Adjacency Capability Driven Mocking Reference

naftiko: 1.0.0-alpha2
info:
  title: Adjacency Capability Driven Mocking Reference
  description: A reference capability exercising capability-driven mocking against capability specs () plus runtime execution (Naftiko) — explicit partnership-boundary artifact.
  tags:
  - Naftiko
  - Adjacency
  - Mocking
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: adjacency-env
  description: Adjacency capability-spec source (e.g. spec registry URL).
  keys:
    ADJACENCY_SPEC_URL: ADJACENCY_SPEC_URL
- namespace: naftiko-env
  description: Naftiko mocking-runtime token.
  keys:
    NAFTIKO_API_KEY: NAFTIKO_API_KEY
capability:
  consumes:
  - namespace: adjacency
    type: http
    baseUri: '{{ADJACENCY_SPEC_URL}}'
    resources:
    - name: capability-spec
      path: /capabilities/{{capability_id}}
      operations:
      - name: get-capability-spec
        method: GET
        inputParameters:
        - name: capability_id
          in: path
  - namespace: naftiko-mock
    type: http
    baseUri: https://api.naftiko.com
    authentication:
      type: bearer
      token: '{{NAFTIKO_API_KEY}}'
    resources:
    - name: mocks
      path: /v1/mocks
      operations:
      - name: create-mock
        method: POST
        description: Create a runtime mock from an Adjacency capability spec.
    - name: mock
      path: /v1/mocks/{{mock_id}}
      operations:
      - name: get-mock
        method: GET
        inputParameters:
        - name: mock_id
          in: path
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: adjacency-capability-driven-mocking-reference-rest
    description: REST surface that renders an Adjacency capability spec as a live Naftiko mock.
    resources:
    - name: mock-from-spec
      path: /mocks/from-spec/{{capability_id}}
      operations:
      - method: POST
        name: mock-from-spec
        description: Pull an Adjacency capability spec and stand up a Naftiko mock for it.
        inputParameters:
        - name: capability_id
          in: path
          type: string
        call: naftiko-mock.create-mock
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: adjacency-capability-driven-mocking-reference-mcp
    description: MCP server letting agents stand up capability-driven mocks on demand.
    tools:
    - name: mock-from-spec
      description: Stand up a Naftiko mock from an Adjacency capability spec.
      inputParameters:
      - name: capability_id
        type: string
        required: true
      call: naftiko-mock.create-mock
    - name: get-mock
      description: Return the runtime URL and metadata of a Naftiko mock.
      hints:
        readOnly: true
      inputParameters:
      - name: mock_id
        type: string
        required: true
      call: naftiko-mock.get-mock
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: adjacency-capability-driven-mocking-reference-skills
    description: Agent Skill bundle for capability-driven mocking.
    skills:
    - name: adjacency-capability-driven-mocking-reference
      description: Spin up runtime mocks from Adjacency capability specs.
      location: file:///opt/naftiko/skills/adjacency-capability-driven-mocking-reference
      allowed-tools: mock-from-spec,get-mock
      tools:
      - name: mock-from-spec
        from:
          sourceNamespace: adjacency-capability-driven-mocking-reference-mcp
          action: mock-from-spec
      - name: get-mock
        from:
          sourceNamespace: adjacency-capability-driven-mocking-reference-mcp
          action: get-mock