@north-light/cli 0.0.0 → 0.3.414

package/dist/commands/revive.js

@@ -0,0 +1,10 @@
+var f=Object.defineProperty;var o=(n,t)=>f(n,"name",{value:t,configurable:!0});import{defineLeaf as h}from"../core/command.js";import{InputError as u}from"../core/io.js";import{requireScope as v}from"../core/errors.js";import{cliClient as m}from"./api-client.js";import{routes as g}from"../api/index.js";import{fullName as p}from"../core/canvas/labels.js";import{recordedPidLiveness as w}from"../core/canvas/pid.js";const L=h({name:"revive",description:"mass-reconnect every disconnected node",whenToUse:"you need to bring back EVERY disconnected node at once (engine not running but a saved session intact) \u2014 the recovery after a reboot, a killed login/tmux session, a mass crash, or the daemon being down a while. You rarely need this for an ordinary crash \u2014 the daemon auto-revives those. To bring back ONE named node (a follow-up on a finished worker, a canceled node, or an on-demand kick of a hanging one), use `node lifecycle revive <id>` instead",help:{name:"canvas revive",summary:"mass-reconnect every disconnected node (engine not running, resumable saved session)",params:[{kind:"flag",name:"all",type:"bool",required:!1,default:!1,constraint:"Required (rejected without it) \u2014 confirms this is the graph-wide sweep, not a typo for a single-node revive (that lives at `node lifecycle revive <id>`). Excludes done/canceled (terminal-by-choice). Run it once to PREVIEW the candidates; nothing is launched until you confirm."},{kind:"flag",name:"force",type:"bool",required:!1,default:!1,hidden:!0,constraint:"Confirm the sweep (internal gate; see code comment)."}],output:[{name:"mode",type:"string",required:!0,constraint:'"preview" (the candidate list, nothing launched) or "revived" (the sweep ran).'},{name:"candidates",type:"string",required:!1,constraint:"Preview: the node ids that WOULD be revived (newline-joined). Empty when none are disconnected."},{name:"revived",type:"string",required:!1,constraint:"Sweep: the node ids whose broker engine was relaunched (newline-joined)."},{name:"failed",type:"string",required:!1,constraint:"Sweep: node ids whose relaunch threw, with the error (newline-joined). Absent when none failed."},{name:"frozen",type:"string",required:!1,constraint:"Sweep: node ids the live-broker cap turned away (newline-joined). Not failures \u2014 the daemon launches each as a slot frees. Absent when none were frozen."}],outputKind:"object",effects:["Launches the detached headless broker engine (no tmux window) for every disconnected node.","Updates each revived node's canvas record: status=active, intent=null.","Without --force: launches NOTHING \u2014 only previews the disconnected candidates."]},run:o(async n=>{if(v("crtr:act","crtr canvas revive"),n.all!==!0)throw new u({error:"missing_parameter",message:"`canvas revive` is the mass-recovery sweep and requires --all.",next:"Run `crtr canvas revive --all` to reconnect every disconnected node, or `crtr node lifecycle revive <id>` to bring back one named node."});return k(n)},"run")}),y=["done","canceled"];function b(n){return!(n.kind==="human"||w(n.pi_pid,null)==="alive"||n.final_report!=null||y.includes(n.status))}o(b,"passesCheapDisconnectedFilter");function E(n){return n.map(t=>`  ${t.node_id}  ${p(t)}  [${t.status}]`).join(`
+`)}o(E,"describe");async function k(n){const t=n.force??!1,d=m(),l=(await d.listNodes()).filter(b),r=[];for(const i of l){const s=await d.getNode(i.node_id);s.pi_session_id!=null&&r.push(s)}if(r.length===0)return{mode:"preview",candidates:"",message:"No disconnected nodes \u2014 every node with a resumable session already has a running engine. Nothing to revive."};if(!t){const i=E(r);return{mode:"preview",candidates:r.map(s=>s.node_id).join(`
+`),message:`${r.length} disconnected node(s) WOULD be revived (RESUME). Nothing has been launched yet:
+
+${i}
+
+Reviving all of these at once can have large, unforeseen consequences (a flood of resumed engines, cost, side effects from each node continuing its work). This is a preview only \u2014 DOUBLE-CHECK WITH THE USER that they want every node above brought back before you proceed. Once they confirm, re-run the revive with confirmation to actually relaunch them.`}}const e=await d.request("POST",g.reviveAll()),a={mode:"revived",revived:e.revived.join(`
+`),message:`Revived ${e.revived.length} disconnected node(s) (RESUME).`};e.failed.length>0&&(a.failed=e.failed.map(i=>`${i.node_id}: ${i.error}`).join(`
+`)),e.frozen.length>0&&(a.frozen=e.frozen.join(`
+`));const c=e.revived.length+e.failed.length+e.frozen.length;return c>e.revived.length&&(a.message=`Revived ${e.revived.length} of ${c} disconnected node(s) (RESUME)`+(e.failed.length>0?`; ${e.failed.length} failed to relaunch (see failed)`:"")+(e.frozen.length>0?`; ${e.frozen.length} frozen at the broker cap and launched as slots free (see frozen)`:"")+"."),a}o(k,"runReviveAll");export{L as reviveLeaf};

package/dist/commands/surface/node/cycle.d.ts

@@ -0,0 +1 @@
+export declare const surfaceNodeCycleLeaf: import("../../../core/command.js").LeafDef;

