@pennyfarthing/core 11.2.1 → 11.2.2

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

@@ -9,7 +9,7 @@ Uncategorized utilities and one-off scripts.
 | `deploy.sh` | Deployment script |
 | `doctor-dogfood.sh` | Health check for framework/orchestrator development setup |
 | `run-ci.sh` | Run CI locally |
-| `pf hooks statusline` | Status line configuration |
+| `pf.sh hooks statusline` | Status line configuration |
 | `uninstall.sh` | Uninstall Pennyfarthing from project |
 | `backlog.sh` | Backlog operations |
 | `repo-utils.sh` | Multi-repo utilities |

package/pennyfarthing-dist/scripts/misc/statusline.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
-# DEPRECATED: This script is a shim. Logic has moved to Python.
-# Use: pf hooks statusline
-exec pf hooks statusline
+# Shim: delegates to Python CLI via uv run — no global pf install needed.
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf hooks statusline

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

@@ -1,35 +1,35 @@
 # Sprint Scripts
 
-Sprint management is handled by the Python CLI: `pf sprint [COMMAND]`.
+Sprint management is handled by the Python CLI: `pf.sh sprint [COMMAND]`.
 
 ## Commands
 
 | Command | Purpose |
 |---------|---------|
-| `pf sprint status` | Show current sprint status and metrics |
-| `pf sprint backlog` | List available stories grouped by epic |
-| `pf sprint info` | Sprint info as JSON (for Cyclist sidebar) |
-| `pf sprint metrics` | Sprint velocity and progress metrics |
-| `pf sprint check <id>` | Check story/epic availability (JSON) |
-| `pf sprint future` | Show future initiatives and epics |
-| `pf sprint new` | Initialize a new sprint |
-| `pf sprint validate <file>` | Validate sprint YAML structure |
-| `pf sprint archive <id>` | Archive a completed story |
-| `pf sprint work <id>` | Start work on a story |
-| `pf sprint story field <id> <field>` | Get a story field value |
-| `pf sprint epic field <id> <field>` | Get an epic field value |
-| `pf sprint epic promote <id>` | Move epic from future to current sprint |
-| `pf sprint epic show <id>` | Show epic details |
-| `pf sprint epic cancel <id>` | Cancel an epic |
-| `pf sprint epic archive` | Archive completed epics |
+| `pf.sh sprint status` | Show current sprint status and metrics |
+| `pf.sh sprint backlog` | List available stories grouped by epic |
+| `pf.sh sprint info` | Sprint info as JSON (for Cyclist sidebar) |
+| `pf.sh sprint metrics` | Sprint velocity and progress metrics |
+| `pf.sh sprint check <id>` | Check story/epic availability (JSON) |
+| `pf.sh sprint future` | Show future initiatives and epics |
+| `pf.sh sprint new` | Initialize a new sprint |
+| `pf.sh sprint validate <file>` | Validate sprint YAML structure |
+| `pf.sh sprint archive <id>` | Archive a completed story |
+| `pf.sh sprint work <id>` | Start work on a story |
+| `pf.sh sprint story field <id> <field>` | Get a story field value |
+| `pf.sh sprint epic field <id> <field>` | Get an epic field value |
+| `pf.sh sprint epic promote <id>` | Move epic from future to current sprint |
+| `pf.sh sprint epic show <id>` | Show epic details |
+| `pf.sh sprint epic cancel <id>` | Cancel an epic |
+| `pf.sh sprint epic archive` | Archive completed epics |
 
 ## Usage
 
 ```bash
-pf sprint status
-pf sprint backlog
-pf sprint future epic-55
-pf sprint epic promote epic-41
+pf.sh sprint status
+pf.sh sprint backlog
+pf.sh sprint future epic-55
+pf.sh sprint epic promote epic-41
 ```
 
 ## Ownership

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

@@ -6,7 +6,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 
 | Script | Purpose |
 |--------|---------|
