@pennyfarthing/core 10.2.0 → 10.3.0

package/pennyfarthing_scripts/prime/loader.py

@@ -236,3 +236,73 @@ def load_domain_docs(project_root: Path | None = None) -> list[tuple[str, str]]:
         docs.append((doc_file.name, doc_file.read_text()))
 
     return docs
+
+
+def load_repos_topology(project_root: Path | None = None) -> str | None:
+    """Load repos.yaml topology as formatted context for agents.
+
+    Reads .pennyfarthing/repos.yaml and formats the topology fields
+    (owns, never_edit, symlinks, ui_layer, components_path) as a
+    readable manifest for agent spatial awareness.
+
+    Args:
+        project_root: Project root path (auto-detected if not provided)
+
+    Returns:
+        Formatted topology context string, or None if unavailable
+    """
+    import yaml
+
+    root = project_root or get_project_root()
+    repos_file = root / ".pennyfarthing" / "repos.yaml"
+
+    if not repos_file.exists():
+        return None
+
+    try:
+        data = yaml.safe_load(repos_file.read_text())
+    except Exception:
+        return None
+
+    if not isinstance(data, dict) or "repos" not in data:
+        return None
+
+    repos = data["repos"]
+    if not repos:
+        return None
+
+    lines: list[str] = []
+    for name, config in repos.items():
+        lines.append(f"## {name}")
+        if config.get("path"):
+            lines.append(f"Path: {config['path']}")
+        if config.get("type"):
+            lines.append(f"Type: {config['type']}")
+        if config.get("description"):
+            lines.append(f"Description: {config['description']}")
+
+        owns = config.get("owns", [])
+        if owns:
+            lines.append(f"Owns: {', '.join(owns)}")
+
+        never_edit = config.get("never_edit", [])
+        if never_edit:
+            lines.append(f"Never Edit: {', '.join(never_edit)}")
+
+        symlinks = config.get("symlinks", {})
+        if symlinks:
+            lines.append("Symlinks:")
+            for src, dest in symlinks.items():
+                lines.append(f"  {src} → {dest}")
+
+        ui_layer = config.get("ui_layer")
+        if ui_layer:
+            lines.append(f"UI Layer: {ui_layer}")
+
+        components_path = config.get("components_path")
+        if components_path:
+            lines.append(f"Components: {components_path}")
+
+        lines.append("")
+
+    return "\n".join(lines).strip() if lines else None

package/pennyfarthing_scripts/prime/persona.py

@@ -24,6 +24,7 @@ from pennyfarthing_scripts.prime.models import CrewMember, Persona
 AGENT_ROLES = [
     "sm", "tea", "dev", "reviewer", "architect",
     "pm", "tech-writer", "ux-designer", "devops", "orchestrator",
+    "ba",
 ]
 
 
@@ -129,7 +130,7 @@ def get_crew_manifest(project_root: Path | None = None) -> list[CrewMember]:
         project_root: Project root path (auto-detected if not provided)
 
     Returns:
-        List of CrewMember objects for all 10 standard roles
+        List of CrewMember objects for all 11 standard roles
     """
     root = project_root or get_project_root()
     theme = get_current_theme(root)

package/pennyfarthing_scripts/prime/tiers.py

@@ -38,6 +38,7 @@ def estimate_tokens(text: str) -> int:
 from pennyfarthing_scripts.prime.loader import (  # noqa: E402
     load_agent_definition,
     load_behavior_guide,
+    load_repos_topology,
     load_session_context,
     load_sidecars,
     load_sprint_context,
@@ -134,6 +135,10 @@ def load_tier_components(
         if sprint_content:
             add_component("sprint_context", sprint_content)
 
+        topology_content = load_repos_topology(project_root)
+        if topology_content:
+            add_component("repos_topology", topology_content)
+
         session_result = load_session_context(project_root)
         if session_result:
             filename, header, _ = session_result
@@ -156,6 +161,10 @@ def load_tier_components(
                 compressed = format_persona_compressed(persona, theme, agent_name)
                 add_component("persona_compressed", compressed)
 
+        topology_content = load_repos_topology(project_root)
+        if topology_content:
+            add_component("repos_topology", topology_content)
+
         components["token_counts"] = token_counts
         components["total_tokens"] = sum(token_counts.values())
         return components
@@ -185,6 +194,10 @@ def load_tier_components(
     if sprint_content:
         add_component("sprint_context", sprint_content)
 
+    topology_content = load_repos_topology(project_root)
+    if topology_content:
+        add_component("repos_topology", topology_content)
+
     session_result = load_session_context(project_root)
     if session_result:
         filename, header, assessment = session_result