@pennyfarthing/core 11.4.0 → 12.0.0

package/pennyfarthing-dist/templates/justfile.template

@@ -0,0 +1,71 @@
+# ${PROJECT_NAME} — project tasks
+# Generated by pf setup — safe to customize
+
+root := justfile_directory()
+
+default:
+    @just --list
+
+# Start WheelHub server (API + WebSocket)
+# Usage: just wheelhub [start|stop|status]
+wheelhub *args:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    subcmd="{{args}}"
+    case "${subcmd:-start}" in
+        start)  uv run --project "{{root}}/.pennyfarthing" pf launch gui --no-open ;;
+        stop)   uv run --project "{{root}}/.pennyfarthing" pf launch stop ;;
+        status) uv run --project "{{root}}/.pennyfarthing" pf launch status ;;
+        *)      echo "Usage: just wheelhub [start|stop|status]"; exit 1 ;;
+    esac
+
+# Launch TUI panel viewer (starts WheelHub if needed)
+tui:
+    uv run --project "{{root}}/.pennyfarthing" --extra tui pf launch tui --foreground
+
+# Launch GUI dashboard in browser (starts WheelHub if needed)
+gui:
+    uv run --project "{{root}}/.pennyfarthing" pf launch gui
+
+# Launch Claude with OTEL pre-configured for WheelHub/BikeRack
+claude:
+    #!/usr/bin/env bash
+    set -euo pipefail
+
+    project_dir="{{root}}"
+    PORT=""
+
+    # Check .cyclist-port first, then .bikerack-port
+    for port_file in "$project_dir/.cyclist-port" "$project_dir/.bikerack-port"; do
+        if [[ -f "$port_file" ]]; then
+            candidate=$(cat "$port_file" 2>/dev/null)
+            if [[ "$candidate" =~ ^[0-9]+$ ]]; then
+                if (echo >/dev/tcp/localhost/"$candidate") 2>/dev/null; then
+                    PORT="$candidate"
+                    break
+                fi
+            fi
+        fi
+    done
+
+    if [[ -n "$PORT" ]]; then
+        echo "[just claude] OTEL configured → http://localhost:$PORT" >&2
+        export CLAUDE_CODE_ENABLE_TELEMETRY="1"
+        export OTEL_EXPORTER_OTLP_PROTOCOL="http/json"
+        export OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:$PORT"
+        export OTEL_LOGS_EXPORTER="otlp"
+        export OTEL_METRICS_EXPORTER="otlp"
+    else
+        echo "[just claude] No WheelHub/BikeRack running — launching without OTEL" >&2
+        echo "[just claude] Start one first: just wheelhub start" >&2
+    fi
+
+    exec claude
+
+# Launch tmux dev layout (Claude + TUI in split panes)
+tmux-dev:
+    exec "{{root}}/tmux-dev"
+
+# Launch tmux dev layout for a specific directory
+tmux dir=invocation_directory():
+    "{{root}}/tmux-dev" "{{dir}}"

package/pennyfarthing-dist/templates/preferences.yaml.template

@@ -1,15 +1,12 @@
 # Pennyfarthing User Preferences
-# Copy to .claude/pennyfarthing/preferences.yaml to customize
-# Override with .local.yaml for personal preferences (gitignored)
+# These settings control agent behavior and output formatting.
+# Copy to .pennyfarthing/preferences.yaml and customize.
 
-# Enable persona character voice in agent output
-# When false, agents respond in a neutral, professional tone
+# Enable character voice in agent responses (themed personas)
 character_voice: true
 
-# Show reasoning and decision explanations
-# When true, agents explain their thought process
+# Include decision explanations in agent output
 explain_decisions: true
 
-# Auto-commit on story completion
-# When true, SM auto-commits after finishing a story
+# Automatically commit after phase completion
 auto_commit: false

package/pennyfarthing-dist/templates/pyproject.toml

