memhook 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to memhook are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.1](https://github.com/utilia-ai-wox/memhook/compare/v0.4.0...v0.4.1) (2026-06-02)
+
+
+### Bug Fixes
+
+* harden parsing, packaging, and CI; expand test coverage ([#34](https://github.com/utilia-ai-wox/memhook/issues/34)) ([9c4fd7f](https://github.com/utilia-ai-wox/memhook/commit/9c4fd7f463504d25eb669d26528228e92cd8a4a9))
+
+## [0.4.0](https://github.com/utilia-ai-wox/memhook/compare/v0.3.0...v0.4.0) (2026-06-02)
+
+
+### Features
+
+* companion skills (/wrap /curate /relay) + installer + nudge ([#32](https://github.com/utilia-ai-wox/memhook/issues/32)) ([3ede75d](https://github.com/utilia-ai-wox/memhook/commit/3ede75dd94cd5383a54dd0540b34b308e649a696))
+
 ## [0.3.0](https://github.com/utilia-ai-wox/memhook/compare/v0.2.2...v0.3.0) (2026-06-02)
 
 

package/README.md

@@ -19,10 +19,6 @@ files for each prompt and injects them as `additionalContext`.
 
 </div>
 
-<!-- TODO(demo): record an asciinema of `tail -f ~/.claude/logs/memhook.log`
-     while prompting Claude Code — it shows the router picking files live.
-     Embed: [![asciicast](https://asciinema.org/a/XXXXX.svg)](https://asciinema.org/a/XXXXX) -->
-
 ## ✨ Features
 
 - 🎯 **Relevant-only injection** — a cheap model picks the 0–5 memory files that matter for _this_ prompt.
@@ -33,6 +29,7 @@ files for each prompt and injects them as `additionalContext`.
 - 🪶 **One dependency** — `yaml`, with zero sub-deps.
 - ⚡ **Cached & pre-filtered** — an LRU cache + a trivial-prompt skip keep latency near zero.
 - 🧰 **One-command setup** — `memhook init` wires the hooks (with backup); `memhook tail` shows routing live.
+- 🧩 **Companion skills** — optional `/wrap`, `/curate`, `/relay` to capture, tidy, and hand off your memory.
 
 ## 🤔 Why
 
@@ -237,6 +234,32 @@ jq -c 'select((.ts | fromdateiso8601) > (now - 7*86400)) | .status' \
 | `api_no_content`       | API returned 200 but no text                          |
 | `parse_invalid`        | Response wasn't a valid JSON array                    |
 
+## 🧩 Companion skills
+
+Routing only works well when your memory stays healthy. memhook ships three
+optional Claude Code skills for that — install them with one command:
+
+```bash
+memhook skills install      # copy them into ~/.claude/skills
+memhook skills list         # show install status
+memhook skills uninstall    # remove them (backs up any edits first)
+```
+
+`memhook init` also offers to install them.
+
+| Skill     | What it does                                                                                                                 |
+| --------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| `/wrap`   | End-of-session wrap-up — captures the session's lessons into memory + a dated journal entry. Proposes; never writes unasked. |
+| `/curate` | Memory hygiene — dedupes, fixes the `MEMORY.md` index, splits oversized files, then rebuilds the catalog.                    |
+| `/relay`  | Generates a self-contained prompt to resume work in a fresh session. Read-only.                                              |
+
+They're standalone skills, so you invoke them directly as `/wrap`, `/curate`,
+`/relay`. They are user-invoked only — Claude won't trigger them on its own.
+
+When your catalog grows large, memhook also adds a one-line reminder to run
+`/curate` (a local-only `systemMessage`, 7-day cooldown — toggle with
+`MEMHOOK_CURATE_NUDGE`).
+
 ## 🛡️ Fail-soft
 
 memhook never blocks Claude Code. On any error — missing key, network
@@ -247,9 +270,9 @@ model**, just without injected memories for that turn.
 ## 🗺️ Roadmap
 
 - `v0.2` ✅ — YAML config file, OpenAI provider, Ollama local provider (published on npm)
-- `v0.3` — `memhook init` / `memhook uninstall` setup wizard + zero-dep live monitor (`memhook tail`)
-- `v0.4` — Companion skills (`/wrap`, `/curate`, `/relay`)
-- `v1.0` — API frozen, cross-platform validated, listed on awesome-lists
+- `v0.3` ✅ — `memhook init` / `memhook uninstall` setup wizard + zero-dep live monitor (`memhook tail`)
+- `v0.4` ✅ — Companion skills (`/wrap`, `/curate`, `/relay`) + `memhook skills` installer + `/curate` nudge
+- `v1.0` — API frozen, cross-platform validated, polished docs
 
 ## 🤝 Contributing
 

package/dist/bin/memhook.d.ts

@@ -18,4 +18,3 @@
  *   "SessionStart":     [{ "hooks": [{ "type": "command", "command": "memhook build-catalog" }] }]
  */
 export {};
-//# sourceMappingURL=memhook.d.ts.map

package/dist/bin/memhook.js

@@ -22,8 +22,11 @@ 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);
@@ -43,6 +46,9 @@ async function main() {
         case "tail":
             process.exitCode = await cmdTail(args);
             break;
+        case "skills":
+            process.exitCode = await cmdSkills(args);
+            break;
         case "version":
         case "--version":
         case "-v":
@@ -98,6 +104,11 @@ async function cmdInit(args) {
         }
         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,
@@ -107,6 +118,30 @@ async function cmdInit(args) {
         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) {
@@ -137,9 +172,10 @@ async function cmdTail(args) {
     });
 }
 // ── tiny flag parser ─────────────────────────────────────────────────────────
-const BOOL_INIT = new Set(["yes", "dry-run", "no-catalog"]);
+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;
@@ -203,6 +239,7 @@ COMMANDS
   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
 
@@ -213,6 +250,8 @@ init OPTIONS
   --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)
 
@@ -228,6 +267,14 @@ tail OPTIONS
   --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)
@@ -241,6 +288,10 @@ ENV VARS
   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)
 
@@ -255,4 +306,3 @@ main().catch((err) => {
     process.stderr.write(`memhook fatal: ${String(err)}\n`);
     process.exit(1);
 });
-//# sourceMappingURL=memhook.js.map

package/dist/src/ansi.d.ts

@@ -68,4 +68,3 @@ 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.js

@@ -97,4 +97,3 @@ export function truncate(s, max) {
         return s.slice(0, max);
     return s.slice(0, max - 1) + "…";
 }
-//# sourceMappingURL=ansi.js.map

package/dist/src/backup.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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;

package/dist/src/backup.js

@@ -0,0 +1,16 @@
+/**
+ * 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");
+}

package/dist/src/cache.d.ts

@@ -27,4 +27,3 @@ export declare class LocalCache {
     put(key: string, value: string): void;
     evictStale(): number;
 }
-//# sourceMappingURL=cache.d.ts.map

package/dist/src/cache.js

@@ -84,4 +84,3 @@ export class LocalCache {
         return removed;
     }
 }
-//# sourceMappingURL=cache.js.map

package/dist/src/catalog.d.ts

@@ -17,4 +17,3 @@ export declare function buildCatalog(opts: CatalogBuildOptions): {
     lines: number;
     bytes: number;
 };
-//# sourceMappingURL=catalog.d.ts.map

package/dist/src/catalog.js

@@ -149,4 +149,3 @@ function extractDescription(file) {
         return h1[1].slice(0, 200).replace(/\s+/g, " ");
     return "";
 }
-//# sourceMappingURL=catalog.js.map

package/dist/src/config.d.ts

@@ -54,7 +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;
-//# sourceMappingURL=config.d.ts.map

package/dist/src/config.js

@@ -166,7 +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,
     };
 }
-//# sourceMappingURL=config.js.map

package/dist/src/configFile.d.ts

@@ -48,7 +48,12 @@ export interface RawConfigFile {
     logging?: {
         jsonlPath?: string;
     };
+    curateNudge?: {
+        enabled?: boolean;
+        thresholdTokens?: number;
+        thresholdFiles?: number;
+        cooldownDays?: number;
+    };
 }
 export declare function resolveConfigPath(env: NodeJS.ProcessEnv): string;
 export declare function loadYamlConfig(env: NodeJS.ProcessEnv): RawConfigFile | null;
-//# sourceMappingURL=configFile.d.ts.map

package/dist/src/configFile.js

@@ -48,4 +48,3 @@ export function loadYamlConfig(env) {
         return null;
     return parsed;
 }
-//# sourceMappingURL=configFile.js.map

package/dist/src/index.d.ts

@@ -15,10 +15,11 @@ export { MEMHOOK_VERSION } from "./version.js";
 export { createProvider } from "./providers/factory.js";
 export { addHooks, removeHooks, memhookSubcommand, MEMHOOK_HOOKS, type Settings, type HookEvent, type AddResult, type RemoveResult, } from "./install.js";
 export { runInit, runUninstall, buildConfigObject, backupPath, type InitOptions, type UninstallOptions, } from "./init.js";
+export { COMPANION_SKILLS, SKILL_FILES, isCompanionSkill, diffSkill, planInstall, planUninstall, type CompanionSkill, type SkillSources, type InstalledFiles, type SkillStatus, type InstallAction, type SkillInstallPlan, type SkillUninstallPlan, } from "./skills.js";
+export { runSkills, installCompanionSkills, bundledSkillsDir, type RunSkillsOptions, type SkillsSubcommand, type InstallSkillsOptions, type SkillInstallResult, } from "./skillsCmd.js";
 export { runTail, parseLogLine, formatRow, formatHeader, formatFooter, summarize, emptyStats, accumulate, tailLines, type LogRow, type Stats, type TailOptions, } from "./tail.js";
 export { makeAnsi, colorEnabled, visibleWidth, type Ansi, type AnsiOptions } from "./ansi.js";
 export { AnthropicProvider, type AnthropicProviderOptions } from "./providers/anthropic.js";
 export { OpenAIProvider } from "./providers/openai.js";
 export { OllamaProvider } from "./providers/ollama.js";
 export type { Provider, ProviderConfig, SelectionRequest, SelectionResponse, UsageBreakdown, } from "./providers/types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -13,11 +13,17 @@ export { LocalCache } from "./cache.js";
 export { PreFilter } from "./preFilter.js";
 export { MEMHOOK_VERSION } from "./version.js";
 export { createProvider } from "./providers/factory.js";
+// ── Internal building blocks (NOT part of the semver-stable surface) ─────────
+// The install/init/skills/tail/ansi re-exports below back the CLI and tests.
+// They are exposed for power users but may change between 0.x minor releases;
+// the stable embedding API is the core above (route, loadConfig, buildCatalog,
+// LocalCache, PreFilter, MEMHOOK_VERSION) plus the provider exports.
 export { addHooks, removeHooks, memhookSubcommand, MEMHOOK_HOOKS, } from "./install.js";
 export { runInit, runUninstall, buildConfigObject, backupPath, } from "./init.js";
+export { COMPANION_SKILLS, SKILL_FILES, isCompanionSkill, diffSkill, planInstall, planUninstall, } from "./skills.js";
+export { runSkills, installCompanionSkills, bundledSkillsDir, } from "./skillsCmd.js";
 export { runTail, parseLogLine, formatRow, formatHeader, formatFooter, summarize, emptyStats, accumulate, tailLines, } from "./tail.js";
 export { makeAnsi, colorEnabled, visibleWidth } from "./ansi.js";
 export { AnthropicProvider } from "./providers/anthropic.js";
 export { OpenAIProvider } from "./providers/openai.js";
 export { OllamaProvider } from "./providers/ollama.js";
-//# sourceMappingURL=index.js.map

package/dist/src/init.d.ts

@@ -23,6 +23,8 @@ export interface InitOptions {
     bin: string;
     settingsPath?: string | undefined;
     noCatalog?: boolean | undefined;
+    /** Tri-state: undefined = ask (interactive) or default-install; true/false force it. */
+    skills?: boolean | undefined;
 }
 export interface UninstallOptions {
     yes: boolean;
@@ -30,8 +32,7 @@ export interface UninstallOptions {
     settingsPath?: string | undefined;
     purge?: boolean | undefined;
 }
-/** A backup path next to `path`, stamped so successive runs never collide. */
-export declare function backupPath(path: string, stamp: string): string;
+export { backupPath } from "./backup.js";
 /**
  * Build the minimal YAML config object for the chosen provider — only keys that
  * differ from the built-in defaults are emitted, so the file stays small and
@@ -44,4 +45,3 @@ export declare function buildConfigObject(opts: {
 }): Record<string, unknown> | null;
 export declare function runInit(opts: InitOptions, env?: NodeJS.ProcessEnv): Promise<number>;
 export declare function runUninstall(opts: UninstallOptions, env?: NodeJS.ProcessEnv): Promise<number>;
-//# sourceMappingURL=init.d.ts.map

package/dist/src/init.js

@@ -22,22 +22,17 @@ import { addHooks, removeHooks } from "./install.js";
 import { buildCatalog } from "./catalog.js";
 import { loadConfig } from "./config.js";
 import { makeAnsi } from "./ansi.js";
+import { backupPath, stampNow } from "./backup.js";
+import { installCompanionSkills } from "./skillsCmd.js";
 const PROVIDERS = ["anthropic", "openai", "ollama"];
 const DEFAULT_KEY_ENV = {
     anthropic: "ANTHROPIC_API_KEY",
     openai: "OPENAI_API_KEY",
     ollama: undefined,
 };
-/** A backup path next to `path`, stamped so successive runs never collide. */
-export function backupPath(path, stamp) {
-    return `${path}.bak-${stamp}`;
-}
-function stampNow() {
-    return new Date()
-        .toISOString()
-        .replace(/[:.]/g, "-")
-        .replace(/-(\d{3})Z$/, "Z");
-}
+// `backupPath` / `stampNow` live in ./backup.js (shared with skillsCmd.ts);
+// re-exported here so existing importers (index.ts, tests) keep working.
+export { backupPath } from "./backup.js";
 function defaultSettingsPath() {
     return join(homedir(), ".claude", "settings.json");
 }
@@ -165,6 +160,9 @@ export async function runInit(opts, env = process.env) {
     }
     if (!opts.noCatalog)
         io.out(`  ${ansi.green("+")} build catalog`);
+    if (opts.skills !== false) {
+        io.out(`  ${ansi.green("+")} companion skills ${ansi.dim("(/wrap /curate /relay)")}`);
+    }
     // 4. API-key heads-up (never blocks; just warns).
     if (provider !== "ollama" && apiKeyEnv && !env[apiKeyEnv]) {
         io.out(`\n  ${ansi.yellow("!")} ${apiKeyEnv} is not set in this shell — ` +
@@ -218,6 +216,51 @@ export async function runInit(opts, env = process.env) {
             io.out(ansi.yellow("! ") + "catalog build skipped (run `memhook build-catalog` later)");
         }
     }
+    // 8. Companion skills (/wrap, /curate, /relay) — opt-in, non-clobbering. The
+    //    install only writes absent skills (never overwrites a user edit without
+    //    --force), so default-on in --yes mode is safe; interactive mode asks.
+    let wantSkills = opts.skills;
+    if (wantSkills === undefined) {
+        if (interactive) {
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            try {
+                const a = (await rl.question(`\nInstall companion skills ${ansi.dim("(/wrap /curate /relay)")} ${ansi.dim("[Y/n]")} `))
+                    .trim()
+                    .toLowerCase();
+                wantSkills = !(a === "n" || a === "no");
+            }
+            finally {
+                rl.close();
+            }
+        }
+        else {
+            wantSkills = true;
+        }
+    }
+    if (wantSkills) {
+        try {
+            const results = installCompanionSkills({});
+            const applied = results.filter((r) => r.applied).map((r) => `/${r.plan.name}`);
+            const blocked = results
+                .filter((r) => r.plan.action === "blocked")
+                .map((r) => `/${r.plan.name}`);
+            if (applied.length > 0) {
+                io.out(`${ansi.green("✓")} skills ${applied.join(" ")} → ${join(homedir(), ".claude", "skills")}`);
+            }
+            else if (blocked.length === 0) {
+                io.out(`${ansi.dim("·")} companion skills already installed ${ansi.dim("(skip)")}`);
+            }
+            if (blocked.length > 0) {
+                io.out(`${ansi.yellow("!")} ${blocked.join(" ")} differ from shipped — left as-is ` +
+                    ansi.dim("(memhook skills install --force to update)"));
+            }
+        }
+        catch (err) {
+            io.out(ansi.yellow("! ") + "skill install skipped (run `memhook skills install` later)");
+            if (env["MEMHOOK_DEBUG"] === "true")
+                process.stderr.write(`${String(err)}\n`);
+        }
+    }
     io.out(`\n${ansi.green("Done.")} Restart Claude Code, then watch it live with ` +
         ansi.bold("memhook tail") +
         ".");
@@ -276,8 +319,8 @@ export async function runUninstall(opts, env = process.env) {
         for (const target of [config.cache.dir, config.logging.jsonlPath]) {
             io.out(ansi.dim(`  (left in place: ${target} — remove manually if desired)`));
         }
+        io.out(ansi.dim("  (companion skills, if installed: remove with `memhook skills uninstall`)"));
     }
     io.out(`\n${ansi.green("Done.")} Restart Claude Code to drop the hooks.`);
     return 0;
 }
-//# sourceMappingURL=init.js.map

package/dist/src/install.d.ts

@@ -84,4 +84,3 @@ export declare function addHooks(input: unknown, bin?: string): AddResult;
  * group list becomes empty — are pruned so no dangling shells are left behind.
  */
 export declare function removeHooks(input: unknown): RemoveResult;
-//# sourceMappingURL=install.d.ts.map

package/dist/src/install.js

@@ -121,4 +121,3 @@ export function removeHooks(input) {
     }
     return { settings, removed, removedEvents };
 }
-//# sourceMappingURL=install.js.map

package/dist/src/preFilter.d.ts

@@ -13,4 +13,3 @@ export declare class PreFilter {
     constructor(filePath: string | undefined, defaults: string[]);
     isTrivial(prompt: string): boolean;
 }
-//# sourceMappingURL=preFilter.d.ts.map

package/dist/src/preFilter.js

@@ -37,4 +37,3 @@ export class PreFilter {
 function normalise(input) {
     return input.replace(/[\s\p{P}]/gu, "").toLowerCase();
 }
-//# sourceMappingURL=preFilter.js.map

package/dist/src/providers/anthropic.d.ts

@@ -30,4 +30,3 @@ export declare class AnthropicProvider implements Provider {
     constructor(config: ProviderConfig, options?: AnthropicProviderOptions);
     select(req: SelectionRequest): Promise<SelectionResponse>;
 }
-//# sourceMappingURL=anthropic.d.ts.map

package/dist/src/providers/anthropic.js

@@ -95,4 +95,3 @@ function extractUsage(json) {
         cacheReadTokens: num("cache_read_input_tokens"),
     };
 }
-//# sourceMappingURL=anthropic.js.map

package/dist/src/providers/factory.d.ts

@@ -12,4 +12,3 @@
 import type { Provider } from "./types.js";
 import type { MemhookConfig } from "../config.js";
 export declare function createProvider(cfg: MemhookConfig, apiKey: string | undefined): Provider;
-//# sourceMappingURL=factory.d.ts.map

package/dist/src/providers/factory.js

@@ -34,4 +34,3 @@ export function createProvider(cfg, apiKey) {
         }
     }
 }
