@pennyfarthing/core 11.3.3 → 11.3.5

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

@@ -15,8 +15,8 @@ from typing import Any
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.prime.models import WorkflowState, WorkflowStatus
+from pf.common.config import get_project_root
+from pf.prime.models import WorkflowState, WorkflowStatus
 
 
 def find_active_session(project_root: Path) -> Path | None:
@@ -164,7 +164,7 @@ def get_backlog_count(project_root: Path) -> int:
         Number of stories available for work
     """
     # Import here to avoid circular imports
-    from pennyfarthing_scripts.sprint.loader import load_sprint
+    from pf.sprint.loader import load_sprint
 
     sprint = load_sprint(project_root)
     if not sprint or "epics" not in sprint:

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

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

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

@@ -31,7 +31,7 @@ def session_new():
     Equivalent to: pf sprint work next
     """
     # Delegate to sprint work command
-    from pennyfarthing_scripts.sprint.work import start_work
+    from pf.sprint.work import start_work
 
     start_work("next")
 
@@ -47,7 +47,7 @@ def session_continue(list_only: bool, story_id: str | None):
       --list       Display available checkpoints without restoring
       --story-id   Resume specific story directly (skip selection)
     """
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     session_dir = root / ".session"

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

@@ -4,7 +4,7 @@ Backward-compatibility shim — session start hook moved to hooks/session_start.
 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}/settings/cli.py

@@ -19,7 +19,7 @@ def settings():
 @settings.command()
 def show():
     """Pretty-print all interesting settings."""
-    from pennyfarthing_scripts.settings.settings import show_settings
+    from pf.settings.settings import show_settings
 
     click.echo(show_settings())
 
@@ -28,7 +28,7 @@ def show():
 @click.argument("key")
 def get(key: str):
     """Get a setting value by dot-path (e.g. workflow.relay_mode)."""
-    from pennyfarthing_scripts.settings.settings import get_setting
+    from pf.settings.settings import get_setting
 
     try:
         value = get_setting(key)
@@ -49,7 +49,7 @@ def get(key: str):
 @click.argument("value")
 def set(key: str, value: str):
     """Set a setting value by dot-path (e.g. workflow.bell_mode true)."""
-    from pennyfarthing_scripts.settings.settings import set_setting
+    from pf.settings.settings import set_setting
 
     set_setting(key, value)
     click.echo(f"{key} = {value}")

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

@@ -8,7 +8,7 @@ from typing import Any
 
 import yaml
 
-from pennyfarthing_scripts.common.config import get_project_root, load_pennyfarthing_config
+from pf.common.config import get_project_root, load_pennyfarthing_config
 
 # Top-level keys to show in `pf settings show` (skip layout/panel blobs)
 SHOW_KEYS = ("theme", "workflow", "jira", "display", "split", "last_panel")

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

@@ -9,26 +9,26 @@ This package provides:
 
 Usage:
     # Use the loader module
-    from pennyfarthing_scripts.sprint import load_sprint, find_epic
+    from pf.sprint import load_sprint, find_epic
     sprint_data = load_sprint()
     epic = find_epic(sprint_data, "63")
 
     # Use CLI
-    python -m pennyfarthing_scripts.sprint <subcommand> [args]
+    python -m pf.sprint <subcommand> [args]
 """
 
 # Re-export from loader for backwards compatibility
 # Import submodules to make them accessible
 # CLI entry point - import module, not function, so "from sprint import cli" gets the module
