memhook 0.2.2 → 0.4.0

package/dist/bin/memhook.js

@@ -1,23 +1,35 @@
 #!/usr/bin/env node
 /**
- * memhook CLI — three commands shipped in v0.1 preview:
+ * memhook CLI.
  *
  *   memhook run            Read stdin (Claude Code hook JSON), write hook output
  *   memhook build-catalog  Rebuild ~/.claude/cache/memory-catalog.txt
+ *   memhook init           Wire memhook into ~/.claude/settings.json (interactive)
+ *   memhook uninstall      Remove memhook's hooks from ~/.claude/settings.json
+ *   memhook tail           Pretty live view of the JSONL routing log
  *   memhook version        Print package version
  *
- * Designed to be wired into ~/.claude/settings.json hooks:
- *   "UserPromptSubmit": [{ "hooks": [{ "type": "command",
- *                                      "command": "memhook run" }] }]
- *   "SessionStart":     [{ "hooks": [{ "type": "command",
- *                                      "command": "memhook build-catalog" }] }]
+ * Only `run` obeys the fail-soft hook contract (never throws, never exits
+ * non-zero). The interactive commands (`init`/`uninstall`/`tail`) may exit
+ * non-zero on user error and are free to use the TTY — docs/SPECIFICATION.md §9.
+ *
+ * Wired into ~/.claude/settings.json hooks (see `memhook init`):
+ *   "UserPromptSubmit": [{ "hooks": [{ "type": "command", "command": "memhook run" }] }]
+ *   "SessionStart":     [{ "hooks": [{ "type": "command", "command": "memhook build-catalog" }] }]
  */
 import { route } from "../src/router.js";
 import { buildCatalog } from "../src/catalog.js";
 import { loadConfig } from "../src/config.js";
+import { runInit, runUninstall } from "../src/init.js";
+import { runTail } from "../src/tail.js";
+import { runSkills } from "../src/skillsCmd.js";
+import { isCompanionSkill } from "../src/skills.js";
 import { MEMHOOK_VERSION as VERSION } from "../src/version.js";
