Backstage Source Of Record Auto Catalog

naftiko: 1.0.0-alpha2
info:
  title: Backstage Source Of Record Auto Catalog
  description: A capability that uses Backstage as source-of-record and auto-catalogs Naftiko capabilities discovered from a registry into the Backstage catalog.
  tags: [Naftiko, Backstage, Auto-Catalog]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: backstage-env
  keys: {BACKSTAGE_HOST: BACKSTAGE_HOST, BACKSTAGE_TOKEN: BACKSTAGE_TOKEN}
capability:
  consumes:
  - namespace: backstage
    type: http
    baseUri: https://{{BACKSTAGE_HOST}}
    authentication: {type: bearer, token: '{{BACKSTAGE_TOKEN}}'}
    resources:
    - {name: locations, path: /api/catalog/locations, operations: [{name: register-location, method: POST}, {name: list-locations, method: GET}]}
    - {name: entities, path: /api/catalog/entities, operations: [{name: list-entities, method: GET}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: backstage-source-of-record-auto-catalog-rest
    description: REST surface for auto-cataloging Naftiko capabilities into Backstage.
    resources:
    - {name: auto-catalog, path: /auto-catalog, operations: [{method: POST, name: auto-catalog, call: backstage.register-location}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: backstage-source-of-record-auto-catalog-mcp
    description: MCP for auto-catalog ops.
    tools:
    - {name: list-cataloged-entities, hints: {readOnly: true}, call: backstage.list-entities}
    - {name: auto-catalog, call: backstage.register-location}
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: backstage-source-of-record-auto-catalog-skills
    description: Skill bundle for auto-catalog.
    skills:
    - name: backstage-source-of-record-auto-catalog
      description: Backstage as source-of-record auto-catalog.
      location: file:///opt/naftiko/skills/backstage-source-of-record-auto-catalog
      allowed-tools: list-cataloged-entities,auto-catalog
      tools:
      - {name: list-cataloged-entities, from: {sourceNamespace: backstage-source-of-record-auto-catalog-mcp, action: list-cataloged-entities}}
      - {name: auto-catalog, from: {sourceNamespace: backstage-source-of-record-auto-catalog-mcp, action: auto-catalog}}