@north-light/crouter 0.3.318 → 0.3.320

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

@@ -1,161 +1 @@
-// 001 — the surfaces cut's frontmatter codemod. Folds the four old routing
-// fields (`system-prompt-visibility`, `file-read-visibility`, `applies-to`,
-// `read-when`) into explicit `surfaces` entries and bakes INDEX boot ceilings
-// into each doc's boot rung (per store).
-//
-// Only docs with a valid substrate `kind` are touched. The old-schema parsing
-// and ceiling walk are FROZEN COPIES of the pre-cut substrate code: the live
-// versions are deleted with the cut, and this migration must keep reading the
-// old format for as long as it ships.
-//
-// Serialization is a textual splice: the dead keys' exact line spans are cut
-// from the raw frontmatter and a rendered `surfaces:` block is appended, so
-// every other byte survives verbatim and a migrated doc's diff shows only the
-// dead fields dying and `surfaces` appearing — never unrelated reformatting
-// (re-serializing through the Document API would unfold folded scalars). Each splice is validated by re-parsing: the result must
-// equal the original record minus the dead fields plus `surfaces`, or the
-// migration throws naming the doc.
-import { parse as parseYaml } from 'yaml';
-import { parseFrontmatterGeneric } from '../core/frontmatter.js';
-import { appendRenderedKey, dropTopLevelKeys, proveFrontmatterRoundTrip, rebuildDocSource, } from './frontmatter-splice.js';
-const OLD_FIELDS = ['system-prompt-visibility', 'file-read-visibility', 'applies-to', 'read-when'];
-// Frozen old-schema parsing (pre-cut substrate/schema.ts semantics).
-const RUNGS = ['none', 'name', 'preview', 'content'];
-function rungRank(r) {
-    return RUNGS.indexOf(r);
-}
-/** Absent/invalid rung falls to the old parser's neutral floor `none`. */
-function parseRung(v) {
-    return typeof v === 'string' && RUNGS.includes(v) ? v : 'none';
-}
-function parseAppliesTo(v) {
-    if (typeof v === 'string')
-        return v.trim() === '' ? [] : [v];
-    if (Array.isArray(v))
-        return v.filter((g) => typeof g === 'string' && g.trim() !== '');
-    return [];
-}
-function parsePredicate(v) {
-    return v !== null && typeof v === 'object' && !Array.isArray(v) ? v : undefined;
-}
-/** Strip the optional `NN-` ordering prefix from every segment (identity
- *  normalization — frozen copy of normalizeDocName). */
-function normalizeName(name) {
-    return name
-        .split('/')
-        .map((s) => s.replace(/^\d{2}-/, ''))
-        .join('/');
-}
-function classify(doc) {
-    const fm = doc.frontmatter;
-    if (fm === null)
-        return null;
-    if (fm['kind'] !== 'knowledge' && fm['kind'] !== 'preference')
-        return null;
-    const fallback = normalizeName(doc.relPath.replace(/\.md$/, ''));
-    const rawName = fm['name'];
-    const name = typeof rawName === 'string' && rawName.trim() !== '' ? normalizeName(rawName.trim()) : fallback;
-    return {
-        doc,
-        name,
-        spv: parseRung(fm['system-prompt-visibility']),
-        fv: parseRung(fm['file-read-visibility']),
-        appliesTo: parseAppliesTo(fm['applies-to']),
-        readWhen: parsePredicate(fm['read-when']),
-        hasOldFields: OLD_FIELDS.some((k) => k in fm),
-    };
-}
-// Frozen boot-ceiling walk (pre-cut substrate/ceiling.ts), per store: a
-// directory INDEX's rung caps every descendant's boot rung; the migration
-// bakes the effective (post-ceiling) rung into each doc so the rendered boot
-// tree is preserved once the ceiling machinery is deleted.
-function buildCeiling(docs) {
-    const m = new Map();
-    for (const d of docs) {
-        if (d.name !== 'INDEX' && !d.name.endsWith('/INDEX'))
-            continue;
-        const dir = d.name === 'INDEX' ? '' : d.name.slice(0, d.name.length - '/INDEX'.length);
-        if (!m.has(dir))
-            m.set(dir, d.spv);
-    }
-    return m;
-}
-function effectiveBootRung(d, ceiling) {
-    let rung = d.spv;
-    const parts = d.name.split('/');
-    parts.pop();
-    for (let i = parts.length; i > 0; i--) {
-        const idx = ceiling.get(parts.slice(0, i).join('/'));
-        if (idx !== undefined && rungRank(idx) < rungRank(rung))
-            rung = idx;
-    }
-    return rung;
-}
-/** Old read globs also matched the path RELATIVE to the doc's store's owning
- *  repo dir. A glob containing `/` that starts with neither `/`, `**`, nor
- *  `./` could ONLY match through that relative target (absolute paths start
- *  with `/`, basenames carry no `/`), so it becomes `./`-anchored — the new
- *  schema's one relative spelling. Every other shape keeps its meaning as-is. */
-function anchorReadGlob(g) {
-    const t = g.trim();
-    if (!t.includes('/'))
-        return t;
-    if (t.startsWith('/') || t.startsWith('**') || t.startsWith('./'))
-        return t;
-    return `./${t}`;
-}
-function planEntries(d, bootRung) {
-    const entries = [];
-    if (d.spv !== 'none' && bootRung !== 'none')
-        entries.push({ on: 'boot', at: bootRung });
-    if (d.fv !== 'none') {
-        // The old `.` token meant both "deliver on workspace open" and "deliver on
-        // any read inside the owning repo" — spelled as two explicit entries.
-        if (d.appliesTo.some((g) => g.trim() === '.')) {
-            entries.push({ on: 'workspace-open', at: d.fv });
-            entries.push({ on: 'read', match: './**', at: d.fv });
-        }
-        const globs = d.appliesTo.filter((g) => g.trim() !== '.').map(anchorReadGlob);
-        if (globs.length > 0)
-            entries.push({ on: 'read', match: globs.length === 1 ? globs[0] : globs, at: d.fv });
-        // Old read matching was pathMatch OR frontmatterMatch, so a separate entry
-        // is behavior-preserving.
-        if (d.readWhen !== undefined)
-            entries.push({ on: 'read', 'match-frontmatter': d.readWhen, at: d.fv });
-    }
-    return entries;
-}
-// Serialization: cut the dead keys' exact line spans out of the raw
-// frontmatter text, append the rendered `surfaces:` block, re-parse to prove
-// the splice is meaning-preserving.
-function migratedYaml(rawYaml, entries, docPath) {
-    let out = dropTopLevelKeys(rawYaml, OLD_FIELDS, docPath);
-    if (entries.length > 0)
-        out = appendRenderedKey(out, 'surfaces', entries, docPath);
-    else
-        out = out.replace(/\r?\n$/, '');
-    const expected = { ...parseYaml(rawYaml) };
-    for (const k of OLD_FIELDS)
-        delete expected[k];
-    if (entries.length > 0)
-        expected['surfaces'] = entries;
-    proveFrontmatterRoundTrip(out, expected, docPath);
-    return out;
-}
-export const surfacesFrontmatterMigration = {
-    id: '001-surfaces-frontmatter',
-    lane: 'convergent',
-    description: 'surfaces frontmatter: fold visibility/applies-to/read-when routing into surfaces entries',
-    apply(store) {
-        const docs = store.docs.map(classify).filter((d) => d !== null);
-        const ceiling = buildCeiling(docs);
-        const changes = [];
-        for (const d of docs) {
-            if (!d.hasOldFields)
-                continue;
-            const newYaml = migratedYaml(parseFrontmatterGeneric(d.doc.source).raw, planEntries(d, effectiveBootRung(d, ceiling)), d.doc.path);
-            changes.push({ path: d.doc.path, after: rebuildDocSource(d.doc.source, newYaml, d.doc.path) });
-        }
-        return changes;
-    },
-};
+var u=Object.defineProperty;var o=(e,n)=>u(e,"name",{value:n,configurable:!0});import{parse as m}from"yaml";import{parseFrontmatterGeneric as d}from"../core/frontmatter.js";import{appendRenderedKey as h,dropTopLevelKeys as g,proveFrontmatterRoundTrip as y,rebuildDocSource as b}from"./frontmatter-splice.js";const a=["system-prompt-visibility","file-read-visibility","applies-to","read-when"],f=["none","name","preview","content"];function p(e){return f.indexOf(e)}o(p,"rungRank");function c(e){return typeof e=="string"&&f.includes(e)?e:"none"}o(c,"parseRung");function v(e){return typeof e=="string"?e.trim()===""?[]:[e]:Array.isArray(e)?e.filter(n=>typeof n=="string"&&n.trim()!==""):[]}o(v,"parseAppliesTo");function w(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0}o(w,"parsePredicate");function l(e){return e.split("/").map(n=>n.replace(/^\d{2}-/,"")).join("/")}o(l,"normalizeName");function k(e){const n=e.frontmatter;if(n===null||n.kind!=="knowledge"&&n.kind!=="preference")return null;const t=l(e.relPath.replace(/\.md$/,"")),r=n.name,i=typeof r=="string"&&r.trim()!==""?l(r.trim()):t;return{doc:e,name:i,spv:c(n["system-prompt-visibility"]),fv:c(n["file-read-visibility"]),appliesTo:v(n["applies-to"]),readWhen:w(n["read-when"]),hasOldFields:a.some(s=>s in n)}}o(k,"classify");function D(e){const n=new Map;for(const t of e){if(t.name!=="INDEX"&&!t.name.endsWith("/INDEX"))continue;const r=t.name==="INDEX"?"":t.name.slice(0,t.name.length-6);n.has(r)||n.set(r,t.spv)}return n}o(D,"buildCeiling");function N(e,n){let t=e.spv;const r=e.name.split("/");r.pop();for(let i=r.length;i>0;i--){const s=n.get(r.slice(0,i).join("/"));s!==void 0&&p(s)<p(t)&&(t=s)}return t}o(N,"effectiveBootRung");function W(e){const n=e.trim();return!n.includes("/")||n.startsWith("/")||n.startsWith("**")||n.startsWith("./")?n:`./${n}`}o(W,"anchorReadGlob");function E(e,n){const t=[];if(e.spv!=="none"&&n!=="none"&&t.push({on:"boot",at:n}),e.fv!=="none"){e.appliesTo.some(i=>i.trim()===".")&&(t.push({on:"workspace-open",at:e.fv}),t.push({on:"read",match:"./**",at:e.fv}));const r=e.appliesTo.filter(i=>i.trim()!==".").map(W);r.length>0&&t.push({on:"read",match:r.length===1?r[0]:r,at:e.fv}),e.readWhen!==void 0&&t.push({on:"read","match-frontmatter":e.readWhen,at:e.fv})}return t}o(E,"planEntries");function F(e,n,t){let r=g(e,a,t);n.length>0?r=h(r,"surfaces",n,t):r=r.replace(/\r?\n$/,"");const i={...m(e)};for(const s of a)delete i[s];return n.length>0&&(i.surfaces=n),y(r,i,t),r}o(F,"migratedYaml");const x={id:"001-surfaces-frontmatter",lane:"convergent",description:"surfaces frontmatter: fold visibility/applies-to/read-when routing into surfaces entries",apply(e){const n=e.docs.map(k).filter(i=>i!==null),t=D(n),r=[];for(const i of n){if(!i.hasOldFields)continue;const s=F(d(i.doc.source).raw,E(i,N(i,t)),i.doc.path);r.push({path:i.doc.path,after:b(i.doc.source,s,i.doc.path)})}return r}};export{x as surfacesFrontmatterMigration};

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

