@pennyfarthing/core 11.2.0 → 11.2.2

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
 

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

@@ -4,126 +4,126 @@
 
 ```bash
 # View issue details
-pf jira view MSSCI-12345
+pf.sh jira view MSSCI-12345
 
 # Check if story is available to claim
-pf jira check MSSCI-12345
+pf.sh jira check MSSCI-12345
 
 # Search by JQL
-pf jira search "project=MSSCI AND type=Epic"
-pf jira search "project=MSSCI AND parent=MSSCI-10980"
-pf jira search "project=MSSCI AND summary~'feedback rules'"
+pf.sh jira search "project=MSSCI AND type=Epic"
+pf.sh jira search "project=MSSCI AND parent=MSSCI-10980"
+pf.sh jira search "project=MSSCI AND summary~'feedback rules'"
 ```
 
 ## Claiming & Assigning
 
 ```bash
 # Claim story (assign to self + In Progress)
-pf jira claim MSSCI-12345
+pf.sh jira claim MSSCI-12345
 
 # Assign to user by email
-pf jira assign MSSCI-12345 keith.avery@1898andco.io
+pf.sh jira assign MSSCI-12345 keith.avery@1898andco.io
 
 # Assign by GitHub username (auto-mapped)
-pf jira assign MSSCI-12345 slabgorb
+pf.sh jira assign MSSCI-12345 slabgorb
 
 # Preview
-pf jira claim MSSCI-12345 --dry-run
-pf jira assign MSSCI-12345 slabgorb --dry-run
+pf.sh jira claim MSSCI-12345 --dry-run
+pf.sh jira assign MSSCI-12345 slabgorb --dry-run
 ```
 
 ## Transitions
 
 ```bash
 # Move to In Progress
-pf jira move MSSCI-12345 "In Progress"
+pf.sh jira move MSSCI-12345 "In Progress"
 
 # Move to Done
-pf jira move MSSCI-12345 "Done"
+pf.sh jira move MSSCI-12345 "Done"
 
 # Move to In Review
-pf jira move MSSCI-12345 "In Review"
+pf.sh jira move MSSCI-12345 "In Review"
 
 # Move back to To Do
-pf jira move MSSCI-12345 "To Do"
+pf.sh jira move MSSCI-12345 "To Do"
 
 # Preview
-pf jira move MSSCI-12345 "Done" --dry-run
+pf.sh jira move MSSCI-12345 "Done" --dry-run
 ```
 
 ## Creating Issues
 
 ```bash
 # Create epic + all child stories from sprint YAML
-pf jira create epic epic-63
-pf jira create epic 63
-pf jira create epic 63 --dry-run
+pf.sh jira create epic epic-63
+pf.sh jira create epic 63
+pf.sh jira create epic 63 --dry-run
 
 # Create single story under an epic
-pf jira create story MSSCI-12077 63-7
-pf jira create story MSSCI-12077 63-7 --dry-run
+pf.sh jira create story MSSCI-12077 63-7
+pf.sh jira create story MSSCI-12077 63-7 --dry-run
 
 # Create standalone story (create + sprint + Done)
-pf jira create standalone "Fix sprint script shard support"
-pf jira create standalone "Fix sprint script shard support" --points 3
-pf jira create standalone "Add drift detection" -d "Detects YAML drift"
-pf jira create standalone "Quick fix" --dry-run
+pf.sh jira create standalone "Fix sprint script shard support"
+pf.sh jira create standalone "Fix sprint script shard support" --points 3
+pf.sh jira create standalone "Add drift detection" -d "Detects YAML drift"
+pf.sh jira create standalone "Quick fix" --dry-run
 ```
 
 ## Linking Issues
 
 ```bash
 # Block relationship
-pf jira link MSSCI-12345 MSSCI-12346 "Blocks"
+pf.sh jira link MSSCI-12345 MSSCI-12346 "Blocks"
 
 # Parent-child
-pf jira link MSSCI-12345 MSSCI-12346 "Parent-Child"
+pf.sh jira link MSSCI-12345 MSSCI-12346 "Parent-Child"
 
 # Related (default)
-pf jira link MSSCI-12345 MSSCI-12346
-pf jira link MSSCI-12345 MSSCI-12346 "Relates"
+pf.sh jira link MSSCI-12345 MSSCI-12346
+pf.sh jira link MSSCI-12345 MSSCI-12346 "Relates"
 
 # Duplicate
-pf jira link MSSCI-12345 MSSCI-12346 "Duplicate"
+pf.sh jira link MSSCI-12345 MSSCI-12346 "Duplicate"
 ```
 
 ## Syncing
 
 ```bash
 # Sync epic to Jira (all fields)
-pf jira sync MSSCI-11952 --all
+pf.sh jira sync MSSCI-11952 --all
 
 # Sync only status transitions
-pf jira sync 63 --transition
+pf.sh jira sync 63 --transition
 
 # Sync only story points
-pf jira sync 63 --points
+pf.sh jira sync 63 --points
 
 # Preview
-pf jira sync 63 --all --dry-run
+pf.sh jira sync 63 --all --dry-run
 
 # Bidirectional sync (Jira wins by default)
-pf jira bidirectional --all
-pf jira bidirectional --all --dry-run
+pf.sh jira bidirectional --all
+pf.sh jira bidirectional --all --dry-run
 
 # YAML wins on conflicts
-pf jira bidirectional --status --yaml-wins
+pf.sh jira bidirectional --status --yaml-wins
 
 # Sync specific fields
-pf jira bidirectional --status --points --assignee
+pf.sh jira bidirectional --status --points --assignee
 
 # Target specific sprint
-pf jira bidirectional --all --sprint 276
+pf.sh jira bidirectional --all --sprint 276
 ```
 
 ## Reconciliation
 
 ```bash
 # Report mismatches
-pf jira reconcile
+pf.sh jira reconcile
 
 # Auto-fix (add missing stories to sprint)
-pf jira reconcile --fix
+pf.sh jira reconcile --fix
 ```
 
 ## Sprint Management