@@ -1,4 +1,4 @@
-# Auto-generated by pennyfarthing init — provides Python dependencies for hooks.
+# Auto-generated by pf setup — provides Python dependencies for hooks.
 # This file enables `uv run --project` to resolve the pf package.
 # Safe to customize: init/update will not overwrite this file once created.
 
@@ -19,6 +19,14 @@ dependencies = [
 [project.scripts]
 pf = "pf.cli:main"
 
+[project.optional-dependencies]
+tui = [
+    "textual>=1.0",
+    "websockets>=12.0",
+    "textual-image>=0.7.0",
+    "watchfiles>=1.0",
+]
+
 [build-system]
 requires = ["setuptools>=68.0"]
 build-backend = "setuptools.build_meta"

package/pennyfarthing-dist/templates/settings.local.json.template

@@ -40,7 +40,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks session-start"
+            "command": "pf hooks session-start"
           }
         ]
       },
@@ -60,6 +60,15 @@
             "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/project/hooks/auto-load-sm.sh"
           }
         ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "pf prime"
+          }
+        ]
       }
     ],
     "Stop": [
@@ -68,7 +77,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks reflector-check"
+            "command": "pf hooks reflector-check"
           }
         ]
       },
@@ -77,7 +86,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks session-stop"
+            "command": "pf hooks session-stop"
           }
         ]
       }
@@ -88,7 +97,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks bell-mode"
+            "command": "pf hooks bell-mode"
           }
         ]
       },
@@ -97,7 +106,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks sprint-yaml"
+            "command": "pf hooks sprint-yaml"
           }
         ]
       }
@@ -108,7 +117,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks pre-edit-check"
+            "command": "pf hooks pre-edit-check"
           }
         ]
       },
@@ -117,7 +126,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks schema-validation"
+            "command": "pf hooks schema-validation"
           }
         ]
       },
@@ -126,7 +135,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks context-warning"
+            "command": "pf hooks context-warning"
           }
         ]
       },
@@ -135,7 +144,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks context-breaker"
+            "command": "pf hooks context-breaker"
           }
         ]
       },
@@ -143,7 +152,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks cyclist-pretooluse"
+            "command": "pf hooks cyclist-pretooluse"
           }
         ]
       }
@@ -151,6 +160,6 @@
   },
   "statusLine": {
     "type": "command",
-    "command": "\"$CLAUDE_PROJECT_DIR\"/.pennyfarthing/scripts/core/pf.sh hooks statusline"
+    "command": "pf hooks statusline"
   }
 }

package/pennyfarthing-dist/templates/tmux-dev.template

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ${PROJECT_NAME} — tmux dev layout
+#
+# Layout (top/bottom):
+# ┌──────────────────────────────────────┐
+# │            claude code               │
+# ├──────────────────────────────────────┤
+# │              TUI                     │
+# └──────────────────────────────────────┘
+#
+# Usage: ./tmux-dev [directory]
+#   directory defaults to current working directory
+#
+# Uses a dedicated tmux socket (-L pf) so the project tmux.conf
+# is guaranteed to load, avoiding conflicts with ~/.tmux.conf.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+DIR="${1:-$(pwd)}"
+DIR="$(cd "$DIR" && pwd)"
+SESSION="pf"
+SOCKET="pf"
+
+# Kill existing session on our socket if running
+tmux -L "$SOCKET" kill-session -t "$SESSION" 2>/dev/null || true
+
+# Pass Kitty env vars so image protocol detection works inside tmux
+# (tmux overwrites TERM to tmux-256color, hiding the real terminal)
+export KITTY_WINDOW_ID="${KITTY_WINDOW_ID:-}"
+export TERM_PROGRAM="${TERM_PROGRAM:-}"
+
+# Create session with top pane (claude)
+tmux -L "$SOCKET" -f "$SCRIPT_DIR/tmux.conf" new-session -d -s "$SESSION" -c "$DIR" -e "KITTY_WINDOW_ID=$KITTY_WINDOW_ID" -e "TERM_PROGRAM=$TERM_PROGRAM"
+tmux -L "$SOCKET" send-keys -t "$SESSION" "just claude" Enter
+
+# Split vertically → bottom pane (tui)
+tmux -L "$SOCKET" split-window -v -t "$SESSION" -c "$DIR" -e "KITTY_WINDOW_ID=$KITTY_WINDOW_ID" -e "TERM_PROGRAM=$TERM_PROGRAM"
+tmux -L "$SOCKET" send-keys -t "$SESSION" "just tui" Enter
+
+# Focus on claude pane
+tmux -L "$SOCKET" select-pane -t "$SESSION.0"
+
+# Attach
+tmux -L "$SOCKET" attach -t "$SESSION"

