@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/canvas/nav-model.js

@@ -1,231 +1 @@
-// nav-model.ts — the canvas-graph half of the nav model for attach's chrome.
-//
-// The PURE render + telemetry helpers (ANSI styling, fillBar/truncate,
-// nodeGlyph, tokensCell, the graph row/fold types, …) live in nav-render.ts and
-// are RE-EXPORTED here so existing importers of nav-model keep working. What
-// stays here is the canvas-db graph layer: getNode/subscriptions walks and the
-// fold/flatten model built over them.
-//
-// Everything is pi-API-free. Per-view interaction state, including ask counts
-// and manual fold overrides, is threaded through parameters (see `asks` and
-// `FoldState`) so this layer owns no singletons and each consumer keeps its own
-// state.
-import { getNode, subscribersOf, subscriptionsOf } from './index.js';
-import { faultSummary } from './status-glyph.js';
-import { statusRank } from './node-order.js';
-import { nodeGlyph, navLabel, shortId, tokensCell, activityCell, cycleBadge, askBadge, liveBelowBadge, truncate, fillBar, fillWidth, isAttached, BOLD, DIM, RESET, REVERSE, BG_ATTACHED, } from './nav-render.js';
-// Re-export the pure render/telemetry half so existing nav-model importers
-// (chrome/canvas-panels, overlays/graph, resume) keep resolving these here.
-export { PI_MAX_WIDGET_LINES, VIEWPORT_FALLBACK_ROWS, ESC, RESET, BOLD, DIM, REVERSE, BG_ATTACHED, GREEN, RED, YELLOW, CYAN, GRAY, nodeGlyph, visibleWidth, truncate, fillWidth, fillBar, readTelemetry, fmtTokens, tokensCell, activityCell, cycleBadge, navLabel, shortId, askBadge, liveBelowBadge, isAttached, hasBrokerViewers, fetchAsksMap, graphWidgetBudget, GRAPH_HINT, } from './nav-render.js';
-// Read primitives — UNCACHED, deliberately
-//
-// These once memoized into module-global Maps that a `beginFrame()` cleared at
-// the top of each TUI render. That cache is gone. Nothing in this module is
-// frame-scoped any more: the GRAPH overlay reads the canvas through crtrd's
-// remote CanvasSource (clients/attach/overlays/graph.ts) and never imports this
-// file, while the one live consumer left — crtrd's `GET /v1/nodes?under=` via
-// `subtreeIds` — is a daemon that runs for HOURS between restarts.
-//
-// A process-lifetime memo there is not "at worst one frame stale", it is
-// permanent: the first `?under=X` request that lands before X has spawned any
-// children pinned `[]` under X and every later request returned it. Correctness
-// on the daemon outranks a render amortization no caller asks for, so each read
-// goes straight to the canvas db. The only frame cache still in play is
-// nav-render's telemetry memo, whose TUI callers clear it themselves via
-// `beginFrameTelem()`.
-/** subscriptionsOf (a node's reports); an unreadable row reads as no edges. */
-function subsOf(id) {
-    try {
-        return subscriptionsOf(id);
-    }
-    catch {
-        return [];
-    }
-}
-/** subscribersOf (a node's managers); an unreadable row reads as no edges. */
-function mgrsOf(id) {
-    try {
-        return subscribersOf(id);
-    }
-    catch {
-        return [];
-    }
-}
-// Attachment — is a human currently WATCHING a node? A separate axis from
-// running (status 'active' = the engine is live on its detached broker, watched
-// or not). Two signals:
-//   viewer pane — a `focuses` row points at the node (one cheap sqlite read per
-//                 render pass; pane-existence alone is NOT the signal).
-//   broker      — the broker persists its helloed-viewer count (tmux panes AND
-//                 web tabs) to job/attach.json on every viewer change
-//                 (src/core/runtime/broker.ts). Trusted only while the node is
-//                 'active': a broker crash can leave a stale file.
-// Graph queries (dependency-free, straight off the canvas db)
-/** First manager (by created) — the UP step for the ancestry spine. */
-export function managerOf(id) {
-    return mgrsOf(id)[0]?.node_id;
-}
-/** A kind:'human' node is a control-plane ASK (a page on the human's
- *  screen), NOT a pi conversation — it has no session, so focusing/reviving it
- *  boots a confused blank "you have been revived" pi. Its pending-ask signal
- *  already rides the ⚑ badge on the ASKING node (attention.ts follows the
- *  bridge node's parent relation), so the row carries no signal of its
- *  own. Drop it from every navigable list (the tree, BASE reports, child counts,
- *  subtree expansion) so it can never be selected. */
-export function isHumanAsk(id) {
-    return getNode(id)?.kind === 'human';
-}
-/** A node's direct children that are navigable conversations — human-ask nodes
- *  dropped. The one place the nav chrome enumerates children. */
-export function convoChildIds(id) {
-    return subsOf(id).map((s) => s.node_id).filter((cid) => !isHumanAsk(cid));
-}
-/** Live reports (active|idle) of a node — the DOWN set in BASE. */
-export function liveReports(id) {
-    return convoChildIds(id).filter((cid) => {
-        const st = getNode(cid)?.status;
-        return st === 'active' || st === 'idle';
-    });
-}
-/** Direct navigable children — used for the ⤳ badge (human-ask nodes excluded,
- *  so the count matches what the tree actually shows). */
-export function childCount(id) {
-    return convoChildIds(id).length;
-}
-/** Climb first-manager edges from `self` to the ancestry root (cycle-guarded). */
-export function climbRoot(self) {
-    let cur = self;
-    const seen = new Set([cur]);
-    for (;;) {
-        const mgr = managerOf(cur);
-        if (mgr === undefined || seen.has(mgr))
-            break;
-        seen.add(mgr);
-        cur = mgr;
-    }
-    return cur;
-}
-/** Space-joined ids of a node's subtree (cursor-relative {subtree} var). */
-export function subtreeIds(root) {
-    const out = [];
-    const seen = new Set([root]);
-    const q = convoChildIds(root);
-    while (q.length > 0) {
-        const id = q.shift();
-        if (seen.has(id))
-            continue;
-        seen.add(id);
-        out.push(id);
-        for (const cid of convoChildIds(id))
-            if (!seen.has(cid))
-                q.push(cid);
-    }
-    return out;
-}
-// Shared cell builders
-/** ⤳M direct-children badge — the single child-count signal, shown on any row
- *  with navigable children (folded or not). In GRAPH the ▸ caret separately marks
- *  a collapsed row, so this stays a pure count and never doubles as a fold badge. */
-export function childBadge(node) {
-    if (node === null)
-        return '';
-    const m = childCount(node.node_id);
-    return m > 0 ? ` ${DIM}⤳${m}${RESET}` : '';
-}
-/** Direct children, live-first — the sibling order used both when flattening
- *  the tree and when stepping into a subtree (`l`). Array.sort is stable, so
- *  equal-status siblings keep their creation order. */
-export function sortedChildIds(id) {
-    return convoChildIds(id).sort((a, b) => statusRank(getNode(a)?.status) - statusRank(getNode(b)?.status));
-}
-// GRAPH model — flatten the local graph fold-aware. Rebuilt every render (cheap
-// sqlite reads) so a finished child / new spawn shows live; the manual fold
-// overrides and the cursor id are the only persisted state.
-export function computeSubtreeActivity(root, self) {
-    const expand = new Set();
-    const activeBelow = new Map();
-    const seen = new Set();
-    // Returns the count of active nodes in subtree(id) INCLUDING id, and whether
-    // that subtree is worth revealing (holds an active node or self).
-    const visit = (id) => {
-        const selfActive = getNode(id)?.status === 'active';
-        if (seen.has(id))
-            return { active: selfActive ? 1 : 0, reveal: selfActive || id === self };
-        seen.add(id);
-        let below = 0;
-        let childReveal = false;
-        for (const c of convoChildIds(id)) {
-            const r = visit(c);
-            below += r.active;
-            if (r.reveal)
-                childReveal = true;
-        }
-        activeBelow.set(id, below);
-        if (childReveal)
-            expand.add(id); // a descendant is worth revealing → unfold id
-        return { active: below + (selfActive ? 1 : 0), reveal: childReveal || selfActive || id === self };
-    };
-    visit(root);
-    return { expand, activeBelow };
-}
-/** Fold policy alone — thin wrapper over computeSubtreeActivity for the keypress
- *  path (buildGraphModel without a precomputed set). The render path computes the
- *  activity once and threads `expand` in, so it never recomputes here. */
-export function computeDefaultExpanded(root, self) {
-    return computeSubtreeActivity(root, self).expand;
-}
-export function buildGraphModel(self, folds, expand) {
-    const rootId = climbRoot(self);
-    const defaultExpanded = expand ?? computeDefaultExpanded(rootId, self);
-    // userExpanded / userCollapsed override the auto policy; absent → policy decides.
-    const isFolded = (id) => folds.userExpanded.has(id) ? false : folds.userCollapsed.has(id) ? true : !defaultExpanded.has(id);
-    const rows = [];
-    const visited = new Set();
-    const walk = (id, prefix, isRoot, isLast) => {
-        if (visited.has(id)) {
-            const connector = isRoot ? '' : isLast ? '└─ ' : '├─ ';
-            rows.push({ id, hasKids: false, isSelf: id === self, branch: prefix + connector, cycle: true, collapsed: false });
-            return;
-        }
-        visited.add(id);
-        const kids = sortedChildIds(id);
-        const folded = isFolded(id);
-        const connector = isRoot ? '' : isLast ? '└─ ' : '├─ ';
-        rows.push({ id, hasKids: kids.length > 0, isSelf: id === self, branch: prefix + connector, cycle: false, collapsed: folded });
-        if (folded)
-            return; // folded — don't descend
-        const childPrefix = isRoot ? '' : prefix + (isLast ? '   ' : '│  ');
-        for (let i = 0; i < kids.length; i++)
-            walk(kids[i], childPrefix, false, i === kids.length - 1);
-    };
-    walk(rootId, '', true, true);
-    return rows;
-}
-/** Render one GRAPH row. CURSOR (selected) → reverse-video bar; an ATTACHED
- *  (human-watched) node → a coloured background bar; SELF → bold name. The
- *  cursor outranks the attached tint when both land on the same row. The
- *  overlay-aware glyph alone carries the live signal (status / ⟳ / ⚠). */
-export function renderGraphRow(r, isCursor, focused, activeBelow, asks) {
-    const wrap = (line, attached) => isCursor ? fillBar(line, fillWidth(), REVERSE)
-        : attached ? fillBar(line, fillWidth(), BG_ATTACHED)
-            : truncate(line);
-    if (r.cycle) {
-        const line = `${r.branch}  ${DIM}↺ ${shortId(r.id)}${RESET}`;
-        return wrap(line, false);
-    }
-    const node = getNode(r.id);
-    const dot = nodeGlyph(node);
-    const rawName = navLabel(node, r.id);
-    const name = r.isSelf ? `${BOLD}${rawName}${RESET}` : rawName;
-    const kind = `${DIM}${node?.kind ?? ''}${RESET}`;
-    const tokens = `${DIM}${tokensCell(r.id)}${RESET}`;
-    // ▸ marks an expandable (collapsed-with-kids) row. The cursor row gets no
-    // caret — its reverse-video bar already distinguishes it — so the triangle
-    // reads purely as "this unfolds".
-    const expandable = r.hasKids && r.collapsed;
-    const caret = !isCursor && expandable ? `${DIM}▸${RESET} ` : '  ';
-    const fault = node?.fault ?? null;
-    const faultSuffix = fault !== null ? ` · ${faultSummary(fault)}` : '';
-    const line = `${r.branch}${caret}${dot} ${name} ${kind} ${tokens}${cycleBadge(node)}${childBadge(node)}${liveBelowBadge(node, activeBelow)}${askBadge(r.id, asks)}${activityCell(r.id, node)}${faultSuffix}`;
-    return wrap(line, isAttached(r.id, node, focused));
-}
+var R=Object.defineProperty;var o=(t,e)=>R(t,"name",{value:e,configurable:!0});import{getNode as $,subscribersOf as y,subscriptionsOf as I}from"./index.js";import{faultSummary as C}from"./status-glyph.js";import{statusRank as S}from"./node-order.js";import{nodeGlyph as T,navLabel as _,shortId as G,tokensCell as O,activityCell as D,cycleBadge as W,askBadge as L,liveBelowBadge as M,truncate as N,fillBar as w,fillWidth as k,isAttached as H,BOLD as K,DIM as g,RESET as m,REVERSE as P,BG_ATTACHED as V}from"./nav-render.js";import{PI_MAX_WIDGET_LINES as dt,VIEWPORT_FALLBACK_ROWS as ft,ESC as ht,RESET as pt,BOLD as $t,DIM as mt,REVERSE as vt,BG_ATTACHED as Et,GREEN as xt,RED as gt,YELLOW as Bt,CYAN as bt,GRAY as St,nodeGlyph as wt,visibleWidth as kt,truncate as At,fillWidth as Rt,fillBar as yt,readTelemetry as It,fmtTokens as Ct,tokensCell as Tt,activityCell as _t,cycleBadge as Gt,navLabel as Ot,shortId as Dt,askBadge as Wt,liveBelowBadge as Lt,isAttached as Mt,hasBrokerViewers as Nt,fetchAsksMap as Ht,graphWidgetBudget as Kt,GRAPH_HINT as Pt}from"./nav-render.js";function Y(t){try{return I(t)}catch{return[]}}o(Y,"subsOf");function F(t){try{return y(t)}catch{return[]}}o(F,"mgrsOf");function q(t){return F(t)[0]?.node_id}o(q,"managerOf");function X(t){return $(t)?.kind==="human"}o(X,"isHumanAsk");function v(t){return Y(t).map(e=>e.node_id).filter(e=>!X(e))}o(v,"convoChildIds");function rt(t){return v(t).filter(e=>{const s=$(e)?.status;return s==="active"||s==="idle"})}o(rt,"liveReports");function j(t){return v(t).length}o(j,"childCount");function z(t){let e=t;const s=new Set([e]);for(;;){const c=q(e);if(c===void 0||s.has(c))break;s.add(c),e=c}return e}o(z,"climbRoot");function ct(t){const e=[],s=new Set([t]),c=v(t);for(;c.length>0;){const l=c.shift();if(!s.has(l)){s.add(l),e.push(l);for(const i of v(l))s.has(i)||c.push(i)}}return e}o(ct,"subtreeIds");function J(t){if(t===null)return"";const e=j(t.node_id);return e>0?` ${g}\u2933${e}${m}`:""}o(J,"childBadge");function Q(t){return v(t).sort((e,s)=>S($(e)?.status)-S($(s)?.status))}o(Q,"sortedChildIds");function U(t,e){const s=new Set,c=new Map,l=new Set,i=o(n=>{const u=$(n)?.status==="active";if(l.has(n))return{active:u?1:0,reveal:u||n===e};l.add(n);let d=0,r=!1;for(const h of v(n)){const f=i(h);d+=f.active,f.reveal&&(r=!0)}return c.set(n,d),r&&s.add(n),{active:d+(u?1:0),reveal:r||u||n===e}},"visit");return i(t),{expand:s,activeBelow:c}}o(U,"computeSubtreeActivity");function Z(t,e){return U(t,e).expand}o(Z,"computeDefaultExpanded");function at(t,e,s){const c=z(t),l=s??Z(c,t),i=o(r=>e.userExpanded.has(r)?!1:e.userCollapsed.has(r)?!0:!l.has(r),"isFolded"),n=[],u=new Set,d=o((r,h,f,E)=>{if(u.has(r)){const a=f?"":E?"\u2514\u2500 ":"\u251C\u2500 ";n.push({id:r,hasKids:!1,isSelf:r===t,branch:h+a,cycle:!0,collapsed:!1});return}u.add(r);const p=Q(r),x=i(r),B=f?"":E?"\u2514\u2500 ":"\u251C\u2500 ";if(n.push({id:r,hasKids:p.length>0,isSelf:r===t,branch:h+B,cycle:!1,collapsed:x}),x)return;const b=f?"":h+(E?"   ":"\u2502  ");for(let a=0;a<p.length;a++)d(p[a],b,!1,a===p.length-1)},"walk");return d(c,"",!0,!0),n}o(at,"buildGraphModel");function lt(t,e,s,c,l){const i=o((a,A)=>e?w(a,k(),P):A?w(a,k(),V):N(a),"wrap");if(t.cycle){const a=`${t.branch}  ${g}\u21BA ${G(t.id)}${m}`;return i(a,!1)}const n=$(t.id),u=T(n),d=_(n,t.id),r=t.isSelf?`${K}${d}${m}`:d,h=`${g}${n?.kind??""}${m}`,f=`${g}${O(t.id)}${m}`,E=t.hasKids&&t.collapsed,p=!e&&E?`${g}\u25B8${m} `:"  ",x=n?.fault??null,B=x!==null?` \xB7 ${C(x)}`:"",b=`${t.branch}${p}${u} ${r} ${h} ${f}${W(n)}${J(n)}${M(n,c)}${L(t.id,l)}${D(t.id,n)}${B}`;return i(b,H(t.id,n,s))}o(lt,"renderGraphRow");export{Et as BG_ATTACHED,$t as BOLD,bt as CYAN,mt as DIM,ht as ESC,Pt as GRAPH_HINT,St as GRAY,xt as GREEN,dt as PI_MAX_WIDGET_LINES,gt as RED,pt as RESET,vt as REVERSE,ft as VIEWPORT_FALLBACK_ROWS,Bt as YELLOW,_t as activityCell,Wt as askBadge,at as buildGraphModel,J as childBadge,j as childCount,z as climbRoot,Z as computeDefaultExpanded,U as computeSubtreeActivity,v as convoChildIds,Gt as cycleBadge,Ht as fetchAsksMap,yt as fillBar,Rt as fillWidth,Ct as fmtTokens,Kt as graphWidgetBudget,Nt as hasBrokerViewers,Mt as isAttached,X as isHumanAsk,Lt as liveBelowBadge,rt as liveReports,q as managerOf,Ot as navLabel,wt as nodeGlyph,It as readTelemetry,lt as renderGraphRow,Dt as shortId,Q as sortedChildIds,ct as subtreeIds,Tt as tokensCell,At as truncate,kt as visibleWidth};

