agent-working-memory 0.16.1 → 0.18.1

package/dist/hooks/prime-query.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Prompt-to-query shaping for the prime hook (2026-10-16).
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * /hooks/prime used to recall against the WHOLE prompt. A prompt that carries a
+ * pasted log, a block of code or a background-task report is mostly paste, and
+ * every retrieval signal then reads the paste instead of the question: BM25 scores
+ * the paste's terms, the embedding becomes the paste's vector, and the cross-encoder
+ * sees mostly paste even after its 128-token query cap (reranker.ts). Measured on
+ * 100 real-store fixture queries wrapped in ~600 tokens of paste, success@1 was 49%
+ * with the question before the paste and 26% with it after, against 93% for the
+ * bare query, and each recall took 5-8 s.
+ *
+ * WHAT IT DOES
+ * ------------
+ * A prompt at or under the budget is returned unchanged, which is most typed
+ * prompts. A longer one is cut down in four steps:
+ *
+ *   1. Envelope lines that only carry an id, a path or a status
+ *      (`<task-id>b43drliev</task-id>`) are dropped, and lowercase tags are stripped
+ *      to their text. Background-task notifications arrive this way; their harness
+ *      note, token counts and attribution trailers are dropped as boilerplate.
+ *   2. Lines that read as machine output are dropped: fenced code, timestamped or
+ *      levelled log lines, stack frames, code statements, SQL, JSON, YAML, CSV,
+ *      tables, diffs, key=value runs and symbol-dense lines. Up to two of them that
+ *      name an error are kept, in a reserved share of the budget, because
+ *      "fix this: <trace>" is answered by the error, not by the prose around it.
+ *   3. The likeliest question is moved to the front (see shapePrimeQuery: the
+ *      cross-encoder reads the start of the query).
+ *   4. If the prose is still over budget, the query is its head and its tail.
+ *
+ * When the prose is only a pointer ("explain this:"), the pointer leads and the
+ * paste's own head and tail fill the budget, because the paste is the subject.
+ *
+ * The shaped text is used for RECALL ONLY. Nothing here changes what the agent sees.
+ * Explicit memory_recall queries are not shaped: an agent's query is written to be
+ * a query.
+ */
+/** Characters of query the prime hook recalls with. 0 disables shaping. */
+export declare const PRIME_QUERY_CHARS: number;
+/** True when a line reads as machine output rather than something a person wrote. */
+export declare function isMachineLine(line: string): boolean;
+/**
+ * The query the prime hook recalls with. Pure and synchronous; never throws on a
+ * string. `budget` defaults to AWM_PRIME_QUERY_CHARS (400); 0 returns the prompt.
+ * Returns '' for a prompt that is nothing but envelope; the caller then skips recall.
+ *
+ * ORDER MATTERS. The cross-encoder reads the start of the query: the same question and
+ * the same memory scored 0.996 with the question in front of 300 chars of notes and
+ * 0.007 behind them, and every other memory scored ~0 too, so ranking collapsed. The
+ * query therefore leads with the likeliest question: a task's <summary>, then lines
+ * that ask something, then the end block of the prompt that reads as a typed request
+ * (steps 1-3 below).
+ */
+export declare function shapePrimeQuery(prompt: string, budget?: number): string;
+//# sourceMappingURL=prime-query.d.ts.map

package/dist/hooks/prime-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-query.d.ts","sourceRoot":"","sources":["../../src/hooks/prime-query.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,QAK1B,CAAC;AAiGL,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA0BnD;AAqED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAA0B,GAAG,MAAM,CAyH1F"}

package/dist/hooks/prime-query.js

