agent-recall-core 3.4.31 → 3.4.36

package/dist/relevance/stager.js.map

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

package/dist/relevance/surfacer.d.ts

@@ -1,34 +0,0 @@
-export interface Candidate {
-    /** Unique id, e.g. "palace:goals/decisions.md" or "journal:2026-06-19.md". */
-    id: string;
-    source: "palace" | "journal" | "staging" | "correction";
-    /** Room slug for palace/staging sources; omitted otherwise. */
-    room?: string;
-    /** ≤ 80 chars. */
-    title: string;
-    /** ≤ 300 chars preview. */
-    snippet: string;
-    /** 0..1 (clamped). */
-    score: number;
-    /** One-line explanation for the Injector. */
-    why: string;
-}
-export interface SurfaceOptions {
-    topK?: number;
-    minScore?: number;
-}
-/**
- * Surface up to `topK` candidates from a project relevant to `query`.
- *
- * Returns an EMPTY array when:
- *   • query is empty/whitespace (no signal to score against),
- *   • the project has no palace/journal yet (cold start), or
- *   • nothing clears `minScore` (silence is precision — better to surface
- *     nothing than to pollute context with low-confidence noise).
- *
- * The function is read-only and synchronous internally, but exposed as async to
- * leave room for future remote/embedding backends without changing the surface
- * (the Injector awaits it either way).
- */
-export declare function surface(project: string, query: string, opts?: SurfaceOptions): Promise<Candidate[]>;
-//# sourceMappingURL=surfacer.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"surfacer.d.ts","sourceRoot":"","sources":["../../src/relevance/surfacer.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACxD,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA6BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC,SAAS,EAAE,CAAC,CAiLtB"}

package/dist/relevance/surfacer.js

