@north-light/crouter 0.3.353 → 0.3.354

package/dist/core/memory/service.d.ts

@@ -1,145 +0,0 @@
-import { type MemoryDoc, type MemoryScope, type MemoryStoreDescriptor, type MemoryTarget } from '../memory-resolver.js';
-import { type DeletedHistoryResolution, type HistoryRecord } from './history.js';
-import { type PrivacyLevel } from '../substrate/schema.js';
-export { createDoc, deleteDoc, moveDoc, updateDoc, type CreateDocInput, type DeleteDocInput, type MoveDocInput, type UpdateDocInput, } from './mutations.js';
-export interface MemoryServiceSelection {
-    /** Resolution identity is always supplied by the caller; this service never uses ambient process state. */
-    target: MemoryTarget;
-    /** Restrict a target view to one source tier. Ignored when an exact store is supplied. */
-    scope?: MemoryScope;
-    /** An exact store already selected by the CLI or API boundary. */
-    store?: MemoryStoreDescriptor | null;
-}
-export interface MemoryCandidateLocation {
-    winner: boolean;
-    scope: MemoryScope;
-    store_root: string;
-    physical_relative_path: string;
-    path: string;
-}
-export declare function candidateLocation(doc: MemoryDoc, winner: MemoryDoc): MemoryCandidateLocation;
-/** Refuse an exact project store that normal resolution would not mount. */
-export declare function requireMountedStore(store: MemoryStoreDescriptor): MemoryStoreDescriptor;
-/** Normalize and validate the public canonical memory address. */
-export declare function requireCanonicalName(rawName: string): string;
-/** Return the name local to an exact store, rejecting a name outside its namespace. */
-export declare function requireLocalNameInStore(store: MemoryStoreDescriptor, rawName: string): string;
-/** Resolution precedence rank used for stable inventory ordering. */
-export declare function memoryScopeRank(scope: MemoryScope): number;
-export interface ListedMemoryDoc {
-    name: string;
-    kind: string;
-    privacy: PrivacyLevel;
-    scope: MemoryScope;
-    path: string;
-    storeRoot: string;
-    physicalRelativePath: string;
-    shortForm: string;
-    slash: boolean;
-    extensions: Record<string, Record<string, string | boolean | number>>;
-    candidates: readonly MemoryDoc[];
-}
-/** Stable key used by inventory ordering and cursor resumption. */
-export declare function memoryListKey(doc: Pick<ListedMemoryDoc, 'scope' | 'kind' | 'name' | 'physicalRelativePath'>): string;
-/** Locale-aware total order for memory inventory keys. */
-export declare function compareMemoryListKeys(left: string, right: string): number;
-/** List the selected corpus. Target views deduplicate canonical names; exact stores retain physical collisions. */
-export declare function listDocs(selection: MemoryServiceSelection & {
-    kind?: string;
-}): ListedMemoryDoc[];
-export interface MemorySearchPath {
-    path: string;
-    store_root: string;
-    physical_relative_path: string;
-    candidates?: readonly MemoryCandidateLocation[];
-}
-export interface MemoryRankedSearchHit extends MemorySearchPath {
-    name: string;
-    kind: string;
-    privacy: PrivacyLevel;
-    scope: MemoryScope;
-    score: number;
-    short_form: string;
-}
-export interface MemoryGrepSearchHit extends MemorySearchPath {
-    name: string;
-    privacy: PrivacyLevel;
-    scope: MemoryScope;
-    line: number;
-    text: string;
-}
-export type MemorySearchResult = {
-    mode: 'ranked';
-    matches: number;
-    hits: readonly MemoryRankedSearchHit[];
-} | {
-    mode: 'grep';
-    matches: number;
-    hits: readonly MemoryGrepSearchHit[];
-};
-export interface SearchDocsInput extends MemoryServiceSelection {
-    query: string;
-    kind?: string;
-    grep?: boolean;
-    body?: boolean;
-    minScore?: number;
-}
-/** Search the selected corpus using either ranked relevance or body-line regex matching. */
-export declare function searchDocs(input: SearchDocsInput): MemorySearchResult;
-export interface ReadDocInput extends MemoryServiceSelection {
-    name: string;
-    kind?: string;
-    frontmatter?: boolean;
-    interpolateNodePaths?: boolean;
-    grantee?: string;
-}
-export type ReadDocResult = {
-    kind: 'document';
-    doc: MemoryDoc;
-    candidates: readonly MemoryDoc[];
-    content: string;
-    links: readonly string[];
-    listingByName: ReadonlyMap<string, MemoryDoc>;
-} | {
-    kind: 'directory';
-    name: string;
-    listingByName: ReadonlyMap<string, MemoryDoc>;
-};
-/** Resolve a document or directory and return unexpanded source plus listing/link data. */
-export declare function readDoc(input: ReadDocInput): ReadDocResult;
-export interface HistoryRevision {
-    revision: number;
-    op: HistoryRecord['op'];
-    at: string;
-    node?: string;
-    rationale?: string;
-    verbatim?: true;
-    body_changed: boolean;
-    frontmatter_changed: string[];
-    diff?: string;
-}
-export type ReadHistoryResult = {
-    name: string;
-    scope: MemoryScope;
-    logPath: string;
-    deleted?: DeletedHistoryResolution;
-    total: number;
-    record: {
-        revision: number;
-    } & HistoryRecord;
-} | {
-    name: string;
-    scope: MemoryScope;
-    logPath: string;
-    deleted?: DeletedHistoryResolution;
-    total: number;
-    revisions: readonly HistoryRevision[];
-};
-export interface ReadHistoryInput extends MemoryServiceSelection {
-    name: string;
-    limit: number;
-    diff?: boolean;
-    revision?: number;
-}
-/** Read one complete revision or a newest-first history summary from the selected corpus. */
-export declare function readHistory(input: ReadHistoryInput): ReadHistoryResult;

package/dist/core/memory/service.js

