@north-light/crouter 0.3.318 → 0.3.319

package/dist/core/canvas/history.js

@@ -1,862 +1,26 @@
-// canvas history — the scan-first engine over the per-cwd episodic record.
-//
-// The canvas accumulates a high-signal corpus per cwd: every node that ran
-// there plus the artifacts it left — its `reports/` (append-only push history:
-// final/update/urgent outcome summaries) and `context/` docs (specs, designs,
-// roadmaps, findings). This module is the ONE place that scans that corpus; it
-// lives in the canvas data-access layer, so it resolves every node and artifact
-// path through canvas.ts + paths.ts. Node facets (cwd/kind/status) are filtered
-// in SQL first, then only the surviving nodes' artifact files are read. FTS5/bm25
-// is the future upgrade; the surface above is backend-independent.
-import { envNodeId } from '../../shared/env.js';
-import { statSync, readdirSync } from 'node:fs';
-import { join, relative, sep } from 'node:path';
-import { getNode, listNodes, view } from './canvas.js';
-import { contextDir, reportsDir, nodeDir } from './paths.js';
-import { openDb } from './db.js';
-import { readTextIfExists, walkFiles, pathExists } from '../fs-utils.js';
-import { parseFrontmatterGeneric } from '../frontmatter.js';
-import { warn } from '../output.js';
-import { readStamps } from '../runtime/stamp/protocol.js';
-/** Every origin token `--origin` accepts. `human` is a person at a front door;
- *  the rest mirror the runtime origin kinds; `unknown` is a message that
- *  carries no stamp at all — its own bucket, never folded into another, since
- *  a rising unknown rate is how a delivery seam that stopped announcing shows
- *  itself. */
-export const ORIGIN_TOKENS = [
-    'human',
-    'inbox',
-    'wake',
-    'revive',
-    'restart-continuation',
-    'stop-guard',
-    'park',
-    'recovery',
-    'context-nudge',
-    'kickoff',
-    'unknown',
-];
-/** Message roles carried by a transcript artifact. */
-export const MESSAGE_ROLES = ['user', 'assistant', 'toolResult'];
-/** The cwd the caller means by default: the calling node's cwd (resolved from
- *  CRTR_NODE_ID via the canvas data layer), falling back to the process cwd
- *  when not run as a node. */
-export function callerCwd() {
-    const id = envNodeId();
-    if (id !== undefined && id !== '') {
-        const node = getNode(id);
-        if (node !== null)
-            return node.cwd;
-    }
-    return process.cwd();
-}
-/** Compact report stamp `20260607T075536` → `2026-06-07T07:55:36`. */
-function compactToIso(stamp) {
-    const m = stamp.match(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/);
-    if (m === null)
-        return stamp;
-    return `${m[1]}-${m[2]}-${m[3]}T${m[4]}:${m[5]}:${m[6]}`;
-}
-function toMs(ts) {
-    const n = Date.parse(ts);
-    return Number.isNaN(n) ? 0 : n;
-}
-/** First markdown heading (`# …`) or first non-empty line, trimmed. */
-function firstHeading(body) {
-    const lines = body.split('\n');
-    for (const l of lines) {
-        const t = l.trim();
-        if (t.startsWith('#'))
-            return t.replace(/^#+\s*/, '').trim();
-    }
-    for (const l of lines) {
-        const t = l.trim();
-        if (t !== '')
-            return t.length > 120 ? t.slice(0, 120) : t;
-    }
-    return '';
-}
-/** A memoized body loader for a file artifact — reads + strips frontmatter once. */
-function fileBodyLoader(absPath) {
-    let cached = null;
-    const load = () => {
-        if (cached !== null)
-            return cached;
-        const raw = readTextIfExists(absPath);
-        cached = raw === null ? '' : parseFrontmatterGeneric(raw).body;
-        return cached;
-    };
-    // Read the head eagerly for ts/title derivation (the file is small markdown).
-    const raw = readTextIfExists(absPath);
-    const head = raw === null ? '' : raw;
-    if (raw !== null)
-        cached = parseFrontmatterGeneric(raw).body;
-    return { load, head };
-}
-function reportArtifact(row, desc, filename) {
-    const abs = join(reportsDir(row.node_id), filename);
-    const m = filename.match(/^([0-9]{8}T[0-9]{6})-(\w+)\.md$/);
-    const { load, head } = fileBodyLoader(abs);
-    const fm = parseFrontmatterGeneric(head).data;
-    const reportKind = (typeof fm?.['kind'] === 'string' ? fm['kind'] : undefined) ?? (m ? m[2] : 'report');
-    const ts = (typeof fm?.['ts'] === 'string' ? fm['ts'] : undefined) ??
-        (m ? compactToIso(m[1]) : new Date(statSync(abs).mtimeMs).toISOString());
-    const body = load();
-    return {
-        ref: `${row.node_id}:reports/${filename}`,
-        nodeId: row.node_id,
-        relpath: `reports/${filename}`,
-        source: 'report',
-        reportKind,
-        ts,
-        tsMs: toMs(ts),
-        title: firstHeading(body),
-        nodeName: row.name,
-        nodeKind: row.kind,
-        nodeStatus: row.status,
-        nodeCwd: row.cwd,
-        nodeDesc: desc,
-        path: abs,
-        loadBody: load,
-    };
-}
-function docArtifact(row, desc, abs) {
-    const rel = relative(nodeDir(row.node_id), abs).split(sep).join('/');
-    const isRoadmap = rel === 'context/roadmap.md';
-    const { load } = fileBodyLoader(abs);
-    let ts;
-    try {
-        ts = new Date(statSync(abs).mtimeMs).toISOString();
-    }
-    catch {
-        ts = row.created;
-    }
-    const body = load();
-    return {
-        ref: `${row.node_id}:${rel}`,
-        nodeId: row.node_id,
-        relpath: rel,
-        source: isRoadmap ? 'roadmap' : 'doc',
-        ts,
-        tsMs: toMs(ts),
-        title: firstHeading(body) || rel.replace(/^context\//, ''),
-        nodeName: row.name,
-        nodeKind: row.kind,
-        nodeStatus: row.status,
-        nodeCwd: row.cwd,
-        nodeDesc: desc,
-        path: abs,
-        loadBody: load,
-    };
-}
-/** Every active-inbox delivery ever recorded for a node, including canceled
- *  and acknowledged deliveries. Message sequence is the durable replacement
- *  for the old file's physical append order. */
-function allInboxEntries(nodeId) {
-    const rows = openDb().prepare(`SELECT m.created_at, m.sender_node_id, d.urgency, m.kind, m.label, m.body_ref, m.body_json
+var G=Object.defineProperty;var c=(n,e)=>G(n,"name",{value:e,configurable:!0});import{envNodeId as H}from"../../shared/env.js";import{statSync as D,readdirSync as q}from"node:fs";import{join as x,relative as z,sep as Y}from"node:path";import{getNode as _,listNodes as v,view as P}from"./canvas.js";import{contextDir as Q,reportsDir as w,nodeDir as C}from"./paths.js";import{openDb as U}from"./db.js";import{readTextIfExists as g,walkFiles as V,pathExists as I}from"../fs-utils.js";import{parseFrontmatterGeneric as S}from"../frontmatter.js";import{warn as X}from"../output.js";import{readStamps as Z}from"../runtime/stamp/protocol.js";const wn=["human","inbox","wake","revive","restart-continuation","stop-guard","park","recovery","context-nudge","kickoff","unknown"],Sn=["user","assistant","toolResult"];function nn(){const n=H();if(n!==void 0&&n!==""){const e=_(n);if(e!==null)return e.cwd}return process.cwd()}c(nn,"callerCwd");function A(n){const e=n.match(/^(\d{4})(\d{2})(\d{2})T(\d{2})(\d{2})(\d{2})$/);return e===null?n:`${e[1]}-${e[2]}-${e[3]}T${e[4]}:${e[5]}:${e[6]}`}c(A,"compactToIso");function b(n){const e=Date.parse(n);return Number.isNaN(e)?0:e}c(b,"toMs");function T(n){const e=n.split(`
+`);for(const t of e){const o=t.trim();if(o.startsWith("#"))return o.replace(/^#+\s*/,"").trim()}for(const t of e){const o=t.trim();if(o!=="")return o.length>120?o.slice(0,120):o}return""}c(T,"firstHeading");function O(n){let e=null;const t=c(()=>{if(e!==null)return e;const s=g(n);return e=s===null?"":S(s).body,e},"load"),o=g(n),i=o===null?"":o;return o!==null&&(e=S(o).body),{load:t,head:i}}c(O,"fileBodyLoader");function B(n,e,t){const o=x(w(n.node_id),t),i=t.match(/^([0-9]{8}T[0-9]{6})-(\w+)\.md$/),{load:s,head:r}=O(o),a=S(r).data,d=(typeof a?.kind=="string"?a.kind:void 0)??(i?i[2]:"report"),u=(typeof a?.ts=="string"?a.ts:void 0)??(i?A(i[1]):new Date(D(o).mtimeMs).toISOString()),f=s();return{ref:`${n.node_id}:reports/${t}`,nodeId:n.node_id,relpath:`reports/${t}`,source:"report",reportKind:d,ts:u,tsMs:b(u),title:T(f),nodeName:n.name,nodeKind:n.kind,nodeStatus:n.status,nodeCwd:n.cwd,nodeDesc:e,path:o,loadBody:s}}c(B,"reportArtifact");function K(n,e,t){const o=z(C(n.node_id),t).split(Y).join("/"),i=o==="context/roadmap.md",{load:s}=O(t);let r;try{r=new Date(D(t).mtimeMs).toISOString()}catch{r=n.created}const a=s();return{ref:`${n.node_id}:${o}`,nodeId:n.node_id,relpath:o,source:i?"roadmap":"doc",ts:r,tsMs:b(r),title:T(a)||o.replace(/^context\//,""),nodeName:n.name,nodeKind:n.kind,nodeStatus:n.status,nodeCwd:n.cwd,nodeDesc:e,path:t,loadBody:s}}c(K,"docArtifact");function E(n){return U().prepare(`SELECT m.created_at, m.sender_node_id, d.urgency, m.kind, m.label, m.body_ref, m.body_json
        FROM deliveries d JOIN messages m ON m.message_id = d.message_id
       WHERE d.destination_kind = 'node_inbox' AND d.destination_id = ? AND d.wake = 1
-      ORDER BY m.seq, d.created_at, d.delivery_id`).all(nodeId);
-    return rows.map((row) => ({
-        ts: row.created_at,
-        from: row.sender_node_id,
-        tier: row.urgency,
-        kind: row.kind,
-        label: row.label,
-        ref: row.body_ref,
-        data: row.body_json === null ? null : JSON.parse(row.body_json),
-    }));
-}
-function reportBodyFromRef(ref) {
-    try {
-        const resolved = resolveRef(ref);
-        if (resolved?.source === 'report')
-            return resolved.body;
-    }
-    catch {
-        /* fall through to the legacy absolute-path fallback */
-    }
-    return null;
-}
-/** One inbox entry's full content: a direct message or system alert's
- *  un-clipped body — dereferenced from its spilled ref file when the inline
- *  preview clipped, else the inline body itself — or, for a push pointer
- *  (which carries no body of its own), its kind/label plus the sender-side
- *  report content resolved through its canonical history ref.
- *
- *  A spilled ref (message/system notice too long to inline) is arbitrary
- *  text with no crouter frontmatter contract — read it RAW, unlike a report
- *  ref, which always carries the `---\n...\n---` header stripped by
- *  fileBodyLoader. The presence of an inline `data.body` preview is what
- *  distinguishes the two: only a spilled message/notice ever carries one
- *  (a push pointer's entry has no `data` field at all). */
-function inboxEntryBody(e) {
-    const meta = [`from: ${e.from ?? 'system'}`, `tier: ${e.tier}`].join('\n');
-    const header = `[${e.kind}] ${e.label}`;
-    const dataBody = typeof e.data === 'object' && e.data !== null && !Array.isArray(e.data)
-        ? e.data['body']
-        : undefined;
-    const inlinePreview = typeof dataBody === 'string' ? dataBody.trim() : '';
-    const isSpilledMessage = typeof dataBody === 'string';
-    const full = e.ref !== null
-        ? isSpilledMessage
-            ? (readTextIfExists(e.ref) ?? '')
-            : reportBodyFromRef(e.ref) ?? fileBodyLoader(e.ref).load()
-        : inlinePreview;
-    const hasBody = full !== '' && full !== e.label;
-    const parts = [meta, header];
-    if (e.ref !== null)
-        parts.push(`ref: ${e.ref}`);
-    if (hasBody)
-        parts.push(full);
-    return parts.join('\n\n');
-}
-function inboxArtifact(row, desc, entry, index) {
-    const relpath = `inbox/${String(index).padStart(6, '0')}`;
-    const body = inboxEntryBody(entry);
-    // An inbox entry IS an arrival, so it carries the same two inbound
-    // dimensions a stamped user message does — which is what lets `--origin` and
-    // `--from` span the transcript and inbox corpora with one vocabulary.
-    const a = {
-        ref: `${row.node_id}:${relpath}`,
-        nodeId: row.node_id,
-        relpath,
-        source: 'inbox',
-        ts: entry.ts,
-        tsMs: toMs(entry.ts),
-        title: `[${entry.kind}] from ${entry.from ?? 'system'}: ${entry.label}`,
-        nodeName: row.name,
-        nodeKind: row.kind,
-        nodeStatus: row.status,
-        nodeCwd: row.cwd,
-        nodeDesc: desc,
-        path: null,
-        loadBody: () => body,
-        origin: 'inbox',
-    };
-    if (typeof entry.from === 'string' && entry.from !== '')
-        a.from = entry.from;
-    return a;
-}
-/** The node's SQL-recorded session `.jsonl`, or null when nothing has been
- *  written yet. Pi binds the path at session creation but writes the file on the
- *  first appended entry, so a fresh node may have a path that is not on disk. */
-function resolveSessionFile(nodeId) {
-    const recorded = getNode(nodeId)?.pi_session_file;
-    return typeof recorded === 'string' && recorded !== '' && pathExists(recorded) ? recorded : null;
-}
-/** The searchable text of a message's content blocks. `thinking` blocks are
- *  deliberately dropped: private model reasoning is excluded from every human
- *  transcript surface, and putting it in the search corpus would leak it back
- *  in through grep. */
-function textFromBlocks(content) {
-    if (typeof content === 'string')
-        return content;
-    if (!Array.isArray(content))
-        return '';
-    const parts = [];
-    for (const block of content) {
-        if (block === null || typeof block !== 'object')
-            continue;
-        const b = block;
-        if (b['type'] === 'text' && typeof b['text'] === 'string')
-            parts.push(b['text']);
-        else if (b['type'] === 'toolCall')
-            parts.push(`Tool: ${typeof b['name'] === 'string' ? b['name'] : 'call'}`);
-    }
-    return parts.join('\n');
-}
-/** The single token `--origin` matches against. */
-function originToken(origin) {
-    if (origin === null || origin === undefined)
-        return 'unknown';
-    return origin.type === 'human' ? 'human' : origin.kind;
-}
-/** Who a delivery came from, comma-joined when it carried several entries. */
-function sendersOf(origin) {
-    if (origin === null || origin === undefined || origin.type !== 'runtime')
-        return undefined;
-    const entries = origin.entries;
-    if (entries === undefined || entries.length === 0)
-        return undefined;
-    const names = new Set();
-    for (const e of entries) {
-        const who = e.fromName ?? e.from;
-        if (typeof who === 'string' && who !== '')
-            names.add(who);
-    }
-    return names.size === 0 ? undefined : [...names].join(', ');
-}
-/** Parse a node's session file into its messages, each carrying the origin its
- *  stamp recorded. Deliberately a direct line parse rather than pi's
- *  SessionManager: reconstruction copies the file to a temp dir and rebuilds
- *  cycles, which is far too heavy to run across every node in a scan.
- *
- *  Stamps are correlated by the target message's own `timestamp` (epoch ms) —
- *  never by tree position, because a stamp is physically written BEFORE the
- *  message it describes. */
-function sessionMessages(nodeId) {
-    const file = resolveSessionFile(nodeId);
-    if (file === null)
-        return [];
-    const raw = readTextIfExists(file);
-    if (raw === null)
-        return [];
-    const entries = [];
-    for (const line of raw.split('\n')) {
-        if (line.trim() === '')
-            continue;
-        try {
-            entries.push(JSON.parse(line));
-        }
-        catch {
-            // A truncated final line is normal while a broker is mid-append.
-        }
-    }
-    const origins = new Map();
-    for (const stamp of readStamps(entries)) {
-        if (stamp.kind !== 'message')
-            continue;
-        const payload = stamp.payload;
-        if (typeof payload.msgTs !== 'number')
-            continue;
-        origins.set(payload.msgTs, payload.origin);
-    }
-    const out = [];
-    for (const entry of entries) {
-        if (entry === null || typeof entry !== 'object')
-            continue;
-        const e = entry;
-        if (e['type'] !== 'message')
-            continue;
-        const message = e['message'];
-        if (message === null || typeof message !== 'object')
-            continue;
-        const m = message;
-        const role = typeof m['role'] === 'string' ? m['role'] : '';
-        if (role === '')
-            continue;
-        const msgTs = typeof m['timestamp'] === 'number' ? m['timestamp'] : undefined;
-        const iso = typeof e['timestamp'] === 'string'
-            ? e['timestamp']
-            : msgTs !== undefined ? new Date(msgTs).toISOString() : '';
-        const text = textFromBlocks(m['content']);
-        const msg = {
-            index: out.length,
-            role,
-            text,
-            ts: iso,
-            tsMs: msgTs ?? toMs(iso),
-        };
-        // Origin is a property of ARRIVAL, so only an inbound turn carries one.
-        if (role === 'user') {
-            const origin = msgTs !== undefined && origins.has(msgTs) ? origins.get(msgTs) : null;
-            msg.origin = originToken(origin);
-            const from = sendersOf(origin);
-            if (from !== undefined)
-                msg.from = from;
-        }
-        out.push(msg);
-    }
-    return out;
-}
-/** The verbatim jsonl line that persisted the Nth MESSAGE. Message ordinals
- *  and line numbers differ — stamps, model changes, and session headers occupy
- *  lines of their own — so this re-walks the file counting message entries
- *  rather than indexing lines directly. */
-function rawSessionLine(file, index) {
-    const raw = readTextIfExists(file);
-    if (raw === null)
-        return null;
-    let seen = 0;
-    for (const line of raw.split('\n')) {
-        if (line.trim() === '')
-            continue;
-        let parsed;
-        try {
-            parsed = JSON.parse(line);
-        }
-        catch {
-            continue;
-        }
-        if (parsed === null || typeof parsed !== 'object')
-            continue;
-        const e = parsed;
-        if (e['type'] !== 'message')
-            continue;
-        const m = e['message'];
-        if (m === null || typeof m !== 'object' || typeof m['role'] !== 'string')
-            continue;
-        if (seen === index)
-            return line;
-        seen++;
-    }
-    return null;
-}
-function transcriptArtifact(row, desc, msg) {
-    const relpath = `session/${String(msg.index).padStart(6, '0')}`;
-    const lead = msg.text.split('\n').map((l) => l.trim()).find((l) => l !== '') ?? '';
-    const a = {
-        ref: `${row.node_id}:${relpath}`,
-        nodeId: row.node_id,
-        relpath,
-        source: 'transcript',
-        ts: msg.ts,
-        tsMs: msg.tsMs,
-        title: `[${msg.role}] ${lead.length > 80 ? `${lead.slice(0, 80)}…` : lead}`,
-        nodeName: row.name,
-        nodeKind: row.kind,
-        nodeStatus: row.status,
-        nodeCwd: row.cwd,
-        nodeDesc: desc,
-        path: null,
-        loadBody: () => msg.text,
-        role: msg.role,
-    };
-    if (msg.origin !== undefined)
-        a.origin = msg.origin;
-    if (msg.from !== undefined)
-        a.from = msg.from;
-    return a;
-}
-function metaArtifact(row, desc) {
-    const body = `${row.name}\n${desc}\n${row.kind}`;
-    return {
-        ref: `${row.node_id}:meta`,
-        nodeId: row.node_id,
-        relpath: 'meta',
-        source: 'meta',
-        ts: row.created,
-        tsMs: toMs(row.created),
-        title: row.name,
-        nodeName: row.name,
-        nodeKind: row.kind,
-        nodeStatus: row.status,
-        nodeCwd: row.cwd,
-        nodeDesc: desc,
-        path: null,
-        loadBody: () => body,
-    };
-}
-/** List the markdown reports a node left, in directory order. */
-function listReportFiles(nodeId) {
-    const dir = reportsDir(nodeId);
-    if (!pathExists(dir))
-        return [];
-    try {
-        return readdirSync(dir).filter((f) => f.endsWith('.md'));
-    }
-    catch {
-        return [];
-    }
-}
-/** The history ref of a node's newest report, or null when it left none.
- *  Report filenames lead with a compact timestamp, so the lexicographic maximum
- *  is the latest one. Callers use this to hand a reader something they can
- *  actually open (`crtr canvas history read <ref>`) instead of a bare node id. */
-export function newestReportRef(nodeId) {
-    let newest = null;
-    for (const f of listReportFiles(nodeId))
-        if (newest === null || f > newest)
-            newest = f;
-    return newest === null ? null : `${nodeId}:reports/${newest}`;
-}
-/** Enumerate every context markdown doc a node left (recursive). */
-function listDocFiles(nodeId) {
-    const dir = contextDir(nodeId);
-    if (!pathExists(dir))
-        return [];
-    try {
-        return walkFiles(dir, (name) => name.endsWith('.md'));
-    }
-    catch {
-        return [];
-    }
-}
-/** Keep one malformed artifact from breaking a cross-node corpus scan. */
-function warnInvalidFrontmatter(path, error) {
-    const message = (error instanceof Error ? error.message : String(error)).split('\n')[0];
-    warn(`invalid frontmatter in ${path}: ${message}`);
-}
-/** Read a node description once for each surviving SQL row. */
-function nodeDescOf(nodeId) {
-    const n = getNode(nodeId);
-    return n?.description ?? '';
-}
-/** Build the searchable artifact set for a scope + corpus filter. Node facets
- *  are applied against the db rows first (cheap); only surviving nodes' files
- *  are read. */
-export function buildCorpus(scope, corpus) {
-    const rows = scopedRows(scope);
-    // Node-facet narrowing (cheap, on the row).
-    const kinds = corpus.kinds;
-    const statuses = corpus.statuses;
-    const survivors = rows.filter((r) => {
-        if (kinds !== undefined && kinds.length > 0 && !kinds.includes(r.kind))
-            return false;
-        if (statuses !== undefined && statuses.length > 0 && !statuses.includes(r.status))
-            return false;
-        return true;
-    });
-    // --report-kind implies type=report. `inbox` and `transcript` are opt-in
-    // only — never part of the default set — since a node's raw inbox history and
-    // its full conversation are unbounded diagnostic detail, not curated past
-    // work.
-    const wantReportKind = corpus.reportKind;
-    const types = corpus.types !== undefined && corpus.types.length > 0
-        ? corpus.types
-        : wantReportKind !== undefined
-            ? ['report']
-            : ['report', 'doc', 'roadmap', 'meta'];
-    const want = new Set(types);
-    const out = [];
-    for (const row of survivors) {
-        const desc = want.has('meta') || want.has('report') || want.has('doc') || want.has('roadmap') || want.has('inbox')
-            ? nodeDescOf(row.node_id)
-            : '';
-        if (want.has('meta'))
-            out.push(metaArtifact(row, desc));
-        if (want.has('report')) {
-            for (const f of listReportFiles(row.node_id)) {
-                const abs = join(reportsDir(row.node_id), f);
-                let a;
-                try {
-                    a = reportArtifact(row, desc, f);
-                }
-                catch (e) {
-                    warnInvalidFrontmatter(abs, e);
-                    continue;
-                }
-                if (a === null)
-                    continue;
-                if (wantReportKind !== undefined && a.reportKind !== wantReportKind)
-                    continue;
-                out.push(a);
-            }
-        }
-        if (want.has('doc') || want.has('roadmap')) {
-            for (const abs of listDocFiles(row.node_id)) {
-                let a;
-                try {
-                    a = docArtifact(row, desc, abs);
-                }
-                catch (e) {
-                    warnInvalidFrontmatter(abs, e);
-                    continue;
-                }
-                if (a.source === 'roadmap' && !want.has('roadmap'))
-                    continue;
-                if (a.source === 'doc' && !want.has('doc'))
-                    continue;
-                out.push(a);
-            }
-        }
-        if (want.has('inbox')) {
-            allInboxEntries(row.node_id).forEach((entry, i) => out.push(inboxArtifact(row, desc, entry, i)));
-        }
-        if (want.has('transcript')) {
-            for (const msg of sessionMessages(row.node_id))
-                out.push(transcriptArtifact(row, desc, msg));
-        }
-    }
-    // Time window on artifact ts, then the message-attribute narrowing. An
-    // artifact that does not carry a dimension never survives that dimension's
-    // filter — asking for an origin excludes every generated turn by itself.
-    return out.filter((a) => {
-        if (corpus.sinceMs !== undefined && a.tsMs < corpus.sinceMs)
-            return false;
-        if (corpus.untilMs !== undefined && a.tsMs > corpus.untilMs)
-            return false;
-        return matchesMessageFilters(a, corpus);
-    });
-}
-/** The transcript/inbox dimensions: origin, role, sender. */
-function matchesMessageFilters(a, corpus) {
-    const { origins, roles, from } = corpus;
-    if (origins !== undefined && origins.length > 0) {
-        if (a.origin === undefined || !origins.includes(a.origin))
-            return false;
-    }
-    if (roles !== undefined && roles.length > 0) {
-        if (a.role === undefined || !roles.includes(a.role))
-            return false;
-    }
-    if (from !== undefined && from !== '') {
-        if (a.from === undefined || !a.from.toLowerCase().includes(from.toLowerCase()))
-            return false;
-    }
-    return true;
-}
-/** Collapse a built corpus into counts by one dimension, descending by count.
- *  Artifacts that do not carry the grouped dimension are omitted rather than
- *  bucketed as empty — grouping by origin answers "what drove arrivals", and a
- *  generated turn is not an arrival. `unknown` is a real origin value here, not
- *  a missing one. */
-export function groupCorpus(arts, by) {
-    const counts = new Map();
-    for (const a of arts) {
-        let key;
-        switch (by) {
-            case 'origin':
-                key = a.origin;
-                break;
-            case 'role':
-                key = a.role;
-                break;
-            case 'node':
-                key = `${a.nodeName} (${a.nodeId})`;
-                break;
-            case 'kind':
-                key = a.nodeKind;
-                break;
-            case 'type':
-                key = a.source;
-                break;
-            case 'day':
-                key = a.ts.slice(0, 10) || undefined;
-                break;
-        }
-        if (key === undefined || key === '')
-            continue;
-        counts.set(key, (counts.get(key) ?? 0) + 1);
-    }
-    return [...counts.entries()]
-        .map(([key, count]) => ({ key, count }))
-        .sort((x, y) => y.count - x.count || x.key.localeCompare(y.key));
-}
-/** Resolve the scope to the node rows in play. */
-function scopedRows(scope) {
-    const all = listNodes();
-    const byId = new Map(all.map((r) => [r.node_id, r]));
-    if (scope.nodes !== undefined && scope.nodes.length > 0) {
-        return scope.nodes.map((id) => byId.get(id)).filter((r) => r !== undefined);
-    }
-    if (scope.under !== undefined && scope.under !== '') {
-        const ids = [scope.under, ...view(scope.under)];
-        return ids.map((id) => byId.get(id)).filter((r) => r !== undefined);
-    }
-    if (scope.allCwds === true)
-        return all;
-    const cwd = scope.cwd !== undefined && scope.cwd !== '' ? scope.cwd : callerCwd();
-    return all.filter((r) => r.cwd === cwd);
-}
-/** Resolve a `<node-id>:<relpath>` handle to its content. Returns null when the
- *  node is unknown or the artifact does not exist. Throws on path traversal. */
-export function resolveRef(ref) {
-    const idx = ref.indexOf(':');
-    if (idx === -1)
-        return null;
-    const nodeId = ref.slice(0, idx);
-    const relpath = ref.slice(idx + 1);
-    const node = getNode(nodeId);
-    if (node === null)
-        return null;
-    if (relpath === 'meta') {
-        const body = `# ${node.name}\n\n- kind: ${node.kind}\n- status: ${node.status}\n- cwd: ${node.cwd}\n- created: ${node.created}\n\n${node.description ?? ''}`;
-        return {
-            nodeId,
-            relpath,
-            source: 'meta',
-            ts: node.created,
-            nodeName: node.name,
-            body,
-            raw: null,
-            path: null,
-        };
-    }
-    if (relpath.startsWith('inbox/')) {
-        const index = Number(relpath.slice('inbox/'.length));
-        const entry = allInboxEntries(nodeId)[index];
-        if (entry === undefined)
-            return null;
-        return {
-            nodeId,
-            relpath,
-            source: 'inbox',
-            ts: entry.ts,
-            nodeName: node.name,
-            body: inboxEntryBody(entry),
-            raw: null,
-            path: null,
-        };
-    }
-    // `session` addresses the whole conversation; `session/<index>` one message.
-    // `raw` is the verbatim record in both cases — the session file's bytes, or
-    // the one jsonl line that persisted that message.
-    if (relpath === 'session' || relpath.startsWith('session/')) {
-        const file = resolveSessionFile(nodeId);
-        if (file === null)
-            return null;
-        const messages = sessionMessages(nodeId);
-        if (relpath === 'session') {
-            const rendered = messages
-                .map((m) => `## ${m.role}${m.origin !== undefined ? ` (origin: ${m.origin})` : ''}\n\n${m.text}`)
-                .join('\n\n');
-            return {
-                nodeId,
-                relpath,
-                source: 'transcript',
-                ts: messages[messages.length - 1]?.ts ?? node.created,
-                nodeName: node.name,
-                body: rendered,
-                raw: readTextIfExists(file),
-                path: file,
-            };
-        }
-        const index = Number(relpath.slice('session/'.length));
-        const msg = messages[index];
-        if (msg === undefined)
-            return null;
-        return {
-            nodeId,
-            relpath,
-            source: 'transcript',
-            ts: msg.ts,
-            nodeName: node.name,
-            body: msg.text,
-            raw: rawSessionLine(file, index),
-            path: file,
-        };
-    }
-    if (relpath.includes('..') || relpath.startsWith('/')) {
-        throw new Error(`illegal relpath in ref: ${relpath}`);
-    }
-    const abs = join(nodeDir(nodeId), relpath);
-    const raw = readTextIfExists(abs);
-    if (raw === null)
-        return null;
-    const { body, data: fm } = parseFrontmatterGeneric(raw);
-    const isReport = relpath.startsWith('reports/');
-    const isRoadmap = relpath === 'context/roadmap.md';
-    let ts;
-    if (typeof fm?.['ts'] === 'string')
-        ts = fm['ts'];
-    else {
-        try {
-            ts = new Date(statSync(abs).mtimeMs).toISOString();
-        }
-        catch {
-            ts = node.created;
-        }
-    }
-    return {
-        nodeId,
-        relpath,
-        source: isReport ? 'report' : isRoadmap ? 'roadmap' : 'doc',
-        reportKind: isReport && typeof fm?.['kind'] === 'string' ? fm['kind'] : undefined,
-        ts,
-        nodeName: node.name,
-        body,
-        raw,
-        path: abs,
-    };
-}
-/** Enumerate one node's artifacts (for `history show`). */
-export function nodeArtifacts(nodeId, types) {
-    const node = getNode(nodeId);
-    if (node === null)
-        return [];
-    const row = {
-        node_id: node.node_id,
-        name: node.name,
-        kind: node.kind,
-        mode: node.mode,
-        lifecycle: node.lifecycle,
-        status: node.status,
-        cwd: node.cwd,
-        host_kind: node.host_kind ?? null,
-        profile_id: node.profile_id ?? null,
-        parent: node.parent ?? null,
-        created: node.created,
-        intent: node.intent ?? null,
-        waiting_for: node.waiting_for ?? null,
-        pi_pid: node.pi_pid ?? null,
-        pi_pid_identity: node.pi_pid_identity ?? null,
-        window: node.window ?? null,
-        tmux_session: node.tmux_session ?? null,
-        pane: node.pane ?? null,
-    };
-    // `inbox` is opt-in only, same as buildCorpus — must be requested explicitly.
-    const want = new Set(types !== undefined && types.length > 0 ? types : ['report', 'doc', 'roadmap']);
-    const desc = node.description ?? '';
-    const out = [];
-    // One malformed file must not break the whole listing — the frontmatter
-    // parser throws by design, so this collection layer isolates per file, same
-    // as buildCorpus. A context dir often holds foreign markdown (a checked-out
-    // repo, node_modules) whose `---` header is not crouter frontmatter.
-    if (want.has('report')) {
-        for (const f of listReportFiles(nodeId)) {
-            let a;
-            try {
-                a = reportArtifact(row, desc, f);
-            }
-            catch (e) {
-                warnInvalidFrontmatter(join(reportsDir(nodeId), f), e);
-                continue;
-            }
-            if (a !== null)
-                out.push(a);
-        }
-    }
-    if (want.has('doc') || want.has('roadmap')) {
-        for (const abs of listDocFiles(nodeId)) {
-            let a;
-            try {
-                a = docArtifact(row, desc, abs);
-            }
-            catch (e) {
-                warnInvalidFrontmatter(abs, e);
-                continue;
-            }
-            if (a.source === 'roadmap' && !want.has('roadmap'))
-                continue;
-            if (a.source === 'doc' && !want.has('doc'))
-                continue;
-            out.push(a);
-        }
-    }
-    if (want.has('inbox')) {
-        allInboxEntries(nodeId).forEach((entry, i) => out.push(inboxArtifact(row, desc, entry, i)));
-    }
-    if (want.has('transcript')) {
-        for (const msg of sessionMessages(nodeId))
-            out.push(transcriptArtifact(row, desc, msg));
-    }
-    return out;
-}
-/** Bounded per-cwd aggregate for the branch `-h` `<corpus>` block. Counts files
- *  on disk without reading bodies. */
-export function corpusStats(cwd) {
-    const rows = listNodes().filter((r) => r.cwd === cwd);
-    let reports = 0;
-    let docs = 0;
-    let min = Infinity;
-    let max = -Infinity;
-    for (const row of rows) {
-        const cMs = toMs(row.created);
-        if (cMs > 0) {
-            if (cMs < min)
-                min = cMs;
-            if (cMs > max)
-                max = cMs;
-        }
-        for (const f of listReportFiles(row.node_id)) {
-            reports++;
-            const m = f.match(/^([0-9]{8}T[0-9]{6})-/);
-            if (m !== null) {
-                const t = toMs(compactToIso(m[1]));
-                if (t > 0) {
-                    if (t < min)
-                        min = t;
-                    if (t > max)
-                        max = t;
-                }
-            }
-        }
-        docs += listDocFiles(row.node_id).length;
-    }
-    const span = min !== Infinity && max !== -Infinity
-        ? { from: new Date(min).toISOString().slice(0, 10), to: new Date(max).toISOString().slice(0, 10) }
-        : null;
-    return { cwd, nodes: rows.length, reports, docs, span };
-}
+      ORDER BY m.seq, d.created_at, d.delivery_id`).all(n).map(t=>({ts:t.created_at,from:t.sender_node_id,tier:t.urgency,kind:t.kind,label:t.label,ref:t.body_ref,data:t.body_json===null?null:JSON.parse(t.body_json)}))}c(E,"allInboxEntries");function tn(n){try{const e=un(n);if(e?.source==="report")return e.body}catch{}return null}c(tn,"reportBodyFromRef");function F(n){const e=[`from: ${n.from??"system"}`,`tier: ${n.tier}`].join(`
+`),t=`[${n.kind}] ${n.label}`,o=typeof n.data=="object"&&n.data!==null&&!Array.isArray(n.data)?n.data.body:void 0,i=typeof o=="string"?o.trim():"",s=typeof o=="string",r=n.ref!==null?s?g(n.ref)??"":tn(n.ref)??O(n.ref).load():i,a=r!==""&&r!==n.label,d=[e,t];return n.ref!==null&&d.push(`ref: ${n.ref}`),a&&d.push(r),d.join(`
+
+`)}c(F,"inboxEntryBody");function W(n,e,t,o){const i=`inbox/${String(o).padStart(6,"0")}`,s=F(t),r={ref:`${n.node_id}:${i}`,nodeId:n.node_id,relpath:i,source:"inbox",ts:t.ts,tsMs:b(t.ts),title:`[${t.kind}] from ${t.from??"system"}: ${t.label}`,nodeName:n.name,nodeKind:n.kind,nodeStatus:n.status,nodeCwd:n.cwd,nodeDesc:e,path:null,loadBody:c(()=>s,"loadBody"),origin:"inbox"};return typeof t.from=="string"&&t.from!==""&&(r.from=t.from),r}c(W,"inboxArtifact");function L(n){const e=_(n)?.pi_session_file;return typeof e=="string"&&e!==""&&I(e)?e:null}c(L,"resolveSessionFile");function en(n){if(typeof n=="string")return n;if(!Array.isArray(n))return"";const e=[];for(const t of n){if(t===null||typeof t!="object")continue;const o=t;o.type==="text"&&typeof o.text=="string"?e.push(o.text):o.type==="toolCall"&&e.push(`Tool: ${typeof o.name=="string"?o.name:"call"}`)}return e.join(`
+`)}c(en,"textFromBlocks");function on(n){return n==null?"unknown":n.type==="human"?"human":n.kind}c(on,"originToken");function sn(n){if(n==null||n.type!=="runtime")return;const e=n.entries;if(e===void 0||e.length===0)return;const t=new Set;for(const o of e){const i=o.fromName??o.from;typeof i=="string"&&i!==""&&t.add(i)}return t.size===0?void 0:[...t].join(", ")}c(sn,"sendersOf");function R(n){const e=L(n);if(e===null)return[];const t=g(e);if(t===null)return[];const o=[];for(const r of t.split(`
+`))if(r.trim()!=="")try{o.push(JSON.parse(r))}catch{}const i=new Map;for(const r of Z(o)){if(r.kind!=="message")continue;const a=r.payload;typeof a.msgTs=="number"&&i.set(a.msgTs,a.origin)}const s=[];for(const r of o){if(r===null||typeof r!="object")continue;const a=r;if(a.type!=="message")continue;const d=a.message;if(d===null||typeof d!="object")continue;const u=d,f=typeof u.role=="string"?u.role:"";if(f==="")continue;const l=typeof u.timestamp=="number"?u.timestamp:void 0,p=typeof a.timestamp=="string"?a.timestamp:l!==void 0?new Date(l).toISOString():"",m=en(u.content),h={index:s.length,role:f,text:m,ts:p,tsMs:l??b(p)};if(f==="user"){const y=l!==void 0&&i.has(l)?i.get(l):null;h.origin=on(y);const $=sn(y);$!==void 0&&(h.from=$)}s.push(h)}return s}c(R,"sessionMessages");function rn(n,e){const t=g(n);if(t===null)return null;let o=0;for(const i of t.split(`
+`)){if(i.trim()==="")continue;let s;try{s=JSON.parse(i)}catch{continue}if(s===null||typeof s!="object")continue;const r=s;if(r.type!=="message")continue;const a=r.message;if(!(a===null||typeof a!="object"||typeof a.role!="string")){if(o===e)return i;o++}}return null}c(rn,"rawSessionLine");function J(n,e,t){const o=`session/${String(t.index).padStart(6,"0")}`,i=t.text.split(`
+`).map(r=>r.trim()).find(r=>r!=="")??"",s={ref:`${n.node_id}:${o}`,nodeId:n.node_id,relpath:o,source:"transcript",ts:t.ts,tsMs:t.tsMs,title:`[${t.role}] ${i.length>80?`${i.slice(0,80)}\u2026`:i}`,nodeName:n.name,nodeKind:n.kind,nodeStatus:n.status,nodeCwd:n.cwd,nodeDesc:e,path:null,loadBody:c(()=>t.text,"loadBody"),role:t.role};return t.origin!==void 0&&(s.origin=t.origin),t.from!==void 0&&(s.from=t.from),s}c(J,"transcriptArtifact");function dn(n,e){const t=`${n.name}
+${e}
+${n.kind}`;return{ref:`${n.node_id}:meta`,nodeId:n.node_id,relpath:"meta",source:"meta",ts:n.created,tsMs:b(n.created),title:n.name,nodeName:n.name,nodeKind:n.kind,nodeStatus:n.status,nodeCwd:n.cwd,nodeDesc:e,path:null,loadBody:c(()=>t,"loadBody")}}c(dn,"metaArtifact");function N(n){const e=w(n);if(!I(e))return[];try{return q(e).filter(t=>t.endsWith(".md"))}catch{return[]}}c(N,"listReportFiles");function Nn(n){let e=null;for(const t of N(n))(e===null||t>e)&&(e=t);return e===null?null:`${n}:reports/${e}`}c(Nn,"newestReportRef");function j(n){const e=Q(n);if(!I(e))return[];try{return V(e,t=>t.endsWith(".md"))}catch{return[]}}c(j,"listDocFiles");function M(n,e){const t=(e instanceof Error?e.message:String(e)).split(`
+`)[0];X(`invalid frontmatter in ${n}: ${t}`)}c(M,"warnInvalidFrontmatter");function an(n){return _(n)?.description??""}c(an,"nodeDescOf");function Mn(n,e){const t=fn(n),o=e.kinds,i=e.statuses,s=t.filter(f=>!(o!==void 0&&o.length>0&&!o.includes(f.kind)||i!==void 0&&i.length>0&&!i.includes(f.status))),r=e.reportKind,a=e.types!==void 0&&e.types.length>0?e.types:r!==void 0?["report"]:["report","doc","roadmap","meta"],d=new Set(a),u=[];for(const f of s){const l=d.has("meta")||d.has("report")||d.has("doc")||d.has("roadmap")||d.has("inbox")?an(f.node_id):"";if(d.has("meta")&&u.push(dn(f,l)),d.has("report"))for(const p of N(f.node_id)){const m=x(w(f.node_id),p);let h;try{h=B(f,l,p)}catch(y){M(m,y);continue}h!==null&&(r!==void 0&&h.reportKind!==r||u.push(h))}if(d.has("doc")||d.has("roadmap"))for(const p of j(f.node_id)){let m;try{m=K(f,l,p)}catch(h){M(p,h);continue}m.source==="roadmap"&&!d.has("roadmap")||m.source==="doc"&&!d.has("doc")||u.push(m)}if(d.has("inbox")&&E(f.node_id).forEach((p,m)=>u.push(W(f,l,p,m))),d.has("transcript"))for(const p of R(f.node_id))u.push(J(f,l,p))}return u.filter(f=>e.sinceMs!==void 0&&f.tsMs<e.sinceMs||e.untilMs!==void 0&&f.tsMs>e.untilMs?!1:cn(f,e))}c(Mn,"buildCorpus");function cn(n,e){const{origins:t,roles:o,from:i}=e;return!(t!==void 0&&t.length>0&&(n.origin===void 0||!t.includes(n.origin))||o!==void 0&&o.length>0&&(n.role===void 0||!o.includes(n.role))||i!==void 0&&i!==""&&(n.from===void 0||!n.from.toLowerCase().includes(i.toLowerCase())))}c(cn,"matchesMessageFilters");function Dn(n,e){const t=new Map;for(const o of n){let i;switch(e){case"origin":i=o.origin;break;case"role":i=o.role;break;case"node":i=`${o.nodeName} (${o.nodeId})`;break;case"kind":i=o.nodeKind;break;case"type":i=o.source;break;case"day":i=o.ts.slice(0,10)||void 0;break}i===void 0||i===""||t.set(i,(t.get(i)??0)+1)}return[...t.entries()].map(([o,i])=>({key:o,count:i})).sort((o,i)=>i.count-o.count||o.key.localeCompare(i.key))}c(Dn,"groupCorpus");function fn(n){const e=v(),t=new Map(e.map(i=>[i.node_id,i]));if(n.nodes!==void 0&&n.nodes.length>0)return n.nodes.map(i=>t.get(i)).filter(i=>i!==void 0);if(n.under!==void 0&&n.under!=="")return[n.under,...P(n.under)].map(s=>t.get(s)).filter(s=>s!==void 0);if(n.allCwds===!0)return e;const o=n.cwd!==void 0&&n.cwd!==""?n.cwd:nn();return e.filter(i=>i.cwd===o)}c(fn,"scopedRows");function un(n){const e=n.indexOf(":");if(e===-1)return null;const t=n.slice(0,e),o=n.slice(e+1),i=_(t);if(i===null)return null;if(o==="meta"){const p=`# ${i.name}
+
+- kind: ${i.kind}
+- status: ${i.status}
+- cwd: ${i.cwd}
+- created: ${i.created}
+
+${i.description??""}`;return{nodeId:t,relpath:o,source:"meta",ts:i.created,nodeName:i.name,body:p,raw:null,path:null}}if(o.startsWith("inbox/")){const p=Number(o.slice(6)),m=E(t)[p];return m===void 0?null:{nodeId:t,relpath:o,source:"inbox",ts:m.ts,nodeName:i.name,body:F(m),raw:null,path:null}}if(o==="session"||o.startsWith("session/")){const p=L(t);if(p===null)return null;const m=R(t);if(o==="session"){const $=m.map(k=>`## ${k.role}${k.origin!==void 0?` (origin: ${k.origin})`:""}
+
+${k.text}`).join(`
+
+`);return{nodeId:t,relpath:o,source:"transcript",ts:m[m.length-1]?.ts??i.created,nodeName:i.name,body:$,raw:g(p),path:p}}const h=Number(o.slice(8)),y=m[h];return y===void 0?null:{nodeId:t,relpath:o,source:"transcript",ts:y.ts,nodeName:i.name,body:y.text,raw:rn(p,h),path:p}}if(o.includes("..")||o.startsWith("/"))throw new Error(`illegal relpath in ref: ${o}`);const s=x(C(t),o),r=g(s);if(r===null)return null;const{body:a,data:d}=S(r),u=o.startsWith("reports/"),f=o==="context/roadmap.md";let l;if(typeof d?.ts=="string")l=d.ts;else try{l=new Date(D(s).mtimeMs).toISOString()}catch{l=i.created}return{nodeId:t,relpath:o,source:u?"report":f?"roadmap":"doc",reportKind:u&&typeof d?.kind=="string"?d.kind:void 0,ts:l,nodeName:i.name,body:a,raw:r,path:s}}c(un,"resolveRef");function In(n,e){const t=_(n);if(t===null)return[];const o={node_id:t.node_id,name:t.name,kind:t.kind,mode:t.mode,lifecycle:t.lifecycle,status:t.status,cwd:t.cwd,host_kind:t.host_kind??null,profile_id:t.profile_id??null,parent:t.parent??null,created:t.created,intent:t.intent??null,waiting_for:t.waiting_for??null,pi_pid:t.pi_pid??null,pi_pid_identity:t.pi_pid_identity??null,window:t.window??null,tmux_session:t.tmux_session??null,pane:t.pane??null},i=new Set(e!==void 0&&e.length>0?e:["report","doc","roadmap"]),s=t.description??"",r=[];if(i.has("report"))for(const a of N(n)){let d;try{d=B(o,s,a)}catch(u){M(x(w(n),a),u);continue}d!==null&&r.push(d)}if(i.has("doc")||i.has("roadmap"))for(const a of j(n)){let d;try{d=K(o,s,a)}catch(u){M(a,u);continue}d.source==="roadmap"&&!i.has("roadmap")||d.source==="doc"&&!i.has("doc")||r.push(d)}if(i.has("inbox")&&E(n).forEach((a,d)=>r.push(W(o,s,a,d))),i.has("transcript"))for(const a of R(n))r.push(J(o,s,a));return r}c(In,"nodeArtifacts");function On(n){const e=v().filter(a=>a.cwd===n);let t=0,o=0,i=1/0,s=-1/0;for(const a of e){const d=b(a.created);d>0&&(d<i&&(i=d),d>s&&(s=d));for(const u of N(a.node_id)){t++;const f=u.match(/^([0-9]{8}T[0-9]{6})-/);if(f!==null){const l=b(A(f[1]));l>0&&(l<i&&(i=l),l>s&&(s=l))}}o+=j(a.node_id).length}const r=i!==1/0&&s!==-1/0?{from:new Date(i).toISOString().slice(0,10),to:new Date(s).toISOString().slice(0,10)}:null;return{cwd:n,nodes:e.length,reports:t,docs:o,span:r}}c(On,"corpusStats");export{Sn as MESSAGE_ROLES,wn as ORIGIN_TOKENS,Mn as buildCorpus,nn as callerCwd,On as corpusStats,Dn as groupCorpus,Nn as newestReportRef,In as nodeArtifacts,un as resolveRef};