docstrings

src/personal_mcp/registry/models/registry.py

@@ -9,6 +9,8 @@ from .prompt import PromptArgumentEntry
 
 
 class ReferenceRecord(StrictFrozenModel):
+    """Registry record for a resolved skill reference document."""
+
     ref_id: str
     uri: str
     relpath: str
@@ -18,6 +20,8 @@ class ReferenceRecord(StrictFrozenModel):
 
 
 class SkillRecord(StrictFrozenModel):
+    """Registry record containing a fully resolved skill and references."""
+
     skill_id: str
     name: str
     description: str
@@ -37,6 +41,8 @@ class SkillRecord(StrictFrozenModel):
 
 
 class SkillSummaryRecord(StrictFrozenModel):
+    """Compact skill summary exposed by catalog listing APIs."""
+
     skill_id: str
     name: str
     description: str
@@ -47,6 +53,8 @@ class SkillSummaryRecord(StrictFrozenModel):
 
 
 class PromptRecord(StrictFrozenModel):
+    """Registry record containing a fully resolved prompt document."""
+
     prompt_id: str
     name: str
     description: str
@@ -65,6 +73,8 @@ class PromptRecord(StrictFrozenModel):
 
 
 class PromptSummaryRecord(StrictFrozenModel):
+    """Compact prompt summary exposed by catalog listing APIs."""
+
     prompt_id: str
     name: str
     description: str
@@ -75,6 +85,8 @@ class PromptSummaryRecord(StrictFrozenModel):
 
 
 class DocsRegistry(StrictFrozenModel):
+    """In-memory index of loaded skills, prompts, and docs content."""
+
     skills_by_id: Mapping[str, SkillRecord] = Field(default_factory=frozen_mapping)
     skills_in_load_order: tuple[str, ...]
     skills_summary_in_load_order: tuple[SkillSummaryRecord, ...]