@north-light/cli 0.0.0 → 0.3.413

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

@@ -0,0 +1,123 @@
+import type { DeliveryRuleDTO } from '../../../../api/dto/docs.js';
+import type { NodeConfigSubject } from '../../../../core/substrate/subject-fields.js';
+import { type ContextSnapshot, type PlanRecord, type PlanRule, type PlannedEvent } from '../resolve.js';
+/** The state an agent-engineer dials. Every axis feeds either the rule `if`
+ *  subject or the reader (cwd → repos, profile → limits), and changing one
+ *  re-plans every activity. */
+export interface Snapshot {
+    kind: string;
+    mode: 'base' | 'orchestrator';
+    lifecycle: 'terminal' | 'resident';
+    hasManager: boolean;
+    /** Profile id; null for no profile. */
+    profileId: string | null;
+    cwd: string;
+    /** The live node the page opened on, or null. */
+    nodeId: string | null;
+    grantee?: string;
+    depth: number;
+    event: PlannedEvent;
+    /** `file-read` payload — the file that was read. */
+    file: string;
+    /** `document-read` payload — the document read. */
+    docName: string;
+    /** `command` / `pre-command` payload. */
+    command: string;
+    /** The live node's own cwd and profile: while the snapshot keeps both, the
+     *  dry run reads the node itself, so its own documents stay in view. */
+    seed: {
+        cwd: string;
+        profileId: string | null;
+    } | null;
+}
+/** One profile the rail can cycle through. */
+export interface ProfileChoice {
+    id: string;
+    name: string;
+}
+/** A rule as the dry run returns it: the row fields over JSON. */
+export interface AdminRule extends PlanRule {
+    position?: number;
+}
+/** The delivery document as the dry run serializes it (bodies are not carried). */
+export interface AdminDoc {
+    object: {
+        id: string;
+        type: string;
+        name: string;
+    };
+    owner: {
+        id: string;
+        type: string;
+        name: string;
+    };
+    ownerHandle: string;
+    ownNode: boolean;
+    /** A package document: an installed plugin's or crtr's own, read-only here. */
+    shipped: boolean;
+    kind: 'knowledge' | 'preference';
+    name: string;
+    displayName: string;
+    preview: string;
+    unlisted: boolean;
+    rules: AdminRule[];
+}
+export type AdminRecord = Omit<PlanRecord, 'doc' | 'shadowedBy'> & {
+    doc: AdminDoc;
+    shadowedBy: AdminDoc | null;
+};
+export interface AdminPlan {
+    subject: NodeConfigSubject | null;
+    docs: AdminRecord[];
+}
+/** Which payload axis an activity reads, so the rail offers exactly the one
+ *  field that can make the current activity match anything. */
+export declare function payloadAxisFor(event: PlannedEvent): 'file' | 'docName' | 'command' | null;
+/** The dry-run request a snapshot stands for: the live node as it is (the
+ *  subject axes as overrides) while cwd and profile are still the node's own,
+ *  else a node that does not exist, started from the live node when there is one. */
+export declare function contextSnapshotOf(snapshot: Snapshot): ContextSnapshot;
+/** Every activity's plan for one snapshot, fetched from the daemon. The
+ *  focused activity is asked for first and the rest follow; a plan that lands
+ *  after the snapshot changed is dropped. */
+export declare class PlanSet {
+    private snapshot;
+    private readonly onChange;
+    private readonly plans;
+    /** Plans read for the current documents; a plan outside it is stale and is
+     *  shown only until its replacement lands. */
+    private readonly fresh;
+    private readonly pending;
+    private generation;
+    /** The last dry run's refusal, shown in place of the list. */
+    error: string | undefined;
+    constructor(snapshot: Snapshot, onChange: () => void);
+    setSnapshot(snapshot: Snapshot): void;
+    /** Drop every plan — the snapshot changed, so none of them describes it. */
+    invalidate(): void;
+    /** Re-read every plan after a write changed a document they were read from,
+     *  keeping the old plans on screen until each replacement lands. */
+    refresh(): void;
+    dispose(): void;
+    peek(event: PlannedEvent): AdminPlan | undefined;
+    /** Fetch the focused activity, then every other one. */
+    warm(first: PlannedEvent): void;
+    private fetch;
+}
+/** What one document does in one activity. */
+export type DeliveryState = 'delivers' | 'capped' | 'gated' | 'shadowed' | 'silent';
+export declare function deliveryStateOf(record: AdminRecord | undefined): DeliveryState;
+/** The word the list prints for one document's state, and its tone. A delivery
+ *  names the level it arrives at, warning-toned when the profile limit lowered
+ *  it; a document that does not load prints nothing unless its silence has a
+ *  name the page can act on — `gated` or `shadowed`. */
+export declare function stateLabel(record: AdminRecord | undefined, state: DeliveryState): {
+    text: string;
+    tone: 'success' | 'warning' | 'muted';
+};
+export declare const DELIVER_LEVELS: ("name" | "preview" | "content")[];
+/** A rule back in the shape `PATCH /v1/docs/:ref` takes. */
+export declare function ruleToDTO(rule: AdminRule): DeliveryRuleDTO;
+/** One rule as a single readable row. */
+export declare function describeRule(rule: AdminRule): string;
+export declare function plural(count: number, one: string, many: string): string;

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

@@ -0,0 +1 @@
+var a=Object.defineProperty;var i=(e,n)=>a(e,"name",{value:n,configurable:!0});import{resolve as f}from"node:path";import{RUNGS as o,rungRank as r}from"../../../../core/substrate/schema.js";import{PLANNED_EVENTS as u,dryRun as c}from"../resolve.js";function x(e){return e==="file-read"?"file":e==="document-read"?"docName":e==="command"||e==="pre-command"?"command":null}i(x,"payloadAxisFor");function h(e){const n={kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,hasManager:e.hasManager,orchestration:{depth:e.depth}},t=e.seed;if(e.nodeId!==null&&t!==null&&t.cwd===e.cwd&&t.profileId===e.profileId)return{nodeId:e.nodeId,hypothetical:null,override:n,nodeMissing:!1};const d={cwd:e.cwd,profile:e.profileId,...e.grantee===void 0?{}:{grantee:e.grantee},kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,has_manager:e.hasManager,depth:e.depth};return{nodeId:e.nodeId,hypothetical:d,override:{},nodeMissing:!1}}i(h,"contextSnapshotOf");function s(e,n){if(n==="file-read")return e.file===""?void 0:f(e.cwd,e.file);if(n==="document-read")return e.docName===""?void 0:e.docName;if(n==="command"||n==="pre-command")return e.command===""?void 0:e.command}i(s,"payloadOf");class w{static{i(this,"PlanSet")}snapshot;onChange;plans=new Map;fresh=new Set;pending=new Set;generation=0;error;constructor(n,t){this.snapshot=n,this.onChange=t}setSnapshot(n){this.snapshot=n,this.invalidate()}invalidate(){this.plans.clear(),this.refresh()}refresh(){this.generation+=1,this.fresh.clear(),this.pending.clear(),this.error=void 0}dispose(){this.generation+=1}peek(n){return this.plans.get(n)}warm(n){this.fetch(n);for(const t of u)this.fetch(t)}fetch(n){if(this.fresh.has(n)||this.pending.has(n))return;this.pending.add(n);const t=this.generation;c(h(this.snapshot),n,s(this.snapshot,n)).then(({plan:d})=>{t===this.generation&&(this.pending.delete(n),this.plans.set(n,{subject:d.subject,docs:d.docs}),this.fresh.add(n),this.onChange())},d=>{t===this.generation&&(this.pending.delete(n),this.plans.set(n,{subject:null,docs:[]}),this.fresh.add(n),this.error=d instanceof Error?d.message:String(d),this.onChange())})}}function y(e){return e===void 0?"silent":e.shadowedBy!==null?"shadowed":e.finalRung!=="none"?r(e.finalRung)<r(e.authoredRung)?"capped":"delivers":e.authoredRung!=="none"?"capped":e.matchedRule===null&&e.ruleGate!==null&&!e.ruleGate.pass?"gated":"silent"}i(y,"deliveryStateOf");function R(e,n){return n==="gated"?{text:"gated",tone:"muted"}:n==="shadowed"?{text:"shadowed",tone:"muted"}:e===void 0||e.finalRung==="none"?{text:"",tone:"muted"}:{text:e.finalRung,tone:n==="capped"?"warning":"success"}}i(R,"stateLabel");const S=o.filter(e=>e!=="none");function I(e){return{on:e.on,...e.match===void 0?{}:{match:e.match},...e.matchFrontmatter===void 0?{}:{match_frontmatter:e.matchFrontmatter},...e.if===void 0?{}:{if:e.if},deliver:e.deliver}}i(I,"ruleToDTO");function N(e){const n=[e.on];return e.match!==void 0&&e.match.length>0&&n.push(e.match.join(" | ")),e.matchFrontmatter!==void 0&&n.push(`fm ${JSON.stringify(e.matchFrontmatter)}`),e.if!==void 0&&n.push(`if ${JSON.stringify(e.if)}`),`${n.join("  ")} \u2192 ${e.deliver}`}i(N,"describeRule");function E(e,n,t){return`${e} ${e===1?n:t}`}i(E,"plural");export{S as DELIVER_LEVELS,w as PlanSet,h as contextSnapshotOf,y as deliveryStateOf,N as describeRule,x as payloadAxisFor,E as plural,I as ruleToDTO,R as stateLabel};

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

