@planu/cli 0.90.2 → 0.92.0

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/hook-templates.d.ts

@@ -0,0 +1,16 @@
+import type { HookTemplateName, HookTemplateOptions, GeneratedHookConfig } from '../../types/index.js';
+/**
+ * Generates a Claude Code hook configuration for the given template.
+ * `notification-desktop` auto-detects the current platform via process.platform.
+ */
+export declare function generateHookTemplate(opts: HookTemplateOptions): GeneratedHookConfig;
+/**
+ * Merges a new hook config into an existing settings object without overwriting.
+ * Existing hooks for the same event type are preserved (array merge).
+ */
+export declare function mergeHookConfig(existing: Record<string, unknown>, newHook: GeneratedHookConfig): Record<string, unknown>;
+/**
+ * Returns all valid HookTemplateName values (for use in Zod schemas and descriptions).
+ */
+export declare function listHookTemplateNames(): HookTemplateName[];
+//# sourceMappingURL=hook-templates.d.ts.map

package/dist/engine/hooks/hook-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-templates.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/hook-templates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AAuH9B;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CAsBnF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,mBAAmB,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAS1D"}

package/dist/engine/hooks/hook-templates.js

@@ -0,0 +1,148 @@
+// engine/hooks/hook-templates.ts — Claude Code notification & permission hook templates (SPEC-258)
+// ---------------------------------------------------------------------------
+// Template builders
+// ---------------------------------------------------------------------------
+function buildNotificationEntry(command, matcher) {
+    return {
+        matcher: matcher ?? '',
+        hooks: [{ type: 'command', command }],
+    };
+}
+function buildMacosTemplate(matcher) {
+    return {
+        hooks: {
+            Notification: [
+                buildNotificationEntry('osascript -e \'display notification "Claude needs your attention" with title "Planu"\'', matcher),
+            ],
+        },
+        mergeInstructions: 'Add the "Notification" key to the "hooks" object in .claude/settings.json.',
+        description: 'macOS desktop notification via osascript when Claude requests attention.',
+    };
+}
+function buildLinuxTemplate(matcher) {
+    return {
+        hooks: {
+            Notification: [
+                buildNotificationEntry("notify-send 'Planu' 'Claude needs your attention'", matcher),
+            ],
+        },
+        mergeInstructions: 'Add the "Notification" key to the "hooks" object in .claude/settings.json.',
+        description: 'Linux desktop notification via notify-send when Claude requests attention. Requires libnotify-bin.',
+    };
+}
+function buildWindowsTemplate(matcher) {
+    const command = "powershell.exe -Command \"[System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); " +
+        "[System.Windows.Forms.MessageBox]::Show('Claude needs your attention', 'Planu')\"";
+    return {
+        hooks: {
+            Notification: [buildNotificationEntry(command, matcher)],
+        },
+        mergeInstructions: 'Add the "Notification" key to the "hooks" object in .claude/settings.json.',
+        description: 'Windows desktop notification via PowerShell MessageBox when Claude needs input.',
+    };
+}
+function buildDesktopTemplate(matcher) {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+        return buildMacosTemplate(matcher);
+    }
+    if (platform === 'win32') {
+        return buildWindowsTemplate(matcher);
+    }
+    // Default to Linux for all other platforms (linux, freebsd, etc.)
+    return buildLinuxTemplate(matcher);
+}
+function buildInstructionsLoadedDebugTemplate() {
+    return {
+        hooks: {
+            InstructionsLoaded: [
+                {
+                    matcher: '',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'echo "[CLAUDE $(date +%H:%M:%S)] Instructions loaded: $CLAUDE_INSTRUCTIONS_FILE" >> ~/.claude/instructions-debug.log',
+                        },
+                    ],
+                },
+            ],
+        },
+        mergeInstructions: 'Add the "InstructionsLoaded" key to the "hooks" object in .claude/settings.json.',
+        description: 'Debug hook that appends a timestamped line to ~/.claude/instructions-debug.log every time Claude loads instructions.',
+    };
+}
+function buildPermissionAutoApproveReadonlyTemplate() {
+    return {
+        hooks: {
+            PermissionRequest: [
+                {
+                    matcher: 'Read|Glob|Grep',
+                    hooks: [
+                        {
+                            type: 'command',
+                            command: 'echo \'{"decision": "allow", "reason": "Read-only operation auto-approved by Planu"}\'',
+                        },
+                    ],
+                },
+            ],
+        },
+        mergeInstructions: 'Add the "PermissionRequest" key to the "hooks" object in .claude/settings.json.',
+        description: 'Automatically approves read-only permission requests (Read, Glob, Grep) without user confirmation.',
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates a Claude Code hook configuration for the given template.
+ * `notification-desktop` auto-detects the current platform via process.platform.
+ */
+export function generateHookTemplate(opts) {
+    const { template, notificationMatcher } = opts;
+    switch (template) {
+        case 'notification-macos':
+            return buildMacosTemplate(notificationMatcher);
+        case 'notification-linux':
+            return buildLinuxTemplate(notificationMatcher);
+        case 'notification-windows':
+            return buildWindowsTemplate(notificationMatcher);
+        case 'notification-desktop':
+            return buildDesktopTemplate(notificationMatcher);
+        case 'instructions-loaded-debug':
+            return buildInstructionsLoadedDebugTemplate();
+        case 'permission-auto-approve-readonly':
+            return buildPermissionAutoApproveReadonlyTemplate();
+        /* v8 ignore next 3 */
+        default: {
+            const _exhaustive = template;
+            throw new Error(`Unknown hook template: ${String(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Merges a new hook config into an existing settings object without overwriting.
+ * Existing hooks for the same event type are preserved (array merge).
+ */
+export function mergeHookConfig(existing, newHook) {
+    const existingHooks = (existing.hooks ?? {});
+    const merged = { ...existingHooks };
+    for (const [eventType, entries] of Object.entries(newHook.hooks)) {
+        const current = merged[eventType] ?? [];
+        merged[eventType] = [...current, ...entries];
+    }
+    return { ...existing, hooks: merged };
+}
+/**
+ * Returns all valid HookTemplateName values (for use in Zod schemas and descriptions).
+ */
+export function listHookTemplateNames() {
+    return [
+        'notification-macos',
+        'notification-linux',
+        'notification-windows',
+        'notification-desktop',
+        'instructions-loaded-debug',
+        'permission-auto-approve-readonly',
+    ];
+}
+//# sourceMappingURL=hook-templates.js.map

package/dist/engine/hooks/hook-templates.js.map

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

package/dist/engine/hooks/plan-mode-detector.d.ts

@@ -0,0 +1,27 @@
+import type { PlanModeEvent } from '../../types/index.js';
+/**
+ * Reads CLAUDE_TOOL_NAME and CLAUDE_TOOL_INPUT from the environment
+ * and returns a PlanModeEvent describing the current tool invocation.
+ *
+ * This is designed to be called from Claude Code hook scripts that set
+ * these env vars before invoking the hook handler.
+ */
+export declare function detectPlanModeEvent(): PlanModeEvent;
+/**
+ * Returns true when the given tool name corresponds to entering Plan Mode.
+ */
+export declare function isEnterPlanMode(toolName: string): boolean;
+/**
+ * Returns true when the given tool name corresponds to exiting Plan Mode.
+ */
+export declare function isExitPlanMode(toolName: string): boolean;
+/**
+ * Attempts to extract a human-readable task description from the JSON-encoded
+ * CLAUDE_TOOL_INPUT string.  Returns null when the input is empty or cannot
+ * be parsed, or when no recognisable description field is present.
+ *
+ * Claude Code's Task tool input has the shape: { description: string, ... }
+ * We also fall back to a `prompt`, `task`, or `content` field.
+ */
+export declare function extractTaskDescription(toolInput: string): string | null;
+//# sourceMappingURL=plan-mode-detector.d.ts.map

package/dist/engine/hooks/plan-mode-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/plan-mode-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAa1D;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAKnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4BvE"}

package/dist/engine/hooks/plan-mode-detector.js

@@ -0,0 +1,68 @@
+/**
+ * Names of Claude Code tools that indicate entering Plan Mode.
+ * The main "Task" tool is how Claude enters plan mode; "plan" is an alias.
+ */
+const ENTER_PLAN_MODE_TOOLS = ['Task'];
+/**
+ * Names of Claude Code tools that indicate exiting Plan Mode.
+ */
+const EXIT_PLAN_MODE_TOOLS = ['exit_plan_mode'];
+/**
+ * Reads CLAUDE_TOOL_NAME and CLAUDE_TOOL_INPUT from the environment
+ * and returns a PlanModeEvent describing the current tool invocation.
+ *
+ * This is designed to be called from Claude Code hook scripts that set
+ * these env vars before invoking the hook handler.
+ */
+export function detectPlanModeEvent() {
+    const toolName = process.env.CLAUDE_TOOL_NAME ?? '';
+    const toolInputRaw = process.env.CLAUDE_TOOL_INPUT ?? '';
+    const taskDescription = extractTaskDescription(toolInputRaw);
+    return { toolName, taskDescription };
+}
+/**
+ * Returns true when the given tool name corresponds to entering Plan Mode.
+ */
+export function isEnterPlanMode(toolName) {
+    return ENTER_PLAN_MODE_TOOLS.includes(toolName);
+}
+/**
+ * Returns true when the given tool name corresponds to exiting Plan Mode.
+ */
+export function isExitPlanMode(toolName) {
+    return EXIT_PLAN_MODE_TOOLS.includes(toolName);
+}
+/**
+ * Attempts to extract a human-readable task description from the JSON-encoded
+ * CLAUDE_TOOL_INPUT string.  Returns null when the input is empty or cannot
+ * be parsed, or when no recognisable description field is present.
+ *
+ * Claude Code's Task tool input has the shape: { description: string, ... }
+ * We also fall back to a `prompt`, `task`, or `content` field.
+ */
+export function extractTaskDescription(toolInput) {
+    if (!toolInput.trim()) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(toolInput);
+    }
+    catch {
+        // Not JSON — treat the raw string as the description if it is short enough
+        const trimmed = toolInput.trim();
+        return trimmed.length > 0 && trimmed.length <= 2000 ? trimmed : null;
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return null;
+    }
+    const obj = parsed;
+    for (const key of ['description', 'prompt', 'task', 'content']) {
+        const val = obj[key];
+        if (typeof val === 'string' && val.trim().length > 0) {
+            return val.trim();
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=plan-mode-detector.js.map

package/dist/engine/hooks/plan-mode-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-detector.js","sourceRoot":"","sources":["../../../src/engine/hooks/plan-mode-detector.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,qBAAqB,GAAsB,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,MAAM,oBAAoB,GAAsB,CAAC,gBAAgB,CAAC,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;IACzD,MAAM,eAAe,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAC7D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;QAC/D,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/hooks/plan-mode-scripts.d.ts

@@ -0,0 +1,10 @@
+import type { PlanModeHookScripts } from '../../types/index.js';
+/**
+ * Returns the content of the two bash scripts that integrate Planu with
+ * Claude Code's Plan Mode hooks:
+ *
+ * - preScript: called by PreToolUse when tool name is "Task" (entering Plan Mode)
+ * - postScript: called by PostToolUse when tool name is "exit_plan_mode"
+ */
+export declare function buildPlanModeHookScripts(): PlanModeHookScripts;
+//# sourceMappingURL=plan-mode-scripts.d.ts.map

package/dist/engine/hooks/plan-mode-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-scripts.d.ts","sourceRoot":"","sources":["../../../src/engine/hooks/plan-mode-scripts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,mBAAmB,CAI9D"}

package/dist/engine/hooks/plan-mode-scripts.js

@@ -0,0 +1,45 @@
+/**
+ * Returns the content of the two bash scripts that integrate Planu with
+ * Claude Code's Plan Mode hooks:
+ *
+ * - preScript: called by PreToolUse when tool name is "Task" (entering Plan Mode)
+ * - postScript: called by PostToolUse when tool name is "exit_plan_mode"
+ */
+export function buildPlanModeHookScripts() {
+    const preScript = buildPreScript();
+    const postScript = buildPostScript();
+    return { preScript, postScript };
+}
+function buildPreScript() {
+    return [
+        '#!/usr/bin/env bash',
+        '# planu-pre-plan.sh — Auto-generated by Planu (SPEC-262)',
+        '# Called by Claude Code PreToolUse hook when entering Plan Mode (Task tool).',
+        '# Injects project context into .planu/plan-context.md',
+        '',
+        'PROJECT_PATH="${CLAUDE_PROJECT_DIR:-$(pwd)}"',
+        '',
+        'node -e "',
+        "import('@planu/cli/dist/engine/hooks/context-injector.js')",
+        '  .then(({ injectPlanContext }) =>',
+        '    injectPlanContext(process.env.PROJECT_PATH || process.cwd(), process.env.CLAUDE_TOOL_INPUT || null)',
+        '  )',
+        '  .catch(() => {});',
+        '" PROJECT_PATH="$PROJECT_PATH" 2>/dev/null || true',
+        '',
+    ].join('\n');
+}
+function buildPostScript() {
+    return [
+        '#!/usr/bin/env bash',
+        '# planu-post-plan.sh — Auto-generated by Planu (SPEC-262)',
+        '# Called by Claude Code PostToolUse hook when exiting Plan Mode.',
+        '# Appends a suggestion to call `facilitate` with plan findings.',
+        '',
+        "echo '---'",
+        "echo 'Planu: Plan Mode exited.'",
+        "echo 'Tip: call `facilitate` with your findings to create a spec, or `create_spec` directly.'",
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=plan-mode-scripts.js.map

package/dist/engine/hooks/plan-mode-scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode-scripts.js","sourceRoot":"","sources":["../../../src/engine/hooks/plan-mode-scripts.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB;IACtC,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;IACrC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,cAAc;IACrB,OAAO;QACL,qBAAqB;QACrB,0DAA0D;QAC1D,8EAA8E;QAC9E,uDAAuD;QACvD,EAAE;QACF,8CAA8C;QAC9C,EAAE;QACF,WAAW;QACX,4DAA4D;QAC5D,oCAAoC;QACpC,yGAAyG;QACzG,KAAK;QACL,qBAAqB;QACrB,oDAAoD;QACpD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;QACL,qBAAqB;QACrB,2DAA2D;QAC3D,kEAAkE;QAClE,iEAAiE;QACjE,EAAE;QACF,YAAY;QACZ,iCAAiC;QACjC,+FAA+F;QAC/F,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,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"}

package/dist/engine/ide-config/generators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/generators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EACd,WAAW,EACX,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAkM9B;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAGpB"}
+{"version":3,"file":"generators.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/generators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EACd,WAAW,EACX,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAsO9B;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAGpB"}

package/dist/engine/ide-config/generators.js

@@ -1,5 +1,5 @@
 // engine/ide-config/generators.ts — Per-IDE config generators (SPEC-080 AC-02..AC-08)
-import { resolveConfigPath, buildServerEntry } from './path-resolver.js';
+import { resolveConfigPath, buildServerEntry, getNpxCommand } from './path-resolver.js';
 /**
  * Generate JSON-based config for IDEs that use a standard mcpServers/servers wrapper.
  */
@@ -125,6 +125,32 @@ function generateNeovimConfig(ide, scope, platform, projectPath) {
             `See comments in the generated file for integration instructions.`,
     };
 }
+/**
+ * Generate OpenCode config (SPEC-277).
+ * opencode.json uses { "mcp": { "planu": { "type": "local", "command": [...] } } }
+ * Also notes that .claude/skills/ are natively compatible (opencode searches that path too).
+ */
+function generateOpencodeConfig(ide, scope, platform, projectPath) {
+    const filePath = resolveConfigPath(ide, scope, platform, projectPath);
+    const npx = getNpxCommand(platform);
+    const config = {
+        $schema: 'https://opencode.ai/config.json',
+        mcp: {
+            planu: {
+                type: 'local',
+                command: [npx, '-y', '@planu/cli'],
+                enabled: true,
+            },
+        },
+    };
+    return {
+        filePath,
+        content: JSON.stringify(config, null, 2),
+        instructions: `OpenCode config generated at ${filePath}. ` +
+            `Run 'opencode' in your project directory to start. ` +
+            `Your existing .claude/skills/ are automatically compatible with OpenCode — no duplication needed.`,
+    };
+}
 /** Map of IDE-specific generators */
 const IDE_GENERATORS = {
     vscode: generateVscodeConfig,
@@ -135,6 +161,7 @@ const IDE_GENERATORS = {
     'claude-code': generateClaudeCodeConfig,
     neovim: generateNeovimConfig,
     chatgpt: generateJsonConfig,
+    opencode: generateOpencodeConfig,
 };
 /**
  * Generate config for a specific IDE.