@@ -0,0 +1,388 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Prompt-to-query shaping for the prime hook (2026-10-16).
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * /hooks/prime used to recall against the WHOLE prompt. A prompt that carries a
+ * pasted log, a block of code or a background-task report is mostly paste, and
+ * every retrieval signal then reads the paste instead of the question: BM25 scores
+ * the paste's terms, the embedding becomes the paste's vector, and the cross-encoder
+ * sees mostly paste even after its 128-token query cap (reranker.ts). Measured on
+ * 100 real-store fixture queries wrapped in ~600 tokens of paste, success@1 was 49%
+ * with the question before the paste and 26% with it after, against 93% for the
+ * bare query, and each recall took 5-8 s.
+ *
+ * WHAT IT DOES
+ * ------------
+ * A prompt at or under the budget is returned unchanged, which is most typed
+ * prompts. A longer one is cut down in four steps:
+ *
+ *   1. Envelope lines that only carry an id, a path or a status
+ *      (`<task-id>b43drliev</task-id>`) are dropped, and lowercase tags are stripped
+ *      to their text. Background-task notifications arrive this way; their harness
+ *      note, token counts and attribution trailers are dropped as boilerplate.
+ *   2. Lines that read as machine output are dropped: fenced code, timestamped or
+ *      levelled log lines, stack frames, code statements, SQL, JSON, YAML, CSV,
+ *      tables, diffs, key=value runs and symbol-dense lines. Up to two of them that
+ *      name an error are kept, in a reserved share of the budget, because
+ *      "fix this: <trace>" is answered by the error, not by the prose around it.
+ *   3. The likeliest question is moved to the front (see shapePrimeQuery: the
+ *      cross-encoder reads the start of the query).
+ *   4. If the prose is still over budget, the query is its head and its tail.
+ *
+ * When the prose is only a pointer ("explain this:"), the pointer leads and the
+ * paste's own head and tail fill the budget, because the paste is the subject.
+ *
+ * The shaped text is used for RECALL ONLY. Nothing here changes what the agent sees.
+ * Explicit memory_recall queries are not shaped: an agent's query is written to be
+ * a query.
+ */
+/** Characters of query the prime hook recalls with. 0 disables shaping. */
+export const PRIME_QUERY_CHARS = (() => {
+    // An explicit 0 disables; anything else invalid falls back to the default (see
+    // reranker.ts shapeCap): a typo must not quietly restore whole-prompt recall.
+    const v = Number(process.env.AWM_PRIME_QUERY_CHARS?.trim() || NaN);
+    return Number.isInteger(v) && v >= 0 ? v : 400;
+})();
+/** Error-bearing machine lines kept, and the share of the budget they may take. */
+const MAX_SALIENT = 2;
+const SALIENT_SHARE = 0.3;
+/** Lines longer than this are classified on their first CLASSIFY_LEN chars. */
+const CLASSIFY_LEN = 400;
+// Seconds are required: "2026-10-15 10:30 call with the client" is a person's note.
+const TIMESTAMP = /^\[?\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}|^\[?\d{2}:\d{2}:\d{2}[.,\]\s]/;
+const LOG_LEVEL = /^\[?(TRACE|DEBUG|INFO|NOTICE|WARN|WARNING|ERROR|ERR|FATAL|CRITICAL)\]?[\s:|-]/;
+// A frame names a source location (a path or file with :line), so "at 10:30 tomorrow"
+// is not one. PowerShell error records are frames too.
+// The error header a trace starts or ends with (TypeError: …, requests.exceptions.
+// ConnectionError: …) belongs to the trace; it is kept as an error line, below.
+const STACK_FRAME = /^(at\s+(async\s+)?(\S+\s+){0,4}\(?\S*[/\\.]\S*:\d+(:\d+)?\)?$|File ".*", line \d+|Traceback \(most recent call last\):|During handling of the above exception|The above exception was the direct cause|[\w.]*(Error|Exception):\s|#\d+\s+0x[0-9a-f]+|\.\.\. \d+ more|At line:\d+ char:\d+|\+ (CategoryInfo|FullyQualifiedErrorId)\s*:)/;
+// Keyword AND code syntax: "for the record (see above)", "let me know if x = y" and
+// "import members from the 2025 sheet" are prose; the code forms are not.
+const CODE_KEYWORD = new RegExp([
+    String.raw `^(const|let|var)\s+([\w$]+|\{[^}]*\}|\[[^\]]*\])\s*(:\s*[\w<>[\]|. ]+)?=(?!=)`,
+    String.raw `^(async\s+)?function\b\s*\*?\s*[\w$]*\s*\(`,
+    String.raw `^import\s+(['"]|.*\s+from\s+['"])`,
+    // "export type information to the CSV" is prose; `export type Foo =` is not.
+    String.raw `^export\s+(\{|\*|default\b|type\s+\w+\s*[=<{]|interface\b|const\b|let\b|function\b|class\b|async\b)`,
+    // One parenthesised condition and nothing after it: "for (most of) the team…" is prose.
+    String.raw `^(if|for|while|switch|catch)\s*\([^)]*\)\s*\{?$`,
+    String.raw `^def\s+\w+\s*\(`,
+    String.raw `^class\s+\w+\s*(\(.*\)\s*:|:$|\{|(extends|implements)\b)`,
+    String.raw `^(SELECT|INSERT|UPDATE|DELETE|CREATE|ALTER|DROP|WITH)\s.*\b(FROM|INTO|SET|TABLE|WHERE|AS)\b`,
+    String.raw `^(FROM|WHERE|JOIN|LEFT JOIN|INNER JOIN|GROUP BY|ORDER BY|HAVING|LIMIT|UNION)\s`,
+    String.raw `^SELECT\s+(DISTINCT\s+)?[\w.*]+(\s*,\s*[\w.*]+)*,?$`,
+    // Python-style assignment, spaced: `result = self.fetch(x)`. Unspaced `AWM_X=1 didn't
+    // help (I checked)` is a person starting a sentence with a flag.
+    String.raw `^[\w.]+(\[[^\]]*\])?\s+[-+*/]?=\s+\S.*[(\[{'"]`,
+].join('|'));
+// An opening brace at the end, or a closing bracket at the start. A line ENDING in '}'
+// is often a person's template ("the template uses {name}"), so that alone is not code.
+const CODE_END = /\{\s*$|^\s*[}\])]/;
+// A trailing ';' is code only with code syntax beside it: "- raise the cap to $30;" is
+// a person's list, `return service.load(id);` is not.
+const SEMICOLON_END = /;\s*$/;
+const CODE_SYNTAX = /\w\(|[=!<>]=|=>|\s=\s|^\s*(return|throw|break|continue)\b/;
+// A key line, a bare bracket, or a bare array value ("beta", "alpha", 42, null). A
+// quoted sentence on its own line is a person quoting, so a string with spaces needs
+// the trailing comma.
+const JSON_LINE = /^"[^"]+"\s*:|^[[{]\s*$|^[\]}],?\s*$|^("[^"\s]*",?|"[^"]*",|-?\d[\d.eE+-]*,?|true,?|false,?|null,?)$/;
+// Compiler and tool output: lowercase `error[E0308]: …` / `warning: …` headers (a typed
+// "Note: …" is prose), Go `panic:` / `goroutine 1 [running]:` lines, `--> src/x.rs:41:10`
+// locations, `   |` / `41 |` source gutters, a bare path:line (nothing after it but an
+// offset — "src/x.ts:42 throws when…" is a person), and frames whose arguments are hex
+// addresses (Go, C).
+const TOOL_OUTPUT = /^((error|warning)(\[[\w-]+\])?:\s|panic:\s|goroutine \d+ \[|Process finished with exit code \d+|npm (ERR!|WARN|notice)\s|-->\s*\S+:\d+|\d*\s*\|(\s|$)|[.~]?[\w.-]*[/\\][^\s:]+:\d+(:\d+)?(\s+[+(]\S*)?$)|(0x[0-9a-fA-F]{4,}.*){2}/;
+const DIFF_HEADER = /^(diff --git |index [0-9a-f]+\.\.[0-9a-f]+|--- (a\/|\/dev\/null)|\+\+\+ (b\/|\/dev\/null)|@@ .* @@)/;
+// One-token key, then one token or nothing (YAML, headers). "Note: fix it" is prose.
+// A quoted value must be one token too: `- Sweep: "LOCAL ONLY. Never touch prod"` is a
+// person's note. A bare label ("Summary:") is dropped, which costs nothing.
+const YAML_LINE = /^(-\s+)?[\w.-]+:(\s+("[^"\s]*"|'[^'\s]*'|\S+))?\s*$/;
+// Delimited rows: CSV with no comma-space (a person's list has them), or 2+ table pipes.
+const CSV_LINE = /^[^\s,]+(,[^,\s]*){3,}$/;
+const TABLE_LINE = /^\|?[^|]*(\s\|\s[^|]*){2,}\|?$|^[-+|: ]{5,}$|^\(\d+ rows?\)$/;
+// The lookbehind keeps this linear: \b[\w.-]+ restarts at every '.' and '-' otherwise,
+// which took 10 s on a 100 KB run of 'a.a.a.'.
+const KEY_VALUE = /(?<![\w.-])[\w.-]+=\S+/g;
+// Error words, plus HTTP 4xx/5xx statuses.
+const ERROR_WORD = /\b(error|exception|fail(ed|ure)?|fatal|panic|denied|refused|cannot|can't|unable|not found|timed? ?out|undefined|traceback|segfault|abort(ed)?)\b|\b(HTTP\/\S+\s+|status\s*)[45]\d\d\b/i;
+// Errno names (ECONNREFUSED, EPIPE) and compiler/vendor codes (TS2304, ORA-00942).
+// Case-sensitive: with /i, E[A-Z]{3,} would match "every".
+const ERROR_CODE = /\bE[A-Z]{3,}\b|\b[A-Z]{2,4}-?\d{3,5}\b/;
+// A block that cannot be the typed request even though it reads as prose: a markdown
+// heading, a line that introduces what follows ("Terraform will perform the following
+// actions:", "Here is the log:"), a sign-off, or a signature / title line.
+const HEADING = /^#{1,6}\s/;
+const INTRODUCER = /:\s*$/;
+const SIGN_OFF = /^(thanks|thank you|many thanks|cheers|regards|best( regards| wishes)?|sincerely|kind regards|let me know( what you think)?|hope this helps)\b/i;
+const SIGNATURE = /^([A-Z][\w&.'’-]*|of|and|the|for|at|&)(\s+([A-Z][\w&.'’-]*|of|and|the|for|at|&)){0,5}$/;
+/** Prose shorter than this many words is a pointer ("explain this:"): the paste is the subject. */
+const POINTER_WORDS = 3;
+const QUESTION = /\?(\s|$)/;
+const MAX_QUESTIONS = 2;
+const QUESTION_LEN = 150;
+const CJK = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u;
+const CJK_ALL = new RegExp(CJK.source, 'gu');
+/** A whole-line tag whose value is one token: an id, a path, a status, a number. */
+const ID_TAG_LINE = /^<([\w-]+)>\s*\S*\s*<\/\1>$/;
+// Lowercase names only: envelope and markup tags. `Map<String, List<Integer>>` is code
+// a person typed into a sentence.
+const TAG = /<\/?[a-z][a-z0-9_-]*(\s[^<>]*)?>/g;
+// A fence marker starts a line and is not closed on it: "```js", "``` js title=x" and a
+// bare "```" are markers; "```npm run build``` fails" is inline code in prose.
+const FENCE = /^(```|~~~)(?!.*(```|~~~))/;
+// Claude Code's task notifications carry the same harness note on every one ("A
+// task-notification fires each time this agent stops…") and token counts. Both say
+// nothing about the task, and the note alone took ~150 chars of a 400-char head.
+const BOILERPLATE_ELEMENTS = ['note', 'usage', 'subagent_tokens'];
+// Attribution trailers an agent's report ends with: they would fill the tail.
+const BOILERPLATE_LINE = /^(🤖\s*)?Generated with \[?Claude Code\]?|^Co-Authored-By:|^Claude-Session:|^https:\/\/claude\.ai\/code\/session_/i;
+/** True when a line reads as machine output rather than something a person wrote. */
+export function isMachineLine(line) {
+    // Bounded, so every check below is linear in a fixed length whatever was pasted.
+    const t = line.trim().slice(0, CLASSIFY_LEN);
+    if (!t)
+        return false;
+    if (TIMESTAMP.test(t) || LOG_LEVEL.test(t) || STACK_FRAME.test(t) || DIFF_HEADER.test(t) || TOOL_OUTPUT.test(t))
+        return true;
+    // A diff body line is a marker plus code. "- item" (a markdown bullet) and "+1" are
+    // not: the rest of the line must itself read as machine output.
+    if (/^[+-](?=\S|\s{2})/.test(t) && !/^[+-]\d/.test(t) && isMachineLine(t.slice(1)))
+        return true;
+    if (CODE_KEYWORD.test(t) || CODE_END.test(t) || JSON_LINE.test(t))
+        return true;
+    if (YAML_LINE.test(t) || CSV_LINE.test(t) || TABLE_LINE.test(t))
+        return true;
+    if (SEMICOLON_END.test(t) && CODE_SYNTAX.test(t))
+        return true;
+    // Three, and most of the line: "set AWM_RERANK2=1 and AWM_RERANK_TAGS=1" is a person
+    // typing; `host=a port=5432 user=b` is not. Pairs inside backticks are a person
+    // quoting them, so they do not count.
+    const kv = t.replace(/`[^`]*`/g, ' ').match(KEY_VALUE)?.length ?? 0;
+    if (kv >= 3 && kv / t.split(/\s+/).length >= 0.4)
+        return true;
+    if (t.length >= 8) {
+        // Identifiers like d.requires_horse or cleanup2.py are fine in prose; a line that
+        // is a quarter punctuation is not. Markdown emphasis and code ticks, path slashes,
+        // sentence punctuation and emoji are a person's, so they do not count.
+        const symbols = t.replace(/[\p{L}\p{N}\p{M}\p{Extended_Pictographic}‍\s_.'’,*`/\\!?-]/gu, '').length;
+        if (symbols / t.length > (t.length >= 24 ? 0.25 : 0.5))
+            return true;
+        // Minified or base64: long and almost no spaces. CJK prose has no spaces either.
+        if (t.length >= 200 && !CJK.test(t) && (t.match(/\s/g)?.length ?? 0) / t.length < 0.03)
+            return true;
+    }
+    return false;
+}
+const ANY_TAG = /<\/?[A-Za-z][^<>]*>/g;
+/**
+ * Checks that need the raw line, before tags are stripped and spaces collapsed: a line
+ * that is mostly markup (HTML, XML) or laid out in columns (`kubectl get pods`, `ps`,
+ * aligned tables) is machine output, though its words would read as prose afterwards.
+ */
+function isMarkupOrColumns(raw) {
+    const t = raw.slice(0, CLASSIFY_LEN);
+    // Several tags, or tags that are most of the line. "What does <summary> do vs
+    // <details>?" mentions two tags; an HTML line is built of them.
+    const found = t.match(ANY_TAG) ?? [];
+    const share = found.join('').length / t.length;
+    if ((share > 0.6 || (share > 0.4 && found.length >= 3)) && !/^<(summary|result)>/.test(t))
+        return true;
+    return /\S(\s{3,}\S+){2,}/.test(t);
+}
+/** `i` moved off the low half of a surrogate pair, so a cut never splits an emoji. */
+function safe(s, i) {
+    const c = s.charCodeAt(i);
+    return c >= 0xdc00 && c <= 0xdfff ? i - 1 : i;
+}
+/** First `n` chars, cut back to a word boundary when one is near. */
+function head(s, n) {
+    if (s.length <= n)
+        return s;
+    const cut = s.slice(0, safe(s, n));
+    const sp = cut.lastIndexOf(' ');
+    return (sp > n * 0.6 ? cut.slice(0, sp) : cut).trimEnd();
+}
+/** Last `n` chars, cut forward to a word boundary when one is near. */
+function tail(s, n) {
+    if (s.length <= n)
+        return s;
+    const from = s.length - n;
+    const cut = s.slice(safe(s, from) === from ? from : from + 1);
+    const sp = cut.indexOf(' ');
+    return (sp >= 0 && sp < n * 0.4 ? cut.slice(sp + 1) : cut).trimStart();
+}
+const ELLIPSIS = ' … ';
+/** Head and tail of `s` in at most `budget` chars. */
+function headAndTail(s, budget) {
+    if (s.length <= budget)
+        return s;
+    if (budget < 4 * ELLIPSIS.length)
+        return head(s, budget);
+    const room = budget - ELLIPSIS.length;
+    const h = Math.ceil(room / 2);
+    return `${head(s, h)}${ELLIPSIS}${tail(s, room - h)}`;
+}
+/** Remove `<name>…</name>` elements in one linear pass; an unclosed one is left alone. */
+function dropElements(s, names) {
+    for (const name of names) {
+        const open = `<${name}>`, close = `</${name}>`;
+        let out = '', at = 0;
+        for (let i = s.indexOf(open); i >= 0; i = s.indexOf(open, at)) {
+            const j = s.indexOf(close, i + open.length);
+            if (j < 0)
+                break;
+            out += `${s.slice(at, i)}\n`;
+            at = j + close.length;
+        }
+        s = out + s.slice(at);
+    }
+    return s;
+}
+/**
+ * The query the prime hook recalls with. Pure and synchronous; never throws on a
+ * string. `budget` defaults to AWM_PRIME_QUERY_CHARS (400); 0 returns the prompt.
+ * Returns '' for a prompt that is nothing but envelope; the caller then skips recall.
+ *
+ * ORDER MATTERS. The cross-encoder reads the start of the query: the same question and
+ * the same memory scored 0.996 with the question in front of 300 chars of notes and
+ * 0.007 behind them, and every other memory scored ~0 too, so ranking collapsed. The
+ * query therefore leads with the likeliest question: a task's <summary>, then lines
+ * that ask something, then the end block of the prompt that reads as a typed request
+ * (steps 1-3 below).
+ */
+export function shapePrimeQuery(prompt, budget = PRIME_QUERY_CHARS) {
+    if (budget <= 0 || prompt.length <= budget)
+        return prompt;
+    let text = prompt.replace(/\r\n?/g, '\n');
+    // Envelope handling (boilerplate, tag stripping) applies to task notifications only,
+    // never to typed text: "What does <summary> do vs <details>?" keeps its subject.
+    const envelope = text.trimStart().startsWith('<task-notification>');
+    if (envelope)
+        text = dropElements(text, BOILERPLATE_ELEMENTS);
+    const rawLines = text.split('\n');
+    // An unclosed fence would turn everything typed after it into machine output, so the
+    // last marker of an odd count does not open a block.
+    const fences = rawLines.reduce((a, l, k) => (FENCE.test(l.trim()) ? [...a, k] : a), []);
+    const ignoredFence = fences.length % 2 ? fences[fences.length - 1] : -1;
+    const lead = []; // <summary> lines
+    const prose = []; // unique prose lines, in order
+    const blocks = [{ lines: 0, prose: [], size: 0 }];
+    const seen = new Set(); // a line repeated verbatim is paste; keep it once
+    const machine = [];
+    const salient = [];
+    let fenced = false;
+    for (let k = 0; k < rawLines.length; k++) {
+        const trimmed = rawLines[k].trim();
+        let b = blocks[blocks.length - 1];
+        if (!trimmed) {
+            if (b.lines)
+                blocks.push({ lines: 0, prose: [], size: 0 });
+            continue;
+        }
+        if (FENCE.test(trimmed) && k !== ignoredFence) {
+            fenced = !fenced;
+            continue;
+        }
+        if (trimmed.length <= CLASSIFY_LEN && ID_TAG_LINE.test(trimmed))
+            continue;
+        const line = (envelope ? trimmed.replace(TAG, ' ') : trimmed).replace(/\s+/g, ' ').trim();
+        if (!line || BOILERPLATE_LINE.test(line))
+            continue;
+        b.lines++;
+        if (fenced || isMarkupOrColumns(trimmed) || isMachineLine(line)) {
+            machine.push(line);
+            const head400 = line.slice(0, CLASSIFY_LEN);
+            if (salient.length < MAX_SALIENT && !salient.includes(line) && (ERROR_WORD.test(head400) || ERROR_CODE.test(head400))) {
+                salient.push(line);
+            }
+            continue;
+        }
+        if (envelope && trimmed.startsWith('<summary>')) {
+            lead.push(line);
+            continue;
+        }
+        b.prose.push(line);
+        b.size += line.length;
+        if (seen.has(line))
+            continue;
+        seen.add(line);
+        prose.push(line);
+    }
+    const wordsIn = (l) => l.split(/\s+/).filter(w => /\p{L}{2}/u.test(w)).length;
+    const all = [...lead, ...prose];
+    const words = wordsIn(all.join(' ')) + (all.join('').match(CJK_ALL)?.length ?? 0) / 2;
+    // No prose, or only a pointer to the paste: the paste is what the prompt is about.
+    // The pointer leads, and the paste's head and tail fill the rest.
+    if (words < POINTER_WORDS) {
+        const pointer = all.join(' ');
+        const rest = headAndTail(machine.join('\n'), Math.max(0, budget - pointer.length - 1));
+        return headAndTail([pointer, rest].filter(Boolean).join('\n'), budget);
+    }
+    // 1. Questions move to the front, within half the budget.
+    const questions = [];
+    const asked = new Set();
+    let used = 0;
+    for (const line of prose) {
+        if (questions.length >= MAX_QUESTIONS)
+            break;
+        const at = line.search(QUESTION);
+        if (at < 0)
+            continue;
+        // A long line is cut to the sentence that asks (searched backwards from the '?',
+        // within a bounded window); the line itself stays in the prose.
+        let q = line;
+        if (line.length > QUESTION_LEN) {
+            const from = Math.max(0, at - 2 * QUESTION_LEN);
+            const before = line.slice(from, at);
+            const stop = Math.max(before.lastIndexOf('. '), before.lastIndexOf('! '), before.lastIndexOf('? '));
+            q = head(line.slice(stop >= 0 ? from + stop + 2 : from, at + 1).trim(), QUESTION_LEN);
+        }
+        if (used + q.length + 1 > budget / 2)
+            break;
+        questions.push(q);
+        if (q === line)
+            asked.add(line);
+        used += q.length + 1;
+    }
+    // 2. Otherwise the typed request is usually a block at one end of the prompt, set off
+    // from the paste by a blank line. An end block can lead only if it is mostly prose and
+    // holds a sentence that is not a heading, an introducer, a sign-off or a signature.
+    // When both ends can, the first leads unless it is clearly the paste (over twice the
+    // size of the last). This needs no knowledge of the paste's format, so it holds when
+    // some of a paste's lines leak through as prose.
+    const filled = blocks.filter(b => b.lines > 0);
+    const canLead = (b) => b.prose.length / b.lines >= 0.5
+        && b.prose.some(l => (wordsIn(l) >= POINTER_WORDS || CJK.test(l))
+            && !HEADING.test(l) && !INTRODUCER.test(l) && !SIGN_OFF.test(l) && !SIGNATURE.test(l));
+    let leadBlock = [];
+    let decided = questions.length > 0;
+    if (!decided && filled.length >= 2) {
+        const first = filled[0], last = filled[filled.length - 1];
+        const firstOk = canLead(first), lastOk = canLead(last);
+        if (lastOk && (!firstOk || last.size * 2 < first.size))
+            leadBlock = last.prose;
+        decided = firstOk || lastOk;
+    }
+    const front = new Set(leadBlock);
+    const remaining = [...new Set(leadBlock)].concat(prose.filter(l => !asked.has(l) && !front.has(l)));
+    // Fragments ("## Meeting notes", "Node.js v20.11.0", a stray "+ Get-Item C:\x" that
+    // escaped the machine rules) go to the back.
+    const isSentence = (l) => wordsIn(l) >= POINTER_WORDS || CJK.test(l);
+    const sentences = remaining.filter(isSentence);
+    const fragments = remaining.filter(l => !isSentence(l));
+    // 3. One block, or neither end can lead: among the sentences, the shorter end leads.
+    if (!decided && sentences.length >= 2 && sentences[sentences.length - 1].length < sentences[0].length) {
+        sentences.unshift(sentences.pop());
+    }
+    const rest = [...sentences, ...fragments];
+    // Error lines get a reserved share, so long prose cannot crowd them out.
+    const each = Math.floor((budget * SALIENT_SHARE) / Math.max(1, salient.length)) - 1;
+    const errors = each >= 20 ? salient.map(e => head(e, each)) : [];
+    const reserve = errors.length ? errors.join('\n').length + 1 : 0;
+    const body = headAndTail([...lead, ...questions, ...rest].join('\n'), budget - reserve);
+    return [body, ...errors].join('\n');
+}
+//# sourceMappingURL=prime-query.js.map

