@north-light/crouter 0.3.349 → 0.3.350

package/dist/core/substrate/injected-store.js

@@ -1 +1,2 @@
-var j=Object.defineProperty;var o=(e,t)=>j(e,"name",{value:t,configurable:!0});import{createHash as T}from"node:crypto";import{existsSync as g,readFileSync as M,rmSync as R}from"node:fs";import{injectedDocsPath as S}from"../canvas/paths.js";import{atomicWriteJson as z,realpathOrSelf as d}from"../fs-utils.js";import{rungRank as w}from"./schema.js";const D=w("content"),f=new Map;function h(){return{preferenceSnapshot:null,exposures:new Map}}o(h,"emptyContextExposureState");function b(e,t){return{state:e,source:t}}o(b,"exposureTarget");function u(e){return typeof e=="number"&&Number.isInteger(e)&&e>=1&&e<=D}o(u,"validRank");function F(e){return Math.max(e?.system??0,e?.transcript??0)}o(F,"activeRank");function C(e,t,r){return F(e.exposures.get(t))>=w(r)}o(C,"exposedAtOrAbove");function m(e,t,r){const n=w(r);if(n===0)return;const s=e.state.exposures.get(t)??{};(s[e.source]??0)>=n||e.state.exposures.set(t,{...s,[e.source]:n})}o(m,"registerExposure");function v(e){const t=e.trim();return t===""?null:`content-sha256:${T("sha256").update(t).digest("hex")}`}o(v,"contentExposureIdentity");function G(e,t,r,n){if(C(e,d(t),n))return!0;const s=v(r);return s!==null&&C(e,s,n)}o(G,"documentExposedAtOrAbove");function L(e,t,r,n){m(e,d(t),n);const s=v(r);s!==null&&m(e,s,n)}o(L,"registerDocumentExposure");function O(e,t){const r=e.exposures.get(t);r!==void 0&&(u(r.system)?e.exposures.set(t,{system:r.system}):e.exposures.delete(t))}o(O,"dropTranscriptExposure");function N(e,t,r){O(e,d(t));const n=v(r);n!==null&&O(e,n)}o(N,"demoteDocumentTranscriptExposure");function Q(e,t){return e.preferenceSnapshot===null&&(e.preferenceSnapshot=t),e.preferenceSnapshot}o(Q,"freezePreferenceSnapshot");function U(e){return{preferenceSnapshot:e.preferenceSnapshot,exposures:new Map([...e.exposures].map(([t,r])=>[t,{...r}]))}}o(U,"cloneContextExposureState");function V(e){return[...e.exposures.values()].some(t=>u(t.transcript))}o(V,"hasTranscriptExposure");function J(e){const t=h(),r=b(t,"transcript");for(const[n,s]of e.exposures){const p=s.transcript;u(p)&&m(r,n,p===1?"name":p===2?"preview":"content")}return t}o(J,"cloneTranscriptExposureState");function k(e,t){e.preferenceSnapshot=t.preferenceSnapshot,e.exposures.clear();for(const[r,n]of t.exposures)e.exposures.set(r,{...n})}o(k,"replaceContextExposureState");function X(e,t){if(e.preferenceSnapshot!==t.preferenceSnapshot||e.exposures.size!==t.exposures.size)return!1;for(const[r,n]of e.exposures){const s=t.exposures.get(r);if(n.system!==s?.system||n.transcript!==s?.transcript)return!1}return!0}o(X,"contextExposureStatesEqual");function Y(e,t){if(e.preferenceSnapshot!==null&&t.preferenceSnapshot!==null&&e.preferenceSnapshot!==t.preferenceSnapshot)throw new Error("context exposure state contains conflicting preference snapshots");e.preferenceSnapshot===null&&t.preferenceSnapshot!==null&&(e.preferenceSnapshot=t.preferenceSnapshot);for(const[r,n]of t.exposures){const s=e.exposures.get(r)??{},p=Math.max(s.system??0,n.system??0),a=Math.max(s.transcript??0,n.transcript??0);e.exposures.set(r,{...p>0?{system:p}:{},...a>0?{transcript:a}:{}})}}o(Y,"mergeContextExposureState");function Z(e){let t=f.get(e);return t===void 0&&(t=$(e),f.set(e,t)),t}o(Z,"sharedContextExposureState");function $(e){const t=S(e);let r;try{r=JSON.parse(M(t,"utf8"))}catch(c){if(c.code==="ENOENT")return h();throw new Error(`failed to read context exposure state at ${t}: ${c instanceof Error?c.message:String(c)}`)}const n=h(),s=b(n,"transcript");if(Array.isArray(r)){for(const c of r){if(typeof c!="string")throw new Error(`invalid v1 context exposure state at ${t}`);m(s,c,"content")}return n}if(r===null||typeof r!="object")throw new Error(`invalid context exposure state at ${t}`);const p=r;if(p.v===3){const c=p.preferenceSnapshot,i=p.exposures;if(c!==null&&typeof c!="string"||i===null||typeof i!="object"||Array.isArray(i))throw new Error(`invalid v3 context exposure state at ${t}`);n.preferenceSnapshot=c;for(const[E,y]of Object.entries(i)){if(y===null||typeof y!="object"||Array.isArray(y))throw new Error(`invalid v3 exposure entry '${E}' at ${t}`);const A=y,x=A.system,l=A.transcript;if(x!==void 0&&!u(x)||l!==void 0&&!u(l)||x===void 0&&l===void 0)throw new Error(`invalid v3 exposure ranks for '${E}' at ${t}`);n.exposures.set(E,{...u(x)?{system:x}:{},...u(l)?{transcript:l}:{}})}return n}if(p.v!==2)throw new Error(`unsupported context exposure state at ${t}`);const a=p.docs;if(a===null||typeof a!="object"||Array.isArray(a))throw new Error(`invalid v2 context exposure state at ${t}`);for(const[c,i]of Object.entries(a)){if(!u(i))throw new Error(`invalid v2 exposure rank for '${c}' at ${t}`);m(s,c,i===1?"name":i===2?"preview":"content")}return n}o($,"loadContextExposureState");function P(e,t){z(S(e),{v:3,preferenceSnapshot:t.preferenceSnapshot,exposures:Object.fromEntries(t.exposures)})}o(P,"saveContextExposureState");function I(e){const t=f.get(e);t!==void 0&&k(t,h()),R(S(e),{force:!0})}o(I,"clearContextExposureState");function ee(e,t){if(g(S(e))){const s=$(e),p=f.get(e);p===void 0?f.set(e,s):k(p,s);return}const r=t===null?h():J($(t)),n=f.get(e);n===void 0?f.set(e,r):k(n,r),P(e,r)}o(ee,"initializeForkContextExposure");export{I as clearContextExposureState,U as cloneContextExposureState,J as cloneTranscriptExposureState,v as contentExposureIdentity,X as contextExposureStatesEqual,N as demoteDocumentTranscriptExposure,G as documentExposedAtOrAbove,h as emptyContextExposureState,C as exposedAtOrAbove,b as exposureTarget,Q as freezePreferenceSnapshot,V as hasTranscriptExposure,ee as initializeForkContextExposure,$ as loadContextExposureState,Y as mergeContextExposureState,L as registerDocumentExposure,m as registerExposure,k as replaceContextExposureState,P as saveContextExposureState,Z as sharedContextExposureState};
+var T=Object.defineProperty;var s=(e,t)=>T(e,"name",{value:t,configurable:!0});import{createHash as M}from"node:crypto";import{injectedDocsPath as S,nodeRunDir as d}from"../canvas/paths.js";import{realpathOrSelf as w}from"../fs-utils.js";import{existsBeneath as g,readFileBeneath as B,setModeBeneath as R,statBeneath as z,unlinkBeneath as D,writeFileBeneath as N}from"../spaces/open-beneath.js";import{rungRank as v}from"./schema.js";function V(e){return{preferenceSnapshot:e.preferenceSnapshot,exposures:Object.fromEntries(e.exposures)}}s(V,"snapshotContextExposure");function W(e){if(e===null||typeof e!="object"||e.preferenceSnapshot!==null&&typeof e.preferenceSnapshot!="string"||e.exposures===null||typeof e.exposures!="object"||Array.isArray(e.exposures))throw new Error("invalid context exposure snapshot");const t=x();t.preferenceSnapshot=e.preferenceSnapshot;for(const[r,n]of Object.entries(e.exposures)){if(n===null||typeof n!="object"||Array.isArray(n)||n.system===void 0&&n.transcript===void 0||n.system!==void 0&&!u(n.system)||n.transcript!==void 0&&!u(n.transcript))throw new Error(`invalid context exposure ranks for '${r}'`);t.exposures.set(r,{...n})}return t}s(W,"restoreContextExposure");const F=v("content"),a=new Map;function x(){return{preferenceSnapshot:null,exposures:new Map}}s(x,"emptyContextExposureState");function $(e,t,r){return r===void 0?{state:e,source:t}:{state:e,source:t,loads:r}}s($,"exposureTarget");function u(e){return typeof e=="number"&&Number.isInteger(e)&&e>=1&&e<=F}s(u,"validRank");function J(e){return Math.max(e?.system??0,e?.transcript??0)}s(J,"activeRank");function O(e,t,r){return J(e.exposures.get(t))>=v(r)}s(O,"exposedAtOrAbove");function y(e,t,r){const n=v(r);if(n===0)return;const o=e.state.exposures.get(t)??{};(o[e.source]??0)>=n||e.state.exposures.set(t,{...o,[e.source]:n})}s(y,"registerExposure");function b(e){const t=e.trim();return t===""?null:`content-sha256:${M("sha256").update(t).digest("hex")}`}s(b,"contentExposureIdentity");function P(e,t,r,n){if(O(e,w(t),n))return!0;const o=b(r);return o!==null&&O(e,o,n)}s(P,"documentExposedAtOrAbove");function X(e,t,r){const{path:n,body:o}=t;r==="content"&&e.loads!==void 0&&!P(e.state,n,o,"content")&&e.loads.push({name:t.name,scope:t.scope}),y(e,w(n),r);const p=b(o);p!==null&&y(e,p,r)}s(X,"registerDocumentExposure");function j(e,t){const r=e.exposures.get(t);r!==void 0&&(u(r.system)?e.exposures.set(t,{system:r.system}):e.exposures.delete(t))}s(j,"dropTranscriptExposure");function Y(e,t,r){j(e,w(t));const n=b(r);n!==null&&j(e,n)}s(Y,"demoteDocumentTranscriptExposure");function Z(e,t){return e.preferenceSnapshot===null&&(e.preferenceSnapshot=t),e.preferenceSnapshot}s(Z,"freezePreferenceSnapshot");function I(e){return{preferenceSnapshot:e.preferenceSnapshot,exposures:new Map([...e.exposures].map(([t,r])=>[t,{...r}]))}}s(I,"cloneContextExposureState");function ee(e){return[...e.exposures.values()].some(t=>u(t.transcript))}s(ee,"hasTranscriptExposure");function q(e){const t=x(),r=$(t,"transcript");for(const[n,o]of e.exposures){const p=o.transcript;u(p)&&y(r,n,p===1?"name":p===2?"preview":"content")}return t}s(q,"cloneTranscriptExposureState");function k(e,t){e.preferenceSnapshot=t.preferenceSnapshot,e.exposures.clear();for(const[r,n]of t.exposures)e.exposures.set(r,{...n})}s(k,"replaceContextExposureState");function te(e,t){if(e.preferenceSnapshot!==t.preferenceSnapshot||e.exposures.size!==t.exposures.size)return!1;for(const[r,n]of e.exposures){const o=t.exposures.get(r);if(n.system!==o?.system||n.transcript!==o?.transcript)return!1}return!0}s(te,"contextExposureStatesEqual");function re(e,t){if(e.preferenceSnapshot!==null&&t.preferenceSnapshot!==null&&e.preferenceSnapshot!==t.preferenceSnapshot)throw new Error("context exposure state contains conflicting preference snapshots");e.preferenceSnapshot===null&&t.preferenceSnapshot!==null&&(e.preferenceSnapshot=t.preferenceSnapshot);for(const[r,n]of t.exposures){const o=e.exposures.get(r)??{},p=Math.max(o.system??0,n.system??0),i=Math.max(o.transcript??0,n.transcript??0);e.exposures.set(r,{...p>0?{system:p}:{},...i>0?{transcript:i}:{}})}}s(re,"mergeContextExposureState");function ne(e){let t=a.get(e);return t===void 0&&(t=x(),a.set(e,t)),t}s(ne,"sharedContextExposureState");function C(e){const t=S(e);let r;try{r=JSON.parse(B(d(e),t).toString("utf8"))}catch(c){if(c.code==="ENOENT")return x();throw new Error(`failed to read context exposure state at ${t}: ${c instanceof Error?c.message:String(c)}`)}const n=x(),o=$(n,"transcript");if(Array.isArray(r)){for(const c of r){if(typeof c!="string")throw new Error(`invalid v1 context exposure state at ${t}`);y(o,c,"content")}return n}if(r===null||typeof r!="object")throw new Error(`invalid context exposure state at ${t}`);const p=r;if(p.v===3){const c=p.preferenceSnapshot,f=p.exposures;if(c!==null&&typeof c!="string"||f===null||typeof f!="object"||Array.isArray(f))throw new Error(`invalid v3 context exposure state at ${t}`);n.preferenceSnapshot=c;for(const[E,m]of Object.entries(f)){if(m===null||typeof m!="object"||Array.isArray(m))throw new Error(`invalid v3 exposure entry '${E}' at ${t}`);const A=m,h=A.system,l=A.transcript;if(h!==void 0&&!u(h)||l!==void 0&&!u(l)||h===void 0&&l===void 0)throw new Error(`invalid v3 exposure ranks for '${E}' at ${t}`);n.exposures.set(E,{...u(h)?{system:h}:{},...u(l)?{transcript:l}:{}})}return n}if(p.v!==2)throw new Error(`unsupported context exposure state at ${t}`);const i=p.docs;if(i===null||typeof i!="object"||Array.isArray(i))throw new Error(`invalid v2 context exposure state at ${t}`);for(const[c,f]of Object.entries(i)){if(!u(f))throw new Error(`invalid v2 exposure rank for '${c}' at ${t}`);y(o,c,f===1?"name":f===2?"preview":"content")}return n}s(C,"loadContextExposureState");function H(e,t){const r=d(e),n=S(e);let o=384;try{o=z(r,n).mode&511}catch(i){if(i.code!=="ENOENT")throw i}const p=`${JSON.stringify({v:3,preferenceSnapshot:t.preferenceSnapshot,exposures:Object.fromEntries(t.exposures)},null,2)}
+`;N(r,n,p,{atomic:!0,mode:o}),R(r,n,o)}s(H,"saveContextExposureState");function oe(e){const t=a.get(e);t!==void 0&&k(t,x());try{D(d(e),S(e))}catch(r){if(r.code!=="ENOENT")throw r}}s(oe,"clearContextExposureState");function se(e,t){if(g(d(e),S(e))){const o=C(e),p=a.get(e);p===void 0?a.set(e,o):k(p,o);return}const r=t===null?x():q(C(t)),n=a.get(e);n===void 0?a.set(e,r):k(n,r),H(e,r)}s(se,"initializeForkContextExposure");export{oe as clearContextExposureState,I as cloneContextExposureState,q as cloneTranscriptExposureState,b as contentExposureIdentity,te as contextExposureStatesEqual,Y as demoteDocumentTranscriptExposure,P as documentExposedAtOrAbove,x as emptyContextExposureState,O as exposedAtOrAbove,$ as exposureTarget,Z as freezePreferenceSnapshot,ee as hasTranscriptExposure,se as initializeForkContextExposure,C as loadContextExposureState,re as mergeContextExposureState,X as registerDocumentExposure,y as registerExposure,k as replaceContextExposureState,W as restoreContextExposure,H as saveContextExposureState,ne as sharedContextExposureState,V as snapshotContextExposure};

package/dist/core/substrate/listings.js

