A

Delivery structure

1 specs, 6 requirements, 0 with no code mapped
Knuckles-Team/immich-apiSpec delivery
Specs (1)
  • CONN-IMMICH-API6
Records not done
  • Requirementsall slices in all specs6
  • Requirements not donenot VERIFIED5
  • Specs not donewhole specs only1

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

B

Delivery states

count of total

Requirements (6)

LANDED (landed)5 of 6 requirements
VERIFIED (verified)1 of 6 requirements

Specs (1)

LANDED (landed)1 of 1 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-IMMICH-APICONN-IMMICH-API — Immich Api connector66/61LANDEDapi-spec/immich.openapi.json implementation: file exists; coverage not verified
spec.md documentation: file exists; coverage not verified
tests/test_immich_content.py test: file exists; coverage not verified
the governing scope documentation: file exists; coverage not verified
Connector SDK documentation: external declaration; not verified
../../immich_api/auth.py implementation: file exists; coverage not verified
../../immich_api/kg_ingest.py implementation: file exists; coverage not verified
../../immich_api/mcp/__init__.py implementation: file exists; coverage not verified
../../immich_api/mcp_server.py implementation: file exists; coverage not verified
../../immich_api/openapi_runtime.py implementation: file exists; coverage not verified
../../scripts/generate_tool_schemas.py implementation: file exists; coverage not verified
../../tests/operation_fixtures.py test: file exists; coverage not verified
../../tests/test_api_wrapper.py test: file exists; coverage not verified
../../tests/test_auth.py test: file exists; coverage not verified
../../tests/test_immich_mcp_validation.py test: file exists; coverage not verified
../../tests/test_kg_ingest.py test: file exists; coverage not verified
../../tests/test_operation_parity.py test: 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

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/immich-api / Connector integration (1)
Knuckles-Team/immich-api / Connector integration (1)CONN-IMMICH-API
CONN-IMMICH-API: source plan diagrams (Mermaid)
flowchart LR
    Caller[Authorized caller] --> Server[MCP server]
    Server --> Router[Operation router]
    Router --> Client[Connector API client]
    Client --> Vendor[Configured external system]
    Resolver[Credential references and TLS policy] --> Client
    Content[Packaged skills prompts ontology manifest] --> Server
    Source[Authorized source observations] --> Mapper[Connector ingest mapper]
    Mapper --> SDK[Shared connector ingest service]
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/immich-api / Connector integration
SpecRelationshipTargetEvidence
CONN-IMMICH-APIreferencesConnector SDKKnuckles-Team/agent-connector-sdk: external declaration; not verified; source: specs/immich-api/spec.md
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-IMMICH-API
      CONN-IMMICH-API — Immich Api connector
      specNoneLANDEDNo recorded commit/test evidence
      CONN-IMMICH-API-R001
      Credential references
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **Credential references.** The connector must resolve authorized credential references in `immich_api/auth.py` when a client is requested. | `tests/test_auth.py::test_client_resolves_reference_and_cleans_up` must observe reference resolution and resource cleanup.
      requirementCONN-IMMICH-APILANDED47656ecb1833
      CONN-IMMICH-API-R002
      Bounded API requests
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **Bounded API requests.** The connector must enforce origin, TLS, timeout, and response-size limits in `immich_api/openapi_runtime.py`. | `tests/test_api_wrapper.py` must exercise rejected origins, redirects, deadlines, and oversized responses through the real client.
      requirementCONN-IMMICH-APILANDED47656ecb1833
      CONN-IMMICH-API-R003
      MCP registration
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **MCP registration.** The connector must register its operation router through `immich_api/mcp_server.py` and `immich_api/mcp/__init__.py`. | `tests/test_immich_mcp_validation.py::test_mcp_instance_registration` must construct the production server without vendor requests.
      requirementCONN-IMMICH-APILANDED47656ecb1833
      CONN-IMMICH-API-R004
      Native content contracts
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **Native content contracts.** The connector must publish packaged prompts, skills, ontology, and its manifest through `immich_api/mcp_server.py`. | `scripts/generate_tool_schemas.py --check` must validate live tool contracts. `tests/test_immich_content.py::test_native_prompt_skill_shapes_and_tool_discovery` must render prompts and read the declared content through the production SDK server.
      requirementCONN-IMMICH-APILANDED47656ecb1833
      CONN-IMMICH-API-R005
      Typed source observations
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **Typed source observations.** The connector must submit authorized source observations through the shared ingest service in `immich_api/kg_ingest.py`. | `tests/test_kg_ingest.py::test_ingest_uses_scoped_binding_and_preserves_receipt` must observe typed changes at the submission boundary.
      requirementCONN-IMMICH-APILANDED47656ecb1833
      CONN-IMMICH-API-R006
      Complete source parity
      Definition — CONN-IMMICH-API / CONN-IMMICH-API — Immich Api connectorCanonical requirement and verification source
      **Complete source parity.** Every operation in the pinned provider schema must retain its method, route, typed arguments, responses and authorization metadata and be reachable through both the API client and native MCP. | `tests/test_operation_parity.py` must execute all source operations against mocked HTTP, verify exact request and response contents, require modern MCP confirmation for writes, and fail on missing or duplicate successful operation IDs.
      requirementCONN-IMMICH-APIVERIFIED0210f2b943f4
      250bb53307c8
      47656ecb1833
      tests/test_generated_schema_policy.py:18
      tests/test_oauth_redirect_response.py:26
      tests/test_operation_parity.py:31
      tests/test_reviewed_secret_history.py:13
      tests/test_session_auth_isolation.py:17
      TitleSpec delivery: immich-api
      RepositoryKnuckles-Team/immich-api
      Commite04a120962d1
      Captured (UTC)2026-10-14T01:41:32
      Snapshotsnapshot.json (v1)
      Sourcespecs/*/status.json
      Sheet1 of 1