@north-light/crouter 0.3.352 → 0.3.354

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

@@ -1,101 +0,0 @@
-import { type MemoryDoc, type MemoryTarget } from '../memory-resolver.js';
-import { type ContextExposureState, type ExposureTarget } from './injected-store.js';
-import { type Rung, type SubstrateDoc } from './schema.js';
-import type { NodeConfigSubject } from './subject-fields.js';
-export type DeliveryCause = 'directory listing attached to content delivery' | 'memory-read companion of content delivery';
-export interface AccountedDelivery {
-    rung: Rung;
-    cause?: DeliveryCause;
-    /** Resolver descriptor for accounting-only attachment rows. */
-    source?: MemoryDoc;
-}
-/** The renderer's structured delivery ledger. It records precisely the document
- * envelopes and listing lines that rendered, so diagnostics can report the
- * same attachment fixpoint without parsing its text or recreating it. */
-export interface DeliveryAccounting {
-    deliveries: Map<string, AccountedDelivery>;
-}
-export declare function deliveryAccounting(): DeliveryAccounting;
-export declare function accountDelivery(accounting: DeliveryAccounting | undefined, doc: Pick<SubstrateDoc, 'path'>, rung: Rung, cause?: DeliveryCause, source?: MemoryDoc): void;
-/** How one content delivery's attachments render, and the ledger + corpus the
- *  whole fixpoint runs against. ONE options object flows through every nested
- *  companion delivery, so `dirs` accumulates across the fixpoint and a
- *  companion inherits its parent's listing mode and memory target. */
-export interface ContentAttachmentOptions {
-    /** Subject for companion `memory-read` gate evaluation. */
-    subject: NodeConfigSubject | null;
-    /** The one exposure ledger this fixpoint reads and registers against. */
-    target: ExposureTarget;
-    /** The corpus every directory question answers from — the caller's own
-     *  listing corpus, never an ambient re-resolution. */
-    byName: ReadonlyMap<string, MemoryDoc>;
-    /** What companion `memory-read` routes plan against. Absent = the ambient
-     *  cwd/profile target and this session's cached event corpus. */
-    memoryTarget?: MemoryTarget;
-    /** `blocks` attaches each disclosed listing as its own `<memory-listing>`.
-     *  `tree` attaches none and accumulates the disclosed directories into
-     *  `dirs` instead, for a caller that renders those members itself (the boot
-     *  catalog tree) and registers them as it renders. */
-    listings: 'blocks' | 'tree';
-    /** Accumulator for `tree` mode: every directory this fixpoint disclosed. */
-    dirs?: string[];
-    /** An explicit `crtr memory read`: the read doc's OWN directory renders
-     *  unfiltered and returns as `listing` rather than attaching as a block. */
-    explicit?: boolean;
-    /** Optional structured mirror of the actual emitted document deliveries. */
-    accounting?: DeliveryAccounting;
-    /** Why this winner was reached through the current content attachment walk. */
-    deliveryCause?: DeliveryCause;
-}
-/** The attachment semantics of a content delivery. Content is read-equivalent:
- * it exposes its own/enclosing directory listings and fires memory-read routes.
- * The exposure ledger makes this finite even when companion routes cycle. */
-export declare function contentReadAttachments(doc: Pick<SubstrateDoc, 'name' | 'path' | 'body'>, opts: ContentAttachmentOptions): {
-    blocks: string[];
-    listing?: string[];
-};
-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, 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.
- *
- * Each candidate's authored rung is clamped to its project's profile
- * 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, 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;
- * `excludeRealpath` keeps the resolved doc from delivering itself). Returns
- * unwrapped blocks — the read leaf composes one `<auto-loaded-context>`
- * envelope from these plus the directory listings. */
-export declare function memoryReadDocBlocks(excludeRealpath: string, name: string, opts: Omit<ContentAttachmentOptions, 'byName'> & {
-    byName?: ReadonlyMap<string, MemoryDoc>;
-}): string[];
-/** 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, 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, 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;
-/** Whether this command matches a `pre-command` surface before its node-config
- * gate is evaluated. A matching gate still requires a subject lookup. */
-export declare function corpusHasPreCommandSurfaceForCommand(command: string): boolean;
-/** Forget the transcript exposure of every `pre-command` doc, re-arming their
- * holds. Compaction drops delivered guidance out of the transcript while the
- * 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, memoryTarget?: MemoryTarget): void;

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

@@ -1,9 +0,0 @@
-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 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,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.d.ts

@@ -1,94 +0,0 @@
-import { type MemoryDoc, type MemoryScope, type MemoryTarget } from '../memory-resolver.js';
-import { type DocKind, type Rung, type SubstrateDoc, type SurfaceEntry, type SurfaceEvent } from './schema.js';
-import type { EventCorpusDoc } from './session-cache.js';
-import type { NodeConfigSubject } from './subject-fields.js';
-/** What the event exposes to match against. Every field is optional: an event
- *  invoked without its payload matches nothing rather than throwing. */
-export interface DeliveryPayload {
-    /** `read`: the file that was read. Realpathed by the planner. */
-    absoluteFile?: string;
-    /** `read`: the read file's own frontmatter. Parsed from the file when omitted. */
-    readFrontmatter?: Record<string, unknown>;
-    /** `memory-read`: the exact canonical name the read resolved to. */
-    resolvedCanonicalName?: string;
-    /** `memory-read`: realpath of the resolved document, which never delivers to
-     *  itself. */
-    resolvedDocPath?: string;
-    /** `command` / `pre-command`: the command string. */
-    command?: string;
-}
-/** A gate verdict with the reason a failure carries. */
-export type GateOutcome = {
-    pass: true;
-} | {
-    pass: false;
-    reason: string;
-};
-/** One authored surface entry of this event and how it fared. `matched` folds
- *  the entry's constraints AND its own gate; `gate` isolates the gate so a
- *  reader can tell "did not fit" from "excluded by this node's config". */
-export interface EntryDecision {
-    entry: SurfaceEntry;
-    matched: boolean;
-    gate: GateOutcome;
-}
-/** One document's delivery decision for one event. */
-export interface DeliveryRecord {
-    /** Canonical name — the identity dedup resolves. */
-    name: string;
-    kind: DocKind;
-    scope: MemoryScope;
-    /** Absolute path to the document file. */
-    storePath: string;
-    /** From the node's own store, which is floored rather than capped at boot. */
-    nodeLocal: boolean;
-    /** Every entry the document authored for this event. */
-    authoredEntries: EntryDecision[];
-    /** The highest-rung entry that matched, or null when none did. */
-    matchedEntry: SurfaceEntry | null;
-    /** The matched entry's rung — what the author asked for, before the cap. */
-    authoredRung: Rung;
-    /** The profile relationship's cap on this document's store, or null when the
-     *  event is uncapped or the document is node-local. */
-    projectMemoryCap: Rung | null;
-    /** `minRung(authoredRung, projectMemoryCap)`. */
-    cappedRung: Rung;
-    docGate: GateOutcome;
-    /** The matched entry's gate, or the verdict that excluded every authored
-     *  entry; null when the document authored no entry for this event. */
-    entryGate: GateOutcome | null;
-    /** What this document delivers at after gates, cap, and the boot node-local
-     *  floor. `none` = delivers nothing. */
-    finalRung: Rung;
-    /** This document is the one its canonical name resolves to for this event. */
-    winner: boolean;
-    /** The document that took this one's name, when it lost the dedup. */
-    shadowedBy: {
-        name: string;
-        scope: MemoryScope;
-        path: string;
-    } | null;
-    /** The parsed document — the renderers' input. */
-    doc: SubstrateDoc;
-    /** The resolver descriptor behind it: physical path, representation, and the
-     *  routing anchor a `./` memory-read glob matches against. */
-    source: MemoryDoc;
-}
-/** Every document considered for one event, in corpus (precedence) order. */
-export interface DeliveryPlan {
-    event: SurfaceEvent;
-    subject: NodeConfigSubject | null;
-    target: MemoryTarget;
-    docs: DeliveryRecord[];
-}
-/** Which boot block a record belongs to. The node's own store is the catch-all
- *  this-node store and rides into the knowledge block whatever its kind, so a
- *  record's kind alone does not answer this. */
-export declare function bootPartitionOf(record: Pick<DeliveryRecord, 'kind' | 'nodeLocal'>): DocKind;
-/** Plan one event's delivery.
- *
- *  `corpus` is the already-loaded document set. The live renderers pass their
- *  session cache (the corpus is scanned and parsed once per session); an
- *  inspection caller omits it and the planner loads the event's corpus from
- *  `target`. Either way the planner writes nothing. */
-export declare function planDelivery(subject: NodeConfigSubject | null, target: MemoryTarget, event: SurfaceEvent, payload?: DeliveryPayload, corpus?: readonly EventCorpusDoc[]): DeliveryPlan;

package/dist/core/substrate/plan.js

@@ -1 +0,0 @@
-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.d.ts