@@ -1 +1 @@
-var h=Object.defineProperty;var o=(e,n)=>h(e,"name",{value:n,configurable:!0});import{buildMemoryTree as a}from"../memory/tree.js";import{parseSubstrateDoc as x,previewLine as D}from"./schema.js";import{documentExposedAtOrAbove as b,registerDocumentExposure as w}from"./injected-store.js";function A(e){return`dir://${e}`}o(A,"dirDedupKey");function E(e){const n=new Map;for(const t of e)n.has(t.name)||n.set(t.name,t);return n}o(E,"docsByName");const f=new WeakMap;function p(e){const n=f.get(e);if(n!==void 0)return n;const t=a([...e.values()]);return f.set(e,t),t}o(p,"treeFor");function y(e,n){return n!==""&&p(e).isDirectory(n)}o(y,"isDirName");function v(e){const n=[],t=e.split("/");for(let r=t.length-1;r>=1;r--)n.push(t.slice(0,r).join("/"));return n}o(v,"ancestorDirsOf");function O(e,n){return[...y(e,n)?[n]:[],...v(n)]}o(O,"docListingDirs");function d(e,n,t){const r=x(e);return r?.unlisted||t&&n!==null&&b(n.state,e.path,e.body,"preview")?null:(n!==null&&w(n,e.path,e.body,"preview"),r===null?"":D(r))}o(d,"previewSuffix");function m(e,n){return n===null||n===""?`[[${e}]]`:`[[${e}]]: ${n}`}o(m,"line");function S(e,n,t,r,l){const s=p(e).node(n);if(s===null)return[];const c=[];for(const u of s.childDocuments){const i=d(u.document,t,r);i!==null&&(l?.(u.document),c.push(m(u.name,i)))}for(const u of s.childDirectories){const i=u.document===null?null:d(u.document,t,r);u.document!==null&&i!==null&&l?.(u.document),c.push(m(u.name,i))}return c}o(S,"renderDirListing");export{v as ancestorDirsOf,A as dirDedupKey,O as docListingDirs,E as docsByName,y as isDirName,S as renderDirListing};
+var h=Object.defineProperty;var o=(e,n)=>h(e,"name",{value:n,configurable:!0});import{buildMemoryTree as x}from"../memory/tree.js";import{parseSubstrateDoc as D,previewLine as a}from"./schema.js";import{documentExposedAtOrAbove as b,registerDocumentExposure as w}from"./injected-store.js";function A(e){return`dir://${e}`}o(A,"dirDedupKey");function E(e){const n=new Map;for(const t of e)n.has(t.name)||n.set(t.name,t);return n}o(E,"docsByName");const f=new WeakMap;function p(e){const n=f.get(e);if(n!==void 0)return n;const t=x([...e.values()]);return f.set(e,t),t}o(p,"treeFor");function v(e,n){return n!==""&&p(e).isDirectory(n)}o(v,"isDirName");function y(e){const n=[],t=e.split("/");for(let r=t.length-1;r>=1;r--)n.push(t.slice(0,r).join("/"));return n}o(y,"ancestorDirsOf");function O(e,n){return[...v(e,n)?[n]:[],...y(n)]}o(O,"docListingDirs");function d(e,n,t){const r=D(e);return r?.unlisted||t&&n!==null&&b(n.state,e.path,e.body,"preview")?null:(n!==null&&w(n,e,"preview"),r===null?"":a(r))}o(d,"previewSuffix");function m(e,n){return n===null||n===""?`[[${e}]]`:`[[${e}]]: ${n}`}o(m,"line");function S(e,n,t,r,l){const s=p(e).node(n);if(s===null)return[];const c=[];for(const u of s.childDocuments){const i=d(u.document,t,r);i!==null&&(l?.(u.document),c.push(m(u.name,i)))}for(const u of s.childDirectories){const i=u.document===null?null:d(u.document,t,r);u.document!==null&&i!==null&&l?.(u.document),c.push(m(u.name,i))}return c}o(S,"renderDirListing");export{y as ancestorDirsOf,A as dirDedupKey,O as docListingDirs,E as docsByName,v as isDirName,S as renderDirListing};

package/dist/core/substrate/memory-events.d.ts

@@ -0,0 +1,6 @@
+import type { MemoryReadEventDTO } from '../../api/dto/analytics.js';
+import type { MemoryLoad } from './injected-store.js';
+export declare function memoryEvents(loads: readonly MemoryLoad[], type: MemoryReadEventDTO['type'], at?: string): MemoryReadEventDTO[];
+/** One POST for all of `events`; resolves (never rejects) whether or not crtrd
+ *  recorded them. Sends nothing when there is nothing to record. */
+export declare function sendMemoryEvents(nodeId: string, events: MemoryReadEventDTO[]): Promise<void>;

package/dist/core/substrate/memory-events.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var r=(o,t)=>i(o,"name",{value:t,configurable:!0});import{localClient as c}from"../../api/node-transport.js";function s(o,t,e=new Date().toISOString()){return o.map(({name:n,scope:a})=>({name:n,scope:a,at:e,type:t}))}r(s,"memoryEvents");async function u(o,t){if(t.length!==0)try{await c({autostart:!1,coldStartPollWindowMs:0,timeoutMs:500}).recordMemoryReads(o,{events:t})}catch{}}r(u,"sendMemoryEvents");export{s as memoryEvents,u as sendMemoryEvents};

package/dist/core/substrate/on-read-node.js

@@ -1 +1 @@
-var s=Object.defineProperty;var n=(e,t)=>s(e,"name",{value:t,configurable:!0});import{getNode as i}from"../canvas/index.js";import{emptyContextExposureState as c,exposureTarget as u}from"./injected-store.js";import{assembleNodeSubject as p}from"./subject.js";import{renderOnReadDocsForSubject as a,renderWorkspaceOpenDocsForSubject as l}from"./on-read.js";function x(e,t,o=u(c(),"transcript")){let r;try{r=p(e)}catch{return""}return r===null?"":a(r,t,o)}n(x,"renderOnReadDocs");function D(e,t=u(c(),"transcript")){try{const o=p(e),r=i(e);return o===null||r===null?"":l(o,r.cwd,r.profile_id??null,t)}catch{return""}}n(D,"renderWorkspaceOpenDocs");export{x as renderOnReadDocs,D as renderWorkspaceOpenDocs};
+var i=Object.defineProperty;var n=(e,t)=>i(e,"name",{value:t,configurable:!0});import{getNode as m}from"../canvas/index.js";import{appForNode as s}from"../canvas/node-agent-paths.js";import{automaticMemoryTarget as a}from"../spaces/permissions.js";import{emptyContextExposureState as c,exposureTarget as p}from"./injected-store.js";import{assembleNodeSubject as u}from"./subject.js";import{renderOnReadDocsForSubject as f,renderWorkspaceOpenDocsForSubject as l}from"./on-read.js";function S(e,t,o=p(c(),"transcript")){let r;try{r=u(e)}catch{return""}return r===null?"":f(r,t,o)}n(S,"renderOnReadDocs");function y(e,t=p(c(),"transcript")){const o=u(e),r=m(e);return o===null||r===null?"":l(o,r.cwd,r.profile_id??null,t,void 0,a({...r,grantee:s(e)}))}n(y,"renderWorkspaceOpenDocs");export{S as renderOnReadDocs,y as renderWorkspaceOpenDocs};

package/dist/core/substrate/on-read.d.ts

