memhook 0.2.2 → 0.4.0

package/dist/src/install.js

@@ -0,0 +1,124 @@
+/**
+ * Pure settings.json hook wiring — the dangerous-but-testable core of
+ * `memhook init` / `memhook uninstall`.
+ *
+ * Everything here is a pure data transform: it takes the parsed contents of
+ * `~/.claude/settings.json` and returns a NEW object with memhook's hooks
+ * added or removed. There is NO file I/O in this module — the orchestration
+ * layer (`src/init.ts`) handles reading, backing up, and writing. Keeping the
+ * merge pure means the idempotency / non-clobbering guarantees are unit-tested
+ * without touching anyone's real config (the one file we must never corrupt).
+ *
+ * The Claude Code hook shape (sourced from the README + docs/SPECIFICATION.md
+ * §10) is:
+ *
+ *   {
+ *     "hooks": {
+ *       "UserPromptSubmit": [ { "hooks": [ { "type": "command", "command": "memhook run" } ] } ],
+ *       "SessionStart":     [ { "hooks": [ { "type": "command", "command": "memhook build-catalog" } ] } ]
+ *     }
+ *   }
+ *
+ * Each event maps to an array of matcher-groups; each group has a `hooks` array
+ * of `{ type, command }`. memhook contributes one group per event and leaves
+ * every other key — and every other user hook — untouched.
+ */
+/** The two events memhook wires, paired with the subcommand each runs. */
+export const MEMHOOK_HOOKS = [
+    { event: "UserPromptSubmit", subcommand: "run" },
+    { event: "SessionStart", subcommand: "build-catalog" },
+];
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * If `command` invokes the memhook binary, return its subcommand
+ * (e.g. "run", "build-catalog"), else null. Matches the README form
+ * (`memhook run`), an absolute-path form (`/usr/local/bin/memhook run`), and a
+ * node form (`node dist/bin/memhook.js run`). Detection is binary-name based
+ * (not the configured invocation), so `uninstall` cleans up a hook regardless
+ * of how it was originally written.
+ */
+export function memhookSubcommand(command) {
+    if (typeof command !== "string")
+        return null;
+    const m = command.match(/(?:^|[\s/\\])memhook(?:\.[cm]?js)?["']?\s+([a-z][a-z-]*)/i);
+    return m?.[1] ? m[1].toLowerCase() : null;
+}
+/** True if `group` contains a memhook hook for `subcommand`. */
+function groupHasMemhook(group, subcommand) {
+    if (!Array.isArray(group.hooks))
+        return false;
+    return group.hooks.some((h) => memhookSubcommand(h?.command) === subcommand);
+}
+/**
+ * Return a deep clone with memhook's hooks added. Idempotent: an event that
+ * already has a memhook hook for its subcommand is left untouched. Every other
+ * key and every other user hook is preserved exactly.
+ *
+ * @param input  parsed settings.json (non-object input is treated as `{}`)
+ * @param bin    the command used to invoke memhook (default `"memhook"`)
+ */
+export function addHooks(input, bin = "memhook") {
+    const settings = isPlainObject(input) ? structuredClone(input) : {};
+    if (!isPlainObject(settings.hooks))
+        settings.hooks = {};
+    const hooks = settings.hooks;
+    const added = [];
+    const alreadyPresent = [];
+    for (const { event, subcommand } of MEMHOOK_HOOKS) {
+        const list = Array.isArray(hooks[event]) ? hooks[event] : (hooks[event] = []);
+        if (list.some((g) => isPlainObject(g) && groupHasMemhook(g, subcommand))) {
+            alreadyPresent.push(event);
+            continue;
+        }
+        list.push({ hooks: [{ type: "command", command: `${bin} ${subcommand}` }] });
+        added.push(event);
+    }
+    return { settings, added, alreadyPresent };
+}
+/**
+ * Return a deep clone with every memhook hook removed. Scans ALL hook events
+ * (not just the two memhook registers) so a hook moved by hand is still cleaned
+ * up. Empties that result — a group whose `hooks` becomes empty, an event whose
+ * group list becomes empty — are pruned so no dangling shells are left behind.
+ */
+export function removeHooks(input) {
+    const settings = isPlainObject(input) ? structuredClone(input) : {};
+    let removed = 0;
+    const removedEvents = [];
+    if (!isPlainObject(settings.hooks))
+        return { settings, removed, removedEvents };
+    const hooks = settings.hooks;
+    for (const event of Object.keys(hooks)) {
+        const list = hooks[event];
+        if (!Array.isArray(list))
+            continue;
+        let removedHere = 0;
+        const kept = [];
+        for (const group of list) {
+            if (!isPlainObject(group) || !Array.isArray(group.hooks)) {
+                kept.push(group);
+                continue;
+            }
+            const before = group.hooks.length;
+            group.hooks = group.hooks.filter((h) => memhookSubcommand(h?.command) === null);
+            removedHere += before - group.hooks.length;
+            // Drop a group only if WE emptied it (a group that was already empty, or
+            // empty for other reasons, is preserved untouched).
+            if (group.hooks.length > 0 || before === 0)
+                kept.push(group);
+        }
+        if (removedHere > 0) {
+            removed += removedHere;
+            removedEvents.push(event);
+            if (kept.length > 0)
+                hooks[event] = kept;
+            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+            else
+                delete hooks[event];
+        }
+    }
+    return { settings, removed, removedEvents };
+}
+//# sourceMappingURL=install.js.map

package/dist/src/install.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkBH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE;QAClB,aAAa,EAAE,kBAAkB,CAAC;QAClC,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAuBD,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,UAAU,CAAC,CA0JrB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAM7D,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,kBAAkB,EAAE;QAClB,aAAa,EAAE,kBAAkB,CAAC;QAClC,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuBD,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,UAAU,CAAC,CA+KrB;AAqID;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAqBpB"}

package/dist/src/router.js

@@ -18,7 +18,7 @@
  * Fail-soft: every error path falls back to empty additionalContext.
  * Never blocks Claude Code.
  */
-import { existsSync, readFileSync, statSync, appendFileSync, mkdirSync, readdirSync, } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, openSync, fstatSync, closeSync, appendFileSync, mkdirSync, readdirSync, } from "node:fs";
 import { join, dirname, basename } from "node:path";
 import { LocalCache } from "./cache.js";
 import { loadConfig } from "./config.js";
@@ -52,7 +52,26 @@ export async function route(stdinJson, env = process.env) {
         logEntry(config, baseLog(input.prompt, "pre_filter_skip"));
         return EMPTY;
     }
-    if (!existsSync(config.catalog.path)) {
+    // Read the catalog through a single fd: `fstat` gives the cache-key mtime and
+    // we read the content from the same handle. Using one open fd — instead of
+    // `existsSync`/`statSync` then `readFileSync` on the path — closes a
+    // check-then-use window (CodeQL js/file-system-race). A missing or unreadable
+    // catalog falls through to `no_catalog` (fail-soft). The content is only used
+    // on a cache miss, but reading it here (a small index file) keeps the catalog
+    // access to one race-free handle.
+    let catalogContent;
+    let catalogMtimeMs;
+    try {
+        const fd = openSync(config.catalog.path, "r");
+        try {
+            catalogMtimeMs = fstatSync(fd).mtimeMs;
+            catalogContent = readFileSync(fd, "utf8");
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
         logEntry(config, baseLog(input.prompt, "no_catalog"));
         return EMPTY;
     }
@@ -63,12 +82,11 @@ export async function route(stdinJson, env = process.env) {
         logEntry(config, baseLog(input.prompt, "no_api_key"));
         return EMPTY;
     }
-    const catalogStat = statSync(config.catalog.path);
     const cache = new LocalCache(config.cache.dir, config.cache.ttlMin, config.cache.evictionDays);
     const cacheKey = config.cache.enabled
         ? cache.key({
             prompt: input.prompt,
-            catalogMtimeMs: catalogStat.mtimeMs,
+            catalogMtimeMs,
             cwd,
             scriptVersion: config.scriptVersion,
             provider: `${config.provider.type}:${config.provider.model}`,
@@ -93,7 +111,6 @@ export async function route(stdinJson, env = process.env) {
         }
     }
     if (!fromCache) {
-        const catalogContent = readFileSync(config.catalog.path, "utf8");
         const systemPrompt = buildSystemPrompt(catalogContent);
         // Provider construction can throw on bad config; the constructor `throw`s
         // are reachable from the hook, so they MUST be caught here (fail-soft).
@@ -175,12 +192,19 @@ export async function route(stdinJson, env = process.env) {
         additionalSizeTokensEst: Math.floor(additional.length / 4),
         status,
     });
-    return {
+    const output = {
         hookSpecificOutput: {
             hookEventName: "UserPromptSubmit",
             additionalContext: additional,
         },
     };
+    // Proactive `/curate` nudge — best-effort, local-only, never affects the
+    // additionalContext contract or fail-soft. `catalogContent` is already in hand
+    // (read above), so the catalog-size signal is free.
+    const nudge = maybeCurateNudge(config, catalogContent, Date.now());
+    if (nudge)
+        output.systemMessage = nudge;
+    return output;
 }
 function buildSystemPrompt(catalog) {
     return `Tu es un sélecteur de mémoire pour Claude Code. Tu identifies les feedbacks et règles pertinents pour le prompt utilisateur. Tu réponds UNIQUEMENT avec un JSON array de basenames .md, sans explication, sans markdown code fence.
@@ -252,10 +276,16 @@ function readSelected(basenames, cwd, config) {
         seen.push(name);
         for (const dir of dirs) {
             const file = join(dir, name);
-            if (!existsSync(file))
+            // Read directly and treat a read failure as "not in this dir" — no
+            // existsSync precheck, so no check-then-use race (CodeQL js/file-system-race).
+            let content;
+            try {
+                content = readFileSync(file, "utf8");
+            }
+            catch {
                 continue;
+            }
             // Cap-A1 projection check — pre-injection, allow ≥1 file always.
-            const content = readFileSync(file, "utf8");
             const projected = additional.length + content.length + 64;
             if (injected > 0 && projected > config.selection.maxAdditionalChars) {
                 return { additional, injected, allBasenames: seen };
@@ -300,6 +330,77 @@ function evictStale(config) {
         // silent — eviction is best-effort
     }
 }
+/**
+ * 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 function maybeCurateNudge(config, catalogContent, now) {
+    try {
+        if (!config.curateNudge.enabled)
+            return undefined;
+        const stampFile = join(config.cache.dir, ".curate-nudge");
+        const last = readNudgeStamp(stampFile);
+        if (last !== null && now - last < config.curateNudge.cooldownDays * 86_400_000) {
+            return undefined;
+        }
+        const tokensEst = Math.floor(catalogContent.length / 4);
+        const fileCount = countMemoryFiles(config.searchDirs[0]);
+        const over = tokensEst >= config.curateNudge.thresholdTokens ||
+            fileCount >= config.curateNudge.thresholdFiles;
+        if (!over)
+            return undefined;
+        writeNudgeStamp(stampFile, now);
+        const tokK = tokensEst >= 10_000 ? Math.round(tokensEst / 1000) : (tokensEst / 1000).toFixed(1);
+        return `📚 memhook: memory catalog is large (~${tokK}k tokens, ${fileCount} files). Run /curate to prune duplicate and stale entries.`;
+    }
+    catch {
+        return undefined; // a nudge must never break fail-soft
+    }
+}
+/** Count top-level `*.md` memory files (excludes MEMORY.md and the journal/ subdir). */
+function countMemoryFiles(projectsRoot) {
+    let total = 0;
+    for (const dir of listProjectsMemoryDirs(projectsRoot)) {
+        let entries = [];
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (e.endsWith(".md") && e !== "MEMORY.md")
+                total++;
+        }
+    }
+    return total;
+}
+function readNudgeStamp(file) {
+    try {
+        const n = Number(readFileSync(file, "utf8").trim());
+        return Number.isFinite(n) ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeNudgeStamp(file, now) {
+    try {
+        writeFileSync(file, String(now), "utf8");
+    }
+    catch {
+        // best-effort — a missed stamp just means the nudge may repeat
+    }
+}
 function baseLog(prompt, status) {
     return {
         ts: nowIso(),
@@ -329,6 +430,10 @@ function logEntry(config, entry) {
             additional_size_chars: entry.additionalSizeChars,
             additional_size_tokens_est: entry.additionalSizeTokensEst,
             status: entry.status,
+            // Additive field (v0.3) — the model that handled this turn. Read by
+            // `memhook tail`. The frozen log schema permits adding fields; never
+            // rename/remove existing ones (docs/SPECIFICATION.md §14).
+            model: config.provider.model,
         });
         appendFileSync(config.logging.jsonlPath, line + "\n", "utf8");
     }

package/dist/src/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,SAAS,EACT,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAsB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAmCjD,MAAM,KAAK,GAAe;IACxB,kBAAkB,EAAE;QAClB,aAAa,EAAE,kBAAkB;QACjC,iBAAiB,EAAE,EAAE;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,SAAiB,EACjB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,UAAU,CAAC,MAAM,CAAC,CAAC;IAEnB,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAElC,IAAI,KAAgB,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAc,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IAClG,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,2EAA2E;IAC3E,qEAAqE;IACrE,8EAA8E;IAC9E,8EAA8E;IAC9E,8EAA8E;IAC9E,kCAAkC;IAClC,IAAI,cAAsB,CAAC;IAC3B,IAAI,cAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,IAAI,CAAC;YACH,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;YACvC,cAAc,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qEAAqE;IACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,IAAI,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QACtD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO;QACnC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;YACR,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,cAAc;YACd,GAAG;YACH,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;SAC7D,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,YAAY,GAAG,EAAE,CAAC;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,KAAK,GAAG;QACV,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;KACnB,CAAC;IACF,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,4EAA4E;QAC5E,yEAAyE;QACzE,IAAI,GAAG,KAAK,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACjD,YAAY,GAAG,GAAG,CAAC;YACnB,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;QACvD,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,QAAQ,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC;YAChE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC;QACT,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;gBAC3B,YAAY;gBACZ,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,eAAe;gBACjD,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,aAAa;aAC1C,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;YAC3D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3B,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,QAAQ,CAAC,MAAM,EAAE;gBACf,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAC1C,SAAS;gBACT,QAAQ,EAAE,KAAK,CAAC,WAAW;gBAC3B,SAAS,EAAE,KAAK,CAAC,YAAY;gBAC7B,WAAW,EAAE,KAAK,CAAC,iBAAiB;gBACpC,SAAS,EAAE,KAAK,CAAC,eAAe;aACjC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE;gBACf,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC;gBACzC,SAAS;gBACT,QAAQ,EAAE,KAAK,CAAC,WAAW;gBAC3B,SAAS,EAAE,KAAK,CAAC,YAAY;gBAC7B,WAAW,EAAE,KAAK,CAAC,iBAAiB;gBACpC,SAAS,EAAE,KAAK,CAAC,eAAe;aACjC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAClD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,SAAS,GAAG,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAEpF,IAAI,MAAc,CAAC;IACnB,IAAI,SAAS,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,GAAG,WAAW,CAAC;SAC/C,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,GAAG,IAAI,CAAC;SAChC,IAAI,YAAY,KAAK,IAAI;QAAE,MAAM,GAAG,iBAAiB,CAAC;;QACtD,MAAM,GAAG,aAAa,CAAC;IAE5B,QAAQ,CAAC,MAAM,EAAE;QACf,EAAE,EAAE,MAAM,EAAE;QACZ,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACxC,QAAQ,EAAE,YAAY;QACtB,SAAS;QACT,QAAQ,EAAE,KAAK,CAAC,WAAW;QAC3B,SAAS,EAAE,KAAK,CAAC,YAAY;QAC7B,WAAW,EAAE,KAAK,CAAC,iBAAiB;QACpC,SAAS,EAAE,KAAK,CAAC,eAAe;QAChC,mBAAmB,EAAE,UAAU,CAAC,MAAM;QACtC,uBAAuB,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1D,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,MAAM,GAAe;QACzB,kBAAkB,EAAE;YAClB,aAAa,EAAE,kBAAkB;YACjC,iBAAiB,EAAE,UAAU;SAC9B;KACF,CAAC;IACF,yEAAyE;IACzE,+EAA+E;IAC/E,oDAAoD;IACpD,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK;QAAE,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,OAAO;;;;EAIP,OAAO;;;;;;;;;;;;;;;;;;;+CAmBsC,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAQD,SAAS,YAAY,CAAC,SAAmB,EAAE,GAAW,EAAE,MAAqB;IAC3E,6EAA6E;IAC7E,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,CAAC,GAAG,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,MAAM,CACzD,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC1D,CAAC;IAEF,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ;YAAE,MAAM;QACjD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAE7B,mEAAmE;YACnE,+EAA+E;YAC/E,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,iEAAiE;YACjE,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;YAC1D,IAAI,QAAQ,GAAG,CAAC,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;gBACpE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;YACtD,CAAC;YACD,UAAU,IAAI,YAAY,IAAI,UAAU,QAAQ,CAAC,GAAG,CAAC,UAAU,OAAO,EAAE,CAAC;YACzE,QAAQ,EAAE,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,sBAAsB,CAAC,YAAgC;IAC9D,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB;IACvC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB;IACvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO;IAClC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/F,KAAK,CAAC,UAAU,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAqB,EACrB,cAAsB,EACtB,GAAW;IAEX,IAAI,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,GAAG,UAAU,EAAE,CAAC;YAC/E,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,GACR,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,eAAe;YAC/C,SAAS,IAAI,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC;QACjD,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAE5B,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAChG,OAAO,yCAAyC,IAAI,aAAa,SAAS,4DAA4D,CAAC;IACzI,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC,CAAC,qCAAqC;IACzD,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,SAAS,gBAAgB,CAAC,YAAgC;IACxD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,sBAAsB,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,IAAI,OAAO,GAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW;gBAAE,KAAK,EAAE,CAAC;QACtD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,GAAW;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,MAAc;IAC7C,OAAO;QACL,EAAE,EAAE,MAAM,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAClC,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,mBAAmB,EAAE,CAAC;QACtB,uBAAuB,EAAE,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAqB,EAAE,KAAe;IACtD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,cAAc,EAAE,KAAK,CAAC,aAAa;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,SAAS,EAAE,KAAK,CAAC,QAAQ;YACzB,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,YAAY,EAAE,KAAK,CAAC,WAAW;YAC/B,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,qBAAqB,EAAE,KAAK,CAAC,mBAAmB;YAChD,0BAA0B,EAAE,KAAK,CAAC,uBAAuB;YACzD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,oEAAoE;YACpE,qEAAqE;YACrE,2DAA2D;YAC3D,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;SAC7B,CAAC,CAAC;QACH,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/dist/src/skills.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pure planning core for `memhook skills install|uninstall|list`.
+ *
+ * Like src/install.ts, this module has NO file I/O. The orchestration layer
+ * (src/skillsCmd.ts) reads the bundled skill files and the files already on
+ * disk, calls these pure planners, and applies the result with backups.
+ * Keeping the plan pure means the idempotency + non-clobbering guarantees are
+ * unit-tested without touching anyone's real `~/.claude/skills`.
+ *
+ * memhook ships three STANDALONE companion skills in Claude Code's skill format
+ * (`~/.claude/skills/<name>/SKILL.md`, invoked as `/<name>`):
+ *
+ *   /wrap   — end-of-session wrap-up (capture lessons into memory + journal)
+ *   /curate — memory hygiene (dedupe, index sync, rebuild the catalog)
+ *   /relay  — generate a handoff prompt for a fresh session
+ *
+ * Standalone — not a plugin — so the command names stay bare (`/wrap`, not
+ * `/memhook:wrap`). See docs/SPECIFICATION.md "Companion skills".
+ */
+export declare const COMPANION_SKILLS: readonly ["wrap", "curate", "relay"];
+export type CompanionSkill = (typeof COMPANION_SKILLS)[number];
+/**
+ * Files bundled for each skill, relative to the skill's own directory. The
+ * orchestration layer reads `<sourceDir>/<name>/<relPath>` and writes
+ * `~/.claude/skills/<name>/<relPath>`.
+ */
+export declare const SKILL_FILES: Record<CompanionSkill, readonly string[]>;
+export declare function isCompanionSkill(name: string): name is CompanionSkill;
+/** Bundled content for one skill, keyed by relative path. */
+export type SkillSources = Record<string, string>;
+/** Installed content per relative path; `null` means the file is not on disk. */
+export type InstalledFiles = Record<string, string | null>;
+export type SkillStatus = "absent" | "identical" | "differs";
+export type InstallAction = "install" | "skip" | "overwrite" | "blocked";
+/**
+ * Compare a skill's bundled files against what's on disk.
+ *   - `absent`    — none of the skill's files are installed.
+ *   - `identical` — every bundled file is installed with matching content.
+ *   - `differs`   — installed but a file is missing or its content changed
+ *                   (a user edit, or an older shipped version).
+ */
+export declare function diffSkill(source: SkillSources, installed: InstalledFiles): SkillStatus;
+export interface SkillInstallPlan {
+    name: CompanionSkill;
+    status: SkillStatus;
+    action: InstallAction;
+    /** Relative paths that will be written for `install` / `overwrite`. */
+    writes: string[];
+}
+/**
+ * Plan one skill install. Idempotent: an `identical` skill is skipped. A skill
+ * that `differs` is NEVER clobbered without `force` (it's reported `blocked`),
+ * matching install.ts's "back up + never overwrite silently" stance. With
+ * `force`, a differing skill is `overwrite` (the caller backs up first).
+ */
+export declare function planInstall(name: CompanionSkill, source: SkillSources, installed: InstalledFiles, opts: {
+    force: boolean;
+}): SkillInstallPlan;
+export interface SkillUninstallPlan {
+    name: CompanionSkill;
+    present: boolean;
+    action: "remove" | "skip";
+    /** Relative paths that exist on disk and will be deleted. */
+    removes: string[];
+}
+/** Plan one skill uninstall: remove only the files memhook ships, if present. */
+export declare function planUninstall(name: CompanionSkill, source: SkillSources, installed: InstalledFiles): SkillUninstallPlan;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,gBAAgB,sCAAuC,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAIjE,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,cAAc,CAErE;AAED,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClD,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,GAAG,WAAW,CAMtF;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,uEAAuE;IACvE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GACvB,gBAAgB,CAQlB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,cAAc,GACxB,kBAAkB,CAIpB"}

package/dist/src/skills.js

@@ -0,0 +1,73 @@
+/**
+ * Pure planning core for `memhook skills install|uninstall|list`.
+ *
+ * Like src/install.ts, this module has NO file I/O. The orchestration layer
+ * (src/skillsCmd.ts) reads the bundled skill files and the files already on
+ * disk, calls these pure planners, and applies the result with backups.
+ * Keeping the plan pure means the idempotency + non-clobbering guarantees are
+ * unit-tested without touching anyone's real `~/.claude/skills`.
+ *
+ * memhook ships three STANDALONE companion skills in Claude Code's skill format
+ * (`~/.claude/skills/<name>/SKILL.md`, invoked as `/<name>`):
+ *
+ *   /wrap   — end-of-session wrap-up (capture lessons into memory + journal)
+ *   /curate — memory hygiene (dedupe, index sync, rebuild the catalog)
+ *   /relay  — generate a handoff prompt for a fresh session
+ *
+ * Standalone — not a plugin — so the command names stay bare (`/wrap`, not
+ * `/memhook:wrap`). See docs/SPECIFICATION.md "Companion skills".
+ */
+export const COMPANION_SKILLS = ["wrap", "curate", "relay"];
+/**
+ * Files bundled for each skill, relative to the skill's own directory. The
+ * orchestration layer reads `<sourceDir>/<name>/<relPath>` and writes
+ * `~/.claude/skills/<name>/<relPath>`.
+ */
+export const SKILL_FILES = {
+    wrap: ["SKILL.md"],
+    curate: ["SKILL.md", "reference.md"],
+    relay: ["SKILL.md"],
+};
+export function isCompanionSkill(name) {
+    return COMPANION_SKILLS.includes(name);
+}
+/**
+ * Compare a skill's bundled files against what's on disk.
+ *   - `absent`    — none of the skill's files are installed.
+ *   - `identical` — every bundled file is installed with matching content.
+ *   - `differs`   — installed but a file is missing or its content changed
+ *                   (a user edit, or an older shipped version).
+ */
+export function diffSkill(source, installed) {
+    const rels = Object.keys(source);
+    const anyPresent = rels.some((r) => installed[r] != null);
+    if (!anyPresent)
+        return "absent";
+    const allMatch = rels.every((r) => installed[r] != null && installed[r] === source[r]);
+    return allMatch ? "identical" : "differs";
+}
+/**
+ * Plan one skill install. Idempotent: an `identical` skill is skipped. A skill
+ * that `differs` is NEVER clobbered without `force` (it's reported `blocked`),
+ * matching install.ts's "back up + never overwrite silently" stance. With
+ * `force`, a differing skill is `overwrite` (the caller backs up first).
+ */
+export function planInstall(name, source, installed, opts) {
+    const status = diffSkill(source, installed);
+    let action;
+    if (status === "absent")
+        action = "install";
+    else if (status === "identical")
+        action = "skip";
+    else
+        action = opts.force ? "overwrite" : "blocked";
+    const writes = action === "install" || action === "overwrite" ? Object.keys(source) : [];
+    return { name, status, action, writes };
+}
+/** Plan one skill uninstall: remove only the files memhook ships, if present. */
+export function planUninstall(name, source, installed) {
+    const removes = Object.keys(source).filter((r) => installed[r] != null);
+    const present = removes.length > 0;
+    return { name, present, action: present ? "remove" : "skip", removes };
+}
+//# sourceMappingURL=skills.js.map

package/dist/src/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAU,CAAC;AAGrE;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAA8C;IACpE,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,MAAM,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,KAAK,EAAE,CAAC,UAAU,CAAC;CACpB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAQ,gBAAsC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAoB,EAAE,SAAyB;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,OAAO,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAoB,EACpB,MAAoB,EACpB,SAAyB,EACzB,IAAwB;IAExB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,MAAqB,CAAC;IAC1B,IAAI,MAAM,KAAK,QAAQ;QAAE,MAAM,GAAG,SAAS,CAAC;SACvC,IAAI,MAAM,KAAK,WAAW;QAAE,MAAM,GAAG,MAAM,CAAC;;QAC5C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAUD,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAC3B,IAAoB,EACpB,MAAoB,EACpB,SAAyB;IAEzB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;AACzE,CAAC"}

package/dist/src/skillsCmd.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `memhook skills install|uninstall|list` — copy the bundled companion skills
+ * (/wrap, /curate, /relay) into `~/.claude/skills/<name>/`.
+ *
+ * This is the I/O shell around the pure planner in src/skills.ts (same split as
+ * init.ts ↔ install.ts). All reads/writes/backups live here; the plan logic is
+ * pure and unit-tested. These are INTERACTIVE, user-invoked commands — not the
+ * hook path — so they may use the TTY and exit non-zero on user error
+ * (docs/SPECIFICATION.md §9). The one safety rule: never clobber a skill the
+ * user has edited without `--force`, and always back up before overwriting.
+ */
+import { type CompanionSkill, type SkillInstallPlan } from "./skills.js";
+/**
+ * Directory holding the bundled skill sources. The module lives at `src/` in
+ * dev/tests and `dist/src/` once published, so the relative depth to the
+ * package-root `skills/` differs — walk up from the module dir until we find a
+ * `skills/wrap/SKILL.md`, which is unambiguous in either layout.
+ */
+export declare function bundledSkillsDir(): string;
+export interface InstallSkillsOptions {
+    home?: string | undefined;
+    sourceDir?: string | undefined;
+    names?: CompanionSkill[] | undefined;
+    force?: boolean | undefined;
+    dryRun?: boolean | undefined;
+}
+export interface SkillInstallResult {
+    plan: SkillInstallPlan;
+    applied: boolean;
+    backedUp: string[];
+}
+/**
+ * Install (copy) the requested skills, backing up any file an `--force`
+ * overwrite would replace. Pure-of-prompts: callers handle confirmation + I/O
+ * reporting. Returns one result per requested skill.
+ */
+export declare function installCompanionSkills(opts?: InstallSkillsOptions): SkillInstallResult[];
+export type SkillsSubcommand = "install" | "uninstall" | "list";
+export interface RunSkillsOptions {
+    subcommand: SkillsSubcommand;
+    names?: CompanionSkill[] | undefined;
+    yes: boolean;
+    dryRun: boolean;
+    force: boolean;
+    /** Test seams. */
+    home?: string | undefined;
+    sourceDir?: string | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+}
+export declare function runSkills(opts: RunSkillsOptions): Promise<number>;
+//# sourceMappingURL=skillsCmd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skillsCmd.d.ts","sourceRoot":"","sources":["../../src/skillsCmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO,EAML,KAAK,cAAc,EAEnB,KAAK,gBAAgB,EAGtB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAWzC;AA8BD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,oBAAyB,GAAG,kBAAkB,EAAE,CAqC5F;AAID,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,cAAc,EAAE,GAAG,SAAS,CAAC;IACrC,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACrC;AAkBD,wBAAsB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4JvE"}