@pennyfarthing/core 11.3.3 → 11.3.5

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

@@ -1,7 +1,7 @@
 """
 Bidirectional sync between BMAD markdown and PF sprint YAML.
 
-Modeled on pennyfarthing_scripts/jira/bidirectional.py — same
+Modeled on pf/jira/bidirectional.py — same
 SyncPlan/SyncChange/SyncResult pattern, adapted for BMAD's flat
 markdown header format instead of a REST API.
 """
@@ -13,13 +13,13 @@ from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any, Literal
 
-from pennyfarthing_scripts.bmad.parser import (
+from pf.bmad.parser import (
     discover_bmad_stories,
     map_bmad_to_pf,
     map_pf_to_bmad,
 )
-from pennyfarthing_scripts.common.config import get_project_root, load_pennyfarthing_config
-from pennyfarthing_scripts.common.output import error, info, success, warn
+from pf.common.config import get_project_root, load_pennyfarthing_config
+from pf.common.output import error, info, success, warn
 
 
 # =============================================================================
@@ -71,7 +71,7 @@ class BmadSyncResult:
 
 def _collect_pf_stories(sprint_path: Path) -> list[dict[str, Any]]:
     """Load all PF stories that have a bmad_key field."""
-    from pennyfarthing_scripts.sprint.yaml_io import read_sprint
+    from pf.sprint.yaml_io import read_sprint
 
     data = read_sprint(sprint_path)
     stories: list[dict[str, Any]] = []
@@ -264,7 +264,7 @@ def execute_sync_plan(
     # Apply PF updates (YAML)
     pf_updates = [c for c in plan.changes if c.action == "update-pf"]
     if pf_updates and sprint_path:
-        from pennyfarthing_scripts.sprint.story_update import update_story
+        from pf.sprint.story_update import update_story
 
         for change in pf_updates:
             update_result = update_story(
@@ -290,7 +290,7 @@ def execute_sync_plan(
             config = load_pennyfarthing_config()
             bmad_config = config.get("bmad", {})
             story_subdir = bmad_config.get("story_dir", "implementation-artifacts")
-            from pennyfarthing_scripts.bmad.parser import discover_bmad_stories as _discover
+            from pf.bmad.parser import discover_bmad_stories as _discover
 
             all_bmad = _discover(bmad_root, story_dir=story_subdir)
             bmad_paths = {s["bmad_key"]: s["bmad_path"] for s in all_bmad}
@@ -326,8 +326,8 @@ def _import_new_stories(
 
     Returns count of successfully imported stories.
     """
-    from pennyfarthing_scripts.bmad.parser import discover_bmad_stories as _discover
-    from pennyfarthing_scripts.sprint.yaml_io import read_sprint, write_sprint
+    from pf.bmad.parser import discover_bmad_stories as _discover
+    from pf.sprint.yaml_io import read_sprint, write_sprint
 
     config = load_pennyfarthing_config()
     bmad_config = config.get("bmad", {})

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

@@ -7,7 +7,7 @@ from pathlib import Path
 
 import pytest
 
-from pennyfarthing_scripts.bmad.parser import (
+from pf.bmad.parser import (
     BMAD_TO_PF_STATUS,
     PF_TO_BMAD_STATUS,
     discover_bmad_stories,
@@ -244,7 +244,7 @@ class TestDiscovery:
         (epics_dir / "epic-02-ingestion.md").write_text(SAMPLE_EPIC)
         (epics_dir / "index.md").write_text("# Index\n")
 
-        from pennyfarthing_scripts.bmad.parser import discover_bmad_epics
+        from pf.bmad.parser import discover_bmad_epics
 
         epics = discover_bmad_epics(tmp_path)
 

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

@@ -6,7 +6,7 @@ from pathlib import Path
 
 import pytest
 
-from pennyfarthing_scripts.bmad.sync import (
+from pf.bmad.sync import (
     BmadSyncChange,
     BmadSyncPlan,
     _update_bmad_file_status,
@@ -31,7 +31,7 @@ def _pf_story(story_id: str, bmad_key: str, status: str = "ready") -> dict:
 
 
 def _bmad_story(bmad_key: str, bmad_status: str = "ready-for-dev") -> dict:
-    from pennyfarthing_scripts.bmad.parser import map_bmad_to_pf
+    from pf.bmad.parser import map_bmad_to_pf
 
     parts = bmad_key.split("-", 2)
     return {

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

@@ -4,7 +4,7 @@ Brownfield discovery module for Pennyfarthing.
 Analyzes existing codebases and generates AI-ready documentation.
 """
 
-from pennyfarthing_scripts.brownfield.discover import (
+from pf.brownfield.discover import (
     DepthLevel,
     DiscoveryResult,
     ProjectType,

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

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

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

@@ -2,7 +2,7 @@
 Brownfield CLI - Analyze existing codebases.
 
 Usage:
-    python -m pennyfarthing_scripts.brownfield <subcommand> [args]
+    python -m pf.brownfield <subcommand> [args]
 
 Subcommands:
     scan        Scan codebase and generate documentation
@@ -13,7 +13,7 @@ import asyncio
 import sys
 from pathlib import Path
 
-from pennyfarthing_scripts.brownfield.discover import (
+from pf.brownfield.discover import (
     DepthLevel,
     discover,
 )

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

@@ -2,7 +2,7 @@
 Pennyfarthing CLI - Command line interface for agent orchestration.
 
 Usage:
-    python -m pennyfarthing_scripts.cli [OPTIONS] COMMAND [ARGS]...
+    python -m pf.cli [OPTIONS] COMMAND [ARGS]...
     pf [OPTIONS] COMMAND [ARGS]...
 
 This module uses lazy loading to keep startup time under 200ms.
@@ -12,7 +12,7 @@ Heavy imports (httpx, workflow modules) are deferred until needed.
 import click
 
 # Get version from package - this is a fast import
-from pennyfarthing_scripts import __version__
+from pf import __version__
 
 
 @click.group()
@@ -44,7 +44,7 @@ def cli():
 
 
 # Import and register sprint group (lazy registration preserves startup time)
-from pennyfarthing_scripts.sprint.cli import sprint  # noqa: E402
+from pf.sprint.cli import sprint  # noqa: E402
 
 cli.add_command(sprint)
 
@@ -55,9 +55,9 @@ cli.add_command(sprint.commands["work"], "work")
 cli.add_command(sprint.commands["story"], "story")
 
 # Import analysis groups
-from pennyfarthing_scripts.deadcode.cli import deadcode  # noqa: E402
-from pennyfarthing_scripts.healthscore.cli import healthscore  # noqa: E402
-from pennyfarthing_scripts.hotspots.cli import hotspots  # noqa: E402
+from pf.deadcode.cli import deadcode  # noqa: E402
+from pf.healthscore.cli import healthscore  # noqa: E402
+from pf.hotspots.cli import hotspots  # noqa: E402
 
 
 @cli.group()
@@ -86,74 +86,74 @@ cli.add_command(healthscore, "healthscore")
 cli.commands["healthscore"].hidden = True
 
 # Import and register jira group
-from pennyfarthing_scripts.jira.cli import jira  # noqa: E402
+from pf.jira.cli import jira  # noqa: E402
 
 cli.add_command(jira)
 
 # Import and register bmad group
-from pennyfarthing_scripts.bmad.cli import bmad  # noqa: E402
+from pf.bmad.cli import bmad  # noqa: E402
 
 cli.add_command(bmad)
 
 # Import and register theme group
-from pennyfarthing_scripts.theme.cli import theme  # noqa: E402
+from pf.theme.cli import theme  # noqa: E402
 
 cli.add_command(theme)
 
 # Import and register validate group
-from pennyfarthing_scripts.validate.cli import validate  # noqa: E402
+from pf.validate.cli import validate  # noqa: E402
 
 cli.add_command(validate)
 
 # Import and register bikerack group
-from pennyfarthing_scripts.bikerack.cli import bikerack  # noqa: E402
+from pf.bikerack.cli import bikerack  # noqa: E402
 
 cli.add_command(bikerack)
 
 # Import and register launch group + top-level sugar aliases
-from pennyfarthing_scripts.launch.cli import launch  # noqa: E402
+from pf.launch.cli import launch  # noqa: E402
 
 cli.add_command(launch)
 cli.add_command(launch.commands["gui"], "gui")
 cli.add_command(launch.commands["tui"], "tui")
 
 # Import and register bc group
-from pennyfarthing_scripts.bc.cli import bc  # noqa: E402
+from pf.bc.cli import bc  # noqa: E402
 
 cli.add_command(bc)
 
 # Import and register handoff group
-from pennyfarthing_scripts.handoff.cli import handoff  # noqa: E402
+from pf.handoff.cli import handoff  # noqa: E402
 
 cli.add_command(handoff)
 
 # Import and register git group
-from pennyfarthing_scripts.git_group.cli import git  # noqa: E402
+from pf.git_group.cli import git  # noqa: E402
 
 cli.add_command(git)
 
 # Import and register session group
-from pennyfarthing_scripts.session.cli import session  # noqa: E402
+from pf.session.cli import session  # noqa: E402
 
 cli.add_command(session)
 
 # Import and register epic group
-from pennyfarthing_scripts.epic.cli import epic  # noqa: E402
+from pf.epic.cli import epic  # noqa: E402
 
 cli.add_command(epic)
 
 # Import and register consultation group
-from pennyfarthing_scripts.consultation.cli import consultation  # noqa: E402
+from pf.consultation.cli import consultation  # noqa: E402
 
 cli.add_command(consultation)
 
 # Import and register hooks group
-from pennyfarthing_scripts.hooks.cli import hooks  # noqa: E402
+from pf.hooks.cli import hooks  # noqa: E402
 
 cli.add_command(hooks)
 
 # Import and register settings group
-from pennyfarthing_scripts.settings.cli import settings  # noqa: E402
+from pf.settings.cli import settings  # noqa: E402
 
 cli.add_command(settings)
 
@@ -199,7 +199,7 @@ def agent_start(
       NAME  - Agent name (sm, tea, dev, reviewer, etc.)
     """
     # Lazy import - only load when command is actually invoked
-    from pennyfarthing_scripts.prime import prime
+    from pf.prime import prime
 
     exit_code = prime(
         agent_name=name,
@@ -237,7 +237,7 @@ def agent_heatmap(
       pf agent heatmap --all        # Summary across all agents
       pf agent heatmap dev --json   # JSON output for tooling
     """
-    from pennyfarthing_scripts.prime.heatmap import run_heatmap
+    from pf.prime.heatmap import run_heatmap
 
     exit_code = run_heatmap(
         agent_name=name,
@@ -249,7 +249,7 @@ def agent_heatmap(
 
 
 # Import and register workflow group
-from pennyfarthing_scripts.workflow.cli import workflow  # noqa: E402
+from pf.workflow.cli import workflow  # noqa: E402
 
 cli.add_command(workflow)
 
@@ -266,7 +266,7 @@ def help_cmd(group: str | None):
 
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     registry_path = root / "pennyfarthing-dist" / "command-registry.yaml"

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

@@ -5,8 +5,8 @@ Story 80-1: Python codemarkers module.
 Story 80-2: @deprecated detection and caller cross-reference.
 """
 
-from pennyfarthing_scripts.codemarkers.analyze import analyze_deprecations, analyze_repo
-from pennyfarthing_scripts.codemarkers.models import (
+from pf.codemarkers.analyze import analyze_deprecations, analyze_repo
+from pf.codemarkers.models import (
     CodeMarker,
     CodeMarkersResult,
     DeprecationMarker,

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

@@ -0,0 +1,6 @@
+"""Allow running as: python -m pf.codemarkers"""
+
+from pf.codemarkers.cli import codemarkers
+
+if __name__ == "__main__":
+    codemarkers()

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

@@ -15,7 +15,7 @@ from collections import defaultdict
 from datetime import UTC, datetime
 from pathlib import Path
 
-from pennyfarthing_scripts.codemarkers.models import (
+from pf.codemarkers.models import (
     CodeMarker,
     CodeMarkersResult,
     DeprecationMarker,

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

@@ -42,8 +42,8 @@ def _common_options(fn):
 
 def _run_analysis(repo: str | None, repo_path: str | None, days: int, exclude: tuple):
     """Run analysis and return result."""
-    from pennyfarthing_scripts.codemarkers.analyze import analyze_repo
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.codemarkers.analyze import analyze_repo
+    from pf.common.config import get_project_root
 
     excludes = list(exclude) if exclude else None
 
@@ -52,7 +52,7 @@ def _run_analysis(repo: str | None, repo_path: str | None, days: int, exclude: t
         return asyncio.run(analyze_repo(p.name, p, days, excludes))
     elif repo:
         project_root = get_project_root()
-        from pennyfarthing_scripts.common.config import load_yaml_config
+        from pf.common.config import load_yaml_config
         repos_yaml = load_yaml_config(project_root / ".pennyfarthing" / "repos.yaml")
         if repos_yaml and repo in repos_yaml:
             cfg = repos_yaml[repo]
@@ -74,7 +74,7 @@ def _run_analysis(repo: str | None, repo_path: str | None, days: int, exclude: t
 
 def _output_result(result, fmt: str, output_file: str | None, top: int, mode: str):
     """Format and output the analysis result."""
-    from pennyfarthing_scripts.codemarkers.formatters import (
+    from pf.codemarkers.formatters import (
         export_csv,
         export_json,
         format_marker_table,
@@ -122,22 +122,22 @@ def summary(repo, repo_path, days, top, fmt, output_file, exclude):
     """Summary counts by marker type."""
     result = _run_analysis(repo, repo_path, days, exclude)
     if fmt == "json":
-        from pennyfarthing_scripts.codemarkers.formatters import export_json
+        from pf.codemarkers.formatters import export_json
         click.echo(export_json(result))
     else:
-        from pennyfarthing_scripts.codemarkers.formatters import format_summary
+        from pf.codemarkers.formatters import format_summary
         format_summary(result, file=click.get_text_stream("stdout"))
 
 
 def _run_deprecation_analysis(repo_path, exclude):
     """Run deprecation analysis and return result dict."""
-    from pennyfarthing_scripts.codemarkers.analyze import analyze_deprecations
+    from pf.codemarkers.analyze import analyze_deprecations
 
     excludes = list(exclude) if exclude else None
     if repo_path:
         p = Path(repo_path).resolve()
     else:
-        from pennyfarthing_scripts.common.config import get_project_root
+        from pf.common.config import get_project_root
         p = get_project_root()
 
     return asyncio.run(analyze_deprecations(p, excludes))

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

@@ -13,7 +13,7 @@ import sys
 from dataclasses import asdict
 from typing import TextIO
 
-from pennyfarthing_scripts.codemarkers.models import (
+from pf.codemarkers.models import (
     CodeMarker,
     CodeMarkersResult,
 )
@@ -43,7 +43,7 @@ def format_marker_table(markers: list[CodeMarker], top_n: int = 20) -> str:
 
 def format_summary(result: CodeMarkersResult, file: TextIO = sys.stderr) -> None:
     """Print a summary header for a single repo result."""
-    from pennyfarthing_scripts.common.output import header, info
+    from pf.common.output import header, info
 
     header(f"  Code Markers: {result.repo_name}", char="=", width=60, file=file)
     info(f"Path: {result.repo_path}", file=file)

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

@@ -5,13 +5,13 @@ This package provides shared utilities used across all CLI tools:
 - config: Project configuration loading
 """
 
-from pennyfarthing_scripts.common.config import (
+from pf.common.config import (
     find_project_root,
     get_project_root,
     load_pennyfarthing_config,
     load_yaml_config,
 )
-from pennyfarthing_scripts.common.output import (
+from pf.common.output import (
     Colors,
     _colorize,
     _supports_color,

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

@@ -7,7 +7,7 @@ Values: draft | ready | none (default: draft)
 
 from __future__ import annotations
 
-from pennyfarthing_scripts.common.config import load_pennyfarthing_config
+from pf.common.config import load_pennyfarthing_config
 
 VALID_PR_MODES = {"draft", "ready", "none"}
 DEFAULT_PR_MODE = "draft"

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

@@ -20,7 +20,7 @@ from typing import Any
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root, load_yaml_config
+from pf.common.config import get_project_root, load_yaml_config
 
 
 def discover_all_theme_dirs(project_root: Path | None = None) -> list[Path]:

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

@@ -5,8 +5,8 @@ Wraps eslint with complexity rules to extract per-file metrics:
 cyclomatic complexity, function length, nesting depth, and line counts.
 """
 
-from pennyfarthing_scripts.complexity.analyze import analyze_complexity
-from pennyfarthing_scripts.complexity.models import ComplexityResult, FileComplexity
+from pf.complexity.analyze import analyze_complexity
+from pf.complexity.models import ComplexityResult, FileComplexity
 
 __all__ = [
     "FileComplexity",

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

@@ -0,0 +1,6 @@
+"""Allow running as: python -m pf.complexity"""
+
+from pf.complexity.cli import complexity
+
+if __name__ == "__main__":
+    complexity()

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

@@ -13,7 +13,7 @@ import json
 import re
 from pathlib import Path
 
-from pennyfarthing_scripts.complexity.models import ComplexityResult, FileComplexity
+from pf.complexity.models import ComplexityResult, FileComplexity
 
 # Regex patterns for extracting numeric values from ESLint messages
 COMPLEXITY_RE = re.compile(r"complexity of (\d+)")

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

@@ -2,7 +2,7 @@
 CLI commands for complexity analysis.
 
 Usage:
-    python -m pennyfarthing_scripts.complexity analyze [OPTIONS]
+    python -m pf.complexity analyze [OPTIONS]
 """
 
 from __future__ import annotations
@@ -14,7 +14,7 @@ from typing import TYPE_CHECKING
 import click
 
 if TYPE_CHECKING:
-    from pennyfarthing_scripts.complexity.models import ComplexityResult
+    from pf.complexity.models import ComplexityResult
 
 
 @click.group()
@@ -45,7 +45,7 @@ def _common_options(fn):
 
 def _run_analysis(target_path: str | None, exclude: tuple) -> ComplexityResult:
     """Run analysis and return result."""
-    from pennyfarthing_scripts.complexity.analyze import analyze_complexity
+    from pf.complexity.analyze import analyze_complexity
 
     excludes = list(exclude) if exclude else None
     p = Path(target_path).resolve() if target_path else Path(".").resolve()
@@ -54,7 +54,7 @@ def _run_analysis(target_path: str | None, exclude: tuple) -> ComplexityResult:
 
 def _output_result(result, fmt: str, output_file: str | None, top: int):
     """Format and output the analysis result."""
-    from pennyfarthing_scripts.complexity.formatters import (
+    from pf.complexity.formatters import (
         export_csv,
         export_json,
         format_file_table,

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

@@ -11,7 +11,7 @@ import io
 import json
 from dataclasses import asdict
 
-from pennyfarthing_scripts.complexity.models import ComplexityResult, FileComplexity
+from pf.complexity.models import ComplexityResult, FileComplexity
 
 
 def format_file_table(files: list[FileComplexity], top_n: int = 20) -> str:

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

@@ -1,12 +1,12 @@
 """
 Configuration loading utilities for Pennyfarthing scripts.
 
-This module re-exports from pennyfarthing_scripts.common.config for
+This module re-exports from pf.common.config for
 backwards compatibility. New code should import from common.config directly.
 """
 
 # Re-export everything from the new location
-from pennyfarthing_scripts.common.config import (
+from pf.common.config import (
     find_project_root,
     get_project_root,
     load_pennyfarthing_config,

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

@@ -34,7 +34,7 @@ def consultation():
 @click.argument("partner")
 def init(story_id: str, workflow: str, leader: str, partner: str) -> None:
     """Create a new dialogue file."""
-    from pennyfarthing_scripts.consultation.dialogue_manager import (
+    from pf.consultation.dialogue_manager import (
         DialogueHeader,
         create_dialogue_content,
     )
@@ -63,7 +63,7 @@ def init(story_id: str, workflow: str, leader: str, partner: str) -> None:
 @click.argument("confidence")
 def append(story_id: str, question: str, recommendation: str, confidence: str) -> None:
     """Append an exchange to a dialogue file."""
-    from pennyfarthing_scripts.consultation.dialogue_manager import (
+    from pf.consultation.dialogue_manager import (
         DialogueExchange,
         append_exchange_to_file,
         parse_dialogue_exchanges,
@@ -103,7 +103,7 @@ def append(story_id: str, question: str, recommendation: str, confidence: str) -
 @click.option("--note", default=None, help="Outcome note")
 def outcome(story_id: str, exchange_num: int, outcome_value: str, note: str | None) -> None:
     """Update outcome of an exchange."""
-    from pennyfarthing_scripts.consultation.dialogue_manager import (
+    from pf.consultation.dialogue_manager import (
         update_outcome_in_file,
     )
 
@@ -120,7 +120,7 @@ def outcome(story_id: str, exchange_num: int, outcome_value: str, note: str | No
 @click.argument("story_id")
 def summarize(story_id: str) -> None:
     """Refresh dialogue summary."""
-    from pennyfarthing_scripts.consultation.dialogue_manager import refresh_summary
+    from pf.consultation.dialogue_manager import refresh_summary
 
     dialogue_path = Path(".session") / f"{story_id}-dialogue.md"
     result = refresh_summary(dialogue_path)
@@ -137,7 +137,7 @@ def summarize(story_id: str) -> None:
 @click.option("--jira-key", default=None, help="Jira key for archive filename")
 def archive(story_id: str, jira_key: str | None) -> None:
     """Archive dialogue file."""
-    from pennyfarthing_scripts.consultation.dialogue_manager import archive_dialogue
+    from pf.consultation.dialogue_manager import archive_dialogue
 
     dialogue_path = Path(".session") / f"{story_id}-dialogue.md"
     archive_dir = Path(".session") / "archive"

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

@@ -0,0 +1,6 @@
+"""Allow running as python -m pf.deadcode."""
+
+from pf.deadcode.cli import deadcode
+
+if __name__ == "__main__":
+    deadcode()

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

@@ -13,7 +13,7 @@ import re
 from datetime import UTC, datetime
 from pathlib import Path
 
-from pennyfarthing_scripts.deadcode.models import (
+from pf.deadcode.models import (
     DeadCodeResult,
     StaleFile,
     UnusedExport,