-from pennyfarthing_scripts.sprint import (
+from pf.sprint import (
     archive,
     cli,
     loader,
     status,
     work,
 )
-from pennyfarthing_scripts.sprint.cli import main
-from pennyfarthing_scripts.sprint.loader import (
+from pf.sprint.cli import main
+from pf.sprint.loader import (
     find_epic,
     find_story,
     get_all_stories,

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

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

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

@@ -6,8 +6,8 @@ Provides functions for archiving completed stories.
 
 from typing import Any
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.sprint.loader import get_story_by_id
+from pf.common.config import get_project_root
+from pf.sprint.loader import get_story_by_id
 
 
 def archive_story(
@@ -109,7 +109,7 @@ def archive_story(
             if isinstance(epic, dict):
                 epic["stories"] = [s for s in epic.get("stories", []) if s.get("id") != story_id]
 
-        from pennyfarthing_scripts.sprint.yaml_io import write_sprint
+        from pf.sprint.yaml_io import write_sprint
         write_sprint(sprint_file, sprint_data)
         msg += f" and removed from {sprint_file.name}"
 

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

@@ -10,9 +10,9 @@ from datetime import date
 from pathlib import Path
 from typing import Any
 
-from pennyfarthing_scripts.common.config import get_project_root
-from pennyfarthing_scripts.sprint.loader import load_sprint
-from pennyfarthing_scripts.sprint.yaml_io import (
+from pf.common.config import get_project_root
+from pf.sprint.loader import load_sprint
+from pf.sprint.yaml_io import (
     _get_epic_ref,
     _make_yaml,
     _read_yaml_file,

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

@@ -53,7 +53,7 @@ def status(filter: str | None):
       FILTER  - Optional status filter (backlog, in-progress, done, etc.)
     """
     # Lazy import to maintain startup performance
-    from pennyfarthing_scripts.sprint.status import format_status, get_sprint_status
+    from pf.sprint.status import format_status, get_sprint_status
 
     sprint_status = get_sprint_status(filter)
     click.echo(format_status(sprint_status))
@@ -66,7 +66,7 @@ def backlog():
     Shows stories with backlog, ready, or planning status.
     Output is grouped by epic with a markdown table per epic.
     """
-    from pennyfarthing_scripts.sprint.loader import load_sprint
+    from pf.sprint.loader import load_sprint
 
     data = load_sprint()
     if not data or "epics" not in data:
@@ -145,7 +145,7 @@ def sprint_use(name: str):
       pf sprint use default    # Clear preference, use sprint/current-sprint.yaml
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.loader import switch_sprint
+    from pf.sprint.loader import switch_sprint
 
     result = switch_sprint(name)
     if result["success"]:
@@ -171,7 +171,7 @@ def sprint_list():
     for this user (based on .pennyfarthing/config.local.yaml).
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.loader import get_active_sprint_name, load_sprint_registry
+    from pf.sprint.loader import get_active_sprint_name, load_sprint_registry
 
     registry = load_sprint_registry()
     if registry is None:
@@ -216,7 +216,7 @@ def sprint_active():
     is set, reports the default sprint/current-sprint.yaml.
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.loader import get_active_sprint_name, load_sprint_registry
+    from pf.sprint.loader import get_active_sprint_name, load_sprint_registry
 
     active = get_active_sprint_name()
     if not active:
@@ -250,8 +250,8 @@ def work(story_id: str | None, dry_run: bool):
       STORY_ID  - Story ID to work on, or 'next' for highest priority
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.loader import get_stories_by_status
-    from pennyfarthing_scripts.sprint.work import check_story, get_next_story
+    from pf.sprint.loader import get_stories_by_status
+    from pf.sprint.work import check_story, get_next_story
 
     if not story_id:
         # Show backlog
@@ -291,7 +291,7 @@ def archive(story_id: str, pr_number: str | None, apply: bool, dry_run: bool):
       PR_NUMBER  - Optional PR number if merged via PR
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.archive import archive_story
+    from pf.sprint.archive import archive_story
 
     result = archive_story(
         story_id,
@@ -328,7 +328,7 @@ def story_show(story_id: str, output_json: bool):
       STORY_ID  - Story ID (e.g., MSSCI-12664 or 67-1)
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.loader import get_story_by_id
+    from pf.sprint.loader import get_story_by_id
 
     story_data = get_story_by_id(story_id)
 
@@ -363,7 +363,7 @@ def story_size(points: int | None):
     Arguments:
       POINTS  - Optional specific point value to show guidance for
     """
-    from pennyfarthing_scripts.story.size import format_size_info, get_sizing_guidelines
+    from pf.story.size import format_size_info, get_sizing_guidelines
 
     guidelines = get_sizing_guidelines(points)
     click.echo(format_size_info(guidelines))
@@ -378,7 +378,7 @@ def story_template(template_type: str | None):
     Arguments:
       TYPE  - Template type (feature, bug, refactor, chore)
     """
-    from pennyfarthing_scripts.story.template import get_all_templates, get_template
+    from pf.story.template import get_all_templates, get_template
 
     if template_type:
         template = get_template(template_type)
@@ -406,8 +406,8 @@ def story_finish(story_id: str, dry_run: bool):
     Arguments:
       STORY_ID  - Story ID (e.g., 83-2)
     """
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.sprint.story_finish import finish_story
+    from pf.common.config import get_project_root
+    from pf.sprint.story_finish import finish_story
 
     root = get_project_root()
     result = finish_story(root, story_id, dry_run=dry_run)
@@ -447,7 +447,7 @@ def story_claim(story_id: str, claim: bool, dry_run: bool):
         action = "claim" if claim else "unclaim"
         click.echo(f"[DRY-RUN] Would {action} {story_id}")
         return
-    from pennyfarthing_scripts.jira.claim import claim_issue, unclaim_issue
+    from pf.jira.claim import claim_issue, unclaim_issue
 
     if claim:
         result = claim_issue(story_id)
@@ -461,12 +461,12 @@ def story_claim(story_id: str, claim: bool, dry_run: bool):
 
 
 # Register story-add as story.add
-from pennyfarthing_scripts.sprint.story_add import story_add_command  # noqa: E402
+from pf.sprint.story_add import story_add_command  # noqa: E402
 
 story.add_command(story_add_command, "add")
 
 # Register story-update as story.update
-from pennyfarthing_scripts.sprint.story_update import story_update_command  # noqa: E402
+from pf.sprint.story_update import story_update_command  # noqa: E402
 
 story.add_command(story_update_command, "update")
 
@@ -499,8 +499,8 @@ def epic_show(epic_id: str, output_json: bool):
     """
     import json as json_mod
 
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.sprint.loader import load_sprint
+    from pf.common.config import get_project_root
+    from pf.sprint.loader import load_sprint
 
     root = get_project_root()
     epic_data = None
@@ -627,8 +627,8 @@ def epic_cancel(epic_id: str, jira: bool, dry_run: bool):
       pf sprint epic cancel epic-42
       pf sprint epic cancel epic-42 --jira
     """
-    from pennyfarthing_scripts.common.config import get_project_root
-    from pennyfarthing_scripts.sprint.yaml_io import read_sprint, write_sprint
+    from pf.common.config import get_project_root
+    from pf.sprint.yaml_io import read_sprint, write_sprint
 
     root = get_project_root()
     sprint_dir = root / "sprint"
@@ -787,10 +787,10 @@ def epic_archive(epic_id: str | None, dry_run: bool, jira: bool):
       pf sprint epic archive epic-64 --jira     # Archive and update Jira
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.archive_epic import (
+    from pf.sprint.archive_epic import (
         archive_all_completed,
     )
-    from pennyfarthing_scripts.sprint.archive_epic import (
+    from pf.sprint.archive_epic import (
         archive_epic as do_archive_epic,
     )
 
@@ -842,7 +842,7 @@ def epic_import(epics_file: str, initiative_name: str | None, marker: str, dry_r
       pf sprint epic import docs/planning/my-feature-epics.md --dry-run
     """
     # Lazy import
-    from pennyfarthing_scripts.sprint.import_epic import import_epic as do_import
+    from pf.sprint.import_epic import import_epic as do_import
 
     result = do_import(
         epics_file,
@@ -888,7 +888,7 @@ def epic_remove(epic_id: str, dry_run: bool):
 
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     future_path = get_project_root() / "sprint" / "future.yaml"
     if not future_path.exists():
@@ -964,7 +964,7 @@ def epic_promote(epic_id: str, dry_run: bool):
 
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     sprint_dir = root / "sprint"
@@ -1064,7 +1064,7 @@ def epic_promote(epic_id: str, dry_run: bool):
         return
 
     # Validate epic shard before writing (ADR-0022)
-    from pennyfarthing_scripts.sprint.validator import validate_epic_shard
+    from pf.sprint.validator import validate_epic_shard
     validation = validate_epic_shard(dict(epic_data))
     if not validation.valid:
         error_msgs = "; ".join(e.message for e in validation.errors)
@@ -1073,7 +1073,7 @@ def epic_promote(epic_id: str, dry_run: bool):
     # Append to sprint
     sprint_data["epics"].append(epic_data)
 
-    from pennyfarthing_scripts.sprint.yaml_io import write_sprint
+    from pf.sprint.yaml_io import write_sprint
     write_sprint(sprint_file, sprint_data)
     click.echo(f"Added epic to {sprint_file}")
 
@@ -1125,12 +1125,12 @@ def epic_promote(epic_id: str, dry_run: bool):
 
 
 # Register epic-add as epic.add
-from pennyfarthing_scripts.sprint.epic_add import epic_add_command  # noqa: E402
+from pf.sprint.epic_add import epic_add_command  # noqa: E402
 
 epic.add_command(epic_add_command, "add")
 
 # Register epic-update as epic.update
-from pennyfarthing_scripts.sprint.epic_update import epic_update_command  # noqa: E402
+from pf.sprint.epic_update import epic_update_command  # noqa: E402
 
 epic.add_command(epic_update_command, "update")
 
@@ -1162,7 +1162,7 @@ def initiative_show(name: str, output_json: bool):
 
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     init_file = root / "sprint" / f"initiative-{name}.yaml"
@@ -1247,7 +1247,7 @@ def initiative_cancel(name: str, jira: bool, dry_run: bool):
     """
     import yaml
 
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     sprint_dir = root / "sprint"
@@ -1357,11 +1357,11 @@ def check(id: str):
     """
     import json
 
-    from pennyfarthing_scripts.sprint.loader import (
+    from pf.sprint.loader import (
         find_epic,
         load_sprint,
     )
-    from pennyfarthing_scripts.sprint.work import check_story, get_next_story
+    from pf.sprint.work import check_story, get_next_story
 
     data = load_sprint()
 
@@ -1477,7 +1477,7 @@ def info():
     """
     import json
 
-    from pennyfarthing_scripts.sprint.loader import get_all_stories, get_sprint_info
+    from pf.sprint.loader import get_all_stories, get_sprint_info
 
     sprint_data = get_sprint_info()
     stories = get_all_stories()
@@ -1512,7 +1512,7 @@ def metrics(output_json: bool):
     import json
     from datetime import date, datetime
 
-    from pennyfarthing_scripts.sprint.loader import get_all_stories, get_sprint_info
+    from pf.sprint.loader import get_all_stories, get_sprint_info
 
     sprint_data = get_sprint_info()
     stories = get_all_stories()
@@ -1623,7 +1623,7 @@ def story_field(story_id: str, field_name: str):
 
     Returns the field value or "null" if not found.
     """
-    from pennyfarthing_scripts.sprint.loader import get_story_by_id, get_story_field, load_sprint
+    from pf.sprint.loader import get_story_by_id, get_story_field, load_sprint
 
     # Default values for common fields
     defaults = {
@@ -1667,7 +1667,7 @@ def epic_field(epic_id: str, field_name: str):
 
     Returns the field value or "null" if not found.
     """
-    from pennyfarthing_scripts.sprint.loader import find_epic, load_sprint
+    from pf.sprint.loader import find_epic, load_sprint
 
     data = load_sprint()
     if not data:
@@ -1704,7 +1704,7 @@ def future(epic_id: 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()
     sprint_dir = root / "sprint"
@@ -1866,7 +1866,7 @@ def new_sprint(sprint_yyww: str, jira_id: int, start_date: str, end_date: str, g
     Examples:
       pf sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish"
     """
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     sprint_file = root / "sprint" / "current-sprint.yaml"
@@ -1893,7 +1893,7 @@ def new_sprint(sprint_yyww: str, jira_id: int, start_date: str, end_date: str, g
         return
 
     # Create sprint file using write_sprint for consistency
-    from pennyfarthing_scripts.sprint.yaml_io import write_sprint
+    from pf.sprint.yaml_io import write_sprint
 
     sprint_data = {
         "sprint": {
@@ -2002,7 +2002,7 @@ sprint.commands["epic-add"].hidden = True
 
 
 # Register validate command from validate_cmd module
-from pennyfarthing_scripts.sprint.validate_cmd import validate_command  # noqa: E402
+from pf.sprint.validate_cmd import validate_command  # noqa: E402
 
 sprint.add_command(validate_command)
 

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

@@ -14,8 +14,8 @@ from typing import Any
 import click
 from ruamel.yaml.comments import CommentedMap, CommentedSeq
 
-from pennyfarthing_scripts.sprint import validator as _shard_validator
-from pennyfarthing_scripts.sprint.yaml_io import (
+from pf.sprint import validator as _shard_validator
+from pf.sprint.yaml_io import (
     EPIC_KEY_ORDER,
     _get_epic_ref,
     _read_yaml_file,
@@ -161,7 +161,7 @@ def epic_add_command(
         return
 
     if sprint_file is None:
-        from pennyfarthing_scripts.common.config import get_project_root
+        from pf.common.config import get_project_root
         path = get_project_root() / "sprint" / "current-sprint.yaml"
     else:
         path = Path(sprint_file)

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

@@ -10,8 +10,8 @@ from typing import Any
 
 import click
 
-from pennyfarthing_scripts.sprint.loader import find_epic
-from pennyfarthing_scripts.sprint.yaml_io import read_sprint, write_sprint
+from pf.sprint.loader import find_epic
+from pf.sprint.yaml_io import read_sprint, write_sprint
 
 VALID_EPIC_STATUSES = {"backlog", "in_progress", "done", "canceled"}
 
@@ -121,7 +121,7 @@ def epic_update_command(
       pf sprint epic update 103 --priority P0 --dry-run
     """
     if sprint_file is None:
-        from pennyfarthing_scripts.common.config import get_project_root
+        from pf.common.config import get_project_root
 
         path = get_project_root() / "sprint" / "current-sprint.yaml"
     else:

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

@@ -10,7 +10,7 @@ from datetime import date
 from pathlib import Path
 from typing import Any
 
-from pennyfarthing_scripts.common.config import get_project_root
+from pf.common.config import get_project_root
 
 
 def parse_epics_markdown(content: str) -> dict[str, Any]:
@@ -303,7 +303,7 @@ def import_epic(
     start_epic_num = get_next_epic_number(root)
 
     # Validate each parsed epic before writing (ADR-0022)
-    from pennyfarthing_scripts.sprint.validator import validate_epic_shard
+    from pf.sprint.validator import validate_epic_shard
 
     epic_num = start_epic_num
     for epic in parsed["epics"]:

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

@@ -12,7 +12,7 @@ import warnings
 from pathlib import Path
 from typing import Any
 
-from pennyfarthing_scripts.common.config import (
+from pf.common.config import (
     get_project_root,
     load_pennyfarthing_config,
     load_yaml_config,

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

@@ -6,7 +6,7 @@ Provides functions for getting and displaying sprint status.
 
 from typing import Any
 
-from pennyfarthing_scripts.sprint.loader import get_all_stories, get_sprint_info
+from pf.sprint.loader import get_all_stories, get_sprint_info
 
 
 def get_sprint_status(filter_status: str | None = None) -> dict[str, Any]:

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

@@ -15,9 +15,9 @@ from typing import Any
 import click
 from ruamel.yaml.comments import CommentedMap
 
-from pennyfarthing_scripts.sprint.loader import find_epic
-from pennyfarthing_scripts.sprint.validator import validate_full_sprint
-from pennyfarthing_scripts.sprint.yaml_io import (
+from pf.sprint.loader import find_epic
+from pf.sprint.validator import validate_full_sprint
+from pf.sprint.yaml_io import (
     STORY_KEY_ORDER,
     read_sprint,
     write_sprint,
@@ -207,7 +207,7 @@ def add_initiative_story(
     Returns:
         Dict with success status and story_id or error
     """
-    from pennyfarthing_scripts.common.config import get_project_root
+    from pf.common.config import get_project_root
 
     root = get_project_root()
     init_path = root / "sprint" / f"initiative-{initiative_slug}.yaml"
@@ -350,7 +350,7 @@ def story_add_command(
             return
 
         if sprint_file is None:
-            from pennyfarthing_scripts.common.config import get_project_root
+            from pf.common.config import get_project_root
             path = get_project_root() / "sprint" / "current-sprint.yaml"
         else:
             path = Path(sprint_file)