@planu/cli 0.91.0 → 0.92.0

package/dist/engine/estimation-calibrator.js

@@ -0,0 +1,176 @@
+// ---------------------------------------------------------------------------
+// Deviation calculation
+// ---------------------------------------------------------------------------
+/**
+ * Compute deviation percentage: positive = over estimate, negative = under estimate.
+ * Returns 0 when estimatedHours is 0 to avoid division by zero.
+ */
+export function computeDeviationPct(estimatedHours, actualHours) {
+    if (estimatedHours === 0) {
+        return 0;
+    }
+    return ((actualHours - estimatedHours) / estimatedHours) * 100;
+}
+// ---------------------------------------------------------------------------
+// Median helper
+// ---------------------------------------------------------------------------
+function median(values) {
+    if (values.length === 0) {
+        return 0;
+    }
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 0) {
+        const lo = sorted.at(mid - 1) ?? 0;
+        const hi = sorted.at(mid) ?? 0;
+        return (lo + hi) / 2;
+    }
+    return sorted.at(mid) ?? 0;
+}
+// ---------------------------------------------------------------------------
+// Scope breakdown
+// ---------------------------------------------------------------------------
+function buildScopeBreakdown(records) {
+    const grouped = new Map();
+    for (const r of records) {
+        const existing = grouped.get(r.specScope) ?? [];
+        existing.push(r.deviationPct);
+        grouped.set(r.specScope, existing);
+    }
+    const result = [];
+    for (const [scope, deviations] of grouped) {
+        const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+        // If consistently over by more than 20%, suggest increasing multiplier
+        const suggestedMultiplier = avg > 20 ? 1 + avg / 100 : 1;
+        result.push({
+            scope,
+            count: deviations.length,
+            avgDeviationPct: Math.round(avg * 10) / 10,
+            suggestedMultiplier: Math.round(suggestedMultiplier * 100) / 100,
+        });
+    }
+    return result.sort((a, b) => a.scope.localeCompare(b.scope));
+}
+// ---------------------------------------------------------------------------
+// Type breakdown
+// ---------------------------------------------------------------------------
+function buildTypeBreakdown(records) {
+    const grouped = new Map();
+    for (const r of records) {
+        const existing = grouped.get(r.specType) ?? [];
+        existing.push(r.deviationPct);
+        grouped.set(r.specType, existing);
+    }
+    const result = [];
+    for (const [type, deviations] of grouped) {
+        const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+        result.push({
+            type,
+            count: deviations.length,
+            avgDeviationPct: Math.round(avg * 10) / 10,
+        });
+    }
+    return result.sort((a, b) => a.type.localeCompare(b.type));
+}
+// ---------------------------------------------------------------------------
+// Report generation
+// ---------------------------------------------------------------------------
+export function generateAccuracyReport(projectId, records) {
+    const deviations = records.map((r) => r.deviationPct);
+    const avgDeviationPct = records.length > 0 ? deviations.reduce((s, v) => s + v, 0) / records.length : 0;
+    const outliers = records
+        .filter((r) => Math.abs(r.deviationPct) > 50)
+        .map((r) => ({ specId: r.specId, deviationPct: r.deviationPct }));
+    const chronological = [...records].sort((a, b) => a.recordedAt.localeCompare(b.recordedAt));
+    const trend = chronological.map((r) => ({
+        specId: r.specId,
+        recordedAt: r.recordedAt,
+        deviationPct: r.deviationPct,
+    }));
+    return {
+        projectId,
+        generatedAt: new Date().toISOString(),
+        totalRecords: records.length,
+        perSpec: chronological,
+        aggregate: {
+            avgDeviationPct: Math.round(avgDeviationPct * 10) / 10,
+            medianDeviationPct: Math.round(median(deviations) * 10) / 10,
+            outlierCount: outliers.length,
+            outliers,
+        },
+        byScope: buildScopeBreakdown(records),
+        byType: buildTypeBreakdown(records),
+        trend,
+    };
+}
+// ---------------------------------------------------------------------------
+// Calibration factor computation
+// ---------------------------------------------------------------------------
+/**
+ * Compute calibration factors from historical actuals.
+ * Only creates a multiplier when sample size >= minSamples.
+ * A positive avg deviation means we historically underestimate → multiplier > 1.
+ */
+export function computeCalibrationFactors(projectId, records, minSamples) {
+    const scopeGroups = new Map();
+    const typeGroups = new Map();
+    for (const r of records) {
+        const scopeList = scopeGroups.get(r.specScope) ?? [];
+        scopeList.push(r.deviationPct);
+        scopeGroups.set(r.specScope, scopeList);
+        const typeList = typeGroups.get(r.specType) ?? [];
+        typeList.push(r.deviationPct);
+        typeGroups.set(r.specType, typeList);
+    }
+    const scopeMultipliers = {};
+    const typeMultipliers = {};
+    const sampleSize = {};
+    for (const [scope, deviations] of scopeGroups) {
+        sampleSize[`scope:${scope}`] = deviations.length;
+        if (deviations.length >= minSamples) {
+            const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+            if (Math.abs(avg) > 20) {
+                scopeMultipliers[scope] = Math.round((1 + avg / 100) * 100) / 100;
+            }
+        }
+    }
+    for (const [type, deviations] of typeGroups) {
+        sampleSize[`type:${type}`] = deviations.length;
+        if (deviations.length >= minSamples) {
+            const avg = deviations.reduce((s, v) => s + v, 0) / deviations.length;
+            if (Math.abs(avg) > 20) {
+                typeMultipliers[type] = Math.round((1 + avg / 100) * 100) / 100;
+            }
+        }
+    }
+    return {
+        projectId,
+        updatedAt: new Date().toISOString(),
+        scopeMultipliers,
+        typeMultipliers,
+        sampleSize,
+    };
+}
+// ---------------------------------------------------------------------------
+// Apply calibration to an estimation
+// ---------------------------------------------------------------------------
+/**
+ * Apply stored calibration factors to a base estimation hours value.
+ * Returns the adjusted hours (or the original if no factor found).
+ */
+export function applyCalibration(baseHours, scope, type, factors) {
+    if (!factors) {
+        return baseHours;
+    }
+    let adjusted = baseHours;
+    const scopeFactor = factors.scopeMultipliers[scope];
+    if (scopeFactor !== undefined) {
+        adjusted *= scopeFactor;
+    }
+    const typeFactor = factors.typeMultipliers[type];
+    if (typeFactor !== undefined) {
+        adjusted *= typeFactor;
+    }
+    return Math.round(adjusted * 10) / 10;
+}
+//# sourceMappingURL=estimation-calibrator.js.map

