@north-light/crouter 0.3.352 → 0.3.354

package/dist/migrations/002-profile-project-memory.d.ts

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

package/dist/migrations/002-profile-project-memory.js

@@ -1 +0,0 @@
-var m=Object.defineProperty;var a=(r,o)=>m(r,"name",{value:o,configurable:!0});import{PROFILE_PROJECT_MEMORY_VALUES as p}from"../api/dto/profiles.js";import{usage as l}from"../core/errors.js";const y="root-00000000";function t(r,o){return l(`profile manifest cannot be migrated: ${o}`,{received:r.path,field:"projects",next:`Fix ${r.path} by hand \u2014 every project entry is a string (pre-migration) or {"path": "/abs/dir", "memory": one of ${p.join(", ")}} \u2014 then re-run \`crtr sys migrate\`.`})}a(t,"malformed");function h(r){return typeof r=="string"&&p.includes(r)}a(h,"isMemory");const u={id:"002-profile-project-memory",lane:"profile-manifest",description:"profile projects carry an explicit memory value",apply(r){const o=r.raw.projects;if(!Array.isArray(o))throw t(r,`projects is ${o===void 0?"missing":typeof o}, not an array`);const f=r.profileId===y?"preview":"content";let n=!1;const c=o.map(e=>{if(typeof e=="string"){if(e.trim()==="")throw t(r,"a project entry is an empty path");return n=!0,{path:e,memory:f}}if(typeof e!="object"||e===null||Array.isArray(e))throw t(r,`a project entry is ${e===null?"null":typeof e}`);const{path:i,memory:s}=e;if(typeof i!="string"||i.trim()==="")throw t(r,`a project entry has no path: ${JSON.stringify(e)}`);if(!h(s))throw t(r,`project ${i} has an unknown memory value: ${JSON.stringify(s)}`);return e});return n?{...r.raw,projects:c}:null}};export{u as profileProjectMemoryMigration};

package/dist/migrations/003-repository-root-memory-identity/front-door.d.ts

@@ -1,26 +0,0 @@
-import type { CorpusBlocker, CorpusSnapshot, FrontDoorAction } from '../types.js';
-import type { RepositoryDecision, StorePrefixFacts } from './repository-facts.js';
-export interface FrontDoorPlan {
-    repositoryRoot: string;
-    /** The repository-root store's key. */
-    storeKey: string;
-    rootDocPath: string;
-    rootAction: 'kept' | 'created' | 'completed';
-    /** The unique legacy front door whose workspace-open entries this run removes. It may live
-     *  in a nested store of the same repository, so it carries its own store key. */
-    leafDocPath: string | null;
-    leafStoreKey: string | null;
-    /** The leaf's FINAL canonical name, for the created root body's `[[link]]`. */
-    leafCanonicalName: string | null;
-    action: FrontDoorAction;
-}
-export declare function planFrontDoors(repositories: readonly RepositoryDecision[], prefixes: ReadonlyMap<string, StorePrefixFacts>, corpus: CorpusSnapshot, finalNameOf: (realPath: string) => string | undefined): {
-    plans: FrontDoorPlan[];
-    blockers: CorpusBlocker[];
-};
-/** New repository-root INDEX.md source. `leafCanonicalName` null yields the generic minimal root body. */
-export declare function rootIndexSource(namespace: string, leafCanonicalName: string | null): string;
-/** Add the missing half or halves of the root front-door pair to a complete document source. */
-export declare function completeRootFrontDoor(source: string, docPath: string): string;
-/** Remove every workspace-open entry while preserving the body and every retained authored YAML byte. */
-export declare function demoteLeafSurfaces(source: string, docPath: string): string;

package/dist/migrations/003-repository-root-memory-identity/front-door.js

@@ -1,11 +0,0 @@
-var q=Object.defineProperty;var r=(o,e)=>q(o,"name",{value:e,configurable:!0});import{join as v,relative as B}from"node:path";import{parse as M,stringify as G}from"yaml";import{realpathOrSelf as O}from"../../core/fs-utils.js";import{parseFrontmatterGeneric as W}from"../../core/frontmatter.js";import{localNameFromPath as J}from"../../core/memory/identity.js";import{appendRenderedKey as X,dropSequenceItems as z,dropTopLevelKeys as H,proveFrontmatterRoundTrip as Q,rebuildDocSource as T,splitDocSource as Y}from"../frontmatter-splice.js";function R(o){return o!==null&&typeof o=="object"&&!Array.isArray(o)?o:null}r(R,"record");function j(o){const e=o?.surfaces;return e===void 0?[]:Array.isArray(e)?e.map(R).filter(t=>t!==null):null}r(j,"surfaceEntries");function U(o){return o==="./**"||Array.isArray(o)&&o.includes("./**")}r(U,"matchIncludesOwnerTree");function I(o){return o.some(e=>e.on==="workspace-open"&&e.at==="content")}r(I,"hasWorkspaceOpen");function N(o){return o.some(e=>e.on==="read"&&e.at==="content"&&U(e.match))}r(N,"hasOwnerRead");function C(o){const e=j(o);return e!==null&&I(e)&&N(e)}r(C,"hasCompleteFrontDoor");function V(o){const e=j(o);return e===null?!0:e.some(t=>t.on!=="workspace-open"?!1:t.at!=="content"||Object.hasOwn(t,"match")||Object.hasOwn(t,"gate")||Object.hasOwn(t,"match-frontmatter"))}r(V,"conflictingRootWorkspaceOpen");function Z(o,e){for(const[t,a]of e)if(a.repositoryRoot===o&&a.ownerRelativePath==="")return t;return O(v(o,".crouter","memory"))}r(Z,"rootStoreKey");function _(o,e){return B(o,e).replace(/\\/g,"/")}r(_,"repositoryRelativePath");function $(o,e,t){return{kind:"front-door",message:o,storeRoot:v(t,".crouter","memory"),...e.length===1?{path:e[0]}:{},paths:[...e]}}r($,"frontDoorBlocker");function lo(o,e,t,a){const d=[],u=[];for(const n of o){const y=v(n.repositoryRoot,".crouter","memory","INDEX.md"),f=O(y),p=Z(n.repositoryRoot,e);let s=null;const D=new Map,b=new Map;for(const c of n.storeKeys){const i=e.get(c);if(i===void 0||i.repositoryRoot!==n.repositoryRoot)continue;const k=i.store??t.store(c);if(!(k===void 0||!k.writable)&&!(k.descriptor.scope!=="project"||k.descriptor.plugin!==void 0))for(const h of k.snapshot.docs){const g=O(h.path);if(g===f){s=h;continue}if(i.nestedDeclarationAction==="synthetic-index-removed"&&J(h.relPath)==="")continue;const x={doc:h,storeKey:c,realPath:g};j(h.frontmatter)?.some(E=>E.on==="workspace-open"&&E.at==="content")&&D.set(g,x),C(h.frontmatter)&&b.set(g,x)}}const w=[...b.values()],m=[];if(w.length>1){const c=w.map(i=>i.doc.path);m.push($(`repository ${n.repositoryRoot} has more than one non-root document carrying the complete workspace front door (${c.join(", ")}) \u2014 keep one source guide as the transfer source, remove the other workspace-open entries, and re-run`,c,n.repositoryRoot))}const A=[...D.values()].filter(c=>!b.has(c.realPath));if(A.length>0){const c=A.map(i=>i.doc.path);m.push($(`repository ${n.repositoryRoot} has non-root workspace-open documents without the complete owner-read pair (${c.join(", ")}) \u2014 complete exactly one legacy front door or remove these workspace-open entries, then re-run`,c,n.repositoryRoot))}if(s!==null&&V(s.frontmatter)){const c=[s.path,...w.map(i=>i.doc.path)];m.push($(`repository-root guide ${s.path} carries a workspace-open route that migration cannot make authoritative without changing its predicate \u2014 make every root workspace-open entry exactly {on: workspace-open, at: content} and re-run`,c,n.repositoryRoot))}const l=w.length===1?w[0]:null,K=l===null?null:a(l.realPath);if(l!==null&&K===void 0&&m.push($(`legacy workspace front door ${l.doc.path} has no provable final canonical name \u2014 repair its identity blocker and re-run`,[l.doc.path],n.repositoryRoot)),m.length>0){u.push(...m);continue}const S=s!==null&&C(s.frontmatter),L=s===null?"created":S?"kept":"completed",F=l===null?null:_(n.repositoryRoot,l.doc.path),P=F!==null?`transferred-from:${F}`:S?"kept-root":"created-root";d.push({repositoryRoot:n.repositoryRoot,storeKey:p,rootDocPath:y,rootAction:L,leafDocPath:l?.doc.path??null,leafStoreKey:l?.storeKey??null,leafCanonicalName:K??null,action:P})}return{plans:d,blockers:u}}r(lo,"planFrontDoors");function uo(o,e){const t=o.split("/").at(-1)??o,a=e===null?`# ${t}
-
-This project's memory store. Every document here answers at \`${o}/<local name>\`.
-`:`# ${t}
-
-This project's memory store. Every document here answers at \`${o}/<local name>\`. Read [[${e}]] for the detailed project guide.
-`;return["---",`namespace: ${JSON.stringify(o)}`,"kind: knowledge",`when-and-why-to-read: When working in \`${o}\`, this knowledge should be read because it names the namespace every document in this repository answers under.`,"surfaces:","  - on: workspace-open","    at: content","  - on: read",'    match: "./**"',"    at: content","---","",a].join(`
-`)}r(uo,"rootIndexSource");function oo(o){return W(o).data===null?`---
-
----
-${o}`:o}r(oo,"sourceWithFrontmatter");function eo(o,e){let t;try{t=M(o===""?"{}":o)}catch(a){throw new Error(`front-door migration: unparseable frontmatter in ${e}`,{cause:a})}if(t===null||typeof t!="object"||Array.isArray(t))throw new Error(`front-door migration: frontmatter is not a mapping in ${e}`);return t}r(eo,"parsedYamlRecord");function fo(o,e){const t=oo(o),{rawYaml:a}=Y(t,e),d=eo(a,e),u=d.surfaces;if(u!==void 0&&!Array.isArray(u))throw new Error(`front-door migration: surfaces is not a sequence in ${e}`);const n=u===void 0?[]:u.map(s=>R(s)??s),y=n.filter(s=>R(s)!==null),f=[...n];if(I(y)||f.push({on:"workspace-open",at:"content"}),N(y)||f.push({on:"read",match:"./**",at:"content"}),f.length===n.length)return t;let p=a;return u!==void 0&&(p=H(p,["surfaces"],e)),p=p===""?G({surfaces:f},{lineWidth:0}).replace(/\r?\n$/,""):X(p,"surfaces",f,e),Q(p,{...d,surfaces:f},e),T(t,p,e)}r(fo,"completeRootFrontDoor");function mo(o,e){if(W(o).data===null)return o;const{rawYaml:t}=Y(o,e),a=z(t,"surfaces",d=>R(d)?.on==="workspace-open",e);return a===t?o:T(o,a,e)}r(mo,"demoteLeafSurfaces");export{fo as completeRootFrontDoor,mo as demoteLeafSurfaces,lo as planFrontDoors,uo as rootIndexSource};

package/dist/migrations/003-repository-root-memory-identity/index.d.ts

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

package/dist/migrations/003-repository-root-memory-identity/index.js

