{
  "version": 1,
  "repository": "Knuckles-Team/ciso-assistant-api",
  "revision": "2472c4b5c1f568a6887faa41a1a812d6df8bac31",
  "captured_at": "2026-11-06T17:40:17.968872+00:00",
  "records": [
    {
      "id": "CONN-CISO-ASSISTANT-API",
      "kind": "spec",
      "parent": null,
      "source": "specs/ciso-assistant-api/status.json",
      "title": "CONN-CISO-ASSISTANT-API \u2014 Credential reference resolution",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/ciso-assistant-api/spec.md",
      "component": "Connector integration",
      "code_refs": [
        {
          "declared_in": "specs/ciso-assistant-api/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/ciso-assistant-api/spec.md"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../ciso_assistant_api/api/api_client_base.py",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/ciso_assistant_api/api/api_client_base.py"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../ciso_assistant_api/auth.py",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/ciso_assistant_api/auth.py"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../pyproject.toml",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/pyproject.toml"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../tests/test_auth.py",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/tests/test_auth.py"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "../../tests/test_credential_refs.py",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/tests/test_credential_refs.py"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/ciso-assistant-api/plan.md"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/ciso-assistant-api/requirements.md"
        },
        {
          "declared_in": "specs/ciso-assistant-api/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/ciso-assistant-api/test-spec.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-R001",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API",
      "source": "specs/ciso-assistant-api/status.json",
      "title": "SDK floor",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "262cb1a5cdaf"
      ],
      "verified_by": [
        "tests/test_credential_refs.py:11"
      ],
      "parent_title": "CONN-CISO-ASSISTANT-API \u2014 Credential reference resolution",
      "definition": "**SDK floor.** `pyproject.toml` must require `scion-sdk[mcp]>=0.5.6,<1.0.0`, the compatible renamed SDK release preserving the credential behavior introduced in scion-sdk 0.3.10, where `default_credential_resolver()` serves `env://` when `OPENBAO_TOKEN_REF` is unset. Caller chain: the `ciso-assistant-mcp` console script (`ciso_assistant_api.mcp_server:mcp_server`, line 79) -> `get_mcp_instance` (line 72) -> SDK `build_server(\"ciso_assistant_api\")` -> `get_client` (`ciso_assistant_api/auth.py` line 53), whose secret resolution depends on the SDK floor declared in `pyproject.toml`. Shape: the floor is the `scion-sdk[mcp]` requirement in `pyproject.toml` dependencies and the `mcp` and `all` extras; `tests/test_credential_refs.py::test_sdk_floor_is_declared` parses the requirement with `packaging` and checks its range. | `tests/test_credential_refs.py::test_sdk_floor_is_declared` must pass.",
      "definition_source": "specs/ciso-assistant-api/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-R002",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API",
      "source": "specs/ciso-assistant-api/status.json",
      "title": "Wiring",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "9f84a516227f"
      ],
      "verified_by": [
        "tests/test_credential_refs.py:20"
      ],
      "parent_title": "CONN-CISO-ASSISTANT-API \u2014 Credential reference resolution",
      "definition": "**Wiring.** `get_client` in `ciso_assistant_api/auth.py` must resolve `CISO_ASSISTANT_USERNAME_REF` and `CISO_ASSISTANT_PASSWORD_REF` through `resolve_secret_reference` with `OPENBAO_ADDR` set and no `OPENBAO_TOKEN_REF`. Caller chain: `ciso_assistant_api/mcp_server.py::register_server_surface` (line 32) passes `get_client` to `register_tool_surface` -> `get_client` (`ciso_assistant_api/auth.py` line 53) -> `_resolve_optional_secret` (line 120) -> `scion_sdk.credentials.resolution.resolve_secret_reference`. Shape: `get_client` reads `CISO_ASSISTANT_USERNAME_REF` and `CISO_ASSISTANT_PASSWORD_REF` through `scion_sdk.config.setting` and `_resolve_optional_secret`; the test sets `env://` references with `OPENBAO_ADDR` and no `OPENBAO_TOKEN_REF` and builds the client. | `tests/test_credential_refs.py::test_env_refs_resolve_with_openbao_addr_and_no_token_ref` must build a client through `get_client`.",
      "definition_source": "specs/ciso-assistant-api/requirements.md",
      "definition_line": 10
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-R003",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API",
      "source": "specs/ciso-assistant-api/status.json",
      "title": "Headless login",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "CONN-CISO-ASSISTANT-API \u2014 Credential reference resolution",
      "definition": "**Headless login.** `_ensure_token` in `ciso_assistant_api/api/api_client_base.py` must use a configured token without logging in; otherwise it must `POST /api/_allauth/app/v1/auth/login` with JSON `email` (or `username` when the identity has no `@`) and `password`, and use `meta.access_token` from the response as the API token. It must not call `/api/iam/login/`. Caller chain: any API tool call -> `Api` client method in `ciso_assistant_api/api/` -> `_auth_headers` (`ciso_assistant_api/api/api_client_base.py` line 152) -> `_ensure_token` (line 116), which posts the headless login when no token is configured. Shape: `_ensure_token` caches the token under `_token_lock` and posts JSON `email` or `username` plus `password` to `/api/_allauth/app/v1/auth/login` with the session in `api_client_base.py`; `tests/test_auth.py` covers the login and the configured-token paths. | `tests/test_auth.py::test_headless_login_returns_access_token` and `tests/test_auth.py::test_configured_token_skips_login` must pass.",
      "definition_source": "specs/ciso-assistant-api/requirements.md",
      "definition_line": 11
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-R004",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API",
      "source": "specs/ciso-assistant-api/status.json",
      "title": "Fleet name",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "60bd1be05869",
        "9f84a516227f",
        "e8d176cf25c8"
      ],
      "verified_by": [
        "tests/test_fleet_name.py:34"
      ],
      "parent_title": "CONN-CISO-ASSISTANT-API \u2014 Credential reference resolution",
      "definition": "**Fleet name.** `pyproject.toml` declares `ciso-assistant-mcp` as the single `scion_sdk.connector` entry point. The content pack, the manifest `connector`, the fingerprints and the ingest binding all carry `ciso-assistant-mcp`. Proving test: `tests/test_fleet_name.py::test_connector_name_is_the_fleet_name`. Caller chain: the `ciso-assistant-mcp = ciso_assistant_api:connector` entry point in `pyproject.toml` -> `ciso_assistant_api/__init__.py::connector` (line 76) -> `IngestBinding` and `ConnectorContent` calls that carry the connector name. Shape: the name is a literal in `pyproject.toml` and the package calls; `tests/test_fleet_name.py` walks the package by AST and compares every `connector` keyword with the fleet name. | Every connector name in the package is `ciso-assistant-mcp`.",
      "definition_source": "specs/ciso-assistant-api/requirements.md",
      "definition_line": 12
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT",
      "kind": "spec",
      "parent": null,
      "source": "specs/connector-content/status.json",
      "title": "CONN-CISO-ASSISTANT-API-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": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "ciso_assistant_api/mcp_server.py",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/ciso_assistant_api/mcp_server.py"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/connector-content/spec.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/connector-content/plan.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/connector-content/requirements.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/ciso-assistant-api",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/ciso-assistant-api/blob/2472c4b5c1f568a6887faa41a1a812d6df8bac31/specs/connector-content/test-spec.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT-R001",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Default content",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "262cb1a5cdaf",
        "4317988a9190"
      ],
      "verified_by": [
        "tests/test_default_content_surfaces.py:15"
      ],
      "parent_title": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Default content.** `pyproject.toml` declares `ciso-assistant-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. Proving test: `tests/test_default_content_surfaces.py`. Caller chain: the `ciso-assistant-mcp = ciso_assistant_api:connector` entry point in `pyproject.toml` -> `ciso_assistant_api/__init__.py::connector` (line 76) -> SDK `build_server(\"ciso_assistant_api\")` called by `ciso_assistant_api/mcp_server.py::get_mcp_instance` (line 72), serving the packaged skills, prompts and ontology. Shape: content comes from the packaged `ciso_assistant_api/skills/`, `prompts/` and `ontology/` directories through the SDK build, with no `content=` argument in the connector; the test lists resources and prompts through `fastmcp.Client`. | `resources/list` includes `skill://` and `ontology://`; `prompts/list` includes each packaged prompt. Test: `tests/test_default_content_surfaces.py::test_default_content_surfaces`.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT-R002",
      "kind": "requirement",
      "parent": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Declare access contracts for the competency reads of ciso-assistant-api",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "CONN-CISO-ASSISTANT-API-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Declare access contracts for the competency reads of ciso-assistant-api.** Subsystem: connector `ciso-assistant-api`. Caller: the connector's existing read tool, called by arbora through `fleet.call`. Declare in `ciso_assistant_api/ontology/access_contracts.ttl` one `ac:AccessContract` per entity. Entities: entity `applied_control` (class control, key `id`, columns status, riskScenarioId); entity `risk_scenario` (class RiskScenario, key `id`, columns serviceRef, name). 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 access contracts file of the container-manager-mcp connector (`access_contracts.ttl` under its `ontology` directory). 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` -> condensed domain tools from `register_server_surface` (`ciso_assistant_api/mcp_server.py` line 32, `TOOL_REGISTRY`) with actions `api_applied_controls_list` and `api_risk_scenarios_list` -> `ciso_assistant_api/api/` client; the new the new `ciso_assistant_api` access contracts file does not exist yet. Shape: add `ciso_assistant_api/ontology/access_contracts.ttl` next to `ciso.ttl` following the access contracts file of the container-manager-mcp connector (`access_contracts.ttl` under its `ontology` directory); class `RiskScenario` exists in `ciso.ttl` but `control` and the columns must be checked against it; add `tests/recordings/<entity>.json` and `risk_scenario.json`, certified through `ciso_assistant_api/ontology/certification.json`. | Test (planned): `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
    }
  ],
  "github": {
    "issues": {
      "available": true,
      "items": []
    },
    "pull_requests": {
      "available": true,
      "items": []
    }
  },
  "spec_edges": []
}
