WIP simplifying load/startup

src/personal_mcp/registry/models/registry.py

@@ -3,17 +3,22 @@ from collections.abc import Mapping
 from pydantic import Field
 from pydantic import field_validator
 
+from .common import DocsPath
 from .common import StrictFrozenModel
 from .common import frozen_mapping
 from .prompt import PromptArgumentEntry
 
 
+def _empty_docs_mapping() -> Mapping[DocsPath, str]:
+    return frozen_mapping()
+
+
 class ReferenceRecord(StrictFrozenModel):
     """Registry record for a resolved skill reference document."""
 
     ref_id: str
     uri: str
-    relpath: str
+    relpath: DocsPath
     mime_type: str
     title: str | None
     content: str
@@ -29,7 +34,7 @@ class SkillRecord(StrictFrozenModel):
     tags: tuple[str, ...]
     capabilities: tuple[str, ...]
     document_uri: str
-    document_relpath: str
+    document_relpath: DocsPath
     document_content: str
     references: Mapping[str, ReferenceRecord] = Field(default_factory=frozen_mapping)
 
@@ -74,7 +79,7 @@ class PromptRecord(StrictFrozenModel):
     capabilities: tuple[str, ...]
     arguments: Mapping[str, PromptArgumentEntry] = Field(default_factory=frozen_mapping)
     document_uri: str
-    document_relpath: str
+    document_relpath: DocsPath
     document_content: str
 
     @field_validator("arguments", mode="before")
@@ -196,8 +201,8 @@ class DocsRegistry(StrictFrozenModel):
     skills_by_id: Mapping[str, SkillRecord] = Field(default_factory=frozen_mapping)
     skills_in_load_order: tuple[str, ...]
     skills_summary_in_load_order: tuple[SkillSummaryRecord, ...]
-    docs_markdown_by_path: Mapping[str, str] = Field(default_factory=frozen_mapping)
-    docs_markdown_path_index: tuple[str, ...]
+    docs_markdown_by_path: Mapping[DocsPath, str] = Field(default_factory=_empty_docs_mapping)
+    docs_markdown_path_index: tuple[DocsPath, ...]
     tag_to_skill_ids: Mapping[str, tuple[str, ...]] = Field(default_factory=frozen_mapping)
     capability_to_skill_ids: Mapping[str, tuple[str, ...]] = Field(default_factory=frozen_mapping)
     prompts_by_id: Mapping[str, PromptRecord] = Field(default_factory=frozen_mapping)