@pennyfarthing/core 11.2.1 → 11.3.1

package/pennyfarthing-dist/scripts/hooks/bell-mode-hook.sh

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

package/pennyfarthing-dist/scripts/hooks/context-circuit-breaker.sh

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

package/pennyfarthing-dist/scripts/hooks/context-warning.sh

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

package/pennyfarthing-dist/scripts/hooks/cyclist-pretooluse-hook.sh

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

package/pennyfarthing-dist/scripts/hooks/otel-auto-config.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 # otel-auto-config.sh - Auto-configure OTEL for Cyclist web mode (Story 20-1)
 #
-# This hook checks for a .wheelhub-port file in the project directory.
+# This hook checks for a .bikerack-port file in the project directory.
 # If found, it sets the OTEL environment variables to connect Claude Code
 # telemetry to the running Cyclist server.
 #
@@ -9,15 +9,15 @@
 #   source /path/to/otel-auto-config.sh
 #
 # Prerequisites:
-#   - Cyclist must be running in web mode (writes .wheelhub-port file)
+#   - Cyclist must be running in web mode (writes .bikerack-port file)
 #   - CLAUDE_PROJECT_DIR must be set (standard in Claude Code environment)
 
 # Determine project directory
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
 
-# Read port from .wheelhub-port (used by both Cyclist and BikeRack)
+# Read port from .bikerack-port (used by both Cyclist and BikeRack)
 PORT=""
-PORT_FILE="$PROJECT_DIR/.wheelhub-port"
+PORT_FILE="$PROJECT_DIR/.bikerack-port"
 if [[ -f "$PORT_FILE" ]]; then
   PORT=$(cat "$PORT_FILE" 2>/dev/null)
   # Validate port is a number
@@ -28,6 +28,7 @@ fi
 
 # Configure OTEL if a valid port was found
 if [[ -n "$PORT" ]]; then
+  export CLAUDE_CODE_ENABLE_TELEMETRY=1
   export OTEL_EXPORTER_OTLP_PROTOCOL="http/json"
   export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:$PORT"
 

package/pennyfarthing-dist/scripts/hooks/pre-commit.sh

@@ -134,7 +134,8 @@ fi
 SPRINT_YAML_FILES=$(git diff --cached --name-only -- 'sprint/*.yaml' 'sprint/archive/*.yaml' 2>/dev/null \
     | grep -v 'sprint-template\.yaml$' \
     | grep -v 'sprint/completed\.yaml$' \
-    | grep -v 'sprint/context/archived/' || true)
+    | grep -v 'sprint/context/archived/' \
+    | grep -v 'sprints\.yaml$' || true)
 
 if [[ -n "$SPRINT_YAML_FILES" ]]; then
     echo "Sprint YAML files staged for commit:"

package/pennyfarthing-dist/scripts/hooks/pre-edit-check.sh

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

package/pennyfarthing-dist/scripts/hooks/question-reflector-check.sh

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

package/pennyfarthing-dist/scripts/hooks/schema-validation.sh

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

package/pennyfarthing-dist/scripts/hooks/session-start.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
-# DEPRECATED: This script is a shim. Logic has moved to Python.
-# Use: pf hooks session-start
-exec pf hooks session-start
+# 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 session-start

package/pennyfarthing-dist/scripts/hooks/session-stop.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
-# DEPRECATED: This script is a shim. Logic has moved to Python.
-# Use: pf hooks session-stop
-exec pf hooks session-stop
+# 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 session-stop

package/pennyfarthing-dist/scripts/hooks/sprint-yaml-validation.sh

@@ -1,4 +1,4 @@
 #!/usr/bin/env bash
-# DEPRECATED: This script is a shim. Logic has moved to Python.
-# Use: pf hooks sprint-yaml
-exec pf hooks sprint-yaml
+# 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 sprint-yaml

package/pennyfarthing-dist/scripts/hooks/welcome-hook.sh

@@ -1,5 +1,4 @@
 #!/usr/bin/env bash
-# DEPRECATED: This script is a shim. Logic has moved to Python.
-# Welcome is now part of session-start.
-# Use: pf hooks session-start
-exec pf hooks session-start
+# 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 session-start