@@ -1,2 +0,0 @@
-var P=Object.defineProperty;var l=(e,n)=>P(e,"name",{value:n,configurable:!0});import{readFileBeneath as v}from"../spaces/open-beneath.js";import{notFound as w,usage as d}from"../errors.js";import{interpolateNodePaths as L}from"../canvas/paths.js";import{loadMemoryStoreView as q,loadMemoryTargetView as x,memoryStoresInPrecedence as M}from"../memory-resolver.js";import{canonicalSegments as k,stripNamespace as b,validateExplicitLocalName as F}from"./identity.js";import{memoryExtensionEffectiveCatalog as j,projectEffectiveMemoryExtensions as E}from"./extensions.js";import{historyLogPathForDoc as I,readHistoryRecords as B,resolveDeletedHistoryLogPath as K,summarizeChange as z,unifiedDiff as A}from"./history.js";import{docsByName as $,isDirName as S}from"../substrate/listings.js";import{effectivePrivacy as H,parseSubstrateDoc as _}from"../substrate/schema.js";import{literalBodySegment as T,serializeMemoryDocLiteral as V}from"./mutation-domain.js";import{createDoc as ue,deleteDoc as pe,moveDoc as ye,updateDoc as ge}from"./mutations.js";function O(e,n){return{winner:e===n,scope:e.scope,store_root:e.root,physical_relative_path:e.physicalRelativePath,path:e.path}}l(O,"candidateLocation");function y(e){if(e.scope!=="project"||e.mountStatus==="ready")return e;const n=e.ownerDir??e.storeRoot;if(e.mountStatus==="absent")throw d(`no memory store at ${e.storeRoot}`,{next:`Initialize it with \`crtr memory write <namespace> --dir ${n}\`, which declares the repository namespace.`});const a=e.repositoryRoot??n;throw d(e.diagnostic??`project memory store at ${e.storeRoot} does not declare a namespace`,{next:`Run \`crtr sys migrate --dir ${a}\`.`})}l(y,"requireMountedStore");function R(e){const n=k(e.trim()).join("/");if(n==="")throw d("memory document name required");const a=F(n);if(!a.ok)throw d(`invalid memory document name \`${e}\`: ${a.reason}`,{received:e,next:"Pass the full canonical name (a project document is <namespace>/<local name>); run `crtr memory find <leaf>` to look one up."});return n}l(R,"requireCanonicalName");function U(e,n){y(e);const a=R(n);if(e.namespace==="")return a;const s=b(a,e.namespace);if(s===null)throw d(`\`${a}\` is not in the namespace of the store at ${e.storeRoot} (\`${e.namespace}\`)`,{memory:a,next:`Every document there answers at \`${e.namespace}/<local name>\`; the store's own document answers at \`${e.namespace}\`.`});return s}l(U,"requireLocalNameInStore");function W(e){return e==="node"?-1:e==="project"?0:e==="profile"?1:e==="user"?2:3}l(W,"memoryScopeRank");function g(e){return e.store!=null?q(y(e.store),!0,e.target):x(e.target,{...e.scope===void 0?{}:{scope:e.scope},includeDescendants:!0,quiet:!0,reportDiscovery:!1})}l(g,"selectedView");function N(e){return g(e).docs}l(N,"selectedDocs");function C(e){return`${String(W(e.scope)+10).padStart(2,"0")}:${e.kind}:${e.name}:${e.physicalRelativePath}`}l(C,"memoryListKey");function G(e,n){const[a,s,i,...o]=e.split(":"),[r,t,c,...h]=n.split(":"),f=Number(a)-Number(r);if(f!==0)return f;const m=s.localeCompare(t);if(m!==0)return m;const u=i.localeCompare(c);return u!==0?u:o.join(":").localeCompare(h.join(":"))}l(G,"compareMemoryListKeys");function ce(e){const n=N(e),a=e.store==null,s=new Map;for(const r of n){const t=s.get(r.name);t!==void 0?t.push(r):s.set(r.name,[r])}const i=new Set,o=[];for(const r of n){const t=_(r);if(!(t===null||e.kind!==void 0&&t.kind!==e.kind)){if(a){if(i.has(t.name))continue;i.add(t.name)}o.push({name:t.name,kind:t.kind,privacy:t.privacy,scope:t.scope,path:t.path,storeRoot:r.root,physicalRelativePath:r.physicalRelativePath,shortForm:t.shortForm,slash:t.slash,extensions:E(r.frontmatter?.extensions,j(r)),candidates:s.get(r.name)??[r]})}}return o.sort((r,t)=>G(C(r),C(t))),o}l(ce,"listDocs");function J(e){const n=N(e),a=e.store==null,s=new Map;for(const r of n){const t=s.get(r.name);t!==void 0?t.push(r):s.set(r.name,[r])}const i=new Set,o=[];for(const r of n){const t=_(r);if(!(t===null||e.kind!==void 0&&t.kind!==e.kind)){if(a){if(i.has(t.name))continue;i.add(t.name)}o.push({name:t.name,localName:r.localName,kind:t.kind,privacy:t.privacy,scope:t.scope,path:t.path,store_root:r.root,physical_relative_path:r.physicalRelativePath,routing:t.whenAndWhyToRead,shortForm:t.shortForm,candidates:s.get(r.name)??[r],body:t.body})}}return o}l(J,"searchUnits");function D(e){return{path:e.path,store_root:e.store_root,physical_relative_path:e.physical_relative_path,...e.candidates.length>1?{candidates:e.candidates.map(n=>O(n,e.candidates[0]))}:{}}}l(D,"searchPath");function me(e){if(e.grep===!0&&e.body===!0)throw d("--grep and --body are mutually exclusive (--grep always scans bodies).");if(e.grep===!0&&e.minScore!==void 0)throw d("--min-score is only available in ranked mode.");if(e.minScore!==void 0&&e.minScore<1)throw d("--min-score must be at least 1.");const n=J(e);if(e.grep===!0){let o;try{o=new RegExp(e.query)}catch{throw d(`invalid regex pattern: ${e.query}`)}const r=[];for(const t of n)t.body.split(`
-`).forEach((c,h)=>{o.test(c)&&r.push({name:t.name,privacy:t.privacy,scope:t.scope,line:h+1,text:c,...D(t)})});return r.sort((t,c)=>{const h=t.name.localeCompare(c.name);if(h!==0)return h;const f=t.scope.localeCompare(c.scope);if(f!==0)return f;const m=t.physical_relative_path.localeCompare(c.physical_relative_path);return m!==0?m:t.line-c.line}),{mode:"grep",matches:r.length,hits:r}}const a=e.query.toLowerCase().split(/\s+/).filter(o=>o.length>0);if(a.length===0)throw d("query must contain at least one non-whitespace term");const s=[];for(const o of n){const r=o.name.toLowerCase(),t=o.localName.toLowerCase(),c=o.physical_relative_path.toLowerCase(),h=o.routing.toLowerCase(),f=o.shortForm.toLowerCase(),m=e.body===!0?o.body.toLowerCase():null;let u=0;for(const p of a)(r.includes(p)||t.includes(p)||c.includes(p))&&(u+=10),h.includes(p)&&(u+=5),f.includes(p)&&(u+=3),m!==null&&m.includes(p)&&(u+=1);u>0&&s.push({unit:o,score:u})}s.sort((o,r)=>{if(r.score!==o.score)return r.score-o.score;const t=o.unit.scope.localeCompare(r.unit.scope);if(t!==0)return t;const c=o.unit.name.localeCompare(r.unit.name);return c!==0?c:o.unit.physical_relative_path.localeCompare(r.unit.physical_relative_path)});const i=e.minScore??(s.length===0?1:Math.max(1,Math.ceil(s[0].score/2)));return{mode:"ranked",matches:s.length,hits:s.filter(o=>o.score>=i).map(({unit:o,score:r})=>({name:o.name,kind:o.kind,privacy:o.privacy,scope:o.scope,score:r,short_form:o.shortForm,...D(o)}))}}l(me,"searchDocs");function le(e){const n=g(e),a=e.kind===void 0?{}:{kind:e.kind},s=n.candidates(e.name,a),i=$(n.docs);if(s===null){const m=k(e.name.trim()).join("/");if(m!==""&&S(i,m))return{kind:"directory",name:m,listingByName:i};n.resolve(e.name,a)}const o=s,r=e.store==null?i:$([...n.docs,...x(e.target,{includeDescendants:!0,quiet:!0,reportDiscovery:!1}).docs]),t=o.winner,c=e.frontmatter===!0?t.frontmatter!==null&&!("privacy"in t.frontmatter)?V({...t.frontmatter,privacy:H(t.frontmatter)},T(v(t.root,t.path).toString("utf8"))):v(t.root,t.path).toString("utf8"):t.body,h=e.interpolateNodePaths===!1||e.target.nodeId===null?c:L(c,e.target.nodeId,e.grantee??e.target.grantee),f=[...o.winner.body.matchAll(/\[\[([^\]]+)\]\]/g)].map(m=>m[1].trim()).filter(m=>r.has(m)||S(r,m));return{kind:"document",doc:o.winner,candidates:o.candidates,content:h,links:f,listingByName:i}}l(le,"readDoc");function Q(e){const a=g(e).candidates(e.name);if(a!==null){const o=a.winner;if(o.plugin!==void 0)throw d(`${o.name} belongs to the installed plugin "${o.plugin}" \u2014 a read-only corpus with no revision history.`,{memory:o.name,plugin:o.plugin});if(o.scope==="builtin")throw d(`${o.name} is a builtin document shipped with the package \u2014 a read-only corpus with no revision history.`,{memory:o.name,scope:"builtin"});return{name:o.name,scope:o.scope,root:o.root,logPath:I(o)}}const s=R(e.name),i=e.store!=null?[y(e.store)]:M(e.target,e.scope,!0,!1).filter(o=>o.mountStatus==="ready"&&o.scope!=="builtin"&&o.plugin===void 0);for(const o of i){if(o.namespace!==""&&b(s,o.namespace)===null||e.target.allowsStore?.(o,s)===!1)continue;const r=U(o,s),t=K(o.storeRoot,r);if(t!==null)return{name:s,scope:o.scope,root:o.storeRoot,logPath:t.logPath,deleted:t}}throw w(`no memory document or revision history found: ${e.name}`,{memory:e.name,next:"Run `crtr memory find <query>` to locate the document. A document that exists but has no history predates this surface or has never been mutated through it."})}l(Q,"historyLocation");function de(e){const n=Q(e),a=B(n.root,n.logPath);if(a.length===0)throw w(`no revision history recorded for ${n.name}`,{memory:n.name,next:"The document predates this surface or has never been mutated through `crtr memory write`/`edit`/`delete`. Its first edit records the pre-existing content in full."});if(e.revision!==void 0){if(e.revision<1||e.revision>a.length)throw d(`revision ${e.revision} is out of range for ${n.name} (1..${a.length})`,{memory:n.name,next:`Run \`crtr memory history ${n.name}\` to see which revisions exist.`});return{...n,total:a.length,record:{revision:e.revision,...a[e.revision-1]}}}const s=a.map((i,o)=>{const r=z(i.before,i.after);return{revision:o+1,op:i.op,at:i.at,...i.node===void 0?{}:{node:i.node},...i.rationale===void 0?{}:{rationale:i.rationale},...i.verbatim===!0?{verbatim:!0}:{},...r,...e.diff===!0?{diff:A(i.before,i.after)}:{}}}).reverse().slice(0,Math.max(0,e.limit));return{...n,total:a.length,revisions:s}}l(de,"readHistory");export{O as candidateLocation,G as compareMemoryListKeys,ue as createDoc,pe as deleteDoc,ce as listDocs,C as memoryListKey,W as memoryScopeRank,ye as moveDoc,le as readDoc,de as readHistory,R as requireCanonicalName,U as requireLocalNameInStore,y as requireMountedStore,me as searchDocs,ge as updateDoc};

