oh-my-claude-sisyphus 1.4.1 → 1.6.0

package/dist/hooks/non-interactive-env/constants.js

@@ -0,0 +1,69 @@
+export const HOOK_NAME = "non-interactive-env";
+export const NON_INTERACTIVE_ENV = {
+    CI: "true",
+    DEBIAN_FRONTEND: "noninteractive",
+    GIT_TERMINAL_PROMPT: "0",
+    GCM_INTERACTIVE: "never",
+    HOMEBREW_NO_AUTO_UPDATE: "1",
+    // Block interactive editors - git rebase, commit, etc.
+    GIT_EDITOR: ":",
+    EDITOR: ":",
+    VISUAL: "",
+    GIT_SEQUENCE_EDITOR: ":",
+    GIT_MERGE_AUTOEDIT: "no",
+    // Block pagers
+    GIT_PAGER: "cat",
+    PAGER: "cat",
+    // NPM non-interactive
+    npm_config_yes: "true",
+    // Pip non-interactive
+    PIP_NO_INPUT: "1",
+    // Yarn non-interactive
+    YARN_ENABLE_IMMUTABLE_INSTALLS: "false",
+};
+/**
+ * Shell command guidance for non-interactive environments.
+ * These patterns should be followed to avoid hanging on user input.
+ */
+export const SHELL_COMMAND_PATTERNS = {
+    // Package managers - always use non-interactive flags
+    npm: {
+        bad: ["npm init", "npm install (prompts)"],
+        good: ["npm init -y", "npm install --yes"],
+    },
+    apt: {
+        bad: ["apt-get install pkg"],
+        good: ["apt-get install -y pkg", "DEBIAN_FRONTEND=noninteractive apt-get install pkg"],
+    },
+    pip: {
+        bad: ["pip install pkg (with prompts)"],
+        good: ["pip install --no-input pkg", "PIP_NO_INPUT=1 pip install pkg"],
+    },
+    // Git operations - always provide messages/flags
+    git: {
+        bad: ["git commit", "git merge branch", "git add -p", "git rebase -i"],
+        good: ["git commit -m 'msg'", "git merge --no-edit branch", "git add .", "git rebase --no-edit"],
+    },
+    // System commands - force flags
+    system: {
+        bad: ["rm file (prompts)", "cp a b (prompts)", "ssh host"],
+        good: ["rm -f file", "cp -f a b", "ssh -o BatchMode=yes host", "unzip -o file.zip"],
+    },
+    // Banned commands - will always hang
+    banned: [
+        "vim", "nano", "vi", "emacs", // Editors
+        "less", "more", "man", // Pagers
+        "python (REPL)", "node (REPL)", // REPLs without -c/-e
+        "git add -p", "git rebase -i", // Interactive git modes
+    ],
+    // Workarounds for scripts that require input
+    workarounds: {
+        yesPipe: "yes | ./script.sh",
+        heredoc: `./script.sh <<EOF
+option1
+option2
+EOF`,
+        expectAlternative: "Use environment variables or config files instead of expect",
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/hooks/non-interactive-env/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAA;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,EAAE,EAAE,MAAM;IACV,eAAe,EAAE,gBAAgB;IACjC,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,OAAO;IACxB,uBAAuB,EAAE,GAAG;IAC5B,uDAAuD;IACvD,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,MAAM,EAAE,EAAE;IACV,mBAAmB,EAAE,GAAG;IACxB,kBAAkB,EAAE,IAAI;IACxB,eAAe;IACf,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,KAAK;IACZ,sBAAsB;IACtB,cAAc,EAAE,MAAM;IACtB,sBAAsB;IACtB,YAAY,EAAE,GAAG;IACjB,uBAAuB;IACvB,8BAA8B,EAAE,OAAO;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,sDAAsD;IACtD,GAAG,EAAE;QACH,GAAG,EAAE,CAAC,UAAU,EAAE,uBAAuB,CAAC;QAC1C,IAAI,EAAE,CAAC,aAAa,EAAE,mBAAmB,CAAC;KAC3C;IACD,GAAG,EAAE;QACH,GAAG,EAAE,CAAC,qBAAqB,CAAC;QAC5B,IAAI,EAAE,CAAC,wBAAwB,EAAE,oDAAoD,CAAC;KACvF;IACD,GAAG,EAAE;QACH,GAAG,EAAE,CAAC,gCAAgC,CAAC;QACvC,IAAI,EAAE,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;KACvE;IACD,iDAAiD;IACjD,GAAG,EAAE;QACH,GAAG,EAAE,CAAC,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,eAAe,CAAC;QACtE,IAAI,EAAE,CAAC,qBAAqB,EAAE,4BAA4B,EAAE,WAAW,EAAE,sBAAsB,CAAC;KACjG;IACD,gCAAgC;IAChC,MAAM,EAAE;QACN,GAAG,EAAE,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,UAAU,CAAC;QAC1D,IAAI,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,2BAA2B,EAAE,mBAAmB,CAAC;KACpF;IACD,qCAAqC;IACrC,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAY,UAAU;QAClD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAoB,SAAS;QAClD,eAAe,EAAE,aAAa,EAAW,sBAAsB;QAC/D,YAAY,EAAE,eAAe,EAAY,wBAAwB;KAClE;IACD,6CAA6C;IAC7C,WAAW,EAAE;QACX,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE;;;IAGT;QACA,iBAAiB,EAAE,6DAA6D;KACjF;CACO,CAAA"}

package/dist/hooks/non-interactive-env/detector.d.ts

@@ -0,0 +1,2 @@
+export declare function isNonInteractive(): boolean;
+//# sourceMappingURL=detector.d.ts.map

package/dist/hooks/non-interactive-env/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/detector.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,IAAI,OAAO,CAkB1C"}

package/dist/hooks/non-interactive-env/detector.js

@@ -0,0 +1,16 @@
+export function isNonInteractive() {
+    if (process.env.CI === "true" || process.env.CI === "1") {
+        return true;
+    }
+    if (process.env.CLAUDE_CODE_RUN === "true" || process.env.CLAUDE_CODE_NON_INTERACTIVE === "true") {
+        return true;
+    }
+    if (process.env.GITHUB_ACTIONS === "true") {
+        return true;
+    }
+    if (process.stdout.isTTY !== true) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=detector.js.map

package/dist/hooks/non-interactive-env/detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/detector.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB;IAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC;QACxD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM,EAAE,CAAC;QACjG,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/hooks/non-interactive-env/index.d.ts

@@ -0,0 +1,14 @@
+import type { ShellHook } from "./types.js";
+export * from "./constants.js";
+export * from "./detector.js";
+export * from "./types.js";
+/**
+ * Non-interactive environment hook for Claude Code.
+ *
+ * Detects and handles non-interactive environments (CI, cron, etc.) by:
+ * - Warning about banned interactive commands (vim, less, etc.)
+ * - Injecting environment variables to prevent git/tools from prompting
+ * - Prepending export statements to git commands to block editors/pagers
+ */
+export declare const nonInteractiveEnvHook: ShellHook;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/non-interactive-env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAG3C,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AA2C1B;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAwBnC,CAAA"}

package/dist/hooks/non-interactive-env/index.js

@@ -0,0 +1,72 @@
+import { HOOK_NAME, NON_INTERACTIVE_ENV, SHELL_COMMAND_PATTERNS } from "./constants.js";
+export * from "./constants.js";
+export * from "./detector.js";
+export * from "./types.js";
+const BANNED_COMMAND_PATTERNS = SHELL_COMMAND_PATTERNS.banned
+    .filter((cmd) => !cmd.includes("("))
+    .map((cmd) => new RegExp(`\\b${cmd}\\b`));
+function detectBannedCommand(command) {
+    for (let i = 0; i < BANNED_COMMAND_PATTERNS.length; i++) {
+        if (BANNED_COMMAND_PATTERNS[i].test(command)) {
+            return SHELL_COMMAND_PATTERNS.banned[i];
+        }
+    }
+    return undefined;
+}
+/**
+ * Shell-escape a value for use in VAR=value prefix.
+ * Wraps in single quotes if contains special chars.
+ */
+function shellEscape(value) {
+    // Empty string needs quotes
+    if (value === "")
+        return "''";
+    // If contains special chars, wrap in single quotes (escape existing single quotes)
+    if (/[^a-zA-Z0-9_\-.:\/]/.test(value)) {
+        return `'${value.replace(/'/g, "'\\''")}'`;
+    }
+    return value;
+}
+/**
+ * Build export statement for environment variables.
+ * Uses `export VAR1=val1 VAR2=val2;` format to ensure variables
+ * apply to ALL commands in a chain (e.g., `cmd1 && cmd2`).
+ *
+ * Previous approach used VAR=value prefix which only applies to the first command.
+ */
+function buildEnvPrefix(env) {
+    const exports = Object.entries(env)
+        .map(([key, value]) => `${key}=${shellEscape(value)}`)
+        .join(" ");
+    return `export ${exports};`;
+}
+/**
+ * Non-interactive environment hook for Claude Code.
+ *
+ * Detects and handles non-interactive environments (CI, cron, etc.) by:
+ * - Warning about banned interactive commands (vim, less, etc.)
+ * - Injecting environment variables to prevent git/tools from prompting
+ * - Prepending export statements to git commands to block editors/pagers
+ */
+export const nonInteractiveEnvHook = {
+    name: HOOK_NAME,
+    async beforeCommand(command) {
+        // Check for banned interactive commands
+        const bannedCmd = detectBannedCommand(command);
+        const warning = bannedCmd
+            ? `Warning: '${bannedCmd}' is an interactive command that may hang in non-interactive environments.`
+            : undefined;
+        // Only prepend env vars for git commands (editor blocking, pager, etc.)
+        const isGitCommand = /\bgit\b/.test(command);
+        if (!isGitCommand) {
+            return { command, warning };
+        }
+        // Prepend export statement to command to ensure non-interactive behavior
+        // Uses `export VAR=val;` format to ensure variables apply to ALL commands
+        // in a chain (e.g., `git add file && git rebase --continue`).
+        const envPrefix = buildEnvPrefix(NON_INTERACTIVE_ENV);
+        const modifiedCommand = `${envPrefix} ${command}`;
+        return { command: modifiedCommand, warning };
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/non-interactive-env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvF,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAE1B,MAAM,uBAAuB,GAAG,sBAAsB,CAAC,MAAM;KAC1D,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;KAC3C,GAAG,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAA;AAEnD,SAAS,mBAAmB,CAAC,OAAe;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxD,IAAI,uBAAuB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACzC,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,KAAa;IAChC,4BAA4B;IAC5B,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAA;IAC7B,mFAAmF;IACnF,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAA;IAC5C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,GAA2B;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;SACrD,IAAI,CAAC,GAAG,CAAC,CAAA;IACZ,OAAO,UAAU,OAAO,GAAG,CAAA;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAc;IAC9C,IAAI,EAAE,SAAS;IAEf,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,wCAAwC;QACxC,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,OAAO,GAAG,SAAS;YACvB,CAAC,CAAC,aAAa,SAAS,4EAA4E;YACpG,CAAC,CAAC,SAAS,CAAA;QAEb,wEAAwE;QACxE,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;QAC7B,CAAC;QAED,yEAAyE;QACzE,0EAA0E;QAC1E,8DAA8D;QAC9D,MAAM,SAAS,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAA;QACrD,MAAM,eAAe,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAA;QAEjD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAA;IAC9C,CAAC;CACF,CAAA"}

package/dist/hooks/non-interactive-env/types.d.ts

@@ -0,0 +1,14 @@
+export interface NonInteractiveEnvConfig {
+    disabled?: boolean;
+}
+/**
+ * Shell hook interface for command interception
+ */
+export interface ShellHook {
+    name: string;
+    beforeCommand?(command: string): Promise<{
+        command: string;
+        warning?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/non-interactive-env/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAChF"}

package/dist/hooks/non-interactive-env/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/non-interactive-env/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hooks/non-interactive-env/types.ts"],"names":[],"mappings":""}

package/dist/hooks/preemptive-compaction/constants.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Preemptive Compaction Constants
+ *
+ * Thresholds and messages for context usage monitoring.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ */
+/**
+ * Default threshold ratio to trigger warning (85%)
+ */
+export declare const DEFAULT_THRESHOLD = 0.85;
+/**
+ * Critical threshold ratio (95%)
+ */
+export declare const CRITICAL_THRESHOLD = 0.95;
+/**
+ * Minimum tokens before considering compaction
+ */
+export declare const MIN_TOKENS_FOR_COMPACTION = 50000;
+/**
+ * Cooldown period between compaction warnings (1 minute)
+ */
+export declare const COMPACTION_COOLDOWN_MS = 60000;
+/**
+ * Maximum warnings per session before stopping
+ */
+export declare const MAX_WARNINGS = 3;
+/**
+ * Default context limits for Claude models
+ */
+export declare const CLAUDE_DEFAULT_CONTEXT_LIMIT: number;
+/**
+ * Average characters per token estimate
+ */
+export declare const CHARS_PER_TOKEN = 4;
+/**
+ * Warning message when context usage is high
+ */
+export declare const CONTEXT_WARNING_MESSAGE = "CONTEXT WINDOW WARNING - APPROACHING LIMIT\n\nYour context usage is getting high. Consider these actions to prevent hitting the limit:\n\n1. USE COMPACT COMMAND\n   - Run /compact to summarize the conversation\n   - This frees up context space while preserving important information\n\n2. BE MORE CONCISE\n   - Show only relevant code portions\n   - Use file paths instead of full code blocks\n   - Summarize instead of repeating information\n\n3. FOCUS YOUR REQUESTS\n   - Work on one task at a time\n   - Complete current tasks before starting new ones\n   - Avoid unnecessary back-and-forth\n\nCurrent Status: Context usage is high but recoverable.\nAction recommended: Use /compact when convenient.\n";
+/**
+ * Critical warning message when context is almost full
+ */
+export declare const CONTEXT_CRITICAL_MESSAGE = "CRITICAL: CONTEXT WINDOW ALMOST FULL\n\nYour context usage is critically high. Immediate action required:\n\n1. COMPACT NOW\n   - Run /compact immediately to summarize the conversation\n   - Without compaction, the next few messages may fail\n\n2. AVOID LARGE OUTPUTS\n   - Do not show full files\n   - Use summaries instead of detailed outputs\n   - Be as concise as possible\n\n3. PREPARE FOR SESSION HANDOFF\n   - If compaction doesn't help enough, prepare to continue in a new session\n   - Note your current progress and next steps\n\nWARNING: Further messages may fail if context is not reduced.\nAction required: Run /compact now.\n";
+/**
+ * Message when compaction was successful
+ */
+export declare const COMPACTION_SUCCESS_MESSAGE = "Context compacted successfully. Session can continue normally.";
+//# sourceMappingURL=constants.d.ts.map

package/dist/hooks/preemptive-compaction/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,4BAA4B,QAI5B,CAAC;AAEd;;GAEG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC;;GAEG;AACH,eAAO,MAAM,uBAAuB,qsBAoBnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,ooBAmBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,mEAAmE,CAAC"}

package/dist/hooks/preemptive-compaction/constants.js

@@ -0,0 +1,90 @@
+/**
+ * Preemptive Compaction Constants
+ *
+ * Thresholds and messages for context usage monitoring.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ */
+/**
+ * Default threshold ratio to trigger warning (85%)
+ */
+export const DEFAULT_THRESHOLD = 0.85;
+/**
+ * Critical threshold ratio (95%)
+ */
+export const CRITICAL_THRESHOLD = 0.95;
+/**
+ * Minimum tokens before considering compaction
+ */
+export const MIN_TOKENS_FOR_COMPACTION = 50_000;
+/**
+ * Cooldown period between compaction warnings (1 minute)
+ */
+export const COMPACTION_COOLDOWN_MS = 60_000;
+/**
+ * Maximum warnings per session before stopping
+ */
+export const MAX_WARNINGS = 3;
+/**
+ * Default context limits for Claude models
+ */
+export const CLAUDE_DEFAULT_CONTEXT_LIMIT = process.env.ANTHROPIC_1M_CONTEXT === 'true' ||
+    process.env.VERTEX_ANTHROPIC_1M_CONTEXT === 'true'
+    ? 1_000_000
+    : 200_000;
+/**
+ * Average characters per token estimate
+ */
+export const CHARS_PER_TOKEN = 4;
+/**
+ * Warning message when context usage is high
+ */
+export const CONTEXT_WARNING_MESSAGE = `CONTEXT WINDOW WARNING - APPROACHING LIMIT
+
+Your context usage is getting high. Consider these actions to prevent hitting the limit:
+
+1. USE COMPACT COMMAND
+   - Run /compact to summarize the conversation
+   - This frees up context space while preserving important information
+
+2. BE MORE CONCISE
+   - Show only relevant code portions
+   - Use file paths instead of full code blocks
+   - Summarize instead of repeating information
+
+3. FOCUS YOUR REQUESTS
+   - Work on one task at a time
+   - Complete current tasks before starting new ones
+   - Avoid unnecessary back-and-forth
+
+Current Status: Context usage is high but recoverable.
+Action recommended: Use /compact when convenient.
+`;
+/**
+ * Critical warning message when context is almost full
+ */
+export const CONTEXT_CRITICAL_MESSAGE = `CRITICAL: CONTEXT WINDOW ALMOST FULL
+
+Your context usage is critically high. Immediate action required:
+
+1. COMPACT NOW
+   - Run /compact immediately to summarize the conversation
+   - Without compaction, the next few messages may fail
+
+2. AVOID LARGE OUTPUTS
+   - Do not show full files
+   - Use summaries instead of detailed outputs
+   - Be as concise as possible
+
+3. PREPARE FOR SESSION HANDOFF
+   - If compaction doesn't help enough, prepare to continue in a new session
+   - Note your current progress and next steps
+
+WARNING: Further messages may fail if context is not reduced.
+Action required: Run /compact now.
+`;
+/**
+ * Message when compaction was successful
+ */
+export const COMPACTION_SUCCESS_MESSAGE = `Context compacted successfully. Session can continue normally.`;
+//# sourceMappingURL=constants.js.map

package/dist/hooks/preemptive-compaction/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;IAC3C,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,MAAM;IAChD,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,OAAO,CAAC;AAEd;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBtC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;;;;;;;CAmBvC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,gEAAgE,CAAC"}

package/dist/hooks/preemptive-compaction/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Preemptive Compaction Hook
+ *
+ * Monitors context usage and warns before hitting the context limit.
+ * Encourages proactive compaction to prevent context overflow.
+ *
+ * Adapted from oh-my-opencode's preemptive-compaction hook.
+ *
+ * Note: This is a simplified version for Claude Code's shell hook system.
+ * The original uses OpenCode's plugin event system for automatic summarization.
+ * This version injects warning messages to prompt manual compaction.
+ */
+import type { ContextUsageResult, PreemptiveCompactionConfig } from './types.js';
+/**
+ * Estimate tokens from text content
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Analyze context usage based on conversation content
+ */
+export declare function analyzeContextUsage(content: string, config?: PreemptiveCompactionConfig): ContextUsageResult;
+/**
+ * Create preemptive compaction hook
+ *
+ * This hook monitors context usage and injects warning messages
+ * when approaching the context limit.
+ */
+export declare function createPreemptiveCompactionHook(config?: PreemptiveCompactionConfig): {
+    /**
+     * PostToolUse - Check context usage after large tool outputs
+     */
+    postToolUse: (input: {
+        tool_name: string;
+        session_id: string;
+        tool_input: Record<string, unknown>;
+        tool_response?: string;
+    }) => string | null;
+    /**
+     * Stop event - Check context before stopping
+     */
+    stop: (input: {
+        session_id: string;
+    }) => string | null;
+};
+/**
+ * Get estimated token usage for a session
+ */
+export declare function getSessionTokenEstimate(sessionId: string): number;
+/**
+ * Reset token estimate for a session (e.g., after compaction)
+ */
+export declare function resetSessionTokenEstimate(sessionId: string): void;
+export type { PreemptiveCompactionState, TokenInfo, ModelLimits, ContextUsageResult, PreemptiveCompactionConfig, } from './types.js';
+export { DEFAULT_THRESHOLD, CRITICAL_THRESHOLD, MIN_TOKENS_FOR_COMPACTION, COMPACTION_COOLDOWN_MS, MAX_WARNINGS, CLAUDE_DEFAULT_CONTEXT_LIMIT, CHARS_PER_TOKEN, CONTEXT_WARNING_MESSAGE, CONTEXT_CRITICAL_MESSAGE, COMPACTION_SUCCESS_MESSAGE, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/preemptive-compaction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/preemptive-compaction/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAkBH,OAAO,KAAK,EAIV,kBAAkB,EAClB,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAyDpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,0BAA0B,GAClC,kBAAkB,CAyBpB;AA+DD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,CAAC,EAAE,0BAA0B;IAiBjC;;OAEG;yBACkB;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,KAAG,MAAM,GAAG,IAAI;IAwDjB;;OAEG;kBACW;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,KAAG,MAAM,GAAG,IAAI;EAevD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAOjE;AAGD,YAAY,EACV,yBAAyB,EACzB,SAAS,EACT,WAAW,EACX,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,EACZ,4BAA4B,EAC5B,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC"}