@@ -1,12 +0,0 @@
-import { type ExposureTarget } from './injected-store.js';
-/** The system-prompt substrate splice for `nodeId` — shipped-layer protocol
- *  prose followed by the `<memory kind="preference">` block: assemble
- *  the node's subject from the canvas-db, render the pure splice, then swap the
- *  literal `$CRTR_CONTEXT_DIR` env-var token for the node's real absolute path
- *  so agents don't paste it into the non-expanding Write tool (see
- *  interpolateNodePaths). A null subject (unknown id) still renders the
- *  always-present memory-usage guidance frame. */
-export declare function renderPreferencesSection(nodeId: string): string;
-/** The first-message `<memory kind="knowledge">` block for `nodeId`. Rendered
- * documents register at their displayed rung through `target`. */
-export declare function renderKnowledgeBlock(nodeId: string, target?: ExposureTarget): string;

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

@@ -1 +0,0 @@
-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,41 +0,0 @@
-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';
-import { type DeliveryAccounting } from './on-read.js';
-/** The computed "sub-personas you may spawn" menu for a subject's kind — the
- *  live restoration of the old `personas/resolve.ts` static menu, now derived
- *  at render time from the merged kind registry (`subKindsAvailableTo`) so it
- *  can never drift from `sys context prompt-review --list`'s `subPersonas` metadata.
- *  Returns '' when the kind has zero available sub-kinds (no dangling empty
- *  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, memoryTarget?: MemoryTarget): {
-    block: string;
-    contentDocs: SubstrateDoc[];
-    tree: string;
-};
-/** The `<memory kind="knowledge">` block embedded in the session_start bearings
- *  message (bearings.ts pushes it as a SIBLING of `<crtr-bearings>`, or drops it
- *  when ''). The consultable catalog: every eligible `kind: knowledge` resolver
- *  doc PLUS the node-local memory docs (any kind) — resolver docs win
- *  first-wins dedup over a same-named node-local doc. GROUPED by rung exactly
- *  like the preference block: content prose first (general→specific,
- *  node-local last), then the preview/name catalog tree. A bootless node-local
- *  doc arrives floored to `name`, so it surfaces as a bare-name tree entry
- *  rather than collapsing into a `[+N more]` count (its body still never
- *  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, 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, ''
- *  when the change exposes nothing.
- *
- *  Both kinds use the current subject's ordinary winner assembly, then compare
- *  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, grantee?: string, memoryTarget?: MemoryTarget): string;

package/dist/core/substrate/render.js

@@ -1,65 +0,0 @@
-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 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(`
-`)}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(`
-
-`),(y.length>0||s!=="")&&(c+=`
-
-${we}`,y.length>0&&(c+=`
-
-${y.join(`
-
-`)}`),s!==""&&(c+=`
-
-${s}`),c+=`
-
-${H}`)}const f=`<memory kind="preference">
-${c}
-</memory>`;return{block:a===""?f:`${a}
-
-${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(p===""&&f==="")return"";let d=ge;return p!==""&&(d+=`
-
-${p}`),f!==""&&(d+=`
-
-${f}`),d+=`
-
-${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}
-
-${[...p,...h].join(`
-
-`)}`),d.length>0||f!==""){let u=Re;d.length>0&&(u+=`
-
-${d.join(`
-
-`)}`),f!==""&&(u+=`
-
-${f}`),u+=`
-
-${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(m!==""||w.tree!==""){let u=De;m!==""&&(u+=`
-
-${m}`),w.tree!==""&&(u+=`
-
-${w.tree}`),u+=`
-
-${V}`,y.push(`<memory kind="knowledge">
-${u}
-</memory>`)}return y.length===0?"":M(y.join(`
-
-`),o,r)}l(Ke,"renderConfigChangeDelta");export{$e as buildSubPersonaMenu,Ke as renderConfigChangeDelta,Ge as renderKnowledgeForSubject,Ie as renderPreferencesForSubject};

package/dist/core/substrate/session-cache.d.ts

@@ -1,27 +0,0 @@
-import type { MemoryDoc } from '../memory-resolver.js';
-import type { SubstrateDoc } from './schema.js';
-type ListAllMemoryDocsFn = () => MemoryDoc[];
-type ParseSubstrateDocFn = (doc: MemoryDoc) => SubstrateDoc | null;
-/** A parsed substrate document with the resolver descriptor it came from. The
- *  parsed doc carries canonical identity but not the physical form behind it,
- *  so the descriptor is what supplies the routing anchor a `./` memory-read
- *  glob matches against. */
-export interface EventCorpusDoc {
-    doc: SubstrateDoc;
-    source: MemoryDoc;
-}
-/** Called by canvas-doc-substrate.ts on every `session_start`.
- *  Resets all cached values so the next access triggers a fresh scan.  */
-export declare function clearSessionCache(): void;
-/** The FULL corpus (listAllMemoryDocs()), INCLUDING node scope, scanned at
- *  most once per session. `listFn` is injected by the caller to avoid
- *  circular imports at module init. This is the single filesystem walk the
- *  whole module performs — every other entry derives from this result rather
- *  than re-scanning. */
-export declare function cachedAllMemoryDocsInclusive(listFn: ListAllMemoryDocsFn): MemoryDoc[];
-/** allMemoryDocsInclusive parsed and paired with its descriptors, INCLUDING
- *  node scope — the event corpus, and the module's only parse pass. */
-export declare function cachedEventCorpusInclusive(listFn: ListAllMemoryDocsFn, parseFn: ParseSubstrateDocFn): EventCorpusDoc[];
-/** The parsed docs of the inclusive event corpus, without their descriptors. */
-export declare function cachedSubstrateDocsInclusive(listFn: ListAllMemoryDocsFn, parseFn: ParseSubstrateDocFn): SubstrateDoc[];
-export {};

package/dist/core/substrate/session-cache.js

@@ -1 +0,0 @@
-var t=Object.defineProperty;var l=(s,c)=>t(s,"name",{value:c,configurable:!0});const e={allMemoryDocsInclusive:null,eventCorpusInclusive:null,substrateDocsInclusive:null};function a(){e.allMemoryDocsInclusive=null,e.eventCorpusInclusive=null,e.substrateDocsInclusive=null}l(a,"clearSessionCache");function r(s){return e.allMemoryDocsInclusive===null&&(e.allMemoryDocsInclusive=s()),e.allMemoryDocsInclusive}l(r,"cachedAllMemoryDocsInclusive");function i(s,c){if(e.eventCorpusInclusive===null){const n=[];for(const u of r(s)){const o=c(u);o!==null&&n.push({doc:o,source:u})}e.eventCorpusInclusive=n}return e.eventCorpusInclusive}l(i,"cachedEventCorpusInclusive");function I(s,c){return e.substrateDocsInclusive===null&&(e.substrateDocsInclusive=i(s,c).map(n=>n.doc)),e.substrateDocsInclusive}l(I,"cachedSubstrateDocsInclusive");export{r as cachedAllMemoryDocsInclusive,i as cachedEventCorpusInclusive,I as cachedSubstrateDocsInclusive,a as clearSessionCache};

package/dist/core/substrate/surface-match.d.ts