package/pennyfarthing-dist/templates/tmux.conf.template

@@ -0,0 +1,91 @@
+# Pennyfarthing Development - tmux config
+# Usage: ./tmux-dev (launcher script)
+#
+# Layout (top/bottom):
+# ┌──────────────────────────────────────┐
+# │            claude code               │
+# ├──────────────────────────────────────┤
+# │              TUI                     │
+# └──────────────────────────────────────┘
+
+# --- Key passthrough ---
+# Enable extended keys (CSI u mode) so shift+enter, ctrl+enter, etc.
+# are properly distinguished from plain enter in Claude Code CLI
+set -g extended-keys on
+set -g extended-keys-format csi-u
+set -as terminal-features ",*:extkeys"
+
+# Don't let tmux eat modifier keys
+set -g xterm-keys on
+
+# --- Clipboard (OSC 52) ---
+# Claude Code uses OSC 52 for copy-to-clipboard. Without this, copy
+# operations silently fail because tmux strips the escape sequences.
+set -g set-clipboard on
+set -as terminal-overrides ",*:Ms=\\E]52;c;%p2%s\\7"
+
+# --- Bracketed paste ---
+# Prevent tmux from double-wrapping paste sequences, which causes garbled
+# input or character-by-character interpretation in Claude Code CLI
+set -as terminal-overrides ",*:Ss=\\E[%p1%d q:Se=\\E[2 q"
+
+# --- Image passthrough ---
+# Allow inline image protocols (Kitty, iTerm2, Sixel) to pass through tmux
+# so portraits and logos render in the terminal
+set -g allow-passthrough all
+
+# Propagate Kitty env vars into tmux sessions so image protocol
+# detection works (tmux overwrites TERM to tmux-256color)
+set -ga update-environment "KITTY_WINDOW_ID"
+set -ga update-environment "TERM_PROGRAM"
+
+# --- Terminal capabilities ---
+# Truecolor support
+set -g default-terminal "tmux-256color"
+set -as terminal-overrides ",*:Tc"
+
+# Unicode/wide character rendering — tell tmux to trust the terminal's
+# width calculations rather than guessing, reduces box-drawing corruption
+set -gq utf8-option on
+
+# --- Mouse ---
+# Full mouse support: click to select pane, scroll, drag borders to resize
+set -g mouse on
+
+# --- Copy mode (macOS clipboard) ---
+# Use vi-style keys in copy mode
+set -g mode-keys vi
+# Mouse drag auto-enters copy mode; releasing the button copies to clipboard
+bind -T copy-mode-vi MouseDragEnd1Pane send -X copy-pipe-and-cancel "pbcopy"
+# 'y' in copy mode also copies to clipboard
+bind -T copy-mode-vi y send -X copy-pipe-and-cancel "pbcopy"
+# Enter in copy mode copies to clipboard
+bind -T copy-mode-vi Enter send -X copy-pipe-and-cancel "pbcopy"
+
+# Allow mouse scroll to enter copy-mode in the normal buffer but pass
+# scroll events through when an app (like Claude Code) uses alternate screen
+set -ga terminal-overrides ",*:smcup@:rmcup@"
+
+# --- Responsiveness ---
+# Low escape time so Esc-based sequences aren't laggy
+set -g escape-time 10
+
+# Pass focus events so apps can detect pane focus/blur
+set -g focus-events on
+
+# Generous scrollback for when you do enter copy-mode
+set -g history-limit 50000
+
+# --- Pane splitting ---
+# New splits target the top pane (Claude Code work area) rather than
+# rearranging the whole layout. The bottom pane (TUI) stays untouched.
+# Vertical split (left/right) within top pane
+bind | split-window -h -t '{top}'
+bind \\ split-window -h -t '{top}'
+# Horizontal split (top/bottom) within top pane
+bind - split-window -v -t '{top}'
+
+# --- Pane resize ---
+# Aggressively resize windows when switching between clients with different
+# terminal sizes (avoids the "small dots" problem in shared sessions)
+set -g aggressive-resize on

