@cstart/coldstart 2.2.8 → 2.2.10

package/dist/kb/view.d.ts

@@ -30,7 +30,10 @@ export declare function buildViewData(root: string, generated: string): {
         backlinks: string[];
     }[];
 };
-/** Bake data into the template. `</` is neutralized so note text can't break the script tag. */
+/** Bake data into the template. `</` is neutralized so note text can't break the
+ *  script tag; the tab title is scoped to the repo already carried in the data
+ *  (`summary.repo`, = basename(root)) so every notebook's view is named for its
+ *  own repo rather than a hardcoded placeholder. */
 export declare function renderViewHtml(template: string, data: unknown): string;
 export interface ViewOptions {
     open?: boolean;

package/dist/kb/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/kb/view.ts"],"names":[],"mappings":"AAkBA,KAAK,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AA4CjE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;mBA3BvC,UAAU;;;;;;mBAsBX,MAAM,EAAE;;EA2B5B;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAGtE;AAyBD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;0EAQ0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAYhF"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/kb/view.ts"],"names":[],"mappings":"AAkBA,KAAK,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AA4CjE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;mBA3BvC,UAAU;;;;;;mBAsBX,MAAM,EAAE;;EA2B5B;AAOD;;;oDAGoD;AACpD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAStE;AAyBD,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;0EAQ0E;AAC1E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAYhF"}

package/dist/kb/view.js

@@ -77,10 +77,23 @@ export function buildViewData(root, generated) {
     }
     return { summary: { total: notes.length, byType, byFreshness, repo: basename(root), generated }, notes };
 }
-/** Bake data into the template. `</` is neutralized so note text can't break the script tag. */
+/** Escape the three chars that matter inside an HTML text node (here, <title>). */
+function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** Bake data into the template. `</` is neutralized so note text can't break the
+ *  script tag; the tab title is scoped to the repo already carried in the data
+ *  (`summary.repo`, = basename(root)) so every notebook's view is named for its
+ *  own repo rather than a hardcoded placeholder. */
 export function renderViewHtml(template, data) {
     const json = JSON.stringify(data).replace(/<\//g, '<\\/');
-    return template.replace('__DATA_JSON__', () => json);
+    const repo = data?.summary?.repo;
+    const title = typeof repo === 'string' && repo.trim()
+        ? `Coldstart Notebook — ${escapeHtml(repo)}`
+        : 'Coldstart Notebook';
+    return template
+        .replace('__TITLE__', () => title)
+        .replace('__DATA_JSON__', () => json);
 }
 /** Best-effort open in the OS default browser. Never throws. */
 function openInBrowser(file) {

package/dist/kb/view.js.map

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

package/hooks/capture-payload.mjs

@@ -87,7 +87,7 @@ for it — your findings, not the notebook decision.`
     body = body.includes("{{WORKLIST}}")
       ? body.replaceAll("{{WORKLIST}}", worklist)
       : `${body.trimEnd()}\n\nWORKLIST — files you actually read this session, most-worked first \
-(the complete scope; never write a note for an unlisted file):\n\n${worklist}`;
+(your scope; if you edited or deep-read a file that isn't listed, you can note it too):\n\n${worklist}`;
     return `**Notebook capture point.** ${opening}\n\n${body.trimEnd()}${tail}`;
   }
 
@@ -102,8 +102,9 @@ branch, reviewing a PR, or reading vendored/generated code, that knowledge is ab
 or the future — write nothing and say so.
 2. If nothing about the current code is worth recording, no note is the right answer. If a \
 future agent would not act differently for knowing it, don't store it.
-3. The worklist below is the complete scope. Unlisted files are out — ignored \
-(.coldstartignore) or already captured. Never write a note for an unlisted file.
+3. The worklist below is your scope, most-worked first. Unlisted files are out — ignored \
+(.coldstartignore) or already captured. If you edited or deep-read a file this session that \
+isn't listed, you can write a note for it too.
 
 WORKLIST — files you actually read this session, most-worked first:
 
@@ -119,7 +120,13 @@ naming convention) is exactly what to record — ONLY if you actually observed i
 session's work. Never guess at usage or go searching for it now. Files flagged "no consumers \
 in import graph" are where an observed usage fact matters most.
 7. Fixed a bug? The cause goes in the culpable file's note; the SYMPTOM words go in \
-"aliases" — symptoms are what a future agent will search.
+"aliases" — symptoms are what a future agent will search. Aliases are SEARCH KEYS, not \
+sentences: each one 2-5 words, no filler ("after", "already", "another", "still"), because \
+every word in an alias is an independent match chance and a long alias makes the note fire \
+on prompts it has nothing to do with. Cover the vocabulary THIS FILE owns — the concept \
+nouns someone would type when they want this file, including the ones already in its name \
+and symbols. A note about alias handling that never says "aliases" cannot be found by \
+someone asking about aliases. 6-10 aliases is plenty; more surface area is not more recall.
 8. Read a note this session that proved wrong? Correct or retract it now — you are the warm \
 agent; there is no "next".
 9. Firsthand only: nothing from a subagent's report you didn't verify yourself.