@@ -1,5 +0,0 @@
-var K=Object.defineProperty;var f=(e,o)=>K(e,"name",{value:o,configurable:!0});import{existsSync as A,readFileSync as j}from"node:fs";import{dirname as N,matchesGlob as z}from"node:path";import{realpathOrSelf as g}from"../../core/fs-utils.js";import{parseFrontmatterGeneric as O}from"../../core/frontmatter.js";import{loadStoreMemoryDocs as T,openProjectMemoryStore as B}from"../../core/memory-resolver.js";import{canonicalSegments as G,composeCanonicalName as $,explicitLocalName as _,INDEX_SEGMENT as Y,localNameFromPath as J,normalizeDocName as U,normalizeNameSegment as X,resolveLocalName as q,stripNamespace as H,validateExplicitLocalName as Q,validateNamespace as V}from"../../core/memory/identity.js";import{lintMemoryStore as W,MEMORY_LINT_IDENTITY_RULES as Z,resolvableCanonicalNames as ee}from"../../core/memory/lint.js";import{completeRootFrontDoor as te,demoteLeafSurfaces as oe,planFrontDoors as ne,rootIndexSource as re}from"./front-door.js";import{planRepositories as ae}from"./repository-facts.js";import{applySplices as S,itemFor as D,keyLineSpan as E,linkRewrites as ie,OldCorpus as se,renderScalar as v,routeRewrites as ce,valueSpan as M,viewsForStore as le,yamlBlock as pe,yamlMap as de}from"./references.js";let h={links:[],routes:[],wrote:new Set,repositories:[]};function F(e=[]){return{blockers:e,consumers:[],identities:[],repositories:[],storePrefixes:[],renames:[],references:[]}}f(F,"emptyPlan");function fe(e){return G(e.replace(/\\/g,"/").replace(/\.md$/i,"")).map(X).join("/")}f(fe,"pathNameNoCollapse");function me(e){const o=e.frontmatter?.name;return typeof o=="string"&&o.trim()!==""?o.trim():null}f(me,"rawExplicitName");function C(e){return e.descriptor.ownerDir??N(N(e.descriptor.storeRoot))}f(C,"ownerDirOf");function x(e){return e.scope==="project"&&e.plugin===void 0}f(x,"isProjectStore");function ue(e){const o=e.descriptor.namespace,r=C(e),p=e.descriptor.plugin??"";return{store:e,storeKey:e.key,storeRoot:e.snapshot.root,ownerDir:r,repositoryKey:"",repositoryRoot:r,ownerRelativePath:"",oldPrefix:p,oldRule:"pre-003",effectivePrefix:o,nestedDeclarationAction:"none",legacyDeclaration:null}}f(ue,"fallbackPrefix");function he(e,o){return o.find(r=>r.repositoryRoot===e.repositoryRoot)}f(he,"repositoryForPrefix");function ye(e,o,r,p){const t=he(o,r),a=[];if(e.snapshot.docs.length===0)return a;if(e.descriptor.plugin!==void 0){const i=V(o.effectivePrefix);i.ok||p.push({kind:"namespace",message:`plugin \`${e.descriptor.plugin}\` mounts its memory under \`${o.effectivePrefix}\`, which is not a valid namespace (${i.reason}) \u2014 fix the plugin package and re-run`,storeRoot:e.key,name:o.effectivePrefix})}for(const i of e.snapshot.docs){const l=J(i.relPath);l===""&&!x(e.descriptor)&&e.descriptor.plugin===void 0&&p.push({kind:"namespace",message:`a root ${Y}.md in a ${e.descriptor.scope} store composes to the empty canonical name \u2014 only a project store's root document answers at its effective prefix; rename this file to a named document (\`<topic>.md\`) or fold its content into the docs it introduces, then re-run`,storeRoot:e.key,path:i.path});const c=me(i),k=c===null?fe(i.relPath):U(c),u=o.oldRule==="per-store-declaration"?$(o.oldPrefix,q(i.frontmatter,l)):$(o.oldPrefix,k);let n=l,d=null;if(l==="")c!==null&&(d="remove");else{const y=_(i.frontmatter);if(y!==null){const s=H(y,o.effectivePrefix)??y;if(s===""||s===l)d="remove";else{const w=Q(s,o.effectivePrefix);w.ok||p.push({kind:"namespace",message:`explicit \`name: ${c}\` cannot become a store-local name (${w.reason}) \u2014 correct it and re-run`,storeRoot:e.key,path:i.path,name:c??s}),n=s,s!==c&&(d={value:s})}}}let m=null;if(l===""&&x(e.descriptor))if(o.ownerRelativePath===""){const y=i.frontmatter?.namespace;t!==void 0&&y!==t.namespace&&(m={value:t.namespace})}else o.nestedDeclarationAction!=="none"&&(m="remove");a.push({doc:i,storeKey:e.key,realPath:g(i.path),oldName:u,finalName:$(o.effectivePrefix,n),finalLocal:n,nameEdit:d,namespaceEdit:m,oldPrefix:o.oldPrefix,deleted:o.nestedDeclarationAction==="synthetic-index-removed"&&l===""})}return a}f(ye,"buildDocFacts");function ge(e,o,r){const p=new Map;for(const t of o){const a=p.get(t.finalName);a===void 0?p.set(t.finalName,[t]):a.push(t)}for(const[t,a]of p)a.length<2||r.push({kind:"collision",message:`${a.length} documents in this store would own canonical name \`${t}\` (${a.map(i=>i.doc.relPath).join(", ")}) \u2014 merge them into one document or rename one, then re-run`,storeRoot:e.key,name:t,paths:a.map(i=>i.doc.path)})}f(ge,"addFinalCollisions");function we(e,o){const r=e.descriptor.plugin!==void 0?`plugin \`${e.descriptor.plugin}\``:"crouter's builtin corpus",p=e.descriptor.plugin!==void 0?`update the plugin package (\`crtr pkg plugin update ${e.descriptor.plugin}\`) once it ships the corrected corpus`:"update crouter (`crtr sys update`) to a release whose builtin corpus already uses repository-root identity";return`${o.doc.relPath} needs an identity rewrite (\`${o.oldName}\` \u2192 \`${o.finalName}\`) in ${r}, a package-owned store this migration never writes \u2014 ${p}`}f(we,"packageOwnedCorpusMessage");function Pe(e,o,r,p){if(r.nameEdit===null&&r.namespaceEdit===null)return[];const t=pe(e);if(t===null)return r.namespaceEdit===null||r.namespaceEdit==="remove"?[]:[{start:0,end:0,text:`---
-namespace: ${v(r.namespaceEdit.value)}
----
-`}];const a=de(t.raw);if(a===null)return p.blockers.push({kind:"parse-failure",message:`${r.doc.relPath}: frontmatter is not a YAML mapping, so its identity fields cannot be rewritten \u2014 fix the file and re-run`,storeRoot:o.key,path:r.doc.path}),[];const i=[];if(r.namespaceEdit!==null){const l=D(a,"namespace");if(r.namespaceEdit==="remove"){if(l!==null){const c=E(t.raw,l);c!==null&&i.push({start:t.base+c[0],end:t.base+c[1],text:""})}}else if(l===null)i.push({start:t.base,end:t.base,text:`namespace: ${v(r.namespaceEdit.value)}
-`});else{const c=M(t.raw,l);c!==null&&i.push({start:t.base+c[0],end:t.base+c[1],text:v(r.namespaceEdit.value)})}}if(r.nameEdit!==null){const l=D(a,"name");if(l!==null)if(r.nameEdit==="remove"){const c=E(t.raw,l);c!==null&&i.push({start:t.base+c[0],end:t.base+c[1],text:""})}else{const c=M(t.raw,l);c!==null&&i.push({start:t.base+c[0],end:t.base+c[1],text:v(r.nameEdit.value)})}}return i}f(Pe,"identityRewrites");function ve(e,o){const r=e.ownerRelativePath===""?o.find(p=>p.storeKey===e.storeKey)?.action??"none":"none";return{storeRoot:e.storeRoot,ownerDir:e.ownerDir,repositoryRoot:e.repositoryRoot,ownerRelativePath:e.ownerRelativePath,oldPrefix:e.oldPrefix,oldRule:e.oldRule,effectivePrefix:e.effectivePrefix,nestedDeclarationAction:e.nestedDeclarationAction,frontDoorAction:r}}f(ve,"storePrefixRow");function ke(e){return{repositoryRoot:e.repositoryRoot,repositoryKey:e.repositoryKey,declarationPath:e.declarationPath,namespace:e.namespace,source:e.source,action:e.action}}f(ke,"repositoryRow");function Re(e){h={links:[],routes:[],wrote:new Set,repositories:[]};const o=F(),r=ae(e);if(r.blockers.length>0)return F(r.blockers);const p=new Map,t=new Map;for(const n of e.stores){const d=r.prefixes.get(n.key)??ue(n);t.set(n.key,d);const m=ye(n,d,r.repositories,o.blockers);p.set(n.key,m),ge(n,m,o.blockers)}const a=new se(p),i=new Map;for(const n of p.values())for(const d of n)i.set(d.realPath,d.finalName);const l=ne(r.repositories,r.prefixes,e,n=>i.get(g(n)));o.blockers.push(...l.blockers),o.repositories.push(...r.repositories.map(ke)),o.storePrefixes.push(...[...r.prefixes.values()].map(n=>ve(n,l.plans)));const c=new Set(l.plans.filter(n=>n.rootAction==="completed").map(n=>g(n.rootDocPath))),k=new Set(l.plans.map(n=>n.leafDocPath).filter(n=>n!==null).map(g)),u=new Map;for(const n of e.stores){const d=t.get(n.key),m=p.get(n.key)??[],y=n.writable?le(e,n):[];for(const s of m){const w=n.writable?[...ie(a,y,n,s,o,h.links),...ce(a,y,n,s,d,o,h.routes)]:[],P=S(s.doc.source,w);if(s.deleted&&n.writable){u.set(s.realPath,{path:s.doc.path,after:null});continue}const R=c.has(s.realPath)?te(P,s.doc.path):k.has(s.realPath)?oe(P,s.doc.path):P,b=Pe(R,n,s,o),L=S(R,b);if(!n.writable){(s.oldPrefix!==d.effectivePrefix||b.length>0)&&s.oldName!==s.finalName&&o.blockers.push({kind:"package-owned-corpus",message:we(n,s),storeRoot:n.key,path:s.doc.path,name:s.finalName});continue}w.length>0&&o.consumers.push({path:s.doc.path,after:P}),(R!==P||b.length>0)&&u.set(s.realPath,{path:s.doc.path,after:L}),(s.oldPrefix!==d.effectivePrefix||s.nameEdit!==null||s.namespaceEdit!==null)&&s.oldName!==s.finalName&&o.renames.push({storeRoot:n.key,path:s.doc.path,from:s.oldName,to:s.finalName})}}for(const n of l.plans)if(n.rootAction==="created"){const d=r.repositories.find(m=>m.repositoryRoot===n.repositoryRoot);if(d===void 0)throw new Error(`migration 003: no repository decision for ${n.repositoryRoot}`);o.identities.push({path:n.rootDocPath,after:re(d.namespace,n.leafCanonicalName)})}else{const d=g(n.rootDocPath),m=u.get(d);m!==void 0&&(o.identities.push(m),u.delete(d))}for(const n of l.plans){if(n.leafDocPath===null)continue;const d=g(n.leafDocPath),m=u.get(d);m!==void 0&&(o.identities.push(m),u.delete(d))}o.identities.push(...u.values());for(const n of[...o.consumers,...o.identities])h.wrote.add(n.path);return h.repositories=o.repositories.map(n=>({...n})),o}f(Re,"plan");function I(e){return x(e.descriptor)?B(C(e)):e.descriptor}f(I,"freshDescriptor");function be(e,o){if(e.size!==o.size)return!1;for(const r of e)if(!o.has(r))return!1;return!0}f(be,"sameSet");function $e(e,o){try{return z(e,o)}catch{return!1}}f($e,"safeGlob");function xe(e){const o=[];for(const t of h.repositories){if(!A(t.declarationPath)){o.push({kind:"verification",message:`repository declaration ${t.declarationPath} was not written`,path:t.declarationPath,name:t.namespace});continue}try{const a=O(j(t.declarationPath,"utf8")).data?.namespace;if(a===t.namespace)continue;o.push({kind:"verification",message:`repository declaration ${t.declarationPath} declares ${JSON.stringify(a)}, not the planned namespace \`${t.namespace}\``,path:t.declarationPath,name:t.namespace})}catch(a){o.push({kind:"verification",message:`repository declaration ${t.declarationPath} cannot be parsed after the write (${a instanceof Error?a.message:String(a)})`,path:t.declarationPath,name:t.namespace})}}for(const t of e.stores)if(!(!t.writable||t.snapshot.docs.length===0))for(const a of W(I(t)).errors){const i=a.rule==="yaml"&&h.wrote.has(a.path);!Z.has(a.rule)&&!i||o.push({kind:"verification",message:`${a.rule}: ${a.message}`,storeRoot:t.key,path:a.path,...a.name===void 0?{}:{name:a.name}})}const r=new Map,p=f(t=>{const a=r.get(t);if(a!==void 0)return a;const i=e.storesForTarget(t).flatMap(c=>T(I(c),!0)),l={names:ee(i),docs:i.map(c=>({name:c.name,realPath:g(c.path)}))};return r.set(t,l),l},"viewFor");for(const t of h.links)p(t.targetId).names.has(t.name)||o.push({kind:"verification",message:`rewritten link [[${t.name}]] resolves to no document in target ${t.targetId} after the write phases`,path:t.carrier,targetId:t.targetId,name:t.name});for(const t of h.routes){const a=p(t.targetId),i=new Set;for(const l of a.docs)t.globs.some(c=>$e(l.name,c))&&i.add(l.realPath);be(i,new Set(t.expected))||o.push({kind:"verification",message:`rewritten memory-read route \`${t.globs.join(", ")}\` names ${i.size} document(s) in target ${t.targetId}, not the ${t.expected.length} it named before the cut`,path:t.carrier,targetId:t.targetId})}return o}f(xe,"verify");const Oe={id:"003-repository-root-memory-identity",lane:"corpus",description:"repository-root memory identity: one namespace per repository, nested stores derive their prefix from their path under it",plan:Re,verify:xe};export{Oe as repositoryRootMemoryIdentityMigration};