@@ -0,0 +1,84 @@
+import { type PlannedEvent } from '../resolve.js';
+import { type ProfileChoice, type Snapshot } from './model.js';
+import { type Filters } from './list-view.js';
+type SurfaceEvent = PlannedEvent;
+export type AxisId = 'event' | 'payload' | 'kind' | 'mode' | 'lifecycle' | 'manager' | 'depth' | 'profile' | 'cwd';
+export interface Axis {
+    id: AxisId;
+    label: string;
+    value: string;
+    /** Free-text axes open a field; the rest cycle in place. */
+    typed: boolean;
+}
+export type FacetId = 'rung' | 'origin' | 'kind' | 'state' | 'query';
+export interface Facet {
+    id: FacetId;
+    label: string;
+    value: string;
+    /** The query is typed; every other facet cycles through a closed set. */
+    typed: boolean;
+}
+/** The FILTERS rows for one filter value. `doc kind` is spelled out because the
+ *  snapshot above it dials the NODE's kind. */
+export declare function facetsOf(filters: Filters): Facet[];
+export declare function cycleFacet(filters: Filters, id: FacetId, delta: number): Filters;
+/** The configuration rows for a snapshot. The event and its payload are not
+ *  here — they belong to the EVENTS section, where the payload sits under the
+ *  count it explains. */
+export declare function axesOf(snapshot: Snapshot, profileName: string): Axis[];
+/** The payload field for the dialled event, or nothing when the event reads no
+ *  payload — on boot there is nothing it could change. It renders inside the
+ *  EVENTS section, directly under the count it explains. */
+export declare function payloadRowOf(snapshot: Snapshot): Axis | undefined;
+/** Cycle one enum axis, returning the changed snapshot. A typed axis is never
+ *  cycled — the shell opens a field for it instead. */
+export declare function cycleAxis(snapshot: Snapshot, id: AxisId, delta: number, profiles?: readonly ProfileChoice[]): Snapshot;
+/** Apply a typed axis's submitted value. */
+export declare function setTypedAxis(snapshot: Snapshot, id: AxisId, value: string): Snapshot;
+/** The value a typed axis's field is seeded with. */
+export declare function typedAxisValue(snapshot: Snapshot, id: AxisId): string;
+/** One activity as the rail states it: how many documents it delivers, and
+ *  whether it is the one the page is planning. `delivers` is undefined while
+ *  that event's plan is still warming. */
+export interface EventRow {
+    event: SurfaceEvent;
+    delivers: number | undefined;
+    dialled: boolean;
+}
+/** Every selectable rail row in drawn order: the events, the dialled event's
+ *  payload field directly under it, the configuration axes, then the filter
+ *  facets. One list, so the shell's single index is also the reading order. */
+export type RailRow = {
+    kind: 'event';
+    event: EventRow;
+} | {
+    kind: 'axis';
+    axis: Axis;
+    indent: boolean;
+} | {
+    kind: 'facet';
+    facet: Facet;
+};
+/** A rail row's identity, which the shell holds the cursor by. The list's
+ *  composition changes whenever the dialled event moves the payload row, so an
+ *  offset kept across that change points at a different row. */
+export declare function railRowKey(row: RailRow): string;
+/** What enter does on a rail row: an event dials it, a typed row opens its
+ *  field, and every other row hands the keyboard to the documents. Space does
+ *  the same thing on the first two and cycles the value on the last. */
+export declare function railEnter(row: RailRow | undefined): 'dial' | 'edit' | 'documents';
+export declare function railRowsOf(events: EventRow[], payload: Axis | undefined, axes: Axis[], facets: Facet[]): RailRow[];
+/** All three sections as one column. `index` runs over `rows`, while the
+ *  section headings and the blank rows between them are drawn but never
+ *  selectable. */
+export declare function renderRail(opts: {
+    rows: RailRow[];
+    index: number;
+    width: number;
+    height: number;
+    focused: boolean;
+    /** Documents the filters select, out of the whole corpus. */
+    matched: number;
+    total: number;
+}): string[];
+export {};

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

@@ -0,0 +1 @@
+var _=Object.defineProperty;var c=(e,n)=>_(e,"name",{value:n,configurable:!0});import{resolve as L}from"node:path";import{truncateToWidth as $}from"@earendil-works/pi-tui";import{padAnsi as v,theme as s}from"../../../../core/tui/panel.js";import{tildify as q}from"../../../../core/fs-utils.js";import{KINDS as C,RUNGS as D}from"../../../../core/substrate/schema.js";import{PLANNED_EVENTS as P}from"../resolve.js";import{payloadAxisFor as b}from"./model.js";import{OWNER_TYPES as G}from"./list-view.js";const K=["any",...D.filter(e=>e!=="none"),"silent"],V=["any",...G],W=["any",...C],B=["any","delivering","gated","shadowed","no-rule"];function w(e){return[{id:"rung",label:"rung",value:e.rung,typed:!1},{id:"origin",label:"owner",value:e.origin,typed:!1},{id:"kind",label:"doc kind",value:e.kind,typed:!1},{id:"state",label:"state",value:e.state,typed:!1},{id:"query",label:"search",value:e.query===""?"any":e.query,typed:!0}]}c(w,"facetsOf");function ee(e,n,a){const i=c((t,r)=>{const f=t.indexOf(r);return t[(Math.max(0,f)+a+t.length)%t.length]},"step");switch(n){case"rung":return{...e,rung:i(K,e.rung)};case"origin":return{...e,origin:i(V,e.origin)};case"kind":return{...e,kind:i(W,e.kind)};case"state":return{...e,state:i(B,e.state)};case"query":return e}}c(ee,"cycleFacet");function ne(e,n){return[{id:"kind",label:"kind",value:e.kind,typed:!0},{id:"mode",label:"mode",value:e.mode,typed:!1},{id:"lifecycle",label:"lifecycle",value:e.lifecycle,typed:!1},{id:"manager",label:"manager",value:e.hasManager?"yes":"no",typed:!1},{id:"depth",label:"depth",value:String(e.depth),typed:!1},{id:"profile",label:"profile",value:n,typed:!1},{id:"cwd",label:"cwd",value:q(e.cwd),typed:!0}]}c(ne,"axesOf");function te(e){const n=b(e.event);if(n===null)return;const a=n==="file"?e.file:n==="docName"?e.docName:e.command;return{id:"payload",label:n==="file"?"file":n==="docName"?"doc":"command",value:a===""?"(none \u2014 nothing matches)":a,typed:!0}}c(te,"payloadRowOf");function ie(e,n,a,i=[]){const t=c((r,f)=>{const p=r.indexOf(f);return r[(Math.max(0,p)+a+r.length)%r.length]},"step");switch(n){case"event":return{...e,event:t(P,e.event)};case"mode":{const r=t(["base","orchestrator"],e.mode);return{...e,mode:r,lifecycle:r==="orchestrator"?"resident":"terminal"}}case"lifecycle":return{...e,lifecycle:t(["terminal","resident"],e.lifecycle)};case"manager":return{...e,hasManager:!e.hasManager};case"depth":return{...e,depth:Math.max(0,e.depth+a)};case"profile":{const r=[null,...i.map(f=>f.id)];return{...e,profileId:t(r,e.profileId)}}default:return e}}c(ie,"cycleAxis");function de(e,n,a){const i=a.trim();if(n==="kind")return i===""?e:{...e,kind:i};if(n==="cwd")return i===""?e:{...e,cwd:L(i)};if(n!=="payload")return e;const t=b(e.event);return t==="file"?{...e,file:i}:t==="docName"?{...e,docName:i}:t==="command"?{...e,command:i}:e}c(de,"setTypedAxis");function re(e,n){if(n==="kind")return e.kind;if(n==="cwd")return e.cwd;const a=b(e.event);return a==="file"?e.file:a==="docName"?e.docName:a==="command"?e.command:""}c(re,"typedAxisValue");const M=10;function ae(e){return e.kind==="event"?`event:${e.event.event}`:e.kind==="axis"?`axis:${e.axis.id}`:`facet:${e.facet.id}`}c(ae,"railRowKey");function ce(e){return e===void 0?"documents":e.kind==="event"?"dial":e.kind==="axis"?e.axis.typed?"edit":"documents":e.facet.typed?"edit":"documents"}c(ce,"railEnter");function le(e,n,a,i){const t=[];for(const r of e)t.push({kind:"event",event:r}),r.dialled&&n!==void 0&&t.push({kind:"axis",axis:n,indent:!0});for(const r of a)t.push({kind:"axis",axis:r,indent:!1});for(const r of i)t.push({kind:"facet",facet:r});return t}c(le,"railRowsOf");function oe(e){const{rows:n,index:a,width:i,height:t,focused:r,matched:f,total:p}=e,u=[];let N=0;const E=c((d,l,o,g,m)=>{d===a&&(N=u.length),d===a&&r?u.push(s.bg("selectedBg",v(o,i))):d===a||l?u.push(`${s.fg("accent","\u258C")}${v(s.fg("accent",m),i-1)}`):u.push(v(g,i))},"push"),S=c((d,l,o,g)=>{const m=Math.max(1,M-g),y=Math.max(1,i-M-2),x=`${" ".repeat(g)}${v($(l,m),m)}`,k=$(o,y);E(d,!1,` ${x} ${k}`,` ${s.fg("dim",x)} ${k}`,`${x} ${k}`)},"labelled"),O=c((d,l)=>{const o=l.delivers===void 0?"\u2026":String(l.delivers),g=l.delivers===void 0||l.delivers===0?"dim":"success",m=Math.max(1,i-2-o.length),y=v($(l.event,m),m),x=s.fg(g,o);E(d,l.dialled,` ${y} ${x}`,` ${s.fg("dim",y)} ${x}`,`${y} ${o}`)},"evented"),R=c(d=>d.kind==="facet"?"filters":d.kind==="event"||d.indent?"events":"snapshot","sectionOf"),I={events:" EVENTS",snapshot:" SNAPSHOT",filters:` FILTERS \xB7 ${f} of ${p}`};let T;n.forEach((d,l)=>{const o=R(d);o!==T&&(u.length>0&&u.push(""),u.push(s.fg("dim",I[o]),""),T=o),d.kind==="event"?O(l,d.event):d.kind==="axis"?S(l,d.axis.label,d.axis.value,d.indent?2:0):S(l,d.facet.label,d.facet.value,0)});const F=Math.max(0,u.length-t),A=Math.min(Math.max(0,N-Math.floor(t/2)),F),h=u.slice(A,A+t);for(;h.length<t;)h.push("");return h}c(oe,"renderRail");export{ne as axesOf,ie as cycleAxis,ee as cycleFacet,w as facetsOf,te as payloadRowOf,ce as railEnter,ae as railRowKey,le as railRowsOf,oe as renderRail,de as setTypedAxis,re as typedAxisValue};

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

