@north-light/crouter 0.3.318 → 0.3.319

package/dist/commands/node/wait.js

@@ -1,163 +1,7 @@
-// `crtr node wait` — durable controller and deadline waits.
-import { envNodeId, envProfileId } from '../../shared/env.js';
-import { defineBranch, defineLeaf } from '../../core/command.js';
-import { InputError } from '../../core/io.js';
-import { parseWhen } from '../../core/wake.js';
-import { cliClient, getNodeOrNull, rethrowAsCliError } from '../api-client.js';
-import { shellQuote } from '../surface/node/placement.js';
-function armerId() {
-    const id = envNodeId();
-    if (id === undefined || id === '') {
-        throw new InputError({ error: 'no_node', message: 'no node to anchor a deadline cron (CRTR_NODE_ID unset)', next: 'Run from inside a node.' });
-    }
-    return id;
-}
-/** Build ParseOpts, including `tz` only when actually provided. */
-function parseOpts(now, tz) {
-    return tz !== undefined && tz.trim() !== '' ? { tz, now } : { now };
-}
-/** Map a time-grammar error to the rendered error block. */
-function throwTimeError(e) {
-    const next = {
-        wake_in_past: 'Pick a future instant — a positive duration ("5m","2h") or an ISO time later than now.',
-        bad_when: 'Use a duration ("5m","1h30m"), a zoned ISO ("2026-06-07T09:00:00Z"), or a bare ISO ("2026-06-07T09:00").',
-        bad_cadence: 'Use a duration ("6h"), a 5-field cron ("0 9 * * *"), or an @alias ("@daily").',
-        unknown_zone: 'Pass --tz with an IANA zone name (e.g. "America/New_York").',
-        cadence_too_fast: 'Use a cadence of at least 60s (e.g. "1m","5m","1h").',
-    };
-    throw new InputError({ error: e.code, message: e.message, received: e.received, next: next[e.code] ?? 'Fix the time value and retry.' });
-}
-/** A human ETA hint like " (~5m)" from a fire-at ISO relative to now. '' if past. */
-function etaHint(fireAt, now) {
-    const ms = new Date(fireAt).getTime() - now.getTime();
-    if (!Number.isFinite(ms) || ms <= 0)
-        return '';
-    const mins = Math.round(ms / 60_000);
-    if (mins < 60)
-        return ` (~${mins}m)`;
-    const hrs = Math.round(ms / 3_600_000);
-    if (hrs < 48)
-        return ` (~${hrs}h)`;
-    return ` (~${Math.round(ms / 86_400_000)}d)`;
-}
-function deadlineHeredoc(body, nodeId) {
-    let delimiter = 'CRTR_DEADLINE';
-    let suffix = 0;
-    const lines = new Set(body.split('\n'));
-    while (lines.has(delimiter))
-        delimiter = `CRTR_DEADLINE_${++suffix}`;
-    return `crtr cron cancel "$CRTR_CRON_ID"\ncrtr node message send --to ${shellQuote(nodeId)} --tier urgent <<'${delimiter}'\n${body}\n${delimiter}`;
-}
-const nodeWaitDeadline = defineLeaf({
-    name: 'deadline',
-    description: 'race this node’s next wake against one urgent deadline cron',
-    whenToUse: 'you are waiting on an event nothing can push for, so a self-scheduled deadline must settle the wait',
-    help: {
-        name: 'node wait deadline',
-        summary: 'arm one cancel-on-wake deadline cron for this node',
-        params: [
-            { kind: 'stdin', name: 'body', required: true, constraint: 'Policy delivered urgently to this node if the deadline fires first.' },
-            { kind: 'flag', name: 'until', type: 'string', required: true, constraint: 'Future duration, zoned ISO timestamp, or bare ISO timestamp interpreted in --tz or host-local time.' },
-            { kind: 'flag', name: 'tz', type: 'string', required: false, constraint: 'IANA timezone for a bare ISO --until value.' },
-        ],
-        output: [
-            { name: 'id', type: 'string', required: true, constraint: 'The armed cron id.' },
-            { name: 'name', type: 'string', required: true, constraint: 'The cron label.' },
-            { name: 'fires_at', type: 'string', required: true, constraint: 'Absolute UTC deadline.' },
-            { name: 'guidance', type: 'string', required: true, constraint: 'How to inspect the cron and dorm.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Arms one anchored cancel-on-wake cron. Any wake of this node cancels it; otherwise it urgently sends the body to this node at the deadline.',
-            'Re-arming replaces this node’s pending deadline rather than stacking a second.',
-        ],
-    },
-    run: async (input) => {
-        const self = armerId();
-        const body = typeof input['body'] === 'string' ? input['body'].trim() : '';
-        if (body === '')
-            throw new InputError({ error: 'empty_body', message: 'a deadline body is required', field: 'body', next: 'Pass the timeout policy on stdin.' });
-        const until = typeof input['until'] === 'string' ? input['until'].trim() : '';
-        if (until === '')
-            throw new InputError({ error: 'missing_until', message: '--until is required', field: 'until', next: 'Pass a future duration or timestamp.' });
-        const tz = typeof input['tz'] === 'string' && input['tz'].trim() !== '' ? input['tz'] : undefined;
-        const now = new Date();
-        const parsed = parseWhen(until, parseOpts(now, tz));
-        if ('error' in parsed)
-            throwTimeError(parsed.error);
-        const profile = envProfileId();
-        // One deadline per node: the arm seam REPLACES this node's pending
-        // cancel-on-wake cron rather than stacking a second one (see armCron in
-        // core/canvas/crons.ts, where the invariant is enforced for every caller).
-        const cron = await cliClient().armCron({
-            name: `deadline:${self}`,
-            command: deadlineHeredoc(body, self),
-            fire_at: parsed.fireAt,
-            recur: null,
-            tz: tz ?? null,
-            created_by: self,
-            cwd: process.cwd(),
-            profile: profile !== undefined && profile !== '' ? profile : null,
-            scope: 'profile',
-            on_output: 'on-failure',
-            sink: null,
-            tier: 'normal',
-            expires_at: null,
-            anchor_node: self,
-            cancel_on_wake: true,
-            run_timeout_s: 300,
-            overlap: 'skip',
-        }).catch(rethrowAsCliError);
-        const guidance = `Deadline cron armed for ${cron.fire_at}${etaHint(cron.fire_at, now)}. End your turn to dorm; any earlier wake cancels it. Inspect pending schedules with \`crtr cron list\`.`;
-        return { id: cron.cron_id, name: cron.name, fires_at: cron.fire_at, guidance };
-    },
-    render: (r) => `Deadline cron armed — ${r['name']} (${r['id']}), fires ${r['fires_at']}.\n\n${r['guidance']}`,
-});
-const nodeWait = defineLeaf({
-    name: 'controller',
-    description: 'wait durably for a named controller message',
-    whenToUse: 'you are a terminal node blocked on one specific live parent or controller and have no managed-child subscription whose report will wake you',
-    help: {
-        name: 'node wait controller',
-        summary: 'declare that your next stop may dorm only until one live controller delivers an inbox message',
-        params: [
-            { kind: 'positional', name: 'controller', type: 'string', required: true, constraint: 'Live node id expected to send the message. It may be your parent or another named controller, but cannot be yourself.' },
-        ],
-        output: [
-            { name: 'node_id', type: 'string', required: true, constraint: 'The terminal node that declared the wait.' },
-        ],
-        outputKind: 'object',
-        effects: ['Durably records the controller on this node. The stop guard permits dormancy only while that controller remains active or idle; its next inbox delivery clears the record before the delivery wakes this node.'],
-    },
-    run: async (input) => {
-        const nodeId = envNodeId();
-        if (nodeId === undefined || nodeId === '')
-            throw new InputError({ error: 'no_node', message: 'no node to wait (CRTR_NODE_ID unset)', next: 'Run from inside the terminal node that is blocked.' });
-        const node = await getNodeOrNull(nodeId);
-        if (node === null)
-            throw new InputError({ error: 'not_found', message: `no node: ${nodeId}`, next: 'Run from a live canvas node.' });
-        if (node.lifecycle !== 'terminal')
-            throw new InputError({ error: 'resident_node', message: `node ${nodeId} is resident and may already dorm on its inbox`, next: 'Use this only from a terminal node that needs the stop guard to recognize a controller dependency.' });
-        const controller = String(input['controller']).trim();
-        if (controller === nodeId)
-            throw new InputError({ error: 'self_controller', message: 'a node cannot wait for its own message', field: 'controller', next: 'Name the parent or external controller expected to send the message.' });
-        // The server validates the controller exists + is live and records the wait
-        // (handleWait); a 404/422 surfaces as the clean CLI error.
-        await cliClient()
-            .waitNode(nodeId, { controller })
-            .catch((err) => rethrowAsCliError(err));
-        return { node_id: nodeId };
-    },
-    render: () => 'Waiting for the controller. End your turn to dorm; its next message wakes you and clears this wait.',
-});
-export const nodeWaitBranch = defineBranch({
-    name: 'wait',
-    description: 'declare a durable controller or deadline wait',
-    whenToUse: 'a terminal node must dorm for one named controller, or race its inbox against a self-scheduled deadline',
-    help: {
-        name: 'node wait',
-        summary: 'declare durable wait state; choose the event that settles it',
-        model: 'Both waits belong to the calling terminal node and settle on one future event. A controller wait records an existing node as the wake source; a deadline wait arms an urgent one-shot cron that races any earlier inbox delivery and is canceled when that delivery wins.',
-    },
-    children: [nodeWait, nodeWaitDeadline],
-});
+var p=Object.defineProperty;var o=(e,n)=>p(e,"name",{value:n,configurable:!0});import{envNodeId as m,envProfileId as g}from"../../shared/env.js";import{defineBranch as y,defineLeaf as u}from"../../core/command.js";import{InputError as i}from"../../core/io.js";import{parseWhen as _}from"../../core/wake.js";import{cliClient as h,getNodeOrNull as b,rethrowAsCliError as f}from"../api-client.js";import{shellQuote as x}from"../surface/node/placement.js";function v(){const e=m();if(e===void 0||e==="")throw new i({error:"no_node",message:"no node to anchor a deadline cron (CRTR_NODE_ID unset)",next:"Run from inside a node."});return e}o(v,"armerId");function k(e,n){return n!==void 0&&n.trim()!==""?{tz:n,now:e}:{now:e}}o(k,"parseOpts");function I(e){const n={wake_in_past:'Pick a future instant \u2014 a positive duration ("5m","2h") or an ISO time later than now.',bad_when:'Use a duration ("5m","1h30m"), a zoned ISO ("2026-06-07T09:00:00Z"), or a bare ISO ("2026-06-07T09:00").',bad_cadence:'Use a duration ("6h"), a 5-field cron ("0 9 * * *"), or an @alias ("@daily").',unknown_zone:'Pass --tz with an IANA zone name (e.g. "America/New_York").',cadence_too_fast:'Use a cadence of at least 60s (e.g. "1m","5m","1h").'};throw new i({error:e.code,message:e.message,received:e.received,next:n[e.code]??"Fix the time value and retry."})}o(I,"throwTimeError");function T(e,n){const t=new Date(e).getTime()-n.getTime();if(!Number.isFinite(t)||t<=0)return"";const r=Math.round(t/6e4);if(r<60)return` (~${r}m)`;const a=Math.round(t/36e5);return a<48?` (~${a}h)`:` (~${Math.round(t/864e5)}d)`}o(T,"etaHint");function $(e,n){let t="CRTR_DEADLINE",r=0;const a=new Set(e.split(`
+`));for(;a.has(t);)t=`CRTR_DEADLINE_${++r}`;return`crtr cron cancel "$CRTR_CRON_ID"
+crtr node message send --to ${x(n)} --tier urgent <<'${t}'
+${e}
+${t}`}o($,"deadlineHeredoc");const D=u({name:"deadline",description:"race this node\u2019s next wake against one urgent deadline cron",whenToUse:"you are waiting on an event nothing can push for, so a self-scheduled deadline must settle the wait",help:{name:"node wait deadline",summary:"arm one cancel-on-wake deadline cron for this node",params:[{kind:"stdin",name:"body",required:!0,constraint:"Policy delivered urgently to this node if the deadline fires first."},{kind:"flag",name:"until",type:"string",required:!0,constraint:"Future duration, zoned ISO timestamp, or bare ISO timestamp interpreted in --tz or host-local time."},{kind:"flag",name:"tz",type:"string",required:!1,constraint:"IANA timezone for a bare ISO --until value."}],output:[{name:"id",type:"string",required:!0,constraint:"The armed cron id."},{name:"name",type:"string",required:!0,constraint:"The cron label."},{name:"fires_at",type:"string",required:!0,constraint:"Absolute UTC deadline."},{name:"guidance",type:"string",required:!0,constraint:"How to inspect the cron and dorm."}],outputKind:"object",effects:["Arms one anchored cancel-on-wake cron. Any wake of this node cancels it; otherwise it urgently sends the body to this node at the deadline.","Re-arming replaces this node\u2019s pending deadline rather than stacking a second."]},run:o(async e=>{const n=v(),t=typeof e.body=="string"?e.body.trim():"";if(t==="")throw new i({error:"empty_body",message:"a deadline body is required",field:"body",next:"Pass the timeout policy on stdin."});const r=typeof e.until=="string"?e.until.trim():"";if(r==="")throw new i({error:"missing_until",message:"--until is required",field:"until",next:"Pass a future duration or timestamp."});const a=typeof e.tz=="string"&&e.tz.trim()!==""?e.tz:void 0,c=new Date,s=_(r,k(c,a));"error"in s&&I(s.error);const l=g(),d=await h().armCron({name:`deadline:${n}`,command:$(t,n),fire_at:s.fireAt,recur:null,tz:a??null,created_by:n,cwd:process.cwd(),profile:l!==void 0&&l!==""?l:null,scope:"profile",on_output:"on-failure",sink:null,tier:"normal",expires_at:null,anchor_node:n,cancel_on_wake:!0,run_timeout_s:300,overlap:"skip"}).catch(f),w=`Deadline cron armed for ${d.fire_at}${T(d.fire_at,c)}. End your turn to dorm; any earlier wake cancels it. Inspect pending schedules with \`crtr cron list\`.`;return{id:d.cron_id,name:d.name,fires_at:d.fire_at,guidance:w}},"run"),render:o(e=>`Deadline cron armed \u2014 ${e.name} (${e.id}), fires ${e.fires_at}.
+
+${e.guidance}`,"render")}),R=u({name:"controller",description:"wait durably for a named controller message",whenToUse:"you are a terminal node blocked on one specific live parent or controller and have no managed-child subscription whose report will wake you",help:{name:"node wait controller",summary:"declare that your next stop may dorm only until one live controller delivers an inbox message",params:[{kind:"positional",name:"controller",type:"string",required:!0,constraint:"Live node id expected to send the message. It may be your parent or another named controller, but cannot be yourself."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The terminal node that declared the wait."}],outputKind:"object",effects:["Durably records the controller on this node. The stop guard permits dormancy only while that controller remains active or idle; its next inbox delivery clears the record before the delivery wakes this node."]},run:o(async e=>{const n=m();if(n===void 0||n==="")throw new i({error:"no_node",message:"no node to wait (CRTR_NODE_ID unset)",next:"Run from inside the terminal node that is blocked."});const t=await b(n);if(t===null)throw new i({error:"not_found",message:`no node: ${n}`,next:"Run from a live canvas node."});if(t.lifecycle!=="terminal")throw new i({error:"resident_node",message:`node ${n} is resident and may already dorm on its inbox`,next:"Use this only from a terminal node that needs the stop guard to recognize a controller dependency."});const r=String(e.controller).trim();if(r===n)throw new i({error:"self_controller",message:"a node cannot wait for its own message",field:"controller",next:"Name the parent or external controller expected to send the message."});return await h().waitNode(n,{controller:r}).catch(a=>f(a)),{node_id:n}},"run"),render:o(()=>"Waiting for the controller. End your turn to dorm; its next message wakes you and clears this wait.","render")}),S=y({name:"wait",description:"declare a durable controller or deadline wait",whenToUse:"a terminal node must dorm for one named controller, or race its inbox against a self-scheduled deadline",help:{name:"node wait",summary:"declare durable wait state; choose the event that settles it",model:"Both waits belong to the calling terminal node and settle on one future event. A controller wait records an existing node as the wake source; a deadline wait arms an urgent one-shot cron that races any earlier inbox delivery and is canceled when that delivery wins."},children:[R,D]});export{S as nodeWaitBranch};

package/dist/commands/node-context.js

@@ -1,159 +1,2 @@
-// `crtr node inspect context` — browse this node's context and reports dirs and those of
-// every node it subscribes to, in one read-only nvim file explorer.
-//
-// crtr makes a STRONG CLAIM that nvim is installed (see
-// .crouter/memory/INDEX.md): the file explorer + file viewer are nvim, not a
-// hand-rolled view-contract surface.
-// We synthesize a temp dir of LABELLED NODE DIRS — `self` first, then one per
-// subscription — and place `context` / `reports` symlinks inside each label dir
-// for the node's existing on-disk dirs. We then open `nvim -R` on the temp tree
-// (read-only: this is a viewer into siblings' state, edits never write back).
-// The symlinks are torn down when nvim exits; the real node dirs are untouched.
-//
-// Re-plumbed onto the API (Stage B-3): the ROSTER (self + the nodes it
-// subscribes to) comes from crtrd (`GET /v1/nodes/{id}/context`). The nvim
-// viewer tail stays a local viewer surface — the symlink tree is built from pure
-// `contextDir`/`reportsDir`/`nodeDir` path helpers over the roster's node ids,
-// and the on-disk existence filter is a local fs read (neither touches canvas
-// state). The /context popup (src/pi-extensions/canvas-context.ts) shells this
-// leaf inside a tmux display-popup. Piped / non-TTY it prints the roster.
-import { envNodeId } from '../shared/env.js';
-import { spawnSync } from 'node:child_process';
-import { existsSync, mkdirSync, mkdtempSync, rmSync, symlinkSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { defineLeaf } from '../core/command.js';
-import { InputError } from '../core/io.js';
-import { contextDir, nodeDir, reportsDir } from '../core/canvas/paths.js';
-import { cliClient, rethrowAsCliError } from './api-client.js';
-/** Make a node label safe as a directory name (netrw shows it verbatim). */
-function sanitize(s) {
-    return s.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'node';
-}
-/** Resolve the current node + every node it subscribes to into browse roots via
- *  the API, keeping any node whose `context/` or `reports/` dir exists on disk.
- *  `self` is always first and labelled `self-<name>`. The API roster is
- *  UNFILTERED (self + all subscriptions); the on-disk existence filter is
- *  applied locally, and the label/dir are derived from pure path helpers to
- *  match the pre-API output. */
-async function resolveRoots(selfId) {
-    const listing = await cliClient().getContext(selfId);
-    const roots = [];
-    for (const r of listing.roots) {
-        const ctx = contextDir(r.node_id);
-        const reports = reportsDir(r.node_id);
-        if (!existsSync(ctx) && !existsSync(reports))
-            continue;
-        const short = r.node_id.slice(0, 8);
-        const label = r.self ? `self-${sanitize(r.label)}` : `${sanitize(r.label)}-${short}`;
-        roots.push({
-            nodeId: r.node_id,
-            label,
-            dir: nodeDir(r.node_id),
-            self: r.self,
-            fileCount: r.files,
-            contextDir: ctx,
-            reportsDir: reports,
-        });
-    }
-    return roots;
-}
-/** Is `nvim` on PATH and runnable? */
-function nvimAvailable() {
-    const r = spawnSync('nvim', ['--version'], { stdio: 'ignore' });
-    return r.error === undefined && (r.status === 0 || r.status === null);
-}
-/** Build a temp dir of labelled node dirs. Self's label is prefixed `0-` so it
- *  sorts first in netrw; each label dir contains `context` and `reports` symlinks
- *  for whichever of those dirs exist on disk. */
-function buildSymlinkTree(roots) {
-    const tree = mkdtempSync(join(tmpdir(), 'crtr-context-'));
-    for (const r of roots) {
-        const name = r.self ? `0-${r.label}` : r.label;
-        const nodeRoot = join(tree, name);
-        mkdirSync(nodeRoot, { recursive: true });
-        try {
-            if (existsSync(r.contextDir)) {
-                symlinkSync(r.contextDir, join(nodeRoot, 'context'), 'dir');
-            }
-            if (existsSync(r.reportsDir)) {
-                symlinkSync(r.reportsDir, join(nodeRoot, 'reports'), 'dir');
-            }
-        }
-        catch {
-            /* best-effort: a label collision or symlink failure just drops that node */
-        }
-    }
-    return tree;
-}
-export const nodeContextLeaf = defineLeaf({
-    name: 'context',
-    description: 'browse this node + its subscriptions’ context and reports dirs in an nvim popup',
-    whenToUse: 'you want to SEE what the nodes you subscribe to have written — open a read-only nvim file explorer over this node’s context and reports dirs and every subscribed node’s context and reports dirs at once. The /context popup shells this. Piped it prints the roster instead',
-    help: {
-        name: 'node inspect context',
-        summary: 'open a read-only nvim file explorer over this node’s context and reports dirs and those of every node it subscribes to',
-        params: [
-            { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Node id to root on. Defaults to $CRTR_NODE_ID (the calling node).' },
-        ],
-        output: [
-            { name: 'roots', type: 'object[]', required: true, constraint: 'Resolved browse roots: {node_id, label, dir, self, files}. Returned on the piped/non-TTY path.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'TTY: builds a temp dir of labelled node dirs, symlinking each available `context`/`reports` dir inside it, then execs `nvim -R` on the tree; the temp links are removed on exit (real dirs untouched).',
-            'Requires nvim on PATH (a crtr strong dependency). Missing nvim -> error with an install hint.',
-            'Non-TTY / piped: prints the resolved roster and exits 0; opens nothing.',
-        ],
-    },
-    run: async (input) => {
-        const selfId = input['node']?.trim() || envNodeId();
-        if (selfId === undefined || selfId === '') {
-            throw new InputError({
-                error: 'no_node',
-                message: 'no current node: $CRTR_NODE_ID is unset and --node was not given',
-                field: 'node',
-                next: 'Run this from inside a canvas node (the /context popup does), or pass --node <id>.',
-            });
-        }
-        let roots;
-        try {
-            roots = await resolveRoots(selfId);
-        }
-        catch (err) {
-            rethrowAsCliError(err);
-        }
-        const rosterOut = roots.map((r) => ({ node_id: r.nodeId, label: r.label, dir: r.dir, self: r.self, files: r.fileCount }));
-        // Non-TTY: print the roster and exit. Opens nothing.
-        if (!process.stdout.isTTY) {
-            return { roots: rosterOut };
-        }
-        if (!nvimAvailable()) {
-            throw new InputError({
-                error: 'nvim_missing',
-                message: 'nvim is not on PATH — `crtr node inspect context` opens the context explorer in nvim',
-                next: 'Install Neovim (macOS: `brew install neovim`; Debian/Ubuntu: `apt install neovim`), then retry.',
-            });
-        }
-        const tree = buildSymlinkTree(roots);
-        try {
-            // `nvim -R .` opens netrw (or the user's dir handler) read-only, cwd = the
-            // symlink tree, so the explorer roots on `self` + each subscription.
-            spawnSync('nvim', ['-R', '.'], { cwd: tree, stdio: 'inherit' });
-        }
-        finally {
-            rmSync(tree, { recursive: true, force: true }); // removes symlinks only; targets untouched
-        }
-        return { roots: rosterOut };
-    },
-    render: (result) => {
-        const roots = result['roots'] ?? [];
-        if (roots.length === 0)
-            return 'No node dirs to show (no subscriptions with written context or reports, and this node’s own context/reports dirs are empty/absent).';
-        const lines = roots.map((r) => {
-            const tag = r['self'] === true ? ' (self)' : '';
-            return `  ${String(r['label'])}${tag}\t${String(r['files'])} files\t${String(r['dir'])}`;
-        });
-        return [`Context roots (${roots.length}):`, ...lines].join('\n');
-    },
-});
+var h=Object.defineProperty;var s=(n,o)=>h(n,"name",{value:o,configurable:!0});import{envNodeId as x}from"../shared/env.js";import{spawnSync as l}from"node:child_process";import{existsSync as d,mkdirSync as v,mkdtempSync as b,rmSync as y,symlinkSync as c}from"node:fs";import{tmpdir as g}from"node:os";import{join as a}from"node:path";import{defineLeaf as w}from"../core/command.js";import{InputError as p}from"../core/io.js";import{contextDir as D,nodeDir as T,reportsDir as _}from"../core/canvas/paths.js";import{cliClient as R,rethrowAsCliError as S}from"./api-client.js";function u(n){return n.replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"node"}s(u,"sanitize");async function $(n){const o=await R().getContext(n),t=[];for(const e of o.roots){const r=D(e.node_id),i=_(e.node_id);if(!d(r)&&!d(i))continue;const m=e.node_id.slice(0,8),f=e.self?`self-${u(e.label)}`:`${u(e.label)}-${m}`;t.push({nodeId:e.node_id,label:f,dir:T(e.node_id),self:e.self,fileCount:e.files,contextDir:r,reportsDir:i})}return t}s($,"resolveRoots");function C(){const n=l("nvim",["--version"],{stdio:"ignore"});return n.error===void 0&&(n.status===0||n.status===null)}s(C,"nvimAvailable");function I(n){const o=b(a(g(),"crtr-context-"));for(const t of n){const e=t.self?`0-${t.label}`:t.label,r=a(o,e);v(r,{recursive:!0});try{d(t.contextDir)&&c(t.contextDir,a(r,"context"),"dir"),d(t.reportsDir)&&c(t.reportsDir,a(r,"reports"),"dir")}catch{}}return o}s(I,"buildSymlinkTree");const H=w({name:"context",description:"browse this node + its subscriptions\u2019 context and reports dirs in an nvim popup",whenToUse:"you want to SEE what the nodes you subscribe to have written \u2014 open a read-only nvim file explorer over this node\u2019s context and reports dirs and every subscribed node\u2019s context and reports dirs at once. The /context popup shells this. Piped it prints the roster instead",help:{name:"node inspect context",summary:"open a read-only nvim file explorer over this node\u2019s context and reports dirs and those of every node it subscribes to",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Node id to root on. Defaults to $CRTR_NODE_ID (the calling node)."}],output:[{name:"roots",type:"object[]",required:!0,constraint:"Resolved browse roots: {node_id, label, dir, self, files}. Returned on the piped/non-TTY path."}],outputKind:"object",effects:["TTY: builds a temp dir of labelled node dirs, symlinking each available `context`/`reports` dir inside it, then execs `nvim -R` on the tree; the temp links are removed on exit (real dirs untouched).","Requires nvim on PATH (a crtr strong dependency). Missing nvim -> error with an install hint.","Non-TTY / piped: prints the resolved roster and exits 0; opens nothing."]},run:s(async n=>{const o=n.node?.trim()||x();if(o===void 0||o==="")throw new p({error:"no_node",message:"no current node: $CRTR_NODE_ID is unset and --node was not given",field:"node",next:"Run this from inside a canvas node (the /context popup does), or pass --node <id>."});let t;try{t=await $(o)}catch(i){S(i)}const e=t.map(i=>({node_id:i.nodeId,label:i.label,dir:i.dir,self:i.self,files:i.fileCount}));if(!process.stdout.isTTY)return{roots:e};if(!C())throw new p({error:"nvim_missing",message:"nvim is not on PATH \u2014 `crtr node inspect context` opens the context explorer in nvim",next:"Install Neovim (macOS: `brew install neovim`; Debian/Ubuntu: `apt install neovim`), then retry."});const r=I(t);try{l("nvim",["-R","."],{cwd:r,stdio:"inherit"})}finally{y(r,{recursive:!0,force:!0})}return{roots:e}},"run"),render:s(n=>{const o=n.roots??[];if(o.length===0)return"No node dirs to show (no subscriptions with written context or reports, and this node\u2019s own context/reports dirs are empty/absent).";const t=o.map(e=>{const r=e.self===!0?" (self)":"";return`  ${String(e.label)}${r}	${String(e.files)} files	${String(e.dir)}`});return[`Context roots (${o.length}):`,...t].join(`
+`)},"render")});export{H as nodeContextLeaf};

package/dist/commands/node-inspect-artifacts.js

@@ -1,109 +1,8 @@
-// `crtr node inspect artifacts` — enumerate one node's artifacts as refs.
-// Re-plumbed onto the API (Stage B-3): the artifact listing runs server-side in
-// crtrd (`GET /v1/nodes/{id}/artifacts?type=`). `--sort` is applied client-side
-// (the DTO carries the timestamp), and the byte-size suffix is reconstructed
-// client-side from each artifact's `<node-id>:<relpath>` ref via the pure
-// `nodeDir` path helper (the DTO deliberately omits size).
-import { statSync } from 'node:fs';
-import { join } from 'node:path';
-import { defineLeaf } from '../core/command.js';
-import { nodeDir } from '../core/canvas/paths.js';
-import { cliClient, rethrowAsCliError } from './api-client.js';
-const TYPES = ['report', 'doc', 'roadmap', 'inbox'];
-/** Byte size of the file behind an artifact ref (`<node-id>:<relpath>`), or 0
- *  when the ref is synthetic (inbox) or the file is unreadable — matching the
- *  pre-API leaf, which sized only file-backed artifacts. */
-function sizeForRef(ref, source) {
-    if (source === 'inbox' || source === 'meta')
-        return 0;
-    const idx = ref.indexOf(':');
-    if (idx < 0)
-        return 0;
-    const nodeId = ref.slice(0, idx);
-    const relpath = ref.slice(idx + 1);
-    if (relpath === '' || relpath === 'meta')
-        return 0;
-    try {
-        return statSync(join(nodeDir(nodeId), relpath)).size;
-    }
-    catch {
-        return 0;
-    }
-}
-export const nodeArtifactsLeaf = defineLeaf({
-    name: 'artifacts',
-    description: 'enumerate one node\'s artifacts as refs',
-    whenToUse: 'you have a node id and want to see everything it left behind — its reports and context docs as refs ready for `canvas history read`. The bridge from "found the node" to "read its artifacts". Use `node inspect show` instead for the node\'s topology/neighbors, not its content.',
-    help: {
-        name: 'node inspect artifacts',
-        summary: 'list one node\'s artifacts (reports + context docs) as refs ready for `canvas history read`',
-        params: [
-            { kind: 'positional', name: 'node-id', required: true, constraint: 'The node whose artifacts to list.' },
-            { kind: 'flag', name: 'type', type: 'enum', choices: [...TYPES], required: false, constraint: 'Narrow to one corpus: report | doc | roadmap | inbox. Default: report, doc, roadmap (inbox is opt-in only — the node\'s inbox history including full un-clipped direct-message bodies; a diagnostic surface, not curated past work).' },
-            { kind: 'flag', name: 'sort', type: 'enum', choices: ['recency', 'oldest'], required: false, constraint: 'Order by artifact timestamp. Default recency.' },
-        ],
-        output: [
-            { name: 'node', type: 'string', required: true, constraint: 'Node name + id.' },
-            { name: 'artifacts', type: 'object[]', required: true, constraint: 'Each: {ref, source, ts, detail}. source = report:<kind> | doc | roadmap | inbox. detail = report title / doc heading + size (inbox: `[kind] label`, no size). ref passes verbatim to `canvas history read`.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const nodeId = input['nodeId'].trim();
-        const type = input['type'];
-        const sort = input['sort'] ?? 'recency';
-        const client = cliClient();
-        let name;
-        let arts;
-        try {
-            // getNode both resolves the node name and enforces existence (404 → the
-            // clean not_found payload); getArtifacts serves the (optionally narrowed)
-            // corpus. Both round-trips run against the same daemon read.
-            const [detail, list] = await Promise.all([
-                client.getNode(nodeId),
-                client.getArtifacts(nodeId, type !== undefined ? { type } : undefined),
-            ]);
-            name = detail.name;
-            arts = list.artifacts;
-        }
-        catch (err) {
-            rethrowAsCliError(err, 'List nodes with `crtr node inspect list`, or find one with `crtr canvas history search`.');
-        }
-        const ms = (ts) => Date.parse(ts) || 0;
-        arts.sort((a, b) => (sort === 'oldest' ? ms(a.ts) - ms(b.ts) : ms(b.ts) - ms(a.ts)) || a.ref.localeCompare(b.ref));
-        const artifacts = arts.map((a) => {
-            const size = sizeForRef(a.ref, a.source);
-            return {
-                ref: a.ref,
-                source: a.source,
-                ts: a.ts,
-                detail: a.title + (size > 0 ? `  (${size}B)` : ''),
-            };
-        });
-        return {
-            node: `${name} (${nodeId})`,
-            artifacts,
-            follow_up: 'Read one with `crtr canvas history read <ref>`; reopen the node with `crtr node lifecycle revive ' + nodeId + '`.',
-        };
-    },
-    render: (r) => {
-        const arts = r['artifacts'];
-        const parts = [`node: ${r['node']}`];
-        if (arts.length === 0) {
-            parts.push('0 artifacts.');
-        }
-        else {
-            const cols = Object.keys(arts[0]);
-            const head = `| ${cols.join(' | ')} |`;
-            const sep = `| ${cols.map(() => '---').join(' | ')} |`;
-            const body = arts
-                .map((a) => `| ${cols.map((c) => String(a[c] ?? '').replace(/\|/g, '\\|').replace(/\n/g, ' ')).join(' | ')} |`)
-                .join('\n');
-            parts.push(`${arts.length} artifacts:\n\n${head}\n${sep}\n${body}`);
-        }
-        parts.push(String(r['follow_up']));
-        return parts.join('\n\n');
-    },
-});
+var l=Object.defineProperty;var d=(r,t)=>l(r,"name",{value:t,configurable:!0});import{statSync as m}from"node:fs";import{join as u}from"node:path";import{defineLeaf as h}from"../core/command.js";import{nodeDir as y}from"../core/canvas/paths.js";import{cliClient as g,rethrowAsCliError as b}from"./api-client.js";const w=["report","doc","roadmap","inbox"];function x(r,t){if(t==="inbox"||t==="meta")return 0;const o=r.indexOf(":");if(o<0)return 0;const i=r.slice(0,o),n=r.slice(o+1);if(n===""||n==="meta")return 0;try{return m(u(y(i),n)).size}catch{return 0}}d(x,"sizeForRef");const C=h({name:"artifacts",description:"enumerate one node's artifacts as refs",whenToUse:'you have a node id and want to see everything it left behind \u2014 its reports and context docs as refs ready for `canvas history read`. The bridge from "found the node" to "read its artifacts". Use `node inspect show` instead for the node\'s topology/neighbors, not its content.',help:{name:"node inspect artifacts",summary:"list one node's artifacts (reports + context docs) as refs ready for `canvas history read`",params:[{kind:"positional",name:"node-id",required:!0,constraint:"The node whose artifacts to list."},{kind:"flag",name:"type",type:"enum",choices:[...w],required:!1,constraint:"Narrow to one corpus: report | doc | roadmap | inbox. Default: report, doc, roadmap (inbox is opt-in only \u2014 the node's inbox history including full un-clipped direct-message bodies; a diagnostic surface, not curated past work)."},{kind:"flag",name:"sort",type:"enum",choices:["recency","oldest"],required:!1,constraint:"Order by artifact timestamp. Default recency."}],output:[{name:"node",type:"string",required:!0,constraint:"Node name + id."},{name:"artifacts",type:"object[]",required:!0,constraint:"Each: {ref, source, ts, detail}. source = report:<kind> | doc | roadmap | inbox. detail = report title / doc heading + size (inbox: `[kind] label`, no size). ref passes verbatim to `canvas history read`."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only."]},run:d(async r=>{const t=r.nodeId.trim(),o=r.type,i=r.sort??"recency",n=g();let f,c;try{const[e,s]=await Promise.all([n.getNode(t),n.getArtifacts(t,o!==void 0?{type:o}:void 0)]);f=e.name,c=s.artifacts}catch(e){b(e,"List nodes with `crtr node inspect list`, or find one with `crtr canvas history search`.")}const a=d(e=>Date.parse(e)||0,"ms");c.sort((e,s)=>(i==="oldest"?a(e.ts)-a(s.ts):a(s.ts)-a(e.ts))||e.ref.localeCompare(s.ref));const p=c.map(e=>{const s=x(e.ref,e.source);return{ref:e.ref,source:e.source,ts:e.ts,detail:e.title+(s>0?`  (${s}B)`:"")}});return{node:`${f} (${t})`,artifacts:p,follow_up:"Read one with `crtr canvas history read <ref>`; reopen the node with `crtr node lifecycle revive "+t+"`."}},"run"),render:d(r=>{const t=r.artifacts,o=[`node: ${r.node}`];if(t.length===0)o.push("0 artifacts.");else{const i=Object.keys(t[0]),n=`| ${i.join(" | ")} |`,f=`| ${i.map(()=>"---").join(" | ")} |`,c=t.map(a=>`| ${i.map(p=>String(a[p]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);o.push(`${t.length} artifacts:
+
+${n}
+${f}
+${c}`)}return o.push(String(r.follow_up)),o.join(`
+
+`)},"render")});export{C as nodeArtifactsLeaf};