@north-light/crouter 0.3.318 → 0.3.320

package/dist/commands/node/inspect.js

@@ -1,300 +1,12 @@
-// `crtr node inspect` — roster, detail, and conversation fork reads.
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { isPidAlive } from '../../core/canvas/pid.js';
-import { fullName } from '../../core/canvas/labels.js';
-import { fuzzyMatch } from '../../core/tui/fuzzy.js';
-import { resolveProfileOperand } from '../../core/profiles/manifest.js';
-import { profilesStateBlock } from '../../core/profiles/state-block.js';
-import { nodeSnapshotLeaf } from '../node-snapshot.js';
-import { nodeTranscriptLeaf } from '../node-transcript.js';
-import { nodeContextLeaf } from '../node-context.js';
-import { nodeArtifactsLeaf } from '../node-inspect-artifacts.js';
-import { cliClient, cliCanvasSource, rethrowAsCliError } from '../api-client.js';
-import { RemoteCanvasSource } from '../../core/canvas/remote-canvas-source.js';
-import { kindsStateBlock } from './create.js';
-import { focusViewer, nodeInPane } from '../surface/node/placement.js';
-const nodeList = defineLeaf({
-    name: 'list',
-    description: 'list nodes on the canvas',
-    whenToUse: 'you want a flat roster of the nodes on the canvas, sliced by displayed name, status, kind, mode, lifecycle, profile, cwd, and graph scope (--under a node, for that node plus its subscription descendants). The filters AND together. Use `node inspect show` instead to drill into one node and its spine neighbors, `canvas dashboard` for the tree shape, and `canvas attention` to find nodes blocked on the user',
-    help: {
-        name: 'node inspect list',
-        summary: 'list nodes on the canvas, filtered by any combination of attribute slices and a graph-scope (--under) that AND together',
-        params: [
-            { kind: 'flag', name: 'status', type: 'string', required: false, constraint: 'Filter status (comma-separated for several; accepted values: active, idle, done, dead, canceled). NOTE: `active` means the engine process is live (never closed), NOT that the node is generating right now — an active node is usually dormant between turns. To tell working-vs-idle, check the pi session-file mtime or CPU, not status.' },
-            { kind: 'flag', name: 'kind', type: 'string', required: false, constraint: 'Filter by persona kind (comma-separated for several). The <kinds> list below names every top-level installable kind; a registered sub-kind filters too by exact path even though it is not listed.' },
-            { kind: 'flag', name: 'mode', type: 'string', required: false, constraint: 'Filter by mode (comma-separated for several; accepted values: base, orchestrator).' },
-            { kind: 'flag', name: 'lifecycle', type: 'string', required: false, constraint: 'Filter by lifecycle (comma-separated for several; accepted values: terminal, resident).' },
-            { kind: 'flag', name: 'profile', type: 'string', required: false, constraint: 'Filter by profile. On the local canvas, accepts a profile id or manifest name from the <profiles> list below, or a close-enough name that resolves to the nearest profile. Against a remote canvas, pass the exact profile id carried by its node rows.' },
-            { kind: 'flag', name: 'name', type: 'string', required: false, constraint: 'Filter by the displayed node label (handle plus generated description) with the canvas browser’s case-insensitive fuzzy subsequence match.' },
-            { kind: 'flag', name: 'cwd', type: 'string', required: false, constraint: 'Filter to nodes pinned to this exact cwd (absolute path). Roster is canvas-wide (all cwds) by default.' },
-            { kind: 'flag', name: 'under', type: 'string', required: false, constraint: 'Graph scope: restrict to this node and its subscription descendants (the sub-DAG reachable downward — its reports, theirs, …). This is "one initiative / my subtree". ANDs with every attribute filter above, narrowing any of them to this subtree.' },
-            { kind: 'flag', name: 'canvas', type: 'string', required: false, constraint: 'Read from the named remote canvas target (see `crtr canvas config list`) instead of the local canvas. Overrides `crtr canvas use`.' },
-        ],
-        output: [
-            { name: 'nodes', type: 'object[]', required: true, constraint: 'Rows include {node_id, name, kind, mode, lifecycle, status, cwd, profile_id, parent, created}. `name` is the displayed node label searched by --name and shown in canvas views. `profile_id` is the stable profile-directory id (null only for historical no-profile nodes).' },
-        ],
-        outputKind: 'object',
-        dynamicState: () => [kindsStateBlock(), profilesStateBlock()].join('\n'),
-        effects: ['Read-only: lists nodes through the daemon API.'],
-    },
-    run: async (input) => {
-        const csv = (k) => {
-            const raw = input[k];
-            return raw !== undefined && raw !== '' ? raw.split(',').map((s) => s.trim()).filter((s) => s !== '') : undefined;
-        };
-        const status = csv('status');
-        const kinds = csv('kind');
-        const modes = csv('mode');
-        const lifecycles = csv('lifecycle');
-        const profile = input['profile'];
-        const name = input['name'];
-        const cwd = input['cwd'];
-        const under = input['under'];
-        const canvasSource = cliCanvasSource({ canvasName: input['canvas'] });
-        // The selected source owns roster filtering, graph scope, missing-node
-        // checks, and node-name hydration for both local and remote canvases. Local
-        // profiles remain the one command-side compatibility lookup: remote guests
-        // cannot resolve this machine's manifest names.
-        const profileId = canvasSource instanceof RemoteCanvasSource
-            ? profile
-            : profile === undefined ? undefined : resolveProfileOperand(profile).profileId;
-        let scope;
-        if (under !== undefined && under !== '') {
-            if (await canvasSource.getNode(under).catch(rethrowAsCliError) === null) {
-                throw new InputError({ error: 'not_found', message: `no node: ${under}`, next: 'List nodes with `crtr node inspect list`, then pass a real id to --under.' });
-            }
-            scope = new Set([under, ...(await canvasSource.view(under))]);
-        }
-        const rows = (await canvasSource.listNodes(status !== undefined ? { status } : undefined).catch(rethrowAsCliError)).filter((row) => {
-            if (scope !== undefined && !scope.has(row.node_id))
-                return false;
-            if (kinds !== undefined && !kinds.includes(row.kind))
-                return false;
-            if (modes !== undefined && !modes.includes(row.mode))
-                return false;
-            if (lifecycles !== undefined && !lifecycles.includes(row.lifecycle))
-                return false;
-            if (profileId !== undefined && row.profile_id !== profileId)
-                return false;
-            if (cwd !== undefined && cwd !== '' && row.cwd !== cwd)
-                return false;
-            return true;
-        });
-        const nodes = rows
-            .map((row) => ({ ...row, name: fullName(row) }))
-            .filter((row) => name === undefined || name === '' || fuzzyMatch(name, row.name));
-        return { nodes };
-    },
-});
-// node inspect show — a node + its place in the spine
-// The renderer receives only the command result, while JSON output bypasses it.
-// Keep remote provenance out of the returned DTO-shaped object without adding a
-// second wire field or mutating the remote response.
-const remoteShowResults = new WeakSet();
-// Enrich a declared source edge so a debugger reads who a report/manager is
-// without rebuilding a NodeMeta compatibility object.
-async function enrichNeighbor(source, ref) {
-    const node = await source.getNode(ref.node_id).catch(rethrowAsCliError);
-    return {
-        node_id: ref.node_id,
-        name: node ? fullName(node) : '(missing)',
-        kind: node?.kind ?? '?',
-        status: node ? (node.intent ? `${node.status}/${node.intent}` : node.status) : '?',
-        active: ref.active,
-    };
-}
-const nodeShow = defineLeaf({
-    name: 'show',
-    description: 'show a node + its spine neighbors, artifacts, and drill-in pointers',
-    whenToUse: 'you want one node in depth — the debugging entrypoint: a glanceable meta slice, named spine neighbors, artifact and pending-cron counts, and exact drill-in paths. Use `node inspect list` for the flat roster or `canvas dashboard` for the whole-tree shape',
-    help: {
-        name: 'node inspect show',
-        summary: 'show a node in depth — meta slice, named neighbors, artifact/pending-cron counts, and drill-in pointers',
-        params: [
-            { kind: 'positional', name: 'node', required: true, constraint: 'Node id.' },
-            { kind: 'flag', name: 'canvas', type: 'string', required: false, constraint: 'Read from the named remote canvas target (see `crtr canvas config list`) instead of the local canvas. Overrides `crtr canvas use`.' },
-        ],
-        output: [
-            { name: 'node', type: 'object', required: true, constraint: 'The full node meta (system prompt + every telemetry field). The render surfaces a glanceable slice; `--json` carries the complete dump.' },
-            { name: 'fault', type: 'object', required: true, constraint: 'The active runtime fault projection, or null: {link, kind, retry: {disposition}, since}.' },
-            { name: 'reports', type: 'object[]', required: true, constraint: 'Who this node subscribes to (its reports/down), each enriched with {node_id, name, kind, status, active} — these are typically its spawned children.' },
-            { name: 'managers', type: 'object[]', required: true, constraint: 'Who subscribes to this node (its managers/up), same enriched shape.' },
-            { name: 'artifacts', type: 'object', required: true, constraint: 'Counts of what the node left on disk by corpus: {report, doc, roadmap}. Enumerate them with `node inspect artifacts <id>`.' },
-            { name: 'pending_crons', type: 'number', required: true, constraint: 'How many pending crons were created by this node. Inspect with `crtr cron list`.' },
-            { name: 'paths', type: 'object', required: true, constraint: 'Resolved on-disk locations: {context_dir, reports_dir, session_file} — read these directly to debug.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'The concrete next commands to drill deeper.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: reads the node, its edges and artifacts, and pending crons through crtrd.'],
-        // The node meta object inlines the full system prompt + every telemetry
-        // field — a machine-readable dump we suppress from the viewer preview; the
-        // render below surfaces only a glanceable slice. Same preview rationale as
-        // canvas snapshot / node inspect snapshot.
-        preview: { suppressOutput: true },
-    },
-    run: async (input) => {
-        const id = input['node'];
-        const canvasName = input['canvas'];
-        const canvasSource = cliCanvasSource({ canvasName });
-        // The remote source declares this exact command-read operation; preserve
-        // its guest-computed artifact/path fields instead of deriving them locally.
-        if (canvasSource instanceof RemoteCanvasSource) {
-            const result = await canvasSource.rawShow(id);
-            if (result === null) {
-                throw new InputError({ error: 'not_found', message: `no node: ${id}`, next: 'List nodes with `crtr node inspect list --canvas <name>`.' });
-            }
-            const shown = { ...result };
-            remoteShowResults.add(shown);
-            return shown;
-        }
-        // The source owns existence and topology. Locally its detail projection is
-        // the daemon DTO that carries the path fields used below.
-        const sourceNode = await canvasSource.getNode(id).catch((err) => rethrowAsCliError(err, 'List nodes with `crtr node inspect list`.'));
-        if (sourceNode === null) {
-            throw new InputError({ error: 'not_found', message: `no node: ${id}`, next: 'List nodes with `crtr node inspect list`.' });
-        }
-        const node = sourceNode;
-        const client = cliClient();
-        const reports = await Promise.all((await canvasSource.subscriptionsOf(id)).map((ref) => enrichNeighbor(canvasSource, ref)));
-        const managers = await Promise.all((await canvasSource.subscribersOf(id)).map((ref) => enrichNeighbor(canvasSource, ref)));
-        const arts = await client.getArtifacts(id);
-        const artifacts = {
-            report: arts.artifacts.filter((a) => a.source.startsWith('report')).length,
-            doc: arts.artifacts.filter((a) => a.source === 'doc').length,
-            roadmap: arts.artifacts.filter((a) => a.source === 'roadmap').length,
-        };
-        const pending_crons = (await client.listCrons().catch(rethrowAsCliError)).filter((cron) => cron.created_by === id).length;
-        const paths = {
-            context_dir: node.paths.context_dir,
-            reports_dir: node.paths.reports_dir,
-            ...(node.pi_session_file !== undefined ? { session_file: node.pi_session_file } : {}),
-        };
-        // Auto-gathered drill-in pointers: the exact commands a debugger reaches for
-        // next, populated only when there is actually something behind them.
-        const hints = [];
-        const artTotal = artifacts.report + artifacts.doc + artifacts.roadmap;
-        if (artTotal > 0)
-            hints.push(`Read its ${artTotal} artifact(s): \`crtr node inspect artifacts ${id}\` → each ref feeds \`crtr canvas history read <ref>\`.`);
-        hints.push(`Browse its context + reports dirs (and its subscriptions') in nvim: \`crtr node inspect context ${id}\`.`);
-        if (paths.session_file)
-            hints.push(`Read the raw conversation transcript: ${paths.session_file}`);
-        hints.push(`On-disk context dir (ls/read directly): ${paths.context_dir}`);
-        if (pending_crons > 0)
-            hints.push(`It created ${pending_crons} pending cron(s): \`crtr cron list\`.`);
-        if (reports.length > 0)
-            hints.push(`Drill into a child/report: \`crtr node inspect show <node_id>\` (${reports.map((r) => r['node_id']).join(', ')}).`);
-        hints.push(`Full machine dump (system prompt + all telemetry): \`crtr --json node inspect show ${id}\`.`);
-        return { node, fault: node.fault ?? null, reports, managers, artifacts, pending_crons, paths, follow_up: hints.join('\n') };
-    },
-    render: (r) => {
-        const node = r['node'];
-        const id = String(node['node_id']);
-        const pid = node['pi_pid'];
-        const isRemoteShow = remoteShowResults.has(r);
-        const alive = isRemoteShow ? 'remote (liveness not checked locally)' : (isPidAlive(pid) ? 'alive' : 'dead');
-        const intent = node['intent'] ? `/${String(node['intent'])}` : '';
-        const fault = r['fault'];
-        const parts = [];
-        // 1) Glanceable meta slice — the debug-critical fields, not the full dump.
-        parts.push(`# ${fullName(node)}  (${id})`);
-        const meta = [
-            `- kind/mode/lifecycle: ${node['kind']} / ${node['mode']} / ${node['lifecycle']}`,
-            `- status: ${node['status']}${intent}`,
-            ...(fault === null || fault === undefined ? [] : [`- fault: ${String(fault['kind'])} / ${String(fault['retry']?.disposition)} since ${String(fault['since'])}`]),
-            `- broker pid: ${pid ?? '(none)'} — ${alive}`,
-            `- cwd: ${node['cwd']}`,
-            `- host: ${node['host_kind']}` + (node['profile_id'] ? ` · profile ${node['profile_id']}` : ''),
-            `- cycles: ${node['cycles']} · created ${node['created']}`,
-        ];
-        if (node['parent'])
-            meta.push(`- parent: ${node['parent']}`);
-        meta.push(`- creator: ${node['creator'] ?? 'an external process'}`);
-        if (node['waiting_for'])
-            meta.push(`- waiting for message: ${node['waiting_for']}`);
-        parts.push(meta.join('\n'));
-        // 2) Neighbor tables (reports down, managers up), pre-enriched with names.
-        const table = (label, rows) => {
-            if (rows.length === 0)
-                return `${label}: none`;
-            const cols = ['node_id', 'name', 'kind', 'status', 'active'];
-            const head = `| ${cols.join(' | ')} |`;
-            const sep = `| ${cols.map(() => '---').join(' | ')} |`;
-            const body = rows.map((row) => `| ${cols.map((c) => String(row[c] ?? '').replace(/\|/g, '\\|').replace(/\n/g, ' ')).join(' | ')} |`).join('\n');
-            return `${rows.length} ${label}:\n\n${head}\n${sep}\n${body}`;
-        };
-        parts.push(table('reports (down — subscriptions, usually children)', r['reports']));
-        parts.push(table('managers (up — subscribers)', r['managers']));
-        // 3) On-disk footprint at a glance.
-        const a = r['artifacts'];
-        parts.push(`artifacts: ${a['report']} report(s), ${a['doc']} doc(s), ${a['roadmap']} roadmap · ${r['pending_crons']} pending cron(s)`);
-        // 4) Auto-gathered drill-in pointers.
-        parts.push(`Drill deeper:\n${String(r['follow_up'])}`);
-        return parts.join('\n\n');
-    },
-});
-// node fork — branch a conversation + durable context into an idle root
-export const nodeFork = defineLeaf({
-    name: 'fork',
-    description: 'fork a node into an independent idle root with the same conversation and durable context',
-    whenToUse: 'a conversation has already accumulated the context you want, and you want a new user-driven branch beside it without sending a prompt or inheriting any graph-management responsibility. This copies the conversation and durable context, then waits for the fork’s first real user message to supply its mandate. Use `node new --fork-from` instead when spawning a managed worker with an immediate task',
-    help: {
-        name: 'node fork',
-        summary: 'create an independent resident root from a node’s conversation and durable context, with no kickoff prompt or model turn',
-        params: [
-            { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Source node id. Mutually exclusive with --pane; one of them is required.' },
-            { kind: 'flag', name: 'pane', type: 'string', required: false, constraint: 'tmux pane showing the source node. Mutually exclusive with --node; one of them is required. The prefix menu passes this for you and the new viewer splits beside this pane.' },
-        ],
-        output: [
-            { name: 'node_id', type: 'string', required: true, constraint: 'The new independent root id.' },
-            { name: 'focused', type: 'boolean', required: true, constraint: 'True when a new viewer pane opened beside the caller; false outside tmux.' },
-            { name: 'session', type: 'string', required: false, constraint: 'The tmux session containing the new viewer, when one opened.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Creates a resident base-mode root with the source node’s copied pi conversation, cwd, profile, kind, model override, and durable context files. Top-level initial-prompt.md, yield-message.md, and result.json are omitted.',
-            'Copies no parent, subscriptions, subscribers, children, crons, worktree, situational context, or lifecycle responsibility. Sends no prompt and consumes no model turn; the first real user message becomes the fork’s mandate.',
-            'Inside tmux, opens and focuses a surface-attach viewer as an even-horizontal split in the source pane’s window. Outside tmux, the root is still created but no interactive fallback opens.',
-        ],
-    },
-    run: async (input) => {
-        const pane = input['pane'];
-        const explicitNode = input['node'];
-        if (explicitNode !== undefined && pane !== undefined) {
-            throw new InputError({ error: 'conflicting_target', message: '--node and --pane are mutually exclusive', next: 'Pass the source node id or its viewer pane, not both.' });
-        }
-        let sourceId = explicitNode;
-        if (sourceId === undefined && pane !== undefined)
-            sourceId = nodeInPane(pane);
-        if (sourceId === undefined || sourceId === '') {
-            throw new InputError({ error: 'no_node', message: 'no source node was provided or found in the pane', next: 'Pass --node <id>, or --pane <pane-id> for a pane showing a node.' });
-        }
-        const detail = await cliClient().forkNode(sourceId).catch(rethrowAsCliError);
-        const placement = await focusViewer(detail.node_id, {
-            cwd: detail.cwd,
-            name: detail.name,
-            ...(pane !== undefined ? { pane } : {}),
-            newPane: true,
-        });
-        return { node_id: detail.node_id, focused: placement.focused, session: placement.session };
-    },
-    render: (result) => {
-        const placement = result['focused'] === true
-            ? ` Viewer opened beside the source${result['session'] ? ` in session ${result['session']}` : ''}.`
-            : ' No viewer opened because no tmux pane was available.';
-        return `Forked independent idle root ${result['node_id']}.${placement} It will make no model call until its first real user message.`;
-    },
-});
-// node inspect — read the graph (list, show, context)
-export const nodeInspect = defineBranch({
-    name: 'inspect',
-    description: 'read one node — its graph position, context, and artifacts',
-    whenToUse: 'reading everything about ONE node you can name: enumerate the roster (`list`), inspect a node and its spine neighbors (`show`), browse its on-disk context dir (`context`), or list its reports/docs as refs (`artifacts`). Use `canvas dashboard` instead to render the whole tree SHAPE, or `canvas attention` to find which nodes are blocked on the user',
-    help: {
-        name: 'node inspect',
-        summary: 'read one node (or the roster) — topology, context dir, and artifacts',
-        model: 'Inspection is read-only and never revives a node. The roster is the selection surface; one-node metadata points to progressively heavier views: a parsed broker snapshot, rendered conversation, context browser, or artifact references.',
-    },
-    children: [nodeList, nodeShow, nodeSnapshotLeaf, nodeTranscriptLeaf, nodeContextLeaf, nodeArtifactsLeaf],
-});
+var R=Object.defineProperty;var h=(t,e)=>R(t,"name",{value:e,configurable:!0});import{defineBranch as I,defineLeaf as k}from"../../core/command.js";import{InputError as b}from"../../core/io.js";import{isPidAlive as O}from"../../core/canvas/pid.js";import{fullName as $}from"../../core/canvas/labels.js";import{fuzzyMatch as A}from"../../core/tui/fuzzy.js";import{resolveProfileOperand as P}from"../../core/profiles/manifest.js";import{profilesStateBlock as C}from"../../core/profiles/state-block.js";import{nodeSnapshotLeaf as F}from"../node-snapshot.js";import{nodeTranscriptLeaf as L}from"../node-transcript.js";import{nodeContextLeaf as U}from"../node-context.js";import{nodeArtifactsLeaf as D}from"../node-inspect-artifacts.js";import{cliClient as _,cliCanvasSource as x,rethrowAsCliError as y}from"../api-client.js";import{RemoteCanvasSource as q}from"../../core/canvas/remote-canvas-source.js";import{kindsStateBlock as E}from"./create.js";import{focusViewer as z,nodeInPane as B}from"../surface/node/placement.js";const W=k({name:"list",description:"list nodes on the canvas",whenToUse:"you want a flat roster of the nodes on the canvas, sliced by displayed name, status, kind, mode, lifecycle, profile, cwd, and graph scope (--under a node, for that node plus its subscription descendants). The filters AND together. Use `node inspect show` instead to drill into one node and its spine neighbors, `canvas dashboard` for the tree shape, and `canvas attention` to find nodes blocked on the user",help:{name:"node inspect list",summary:"list nodes on the canvas, filtered by any combination of attribute slices and a graph-scope (--under) that AND together",params:[{kind:"flag",name:"status",type:"string",required:!1,constraint:"Filter status (comma-separated for several; accepted values: active, idle, done, dead, canceled). NOTE: `active` means the engine process is live (never closed), NOT that the node is generating right now \u2014 an active node is usually dormant between turns. To tell working-vs-idle, check the pi session-file mtime or CPU, not status."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Filter by persona kind (comma-separated for several). The <kinds> list below names every top-level installable kind; a registered sub-kind filters too by exact path even though it is not listed."},{kind:"flag",name:"mode",type:"string",required:!1,constraint:"Filter by mode (comma-separated for several; accepted values: base, orchestrator)."},{kind:"flag",name:"lifecycle",type:"string",required:!1,constraint:"Filter by lifecycle (comma-separated for several; accepted values: terminal, resident)."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Filter by profile. On the local canvas, accepts a profile id or manifest name from the <profiles> list below, or a close-enough name that resolves to the nearest profile. Against a remote canvas, pass the exact profile id carried by its node rows."},{kind:"flag",name:"name",type:"string",required:!1,constraint:"Filter by the displayed node label (handle plus generated description) with the canvas browser\u2019s case-insensitive fuzzy subsequence match."},{kind:"flag",name:"cwd",type:"string",required:!1,constraint:"Filter to nodes pinned to this exact cwd (absolute path). Roster is canvas-wide (all cwds) by default."},{kind:"flag",name:"under",type:"string",required:!1,constraint:'Graph scope: restrict to this node and its subscription descendants (the sub-DAG reachable downward \u2014 its reports, theirs, \u2026). This is "one initiative / my subtree". ANDs with every attribute filter above, narrowing any of them to this subtree.'},{kind:"flag",name:"canvas",type:"string",required:!1,constraint:"Read from the named remote canvas target (see `crtr canvas config list`) instead of the local canvas. Overrides `crtr canvas use`."}],output:[{name:"nodes",type:"object[]",required:!0,constraint:"Rows include {node_id, name, kind, mode, lifecycle, status, cwd, profile_id, parent, created}. `name` is the displayed node label searched by --name and shown in canvas views. `profile_id` is the stable profile-directory id (null only for historical no-profile nodes)."}],outputKind:"object",dynamicState:h(()=>[E(),C()].join(`
+`),"dynamicState"),effects:["Read-only: lists nodes through the daemon API."]},run:h(async t=>{const e=h(n=>{const w=t[n];return w!==void 0&&w!==""?w.split(",").map(v=>v.trim()).filter(v=>v!==""):void 0},"csv"),o=e("status"),s=e("kind"),p=e("mode"),r=e("lifecycle"),m=t.profile,a=t.name,d=t.cwd,i=t.under,l=x({canvasName:t.canvas}),f=l instanceof q?m:m===void 0?void 0:P(m).profileId;let u;if(i!==void 0&&i!==""){if(await l.getNode(i).catch(y)===null)throw new b({error:"not_found",message:`no node: ${i}`,next:"List nodes with `crtr node inspect list`, then pass a real id to --under."});u=new Set([i,...await l.view(i)])}return{nodes:(await l.listNodes(o!==void 0?{status:o}:void 0).catch(y)).filter(n=>!(u!==void 0&&!u.has(n.node_id)||s!==void 0&&!s.includes(n.kind)||p!==void 0&&!p.includes(n.mode)||r!==void 0&&!r.includes(n.lifecycle)||f!==void 0&&n.profile_id!==f||d!==void 0&&d!==""&&n.cwd!==d)).map(n=>({...n,name:$(n)})).filter(n=>a===void 0||a===""||A(a,n.name))}},"run")}),S=new WeakSet;async function j(t,e){const o=await t.getNode(e.node_id).catch(y);return{node_id:e.node_id,name:o?$(o):"(missing)",kind:o?.kind??"?",status:o?o.intent?`${o.status}/${o.intent}`:o.status:"?",active:e.active}}h(j,"enrichNeighbor");const K=k({name:"show",description:"show a node + its spine neighbors, artifacts, and drill-in pointers",whenToUse:"you want one node in depth \u2014 the debugging entrypoint: a glanceable meta slice, named spine neighbors, artifact and pending-cron counts, and exact drill-in paths. Use `node inspect list` for the flat roster or `canvas dashboard` for the whole-tree shape",help:{name:"node inspect show",summary:"show a node in depth \u2014 meta slice, named neighbors, artifact/pending-cron counts, and drill-in pointers",params:[{kind:"positional",name:"node",required:!0,constraint:"Node id."},{kind:"flag",name:"canvas",type:"string",required:!1,constraint:"Read from the named remote canvas target (see `crtr canvas config list`) instead of the local canvas. Overrides `crtr canvas use`."}],output:[{name:"node",type:"object",required:!0,constraint:"The full node meta (system prompt + every telemetry field). The render surfaces a glanceable slice; `--json` carries the complete dump."},{name:"fault",type:"object",required:!0,constraint:"The active runtime fault projection, or null: {link, kind, retry: {disposition}, since}."},{name:"reports",type:"object[]",required:!0,constraint:"Who this node subscribes to (its reports/down), each enriched with {node_id, name, kind, status, active} \u2014 these are typically its spawned children."},{name:"managers",type:"object[]",required:!0,constraint:"Who subscribes to this node (its managers/up), same enriched shape."},{name:"artifacts",type:"object",required:!0,constraint:"Counts of what the node left on disk by corpus: {report, doc, roadmap}. Enumerate them with `node inspect artifacts <id>`."},{name:"pending_crons",type:"number",required:!0,constraint:"How many pending crons were created by this node. Inspect with `crtr cron list`."},{name:"paths",type:"object",required:!0,constraint:"Resolved on-disk locations: {context_dir, reports_dir, session_file} \u2014 read these directly to debug."},{name:"follow_up",type:"string",required:!0,constraint:"The concrete next commands to drill deeper."}],outputKind:"object",effects:["Read-only: reads the node, its edges and artifacts, and pending crons through crtrd."],preview:{suppressOutput:!0}},run:h(async t=>{const e=t.node,o=t.canvas,s=x({canvasName:o});if(s instanceof q){const n=await s.rawShow(e);if(n===null)throw new b({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list --canvas <name>`."});const w={...n};return S.add(w),w}const p=await s.getNode(e).catch(n=>y(n,"List nodes with `crtr node inspect list`."));if(p===null)throw new b({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list`."});const r=p,m=_(),a=await Promise.all((await s.subscriptionsOf(e)).map(n=>j(s,n))),d=await Promise.all((await s.subscribersOf(e)).map(n=>j(s,n))),i=await m.getArtifacts(e),l={report:i.artifacts.filter(n=>n.source.startsWith("report")).length,doc:i.artifacts.filter(n=>n.source==="doc").length,roadmap:i.artifacts.filter(n=>n.source==="roadmap").length},f=(await m.listCrons().catch(y)).filter(n=>n.created_by===e).length,u={context_dir:r.paths.context_dir,reports_dir:r.paths.reports_dir,...r.pi_session_file!==void 0?{session_file:r.pi_session_file}:{}},c=[],g=l.report+l.doc+l.roadmap;return g>0&&c.push(`Read its ${g} artifact(s): \`crtr node inspect artifacts ${e}\` \u2192 each ref feeds \`crtr canvas history read <ref>\`.`),c.push(`Browse its context + reports dirs (and its subscriptions') in nvim: \`crtr node inspect context ${e}\`.`),u.session_file&&c.push(`Read the raw conversation transcript: ${u.session_file}`),c.push(`On-disk context dir (ls/read directly): ${u.context_dir}`),f>0&&c.push(`It created ${f} pending cron(s): \`crtr cron list\`.`),a.length>0&&c.push(`Drill into a child/report: \`crtr node inspect show <node_id>\` (${a.map(n=>n.node_id).join(", ")}).`),c.push(`Full machine dump (system prompt + all telemetry): \`crtr --json node inspect show ${e}\`.`),{node:r,fault:r.fault??null,reports:a,managers:d,artifacts:l,pending_crons:f,paths:u,follow_up:c.join(`
+`)}},"run"),render:h(t=>{const e=t.node,o=String(e.node_id),s=e.pi_pid,r=S.has(t)?"remote (liveness not checked locally)":O(s)?"alive":"dead",m=e.intent?`/${String(e.intent)}`:"",a=t.fault,d=[];d.push(`# ${$(e)}  (${o})`);const i=[`- kind/mode/lifecycle: ${e.kind} / ${e.mode} / ${e.lifecycle}`,`- status: ${e.status}${m}`,...a==null?[]:[`- fault: ${String(a.kind)} / ${String(a.retry?.disposition)} since ${String(a.since)}`],`- broker pid: ${s??"(none)"} \u2014 ${r}`,`- cwd: ${e.cwd}`,`- host: ${e.host_kind}`+(e.profile_id?` \xB7 profile ${e.profile_id}`:""),`- cycles: ${e.cycles} \xB7 created ${e.created}`];e.parent&&i.push(`- parent: ${e.parent}`),i.push(`- creator: ${e.creator??"an external process"}`),e.waiting_for&&i.push(`- waiting for message: ${e.waiting_for}`),d.push(i.join(`
+`));const l=h((u,c)=>{if(c.length===0)return`${u}: none`;const g=["node_id","name","kind","status","active"],n=`| ${g.join(" | ")} |`,w=`| ${g.map(()=>"---").join(" | ")} |`,v=c.map(T=>`| ${g.map(N=>String(T[N]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);return`${c.length} ${u}:
+
+${n}
+${w}
+${v}`},"table");d.push(l("reports (down \u2014 subscriptions, usually children)",t.reports)),d.push(l("managers (up \u2014 subscribers)",t.managers));const f=t.artifacts;return d.push(`artifacts: ${f.report} report(s), ${f.doc} doc(s), ${f.roadmap} roadmap \xB7 ${t.pending_crons} pending cron(s)`),d.push(`Drill deeper:
+${String(t.follow_up)}`),d.join(`
+
+`)},"render")}),ae=k({name:"fork",description:"fork a node into an independent idle root with the same conversation and durable context",whenToUse:"a conversation has already accumulated the context you want, and you want a new user-driven branch beside it without sending a prompt or inheriting any graph-management responsibility. This copies the conversation and durable context, then waits for the fork\u2019s first real user message to supply its mandate. Use `node new --fork-from` instead when spawning a managed worker with an immediate task",help:{name:"node fork",summary:"create an independent resident root from a node\u2019s conversation and durable context, with no kickoff prompt or model turn",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Source node id. Mutually exclusive with --pane; one of them is required."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane showing the source node. Mutually exclusive with --node; one of them is required. The prefix menu passes this for you and the new viewer splits beside this pane."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The new independent root id."},{name:"focused",type:"boolean",required:!0,constraint:"True when a new viewer pane opened beside the caller; false outside tmux."},{name:"session",type:"string",required:!1,constraint:"The tmux session containing the new viewer, when one opened."}],outputKind:"object",effects:["Creates a resident base-mode root with the source node\u2019s copied pi conversation, cwd, profile, kind, model override, and durable context files. Top-level initial-prompt.md, yield-message.md, and result.json are omitted.","Copies no parent, subscriptions, subscribers, children, crons, worktree, situational context, or lifecycle responsibility. Sends no prompt and consumes no model turn; the first real user message becomes the fork\u2019s mandate.","Inside tmux, opens and focuses a surface-attach viewer as an even-horizontal split in the source pane\u2019s window. Outside tmux, the root is still created but no interactive fallback opens."]},run:h(async t=>{const e=t.pane,o=t.node;if(o!==void 0&&e!==void 0)throw new b({error:"conflicting_target",message:"--node and --pane are mutually exclusive",next:"Pass the source node id or its viewer pane, not both."});let s=o;if(s===void 0&&e!==void 0&&(s=B(e)),s===void 0||s==="")throw new b({error:"no_node",message:"no source node was provided or found in the pane",next:"Pass --node <id>, or --pane <pane-id> for a pane showing a node."});const p=await _().forkNode(s).catch(y),r=await z(p.node_id,{cwd:p.cwd,name:p.name,...e!==void 0?{pane:e}:{},newPane:!0});return{node_id:p.node_id,focused:r.focused,session:r.session}},"run"),render:h(t=>{const e=t.focused===!0?` Viewer opened beside the source${t.session?` in session ${t.session}`:""}.`:" No viewer opened because no tmux pane was available.";return`Forked independent idle root ${t.node_id}.${e} It will make no model call until its first real user message.`},"render")}),de=I({name:"inspect",description:"read one node \u2014 its graph position, context, and artifacts",whenToUse:"reading everything about ONE node you can name: enumerate the roster (`list`), inspect a node and its spine neighbors (`show`), browse its on-disk context dir (`context`), or list its reports/docs as refs (`artifacts`). Use `canvas dashboard` instead to render the whole tree SHAPE, or `canvas attention` to find which nodes are blocked on the user",help:{name:"node inspect",summary:"read one node (or the roster) \u2014 topology, context dir, and artifacts",model:"Inspection is read-only and never revives a node. The roster is the selection surface; one-node metadata points to progressively heavier views: a parsed broker snapshot, rendered conversation, context browser, or artifact references."},children:[W,K,F,L,U,D]});export{ae as nodeFork,de as nodeInspect};