@@ -0,0 +1,27 @@
+import { type PlannedEvent } from '../resolve.js';
+import type { NodeConfigSubject } from '../../../../core/substrate/subject-fields.js';
+import { type AdminRecord } from './model.js';
+type SurfaceEvent = PlannedEvent;
+/** What the read face needs beyond the record: the event it is judged against,
+ *  the sibling events' records, and the two facts the shell resolves. */
+export interface DossierContext {
+    event: SurfaceEvent;
+    records: Map<SurfaceEvent, AdminRecord>;
+    readOnly: boolean;
+    /** The body, once the reader opened it — the plan carries none. */
+    body: string | undefined;
+    /** The configuration every record here was planned against — what a failed
+     *  gate is explained against. Null when there is no node config at all. */
+    subject: NodeConfigSubject | null;
+}
+/** The resting card, and — when `bodyOpen` — the document's own text beneath
+ *  it in place of the affordance line that names it. */
+export declare function renderDossierRead(record: AdminRecord, context: DossierContext, width: number, bodyOpen: boolean): string[];
+/** Identity and routing — what the edit face keeps overhead of its field list,
+ *  because they are the context a field is being edited against. */
+export declare function renderDossierHeader(record: AdminRecord, context: DossierContext, width: number): string[];
+/** Does it load here, what does it cost, and — only when there is one — what
+ *  interfered. The three questions the old verdict, cost table and event grid
+ *  each answered a piece of. */
+export declare function renderDossierDelivery(record: AdminRecord, context: DossierContext, width: number): string[];
+export {};

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

@@ -0,0 +1 @@
+var T=Object.defineProperty;var r=(e,s)=>T(e,"name",{value:s,configurable:!0});import{getMarkdownTheme as A}from"@earendil-works/pi-coding-agent";import{Markdown as L,visibleWidth as g,wrapTextWithAnsi as x}from"@earendil-works/pi-tui";import{theme as i,wrapText as k}from"../../../../core/tui/panel.js";import{rungRank as M}from"../../../../core/substrate/schema.js";import{PLANNED_EVENTS as H}from"../resolve.js";import{CLAUSE_SEPARATOR as O,explainGate as _,formatClause as P}from"../../../../core/substrate/gate-explain.js";import{ownerTypeOf as S}from"./list-view.js";import{plural as j}from"./model.js";const B="\u2298",l=" ";function X(e,s,n,t){const o=Math.max(1,n-l.length),u=C(e,s,n);u.push(...I(e,s,n));const p=s.body;return t&&p!==void 0?(u.push(""),u.push(...d(new L(p,0,0,A()).render(o)))):t?u.push("",...v("reading the body\u2026",n)):u.push("",...v("enter  read the body",n)),u}r(X,"renderDossierRead");function v(e,s){const n=Math.max(1,s-l.length);return g(e)<=n?[`${l}${i.fg("dim",e)}`]:d(f(e,n)).map(t=>i.fg("dim",t))}r(v,"dim");function C(e,s,n){const t=Math.max(1,n-l.length),o=G(e,s,t);o.push("",i.fg("dim",`${l}PREVIEW`));const u=e.doc.preview.trim();return o.push(...u===""?[i.fg("dim",`${l}Not declared.`)]:d(f(u,t))),o}r(C,"renderDossierHeader");function G(e,s,n){const t=`${e.doc.kind} \xB7 ${S(e)} ${e.doc.ownerHandle}${e.doc.unlisted?" \xB7 unlisted":""}${s.readOnly?` ${B}`:""}`,o=f(e.doc.displayName,n),u=o.map(h=>`${l}${i.fg("accent",i.bold(h))}`),p=o[o.length-1]??"",$=n-g(p)-g(t);return $>=2?(u[u.length-1]=`${l}${i.fg("accent",i.bold(p))}${" ".repeat($)}${i.fg("dim",t)}`,u):(u.push(...f(t,n).map(h=>`${l}${" ".repeat(Math.max(0,n-g(h)))}${i.fg("dim",h)}`)),u)}r(G,"identityLines");function I(e,s,n){const t=Math.max(1,n-l.length),o=e.finalRung!=="none",u=M(e.cappedRung)<M(e.authoredRung),p=o?e.finalRung:"nothing",$=o?u?"warning":"success":"dim",h=`${s.event} \u2192 `,m=[""];g(h)+g(p)<=t?m.push(`${l}${i.fg("dim",h)}${i.fg($,p)}`):(m.push(...d(f(h,t)).map(a=>i.fg("dim",a))),m.push(...d(f(p,t)).map(a=>i.fg($,a))));const w=r(a=>{m.push(...d(f(a,t)).map(c=>i.fg("warning",c)))},"warn"),b=e.ruleGate;if(e.matchedRule===null&&b!==null&&!b.pass){const a=e.authoredRules.find(R=>!R.gate.pass)?.rule.if,c=a===void 0||s.subject===null?[]:_(a,s.subject);if(c.length===0)w(`rule if fails: ${b.reason}`);else{const R=c.every(E=>E.failure==="mismatch");w(R?"rule if fails":"rule if never matches");for(const E of c)m.push(...W(P(E),t).map(D=>i.fg("warning",D)));R&&m.push(...v("dial the snapshot at left to load it here",n))}}else e.matchedRule===null&&e.authoredRules.length>0&&m.push(...d(f(`${j(e.authoredRules.length,"rule","rules")} for this activity, none matched`,t)).map(a=>i.fg("dim",a)));u&&w(`limited to ${e.cappedRung} by the profile\u2019s delivery limit for ${e.doc.ownerHandle} (authored ${e.authoredRung})`),e.shadowedBy!==null&&m.push(...d(f(`shadowed by ${e.shadowedBy.ownerHandle}/${e.shadowedBy.name}`,t)).map(a=>i.fg("muted",a)));const N=H.filter(a=>a!==s.event).map(a=>({event:a,held:s.records.get(a)})).filter(a=>a.held!==void 0&&a.held.finalRung!=="none").map(a=>`${a.event} \u2192 ${a.held.finalRung}`);return N.length>0&&m.push(...d(f(`also ${N.join(" \xB7 ")}`,t)).map(a=>i.fg("dim",a))),m}r(I,"renderDossierDelivery");function d(e){return e.map(s=>`${l}${s}`)}r(d,"indent");const y=`${l}  `;function W(e,s){const n=Math.max(1,s-2);if(g(e)<=n)return[`${y}${e}`];const t=e.indexOf(O);return t===-1?f(e,n).map(o=>`${y}${o}`):[...f(e.slice(0,t),n).map(o=>`${y}${o}`),...f(e.slice(t+1),Math.max(1,n-2)).map(o=>`${y}  ${o}`)]}r(W,"clauseRows");function f(e,s){const n=e.trim();return n===""?[]:n.split(/\s+/).some(t=>g(t)>s)?x(n,s):k(n,s)}r(f,"wrapped");export{I as renderDossierDelivery,C as renderDossierHeader,X as renderDossierRead};

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

