A

Delivery structure

2 specs, 5 requirements, 2 with no code mapped
Knuckles-Team/keycloak-agentSpec delivery
Specs (2)
  • CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT2
  • CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY3
Records not done
  • Requirementsall slices in all specs5
  • Requirements not donenot VERIFIED2
  • Specs not donewhole specs only1

Each spec shows its requirement count. Panel J lists every record.

B

Delivery states

count of total

Requirements (5)

LANDED (landed)2 of 5 requirements
VERIFIED (verified)3 of 5 requirements

Specs (2)

LANDED (landed)1 of 2 specs
VERIFIED (verified)1 of 2 specs

Each bar shows one state against all records of the same kind.

Percentages count current rows. Done means VERIFIED.

C

State definitions

delivery_state
StateDefinition
SPECIFIEDThe requirement is written. No code for it is on the default branch.
LANDEDA commit that carries its ID in a Spec trailer is on the default branch.
VERIFIEDIt is LANDED and a test bound to its ID exists.

A spec state is the lowest state of its rows. Done means VERIFIED.

Invalid state: 0

D

Specifications

specs/*/status.json
Spec / titleReq.LandedDoneSpec stateCode references
CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENTCONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT — The connector serves its packaged content22/20LANDEDspec.md documentation: file exists; coverage not verified
plan.md documentation: file exists; coverage not verified
requirements.md documentation: file exists; coverage not verified
test-spec.md documentation: file exists; coverage not verified
CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITYCONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY — The connector is filed under its fleet name33/33✓ VERIFIEDspec.md documentation: file exists; coverage not verified
plan.md documentation: file exists; coverage not verified
requirements.md documentation: file exists; coverage not verified
test-spec.md documentation: file exists; coverage not verified
tests/test_identity_client_scoping.py test: file exists; coverage not verified
tests/test_identity_realm_scoping.py test: file exists; coverage not verified

Landed counts LANDED and VERIFIED requirements. Done counts VERIFIED requirements only.

The spec state comes from the spec status file only.

U

Spec architecture

repository / component packages

Packages group specs by repository and declared component. Unassigned means no component was declared. Code links do not prove coverage. Mermaid source.

Knuckles-Team/keycloak-agent / Unassigned (2)

CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT: no plan diagram declared.

CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY: no plan diagram declared.

R

Spec relationships

declared dependencies and references

Depends on means a declared prerequisite. Extends and references do not imply prerequisite order. Shared code never creates dependencies. External targets are source declarations, not verified delivery.

Knuckles-Team/keycloak-agent / Unassigned
SpecRelationshipTargetEvidence
CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENTNo relationships declared; dependencies unknown
CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITYNo relationships declared; dependencies unknown
G

Open issues and pull requests

open at capture

Issues

0 open at capture.

    Pull Requests

    0 open at capture.

      The build reads GitHub one time. This page makes no live API requests.

      J

      Record inventory

      7 records

      Each status file gives one spec row. Each requirement gives one more row. A record without a valid state shows INVALID. Expand a Definition to read the canonical requirement and verification text.

      All documented records (7 rows)
      ID / sourceKindParentStateCommit / test evidence
      CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT
      CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT — The connector serves its packaged content
      specNoneLANDEDNo recorded commit/test evidence
      CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT-R001
      Default content
      Definition — CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT / CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT — The connector serves its packaged contentCanonical requirement and verification source
      **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`.
      requirementCONN-KEYCLOAK-AGENT-CONNECTOR-CONTENTLANDED10e1d7b242f7
      56d43c85ce54
      CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT-R002
      Advertised actions are real
      Definition — CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT / CONN-KEYCLOAK-AGENT-CONNECTOR-CONTENT — The connector serves its packaged contentCanonical requirement and verification source
      **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.
      requirementCONN-KEYCLOAK-AGENT-CONNECTOR-CONTENTLANDED1b1a82299727
      CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY
      CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY — The connector is filed under its fleet name
      specNoneVERIFIEDNo recorded commit/test evidence
      CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R001
      Fleet name
      Definition — CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY / CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY — The connector is filed under its fleet nameCanonical requirement and verification source
      **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`.
      requirementCONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITYVERIFIED88cd551054e6
      edf6b09d17b3
      tests/test_fleet_name.py:34
      CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R002
      Realm catalog requires a verified identity
      Definition — CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY / CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY — The connector is filed under its fleet nameCanonical requirement and verification source
      **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`.
      requirementCONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITYVERIFIED3225b0384a4d
      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
      CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY-R003
      Client catalog auto-load is identity scoped
      Definition — CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY / CONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITY — The connector is filed under its fleet nameCanonical requirement and verification source
      **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`.
      requirementCONN-KEYCLOAK-AGENT-CONNECTOR-IDENTITYVERIFIED8e75ae3dfa70
      965b37afbf6e
      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
      TitleSpec delivery: keycloak-agent
      RepositoryKnuckles-Team/keycloak-agent
      Commit10e1d7b242f7
      Captured (UTC)2026-11-06T18:32:20
      Snapshotsnapshot.json (v1)
      Sourcespecs/*/status.json
      Sheet1 of 1