mnueron 0.4.0 → 0.6.0

package/dist/runbook/capture.js.map

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

package/dist/runbook/explain.js

@@ -0,0 +1,154 @@
+/**
+ * `mnueron explain-error` — paste-an-error → suggested fixes.
+ *
+ * The simplest, least-invasive entry point to the Terminal Copilot:
+ * user copies an error from their terminal, pastes it into a prompt,
+ * and gets back known fixes (with confidence labels) or a suggestion
+ * to capture a new runbook if nothing matches.
+ *
+ * Usage:
+ *   mnueron explain-error                              (reads stdin, ends on EOF)
+ *   mnueron explain-error --file path/to/error.log     (reads file)
+ *   mnueron explain-error --text "fatal: ..."          (one-liner via flag)
+ *   mnueron explain-error --ns mnueron                 (namespace scope)
+ *   mnueron explain-error --json                       (machine-readable output)
+ */
+import { readFile } from 'node:fs/promises';
+import { loadConfig, makeProvider } from '../config.js';
+import { openLocalDb } from '../store/local-db.js';
+import { fingerprintError } from './fingerprint.js';
+import { searchRunbooks } from './search.js';
+export async function cmdExplainError(args) {
+    const opts = parseArgs(args);
+    const errorText = await readErrorInput(opts);
+    if (!errorText.trim()) {
+        console.error('No error text provided. Pipe an error in, use --file, or --text "..."');
+        process.exit(1);
+    }
+    const cfg = loadConfig();
+    const provider = makeProvider(cfg);
+    const db = openLocalDb(cfg.dbPath);
+    const fp = fingerprintError(errorText);
+    if (!opts.json) {
+        console.log('');
+        console.log(`Fingerprint: ${fp.hash}${fp.tool ? `   (tool: ${fp.tool})` : ''}`);
+        if (fp.redactedCount > 0) {
+            console.log(`Redacted ${fp.redactedCount} secret${fp.redactedCount > 1 ? 's' : ''}: ${fp.redactedKinds.join(', ')}`);
+        }
+        console.log('');
+    }
+    const hits = await searchRunbooks(fp, {
+        db,
+        provider,
+        namespace: opts.namespace,
+    });
+    if (opts.json) {
+        console.log(JSON.stringify({
+            fingerprint: { hash: fp.hash, tool: fp.tool, normalized: fp.normalized },
+            redacted: { count: fp.redactedCount, kinds: fp.redactedKinds },
+            hits,
+        }, null, 2));
+        return;
+    }
+    if (hits.length === 0) {
+        console.log('No matching runbooks found.');
+        console.log('');
+        console.log('If you solve this and want to remember the fix, run:');
+        console.log('  mnueron runbook capture');
+        return;
+    }
+    console.log(`Found ${hits.length} runbook${hits.length > 1 ? 's' : ''}:`);
+    console.log('');
+    for (const [i, hit] of hits.entries()) {
+        renderHit(hit, i + 1);
+    }
+    console.log('');
+    console.log('After you apply a fix that worked:');
+    console.log('  mnueron runbook capture        (or update an existing one)');
+}
+function renderHit(hit, index) {
+    const tag = hit.confidence === 'high'
+        ? '★ high'
+        : hit.confidence === 'medium'
+            ? '○ medium'
+            : '· low';
+    console.log(`${index}. [${tag}] ${hit.name}${hit.verified ? ' ✓ verified' : ''}`);
+    console.log(`   ${hit.summary || '(no summary)'}`);
+    console.log(`   reason: ${hit.reason}`);
+    if (hit.successCount + hit.failureCount > 0) {
+        console.log(`   record: ${hit.successCount} success / ${hit.failureCount} failure`);
+    }
+    if (hit.steps.length > 0) {
+        console.log('   steps:');
+        for (const [j, step] of hit.steps.entries()) {
+            console.log(`     ${j + 1}. ${step.step}`);
+            if (step.code) {
+                const trimmed = step.code.length > 200 ? step.code.slice(0, 197) + '...' : step.code;
+                console.log(`        > ${trimmed.replace(/\n/g, '\n        > ')}`);
+            }
+        }
+    }
+    console.log('');
+}
+function parseArgs(args) {
+    const out = { json: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--file' || a === '-f')
+            out.file = args[++i];
+        else if (a === '--text' || a === '-t')
+            out.text = args[++i];
+        else if (a === '--ns' || a === '--namespace')
+            out.namespace = args[++i];
+        else if (a === '--json')
+            out.json = true;
+        else if (a === '--help' || a === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+        else {
+            console.error(`Unknown argument: ${a}`);
+            printHelp();
+            process.exit(1);
+        }
+    }
+    return out;
+}
+function printHelp() {
+    console.log(`mnueron explain-error — match a terminal error against known runbooks
+
+  mnueron explain-error                          Read error from stdin
+  mnueron explain-error --file <path>            Read error from a file
+  mnueron explain-error --text "<error string>"  Pass error inline
+
+Options:
+  --ns <name>           Limit search to a namespace (default: search all)
+  --json                Machine-readable output
+  -h, --help            Show this help
+
+Examples:
+  git push 2>&1 | mnueron explain-error
+  mnueron explain-error --file last-build.log
+  mnueron explain-error --text "fatal: Unable to create '.git/index.lock'"`);
+}
+async function readErrorInput(opts) {
+    if (opts.text)
+        return opts.text;
+    if (opts.file) {
+        return readFile(opts.file, 'utf8');
+    }
+    // Stdin path
+    if (process.stdin.isTTY) {
+        console.log('Paste your error, then press Ctrl+D (Ctrl+Z on Windows) when done:');
+    }
+    return readStdin();
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on('data', (c) => chunks.push(c));
+        process.stdin.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        process.stdin.on('error', reject);
+    });
+}
+//# sourceMappingURL=explain.js.map