-| `finish-story.sh` | **DEPRECATED** — forwards to `pf sprint story finish` |
+| `finish-story.sh` | **DEPRECATED** — forwards to `pf.sh sprint story finish` |
 | `fix-session-phase.sh` | Repair session file phase state |
 | `check.sh` | Quality gates runner (lint, type check, tests) |
 | `list-workflows.sh` | List available workflows |
@@ -18,7 +18,7 @@ Scripts for workflow mechanics, phase transitions, and quality gates.
 ## Usage
 
 ```bash
-pf sprint story finish MSSCI-12345
+pf.sh sprint story finish MSSCI-12345
 .pennyfarthing/scripts/workflow/start-workflow.sh prd --mode create
 ```
 

package/pennyfarthing-dist/scripts/workflow/finish-story.sh

@@ -1,20 +1,6 @@
 #!/bin/bash
 # DEPRECATED: Use `pf sprint story finish` instead.
-#
-# This shell script had a bug where yq paths targeted .epics[].stories[]
-# but the sprint YAML uses sharded epic files with .stories[] at root.
-# The Python implementation (pennyfarthing_scripts.sprint.story_finish)
-# correctly handles sharded YAML via read_sprint/write_sprint.
-#
-# Usage: finish-story.sh <story-id> [--dry-run]
-
 set -euo pipefail
-
 echo "DEPRECATED: finish-story.sh is deprecated. Forwarding to 'pf sprint story finish'." >&2
-
-ARGS=()
-for arg in "$@"; do
-  ARGS+=("$arg")
-done
-
-exec pf sprint story finish "${ARGS[@]}"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf sprint story finish "$@"

package/pennyfarthing-dist/scripts/workflow/fix-session-phase.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow fix-phase` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: fix-session-phase.sh is deprecated. Use: pf workflow fix-phase $*" >&2
-exec pf workflow fix-phase "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow fix-phase "$@"

package/pennyfarthing-dist/scripts/workflow/get-workflow-type.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow type` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: get-workflow-type.sh is deprecated. Use: pf workflow type $*" >&2
-exec pf workflow type "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow type "$@"

package/pennyfarthing-dist/scripts/workflow/list-workflows.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow list` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: list-workflows.sh is deprecated. Use: pf workflow list" >&2
-exec pf workflow list "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow list "$@"

package/pennyfarthing-dist/scripts/workflow/phase-owner.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow phase-check` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: phase-owner.sh is deprecated. Use: pf workflow phase-check $*" >&2
-exec pf workflow phase-check "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow phase-check "$@"

package/pennyfarthing-dist/scripts/workflow/resume-workflow.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow resume` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: resume-workflow.sh is deprecated. Use: pf workflow resume $*" >&2
-exec pf workflow resume "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow resume "$@"

package/pennyfarthing-dist/scripts/workflow/show-workflow.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow show` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: show-workflow.sh is deprecated. Use: pf workflow show $*" >&2
-exec pf workflow show "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow show "$@"

package/pennyfarthing-dist/scripts/workflow/start-workflow.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow start` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: start-workflow.sh is deprecated. Use: pf workflow start $*" >&2
-exec pf workflow start "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow start "$@"

package/pennyfarthing-dist/scripts/workflow/workflow-status.sh

@@ -1,5 +1,5 @@
-#!/bin/bash
+#!/usr/bin/env bash
 # DEPRECATED: Use `pf workflow status` instead.
-# This shim forwards to the Python CLI for backward compatibility.
 echo "Warning: workflow-status.sh is deprecated. Use: pf workflow status $*" >&2
-exec pf workflow status "$@"
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+exec_pf workflow status "$@"

package/pennyfarthing-dist/skills/pf-bc/examples.md

@@ -4,80 +4,80 @@
 
 ```bash
 # Focus on Sprint panel
-pf bc sprint
+pf.sh bc sprint
 
 # Focus on Diffs panel
-pf bc diffs
+pf.sh bc diffs
 
 # Focus on Acceptance Criteria