@@ -1,73 +0,0 @@
-import { type Rung, type SubstrateDoc, type SurfaceEntry, type SurfaceEvent } from './schema.js';
-import type { NodeConfigSubject } from './subject-fields.js';
-/** The project directory owning a doc's store: the path segment stack above
- *  the doc's `.crouter` dir. `null` when the doc's path carries no `.crouter`
- *  segment (builtin docs). */
-export declare function owningRootOf(doc: Pick<SubstrateDoc, 'path'>): string | null;
-/** True when the (already-realpathed) file sits beneath the doc's store's
- *  owning directory. Callers additionally guard on `doc.scope === 'project'`:
- *  a profile store's path computes an owning root of `~`, and user/builtin/
- *  node docs likewise have no project-owning dir, so a `./`-anchored glob
- *  outside a project store must never match. */
-export declare function underOwningRoot(doc: Pick<SubstrateDoc, 'path'>, absFile: string): boolean;
-/** Does a `read` entry fit the read file? `absReadFile` must already be
- *  realpathed. `readFrontmatter` is the read file's own parsed YAML (empty
- *  for non-markdown files); an empty record never satisfies
- *  `matchFrontmatter`. */
-export declare function matchesReadEntry(entry: SurfaceEntry, doc: Pick<SubstrateDoc, 'path' | 'scope'>, subject: NodeConfigSubject | null, absReadFile: string, readFrontmatter: Record<string, unknown>): boolean;
-/** Does a `memory-read` entry on a carrier anchored at `routingAnchor` fit a
- *  resolved read of the doc known by its exact canonical `name`? */
-export declare function matchesMemoryReadEntry(entry: SurfaceEntry, routingAnchor: string, subject: NodeConfigSubject | null, name: string): boolean;
-/** Does a `command` entry's parsed command pattern fit, without evaluating its
- * node-config gate? Callers use this only to determine whether resolving a
- * subject could be necessary; delivery must still use `matchesCommandEntry`. */
-export declare function commandEntryMatches(entry: SurfaceEntry, command: string): boolean;
-/** Does a `command` entry fit the executed command string? */
-export declare function matchesCommandEntry(entry: SurfaceEntry, subject: NodeConfigSubject | null, command: string): boolean;
-/** Does a `pre-command` entry's parsed command pattern fit, without evaluating
- * its node-config gate? Callers use this only to determine whether resolving a
- * subject could be necessary; delivery must still use `matchesPreCommandEntry`. */
-export declare function preCommandEntryMatches(entry: SurfaceEntry, command: string): boolean;
-/** Does a `pre-command` entry fit a command that is ABOUT to run? The same
- * glob machinery `command` uses — one matcher, one semantics — applied to the
- * command with its heredoc bodies stripped. Subshell parentheses, backticks,
- * and path-prefixed binaries stay unhandled: this is a guardrail against the
- * faithful-but-uninformed action, not an enforcement boundary. */
-export declare function matchesPreCommandEntry(entry: SurfaceEntry, subject: NodeConfigSubject | null, command: string): boolean;
-/** What an event occurrence exposes for matching. A field the event does not
- *  use is ignored; a field the event needs and lacks matches nothing. */
-export interface SurfaceMatchPayload {
-    /** `read`: the read file, already realpathed. */
-    absoluteFile?: string;
-    /** `read`: the read file's own parsed YAML (empty for a non-markdown file). */
-    readFrontmatter?: Record<string, unknown>;
-    /** `memory-read`: the exact canonical name the read resolved to. */
-    resolvedCanonicalName?: string;
-    /** `memory-read`: the CARRIER's routing anchor, from its resolver descriptor
-     *  — not derivable from a canonical name, which cannot say whether the doc
-     *  fronts its own directory. */
-    routingAnchor?: string;
-    /** `command` / `pre-command`: the command string. */
-    command?: string;
-}
-/** A doc as the matchers see it. `path`/`scope` are consulted only by `read`
- *  (a `./`-anchored glob resolves against the store's owning repo dir). */
-type MatchDoc = Pick<SubstrateDoc, 'surfaces'> & Partial<Pick<SubstrateDoc, 'path' | 'scope'>>;
-/** Does ONE entry of `event` fit this occurrence — constraints and the entry's
- *  own gate together? */
-export declare function surfaceEntryParticipates(entry: SurfaceEntry, doc: MatchDoc, subject: NodeConfigSubject | null, event: SurfaceEvent, payload: SurfaceMatchPayload): boolean;
-/** The entry that decides this doc's delivery for one event occurrence: the
- *  highest-rung participating entry, or null when none participates. */
-export declare function matchingSurfaceEntry(doc: MatchDoc, subject: NodeConfigSubject | null, event: SurfaceEvent, payload: SurfaceMatchPayload): SurfaceEntry | null;
-/** The doc's delivery rung for a read of `absReadFile` (already realpathed). */
-export declare function readDeliveryRung(doc: Pick<SubstrateDoc, 'surfaces' | 'path' | 'scope'>, subject: NodeConfigSubject | null, absReadFile: string, readFrontmatter: Record<string, unknown>): Rung;
-/** The doc's workspace-open rung. */
-export declare function workspaceOpenRung(doc: Pick<SubstrateDoc, 'surfaces'>, subject: NodeConfigSubject | null): Rung;
-/** The doc's delivery rung for a `crtr memory read` that resolved a doc known
- *  by its exact canonical `name` — no mount-stripped or other alias. */
-export declare function memoryReadDeliveryRung(doc: Pick<SubstrateDoc, 'surfaces'>, routingAnchor: string, subject: NodeConfigSubject | null, name: string): Rung;
-/** The doc's delivery rung for an executed command string. */
-export declare function commandDeliveryRung(doc: Pick<SubstrateDoc, 'surfaces'>, subject: NodeConfigSubject | null, command: string): Rung;
-/** The doc's delivery rung for a command about to run. */
-export declare function preCommandDeliveryRung(doc: Pick<SubstrateDoc, 'surfaces'>, subject: NodeConfigSubject | null, command: string): Rung;
-export {};

package/dist/core/substrate/surface-match.js

@@ -1 +0,0 @@
-var x=Object.defineProperty;var i=(e,t)=>x(e,"name",{value:t,configurable:!0});import{basename as M,isAbsolute as C,matchesGlob as v,relative as p,sep as l}from"node:path";import{commandSegments as G,stripHeredocs as O}from"../shell-segments.js";import{CRTR_DIR_NAME as $}from"../../types.js";import{realpathOrSelf as g}from"../fs-utils.js";import{evalCondition as D}from"../predicate.js";import{surfaceEntryGatePasses as c}from"./gate.js";import{rungRank as R}from"./schema.js";function E(e){const t=e.path.split(l),n=t.lastIndexOf($);return n<=0?null:t.slice(0,n).join(l)||l}i(E,"owningRootOf");function N(e,t){const n=E(e);if(n===null)return!1;const r=p(g(n),t);return r!==""&&!r.startsWith("..")&&!C(r)}i(N,"underOwningRoot");function a(e,t){try{return v(e,t)}catch{return!1}}i(a,"safeGlob");function P(e,t,n){if(e.startsWith("./")){if(t.scope!=="project"||!N(t,n))return!1;const r=E(t);return r===null?!1:a(p(g(r),n),e.slice(2))}return a(n,e)||a(M(n),e)}i(P,"readGlobMatches");function S(e,t,n,r,o){return e.on!=="read"||!c(e,n)||e.match!==void 0&&!e.match.some(s=>P(s,t,r))||e.matchFrontmatter!==void 0&&(Object.keys(o).length===0||!D(e.matchFrontmatter,o))?!1:e.match!==void 0||e.matchFrontmatter!==void 0}i(S,"matchesReadEntry");function W(e,t,n){if(e.startsWith("./")){const r=e.slice(2);return t===""?a(n,r):n.startsWith(t+"/")?a(n.slice(t.length+1),r):!1}return a(n,e)}i(W,"memoryReadGlobMatches");function k(e,t,n,r){return e.on!=="memory-read"||e.match===void 0||!c(e,n)?!1:e.match.some(o=>W(o,t,r))}i(k,"matchesMemoryReadEntry");function F(e){const t=e.trim().split(/\s+/);if(t.length===1&&t[0]==="")return null;const n=[];for(const r of t){const o=r.split("*");for(let s=0;s<o.length;s+=1)o[s]!==""&&n.push({kind:"literal",text:o[s]}),s<o.length-1&&n.push({kind:"any"})}return n}i(F,"commandGlobPattern");function b(e,t){const n=e.split("").map(r=>r==="?"?"[\\s\\S]":r.replace(/[.+^${}()|[\]\\]/g,"\\$&")).join("");return new RegExp(`^${n}$`).test(t)}i(b,"tokenMatches");function _(e,t){const n=new Map,r=i((o,s)=>{const h=`${o}:${s}`,d=n.get(h);if(d!==void 0)return d;let u;if(o===e.length)u=s===t.length;else if(e[o].kind==="any")u=r(o+1,s)||s<t.length&&r(o,s+1);else{const m=t[s];u=m!==void 0&&!m.opaque&&b(e[o].text,m.text)&&r(o+1,s+1)}return n.set(h,u),u},"match");return r(0,0)}i(_,"segmentMatches");function w(e,t){const n=F(e);return n===null?!1:G(t).filter(({tokens:r})=>r.length>0).some(({tokens:r})=>_(n,r))}i(w,"commandGlobMatches");function q(e,t){return e.on==="command"&&e.match!==void 0&&e.match.some(n=>w(n,t))}i(q,"commandEntryMatches");function A(e,t,n){return q(e,n)&&c(e,t)}i(A,"matchesCommandEntry");function H(e,t){return e.on!=="pre-command"||e.match===void 0?!1:e.match.some(n=>w(n,O(t)))}i(H,"preCommandEntryMatches");function T(e,t,n){return H(e,n)&&c(e,t)}i(T,"matchesPreCommandEntry");function j(e,t,n,r,o){if(e.on!==r)return!1;switch(r){case"boot":case"workspace-open":return c(e,n);case"read":return o.absoluteFile===void 0||t.path===void 0||t.scope===void 0?!1:S(e,{path:t.path,scope:t.scope},n,o.absoluteFile,o.readFrontmatter??{});case"memory-read":return o.resolvedCanonicalName===void 0?!1:k(e,o.routingAnchor??"",n,o.resolvedCanonicalName);case"command":return o.command!==void 0&&A(e,n,o.command);case"pre-command":return o.command!==void 0&&T(e,n,o.command)}}i(j,"surfaceEntryParticipates");function f(e,t,n,r){let o=null;for(const s of e.surfaces)j(s,e,t,n,r)&&(o===null||R(s.at)>R(o.at))&&(o=s);return o}i(f,"matchingSurfaceEntry");function X(e,t,n,r){return f(e,t,"read",{absoluteFile:n,readFrontmatter:r})?.at??"none"}i(X,"readDeliveryRung");function Y(e,t){return f(e,t,"workspace-open",{})?.at??"none"}i(Y,"workspaceOpenRung");function Z(e,t,n,r){return f(e,n,"memory-read",{routingAnchor:t,resolvedCanonicalName:r})?.at??"none"}i(Z,"memoryReadDeliveryRung");function y(e,t,n){return f(e,t,"command",{command:n})?.at??"none"}i(y,"commandDeliveryRung");function I(e,t,n){return f(e,t,"pre-command",{command:n})?.at??"none"}i(I,"preCommandDeliveryRung");export{y as commandDeliveryRung,q as commandEntryMatches,A as matchesCommandEntry,k as matchesMemoryReadEntry,T as matchesPreCommandEntry,S as matchesReadEntry,f as matchingSurfaceEntry,Z as memoryReadDeliveryRung,E as owningRootOf,I as preCommandDeliveryRung,H as preCommandEntryMatches,X as readDeliveryRung,j as surfaceEntryParticipates,N as underOwningRoot,Y as workspaceOpenRung};