@@ -133,10 +133,10 @@ pf jira reconcile --fix
 SPRINT_ID=$(grep 'jira_sprint_id:' sprint/current-sprint.yaml | awk '{print $2}')
 
 # Add issue to sprint
-pf jira sprint add "$SPRINT_ID" MSSCI-11999
+pf.sh jira sprint add "$SPRINT_ID" MSSCI-11999
 
 # Preview
-pf jira sprint add "$SPRINT_ID" MSSCI-11999 --dry-run
+pf.sh jira sprint add "$SPRINT_ID" MSSCI-11999 --dry-run
 ```
 
 ## Common Workflows
@@ -144,23 +144,23 @@ pf jira sprint add "$SPRINT_ID" MSSCI-11999 --dry-run
 ### New story from sprint YAML to Jira
 ```bash
 # 1. Add story to sprint YAML
-pf sprint story add 91 "New feature" 3
+pf.sh sprint story add 91 "New feature" 3
 
 # 2. Create in Jira under existing epic
-pf jira create story MSSCI-14298 91-5
+pf.sh jira create story MSSCI-14298 91-5
 
 # 3. Claim it
-pf jira claim MSSCI-15050
+pf.sh jira claim MSSCI-15050
 ```
 
 ### End-of-sprint reconciliation
 ```bash
 # 1. Check for mismatches
-pf jira reconcile
+pf.sh jira reconcile
 
 # 2. Sync all completed stories
-pf jira bidirectional --all
+pf.sh jira bidirectional --all
 
 # 3. Fix any remaining issues
-pf jira reconcile --fix
+pf.sh jira reconcile --fix
 ```

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

@@ -1,13 +1,13 @@
 # Jira CLI — Detailed Usage
 
-All commands use `pf jira <command>` as the entry point. REST API is used where possible — no interactive prompt issues.
+All commands use `pf.sh jira <command>` as the entry point. REST API is used where possible — no interactive prompt issues.
 
 ## Commands
 
 ### View Issue
 
 ```bash