package/dist/engine/estimation-calibrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimation-calibrator.js","sourceRoot":"","sources":["../../src/engine/estimation-calibrator.ts"],"names":[],"mappings":"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"}

package/dist/engine/hooks/custom-commands-generator.d.ts

@@ -0,0 +1,11 @@
+import type { CustomCommand } from '../../types/hooks-advanced.js';
+/**
+ * Returns the four standard Planu slash commands for .claude/commands/.
+ */
+export declare function generateCustomCommands(projectPath: string): CustomCommand[];
+/**
+ * Writes command markdown files to <projectPath>/.claude/commands/.
+ * Creates the directory if it does not exist. Idempotent.
+ */
+export declare function writeCustomCommands(projectPath: string): void;
+//# sourceMappingURL=custom-commands-generator.d.ts.map

package/dist/engine/hooks/custom-commands-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/custom-commands-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAoEnE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CAO3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAS7D"}

package/dist/engine/hooks/custom-commands-generator.js

@@ -0,0 +1,88 @@
+// engine/hooks/custom-commands-generator.ts — .claude/commands/ generator (SPEC-265)
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Command content builders
+// ---------------------------------------------------------------------------
+function buildSpecCommand(projectPath) {
+    return {
+        name: 'spec',
+        description: 'Create a Planu spec for the described feature',
+        content: `---
+description: Create a Planu spec for the described feature
+---
+Use the mcp__planu__create_spec tool with projectPath: ${projectPath}
+and the user's description as the description parameter.
+Always wait for user approval before implementing.
+`,
+    };
+}
+function buildValidateCommand() {
+    return {
+        name: 'validate',
+        description: 'Validate the active Planu spec',
+        content: `---
+description: Validate the active Planu spec
+---
+Use the mcp__planu__validate tool with the current project path.
+Report any compliance gaps found.
+`,
+    };
+}
+function buildStatusCommand() {
+    return {
+        name: 'status',
+        description: 'Show Planu project status snapshot',
+        content: `---
+description: Show Planu project status snapshot
+---
+Use the mcp__planu__planu_status tool with the current project path.
+Show the active spec, git state, and pending queue in a concise summary.
+`,
+    };
+}
+function buildPlanuCommand() {
+    return {
+        name: 'planu',
+        description: 'Quick reference for the Planu SDD workflow',
+        content: `---
+description: Quick reference for the Planu SDD workflow
+---
+Explain the Spec Driven Development workflow:
+1. /spec <description> — create a spec and get approval
+2. Implement only after approval
+3. /validate — check implementation against spec
+4. /status — see what is active and pending
+
+Always use mcp__planu__* tools. Never write code without an approved spec.
+`,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the four standard Planu slash commands for .claude/commands/.
+ */
+export function generateCustomCommands(projectPath) {
+    return [
+        buildSpecCommand(projectPath),
+        buildValidateCommand(),
+        buildStatusCommand(),
+        buildPlanuCommand(),
+    ];
+}
+/**
+ * Writes command markdown files to <projectPath>/.claude/commands/.
+ * Creates the directory if it does not exist. Idempotent.
+ */
+export function writeCustomCommands(projectPath) {
+    const commandsDir = join(projectPath, '.claude', 'commands');
+    mkdirSync(commandsDir, { recursive: true });
+    const commands = generateCustomCommands(projectPath);
+    for (const cmd of commands) {
+        const filePath = join(commandsDir, `${cmd.name}.md`);
+        writeFileSync(filePath, cmd.content, 'utf8');
+    }
+}
+//# sourceMappingURL=custom-commands-generator.js.map

package/dist/engine/hooks/custom-commands-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-commands-generator.js","sourceRoot":"","sources":["../../../src/engine/hooks/custom-commands-generator.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+CAA+C;QAC5D,OAAO,EAAE;;;yDAG4C,WAAW;;;CAGnE;KACE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE;;;;;CAKZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE;;;;;CAKZ;KACE,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,4CAA4C;QACzD,OAAO,EAAE;;;;;;;;;;CAUZ;KACE,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO;QACL,gBAAgB,CAAC,WAAW,CAAC;QAC7B,oBAAoB,EAAE;QACtB,kBAAkB,EAAE;QACpB,iBAAiB,EAAE;KACpB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC7D,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;QACrD,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/engine/hooks/effort-configurator.d.ts

@@ -0,0 +1,13 @@
+import type { EffortLevel, EffortRule } from '../../types/hooks-advanced.js';
+export declare const DEFAULT_EFFORT_RULES: EffortRule[];
+/**
+ * Returns the effort level for a given tool name by matching against rules.
+ * Uses the first matching rule. Falls back to 'medium' if no rule matches.
+ */
+export declare function getEffortForTool(toolName: string, rules?: EffortRule[]): EffortLevel;
+/**
+ * Builds a Record<toolNamePattern, EffortLevel> suitable for Claude Code settings.json.
+ * Keys are the raw pattern strings from the rules.
+ */
+export declare function buildEffortConfig(rules?: EffortRule[]): Record<string, EffortLevel>;
+//# sourceMappingURL=effort-configurator.d.ts.map

package/dist/engine/hooks/effort-configurator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-configurator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/effort-configurator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAM7E,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAqB5C,CAAC;AAMF;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,UAAU,EAAyB,GACzC,WAAW,CAQb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,GAAE,UAAU,EAAyB,GACzC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B"}

package/dist/engine/hooks/effort-configurator.js

@@ -0,0 +1,54 @@
+// engine/hooks/effort-configurator.ts — Effort level configuration for Claude Code tools (SPEC-265)
+// ---------------------------------------------------------------------------
+// Default rules
+// ---------------------------------------------------------------------------
+export const DEFAULT_EFFORT_RULES = [
+    {
+        pattern: 'list_specs|usage_stats|license_status',
+        effort: 'low',
+        reason: 'read-only queries',
+    },
+    {
+        pattern: 'create_spec|update_status|validate',
+        effort: 'medium',
+        reason: 'standard operations',
+    },
+    {
+        pattern: 'challenge_spec|red_team|check_readiness',
+        effort: 'high',
+        reason: 'analysis tasks',
+    },
+    {
+        pattern: 'init_project|init_constitution|config_health',
+        effort: 'max',
+        reason: 'architectural decisions',
+    },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Returns the effort level for a given tool name by matching against rules.
+ * Uses the first matching rule. Falls back to 'medium' if no rule matches.
+ */
+export function getEffortForTool(toolName, rules = DEFAULT_EFFORT_RULES) {
+    for (const rule of rules) {
+        const regex = new RegExp(rule.pattern);
+        if (regex.test(toolName)) {
+            return rule.effort;
+        }
+    }
+    return 'medium';
+}
+/**
+ * Builds a Record<toolNamePattern, EffortLevel> suitable for Claude Code settings.json.
+ * Keys are the raw pattern strings from the rules.
+ */
+export function buildEffortConfig(rules = DEFAULT_EFFORT_RULES) {
+    const config = {};
+    for (const rule of rules) {
+        config[rule.pattern] = rule.effort;
+    }
+    return config;
+}
+//# sourceMappingURL=effort-configurator.js.map

package/dist/engine/hooks/effort-configurator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-configurator.js","sourceRoot":"","sources":["../../../src/engine/hooks/effort-configurator.ts"],"names":[],"mappings":"AAAA,oGAAoG;AAIpG,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAiB;IAChD;QACE,OAAO,EAAE,uCAAuC;QAChD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,mBAAmB;KAC5B;IACD;QACE,OAAO,EAAE,oCAAoC;QAC7C,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,qBAAqB;KAC9B;IACD;QACE,OAAO,EAAE,yCAAyC;QAClD,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,gBAAgB;KACzB;IACD;QACE,OAAO,EAAE,8CAA8C;QACvD,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,yBAAyB;KAClC;CACF,CAAC;AAEF,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,QAAsB,oBAAoB;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,oBAAoB;IAE1C,MAAM,MAAM,GAAgC,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/hooks/full-spectrum-generator.d.ts

@@ -0,0 +1,31 @@
+import type { FullSpectrumHookConfig, HookScript } from '../../types/hooks-advanced.js';
+/**
+ * Generates the Stop hook script — auto-commits planu/ on session end.
+ */
+export declare function generateStopHookScript(projectPath: string): string;
+/**
+ * Generates the PreCompact hook script — queues a session_checkpoint action.
+ */
+export declare function generatePreCompactHookScript(): string;
+/**
+ * Generates the UserPromptSubmit hook script — injects active spec context.
+ */
+export declare function generateUserPromptSubmitHookScript(): string;
+/**
+ * Generates the Notification hook script — shown when Claude is idle.
+ */
+export declare function generateNotificationHookScript(): string;
+/**
+ * Generates WorktreeCreate and WorktreeRemove hook scripts.
+ */
+export declare function generateWorktreeHookScripts(): {
+    create: string;
+    remove: string;
+};
+/**
+ * Generates all requested hook scripts based on the supplied config.
+ * Returns an array of HookScript objects, one per enabled hook type.
+ * The projectPath is used only for the Stop hook script.
+ */
+export declare function generateFullSpectrumHooks(config: FullSpectrumHookConfig, projectPath?: string): HookScript[];
+//# sourceMappingURL=full-spectrum-generator.d.ts.map

package/dist/engine/hooks/full-spectrum-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-spectrum-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/full-spectrum-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAMxF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAKrD;AAED;;GAEG;AACH,wBAAgB,kCAAkC,IAAI,MAAM,CAS3D;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAMvD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAYhF;AAMD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,WAAW,SAAyB,GACnC,UAAU,EAAE,CAkDd"}

package/dist/engine/hooks/full-spectrum-generator.js

@@ -0,0 +1,115 @@
+// engine/hooks/full-spectrum-generator.ts — Full-spectrum Claude Code hook generator (SPEC-265)
+// ---------------------------------------------------------------------------
+// Individual script builders
+// ---------------------------------------------------------------------------
+/**
+ * Generates the Stop hook script — auto-commits planu/ on session end.
+ */
+export function generateStopHookScript(projectPath) {
+    return `#!/bin/bash
+# Auto-commit planu/ if there are changes (Planu Stop hook)
+cd "${projectPath}"
+if git diff --quiet planu/ 2>/dev/null; then exit 0; fi
+git add planu/ && git commit -m "chore(planu): auto-commit session state [skip ci]" --no-verify
+`;
+}
+/**
+ * Generates the PreCompact hook script — queues a session_checkpoint action.
+ */
+export function generatePreCompactHookScript() {
+    return `#!/bin/bash
+# Queue session_checkpoint before context compression (Planu PreCompact hook)
+echo '{"tool":"session_checkpoint","note":"auto-checkpoint before context compression"}' >> /tmp/planu-pending-actions.json
+`;
+}
+/**
+ * Generates the UserPromptSubmit hook script — injects active spec context.
+ */
+export function generateUserPromptSubmitHookScript() {
+    return `#!/bin/bash
+# Inject active spec context on each prompt (Planu UserPromptSubmit hook)
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+SPEC_ID=$(echo "$BRANCH" | grep -oE 'SPEC-[0-9]+' | head -1)
+if [ -n "$SPEC_ID" ]; then
+  echo "## Active spec: $SPEC_ID | Branch: $BRANCH"
+fi
+`;
+}
+/**
+ * Generates the Notification hook script — shown when Claude is idle.
+ */
+export function generateNotificationHookScript() {
+    return `#!/bin/bash
+# Show pending approved specs when Claude is idle (Planu Notification hook)
+# Non-blocking: only outputs if there are pending specs
+true
+`;
+}
+/**
+ * Generates WorktreeCreate and WorktreeRemove hook scripts.
+ */
+export function generateWorktreeHookScripts() {
+    const create = `#!/bin/bash
+# Log worktree creation in shared-context (Planu WorktreeCreate hook)
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Worktree created: $CLAUDE_WORKTREE_PATH" >> .claude/shared-context.md 2>/dev/null || true
+`;
+    const remove = `#!/bin/bash
+# Log worktree removal in shared-context (Planu WorktreeRemove hook)
+echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] Worktree removed: $CLAUDE_WORKTREE_PATH" >> .claude/shared-context.md 2>/dev/null || true
+`;
+    return { create, remove };
+}
+// ---------------------------------------------------------------------------
+// Public aggregator
+// ---------------------------------------------------------------------------
+/**
+ * Generates all requested hook scripts based on the supplied config.
+ * Returns an array of HookScript objects, one per enabled hook type.
+ * The projectPath is used only for the Stop hook script.
+ */
+export function generateFullSpectrumHooks(config, projectPath = '$CLAUDE_PROJECT_PATH') {
+    const scripts = [];
+    if (config.stopHook) {
+        scripts.push({
+            eventType: 'Stop',
+            scriptContent: generateStopHookScript(projectPath),
+            description: 'Auto-commits planu/ changes at session end.',
+        });
+    }
+    if (config.preCompactHook) {
+        scripts.push({
+            eventType: 'PreCompact',
+            scriptContent: generatePreCompactHookScript(),
+            description: 'Queues a session_checkpoint before context compression.',
+        });
+    }
+    if (config.userPromptSubmitHook) {
+        scripts.push({
+            eventType: 'UserPromptSubmit',
+            scriptContent: generateUserPromptSubmitHookScript(),
+            description: 'Injects active spec/branch context into each prompt.',
+        });
+    }
+    if (config.notificationHook) {
+        scripts.push({
+            eventType: 'Notification',
+            scriptContent: generateNotificationHookScript(),
+            description: 'Shows pending approved specs when Claude is idle.',
+        });
+    }
+    if (config.worktreeHooks) {
+        const { create, remove } = generateWorktreeHookScripts();
+        scripts.push({
+            eventType: 'WorktreeCreate',
+            scriptContent: create,
+            description: 'Logs worktree creation in .claude/shared-context.md.',
+        });
+        scripts.push({
+            eventType: 'WorktreeRemove',
+            scriptContent: remove,
+            description: 'Logs worktree removal in .claude/shared-context.md.',
+        });
+    }
+    return scripts;
+}
+//# sourceMappingURL=full-spectrum-generator.js.map

package/dist/engine/hooks/full-spectrum-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-spectrum-generator.js","sourceRoot":"","sources":["../../../src/engine/hooks/full-spectrum-generator.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAIhG,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO;;MAEH,WAAW;;;CAGhB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;;;CAGR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;;;;;;;CAOR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B;IAC5C,OAAO;;;;CAIR,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,MAAM,GAAG;;;CAGhB,CAAC;IAEA,MAAM,MAAM,GAAG;;;CAGhB,CAAC;IAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA8B,EAC9B,WAAW,GAAG,sBAAsB;IAEpC,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,MAAM;YACjB,aAAa,EAAE,sBAAsB,CAAC,WAAW,CAAC;YAClD,WAAW,EAAE,6CAA6C;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,YAAY;YACvB,aAAa,EAAE,4BAA4B,EAAE;YAC7C,WAAW,EAAE,yDAAyD;SACvE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,kBAAkB;YAC7B,aAAa,EAAE,kCAAkC,EAAE;YACnD,WAAW,EAAE,sDAAsD;SACpE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,cAAc;YACzB,aAAa,EAAE,8BAA8B,EAAE;YAC/C,WAAW,EAAE,mDAAmD;SACjE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,2BAA2B,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,gBAAgB;YAC3B,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,sDAAsD;SACpE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,gBAAgB;YAC3B,aAAa,EAAE,MAAM;YACrB,WAAW,EAAE,qDAAqD;SACnE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/engine/hooks/profile-generator.d.ts

@@ -0,0 +1,21 @@
+import type { ClaudeProfile } from '../../types/hooks-advanced.js';
+/**
+ * Generates the "planu-safe" profile:
+ * - Approval on-request for mutations
+ * - Medium effort default
+ * - Allows common read/edit tools; denies destructive git ops without spec
+ */
+export declare function generatePlanuSafeProfile(): ClaudeProfile;
+/**
+ * Generates the "planu-fast" profile:
+ * - Auto-approve all Planu tools and read ops
+ * - Low effort for reads, medium for writes
+ * - Allows all Planu tools without interruption
+ */
+export declare function generatePlanuFastProfile(): ClaudeProfile;
+/**
+ * Reads .claude/settings.json at settingsPath, merges profiles into it,
+ * and writes it back. Idempotent: profiles with the same name are replaced.
+ */
+export declare function mergeProfilesIntoSettings(settingsPath: string, profiles: ClaudeProfile[]): void;
+//# sourceMappingURL=profile-generator.d.ts.map

package/dist/engine/hooks/profile-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/profile-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAMnE;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,CAwBxD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,aAAa,CAYxD;AAMD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,IAAI,CA4B/F"}

package/dist/engine/hooks/profile-generator.js

@@ -0,0 +1,90 @@
+// engine/hooks/profile-generator.ts — Claude Code profile generator (SPEC-265)
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Profile builders
+// ---------------------------------------------------------------------------
+/**
+ * Generates the "planu-safe" profile:
+ * - Approval on-request for mutations
+ * - Medium effort default
+ * - Allows common read/edit tools; denies destructive git ops without spec
+ */
+export function generatePlanuSafeProfile() {
+    return {
+        name: 'planu-safe',
+        permissions: {
+            allow: [
+                'mcp__planu__*',
+                'Read',
+                'Glob',
+                'Grep',
+                'Edit',
+                'Write',
+                'Bash(git status:*)',
+                'Bash(git log:*)',
+                'Bash(git diff:*)',
+                'Bash(pnpm typecheck:*)',
+                'Bash(pnpm lint:*)',
+                'Bash(pnpm test:*)',
+            ],
+            deny: ['Bash(git push --force:*)', 'Bash(git reset --hard:*)', 'Bash(git clean -f:*)'],
+        },
+        env: {
+            PLANU_EFFORT_DEFAULT: 'medium',
+        },
+    };
+}
+/**
+ * Generates the "planu-fast" profile:
+ * - Auto-approve all Planu tools and read ops
+ * - Low effort for reads, medium for writes
+ * - Allows all Planu tools without interruption
+ */
+export function generatePlanuFastProfile() {
+    return {
+        name: 'planu-fast',
+        permissions: {
+            allow: ['mcp__planu__*', 'Read', 'Glob', 'Grep', 'Edit', 'Write', 'Bash(*)'],
+            deny: [],
+        },
+        env: {
+            PLANU_EFFORT_DEFAULT: 'low',
+            PLANU_AUTO_APPROVE: '1',
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Settings merge
+// ---------------------------------------------------------------------------
+/**
+ * Reads .claude/settings.json at settingsPath, merges profiles into it,
+ * and writes it back. Idempotent: profiles with the same name are replaced.
+ */
+export function mergeProfilesIntoSettings(settingsPath, profiles) {
+    let settings = {};
+    /* v8 ignore start */
+    if (existsSync(settingsPath)) {
+        try {
+            const raw = readFileSync(settingsPath, 'utf8');
+            settings = JSON.parse(raw);
+        }
+        catch {
+            settings = {};
+        }
+    }
+    /* v8 ignore stop */
+    const existing = (settings.profiles ?? []);
+    const merged = [...existing];
+    for (const profile of profiles) {
+        const idx = merged.findIndex((p) => p.name === profile.name);
+        if (idx >= 0) {
+            merged[idx] = profile;
+        }
+        else {
+            merged.push(profile);
+        }
+    }
+    settings.profiles = merged;
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+}
+//# sourceMappingURL=profile-generator.js.map

package/dist/engine/hooks/profile-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-generator.js","sourceRoot":"","sources":["../../../src/engine/hooks/profile-generator.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAIlE,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;YACX,KAAK,EAAE;gBACL,eAAe;gBACf,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,oBAAoB;gBACpB,iBAAiB;gBACjB,kBAAkB;gBAClB,wBAAwB;gBACxB,mBAAmB;gBACnB,mBAAmB;aACpB;YACD,IAAI,EAAE,CAAC,0BAA0B,EAAE,0BAA0B,EAAE,sBAAsB,CAAC;SACvF;QACD,GAAG,EAAE;YACH,oBAAoB,EAAE,QAAQ;SAC/B;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC;YAC5E,IAAI,EAAE,EAAE;SACT;QACD,GAAG,EAAE;YACH,oBAAoB,EAAE,KAAK;YAC3B,kBAAkB,EAAE,GAAG;SACxB;KACF,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,YAAoB,EAAE,QAAyB;IACvF,IAAI,QAAQ,GAA4B,EAAE,CAAC;IAE3C,qBAAqB;IACrB,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC/C,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IACD,oBAAoB;IAEpB,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAoB,CAAC;IAC9D,MAAM,MAAM,GAAoB,CAAC,GAAG,QAAQ,CAAC,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC;IAC3B,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC"}