@pennyfarthing/core 11.2.1 → 11.2.2

package/pennyfarthing_scripts/hooks/bell_mode.py

@@ -32,7 +32,6 @@ from pennyfarthing_scripts.hooks import (
     send_to_cyclist,
 )
 
-
 # =============================================================================
 # Bell Queue
 # =============================================================================

package/pennyfarthing_scripts/hooks/pre_edit_check.py

@@ -15,7 +15,6 @@ import os
 import sys
 from pathlib import Path
 
-
 # Protected patterns — files that should never be edited automatically
 PROTECTED_PATTERNS = [
     "*.env",

package/pennyfarthing_scripts/hooks/reflector_check.py

@@ -17,7 +17,6 @@ import sys
 from pathlib import Path
 from typing import Any
 
-
 # =============================================================================
 # Import detection logic — inline to avoid import path issues
 # The logic lives in question_reflector_check.py in pennyfarthing-dist/scripts/hooks/
@@ -214,7 +213,7 @@ def main() -> None:
         sys.exit(0)
 
     project_dir = os.environ.get('CLAUDE_PROJECT_DIR', os.getcwd())
-    config = _load_config(project_dir)
+    _load_config(project_dir)
 
     # Prevent infinite loops
     if input_data.get('stop_hook_active'):

package/pennyfarthing_scripts/hooks/schema_validation.py

@@ -18,7 +18,6 @@ from pennyfarthing_scripts.hooks import (
     read_stdin_json,
 )
 
-
 # =============================================================================
 # File Type Detection
 # =============================================================================

package/pennyfarthing_scripts/hooks/session_start.py

@@ -21,13 +21,11 @@ from datetime import UTC, datetime
 from pathlib import Path
 
 from pennyfarthing_scripts.hooks import (
-    find_project_root,
     is_cyclist_running,
     load_settings,
     send_to_cyclist,
 )
 
-
 # =============================================================================
 # Session Setup
 # =============================================================================
@@ -138,7 +136,7 @@ def _ensure_wheelhub(project_dir: Path) -> int | None:
     )
 
     # Skip if full Cyclist is running
-    cyclist_port_file = project_dir / ".wheelhub-port"
+    cyclist_port_file = project_dir / ".bikerack-port"
     if cyclist_port_file.exists():
         try:
             return int(cyclist_port_file.read_text().strip())
@@ -177,11 +175,11 @@ def _write_env_file(project_dir: Path, session_id: str, otel_port: int | None) -
     ]
 
     if otel_port is not None:
-        lines.extend([
-            "# OTEL auto-configuration for Cyclist/WheelHub",
-            'export OTEL_EXPORTER_OTLP_PROTOCOL="http/json"',
-            f'export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:{otel_port}"',
-        ])
+        from pennyfarthing_scripts.bikerack.launcher import build_otel_env
+
+        lines.append("# OTEL auto-configuration for Cyclist/WheelHub")
+        for key, value in build_otel_env(otel_port).items():
+            lines.append(f'export {key}="{value}"')
 
     with open(env_file, "a") as f:
         f.write("\n".join(lines) + "\n")

package/pennyfarthing_scripts/hooks/statusline.py

@@ -16,6 +16,8 @@ import subprocess
 import sys
 from pathlib import Path
 
+from pennyfarthing_scripts.hooks import load_settings
+
 try:
     import yaml
     HAS_YAML = True
@@ -349,7 +351,14 @@ def main() -> None:
         session_id = data.get("session_id", "")
 
         model = _get_model_name(data)
-        branch, branch_dirty = _get_git_info(cwd) if cwd else ("", "")
+
+        # Check git_monitor setting — skip git calls when disabled
+        _settings = load_settings(Path(project_root) if project_root else None)
+        if cwd and _settings.git_monitor:
+            branch, branch_dirty = _get_git_info(cwd)
+        else:
+            branch, branch_dirty = "", ""
+
         pct = _get_context_pct(data)
 
         agent_name = _resolve_agent(project_root, session_id)

package/pennyfarthing_scripts/prime/heatmap.py

@@ -14,13 +14,10 @@ Usage:
 from __future__ import annotations
 
 import json
-import math
 import re
 import subprocess
 import sys
 from dataclasses import dataclass, field
