@north-light/cli 0.0.0 → 0.3.413

package/dist/commands/sys/sync-shared.d.ts

@@ -0,0 +1,44 @@
+import { type CrtrClient } from '../../api/index.js';
+import type { DeliveryRuleDTO, DocKindName } from '../../api/dto/docs.js';
+import type { PrivacyName } from '../../api/dto/objects.js';
+export declare function scalarString(value: unknown): string | undefined;
+export declare function routeFromDescription(description: string, kind: string): string;
+/** Slugify a raw name/path into a document name: lowercase, `.md` stripped,
+ *  path separators normalized to `/`, each segment reduced to `[a-z0-9_-]`. */
+export declare function normalizedName(raw: string): string;
+/** A document a sync lane converts, in `/v1/docs` terms. */
+export interface SyncDoc {
+    name: string;
+    body: string;
+    preview: string;
+    summary?: string;
+    kind: DocKindName;
+    privacy?: PrivacyName;
+    rules: DeliveryRuleDTO[];
+}
+/** Legacy `surfaces`/`gate`/`slash` frontmatter as `/v1/docs` rules. */
+export declare function rulesFromLegacyFrontmatter(fm: Record<string, unknown>): DeliveryRuleDTO[];
+/** Where a lane's documents go: the repo enclosing `cwd`, or the person. */
+export interface SyncOwner {
+    owner: 'repo' | 'user';
+    /** Sent with every write so `--owner repo` resolves this repo. */
+    cwd: string;
+    /** The owner's handle; for an owner not yet on the canvas, the handle it is expected to get. */
+    handle: string;
+    /** Local names of the owner's existing documents. */
+    existing: Set<string>;
+}
+/** The repo enclosing `dir`. Throws when `dir` is in no repo. */
+export declare function repoOwner(client: CrtrClient, dir: string): Promise<SyncOwner>;
+/** The person on this runtime. */
+export declare function userOwner(client: CrtrClient): Promise<SyncOwner>;
+/** Write `doc` as a new document, or replace an existing one's body and fields
+ *  (read first, as every edit requires). Answers the document's full name and
+ *  whether anything changed. The first write under an owner that was not yet
+ *  on the canvas corrects `owner.handle` from the name the daemon answers. */
+export declare function putDoc(client: CrtrClient, owner: SyncOwner, doc: SyncDoc, rationale: string): Promise<{
+    name: string;
+    changed: boolean;
+}>;
+/** One line for a failed write, for a lane's `skipped` row. */
+export declare function writeFailure(err: unknown): string;