package/dist/core/memory/tree.d.ts

@@ -1,39 +0,0 @@
-import type { MemoryDoc } from '../memory-resolver.js';
-/** One canonical directory row: its own document (when it has one) plus its
- *  immediate members. */
-export interface MemoryTreeNode {
-    /** Exact canonical identity. `''` is the corpus root, which holds no
-     *  document — every store's documents merge beneath it. */
-    name: string;
-    /** Sort key among siblings: the stored physical path segment, `NN-` ordering
-     *  prefix retained, or this node's canonical segment when no physical
-     *  segment aligns. */
-    order: string;
-    /** The winning document attached to this row, or null for a directory that
-     *  carries none. */
-    document: MemoryDoc | null;
-    /** Every physical document sharing this identity, in source order. */
-    documentCandidates: readonly MemoryDoc[];
-    /** Immediate children that have members of their own, ordered. Each may also
-     *  carry its own `document`. */
-    childDirectories: readonly MemoryTreeNode[];
-    /** Immediate childless members, ordered. A node's own document never appears
-     *  among its children. */
-    childDocuments: readonly MemoryTreeDocumentNode[];
-}
-/** A childless node: it exists only because a document landed on it. */
-export interface MemoryTreeDocumentNode extends MemoryTreeNode {
-    document: MemoryDoc;
-}
-export interface MemoryTree {
-    root: MemoryTreeNode;
-    /** The node at an exact canonical name, or null when nothing lives there. */
-    node(name: string): MemoryTreeNode | null;
-    /** Does this canonical name have members? True for the corpus root when the
-     *  corpus is non-empty. */
-    isDirectory(name: string): boolean;
-}
-/** Merge a precedence-ordered corpus into the canonical tree. Documents sharing
- *  one identity stay in source order behind that node, so its `document` is the
- *  address winner. */
-export declare function buildMemoryTree(docs: readonly MemoryDoc[]): MemoryTree;

package/dist/core/memory/tree.js

@@ -1 +0,0 @@
-var g=Object.defineProperty;var s=(e,n)=>g(e,"name",{value:n,configurable:!0});import{canonicalSegments as a,normalizeNameSegment as y}from"./identity.js";function w(e){const n=a(e.name),o=a(e.physicalRelativePath.replace(/\.md$/i,""));e.representation==="directory-index"&&o.pop();const i=[];for(let c=n.length-1,r=o.length-1;c>=0&&r>=0;c--,r--){const t=o[r];if(y(t)!==n[c])break;i.push([n.slice(0,c+1).join("/"),t])}return i}s(w,"physicalOrderSegments");function f(e){return e.childDirectories.length>0||e.childDocuments.length>0}s(f,"hasMembers");function D(e,n){return e.order.localeCompare(n.order)||e.name.localeCompare(n.name)}s(D,"compareNodes");function M(e){if(e.document===null)throw new Error(`memory tree: ${e.name} has neither a document nor members`);return e}s(M,"asDocumentNode");function p(e,n,o){const i=[...e.children.values()].map(t=>p(t,n,o)).sort(D),c=a(e.name),r={name:e.name,order:n.get(e.name)??c[c.length-1]??"",document:e.documents[0]??null,documentCandidates:e.documents,childDirectories:i.filter(f),childDocuments:i.filter(t=>!f(t)).map(M)};return o.set(r.name,r),r}s(p,"finalize");function b(e){const n={name:"",documents:[],children:new Map},o=new Map;for(const t of e){const l=a(t.name);if(l.length===0)continue;let u=n;for(let m=0;m<l.length;m++){const d=l[m];let h=u.children.get(d);h===void 0&&(h={name:l.slice(0,m+1).join("/"),documents:[],children:new Map},u.children.set(d,h)),u=h}u.documents.push(t);for(const[m,d]of w(t))o.has(m)||o.set(m,d)}const i=new Map,c=p(n,o,i),r=s(t=>i.get(a(t).join("/"))??null,"lookup");return{root:c,node:r,isDirectory:s(t=>{const l=r(t);return l!==null&&f(l)},"isDirectory")}}s(b,"buildMemoryTree");export{b as buildMemoryTree};

package/dist/core/memory-resolver.d.ts

