@claude-flow/cli 3.10.45 → 3.11.0

package/dist/src/ruvector/router-trajectory.js

@@ -1,87 +1,250 @@
 /**
- * Router trajectory collection (#2334 Phase 1)
+ * router-trajectory.ts — Opt-in DRACO-shaped trajectory recorder for the
+ * cost-optimal model router (ADR-148, phase 5).
  *
- * Opt-in per-decision dataset collection for the model router. The persisted
- * bandit state (`.swarm/model-router-state.json`) keeps only aggregates —
- * 9 Beta(α,β) cells and a capped/truncated history — which is not trainable
- * material for the Phase 2 FastGRNN tier-classifier. This sidecar captures
- * the per-example rows that training needs:
+ * Writes one JSON-line per routing decision and one per outcome to a
+ * shared `.swarm/model-router-trajectories.jsonl`. Outcome rows are
+ * matched to their decision via `task_hash` (FNV-1a-32 of the task text).
  *
- *   decision rows: { taskHash, task, embedding?, complexity, features,
- *                    model, confidence, uncertainty, routedBy, ts }
- *   outcome rows:  { taskHash, model, outcome, ts }
+ * Gated behind `CLAUDE_FLOW_ROUTER_TRAJECTORY=1`. Default: **off** — rows
+ * carry full task text + raw embeddings, which is a PII/retention surface
+ * we do not enable without explicit consent.
  *
- * joined offline on `taskHash` (sha256-16 of the task text).
- *
- * OFF by default. Enable with CLAUDE_FLOW_ROUTER_TRAJECTORY=1. Rows append to
- * `.swarm/model-router-trajectories.jsonl` — local-only, same trust domain as
- * the existing state file, but unlike it the rows contain full task text (up
- * to 500 chars) and raw embeddings, which is why this is opt-in rather than
- * always-on.
- *
- * Writes are best-effort: any fs error is swallowed (collection must never
- * break routing), matching the state-file behavior in model-router.ts.
+ * Schema is versioned (`"v": 1`). New required fields bump the version;
+ * additive optional fields do not.
  *
  * @module router-trajectory
  */
