npm - @pennyfarthing/core - Versions diffs - 11.2.1 → 11.2.2 - Mend

@pennyfarthing/core 11.2.1 → 11.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (467) hide show

package/pennyfarthing-dist/skills/pf-sprint/skill.md CHANGED Viewed

@@ -4,73 +4,73 @@ description: |
   Sprint status, backlog, and story management for Pennyfarthing. Use when checking current
   sprint status, finding available stories, reviewing backlog, or understanding story context
   and history.
-  IMPORTANT: Always use `pf sprint` CLI commands - never manually edit sprint YAML.
+  IMPORTANT: Always use `pf.sh sprint` CLI commands - never manually edit sprint YAML.
 args: "[status|backlog|work|story|epic|initiative|archive|new|future|info|metrics|validate|standalone]"
 ---
 # /pf-sprint - Sprint Management
 <critical>
-Never manually edit `sprint/current-sprint.yaml`. Use `pf sprint` CLI commands for deterministic, correct YAML formatting.
+Never manually edit `sprint/current-sprint.yaml`. Use `pf.sh sprint` CLI commands for deterministic, correct YAML formatting.
 </critical>
 ## Quick Reference
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-sprint` | `pf sprint status` | Show sprint status |
-| `/pf-sprint status [filter]` | `pf sprint status [filter]` | Filter: `backlog`, `todo`, `in-progress`, `review`, `done` |
-| `/pf-sprint backlog` | `pf sprint backlog` | Available stories by epic |
-| `/pf-sprint work [id]` | `pf sprint work [story-id] [--dry-run]` | Start work on a story |
-| `/pf-sprint archive <id> [pr]` | `pf sprint archive <id> [pr] [--apply] [--dry-run]` | Archive completed story |
-| `/pf-sprint new ...` | `pf sprint new <yyww> <jira-id> <start> <end> "<goal>" [--dry-run]` | Initialize new sprint |
-| `/pf-sprint future [epic-id]` | `pf sprint future [epic-id]` | Show future initiatives |
-| `/pf-sprint info` | `pf sprint info` | Sprint header as JSON |
-| `/pf-sprint metrics` | `pf sprint metrics [--json]` | Sprint progress and velocity |
-| `/pf-sprint validate` | `pf sprint validate [--fix] [--strict]` | Validate sprint YAML |
+| `/pf-sprint` | `pf.sh sprint status` | Show sprint status |
+| `/pf-sprint status [filter]` | `pf.sh sprint status [filter]` | Filter: `backlog`, `todo`, `in-progress`, `review`, `done` |
+| `/pf-sprint backlog` | `pf.sh sprint backlog` | Available stories by epic |
+| `/pf-sprint work [id]` | `pf.sh sprint work [story-id] [--dry-run]` | Start work on a story |
+| `/pf-sprint archive <id> [pr]` | `pf.sh sprint archive <id> [pr] [--apply] [--dry-run]` | Archive completed story |
+| `/pf-sprint new ...` | `pf.sh sprint new <yyww> <jira-id> <start> <end> "<goal>" [--dry-run]` | Initialize new sprint |
+| `/pf-sprint future [epic-id]` | `pf.sh sprint future [epic-id]` | Show future initiatives |
+| `/pf-sprint info` | `pf.sh sprint info` | Sprint header as JSON |
+| `/pf-sprint metrics` | `pf.sh sprint metrics [--json]` | Sprint progress and velocity |
+| `/pf-sprint validate` | `pf.sh sprint validate [--fix] [--strict]` | Validate sprint YAML |
 ### Story Commands
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-sprint story show <id>` | `pf sprint story show <id> [--json]` | Show story details |
-| `/pf-sprint story add ...` | `pf sprint story add <epic-id> "<title>" <pts> [opts]` | Add story to epic |
-| `/pf-sprint story update <id>` | `pf sprint story update <id> [opts]` | Update story fields |
-| `/pf-sprint story field <id> <f>` | `pf sprint story field <id> <field>` | Get single field value |
-| `/pf-sprint story size [pts]` | `pf sprint story size [points]` | Sizing guidelines |
-| `/pf-sprint story template [t]` | `pf sprint story template [type]` | Story templates |
-| `/pf-sprint story finish <id>` | `pf sprint story finish <id> [--dry-run]` | Complete story workflow |
-| `/pf-sprint story claim <id>` | `pf sprint story claim <id> [--claim/--unclaim] [--dry-run]` | Claim/unclaim in Jira |
+| `/pf-sprint story show <id>` | `pf.sh sprint story show <id> [--json]` | Show story details |
+| `/pf-sprint story add ...` | `pf.sh sprint story add <epic-id> "<title>" <pts> [opts]` | Add story to epic |
+| `/pf-sprint story update <id>` | `pf.sh sprint story update <id> [opts]` | Update story fields |
+| `/pf-sprint story field <id> <f>` | `pf.sh sprint story field <id> <field>` | Get single field value |
+| `/pf-sprint story size [pts]` | `pf.sh sprint story size [points]` | Sizing guidelines |
+| `/pf-sprint story template [t]` | `pf.sh sprint story template [type]` | Story templates |
+| `/pf-sprint story finish <id>` | `pf.sh sprint story finish <id> [--dry-run]` | Complete story workflow |
+| `/pf-sprint story claim <id>` | `pf.sh sprint story claim <id> [--claim/--unclaim] [--dry-run]` | Claim/unclaim in Jira |
 ### Epic Commands
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-sprint epic show <id>` | `pf sprint epic show <id> [--json]` | Show epic details |
-| `/pf-sprint epic add <id> <title>` | `pf sprint epic add <id> <title> [opts]` | Add epic to sprint |
-| `/pf-sprint epic update <id>` | `pf sprint epic update <id> [--status] [--priority] [--dry-run]` | Update epic fields |
-| `/pf-sprint epic promote <id>` | `pf sprint epic promote <id> [--dry-run]` | Move from future to current |
-| `/pf-sprint epic archive [id]` | `pf sprint epic archive [id] [--dry-run] [--jira]` | Archive completed epics |
-| `/pf-sprint epic cancel <id>` | `pf sprint epic cancel <id> [--jira] [--dry-run]` | Cancel epic and stories |
-| `/pf-sprint epic import <file>` | `pf sprint epic import <file> [init] [--marker] [--dry-run]` | Import BMAD epics |
-| `/pf-sprint epic remove <id>` | `pf sprint epic remove <id> [--dry-run]` | Remove from future.yaml |
-| `/pf-sprint epic field <id> <f>` | `pf sprint epic field <id> <field>` | Get single field value |
+| `/pf-sprint epic show <id>` | `pf.sh sprint epic show <id> [--json]` | Show epic details |
+| `/pf-sprint epic add <id> <title>` | `pf.sh sprint epic add <id> <title> [opts]` | Add epic to sprint |
+| `/pf-sprint epic update <id>` | `pf.sh sprint epic update <id> [--status] [--priority] [--dry-run]` | Update epic fields |
+| `/pf-sprint epic promote <id>` | `pf.sh sprint epic promote <id> [--dry-run]` | Move from future to current |
+| `/pf-sprint epic archive [id]` | `pf.sh sprint epic archive [id] [--dry-run] [--jira]` | Archive completed epics |
+| `/pf-sprint epic cancel <id>` | `pf.sh sprint epic cancel <id> [--jira] [--dry-run]` | Cancel epic and stories |
+| `/pf-sprint epic import <file>` | `pf.sh sprint epic import <file> [init] [--marker] [--dry-run]` | Import BMAD epics |
+| `/pf-sprint epic remove <id>` | `pf.sh sprint epic remove <id> [--dry-run]` | Remove from future.yaml |
+| `/pf-sprint epic field <id> <f>` | `pf.sh sprint epic field <id> <field>` | Get single field value |
 ### Initiative Commands
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-sprint initiative show <n>` | `pf sprint initiative show <name> [--json]` | Show initiative details |
-| `/pf-sprint initiative cancel <n>` | `pf sprint initiative cancel <name> [--jira] [--dry-run]` | Cancel initiative |
+| `/pf-sprint initiative show <n>` | `pf.sh sprint initiative show <name> [--json]` | Show initiative details |
+| `/pf-sprint initiative cancel <n>` | `pf.sh sprint initiative cancel <name> [--jira] [--dry-run]` | Cancel initiative |
 ### Aliases
 | Alias | Equivalent |
 |-------|------------|