package/dist/daemon/api/handlers/memory.js

@@ -1,5 +0,0 @@
-var Fe=Object.defineProperty;var m=(e,t)=>Fe(e,"name",{value:t,configurable:!0});import{createHash as We}from"node:crypto";import{getNode as Z,findNodeBySessionFile as Be}from"../../../core/canvas/canvas.js";import{interpolateNodePaths as ce}from"../../../core/canvas/paths.js";import{existsSync as Ge,readFileSync as ue,realpathSync as ze,statSync as Ue}from"node:fs";import{join as K,resolve as Ze}from"node:path";import{loadProfileManifest as Ke,resolveProfileOperand as He}from"../../../core/profiles/manifest.js";import{conversationStore as Ve,ConversationNotFoundError as Ye}from"../../../core/conversation-store/index.js";import{ApiError as l}from"../../../api/errors.js";import{paginate as H}from"../../../core/pagination.js";import{appSpace as V}from"../../../core/layout.js";import{memoryPermission as fe,readableProjectForScopes as Je}from"../../../core/spaces/permissions.js";import{canReadRun as Xe,resolvedScopes as Y}from"../router.js";import{CrtrError as J}from"../../../core/errors.js";import{memoryDir as Qe}from"../../../core/runtime/memory.js";import{NEUTRAL_PROJECT_MEMORY as xe,projectScopeRoot as X,projectScopeRootsWithMemory as et,scopeMemoryDir as pe,ensureProjectScopeRoot as tt}from"../../../core/scope.js";import{descendantStoreDiscoveryWarnings as ot}from"../../../core/nested-stores.js";import{profileMemoryDir as nt}from"../../../core/profiles/manifest.js";import{openProjectMemoryStore as Q}from"../../../core/memory-resolver.js";import{effectivePrivacy as x,PRIVACY_LEVELS as B}from"../../../core/substrate/schema.js";import{lintMemoryStore as he,lintMemoryTarget as rt,lintOrphans as it,resolvableCanonicalNames as st}from"../../../core/memory/lint.js";import{createMemoryDocSnapshot as ye,loadMemoryTargetView as ge,memoryStoresInPrecedence as ee}from"../../../core/memory-resolver.js";import{parseSubstrateDoc as we}from"../../../core/substrate/schema.js";import{parseFrontmatterGeneric as be}from"../../../core/frontmatter.js";import{dirDedupKey as at,docsByName as dt,renderDirListing as lt}from"../../../core/substrate/listings.js";import{memoryExtensionEffectiveCatalog as mt,memoryExtensionValidationCatalog as ct,projectEffectiveMemoryExtensions as ut}from"../../../core/memory/extensions.js";import{effectiveDocKind as ft}from"../../../core/substrate/schema.js";import{requireUnambiguousDoc as pt}from"../../../core/memory/mutation-domain.js";import{contentReadAttachments as ve}from"../../../core/substrate/on-read.js";import{assembleNodeSubject as _e}from"../../../core/substrate/subject.js";import{emptyContextExposureState as ht,exposureTarget as G,loadContextExposureState as te,registerDocumentExposure as Se,registerExposure as ke,saveContextExposureState as z}from"../../../core/substrate/injected-store.js";import{insertMemoryReads as yt}from"../../../core/canvas/memory-reads.js";import{emitEvent as gt}from"../../../core/events/emit.js";import{memoryEvents as oe}from"../../../core/substrate/memory-events.js";import{candidateLocation as qe,compareMemoryListKeys as wt,memoryListKey as bt,createDoc as je,deleteDoc as De,listDocs as vt,moveDoc as Re,readDoc as Ee,readHistory as _t,searchDocs as St,updateDoc as $e}from"../../../core/memory/service.js";import{MEMORY_SCOPES as Ie,isMemoryDocName as M}from"../../../api/dto/memory.js";import{invalidRequest as N,isRecord as E,objectBody as C,optionalString as I,requiredString as $}from"./validate.js";const P="read",q="rw",ne=100,Pe=100;function A(e){const t=e.params.name;if(t===void 0||!M(t))throw new l(400,"invalid_memory_doc_name","memory document name must be slash-joined [A-Za-z0-9_-] segments");return t}m(A,"requireName");function O(e){return Object.fromEntries(e.query.entries())}m(O,"queryObject");function F(e,t,o,i){return{scope:e,storeRoot:t,namespace:"",mountStatus:"ready",projectMemory:xe,ownerApp:o,profileId:i}}m(F,"nativeStore");function T(e,t){if(e.principal.class==="person")return!0;const o=e.principal.app;return process.platform!=="linux"&&o==="app:terminal"?!0:Je(t,o,Y(e.principal),e.principal.class==="broker"?e.principal.scopes:null)}m(T,"projectReadable");function v(e,t,o,i="read"){const s=[];for(const u of Object.keys(t))o.includes(u)||s.push({field:u,problem:"is not allowed",received:t[u]});const n=I(t,"node",s),r=I(t,"cwd",s),a=I(t,"profile",s),d=I(t,"store",s),f=I(t,"dir",s),c=I(t,"select_profile",s);if(f!==void 0&&(d!==void 0||c!==void 0)&&s.push({field:"dir",problem:"selects the project store itself and cannot combine with store or select_profile"}),c!==void 0&&d!=="profile"&&s.push({field:"select_profile",problem:"requires store profile"}),d!==void 0&&!Ie.includes(d)&&!/^app:[A-Za-z0-9_-]{1,64}$/.test(d)&&s.push({field:"store",problem:`must be one of ${Ie.join(", ")} or app:<id>`,received:d}),e.principal.class==="app"&&(n!==void 0||r!==void 0||a!==void 0||f!==void 0||c!==void 0||t.mode==="cli"))throw new l(403,"scope_missing","an app server cannot select a node, cwd or profile");if(e.principal.class==="broker"&&(n!==void 0&&n!==e.principal.node||r!==void 0||a!==void 0||f!==void 0||c!==void 0))throw new l(403,"scope_missing","a broker can select only its own node and mounted memory");n!==void 0&&a!==void 0&&s.push({field:"node",problem:"derives profile and cannot be combined with it"}),s.length>0&&N("memory scope",s);let g,k;if(n!==void 0){const u=Z(n);if(u===null)throw new l(404,"node_not_found",`unknown node: ${n}`);g={cwd:r??u.cwd,profileId:u.profile_id??null,nodeId:u.node_id,grantee:u.grantee},k=u.node_id}else g={cwd:r??(e.principal.class==="broker"?Z(e.principal.node)?.cwd??"/":e.principal.class==="app"?V(e.principal.app).files:"/"),profileId:a??(e.principal.class==="broker"?Z(e.principal.node)?.profile_id??null:null),nodeId:e.principal.class==="broker"?e.principal.node:null,grantee:e.principal.class==="person"?void 0:e.principal.app},e.principal.class==="broker"&&(k=e.principal.node);const b=d;if(b==="node"&&k===void 0)throw new l(400,"invalid_request","store node requires node");if(b==="profile"&&g.profileId===null&&c===void 0)throw new l(400,"invalid_request","store profile requires profile or node with a profile");if(c!==void 0&&(g={...g,profileId:He(c).profileId}),f!==void 0){const u=Ze(g.cwd,f);if(!Ge(u)||!Ue(u).isDirectory())throw new l(400,"invalid_request",`--dir does not exist or is not a directory: ${f}`);const R=Q(ze(u));if(!T(e,R.repositoryRoot??R.ownerDir??u))throw new l(403,"scope_missing","project memory is outside the run mounts");return g={...g,allowsStore:m((y,me)=>y.scope==="project"&&T(e,y.repositoryRoot??y.ownerDir??y.storeRoot),"allowsStore"),allowsProject:m(y=>T(e,y),"allowsProject")},{target:g,nodeId:k,store:R,access:i,permitted:m(y=>y.scope==="project"&&T(e,y.repositoryRoot??y.ownerDir??y.storeRoot),"permitted")}}const h=e.principal,w=h.class==="person"?[]:Y(h),p=h.class==="broker"?h.scopes:null,S=h.class==="person"?null:h.app,D=m((u,R)=>h.class==="person"?!0:u.scope==="project"?T(e,u.repositoryRoot??u.ownerDir??u.storeRoot):fe(S,w,p,u,i,R),"permitted");if(g={...g,allowsStore:D,allowsProject:m(u=>T(e,u),"allowsProject")},d?.startsWith("app:")||h.class==="app"&&d===void 0){const u=d??(h.class==="person"?"app:terminal":h.app),R=F("profile",V(u).memory,u);if(!D(R))throw new l(403,"scope_missing",`missing memory permission for ${u}`);return{target:g,nodeId:k,store:R,access:i,permitted:D}}if(b!==void 0&&h.class!=="person"){const u=ee({...g,allowsStore:void 0,allowsProject:void 0},b);if(u.length===0||!u.some(R=>D(R)))throw new l(403,"scope_missing",`missing memory permission for ${b}`)}return{target:g,...b===void 0?{}:{scope:b},...k===void 0?{}:{nodeId:k},access:i,permitted:D}}m(v,"resolveScope");function _(e,t){if(e.access!==t)throw new Error("memory route access mismatch");if(e.store!==void 0&&!e.permitted(e.store))throw new l(403,"scope_missing","memory store is not permitted")}m(_,"requireScope");function U(e,t,o){if(!e.permitted(t,o))throw new l(403,"scope_missing",`missing memory write permission for ${o}`)}m(U,"requireWrite");function j(e,t){const o=e.scope;if(!t)return{...o===void 0?{}:{scope:o},...e.store===void 0?{}:{store:e.store}};if(e.store!==void 0)return{scope:e.store.scope,store:e.store,memoryDir:e.store.storeRoot};const i=o??(e.target.nodeId?"node":X(e.target.cwd)!==null?"project":"user");if(i==="builtin")throw new l(400,"invalid_request","builtin memory is read-only");if(i==="node"){const r=Qe(e.target.nodeId,e.target.grantee),a=F("node",r,e.target.grantee);if(!e.permitted(a))throw new l(403,"scope_missing","node memory is not permitted");return{scope:i,store:a,memoryDir:r}}if(i==="profile"){const{profileId:r,manifest:a}=Ke(e.target.profileId),d=a.grantee?.startsWith("app:")?K(V(a.grantee).memory,"profiles",r):nt(r),f=F("profile",d,a.grantee,r);if(!e.permitted(f))throw new l(403,"scope_missing","profile memory is not permitted");return{scope:i,store:f,memoryDir:d}}if(i==="project"){const r=o==="project"?tt(e.target.cwd):X(e.target.cwd);if(r===null)throw new l(400,"invalid_request","store project requires a project memory store in cwd");const a=Q(r.slice(0,-8).replace(/\/$/,""));if(!e.permitted(a))throw new l(403,"scope_missing","project memory is outside the run mounts");return{scope:i,store:a,memoryDir:a.storeRoot}}const s=pe("user");if(s===null)throw new Error("user memory directory unavailable");const n=F("user",s);if(!e.permitted(n))throw new l(403,"scope_missing","user memory is not permitted");return{scope:"user",store:n,memoryDir:s}}m(j,"selection");function Ae(e,t){return e.length>1?e.map(o=>qe(o,t)):void 0}m(Ae,"candidates");function Te(e){return{name:e.name,short_form:e.shortForm,kind:e.kind,privacy:e.privacy,scope:e.scope,extensions:e.extensions,path:e.path,store_root:e.storeRoot,physical_relative_path:e.physicalRelativePath,...Ae(e.candidates,e.candidates[0])===void 0?{}:{candidates:Ae(e.candidates,e.candidates[0])}}}m(Te,"summary");function re(e){try{const t=Ee(e);if(t.kind==="document")return t}catch(t){if(!(t instanceof J)||t.code!=="not_found")throw t}throw new l(404,"memory_document_not_found",`memory document not found: ${e.name}`)}m(re,"requestedDocument");function ie(e,t,o=j(t,!1),i=!1){const s=re({target:t.target,...o,name:e,frontmatter:i,interpolateNodePaths:!1}),n=s.doc;return{...Te({name:n.name,kind:String(n.frontmatter?.kind??""),privacy:x(n.frontmatter),scope:n.scope,path:n.path,storeRoot:n.root,physicalRelativePath:n.physicalRelativePath,shortForm:String(n.frontmatter?.["short-form"]??""),slash:n.frontmatter?.slash===!0,extensions:n.frontmatter?.extensions??{},candidates:s.candidates}),body:s.content,frontmatter:n.frontmatter===null?null:{...n.frontmatter,privacy:x(n.frontmatter)},representation:n.representation,links:[...s.links]}}m(ie,"document");function se(e,t,o){if(e===void 0)return o;const i=typeof e=="number"?e:Number(e);if(!Number.isInteger(i)||i<1||i>Pe)throw new l(400,"invalid_request",`${t} must be an integer from 1 through ${Pe}`);return i}m(se,"number");function ae(e,t,o){if(e===void 0)return t;const i=typeof e=="number"||typeof e=="string"&&e.trim()!==""?Number(e):NaN;if(!Number.isInteger(i)||i<1||o!==void 0&&i>o)throw new l(400,"invalid_request",`limit must be ${o===void 0?"a positive integer":`an integer from 1 through ${o}`}`);return i}m(ae,"cliLimit");function Oe(e,t){const o=typeof e=="number"?e:Number(e);if(!Number.isFinite(o)||o<1)throw new l(400,"invalid_request",`${t} must be a finite number of at least 1`);return o}m(Oe,"positiveNumber");function W(e,t){const o=e[t];if(o!==void 0){if(o===!0||o==="true")return!0;if(o===!1||o==="false")return!1;throw new l(400,"invalid_request",`${t} must be a boolean`)}}m(W,"optionalBoolean");function Ne(e,t,o=[]){if(e!==void 0&&!E(e))throw new l(400,"invalid_request","frontmatter must be an object");const i=e===void 0?{}:e;for(const r of o)if(r in i)throw new l(400,"invalid_request",`frontmatter.${r} cannot be set directly`);const s={},n={"short-form":"shortForm","when-and-why-to-read":"whenAndWhyToRead","lint-ignore":"lintIgnore",rationale:"docRationale",kind:"kind",privacy:"privacy",unlisted:"unlisted",surfaces:"surface",gate:"gate",slash:"slash"};for(const[r,a]of Object.entries(i)){const d=n[r];if(d===void 0)throw new l(400,"invalid_request",`frontmatter.${r} is not writable through this route`);if(r==="privacy"){if(!B.includes(a))throw new l(400,"invalid_request",`frontmatter.privacy must be one of ${B.join(", ")}`)}else if(r==="unlisted"||r==="slash"){if(a!==!0)throw new l(400,"invalid_request",`frontmatter.${r} must be true; remove it with unset`)}else if(r==="surfaces"){if(!Array.isArray(a)||!a.every(f=>typeof f=="string"))throw new l(400,"invalid_request","frontmatter.surfaces must be a string array")}else if(r==="lint-ignore"){if(!Array.isArray(a)||!a.every(f=>typeof f=="string"))throw new l(400,"invalid_request","frontmatter.lint-ignore must be a string array")}else if(typeof a!="string"||a.trim()==="")throw new l(400,"invalid_request",`frontmatter.${r} must be a non-empty string`);s[d]=a}if(t!==void 0){if(!E(t))throw new l(400,"invalid_request","extensions must be an object");const r=[];for(const[a,d]of Object.entries(t)){if(!E(d))throw new l(400,"invalid_request",`extensions.${a} must be an object`);for(const[f,c]of Object.entries(d))r.push(`extensions.${a}.${f}=${String(c)}`)}s.extension=r}return s}m(Ne,"frontmatterFields");function de(e,t){if(t.nodeId!==void 0&&e.principal.class!=="app"){if(e.principal.class==="broker"&&e.principal.node!==t.nodeId)throw new l(403,"other_app_run","memory exposure can only be recorded for the calling node");return t.nodeId}}m(de,"ledgerNode");function Ce(e,t,o,i){const s=de(e,t);if(s===void 0||i.length===0)return;const n=te(s),r=We("sha256").update(JSON.stringify(i)).digest("hex");ke(G(n,"transcript"),`listing:memory-${o}:${r}`,"content"),z(s,n)}m(Ce,"listingExposure");function Me(e,t){if(t.length!==0)try{yt(e,t)}catch(o){gt({level:"warn",event:"memory_reads.insert_failed",error:o,fields:{node_id:e}})}}m(Me,"recordMemoryReads");function kt(e){const t=O(e),o=[],i=I(t,"kind",o),s=I(t,"after",o);o.length>0&&N("memory list query",o);const n=v(e,t,["node","cwd","profile","store","dir","select_profile","mode","kind","limit","cursor","after"]);_(n,P);const r=vt({target:n.target,...j(n,!1),...i===void 0?{}:{kind:i}});if(t.mode==="cli"){const c=H(r,{limit:ae(t.limit,50,200),cursor:t.cursor},{defaultLimit:50,maxLimit:200,keyOf:bt,compareKeys:wt,total:"count"});return Ce(e,n,"list",c.items),{status:200,body:c}}r.sort((c,g)=>c.name.localeCompare(g.name));const a=s===void 0?r:r.filter(c=>c.name.localeCompare(s)>0),d=a.slice(0,se(t.limit,"limit",ne)).map(Te);return{status:200,body:{object:"list",data:d,has_more:a.length>d.length}}}m(kt,"handleList");function qt(e){const t=O(e);if(t.mode==="cli"){const i=v(e,t,["node","cwd","profile","store","dir","mode","kind","frontmatter"]);_(i,P);const s=A(e),n=Ee({target:i.target,...j(i,!1),name:s,...t.kind===void 0?{}:{kind:String(t.kind)},frontmatter:W(t,"frontmatter")===!0}),r=de(e,i),a=r===void 0?ht():te(r),d=[],f=G(a,"transcript",d);if(n.kind==="directory"){const u=lt(n.listingByName,n.name,r===void 0?null:f,!1);return r!==void 0&&(ke(f,at(n.name),"preview"),z(r,a)),{status:200,body:{name:n.name,listing:u,follow_up:"Each line is readable with `crtr memory read <name>` \u2014 a `[[name]]: <line>` entry is a doc, a bare `[[name]]` is a subdirectory whose read browses deeper. Browse the whole inventory with `crtr memory list`."}}}const{doc:c,candidates:g,content:k,links:b,listingByName:h}=n;Se(G(a,"transcript"),c,"content");const w=ve(c,{subject:i.nodeId===void 0?null:_e(i.nodeId),target:f,byName:h,memoryTarget:i.target,listings:"blocks",explicit:!0});if(r!==void 0){z(r,a);const u=new Date().toISOString();Me(r,[...oe([{name:c.name,scope:c.scope}],"read",u),...oe(d,"loaded",u)])}const p=w.listing,S=p!==void 0&&p.length>0,D=S?b.length>0?"Each `[[name]]` line in `listing` is one of this directory\u2019s immediate members, and the `[[name]]` links in the body are further reading \u2014 follow either with `crtr memory read <name>` only when the task needs that depth.":"Each `[[name]]` line in `listing` is one of this directory\u2019s immediate members, readable with `crtr memory read <name>` \u2014 follow one only when the task needs that depth.":b.length>0?"The `[[name]]` links in the body are further reading \u2014 follow one with `crtr memory read <name>` only when the task needs that depth.":null;return{status:200,body:{name:c.name,local_name:c.localName,kind:ft(c),privacy:x(c.frontmatter),scope:c.scope,path:c.path,store_root:c.root,physical_relative_path:c.physicalRelativePath,representation:c.representation,...g.length>1?{candidates:g.map(u=>qe(u,c))}:{},content:k,attachment_blocks:w.blocks,...S?{listing:p}:{},extensions:ut(c.frontmatter?.extensions,mt(c)),...b.length>0?{links:b}:{},...D===null?{}:{follow_up:D}}}}const o=v(e,t,["node","cwd","profile","store","frontmatter"]);return _(o,P),{status:200,body:ie(A(e),o,j(o,!1),W(t,"frontmatter")===!0)}}m(qt,"handleRetrieve");function jt(e){if(E(e.body)&&e.body.mode==="cli"){const{mode:k,...b}=e.body,h=v(e,e.body,["node","cwd","profile","store","dir","select_profile","fields","mode"],q);_(h,q);const w=[],p=C(b.fields,["name","kind","whenAndWhyToRead","body","privacy","shortForm","unlisted","surface","gate","lintIgnore","slash","rationale","extension"],w),S=$(p,"name",w),D=$(p,"kind",w);$(p,"whenAndWhyToRead",w),$(p,"body",w),D!==void 0&&D!=="knowledge"&&D!=="preference"&&w.push({field:"kind",problem:"must be knowledge or preference",received:D});for(const y of["privacy","shortForm","gate","rationale"])p[y]!==void 0&&(typeof p[y]!="string"||p[y].trim()==="")&&w.push({field:y,problem:"must be a non-empty string",received:p[y]});p.privacy!==void 0&&!B.includes(p.privacy)&&w.push({field:"privacy",problem:`must be one of ${B.join(", ")}`,received:p.privacy});for(const y of["unlisted","slash"])p[y]!==void 0&&typeof p[y]!="boolean"&&w.push({field:y,problem:"must be a boolean",received:p[y]});for(const y of["surface","extension"])p[y]!==void 0&&(!Array.isArray(p[y])||!p[y].every(me=>typeof me=="string"))&&w.push({field:y,problem:"must be a string array",received:p[y]});if(p.lintIgnore!==void 0&&typeof p.lintIgnore!="string"&&(!Array.isArray(p.lintIgnore)||!p.lintIgnore.every(y=>typeof y=="string"))&&w.push({field:"lintIgnore",problem:"must be a string or string array",received:p.lintIgnore}),w.length>0&&N("memory create request",w),!M(S))throw new l(400,"invalid_memory_doc_name","memory document name must be slash-joined [A-Za-z0-9_-] segments");const u=j(h,!0);U(h,u.store,S);const R={created:new Date().toISOString(),cwd:h.target.cwd,...h.target.nodeId===null?{}:{node:h.target.nodeId}};return{status:200,body:je({target:h.target,scope:u.scope,store:u.store,memoryDir:u.memoryDir,isExplicitProjectStore:b.dir!==void 0||b.store==="project",origin:R,fields:p})}}const t=[],o=C(e.body,["name","kind","when_and_why_to_read","body","frontmatter","extensions","node","cwd","profile","store"],t),i=$(o,"name",t),s=$(o,"kind",t),n=$(o,"when_and_why_to_read",t),r=$(o,"body",t);if(t.length>0&&N("memory create request",t),!M(i))throw new l(400,"invalid_memory_doc_name","memory document name must be slash-joined [A-Za-z0-9_-] segments");const a=v(e,o,["name","kind","when_and_why_to_read","body","frontmatter","extensions","node","cwd","profile","store"],q);_(a,q);const d=j(a,!0);U(a,d.store,i);const f={name:i,kind:s,whenAndWhyToRead:n,body:r,...Ne(o.frontmatter,o.extensions,["kind","when-and-why-to-read","origin","last-updated"])},c=je({target:a.target,scope:d.scope,memoryDir:d.memoryDir,store:d.store,isExplicitProjectStore:!1,origin:{created:new Date().toISOString(),cwd:a.target.cwd,...a.target.nodeId===null?{}:{node:a.target.nodeId}},fields:f}),g=ie(c.name,a,d);return{status:200,body:c.findings===void 0?g:{...g,findings:c.findings}}}m(jt,"handleCreate");function Dt(e){if(E(e.body)&&e.body.mode==="cli"){const{mode:a,...d}=e.body,f=v(e,e.body,["node","cwd","profile","store","dir","select_profile","fields","mode"],q);if(_(f,q),!E(d.fields))throw new l(400,"invalid_request","fields must be an object");return{status:200,body:$e({target:f.target,selection:{target:f.target,...j(f,!1)},fields:{...d.fields,name:A(e)}})}}const t=[],o=C(e.body,["rationale","body","frontmatter","extensions","unset","node","cwd","profile","store"],t),i=$(o,"rationale",t);o.body!==void 0&&typeof o.body!="string"&&t.push({field:"body",problem:"must be a string",received:o.body}),o.unset!==void 0&&(!Array.isArray(o.unset)||!o.unset.every(a=>typeof a=="string"))&&t.push({field:"unset",problem:"must be a string array",received:o.unset}),t.length>0&&N("memory update request",t);const s=A(e),n=v(e,o,["rationale","body","frontmatter","extensions","unset","node","cwd","profile","store"],q);_(n,q);const r=Ne(o.frontmatter,o.extensions,["kind","when-and-why-to-read","origin","last-updated"]);return $e({target:n.target,selection:{target:n.target,...j(n,!1)},fields:{name:s,rationale:i,...o.body===void 0?{}:{body:o.body},...o.unset===void 0?{}:{unset:o.unset},...r}}),{status:200,body:ie(s,n)}}m(Dt,"handleUpdate");function Rt(e){if(E(e.body)&&e.body.mode==="cli"){const{mode:s,...n}=e.body,r=v(e,e.body,["node","cwd","profile","store","dir","fields","mode"],q);return _(r,q),{status:200,body:De({target:r.target,selection:{target:r.target,...j(r,!1)},fields:{name:A(e)}})}}const t=v(e,O(e),["node","cwd","profile","store"],q);_(t,q);const o=A(e);return{status:200,body:{...De({target:t.target,selection:{target:t.target,...j(t,!1)},fields:{name:o}}),deleted:!0}}}m(Rt,"handleDelete");function Et(e){if(E(e.body)&&e.body.mode==="cli"){const{mode:a,...d}=e.body,f=v(e,e.body,["node","cwd","profile","store","dir","fields","mode"],q);if(_(f,q),!E(d.fields))throw new l(400,"invalid_request","fields must be an object");if(typeof d.fields.to!="string"||!M(d.fields.to))throw new l(400,"invalid_memory_doc_name","move destination must be a memory document name");return Le(f,A(e),d.fields.to),{status:200,body:Re({target:f.target,selection:{target:f.target,...j(f,!1)},fields:{...d.fields,name:A(e)}})}}const t=[],o=C(e.body,["to","node","cwd","profile","store"],t),i=$(o,"to",t);if(t.length>0&&N("memory move request",t),!M(i))throw new l(400,"invalid_memory_doc_name","memory document name must be slash-joined [A-Za-z0-9_-] segments");const s=v(e,o,["to","node","cwd","profile","store"],q);_(s,q);const n=A(e);return Le(s,n,i),{status:200,body:Re({target:s.target,selection:{target:s.target,...j(s,!1)},fields:{name:n,to:i}})}}m(Et,"handleMove");function Le(e,t,o){const i=re({target:e.target,...j(e,!1),name:t}).doc;U(e,i.store,t),U(e,i.store,o)}m(Le,"requireMoveDestination");function le(e){return"line"in e?`${e.name}\0${e.scope}\0${e.physical_relative_path}\0${String(e.line).padStart(10,"0")}`:e.name}m(le,"grepCursor");function $t(e){const t=[],o=C(e.body,["query","kind","grep","body","limit","cursor","after","min_score","node","cwd","profile","store","dir","mode"],t),i=$(o,"query",t),s=I(o,"kind",t),n=I(o,"after",t);t.length>0&&N("memory search request",t);const r=v(e,o,["query","kind","grep","body","limit","cursor","after","min_score","node","cwd","profile","store","dir","mode"]);_(r,P);const a=W(o,"grep"),d=W(o,"body"),f=o.min_score===void 0?void 0:Oe(o.min_score,"min_score");if(a===!0&&d===!0)throw new l(400,"invalid_request","grep and body cannot both be true");if(a===!0&&f!==void 0)throw new l(400,"invalid_request","min_score is only available in ranked mode");const c=St({target:r.target,...j(r,!1),query:i,...s===void 0?{}:{kind:s},...a===void 0?{}:{grep:a},...d===void 0?{}:{body:d},...f===void 0?{}:{minScore:f}});if(o.mode==="cli"){const h=ae(o.limit,10,100),w=o.cursor,p=c.mode==="grep"?H([...c.hits],{limit:h,cursor:w},{defaultLimit:10,maxLimit:100,keyOf:m(S=>`${S.name}:${S.scope}:${S.physical_relative_path}:${String(S.line).padStart(7,"0")}`,"keyOf"),total:"omit"}):H([...c.hits],{limit:h,cursor:w},{defaultLimit:10,maxLimit:100,keyOf:m(S=>`${String(1e6-S.score).padStart(7,"0")}:${S.scope}:${S.name}:${S.physical_relative_path}`,"keyOf"),total:"omit"});return Ce(e,r,"find",p.items),{status:200,body:{mode:c.mode,matches:c.matches,hits:p.items,next_cursor:p.next_cursor}}}const g=[...c.hits].sort((h,w)=>a===!0?le(h).localeCompare(le(w)):h.name.localeCompare(w.name)),k=n===void 0?g:g.filter(h=>(a===!0?le(h):h.name).localeCompare(n)>0),b=k.slice(0,se(o.limit,"limit",ne));return{status:200,body:{object:"list",data:b,has_more:k.length>b.length}}}m($t,"handleSearch");function It(e){const t=O(e),o=v(e,t,["node","cwd","profile","store","dir","select_profile","mode","limit","revision","diff"]);_(o,P);const i=t.revision===void 0?void 0:Oe(t.revision,"revision"),s=W(t,"diff"),n=_t({target:o.target,...j(o,!1),name:A(e),limit:t.mode==="cli"?ae(t.limit,10):se(t.limit,"limit",ne),...i===void 0?{}:{revision:i},...s===void 0?{}:{diff:s}});return t.mode==="cli"?{status:200,body:n}:{status:200,body:{name:n.name,scope:n.scope,log_path:n.logPath,total:n.total,...n.deleted===void 0?{}:{deleted:n.deleted},..."record"in n?{record:n.record}:{revisions:[...n.revisions]}}}}m(It,"handleHistory");function Pt(e){const t=O(e),o=e.query.get("name");if(o===null||!M(o))throw new l(400,"invalid_memory_doc_name","memory document name must be slash-joined [A-Za-z0-9_-] segments");const i=v(e,t,["name","node","cwd","profile","store","dir","select_profile","mode"]);_(i,P);const s=re({target:i.target,...j(i,!1),name:o});if(t.mode==="cli"){const n=pt({name:o,winner:s.doc,candidates:s.candidates});return{status:200,body:{name:n.name,path:n.path,scope:n.scope,local_name:n.localName,store_root:n.root,physical_relative_path:n.physicalRelativePath,representation:n.representation,origin:n.frontmatter?.origin??null}}}return{status:200,body:{name:s.doc.name,scope:s.doc.scope,path:s.doc.path,store_root:s.doc.root,physical_relative_path:s.doc.physicalRelativePath,...s.doc.plugin===void 0?{}:{plugin:s.doc.plugin}}}}m(Pt,"handleResolve");function At(e){const t=v(e,O(e),["node","cwd","profile"]);_(t,P);const o=ye(t.target),i=new Set,s=[];for(const n of o.docs){if(i.has(n.name))continue;i.add(n.name);const r=we(n);if(r?.slash===!0)try{const a=ue(n.path,"utf8"),d=be(a).body;s.push({name:n.name,short_form:r.shortForm,path:n.path,canonical_body:n.body,execution_body:t.nodeId===void 0?d:ce(d,t.nodeId,t.target.grantee)})}catch(a){s.push({name:n.name,short_form:r.shortForm,path:n.path,canonical_body:n.body,error:a instanceof Error?a.message:String(a)})}}return{status:200,body:s}}m(At,"handleSlashDocs");async function Tt(e){const t=C(e.body,["node","name"],[]),o=v(e,t,["node","name"]);if(_(o,P),o.nodeId===void 0)throw new l(400,"invalid_request","slash attachments require a node");const i=$(t,"name",[]);if(i===void 0)throw new l(400,"invalid_request","slash document name required");const n=ye(o.target).resolve([i]).get(i);if(n===void 0)throw new l(404,"not_found",`memory slash document not found: ${i}`);const r=de(e,o);if(r===void 0)throw new l(403,"permission_error","slash attachments require the calling node");const a=be(ue(n.path,"utf8")),d={...n,frontmatter:a.data,body:a.body};if(we(d)?.slash!==!0)throw new l(404,"not_found",`memory slash document not found: ${i}`);const f=ce(d.body,r,o.target.grantee),c=te(r),g=[],k=G(c,"transcript",g);Se(k,d,"content");const b=ge(o.target,{quiet:!0,includeDescendants:!0}),h=ve(d,{subject:_e(o.nodeId),target:k,byName:dt(b.docs),memoryTarget:o.target,listings:"blocks"}).blocks;return z(r,c),Me(r,oe(g,"loaded")),{status:200,body:{blocks:h,execution_body:f}}}m(Tt,"handleSlashAttachments");function Ot(e){const t=C(e.body,["node","cwd","profile","store","dir","mode"],[]),o=v(e,t,["node","cwd","profile","store","dir","mode"]);if(_(o,P),t.dir!==void 0&&(typeof t.dir!="string"||t.dir===""))throw new l(400,"invalid_request","dir must be a nonempty directory path");if(t.dir!==void 0&&t.store!==void 0)throw new l(400,"invalid_request","dir selects one store and cannot combine with store");if(e.principal.class!=="person"){const n=o.store??(o.scope===void 0?void 0:ee(o.target,o.scope).find(d=>d.mountStatus==="ready"));if(n===void 0||(n.scope==="project"?!T(e,n.repositoryRoot??n.ownerDir??n.storeRoot):!fe(e.principal.app,Y(e.principal),e.principal.class==="broker"?e.principal.scopes:null,n,"read",void 0,!0)))throw new l(403,"scope_missing","memory lint requires a whole-store read grant and an explicit store");const r=he(n),a=m(d=>({rule:d.rule,path:d.path,message:d.message}),"row");return{status:200,body:{checked:r.checked,stores:r.storesLinted,findings:r.errors.map(a),warnings:r.warnings.map(a),notices:r.notices.map(a)}}}const i=t.dir===void 0?rt({target:o.target,...o.scope===void 0?{}:{scope:o.scope}}):(()=>{const n=o.store,r=ge({...o.target,cwd:n.ownerDir??n.storeRoot,nodeId:null},{quiet:!0,includeDescendants:!0}),a=he(n,{resolvable:st(r.docs),frontDoor:"advisory"}),d=it(r.docs,{flagStoreRoot:n.storeRoot});return{...a,findings:[...a.findings,...d],warnings:[...a.warnings,...d]}})(),s=m(n=>({rule:n.rule,path:n.path,message:n.message,...n.name===void 0?{}:{name:n.name},...n.scope===void 0?{}:{scope:n.scope},...n.storeRoot===void 0?{}:{store_root:n.storeRoot},...n.paths===void 0?{}:{paths:[...n.paths]}}),"row");return{status:200,body:{checked:i.checked,stores:i.storesLinted,..."profileProjects"in i?{profile_projects:i.profileProjects}:{},findings:i.errors.map(s),warnings:i.warnings.map(s),notices:i.notices.map(s)}}}m(Ot,"handleLint");function Nt(e){const t=v(e,O(e),["node","cwd","profile"]);_(t,P);const o=X(t.target.cwd),i=o!==null&&T(e,t.target.cwd)?"project":"user",s=i==="user"?pe("user"):K(o,"memory");if(e.principal.class!=="person"&&!t.permitted(i==="user"?F("user",s):Q(t.target.cwd)))throw new l(403,"scope_missing","memory extensions are not permitted");if(s===null)throw new Error("user memory directory unavailable");return{status:200,body:ct({scope:i,path:K(s,".extension-help.md")})}}m(Nt,"handleExtensionCatalog");function L(e,t){const o=E(e.body)&&e.body.mode==="cli"?e.body:O(e);if(!E(o)||o.mode!=="cli")return t(e);const i=Object.fromEntries(["node","cwd","profile","store","dir","select_profile"].filter(r=>o[r]!==void 0).map(r=>[r,o[r]])),s=v(e,i,Object.keys(i)),n=(s.store===void 0?ee(s.target,s.scope,!0,!1):[s.store]).filter(r=>r.mountStatus!=="ready"&&r.mountStatus!=="absent"&&r.diagnostic!==void 0).map(r=>`memory store not mounted: ${r.diagnostic}`);s.store===void 0&&(s.scope===void 0||s.scope==="project")&&n.push(...ot(et(s.target.cwd,s.target.profileId).map(({root:r})=>r).filter(r=>T(e,r))));try{const r=t(e);return n.length===0||!E(r.body)?r:{...r,body:{...r.body,diagnostics:n}}}catch(r){throw n.length>0&&r instanceof l&&r.status===404?new l(r.status,r.code,`${r.message}
-${n.join(`
-`)}`,r.details):n.length>0&&r instanceof J&&r.code==="not_found"?new J(r.code,`${r.message}
-${n.join(`
-`)}`,r.exitCode,r.details):r}}m(L,"withCliDiscovery");function Ct(e){const t=e.query.get("conversation_id");if(t===null||!/^[0-9a-f-]{36}$/i.test(t)||e.query.size!==1)throw new l(400,"invalid_request","conversation_id must be a single conversation UUID");try{const o=Ve().header(t),i=Be(o.path);if(e.principal.class!=="person"&&(i===null||!Xe(e.principal,i.grantee??"app:terminal")))throw new l(404,"not_found",`conversation not found: ${t}`);return{status:200,body:{session_file:o.path}}}catch(o){throw o instanceof Ye?new l(404,"not_found",`conversation not found: ${t}`):o}}m(Ct,"handleOriginConversation");const _o=[{method:"GET",pattern:"/v1/memory/docs",handler:m(e=>L(e,kt),"handler")},{method:"GET",pattern:"/v1/memory/docs/:name",handler:m(e=>L(e,qt),"handler")},{method:"POST",pattern:"/v1/memory/docs",handler:jt},{method:"PATCH",pattern:"/v1/memory/docs/:name",handler:Dt},{method:"DELETE",pattern:"/v1/memory/docs/:name",handler:Rt},{method:"POST",pattern:"/v1/memory/docs/:name/move",handler:Et},{method:"POST",pattern:"/v1/memory/search",handler:m(e=>L(e,$t),"handler")},{method:"GET",pattern:"/v1/memory/docs/:name/history",handler:m(e=>L(e,It),"handler")},{method:"GET",pattern:"/v1/memory/resolve",handler:m(e=>L(e,Pt),"handler")},{method:"GET",pattern:"/v1/memory/origin",handler:Ct},{method:"GET",pattern:"/v1/memory/extensions",handler:Nt},{method:"POST",pattern:"/v1/memory/lint",handler:m(e=>L(e,Ot),"handler")},{method:"GET",pattern:"/v1/memory/slash",handler:At},{method:"POST",pattern:"/v1/memory/slash/attachments",handler:Tt}];export{_o as memoryRoutes};

