@pennyfarthing/core 6.6.1 → 7.0.1

package/README.md

@@ -1,6 +1,6 @@
 # Pennyfarthing
 
-**v6.5.0** | *The outer loop goes once, the inner loop goes many times.*
+**v7.0.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" margin="10px">
 
@@ -30,7 +30,7 @@ Explore all themes with OCEAN spider charts, Chernoff faces, and 1020 character
 cd your-project
 
 # Install CLI (1.1 MB)
-npm install --save-dev pennyfarthing
+npm install --save-dev @pennyfarthing/core
 
 # Initialize (creates symlinks, no file copying)
 npx pennyfarthing init
@@ -147,11 +147,8 @@ After initialization:
 ```
 your-project/
 ├── .claude/
-│   ├── agents/               # → symlink to node_modules/pennyfarthing/pennyfarthing-dist/agents/
-│   ├── commands/             # → symlink to node_modules/pennyfarthing/pennyfarthing-dist/commands/
-│   ├── skills/               # → symlink to node_modules/pennyfarthing/pennyfarthing-dist/skills/
-│   ├── personas/             # → symlink to node_modules/pennyfarthing/pennyfarthing-dist/personas/
-│   ├── scripts/              # → symlink to node_modules/pennyfarthing/pennyfarthing-dist/scripts/
+│   ├── commands/             # → symlinks to @pennyfarthing/core commands
+│   ├── skills/               # → symlinks to @pennyfarthing/core skills
 │   ├── project/              # YOUR customizations
 │   │   ├── agents/*-sidecar/ # Agent memory/learnings
 │   │   ├── docs/             # shared-context.md
@@ -159,6 +156,11 @@ your-project/
 │   ├── manifest.json         # Installation manifest
 │   └── settings.local.json   # Claude Code settings
 ├── .pennyfarthing/
+│   ├── agents/               # → symlink to @pennyfarthing/core agents
+│   ├── guides/               # → symlink to @pennyfarthing/core guides
+│   ├── personas/             # → symlink to @pennyfarthing/core personas
+│   ├── scripts/              # → symlink to @pennyfarthing/core scripts
+│   ├── sidecars/             # Agent learning files
 │   └── config.local.yaml     # Theme selection (gitignored)
 ├── sprint/
 │   ├── current-sprint.yaml   # Active sprint
@@ -229,7 +231,7 @@ Override locally with `.claude/pennyfarthing/preferences.local.yaml` (gitignored
 
 ```bash
 # Update CLI
-npm update pennyfarthing
+npm update @pennyfarthing/core
 
 # Update visual terminal (if installed)
 npm update @pennyfarthing/cyclist
@@ -250,17 +252,23 @@ pennyfarthing uninstall --all
 
 Archived sprint data (`sprint/archive/`, `sprint/context/`) is always preserved.
 
-## What's New in v6.4
+## What's New in v7.0
 
-- **102 Themes** - 11 new themes added since v6.0
-- **20 Skills** - Expanded knowledge domains
-- **43 Commands** - More workflow entry points
-- **Sprint 10** - Customizable workflows and runtime permissions
+- **BREAKING: Package Renamed** - `pennyfarthing` → `@pennyfarthing/core`
+- **BREAKING: Directory Restructure** - Content moved from `.claude/` to `.pennyfarthing/`
+- **Cyclist Split** - Visual terminal is now optional `@pennyfarthing/cyclist` (160MB → 1.1MB core)
+- **Customizable Workflow Engine** - YAML-based workflow definitions with story routing
+- **BMAD Interoperability** - Parse and export BMAD format stories and epics
+- **Runtime Permission Management** - Approval gates, spot grants, `/permissions` skill
+- **Enhanced OTEL** - Tool enrichment for Bash, Read, Edit, Write, Grep/Glob spans
+- **Agent Modernization** - All agents updated with status tags and shared behavior
+
+See [CHANGELOG.md](CHANGELOG.md) for full migration guide.
 
 ## What's New in v6.5
 
 - **Simplified Installation** - Two packages for different needs:
-  - `pennyfarthing` - CLI only (1.1 MB)
+  - `@pennyfarthing/core` - CLI only (1.1 MB)
   - `@pennyfarthing/cyclist` - Optional visual terminal with portraits (160 MB)
 - **Portrait Optimization** - Cyclist bundles only 128px and 256px portraits (saves 450MB)
 - **Agent Modernization** - All agents updated with status tags and consolidated shared behavior

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennyfarthing/core",
-  "version": "6.6.1",
+  "version": "7.0.1",
   "description": "Claude Code agent framework with TDD workflow and persona system",
   "type": "module",
   "bin": {

package/packages/core/dist/cli/utils/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAoC1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAgBtC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAqC1C;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAgBtC"}

package/packages/core/dist/cli/utils/version.js

@@ -25,7 +25,8 @@ export function getPackageVersion() {
     }
     // Fallback to package.json
     const packagePaths = [
-        join(__dirname, '../../../package.json'),
+        join(__dirname, '../../../../../package.json'), // From packages/core/dist/cli/utils/ in npm install
+        join(__dirname, '../../../package.json'), // From dist/cli/utils/ in local dev
         join(__dirname, '../../package.json')
     ];
     for (const packagePath of packagePaths) {

package/packages/core/dist/cli/utils/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,gEAAgE;IAChE,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAG,uBAAuB;QAC7D,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAO,WAAW;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAS,+BAA+B;KACvE,CAAC;IAEF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC;QACxC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC;KACtC,CAAC;IAEF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC1D,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,WAAW,GAAG;QAClB,IAAI,CAAC,SAAS,EAAE,mCAAmC,CAAC,EAAG,qDAAqD;QAC5G,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC;KAC1C,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/cli/utils/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,gEAAgE;IAChE,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,EAAG,uBAAuB;QAC7D,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAO,WAAW;QAClD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAS,+BAA+B;KACvE,CAAC;IAEF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG;QACnB,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,EAAG,oDAAoD;QACrG,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC,EAAS,oCAAoC;QACrF,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC;KACtC,CAAC;IAEF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;gBAC1D,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,WAAW,GAAG;QAClB,IAAI,CAAC,SAAS,EAAE,mCAAmC,CAAC,EAAG,qDAAqD;QAC5G,IAAI,CAAC,SAAS,EAAE,gCAAgC,CAAC;QACjD,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC;QAC9C,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC;KAC1C,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;AAClF,CAAC"}

package/pennyfarthing-dist/guides/shared-context.md

@@ -9,7 +9,7 @@ Loaded automatically by `/prime --agent <name>` on agent activation.
 ## Project Info
 
 **Project:** Pennyfarthing - Claude Code agent orchestration framework
-**Version:** 6.3.0
+**Version:** 7.0.0
 **Type:** ES module with TypeScript (pnpm monorepo)
 **Node:** >=18.0.0
 

package/pennyfarthing-dist/scripts/doctor-dogfood.sh

@@ -119,19 +119,64 @@ echo ""
 echo "Checking symlinks..."
 echo ""
 
-# Check .claude/pennyfarthing symlink
-if [[ -L ".claude/pennyfarthing" ]]; then
-    TARGET=$(readlink ".claude/pennyfarthing")
-    if [[ "$TARGET" == "../pennyfarthing-dist" ]]; then
-        ok ".claude/pennyfarthing -> ../pennyfarthing-dist"
+# Check .pennyfarthing/ symlinks (new structure)
+PENNYFARTHING_SYMLINKS=("agents" "guides" "personas" "scripts")
+for item in "${PENNYFARTHING_SYMLINKS[@]}"; do
+    link_path=".pennyfarthing/$item"
+    expected_target="../pennyfarthing-dist/$item"
+
+    if [[ -L "$link_path" ]]; then
+        actual_target=$(readlink "$link_path")
+        if [[ "$actual_target" == "$expected_target" ]]; then
+            ok ".pennyfarthing/$item -> $expected_target"
+        else
+            warn ".pennyfarthing/$item points to: $actual_target (expected $expected_target)"
+        fi
+    elif [[ -d "$link_path" ]]; then
+        fail ".pennyfarthing/$item is a directory, should be symlink"
+        if $FIX_MODE; then
+            rm -rf "$link_path"
+            ln -s "$expected_target" "$link_path"
+            fix ".pennyfarthing/$item symlink created"
+        fi
     else
-        fail ".claude/pennyfarthing points to wrong target: $TARGET"
+        fail ".pennyfarthing/$item missing"
+        if $FIX_MODE; then
+            mkdir -p .pennyfarthing
+            ln -s "$expected_target" "$link_path"
+            fix ".pennyfarthing/$item symlink created"
+        fi
     fi
-elif [[ -d ".claude/pennyfarthing" ]]; then
-    fail ".claude/pennyfarthing is a directory, should be symlink"
-else
-    fail ".claude/pennyfarthing missing"
-fi
+done
+
+# Check .claude/ symlinks (commands and skills only)
+CLAUDE_SYMLINKS=("commands" "skills")
+for item in "${CLAUDE_SYMLINKS[@]}"; do
+    link_path=".claude/$item"
+    expected_target="../pennyfarthing-dist/$item"
+
+    if [[ -L "$link_path" ]]; then
+        actual_target=$(readlink "$link_path")
+        if [[ "$actual_target" == "$expected_target" ]]; then
+            ok ".claude/$item -> $expected_target"
+        else
+            warn ".claude/$item points to: $actual_target (expected $expected_target)"
+        fi
+    elif [[ -d "$link_path" ]]; then
+        warn ".claude/$item is a directory, should be symlink to pennyfarthing-dist/$item"
+        if $FIX_MODE; then
+            rm -rf "$link_path"
+            ln -s "$expected_target" "$link_path"
+            fix ".claude/$item symlink created"
+        fi
+    else
+        fail ".claude/$item missing"
+        if $FIX_MODE; then
+            ln -s "$expected_target" "$link_path"
+            fix ".claude/$item symlink created"
+        fi
+    fi
+done
 
 # Check scripts directory/symlink
 if [[ -L "scripts" ]]; then
@@ -194,14 +239,15 @@ echo ""
 echo "Checking build..."
 echo ""
 
-# Check if dist/ is up to date
-if [[ -d "dist" ]]; then
+# Check if packages/core/dist/ is up to date (monorepo structure)
+CORE_DIST="packages/core/dist"
+if [[ -d "$CORE_DIST" ]]; then
     # Check if any src file is newer than its dist counterpart
     OUTDATED=false
-    for src_file in src/cli/commands/*.ts; do
+    for src_file in packages/core/src/cli/commands/*.ts; do
         if [[ -f "$src_file" ]]; then
             base=$(basename "$src_file" .ts)
-            dist_file="dist/cli/commands/${base}.js"
+            dist_file="${CORE_DIST}/cli/commands/${base}.js"
             if [[ -f "$dist_file" ]]; then
                 if [[ "$src_file" -nt "$dist_file" ]]; then
                     OUTDATED=true
@@ -212,19 +258,19 @@ if [[ -d "dist" ]]; then
     done
 
     if $OUTDATED; then
-        warn "dist/ may be outdated (run: npm run build)"
+        warn "packages/core/dist/ may be outdated (run: npm run build)"
         if $FIX_MODE; then
             npm run build >/dev/null 2>&1
-            fix "Rebuilt dist/"
+            fix "Rebuilt packages"
         fi
     else
-        ok "dist/ appears up to date"
+        ok "packages/core/dist/ appears up to date"
     fi
 else
-    fail "dist/ directory missing"
+    fail "packages/core/dist/ missing"
     if $FIX_MODE; then
         npm run build >/dev/null 2>&1
-        fix "Built dist/"
+        fix "Built packages"
     fi
 fi
 
@@ -260,30 +306,19 @@ echo ""
 echo "Checking file locations..."
 echo ""
 
-# Check for files that should be in pennyfarthing-dist but aren't
-# Only check directories that are NOT symlinks (symlink dirs are fine)
-MISPLACED=0
-
-# .claude/agents should be a symlink, not a real directory with files
-if [[ -d ".claude/agents" ]] && [[ ! -L ".claude/agents" ]]; then
-    warn ".pennyfarthing/agents/ is a directory, should be symlink to pennyfarthing/agents"
-    ((MISPLACED++))
-fi
-
-# .claude/commands should be a symlink
-if [[ -d ".claude/commands" ]] && [[ ! -L ".claude/commands" ]]; then
-    warn ".claude/commands/ is a directory, should be symlink to pennyfarthing/commands"
-    ((MISPLACED++))
-fi
-
-# .claude/skills should be a symlink
-if [[ -d ".claude/skills" ]] && [[ ! -L ".claude/skills" ]]; then
-    warn ".claude/skills/ is a directory, should be symlink to pennyfarthing/skills"
-    ((MISPLACED++))
+# Check .pennyfarthing/sidecars exists (user-specific, not symlinked)
+if [[ -d ".pennyfarthing/sidecars" ]]; then
+    SIDECAR_COUNT=$(find .pennyfarthing/sidecars -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+    ok ".pennyfarthing/sidecars/ exists ($SIDECAR_COUNT agent sidecars)"
+else
+    warn ".pennyfarthing/sidecars/ missing (agent learning files)"
 fi
 
-if [[ $MISPLACED -eq 0 ]]; then
-    ok "All .claude/ directories properly symlinked"
+# Check .claude/project exists (project-specific customizations)
+if [[ -d ".claude/project" ]]; then
+    ok ".claude/project/ exists"
+else
+    warn ".claude/project/ missing"
 fi
 
 echo ""