-pf jira view <KEY>
+pf.sh jira view <KEY>
 ```
 
 | Arg | Required | Description |
@@ -19,7 +19,7 @@ Delegates to `jira issue view`. Shows summary, status, assignee, description, li
 ### Check Availability
 
 ```bash
-pf jira check <KEY>
+pf.sh jira check <KEY>
 ```
 
 | Arg | Required | Description |
@@ -31,7 +31,7 @@ Exit codes: `0` = available, `1` = assigned, `2` = not found, `3` = error.
 ### Claim Story
 
 ```bash
-pf jira claim <KEY> [--dry-run]
+pf.sh jira claim <KEY> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -44,7 +44,7 @@ Assigns to self and moves to In Progress.
 ### Move Issue
 
 ```bash
-pf jira move <KEY> "<STATUS>" [--dry-run]
+pf.sh jira move <KEY> "<STATUS>" [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -58,7 +58,7 @@ Checks current status first — skips if already there.
 ### Assign Issue
 
 ```bash
-pf jira assign <KEY> <USER> [--dry-run]
+pf.sh jira assign <KEY> <USER> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -72,7 +72,7 @@ Checks current assignee — skips if already assigned.
 ### Link Issues
 
 ```bash
-pf jira link <PARENT_KEY> <CHILD_KEY> [LINK_TYPE] [--dry-run]
+pf.sh jira link <PARENT_KEY> <CHILD_KEY> [LINK_TYPE] [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -85,7 +85,7 @@ pf jira link <PARENT_KEY> <CHILD_KEY> [LINK_TYPE] [--dry-run]
 ### Search Issues
 
 ```bash
-pf jira search "<JQL>"
+pf.sh jira search "<JQL>"
 ```
 
 | Arg | Required | Description |
@@ -97,7 +97,7 @@ Delegates to `jira issue list --jql`.
 ### Create Epic
 
 ```bash
-pf jira create epic <EPIC_ID> [--dry-run]
+pf.sh jira create epic <EPIC_ID> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -110,7 +110,7 @@ Creates Jira epic and all child stories without existing Jira keys. Updates spri
 ### Create Story
 
 ```bash
-pf jira create story <EPIC_JIRA_KEY> <STORY_ID> [--dry-run]
+pf.sh jira create story <EPIC_JIRA_KEY> <STORY_ID> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -124,7 +124,7 @@ Sets priority, points, sprint membership. Updates YAML.
 ### Create Standalone
 
 ```bash
-pf jira create standalone "<TITLE>" [--points N] [-d DESC] [--dry-run]
+pf.sh jira create standalone "<TITLE>" [--points N] [-d DESC] [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -139,7 +139,7 @@ Creates story, adds to current sprint, transitions to Done. All via REST API.
 ### Sync Epic
 
 ```bash
-pf jira sync <EPIC> [--transition] [--points] [--all] [--dry-run]
+pf.sh jira sync <EPIC> [--transition] [--points] [--all] [--dry-run]
 ```
 
 | Arg/Option | Required | Description |
@@ -153,7 +153,7 @@ pf jira sync <EPIC> [--transition] [--points] [--all] [--dry-run]
 ### Bidirectional Sync
 
 ```bash
-pf jira bidirectional [options]
+pf.sh jira bidirectional [options]
 ```
 
 | Option | Description |
@@ -169,7 +169,7 @@ pf jira bidirectional [options]
 ### Reconcile
 
 ```bash
-pf jira reconcile [--fix]
+pf.sh jira reconcile [--fix]
 ```
 
 | Option | Description |
@@ -181,7 +181,7 @@ Reports: status mismatches, missing Jira keys, orphans, sprint membership gaps.
 ### Sprint Add
 
 ```bash
-pf jira sprint add <SPRINT_ID> <ISSUE_KEY> [--dry-run]
+pf.sh jira sprint add <SPRINT_ID> <ISSUE_KEY> [--dry-run]
 ```
 
 | Arg/Option | Required | Description |