+const PROVIDERS = ["anthropic", "openai", "ollama"];
+const SKILLS_SUBCOMMANDS = ["install", "uninstall", "list"];
 async function main() {
     const cmd = process.argv[2] ?? "help";
+    const args = process.argv.slice(3);
     switch (cmd) {
         case "run":
             await cmdRun();
@@ -25,6 +37,18 @@ async function main() {
         case "build-catalog":
             cmdBuildCatalog();
             break;
+        case "init":
+            process.exitCode = await cmdInit(args);
+            break;
+        case "uninstall":
+            process.exitCode = await cmdUninstall(args);
+            break;
+        case "tail":
+            process.exitCode = await cmdTail(args);
+            break;
+        case "skills":
+            process.exitCode = await cmdSkills(args);
+            break;
         case "version":
         case "--version":
         case "-v":
@@ -42,19 +66,20 @@ async function main() {
     }
 }
 async function cmdRun() {
-    const stdin = await readStdin();
-    let output;
+    // Fail-soft: read stdin AND route inside one try, so ANY error — a stdin
+    // read error (stdin 'error' event) just as much as a routing error — falls
+    // back to empty additionalContext and exit 0, never a non-zero exit that
+    // would block the user prompt.
+    let output = {
+        hookSpecificOutput: {
+            hookEventName: "UserPromptSubmit",
+            additionalContext: "",
+        },
+    };
     try {
-        output = await route(stdin);
+        output = await route(await readStdin());
     }
     catch (err) {
-        // Fail-soft: emit empty additionalContext, never block the user prompt
-        output = {
-            hookSpecificOutput: {
-                hookEventName: "UserPromptSubmit",
-                additionalContext: "",
-            },
-        };
         if (process.env["MEMHOOK_DEBUG"] === "true") {
             process.stderr.write(`memhook run error: ${String(err)}\n`);
         }
@@ -69,6 +94,130 @@ function cmdBuildCatalog() {
     });
     process.stderr.write(`[memhook build-catalog] ${config.catalog.path} — ${result.lines}L, ${result.bytes}B\n`);
 }
+async function cmdInit(args) {
+    const { flags } = parseArgs(args, BOOL_INIT);
+    let provider;
+    if (typeof flags["provider"] === "string") {
+        if (!PROVIDERS.includes(flags["provider"])) {
+            process.stderr.write(`memhook init: unknown provider "${flags["provider"]}"\n`);
+            return 1;
+        }
+        provider = flags["provider"];
+    }
+    let skills;
+    if (flags["no-skills"] === true)
+        skills = false;
+    else if (flags["skills"] === true)
+        skills = true;
+    return runInit({
+        yes: flags["yes"] === true,
+        dryRun: flags["dry-run"] === true,
+        provider,
+        apiKeyEnv: strFlag(flags["api-key-env"]),
+        model: strFlag(flags["model"]),
+        bin: strFlag(flags["bin"]) ?? "memhook",
+        settingsPath: strFlag(flags["settings"]),
+        noCatalog: flags["no-catalog"] === true,
+        skills,
+    });
+}
+async function cmdSkills(args) {
+    const { flags, positionals } = parseArgs(args, BOOL_SKILLS);
+    const sub = positionals[0] ?? "list";
+    if (!SKILLS_SUBCOMMANDS.includes(sub)) {
+        process.stderr.write(`memhook skills: unknown subcommand "${sub}" (install | uninstall | list)\n`);
+        return 1;
+    }
+    const names = [];
+    for (const n of positionals.slice(1)) {
+        if (!isCompanionSkill(n)) {
+            process.stderr.write(`memhook skills: unknown skill "${n}" (wrap | curate | relay)\n`);
+            return 1;
+        }
+        names.push(n);
+    }
+    return runSkills({
+        subcommand: sub,
+        names: names.length > 0 ? names : undefined,
+        yes: flags["yes"] === true,
+        dryRun: flags["dry-run"] === true,
+        force: flags["force"] === true,
+    });
+}
+async function cmdUninstall(args) {
+    const { flags } = parseArgs(args, BOOL_UNINSTALL);
+    return runUninstall({
+        yes: flags["yes"] === true,
+        dryRun: flags["dry-run"] === true,
+        settingsPath: strFlag(flags["settings"]),
+        purge: flags["purge"] === true,
+    });
+}
+async function cmdTail(args) {
+    const { flags } = parseArgs(args, BOOL_TAIL);
+    const linesRaw = strFlag(flags["lines"]);
+    const lines = linesRaw !== undefined && /^\d+$/.test(linesRaw) ? Number(linesRaw) : 10;
+    const statusRaw = strFlag(flags["status"]);
+    const status = statusRaw
+        ? statusRaw
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : undefined;
+    return runTail({
+        file: strFlag(flags["file"]),
+        lines,
+        noFollow: flags["no-follow"] === true,
+        status,
+    });
+}
+// ── tiny flag parser ─────────────────────────────────────────────────────────
+const BOOL_INIT = new Set(["yes", "dry-run", "no-catalog", "skills", "no-skills"]);
+const BOOL_UNINSTALL = new Set(["yes", "dry-run", "purge"]);
+const BOOL_TAIL = new Set(["no-follow"]);
+const BOOL_SKILLS = new Set(["yes", "dry-run", "force"]);
+const SHORT = { "-y": "--yes", "-n": "--lines" };
+function strFlag(v) {
+    return typeof v === "string" ? v : undefined;
+}
+/**
+ * Parse `--key value`, `--key=value`, and boolean flags (those listed in
+ * `bools`, plus any `--key` not followed by a value). Unknown long flags that
+ * take a value consume the next non-dash token.
+ */
+function parseArgs(args, bools) {
+    const flags = {};
+    const positionals = [];
+    for (let i = 0; i < args.length; i++) {
+        const raw = args[i];
+        if (raw === undefined)
+            continue;
+        const a = SHORT[raw] ?? raw;
+        if (!a.startsWith("--")) {
+            positionals.push(a);
+            continue;
+        }
+        const key = a.slice(2);
+        const eq = key.indexOf("=");
+        if (eq >= 0) {
+            flags[key.slice(0, eq)] = key.slice(eq + 1);
+            continue;
+        }
+        if (bools.has(key)) {
+            flags[key] = true;
+            continue;
+        }
+        const next = args[i + 1];
+        if (next !== undefined && !next.startsWith("-")) {
+            flags[key] = next;
+            i++;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    return { flags, positionals };
+}
 function readStdin() {
     return new Promise((resolve, reject) => {
         let data = "";
@@ -82,30 +231,68 @@ function printHelp() {
     console.log(`memhook ${VERSION}
 
 USAGE
-  memhook <command>
+  memhook <command> [options]
 
 COMMANDS
   run                Read Claude Code hook JSON from stdin, emit additionalContext
   build-catalog      Rebuild the memory catalog at $MEMHOOK_CATALOG_PATH
+  init               Wire memhook into ~/.claude/settings.json (with backup)
+  uninstall          Remove memhook's hooks from ~/.claude/settings.json
+  tail               Pretty live view of the routing log (status, latency, memories)
+  skills             Install/uninstall/list companion skills (/wrap /curate /relay)
   version            Print version
   help               Show this message
 
+init OPTIONS
+  --provider <p>     anthropic | openai | ollama (else prompted; default anthropic)
+  --api-key-env <n>  env var holding the API key (default per provider)
+  --model <m>        override the model id
+  --bin <name>       command written into settings.json (default: memhook)
+  --settings <path>  settings file to patch (default: ~/.claude/settings.json)
+  --no-catalog       skip the initial catalog build
+  --skills           install companion skills (default: ask / yes in --yes mode)
+  --no-skills        skip installing companion skills
+  --dry-run          print the plan, write nothing
+  -y, --yes          non-interactive (accept defaults / flags)
+
+uninstall OPTIONS
+  --settings <path>  settings file to patch (default: ~/.claude/settings.json)
+  --dry-run          print the plan, write nothing
+  -y, --yes          non-interactive
+  --purge            also report cache + log locations to clean up
+
+tail OPTIONS
+  -n, --lines <N>    history lines to show before following (default: 10)
+  --no-follow        print the recent log + summary, then exit (no live follow)
+  --status <a,b>     only show these statuses (e.g. ok,cache_hit)
+  --file <path>      log file to read (default: $MEMHOOK_LOG_PATH)
+
+skills SUBCOMMANDS
+  install [names…]   copy /wrap /curate /relay into ~/.claude/skills (default: all)
+  uninstall [names…] remove the bundled companion skills (backs up first)
+  list               show each skill's install status
+  --force            overwrite a skill that differs from shipped (backs up first)
+  --dry-run          print the plan, write nothing
+  -y, --yes          non-interactive (accept defaults)
+
 ENV VARS
   MEMHOOK_ENABLED                 toggle (default: true)
   MEMHOOK_PROVIDER                anthropic | openai | ollama (default: anthropic)
   MEMHOOK_MODEL                   model id (per-provider default if unset)
   MEMHOOK_API_KEY_ENV             env var name holding the API key
-                                  (anthropic: ANTHROPIC_API_KEY, openai: OPENAI_API_KEY,
-                                   ollama: none required)
   MEMHOOK_BASE_URL                override the provider API endpoint
   MEMHOOK_CONFIG                  path to a YAML config file
-                                  (default: ~/.config/memhook/config.yaml)
+  MEMHOOK_LOG_PATH                JSONL log path (read by 'memhook tail')
   MEMHOOK_MAX_FILES               file-count cap (default: 5)
   MEMHOOK_MAX_ADDITIONAL_CHARS    injection size cap (default: 9500)
-  MEMHOOK_MAX_OUTPUT_TOKENS       model output cap (default: 200)
   MEMHOOK_TIMEOUT_MS              request timeout (default: 8000; ollama: 30000)
   MEMHOOK_DISABLE_CACHE=true      skip local LRU cache
   MEMHOOK_DISABLE_PREFILTER=true  skip trivial-prompt skip
+  MEMHOOK_CURATE_NUDGE            /curate-nudge toggle (default: true)
+  MEMHOOK_CURATE_NUDGE_TOKENS     catalog-token threshold to nudge (default: 15000)
+  MEMHOOK_CURATE_NUDGE_FILES      memory-file-count threshold to nudge (default: 250)
+  MEMHOOK_CURATE_NUDGE_COOLDOWN_DAYS  min days between nudges (default: 7)
+  NO_COLOR / MEMHOOK_NO_COLOR     disable colour in init/tail output
   MEMHOOK_DEBUG=true              print errors to stderr (default: silent fail-soft)
 
 PROVIDERS

package/dist/bin/memhook.js.map

@@ -1 +1 @@
-{"version":3,"file":"memhook.js","sourceRoot":"","sources":["../../bin/memhook.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"memhook.js","sourceRoot":"","sources":["../../bin/memhook.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAyB,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpD,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAE5D,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACtC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,KAAK;YACR,MAAM,MAAM,EAAE,CAAC;YACf,MAAM;QACR,KAAK,eAAe;YAClB,eAAe,EAAE,CAAC;YAClB,MAAM;QACR,KAAK,MAAM;YACT,OAAO,CAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM;QACR,KAAK,WAAW;YACd,OAAO,CAAC,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM;QACR,KAAK,MAAM;YACT,OAAO,CAAC,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM;QACR,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,SAAS,EAAE,CAAC;YACZ,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,6BAA6B,GAAG,GAAG,CAAC,CAAC;YACnD,SAAS,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM;IACnB,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,+BAA+B;IAC/B,IAAI,MAAM,GAAG;QACX,kBAAkB,EAAE;YAClB,aAAa,EAAE,kBAA2B;YAC1C,iBAAiB,EAAE,EAAE;SACtB;KACF,CAAC;IACF,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,EAAE,CAAC;YAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,eAAe;IACtB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;KAChC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,2BAA2B,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,MAAM,CAAC,KAAK,MAAM,MAAM,CAAC,KAAK,KAAK,CACxF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAc;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,QAAkC,CAAC;IACvC,IAAI,OAAO,KAAK,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAChF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAiB,CAAC;IAC/C,CAAC;IACD,IAAI,MAA2B,CAAC;IAChC,IAAI,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI;QAAE,MAAM,GAAG,KAAK,CAAC;SAC3C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI;QAAE,MAAM,GAAG,IAAI,CAAC;IACjD,OAAO,OAAO,CAAC;QACb,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI;QACjC,QAAQ;QACR,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,SAAS;QACvC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxC,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI;QACvC,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAAc;IACrC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACrC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,uCAAuC,GAAG,kCAAkC,CAC7E,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,CAAC,6BAA6B,CAAC,CAAC;YACvF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;QACf,UAAU,EAAE,GAAuB;QACnC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC3C,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI;QACjC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAc;IACxC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC;QAClB,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI;QACjC,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACxC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI;KAC/B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAc;IACnC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,SAAS;QACtB,CAAC,CAAC,SAAS;aACN,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IACd,OAAO,OAAO,CAAC;QACb,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK,IAAI;QACrC,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAEhF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AACnF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAC5D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AACzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzD,MAAM,KAAK,GAA2B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAEzE,SAAS,OAAO,CAAC,CAA+B;IAC9C,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,SAAS,SAAS,CAChB,IAAc,EACd,KAAkB;IAElB,MAAM,KAAK,GAAqC,EAAE,CAAC;IACnD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YAClB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwE/B,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/ansi.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Zero-dependency ANSI styling for the interactive CLI commands
+ * (`memhook init`, `memhook tail`).
+ *
+ * This module is NOT used by the hook entrypoint (`memhook run`) — the hook's
+ * stdout is reserved for the JSON envelope and must stay byte-clean. Colour is
+ * only ever emitted to a human-facing TTY.
+ *
+ * Colour is disabled (every styler becomes the identity function) when:
+ *   - `NO_COLOR` is set (any value) — https://no-color.org/
+ *   - `MEMHOOK_NO_COLOR` is set (memhook-specific opt-out)
+ *   - `TERM=dumb`
+ *   - the target stream is not a TTY (piped to a file / another process)
+ * `FORCE_COLOR` (any value) overrides all of the above and forces colour on,
+ * which is what the test-suite and `| less -R` rely on.
+ */
+export interface AnsiOptions {
+    /** Whether the destination is an interactive terminal. */
+    isTTY: boolean;
+    env: NodeJS.ProcessEnv;
+}
+/** Decide once whether colour should be emitted for a given stream + env. */
+export declare function colorEnabled({ isTTY, env }: AnsiOptions): boolean;
+/** SGR codes used by the CLI. Kept tiny on purpose. */
+declare const CODES: {
+    readonly bold: 1;
+    readonly dim: 2;
+    readonly italic: 3;
+    readonly underline: 4;
+    readonly red: 31;
+    readonly green: 32;
+    readonly yellow: 33;
+    readonly blue: 34;
+    readonly magenta: 35;
+    readonly cyan: 36;
+    readonly white: 37;
+    readonly gray: 90;
+    readonly brightGreen: 92;
+    readonly brightCyan: 96;
+};
+export type AnsiColor = keyof typeof CODES;
+export interface Ansi {
+    readonly enabled: boolean;
+    /** Wrap `s` in the SGR code for `name`, or return it untouched if disabled. */
+    style(name: AnsiColor, s: string): string;
+    bold(s: string): string;
+    dim(s: string): string;
+    red(s: string): string;
+    green(s: string): string;
+    yellow(s: string): string;
+    cyan(s: string): string;
+    gray(s: string): string;
+}
+/**
+ * Build an `Ansi` styler. When colour is disabled every method is the identity
+ * function, so call-sites never branch on `enabled` themselves.
+ */
+export declare function makeAnsi(opts: AnsiOptions): Ansi;
+/**
+ * Visible width of a string with ANSI escapes stripped — used to pad/align
+ * columns correctly even when the cell contains colour codes.
+ */
+export declare function visibleWidth(s: string): number;
+/** Left-pad `s` to `width` visible columns (right-align). */
+export declare function padStart(s: string, width: number): string;
+/** Right-pad `s` to `width` visible columns (left-align). */
+export declare function padEnd(s: string, width: number): string;
+/** Truncate to `max` chars, appending `…` when cut. Callers pass plain text. */
+export declare function truncate(s: string, max: number): string;
+export {};
+//# sourceMappingURL=ansi.d.ts.map

package/dist/src/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../../src/ansi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAWH,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,WAAW,GAAG,OAAO,CAMjE;AAED,uDAAuD;AACvD,QAAA,MAAM,KAAK;;;;;;;;;;;;;;;CAeD,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAC;AAE3C,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1C,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAehD;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,6DAA6D;AAC7D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/dist/src/ansi.js

@@ -0,0 +1,100 @@
+/**
+ * Zero-dependency ANSI styling for the interactive CLI commands
+ * (`memhook init`, `memhook tail`).
+ *
+ * This module is NOT used by the hook entrypoint (`memhook run`) — the hook's
+ * stdout is reserved for the JSON envelope and must stay byte-clean. Colour is
+ * only ever emitted to a human-facing TTY.
+ *
+ * Colour is disabled (every styler becomes the identity function) when:
+ *   - `NO_COLOR` is set (any value) — https://no-color.org/
+ *   - `MEMHOOK_NO_COLOR` is set (memhook-specific opt-out)
+ *   - `TERM=dumb`
+ *   - the target stream is not a TTY (piped to a file / another process)
+ * `FORCE_COLOR` (any value) overrides all of the above and forces colour on,
+ * which is what the test-suite and `| less -R` rely on.
+ */
+/**
+ * The ANSI escape introducer (0x1b). Built from a char code so the source file
+ * stays printable ASCII — no raw control byte to be mangled by an editor,
+ * `git`, or a copy/paste.
+ */
+const ESC = String.fromCharCode(27);
+const CSI = `${ESC}[`;
+const RESET = `${CSI}0m`;
+/** Decide once whether colour should be emitted for a given stream + env. */
+export function colorEnabled({ isTTY, env }) {
+    if (env["FORCE_COLOR"] !== undefined && env["FORCE_COLOR"] !== "")
+        return true;
+    if (env["NO_COLOR"] !== undefined)
+        return false;
+    if (env["MEMHOOK_NO_COLOR"] !== undefined)
+        return false;
+    if (env["TERM"] === "dumb")
+        return false;
+    return isTTY;
+}
+/** SGR codes used by the CLI. Kept tiny on purpose. */
+const CODES = {
+    bold: 1,
+    dim: 2,
+    italic: 3,
+    underline: 4,
+    red: 31,
+    green: 32,
+    yellow: 33,
+    blue: 34,
+    magenta: 35,
+    cyan: 36,
+    white: 37,
+    gray: 90,
+    brightGreen: 92,
+    brightCyan: 96,
+};
+/**
+ * Build an `Ansi` styler. When colour is disabled every method is the identity
+ * function, so call-sites never branch on `enabled` themselves.
+ */
+export function makeAnsi(opts) {
+    const enabled = colorEnabled(opts);
+    const wrap = (name, s) => enabled ? `${CSI}${CODES[name]}m${s}${RESET}` : s;
+    return {
+        enabled,
+        style: wrap,
+        bold: (s) => wrap("bold", s),
+        dim: (s) => wrap("dim", s),
+        red: (s) => wrap("red", s),
+        green: (s) => wrap("green", s),
+        yellow: (s) => wrap("yellow", s),
+        cyan: (s) => wrap("cyan", s),
+        gray: (s) => wrap("gray", s),
+    };
+}
+/** Matches any SGR escape sequence, e.g. "ESC[32m" or "ESC[0m". */
+const SGR_RE = new RegExp(`${ESC}\\[[0-9;]*m`, "g");
+/**
+ * Visible width of a string with ANSI escapes stripped — used to pad/align
+ * columns correctly even when the cell contains colour codes.
+ */
+export function visibleWidth(s) {
+    return s.replace(SGR_RE, "").length;
+}
+/** Left-pad `s` to `width` visible columns (right-align). */
+export function padStart(s, width) {
+    const gap = width - visibleWidth(s);
+    return gap > 0 ? " ".repeat(gap) + s : s;
+}
+/** Right-pad `s` to `width` visible columns (left-align). */
+export function padEnd(s, width) {
+    const gap = width - visibleWidth(s);
+    return gap > 0 ? s + " ".repeat(gap) : s;
+}
+/** Truncate to `max` chars, appending `…` when cut. Callers pass plain text. */
+export function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    if (max <= 1)
+        return s.slice(0, max);
+    return s.slice(0, max - 1) + "…";
+}
+//# sourceMappingURL=ansi.js.map

package/dist/src/ansi.js.map

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

package/dist/src/backup.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tiny shared backup helpers for the interactive commands (init / uninstall /
+ * skills). Extracted so both `init.ts` and `skillsCmd.ts` can use them without
+ * importing each other (which would create a module cycle).
+ */
+/** A backup path next to `path`, stamped so successive runs never collide. */
+export declare function backupPath(path: string, stamp: string): string;
+/** A filesystem-safe ISO-ish timestamp for backup filenames. */
+export declare function stampNow(): string;
+//# sourceMappingURL=backup.d.ts.map

package/dist/src/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,IAAI,MAAM,CAKjC"}

package/dist/src/backup.js

@@ -0,0 +1,17 @@
+/**
+ * Tiny shared backup helpers for the interactive commands (init / uninstall /
+ * skills). Extracted so both `init.ts` and `skillsCmd.ts` can use them without
+ * importing each other (which would create a module cycle).
+ */
+/** A backup path next to `path`, stamped so successive runs never collide. */
+export function backupPath(path, stamp) {
+    return `${path}.bak-${stamp}`;
+}
+/** A filesystem-safe ISO-ish timestamp for backup filenames. */
+export function stampNow() {
+    return new Date()
+        .toISOString()
+        .replace(/[:.]/g, "-")
+        .replace(/-(\d{3})Z$/, "Z");
+}
+//# sourceMappingURL=backup.js.map

package/dist/src/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAa;IACpD,OAAO,GAAG,IAAI,QAAQ,KAAK,EAAE,CAAC;AAChC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,QAAQ;IACtB,OAAO,IAAI,IAAI,EAAE;SACd,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM;IAKvC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAKjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAiB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,UAAU,IAAI,MAAM;CAwBrB"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM;IAKvC,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAKjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAuB/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,UAAU,IAAI,MAAM;CAwBrB"}

package/dist/src/cache.js

@@ -10,7 +10,7 @@
  * filesystem mtime check.
  */
 import { createHash } from "node:crypto";
-import { mkdirSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { closeSync, fstatSync, mkdirSync, openSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
 import { join } from "node:path";
 export class LocalCache {
     dir;
@@ -28,22 +28,29 @@ export class LocalCache {
     }
     get(key) {
         const file = join(this.dir, `${key}.json`);
-        let stat;
+        // Open once, then `fstat` (for the TTL check) and read from the SAME fd.
+        // A single handle — rather than statSync-then-readFileSync on the path —
+        // closes a check-then-use window (CodeQL js/file-system-race). Any failure
+        // (missing, unreadable, vanished mid-read) is treated as a cache miss.
+        let fd;
         try {
-            stat = statSync(file);
+            fd = openSync(file, "r");
         }
         catch {
             return null;
         }
-        const ageMs = Date.now() - stat.mtimeMs;
-        if (ageMs > this.ttlMin * 60_000)
-            return null;
         try {
-            return readFileSync(file, "utf8");
+            const ageMs = Date.now() - fstatSync(fd).mtimeMs;
+            if (ageMs > this.ttlMin * 60_000)
+                return null;
+            return readFileSync(fd, "utf8");
         }
         catch {
             return null;
         }
+        finally {
+            closeSync(fd);
+        }
     }
     put(key, value) {
         const file = join(this.dir, `${key}.json`);

package/dist/src/cache.js.map

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

package/dist/src/config.d.ts

@@ -54,6 +54,17 @@ export interface MemhookConfig {
     logging: {
         jsonlPath: string;
     };
+    /**
+     * Optional proactive nudge: when the memory catalog grows past a threshold,
+     * the router attaches a one-line `systemMessage` suggesting `/curate`. This
+     * is local-only (no outbound call) and best-effort (never affects fail-soft).
+     */
+    curateNudge: {
+        enabled: boolean;
+        thresholdTokens: number;
+        thresholdFiles: number;
+        cooldownDays: number;
+    };
     scriptVersion: string;
 }
 export declare function loadConfig(env?: NodeJS.ProcessEnv): MemhookConfig;

package/dist/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,2EAA2E;QAC3E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,yEAAyE;QACzE,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,oEAAoE;QACpE,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACvB;AAuDD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAyI9E"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,YAAY,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,2EAA2E;QAC3E,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,yEAAyE;QACzE,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IACF,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,oEAAoE;QACpE,eAAe,EAAE,IAAI,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;QACrC,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF;;;;OAIG;IACH,WAAW,EAAE;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;CACvB;AAuDD,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,CAmJ9E"}

package/dist/src/config.js

@@ -166,6 +166,12 @@ export function loadConfig(env = process.env) {
         logging: {
             jsonlPath: str("MEMHOOK_LOG_PATH", yaml?.logging?.jsonlPath, join(home, ".claude", "logs", "memhook.log")),
         },
+        curateNudge: {
+            enabled: bool("MEMHOOK_CURATE_NUDGE", yaml?.curateNudge?.enabled, true),
+            thresholdTokens: num("MEMHOOK_CURATE_NUDGE_TOKENS", yaml?.curateNudge?.thresholdTokens, 15000),
+            thresholdFiles: num("MEMHOOK_CURATE_NUDGE_FILES", yaml?.curateNudge?.thresholdFiles, 250),
+            cooldownDays: num("MEMHOOK_CURATE_NUDGE_COOLDOWN_DAYS", yaml?.curateNudge?.cooldownDays, 7),
+        },
         scriptVersion: MEMHOOK_VERSION,
     };
 }