@@ -57,8 +57,8 @@ export declare function contentReadAttachments(doc: Pick<SubstrateDoc, 'name' |
 export declare function renderAutoLoadedContext(blocks: readonly string[]): string;
 /** Surface docs whose `read` entries match a successfully read file, using
  * the caller-supplied daemon snapshot subject. */
-export declare function renderOnReadDocBlocksForSubject(subject: NodeConfigSubject, readFilePath: string, target?: ExposureTarget, accounting?: DeliveryAccounting): string[];
-export declare function renderOnReadDocsForSubject(subject: NodeConfigSubject, readFilePath: string, target?: ExposureTarget, accounting?: DeliveryAccounting): string;
+export declare function renderOnReadDocBlocksForSubject(subject: NodeConfigSubject, readFilePath: string, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): string[];
+export declare function renderOnReadDocsForSubject(subject: NodeConfigSubject, readFilePath: string, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): string;
 /** Workspace boot docs using the snapshot's cwd/profile instead of a canvas
  * lookup. The shared exposure target prevents a later read from repeating a
  * document already loaded here.
@@ -67,7 +67,7 @@ export declare function renderOnReadDocsForSubject(subject: NodeConfigSubject, r
  * relationship cap BEFORE filtering, ordering, rendering, and exposure
  * registration. A later explicit `crtr memory read` can still raise a document
  * that workspace-open disclosed at a lower rung. */
-export declare function renderWorkspaceOpenDocsForSubject(subject: NodeConfigSubject, cwd: string, profileId: string | null, target?: ExposureTarget, accounting?: DeliveryAccounting): string;
+export declare function renderWorkspaceOpenDocsForSubject(subject: NodeConfigSubject, cwd: string, profileId: string | null, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): string;
 /** Inner `<memory>` blocks for the memory-read event: docs whose
  * `memory-read` entries match the doc a `crtr memory read` just resolved
  * (known by its exact canonical `name` — no mount-stripped or other alias;
@@ -80,13 +80,13 @@ export declare function memoryReadDocBlocks(excludeRealpath: string, name: strin
 /** Surface docs whose `command` entries match an executed bash command.
  * The corpus is the resolved cwd/profile set; a command has no file from which
  * to discover enclosing project stores. */
-export declare function renderOnCommandDocsForSubject(subject: NodeConfigSubject, command: string, target?: ExposureTarget, accounting?: DeliveryAccounting): string;
+export declare function renderOnCommandDocsForSubject(subject: NodeConfigSubject, command: string, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): string;
 /** Surface docs whose `pre-command` entries match a bash command that has NOT
  * run yet. The exact twin of the post-execution renderer above, and its empty
  * string is load-bearing: `''` means every matching doc is already exposed at
  * its matching rung or above, which is the release — the caller lets the
  * command through. */
-export declare function renderPreCommandDocsForSubject(subject: NodeConfigSubject, command: string, target?: ExposureTarget, accounting?: DeliveryAccounting): string;
+export declare function renderPreCommandDocsForSubject(subject: NodeConfigSubject, command: string, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): string;
 /** Whether this command matches a `command` surface before its node-config
  * gate is evaluated. A matching gate still requires a subject lookup. */
 export declare function corpusHasCommandSurfaceForCommand(command: string): boolean;
@@ -98,4 +98,4 @@ export declare function corpusHasPreCommandSurfaceForCommand(command: string): b
  * ledger still claims it was delivered, so without this pass a doc could be
  * held once and then silently absent for the rest of the session. Lives here
  * rather than in the extension because the corpus accessor is private. */
-export declare function demotePreCommandExposures(state: ContextExposureState): void;
+export declare function demotePreCommandExposures(state: ContextExposureState, memoryTarget?: MemoryTarget): void;

package/dist/core/substrate/on-read.js

@@ -1,9 +1,9 @@
-var T=Object.defineProperty;var i=(e,n)=>T(e,"name",{value:n,configurable:!0});import{sep as w}from"node:path";import{realpathOrSelf as E}from"../fs-utils.js";import{ambientMemoryTarget as B,listAllMemoryDocs as M,loadMemoryTargetView as P}from"../memory-resolver.js";import{commandEntryMatches as j,owningRootOf as S,preCommandEntryMatches as L}from"./surface-match.js";import{demoteDocumentTranscriptExposure as W,documentExposedAtOrAbove as q,emptyContextExposureState as H,exposedAtOrAbove as I,exposureTarget as K,registerDocumentExposure as V,registerExposure as z}from"./injected-store.js";import{planDelivery as b}from"./plan.js";import{parseSubstrateDoc as G,previewLine as J,rungRank as O}from"./schema.js";import{dirDedupKey as A,docListingDirs as Q,docsByName as F,isDirName as U,renderDirListing as X}from"./listings.js";import{cachedEventCorpusInclusive as Y}from"./session-cache.js";function h(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}i(h,"attr");function C(){try{return Y(M,G)}catch{return[]}}i(C,"resolvedDocs");function Z(e,n){if(n==="none")return null;let r=`kind="${h(e.kind)}" name="${h(e.name)}"`;if(n==="content"){const t=e.body.trim();if(t!=="")return`<memory ${r}>
-${t}
-</memory>`}else if(n==="preview"){const t=J(e);t!==""&&(r+=` readWhen="${h(t)}"`)}return`<memory ${r} />`}i(Z,"renderDocEnvelope");function l(e){return e.docs.filter(n=>n.winner).map(n=>({doc:n.doc,rung:n.finalRung,source:n.source}))}i(l,"planWinners");function R(e){return F(e.docs.map(({source:n})=>n))}i(R,"planListingCorpus");function _(e,n){return`<memory-listing dir="${h(e)}">
+var P=Object.defineProperty;var i=(e,n)=>P(e,"name",{value:n,configurable:!0});import{sep as w}from"node:path";import{realpathOrSelf as E}from"../fs-utils.js";import{ambientMemoryTarget as j,listAllMemoryDocs as L,loadMemoryTargetView as S}from"../memory-resolver.js";import{commandEntryMatches as W,owningRootOf as O,preCommandEntryMatches as q}from"./surface-match.js";import{demoteDocumentTranscriptExposure as T,documentExposedAtOrAbove as H,emptyContextExposureState as I,exposedAtOrAbove as K,exposureTarget as V,registerDocumentExposure as z,registerExposure as G}from"./injected-store.js";import{planDelivery as C}from"./plan.js";import{parseSubstrateDoc as A,previewLine as J,rungRank as F}from"./schema.js";import{dirDedupKey as R,docListingDirs as Q,docsByName as $,isDirName as U,renderDirListing as X}from"./listings.js";import{cachedEventCorpusInclusive as Y}from"./session-cache.js";function g(e){return e.replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}i(g,"attr");function D(){try{return Y(L,A)}catch{return[]}}i(D,"resolvedDocs");function Z(e,n){if(n==="none")return null;let t=`kind="${g(e.kind)}" name="${g(e.name)}"`;if(n==="content"){const r=e.body.trim();if(r!=="")return`<memory ${t}>
+${r}
+</memory>`}else if(n==="preview"){const r=J(e);r!==""&&(t+=` readWhen="${g(r)}"`)}return`<memory ${t} />`}i(Z,"renderDocEnvelope");function p(e){return e.docs.filter(n=>n.winner).map(n=>({doc:n.doc,rung:n.finalRung,source:n.source}))}i(p,"planWinners");function N(e){return $(e.docs.map(({source:n})=>n))}i(N,"planListingCorpus");function _(e,n){return`<memory-listing dir="${g(e)}">
 ${n.join(`
 `)}
-</memory-listing>`}i(_,"listingBlock");function fe(){return{deliveries:new Map}}i(fe,"deliveryAccounting");function $(e,n,r,t,o){if(e===void 0||r==="none")return;const c=E(n.path),a=e.deliveries.get(c);a!==void 0&&O(a.rung)>=O(r)||e.deliveries.set(c,{rung:r,...t===void 0?{}:{cause:t},...o===void 0?{}:{source:o}})}i($,"accountDelivery");function ee(e,n){const{target:r,byName:t}=n,o=Q(t,e.name),c=o[0]===e.name,a=[];let s;for(const[y,u]of o.entries()){if(!U(t,u))continue;const m=c&&y===0;if(!m&&I(r.state,A(u),"preview"))continue;if(n.listings==="tree"){n.dirs?.push(u);continue}const d=m&&n.explicit===!0,g=X(t,u,r,!d,k=>$(n.accounting,k,"preview","directory listing attached to content delivery",k));g.length!==0&&(z(r,A(u),"preview"),d?s=g:a.push(_(u,g)))}return a.push(...re(E(e.path),e.name,{...n,deliveryCause:"memory-read companion of content delivery"})),{blocks:a,...s===void 0?{}:{listing:s}}}i(ee,"contentReadAttachments");function p(e,n){const{target:r}=n,t=[];for(const{doc:o,rung:c,source:a}of e){if(q(r.state,o.path,o.body,c))continue;const s=Z(o,c);s!==null&&(V(r,o.path,o.body,c),$(n.accounting,o,c,n.deliveryCause,a),c==="content"&&t.push(...ee(o,{...n,deliveryCause:"memory-read companion of content delivery"}).blocks),t.push(s))}return t}i(p,"renderWinnerBlocks");function D(e,n,r,t){return{subject:e,target:n,byName:R(r),listings:"blocks",accounting:t}}i(D,"eventAttachmentOptions");function f(){return K(H(),"transcript")}i(f,"transientTranscriptTarget");function x(e){return e.length===0?"":`<auto-loaded-context>
+</memory-listing>`}i(_,"listingBlock");function fe(){return{deliveries:new Map}}i(fe,"deliveryAccounting");function B(e,n,t,r,o){if(e===void 0||t==="none")return;const c=E(n.path),a=e.deliveries.get(c);a!==void 0&&F(a.rung)>=F(t)||e.deliveries.set(c,{rung:t,...r===void 0?{}:{cause:r},...o===void 0?{}:{source:o}})}i(B,"accountDelivery");function ee(e,n){const{target:t,byName:r}=n,o=Q(r,e.name),c=o[0]===e.name,a=[];let s;for(const[h,u]of o.entries()){if(!U(r,u))continue;const m=c&&h===0;if(!m&&K(t.state,R(u),"preview"))continue;if(n.listings==="tree"){n.dirs?.push(u);continue}const l=m&&n.explicit===!0,d=X(r,u,t,!l,b=>B(n.accounting,b,"preview","directory listing attached to content delivery",b));d.length!==0&&(G(t,R(u),"preview"),l?s=d:a.push(_(u,d)))}return a.push(...re(E(e.path),e.name,{...n,deliveryCause:"memory-read companion of content delivery"})),{blocks:a,...s===void 0?{}:{listing:s}}}i(ee,"contentReadAttachments");function f(e,n){const{target:t}=n,r=[];for(const{doc:o,rung:c,source:a}of e){if(H(t.state,o.path,o.body,c))continue;const s=Z(o,c);s!==null&&(z(t,o,c),B(n.accounting,o,c,n.deliveryCause,a),c==="content"&&r.push(...ee(o,{...n,deliveryCause:"memory-read companion of content delivery"}).blocks),r.push(s))}return r}i(f,"renderWinnerBlocks");function k(e,n,t,r,o){return{subject:e,target:n,byName:N(t),listings:"blocks",accounting:r,memoryTarget:o}}i(k,"eventAttachmentOptions");function y(){return V(I(),"transcript")}i(y,"transientTranscriptTarget");function x(e){return e.length===0?"":`<auto-loaded-context>
 ${e.join(`
 `)}
-</auto-loaded-context>`}i(x,"renderAutoLoadedContext");function v(e,n,r,t){return t===void 0?b(e,B(),n,r,C()):b(e,t,n,r)}i(v,"eventPlan");function ne(e,n,r=f(),t){const o=v(e,"read",{absoluteFile:n});return p(l(o),D(o.subject,r,o,t))}i(ne,"renderOnReadDocBlocksForSubject");function ye(e,n,r=f(),t){return x(ne(e,n,r,t))}i(ye,"renderOnReadDocsForSubject");function ge(e,n,r,t=f(),o){const c={cwd:n,profileId:r,nodeId:null};let a,s;try{a=l(b(e,c,"workspace-open")),s=F(P(c,{quiet:!0}).docs)}catch{return""}return a.sort((y,u)=>{const m=S(y.doc)??"",d=S(u.doc)??"";return m.split(w).filter(Boolean).length-d.split(w).filter(Boolean).length||m.localeCompare(d)||y.doc.path.localeCompare(u.doc.path)}),x(p(a,{subject:e,target:t,byName:s,memoryTarget:c,listings:"blocks",accounting:o}))}i(ge,"renderWorkspaceOpenDocsForSubject");function re(e,n,r){const t=v(r.subject,"memory-read",{resolvedCanonicalName:n,resolvedDocPath:e},r.memoryTarget);return p(l(t),{...r,byName:r.byName??R(t)})}i(re,"memoryReadDocBlocks");function he(e,n,r=f(),t){const o=v(e,"command",{command:n});return x(p(l(o),D(e,r,o,t)))}i(he,"renderOnCommandDocsForSubject");function xe(e,n,r=f(),t){const o=v(e,"pre-command",{command:n});return x(p(l(o),D(e,r,o,t)))}i(xe,"renderPreCommandDocsForSubject");function te(e){return e.surfaces.some(n=>n.on==="pre-command")}i(te,"carriesPreCommandEntry");function N(e,n){const r=n==="command"?j:L;return C().some(({doc:t})=>t.surfaces.some(o=>r(o,e)))}i(N,"hasCommandSurfaceForCommand");function ve(e){return N(e,"command")}i(ve,"corpusHasCommandSurfaceForCommand");function be(e){return N(e,"pre-command")}i(be,"corpusHasPreCommandSurfaceForCommand");function Ce(e){for(const{doc:n}of C())te(n)&&W(e,n.path,n.body)}i(Ce,"demotePreCommandExposures");export{$ as accountDelivery,ee as contentReadAttachments,ve as corpusHasCommandSurfaceForCommand,be as corpusHasPreCommandSurfaceForCommand,fe as deliveryAccounting,Ce as demotePreCommandExposures,re as memoryReadDocBlocks,x as renderAutoLoadedContext,he as renderOnCommandDocsForSubject,ne as renderOnReadDocBlocksForSubject,ye as renderOnReadDocsForSubject,xe as renderPreCommandDocsForSubject,ge as renderWorkspaceOpenDocsForSubject};
+</auto-loaded-context>`}i(x,"renderAutoLoadedContext");function v(e,n,t,r){return r===void 0?C(e,j(),n,t,D()):C(e,r,n,t)}i(v,"eventPlan");function ne(e,n,t=y(),r,o){const c=v(e,"read",{absoluteFile:n},o);return f(p(c),k(c.subject,t,c,r,o))}i(ne,"renderOnReadDocBlocksForSubject");function ye(e,n,t=y(),r,o){return x(ne(e,n,t,r,o))}i(ye,"renderOnReadDocsForSubject");function he(e,n,t,r=y(),o,c){const a=c===void 0?{cwd:n,profileId:t,nodeId:null}:{...c,cwd:n,profileId:t,nodeId:null};let s,h;try{s=p(C(e,a,"workspace-open")),h=$(S(a,{quiet:!0}).docs)}catch{return""}return s.sort((u,m)=>{const l=O(u.doc)??"",d=O(m.doc)??"";return l.split(w).filter(Boolean).length-d.split(w).filter(Boolean).length||l.localeCompare(d)||u.doc.path.localeCompare(m.doc.path)}),x(f(s,{subject:e,target:r,byName:h,memoryTarget:a,listings:"blocks",accounting:o}))}i(he,"renderWorkspaceOpenDocsForSubject");function re(e,n,t){const r=v(t.subject,"memory-read",{resolvedCanonicalName:n,resolvedDocPath:e},t.memoryTarget);return f(p(r),{...t,byName:t.byName??N(r)})}i(re,"memoryReadDocBlocks");function ge(e,n,t=y(),r,o){const c=v(e,"command",{command:n},o);return x(f(p(c),k(e,t,c,r,o)))}i(ge,"renderOnCommandDocsForSubject");function xe(e,n,t=y(),r,o){const c=v(e,"pre-command",{command:n},o);return x(f(p(c),k(e,t,c,r,o)))}i(xe,"renderPreCommandDocsForSubject");function te(e){return e.surfaces.some(n=>n.on==="pre-command")}i(te,"carriesPreCommandEntry");function M(e,n){const t=n==="command"?W:q;return D().some(({doc:r})=>r.surfaces.some(o=>t(o,e)))}i(M,"hasCommandSurfaceForCommand");function ve(e){return M(e,"command")}i(ve,"corpusHasCommandSurfaceForCommand");function be(e){return M(e,"pre-command")}i(be,"corpusHasPreCommandSurfaceForCommand");function Ce(e,n){const t=n===void 0?D():S(n,{quiet:!0}).docs.map(r=>({doc:A(r)})).filter(r=>r.doc!==null);for(const{doc:r}of t)te(r)&&T(e,r.path,r.body)}i(Ce,"demotePreCommandExposures");export{B as accountDelivery,ee as contentReadAttachments,ve as corpusHasCommandSurfaceForCommand,be as corpusHasPreCommandSurfaceForCommand,fe as deliveryAccounting,Ce as demotePreCommandExposures,re as memoryReadDocBlocks,x as renderAutoLoadedContext,ge as renderOnCommandDocsForSubject,ne as renderOnReadDocBlocksForSubject,ye as renderOnReadDocsForSubject,xe as renderPreCommandDocsForSubject,he as renderWorkspaceOpenDocsForSubject};

package/dist/core/substrate/plan.js

@@ -1 +1 @@
-var P=Object.defineProperty;var a=(e,t)=>P(e,"name",{value:t,configurable:!0});import{homedir as b}from"node:os";import{dirname as w,parse as k,sep as S}from"node:path";import{parseFrontmatterGeneric as R}from"../frontmatter.js";import{readText as D,realpathOrSelf as l}from"../fs-utils.js";import{listProjectMemoryDocs as G,loadMemoryTargetView as M,loadStoreMemoryDocs as E,openProjectMemoryStore as x}from"../memory-resolver.js";import{userScopeRoot as C}from"../scope.js";import{gatePasses as O,surfaceEntryGatePasses as A}from"./gate.js";import{minRung as $,parseSubstrateDoc as F,rungAtLeast as y}from"./schema.js";import{matchingSurfaceEntry as L,surfaceEntryParticipates as N}from"./surface-match.js";function B(e){return e.nodeLocal?"knowledge":e.kind}a(B,"bootPartitionOf");function ie(e,t,n,o={},r){const s=I(n,o),u=T(n,r??K(t,n),s).map(({doc:c,source:f})=>U(c,f,e,n,s));return Q(n,u),{event:n,subject:e,target:t,docs:u}}a(ie,"planDelivery");function I(e,t){if(e!=="read"||t.absoluteFile===void 0)return{...t,readFrontmatter:t.readFrontmatter??{}};const n=l(t.absoluteFile);return{...t,absoluteFile:n,readFrontmatter:t.readFrontmatter??J(n)}}a(I,"resolvePayload");function J(e){if(!/\.(md|mdx|markdown)$/i.test(e))return{};try{return R(D(e)).data??{}}catch{return{}}}a(J,"readFileFrontmatter");function T(e,t,n){if(e==="read"){const o=n.absoluteFile;return o===void 0?[...t]:[...q(o),...t].filter(({doc:r})=>l(r.path)!==o)}if(e==="memory-read"&&n.resolvedDocPath!==void 0){const o=n.resolvedDocPath;return t.filter(({doc:r})=>l(r.path)!==o)}return[...t]}a(T,"considerFor");const _=new Set(["node_modules",".git","dist","build",".next",".cache",".yalc"]);function j(e){return e.split(S).some(t=>_.has(t))}a(j,"isJunkAncestor");function q(e){const t=[],n=new Set,o=l(b()),r=l(C()),s=k(e).root;let i=w(e);for(;;){if(i!==o&&i!==r&&!j(i)){const c=x(i);if(c.mountStatus==="ready"&&!n.has(c.storeRoot)){n.add(c.storeRoot);for(const f of E(c,!0)){const m=F(f);m!==null&&t.push({doc:m,source:f})}}}if(i===o||i===s)break;const u=w(i);if(u===i)break;i=u}return t}a(q,"enclosingProjectDocs");function K(e,t){const n=t==="workspace-open"?G(e.cwd,e.profileId):M(e,{quiet:!0}).docs,o=[];for(const r of n){const s=F(r);s!==null&&o.push({doc:s,source:r})}return t!=="boot"?o:[...o.filter(r=>r.doc.scope!=="node"),...o.filter(r=>r.doc.scope==="node")]}a(K,"loadEventCorpus");function U(e,t,n,o,r){const s={absoluteFile:r.absoluteFile,readFrontmatter:r.readFrontmatter,resolvedCanonicalName:r.resolvedCanonicalName,routingAnchor:t.routingAnchor,command:r.command},i=V(e,n),u=e.surfaces.filter(d=>d.on===o).map(d=>({entry:d,matched:N(d,e,n,o,s),gate:W(d,n)})),c=L(e,n,o,s),f=c?.at??"none",m=e.scope==="node",p=(o==="boot"||o==="workspace-open")&&!m?e.projectMemory:null,g=p===null?f:$(f,p);let h=i.pass?g:"none";return o==="boot"&&m&&i.pass&&!y(h,"name")&&!e.surfaces.some(d=>d.on==="boot")&&(h="name"),{name:e.name,kind:e.kind,scope:e.scope,storePath:e.path,nodeLocal:m,authoredEntries:u,matchedEntry:c,authoredRung:f,projectMemoryCap:p,cappedRung:g,docGate:i,entryGate:z(u,c),finalRung:h,winner:!1,shadowedBy:null,doc:e,source:t}}a(U,"decide");function V(e,t){if(e.gate===void 0)return{pass:!0};if(t===null)return{pass:!1,reason:"gated document with no node config to match"};try{return O(e,t)?{pass:!0}:{pass:!1,reason:"document gate does not match this node config"}}catch(n){return{pass:!1,reason:`document gate failed to evaluate: ${String(n)}`}}}a(V,"documentGateOutcome");function W(e,t){return e.gate===void 0?{pass:!0}:A(e,t)?{pass:!0}:{pass:!1,reason:"entry gate does not match this node config"}}a(W,"entryGateOutcome");function z(e,t){if(e.length===0)return null;if(t!==null)return{pass:!0};const n=e.find(o=>!o.gate.pass);return n===void 0?{pass:!0}:n.gate}a(z,"recordEntryGate");function H(e,t){return e.docGate.pass?t==="boot"?e.projectMemoryCap!=="none":y(e.finalRung,"name"):!1}a(H,"participates");function Q(e,t){const n=new Map;for(const o of t){if(!H(o,e))continue;const r=e==="boot"?`${B(o)}:${o.name}`:o.name,s=n.get(r);if(s===void 0){n.set(r,o),o.winner=!0;continue}o.shadowedBy={name:s.name,scope:s.scope,path:s.storePath}}}a(Q,"resolveWinners");export{B as bootPartitionOf,ie as planDelivery};
+var b=Object.defineProperty;var c=(e,t)=>b(e,"name",{value:t,configurable:!0});import{homedir as k}from"node:os";import{dirname as F,parse as R,sep as D}from"node:path";import{parseFrontmatterGeneric as G}from"../frontmatter.js";import{readText as E,realpathOrSelf as l}from"../fs-utils.js";import{loadMemoryTargetView as S,loadStoreMemoryDocs as M,openProjectMemoryStore as x}from"../memory-resolver.js";import{userScopeRoot as C}from"../scope.js";import{gatePasses as O,surfaceEntryGatePasses as A}from"./gate.js";import{minRung as $,parseSubstrateDoc as y,rungAtLeast as P}from"./schema.js";import{matchingSurfaceEntry as L,surfaceEntryParticipates as N}from"./surface-match.js";function j(e){return e.nodeLocal?"knowledge":e.kind}c(j,"bootPartitionOf");function ae(e,t,o,n={},r){const s=q(o,n),a=J(o,r??K(t,o),s,t).map(({doc:u,source:i})=>U(u,i,e,o,s));return Q(o,a),{event:o,subject:e,target:t,docs:a}}c(ae,"planDelivery");function q(e,t){if(e!=="read"||t.absoluteFile===void 0)return{...t,readFrontmatter:t.readFrontmatter??{}};const o=l(t.absoluteFile);return{...t,absoluteFile:o,readFrontmatter:t.readFrontmatter??B(o)}}c(q,"resolvePayload");function B(e){if(!/\.(md|mdx|markdown)$/i.test(e))return{};try{return G(E(e)).data??{}}catch{return{}}}c(B,"readFileFrontmatter");function J(e,t,o,n){if(e==="read"){const r=o.absoluteFile;return r===void 0?[...t]:[...I(r,n),...t].filter(({doc:s})=>l(s.path)!==r)}if(e==="memory-read"&&o.resolvedDocPath!==void 0){const r=o.resolvedDocPath;return t.filter(({doc:s})=>l(s.path)!==r)}return[...t]}c(J,"considerFor");const T=new Set(["node_modules",".git","dist","build",".next",".cache",".yalc"]);function _(e){return e.split(D).some(t=>T.has(t))}c(_,"isJunkAncestor");function I(e,t){const o=[],n=new Set,r=l(k()),s=l(C()),m=R(e).root;let a=F(e);for(;;){if(a!==r&&a!==s&&!_(a)){const i=x(a);if(i.mountStatus==="ready"&&!n.has(i.storeRoot)&&t.allowsProject?.(i.repositoryRoot??i.ownerDir??i.storeRoot)!==!1&&t.allowsStore?.(i)!==!1){n.add(i.storeRoot);for(const f of M(i,!0)){if(t.allowsStore?.(i,f.name)===!1)continue;const p=y(f);p!==null&&o.push({doc:p,source:f})}}}if(a===r||a===m)break;const u=F(a);if(u===a)break;a=u}return o}c(I,"enclosingProjectDocs");function K(e,t){const o=t==="workspace-open"?S(e,{quiet:!0,scope:"project"}).docs:S(e,{quiet:!0}).docs,n=[];for(const r of o){const s=y(r);s!==null&&n.push({doc:s,source:r})}return t!=="boot"?n:[...n.filter(r=>r.doc.scope!=="node"),...n.filter(r=>r.doc.scope==="node")]}c(K,"loadEventCorpus");function U(e,t,o,n,r){const s={absoluteFile:r.absoluteFile,readFrontmatter:r.readFrontmatter,resolvedCanonicalName:r.resolvedCanonicalName,routingAnchor:t.routingAnchor,command:r.command},m=V(e,o),a=e.surfaces.filter(d=>d.on===n).map(d=>({entry:d,matched:N(d,e,o,n,s),gate:W(d,o)})),u=L(e,o,n,s),i=u?.at??"none",f=e.scope==="node",h=(n==="boot"||n==="workspace-open")&&!f?e.projectMemory:null,w=h===null?i:$(i,h);let g=m.pass?w:"none";return n==="boot"&&f&&m.pass&&!P(g,"name")&&!e.surfaces.some(d=>d.on==="boot")&&(g="name"),{name:e.name,kind:e.kind,scope:e.scope,storePath:e.path,nodeLocal:f,authoredEntries:a,matchedEntry:u,authoredRung:i,projectMemoryCap:h,cappedRung:w,docGate:m,entryGate:z(a,u),finalRung:g,winner:!1,shadowedBy:null,doc:e,source:t}}c(U,"decide");function V(e,t){if(e.gate===void 0)return{pass:!0};if(t===null)return{pass:!1,reason:"gated document with no node config to match"};try{return O(e,t)?{pass:!0}:{pass:!1,reason:"document gate does not match this node config"}}catch(o){return{pass:!1,reason:`document gate failed to evaluate: ${String(o)}`}}}c(V,"documentGateOutcome");function W(e,t){return e.gate===void 0?{pass:!0}:A(e,t)?{pass:!0}:{pass:!1,reason:"entry gate does not match this node config"}}c(W,"entryGateOutcome");function z(e,t){if(e.length===0)return null;if(t!==null)return{pass:!0};const o=e.find(n=>!n.gate.pass);return o===void 0?{pass:!0}:o.gate}c(z,"recordEntryGate");function H(e,t){return e.docGate.pass?t==="boot"?e.projectMemoryCap!=="none":P(e.finalRung,"name"):!1}c(H,"participates");function Q(e,t){const o=new Map;for(const n of t){if(!H(n,e))continue;const r=e==="boot"?`${j(n)}:${n.name}`:n.name,s=o.get(r);if(s===void 0){o.set(r,n),n.winner=!0;continue}n.shadowedBy={name:s.name,scope:s.scope,path:s.storePath}}}c(Q,"resolveWinners");export{j as bootPartitionOf,ae as planDelivery};

package/dist/core/substrate/render-node.js

@@ -1 +1 @@
-var c=Object.defineProperty;var t=(e,r)=>c(e,"name",{value:r,configurable:!0});import{interpolateNodePaths as u}from"../canvas/paths.js";import{assembleNodeSubject as n}from"./subject.js";import{emptyContextExposureState as s,exposureTarget as p}from"./injected-store.js";import{renderPreferencesForSubject as i,renderKnowledgeForSubject as m}from"./render.js";function x(e){const r=n(e);return u(i(r).block,e)}t(x,"renderPreferencesSection");function S(e,r=p(s(),"transcript")){const o=n(e);return o===null?"":m(o,e,r)}t(S,"renderKnowledgeBlock");export{S as renderKnowledgeBlock,x as renderPreferencesSection};
+var m=Object.defineProperty;var t=(e,r)=>m(e,"name",{value:r,configurable:!0});import{appForNode as n,interpolateNodePaths as p}from"../canvas/node-agent-paths.js";import{getNode as u}from"../canvas/canvas.js";import{automaticMemoryTarget as i}from"../spaces/permissions.js";import{assembleNodeSubject as c}from"./subject.js";import{emptyContextExposureState as f,exposureTarget as s}from"./injected-store.js";import{renderPreferencesForSubject as a,renderKnowledgeForSubject as l}from"./render.js";function P(e){const r=c(e);return p(a(r).block,e)}t(P,"renderPreferencesSection");function d(e,r=s(f(),"transcript")){const o=c(e);return o===null?"":l(o,e,r,void 0,n(e),i({...u(e),grantee:n(e)}))}t(d,"renderKnowledgeBlock");export{d as renderKnowledgeBlock,P as renderPreferencesSection};

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

@@ -1,3 +1,4 @@
+import { type MemoryTarget } from '../memory-resolver.js';
 import { type ExposureTarget } from './injected-store.js';
 import { type SubstrateDoc } from './schema.js';
 import type { NodeConfigSubject } from './subject-fields.js';
@@ -10,7 +11,7 @@ import { type DeliveryAccounting } from './on-read.js';
  *  header). Emitted for BOTH base and orchestrator modes per the CTO's ruling —
  *  mode is irrelevant to which sub-kinds are spawnable. */
 export declare function buildSubPersonaMenu(kind: string): string;