@@ -0,0 +1,125 @@
+import { type Component, type Focusable, type TUI } from '@earendil-works/pi-tui';
+import { type BindingId, type BindingResolution } from '../../../../core/keybindings/index.js';
+import { type ProfileChoice, type Snapshot } from './model.js';
+export interface AdminResult {
+    edited: string[];
+}
+export declare class ContextAdminShell implements Component, Focusable {
+    private readonly tui;
+    private readonly terminalRows;
+    private readonly bindings;
+    private readonly suspendForChild;
+    private readonly profiles;
+    private snapshot;
+    private plans;
+    private zone;
+    private railIndex;
+    private filters;
+    private rows;
+    /** The search field owns the keyboard while it is open. */
+    private searching;
+    private readonly docs;
+    private readonly detail;
+    private modal;
+    private notice;
+    private busy;
+    private readonly edited;
+    /** Bodies the reader opened, by object id — the plan carries none. */
+    private readonly bodies;
+    private _focused;
+    onCancel?: () => void;
+    onSubmit?: (result: AdminResult) => void;
+    constructor(seed: Snapshot, tui: TUI, terminalRows: () => number, bindings: BindingResolution<BindingId>, suspendForChild: () => () => void, profiles: readonly ProfileChoice[]);
+    set focused(value: boolean);
+    get focused(): boolean;
+    /** Required by `Component`. Nothing is cached between frames: a plan can land
+     *  from a warm tick and an edit can land from an await, both between inputs. */
+    invalidate(): void;
+    dispose(): void;
+    /** Recompute the focused event's plan, refresh the panels from it, and let
+     *  the remaining events fill in behind it. */
+    private rebuild;
+    private refreshRows;
+    /** A filter never re-plans: it is a question about the plan already computed,
+     *  which is what keeps a facet change instant on a corpus this size. */
+    private setFilters;
+    private syncDetail;
+    private setSnapshot;
+    /** Put the rail cursor back on the row it was on, since dialling a different
+     *  event moves the payload row and every offset below it. The payload belongs
+     *  to the dialled event, so when the new event reads none the cursor falls to
+     *  that event's own row rather than to whatever slid into the offset. */
+    private holdRail;
+    private matches;
+    private label;
+    private isDown;
+    private isUp;
+    private isDescend;
+    private isAscend;
+    /** Tab steps the focused event from any zone — the one axis every panel is
+     *  drawn against, so it earns the page-level gesture. */
+    private cyclesEvent;
+    handleInput(data: string): void;
+    /** Every surface event with what it delivers, which is what the rail states
+     *  instead of the list drawing a cell per event on every row. An event whose
+     *  plan has not warmed yet has no count to state. */
+    private eventRows;
+    /** The rail's rows: the events, then the snapshot axes, then the filter
+     *  facets, so one cursor and one gesture drive all three sections. */
+    private railRows;
+    private profileName;
+    private handleRail;
+    private handleDocs;
+    private openSearch;
+    /** Typing filters live, so the field is the list's own heading rather than a
+     *  modal over the rows it is selecting. */
+    private handleSearch;
+    private handleDetail;
+    /** Put the focused document's object id on the clipboard, so a reader who
+     *  spotted the document that is misbehaving can read, edit, or pass it along
+     *  (`crtr canvas read <id>`) without retyping it off the screen. */
+    private yankId;
+    /** The resting face: reading, and the two gestures that leave it. */
+    private handleRead;
+    /** Open the body in place, fetching it the first time it is opened. */
+    private openBody;
+    /** The field list. Every write gesture is resolved before it is started, so a
+     *  read-only document refuses at the keypress rather than after a modal. */
+    private handleEdit;
+    /** The write one edit-face key starts, or undefined when the key writes
+     *  nothing. `document` marks the writes a read-only document refuses — the
+     *  delivery limit is not one of them; it lives on the profile. */
+    private writeGesture;
+    /** The refusal a read-only document owes the write just attempted, carried by
+     *  the same footer channel every other write outcome uses. */
+    private refusesWrite;
+    /** What the focused dossier row does when opened — the same write its letter
+     *  key starts, so a user who never learns the letters can still edit. */
+    private activate;
+    private get record();
+    private apply;
+    private cycleRuleLevel;
+    private removeRule;
+    /** Activity, then match, then level — the three fields a valid rule needs,
+     *  asked in the order the rule reads them. */
+    private composeRule;
+    private flipUnlisted;
+    private editPreview;
+    /** The one write that leaves the page: the terminal goes to $EDITOR and comes
+     *  back repainted, and the buffer that returns is saved through the same
+     *  route `crtr doc edit` uses. */
+    private editBody;
+    private editMove;
+    /** Delivery limits belong to the profile, per owner — not to the document. */
+    private explainLimit;
+    private openAxisField;
+    private close;
+    private handleModal;
+    private renderModal;
+    private footer;
+    /** What the focused row does when opened. A directory expands; a document
+     *  opens its dossier. */
+    private docsGesture;
+    render(width: number): string[];
+}
+export declare function runContextAdmin(seed: Snapshot, profiles: readonly ProfileChoice[]): Promise<AdminResult | undefined>;

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