package/pennyfarthing-dist/workflows/installation-check/steps/step-01-foundation.md

@@ -14,7 +14,7 @@ Verify the core Pennyfarthing installation exists and is intact. This checks the
 </purpose>
 
 <prerequisites>
-- Project has been initialized with `pennyfarthing init`
+- Project has been initialized with `pf setup`
 - Running from the project root directory
 </prerequisites>
 
@@ -67,7 +67,7 @@ After reviewing foundation results, proceed to step-02-commands.md for Commands
 ## Failure Modes
 
 - Running from wrong directory (not project root)
-- Manifest missing entirely (needs `pennyfarthing init`)
+- Manifest missing entirely (needs `pf setup`)
 - Broken symlinks after `node_modules` cleanup without reinstall
 
 ## Success Metrics

package/pennyfarthing-dist/workflows/installation-check/steps/step-05-layout.md

@@ -73,7 +73,7 @@ After reviewing layout results, proceed to step-06-legacy.md for Legacy artifact
 ## Failure Modes
 
 - Moving files manually without updating references in settings.local.json
-- Missing sprint/ or .session/ directories (need `pennyfarthing init`)
+- Missing sprint/ or .session/ directories (need `pf setup`)
 
 ## Success Metrics
 

package/pennyfarthing-dist/workflows/installation-check/steps/step-07-tools.md

@@ -10,7 +10,7 @@ next: step-08-summary
 </step-meta>
 
 <purpose>
-Check optional components that enhance but are not required for core Pennyfarthing functionality. These include the Cyclist visual terminal and the pf Python CLI.
+Check the pf Python CLI (required — all hooks depend on it) and optional components like the Cyclist visual terminal.
 </purpose>
 
 <prerequisites>
@@ -23,8 +23,8 @@ Check optional components that enhance but are not required for core Pennyfarthi
    - **cyclist/installed**: Cyclist is the Electron visual terminal for Pennyfarthing. It provides a graphical UI with panels for sprint tracking, diffs, workflow visualization, and more. Not required for CLI-only usage.
    - **cyclist/node-pty**: node-pty powers the terminal panel in Cyclist. Without it, the embedded terminal won't work but other panels still function.
    - **cyclist/spawn-helper**: The native binary that node-pty uses to spawn processes. Must have execute permission on macOS/Linux. Missing permission causes `posix_spawnp` failures.
-   - **tools/pf-cli**: The Python `pf` command provides agent activation (`pf agent start`), hook dispatch (`pf hooks`), and sprint management. Required for agent workflows. Installable via `uv tool install pennyfarthing-scripts` or `pipx install pennyfarthing-scripts`.
-3. For missing tools, explain whether they're required or optional based on the user's workflow
+   - **tools/pf-cli**: **REQUIRED.** The Python `pf` command provides agent activation (`pf agent start`), hook dispatch (`pf hooks`), and sprint management. All Claude Code hooks call `pf` directly — without it, every session is broken. Install via `pipx install -e pennyfarthing-dist/` (editable) or `pipx install pennyfarthing-scripts` (released).
+3. For missing tools: pf CLI is **required** (hooks depend on it), Cyclist is optional based on the user's workflow
 4. Present the collaboration menu
 </instructions>
 