package/dist/migrations/003-repository-root-memory-identity/references.d.ts

@@ -1,95 +0,0 @@
-import { type Pair, type YAMLMap } from 'yaml';
-import type { CorpusPlan, CorpusSnapshot, CorpusStore, StoreDoc } from '../types.js';
-import type { StorePrefixFacts } from './repository-facts.js';
-export interface DocFacts {
-    doc: StoreDoc;
-    storeKey: string;
-    /** Realpath of the file: the identity a reference proof is keyed by. */
-    realPath: string;
-    /** The exact name this document answered at before this migration. */
-    oldName: string;
-    /** Its repository-root canonical name after this migration. */
-    finalName: string;
-    /** The store-local half of `finalName`; `''` for a store root document. */
-    finalLocal: string;
-    nameEdit: 'remove' | {
-        value: string;
-    } | null;
-    namespaceEdit: 'remove' | {
-        value: string;
-    } | null;
-    /** True when phase 2 deletes this exact synthetic nested INDEX document. */
-    deleted: boolean;
-    /** The prefix this document's store answered under before this migration. */
-    oldPrefix: string;
-}
-export interface Splice {
-    start: number;
-    end: number;
-    text: string;
-}
-/** Right-to-left, widest-first at a shared start. A whole-key removal beginning
- * at the YAML block base must run before a zero-width insertion there. */
-export declare function applySplices(source: string, splices: readonly Splice[]): string;
-/** Locate the raw YAML within a complete document source. */
-export declare function yamlBlock(source: string): {
-    base: number;
-    raw: string;
-} | null;
-export declare function yamlMap(raw: string): YAMLMap | null;
-export declare function itemFor(map: YAMLMap, key: string): Pair | null;
-/** Whole-line span of a mapping key, including its multiline value. */
-export declare function keyLineSpan(raw: string, item: Pair): [number, number] | null;
-/** Span of a mapping value with trailing whitespace excluded. */
-export declare function valueSpan(raw: string, item: Pair): [number, number] | null;
-export declare function renderScalar(value: string): string;
-/** Render one or several route globs without expanding a one-line value into a
- * block sequence. */
-export declare function renderGlobList(globs: readonly string[]): string;
-export interface View {
-    signature: string;
-    storeKeys: readonly string[];
-    targetIds: readonly string[];
-}
-export declare function viewsForStore(corpus: CorpusSnapshot, store: CorpusStore): View[];
-export interface LinkProof {
-    targetId: string;
-    carrier: string;
-    name: string;
-}
-export interface RouteProof {
-    targetId: string;
-    carrier: string;
-    globs: readonly string[];
-    /** Realpaths the rewritten globs must still name exactly. */
-    expected: readonly string[];
-}
-/** Reference resolution under the frozen old corpus view. */
-export declare class OldCorpus {
-    private readonly facts;
-    private readonly matchCache;
-    constructor(docsByStoreKey: ReadonlyMap<string, DocFacts[]>);
-    /** The physical old-name winner in one view, including a synthetic document
-     * phase 2 will delete. The retired directory-index fallback is part of this
-     * frozen lookup. A virtual bare-directory prefix has no physical fact. */
-    resolveOldFact(view: View, written: string): DocFacts | null;
-    /** The final canonical name a written old name denoted in one view. Deleted
-     * physical winners have no final projection; dangling references and
-     * unprovable bare-directory mappings likewise return null. */
-    resolveOld(view: View, written: string): string | null;
-    /** Realpaths a glob names under old or final identity, plus the effective
-     * prefixes of stores contributing a match. */
-    matchSet(view: View, glob: string, phase: 'old' | 'final'): {
-        paths: Set<string>;
-        namespaces: Set<string>;
-    };
-    /** Candidate qualification for both accepted old models. A pre-003 store
-     * gains its final prefix; a superseded per-store declaration has its old
-     * prefix replaced by the repository-derived one. */
-    finalGlobSpellings(views: readonly View[], glob: string): string[];
-}
-/** The minimal glob list naming exactly the old match set under final identity,
- * or null when no exact rewrite can be proved. */
-export declare function provenGlobs(corpus: OldCorpus, views: readonly View[], glob: string): string[] | null;
-export declare function linkRewrites(corpus: OldCorpus, views: readonly View[], store: CorpusStore, fact: DocFacts, result: CorpusPlan, proofs: LinkProof[]): Splice[];
-export declare function routeRewrites(corpus: OldCorpus, views: readonly View[], store: CorpusStore, fact: DocFacts, prefix: StorePrefixFacts, result: CorpusPlan, proofs: RouteProof[]): Splice[];

package/dist/migrations/003-repository-root-memory-identity/references.js