@@ -0,0 +1 @@
+var z=Object.defineProperty;var l=(u,e)=>z(u,"name",{value:e,configurable:!0});import{Input as A,matchesKey as s,truncateToWidth as b,visibleWidth as w}from"@earendil-works/pi-tui";import{formatGesture as C,matchesPiTuiInput as N}from"../../../../core/keybindings/index.js";import{writeClipboardTextEverywhere as T}from"../../../../core/clipboard-text.js";import{runTuiPage as O}from"../../../../core/tui/page-host.js";import{PAGE_CHROME_ROWS as F,columns as x,framed as W,pageFrame as L,theme as h}from"../../../../core/tui/panel.js";import{editBufferInEditor as G}from"../../../../clients/inbox/review/roundtrip.js";import{PLANNED_EVENTS as m}from"../resolve.js";import{moveDoc as H,readBody as k,readOnlyReason as I,toggleUnlisted as P,writeBody as B,writePreview as U,writeRules as v}from"./actions.js";import{axesOf as j,cycleAxis as $,cycleFacet as V,facetsOf as K,payloadRowOf as X,railEnter as D,railRowKey as M,railRowsOf as J,renderRail as Q,setTypedAxis as Y,typedAxisValue as Z}from"./rail-panel.js";import{ContextDetailPanel as ee}from"./detail-panel.js";import{ContextDocsPanel as te,buildRows as ie}from"./docs-panel.js";import{NO_FILTERS as se}from"./list-view.js";import{DELIVER_LEVELS as g,PlanSet as ne,describeRule as re,plural as S}from"./model.js";function oe(u){return u!=="boot"&&u!=="workspace-open"}l(oe,"needsMatch");const le={boot:"","workspace-open":"","file-read":"absolute path glob, or ./ for this document\u2019s own directory","document-read":"document name glob",command:"command-path glob, e.g. node new","pre-command":"command-path glob, e.g. node new","slash-command":"slash command name glob"},a=26,de=86,he=112,q=6,ce=48,ue=100,ae=.45;function fe(u){const e=Math.max(1,u-a-q);return Math.max(ce,Math.min(ue,Math.floor(e*ae)))}l(fe,"docsWidthFor");class pe{static{l(this,"ContextAdminShell")}tui;terminalRows;bindings;suspendForChild;profiles;snapshot;plans;zone="rail";railIndex=0;filters=se;rows=[];searching=!1;docs;detail=new ee;modal;notice;busy;edited=new Set;bodies=new Map;_focused=!1;onCancel;onSubmit;constructor(e,t,i,n,r,o){this.tui=t,this.terminalRows=i,this.bindings=n,this.suspendForChild=r,this.profiles=o,this.snapshot=e,this.plans=new ne(e,()=>{this.refreshRows(),this.tui.requestRender()}),this.docs=new te(()=>this.tui.requestRender()),this.rebuild()}set focused(e){this._focused=e}get focused(){return this._focused}invalidate(){}dispose(){this.plans.dispose()}rebuild(){this.refreshRows(),this.plans.warm(this.snapshot.event)}refreshRows(){this.rows=ie(this.plans,this.snapshot.event),this.docs.setRows(this.rows,this.snapshot.event),this.syncDetail()}setFilters(e){this.filters=e,this.docs.setFilters(e),this.syncDetail()}syncDetail(){const e=this.docs.selected,t=e===void 0?null:I(e.anchor),i=this.plans.peek(this.snapshot.event)?.subject??null;this.detail.setContext(e,this.snapshot.event,t,i,e===void 0?void 0:this.bodies.get(e.key))}setSnapshot(e){const t=this.railRows()[this.railIndex];this.snapshot=e,this.plans.setSnapshot(e),this.notice=void 0,this.rebuild(),this.holdRail(t)}holdRail(e){if(e===void 0)return;const t=this.railRows(),i=M(e),n=t.findIndex(r=>M(r)===i);this.railIndex=Math.max(0,n>=0?n:t.findIndex(r=>r.kind==="event"&&r.event.dialled))}matches(e,t){return N(this.bindings,e,t,(i,n)=>s(i,n))}label(e,t){const i=this.bindings.gestures(e);return i.length===0?t:C(i[0].split(" > ").pop())}isDown(e){return s(e,"j")||s(e,"down")||this.matches("crtr.setup.list-down",e)}isUp(e){return s(e,"k")||s(e,"up")||this.matches("crtr.setup.list-up",e)}isDescend(e){return s(e,"l")||s(e,"right")||s(e,"enter")||this.matches("crtr.setup.advance",e)}isAscend(e){return s(e,"h")||s(e,"left")}cyclesEvent(e){const t=s(e,"right")||s(e,"left");return s(e,"tab")||!t&&this.matches("crtr.setup.tab-next",e)?1:s(e,"shift+tab")||!t&&this.matches("crtr.setup.tab-previous",e)?-1:0}handleInput(e){if(this.busy!==void 0)return;if(this.modal!==void 0){this.handleModal(e);return}if(this.searching){this.handleSearch(e);return}const t=this.cyclesEvent(e);if(t!==0){this.setSnapshot($(this.snapshot,"event",t,this.profiles));return}if(!(this.zone==="detail"&&!this.detail.editing&&s(e,"ctrl+d"))&&(s(e,"q")||this.matches("crtr.setup.cancel",e))){this.close();return}this.zone==="rail"?this.handleRail(e):this.zone==="docs"?this.handleDocs(e):this.handleDetail(e)}eventRows(){return m.map(e=>{const t=this.plans.peek(e);return{event:e,delivers:t===void 0?void 0:t.docs.filter(i=>i.finalRung!=="none").length,dialled:e===this.snapshot.event}})}railRows(){return J(this.eventRows(),X(this.snapshot),j(this.snapshot,this.profileName()),K(this.filters))}profileName(){const e=this.snapshot.profileId;return e===null?"none":this.profiles.find(t=>t.id===e)?.name??e}handleRail(e){const t=this.railRows();this.railIndex=Math.max(0,Math.min(this.railIndex,t.length-1));const i=t[this.railIndex],n=l(o=>{i!==void 0&&(i.kind==="event"?this.setSnapshot({...this.snapshot,event:i.event.event}):i.kind==="axis"?i.axis.typed?this.openAxisField(i.axis.id,i.axis.label):this.setSnapshot($(this.snapshot,i.axis.id,o,this.profiles)):i.facet.typed?this.openSearch():this.setFilters(V(this.filters,i.facet.id,o)))},"change"),r=D(i);this.isDown(e)?this.railIndex=Math.min(t.length-1,this.railIndex+1):this.isUp(e)?this.railIndex=Math.max(0,this.railIndex-1):s(e,"space")||this.matches("crtr.setup.toggle",e)?n(1):this.isDescend(e)?s(e,"enter")&&r!=="documents"?n(1):this.zone="docs":s(e,"escape")&&this.close()}handleDocs(e){e==="/"||s(e,"/")?this.openSearch():s(e,"y")?this.yankId():this.isDown(e)?(this.docs.move(1),this.syncDetail()):this.isUp(e)?(this.docs.move(-1),this.syncDetail()):s(e,"space")||this.matches("crtr.setup.toggle",e)?(this.docs.toggleGroup(),this.syncDetail()):this.isDescend(e)?this.docs.onGroup?(this.docs.toggleGroup(),this.syncDetail()):this.docs.selected!==void 0&&(this.zone="detail"):s(e,"escape")&&this.filters.query!==""?this.setFilters({...this.filters,query:""}):(this.isAscend(e)||s(e,"escape"))&&(this.zone="rail")}openSearch(){this.searching=!0,this.zone="docs",this.tui.requestRender()}handleSearch(e){s(e,"escape")?(this.searching=!1,this.setFilters({...this.filters,query:""})):s(e,"enter")?this.searching=!1:s(e,"backspace")?this.setFilters({...this.filters,query:this.filters.query.slice(0,-1)}):e.length===1&&e.charCodeAt(0)>=32&&this.setFilters({...this.filters,query:this.filters.query+e}),this.tui.requestRender()}handleDetail(e){s(e,"y")?this.yankId():this.detail.editing?this.handleEdit(e):this.handleRead(e)}yankId(){const e=this.docs.selected;if(e===void 0)return;const{system:t,tmux:i}=T(e.key);this.notice=t||i?{text:`Copied ${e.key}${t?"":" to the tmux buffer"}`,ok:!0}:{text:"No clipboard tool available \u2014 nothing copied",ok:!1},this.tui.requestRender()}handleRead(e){this.isDown(e)?this.detail.move(1):this.isUp(e)?this.detail.move(-1):s(e,"ctrl+d")?this.detail.page(1):s(e,"ctrl+u")?this.detail.page(-1):e==="G"||s(e,"shift+g")?this.detail.jump("bottom"):e==="g"||s(e,"g")?this.detail.jump("top"):e==="e"||s(e,"e")?this.detail.edit():this.isDescend(e)?this.openBody():(this.isAscend(e)||s(e,"escape"))&&(this.detail.back()||(this.zone="docs"))}openBody(){const e=this.docs.selected;if(e===void 0||!this.detail.openBody()||this.bodies.has(e.key))return;const t=e.key;k(e.anchor.doc).then(i=>{this.bodies.set(t,i),this.syncDetail(),this.tui.requestRender()},i=>{this.notice={text:i instanceof Error?i.message:String(i),ok:!1},this.detail.back(),this.tui.requestRender()})}handleEdit(e){if(this.isDown(e)){this.detail.move(1);return}if(this.isUp(e)){this.detail.move(-1);return}if(this.isAscend(e)||s(e,"escape")){this.detail.back();return}const t=this.writeGesture(e);t!==void 0&&(t.document&&this.refusesWrite()||t.start())}writeGesture(e){const t=l(i=>({start:i,document:!0}),"doc");if(s(e,"enter")||s(e,"space")||this.matches("crtr.setup.toggle",e))return this.detail.selected===void 0?void 0:t(()=>this.activate());if(s(e,"m"))return{start:l(()=>this.explainLimit(),"start"),document:!1};if(s(e,"b"))return t(()=>this.editBody());if(s(e,"x"))return t(()=>this.removeRule());if(s(e,"e"))return t(()=>this.composeRule());if(s(e,"u"))return t(()=>this.flipUnlisted());if(s(e,"r"))return t(()=>this.editMove());if(s(e,"w"))return t(()=>this.editPreview())}refusesWrite(){const e=this.record;if(e===void 0)return!1;const t=I(e);return t===null?!1:(this.notice={text:t,ok:!1},this.tui.requestRender(),!0)}activate(){const e=this.detail.selected;if(e!==void 0)switch(e.kind){case"rule":return this.cycleRuleLevel(e.at);case"add-rule":return this.composeRule();case"preview":return this.editPreview();case"unlisted":return this.flipUnlisted();case"body":return this.editBody();case"move":return this.editMove()}}get record(){return this.docs.selected?.anchor}apply(e){this.busy="writing\u2026",this.tui.requestRender(),e.then(t=>{this.busy=void 0,this.notice={text:t.message,ok:t.ok},t.ok&&(t.name!==void 0&&this.edited.add(t.name),this.bodies.clear(),this.plans.refresh(),this.rebuild()),this.tui.requestRender()})}cycleRuleLevel(e){const t=this.record,i=t?.doc.rules[e];if(t===void 0||i===void 0)return;const r=g[(g.indexOf(i.deliver)+1)%g.length],o=t.doc.rules.map((d,p)=>p===e?{...d,deliver:r}:d);this.apply(v(t,o,`${t.doc.displayName} now delivers ${r} on ${i.on}.`))}removeRule(){const e=this.record,t=this.detail.selectedRule;if(e===void 0||t===void 0){this.notice={text:"Select a delivery rule to remove.",ok:!1};return}const i=e.doc.rules[t],n=e.doc.rules.filter((r,o)=>o!==t);this.modal={kind:"confirm",title:"Remove delivery rule",message:`${e.doc.displayName} will stop delivering on ${i.on} (${re(i)}).`,submit:l(()=>this.apply(v(e,n,`Removed the ${i.on} rule from ${e.doc.displayName}.`)),"submit")}}composeRule(){const e=this.record;e!==void 0&&(this.modal={kind:"choice",title:"New rule \u2014 activity",options:[...m],index:m.indexOf(this.snapshot.event),submit:l(t=>{const i=t,n=l(r=>{this.modal={kind:"choice",title:"New rule \u2014 deliver",options:[...g],index:0,submit:l(o=>{this.modal=void 0;const d={on:i,...r===""?{}:{match:[r]},deliver:o};this.apply(v(e,[...e.doc.rules,d],`${e.doc.displayName} now delivers ${o} on ${i}.`))},"submit")}},"chooseLevel");if(!oe(i)){n("");return}this.modal={kind:"field",title:`New rule \u2014 ${i} match`,hint:le[i],input:y(""),submit:l(r=>{const o=r.trim();if(o===""){this.modal=void 0,this.notice={text:`A ${i} rule needs a match glob.`,ok:!1};return}n(o)},"submit")}},"submit")})}flipUnlisted(){const e=this.record;e!==void 0&&this.apply(P(e))}editPreview(){const e=this.record;e!==void 0&&(this.modal={kind:"field",title:"Preview",hint:"the one line a reader decides to open the document on",input:y(e.doc.preview),submit:l(t=>{this.modal=void 0,this.apply(U(e,t))},"submit")})}editBody(){const e=this.record;e!==void 0&&(this.busy="reading the body\u2026",this.tui.requestRender(),k(e.doc).then(t=>{this.busy=void 0;const i=this.suspendForChild();let n;try{n=G(t)}finally{i()}if(n.error!==void 0)this.notice={text:n.error,ok:!1};else if(n.text===t)this.notice={text:`${e.doc.displayName} came back unchanged \u2014 nothing written.`,ok:!1};else{this.apply(B(e,n.text));return}this.tui.requestRender()},t=>{this.busy=void 0,this.notice={text:t instanceof Error?t.message:String(t),ok:!1},this.tui.requestRender()}))}editMove(){const e=this.record;e!==void 0&&(this.modal={kind:"field",title:"Rename",hint:"the new name under this document\u2019s own owner",input:y(e.doc.displayName),submit:l(t=>{this.modal=void 0,this.apply(H(e,t))},"submit")})}explainLimit(){this.notice={text:"Delivery limits are per owner on the profile; set one with `crtr profile project limit`.",ok:!1},this.tui.requestRender()}openAxisField(e,t){this.modal={kind:"field",title:t,hint:e==="cwd"?"absolute directory the project stores resolve from":"value the planner should match against",input:y(Z(this.snapshot,e)),submit:l(i=>{this.modal=void 0,this.setSnapshot(Y(this.snapshot,e,i))},"submit")}}close(){if(this.edited.size===0){this.onCancel?.();return}this.onSubmit?.({edited:[...this.edited]})}handleModal(e){const t=this.modal;if(t!==void 0){if(s(e,"escape")){this.modal=void 0;return}if(t.kind==="choice"){this.isDown(e)?t.index=Math.min(t.options.length-1,t.index+1):this.isUp(e)?t.index=Math.max(0,t.index-1):s(e,"enter")&&t.submit(t.options[t.index]);return}if(t.kind==="confirm"){s(e,"y")||s(e,"enter")?(this.modal=void 0,t.submit()):s(e,"n")&&(this.modal=void 0);return}s(e,"enter")?t.submit(t.input.getValue()):t.input.handleInput(e)}}renderModal(e,t){const i=this.modal;if(i===void 0)return[];let n;i.kind==="choice"?n=[h.fg("accent",h.bold(i.title)),"",...i.options.map((o,d)=>`${d===i.index?h.fg("accent","\u25B6"):" "} ${o}`)]:i.kind==="confirm"?n=[h.fg("warning",h.bold(i.title)),"",...ge(i.message,Math.max(1,e-6))]:n=[h.fg("accent",h.bold(i.title)),h.fg("dim",i.hint),"",i.input.render(Math.max(1,e-6))[0]??""];const r=W(n,e);for(;r.length<t;)r.push("");return r.slice(0,t)}footer(e,t){if(this.busy!==void 0)return h.fg("warning",this.busy);if(this.modal?.kind==="choice")return h.fg("dim","\u2191\u2193/jk choose \xB7 enter apply \xB7 esc cancel");if(this.modal?.kind==="confirm")return h.fg("dim","y/enter confirm \xB7 n/esc cancel");if(this.modal?.kind==="field")return h.fg("dim","type \xB7 enter apply \xB7 esc cancel");if(this.searching)return h.fg("dim","type to search names \xB7 enter keep \xB7 esc clear");if(this.notice===void 0&&this.plans.error!==void 0)return h.fg("warning",b(`dry run refused: ${this.plans.error}`,e));if(this.notice!==void 0)return h.fg(this.notice.ok?"success":"warning",b(this.notice.text,e));const i=`${this.label("crtr.setup.list-down","j")}/${this.label("crtr.setup.list-up","k")}`,n=this.zone==="rail"?`${i} row \xB7 ${me(t)}`:this.zone==="docs"?`${i} row \xB7 ${this.docsGesture()} \xB7 / search \xB7 y id`:this.detail.editing?`${i} field \xB7 enter edit \xB7 e add \xB7 x remove \xB7 w preview \xB7 b body \xB7 u unlisted \xB7 m limit \xB7 r rename \xB7 y id \xB7 esc read`:this.detail.bodyOpen?`${i} scroll \xB7 ctrl-d/u page \xB7 g/G ends \xB7 y id \xB7 esc collapse`:`${i} scroll \xB7 enter body \xB7 e edit \xB7 y id \xB7 esc list`,r=`${this.label("crtr.setup.tab-next","tab")} event \xB7 ${this.label("crtr.setup.cancel","q")} close`,o=e-w(n)-w(r);return o>=2?`${h.fg("dim",n)}${" ".repeat(o)}${h.fg("dim",r)}`:h.fg("dim",b(`${n} \xB7 ${this.label("crtr.setup.cancel","q")} close`,e))}docsGesture(){return this.docs.onGroup?"space/enter open":"enter dossier"}render(e){const t=this.terminalRows(),i=Math.max(1,t-F),n=e>=de,r=this.railRows();this.railIndex=Math.max(0,Math.min(this.railIndex,r.length-1));const o=l(c=>Q({rows:r,index:this.railIndex,width:c,height:i,focused:this.zone==="rail",matched:this.docs.visibleCount,total:this.rows.length}),"rail");let d;if(e>=he){const c=fe(e),f=Math.max(1,e-a-c-q),_=x(this.docs.render(c,i,this.zone==="docs"),c,this.modal===void 0?this.detail.render(f,i,this.zone==="detail"):this.renderModal(f,i),f);d=x(o(a),a,_,e-a-3)}else if(n){const c=e-a-3,f=this.modal!==void 0?this.renderModal(c,i):this.zone==="detail"?this.detail.render(c,i,!0):this.docs.render(c,i,this.zone==="docs");d=x(o(a),a,f,c)}else this.modal!==void 0?d=this.renderModal(e,i):this.zone==="rail"?d=o(e):this.zone==="detail"?d=this.detail.render(e,i,!0):d=this.docs.render(e,i,!0);const p=m.filter(c=>this.plans.peek(c)===void 0).length,R=this.plans.peek(this.snapshot.event)?.docs.filter(c=>c.finalRung!=="none").length,E=[this.snapshot.event,R===void 0?"":`${R} delivered`,p>0?`${S(p,"event","events")} planning`:"all events planned",this.edited.size>0?`${S(this.edited.size,"doc","docs")} edited`:""].filter(c=>c!=="").join(" \xB7 ");return L({width:e,height:t,title:"crouter context",meta:E,body:d,footer:this.footer(e,r[this.railIndex])})}}function me(u){switch(D(u)){case"dial":return"space/enter dial \xB7 l documents";case"edit":return"space/enter edit \xB7 l documents";default:return"space change \xB7 enter documents"}}l(me,"railGesture");function y(u){const e=new A;return e.setValue(u),e.handleInput(""),e.focused=!0,e}l(y,"seeded");function ge(u,e){const t=[];let i="";for(const n of u.trim().split(/\s+/)){const r=i===""?n:`${i} ${n}`;w(r)<=e?i=r:(i!==""&&t.push(i),i=n)}return i!==""&&t.push(i),t}l(ge,"wrap");async function _e(u,e){return O(({tui:t,terminal:i,bindings:n,suspendForChild:r},o)=>{const d=new pe(u,t,()=>i.rows,n,r,e);return d.onCancel=o.cancel,d.onSubmit=o.submit,d})}l(_e,"runContextAdmin");export{pe as ContextAdminShell,_e as runContextAdmin};

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

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

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