@@ -1,280 +0,0 @@
-import { type InstalledPlugin, type Scope } from '../types.js';
-import type { ProfileProjectMemory } from '../api/dto/profiles.js';
-import { type DocRepresentation } from './memory/identity.js';
-/**
- * Memory-document loading and resolution for the document substrate.
- *
- * Every document belongs to exactly one physical STORE. A store declares a
- * namespace — a project's `namespace:` on its root `INDEX.md`, an installed
- * plugin's mount prefix, or empty for user/profile/node/builtin — and every
- * document's CANONICAL name is that namespace composed with the document's
- * store-local name (see memory/identity.ts). The canonical name is the only
- * address: resolution compares the normalized query with canonical identities
- * and nothing else. There is no physical-path pass, no bare-leaf pass, no
- * scope-prefixed spelling, and no `<dir>/INDEX` address — a trailing `INDEX`
- * segment collapses, so a directory's own document answers at the directory
- * name and `memory find` is the discovery surface when the name is unknown.
- *
- * A project store whose repository root carries no valid `namespace:` does not mount: its
- * documents are absent from every target view, and its descriptor carries the
- * `crtr sys migrate --dir <repository root>` remedy. Exact-store inspection
- * (`openProjectMemoryStore` + `loadMemoryStoreView`) still loads it, which is
- * what lint and migration diagnose an unmounted store through.
- *
- * Two views exist over the same loader:
- *   - a TARGET view — the ordered source stack of one cwd/profile/node
- *     (node > project stores nearest-first > profile > user > builtin, native
- *     documents before enabled-plugin documents within each source). Alternate
- *     physical stores legitimately expose the same canonical identity (a linked
- *     worktree, a generated copy), so a name yields an ordered CANDIDATE set:
- *     source order picks the address winner, every later candidate stays
- *     inspectable.
- *   - an exact STORE view — one physical project store selected by owner
- *     directory, which still requires the full canonical query.
- *
- * Resolution never consults a project store's profile memory ceiling
- * (`projectMemory`); the full corpus resolves and lists regardless, and only
- * automatic delivery clamps against it.
- */
-/** The memory-only scope union: the global `Scope` (`user|project|builtin`)
- *  plus `profile` and `node`. Confined to the memory resolver/list/read/write/
- *  render paths — deliberately NOT folded into the global `Scope` union, because
- *  that would leak these into config, plugin, marketplace, and sys-config
- *  surfaces the spec does not extend. `node` is the this-node store
- *  (`nodes/<id>/context/memory/`), available only inside a running node
- *  (`CRTR_NODE_ID`), and it is the NEAREST scope — a node doc overrides a
- *  same-named doc at any wider scope. */
-export type MemoryScope = Scope | 'profile' | 'node';
-/** Whether a store contributes to target views.
- *  `absent` — no `memory/` dir on disk (silent, the ordinary case).
- *  `undeclared`/`invalid` — a project store the runtime refuses to mount until
- *  its namespace is declared; `diagnostic` carries the migration remedy. */
-export type MemoryStoreMountStatus = 'ready' | 'absent' | 'undeclared' | 'invalid';
-/** One physical memory store: where its documents live, what namespace their
- *  canonical names compose under, and whether it mounts. */
-export interface MemoryStoreDescriptor {
-    scope: MemoryScope;
-    /** App holding a profile store; absent for legacy local profiles. */
-    ownerApp?: string;
-    profileId?: string;
-    /** Absolute path of the physical `memory/` dir. Store identity (and the
-     *  dedup of one real store reached twice) uses its realpath. */
-    storeRoot: string;
-    /** The project directory containing `.crouter/`, for project stores only. */
-    ownerDir?: string;
-    /** Effective project prefix, repository-root namespace composed with the
-     *  owner-relative path; installed-plugin mount prefix, or `''`. */
-    namespace: string;
-    /** The repository-root `INDEX.md` a project namespace is declared on, when
-     *  association succeeds — present even for an undeclared/invalid store so
-     *  lint and migration can point at it. */
-    namespacePath?: string;
-    /** Absolute realpath of the associated repository root, for project stores. */
-    repositoryRoot?: string;
-    /** Linked-worktree/non-Git grouping key, for project stores. */
-    repositoryKey?: string;
-    /** Valid namespace read from the repository-root declaration. */
-    repositoryNamespace?: string;
-    /** Canonical owner path relative to the repository root, empty at the root. */
-    ownerRelativePath?: string;
-    /** Structured cause for a project store that does not mount. */
-    mountFailure?: 'association' | 'collision' | 'undeclared-root' | 'invalid-root' | 'symlink';
-    /** The owning plugin's name for a plugin-mounted store. Plugin docs surface
-     *  within a source scope but live under the plugins dir and are managed by
-     *  `crtr pkg`, so consumers that mutate the store gate on this. */
-    plugin?: string;
-    mountStatus: MemoryStoreMountStatus;
-    /** Why a non-`ready` store does not mount, with its actionable remedy. */
-    diagnostic?: string;
-    /** The selected profile relationship's ceiling for this store: the maximum
-     *  rung AUTOMATIC boot and workspace-open delivery may disclose it at.
-     *  Neutral (`content`) for every non-project store. */
-    projectMemory: ProfileProjectMemory;
-}
-export interface MemoryDoc {
-    /** Canonical identity — the store's namespace composed with `localName`, and
-     *  the only address resolution accepts. */
-    name: string;
-    /** Store-local identity: the explicit frontmatter `name` when present, else
-     *  derived from the store-relative path with ordering prefixes stripped and
-     *  one trailing `INDEX` collapsed. Empty for a store's root document. */
-    localName: string;
-    scope: MemoryScope;
-    /** Absolute path to the resolved .md file. */
-    path: string;
-    /** Absolute path of the `memory/` dir this doc loaded from — the store root
-     *  its physical path is relative to. Sidecar trees that mirror the doc tree
-     *  (the revision-history log) are derived from `path` relative to this. */
-    root: string;
-    /** Store-relative markdown path, kept exactly: placement, ordering, origin,
-     *  and history depend on the physical form, never on segment counts of the
-     *  canonical name. */
-    physicalRelativePath: string;
-    /** Which physical form owns this identity — `foo.md` or `foo/INDEX.md`. */
-    representation: DocRepresentation;
-    /** The canonical directory this doc's `./` memory-read entries match against:
-     *  its own name for a directory document, its parent for a leaf. */
-    routingAnchor: string;
-    store: MemoryStoreDescriptor;
-    /** Raw, uncoerced frontmatter record (null when the doc has no frontmatter). */
-    frontmatter: Record<string, unknown> | null;
-    /** Document body, with the frontmatter block stripped. */
-    body: string;
-    plugin?: string;
-    projectMemory: ProfileProjectMemory;
-}
-/** Every physical document sharing one canonical identity in a view, in source
- *  order. `winner` is the address a deliberate read resolves to; automatic
- *  delivery filters the ordered candidates for its own event eligibility. */
-export interface MemoryCandidateSet {
-    name: string;
-    winner: MemoryDoc;
-    candidates: readonly MemoryDoc[];
-}
-/** Restrict resolution to docs whose resolved kind matches. Threaded INTO
- *  candidate selection, not applied as a post-filter: a wrong-kind candidate is
- *  skipped so a nearer one cannot shadow a farther matching-kind document into
- *  a false not_found. */
-export interface MemoryCandidateOpts {
-    kind?: string;
-}
-export interface MemoryResolutionOpts extends MemoryCandidateOpts {
-    /** Restrict resolution to a single scope. Narrows the source stack only — the
-     *  query is still the full canonical name. */
-    scope?: MemoryScope;
-    /** Also consult `.crouter/memory` stores discovered BELOW the mounted
-     *  project roots (bounded discovery — see nested-stores.ts). Opt-in for the
-     *  addressing surfaces (`memory read/list/find/lint/delete/origin`); OFF for
-     *  boot render, on-read resolvedDocs, the slash-command snapshot, and
-     *  persona resolution, which stay on the flat ancestor+profile stack. */
-    includeDescendants?: boolean;
-    /** Report when bounded descendant discovery omits an owner. Defaults to the inverse of `quiet`, so callers can preserve quiet malformed-document handling while still making an incomplete corpus visible to their caller. */
-    reportDiscovery?: boolean;
-}
-/** A loaded corpus and the exact-identity queries over it. */
-export interface MemoryView {
-    /** Every store the view discovered, mounted or not, in precedence order. */
-    stores: readonly MemoryStoreDescriptor[];
-    /** Every document of every MOUNTED store, in source order — candidates
-     *  included, so a first-wins dedup by name yields the winners. */
-    docs: readonly MemoryDoc[];
-    /** The ordered candidate set for one exact canonical name, or null. */
-    candidates(name: string, opts?: MemoryCandidateOpts): MemoryCandidateSet | null;
-    /** One entry per canonical identity, sorted by name. */
-    candidateSets(opts?: MemoryCandidateOpts): MemoryCandidateSet[];
-    /** The address winner for one exact canonical name; throws not_found. */
-    resolve(name: string, opts?: MemoryCandidateOpts): MemoryDoc;
-}
-export interface MemoryTargetView extends MemoryView {
-    target: MemoryTarget;
-}
-export interface MemoryStoreView extends MemoryView {
-    store: MemoryStoreDescriptor;
-}
-/** Whose memory view is being resolved: the workspace dir, profile, and node
- *  id that decide which stores exist and in what order. Ambient resolution
- *  builds this from the process (`process.cwd()`, `CRTR_PROFILE_ID`,
- *  `CRTR_NODE_ID`); a TARGET-ADDRESSED caller passes another node's, which is
- *  what one process serving several nodes needs — crtrd resolving a link on
- *  behalf of a node, or a warm-spare claim building a node's first-message
- *  context. The same name can name different documents for different nodes, so
- *  every scope in the chain (node-local, project stack, profile, user, builtin)
- *  reads from the target rather than the host process. */
-export interface MemoryTarget {
-    /** The workspace dir the project-scope stack walks up from. */
-    cwd: string;
-    /** The selected profile id, or null when none. */
-    profileId: string | null;
-    /** The node whose `nodes/<id>/context/memory/` store is the nearest scope,
-     *  or null outside a node. */
-    nodeId: string | null;
-    /** App assignment from the selected node's row when outside its broker. */
-    grantee?: string;
-    /** Daemon authorization applied before exposing any candidate or store. */
-    allowsStore?: (store: MemoryStoreDescriptor, name?: string) => boolean;
-    /** Project roots whose repository is readable in the run's mount set. */
-    allowsProject?: (repositoryRoot: string) => boolean;
-}
-/** The target the ambient process describes: cwd + the two env seams every
- *  profile/node-aware memory path reads through (`CRTR_PROFILE_ID`,
- *  `CRTR_NODE_ID`). */
-export declare function ambientMemoryTarget(): MemoryTarget;
-/** The exact project store owned by `ownerDir` — the `--dir` selector's store,
- *  loaded whatever its mount status so lint and migration can inspect a store
- *  the runtime refuses to mount. */
-export declare function openProjectMemoryStore(ownerDir: string): MemoryStoreDescriptor;
-/** Every store a target sees, in precedence order: node, each project store
- *  nearest-first (its enabled plugins after it), then profile, user, builtin.
- *  One real store reached twice contributes once, at its first position. */
-export declare function memoryStoresInPrecedence(target: MemoryTarget, scope?: MemoryScope, includeDescendants?: boolean, reportDiscovery?: boolean): MemoryStoreDescriptor[];
-/** The native (non-plugin) MOUNTED store dirs in resolution precedence.
- *  Addresses a store directly when the document itself may be absent, which is
- *  how a DELETED doc's revision log is still found: history outlives the doc,
- *  so its lookup cannot go through document resolution. */
-export declare function nativeMemoryStoresInPrecedence(scope?: MemoryScope, includeDescendants?: boolean): {
-    scope: MemoryScope;
-    memoryDir: string;
-    store: MemoryStoreDescriptor;
-}[];
-/** Every document in one store, sorted by canonical identity. SKILL.md bundles
- *  are Agent Skills, not memory docs. Enumeration stops at a nested `.crouter/`:
- *  that is another store's mount point, never this store's content. */
-export declare function loadStoreMemoryDocs(store: MemoryStoreDescriptor, quiet?: boolean): MemoryDoc[];
-/** All of one plugin's substrate docs, mounted under the plugin's own name:
- *  each doc's store-local name (explicit or path-derived) composes under that
- *  mount prefix. */
-export declare function listPluginMemoryDocs(plugin: InstalledPlugin, scope: MemoryScope, quiet?: boolean, projectMemory?: ProfileProjectMemory): MemoryDoc[];
-/** Load one target's whole corpus: every mounted store's documents in source
- *  order. A project store that does not mount is reported once (unless quiet)
- *  with its migration remedy and contributes nothing. */
-export declare function loadMemoryTargetView(target: MemoryTarget, opts?: MemoryResolutionOpts & {
-    quiet?: boolean;
-}): MemoryTargetView;
-/** Load ONE exact physical store. An undeclared/invalid project store loads
- *  under the empty namespace so lint and migration can inspect what it holds;
- *  no target view ever sees those documents. */
-export declare function loadMemoryStoreView(store: MemoryStoreDescriptor, quiet?: boolean, target?: MemoryTarget): MemoryStoreView;
-/** All project-scoped docs visible from an explicit node workspace/profile — the
- *  project-only slice of a `MemoryTarget` view, used where only workspace docs
- *  are wanted (a workspace-open render). For a full-precedence target-addressed
- *  lookup, use `resolveMemoryDocForTarget`. */
-export declare function listProjectMemoryDocs(startDir?: string, profileId?: string | null, quiet?: boolean): MemoryDoc[];
-/** All memory docs across the resolved sources, in precedence order: each
- *  ancestor project `.crouter/` from nearest to farthest, then the selected
- *  profile's memory (if any), then user, then builtin. Within each source,
- *  native docs are emitted before enabled-plugin docs, and equal-canonical
- *  candidates stay in source order, so a caller's first-wins dedup yields the
- *  address winners. */
-export declare function listAllMemoryDocs(scope?: MemoryScope, quiet?: boolean, includeDescendants?: boolean): MemoryDoc[];
-export interface MemoryDocSnapshot {
-    /** Every document in default scope precedence order, loaded once. */
-    docs: readonly MemoryDoc[];
-    /** Resolve names against that source snapshot; failures are omitted so
-     * callers can retain their own per-document error behavior. */
-    resolve(names: readonly string[]): Map<string, MemoryDoc>;
-}
-export declare function createMemoryDocSnapshot(target?: MemoryTarget): MemoryDocSnapshot;
-/** Resolve several canonical names over one memory-source snapshot. Failed
- * names are omitted so callers can preserve their per-document error behavior. */
-export declare function resolveMemoryDocs(names: readonly string[]): Map<string, MemoryDoc>;
-/** The address winner for an exact canonical name in the ambient target. */
-export declare function resolveMemoryDoc(rawName: string, opts?: MemoryResolutionOpts): MemoryDoc;
-/** Resolve a memory document as ANOTHER node would see it — the same precedence
- *  chain (node-local > project stack > profile > user > builtin), read from the
- *  target's cwd/profile/node rather than the host process's. This is what crtrd
- *  resolves a `[[name]]` link through: the daemon's own cwd and env name no
- *  node, and the same name can be a different document for two nodes. */
-export declare function resolveMemoryDocForTarget(rawName: string, target: MemoryTarget, opts?: MemoryResolutionOpts): MemoryDoc;
-/** Every physical candidate for an exact canonical name in the ambient target,
- *  in source order — what path-aware inventory, diagnostics, and automatic
- *  event eligibility consume instead of the winner alone. */
-export declare function resolveMemoryCandidates(rawName: string, opts?: MemoryResolutionOpts): MemoryCandidateSet;
-export declare function resolveMemoryCandidatesForTarget(rawName: string, target: MemoryTarget, opts?: MemoryResolutionOpts): MemoryCandidateSet;
-/** The address winner for an exact canonical name inside ONE project store —
- *  the `--dir` selector's resolution. The query is still the full canonical
- *  name, including that store's namespace. */
-export declare function resolveMemoryDocInStore(rawName: string, store: MemoryStoreDescriptor, opts?: MemoryCandidateOpts): MemoryDoc;
-/** Resolve PHYSICAL path segments against a `.history` tree, which mirrors the
- *  doc tree segment for segment with `.jsonl` in place of `.md`. A log outlives
- *  its document, so this lookup cannot go through document resolution. */
-export declare function resolveHistoryLogPath(historyDir: string, segments: string[]): string | null;

