@pennyfarthing/core 11.2.2 → 11.3.2

package/README.md

@@ -1,6 +1,6 @@
 # Pennyfarthing
 
-**v11.2.2** | *The outer loop goes once, the inner loop goes many times.*
+**v11.3.2** | *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">
 
@@ -15,9 +15,9 @@ A Claude Code agent orchestration framework built around three pillars: a flexib
 A multi-agent system with customizable BikeLane workflows for structured software development:
 
 - **11 Coordinated Agents** - SM, TEA, Dev, Reviewer, Architect, PM, Tech Writer, UX Designer, DevOps, Orchestrator, BA
-- **12 BikeLane Workflows** - Phased (TDD, BDD, Trivial, 2pTDD, TDD-Tandem, BDD-Tandem, Review-Tandem, Patch, Agent-Docs), Stepped (Architecture, Release, Git Cleanup)
+- **14 BikeLane Workflows** - Phased (TDD, BDD, Trivial, 2pTDD, TDD-Tandem, BDD-Tandem, TDD-Team, BDD-Team, Review-Tandem, Patch, Agent-Docs), Stepped (Architecture, Release, Git Cleanup)
 - **60 Slash Commands** - Entry points for agent activation and workflows
-- **22 Skills** - Reusable knowledge domains (testing, code-review, jira, mermaid, etc.)
+- **23 Skills** - Reusable knowledge domains (testing, code-review, jira, settings, mermaid, etc.)
 - **Prime Context System** - Tiered context injection assembles agent definition, persona, session state, and sidecar memory
 - **Automatic Handoffs** - Context-aware agent transitions via subagent delegation
 - **Agent Sidecars** - Persistent learning files where agents record patterns, gotchas, and decisions across stories

package/package.json

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

package/packages/core/dist/cli/commands/doctor-legacy.test.js