-pf bc ac
+pf.sh bc ac
 
 # Focus on Git panel
-pf bc git
+pf.sh bc git
 
 # Preview without changing
-pf bc sprint --dry-run
+pf.sh bc sprint --dry-run
 ```
 
 ## Clearing Focus
 
 ```bash
 # Remove focus setting
-pf bc reset
+pf.sh bc reset
 
 # Preview
-pf bc reset --dry-run
+pf.sh bc reset --dry-run
 ```
 
 ## Named Layouts
 
 ```bash
 # Save current layout as "normal"
-pf bc save normal
+pf.sh bc save normal
 
 # Save current layout as "review"
-pf bc save review
+pf.sh bc save review
 
 # Save current layout as "debug"
-pf bc save debug
+pf.sh bc save debug
 
 # List all saved layouts
-pf bc list
+pf.sh bc list
 
 # Switch to review layout
-pf bc load review
+pf.sh bc load review
 
 # Switch back to normal
-pf bc load normal
+pf.sh bc load normal
 
 # Delete a specific layout
-pf bc clear review
+pf.sh bc clear review
 
 # Delete all layouts
-pf bc clear-all
+pf.sh bc clear-all
 ```
 
 ## Common Workflows
 
 ### During code review
 ```bash
-pf bc save normal          # Save current layout first
-pf bc diffs                # Focus on diffs
+pf.sh bc save normal          # Save current layout first
+pf.sh bc diffs                # Focus on diffs
 # ... do review ...
-pf bc load normal          # Restore normal layout
+pf.sh bc load normal          # Restore normal layout
 ```
 
 ### Debugging session
 ```bash
-pf bc save normal
-pf bc debug                # Focus debug panel
+pf.sh bc save normal
+pf.sh bc debug                # Focus debug panel
 # ... debug ...
-pf bc reset                # Clear focus
+pf.sh bc reset                # Clear focus
 ```
 
 ### Sprint planning
 ```bash
-pf bc sprint               # Focus sprint panel
+pf.sh bc sprint               # Focus sprint panel
 # ... review backlog ...