-| `pf status` | `pf sprint status` |
-| `pf backlog` | `pf sprint backlog` |
-| `pf work` | `pf sprint work` |
-| `pf story` | `pf sprint story` |
+| `pf.sh status` | `pf.sh sprint status` |
+| `pf.sh backlog` | `pf.sh sprint backlog` |
+| `pf.sh work` | `pf.sh sprint work` |
+| `pf.sh story` | `pf.sh sprint story` |
 | `/pf-session new` | `/pf-sprint work` |
 ---

package/pennyfarthing-dist/skills/pf-sprint/usage.md CHANGED Viewed

@@ -2,7 +2,7 @@
 ## Top-Level Commands
-### `pf sprint status [FILTER]`
+### `pf.sh sprint status [FILTER]`
 | Arg | Required | Type | Description |
 |-----|----------|------|-------------|
@@ -10,11 +10,11 @@
 Returns sprint metadata, stories grouped by epic, points breakdown.
-### `pf sprint backlog`
+### `pf.sh sprint backlog`
 No arguments. Shows stories with `backlog`, `ready`, or `planning` status grouped by epic.
-### `pf sprint work [STORY_ID] [--dry-run]`
+### `pf.sh sprint work [STORY_ID] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -23,7 +23,7 @@ No arguments. Shows stories with `backlog`, `ready`, or `planning` status groupe
 Without argument: shows backlog. With `next`: auto-selects highest priority.
