mnueron 0.4.0 → 0.6.0

package/dist/detectors/codex.js

@@ -0,0 +1,138 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+/**
+ * Codex stores MCP servers in ~/.codex/config.toml:
+ *
+ *   [mcp_servers.<name>]
+ *   command = "..."
+ *   args = [...]
+ *
+ *   [mcp_servers.<name>.env]
+ *   KEY = "value"
+ *
+ * This detector edits only the mnueron block and leaves the rest of the TOML
+ * untouched. It intentionally avoids a full TOML parser dependency.
+ */
+export class CodexDetector {
+    id = 'codex';
+    displayName = 'Codex';
+    configPath() {
+        return join(homedir(), '.codex', 'config.toml');
+    }
+    status() {
+        const path = this.configPath();
+        const dir = dirname(path);
+        const installed = existsSync(dir) || existsSync(path);
+        const configExists = existsSync(path);
+        let alreadyConfigured = false;
+        if (configExists) {
+            try {
+                const raw = readFileSync(path, 'utf8');
+                alreadyConfigured = hasServerBlock(raw, 'mnueron');
+            }
+            catch {
+                alreadyConfigured = false;
+            }
+        }
+        return {
+            id: this.id,
+            displayName: this.displayName,
+            installed,
+            configPath: path,
+            configExists,
+            alreadyConfigured,
+            note: 'writes ~/.codex/config.toml',
+        };
+    }
+    install(serverName, entry) {
+        const path = this.configPath();
+        mkdirSync(dirname(path), { recursive: true });
+        const codexEntry = {
+            ...entry,
+            command: entry.command === 'node' ? process.execPath : entry.command,
+        };
+        let raw = '';
+        if (existsSync(path)) {
+            try {
+                raw = readFileSync(path, 'utf8');
+            }
+            catch (e) {
+                return { ok: false, changed: false, message: `failed to read ${path}: ${e?.message ?? e}` };
+            }
+        }
+        const before = raw;
+        const withoutOld = removeServerBlock(raw, serverName).trimEnd();
+        const next = `${withoutOld}${withoutOld ? '\n\n' : ''}${formatServerBlock(serverName, codexEntry)}\n`;
+        const changed = before !== next;
+        writeFileSync(path, next);
+        return {
+            ok: true,
+            changed,
+            configPath: path,
+            message: changed
+                ? (hasServerBlock(before, serverName) ? 'updated existing entry' : 'added')
+                : 'already up to date',
+        };
+    }
+    uninstall(serverName) {
+        const path = this.configPath();
+        if (!existsSync(path))
+            return { ok: true, removed: false, message: 'nothing to remove' };
+        try {
+            const raw = readFileSync(path, 'utf8');
+            const next = removeServerBlock(raw, serverName).trimEnd() + '\n';
+            const removed = raw !== next;
+            if (removed)
+                writeFileSync(path, next);
+            return { ok: true, removed, message: removed ? 'removed' : 'not registered' };
+        }
+        catch (e) {
+            return { ok: false, removed: false, message: `failed: ${e?.message ?? e}` };
+        }
+    }
+}
+function hasServerBlock(raw, serverName) {
+    return new RegExp(`^\\[mcp_servers\\.${escapeRegExp(serverName)}\\]`, 'm').test(raw);
+}
+function removeServerBlock(raw, serverName) {
+    const lines = raw.split(/\r?\n/);
+    const out = [];
+    let skipping = false;
+    for (const line of lines) {
+        const header = line.match(/^\s*\[([^\]]+)\]\s*$/);
+        if (header) {
+            const section = header[1].trim();
+            if (section === `mcp_servers.${serverName}` || section === `mcp_servers.${serverName}.env`) {
+                skipping = true;
+                continue;
+            }
+            skipping = false;
+        }
+        if (!skipping)
+            out.push(line);
+    }
+    return out.join('\n');
+}
+function formatServerBlock(serverName, entry) {
+    const lines = [];
+    lines.push(`[mcp_servers.${serverName}]`);
+    lines.push(`command = ${tomlString(entry.command)}`);
+    lines.push(`args = [${entry.args.map(tomlString).join(', ')}]`);
+    lines.push('startup_timeout_sec = 120');
+    if (entry.env && Object.keys(entry.env).length > 0) {
+        lines.push('');
+        lines.push(`[mcp_servers.${serverName}.env]`);
+        for (const [key, value] of Object.entries(entry.env)) {
+            lines.push(`${key} = ${tomlString(value)}`);
+        }
+    }
+    return lines.join('\n');
+}
+function tomlString(value) {
+    return JSON.stringify(value);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=codex.js.map

package/dist/detectors/codex.js.map

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

package/dist/detectors/index.js

@@ -8,6 +8,7 @@ import { ZedDetector } from './zed.js';
 import { AiderDetector } from './aider.js';
 import { GooseDetector } from './goose.js';
 import { OpenCodeDetector } from './opencode.js';
+import { CodexDetector } from './codex.js';
 /**
  * Order matters for the setup wizard output. The first five (Claude-family +
  * Cursor + Windsurf + Cline) are the original tier-1 tools. The v0.2.7
@@ -17,6 +18,7 @@ export function allDetectors() {
     return [
         new ClaudeDesktopDetector(),
         new ClaudeCodeDetector(),
+        new CodexDetector(),
         new CursorDetector(),
         new WindsurfDetector(),
         new ClineDetector(),

package/dist/detectors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,qBAAqB,EAAE;QAC3B,IAAI,kBAAkB,EAAE;QACxB,IAAI,cAAc,EAAE;QACpB,IAAI,gBAAgB,EAAE;QACtB,IAAI,aAAa,EAAE;QACnB,IAAI,gBAAgB,EAAE;QACtB,IAAI,WAAW,EAAE;QACjB,IAAI,aAAa,EAAE;QACnB,IAAI,gBAAgB,EAAE;QACtB,IAAI,aAAa,EAAE;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/detectors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,qBAAqB,EAAE;QAC3B,IAAI,kBAAkB,EAAE;QACxB,IAAI,aAAa,EAAE;QACnB,IAAI,cAAc,EAAE;QACpB,IAAI,gBAAgB,EAAE;QACtB,IAAI,aAAa,EAAE;QACnB,IAAI,gBAAgB,EAAE;QACtB,IAAI,WAAW,EAAE;QACjB,IAAI,aAAa,EAAE;QACnB,IAAI,gBAAgB,EAAE;QACtB,IAAI,aAAa,EAAE;KACpB,CAAC;AACJ,CAAC"}

package/dist/detectors/json_detector.js

@@ -89,7 +89,7 @@ export class JsonMcpDetector {
     }
     lastServerName;
     serverNameInConfig() {
-        return this.lastServerName ?? 'engrama';
+        return this.lastServerName ?? 'mnueron';
     }
 }
 //# sourceMappingURL=json_detector.js.map

package/dist/lib/context-engine/confidence.js

@@ -0,0 +1,153 @@
+/**
+ * Confidence scoring + threshold logic for the Context Engine.
+ *
+ * The recall engine searches mnueron memory and returns candidates with
+ * raw hybrid-search scores (BM25 + cosine). Those scores are good for
+ * RANKING within a result set, but they're not directly interpretable
+ * as "should I surface this to the user?"
+ *
+ * This module converts the raw signals (intent classification,
+ * entity matches, raw recall score) into a single confidence value
+ * 0..1, and gates surfacing decisions against a conservative threshold.
+ *
+ * Conservative default 0.75 — only surface high-confidence matches.
+ * Users CAN explicitly lower it for "show me anything you've got" mode.
+ */
+export const DEFAULT_CONFIG = {
+    threshold: 0.75,
+    maxSuggestions: 3,
+    preferRunbooks: true,
+};
+/**
+ * Score a candidate by combining intent fit, entity overlap, raw search
+ * score, and verified-runbook prior.
+ *
+ * The formula:
+ *
+ *   confidence = 0.45 * raw_score
+ *              + 0.20 * intent_fit
+ *              + 0.20 * entity_overlap
+ *              + 0.15 * verified_prior
+ *
+ * Weights tuned for HIGH PRECISION. Boost factors:
+ *   - Verified runbook with >0 successes:  +0.10
+ *   - Verified runbook with >0 failures:   -0.05 (proven not always working)
+ */
+export function scoreCandidate(candidate, intent, entities, config = DEFAULT_CONFIG) {
+    const reasons = [];
+    // ─── Raw search score (0.45 weight) ──────────────────────────────────
+    // BM25+cosine RRF scores from LocalProvider are roughly [0..1].
+    // For runbooks (from procedural_memories) we treat them as already
+    // normalized.
+    const rawComponent = Math.max(0, Math.min(1, candidate.rawScore)) * 0.45;
+    reasons.push(`raw=${(rawComponent / 0.45).toFixed(2)}`);
+    // ─── Intent fit (0.20 weight) ────────────────────────────────────────
+    // High when the intent strongly matches the candidate kind. E.g.,
+    // 'deploying' intent + runbook candidate = good fit. 'debugging' intent
+    // + runbook with `tool=git` and matching error fingerprint = great fit.
+    let intentFit = 0;
+    if (intent.kind === 'none') {
+        intentFit = 0.3; // no penalty for unclassified intent
+    }
+    else if (candidate.kind === 'runbook') {
+        if (intent.kind === 'deploying' || intent.kind === 'debugging')
+            intentFit = 1.0;
+        else if (intent.kind === 'testing' || intent.kind === 'coding')
+            intentFit = 0.7;
+        else
+            intentFit = 0.5;
+    }
+    else {
+        // memory candidate
+        intentFit = 0.6;
+    }
+    const intentComponent = intentFit * 0.20;
+    reasons.push(`intent[${intent.kind}]=${intentFit.toFixed(2)}`);
+    // ─── Entity overlap (0.20 weight) ────────────────────────────────────
+    // How many query entities appear in the candidate content?
+    const candidateLower = (candidate.content ?? '').toLowerCase();
+    let overlap = 0;
+    let possibleOverlap = 0;
+    for (const tech of entities.technologies) {
+        possibleOverlap++;
+        if (candidateLower.includes(tech))
+            overlap++;
+    }
+    for (const file of entities.files) {
+        possibleOverlap++;
+        if (candidateLower.includes(file.toLowerCase()))
+            overlap++;
+    }
+    if (entities.project) {
+        possibleOverlap++;
+        if (candidateLower.includes(entities.project.toLowerCase()))
+            overlap++;
+    }
+    const overlapRatio = possibleOverlap > 0 ? overlap / possibleOverlap : 0.5;
+    const overlapComponent = overlapRatio * 0.20;
+    reasons.push(`entities=${overlap}/${possibleOverlap}`);
+    // ─── Verified prior (0.15 weight) ────────────────────────────────────
+    // A verified runbook with successful uses is more confident than an
+    // unverified draft.
+    let verifiedPrior = 0;
+    if (candidate.kind === 'runbook') {
+        const successes = candidate.successCount ?? 0;
+        const failures = candidate.failureCount ?? 0;
+        if (candidate.verified)
+            verifiedPrior += 0.5;
+        if (successes > 0)
+            verifiedPrior += Math.min(0.5, successes * 0.1);
+        if (failures > 0)
+            verifiedPrior -= Math.min(0.3, failures * 0.05);
+        verifiedPrior = Math.max(0, Math.min(1, verifiedPrior));
+    }
+    else {
+        verifiedPrior = 0.3; // memories don't have verified state; neutral
+    }
+    const verifiedComponent = verifiedPrior * 0.15;
+    reasons.push(`verified=${verifiedPrior.toFixed(2)}`);
+    let confidence = rawComponent + intentComponent + overlapComponent + verifiedComponent;
+    confidence = Math.max(0, Math.min(1, confidence));
+    return {
+        ...candidate,
+        confidence,
+        reason: reasons.join(' '),
+    };
+}
+/**
+ * Filter ranked candidates by threshold and rank. Returns at most
+ * `config.maxSuggestions` candidates above `config.threshold`.
+ */
+export function filterByConfidence(scored, config = DEFAULT_CONFIG) {
+    let threshold = config.threshold;
+    // If runbook preference enabled and we have runbook candidates,
+    // lower threshold for them by 0.1 (runbooks tend to be more
+    // actionable than memories — worth surfacing slightly earlier).
+    const surviving = scored.filter(s => {
+        const effective = config.preferRunbooks && s.kind === 'runbook'
+            ? Math.max(0.5, threshold - 0.1)
+            : threshold;
+        return s.confidence >= effective;
+    });
+    surviving.sort((a, b) => b.confidence - a.confidence);
+    return surviving.slice(0, config.maxSuggestions);
+}
+/**
+ * Decide whether to surface ANY suggestion. Used by the suggestion
+ * service to short-circuit when no candidate clears the bar.
+ *
+ * Returns the surfaced list (possibly empty).
+ */
+export function gateSurfacing(candidates, intent, entities, runbookDetection, config = DEFAULT_CONFIG) {
+    // If intent is 'none' and no entities of substance, don't bother.
+    if (intent.kind === 'none' &&
+        entities.files.length === 0 &&
+        entities.commands.length === 0 &&
+        entities.errors.length === 0 &&
+        !runbookDetection?.isRunbook) {
+        return [];
+    }
+    const scored = candidates.map(c => scoreCandidate(c, intent, entities, config));
+    return filterByConfidence(scored, config);
+}
+//# sourceMappingURL=confidence.js.map

package/dist/lib/context-engine/confidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../../src/lib/context-engine/confidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0CH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,CAAC;IACjB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA0B,EAC1B,MAAqB,EACrB,QAAyB,EACzB,SAA2B,cAAc;IAEzC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,wEAAwE;IACxE,gEAAgE;IAChE,mEAAmE;IACnE,cAAc;IACd,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAExD,wEAAwE;IACxE,kEAAkE;IAClE,wEAAwE;IACxE,wEAAwE;IACxE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,SAAS,GAAG,GAAG,CAAC,CAAC,qCAAqC;IACxD,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS,GAAG,GAAG,CAAC;aAC3E,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS,GAAG,GAAG,CAAC;;YAC3E,SAAS,GAAG,GAAG,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,mBAAmB;QACnB,SAAS,GAAG,GAAG,CAAC;IAClB,CAAC;IACD,MAAM,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE/D,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QACzC,eAAe,EAAE,CAAC;QAClB,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,eAAe,EAAE,CAAC;QAClB,IAAI,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,eAAe,EAAE,CAAC;QAClB,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,EAAE,CAAC;IACzE,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3E,MAAM,gBAAgB,GAAG,YAAY,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;IAEvD,wEAAwE;IACxE,oEAAoE;IACpE,oBAAoB;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,YAAY,IAAI,CAAC,CAAC;QAC7C,IAAI,SAAS,CAAC,QAAQ;YAAE,aAAa,IAAI,GAAG,CAAC;QAC7C,IAAI,SAAS,GAAG,CAAC;YAAE,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC,CAAC;QACnE,IAAI,QAAQ,GAAG,CAAC;YAAE,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;QAClE,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;IAC1D,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,GAAG,CAAC,CAAC,8CAA8C;IACrE,CAAC;IACD,MAAM,iBAAiB,GAAG,aAAa,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,YAAY,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErD,IAAI,UAAU,GAAG,YAAY,GAAG,eAAe,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;IACvF,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;IAElD,OAAO;QACL,GAAG,SAAS;QACZ,UAAU;QACV,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA0B,EAC1B,SAA2B,cAAc;IAEzC,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAEjC,gEAAgE;IAChE,4DAA4D;IAC5D,gEAAgE;IAChE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAC7D,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC;YAChC,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IACtD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,UAA6B,EAC7B,MAAqB,EACrB,QAAyB,EACzB,gBAAyC,EACzC,SAA2B,cAAc;IAEzC,kEAAkE;IAClE,IACE,MAAM,CAAC,IAAI,KAAK,MAAM;QACtB,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,CAAC,gBAAgB,EAAE,SAAS,EAC5B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAChF,OAAO,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/context-engine/entities.js

@@ -0,0 +1,179 @@
+/**
+ * Active-context entity extractor.
+ *
+ * Different from `src/store/entity-extractor.ts` — that one runs an LLM
+ * call on saved memories to find people/orgs/products for the knowledge
+ * graph. THIS extractor is regex-only, runs in <5ms, and pulls the
+ * DEVELOPMENT-context entities the recall engine needs:
+ *
+ *   project    — namespace/repo name (from cwd or explicit mention)
+ *   files      — referenced source files
+ *   commands   — shell commands (git, npm, supabase, curl, etc.)
+ *   errors     — error messages, codes, stack-trace prefixes
+ *   technologies — frameworks, services, languages mentioned
+ *
+ * These feed the recall engine's namespace + filter selection:
+ *   - project name → search namespace=`repo:<project>` first
+ *   - files mentioned → boost memories that reference the same files
+ *   - errors → check procedural_memories for matching fingerprints
+ *   - technologies → expand search vocabulary
+ *
+ * Pure module — no I/O, no LLM. Same shape as date-anchors.ts.
+ */
+import { basename, dirname } from 'node:path';
+const TECH_VOCAB = [
+    // Languages
+    'typescript', 'javascript', 'python', 'go', 'rust', 'java', 'c#', 'ruby', 'php', 'swift', 'kotlin',
+    // Frameworks
+    'react', 'next.js', 'next', 'vue', 'svelte', 'angular', 'express', 'fastify', 'nestjs', 'django',
+    'flask', 'fastapi', 'rails', 'spring', '.net', 'dotnet',
+    // Cloud / infra
+    'aws', 'gcp', 'azure', 'vercel', 'netlify', 'cloudflare', 'fly.io', 'railway', 'heroku', 'render',
+    'kubernetes', 'k8s', 'docker', 'terraform', 'ansible',
+    // Databases
+    'postgres', 'postgresql', 'mysql', 'sqlite', 'redis', 'mongodb', 'dynamodb', 'supabase', 'planetscale',
+    'prisma', 'drizzle',
+    // AI / ML
+    'openai', 'anthropic', 'claude', 'gpt-4', 'gpt-4o', 'haiku', 'sonnet', 'opus', 'gemini', 'llama',
+    'mistral', 'embeddings', 'pgvector', 'sqlite-vec', 'langchain', 'llamaindex',
+    // Payment / billing
+    'stripe', 'paypal', 'lemon squeezy', 'paddle',
+    // Auth / identity
+    'oauth', 'jwt', 'session', 'cookie', 'sso', 'saml',
+    // MCP / mnueron-specific
+    'mcp', 'mnueron', 'cowork', 'claude desktop', 'cursor', 'windsurf', 'cline',
+    // Build / package
+    'npm', 'pnpm', 'yarn', 'cargo', 'pip', 'composer', 'maven', 'gradle',
+    // Test / CI
+    'vitest', 'jest', 'mocha', 'pytest', 'github actions', 'circleci',
+];
+/**
+ * Extract development entities from active context.
+ *
+ * @param text The active context — typically the last 500-2000 chars of
+ *             what the user has been writing/typing/talking-about.
+ * @param opts.cwd If provided, the working directory. Used to infer
+ *                 `project` when not explicitly mentioned.
+ * @param opts.explicitProject If the caller already knows the project
+ *                              (e.g. from MCP-side namespace hints),
+ *                              skip cwd inference.
+ */
+export function extractEntities(text, opts = {}) {
+    if (!text) {
+        return {
+            project: opts.explicitProject ?? inferProjectFromCwd(opts.cwd),
+            files: [],
+            commands: [],
+            errors: [],
+            technologies: [],
+            tags: [],
+        };
+    }
+    const lower = text.toLowerCase();
+    // ─── Files ────────────────────────────────────────────────────────────
+    // Looks for path-like tokens: src/foo/bar.ts, ./components/X.tsx, etc.
+    // Quoted paths in errors ('C:/foo/.git/index.lock') already captured
+    // by the path regex.
+    const fileRe = /(?<!\w)((?:[a-z0-9_-]+\/){0,5}[a-z0-9_.-]+\.(?:ts|tsx|js|jsx|py|go|rs|java|cs|rb|php|swift|kt|sql|md|yaml|yml|json|sh|ps1|html|css))(?!\w)/gi;
+    const files = Array.from(new Set(Array.from(text.matchAll(fileRe)).map(m => m[1]).filter(f => !f.startsWith('node_modules/') && f.length < 200))).slice(0, 15);
+    // ─── Commands ─────────────────────────────────────────────────────────
+    // Recognize lines that LOOK like shell commands: starts with a known
+    // CLI verb. Captures from fenced code blocks too.
+    const cmdRe = /(?:^|\n|`{1,3}\s*|\$\s+)((?:git|npm|pnpm|yarn|node|npx|tsx|python|pip|cargo|rustc|go|docker|kubectl|terraform|ansible|aws|gcloud|az|supabase|stripe|vercel|netlify|gh|mnueron|curl|wget|psql|mysql|sqlite3|redis-cli|jq|sed|awk|grep|find|ls|cd|rm|cp|mv|mkdir|chmod|chown|sudo|systemctl|service|kill|ps|top|netstat|ssh|scp|rsync|tar|zip|unzip|cmake|make|gradle|mvn|bundle|gem)\s+[^\n`]{1,200})/g;
+    const commands = Array.from(new Set(Array.from(text.matchAll(cmdRe)).map(m => m[1].trim()))).slice(0, 10);
+    // ─── Errors ───────────────────────────────────────────────────────────
+    // Catches lines that look like error output. Conservative — we don't
+    // want to mark every "failed" mention as an error entity.
+    const errorPatterns = [
+        /(?:^|\n)\s*(?:ERROR|FATAL|Error|Exception|Traceback)[: ][^\n]{5,200}/g,
+        /\b(?:HTTP|status)\s+(?:4|5)\d{2}\b/g,
+        /\bSQLSTATE\s+\d{5}\b/gi,
+        /\bcannot find (?:module|file)\b[^\n]{0,100}/gi,
+        /\b(?:is not recognized|not found|undefined|null pointer|access denied|permission denied)\b/gi,
+    ];
+    const errors = [];
+    for (const re of errorPatterns) {
+        for (const m of text.matchAll(re)) {
+            errors.push(m[0].trim());
+            if (errors.length >= 5)
+                break;
+        }
+        if (errors.length >= 5)
+            break;
+    }
+    // ─── Technologies ─────────────────────────────────────────────────────
+    // Conservative vocabulary match. Avoids false positives on words like
+    // "Go" by requiring word boundaries (so "Go" only matches as a token).
+    const technologies = TECH_VOCAB.filter(t => {
+        // Special handling for short tokens to avoid false positives
+        if (t.length <= 2) {
+            // "go", "k8s" — require word boundary on both sides + lowercase context
+            return new RegExp(`\\b${escapeRe(t)}\\b`).test(lower);
+        }
+        return lower.includes(t);
+    }).slice(0, 15);
+    // ─── Project ──────────────────────────────────────────────────────────
+    const project = opts.explicitProject ?? extractProjectFromText(text) ?? inferProjectFromCwd(opts.cwd);
+    // ─── Tags ─────────────────────────────────────────────────────────────
+    // Pull noun phrases from the first 200 chars as candidate tags.
+    // Useful for stamping captured runbooks with relevant labels.
+    const tags = Array.from(new Set([
+        ...technologies.slice(0, 5),
+        ...(project ? [`project:${project}`] : []),
+        ...files.slice(0, 3).map(f => `file:${basename(f)}`),
+    ])).slice(0, 10);
+    return {
+        project,
+        files,
+        commands,
+        errors,
+        technologies,
+        tags,
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────
+/** Pull "in the foo repo" / "repo: foo" / "namespace=repo:foo" from text. */
+function extractProjectFromText(text) {
+    // Order from most-specific-phrase to least. The "in the X repo" pattern
+    // comes FIRST because it's the most natural English phrasing and the
+    // most unambiguous about which word is the project name.
+    const patterns = [
+        // "in the mnueron repo" / "in mnueron project" / "in the foo codebase"
+        /\bin\s+(?:the\s+)?([a-zA-Z0-9._-]{2,60})\s+(?:repo|project|codebase)\b/i,
+        // "namespace=repo:mnueron" / "namespace: repo:foo"
+        /\bnamespace[=:\s]+["`']?(repo:[a-zA-Z0-9._-]+)["`']?/i,
+        // "project: mnueron" / "repo: foo" — REQUIRES `:` or `=` (NOT bare whitespace)
+        // to avoid matching "repo working" or "project plan" as "working" or "plan".
+        /\b(?:project|repo|repository)\s*[:=]\s*["`']?([a-zA-Z0-9._-]{2,60})["`']?\b/i,
+    ];
+    for (const re of patterns) {
+        const m = re.exec(text);
+        if (m)
+            return m[1].replace(/^repo:/, '');
+    }
+    return null;
+}
+/** Last dir name of cwd, e.g. "/home/me/projects/mnueron" → "mnueron". */
+function inferProjectFromCwd(cwd) {
+    if (!cwd)
+        return null;
+    try {
+        let name = basename(cwd);
+        // If cwd ends in `/src` or similar generic, walk up.
+        while (['src', 'lib', 'app', 'packages', 'frontend', 'backend'].includes(name)) {
+            const parent = dirname(cwd);
+            if (parent === cwd)
+                break;
+            cwd = parent;
+            name = basename(cwd);
+        }
+        return name || null;
+    }
+    catch {
+        return null;
+    }
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=entities.js.map

package/dist/lib/context-engine/entities.js.map

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

package/dist/lib/context-engine/index.js

@@ -0,0 +1,74 @@
+/**
+ * Context Engine — top-level orchestrator.
+ *
+ * Single entrypoint that takes active context text + optional cwd and
+ * returns a complete `ContextSignal` ready to be passed to the recall
+ * engine.
+ *
+ * Combines:
+ *   - intent.classifyIntent()
+ *   - entities.extractEntities()
+ *   - runbook-detector.detectRunbook()
+ *
+ * Used by the MCP tools (`recall_assist`, `runbook_suggest`) and any
+ * future client (VS Code extension, browser ext suggestion watcher,
+ * dashboard live-demo box).
+ */
+import { classifyIntent } from './intent.js';
+import { extractEntities } from './entities.js';
+import { detectRunbook } from './runbook-detector.js';
+export { DEFAULT_CONFIG, scoreCandidate, filterByConfidence, gateSurfacing, } from './confidence.js';
+/**
+ * Analyze active context. Pure function — no I/O.
+ *
+ * Returns a ContextSignal that the recall engine can use to decide:
+ *   - What namespace(s) to search
+ *   - Whether to look at procedural_memories (runbooks) vs memories
+ *   - What confidence threshold to apply
+ *   - Whether to offer the user to save THIS text as a runbook
+ */
+export function analyzeContext(text, opts = {}) {
+    const intent = classifyIntent(text);
+    const entities = extractEntities(text, {
+        cwd: opts.cwd,
+        explicitProject: opts.project,
+    });
+    const runbookDetection = detectRunbook(text);
+    // ─── Namespace hints ──────────────────────────────────────────────────
+    // Project namespace convention (from migration 040): `repo:<name>`.
+    // If we have a project, prefer searching that namespace first; fall
+    // back to broader namespaces if no hits.
+    const namespaceHints = [];
+    if (opts.namespaceHints?.length) {
+        namespaceHints.push(...opts.namespaceHints);
+    }
+    if (entities.project) {
+        namespaceHints.push(`repo:${entities.project}`);
+        namespaceHints.push(`project:${entities.project}`);
+    }
+    // For runbook-shaped queries, also include the 'mnueron' namespace
+    // (the default for `runbook capture` saves).
+    if (runbookDetection.isRunbook || intent.kind === 'deploying' || intent.kind === 'debugging') {
+        namespaceHints.push('mnueron');
+    }
+    // Always include 'default' as a fallback.
+    if (!namespaceHints.includes('default'))
+        namespaceHints.push('default');
+    // ─── Worth searching? ────────────────────────────────────────────────
+    // We skip the recall query entirely if the signal is so weak there's
+    // no useful filter. Saves DB queries on every keystroke debounce.
+    const worthSearching = intent.kind !== 'none' ||
+        entities.files.length > 0 ||
+        entities.commands.length > 0 ||
+        entities.errors.length > 0 ||
+        runbookDetection.confidence > 0.4 ||
+        (entities.technologies.length > 0 && entities.technologies.length >= 2);
+    return {
+        intent,
+        entities,
+        runbookDetection,
+        namespaceHints,
+        worthSearching,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/context-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/context-engine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,eAAe,EAAwB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,aAAa,EAAyB,MAAM,uBAAuB,CAAC;AAU7E,OAAO,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA8BzB;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAuB,EAAE;IACpE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE;QACrC,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,eAAe,EAAE,IAAI,CAAC,OAAO;KAC9B,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAE7C,yEAAyE;IACzE,oEAAoE;IACpE,oEAAoE;IACpE,yCAAyC;IACzC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,IAAI,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC;QAChC,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,cAAc,CAAC,IAAI,CAAC,QAAQ,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,cAAc,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,mEAAmE;IACnE,6CAA6C;IAC7C,IAAI,gBAAgB,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC7F,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IACD,0CAA0C;IAC1C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAExE,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,MAAM,cAAc,GAClB,MAAM,CAAC,IAAI,KAAK,MAAM;QACtB,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACzB,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC5B,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAC1B,gBAAgB,CAAC,UAAU,GAAG,GAAG;QACjC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAE1E,OAAO;QACL,MAAM;QACN,QAAQ;QACR,gBAAgB;QAChB,cAAc;QACd,cAAc;KACf,CAAC;AACJ,CAAC"}