@@ -72,9 +72,10 @@ After reviewing tools, proceed to step-08-summary.md for the final health report
 
 - Installing Cyclist when only CLI usage is needed (unnecessary complexity)
 - spawn-helper permission issues after pnpm install (common on macOS)
+- Stale pf shim from deprecated uv install pointing to dead virtualenv
 
 ## Success Metrics
 
-- User understands which tools they need
-- Required tools (pf CLI) are installed
+- **pf CLI is installed and functional** (non-negotiable — hooks are broken without it)
+- User understands which optional tools they need
 - Optional tools have clear install path if wanted

package/pennyfarthing-dist/workflows/patch.yaml

@@ -56,12 +56,11 @@ workflow:
     handoff_on_complete: true
 
   triggers:
-    # Manual triggers
     commands:
       - "/patch"
       - "/fix-blocker"
-    # Automatic triggers (future)
-    # error_patterns:
-    #   - "No such file or directory"
-    #   - "ModuleNotFoundError"
-    #   - "command not found"
+      # Automatic triggers (future):
+      # error_patterns:
+      #   - "No such file or directory"
+      #   - "ModuleNotFoundError"
+      #   - "command not found"

package/pennyfarthing-dist/workflows/project-setup/steps/step-04-claude-md.md

@@ -101,6 +101,33 @@ This file provides guidance to Claude Code when working on this project.
 {test_command} -- --grep "pattern"    # Run specific tests
 ```
 
+## Developer Guidance
+
+{if has_pennyfarthing}
+### Getting Started
+
+- Run `/pf-help` for context-aware help on any command or agent
+- Run `/pf-sprint status` to see current sprint progress
+- Run `/pf-sprint work` to pick up your next story
+
+### Daily Workflow
+
+1. `/sm` — Start or resume a story (Scrum Master handles setup)
+2. Agent handoffs guide you through the workflow automatically
+3. `/reviewer` — Code review when implementation is complete
+4. `/sm` — Finish the story (archive, merge, Jira update)
+
+### Key Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/pf-help` | Context-aware help |
+| `/pf-sprint backlog` | See available work |
+| `/pf-sprint work STORY` | Start a specific story |
+| `/pf-theme show` | See your current persona theme |
+| `/pf-workflow` | Check active workflow status |
+{/if}
+
 ## Important Notes
 
 {Project-specific notes, gotchas, conventions}