@@ -1,5 +0,0 @@
-var E=Object.defineProperty;var u=(t,n)=>E(t,"name",{value:n,configurable:!0});import{matchesGlob as j}from"node:path";import{isMap as M,isSeq as z,parseDocument as _}from"yaml";import{parseFrontmatterGeneric as q}from"../../core/frontmatter.js";import{findDocLinks as B}from"../../core/memory/doc-link-grammar.js";import{canonicalParent as D,composeCanonicalName as b,INDEX_SEGMENT as k,representationForPath as J,routingAnchorFor as T,stripNamespace as Z}from"../../core/memory/identity.js";function de(t,n){let o=t;for(const e of[...n].sort((s,r)=>r.start-s.start||r.end-s.end))o=o.slice(0,e.start)+e.text+o.slice(e.end);return o}u(de,"applySplices");function V(t){const n=q(t);if(n.raw==="")return null;const o=t.length-n.body.length,e=t.slice(0,o).indexOf(n.raw);return e<0?null:{base:e,raw:n.raw}}u(V,"yamlBlock");function X(t){const n=_(t);return n.errors.length===0&&M(n.contents)?n.contents:null}u(X,"yamlMap");function K(t,n){return t.items.find(o=>String(o.key)===n)??null}u(K,"itemFor");function fe(t,n){const o=n.key?.range;if(o===void 0)return null;const e=n.value?.range;let s=t.lastIndexOf(`
-`,o[0]-1)+1,r=e?.[2]??o[2];if(!(r>0&&t[r-1]===`
-`)){for(;r<t.length&&(t[r]===" "||t[r]==="	"||t[r]==="\r");)r++;t[r]===`
-`&&r++}return r>=t.length&&s>0&&t[s-1]===`
-`&&(s-=1),[s,r]}u(fe,"keyLineSpan");function Y(t,n){const o=n.value?.range;if(o===void 0)return null;let e=o[1];for(;e>o[0]&&/\s/.test(t[e-1]);)e--;return[o[0],e]}u(Y,"valueSpan");const H=/^[A-Za-z][A-Za-z0-9._\-/]*$/;function ue(t){return H.test(t)?t:JSON.stringify(t)}u(ue,"renderScalar");function Q(t){return t.length===1?JSON.stringify(t[0]):`[${t.map(n=>JSON.stringify(n)).join(", ")}]`}u(Q,"renderGlobList");function he(t,n){if(n.targets.length===0)return[{signature:n.key,storeKeys:[n.key],targetIds:[]}];const o=new Map;for(const e of n.targets){const s=t.storesForTarget(e).map(i=>i.key),r=s.join("\0"),a=o.get(r);a===void 0?o.set(r,{signature:r,storeKeys:s,targetIds:[e]}):a.targetIds.push(e)}return[...o.values()]}u(he,"viewsForStore");function G(t,n){try{return j(t,n)}catch{return!1}}u(G,"safeGlob");function U(t,n){const o=t.doc.relPath.endsWith(`${k}.md`),e=n.doc.relPath.endsWith(`${k}.md`);return o!==e?o?t:n:t.doc.relPath.localeCompare(n.doc.relPath)<=0?t:n}u(U,"oldNameWinner");function ee(t){if(t.finalLocal==="")return t.finalName;if(t.finalName===t.finalLocal)return"";const n=`/${t.finalLocal}`;if(!t.finalName.endsWith(n))throw new Error(`migration 003 reference facts for ${t.doc.path} disagree: final name \`${t.finalName}\` does not compose from local name \`${t.finalLocal}\``);return t.finalName.slice(0,-n.length)}u(ee,"effectivePrefixOf");class me{static{u(this,"OldCorpus")}facts=new Map;matchCache=new Map;constructor(n){for(const[o,e]of n){const s=new Map;let r=null,a=null;for(const i of e){const l=s.get(i.oldName);if(s.set(i.oldName,l===void 0?i:U(l,i)),r===null)r=i.oldPrefix;else if(r!==i.oldPrefix)throw new Error(`migration 003 reference facts for store ${o} disagree on old prefix (\`${r}\` vs \`${i.oldPrefix}\`)`);const h=ee(i);if(a===null)a=h;else if(a!==h)throw new Error(`migration 003 reference facts for store ${o} disagree on effective prefix (\`${a}\` vs \`${h}\`)`)}this.facts.set(o,{docs:e,byOldName:s,oldPrefix:r??"",effectivePrefix:a??""})}}resolveOldFact(n,o){for(const e of n.storeKeys){const s=this.facts.get(e)?.byOldName.get(o);if(s!==void 0)return s}for(const e of n.storeKeys){const s=this.facts.get(e)?.byOldName.get(`${o}/${k}`);if(s!==void 0)return s}return null}resolveOld(n,o){const e=this.resolveOldFact(n,o);if(e!==null)return e.deleted?null:e.finalName;const s=`${o}/`;let r=null,a=!1;for(const i of n.storeKeys)for(const l of this.facts.get(i)?.docs??[]){if(!l.oldName.startsWith(s))continue;a=!0;const h=l.oldName.slice(s.length);if(!l.finalName.endsWith(`/${h}`))return null;const c=l.finalName.slice(0,l.finalName.length-h.length-1);if(r===null)r=c;else if(r!==c)return null}return a?r:null}matchSet(n,o,e){const s=`${n.signature}\0${e}\0${o}`,r=this.matchCache.get(s);if(r!==void 0)return r;const a=new Set,i=new Set;for(const h of n.storeKeys){const c=this.facts.get(h);if(c!==void 0)for(const d of c.docs){if(e==="final"&&d.deleted)continue;const y=e==="old"?d.oldName:d.finalName;y===""||!G(y,o)||(a.add(d.realPath),c.effectivePrefix!==""&&i.add(c.effectivePrefix))}}const l={paths:a,namespaces:i};return this.matchCache.set(s,l),l}finalGlobSpellings(n,o){const e=new Set;for(const s of n)for(const r of s.storeKeys){const a=this.facts.get(r);a===void 0||!a.docs.some(i=>i.oldName!==""&&G(i.oldName,o))||(e.add(b(a.effectivePrefix,o)),a.oldPrefix!==""&&(o===a.oldPrefix?e.add(a.effectivePrefix):o.startsWith(`${a.oldPrefix}/`)&&e.add(b(a.effectivePrefix,o.slice(a.oldPrefix.length+1)))))}return e.delete(""),[...e].sort()}}function C(t,n){for(const o of t)if(!n.has(o))return!1;return!0}u(C,"isSubset");function te(t,n){return t.size===n.size&&C(t,n)}u(te,"sameSet");function ne(t){const n=[],o=u(e=>{e!==""&&!n.includes(e)&&n.push(e)},"push");for(const e of t){o(e);const s=e.endsWith(`/${k}`)?e.slice(0,-(k.length+1)):e.endsWith("/**")?e.slice(0,-3):e.endsWith("/*")?e.slice(0,-2):null;s!==null&&o(s)}return n}u(ne,"candidateSpellings");function oe(t,n,o){const e=n.map(i=>({view:i,expected:t.matchSet(i,o,"old").paths}));if(e.every(({expected:i})=>i.size===0))return[o];let r=ne([o,...t.finalGlobSpellings(n,o)]).filter(i=>e.every(({view:l,expected:h})=>C(t.matchSet(l,i,"final").paths,h)));const a=u(i=>e.every(({view:l,expected:h})=>{const c=new Set;for(const d of i)for(const y of t.matchSet(l,d,"final").paths)c.add(y);return te(c,h)}),"covers");if(!a(r))return null;for(let i=r.length-1;i>=0;i--){const l=r.filter((h,c)=>c!==i);l.length>0&&a(l)&&(r=l)}return r}u(oe,"provenGlobs");function pe(t,n,o,e,s,r){const a=B(e.doc.body);if(a.length===0)return[];const i=e.doc.source.length-e.doc.body.length,l=new Map,h=[];for(const c of a){let d=l.get(c.name);if(d===void 0){const x=n.map(f=>({view:f,fact:t.resolveOldFact(f,c.name)})).filter(f=>f.fact?.deleted===!0);if(x.length>0){const f=[...new Set(x.map(p=>p.fact.doc.path))];s.blockers.push({kind:"divergent-reference",message:`[[${c.name}]] resolves to the synthetic document${f.length===1?"":"s"} ${f.map(p=>`\`${p}\``).join(", ")}, but this migration deletes ${f.length===1?"that exact document":"those exact documents"} and no surviving physical document has the same identity \u2014 rewrite the link to the intended surviving document and re-run`,storeRoot:o.key,path:e.doc.path,name:c.name,paths:f,...x[0]?.view.targetIds[0]===void 0?{}:{targetId:x[0].view.targetIds[0]}}),d=null,l.set(c.name,d);continue}const g=n.map(f=>({view:f,name:t.resolveOld(f,c.name)})).filter(f=>f.name!==null),$=[...new Set(g.map(f=>f.name))];if($.length>1)s.blockers.push({kind:"divergent-reference",message:`[[${c.name}]] resolves to different documents depending on the target view (${$.map(f=>`\`${f}\``).join(" vs ")}) \u2014 this migration never guesses which one the author meant; rewrite the link by hand and re-run`,storeRoot:o.key,path:e.doc.path,name:c.name,...g[0]===void 0||g[0].view.targetIds[0]===void 0?{}:{targetId:g[0].view.targetIds[0]}}),d=null;else if(d=$[0]??null,d!==null&&d!==c.name){for(const f of g){const p=f.view.targetIds[0];p!==void 0&&r.push({targetId:p,carrier:e.doc.path,name:d})}s.references.push({storeRoot:o.key,path:e.doc.path,kind:"link",from:c.name,to:d})}l.set(c.name,d)}d===null||d===c.name||h.push({start:i+c.start,end:i+c.end,text:`[[${d}]]`})}return h}u(pe,"linkRewrites");function ge(t,n,o,e,s,r,a){const i=e.doc.frontmatter?.surfaces;if(!Array.isArray(i))return[];const l=V(e.doc.source);if(l===null)return[];const h=X(l.raw),c=h===null?null:K(h,"surfaces")?.value,d=D(e.oldName),y=Z(d,e.oldPrefix)??d,x=b(s.effectivePrefix,y),g=T(e.finalName,J(e.doc.relPath)),$=g!==x,f=[];for(let p=0;p<i.length;p++){const w=i[p];if(w===null||typeof w!="object"||w.on!=="memory-read")continue;const N=w.match,I=(typeof N=="string"?[N]:Array.isArray(N)?N:[]).filter(m=>typeof m=="string");if(I.length===0)continue;const P=[];let A=!1;for(const m of I){if(m.startsWith("./")){$&&r.blockers.push({kind:"unsafe-route",message:`memory-read glob \`${m}\` is anchored at \`${d}\`, but this document's explicit \`name:\` re-anchors it at \`${g}\` after the identity cut \u2014 a different subtree, which no rewrite of the glob restores; spell the route out absolutely (or give the document the \`${x}/${k}.md\` path its name implies) and re-run`,storeRoot:o.key,path:e.doc.path,name:m}),P.push(m);continue}const v=oe(t,n,m);if(v===null){r.blockers.push({kind:"unsafe-route",message:`memory-read glob \`${m}\` cannot be proved to name the same documents under repository-root identity \u2014 rewrite the entry by hand (or anchor it with \`./\`) and re-run`,storeRoot:o.key,path:e.doc.path,name:m}),P.push(m);continue}if(v.length!==1||v[0]!==m){A=!0;for(const F of n){const L=F.targetIds[0],W=t.matchSet(F,m,"old").paths;L===void 0||W.size===0||a.push({targetId:L,carrier:e.doc.path,globs:v,expected:[...W]})}r.references.push({storeRoot:o.key,path:e.doc.path,kind:"memory-read",from:m,to:v.join(", ")})}P.push(...v)}if(!A)continue;if(!z(c)){r.blockers.push({kind:"unsafe-route",message:`memory-read routes in ${e.doc.relPath} need rewriting but its \`surfaces:\` block is not a YAML sequence \u2014 fix the file and re-run`,storeRoot:o.key,path:e.doc.path});continue}const O=c.items[p],R=M(O)?K(O,"match"):null,S=R===null?null:Y(l.raw,R);if(S===null){r.blockers.push({kind:"unsafe-route",message:`memory-read route in ${e.doc.relPath} needs rewriting but its \`match\` value cannot be located in the frontmatter text \u2014 fix the file and re-run`,storeRoot:o.key,path:e.doc.path});continue}f.push({start:l.base+S[0],end:l.base+S[1],text:Q([...new Set(P)])})}return f}u(ge,"routeRewrites");export{me as OldCorpus,de as applySplices,K as itemFor,fe as keyLineSpan,pe as linkRewrites,oe as provenGlobs,Q as renderGlobList,ue as renderScalar,ge as routeRewrites,Y as valueSpan,he as viewsForStore,V as yamlBlock,X as yamlMap};

package/dist/migrations/003-repository-root-memory-identity/repository-facts.d.ts

@@ -1,39 +0,0 @@
-import { type ProjectNamespaceSource } from '../../core/memory/project-namespace.js';
-import type { CorpusBlocker, CorpusSnapshot, CorpusStore } from '../types.js';
-export interface RepositoryDecision {
-    repositoryKey: string;
-    repositoryRoot: string;
-    declarationPath: string;
-    namespace: string;
-    source: 'declared' | ProjectNamespaceSource;
-    action: 'kept' | 'created' | 'filled-linked-root';
-    /** Store keys grouped under this repository, in corpus order. */
-    storeKeys: readonly string[];
-}
-export type NestedDeclarationAction = 'none' | 'removed' | 'synthetic-index-removed';
-export interface StorePrefixFacts {
-    store: CorpusStore;
-    storeKey: string;
-    storeRoot: string;
-    ownerDir: string;
-    repositoryKey: string;
-    repositoryRoot: string;
-    ownerRelativePath: string;
-    /** The prefix this store's documents answered under BEFORE this run. */
-    oldPrefix: string;
-    /** How that prefix was proven: `'per-store-declaration'` when a declaration on
-     *  disk — this store's own legacy one, or the repository-root one a nested
-     *  store already answers under — names it, `'pre-003'` when nothing declares
-     *  it and the documents answered at bare local names. */
-    oldRule: 'pre-003' | 'per-store-declaration';
-    /** repositoryNamespace ⊕ ownerRelativePath. */
-    effectivePrefix: string;
-    nestedDeclarationAction: NestedDeclarationAction;
-    /** The legacy nested `namespace:` value, when one was present. */
-    legacyDeclaration: string | null;
-}
-export declare function planRepositories(corpus: CorpusSnapshot): {
-    repositories: RepositoryDecision[];
-    prefixes: Map<string, StorePrefixFacts>;
-    blockers: CorpusBlocker[];
-};

package/dist/migrations/003-repository-root-memory-identity/repository-facts.js