@@ -1,333 +0,0 @@
-/**
- * Surfacer — local retrieval for the Ambient Relevance Loop (v3.5.0 P-B).
- *
- * Per spec §4.2 (Surface) + §5: cheap, fully-local retrieval over palace + journal
- * + active corrections. Combines lexical overlap, room salience, and recency into
- * a single score. Threshold-gated (silence is precision) and top-K capped.
- *
- * Zero cloud. Zero embeddings dependency. Returns Candidate[] with a `why` field
- * the Injector uses to explain each surfaced memory.
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { listRooms } from "../palace/rooms.js";
-import { listJournalFiles } from "../helpers/journal-files.js";
-import { readActiveCorrections } from "../storage/corrections.js";
-import { roomDir } from "../storage/paths.js";
-import { readStaging } from "./stager.js";
-// ---------------------------------------------------------------------------
-// Tunables
-// ---------------------------------------------------------------------------
-const DEFAULT_TOP_K = 3;
-/** SILENCE IS PRECISION — anything below this floor returns nothing. */
-const DEFAULT_MIN_SCORE = 0.3;
-/** Cap journal scan to keep latency bounded (spec §10: tens-of-ms budget). */
-const JOURNAL_SCAN_CAP = 30;
-/** Cap staging scan — staging holds this-session exchanges; small N is plenty. */
-const STAGING_SCAN_CAP = 50;
-/** Snippet budget for a staged exchange (user+assistant concat). */
-const STAGING_SNIPPET_BUDGET = 400;
-/** Bytes of file content to consider for token overlap. */
-const PALACE_SNIPPET_BUDGET = 400;
-const JOURNAL_SNIPPET_BUDGET = 400;
-const SNIPPET_MAX_CHARS = 300;
-const TITLE_MAX_CHARS = 80;
-/** Correction surfacing — minimum lexical overlap before we surface. */
-const CORRECTION_OVERLAP_MIN = 0.3;
-/** Strong bonus added to the correction's surfaced score. */
-const CORRECTION_SCORE_BONUS = 0.3;
-// ---------------------------------------------------------------------------
-// Surface
-// ---------------------------------------------------------------------------
-/**
- * Surface up to `topK` candidates from a project relevant to `query`.
- *
- * Returns an EMPTY array when:
- *   • query is empty/whitespace (no signal to score against),
- *   • the project has no palace/journal yet (cold start), or
- *   • nothing clears `minScore` (silence is precision — better to surface
- *     nothing than to pollute context with low-confidence noise).
- *
- * The function is read-only and synchronous internally, but exposed as async to
- * leave room for future remote/embedding backends without changing the surface
- * (the Injector awaits it either way).
- */
-export async function surface(project, query, opts) {
-    // Empty-query guard FIRST — tokenOverlap of "" against anything is 0 anyway,
-    // but exiting early skips all the fs work for the no-signal case.
-    if (!query || query.trim() === "")
-        return [];
-    const topK = opts?.topK ?? DEFAULT_TOP_K;
-    const minScore = opts?.minScore ?? DEFAULT_MIN_SCORE;
-    const candidates = [];
-    // ── Palace topics ─────────────────────────────────────────────────────────
-    let rooms;
-    try {
-        rooms = listRooms(project);
-    }
-    catch {
-        rooms = [];
-    }
-    for (const room of rooms) {
-        let dir;
-        try {
-            dir = roomDir(project, room.slug);
-        }
-        catch {
-            continue; // bad slug — skip, never throw out of surface()
-        }
-        let topicFiles;
-        try {
-            topicFiles = fs.readdirSync(dir);
-        }
-        catch {
-            continue; // missing/unreadable room dir — skip
-        }
-        for (const file of topicFiles) {
-            if (!file.endsWith(".md"))
-                continue;
-            if (file === "README.md")
-                continue; // README is room scaffold, not a topic
-            const fullPath = path.join(dir, file);
-            let content;
-            try {
-                content = fs.readFileSync(fullPath, "utf-8").slice(0, PALACE_SNIPPET_BUDGET);
-            }
-            catch {
-                continue; // unreadable topic file — skip
-            }
-            const lex = tokenOverlap(query, `${room.name} ${file} ${content}`);
-            // Lexical gate FIRST — silence is precision. A room can be high-salience
-            // and freshly updated, but if zero query tokens match the topic, it is
-            // not relevant to THIS turn; surfacing it is exactly the context-flooding
-            // failure mode the spec warns against (§6). Salience/recency act only as
-            // tiebreakers among lex-matched candidates.
-            if (lex <= 0)
-                continue;
-            const sal = clamp01(room.salience ?? 0.5);
-            const rec = recencyBoost(room.updated);
-            const score = clamp01(lex * 0.5 + sal * 0.3 + rec * 0.2);
-            if (score >= minScore) {
-                candidates.push({
-                    id: `palace:${room.slug}/${file}`,
-                    source: "palace",
-                    room: room.slug,
-                    title: truncate(`${room.name} — ${file.replace(/\.md$/, "")}`, TITLE_MAX_CHARS),
-                    snippet: truncate(content, SNIPPET_MAX_CHARS),
-                    score,
-                    why: `matched palace/${room.slug}`,
-                });
-            }
-        }
-    }
-    // ── Journals (recent only, exclude archive) ───────────────────────────────
-    let journals;
-    try {
-        journals = listJournalFiles(project, /* includeArchive */ false);
-    }
-    catch {
-        journals = [];
-    }
-    // Cap to keep latency bounded; listJournalFiles already sorts newest-first.
-    const recentJournals = journals.slice(0, JOURNAL_SCAN_CAP);
-    for (const j of recentJournals) {
-        const fullPath = path.join(j.dir, j.file);
-        let content;
-        try {
-            content = fs.readFileSync(fullPath, "utf-8").slice(0, JOURNAL_SNIPPET_BUDGET);
-        }
-        catch {
-            continue;
-        }
-        const lex = tokenOverlap(query, content);
-        // Same lex-gate as palace topics — a recent journal with zero query overlap
-        // is not "relevant", it is just new. recency * 0.4 alone clears 0.3 and
-        // would flood every turn with the latest entry; gate it.
-        if (lex <= 0)
-            continue;
-        const rec = recencyBoost(j.date);
-        const score = clamp01(lex * 0.6 + rec * 0.4);
-        if (score >= minScore) {
-            candidates.push({
-                id: `journal:${j.file}`,
-                source: "journal",
-                title: truncate(`journal ${j.date}`, TITLE_MAX_CHARS),
-                snippet: truncate(content, SNIPPET_MAX_CHARS),
-                score,
-                why: `matched recent journal ${j.date}`,
-            });
-        }
-    }
-    // ── Staging (this-session exchanges, pre-promote) ────────────────────────
-    // Per spec §4.4: "Staging is itself retrievable by Surface (so this-session
-    // content is recallable before promotion)". Without this branch, anything
-    // captured by hook-stop in the current session is invisible to Surface
-    // until session_end fires Promote — which defeats the read-after-write
-    // contract the spec promises. We score these the same way as journals
-    // (lex + recency) but skip the salience term (staged entries don't live
-    // in a room yet) and gate them on the same lex floor (silence is
-    // precision; a staged "ok thanks" must not surface). The Candidate.source
-    // is "staging" so the Injector / dashboard can distinguish them from
-    // promoted journal hits.
-    let staged;
-    try {
-        staged = readStaging(project, STAGING_SCAN_CAP);
-    }
-    catch {
-        staged = [];
-    }
-    for (const ex of staged) {
-        // Concatenate the human-readable fields so token overlap considers both
-        // sides of the exchange. tool_calls are intentionally excluded — their
-        // args_summary is JSON noise that would inflate the token set without
-        // adding semantic content.
-        const text = `${ex.user ?? ""} ${ex.assistant ?? ""}`
-            .trim()
-            .slice(0, STAGING_SNIPPET_BUDGET);
-        if (!text)
-            continue; // tool-only turn — nothing to score against
-        const lex = tokenOverlap(query, text);
-        // Same lex-gate as palace topics / journals — silence is precision.
-        // A freshly-staged exchange with zero query overlap is not relevant to
-        // THIS turn; surfacing it would flood context with chitchat the
-        // Promoter is about to discard anyway.
-        if (lex <= 0)
-            continue;
-        const rec = recencyBoost(ex.ts);
-        // Weight identical to journals (lex 0.6 + rec 0.4) — staging IS journal
-        // material that just hasn't been promoted yet. Keeping weights aligned
-        // means a staged-then-promoted entry's score doesn't visibly jump.
-        const score = clamp01(lex * 0.6 + rec * 0.4);
-        if (score >= minScore) {
-            // Title: ISO timestamp + first ~40 chars of the text so the candidate
-            // is identifiable to the agent even before it gets a real slug.
-            const head = text.replace(/\s+/g, " ").slice(0, TITLE_MAX_CHARS - 25);
-            candidates.push({
-                // Use the ts as the id — ts is unique-enough within a project (one
-                // line per exchange) and stable across reads. Tail with `staging:`
-                // prefix so per_source bucketing in precision.ts groups them.
-                id: `staging:${ex.ts}`,
-                source: "staging",
-                title: truncate(`staging ${ex.ts.slice(0, 19)} — ${head}`, TITLE_MAX_CHARS),
-                snippet: truncate(text, SNIPPET_MAX_CHARS),
-                score,
-                why: `matched current-session staging`,
-            });
-        }
-    }
-    // ── Active corrections — strong bonus when query overlaps the rule ───────
-    let corrections;
-    try {
-        corrections = readActiveCorrections(project);
-    }
-    catch {
-        corrections = [];
-    }
-    for (const c of corrections) {
-        const overlap = tokenOverlap(query, c.rule || "");
-        if (overlap >= CORRECTION_OVERLAP_MIN) {
-            const score = clamp01(overlap + CORRECTION_SCORE_BONUS);
-            candidates.push({
-                id: `correction:${c.id}`,
-                source: "correction",
-                title: truncate(c.rule || c.id, TITLE_MAX_CHARS),
-                snippet: truncate(c.context || c.rule || "", SNIPPET_MAX_CHARS),
-                score,
-                why: "matches active correction",
-            });
-        }
-    }
-    return candidates.sort((a, b) => b.score - a.score).slice(0, topK);
-}
-// ---------------------------------------------------------------------------
-// Helpers (inline — only used by Surfacer)
-// ---------------------------------------------------------------------------
-/**
- * Lexical overlap between two strings.
- *
- * Tokens: lowercase alphanum/CJK runs of length ≥ 4. Ratio is
- *   |aTokens ∩ bTokens| / max(|aTokens|, |bTokens|, 1)
- * so a tiny query that fully matches a long doc still scores high, and the
- * `max(..., 1)` guard keeps the empty-set case at 0 instead of NaN.
- *
- * Visible for testing — kept narrow (no synonym expansion, no stemming) because
- * Surfacer is the FIRST pass; the agent's own model is the final relevance
- * judge (spec §4.2 "Judge").
- */
-function tokenOverlap(a, b) {
-    const aTokens = tokenize(a);
-    const bTokens = tokenize(b);
-    if (aTokens.size === 0 || bTokens.size === 0)
-        return 0;
-    let intersect = 0;
-    // Iterate the smaller set for cheaper lookups.
-    const [smaller, larger] = aTokens.size <= bTokens.size ? [aTokens, bTokens] : [bTokens, aTokens];
-    for (const t of smaller) {
-        if (larger.has(t))
-            intersect++;
-    }
-    const denom = Math.max(aTokens.size, bTokens.size, 1);
-    return intersect / denom;
-}
-function tokenize(s) {
-    const out = new Set();
-    if (!s)
-        return out;
-    // Split on anything that is not alphanumeric (ASCII only — keeps the helper
-    // lean; the broader vector pipeline handles CJK).
-    const parts = s.toLowerCase().split(/[^a-z0-9]+/);
-    for (const p of parts) {
-        if (p.length >= 4)
-            out.add(p);
-    }
-    return out;
-}
-/**
- * Recency boost for a YYYY-MM-DD or ISO date string.
- *
- *   < 7 days  → 1.0
- *   < 30 days → 0.6
- *   < 180 days→ 0.2
- *   else      → 0
- *
- * Threshold ordering is high → low (worker done-definition rule 3). Any
- * unparseable input (NaN) returns 0 — never throws.
- */
-function recencyBoost(dateStr) {
-    if (!dateStr)
-        return 0;
-    const dt = new Date(dateStr);
-    const t = dt.getTime();
-    if (isNaN(t))
-        return 0;
-    const ageMs = Date.now() - t;
-    if (ageMs < 0) {
-        // Future-dated entries (e.g. clock drift, fixture data). Treat as "very
-        // recent" rather than NaN/0 so they still rank — but cap at 1.0.
-        return 1.0;
-    }
-    const days = ageMs / (24 * 60 * 60 * 1000);
-    // High threshold first so we never return the lower bucket for a recent doc.
-    if (days < 7)
-        return 1.0;
-    if (days < 30)
-        return 0.6;
-    if (days < 180)
-        return 0.2;
-    return 0;
-}
-function clamp01(n) {
-    if (isNaN(n))
-        return 0;
-    if (n < 0)
-        return 0;
-    if (n > 1)
-        return 1;
-    return n;
-}
-function truncate(s, n) {
-    if (!s)
-        return "";
-    return s.length <= n ? s : s.slice(0, n);
-}
-//# sourceMappingURL=surfacer.js.map

package/dist/relevance/surfacer.js.map

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