package/dist/core/memory-resolver.js

@@ -1,2 +0,0 @@
-var W=Object.defineProperty;var c=(e,o)=>W(e,"name",{value:o,configurable:!0});import{envGrantee as G,envNodeId as V,envProfileId as H}from"../shared/env.js";import{dirname as x,join as y,relative as J,sep as Q}from"node:path";import{readdirSync as U}from"node:fs";import{CRTR_DIR_NAME as F}from"../types.js";import{realpathOrSelf as $}from"./fs-utils.js";import{existsBeneath as X,isBeneathRefusal as Y,readFileBeneath as Z,readTextBeneathIfExists as ee,walkFilesBeneath as oe}from"./spaces/open-beneath.js";import{parseFrontmatterGeneric as k}from"./frontmatter.js";import{listInstalledPlugins as ne,listInstalledPluginsInRoot as te}from"./resolver.js";import{notFound as re,usage as N}from"./errors.js";import{warn as j}from"./output.js";import{NEUTRAL_PROJECT_MEMORY as h,pluginMemoryDir as ie,projectScopeRoots as ae,projectScopeRootsWithMemory as se,scopeMemoryDir as ce}from"./scope.js";import{effectiveDocKind as b}from"./substrate/schema.js";import{INDEX_SEGMENT as w,canonicalSegments as E,composeCanonicalName as T,localNameFromPath as ue,normalizeNameSegment as C,representationForPath as le,resolveLocalName as me,routingAnchorFor as de,validateNamespace as fe}from"./memory/identity.js";import{loadProfileManifest as A,profileMemoryDir as pe}from"./profiles/manifest.js";import{memoryDir as ye}from"./runtime/memory.js";import{descendantStoreRoots as he}from"./nested-stores.js";import{associateRepository as ge}from"./memory/repository-association.js";import{appSpace as we}from"./layout.js";function g(){return{cwd:process.cwd(),profileId:H()||null,nodeId:V()||null,grantee:G()||void 0}}c(g,"ambientMemoryTarget");function ve(){return g().profileId??""}c(ve,"selectedProfileId");function Se(e,o){if(o)return[o];const n=[];return e.nodeId&&n.push("node"),ae(e.cwd,e.profileId).length>0&&n.push("project"),e.profileId&&n.push("profile"),n.push("user"),n.push("builtin"),n}c(Se,"scopesInPrecedence");function L(e,o,n){const t={scope:"project",storeRoot:o,ownerDir:e,projectMemory:n},r=R(o);if(r.mountStatus!=="ready")return{...t,namespace:"",...r};const i=ge(e);if(!i.ok){const p=`run \`crtr sys migrate --dir ${e}\``;return i.code==="no-project-root"?{...t,namespace:"",mountStatus:"undeclared",mountFailure:"association",diagnostic:`project memory store at ${o} has no repository root declaring \`namespace:\` \u2014 ${p}`}:{...t,namespace:"",mountStatus:"invalid",mountFailure:"association",diagnostic:`project memory store at ${o} cannot be associated: ${i.reason} \u2014 ${p}`}}const{association:s}=i,u={namespacePath:s.declarationPath,repositoryRoot:s.repositoryRoot,repositoryKey:s.repositoryKey,ownerRelativePath:s.ownerRelativePath},m=s.declarationPath,a=s.ownerRelativePath!=="",l=`run \`crtr sys migrate --dir ${s.repositoryRoot}\``,f=a?`nested project memory store at ${o} takes its identity from ${m}, which is missing root ${w}.md declaring \`namespace:\` \u2014 ${l}`:`project memory store has no root ${w}.md declaring \`namespace:\` \u2014 ${l}`;let d;try{const p=ee(x(m),m);if(p===null)return{...t,...u,namespace:"",mountStatus:"undeclared",mountFailure:"undeclared-root",diagnostic:f};d=k(p).data?.namespace}catch(p){return{...t,...u,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store's ${m} does not parse (${z(p)}) \u2014 ${l}`}}if(d==null||d===""){const p=a?`nested project memory store at ${o} takes its identity from ${m}, which declares no \`namespace:\` \u2014 ${l}`:`project memory store's ${m} declares no \`namespace:\` \u2014 ${l}`;return{...t,...u,namespace:"",mountStatus:"undeclared",mountFailure:"undeclared-root",diagnostic:p}}if(typeof d!="string")return{...t,...u,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store declares a non-string \`namespace:\` (${JSON.stringify(d)}) \u2014 quote it in ${m}, or ${l}`};const v=fe(d);return v.ok?{...t,...u,repositoryNamespace:d,namespace:T(d,s.ownerRelativePath),mountStatus:"ready"}:{...t,...u,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store declares an invalid namespace \`${d}\` (${v.reason}) \u2014 ${l}`}}c(L,"projectStoreDescriptor");function R(e){try{return{mountStatus:X(e,e)?"ready":"absent"}}catch(o){if(!Y(o))throw o;return{mountStatus:"invalid",mountFailure:"symlink",diagnostic:`memory store at ${e} is reached through a symlink, which never mounts`}}}c(R,"storeRootMount");function M(e,o){return o===null?{scope:e,storeRoot:"",namespace:"",mountStatus:"absent",projectMemory:h}:{scope:e,storeRoot:o,namespace:"",...R(o),projectMemory:h}}c(M,"plainStoreDescriptor");function I(e,o,n){const t=$(ie(e));return{scope:o,storeRoot:t,namespace:e.name,plugin:e.name,...R(t),projectMemory:n}}c(I,"pluginStoreDescriptor");function Ve(e){const o=$(e);return L(o,y(o,F,"memory"),h)}c(Ve,"openProjectMemoryStore");function q(e,o,n=!1,t=!0){const r=[],i=c((a,l)=>{r.push(L(x(a),y(a,"memory"),l));for(const f of te("project",a).filter(d=>d.enabled))r.push(I(f,"project",l))},"projectStores");for(const a of Se(e,o))if(a==="project"){const l=se(e.cwd,e.profileId);for(const{root:f,memory:d}of l)i(f,d);if(n)for(const f of he(l.map(({root:d})=>d),t))i(f,h)}else if(a==="profile"){const l=e.profileId??"";if(l!=="")try{const{profileId:f}=A(l),{manifest:d}=A(f),v=d.grantee?.startsWith("app:")?y(we(d.grantee).memory,"profiles",f):pe(f);r.push({...M("profile",v),profileId:f,ownerApp:d.grantee})}catch{}}else if(a==="node"){const l=e.nodeId??"";l!==""&&r.push({...M("node",ye(l,e.grantee)),ownerApp:e.grantee})}else{r.push(M(a,ce(a)));for(const l of ne(a).filter(f=>f.enabled))r.push(I(l,a,h))}const s=new Set,u=r.filter(a=>{if(a.storeRoot==="")return!1;const l=$(a.storeRoot);return s.has(l)?!1:(s.add(l),!0)}),m=new Map;for(const a of u){if(a.scope!=="project"||a.mountStatus!=="ready"||a.repositoryRoot===void 0||a.ownerRelativePath===void 0)continue;const l=`${a.repositoryRoot}\0${a.ownerRelativePath}`,f=m.get(l);f?f.push(a):m.set(l,[a])}return u.filter(a=>(a.scope!=="project"||a.repositoryRoot===void 0||e.allowsProject?.(a.repositoryRoot)!==!1)&&e.allowsStore?.(a)!==!1).map(a=>{if(a.scope!=="project"||a.mountStatus!=="ready"||a.repositoryRoot===void 0||a.ownerRelativePath===void 0)return a;const l=m.get(`${a.repositoryRoot}\0${a.ownerRelativePath}`);if(l===void 0||l.length<2)return a;const f=l.map(d=>d.ownerDir??d.storeRoot).join(", ");return{...a,mountStatus:"invalid",mountFailure:"collision",diagnostic:`project memory stores at ${f} normalize to the same effective prefix \`${a.namespace}\` \u2014 rename one owner directory`}})}c(q,"memoryStoresInPrecedence");function He(e,o=!1){return q(g(),e,o).filter(n=>n.mountStatus==="ready"&&n.scope!=="builtin"&&n.plugin===void 0).map(n=>({scope:n.scope,memoryDir:n.storeRoot,store:n}))}c(He,"nativeMemoryStoresInPrecedence");function z(e){return(e instanceof Error?e.message:String(e)).split(`
-`)[0]??""}c(z,"firstLine");function $e(e,o,n){const{data:t,body:r}=k(Z(e.storeRoot,o).toString("utf8")),i=ue(n),s=le(n),u=i===""?"":me(t,i),m=T(e.namespace,u);return m===""?null:{name:m,localName:u,scope:e.scope,path:o,root:e.storeRoot,physicalRelativePath:n,representation:s,routingAnchor:de(m,s),store:e,frontmatter:t,body:r,projectMemory:e.projectMemory,...e.plugin===void 0?{}:{plugin:e.plugin}}}c($e,"loadMemoryDoc");function je(e,o){const n=e.name.localeCompare(o.name);return n!==0?n:e.representation!==o.representation?e.representation==="directory-index"?-1:1:e.physicalRelativePath.localeCompare(o.physicalRelativePath)}c(je,"compareDocs");function P(e,o=!1){if(e.storeRoot===""||e.mountFailure==="symlink")return[];const n=[];for(const t of oe(e.storeRoot,e.storeRoot,r=>r.endsWith(".md")&&r!=="SKILL.md",r=>r===F)){const r=J(e.storeRoot,t).split(Q).join("/");try{const i=$e(e,t,r);if(i===null){o||j(`${t}: a root ${w}.md has no canonical name in a store without a namespace`);continue}n.push(i)}catch(i){o||j(`invalid frontmatter in ${t}: ${z(i)}`)}}return n.sort(je)}c(P,"loadStoreMemoryDocs");function Je(e,o,n=!1,t=h){return P(I(e,o,t),n)}c(Je,"listPluginMemoryDocs");function D(e){return E(e.trim()).join("/")}c(D,"normalizeQuery");function B(e,o,n){const t=E(o),r=t[t.length-1]===w;r&&t.pop();const i=t[t.length-1]??o,s=r?`A directory's own document answers at the directory name \u2014 drop the trailing /${w}. Run \`crtr memory find ${i}\` to find the canonical name.`:`Resolution takes the full canonical name (a project doc is <namespace>/<local name>). Run \`crtr memory find ${i}\` to find it.`;return re(`memory document not found: ${e}`,{memory:o,...n?{scope:n}:{},next:s})}c(B,"notFoundError");function _(e,o,n){const t=c((r,i)=>{const s=D(r);if(s==="")return null;const u=i?.kind,m=o.filter(a=>a.name===s&&(u===void 0||b(a)===u));return m.length===0?null:{name:s,winner:m[0],candidates:m}},"candidatesFor");return{stores:e,docs:o,candidates:t,candidateSets(r){const i=r?.kind,s=new Map;for(const u of o){if(i!==void 0&&b(u)!==i)continue;const m=s.get(u.name);m?m.push(u):s.set(u.name,[u])}return[...s.entries()].sort(([u],[m])=>u.localeCompare(m)).map(([u,m])=>({name:u,winner:m[0],candidates:m}))},resolve(r,i){const s=D(r);if(s==="")throw N("memory document name required");const u=t(s,i);if(u===null)throw B(r,s,n);return u.winner}}}c(_,"makeView");function S(e,o={}){const n=o.quiet??!1,t=q(e,o.scope,o.includeDescendants??!1,o.reportDiscovery??!n),r=[];for(const i of t)if(i.mountStatus!=="absent"){if(i.mountStatus!=="ready"){!n&&i.diagnostic!==void 0&&j(`memory store not mounted: ${i.diagnostic}`);continue}r.push(...P(i,n).filter(s=>e.allowsStore?.(i,s.name)!==!1))}return{target:e,..._(t,r,o.scope)}}c(S,"loadMemoryTargetView");function Re(e,o=!1,n){const t=P(e,o).filter(r=>n?.allowsStore?.(e,r.name)!==!1);return{store:e,..._([e],t)}}c(Re,"loadMemoryStoreView");function Qe(e=process.cwd(),o=ve()||null,n=!1){return[...S({cwd:e,profileId:o,nodeId:null},{scope:"project",quiet:n}).docs]}c(Qe,"listProjectMemoryDocs");function Ue(e,o=!1,n=!1){return[...S(g(),{...e?{scope:e}:{},quiet:o,includeDescendants:n}).docs]}c(Ue,"listAllMemoryDocs");function Me(e=g()){const o=S(e,{quiet:!0});return{docs:o.docs,resolve:c(n=>{const t=new Map;for(const r of n){const i=o.candidates(r);i!==null&&t.set(r,i.winner)}return t},"resolve")}}c(Me,"createMemoryDocSnapshot");function Xe(e){return Me().resolve(e)}c(Xe,"resolveMemoryDocs");function Ye(e,o={}){return Ie(e,g(),o)}c(Ye,"resolveMemoryDoc");function Ie(e,o,n={}){return K(e,o,n).winner}c(Ie,"resolveMemoryDocForTarget");function Ze(e,o={}){return K(e,g(),o)}c(Ze,"resolveMemoryCandidates");function K(e,o,n={}){const t=S(o,{...n,quiet:!0}),r=D(e);if(r==="")throw N("memory document name required");const i=t.candidates(r,n);if(i===null)throw B(e,r,n.scope);return i}c(K,"resolveMemoryCandidatesForTarget");function eo(e,o,n={}){return Re(o,!0).resolve(e,n)}c(eo,"resolveMemoryDocInStore");function O(e,o,n,t=".md"){let r;try{r=U(e,{withFileTypes:!0})}catch{return null}let i=null;for(const s of r)if(n==="dir"){if(!s.isDirectory())continue;if(s.name===o)return y(e,s.name);i===null&&C(s.name)===o&&(i=y(e,s.name))}else{if(!(s.isFile()&&s.name.endsWith(t)))continue;const u=s.name.slice(0,-t.length);if(u===o)return y(e,s.name);i===null&&C(u)===o&&(i=y(e,s.name))}return i}c(O,"matchNormalizedChild");function Pe(e,o,n){let t=e;for(let r=0;r<o.length-1;r++){const i=O(t,o[r],"dir",n);if(!i)return null;t=i}return O(t,o[o.length-1],"file",n)}c(Pe,"resolveNormalizedFile");function oo(e,o){return o.length===0?null:Pe(e,o,".jsonl")}c(oo,"resolveHistoryLogPath");export{g as ambientMemoryTarget,Me as createMemoryDocSnapshot,Ue as listAllMemoryDocs,Je as listPluginMemoryDocs,Qe as listProjectMemoryDocs,Re as loadMemoryStoreView,S as loadMemoryTargetView,P as loadStoreMemoryDocs,q as memoryStoresInPrecedence,He as nativeMemoryStoresInPrecedence,Ve as openProjectMemoryStore,oo as resolveHistoryLogPath,Ze as resolveMemoryCandidates,K as resolveMemoryCandidatesForTarget,Ye as resolveMemoryDoc,Ie as resolveMemoryDocForTarget,eo as resolveMemoryDocInStore,Xe as resolveMemoryDocs};

package/dist/core/nested-stores.d.ts

@@ -1,18 +0,0 @@
-export declare function descendantStoreDiscoveryWarnings(ancestorRoots: string[]): string[];
-/**
- * Every `.crouter` store root strictly BELOW the given ancestor roots' owning
- * dirs, in owner order then discovery order. Takes the `projectScopeRoots()`
- * entries themselves (`.crouter` dir paths) and derives owner dirs internally.
- *
- * Any discovered root whose realpath matches an INPUT root is excluded here,
- * inside the function: a profile can manage both `/a` and `/a/b`, making
- * `/a/b/.crouter` simultaneously an ancestor root and a descendant of `/a` —
- * excluding centrally gives the resolver and lint the identical call with no
- * duplicated dedupe logic.
- */
-export declare function descendantStoreRoots(ancestorRoots: string[], reportBudgetExceeded?: boolean, warnings?: string[]): string[];
-/** Complete descendant-store discovery for state migrations. Unlike the
- *  interactive addressing lane, this filesystem walk has no time or depth
- *  budget, crosses embedded repositories, admits plugin-only `.crouter` roots,
- *  and does not cache. */
-export declare function descendantStoreRootsExhaustive(ancestorRoots: string[]): string[];

package/dist/core/nested-stores.js

@@ -1 +0,0 @@
-var D=Object.defineProperty;var a=(t,r)=>D(t,"name",{value:r,configurable:!0});import{readdirSync as E}from"node:fs";import{dirname as x,join as f,sep as R}from"node:path";import{CRTR_DIR_NAME as l}from"../types.js";import{pathExists as p,realpathOrSelf as m}from"./fs-utils.js";import{gitSync as _}from"./git.js";import{warn as v}from"./output.js";const O=new Set(["node_modules",".git","dist","build",".next",".cache",".yalc",".venv"]),T=6,h=500;function C(t){const r=[];return b(t,!1,r),r}a(C,"descendantStoreDiscoveryWarnings");function b(t,r=!0,o=[]){const i=new Set(t.map(s=>m(s))),c=[],d=new Set;for(const s of t){const u=x(s),y=m(u);d.has(y)||(d.add(y),c.push(u))}const e=a(s=>{const u=`memory: nested-store discovery under ${s} exceeded its ${h}ms budget \u2014 this result may omit nested stores. To read a document from a known nested store, pass its owner as \`--dir <owner>\`; that exact-store read bypasses discovery.`;o.push(u),r&&v(u)},"tripBudget"),n=[],w=new Set,S=a(s=>{const u=m(s);w.has(u)||i.has(u)||(w.add(u),n.push(s))},"add");for(const s of c)p(f(s,".git"))?k(s,S,h,()=>e(s)):M(s,S,Date.now()+h,()=>e(s));return n}a(b,"descendantStoreRoots");function k(t,r,o,i){const c=`/${l}/memory/`,d=_(["-C",t,"ls-files","-z","-co","--exclude-standard","--",`*/${l}/memory/*`],void 0,void 0,{timeoutMs:o});if(d.timedOut===!0){i();return}if(d.status===0)for(const e of d.stdout.split("\0")){if(e==="")continue;const n=e.indexOf(c);n<=0||r(f(t,e.slice(0,n).split("/").join(R),l))}}a(k,"collectGitStores");function M(t,r,o,i){g(t,r,{deadline:o,maxDepth:T,trip:i})}a(M,"collectWalkStores");function g(t,r,o={}){const i=[{dir:t,depth:0}];for(;i.length>0;){if(o.deadline!==void 0&&Date.now()>o.deadline){o.trip?.();return}const{dir:c,depth:d}=i.pop();if(c!==t){if(o.crossEmbeddedRepos!==!0&&p(f(c,".git")))continue;const n=f(c,l);p(o.includePluginOnly===!0?n:f(n,"memory"))&&r(n)}if(o.maxDepth!==void 0&&d>=o.maxDepth)continue;let e;try{e=E(c,{withFileTypes:!0})}catch{continue}for(const n of e)n.isDirectory()&&(O.has(n.name)||n.name===l||i.push({dir:f(c,n.name),depth:d+1}))}}a(g,"collectWalkStoresFromOwner");function F(t){const r=new Set(t.map(e=>m(e))),o=[],i=new Set,c=a(e=>{const n=m(e);i.has(n)||r.has(n)||(i.add(n),o.push(e))},"add"),d=new Set(t.map(e=>m(x(e))));for(const e of d)g(e,c,{includePluginOnly:!0,crossEmbeddedRepos:!0});return o}a(F,"descendantStoreRootsExhaustive");export{C as descendantStoreDiscoveryWarnings,b as descendantStoreRoots,F as descendantStoreRootsExhaustive};

package/dist/core/runtime/memory.d.ts

@@ -1,3 +0,0 @@
-/** The node-local memory directory in a node's context dir — holds substrate
- *  docs (.md files with kind/when/why frontmatter). */
-export declare function memoryDir(nodeId: string, grantee?: string): string;

package/dist/core/runtime/memory.js

@@ -1 +0,0 @@
-var e=Object.defineProperty;var m=(r,o)=>e(r,"name",{value:o,configurable:!0});import{join as p}from"node:path";import{appSpace as i}from"../layout.js";function a(r,o){if(!o)throw new Error(`memory store for ${r} requires an app`);return p(i(o).memory,"nodes",r)}m(a,"memoryDir");export{a as memoryDir};

package/dist/core/substrate/frontmatter-validation.d.ts

@@ -1,11 +0,0 @@
-import { type SurfaceEntry } from './schema.js';
-export declare const SUPPRESSIBLE_RULES: readonly string[];
-/** Strict validation of one raw routing entry. Runtime parsing deliberately
- * tolerates malformed docs; this authoring/preflight contract does not. */
-export declare function lintSubstrateSurfaces(value: unknown): string | null;
-/** Strict substrate frontmatter checker shared by lint and package preflight. */
-export declare function lintSubstrateFrontmatter(fm: Record<string, unknown> | null): string | null;
-/** Compatibility name for consumers that adopted lint's former export. */
-export declare const lintSubstrateSchema: typeof lintSubstrateFrontmatter;
-/** Parsed routing entries for checks that run after strict validation. */
-export declare function parsedSubstrateSurfaces(fm: Record<string, unknown>): SurfaceEntry[];

package/dist/core/substrate/frontmatter-validation.js

@@ -1 +0,0 @@
-var g=Object.defineProperty;var s=(e,n)=>g(e,"name",{value:n,configurable:!0});import{isDocKind as m,parseSubstrateFrontmatter as b,PRIVACY_LEVELS as y,SURFACE_EVENTS as f,SURFACE_RUNGS as h}from"./schema.js";const S=["system-prompt-visibility","file-read-visibility","applies-to","read-when"],v=["on","match","match-frontmatter","gate","at"],p=["length","broad-memory-read","orphan"];function $(e){if(e===void 0)return null;if(!Array.isArray(e))return`invalid surfaces: ${JSON.stringify(e)} (expected a list of {on, at, match?, match-frontmatter?, gate?} entries)`;for(const n of e){if(n===null||typeof n!="object"||Array.isArray(n))return`invalid surfaces entry: ${JSON.stringify(n)} (expected an {on, at, match?, match-frontmatter?, gate?} object)`;const r=n;for(const i of Object.keys(r))if(!v.includes(i))return`invalid surfaces entry: unknown key \`${i}\` (an entry carries only on, match, match-frontmatter, gate, at)`;const t=r.on;if(typeof t!="string"||!f.includes(t))return`invalid surfaces entry \`on\`: ${JSON.stringify(t)} (expected ${f.join("|")})`;const c=r.at;if(typeof c!="string"||!h.includes(c))return`invalid surfaces entry \`at\`: ${JSON.stringify(c)} (expected ${h.join("|")})`;let u=!1;if(r.match!==void 0){if(t==="boot"||t==="workspace-open")return`invalid surfaces entry: \`match\` is meaningless on \`${t}\` \u2014 the entry's presence is the match; drop it`;const i=r.match,d=typeof i=="string"?[i]:Array.isArray(i)&&i.every(l=>typeof l=="string")?i:null;if(d===null||d.length===0||d.some(l=>l.trim()===""))return`invalid surfaces entry \`match\`: ${JSON.stringify(i)} (expected a non-empty glob or non-empty glob list)`;u=!0}const a=r["match-frontmatter"];if(a!==void 0){if(t!=="read")return"invalid surfaces entry: `match-frontmatter` is a `read`-event predicate only";if(a===null||typeof a!="object"||Array.isArray(a))return`invalid surfaces entry \`match-frontmatter\`: ${JSON.stringify(a)} (expected a field\u2192matcher object)`}if((t==="read"||t==="memory-read"||t==="command"||t==="pre-command")&&!u&&a===void 0)return`invalid surfaces entry: a \`${t}\` entry requires \`match\`${t==="read"?" or `match-frontmatter`":""}`;const o=r.gate;if(o!==void 0&&(o===null||typeof o!="object"||Array.isArray(o)))return`invalid surfaces entry \`gate\`: ${JSON.stringify(o)} (expected a field\u2192matcher object)`}return null}s($,"lintSubstrateSurfaces");function w(e){if(e===null)return"missing frontmatter: a memory store doc requires `kind: knowledge|preference`";if(!m(e.kind))return`invalid kind: ${JSON.stringify(e.kind)} (expected knowledge|preference)`;if("when"in e||"why"in e)return'retired `when`/`why` keys: merge them into one `when-and-why-to-read` line \u2014 "When <circumstance>, this <kind> should be read because <broader downstream payoff>." WHY is the benefit unlocked by reading, not the document summary, rule, or obedience rationale.';if(typeof e["when-and-why-to-read"]!="string"||e["when-and-why-to-read"].trim()==="")return'missing `when-and-why-to-read`: one routing line \u2014 "When <circumstance>, this <kind> should be read because <broader downstream payoff>." WHY is the benefit unlocked by reading, not the document summary, rule, or obedience rationale.';for(const r of S)if(r in e)return`retired \`${r}\` key: the visibility axes were replaced by \`surfaces\` event routing \u2014 run \`crtr sys migrate\` to convert old-format docs, or author \`surfaces\` entries by hand (\`crtr memory write -h\`)`;if("privacy"in e&&!y.includes(e.privacy))return`invalid privacy: ${JSON.stringify(e.privacy)} (expected ${y.join("|")})`;if(e.unlisted!==void 0&&typeof e.unlisted!="boolean")return`invalid unlisted: ${JSON.stringify(e.unlisted)} (expected a boolean)`;const n=$(e.surfaces);if(n!==null)return n;if(e.gate!==void 0&&(e.gate===null||typeof e.gate!="object"||Array.isArray(e.gate)))return`invalid gate: ${JSON.stringify(e.gate)} (expected a field\u2192matcher object)`;if(e.slash!==void 0&&typeof e.slash!="boolean")return`invalid slash: ${JSON.stringify(e.slash)} (expected a boolean)`;if(e.rationale!==void 0&&typeof e.rationale!="string")return`invalid rationale: ${JSON.stringify(e.rationale)} (expected a string)`;if(e["lint-ignore"]!==void 0){const r=Array.isArray(e["lint-ignore"])?e["lint-ignore"]:[e["lint-ignore"]];if(r.length===0||!r.every(t=>typeof t=="string"&&p.includes(t)))return`invalid lint-ignore: ${JSON.stringify(e["lint-ignore"])} (suppressible rules: ${p.map(t=>`\`${t}\``).join(", ")})`}return null}s(w,"lintSubstrateFrontmatter");const k=w;function N(e){return b(e)?.surfaces??[]}s(N,"parsedSubstrateSurfaces");export{p as SUPPRESSIBLE_RULES,w as lintSubstrateFrontmatter,k as lintSubstrateSchema,$ as lintSubstrateSurfaces,N as parsedSubstrateSurfaces};

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

@@ -1,16 +0,0 @@
-import type { SubstrateDoc, SurfaceEntry } from './schema.js';
-import type { NodeConfigSubject } from './subject-fields.js';
-/** Does `doc` pass its gate for `subject`?
- *
- *  - No gate (field absent) ⇒ `true`: always eligible (the common case).
- *  - A gate present ⇒ the matcher engine's verdict. An empty `gate: {}` is inert
- *    and returns `false` (never matches) per design §4 — so an author cannot
- *    write an always-eligible-via-empty-predicate doc.
- *
- *  Eligibility only. A failing gate excludes the doc from BOTH automatic hooks
- *  for this node; it remains findable by `crtr memory find` (search ignores
- *  gate + rung). */
-export declare function gatePasses(doc: SubstrateDoc, subject: NodeConfigSubject): boolean;
-/** Does a surface entry participate for `subject`? A missing subject cannot
- * satisfy an entry gate; entries without one remain eligible. */
-export declare function surfaceEntryGatePasses(entry: Pick<SurfaceEntry, 'gate'>, subject: NodeConfigSubject | null): boolean;

package/dist/core/substrate/gate.js

@@ -1 +0,0 @@
-var a=Object.defineProperty;var n=(e,t)=>a(e,"name",{value:t,configurable:!0});import{evalCondition as r}from"../predicate.js";function f(e,t){return e.gate===void 0?!0:r(e.gate,t)}n(f,"gatePasses");function o(e,t){return e.gate===void 0||t!==null&&r(e.gate,t)}n(o,"surfaceEntryGatePasses");export{f as gatePasses,o as surfaceEntryGatePasses};

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

@@ -1,18 +0,0 @@
-export { KINDS, isDocKind, RUNGS, rungRank, rungAtLeast, SURFACE_EVENTS, SURFACE_RUNGS, parseSubstrateFrontmatter, parseSubstrateDoc, previewLine, normalizeNameSegment, normalizeDocName, resolveDocName, } from './schema.js';
-export type { DocKind, Rung, GatePredicate, SubstrateSchema, SubstrateDoc, SurfaceEntry, SurfaceEvent, SurfaceRung } from './schema.js';
-export { lintSubstrateFrontmatter, lintSubstrateSchema, lintSubstrateSurfaces, parsedSubstrateSurfaces } from './frontmatter-validation.js';
-export { matchesReadEntry, matchesMemoryReadEntry, matchesCommandEntry, readDeliveryRung, workspaceOpenRung, memoryReadDeliveryRung, commandDeliveryRung, matchingSurfaceEntry, surfaceEntryParticipates, owningRootOf, underOwningRoot } from './surface-match.js';
-export type { SurfaceMatchPayload } from './surface-match.js';
-export { planDelivery, bootPartitionOf } from './plan.js';
-export type { DeliveryPlan, DeliveryRecord, DeliveryPayload, EntryDecision, GateOutcome } from './plan.js';
-export { dirDedupKey, docsByName, isDirName, ancestorDirsOf, renderDirListing } from './listings.js';
-export { clearContextExposureState, cloneContextExposureState, cloneTranscriptExposureState, contentExposureIdentity, contextExposureStatesEqual, documentExposedAtOrAbove, emptyContextExposureState, exposedAtOrAbove, exposureTarget, freezePreferenceSnapshot, hasTranscriptExposure, initializeForkContextExposure, loadContextExposureState, mergeContextExposureState, registerDocumentExposure, registerExposure, replaceContextExposureState, saveContextExposureState, sharedContextExposureState, } from './injected-store.js';
-export type { ContextExposureState, ExposureSource, ExposureTarget } from './injected-store.js';
-export { scopeForCwd, profileNameFor } from './subject-fields.js';
-export type { NodeConfigSubject } from './subject-fields.js';
-export { spineDepth, assembleNodeSubject } from './subject.js';
-export { gatePasses } from './gate.js';
-export { renderPreferencesForSubject, renderKnowledgeForSubject } from './render.js';
-export { renderPreferencesSection, renderKnowledgeBlock } from './render-node.js';
-export { renderOnReadDocsForSubject, renderWorkspaceOpenDocsForSubject, renderOnCommandDocsForSubject, memoryReadDocBlocks } from './on-read.js';
-export { renderOnReadDocs, renderWorkspaceOpenDocs } from './on-read-node.js';