@north-light/crouter 0.3.318 → 0.3.319

package/dist/core/feed/feed.js

@@ -1,202 +1,7 @@
-// Push engine for the canvas report spine.
-import { existsSync, linkSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { reportsDir, cancelCronsOnWake, getNode } from '../canvas/index.js';
-import { openDb, withCanvasWrite } from '../canvas/db.js';
-import { activateArmedExternalActionDelivery, readExternalActionDelivery } from '../canvas/deliveries.js';
-import { composeNodeOutcomeDocument } from '../runtime/outcome-document.js';
-import { syncDirectory, syncFile } from '../fs-utils.js';
-import { enqueueSubscriberMail } from './messages.js';
-import { operationIdContext } from '../events/operation-id.js';
-export class FinalizationError extends Error {
-    code;
-    reportPath;
-    constructor(code, reportPath) {
-        super(code);
-        this.code = code;
-        this.reportPath = reportPath;
-    }
-}
-function compactTs(d) {
-    const pad = (n, w = 2) => String(n).padStart(w, '0');
-    return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}T${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}${pad(d.getUTCMilliseconds(), 3)}`;
-}
-function stageReport(nodeId, kind, body) {
-    const dir = reportsDir(nodeId);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const now = new Date();
-    const basename = `${compactTs(now)}-${randomUUID().slice(-8)}-${kind}.md`;
-    const finalPath = join(dir, basename);
-    const stagedPath = join(dir, `.${basename}.${randomUUID()}.tmp`);
-    const ts = now.toISOString();
-    writeFileSync(stagedPath, `---\nnode: ${nodeId}\nkind: ${kind}\nts: ${ts}\n---\n${body}`, 'utf8');
-    syncFile(stagedPath);
-    return { finalPath, stagedPath, basename, ts };
-}
-/** Install without replacement. link(2) fails if another writer already owns the name. */
-function install(staged) {
-    let linked = false;
-    try {
-        linkSync(staged.stagedPath, staged.finalPath);
-        linked = true;
-        rmSync(staged.stagedPath, { force: true });
-        syncDirectory(dirname(staged.finalPath));
-    }
-    catch (error) {
-        if (linked)
-            rmSync(staged.finalPath, { force: true });
-        throw error;
-    }
-}
-function firstLine(text, maxLen = 80) {
-    const line = text.split('\n')[0] ?? '';
-    return line.length > maxLen ? `${line.slice(0, maxLen - 1)}…` : line;
-}
-/** Requested update delivery urgency wins; legacy report-kind mapping is the fallback. */
-function tierFor(kind, requestedTier) {
-    return requestedTier ?? (kind === 'urgent' ? 'urgent' : 'normal');
-}
-function outcomeAction(nodeId) {
-    const delivery = readExternalActionDelivery(`node-outcome:${nodeId}`);
-    if (delivery === null)
-        return null;
-    const adapter = delivery.adapter;
-    if (adapter?.adapter !== 'subprocess' || !Array.isArray(adapter.argv) || !adapter.argv.every((entry) => typeof entry === 'string') || typeof adapter.cwd !== 'string') {
-        throw new Error(`outcome delivery ${delivery.deliveryId} has an invalid subprocess adapter`);
-    }
-    return { name: delivery.destinationId, payload: adapter.payload ?? null };
-}
-function enqueueReport(subscribers, from, fromName, kind, requestedTier, reportRef, body, disposition) {
-    return enqueueSubscriberMail(subscribers, {
-        kind,
-        label: firstLine(body),
-        senderNodeId: from,
-        senderName: fromName,
-        bodyRef: reportRef,
-        urgency: tierFor(kind, requestedTier),
-        ...(disposition === undefined ? {} : { disposition }),
-    }).map((delivery) => delivery.destinationNodeId);
-}
-/** Claim the one canonical final while holding SQLite's write lock. */
-function commitCanonicalFinal(nodeId, staged, body, from, fromName, disposition, outcome) {
-    const db = openDb();
-    let installed = false;
-    db.exec('BEGIN IMMEDIATE');
-    try {
-        const row = db.prepare('SELECT status, final_report FROM nodes WHERE node_id = ?').get(nodeId);
-        if (row === undefined)
-            throw new FinalizationError('unknown_node');
-        if (row.final_report !== null)
-            throw new FinalizationError('already_finalized', row.final_report);
-        if (row.status === 'canceled' || row.status === 'dead')
-            throw new FinalizationError('finalization_forbidden');
-        if (row.status !== 'active' && row.status !== 'idle' && row.status !== 'done')
-            throw new FinalizationError('finalization_forbidden');
-        const subscribers = db.prepare(`SELECT from_id AS node_id, active, created FROM edges WHERE type = 'subscribes_to' AND to_id = ? ORDER BY created`).all(nodeId).map((row) => ({ node_id: row['node_id'], active: row['active'] === 1, created: row['created'] }));
-        const node = getNode(nodeId);
-        const recordsOutcome = node?.kind !== 'human';
-        const revision = (node?.outcome_revision ?? 0) + 1;
-        const outcomeKind = outcome?.kind ?? 'result';
-        const outcomeReason = outcome?.reason ?? 'finalized';
-        const outcomeDetailJson = outcome?.detailJson ?? null;
-        const action = node === null ? null : outcomeAction(nodeId);
-        const documentJson = !recordsOutcome || action === null || node === null ? null : JSON.stringify(composeNodeOutcomeDocument({
-            node: { ...node, status: 'done', intent: 'done', terminal_reason: outcomeReason },
-            outcome: { kind: outcomeKind, reason: outcomeReason, at: staged.ts, revision, detailJson: outcomeDetailJson },
-            action,
-            finalReport: staged.basename,
-        }));
-        install(staged);
-        installed = true;
-        if (recordsOutcome) {
-            db.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = ?, final_report = ?, finalized_at = ?, outcome_kind = ?, outcome_reason = ?, outcome_at = ?, outcome_revision = outcome_revision + 1, outcome_detail_json = ? WHERE node_id = ? AND final_report IS NULL").run(outcomeReason, staged.basename, staged.ts, outcomeKind, outcomeReason, staged.ts, outcomeDetailJson, nodeId);
-            if (documentJson !== null)
-                activateArmedExternalActionDelivery(db, {
-                    idempotencyKey: `node-outcome:${nodeId}`,
-                    label: nodeId,
-                    bodyJson: documentJson,
-                    supersede: true,
-                }, Date.now());
-        }
-        else {
-            db.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = 'finalized', final_report = ?, finalized_at = ? WHERE node_id = ? AND final_report IS NULL").run(staged.basename, staged.ts, nodeId);
-        }
-        const deliveredTo = enqueueReport(subscribers, from, fromName, 'final', undefined, `${nodeId}:reports/${staged.basename}`, body, disposition);
-        db.exec('COMMIT');
-        return { deliveredTo };
-    }
-    catch (err) {
-        db.exec('ROLLBACK');
-        if (installed)
-            rmSync(staged.finalPath, { force: true });
-        throw err;
-    }
-    finally {
-        rmSync(staged.stagedPath, { force: true });
-    }
-}
-async function pushWithContext(nodeId, opts) {
-    if (!nodeId)
-        throw new Error(`push: empty nodeId (kind=${opts.kind}) — a report must belong to a node`);
-    if (opts.kind === 'final' && opts.deliveryTier !== undefined)
-        throw new Error('push final does not accept a delivery tier');
-    if (opts.kind !== 'final' && opts.outcome !== undefined)
-        throw new Error('push outcome is final-only');
-    const staged = stageReport(nodeId, opts.kind, opts.body);
-    const from = opts.from ?? nodeId;
-    const fromName = getNode(from)?.name;
-    if (opts.kind === 'final') {
-        const { deliveredTo } = commitCanonicalFinal(nodeId, staged, opts.body, from, fromName, opts.disposition, opts.outcome);
-        // The finalization latch ends every wait this node was holding. It flips the
-        // row to done DIRECTLY (not through lifecycle's `finish` event), so the
-        // deadline cleanup must ride here too: an armed deadline outliving the final
-        // fires an urgent self-message at a finalized node, is refused, and its
-        // on-failure disposition spawns a spurious escalation agent. Only
-        // cancel-on-wake rows anchored here go; standing crons survive. Outside
-        // commitCanonicalFinal's transaction — it takes its own write boundary.
-        cancelCronsOnWake(nodeId);
-        return { reportPath: staged.finalPath, deliveredTo };
-    }
-    let installed = false;
-    try {
-        install(staged);
-        installed = true;
-        const deliveredTo = withCanvasWrite((db) => {
-            const subscribers = db.prepare(`SELECT from_id AS node_id, active, created FROM edges WHERE type = 'subscribes_to' AND to_id = ? ORDER BY created`).all(nodeId).map((row) => ({ node_id: row['node_id'], active: row['active'] === 1, created: row['created'] }));
-            return enqueueReport(subscribers, from, fromName, opts.kind, opts.deliveryTier, `${nodeId}:reports/${staged.basename}`, opts.body, opts.disposition);
-        });
-        return { reportPath: staged.finalPath, deliveredTo };
-    }
-    catch (error) {
-        if (installed)
-            rmSync(staged.finalPath, { force: true });
-        throw error;
-    }
-    finally {
-        rmSync(staged.stagedPath, { force: true });
-    }
-}
-export function push(nodeId, opts) {
-    return operationIdContext.current() === undefined
-        ? operationIdContext.fresh(() => pushWithContext(nodeId, opts))
-        : pushWithContext(nodeId, opts);
-}
-export async function pushUpdate(nodeId, body, opts) {
-    return push(nodeId, { kind: 'update', body, ...opts });
-}
-export async function pushUrgent(nodeId, body, opts) {
-    return push(nodeId, { kind: 'urgent', body, ...opts });
-}
-export async function pushFinal(nodeId, body, opts) {
-    return push(nodeId, { kind: 'final', body, ...opts });
-}
-/** Re-fan a previously committed final to its ticket origin without finalizing again. */
-export function redeliverFinalReport(nodeId, originNodeId, reportBasename, body, opts) {
-    if (reportBasename === '' || reportBasename.includes('/') || reportBasename.includes('\\')) {
-        throw new Error(`invalid canonical final report basename: ${reportBasename}`);
-    }
-    const deliveredTo = enqueueReport([{ node_id: originNodeId, active: true, created: '' }], nodeId, getNode(nodeId)?.name, 'final', undefined, `${nodeId}:reports/${reportBasename}`, body, opts?.disposition);
-    return { reportPath: join(reportsDir(nodeId), reportBasename), deliveredTo };
-}
+var x=Object.defineProperty;var o=(n,e)=>x(n,"name",{value:e,configurable:!0});import{existsSync as N,linkSync as O,mkdirSync as F,rmSync as d,writeFileSync as M}from"node:fs";import{dirname as L,join as y}from"node:path";import{randomUUID as D}from"node:crypto";import{reportsDir as P,cancelCronsOnWake as z,getNode as _}from"../canvas/index.js";import{openDb as W,withCanvasWrite as H}from"../canvas/db.js";import{activateArmedExternalActionDelivery as J,readExternalActionDelivery as K}from"../canvas/deliveries.js";import{composeNodeOutcomeDocument as Y}from"../runtime/outcome-document.js";import{syncDirectory as j,syncFile as q}from"../fs-utils.js";import{enqueueSubscriberMail as G}from"./messages.js";import{operationIdContext as R}from"../events/operation-id.js";class p extends Error{static{o(this,"FinalizationError")}code;reportPath;constructor(e,t){super(e),this.code=e,this.reportPath=t}}function Q(n){const e=o((t,r=2)=>String(t).padStart(r,"0"),"pad");return`${n.getUTCFullYear()}${e(n.getUTCMonth()+1)}${e(n.getUTCDate())}T${e(n.getUTCHours())}${e(n.getUTCMinutes())}${e(n.getUTCSeconds())}${e(n.getUTCMilliseconds(),3)}`}o(Q,"compactTs");function V(n,e,t){const r=P(n);N(r)||F(r,{recursive:!0});const l=new Date,s=`${Q(l)}-${D().slice(-8)}-${e}.md`,c=y(r,s),i=y(r,`.${s}.${D()}.tmp`),u=l.toISOString();return M(i,`---
+node: ${n}
+kind: ${e}
+ts: ${u}
+---
+${t}`,"utf8"),q(i),{finalPath:c,stagedPath:i,basename:s,ts:u}}o(V,"stageReport");function g(n){let e=!1;try{O(n.stagedPath,n.finalPath),e=!0,d(n.stagedPath,{force:!0}),j(L(n.finalPath))}catch(t){throw e&&d(n.finalPath,{force:!0}),t}}o(g,"install");function X(n,e=80){const t=n.split(`
+`)[0]??"";return t.length>e?`${t.slice(0,e-1)}\u2026`:t}o(X,"firstLine");function Z(n,e){return e??(n==="urgent"?"urgent":"normal")}o(Z,"tierFor");function B(n){const e=K(`node-outcome:${n}`);if(e===null)return null;const t=e.adapter;if(t?.adapter!=="subprocess"||!Array.isArray(t.argv)||!t.argv.every(r=>typeof r=="string")||typeof t.cwd!="string")throw new Error(`outcome delivery ${e.deliveryId} has an invalid subprocess adapter`);return{name:e.destinationId,payload:t.payload??null}}o(B,"outcomeAction");function E(n,e,t,r,l,s,c,i){return G(n,{kind:r,label:X(c),senderNodeId:e,senderName:t,bodyRef:s,urgency:Z(r,l),...i===void 0?{}:{disposition:i}}).map(u=>u.destinationNodeId)}o(E,"enqueueReport");function I(n,e,t,r,l,s,c){const i=W();let u=!1;i.exec("BEGIN IMMEDIATE");try{const a=i.prepare("SELECT status, final_report FROM nodes WHERE node_id = ?").get(n);if(a===void 0)throw new p("unknown_node");if(a.final_report!==null)throw new p("already_finalized",a.final_report);if(a.status==="canceled"||a.status==="dead")throw new p("finalization_forbidden");if(a.status!=="active"&&a.status!=="idle"&&a.status!=="done")throw new p("finalization_forbidden");const C=i.prepare("SELECT from_id AS node_id, active, created FROM edges WHERE type = 'subscribes_to' AND to_id = ? ORDER BY created").all(n).map(h=>({node_id:h.node_id,active:h.active===1,created:h.created})),f=_(n),b=f?.kind!=="human",A=(f?.outcome_revision??0)+1,$=c?.kind??"result",m=c?.reason??"finalized",w=c?.detailJson??null,T=f===null?null:B(n),S=!b||T===null||f===null?null:JSON.stringify(Y({node:{...f,status:"done",intent:"done",terminal_reason:m},outcome:{kind:$,reason:m,at:e.ts,revision:A,detailJson:w},action:T,finalReport:e.basename}));g(e),u=!0,b?(i.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = ?, final_report = ?, finalized_at = ?, outcome_kind = ?, outcome_reason = ?, outcome_at = ?, outcome_revision = outcome_revision + 1, outcome_detail_json = ? WHERE node_id = ? AND final_report IS NULL").run(m,e.basename,e.ts,$,m,e.ts,w,n),S!==null&&J(i,{idempotencyKey:`node-outcome:${n}`,label:n,bodyJson:S,supersede:!0},Date.now())):i.prepare("UPDATE nodes SET status = 'done', intent = 'done', terminal_reason = 'finalized', final_report = ?, finalized_at = ? WHERE node_id = ? AND final_report IS NULL").run(e.basename,e.ts,n);const U=E(C,r,l,"final",void 0,`${n}:reports/${e.basename}`,t,s);return i.exec("COMMIT"),{deliveredTo:U}}catch(a){throw i.exec("ROLLBACK"),u&&d(e.finalPath,{force:!0}),a}finally{d(e.stagedPath,{force:!0})}}o(I,"commitCanonicalFinal");async function k(n,e){if(!n)throw new Error(`push: empty nodeId (kind=${e.kind}) \u2014 a report must belong to a node`);if(e.kind==="final"&&e.deliveryTier!==void 0)throw new Error("push final does not accept a delivery tier");if(e.kind!=="final"&&e.outcome!==void 0)throw new Error("push outcome is final-only");const t=V(n,e.kind,e.body),r=e.from??n,l=_(r)?.name;if(e.kind==="final"){const{deliveredTo:c}=I(n,t,e.body,r,l,e.disposition,e.outcome);return z(n),{reportPath:t.finalPath,deliveredTo:c}}let s=!1;try{g(t),s=!0;const c=H(i=>{const u=i.prepare("SELECT from_id AS node_id, active, created FROM edges WHERE type = 'subscribes_to' AND to_id = ? ORDER BY created").all(n).map(a=>({node_id:a.node_id,active:a.active===1,created:a.created}));return E(u,r,l,e.kind,e.deliveryTier,`${n}:reports/${t.basename}`,e.body,e.disposition)});return{reportPath:t.finalPath,deliveredTo:c}}catch(c){throw s&&d(t.finalPath,{force:!0}),c}finally{d(t.stagedPath,{force:!0})}}o(k,"pushWithContext");function v(n,e){return R.current()===void 0?R.fresh(()=>k(n,e)):k(n,e)}o(v,"push");async function de(n,e,t){return v(n,{kind:"update",body:e,...t})}o(de,"pushUpdate");async function fe(n,e,t){return v(n,{kind:"urgent",body:e,...t})}o(fe,"pushUrgent");async function me(n,e,t){return v(n,{kind:"final",body:e,...t})}o(me,"pushFinal");function pe(n,e,t,r,l){if(t===""||t.includes("/")||t.includes("\\"))throw new Error(`invalid canonical final report basename: ${t}`);const s=E([{node_id:e,active:!0,created:""}],n,_(n)?.name,"final",void 0,`${n}:reports/${t}`,r,l?.disposition);return{reportPath:y(P(n),t),deliveredTo:s}}o(pe,"redeliverFinalReport");export{p as FinalizationError,v as push,me as pushFinal,de as pushUpdate,fe as pushUrgent,pe as redeliverFinalReport};

package/dist/core/feed/inbox-migrate.js

@@ -1,135 +1,3 @@
-// One-shot boot migration for pre-cutover inbox state. The strict reader
-// (inbox.ts) requires canonical 32-lowercase-hex entry_id/operation_id on
-// every physical row and an exact-identity cursor; state written before the
-// cutover has rows with no identities at all, UUID-spelled identities, or an
-// ISO-timestamp cursor boundary. The out-of-band cutover driver was supposed
-// to archive that state but never ran on hosts with live canvases, leaving
-// every legacy node's broker crash-looping at inbox seed (WatcherFatalError
-// "inbox poll state is corrupt" → revive → crash, forever). The daemon runs
-// this once at boot, before supervision can revive anything.
-//
-// Identity derivation MUST match the removed lazy-migration path (5a0375b1):
-// the digest is computed over the ORIGINAL physical line, so identities agree
-// with any cursor the lazy reader persisted while it was live.
-import { existsSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { createHash } from 'node:crypto';
-import { inboxPath, nodesRoot } from '../canvas/index.js';
-import { emitEvent } from '../events/emit.js';
-const HEX32 = /^(?!0{32}$)[0-9a-f]{32}$/;
-const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const ISO_CURSOR = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/;
-function legacyIdentity(domain, nodeId, index, line) {
-    return createHash('sha256')
-        .update(`crouter:legacy-inbox:${domain}\0${nodeId}\0${index}\0${line}`)
-        .digest('hex')
-        .slice(0, 32);
-}
-function normalize(domain, nodeId, index, line, value) {
-    if (value === undefined)
-        return legacyIdentity(domain, nodeId, index, line);
-    if (typeof value !== 'string')
-        return undefined;
-    if (HEX32.test(value))
-        return value;
-    if (UUID.test(value))
-        return value.replaceAll('-', '').toLowerCase();
-    return undefined;
-}
-function atomicWrite(path, content) {
-    const tmp = `${path}.tmp`;
-    writeFileSync(tmp, content, 'utf8');
-    renameSync(tmp, path);
-}
-/** Migrate one node's inbox file + cursor sidecar in place. Returns counts of
- *  rewritten entries/cursors; throws only on unreadable/unparseable state the
- *  strict reader could not have consumed either way. */
-function migrateNode(nodeId) {
-    const p = inboxPath(nodeId);
-    const cursorFile = `${p}.cursor`;
-    let rewrittenEntries = 0;
-    let migrated = [];
-    if (existsSync(p)) {
-        const raw = readFileSync(p, 'utf8');
-        if (raw !== '') {
-            const lines = raw.split('\n');
-            if (lines.at(-1) === '')
-                lines.pop();
-            const out = lines.map((line, index) => {
-                const entry = JSON.parse(line);
-                const entryId = normalize('entry', nodeId, index, line, entry.entry_id);
-                const operationId = normalize('operation', nodeId, index, line, entry.operation_id);
-                if (entryId === undefined || operationId === undefined) {
-                    throw new Error(`unmigratable inbox row ${index}: ${String(entry.entry_id)}`);
-                }
-                const changed = entryId !== entry.entry_id || operationId !== entry.operation_id;
-                if (changed)
-                    rewrittenEntries += 1;
-                entry.entry_id = entryId;
-                entry.operation_id = operationId;
-                return { line: changed ? JSON.stringify(entry) : line, ts: entry.ts, entry_id: entryId };
-            });
-            migrated = out;
-            if (rewrittenEntries > 0)
-                atomicWrite(p, out.map((e) => `${e.line}\n`).join(''));
-        }
-    }
-    if (!existsSync(cursorFile))
-        return { entries: rewrittenEntries, cursor: false };
-    const rawCursor = readFileSync(cursorFile, 'utf8').trim();
-    if (rawCursor === '' || HEX32.test(rawCursor))
-        return { entries: rewrittenEntries, cursor: false };
-    if (UUID.test(rawCursor)) {
-        atomicWrite(cursorFile, rawCursor.replaceAll('-', '').toLowerCase());
-        return { entries: rewrittenEntries, cursor: true };
-    }
-    if (ISO_CURSOR.test(rawCursor)) {
-        // Legacy cursors were a timestamp boundary: every row with ts <= boundary
-        // was covered. Map to the exact identity of the last covered row; with no
-        // covered row the cursor is meaningless — remove it (everything unread).
-        let index = -1;
-        for (let i = 0; i < migrated.length; i += 1) {
-            if (migrated[i].ts <= rawCursor)
-                index = i;
-        }
-        if (index < 0)
-            rmSync(cursorFile);
-        else
-            atomicWrite(cursorFile, migrated[index].entry_id);
-        return { entries: rewrittenEntries, cursor: true };
-    }
-    throw new Error(`unrecognized inbox cursor: ${rawCursor.slice(0, 64)}`);
-}
-/** Scan every node dir under the local canvas and migrate legacy inbox state.
- *  Idempotent; a node that fails migration is reported and skipped so one bad
- *  dir cannot block daemon boot (its broker stays crash-faulted, same as
- *  before the migration existed). */
-export function migrateLegacyInboxIdentities() {
-    const summary = { nodes: 0, entries: 0, cursors: 0, failures: 0 };
-    const root = nodesRoot();
-    if (!existsSync(root))
-        return summary;
-    for (const nodeId of readdirSync(root)) {
-        try {
-            if (!statSync(join(root, nodeId)).isDirectory())
-                continue;
-            const { entries, cursor } = migrateNode(nodeId);
-            if (entries > 0 || cursor) {
-                summary.nodes += 1;
-                summary.entries += entries;
-                if (cursor)
-                    summary.cursors += 1;
-            }
-        }
-        catch (error) {
-            summary.failures += 1;
-            emitEvent({
-                level: 'warn',
-                event: 'inbox.migrate.node_failed',
-                node_id: nodeId,
-                error,
-            });
-        }
-    }
-    return summary;
-}
+var h=Object.defineProperty;var d=(r,t)=>h(r,"name",{value:t,configurable:!0});import{existsSync as l,readFileSync as w,readdirSync as x,renameSync as I,rmSync as E,statSync as C,writeFileSync as O}from"node:fs";import{join as F}from"node:path";import{createHash as L}from"node:crypto";import{inboxPath as N,nodesRoot as R}from"../canvas/index.js";import{emitEvent as U}from"../events/emit.js";const S=/^(?!0{32}$)[0-9a-f]{32}$/,_=/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,j=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z$/;function z(r,t,e,n){return L("sha256").update(`crouter:legacy-inbox:${r}\0${t}\0${e}\0${n}`).digest("hex").slice(0,32)}d(z,"legacyIdentity");function b(r,t,e,n,i){if(i===void 0)return z(r,t,e,n);if(typeof i=="string"){if(S.test(i))return i;if(_.test(i))return i.replaceAll("-","").toLowerCase()}}d(b,"normalize");function p(r,t){const e=`${r}.tmp`;O(e,t,"utf8"),I(e,r)}d(p,"atomicWrite");function A(r){const t=N(r),e=`${t}.cursor`;let n=0,i=[];if(l(t)){const f=w(t,"utf8");if(f!==""){const s=f.split(`
+`);s.at(-1)===""&&s.pop();const g=s.map((a,m)=>{const o=JSON.parse(a),u=b("entry",r,m,a,o.entry_id),y=b("operation",r,m,a,o.operation_id);if(u===void 0||y===void 0)throw new Error(`unmigratable inbox row ${m}: ${String(o.entry_id)}`);const $=u!==o.entry_id||y!==o.operation_id;return $&&(n+=1),o.entry_id=u,o.operation_id=y,{line:$?JSON.stringify(o):a,ts:o.ts,entry_id:u}});i=g,n>0&&p(t,g.map(a=>`${a.line}
+`).join(""))}}if(!l(e))return{entries:n,cursor:!1};const c=w(e,"utf8").trim();if(c===""||S.test(c))return{entries:n,cursor:!1};if(_.test(c))return p(e,c.replaceAll("-","").toLowerCase()),{entries:n,cursor:!0};if(j.test(c)){let f=-1;for(let s=0;s<i.length;s+=1)i[s].ts<=c&&(f=s);return f<0?E(e):p(e,i[f].entry_id),{entries:n,cursor:!0}}throw new Error(`unrecognized inbox cursor: ${c.slice(0,64)}`)}d(A,"migrateNode");function X(){const r={nodes:0,entries:0,cursors:0,failures:0},t=R();if(!l(t))return r;for(const e of x(t))try{if(!C(F(t,e)).isDirectory())continue;const{entries:n,cursor:i}=A(e);(n>0||i)&&(r.nodes+=1,r.entries+=n,i&&(r.cursors+=1))}catch(n){r.failures+=1,U({level:"warn",event:"inbox.migrate.node_failed",node_id:e,error:n})}return r}d(X,"migrateLegacyInboxIdentities");export{X as migrateLegacyInboxIdentities};

package/dist/core/feed/inbox.js

@@ -1,122 +1,10 @@
-import { resolveRef } from '../canvas/history.js';
-import { validateOperationId } from '../events/operation-id.js';
-import { formatInboxCard, formatInboxRefInstruction } from '../../shared/generated-context.js';
-import { renderBirthAnnouncementBody } from '../../shared/birth-announcement.js';
-const INBOX_ENTRY_ID = /^(?!0{32}$)[0-9a-f]{32}$/;
-function validateInboxEntryId(value) {
-    if (typeof value !== 'string' || !INBOX_ENTRY_ID.test(value))
-        throw new TypeError('entry_id must be 32 lowercase non-zero hexadecimal characters');
-    return value;
-}
-/** Project the immutable message body and destination-specific urgency into the canonical inbox rendering shape. */
-export function nodeMailEntry(delivery) {
-    const message = delivery.message;
-    return {
-        entry_id: validateInboxEntryId(message.messageId),
-        operation_id: validateOperationId(message.operationId),
-        ts: message.createdAt,
-        from: message.senderNodeId,
-        ...(message.senderName === null ? {} : { from_name: message.senderName }),
-        tier: delivery.urgency,
-        kind: message.kind,
-        ...(message.bodyRef === null ? {} : { ref: message.bodyRef }),
-        label: message.label,
-        ...(message.bodyJson === null ? {} : { data: message.bodyJson }),
-        ...(message.disposition === null ? {} : { disposition: message.disposition }),
-    };
-}
-const BODY_MAX_LINES = 12;
-const BODY_MAX_CHARS = 1000;
-const INLINE_REPORT_MAX_CHARS = 1000;
-/** Clip a body to the bounded preview stored beside a spilled message body. */
-export function clipBody(body) {
-    let text = body;
-    let clipped = false;
-    const lines = text.split('\n');
-    if (lines.length > BODY_MAX_LINES) {
-        text = lines.slice(0, BODY_MAX_LINES).join('\n');
-        clipped = true;
-    }
-    if (text.length > BODY_MAX_CHARS) {
-        text = text.slice(0, BODY_MAX_CHARS);
-        clipped = true;
-    }
-    return { text: text.trimEnd(), clipped };
-}
-function inlineBody(entry) {
-    const body = typeof entry.data?.['body'] === 'string' ? entry.data['body'].trim() : '';
-    return body === '' || body === entry.label ? '' : body;
-}
-function inlineReport(entry) {
-    if (entry.ref === undefined || entry.ref.startsWith('/'))
-        return null;
-    try {
-        const report = resolveRef(entry.ref);
-        if (report?.source !== 'report' || report.path === null || report.body.length >= INLINE_REPORT_MAX_CHARS)
-            return null;
-        return report.body;
-    }
-    catch {
-        return null;
-    }
-}
-function entryBody(entry) {
-    const birth = renderBirthAnnouncementBody(entry.data, entry.ts);
-    if (birth !== null)
-        return birth;
-    const report = inlineReport(entry);
-    if (report !== null)
-        return `${report.trimEnd()}\n\n${formatInboxRefInstruction(entry.ref)}`;
-    const body = inlineBody(entry);
-    if (body === '')
-        return entry.ref === undefined ? entry.label : `${entry.label}\n\n${formatInboxRefInstruction(entry.ref)}`;
-    const { text, clipped } = clipBody(body);
-    if (entry.ref !== undefined)
-        return `${text}\n\n${formatInboxRefInstruction(entry.ref)}`;
-    return clipped ? `${text}\n… (body clipped)` : text;
-}
-function cardEntry(entry) {
-    return {
-        kind: entry.kind,
-        body: entryBody(entry),
-        ...(entry.ref === undefined ? {} : { ref: entry.ref }),
-        ...(entry.disposition === undefined ? {} : { disposition: entry.disposition }),
-    };
-}
-/** Split delivered entries into verbatim human messages and sender-grouped inbox cards. */
-export function coalesce(entries) {
-    if (entries.length === 0)
-        return [];
-    const groups = new Map();
-    for (const entry of entries) {
-        const sender = entry.from ?? 'system';
-        if (!groups.has(sender))
-            groups.set(sender, []);
-        groups.get(sender).push(entry);
-    }
-    const deliveries = [];
-    const sections = [];
-    let cardSlot = -1;
-    for (const [sender, items] of groups) {
-        if (sender === 'human') {
-            for (const entry of items) {
-                const body = inlineBody(entry);
-                deliveries.push({ kind: 'human', text: body === '' ? entry.label : body, entries: [entry] });
-            }
-            continue;
-        }
-        if (cardSlot < 0) {
-            cardSlot = deliveries.length;
-            deliveries.push({ kind: 'card', text: '', entries: [] });
-        }
-        sections.push({ id: sender, entries: items.map(cardEntry) });
-    }
-    if (cardSlot >= 0) {
-        deliveries[cardSlot] = {
-            kind: 'card',
-            text: formatInboxCard(sections),
-            entries: entries.filter((entry) => (entry.from ?? 'system') !== 'human'),
-        };
-    }
-    return deliveries;
-}
+var m=Object.defineProperty;var r=(n,e)=>m(n,"name",{value:e,configurable:!0});import{resolveRef as b}from"../canvas/history.js";import{validateOperationId as h}from"../events/operation-id.js";import{formatInboxCard as I,formatInboxRefInstruction as l}from"../../shared/generated-context.js";import{renderBirthAnnouncementBody as g}from"../../shared/birth-announcement.js";const x=/^(?!0{32}$)[0-9a-f]{32}$/;function _(n){if(typeof n!="string"||!x.test(n))throw new TypeError("entry_id must be 32 lowercase non-zero hexadecimal characters");return n}r(_,"validateInboxEntryId");function w(n){const e=n.message;return{entry_id:_(e.messageId),operation_id:h(e.operationId),ts:e.createdAt,from:e.senderNodeId,...e.senderName===null?{}:{from_name:e.senderName},tier:n.urgency,kind:e.kind,...e.bodyRef===null?{}:{ref:e.bodyRef},label:e.label,...e.bodyJson===null?{}:{data:e.bodyJson},...e.disposition===null?{}:{disposition:e.disposition}}}r(w,"nodeMailEntry");const u=12,a=1e3,y=1e3;function E(n){let e=n,t=!1;const i=e.split(`
+`);return i.length>u&&(e=i.slice(0,u).join(`
+`),t=!0),e.length>a&&(e=e.slice(0,a),t=!0),{text:e.trimEnd(),clipped:t}}r(E,"clipBody");function p(n){const e=typeof n.data?.body=="string"?n.data.body.trim():"";return e===""||e===n.label?"":e}r(p,"inlineBody");function R(n){if(n.ref===void 0||n.ref.startsWith("/"))return null;try{const e=b(n.ref);return e?.source!=="report"||e.path===null||e.body.length>=y?null:e.body}catch{return null}}r(R,"inlineReport");function $(n){const e=g(n.data,n.ts);if(e!==null)return e;const t=R(n);if(t!==null)return`${t.trimEnd()}
+
+${l(n.ref)}`;const i=p(n);if(i==="")return n.ref===void 0?n.label:`${n.label}
+
+${l(n.ref)}`;const{text:s,clipped:o}=E(i);return n.ref!==void 0?`${s}
+
+${l(n.ref)}`:o?`${s}
+\u2026 (body clipped)`:s}r($,"entryBody");function B(n){return{kind:n.kind,body:$(n),...n.ref===void 0?{}:{ref:n.ref},...n.disposition===void 0?{}:{disposition:n.disposition}}}r(B,"cardEntry");function S(n){if(n.length===0)return[];const e=new Map;for(const o of n){const d=o.from??"system";e.has(d)||e.set(d,[]),e.get(d).push(o)}const t=[],i=[];let s=-1;for(const[o,d]of e){if(o==="human"){for(const f of d){const c=p(f);t.push({kind:"human",text:c===""?f.label:c,entries:[f]})}continue}s<0&&(s=t.length,t.push({kind:"card",text:"",entries:[]})),i.push({id:o,entries:d.map(B)})}return s>=0&&(t[s]={kind:"card",text:I(i),entries:n.filter(o=>(o.from??"system")!=="human")}),t}r(S,"coalesce");export{E as clipBody,S as coalesce,w as nodeMailEntry};