nlm-memory 0.20.1 → 0.21.12

package/dist/core/hook/memo.js

@@ -3,26 +3,34 @@
  * conversation holds the set of session ids already surfaced, so each is
  * surfaced at most once per conversation.
  *
- * State dir defaults to ~/.nlm/hook-state/, overridable via
- * NLM_HOOK_STATE_DIR (testability — mirrors query-log.ts).
+ * State dir is tenant-derived (core/tenancy/tenant-state-path.ts): the
+ * default team's memo dir is ~/.nlm/hook-state/, overridable via
+ * NLM_HOOK_STATE_DIR (testability — mirrors query-log.ts); every other
+ * tenant is isolated under ~/.nlm/tenants/<tenantId>/hook-state/ and
+ * ignores the env override (see the path contract note in
+ * tenant-state-path.ts).
  *
  * Every function is defensive: a missing or corrupt file yields an empty
  * memo, and a write failure is swallowed. The hook must never break on memo
  * I/O.
  */
 import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
-import { homedir } from "node:os";
 import { join } from "node:path";
-function stateDir() {
-    return process.env["NLM_HOOK_STATE_DIR"] ?? join(homedir(), ".nlm", "hook-state");
+import { tenantStatePath } from "../tenancy/tenant-state-path.js";
+import { DEFAULT_TEAM_ID } from "../tenancy/default-team.js";
+function stateDir(tenantId) {
+    if (tenantId === DEFAULT_TEAM_ID) {
+        return process.env["NLM_HOOK_STATE_DIR"] ?? tenantStatePath(tenantId, "hook-state");
+    }
+    return tenantStatePath(tenantId, "hook-state");
 }
-function memoPath(conversationId) {
+function memoPath(tenantId, conversationId) {
     const safe = conversationId.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown";
-    return join(stateDir(), `${safe}.json`);
+    return join(stateDir(tenantId), `${safe}.json`);
 }
-export function loadSurfaced(conversationId) {
+export function loadSurfaced(tenantId, conversationId) {
     try {
-        const path = memoPath(conversationId);
+        const path = memoPath(tenantId, conversationId);
         if (!existsSync(path))
             return new Set();
         const parsed = JSON.parse(readFileSync(path, "utf8"));
@@ -34,13 +42,13 @@ export function loadSurfaced(conversationId) {
         return new Set();
     }
 }
-export function recordSurfaced(conversationId, ids) {
+export function recordSurfaced(tenantId, conversationId, ids) {
     try {
-        const merged = loadSurfaced(conversationId);
+        const merged = loadSurfaced(tenantId, conversationId);
         for (const id of ids)
             merged.add(id);
-        mkdirSync(stateDir(), { recursive: true });
-        writeFileSync(memoPath(conversationId), JSON.stringify([...merged]), "utf8");
+        mkdirSync(stateDir(tenantId), { recursive: true });
+        writeFileSync(memoPath(tenantId, conversationId), JSON.stringify([...merged]), "utf8");
     }
     catch {
         // Memo write failure must never break the hook.
@@ -57,9 +65,9 @@ export function recordSurfaced(conversationId, ids) {
  *
  * Defensive: any I/O error yields null so cite_session never breaks.
  */
-export function resolveConversationForSession(sessionId) {
+export function resolveConversationForSession(tenantId, sessionId) {
     try {
-        const dir = stateDir();
+        const dir = stateDir(tenantId);
         if (!existsSync(dir))
             return null;
         let best = null;
@@ -91,9 +99,9 @@ export function resolveConversationForSession(sessionId) {
  * hook so memo files don't accumulate forever. Returns true if a file was
  * removed, false otherwise — callers may want to log the outcome.
  */
-export function clearSurfaced(conversationId) {
+export function clearSurfaced(tenantId, conversationId) {
     try {
-        const path = memoPath(conversationId);
+        const path = memoPath(tenantId, conversationId);
         if (!existsSync(path))
             return false;
         rmSync(path);

package/dist/core/hook/memo.js.map

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

package/dist/core/hook/pointer-block.d.ts

@@ -29,5 +29,12 @@ export interface PointerExemplar {
     readonly repo: string;
     readonly taskContext: string;
 }
+export interface PointerConcept {
+    readonly concept: string;
+    readonly status: string;
+    readonly attemptCount: number;
+    /** Owning enrollment's latest next_step (shared across its concepts). */
+    readonly nextStep: string | null;
+}
 export declare function truncateSummary(s: string, max?: number): string;
-export declare function formatPointerBlock(hits: ReadonlyArray<PointerHit>, facts?: ReadonlyArray<PointerFact>, exemplars?: ReadonlyArray<PointerExemplar>): string;
+export declare function formatPointerBlock(hits: ReadonlyArray<PointerHit>, facts?: ReadonlyArray<PointerFact>, exemplars?: ReadonlyArray<PointerExemplar>, concepts?: ReadonlyArray<PointerConcept>): string;

package/dist/core/hook/pointer-block.js

@@ -32,8 +32,8 @@ export function truncateSummary(s, max = 200) {
     }
     return window + " ...";
 }
-export function formatPointerBlock(hits, facts = [], exemplars = []) {
-    if (hits.length === 0 && facts.length === 0 && exemplars.length === 0)
+export function formatPointerBlock(hits, facts = [], exemplars = [], concepts = []) {
+    if (hits.length === 0 && facts.length === 0 && exemplars.length === 0 && concepts.length === 0)
         return "";
     const out = [];
     if (hits.length > 0) {
@@ -66,9 +66,22 @@ export function formatPointerBlock(hits, facts = [], exemplars = []) {
             out.push(`- [${e.outcome}] ${langPart}${e.repo} - ${truncateSummary(e.taskContext)}`);
         }
     }
+    if (concepts.length > 0) {
+        if (out.length > 0)
+            out.push("");
+        out.push("## Learning state (nlm-memory)");
+        for (const c of concepts) {
+            const n = c.attemptCount === 1 ? "1 attempt" : `${c.attemptCount} attempts`;
+            out.push(`- [${c.status}] ${c.concept} (${n})`);
+        }
+        const nextSteps = [...new Set(concepts.map((c) => c.nextStep).filter((s) => !!s))].slice(0, 2);
+        for (const next of nextSteps) {
+            out.push(`Next: ${truncateSummary(next, 120)}`);
+        }
+    }
     const tools = exemplars.length > 0
-        ? "NLM tools: recall_sessions (search), get_session (full transcript), recall_facts (prior decisions), get_fact_history (how a decision evolved), recall_code (pull the full code for a related exemplar)."
-        : "NLM tools: recall_sessions (search), get_session (full transcript), recall_facts (prior decisions), get_fact_history (how a decision evolved).";
+        ? "NLM tools: recall_sessions (search), get_session (full transcript), recall_facts (prior decisions), get_fact_history (how a decision evolved), recall_code (pull the full code for a related exemplar), learner_summary (concept mastery + next step)."
+        : "NLM tools: recall_sessions (search), get_session (full transcript), recall_facts (prior decisions), get_fact_history (how a decision evolved), learner_summary (concept mastery + next step).";
     out.push(tools);
     return out.join("\n");
 }

package/dist/core/hook/pointer-block.js.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-block.js","sourceRoot":"","sources":["../../../src/core/hook/pointer-block.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pointer-block.js","sourceRoot":"","sources":["../../../src/core/hook/pointer-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+BH,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,GAAG,GAAG,GAAG;IAClD,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9E,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACnE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACtB,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAA+B,EAC/B,QAAoC,EAAE,EACtC,YAA4C,EAAE,EAC9C,WAA0C,EAAE;IAE5C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1G,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,KAAK,QAAQ,OAAO,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnF,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,KAAK,QAAQ,GAAG,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,kBAAkB,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,KAAK,QAAQ,GAAG,CAAC,CAAC,IAAI,MAAM,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,WAAW,CAAC;YAC5E,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5G,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;QAChC,CAAC,CAAC,wPAAwP;QAC1P,CAAC,CAAC,+LAA+L,CAAC;IACpM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/core/hook/resolve-conversation-by-query.d.ts

@@ -1,7 +1,7 @@
 /**
- * Resolve which Claude Code conversation triggered a recall pull, by scanning
- * the N most-recently-modified transcript JSONL files under ~/.claude/projects
- * for the exact query string.
+ * Resolve which conversation triggered a recall pull, by scanning the N
+ * most-recently-modified transcript JSONL files across the local runtimes'
+ * transcript stores for the exact query string.
  *
  * When an agent calls a recall tool, the runtime has already written the
  * tool_use block (containing the query string) to its transcript before the
@@ -9,12 +9,13 @@
  * deterministic, cheap join between a pull log entry and its source
  * conversation, without requiring the agent to pass conversation_id explicitly.
  *
- * Non-Claude-Code runtimes do not write to ~/.claude/projects, so they
- * resolve to null and remain unattributed.
+ * Claude Code conversations resolve to their bare transcript id; other
+ * runtimes resolve to `<runtime>:<id>` so their ids can't collide.
  *
  * Fail-open: any I/O error returns null so the recall path never breaks.
  */
 export interface ResolveByQueryOpts {
+    /** Scan only this directory, as Claude Code transcripts. */
     readonly rootDir?: string;
 }
 /**

package/dist/core/hook/resolve-conversation-by-query.js

@@ -1,7 +1,7 @@
 /**
- * Resolve which Claude Code conversation triggered a recall pull, by scanning
- * the N most-recently-modified transcript JSONL files under ~/.claude/projects
- * for the exact query string.
+ * Resolve which conversation triggered a recall pull, by scanning the N
+ * most-recently-modified transcript JSONL files across the local runtimes'
+ * transcript stores for the exact query string.
  *
  * When an agent calls a recall tool, the runtime has already written the
  * tool_use block (containing the query string) to its transcript before the
@@ -9,19 +9,30 @@
  * deterministic, cheap join between a pull log entry and its source
  * conversation, without requiring the agent to pass conversation_id explicitly.
  *
- * Non-Claude-Code runtimes do not write to ~/.claude/projects, so they
- * resolve to null and remain unattributed.
+ * Claude Code conversations resolve to their bare transcript id; other
+ * runtimes resolve to `<runtime>:<id>` so their ids can't collide.
  *
  * Fail-open: any I/O error returns null so the recall path never breaks.
  */
 import { closeSync, fstatSync, openSync, readdirSync, readSync, statSync } from "node:fs";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
 import { homedir } from "node:os";
 const MIN_QUERY_LEN = 12;
 const TAIL_BYTES = 64 * 1024;
 const MAX_CANDIDATES = 5;
-function defaultRootDir() {
-    return process.env["NLM_CLAUDE_PROJECTS_ROOT"] ?? join(homedir(), ".claude", "projects");
+function defaultRoots() {
+    const home = homedir();
+    const dataHome = process.env["XDG_DATA_HOME"] || join(home, ".local", "share");
+    return [
+        {
+            dir: process.env["NLM_CLAUDE_PROJECTS_ROOT"] ?? join(home, ".claude", "projects"),
+            idOf: (_path, stem) => stem,
+        },
+        { dir: join(home, ".codex", "sessions"), idOf: (_path, stem) => `codex:${stem}` },
+        { dir: join(home, ".pi", "agent", "sessions"), idOf: (_path, stem) => `pi:${stem}` },
+        // Muse names every transcript session.jsonl; the session is its directory.
+        { dir: join(dataHome, "muse", "sessions"), idOf: (path) => `muse:${basename(dirname(path))}` },
+    ];
 }
 function tailRead(path, maxBytes) {
     const fd = openSync(path, "r");
@@ -75,15 +86,16 @@ export function resolveConversationByQuery(query, opts) {
     try {
         if (query.length < MIN_QUERY_LEN)
             return null;
-        const rootDir = opts?.rootDir ?? defaultRootDir();
-        const files = collectJsonlFiles(rootDir)
+        const roots = opts?.rootDir ? [{ dir: opts.rootDir, idOf: (_p, stem) => stem }] : defaultRoots();
+        const files = roots
+            .flatMap((root) => collectJsonlFiles(root.dir).map((f) => ({ ...f, root })))
             .sort((a, b) => b.mtimeMs - a.mtimeMs)
             .slice(0, MAX_CANDIDATES);
-        for (const { path, stem } of files) {
+        for (const { path, stem, root } of files) {
             try {
                 const tail = tailRead(path, TAIL_BYTES);
                 if (tail.includes(query))
-                    return stem;
+                    return root.idOf(path, stem);
             }
             catch {
                 // skip unreadable or vanished files

package/dist/core/hook/resolve-conversation-by-query.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-conversation-by-query.js","sourceRoot":"","sources":["../../../src/core/hook/resolve-conversation-by-query.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-conversation-by-query.js","sourceRoot":"","sources":["../../../src/core/hook/resolve-conversation-by-query.ts"],"names":[],"mappings":"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"}

package/dist/core/ingest/backfill-derivables.d.ts

@@ -0,0 +1,92 @@
+/**
+ * backfill-derivables — one-time retroactive stamp of agent_persona +
+ * parent_session_id (#352 phase 2) onto sessions ingested before the
+ * scheduler started stamping them at classify time (see
+ * src/core/scheduler/scheduler.ts, commit 34968a8).
+ *
+ * Mirrors the live stamp site exactly so backfilled rows match
+ * freshly-ingested ones: claude-code rows go through deriveSubagentMeta
+ * (reversing the `<parent>/agent-<id>` runtimeSessionId + `[subagent <slug>]`
+ * label encoding); every other runtime has no subagent concept, so persona
+ * is just the runtime name and parent is null.
+ *
+ * Idempotent: selection is WHERE agent_persona IS NULL, so a re-run only
+ * touches rows a prior run (or live ingest) hasn't stamped yet.
+ *
+ * Known data quirk (Task 2 review): some subagent transcripts encode a
+ * literal `unknown` parent (`unknown/agent-<id>`), which derives
+ * parentSessionId = "unknown" — a non-joining placeholder, not a real
+ * session id. The backfill still writes it, for consistency with live
+ * stamping, but counts it separately (`unknownParent`) so operators can see
+ * how much of the corpus has an unresolvable parent link.
+ *
+ * Persona is frequently unrecoverable for pre-existing subagent rows: the
+ * live stamp site derives persona from the transient pre-classification
+ * chunk.label (which carries the `[subagent <slug>]` prefix), but the
+ * `label` column this backfill reads is the classifier's generated title —
+ * that prefix is already gone by the time a row lands in `sessions`. In
+ * practice this means most historical subagent rows get parent_session_id
+ * populated but agent_persona stays NULL. Only genuinely new ingests (which
+ * derive from the live chunk before classification overwrites it) get both.
+ * Such rows stay selectable (agent_persona IS NULL) forever, so the run
+ * compares derived values against stored ones and counts a row `updated`
+ * only when the write would change something; a re-run over a fully
+ * backfilled corpus reports updated=0 with the unrecoverable rows under
+ * `skippedNoop`.
+ *
+ * Task 5 addition: `--with-transcript-scan` optionally also re-scans each
+ * candidate's transcript file for primary_model/total_tokens/skill via
+ * scanTranscriptDerivables. Off by default — scanning streams every
+ * candidate's transcript off disk and is far slower than the persona/parent
+ * derivation above, which only touches already-loaded columns. When the
+ * flag is set, candidacy widens beyond WHERE agent_persona IS NULL with an
+ * OR arm keyed on the scan's own columns (claude-code-jsonl rows with a
+ * transcript_path and all three scan columns still NULL) — otherwise a row
+ * whose persona was stamped by an earlier flagless run would never be
+ * scannable, leaving the flag shipped but effectively unwired for exactly
+ * the rows Task 3 already processed. Rows selected only via that arm get a
+ * scan-only write (persona/parent untouched); either way the scan columns
+ * COALESCE-preserve, and a re-run reports updated=0: a stamped scan column
+ * excludes the row from the OR arm on the next pass, and rows that stay
+ * selectable via the persona arm (persona-unrecoverable subagent rows) skip
+ * the re-scan once any scan column is stamped and count as no-op when the
+ * scan cannot change the row (all-null result, or derivables already
+ * stored).
+ */
+import type { Database } from "better-sqlite3";
+export interface BackfillOptions {
+    readonly dryRun?: boolean;
+    /**
+     * Also scan each candidate's transcript file for
+     * primary_model/total_tokens/skill (#352 phase 2, Task 5). Off by
+     * default: slower than the persona/parent derivation (streams every
+     * candidate's transcript off disk).
+     */
+    readonly withTranscriptScan?: boolean;
+}
+export interface BackfillReport {
+    /** All rows in the sessions table, stamped or not. */
+    readonly total: number;
+    /** Rows whose write would change something (or did, when not --dry-run). */
+    readonly updated: number;
+    /**
+     * Rows not selected at all: agent_persona already stamped and (when
+     * withTranscriptScan) not eligible for the scan arm either.
+     */
+    readonly skippedAlreadyStamped: number;
+    /**
+     * Selected rows whose derived values match what's already stored — persona
+     * unrecoverable (NULL derives NULL), parent either already stamped by a
+     * prior run or also underivable, and (when withTranscriptScan) the
+     * transcript scan derived nothing either. Attempted, nothing to write.
+     */
+    readonly skippedNoop: number;
+    /** Of the selected rows, how many derived a real parent link (subagent-shaped runtimeSessionId). */
+    readonly subagentCandidates: number;
+    /** Of the selected rows, how many derived a literal "unknown" parent placeholder. */
+    readonly unknownParent: number;
+    /** Rows whose transcript was scanned and derived at least one non-null
+     *  field. Always 0 when withTranscriptScan is not set. */
+    readonly transcriptScanned: number;
+}
+export declare function backfillDerivables(db: Database, opts?: BackfillOptions): Promise<BackfillReport>;

package/dist/core/ingest/backfill-derivables.js

@@ -0,0 +1,175 @@
+/**
+ * backfill-derivables — one-time retroactive stamp of agent_persona +
+ * parent_session_id (#352 phase 2) onto sessions ingested before the
+ * scheduler started stamping them at classify time (see
+ * src/core/scheduler/scheduler.ts, commit 34968a8).
+ *
+ * Mirrors the live stamp site exactly so backfilled rows match
+ * freshly-ingested ones: claude-code rows go through deriveSubagentMeta
+ * (reversing the `<parent>/agent-<id>` runtimeSessionId + `[subagent <slug>]`
+ * label encoding); every other runtime has no subagent concept, so persona
+ * is just the runtime name and parent is null.
+ *
+ * Idempotent: selection is WHERE agent_persona IS NULL, so a re-run only
+ * touches rows a prior run (or live ingest) hasn't stamped yet.
+ *
+ * Known data quirk (Task 2 review): some subagent transcripts encode a
+ * literal `unknown` parent (`unknown/agent-<id>`), which derives
+ * parentSessionId = "unknown" — a non-joining placeholder, not a real
+ * session id. The backfill still writes it, for consistency with live
+ * stamping, but counts it separately (`unknownParent`) so operators can see
+ * how much of the corpus has an unresolvable parent link.
+ *
+ * Persona is frequently unrecoverable for pre-existing subagent rows: the
+ * live stamp site derives persona from the transient pre-classification
+ * chunk.label (which carries the `[subagent <slug>]` prefix), but the
+ * `label` column this backfill reads is the classifier's generated title —
+ * that prefix is already gone by the time a row lands in `sessions`. In
+ * practice this means most historical subagent rows get parent_session_id
+ * populated but agent_persona stays NULL. Only genuinely new ingests (which
+ * derive from the live chunk before classification overwrites it) get both.
+ * Such rows stay selectable (agent_persona IS NULL) forever, so the run
+ * compares derived values against stored ones and counts a row `updated`
+ * only when the write would change something; a re-run over a fully
+ * backfilled corpus reports updated=0 with the unrecoverable rows under
+ * `skippedNoop`.
+ *
+ * Task 5 addition: `--with-transcript-scan` optionally also re-scans each
+ * candidate's transcript file for primary_model/total_tokens/skill via
+ * scanTranscriptDerivables. Off by default — scanning streams every
+ * candidate's transcript off disk and is far slower than the persona/parent
+ * derivation above, which only touches already-loaded columns. When the
+ * flag is set, candidacy widens beyond WHERE agent_persona IS NULL with an
+ * OR arm keyed on the scan's own columns (claude-code-jsonl rows with a
+ * transcript_path and all three scan columns still NULL) — otherwise a row
+ * whose persona was stamped by an earlier flagless run would never be
+ * scannable, leaving the flag shipped but effectively unwired for exactly
+ * the rows Task 3 already processed. Rows selected only via that arm get a
+ * scan-only write (persona/parent untouched); either way the scan columns
+ * COALESCE-preserve, and a re-run reports updated=0: a stamped scan column
+ * excludes the row from the OR arm on the next pass, and rows that stay
+ * selectable via the persona arm (persona-unrecoverable subagent rows) skip
+ * the re-scan once any scan column is stamped and count as no-op when the
+ * scan cannot change the row (all-null result, or derivables already
+ * stored).
+ */
+import { deriveSubagentMeta } from "../adapters/claude-code.js";
+import { scanTranscriptDerivables } from "./transcript-derivables.js";
+const BATCH_SIZE = 500;
+const NULL_TRANSCRIPT_DERIVABLES = {
+    primaryModel: null,
+    totalTokens: null,
+    skill: null,
+};
+// Widened OR arm for --with-transcript-scan: rows already persona-stamped
+// (e.g. by an earlier flagless Task 3 run) but never transcript-scanned.
+// Scoped to claude-code-jsonl since scanTranscriptDerivables derives nothing
+// for any other kind; requires ALL three scan columns NULL so any stamped
+// scan column excludes the row on the next pass (re-run idempotency).
+const SCAN_CANDIDATE_ARM = " OR (transcript_path IS NOT NULL AND transcript_kind = 'claude-code-jsonl'" +
+    " AND primary_model IS NULL AND total_tokens IS NULL AND skill IS NULL)";
+function selectCandidates(db, withTranscriptScan) {
+    return db
+        .prepare("SELECT id, runtime, runtime_session_id, label, agent_persona, parent_session_id, transcript_path, transcript_kind, primary_model, total_tokens, skill" +
+        " FROM sessions WHERE agent_persona IS NULL" +
+        (withTranscriptScan ? SCAN_CANDIDATE_ARM : ""))
+        .all();
+}
+// The sessions.runtime column stores the adapter's versioned runtime string
+// (e.g. "claude-code/1.0", "hermes/1.0" — see each adapter's runtimeVersion
+// field), but the live stamp site in scheduler.ts branches on the bare
+// adapter name ("claude-code", "hermes", ...). Strip the version suffix so
+// the backfill branches identically to a fresh ingest.
+function bareRuntimeName(runtime) {
+    const slash = runtime.indexOf("/");
+    return slash === -1 ? runtime : runtime.slice(0, slash);
+}
+function deriveMeta(row) {
+    const runtimeName = bareRuntimeName(row.runtime);
+    if (runtimeName === "claude-code") {
+        return deriveSubagentMeta(row.runtime_session_id ?? "", row.label);
+    }
+    return { persona: runtimeName, parentSessionId: null };
+}
+export async function backfillDerivables(db, opts = {}) {
+    const total = db.prepare("SELECT COUNT(*) AS n FROM sessions").get().n;
+    const candidates = selectCandidates(db, Boolean(opts.withTranscriptScan));
+    const skippedAlreadyStamped = total - candidates.length;
+    let subagentCandidates = 0;
+    let unknownParent = 0;
+    let skippedNoop = 0;
+    let transcriptScanned = 0;
+    const toWrite = [];
+    for (const row of candidates) {
+        const meta = row.agent_persona === null ? deriveMeta(row) : null;
+        if (meta) {
+            if (meta.parentSessionId !== null)
+                subagentCandidates++;
+            if (meta.parentSessionId === "unknown")
+                unknownParent++;
+        }
+        // Any non-null stored scan column means a completed prior scan already
+        // stamped every field this transcript can derive (all three co-derive
+        // from the same pass, at ingest and here) - re-scanning would only
+        // re-derive values COALESCE discards. Skipping is what keeps
+        // persona-unrecoverable rows (agent_persona NULL forever, re-selected
+        // every run via the persona arm) from re-streaming their transcript and
+        // churning as "updated" on every pass.
+        const scanAlreadyRan = row.primary_model !== null || row.total_tokens !== null || row.skill !== null;
+        let transcript = NULL_TRANSCRIPT_DERIVABLES;
+        if (opts.withTranscriptScan && row.transcript_path && !scanAlreadyRan) {
+            transcript = await scanTranscriptDerivables(row.transcript_path, row.transcript_kind ?? "");
+            if (transcript.primaryModel !== null || transcript.totalTokens !== null || transcript.skill !== null) {
+                transcriptScanned++;
+            }
+        }
+        // Persona-null rows: the meta write is a no-op exactly when the derived
+        // persona is also NULL and the derived parent matches what a prior run
+        // already stamped (or is equally NULL). Scan-only rows have nothing to
+        // write for meta by definition.
+        const metaIsNoop = meta === null || (meta.persona === null && meta.parentSessionId === row.parent_session_id);
+        // The scan write is COALESCE-guarded, so it changes the row only where a
+        // stored column is NULL and the scan derived a value for it. An all-null
+        // scan (missing/unreadable transcript) or a scan whose derivables are
+        // already stored is a no-op - counting those as "updated" was the run-N
+        // churn bug (updated=N repeating forever with byte-identical results).
+        const transcriptWrites = (row.primary_model === null && transcript.primaryModel !== null) ||
+            (row.total_tokens === null && transcript.totalTokens !== null) ||
+            (row.skill === null && transcript.skill !== null);
+        if (metaIsNoop && !transcriptWrites) {
+            skippedNoop++;
+            continue;
+        }
+        toWrite.push({ id: row.id, meta, transcript });
+    }
+    if (opts.dryRun) {
+        return { total, updated: toWrite.length, skippedAlreadyStamped, skippedNoop, subagentCandidates, unknownParent, transcriptScanned };
+    }
+    const metaAndScanStmt = db.prepare(`UPDATE sessions SET
+       agent_persona = ?, parent_session_id = ?,
+       primary_model = COALESCE(primary_model, ?),
+       total_tokens = COALESCE(total_tokens, ?),
+       skill = COALESCE(skill, ?)
+     WHERE id = ? AND agent_persona IS NULL`);
+    const scanOnlyStmt = db.prepare(`UPDATE sessions SET
+       primary_model = COALESCE(primary_model, ?),
+       total_tokens = COALESCE(total_tokens, ?),
+       skill = COALESCE(skill, ?)
+     WHERE id = ?`);
+    for (let i = 0; i < toWrite.length; i += BATCH_SIZE) {
+        const batch = toWrite.slice(i, i + BATCH_SIZE);
+        const runBatch = db.transaction((rows) => {
+            for (const row of rows) {
+                if (row.meta) {
+                    metaAndScanStmt.run(row.meta.persona, row.meta.parentSessionId, row.transcript.primaryModel, row.transcript.totalTokens, row.transcript.skill, row.id);
+                }
+                else {
+                    scanOnlyStmt.run(row.transcript.primaryModel, row.transcript.totalTokens, row.transcript.skill, row.id);
+                }
+            }
+        });
+        runBatch(batch);
+    }
+    return { total, updated: toWrite.length, skippedAlreadyStamped, skippedNoop, subagentCandidates, unknownParent, transcriptScanned };
+}
+//# sourceMappingURL=backfill-derivables.js.map

package/dist/core/ingest/backfill-derivables.js.map

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

package/dist/core/ingest/ingest-session.d.ts

@@ -44,4 +44,4 @@ export interface IngestResult {
     readonly error?: string;
 }
 export declare function deriveSessionId(runtime: string, startedAt: string, text: string): string;
-export declare function ingestSession(input: IngestInput, deps: IngestDeps): Promise<IngestResult>;
+export declare function ingestSession(input: IngestInput, deps: IngestDeps, tenantId: string): Promise<IngestResult>;

package/dist/core/ingest/ingest-session.js

@@ -8,6 +8,7 @@
  */
 import { createHash } from "node:crypto";
 import { extractFacts } from "../facts/extract-facts.js";
+import { scanTranscriptDerivables } from "../ingest/transcript-derivables.js";
 import { PgSessionStore } from "../storage/pg-session-store.js";
 const BODY_CAP = 200_000;
 const CONFIDENCE_FLOOR = 0.3;
@@ -22,7 +23,7 @@ export function deriveSessionId(runtime, startedAt, text) {
         .slice(0, 16);
     return `webhook_${hash}`;
 }
-export async function ingestSession(input, deps) {
+export async function ingestSession(input, deps, tenantId) {
     const startedAt = input.startedAt ?? new Date().toISOString();
     const id = input.id ?? deriveSessionId(input.runtime, startedAt, input.text);
     const log = deps.log ?? ((m) => console.error(m));
@@ -44,6 +45,14 @@ export async function ingestSession(input, deps) {
             confidence: classification.confidence,
         };
     }
+    // Task #352 phase 2 (Task 5): scan the transcript file (if any) for
+    // primary_model/total_tokens/skill. Webhook pushes carry transcriptKind
+    // "webhook", not "claude-code-jsonl", so this always resolves all-null
+    // today -- wired for parity with the scheduler stamp site and any future
+    // webhook kind that does carry a scannable transcript.
+    const transcriptDerivables = input.transcriptPath
+        ? await scanTranscriptDerivables(input.transcriptPath, "webhook")
+        : { primaryModel: null, totalTokens: null, skill: null };
     const record = {
         id,
         runtime: input.runtime,
@@ -62,6 +71,17 @@ export async function ingestSession(input, deps) {
         entities: classification.entities,
         decisions: classification.decisions,
         openQuestions: classification.open,
+        // Push ingest carries no project directory; the scope backfill command
+        // derives it later from the transcript when evidence exists.
+        scope: null,
+        // Webhook pushes have no adapter chunk to derive subagent lineage from;
+        // stamp the runtime name as persona, matching every non-claude-code
+        // adapter at the scheduler stamp site (#352 phase 2).
+        agentPersona: input.runtime,
+        parentSessionId: null,
+        primaryModel: transcriptDerivables.primaryModel,
+        totalTokens: transcriptDerivables.totalTokens,
+        skill: transcriptDerivables.skill,
         ...(deps.classifierDescriptor !== undefined
             ? { classifier: { ...deps.classifierDescriptor, confidence: classification.confidence } }
             : {}),
@@ -72,10 +92,10 @@ export async function ingestSession(input, deps) {
     // Store + factStore come from the same backend (see buildStack); the cast
     // is sound — TS can't correlate the two union members at one call site.
     if (deps.store instanceof PgSessionStore) {
-        await deps.store.insertSession(record, deps.embedder, null, deps.factStore ? { factStore: deps.factStore, facts } : null);
+        await deps.store.insertSession(tenantId, record, deps.embedder, null, deps.factStore ? { factStore: deps.factStore, facts } : null);
     }
     else {
-        await deps.store.insertSession(record, deps.embedder, null, deps.factStore ? { factStore: deps.factStore, facts } : null);
+        await deps.store.insertSession(tenantId, record, deps.embedder, null, deps.factStore ? { factStore: deps.factStore, facts } : null);
     }
     return { id, status: "ingested", latencyMs: Date.now() - t0, confidence: classification.confidence };
 }