agent-recall-core 3.4.31 → 3.4.35

package/dist/tools-logic/store-repair.js

@@ -0,0 +1,243 @@
+/**
+ * store-repair.ts — WRITE-side remediation, the deliberate sibling to the
+ * read-only store-doctor.ts.
+ *
+ *   store-doctor   = DIAGNOSE. Strictly read-only, lock-free, never throws.
+ *   store-repair   = REMEDIATE. Re-derives the same conditions the doctor
+ *                    detects and applies the minimal, idempotent fix each
+ *                    `fix_hint` prescribes.
+ *
+ * SAFETY INVARIANTS:
+ *   1. DRY-RUN BY DEFAULT. `opts.apply` must be EXPLICITLY true to mutate. A
+ *      dry-run computes the full plan (what WOULD change) and writes nothing.
+ *   2. PER-STEP ISOLATION. Each step runs in its own try/catch (mirrors
+ *      safety-consolidation.ts) — one failing step never aborts the others.
+ *   3. IDEMPOTENT. A re-run on an already-clean store is a no-op: drift is
+ *      recomputed from disk truth, locks are re-scanned, and the consume marker
+ *      the drain advances is monotonic.
+ *   4. LOCK SAFETY. Only `.lock-*` dirs older than LOCK_RED_MS (the doctor's RED
+ *      threshold) are removed. The locker's acquire timeout is 5s and it
+ *      force-breaks stale locks at 30s, so a dir older than 5min cannot belong
+ *      to a live writer — removal is safe WITHOUT scanning for processes.
+ *
+ * NOT on any hot path. Invoked manually via `ar repair [--apply]`.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getRoot } from "../types.js";
+import { readJsonSafe } from "../storage/fs-utils.js";
+import { listAllProjects } from "../storage/project.js";
+import { palaceDir, archiveRawDir } from "../storage/paths.js";
+import { countRoomEntries } from "../palace/rooms.js";
+import { updatePalaceIndex } from "../palace/index-manager.js";
+import { runSafetyConsolidation } from "./safety-consolidation.js";
+import { runStoreDoctor, INDEX_DRIFT_TOLERANCE, LOCK_RED_MS, DREAM_NULL_MARKER_WARN_DAYS, } from "./store-doctor.js";
+import { resolveRetentionDays } from "../storage/retention.js";
+function snapshot(r) {
+    return {
+        status: r.status,
+        red: r.checks.filter((c) => c.level === "red").map((c) => c.name),
+    };
+}
+/**
+ * Re-derive which projects have at least one room drifting beyond tolerance.
+ * Disk (`### ` block count) is the source of truth; the index is the cache.
+ * Computed independently of the doctor's string output so repair never parses
+ * a human-readable detail line.
+ */
+function findDriftedProjects() {
+    const drifted = new Set();
+    for (const proj of listAllProjects()) {
+        const index = readJsonSafe(path.join(palaceDir(proj.slug), "palace-index.json"));
+        if (!index || !index.rooms)
+            continue;
+        for (const [slug, room] of Object.entries(index.rooms)) {
+            const indexed = room?.memory_count ?? 0;
+            const live = countRoomEntries(proj.slug, slug);
+            if (Math.abs(indexed - live) > INDEX_DRIFT_TOLERANCE) {
+                drifted.add(proj.slug);
+                break;
+            }
+        }
+    }
+    return [...drifted];
+}
+/** Find `.lock-*` dirs older than the RED threshold (definitely dead writers). */
+function findDeadLocks() {
+    const root = getRoot();
+    const now = Date.now();
+    const dead = [];
+    let entries = [];
+    try {
+        entries = fs.existsSync(root) ? fs.readdirSync(root) : [];
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        if (!entry.startsWith(".lock-"))
+            continue;
+        try {
+            const ageMs = now - fs.statSync(path.join(root, entry)).mtimeMs;
+            if (ageMs > LOCK_RED_MS)
+                dead.push(entry);
+        }
+        catch {
+            // raced with a release — already gone, nothing to remove
+        }
+    }
+    return dead;
+}
+/**
+ * Projects the drain should target — EXACTLY the ones the doctor flags as
+ * dreaming_stale, no more. Mirroring the doctor's RED+WARN conditions keeps
+ * repair and diagnosis in lockstep and makes the drain idempotent: a RECENT raw
+ * segment (the healthy backup buffer the doctor calls OK) is NOT selected, so we
+ * don't perpetually "drain" a project whose marker simply can't advance past
+ * within-retention segments.
+ *
+ *   RED  — a raw segment older than the (config-resolved) retention window is
+ *          still unconsumed (mtime newer than the marker).
+ *   WARN — the marker never advanced (null/absent) while raw older than the warn
+ *          floor exists.
+ */
+function findProjectsNeedingDrain() {
+    const now = Date.now();
+    const DAY_MS = 24 * 60 * 60 * 1000;
+    const retentionMs = resolveRetentionDays() * DAY_MS;
+    const warnMs = DREAM_NULL_MARKER_WARN_DAYS * DAY_MS;
+    const need = [];
+    for (const proj of listAllProjects()) {
+        const dir = archiveRawDir(proj.slug);
+        let rawFiles = [];
+        try {
+            rawFiles = fs.existsSync(dir)
+                ? fs.readdirSync(dir).filter((f) => f.endsWith(".md") && f !== "index.md")
+                : [];
+        }
+        catch {
+            continue;
+        }
+        if (rawFiles.length === 0)
+            continue;
+        const marker = readJsonSafe(path.join(dir, ".consumed.json"));
+        const lastConsumed = marker?.lastConsumedAt ?? null;
+        const markerNeverAdvanced = lastConsumed === null;
+        const lastMs = lastConsumed ? new Date(lastConsumed).getTime() : 0;
+        let flagged = false;
+        for (const f of rawFiles) {
+            let mtime;
+            try {
+                mtime = fs.statSync(path.join(dir, f)).mtimeMs;
+            }
+            catch {
+                continue;
+            }
+            const age = now - mtime;
+            const unconsumed = mtime > lastMs;
+            if (age > retentionMs && unconsumed) {
+                flagged = true; // RED
+                break;
+            }
+            if (markerNeverAdvanced && age > warnMs) {
+                flagged = true; // WARN
+            }
+        }
+        if (flagged)
+            need.push(proj.slug);
+    }
+    return need;
+}
+/**
+ * Run all repairs. DRY-RUN unless `opts.apply === true`. Each step is isolated;
+ * the result reports exactly what was (or would be) changed, plus the doctor
+ * status before and (when applied) after.
+ */
+export async function runStoreRepair(opts = {}) {
+    const apply = opts.apply === true;
+    const before = snapshot(runStoreDoctor());
+    const reindexed = { projects: [] };
+    const locksRemoved = { names: [] };
+    const drained = { projects: [] };
+    // ── (1) vector_index_drift → rebuild palace-index.json from .md truth ──────
+    // updatePalaceIndex re-counts `### ` blocks and writes atomically under lock.
+    try {
+        reindexed.projects = findDriftedProjects();
+        if (apply) {
+            for (const slug of reindexed.projects)
+                updatePalaceIndex(slug);
+        }
+    }
+    catch (err) {
+        reindexed.error = err instanceof Error ? err.message : String(err);
+    }
+    // ── (2) stale_lock → remove .lock-* dirs older than the RED threshold ──────
+    // Use rmdirSync (NOT rmSync recursive): a lock dir is always empty (the locker
+    // creates it via mkdirSync as a pure mutex), so rmdirSync suffices and FAILS
+    // LOUD if a dir unexpectedly has content — we never blind-recursively delete.
+    // In apply mode, names lists only locks ACTUALLY removed (honest reporting); in
+    // dry-run it lists the candidates that WOULD be removed.
+    try {
+        const candidates = findDeadLocks();
+        if (apply) {
+            const root = getRoot();
+            const removed = [];
+            for (const name of candidates) {
+                try {
+                    fs.rmdirSync(path.join(root, name));
+                    removed.push(name);
+                }
+                catch {
+                    // non-empty (unexpected — leave it) or raced with a release — don't
+                    // claim a removal that didn't happen
+                }
+            }
+            locksRemoved.names = removed;
+        }
+        else {
+            locksRemoved.names = candidates;
+        }
+    }
+    catch (err) {
+        locksRemoved.error = err instanceof Error ? err.message : String(err);
+    }
+    // ── (3) dreaming_stale → login-free, LLM-free consolidation drain ──────────
+    // Advances the consume marker + prunes aged raw. consolidateJournalToPalace
+    // (inside the drain) self-updates the palace index, so this never re-introduces
+    // the drift fixed in step (1).
+    try {
+        drained.projects = findProjectsNeedingDrain();
+        if (apply) {
+            // Per-project isolation: one project's drain throwing must not skip the
+            // rest. Collect failures into the step error rather than aborting.
+            const failed = [];
+            for (const slug of drained.projects) {
+                try {
+                    await runSafetyConsolidation(slug, { dryRun: false });
+                }
+                catch (e) {
+                    failed.push(`${slug} (${e instanceof Error ? e.message : String(e)})`);
+                }
+            }
+            if (failed.length > 0)
+                drained.error = `drain failed for: ${failed.join("; ")}`;
+        }
+    }
+    catch (err) {
+        drained.error = err instanceof Error ? err.message : String(err);
+    }
+    const after = apply ? snapshot(runStoreDoctor()) : null;
+    return { apply, before, reindexed, locksRemoved, drained, after };
+}
+/** One-line summary for CLI / logs. */
+export function storeRepairSummary(r) {
+    const verb = r.apply ? "repaired" : "would repair (dry-run)";
+    const parts = [
+        `${r.reindexed.projects.length} reindex`,
+        `${r.locksRemoved.names.length} lock`,
+        `${r.drained.projects.length} drain`,
+    ];
+    const tail = r.after ? ` · doctor ${r.before.status}→${r.after.status}` : "";
+    return `store-repair ${verb}: ${parts.join(", ")}${tail}`;
+}
+//# sourceMappingURL=store-repair.js.map