@@ -0,0 +1,2 @@
+var b=Object.defineProperty;var r=(n,t)=>b(n,"name",{value:t,configurable:!0});import{resolve as D,sep as h}from"node:path";import{defineLeaf as x}from"../../../core/command.js";import{InputError as p}from"../../../core/io.js";import{ApiError as N}from"../../../api/index.js";import{cliClient as g}from"../../api-client.js";import{envNodeId as _}from"../../../shared/env.js";import{PLANNED_EVENTS as T}from"./resolve.js";const L=x({name:"admin",description:"browse and edit what documents deliver, interactively",whenToUse:"you are shaping what agents load rather than answering one question about it \u2014 comparing node configurations, sweeping which documents deliver on which activity, and editing their rules in place",help:{name:"sys context admin",summary:"interactive browser and editor for document delivery",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Open on this live node: its own documents, cwd, profile, and configuration. Defaults to the calling node (CRTR_NODE_ID); outside a node, the page opens on a node that does not exist, working in the current directory."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Opening node kind. Defaults to the node\u2019s kind, else `general`."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,constraint:"Opening node mode. Defaults to the node\u2019s mode, else `base`."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile (id or name) whose delivery limits apply. Defaults to the node\u2019s profile, else the profile pinned to the directory."},{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Directory the simulated node works in; the repos enclosing it apply. Defaults to the node\u2019s cwd, else the current directory."},{kind:"flag",name:"event",type:"enum",choices:[...T],required:!1,constraint:"Opening activity. Defaults to `boot`."}],output:[{name:"edited",type:"array",required:!1,constraint:"Names of the documents changed during the session; absent when nothing was changed."}],outputKind:"object",effects:["Interactive: requires a TTY.","Edits documents through the routes `crtr doc edit` and `crtr doc move` use, with rationale `editor`, when you choose an edit action."]},run:r(async n=>{if(!process.stdout.isTTY)throw new p({error:"not_a_tty",message:"sys context admin is interactive and needs a TTY",next:"Run it in a terminal, or use `crtr sys context resolve` and `crtr sys context doc` for scriptable reads."});const t=g(),i=a(n.node)??a(_()),e=i===void 0?null:await w(i),o=await t.listProfiles(),y=o.map(d=>({id:d.id,name:d.name})),u=a(n.cwd),f=u!==void 0?D(u):e?.cwd??process.cwd(),s=a(n.profile);let l;if(s!==void 0){const d=o.find(m=>m.id===s||m.name===s);if(d===void 0)throw new p({error:"unknown_profile",message:`No profile is named ${s}.`,next:"Run `crtr profile list` for the profile ids and names."});l=d.id}else l=e!==null?e.profile_id:q(o,f);const v={kind:a(n.kind)??e?.kind??"general",mode:n.mode??e?.mode??"base",lifecycle:e?.lifecycle??"terminal",hasManager:e?.parent!=null,profileId:l,cwd:f,nodeId:e?.node_id??null,...e===null?{}:{grantee:e.grantee},depth:e===null?0:await E(e),event:n.event??"boot",file:"",docName:"",command:"",seed:e===null?null:{cwd:e.cwd,profileId:e.profile_id}},{runContextAdmin:k}=await import("./admin/shell.js"),c=await k(v,y);return c===void 0||c.edited.length===0?{}:{edited:c.edited}},"run"),render:r(n=>{const t=n.edited??[];return t.length===0?"Closed the context admin with nothing changed.":t.map(i=>`- edited ${i}`).join(`
+`)},"render")});function a(n){if(typeof n!="string")return;const t=n.trim();return t===""?void 0:t}r(a,"optional");function q(n,t){let i=null;for(const e of n){const o=e.default_dir;o!=null&&(t!==o&&!t.startsWith(o.endsWith(h)?o:`${o}${h}`)||(i===null||o.length>i.depth)&&(i={id:e.id,depth:o.length}))}return i?.id??null}r(q,"pinnedProfileFor");async function w(n){try{return await g().getNode(n)}catch(t){if(t instanceof N&&t.status===404)return null;throw t}}r(w,"fetchNodeOrNull");async function E(n){const t=new Set([n.node_id]);let i=n.parent,e=0;for(;i!=null&&!t.has(i);){t.add(i),e+=1;const o=await w(i);if(o===null)break;i=o.parent}return e}r(E,"spineDepth");export{L as adminLeaf};