-export declare function renderPreferencesForSubject(subject: NodeConfigSubject | null, target?: ExposureTarget, accounting?: DeliveryAccounting): {
+export declare function renderPreferencesForSubject(subject: NodeConfigSubject | null, target?: ExposureTarget, accounting?: DeliveryAccounting, memoryTarget?: MemoryTarget): {
     block: string;
     contentDocs: SubstrateDoc[];
     tree: string;
@@ -27,7 +28,7 @@ export declare function renderPreferencesForSubject(subject: NodeConfigSubject |
  *  renders: floored docs never reach the `content` rung). Procedural guidance and factual
  *  references both live here as `knowledge`. Returns '' when nothing is
  *  eligible. */
-export declare function renderKnowledgeForSubject(subject: NodeConfigSubject, nodeId: string, target?: ExposureTarget, accounting?: DeliveryAccounting): string;
+export declare function renderKnowledgeForSubject(subject: NodeConfigSubject, nodeId: string, target?: ExposureTarget, accounting?: DeliveryAccounting, grantee?: string, memoryTarget?: MemoryTarget): string;
 /** What a node's configuration change newly exposes, rendered as up to three
  *  blocks in one string: the shipped protocol prose, a `<memory kind="preference">`
  *  block, and a `<memory kind="knowledge">` block — each dropped when empty, ''
@@ -37,4 +38,4 @@ export declare function renderKnowledgeForSubject(subject: NodeConfigSubject, no
  *  against the active exposure maximum. A lower rung or removal yields nothing
  *  because content already loaded into this context cannot be withdrawn.
  *  Rendered deltas register as transcript exposure through `target`. */
-export declare function renderConfigChangeDelta(subject: NodeConfigSubject, nodeId: string, target: ExposureTarget): string;
+export declare function renderConfigChangeDelta(subject: NodeConfigSubject, nodeId: string, target: ExposureTarget, grantee?: string, memoryTarget?: MemoryTarget): string;

package/dist/core/substrate/render.js

@@ -1,65 +1,65 @@
-var q=Object.defineProperty;var u=(e,t)=>q(e,"name",{value:t,configurable:!0});import{sep as z}from"node:path";import{interpolateNodePaths as T}from"../canvas/paths.js";import{ambientMemoryTarget as J,listAllMemoryDocs as Q,loadMemoryTargetView as X,resolveMemoryDoc as Z}from"../memory-resolver.js";import{buildMemoryTree as C}from"../memory/tree.js";import{subKindsAvailableTo as ee}from"../config.js";import{projectScopeRoots as ne}from"../scope.js";import{documentExposedAtOrAbove as v,emptyContextExposureState as te,exposureTarget as oe,registerDocumentExposure as O,registerExposure as re}from"./injected-store.js";import{bootPartitionOf as se,planDelivery as ie}from"./plan.js";import{parseSubstrateDoc as P,previewLine as ce,rungAtLeast as M,rungRank as N}from"./schema.js";import{accountDelivery as S,contentReadAttachments as ae}from"./on-read.js";import{dirDedupKey as ue,docsByName as le}from"./listings.js";import{cachedEventCorpusInclusive as fe}from"./session-cache.js";function A(e){if(e===null)return[];let t;try{t=X({cwd:process.cwd(),profileId:null,nodeId:e},{scope:"node",quiet:!0}).docs}catch{return[]}const n=[];for(const r of t){const o=P(r);o!==null&&n.push({doc:o,source:r})}return n}u(A,"nodeStoreCorpus");function de(e){let t;try{t=fe(Q,P).filter(n=>n.doc.scope!=="node")}catch{return A(e)}return[...t,...A(e)]}u(de,"bootCorpus");function E(e,t){return ie(e,{...J(),nodeId:t},"boot",{},de(t))}u(E,"bootPlan");function g(e,t){return e.docs.filter(n=>n.winner&&se(n)===t).map(n=>({...n.doc,source:n.source,bootRung:n.finalRung}))}u(g,"bootWinners");function R(e){return D(e.bootRung)&&(e.bootRung!=="content"||e.body.trim()!=="")}u(R,"rendersAtBoot");function _(e){if(e.scope==="node")return 1e3;if(e.scope==="builtin")return 0;if(e.scope==="user")return 1;if(e.scope==="profile")return 2;const t=ne();if(t.length===0)return 3;const n=t.findIndex(o=>e.path.startsWith(o+z)),r=n===-1?0:n;return 3+(t.length-1-r)}u(_,"scopeGeneralityRank");function B(e){const t=e.source.physicalRelativePath.replace(/\.md$/i,"").split("/");return e.source.representation==="directory-index"&&t.pop(),t}u(B,"physicalSegments");function me(e,t){const n=B(e),r=B(t),o=Math.min(n.length,r.length);for(let i=0;i<o;i++){const a=n[i].localeCompare(r[i]);if(a!==0)return a}return n.length-r.length}u(me,"compareTreePosition");function w(e){return e.scope!=="builtin"&&e.plugin===void 0}u(w,"isAgentEditable");function pe(e,t,n){if(t.length===0)return[];const r=new Map(e.map(a=>[a.path,a])),o=C(e.map(a=>a.source)),i=new Map;for(const a of t){const l=o.node(a);if(l===null)continue;let d=!1;const m=[...l.childDocuments.map(p=>p.document),...l.childDirectories.flatMap(p=>p.document===null?[]:[p.document])];for(const p of m){const f=r.get(p.path);f===void 0||i.has(f.path)||f.bootRung==="content"||M(f.bootRung,"preview")||f.unlisted||M(f.projectMemory,"preview")&&(v(n.state,f.path,f.body,"preview")||(i.set(f.path,{...f,bootRung:"preview"}),d=!0))}d&&re(n,ue(a),"preview")}return[...i.values()]}u(pe,"exposedDirEntries");function b(e,t,n,r,o=e,i){const a=r??oe(te(),"transcript"),l=[],d=[];for(const s of e)s.bootRung==="content"?l.push(s):d.push(s);l.sort((s,$)=>_(s)-_($)||me(s,$)||s.name.localeCompare($.name));const m=l.filter(s=>!v(a.state,s.path,s.body,"content")),p=m.map(s=>s.body.trim()).filter(s=>s!=="").join(`
+var J=Object.defineProperty;var l=(e,o)=>J(e,"name",{value:o,configurable:!0});import{sep as Q}from"node:path";import{interpolateNodePaths as M}from"../canvas/paths.js";import{ambientMemoryTarget as X,listAllMemoryDocs as Z,loadMemoryTargetView as N,resolveMemoryDoc as ee}from"../memory-resolver.js";import{buildMemoryTree as S}from"../memory/tree.js";import{subKindsAvailableTo as ne}from"../config.js";import{projectScopeRoots as te}from"../scope.js";import{documentExposedAtOrAbove as R,emptyContextExposureState as oe,exposureTarget as re,registerDocumentExposure as T,registerExposure as se}from"./injected-store.js";import{bootPartitionOf as ie,planDelivery as ce}from"./plan.js";import{parseSubstrateDoc as D,previewLine as ae,rungAtLeast as A,rungRank as _}from"./schema.js";import{accountDelivery as B,contentReadAttachments as ue}from"./on-read.js";import{dirDedupKey as le,docsByName as fe}from"./listings.js";import{cachedEventCorpusInclusive as de}from"./session-cache.js";function j(e,o,n){if(e===null)return[];let r;try{r=N({...n??{cwd:process.cwd(),profileId:null},nodeId:e,grantee:o},{scope:"node",quiet:!0}).docs}catch{return[]}const t=[];for(const s of r){const a=D(s);a!==null&&t.push({doc:a,source:s})}return t}l(j,"nodeStoreCorpus");function pe(e,o,n){let r;try{r=(n===void 0?de(Z,D):N({...n,nodeId:null},{quiet:!0}).docs.map(t=>({source:t,doc:D(t)})).filter(t=>t.doc!==null)).filter(t=>t.doc.scope!=="node")}catch{return j(e,o,n)}return[...r,...j(e,o,n)]}l(pe,"bootCorpus");function x(e,o,n,r){return ce(e,{...r??X(),nodeId:o,grantee:n},"boot",{},pe(o,n,r))}l(x,"bootPlan");function g(e,o){return e.docs.filter(n=>n.winner&&ie(n)===o).map(n=>({...n.doc,source:n.source,bootRung:n.finalRung}))}l(g,"bootWinners");function C(e){return O(e.bootRung)&&(e.bootRung!=="content"||e.body.trim()!=="")}l(C,"rendersAtBoot");function L(e){if(e.scope==="node")return 1e3;if(e.scope==="builtin")return 0;if(e.scope==="user")return 1;if(e.scope==="profile")return 2;const o=te();if(o.length===0)return 3;const n=o.findIndex(t=>e.path.startsWith(t+Q)),r=n===-1?0:n;return 3+(o.length-1-r)}l(L,"scopeGeneralityRank");function I(e){const o=e.source.physicalRelativePath.replace(/\.md$/i,"").split("/");return e.source.representation==="directory-index"&&o.pop(),o}l(I,"physicalSegments");function me(e,o){const n=I(e),r=I(o),t=Math.min(n.length,r.length);for(let s=0;s<t;s++){const a=n[s].localeCompare(r[s]);if(a!==0)return a}return n.length-r.length}l(me,"compareTreePosition");function k(e){return e.scope!=="builtin"&&e.plugin===void 0}l(k,"isAgentEditable");function he(e,o,n){if(o.length===0)return[];const r=new Map(e.map(a=>[a.path,a])),t=S(e.map(a=>a.source)),s=new Map;for(const a of o){const c=t.node(a);if(c===null)continue;let f=!1;const h=[...c.childDocuments.map(p=>p.document),...c.childDirectories.flatMap(p=>p.document===null?[]:[p.document])];for(const p of h){const d=r.get(p.path);d===void 0||s.has(d.path)||d.bootRung==="content"||A(d.bootRung,"preview")||d.unlisted||A(d.projectMemory,"preview")&&(R(n.state,d.path,d.body,"preview")||(s.set(d.path,{...d,bootRung:"preview"}),f=!0))}f&&se(n,le(a),"preview")}return[...s.values()]}l(he,"exposedDirEntries");function $(e,o,n,r,t=e,s,a){const c=r??re(oe(),"transcript"),f=[],h=[];for(const i of e)i.bootRung==="content"?f.push(i):h.push(i);f.sort((i,E)=>L(i)-L(E)||me(i,E)||i.name.localeCompare(E.name));const p=f.filter(i=>!R(c.state,i.path,i.body,"content")),d=p.map(i=>i.body.trim()).filter(i=>i!=="").join(`
 
-`);for(const s of m)R(s)&&(O(a,s.path,s.body,s.bootRung),S(i,s,s.bootRung,void 0,s.source));const f={subject:n??null,target:a,byName:le(o.map(s=>s.source)),listings:"tree",dirs:[],accounting:i},h=m.flatMap(s=>ae(s,f).blocks),c=pe(o,f.dirs??[],a),y=new Map(c.map(s=>[s.path,s])),V=new Set(d.map(s=>s.path)),x=[...d.map(s=>y.get(s.path)??s),...c.filter(s=>!V.has(s.path))];for(const s of x)R(s)&&(O(a,s.path,s.body,s.bootRung),S(i,s,s.bootRung,y.has(s.path)?"directory listing attached to content delivery":void 0,s.source));return{contentProse:p,tree:he(x,t),contentDocs:m,attachmentBlocks:h}}u(b,"renderGrouped");function j(e){const t=e.lastIndexOf("/");return t===-1?e:e.slice(t+1)}u(j,"leafSegment");function D(e){return N(e)>=N("name")}u(D,"isVisible");function L(e,t){const n=e.childDirectories.map(l=>L(l,t)),r=[];let o=0;for(const l of e.childDocuments){const d=t.get(l.document.path);d!==void 0&&(D(d.bootRung)?r.push({name:l.name,order:l.order,doc:d}):o+=1)}const i=e.document===null?null:t.get(e.document.path)??null;let a=null;return i!==null&&(D(i.bootRung)?a=i:o+=1),{name:e.name,segment:j(e.name),order:e.order,own:a,children:n,leaves:r,hiddenHere:o,renders:!1,ownCount:0}}u(L,"planDir");function G(e,t){let n=e.hiddenHere;for(const i of e.children)n+=G(i,e.name==="");const r=e.own!==null||e.leaves.length>0,o=e.children.some(i=>i.renders);return e.renders=r||o||t||e.name==="",e.ownCount=e.renders?n:0,e.renders?0:n}u(G,"resolveDir");function I(e){return e.kind==="dir"?e.node.order:e.kind==="leaf"?e.entry.order:""}u(I,"itemOrder");function K(e){return e.kind==="dir"?e.node.name:e.kind==="leaf"?e.entry.name:""}u(K,"itemName");function F(e,t,n,r){const o=e.bootRung==="preview"?ce(e):"";r.push(o===""?`${n}${t}`:`${n}${t}  # read when: ${o}`)}u(F,"renderDocEntry");function W(e,t,n){const r=[];for(const o of e.children)o.renders&&r.push({kind:"dir",node:o});for(const o of e.leaves)r.push({kind:"leaf",entry:o});r.sort((o,i)=>I(o).localeCompare(I(i))||K(o).localeCompare(K(i))),e.ownCount>0&&r.push({kind:"more",count:e.ownCount}),r.forEach((o,i)=>{const a=i===r.length-1,l=t+(a?"\u2514\u2500 ":"\u251C\u2500 "),d=t+(a?"   ":"\u2502  ");switch(o.kind){case"more":n.push(`${l}[+${o.count} more]`);break;case"dir":{const m=`${o.node.segment}/`;o.node.own===null?n.push(`${l}${m}`):F(o.node.own,m,l,n),W(o.node,d,n);break}case"leaf":F(o.entry.doc,j(o.entry.name),l,n);break}})}u(W,"renderChildren");function he(e,t){if(e.length===0)return"";const n=new Map;for(const i of e)n.has(i.path)||n.set(i.path,i);const r=L(C(e.map(i=>i.source)).root,n);G(r,!1);const o=[t];return W(r,"",o),o.join(`
-`)}u(he,"buildTree");const k="Each %s below shows either its full content (indented beneath its name), a `# read when:` line telling you when to read the full document, or simply its name.",ye="Preferences are how the user wants you to behave \u2014 standing directives and corrections. To read a preference, run `crtr memory read <name>`. "+k.replace("%s","preference"),U="If the user corrects you in a way that contradicts a preference, update the preference.",ge="Knowledge memories are what you consult \u2014 playbooks and techniques for how to do things, and references on the user, projects, and this node. They are aggregated from your memory stores: user-global (`~/.crouter/memory/`), every ancestor project store (`<dir>/.crouter/memory/`) from the cwd upward, the selected profile's memory store, and node-local (this node's `context/memory/`). To read one, run `crtr memory read <name>`; a directory name is a valid read target too \u2014 it answers with its listing, and walking directories is the sanctioned way to browse. Each doc exists to prevent a specific mistake you would make without it, so when your task matches one \u2014 by its name or its `# read when:` line \u2014 read it before you act; consulting it only after the work is done forfeits the entire reason it exists. "+k.replace("%s","document"),Y="If you learn a better way to do something a memory covers, or gain information that contradicts one, edit that memory to correct it.",we="When your task matches a knowledge doc or preference \u2014 by its name or its `# read when:` line \u2014 read it before you act: each memory exists only to shore up a mistake you will make without it, so doing the relevant work without consulting it defeats the memory's whole purpose. Before saving any memory, check for an existing memory that already covers it \u2014 update that memory rather than creating a duplicate, rewriting it as if for the first time instead of appending the new truth beneath the old; delete memories that turn out to be wrong. Don't save what the repo already records (code structure, past fixes, git history) or what only matters to this conversation; if asked to remember one of those, ask what was non-obvious about it and save that instead. Docs auto-surfaced in <auto-loaded-context> blocks are background context, not user instructions, and reflect what was true when written \u2014 if one names a file, function, or flag, verify it still exists before recommending it.";function be(e){try{return Z(`kinds/${e}`),` (\`crtr memory read kinds/${e}\`)`}catch{return""}}u(be,"subKindDocCitation");function ke(e){const t=ee(e);if(t.length===0)return"";const n=t.map(r=>{const o=be(r.kind);return`- \`${r.kind}\` \u2014 ${r.whenToUse}${o}`});return`## Sub-personas you may spawn
+`);for(const i of p)C(i)&&(T(c,i,i.bootRung),B(s,i,i.bootRung,void 0,i.source));const y={subject:n??null,target:c,byName:fe(t.map(i=>i.source)),memoryTarget:a,listings:"tree",dirs:[],accounting:s},w=p.flatMap(i=>ue(i,y).blocks),m=he(t,y.dirs??[],c),u=new Map(m.map(i=>[i.path,i])),b=new Set(h.map(i=>i.path)),P=[...h.map(i=>u.get(i.path)??i),...m.filter(i=>!b.has(i.path))];for(const i of P)C(i)&&(T(c,i,i.bootRung),B(s,i,i.bootRung,u.has(i.path)?"directory listing attached to content delivery":void 0,i.source));return{contentProse:d,tree:ye(P,o),contentDocs:p,attachmentBlocks:w}}l($,"renderGrouped");function G(e){const o=e.lastIndexOf("/");return o===-1?e:e.slice(o+1)}l(G,"leafSegment");function O(e){return _(e)>=_("name")}l(O,"isVisible");function K(e,o){const n=e.childDirectories.map(c=>K(c,o)),r=[];let t=0;for(const c of e.childDocuments){const f=o.get(c.document.path);f!==void 0&&(O(f.bootRung)?r.push({name:c.name,order:c.order,doc:f}):t+=1)}const s=e.document===null?null:o.get(e.document.path)??null;let a=null;return s!==null&&(O(s.bootRung)?a=s:t+=1),{name:e.name,segment:G(e.name),order:e.order,own:a,children:n,leaves:r,hiddenHere:t,renders:!1,ownCount:0}}l(K,"planDir");function F(e,o){let n=e.hiddenHere;for(const s of e.children)n+=F(s,e.name==="");const r=e.own!==null||e.leaves.length>0,t=e.children.some(s=>s.renders);return e.renders=r||t||o||e.name==="",e.ownCount=e.renders?n:0,e.renders?0:n}l(F,"resolveDir");function W(e){return e.kind==="dir"?e.node.order:e.kind==="leaf"?e.entry.order:""}l(W,"itemOrder");function U(e){return e.kind==="dir"?e.node.name:e.kind==="leaf"?e.entry.name:""}l(U,"itemName");function Y(e,o,n,r){const t=e.bootRung==="preview"?ae(e):"";r.push(t===""?`${n}${o}`:`${n}${o}  # read when: ${t}`)}l(Y,"renderDocEntry");function q(e,o,n){const r=[];for(const t of e.children)t.renders&&r.push({kind:"dir",node:t});for(const t of e.leaves)r.push({kind:"leaf",entry:t});r.sort((t,s)=>W(t).localeCompare(W(s))||U(t).localeCompare(U(s))),e.ownCount>0&&r.push({kind:"more",count:e.ownCount}),r.forEach((t,s)=>{const a=s===r.length-1,c=o+(a?"\u2514\u2500 ":"\u251C\u2500 "),f=o+(a?"   ":"\u2502  ");switch(t.kind){case"more":n.push(`${c}[+${t.count} more]`);break;case"dir":{const h=`${t.node.segment}/`;t.node.own===null?n.push(`${c}${h}`):Y(t.node.own,h,c,n),q(t.node,f,n);break}case"leaf":Y(t.entry.doc,G(t.entry.name),c,n);break}})}l(q,"renderChildren");function ye(e,o){if(e.length===0)return"";const n=new Map;for(const s of e)n.has(s.path)||n.set(s.path,s);const r=K(S(e.map(s=>s.source)).root,n);F(r,!1);const t=[o];return q(r,"",t),t.join(`
+`)}l(ye,"buildTree");const v="Each %s below shows either its full content (indented beneath its name), a `# read when:` line telling you when to read the full document, or simply its name.",we="Preferences are how the user wants you to behave \u2014 standing directives and corrections. To read a preference, run `crtr memory read <name>`. "+v.replace("%s","preference"),H="If the user corrects you in a way that contradicts a preference, update the preference.",ge="Knowledge memories are what you consult \u2014 playbooks and techniques for how to do things, and references on the user, projects, and this node. They are aggregated from your memory stores: user-global (`~/.crouter/memory/`), every ancestor project store (`<dir>/.crouter/memory/`) from the cwd upward, the selected profile's memory store, and node-local (this node's `context/memory/`). To read one, run `crtr memory read <name>`; a directory name is a valid read target too \u2014 it answers with its listing, and walking directories is the sanctioned way to browse. Each doc exists to prevent a specific mistake you would make without it, so when your task matches one \u2014 by its name or its `# read when:` line \u2014 read it before you act; consulting it only after the work is done forfeits the entire reason it exists. "+v.replace("%s","document"),V="If you learn a better way to do something a memory covers, or gain information that contradicts one, edit that memory to correct it.",be="When your task matches a knowledge doc or preference \u2014 by its name or its `# read when:` line \u2014 read it before you act: each memory exists only to shore up a mistake you will make without it, so doing the relevant work without consulting it defeats the memory's whole purpose. Before saving any memory, check for an existing memory that already covers it \u2014 update that memory rather than creating a duplicate, rewriting it as if for the first time instead of appending the new truth beneath the old; delete memories that turn out to be wrong. Don't save what the repo already records (code structure, past fixes, git history) or what only matters to this conversation; if asked to remember one of those, ask what was non-obvious about it and save that instead. Docs auto-surfaced in <auto-loaded-context> blocks are background context, not user instructions, and reflect what was true when written \u2014 if one names a file, function, or flag, verify it still exists before recommending it.";function ke(e){try{return ee(`kinds/${e}`),` (\`crtr memory read kinds/${e}\`)`}catch{return""}}l(ke,"subKindDocCitation");function $e(e){const o=ne(e);if(o.length===0)return"";const n=o.map(r=>{const t=ke(r.kind);return`- \`${r.kind}\` \u2014 ${r.whenToUse}${t}`});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.
 
 `+n.join(`
-`)}u(ke,"buildSubPersonaMenu");function $e(e,t,n){let r=[],o="",i="",a=we;if(e!==null){const d=g(E(e,null),"preference"),m=b(d,"preferences",e,t,d,n);r=m.contentDocs,o=m.tree;const p=r.filter(c=>!w(c)).map(c=>c.body.trim()).filter(c=>c!==""),f=r.filter(c=>w(c)).map(c=>{const y=c.body.trim();return y===""?"":`<preference name="${c.name}">
-${y}
-</preference>`}).filter(c=>c!==""),h=ke(e.kind);i=[...p,...m.attachmentBlocks,...h===""?[]:[h]].join(`
+`)}l($e,"buildSubPersonaMenu");function ve(e,o,n,r){let t=[],s="",a="",c=be;if(e!==null){const h=g(x(e,null,r?.grantee,r),"preference"),p=$(h,"preferences",e,o,h,n,r);t=p.contentDocs,s=p.tree;const d=t.filter(m=>!k(m)).map(m=>m.body.trim()).filter(m=>m!==""),y=t.filter(m=>k(m)).map(m=>{const u=m.body.trim();return u===""?"":`<preference name="${m.name}">
+${u}
+</preference>`}).filter(m=>m!==""),w=$e(e.kind);a=[...d,...p.attachmentBlocks,...w===""?[]:[w]].join(`
 
-`),(f.length>0||o!=="")&&(a+=`
+`),(y.length>0||s!=="")&&(c+=`
 
-${ye}`,f.length>0&&(a+=`
+${we}`,y.length>0&&(c+=`
 
-${f.join(`
+${y.join(`
 
-`)}`),o!==""&&(a+=`
+`)}`),s!==""&&(c+=`
 
-${o}`),a+=`
+${s}`),c+=`
 
-${U}`)}const l=`<memory kind="preference">
-${a}
-</memory>`;return{block:i===""?l:`${i}
+${H}`)}const f=`<memory kind="preference">
+${c}
+</memory>`;return{block:a===""?f:`${a}
 
-${l}`,contentDocs:r,tree:o}}u($e,"buildPreferencesBlock");function Le(e,t,n){return $e(e,t,n)}u(Le,"renderPreferencesForSubject");function Ge(e,t,n,r){const o=g(E(e,t),"knowledge"),{contentProse:i,tree:a,attachmentBlocks:l}=b(o,"knowledge",e,n,o,r),d=[i,...l].filter(p=>p!=="").join(`
+${f}`,contentDocs:t,tree:s}}l(ve,"buildPreferencesBlock");function Ie(e,o,n,r){return ve(e,o,n,r)}l(Ie,"renderPreferencesForSubject");function Ge(e,o,n,r,t,s){const a=g(x(e,o,t,s),"knowledge"),{contentProse:c,tree:f,attachmentBlocks:h}=$(a,"knowledge",e,n,a,r,s),p=[c,...h].filter(y=>y!=="").join(`
 
-`);if(d===""&&a==="")return"";let m=ge;return d!==""&&(m+=`
+`);if(p===""&&f==="")return"";let d=ge;return p!==""&&(d+=`
 
-${d}`),a!==""&&(m+=`
+${p}`),f!==""&&(d+=`
 
-${a}`),m+=`
+${f}`),d+=`
 
-${Y}`,T(`<memory kind="knowledge">
-${m}
-</memory>`,t)}u(Ge,"renderKnowledgeForSubject");const ve="Your node configuration changed. This operating protocol is in force for you now:",Ee="Your new configuration puts these preferences in force \u2014 standing directives and corrections from the user. To read one, run `crtr memory read <name>`. "+k.replace("%s","preference"),Re="Your new configuration exposes these knowledge documents \u2014 consult them exactly like the rest of your catalog (`crtr memory read <name>`). "+k.replace("%s","document");function H(e,t){return t.filter(n=>R(n)&&!v(e.state,n.path,n.body,n.bootRung))}u(H,"undelivered");function Ie(e,t,n){const r=E(e,t),o=H(n,g(r,"preference")),{contentDocs:i,tree:a,attachmentBlocks:l}=b(o,"preferences",e,n,g(r,"preference")),d=i.filter(c=>!w(c)).map(c=>c.body.trim()).filter(c=>c!==""),m=i.filter(c=>w(c)).map(c=>{const y=c.body.trim();return y===""?"":`<preference name="${c.name}">
-${y}
-</preference>`}).filter(c=>c!==""),p=[];if((d.length>0||l.length>0)&&p.push(`${ve}
+${V}`,M(`<memory kind="knowledge">
+${d}
+</memory>`,o,t)}l(Ge,"renderKnowledgeForSubject");const Ee="Your node configuration changed. This operating protocol is in force for you now:",Re="Your new configuration puts these preferences in force \u2014 standing directives and corrections from the user. To read one, run `crtr memory read <name>`. "+v.replace("%s","preference"),De="Your new configuration exposes these knowledge documents \u2014 consult them exactly like the rest of your catalog (`crtr memory read <name>`). "+v.replace("%s","document");function z(e,o){return o.filter(n=>C(n)&&!R(e.state,n.path,n.body,n.bootRung))}l(z,"undelivered");function Ke(e,o,n,r,t){const s=x(e,o,r,t),a=z(n,g(s,"preference")),{contentDocs:c,tree:f,attachmentBlocks:h}=$(a,"preferences",e,n,g(s,"preference"),void 0,t),p=c.filter(u=>!k(u)).map(u=>u.body.trim()).filter(u=>u!==""),d=c.filter(u=>k(u)).map(u=>{const b=u.body.trim();return b===""?"":`<preference name="${u.name}">
+${b}
+</preference>`}).filter(u=>u!==""),y=[];if((p.length>0||h.length>0)&&y.push(`${Ee}
 
-${[...d,...l].join(`
+${[...p,...h].join(`
 
-`)}`),m.length>0||a!==""){let c=Ee;m.length>0&&(c+=`
+`)}`),d.length>0||f!==""){let u=Re;d.length>0&&(u+=`
 
-${m.join(`
+${d.join(`
 
-`)}`),a!==""&&(c+=`
+`)}`),f!==""&&(u+=`
 
-${a}`),c+=`
+${f}`),u+=`
 
-${U}`,p.push(`<memory kind="preference">
-${c}
-</memory>`)}const f=b(H(n,g(r,"knowledge")),"knowledge",e,n,g(r,"knowledge")),h=[f.contentProse,...f.attachmentBlocks].filter(c=>c!=="").join(`
+${H}`,y.push(`<memory kind="preference">
+${u}
+</memory>`)}const w=$(z(n,g(s,"knowledge")),"knowledge",e,n,g(s,"knowledge"),void 0,t),m=[w.contentProse,...w.attachmentBlocks].filter(u=>u!=="").join(`
 
-`);if(h!==""||f.tree!==""){let c=Re;h!==""&&(c+=`
+`);if(m!==""||w.tree!==""){let u=De;m!==""&&(u+=`
 
-${h}`),f.tree!==""&&(c+=`
+${m}`),w.tree!==""&&(u+=`
 
-${f.tree}`),c+=`
+${w.tree}`),u+=`
 
-${Y}`,p.push(`<memory kind="knowledge">
-${c}
-</memory>`)}return p.length===0?"":T(p.join(`
+${V}`,y.push(`<memory kind="knowledge">
+${u}
+</memory>`)}return y.length===0?"":M(y.join(`
 
-`),t)}u(Ie,"renderConfigChangeDelta");export{ke as buildSubPersonaMenu,Ie as renderConfigChangeDelta,Ge as renderKnowledgeForSubject,Le as renderPreferencesForSubject};
+`),o,r)}l(Ke,"renderConfigChangeDelta");export{$e as buildSubPersonaMenu,Ke as renderConfigChangeDelta,Ge as renderKnowledgeForSubject,Ie as renderPreferencesForSubject};

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

@@ -2,6 +2,10 @@ import { type ProfileProjectMemory } from '../../api/dto/profiles.js';
 import type { MemoryDoc, MemoryScope } from '../memory-resolver.js';
 export declare const KINDS: readonly ["knowledge", "preference"];
 export type DocKind = (typeof KINDS)[number];
+export declare const PRIVACY_LEVELS: readonly ["public", "friends", "private"];
+export type PrivacyLevel = (typeof PRIVACY_LEVELS)[number];
+/** Missing or malformed privacy is treated conservatively on reads; lint rejects malformed values. */
+export declare function effectivePrivacy(fm: Record<string, unknown> | null): PrivacyLevel;
 /** 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"];
@@ -51,6 +55,8 @@ export type GatePredicate = Record<string, unknown>;
 export interface SubstrateSchema {
     /** Which of the two semantic kinds (knowledge | preference). */
     kind: DocKind;
+    /** App access level; legacy documents without the field resolve to private. */
+    privacy: PrivacyLevel;
     /** The read-routing line — a single sentence answering WHEN to read this doc
      *  and WHY it is worth the read: "When <circumstance>, this <kind> should be
      *  read because <broader downstream payoff>." (design §4). This is

package/dist/core/substrate/schema.js

@@ -1 +1 @@
-var l=Object.defineProperty;var t=(e,n)=>l(e,"name",{value:n,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as m}from"../../api/dto/profiles.js";const y=["knowledge","preference"];function g(e){return typeof e=="string"&&y.includes(e)}t(g,"isDocKind");const h=m;function a(e){return h.indexOf(e)}t(a,"rungRank");function F(e,n){return a(e)>=a(n)}t(F,"rungAtLeast");function D(e,n){return a(e)<=a(n)?e:n}t(D,"minRung");import{normalizeNameSegment as j,normalizeDocName as G,resolveLocalName as O}from"../memory/identity.js";const x=["boot","workspace-open","read","memory-read","command","pre-command"],A=["name","preview","content"];function R(e){return e===null||!g(e.kind)?null:{kind:e.kind,whenAndWhyToRead:p(e["when-and-why-to-read"]),shortForm:p(e["short-form"]),unlisted:e.unlisted===!0,surfaces:k(e.surfaces),gate:f(e.gate),slash:e.slash===!0,rationale:S(e.rationale)}}t(R,"parseSubstrateFrontmatter");function w(e){const n=R(e.frontmatter);return n===null?null:{...n,name:e.name,scope:e.scope,plugin:e.plugin,path:e.path,body:e.body,projectMemory:e.projectMemory}}t(w,"parseSubstrateDoc");function L(e){const n=w(e);if(n!==null)return n.kind;const r=e.frontmatter?.kind;return typeof r=="string"?r:"knowledge"}t(L,"effectiveDocKind");function M(e){const n=e.whenAndWhyToRead.trim().replace(/\.+$/,"");return n===""?"":`${n}.`}t(M,"previewLine");function p(e){return typeof e=="string"?e:""}t(p,"strField");function S(e){return typeof e=="string"&&e.trim()!==""?e:void 0}t(S,"parseRationale");function f(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}t(f,"parseGate");function k(e){if(!Array.isArray(e))return[];const n=[];for(const r of e){if(r===null||typeof r!="object"||Array.isArray(r))continue;const i=r,o=i.on;if(typeof o!="string"||!x.includes(o))continue;const u=i.at;if(typeof u!="string"||!A.includes(u))continue;const s=b(i.match),c=o==="read"?f(i["match-frontmatter"]):void 0,d=f(i.gate);(o==="read"||o==="memory-read"||o==="command"||o==="pre-command")&&s===void 0&&c===void 0||n.push({on:o,at:u,...s!==void 0?{match:s}:{},...c!==void 0?{matchFrontmatter:c}:{},...d!==void 0?{gate:d}:{}})}return n}t(k,"parseSurfaces");function b(e){if(typeof e=="string"){const n=e.trim();return n===""?void 0:[n]}if(Array.isArray(e)){const n=e.filter(r=>typeof r=="string"&&r.trim()!=="").map(r=>r.trim());return n.length>0?n:void 0}}t(b,"parseMatchGlobs");export{y as KINDS,h as RUNGS,x as SURFACE_EVENTS,A as SURFACE_RUNGS,L as effectiveDocKind,g as isDocKind,D as minRung,G as normalizeDocName,j as normalizeNameSegment,w as parseSubstrateDoc,R as parseSubstrateFrontmatter,k as parseSurfaces,M as previewLine,O as resolveDocName,F as rungAtLeast,a as rungRank};
+var l=Object.defineProperty;var t=(e,n)=>l(e,"name",{value:n,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as m}from"../../api/dto/profiles.js";const y=["knowledge","preference"],g=["public","friends","private"];function h(e){const n=e?.privacy;return typeof n=="string"&&g.includes(n)?n:"private"}t(h,"effectivePrivacy");function x(e){return typeof e=="string"&&y.includes(e)}t(x,"isDocKind");const A=m;function a(e){return A.indexOf(e)}t(a,"rungRank");function D(e,n){return a(e)>=a(n)}t(D,"rungAtLeast");function _(e,n){return a(e)<=a(n)?e:n}t(_,"minRung");import{normalizeNameSegment as G,normalizeDocName as O,resolveLocalName as P}from"../memory/identity.js";const R=["boot","workspace-open","read","memory-read","command","pre-command"],S=["name","preview","content"];function w(e){return e===null||!x(e.kind)?null:{kind:e.kind,privacy:h(e),whenAndWhyToRead:d(e["when-and-why-to-read"]),shortForm:d(e["short-form"]),unlisted:e.unlisted===!0,surfaces:E(e.surfaces),gate:p(e.gate),slash:e.slash===!0,rationale:k(e.rationale)}}t(w,"parseSubstrateFrontmatter");function b(e){const n=w(e.frontmatter);return n===null?null:{...n,name:e.name,scope:e.scope,plugin:e.plugin,path:e.path,body:e.body,projectMemory:e.projectMemory}}t(b,"parseSubstrateDoc");function M(e){const n=b(e);if(n!==null)return n.kind;const r=e.frontmatter?.kind;return typeof r=="string"?r:"knowledge"}t(M,"effectiveDocKind");function U(e){const n=e.whenAndWhyToRead.trim().replace(/\.+$/,"");return n===""?"":`${n}.`}t(U,"previewLine");function d(e){return typeof e=="string"?e:""}t(d,"strField");function k(e){return typeof e=="string"&&e.trim()!==""?e:void 0}t(k,"parseRationale");function p(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}t(p,"parseGate");function E(e){if(!Array.isArray(e))return[];const n=[];for(const r of e){if(r===null||typeof r!="object"||Array.isArray(r))continue;const i=r,o=i.on;if(typeof o!="string"||!R.includes(o))continue;const u=i.at;if(typeof u!="string"||!S.includes(u))continue;const s=N(i.match),c=o==="read"?p(i["match-frontmatter"]):void 0,f=p(i.gate);(o==="read"||o==="memory-read"||o==="command"||o==="pre-command")&&s===void 0&&c===void 0||n.push({on:o,at:u,...s!==void 0?{match:s}:{},...c!==void 0?{matchFrontmatter:c}:{},...f!==void 0?{gate:f}:{}})}return n}t(E,"parseSurfaces");function N(e){if(typeof e=="string"){const n=e.trim();return n===""?void 0:[n]}if(Array.isArray(e)){const n=e.filter(r=>typeof r=="string"&&r.trim()!=="").map(r=>r.trim());return n.length>0?n:void 0}}t(N,"parseMatchGlobs");export{y as KINDS,g as PRIVACY_LEVELS,A as RUNGS,R as SURFACE_EVENTS,S as SURFACE_RUNGS,M as effectiveDocKind,h as effectivePrivacy,x as isDocKind,_ as minRung,O as normalizeDocName,G as normalizeNameSegment,b as parseSubstrateDoc,w as parseSubstrateFrontmatter,E as parseSurfaces,U as previewLine,P as resolveDocName,D as rungAtLeast,a as rungRank};

package/dist/core/tui/panel.js

@@ -1 +1 @@
-var T=Object.defineProperty;var a=(r,e)=>T(r,"name",{value:e,configurable:!0});import{getMarkdownTheme as p,getSelectListTheme as k,getSettingsListTheme as R}from"@earendil-works/pi-coding-agent";import{truncateToWidth as s,visibleWidth as d}from"@earendil-works/pi-tui";const L=a(r=>`\x1B[32m${r}\x1B[39m`,"ansiGreen"),W=a(r=>`\x1B[33m${r}\x1B[39m`,"ansiYellow"),m={fg(r,e){switch(r){case"border":return p().hr(e);case"accent":return p().heading(e);case"dim":return R().description(e);case"muted":return k().description(e);case"mdLink":return p().link(e);case"mdLinkUrl":return p().linkUrl(e);case"success":return L(e);case"warning":return W(e)}},bg(r,e){return`\x1B[7m${e}\x1B[27m`},bold(r){return p().bold(r)}};function A(r,e){const t=r.trim();if(t==="")return[""];if(e<=1)return[s(t,e)];const o=[];let n="";for(const i of t.split(/\s+/)){if(n===""){n=i;continue}const c=`${n} ${i}`;s(c,e)===c?n=c:(o.push(s(n,e)),n=i)}return n!==""&&o.push(s(n,e)),o.length>0?o:[""]}a(A,"wrapText");function E(r,e){return r.map(t=>s(t,e))}a(E,"renderRows");function b(r,e){const t=d(r);return t>=e?s(r,e):`${r}${" ".repeat(e-t)}`}a(b,"padAnsi");function $(r){return m.fg("border","\u2500".repeat(Math.max(0,r)))}a($,"rule");function G(r,e,t){if(r<=0)return{start:0,end:0};const o=Math.max(1,Math.min(t,r)),n=Math.max(0,Math.min(e-Math.floor(o/2),r-o));return{start:n,end:Math.min(r,n+o)}}a(G,"visibleRange");function O(r,e){if(e<4)return r.map(c=>s(c,e));const t=e-4,o=m.fg("border","\u2502"),n=m.fg("border",`\u250C${"\u2500".repeat(e-2)}\u2510`),i=m.fg("border",`\u2514${"\u2500".repeat(e-2)}\u2518`);return[n,...r.map(c=>`${o} ${b(s(c,t),t)} ${o}`),i]}a(O,"framed");function U(r,e){return e>=r.length?r:r.slice(r.length-e)}a(U,"fitTail");const v=4;function w(r){const{width:e,height:t,title:o,meta:n,body:i,footer:c}=r,u=m.fg("accent",m.bold(o)),l=n?m.fg("dim",n):"",f=e-d(u)-d(l),x=l!==""&&f>=2?`${u}${" ".repeat(f)}${l}`:s(u,e),h=Math.max(1,t-v),g=i.slice(0,h);for(;g.length<h;)g.push("");return[s(x,e),$(e),...g.map(M=>s(M,e)),$(e),s(c,e)]}a(w,"pageFrame");function y(r,e,t,o){const n=m.fg("border","\u2502"),i=Math.max(r.length,t.length),c=[];for(let u=0;u<i;u+=1){const l=b(r[u]??"",e),f=s(t[u]??"",o);c.push(`${l} ${n} ${f}`)}return c}a(y,"columns");export{v as PAGE_CHROME_ROWS,y as columns,U as fitTail,O as framed,b as padAnsi,w as pageFrame,E as renderRows,$ as rule,m as theme,G as visibleRange,A as wrapText};
+var T=Object.defineProperty;var i=(r,e)=>T(r,"name",{value:e,configurable:!0});import{getMarkdownTheme as p,getSelectListTheme as k,getSettingsListTheme as C}from"@earendil-works/pi-coding-agent";import{truncateToWidth as s,visibleWidth as g}from"@earendil-works/pi-tui";import{detectColorCaps as R}from"./draw.js";const L=i(r=>`\x1B[32m${r}\x1B[39m`,"ansiGreen"),W=i(r=>`\x1B[33m${r}\x1B[39m`,"ansiYellow"),m={fg(r,e){if(!R().color)return e;switch(r){case"border":return p().hr(e);case"accent":return p().heading(e);case"dim":return C().description(e);case"muted":return k().description(e);case"mdLink":return p().link(e);case"mdLinkUrl":return p().linkUrl(e);case"success":return L(e);case"warning":return W(e)}},bg(r,e){return`\x1B[7m${e}\x1B[27m`},bold(r){return p().bold(r)}};function G(r,e){const t=r.trim();if(t==="")return[""];if(e<=1)return[s(t,e)];const o=[];let n="";for(const a of t.split(/\s+/)){if(n===""){n=a;continue}const c=`${n} ${a}`;s(c,e)===c?n=c:(o.push(s(n,e)),n=a)}return n!==""&&o.push(s(n,e)),o.length>0?o:[""]}i(G,"wrapText");function O(r,e){return r.map(t=>s(t,e))}i(O,"renderRows");function b(r,e){const t=g(r);return t>=e?s(r,e):`${r}${" ".repeat(e-t)}`}i(b,"padAnsi");function $(r){return m.fg("border","\u2500".repeat(Math.max(0,r)))}i($,"rule");function U(r,e,t){if(r<=0)return{start:0,end:0};const o=Math.max(1,Math.min(t,r)),n=Math.max(0,Math.min(e-Math.floor(o/2),r-o));return{start:n,end:Math.min(r,n+o)}}i(U,"visibleRange");function w(r,e){if(e<4)return r.map(c=>s(c,e));const t=e-4,o=m.fg("border","\u2502"),n=m.fg("border",`\u250C${"\u2500".repeat(e-2)}\u2510`),a=m.fg("border",`\u2514${"\u2500".repeat(e-2)}\u2518`);return[n,...r.map(c=>`${o} ${b(s(c,t),t)} ${o}`),a]}i(w,"framed");function y(r,e){return e>=r.length?r:r.slice(r.length-e)}i(y,"fitTail");const v=4;function F(r){const{width:e,height:t,title:o,meta:n,body:a,footer:c}=r,u=m.fg("accent",m.bold(o)),l=n?m.fg("dim",n):"",f=e-g(u)-g(l),x=l!==""&&f>=2?`${u}${" ".repeat(f)}${l}`:s(u,e),h=Math.max(1,t-v),d=a.slice(0,h);for(;d.length<h;)d.push("");return[s(x,e),$(e),...d.map(M=>s(M,e)),$(e),s(c,e)]}i(F,"pageFrame");function H(r,e,t,o){const n=m.fg("border","\u2502"),a=Math.max(r.length,t.length),c=[];for(let u=0;u<a;u+=1){const l=b(r[u]??"",e),f=s(t[u]??"",o);c.push(`${l} ${n} ${f}`)}return c}i(H,"columns");export{v as PAGE_CHROME_ROWS,H as columns,y as fitTail,w as framed,b as padAnsi,F as pageFrame,O as renderRows,$ as rule,m as theme,U as visibleRange,G as wrapText};

package/dist/core/user-settings.d.ts

@@ -343,6 +343,18 @@ export declare const CONFIG_SETTINGS_COVERAGE: {
         surface: "specialized";
         owner: string;
     };
+    paths: {
+        surface: "specialized";
+        owner: string;
+    };
+    store: {
+        surface: "specialized";
+        owner: string;
+    };
+    runtime: {
+        surface: "specialized";
+        owner: string;
+    };
     spawnEnv: {
         surface: "specialized";
         owner: string;

package/dist/core/user-settings.js

@@ -1 +1 @@
-var v=Object.defineProperty;var s=(e,t)=>v(e,"name",{value:t,configurable:!0});import{CONDENSED_HISTORY_MODES as u,MOUSE_MODE_DEFAULTS as p,WHIP_MESSAGE_MODES as d}from"../types.js";function i(e,t,o){const r=e.indexOf(t),a=r>=0?r:0;return e[(a+o+e.length)%e.length]}s(i,"cycleChoice");function c(e,t,o){const r=e.indexOf(t);return r>=0?e[(r+o+e.length)%e.length]:o>=0?e.find(a=>a>t)??e[0]:[...e].reverse().find(a=>a<t)??e[e.length-1]}s(c,"cycleNumber");function n(e,t){return e==="true"?!0:e==="false"?!1:`${t} must be true or false`}s(n,"booleanFromString");function f(e,t){if(!/^\d+$/.test(e))return`${t} must be an integer >= 0`;const o=Number(e);return Number.isSafeInteger(o)?o:`${t} must be an integer >= 0`}s(f,"nonNegativeIntegerFromString");function _(e,t){const o=f(e,t);return typeof o=="string"||o<1?`${t} must be an integer >= 1`:o}s(_,"positiveIntegerFromString");const m=[!1,"notify","apply"],w=[0,1,6,12,24,48,72,168],b=[1,2,3,4,5,6,8,10,12],l="openai-codex";function g(e,t){const o=e.providerOptions[t];if(o!==void 0)return o;const r={};return e.providerOptions[t]=r,r}s(g,"providerOptionsFor");const x=[1,2,3,4,5,6],h={schema_version:{surface:"specialized",owner:"internal schema migration"},marketplaces:{surface:"specialized",owner:"Plugins and pkg market commands"},plugins:{surface:"specialized",owner:"Plugins tab and pkg plugin commands"},auto_update:{surface:"settings",settings:{crtr:{key:"auto_update.crtr",label:"crouter updates",description:"Notify about crouter releases, install them automatically, or turn checks off.",valueConstraint:"true|false|notify|apply; true stores notify",applies:"Applies on the next crouter command.",group:"updates",order:70,format:s(e=>e.auto_update.crtr===!1?"off":e.auto_update.crtr,"format"),cycle:s((e,t)=>{e.auto_update.crtr=i(m,e.auto_update.crtr,t)},"cycle"),setFromString:s((e,t)=>{const o=t==="true"?"notify":t;return o!=="notify"&&o!=="apply"&&o!=="false"?"auto_update.crtr must be notify, apply, or false":(e.auto_update.crtr=o==="false"?!1:o,null)},"setFromString")},content:{key:"auto_update.content",label:"Content updates",description:"Notify about plugin and marketplace updates, apply them automatically, or turn checks off.",valueConstraint:"false|notify|apply",applies:"Applies on the next crouter command.",group:"updates",order:80,format:s(e=>e.auto_update.content===!1?"off":e.auto_update.content,"format"),cycle:s((e,t)=>{e.auto_update.content=i(m,e.auto_update.content,t)},"cycle"),setFromString:s((e,t)=>t!=="notify"&&t!=="apply"&&t!=="false"?"auto_update.content must be notify, apply, or false":(e.auto_update.content=t==="false"?!1:t,null),"setFromString")},interval_hours:{key:"auto_update.interval_hours",label:"Update interval",description:"Minimum hours between automatic update checks. Zero checks on every command.",valueConstraint:"integer >= 0",applies:"Applies on the next crouter command.",group:"updates",order:90,format:s(e=>`${e.auto_update.interval_hours}h`,"format"),cycle:s((e,t)=>{e.auto_update.interval_hours=c(w,e.auto_update.interval_hours,t)},"cycle"),setFromString:s((e,t)=>{const o=f(t,"auto_update.interval_hours");return typeof o=="string"?o:(e.auto_update.interval_hours=o,null)},"setFromString")}}},max_panes_per_window:{surface:"settings",setting:{key:"max_panes_per_window",label:"Maximum panes",description:"Maximum human-review panes placed in one tmux window before using another window.",valueConstraint:"integer >= 1",applies:"Applies to the next pane placement.",group:"panes",order:20,format:s(e=>String(e.max_panes_per_window),"format"),cycle:s((e,t)=>{e.max_panes_per_window=c(b,e.max_panes_per_window,t)},"cycle"),setFromString:s((e,t)=>{const o=_(t,"max_panes_per_window");return typeof o=="string"?o:(e.max_panes_per_window=o,null)},"setFromString")}},auto_open_child_viewers:{surface:"settings",setting:{key:"auto_open_child_viewers",label:"Open child panes",description:"Open each managed child beside its watched parent. Off keeps new children running in the background.",valueConstraint:"true|false",applies:"Applies to the next managed child created; independent roots still open their attended viewer.",group:"panes",order:10,format:s(e=>e.auto_open_child_viewers?"on":"off","format"),cycle:s(e=>{e.auto_open_child_viewers=!e.auto_open_child_viewers},"cycle"),setFromString:s((e,t)=>{const o=n(t,"auto_open_child_viewers");return typeof o=="string"?o:(e.auto_open_child_viewers=o,null)},"setFromString")}},brokerThresholds:{surface:"specialized",owner:"Broker limits tab"},lifecycle:{surface:"specialized",owner:"sys config set lifecycle.unattendedParkMs"},completion_bell:{surface:"settings",setting:{key:"completion_bell",label:"Completion bell",description:"Ring a short sound when the node in an attached viewer finishes a turn.",valueConstraint:"true|false",applies:"Applies on the next turn end.",group:"display",order:41,format:s(e=>e.completion_bell?"on":"off","format"),cycle:s(e=>{e.completion_bell=!e.completion_bell},"cycle"),setFromString:s((e,t)=>{const o=n(t,"completion_bell");return typeof o=="string"?o:(e.completion_bell=o,null)},"setFromString")}},working_gerunds:{surface:"specialized",owner:"sys config set working_gerunds"},whip_mode:{surface:"settings",setting:{key:"whip_mode",label:"Whip mode",description:"Play the whip animation when you send a prompt and when a viewer opens for an agent with an initial prompt.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:39,format:s(e=>e.whip_mode?"on":"off","format"),cycle:s(e=>{e.whip_mode=!e.whip_mode},"cycle"),setFromString:s((e,t)=>{const o=n(t,"whip_mode");return typeof o=="string"?o:(e.whip_mode=o,null)},"setFromString")}},page_surface:{surface:"settings",setting:{key:"page_surface",label:"Page human surface",description:"This host reads pages in a browser rather than a terminal. Agents are told the page module runs as written, HTML pages are offered, and document review and live display leave the command tree.",valueConstraint:"true|false",applies:"Applies when human command help is assembled.",group:"display",order:37,format:s(e=>e.page_surface?"on":"off","format"),cycle:s(e=>{e.page_surface=!e.page_surface},"cycle"),setFromString:s((e,t)=>{const o=n(t,"page_surface");return typeof o=="string"?o:(e.page_surface=o,null)},"setFromString")}},whip_messages:{surface:"specialized",owner:"sys config set whip_messages"},whip_message_mode:{surface:"settings",setting:{key:"whip_message_mode",label:"Whip message",description:"What the whip action sends: a random line from whip_messages, or the fixed \u201CGo faster\u201D.",valueConstraint:d.join("|"),applies:"Applies on the next attach.",group:"display",order:40,format:s(e=>e.whip_message_mode==="go-faster"?"go faster":"random","format"),cycle:s((e,t)=>{e.whip_message_mode=i(d,e.whip_message_mode,t)},"cycle"),setFromString:s((e,t)=>d.includes(t)?(e.whip_message_mode=t,null):`whip_message_mode must be one of: ${d.join("|")}`,"setFromString")}},mouse_mode_default:{surface:"settings",setting:{key:"mouse_mode_default",label:"Default mouse mode",description:"Initial mouse wheel scrolling for each attached viewer.",valueConstraint:p.join("|"),applies:"Applies on the next attach.",group:"display",order:38,format:s(e=>e.mouse_mode_default==="tmux"?"follow tmux":e.mouse_mode_default,"format"),cycle:s((e,t)=>{e.mouse_mode_default=i(p,e.mouse_mode_default,t)},"cycle"),setFromString:s((e,t)=>p.includes(t)?(e.mouse_mode_default=t,null):`mouse_mode_default must be one of: ${p.join("|")}`,"setFromString")}},live_cycles:{surface:"settings",setting:{key:"live_cycles",label:"Live cycles",description:"Trailing refresh cycles rendered at full fidelity; older cycles condense to text.",valueConstraint:"integer >= 1",applies:"Applies on the next attach.",group:"display",order:50,format:s(e=>String(e.live_cycles),"format"),cycle:s((e,t)=>{e.live_cycles=c(x,e.live_cycles,t)},"cycle"),setFromString:s((e,t)=>{const o=_(t,"live_cycles");return typeof o=="string"?o:(e.live_cycles=o,null)},"setFromString")}},condensed_history:{surface:"settings",setting:{key:"condensed_history",label:"Condensed history",description:"Messages retained from condensed cycles. Tool calls are never kept.",valueConstraint:u.join("|"),applies:"Applies on the next attach.",group:"display",order:60,format:s(e=>e.condensed_history,"format"),cycle:s((e,t)=>{e.condensed_history=i(u,e.condensed_history,t)},"cycle"),setFromString:s((e,t)=>u.includes(t)?(e.condensed_history=t,null):`condensed_history must be one of: ${u.join("|")}`,"setFromString")}},bash_tool_purpose:{surface:"settings",setting:{key:"bash_tool_purpose",label:"Bash purpose field",description:"Expose the optional purpose label to agents in the bash tool schema. Off removes the field without disabling the bash valve.",valueConstraint:"true|false",applies:"Applies on the next node session.",group:"display",order:25,format:s(e=>e.bash_tool_purpose?"on":"off","format"),cycle:s(e=>{e.bash_tool_purpose=!e.bash_tool_purpose},"cycle"),setFromString:s((e,t)=>{const o=n(t,"bash_tool_purpose");return typeof o=="string"?o:(e.bash_tool_purpose=o,null)},"setFromString")}},fold_finished_tools:{surface:"settings",setting:{key:"fold_finished_tools",label:"Fold finished tools",description:"Fold every settled tool call to its call line. Toggle live with /fold-tools.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:30,format:s(e=>e.fold_finished_tools?"on":"off","format"),cycle:s(e=>{e.fold_finished_tools=!e.fold_finished_tools},"cycle"),setFromString:s((e,t)=>{const o=n(t,"fold_finished_tools");return typeof o=="string"?o:(e.fold_finished_tools=o,null)},"setFromString")}},summarize_tool_calls:{surface:"settings",setting:{key:"summarize_tool_calls",label:"Summarize tool calls",description:"Replace completed folded tool-call groups with a one-line broker summary when available.",valueConstraint:"true|false",applies:"Applies when the next visible message closes a tool-call group.",group:"display",order:35,format:s(e=>e.summarize_tool_calls?"on":"off","format"),cycle:s(e=>{e.summarize_tool_calls=!e.summarize_tool_calls},"cycle"),setFromString:s((e,t)=>{const o=n(t,"summarize_tool_calls");return typeof o=="string"?o:(e.summarize_tool_calls=o,null)},"setFromString")}},detailed_tool_recaps:{surface:"settings",setting:{key:"detailed_tool_recaps",label:"Detailed tool recaps",description:"Show each memory read and edited file in folded tool recaps. Off shows a compact count line instead.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:36,format:s(e=>e.detailed_tool_recaps?"on":"off","format"),cycle:s(e=>{e.detailed_tool_recaps=!e.detailed_tool_recaps},"cycle"),setFromString:s((e,t)=>{const o=n(t,"detailed_tool_recaps");return typeof o=="string"?o:(e.detailed_tool_recaps=o,null)},"setFromString")}},keybindings:{surface:"specialized",owner:"Keybindings tab"},tmux_passthrough:{surface:"specialized",owner:"Keybindings tab"},providerOptions:{surface:"settings",settings:{"openai-codex.fastMode":{key:`providerOptions.${l}.fastMode`,label:"Codex fast mode",description:"Serve Codex turns at the ChatGPT priority tier: about 1.5x faster generation for about 2x the credits. Displayed cost does not reflect the premium.",valueConstraint:"true|false",applies:"Applies on each node's next turn.",group:"providers",order:40,format:s(e=>e.providerOptions[l]?.fastMode?"on":"off","format"),cycle:s(e=>{const t=g(e,l);t.fastMode=!t.fastMode},"cycle"),setFromString:s((e,t)=>{const o=n(t,`providerOptions.${l}.fastMode`);return typeof o=="string"?o:(g(e,l).fastMode=o,null)},"setFromString")}}},modelLadders:{surface:"specialized",owner:"Models tab"},modelRoutes:{surface:"specialized",owner:"Models route declarations"},modelRouting:{surface:"specialized",owner:"Models route declarations"},kinds:{surface:"specialized",owner:"Models tab and kind registry"},page_components:{surface:"specialized",owner:"Page component catalog: product-registered page component kinds"},remoteCanvas:{surface:"specialized",owner:"canvas config commands"},api:{surface:"specialized",owner:"sys connect"},spawnEnv:{surface:"specialized",owner:"spawn environment allow-list"},bin:{surface:"specialized",owner:"bare-binary contributions on every node PATH"},humanActions:{surface:"specialized",owner:"scope-configured human completion actions"}},O=Object.keys(h);function S(){const e=[];for(const t of Object.values(h))t.surface==="settings"&&("setting"in t?e.push(t.setting):e.push(...Object.values(t.settings)));return e.sort((t,o)=>t.order-o.order)}s(S,"collectUserSettings");const y=S();function A(e){return y.find(t=>t.key===e)}s(A,"findUserSetting");function E(e){return y.filter(t=>t.group===e)}s(E,"userSettingsInGroup");export{h as CONFIG_SETTINGS_COVERAGE,O as SCOPE_CONFIG_KEYS,y as USER_SETTINGS,A as findUserSetting,E as userSettingsInGroup};
+var v=Object.defineProperty;var s=(e,t)=>v(e,"name",{value:t,configurable:!0});import{CONDENSED_HISTORY_MODES as u,MOUSE_MODE_DEFAULTS as p,WHIP_MESSAGE_MODES as d}from"../types.js";function i(e,t,o){const r=e.indexOf(t),a=r>=0?r:0;return e[(a+o+e.length)%e.length]}s(i,"cycleChoice");function c(e,t,o){const r=e.indexOf(t);return r>=0?e[(r+o+e.length)%e.length]:o>=0?e.find(a=>a>t)??e[0]:[...e].reverse().find(a=>a<t)??e[e.length-1]}s(c,"cycleNumber");function n(e,t){return e==="true"?!0:e==="false"?!1:`${t} must be true or false`}s(n,"booleanFromString");function f(e,t){if(!/^\d+$/.test(e))return`${t} must be an integer >= 0`;const o=Number(e);return Number.isSafeInteger(o)?o:`${t} must be an integer >= 0`}s(f,"nonNegativeIntegerFromString");function _(e,t){const o=f(e,t);return typeof o=="string"||o<1?`${t} must be an integer >= 1`:o}s(_,"positiveIntegerFromString");const m=[!1,"notify","apply"],w=[0,1,6,12,24,48,72,168],b=[1,2,3,4,5,6,8,10,12],l="openai-codex";function g(e,t){const o=e.providerOptions[t];if(o!==void 0)return o;const r={};return e.providerOptions[t]=r,r}s(g,"providerOptionsFor");const x=[1,2,3,4,5,6],h={schema_version:{surface:"specialized",owner:"internal schema migration"},marketplaces:{surface:"specialized",owner:"Plugins and pkg market commands"},plugins:{surface:"specialized",owner:"Plugins tab and pkg plugin commands"},auto_update:{surface:"settings",settings:{crtr:{key:"auto_update.crtr",label:"crouter updates",description:"Notify about crouter releases, install them automatically, or turn checks off.",valueConstraint:"true|false|notify|apply; true stores notify",applies:"Applies on the next crouter command.",group:"updates",order:70,format:s(e=>e.auto_update.crtr===!1?"off":e.auto_update.crtr,"format"),cycle:s((e,t)=>{e.auto_update.crtr=i(m,e.auto_update.crtr,t)},"cycle"),setFromString:s((e,t)=>{const o=t==="true"?"notify":t;return o!=="notify"&&o!=="apply"&&o!=="false"?"auto_update.crtr must be notify, apply, or false":(e.auto_update.crtr=o==="false"?!1:o,null)},"setFromString")},content:{key:"auto_update.content",label:"Content updates",description:"Notify about plugin and marketplace updates, apply them automatically, or turn checks off.",valueConstraint:"false|notify|apply",applies:"Applies on the next crouter command.",group:"updates",order:80,format:s(e=>e.auto_update.content===!1?"off":e.auto_update.content,"format"),cycle:s((e,t)=>{e.auto_update.content=i(m,e.auto_update.content,t)},"cycle"),setFromString:s((e,t)=>t!=="notify"&&t!=="apply"&&t!=="false"?"auto_update.content must be notify, apply, or false":(e.auto_update.content=t==="false"?!1:t,null),"setFromString")},interval_hours:{key:"auto_update.interval_hours",label:"Update interval",description:"Minimum hours between automatic update checks. Zero checks on every command.",valueConstraint:"integer >= 0",applies:"Applies on the next crouter command.",group:"updates",order:90,format:s(e=>`${e.auto_update.interval_hours}h`,"format"),cycle:s((e,t)=>{e.auto_update.interval_hours=c(w,e.auto_update.interval_hours,t)},"cycle"),setFromString:s((e,t)=>{const o=f(t,"auto_update.interval_hours");return typeof o=="string"?o:(e.auto_update.interval_hours=o,null)},"setFromString")}}},max_panes_per_window:{surface:"settings",setting:{key:"max_panes_per_window",label:"Maximum panes",description:"Maximum human-review panes placed in one tmux window before using another window.",valueConstraint:"integer >= 1",applies:"Applies to the next pane placement.",group:"panes",order:20,format:s(e=>String(e.max_panes_per_window),"format"),cycle:s((e,t)=>{e.max_panes_per_window=c(b,e.max_panes_per_window,t)},"cycle"),setFromString:s((e,t)=>{const o=_(t,"max_panes_per_window");return typeof o=="string"?o:(e.max_panes_per_window=o,null)},"setFromString")}},auto_open_child_viewers:{surface:"settings",setting:{key:"auto_open_child_viewers",label:"Open child panes",description:"Open each managed child beside its watched parent. Off keeps new children running in the background.",valueConstraint:"true|false",applies:"Applies to the next managed child created; independent roots still open their attended viewer.",group:"panes",order:10,format:s(e=>e.auto_open_child_viewers?"on":"off","format"),cycle:s(e=>{e.auto_open_child_viewers=!e.auto_open_child_viewers},"cycle"),setFromString:s((e,t)=>{const o=n(t,"auto_open_child_viewers");return typeof o=="string"?o:(e.auto_open_child_viewers=o,null)},"setFromString")}},brokerThresholds:{surface:"specialized",owner:"Broker limits tab"},lifecycle:{surface:"specialized",owner:"sys config set lifecycle.unattendedParkMs"},completion_bell:{surface:"settings",setting:{key:"completion_bell",label:"Completion bell",description:"Ring a short sound when the node in an attached viewer finishes a turn.",valueConstraint:"true|false",applies:"Applies on the next turn end.",group:"display",order:41,format:s(e=>e.completion_bell?"on":"off","format"),cycle:s(e=>{e.completion_bell=!e.completion_bell},"cycle"),setFromString:s((e,t)=>{const o=n(t,"completion_bell");return typeof o=="string"?o:(e.completion_bell=o,null)},"setFromString")}},working_gerunds:{surface:"specialized",owner:"sys config set working_gerunds"},whip_mode:{surface:"settings",setting:{key:"whip_mode",label:"Whip mode",description:"Play the whip animation when you send a prompt and when a viewer opens for an agent with an initial prompt.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:39,format:s(e=>e.whip_mode?"on":"off","format"),cycle:s(e=>{e.whip_mode=!e.whip_mode},"cycle"),setFromString:s((e,t)=>{const o=n(t,"whip_mode");return typeof o=="string"?o:(e.whip_mode=o,null)},"setFromString")}},page_surface:{surface:"settings",setting:{key:"page_surface",label:"Page human surface",description:"This host reads pages in a browser rather than a terminal. Agents are told the page module runs as written, HTML pages are offered, and document review and live display leave the command tree.",valueConstraint:"true|false",applies:"Applies when human command help is assembled.",group:"display",order:37,format:s(e=>e.page_surface?"on":"off","format"),cycle:s(e=>{e.page_surface=!e.page_surface},"cycle"),setFromString:s((e,t)=>{const o=n(t,"page_surface");return typeof o=="string"?o:(e.page_surface=o,null)},"setFromString")}},whip_messages:{surface:"specialized",owner:"sys config set whip_messages"},whip_message_mode:{surface:"settings",setting:{key:"whip_message_mode",label:"Whip message",description:"What the whip action sends: a random line from whip_messages, or the fixed \u201CGo faster\u201D.",valueConstraint:d.join("|"),applies:"Applies on the next attach.",group:"display",order:40,format:s(e=>e.whip_message_mode==="go-faster"?"go faster":"random","format"),cycle:s((e,t)=>{e.whip_message_mode=i(d,e.whip_message_mode,t)},"cycle"),setFromString:s((e,t)=>d.includes(t)?(e.whip_message_mode=t,null):`whip_message_mode must be one of: ${d.join("|")}`,"setFromString")}},mouse_mode_default:{surface:"settings",setting:{key:"mouse_mode_default",label:"Default mouse mode",description:"Initial mouse wheel scrolling for each attached viewer.",valueConstraint:p.join("|"),applies:"Applies on the next attach.",group:"display",order:38,format:s(e=>e.mouse_mode_default==="tmux"?"follow tmux":e.mouse_mode_default,"format"),cycle:s((e,t)=>{e.mouse_mode_default=i(p,e.mouse_mode_default,t)},"cycle"),setFromString:s((e,t)=>p.includes(t)?(e.mouse_mode_default=t,null):`mouse_mode_default must be one of: ${p.join("|")}`,"setFromString")}},live_cycles:{surface:"settings",setting:{key:"live_cycles",label:"Live cycles",description:"Trailing refresh cycles rendered at full fidelity; older cycles condense to text.",valueConstraint:"integer >= 1",applies:"Applies on the next attach.",group:"display",order:50,format:s(e=>String(e.live_cycles),"format"),cycle:s((e,t)=>{e.live_cycles=c(x,e.live_cycles,t)},"cycle"),setFromString:s((e,t)=>{const o=_(t,"live_cycles");return typeof o=="string"?o:(e.live_cycles=o,null)},"setFromString")}},condensed_history:{surface:"settings",setting:{key:"condensed_history",label:"Condensed history",description:"Messages retained from condensed cycles. Tool calls are never kept.",valueConstraint:u.join("|"),applies:"Applies on the next attach.",group:"display",order:60,format:s(e=>e.condensed_history,"format"),cycle:s((e,t)=>{e.condensed_history=i(u,e.condensed_history,t)},"cycle"),setFromString:s((e,t)=>u.includes(t)?(e.condensed_history=t,null):`condensed_history must be one of: ${u.join("|")}`,"setFromString")}},bash_tool_purpose:{surface:"settings",setting:{key:"bash_tool_purpose",label:"Bash purpose field",description:"Expose the optional purpose label to agents in the bash tool schema. Off removes the field without disabling the bash valve.",valueConstraint:"true|false",applies:"Applies on the next node session.",group:"display",order:25,format:s(e=>e.bash_tool_purpose?"on":"off","format"),cycle:s(e=>{e.bash_tool_purpose=!e.bash_tool_purpose},"cycle"),setFromString:s((e,t)=>{const o=n(t,"bash_tool_purpose");return typeof o=="string"?o:(e.bash_tool_purpose=o,null)},"setFromString")}},fold_finished_tools:{surface:"settings",setting:{key:"fold_finished_tools",label:"Fold finished tools",description:"Fold every settled tool call to its call line. Toggle live with /fold-tools.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:30,format:s(e=>e.fold_finished_tools?"on":"off","format"),cycle:s(e=>{e.fold_finished_tools=!e.fold_finished_tools},"cycle"),setFromString:s((e,t)=>{const o=n(t,"fold_finished_tools");return typeof o=="string"?o:(e.fold_finished_tools=o,null)},"setFromString")}},summarize_tool_calls:{surface:"settings",setting:{key:"summarize_tool_calls",label:"Summarize tool calls",description:"Replace completed folded tool-call groups with a one-line broker summary when available.",valueConstraint:"true|false",applies:"Applies when the next visible message closes a tool-call group.",group:"display",order:35,format:s(e=>e.summarize_tool_calls?"on":"off","format"),cycle:s(e=>{e.summarize_tool_calls=!e.summarize_tool_calls},"cycle"),setFromString:s((e,t)=>{const o=n(t,"summarize_tool_calls");return typeof o=="string"?o:(e.summarize_tool_calls=o,null)},"setFromString")}},detailed_tool_recaps:{surface:"settings",setting:{key:"detailed_tool_recaps",label:"Detailed tool recaps",description:"Show each memory read and edited file in folded tool recaps. Off shows a compact count line instead.",valueConstraint:"true|false",applies:"Applies on the next attach.",group:"display",order:36,format:s(e=>e.detailed_tool_recaps?"on":"off","format"),cycle:s(e=>{e.detailed_tool_recaps=!e.detailed_tool_recaps},"cycle"),setFromString:s((e,t)=>{const o=n(t,"detailed_tool_recaps");return typeof o=="string"?o:(e.detailed_tool_recaps=o,null)},"setFromString")}},keybindings:{surface:"specialized",owner:"Keybindings tab"},tmux_passthrough:{surface:"specialized",owner:"Keybindings tab"},providerOptions:{surface:"settings",settings:{"openai-codex.fastMode":{key:`providerOptions.${l}.fastMode`,label:"Codex fast mode",description:"Serve Codex turns at the ChatGPT priority tier: about 1.5x faster generation for about 2x the credits. Displayed cost does not reflect the premium.",valueConstraint:"true|false",applies:"Applies on each node's next turn.",group:"providers",order:40,format:s(e=>e.providerOptions[l]?.fastMode?"on":"off","format"),cycle:s(e=>{const t=g(e,l);t.fastMode=!t.fastMode},"cycle"),setFromString:s((e,t)=>{const o=n(t,`providerOptions.${l}.fastMode`);return typeof o=="string"?o:(g(e,l).fastMode=o,null)},"setFromString")}}},modelLadders:{surface:"specialized",owner:"Models tab"},modelRoutes:{surface:"specialized",owner:"Models route declarations"},modelRouting:{surface:"specialized",owner:"Models route declarations"},kinds:{surface:"specialized",owner:"Models tab and kind registry"},page_components:{surface:"specialized",owner:"Page component catalog: product-registered page component kinds"},remoteCanvas:{surface:"specialized",owner:"canvas config commands"},api:{surface:"specialized",owner:"sys connect"},paths:{surface:"specialized",owner:"runtime layout"},store:{surface:"specialized",owner:"daemon conversation store"},runtime:{surface:"specialized",owner:"app-facing listener"},spawnEnv:{surface:"specialized",owner:"spawn environment allow-list"},bin:{surface:"specialized",owner:"bare-binary contributions on every node PATH"},humanActions:{surface:"specialized",owner:"scope-configured human completion actions"}},O=Object.keys(h);function S(){const e=[];for(const t of Object.values(h))t.surface==="settings"&&("setting"in t?e.push(t.setting):e.push(...Object.values(t.settings)));return e.sort((t,o)=>t.order-o.order)}s(S,"collectUserSettings");const y=S();function z(e){return y.find(t=>t.key===e)}s(z,"findUserSetting");function A(e){return y.filter(t=>t.group===e)}s(A,"userSettingsInGroup");export{h as CONFIG_SETTINGS_COVERAGE,O as SCOPE_CONFIG_KEYS,y as USER_SETTINGS,z as findUserSetting,A as userSettingsInGroup};