-pf bc reset
+pf.sh bc reset
 ```

package/pennyfarthing-dist/skills/pf-bc/skill.md

@@ -16,28 +16,28 @@ Set or clear the focused panel in Cyclist/BikeRack. Save and restore named layou
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/bc sprint` | `pf bc sprint [--dry-run]` | Focus Sprint panel |
-| `/bc git` | `pf bc git [--dry-run]` | Focus Git panel |
-| `/bc diffs` | `pf bc diffs [--dry-run]` | Focus Diffs panel |
-| `/bc todo` | `pf bc todo [--dry-run]` | Focus Todo panel |
-| `/bc workflow` | `pf bc workflow [--dry-run]` | Focus Workflow panel |
-| `/bc background` | `pf bc background [--dry-run]` | Focus Background panel |
-| `/bc audit-log` | `pf bc audit-log [--dry-run]` | Focus Audit Log panel |
-| `/bc changed` | `pf bc changed [--dry-run]` | Focus Changed panel |
-| `/bc ac` | `pf bc ac [--dry-run]` | Focus Acceptance Criteria panel |
-| `/bc debug` | `pf bc debug [--dry-run]` | Focus Debug panel |
-| `/bc settings` | `pf bc settings [--dry-run]` | Focus Settings panel |
-| `/bc reset` | `pf bc reset [--dry-run]` | Clear focus setting |
+| `/bc sprint` | `pf.sh bc sprint [--dry-run]` | Focus Sprint panel |
+| `/bc git` | `pf.sh bc git [--dry-run]` | Focus Git panel |
+| `/bc diffs` | `pf.sh bc diffs [--dry-run]` | Focus Diffs panel |
+| `/bc todo` | `pf.sh bc todo [--dry-run]` | Focus Todo panel |
+| `/bc workflow` | `pf.sh bc workflow [--dry-run]` | Focus Workflow panel |
+| `/bc background` | `pf.sh bc background [--dry-run]` | Focus Background panel |
+| `/bc audit-log` | `pf.sh bc audit-log [--dry-run]` | Focus Audit Log panel |
+| `/bc changed` | `pf.sh bc changed [--dry-run]` | Focus Changed panel |
+| `/bc ac` | `pf.sh bc ac [--dry-run]` | Focus Acceptance Criteria panel |
+| `/bc debug` | `pf.sh bc debug [--dry-run]` | Focus Debug panel |
+| `/bc settings` | `pf.sh bc settings [--dry-run]` | Focus Settings panel |
+| `/bc reset` | `pf.sh bc reset [--dry-run]` | Clear focus setting |
 
 ### Named Layouts
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/bc save <name>` | `pf bc save <name> [--dry-run]` | Save current layout from running server |
-| `/bc load <name>` | `pf bc load <name> [--dry-run]` | Load a saved layout |
-| `/bc list` | `pf bc list` | List all saved layouts |
-| `/bc clear <name>` | `pf bc clear <name> [--dry-run]` | Delete a saved layout |
-| `/bc clear-all` | `pf bc clear-all [--dry-run]` | Delete all saved layouts |
+| `/bc save <name>` | `pf.sh bc save <name> [--dry-run]` | Save current layout from running server |
+| `/bc load <name>` | `pf.sh bc load <name> [--dry-run]` | Load a saved layout |
+| `/bc list` | `pf.sh bc list` | List all saved layouts |
+| `/bc clear <name>` | `pf.sh bc clear <name> [--dry-run]` | Delete a saved layout |
+| `/bc clear-all` | `pf.sh bc clear-all [--dry-run]` | Delete all saved layouts |
 
 ### Notes
 

package/pennyfarthing-dist/skills/pf-bc/usage.md

@@ -5,7 +5,7 @@
 ### Set Focus
 
 ```bash
-pf bc <panel> [--dry-run]
+pf.sh bc <panel> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -37,7 +37,7 @@ Output on error: `{"success": false, "error": "Invalid panel..."}`
 ### Clear Focus
 
 ```bash
-pf bc reset [--dry-run]
+pf.sh bc reset [--dry-run]
 ```
 
 Removes the `focus` key from `.pennyfarthing/config.local.yaml`.
@@ -49,7 +49,7 @@ Removes the `focus` key from `.pennyfarthing/config.local.yaml`.
 ### Save Layout
 
 ```bash
-pf bc save <NAME> [--dry-run]
+pf.sh bc save <NAME> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -57,14 +57,14 @@ pf bc save <NAME> [--dry-run]
 | `NAME` | Yes | Layout name to save as |
 | `--dry-run` | No | Preview without making changes |
 
-Fetches the active layout from the running Cyclist/BikeRack server (reads `.wheelhub-port`). Fails if no server is running.
+Fetches the active layout from the running Cyclist/BikeRack server (reads `.bikerack-port`). Fails if no server is running.
 
 Output: `{"success": true, "name": "<name>", "panels": <count>}`
 
 ### Load Layout
 
 ```bash
-pf bc load <NAME> [--dry-run]
+pf.sh bc load <NAME> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -77,7 +77,7 @@ Output: `{"success": true, "name": "<name>", "layout": {...}}`
 ### List Layouts
 
 ```bash
-pf bc list
+pf.sh bc list
 ```
 
 No arguments. Output: `{"success": true, "layouts": ["normal", "review", ...]}`
@@ -85,7 +85,7 @@ No arguments. Output: `{"success": true, "layouts": ["normal", "review", ...]}`
 ### Delete Layout
 
 ```bash
-pf bc clear <NAME> [--dry-run]
+pf.sh bc clear <NAME> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -96,7 +96,7 @@ pf bc clear <NAME> [--dry-run]
 ### Delete All Layouts
 
 ```bash
