memhook 0.2.0

package/dist/src/providers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/src/router.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Memhook router — UserPromptSubmit hook entry point.
+ *
+ * Port of ~/.claude/hooks/memory-guard.sh (Phase 0.5 r5, 2026-05-28).
+ *
+ * Pipeline:
+ *   1. Parse stdin: {"prompt", "cwd"}
+ *   2. Toggle gate (config.enabled)
+ *   3. Pre-filter trivial prompts (skip LLM entirely)
+ *   4. Catalog & API key checks
+ *   5. Local LRU cache (key: prompt + catalog_mtime + cwd + script_version)
+ *   6. Provider call (Haiku 4.5 default, ttl 1h ephemeral)
+ *   7. Parse JSON array of basenames, sanitise
+ *   8. Read selected files with cap-by-tokens fix (projected size check)
+ *   9. Emit {"hookSpecificOutput": {"additionalContext": "..."}}
+ *  10. Append JSONL log entry
+ *
+ * Fail-soft: every error path falls back to empty additionalContext.
+ * Never blocks Claude Code.
+ */
+export interface HookInput {
+    prompt: string;
+    cwd?: string;
+}
+export interface HookOutput {
+    hookSpecificOutput: {
+        hookEventName: "UserPromptSubmit";
+        additionalContext: string;
+    };
+}
+export declare function route(stdinJson: string, env?: NodeJS.ProcessEnv): Promise<HookOutput>;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/router.js