package/dist/commands/sys/sync-shared.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var i=(n,e)=>f(n,"name",{value:e,configurable:!0});import{ApiError as h}from"../../api/index.js";import{identifyCheckout as p}from"../../core/graph/repo-sync/identity.js";import{rulesFromFrontmatter as w}from"../../core/graph/rules.js";import{usage as g}from"../../core/errors.js";function S(n){if(typeof n=="string")return n;if(typeof n=="number"||typeof n=="boolean")return String(n)}i(S,"scalarString");function m(n){let e=n.replace(/\s+/g," ").trim();return e=e.replace(/^[,;:.\s]+/,"").replace(/[,;:.\s]+$/,""),/^[A-Z][a-z]/.test(e)&&(e=e.charAt(0).toLowerCase()+e.slice(1)),e}i(m,"cleanClause");const y=/\b(?:use\s+this\s+skill\s+when|use\s+this\s+when|this\s+skill\s+should\s+be\s+used\s+when|used\s+when|use\s+when)\b\s*/i;function v(n,e){const t=n.replace(/\s+/g," ").trim();if(t==="")return`When this migrated ${e} applies, this ${e} should be read.`;const r=t.match(y);if(r&&r.index!==void 0){const a=m(t.slice(0,r.index)),o=m(t.slice(r.index+r[0].length));if(o!==""){let s=`When ${o}, this ${e} should be read`;return a!==""&&(s+=` because ${a}`),`${s}.`}}return`When ${m(t)}, this ${e} should be read.`}i(v,"routeFromDescription");function C(n){return n.replace(/\\/g,"/").replace(/\.md$/i,"").split("/").map(t=>t.trim().toLowerCase().replace(/[^a-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"")).filter(Boolean).join("/")}i(C,"normalizedName");function E(n){return w(n).map(e=>({on:e.on,deliver:e.deliver,...e.match!==void 0?{match:e.match}:{},...e.matchFrontmatter!==void 0?{match_frontmatter:e.matchFrontmatter}:{},...e.if!==void 0?{if:e.if}:{}}))}i(E,"rulesFromLegacyFrontmatter");async function d(n,e,t){let r;do{const a=await n.objects.list({type:e,limit:100,...r?{cursor:r}:{}});for(const o of a.items){const s=await n.objects.read(o.id);if(s.state!=="object"||s.type!==e)continue;const u=s.data;if(u.identity.external_id===t)return u.handle}r=a.next_cursor??void 0}while(r);return null}i(d,"ownerByIdentity");async function l(n,e){const t=new Set;let r;do{const a=await n.objects.list({type:"document",owner:e,limit:100,...r?{cursor:r}:{}});for(const o of a.items)t.add(o.name);r=a.next_cursor??void 0}while(r);return t}i(l,"documentNames");async function W(n,e){const t=p(e);if(!t.ok)throw g(`${e} is not inside a repo: ${t.reason}`);const r=await d(n,"repo",t.externalId);return{owner:"repo",cwd:t.root,handle:r??t.handleHint,existing:r?await l(n,r):new Set}}i(W,"repoOwner");async function k(n){const e=await d(n,"person","user:local");return{owner:"user",cwd:process.cwd(),handle:e??"user",existing:e?await l(n,e):new Set}}i(k,"userOwner");async function z(n,e,t,r){const a={preview:t.preview,...t.summary!==void 0&&t.summary!==""?{summary:t.summary}:{},...t.privacy!==void 0?{privacy:t.privacy}:{},rules:t.rules};if(!e.existing.has(t.name)){const c=await n.docs.write({name:t.name,body:t.body,kind:t.kind,owner:e.owner,cwd:e.cwd,...a});return e.handle=c.name.slice(0,c.name.length-t.name.length-1),e.existing.add(t.name),{name:c.name,changed:!0}}const o=`${e.handle}/${t.name}`,s=await n.objects.read(o),u=s.state==="object"&&s.type==="document"?s.data.bodies:null;return s.state==="object"&&u!==null&&u.length===1&&u[0]===t.body&&s.object.preview===t.preview?{name:o,changed:!1}:{name:(await n.docs.edit(o,{body:t.body,rationale:r,...a})).name,changed:!0}}i(z,"putDoc");function A(n){if(n instanceof h)return n.message;throw n}i(A,"writeFailure");export{C as normalizedName,z as putDoc,W as repoOwner,v as routeFromDescription,E as rulesFromLegacyFrontmatter,S as scalarString,k as userOwner,A as writeFailure};

package/dist/commands/sys/sync-skills.d.ts

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

package/dist/commands/sys/sync-skills.js

@@ -0,0 +1,2 @@
+var _=Object.defineProperty;var i=(e,o)=>_(e,"name",{value:o,configurable:!0});import{existsSync as j}from"node:fs";import{userFilesRoot as C}from"../../core/layout.js";import{basename as R,dirname as k,join as f,relative as E,resolve as h,sep as N}from"node:path";import{defineLeaf as O}from"../../core/command.js";import{usage as L}from"../../core/errors.js";import{parseFrontmatterGeneric as q}from"../../core/frontmatter.js";import{readJsonIfExists as P,readText as D,walkFiles as M,writeJson as T}from"../../core/fs-utils.js";import{identifyCheckout as J}from"../../core/graph/repo-sync/identity.js";import{runtimeRoot as W}from"../../core/layout.js";import{piAgentDir as G}from"../../core/runtime/package-health.js";import{CRTR_DIR_NAME as H}from"../../types.js";import{cliClient as U}from"../api-client.js";import{normalizedName as x,putDoc as z,repoOwner as B,routeFromDescription as V,rulesFromLegacyFrontmatter as X,scalarString as S,userOwner as Y,writeFailure as Q}from"./sync-shared.js";const Z="<!-- crtr-boot-skill v",$="SKILL.md",y="skill-import-ignore.json",ee=new Set(["node_modules",".git",".venv","venv","dist","build",".next",".cache",".yalc",".sisyphus",H]);function oe(){const e=J(process.cwd());return e.ok?e.root:null}i(oe,"projectDir");function w(){return f(W(),y)}i(w,"ignoreFilePath");function te(){const e=[{label:"claude-user",root:f(C(),".claude","skills"),defaultScope:"user"},{label:"pi-user",root:f(G(),"skills"),defaultScope:"user"}],o=oe();return o&&(e.push({label:"claude-project",root:f(o,".claude","skills"),defaultScope:"project"}),e.push({label:"pi-project",root:f(o,".pi","agent","skills"),defaultScope:"project"})),e}i(te,"defaultSourceRoots");function re(e,o){if(e===void 0)return te();const r=h(e);if(o!==void 0&&o!=="user"&&o!=="project")throw L(`invalid --scope: ${o} (expected user|project)`);return[{label:"source",root:r,defaultScope:o??"user"}]}i(re,"sourceRootsFromArg");function ne(e){const o=e.root;if(!j(o))return[];const r=h(o),t=[];if(R(r)===$)return t.push({path:r,root:k(r),source:e.label,defaultScope:e.defaultScope}),t;const n=f(r,$);if(j(n))return t.push({path:n,root:k(r),source:e.label,defaultScope:e.defaultScope}),t;for(const a of M(r,c=>c===$,c=>ee.has(c)))t.push({path:a,root:r,source:e.label,defaultScope:e.defaultScope});return t}i(ne,"collectCandidates");function se(e,o){const r=S(o?.name);if(r&&r.trim()!=="")return x(r);const t=E(e.root,k(e.path)).split(N).join("/");return x(t||R(k(e.path)))}i(se,"nameForCandidate");function ie(e){const o=new Map;return r=>{let t=o.get(r);return t===void 0&&(t=r==="user"?Y(e):B(e,process.cwd()),o.set(r,t)),t}}i(ie,"ownerResolver");function ce(){let e;try{e=P(w())}catch(r){throw L(`invalid JSON in ${w()}: ${r instanceof Error?r.message:String(r)}`)}if(e===null)return{version:1,ignored:[]};if(typeof e!="object"||e===null||e.version!==1||!Array.isArray(e.ignored))throw L(`malformed ${w()}: expected {"version":1,"ignored":[...]}`);const o=[];for(const r of e.ignored){if(typeof r!="object"||r===null)continue;const t=r;typeof t.source=="string"&&typeof t.name=="string"&&(t.scope==="user"||t.scope==="project")&&typeof t.ignoredAt=="string"&&o.push({source:h(t.source),name:t.name,scope:t.scope,ignoredAt:t.ignoredAt})}return{version:1,ignored:o}}i(ce,"readIgnoreState");function ae(e){T(w(),e)}i(ae,"writeIgnoreState");function F(e,o){const r=h(e.candidate.path);return o.ignored.some(t=>t.source===r||t.scope===e.scope&&t.name===e.name)}i(F,"isIgnored");function ue(e,o){return F(e,o)?!1:(o.ignored.push({source:h(e.candidate.path),name:e.name,scope:e.scope,ignoredAt:new Date().toISOString()}),o.ignored.sort((r,t)=>`${r.scope}/${r.name}`.localeCompare(`${t.scope}/${t.name}`)),!0)}i(ue,"rememberIgnored");function K(e,o,r){return{source:e.path,name:"",scope:o,status:"skipped",reason:r}}i(K,"skipResult");async function le(e,o,r){const t=D(e.path),n=r??e.defaultScope;if(t.includes(Z))return K(e,n,"legacy generated crtr boot skill is pruned by host exports, not imported");const a=q(t),c=a.data??{},u=c.kind==="preference"?"preference":"knowledge",l=se(e,c);if(l==="")return K(e,n,"could not derive a document name");const p=await o(n);return{candidate:e,raw:t,parsed:a,sourceFm:c,kind:u,localName:l,name:`${p.handle}/${l}`,scope:n,owner:p}}i(le,"prepareCandidate");const de=["public","friends","private"];async function pe(e,o,r){const t={source:o.candidate.path,name:o.name,scope:o.scope};if(o.owner.existing.has(o.localName)&&!r.overwrite)return{...t,status:"skipped",reason:"a document with this name already exists; re-run with --overwrite to replace it"};if(r.dryRun)return{...t,status:"would-import"};const n=o.sourceFm,a=S(n.description)??"",c=S(n["when-and-why-to-read"])?.trim(),u=S(n["short-form"])?.trim(),l=X(n),p=de.find(m=>m===n.privacy),s={name:o.localName,kind:o.kind,preview:(c!==void 0&&c!==""?c:V(a,o.kind)).replace(/\s+/g," "),summary:u!==void 0&&u!==""?u:a.replace(/\s+/g," ").trim(),...p!==void 0?{privacy:p}:{},rules:Array.isArray(n.surfaces)?l:[{on:"boot",deliver:"preview"}],body:o.parsed.body};try{const m=await z(e,o.owner,s,"imported by crtr sys sync skills");return{...t,name:m.name,status:m.changed?"imported":"unchanged"}}catch(m){return{...t,status:"skipped",reason:Q(m)}}}i(pe,"convertPrepared");function A(e,o,r){return{source:e.candidate.path,name:e.name,scope:e.scope,status:r?"would-ignore":"ignored",reason:o}}i(A,"ignoreResult");function me(e,o){const r=e.filter(s=>s.status==="imported").length,t=e.filter(s=>s.status==="would-import").length,n=e.filter(s=>s.status==="skipped").length,a=e.filter(s=>s.status==="ignored").length,c=e.filter(s=>s.status==="would-ignore").length;let u;o?u=`crtr sys sync skills \u2014 ${c>0?`${c} would ignore`:`${a} ignored`}, ${n} skipped`:t>0?u=`crtr sys sync skills \u2014 dry run: ${t} would import, ${n} skipped, ${a} ignored`:u=`crtr sys sync skills \u2014 ${r} imported, ${n} skipped, ${a} ignored`;const l=e.map(s=>{const m=s.reason?` (${s.reason})`:"";return`| ${s.status} | ${s.name||"\u2014"} | ${s.source}${m} |`}),p=l.length===0?["No sync candidates."]:["| status | document | source |","| --- | --- | --- |",...l];return[u,"",...p].join(`
+`)}i(me,"renderSummary");const xe=O({name:"skills",description:"import host Agent Skill (SKILL.md) bundles as documents",whenToUse:"migrating legacy host-native Agent Skill bundles (SKILL.md \u2014 Claude/pi user or project skill roots, or an explicit bundle/root via --source) into documents. One-way: crouter never re-exports documents back to SKILL.md, and stops reading the originals unconditionally once migrated.",help:{name:"sys sync skills",summary:"one-way import: host SKILL.md bundles \u2192 documents owned by you or the repo",params:[{kind:"flag",name:"source",type:"string",required:!1,constraint:"A SKILL.md file, a single skill bundle dir containing SKILL.md, or a skills root to scan recursively. Default: the user/project Claude and pi skill roots that exist."},{kind:"flag",name:"scope",type:"enum",choices:["user","project"],required:!1,constraint:"Owner of the imported documents. `user` \u2014 you, the person; `project` \u2014 the repo of the working directory (a repo owns only public documents). Default: user for user host roots and project for project host roots; an explicit value applies to every selected source."},{kind:"flag",name:"dry-run",type:"bool",required:!1,constraint:"Show what would be imported without writing documents."},{kind:"flag",name:"overwrite",type:"bool",required:!1,constraint:"Replace the body and fields of an existing document of the same name (a new revision). Default: skip it."},{kind:"flag",name:"ignore",type:"bool",required:!1,constraint:`Permanently ignore every selected SKILL.md source by recording it in ~/.crouter/${y}. Honors --source/--scope; with no --source, ignores every currently discovered default host skill candidate.`},{kind:"flag",name:"include-ignored",type:"bool",required:!1,constraint:"Include ignored candidates in the report without making sync read-only. Pair with --dry-run to audit the full candidate set without importing non-ignored skills."}],output:[{name:"results",type:"object[]",required:!0,constraint:"Each: {source,target,name,scope,status,reason?}; status is one of imported, unchanged, skipped, would-import, ignored, would-ignore. `name` is the document's full name, `<owner handle>/<bundle name>`."}],outputKind:"object",effects:["Writes the document `<owner handle>/<bundle name>` with the SKILL.md body; its preview comes from the skill description, and it carries a boot rule at preview unless the source declares its own `surfaces`.","Skips existing documents unless --overwrite is present.","Skips marker-bearing generated crtr boot skills; host exports prune those legacy artifacts instead.",`With --ignore: writes ~/.crouter/${y} and does not import the selected sources.`,"With --dry-run: read-only; writes nothing."]},run:i(async e=>{const o=e.source,r=e.scope,t=e.dryRun??!1,n=e.overwrite??!1,a=e.ignore??!1,c=e.includeIgnored??!1,u=re(o,r),l=new Set,p=[];for(const I of u)for(const d of ne(I))l.has(d.path)||(l.add(d.path),p.push(d));const s=U(),m=ie(s),b=ce(),g=[];let v=!1;for(const I of p){const d=await le(I,m,r);if("status"in d){g.push(d);continue}if(a){t||(v=ue(d,b)||v),g.push(A(d,t?"would record permanent ignore":`recorded in ~/.crouter/${y}`,t));continue}if(F(d,b)){c&&g.push(A(d,`matched ~/.crouter/${y}`,!1));continue}g.push(await pe(s,d,{dryRun:t,overwrite:n}))}return v&&ae(b),{results:g,ignoreFile:w(),ignoreMode:a}},"run"),render:i(e=>me(e.results,e.ignoreMode===!0),"render")});export{xe as sysSyncSkillsLeaf};

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

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

package/dist/commands/sys/sync.js

@@ -0,0 +1 @@
+import{defineBranch as e}from"../../core/command.js";import{sysSyncSkillsLeaf as n}from"./sync-skills.js";import{sysSyncProjectGuidanceLeaf as o}from"./sync-project-guidance.js";import{sysSyncDepsLeaf as s}from"./sync-deps.js";const c=e({name:"sync",description:"migrate non-crouter guidance surfaces into documents",whenToUse:"importing or migrating an external guidance source \u2014 host Agent Skill bundles, project CLAUDE.md/AGENTS.md/.claude/rules, or npm-dependency-shipped Agent Skill bundles \u2014 into documents",help:{name:"sys sync",summary:"migrate external guidance sources into documents",model:"Three independent one-way conversion lanes, none of which ever export documents back to their source: skills imports host-native SKILL.md bundles as documents owned by you or by the working directory's repo; project-guidance migrates a repo's own CLAUDE.md/AGENTS.md/.claude/rules into documents owned by that repo; deps vendors Agent Skill bundles shipped inside installed npm dependencies as the repo's `deps/\u2026` documents, rewritten on every run."},children:[n,o,s]});export{c as sysSyncBranch};

package/dist/commands/sys/terminal-option.d.ts

@@ -0,0 +1,112 @@
+export type TerminalId = 'terminal-app' | 'iterm2' | 'ghostty' | 'vscode' | 'cursor' | 'wezterm' | 'kitty' | 'alacritty' | 'unknown';
+export interface DetectedTerminal {
+    readonly id: TerminalId;
+    readonly name: string;
+}
+/** True positive identification of the terminal the user is typing into, from the
+ *  variables terminals export. `TERM_PROGRAM` is overwritten by tmux (`tmux`), so
+ *  terminal-specific markers are consulted after it. */
+export declare function detectTerminal(env: NodeJS.ProcessEnv): DetectedTerminal;
+/** One safe, previewable write. `lines` is EXACTLY what lands in the file. */
+export interface TerminalConfigEdit {
+    readonly kind: 'append-lines' | 'jsonc-insert-property';
+    readonly path: string;
+    readonly lines: readonly string[];
+    /** Ghostty only: the default config files in load order, so applying can
+     *  re-check (against the files as they are then) that the appended line will be
+     *  the effective one. */
+    readonly ghosttyPaths?: readonly string[];
+    /** Where a running terminal picks the change up. */
+    readonly reload: string;
+}
+export type OptionAsAltStatus = 'configured' | 'unverified' | 'needs-change';
+export interface OptionAsAltPlan {
+    readonly terminal: DetectedTerminal;
+    readonly status: OptionAsAltStatus;
+    /** One-line verdict shown under the heading. */
+    readonly summary: string;
+    /** How to set it by hand (always present unless already configured). */
+    readonly instructions: readonly string[];
+    /** Present only where crouter can write the setting safely. */
+    readonly edit?: TerminalConfigEdit;
+}
+export interface PlanInput {
+    readonly env: NodeJS.ProcessEnv;
+    readonly platform: NodeJS.Platform;
+    readonly home: string;
+}
+/** Ghostty's default config files in the documented load order (ghostty.org/docs/
+ *  config#file-location) — a later file overrides an earlier one, and every macOS
+ *  Application Support file loads after every XDG file. */
+export declare function ghosttyConfigPaths(env: NodeJS.ProcessEnv, home: string): string[];
+export interface GhosttySetting {
+    /** The effective value; `undefined` when never assigned (or reset to default). */
+    readonly value: string | undefined;
+    /** The file holding the last effective assignment. */
+    readonly source: string | undefined;
+    /** An existing file that could not be read — the answer may be incomplete. */
+    readonly unreadable: readonly string[];
+}
+type ReadText = (path: string) => string | null;
+/** The effective `macos-option-as-alt`, following Ghostty's own precedence: the
+ *  default files load in order (a later file overrides an earlier one, the last
+ *  assignment within a file wins), then every `config-file` include — from any of
+ *  them — loads after ALL of them, in order, so an include overrides every
+ *  default file; includes of includes queue behind. `config-file = ""` clears the
+ *  includes gathered so far, `?path` is an optional include, relative paths are
+ *  relative to the including file, and an empty `macos-option-as-alt =` resets to
+ *  the default. A line with an unrecognised value is rejected by Ghostty and
+ *  ignored here. */
+export declare function resolveGhosttyOptionSetting(paths: readonly string[], home?: string, read?: ReadText): GhosttySetting;
+/** The effective `macos-option-as-alt` across Ghostty's config files (and their
+ *  `config-file` includes). `undefined` when never assigned. */
+export declare function readGhosttyOptionSetting(paths: readonly string[], home?: string): string | undefined;
+/** Would appending `lines` to `target` make `macos-option-as-alt = true` the
+ *  effective setting? Evaluates the files as they are now, with the append
+ *  simulated. When not, `blockedBy` names the overriding file. */
+export declare function appendTakesEffect(paths: readonly string[], target: string, home?: string): {
+    readonly effective: boolean;
+    readonly blockedBy?: string;
+    readonly unreadable: readonly string[];
+};
+export interface TopLevelScan {
+    /** Index of the top-level `{`. */
+    readonly open: number;
+    /** True when the object has no property (the next token is its `}`). */
+    readonly empty: boolean;
+    /** Top-level properties only, last duplicate wins: key → raw value token
+     *  (`true`, `false`, a string literal, or `{`/`[` for a container). */
+    readonly props: ReadonlyMap<string, string>;
+}
+/** Scan JSONC for the properties of the top-level object — comments, strings and
+ *  nesting aware, so a key inside `"[markdown]": {…}` is never seen. `undefined`
+ *  when the first token is not `{`. */
+export declare function scanTopLevelObject(text: string): TopLevelScan | undefined;
+export type VscodePropertyState = 'absent' | 'true' | 'false' | 'other' | 'invalid';
+/** State of the TOP-LEVEL `terminal.integrated.macOptionIsMeta` in a
+ *  settings.json text. `invalid` = no top-level object; `other` = present with a
+ *  non-boolean value. */
+export declare function vscodePropertyState(text: string): VscodePropertyState;
+/** The top-level value of `terminal.integrated.macOptionIsMeta`, or `undefined`
+ *  when it is absent (or not a boolean). */
+export declare function readVscodeOptionSetting(text: string): boolean | undefined;
+/** The whole file for a settings.json that does not exist (or is blank). */
+export declare function freshVscodeSettings(): string;
+/** Insert `"<key>": true` as the first property of the top-level object, leaving
+ *  every other byte (comments, trailing commas, formatting) untouched. A blank
+ *  file becomes a fresh object. Returns `undefined` when the text has no
+ *  recognisable top-level object. */
+export declare function insertVscodeProperty(text: string): string | undefined;
+/** Build the Option-as-Alt plan for this machine. `null` off macOS, where Alt is
+ *  already Alt. */
+export declare function planOptionAsAlt(input: PlanInput): OptionAsAltPlan | null;
+/** The text a write would produce, exactly, for the confirm page. */
+export declare function describeEdit(edit: TerminalConfigEdit): string[];
+export interface ApplyResult {
+    readonly ok: boolean;
+    readonly message: string;
+}
+/** Perform one planned edit against the file as it is NOW (never a stale
+ *  snapshot). Idempotent: an already-configured file is left alone. */
+export declare function applyTerminalEdit(edit: TerminalConfigEdit): ApplyResult;
+export {};

package/dist/commands/sys/terminal-option.js

@@ -0,0 +1,15 @@
+var M=Object.defineProperty;var d=(e,t)=>M(e,"name",{value:t,configurable:!0});import{appendFileSync as R,existsSync as S,mkdirSync as E,readFileSync as L,writeFileSync as P}from"node:fs";import{homedir as b}from"node:os";import{dirname as O,isAbsolute as V,join as y,resolve as W}from"node:path";function D(e){const t=e.TERM_PROGRAM??"",n=e.TERM??"";switch(t){case"Apple_Terminal":return{id:"terminal-app",name:"Terminal.app"};case"iTerm.app":return{id:"iterm2",name:"iTerm2"};case"ghostty":return{id:"ghostty",name:"Ghostty"};case"WezTerm":return{id:"wezterm",name:"WezTerm"};case"vscode":return e.CURSOR_TRACE_ID!==void 0?{id:"cursor",name:"the Cursor terminal"}:{id:"vscode",name:"the VS Code terminal"}}return e.LC_TERMINAL==="iTerm2"?{id:"iterm2",name:"iTerm2"}:e.GHOSTTY_RESOURCES_DIR!==void 0||n==="xterm-ghostty"?{id:"ghostty",name:"Ghostty"}:e.KITTY_WINDOW_ID!==void 0||n==="xterm-kitty"?{id:"kitty",name:"kitty"}:e.WEZTERM_EXECUTABLE!==void 0||e.WEZTERM_PANE!==void 0?{id:"wezterm",name:"WezTerm"}:e.ALACRITTY_SOCKET!==void 0||e.ALACRITTY_LOG!==void 0||n==="alacritty"?{id:"alacritty",name:"Alacritty"}:e.ITERM_SESSION_ID!==void 0?{id:"iterm2",name:"iTerm2"}:{id:"unknown",name:"your terminal"}}d(D,"detectTerminal");const g="macos-option-as-alt",k="terminal.integrated.macOptionIsMeta";function N(e,t){const n=e.XDG_CONFIG_HOME!==void 0&&e.XDG_CONFIG_HOME!==""?e.XDG_CONFIG_HOME:y(t,".config"),r=y(t,"Library","Application Support","com.mitchellh.ghostty");return[y(n,"ghostty","config.ghostty"),y(n,"ghostty","config"),y(r,"config.ghostty"),y(r,"config")]}d(N,"ghosttyConfigPaths");const K=new Set(["true","false","left","right"]);function w(e){try{return L(e,"utf8")}catch{return null}}d(w,"readTextOrNull");function C(e){const t=e.trim();return t.length>=2&&t.startsWith('"')&&t.endsWith('"')?t.slice(1,-1):t}d(C,"unquote");function _(e,t=b(),n=w){let r,s;const a=[];let c=[];const u=new Set,h=d((o,p)=>{const l=n(o);if(l===null){!p&&S(o)&&a.push(o);return}for(const m of l.split(/\r?\n/)){const i=/^\s*([A-Za-z0-9-]+)\s*=\s*(.*?)\s*$/.exec(m);if(i===null)continue;const T=i[1];if(T===g){const f=C(i[2]).toLowerCase();f===""?(r=void 0,s=void 0):K.has(f)&&(r=f,s=o)}else if(T==="config-file"){let f=i[2].trim();if(f===""||f==='""'){c=[];continue}let A=!1;if(f.startsWith("?")&&(A=!0,f=f.slice(1)),f=C(f),f==="")continue;const I=f.startsWith("~/")?y(t,f.slice(2)):V(f)?f:W(O(o),f);c.push(`${A?"?":""}${I}`)}}},"load");for(const o of e)h(o,!0);for(;c.length>0;){const o=c.shift(),p=o.startsWith("?"),l=p?o.slice(1):o;u.has(l)||(u.add(l),h(l,p))}return{value:r,source:s,unreadable:a}}d(_,"resolveGhosttyOptionSetting");function x(e,t){return _(e,t).value}d(x,"readGhosttyOptionSetting");function v(e,t,n=b()){const r=d(a=>{const c=w(a);return a===t?`${c??""}
+${g} = true
+`:c},"simulated"),s=_(e.includes(t)?e:[...e,t],n,r);return s.value==="true"?{effective:!0,unreadable:s.unreadable}:{effective:!1,...s.source!==void 0&&s.source!==t?{blockedBy:s.source}:{},unreadable:s.unreadable}}d(v,"appendTakesEffect");function G(e){const t=new Map;let n=0,r=0,s=-1,a=!1,c=!1,u,h=!1;for(;n<e.length;){const o=e[n],p=e[n+1];if(/\s/.test(o)){n+=1;continue}if(o==="/"&&p==="/"){for(;n<e.length&&e[n]!==`
+`;)n+=1;continue}if(o==="/"&&p==="*"){const i=e.indexOf("*/",n+2);n=i===-1?e.length:i+2;continue}if(s===-1&&o!=="{")return;let l=o,m=n+1;if(o==='"'){let i=n+1;for(;i<e.length&&e[i]!=='"';)i+=e[i]==="\\"?2:1;m=Math.min(i+1,e.length),l=e.slice(n,m)}else if(!"{}[],:".includes(o)){for(;m<e.length&&!/[\s,:{}[\]"/]/.test(e[m]);)m+=1;l=e.slice(n,m)}if(r===1)if(c&&l.startsWith('"')){try{u=JSON.parse(l)}catch{u=l.slice(1,-1)}c=!1}else c&&l==="}"||(u!==void 0&&!h&&l===":"?h=!0:h?(t.set(u,l),h=!1,u=void 0):l===","&&(c=!0,u=void 0));if(o==="{"||o==="["){if(r+=1,s===-1){s=n,c=!0;let i=m;for(;i<e.length;)if(/\s/.test(e[i]))i+=1;else if(e[i]==="/"&&e[i+1]==="/")for(;i<e.length&&e[i]!==`
+`;)i+=1;else if(e[i]==="/"&&e[i+1]==="*"){const T=e.indexOf("*/",i+2);i=T===-1?e.length:T+2}else break;a=i>=e.length||e[i]==="}"}}else if((o==="}"||o==="]")&&(r-=1,r===0))break;n=m}return s===-1?void 0:{open:s,empty:a,props:t}}d(G,"scanTopLevelObject");function $(e){if(e.trim()==="")return"absent";const t=G(e);if(t===void 0)return"invalid";const n=t.props.get(k);return n===void 0?"absent":n==="true"?"true":n==="false"?"false":"other"}d($,"vscodePropertyState");function Z(e){const t=$(e);return t==="true"?!0:t==="false"?!1:void 0}d(Z,"readVscodeOptionSetting");function z(){return`{
+  "${k}": true
+}
+`}d(z,"freshVscodeSettings");function B(e){if(e.trim()==="")return z();const t=G(e);if(t===void 0)return;const n=`"${k}": true`;return`${e.slice(0,t.open+1)}
+  ${n}${t.empty?`
+`:","}${e.slice(t.open+1)}`}d(B,"insertVscodeProperty");function j(e){return y(e,"Library","Application Support","Code","User","settings.json")}d(j,"vscodeSettingsPath");function Y(e){return[e.VSCODE_GIT_ASKPASS_MAIN,e.VSCODE_GIT_ASKPASS_NODE].some(t=>t?.includes("Visual Studio Code")===!0)}d(Y,"isStockVscode");const q="Restart the terminal (or open a new window) afterwards so the setting applies.";function J(e){if(e.platform!=="darwin")return null;const{env:t,home:n}=e,r=D(t);switch(r.id){case"ghostty":{const s=N(t,n),a=_(s,n);if(a.value==="true"||a.value==="left"||a.value==="right")return{terminal:r,status:"configured",summary:a.value==="true"?"Ghostty already sends Alt for both Option keys (macos-option-as-alt = true).":`Ghostty already sends Alt for the ${a.value} Option key only (macos-option-as-alt = ${a.value}) \u2014 Alt shortcuts work from that key.`,instructions:[]};const u=s.filter(l=>S(l)).at(-1)??y(O(s[0]),"config"),h="Ghostty types accented characters for Option, so Alt+C will not open the crouter menu yet.",o="Then reload the config (\u2318\u21E7,) or restart Ghostty.",p=v(s,u,n);if(p.blockedBy!==void 0)return{terminal:r,status:"needs-change",summary:h,instructions:[`${p.blockedBy} sets ${g} = ${a.value??"\u2026"}, and Ghostty loads it after the config files crouter could add to, so crouter will not write a line that would not take effect.`,`Change that line in ${p.blockedBy} to:`,`  ${g} = true`,o]};if(!p.effective||p.unreadable.length>0){const l=p.unreadable[0];return{terminal:r,status:"needs-change",summary:h,instructions:[l===void 0?`crouter could not confirm that a line added to ${u} would take effect.`:`crouter could not read ${l}, so it cannot confirm a line added to ${u} would take effect.`,`Add this line to ${u} (after any config-file lines):`,`  ${g} = true`,o]}}return{terminal:r,status:"needs-change",summary:h,instructions:[`Add this line to ${u}:`,`  ${g} = true`,o],edit:{kind:"append-lines",path:u,lines:["# crouter: let Option act as Alt (Alt+C opens the crouter menu)",`${g} = true`],ghosttyPaths:s,reload:"Reload Ghostty\u2019s config (\u2318\u21E7,) or restart it."}}}case"vscode":case"cursor":{const s=[`In ${r.id==="cursor"?"Cursor":"VS Code"}, open Settings (\u2318,), search "macOptionIsMeta", and tick`,'"Terminal \u203A Integrated: Mac Option Is Meta" \u2014 or in settings.json:',`  "${k}": true`,"Then open a new terminal."];if(r.id==="vscode"&&Y(t)){const a=j(n),c=w(a),u={terminal:r,status:"needs-change",summary:"The VS Code terminal types accented characters for Option, so Alt+C will not open the crouter menu yet.",instructions:s,edit:{kind:"jsonc-insert-property",path:a,lines:[`"${k}": true`],reload:"Open a new terminal in VS Code."}};if(c!==null){const h=$(c);if(h==="true")return{terminal:r,status:"configured",summary:`VS Code already treats Option as Meta (${k} is true).`,instructions:[]};if(h==="absent")return u}else if(!S(a)){if(S(O(O(a))))return u}}return{terminal:r,status:"unverified",summary:`${r.name} types accented characters for Option unless told otherwise.`,instructions:s}}case"terminal-app":return{terminal:r,status:"unverified",summary:"Terminal.app types accented characters for Option unless told otherwise \u2014 crouter cannot check this setting.",instructions:["Terminal \u25B8 Settings (\u2318,) \u25B8 Profiles \u25B8 (your profile) \u25B8 Keyboard,","tick \u201CUse Option as Meta key\u201D. Close the settings window; new keystrokes use it at once."]};case"iterm2":return{terminal:r,status:"unverified",summary:"iTerm2 types accented characters for Option unless told otherwise \u2014 crouter cannot check this setting.",instructions:["iTerm2 \u25B8 Settings (\u2318,) \u25B8 Profiles \u25B8 (your profile) \u25B8 Keys \u25B8 General,","set \u201CLeft Option key\u201D (and \u201CRight Option key\u201D if you use it) to \u201CEsc+\u201D."]};case"wezterm":return{terminal:r,status:"unverified",summary:"WezTerm sends Alt for the LEFT Option key by default; the right one types accents.",instructions:["To make the right Option key work too, in ~/.config/wezterm/wezterm.lua add:","  config.send_composed_key_when_right_alt_is_pressed = false"]};case"kitty":return{terminal:r,status:"unverified",summary:"kitty types accented characters for Option unless told otherwise.",instructions:["In ~/.config/kitty/kitty.conf add:","  macos_option_as_alt yes","Then restart kitty."]};case"alacritty":return{terminal:r,status:"unverified",summary:"Alacritty types accented characters for Option unless told otherwise.",instructions:["In ~/.config/alacritty/alacritty.toml add:","  [window]",'  option_as_alt = "Both"',"Then restart Alacritty."]};case"unknown":return{terminal:r,status:"unverified",summary:"crouter could not tell which terminal this is. Most Mac terminals type accented characters for Option unless told otherwise.",instructions:["Look in your terminal\u2019s settings for \u201COption as Alt\u201D, \u201COption as Meta\u201D or \u201CEsc+\u201D.","Terminal.app: Settings \u25B8 Profiles \u25B8 Keyboard \u25B8 \u201CUse Option as Meta key\u201D.","iTerm2: Settings \u25B8 Profiles \u25B8 Keys \u25B8 Left/Right Option key \u25B8 \u201CEsc+\u201D.",'Ghostty: macos-option-as-alt = true.  kitty: macos_option_as_alt yes.  Alacritty: option_as_alt = "Both".']}}}d(J,"planOptionAsAlt");function Q(e){return[`${e.path}`,...e.lines.map(t=>`  + ${t}`),`  ${e.reload}`]}d(Q,"describeEdit");function ee(e){try{if(e.kind==="append-lines"){const s=w(e.path)??"",a=e.ghosttyPaths??[e.path],c=v(a,e.path);if(_(a).value==="true")return{ok:!0,message:"already set"};if(!c.effective)return{ok:!1,message:c.blockedBy===void 0?`could not confirm a line added to ${e.path} would take effect \u2014 add ${g} = true by hand`:`${c.blockedBy} overrides ${g} \u2014 change it there by hand`};E(O(e.path),{recursive:!0});const u=s===""||s.endsWith(`
+`)?"":`
+`,h=s===""?"":`
+`;return R(e.path,`${u}${h}${e.lines.join(`
+`)}
+`,"utf8"),{ok:!0,message:`appended to ${e.path}`}}const t=w(e.path)??"",n=$(t);if(n==="true")return{ok:!0,message:"already set"};if(n==="false"||n==="other")return{ok:!1,message:`${e.path} sets ${k} to a value other than true \u2014 change it by hand`};const r=B(t);return r===void 0?{ok:!1,message:`${e.path} has no top-level object \u2014 edit it by hand`}:(E(O(e.path),{recursive:!0}),P(e.path,r,"utf8"),{ok:!0,message:`${t===""?"created":"updated"} ${e.path}`})}catch(t){return{ok:!1,message:t instanceof Error?t.message:String(t)}}}d(ee,"applyTerminalEdit");export{v as appendTakesEffect,ee as applyTerminalEdit,Q as describeEdit,D as detectTerminal,z as freshVscodeSettings,N as ghosttyConfigPaths,B as insertVscodeProperty,J as planOptionAsAlt,x as readGhosttyOptionSetting,Z as readVscodeOptionSetting,_ as resolveGhosttyOptionSetting,G as scanTopLevelObject,$ as vscodePropertyState};

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

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

package/dist/commands/sys/tutorial/branch.js

@@ -0,0 +1 @@
+import{defineBranch as e}from"../../../core/command.js";import{basicLeaf as r}from"./tracks.js";import{scenarioBranch as s}from"./scenario.js";const t=e({name:"tutorial",description:"guided crouter lessons and disposable practice scenarios",whenToUse:"you need to learn crouter operation conversationally, one lesson at a time, or create the disposable canvas state a lesson asks you to inspect.",extensible:!0,help:{name:"sys tutorial",summary:"guided crouter lessons and disposable practice scenarios",model:"Tracks serve one lesson per invocation and never record progress, so --step can start or resume anywhere. Scenarios create only the temporary canvas state a lesson needs and clean exactly the recorded rows afterward."},children:[r,s]});export{t as tutorialBranch};

package/dist/commands/sys/tutorial/lessons.d.ts

@@ -0,0 +1,5 @@
+export interface TutorialLesson {
+    readonly title: string;
+    readonly body: string;
+}
+export declare const BASIC_LESSONS: readonly TutorialLesson[];

package/dist/commands/sys/tutorial/lessons.js

@@ -0,0 +1,8 @@
+const e=[{title:"Return to a conversation \u2014 recap, find, pin",body:["Start with a conversation the user actually wants to return to. `Alt+C` opens the crouter action menu; its entries show the keys, so do not ask the user to memorize a shortcut list.","","Ask them to press `Alt+C`. Teach `/menu` alongside it: typing `/menu` in the conversation opens the same action menu without any Alt key, so it is the route to use whenever Option does not work yet (the viewer\u2019s status line shows `Alt+C menu (or /menu)` as a standing reminder). If Option types an accented character instead of opening the menu, identify their terminal and help set Option to send Alt/Esc; show any proposed config edit and get permission before writing it. If they cannot use tmux panes yet, inspect their existing tmux prefix and bindings and teach only the pane actions they need. These are conditional setup steps, not separate lessons.","","While Option is in view, teach multiline messages: Enter sends, and `Alt+Enter` (Option+Enter on a Mac) or `Shift+Enter` inserts a new line instead. Have them type a two-line message to confirm it. If Option+Enter sends the message, it is the same Option-as-Alt setting; some terminals do not report Shift+Enter distinctly, so Alt+Enter is the one to rely on.","","Have them choose `s` from the menu to refresh this conversation\u2019s Goal/State recap and generated title. Point out the Goal above the transcript and the State above the editor. This generates content using an agent; do not describe it as a free visual toggle. Then open Find node with `Alt+C`, `/`, search for the refreshed title, and select the conversation. The navigator searches conversations across the canvas; the graph in a later lesson is only for nodes connected to the current conversation.","","In Find node, have them select this conversation and press `p` to pin it; the star and sorting change. If it was already pinned, do not unpin it merely for practice. A pin persists, so ask before changing it and restore the original state if this is only a demonstration.","","Explain the important distinction: closing the viewer or terminal detaches from the conversation; it does not close the node. They can find it again. `Alt+C`, `x` deliberately closes the node and its subtree, so do not use it for detaching. Let them try recap, find, and pin before proceeding.","","Close by telling them two things plainly: crouter can debug itself, so whenever something looks broken or stuck they should feel free to ask you to diagnose it; and they can ask you to explain any crouter term (node, canvas, resident, inbox, and so on) the moment it comes up, rather than guessing."].join(`
+`)},{title:"Answer an agent \u2014 the inbox",body:["When an agent needs a decision, it can put a question in the human inbox and wait without polling. The answer to an agent\u2019s own question wakes that agent. Teach the habit: if work seems paused, check the inbox with `Alt+I`.","","Ask before creating the disposable tutorial question. Once they agree, run:","","```bash",'crtr sys tutorial scenario start pending-ask --parent "$CRTR_NODE_ID"',"```","","Have them open **A question from the tutorial** with `Alt+I`, select an option with the arrow keys (or `j`/`k`), toggle it with Space, optionally add a comment with `c`, and submit. This question links back to the tutorial conversation but **no agent waits on its answer**; it practices the same inbox controls as a real request. Clean up afterward, even if they decide not to submit:","","```bash","crtr sys tutorial scenario clean pending-ask","```"].join(`
+`)},{title:"Review a document with an agent",body:["Frame this lesson around one idea: a document review is the best way to read and shape anything an agent writes, such as a plan, a spec or a draft. It works like a shared Google Doc that the user and the agent edit together. The document opens in its own window. The user highlights a passage and leaves a comment on it, and an agent in the pane beside the document answers that comment. The agent can also revise the document itself, and the user watches the text change in place. That beats copying passages into chat, because every comment stays attached to the exact lines it is about.","","Ask before creating the practice review. Once they agree, run:","","```bash",'crtr sys tutorial scenario start review-doc --parent "$CRTR_NODE_ID"',"```","","This writes a short practice document, an offsite plan with a vague goal, an agenda step nobody owns and an open question, and queues a review of it. Have them open it from the inbox with `Alt+I`. It opens in a new tmux window, the inbox closes, and the agent pane appears beside the document. Walk them through it one step at a time:","","1. Move between blocks with the arrow keys (or `j`/`k`). `J`/`K` widens the highlight to cover several blocks.","2. Press `c` (or Enter) on something they would change, type a comment, and press Enter to save it. Suggest the vague Goal section. The agent in the side pane picks the comment up and replies or edits the document.","3. Point out the key bar at the bottom: every key it shows is labeled with what it does, and `?` opens the full list. They do not need to memorize anything.","4. `C` lists every comment so they can edit or delete one. `s` twice approves and submits the review, and `Esc` leaves it open in the inbox to come back to.","","When they submit, the approval comes back to this conversation. Use that moment to say what happens with a real review: the agent sees every comment and every edit, and it carries on from the approved document. Tell them they can ask any agent to \u201Copen that for review\u201D whenever it has written something worth reading closely.","","Clean up afterward, whether or not they submitted:","","```bash","crtr sys tutorial scenario clean review-doc","```"].join(`
+`)},{title:"Make it yours \u2014 settings and plugins",body:["Open `Alt+C`, `,` to inspect settings and keybindings. Let the user find one binding they care about. In the keybinding editor, `/` filters, Enter edits, and Escape discards an unsaved edit. Do not save a binding change unless they ask for that exact change; saved bindings affect their future sessions.","","Then use `Alt+C`, `l` to browse plugins. Have them inspect one plugin\u2019s capabilities and decide whether it is relevant to their work. Browsing does not install it. Installing or enabling a plugin changes local configuration, so do that only if they choose a specific plugin and approve the change.","","These are discovery tools, not a feature tour: the user should leave knowing how to find a setting or capability when they need it, not with a new configuration they did not request."].join(`
+`)},{title:"Take another direction \u2014 fork",body:["Forking lets the user pursue another direction without replacing the original conversation. `Alt+C`, `f` forks the focused node into a separate, idle root. It does not start a model turn; the fork is a new conversation that remains on the canvas until closed.","","Ask whether they have a disposable conversation to fork and want to try it. Do not fork the current long-lived conversation just to make a demonstration. If they agree, focus that conversation, use `Alt+C`, `f`, then find both the original and the new root with `Alt+C`, `/`. Confirm which is which before offering to close the disposable fork; closing it is a separate, destructive action that needs permission.","","If there is no suitable conversation or they decline to create durable state, explain the action and move on. Mention `/fork` only if they specifically need to choose a point within the conversation; the menu action is enough for this lesson."].join(`
+`)},{title:"Keep a useful fact \u2014 a document",body:["The practical instruction is \u201Cremember that.\u201D The user does not need to choose a storage format: the agent can propose whether the fact is knowledge about how to do something or a preference about how it should behave, and where that document should apply.","","Ask whether there is a genuine, durable fact from their work that they want the agent to remember. State the proposed wording and scope, and get their approval before writing. Do not manufacture a personal preference or save a fact just to complete the exercise. If none exists, let them try the phrase as a future request and move on.","","A project fact should not silently become a global preference. The useful outcome is that the user knows they can say \u201Cremember that\u201D and correct the proposed wording or scope."].join(`
+`)},{title:"Follow delegated work \u2014 the graph",body:["Use a real task with independent parts if one is already underway. Delegation is useful when pieces can run separately or a task has several large phases; do not promote a node or spawn children solely to fill a graph. A small task stays with one agent.","","Press `Alt+g` to open the graph of this conversation and its connected nodes. With real children present, \u2192 (or `l`) expands a parent or moves to its first child, \u2191\u2193 (or `j`/`k`) select rows, \u2190 (or `h`) moves toward the parent, Enter focuses a child, and Esc closes the graph. Do not use `x`: it asks to close a subtree. If no real children are present, describe these controls briefly and let the user revisit the graph when an agent delegates actual work.","","A manager may look idle while its children run. That is expected: it ends its turn and waits for a child\u2019s report, which wakes it to integrate the result. A running broker is not proof that a model turn is streaming; a fault is different from ordinary waiting and needs attention. Explain status only in response to what the user actually sees, not as a glyph glossary.","","The visible result should be a user who can open a working child and return to its manager without wondering why the manager stopped speaking. End the tutorial here; promotion, node modes, and lifecycle commands are details to explain only when a real task requires them."].join(`
+`)}];export{e as BASIC_LESSONS};

package/dist/commands/sys/tutorial/scenario.d.ts

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

package/dist/commands/sys/tutorial/scenario.js

@@ -0,0 +1,3 @@
+var S=Object.defineProperty;var i=(r,t)=>S(r,"name",{value:t,configurable:!0});import{randomUUID as O}from"node:crypto";import{mkdirSync as q,readFileSync as T}from"node:fs";import{dirname as k,join as E}from"node:path";import{ApiError as g}from"../../../api/index.js";import{withMetaLock as x,writeMetaObjectLocked as I}from"../../../core/canvas/meta-file.js";import{defineBranch as C,defineLeaf as y}from"../../../core/command.js";import{InputError as h}from"../../../core/io.js";import{userScopeRoot as P}from"../../../core/scope.js";import{envNodeId as $}from"../../../shared/env.js";import{cliClient as d,getNodeOrNull as j,rethrowAsCliError as u}from"../../api-client.js";const m={"idle-nodes":{title:"Three practice children of a tutorial conversation",teaches:"the graph lesson \u2014 navigate a parent and its children",builds:"three child nodes without tasks under the specified parent; their brokers run until cleanup"},"pending-ask":{title:"A question waiting in the inbox",teaches:"the inbox lesson \u2014 reading a pending item and answering it",builds:"one durable pending request in the human inbox"},"review-doc":{title:"A short practice document waiting for review",teaches:"the review lesson \u2014 commenting on a document alongside an agent",builds:"one practice document owned by the calling node and one document review of it in the human inbox, with its companion agent"}},v=["nodes","requests","documents","reviews"],L=["# Team offsite plan","","A one-day offsite to plan next quarter.","","## Goal","","Leave with a clear plan for the quarter.","","## Agenda","","1. Review last quarter \u2014 what shipped and what slipped.","2. Pick the three projects that matter most.","3. Assign an owner to each project.","","## Logistics","","Somewhere near the office, sometime next month. Lunch is provided.","","## Open questions","","- Should remote teammates join by video, or travel in?",""].join(`
+`),D=["export default function TutorialAsk() {","  return (",'    <Page title="A question from the tutorial" subtitle="Practice choosing and commenting on an option.">',"      <UserQuestion",'        id="answer"','        label="Which crouter topics would you like to explore?"','        body="Select one or more topics with Space and add a comment to an option with c. This is practice; no agent acts on your answer."','        mode="multi"',"        options={[","          { id: 'orchestration', label: 'Delegating work to other agents' },","          { id: 'memory', label: 'Teaching it my preferences' },","          { id: 'navigation', label: 'Finding conversations and navigating the canvas' },","        ]}","      />","    </Page>","  );","}"].join(`
+`);function f(){return E(P(),"tutorial-scenarios.json")}i(f,"ledgerPath");function U(r){return Array.isArray(r)&&r.every(t=>typeof t=="string")}i(U,"isStringArray");function R(){let r;try{r=JSON.parse(T(f(),"utf8"))}catch(e){if(e.code==="ENOENT")return{};throw e}if(typeof r!="object"||r===null||Array.isArray(r))throw new h({error:"invalid_scenario_ledger",message:`tutorial scenario ledger at ${f()} must be an object`,next:"Remove or repair the ledger file, then retry the scenario command."});const t={};for(const e of Object.keys(m)){const n=r[e];if(n===void 0)continue;if(typeof n!="object"||n===null||typeof n.started!="string")throw new h({error:"invalid_scenario_ledger",message:`tutorial scenario ledger has an invalid ${e} record`,next:"Remove or repair the ledger file, then retry the scenario command."});const o=n;if(v.some(l=>o[l]!==void 0&&!U(o[l])))throw new h({error:"invalid_scenario_ledger",message:`tutorial scenario ledger has invalid ids for ${e}`,next:"Remove or repair the ledger file, then retry the scenario command."});const s={started:o.started};for(const l of v)o[l]!==void 0&&(s[l]=o[l]);t[e]=s}return t}i(R,"readLedger");function N(r){const t=f();return q(k(t),{recursive:!0}),x(t,()=>r(R()))}i(N,"withLedger");function b(r){const t=f();return q(k(t),{recursive:!0}),x(t,()=>{const e=R(),n=r(e);return I(t,e),n})}i(b,"updateLedger");function B(r){return b(t=>{if(t[r]!==void 0)throw new h({error:"scenario_already_standing",message:`the '${r}' scenario is already standing (started ${t[r].started})`,field:"scenario",next:`Run \`crtr sys tutorial scenario clean ${r}\` first, then start it again.`});const e={started:new Date().toISOString(),...r==="idle-nodes"?{nodes:[]}:r==="pending-ask"?{requests:[]}:{documents:[],reviews:[]}};return t[r]=e,e})}i(B,"reserveScenario");async function w(r,t,e){if(!b(o=>{const s=o[r];return s===void 0?!1:(s[t]=[...s[t]??[],e],!0)})){try{t==="nodes"?await d().closeNode(e):t==="requests"?await d().cancelHumanRequest(e,{reason:"Tutorial scenario start interrupted."}):t==="reviews"?await d().cancelReview(e,{reason:"Tutorial scenario start interrupted."}):await d().docs.delete(e)}catch(o){p(o)||u(o)}throw new Error(`tutorial scenario '${r}' disappeared while it was starting`)}}i(w,"appendScenarioId");function p(r){return r instanceof g&&(r.status===404||r.code==="already_settled")}i(p,"isAlreadyCleaned");function K(r){return r==="done"||r==="dead"||r==="canceled"}i(K,"isTerminalNode");function A(r){const t=r.scenario;if(typeof t=="string"&&Object.hasOwn(m,t))return t;throw new h({error:"unknown_scenario",message:`no tutorial scenario named '${String(t)}'`,field:"scenario",next:`Use one of: ${Object.keys(m).join(", ")}. Run \`crtr sys tutorial scenario list\` for what each one builds.`})}i(A,"scenario");async function M(r,t){const e=["tutorial-demo-one","tutorial-demo-two","tutorial-demo-three"];for(const n of e){const o=await d().createNode({parent:t,creator:t,root_lifecycle:"resident",no_kickoff:!0,prompt:"",cwd:process.cwd(),name:n}).catch(u);await w("idle-nodes","nodes",o.node_id),r.nodes.push(o.node_id)}}i(M,"startIdleNodes");async function F(r,t){const e=await d().createHumanRequest({page:{dialect:"jsx",source:D},delivery:{placement:"inline",inbox:!0,reply:!1},source:{askedBy:"crtr sys tutorial",sessionName:"tutorial",nodeId:t},creator_cwd:process.cwd()}).catch(u);await w("pending-ask","requests",e.request_id),r.requests.push(e.request_id)}i(F,"startPendingAsk");async function H(r,t){const e=await d().docs.write({name:`tutorial-review-practice-${Date.now().toString(36)}`,body:L,preview:"A short practice plan for the crouter tutorial\u2019s document-review lesson; safe to delete.",unlisted:!0,cwd:process.cwd()}).catch(u);await w("review-doc","documents",e.name),r.documents.push(e.name);const n=await d().createReview({origin_kind:"ticket",origin_node_id:t,document:e.name,idempotency_key:O(),subtitle:"Practice reviewing a document with an agent: comment on anything, then approve."}).catch(u);await w("review-doc","reviews",n.review_id),r.reviews.push(n.review_id)}i(H,"startReviewDoc");const G=y({name:"list",description:"list the tutorial practice scenarios",whenToUse:"you need to choose a disposable canvas scenario for a lesson or see whether one is already standing.",help:{name:"sys tutorial scenario list",summary:"list the tutorial practice scenarios and their standing state",inputNote:"No input parameters.",output:[{name:"scenarios",type:"object[]",required:!0,constraint:"One row per scenario: {id, title, teaches, builds, standing}."},{name:"standing",type:"number",required:!0,constraint:"Number of scenarios currently recorded as standing."}],outputKind:"object",effects:["None. Read-only."]},run:i(async()=>{const r=N(e=>e),t=Object.entries(m).map(([e,n])=>({id:e,title:n.title,teaches:n.teaches,builds:n.builds,standing:r[e]!==void 0}));return{scenarios:t,standing:t.filter(e=>e.standing).length}},"run")}),W=y({name:"start",description:"create a tutorial practice scenario",whenToUse:"a tutorial lesson needs its disposable graph rows or inbox request before the user can practice against a real canvas surface.",help:{name:"sys tutorial scenario start",summary:"create one tutorial practice scenario",params:[{kind:"positional",name:"scenario",type:"string",required:!0,constraint:"idle-nodes (three children without tasks), pending-ask (one durable inbox request) or review-doc (a practice document and a review of it)."},{kind:"flag",name:"parent",type:"string",required:!0,constraint:"Node id of the tutorial conversation; children, the inbox request and the review are linked to this node. For review-doc it must be the calling node."}],output:[{name:"nodes",type:"string[]",required:!1,constraint:"Created child node ids for idle-nodes."},{name:"requests",type:"string[]",required:!1,constraint:"Created human request ids for pending-ask."},{name:"documents",type:"string[]",required:!1,constraint:"Created practice document names for review-doc."},{name:"reviews",type:"string[]",required:!1,constraint:"Created review ids for review-doc."},{name:"clean_with",type:"string",required:!0,constraint:"Exact command that removes this scenario."},{name:"look_at",type:"string",required:!0,constraint:"Viewer surface that shows the created state."}],outputKind:"object",effects:["idle-nodes creates three resident children of --parent with no kickoff turn; their brokers run until cleanup. Their ids are recorded in ~/.crouter/tutorial-scenarios.json.","pending-ask publishes one durable human request with --parent as its source; answering it does not wake that node. Its id is recorded in ~/.crouter/tutorial-scenarios.json.","review-doc writes one unlisted practice document owned by the calling node and queues a document review of it with --parent as origin: a companion agent forked from --parent joins the review, and submitting it pushes the approval to --parent. Both ids are recorded in ~/.crouter/tutorial-scenarios.json.","Refuses a scenario already recorded as standing; clean it before starting it again."]},run:i(async r=>{const t=A(r),e=r.parent;if(e===void 0||e.trim()==="")throw new h({error:"parent_required",message:`${t} needs the tutorial conversation node id in --parent`,field:"parent",next:"Pass the node id of the conversation the user is viewing."});if(await j(e)===null)throw new h({error:"unknown_parent",message:`no local node exists for --parent ${e}`,field:"parent",next:"Pass the node id of a conversation on this canvas."});if(t==="review-doc"&&$()!==e)throw new h({error:"parent_not_caller",message:"review-doc writes the practice document as the calling node, so --parent must be that node",field:"parent",next:'Run it from the tutorial conversation with --parent "$CRTR_NODE_ID".'});const n=B(t);t==="idle-nodes"?await M(n,e):t==="pending-ask"?await F(n,e):await H(n,e);const o={};for(const s of v)n[s]!==void 0&&(o[s]=n[s]);return{...o,clean_with:`crtr sys tutorial scenario clean ${t}`,look_at:t==="idle-nodes"?"Open the graph with `Alt+g`.":t==="pending-ask"?"Open the inbox with `Alt+I`.":"Open the inbox with `Alt+I` and select the review; it opens in its own window."}},"run")}),J=y({name:"clean",description:"remove a tutorial practice scenario",whenToUse:"the lesson has finished with a scenario and you need to remove exactly the nodes or request it recorded.",help:{name:"sys tutorial scenario clean",summary:"remove exactly the rows recorded for one tutorial practice scenario",params:[{kind:"positional",name:"scenario",type:"string",required:!0,constraint:"Scenario to remove: idle-nodes, pending-ask or review-doc."}],output:[{name:"was_standing",type:"boolean",required:!0,constraint:"Whether this scenario had a ledger record to remove."},{name:"closed_nodes",type:"number",required:!1,constraint:"Number of ledger-recorded node ids closed. Present when the scenario was standing."},{name:"canceled_requests",type:"number",required:!1,constraint:"Number of ledger-recorded request ids canceled. Present when the scenario was standing."},{name:"already_settled_requests",type:"number",required:!1,constraint:"Number of ledger-recorded request or review ids already terminal when clean processed them. Present when the scenario was standing."},{name:"deleted_documents",type:"number",required:!1,constraint:"Number of ledger-recorded practice documents deleted. Present when the scenario was standing."}],outputKind:"object",effects:["Closes, cancels or deletes only ids recorded for this scenario in ~/.crouter/tutorial-scenarios.json, then removes that scenario record. A review is canceled before its practice document is deleted."]},run:i(async r=>{const t=A(r),e=N(c=>c[t]);if(e===void 0)return{was_standing:!1};let n=0,o=0,s=0;for(const c of e.nodes??[]){const a=await j(c);if(!(a===null||K(a.status)))try{await d().closeNode(c),n++}catch(_){p(_)||u(_)}}for(const c of e.requests??[])try{await d().cancelHumanRequest(c,{reason:"Tutorial scenario cleaned up."}),o++}catch(a){a instanceof g&&a.code==="already_settled"?s++:p(a)||u(a)}for(const c of e.reviews??[])try{(await d().cancelReview(c,{reason:"Tutorial scenario cleaned up."})).outcome==="already_settled"?s++:o++}catch(a){a instanceof g&&(a.code==="already_settled"||a.code==="review_terminal_conflict")?s++:p(a)||u(a)}let l=0;for(const c of e.documents??[])try{await d().docs.delete(c),l++}catch(a){p(a)||u(a)}return b(c=>{delete c[t]}),{was_standing:!0,closed_nodes:n,canceled_requests:o,...e.documents===void 0?{}:{deleted_documents:l},...s===0?{}:{already_settled_requests:s}}},"run")}),ae=C({name:"scenario",description:"create and remove disposable tutorial practice state",whenToUse:"a tutorial lesson needs real but disposable canvas rows or an inbox request to inspect and practice against.",help:{name:"sys tutorial scenario",summary:"create and remove disposable canvas state for tutorial lessons",model:"Each scenario records only the ids it creates. Start refuses an already-standing scenario, and clean acts only on that recorded list."},children:[G,W,J]});export{ae as scenarioBranch};

package/dist/commands/sys/tutorial/tracks.d.ts

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

package/dist/commands/sys/tutorial/tracks.js

@@ -0,0 +1,4 @@
+var h=Object.defineProperty;var i=(e,n)=>h(e,"name",{value:n,configurable:!0});import{defineLeaf as m}from"../../../core/command.js";import{InputError as y}from"../../../core/io.js";import{BASIC_LESSONS as p}from"./lessons.js";const g=["Teach this conversationally, in your own words \u2014 do not paste this lesson at the user.","Ask before you change anything on their machine, and show the exact diff you propose.","Let the user actually try each thing and confirm it worked before you move on."].join(" "),f={basic:p};function b(e){return e.map((n,t)=>`${t+1}. ${n.title}`).join(`
+`)}i(b,"tableOfContents");async function w(){const{resolveRoot:e}=await import("../../../build-root.js"),t=(await e("sys")).subtrees.find(s=>s.name==="sys");if(t?.kind!=="branch")throw new Error("The assembled sys subtree is missing.");const r=t.children.find(s=>s.name==="tutorial");if(r?.kind!=="branch")throw new Error("The assembled sys tutorial branch is missing.");if(r.help.listing===void 0)throw new Error("The assembled sys tutorial listing is missing.");return r.help.listing}i(w,"tutorialListing");function $(e){return e.length===0?"That is the whole tutorial.":`What's next: ${e.map(({command:n,description:t})=>`${n} \u2014 ${t}`).join("; ")}`}i($,"nextTracksLine");async function T(e,n){const t=f[e],r=t.length,s=n.step,o=s==null?1:Number(s);if(!Number.isInteger(o)||o<1||o>r)throw new y({error:"step_out_of_range",message:`--step must be between 1 and ${r} (got ${String(s)})`,field:"step",next:`Run \`crtr sys tutorial ${e} -h\` and read the contents, then pick a lesson in range.`});const c=t[o-1],l=o<r?`crtr sys tutorial ${e} --step ${o+1}`:void 0,d=l===void 0?await w():void 0;let a;return d!==void 0&&(a=d.filter(u=>u.plugin!==void 0).map(u=>({command:`crtr sys tutorial ${u.name}`,description:u.description}))),{track:e,step:o,total:r,title:c.title,body:a===void 0?c.body:`${c.body}
+
+${$(a)}`,...l===void 0?{}:{next:l},teaching_contract:g,...o===1?{contents:b(t)}:{},...a===void 0?{}:{next_tracks:a}}}i(T,"runTrack");function k(e,n,t){return m({name:e,description:n,whenToUse:t,help:{name:`sys tutorial ${e}`,summary:`serve one lesson from the ${e} crouter tutorial track`,params:[{kind:"flag",name:"step",type:"int",required:!1,default:1,constraint:`Lesson number, from 1 through ${f[e].length}. Default: 1.`}],output:[{name:"track",type:"string",required:!0,constraint:`The served track: ${e}.`},{name:"step",type:"number",required:!0,constraint:"The served lesson number."},{name:"total",type:"number",required:!0,constraint:"Number of lessons in this track."},{name:"title",type:"string",required:!0,constraint:"Lesson title."},{name:"body",type:"string",required:!0,constraint:"Lesson instructions for the teaching agent."},{name:"next",type:"string",required:!1,constraint:"The exact command for the next lesson. Absent on the last lesson."},{name:"teaching_contract",type:"string",required:!0,constraint:"Rules for teaching the lesson conversationally and safely."},{name:"contents",type:"string",required:!1,constraint:"Numbered titles for every lesson in this track. Present only for step 1."},{name:"next_tracks",type:"array",required:!1,constraint:"Available core and plugin tutorial tracks, each with command and description. Present only on the last lesson."}],outputKind:"object",effects:["None. Read-only. Progress is not stored."]},run:i(async r=>T(e,r),"run")})}i(k,"trackLeaf");const N=k("basic","serve one task-first crouter lesson","you want to learn everyday crouter actions, from returning to a conversation through following delegated work.");export{N as basicLeaf};

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

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

package/dist/commands/sys/update.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var c=(o,s)=>u(o,"name",{value:s,configurable:!0});import{defineLeaf as l}from"../../core/command.js";import{updateState as d}from"../../core/config.js";import{projectScopeRoot as p}from"../../core/scope.js";import{selfCheck as f,selfUpdate as m,contentCheck as h}from"../../core/self-update.js";import{marketUpdate as g}from"../pkg/market-manage.js";import{pluginUpdate as y}from"../pkg/plugin-manage.js";import{nowIso as k}from"../../core/fs-utils.js";import{processLocatedGeneration as b,readPackageVersion as _,runtimeManifest as v,selectedGeneration as w}from"./shared.js";const x=l({name:"update",description:"update binary and content",whenToUse:"upgrading crtr or its installed plugins and marketplaces \u2014 pull the latest binary, refresh installed content, or both, or just check what is out of date without applying anything.",help:{name:"sys update",summary:"update the crtr binary and/or installed plugins and marketplaces",params:[{kind:"flag",name:"target",type:"enum",choices:["self","content","all"],required:!1,constraint:"What to update. Default: all."},{kind:"flag",name:"check",type:"bool",required:!1,constraint:"Check for updates without applying them (bounded, blocking)."}],output:[{name:"target",type:"string",required:!1,constraint:"Present when applying updates: self | content | all."},{name:"status",type:"string",required:!1,constraint:"done | failed when applying updates."},{name:"error",type:"string",required:!1,constraint:"Failure message when status is failed."},{name:"updates",type:"object[]",required:!1,constraint:"Present when --check. Each: {name, current, latest, up_to_date, unreachable, kind}."},{name:"up_to_date",type:"boolean",required:!1,constraint:"Present when --check. True when all items are up to date."}],outputKind:"object",effects:["--check \u2014 read-only, bounded network calls.","Default (no --check) \u2014 launches a background job; returns job handle immediately.","Content update replaces each marketplace and source-installed plugin checkout with a freshly staged revision, discarding local modifications in those directories."]},run:c(async o=>{const s=o.target,i=o.check,n=s!==void 0?s:"all";if(i){const t=[];if(n==="self"||n==="all"){const e=f();e!==null?t.push({name:e.package,kind:"self",current:e.current,latest:e.latest,up_to_date:!e.migrating&&e.current===e.latest,unreachable:!1}):t.push({name:"@north-light/cli",kind:"self",current:null,latest:null,up_to_date:!0,unreachable:!0})}if(n==="content"||n==="all"){const e=h();for(const r of e)t.push({name:r.name,kind:r.kind,current:r.current,latest:r.latest,up_to_date:r.up_to_date,unreachable:r.unreachable})}const a=t.every(e=>e.up_to_date||e.unreachable);return{updates:t,up_to_date:a}}try{if(n==="self"||n==="all"){m();const t=["user"];p()&&t.unshift("project");for(const a of t)d(a,e=>{e.last_self_check=k()})}return(n==="content"||n==="all")&&(await g.run({}),await y.run({})),{target:n,status:"done"}}catch(t){const a=t instanceof Error?t.message:String(t);return{target:n,status:"failed",error:a}}},"run")}),G=l({name:"version",description:"print installed version",whenToUse:"you need the installed crtr version \u2014 to report it in a bug or confirm an upgrade landed.",help:{name:"sys version",summary:"report selected and process runtime generations",params:[],output:[{name:"version",type:"string",required:!0,constraint:"Version from this process generation manifest; package.json version in a development checkout."},{name:"selected_generation",type:"object",required:!0,constraint:"Selected runtime generation: {id, version, status}; id/version are null when no selection exists."},{name:"process_generation",type:"object",required:!0,constraint:"Generation containing this loaded module: {id, version, status}; id/version are null in a development checkout."},{name:"drift",type:"boolean",required:!0,constraint:"True when selected and process generation ids differ."}],outputKind:"object",effects:["None. Read-only."]},run:c(async o=>{const s=c(t=>{if(t.generation===null)return{id:null,version:null,status:t.error??"no runtime generation"};const{id:a,manifest:e}=t.generation,r=v.validateManifestShape(e,{id:a,entryName:"cli"});return{id:a,version:typeof e.packageVersion=="string"?e.packageVersion:null,status:r.ok?"valid":r.error}},"describe"),i=s(w()),n=s(b());return{version:n.version??_(),selected_generation:i,process_generation:n,drift:i.id!==null&&n.id!==null&&i.id!==n.id}},"run")});export{x as sysUpdateLeaf,G as sysVersionLeaf};

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

@@ -0,0 +1,2 @@
+export declare function formatSize(bytes: number | null): string;
+export declare const sysWorktreesLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/sys/worktrees.js

@@ -0,0 +1,5 @@
+var i=Object.defineProperty;var r=(t,n)=>i(t,"name",{value:n,configurable:!0});import{defineLeaf as o}from"../../core/command.js";import{cliClient as s,rethrowAsCliError as d}from"../api-client.js";function u(t){if(t===null||!Number.isFinite(t)||t<0)return"unmeasurable";const n=["B","KiB","MiB","GiB","TiB"];let e=t,a=0;for(;e>=1024&&a<n.length-1;)e/=1024,a++;return`${e>=10||a===0?e.toFixed(0):e.toFixed(1)} ${n[a]}`}r(u,"formatSize");const p=o({name:"worktrees",description:"list managed worktrees quarantined by daemon cleanup",whenToUse:"daemon cleanup has stopped retrying managed worktrees it could not reconcile and you need the recorded refusal, remaining checkout, and disk cost for human intervention",help:{name:"sys worktrees",summary:"list managed worktrees the daemon cleanup sweep quarantined",params:[],output:[{name:"worktrees",type:"QuarantinedWorktreeDTO[]",required:!0,constraint:"Oldest refusal first. Each record: {node_id, path, branch, repo_root, reason, detail?, attempts, last_attempt, size_bytes}; size_bytes is null when the checkout path is gone or cannot be measured."}],outputKind:"object",effects:["None. Read-only."]},run:r(async()=>{try{return{worktrees:await s().listQuarantinedWorktrees()}}catch(t){d(t)}},"run"),render:r(t=>{const n=t.worktrees;return n.length===0?"0 quarantined managed worktrees.":`${n.length} quarantined managed worktree${n.length===1?"":"s"}:
+
+${n.map(e=>{const a=[`- \`${e.node_id}\` \u2014 ${e.reason} \xB7 ${u(e.size_bytes)} \xB7 ${e.attempts} attempt${e.attempts===1?"":"s"} \xB7 ${e.last_attempt}`,`  - path: \`${e.path}\``,`  - branch: \`${e.branch}\``,`  - repo root: \`${e.repo_root}\``];return e.detail!==void 0&&a.push(`  - detail: ${e.detail}`),a.join(`
+`)}).join(`
+`)}`},"render")});export{u as formatSize,p as sysWorktreesLeaf};

package/dist/commands/sys.d.ts

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

package/dist/commands/sys.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var r=(o,m)=>s(o,"name",{value:m,configurable:!0});import{defineSysBranch as t}from"./sys/branch.js";import{configBranch as f}from"./sys/config.js";import{sysEnvBranch as e}from"./sys/env.js";import{daemonBranch as i}from"./sys/daemon.js";import{sysDoctorLeaf as a}from"./sys/doctor.js";import{sysFeedbackLeaf as p}from"./sys/feedback.js";import{sysLogsLeaf as n}from"./sys/logs.js";import{sysRetryDeliveryLeaf as y}from"./sys/retry-delivery.js";import{sysWorktreesLeaf as c}from"./sys/worktrees.js";import{sysSpacesLeaf as L}from"./sys/spaces.js";import{sysLimitsBranch as h}from"./sys/limits.js";import{sysSettingsLeaf as B}from"./sys/settings.js";import{sysConnectLeaf as S}from"./sys/connect.js";import{sysSetupLeaf as g}from"./sys/setup.js";import{tutorialBranch as u}from"./sys/tutorial/branch.js";import{supportBranch as d}from"./sys/support.js";import{contextBranch as k}from"./sys/context.js";import{sysSyncBranch as l}from"./sys/sync.js";import{sysMigrateLeaf as v}from"./sys/migrate.js";import{sysJoinLeaf as x}from"./sys/join.js";import{sysUpdateLeaf as D,sysVersionLeaf as b}from"./sys/update.js";function T(){return t([B,f,e,S,g,u,a,k,p,n,c,y,L,h,d,D,b,v,x,l,i])}r(T,"registerSys");export{T as registerSys};

package/dist/core/activity-signal.d.ts

@@ -0,0 +1,7 @@
+/** One durable-mutation signal file under `crtrHome()/signals/<name>`, shared by
+ *  every subsystem that needs to tell every open viewer "something changed"
+ *  without watching each individual record's directory. */
+export declare function activityPath(name: string): string;
+/** Signal one durable mutation to every open watcher of `name`. */
+export declare function signalActivity(name: string): void;
+export declare function watchActivity(name: string, onChange: () => void): () => void;

package/dist/core/activity-signal.js

@@ -0,0 +1,2 @@
+var m=Object.defineProperty;var o=(t,r)=>m(t,"name",{value:r,configurable:!0});import{basename as u,dirname as n,join as f}from"node:path";import{mkdirSync as c,watch as h,writeFileSync as p}from"node:fs";import{crtrHome as y}from"./canvas/paths.js";function a(t){return f(y(),"signals",t)}o(a,"activityPath");function S(t){const r=a(t);try{c(n(r),{recursive:!0,mode:448}),p(r,`${Date.now()}
+`,{mode:384})}catch{}}o(S,"signalActivity");function x(t,r){const i=a(t);try{c(n(i),{recursive:!0,mode:448});const e=h(n(i),(l,s)=>{String(s)===u(i)&&r()});return()=>e.close()}catch(e){return console.error(`activity-signal: failed to watch "${t}": ${e instanceof Error?e.message:String(e)}`),()=>{}}}o(x,"watchActivity");export{a as activityPath,S as signalActivity,x as watchActivity};

package/dist/core/asset-root.d.ts

@@ -0,0 +1,7 @@
+/** The source or runtime directory containing every shipped asset tree.
+ *
+ * `import.meta.url` names the module when loaded directly, but names the
+ * attach viewer bundle when esbuild inlines this module. Walking to the
+ * directory marked by the built-in assets preserves one resolution rule for
+ * both loading contexts. */
+export declare function assetRoot(): string;

package/dist/core/asset-root.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var e=(r,o)=>m(r,"name",{value:o,configurable:!0});import{existsSync as i}from"node:fs";import{dirname as t,join as n}from"node:path";import{fileURLToPath as a}from"node:url";function u(){for(let r=t(a(import.meta.url));;r=t(r)){if(i(n(r,"builtin-memory"))&&i(n(r,"builtin-pi-packages")))return r;if(t(r)===r)throw new Error(`cannot locate crouter assets from ${import.meta.url}`)}}e(u,"assetRoot");export{u as assetRoot};

package/dist/core/auth-file.d.ts

@@ -0,0 +1,41 @@
+import type { Credential, CredentialInfo, CredentialStore } from '@earendil-works/pi-ai';
+type AuthFileData = Record<string, Credential>;
+export declare function defaultAuthPath(): string;
+/**
+ * Resolve a stored api-key value the way pi does before handing it to a provider: a leading
+ * `!` runs the rest as a shell command (cached for the process), and `$VAR` / `${VAR}`
+ * interpolate from the credential's own env then `process.env` (`$$` and `$!` escape a
+ * literal `$`/`!`); an unset reference resolves the whole value to undefined. pi's resolver
+ * is internal to the coding agent and its credential store — which crouter replaces — is the
+ * only place it runs, so an auth.json holding `"key": "$ANTHROPIC_API_KEY"` would otherwise
+ * be sent to the provider verbatim.
+ */
+export declare function resolveCredentialValue(config: string, env?: Record<string, string>): string | undefined;
+/** Read all stored credentials. Lock-free: every writer replaces auth.json by atomic
+ *  rename, so a reader either sees the old whole file or the new one. Taking the lock here
+ *  would be pure cost — pi asks for every registered provider (~75 reads) each time it
+ *  builds a model runtime, and those contended acquisitions cost seconds per broker boot. */
+export declare function readAuthCredentials(authPath?: string): Promise<AuthFileData>;
+/** Read one provider's stored credential. */
+export declare function readAuthCredential(providerId: string, authPath?: string): Promise<Credential | undefined>;
+/** Persist one provider's credential under the auth.json lock, leaving every other entry intact. */
+export declare function setAuthCredential(providerId: string, credential: Credential, authPath?: string): Promise<void>;
+/** Remove one provider's credential (logout) under the auth.json lock. Returns
+ * whether a record was removed from the exact snapshot this write replaced. */
+export declare function deleteAuthCredential(providerId: string, authPath?: string): Promise<boolean>;
+/**
+ * The `CredentialStore` crouter hands to `ModelRuntime`. Backed directly by auth.json rather
+ * than by an in-memory cache, so `modify` is a real cross-process read-modify-write: pi's
+ * locked OAuth refresh inside `Models.getAuth()` and crouter's own credential writes serialize
+ * against each other on one lock.
+ */
+export declare class CrouterCredentialStore implements CredentialStore {
+    private readonly authPath;
+    private readonly file;
+    constructor(authPath?: string);
+    read(providerId: string): Promise<Credential | undefined>;
+    list(): Promise<readonly CredentialInfo[]>;
+    modify(providerId: string, fn: (current: Credential | undefined) => Promise<Credential | undefined>): Promise<Credential | undefined>;
+    delete(providerId: string): Promise<void>;
+}
+export {};

package/dist/core/auth-file.js

@@ -0,0 +1,2 @@
+var w=Object.defineProperty;var s=(e,t)=>w(e,"name",{value:t,configurable:!0});import{execSync as m}from"node:child_process";import{join as A}from"node:path";import{secretsDir as k}from"./layout.js";import{LockedJsonFile as d}from"./locked-file.js";function o(){return A(k(),"auth.json")}s(o,"defaultAuthPath");function l(e){if(e===void 0||e.trim()==="")return{};const t=JSON.parse(e);return t!==null&&typeof t=="object"?t:{}}s(l,"parse");function p(e){return`${JSON.stringify(e,null,2)}
+`}s(p,"serialize");const _=/^[A-Za-z_][A-Za-z0-9_]*/,C=/^[A-Za-z_][A-Za-z0-9_]*$/,x=new Map;function O(e){if(x.has(e))return x.get(e);let t;try{t=m(e,{encoding:"utf-8",timeout:1e4,stdio:["ignore","pipe","ignore"]}).trim()||void 0}catch{t=void 0}return x.set(e,t),t}s(O,"runValueCommand");function N(e,t){if(e.startsWith("!"))return O(e.slice(1));let n="",i=0;for(;i<e.length;){const r=e.indexOf("$",i);if(r<0){n+=e.slice(i);break}n+=e.slice(i,r);const a=e[r+1];if(a==="$"||a==="!"){n+=a,i=r+2;continue}let u,f=r+1;if(a==="{"){const c=e.indexOf("}",r+2),y=c<0?void 0:e.slice(r+2,c);y!==void 0&&C.test(y)&&(u=y,f=c+1)}else{const c=_.exec(e.slice(r+1));c!==null&&(u=c[0],f=r+1+u.length)}if(u===void 0){n+="$",i=r+1;continue}const h=t?.[u]||process.env[u];if(h===void 0||h==="")return;n+=h,i=f}return n}s(N,"resolveCredentialValue");async function j(e=o()){return l(new d(e).readUnlocked())}s(j,"readAuthCredentials");async function z(e,t=o()){return(await j(t))[e]}s(z,"readAuthCredential");async function L(e,t,n=o()){await new d(n).withLockAsync(async i=>{const r=l(i);return r[e]=t,{result:void 0,next:p(r)}})}s(L,"setAuthCredential");async function E(e,t=o()){return new d(t).withLockAsync(async n=>{const i=l(n),r=Object.hasOwn(i,e);return delete i[e],{result:r,next:p(i)}})}s(E,"deleteAuthCredential");class S{static{s(this,"CrouterCredentialStore")}authPath;file;constructor(t=o()){this.authPath=t,this.file=new d(t)}async read(t){const n=await z(t,this.authPath);return n?.type!=="api_key"||n.key===void 0?n:{...n,key:N(n.key,n.env)}}async list(){return Object.entries(l(this.file.readUnlocked())).map(([t,n])=>({providerId:t,type:n.type}))}async modify(t,n){return this.file.withLockAsync(async i=>{const r=l(i),a=await n(r[t]);return a===void 0?{result:r[t]}:(r[t]=a,{result:a,next:p(r)})})}async delete(t){await E(t,this.authPath)}}export{S as CrouterCredentialStore,o as defaultAuthPath,E as deleteAuthCredential,z as readAuthCredential,j as readAuthCredentials,N as resolveCredentialValue,L as setAuthCredential};

package/dist/core/auth-interaction.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderAuthInteraction } from '@earendil-works/pi-ai';
+import type { LoginDialogComponent } from '@earendil-works/pi-coding-agent';
+export type DialogInteractionOptions = {
+    /** Open the verification URL for `auth_url` / `device_code` events. */
+    openBrowser?: (url: string) => void;
+    /** Repaint hook — the login dialog transitions between keystrokes, so a host that
+     *  proxies its render (the setup wizard) must be told to drop its cached lines. */
+    onChange?: () => void;
+    /** False once the flow is dead (superseded, cancelled); events are then dropped. */
+    isActive?: () => boolean;
+};
+/**
+ * Build the `AuthInteraction` for one login flow on `dialog`.
+ *
+ * `select` prompts render as a numbered list through the dialog's normal text input:
+ * the dialog occupies crouter's single inline slot in both surfaces, so swapping in pi's
+ * separate selector component (what pi's own interactive mode does) has nowhere to go.
+ */
+export declare function dialogAuthInteraction(dialog: LoginDialogComponent, options?: DialogInteractionOptions): ProviderAuthInteraction;

package/dist/core/auth-interaction.js

@@ -0,0 +1,3 @@
+var w=Object.defineProperty;var o=(n,t)=>w(n,"name",{value:t,configurable:!0});async function b(n,t){const a=t.filter(r=>r!==void 0);if(a.length===0)return n;const i=[],c=new Promise((r,u)=>{for(const e of a){const s=o(()=>u(new Error("Login cancelled")),"onAbort");e.addEventListener("abort",s,{once:!0}),i.push(()=>e.removeEventListener("abort",s))}});try{return await Promise.race([n,c])}finally{for(const r of i)r()}}o(b,"withAbort");function d(n,t={}){const{openBrowser:a,onChange:i,isActive:c}=t,r=o(()=>c?c():!n.signal.aborted,"active"),u=o(()=>i?.(),"changed");return{signal:n.signal,notify(e){if(r()){switch(e.type){case"auth_url":n.showAuth(e.url,e.instructions),a?.(e.url);break;case"device_code":n.showDeviceCode(e),n.showWaiting("Waiting for authentication..."),a?.(e.verificationUri);break;case"info":n.showInfo(e.message,e.links);break;case"progress":n.showProgress(e.message);break}u()}},async prompt(e){if(n.signal.aborted||e.signal?.aborted===!0)throw new Error("Login cancelled");let s;if(e.type==="select"){const f=e.options.map((h,l)=>`${l+1}. ${h.label}`).join(`
+`);s=n.showPrompt(`${e.message}
+${f}`,"1").then(h=>{const l=e.options[Number.parseInt(h,10)-1]?.id;if(l===void 0)throw new Error("Login cancelled");return l})}else e.type==="manual_code"?s=n.showManualInput(e.message):s=n.showPrompt(e.message,e.placeholder);return u(),b(s,[n.signal,e.signal])}}}o(d,"dialogAuthInteraction");export{d as dialogAuthInteraction};

package/dist/core/auto-update.d.ts

@@ -0,0 +1 @@
+export declare function maybeAutoUpdate(argv: string[]): void;

package/dist/core/auto-update.js

@@ -0,0 +1,4 @@
+var h=Object.defineProperty;var s=(r,t)=>h(r,"name",{value:t,configurable:!0});import{spawn as u}from"node:child_process";import{readConfig as m,readState as g,updateState as f}from"./config.js";import{nowIso as l}from"./fs-utils.js";import{info as p}from"./output.js";import{SELF_UPDATE_SCRIPT as _,selfCheck as k,contentCheck as S}from"./self-update.js";import{envDebug as v}from"../shared/env.js";const w=3600*1e3,y=new Set(["update","help","--help","-h","--version","-v"]);function b(r){const t=r[2];return t===void 0?!0:y.has(t)}s(b,"shouldSkipForArgv");function D(r,t){if(!r)return!1;const n=Date.parse(r);return Number.isFinite(n)?Date.now()-n<t*w:!1}s(D,"withinInterval");function U(){u(process.execPath,[_],{detached:!0,stdio:"ignore"}).unref()}s(U,"spawnDetachedSelfUpdate");function $(){u("crtr",["update","--content"],{detached:!0,stdio:"ignore"}).unref()}s($,"spawnDetachedContentUpdate");function F(r){try{if(process.env.CRTR_NO_AUTO_UPDATE==="1"||b(r))return;const t=m("user"),{crtr:n,content:o,interval_hours:d}=t.auto_update;if(n===!1&&o===!1)return;const i=g("user");if(i.last_self_check===void 0){f("user",e=>{e.last_self_check=l()});return}if(D(i.last_self_check,d))return;if(f("user",e=>{e.last_self_check=l()}),n==="notify"){const e=k();e!==null&&(e.migrating||e.latest!==e.current)&&process.stderr.write(`crtr: ${e.package} v${e.latest} available (current ${e.current}${e.migrating?"; this install moves to the new package name":""}) \u2014 run \`crtr sys update\`
+`)}else n==="apply"&&(p("applying self-update in background"),U());if(o==="notify"){const e=S().filter(a=>!a.up_to_date&&!a.unreachable);if(e.length>0){const a=e.map(c=>`${c.kind} ${c.name}`).join(", ");process.stderr.write(`crtr: updates available for ${a} \u2014 run \`crtr sys update\`
+`)}}else o==="apply"&&(p("applying content updates in background"),$())}catch(t){if(v()){const n=t instanceof Error?t.message:String(t);process.stderr.write(`crtr: auto-update hook error: ${n}
+`)}}}s(F,"maybeAutoUpdate");export{F as maybeAutoUpdate};