-//# sourceMappingURL=factory.js.map

package/dist/src/providers/http.d.ts

@@ -31,4 +31,3 @@ export interface RawHttpResult {
     latencyMs: number;
 }
 export declare function postJsonWithRetry(opts: PostJsonOptions): Promise<RawHttpResult>;
-//# sourceMappingURL=http.d.ts.map

package/dist/src/providers/http.js

@@ -57,4 +57,3 @@ export async function postJsonWithRetry(opts) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=http.js.map

package/dist/src/providers/ollama.d.ts

@@ -27,4 +27,3 @@ export declare class OllamaProvider implements Provider {
     constructor(config: ProviderConfig);
     select(req: SelectionRequest): Promise<SelectionResponse>;
 }
-//# sourceMappingURL=ollama.d.ts.map

package/dist/src/providers/ollama.js

@@ -86,4 +86,3 @@ function extractUsage(json) {
         cacheReadTokens: 0,
     };
 }
-//# sourceMappingURL=ollama.js.map

package/dist/src/providers/openai.d.ts

@@ -28,4 +28,3 @@ export declare class OpenAIProvider implements Provider {
     constructor(config: ProviderConfig);
     select(req: SelectionRequest): Promise<SelectionResponse>;
 }
-//# sourceMappingURL=openai.d.ts.map