@@ -0,0 +1,342 @@
+/**
+ * Memhook router — UserPromptSubmit hook entry point.
+ *
+ * Port of ~/.claude/hooks/memory-guard.sh (Phase 0.5 r5, 2026-05-28).
+ *
+ * Pipeline:
+ *   1. Parse stdin: {"prompt", "cwd"}
+ *   2. Toggle gate (config.enabled)
+ *   3. Pre-filter trivial prompts (skip LLM entirely)
+ *   4. Catalog & API key checks
+ *   5. Local LRU cache (key: prompt + catalog_mtime + cwd + script_version)
+ *   6. Provider call (Haiku 4.5 default, ttl 1h ephemeral)
+ *   7. Parse JSON array of basenames, sanitise
+ *   8. Read selected files with cap-by-tokens fix (projected size check)
+ *   9. Emit {"hookSpecificOutput": {"additionalContext": "..."}}
+ *  10. Append JSONL log entry
+ *
+ * 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 { join, dirname, basename } from "node:path";
+import { LocalCache } from "./cache.js";
+import { loadConfig } from "./config.js";
+import { PreFilter } from "./preFilter.js";
+import { createProvider } from "./providers/factory.js";
+const SAFE_BASENAME_RE = /^[A-Za-z0-9._-]+\.md$/;
+const EMPTY = {
+    hookSpecificOutput: {
+        hookEventName: "UserPromptSubmit",
+        additionalContext: "",
+    },
+};
+export async function route(stdinJson, env = process.env) {
+    const config = loadConfig(env);
+    ensureDirs(config);
+    evictStale(config);
+    if (!config.enabled)
+        return EMPTY;
+    let input;
+    try {
+        input = JSON.parse(stdinJson);
+    }
+    catch {
+        return EMPTY;
+    }
+    if (!input.prompt || typeof input.prompt !== "string")
+        return EMPTY;
+    const cwd = input.cwd ?? process.cwd();
+    const preFilter = new PreFilter(config.preFilter.trivialWordsFile, config.preFilter.defaultWords);
+    if (config.preFilter.enabled && preFilter.isTrivial(input.prompt)) {
+        logEntry(config, baseLog(input.prompt, "pre_filter_skip"));
+        return EMPTY;
+    }
+    if (!existsSync(config.catalog.path)) {
+        logEntry(config, baseLog(input.prompt, "no_catalog"));
+        return EMPTY;
+    }
+    // Provider-aware key gate: local providers (Ollama) need no API key.
+    const needsKey = config.provider.type !== "ollama";
+    const apiKey = config.provider.apiKeyEnv ? env[config.provider.apiKeyEnv] : undefined;
+    if (needsKey && !apiKey) {
+        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,
+            cwd,
+            scriptVersion: config.scriptVersion,
+            provider: `${config.provider.type}:${config.provider.model}`,
+        })
+        : "";
+    let selectedJson = "";
+    let fromCache = false;
+    let usage = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreateTokens: 0,
+        cacheReadTokens: 0,
+    };
+    let latencyMs = 0;
+    if (config.cache.enabled) {
+        const hit = cache.get(cacheKey);
+        // Only trust a cache entry that still parses to a string array; a corrupted
+        // entry is treated as a miss (we re-fetch) rather than killing the turn.
+        if (hit !== null && parseBasenames(hit) !== null) {
+            selectedJson = hit;
+            fromCache = true;
+        }
+    }
+    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).
+        let provider;
+        try {
+            provider = createProvider(config, apiKey);
+        }
+        catch {
+            logEntry(config, baseLog(input.prompt, "provider_init_failed"));
+            return EMPTY;
+        }
+        let resp;
+        try {
+            resp = await provider.select({
+                systemPrompt,
+                userPrompt: input.prompt,
+                maxOutputTokens: config.selection.maxOutputTokens,
+                timeoutMs: config.selection.curlTimeoutMs,
+            });
+        }
+        catch {
+            logEntry(config, baseLog(input.prompt, "api_no_response"));
+            return EMPTY;
+        }
+        latencyMs = resp.latencyMs;
+        usage = resp.usage;
+        if (!resp.rawText) {
+            logEntry(config, {
+                ...baseLog(input.prompt, "api_no_content"),
+                latencyMs,
+                tokensIn: usage.inputTokens,
+                tokensOut: usage.outputTokens,
+                cacheCreate: usage.cacheCreateTokens,
+                cacheRead: usage.cacheReadTokens,
+            });
+            return EMPTY;
+        }
+        const extracted = extractJsonArray(resp.rawText);
+        if (extracted === null) {
+            logEntry(config, {
+                ...baseLog(input.prompt, "parse_invalid"),
+                latencyMs,
+                tokensIn: usage.inputTokens,
+                tokensOut: usage.outputTokens,
+                cacheCreate: usage.cacheCreateTokens,
+                cacheRead: usage.cacheReadTokens,
+            });
+            return EMPTY;
+        }
+        selectedJson = JSON.stringify(extracted);
+        if (config.cache.enabled && selectedJson !== "[]") {
+            cache.put(cacheKey, selectedJson);
+        }
+    }
+    // selectedJson is a validated cache entry or a fresh `JSON.stringify` of a
+    // string array, so this parse is safe by construction; `?? []` is a final
+    // fail-soft backstop that never lets a malformed value throw out of route().
+    const basenames = parseBasenames(selectedJson) ?? [];
+    const { additional, injected, allBasenames } = readSelected(basenames, cwd, config);
+    let status;
+    if (fromCache && injected > 0)
+        status = "cache_hit";
+    else if (injected > 0)
+        status = "ok";
+    else if (selectedJson === "[]")
+        status = "empty_selection";
+    else
+        status = "all_unfound";
+    logEntry(config, {
+        ts: nowIso(),
+        promptPreview: input.prompt.slice(0, 80),
+        selected: allBasenames,
+        latencyMs,
+        tokensIn: usage.inputTokens,
+        tokensOut: usage.outputTokens,
+        cacheCreate: usage.cacheCreateTokens,
+        cacheRead: usage.cacheReadTokens,
+        additionalSizeChars: additional.length,
+        additionalSizeTokensEst: Math.floor(additional.length / 4),
+        status,
+    });
+    return {
+        hookSpecificOutput: {
+            hookEventName: "UserPromptSubmit",
+            additionalContext: additional,
+        },
+    };
+}
+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.
+
+Voici les memory feedbacks + rules disponibles (sections par type, sous-sections par repo, [CWD] = repo courant à prioriser) :
+
+${catalog}
+
+Sélectionne 0 à 5 fichiers (basenames .md) dont le contenu sera DIRECTEMENT pertinent pour la demande utilisateur qui suit.
+
+Critères :
+- Feedback comportemental qui matche l'action (git, crypto, design, commit, etc.)
+- Rule globale qui contraint la zone touchée
+- Project memory qui décrit une décision déjà prise
+- Memory ou rule du repo CWD (marqué [CWD]) — prioriser en cas de collision basename cross-repo
+
+RÈGLES STRICTES POUR LES BASENAMES :
+1. Copie le basename EXACT tel qu'il apparaît dans le catalog (avec préfixe \`feedback_\` ou \`project_\` si présent)
+2. NE substitue PAS \`_\` par \`-\` ou inverse — les rules sont en kebab-case (\`crypto-standards.md\`), les memory en snake_case (\`feedback_X.md\`)
+3. NE tronque PAS le préfixe : \`feedback_commit_without_asking.md\` reste avec son préfixe
+4. N'invente JAMAIS un basename absent du catalog
+
+Format réponse : JSON array de basenames sur UNE SEULE LIGNE.
+Exemple correct : ["feedback_commit_without_asking.md", "crypto-standards.md"]
+Si rien n'est pertinent : []
+Pas d'explication, pas de markdown code fence.`;
+}
+/** Strictly parse a JSON string into a string array, or null if it isn't one. */
+function parseBasenames(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return null;
+        return parsed.filter((x) => typeof x === "string");
+    }
+    catch {
+        return null;
+    }
+}
+function extractJsonArray(text) {
+    const flat = text.replace(/\n/g, " ");
+    const match = flat.match(/\[[^\]]*\]/);
+    if (!match)
+        return null;
+    try {
+        const parsed = JSON.parse(match[0]);
+        if (!Array.isArray(parsed))
+            return null;
+        return parsed.filter((x) => typeof x === "string");
+    }
+    catch {
+        return null;
+    }
+}
+function readSelected(basenames, cwd, config) {
+    // Build search dirs: ~/.claude/projects/*/memory + global rules + cwd rules.
+    const projectDirs = listProjectsMemoryDirs(config.searchDirs[0]);
+    const rulesDir = config.searchDirs[1];
+    const cwdRulesDir = join(cwd, ".claude", "rules");
+    const dirs = [...projectDirs, rulesDir, cwdRulesDir].filter((d) => typeof d === "string" && d.length > 0);
+    let additional = "";
+    let injected = 0;
+    const seen = [];
+    for (const name of basenames) {
+        if (injected >= config.selection.maxFiles)
+            break;
+        if (!SAFE_BASENAME_RE.test(name))
+            continue;
+        seen.push(name);
+        for (const dir of dirs) {
+            const file = join(dir, name);
+            if (!existsSync(file))
+                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 };
+            }
+            additional += `\n\n<!-- ${name} (from ${basename(dir)}) -->\n${content}`;
+            injected++;
+            break;
+        }
+    }
+    return { additional, injected, allBasenames: seen };
+}
+function listProjectsMemoryDirs(projectsRoot) {
+    if (!projectsRoot)
+        return [];
+    let entries = [];
+    try {
+        entries = readdirSync(projectsRoot);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        const mem = join(projectsRoot, e, "memory");
+        if (existsSync(mem))
+            out.push(mem);
+    }
+    return out;
+}
+function ensureDirs(config) {
+    mkdirSync(dirname(config.logging.jsonlPath), { recursive: true });
+    mkdirSync(config.cache.dir, { recursive: true });
+}
+function evictStale(config) {
+    if (!config.cache.enabled)
+        return;
+    try {
+        const cache = new LocalCache(config.cache.dir, config.cache.ttlMin, config.cache.evictionDays);
+        cache.evictStale();
+    }
+    catch {
+        // silent — eviction is best-effort
+    }
+}
+function baseLog(prompt, status) {
+    return {
+        ts: nowIso(),
+        promptPreview: prompt.slice(0, 80),
+        selected: [],
+        latencyMs: 0,
+        tokensIn: 0,
+        tokensOut: 0,
+        cacheCreate: 0,
+        cacheRead: 0,
+        additionalSizeChars: 0,
+        additionalSizeTokensEst: 0,
+        status,
+    };
+}
+function logEntry(config, entry) {
+    try {
+        const line = JSON.stringify({
+            ts: entry.ts,
+            prompt_preview: entry.promptPreview,
+            selected: entry.selected,
+            latency_ms: entry.latencyMs,
+            tokens_in: entry.tokensIn,
+            tokens_out: entry.tokensOut,
+            cache_create: entry.cacheCreate,
+            cache_read: entry.cacheRead,
+            additional_size_chars: entry.additionalSizeChars,
+            additional_size_tokens_est: entry.additionalSizeTokensEst,
+            status: entry.status,
+        });
+        appendFileSync(config.logging.jsonlPath, line + "\n", "utf8");
+    }
+    catch {
+        // silent — logging is best-effort, never block hook
+    }
+}
+function nowIso() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+//# sourceMappingURL=router.js.map