@@ -1,3 +0,0 @@
-var A=Object.defineProperty;var p=(e,t)=>A(e,"name",{value:t,configurable:!0});import{dirname as v}from"node:path";import{realpathOrSelf as g,readTextIfExists as _}from"../../core/fs-utils.js";import{parseFrontmatterGeneric as C}from"../../core/frontmatter.js";import{composeCanonicalName as P,explicitLocalName as D,localNameFromPath as k,validateExplicitLocalName as T,validateNamespace as b}from"../../core/memory/identity.js";import{deriveProjectNamespace as I}from"../../core/memory/project-namespace.js";import{associateRepository as j}from"../../core/memory/repository-association.js";const R="__CROUTER_SYNTHETIC_NAMESPACE__",w="__CROUTER_SYNTHETIC_NAMESPACE_SCALAR__",K=["---","kind: knowledge",`namespace: ${w}`,`when-and-why-to-read: When working in \`${R}\`, this knowledge should be read because it names the namespace every document in this project answers under.`,"surfaces:","  - on: workspace-open","    at: content","  - on: read",'    match: "./**"',"    at: content","---",`# ${R}`,"",`This project's memory store. Every document here answers at \`${R}/<local name>\`.`,""].join(`
-`);function te(e){const t=[],r=[],n=new Map,a=[];for(const o of e.stores){if(!U(o))continue;const l=g(J(o)),d=j(l);if(!d.ok){t.push({kind:"association",message:`project memory store at ${o.key} owned by ${l} cannot be associated with a repository (${d.reason}) \u2014 repair the repository boundary and re-run`,storeRoot:o.key});continue}const m={store:o,ownerDir:l,association:d.association,rootDoc:o.snapshot.docs.find(N=>k(N.relPath)==="")??null};r.push(m);const h=d.association.kind==="git"?d.association.repositoryKey:`path:${d.association.repositoryRoot}`;let y=n.get(h);y===void 0&&(y={repositoryKey:d.association.repositoryKey,roots:new Map},n.set(h,y));let f=y.roots.get(d.association.repositoryRoot);f===void 0&&(f={association:d.association,stores:[],rootStore:null,index:$(),declaration:{state:"missing"}},y.roots.set(d.association.repositoryRoot,f),a.push(f)),f.stores.push(m),d.association.ownerRelativePath===""&&f.rootStore===null&&(f.rootStore=m)}const s=new Map;for(const o of r){if(o.association.ownerRelativePath===""){s.set(o.store.key,{declaration:{state:"missing"},action:"none"});continue}const l=H(o.rootDoc);let d="none";l.state==="invalid"?t.push(E(o.store.key,o.rootDoc?.path??o.store.key,l,"nested project memory store")):l.state==="valid"&&(d=o.rootDoc!==null&&z(o.rootDoc.source,l.value)?"synthetic-index-removed":"removed"),s.set(o.store.key,{declaration:l,action:d})}for(const o of a)o.index=F(o),o.declaration=o.index.error===null?Y(o.index.frontmatter?.namespace):{state:"invalid",reason:o.index.error,raw:void 0},o.declaration.state==="invalid"&&t.push(E(o.rootStore?.store.key??v(o.association.declarationPath),o.association.declarationPath,o.declaration,"repository root"));const i=new Map;for(const o of n.values())L(o,i,t);const u=[];for(const o of a){const l=i.get(o.association.repositoryRoot);l!==void 0&&u.push(l.decision)}const c=new Map;for(const o of r){const l=i.get(o.association.repositoryRoot),d=s.get(o.store.key);if(l===void 0||d.declaration.state==="invalid")continue;const m=o.association.ownerRelativePath==="",h=P(l.decision.namespace,o.association.ownerRelativePath),{oldPrefix:y,oldRule:f}=M(o.store,m,l.declaration,d.declaration,h);c.set(o.store.key,{store:o.store,storeKey:o.store.key,storeRoot:o.store.key,ownerDir:o.ownerDir,repositoryKey:o.association.repositoryKey,repositoryRoot:o.association.repositoryRoot,ownerRelativePath:o.association.ownerRelativePath,oldPrefix:y,oldRule:f,effectivePrefix:h,nestedDeclarationAction:d.action,legacyDeclaration:!m&&d.declaration.state==="valid"?d.declaration.value:null})}return B(r,i,t),{repositories:u,prefixes:c,blockers:t}}p(te,"planRepositories");function M(e,t,r,n,a){const s=t?r:n;return s.state==="valid"?{oldPrefix:s.value,oldRule:"per-store-declaration"}:!t&&r.state==="valid"&&!O(e,a)?{oldPrefix:a,oldRule:"per-store-declaration"}:{oldPrefix:"",oldRule:"pre-003"}}p(M,"oldAuthority");function O(e,t){return e.snapshot.docs.some(r=>{const n=D(r.frontmatter);return n===null?!1:k(r.relPath)===""||!T(n,t).ok})}p(O,"carriesLegacyExplicitIdentity");function L(e,t,r){const n=[...e.roots.values()];if(n.some(c=>c.declaration.state==="invalid"))return;const a=n.filter(c=>c.declaration.state==="valid"),s=[...new Set(a.map(c=>c.declaration.value))];if(s.length>1){const c=a.map(o=>o.association.declarationPath);r.push({kind:"namespace",message:`linked repository roots for ${e.repositoryKey} declare different namespaces (${s.map(o=>`\`${o}\``).join(", ")}) \u2014 make every root declaration agree and re-run`,paths:c});return}if(s.length===1){const c=s[0];for(const o of n){const l=o.declaration.state==="valid"?"kept":"filled-linked-root";t.set(o.association.repositoryRoot,{declaration:o.declaration,decision:x(e,o,c,"declared",l)})}return}const i=n[0],u=I({ownerDir:i.association.repositoryRoot,rootFrontmatter:i.index.frontmatter,...i.index.exists?{rootBody:i.index.body}:{}});if(!u.ok){r.push({kind:"namespace",message:`repository at ${i.association.repositoryRoot} cannot derive a namespace (${u.reason}) \u2014 declare a valid \`namespace:\` on ${i.association.declarationPath} and re-run`,storeRoot:i.rootStore?.store.key??v(i.association.declarationPath),...i.index.exists?{path:i.association.declarationPath}:{}});return}for(const c of n)t.set(c.association.repositoryRoot,{declaration:c.declaration,decision:x(e,c,u.namespace,u.source,c.index.exists?"kept":"created")})}p(L,"selectGroup");function x(e,t,r,n,a){return{repositoryKey:e.repositoryKey,repositoryRoot:t.association.repositoryRoot,declarationPath:t.association.declarationPath,namespace:r,source:n,action:a,storeKeys:t.stores.map(s=>s.store.key)}}p(x,"repositoryDecision");function F(e){const t=g(e.association.declarationPath),r=e.rootStore?.store.snapshot.docs.find(n=>g(n.path)===t);if(r!==void 0)return{exists:!0,frontmatter:r.frontmatter,body:r.body,error:null};try{const n=_(e.association.declarationPath);if(n===null)return $();const a=C(n);return{exists:!0,frontmatter:a.data,body:a.body,error:null}}catch(n){return{exists:!0,frontmatter:null,body:"",error:`cannot read or parse ${e.association.declarationPath} (${Z(n)})`}}}p(F,"readRootIndex");function $(){return{exists:!1,frontmatter:null,body:"",error:null}}p($,"missingRootIndex");function H(e){return e?.frontmatter===null||e?.frontmatter===void 0||!Object.prototype.hasOwnProperty.call(e.frontmatter,"namespace")?{state:"missing"}:S(e.frontmatter.namespace)}p(H,"legacyNestedDeclarationFacts");function Y(e){return e==null||e===""?{state:"missing"}:S(e)}p(Y,"declarationFacts");function S(e){if(typeof e!="string")return{state:"invalid",reason:`\`namespace:\` is non-string (${JSON.stringify(e)})`,raw:e};const t=b(e);return t.ok?{state:"valid",value:e}:{state:"invalid",reason:`\`namespace: ${e}\` is invalid (${t.reason})`,raw:e}}p(S,"authoredDeclarationFacts");function E(e,t,r,n){return{kind:"namespace",message:`${n} has an invalid namespace declaration at ${t} (${r.reason}) \u2014 correct it and re-run; migration never replaces an unprovable identity`,storeRoot:e,path:t,...typeof r.raw=="string"?{name:r.raw}:{}}}p(E,"invalidDeclarationBlocker");function B(e,t,r){const n=new Map;for(const a of e){const s=`${a.association.repositoryRoot}\0${a.association.ownerRelativePath}`,i=n.get(s);i===void 0?n.set(s,[a]):i.push(a)}for(const a of n.values()){if(a.length<2)continue;const s=a[0],i=t.get(s.association.repositoryRoot),u=i===void 0?s.association.ownerRelativePath:P(i.decision.namespace,s.association.ownerRelativePath),c=a.map(o=>o.ownerDir);r.push({kind:"collision",message:`directories ${c.join(", ")} in repository ${s.association.repositoryRoot} normalize to the same owner path \`${s.association.ownerRelativePath}\` and effective prefix \`${u}\` \u2014 rename one directory and re-run`,storeRoot:s.store.key,name:u,paths:c})}}p(B,"addOwnerPathCollisionBlockers");function z(e,t){return e===K.replaceAll(w,G(t)).replaceAll(R,t)}p(z,"isSupersededSyntheticIndex");function G(e){return/^[A-Za-z][A-Za-z0-9._\-/]*$/.test(e)?e:JSON.stringify(e)}p(G,"renderScalar");function J(e){return e.descriptor.ownerDir??v(v(e.descriptor.storeRoot))}p(J,"ownerDirOf");function U(e){return e.descriptor.scope==="project"&&e.descriptor.plugin===void 0}p(U,"isNativeProjectStore");function Z(e){return(e instanceof Error?e.message:String(e)).split(`
-`)[0]??String(e)}p(Z,"firstLine");export{te as planRepositories};

package/dist/migrations/convergent.d.ts

@@ -1,43 +0,0 @@
-import type { DocChange, StateMigration, StoreSnapshot } from './types.js';
-/** A doc excluded from the snapshot because its frontmatter is not valid YAML.
- *  Per-doc throw isolation at the collection layer: the bad file is named and
- *  the rest of the store still migrates. */
-export interface SkippedDoc {
-    relPath: string;
-    error: string;
-}
-export interface ConvergentRunResult {
-    root: string;
-    /** One row per migration that planned real changes, in registry order. */
-    applied: {
-        migration: string;
-        files: string[];
-    }[];
-    skipped: SkippedDoc[];
-    /** The store's docs with every planned change folded in — the bytes on disk
-     *  after a write run, and the bytes a write run WOULD have produced under
-     *  `--dry-run`. What the corpus lane plans against. */
-    snapshot: StoreSnapshot;
-}
-/** Snapshot every parseable `.md` under `root` (hidden dirs — `.history`
- *  sidecars and the like — skipped, mirroring substrate doc enumeration).
- *  `SKILL.md` bundles are Agent Skills, not memory docs: they carry no
- *  canonical identity and are never rewritten. */
-export declare function loadStoreSnapshot(root: string): {
-    snapshot: StoreSnapshot;
-    skipped: SkippedDoc[];
-};
-/** Fold one applied change back into the in-memory snapshot so the NEXT
- *  migration plans against post-change state (dry runs included — that is what
- *  makes a dry-run diff equal the real run's writes). A migration that emits
- *  invalid YAML is a defect and throws here, before anything else compounds
- *  on its output. */
-export declare function foldDocChange(snapshot: StoreSnapshot, change: DocChange): void;
-/** Run every registered convergent migration over the store at `root`, in
- *  registry order. No-op changes (identical text) are filtered; each real
- *  change is written atomically unless `dryRun`. Journaled migrations in the
- *  list are the db chain's business and are skipped here. */
-export declare function runConvergentMigrations(root: string, opts?: {
-    dryRun?: boolean;
-    migrations?: readonly StateMigration[];
-}): ConvergentRunResult;