package/pennyfarthing-dist/scripts/lib/env.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+# Resolve CLAUDE_PROJECT_DIR in any context (hooks, Bash tool, subshells).
+#
+# Claude Code sets CLAUDE_PROJECT_DIR for hook execution but NOT for the
+# Bash tool environment.  This script fills the gap by walking up from PWD
+# to find .pennyfarthing/, mirroring find-root.sh's fallback strategy.
+#
+# Usage:
+#   source .pennyfarthing/scripts/lib/env.sh   # relative (Bash tool)
+#   source "$CLAUDE_PROJECT_DIR/.pennyfarthing/scripts/lib/env.sh"  # hooks (already set)
+#
+# After sourcing, CLAUDE_PROJECT_DIR is exported and safe to use.
+
+if [[ -z "${CLAUDE_PROJECT_DIR:-}" ]]; then
+  _d="$PWD"
+  while [[ ! -d "$_d/.pennyfarthing" ]] && [[ "$_d" != "/" ]]; do
+    _d="$(dirname "$_d")"
+  done
+  if [[ -d "$_d/.pennyfarthing" ]]; then
+    # Guard against nested .pennyfarthing (e.g., inlined child repo).
+    # If the found dir sits inside a parent that also has .pennyfarthing/,
+    # prefer the parent (outermost project root).
+    _parent="$(dirname "$_d")"
+    while [[ "$_parent" != "/" ]]; do
+      if [[ -d "$_parent/.pennyfarthing" ]]; then
+        _d="$_parent"
+      fi
+      _parent="$(dirname "$_parent")"
+    done
+    unset _parent
+    export CLAUDE_PROJECT_DIR="$_d"
+  fi
+  unset _d
+fi

package/pennyfarthing-dist/scripts/lib/find-root.sh

@@ -29,6 +29,11 @@ if [[ -n "$_caller_script" ]]; then
         _pkg="${_pkg%/.pennyfarthing}"
         if [[ "$_pkg" == */node_modules/* ]]; then
             PROJECT_ROOT="${_pkg%/node_modules/*}"
+        elif [[ -d "$_pkg/.pennyfarthing" ]]; then
+            PROJECT_ROOT="$_pkg"
+        elif [[ -d "$_pkg/../.pennyfarthing" ]]; then
+            # Dogfooding: pennyfarthing/ inlined inside orchestrator
+            PROJECT_ROOT="$(cd "$_pkg/.." && pwd -P)"
         else
             PROJECT_ROOT="$_pkg"
         fi

package/pennyfarthing-dist/scripts/lib/run-pf.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# Shared utility: Run the `pf` CLI via uv run — no global install needed.
+#
+# Resolution order for pyproject.toml:
+# 1. Dogfooding: $PROJECT_ROOT/pennyfarthing/pyproject.toml (inlined repo)
+# 2. Consumer:   $PROJECT_ROOT/pyproject.toml (project declares dependency)
+#
+# Usage from hook shims:
+#   source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)/../lib/run-pf.sh"
+#   exec_pf hooks session-start
+
+# Resolve PROJECT_ROOT if not already set
+_lib_dir="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd -P)"
+source "$_lib_dir/find-root.sh"
+
+# Find the pyproject.toml that provides pennyfarthing-scripts
+_pf_project=""
+if [[ -f "$PROJECT_ROOT/pennyfarthing/pyproject.toml" ]]; then
+    # Dogfooding: inlined framework repo
+    _pf_project="$PROJECT_ROOT/pennyfarthing"
+elif [[ -f "$PROJECT_ROOT/pyproject.toml" ]]; then
+    # Consumer: project-level pyproject.toml with pennyfarthing-scripts dep
+    _pf_project="$PROJECT_ROOT"
+elif [[ -f "$PROJECT_ROOT/.pennyfarthing/pyproject.toml" ]]; then
+    # Consumer: auto-generated by pennyfarthing init
+    _pf_project="$PROJECT_ROOT/.pennyfarthing"
+fi
+
+if [[ -z "$_pf_project" ]]; then
+    echo "Error: No pyproject.toml found for pennyfarthing-scripts" >&2
+    echo "Expected: $PROJECT_ROOT/pennyfarthing/pyproject.toml (dogfooding)" >&2
+    echo "      or: $PROJECT_ROOT/pyproject.toml (consumer)" >&2
+    echo "      or: $PROJECT_ROOT/.pennyfarthing/pyproject.toml (auto-generated)" >&2
+    exit 1
+fi
+
+run_pf() {
+    uv run --project "$_pf_project" pf "$@"
+}
+
+exec_pf() {
+    exec uv run --project "$_pf_project" pf "$@"
+}

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