@pennyfarthing/core 11.3.3 → 11.3.5

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

@@ -16,7 +16,7 @@ from typing import Any
 
 import pytest
 
-from pennyfarthing_scripts.sprint.yaml_io import (
+from pf.sprint.yaml_io import (
     EPIC_KEY_ORDER,
     SPRINT_KEY_ORDER,
     STORY_KEY_ORDER,

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

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

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

@@ -32,7 +32,7 @@ def theme():
 @theme.command("list")
 def list_cmd():
     """Show all available themes with current theme highlighted."""
-    from pennyfarthing_scripts.common.themes import format_theme_list
+    from pf.common.themes import format_theme_list
 
     click.echo(format_theme_list())
 
@@ -49,7 +49,7 @@ def show(name: str | None, full: bool):
     """
     import yaml
 
-    from pennyfarthing_scripts.common.themes import (
+    from pf.common.themes import (
         get_current_theme,
         list_themes,
         resolve_theme_path,
@@ -153,8 +153,8 @@ def set_theme(name: str, dry_run: bool):
     """
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.common.themes import (
+    from pf.common.config import get_project_root
+    from pf.common.themes import (
         list_themes,
         resolve_theme_path,
     )
@@ -242,8 +242,8 @@ def create(name: str, base: str | None, user: bool, dry_run: bool):
 
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.common.themes import (
+    from pf.common.config import get_project_root
+    from pf.common.themes import (
         get_current_theme,
         list_themes,
         resolve_theme_path,

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

@@ -13,7 +13,7 @@ from pathlib import Path
 
 import yaml
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 VALID_MODELS = {"haiku", "sonnet", "opus"}
 BUILTIN_AGENTS = {"Explore", "Plan"}

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

@@ -7,12 +7,12 @@ from __future__ import annotations
 
 from pathlib import Path
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 
 def run(root: Path, *, fix: bool = False, strict: bool = False) -> ValidateReport:
     """Validate XML schema files (sessions, skills, workflow steps)."""
-    from pennyfarthing_scripts.migration.validate import validate_all
+    from pf.migration.validate import validate_all
 
     summary = validate_all(root, file_type="all", strict=strict)
 

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

@@ -14,7 +14,7 @@ from pathlib import Path
 
 import yaml
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 _SEMVER_RE = re.compile(r"^\d+\.\d+\.\d+$")
 

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

@@ -7,7 +7,7 @@ from __future__ import annotations
 
 from pathlib import Path
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 
 def _discover_files(root: Path) -> list[Path]:
@@ -34,7 +34,7 @@ def _discover_files(root: Path) -> list[Path]:
 
 def run(root: Path, *, fix: bool = False, strict: bool = False) -> ValidateReport:
     """Validate all sprint YAML files."""
-    from pennyfarthing_scripts.sprint.validate_cmd import validate_sprint_yaml
+    from pf.sprint.validate_cmd import validate_sprint_yaml
 
     report = ValidateReport(validator="sprint")
     files = _discover_files(root)

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

@@ -11,7 +11,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 # Regex to extract <tandem-consultation> section content
 _TANDEM_RE = re.compile(

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

@@ -11,7 +11,7 @@ from __future__ import annotations
 import re
 from pathlib import Path
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 # Regex to extract <team-mode> section content
 _TEAM_MODE_RE = re.compile(r"<team-mode>(.*?)</team-mode>", re.DOTALL)

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

@@ -13,7 +13,7 @@ from pathlib import Path
 
 import yaml
 
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.validate import ValidateReport
 
 # Known workflow types
 VALID_TYPES = {"phased", "stepped", "procedural"}

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

@@ -12,17 +12,17 @@ from __future__ import annotations
 
 import click
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.common.output import error, header, info, success, warn
-from pennyfarthing_scripts.validate import ValidateReport
+from pf.common.config import get_project_root
+from pf.common.output import error, header, info, success, warn
+from pf.validate import ValidateReport
 
 VALIDATORS = {
-    "sprint": "pennyfarthing_scripts.validate.adapters.sprint",
-    "schema": "pennyfarthing_scripts.validate.adapters.schema",
-    "agent": "pennyfarthing_scripts.validate.adapters.agent",
-    "workflow": "pennyfarthing_scripts.validate.adapters.workflow",
-    "skill-command": "pennyfarthing_scripts.validate.adapters.skill_command",
-    "tandem-awareness": "pennyfarthing_scripts.validate.adapters.tandem_awareness",
+    "sprint": "pf.validate.adapters.sprint",
+    "schema": "pf.validate.adapters.schema",
+    "agent": "pf.validate.adapters.agent",
+    "workflow": "pf.validate.adapters.workflow",
+    "skill-command": "pf.validate.adapters.skill_command",
+    "tandem-awareness": "pf.validate.adapters.tandem_awareness",
 }
 
 

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

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

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

@@ -2,10 +2,10 @@
 Workflow package — scale levels, phase ownership, and workflow CLI commands.
 
 Re-exports all public symbols for backward compatibility with
-`from pennyfarthing_scripts.workflow import ...`.
+`from pf.workflow import ...`.
 """
 
-from pennyfarthing_scripts.workflow.scale import (
+from pf.workflow.scale import (
     SCALE_LEVELS,
     detect_scale_level,
     determine_scale_level,
@@ -14,7 +14,7 @@ from pennyfarthing_scripts.workflow.scale import (
     get_workflow_for_scale_level,
     scale_level_from_story_count,
 )
-from pennyfarthing_scripts.workflow.state import (
+from pf.workflow.state import (
     TDD_PHASE_OWNERS,
     TRIVIAL_PHASE_OWNERS,
     WORKFLOW_PHASES,

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

@@ -54,7 +54,7 @@ def workflow_check(output_json: bool):
 
     Returns the current story ID, phase, and workflow state.
     """
-    from pennyfarthing_scripts.workflow.state import get_workflow_state
+    from pf.workflow.state import get_workflow_state
 
     state = get_workflow_state()
 
@@ -83,7 +83,7 @@ def workflow_phase_check(workflow_name: str, phase: str):
       WORKFLOW_NAME  - The workflow type (tdd, trivial, etc.)
       PHASE          - The phase to check (red, implement, review, etc.)
     """
-    from pennyfarthing_scripts.workflow.state import get_phase_owner
+    from pf.workflow.state import get_phase_owner
 
     owner = get_phase_owner(workflow_name, phase)
     click.echo(owner)
@@ -101,7 +101,7 @@ def workflow_handoff(next_agent: str):
     Arguments:
       NEXT_AGENT  - The agent to hand off to (tea, dev, reviewer, etc.)
     """
-    from pennyfarthing_scripts.handoff.marker import generate_marker
+    from pf.handoff.marker import generate_marker
 
     click.echo(generate_marker(next_agent))
 
@@ -120,7 +120,7 @@ def workflow_type_cmd(workflow_name: str):
     Arguments:
       WORKFLOW_NAME  - Workflow name (e.g., tdd, architecture)
     """
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.workflow.helpers import (
         find_workflow_file,
         get_workflow_type,
         get_workflows_dir,
@@ -144,7 +144,7 @@ def workflow_list_cmd():
     Shows a markdown table with type, phases/steps, modes, and descriptions.
     """
 
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.workflow.helpers import (
         count_steps,
         get_workflows_dir,
         load_workflow_data,
@@ -174,7 +174,7 @@ def workflow_list_cmd():
     click.echo("| Workflow | Type | Default | Steps/Phases | Modes | Description |")
     click.echo("|----------|------|---------|--------------|-------|-------------|")
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     project_root = get_project_root()
 
@@ -237,8 +237,8 @@ def workflow_show_cmd(name: str | None):
     Arguments:
       NAME  - Workflow name (defaults to current session's workflow or tdd)
     """
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         find_workflow_file,
         get_session_dir,
         get_workflows_dir,
@@ -356,8 +356,8 @@ def workflow_start_cmd(name: str, mode: str | None):
     """
     from datetime import datetime
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         count_steps,
         find_step_file,
         find_workflow_file,
@@ -519,8 +519,8 @@ def workflow_resume_cmd(name: str | None):
     """
     from datetime import datetime
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         count_steps,
         find_step_file,
         find_workflow_file,
@@ -650,8 +650,8 @@ def workflow_status_cmd(name: str | None):
     Arguments:
       NAME  - Workflow name (auto-detects from active session if omitted)
     """
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         count_steps,
         find_workflow_file,
         find_workflow_session,
@@ -791,8 +791,8 @@ def workflow_fix_phase_cmd(story_id: str, target_phase: str, dry_run: bool):
     import re
     from datetime import datetime
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         find_story_session,
         get_session_dir,
     )
@@ -954,8 +954,8 @@ def workflow_complete_step_cmd(name: str | None, step_override: int | None):
     import re
     from datetime import datetime
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.workflow.helpers import (
+    from pf.common.config import get_project_root
+    from pf.workflow.helpers import (
         count_steps,
         find_step_file,
         find_workflow_file,

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

@@ -12,7 +12,7 @@ from pathlib import Path
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root
+from pf.common.config import get_project_root
 
 
 def get_workflows_dir(project_root: Path | None = None) -> Path:

package/pennyfarthing-dist/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "pennyfarthing-scripts"
+version = "8.1.0"
+requires-python = ">=3.11"
+dependencies = ["pyyaml>=6.0", "ruamel.yaml>=0.18", "httpx>=0.28", "click>=8.0", "pydriller>=2.6"]
+
+[project.optional-dependencies]
+tui = ["textual>=1.0", "websockets>=12.0", "textual-image>=0.7.0"]
+
+[project.scripts]
+pf = "pf.cli:main"
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+include = ["pf*"]

package/pennyfarthing-dist/scripts/core/agent-session.sh

@@ -8,11 +8,11 @@
 #
 # Session files stored in .session/agents/<session-id> for multi-session support
 
-# Find package root (where pennyfarthing_scripts lives) from script location
+# Find package root (where pf/ lives) from script location
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
-PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../../.." && pwd -P)"
+PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd -P)"
 
-# Set PYTHONPATH so Python can find pennyfarthing_scripts
+# Set PYTHONPATH so Python can find pf package
 export PYTHONPATH="${PACKAGE_ROOT}:${PYTHONPATH:-}"
 
 # Agents directory for multi-session support

package/pennyfarthing-dist/scripts/core/check-context.sh

@@ -2,7 +2,7 @@
 # check-context.sh - Check current Claude Code context usage
 # Returns: percentage and recommendation for handoff
 #
-# This is a thin wrapper around pennyfarthing_scripts/context.py
+# This is a thin wrapper around pf/context.py
 #
 # Usage:
 #   ./check-context.sh                    # Output env vars (most recent transcript)
@@ -14,7 +14,7 @@ set -euo pipefail
 
 echo "DEPRECATED: check-context.sh — use 'pf context' instead" >&2
 
-# Find project root (where pennyfarthing_scripts lives)
+# Find project root (where pf lives)
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 
 # Resolve symlinks to find actual location
@@ -29,17 +29,17 @@ if [[ "$REAL_DIR" == *"/pennyfarthing-dist/scripts/core" ]]; then
 elif [[ "$REAL_DIR" == *"/node_modules/"* ]]; then
     # In node_modules, walk up to find project root
     PACKAGE_ROOT="${REAL_DIR}"
-    while [[ "$PACKAGE_ROOT" != "/" ]] && [[ ! -d "$PACKAGE_ROOT/pennyfarthing_scripts" ]]; do
+    while [[ "$PACKAGE_ROOT" != "/" ]] && [[ ! -d "$PACKAGE_ROOT/pf" ]]; do
         PACKAGE_ROOT="$(dirname "$PACKAGE_ROOT")"
     done
 fi
 
-# Try to find pennyfarthing_scripts
+# Try to find pf
 PYTHON_MODULE=""
-if [[ -f "$PACKAGE_ROOT/pennyfarthing_scripts/context.py" ]]; then
-    PYTHON_MODULE="$PACKAGE_ROOT/pennyfarthing_scripts/context.py"
-elif [[ -f "${PROJECT_ROOT:-}/pennyfarthing_scripts/context.py" ]]; then
-    PYTHON_MODULE="${PROJECT_ROOT}/pennyfarthing_scripts/context.py"
+if [[ -f "$PACKAGE_ROOT/pf/context.py" ]]; then
+    PYTHON_MODULE="$PACKAGE_ROOT/pf/context.py"
+elif [[ -f "${PROJECT_ROOT:-}/pf/context.py" ]]; then
+    PYTHON_MODULE="${PROJECT_ROOT}/pf/context.py"
 fi
 
 # If Python module exists, use it

package/pennyfarthing-dist/scripts/hooks/pre-commit.sh

@@ -158,7 +158,7 @@ if [[ -n "$SPRINT_YAML_FILES" ]]; then
         # Set PYTHONPATH to include pennyfarthing source
         PYTHONPATH_ORIG="${PYTHONPATH:-}"
         if [[ -d "$PROJECT_ROOT/pennyfarthing" ]]; then
-            export PYTHONPATH="$PROJECT_ROOT/pennyfarthing${PYTHONPATH_ORIG:+:$PYTHONPATH_ORIG}"
+            export PYTHONPATH="$PROJECT_ROOT/pennyfarthing/pennyfarthing-dist${PYTHONPATH_ORIG:+:$PYTHONPATH_ORIG}"
         fi
 
         VALIDATION_FAILED=0
@@ -171,7 +171,7 @@ if [[ -n "$SPRINT_YAML_FILES" ]]; then
             if ! $PYTHON -c "
 import sys
 from pathlib import Path
-from pennyfarthing_scripts.sprint.validate_cmd import validate_sprint_yaml
+from pf.sprint.validate_cmd import validate_sprint_yaml
 result = validate_sprint_yaml(Path(sys.argv[1]))
 if result.errors:
     for e in result.errors:
@@ -198,7 +198,7 @@ sys.exit(0 if result.valid else 1)
             echo "COMMIT BLOCKED - Sprint YAML validation failed"
             echo ""
             echo "Fix: Review errors above, then run:"
-            echo "  python3 -m pennyfarthing_scripts.sprint.validate_cmd --fix <file>"
+            echo "  python3 -m pf.sprint.validate_cmd --fix <file>"
             echo ""
             exit 1
         fi

package/pennyfarthing-dist/scripts/jira/README.md

@@ -18,7 +18,7 @@ Scripts for Jira integration, synchronization, and story management.
 
 ## Python Implementation
 
-Core logic lives in `pennyfarthing_scripts/jira/`:
+Core logic lives in `pf/jira/`:
 - `sync.py` — Epic and story sync
 - `bidirectional.py` — Two-way YAML ↔ Jira sync
 - `story.py` — Story operations

package/pennyfarthing-dist/scripts/jira/create-jira-epic.sh

@@ -3,7 +3,7 @@
 # Usage: create-jira-epic.sh <epic-id> [--dry-run]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira create epic <epic-id> [--dry-run]
+#   python -m pf.jira create epic <epic-id> [--dry-run]
 
 set -e
 

package/pennyfarthing-dist/scripts/jira/create-jira-story.sh

@@ -3,7 +3,7 @@
 # Usage: create-jira-story.sh <epic-jira-key> <story-id> [--dry-run]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira create story <epic-jira-key> <story-id> [--dry-run]
+#   python -m pf.jira create story <epic-jira-key> <story-id> [--dry-run]
 
 set -e
 

package/pennyfarthing-dist/scripts/jira/jira-claim-story.sh

@@ -3,7 +3,7 @@
 # Usage: jira-claim-story.sh <issue-key> [--claim]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira claim <issue-key> [--claim]
+#   python -m pf.jira claim <issue-key> [--claim]
 #
 # Exit codes:
 #   0 - Story is available or successfully claimed

package/pennyfarthing-dist/scripts/jira/jira-reconcile.sh

@@ -3,7 +3,7 @@
 # Usage: jira-reconcile.sh [--fix]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira reconcile [--fix]
+#   python -m pf.jira reconcile [--fix]
 
 set -e
 

package/pennyfarthing-dist/scripts/jira/jira-sync-story.sh

@@ -3,7 +3,7 @@
 # Usage: jira-sync-story.sh <story_key> [--transition] [--points] [--comment "message"]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira create story <story_key> [options]
+#   python -m pf.jira create story <story_key> [options]
 #
 # Note: The subcommand is 'create story' but it handles sync, not creation.
 

package/pennyfarthing-dist/scripts/jira/sync-epic-jira.sh

@@ -3,7 +3,7 @@
 # Usage: sync-epic-jira.sh <epic-id> [--dry-run] [--transition] [--points] [--all]
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.jira sync <epic-id> [options]
+#   python -m pf.jira sync <epic-id> [options]
 
 set -e
 

package/pennyfarthing-dist/scripts/lib/common.sh

@@ -171,7 +171,7 @@ check_dependencies() {
 #
 # Usage:
 #   get_python
-#   $PYTHON_CMD -m pennyfarthing_scripts.jira view MSSCI-12345
+#   $PYTHON_CMD -m pf.jira view MSSCI-12345
 #
 get_python() {
     # Find project root if not set
@@ -197,7 +197,7 @@ get_python() {
 }
 
 # run_python_module MODULE [ARGS...]
-# Run a pennyfarthing_scripts Python module with proper venv handling
+# Run a pf Python module with proper venv handling
 #
 # Usage:
 #   run_python_module jira view MSSCI-12345
@@ -208,5 +208,5 @@ run_python_module() {
     get_python || return 1
     local module="$1"
     shift
-    exec $PYTHON_CMD -m "pennyfarthing_scripts.${module}" "$@"
+    exec $PYTHON_CMD -m "pf.${module}" "$@"
 }

package/pennyfarthing-dist/scripts/lib/run-pf.sh

@@ -2,8 +2,9 @@
 # Shared utility: Run the `pf` CLI via uv run — no global install needed.
 #
 # Resolution order for pyproject.toml:
-# 1. Dogfooding: $PROJECT_ROOT/pennyfarthing/pyproject.toml (inlined repo)
-# 2. Consumer:   $PROJECT_ROOT/pyproject.toml (project declares dependency)
+# 1. Dogfooding: $PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml (inlined repo)
+# 2. Consumer:   $PROJECT_ROOT/.pennyfarthing/pyproject.toml (symlinked from dist)
+# 3. Fallback:   $PROJECT_ROOT/pyproject.toml (project declares dependency)
 #
 # Usage from hook shims:
 #   source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
@@ -15,25 +16,22 @@ source "$_lib_dir/find-root.sh"
 
 # Find the pyproject.toml that provides pennyfarthing-scripts
 _pf_project=""
-if [[ -f "$PROJECT_ROOT/pennyfarthing/pyproject.toml" ]]; then
+if [[ -f "$PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml" ]]; then
     # Dogfooding: inlined framework repo
-    _pf_project="$PROJECT_ROOT/pennyfarthing"
-elif [[ -f "$PROJECT_ROOT/node_modules/@pennyfarthing/core/pyproject.toml" ]]; then
-    # Symlink install: npm package has full Python source
-    _pf_project="$PROJECT_ROOT/node_modules/@pennyfarthing/core"
+    _pf_project="$PROJECT_ROOT/pennyfarthing/pennyfarthing-dist"
+elif [[ -f "$PROJECT_ROOT/.pennyfarthing/pyproject.toml" ]]; then
+    # Consumer: auto-generated by pennyfarthing init (symlinked from dist)
+    _pf_project="$PROJECT_ROOT/.pennyfarthing"
 elif [[ -f "$PROJECT_ROOT/pyproject.toml" ]]; then
     # Consumer: project-level pyproject.toml with pennyfarthing-scripts dep
     _pf_project="$PROJECT_ROOT"
-elif [[ -f "$PROJECT_ROOT/.pennyfarthing/pyproject.toml" ]]; then
-    # Consumer: auto-generated by pennyfarthing init
-    _pf_project="$PROJECT_ROOT/.pennyfarthing"
 fi
 
 if [[ -z "$_pf_project" ]]; then
     echo "Error: No pyproject.toml found for pennyfarthing-scripts" >&2
-    echo "Expected: $PROJECT_ROOT/pennyfarthing/pyproject.toml (dogfooding)" >&2
-    echo "      or: $PROJECT_ROOT/pyproject.toml (consumer)" >&2
-    echo "      or: $PROJECT_ROOT/.pennyfarthing/pyproject.toml (auto-generated)" >&2
+    echo "Expected: $PROJECT_ROOT/pennyfarthing/pennyfarthing-dist/pyproject.toml (dogfooding)" >&2
+    echo "      or: $PROJECT_ROOT/.pennyfarthing/pyproject.toml (consumer)" >&2
+    echo "      or: $PROJECT_ROOT/pyproject.toml (fallback)" >&2
     exit 1
 fi
 

package/pennyfarthing-dist/scripts/sprint/README.md

@@ -40,5 +40,5 @@ pf.sh sprint epic promote epic-41
 ## Migration Note
 
 All bash scripts previously in this directory have been migrated to Python CLI
-commands in `pennyfarthing_scripts/sprint/cli.py`. See PR #716 and the follow-up
+commands in `pf/sprint/cli.py`. See PR #716 and the follow-up
 deprecation commit for details.

package/pennyfarthing-dist/scripts/story/create-story.sh

@@ -6,7 +6,7 @@
 #   --priority P0|P1|P2|P3             Priority (default: P2)
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.story create <epic-id> "<title>" <points> [options]
+#   python -m pf.story create <epic-id> "<title>" <points> [options]
 
 set -e
 

package/pennyfarthing-dist/scripts/story/size-story.sh

@@ -5,7 +5,7 @@
 #   points:  Show specific guidance for that point value
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.story size [points]
+#   python -m pf.story size [points]
 
 set -e
 

package/pennyfarthing-dist/scripts/story/story-template.sh

@@ -5,7 +5,7 @@
 #   type:    Show specific template
 #
 # Thin wrapper that delegates to Python CLI:
-#   python -m pennyfarthing_scripts.story template [type]
+#   python -m pf.story template [type]
 
 set -e