package/dist/commands/surface/node/cycle.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var c=(n,s)=>f(n,"name",{value:s,configurable:!0});import{defineLeaf as u}from"../../../core/command.js";import{cliCanvasSource as l,getNodeOrNull as p,rethrowAsCliError as h}from"../../api-client.js";import{currentTmux as m,focusViewer as w,nodeInPane as g}from"./placement.js";async function v(){const n=await l().listNodes({status:["active","idle"]}).catch(h),s=new Set(n.map(e=>e.node_id)),d=new Map;for(const e of n){const t=e.parent;if(t!=null&&s.has(t)){const a=d.get(t)??[];a.push(e.node_id),d.set(t,a)}}const o=[],r=new Set,i=c(e=>{if(!r.has(e)){r.add(e),o.push(e);for(const t of d.get(e)??[])i(t)}},"visit");for(const e of n)(e.parent==null||!s.has(e.parent))&&i(e.node_id);for(const e of n)i(e.node_id);return o}c(v,"liveDfsOrder");const _=u({name:"cycle",description:"DFS-walk to the next/prev live node's viewer",whenToUse:"sweeping the canvas one viewer at a time, descending into children before siblings (bound to Alt+] forward / Alt+[ back). Use `surface node focus` instead to jump straight to a named node",help:{name:"surface node cycle",summary:"focus the next/previous live node's viewer in DFS pre-order \u2014 the canvas walked one viewer at a time, descending into a node's children before its siblings (bound to Alt+] forward / Alt+[ back)",params:[{kind:"flag",name:"dir",type:"enum",choices:["next","prev"],required:!1,default:"next",constraint:"Direction along the pre-order: next (Alt+], rightward/deeper into children) or prev (Alt+[, back). Wraps at the ends."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane to cycle FROM. Defaults to $TMUX_PANE / your current pane. The Alt+] / Alt+[ bindings pass this for you."}],output:[{name:"focused",type:"boolean",required:!0,constraint:"True when the neighbor was brought into view."},{name:"node_id",type:"string",required:!1,constraint:"The node now in front of you."},{name:"name",type:"string",required:!1,constraint:"Its display name."},{name:"from",type:"string",required:!1,constraint:"The node you cycled away from."}],outputKind:"object",effects:["Brings the neighbor's viewer forefront beside the caller (like `surface node focus`); the viewer you were watching drops to the background.","Opens a parked resident from its saved snapshot without waking it; submitted input wakes it through the normal message path."]},run:c(async n=>{const s=n.pane??process.env.TMUX_PANE??m()?.pane??void 0,d=n.dir??"next",o=g(s);if(o===void 0)return{focused:!1};const r=await v(),i=r.indexOf(o);if(i===-1||r.length<2)return{focused:!1,node_id:o,from:o};const t=r[(i+(d==="next"?1:-1)+r.length)%r.length],a=await p(t);return a===null?{focused:!1,from:o}:{focused:(await w(t,{cwd:a.cwd,name:a.name,pane:s})).focused,node_id:t,name:a.name,from:o}},"run"),render:c(n=>n.focused===!0?`Cycled to "${n.name??""}" (${n.node_id}) \u2014 from ${n.from??"?"}.`:"No other live node to focus.","render")});export{_ as surfaceNodeCycleLeaf};

package/dist/commands/surface/node/focus.d.ts

@@ -0,0 +1 @@
+export declare const surfaceNodeFocusLeaf: import("../../../core/command.js").LeafDef;

package/dist/commands/surface/node/focus.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var i=(e,n)=>p(e,"name",{value:n,configurable:!0});import{defineLeaf as u}from"../../../core/command.js";import{InputError as l}from"../../../core/io.js";import{focusNode as h}from"../../../core/runtime/focus-viewer.js";import{cliClient as w,rethrowAsCliError as s}from"../../api-client.js";import{currentTmux as f}from"./placement.js";async function d(e,n,a,r=!1,o=!1){const t=await h(e,n,{pane:a,newPane:r,inPlace:o}).catch(c=>s(c));return{focused:t.focused,session:t.session,revived:t.revived,in_place:t.inPlace}}i(d,"focusNodeOrThrow");const x=u({name:"focus",description:"bring a node into view without waking parked or finished work",whenToUse:"you want to bring a specific node into view \u2014 a live node opens beside your pane, while a parked resident opens its saved conversation without waking until input is submitted. FINISHED work \u2014 a terminal worker, or any node that pushed a final report \u2014 opens its saved transcript instead of being put back to work. Use `node lifecycle revive` to deliberately relaunch finished work anyway. Use `surface node cycle` to walk neighbors, and `node message send` to steer without leaving where you are",help:{name:"surface node focus",summary:"bring a node into view \u2014 attach live, open a parked resident without waking it, or inspect finished work as a saved transcript",params:[{kind:"positional",name:"node",required:!0,constraint:"Node id to focus."},{kind:"flag",name:"new-pane",type:"bool",required:!1,constraint:"Always open a NEW viewer SIDE-BY-SIDE with your current pane instead of moving/reusing the node's existing viewer. Two agents on screen at once (F4)."},{kind:"flag",name:"in-place",type:"bool",required:!1,constraint:"Re-exec the --pane pane ONTO this node, REPLACING whatever viewer it showed (a swap in place, not a split beside). Backs the attach viewer's subagent scroll+swap (\u2193 into the reports roster, Enter dives into the child right in your pane). MUST be driven from OUTSIDE that pane's process tree (e.g. `tmux run-shell`) \u2014 respawn-pane -k kills whatever runs in it. Mutually exclusive with --new-pane."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id to focus beside (default: caller TMUX_PANE). Used by the canvas browser popup to focus back into the originating pane."}],output:[{name:"focused",type:"boolean",required:!0,constraint:"True when the node's viewer was brought into view."},{name:"session",type:"string",required:!1,constraint:"The tmux session the viewer lives in."},{name:"revived",type:"boolean",required:!0,constraint:"True when focusing had to recover a non-parked node's broker; false for an already attached viewer, an offline parked resident, or saved-transcript inspection."},{name:"in_place",type:"boolean",required:!0,constraint:"True when an existing viewer was navigated to (no new pane); false when a fresh viewer pane was opened or moved beside you."}],outputKind:"object",effects:["For active/idle nodes: opens/moves the one surface-attach viewer beside the caller, or navigates to its existing viewer.","For an unfinalized parked resident: opens the normal conversation viewer from its saved snapshot without launching a broker or changing lifecycle; submitting input sends the durable human message that wakes it.","For finished work (a terminal node, or any node with a final report): opens a read-only saved transcript popup. It does not launch a broker or change node status.","With --new-pane/--in-place on a conversation viewer: controls whether the viewer splits beside or replaces the caller pane."]},run:i(async e=>{const n=e.node,a=w(),r=await a.getNode(n).catch(t=>s(t,"List nodes with `crtr node inspect list`."));if(r.kind==="human")return d(a,r,"");const o=e.pane??process.env.TMUX_PANE??f()?.pane;if(o===void 0||o==="")throw new l({error:"no_pane",message:`no tmux pane to focus ${n} into \u2014 surfaces need a tmux server, and this call has neither --pane nor a caller pane.`,next:`Run it from inside tmux, pass \`--pane <id>\`, or read the node without a surface: \`crtr node inspect transcript ${n}\`.`});return d(a,r,o,e.newPane===!0,e.inPlace===!0)},"run")});export{x as surfaceNodeFocusLeaf};

package/dist/commands/surface/node/id.d.ts

@@ -0,0 +1 @@
+export declare const surfaceNodeIdLeaf: import("../../../core/command.js").LeafDef;

package/dist/commands/surface/node/id.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(o,e)=>a(o,"name",{value:e,configurable:!0});import{defineLeaf as i}from"../../../core/command.js";import{InputError as d}from"../../../core/io.js";import{writeClipboardText as s}from"../../../core/clipboard-text.js";import{displayMessage as r}from"../../../core/runtime/tmux-chrome.js";import{nodeInPane as p}from"./placement.js";const y=i({name:"id",description:"copy the focused node id to the system clipboard",whenToUse:"you need the id of the node in a tmux pane for a follow-up command or external reference",help:{name:"surface node id",summary:"copy the node resolved from a tmux pane to the system clipboard",params:[{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id whose focused node to copy. Defaults to $TMUX_PANE / your current pane."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The focused node id copied to the system clipboard."}],outputKind:"object",effects:["Writes the focused node id to the system clipboard and shows a transient tmux confirmation."]},run:t(async o=>{const e=o.pane??process.env.TMUX_PANE,n=p(e);if(n===void 0)throw r("crtr: no node in pane",e),new d({error:"no_node",message:"no node found in this pane",next:"Pass --pane <pane-id> for a pane showing an active node."});if(!s(n))throw r("crtr: copy failed",e),new d({error:"clipboard_write_failed",message:"could not write the node id to the system clipboard",next:"Make a system clipboard tool available, then retry."});return r("crtr: node id copied",e),{node_id:n}},"run"),render:t(o=>`Copied node id: ${o.node_id}`,"render")});export{y as surfaceNodeIdLeaf};

package/dist/commands/surface/node/pin.d.ts

@@ -0,0 +1 @@
+export declare const surfaceNodePinLeaf: import("../../../core/command.js").LeafDef;

package/dist/commands/surface/node/pin.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var i=(n,e)=>s(n,"name",{value:e,configurable:!0});import{defineLeaf as d}from"../../../core/command.js";import{InputError as p}from"../../../core/io.js";import{displayMessage as r}from"../../../core/runtime/tmux-chrome.js";import{loadPins as u,savePins as c}from"../../../core/canvas/browse/pins.js";import{nodeInPane as h}from"./placement.js";const y=d({name:"pin",description:"pin or unpin the node in a tmux pane in the canvas navigator",whenToUse:"you want the conversation in this pane starred at the top of your canvas navigator (the same pin `canvas browse` toggles), without opening the navigator to do it",help:{name:"surface node pin",summary:"toggle the canvas-navigator pin on the node resolved from a tmux pane \u2014 a local, per-user view preference that sorts the node to the top of your navigator and fills its Pinned tab, mutating nothing on the canvas",params:[{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id whose focused node to pin. Defaults to $TMUX_PANE / your current pane."}],output:[{name:"node_id",type:"string",required:!0,constraint:"The node whose pin was toggled."},{name:"pinned",type:"boolean",required:!0,constraint:"True when the node is now pinned, false when the pin was removed."}],outputKind:"object",effects:["Toggles the node in the per-user navigator pin set and shows a transient tmux confirmation."]},run:i(async n=>{const e=n.pane??process.env.TMUX_PANE,o=h(e);if(o===void 0)throw r("crtr: no node in pane",e),new p({error:"no_node",message:"no node found in this pane",next:"Pass --pane <pane-id> for a pane showing an active node."});const t=u(),a=!t.has(o);return a?t.add(o):t.delete(o),c(t),r(a?"crtr: conversation pinned":"crtr: conversation unpinned",e),{node_id:o,pinned:a}},"run"),render:i(n=>n.pinned===!0?`Pinned ${n.node_id} in the canvas navigator.`:`Unpinned ${n.node_id}.`,"render")});export{y as surfaceNodePinLeaf};

package/dist/commands/surface/node/placement.d.ts

@@ -0,0 +1,30 @@
+import { closePane, currentTmux, displayPopup, paneCurrentPath, paneExists, panePid, paneStartCommand, respawnPaneInPlace, respawnPaneSync, shellQuote, viewerSplitEnv } from '../../../core/runtime/placement-tmux.js';
+import { viewerEnv, viewerPaneOf, type FocusViewerOpts, type FocusViewerResult } from '../../../core/runtime/focus-viewer.js';
+export { closePane, currentTmux, displayPopup, paneCurrentPath, paneExists, panePid, paneStartCommand, respawnPaneInPlace, respawnPaneSync, shellQuote, viewerSplitEnv };
+export { viewerEnv, viewerPaneOf };
+/** `focusViewer` bound to the CLI's daemon client, with daemon failures
+ *  rethrown as clean CLI errors. The implementation is shared with the attach
+ *  viewer in `core/runtime/focus-viewer.ts`. */
+export declare function focusViewer(nodeId: string, opts: FocusViewerOpts): Promise<FocusViewerResult>;
+/** Open a viewer for a freshly-spawned --root node in a FRESH WINDOW in the
+ *  caller's current tmux session (the --root spawn-viewer path). Pure tmux; the
+ *  broker is already launching server-side, so the attach pane self-polls the
+ *  cold socket. Returns the opened window/session, empty when not in tmux. */
+export declare function openSpawnViewer(nodeId: string, cwd: string, name: string): {
+    window?: string;
+    session?: string;
+};
+/** The node "in front of you" in a tmux pane, resolved PURELY from the pane's
+ *  `@crtr_node` tag. Defaults to $TMUX_PANE / the caller's current pane when
+ *  `pane` is omitted — shared by `node lifecycle recycle` / `node lifecycle
+ *  demote` / `node config --lifecycle` / `node lifecycle close` / `surface node cycle`,
+ *  and the `canvas chord` leaf.
+ *
+ *  A `crtr surface attach` viewer self-tags its pane with the node it views
+ *  (`@crtr_node`) — the tag IS the handle (a broker engine runs DETACHED with
+ *  window=null, so there is no window→node fallback). Kept SYNC + tag-only: the
+ *  CLI does not read canvas state to confirm the tagged node is
+ *  still live, so a stale tag (attach SIGKILLed without clearing) resolves until
+ *  the pane is respawned. Callers that mutate then re-validate the id via the
+ *  API (getNode 404 → clean error). */
+export declare function nodeInPane(pane?: string): string | undefined;

package/dist/commands/surface/node/placement.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var i=(n,e)=>c(n,"name",{value:e,configurable:!0});import{closePane as p,currentTmux as s,displayPopup as u,ensureSession as d,getPaneOption as f,openNodeWindow as w,paneCurrentPath as l,paneExists as P,panePid as m,paneStartCommand as v,respawnPaneInPlace as x,respawnPaneSync as h,selectPane as E,selectWindow as S,shellQuote as C,viewerSplitEnv as V}from"../../../core/runtime/placement-tmux.js";import{focusViewer as g,viewerEnv as a,viewerPaneOf as y}from"../../../core/runtime/focus-viewer.js";import{cliClient as W,rethrowAsCliError as A}from"../../api-client.js";async function M(n,e){return g(W(),n,e).catch(A)}i(M,"focusViewer");function Q(n,e,o){const r=s()?.session;if(r===void 0||r==="")return{};d(r,e);const t=w({session:r,name:o,cwd:e,env:a(),command:`crtr surface attach to ${n}`});return t===null?{}:(S(r,t.window),E(t.pane),{window:t.window,session:r})}i(Q,"openSpawnViewer");function U(n){const e=n??process.env.TMUX_PANE??s()?.pane;if(e===void 0||e==="")return;const o=f(e,"@crtr_node");return o!==void 0&&o!==""?o:void 0}i(U,"nodeInPane");export{p as closePane,s as currentTmux,u as displayPopup,M as focusViewer,U as nodeInPane,Q as openSpawnViewer,l as paneCurrentPath,P as paneExists,m as panePid,v as paneStartCommand,x as respawnPaneInPlace,h as respawnPaneSync,C as shellQuote,a as viewerEnv,y as viewerPaneOf,V as viewerSplitEnv};

package/dist/commands/surface-edit.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const surfaceEditLeaf: LeafDef;

package/dist/commands/surface-edit.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var s=(n,e)=>d(n,"name",{value:e,configurable:!0});import{envNodeId as p}from"../shared/env.js";import{existsSync as h,statSync as l}from"node:fs";import{isAbsolute as c,resolve as u}from"node:path";import{defineLeaf as f}from"../core/command.js";import{InputError as o}from"../core/io.js";import{currentTmux as w,splitWindow as m,paneLocation as g,paneOfNode as v}from"../core/runtime/placement-tmux.js";import{shellQuote as T}from"../shared/shell-quote.js";function E(n){const e=n?.trim();if(e!==void 0&&e!=="")return e;const t=process.env.TMUX_PANE;if(t!==void 0&&t!=="")return t;const r=p();if(r!==void 0&&r!==""){const i=v(r);if(i!==null)return i}return w()?.pane??null}s(E,"resolveTargetPane");const b="${EDITOR:-${VISUAL}}",_=f({name:"edit",description:"open a file in the user's $EDITOR in a new pane beside the pane that opened this command",whenToUse:"you (an agent) want the user to SEE a file WHILE THEY'RE WATCHING YOU \u2014 open it in their $EDITOR in a new pane split beside this node's viewer pane, without them hunting for it. Works headless (the broker reaches the tmux server over its socket). Requires this node to be on screen (a viewer open) or a caller pane; a background node with no viewer gets a no_pane error \u2014 report the path instead and it opens beside you once watched",help:{name:"surface edit",summary:"Open <file> in a new pane running the user's $EDITOR (else $VISUAL), split beside THE PANE THAT OPENED THIS: an explicit --pane, the caller's own $TMUX_PANE, or this node's viewer pane (the pane where the user is watching it). Works from a HEADLESS broker (the tmux server is reached over its socket, no $TMUX needed). A background node with no viewer on screen has no pane to sit beside -> no_pane error. The split is -d, so focus is unchanged",params:[{kind:"positional",name:"file",required:!0,constraint:"Path to open. Relative paths resolve against the current working directory."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id to split beside. Defaults to $TMUX_PANE, else the pane showing this node (its @crtr_node tag), else the attached client's active pane."},{kind:"flag",name:"vertical",type:"bool",required:!1,constraint:"Split top/bottom instead of the default left/right."}],output:[{name:"pane",type:"string",required:!0,constraint:"The new pane id running the editor."},{name:"session",type:"string",required:!1,constraint:"The session the editor pane lives in."},{name:"file",type:"string",required:!0,constraint:"The resolved absolute path opened."}],outputKind:"object",effects:["Opens a NEW pane running the user's $EDITOR (else $VISUAL) on <file> beside the target pane (tmux split-window -d; focus unchanged). Reaches the tmux server over its socket, so it works from a headless broker.","The editor is $EDITOR expanded by the new pane's own shell against the inherited tmux server env \u2014 the same way subagent viewer panes get their env. tmux-native: a web-only surface has no pane to split, so it resolves to a no_pane error rather than being a caller of this.","Requires a pane that opened it to sit beside \u2014 this node\u2019s on-screen viewer, an explicit --pane, or a caller pane. A background node with no viewer errors (no_pane); it does NOT invent a window in some attached session."]},run:s(async n=>{const e=n.file.trim();if(e==="")throw new o({error:"no_file",message:"no file given",field:"file",next:"Pass a path to open."});const t=c(e)?e:u(process.cwd(),e);if(h(t)&&l(t).isDirectory())throw new o({error:"is_directory",message:`${t} is a directory`,field:"file",next:"Pass a file path (surface edit opens a single file in $EDITOR)."});const r=E(n.pane);if(r===null)throw new o({error:"no_pane",message:"no pane to open the editor beside \u2014 this node has no viewer on screen (it is running in the background).",next:"Open a viewer on this node (`crtr surface node focus <id>` / `crtr surface attach`) and retry, pass --pane <pane-id>, or run from inside a tmux pane. To just point the user at a file, report its path instead."});const i=`${b} ${T(t)}`,a=m(r,{cwd:process.cwd(),env:{},command:i,vertical:n.vertical===!0});if(a===null)throw new o({error:"split_failed",message:`tmux split-window failed for ${r}`,next:"Ensure the pane still exists and the tmux window has room (try a wider window)."});return{pane:a,session:g(a)?.session??void 0,file:t}},"run"),render:s(n=>{const e=n;return`opened ${e.file} in a new pane (${e.pane})`},"render")});export{_ as surfaceEditLeaf};

package/dist/commands/surface-inbox.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const surfaceInboxLeaf: LeafDef;

package/dist/commands/surface-inbox.js

@@ -0,0 +1 @@
+var h=Object.defineProperty;var o=(e,t)=>h(e,"name",{value:t,configurable:!0});import{defineLeaf as m}from"../core/command.js";import{currentTmux as c,displayClientMessage as g,liveViewerPanes as w,paneLocation as l,selectPane as f,selectWindow as v,sendAttachControl as x,switchClient as k}from"../core/runtime/placement-tmux.js";const p="No crouter viewer is running \u2014 attach to a node first (crtr surface attach to <node>).";function b(){const e=process.env.TMUX?.split(",")[0]?.trim();return e===void 0||e===""?void 0:e}o(b,"tmuxSocketFromEnvironment");function y(e){if(e!==void 0&&e!=="")return e;const t=process.env.TMUX_PANE;return t!==void 0&&t!==""?t:c()?.pane}o(y,"paneForInvocation");function q(e,t){return e.stampMs!==t.stampMs?t.stampMs-e.stampMs:e.pane===t.pane?0:e.pane<t.pane?-1:1}o(q,"newestViewer");function M(e,t,s){const n=t===void 0?void 0:e.find(r=>r.pane===t);if(n!==void 0)return n;const i=s===void 0?[]:e.filter(r=>r.session===s);return[...i.length>0?i:e].sort(q)[0]}o(M,"selectViewer");function E(e,t,s){if(e.pane===t)return;const n=l(e.pane);if(n===null){f(e.pane);return}s!==n.session&&k(n.session),v(n.session,n.window),f(e.pane)}o(E,"focusViewer");const C=m({name:"inbox",description:"human inbox toggle dispatcher (bound to the inbox-toggle key; not run by hand)",whenToUse:"never directly \u2014 the inbox-toggle keybinding routes the user\u2019s own request through it. An agent that wants a decision uses crtr human send; how the user reaches their inbox is theirs.",tier:"hidden",hookEligible:!1,help:{name:"surface inbox",summary:"deliver the human inbox toggle to a live viewer",guide:"Selection prefers the target pane, then the resolved client session by newest viewer stamp, then newest globally; ties use pane id. The viewer decides whether the delivered toggle opens or closes the surface.",params:[{kind:"flag",name:"tmux-socket",type:"path",required:!1,constraint:"Tmux server socket. Omit to use the first field of $TMUX."},{kind:"flag",name:"tmux-client",type:"string",required:!1,constraint:"Tmux client name for the status-line message and client-session context."},{kind:"flag",name:"target-pane",type:"string",required:!1,constraint:"Viewer pane to prefer. Omit to use $TMUX_PANE or the current tmux pane as the selection target."},{kind:"flag",name:"quiet",type:"bool",required:!1,default:!1,constraint:"Suppress the structured command result. A no-viewer status-line message is still shown."}],output:[{name:"action",type:"opened | skipped",required:!0,constraint:"opened means the private inbox toggle sequence was delivered to a live viewer; it does not assert that the surface is now open. skipped means delivery did not happen."},{name:"message",type:"string",required:!1,constraint:"Present when action is skipped. With no live viewer, the same message is also shown in the tmux status line."}],outputKind:"object",effects:["Sends the private inbox attach-control sequence to one live viewer and focuses that viewer unless it is already the target pane. Never opens a popup, launches a viewer, or wakes a node. With --quiet, suppresses only the structured result."]},run:o(async e=>{const t=e.quiet,s=e.tmuxSocket??b(),n=e.tmuxClient,i=y(e.targetPane);if(s===void 0)return t?void 0:{action:"skipped",message:"the inbox needs tmux"};const r=w(s),d=(i===void 0?void 0:r.find(a=>a.pane===i))?.session??(i===void 0?void 0:l(i)?.session)??c()?.session,u=M(r,i,d);return u===void 0?(g(s,n,p),t?void 0:{action:"skipped",message:p}):x(s,u.pane,"crtr.attach.inbox.toggle")?(E(u,i,d),t?void 0:{action:"opened"}):t?void 0:{action:"skipped",message:"could not deliver the inbox toggle to the selected viewer"}},"run")});export{C as surfaceInboxLeaf};

package/dist/commands/surface-inspect.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const surfaceInspectLeaf: LeafDef;

package/dist/commands/surface-inspect.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(e,t)=>a(e,"name",{value:t,configurable:!0});import{defineLeaf as i}from"../core/command.js";import{InputError as c}from"../core/io.js";import{inspectorCore as p}from"../core/inspector/core.js";import{inspectorText as d}from"../core/inspector/text.js";import{inspectorTui as u}from"../core/inspector/tui.js";import{inTmux as f}from"../core/runtime/placement-tmux.js";import{runInspector as m}from"../core/inspector/host.js";const x=i({name:"inspect",description:"host the native Inspector for one node",whenToUse:"you want a live native screen for a node\u2019s overview, raw record, owner-scoped crons, and live background bash jobs. Use node inspect show for the underlying one-shot data read instead.",help:{name:"surface inspect",summary:"host the native Inspector in this pane (the attach viewer opens it as a tmux popup)",params:[{kind:"positional",name:"node",required:!0,constraint:"Node id or resolvable reference to inspect."},{kind:"flag",name:"section",type:"enum",choices:["overview","schedule","jobs","raw"],required:!1,default:"overview",constraint:"Section focused when the Inspector opens."},{kind:"flag",name:"read-only",type:"bool",required:!1,constraint:"Offer no cron cancel or job stop, so the Inspector cannot change canvas state."}],output:[],outputKind:"object",effects:["Reads node, cron, and background bash job data through crtr subprocesses and crtrd. Takes over the hosting pane (or popup) until it quits."]},run:o(async e=>{const t=e.node,r=e.section??"overview",s=e.readOnly===!0?"true":"false",n=o(()=>m(p,u,d,{options:{target:t,section:r,readOnly:s}}),"host");if(!process.stdin.isTTY||!process.stdout.isTTY){await n();return}if(!f())throw new c({error:"not_in_tmux",message:"Inspector is tmux-only for interactive use.",next:"Run it inside tmux, or pipe `crtr surface inspect <node>` for a static snapshot."});await n()},"run"),render:o(()=>"","render")});export{x as surfaceInspectLeaf};

package/dist/commands/surface-node.d.ts

@@ -0,0 +1,2 @@
+import { type BranchDef } from '../core/command.js';
+export declare function registerSurfaceNode(): BranchDef;

package/dist/commands/surface-node.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var e=(o,n)=>r(o,"name",{value:n,configurable:!0});import{defineBranch as a}from"../core/command.js";import{surfaceNodeFocusLeaf as i}from"./surface/node/focus.js";import{surfaceNodeCycleLeaf as d}from"./surface/node/cycle.js";import{surfaceNodeIdLeaf as t}from"./surface/node/id.js";import{surfaceNodePinLeaf as s}from"./surface/node/pin.js";function v(){return a({name:"node",description:"navigate and identify node viewer surfaces",whenToUse:"you need to bring a node viewer into focus, move through live node viewers, copy the node id shown in a pane, or pin that node in your canvas navigator",help:{name:"surface node",summary:"navigate and identify node viewer surfaces",model:"Focus jumps to one named node, cycle walks the live viewer order, id copies the node shown in a pane, and pin stars that node in your navigator."},children:[i,d,t,s]})}e(v,"registerSurfaceNode");export{v as registerSurfaceNode};

package/dist/commands/surface-reload.d.ts

@@ -0,0 +1,7 @@
+import type { LeafDef } from '../core/command.js';
+/** The node a `crtr surface attach to <id>` command line targets. Panes opened
+ *  by a respawn path (the Markdown file-open bridge, the review companion) carry
+ *  a shell-quoted id, so the raw command line is not comparable to the canonical
+ *  one — the target node is. */
+export declare function attachTargetNode(command: string): string | undefined;
+export declare const surfaceReloadLeaf: LeafDef;

package/dist/commands/surface-reload.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var p=(n,e)=>f(n,"name",{value:e,configurable:!0});import{defineLeaf as w}from"../core/command.js";import{InputError as o}from"../core/io.js";import{listProcessTable as l}from"../core/canvas/pid.js";import{displayMessage as a}from"../core/runtime/tmux-chrome.js";import{nodeInPane as v,paneCurrentPath as g,panePid as x,paneStartCommand as y,respawnPaneInPlace as P,respawnPaneSync as _,viewerSplitEnv as $}from"./surface/node/placement.js";function T(n,e){const r=l();if(r===null)return!1;const s=new Map,t=new Map;for(const{pid:d,ppid:c,command:h}of r){t.set(d,h);const m=s.get(c)??[];m.push(d),s.set(c,m)}const u=new RegExp(`(?:^|\\s)surface attach to ${e}(?:\\s|$)`),i=[n];for(;i.length>0;){const d=i.pop(),c=t.get(d);if(c!==void 0&&u.test(c))return!0;const h=s.get(d);h!==void 0&&i.push(...h)}return!1}p(T,"paneTreeHasViewer");function b(n){const e=/(?:^|\s)surface attach to\s+(?:'([^']*)'|"([^"]*)"|(\S+))/.exec(n);return e?.[1]??e?.[2]??e?.[3]}p(b,"attachTargetNode");const R=w({name:"reload",description:"respawn a viewer pane in place onto the current runtime generation",whenToUse:"a viewer pane predates a runtime roll and should be refreshed onto the selected generation without losing the pane or the node it views",help:{name:"surface reload",summary:"kill and re-run a viewer pane\u2019s `crtr surface attach to <node>` command line in place, so the fresh viewer picks up the currently selected runtime generation",params:[{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id hosting the viewer to reload. Defaults to $TMUX_PANE / your current pane. The Alt+C menu passes this for you."}],output:[{name:"pane",type:"string",required:!0,constraint:"The respawned tmux pane."},{name:"node_id",type:"string",required:!0,constraint:"The node whose viewer was reloaded."}],outputKind:"object",effects:["Kills the pane\u2019s viewer process and re-runs the viewer command line in the same pane; the node\u2019s broker engine keeps running untouched."]},run:p(async n=>{const e=n.pane??process.env.TMUX_PANE;if(e===void 0||e==="")throw new o({error:"not_in_tmux",message:"viewer reload is tmux-only \u2014 no tmux pane to target",next:"Run it inside tmux, or pass --pane <pane-id> of a tmux viewer pane."});const r=v(e);if(r===void 0)throw a("crtr: no viewer in pane",e),new o({error:"no_viewer",message:"this pane does not host an attach viewer",next:"Pass --pane <pane-id> for a pane running `crtr surface attach to <node>`."});const s=`crtr surface attach to ${r}`,t=y(e)?.replace(/^"|"$/g,"");if(t!==void 0&&t.startsWith("crtr surface attach ")){if(b(t)!==r)throw a("crtr: viewer/node mismatch in pane",e),new o({error:"no_viewer",message:`this pane's viewer command (${t}) does not match its node tag (${r})`,next:"Pass --pane <pane-id> for a pane running `crtr surface attach to <node>`."});if(!P(e))throw a("crtr: viewer reload failed",e),new o({error:"respawn_failed",message:`tmux could not respawn pane ${e}`,next:"Check the tmux server is reachable, then retry."});return a("crtr: viewer reloaded",e),{pane:e,node_id:r}}const u=x(e);if(u===void 0||!T(u,r))throw a("crtr: no viewer in pane",e),new o({error:"no_viewer",message:"this pane does not host an attach viewer",next:"Pass --pane <pane-id> for a pane running `crtr surface attach to <node>`."});const i=g(e)??process.cwd();if(!_({pane:e,cwd:i,env:$(),command:s}))throw a("crtr: viewer reload failed",e),new o({error:"respawn_failed",message:`tmux could not respawn pane ${e}`,next:"Check the tmux server is reachable, then retry."});return a("crtr: viewer reloaded",e),{pane:e,node_id:r}},"run"),render:p(n=>`Reloaded viewer for ${n.node_id} in pane ${n.pane}.`,"render")});export{b as attachTargetNode,R as surfaceReloadLeaf};

package/dist/commands/surface-tmux-spread.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const tmuxSpreadLeaf: LeafDef;

package/dist/commands/surface-tmux-spread.js

@@ -0,0 +1 @@
+var P=Object.defineProperty;var c=(e,n)=>P(e,"name",{value:n,configurable:!0});import{statSync as T}from"node:fs";import{join as E}from"node:path";import{defineLeaf as N}from"../core/command.js";import{InputError as u}from"../core/io.js";import{cliCanvasSource as S,cliClient as j}from"./api-client.js";import{jobDir as q}from"../core/canvas/paths.js";import{isPidAlive as A}from"../core/canvas/pid.js";import{inTmux as $,currentTmux as F,breakPane as L,selectLayout as g,openViewerPane as O,paneLocation as B,paneExists as C,closePane as I,getPaneOption as M,switchClient as R,selectWindow as U,waitForBrokerViewSocket as V}from"../core/runtime/placement-tmux.js";async function D(e,n){let t=n;const r=new Set([t]);for(;;){const s=(await e.subscribersOf(t))[0]?.node_id;if(s===void 0||r.has(s))break;r.add(s),t=s}return t}c(D,"climbRootViaSource");const X=8;function x(e){try{return T(E(q(e),"telemetry.json"),{throwIfNoEntry:!1})?.mtimeMs??0}catch{return 0}}c(x,"sessionMtime");function K(e){return(e.status==="active"||e.status==="idle")&&A(e.pi_pid??null)}c(K,"brokerAlive");const ie=N({name:"tmux-spread",description:"break the caller's pane into a new window and tile a viewer for every broker-alive node in the local subtree",whenToUse:"you want the whole live subtree you are watching on one tiled tmux window at once, instead of hunting down each node's viewer by hand \u2014 also bound to the `/graph` view's `e` key",help:{name:"surface tmux-spread",summary:"Explode the local subtree into a tiled grid: break the caller's viewer pane into a brand-new window, then tile a surface-attach viewer pane beside it for every broker-alive node (status active/idle + live pi_pid) in the ancestry-root subtree, most-recently-active first, capped at 8 panes",params:[{kind:"positional",name:"node",required:!0,constraint:"The spread anchor (self) \u2014 its ancestry root + descendants define the subtree to tile. Passed as {self} by the `/graph` view's `e` key."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id of the caller's viewer (the pane broken into the new window). Defaults to $TMUX_PANE."}],output:[{name:"window",type:"string",required:!1,constraint:"The new window id holding the tiled spread."},{name:"session",type:"string",required:!1,constraint:"The session the spread window lives in (the caller's session \u2014 break-pane keeps it)."},{name:"nodes",type:"string",required:!0,constraint:"Space-joined ids tiled into the window (self first)."},{name:"overflow",type:"number",required:!0,constraint:"Broker-alive siblings beyond the cap that were NOT shown."}],outputKind:"object",effects:["Breaks the caller's viewer pane into a brand-new tmux window (tmux break-pane).","Opens a surface-attach viewer pane (and a focuses row) for each shown sibling, moving any that had a viewer elsewhere into the spread.","Tiles the window and switches the client onto it."]},run:c(async e=>{if(!$())throw new u({error:"no_tmux",message:"tmux-spread needs a tmux server \u2014 crtr placement is tmux-only.",next:"Run from inside a tmux session (an agent viewer pane)."});const n=e.node,t=e.pane??process.env.TMUX_PANE??F()?.pane;if(t===void 0||t==="")throw new u({error:"no_pane",message:"no caller pane to break out",next:"Run from inside an agent's pane, or pass --pane <pane-id>."});const r=S(),s=j();if(await r.getNode(n)===null)throw new u({error:"not_found",message:`no node: ${n}`,next:"List nodes with `crtr node inspect list`."});const h=await D(r,n),k=await r.view(h),m=(await Promise.all([h,...k].map(o=>r.getNode(o)))).filter(o=>o!==null&&K(o)).filter(o=>o.node_id!==n).sort((o,i)=>x(i.node_id)-x(o.node_id)),b=m.slice(0,X-1),_=m.length-b.length,p=L(t);if(p===null)throw new u({error:"break_failed",message:`tmux break-pane failed for ${t}`,next:"Ensure the pane exists and tmux is healthy."});const f=p.pane,l=p.window,a=B(f)?.session??null,v=await s.focusByPane(t);v!==null&&await s.setFocusPane(v.focus_id,{pane:f,session:a});const y=[n];for(const o of b){const i=o.node_id,d=await s.focusOf(i);d!==null&&d.pane!==null&&(C(d.pane)&&M(d.pane,"@crtr_node")===i&&I(d.pane),await s.closeFocus(d.focus_id)),await V(i);const w=O(i,a??"",{cwd:o.cwd,besidePane:f});w===null||await s.registerFocus({node_id:i,pane:w.pane,session:w.session,window:w.window})===null||(y.push(i),g(l,"tiled"))}return g(l,"tiled"),a!==null&&(R(a),U(a,l)),{window:l,session:a??void 0,nodes:y.join(" "),overflow:_}},"run"),render:c(e=>{const n=e,t=n.overflow>0?` (+${n.overflow} more not shown)`:"";return`spread viewers into window ${n.window??"?"}${t}`},"render")});export{ie as tmuxSpreadLeaf};

package/dist/commands/surface.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef } from '../core/command.js';
+export declare function registerSurface(): BranchDef;

package/dist/commands/surface.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var r=(e,a)=>o(e,"name",{value:a,configurable:!0});import{defineBranch as n}from"../core/command.js";import{registerAttach as t}from"../clients/attach/command.js";import{tmuxSpreadLeaf as c}from"./surface-tmux-spread.js";import{surfaceEditLeaf as s}from"./surface-edit.js";import{registerSurfaceNode as i}from"./surface-node.js";import{surfaceInspectLeaf as m}from"./surface-inspect.js";import{surfaceReloadLeaf as f}from"./surface-reload.js";import{surfaceInboxLeaf as p}from"./surface-inbox.js";function x(){const e=t("surface","important");return n({name:"surface",rootEntry:{concept:"screen-facing surfaces \u2014 node viewers, live broker attachment, and the Inspector",desc:"open and manage screen-facing surfaces",useWhen:"you need a UI or presentation surface rather than a node, document, or graph operation \u2014 node-viewer navigation, live broker attachment, node inspection, tmux placement, or an editor pane"},help:{name:"surface",summary:"open and manage screen-facing surfaces",model:"Choose `node` for navigation among node viewers. The other commands open a broker attachment, node Inspector, subtree spread, reload, or adjacent editor pane."},children:[i(),e,m,f,c,s,p]})}r(x,"registerSurface");export{x as registerSurface};

package/dist/commands/sys/branch.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef, LeafDef } from '../../core/command.js';
+export declare function defineSysBranch(children: (LeafDef | BranchDef)[]): BranchDef;

package/dist/commands/sys/branch.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var t=(e,n)=>o(e,"name",{value:n,configurable:!0});import{defineBranch as r}from"../../core/command.js";const i={concept:"crtr configuration, diagnostics, and self-management",desc:"settings, config, connect, setup, tutorial, doctor, context, sync, migrate, join, update, version, feedback, logs, retry-delivery, support, limits, daemon",useWhen:"managing the crtr installation, inspecting diagnostics, operating the crtrd supervisor process, or registering a hosted runtime with its directory before first boot"},s={name:"sys",summary:"crtr system configuration, settings, diagnostics, and self-management",model:"Configuration and settings own durable behavior; diagnostics and support observe it. Setup, migration, sync, and update change installed or generated state, and join registers a stopped runtime with its directory from an enrollment token, while daemon control owns the supervisor lifecycle."};function d(e){return r({name:"sys",rootEntry:i,help:{...s},children:e})}t(d,"defineSysBranch");export{d as defineSysBranch};

package/dist/commands/sys/config.d.ts

@@ -0,0 +1 @@
+export declare const configBranch: import("../../core/command.js").BranchDef;

package/dist/commands/sys/config.js

@@ -0,0 +1 @@
+var S=Object.defineProperty;var i=(t,e)=>S(t,"name",{value:e,configurable:!0});import{defineBranch as j,defineLeaf as u}from"../../core/command.js";import{InvalidRawSettingsError as T,readConfig as f,readRawSettingsForTarget as q,replaceRawSettingsForTarget as L,updateConfig as R,persistModelLadders as P,configPath as N}from"../../core/config.js";import{usage as o,notFound as g}from"../../core/errors.js";import{requireScopeRoot as _}from"../../core/scope.js";import{resolveScope as h}from"./shared.js";import{resolveProfileOperand as O}from"../../core/profiles/manifest.js";import{SettingsRevisionConflictError as E}from"../../core/scoped-state/settings.js";import{InputError as l}from"../../core/io.js";import{SCOPE_CONFIG_KEYS as C,USER_SETTINGS as U,findUserSetting as m}from"../../core/user-settings.js";const $=C.join(", "),J=U.map(t=>`${t.key} (${t.valueConstraint})`).join(", "),M=new Set(["anthropic","openai"]),I=new Set(["ultra","strong","medium","light"]);function y(t){return M.has(t)}i(y,"isModelProvider");function x(t){return I.has(t)}i(x,"isModelStrength");function w(t,e){const n=e.split(".");let r=t;for(const s of n){if(r===null||typeof r!="object")return;r=r[s]}return r}i(w,"getNestedValue");function A(t){return t==="true"?!0:t==="false"?!1:/^-?\d+$/.test(t)?parseInt(t,10):t}i(A,"parseConfigValue");function b(t,e){if(t.split(".",1)[0]==="brokerThresholds"&&e!=="user")throw o("brokerThresholds are available only in user scope")}i(b,"assertUserScopeBrokerThresholds");function v(t,e){if(t.split(".",1)[0]==="lifecycle"&&e!=="user")throw o("lifecycle settings are available only in user scope")}i(v,"assertUserScopeLifecycle");function F(t,e){if(t==="working_gerunds"&&e!=="user")throw o("working_gerunds is available only in user scope")}i(F,"assertWorkingGerundsScope");function K(t,e){if(t==="whip_messages"&&e!=="user")throw o("whip_messages are available only in user scope")}i(K,"assertWhipMessagesScope");function D(t,e){if(m(t)!==void 0&&e!=="user")throw o(`${t} is available only in user scope`)}i(D,"assertUserSettingScope");function G(t,e){const n=t.split(".");if(n[0]!=="modelLadders")return null;if(n.length===2&&n[1]==="defaultProvider"){if(!y(e))throw o("modelLadders.defaultProvider must be anthropic or openai");return{defaultProvider:e}}if(n.length===3){const r=n[1],s=n[2];if(!y(r))throw o("modelLadders provider must be anthropic or openai");if(!x(s))throw o("modelLadders strength must be ultra, strong, medium, or light");if(e.trim()==="")throw o(`modelLadders.${r}.${s} cannot be empty`);return{[r]:{[s]:e}}}throw o(`unsupported key path for set: ${t}`)}i(G,"modelLadderPatch");function k(t){const e=t.scope;if(e==="project")throw o("project settings remain a JSON file; use `crtr sys config set` or `crtr sys config path --scope project`.");const n=t.profile;if(e==="user"){if(n!==void 0)throw o("--profile is available only with --scope profile.");return{scope:"user"}}if(n===void 0)throw o("--profile is required with --scope profile.");return{scope:"profile",profileId:O(n).profileId}}i(k,"rawSettingsTarget");function Q(t){let e;try{e=JSON.parse(t)}catch{throw new l({error:"invalid_request",message:"stdin must be valid JSON",field:"stdin",next:"Pipe one complete JSON object on stdin."})}if(e===null||typeof e!="object"||Array.isArray(e))throw new l({error:"invalid_request",message:"stdin must be a JSON object",field:"stdin",next:"Pipe one complete JSON object on stdin."});return e}i(Q,"parseRawSettings");function W(t,e,n,r){const s=e.split("."),c=s[0];if(e==="working_gerunds"||e==="whip_messages"){let a;try{a=JSON.parse(n)}catch{throw o(`${e} must be a JSON array of non-empty strings`)}if(!Array.isArray(a)||a.length===0||!a.every(d=>typeof d=="string"&&d.trim()!==""))throw o(`${e} must be a non-empty JSON array of non-empty strings`);t[e]=a.map(d=>d.trim());return}if(c==="keybindings")throw o("keybindings are edited only through `crtr sys settings`");if(c==="modelLadders")throw o("modelLadders keys are written through persistModelLadders, not this path");const p=m(e);if(p!==void 0){const a=p.setFromString(t,n);if(a!==null)throw o(a);return}if(c==="brokerThresholds"){if(s.length!==2||s[1]!=="warning"&&s[1]!=="automaticReviveCap")throw o("brokerThresholds key must be warning or automaticReviveCap");if(typeof r!="number"||!Number.isFinite(r)||r<1)throw o(`brokerThresholds.${s[1]} must be an integer >= 1`);const a=Math.floor(r);if(s[1]==="warning"&&a>t.brokerThresholds.automaticReviveCap)throw o("brokerThresholds.warning must be <= brokerThresholds.automaticReviveCap");if(s[1]==="automaticReviveCap"&&a<t.brokerThresholds.warning)throw o("brokerThresholds.automaticReviveCap must be >= brokerThresholds.warning");t.brokerThresholds[s[1]]=a;return}if(c==="lifecycle"){if(s.length!==2||s[1]!=="unattendedParkMs")throw o("lifecycle key must be unattendedParkMs");if(typeof r!="number"||!Number.isFinite(r)||r<1)throw o("lifecycle.unattendedParkMs must be an integer >= 1");t.lifecycle.unattendedParkMs=Math.floor(r);return}throw o(`unsupported key path for set: ${e}`)}i(W,"setNestedValue");const B=u({name:"get",description:"read a config value by key",whenToUse:"you want to inspect one config value \u2014 including the whole user keybindings object \u2014 optionally from a specific scope. Use sys settings to edit keybindings and sys config set for supported scalar settings.",help:{name:"sys config get",summary:"read a config value by dotted key",params:[{kind:"positional",name:"key",type:"string",required:!0,constraint:`Dotted key path. Top-level keys: ${$}. brokerThresholds and lifecycle are user-only; keybindings is readable only as the whole user-scope object and editable only through sys settings.`},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Scope to read from. Default: user."}],output:[{name:"key",type:"string",required:!0,constraint:"Echo of input key."},{name:"value",type:"unknown",required:!0,constraint:"The resolved value. Type depends on the key."},{name:"scope",type:"string",required:!0,constraint:"Scope the value was read from."}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>{const e=t.key,n=h(t.scope);if(b(e,n),v(e,n),e.startsWith("keybindings.")||e==="keybindings"&&n!=="user")throw g("keybindings are available only as the whole user-scope object");const r=f(n),s=w(r,e);if(s===void 0)throw g(`config key not found: ${e}`);return{key:e,value:s,scope:n}},"run")}),H=u({name:"set",description:"write a config value by key",whenToUse:"you want to change a supported crtr setting in user or project scope. Use sys settings instead for keybindings, and sys config get to inspect values.",help:{name:"sys config set",summary:"write a config value by dotted key",params:[{kind:"positional",name:"key",type:"string",required:!0,constraint:`Dotted key path. User-scope scalar settings: ${J}. Also supported: working_gerunds and whip_messages (non-empty JSON string arrays), brokerThresholds.warning and brokerThresholds.automaticReviveCap (user scope; integer >= 1), lifecycle.unattendedParkMs (user scope; integer ms >= 1), modelLadders.defaultProvider, and modelLadders.<anthropic|openai>.<ultra|strong|medium|light>. Keybindings are edited only through sys settings. For arbitrary raw user or profile documents, use sys config get-raw and set-raw.`},{kind:"flag",name:"value",type:"string",required:!0,constraint:"value VALUE \u2014 string, required. working_gerunds and whip_messages accept JSON arrays; other values are stored as-is if quoted and coerced to number or boolean when unambiguous."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Scope to write to. Default: user. Project scope is supported only for modelLadders."}],output:[{name:"value",type:"unknown",required:!0,constraint:"Resolved value as written after parsing and setting-specific coercion."},{name:"scope",type:"string",required:!0,constraint:"Scope the value was written to."}],outputKind:"object",effects:["Writes the updated value through the target scope\u2019s configuration storage."]},run:i(async t=>{const e=t.key,n=t.value,r=h(t.scope);b(e,r),v(e,r),F(e,r),K(e,r),D(e,r);const s=A(n),c=G(e,n),p=c!==null?(P(_(r),c),f(r)):R(r,d=>W(d,e,n,s));return{value:w(p,e),scope:r}},"run")}),V=u({name:"get-raw",description:"read one raw SQL-backed settings document and revision",whenToUse:"you need the exact stored user or profile settings document before replacing it with set-raw.",help:{name:"sys config get-raw",summary:"read one raw user or profile settings document",params:[{kind:"flag",name:"scope",type:"enum",choices:["user","profile","project"],required:!0,constraint:"SQL-backed target: user or profile. project is rejected because its settings remain a JSON file."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id or name to target. Required with --scope profile; rejected with --scope user or project."}],output:[{name:"revision",type:"string",required:!0,constraint:"Opaque revision token for set-raw. absent means the settings row does not exist."},{name:"settings",type:"object | null",required:!0,constraint:"Exact stored settings document, or null when no row exists."}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>q(k(t)),"run")}),z=u({name:"set-raw",description:"replace one raw SQL-backed settings document at a revision",whenToUse:"you have a complete user or profile settings document from get-raw and must replace it without losing a concurrent change.",help:{name:"sys config set-raw",summary:"atomically replace one raw user or profile settings document",params:[{kind:"flag",name:"scope",type:"enum",choices:["user","profile","project"],required:!0,constraint:"SQL-backed target: user or profile. project is rejected because its settings remain a JSON file."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id or name to target. Required with --scope profile; rejected with --scope user or project."},{kind:"flag",name:"if-revision",type:"string",required:!0,constraint:"Revision returned by get-raw. Required; use absent only when get-raw reported no settings row."},{kind:"stdin",name:"settings",required:!0,allowPositional:!1,constraint:"One complete JSON object. It replaces the document exactly; values are not normalized or merged."}],output:[{name:"revision",type:"string",required:!0,constraint:"Revision token of the stored document after this operation."},{name:"changed",type:"boolean",required:!0,constraint:"Whether the stored document changed."}],outputKind:"object",effects:["Atomically replaces the SQL-backed settings document only when --if-revision matches its current revision."]},run:i(async t=>{const e=k(t),n=Q(t.settings);try{return L(e,n,t.ifRevision)}catch(r){throw r instanceof E?new l({error:"settings_revision_conflict",message:"settings changed since the supplied revision",field:"if_revision",next:"Run `crtr sys config get-raw` again, reapply the intended transformation, and retry with its revision."}):r instanceof T?new l({error:"invalid_settings",message:r.message,field:"stdin",next:"Correct the document so crouter can merge it into resolved settings, then retry with a fresh revision."}):r}},"run")}),Y=u({name:"path",description:"print the project config.json path",whenToUse:"you need the project config.json path for inspection or backup. User and profile settings use get-raw and set-raw instead.",help:{name:"sys config path",summary:"print the project config.json path",params:[{kind:"flag",name:"scope",type:"enum",choices:["project","user","profile"],required:!1,constraint:"Project is the only path-backed settings scope. user and profile are rejected because they use SQL-backed get-raw and set-raw. Default: project."}],output:[{name:"paths",type:"object[]",required:!0,constraint:'One {scope: "project", path} entry when the current project has a config file; otherwise empty.'}],outputKind:"object",effects:["None. Read-only."]},run:i(async t=>{const e=t.scope;if(e==="user"||e==="profile")throw o(`${e} settings are SQL-backed; use \`crtr sys config get-raw --scope ${e}\` instead.`);const n=N("project");return{paths:n===null?[]:[{scope:"project",path:n}]}},"run")}),ce=j({name:"config",description:"read and write configuration",whenToUse:"inspecting crtr settings, changing supported scalar values, replacing complete raw user or profile settings documents, or locating a project config.json. Keybinding changes belong in sys settings.",help:{name:"sys config",summary:"read and write crtr configuration, including model ladders and raw SQL-backed user/profile settings",model:"get and set resolve individual settings. get-raw and set-raw read and replace complete user or profile documents with a revision precondition. path applies only to project config.json."},children:[B,H,V,z,Y]});export{ce as configBranch};

package/dist/commands/sys/connect.d.ts

@@ -0,0 +1 @@
+export declare const sysConnectLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/sys/connect.js

@@ -0,0 +1,3 @@
+var x=Object.defineProperty;var i=(e,n)=>x(e,"name",{value:n,configurable:!0});import{randomBytes as P}from"node:crypto";import R from"node:path";import{defineLeaf as A}from"../../core/command.js";import{readConfig as k,updateConfig as y}from"../../core/config.js";import{emit as S,InputError as s,isJsonOutput as E}from"../../core/io.js";import{renderResult as L}from"../../core/render.js";import{addScopedApiToken as q,getApiToken as b,setApiToken as I}from"../../core/secrets.js";import{ENFORCED as c}from"@north-light/identity";import{envCrtrdTcp as D,envCrtrdToken as v,envNodeId as N}from"../../shared/env.js";import{shellQuote as p}from"../../shared/shell-quote.js";import{cliClient as T}from"../api-client.js";const O="127.0.0.1:8787",$=3e4,M=100;function C(){return P(32).toString("hex")}i(C,"token");function j(e){if(e===void 0)return;const n=String(e).split(",").map(t=>t.trim()).filter(t=>t!=="");if(n.length===0)throw new s({error:"empty_scopes",message:"--scopes names no scope",received:e,field:"scopes",next:`Pass a comma-separated list from ${[...c].join(", ")}; omit the flag for the owner token.`});for(const t of n)if(!c.has(t))throw new s({error:"invalid_scope",message:`invalid scope: ${t}`,field:"scopes",received:t,next:`Use one of ${[...c].join(", ")}.`});return n}i(j,"parseScopes");function U(e){E()?S(e):process.stdout.write(L(e,F.help)+`
+`)}i(U,"printCredentials");function W(e){const n=e.lastIndexOf(":");return n===-1||Number(e.slice(n+1))!==0?e:`${e.slice(0,n+1)}8787`}i(W,"fixedTcpPort");async function z(){const e=T(),n=Date.now()+$;let t;for(;Date.now()<n;){try{const r=await e.status();if(r.listeners.tcp!==null)return r}catch(r){t=r}await new Promise(r=>setTimeout(r,M))}throw new s({error:"listener_unavailable",message:`the successor did not expose a TCP listener within ${$}ms${t instanceof Error?`: ${t.message}`:""}`,next:"Run `crtr sys daemon status` to inspect the daemon, then retry `crtr sys connect`."})}i(z,"awaitTcpListener");async function _(e,n){const t=await e.getModelAuthReadiness(n);if(t.credential==="ready")return;process.stderr.write(`Logging in to ${t.provider} for ${t.model}.
+`);const{loginProvider:r,openProviderLoginRuntime:a,terminalAuthInteraction:m}=await import("./provider-login.js");await r(await a(),t.provider,m());const o=await e.getModelAuthReadiness(n);if(o.credential!=="ready")throw new s({error:"provider_login_incomplete",message:`provider ${o.provider} credential is ${o.credential} after login`,next:`Run \`${B(n)}\` again and complete the provider login.`})}i(_,"ensureProviderCredential");function B(e){return["crtr sys connect",e.profile===void 0?void 0:`--profile ${p(e.profile)}`,e.cwd===void 0?void 0:`--cwd ${p(e.cwd)}`,e.kind===void 0?void 0:`--kind ${p(e.kind)}`,e.model===void 0?void 0:`--model ${p(e.model)}`].filter(n=>n!==void 0).join(" ")}i(B,"connectCommand");const F=A({name:"connect",description:"enable browser access to this daemon",whenToUse:"an application needs a browser-reachable daemon URL and bearer token; this enables the local TCP listener and reports the credentials to paste into that application. Add --app and --scopes to mint an app token instead of the owner token.",help:{name:"sys connect",summary:"enable authenticated browser access and log in to the selected model provider when needed; a handover reports browser credentials before it begins",params:[{kind:"flag",name:"app",type:"string",required:!1,constraint:"App id for the new scoped token (without the app: prefix). Required with --scopes; omit both for the owner token."},{kind:"flag",name:"scopes",type:"string",required:!1,constraint:`Comma-separated list from ${[...c].join(", ")}. Requires --app; mints a NEW app bearer with this resolved scope set. Omit both flags for the owner token.`},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile setting selecting the provider a root launch with these settings would use."},{kind:"flag",name:"cwd",type:"string",required:!1,constraint:"Directory setting selecting the provider a root launch with these settings would use. Default: this directory."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Node kind setting selecting the provider a root launch with these settings would use."},{kind:"flag",name:"model",type:"string",required:!1,constraint:"Model setting selecting the provider a root launch with these settings would use."}],output:[{name:"base_url",type:"string",required:!0,constraint:"The HTTP URL configured for the TCP listener."},{name:"token",type:"string",required:!0,constraint:"The bearer token accepted by that listener: the owner token, or with --scopes the newly minted scoped token. Paste it only into the application that needs daemon access."}],outputKind:"object",effects:["Stores a missing listener address in user settings and a missing owner bearer token in the 0600 user secrets store.","With --scopes, appends a new scoped token to that secrets store; there is no revoke verb yet, so removing one means editing the store by hand.","When the listener is not already up with both settings present, or a scoped token was minted (the daemon reads tokens only at boot), asks the daemon to hand over to a successor.","After the listener is available, resolves the provider selected by these params (default: this directory) and runs its existing OAuth login flow when that provider has no usable credential."]},run:i(async e=>{const n={profile:e.profile,cwd:R.resolve(e.cwd??process.cwd()),kind:e.kind,model:e.model},t=j(e.scopes),r=e.app;if(t===void 0!=(r===void 0)||r!==void 0&&!/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(String(r)))throw new s({error:"invalid_app",message:"--app must name an app id and is required exactly when --scopes is set",field:"app",received:r,next:"Pass --app with an app id and --scopes together, or omit both for the owner token."});const a=N(),o=k("user").api.tcp,l=b("user"),d=T(),w=await d.status();o===""?y("user",h=>{h.api.tcp=O}):Number(o.slice(o.lastIndexOf(":")+1))===0&&y("user",h=>{h.api.tcp=W(o)});const f=D()??k("user").api.tcp;if(Number(f.slice(f.lastIndexOf(":")+1))===0)throw new s({error:"dynamic_tcp_port",message:"CRTRD_TCP must use a fixed port for `crtr sys connect`",next:"Set CRTRD_TCP to a host and fixed port, then run `crtr sys connect` again."});if(t===void 0&&o!==""&&l!==void 0&&w.listeners.tcp!==null)return await _(d,n),{base_url:`http://${w.listeners.tcp}`,token:v()??l};l===void 0&&I(C(),"user");const g=v()??b("user");if(g===void 0)throw new Error("TCP listener cannot start without a bearer token");let u=g;t!==void 0&&(u=C(),q({token:u,grantee:`app:${String(r)}`,scopes:t,created:new Date().toISOString()},"user")),U({base_url:`http://${f}`,token:u}),await d.restartDaemon(),await z(),await _(d,n),a!==void 0&&await d.sendMessage(a,{body:"Browser access is ready.",tier:"urgent",from:a})},"run")});export{F as sysConnectLeaf};

package/dist/commands/sys/context/admin/actions.d.ts

@@ -0,0 +1,23 @@
+import { type AdminDoc, type AdminRecord, type AdminRule } from './model.js';
+export interface ActionOutcome {
+    ok: boolean;
+    message: string;
+    /** The name the document answers to after the action — the new name after a
+     *  move. Absent when the action changed no document. */
+    name?: string;
+}
+/** The notice a write shows instead of writing, or null when the document is
+ *  writable here. A shipped document belongs to its package and is replaced,
+ *  not edited. */
+export declare function readOnlyReason(record: AdminRecord): string | null;
+/** Replace the document's whole rule list. An empty list clears it. */
+export declare function writeRules(record: AdminRecord, rules: AdminRule[], success: string): Promise<ActionOutcome>;
+export declare function toggleUnlisted(record: AdminRecord): Promise<ActionOutcome>;
+export declare function writePreview(record: AdminRecord, line: string): Promise<ActionOutcome>;
+/** The document's current body, read the way `crtr canvas read` reads it —
+ *  which also records the read the following edit is based on. */
+export declare function readBody(doc: AdminDoc): Promise<string>;
+/** Replace the whole body. */
+export declare function writeBody(record: AdminRecord, body: string): Promise<ActionOutcome>;
+/** Rename a document under its own owner. */
+export declare function moveDoc(record: AdminRecord, to: string): Promise<ActionOutcome>;

package/dist/commands/sys/context/admin/actions.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var r=(e,t)=>u(e,"name",{value:t,configurable:!0});import{ApiError as c}from"../../../../api/index.js";import{cliClient as a}from"../../../api-client.js";import{ruleToDTO as l}from"./model.js";const f="editor";function d(e){const t=e.doc;return t.shipped?`${t.displayName} ships with the plugin \u201C${t.ownerHandle}\u201D and is read-only here \u2014 override it with \`crtr doc write ${t.name} --owner user\`.`:null}r(d,"readOnlyReason");function m(e){return e instanceof c?{ok:!1,message:e.message}:{ok:!1,message:e instanceof Error?e.message:String(e)}}r(m,"failure");async function i(e,t,n){const s=d(e);if(s!==null)return{ok:!1,message:s};try{return await a().docs.edit(e.doc.object.id,{rationale:f,...t}),{ok:!0,message:n,name:e.doc.displayName}}catch(o){return m(o)}}r(i,"runEdit");function h(e,t,n){return i(e,t.length===0?{unset:["rules"]}:{rules:t.map(l)},n)}r(h,"writeRules");function v(e){const t=e.doc.displayName;return e.doc.unlisted?i(e,{unset:["unlisted"]},`${t} is listed again.`):i(e,{unlisted:!0},`${t} is now unlisted.`)}r(v,"toggleUnlisted");function $(e,t){const n=t.trim();return n===""?Promise.resolve({ok:!1,message:"A preview cannot be empty \u2014 it is what a reader decides to open the document on."}):i(e,{preview:n},`Rewrote the preview of ${e.doc.displayName}.`)}r($,"writePreview");async function N(e){const t=await a().objects.read(e.object.id);if(t.state!=="object"||t.type!=="document")throw new Error(`${e.displayName} is no longer a readable document.`);const n=t.data;if(n.needs_merge)throw new Error(`${e.displayName} has diverged heads; merge them with \`crtr doc edit\` first.`);return n.bodies[0]??""}r(N,"readBody");function b(e,t){return t.trim()===""?Promise.resolve({ok:!1,message:`An empty body is not an edit \u2014 remove ${e.doc.displayName} with \`crtr doc delete\` instead.`}):i(e,{body:t},`Rewrote the body of ${e.doc.displayName}.`)}r(b,"writeBody");async function k(e,t){const n=t.trim();if(n==="")return{ok:!1,message:"Type the new name."};const s=d(e);if(s!==null)return{ok:!1,message:s};try{const o=await a().docs.move(e.doc.object.id,{new_name:n});return{ok:!0,message:`${e.doc.displayName} now answers to ${o.name}.`,name:o.name}}catch(o){return m(o)}}r(k,"moveDoc");export{k as moveDoc,N as readBody,d as readOnlyReason,v as toggleUnlisted,b as writeBody,$ as writePreview,h as writeRules};

package/dist/commands/sys/context/admin/detail-panel.d.ts

@@ -0,0 +1,73 @@
+import type { NodeConfigSubject } from '../../../../core/substrate/subject-fields.js';
+import type { PlannedEvent } from '../resolve.js';
+import { type AdminRecord } from './model.js';
+import type { DocRow } from './docs-panel.js';
+type SurfaceEvent = PlannedEvent;
+/** A field of the focused document the shell can write. `rule` carries an
+ *  index into the document's whole rule list, not the focused event's subset,
+ *  because that list is what a write replaces. */
+export type DetailRow = {
+    kind: 'rule';
+    at: number;
+} | {
+    kind: 'add-rule';
+} | {
+    kind: 'preview';
+} | {
+    kind: 'unlisted';
+} | {
+    kind: 'body';
+} | {
+    kind: 'move';
+};
+export declare class ContextDetailPanel {
+    private row;
+    private event;
+    private body;
+    private readOnly;
+    private subject;
+    private rows;
+    private index;
+    private face;
+    private open;
+    private scroll;
+    /** Last render's geometry, so a half-pane jump and the end-of-content clamp
+     *  measure against real content rather than a counter nobody can see. */
+    private lastLines;
+    private lastHeight;
+    setContext(row: DocRow | undefined, event: SurfaceEvent, readOnly: string | null, subject: NodeConfigSubject | null, body: string | undefined): void;
+    /** True while the field list owns the pane, so the shell routes the write
+     *  letters and teaches them in the footer. */
+    get editing(): boolean;
+    get bodyOpen(): boolean;
+    get selected(): DetailRow | undefined;
+    /** The rule index a level cycle or a removal would act on. */
+    get selectedRule(): number | undefined;
+    /** `j`/`k`: a line of the read face, a field of the edit face. */
+    move(delta: number): void;
+    /** `ctrl-d`/`ctrl-u`: half a pane, so a long body is crossed in jumps a
+     *  reader can still follow. */
+    page(direction: 1 | -1): void;
+    /** `g`/`G`. */
+    jump(to: 'top' | 'bottom'): void;
+    /** `enter`: the document's own text, in place. The body is not in the plan,
+     *  so the shell fetches it and hands it over through `setContext`. */
+    openBody(): boolean;
+    /** `e`: the field list. */
+    edit(): void;
+    /** `esc`/`h`: leave the edit face, else collapse the body. False means the
+     *  read face is already at rest and the shell should leave the dossier. */
+    back(): boolean;
+    private scrollBy;
+    private maxScroll;
+    private record;
+    private context;
+    render(width: number, height: number, focused: boolean): string[];
+    /** Today's field list, under the identity and delivery it is being edited
+     *  against. A row's clarifying tail renders only while that row is focused:
+     *  unfocused, twelve explanations are twelve lines of noise. */
+    private editLines;
+}
+/** The editable rows for one document, in the order the panel draws them. */
+export declare function buildDetailRows(record: AdminRecord): DetailRow[];
+export {};

package/dist/commands/sys/context/admin/detail-panel.js

@@ -0,0 +1,2 @@
+var $=Object.defineProperty;var u=(r,e)=>$(r,"name",{value:e,configurable:!0});import{truncateToWidth as p,visibleWidth as w}from"@earendil-works/pi-tui";import{padAnsi as y,theme as n,wrapText as k}from"../../../../core/tui/panel.js";import{describeRule as D,plural as L}from"./model.js";import{renderDossierDelivery as H,renderDossierHeader as j,renderDossierRead as O}from"./read-view.js";class U{static{u(this,"ContextDetailPanel")}row;event="boot";body;readOnly=null;subject=null;rows=[];index=0;face="read";open=!1;scroll=0;lastLines=1;lastHeight=1;setContext(e,t,s,a,i){const l=e?.key!==this.row?.key;this.row=e,this.event=t,this.body=i,this.readOnly=s,this.subject=a,this.rows=e===void 0?[]:R(e.anchor),l&&(this.index=0,this.scroll=0,this.open=!1,this.face="read"),this.index=Math.max(0,Math.min(this.index,this.rows.length-1))}get editing(){return this.face==="edit"}get bodyOpen(){return this.open}get selected(){return this.face==="edit"?this.rows[this.index]:void 0}get selectedRule(){const e=this.selected;return e?.kind==="rule"?e.at:void 0}move(e){if(this.face==="edit"){this.index=Math.max(0,Math.min(this.rows.length-1,this.index+e));return}this.scrollBy(e)}page(e){this.face!=="edit"&&this.scrollBy(e*Math.max(1,Math.floor(this.lastHeight/2)))}jump(e){this.face!=="edit"&&(this.scroll=e==="top"?0:this.maxScroll())}openBody(){return this.face==="edit"||this.row===void 0?!1:(this.open=!0,this.scroll=0,!0)}edit(){this.row!==void 0&&(this.face="edit",this.scroll=0)}back(){return this.face==="edit"?(this.face="read",this.scroll=0,!0):this.open?(this.open=!1,this.scroll=0,!0):!1}scrollBy(e){this.scroll=Math.max(0,Math.min(this.scroll+e,this.maxScroll()))}maxScroll(){return Math.max(0,this.lastLines-this.lastHeight)}record(){const e=this.row;return e.records.get(this.event)??e.anchor}context(){return{event:this.event,records:this.row?.records??new Map,readOnly:this.readOnly!==null,body:this.body,subject:this.subject}}render(e,t,s){if(this.row===void 0)return this.lastLines=1,this.lastHeight=t,b([n.fg("dim"," Select a document.")],t);const a=this.record(),i=this.face==="read"?{lines:O(a,this.context(),e,this.open),cursor:void 0}:this.editLines(a,e,s),l=i.lines,d=l.length>t,o=Math.max(1,d?t-1:t);this.lastLines=l.length,this.lastHeight=o;let c;i.cursor===void 0?(this.scroll=Math.max(0,Math.min(this.scroll,Math.max(0,l.length-o))),c=this.scroll):c=Math.min(Math.max(0,i.cursor-Math.floor(o/3)),Math.max(0,l.length-o));const h=b(l.slice(c,c+o),o);return d&&h.push(T(c+1,Math.min(l.length,c+o),l.length,e)),h}editLines(e,t,s){const a=this.context(),i=[...j(e,a,t),...H(e,a,t),""];let l=0;const d=u((h,m,M)=>{const v=[m,...h===this.index&&M!==void 0?S(M,t):[]];h===this.index&&(l=i.length);for(const g of v)i.push(h===this.index&&s?n.bg("selectedBg",y(p(g,t),t)):h===this.index?`${n.fg("accent","\u258C")}${p(g,Math.max(0,t-1))}`:` ${p(g,Math.max(0,t-1))}`)},"push");let o=0;i.push(n.fg("dim"," RULES"));const c=e.doc.rules;c.length===0&&i.push(n.fg("dim"," no rules \u2014 this document only appears in its listing"));for(const h of c){const m=D(h);d(o++,h.on===this.event?m:n.fg("dim",m))}return d(o++,n.fg("success","+ add a delivery rule")),i.push(""),i.push(n.fg("dim"," DOCUMENT")),d(o++,f("preview",e.doc.preview===""?n.fg("dim","none"):e.doc.preview,t)),d(o++,f("unlisted",e.doc.unlisted?"yes":n.fg("dim","no"),t)),d(o++,f("body",n.fg("dim",this.body===void 0?"not read yet":L(B(this.body),"line","lines")),t),"opens in $EDITOR"),d(o++,f("name",e.doc.displayName,t),"renames the document under its own owner"),i.push(` ${f("owner",n.fg("dim",e.doc.ownerHandle),Math.max(0,t-1))}`),i.push(` ${f("object",n.fg("dim",e.doc.object.id),Math.max(0,t-1))}`),{lines:i,cursor:l}}}function R(r){return[...r.doc.rules.map((t,s)=>({kind:"rule",at:s})),{kind:"add-rule"},{kind:"preview"},{kind:"unlisted"},{kind:"body"},{kind:"move"}]}u(R,"buildDetailRows");function B(r){const e=r.replace(/\n+$/,"");return e===""?0:e.split(`
+`).length}u(B,"bodyLines");const x=15;function f(r,e,t){const s=Math.max(1,t-x-2);return`${y(n.fg("dim",r),x)} ${p(e,s)}`}u(f,"field");function S(r,e){const t=Math.max(1,e-x-2);return k(`\u2014 ${r}`,t).map(s=>`${" ".repeat(x+1)}${n.fg("dim",s)}`)}u(S,"tailLines");function T(r,e,t,s){const a=`${r}\u2013${e} / ${t}`;return n.fg("dim",`${" ".repeat(Math.max(0,s-a.length))}${a}`)}u(T,"badge");function b(r,e){const t=[...r];for(;t.length<e;)t.push("");return t.slice(0,e).map(s=>w(s)===0?"":s)}u(b,"fit");export{U as ContextDetailPanel,R as buildDetailRows};

package/dist/commands/sys/context/admin/docs-panel.d.ts

@@ -0,0 +1,63 @@
+import { type PlannedEvent } from '../resolve.js';
+import { PlanSet, type AdminRecord } from './model.js';
+type SurfaceEvent = PlannedEvent;
+import { type Filters } from './list-view.js';
+/** One physical document across every event. `records` is sparse: an event
+ *  whose corpus never reaches this document has no record for it, and an event
+ *  still being planned has none yet either. */
+export interface DocRow {
+    key: string;
+    name: string;
+    /** The record for the focused event, or the first one any event carries —
+     *  every panel needs a document to describe even when the focused event's
+     *  corpus excludes it. */
+    anchor: AdminRecord;
+    records: Map<SurfaceEvent, AdminRecord>;
+    /** Present only in an event other than the focused one. */
+    offEvent: boolean;
+}
+/** The union of every planned event's corpus, ordered by the focused event's
+ *  precedence order with the documents only other events see appended. */
+export declare function buildRows(plans: PlanSet, event: SurfaceEvent): DocRow[];
+export declare class ContextDocsPanel {
+    private readonly onChange;
+    private rows;
+    private filters;
+    private event;
+    private lines;
+    private index;
+    /** Directories the user opened, by full name prefix. Empty means every level
+     *  is collapsed, which is how the page opens: ~25 rows that name the whole
+     *  corpus. */
+    private readonly expanded;
+    constructor(onChange: () => void);
+    /** The document the dossier describes: the focused row, or the first member
+     *  of the focused group so the dossier is never blank. */
+    get selected(): DocRow | undefined;
+    /** Documents the current question selects — counted from the top-level
+     *  rollups, which partition the corpus, so a fully collapsed list still
+     *  reports its size and a nested rollup is never counted twice. */
+    get visibleCount(): number;
+    /** Documents that actually load on the dialled event, counted the same way —
+     *  the numerator of the heading's `N of M`. */
+    get loadedCount(): number;
+    setRows(rows: DocRow[], event: SurfaceEvent): void;
+    setFilters(filters: Filters): void;
+    move(delta: number): void;
+    /** True when the focused line can be opened — a directory header. */
+    get onGroup(): boolean;
+    toggleGroup(): void;
+    /** Rebuild the drawn lines, keeping the cursor on whatever it holds — the
+     *  same document, or the same directory header, which a collapsed group draws
+     *  no document row for — and clamping when what it was on is gone. */
+    private relayout;
+    render(width: number, height: number, focused: boolean): string[];
+    /** A directory header: a pure rollup of its whole subtree — how many of its
+     *  documents load. */
+    private groupLine;
+    private docLine;
+    /** Pad rather than trim: this column sets the length of the divider drawn
+     *  beside it. */
+    private fit;
+}
+export {};

package/dist/commands/sys/context/admin/docs-panel.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var l=(r,t)=>w(r,"name",{value:t,configurable:!0});import{truncateToWidth as f,visibleWidth as y}from"@earendil-works/pi-tui";import{padAnsi as p,theme as o,visibleRange as C}from"../../../../core/tui/panel.js";import{PLANNED_EVENTS as v}from"../resolve.js";import{deliveryStateOf as M,plural as N,stateLabel as L}from"./model.js";import{NO_FILTERS as T,buildListView as S,groupKeysOf as D}from"./list-view.js";function W(r,t){const e=new Map,i=[],n=l(s=>{const d=r.peek(s);if(d!==void 0)for(const h of d.docs){const c=h.doc.object.id,a=e.get(c);if(a===void 0){e.set(c,{key:c,name:h.doc.displayName,anchor:h,records:new Map([[s,h]]),offEvent:s!==t}),i.push(c);continue}a.records.set(s,h),s===t&&(a.anchor=h,a.offEvent=!1)}},"absorb");n(t);for(const s of v)s!==t&&n(s);return i.map(s=>e.get(s))}l(W,"buildRows");const g=10,k=2;class _{static{l(this,"ContextDocsPanel")}onChange;rows=[];filters=T;event="boot";lines=[];index=0;expanded=new Set;constructor(t){this.onChange=t}get selected(){const t=this.lines[this.index];if(t!==void 0)return t.kind==="doc"?t.row:t.first}get visibleCount(){return this.lines.reduce((t,e)=>t+(e.kind==="group"&&e.depth===0?e.docs:0),0)}get loadedCount(){return this.lines.reduce((t,e)=>t+(e.kind==="group"&&e.depth===0?e.rungs.content+e.rungs.preview+e.rungs.name:0),0)}setRows(t,e){this.rows=t,this.event=e;const i=D(t);for(const n of this.expanded)i.has(n)||this.expanded.delete(n);this.relayout()}setFilters(t){this.filters=t,this.relayout()}move(t){this.lines.length!==0&&(this.index=Math.max(0,Math.min(this.lines.length-1,this.index+t)),this.onChange())}get onGroup(){return this.lines[this.index]?.kind==="group"}toggleGroup(){const t=this.lines[this.index];t?.kind==="group"&&(this.expanded.has(t.key)?this.expanded.delete(t.key):this.expanded.add(t.key),this.relayout(),this.onChange())}relayout(){const t=this.lines[this.index];this.lines=S(this.rows,this.filters,this.expanded,this.event);const e=t===void 0?-1:this.lines.findIndex(i=>i.kind===t.kind&&i.key===t.key);this.index=e>=0?e:Math.max(0,Math.min(this.index,this.lines.length-1))}render(t,e,i){const n=[],s=Math.max(1,t-g-2),d=this.filters.query===""?"DOCUMENTS":`/${this.filters.query}`,h=this.filters.query===""?`${this.loadedCount} of ${this.visibleCount} load on ${this.event}`:N(this.visibleCount,"match","matches"),c=`${o.fg("accent",o.bold(d))} ${o.fg("dim",h)}`;if(n.push(` ${p(f(c,s),s)} ${$(o.fg("dim","loads"),g)}`),this.lines.length===0)return n.push("",o.fg("dim",' Nothing matches this question \u2014 cycle a facet back to "any".')),this.fit(n,e);const a=Math.max(1,e-n.length),b=C(this.lines.length,this.index,a);for(let u=b.start;u<b.end;u+=1){const m=this.lines[u],x=m.kind==="group"?this.groupLine(m,s):this.docLine(m,s);n.push(u===this.index&&i?o.bg("selectedBg",p(x,t)):u===this.index?`${o.fg("accent","\u258C")}${f(x.slice(1),Math.max(0,t-1))}`:x)}return this.fit(n,e)}groupLine(t,e){const i=t.expanded?"\u25BE":"\u25B8",n=`${" ".repeat(t.depth*k)}${i} ${o.bold(t.label)}`,s=t.rungs.content+t.rungs.preview+t.rungs.name,d=o.fg(s>0?"success":"dim",`${s} of ${t.docs}`);return` ${p(f(n,e),e)} ${$(d,g)}`}docLine(t,e){const i=f(`${" ".repeat(t.depth*k)}${t.label}`,e),n=t.row.records.get(this.event),s=L(n,M(n)),d=s.text===""?"":o.fg(s.tone,s.text);return` ${p(i,e)} ${$(d,g)}`}fit(t,e){for(;t.length<e;)t.push("");return t.slice(0,e).map(i=>y(i)===0?"":i)}}function $(r,t){const e=y(r);return e>=t?f(r,t):`${" ".repeat(t-e)}${r}`}l($,"field");export{_ as ContextDocsPanel,W as buildRows};

package/dist/commands/sys/context/admin/list-view.d.ts

@@ -0,0 +1,62 @@
+import type { DocKind, Rung } from '../../../../core/substrate/schema.js';
+import type { PlannedEvent } from '../resolve.js';
+import type { DocRow } from './docs-panel.js';
+import type { AdminRecord } from './model.js';
+type SurfaceEvent = PlannedEvent;
+/** The owner types a document can belong to. */
+export declare const OWNER_TYPES: readonly ["node", "user", "profile", "repo", "app"];
+export type RungFacet = 'any' | Exclude<Rung, 'none'> | 'silent';
+export type OriginFacet = 'any' | (typeof OWNER_TYPES)[number];
+export type KindFacet = 'any' | DocKind;
+export type StateFacet = 'any' | 'delivering' | 'gated' | 'shadowed' | 'no-rule';
+/** The question the page is asking. Rung asks what arrives, state asks why it
+ *  does not, and the two compose. Every facet is "any" by default, so the page
+ *  opens on the whole corpus. */
+export interface Filters {
+    rung: RungFacet;
+    origin: OriginFacet;
+    kind: KindFacet;
+    state: StateFacet;
+    /** Fuzzy subsequence over the canonical name only. */
+    query: string;
+}
+export declare const NO_FILTERS: Filters;
+/** One drawn line. A group carries what its whole subtree adds up to, so a
+ *  collapsed list still states where the corpus and its deliveries sit. `depth` is
+ *  how many name segments sit above the line, which the renderer spends on
+ *  indent. */
+export type ListLine = {
+    kind: 'group';
+    key: string;
+    label: string;
+    depth: number;
+    docs: number;
+    rungs: Record<Exclude<Rung, 'none'>, number>;
+    expanded: boolean;
+    /** The document the dossier describes while the cursor rests on the
+     *  header: this directory's own document when it has one, else the first
+     *  document in its subtree. A header never stands in for that document's
+     *  own row — it only keeps the dossier from going blank. */
+    first: DocRow;
+} | {
+    kind: 'doc';
+    key: string;
+    row: DocRow;
+    label: string;
+    depth: number;
+};
+/** Every group key the rows can produce — one per proper name prefix, since a
+ *  prefix exists only because something sits under it — so collapse state can
+ *  drop the keys a re-plan removed instead of accumulating them. The leading
+ *  section is a key only when a name with no `/` owns no directory, which is
+ *  exactly when it is not itself one of those prefixes. */
+export declare function groupKeysOf(rows: readonly DocRow[]): Set<string>;
+/** The lines to draw, in corpus order: the leading section, then each directory
+ *  in order of first appearance, each recursing into its own members only when
+ *  it is open. A live query force-expands every directory, which is exactly the
+ *  ancestor chain of every surviving match, without touching `expanded` — so
+ *  clearing the query restores what the user collapsed. */
+export declare function buildListView(rows: readonly DocRow[], filters: Filters, expanded: ReadonlySet<string>, event: SurfaceEvent): ListLine[];
+/** `user` is the person owner; every other facet is the owner object's type. */
+export declare function ownerTypeOf(record: AdminRecord): string;
+export {};

package/dist/commands/sys/context/admin/list-view.js

@@ -0,0 +1 @@
+var k=Object.defineProperty;var a=(e,n)=>k(e,"name",{value:n,configurable:!0});import{fuzzyMatch as w}from"../../../../core/tui/fuzzy.js";const q=["node","user","profile","repo","app"],b={rung:"any",origin:"any",kind:"any",state:"any",query:""},p="",v="top level";function z(e){const n=new Set,o=[];for(const t of e)if(t.name.includes("/"))for(let s=t.name.indexOf("/");s>=0;s=t.name.indexOf("/",s+1))n.add(t.name.slice(0,s));else o.push(t.name);return o.some(t=>!n.has(t))&&n.add(p),n}a(z,"groupKeysOf");function G(e,n,o,t){const s={key:"",segment:"",depth:-1,children:new Map,selves:[]};for(const u of e){if(!R(u,u.records.get(t),n))continue;let c=s;for(const l of u.name.split("/")){let h=c.children.get(l);h===void 0&&(h={key:c.depth<0?l:`${c.key}/${l}`,segment:l,depth:c.depth+1,children:new Map,selves:[]},c.children.set(l,h)),c=h}c.selves.push(u)}const f=[],i=[];for(const u of s.children.values())u.children.size===0?f.push(...u.selves):i.push(u);const r=[];if(f.length>0){const u=n.query!==""||o.has(p);if(r.push({kind:"group",key:p,label:v,depth:0,...m(f,t),expanded:u,first:f[0]}),u)for(const c of f)r.push(d(c,c.name,1,t))}for(const u of i)y(u,n,o,t,r);return r}a(G,"buildListView");function g(e,n=[]){n.push(...e.selves);for(const o of e.children.values())g(o,n);return n}a(g,"subtree");function y(e,n,o,t,s){if(e.children.size===0){for(const r of e.selves)s.push(d(r,e.segment,e.depth,t));return}const f=g(e),i=n.query!==""||o.has(e.key);if(s.push({kind:"group",key:e.key,label:`${e.segment}/`,depth:e.depth,...m(f,t),expanded:i,first:f[0]}),!!i){for(const r of e.selves)s.push(d(r,e.segment,e.depth+1,t));for(const r of e.children.values())y(r,n,o,t,s)}}a(y,"emit");function d(e,n,o,t){return{kind:"doc",key:e.key,row:e,label:n,depth:o}}a(d,"docLine");function m(e,n){const o={name:0,preview:0,content:0};for(const t of e){const s=t.records.get(n);s!==void 0&&s.finalRung!=="none"&&(o[s.finalRung]+=1)}return{docs:e.length,rungs:o}}a(m,"rollup");function R(e,n,o){if(o.rung!=="any"){const t=n?.finalRung??"none";if(o.rung==="silent"?t!=="none":t!==o.rung)return!1}return!(o.origin!=="any"&&x(e.anchor)!==o.origin||o.kind!=="any"&&e.anchor.doc.kind!==o.kind||o.state!=="any"&&!E(n,o.state)||o.query!==""&&!w(o.query,e.name))}a(R,"passes");function x(e){return e.doc.owner.type==="person"?"user":e.doc.owner.type}a(x,"ownerTypeOf");function E(e,n){if(e===void 0)return n==="no-rule";switch(n){case"delivering":return e.finalRung!=="none";case"gated":return e.matchedRule===null&&e.ruleGate!==null&&!e.ruleGate.pass;case"shadowed":return e.shadowedBy!==null;case"no-rule":return e.authoredRules.length===0}}a(E,"inState");export{b as NO_FILTERS,q as OWNER_TYPES,G as buildListView,z as groupKeysOf,x as ownerTypeOf};