-from pathlib import Path
-
 
 # ── Section Categories ──────────────────────────────────────────────
 
@@ -204,7 +201,6 @@ def parse_sections(raw_output: str) -> list[Section]:
     current_section_lines: list[str] = []
     in_agent_def = False
     in_behavior_guide = False
-    in_sidecar = False
 
     def _flush_section(end_line: int) -> None:
         """Emit the current section."""
@@ -245,42 +241,36 @@ def parse_sections(raw_output: str) -> list[Section]:
                 current_section_name = "Workflow State"
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = False
             elif header_text.startswith("Agent Definition"):
                 current_component = "agent_definition"
                 current_section_category = "identity"
                 current_section_name = "Agent Definition"
                 in_agent_def = True
                 in_behavior_guide = False
-                in_sidecar = False
             elif header_text.startswith("Persona:"):
                 current_component = "persona"
                 current_section_category = "persona"
                 current_section_name = header_text
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = False
             elif header_text.startswith("Agent Behavior Guide"):
                 current_component = "behavior_guide"
                 current_section_category = "shared"
                 current_section_name = "BG: Preamble"
                 in_agent_def = False
                 in_behavior_guide = True
-                in_sidecar = False
             elif header_text.startswith("Sprint Context"):
                 current_component = "sprint_context"
                 current_section_category = "shared"
                 current_section_name = "Sprint Context"
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = False
             elif header_text.startswith("Repos Topology"):
                 current_component = "repos_topology"
                 current_section_category = "shared"
                 current_section_name = "Repos Topology"
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = False
             elif header_text.startswith("Agent Sidecar:"):
                 current_component = "sidecars"
                 current_section_category = "learned"
@@ -288,14 +278,12 @@ def parse_sections(raw_output: str) -> list[Section]:
                 current_section_name = f"Sidecar: {sidecar_file.replace('.md', '').title()}"
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = True
             elif header_text.startswith("Active Session:"):
                 current_component = "session"
                 current_section_category = "routing"
                 current_section_name = "Active Session"
                 in_agent_def = False
                 in_behavior_guide = False
-                in_sidecar = False
 
             current_section_start = i
             current_section_lines = [line]