package/dist/core/canvas/nav-render.js

@@ -1,260 +1 @@
-// nav-render.ts — the PURE render + telemetry half of the nav model.
-//
-// Everything here is canvas-db-free: it reads node telemetry (job/telemetry.json,
-// attach.json — pure `jobDir` fs reads) plus the fault/streaming fields already
-// projected onto the node row, and produces ANSI-styled strings. No `getNode`/`subscriptionsOf`/`listFocuses` — the
-// graph-walking half lives in nav-model.ts (which re-exports these helpers for its
-// own callers). This split lets the attach viewer's pure chrome pull render helpers
-// without dragging the canvas state-store into its bundle.
-import { execFileSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { jobDir } from './paths.js';
-import { isFrozenRow, resolveNodeVisual } from './status-glyph.js';
-// Tuning constants
-/** pi's InteractiveMode.MAX_WIDGET_LINES — the hard cap on lines in a string
- *  array widget; anything beyond it pi truncates with its own "... (widget
- *  truncated)". Our GRAPH viewport stays at/under this and scrolls internally. */
-export const PI_MAX_WIDGET_LINES = 10;
-export const VIEWPORT_FALLBACK_ROWS = 30;
-// ANSI styling. pi renders embedded escapes in widget lines and measures width
-// ANSI-aware, so raw escapes are safe and need no pi-tui dependency. The cursor
-// (selected row) uses a theme-agnostic ATTRIBUTE (reverse), so it reads under
-// NO_COLOR; the attached-row tint is a background COLOUR, while the overlay-
-// aware glyph (●/○/✓/✗/⟳/⚠) carries the live signal independently, even where
-// colour is stripped.
-export const ESC = '\x1b[';
-export const RESET = `${ESC}0m`;
-export const BOLD = `${ESC}1m`;
-export const DIM = `${ESC}2m`;
-export const REVERSE = `${ESC}7m`;
-/** Dark-green background bar marking an ATTACHED node (a human is currently
- *  watching it) — distinct from the cursor's reverse-video bar; chosen so
- *  default-fg text stays readable. */
-export const BG_ATTACHED = `${ESC}48;5;22m`;
-export const GREEN = `${ESC}32m`;
-export const RED = `${ESC}31m`;
-export const YELLOW = `${ESC}33m`;
-export const CYAN = `${ESC}36m`;
-export const GRAY = `${ESC}90m`;
-function streamingFor(node) {
-    if (node.status !== 'active' && node.status !== 'idle')
-        return false;
-    // The projected field is the live execution's open turn AND-ed with broker-pid
-    // liveness, so a witness left by a crashed pi reads false.
-    return node.streaming === true;
-}
-/** Overlay-aware glyph for a node: hanging ⚠ outranks streaming ⟳, which
- *  outranks the base status glyph. Every input is a projected row field — the
- *  owning daemon computed `fault`/`streaming` — so this holds for a remote node
- *  too, with no local read keyed on a node id that may collide. */
-export function nodeGlyph(node) {
-    if (node === null)
-        return '?';
-    const v = resolveNodeVisual(node.status, {
-        streaming: streamingFor(node),
-        frozen: isFrozenRow(node),
-        hanging: node.fault ?? null,
-    });
-    return `${ESC}${v.color}m${v.glyph}${RESET}`;
-}
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-/** Drop every SGR sequence, keeping the visible text. The selection bar uses
- *  this: reverse-video INVERTS a coloured cell into a coloured block, so a row
- *  built from tinted spans highlights as a patchwork of background swatches
- *  instead of one bar. Stripping colour first leaves a single clean bar — the
- *  glyphs (●/○/✓/✗/⚙/◷) still carry the signal, exactly as under NO_COLOR. */
-export function stripSgr(s) {
-    return s.replace(ANSI_RE, '');
-}
-/** Visible width, ignoring ANSI escapes. */
-export function visibleWidth(s) {
-    return s.replace(ANSI_RE, '').length;
-}
-/** Truncate to `max` VISIBLE columns: escape sequences are copied through
- *  verbatim (so a cut never lands mid-escape) and the result always ends in
- *  RESET, so a clipped style can't bleed into the editor below. */
-export function truncate(s, max = fillWidth()) {
-    if (visibleWidth(s) <= max)
-        return s;
-    let out = '';
-    let w = 0;
-    let i = 0;
-    while (i < s.length && w < max - 1) {
-        if (s[i] === '\x1b') {
-            const m = /^\x1b\[[0-9;]*m/.exec(s.slice(i));
-            if (m) {
-                out += m[0];
-                i += m[0].length;
-                continue;
-            }
-        }
-        out += s[i];
-        w++;
-        i++;
-    }
-    return `${out}…${RESET}`;
-}
-/** Visible columns available to ONE widget line — the cap for every line we
- *  emit, and the width a full-width reverse-video SELF bar fills to.
- *
- *  pi does NOT clip widget lines; it WRAPS them. Each string line is wrapped in
- *  a `Text(paddingX = 1)` inside a full-terminal-width container, so the usable
- *  content width is `columns - 2` (a 1-col margin on each side). A line wider
- *  than that wraps, and the overflow spills onto a second row as a stray
- *  reverse-video block (the bug this guards against). Clamp to `columns - 2`. */
-export function fillWidth() {
-    return Math.max(20, Math.min((process.stdout.columns ?? 80) - 2, 180));
-}
-/** Wrap `content` in a full-width background bar opened by `open` (REVERSE for
- *  the cursor, BG_ATTACHED for a human-watched node). `open` is re-asserted after every
- *  embedded RESET so a coloured cell (the status dot) can't punch a hole in the
- *  bar; the visible width is padded out to `width`; the line closes with a real
- *  RESET so the style never bleeds into the editor below. */
-export function fillBar(content, width, open) {
-    const clipped = truncate(content, width);
-    const reasserted = clipped.replace(/\x1b\[0m/g, `${RESET}${open}`);
-    const pad = Math.max(0, width - visibleWidth(clipped));
-    return `${open}${reasserted}${' '.repeat(pad)}${RESET}`;
-}
-// Per-frame telemetry cache. Its callers are TUI render passes ONLY (the GRAPH
-// overlay and the canvas panels), each of which calls beginFrameTelem() at the
-// top of the pass, so token/activity cells read fresh once per frame instead of
-// once per row and a stale entry can at worst be one frame old. Never memoize a
-// canvas read for a caller that is not a render pass: crtrd lives for hours, and
-// a memo it never clears is permanent, not per-frame.
-const frameTelem = new Map();
-/** Clear the per-frame telemetry cache. Every render pass calls this first, so
- *  one keystroke re-reads each node's telemetry exactly once. */
-export function beginFrameTelem() {
-    frameTelem.clear();
-}
-export function readTelemetry(nodeId) {
-    const hit = frameTelem.get(nodeId);
-    if (hit !== undefined)
-        return hit;
-    let v;
-    try {
-        const p = join(jobDir(nodeId), 'telemetry.json');
-        v = existsSync(p) ? JSON.parse(readFileSync(p, 'utf8')) : {};
-    }
-    catch {
-        v = {};
-    }
-    frameTelem.set(nodeId, v);
-    return v;
-}
-export function fmtTokens(n) {
-    return n < 1_000 ? `${n}` : `${Math.round(n / 1_000)}k`;
-}
-/** The context-window cell — live window fill rounded to the nearest 1k (the same
- *  figure pi's footer shows), NOT a per-turn token delta. `remote` skips the local
- *  `telemetry.json` read entirely and reports 0 (a remote node id may collide
- *  with a local one). */
-export function tokensCell(id, remote = false) {
-    return fmtTokens(remote ? 0 : (readTelemetry(id).context_tokens ?? 0));
-}
-/** Dimmed live "what is it doing" cue for an ACTIVE node — the last tool it ran.
- *  Empty for non-active rows (stale once a node parks) and when none is recorded.
- *  `remote` skips the local `telemetry.json` read entirely and reports empty. */
-export function activityCell(id, node, remote = false) {
-    if (remote)
-        return '';
-    if (node?.status !== 'active')
-        return '';
-    const a = (readTelemetry(id).last_activity ?? '').trim();
-    return a === '' ? '' : ` ${DIM}· ${a}${RESET}`;
-}
-/** Revive-count badge (meta.cycles). Hidden on the first cycle (0) to cut noise. */
-export function cycleBadge(node) {
-    const c = node?.cycles ?? 0;
-    return c > 0 ? ` ${DIM}⟳${c}${RESET}` : '';
-}
-/** Short on-screen label: the explicit handle when set, else the pi-generated
- *  description, else the bare name. fullName joins BOTH (`handle description`);
- *  the nav chrome shows just the first so rows stay compact. */
-export function navLabel(node, id) {
-    if (node === null)
-        return shortId(id);
-    const handle = node.name && node.name !== node.kind ? node.name : '';
-    if (handle !== '')
-        return handle;
-    const desc = (node.description ?? '').trim();
-    return desc !== '' ? desc : node.name;
-}
-export function shortId(id) {
-    return id.slice(0, 8);
-}
-/** True when a human is watching `id` right now via the broker viewer count
- *  (attach.json). The tmux-focus axis (a `focuses` row) is a canvas-db read and
- *  stays in nav-model's `isAttached`, which ORs this signal with the focus set.
- *  `remote` skips the local `attach.json` read entirely and reports false (a
- *  remote node id may collide with a local one). */
-export function hasBrokerViewers(id, node, remote = false) {
-    if (remote)
-        return false;
-    if (node?.status !== 'active')
-        return false; // stale attach.json from a crash
-    try {
-        const p = join(jobDir(id), 'attach.json');
-        if (!existsSync(p))
-            return false;
-        const rec = JSON.parse(readFileSync(p, 'utf8'));
-        return typeof rec.viewers === 'number' && rec.viewers > 0;
-    }
-    catch {
-        return false;
-    }
-}
-/** True when a human is watching `id` right now (tmux focus or broker viewer).
- *  `focused` is the tmux-focus set (a canvas-db read the caller supplies). The
- *  broker-viewer half is a pure `attach.json` read. `remote` skips the local read
- *  entirely and reports false (a remote node id may collide with a local one). */
-export function isAttached(id, node, focused, remote = false) {
-    if (remote)
-        return false;
-    if (focused.has(id))
-        return true;
-    return hasBrokerViewers(id, node, remote);
-}
-/** ⚑K pending-asks badge for a node, read from the supplied per-node ask map. */
-export function askBadge(id, asks) {
-    const k = asks[id] ?? 0;
-    return k > 0 ? ` ${YELLOW}⚑${k}${RESET}` : '';
-}
-/** "Live work below" badge — green ⇣N when this node is NOT itself active but has
- *  N active descendants. The one signal that an idle/parked node isn't dead: real
- *  work is still running beneath it. Count comes from the single subtree-activity
- *  pass (no per-row walk). Suppressed on active rows (their own ● already says so). */
-export function liveBelowBadge(node, activeBelow) {
-    if (node === null || node.status === 'active')
-        return '';
-    const n = activeBelow.get(node.node_id) ?? 0;
-    return n > 0 ? ` ${GREEN}⇣${n}${RESET}` : '';
-}
-// Per-node ask counts — ONE shell-out per poll. `crtr canvas attention map`
-// buckets a whole sub-DAG's pending asks by node in a single process, so the
-// timer stays cheap (< 2 s) regardless of how many nodes are visible. --json
-// gives a parseable {counts} blob (the default render is XML chrome).
-export function fetchAsksMap(rootId) {
-    try {
-        const raw = execFileSync('crtr', ['canvas', 'attention', 'map', '--view', rootId, '--json'], {
-            timeout: 2_500,
-            encoding: 'utf8',
-        });
-        const parsed = JSON.parse(raw.trim());
-        return parsed.counts ?? {};
-    }
-    catch {
-        return {};
-    }
-}
-/** Total lines the GRAPH widget may emit. pi hard-caps extension widgets at
- *  MAX_WIDGET_LINES — anything past that pi truncates itself, eating our own
- *  scroll chrome — so never exceed it (and shrink on a very short terminal).
- *  The viewport scrolls WITHIN this cap as the cursor moves. */
-export function graphWidgetBudget() {
-    const rows = process.stdout.rows ?? VIEWPORT_FALLBACK_ROWS;
-    return Math.max(4, Math.min(PI_MAX_WIDGET_LINES, rows - 4));
-}
-export const GRAPH_HINT = `${DIM}jk move · hl fold · ↵ focus · e expand · x kill · m mgr · esc${RESET}`;
+var v=Object.defineProperty;var n=(t,e)=>v(t,"name",{value:e,configurable:!0});import{execFileSync as y}from"node:child_process";import{existsSync as f,readFileSync as p}from"node:fs";import{join as m}from"node:path";import{jobDir as x}from"./paths.js";import{isFrozenRow as E,resolveNodeVisual as _}from"./status-glyph.js";const d=10,S=30,c="\x1B[",i=`${c}0m`,D=`${c}1m`,a=`${c}2m`,F=`${c}7m`,G=`${c}48;5;22m`,k=`${c}32m`,I=`${c}31m`,w=`${c}33m`,V=`${c}36m`,H=`${c}90m`;function A(t){return t.status!=="active"&&t.status!=="idle"?!1:t.streaming===!0}n(A,"streamingFor");function J(t){if(t===null)return"?";const e=_(t.status,{streaming:A(t),frozen:E(t),hanging:t.fault??null});return`${c}${e.color}m${e.glyph}${i}`}n(J,"nodeGlyph");const $=/\x1b\[[0-9;]*m/g;function P(t){return t.replace($,"")}n(P,"stripSgr");function h(t){return t.replace($,"").length}n(h,"visibleWidth");function R(t,e=b()){if(h(t)<=e)return t;let r="",o=0,s=0;for(;s<t.length&&o<e-1;){if(t[s]==="\x1B"){const u=/^\x1b\[[0-9;]*m/.exec(t.slice(s));if(u){r+=u[0],s+=u[0].length;continue}}r+=t[s],o++,s++}return`${r}\u2026${i}`}n(R,"truncate");function b(){return Math.max(20,Math.min((process.stdout.columns??80)-2,180))}n(b,"fillWidth");function Y(t,e,r){const o=R(t,e),s=o.replace(/\x1b\[0m/g,`${i}${r}`),u=Math.max(0,e-h(o));return`${r}${s}${" ".repeat(u)}${i}`}n(Y,"fillBar");const l=new Map;function z(){l.clear()}n(z,"beginFrameTelem");function g(t){const e=l.get(t);if(e!==void 0)return e;let r;try{const o=m(x(t),"telemetry.json");r=f(o)?JSON.parse(p(o,"utf8")):{}}catch{r={}}return l.set(t,r),r}n(g,"readTelemetry");function B(t){return t<1e3?`${t}`:`${Math.round(t/1e3)}k`}n(B,"fmtTokens");function K(t,e=!1){return B(e?0:g(t).context_tokens??0)}n(K,"tokensCell");function X(t,e,r=!1){if(r||e?.status!=="active")return"";const o=(g(t).last_activity??"").trim();return o===""?"":` ${a}\xB7 ${o}${i}`}n(X,"activityCell");function q(t){const e=t?.cycles??0;return e>0?` ${a}\u27F3${e}${i}`:""}n(q,"cycleBadge");function Q(t,e){if(t===null)return M(e);const r=t.name&&t.name!==t.kind?t.name:"";if(r!=="")return r;const o=(t.description??"").trim();return o!==""?o:t.name}n(Q,"navLabel");function M(t){return t.slice(0,8)}n(M,"shortId");function T(t,e,r=!1){if(r||e?.status!=="active")return!1;try{const o=m(x(t),"attach.json");if(!f(o))return!1;const s=JSON.parse(p(o,"utf8"));return typeof s.viewers=="number"&&s.viewers>0}catch{return!1}}n(T,"hasBrokerViewers");function U(t,e,r,o=!1){return o?!1:r.has(t)?!0:T(t,e,o)}n(U,"isAttached");function Z(t,e){const r=e[t]??0;return r>0?` ${w}\u2691${r}${i}`:""}n(Z,"askBadge");function tt(t,e){if(t===null||t.status==="active")return"";const r=e.get(t.node_id)??0;return r>0?` ${k}\u21E3${r}${i}`:""}n(tt,"liveBelowBadge");function et(t){try{const e=y("crtr",["canvas","attention","map","--view",t,"--json"],{timeout:2500,encoding:"utf8"});return JSON.parse(e.trim()).counts??{}}catch{return{}}}n(et,"fetchAsksMap");function rt(){const t=process.stdout.rows??S;return Math.max(4,Math.min(d,t-4))}n(rt,"graphWidgetBudget");const nt=`${a}jk move \xB7 hl fold \xB7 \u21B5 focus \xB7 e expand \xB7 x kill \xB7 m mgr \xB7 esc${i}`;export{G as BG_ATTACHED,D as BOLD,V as CYAN,a as DIM,c as ESC,nt as GRAPH_HINT,H as GRAY,k as GREEN,d as PI_MAX_WIDGET_LINES,I as RED,i as RESET,F as REVERSE,S as VIEWPORT_FALLBACK_ROWS,w as YELLOW,X as activityCell,Z as askBadge,z as beginFrameTelem,q as cycleBadge,et as fetchAsksMap,Y as fillBar,b as fillWidth,B as fmtTokens,rt as graphWidgetBudget,T as hasBrokerViewers,U as isAttached,tt as liveBelowBadge,Q as navLabel,J as nodeGlyph,g as readTelemetry,M as shortId,P as stripSgr,K as tokensCell,R as truncate,h as visibleWidth};

package/dist/core/canvas/node-order.js

@@ -1,37 +1 @@
-// node-order.ts — canonical ordering and status/lifecycle classification for
-// canvas nodes. Pure (type-only imports) so every surface — the browser model,
-// command leaves, renderers — can share one answer to "is this node live?" and
-// "did this node finish?" without reaching the db.
-/** Sort live work before terminal work; unknown statuses sort last. */
-export function statusRank(status) {
-    switch (status) {
-        case 'active': return 0;
-        case 'idle': return 1;
-        case 'done': return 2;
-        case 'canceled': return 3;
-        case 'dead': return 4;
-        default: return 5;
-    }
-}
-/** True when the node has a broker the daemon supervises — the statuses that
- *  mean "a live engine is (or should be) running right now". */
-export function isLiveStatus(status) {
-    return status === 'active' || status === 'idle';
-}
-/** True when a node's work is FINISHED — a terminal one-shot worker, or any node
- *  that pushed a final report.
- *
- *  This is deliberately NOT "is it running": a non-live status alone conflates two
- *  unrelated situations. Finished work is archive — opening it is inspection, and
- *  relaunching it puts a completed worker back to work (the stop-guard reprompts a
- *  terminal node that never pushed a final). A RESIDENT node with no final report
- *  is the opposite: its `done` is only `markCleanExitDone` recording a clean broker
- *  exit, which the stop-guard itself rules a legitimate stop (`reason: 'dormant'`),
- *  so it never finished anything and resuming it is simply reopening a conversation.
- *
- *  `lifecycle` is optional because DashboardRow only carries it on the full browser
- *  snapshot; absent, this answers `true` (treat as finished), keeping the caller on
- *  the conservative inspect-don't-revive path. */
-export function isFinishedWork(node) {
-    return node.lifecycle !== 'resident' || node.finalized;
-}
+var n=Object.defineProperty;var r=(e,t)=>n(e,"name",{value:t,configurable:!0});function c(e){switch(e){case"active":return 0;case"idle":return 1;case"done":return 2;case"canceled":return 3;case"dead":return 4;default:return 5}}r(c,"statusRank");function a(e){return e==="active"||e==="idle"}r(a,"isLiveStatus");function u(e){return e.lifecycle!=="resident"||e.finalized}r(u,"isFinishedWork");export{u as isFinishedWork,a as isLiveStatus,c as statusRank};

package/dist/core/canvas/node-recap.js

@@ -1,67 +1,2 @@
-// node-recap.ts — the node's last Goal/State briefing, persisted.
-//
-// The recap itself is generated in the broker (`pi-extensions/canvas-recap.ts`)
-// and painted above the editor as throwaway chrome. That widget lives in broker
-// memory, so the moment a node goes dormant its briefing is gone — which is
-// exactly when a developer scanning `crtr canvas browse` needs it most ("what was
-// this one for, and where did it stop?"). Persisting the two lines the viewer
-// already produced makes them readable without a broker and without a model call.
-//
-// Stored beside telemetry in `job/` because it is machine-generated runtime
-// state, not a document the node authored: safe to delete, rebuilt on the node's
-// next idle recap. `context/` stays the agent's own document space.
-import { join } from 'node:path';
-import { mkdirSync } from 'node:fs';
-import { jobDir } from './paths.js';
-import { readJsonIfExists, atomicWriteJson } from '../fs-utils.js';
-function recapPath(nodeId) {
-    return join(jobDir(nodeId), 'recap.json');
-}
-/** Strip one leading `Goal:` / `State:` label from a briefing line. */
-function stripLabel(line) {
-    return line.replace(/^\s*(goal|state)\s*:\s*/i, '').trim();
-}
-/** Split the model's two-line briefing into its labelled halves. Returns null for
- *  anything that doesn't yield at least one non-empty line — a garbled recap is
- *  worse than none, so it is never stored. Missing labels fall back to line order
- *  (the prompt asks for Goal first, State second). */
-export function parseRecapBriefing(briefing) {
-    const lines = briefing.split('\n').map((l) => l.trim()).filter((l) => l !== '');
-    if (lines.length === 0)
-        return null;
-    const labelled = (prefix) => lines.find((l) => new RegExp(`^${prefix}\\s*:`, 'i').test(l));
-    const goalLine = labelled('goal') ?? lines[0];
-    const stateLine = labelled('state') ?? (lines[1] !== goalLine ? lines[1] : undefined);
-    const goal = goalLine === undefined ? '' : stripLabel(goalLine);
-    const state = stateLine === undefined ? '' : stripLabel(stateLine);
-    if (goal === '' && state === '')
-        return null;
-    return { goal, state };
-}
-/** Persist a freshly generated briefing. Best-effort — a write failure only costs
- *  the browse preview one stale panel, so it must never disturb the broker. */
-export function writeNodeRecap(nodeId, briefing) {
-    const parsed = parseRecapBriefing(briefing);
-    if (parsed === null)
-        return;
-    try {
-        mkdirSync(jobDir(nodeId), { recursive: true });
-        atomicWriteJson(recapPath(nodeId), { ...parsed, at: new Date().toISOString() });
-    }
-    catch {
-        /* best-effort: the recap is regenerated on the node's next idle window */
-    }
-}
-/** The node's stored briefing, or undefined when it never generated one (a node
- *  that finished before its first idle window, or one last run before this file
- *  existed). Never throws. */
-export function readNodeRecap(nodeId) {
-    const raw = readJsonIfExists(recapPath(nodeId));
-    if (raw === null || typeof raw !== 'object')
-        return undefined;
-    const goal = typeof raw.goal === 'string' ? raw.goal : '';
-    const state = typeof raw.state === 'string' ? raw.state : '';
-    if (goal === '' && state === '')
-        return undefined;
-    return { goal, state, at: typeof raw.at === 'string' ? raw.at : '' };
-}
+var d=Object.defineProperty;var r=(e,t)=>d(e,"name",{value:t,configurable:!0});import{join as g}from"node:path";import{mkdirSync as m}from"node:fs";import{jobDir as f}from"./paths.js";import{readJsonIfExists as y,atomicWriteJson as x}from"../fs-utils.js";function u(e){return g(f(e),"recap.json")}r(u,"recapPath");function l(e){return e.replace(/^\s*(goal|state)\s*:\s*/i,"").trim()}r(l,"stripLabel");function b(e){const t=e.split(`
+`).map(i=>i.trim()).filter(i=>i!=="");if(t.length===0)return null;const n=r(i=>t.find(p=>new RegExp(`^${i}\\s*:`,"i").test(p)),"labelled"),o=n("goal")??t[0],a=n("state")??(t[1]!==o?t[1]:void 0),s=o===void 0?"":l(o),c=a===void 0?"":l(a);return s===""&&c===""?null:{goal:s,state:c}}r(b,"parseRecapBriefing");function S(e,t){const n=b(t);if(n!==null)try{m(f(e),{recursive:!0}),x(u(e),{...n,at:new Date().toISOString()})}catch{}}r(S,"writeNodeRecap");function D(e){const t=y(u(e));if(t===null||typeof t!="object")return;const n=typeof t.goal=="string"?t.goal:"",o=typeof t.state=="string"?t.state:"";if(!(n===""&&o===""))return{goal:n,state:o,at:typeof t.at=="string"?t.at:""}}r(D,"readNodeRecap");export{b as parseRecapBriefing,D as readNodeRecap,S as writeNodeRecap};