@north-light/cli 0.0.0 → 0.3.414

package/dist/core/substrate/delivery/render-event.d.ts

@@ -0,0 +1,54 @@
+/** Event rendering for the row-backed delivery engine: plan an activity, render
+ *  each winner the ledger does not already hold, and for every content
+ *  delivery attach its prefix listings and link previews and chain its `document-read` rules
+ *  until nothing new is delivered. Every rendered document is held in the
+ *  in-memory `ledger`; persisting it is the caller's. Envelope markup is the
+ *  `<memory>` / `<memory-listing>` / `<auto-loaded-context>` shape that
+ *  `pi-extensions/envelope-merge.ts` parses. */
+import type { DatabaseSync } from 'node:sqlite';
+import { type Channel, type Ledger } from '../../graph/exposures.js';
+import type { Reader, RuleOn } from '../../graph/types.js';
+import type { Rung } from '../schema.js';
+import type { NodeConfigSubject } from '../subject-fields.js';
+import { type DeliveryPayload } from './plan.js';
+import type { DeliveryDoc } from './types.js';
+export type DeliveryCause = 'directory listing attached to content delivery' | 'link preview attached to content delivery' | 'memory-read companion of content delivery';
+export interface DeliveredDoc {
+    doc: DeliveryDoc;
+    level: Exclude<Rung, 'none'>;
+    /** Absent for a document the activity's own rules delivered. */
+    cause?: DeliveryCause;
+}
+export interface RenderContext {
+    db: DatabaseSync;
+    reader: Reader;
+    subject: NodeConfigSubject | null;
+    ledger: Ledger;
+    channel: Channel;
+}
+/** One document at one level: body inside the element for content, self-closing
+ *  otherwise (a preview carries its line as `readWhen`). Empty-bodied content renders self-closing. */
+export declare function renderEnvelope(doc: DeliveryDoc, level: Exclude<Rung, 'none'>): string;
+export declare function wrapAutoLoaded(blocks: readonly string[]): string;
+/** The live documents `doc`'s current revision links to that the reader may
+ *  read, in link order, without `doc` itself. Remote and unresolved links have
+ *  no `links-to` edge, so they never appear. */
+export declare function linkedDocs(db: DatabaseSync, reader: Reader, doc: DeliveryDoc): DeliveryDoc[];
+/** Deliver one activity. `corpus` overrides the reader's own corpus for `on`
+ *  (the file-read corpus also carries the rules of repos enclosing the file). */
+export declare function renderEvent(ctx: RenderContext, on: RuleOn, payload: DeliveryPayload, corpus?: readonly DeliveryDoc[]): {
+    content: string;
+    delivered: DeliveredDoc[];
+};
+/** What a document the node read on purpose brings with it: its own prefix
+ *  listing unfiltered (`listing`), the documents it links to not yet held at
+ *  preview (`linked`, held at preview now), enclosing listings and chained
+ *  `document-read` deliveries (`attachments`, wrapped). With `ownAsBlock`
+ *  (a caller that renders only `attachments`), the own set rides there as a
+ *  block instead. The read document itself is held at content in `ledger`. */
+export declare function renderExplicitRead(ctx: RenderContext, doc: DeliveryDoc, ownAsBlock?: boolean): {
+    attachments: string;
+    listing?: string[];
+    linked: DeliveryDoc[];
+    delivered: DeliveredDoc[];
+};

package/dist/core/substrate/delivery/render-event.js

@@ -0,0 +1,8 @@
+var A=Object.defineProperty;var s=(e,n)=>A(e,"name",{value:n,configurable:!0});import{prepared as D}from"../../sqlite-statements.js";import{canRead as E}from"../../graph/access.js";import{heldAtOrAbove as y,hold as b,holdListing as O,listedAtOrAbove as H}from"../../graph/exposures.js";import{deliveryDocOf as K,listingCorpus as L,loadCorpus as w}from"./corpus.js";import{listingBlock as R,ownSetBlock as C,listingKey as P,listingLabel as x,listingPrefixes as S,renderListing as k}from"./listings.js";import{planDelivery as B}from"./plan.js";function g(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}s(g,"attr");function M(e,n){let t=`kind="${g(e.kind)}" name="${g(e.displayName)}"`;if(n==="content"){const i=e.body().trim();if(i!=="")return`<memory ${t}>
+${i}
+</memory>`}else n==="preview"&&e.preview.trim()!==""&&(t+=` readWhen="${g(e.preview.trim())}"`);return`<memory ${t} />`}s(M,"renderEnvelope");function j(e){return e.length===0?"":`<auto-loaded-context>
+${e.join(`
+`)}
+</auto-loaded-context>`}s(j,"wrapAutoLoaded");function W(e,n){let t=e.members.get(n.owner.rowid);return t===void 0&&(t=L(e.ctx.db,e.ctx.reader,n.owner),e.members.set(n.owner.rowid,t)),t}s(W,"membersOf");function I(e,n,t){return D(e,`SELECT o.* FROM edges e JOIN objects o ON o.rowid = e.dst
+    WHERE e.type = 'links-to' AND e.src = ? AND o.type = 'document' AND o.deleted_at IS NULL AND o.rowid <> ?
+    ORDER BY e.written_as`).all(t.object.rowid,t.object.rowid).filter(o=>E(e,n,o)).map(o=>K(e,n,o))}s(I,"linkedDocs");function _(e,n){return n.owner.rowid===e.owner.rowid&&n.name.startsWith(`${e.name}/`)&&!n.name.slice(e.name.length+1).includes("/")}s(_,"underOwnPrefix");function q(e,n){const{ledger:t,channel:i}=e.ctx,o=[],c=[];for(const r of I(e.ctx.db,e.ctx.reader,n)){if(_(n,r)&&!r.unlisted)continue;const a={object:r.object.rowid,headsKey:r.headsKey,contentHash:r.bodyHash};if(y(t,a,"preview"))continue;b(t,i,a,"preview"),e.delivered.push({doc:r,level:"preview",cause:"link preview attached to content delivery"}),c.push(r);const d=r.preview.trim();o.push(d===""?`[[${r.displayName}]]`:`[[${r.displayName}]]: ${d}`)}return{lines:o,linked:c}}s(q,"linkPreviews");function $(e,n,t){const{ledger:i,channel:o}=e.ctx,c=W(e,n),r=[];let a,d=[];for(const m of S(c,n.name)){const p=m===n.name,f=P(n,m);if(!(p&&t)&&H(i,f,"preview"))continue;const{lines:l,previewed:u}=k(c,m,i,o,!(p&&t));for(const v of u)e.delivered.push({doc:v,level:"preview",cause:"directory listing attached to content delivery"});l.length!==0&&(O(i,o,f,"preview"),p?d=l:r.push(R(x(n,m),l)))}const h=q(e,n);return t?d.length>0&&(a=d):d.length+h.lines.length>0&&r.unshift(C(x(n,n.name),d,h.lines)),e.chainCorpus??=w(e.ctx.db,e.ctx.reader,["document-read"]),r.push(...N(e,e.chainCorpus,"document-read",{doc:n},"memory-read companion of content delivery")),{blocks:r,...a===void 0?{}:{listing:a},linked:h.linked}}s($,"attachments");function N(e,n,t,i,o){const{db:c,reader:r,subject:a,ledger:d,channel:h}=e.ctx,m=B(c,a,r,n,t,i),p=[];for(const f of m.docs){const l=f.finalRung;if(!f.winner||l==="none")continue;const{doc:u}=f,v={object:u.object.rowid,headsKey:u.headsKey,contentHash:u.bodyHash};y(d,v,l)||(b(d,h,v,l),e.delivered.push({doc:u,level:l,...o===void 0?{}:{cause:o}}),l==="content"&&p.push(...$(e,u,!1).blocks),p.push(M(u,l)))}return p}s(N,"renderPlan");function Q(e,n,t,i=w(e.db,e.reader,[n])){const o={ctx:e,delivered:[],members:new Map};return{content:j(N(o,i,n,t)),delivered:o.delivered}}s(Q,"renderEvent");function V(e,n,t=!1){const i={ctx:e,delivered:[],members:new Map};b(e.ledger,e.channel,{object:n.object.rowid,headsKey:n.headsKey,contentHash:n.bodyHash},"content");const{blocks:o,listing:c,linked:r}=$(i,n,!t);return{attachments:j(o),...c===void 0?{}:{listing:c},linked:r,delivered:i.delivered}}s(V,"renderExplicitRead");export{I as linkedDocs,M as renderEnvelope,Q as renderEvent,V as renderExplicitRead,j as wrapAutoLoaded};

package/dist/core/substrate/delivery/sub-persona-menu.d.ts

@@ -0,0 +1,2 @@
+/** The "sub-personas you may spawn" menu for a kind; '' when it has none. */
+export declare function buildSubPersonaMenu(kind: string): string;