package/hooks/codex-kb-recall.mjs

@@ -27,6 +27,11 @@ import { existsSync, appendFileSync, readFileSync, writeFileSync } from "node:fs
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
+// Strip host telemetry wrappers before the query is built — see recall-query.mjs.
+import { recallQuery } from "./recall-query.mjs";
+// Per-session dedup shared with the other recall hooks — see recall-seen.mjs.
+// Hosts with no transcript path never reset; dedup still holds for the session.
+import { readSeen, writeSeen, idsInPage, seenArgs } from "./recall-seen.mjs";
 
 // hooks/ sits beside dist/ in both the repo and the published package.
 const CLI = fileURLToPath(new URL("../dist/index.js", import.meta.url));
@@ -71,15 +76,23 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     if (!root) process.exit(0);
     setLogRoot(root);
 
+    const sid = String(input.session_id || "").replace(/[^\w-]/g, "");
+
     // No notebook → no tax, not even a child process.
     if (!existsSync(join(root, ".coldstart", "notebook", ".raw"))) process.exit(0);
 
-    const prompt = String(input.prompt || "").slice(0, MAX_QUERY_CHARS).trim();
+    const prompt = recallQuery(input.prompt, MAX_QUERY_CHARS);
     if (!prompt) process.exit(0);
 