-import { createHash } from 'crypto';
-import { appendFileSync, existsSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-export const TRAJECTORY_FILE = '.swarm/model-router-trajectories.jsonl';
-/** Schema version stamped on every row so offline training can dispatch. */
-const ROW_VERSION = 1;
-export function trajectoryCollectionEnabled() {
-    return process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY === '1';
-}
-/** Join key: first 16 hex chars of sha256(task). */
+import { appendFileSync, mkdirSync, existsSync, statSync, renameSync, unlinkSync } from 'node:fs';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import { costUsd } from './model-prices.js';
+// ============================================================================
+// FNV-1a-32 (matches scripts/gen-seed-corpus.mjs)
+// ============================================================================
 export function taskHash(task) {
-    return createHash('sha256').update(task).digest('hex').slice(0, 16);
+    let h = 0x811c9dc5 >>> 0;
+    for (let i = 0; i < task.length; i++) {
+        h ^= task.charCodeAt(i);
+        h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;
+    }
+    return h.toString(16).padStart(8, '0');
+}
+let _cfg = null;
+/** Cached size of the current file; updated incrementally on each append to
+ *  avoid a `statSync` per write. -1 means "unknown, probe on next append". */
+let _cachedSize = -1;
+function getConfig() {
+    if (_cfg !== null)
+        return _cfg;
+    const enabled = process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY === '1';
+    const swarmDir = process.env.CLAUDE_FLOW_SWARM_DIR
+        ?? resolvePath(process.cwd(), '.swarm');
+    _cfg = {
+        enabled,
+        path: process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY_PATH
+            ?? join(swarmDir, 'model-router-trajectories.jsonl'),
+        taskCharLimit: parseInt(process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY_TASKLEN ?? '500', 10) || 500,
+        maxSizeBytes: parseInt(process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY_MAXSIZE ?? `${10 * 1024 * 1024}`, 10) | 0,
+        maxRotations: Math.max(0, parseInt(process.env.CLAUDE_FLOW_ROUTER_TRAJECTORY_MAXROTATIONS ?? '3', 10) || 3),
+    };
+    return _cfg;
+}
+/** Rotate `path` → `path.1`, `path.1` → `path.2`, ..., dropping the oldest. */
+function rotate(cfg) {
+    if (!existsSync(cfg.path))
+        return;
+    try {
+        // Walk from oldest to newest so each rename has a free target.
+        if (cfg.maxRotations === 0) {
+            // No history kept — just truncate by deleting.
+            unlinkSync(cfg.path);
+            return;
+        }
+        const oldest = `${cfg.path}.${cfg.maxRotations}`;
+        if (existsSync(oldest))
+            unlinkSync(oldest);
+        for (let i = cfg.maxRotations - 1; i >= 1; i--) {
+            const src = `${cfg.path}.${i}`;
+            if (existsSync(src))
+                renameSync(src, `${cfg.path}.${i + 1}`);
+        }
+        renameSync(cfg.path, `${cfg.path}.1`);
+    }
+    catch {
+        // If rotation fails (permissions, race), drop back to overwriting the
+        // active file by truncating its handle. Worst case we lose history.
+        try {
+            unlinkSync(cfg.path);
+        }
+        catch { /* */ }
+    }
+    _cachedSize = 0;
 }
 function appendRow(row) {
+    const cfg = getConfig();
+    if (!cfg.enabled)
+        return;
     try {
-        const fullPath = join(process.cwd(), TRAJECTORY_FILE);
-        const dir = dirname(fullPath);
+        const dir = dirname(cfg.path);
         if (!existsSync(dir))
             mkdirSync(dir, { recursive: true });
-        appendFileSync(fullPath, JSON.stringify(row) + '\n');
+        // Probe size lazily on first call this process, then track incrementally.
+        if (_cachedSize < 0) {
+            _cachedSize = existsSync(cfg.path) ? statSync(cfg.path).size : 0;
+        }
+        // One JSON object per line, newline-terminated. No leading whitespace —
+        // we want the file to be `jq -c`-friendly.
+        const line = JSON.stringify(row) + '\n';
+        const bytes = Buffer.byteLength(line, 'utf8');
+        // Rotate BEFORE writing if this row would push us past the cap.
+        if (cfg.maxSizeBytes > 0 && _cachedSize + bytes > cfg.maxSizeBytes) {
+            rotate(cfg);
+        }
+        appendFileSync(cfg.path, line);
+        _cachedSize += bytes;
     }
     catch {
-        // Best-effort: collection must never break routing.
+        // Silent: trajectory collection must never break routing.
     }
 }
-export function recordTrajectoryDecision(task, embedding, complexity, decision) {
-    if (!trajectoryCollectionEnabled())
+// ============================================================================
+// Public API
+// ============================================================================
+/** Record one decision. Cheap — a single appendFileSync of a JSONL row. */
+export function recordDecision(args) {
+    const cfg = getConfig();
+    if (!cfg.enabled)
         return;
-    appendRow({
-        v: ROW_VERSION,
-        type: 'decision',
+    const row = {
+        v: 1, type: 'decision',
         ts: new Date().toISOString(),
-        taskHash: taskHash(task),
-        task: task.slice(0, 500),
-        ...(embedding && embedding.length > 0 ? { embedding } : {}),
-        complexity: complexity.score,
-        features: {
-            lexicalComplexity: complexity.lexicalComplexity,
-            semanticDepth: complexity.semanticDepth,
-            taskScope: complexity.taskScope,
-            uncertaintyLevel: complexity.uncertaintyLevel,
-        },
-        model: decision.model,
-        confidence: decision.confidence,
-        uncertainty: decision.uncertainty,
-        routedBy: decision.routedBy,
-    });
+        task_hash: taskHash(args.task),
+        task: args.task.length > cfg.taskCharLimit ? args.task.slice(0, cfg.taskCharLimit) : args.task,
+        embedding: args.embedding,
+        complexity: args.complexity,
+        model: args.model,
+        confidence: args.confidence,
+        uncertainty: args.uncertainty,
+        routed_by: args.routedBy,
+        ...(args.neuralBackend ? { neural_backend: args.neuralBackend } : {}),
+        ...(args.abPair ? { ab_pair: args.abPair } : {}),
+        ...(args.provider ? { provider: args.provider } : {}),
+        ...(args.openrouterModel ? { openrouter_model: args.openrouterModel } : {}),
+        ...(args.ensembleDisagreement !== undefined ? { ensemble_disagreement: args.ensembleDisagreement } : {}),
+    };
+    appendRow(row);
 }
-export function recordTrajectoryOutcome(task, model, outcome) {
-    if (!trajectoryCollectionEnabled())
+/** Record one outcome. Join to a decision by `task_hash`. */
+export function recordTrajectoryOutcome(args) {
+    const cfg = getConfig();
+    if (!cfg.enabled)
         return;
-    appendRow({
-        v: ROW_VERSION,
-        type: 'outcome',
+    // iter 31 — compute USD spend at write time using the canonical price
+    // table. Cost is a first-class field so consumers don't need to JOIN
+    // against the decision row (which may live in a rotated file).
+    const cost_usd = args.tokens && (args.tokens.input > 0 || args.tokens.output > 0)
+        ? costUsd(args.modelId, args.tokens.input, args.tokens.output)
+        : undefined;
+    const row = {
+        v: 1, type: 'outcome',
         ts: new Date().toISOString(),
-        taskHash: taskHash(task),
-        model,
-        outcome,
-    });
+        task_hash: taskHash(args.task),
+        quality: args.quality,
+        scores: args.scores,
+        source: args.source,
+        ...(args.tokens ? { tokens: args.tokens } : {}),
+        ...(cost_usd != null ? { cost_usd } : {}),
+        ...(args.modelId ? { model_id: args.modelId } : {}),
+    };
+    appendRow(row);
+}
+/** Diagnostic for status/CLI. */
+export function trajectoryRecorderStatus() {
+    return { ...getConfig() };
+}
+/** Map decision-side complexity ∈ [0,1] back to the corpus tier label. The
+ *  buckets are deliberately the same boundaries the bandit uses so a pair
+ *  drawn from production lands in the same KRR specialist that served it. */
+export function tierFromComplexity(complexity) {
+    if (complexity < 0.34)
+        return 'cheap';
+    if (complexity < 0.67)
+        return 'mid';
+    return 'strong';
+}
+/** Pair decision+outcome rows by task_hash. Returns the rebuilt training rows
+ *  + diagnostics so the caller (script or test) can report what was dropped
+ *  and why. */
+export function pairTrajectoryRows(rows) {
+    const decisions = new Map();
+    const outcomes = new Map();
+    // Latest-wins per hash. Production may re-run the same task — using the most
+    // recent outcome avoids polluting the corpus with stale judgments.
+    let dCount = 0, oCount = 0;
+    for (const row of rows) {
+        if (row.type === 'decision') {
+            dCount++;
+            const prev = decisions.get(row.task_hash);
+            if (!prev || row.ts > prev.ts)
+                decisions.set(row.task_hash, row);
+        }
+        else if (row.type === 'outcome') {
+            oCount++;
+            const prev = outcomes.get(row.task_hash);
+            if (!prev || row.ts > prev.ts)
+                outcomes.set(row.task_hash, row);
+        }
+    }
+    const pairs = [];
+    const bySource = {};
+    const byTier = {};
+    let droppedNoEmbedding = 0;
+    let droppedNoMatch = 0;
+    for (const [hash, dec] of decisions) {
+        const out = outcomes.get(hash);
+        if (!out) {
+            droppedNoMatch++;
+            continue;
+        }
+        if (!dec.embedding || dec.embedding.length === 0) {
+            droppedNoEmbedding++;
+            continue;
+        }
+        // scores map: prefer the outcome's full per-model map (set by callers who
+        // ran multi-model comparisons); fall back to a single-model entry derived
+        // from the model the decision actually dispatched.
+        const scores = out.scores
+            ?? { [dec.openrouter_model ?? dec.model]: out.quality };
+        const tier = tierFromComplexity(dec.complexity);
+        const source = out.source ?? 'unknown';
+        pairs.push({
+            task: dec.task,
+            embedding: dec.embedding,
+            scores,
+            tier,
+            source,
+            ts: out.ts,
+        });
+        bySource[source] = (bySource[source] ?? 0) + 1;
+        byTier[tier] = (byTier[tier] ?? 0) + 1;
+    }
+    return {
+        pairs,
+        stats: {
+            totalRows: rows.length,
+            decisions: dCount,
+            outcomes: oCount,
+            paired: pairs.length,
+            droppedNoEmbedding,
+            droppedNoMatch,
+            bySource,
+            byTier,
+        },
+    };
+}
+/** Test seam — reset cached config so unit tests can change env vars between cases. */
+export function __resetTrajectoryRecorderForTests() {
+    _cfg = null;
+    _cachedSize = -1;
 }
 //# sourceMappingURL=router-trajectory.js.map

package/dist/src/ruvector/router-trajectory.js.map

@@ -1 +1 @@
-{"version":3,"file":"router-trajectory.js","sourceRoot":"","sources":["../../../src/ruvector/router-trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,CAAC,MAAM,eAAe,GAAG,wCAAwC,CAAC;AAExE,4EAA4E;AAC5E,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAM,UAAU,2BAA2B;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,GAAG,CAAC;AAC3D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC;AAiCD,SAAS,SAAS,CAAC,GAAiD;IAClE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,SAA+B,EAC/B,UAAiE,EACjE,QAAsF;IAEtF,IAAI,CAAC,2BAA2B,EAAE;QAAE,OAAO;IAC3C,SAAS,CAAC;QACR,CAAC,EAAE,WAAW;QACd,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACxB,GAAG,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,QAAQ,EAAE;YACR,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;YAC/C,aAAa,EAAE,UAAU,CAAC,aAAa;YACvC,SAAS,EAAE,UAAU,CAAC,SAAS;YAC/B,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;SAC9C;QACD,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAY,EACZ,KAAa,EACb,OAA4C;IAE5C,IAAI,CAAC,2BAA2B,EAAE;QAAE,OAAO;IAC3C,SAAS,CAAC;QACR,CAAC,EAAE,WAAW;QACd,IAAI,EAAE,SAAS;QACf,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC;QACxB,KAAK;QACL,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"router-trajectory.js","sourceRoot":"","sources":["../../../src/ruvector/router-trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AAIlE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AA4E5C,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAE/E,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAiBD,IAAI,IAAI,GAA0B,IAAI,CAAC;AACvC;8EAC8E;AAC9E,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;AAErB,SAAS,SAAS;IAChB,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,KAAK,GAAG,CAAC;IAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB;WAC7C,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC1C,IAAI,GAAG;QACL,OAAO;QACP,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,kCAAkC;eAC/C,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC;QACtD,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG;QAC9F,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC;QAC1G,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;KAC5G,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,SAAS,MAAM,CAAC,GAAmB;IACjC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAClC,IAAI,CAAC;QACH,+DAA+D;QAC/D,IAAI,GAAG,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC3B,+CAA+C;YAC/C,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,KAAK,IAAI,CAAC,GAAG,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,UAAU,CAAC,GAAG,CAAC;gBAAE,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,oEAAoE;QACpE,IAAI,CAAC;YAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,WAAW,GAAG,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,GAAkB;IACnC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE1D,0EAA0E;QAC1E,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QAED,wEAAwE;QACxE,2CAA2C;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAE9C,gEAAgE;QAChE,IAAI,GAAG,CAAC,YAAY,GAAG,CAAC,IAAI,WAAW,GAAG,KAAK,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;YACnE,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,WAAW,IAAI,KAAK,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAc9B;IACC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO;IACzB,MAAM,GAAG,GAA0B;QACjC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU;QACtB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QAC9F,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,IAAI,CAAC,QAAQ;QACxB,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,IAAI,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzG,CAAC;IACF,SAAS,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,uBAAuB,CAAC,IASvC;IACC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG,CAAC,OAAO;QAAE,OAAO;IACzB,sEAAsE;IACtE,qEAAqE;IACrE,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/E,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9D,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,GAAG,GAAyB;QAChC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS;QACrB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;IACF,SAAS,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC;AAC5B,CAAC;AAoBD;;6EAE6E;AAC7E,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,IAAI,UAAU,GAAG,IAAI;QAAE,OAAO,OAAO,CAAC;IACtC,IAAI,UAAU,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;eAEe;AACf,MAAM,UAAU,kBAAkB,CAChC,IAAqB;IAcrB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEzD,6EAA6E;IAC7E,mEAAmE;IACnE,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;YAAC,cAAc,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAAC,kBAAkB,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAErF,0EAA0E;QAC1E,0EAA0E;QAC1E,mDAAmD;QACnD,MAAM,MAAM,GAA2B,GAAG,CAAC,MAAM;eAC5C,EAAE,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAE1D,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,SAAS,CAAC;QAEvC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM;YACN,IAAI;YACJ,MAAM;YACN,EAAE,EAAE,GAAG,CAAC,EAAE;SACX,CAAC,CAAC;QAEH,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,OAAO;QACL,KAAK;QACL,KAAK,EAAE;YACL,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,kBAAkB;YAClB,cAAc;YACd,QAAQ;YACR,MAAM;SACP;KACF,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,iCAAiC;IAC/C,IAAI,GAAG,IAAI,CAAC;IACZ,WAAW,GAAG,CAAC,CAAC,CAAC;AACnB,CAAC"}

package/dist/src/ruvector/task-embedder.d.ts

@@ -0,0 +1,56 @@
+/**
+ * task-embedder.ts — Shared lazy task embedder + LRU cache (ADR-149 iter 9).
+ *
+ * The cost-optimal neural router (ADR-149) fires only when `route(task, embedding)`
+ * is called with a real embedding. Two call sites in the dispatcher chain need
+ * embeddings: `agent-tools.ts` (initial routing) and `agent-execute-core.ts`
+ * (the fallback chain on 429/5xx). Before this module they each loaded their
+ * own @xenova/transformers MiniLM pipeline and recomputed embeddings on every
+ * call — including for repeated prompts.
+ *
+ * This module:
+ *   1. Loads the pipeline once per process (`loadTaskEmbedder`).
+ *   2. Caches embeddings per task text via an LRU of configurable size
+ *      (default 500 entries ≈ 1.5 MB at 384-dim).
+ *   3. Hashes by FNV-1a-32 + length to keep the key compact and collision-safe
+ *      for typical prompt sizes.
+ *   4. Returns `undefined` on any failure so callers gracefully fall back to
+ *      the heuristic+bandit path.
+ *
+ * @module task-embedder
+ */
+/**
+ * Compute (or fetch from cache) the 384-dim MiniLM embedding for `task`.
+ * Returns `undefined` on any failure (missing @xenova/transformers, ONNX
+ * runtime error, etc.) so callers can gracefully fall back to the
+ * heuristic+bandit path. Best-effort and never throws.
+ *
+ * Cache hit-rate accumulates across the process lifetime and is observable
+ * via `embedderStats()` for diagnostics.
+ */
+export declare function embedTaskWithCache(task: string): Promise<number[] | undefined>;
+/**
+ * Batch counterpart to `embedTaskWithCache`. For each task, returns the
+ * cached embedding when present, else schedules a fresh inference. The
+ * fresh-inference set is computed in a SINGLE ONNX pass via
+ * @xenova/transformers' array-input mode, amortizing tensor setup +
+ * model-load overhead across the batch. Order of the output array
+ * matches the input order.
+ *
+ * Returns `undefined` for any task that failed to embed (missing dep,
+ * runtime error). Cache state updates as if each task had been called
+ * separately through embedTaskWithCache (hits/misses counters update
+ * accordingly).
+ */
+export declare function embedTaskWithCacheBatch(tasks: string[]): Promise<Array<number[] | undefined>>;
+/** Diagnostic surface — hit/miss counters + cache state. */
+export declare function embedderStats(): {
+    size: number;
+    maxSize: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+};
+/** Test seam — clear LRU + counters so tests get a fresh baseline. */
+export declare function __resetTaskEmbedderForTests(): void;
+//# sourceMappingURL=task-embedder.d.ts.map

package/dist/src/ruvector/task-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-embedder.d.ts","sourceRoot":"","sources":["../../../src/ruvector/task-embedder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAuHH;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAkBpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CA2CnG;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAShH;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD"}

package/dist/src/ruvector/task-embedder.js

@@ -0,0 +1,237 @@
+/**
+ * task-embedder.ts — Shared lazy task embedder + LRU cache (ADR-149 iter 9).
+ *
+ * The cost-optimal neural router (ADR-149) fires only when `route(task, embedding)`
+ * is called with a real embedding. Two call sites in the dispatcher chain need
+ * embeddings: `agent-tools.ts` (initial routing) and `agent-execute-core.ts`
+ * (the fallback chain on 429/5xx). Before this module they each loaded their
+ * own @xenova/transformers MiniLM pipeline and recomputed embeddings on every
+ * call — including for repeated prompts.
+ *
+ * This module:
+ *   1. Loads the pipeline once per process (`loadTaskEmbedder`).
+ *   2. Caches embeddings per task text via an LRU of configurable size
+ *      (default 500 entries ≈ 1.5 MB at 384-dim).
+ *   3. Hashes by FNV-1a-32 + length to keep the key compact and collision-safe
+ *      for typical prompt sizes.
+ *   4. Returns `undefined` on any failure so callers gracefully fall back to
+ *      the heuristic+bandit path.
+ *
+ * @module task-embedder
+ */
+// ============================================================================
+// FNV-1a-32 hash (matches scripts/gen-seed-corpus.mjs + router-trajectory.ts)
+// ============================================================================
+function fnv1a32(s) {
+    let h = 0x811c9dc5 >>> 0;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = (h + ((h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24))) >>> 0;
+    }
+    return h.toString(16).padStart(8, '0');
+}
+/** Compact cache key — hash + length so distinct prompts of similar shape collide rarely. */
+function cacheKey(task) {
+    return `${fnv1a32(task)}:${task.length}`;
+}
+// Single shared extractor. Both single-text and array-input modes call this
+// same function (xenova's pipeline returns a callable that accepts either),
+// so we don't pay the ONNX model-load cost twice.
+let _extractorPromise = null;
+function loadExtractor() {
+    if (_extractorPromise !== null)
+        return _extractorPromise;
+    _extractorPromise = (async () => {
+        try {
+            const specifier = '@xenova/transformers';
+            const mod = await import(/* @vite-ignore */ specifier).catch(() => null);
+            if (!mod || typeof mod.pipeline !== 'function')
+                return null;
+            return await mod.pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2', { quantized: true });
+        }
+        catch {
+            return null;
+        }
+    })();
+    return _extractorPromise;
+}
+async function loadEmbedder() {
+    const ex = await loadExtractor();
+    if (!ex)
+        return null;
+    return async (text) => {
+        const out = await ex(text, { pooling: 'mean', normalize: true });
+        return Array.from(out.data);
+    };
+}
+/**
+ * Array-input batch embedder — xenova's pipeline accepts `string[]` and
+ * returns a stacked tensor of shape `[N, dim]`. Shares the same loaded
+ * pipeline with `loadEmbedder` so cold-load cost is paid once across
+ * single + batch usage. Measured speedup: ~1.83× on 30-task batches
+ * against the same-pipeline single-call loop.
+ */
+async function loadEmbedderBatch() {
+    const ex = await loadExtractor();
+    if (!ex)
+        return null;
+    return async (texts) => {
+        const out = await ex(texts, { pooling: 'mean', normalize: true });
+        const dims = out.dims ?? [texts.length, 384];
+        const N = dims[0] ?? texts.length;
+        const dim = dims[1] ?? Math.floor(out.data.length / N);
+        const data = out.data;
+        const result = new Array(N);
+        for (let i = 0; i < N; i++) {
+            result[i] = Array.from(data.subarray(i * dim, (i + 1) * dim));
+        }
+        return result;
+    };
+}
+// ============================================================================
+// LRU cache — Map preserves insertion order, so delete+set on hit = O(1) LRU
+// ============================================================================
+const MAX_SIZE = (() => {
+    const v = parseInt(process.env.CLAUDE_FLOW_ROUTER_EMBED_CACHE_SIZE ?? '500', 10);
+    return Number.isFinite(v) && v >= 0 ? v : 500;
+})();
+const _cache = new Map();
+let _hits = 0;
+let _misses = 0;
+function lruGet(key) {
+    const hit = _cache.get(key);
+    if (hit === undefined)
+        return undefined;
+    // Refresh recency: re-insert at the end.
+    _cache.delete(key);
+    _cache.set(key, hit);
+    return hit;
+}
+function lruSet(key, value) {
+    if (MAX_SIZE === 0)
+        return;
+    if (_cache.has(key))
+        _cache.delete(key);
+    _cache.set(key, value);
+    while (_cache.size > MAX_SIZE) {
+        const oldest = _cache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        _cache.delete(oldest);
+    }
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Compute (or fetch from cache) the 384-dim MiniLM embedding for `task`.
+ * Returns `undefined` on any failure (missing @xenova/transformers, ONNX
+ * runtime error, etc.) so callers can gracefully fall back to the
+ * heuristic+bandit path. Best-effort and never throws.
+ *
+ * Cache hit-rate accumulates across the process lifetime and is observable
+ * via `embedderStats()` for diagnostics.
+ */
+export async function embedTaskWithCache(task) {
+    if (typeof task !== 'string' || task.length === 0)
+        return undefined;
+    const key = cacheKey(task);
+    const cached = lruGet(key);
+    if (cached !== undefined) {
+        _hits++;
+        return cached;
+    }
+    try {
+        const embed = await loadEmbedder();
+        if (!embed)
+            return undefined;
+        const v = await embed(task);
+        lruSet(key, v);
+        _misses++;
+        return v;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Batch counterpart to `embedTaskWithCache`. For each task, returns the
+ * cached embedding when present, else schedules a fresh inference. The
+ * fresh-inference set is computed in a SINGLE ONNX pass via
+ * @xenova/transformers' array-input mode, amortizing tensor setup +
+ * model-load overhead across the batch. Order of the output array
+ * matches the input order.
+ *
+ * Returns `undefined` for any task that failed to embed (missing dep,
+ * runtime error). Cache state updates as if each task had been called
+ * separately through embedTaskWithCache (hits/misses counters update
+ * accordingly).
+ */
+export async function embedTaskWithCacheBatch(tasks) {
+    const out = new Array(tasks.length).fill(undefined);
+    // Validate + split into (cached-hits) and (missing-needs-inference).
+    const missingIdx = [];
+    const missingTasks = [];
+    const missingKeys = [];
+    for (let i = 0; i < tasks.length; i++) {
+        const t = tasks[i];
+        if (typeof t !== 'string' || t.length === 0)
+            continue;
+        const key = cacheKey(t);
+        const hit = lruGet(key);
+        if (hit !== undefined) {
+            _hits++;
+            out[i] = hit;
+        }
+        else {
+            missingIdx.push(i);
+            missingTasks.push(t);
+            missingKeys.push(key);
+        }
+    }
+    if (missingTasks.length === 0)
+        return out;
+    try {
+        const embedBatch = await loadEmbedderBatch();
+        if (!embedBatch) {
+            for (let j = 0; j < missingIdx.length; j++)
+                _misses++;
+            return out;
+        }
+        // Real array-input batch: xenova returns one stacked tensor we slice
+        // back into N embeddings. Amortizes tensor setup + ONNX overhead
+        // across the batch (measured 1.83× speedup at N=30).
+        const fresh = await embedBatch(missingTasks);
+        for (let j = 0; j < missingIdx.length; j++) {
+            const v = fresh[j];
+            if (v) {
+                lruSet(missingKeys[j], v);
+                out[missingIdx[j]] = v;
+            }
+            _misses++;
+        }
+    }
+    catch {
+        // best-effort — leave undefined entries as is
+    }
+    return out;
+}
+/** Diagnostic surface — hit/miss counters + cache state. */
+export function embedderStats() {
+    const total = _hits + _misses;
+    return {
+        size: _cache.size,
+        maxSize: MAX_SIZE,
+        hits: _hits,
+        misses: _misses,
+        hitRate: total > 0 ? _hits / total : 0,
+    };
+}
+/** Test seam — clear LRU + counters so tests get a fresh baseline. */
+export function __resetTaskEmbedderForTests() {
+    _cache.clear();
+    _hits = 0;
+    _misses = 0;
+    _extractorPromise = null;
+}
+//# sourceMappingURL=task-embedder.js.map

package/dist/src/ruvector/task-embedder.js.map

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