package/dist/migrations/convergent.js

@@ -1,2 +0,0 @@
-var m=Object.defineProperty;var p=(o,t)=>m(o,"name",{value:t,configurable:!0});import{relative as l,sep as d}from"node:path";import{atomicWriteText as h,readText as S,removePath as g,walkFiles as x}from"../core/fs-utils.js";import{parseFrontmatterGeneric as u}from"../core/frontmatter.js";import{STATE_MIGRATIONS as y}from"./registry.js";function T(o,t){const s=l(o,t).split(d).join("/"),n=S(t);try{const{data:r,body:a}=u(n);return{doc:{path:t,relPath:s,source:n,frontmatter:r,body:a}}}catch(r){return{error:(r instanceof Error?r.message:String(r)).split(`
-`)[0]}}}p(T,"parseDoc");function v(o){const t=[],s=[];for(const n of x(o,r=>r.endsWith(".md")&&r!=="SKILL.md",r=>r.startsWith("."))){const r=T(o,n);"doc"in r?t.push(r.doc):s.push({relPath:l(o,n).split(d).join("/"),error:r.error})}return{snapshot:{root:o,docs:t},skipped:s}}p(v,"loadStoreSnapshot");function I(o,t){const s=o.docs.findIndex(c=>c.path===t.path);if(t.after===null){s>=0&&o.docs.splice(s,1);return}const n=l(o.root,t.path).split(d).join("/"),{data:r,body:a}=u(t.after),i={path:t.path,relPath:n,source:t.after,frontmatter:r,body:a};s>=0?o.docs[s]=i:o.docs.push(i)}p(I,"foldDocChange");function W(o,t={}){const s=(t.migrations??y).filter(i=>i.lane==="convergent"),{snapshot:n,skipped:r}=v(o),a=[];for(const i of s){const c=new Map(n.docs.map(e=>[e.path,e.source])),f=i.apply(n).filter(e=>e.after===null?c.has(e.path):c.get(e.path)!==e.after);if(f.length!==0){for(const e of f)t.dryRun!==!0&&(e.after===null?g(e.path):h(e.path,e.after)),I(n,e);a.push({migration:i.description,files:f.map(e=>e.path)})}}return{root:o,applied:a,skipped:r,snapshot:n}}p(W,"runConvergentMigrations");export{I as foldDocChange,v as loadStoreSnapshot,W as runConvergentMigrations};

package/dist/migrations/corpus.d.ts

@@ -1,75 +0,0 @@
-import type { NodeMemoryTarget } from '../core/canvas/types.js';
-import type { CorpusBlocker, CorpusDiscoveryRoot, CorpusIdentityRename, CorpusReferenceRewrite, CorpusRepositoryDecision, CorpusSnapshot, CorpusStore, CorpusStorePrefix, CorpusTarget, ProfileManifestSnapshot, StateMigration, StoreSnapshot } from './types.js';
-/** A store before its documents are read. */
-export type DiscoveredStore = Omit<CorpusStore, 'snapshot'>;
-export interface CorpusDiscovery {
-    /** Every place discovery looked, in the order it looked. */
-    roots: CorpusDiscoveryRoot[];
-    /** Deduped by realpath, in discovery order. Stores whose directory does not
-     *  exist are absent: there is nothing to migrate and nothing to point at. */
-    stores: DiscoveredStore[];
-    targets: CorpusTarget[];
-    /** Roots and targets discovery could not read. */
-    blockers: CorpusBlocker[];
-}
-export interface CorpusSkippedDoc {
-    storeRoot: string;
-    relPath: string;
-    error: string;
-}
-export interface CorpusRunResult {
-    /** Corpus migrations in the registry. Zero means the lane is inert. */
-    migrations: number;
-    /** True when blockers exist and a corpus migration was registered to gate. */
-    blocked: boolean;
-    blockers: CorpusBlocker[];
-    planned: {
-        migration: string;
-        consumers: string[];
-        identities: string[];
-    }[];
-    repositories: CorpusRepositoryDecision[];
-    storePrefixes: CorpusStorePrefix[];
-    renames: CorpusIdentityRename[];
-    references: CorpusReferenceRewrite[];
-    /** Files written, or under `--dry-run` the files that would be written. */
-    wrote: {
-        consumers: string[];
-        identities: string[];
-    };
-    /** True when the post-write rebuild ran every migration's `verify`. */
-    verified: boolean;
-}
-/** Discover the whole reachable corpus: every store, the targets that mount
- *  them, and the frontier searched to find them. `profiles` are the manifest
- *  lane's post-migration snapshots — a pre-migration manifest reads as corrupt,
- *  so discovery must run after that lane, not against `listProfiles()`. */
-export declare function discoverCorpus(opts: {
-    cwd?: string;
-    profiles: readonly ProfileManifestSnapshot[];
-    explicitDirs?: readonly string[];
-    nodes: readonly NodeMemoryTarget[];
-}): Promise<CorpusDiscovery>;
-/** Read every discovered store's documents. `preloaded` supplies the per-store
- *  convergent lane's FOLDED snapshots so the corpus plans against the bytes a
- *  write run leaves behind — identical under `--dry-run`, where the same fold
- *  ran and nothing was written. */
-export declare function loadCorpusSnapshots(discovery: CorpusDiscovery, opts?: {
-    preloaded?: ReadonlyMap<string, StoreSnapshot>;
-}): {
-    snapshots: Map<string, StoreSnapshot>;
-    skipped: CorpusSkippedDoc[];
-};
-export declare function parseFailureBlockers(skipped: readonly CorpusSkippedDoc[]): CorpusBlocker[];
-export declare function buildCorpusSnapshot(discovery: CorpusDiscovery, snapshots: ReadonlyMap<string, StoreSnapshot>): CorpusSnapshot;
-/** Plan every corpus migration over the whole corpus, then — only when the
- *  global plan is blocker-free — write every migration's consumer rewrites
- *  before any identity rewrite. `rebuild` re-reads the corpus from file truth
- *  for the post-write `verify` pass. */
-export declare function runCorpusMigrations(corpus: CorpusSnapshot, opts?: {
-    dryRun?: boolean;
-    migrations?: readonly StateMigration[];
-    /** Discovery and parse-failure blockers, gating identically to plan ones. */
-    blockers?: readonly CorpusBlocker[];
-    rebuild?: () => CorpusSnapshot;
-}): CorpusRunResult;

package/dist/migrations/corpus.js

