{
  "version": 1,
  "repository": "Knuckles-Team/keycloak-agent",
  "revision": "10e1d7b242f7dcab39571e31170afa5a9c61be56",
  "captured_at": "2026-11-06T18:32:20.145351+00:00",
  "records": [
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT",
      "kind": "spec",
      "parent": null,
      "source": "specs/connector-content/status.json",
      "title": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "delivery_state": "LANDED",
      "state": "landed",
      "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": "spec.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-content/spec.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-content/plan.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/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/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-content/test-spec.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT-R001",
      "kind": "requirement",
      "parent": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Default content",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "10e1d7b242f7",
        "56d43c85ce54"
      ],
      "verified_by": [],
      "parent_title": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Default content.** `pyproject.toml` declares `keycloak-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 `keycloak-mcp` console script (pyproject.toml) loads the `scion_sdk.connector` entry point `keycloak_agent:connector` -> keycloak_agent/__init__.py::connector (a Connector with no content= argument) -> the SDK default content registration serves skill://, ontology:// and prompts. Shape: tests build the server from keycloak_agent and list resources and prompts over the packaged keycloak_agent/skills, keycloak_agent/ontology and keycloak_agent/prompts directories. | `resources/list` includes `skill://` and `ontology://`; `prompts/list` includes each packaged prompt. Planned test: `tests/test_default_content_surfaces.py::test_default_content_surfaces_list_skills_ontology_prompts`.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT-R002",
      "kind": "requirement",
      "parent": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Advertised actions are real",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "1b1a82299727"
      ],
      "verified_by": [],
      "parent_title": "CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Advertised actions are real.** Every action name a keycloak tool advertises in its description is a generated or hand-written client method, so each expanded per-action tool resolves. Proving test: `tests/test_tool_action_names.py`. | Groups, roles, components, identity providers, organizations and authentication tools list actions that exist in the client.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 10
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY",
      "kind": "spec",
      "parent": null,
      "source": "specs/connector-identity/status.json",
      "title": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY \u2014 The connector is filed under its fleet name",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/connector-identity/spec.md",
      "component": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/connector-identity/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-identity/spec.md"
        },
        {
          "declared_in": "specs/connector-identity/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-identity/plan.md"
        },
        {
          "declared_in": "specs/connector-identity/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-identity/requirements.md"
        },
        {
          "declared_in": "specs/connector-identity/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/specs/connector-identity/test-spec.md"
        },
        {
          "declared_in": "specs/connector-identity/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "tests/test_identity_client_scoping.py",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/tests/test_identity_client_scoping.py"
        },
        {
          "declared_in": "specs/connector-identity/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "tests/test_identity_realm_scoping.py",
          "repository": "Knuckles-Team/keycloak-agent",
          "role": "test",
          "url": "https://github.com/Knuckles-Team/keycloak-agent/blob/10e1d7b242f7dcab39571e31170afa5a9c61be56/tests/test_identity_realm_scoping.py"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R001",
      "kind": "requirement",
      "parent": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY",
      "source": "specs/connector-identity/status.json",
      "title": "Fleet name",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "88cd551054e6",
        "edf6b09d17b3"
      ],
      "verified_by": [
        "tests/test_fleet_name.py:34"
      ],
      "parent_title": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY \u2014 The connector is filed under its fleet name",
      "definition": "**Fleet name.** `pyproject.toml` declares `keycloak-mcp` as the single `scion_sdk.connector` entry point. The content pack, the manifest `connector`, the fingerprints and the ingest binding all carry `keycloak-mcp`. Proving test: `tests/test_fleet_name.py::test_connector_name_is_the_fleet_name`. Caller chain: the `keycloak-mcp` console script (pyproject.toml, scion_sdk.cli:serve) loads `keycloak_agent:connector` (keycloak_agent/__init__.py) -> keycloak_agent/connector_sources.py (server=\"keycloak-mcp\", served as connector://resources) and the SDK connector_name(\"keycloak_agent\"). Shape: tests/test_fleet_name.py scans keycloak_agent/*.py with ast for IngestBinding and ConnectorContent connector= keywords and compares scion_sdk.connector_identity.connector_name with keycloak-mcp; the package sets the name only in pyproject.toml and connector_sources.py. | Every connector name in the package is `keycloak-mcp`.",
      "definition_source": "specs/connector-identity/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R002",
      "kind": "requirement",
      "parent": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY",
      "source": "specs/connector-identity/status.json",
      "title": "Realm catalog requires a verified identity",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "3225b0384a4d"
      ],
      "verified_by": [
        "tests/test_identity_realm_scoping.py:101",
        "tests/test_identity_realm_scoping.py:110",
        "tests/test_identity_realm_scoping.py:49",
        "tests/test_identity_realm_scoping.py:66",
        "tests/test_identity_realm_scoping.py:91"
      ],
      "parent_title": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY \u2014 The connector is filed under its fleet name",
      "definition": "**Realm catalog requires a verified identity.** Before fetching realms, require the SDK entitlement resolver and an authenticated, tenant-bound actor. Return only valid realm entries granted to that actor. Refuse unavailable resolvers and malformed catalog responses. Caller chain: arbora fleet.call -> `keycloak_agent_realms` tool (keycloak_agent/mcp/mcp_realms.py::register_realms_tools:10) -> keycloak_agent/api/api_client_realms.py::Api.list_realms -> _entitled -> scion_sdk.entitlements.identity_scoped_resources. Shape: keycloak_agent/api/api_client_realms.py::_entitled wraps the SDK identity_scoped_resources and raises PermissionError when the resolver import fails; list_realms validates each entry's realm string before filtering. | `tests/test_identity_realm_scoping.py` covers real SDK actor scoping, a missing resolver, missing identity and malformed entries. Test: `tests/test_identity_realm_scoping.py::test_real_authenticated_identity_scopes_the_catalog`.",
      "definition_source": "specs/connector-identity/requirements.md",
      "definition_line": 10
    },
    {
      "id": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R003",
      "kind": "requirement",
      "parent": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY",
      "source": "specs/connector-identity/status.json",
      "title": "Client catalog auto-load is identity scoped",
      "delivery_state": "VERIFIED",
      "state": "verified",
      "done": true,
      "landed_in": [
        "8e75ae3dfa70",
        "965b37afbf6e"
      ],
      "verified_by": [
        "tests/test_identity_client_scoping.py:36",
        "tests/test_identity_client_scoping.py:53",
        "tests/test_identity_client_scoping.py:69",
        "tests/test_identity_client_scoping.py:9"
      ],
      "parent_title": "CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY \u2014 The connector is filed under its fleet name",
      "definition": "**Client catalog auto-load is identity scoped.** Before listing Keycloak clients, require the actor's realm grant. Return only valid client UUID entries granted by the `keycloak-client` namespace. Refuse missing identity and malformed catalogs. This row does not claim that direct client operations are authorized. Caller chain: arbora fleet.call -> `keycloak_agent_clients` tool (keycloak_agent/mcp/mcp_clients.py:14, action list_clients) -> keycloak_agent/api/api_client_clients.py::Api.list_clients -> keycloak_agent/api/api_client_realms.py::_entitled for namespaces realm and keycloak-client. Shape: Api.list_clients in keycloak_agent/api/api_client_clients.py checks the realm grant, validates every client id, and filters with _entitled(\"keycloak-client\", ids), reusing the SDK identity_scoped_resources. | `tests/test_identity_client_scoping.py` covers actor grants, realm refusal, missing identity and malformed entries. Test: `tests/test_identity_client_scoping.py::test_client_catalog_returns_only_granted_ids`.",
      "definition_source": "specs/connector-identity/requirements.md",
      "definition_line": 11
    }
  ],
  "github": {
    "issues": {
      "available": true,
      "items": []
    },
    "pull_requests": {
      "available": true,
      "items": []
    }
  },
  "spec_edges": []
}
