memhook 0.2.0

package/dist/src/catalog.js

@@ -0,0 +1,152 @@
+/**
+ * Memhook catalog builder — TS port of build-memory-catalog.sh.
+ *
+ * Discovers feedbacks & projects in `~/.claude/projects/* /memory/`, global
+ * rules in `~/.claude/rules/`, and project rules in `<cwd>/.claude/rules/`.
+ *
+ * Phase 0.5 Q4: title-only for non-CWD zones (~50% catalog size reduction).
+ * The CWD zone gets full `basename: description`; others list just basenames.
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync, statSync, renameSync, } from "node:fs";
+import { join, basename as pathBasename } from "node:path";
+import { homedir } from "node:os";
+export function buildCatalog(opts) {
+    const home = homedir();
+    const projectsRoot = opts.projectsRoot ?? join(home, ".claude", "projects");
+    const globalRulesDir = opts.globalRulesDir ?? join(home, ".claude", "rules");
+    const memoryDirs = discoverMemoryDirs(projectsRoot, opts.cwd);
+    const sections = [];
+    sections.push(emitMemorySection("feedback", "MEMORY FEEDBACKS", memoryDirs));
+    sections.push(emitMemorySection("project", "MEMORY PROJECTS", memoryDirs));
+    sections.push(emitRulesSection("GLOBAL RULES", globalRulesDir, true));
+    sections.push(emitRulesSection(`PROJECT RULES (${pathBasename(opts.cwd)})`, join(opts.cwd, ".claude", "rules"), true));
+    const content = sections.join("\n");
+    const tmp = `${opts.outputPath}.tmp.${process.pid}`;
+    writeFileSync(tmp, content, "utf8");
+    renameSync(tmp, opts.outputPath);
+    const lines = content.split("\n").length;
+    const bytes = Buffer.byteLength(content, "utf8");
+    return { lines, bytes };
+}
+function discoverMemoryDirs(projectsRoot, cwd) {
+    if (!existsSync(projectsRoot))
+        return [];
+    const out = [];
+    const cwdSlug = cwdToSlug(cwd);
+    for (const entry of readdirSync(projectsRoot)) {
+        const dir = join(projectsRoot, entry, "memory");
+        if (!existsSync(dir))
+            continue;
+        out.push({ zoneSlug: entry, path: dir, isCwd: entry === cwdSlug });
+    }
+    // CWD first for Haiku priority
+    out.sort((a, b) => a.isCwd === b.isCwd ? a.zoneSlug.localeCompare(b.zoneSlug) : a.isCwd ? -1 : 1);
+    return out;
+}
+function cwdToSlug(cwd) {
+    // ~/.claude/projects encodes a POSIX path like `/Users/you/dev/app` as
+    // `-Users-you-dev-app`. On Windows, normalise backslashes first so a path
+    // like `C:\Users\you\dev\app` slugifies consistently (drive-letter matching
+    // is best-effort — Claude Code's Windows encoding is unverified).
+    return cwd.replace(/\\/g, "/").replace(/^\//, "-").replace(/\//g, "-");
+}
+function emitMemorySection(prefix, label, dirs) {
+    const lines = [`=== ${label} ===`];
+    let total = 0;
+    for (const dir of dirs) {
+        const files = listMemoryFiles(dir.path, prefix);
+        if (files.length === 0)
+            continue;
+        const marker = dir.isCwd ? " [CWD]" : "";
+        lines.push(`--- ${dir.zoneSlug}${marker} ---`);
+        for (const file of files) {
+            const bn = pathBasename(file);
+            if (dir.isCwd) {
+                lines.push(`${bn}: ${extractDescription(file)}`);
+            }
+            else {
+                lines.push(bn);
+            }
+        }
+        total += files.length;
+    }
+    lines.push(`(${total} entries)`);
+    lines.push("");
+    return lines.join("\n");
+}
+function emitRulesSection(label, dir, isCwdZone) {
+    const lines = [`=== ${label} ===`];
+    if (!existsSync(dir)) {
+        lines.push(`(directory not found: ${dir})`);
+        lines.push("");
+        return lines.join("\n");
+    }
+    let count = 0;
+    for (const entry of readdirSync(dir).sort()) {
+        if (!entry.endsWith(".md"))
+            continue;
+        const full = join(dir, entry);
+        try {
+            const s = statSync(full);
+            if (!s.isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (isCwdZone) {
+            lines.push(`${entry}: ${extractDescription(full)}`);
+        }
+        else {
+            lines.push(entry);
+        }
+        count++;
+    }
+    lines.push(`(${count} entries)`);
+    lines.push("");
+    return lines.join("\n");
+}
+function listMemoryFiles(dir, prefix) {
+    let entries = [];
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const re = new RegExp(`^${prefix}_.*\\.md$`);
+    return entries
+        .filter((e) => re.test(e))
+        .map((e) => join(dir, e))
+        .sort();
+}
+function extractDescription(file) {
+    let content = "";
+    try {
+        content = readFileSync(file, "utf8");
+    }
+    catch {
+        return "";
+    }
+    // YAML frontmatter description
+    if (content.startsWith("---")) {
+        const end = content.indexOf("\n---", 3);
+        if (end > 0) {
+            const fm = content.slice(3, end);
+            const descMatch = fm.match(/^description:\s*(.+?)$/m);
+            if (descMatch?.[1]) {
+                return descMatch[1]
+                    .trim()
+                    .replace(/^["']|["']$/g, "")
+                    .slice(0, 200)
+                    .replace(/\s+/g, " ");
+            }
+        }
+    }
+    // Fallback: first H1
+    const h1 = content.match(/^# (.+)$/m);
+    if (h1?.[1])
+        return h1[1].slice(0, 200).replace(/\s+/g, " ");
+    return "";
+}
+//# sourceMappingURL=catalog.js.map

package/dist/src/catalog.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration resolution — env vars > config.yaml > defaults.
+ *
+ * Each key is resolved in exactly one place by a precedence-aware reader
+ * (`str`/`num`/`bool`): it reads the env var first, then the YAML file value
+ * (opt-in, loaded by `configFile.ts`), then a default. With no env vars and no
+ * `~/.config/memhook/config.yaml`, resolution collapses to the same defaults
+ * memhook shipped in v0.1, so existing Anthropic setups are unchanged.
+ *
+ * `loadConfig` is total — it must NEVER throw (it runs before the router's
+ * try-boundaries on some paths). All YAML I/O is isolated in `loadYamlConfig`,
+ * which swallows every error to null.
+ */
+export type ProviderType = "anthropic" | "openai" | "ollama";
+export interface MemhookConfig {
+    enabled: boolean;
+    provider: {
+        type: ProviderType;
+        model: string;
+        /** Env var name holding the API key. `undefined` for keyless providers. */
+        apiKeyEnv: string | undefined;
+        baseUrl?: string | undefined;
+        /** Anthropic-only; forwarded to AnthropicProvider, ignored otherwise. */
+        betaHeaders: string[];
+    };
+    selection: {
+        maxFiles: number;
+        maxAdditionalChars: number;
+        maxOutputTokens: number;
+        curlTimeoutMs: number;
+        /** Anthropic-only ephemeral cache TTL; forwarded by the factory. */
+        cacheControlTtl: "5m" | "1h";
+    };
+    cache: {
+        enabled: boolean;
+        ttlMin: number;
+        dir: string;
+        evictionDays: number;
+    };
+    preFilter: {
+        enabled: boolean;
+        trivialWordsFile: string | undefined;
+        defaultWords: string[];
+    };
+    retry: {
+        enabled: boolean;
+        maxAttempts: number;
+        backoffMs: number;
+    };
+    catalog: {
+        path: string;
+    };
+    searchDirs: string[];
+    logging: {
+        jsonlPath: string;
+    };
+    scriptVersion: string;
+}
+export declare function loadConfig(env?: NodeJS.ProcessEnv): MemhookConfig;
+//# sourceMappingURL=config.d.ts.map

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

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