package/dist/commands/sys/context/doc.d.ts

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

package/dist/commands/sys/context/doc.js

@@ -0,0 +1,2 @@
+var v=Object.defineProperty;var a=(n,e)=>v(n,"name",{value:e,configurable:!0});import{defineLeaf as g}from"../../../core/command.js";import{InputError as b}from"../../../core/io.js";import{PLANNED_EVENTS as h,SNAPSHOT_PARAMS as _,buildSnapshot as j,delivers as f,describeSubject as q,dryRun as x,exclusionReason as k,nodeLine as R,snapshotHead as T,gateText as $,optionalString as l,ruleText as N,subjectFor as P,subjectSummary as S,table as p}from"./resolve.js";const W=g({name:"doc",description:"show one document\u2019s delivery across every event for one node",whenToUse:"a document is reaching a node it should not, or failing to reach one it should \u2014 this says which event delivers it, at what level, and what excluded it everywhere else",help:{name:"sys context doc",summary:"show where one document delivers to a node, at what level, and what excludes it elsewhere",params:[{kind:"positional",name:"name",required:!0,constraint:"The document as the node names it, exactly as `crtr canvas read` takes it: its bare name, or `<owner>/<name>` for a document another owner holds under the same name."},..._,{kind:"flag",name:"event",type:"enum",choices:[...h],required:!1,constraint:"Report only this rule `on` name instead of all of them."},{kind:"flag",name:"file",type:"path",required:!1,constraint:"Payload for the file-read event: the file being read. Without it, no file-read rule matches."},{kind:"flag",name:"read-name",type:"string",required:!1,constraint:"Payload for the document-read event: the document read, as `crtr canvas read` takes it. Without it, no document-read rule matches."},{kind:"flag",name:"command",type:"string",required:!1,constraint:"Payload for the command and pre-command events: the command string."}],output:[{name:"name",type:"string",required:!0,constraint:"The document\u2019s name as the node sees it."},{name:"kind",type:"string",required:!0,constraint:"knowledge or preference."},{name:"owner",type:"string",required:!0,constraint:"The owner handle: a node id, or the space or profile name."},{name:"ref",type:"string",required:!0,constraint:"The document\u2019s object id."},{name:"node",type:"string",required:!1,constraint:"The node the dry runs ran for, or the node --cwd and --profile dialled away from. Absent when the node is simulated."},{name:"cwd",type:"string",required:!1,constraint:"The simulated node\u2019s directory. Present when the node is simulated."},{name:"node_missing",type:"boolean",required:!1,constraint:"Present when --node named a node that does not exist, so the node was simulated."},{name:"subject",type:"object",required:!0,constraint:"The node configuration every row was computed under."},{name:"rules",type:"array",required:!0,constraint:"The document\u2019s rules for the reported events: on, match, if, deliver."},{name:"events",type:"array",required:!0,constraint:"One row per event: event, delivers, authored_rung, limit, capped_rung, final_rung, gate, matched_rule, winner, shadowed_by, excluded."}],outputKind:"object",effects:["None. Read-only; the dry runs record nothing."]},run:a(async n=>{const e=await j(n),r=n.name,w=l(n.event)===null?[...h]:[n.event],y={file:l(n.file),readName:l(n.readName),command:l(n.command)};let t=null,u=null;const m=[],c=[];for(const o of w){const{plan:d}=await x(e,o,P(o,y));u??=d.subject;const i=d.docs.find(s=>t!==null?s.doc.object.id===t.object.id:A(s.doc,r))??null;i!==null&&(t??=i.doc,m.push(...i.authoredRules.map(s=>s.rule))),c.push({event:o,record:i})}if(t===null)throw new b({error:"not_found",message:`no document ${r} with a delivery rule in ${e.nodeId===null?"the simulated node":`node ${e.nodeId}`}\u2019s view for these events`,field:"name",next:"Check the name with `crtr sys context resolve --all-events --all`, which lists every document the node considers."});return{name:t.displayName,kind:t.kind,owner:t.ownerHandle,ref:t.object.id,...T(e),subject:S(u),rules:m.map(E),events:c.map(({event:o,record:d})=>H(o,d,u))}},"run"),render:a(n=>L(n),"render")});function A(n,e){return n.displayName===e||`${n.ownerHandle}/${n.name}`===e}a(A,"matchesName");function E(n){return{on:n.on,match:n.match===void 0?null:n.match.join(", "),if:n.if!==void 0,deliver:n.deliver}}a(E,"ruleRow");function H(n,e,r){return e===null?{event:n,delivers:!1,authored_rung:"none",limit:null,capped_rung:"none",final_rung:"none",gate:null,matched_rule:null,winner:!1,shadowed_by:null,excluded:"no rule for this event"}:{event:n,delivers:f(e),authored_rung:e.authoredRung,limit:e.limit,capped_rung:e.cappedRung,final_rung:e.finalRung,gate:$(e,r),matched_rule:N(e.matchedRule),winner:e.winner,shadowed_by:e.shadowedBy===null?null:`${e.shadowedBy.ownerHandle}/${e.shadowedBy.name}`,excluded:f(e)?null:k(e,r)}}a(H,"eventRow");function L(n){return[`# ${n.name}`,"",`- kind: ${n.kind}`,`- owner: ${n.owner}`,`- ref: ${n.ref}`,"",R(n),`subject: ${q(n.subject)}`,"","## Rules","",n.rules.length===0?"None for these events.":p(["on","deliver","match","if"],n.rules.map(e=>[e.on,e.deliver,e.match??"\u2014",e.if?"yes":"\u2014"])),"","## Delivery per event","",p(["event","delivers","authored","limit","final","matched","if","why not"],n.events.map(e=>[e.event,e.delivers?"yes":"no",e.authored_rung,e.limit??"\u2014",e.final_rung,e.matched_rule??"\u2014",e.gate??"\u2014",e.excluded??"\u2014"]))].join(`
+`)}a(L,"renderDoc");export{W as docLeaf};

package/dist/commands/sys/context/expose.d.ts

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

package/dist/commands/sys/context/expose.js

@@ -0,0 +1,2 @@
+var d=Object.defineProperty;var a=(n,t)=>d(n,"name",{value:t,configurable:!0});import{accessSync as l,constants as c,realpathSync as f,statSync as u}from"node:fs";import{resolve as h}from"node:path";import{defineLeaf as p}from"../../../core/command.js";import{expandTilde as m}from"../../../core/fs-utils.js";import{brokerDelivery as y}from"../../../core/runtime/broker/daemon-ops.js";import{envExecutionId as v,envNodeId as b}from"../../../shared/env.js";function g(n){const t=[],o=new Set;for(const s of n)try{const e=f(h(m(s)));if(l(e,c.R_OK),!u(e).isFile()||o.has(e))continue;o.add(e),t.push(e)}catch{}return t}a(g,"readableRegularFiles");const D=p({name:"expose",description:"deliver file-read documents for file content a local command displays",whenToUse:"a local command has successfully rendered file contents and must place the documents their file-read rules deliver in that same output",help:{name:"sys context expose",summary:"deliver file-read documents for files displayed by a command",params:[{kind:"flag",name:"file",type:"path",required:!0,repeatable:!0,constraint:"Files whose contents the caller displays. Relative paths resolve against this process\u2019s cwd; leading ~ expands as for Read. Symlinks resolve to their target. Missing, unreadable, and non-file paths contribute nothing."}],output:[{name:"content",type:"string",required:!1,constraint:"The delivered <auto-loaded-context> blocks, one per displayed file with new matches. Absent when nothing new matches or the caller is not inside a node. Prose output is the blocks alone, without a field label or acknowledgement."}],outputKind:"object",effects:["Delivers through the current node\u2019s file-read activity: records its exposures, and a watch and read event for each document delivered at content. Inherits node identity from CRTR_NODE_ID. The caller must include the returned blocks in the same output as the displayed files; this is not a preview operation."]},run:a(async n=>{const t=b()?.trim();if(t===void 0||t==="")return{};const o=g(n.file);if(o.length===0)return{};const s=v();if(s===void 0||s==="")return{};const e=[];for(const i of o){const r=await y(t,{activity:"file-read",subject:i});r.content!==""&&e.push(r.content)}return e.length===0?{}:{content:e.join(`
+`)}},"run"),render:a(n=>n.content??"","render")});export{D as exposeLeaf};