package/dist/core/substrate/delivery/sub-persona-menu.js

@@ -0,0 +1,6 @@
+var a=Object.defineProperty;var o=(e,n)=>a(e,"name",{value:n,configurable:!0});import{subKindsAvailableTo as r}from"../../config.js";import{packageFiles as u}from"../../graph/package-files.js";import{builtinMemoryRoot as p}from"../../scope.js";let s;function c(e){s??=u(p()).files.map(t=>t.name);const n=`kinds/${e}`;return s.some(t=>t===n||t.startsWith(`${n}/`))?` (\`crtr canvas read ${n}\`)`:""}o(c,"subKindDocCitation");function f(e){const n=r(e);if(n.length===0)return"";const t=n.map(i=>`- \`${i.kind}\` \u2014 ${i.whenToUse}${c(i.kind)}`);return`## Sub-personas you may spawn
+
+These specialist sub-personas are available to the ${e} kind. Spawn one with \`crtr node new --kind <sub> "<scope>"\`, and treat it as its own scope instead of dragging unrelated context into it.
+
+`+t.join(`
+`)}o(f,"buildSubPersonaMenu");export{f as buildSubPersonaMenu};

package/dist/core/substrate/delivery/types.d.ts

@@ -0,0 +1,30 @@
+/** Row-backed delivery engine: one document as the planner and renderers see it. */
+import type { RuleRow } from '../../graph/rules.js';
+import type { ObjectRow } from '../../graph/types.js';
+import type { Rung } from '../schema.js';
+export interface DeliveryDoc {
+    object: ObjectRow;
+    owner: ObjectRow;
+    /** How `<handle>/<name>` names the owner: a node's id, else the owner's name. */
+    ownerHandle: string;
+    /** The owner's index in the reader's view (0 = own node); lower wins a bare name. */
+    viewRank: number;
+    /** The document belongs to the reading node itself. */
+    ownNode: boolean;
+    /** A package document (`documents.source_path` set): an installed plugin's or crtr's own. */
+    shipped: boolean;
+    kind: 'knowledge' | 'preference';
+    name: string;
+    /** The bare name when `[[name]]` resolves to this object for the reader, else `<ownerHandle>/<name>`. */
+    displayName: string;
+    preview: string;
+    unlisted: boolean;
+    headsKey: string;
+    /** Body hash of the highest head revision. */
+    bodyHash: string;
+    /** Lazy: preview and name deliveries never read the body. */
+    body(): string;
+    rules: RuleRow[];
+    /** The profile's cap for this owner on `boot` / `workspace-open`. */
+    limit: Rung;
+}

package/dist/core/substrate/gate-explain.d.ts

@@ -0,0 +1,35 @@
+import type { NodeConfigSubject } from './subject-fields.js';
+/** The subject has no value at this field path — distinct from a value of
+ *  `null`, which a gate can legitimately demand. */
+export declare const ABSENT: unique symbol;
+/** One failing condition of a gate.
+ *
+ *  `mismatch` and `malformed` are two different remedies on two different
+ *  objects: dial the node's configuration, or edit the document. */
+export interface GateClause {
+    /** The gate field as authored (`kind`, `cwd`, `orchestration.depth`). Empty
+     *  for a defect of the gate as a whole, such as an empty `gate: {}`. */
+    field: string;
+    failure: 'mismatch' | 'malformed';
+    /** The subject's resolved value at `field`, or `ABSENT`. */
+    actual: unknown;
+    /** The matcher as authored, structurally — rendered by `formatClause`. */
+    demand: unknown;
+    /** What is wrong with the gate itself. Only when `failure` is `malformed`. */
+    defect?: string;
+}
+/** The failing clauses of `condition` against `subject`, or an empty list when
+ *  the failure cannot be decomposed — an `any`/`not` combinator swallowed it,
+ *  or the predicate is a shape this walk does not recognise. An empty list is
+ *  the caller's signal to print the generic reason instead. */
+export declare function explainGate(condition: unknown, subject: NodeConfigSubject): GateClause[];
+/** The grammar's own break between the reader's value and the gate's demand —
+ *  the only place a clause line may be split. */
+export declare const CLAUSE_SEPARATOR = " | gate: ";
+/** One clause as one line of plain text — the ONLY place a gate failure is put
+ *  into human words. Callers own indentation, colour, wrapping, and joining. */
+export declare function formatClause(clause: GateClause): string;
+/** The pattern as the thing it demands: an anchored literal path collapsed to
+ *  the directory it names, else the longest literal run it insists on, else an
+ *  admission that it is a pattern. The source is never printed. */
+export declare function readableRegex(source: string): string;

package/dist/core/substrate/gate-explain.js

