@pennyfarthing/core 11.3.3 → 11.3.5

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira/reconcile.py

@@ -19,13 +19,13 @@ from datetime import datetime
 from pathlib import Path
 from typing import Any
 
-from pennyfarthing_scripts.jira.client import (
+from pf.jira.client import (
     JIRA_PROJECT,
     get_client,
     get_jira_field,
     map_status_to_jira,
 )
-from pennyfarthing_scripts.sprint.loader import load_sprint
+from pf.sprint.loader import load_sprint
 
 
 def _normalize_status(status: str) -> str:

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira/story.py

@@ -2,7 +2,7 @@
 Sync a single story between Pennyfarthing sprint YAML and Jira.
 
 Usage:
-    python -m pennyfarthing_scripts.jira story <story_key> [options]
+    python -m pf.jira story <story_key> [options]
 
 Options:
     --transition    Sync status (transition Jira issue)
@@ -11,21 +11,21 @@ Options:
     --dry-run       Show what would be done without making changes
 
 Examples:
-    python -m pennyfarthing_scripts.jira story 63-7 --transition
-    python -m pennyfarthing_scripts.jira story MSSCI-12401 --points --dry-run
+    python -m pf.jira story 63-7 --transition
+    python -m pf.jira story MSSCI-12401 --points --dry-run
 """
 
 import argparse
 import sys
 from typing import Any
 
-from pennyfarthing_scripts.jira import client as jira_client
-from pennyfarthing_scripts.sprint.loader import (
+from pf.jira import client as jira_client
+from pf.sprint.loader import (
     find_epic,
     find_story,
     get_story_by_id,
 )
-from pennyfarthing_scripts.sprint.loader import (
+from pf.sprint.loader import (
     load_sprint as load_current_sprint,
 )
 

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira/sync.py

@@ -5,7 +5,7 @@ Syncs epic stories to Jira with async parallel API calls.
 Ported from jira-sync.mjs for Python parallelism.
 
 Usage:
-    python -m pennyfarthing_scripts.jira sync <epic_number> [--dry-run] [--transition] [--points]
+    python -m pf.jira sync <epic_number> [--dry-run] [--transition] [--points]
 """
 
 from __future__ import annotations
@@ -16,15 +16,15 @@ import sys
 from dataclasses import dataclass, field
 from typing import Any
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.common.output import error, info, success, warn
-from pennyfarthing_scripts.jira.client import (
+from pf.common.config import get_project_root
+from pf.common.output import error, info, success, warn
+from pf.jira.client import (
     JiraClient,
     extract_jira_key,
     get_jira_field,
     map_status_to_jira,
 )
-from pennyfarthing_scripts.sprint.loader import find_epic, load_sprint
+from pf.sprint.loader import find_epic, load_sprint
 
 
 @dataclass

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira_bidirectional_sync.py

@@ -1,14 +1,14 @@
 """
 Bidirectional sync between sprint YAML and Jira.
 
-This module re-exports from pennyfarthing_scripts.jira.bidirectional for
+This module re-exports from pf.jira.bidirectional for
 backwards compatibility. New code should import from jira.bidirectional directly.
 
-Usage: python -m pennyfarthing_scripts.jira_bidirectional_sync [options]
+Usage: python -m pf.jira_bidirectional_sync [options]
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.jira.bidirectional import (
+from pf.jira.bidirectional import (
     SyncChange,
     SyncPlan,
     SyncResult,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira_epic_creation.py

@@ -1,15 +1,15 @@
 """
 Create Jira epics from Pennyfarthing sprint YAML definitions.
 
-This module re-exports from pennyfarthing_scripts.jira.epic for
+This module re-exports from pf.jira.epic for
 backwards compatibility. New code should import from jira.epic directly.
 
 Usage:
-    python -m pennyfarthing_scripts.jira_epic_creation <epic_id> [options]
+    python -m pf.jira_epic_creation <epic_id> [options]
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.jira.epic import (
+from pf.jira.epic import (
     build_epic_payload,
     create_epic,
     create_epic_from_yaml,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira_sync.py

@@ -1,15 +1,15 @@
 """
 Jira sync for Pennyfarthing epics.
 
-This module re-exports from pennyfarthing_scripts.jira.sync for
+This module re-exports from pf.jira.sync for
 backwards compatibility. New code should import from jira.sync directly.
 
 Usage:
-    python -m pennyfarthing_scripts.jira_sync <epic_number> [--dry-run] [--transition] [--points]
+    python -m pf.jira_sync <epic_number> [--dry-run] [--transition] [--points]
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.jira.sync import (
+from pf.jira.sync import (
     SyncResult,
     async_main,
     format_story_line,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/jira_sync_story.py

@@ -1,15 +1,15 @@
 """
 Sync a single story between Pennyfarthing sprint YAML and Jira.
 
-This module re-exports from pennyfarthing_scripts.jira.story for
+This module re-exports from pf.jira.story for
 backwards compatibility. New code should import from jira.story directly.
 
 Usage:
-    python -m pennyfarthing_scripts.jira_sync_story <story_key> [options]
+    python -m pf.jira_sync_story <story_key> [options]
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.jira.story import (
+from pf.jira.story import (
     fetch_jira_issue,
     get_story_from_sprint,
     main,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/launch/cli.py

@@ -24,7 +24,7 @@ def _ensure_wheelhub(project_dir: Path) -> tuple[int, int, bool]:
     If already running, reuses existing instance.
     If not, starts a new one and prints a mid-session OTEL note.
     """
-    from pennyfarthing_scripts.bikerack.launcher import (
+    from pf.bikerack.launcher import (
         is_already_running,
         poll_for_port_file,
         start_wheelhub,
@@ -76,7 +76,7 @@ def gui(project_dir, no_open, dry_run):
     Ensures WheelHub is running (starts it if needed), then opens
     the dashboard URL. Safe to call multiple times — reuses existing server.
     """
-    from pennyfarthing_scripts.bikerack.launcher import resolve_project_dir
+    from pf.bikerack.launcher import resolve_project_dir
 
     project_dir = resolve_project_dir(project_dir)
 
@@ -121,7 +121,7 @@ def tui(project_dir, mode, port, dry_run):
 
     Use --foreground or --detach to override auto-detection.
     """
-    from pennyfarthing_scripts.bikerack.launcher import resolve_project_dir
+    from pf.bikerack.launcher import resolve_project_dir
 
     project_dir = resolve_project_dir(project_dir)
 
@@ -148,7 +148,7 @@ def tui(project_dir, mode, port, dry_run):
             sys.exit(1)
 
     if mode == "foreground":
-        from pennyfarthing_scripts.bikerack.tui import main as tui_main
+        from pf.bikerack.tui import main as tui_main
 
         tui_main(port=port, project_dir=project_dir)
     else:
@@ -160,7 +160,7 @@ def _launch_tui_detached(project_dir: Path, port: int) -> None:
     import subprocess
 
     python = sys.executable
-    cmd = f"{python} -m pennyfarthing_scripts.bikerack.tui --port {port} --project-dir {project_dir}"
+    cmd = f"{python} -m pf.bikerack.tui --port {port} --project-dir {project_dir}"
 
     applescript = f'''
     tell application "Terminal"
@@ -187,7 +187,7 @@ def _launch_tui_detached(project_dir: Path, port: int) -> None:
 )
 def status(project_dir):
     """Show WheelHub running state."""
-    from pennyfarthing_scripts.bikerack.launcher import get_status, resolve_project_dir
+    from pf.bikerack.launcher import get_status, resolve_project_dir
 
     project_dir = resolve_project_dir(project_dir)
     result = get_status(project_dir)
@@ -213,7 +213,7 @@ def status(project_dir):
 @click.option("--dry-run", is_flag=True, help="Show what would be done without making changes.")
 def stop(project_dir, dry_run):
     """Stop WheelHub server."""
-    from pennyfarthing_scripts.bikerack.launcher import resolve_project_dir, stop_bikerack
+    from pf.bikerack.launcher import resolve_project_dir, stop_bikerack
 
     project_dir = resolve_project_dir(project_dir)
 

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/migration/__init__.py

@@ -8,7 +8,7 @@ to conform to the XML schema definitions:
 - Workflow step files -> guides/workflow-step-schema.md
 
 Usage:
-    python -m pennyfarthing_scripts.migration [command] [options]
+    python -m pf.migration [command] [options]
 
 Commands:
     session   Migrate session files to XML format
@@ -17,14 +17,14 @@ Commands:
     validate  Validate files against schemas
 """
 
-from pennyfarthing_scripts.migration.session import (
+from pf.migration.session import (
     SessionFile,
     convert_session_file,
     parse_markdown_session,
 )
-from pennyfarthing_scripts.migration.skill import audit_skill_file, audit_skills
-from pennyfarthing_scripts.migration.step import audit_step_file, audit_workflow_steps
-from pennyfarthing_scripts.migration.validate import validate_all, validate_file
+from pf.migration.skill import audit_skill_file, audit_skills
+from pf.migration.step import audit_step_file, audit_workflow_steps
+from pf.migration.validate import validate_all, validate_file
 
 __all__ = [
     "SessionFile",

package/pennyfarthing-dist/pf/migration/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for python -m pf.migration
+"""
+
+import sys
+
+from pf.migration.cli import cli
+
+if __name__ == "__main__":
+    sys.exit(cli())

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/migration/cli.py

@@ -3,7 +3,7 @@ Migration CLI - Click-based CLI for XML schema migration tools.
 
 Usage:
     pf migration [COMMAND] [ARGS]...
-    python -m pennyfarthing_scripts.migration [COMMAND] [ARGS]...
+    python -m pf.migration [COMMAND] [ARGS]...
 
 Commands:
     session   Migrate session files to XML format
@@ -18,7 +18,7 @@ from pathlib import Path
 
 import click
 
-from pennyfarthing_scripts.common.output import error, info, success, warn
+from pf.common.output import error, info, success, warn
 
 
 def _find_project_root() -> Path:
@@ -65,7 +65,7 @@ def session(file: str | None, dry_run: bool, convert_all: bool):
       pf migration session --all --dry-run
       pf migration session --all
     """
-    from pennyfarthing_scripts.migration.session import (
+    from pf.migration.session import (
         convert_session_file,
         find_session_files,
     )
@@ -147,7 +147,7 @@ def skill(skill_name: str | None, report: bool):
       pf migration skill --report
       pf migration skill sprint
     """
-    from pennyfarthing_scripts.migration.skill import audit_skills
+    from pf.migration.skill import audit_skills
 
     root = _find_project_root()
     results = audit_skills(root, skill_name=skill_name)
@@ -200,7 +200,7 @@ def step(workflow_name: str | None, report: bool):
       pf migration step --report
       pf migration step architecture
     """
-    from pennyfarthing_scripts.migration.step import audit_workflow_steps
+    from pf.migration.step import audit_workflow_steps
 
     root = _find_project_root()
     results = audit_workflow_steps(root, workflow_name=workflow_name)
@@ -253,7 +253,7 @@ def validate(file_type: str, strict: bool):
       pf migration validate --type skill
       pf migration validate --strict
     """
-    from pennyfarthing_scripts.migration.validate import validate_all
+    from pf.migration.validate import validate_all
 
     root = _find_project_root()
     summary = validate_all(root, file_type=file_type, strict=strict)

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/migration/validate.py

@@ -14,26 +14,26 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Literal
 
-from pennyfarthing_scripts.migration.session import (
+from pf.migration.session import (
     find_session_files,
     is_xml_format,
 )
-from pennyfarthing_scripts.migration.skill import (
+from pf.migration.skill import (
     RECOMMENDED_TAGS as SKILL_RECOMMENDED,
 )
-from pennyfarthing_scripts.migration.skill import (
+from pf.migration.skill import (
     REQUIRED_TAGS as SKILL_REQUIRED,
 )
-from pennyfarthing_scripts.migration.skill import (
+from pf.migration.skill import (
     find_skill_files,
 )
-from pennyfarthing_scripts.migration.step import (
+from pf.migration.step import (
     RECOMMENDED_TAGS as STEP_RECOMMENDED,
 )
-from pennyfarthing_scripts.migration.step import (
+from pf.migration.step import (
     REQUIRED_TAGS as STEP_REQUIRED,
 )
-from pennyfarthing_scripts.migration.step import (
+from pf.migration.step import (
     STEP_META_FIELDS,
     find_step_files,
 )

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/output.py

@@ -1,12 +1,12 @@
 """
 Console output utilities for Pennyfarthing scripts.
 
-This module re-exports from pennyfarthing_scripts.common.output for
+This module re-exports from pf.common.output for
 backwards compatibility. New code should import from common.output directly.
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.common.output import (
+from pf.common.output import (
     Colors,
     _colorize,
     _supports_color,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/patch_mode.py

@@ -20,7 +20,7 @@ from typing import Any
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root
+from pf.common.config import get_project_root
 
 
 @dataclass

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/preflight/__init__.py

@@ -4,7 +4,7 @@ This package provides async preflight checks that run in parallel
 to validate story completion before finishing.
 """
 
-from pennyfarthing_scripts.preflight.finish import (
+from pf.preflight.finish import (
     PreflightIssue,
     PreflightResult,
     run_finish_preflight,

package/pennyfarthing-dist/pf/preflight/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for python -m pf.preflight
+"""
+
+import sys
+
+from pf.preflight.cli import cli
+
+if __name__ == "__main__":
+    sys.exit(cli())

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/preflight/cli.py

@@ -2,7 +2,7 @@
 Preflight CLI - Fan-out CLI for preflight checks.
 
 Usage:
-    python -m pennyfarthing_scripts.preflight <subcommand> [args]
+    python -m pf.preflight <subcommand> [args]
 
 Subcommands:
     finish      Run finish preflight checks
@@ -14,7 +14,7 @@ import json
 import sys
 from pathlib import Path
 
-from pennyfarthing_scripts.preflight.finish import run_finish_preflight
+from pf.preflight.finish import run_finish_preflight
 
 
 def finish(args: list[str]) -> int:

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/pretooluse_hook.py

@@ -4,7 +4,7 @@ Backward-compatibility shim — pretooluse hook moved to hooks/cyclist_pretoolus
 This file will be removed in a future version.
 """
 
-from pennyfarthing_scripts.hooks.cyclist_pretooluse import main  # noqa: F401
+from pf.hooks.cyclist_pretooluse import main  # noqa: F401
 
 if __name__ == "__main__":
     main()

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/__init__.py

@@ -6,7 +6,7 @@ consolidating agent-session.sh, prime.sh, and workflow-status-check into a singl
 Python entry point.
 
 Usage:
-    python -m pennyfarthing_scripts.prime [--agent <name>] [--json] [--minimal] [--full]
+    python -m pf.prime [--agent <name>] [--json] [--minimal] [--full]
 
 Public API:
     prime() - Load and print context (main entry point)
@@ -42,8 +42,8 @@ Public API:
         PrimeResult - Complete prime result for JSON output
 """
 
-from pennyfarthing_scripts.prime.cli import prime
-from pennyfarthing_scripts.prime.loader import (
+from pf.prime.cli import prime
+from pf.prime.loader import (
     load_agent_definition,
     load_behavior_guide,
     load_domain_docs,
@@ -52,7 +52,7 @@ from pennyfarthing_scripts.prime.loader import (
     load_sidecars,
     load_sprint_context,
 )
-from pennyfarthing_scripts.prime.models import (
+from pf.prime.models import (
     CrewMember,
     Persona,
     PrimeResult,
@@ -60,7 +60,7 @@ from pennyfarthing_scripts.prime.models import (
     WorkflowState,
     WorkflowStatus,
 )
-from pennyfarthing_scripts.prime.persona import (
+from pf.prime.persona import (
     format_persona_output,
     get_crew_manifest,
     get_current_theme,
@@ -69,14 +69,14 @@ from pennyfarthing_scripts.prime.persona import (
     load_persona,
     load_theme,
 )
-from pennyfarthing_scripts.prime.session import (
+from pf.prime.session import (
     cleanup_old_sessions,
     get_session_agent,
     list_sessions,
     register_session,
     unregister_session,
 )
-from pennyfarthing_scripts.prime.workflow import (
+from pf.prime.workflow import (
     check_redirect,
     detect_workflow_state,
     find_active_session,

package/pennyfarthing-dist/pf/prime/__main__.py

@@ -0,0 +1,8 @@
+"""Entry point for python -m pf.prime."""
+
+import sys
+
+from pf.prime.cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/cli.py

@@ -2,7 +2,7 @@
 Prime CLI - Unified agent bootstrap for Pennyfarthing.
 
 Usage:
-    python -m pennyfarthing_scripts.prime [options]
+    python -m pf.prime [options]
 
 Options:
     --agent <name>    Load agent definition and sidecar
@@ -27,8 +27,8 @@ from typing import TYPE_CHECKING
 if TYPE_CHECKING:
     from typing import Any
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.prime.loader import (
+from pf.common.config import get_project_root
+from pf.prime.loader import (
     load_agent_definition,
     load_behavior_guide,
     load_domain_docs,
@@ -36,8 +36,8 @@ from pennyfarthing_scripts.prime.loader import (
     load_sidecars,
     load_sprint_context,
 )
-from pennyfarthing_scripts.prime.models import PrimeComponent, PrimeResult, WorkflowState
-from pennyfarthing_scripts.prime.persona import (
+from pf.prime.models import PrimeComponent, PrimeResult, WorkflowState
+from pf.prime.persona import (
     format_persona_compressed,
     format_persona_output,
     get_crew_manifest,
@@ -45,9 +45,9 @@ from pennyfarthing_scripts.prime.persona import (
     is_character_voice_enabled,
     load_persona,
 )
-from pennyfarthing_scripts.prime.session import cleanup_old_sessions, register_session
-from pennyfarthing_scripts.prime.tiers import ContextTier, load_tier_components, tier_from_string
-from pennyfarthing_scripts.prime.workflow import check_redirect, detect_workflow_state
+from pf.prime.session import cleanup_old_sessions, register_session
+from pf.prime.tiers import ContextTier, load_tier_components, tier_from_string
+from pf.prime.workflow import check_redirect, detect_workflow_state
 
 
 def _print_header(title: str, quiet: bool) -> None:
@@ -480,7 +480,7 @@ def prime(
     # PRIORITY 5.5: Repos Topology
     # ==========================================================================
     if not json_output:
-        from pennyfarthing_scripts.prime.loader import load_repos_topology
+        from pf.prime.loader import load_repos_topology
 
         topology_content = load_repos_topology(root)
         if topology_content:

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/heatmap.py

@@ -335,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(
-        [sys.executable, "-m", "pennyfarthing_scripts.cli", "agent", "start", agent_name],
+        [sys.executable, "-m", "pf.cli", "agent", "start", agent_name],
         capture_output=True,
         text=True,
         timeout=30,

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/loader.py

@@ -15,7 +15,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from pennyfarthing_scripts.common.config import get_project_root
+from pf.common.config import get_project_root
 
 
 def load_agent_definition(agent_name: str, project_root: Path | None = None) -> str | None:
@@ -67,8 +67,8 @@ def load_sprint_context(project_root: Path | None = None) -> str | None:
         Formatted sprint summary, or None if no sprint data
     """
     # Import here to avoid circular imports
-    from pennyfarthing_scripts.sprint.loader import load_sprint
-    from pennyfarthing_scripts.sprint.status import get_sprint_status
+    from pf.sprint.loader import load_sprint
+    from pf.sprint.status import get_sprint_status
 
     root = project_root or get_project_root()
     sprint_file = root / "sprint" / "current-sprint.yaml"

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/persona.py

@@ -11,14 +11,14 @@ from typing import Any
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root, load_yaml_config
-from pennyfarthing_scripts.common.themes import (
+from pf.common.config import get_project_root, load_yaml_config
+from pf.common.themes import (
     get_current_theme as _get_current_theme,
 )
-from pennyfarthing_scripts.common.themes import (
+from pf.common.themes import (
     resolve_theme_path,
 )
-from pennyfarthing_scripts.prime.models import CrewMember, Persona
+from pf.prime.models import CrewMember, Persona
 
 # Standard agent roles for crew manifest
 AGENT_ROLES = [

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/session.py

@@ -11,8 +11,8 @@ import time
 import uuid
 from pathlib import Path
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.prime.models import SessionInfo
+from pf.common.config import get_project_root
+from pf.prime.models import SessionInfo
 
 
 def get_agents_dir(project_root: Path) -> Path:

package/{pennyfarthing_scripts → pennyfarthing-dist/pf}/prime/tiers.py

@@ -35,7 +35,7 @@ def estimate_tokens(text: str) -> int:
     return max(1, len(text) // 4)
 
 
-from pennyfarthing_scripts.prime.loader import (  # noqa: E402
+from pf.prime.loader import (  # noqa: E402
     load_agent_definition,
     load_behavior_guide,
     load_repos_topology,
@@ -43,14 +43,14 @@ from pennyfarthing_scripts.prime.loader import (  # noqa: E402
     load_sidecars,
     load_sprint_context,
 )
-from pennyfarthing_scripts.prime.persona import (  # noqa: E402
+from pf.prime.persona import (  # noqa: E402
     format_persona_compressed,
     get_crew_manifest,
     get_user_title,
     is_character_voice_enabled,
     load_persona,
 )
-from pennyfarthing_scripts.prime.workflow import detect_workflow_state  # noqa: E402
+from pf.prime.workflow import detect_workflow_state  # noqa: E402
 
 
 class ContextTier(Enum):
@@ -177,7 +177,7 @@ def load_tier_components(
     if is_character_voice_enabled(project_root):
         persona, theme = load_persona(agent_name, project_root)
         if persona and theme:
-            from pennyfarthing_scripts.prime.persona import format_persona_output
+            from pf.prime.persona import format_persona_output
 
             crew = get_crew_manifest(project_root)
             user_title = get_user_title(project_root)