@@ -347,7 +335,7 @@ def _pretty_tag(tag: str) -> str:
 def capture_agent_output(agent_name: str) -> str:
     """Run pf agent start and capture raw output."""
     result = subprocess.run(
-        ["pf", "agent", "start", agent_name],
+        [sys.executable, "-m", "pennyfarthing_scripts.cli", "agent", "start", agent_name],
         capture_output=True,
         text=True,
         timeout=30,
@@ -484,10 +472,10 @@ def render_summary(heatmaps: list[AgentHeatmap]) -> str:
     comp_labels = ["Route", "Ident", "Guard", "Proced", "Refer", "Perso", "Shared", "Learn"]
 
     # Find max per category across all agents
-    cat_maxes: dict[str, int] = {c: 0 for c in components}
+    cat_maxes: dict[str, int] = dict.fromkeys(components, 0)
     agent_cats: dict[str, dict[str, int]] = {}
     for hm in heatmaps:
-        agent_cats[hm.agent] = {c: 0 for c in components}
+        agent_cats[hm.agent] = dict.fromkeys(components, 0)
         for s in hm.sections:
             agent_cats[hm.agent][s.category] = agent_cats[hm.agent].get(s.category, 0) + s.tokens
         for c in components:

package/pennyfarthing_scripts/sprint/cli.py

@@ -7,6 +7,9 @@ Usage:
 Commands:
     status      Show sprint status
     backlog     Show available stories
+    use         Switch active sprint (multi-sprint projects)
+    list        Show registered sprints from sprint/sprints.yaml
+    active      Show which sprint is currently active
     work        Start work on a story
     archive     Archive a completed story
     story       Story subcommands (show, add, update, size, template, finish, claim)
@@ -25,6 +28,9 @@ def sprint():
     Commands:
       status   - Show sprint status
       backlog  - Show available stories
+      use      - Switch active sprint (multi-sprint projects)
+      list     - Show registered sprints
+      active   - Show which sprint is active
       story    - Story operations (show, add, update, size, template, finish, claim)
       epic     - Epic operations (show, add, promote, archive, cancel, import, remove)
       initiative - Initiative operations (show, cancel)
@@ -118,6 +124,121 @@ def backlog():
     click.echo(f"**Total available:** {total_count} stories, {total_points} points")
 
 
+@sprint.command("use")
+@click.argument("name")
+def sprint_use(name: str):
+    """Switch the active sprint (per-user preference).
+
+    \b
+    Validates the sprint name against sprint/sprints.yaml, then saves
+    the preference to .pennyfarthing/config.local.yaml. Does not modify
+    any shared repo files. Use "default" to clear the preference.
+
+    \b
+    Arguments:
+      NAME  - Sprint name from the registry, or "default" to clear
+
+    \b
+    Examples:
+      pf sprint use main       # Switch to main project sprint
+      pf sprint use ocsf-rs1   # Switch to OCSF research spike
+      pf sprint use default    # Clear preference, use sprint/current-sprint.yaml
+    """
+    # Lazy import
+    from pennyfarthing_scripts.sprint.loader import switch_sprint
+
+    result = switch_sprint(name)
+    if result["success"]:
+        entry = result.get("sprint", {})
+        click.echo(result["message"])
+        if entry.get("description"):
+            click.echo(f"  {entry['description']}")
+        if entry.get("type"):
+            click.echo(f"  Type: {entry['type']}")
+        if entry.get("repos"):
+            click.echo(f"  Repos: {', '.join(entry['repos'])}")
+    else:
+        raise click.ClickException(result["error"])
+
+
+@sprint.command("list")
+def sprint_list():
+    """Show all registered sprints from the sprint registry.
+
+    \b
+    Reads sprint/sprints.yaml and displays each registered sprint
+    with its type, description, and whether it is currently active
+    for this user (based on .pennyfarthing/config.local.yaml).
+    """
+    # Lazy import
+    from pennyfarthing_scripts.sprint.loader import get_active_sprint_name, load_sprint_registry
+
+    registry = load_sprint_registry()
+    if registry is None:
+        click.echo("No sprint registry found (sprint/sprints.yaml)")
+        click.echo("This project uses a single sprint.")
+        return
+
+    active = get_active_sprint_name()
+    sprints = registry.get("sprints", {})
+
+    if not sprints:
+        click.echo("Sprint registry is empty.")
+        return
+
+    click.echo("Registered Sprints:")
+    click.echo("")
+
+    for name, entry in sprints.items():
+        marker = "*" if name == active else " "
+        desc = entry.get("description", "")
+        sprint_type = entry.get("type", "project")
+        repos = ", ".join(entry.get("repos", []))
+        click.echo(f"  {marker} {name:<16} [{sprint_type}] {desc}")
+        if repos:
+            click.echo(f"    Repos: {repos}")
+
+    click.echo("")
+    if active:
+        click.echo(f"Active: {active} (per-user preference)")
+    else:
+        click.echo("Active: default (sprint/current-sprint.yaml)")
+    click.echo("Switch: pf sprint use <name>")
+
+
+@sprint.command("active")
+def sprint_active():
+    """Show which sprint is currently active for this user.
+
+    \b
+    Reads the per-user preference from .pennyfarthing/config.local.yaml
+    and displays the active sprint name and metadata. If no preference
+    is set, reports the default sprint/current-sprint.yaml.
+    """
+    # Lazy import
+    from pennyfarthing_scripts.sprint.loader import get_active_sprint_name, load_sprint_registry
+
+    active = get_active_sprint_name()
+    if not active:
+        click.echo("default (sprint/current-sprint.yaml)")
+        click.echo("  No per-user sprint preference set.")
+        click.echo("  Set one with: pf sprint use <name>")
+        return
+
+    registry = load_sprint_registry()
+    if registry:
+        sprints = registry.get("sprints", {})
+        entry = sprints.get(active, {})
+        sprint_type = entry.get("type", "project")
+        desc = entry.get("description", "")
+        click.echo(f"{active} ({sprint_type})")
+        if desc:
+            click.echo(f"  {desc}")
+    else:
+        click.echo(f"{active}")
+        click.echo("  (no sprint registry found to look up metadata)")
+
+
 @sprint.command()
 @click.argument("story_id", required=False)
 @click.option("--dry-run", is_flag=True, help="Show what would be done without making changes")