+    // Ephemeral Codex runs expose no rollout path; readSeen then never resets,
+    // which is the safe direction — dedup simply holds for the whole session.
+    const tPath = String(input.transcript_path || "");
+    const seen = readSeen(sid, tPath, log);
+
     let page = "";
     try {
-      page = execFileSync("node", [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, prompt], {
+      const args = [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, ...seenArgs(seen.ids)];
+      page = execFileSync("node", [...args, prompt], {
         encoding: "utf8",
         timeout: SEARCH_TIMEOUT_MS,
         stdio: ["ignore", "pipe", "ignore"],
@@ -94,6 +107,10 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
       process.exit(0);
     }
 
+    // Record what this page hands over before the size guards can trim it — a
+    // note the agent was shown is seen, whichever way it ends up rendered.
+    writeSeen(sid, [...seen.ids, ...idsInPage(page)], tPath);
+
     // Pointer page (rulings 2026-07-06/08): titles + gists + an OPENABLE note
     // path, never a full body — a wrong pointer costs a glance, a wrong
     // implant poisons the whole session. Depth is one Read of the → path away
@@ -130,7 +147,6 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     // grep-spiral unguarded otherwise. Path/shape must match the handler's state
     // file: literal /tmp + main-agent key = session_id.
     try {
-      const sid = String(input.session_id || "");
       if (sid && /^[\w-]+$/.test(sid)) {
         const sf = `/tmp/find_nudge_${sid}.json`;
         let st = {};

package/hooks/cursor-kb-recall.mjs

@@ -29,6 +29,11 @@ import { cursorRoot } from "./cursor-input.mjs";
 // stop wrote its worklist payload to a pending file instead of blocking; it
 // rides this same next-prompt channel — capture first, then the user's request.
 import { takePendingCapture } from "./elicit-core.mjs";
+// Strip host telemetry wrappers before the query is built — see recall-query.mjs.
+import { recallQuery } from "./recall-query.mjs";
+// Per-session dedup shared with the other recall hooks — see recall-seen.mjs.
+// Hosts with no transcript path never reset; dedup still holds for the session.
+import { readSeen, writeSeen, idsInPage, seenArgs } from "./recall-seen.mjs";
 
 // hooks/ sits beside dist/ in both the repo and the published package.
 const CLI = fileURLToPath(new URL("../dist/index.js", import.meta.url));
@@ -80,13 +85,17 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     // (the first capture is what creates it).
     const pending = takePendingCapture(sid);
 
-    const prompt = String(input.prompt || "").slice(0, MAX_QUERY_CHARS).trim();
+    const prompt = recallQuery(input.prompt, MAX_QUERY_CHARS);
+
+    const tPath = String(input.transcript_path || "");
+    const seen = readSeen(sid, tPath, log);
 
     let page = "";
     // No notebook / no prompt → no recall search, not even a child process.
     if (prompt && existsSync(join(root, ".coldstart", "notebook", ".raw"))) {
+      const args = [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, ...seenArgs(seen.ids)];
       try {
-        page = execFileSync("node", [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, prompt], {
+        page = execFileSync("node", [...args, prompt], {
           encoding: "utf8",
           timeout: SEARCH_TIMEOUT_MS,
           stdio: ["ignore", "pipe", "ignore"],
@@ -108,6 +117,10 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     // Pointer page — titles + gists + an OPENABLE note path, never a full body.
     // (Same framing as codex-kb-recall.mjs; notes are REFERENCE DATA, not
     // instructions.)
+    // Record what this page hands over before the size guards can trim it — a
+    // note the agent was shown is seen, whichever way it ends up rendered.
+    if (page) writeSeen(sid, [...seen.ids, ...idsInPage(page)], tPath);
+
     let block = "";
     if (page) block =
       `The repo's notebook (notes written by past agents after real tasks here) has entries ` +

package/hooks/elicit-core.mjs

@@ -16,7 +16,10 @@ import { tmpdir } from "node:os";
 import { execFileSync } from "node:child_process";
 import { existsSync, readFileSync, writeFileSync, unlinkSync, appendFileSync, mkdirSync } from "node:fs";
 
-export const MAX_WORKLIST = 30;
+import { MAX_CAPTURE_FILES } from "./trigger.mjs";
+// One source of truth: the display cap equals what a fire claims, so the prompt
+// never shows fewer (or more) files than the fire marks captured.
+export const MAX_WORKLIST = MAX_CAPTURE_FILES;
 
 const noop = () => {};
 

package/hooks/kb-elicit.mjs

@@ -38,7 +38,7 @@ import { initialState, step } from "./trigger.mjs";
 import { loadIgnore } from "./ignore.mjs";
 import { buildCapturePayload } from "./capture-payload.mjs";
 import {
-  worklistEntries, freshNotedSet, gitHead, logCaptureEvent, writePendingCapture,
+  worklistEntries, freshNotedSet, gitHead, logCaptureEvent, writePendingCapture, MAX_WORKLIST,
 } from "./elicit-core.mjs";
 
 // hooks/ sits beside dist/ in both the repo and the published package.
@@ -180,7 +180,23 @@ if (process.argv.includes("--manual")) {
       process.exit(0);
     }
     const { sid, state, path: markerPath } = found;
-    const files = Object.keys(state.files).filter((rel) => !state.files[rel].captured);
+    // A manual /capture-notes is an EXPLICIT request to write up THIS session's
+    // work, so its scope is everything worked on — not merely what an automatic
+    // fire has yet to offer. Files EDITED this session are the highest-value
+    // notes (the fix, a brand-new helper), and an earlier automatic fire may
+    // have already marked them `captured` — a flag that means "offered once",
+    // never "a good note exists". Excluding them left the single most valuable
+    // note unwritten and a now-stale note unfixed (the Bug-1 report). So:
+    // include every edited file regardless of the flag, and drop only READ-ONLY
+    // files that were already offered (re-listing those on demand is just
+    // noise). Rank most-worked first (edits → retouches → reads) so new/edited
+    // files lead; the per-file annotations flag when a fresh note needs nothing.
+    const files = Object.entries(state.files)
+      .filter(([, f]) => (f.reads + f.edits + f.gs) > 0 && (f.edits > 0 || !f.captured))
+      .sort((a, b) => (b[1].edits - a[1].edits)
+        || ((b[1].retouches || 0) - (a[1].retouches || 0))
+        || (b[1].reads - a[1].reads))
+      .map(([rel]) => rel);
     if (!files.length) {
       process.stdout.write("Everything worked on so far is already captured — nothing new to write right now.\n");
       log(`MANUAL nothing-new session=${sid}`);
@@ -188,14 +204,16 @@ if (process.argv.includes("--manual")) {
     }
     const entries = worklistEntries(CLI, root, files, state.files, log);
     const payload = buildCapturePayload({ root, cli: CLI, sid, entries, envelope: "manual" });
-    // Mark ONLY the listed files captured. Re-read first: a Stop hook may have
-    // written the marker since we loaded it, and we must not clobber its
-    // counters. Best-effort — a failure here costs a duplicate ask, never the
-    // payload the user asked for.
+    // Mark ONLY the files actually LISTED (the worklist caps its display to
+    // MAX_WORKLIST) captured — any overflow stays uncaptured so it rolls into
+    // the next capture rather than being marked done but never shown. Re-read
+    // first: a Stop hook may have written the marker since we loaded it, and we
+    // must not clobber its counters. Best-effort — a failure here costs a
+    // duplicate ask, never the payload the user asked for.
     try {
       const live = JSON.parse(readFileSync(markerPath, "utf8"));
       if (live && live.files) {
-        for (const rel of files) if (live.files[rel]) live.files[rel].captured = true;
+        for (const rel of files.slice(0, MAX_WORKLIST)) if (live.files[rel]) live.files[rel].captured = true;
         writeFileSync(markerPath, JSON.stringify(live));
       }
     } catch (e) { log(`MANUAL mark-captured skipped ${e}`); }

package/hooks/kb-recall.mjs

@@ -34,6 +34,13 @@ import { fileURLToPath } from "node:url";
 // the user's request. Consumed (deleted) on delivery; stale pendings (>24h,
 // e.g. a session resumed days later) are dropped.
 import { takePendingCapture } from "./elicit-core.mjs";
+// The host wraps the user's words in editor/subagent telemetry; that text is
+// file-rich and hijacks the path-name override in kb search. Strip it BEFORE
+// truncating, or a long <ide_selection> eats the whole query budget.
+import { recallQuery } from "./recall-query.mjs";
+// Per-session dedup: don't re-show a note this session already got, and forget
+// what was shown once the transcript shrinks (a compact). See recall-seen.mjs.
+import { readSeen, writeSeen, idsInPage, seenArgs } from "./recall-seen.mjs";
 
 // hooks/ sits beside dist/ in both the repo and the published package.
 const CLI = fileURLToPath(new URL("../dist/index.js", import.meta.url));
@@ -41,6 +48,7 @@ const CLI = fileURLToPath(new URL("../dist/index.js", import.meta.url));
 const MAX_QUERY_CHARS = 2000; // pasted-code prompts: the head carries the ask
 const SEARCH_TIMEOUT_MS = 4000;
 
+
 let LOG_FILE = join(tmpdir(), "coldstart-kb-hook.log");
 function setLogRoot(root) { if (root) LOG_FILE = join(root, ".coldstart", "kb-hook.log"); }
 function log(msg) {
@@ -85,13 +93,17 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     // (the first capture is what creates it).
     const pending = takePendingCapture(sid);
 
-    const prompt = String(input.prompt || "").slice(0, MAX_QUERY_CHARS).trim();
+    const prompt = recallQuery(input.prompt, MAX_QUERY_CHARS);
+
+    const tPath = String(input.transcript_path || "");
+    const seen = readSeen(sid, tPath, log);
 
     let page = "";
     // No notebook / no prompt → no recall search, not even a child process.
     if (prompt && existsSync(join(root, ".coldstart", "notebook", ".raw"))) {
+      const args = [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, ...seenArgs(seen.ids)];
       try {
-        page = execFileSync("node", [CLI, "kb", "search", "--hook", "--max", "3", "--root", root, prompt], {
+        page = execFileSync("node", [...args, prompt], {
           encoding: "utf8",
           timeout: SEARCH_TIMEOUT_MS,
           stdio: ["ignore", "pipe", "ignore"],
@@ -117,6 +129,10 @@ process.on("unhandledRejection", (e) => { log(`unhandled ${e?.stack || e}`); pro
     // agents never used it). Trust framing: [fresh] content is reliable
     // as-is; the caution that remains is about COMPLETENESS (a note names a
     // finding, not necessarily your whole file set), not about content.
+    // Record what this page hands over BEFORE the size guards below can trim
+    // it — a note the agent was shown is seen, whichever way it was rendered.
+    if (page) writeSeen(sid, [...seen.ids, ...idsInPage(page)], tPath);
+
     let block = "";
     if (page) block =
       `The repo's notebook (notes written by past agents after real tasks here) has entries ` +

package/hooks/recall-query.mjs

@@ -0,0 +1,83 @@
+/**
+ * recall-query.mjs — turn a raw UserPromptSubmit payload into a recall QUERY.
+ *
+ * The hosts do not hand us the user's words. They hand us the user's words
+ * WRAPPED IN HARNESS TELEMETRY: the file that happens to be open in the editor,
+ * the current selection, a finished subagent's summary, the expansion of a
+ * slash command. That text is file- and symbol-rich, so `kb search --hook`
+ * treats it as if the user had named those files — most damagingly through the
+ * path-name override in src/kb/search.ts, which boosts a note past every
+ * eligibility gate when the query string contains its anchor path. A stale-open
+ * editor tab then hijacks recall for turns at a time.
+ *
+ * So: strip the wrappers (tag AND content) before the query is built, and
+ * before truncation — a 1.5KB <ide_selection> ahead of a short question would
+ * otherwise eat the whole MAX_QUERY_CHARS budget and leave the real ask cut off.
+ *
+ * Only a NAMED set of tags is stripped. Anything else — including XML or HTML
+ * the user pasted deliberately — is left alone; over-stripping would silently
+ * drop real questions, which is the failure this is meant to prevent.
+ *
+ * Fail-open: on any error the raw text is returned unchanged.
+ */
+
+/** Harness-emitted wrappers, union across Claude Code / Cursor / Codex. A tag
+ *  a given host never emits simply never matches. */
+export const HARNESS_TAGS = [
+  // Claude Code
+  "system-reminder",
+  "ide_opened_file",
+  "ide_selection",
+  "ide_diagnostics",
+  "task-notification",
+  "local-command-caveat",
+  "local-command-stdout",
+  "local-command-stderr",
+  "command-name",
+  "command-message",
+  "command-args",
+  "user-prompt-submit-hook",
+  // Cursor
+  "browser_instruction",
+  // Codex
+  "environment_context",
+  "user_instructions",
+];
+
+const NAMES = HARNESS_TAGS.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+// Well-formed pair, content included. Non-greedy, /s so it spans newlines.
+const PAIRED = new RegExp(`<(${NAMES})(?:\\s[^>]*)?>[\\s\\S]*?<\\/\\1\\s*>`, "gi");
+// Leftovers: self-closing, or a lone open/close tag from a truncated payload.
+const LONE = new RegExp(`<\\/?(?:${NAMES})(?:\\s[^>]*)?\\/?>`, "gi");
+
+/**
+ * Strip harness wrappers from a raw prompt.
+ * @param {string} raw
+ * @returns {string} the user's own text; "" when nothing but telemetry remains.
+ */
+export function stripHarnessWrappers(raw) {
+  try {
+    let s = String(raw ?? "");
+    if (!s) return "";
+    // Nested wrappers (a system-reminder inside a task-notification) need more
+    // than one pass; bounded so a pathological payload cannot spin.
+    for (let i = 0; i < 4; i++) {
+      const next = s.replace(PAIRED, " ");
+      if (next === s) break;
+      s = next;
+    }
+    return s.replace(LONE, " ").replace(/[ \t]+/g, " ").trim();
+  } catch {
+    return String(raw ?? "");
+  }
+}
+
+/**
+ * The full prompt → query pipeline: strip, THEN truncate.
+ * @param {string} raw raw `input.prompt`
+ * @param {number} maxChars
+ * @returns {string} "" when there is nothing left to search for.
+ */
+export function recallQuery(raw, maxChars) {
+  return stripHarnessWrappers(raw).slice(0, maxChars).trim();
+}

package/hooks/recall-seen.mjs

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * recall-seen.mjs — per-session dedup state for the recall hooks.
+ *
+ * 61% of notebook injections re-showed a note the SAME session had already
+ * been given (worst case 12x). That is pure tax: the title and gist are
+ * already in the agent's context, so the repeat buys nothing and pushes the
+ * page toward the host's size cap. Each recall hook remembers the ids it has
+ * shown and passes them to `kb search --seen`, which drops them from the page
+ * it would otherwise have rendered (no backfill; all-seen => inject nothing).
+ *
+ * Reset on COMPACTION, not on a clock. After a compact the session id is
+ * unchanged but the agent's context is gone, so a previously-shown note is
+ * genuinely absent again and SHOULD be re-injectable. A shrinking transcript
+ * file is the observable signal — the same one kb-elicit uses for its own
+ * resume handling. Hosts that expose no transcript path (ephemeral Codex runs)
+ * simply never reset: dedup still works, it just holds for the whole session.
+ *
+ * Shared by kb-recall.mjs (Claude), cursor-kb-recall.mjs and
+ * codex-kb-recall.mjs so the three cannot drift. Every function is fail-open:
+ * any error leaves dedup OFF rather than blocking recall.
+ */
+
+import { readFileSync, writeFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+
+const SEEN_TTL_MS = 24 * 60 * 60 * 1000;
+/** os.tmpdir(), NOT literal /tmp — that path is reserved for the find_nudge
+ *  state file, which the nudge handler reads back by an agreed literal path. */
+const seenPath = (sid) => join(tmpdir(), `coldstart-recall-seen-${sid}.json`);
+
+function transcriptSize(p) {
+  try { return p ? statSync(p).size : 0; } catch { return 0; }
+}
+
+/**
+ * Ids already shown this session. `log` is optional (each host has its own).
+ * Returns { ids, size } — pass both back to writeSeen.
+ */
+export function readSeen(sid, transcriptPath, log) {
+  if (!sid) return { ids: [], size: 0 };
+  try {
+    const st = JSON.parse(readFileSync(seenPath(sid), "utf8"));
+    if (!st || !Array.isArray(st.ids)) return { ids: [], size: 0 };
+    if (Date.now() - (st.ts || 0) > SEEN_TTL_MS) return { ids: [], size: 0 };
+    const now = transcriptSize(transcriptPath);
+    if (now && st.size && now < st.size) {
+      log?.(`compaction detected (${st.size} -> ${now} bytes): clearing ${st.ids.length} seen ids`);
+      return { ids: [], size: now };
+    }
+    return { ids: st.ids, size: st.size || 0 };
+  } catch { return { ids: [], size: 0 }; }
+}
+
+export function writeSeen(sid, ids, transcriptPath) {
+  if (!sid) return;
+  try {
+    writeFileSync(seenPath(sid), JSON.stringify({
+      ids: [...new Set(ids)].slice(-200), // bounded; a session never shows this many
+      size: transcriptSize(transcriptPath),
+      ts: Date.now(),
+    }));
+  } catch { /* fail-open: dedup is an optimisation, never a gate */ }
+}
+
+/** Note ids on a rendered pointer page — each hit carries `→ open: …/<id>.md`.
+ *  Read back off the rendered text so the hooks need no structured output. */
+export function idsInPage(page) {
+  return [...page.matchAll(/→ open:\s*\S*?notes\/([\w.-]+)\.md/g)].map((m) => m[1]);
+}
+
+/** The `--seen a,b,c` argv fragment, or [] when there is nothing to exclude. */
+export function seenArgs(ids) {
+  return ids.length ? ["--seen", ids.join(",")] : [];
+}

package/hooks/trigger.mjs

@@ -43,6 +43,12 @@
 
 export const T_ARM = 10;
 export const T_CAP = 20;
+/** Files a single fire CLAIMS (marks captured) and lists — the same cap the
+ *  worklist prompt renders (elicit-core slices its display to it). Files beyond
+ *  it stay UNCAPTURED so they roll into the NEXT fire's worklist, rather than
+ *  being marked done but never shown — which silently dropped notes on sessions
+ *  that touched more than this many files (a long autonomous grind). */
+export const MAX_CAPTURE_FILES = 30;
 export const SETTLE_ACTIVE_STOPS = 3;
 export const DESCENT_QUIET = 1;
 /** Uncaptured-file floor for the BLOCKING/backlog paths (head-drift, cap).
@@ -152,11 +158,15 @@ export function step(state, obs) {
 
   let decision = null;
   if (fire) {
-    // worklist = the uncaptured set, most-worked first (edits, then retouches)
-    const files = uncaptured
+    // worklist = the uncaptured set, most-worked first (edits, then retouches),
+    // capped to what one fire claims. Mark ONLY the listed files captured; the
+    // overflow stays uncaptured and rolls into the next fire (which re-fires
+    // soon, since the backlog keeps the score high).
+    const ranked = uncaptured
       .sort((a, b) => (b[1].edits - a[1].edits) || (b[1].retouches - a[1].retouches) || (b[1].reads - a[1].reads))
-      .map(([rel]) => rel);
-    for (const [, f] of uncaptured) f.captured = true;
+      .slice(0, MAX_CAPTURE_FILES);
+    const files = ranked.map(([rel]) => rel);
+    for (const [, f] of ranked) f.captured = true;
     s.armed = false;
     s.activeStops = 0;
     s.stopsSinceFire = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cstart/coldstart",
-  "version": "2.2.8",
+  "version": "2.2.10",
   "mcpName": "io.github.AkashGoenka/coldstart",
   "publishConfig": {
     "access": "public"