package/dist/hooks/prime-query.js.map

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

package/dist/hooks/prime.d.ts

@@ -36,13 +36,21 @@ export interface PrimeCandidate {
         concept: string;
         content: string;
         memoryClass?: string;
+        validFrom?: string | null;
         validTo?: string | null;
+        supersededBy?: string | null;
         /** Used for the age label; Date from the store, string over HTTP. */
         createdAt?: Date | string | null;
     };
     score: number;
     summary?: string;
     confidence?: number;
+    /** Other results in the same recall that look like another version of this fact. */
+    conflictsWith?: Array<{
+        id: string;
+        newer: boolean;
+        slot: string;
+    }>;
 }
 export interface PrimeOptions {
     /** Hard ceiling on injected tokens. */

package/dist/hooks/prime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../src/hooks/prime.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QACnE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,qEAAqE;QACrE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CAC/D;AAED,eAAO,MAAM,cAAc;;IAEzB;;;;;;;;OAQG;;;CAGK,CAAC;AAiBX;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,cAAc,EAAE,EAC5B,IAAI,GAAE,YAAiB,GACtB,WAAW,CA6Cb"}
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../src/hooks/prime.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAMH,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QACnE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,qEAAqE;QACrE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CAC/D;AAED,eAAO,MAAM,cAAc;;IAEzB;;;;;;;;OAQG;;;CAGK,CAAC;AAkCX;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,cAAc,EAAE,EAC5B,IAAI,GAAE,YAAiB,GACtB,WAAW,CA6Cb"}

package/dist/hooks/prime.js

@@ -32,6 +32,8 @@
  *    thrown error. A hook that errors on every prompt is worse than no hook.
  */
 import { packRecallByBudget, estimateTokens } from '../core/token-budget.js';
+import { isFaded } from '../core/format-recall.js';
+import { validityState } from '../core/validity.js';
 export const PRIME_DEFAULTS = {
     maxTokens: 600,
     /**
@@ -51,14 +53,31 @@ export const PRIME_DEFAULTS = {
  *  report. The id is retained so the agent can act on it (feedback, supersede). */
 function formatPrimeLine(c, now = Date.now()) {
     const body = c.summary ?? c.engram.content;
-    const validity = c.engram.validTo ? ` [valid until ${c.engram.validTo}]` : '';
+    // Same validity decision as ranking and the MCP format (core/validity.ts).
+    const vstate = validityState(c.engram, now);
+    const validity = vstate === 'expired'
+        ? ` ⚠ EXPIRED ${c.engram.validTo}`
+        : vstate === 'not-yet-valid'
+            ? ` [not yet valid — from ${c.engram.validFrom}]`
+            : c.engram.validTo ? ` [valid until ${c.engram.validTo}]` : '';
+    // The MCP format has carried this since 0.12.x; the prime line dropped it, so
+    // pushed context could present a superseded memory as current with no sign.
+    const superseded = c.engram.supersededBy ? ` · superseded by ${c.engram.supersededBy}` : '';
+    // Terse form of the MCP conflict mark: enough to send the agent to the source.
+    const conflicts = (c.conflictsWith ?? []).length > 0
+        ? ` · ${(c.conflictsWith ?? []).some(x => x.newer) ? 'newer than' : 'older than'} ${(c.conflictsWith ?? []).map(x => x.id).join(', ')} — confirm before stating a value`
+        : '';
     // Class + age make the volatility rubric mechanical: a 90-day-old working
     // memory reads differently from a 2-day-old canonical one, and the agent
     // should not have to look either up before deciding how much to trust it.
     const cls = c.engram.memoryClass ?? 'working';
     const created = c.engram.createdAt ? new Date(c.engram.createdAt).getTime() : NaN;
     const age = Number.isFinite(created) ? ` · ${Math.max(0, Math.round((now - created) / 86_400_000))}d` : '';
-    return `- [${cls}${age}] ${c.engram.concept}${validity} [${c.engram.id}]: ${body}`;
+    // Same reason as the MCP format: a trimmed body that still reads as an answer
+    // is the one failure mode the agent cannot detect for itself. Terser here
+    // because this is unrequested context.
+    const faded = isFaded(c.engram.content) ? ' · faded' : '';
+    return `- [${cls}${age}${faded}${superseded}${conflicts}] ${c.engram.concept}${validity} [${c.engram.id}]: ${body}`;
 }
 /**
  * Build the injection for a prompt. Pure — no I/O — so it is unit-testable

package/dist/hooks/prime.js.map

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

package/dist/hooks/sidecar.d.ts

@@ -53,11 +53,18 @@ export interface SidecarDeps {
             content: string;
             createdAt?: string;
             memoryClass?: string;
+            validFrom?: string | null;
             validTo?: string | null;
+            supersededBy?: string | null;
         };
         score: number;
         summary?: string;
         confidence?: number;
+        conflictsWith?: Array<{
+            id: string;
+            newer: boolean;
+            slot: string;
+        }>;
     }>>;
 }
 export interface SidecarHandle {

package/dist/hooks/sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/hooks/sidecar.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;KAC3C,KAAK,OAAO,CAAC,KAAK,CAAC;QAClB,MAAM,EAAE;YACN,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SACnE,CAAC;QACF,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC,CAAC;CACL;AA0GD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,wFAAwF;IACxF,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CA4P7D"}
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/hooks/sidecar.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMvE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;KAC3C,KAAK,OAAO,CAAC,KAAK,CAAC;QAClB,MAAM,EAAE;YACN,EAAE,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SAClF,CAAC;QACF,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACrE,CAAC,CAAC,CAAC;CACL;AA0GD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,wFAAwF;IACxF,SAAS,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAmQ7D"}

package/dist/hooks/sidecar.js

@@ -19,6 +19,7 @@ import { createServer } from 'node:http';
 import { readFileSync, existsSync } from 'node:fs';
 import { log, getLogPath } from '../core/logger.js';
 import { buildPrimeInjection } from './prime.js';
+import { shapePrimeQuery } from './prime-query.js';
 /**
  * Parse the Claude Code transcript to extract context for auto-checkpointing.
  * Reads the JSONL transcript file and extracts recent tool calls, files, and user messages.
@@ -210,8 +211,15 @@ export function startSidecar(deps) {
                     json(res, 200, { inject: '', kept: 0, total: 0, tokens: 0, reason: 'no-prompt' });
                     return;
                 }
+                // Recall against the prompt's question, not its paste (prime-query.ts).
+                const query = shapePrimeQuery(context);
+                if (!query.trim()) {
+                    // Nothing but envelope (ids, fences, trailers): no question to recall for.
+                    json(res, 200, { inject: '', kept: 0, total: 0, tokens: 0, reason: 'no-prompt' });
+                    return;
+                }
                 const candidates = await deps.activate({
-                    context,
+                    context: query,
                     limit: 8,
                     granularity: 'compact', // priming is a brief note, not a report
                 });
@@ -220,7 +228,7 @@ export function startSidecar(deps) {
                     minConfidence: body.minConfidence,
                     minScore: body.minScore,
                 });
-                log(agentId, 'hook:prime', `"${context.slice(0, 60)}" → ${primed.kept}/${primed.total} injected, ~${primed.tokens} tok${primed.reason ? ` (${primed.reason})` : ''}`);
+                log(agentId, 'hook:prime', `"${query.slice(0, 60)}"${query === context ? '' : ` (shaped ${context.length}→${query.length} chars)`} → ${primed.kept}/${primed.total} injected, ~${primed.tokens} tok${primed.reason ? ` (${primed.reason})` : ''}`);
                 json(res, 200, { ...primed });
             }
             catch (err) {