oh-my-claude-sisyphus 1.4.1 → 1.6.0

package/dist/hooks/directory-readme-injector/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CACzC,oBAAoB,EACpB,kBAAkB,CACnB,CAAC;AAEF,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC"}

package/dist/hooks/directory-readme-injector/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Directory README Injector Hook
+ *
+ * Automatically injects relevant README content from directories when files are accessed.
+ * Walks up the directory tree from accessed files to find and inject README.md files.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ * Adapted for Claude Code's shell hook system.
+ */
+export * from './types.js';
+export * from './constants.js';
+export * from './storage.js';
+/**
+ * Create directory README injector hook for Claude Code.
+ *
+ * @param workingDirectory - The working directory for resolving paths
+ * @returns Hook handlers for tool execution
+ */
+export declare function createDirectoryReadmeInjectorHook(workingDirectory: string): {
+    /**
+     * Process a tool execution and inject READMEs if relevant.
+     */
+    processToolExecution: (toolName: string, filePath: string, sessionID: string) => string;
+    /**
+     * Get READMEs for a specific file without marking as injected.
+     */
+    getReadmesForFile: (filePath: string) => string[];
+    /**
+     * Clear session cache when session ends.
+     */
+    clearSession: (sessionID: string) => void;
+    /**
+     * Check if a tool triggers README injection.
+     */
+    isTrackedTool: (toolName: string) => boolean;
+};
+/**
+ * Get README paths for a file (simple utility function).
+ */
+export declare function getReadmesForPath(filePath: string, workingDirectory?: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/directory-readme-injector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAsC7B;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,gBAAgB,EAAE,MAAM;IAyFtE;;OAEG;qCAES,MAAM,YACN,MAAM,aACL,MAAM,KAChB,MAAM;IAQT;;OAEG;kCAC2B,MAAM,KAAG,MAAM,EAAE;IAQ/C;;OAEG;8BACuB,MAAM,KAAG,IAAI;IAKvC;;OAEG;8BACuB,MAAM,KAAG,OAAO;EAI7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,MAAM,EAAE,CAIV"}

package/dist/hooks/directory-readme-injector/index.js

@@ -0,0 +1,162 @@
+/**
+ * Directory README Injector Hook
+ *
+ * Automatically injects relevant README content from directories when files are accessed.
+ * Walks up the directory tree from accessed files to find and inject README.md files.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ * Adapted for Claude Code's shell hook system.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { loadInjectedPaths, saveInjectedPaths, clearInjectedPaths, } from './storage.js';
+import { README_FILENAME, TRACKED_TOOLS } from './constants.js';
+// Re-export submodules
+export * from './types.js';
+export * from './constants.js';
+export * from './storage.js';
+/**
+ * Simple token estimation (4 chars per token)
+ */
+const CHARS_PER_TOKEN = 4;
+const DEFAULT_MAX_README_TOKENS = 5000;
+/**
+ * Simple truncation for README content
+ */
+function truncateContent(content, maxTokens = DEFAULT_MAX_README_TOKENS) {
+    const estimatedTokens = Math.ceil(content.length / CHARS_PER_TOKEN);
+    if (estimatedTokens <= maxTokens) {
+        return { result: content, truncated: false };
+    }
+    const maxChars = maxTokens * CHARS_PER_TOKEN;
+    const truncated = content.slice(0, maxChars);
+    return {
+        result: truncated,
+        truncated: true,
+    };
+}
+/**
+ * Create directory README injector hook for Claude Code.
+ *
+ * @param workingDirectory - The working directory for resolving paths
+ * @returns Hook handlers for tool execution
+ */
+export function createDirectoryReadmeInjectorHook(workingDirectory) {
+    const sessionCaches = new Map();
+    function getSessionCache(sessionID) {
+        if (!sessionCaches.has(sessionID)) {
+            sessionCaches.set(sessionID, loadInjectedPaths(sessionID));
+        }
+        return sessionCaches.get(sessionID);
+    }
+    function resolveFilePath(path) {
+        if (!path)
+            return null;
+        if (path.startsWith('/'))
+            return path;
+        return resolve(workingDirectory, path);
+    }
+    /**
+     * Find README.md files by walking up the directory tree.
+     * Returns paths in order from root to leaf.
+     */
+    function findReadmeMdUp(startDir) {
+        const found = [];
+        let current = startDir;
+        while (true) {
+            const readmePath = join(current, README_FILENAME);
+            if (existsSync(readmePath)) {
+                found.push(readmePath);
+            }
+            // Stop at working directory root
+            if (current === workingDirectory)
+                break;
+            const parent = dirname(current);
+            // Stop at filesystem root
+            if (parent === current)
+                break;
+            // Stop if we've gone outside the working directory
+            if (!parent.startsWith(workingDirectory))
+                break;
+            current = parent;
+        }
+        // Return in order from root to leaf (reverse the array)
+        return found.reverse();
+    }
+    /**
+     * Process a file path and return README content to inject.
+     */
+    function processFilePathForReadmes(filePath, sessionID) {
+        const resolved = resolveFilePath(filePath);
+        if (!resolved)
+            return '';
+        const dir = dirname(resolved);
+        const cache = getSessionCache(sessionID);
+        const readmePaths = findReadmeMdUp(dir);
+        let output = '';
+        for (const readmePath of readmePaths) {
+            const readmeDir = dirname(readmePath);
+            if (cache.has(readmeDir))
+                continue;
+            try {
+                const content = readFileSync(readmePath, 'utf-8');
+                const { result, truncated } = truncateContent(content);
+                const truncationNotice = truncated
+                    ? `\n\n[Note: Content was truncated to save context window space. For full context, please read the file directly: ${readmePath}]`
+                    : '';
+                output += `\n\n[Project README: ${readmePath}]\n${result}${truncationNotice}`;
+                cache.add(readmeDir);
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+        if (output) {
+            saveInjectedPaths(sessionID, cache);
+        }
+        return output;
+    }
+    return {
+        /**
+         * Process a tool execution and inject READMEs if relevant.
+         */
+        processToolExecution: (toolName, filePath, sessionID) => {
+            if (!TRACKED_TOOLS.includes(toolName.toLowerCase())) {
+                return '';
+            }
+            return processFilePathForReadmes(filePath, sessionID);
+        },
+        /**
+         * Get READMEs for a specific file without marking as injected.
+         */
+        getReadmesForFile: (filePath) => {
+            const resolved = resolveFilePath(filePath);
+            if (!resolved)
+                return [];
+            const dir = dirname(resolved);
+            return findReadmeMdUp(dir);
+        },
+        /**
+         * Clear session cache when session ends.
+         */
+        clearSession: (sessionID) => {
+            sessionCaches.delete(sessionID);
+            clearInjectedPaths(sessionID);
+        },
+        /**
+         * Check if a tool triggers README injection.
+         */
+        isTrackedTool: (toolName) => {
+            return TRACKED_TOOLS.includes(toolName.toLowerCase());
+        },
+    };
+}
+/**
+ * Get README paths for a file (simple utility function).
+ */
+export function getReadmesForPath(filePath, workingDirectory) {
+    const cwd = workingDirectory || process.cwd();
+    const hook = createDirectoryReadmeInjectorHook(cwd);
+    return hook.getReadmesForFile(filePath);
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/directory-readme-injector/index.js.map

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

package/dist/hooks/directory-readme-injector/storage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Directory README Injector Storage
+ *
+ * Persistent storage for tracking which directory READMEs have been injected per session.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+/**
+ * Load set of injected directory paths for a session.
+ */
+export declare function loadInjectedPaths(sessionID: string): Set<string>;
+/**
+ * Save set of injected directory paths for a session.
+ */
+export declare function saveInjectedPaths(sessionID: string, paths: Set<string>): void;
+/**
+ * Clear injected paths for a session.
+ */
+export declare function clearInjectedPaths(sessionID: string): void;
+//# sourceMappingURL=storage.d.ts.map

package/dist/hooks/directory-readme-injector/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAWhE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAY7E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAK1D"}

package/dist/hooks/directory-readme-injector/storage.js

@@ -0,0 +1,56 @@
+/**
+ * Directory README Injector Storage
+ *
+ * Persistent storage for tracking which directory READMEs have been injected per session.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync, } from 'node:fs';
+import { join } from 'node:path';
+import { README_INJECTOR_STORAGE } from './constants.js';
+/**
+ * Get storage file path for a session.
+ */
+function getStoragePath(sessionID) {
+    return join(README_INJECTOR_STORAGE, `${sessionID}.json`);
+}
+/**
+ * Load set of injected directory paths for a session.
+ */
+export function loadInjectedPaths(sessionID) {
+    const filePath = getStoragePath(sessionID);
+    if (!existsSync(filePath))
+        return new Set();
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const data = JSON.parse(content);
+        return new Set(data.injectedPaths);
+    }
+    catch {
+        return new Set();
+    }
+}
+/**
+ * Save set of injected directory paths for a session.
+ */
+export function saveInjectedPaths(sessionID, paths) {
+    if (!existsSync(README_INJECTOR_STORAGE)) {
+        mkdirSync(README_INJECTOR_STORAGE, { recursive: true });
+    }
+    const data = {
+        sessionID,
+        injectedPaths: Array.from(paths),
+        updatedAt: Date.now(),
+    };
+    writeFileSync(getStoragePath(sessionID), JSON.stringify(data, null, 2));
+}
+/**
+ * Clear injected paths for a session.
+ */
+export function clearInjectedPaths(sessionID) {
+    const filePath = getStoragePath(sessionID);
+    if (existsSync(filePath)) {
+        unlinkSync(filePath);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/hooks/directory-readme-injector/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAGzD;;GAEG;AACH,SAAS,cAAc,CAAC,SAAiB;IACvC,OAAO,IAAI,CAAC,uBAAuB,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,GAAG,EAAE,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,IAAI,GAAsB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAkB;IACrE,IAAI,CAAC,UAAU,CAAC,uBAAuB,CAAC,EAAE,CAAC;QACzC,SAAS,CAAC,uBAAuB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAsB;QAC9B,SAAS;QACT,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,aAAa,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/hooks/directory-readme-injector/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Directory README Injector Types
+ *
+ * Type definitions for tracking injected README files per session.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+/**
+ * Storage data for tracking which directory READMEs have been injected
+ * into a session's context.
+ */
+export interface InjectedPathsData {
+    /** Session identifier */
+    sessionID: string;
+    /** List of directory paths whose READMEs have been injected */
+    injectedPaths: string[];
+    /** Timestamp of last update */
+    updatedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/directory-readme-injector/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/hooks/directory-readme-injector/types.js

@@ -0,0 +1,9 @@
+/**
+ * Directory README Injector Types
+ *
+ * Type definitions for tracking injected README files per session.
+ *
+ * Ported from oh-my-opencode's directory-readme-injector hook.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/directory-readme-injector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/directory-readme-injector/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/hooks/edit-error-recovery/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Edit Error Recovery Hook
+ *
+ * Detects Edit tool errors caused by AI mistakes and injects
+ * a recovery reminder to guide corrective action.
+ *
+ * Common Edit tool failures:
+ * - oldString and newString must be different (trying to "edit" to same content)
+ * - oldString not found (wrong assumption about file content)
+ * - oldString found multiple times (ambiguous match, need more context)
+ *
+ * Ported from oh-my-opencode's edit-error-recovery hook.
+ */
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export declare const EDIT_ERROR_PATTERNS: readonly ["oldString and newString must be different", "oldString not found", "oldString found multiple times", "old_string not found", "old_string and new_string must be different"];
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export declare const EDIT_ERROR_REMINDER = "\n[EDIT ERROR - IMMEDIATE ACTION REQUIRED]\n\nYou made an Edit mistake. STOP and do this NOW:\n\n1. READ the file immediately to see its ACTUAL current state\n2. VERIFY what the content really looks like (your assumption was wrong)\n3. APOLOGIZE briefly to the user for the error\n4. CONTINUE with corrected action based on the real file content\n\nDO NOT attempt another edit until you've read and verified the file state.\n";
+/**
+ * Check if an output contains an edit error pattern
+ */
+export declare function detectEditError(output: string): boolean;
+/**
+ * Inject the edit error recovery reminder into the output
+ */
+export declare function injectEditErrorRecovery(output: string): string;
+/**
+ * Hook input interface for tool execution
+ */
+export interface ToolExecuteInput {
+    tool: string;
+    sessionId: string;
+    callId: string;
+}
+/**
+ * Hook output interface for tool execution
+ */
+export interface ToolExecuteOutput {
+    title: string;
+    output: string;
+    metadata?: unknown;
+}
+/**
+ * Creates the edit error recovery hook for Claude Code.
+ * This is the main export for hook registration.
+ */
+export declare function createEditErrorRecoveryHook(): {
+    /**
+     * After tool execution, check for Edit errors and inject recovery reminder.
+     */
+    afterToolExecute: (input: ToolExecuteInput, output: ToolExecuteOutput) => ToolExecuteOutput;
+};
+/**
+ * Process edit tool output and inject recovery if needed.
+ * Simplified function for direct use without hook context.
+ */
+export declare function processEditOutput(toolName: string, output: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/edit-error-recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/edit-error-recovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB,wLAMtB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,mBAAmB,8aAW/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B;IAEvC;;OAEG;8BAEM,gBAAgB,UACf,iBAAiB,KACxB,iBAAiB;EAevB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1E"}

package/dist/hooks/edit-error-recovery/index.js

@@ -0,0 +1,89 @@
+/**
+ * Edit Error Recovery Hook
+ *
+ * Detects Edit tool errors caused by AI mistakes and injects
+ * a recovery reminder to guide corrective action.
+ *
+ * Common Edit tool failures:
+ * - oldString and newString must be different (trying to "edit" to same content)
+ * - oldString not found (wrong assumption about file content)
+ * - oldString found multiple times (ambiguous match, need more context)
+ *
+ * Ported from oh-my-opencode's edit-error-recovery hook.
+ */
+/**
+ * Known Edit tool error patterns that indicate the AI made a mistake
+ */
+export const EDIT_ERROR_PATTERNS = [
+    'oldString and newString must be different',
+    'oldString not found',
+    'oldString found multiple times',
+    'old_string not found',
+    'old_string and new_string must be different',
+];
+/**
+ * System reminder injected when Edit tool fails due to AI mistake
+ * Short, direct, and commanding - forces immediate corrective action
+ */
+export const EDIT_ERROR_REMINDER = `
+[EDIT ERROR - IMMEDIATE ACTION REQUIRED]
+
+You made an Edit mistake. STOP and do this NOW:
+
+1. READ the file immediately to see its ACTUAL current state
+2. VERIFY what the content really looks like (your assumption was wrong)
+3. APOLOGIZE briefly to the user for the error
+4. CONTINUE with corrected action based on the real file content
+
+DO NOT attempt another edit until you've read and verified the file state.
+`;
+/**
+ * Check if an output contains an edit error pattern
+ */
+export function detectEditError(output) {
+    const outputLower = output.toLowerCase();
+    return EDIT_ERROR_PATTERNS.some((pattern) => outputLower.includes(pattern.toLowerCase()));
+}
+/**
+ * Inject the edit error recovery reminder into the output
+ */
+export function injectEditErrorRecovery(output) {
+    if (detectEditError(output)) {
+        return output + EDIT_ERROR_REMINDER;
+    }
+    return output;
+}
+/**
+ * Creates the edit error recovery hook for Claude Code.
+ * This is the main export for hook registration.
+ */
+export function createEditErrorRecoveryHook() {
+    return {
+        /**
+         * After tool execution, check for Edit errors and inject recovery reminder.
+         */
+        afterToolExecute: (input, output) => {
+            if (input.tool.toLowerCase() !== 'edit') {
+                return output;
+            }
+            if (detectEditError(output.output)) {
+                return {
+                    ...output,
+                    output: output.output + EDIT_ERROR_REMINDER,
+                };
+            }
+            return output;
+        },
+    };
+}
+/**
+ * Process edit tool output and inject recovery if needed.
+ * Simplified function for direct use without hook context.
+ */
+export function processEditOutput(toolName, output) {
+    if (toolName.toLowerCase() !== 'edit') {
+        return output;
+    }
+    return injectEditErrorRecovery(output);
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/edit-error-recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/edit-error-recovery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,2CAA2C;IAC3C,qBAAqB;IACrB,gCAAgC;IAChC,sBAAsB;IACtB,6CAA6C;CACrC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;CAWlC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1C,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,IAAI,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5B,OAAO,MAAM,GAAG,mBAAmB,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAoBD;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL;;WAEG;QACH,gBAAgB,EAAE,CAChB,KAAuB,EACvB,MAAyB,EACN,EAAE;YACrB,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;gBACxC,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnC,OAAO;oBACL,GAAG,MAAM;oBACT,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,mBAAmB;iBAC5C,CAAC;YACJ,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,MAAc;IAChE,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/hooks/empty-message-sanitizer/constants.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Empty Message Sanitizer Constants
+ *
+ * Constants for the empty message sanitizer hook.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+/**
+ * Placeholder text injected for empty messages
+ * This prevents API errors about empty content
+ */
+export declare const PLACEHOLDER_TEXT = "[user interrupted]";
+/**
+ * Tool-related part types that count as valid content
+ */
+export declare const TOOL_PART_TYPES: Set<string>;
+/**
+ * Hook name identifier
+ */
+export declare const HOOK_NAME = "empty-message-sanitizer";
+/**
+ * Debug log prefix
+ */
+export declare const DEBUG_PREFIX = "[empty-message-sanitizer]";
+/**
+ * Error message patterns for debugging
+ */
+export declare const ERROR_PATTERNS: {
+    EMPTY_CONTENT: string;
+    EMPTY_TEXT: string;
+    NO_VALID_PARTS: string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/empty-message-sanitizer/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/empty-message-sanitizer/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,uBAAuB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,eAAe,aAI1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,4BAA4B,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,YAAY,8BAA8B,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAI1B,CAAC"}

package/dist/hooks/empty-message-sanitizer/constants.js

@@ -0,0 +1,37 @@
+/**
+ * Empty Message Sanitizer Constants
+ *
+ * Constants for the empty message sanitizer hook.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+/**
+ * Placeholder text injected for empty messages
+ * This prevents API errors about empty content
+ */
+export const PLACEHOLDER_TEXT = '[user interrupted]';
+/**
+ * Tool-related part types that count as valid content
+ */
+export const TOOL_PART_TYPES = new Set([
+    'tool',
+    'tool_use',
+    'tool_result',
+]);
+/**
+ * Hook name identifier
+ */
+export const HOOK_NAME = 'empty-message-sanitizer';
+/**
+ * Debug log prefix
+ */
+export const DEBUG_PREFIX = '[empty-message-sanitizer]';
+/**
+ * Error message patterns for debugging
+ */
+export const ERROR_PATTERNS = {
+    EMPTY_CONTENT: 'all messages must have non-empty content',
+    EMPTY_TEXT: 'message contains empty text part',
+    NO_VALID_PARTS: 'message has no valid content parts',
+};
+//# sourceMappingURL=constants.js.map

package/dist/hooks/empty-message-sanitizer/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/empty-message-sanitizer/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IACrC,MAAM;IACN,UAAU;IACV,aAAa;CACd,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,yBAAyB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,2BAA2B,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,aAAa,EAAE,0CAA0C;IACzD,UAAU,EAAE,kCAAkC;IAC9C,cAAc,EAAE,oCAAoC;CACrD,CAAC"}

package/dist/hooks/empty-message-sanitizer/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Empty Message Sanitizer Hook
+ *
+ * Sanitizes empty messages to prevent API errors.
+ * According to the Anthropic API spec, all messages must have non-empty content
+ * except for the optional final assistant message.
+ *
+ * This hook:
+ * 1. Detects messages with no valid content (empty text or no parts)
+ * 2. Injects placeholder text to prevent API errors
+ * 3. Marks injected content as synthetic
+ *
+ * NOTE: This sanitizer would ideally run on a message transform hook that executes
+ * AFTER all other message processing. In the shell hooks system, this should be
+ * invoked at the last stage before messages are sent to the API.
+ *
+ * Adapted from oh-my-opencode's empty-message-sanitizer hook.
+ */
+import type { MessagePart, MessageWithParts, EmptyMessageSanitizerInput, EmptyMessageSanitizerOutput, EmptyMessageSanitizerConfig } from './types.js';
+/**
+ * Check if a part has non-empty text content
+ */
+export declare function hasTextContent(part: MessagePart): boolean;
+/**
+ * Check if a part is a tool-related part
+ */
+export declare function isToolPart(part: MessagePart): boolean;
+/**
+ * Check if message parts contain valid content
+ * Valid content = non-empty text OR tool parts
+ */
+export declare function hasValidContent(parts: MessagePart[]): boolean;
+/**
+ * Sanitize a single message to ensure it has valid content
+ */
+export declare function sanitizeMessage(message: MessageWithParts, isLastMessage: boolean, placeholderText?: string): boolean;
+/**
+ * Sanitize all messages in the input
+ */
+export declare function sanitizeMessages(input: EmptyMessageSanitizerInput, config?: EmptyMessageSanitizerConfig): EmptyMessageSanitizerOutput;
+/**
+ * Create empty message sanitizer hook for Claude Code shell hooks
+ *
+ * This hook ensures all messages have valid content before being sent to the API.
+ * It should be called at the last stage of message processing.
+ */
+export declare function createEmptyMessageSanitizerHook(config?: EmptyMessageSanitizerConfig): {
+    /**
+     * Sanitize messages (called during message transform phase)
+     */
+    sanitize: (input: EmptyMessageSanitizerInput) => EmptyMessageSanitizerOutput;
+    /**
+     * Get hook name
+     */
+    getName: () => string;
+};
+export type { MessagePart, MessageInfo, MessageWithParts, EmptyMessageSanitizerInput, EmptyMessageSanitizerOutput, EmptyMessageSanitizerConfig, } from './types.js';
+export { PLACEHOLDER_TEXT, TOOL_PART_TYPES, HOOK_NAME, DEBUG_PREFIX, ERROR_PATTERNS, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/empty-message-sanitizer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/empty-message-sanitizer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAcpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAMzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAErD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,aAAa,EAAE,OAAO,EACtB,eAAe,GAAE,MAAyB,GACzC,OAAO,CAwET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,0BAA0B,EACjC,MAAM,CAAC,EAAE,2BAA2B,GACnC,2BAA2B,CAyB7B;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,CAAC,EAAE,2BAA2B;IAIhF;;OAEG;sBACe,0BAA0B,KAAG,2BAA2B;IAI1E;;OAEG;mBACU,MAAM;EAItB;AAGD,YAAY,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,GACf,MAAM,gBAAgB,CAAC"}