@@ -1,3 +0,0 @@
-var z=Object.defineProperty;var c=(t,n)=>z(t,"name",{value:n,configurable:!0});import{envProfileId as H}from"../shared/env.js";import{readdirSync as Q}from"node:fs";import{dirname as C,join as x}from"node:path";import{appsRoot as T,appSpace as V}from"../core/layout.js";import{atomicWriteText as L,listDirs as O,pathExists as v,realpathOrSelf as R,removePath as _,walkFiles as X}from"../core/fs-utils.js";import{memoryStoresInPrecedence as Z}from"../core/memory-resolver.js";import{descendantStoreRootsExhaustive as oo}from"../core/nested-stores.js";import{profileMemoryDir as eo}from"../core/profiles/manifest.js";import{memoryDir as to}from"../core/runtime/memory.js";import{listInstalledPlugins as so,listInstalledPluginsInRoot as no}from"../core/resolver.js";import{NEUTRAL_PROJECT_MEMORY as D,pluginMemoryDir as ro,projectScopeRoots as B,scopeRoot as io}from"../core/scope.js";import{CRTR_DIR_NAME as F}from"../types.js";import{foldDocChange as ao,loadStoreSnapshot as co}from"./convergent.js";import{STATE_MIGRATIONS as po}from"./registry.js";function fo(t){return(t instanceof Error?t.message:String(t)).split(`
-`)[0]??""}c(fo,"firstLine");function uo(t){return`${t.profileId??"-"}:${t.nodeId??"-"}:${R(t.cwd)}`}c(uo,"targetId");function lo(t){const n=ro(t);return{scope:t.scope,storeRoot:n,namespace:t.name,plugin:t.name,mountStatus:v(n)?"ready":"absent",projectMemory:D}}c(lo,"pluginStoreDescriptor");function mo(t){return{scope:"node",storeRoot:t,namespace:"",mountStatus:v(t)?"ready":"absent",projectMemory:D}}c(mo,"nodeStoreDescriptor");function ho(){const t=[];for(const n of O(T()))for(const r of O(x(T(),n,"memory","nodes"))){const i=x(T(),n,"memory","nodes",r);if(!v(i))continue;X(i,d=>d.endsWith(".md")&&d!=="SKILL.md",d=>d.startsWith(".")).length>0&&t.push({nodeId:r,storeRoot:i})}return t}c(ho,"nodeStoresWithDocs");async function Do(t){const n=R(t.cwd??process.cwd()),r=H()||null,i=t.explicitDirs??[],m=[],d=new Set,u=c(o=>{const e=`${o.reason}\0${R(o.root)}\0${o.detail??""}`;d.has(e)||(d.add(e),m.push(o))},"addRoot"),y=new Map,P=c((o,e,s)=>{const f=R(o);let p=y.get(f);p===void 0&&(p={root:o,reason:e,profileIds:[]},y.set(f,p)),p.profileIds.includes(s)||p.profileIds.push(s)},"addProjectRoot"),$=[{reason:"cwd-ancestor",profileId:r,roots:B(n,r)},...t.profiles.map(({profileId:o,manifest:e})=>({reason:"profile-project",profileId:o,detail:o,roots:[...new Set(e.projects.flatMap(s=>[x(s.path,F),...B(s.path,null)]))]})),...i.map(o=>({reason:"explicit-dir",profileId:r,detail:o,roots:[x(R(o),F)]}))],S=new Map,b=c(o=>{const e=o.map(f=>R(f)).sort().join(`
-`);let s=S.get(e);return s===void 0&&(s=oo([...o]),S.set(e,s)),s},"descendantsUnder"),j=c((o,e,s,f)=>{const p=f===void 0?{}:{detail:f};for(const h of o)u({reason:e,root:h,boundary:e==="explicit-dir"?"store":"ancestors",...p}),P(h,e,s);for(const h of b(o))u({reason:"descendant",root:h,boundary:"descendants",...p}),P(h,"descendant",s)},"expandRoots");for(const o of $)j(o.roots,o.reason,o.profileId,o.detail);const I=[],k=new Map,w=c((o,e,s)=>{const f=o.storeRoot;if(f===""||!v(f))return;const p=R(f);let h=k.get(p);if(h===void 0){h={key:p,descriptor:o,discovery:[],discoverySeen:new Set,targets:[],writable:o.scope!=="builtin"},k.set(p,h);try{Q(p)}catch(q){I.push({kind:"inaccessible-root",message:`memory store cannot be listed (${fo(q)}) \u2014 discovery cannot see its documents; fix the permissions and re-run`,storeRoot:p})}}const A=`${e.reason}\0${e.root}\0${e.targetId??""}`;h.discoverySeen.has(A)||(h.discoverySeen.add(A),h.discovery.push(e)),s!==void 0&&(h.targets.includes(s.id)||h.targets.push(s.id),s.storeKeys.includes(p)||s.storeKeys.push(p))},"register"),a=[],l=new Map,M=c((o,e,s)=>{const f=uo(s);if(l.has(f))return;const p={id:f,kind:o,origin:e,target:s,storeKeys:[]};l.set(f,p),a.push(p)},"addTarget");M("cwd",n,{cwd:n,profileId:r,nodeId:null});for(const{profileId:o,manifest:e}of t.profiles)M("profile",o,{cwd:e.projects[0]?.path??n,profileId:o,nodeId:null});const g=c(()=>{for(const{root:o,profileIds:e}of[...y.values()])for(const s of[...e])M("project",C(o),{cwd:C(o),profileId:s,nodeId:null})},"addProjectTargets"),Y=ho();v(T())&&u({reason:"node",root:T(),boundary:"nodes"});const G=new Map(t.nodes.map(o=>[o.nodeId,o]));for(const{nodeId:o,storeRoot:e}of Y){const s=G.get(o);if(s===void 0||s.cwd===""||to(o,s.grantee)!==e){const f=s===void 0?"no row":s.cwd===""?"empty cwd":"app assignment differs from folder";I.push({kind:"inaccessible-target",message:`node ${o} holds memory documents but canvas.db has no matching app assignment and usable row for it (${f}) \u2014 the corpus cannot resolve its project or profile`,storeRoot:R(e)}),w(mo(e),{reason:"node",root:e});continue}M("node",o,{cwd:s.cwd,profileId:s.profileId,nodeId:o,grantee:s.grantee})}const J=c(o=>{for(const e of Z(o.target)){if(e.plugin!==void 0){u({reason:"plugin",root:e.storeRoot,boundary:"store",detail:e.plugin}),w(e,{reason:"plugin",root:e.storeRoot,targetId:o.id},o);continue}if(e.scope==="project"){const f=C(e.storeRoot),p=y.get(R(f));p===void 0&&j([f],"cwd-ancestor",o.target.profileId,o.id),w(e,{reason:p?.reason??"cwd-ancestor",root:f,targetId:o.id},o);continue}const s=e.scope==="user"?"user":e.scope==="profile"?"profile":e.scope==="node"?"node":"builtin";u({reason:s,root:e.storeRoot,boundary:"store"}),w(e,{reason:s,root:e.storeRoot,targetId:o.id},o)}},"walkTarget"),E=new Set;for(;;){g();const o=a.filter(e=>!E.has(e.id));if(o.length===0)break;for(const e of o)E.add(e.id),J(e)}const K=io("user");K!==null&&u({reason:"plugin",root:K,boundary:"plugins"});const W=[...so("user")];for(const{root:o}of y.values())u({reason:"plugin",root:o,boundary:"plugins"}),W.push(...no("project",o));for(const o of W){const e=lo(o);u({reason:"plugin",root:e.storeRoot,boundary:"store",detail:o.name}),w(e,{reason:"plugin",root:e.storeRoot})}for(const{profileId:o,manifest:e}of t.profiles){const s=e.grantee?.startsWith("app:")?x(V(e.grantee).memory,"profiles",o):eo(o);u({reason:"profile",root:s,boundary:"store",detail:o}),w({scope:"profile",storeRoot:s,namespace:"",mountStatus:v(s)?"ready":"absent",projectMemory:D},{reason:"profile",root:s})}return{roots:m,stores:[...k.values()].map(o=>({key:o.key,descriptor:o.descriptor,discovery:o.discovery,targets:o.targets,writable:o.writable})),targets:a.map(o=>({id:o.id,kind:o.kind,origin:o.origin,target:o.target,storeKeys:o.storeKeys})),blockers:I}}c(Do,"discoverCorpus");function Eo(t,n={}){const r=new Map,i=[];for(const m of t.stores){const d=n.preloaded?.get(m.key);if(d!==void 0){r.set(m.key,d);continue}const u=co(m.descriptor.storeRoot);r.set(m.key,u.snapshot);for(const y of u.skipped)i.push({storeRoot:m.key,...y})}return{snapshots:r,skipped:i}}c(Eo,"loadCorpusSnapshots");function Ko(t){return t.map(n=>({kind:"parse-failure",message:`${n.relPath}: frontmatter is not valid YAML (${n.error}) \u2014 the document's identity cannot be read; fix the file and re-run`,storeRoot:n.storeRoot,path:x(n.storeRoot,n.relPath)}))}c(Ko,"parseFailureBlockers");function N(t,n,r){const i=new Map(t.map(d=>[d.key,d])),m=new Map(n.map(d=>[d.id,d]));return{stores:t,targets:n,roots:r,store:c(d=>i.get(d),"store"),storesForTarget:c(d=>(m.get(d)?.storeKeys??[]).map(u=>i.get(u)).filter(u=>u!==void 0),"storesForTarget")}}c(N,"makeCorpusSnapshot");function Wo(t,n){const r=t.stores.map(i=>({...i,snapshot:n.get(i.key)??{root:i.descriptor.storeRoot,docs:[]}}));return N(r,t.targets,t.roots)}c(Wo,"buildCorpusSnapshot");function go(t){const n=t.stores.map(r=>({...r,snapshot:{root:r.snapshot.root,docs:[...r.snapshot.docs]}}));return N(n,t.targets,t.roots)}c(go,"cloneCorpus");function U(t,n,r=new Set){let i;for(const m of t.stores)n.path.startsWith(`${m.snapshot.root}/`)&&(i===void 0||m.snapshot.root.length>i.snapshot.root.length)&&(i=m);if(i===void 0){if(r.has(n.path))return;throw new Error(`corpus migration: planned change outside every discovered store: ${n.path}`)}ao(i.snapshot,n)}c(U,"foldCorpusChange");function Ao(t,n={}){const r=(n.migrations??po).filter(a=>a.lane==="corpus"),i=[...n.blockers??[]],m=[],d=[],u=[],y=[],P=[],$=[],S=[],b=c((a,l)=>({migrations:r.length,blocked:i.length>0&&r.length>0,blockers:i,planned:m,repositories:d,storePrefixes:u,renames:y,references:P,wrote:l,verified:a}),"result"),j={consumers:[],identities:[]};if(r.length===0)return b(!1,j);const I=go(t);for(const a of r){const l=a.plan(I);i.push(...l.blockers),d.push(...l.repositories),u.push(...l.storePrefixes),y.push(...l.renames),P.push(...l.references);for(const g of l.consumers)U(I,g);const M=new Set(l.repositories.map(g=>g.declarationPath));for(const g of l.identities)U(I,g,M);$.push(...l.consumers),S.push(...l.identities),m.push({migration:a.description,consumers:l.consumers.map(g=>g.path),identities:l.identities.map(g=>g.path)})}const k={consumers:$.map(a=>a.path),identities:S.map(a=>a.path)};if(i.length>0)return b(!1,j);if(n.dryRun===!0)return b(!1,k);for(const a of $)a.after===null?_(a.path):L(a.path,a.after);for(const a of S)a.after===null?_(a.path):L(a.path,a.after);if(n.rebuild===void 0)return b(!1,k);const w=n.rebuild();for(const a of r)for(const l of a.verify?.(w)??[])i.push({...l,kind:"verification"});return b(!0,k)}c(Ao,"runCorpusMigrations");export{Wo as buildCorpusSnapshot,Do as discoverCorpus,Eo as loadCorpusSnapshots,Ko as parseFailureBlockers,Ao as runCorpusMigrations};

package/dist/migrations/frontmatter-splice.d.ts

@@ -1,15 +0,0 @@
-/** Split a complete document into its raw frontmatter YAML and byte-preserved body. */
-export declare function splitDocSource(source: string, docPath: string): {
-    rawYaml: string;
-    body: string;
-};
-/** Remove complete top-level mapping-key lines, including multiline values. */
-export declare function dropTopLevelKeys(rawYaml: string, keys: readonly string[], docPath: string): string;
-/** Remove selected items from a top-level block sequence without re-rendering retained bytes. */
-export declare function dropSequenceItems(rawYaml: string, key: string, drop: (item: unknown) => boolean, docPath: string): string;
-/** Append a rendered top-level mapping pair while retaining existing YAML bytes. */
-export declare function appendRenderedKey(rawYaml: string, key: string, value: unknown, docPath: string): string;
-/** Prove that a transformed YAML block parses to exactly the expected mapping. */
-export declare function proveFrontmatterRoundTrip(after: string, expected: Record<string, unknown>, docPath: string): void;
-/** Replace only the YAML block in a complete document; the body remains byte-for-byte unchanged. */
-export declare function rebuildDocSource(source: string, newYaml: string, docPath: string): string;

package/dist/migrations/frontmatter-splice.js