@@ -1,72 +1 @@
-// 002 — profile projects gain an explicit memory value. Historical manifests
-// stored `projects` as bare directory strings; the current contract is
-// `{ path, memory }`, where memory caps automatic boot/workspace-open
-// disclosure from that project's stores.
-//
-// Mapping: a string entry on the root profile becomes `preview` (root is an
-// aggregate identity — it points at everything and should not absorb every
-// project's full corpus), every other profile's string entries become
-// `content` (they were authored as that profile's own working context).
-// Root is classified ONLY by the fixed profile directory id: a manifest
-// `name` is mutable, so `name === 'root'` would misclassify a renamed profile.
-//
-// Mixed manifests converge: already-valid objects pass through byte-identical
-// and only string entries convert. Anything else — a non-array `projects`, a
-// non-string/non-object entry, an object without a path, an unknown memory
-// value — throws naming the file, because a guessed cap silently widens or
-// narrows what every node under that profile is shown.
-import { PROFILE_PROJECT_MEMORY_VALUES } from '../api/dto/profiles.js';
-import { usage } from '../core/errors.js';
-/** Frozen copy of `ROOT_PROFILE_ID` (core/profiles/manifest.ts). Migrations
- *  stay out of that module's import graph — its readers reject the very
- *  manifests this lane exists to convert. */
-const ROOT_PROFILE_ID = 'root-00000000';
-function malformed(input, detail) {
-    return usage(`profile manifest cannot be migrated: ${detail}`, {
-        received: input.path,
-        field: 'projects',
-        next: `Fix ${input.path} by hand — every project entry is a string (pre-migration) or {"path": "/abs/dir", "memory": one of ${PROFILE_PROJECT_MEMORY_VALUES.join(', ')}} — then re-run \`crtr sys migrate\`.`,
-    });
-}
-function isMemory(value) {
-    return typeof value === 'string' && PROFILE_PROJECT_MEMORY_VALUES.includes(value);
-}
-export const profileProjectMemoryMigration = {
-    id: '002-profile-project-memory',
-    lane: 'profile-manifest',
-    description: 'profile projects carry an explicit memory value',
-    apply(input) {
-        const stored = input.raw['projects'];
-        if (!Array.isArray(stored)) {
-            throw malformed(input, `projects is ${stored === undefined ? 'missing' : typeof stored}, not an array`);
-        }
-        const legacyMemory = input.profileId === ROOT_PROFILE_ID ? 'preview' : 'content';
-        let converted = false;
-        const projects = stored.map((entry) => {
-            if (typeof entry === 'string') {
-                if (entry.trim() === '')
-                    throw malformed(input, 'a project entry is an empty path');
-                converted = true;
-                return { path: entry, memory: legacyMemory };
-            }
-            if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
-                throw malformed(input, `a project entry is ${entry === null ? 'null' : typeof entry}`);
-            }
-            const { path, memory } = entry;
-            if (typeof path !== 'string' || path.trim() === '') {
-                throw malformed(input, `a project entry has no path: ${JSON.stringify(entry)}`);
-            }
-            if (!isMemory(memory)) {
-                throw malformed(input, `project ${path} has an unknown memory value: ${JSON.stringify(memory)}`);
-            }
-            // Byte-identical pass-through: an already-valid entry keeps whatever
-            // else it carries, so re-running plans no change.
-            return entry;
-        });
-        if (!converted)
-            return null;
-        // Spread preserves the manifest's stored key order, so the rewrite's diff
-        // is the projects array and nothing else.
-        return { ...input.raw, projects };
-    },
-};
+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.js