package/dist/src/providers/openai.js

@@ -91,4 +91,3 @@ function extractUsage(json) {
         cacheReadTokens: cachedTokens,
     };
 }
-//# sourceMappingURL=openai.js.map

package/dist/src/providers/types.d.ts

@@ -45,4 +45,3 @@ export interface Provider {
     readonly name: string;
     select(req: SelectionRequest): Promise<SelectionResponse>;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/src/providers/types.js

@@ -15,4 +15,3 @@
  * `createProvider()` in `factory.ts`.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/dist/src/router.d.ts

@@ -18,6 +18,7 @@
  * Fail-soft: every error path falls back to empty additionalContext.
  * Never blocks Claude Code.
  */
+import { type MemhookConfig } from "./config.js";
 export interface HookInput {
     prompt: string;
     cwd?: string;
@@ -27,6 +28,26 @@ export interface HookOutput {
         hookEventName: "UserPromptSubmit";
         additionalContext: string;
     };
+    /**
+     * Optional, additive (v0.4). A one-line warning shown to the user — used only
+     * for the `/curate` nudge when the catalog grows large. Documented Claude Code
+     * field; absent on every turn the nudge does not fire, so the existing output
+     * shape is unchanged for existing consumers (docs/SPECIFICATION.md §10.2).
+     */
+    systemMessage?: string;
 }
 export declare function route(stdinJson: string, env?: NodeJS.ProcessEnv): Promise<HookOutput>;
-//# sourceMappingURL=router.d.ts.map
+/**
+ * Proactive `/curate` nudge. Returns a one-line `systemMessage` when the memory
+ * catalog has grown past a threshold and the cooldown has elapsed, else
+ * undefined. Local-only: it reads the already-loaded catalog length, counts
+ * memory files, and stamps a local cooldown file — NO outbound call. The whole
+ * body is wrapped so any failure yields no nudge (fail-soft is never affected).
+ *
+ * Cost: within the cooldown it pays one tiny stamp read and returns; only once
+ * the cooldown elapses does it count files (a readdir per memory dir, the same
+ * order of I/O the router already does in `readSelected`).
+ *
+ * Exported for direct unit testing.
+ */
+export declare function maybeCurateNudge(config: MemhookConfig, catalogContent: string, now: number): string | undefined;