package/dist/src/config.js

@@ -0,0 +1,172 @@
+/**
+ * Configuration resolution — env vars > config.yaml > defaults.
+ *
+ * Each key is resolved in exactly one place by a precedence-aware reader
+ * (`str`/`num`/`bool`): it reads the env var first, then the YAML file value
+ * (opt-in, loaded by `configFile.ts`), then a default. With no env vars and no
+ * `~/.config/memhook/config.yaml`, resolution collapses to the same defaults
+ * memhook shipped in v0.1, so existing Anthropic setups are unchanged.
+ *
+ * `loadConfig` is total — it must NEVER throw (it runs before the router's
+ * try-boundaries on some paths). All YAML I/O is isolated in `loadYamlConfig`,
+ * which swallows every error to null.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { loadYamlConfig } from "./configFile.js";
+import { MEMHOOK_VERSION } from "./version.js";
+/** Per-provider defaults applied once the provider type is known. */
+const PROVIDER_DEFAULTS = {
+    anthropic: { model: "claude-haiku-4-5", apiKeyEnv: "ANTHROPIC_API_KEY", timeoutMs: 8000 },
+    openai: { model: "gpt-4o-mini", apiKeyEnv: "OPENAI_API_KEY", timeoutMs: 8000 },
+    // Local models can be slow to cold-load into RAM/VRAM on the first call, so
+    // Ollama gets a more generous default timeout to avoid aborting every cold start.
+    ollama: { model: "llama3.1", apiKeyEnv: undefined, timeoutMs: 30000 },
+};
+const DEFAULT_TRIVIAL_WORDS = [
+    "ok",
+    "okay",
+    "oui",
+    "non",
+    "no",
+    "yes",
+    "yeah",
+    "yep",
+    "ouais",
+    "ouep",
+    "nope",
+    "merci",
+    "thanks",
+    "thx",
+    "stop",
+    "next",
+    "bien",
+    "nickel",
+    "parfait",
+    "hmm",
+    "hmmm",
+    "hmmmm",
+    "k",
+    "go",
+    "vasy",
+    "tupeux",
+    "lance",
+    "fais",
+    "continue",
+    "continu",
+    "allez",
+    "sure",
+    "sur",
+    "certain",
+];
+function isProviderType(v) {
+    return v === "anthropic" || v === "openai" || v === "ollama";
+}
+export function loadConfig(env = process.env) {
+    const home = homedir();
+    const yaml = loadYamlConfig(env);
+    // Precedence-aware readers: env > yaml > default. One call names each key once.
+    //
+    // Two robustness rules baked in here:
+    //   1. A present-but-empty/whitespace env var is treated as ABSENT (matches
+    //      v0.1's `if (!v)` numeric handling), so `MEMHOOK_MAX_FILES=` falls
+    //      through to yaml/default instead of coercing to 0/"".
+    //   2. The YAML value is parsed leniently and untrusted, so each reader
+    //      type-narrows it at runtime — a wrong-typed key (string for a number,
+    //      number for a bool) is ignored rather than leaking into typed config.
+    const envVal = (envKey) => {
+        const v = env[envKey];
+        return v !== undefined && v.trim() !== "" ? v : undefined;
+    };
+    const str = (envKey, yamlVal, def) => envVal(envKey) ?? (typeof yamlVal === "string" ? yamlVal : undefined) ?? def;
+    const strOpt = (envKey, yamlVal, def) => envVal(envKey) ?? (typeof yamlVal === "string" ? yamlVal : undefined) ?? def;
+    // Every numeric knob is a positive-integer count or duration, so a candidate
+    // is only accepted if it is a finite integer >= 1. This rejects degenerate
+    // values (negative caps, a 0ms timeout that aborts every request, NaN) by
+    // falling through to yaml/default instead of passing them on; fractions are
+    // floored. Defaults are trusted constants and pass through unchecked.
+    const posInt = (n) => Number.isFinite(n) && n >= 1 ? Math.floor(n) : undefined;
+    const num = (envKey, yamlVal, def) => {
+        const v = envVal(envKey);
+        if (v !== undefined) {
+            const fromEnv = posInt(Number(v));
+            if (fromEnv !== undefined)
+                return fromEnv;
+        }
+        const fromYaml = typeof yamlVal === "number" ? posInt(yamlVal) : undefined;
+        return fromYaml ?? def;
+    };
+    // Accepted truthy tokens, case-insensitive: true / 1 / yes / on.
+    const truthy = (v) => {
+        const t = v.trim().toLowerCase();
+        return t === "true" || t === "1" || t === "yes" || t === "on";
+    };
+    // Positive boolean (env wins, then yaml, then default).
+    const bool = (envKey, yamlVal, def) => {
+        const v = envVal(envKey);
+        if (v !== undefined)
+            return truthy(v);
+        return typeof yamlVal === "boolean" ? yamlVal : def;
+    };
+    // Inverted `MEMHOOK_DISABLE_*` env flag mapped onto a positive enabled value.
+    const enabledFromDisable = (disableEnvKey, yamlEnabled, def) => {
+        const v = envVal(disableEnvKey);
+        if (v !== undefined)
+            return !truthy(v);
+        return typeof yamlEnabled === "boolean" ? yamlEnabled : def;
+    };
+    // Provider type first; its per-provider defaults seed model/apiKeyEnv/timeout.
+    const rawType = envVal("MEMHOOK_PROVIDER") ?? yaml?.provider?.type;
+    const type = isProviderType(rawType) ? rawType : "anthropic";
+    const pdef = PROVIDER_DEFAULTS[type];
+    // betaHeaders is the one list-typed key; narrow to a string[] (Anthropic-only).
+    const yamlBetas = yaml?.provider?.betaHeaders;
+    const betaHeaders = Array.isArray(yamlBetas)
+        ? yamlBetas.filter((h) => typeof h === "string")
+        : [];
+    return {
+        enabled: bool("MEMHOOK_ENABLED", yaml?.enabled, true),
+        provider: {
+            type,
+            model: str("MEMHOOK_MODEL", yaml?.provider?.model, pdef.model),
+            apiKeyEnv: strOpt("MEMHOOK_API_KEY_ENV", yaml?.provider?.apiKeyEnv, pdef.apiKeyEnv),
+            baseUrl: strOpt("MEMHOOK_BASE_URL", yaml?.provider?.baseUrl, undefined),
+            betaHeaders,
+        },
+        selection: {
+            maxFiles: num("MEMHOOK_MAX_FILES", yaml?.selection?.maxFiles, 5),
+            maxAdditionalChars: num("MEMHOOK_MAX_ADDITIONAL_CHARS", yaml?.selection?.maxAdditionalChars, 9500),
+            maxOutputTokens: num("MEMHOOK_MAX_OUTPUT_TOKENS", yaml?.selection?.maxOutputTokens, 200),
+            curlTimeoutMs: num("MEMHOOK_TIMEOUT_MS", yaml?.selection?.timeoutMs, pdef.timeoutMs),
+            cacheControlTtl: "1h",
+        },
+        cache: {
+            enabled: enabledFromDisable("MEMHOOK_DISABLE_CACHE", yaml?.cache?.enabled, true),
+            ttlMin: num("MEMHOOK_CACHE_TTL_MIN", yaml?.cache?.ttlMin, 60),
+            dir: str("MEMHOOK_CACHE_DIR", yaml?.cache?.dir, join(home, ".cache", "memhook")),
+            evictionDays: num("MEMHOOK_CACHE_EVICT_DAYS", yaml?.cache?.evictionDays, 7),
+        },
+        preFilter: {
+            enabled: enabledFromDisable("MEMHOOK_DISABLE_PREFILTER", yaml?.preFilter?.enabled, true),
+            trivialWordsFile: strOpt("MEMHOOK_TRIVIAL_FILE", yaml?.preFilter?.trivialWordsFile, join(home, ".config", "memhook", "trivial-words.txt")),
+            defaultWords: DEFAULT_TRIVIAL_WORDS,
+        },
+        retry: {
+            enabled: true,
+            maxAttempts: 2,
+            backoffMs: 500,
+        },
+        catalog: {
+            path: str("MEMHOOK_CATALOG_PATH", yaml?.catalog?.path, join(home, ".claude", "cache", "memory-catalog.txt")),
+        },
+        searchDirs: [
+            str("MEMHOOK_PROJECTS_ROOT", yaml?.searchDirs?.projectsRoot, join(home, ".claude", "projects")),
+            str("MEMHOOK_GLOBAL_RULES_DIR", yaml?.searchDirs?.globalRulesDir, join(home, ".claude", "rules")),
+        ],
+        logging: {
+            jsonlPath: str("MEMHOOK_LOG_PATH", yaml?.logging?.jsonlPath, join(home, ".claude", "logs", "memhook.log")),
+        },
+        scriptVersion: MEMHOOK_VERSION,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

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

package/dist/src/configFile.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Optional YAML config file loader.
+ *
+ * Resolution: `$MEMHOOK_CONFIG`, else `~/.config/memhook/config.yaml`. The file
+ * is entirely opt-in — when it is absent, `loadYamlConfig` returns null and the
+ * config layer collapses to exactly the env-var-or-default behaviour of v0.1.
+ *
+ * This module is the ONLY place YAML I/O happens, and it must NEVER throw: any
+ * error (missing file, unreadable, malformed YAML, non-object root) resolves to
+ * null so `loadConfig` stays total and the hook stays fail-soft. The `yaml`
+ * parser is lenient (it can return a partial object for malformed input), so
+ * callers must still treat the returned shape as untrusted and narrow each
+ * field — see `config.ts`.
+ */
+/** A YAML config mirrors a subset of MemhookConfig. Every key is optional. */
+export interface RawConfigFile {
+    enabled?: boolean;
+    provider?: {
+        type?: string;
+        model?: string;
+        apiKeyEnv?: string;
+        baseUrl?: string;
+        betaHeaders?: string[];
+    };
+    selection?: {
+        maxFiles?: number;
+        maxAdditionalChars?: number;
+        maxOutputTokens?: number;
+        timeoutMs?: number;
+    };
+    cache?: {
+        enabled?: boolean;
+        ttlMin?: number;
+        dir?: string;
+        evictionDays?: number;
+    };
+    preFilter?: {
+        enabled?: boolean;
+        trivialWordsFile?: string;
+    };
+    catalog?: {
+        path?: string;
+    };
+    searchDirs?: {
+        projectsRoot?: string;
+        globalRulesDir?: string;
+    };
+    logging?: {
+        jsonlPath?: string;
+    };
+}
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../../src/configFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,UAAU,CAAC,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAEhE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,aAAa,GAAG,IAAI,CA2B3E"}

package/dist/src/configFile.js

@@ -0,0 +1,51 @@
+/**
+ * Optional YAML config file loader.
+ *
+ * Resolution: `$MEMHOOK_CONFIG`, else `~/.config/memhook/config.yaml`. The file
+ * is entirely opt-in — when it is absent, `loadYamlConfig` returns null and the
+ * config layer collapses to exactly the env-var-or-default behaviour of v0.1.
+ *
+ * This module is the ONLY place YAML I/O happens, and it must NEVER throw: any
+ * error (missing file, unreadable, malformed YAML, non-object root) resolves to
+ * null so `loadConfig` stays total and the hook stays fail-soft. The `yaml`
+ * parser is lenient (it can return a partial object for malformed input), so
+ * callers must still treat the returned shape as untrusted and narrow each
+ * field — see `config.ts`.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parse } from "yaml";
+export function resolveConfigPath(env) {
+    return env["MEMHOOK_CONFIG"] ?? join(homedir(), ".config", "memhook", "config.yaml");
+}
+export function loadYamlConfig(env) {
+    const path = resolveConfigPath(env);
+    if (!existsSync(path))
+        return null;
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        // logLevel "error" keeps stray parser warnings off stderr (the hook must
+        // never emit noise). Malformed YAML throws YAMLParseError -> caught -> null.
+        parsed = parse(text, { logLevel: "error" });
+    }
+    catch {
+        if (env["MEMHOOK_DEBUG"] === "true") {
+            process.stderr.write(`memhook: ignoring unparseable config at ${path}\n`);
+        }
+        return null;
+    }
+    // The parser is lenient and may return scalars/arrays/null — only trust a
+    // plain object root.
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    return parsed;
+}
+//# sourceMappingURL=configFile.js.map

package/dist/src/configFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../../src/configFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAwC7B,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,OAAO,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,yEAAyE;QACzE,6EAA6E;QAC7E,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,IAAI,IAAI,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0EAA0E;IAC1E,qBAAqB;IACrB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAChF,OAAO,MAAuB,CAAC;AACjC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Memhook public API surface.
+ *
+ * Consumers typically don't import these directly — the package is invoked
+ * as a Claude Code hook via `memhook run` or `node dist/router.js`. Exposed
+ * here for programmatic embedding (tests, plugins, custom dashboards).
+ */
+export { loadConfig, type MemhookConfig, type ProviderType } from "./config.js";
+export { loadYamlConfig, resolveConfigPath, type RawConfigFile } from "./configFile.js";
+export { route, type HookInput, type HookOutput } from "./router.js";
+export { buildCatalog, type CatalogBuildOptions } from "./catalog.js";
+export { LocalCache, type CacheKeyInput } from "./cache.js";
+export { PreFilter } from "./preFilter.js";
+export { MEMHOOK_VERSION } from "./version.js";
+export { createProvider } from "./providers/factory.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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EACV,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,GACf,MAAM,sBAAsB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,19 @@
+/**
+ * Memhook public API surface.
+ *
+ * Consumers typically don't import these directly — the package is invoked
+ * as a Claude Code hook via `memhook run` or `node dist/router.js`. Exposed
+ * here for programmatic embedding (tests, plugins, custom dashboards).
+ */
+export { loadConfig } from "./config.js";
+export { loadYamlConfig, resolveConfigPath } from "./configFile.js";
+export { route } from "./router.js";
+export { buildCatalog } from "./catalog.js";
+export { LocalCache } from "./cache.js";
+export { PreFilter } from "./preFilter.js";
+export { MEMHOOK_VERSION } from "./version.js";
+export { createProvider } from "./providers/factory.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/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAyC,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAsB,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,KAAK,EAAmC,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,YAAY,EAA4B,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAiC,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/preFilter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pre-filter trivial prompts — skip the LLM call entirely on acks like
+ * "ok", "yeah", "merci", etc. Conservative by design: better to false-negative
+ * (call Haiku unnecessarily) than false-positive (skip a real prompt).
+ *
+ * Strategy:
+ *   - Strip whitespace and punctuation from the prompt
+ *   - Lowercase
+ *   - Exact match against the trivial word list (file > defaults)
+ */
+export declare class PreFilter {
+    private readonly words;
+    constructor(filePath: string | undefined, defaults: string[]);
+    isTrivial(prompt: string): boolean;
+}
+//# sourceMappingURL=preFilter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preFilter.d.ts","sourceRoot":"","sources":["../../src/preFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE;IAgB5D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;CAKnC"}

package/dist/src/preFilter.js

@@ -0,0 +1,40 @@
+/**
+ * Pre-filter trivial prompts — skip the LLM call entirely on acks like
+ * "ok", "yeah", "merci", etc. Conservative by design: better to false-negative
+ * (call Haiku unnecessarily) than false-positive (skip a real prompt).
+ *
+ * Strategy:
+ *   - Strip whitespace and punctuation from the prompt
+ *   - Lowercase
+ *   - Exact match against the trivial word list (file > defaults)
+ */
+import { existsSync, readFileSync } from "node:fs";
+export class PreFilter {
+    words;
+    constructor(filePath, defaults) {
+        let words = defaults;
+        if (filePath && existsSync(filePath)) {
+            try {
+                const raw = readFileSync(filePath, "utf8");
+                words = raw
+                    .split(/\r?\n/)
+                    .map((line) => line.trim())
+                    .filter((line) => line.length > 0 && !line.startsWith("#"));
+            }
+            catch {
+                // fall back to defaults silently
+            }
+        }
+        this.words = new Set(words.map((w) => normalise(w)));
+    }
+    isTrivial(prompt) {
+        const trim = normalise(prompt);
+        if (trim.length === 0)
+            return true;
+        return this.words.has(trim);
+    }
+}
+function normalise(input) {
+    return input.replace(/[\s\p{P}]/gu, "").toLowerCase();
+}
+//# sourceMappingURL=preFilter.js.map

package/dist/src/preFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preFilter.js","sourceRoot":"","sources":["../../src/preFilter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,OAAO,SAAS;IACH,KAAK,CAAc;IAEpC,YAAY,QAA4B,EAAE,QAAkB;QAC1D,IAAI,KAAK,GAAG,QAAQ,CAAC;QACrB,IAAI,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC3C,KAAK,GAAG,GAAG;qBACR,KAAK,CAAC,OAAO,CAAC;qBACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;qBAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACxD,CAAC"}