@pennyfarthing/core 10.2.0 → 10.3.1

package/pennyfarthing_scripts/healthscore/analyze.py

@@ -490,7 +490,8 @@ async def _probe_agent_context_efficiency(target_path: Path) -> float | None:
     from pennyfarthing_scripts.prime.tiers import ContextTier, load_tier_components
 
     agents = ["sm", "tea", "dev", "reviewer", "architect",
-              "pm", "tech-writer", "ux-designer", "devops", "orchestrator"]
+              "pm", "tech-writer", "ux-designer", "devops", "orchestrator",
+              "ba"]
 
     target_budget = 4000
     scores: list[float] = []

package/pennyfarthing_scripts/prime/__init__.py

@@ -47,6 +47,7 @@ from pennyfarthing_scripts.prime.loader import (
     load_agent_definition,
     load_behavior_guide,
     load_domain_docs,
+    load_repos_topology,
     load_session_context,
     load_sidecars,
     load_sprint_context,
@@ -94,6 +95,7 @@ __all__ = [
     "load_session_context",
     "load_sidecars",
     "load_domain_docs",
+    "load_repos_topology",
     # Workflow detection
     "detect_workflow_state",
     "check_redirect",

package/pennyfarthing_scripts/prime/cli.py

@@ -102,6 +102,7 @@ def _component_header(name: str, agent_name: str | None) -> str:
         "persona_compressed": f"Persona: {agent_name} (compressed)",
         "behavior_guide": "Agent Behavior Guide",
         "sprint_context": "Sprint Context",
+        "repos_topology": "Repos Topology",
         "session_header": "Active Session",
         "session_assessment": "Session Assessment",
         "sidecars": f"Agent Sidecar: {agent_name}",
@@ -118,6 +119,7 @@ def _component_source(name: str, agent_name: str | None, root: Path) -> str | No
         "persona_compressed": None,
         "behavior_guide": ".pennyfarthing/guides/agent-behavior.md",
         "sprint_context": "sprint/current-sprint.yaml",
+        "repos_topology": ".pennyfarthing/repos.yaml",
         "session_header": None,
         "session_assessment": None,
         "sidecars": f".pennyfarthing/sidecars/{agent_name}/",
@@ -474,6 +476,17 @@ def prime(
             _print_header("Sprint Context", quiet)
             print(sprint_content)
 
+    # ==========================================================================
+    # PRIORITY 5.5: Repos Topology
+    # ==========================================================================
+    if not json_output:
+        from pennyfarthing_scripts.prime.loader import load_repos_topology
+
+        topology_content = load_repos_topology(root)
+        if topology_content:
+            _print_header("Repos Topology", quiet)
+            print(topology_content)
+
     # ==========================================================================
     # PRIORITY 6: Session context
     # ==========================================================================

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