@@ -135,7 +162,37 @@ If sprint/ exists:
 - `/pf-sprint work` - Start a story
 ```
 
-### 4. Add Project-Specific Sections
+### 4. Include Developer Guidance
+
+If `.pennyfarthing/` exists (Pennyfarthing is initialized):
+```markdown
+## Developer Guidance
+
+### Getting Started
+
+- Run `/pf-help` for context-aware help on any command or agent
+- Run `/pf-sprint status` to see current sprint progress
+- Run `/pf-sprint work` to pick up your next story
+
+### Daily Workflow
+
+1. `/sm` — Start or resume a story (Scrum Master handles setup)
+2. Agent handoffs guide you through the workflow automatically
+3. `/reviewer` — Code review when implementation is complete
+4. `/sm` — Finish the story (archive, merge, Jira update)
+
+### Key Commands
+
+| Command | Purpose |
+|---------|---------|
+| `/pf-help` | Context-aware help |
+| `/pf-sprint backlog` | See available work |
+| `/pf-sprint work STORY` | Start a specific story |
+| `/pf-theme show` | See your current persona theme |
+| `/pf-workflow` | Check active workflow status |
+```
+
+### 5. Add Project-Specific Sections
 
 Based on tech stack:
 
@@ -179,6 +236,7 @@ Options:
 ✅ Commands are correct and tested
 ✅ Structure matches actual project
 ✅ Workflows appropriate for project type
+✅ Developer guidance included (if Pennyfarthing initialized)
 ✅ User has reviewed and approved
 
 ## NEXT STEP

package/pennyfarthing-dist/workflows/release/steps/step-01-preflight.md

@@ -96,6 +96,9 @@ Set `IS_PRERELEASE=true` and `PRERELEASE_CHANNEL` (alpha/beta/rc) for use in lat
 # Check npm (prerelease uses dist-tag, but still check exact version)
 npm view @pennyfarthing/core@$NEW_VERSION version 2>/dev/null && echo "WARNING: $NEW_VERSION already on npm!"
 
+# Check PyPI
+pip index versions pennyfarthing-scripts 2>/dev/null | grep -q "$NEW_VERSION" && echo "WARNING: $NEW_VERSION already on PyPI!"
+
 # Check git tags
 git tag -l "v$NEW_VERSION" | grep -q . && echo "WARNING: Tag v$NEW_VERSION already exists!"
 
@@ -117,6 +120,7 @@ fi
 | Clean working dir  | ✓/✗    |
 | On develop branch  | ✓/✗    |
 | npm not published  | ✓/✗    |
+| PyPI not published | ✓/✗    |
 | Tag not exists     | ✓/✗    |
 
 **Version:** {CURRENT_VERSION} → {NEW_VERSION}

package/pennyfarthing-dist/workflows/release/steps/step-02-bump.md

@@ -1,17 +1,18 @@
 # Step 2: Bump Version
 
 <purpose>
-Update all version files (VERSION, package.json, workspace packages, README, CHANGELOG) and show the full diff for review before committing anything.
+Update all version files (VERSION, package.json, workspace packages, Python pf CLI, README, CHANGELOG) and show the full diff for review before committing anything.
 </purpose>
 
 <instructions>
 1. Write new version to VERSION file
 2. Update root package.json version
 3. Update all workspace package versions (core, cyclist, shared, theme packs)
-4. Update README.md version badge
-5. Update package-lock.json
-6. Update CHANGELOG.md (version links and header)
-7. Show complete diff of all changes for review
+4. Update Python pf CLI version (`pennyfarthing-dist/src/pf/__init__.py`)
+5. Update README.md version badge
+6. Update package-lock.json
+7. Update CHANGELOG.md (version links and header)
+8. Show complete diff of all changes for review
 </instructions>
 
 <output>
@@ -45,7 +46,15 @@ for PKG_JSON in packages/*/package.json; do
 done
 ```
 
-### 2.4 Update README.md
+### 2.4 Update Python pf CLI Version
+
+```bash
+# Update __version__ in pf/__init__.py (source of truth for PyPI package)
+sed -i '' -E 's/__version__ = "[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?"/__version__ = "{new_version}"/' pennyfarthing-dist/src/pf/__init__.py
+echo "Updated pennyfarthing-dist/src/pf/__init__.py"
+```
+
+### 2.5 Update README.md
 
 **Skip for prerelease** — README should always reflect the latest stable version.
 
@@ -55,13 +64,13 @@ if [[ "$IS_PRERELEASE" != "true" ]]; then
 fi
 ```
 
-### 2.5 Update package-lock.json
+### 2.6 Update package-lock.json
 
 ```bash
 [[ -f package.json ]] && npm install --package-lock-only --silent 2>/dev/null
 ```
 
-### 2.6 Update CHANGELOG.md
+### 2.7 Update CHANGELOG.md
 
 ```bash
 TODAY=$(date +%Y-%m-%d)
@@ -69,7 +78,7 @@ TODAY=$(date +%Y-%m-%d)
 # See deploy.sh for full sed commands
 ```
 
-### 2.7 Show Diff for Review
+### 2.8 Show Diff for Review
 
 ```bash
 echo "=== Version Bump Diff ==="
@@ -86,6 +95,7 @@ git diff --stat
 | `VERSION` | `{new_version}` |
 | `package.json` | `"version": "{new_version}"` |
 | `packages/*/package.json` | `"version": "{new_version}"` (all workspace packages) |
+| `pennyfarthing-dist/src/pf/__init__.py` | `__version__ = "{new_version}"` |
 | `README.md` | Badge updated (stable only) |
 | `CHANGELOG.md` | New version header |