package/dist/tools-logic/store-repair.js.map

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

package/dist/tools-logic/supersession.d.ts

@@ -0,0 +1,34 @@
+export interface SupersessionMatch {
+    existingId: string;
+    existingRule: string;
+    conflictingValues: Array<{
+        existing: string;
+        incoming: string;
+    }>;
+}
+export interface SupersessionReview {
+    /** Older active corrections the new one contradicts — proposed for supersession. */
+    suggestions: SupersessionMatch[];
+    /** ids actually retracted (superseded_by set) — non-empty ONLY in auto mode. */
+    superseded: string[];
+    auto: boolean;
+}
+/** Find active corrections that contradict the candidate on a version/status/kv fact. */
+export declare function detectCorrectionConflicts(project: string, candidate: {
+    id?: string;
+    rule: string;
+    context?: string;
+}): SupersessionMatch[];
+/**
+ * Review (and, under auto, apply) supersessions for a newly-written correction.
+ * SUGGEST-ONLY by default. With auto (or AR_CONSOLIDATE_AUTO=1) the contradicted
+ * older corrections are retracted with superseded_by = the new correction's id.
+ */
+export declare function reviewSupersessions(project: string, newCorrection: {
+    id: string;
+    rule: string;
+    context?: string;
+}, opts?: {
+    auto?: boolean;
+}): SupersessionReview;
+//# sourceMappingURL=supersession.d.ts.map