@@ -0,0 +1 @@
+var O=Object.defineProperty;var o=(n,t)=>O(n,"name",{value:t,configurable:!0});import{getField as y,matchField as W,evalCondition as m}from"../predicate.js";import{tildify as w}from"../fs-utils.js";const d=Symbol("absent");function M(n,t){return g(n,t)??[]}o(M,"explainGate");function g(n,t){if(n==null||typeof n!="object")return[];if(Array.isArray(n))return A(n,t);const e=n,r=[];if(("any"in e||"not"in e)&&("any"in e&&!m({any:e.any},t)||"not"in e&&!m({not:e.not},t)))return null;if("all"in e){const s=A(Array.isArray(e.all)?e.all:[e.all],t);if(s===null)return null;r.push(...s)}const i=Object.keys(e).filter(s=>s!=="all"&&s!=="any"&&s!=="not");if(i.length===0&&!("all"in e)&&!("any"in e)&&!("not"in e))return[{field:"",failure:"malformed",actual:d,demand:e,defect:"is empty, and an empty gate never matches"}];for(const s of i){const u=e[s];W(y(t,s),u)||r.push(N(s,u,t))}return r}o(g,"walk");function A(n,t){const e=[];for(const r of n){const i=g(r,t);if(i===null)return null;e.push(...i)}return e}o(A,"collect");function N(n,t,e){const r=y(e,n),i=r===void 0?d:r,s=E(t);return s===null?{field:n,failure:"mismatch",actual:i,demand:t}:{field:n,failure:"malformed",actual:i,demand:t,defect:s}}o(N,"clauseFor");const j=new Set(["eq","ne","in","nin","exists","contains","containsAll","containsAny","matches","imatches","gt","gte","lt","lte"]);function E(n){if(n===null||Array.isArray(n)||typeof n!="object")return null;for(const[t,e]of Object.entries(n)){if(!j.has(t))return`uses unknown operator "${t}" \u2014 unknown operators never match`;if(t==="matches"||t==="imatches"){if(typeof e!="string")return"is matched against something that is not a pattern \u2014 it never matches";try{new RegExp(e,t==="imatches"?"i":"")}catch{return"has an invalid regular expression \u2014 an invalid pattern never matches"}}if(["gt","gte","lt","lte"].includes(t)&&Number.isNaN(Number(e)))return`compares ${t} against something that is not a number \u2014 it never matches`}return null}o(E,"matcherDefect");function $(n){return n==="hasManager"?"manager":n==="orchestration.depth"?"depth":n}o($,"labelFor");const L=" | gate: ";function _(n){return n.failure==="malformed"?`${n.field===""?"the gate":$(n.field)} ${n.defect??"never matches"}`:`${$(n.field)}: ${x(n.actual)}${L}${a(n.demand)}`}o(_,"formatClause");function x(n){return n===d||n===null||n===void 0?"none":typeof n=="boolean"?n?"yes":"no":Array.isArray(n)?n.map(t=>x(t)).join(", "):typeof n=="string"?n===""?"none":h(n):typeof n=="object"?JSON.stringify(n):String(n)}o(x,"renderActual");function a(n){if(n==null)return"none";if(typeof n=="boolean")return n?"yes":"no";if(typeof n=="string")return n===""?"none":h(n);if(typeof n=="number")return String(n);if(Array.isArray(n))return p(n);const t=Object.entries(n);return t.length===0?"nothing":t.map(([e,r])=>R(e,r)).join(" and ")}o(a,"renderDemand");function R(n,t){switch(n){case"eq":return a(t);case"ne":return`not ${a(t)}`;case"in":return p(t);case"nin":return`not ${p(t)}`;case"exists":return t===!1?"no value":"any value";case"contains":return`includes ${a(t)}`;case"containsAll":return`includes all of ${S(t)}`;case"containsAny":return`includes any of ${S(t)}`;case"matches":case"imatches":return typeof t=="string"?C(t):"a pattern";case"gt":return`> ${String(t)}`;case"gte":return`\u2265 ${String(t)}`;case"lt":return`< ${String(t)}`;case"lte":return`\u2264 ${String(t)}`;default:return`${n} ${String(t)}`}}o(R,"renderOp");function p(n){const t=(Array.isArray(n)?n:[n]).map(e=>a(e));return t.length===0?"nothing":t.join(" or ")}o(p,"orList");function S(n){return(Array.isArray(n)?n:[n]).map(t=>a(t)).join(", ")}o(S,"commaList");function h(n){return n.startsWith("/")?w(n):n}o(h,"shortPath");const c=new Set(["\\","^","$",".","|","?","*","+","(",")","[","]","{","}"]);function C(n){let t=n;t.startsWith("^")&&(t=t.slice(1)),t=t.replace(/\((?:\?:)?\\?\/\|\$\)\??$/,""),t.endsWith("$")&&!t.endsWith("\\$")&&(t=t.slice(0,-1));const e=b(t);if(e!==null&&e!=="")return h(e);const r=F(t);if(r!==null)return r.map(s=>h(s)).join(" or ");const i=P(n);return i===null?"a pattern":`contains "${h(i)}"`}o(C,"readableRegex");function b(n){let t="";for(let e=0;e<n.length;e++){const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(b,"unescapeLiteral");function F(n){const t=n.indexOf("(");if(t===-1||!n.endsWith(")"))return null;const e=b(n.slice(0,t));if(e===null)return null;let r=n.slice(t+1,-1);if(r.startsWith("?:")&&(r=r.slice(2)),r.includes("(")||r.includes(")"))return null;const i=r.split("|");if(i.length<2)return null;const s=[];for(const u of i){const l=T(u);if(l===null)return null;s.push(e+l)}return s}o(F,"distributeAlternation");function T(n){let t="";for(let e=0;e<n.length;e++){if(n.startsWith("[^/]+",e)){t+="*",e+=4;continue}if(n.startsWith("[^\\/]+",e)){t+="*",e+=5;continue}if(n.startsWith(".*",e)){t+="*",e+=1;continue}const r=n[e];if(r==="\\"){const i=n[e+1];if(i===void 0||!c.has(i)&&i!=="/"&&i!=="-")return null;t+=i,e++;continue}if(c.has(r))return null;t+=r}return t}o(T,"branchText");function P(n){let t="",e="",r=0,i=!1;const s=o(()=>{e.length>t.length&&(t=e),e=""},"flush");for(let u=0;u<n.length;u++){const l=n[u];if(l==="\\"){const f=n[u+1];if(u++,r===0&&!i&&f!==void 0&&(c.has(f)||f==="/"||f==="-")){e+=f;continue}s();continue}if(i){l==="]"&&(i=!1);continue}if(l==="["){s(),i=!0;continue}if(l==="("){s(),r++;continue}if(l===")"){s(),r>0&&r--;continue}if(l==="|"&&r===0)return null;if(l==="{"){e.length>0&&(e=e.slice(0,-1)),s();const f=n.indexOf("}",u);f!==-1&&(u=f);continue}if(c.has(l)||r>0){(l==="?"||l==="*")&&e.length>0&&(e=e.slice(0,-1)),s();continue}e+=l}return s(),t.length>1?t:null}o(P,"longestLiteralRun");export{d as ABSENT,L as CLAUSE_SEPARATOR,M as explainGate,_ as formatClause,C as readableRegex};

package/dist/core/substrate/schema.d.ts

@@ -0,0 +1,29 @@
+import { type ProfileProjectMemory } from '../../api/dto/profiles.js';
+export declare const KINDS: readonly ["knowledge", "preference"];
+export type DocKind = (typeof KINDS)[number];
+/** Is `v` one of the two valid document kinds? */
+export declare function isDocKind(v: unknown): v is DocKind;
+export declare const RUNGS: readonly ["none", "name", "preview", "content"];
+export type Rung = ProfileProjectMemory;
+/** Ordinal of a rung on the ladder (none=0 … content=3). */
+export declare function rungRank(r: Rung): number;
+/** Does rung `r` disclose at least as much as `min`? */
+export declare function rungAtLeast(r: Rung, min: Rung): boolean;
+/** The lower of two rungs — the clamp automatic delivery applies to an
+ *  authored rung against its project relationship's cap. */
+export declare function minRung(a: Rung, b: Rung): Rung;
+/** A gate predicate tree, evaluated by predicate.ts (`evalCondition`) against
+ *  the node-config subject. Typed loosely on purpose — the matcher engine owns
+ *  validation; structurally it is a field→matcher map with optional
+ *  `all`/`any`/`not` combinators. */
+export type GatePredicate = Record<string, unknown>;
+export type DocRepresentation = 'leaf-file' | 'directory-index';
+/** Which form a store-relative markdown path takes. */
+export declare function representationForPath(physicalRelativePath: string): DocRepresentation;
+/** Local name derived from a store-relative markdown path: ordering prefixes
+ *  stripped from every segment and one trailing `INDEX` collapsed. Empty only
+ *  for a root `INDEX.md`. */
+export declare function localNameFromPath(physicalRelativePath: string): string;
+/** A document's explicit frontmatter `name` as a local name — normalized with
+ *  one trailing `INDEX` collapsed — or `null` when it carries none. */
+export declare function explicitLocalName(fm: Record<string, unknown> | null | undefined): string | null;

package/dist/core/substrate/schema.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(n,e)=>a(n,"name",{value:e,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as l}from"../../api/dto/profiles.js";const f=["knowledge","preference"];function d(n){return typeof n=="string"&&f.includes(n)}t(d,"isDocKind");const s=l;function r(n){return s.indexOf(n)}t(r,"rungRank");function N(n,e){return r(n)>=r(e)}t(N,"rungAtLeast");function R(n,e){return r(n)<=r(e)?n:e}t(R,"minRung");const m=/^\d{2}-/,o="INDEX";function i(n){return n.replace(m,"")}t(i,"normalizeNameSegment");function g(n){return n.split("/").map(i).join("/")}t(g,"normalizeDocName");function c(n){return n.split("/").filter(e=>e!=="")}t(c,"canonicalSegments");function u(n){const e=c(n);return e[e.length-1]===o&&e.pop(),e.join("/")}t(u,"collapseTrailingIndex");function p(n){return c(n.replace(/\\/g,"/").replace(/\.md$/i,"")).map(i)}t(p,"pathIdentitySegments");function I(n){const e=p(n);return e[e.length-1]===o?"directory-index":"leaf-file"}t(I,"representationForPath");function S(n){return u(p(n).join("/"))}t(S,"localNameFromPath");function _(n){const e=n?.name;return typeof e!="string"||e.trim()===""?null:u(g(e.trim()))}t(_,"explicitLocalName");export{f as KINDS,s as RUNGS,_ as explicitLocalName,d as isDocKind,S as localNameFromPath,R as minRung,I as representationForPath,N as rungAtLeast,r as rungRank};

package/dist/core/substrate/subject-fields.d.ts

@@ -0,0 +1,48 @@
+import type { Mode, Lifecycle } from '../canvas/types.js';
+/** The gate input: a node's configuration as a structured object. Field names
+ *  and shape are the predicate vocabulary's dotted paths (`orchestration.depth`,
+ *  `hasManager`, …). There is intentionally NO `tags` field — NodeMeta has none. */
+export interface NodeConfigSubject {
+    /** The node's role, free-form (developer | explore | design | …). NodeMeta.kind. */
+    kind: string;
+    /** base (hands-on worker) | orchestrator (delegating manager). NodeMeta.mode. */
+    mode: Mode;
+    /** terminal (worker) | resident (manager). NodeMeta.lifecycle. */
+    lifecycle: Lifecycle;
+    /** Spine position: does this node have a manager? (= parent !== null). */
+    hasManager: boolean;
+    /** The node's working directory on disk. NodeMeta.cwd. */
+    cwd: string;
+    /** DERIVED: the scope scope.ts resolves for `cwd` — `project` when a
+     *  nearest-ancestor `.crouter/` exists at/above cwd, else `user`. */
+    scope: 'user' | 'project';
+    /** DERIVED orchestration metrics. */
+    orchestration: {
+        /** Spine distance (hops) from this node up to its root orchestrator. The
+         *  root itself is 0; a direct child of the root is 1; etc. */
+        depth: number;
+    };
+    /** DERIVED: `meta.profile_id` resolved to its manifest's mutable `name` (NOT
+     *  the stable directory id — gate authors write `gate: {profile: <name>}`).
+     *  null for historical null-profile rows, and null (never throwing) when the
+     *  profile has been deleted or its manifest is unreadable — this is a HOT,
+     *  every-doc-render path and must never brick boot/on-read gating. */
+    profile: string | null;
+    /** Effective per-run scopes. */
+    scopes: readonly string[];
+    /** DERIVED: handles of the repos enclosing `cwd`, nearest first. A rule's
+     *  `if: {repo: crouter}` holds when any element is `crouter`. */
+    repo: readonly string[];
+}
+export declare function effectiveScopes(scopes: readonly string[] | null | undefined): string[];
+/** The scope a cwd resolves into: `project` when scope.ts finds a
+ *  nearest-ancestor `.crouter/` at/above it, else `user`. Reuses the existing
+ *  resolver (`projectScopeRoot`). */
+export declare function scopeForCwd(cwd: string): 'user' | 'project';
+/** Resolve `profile_id` to the manifest's mutable `name` for the gate subject.
+ *  NEVER throws: a missing/deleted profile resolves to `null` silently (the
+ *  ordinary lifecycle of a node whose profile was deleted out from under it);
+ *  any OTHER failure (e.g. an unreadable/corrupt manifest slipping past
+ *  `loadProfileManifest`'s own tolerance) is logged and still resolves to
+ *  `null` rather than throwing — this runs on every gated-doc render. */
+export declare function profileNameFor(profileId: string | null | undefined): string | null;

package/dist/core/substrate/subject-fields.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(r,e)=>o(r,"name",{value:e,configurable:!0});import{projectScopeRoot as t}from"../scope.js";import{loadProfileManifest as u}from"../profiles/manifest.js";import{CrtrError as f}from"../errors.js";import{SCOPE_VOCABULARY as l}from"../scopes.js";function p(r){return r==null?[...l]:[...r]}n(p,"effectiveScopes");function d(r){return t(r)!==null?"project":"user"}n(d,"scopeForCwd");function j(r){if(r==null||r==="")return null;try{return u(r).manifest.name}catch(e){return e instanceof f&&e.code==="not_found"||console.warn(`[subject] profile "${r}" failed to resolve for node subject assembly: ${e.message}`),null}}n(j,"profileNameFor");export{p as effectiveScopes,j as profileNameFor,d as scopeForCwd};

package/dist/core/substrate/subject.d.ts

@@ -0,0 +1,13 @@
+import type { ObjectRow } from '../graph/types.js';
+import { type NodeConfigSubject } from './subject-fields.js';
+export { effectiveScopes, scopeForCwd, profileNameFor } from './subject-fields.js';
+export type { NodeConfigSubject } from './subject-fields.js';
+/** Spine distance from `nodeId` up to its root orchestrator: count the hops
+ *  walking the `parent` chain (canvas-db rows) until a row with no parent (the
+ *  root). The root is depth 0. Cycle-guarded (parents must not cycle, but never
+ *  loop forever) — mirrors `rootOfSpine` in runtime/placement.ts. */
+export declare function spineDepth(nodeId: string): number;
+/** Assemble the node-config subject for `nodeId` from its `NodeMeta` + the
+ *  derived fields. Returns `null` when the node has no canvas-db row (an
+ *  unknown id). Pure aside from the canvas-db + profile-manifest reads. */
+export declare function assembleNodeSubject(nodeId: string, repos?: readonly ObjectRow[]): NodeConfigSubject | null;

package/dist/core/substrate/subject.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var n=(r,o)=>c(r,"name",{value:o,configurable:!0});import{getNode as l,getRow as i}from"../canvas/index.js";import{openDb as f}from"../canvas/db.js";import{reposForCwd as s}from"../graph/repo-sync/repos.js";import{effectiveScopes as a,scopeForCwd as m,profileNameFor as d}from"./subject-fields.js";import{effectiveScopes as x,scopeForCwd as C,profileNameFor as v}from"./subject-fields.js";function u(r){let o=r;const e=new Set;let t=0;for(;!e.has(o);){e.add(o);const p=i(o);if(p===null||p.parent==null)break;o=p.parent,t++}return t}n(u,"spineDepth");function N(r,o){const e=l(r);return e===null?null:{kind:e.kind,mode:e.mode,lifecycle:e.lifecycle,hasManager:(e.parent??null)!==null,cwd:e.cwd,scope:m(e.cwd),orchestration:{depth:u(r)},profile:d(e.profile_id),scopes:a(e.scopes),repo:(o??s(f(),e.cwd)).map(t=>t.name)}}n(N,"assembleNodeSubject");export{N as assembleNodeSubject,x as effectiveScopes,v as profileNameFor,C as scopeForCwd,u as spineDepth};

package/dist/core/termrender/code-doc.d.ts

@@ -0,0 +1,12 @@
+import { type RenderedDoc } from './termrender.js';
+export declare function isMarkdownFile(file: string): boolean;
+/** Fence info string for a source file — `text` when the extension is unknown,
+ *  which every highlighter degrades to plain text on. */
+export declare function fenceLanguageFor(file: string): string;
+/** Wrap source text as a fenced block. The fence is grown past the longest
+ *  backtick run in the content, so a file that itself contains ``` can't close
+ *  its own block. */
+export declare function codeFenceDocument(content: string, language: string): string;
+/** Render a source file as a syntax-highlighted code panel whose spans are
+ *  source lines — the code-file counterpart of `renderReviewDoc`. */
+export declare function codeRenderedDoc(content: string, language: string, width: number): RenderedDoc;

package/dist/core/termrender/code-doc.js

@@ -0,0 +1,5 @@
+var c=Object.defineProperty;var a=(t,s)=>c(t,"name",{value:s,configurable:!0});import{extname as i}from"node:path";import{documentLines as p}from"../document-lines.js";import{renderMarkdownWithMap as m}from"./termrender.js";const f={".ts":"typescript",".mts":"typescript",".cts":"typescript",".tsx":"tsx",".js":"javascript",".mjs":"javascript",".cjs":"javascript",".jsx":"jsx",".py":"python",".rb":"ruby",".go":"go",".rs":"rust",".java":"java",".c":"c",".h":"c",".cc":"cpp",".cpp":"cpp",".hpp":"cpp",".cs":"csharp",".swift":"swift",".kt":"kotlin",".php":"php",".lua":"lua",".pl":"perl",".sh":"bash",".bash":"bash",".zsh":"bash",".fish":"fish",".sql":"sql",".json":"json",".jsonc":"json",".yaml":"yaml",".yml":"yaml",".toml":"toml",".ini":"ini",".xml":"xml",".html":"html",".htm":"html",".css":"css",".scss":"scss",".less":"less",".vim":"vim",".el":"lisp",".ex":"elixir",".exs":"elixir",".erl":"erlang",".hs":"haskell",".scala":"scala",".dart":"dart",".r":"r",".jl":"julia",".zig":"zig",".tf":"terraform",".proto":"protobuf",".graphql":"graphql",".gql":"graphql",".dockerfile":"dockerfile",".diff":"diff",".patch":"diff",".csv":"text",".txt":"text",".log":"text",".env":"bash",".mk":"makefile"},h=new Set([".md",".markdown",".mdown",".mkd"]);function y(t){return h.has(i(t).toLowerCase())}a(y,"isMarkdownFile");function w(t){const s=i(t).toLowerCase();if(s===""){const r=t.slice(t.lastIndexOf("/")+1).toLowerCase();return r==="dockerfile"?"dockerfile":r==="makefile"?"makefile":"text"}return f[s]??"text"}a(w,"fenceLanguageFor");function u(t,s){let r=0;for(const e of t.matchAll(/`+/g))r=Math.max(r,e[0].length);const n="`".repeat(Math.max(3,r+1)),l=t.endsWith(`
+`)?t.slice(0,-1):t;return`${n}${s}
+${l}
+${n}
+`}a(u,"codeFenceDocument");function x(t,s){const r=s+2,n=a(e=>Math.max(1,Math.min(e-1,s)),"clamp"),l=t.spans.map(e=>e!==null&&(e[0]<=1||e[1]>=r));return{lines:t.lines,rows:t.rows.map((e,o)=>l[o]===!0?null:e),spans:t.spans.map((e,o)=>e===null||l[o]===!0?null:[n(e[0]),n(e[1])]),blocks:t.blocks.map(e=>({type:e.type,start:n(e.start),end:n(e.end)}))}}a(x,"foldFenceOffset");function b(t,s,r){const n=p(t).length;return x(m(u(t,s),r),n)}a(b,"codeRenderedDoc");export{u as codeFenceDocument,b as codeRenderedDoc,w as fenceLanguageFor,y as isMarkdownFile};

package/dist/core/termrender/display.d.ts

@@ -0,0 +1,16 @@
+/** Options for `display()` — the live-watch tmux pane surface. The pane always
+ *  watches the file and live-updates on edits; there is no non-watched mode. */
+export interface DisplayOpts {
+    /** `'auto'` (default) splits until the pane budget, then opens a new window. */
+    window?: 'auto' | 'split' | 'new';
+    /** Pane budget per window before `'auto'` opens a new window. Default 3. */
+    maxPanes?: number;
+}
+export type DisplayResult = {
+    paneId: string;
+    reason?: never;
+} | {
+    paneId?: never;
+    reason: string;
+};
+export declare function display(path: string, opts?: DisplayOpts): DisplayResult;

package/dist/core/termrender/display.js

@@ -0,0 +1,2 @@
+var c=Object.defineProperty;var a=(e,n)=>c(e,"name",{value:n,configurable:!0});import{envNodeId as m}from"../../shared/env.js";import{spawnSync as f}from"node:child_process";import{resolve as p}from"node:path";import{breakPane as w,closePane as P,currentTmux as x,paneOfNode as v,splitWindow as g}from"../runtime/placement-tmux.js";import{documentWatchCommand as I}from"./termrender.js";function h(){const e=process.env.TMUX_PANE;if(e!==void 0&&e!=="")return e;const n=m();if(n!==void 0&&n!==""){const t=v(n);if(t!==null)return t}return x()?.pane??null}a(h,"targetPane");function N(e){const n=f("tmux",["list-panes","-t",e,"-F","#{pane_id}"],{encoding:"utf8"});return n.status!==0?null:n.stdout.split(`
+`).filter(t=>t.trim()!=="").length}a(N,"countPanes");function $(e,n){const t=n?.window==="split"||n?.window==="new"?n.window:"auto",l=n?.maxPanes!==void 0&&n.maxPanes>0?n.maxPanes:3,u=I(p(e));if(u===null)return{reason:"renderer unavailable"};const o=h();if(o===null)return{reason:"no pane on screen"};let i=t==="new";if(t==="auto"){const d=N(o);if(d===null)return{reason:`tmux could not inspect target pane ${o}`};i=d>=l}const r=g(o,{cwd:process.cwd(),env:{},command:u});if(r===null)return{reason:`tmux could not split target pane ${o}`};if(!i)return{paneId:r};const s=w(r);return s!==null?{paneId:s.pane}:(P(r),{reason:"tmux could not move the document pane into a new window"})}a($,"display");export{$ as display};

package/dist/core/termrender/termrender.d.ts

@@ -0,0 +1,71 @@
+type RendererDiagnostic = (message: string) => void;
+/**
+ * Memoized, self-healing. Guarantees at most one authoritative renderer
+ * lifecycle per process: trust a valid stamp outright (zero subprocess spawns),
+ * else run ONE provision/verify/publish transition under the exclusive lock.
+ * There is no permanent legacy-verifier fallback — the spawn-based verify
+ * (`binaryOk` + `installedVersion`) is a step INSIDE that single transition,
+ * always followed by publishing the stamp, never a lasting alternate path.
+ *
+ * Single degradation path: `uv` absent → one stderr remediation line + plaintext.
+ * win32 → plaintext (no renderer).
+ *
+ * Invoked at postinstall AND lazily on the first render/check/display call,
+ * so `npm ci --ignore-scripts` consumers still self-heal on first use.
+ */
+export declare function ensureRenderer(report?: RendererDiagnostic): void;
+/** Cheap predicate — true when the pinned managed binary is verified ready. Does not install or spawn. */
+export declare function isRendererReady(): boolean;
+/** Render markdown to terminal lines via the pinned binary; plaintext fallback.
+ *  Callers own the returned array — every return is a fresh copy, so a caller
+ *  that appends to it cannot grow the cached render on the next hit. */
+export declare function renderMarkdown(md: string, width: number): string[];
+export interface RenderedDoc {
+    /** Rendered ANSI rows — byte-identical to the plain `doc render` output. */
+    lines: string[];
+    /** Per-row index into `blocks`; null for the blank separator rows between blocks. */
+    rows: (number | null)[];
+    /** Per-row finest 1-indexed inclusive source-line range the renderer knows
+     *  (a bullet, a table row, a code line…); null for separator rows and rows
+     *  of unmapped blocks. Same length as `lines`. */
+    spans: ([number, number] | null)[];
+    /** Per top-level block: its termrender block type plus 1-indexed inclusive
+     *  source-line bounds. Never empty. */
+    blocks: {
+        type: string;
+        start: number;
+        end: number;
+    }[];
+}
+/** Render markdown with a row→source-line map via the pinned binary
+ *  (`doc render --line-map`); plaintext paragraph-block fallback. */
+export declare function renderMarkdownWithMap(md: string, width: number): RenderedDoc;
+/**
+ * The shared block-aware mapped render: prose blocks keep the readability cap
+ * (`proseWidth`), while diagram blocks are re-rendered at the pane's full
+ * `paneWidth` and spliced back in by block index. Both surfaces (terminal
+ * review and the ask page) go through this, so "which blocks may be wide" is
+ * decided once, from the renderer's own block types, never by heuristics on
+ * the emitted rows.
+ *
+ * Row order, block list and source spans are the narrow render's; only the
+ * rows OF a wide block are replaced, so anchoring stays source-based and
+ * unchanged.
+ */
+export declare function renderMarkdownBlockAware(md: string, proseWidth: number, paneWidth: number): RenderedDoc;
+/** Block-aware render as plain rows, for surfaces that do not anchor. The rows
+ *  are the caller's own array: the block-aware render can pass the mapped
+ *  cache's line array straight through, and a caller appending to it would
+ *  otherwise poison every later render of the same document. */
+export declare function renderMarkdownBlockAwareLines(md: string, proseWidth: number, paneWidth: number): string[];
+/** Validate markdown via `termrender doc check`. */
+export declare function checkMarkdown(md: string): {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Shell command for a pane that live-renders `path` with crouter's pinned
+ *  termrender. Null means the managed renderer could not be provisioned. */
+export declare function documentWatchCommand(path: string): string | null;
+export {};

package/dist/core/termrender/termrender.js

@@ -0,0 +1,14 @@
+var j=Object.defineProperty;var a=(t,e)=>j(t,"name",{value:e,configurable:!0});import{execFileSync as g,spawnSync as G}from"node:child_process";import{existsSync as A,readFileSync as X,writeFileSync as Y,statSync as q,mkdirSync as Q,unlinkSync as C,renameSync as W,accessSync as Z,realpathSync as I,constants as ee}from"node:fs";import{homedir as te}from"node:os";import{join as b,resolve as re}from"node:path";import N from"string-width";import{shellQuote as V}from"../../shared/shell-quote.js";import{withExclusiveDirectoryLock as ne}from"../exclusive-lock.js";import{TERMRENDER_VERSION as v}from"./version.js";const R=b(re(process.env.XDG_CACHE_HOME||b(te(),".cache")),"crouter","termrender",v),E=b(R,"venv"),h=b(E,"bin/termrender"),m=b(E,"bin/python"),w=b(E,".crtr-termrender-stamp.json"),se=b(R,".crtr-termrender.lock"),ie=36e4;let f="unchecked";function T(t){const e=t;return!!e&&typeof e.mtimeMs=="number"&&typeof e.size=="number"&&typeof e.mode=="number"}a(T,"isFp");function S(t){try{const e=q(t);return{mtimeMs:e.mtimeMs,size:e.size,mode:e.mode}}catch{return null}}a(S,"fingerprint");function D(t,e){return!!t&&t.mtimeMs===e.mtimeMs&&t.size===e.size&&t.mode===e.mode}a(D,"fpMatch");function oe(){try{const t=JSON.parse(X(w,"utf8"));return t&&typeof t.version=="string"&&T(t.bin)&&T(t.python)&&typeof t.pythonRealpath=="string"?t:null}catch{return null}}a(oe,"readStamp");function le(t){const e=S(h),n=S(m);if(!e||!n){t(`[crtr] termrender stamp skipped: venv files vanished immediately after verify
+`);return}let r;try{r=I(m)}catch{r=m}const i={version:v,bin:e,python:n,pythonRealpath:r},o=`${w}.${process.pid}.tmp`;try{Y(o,JSON.stringify(i)),W(o,w)}catch(u){try{C(o)}catch{}t(`[crtr] termrender ready but stamp not persisted (${u instanceof Error?u.message:String(u)}); future launches will re-verify the slow way
+`)}}a(le,"publishStamp");function x(t){let e=!0;try{C(w)}catch(n){n.code!=="ENOENT"&&(e=!1)}f="unavailable",e?process.stderr.write(`[crtr] termrender invocation failed (${t}); invalidated readiness, future launches will repair
+`):process.stderr.write(`[crtr] termrender invocation failed (${t}) but its readiness marker could not be removed; future launches may keep trusting a broken renderer until ${w} is deleted
+`)}a(x,"invalidateRenderer");function B(t){const e=t;return e?.code==="ETIMEDOUT"||!!e?.killed&&!!e?.signal}a(B,"isTimeout");function _(){const t=oe();if(!t||t.version!==v)return!1;try{Z(h,ee.X_OK)}catch{return!1}if(!D(S(h),t.bin)||!D(S(m),t.python))return!1;try{if(I(m)!==t.pythonRealpath)return!1}catch{return!1}return!0}a(_,"stampValid");function ae(t,e){try{Q(R,{recursive:!0})}catch(n){f="unavailable",e(`[crtr] termrender unavailable \u2014 renderer cache cannot be created (${n instanceof Error?n.message:String(n)}); using plaintext fallback
+`);return}try{ne(se,t,{timeoutMs:ie})}catch{f="unavailable"}}a(ae,"withProvisionLock");function L(){if(!A(h))return!1;try{return g(h,["-h"],{encoding:"utf8",stdio:["ignore","pipe","pipe"],timeout:5e3}),!0}catch{return!1}}a(L,"binaryOk");function z(){if(!A(m))return null;try{return g(m,["-c",'import importlib.metadata as m; print(m.version("termrender"))'],{encoding:"utf8",stdio:["ignore","pipe","pipe"],timeout:5e3}).trim()||null}catch{return null}}a(z,"installedVersion");function ue(){try{return g("uv",["--version"],{stdio:"pipe",timeout:5e3}),!0}catch{return!1}}a(ue,"uvAvailable");function M(t=e=>process.stderr.write(e)){if(f==="unchecked"){if(process.platform==="win32"){f="unavailable";return}if(_()){f="ready";return}ce(t)}}a(M,"ensureRenderer");function ce(t){ae(()=>{if(_()){f="ready";return}let e=L()&&z()===v;if(!e){if(!ue()){t(`[crtr] termrender unavailable \u2014 install uv to enable rich rendering:
+  curl -LsSf https://astral.sh/uv/install.sh | sh
+`),f="unavailable";return}try{A(m)||g("uv",["venv","--clear",E],{stdio:"pipe",timeout:6e4}),g("uv",["pip","install","--reinstall","--python",m,`termrender==${v}`],{stdio:"pipe",timeout:12e4})}catch(n){t(`[crtr] termrender install failed (${n instanceof Error?n.message:String(n)}); using plaintext fallback
+`),f="unavailable";return}e=L()&&z()===v}if(!e){f="unavailable",t(`[crtr] termrender install completed but health check failed; using plaintext fallback
+`);return}le(t),f="ready"},t)}a(ce,"provisionAndPublish");function Me(){return f==="ready"?!0:f==="unavailable"?!1:process.platform!=="win32"&&_()}a(Me,"isRendererReady");const pe=/\x1b\[[0-9;?]*[a-zA-Z]|\x1b[@-_]|[\x00-\x08\x0B\x0E-\x1F\x7F-\x9F]/g;function F(t){return typeof t!="string"?"":t.replace(pe,"")}a(F,"sanitize");function fe(t,e){let n=0,r="";for(const i of t){const o=N(i);if(n+o>e)break;r+=i,n+=o}return r===""&&t.length>0&&(r=[...t][0]),r}a(fe,"sliceByWidth");function P(t,e){if(e<1)return[t];const n=[],r=t.split(`
+`);for(let i=0;i<r.length;i++){const o=r[i];if(o===""){n.push("");continue}const u=o.split(/[ \t]+/).filter(Boolean);let p="";for(let l of u){for(;N(l)>e;){p&&(n.push(p),p="");const c=fe(l,e);n.push(c),l=l.slice(c.length)}const s=p?`${p} ${l}`:l;N(s)<=e?p=s:(p&&n.push(p),p=l)}p&&n.push(p)}return n.length>0?n:[""]}a(P,"wrap");class H{static{a(this,"BoundedLRUCache")}map=new Map;maxEntries;constructor(e){this.maxEntries=e}get(e){if(!this.map.has(e))return;const n=this.map.get(e);return this.map.delete(e),this.map.set(e,n),n}set(e,n){if(this.map.has(e))this.map.delete(e);else if(this.map.size>=this.maxEntries){const r=this.map.keys().next().value;this.map.delete(r)}this.map.set(e,n)}}const $=new H(20);function Ae(t,e){const n=`${t}\0${e}`,r=$.get(n);if(r)return[...r];if(M(),f==="ready")try{const u=g(h,["doc","render","--width",String(e),"--color","on"],{input:t,encoding:"utf-8",timeout:5e3,stdio:["pipe","pipe","pipe"]}).split(`
+`);return u.length>0&&u[u.length-1]===""&&u.pop(),$.set(n,u),[...u]}catch(o){B(o)||x("doc render")}const i=P(F(t),e);return $.set(n,i),[...i]}a(Ae,"renderMarkdown");const K=new Set(["mermaid"]);function de(t,e){let n;try{n=JSON.parse(t)}catch{return null}const r=n;if(!Array.isArray(r.lines)||!Array.isArray(r.rows)||!Array.isArray(r.spans)||!Array.isArray(r.blocks)||r.rows.length!==r.lines.length||r.spans.length!==r.lines.length||!r.lines.every(s=>typeof s=="string"))return null;const i=r.blocks.length;if(!r.rows.every(s=>s===null||typeof s=="number"&&Number.isInteger(s)&&s>=0&&s<i))return null;const o=Math.max(1,e.split(`
+`).length),u=[];let p=0;for(const s of r.blocks){if(typeof s!="object"||s===null||typeof s.type!="string"||s.type===""||s.start!=null&&!Number.isInteger(s.start)||s.end!=null&&!Number.isInteger(s.end))return null;const c=typeof s.start=="number"?s.start:p+1,d=typeof s.end=="number"?Math.max(s.end,c):c,y=Math.max(1,Math.min(c,o)),k=Math.max(y,Math.min(d,o));u.push({type:s.type,start:y,end:k}),p=k}u.length===0&&u.push({type:"paragraph",start:1,end:o});const l=[];for(let s=0;s<r.spans.length;s++){const c=r.spans[s];if(c===null){l.push(null);continue}if(!Array.isArray(c)||c.length!==2)return null;const[d,y]=c;if(!Number.isInteger(d)||!Number.isInteger(y)||d<1||y<d||y>o)return null;const k=r.rows[s];if(k===null)return null;const O=u[k];if(d<O.start||y>O.end)return null;l.push([d,y])}return{lines:r.lines,rows:r.rows,spans:l,blocks:u}}a(de,"parseRenderedDoc");function he(t,e){const n=F(t).split(`
+`),r=[];let i=null;for(let l=0;l<n.length;l++)n[l].trim()!==""?i===null&&(i=l):i!==null&&(r.push({type:"paragraph",start:i+1,end:l}),i=null);i!==null&&r.push({type:"paragraph",start:i+1,end:n.length}),r.length===0&&r.push({type:"paragraph",start:1,end:Math.max(1,n.length)});const o=[],u=[],p=[];return r.forEach((l,s)=>{s>0&&(o.push(""),u.push(null),p.push(null));for(let c=l.start;c<=l.end;c++)for(const d of P(n[c-1]??"",e))o.push(d),u.push(s),p.push([c,c])}),{lines:o,rows:u,spans:p,blocks:r}}a(he,"fallbackDocWithMap");const J=new H(20);function U(t,e){const n=`${t}\0${e}`,r=J.get(n);if(r)return r;if(M(),f==="ready")try{const i=g(h,["doc","render","--width",String(e),"--color","on","--line-map"],{input:t,encoding:"utf-8",timeout:5e3,stdio:["pipe","pipe","pipe"],maxBuffer:67108864}),o=de(i.trim(),t);if(o!==null)return J.set(n,o),o;x("doc render --line-map (malformed output)")}catch(i){B(i)||x("doc render --line-map")}return he(t,e)}a(U,"renderMarkdownWithMap");function me(t,e,n){const r=U(t,e);if(n<=e||!r.blocks.some(l=>K.has(l.type)))return r;const i=U(t,n);if(i.blocks.length!==r.blocks.length)return r;const o=[],u=[],p=[];for(let l=0;l<r.lines.length;l++){const s=r.rows[l]??null;if(s===null||!K.has(r.blocks[s].type)){o.push(r.lines[l]),u.push(s),p.push(r.spans[l]??null);continue}if(l===0||r.rows[l-1]!==s)for(let c=0;c<i.lines.length;c++)i.rows[c]===s&&(o.push(i.lines[c]),u.push(s),p.push(i.spans[c]??null))}return{lines:o,rows:u,spans:p,blocks:r.blocks}}a(me,"renderMarkdownBlockAware");function Ne(t,e,n){return[...me(t,e,n).lines]}a(Ne,"renderMarkdownBlockAwareLines");function Re(t){if(M(),f!=="ready")return{ok:!0};const e=G(h,["doc","check"],{input:t,encoding:"utf-8",timeout:5e3});if(e.error)return e.error.code==="ETIMEDOUT"||e.signal==="SIGTERM"||x("doc check"),{ok:!1,error:`termrender: invocation failed: ${e.error.message}`};let n=null;const r=typeof e.stdout=="string"?e.stdout:"";if(r)try{n=JSON.parse(r.trim())}catch{}if(n!==null){if(n.ok)return{ok:!0};const i=Array.isArray(n.errors)?n.errors[0]:void 0;return{ok:!1,error:`termrender: ${i&&typeof i.message=="string"&&i.message?i.message:"invalid markdown"}`}}return e.status!==0?{ok:!1,error:`termrender: doc check exited ${e.status}`}:{ok:!0}}a(Re,"checkMarkdown");function _e(t){return M(),f!=="ready"?null:`${V(h)} doc watch ${V(t)}`}a(_e,"documentWatchCommand");export{Re as checkMarkdown,_e as documentWatchCommand,M as ensureRenderer,Me as isRendererReady,Ae as renderMarkdown,me as renderMarkdownBlockAware,Ne as renderMarkdownBlockAwareLines,U as renderMarkdownWithMap};

package/dist/core/termrender/version.d.ts

@@ -0,0 +1 @@
+export declare const TERMRENDER_VERSION = "4.12.12";

package/dist/core/termrender/version.js

@@ -0,0 +1 @@
+const E="4.12.12";export{E as TERMRENDER_VERSION};

package/dist/core/timing.d.ts

@@ -0,0 +1,11 @@
+/** True when CRTR_TIMING is set — guard expensive marker payloads with this. */
+export declare function timingEnabled(): boolean;
+/** Label this process in the timing log (e.g. 'viewer', 'broker'). */
+export declare function timingProc(name: string): void;
+/**
+ * Record one phase marker. Columns:
+ *   `+`  ms since the shared cross-process origin (the whole front-door clock)
+ *   `Δ`  ms since the previous marker in THIS process
+ *   `up` ms since this process started (same sense as broker `duration_ms`)
+ */
+export declare function mark(phase: string, fields?: Record<string, unknown>): void;

package/dist/core/timing.js

@@ -0,0 +1,2 @@
+var I=Object.defineProperty;var r=(e,n)=>I(e,"name",{value:n,configurable:!0});const v="CRTR_TIMING",u="CRTR_TIMING_T0";function T(){return performance.timeOrigin+performance.now()}r(T,"nowMs");const o=(()=>{const e=process.env[v];return e!==void 0&&e!==""&&e!=="0"&&e.toLowerCase()!=="false"})(),$=(()=>{if(!o)return 0;const e=Number(process.env[u]);if(Number.isFinite(e)&&e>0)return e;const n=performance.timeOrigin;return process.env[u]=String(n),n})(),g=(()=>{const e=process.env.CRTR_TIMING_PROC;return e!==void 0&&e!==""?e:process.argv[2]==="surface"&&process.argv[3]==="attach"?"viewer":"cli"})();let c=0;function _(){return o}r(_,"timingEnabled");function N(e){o&&(process.env.CRTR_TIMING_PROC=e)}r(N,"timingProc");function l(e,n){if(!o)return;const t=T(),p=t-$,a=c===0?p:t-c;c=t;const f=performance.now(),m=n===void 0?"":" "+Object.entries(n).map(([i,R])=>`${i}=${String(R)}`).join(" "),d=process.env.CRTR_TIMING_PROC??g,s=r(i=>i.toFixed(1).padStart(8),"fmt");process.stderr.write(`[timing] +${s(p)}ms \u0394${s(a)}ms up=${s(f)}ms t=${t.toFixed(1)} ${d}/${process.pid} ${e}${m}
+`)}r(l,"mark");export{l as mark,_ as timingEnabled,N as timingProc};

package/dist/core/tui/draw.d.ts

@@ -0,0 +1,103 @@
+export declare const META_FG = "38;5;246";
+export declare const RECESSIVE_FG = "38;5;243";
+export interface Size {
+    cols: number;
+    rows: number;
+}
+export interface Rect {
+    row: number;
+    col: number;
+    width: number;
+    height: number;
+}
+export interface Style {
+    fg?: string;
+    bg?: string;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    reverse?: boolean;
+}
+export interface Span {
+    text: string;
+    style?: Style;
+}
+/** An SGR fg/bg parameter is digits and semicolons only (e.g. '32', '1;36', '236').
+ *  Guards styleSpan against a non-numeric value (a color name) producing a broken
+ *  escape sequence. */
+export declare function isSgrParams(v: string): boolean;
+/** Style one chunk of text. Hue (fg/bg) is gated on `color`; bold/dim/reverse
+ *  are not. After the styled text we return to `lineBase` (not a bare reset) so a
+ *  row-level background/dim persists across spans instead of bleeding or being
+ *  cleared. */
+export declare function styleSpan(text: string, style: Style | undefined, color: boolean, lineBase: string): string;
+/** Assemble styled spans into one line clipped to `width` visible cols. When
+ *  `fill`, pad the remainder with spaces (under `lineBase`) so a cursor-row
+ *  background spans the full width. Always RESET-terminated so no color bleeds
+ *  into the next line. */
+export declare function assemble(spans: Span[], width: number, color: boolean, lineBase: string, fill: boolean): string;
+/** Truncate to `max` visible cols (plain text, no ANSI). */
+export declare function clip(text: string, max: number): string;
+export interface ColorCaps {
+    /** Any hue (fg/bg color) allowed. */
+    color: boolean;
+    /** 256-color bg allowed — drives the subtle cursor-row background. */
+    color256: boolean;
+}
+/** Detect color capability. Honors `NO_COLOR` and `TERM=dumb`, and only emits
+ *  hue when stdout is a TTY. `color256` additionally requires a 256/truecolor
+ *  terminal (for the cursor-row background; otherwise we fall back to reverse). */
+export declare function detectColorCaps(stream?: {
+    isTTY?: boolean;
+}, env?: NodeJS.ProcessEnv): ColorCaps;
+/** One pre-styled list row (the view styles its own spans; `list` windows + the
+ *  cursor highlight are the host's job). An optional `right` group is flush-right
+ *  on the row (e.g. a timestamp) via spansRight; the left `spans` are clipped to
+ *  leave room for it, and the cursor-row highlight merges over both. */
+export interface ListItemRow {
+    spans: Span[];
+    right?: Span[];
+    /** Optional continuation lines drawn under `spans` as part of the SAME item
+     *  (e.g. a wrapped subtitle). They share the item's cursor highlight and the
+     *  item still counts as one cursor position; the list windows by screen rows. */
+    lines?: Span[][];
+}
+/** Adjusted scroll the view stores back so the cursor stays visible. */
+export interface ListResult {
+    scroll: number;
+}
+export interface Draw {
+    readonly size: Size;
+    readonly caps: ColorCaps;
+    /** Styled spans at an absolute cell, clipped to maxWidth (default → edge). */
+    spans(row: number, col: number, spans: Span[], maxWidth?: number): void;
+    /** Flush-right span placement (mirror of `spans`): the group's last visible
+     *  cell lands just before `rightCol` (i.e. start col = rightCol − visibleWidth,
+     *  rightCol exclusive). If the group exceeds `maxWidth` (default → the room left
+     *  of rightCol) the LEFT end is clipped with a leading `…`. */
+    spansRight(row: number, rightCol: number, spans: Span[], maxWidth?: number): void;
+    /** Convenience single span. */
+    text(row: number, col: number, text: string, style?: Style): void;
+    /** Dim horizontal rule across [fromCol,toCol) (default full width). */
+    hline(row: number, fromCol?: number, toCol?: number, ch?: string): void;
+    /** Dim vertical rule down column `col` across [fromRow,toRow) (default full
+     *  height). `ch` defaults to `│`; pass `|` as the ASCII fallback. */
+    vline(col: number, fromRow?: number, toRow?: number, ch?: string): void;
+    /** Single-line box border around rect (optional title in the top edge). */
+    box(rect: Rect, title?: string): void;
+    /** Split a rect into N columns by weights. */
+    columns(rect: Rect, weights: number[]): Rect[];
+    /** Scrollable list within rect: windows `items` to fit height, highlights the
+     *  cursor row (256-bg or reverse fallback, like browse). Returns adjusted
+     *  scroll so the cursor stays visible — the view stores it in state. */
+    list(rect: Rect, items: ListItemRow[], cursor: number, scroll: number): ListResult;
+}
+/** A live Draw plus the host-side serializer. */
+export interface DrawHandle {
+    draw: Draw;
+    /** Serialize the buffer to a full repaint frame (home + per-line clear + clear
+     *  below) — identical framing to browse's renderFrame. */
+    frame(): string;
+}
+/** Create a screen-sized cell buffer + the absolute-cell Draw API over it. */
+export declare function createDraw(size: Size, caps: ColorCaps): DrawHandle;

package/dist/core/tui/draw.js

@@ -0,0 +1,2 @@
+var v=Object.defineProperty;var x=(r,n)=>v(r,"name",{value:n,configurable:!0});const V="\x1B[",w="\x1B[0m",A="\x1B[7m",I="\x1B[2m",D="\x1B[1m",_="\x1B[3m",W="38;5;246",j="38;5;243";function R(r){return r.length>0&&/^[0-9;]+$/.test(r)}x(R,"isSgrParams");function T(r,n,d,g){if(r==="")return"";let u="";return n?.dim&&(u+=I),n?.bold&&(u+=D),n?.italic&&(u+=_),n?.reverse&&(u+=A),d&&n?.fg&&R(n.fg)&&(u+=`\x1B[${n.fg}m`),d&&n?.bg&&R(n.bg)&&(u+=`\x1B[48;5;${n.bg}m`),u===""?r:`${u}${r}${w}${g}`}x(T,"styleSpan");function H(r,n,d,g,u){let m=0,y="";for(const E of r){if(m>=n)break;if(E.text==="")continue;let $=E.text;const b=n-m;let S=!1;if($.length>b&&($=$.slice(0,Math.max(0,b-1))+"\u2026",S=!0),y+=T($,E.style,d,g),m+=$.length,S)break}return u&&m<n&&(y+=" ".repeat(n-m)),g===""?y:`${g}${y}${w}`}x(H,"assemble");function J(r,n){return n<=0?"":r.length<=n?r:r.slice(0,Math.max(0,n-1))+"\u2026"}x(J,"clip");function K(r=process.stdout,n=process.env){const d=n.TERM??"",g=r.isTTY===!0&&!n.NO_COLOR&&d!=="dumb",u=n.COLORTERM??"",m=g&&(/256|direct/i.test(d)||/truecolor|24bit/i.test(u));return{color:g,color256:m}}x(K,"detectColorCaps");function z(r,n){return n?{fg:n.fg??r.fg,bg:n.bg??r.bg,bold:n.bold||r.bold,dim:n.dim||r.dim,italic:n.italic||r.italic,reverse:n.reverse||r.reverse}:r}x(z,"mergeStyle");function k(r,n){return r===n?!0:!r||!n?!1:r.fg===n.fg&&r.bg===n.bg&&!!r.bold==!!n.bold&&!!r.dim==!!n.dim&&!!r.italic==!!n.italic&&!!r.reverse==!!n.reverse}x(k,"sameStyle");function N(r,n){const d=Math.max(1,r.cols),g=Math.max(1,r.rows),u=[];for(let t=0;t<g;t++){const e=new Array(d);for(let o=0;o<d;o++)e[o]={ch:" ",style:void 0};u.push(e)}const m=x((t,e,o,i,f)=>{if(t<0||t>=g)return;const c=d-e,s=Math.min(i??c,c);if(s<=0)return;let l=e,M=0;for(const h of o){if(M>=s)break;const a=f?z(f,h.style):h.style;for(const p of Array.from(h.text)){if(M>=s)break;l>=0&&l<d&&(u[t][l]={ch:p,style:a}),l++,M++}}},"place"),y=x((t,e,o,i)=>{if(t<0||t>=g)return;const f=Math.min(d,e+o);for(let c=Math.max(0,e);c<f;c++)u[t][c]={ch:" ",style:i}},"fillStyle"),E=x(t=>{let e=0;for(const o of t)e+=Array.from(o.text).length;return e},"spanWidth"),$=x(t=>{const e=[];for(const o of t){const i=e[e.length-1];i&&k(i.style,o.style)?i.text+=o.ch:e.push({text:o.ch,style:o.style})}return e},"regroup"),b=x((t,e,o,i,f)=>{if(t<0||t>=g)return;const c=Math.max(0,e),s=Math.min(i??c,c);if(s<=0)return;let l=[];for(const h of o)for(const a of Array.from(h.text))l.push({ch:a,style:h.style});if(l.length===0)return;if(l.length>s){const h=l.length-s+1;l=l.slice(h),l.unshift({ch:"\u2026",style:l[0]?.style})}const M=e-l.length;m(t,M,$(l),void 0,f)},"placeRight"),S={size:{cols:d,rows:g},caps:n,spans(t,e,o,i){m(t,e,o,i)},spansRight(t,e,o,i){b(t,e,o,i)},text(t,e,o,i){m(t,e,[{text:o,style:i}],void 0)},hline(t,e=0,o=d,i="\u2500"){if(t<0||t>=g)return;const f=Math.max(0,Math.min(d,e)),c=Math.max(0,Math.min(d,o));for(let s=f;s<c;s++)u[t][s]={ch:i,style:{dim:!0}}},vline(t,e=0,o=g,i="\u2502"){if(t<0||t>=d)return;const f=Math.max(0,Math.min(g,e)),c=Math.max(0,Math.min(g,o));for(let s=f;s<c;s++)u[s][t]={ch:i,style:{dim:!0}}},box(t,e){const{row:o,col:i,width:f,height:c}=t;if(f<2||c<2)return;const s={dim:!0},l=i+f-1,M=o+c-1,h="\u2500".repeat(Math.max(0,f-2));m(o,i,[{text:`\u250C${h}\u2510`,style:s}],f),m(M,i,[{text:`\u2514${h}\u2518`,style:s}],f);for(let a=o+1;a<M;a++)m(a,i,[{text:"\u2502",style:s}],1),m(a,l,[{text:"\u2502",style:s}],1);e!==void 0&&e!==""&&f>4&&m(o,i+2,[{text:` ${e} `}],f-4)},columns(t,e){const o=e.length;if(o===0)return[];const i=e.reduce((l,M)=>l+(M>0?M:0),0)||1,f=[];let c=t.col,s=0;for(let l=0;l<o;l++){const h=l===o-1?Math.max(0,t.width-s):Math.max(0,Math.floor(t.width*Math.max(0,e[l])/i));f.push({row:t.row,col:c,width:h,height:t.height}),c+=h,s+=h}return f},list(t,e,o,i){const f=Math.max(0,t.height),c=x(h=>1+(e[h]?.lines?.length??0),"rowsOf");let s=i;if(s<0&&(s=0),s>Math.max(0,e.length-1)&&(s=Math.max(0,e.length-1)),f>0)for(o<s&&(s=o);;){let h=0;for(let a=s;a<=o&&a<e.length;a++)h+=c(a);if(h<=f||s>=o)break;s++}let l=t.row;const M=t.row+f;for(let h=s;h<e.length&&l<M;h++){const a=e[h],p=h===o?n.color256?{bg:"236"}:{reverse:!0}:void 0;if(p&&y(l,t.col,t.width,p),a.right&&a.right.length){const C=E(a.right),O=Math.max(0,t.width-C-1);m(l,t.col,a.spans,O,p),b(l,t.col+t.width,a.right,C,p)}else m(l,t.col,a.spans,t.width,p);l++;for(const C of a.lines??[]){if(l>=M)break;p&&y(l,t.col,t.width,p),m(l,t.col,C,t.width,p),l++}}return{scroll:s}}},L=x(t=>{let e=-1;for(let f=t.length-1;f>=0;f--){const c=t[f];if(c.ch!==" "||c.style!==void 0){e=f;break}}if(e<0)return"";let o="",i=0;for(;i<=e;){const f=t[i].style;let c="";for(;i<=e&&k(t[i].style,f);)c+=t[i].ch,i++;o+=T(c,f,n.color,"")}return o},"serializeRow");return{draw:S,frame:x(()=>`\x1B[H${u.map(e=>`${L(e)}\x1B[K`).join(`\r
+`)}\x1B[J`,"frame")}}x(N,"createDraw");export{W as META_FG,j as RECESSIVE_FG,H as assemble,J as clip,N as createDraw,K as detectColorCaps,R as isSgrParams,T as styleSpan};

package/dist/core/tui/fuzzy.d.ts

@@ -0,0 +1,9 @@
+/** Case-insensitive subsequence match: every char of `query` appears in `text`
+ *  in order (gaps allowed). Empty query matches everything. Substrings are a
+ *  subsequence, so this subsumes substring matching too. */
+export declare function fuzzyMatch(query: string, text: string): boolean;
+/** Indices in `text` consumed by a greedy left-to-right subsequence match of
+ *  `query` — the same walk as `fuzzyMatch`, but returning WHICH chars matched so
+ *  the renderer can highlight them. Empty set when `query` is empty OR does not
+ *  fully match (no partial highlights). */
+export declare function matchIndices(query: string, text: string): Set<number>;

package/dist/core/tui/fuzzy.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var l=(n,i)=>f(n,"name",{value:i,configurable:!0});function a(n,i){if(n==="")return!0;const t=n.toLowerCase(),r=i.toLowerCase();let o=0;for(let e=0;e<r.length&&o<t.length;e++)r[e]===t[o]&&o++;return o===t.length}l(a,"fuzzyMatch");function h(n,i){const t=new Set;if(n==="")return t;const r=n.toLowerCase(),o=i.toLowerCase();let e=0;for(let c=0;c<o.length&&e<r.length;c++)o[c]===r[e]&&(t.add(c),e++);return e<r.length&&t.clear(),t}l(h,"matchIndices");export{a as fuzzyMatch,h as matchIndices};