-### `pf sprint archive <STORY_ID> [PR_NUMBER] [--apply] [--dry-run]`
+### `pf.sh sprint archive <STORY_ID> [PR_NUMBER] [--apply] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -32,7 +32,7 @@ Without argument: shows backlog. With `next`: auto-selects highest priority.
 | `--apply` | No | Also remove from current-sprint.yaml |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint new <YYWW> <JIRA_ID> <START> <END> <GOAL> [--dry-run]`
+### `pf.sh sprint new <YYWW> <JIRA_ID> <START> <END> <GOAL> [--dry-run]`
 | Arg | Required | Description |
 |-----|----------|-------------|
@@ -45,7 +45,7 @@ Without argument: shows backlog. With `next`: auto-selects highest priority.
 Creates `sprint/current-sprint.yaml` and `sprint/archive/sprint-{YYWW}-completed.yaml`.
-### `pf sprint future [EPIC_ID]`
+### `pf.sh sprint future [EPIC_ID]`
 | Arg | Required | Description |
 |-----|----------|-------------|
@@ -53,11 +53,11 @@ Creates `sprint/current-sprint.yaml` and `sprint/archive/sprint-{YYWW}-completed
 Without arg: initiative summary. With arg: full epic detail with stories.
-### `pf sprint info`
+### `pf.sh sprint info`
 No arguments. Returns sprint header fields plus computed totals as JSON.
-### `pf sprint metrics [--json]`
+### `pf.sh sprint metrics [--json]`
 | Option | Description |
 |--------|-------------|
@@ -65,7 +65,7 @@ No arguments. Returns sprint header fields plus computed totals as JSON.
 Shows points, stories, timeline, and velocity tracking.
-### `pf sprint check <ID>`
+### `pf.sh sprint check <ID>`
 | Arg | Required | Description |
 |-----|----------|-------------|
@@ -73,7 +73,7 @@ Shows points, stories, timeline, and velocity tracking.
 Returns JSON with `type` (`story`, `epic`, `next`, `not_found`), availability, and details.
-### `pf sprint validate [SUBCOMMAND] [--fix] [--strict]`
+### `pf.sh sprint validate [SUBCOMMAND] [--fix] [--strict]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -85,14 +85,14 @@ Returns JSON with `type` (`story`, `epic`, `next`, `not_found`), availability, a
 ## Story Commands
-### `pf sprint story show <STORY_ID> [--json]`
+### `pf.sh sprint story show <STORY_ID> [--json]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
 | `STORY_ID` | Yes | Story ID (e.g., `MSSCI-12664` or `67-1`) |
 | `--json` | No | Output as JSON |