package/dist/tools-logic/supersession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersession.d.ts","sourceRoot":"","sources":["../../src/tools-logic/supersession.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,gFAAgF;IAChF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAsDD,yFAAyF;AACzF,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,iBAAiB,EAAE,CAgBrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GACxB,kBAAkB,CAgBpB"}

package/dist/tools-logic/supersession.js

@@ -0,0 +1,103 @@
+/**
+ * supersession.ts — P2: detect when a NEW correction CONTRADICTS an existing
+ * active one on a versioned / status / key-value fact, and (suggest-default)
+ * supersede the stale one.
+ *
+ * Reuses AgentRecall's existing conflict-token grammar (helpers/conflict-scan.ts)
+ * — pure, NO LLM, NO network, NO key. SCOPE LIMIT (honest): this catches
+ * contradictions expressed as a version bump ("X is 1.2.3" → "X is 1.3.0"), a
+ * status flip ("status: blocked" → "status: done"), or a key-value change
+ * ("env = prod" → "env = staging"). It does NOT catch arbitrary semantic
+ * substitutions ("use middleware.ts" → "use proxy.ts") with no key — that needs
+ * the optional semantic/LLM path and is intentionally out of scope here.
+ *
+ * Mutation policy: SUGGEST-ONLY by default. Set AR_CONSOLIDATE_AUTO=1 (or pass
+ * { auto: true }) to actually retract the contradicted records (with
+ * superseded_by set to the new correction's id). The default mutates NOTHING.
+ */
+import { extractVersionTokens, extractStatusTokens, extractKVTokens, } from "../helpers/conflict-scan.js";
+import { readActiveCorrections, retractCorrection } from "../storage/corrections.js";
+/**
+ * Pairwise contradiction check over version + status + key-value tokens. Mirrors
+ * the comparison in conflict-scan.ts::scanForConflicts so both agree on what a
+ * "conflict" is (no fork of the grammar).
+ */
+function compareForConflicts(newText, existingText) {
+    const out = [];
+    // 1. Version token conflicts (same key, different semver).
+    const newV = extractVersionTokens(newText);
+    if (newV.size > 0) {
+        const exV = extractVersionTokens(existingText);
+        for (const [k, nv] of newV) {
+            const ev = exV.get(k);
+            if (ev && ev !== nv)
+                out.push({ existing: `${k} is ${ev}`, incoming: `${k} is ${nv}` });
+        }
+    }
+    // 2. Status category conflicts (existing has a category the new text lacks).
+    const newS = extractStatusTokens(newText);
+    if (newS.size > 0) {
+        const exS = extractStatusTokens(existingText);
+        const newCats = new Set(newS.values());
+        const exCats = new Set(exS.values());
+        for (const cat of exCats) {
+            if (!newCats.has(cat)) {
+                const exWord = [...exS.entries()].find(([, c]) => c === cat)?.[0] ?? cat;
+                const newCat = [...newCats][0];
+                if (newCat) {
+                    const newWord = [...newS.entries()].find(([, c]) => c === newCat)?.[0] ?? newCat;
+                    out.push({ existing: `status is ${exWord}`, incoming: `status is ${newWord}` });
+                }
+            }
+        }
+    }
+    // 3. Key-value conflicts (same key, different value).
+    const newKV = extractKVTokens(newText);
+    if (newKV.size > 0) {
+        const exKV = extractKVTokens(existingText);
+        for (const [k, nv] of newKV) {
+            const ev = exKV.get(k);
+            if (ev && ev !== nv)
+                out.push({ existing: `${k} is ${ev}`, incoming: `${k} is ${nv}` });
+        }
+    }
+    return out;
+}
+/** Find active corrections that contradict the candidate on a version/status/kv fact. */
+export function detectCorrectionConflicts(project, candidate) {
+    const newText = `${candidate.rule} ${candidate.context ?? ""}`.trim();
+    const matches = [];
+    for (const existing of readActiveCorrections(project)) {
+        if (candidate.id && existing.id === candidate.id)
+            continue;
+        const existingText = `${existing.rule} ${existing.context ?? ""}`.trim();
+        const conflicts = compareForConflicts(newText, existingText);
+        if (conflicts.length > 0) {
+            matches.push({
+                existingId: existing.id,
+                existingRule: existing.rule,
+                conflictingValues: conflicts,
+            });
+        }
+    }
+    return matches;
+}
+/**
+ * Review (and, under auto, apply) supersessions for a newly-written correction.
+ * SUGGEST-ONLY by default. With auto (or AR_CONSOLIDATE_AUTO=1) the contradicted
+ * older corrections are retracted with superseded_by = the new correction's id.
+ */
+export function reviewSupersessions(project, newCorrection, opts) {
+    const auto = opts?.auto ?? process.env.AR_CONSOLIDATE_AUTO === "1";
+    const suggestions = detectCorrectionConflicts(project, newCorrection);
+    const superseded = [];
+    if (auto) {
+        for (const m of suggestions) {
+            const res = retractCorrection(project, m.existingId, `superseded by ${newCorrection.id}`, newCorrection.id);
+            if (res.success)
+                superseded.push(m.existingId);
+        }
+    }
+    return { suggestions, superseded, auto };
+}
+//# sourceMappingURL=supersession.js.map