package/dist/core/bash-guard.d.ts

@@ -0,0 +1,6 @@
+/** Seconds a leading `sleep ...` will block for, or null when the command does
+ *  not open with a sleep (or its duration isn't statically knowable). */
+export declare function leadingSleepSeconds(command: string): number | null;
+/** The refusal this command earns before it runs, or null when it may run.
+ *  `cwd` is the directory the command will execute in. */
+export declare function bashCommandRefusal(command: string, cwd: string, home?: string): string | null;

package/dist/core/bash-guard.js

@@ -0,0 +1,11 @@
+var $=Object.defineProperty;var a=(n,t)=>$(n,"name",{value:t,configurable:!0});import{homedir as I,userInfo as R}from"node:os";import{isAbsolute as k,resolve as x,sep as v}from"node:path";import{commandSegments as L,stripHeredocs as O}from"./shell-segments.js";const h=10,W={s:1,m:60,h:3600,d:86400};function N(n){const t=/^\s*sleep(\s+[^;&|\n]+)/.exec(n);if(!t)return null;let e=0;for(const s of t[1].trim().split(/\s+/)){const r=/^([0-9]*\.?[0-9]+)([smhd]?)$/.exec(s);if(!r)return null;e+=Number(r[1])*W[r[2]||"s"]}return e}a(N,"leadingSleepSeconds");function z(n){const t=N(n);return t===null||t<=h?null:`Refused: this command starts by sleeping ${t}s, over the ${h}s inline limit.
+Holding a live window on a clock is never how you wait here. Instead:
+  - schedule the wake and end your turn: crtr cron -h (one-shot at a time, or recurring)
+  - race an inbox message against a deadline: crtr node wait deadline -h
+  - waiting on a child, a reply from the user, or any spine event: just stop \u2014 the runtime wakes you.
+If you truly need a short pause inline, sleep ${h}s or less.`}a(z,"longSleepRefusal");const D=["/","/Applications","/bin","/dev","/etc","/home","/Library","/opt","/private","/private/etc","/private/tmp","/private/var","/sbin","/System","/tmp","/usr","/Users","/var","/Volumes"];function M(n,t,e){return D.includes(n)?"a system directory":n===t?"your home directory":n===`${t}/.crouter`?"the canvas home \u2014 every node\u2019s conversation and state":e===n||!e.startsWith(n.endsWith(v)?n:n+v)?null:`a directory containing your working directory (${e})`}a(M,"protectedReason");function T(n,t){const e=R().username;return new Map([["HOME",n],["PWD",t],["USER",e],["LOGNAME",e]])}a(T,"initialVariables");function y(n,t){let e=n;if(e==="~"||e.startsWith("~/")){const s=t.get("HOME");if(s===void 0)return null;e=s+e.slice(1)}else if(e.startsWith("~"))return null;return e=e.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)\}|\$([A-Za-z_][A-Za-z0-9_]*)/g,(s,r,i)=>t.get(r??i)??s),/[$`*?[]/.test(e)?null:e}a(y,"expandText");function E(n,t,e){const s=y(n.replace(/\/+\*?\.?$/,"")||"/",t);return s===null?null:k(s)?x(s):e===null?null:x(e,s)}a(E,"resolveTarget");function d(n,t){for(const e of t){const s=e.indexOf("=");if(s<=0)continue;const r=e.slice(0,s);if(!/^[A-Za-z_][A-Za-z0-9_]*$/.test(r))continue;const i=y(e.slice(s+1),n);i===null?n.delete(r):n.set(r,i)}}a(d,"applyAssignments");const H=/^[0-9]*(&?>>?|<<?|>&|<&)/;function m(n){const t=[];let e=!1,s=!1;for(const r of n.slice(1)){if(s){s=!1;continue}const i=H.exec(r.text);if(i!==null&&!r.opaque){s=r.text===i[0];continue}if(!e&&r.text==="--"){e=!0;continue}!e&&r.text.startsWith("-")&&r.text!=="-"||t.push(r.text)}return t}a(m,"operands");function P(n){const t=new Set,e=new Set;for(const s of n.slice(1)){if(s.text==="--")break;if(s.text.startsWith("--"))e.add(s.text.slice(2));else if(s.text.startsWith("-")&&s.text.length>1)for(const r of s.text.slice(1))t.add(r)}return{letters:t,long:e}}a(P,"flagLetters");function w(n){const{letters:t,long:e}=P(n);return t.has("r")||t.has("R")||e.has("recursive")}a(w,"isRecursive");const C=/^\/dev\/r?(disk|sd[a-z]|nvme|hd[a-z]|vd[a-z]|mmcblk|md)/;function q(n){const t=[];let e=1;for(;e<n.length;){const s=n[e].text;if(s==="--"||/^-[HLPEdsx]$/.test(s))e+=1;else if(s==="-D"||s==="-O")e+=2;else if(s==="-f")e+1<n.length&&t.push(n[e+1].text),e+=2;else break}for(;e<n.length&&!n[e].text.startsWith("-");e+=1)t.push(n[e].text);return t}a(q,"findPaths");const Z=new Set(["sudo","doas","command","env","nice","nohup","time","stdbuf","xargs","exec","builtin"]);function V(n){let t=n;for(;t.length>0&&!t[0].opaque&&Z.has(t[0].text);){let e=1;for(;e<t.length&&t[e].text.startsWith("-");){const s=/^-[nu]$/.test(t[e].text);e+=s?2:1}for(;e<t.length&&/^[A-Za-z_][A-Za-z0-9_]*=/.test(t[e].text);)e+=1;if(e>=t.length)return[];t=t.slice(e)}return t}a(V,"stripCommandPrefixes");function U(n){const t={targets:[],named:null},e=n[0];if(e===void 0||e.opaque)return t;const s=e.text.slice(e.text.lastIndexOf("/")+1),r=m(n);switch(s){case"rm":return w(n)?{targets:r,named:null}:t;case"mv":return r.length>=2?{targets:r.slice(0,-1),named:null}:t;case"chmod":case"chown":case"chgrp":return w(n)&&r.length>=2?{targets:r.slice(1),named:null}:t;case"find":return n.some(o=>!o.opaque&&(o.text==="-delete"||o.text==="-exec"||o.text==="-execdir"))?{targets:q(n),named:null}:t;case"dd":{const i=n.find(l=>l.text.startsWith("of="));if(i===void 0)return t;const o=i.text.slice(3);return C.test(o)?{targets:[],named:o}:o.startsWith("/dev/")?t:{targets:[o],named:null}}default:if(/^(mkfs|newfs)([.-].+)?$/.test(s))return{targets:[],named:s};if(s==="diskutil"){const i=r[0];if(i!==void 0&&/^(erase|reformat|partition|zeroDisk|randomDisk|secureErase)/i.test(i))return{targets:[],named:`diskutil ${i}`}}return t}}a(U,"destructiveTargets");function B(n,t,e){const s=T(e,t);let r=[t];for(const i of L(O(n))){const o=V(i.tokens),l=o[0];if(l!==void 0){const u=new Map(s);d(u,i.assignments);const c=r[r.length-1];c!==void 0&&u.set("PWD",c);const{targets:S,named:p}=U(o);if(p!==null)return b(i.text,p,"a whole disk or volume \u2014 never a task boundary");for(const A of S)for(const _ of r.length===0?[null]:r){const f=E(A,u,_);if(f===null)continue;const g=M(f,e,t);if(g!==null)return b(i.text,f,g)}}if(!i.background){if(l===void 0)d(s,i.assignments);else if(!l.opaque&&X.has(l.text))d(s,i.assignments),d(s,m(o));else if(!l.opaque&&l.text==="cd"){const u=m(o)[0],c=u===void 0?s.get("HOME")??null:E(u,s,r[r.length-1]??null);r=c===null?[]:[...r,c]}}}return null}a(B,"destructiveCommandRefusal");const X=new Set(["export","declare","typeset","readonly"]);function b(n,t,e){return`Refused: \`${n}\` targets ${t}, which is ${e}.
+Nothing an agent is asked to do requires destroying that path, and it cannot be undone.
+If you meant somewhere else, name that path explicitly and run the command again. Two traps to check first:
+  - a \`VAR=value cmd\` prefix applies ONLY to that one command, so a later \`$VAR\` in the same line is the SHELL's value \u2014 this is exactly how a node deleted a home directory.
+  - \`~\` and \`$HOME\` are the real home directory, never a scratch dir; build scratch paths with mktemp -d and hold them in a variable of your own.
+If you believe this path genuinely must be destroyed, ask the user \u2014 do not work around this refusal.`}a(b,"refusalMessage");function K(n,t,e=I()){return z(n)??B(n,t,e)}a(K,"bashCommandRefusal");export{K as bashCommandRefusal,N as leadingSleepSeconds};

