{
  "version": 1,
  "repository": "Knuckles-Team/portainer-agent",
  "revision": "63de16a8e809f666a822abf925d5618d39a85276",
  "captured_at": "2026-11-06T18:39:57.710894+00:00",
  "records": [
    {
      "id": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT",
      "kind": "spec",
      "parent": null,
      "source": "specs/connector-content/status.json",
      "title": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/connector-content/spec.md",
      "component": "portainer-agent connector",
      "code_refs": [
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "portainer_agent/__init__.py:94",
          "repository": "Knuckles-Team/portainer-agent",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/portainer-agent/blob/63de16a8e809f666a822abf925d5618d39a85276/portainer_agent/__init__.py#L94"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "portainer_agent/mcp_server.py",
          "repository": "Knuckles-Team/portainer-agent",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/portainer-agent/blob/63de16a8e809f666a822abf925d5618d39a85276/portainer_agent/mcp_server.py"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/portainer-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/portainer-agent/blob/63de16a8e809f666a822abf925d5618d39a85276/specs/connector-content/requirements.md"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/portainer-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/portainer-agent/blob/63de16a8e809f666a822abf925d5618d39a85276/specs/connector-content/spec.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../portainer_agent/__init__.py",
          "repository": "Knuckles-Team/portainer-agent",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/portainer-agent/blob/63de16a8e809f666a822abf925d5618d39a85276/portainer_agent/__init__.py"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT-R001",
      "kind": "requirement",
      "parent": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Default content",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "069df7a3125f",
        "63de16a8e809"
      ],
      "verified_by": [],
      "parent_title": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Default content.** `pyproject.toml` declares `portainer-mcp` as the single `scion_sdk.connector` entry point. The server lists the packaged `skill://` and `ontology://` resources and the packaged prompts with no `content=` argument. Caller chain: `portainer-mcp` in `pyproject.toml` runs `scion_sdk.cli:serve`, which builds the server from the `scion_sdk.connector` entry point `portainer_agent:connector` (`portainer_agent/__init__.py:94`); the SDK `Connector` then lists the packaged skills, ontology and prompts. Shape: `pyproject.toml` entry point `portainer-mcp` plus the `connector = Connector(.)` object in `portainer_agent/__init__.py`; the packaged `skills/`, `ontology/` and `prompts/` directories of `portainer_agent` are reused as is, with no connector-local registration code. Proving test (planned): `tests/test_default_content_surfaces.py::test_default_content_surfaces`. Proving test (planned): `tests/test_default_content_surfaces.py::test_default_content_surfaces`. Proving test (planned): `tests/test_default_content_surfaces.py::test_default_content_surfaces`. Proving test (planned): `tests/test_default_content_surfaces.py::test_default_content_surfaces`. | `resources/list` includes `skill://` and `ontology://`; `prompts/list` includes each packaged prompt.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT-R002",
      "kind": "requirement",
      "parent": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Declare access contracts for the competency reads of portainer-agent",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Declare access contracts for the competency reads of portainer-agent.** Subsystem: connector `portainer-agent`. Caller: the connector's existing read tool, called by arbora through `fleet.call`. Declare in `portainer_agent/ontology/access_contracts.ttl` one `ac:AccessContract` per entity. Entities: entity `stack` (class stack, key `id`, columns name, gitUrl, endpointId). Each row sets `ac:classIri`, `ac:sourceId`, `ac:entity`, `ac:keyField`, `ac:accessKind` `mcp_tool`, `ac:operation` (the existing tool name) and `ac:pagination`. Column names equal the ontology property local names. Follow the `ac:AccessContract` vocabulary of the SDK. Save one recorded response per entity in `tests/recordings/<entity>.json`. Medulla copies these into its competency fixtures. The consumer is the medulla table row MEDULLA-CQ-CONN-R086. Caller chain: arbora `fleet.call` reaches the existing read tool of `portainer_agent/mcp_server.py`, whose result is validated against the `ac:AccessContract` rows declared in `portainer_agent/ontology/access_contracts.ttl`. Shape: `portainer_agent/ontology/access_contracts.ttl` with one `ac:AccessContract` per entity named in the row; reuses the existing read tool and the SDK ontology certification, no new tool. Proving test (planned): `tests/test_access_contracts.py::test_competency_contracts_certified`. Proving test (planned): `tests/test_access_contracts.py::test_competency_contracts_certified`. Proving test (planned): `tests/test_access_contracts.py::test_competency_contracts_certified`. Proving test (planned): `tests/test_access_contracts.py::test_competency_contracts_certified`. | Test: `tests/test_access_contracts.py::test_competency_contracts_certified` (L2) runs the connector ontology certification and validates each recording against its contract.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 10
    },
    {
      "id": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT-R003",
      "kind": "requirement",
      "parent": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Served dispatch targets exist",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "6297a2498c73"
      ],
      "verified_by": [],
      "parent_title": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Served dispatch targets exist.** Every client method the served action dispatch references exists on the client, so a missing method cannot make every action of a tool raise. Proving test: `tests/test_served_dispatch_targets_exist.py`. | Docker system usage, edge stack and job creation, and custom template creation resolve to client methods.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 11
    },
    {
      "id": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT-R004",
      "kind": "requirement",
      "parent": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Kubernetes RBAC and Helm chart reads call served routes",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "75b69d815c7b"
      ],
      "verified_by": [],
      "parent_title": "CONN-PORTAINER-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Kubernetes RBAC and Helm chart reads call served routes.** The Kubernetes RBAC listing tools call the routes Portainer serves (`cluster_role_bindings`, `cluster_roles`, `role_bindings`, `service_accounts`), and the Helm chart listing tool takes the chart repository URL and sends it as the required `repo` query parameter. Proving test: `tests/test_kubernetes_rbac_and_helm_routes.py`. | The RBAC listings and the Helm chart listing return data from a Kubernetes environment instead of 404 or 400.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 12
    }
  ],
  "github": {
    "issues": {
      "available": true,
      "items": []
    },
    "pull_requests": {
      "available": true,
      "items": []
    }
  },
  "spec_edges": []
}