package/dist/migrations/001-surfaces-frontmatter.d.ts

@@ -1,2 +0,0 @@
-import type { ConvergentMigration } from './types.js';
-export declare const surfacesFrontmatterMigration: ConvergentMigration;

package/dist/migrations/001-surfaces-frontmatter.js

@@ -1 +0,0 @@
-var u=Object.defineProperty;var o=(e,n)=>u(e,"name",{value:n,configurable:!0});import{parse as m}from"yaml";import{parseFrontmatterGeneric as d}from"../core/frontmatter.js";import{appendRenderedKey as h,dropTopLevelKeys as g,proveFrontmatterRoundTrip as y,rebuildDocSource as b}from"./frontmatter-splice.js";const a=["system-prompt-visibility","file-read-visibility","applies-to","read-when"],f=["none","name","preview","content"];function p(e){return f.indexOf(e)}o(p,"rungRank");function c(e){return typeof e=="string"&&f.includes(e)?e:"none"}o(c,"parseRung");function v(e){return typeof e=="string"?e.trim()===""?[]:[e]:Array.isArray(e)?e.filter(n=>typeof n=="string"&&n.trim()!==""):[]}o(v,"parseAppliesTo");function w(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}o(w,"parsePredicate");function l(e){return e.split("/").map(n=>n.replace(/^\d{2}-/,"")).join("/")}o(l,"normalizeName");function k(e){const n=e.frontmatter;if(n===null||n.kind!=="knowledge"&&n.kind!=="preference")return null;const t=l(e.relPath.replace(/\.md$/,"")),r=n.name,i=typeof r=="string"&&r.trim()!==""?l(r.trim()):t;return{doc:e,name:i,spv:c(n["system-prompt-visibility"]),fv:c(n["file-read-visibility"]),appliesTo:v(n["applies-to"]),readWhen:w(n["read-when"]),hasOldFields:a.some(s=>s in n)}}o(k,"classify");function D(e){const n=new Map;for(const t of e){if(t.name!=="INDEX"&&!t.name.endsWith("/INDEX"))continue;const r=t.name==="INDEX"?"":t.name.slice(0,t.name.length-6);n.has(r)||n.set(r,t.spv)}return n}o(D,"buildCeiling");function N(e,n){let t=e.spv;const r=e.name.split("/");r.pop();for(let i=r.length;i>0;i--){const s=n.get(r.slice(0,i).join("/"));s!==void 0&&p(s)<p(t)&&(t=s)}return t}o(N,"effectiveBootRung");function W(e){const n=e.trim();return!n.includes("/")||n.startsWith("/")||n.startsWith("**")||n.startsWith("./")?n:`./${n}`}o(W,"anchorReadGlob");function E(e,n){const t=[];if(e.spv!=="none"&&n!=="none"&&t.push({on:"boot",at:n}),e.fv!=="none"){e.appliesTo.some(i=>i.trim()===".")&&(t.push({on:"workspace-open",at:e.fv}),t.push({on:"read",match:"./**",at:e.fv}));const r=e.appliesTo.filter(i=>i.trim()!==".").map(W);r.length>0&&t.push({on:"read",match:r.length===1?r[0]:r,at:e.fv}),e.readWhen!==void 0&&t.push({on:"read","match-frontmatter":e.readWhen,at:e.fv})}return t}o(E,"planEntries");function F(e,n,t){let r=g(e,a,t);n.length>0?r=h(r,"surfaces",n,t):r=r.replace(/\r?\n$/,"");const i={...m(e)};for(const s of a)delete i[s];return n.length>0&&(i.surfaces=n),y(r,i,t),r}o(F,"migratedYaml");const x={id:"001-surfaces-frontmatter",lane:"convergent",description:"surfaces frontmatter: fold visibility/applies-to/read-when routing into surfaces entries",apply(e){const n=e.docs.map(k).filter(i=>i!==null),t=D(n),r=[];for(const i of n){if(!i.hasOldFields)continue;const s=F(d(i.doc.source).raw,E(i,N(i,t)),i.doc.path);r.push({path:i.doc.path,after:b(i.doc.source,s,i.doc.path)})}return r}};export{x as surfacesFrontmatterMigration};