package/dist/core/bash-job-supervisor.d.ts

@@ -0,0 +1,5 @@
+export declare const MAX_BACKGROUND_BASH_LOG_BYTES: number;
+export declare const BACKGROUND_BASH_LOG_TRUNCATION_MARKER = "\n[background bash job output truncated at 10 MiB; remaining output discarded]\n";
+/** File-backed command supervisor. It writes the exit code to job.exit and, for a foreground
+ * command, claims job.done; the daemon reads job.exit of a backgrounded job and publishes `exited`. */
+export declare const BASH_JOB_SUPERVISOR_SCRIPT: string;

package/dist/core/bash-job-supervisor.js

@@ -0,0 +1,4 @@
+const t=10485760,n=`
+[background bash job output truncated at 10 MiB; remaining output discarded]
+`,e=['const fs = require("node:fs");',"const cap = 10485760;",`const marker = Buffer.from(${JSON.stringify(n)});`,"const prefixCap = cap - marker.length;",'const fd = fs.openSync(process.argv[1], "w");',"let written = 0;","let truncated = false;",'process.stdin.on("data", (chunk) => {',"  if (truncated) return;","  const available = prefixCap - written;","  if (available > 0) {","    const prefix = chunk.subarray(0, available);","    fs.writeSync(fd, prefix);","    written += prefix.length;","    if (prefix.length === chunk.length) return;","  }","  fs.writeSync(fd, marker);","  truncated = true;","});",'process.stdin.on("end", () => fs.closeSync(fd));'].join(" "),r=["n=$(command -v nice)",'${n:+"$n" -n "$7"} "$6" "$1" 2>&1 | "$8" -e '+JSON.stringify(e)+' "$2"','echo "${PIPESTATUS[0]}" > "$3"','mv "$4" "$5" 2>/dev/null || true'].join(`
+`);export{n as BACKGROUND_BASH_LOG_TRUNCATION_MARKER,r as BASH_JOB_SUPERVISOR_SCRIPT,t as MAX_BACKGROUND_BASH_LOG_BYTES};