@pennyfarthing/core 8.1.0 → 9.0.0

package/README.md

@@ -1,6 +1,6 @@
 # Pennyfarthing
 
-**v7.9.2** | *The outer loop goes once, the inner loop goes many times.*
+**v8.1.0** | *The outer loop goes once, the inner loop goes many times.*
 
 <img src="pennyfarthing.png" alt="Pennyfarthing Logo" width="75" style="float:left; margin:10px">
 
@@ -62,7 +62,7 @@ npx pennyfarthing init
 npx pennyfarthing doctor
 
 # Start working (in Claude Code)
-/work
+/new-work
 ```
 
 ### Optional: Visual Terminal
@@ -88,7 +88,7 @@ BikeLane is the umbrella workflow system supporting three types:
 ### Example: TDD Workflow (Phased)
 
 ```
-/work → SM → TEA → Dev → Reviewer → SM (finish)
+/new-work → SM → TEA → Dev → Reviewer → SM (finish)
          │     │     │       │
       setup  tests  impl   review
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennyfarthing/core",
-  "version": "8.1.0",
+  "version": "9.0.0",
   "description": "Claude Code agent framework with TDD workflow and persona system",
   "type": "module",
   "bin": {
@@ -30,8 +30,8 @@
     "url": "https://github.com/1898andCo/pennyfarthing/issues"
   },
   "scripts": {
-    "build": "pnpm --filter @pennyfarthing/shared build && pnpm --filter @pennyfarthing/core build && pnpm --filter @pennyfarthing/cyclist build && ./scripts/utils/generate-skill-docs.sh",
-    "docs": "./scripts/utils/generate-skill-docs.sh",
+    "build": "pnpm --filter @pennyfarthing/shared build && pnpm --filter @pennyfarthing/core build && pnpm --filter @pennyfarthing/cyclist build && ./scripts/generate-skill-docs.sh",
+    "docs": "./scripts/generate-skill-docs.sh",
     "dev": "pnpm -r --parallel dev",
     "test": "pnpm -r test",
     "lint": "eslint 'packages/*/src/**/*.ts' --max-warnings 0",

package/pennyfarthing-dist/agents/README.md

@@ -284,7 +284,7 @@ When running in Cyclist, background tasks are automatically tracked:
 Use the background task tracking utilities to manage session file entries:
 
 ```bash
-source .pennyfarthing/scripts/utils/background-tasks.sh
+source .pennyfarthing/scripts/lib/background-tasks.sh
 SESSION_FILE=".session/${STORY_ID}-session.md"
 
 # After spawning, record the task:

package/pennyfarthing-dist/agents/dev.md

@@ -153,7 +153,7 @@ Write to session file BEFORE spawning handoff:
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 </exit-sequence>

package/pennyfarthing-dist/agents/handoff.md

@@ -229,7 +229,7 @@ When you receive `HANDOFF_RESULT`:
 **CRITICAL: The calling agent MUST run this as their ABSOLUTE LAST ACTION:**
 
 ```bash
-.pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+.pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
 ```
 
 Then output the script's result verbatim and EXIT. Nothing else after.

package/pennyfarthing-dist/agents/reviewer-preflight.md

@@ -35,7 +35,7 @@ cd "${REPO}" 2>/dev/null || cd "packages/${REPO}" && git fetch origin && git che
 ## 2. Check Test Cache
 
 ```bash
-source scripts/utils/test-cache.sh
+source .pennyfarthing/scripts/test/test-cache.sh
 SESSION_FILE=".session/{STORY_ID}-session.md"
 
 if test_cache_valid "$SESSION_FILE"; then

package/pennyfarthing-dist/agents/sm-setup.md

@@ -135,14 +135,14 @@ GRANTS=$(cat .claude/settings.local.json 2>/dev/null | jq '.permissions.grants /
 
 ## Step 3: Claim in Jira
 
-Use `/jira claim` command:
+Use `/jira check` and `/jira claim` commands:
 
 ```bash
 # Check availability first
-.pennyfarthing/scripts/jira/jira-claim-story.sh {JIRA_KEY}
+/jira check {JIRA_KEY}
 
 # Then claim (assign to self + move to In Progress)
-.pennyfarthing/scripts/jira/jira-claim-story.sh {JIRA_KEY} --claim
+/jira claim {JIRA_KEY}
 ```
 
 **Exit codes:**

package/pennyfarthing-dist/agents/sm.md

@@ -286,7 +286,7 @@ OWNER=$(.pennyfarthing/scripts/workflow/phase-owner.sh {workflow} {phase})
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 

package/pennyfarthing-dist/agents/tea.md

@@ -144,7 +144,7 @@ Write to session file BEFORE spawning handoff:
 3. Await `HANDOFF_RESULT` with `next_agent`
 4. **ABSOLUTE LAST ACTION:**
    ```bash
-   .pennyfarthing/scripts/handoff/handoff-marker.sh {next_agent}
+   .pennyfarthing/scripts/core/handoff-marker.sh {next_agent}
    ```
 5. Output result verbatim and EXIT
 </exit-sequence>

package/pennyfarthing-dist/agents/testing-runner.md

@@ -40,8 +40,8 @@ This runs lint + typecheck + tests. Exit 0 = all passed.
 ## Setup
 
 ```bash
-source .pennyfarthing/scripts/repo-utils.sh
-source .pennyfarthing/scripts/utils/test-setup.sh
+source .pennyfarthing/scripts/misc/repo-utils.sh
+source .pennyfarthing/scripts/test/test-setup.sh
 
 RUN_ID="${RUN_ID:-$(generate_run_id)}"
 ensure_test_containers
@@ -73,7 +73,7 @@ fi
 
 Write cache after running:
 ```bash
-source .pennyfarthing/scripts/utils/test-cache.sh
+source .pennyfarthing/scripts/test/test-cache.sh
 SESSION_FILE=".session/${STORY_ID}-session.md"
 test_cache_write "$SESSION_FILE" "$RESULT" "$PASS" "$FAIL" "$SKIP" "${DURATION}s"
 ```

package/pennyfarthing-dist/commands/architect.md

@@ -3,5 +3,7 @@ description: System Architect - Technical design and architecture
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "architect"
 ```

package/pennyfarthing-dist/commands/continue-session.md

@@ -66,7 +66,7 @@ Source the checkpoint utilities and restore:
 
 ```bash
 # Source checkpoint utilities
-source "${PROJECT_ROOT:-.}/.pennyfarthing/scripts/utils/checkpoint.sh"
+source "${PROJECT_ROOT:-.}/.pennyfarthing/scripts/lib/checkpoint.sh"
 
 # Restore by label
 PHASE=$(checkpoint_restore "phase:${STORY_ID}")
@@ -177,7 +177,7 @@ This command completes the circuit breaker workflow:
 </integration>
 
 <reference>
-- **Checkpoint API:** `scripts/utils/checkpoint.sh`
+- **Checkpoint API:** `.pennyfarthing/scripts/lib/checkpoint.sh`
 - **Circuit Breaker:** `scripts/hooks/context-circuit-breaker.sh`
 - **Related:** `/work`, `/new-work`
 - **Session Files:** `.session/{story-id}-session.md`

package/pennyfarthing-dist/commands/dev.md

@@ -3,5 +3,7 @@ description: Developer - Feature implementation and coding
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "dev"
 ```

package/pennyfarthing-dist/commands/devops.md

@@ -3,5 +3,7 @@ description: DevOps Engineer - Infrastructure and deployment automation
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "devops"
 ```

package/pennyfarthing-dist/commands/health-check.md

@@ -3,6 +3,8 @@ description: Check Pennyfarthing installation health and apply updates
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "devops"
 ```
 

package/pennyfarthing-dist/commands/new-work.md

@@ -0,0 +1,23 @@
+---
+description: Start the next available story from the sprint backlog
+---
+
+# New Work
+
+<purpose>
+Shortcut to start the highest priority available story. Alias for `/sprint work next`.
+</purpose>
+
+<on-invoke>
+Invoke the sprint work command with "next" to auto-select the highest priority story:
+
+```
+/sprint work next
+```
+</on-invoke>
+
+<related>
+- `/sprint work` - Interactive story selection
+- `/sprint backlog` - View available stories
+- `/work` - Resume existing work or start new
+</related>

package/pennyfarthing-dist/commands/orchestrator.md

@@ -3,5 +3,7 @@ description: Orchestrator - Coordinator of all agents and meta operations
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "orchestrator"
 ```

package/pennyfarthing-dist/commands/parallel-work.md

@@ -3,6 +3,8 @@ description: Start parallel work in a new worktree
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```
 
@@ -20,10 +22,10 @@ read -p "Branch name (e.g., feat/5-3a-feature): " BRANCH_NAME
 
 # Create worktree
 WORKTREE_NAME="wt-${STORY_ID}"
-./scripts/git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
+.pennyfarthing/scripts/git/worktree-manager.sh create "$WORKTREE_NAME" "$BRANCH_NAME"
 
 # Get port configuration
-eval $(./scripts/git/worktree-manager.sh ports "$WORKTREE_NAME")
+eval $(.pennyfarthing/scripts/git/worktree-manager.sh ports "$WORKTREE_NAME")
 ```
 
 ### Step 2: Create Session File

package/pennyfarthing-dist/commands/pm.md

@@ -3,5 +3,7 @@ description: Product Manager - Strategic planning and prioritization
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "pm"
 ```

package/pennyfarthing-dist/commands/reviewer.md

@@ -3,5 +3,7 @@ description: Code Reviewer - Critical code review and quality enforcement
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "reviewer"
 ```

package/pennyfarthing-dist/commands/sm.md

@@ -3,5 +3,7 @@ description: Scrum Master - Story coordination and sprint management
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```

package/pennyfarthing-dist/commands/tea.md

@@ -3,5 +3,7 @@ description: Test Engineer/Architect - Test strategy and TDD
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "tea"
 ```

package/pennyfarthing-dist/commands/tech-writer.md

@@ -3,5 +3,7 @@ description: Technical Writer - Documentation creation and maintenance
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "tech-writer"
 ```

package/pennyfarthing-dist/commands/ux-designer.md

@@ -3,5 +3,7 @@ description: UX Designer - User experience design and UI patterns
 ---
 
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "ux-designer"
 ```

package/pennyfarthing-dist/commands/work.md

@@ -7,6 +7,8 @@ description: Resume work or start new - smart entry point that picks up where yo
 <agent-activation>
 **FIRST:** Use Bash tool to run:
 ```bash
+d="$PWD"; while [[ ! -d "$d/.pennyfarthing" ]] && [[ "$d" != "/" ]]; do d="$(dirname "$d")"; done
+export PYTHONPATH="$(dirname "$(dirname "$(cd "$d/.pennyfarthing/scripts" && pwd -P)")"):${PYTHONPATH:-}"
 python3 -m pennyfarthing_scripts.cli agent start "sm"
 ```
 This loads your persona. Adopt the character shown in the output.