{
  "version": 1,
  "repository": "Knuckles-Team/audiobookshelf-mcp",
  "revision": "c08a08b72aac88e2dc2986db277a645c7d0e8641",
  "captured_at": "2026-11-06T16:19:17.501618+00:00",
  "records": [
    {
      "id": "CONN-AUDIOBOOKSHELF-MCP-COMPETENCY-OPERATIONS",
      "kind": "spec",
      "parent": null,
      "source": "specs/competency-operations/status.json",
      "title": "CONN-AUDIOBOOKSHELF-MCP-COMPETENCY-OPERATIONS \u2014 User listening progress",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "document": "specs/competency-operations/spec.md",
      "component": "Unassigned",
      "code_refs": [
        {
          "declared_in": "specs/competency-operations/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/competency-operations/spec.md"
        },
        {
          "declared_in": "specs/competency-operations/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/competency-operations/plan.md"
        },
        {
          "declared_in": "specs/competency-operations/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/competency-operations/requirements.md"
        },
        {
          "declared_in": "specs/competency-operations/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "test-spec.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/competency-operations/test-spec.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-AUDIOBOOKSHELF-MCP-COMPETENCY-OPERATIONS-R001",
      "kind": "requirement",
      "parent": "CONN-AUDIOBOOKSHELF-MCP-COMPETENCY-OPERATIONS",
      "source": "specs/competency-operations/status.json",
      "title": "The connector must serve typed tools that return media progress per user and item: `audiobookshelf_get_users`, `audiobookshelf_get_user_listening_stats`, `audiobookshelf_get_user_listening_sessions`, `audiobookshelf_get_my_items_in_progress`. Proving test: `tests/test_operations_surface.py`. Caller chain: the `audiobookshelf-mcp = scion_sdk.cli:serve` console script -> entry point `audiobookshelf_mcp:connector` -> `ApiClientSystem` (`audiobookshelf_mcp/api/__init__.py`) -> `ApiClientUsers` (`api_client_users.py`) and `ApiClientMe` (`api_client_me.py`). Shape: one client method per upstream route; the SDK serves each as one typed tool",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "8a9ddc985afa"
      ],
      "verified_by": [],
      "parent_title": "CONN-AUDIOBOOKSHELF-MCP-COMPETENCY-OPERATIONS \u2014 User listening progress",
      "definition": "The connector must serve typed tools that return media progress per user and item: `audiobookshelf_get_users`, `audiobookshelf_get_user_listening_stats`, `audiobookshelf_get_user_listening_sessions`, `audiobookshelf_get_my_items_in_progress`. Proving test: `tests/test_operations_surface.py`. Caller chain: the `audiobookshelf-mcp = scion_sdk.cli:serve` console script -> entry point `audiobookshelf_mcp:connector` -> `ApiClientSystem` (`audiobookshelf_mcp/api/__init__.py`) -> `ApiClientUsers` (`api_client_users.py`) and `ApiClientMe` (`api_client_me.py`). Shape: one client method per upstream route; the SDK serves each as one typed tool. | The operation returns the documented fields. Test: `tests/test_operations_surface.py::test_media_progress_tools_are_served`.",
      "definition_source": "specs/competency-operations/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT",
      "kind": "spec",
      "parent": null,
      "source": "specs/connector-content/status.json",
      "title": "CONN-AUDIOBOOKSHELF-MCP-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": "audiobookshelf_mcp/__init__.py:15",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/audiobookshelf_mcp/__init__.py#L15"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "audiobookshelf_mcp/ontology/audiobookshelf.ttl",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "implementation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/audiobookshelf_mcp/ontology/audiobookshelf.ttl"
        },
        {
          "declared_in": "specs/connector-content/plan.md",
          "evidence": "file exists; coverage not verified",
          "label": "spec.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/connector-content/spec.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "plan.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/connector-content/plan.md"
        },
        {
          "declared_in": "specs/connector-content/spec.md",
          "evidence": "file exists; coverage not verified",
          "label": "requirements.md",
          "repository": "Knuckles-Team/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/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/audiobookshelf-mcp",
          "role": "documentation",
          "url": "https://github.com/Knuckles-Team/audiobookshelf-mcp/blob/c08a08b72aac88e2dc2986db277a645c7d0e8641/specs/connector-content/test-spec.md"
        }
      ],
      "relations": [],
      "plan_diagrams": [],
      "unparsed_references": []
    },
    {
      "id": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT-R002",
      "kind": "requirement",
      "parent": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Stop declaring :Author in the shared namespace",
      "delivery_state": "SPECIFIED",
      "state": "specified",
      "done": false,
      "landed_in": [],
      "verified_by": [],
      "parent_title": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Stop declaring :Author in the shared namespace.** Stop declaring :Author in the shared namespace; use mv:contributor to :Person. This resolves the collision with the software ontology :Author. Caller chain: the `audiobookshelf-mcp` console script (`scion_sdk.cli:serve`) loads `audiobookshelf_mcp:connector` (`audiobookshelf_mcp/__init__.py:15`), whose packaged `audiobookshelf_mcp/ontology/audiobookshelf.ttl` declares `:Author` at line 37 and `writtenBy` at line 51. Shape: in `audiobookshelf.ttl` drop `:Author a owl:Class`, point `writtenBy` range at the core `:Person` through the `mv:contributor` property, and update `audiobookshelf_mcp/ontology/mappings/source.yaml` and fixtures that name the Author class. | Test: ontology load shows no duplicate class IRI with core. Planned test: `tests/test_ontology_parent_link.py::test_author_is_not_declared_in_the_shared_namespace`.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 9
    },
    {
      "id": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT-R001",
      "kind": "requirement",
      "parent": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT",
      "source": "specs/connector-content/status.json",
      "title": "Default content",
      "delivery_state": "LANDED",
      "state": "landed",
      "done": false,
      "landed_in": [
        "0bfcccca44b8",
        "444ef757810e"
      ],
      "verified_by": [],
      "parent_title": "CONN-AUDIOBOOKSHELF-MCP-CONNECTOR-CONTENT \u2014 The connector serves its packaged content",
      "definition": "**Default content.** `pyproject.toml` declares `audiobookshelf-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 `audiobookshelf-mcp` console script (`scion_sdk.cli:serve`) loads the `scion_sdk.connector` entry point `audiobookshelf_mcp:connector` (`audiobookshelf_mcp/__init__.py:15`), which the SDK `build_server` turns into the served MCP server and its resources and prompts. Shape: `connector = Connector(...)` in `audiobookshelf_mcp/__init__.py:15` passes no `content=`, so the SDK reuses `ConnectorContent.for_package` over the packaged `audiobookshelf_mcp/skills` and `audiobookshelf_mcp/ontology` folders and any packaged prompts. | `resources/list` includes `skill://` and `ontology://`; `prompts/list` includes each packaged prompt. Planned test: `tests/test_default_content_surfaces.py::test_default_content_surfaces`.",
      "definition_source": "specs/connector-content/requirements.md",
      "definition_line": 10
    }
  ],
  "github": {
    "issues": {
      "available": true,
      "items": []
    },
    "pull_requests": {
      "available": true,
      "items": []
    }
  },
  "spec_edges": []
}
