Backstage Demo Scaffold

naftiko: 1.0.0-alpha2
info:
  title: Backstage Demo Scaffold
  description: A scaffold capability that bootstraps a Backstage demo environment with example entities and TechDocs.
  tags: [Naftiko, Backstage, Scaffold]
  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: scaffolder-tasks, path: /api/scaffolder/v2/tasks, operations: [{name: run-scaffolder-task, method: POST}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: backstage-demo-scaffold-rest
    description: REST surface for scaffolding a Backstage demo.
    resources:
    - {name: scaffold, path: /scaffold, operations: [{method: POST, name: scaffold-demo, call: backstage.run-scaffolder-task}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: backstage-demo-scaffold-mcp
    description: MCP for Backstage scaffolding.
    tools:
    - {name: scaffold-demo, call: backstage.run-scaffolder-task}
    - {name: register-location, call: backstage.register-location}
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: backstage-demo-scaffold-skills
    description: Skill bundle for Backstage demo scaffolding.
    skills:
    - name: backstage-demo-scaffold
      description: Bootstrap a Backstage demo.
      location: file:///opt/naftiko/skills/backstage-demo-scaffold
      allowed-tools: scaffold-demo,register-location
      tools:
      - {name: scaffold-demo, from: {sourceNamespace: backstage-demo-scaffold-mcp, action: scaffold-demo}}
      - {name: register-location, from: {sourceNamespace: backstage-demo-scaffold-mcp, action: register-location}}