@@ -1,231 +1,11 @@
-import { join, relative } from 'node:path';
-import { parse as parseYaml, stringify } from 'yaml';
-import { realpathOrSelf } from '../../core/fs-utils.js';
-import { parseFrontmatterGeneric } from '../../core/frontmatter.js';
-import { localNameFromPath } from '../../core/memory/identity.js';
-import { appendRenderedKey, dropSequenceItems, dropTopLevelKeys, proveFrontmatterRoundTrip, rebuildDocSource, splitDocSource, } from '../frontmatter-splice.js';
-function record(value) {
-    return value !== null && typeof value === 'object' && !Array.isArray(value)
-        ? value
-        : null;
-}
-function surfaceEntries(frontmatter) {
-    const raw = frontmatter?.['surfaces'];
-    if (raw === undefined)
-        return [];
-    if (!Array.isArray(raw))
-        return null;
-    return raw.map(record).filter((entry) => entry !== null);
-}
-function matchIncludesOwnerTree(match) {
-    return match === './**' || (Array.isArray(match) && match.includes('./**'));
-}
-function hasWorkspaceOpen(entries) {
-    return entries.some((entry) => entry['on'] === 'workspace-open' && entry['at'] === 'content');
-}
-function hasOwnerRead(entries) {
-    return entries.some((entry) => entry['on'] === 'read'
-        && entry['at'] === 'content'
-        && matchIncludesOwnerTree(entry['match']));
-}
-function hasCompleteFrontDoor(frontmatter) {
-    const entries = surfaceEntries(frontmatter);
-    return entries !== null && hasWorkspaceOpen(entries) && hasOwnerRead(entries);
-}
-function conflictingRootWorkspaceOpen(frontmatter) {
-    const entries = surfaceEntries(frontmatter);
-    if (entries === null)
-        return true;
-    return entries.some((entry) => {
-        if (entry['on'] !== 'workspace-open')
-            return false;
-        return entry['at'] !== 'content'
-            || Object.hasOwn(entry, 'match')
-            || Object.hasOwn(entry, 'gate')
-            || Object.hasOwn(entry, 'match-frontmatter');
-    });
-}
-function rootStoreKey(repositoryRoot, prefixes) {
-    for (const [storeKey, facts] of prefixes) {
-        if (facts.repositoryRoot === repositoryRoot && facts.ownerRelativePath === '')
-            return storeKey;
-    }
-    return realpathOrSelf(join(repositoryRoot, '.crouter', 'memory'));
-}
-function repositoryRelativePath(repositoryRoot, filePath) {
-    return relative(repositoryRoot, filePath).replace(/\\/g, '/');
-}
-function frontDoorBlocker(message, paths, repositoryRoot) {
-    return {
-        kind: 'front-door',
-        message,
-        storeRoot: join(repositoryRoot, '.crouter', 'memory'),
-        ...(paths.length === 1 ? { path: paths[0] } : {}),
-        paths: [...paths],
-    };
-}
-export function planFrontDoors(repositories, prefixes, corpus, finalNameOf) {
-    const plans = [];
-    const blockers = [];
-    for (const repository of repositories) {
-        const rootDocPath = join(repository.repositoryRoot, '.crouter', 'memory', 'INDEX.md');
-        const rootRealPath = realpathOrSelf(rootDocPath);
-        const rootKey = rootStoreKey(repository.repositoryRoot, prefixes);
-        let rootDoc = null;
-        const workspaceOpenDocs = new Map();
-        const candidates = new Map();
-        for (const storeKey of repository.storeKeys) {
-            const facts = prefixes.get(storeKey);
-            if (facts === undefined || facts.repositoryRoot !== repository.repositoryRoot)
-                continue;
-            const store = facts.store ?? corpus.store(storeKey);
-            if (store === undefined || !store.writable)
-                continue;
-            if (store.descriptor.scope !== 'project' || store.descriptor.plugin !== undefined)
-                continue;
-            for (const doc of store.snapshot.docs) {
-                const docRealPath = realpathOrSelf(doc.path);
-                if (docRealPath === rootRealPath) {
-                    rootDoc = doc;
-                    continue;
-                }
-                if (facts.nestedDeclarationAction === 'synthetic-index-removed'
-                    && localNameFromPath(doc.relPath) === '')
-                    continue;
-                const entry = { doc, storeKey, realPath: docRealPath };
-                const entries = surfaceEntries(doc.frontmatter);
-                if (entries?.some((surface) => surface['on'] === 'workspace-open' && surface['at'] === 'content')) {
-                    workspaceOpenDocs.set(docRealPath, entry);
-                }
-                if (!hasCompleteFrontDoor(doc.frontmatter))
-                    continue;
-                candidates.set(docRealPath, entry);
-            }
-        }
-        const leaves = [...candidates.values()];
-        const repositoryBlockers = [];
-        if (leaves.length > 1) {
-            const paths = leaves.map((leaf) => leaf.doc.path);
-            repositoryBlockers.push(frontDoorBlocker(`repository ${repository.repositoryRoot} has more than one non-root document carrying the complete workspace front door (${paths.join(', ')}) — keep one source guide as the transfer source, remove the other workspace-open entries, and re-run`, paths, repository.repositoryRoot));
-        }
-        const incompleteWorkspaceOpenDocs = [...workspaceOpenDocs.values()]
-            .filter((entry) => !candidates.has(entry.realPath));
-        if (incompleteWorkspaceOpenDocs.length > 0) {
-            const paths = incompleteWorkspaceOpenDocs.map((entry) => entry.doc.path);
-            repositoryBlockers.push(frontDoorBlocker(`repository ${repository.repositoryRoot} has non-root workspace-open documents without the complete owner-read pair (${paths.join(', ')}) — complete exactly one legacy front door or remove these workspace-open entries, then re-run`, paths, repository.repositoryRoot));
-        }
-        if (rootDoc !== null && conflictingRootWorkspaceOpen(rootDoc.frontmatter)) {
-            const paths = [rootDoc.path, ...leaves.map((leaf) => leaf.doc.path)];
-            repositoryBlockers.push(frontDoorBlocker(`repository-root guide ${rootDoc.path} carries a workspace-open route that migration cannot make authoritative without changing its predicate — make every root workspace-open entry exactly {on: workspace-open, at: content} and re-run`, paths, repository.repositoryRoot));
-        }
-        const leaf = leaves.length === 1 ? leaves[0] : null;
-        const leafCanonicalName = leaf === null ? null : finalNameOf(leaf.realPath);
-        if (leaf !== null && leafCanonicalName === undefined) {
-            repositoryBlockers.push(frontDoorBlocker(`legacy workspace front door ${leaf.doc.path} has no provable final canonical name — repair its identity blocker and re-run`, [leaf.doc.path], repository.repositoryRoot));
-        }
-        if (repositoryBlockers.length > 0) {
-            blockers.push(...repositoryBlockers);
-            continue;
-        }
-        const rootComplete = rootDoc !== null && hasCompleteFrontDoor(rootDoc.frontmatter);
-        const rootAction = rootDoc === null
-            ? 'created'
-            : rootComplete
-                ? 'kept'
-                : 'completed';
-        const relativeLeafPath = leaf === null
-            ? null
-            : repositoryRelativePath(repository.repositoryRoot, leaf.doc.path);
-        const action = relativeLeafPath !== null
-            ? `transferred-from:${relativeLeafPath}`
-            : rootComplete
-                ? 'kept-root'
-                : 'created-root';
-        plans.push({
-            repositoryRoot: repository.repositoryRoot,
-            storeKey: rootKey,
-            rootDocPath,
-            rootAction,
-            leafDocPath: leaf?.doc.path ?? null,
-            leafStoreKey: leaf?.storeKey ?? null,
-            leafCanonicalName: leafCanonicalName ?? null,
-            action,
-        });
-    }
-    return { plans, blockers };
-}
-/** New repository-root INDEX.md source. `leafCanonicalName` null yields the generic minimal root body. */
-export function rootIndexSource(namespace, leafCanonicalName) {
-    const label = namespace.split('/').at(-1) ?? namespace;
-    const body = leafCanonicalName === null
-        ? `# ${label}\n\nThis project's memory store. Every document here answers at \`${namespace}/<local name>\`.\n`
-        : `# ${label}\n\nThis project's memory store. Every document here answers at \`${namespace}/<local name>\`. Read [[${leafCanonicalName}]] for the detailed project guide.\n`;
-    return [
-        '---',
-        `namespace: ${JSON.stringify(namespace)}`,
-        'kind: knowledge',
-        `when-and-why-to-read: When working in \`${namespace}\`, 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',
-        '---',
-        '',
-        body,
-    ].join('\n');
-}
-function sourceWithFrontmatter(source) {
-    return parseFrontmatterGeneric(source).data === null ? `---\n\n---\n${source}` : source;
-}
-function parsedYamlRecord(rawYaml, docPath) {
-    let parsed;
-    try {
-        parsed = parseYaml(rawYaml === '' ? '{}' : rawYaml);
-    }
-    catch (error) {
-        throw new Error(`front-door migration: unparseable frontmatter in ${docPath}`, { cause: error });
-    }
-    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
-        throw new Error(`front-door migration: frontmatter is not a mapping in ${docPath}`);
-    }
-    return parsed;
-}
-/** Add the missing half or halves of the root front-door pair to a complete document source. */
-export function completeRootFrontDoor(source, docPath) {
-    const withFrontmatter = sourceWithFrontmatter(source);
-    const { rawYaml } = splitDocSource(withFrontmatter, docPath);
-    const before = parsedYamlRecord(rawYaml, docPath);
-    const rawSurfaces = before['surfaces'];
-    if (rawSurfaces !== undefined && !Array.isArray(rawSurfaces)) {
-        throw new Error(`front-door migration: surfaces is not a sequence in ${docPath}`);
-    }
-    const surfaces = rawSurfaces === undefined
-        ? []
-        : rawSurfaces.map((entry) => record(entry) ?? entry);
-    const entries = surfaces.filter((entry) => record(entry) !== null);
-    const merged = [...surfaces];
-    if (!hasWorkspaceOpen(entries))
-        merged.push({ on: 'workspace-open', at: 'content' });
-    if (!hasOwnerRead(entries))
-        merged.push({ on: 'read', match: './**', at: 'content' });
-    if (merged.length === surfaces.length)
-        return withFrontmatter;
-    let newYaml = rawYaml;
-    if (rawSurfaces !== undefined)
-        newYaml = dropTopLevelKeys(newYaml, ['surfaces'], docPath);
-    newYaml = newYaml === ''
-        ? stringify({ surfaces: merged }, { lineWidth: 0 }).replace(/\r?\n$/, '')
-        : appendRenderedKey(newYaml, 'surfaces', merged, docPath);
-    proveFrontmatterRoundTrip(newYaml, { ...before, surfaces: merged }, docPath);
-    return rebuildDocSource(withFrontmatter, newYaml, docPath);
-}
-/** Remove every workspace-open entry while preserving the body and every retained authored YAML byte. */
-export function demoteLeafSurfaces(source, docPath) {
-    if (parseFrontmatterGeneric(source).data === null)
-        return source;
-    const { rawYaml } = splitDocSource(source, docPath);
-    const newYaml = dropSequenceItems(rawYaml, 'surfaces', (item) => record(item)?.['on'] === 'workspace-open', docPath);
-    return newYaml === rawYaml ? source : rebuildDocSource(source, newYaml, docPath);
-}
+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};