-### `pf sprint story add <EPIC_ID> <TITLE> <POINTS> [options]`
+### `pf.sh sprint story add <EPIC_ID> <TITLE> <POINTS> [options]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -110,7 +110,7 @@ Returns JSON with `type` (`story`, `epic`, `next`, `not_found`), availability, a
 When using `--initiative`, positional args shift: `<TITLE> <POINTS>` (no epic ID).
-### `pf sprint story update <STORY_ID> [options]`
+### `pf.sh sprint story update <STORY_ID> [options]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -127,7 +127,7 @@ When using `--initiative`, positional args shift: `<TITLE> <POINTS>` (no epic ID
 Auto-sets `completed` date when status is `done`. Auto-sets `started` and `assigned_to` when status is `in_progress`.
-### `pf sprint story field <STORY_ID> <FIELD>`
+### `pf.sh sprint story field <STORY_ID> <FIELD>`
 | Arg | Required | Description |
 |-----|----------|-------------|
@@ -136,19 +136,19 @@ Auto-sets `completed` date when status is `done`. Auto-sets `started` and `assig
 Returns field value or `null`. Defaults: `workflow=tdd`, `status=backlog`, `repos=pennyfarthing`.
-### `pf sprint story size [POINTS]`
+### `pf.sh sprint story size [POINTS]`
 | Arg | Required | Description |
 |-----|----------|-------------|
 | `POINTS` | No | Specific point value |
-### `pf sprint story template [TYPE]`
+### `pf.sh sprint story template [TYPE]`
 | Arg | Required | Description |
 |-----|----------|-------------|
 | `TYPE` | No | `feature`, `bug`, `refactor`, `chore` |
-### `pf sprint story finish <STORY_ID> [--dry-run]`
+### `pf.sh sprint story finish <STORY_ID> [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -157,7 +157,7 @@ Returns field value or `null`. Defaults: `workflow=tdd`, `status=backlog`, `repo
 Requires: session file exists, PR approved, reviewer phase complete.
-### `pf sprint story claim <STORY_ID> [--claim/--unclaim] [--dry-run]`
+### `pf.sh sprint story claim <STORY_ID> [--claim/--unclaim] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -169,7 +169,7 @@ Requires: session file exists, PR approved, reviewer phase complete.
 ## Epic Commands
-### `pf sprint epic show <EPIC_ID> [--json]`
+### `pf.sh sprint epic show <EPIC_ID> [--json]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -178,7 +178,7 @@ Requires: session file exists, PR approved, reviewer phase complete.
 Searches both current sprint and future initiative shards.
-### `pf sprint epic add <EPIC_ID> <TITLE> [options]`
+### `pf.sh sprint epic add <EPIC_ID> <TITLE> [options]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -192,7 +192,7 @@ Searches both current sprint and future initiative shards.
 | `--sprint-file` | No | Path to sprint YAML file |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint epic update <EPIC_ID> [options]`
+### `pf.sh sprint epic update <EPIC_ID> [options]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -202,7 +202,7 @@ Searches both current sprint and future initiative shards.
 | `--sprint-file` | No | Path to sprint YAML file |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint epic promote <EPIC_ID> [--dry-run]`
+### `pf.sh sprint epic promote <EPIC_ID> [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -211,7 +211,7 @@ Searches both current sprint and future initiative shards.
 Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions. Validates before writing.
-### `pf sprint epic archive [EPIC_ID] [--dry-run] [--jira]`
+### `pf.sh sprint epic archive [EPIC_ID] [--dry-run] [--jira]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -219,7 +219,7 @@ Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions.
 | `--dry-run` | No | Preview without making changes |
 | `--jira` | No | Also update Jira epic status to Done |
-### `pf sprint epic cancel <EPIC_ID> [--jira] [--dry-run]`
+### `pf.sh sprint epic cancel <EPIC_ID> [--jira] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -227,7 +227,7 @@ Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions.
 | `--jira` | No | Also cancel in Jira |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint epic import <FILE> [INITIATIVE] [--marker TAG] [--dry-run]`
+### `pf.sh sprint epic import <FILE> [INITIATIVE] [--marker TAG] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -236,14 +236,14 @@ Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions.
 | `--marker` | No | Marker tag for stories (default: `imported`) |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint epic remove <EPIC_ID> [--dry-run]`
+### `pf.sh sprint epic remove <EPIC_ID> [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
 | `EPIC_ID` | Yes | Epic ID (e.g., `epic-41`) |
 | `--dry-run` | No | Preview without making changes |
-### `pf sprint epic field <EPIC_ID> <FIELD>`
+### `pf.sh sprint epic field <EPIC_ID> <FIELD>`
 | Arg | Required | Description |
 |-----|----------|-------------|
@@ -254,14 +254,14 @@ Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions.
 ## Initiative Commands
-### `pf sprint initiative show <NAME> [--json]`
+### `pf.sh sprint initiative show <NAME> [--json]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
 | `NAME` | Yes | Initiative slug (e.g., `benchmark-reliability`) |
 | `--json` | No | Output as JSON |
-### `pf sprint initiative cancel <NAME> [--jira] [--dry-run]`
+### `pf.sh sprint initiative cancel <NAME> [--jira] [--dry-run]`
 | Arg/Option | Required | Description |
 |------------|----------|-------------|
@@ -290,4 +290,4 @@ Moves epic from initiative shard to current-sprint.yaml. Detects ID collisions.
 | Workflow | `tdd`, `trivial`, `bdd`, `tdd-tandem`, `bdd-tandem`, `agent-docs` |
 | Priority | `P0`, `P1`, `P2`, `P3` |
-Note: `tdd-tandem` and `bdd-tandem` are valid workflow values in YAML but the `pf sprint story add --workflow` CLI choice is limited to `tdd`, `trivial`, `bdd`. Set tandem workflows via `pf sprint story update --workflow tdd-tandem`.
+Note: `tdd-tandem` and `bdd-tandem` are valid workflow values in YAML but the `pf.sh sprint story add --workflow` CLI choice is limited to `tdd`, `trivial`, `bdd`. Set tandem workflows via `pf.sh sprint story update --workflow tdd-tandem`.

package/pennyfarthing-dist/skills/pf-theme/examples.md CHANGED Viewed

@@ -4,54 +4,54 @@
 ```bash
 # List all available themes with tiers
-pf theme list
+pf.sh theme list
 # Show current theme
-pf theme show
+pf.sh theme show
 # Show specific theme
-pf theme show blade-runner
+pf.sh theme show blade-runner
 # Show full details (OCEAN, quirks, catchphrases)
-pf theme show blade-runner --full
-pf theme show fifth-element --full
+pf.sh theme show blade-runner --full
+pf.sh theme show fifth-element --full
 ```
 ## Changing Theme
 ```bash
 # Set theme
-pf theme set blade-runner
+pf.sh theme set blade-runner
 # Preview without changing
-pf theme set blade-runner --dry-run
+pf.sh theme set blade-runner --dry-run
 # Refresh agent persona after change
-pf agent start "sm"
+pf.sh agent start "sm"
 ```
 ## Creating Custom Themes
 ```bash
 # Create from current theme
-pf theme create my-team
+pf.sh theme create my-team
 # Create from specific base
-pf theme create my-team --base blade-runner
+pf.sh theme create my-team --base blade-runner
 # Create as user-level (available across projects)
-pf theme create my-team --user
+pf.sh theme create my-team --user
 # Create from specific base as user-level
-pf theme create my-team --base fifth-element --user
+pf.sh theme create my-team --base fifth-element --user
 # Preview
-pf theme create my-team --base blade-runner --dry-run
+pf.sh theme create my-team --base blade-runner --dry-run
 ```
 After creation:
 1. Edit the theme file to customize agents
-2. Run `pf theme set my-team` to activate
+2. Run `pf.sh theme set my-team` to activate
 ## Theme Maker (Interactive)
@@ -73,7 +73,7 @@ Specify character name, style, and quote for each agent. Skip agents for default
 ### After Creation
 ```bash
 # Activate the new theme
-pf theme set my-universe
+pf.sh theme set my-universe
 # Generate portraits (optional, requires GPU)
 ./scripts/generate-portraits.sh --theme my-universe

package/pennyfarthing-dist/skills/pf-theme/skill.md CHANGED Viewed

@@ -12,18 +12,18 @@ Manage persona themes for agent characters.
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/theme` | `pf theme show` | Show current theme |
-| `/theme list` | `pf theme list` | List all available themes |
-| `/theme show [name]` | `pf theme show [name] [--full]` | Show theme details |
-| `/theme set <name>` | `pf theme set <name> [--dry-run]` | Set active theme |
-| `/theme create <name>` | `pf theme create <name> [--base X] [--user] [--dry-run]` | Create from base theme |
+| `/theme` | `pf.sh theme show` | Show current theme |
+| `/theme list` | `pf.sh theme list` | List all available themes |
+| `/theme show [name]` | `pf.sh theme show [name] [--full]` | Show theme details |
+| `/theme set <name>` | `pf.sh theme set <name> [--dry-run]` | Set active theme |
+| `/theme create <name>` | `pf.sh theme create <name> [--base X] [--user] [--dry-run]` | Create from base theme |
 | `/theme maker` | *(interactive wizard)* | AI-driven theme creation |
 ### After Setting a Theme
 Refresh the current agent persona:
 ```bash
-pf agent start "sm"
+pf.sh agent start "sm"
 ```
 Adopt the new character immediately.

package/pennyfarthing-dist/skills/pf-theme/usage.md CHANGED Viewed

@@ -5,7 +5,7 @@
 ### List Themes
 ```bash
-pf theme list
+pf.sh theme list
 ```
 No arguments. Shows all available themes with:
@@ -17,7 +17,7 @@ Copy output into response text — Bash tool output may be collapsed in the UI.
 ### Show Theme
 ```bash
-pf theme show [NAME] [--full]
+pf.sh theme show [NAME] [--full]
 ```
 | Arg/Option | Required | Description |
@@ -30,7 +30,7 @@ Copy output into response text.
 ### Set Theme
 ```bash
-pf theme set <NAME> [--dry-run]
+pf.sh theme set <NAME> [--dry-run]
 ```
 | Arg/Option | Required | Description |
@@ -42,14 +42,14 @@ Updates `.pennyfarthing/config.local.yaml` with theme name and character map.
 After setting, refresh agent persona:
 ```bash
-pf agent start "sm"
+pf.sh agent start "sm"
 ```
 Adopt the new character immediately.
 ### Create Theme
 ```bash
-pf theme create <NAME> [--base <THEME>] [--user] [--dry-run]
+pf.sh theme create <NAME> [--base <THEME>] [--user] [--dry-run]
 ```
 | Arg/Option | Required | Description |

package/pennyfarthing-dist/skills/pf-workflow/examples.md CHANGED Viewed

@@ -4,86 +4,86 @@
 ```bash
 # List all available workflows
-pf workflow list
+pf.sh workflow list
 # Show TDD workflow details
-pf workflow show tdd
+pf.sh workflow show tdd
 # Show current session's workflow
-pf workflow show
+pf.sh workflow show
 # Show trivial workflow
-pf workflow show trivial
+pf.sh workflow show trivial
 ```
 ## Checking State
 ```bash
 # Check current workflow state
-pf workflow check
-pf workflow check --json
+pf.sh workflow check
+pf.sh workflow check --json
 # Who owns the "review" phase in TDD?
-pf workflow phase-check tdd review
+pf.sh workflow phase-check tdd review
 # Returns: reviewer
 # Who owns the "implement" phase in trivial?
-pf workflow phase-check trivial implement
+pf.sh workflow phase-check trivial implement
 # Returns: dev
 # Get workflow type
-pf workflow type tdd
+pf.sh workflow type tdd
 # Returns: phased
-pf workflow type architecture
+pf.sh workflow type architecture
 # Returns: stepped
 # Emit handoff marker for Cyclist
-pf workflow handoff reviewer
+pf.sh workflow handoff reviewer
 ```
 ## Stepped Workflows (BikeLane)
 ```bash
 # Start architecture workflow in create mode (default)
-pf workflow start architecture
+pf.sh workflow start architecture
 # Start in validate mode
-pf workflow start architecture --mode validate
+pf.sh workflow start architecture --mode validate
 # Check progress
-pf workflow status
+pf.sh workflow status
 # Resume after interruption
-pf workflow resume
-pf workflow resume architecture
+pf.sh workflow resume
+pf.sh workflow resume architecture
 # Complete current step and advance
-pf workflow complete-step
-pf workflow complete-step architecture --step 3
+pf.sh workflow complete-step
+pf.sh workflow complete-step architecture --step 3
 ```
 ## Phase Repair
 ```bash
 # Preview phase fix
-pf workflow fix-phase 56-1 review --dry-run
+pf.sh workflow fix-phase 56-1 review --dry-run
 # Fix phase to review (after Dev completed)
-pf workflow fix-phase 56-1 review
+pf.sh workflow fix-phase 56-1 review
 # Fix phase to approved (after Reviewer approved)
-pf workflow fix-phase 56-1 approved
+pf.sh workflow fix-phase 56-1 approved
 # Using Jira key
-pf workflow fix-phase MSSCI-12190 approved
+pf.sh workflow fix-phase MSSCI-12190 approved
 ```
 ## Switching Workflow Mid-Session
 1. Verify the target workflow exists:
    ```bash
-   pf workflow show trivial
+   pf.sh workflow show trivial
    ```
 2. Edit the session file:
@@ -97,16 +97,16 @@ pf workflow fix-phase MSSCI-12190 approved
 ### Story upgraded from trivial to TDD
 ```bash
 # Check current state
-pf workflow check --json
+pf.sh workflow check --json
 # Edit session to change workflow from trivial to tdd
 # Fix phase to match where you are
-pf workflow fix-phase 56-1 red
+pf.sh workflow fix-phase 56-1 red
 ```
 ### Agent activated on wrong phase
 ```bash
 # Check who owns the current phase
-pf workflow phase-check tdd review
+pf.sh workflow phase-check tdd review
 # Returns: reviewer — hand off if you're not the reviewer
-pf workflow handoff reviewer
+pf.sh workflow handoff reviewer
 ```

package/pennyfarthing-dist/skills/pf-workflow/skill.md CHANGED Viewed

@@ -15,18 +15,18 @@ Pennyfarthing uses YAML-defined workflows to control agent sequences. The defaul
 | Command | CLI | Purpose |
 |---------|-----|---------|
-| `/pf-workflow` or `/pf-workflow list` | `pf workflow list` | List all workflows |
-| `/pf-workflow show [name]` | `pf workflow show [name]` | Show workflow details |
+| `/pf-workflow` or `/pf-workflow list` | `pf.sh workflow list` | List all workflows |
+| `/pf-workflow show [name]` | `pf.sh workflow show [name]` | Show workflow details |
 | `/pf-workflow set <name>` | Edit session file `**Workflow:**` line | Switch workflow mid-session |
-| `/pf-workflow start <name>` | `pf workflow start <name> [--mode M]` | Start stepped workflow |
-| `/pf-workflow resume [name]` | `pf workflow resume [name]` | Resume interrupted workflow |
-| `/pf-workflow status` | `pf workflow status` | Show stepped workflow progress |
-| `/pf-workflow fix-phase <id> <phase>` | `pf workflow fix-phase <id> <phase> [--dry-run]` | Repair session phase |
-| Check workflow state | `pf workflow check [--json]` | Current story, phase, state |
-| Check phase owner | `pf workflow phase-check <workflow> <phase>` | Which agent owns a phase |
-| Get workflow type | `pf workflow type <workflow>` | phased/stepped/procedural |
-| Emit handoff marker | `pf workflow handoff <next-agent>` | CYCLIST handoff marker |
-| Complete step | `pf workflow complete-step [name] [--step N]` | Advance stepped workflow |
+| `/pf-workflow start <name>` | `pf.sh workflow start <name> [--mode M]` | Start stepped workflow |
+| `/pf-workflow resume [name]` | `pf.sh workflow resume [name]` | Resume interrupted workflow |
+| `/pf-workflow status` | `pf.sh workflow status` | Show stepped workflow progress |
+| `/pf-workflow fix-phase <id> <phase>` | `pf.sh workflow fix-phase <id> <phase> [--dry-run]` | Repair session phase |
+| Check workflow state | `pf.sh workflow check [--json]` | Current story, phase, state |
+| Check phase owner | `pf.sh workflow phase-check <workflow> <phase>` | Which agent owns a phase |
+| Get workflow type | `pf.sh workflow type <workflow>` | phased/stepped/procedural |
+| Emit handoff marker | `pf.sh workflow handoff <next-agent>` | CYCLIST handoff marker |
+| Complete step | `pf.sh workflow complete-step [name] [--step N]` | Advance stepped workflow |
 ### Built-in Workflows