-pf bc clear-all [--dry-run]
+pf.sh bc clear-all [--dry-run]
 ```
 
 | Option | Description |

package/pennyfarthing-dist/skills/pf-jira/SKILL.md

@@ -11,7 +11,7 @@ Never fabricate or guess Jira IDs. Valid keys follow `MSSCI-XXXXX`. Old-style ID
 </critical>
 
 <run>
-pf jira <command> [args]
+pf.sh jira <command> [args]
 </run>
 
 <output>
@@ -22,20 +22,20 @@ Command-specific output. Most commands print status messages. Use `--dry-run` on
 
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-jira view <key>` | `pf jira view <key>` | View issue details |
-| `/pf-jira check <key>` | `pf jira check <key>` | Check availability |
-| `/pf-jira claim <key>` | `pf jira claim <key> [--dry-run]` | Assign to self + In Progress |
-| `/pf-jira move <key> <status>` | `pf jira move <key> "<status>" [--dry-run]` | Transition status |
-| `/pf-jira assign <key> <user>` | `pf jira assign <key> <user> [--dry-run]` | Assign to user |
-| `/pf-jira link <p> <c> [type]` | `pf jira link <parent> <child> [type] [--dry-run]` | Link two issues |
-| `/pf-jira search "<jql>"` | `pf jira search "<jql>"` | Search by JQL |
-| `/pf-jira create epic <id>` | `pf jira create epic <id> [--dry-run]` | Create epic + stories |
-| `/pf-jira create story <ek> <sid>` | `pf jira create story <epic-key> <story-id> [--dry-run]` | Create single story |
-| `/pf-jira create standalone` | `pf jira create standalone "<title>" [opts]` | Create standalone story |
-| `/pf-jira sync <epic>` | `pf jira sync <epic> [--transition] [--points] [--all] [--dry-run]` | Sync epic to Jira |
-| `/pf-jira bidirectional` | `pf jira bidirectional [opts]` | Bidirectional sync |
-| `/pf-jira reconcile` | `pf jira reconcile [--fix]` | Reconciliation report |
-| `/pf-jira sprint add <sid> <key>` | `pf jira sprint add <sprint-id> <issue-key> [--dry-run]` | Add issue to sprint |
+| `/pf-jira view <key>` | `pf.sh jira view <key>` | View issue details |
+| `/pf-jira check <key>` | `pf.sh jira check <key>` | Check availability |
+| `/pf-jira claim <key>` | `pf.sh jira claim <key> [--dry-run]` | Assign to self + In Progress |
+| `/pf-jira move <key> <status>` | `pf.sh jira move <key> "<status>" [--dry-run]` | Transition status |
+| `/pf-jira assign <key> <user>` | `pf.sh jira assign <key> <user> [--dry-run]` | Assign to user |
+| `/pf-jira link <p> <c> [type]` | `pf.sh jira link <parent> <child> [type] [--dry-run]` | Link two issues |
+| `/pf-jira search "<jql>"` | `pf.sh jira search "<jql>"` | Search by JQL |
+| `/pf-jira create epic <id>` | `pf.sh jira create epic <id> [--dry-run]` | Create epic + stories |
+| `/pf-jira create story <ek> <sid>` | `pf.sh jira create story <epic-key> <story-id> [--dry-run]` | Create single story |
+| `/pf-jira create standalone` | `pf.sh jira create standalone "<title>" [opts]` | Create standalone story |
+| `/pf-jira sync <epic>` | `pf.sh jira sync <epic> [--transition] [--points] [--all] [--dry-run]` | Sync epic to Jira |
+| `/pf-jira bidirectional` | `pf.sh jira bidirectional [opts]` | Bidirectional sync |
+| `/pf-jira reconcile` | `pf.sh jira reconcile [--fix]` | Reconciliation report |
+| `/pf-jira sprint add <sid> <key>` | `pf.sh jira sprint add <sprint-id> <issue-key> [--dry-run]` | Add issue to sprint |
 
 ### GitHub to Jira User Mapping