@@ -196,9 +196,9 @@ describe('MSSCI-12346: Legacy Install Cleanup', () => {
             assert.ok(result.fix, 'Should have fix function');
             // Execute the fix
             result.fix();
-            // Verify the path was updated
+            // Verify the path was updated (fix now writes pf.sh hooks statusline)
             const updatedSettings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
-            assert.ok(updatedSettings.statusLine.command.includes('.pennyfarthing/scripts/misc/statusline.sh'), 'Should update to proper path');
+            assert.ok(updatedSettings.statusLine.command.includes('.pennyfarthing/scripts/core/pf.sh hooks statusline'), 'Should update to pf.sh hooks statusline path');
             assert.strictEqual(updatedSettings.otherSetting, 'preserved', 'Should preserve other settings');
         });
         it('should detect multiple legacy statusline paths', () => {

package/packages/core/dist/cli/commands/doctor-legacy.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-legacy.test.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor-legacy.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"doctor-legacy.test.js","sourceRoot":"","sources":["../../../src/cli/commands/doctor-legacy.test.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/cli/commands/doctor.d.ts

@@ -1,9 +1,17 @@
+import { readManifest } from '../utils/manifest.js';
 interface DoctorOptions {
     fix?: boolean;
     json?: boolean;
     quiet?: boolean;
     dogfood?: boolean;
+    category?: string;
+    listCategories?: boolean;
 }
+/**
+ * Category-to-check-function mapping for --category filtering.
+ * Each category maps to the check functions that produce results in that group.
+ */
+export declare const CATEGORY_CHECKS: Record<string, string[]>;
 export interface CheckResult {
     name: string;
     status: 'pass' | 'warn' | 'fail';
@@ -11,6 +19,55 @@ export interface CheckResult {
     fix?: () => void;
 }
 export declare function doctorCommand(options: DoctorOptions): Promise<void>;
+export declare function checkInstallation(projectRoot: string, manifest: ReturnType<typeof readManifest>): CheckResult[];
+export declare function checkCoreFiles(projectRoot: string, manifest: ReturnType<typeof readManifest>): CheckResult[];
+/**
+ * Check commands and skills are properly copied (not symlinked) and up to date.
+ * Commands and skills are file copies since v11.3.0 to avoid node_modules drift.
+ */
+export declare function checkCommandsAndSkills(projectRoot: string, _nodeModulesPath: string | null): CheckResult[];
+/**
+ * Check basic user files only (project dir, sidecars, persona config, settings.local.json existence).
+ * Does NOT include the settings hook checks — use checkSettingsHooks() for those.
+ * Used by --category commands to separate user file checks from hook configuration checks.
+ */
+export declare function checkUserFilesBasic(projectRoot: string): CheckResult[];
+/**
+ * Check all settings hook configurations in settings.local.json.
+ * Returns results for all 9 hook checks (session-start, otel, auto-load-sm,
+ * stop, post-tool-use, benchmark-permissions, context-circuit-breaker,
+ * schema-validation, sprint-yaml-validation).
+ * Used by --category hooks for targeted hook configuration checking.
+ */
+export declare function checkSettingsHooks(projectRoot: string): CheckResult[];
+export declare function checkDirectories(projectRoot: string): CheckResult[];
+export declare function checkHooks(projectRoot: string): CheckResult[];
+/**
+ * Check git hooks in .git/hooks/ are up-to-date with package source.
+ *
+ * Supports two installation patterns:
+ *
+ * 1. **Dispatcher pattern** (current): `.git/hooks/{name}` is a generic dispatcher that
+ *    runs scripts from `.git/hooks/{name}.d/`. The dispatcher is generated from
+ *    `dispatcher-template.sh` and the actual hook implementation lives in the `.d/` dir.
+ *
+ * 2. **Direct-copy pattern** (legacy): `.git/hooks/{name}` is a direct copy of `{name}.sh`.
+ *
+ * For framework/orchestrator repos (has pennyfarthing-dist/), checks that hooks are
+ * symlinked rather than copied, since symlinks stay current automatically.
+ * Provides --fix to refresh stale hooks or replace copies with symlinks.
+ */
+export declare function checkGitHooks(projectRoot: string, nodeModulesPath: string | null): CheckResult[];
+/**
+ * Check Cyclist installation health (if installed as a workspace package)
+ * Detects node-pty spawn-helper permission issues that cause posix_spawnp failures
+ */
+export declare function checkCyclist(projectRoot: string): CheckResult[];
+/**
+ * Check if the pf CLI is installed and working.
+ * The pf CLI is required for agent commands (e.g., `pf agent start "dev"`).
+ */
+export declare function checkPfCli(nodeModulesPath: string | null): CheckResult;
 /**
  * Check for legacy files that may shadow or conflict with current Pennyfarthing files.
  * Returns results with fix functions for --fix mode.
@@ -24,6 +81,12 @@ export declare function checkLegacyFiles(projectRoot: string): CheckResult[];
  * Returns result with fix function to update to canonical path if needed.
  */
 export declare function checkLegacyStatuslinePath(projectRoot: string): CheckResult;
+/**
+ * Check if settings.local.json contains legacy .sh hook commands that should
+ * be migrated to `pf hooks` commands. The .sh scripts still work (they're shims)
+ * but `pf hooks` is the canonical path — faster, no shell indirection.
+ */
+export declare function checkLegacyHookCommands(projectRoot: string): CheckResult;
 /**
  * Check file layout — validate files are at correct .pennyfarthing/ locations.
  * Flags old .claude/ locations with migration instructions.

package/packages/core/dist/cli/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAwBA,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA8HzE;AAm+DD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA+JnE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAkF1E;AAqFD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAsIlE"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,YAAY,EACb,MAAM,sBAAsB,CAAC;AAc9B,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAQpD,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsKzE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,WAAW,EAAE,CAW/G;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,GAAG,WAAW,EAAE,CAiE5G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE,CA4I1G;AA0JD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAsDtE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA2BrE;AA8tCD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAkBnE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAuD7D;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EAAE,CA+NhG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA8G/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAoBtE;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CA+JnE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAkF1E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CA4ExE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE,CAsIlE"}

package/packages/core/dist/cli/commands/doctor.js

@@ -12,8 +12,35 @@ import { findNodeModulesPath } from '../utils/node-modules.js';
 import { ALL_SYMLINKS, CORE_AGENTS } from '../utils/constants.js';
 import { getPfVersion, installPfCli } from '../utils/python.js';
 import { LEGACY_HOOK_MIGRATIONS, migrateHookPaths } from '../utils/settings.js';
+/**
+ * Category-to-check-function mapping for --category filtering.
+ * Each category maps to the check functions that produce results in that group.
+ */
+export const CATEGORY_CHECKS = {
+    'installation': ['checkInstallation', 'checkCoreFiles'],
+    'commands': ['checkCommandsAndSkills', 'checkUserFilesBasic'],
+    'hooks': ['checkSettingsHooks'],
+    'scripts': ['checkHooks', 'checkGitHooks'],
+    'layout': ['checkDirectories', 'checkFileLayout'],
+    'legacy': ['checkLegacyFiles', 'checkLegacyStatuslinePath', 'checkLegacyHookCommands'],
+    'tools': ['checkCyclist', 'checkPfCli'],
+};
 export async function doctorCommand(options) {
     const projectRoot = process.cwd();
+    // Handle --list-categories
+    if (options.listCategories) {
+        console.log('Available check categories:');
+        for (const [name, checks] of Object.entries(CATEGORY_CHECKS)) {
+            console.log(`  ${name.padEnd(14)} ${checks.join(', ')}`);
+        }
+        return;
+    }
+    // Validate --category if provided
+    if (options.category && !CATEGORY_CHECKS[options.category]) {
+        logger.error(`Unknown category: ${options.category}`);
+        logger.info(`Available categories: ${Object.keys(CATEGORY_CHECKS).join(', ')}`);
+        process.exit(1);
+    }
     // Handle dogfood mode - run checks for framework/orchestrator development
     if (options.dogfood) {
         const dogfoodScript = join(projectRoot, 'pennyfarthing-dist/scripts/misc/doctor-dogfood.sh');
@@ -45,20 +72,58 @@ export async function doctorCommand(options) {
     logger.newline();
     // Resolve node_modules path for checks that need it
     const nodeModulesPath = findNodeModulesPath(projectRoot);
-    // Run checks
-    results.push(...checkInstallation(projectRoot, manifest));
-    results.push(...checkCoreFiles(projectRoot, manifest));
-    results.push(...checkCommandsAndSkills(projectRoot, nodeModulesPath));
-    results.push(...checkUserFiles(projectRoot));
-    results.push(...checkDirectories(projectRoot));
-    results.push(...checkHooks(projectRoot));
-    results.push(...checkGitHooks(projectRoot, nodeModulesPath));
-    results.push(...checkFileLayout(projectRoot));
-    results.push(...checkLegacyFiles(projectRoot));
-    results.push(checkLegacyStatuslinePath(projectRoot));
-    results.push(checkLegacyHookCommands(projectRoot));
-    results.push(...checkCyclist(projectRoot));
-    results.push(checkPfCli(nodeModulesPath));
+    // Determine which checks to run
+    const activeChecks = options.category
+        ? new Set(CATEGORY_CHECKS[options.category])
+        : null; // null = run all
+    // Run checks — when category is specified, only run matching subset
+    if (activeChecks) {
+        // Category-filtered run
+        if (activeChecks.has('checkInstallation'))
+            results.push(...checkInstallation(projectRoot, manifest));
+        if (activeChecks.has('checkCoreFiles'))
+            results.push(...checkCoreFiles(projectRoot, manifest));
+        if (activeChecks.has('checkCommandsAndSkills'))
+            results.push(...checkCommandsAndSkills(projectRoot, nodeModulesPath));
+        if (activeChecks.has('checkUserFilesBasic'))
+            results.push(...checkUserFilesBasic(projectRoot));
+        if (activeChecks.has('checkSettingsHooks'))
+            results.push(...checkSettingsHooks(projectRoot));
+        if (activeChecks.has('checkDirectories'))
+            results.push(...checkDirectories(projectRoot));
+        if (activeChecks.has('checkHooks'))
+            results.push(...checkHooks(projectRoot));
+        if (activeChecks.has('checkGitHooks'))
+            results.push(...checkGitHooks(projectRoot, nodeModulesPath));
+        if (activeChecks.has('checkFileLayout'))
+            results.push(...checkFileLayout(projectRoot));
+        if (activeChecks.has('checkLegacyFiles'))
+            results.push(...checkLegacyFiles(projectRoot));
+        if (activeChecks.has('checkLegacyStatuslinePath'))
+            results.push(checkLegacyStatuslinePath(projectRoot));
+        if (activeChecks.has('checkLegacyHookCommands'))
+            results.push(checkLegacyHookCommands(projectRoot));
+        if (activeChecks.has('checkCyclist'))
+            results.push(...checkCyclist(projectRoot));
+        if (activeChecks.has('checkPfCli'))
+            results.push(checkPfCli(nodeModulesPath));
+    }
+    else {
+        // Full run — original behavior
+        results.push(...checkInstallation(projectRoot, manifest));
+        results.push(...checkCoreFiles(projectRoot, manifest));
+        results.push(...checkCommandsAndSkills(projectRoot, nodeModulesPath));
+        results.push(...checkUserFiles(projectRoot));
+        results.push(...checkDirectories(projectRoot));
+        results.push(...checkHooks(projectRoot));
+        results.push(...checkGitHooks(projectRoot, nodeModulesPath));
+        results.push(...checkFileLayout(projectRoot));
+        results.push(...checkLegacyFiles(projectRoot));
+        results.push(checkLegacyStatuslinePath(projectRoot));
+        results.push(checkLegacyHookCommands(projectRoot));
+        results.push(...checkCyclist(projectRoot));
+        results.push(checkPfCli(nodeModulesPath));
+    }
     // Output results
     if (options.json) {
         console.log(JSON.stringify(results, null, 2));
@@ -124,7 +189,7 @@ export async function doctorCommand(options) {
         process.exit(1);
     }
 }
-function checkInstallation(projectRoot, manifest) {
+export function checkInstallation(projectRoot, manifest) {
     const results = [];
     // Check manifest exists
     results.push({
@@ -134,7 +199,7 @@ function checkInstallation(projectRoot, manifest) {
     });
     return results;
 }
-function checkCoreFiles(projectRoot, manifest) {
+export function checkCoreFiles(projectRoot, manifest) {
     const results = [];
     const installationType = manifest?.installationType || 'copy';
     const nodeModulesPath = findNodeModulesPath(projectRoot);
@@ -196,7 +261,7 @@ function checkCoreFiles(projectRoot, manifest) {
  * Check commands and skills are properly copied (not symlinked) and up to date.
  * Commands and skills are file copies since v11.3.0 to avoid node_modules drift.
  */
-function checkCommandsAndSkills(projectRoot, _nodeModulesPath) {
+export function checkCommandsAndSkills(projectRoot, _nodeModulesPath) {
     const results = [];
     // Use assetsPath for source resolution (correct pf-* prefix in dogfood)
     let assetsPath = null;
@@ -480,6 +545,91 @@ function checkSymlinks(projectRoot, nodeModulesPath) {
     }
     return results;
 }
+/**
+ * Check basic user files only (project dir, sidecars, persona config, settings.local.json existence).
+ * Does NOT include the settings hook checks — use checkSettingsHooks() for those.
+ * Used by --category commands to separate user file checks from hook configuration checks.
+ */
+export function checkUserFilesBasic(projectRoot) {
+    const results = [];
+    const manifest = readManifest(projectRoot);
+    const installationType = manifest?.installationType || 'copy';
+    // Check project directory
+    const projectDir = join(projectRoot, '.claude/project');
+    results.push({
+        name: 'project/directory',
+        status: pathExists(projectDir) ? 'pass' : 'warn',
+        detail: pathExists(projectDir) ? undefined : 'Run init to create'
+    });
+    // Check agent sidecars (now in .pennyfarthing/sidecars/)
+    const sidecarsDir = join(projectRoot, '.pennyfarthing/sidecars');
+    if (pathExists(sidecarsDir)) {
+        const existingSidecars = CORE_AGENTS.filter(a => pathExists(join(sidecarsDir, a)));
+        results.push({
+            name: 'project/sidecars',
+            status: existingSidecars.length > 0 ? 'pass' : 'warn',
+            detail: `${existingSidecars.length} agent sidecars configured`
+        });
+    }
+    // Check persona config at canonical location
+    const personaConfig = join(projectRoot, '.pennyfarthing/config.local.yaml');
+    results.push({
+        name: 'persona-config',
+        status: pathExists(personaConfig) ? 'pass' : 'warn',
+        detail: pathExists(personaConfig) ? undefined : 'No theme configured'
+    });
+    // Check settings.local.json exists (CRITICAL - registers hooks with Claude Code)
+    const settingsLocal = join(projectRoot, '.claude/settings.local.json');
+    if (!pathExists(settingsLocal)) {
+        results.push({
+            name: 'settings.local.json',
+            status: 'fail',
+            detail: 'Missing - hooks not registered with Claude Code!',
+            fix: () => {
+                createSettingsLocalJson(projectRoot, installationType);
+            }
+        });
+    }
+    else {
+        results.push({
+            name: 'settings.local.json',
+            status: 'pass',
+            detail: undefined
+        });
+    }
+    return results;
+}
+/**
+ * Check all settings hook configurations in settings.local.json.
+ * Returns results for all 9 hook checks (session-start, otel, auto-load-sm,
+ * stop, post-tool-use, benchmark-permissions, context-circuit-breaker,
+ * schema-validation, sprint-yaml-validation).
+ * Used by --category hooks for targeted hook configuration checking.
+ */
+export function checkSettingsHooks(projectRoot) {
+    const results = [];
+    const manifest = readManifest(projectRoot);
+    const installationType = manifest?.installationType || 'copy';
+    const settingsLocal = join(projectRoot, '.claude/settings.local.json');
+    if (!pathExists(settingsLocal)) {
+        results.push({
+            name: 'settings.local.json',
+            status: 'fail',
+            detail: 'Missing - cannot check hook configuration'
+        });
+        return results;
+    }
+    results.push(checkSessionStartHooks(projectRoot, installationType));
+    results.push(checkOtelAutoStart(projectRoot, installationType));
+    results.push(checkAutoLoadSmHook(projectRoot));
+    results.push(checkStopHook(projectRoot, installationType));
+    results.push(checkPostToolUseHook(projectRoot, installationType));
+    results.push(checkBenchmarkPermissions(projectRoot));
+    results.push(checkContextCircuitBreaker(projectRoot, installationType));
+    results.push(checkSchemaValidationHook(projectRoot, installationType));
+    results.push(checkSprintYamlValidationHook(projectRoot, installationType));
+    return results;
+}
 function checkUserFiles(projectRoot) {
     const results = [];
     // Detect installation type from manifest
@@ -1586,7 +1736,7 @@ function createSettingsLocalJson(projectRoot, _installationType) {
     ensureDirSync(join(projectRoot, '.claude'));
     writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
 }
-function checkDirectories(projectRoot) {
+export function checkDirectories(projectRoot) {
     const results = [];
     const dirs = [
         { path: 'sprint', name: 'dir/sprint' },
@@ -1602,7 +1752,7 @@ function checkDirectories(projectRoot) {
     }
     return results;
 }
-function checkHooks(projectRoot) {
+export function checkHooks(projectRoot) {
     const results = [];
     // Detect installation type from manifest
     const manifest = readManifest(projectRoot);
@@ -1652,14 +1802,28 @@ function checkHooks(projectRoot) {
     }
     return results;
 }
+/**
+ * Render the dispatcher template by substituting __HOOK_NAME__ with the actual hook name.
+ */
+function renderDispatcherTemplate(template, hookName) {
+    return template.replace(/__HOOK_NAME__/g, hookName);
+}
 /**
  * Check git hooks in .git/hooks/ are up-to-date with package source.
- * Detects stale copies that were installed by `pennyfarthing init` but never refreshed.
+ *
+ * Supports two installation patterns:
+ *
+ * 1. **Dispatcher pattern** (current): `.git/hooks/{name}` is a generic dispatcher that
+ *    runs scripts from `.git/hooks/{name}.d/`. The dispatcher is generated from
+ *    `dispatcher-template.sh` and the actual hook implementation lives in the `.d/` dir.
+ *
+ * 2. **Direct-copy pattern** (legacy): `.git/hooks/{name}` is a direct copy of `{name}.sh`.
+ *
  * For framework/orchestrator repos (has pennyfarthing-dist/), checks that hooks are
  * symlinked rather than copied, since symlinks stay current automatically.
  * Provides --fix to refresh stale hooks or replace copies with symlinks.
  */
-function checkGitHooks(projectRoot, nodeModulesPath) {
+export function checkGitHooks(projectRoot, nodeModulesPath) {
     const results = [];
     // Use git rev-parse to find the actual git dir (handles worktrees where .git is a file)
     const gitDirResult = spawnSync('git', ['rev-parse', '--git-dir'], { cwd: projectRoot, encoding: 'utf8' });
@@ -1679,17 +1843,23 @@ function checkGitHooks(projectRoot, nodeModulesPath) {
     if (!nodeModulesPath && !frameworkHooksDir) {
         return results;
     }
+    // Resolve the hooks source directory
+    const hooksSourceDir = frameworkHooksDir ?? join(nodeModulesPath, 'scripts/hooks');
+    // Load dispatcher template for comparison (used by dispatcher pattern detection)
+    const dispatcherTemplatePath = join(hooksSourceDir, 'dispatcher-template.sh');
+    const hasDispatcherTemplate = pathExists(dispatcherTemplatePath);
+    const dispatcherTemplate = hasDispatcherTemplate
+        ? readFileSync(dispatcherTemplatePath, 'utf8')
+        : null;
     const hooks = [
         { source: 'pre-commit.sh', dest: 'pre-commit', marker: 'pennyfarthing' },
         { source: 'pre-push.sh', dest: 'pre-push', marker: 'pennyfarthing' },
         { source: 'post-merge.sh', dest: 'post-merge', marker: 'pennyfarthing' },
     ];
     for (const hook of hooks) {
-        // Prefer framework source (pennyfarthing-dist/) over node_modules
-        const sourcePath = frameworkHooksDir
-            ? join(frameworkHooksDir, hook.source)
-            : join(nodeModulesPath, 'scripts/hooks', hook.source);
+        const sourcePath = join(hooksSourceDir, hook.source);
         const destPath = join(gitHooksDir, hook.dest);
+        const dDir = join(gitHooksDir, `${hook.dest}.d`);
         if (!pathExists(sourcePath)) {
             continue;
         }
@@ -1778,23 +1948,90 @@ function checkGitHooks(projectRoot, nodeModulesPath) {
             });
             continue;
         }
-        const sourceContent = readFileSync(sourcePath, 'utf8');
-        if (existingContent === sourceContent) {
-            results.push({
-                name: `git-hook/${hook.dest}`,
-                status: 'pass',
-                detail: undefined
-            });
+        // Detect dispatcher pattern: the installed hook is a dispatcher (from dispatcher-template.sh)
+        // and the actual implementation lives in .git/hooks/{name}.d/
+        const isDispatcherPattern = dispatcherTemplate
+            && existingContent.includes('pennyfarthing-dispatcher')
+            && pathExists(dDir);
+        if (isDispatcherPattern) {
+            // --- Dispatcher pattern: check dispatcher + .d/ scripts separately ---
+            // 1. Check the dispatcher itself against the rendered template
+            const expectedDispatcher = renderDispatcherTemplate(dispatcherTemplate, hook.dest);
+            if (existingContent !== expectedDispatcher) {
+                results.push({
+                    name: `git-hook/${hook.dest}`,
+                    status: 'warn',
+                    detail: 'Stale dispatcher — content differs from template',
+                    fix: () => {
+                        writeFileSync(destPath, expectedDispatcher, { mode: 0o755 });
+                    }
+                });
+            }
+            else {
+                results.push({
+                    name: `git-hook/${hook.dest}`,
+                    status: 'pass',
+                    detail: 'Dispatcher'
+                });
+            }
+            // 2. Check the .d/ script against its source
+            const dScripts = readdirSync(dDir).filter(f => f.includes('pennyfarthing'));
+            if (dScripts.length === 0) {
+                results.push({
+                    name: `git-hook/${hook.dest}.d`,
+                    status: 'warn',
+                    detail: 'No pennyfarthing script in .d/ directory',
+                    fix: () => {
+                        const sourceContent = readFileSync(sourcePath, 'utf8');
+                        const dScriptPath = join(dDir, `10-pennyfarthing-${hook.dest}.sh`);
+                        writeFileSync(dScriptPath, sourceContent, { mode: 0o755 });
+                    }
+                });
+            }
+            else {
+                // Compare the first matching .d/ script against the source
+                const dScriptPath = join(dDir, dScripts[0]);
+                const dScriptContent = readFileSync(dScriptPath, 'utf8');
+                const sourceContent = readFileSync(sourcePath, 'utf8');
+                if (dScriptContent === sourceContent) {
+                    results.push({
+                        name: `git-hook/${hook.dest}.d`,
+                        status: 'pass',
+                        detail: undefined
+                    });
+                }
+                else {
+                    results.push({
+                        name: `git-hook/${hook.dest}.d`,
+                        status: 'warn',
+                        detail: 'Stale — content differs from package',
+                        fix: () => {
+                            writeFileSync(dScriptPath, sourceContent, { mode: 0o755 });
+                        }
+                    });
+                }
+            }
         }
         else {
-            results.push({
-                name: `git-hook/${hook.dest}`,
-                status: 'warn',
-                detail: 'Stale — content differs from package',
-                fix: () => {
-                    writeFileSync(destPath, sourceContent, { mode: 0o755 });
-                }
-            });
+            // --- Legacy direct-copy pattern: compare hook directly against source ---
+            const sourceContent = readFileSync(sourcePath, 'utf8');
+            if (existingContent === sourceContent) {
+                results.push({
+                    name: `git-hook/${hook.dest}`,
+                    status: 'pass',
+                    detail: undefined
+                });
+            }
+            else {
+                results.push({
+                    name: `git-hook/${hook.dest}`,
+                    status: 'warn',
+                    detail: 'Stale — content differs from package',
+                    fix: () => {
+                        writeFileSync(destPath, sourceContent, { mode: 0o755 });
+                    }
+                });
+            }
         }
     }
     return results;
@@ -1803,7 +2040,7 @@ function checkGitHooks(projectRoot, nodeModulesPath) {
  * Check Cyclist installation health (if installed as a workspace package)
  * Detects node-pty spawn-helper permission issues that cause posix_spawnp failures
  */
-function checkCyclist(projectRoot) {
+export function checkCyclist(projectRoot) {
     const results = [];
     // Detect Cyclist package — check common locations
     const cyclistLocations = [
@@ -1905,7 +2142,7 @@ function checkCyclist(projectRoot) {
  * Check if the pf CLI is installed and working.
  * The pf CLI is required for agent commands (e.g., `pf agent start "dev"`).
  */
-function checkPfCli(nodeModulesPath) {
+export function checkPfCli(nodeModulesPath) {
     const version = getPfVersion();
     if (version) {
         return {
@@ -2182,7 +2419,7 @@ export function checkLegacyStatuslinePath(projectRoot) {
  * be migrated to `pf hooks` commands. The .sh scripts still work (they're shims)
  * but `pf hooks` is the canonical path — faster, no shell indirection.
  */
-function checkLegacyHookCommands(projectRoot) {
+export function checkLegacyHookCommands(projectRoot) {
     const settingsPath = join(projectRoot, '.claude/settings.local.json');
     if (!pathExists(settingsPath)) {
         return { name: 'legacy/hook-commands', status: 'pass', detail: 'No settings file' };