Backstage Software Template Publisher

naftiko: 1.0.0-alpha2
info:
  title: Backstage Software Template Publisher
  description: A capability that publishes a Naftiko capability YAML as a Backstage software template, available in the developer portal.
  tags: [Naftiko, Backstage, Publisher]
  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: catalog-refresh, path: /api/catalog/refresh, operations: [{name: refresh-catalog, method: POST}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: backstage-software-template-publisher-rest
    description: REST surface for publishing software templates to Backstage.
    resources:
    - {name: publish, path: /publish, operations: [{method: POST, name: publish-template, call: backstage.register-location}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: backstage-software-template-publisher-mcp
    description: MCP for template publication.
    tools:
    - {name: publish-template, call: backstage.register-location}
    - {name: refresh-catalog, call: backstage.refresh-catalog}
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: backstage-software-template-publisher-skills
    description: Skill for publishing templates.
    skills:
    - name: backstage-software-template-publisher
      description: Publish capability YAML as Backstage template.
      location: file:///opt/naftiko/skills/backstage-software-template-publisher
      allowed-tools: publish-template,refresh-catalog
      tools:
      - {name: publish-template, from: {sourceNamespace: backstage-software-template-publisher-mcp, action: publish-template}}
      - {name: refresh-catalog, from: {sourceNamespace: backstage-software-template-publisher-mcp, action: refresh-catalog}}