@@ -1,8 +0,0 @@
-var A=Object.defineProperty;var p=(e,t)=>A(e,"name",{value:t,configurable:!0});import{isMap as q,isSeq as v,parse as x,parseDocument as k,stringify as O}from"yaml";import{parseFrontmatterGeneric as R}from"../core/frontmatter.js";function w(e,t){if(e===t)return!0;if(Array.isArray(e)||Array.isArray(t))return!Array.isArray(e)||!Array.isArray(t)||e.length!==t.length?!1:e.every((r,n)=>w(r,t[n]));if(e!==null&&t!==null&&typeof e=="object"&&typeof t=="object"){const r=Object.keys(e),n=Object.keys(t);return r.length!==n.length?!1:r.every(c=>w(e[c],t[c]))}return!1}p(w,"deepEqual");function $(e,t){if(e.trim()==="")return[];const r=k(e);if(r.errors.length>0||!q(r.contents))throw new Error(`frontmatter splice: unparseable frontmatter in ${t}`);return r.contents.items}p($,"yamlMap");function j(e,t,r){const n=t.key?.range,c=t.value?.range;if(n===void 0)throw new Error(`frontmatter splice: rangeless key in ${r}`);const f=e.lastIndexOf(`
-`,n[0]-1)+1;let o=c?.[2]??n[2];if(!(o>0&&e[o-1]===`
-`)){for(;o<e.length&&(e[o]===" "||e[o]==="	"||e[o]==="\r");)o++;e[o]===`
-`&&o++}return[f,o]}p(j,"keyLineSpan");function h(e,t){$(e,t);let r;try{r=x(e)}catch{throw new Error(`frontmatter splice: unparseable frontmatter in ${t}`)}if(r===null||typeof r!="object"||Array.isArray(r))throw new Error(`frontmatter splice: frontmatter is not a mapping in ${t}`);return r}p(h,"parseRecord");function D(e,t){let r;try{r=R(e)}catch(n){throw new Error(`frontmatter splice: unparseable frontmatter in ${t}`,{cause:n})}if(r.raw===""&&r.body===e)throw new Error(`frontmatter splice: cannot locate frontmatter block in ${t}`);return{rawYaml:r.raw,body:r.body}}p(D,"splitDocSource");function I(e,t,r){const n=$(e,r),c=new Set(t),f=n.filter(i=>c.has(String(i.key))).map(i=>j(e,i,r)).sort((i,u)=>u[0]-i[0]);let o=e;for(const[i,u]of f)o=o.slice(0,i)+o.slice(u);const l=h(e,r);for(const i of t)delete l[i];return g(o,l,r),o}p(I,"dropTopLevelKeys");function M(e,t,r,n){const f=$(e,n).find(s=>String(s.key)===t);if(f===void 0)return e;if(!v(f.value))throw new Error(`frontmatter splice: ${t} is not a sequence in ${n}`);const o=f.value.items,l=o.map(s=>r(s.toJSON?.()));if(!l.some(Boolean))return e;const i=h(e,n),u=i[t];if(!Array.isArray(u))throw new Error(`frontmatter splice: ${t} is not a sequence in ${n}`);const E=u.filter((s,a)=>!l[a]);if(E.length===0){delete i[t];const s=I(e,[t],n);return g(s,i,n),s}const b=f.value.range;if(b===void 0)throw new Error(`frontmatter splice: rangeless sequence in ${n}`);const y=o.map(s=>{const a=s.range;if(a===void 0)throw new Error(`frontmatter splice: rangeless sequence item in ${n}`);return e.lastIndexOf(`
-`,a[0]-1)+1});if(new Set(y).size!==y.length)throw new Error(`frontmatter splice: flow sequence cannot be spliced byte-precisely in ${n}`);const m=[];for(let s=0;s<o.length;s++){if(!l[s])continue;const a=y[s],S=y[s+1]??b[2];m.push([a,S])}m.sort((s,a)=>a[0]-s[0]);let d=e;for(const[s,a]of m)d=d.slice(0,s)+d.slice(a);return i[t]=E,g(d,i,n),d}p(M,"dropSequenceItems");function N(e,t,r,n){const c=h(e,n);c[t]=r;const f=O({[t]:r},{lineWidth:0});let o=e===""?f:(e.endsWith(`
-`)?e:e+`
-`)+f;return o=o.replace(/\r?\n$/,""),g(o,c,n),o}p(N,"appendRenderedKey");function g(e,t,r){let n;try{n=x(e===""?"{}":e)}catch(c){throw new Error(`frontmatter splice: transformed frontmatter does not parse in ${r}`,{cause:c})}if(!w(n??{},t))throw new Error(`frontmatter splice: spliced frontmatter does not round-trip in ${r}`)}p(g,"proveFrontmatterRoundTrip");function T(e,t,r){const{rawYaml:n,body:c}=D(e,r),f=e.length-c.length,o=e.indexOf(`
-`),l=o<0?-1:o+1,i=l<0?-1:l+n.length;if(n===""&&f===e.length)throw new Error(`frontmatter splice: cannot locate frontmatter block in ${r}`);if(l<0||i>f)throw new Error(`frontmatter splice: cannot locate frontmatter block in ${r}`);return e.slice(0,l)+t+e.slice(i)}p(T,"rebuildDocSource");export{N as appendRenderedKey,M as dropSequenceItems,I as dropTopLevelKeys,g as proveFrontmatterRoundTrip,T as rebuildDocSource,D as splitDocSource};

package/dist/migrations/profile-manifests.d.ts

@@ -1,30 +0,0 @@
-import type { ProfileManifestSnapshot, StateMigration } from './types.js';
-export interface ProfileManifestRunResult {
-    /** Profile manifests found under the profiles root. */
-    profiles: number;
-    /** One row per migration that rewrote a manifest, in registry order. */
-    applied: {
-        profileId: string;
-        path: string;
-        migration: string;
-    }[];
-    /** Post-migration manifest per readable profile, in scan order — coherent
-     *  under `dryRun`, where the same fold ran but nothing was written. */
-    snapshots: ProfileManifestSnapshot[];
-    /** Manifests left untouched because they are not valid JSON. Unreadable
-     *  bytes are not a structure this lane can convert, and failing the run over
-     *  one would block every other profile's convergence. */
-    skipped: {
-        profileId: string;
-        path: string;
-        error: string;
-    }[];
-}
-export declare function runProfileManifestMigrations(profilesRoot: string, opts: {
-    /** Held for the whole re-read/fold/write of one manifest — the same lock
-     *  add/remove take, so a concurrent mutation either lands before the
-     *  re-read or serializes after the write, never under it. */
-    withLock: <T>(profileId: string, fn: () => T) => T;
-    dryRun?: boolean;
-    migrations?: readonly StateMigration[];
-}): ProfileManifestRunResult;

package/dist/migrations/profile-manifests.js

@@ -1,2 +0,0 @@
-var d=Object.defineProperty;var l=(n,o)=>d(n,"name",{value:o,configurable:!0});import{existsSync as u,readFileSync as h,readdirSync as y}from"node:fs";import{join as S}from"node:path";import{atomicWriteJson as g}from"../core/fs-utils.js";import{STATE_MIGRATIONS as w}from"./registry.js";const A=/^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{8}$/;function x(n,o){const m=(o.migrations??w).filter(s=>s.lane==="profile-manifest"),e={profiles:0,applied:[],snapshots:[],skipped:[]};if(!u(n))return e;for(const s of y(n,{withFileTypes:!0})){if(!s.isDirectory())continue;const t=s.name;if(!A.test(t))continue;const i=S(n,t,"profile.json");u(i)&&(e.profiles+=1,o.withLock(t,()=>{let f;try{const r=JSON.parse(h(i,"utf8"));if(typeof r!="object"||r===null||Array.isArray(r))throw new Error("manifest is not a JSON object");f=r}catch(r){e.skipped.push({profileId:t,path:i,error:(r instanceof Error?r.message:String(r)).split(`
-`)[0]});return}let a=f,c=!1;for(const r of m){const p=r.apply({profileId:t,path:i,raw:a});p!==null&&(a=p,c=!0,e.applied.push({profileId:t,path:i,migration:r.description}))}c&&o.dryRun!==!0&&g(i,a),e.snapshots.push({profileId:t,path:i,manifest:a})}))}return e}l(x,"runProfileManifestMigrations");export{x as runProfileManifestMigrations};

package/dist/migrations/registry.d.ts

@@ -1,7 +0,0 @@
-import type { OnDiskMigrationLane, StateMigration } from './types.js';
-export declare const STATE_MIGRATIONS: readonly StateMigration[];
-export interface OnDiskMigrationIdentity {
-    readonly id: string;
-    readonly lane: OnDiskMigrationLane;
-}
-export declare function onDiskMigrationIdentity(): readonly OnDiskMigrationIdentity[];

package/dist/migrations/registry.js

@@ -1 +0,0 @@
-var i=Object.defineProperty;var t=(o,r)=>i(o,"name",{value:r,configurable:!0});import{surfacesFrontmatterMigration as e}from"./001-surfaces-frontmatter.js";import{profileProjectMemoryMigration as n}from"./002-profile-project-memory.js";import{repositoryRootMemoryIdentityMigration as m}from"./003-repository-root-memory-identity/index.js";const a=[e,n,m];function y(){return a.filter(o=>o.lane!=="journaled").map(({id:o,lane:r})=>({id:o,lane:r}))}t(y,"onDiskMigrationIdentity");export{a as STATE_MIGRATIONS,y as onDiskMigrationIdentity};

package/dist/migrations/runner.d.ts

@@ -1,43 +0,0 @@
-import type { NodeMemoryTarget } from '../core/canvas/types.js';
-import { type CorpusDiscovery } from './corpus.js';
-import type { CorpusBlocker, CorpusIdentityRename, CorpusRepositoryDecision, CorpusStorePrefix, CorpusReferenceRewrite, OnDiskMigrationLane, StoreSnapshot } from './types.js';
-export type OnDiskMigrationPhase = 'not-started' | 'planned' | 'written';
-export interface OnDiskMigrationApplied {
-    store: string;
-    lane: OnDiskMigrationLane;
-    migration: string;
-    files: string[];
-}
-export interface OnDiskMigrationSkipped {
-    store: string;
-    relPath: string;
-    error: string;
-}
-export interface OnDiskMigrationRunResult {
-    profiles: number;
-    discovery: CorpusDiscovery;
-    snapshots: ReadonlyMap<string, StoreSnapshot>;
-    changed: number;
-    applied: OnDiskMigrationApplied[];
-    skipped: OnDiskMigrationSkipped[];
-    blocked: boolean;
-    blockers: CorpusBlocker[];
-    corpusPhase: OnDiskMigrationPhase;
-    wrote: {
-        profileManifests: string[];
-        documents: string[];
-        corpusConsumers: string[];
-        corpusIdentities: string[];
-    };
-    repositories: CorpusRepositoryDecision[];
-    storePrefixes: CorpusStorePrefix[];
-    renames: CorpusIdentityRename[];
-    references: CorpusReferenceRewrite[];
-    finalVerificationSucceeded: boolean;
-    dryRun: boolean;
-}
-export declare function runOnDiskMigrations(opts: {
-    dryRun?: boolean;
-    explicitDirs?: readonly string[];
-    nodes: readonly NodeMemoryTarget[];
-}): Promise<OnDiskMigrationRunResult>;

package/dist/migrations/runner.js

@@ -1 +0,0 @@
-var b=Object.defineProperty;var l=(n,t)=>b(n,"name",{value:t,configurable:!0});import{profileSpace as y}from"../core/layout.js";import{listStoredProfiles as C}from"../core/scoped-state/profiles.js";import{resetScopeCache as R,userScopeRoot as S}from"../core/scope.js";import{buildCorpusSnapshot as g,discoverCorpus as v,loadCorpusSnapshots as k,parseFailureBlockers as M,runCorpusMigrations as P}from"./corpus.js";import{runConvergentMigrations as x}from"./convergent.js";async function j(n){const t=n.dryRun===!0,i=[],u=[],f=C(S()).map(({profileId:e,manifest:r})=>({profileId:e,manifest:r,path:y(r.grantee??"app:terminal",e).memory}));R();const s=await v({profiles:f,explicitDirs:n.explicitDirs,nodes:n.nodes}),p=[],d=new Map;for(const e of s.stores){if(!e.writable)continue;const r=x(e.descriptor.storeRoot,{dryRun:t});d.set(e.key,r.snapshot);for(const c of r.applied)i.push({store:e.key,lane:"convergent",migration:c.migration,files:c.files});for(const c of r.skipped)p.push({storeRoot:e.key,...c})}const a=k(s,{preloaded:d});p.push(...a.skipped);for(const e of p)u.push({store:e.storeRoot,relPath:e.relPath,error:e.error});const o=P(g(s,a.snapshots),{dryRun:t,blockers:[...s.blockers,...M(p)],rebuild:l(()=>g(s,k(s).snapshots),"rebuild")}),m=o.wrote.consumers.length>0||o.wrote.identities.length>0;if(m)for(const e of o.planned){const r=[...e.consumers,...e.identities];r.length>0&&i.push({store:"corpus",lane:"corpus",migration:e.migration,files:r})}const w=t?"planned":m?"written":"not-started",h=o.blocked;return{profiles:f.length,discovery:s,snapshots:a.snapshots,changed:i.reduce((e,r)=>e+r.files.length,0),applied:i,skipped:u,blocked:h,blockers:o.blockers,corpusPhase:w,wrote:{profileManifests:[],documents:i.filter(e=>e.lane==="convergent").flatMap(e=>e.files),corpusConsumers:o.wrote.consumers,corpusIdentities:o.wrote.identities},repositories:o.repositories,storePrefixes:o.storePrefixes,renames:o.renames,references:o.references,finalVerificationSucceeded:o.verified&&!h,dryRun:t}}l(j,"runOnDiskMigrations");export{j as runOnDiskMigrations};