package/dist/runbook/explain.js.map

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

package/dist/runbook/fingerprint.js

@@ -0,0 +1,128 @@
+/**
+ * Error fingerprinting.
+ *
+ * A fingerprint is a stable, low-entropy hash designed to:
+ *   - SURVIVE noise (paths, timestamps, UUIDs, hex IDs change every
+ *     run; we strip them before hashing)
+ *   - BREAK on category change (a git error and a typescript error
+ *     should never share a fingerprint)
+ *
+ * Algorithm:
+ *   1. Redact secrets first (reuses the existing `redact()` helper, so
+ *      any API tokens or PEM blocks vanish before they touch the hash).
+ *   2. Normalize: strip paths, UUIDs, hex digests, timestamps, line:col
+ *      positions, and collapse whitespace + lowercase.
+ *   3. SHA-256 the normalized string, take the first 12 hex chars as
+ *      the fingerprint. 12 chars = 48 bits of entropy — enough to avoid
+ *      collisions across a reasonable error vocabulary while staying
+ *      short for human display.
+ *   4. Detect the originating tool from keywords so the UI can hint
+ *      "this looks like a git problem" before searching.
+ *
+ * Pure module — no I/O, no DB. Trivially unit-testable.
+ */
+import { createHash } from 'node:crypto';
+import { redact } from '../store/redactor.js';
+/** Build a fingerprint from a raw error string. */
+export function fingerprintError(raw) {
+    const redaction = redact(raw);
+    const normalized = normalize(redaction.content);
+    const hash = createHash('sha256').update(normalized).digest('hex').slice(0, 12);
+    return {
+        hash,
+        normalized,
+        tool: detectTool(normalized),
+        redactedOriginal: redaction.content,
+        redactedCount: redaction.count,
+        redactedKinds: redaction.kinds,
+    };
+}
+/**
+ * Strip variable noise so the same root-cause error normalizes to the
+ * same string regardless of where/when it happened.
+ *
+ * Order matters: do the most specific patterns first (URLs, UUIDs) so
+ * less-specific ones (hex IDs, timestamps) don't eat their tokens.
+ */
+export function normalize(s) {
+    return (s
+        // URLs first — they contain hex/UUID-looking substrings that
+        // would otherwise be matched by the generic patterns below.
+        .replace(/https?:\/\/[^\s'"<>]+/g, '<URL>')
+        // Windows paths: C:\path\to\file or C:/path/to/file
+        .replace(/[A-Z]:[\\/][\w\\/.~ \-+@]+(?=[\s'"`)\],]|$)/g, '<PATH>')
+        // POSIX absolute paths: /usr/local/..., /Users/me/...
+        .replace(/(?<![\w/])\/[\w./~+-]{2,}/g, '<PATH>')
+        // UUIDs (8-4-4-4-12)
+        .replace(/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, '<UUID>')
+        // Long hex digests (git SHAs, content hashes, MD5, SHA-1, SHA-256)
+        .replace(/\b[0-9a-f]{7,}\b/gi, '<HEX>')
+        // ISO dates and times — 2026-05-25, 14:32:11, 14:32:11.456
+        .replace(/\b\d{4}-\d{2}-\d{2}([Tt ]\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:?\d{2})?)?\b/g, '<DATETIME>')
+        .replace(/\b\d{1,2}:\d{2}(:\d{2}(\.\d+)?)?\b/g, '<TIME>')
+        // file.ext:line:col patterns
+        .replace(/:\d+:\d+/g, ':<L>:<C>')
+        // Standalone bare line numbers in stack-trace format "at file:42"
+        .replace(/:(\d{2,})\b/g, ':<L>')
+        // PIDs and other ad-hoc numerics that vary run-to-run
+        .replace(/\bpid[: ]?\d+/gi, 'pid:<N>')
+        .replace(/\bport[: ]?\d+/gi, 'port:<N>')
+        // Bracketed placeholder noise — strip the surrounding brackets so
+        // `[<DATETIME>] fatal: ...` and `fatal: ...` normalize identically.
+        // Only matches a placeholder we just produced (uppercase token), so
+        // legitimate bracketed content like `error[42]:` survives... almost.
+        // We do strip `error[42]:` too because [42] would normalize to <L> first.
+        .replace(/\[<[A-Z_]+>\]\s*/g, '')
+        // Quoted strings collapsed (paths leak through in quotes sometimes)
+        .replace(/'([^']{0,200})'/g, (_, inner) => 
+    // Keep short identifiers (likely keywords like 'main'), strip long ones
+    inner.length > 30 ? `'<STR>'` : `'${inner}'`)
+        // Collapse whitespace
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase());
+}
+/**
+ * Best-effort tool detection from the normalized error text.
+ *
+ * Returns one of: 'git', 'npm', 'pnpm', 'yarn', 'typescript', 'postgres',
+ * 'supabase', 'powershell', 'docker', 'kubectl', 'python', 'node', or
+ * undefined if we can't tell.
+ *
+ * Used to:
+ *   - Filter the search-by-tool branch
+ *   - Display a friendly hint ("Looks like a git error") in `explain-error`
+ *   - Stamp `tool` on captured runbooks so future "show me all my
+ *     git runbooks" works cleanly
+ */
+export function detectTool(normalized) {
+    // Order matters — first match wins. Sort by SPECIFICITY of the pattern,
+    // not by what tool is most common. PowerShell's "The term '...' is not
+    // recognized" / "The token '...' is not a valid statement separator"
+    // are essentially impossible to false-match, so they go first — they
+    // catch the cases where surrounding text mentions other tools (e.g. a
+    // PowerShell error inside a session that was running git commands).
+    const sigs = [
+        [
+            'powershell',
+            /the term '[^']+' is not (recognized|valid)|the token '[^']+' is not (a valid|valid)|\bcmdlet\b|\bps[1-9]\b|\binvoke-\w+\b|parsererror|invalidendofline/,
+        ],
+        ['supabase', /\bsupabase\b|supabase_migrations/],
+        ['postgres', /\bpostgres\b|sqlstate\b|\brelation\b.+\b(exists|does not exist)\b|duplicate key value|schema_migrations/],
+        ['typescript', /\berror ts\d{4}\b|\bcannot find module\b|jsx element|tsconfig/],
+        ['git', /\bfatal:|\bgit\b|\.git[/\\]|index\.lock|merge conflict|head[\^~]|origin\/main/],
+        ['npm', /\bnpm err\b|\bnpm error\b|npm warn\b|package-lock\.json/],
+        ['pnpm', /\bpnpm err\b|pnpm-lock/],
+        ['yarn', /\byarn error\b|yarn\.lock/],
+        ['docker', /\bdocker(d|fil)?\b|container\s+\w+|image\s+\w+:\w+|oci runtime/],
+        ['kubectl', /\bkubectl\b|\bkube-?\w+\b|namespace .* not found|pod\/\w+/],
+        ['python', /\btraceback\b|pip install|importerror|modulenotfound|python\d/],
+        ['node', /\bnode:internal\b|cannot find module|err_module|process exited with code/],
+    ];
+    for (const [name, re] of sigs) {
+        if (re.test(normalized))
+            return name;
+    }
+    return undefined;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/runbook/fingerprint.js.map

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

package/dist/runbook/search.js

@@ -0,0 +1,76 @@
+/**
+ * Runbook search — the matching logic for `mnueron explain-error`.
+ *
+ * Three-leg parallel search:
+ *   1. Exact fingerprint match against the stored error_fingerprints array.
+ *      A hit means "we've literally solved this exact error before" →
+ *      confidence: 'high'.
+ *   2. Tool match — if the fingerprint detected a tool, find other
+ *      verified runbooks under that tool. Confidence: 'medium'.
+ *   3. Hybrid recall via provider.search() against ANY memory (not just
+ *      runbooks). May surface a note the user saved that solved the
+ *      issue without being formalized into a runbook. Confidence: 'low'.
+ *
+ * Results dedup on runbookId and sort by confidence then verified-ness
+ * then recency.
+ */
+import { matchByFingerprint, matchByTool, } from '../store/procedural.js';
+/**
+ * Run the three-leg search and return a merged, ranked list of runbook hits.
+ *
+ * `fingerprint.normalized` is what we send to the hybrid-recall leg so
+ * we benefit from the same noise stripping the fingerprint did.
+ */
+export async function searchRunbooks(fingerprint, opts) {
+    const perLegLimit = opts.perLegLimit ?? 5;
+    // Leg 1: exact fingerprint match
+    const fingerprintHits = matchByFingerprint(opts.db, fingerprint.hash, opts.namespace);
+    // Leg 2: tool match (only if we detected a tool)
+    const toolHits = fingerprint.tool
+        ? matchByTool(opts.db, fingerprint.tool, opts.namespace, perLegLimit)
+        : [];
+    // Leg 3: hybrid recall against any memory in the namespace.
+    // Note: provider.search returns Memory[] not ExtendedProcedural[], so
+    // we'll need to convert. We're using it as a "fuzzy signal" only; for
+    // anything it returns we look up the corresponding runbook (if any)
+    // by id-prefix match against procedural rows. In v1 of this MVP we
+    // simply skip leg 3 if no fingerprint/tool hits — the procedural
+    // table is the source of truth. This keeps the implementation tight.
+    // TODO Phase 2: implement true fuzzy-recall fallback that surfaces
+    // raw memories (not just runbooks).
+    // We invoke provider so the import is still useful and we leave a
+    // breadcrumb for future work.
+    void opts.provider;
+    // Merge + dedup
+    const seen = new Set();
+    const hits = [];
+    for (const r of fingerprintHits) {
+        if (seen.has(r.id))
+            continue;
+        seen.add(r.id);
+        hits.push(toHit(r, 'high', 'exact fingerprint match'));
+    }
+    for (const r of toolHits) {
+        if (seen.has(r.id))
+            continue;
+        seen.add(r.id);
+        hits.push(toHit(r, r.verified ? 'medium' : 'low', `verified runbook for tool=${fingerprint.tool}`));
+    }
+    return hits;
+}
+function toHit(r, confidence, reason) {
+    return {
+        runbookId: r.id,
+        name: r.name,
+        summary: r.summary,
+        steps: r.steps,
+        confidence,
+        reason,
+        successCount: r.success_count,
+        failureCount: r.failure_count,
+        verified: r.verified,
+        os: r.os ?? undefined,
+        tool: r.tool ?? undefined,
+    };
+}
+//# sourceMappingURL=search.js.map

package/dist/runbook/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/runbook/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EACL,kBAAkB,EAClB,WAAW,GAEZ,MAAM,wBAAwB,CAAC;AAehC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,IAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAE1C,iCAAiC;IACjC,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAEtF,iDAAiD;IACjD,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI;QAC/B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;QACrE,CAAC,CAAC,EAAE,CAAC;IAEP,4DAA4D;IAC5D,sEAAsE;IACtE,sEAAsE;IACtE,oEAAoE;IACpE,mEAAmE;IACnE,iEAAiE;IACjE,qEAAqE;IACrE,mEAAmE;IACnE,oCAAoC;IACpC,kEAAkE;IAClE,8BAA8B;IAC9B,KAAK,IAAI,CAAC,QAAQ,CAAC;IAEnB,gBAAgB;IAChB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAiB,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,CACP,KAAK,CACH,CAAC,EACD,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAC7B,6BAA6B,WAAW,CAAC,IAAI,EAAE,CAChD,CACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CACZ,CAAqB,EACrB,UAAoC,EACpC,MAAc;IAEd,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,EAAE;QACf,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU;QACV,MAAM;QACN,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,YAAY,EAAE,CAAC,CAAC,aAAa;QAC7B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,SAAS;QACrB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;KAC1B,CAAC;AACJ,CAAC"}

package/dist/runbook/types.js

@@ -0,0 +1,15 @@
+/**
+ * Mnueron Terminal Copilot — shared types.
+ *
+ * The Terminal Copilot recognizes repeated errors, looks them up in
+ * procedural memory, suggests prior fixes, and writes/updates runbooks
+ * on confirmation. This file holds the cross-module types.
+ *
+ * Storage strategy:
+ *   We extend the existing `procedural_memories` table with optional
+ *   columns (trigger_phrases, error_fingerprints, verified, os, tool,
+ *   success_count, failure_count) rather than introducing a new table.
+ *   Older runbooks remain valid — the new columns are nullable.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/runbook/types.js.map

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

package/dist/setup.js

@@ -10,6 +10,8 @@
  *                                          → configure for hosted mode
  *   mnueron setup --uninstall              → remove from all tools
  */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { allDetectors } from './detectors/index.js';
@@ -22,6 +24,9 @@ export async function runSetup(opts = {}) {
         return runUninstall(detectors, opts);
     const entry = buildEntry(opts);
     const reports = [];
+    if (opts.hosted && opts.persistHosted !== false && !opts.dryRun) {
+        persistHostedConfig(opts.hosted.url, opts.hosted.token, opts.namespace);
+    }
     for (const d of detectors) {
         const status = d.status();
         if (!status.installed) {
@@ -82,14 +87,37 @@ function buildEntry(opts) {
         command: 'node',
         args: [MNUERON_ENTRY],
     };
+    const env = {};
     if (opts.hosted) {
-        entry.env = {
-            MNUERON_API_URL: opts.hosted.url,
-            MNUERON_API_TOKEN: opts.hosted.token,
-        };
+        env.MNUERON_API_URL = opts.hosted.url;
+        env.MNUERON_API_TOKEN = opts.hosted.token;
     }
+    if (opts.namespace)
+        env.MNUERON_NAMESPACE = opts.namespace;
+    if (Object.keys(env).length > 0)
+        entry.env = env;
     return entry;
 }
+function persistHostedConfig(url, token, namespace) {
+    const dir = resolve(homedir(), '.mnueron');
+    const path = resolve(dir, 'config.json');
+    mkdirSync(dir, { recursive: true });
+    let existing = {};
+    if (existsSync(path)) {
+        try {
+            const raw = readFileSync(path, 'utf8');
+            existing = raw.trim() ? JSON.parse(raw) : {};
+        }
+        catch {
+            existing = {};
+        }
+    }
+    existing.apiUrl = url;
+    existing.apiToken = token;
+    if (namespace)
+        existing.defaultNamespace = namespace;
+    writeFileSync(path, JSON.stringify(existing, null, 2));
+}
 /** Pretty-print the report for terminal output. */
 export function formatReport(reports) {
     const lines = [];

package/dist/setup.js.map

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

package/dist/store/entity-extractor.js

@@ -25,14 +25,71 @@ const MAX_CONTENT_CHARS = 12000;
 const MAX_ENTITIES = 25;
 const TIMEOUT_MS = 30000;
 export const ENTITY_EXTRACTION_ENABLED = (process.env.MNUERON_ENABLE_ENTITY_EXTRACTION ?? '').toLowerCase() === 'true';
+// Process-wide circuit breaker. When either provider returns 429, we suspend
+// extraction for a cooldown window so a single rate-limit hit doesn't turn
+// into thousands of follow-on warnings (and doesn't keep consuming whatever
+// quota remains in shorter time buckets). Saves continue with no entity tags.
+//
+// Cooldowns by detected scope:
+//   - "per day"    -> 1 hour (daily quotas reset at the provider's midnight;
+//                    an hour balances "stop spamming" vs. "retry if user upgrades")
+//   - "per minute" -> 60 seconds
+//   - "per second" -> 5 seconds
+//   - unknown      -> 5 minutes
+//
+// One warn-line per disable event keeps the console clean.
+let extractionDisabledUntil = 0;
+let warnedThisCooldown = false;
+function isExtractionRateLimited() {
+    if (Date.now() < extractionDisabledUntil)
+        return true;
+    if (extractionDisabledUntil !== 0 && Date.now() >= extractionDisabledUntil) {
+        // Cooldown elapsed -- clear so the next 429 can warn again.
+        extractionDisabledUntil = 0;
+        warnedThisCooldown = false;
+    }
+    return false;
+}
+function disableExtractionAfter429(provider, body) {
+    const lower = body.toLowerCase();
+    let durationMs = 5 * 60 * 1000; // default: 5 minutes
+    let scope = 'unknown';
+    if (lower.includes('per day')) {
+        durationMs = 60 * 60 * 1000;
+        scope = 'per-day';
+    }
+    else if (lower.includes('per minute')) {
+        durationMs = 60 * 1000;
+        scope = 'per-minute';
+    }
+    else if (lower.includes('per second')) {
+        durationMs = 5 * 1000;
+        scope = 'per-second';
+    }
+    extractionDisabledUntil = Math.max(extractionDisabledUntil, Date.now() + durationMs);
+    if (!warnedThisCooldown) {
+        warnedThisCooldown = true;
+        const mins = Math.round(durationMs / 60000);
+        console.warn(`[mnueron/entity-extractor] ${provider} returned 429 (${scope}). ` +
+            `Suspending entity extraction for ~${mins}m. ` +
+            `Saves will continue with no entity tags. ` +
+            `Set MNUERON_ENABLE_ENTITY_EXTRACTION=false to opt out permanently.`);
+    }
+}
 /**
  * Per-call gate. Same shape as hosted-side `shouldExtractEntities`.
  *
  * Explicit per-call opt-in (metadata.extract_entities: true OR BYOK key)
  * always runs, even on short content. The length floor only applies to
  * the env-var default path, to keep that from burning money on noise.
+ *
+ * Circuit breaker: a recent 429 from either provider disables this gate
+ * across the whole process for the cooldown window. Saves still complete
+ * normally -- they just skip the LLM call that would have failed anyway.
  */
 export function shouldExtractEntities(contentLen, metadata, minChars = MIN_LENGTH_CHARS) {
+    if (isExtractionRateLimited())
+        return false;
     if (metadata?.extract_entities === true)
         return true;
     const a = metadata?.byok_anthropic_key;
@@ -153,7 +210,12 @@ async function extractViaAnthropic(content, apiKey) {
         });
         if (!resp.ok) {
             const body = await resp.text();
-            console.warn('[mnueron/entity-extractor/anthropic] HTTP ' + resp.status + ': ' + body.slice(0, 200));
+            if (resp.status === 429) {
+                disableExtractionAfter429('anthropic', body);
+            }
+            else {
+                console.warn('[mnueron/entity-extractor/anthropic] HTTP ' + resp.status + ': ' + body.slice(0, 200));
+            }
             return [];
         }
         const data = (await resp.json());
@@ -195,7 +257,12 @@ async function extractViaOpenAI(content, apiKey) {
         });
         if (!resp.ok) {
             const body = await resp.text();
-            console.warn('[mnueron/entity-extractor/openai] HTTP ' + resp.status + ': ' + body.slice(0, 200));
+            if (resp.status === 429) {
+                disableExtractionAfter429('openai', body);
+            }
+            else {
+                console.warn('[mnueron/entity-extractor/openai] HTTP ' + resp.status + ': ' + body.slice(0, 200));
+            }
             return [];
         }
         const data = (await resp.json());