K8S Gitops Capability

naftiko: 1.0.0-alpha2
info:
  title: K8s Gitops Capability
  description: A capability over a Kubernetes cluster's API server for GitOps-driven capability deployments — read-only deployments + scaling exposed as governed actions.
  tags: [Naftiko, Kubernetes, GitOps]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: k8s-env
  keys: {K8S_HOST: K8S_HOST, K8S_TOKEN: K8S_TOKEN, K8S_NAMESPACE: K8S_NAMESPACE}
capability:
  consumes:
  - namespace: k8s
    type: http
    baseUri: 'https://{{K8S_HOST}}'
    authentication: {type: bearer, token: '{{K8S_TOKEN}}'}
    resources:
    - {name: deployments, path: '/apis/apps/v1/namespaces/{{K8S_NAMESPACE}}/deployments', operations: [{name: list-deployments, method: GET}]}
    - name: deployment
      path: '/apis/apps/v1/namespaces/{{K8S_NAMESPACE}}/deployments/{{name}}'
      operations:
      - {name: get-deployment, method: GET, inputParameters: [{name: name, in: path}]}
      - {name: patch-deployment, method: PATCH, inputParameters: [{name: name, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: k8s-gitops-capability-rest
    description: REST surface for K8s deploys.
    resources:
    - {name: deployments, path: /deployments, operations: [{method: GET, name: list-deployments, call: k8s.list-deployments}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: k8s-gitops-capability-mcp
    description: MCP for K8s deploys.
    tools:
    - {name: list-deployments, hints: {readOnly: true}, call: k8s.list-deployments}
    - name: get-deployment
      hints: {readOnly: true}
      inputParameters: [{name: name, type: string, required: true}]
      call: k8s.get-deployment
    - name: scale-deployment
      inputParameters: [{name: name, type: string, required: true}]
      call: k8s.patch-deployment
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: k8s-gitops-capability-skills
    description: Skill for K8s GitOps.
    skills:
    - name: k8s-gitops-capability
      description: Kubernetes GitOps deploys.
      location: file:///opt/naftiko/skills/k8s-gitops-capability
      allowed-tools: list-deployments,get-deployment,scale-deployment
      tools:
      - {name: list-deployments, from: {sourceNamespace: k8s-gitops-capability-mcp, action: list-deployments}}
      - {name: get-deployment, from: {sourceNamespace: k8s-gitops-capability-mcp, action: get-deployment}}
      - {name: scale-deployment, from: {sourceNamespace: k8s-gitops-capability-mcp, action: scale-deployment}}