package/dist/commands/sys/context/prompt-review.d.ts

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

package/dist/commands/sys/context/prompt-review.js

@@ -0,0 +1,11 @@
+var $=Object.defineProperty;var o=(n,e)=>$(n,"name",{value:e,configurable:!0});import{mkdirSync as q,writeFileSync as S}from"node:fs";import{join as y}from"node:path";import{defineLeaf as P}from"../../../core/command.js";import{InputError as c,readStdinRaw as _}from"../../../core/io.js";import{userScopeRoot as j}from"../../../core/scope.js";import{ApiError as M}from"../../../api/index.js";import{cliClient as w}from"../../api-client.js";import{envNodeId as D}from"../../../shared/env.js";import{readMergedLaunchConfig as L,subKindsAvailableTo as O}from"../../../core/config.js";import{LAUNCH_SYSTEM_PROMPT as u}from"../../../core/runtime/launch-prompt.js";function R(n,e){return e!==void 0?e:n==="orchestrator"?"resident":"terminal"}o(R,"resolveLifecycle");function N(n){try{return JSON.parse(n)}catch(e){throw new c({error:"invalid_json",message:`stdin is not valid JSON: ${String(e)}`,field:"stdin",next:"Pass the comments deck JSON on stdin."})}}o(N,"readJson");function b(n,e,r){if(n===void 0)return r;if(n===!0||n===!1)return n;if(typeof n!="string")throw new c({error:"invalid_field",message:`${e} must be true or false`,field:e,next:`Use true or false for ${e}.`});const t=n.trim().toLowerCase();if(t==="true")return!0;if(t==="false")return!1;throw new c({error:"invalid_field",message:`${e} must be true or false`,field:e,next:`Use true or false for ${e}.`})}o(b,"parseBool");function T(n){return typeof n=="string"&&n.trim()!==""?n:null}o(T,"optionalString");function p(n){return Math.ceil(n.length/4)}o(p,"approxTokens");function C(){const n=L().kinds;return Object.entries(n).filter(([e])=>!e.includes("/")).map(([e,r])=>({kind:e,whenToUse:r.whenToUse})).sort((e,r)=>e.kind.localeCompare(r.kind))}o(C,"topLevelKinds");function U(n){return O(n)}o(U,"subKindsFor");function I(){const n=C(),e={};for(const{kind:r}of n)e[r]=U(r);return{kinds:n,modes:["base","orchestrator"],lifecycles:["terminal","resident"],subPersonas:e}}o(I,"reviewList");async function A(n){if(n===null)return null;try{return await w().getNode(n)}catch(e){if(e instanceof M&&e.status===404)return null;throw e}}o(A,"fetchNodeOrNull");async function k(n,e,r){const t=await w().nodeDelivery(n,{dry_run:!0,activity:e,subject_override:r});return{content:t.content,docs:t.plan?.docs??[]}}o(k,"dryRun");function E(n,e){const t=n.indexOf(`
+
+Guidelines:`);return t===-1?`${n}
+
+${e}`:`${n.slice(0,t)}
+
+${e}${n.slice(t)}`}o(E,"spliceIntoScaffold");function J(){const n=y(j(),"prompt-reviews");return q(n,{recursive:!0}),y(n,`${new Date().toISOString()}.md`)}o(J,"promptReviewPath");function K(n){const e=[];if(e.push(`# Prompt review \u2014 ${n.config.kind}/${n.config.mode}`),e.push(""),e.push("## Config"),e.push(`- timestamp: ${new Date().toISOString()}`),e.push(`- kind: ${n.config.kind}`),e.push(`- mode: ${n.config.mode}`),e.push(`- lifecycle: ${n.config.lifecycle}`),e.push(`- hasManager: ${String(n.config.hasManager)}`),e.push(`- node: ${n.config.node??"(none)"}`),e.push(""),e.push("## Comments"),n.comments.length===0)e.push("- none");else{for(const t of n.comments)e.push(`### ${t.label} (${t.layerId})`),e.push(`- source: \`${t.sourcePath??"(generated)"}\` (${t.scope})`),t.anchor!==null&&e.push("> "+t.anchor.split(`
+`).join(`
+> `)),e.push(t.body),e.push("");e[e.length-1]===""&&e.pop()}e.push(""),e.push("## Prompt sources (edit these documents)");const r=new Set;for(const t of n.sources){const i=`${t.scope}:${t.path}`;r.has(i)||(r.add(i),e.push(`- ${t.label} \u2014 \`${t.path}\` (${t.scope})`))}return e.push(""),e.push("These are review comments on an assembled system prompt; edit the listed documents (ref and owner) with `crtr doc edit` to address them."),e.join(`
+`)+`
+`}o(K,"renderExportDeck");function B(n){const e=J();return S(e,K(n),"utf8"),{path:e}}o(B,"exportReview");async function F(n){const e=n.kind,r=n.mode??"base",t=R(r,n.lifecycle),i=b(n.hasManager,"hasManager",!0),f=T(n.node);if(e===void 0||e.trim()==="")throw new c({error:"missing_parameter",message:"kind is required",field:"kind",next:"Pass --kind <kind> or use --list."});const a=await A(f??D()??null);if(a===null)throw new c({error:"missing_parameter",message:"prompt-review needs an existing node whose view it renders",field:"node",next:"Pass --node <id> of a node that exists, or run from inside a node."});const g={kind:e,mode:r,lifecycle:t,hasManager:i},d=(await k(a.node_id,"system-prompt",g)).content,l=await k(a.node_id,"boot",g),x=l.docs.filter(s=>s.winner&&s.finalRung==="content"&&!s.doc.ownNode&&s.doc.kind==="preference"),m=[{id:"launch-scaffold",label:"Launch scaffold",group:"generated",source:"generated: launch scaffold",sourcePath:null,scope:"generated",included:!0,condition:null,text:u,tokens:p(u),chars:u.length}];d!==""&&m.push({id:"preferences",label:"Preferences",group:"substrate",source:"delivery: system-prompt",sourcePath:null,scope:"generated",included:!0,condition:null,text:d,tokens:p(d),chars:d.length}),l.content!==""&&m.push({id:"boot-context",label:"Boot context \u2014 context message, not system prompt",group:"substrate",source:"delivery: boot",sourcePath:null,scope:"runtime",included:!1,condition:"session_start context message, not the system prompt",text:l.content,tokens:p(l.content),chars:l.content.length});const h=E(u,d),v=x.map(s=>({id:s.doc.displayName,label:s.doc.displayName,path:s.doc.object.id,scope:s.doc.ownerHandle}));return{config:{kind:e,mode:r,lifecycle:t,hasManager:i,node:a?.node_id??null},layers:m,assembled:h,total:{tokens:p(h),chars:h.length},sources:v}}o(F,"resolveDeck");const te=P({name:"prompt-review",description:"inspect an assembled prompt and export review notes",whenToUse:"you want to inspect a composed persona prompt for a kind/mode combo, compare the space around it, or export review notes back to source files",help:{name:"sys context prompt-review",summary:"inspect an assembled prompt and export review notes",params:[{kind:"positional",name:"action",type:"string",required:!1,constraint:"Optional subcommand: export. Omit for the assembled prompt contract."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Persona kind to inspect. Required unless --list or export."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,default:"base",constraint:"Persona mode. Default: base."},{kind:"flag",name:"lifecycle",type:"enum",choices:["terminal","resident"],required:!1,constraint:"Lifecycle axis. Default: base -> terminal, orchestrator -> resident."},{kind:"flag",name:"has-manager",type:"string",required:!1,default:"true",constraint:"Whether the node reports to a manager. Use true or false. Default: true."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"The node whose view and profile limits render the prompt. Defaults to the calling node (CRTR_NODE_ID); the node must exist unless --list or export."},{kind:"flag",name:"list",type:"bool",required:!1,constraint:"List the available kinds, modes, lifecycles, and sub-personas."}],output:[{name:"config",type:"object",required:!1,constraint:"Resolved config: {kind, mode, lifecycle, hasManager, node}."},{name:"layers",type:"object[]",required:!1,constraint:"Ordered prompt layers, including excluded alternatives and provenance."},{name:"assembled",type:"string",required:!1,constraint:"The assembled prompt string."},{name:"total",type:"object",required:!1,constraint:"Approximate token/char totals for included layers."},{name:"sources",type:"object[]",required:!1,constraint:"The preference documents delivered into the prompt: {id, label, path (the document ref), scope (the owner)}."},{name:"kinds",type:"object[]",required:!1,constraint:"Available kinds for --list."},{name:"modes",type:"string[]",required:!1,constraint:"Mode choices for --list."},{name:"lifecycles",type:"string[]",required:!1,constraint:"Lifecycle choices for --list."},{name:"subPersonas",type:"object",required:!1,constraint:"Available sub-personas keyed by kind for --list."},{name:"path",type:"string",required:!1,constraint:"Written markdown path for export."}],outputKind:"object",effects:["Read-only inspection, or writes a review markdown file under `~/.crouter/prompt-reviews/`."]},run:o(async n=>{const e=n.action,r=n.list===!0,t=b(n.hasManager,"hasManager",!0);if(e!==void 0&&e!=="export")throw new c({error:"unknown_action",message:`unknown action: ${e}`,field:"action",next:"Use `export` or omit the positional action."});if(e==="export"){const f=await _(),a=N(f);return B(a)}return r?I():await F({...n,hasManager:t})},"run")});export{te as promptReviewLeaf};