package/dist/src/router.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Single source of truth for memhook's version string at runtime.
+ *
+ * Imported by `src/config.ts` (the cache-key `scriptVersion` token) and
+ * `bin/memhook.ts` (the `version` / `--help` banner). This constant reflects
+ * the LAST RELEASED version and is bumped automatically by release-please: it
+ * is listed in `release-please-config.json` `extra-files`, and the
+ * `x-release-please-version` annotation below tells release-please to rewrite
+ * the literal in lockstep with `package.json` + `.release-please-manifest.json`.
+ * Do not bump it by hand.
+ */
+export declare const MEMHOOK_VERSION = "0.2.0";
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC"}

package/dist/src/version.js

@@ -0,0 +1,13 @@
+/**
+ * Single source of truth for memhook's version string at runtime.
+ *
+ * Imported by `src/config.ts` (the cache-key `scriptVersion` token) and
+ * `bin/memhook.ts` (the `version` / `--help` banner). This constant reflects
+ * the LAST RELEASED version and is bumped automatically by release-please: it
+ * is listed in `release-please-config.json` `extra-files`, and the
+ * `x-release-please-version` annotation below tells release-please to rewrite
+ * the literal in lockstep with `package.json` + `.release-please-manifest.json`.
+ * Do not bump it by hand.
+ */
+export const MEMHOOK_VERSION = "0.2.0"; // x-release-please-version
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,2BAA2B"}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "memhook",
+  "version": "0.2.0",
+  "description": "Semantic memory router for Claude Code — picks relevant feedbacks & rules per prompt via Haiku, injects them as additionalContext.",
+  "type": "module",
+  "license": "MIT",
+  "author": "wox <hello@utilia-ai.com>",
+  "homepage": "https://github.com/utilia-ai-wox/memhook",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/utilia-ai-wox/memhook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/utilia-ai-wox/memhook/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "anthropic",
+    "memory",
+    "hook",
+    "userpromptsubmit",
+    "semantic-router",
+    "haiku"
+  ],
+  "bin": {
+    "memhook": "./dist/bin/memhook.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./hook": {
+      "types": "./dist/src/router.d.ts",
+      "import": "./dist/src/router.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "prebuild": "node scripts/clean.mjs",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -w -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepare": "husky",
+    "prepublishOnly": "npm run typecheck && npm run lint && npm test && npm run build"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.0.0",
+    "@commitlint/config-conventional": "^19.0.0",
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "husky": "^9.0.0",
+    "lint-staged": "^15.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "lint-staged": {
+    "*.{ts,js,mjs,cjs}": [
+      "prettier --write",
+      "eslint --fix"
+    ],
+    "*.{json,yml,yaml,md}": [
+      "prettier --write"
+    ]
+  }
+}