package/dist/tools-logic/supersession.js.map

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

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Shared types, interfaces, and constants for agent-recall-mcp.
  */
-export declare const VERSION = "3.4.30";
+export declare const VERSION = "3.4.35";
 /**
  * Set the storage root directory. This is process-global state —
  * only one root is active at a time. Call before any other operations.
@@ -106,6 +106,12 @@ export interface RoomMeta {
      * access frequency. Set by markKeystones() during consolidation.
      */
     keystone?: boolean;
+    /**
+     * Wave 3: non-destructive archive flag. Set by the decay pass when a room's
+     * salience falls at/below the archive threshold. The room dir is NEVER
+     * deleted — the flag is advisory and lets readers down-rank/hide it.
+     */
+    archived?: boolean;
 }
 export interface PalaceIndex {
     version: string;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -6,7 +6,7 @@ import * as os from "node:os";
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
-export const VERSION = "3.4.30";
+export const VERSION = "3.4.35";
 // ---------------------------------------------------------------------------
 // Root directory (configurable at runtime for SDK usage)
 // ---------------------------------------------------------------------------

package/dist/vector/local-vector-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-vector-backend.d.ts","sourceRoot":"","sources":["../../src/vector/local-vector-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAS5E,qBAAa,wBAAwB;IACnC,SAAS,IAAI,OAAO;IAId,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAoBpC"}
+{"version":3,"file":"local-vector-backend.d.ts","sourceRoot":"","sources":["../../src/vector/local-vector-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAG5E,qBAAa,wBAAwB;IACnC,SAAS,IAAI,OAAO;IAId,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAyBpC"}

package/dist/vector/local-vector-backend.js

@@ -8,15 +8,7 @@
  */
 import { embed } from "./embedding.js";
 import { queryVector } from "./local-vector-store.js";
-function scoreLabel(score) {
-    if (score >= 0.80)
-        return "high";
-    if (score >= 0.65)
-        return "medium";
-    if (score >= 0.50)
-        return "low";
-    return "weak";
-}
+import { calibratedConfidence } from "../tools-logic/confidence.js";
 export class LocalVectorRecallBackend {
     available() {
         return !!process.env.OPENAI_API_KEY;
@@ -30,14 +22,19 @@ export class LocalVectorRecallBackend {
             return [];
         }
         const hits = await queryVector(project, embedding, limit);
-        return hits.map((h) => ({
-            id: h.id,
-            source: h.source,
-            title: h.title,
-            excerpt: h.excerpt,
-            score: h.score,
-            confidence: scoreLabel(h.score),
-        }));
+        return hits.map((h) => {
+            // local-vector scores are cosine similarity — already 0..1.
+            const c = calibratedConfidence(h.score, "cosine");
+            return {
+                id: h.id,
+                source: h.source,
+                title: h.title,
+                excerpt: h.excerpt,
+                score: h.score,
+                confidence: c.label,
+                calibrated: c.calibrated,
+            };
+        });
     }
 }
 //# sourceMappingURL=local-vector-backend.js.map

package/dist/vector/local-vector-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-vector-backend.js","sourceRoot":"","sources":["../../src/vector/local-vector-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,MAAM,CAAC;IACjC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACnC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,wBAAwB;IACnC,SAAS;QACP,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA2B,EAC3B,KAAa;QAEb,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,iFAAiF;YACjF,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}
+{"version":3,"file":"local-vector-backend.js","sourceRoot":"","sources":["../../src/vector/local-vector-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,OAAO,wBAAwB;IACnC,SAAS;QACP,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAA2B,EAC3B,KAAa;QAEb,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,iFAAiF;YACjF,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpB,4DAA4D;YAC5D,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAClD,OAAO;gBACL,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,UAAU,EAAE,CAAC,CAAC,KAAK;gBACnB,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-recall-core",
-  "version": "3.4.31",
+  "version": "3.4.35",
   "description": "Core memory palace engine for AgentRecall",
   "type": "module",
   "main": "dist/index.js",

package/dist/relevance/injector.d.ts

@@ -1,51 +0,0 @@
-/**
- * Injector — formats Surfacer Candidates as an "added context" block the host
- * hook can echo into the agent's context (v3.5.0 P-B, spec §4 "Judge" + §5).
- *
- * Contract:
- *   • Pure function. Zero fs, zero network — Surfacer already did the I/O.
- *   • Empty candidates → returns "" (silence is precision; the hook MUST emit
- *     nothing in this case so the agent's context stays clean — see spec §6).
- *   • One bullet per candidate, capped at ~140 chars total per line so the
- *     injected block never blows past a few hundred tokens even at K=3.
- *   • Title-render uses [source] (palace shows palace/<room>) and includes
- *     the Surfacer's `why` clause so the model knows WHY this surfaced and
- *     can decide whether to act on it.
- *
- * Output shape (verbatim — host hook copy-pastes this into stdout):
- *
- *   <agent-recall-context>
- *   Possibly relevant prior memory (use if it helps, ignore otherwise):
- *   • [palace/goals] Rate limiting in Stripe — must use idempotency keys (why: matches palace/goals)
- *   • [journal] 2026-06-12 — Stripe webhook signature verification gotcha (why: matched recent journal 2026-06-12)
- *   </agent-recall-context>
- *
- * Worker done-definition self-check:
- *   (1) Error path: candidates is null/undefined → coerce to [] before any
- *       work. Each candidate field is `?? ""` so undefined never throws.
- *   (2) No global binaries — pure node, no shell-outs, no deps.
- *   (3) Threshold/ternary ordering — only branch is `length === 0 ? '' : block`,
- *       short-circuit-on-empty first.
- *   (4) No time-of-day logic; nothing TZ-sensitive.
- */
-import type { Candidate } from "./surfacer.js";
-/**
- * Render one Candidate as a single bullet line, capped to LINE_MAX_CHARS.
- *
- * Format: `• [<tag>] <title> (why: <why>)`
- *
- * If the assembled line exceeds LINE_MAX_CHARS we re-trim the title (the
- * most variable field) until the whole line fits. The `[tag]` prefix and
- * the `why:` clause are short and information-dense, so they survive
- * intact at the expense of the title's tail.
- */
-export declare function formatCandidate(c: Candidate): string;
-/**
- * Format a list of Candidates for the host hook to inject.
- *
- * Empty input → empty string. This is load-bearing — the hook in the host
- * is wired to echo our stdout verbatim, so an empty string keeps the
- * agent's context clean (silence is precision, spec §6).
- */
-export declare function formatForHook(candidates: Candidate[] | null | undefined): string;
-//# sourceMappingURL=injector.d.ts.map

package/dist/relevance/injector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../../src/relevance/injector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA+B/C;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CA0BpD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAqBhF"}