@pennyfarthing/core 11.2.1 → 11.2.2

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 |

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

@@ -4,178 +4,178 @@
 
 ```bash
 # Full sprint status
-pf sprint status
+pf.sh sprint status
 
 # Only backlog stories
-pf sprint status backlog
+pf.sh sprint status backlog
 
 # Only in-progress work
-pf sprint status in-progress
+pf.sh sprint status in-progress
 
 # Only completed stories
-pf sprint status done
+pf.sh sprint status done
 
 # Available stories grouped by epic
-pf sprint backlog
+pf.sh sprint backlog
 
 # Sprint metrics and velocity
-pf sprint metrics
-pf sprint metrics --json
+pf.sh sprint metrics
+pf.sh sprint metrics --json
 
 # Sprint header as JSON (for scripts)
-pf sprint info
+pf.sh sprint info
 
 # Future initiatives overview
-pf sprint future
+pf.sh sprint future
 
 # Future epic detail with stories
-pf sprint future epic-55
+pf.sh sprint future epic-55
 ```
 
 ## Starting Work
 
 ```bash
 # Show available stories (interactive)
-pf sprint work
+pf.sh sprint work
 
 # Start specific story
-pf sprint work 91-3
+pf.sh sprint work 91-3
 
 # Auto-select highest priority
-pf sprint work next
+pf.sh sprint work next
 
 # Preview without starting
-pf sprint work 91-3 --dry-run
+pf.sh sprint work 91-3 --dry-run
 
 # Check story availability (JSON output)
-pf sprint check 91-3
-pf sprint check MSSCI-15033
-pf sprint check next
+pf.sh sprint check 91-3
+pf.sh sprint check MSSCI-15033
+pf.sh sprint check next
 ```
 
 ## Story Operations
 
 ```bash
 # Show story details
-pf sprint story show 91-3
-pf sprint story show MSSCI-15033 --json
+pf.sh sprint story show 91-3
+pf.sh sprint story show MSSCI-15033 --json
 
 # Add story to epic
-pf sprint story add 91 "Add error handling" 3
-pf sprint story add 91 "Fix null pointer" 2 --type bug
-pf sprint story add 91 "Refactor parser" 3 --workflow trivial --priority p0
+pf.sh sprint story add 91 "Add error handling" 3
+pf.sh sprint story add 91 "Fix null pointer" 2 --type bug
+pf.sh sprint story add 91 "Refactor parser" 3 --workflow trivial --priority p0
 
 # Add standalone story to initiative
-pf sprint story add --initiative technical-debt "Fix flaky test" 2 --type bug
+pf.sh sprint story add --initiative technical-debt "Fix flaky test" 2 --type bug
 
 # Update story fields
-pf sprint story update 91-3 --status in_progress
-pf sprint story update 91-3 --status done
-pf sprint story update 91-3 --points 5 --priority P0
-pf sprint story update 91-3 --assigned-to keith.avery@1898andco.io
-pf sprint story update 91-3 --workflow tdd-tandem
-pf sprint story update 91-3 --status done --dry-run
+pf.sh sprint story update 91-3 --status in_progress
+pf.sh sprint story update 91-3 --status done
+pf.sh sprint story update 91-3 --points 5 --priority P0
+pf.sh sprint story update 91-3 --assigned-to keith.avery@1898andco.io
+pf.sh sprint story update 91-3 --workflow tdd-tandem
+pf.sh sprint story update 91-3 --status done --dry-run
 
 # Get single field
-pf sprint story field 91-3 workflow    # tdd
-pf sprint story field 91-3 jira        # MSSCI-15033
-pf sprint story field 91-3 status      # in_progress
+pf.sh sprint story field 91-3 workflow    # tdd
+pf.sh sprint story field 91-3 jira        # MSSCI-15033
+pf.sh sprint story field 91-3 status      # in_progress
 
 # Sizing guidelines
-pf sprint story size
-pf sprint story size 5
+pf.sh sprint story size
+pf.sh sprint story size 5
 
 # Story templates
-pf sprint story template
-pf sprint story template feature
-pf sprint story template bug
+pf.sh sprint story template
+pf.sh sprint story template feature
+pf.sh sprint story template bug
 
 # Complete story (archive, merge, Jira transition)
-pf sprint story finish 91-3
-pf sprint story finish 91-3 --dry-run
+pf.sh sprint story finish 91-3
+pf.sh sprint story finish 91-3 --dry-run
 
 # Claim/unclaim in Jira
-pf sprint story claim MSSCI-15033
-pf sprint story claim MSSCI-15033 --unclaim
+pf.sh sprint story claim MSSCI-15033
+pf.sh sprint story claim MSSCI-15033 --unclaim
 ```
 
 ## Epic Operations
 
 ```bash
 # Show epic details
-pf sprint epic show 91
-pf sprint epic show MSSCI-14298
-pf sprint epic show 91 --json
+pf.sh sprint epic show 91
+pf.sh sprint epic show MSSCI-14298
+pf.sh sprint epic show 91 --json
 
 # Add new epic
-pf sprint epic add epic-95 "New Feature Epic"
-pf sprint epic add epic-95 "New Feature" --priority p0 --jira MSSCI-15100
-pf sprint epic add epic-95 "New Feature" -d "Description of the epic"
+pf.sh sprint epic add epic-95 "New Feature Epic"
+pf.sh sprint epic add epic-95 "New Feature" --priority p0 --jira MSSCI-15100
+pf.sh sprint epic add epic-95 "New Feature" -d "Description of the epic"
 
 # Update epic
-pf sprint epic update 91 --status in_progress
-pf sprint epic update MSSCI-14298 --priority P0
-pf sprint epic update 91 --status done --dry-run
+pf.sh sprint epic update 91 --status in_progress
+pf.sh sprint epic update MSSCI-14298 --priority P0
+pf.sh sprint epic update 91 --status done --dry-run
 
 # Promote from future to current sprint
-pf sprint epic promote epic-55
-pf sprint epic promote 55
-pf sprint epic promote epic-55 --dry-run
+pf.sh sprint epic promote epic-55
+pf.sh sprint epic promote 55
+pf.sh sprint epic promote epic-55 --dry-run
 
 # Archive completed epics
-pf sprint epic archive                     # Scan all completed
-pf sprint epic archive --dry-run           # Preview
-pf sprint epic archive 91                  # Specific epic
-pf sprint epic archive 91 --jira           # Also update Jira
+pf.sh sprint epic archive                     # Scan all completed
+pf.sh sprint epic archive --dry-run           # Preview
+pf.sh sprint epic archive 91                  # Specific epic
+pf.sh sprint epic archive 91 --jira           # Also update Jira
 
 # Cancel epic and all stories
-pf sprint epic cancel 91
-pf sprint epic cancel 91 --jira            # Also cancel in Jira
-pf sprint epic cancel 91 --dry-run
+pf.sh sprint epic cancel 91
+pf.sh sprint epic cancel 91 --jira            # Also cancel in Jira
+pf.sh sprint epic cancel 91 --dry-run
 
 # Import BMAD epics
-pf sprint epic import docs/planning/feature-epics.md
-pf sprint epic import docs/planning/feature-epics.md "My Feature" --marker my-feature
-pf sprint epic import docs/planning/feature-epics.md --dry-run
+pf.sh sprint epic import docs/planning/feature-epics.md
+pf.sh sprint epic import docs/planning/feature-epics.md "My Feature" --marker my-feature
+pf.sh sprint epic import docs/planning/feature-epics.md --dry-run
 
 # Remove from future.yaml
-pf sprint epic remove epic-41
-pf sprint epic remove epic-41 --dry-run
+pf.sh sprint epic remove epic-41
+pf.sh sprint epic remove epic-41 --dry-run
 
 # Get epic field
-pf sprint epic field 91 jira               # MSSCI-14298
-pf sprint epic field 91 title              # Epic title
+pf.sh sprint epic field 91 jira               # MSSCI-14298
+pf.sh sprint epic field 91 title              # Epic title
 ```
 
 ## Initiative Operations
 
 ```bash
 # Show initiative details
-pf sprint initiative show benchmark-reliability
-pf sprint initiative show technical-debt --json
+pf.sh sprint initiative show benchmark-reliability
+pf.sh sprint initiative show technical-debt --json
 
 # Cancel initiative
-pf sprint initiative cancel technical-debt
-pf sprint initiative cancel technical-debt --jira
-pf sprint initiative cancel technical-debt --dry-run
+pf.sh sprint initiative cancel technical-debt
+pf.sh sprint initiative cancel technical-debt --jira
+pf.sh sprint initiative cancel technical-debt --dry-run
 ```
 
 ## Sprint Lifecycle
 
 ```bash
 # Initialize new sprint
-pf sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish"
-pf sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish" --dry-run
+pf.sh sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish"
+pf.sh sprint new 2607 278 2026-02-16 2026-03-01 "Performance and polish" --dry-run
 
 # Archive completed story
-pf sprint archive 91-3 856
-pf sprint archive 91-3 856 --apply          # Archive + remove atomically
+pf.sh sprint archive 91-3 856
+pf.sh sprint archive 91-3 856 --apply          # Archive + remove atomically
 
 # Validate sprint YAML
-pf sprint validate                           # All validators
-pf sprint validate sprint                    # Sprint YAML only
-pf sprint validate --fix                     # Auto-fix issues
-pf sprint validate --strict                  # Warnings as errors
+pf.sh sprint validate                           # All validators
+pf.sh sprint validate sprint                    # Sprint YAML only
+pf.sh sprint validate --fix                     # Auto-fix issues
+pf.sh sprint validate --strict                  # Warnings as errors
 ```
 
 ## Sizing Quick Reference