@north-light/crouter 0.3.318 → 0.3.319

package/dist/core/memory-resolver.js

@@ -1,611 +1,2 @@
-import { envNodeId, envProfileId } from '../shared/env.js';
-import { dirname, join, relative, sep } from 'node:path';
-import { readdirSync } from 'node:fs';
-import { CRTR_DIR_NAME } from '../types.js';
-import { pathExists, readText, realpathOrSelf, walkFiles } from './fs-utils.js';
-import { parseFrontmatterGeneric } from './frontmatter.js';
-import { interpolateNodePaths } from './canvas/paths.js';
-import { listInstalledPlugins, listInstalledPluginsInRoot } from './resolver.js';
-import { notFound, usage } from './errors.js';
-import { warn } from './output.js';
-import { NEUTRAL_PROJECT_MEMORY, pluginMemoryDir, projectScopeRoots, projectScopeRootsWithMemory, scopeMemoryDir } from './scope.js';
-import { effectiveDocKind } from './substrate/schema.js';
-import { INDEX_SEGMENT, canonicalSegments, composeCanonicalName, localNameFromPath, normalizeNameSegment, representationForPath, resolveLocalName, routingAnchorFor, validateNamespace, } from './memory/identity.js';
-import { loadProfileManifest, profileMemoryDir } from './profiles/manifest.js';
-import { memoryDir as nodeMemoryDir } from './runtime/memory.js';
-import { descendantStoreRoots } from './nested-stores.js';
-import { associateRepository } from './memory/repository-association.js';
-/** The target the ambient process describes: cwd + the two env seams every
- *  profile/node-aware memory path reads through (`CRTR_PROFILE_ID`,
- *  `CRTR_NODE_ID`). */
-export function ambientMemoryTarget() {
-    return {
-        cwd: process.cwd(),
-        profileId: envProfileId() || null,
-        nodeId: envNodeId() || null,
-    };
-}
-/** The selected profile id from the process env, or '' when none. */
-function selectedProfileId() {
-    return ambientMemoryTarget().profileId ?? '';
-}
-// Store discovery: which physical stores a target sees, in what order, and
-// whether each one's namespace lets it mount.
-/** The memory scopes in resolution precedence: node > project stack > profile >
- *  user > builtin. Node is included only when the target names one and ranks
- *  NEAREST — a node doc overrides any wider scope. Project is included only when
- *  a project scope exists for the target's cwd (or its profile's project stack);
- *  profile is included only when the target has one. A single `scope` narrows to
- *  just that scope. */
-function scopesInPrecedence(target, scope) {
-    if (scope)
-        return [scope];
-    const out = [];
-    if (target.nodeId)
-        out.push('node');
-    if (projectScopeRoots(target.cwd, target.profileId).length > 0)
-        out.push('project');
-    if (target.profileId)
-        out.push('profile');
-    out.push('user');
-    out.push('builtin');
-    return out;
-}
-/** Resolve a project store through its repository-root declaration. */
-function projectStoreDescriptor(ownerDir, storeRoot, projectMemory) {
-    const base = { scope: 'project', storeRoot, ownerDir, projectMemory };
-    if (!pathExists(storeRoot))
-        return { ...base, namespace: '', mountStatus: 'absent' };
-    const association = associateRepository(ownerDir);
-    if (!association.ok) {
-        const remedy = `run \`crtr sys migrate --dir ${ownerDir}\``;
-        if (association.code === 'no-project-root') {
-            return {
-                ...base,
-                namespace: '',
-                mountStatus: 'undeclared',
-                mountFailure: 'association',
-                diagnostic: `project memory store at ${storeRoot} has no repository root declaring \`namespace:\` — ${remedy}`,
-            };
-        }
-        return {
-            ...base,
-            namespace: '',
-            mountStatus: 'invalid',
-            mountFailure: 'association',
-            diagnostic: `project memory store at ${storeRoot} cannot be associated: ${association.reason} — ${remedy}`,
-        };
-    }
-    const { association: repository } = association;
-    const repositoryFields = {
-        namespacePath: repository.declarationPath,
-        repositoryRoot: repository.repositoryRoot,
-        repositoryKey: repository.repositoryKey,
-        ownerRelativePath: repository.ownerRelativePath,
-    };
-    const rootIndex = repository.declarationPath;
-    const nested = repository.ownerRelativePath !== '';
-    const remedy = `run \`crtr sys migrate --dir ${repository.repositoryRoot}\``;
-    const missingDiagnostic = nested
-        ? `nested project memory store at ${storeRoot} takes its identity from ${rootIndex}, which is missing root ${INDEX_SEGMENT}.md declaring \`namespace:\` — ${remedy}`
-        : `project memory store has no root ${INDEX_SEGMENT}.md declaring \`namespace:\` — ${remedy}`;
-    if (!pathExists(rootIndex)) {
-        return {
-            ...base,
-            ...repositoryFields,
-            namespace: '',
-            mountStatus: 'undeclared',
-            mountFailure: 'undeclared-root',
-            diagnostic: missingDiagnostic,
-        };
-    }
-    let declared;
-    try {
-        declared = parseFrontmatterGeneric(readText(rootIndex)).data?.['namespace'];
-    }
-    catch (e) {
-        return {
-            ...base,
-            ...repositoryFields,
-            namespace: '',
-            mountStatus: 'invalid',
-            mountFailure: 'invalid-root',
-            diagnostic: `project memory store's ${rootIndex} does not parse (${firstLine(e)}) — ${remedy}`,
-        };
-    }
-    if (declared === undefined || declared === null || declared === '') {
-        const diagnostic = nested
-            ? `nested project memory store at ${storeRoot} takes its identity from ${rootIndex}, which declares no \`namespace:\` — ${remedy}`
-            : `project memory store's ${rootIndex} declares no \`namespace:\` — ${remedy}`;
-        return {
-            ...base,
-            ...repositoryFields,
-            namespace: '',
-            mountStatus: 'undeclared',
-            mountFailure: 'undeclared-root',
-            diagnostic,
-        };
-    }
-    // No coercion: a numeric or otherwise non-string declaration is a malformed
-    // store, not a namespace. Coercing it would mount a store whose namespace no
-    // memory command can then edit.
-    if (typeof declared !== 'string') {
-        return {
-            ...base,
-            ...repositoryFields,
-            namespace: '',
-            mountStatus: 'invalid',
-            mountFailure: 'invalid-root',
-            diagnostic: `project memory store declares a non-string \`namespace:\` (${JSON.stringify(declared)}) — quote it in ${rootIndex}, or ${remedy}`,
-        };
-    }
-    const valid = validateNamespace(declared);
-    if (!valid.ok) {
-        return {
-            ...base,
-            ...repositoryFields,
-            namespace: '',
-            mountStatus: 'invalid',
-            mountFailure: 'invalid-root',
-            diagnostic: `project memory store declares an invalid namespace \`${declared}\` (${valid.reason}) — ${remedy}`,
-        };
-    }
-    return {
-        ...base,
-        ...repositoryFields,
-        repositoryNamespace: declared,
-        namespace: composeCanonicalName(declared, repository.ownerRelativePath),
-        mountStatus: 'ready',
-    };
-}
-/** A store with no namespace of its own: user, profile, node, builtin. */
-function plainStoreDescriptor(scope, storeRoot) {
-    if (storeRoot === null) {
-        return { scope, storeRoot: '', namespace: '', mountStatus: 'absent', projectMemory: NEUTRAL_PROJECT_MEMORY };
-    }
-    return {
-        scope,
-        storeRoot,
-        namespace: '',
-        mountStatus: pathExists(storeRoot) ? 'ready' : 'absent',
-        projectMemory: NEUTRAL_PROJECT_MEMORY,
-    };
-}
-/** An installed plugin's store, mounted under the plugin's own name. */
-function pluginStoreDescriptor(plugin, scope, projectMemory) {
-    const storeRoot = pluginMemoryDir(plugin);
-    return {
-        scope,
-        storeRoot,
-        namespace: plugin.name,
-        plugin: plugin.name,
-        mountStatus: pathExists(storeRoot) ? 'ready' : 'absent',
-        projectMemory,
-    };
-}
-/** The exact project store owned by `ownerDir` — the `--dir` selector's store,
- *  loaded whatever its mount status so lint and migration can inspect a store
- *  the runtime refuses to mount. */
-export function openProjectMemoryStore(ownerDir) {
-    const owner = realpathOrSelf(ownerDir);
-    return projectStoreDescriptor(owner, join(owner, CRTR_DIR_NAME, 'memory'), NEUTRAL_PROJECT_MEMORY);
-}
-/** Every store a target sees, in precedence order: node, each project store
- *  nearest-first (its enabled plugins after it), then profile, user, builtin.
- *  One real store reached twice contributes once, at its first position. */
-export function memoryStoresInPrecedence(target, scope, includeDescendants = false, reportDiscovery = true) {
-    const out = [];
-    const projectStores = (crtrRoot, projectMemory) => {
-        out.push(projectStoreDescriptor(dirname(crtrRoot), join(crtrRoot, 'memory'), projectMemory));
-        for (const plugin of listInstalledPluginsInRoot('project', crtrRoot).filter((p) => p.enabled)) {
-            out.push(pluginStoreDescriptor(plugin, 'project', projectMemory));
-        }
-    };
-    for (const s of scopesInPrecedence(target, scope)) {
-        if (s === 'project') {
-            const annotated = projectScopeRootsWithMemory(target.cwd, target.profileId);
-            for (const { root, memory } of annotated)
-                projectStores(root, memory);
-            // Descendant stores rank after every ancestor source (and before
-            // profile): an ancestor doc always wins an equal-canonical tie against a
-            // nested one. They carry the neutral ceiling — no profile entry names
-            // them, and descendant discovery is off for every automatic delivery path.
-            if (includeDescendants) {
-                for (const root of descendantStoreRoots(annotated.map(({ root: r }) => r), reportDiscovery)) {
-                    projectStores(root, NEUTRAL_PROJECT_MEMORY);
-                }
-            }
-        }
-        else if (s === 'profile') {
-            const profileId = target.profileId ?? '';
-            if (profileId !== '') {
-                try {
-                    const { profileId: resolvedId } = loadProfileManifest(profileId);
-                    out.push(plainStoreDescriptor('profile', profileMemoryDir(resolvedId)));
-                }
-                catch {
-                    // Missing/deleted/invalid selected profile: no profile memory store.
-                }
-            }
-        }
-        else if (s === 'node') {
-            const nodeId = target.nodeId ?? '';
-            if (nodeId !== '')
-                out.push(plainStoreDescriptor('node', nodeMemoryDir(nodeId)));
-        }
-        else {
-            out.push(plainStoreDescriptor(s, scopeMemoryDir(s)));
-            for (const plugin of listInstalledPlugins(s).filter((p) => p.enabled)) {
-                out.push(pluginStoreDescriptor(plugin, s, NEUTRAL_PROJECT_MEMORY));
-            }
-        }
-    }
-    const seen = new Set();
-    const deduped = out.filter((store) => {
-        if (store.storeRoot === '')
-            return false;
-        const key = realpathOrSelf(store.storeRoot);
-        if (seen.has(key))
-            return false;
-        seen.add(key);
-        return true;
-    });
-    const collisions = new Map();
-    for (const store of deduped) {
-        if (store.scope !== 'project' ||
-            store.mountStatus !== 'ready' ||
-            store.repositoryRoot === undefined ||
-            store.ownerRelativePath === undefined)
-            continue;
-        const key = `${store.repositoryRoot}\u0000${store.ownerRelativePath}`;
-        const group = collisions.get(key);
-        if (group)
-            group.push(store);
-        else
-            collisions.set(key, [store]);
-    }
-    return deduped.map((store) => {
-        if (store.scope !== 'project' ||
-            store.mountStatus !== 'ready' ||
-            store.repositoryRoot === undefined ||
-            store.ownerRelativePath === undefined)
-            return store;
-        const group = collisions.get(`${store.repositoryRoot}\u0000${store.ownerRelativePath}`);
-        if (group === undefined || group.length < 2)
-            return store;
-        const owners = group.map((member) => member.ownerDir ?? member.storeRoot).join(', ');
-        return {
-            ...store,
-            mountStatus: 'invalid',
-            mountFailure: 'collision',
-            diagnostic: `project memory stores at ${owners} normalize to the same effective prefix \`${store.namespace}\` — rename one owner directory`,
-        };
-    });
-}
-/** The native (non-plugin) MOUNTED store dirs in resolution precedence.
- *  Addresses a store directly when the document itself may be absent, which is
- *  how a DELETED doc's revision log is still found: history outlives the doc,
- *  so its lookup cannot go through document resolution. */
-export function nativeMemoryStoresInPrecedence(scope, includeDescendants = false) {
-    return memoryStoresInPrecedence(ambientMemoryTarget(), scope, includeDescendants)
-        .filter((store) => store.mountStatus === 'ready' && store.scope !== 'builtin' && store.plugin === undefined)
-        .map((store) => ({ scope: store.scope, memoryDir: store.storeRoot, store }));
-}
-// Document loading: one store's markdown files become canonically-identified
-// documents.
-function firstLine(e) {
-    return (e instanceof Error ? e.message : String(e)).split('\n')[0] ?? '';
-}
-/** Load one markdown file as a document of `store`, or null when it has no
- *  canonical identity — a root `INDEX.md` in a store without a namespace, which
- *  would compose to the empty name. */
-function loadMemoryDoc(store, path, physicalRelativePath) {
-    const { data, body } = parseFrontmatterGeneric(readText(path));
-    const pathLocal = localNameFromPath(physicalRelativePath);
-    const representation = representationForPath(physicalRelativePath);
-    // A store's root INDEX.md is the store's own document: its identity is the
-    // namespace itself, never an explicit `name` (lint rejects one there).
-    const localName = pathLocal === '' ? '' : resolveLocalName(data, pathLocal);
-    const name = composeCanonicalName(store.namespace, localName);
-    if (name === '')
-        return null;
-    return {
-        name,
-        localName,
-        scope: store.scope,
-        path,
-        root: store.storeRoot,
-        physicalRelativePath,
-        representation,
-        routingAnchor: routingAnchorFor(name, representation),
-        store,
-        frontmatter: data,
-        body,
-        projectMemory: store.projectMemory,
-        ...(store.plugin === undefined ? {} : { plugin: store.plugin }),
-    };
-}
-/** Within one store, `foo/INDEX.md` deterministically precedes `foo.md` for the
- *  same canonical identity: the directory form physically fronts the directory.
- *  Lint errors on the pair and every mutation refuses it, but a read still has
- *  one answer. */
-function compareDocs(a, b) {
-    const byName = a.name.localeCompare(b.name);
-    if (byName !== 0)
-        return byName;
-    if (a.representation !== b.representation)
-        return a.representation === 'directory-index' ? -1 : 1;
-    return a.physicalRelativePath.localeCompare(b.physicalRelativePath);
-}
-/** Every document in one store, sorted by canonical identity. SKILL.md bundles
- *  are Agent Skills, not memory docs. Enumeration stops at a nested `.crouter/`:
- *  that is another store's mount point, never this store's content. */
-export function loadStoreMemoryDocs(store, quiet = false) {
-    if (store.storeRoot === '' || !pathExists(store.storeRoot))
-        return [];
-    const docs = [];
-    for (const path of walkFiles(store.storeRoot, (n) => n.endsWith('.md') && n !== 'SKILL.md', (d) => d === CRTR_DIR_NAME)) {
-        const physicalRelativePath = relative(store.storeRoot, path).split(sep).join('/');
-        // COLLECTION layer: the strict frontmatter parser throws on invalid YAML.
-        // Isolate one malformed doc with a scoped notice + skip, so a single bad
-        // file can't brick `memory list`/`find` or the substrate boot render.
-        // `quiet` suppresses the notice for a targeted resolve, where another doc's
-        // health is noise before the result.
-        try {
-            const doc = loadMemoryDoc(store, path, physicalRelativePath);
-            if (doc === null) {
-                if (!quiet)
-                    warn(`${path}: a root ${INDEX_SEGMENT}.md has no canonical name in a store without a namespace`);
-                continue;
-            }
-            docs.push(doc);
-        }
-        catch (e) {
-            if (!quiet)
-                warn(`invalid frontmatter in ${path}: ${firstLine(e)}`);
-        }
-    }
-    return docs.sort(compareDocs);
-}
-/** All of one plugin's substrate docs, mounted under the plugin's own name:
- *  each doc's store-local name (explicit or path-derived) composes under that
- *  mount prefix. */
-export function listPluginMemoryDocs(plugin, scope, quiet = false, projectMemory = NEUTRAL_PROJECT_MEMORY) {
-    return loadStoreMemoryDocs(pluginStoreDescriptor(plugin, scope, projectMemory), quiet);
-}
-// Views: exact canonical resolution over a loaded corpus.
-/** The canonical form of a query: empty segments dropped. An `NN-` ordering
- *  prefix is physical-path-only and is NOT stripped here — a canonical name
- *  never carries one, so `04-base` is simply no document's address. */
-function normalizeQuery(rawName) {
-    return canonicalSegments(rawName.trim()).join('/');
-}
-function notFoundError(rawName, name, scope) {
-    const segments = canonicalSegments(name);
-    const collapsedIndex = segments[segments.length - 1] === INDEX_SEGMENT;
-    if (collapsedIndex)
-        segments.pop();
-    const leaf = segments[segments.length - 1] ?? name;
-    const next = collapsedIndex
-        ? `A directory's own document answers at the directory name — drop the trailing /${INDEX_SEGMENT}. Run \`crtr memory find ${leaf}\` to find the canonical name.`
-        : `Resolution takes the full canonical name (a project doc is <namespace>/<local name>). Run \`crtr memory find ${leaf}\` to find it.`;
-    return notFound(`memory document not found: ${rawName}`, { memory: name, ...(scope ? { scope } : {}), next });
-}
-function makeView(stores, docs, scope) {
-    const candidatesFor = (rawName, opts) => {
-        const name = normalizeQuery(rawName);
-        if (name === '')
-            return null;
-        const kind = opts?.kind;
-        const candidates = docs.filter((d) => d.name === name && (kind === undefined || effectiveDocKind(d) === kind));
-        if (candidates.length === 0)
-            return null;
-        return { name, winner: candidates[0], candidates };
-    };
-    return {
-        stores,
-        docs,
-        candidates: candidatesFor,
-        candidateSets(opts) {
-            const kind = opts?.kind;
-            const grouped = new Map();
-            for (const doc of docs) {
-                if (kind !== undefined && effectiveDocKind(doc) !== kind)
-                    continue;
-                const bucket = grouped.get(doc.name);
-                if (bucket)
-                    bucket.push(doc);
-                else
-                    grouped.set(doc.name, [doc]);
-            }
-            return [...grouped.entries()]
-                .sort(([a], [b]) => a.localeCompare(b))
-                .map(([name, candidates]) => ({ name, winner: candidates[0], candidates }));
-        },
-        resolve(rawName, opts) {
-            const name = normalizeQuery(rawName);
-            if (name === '')
-                throw usage('memory document name required');
-            const set = candidatesFor(name, opts);
-            if (set === null)
-                throw notFoundError(rawName, name, scope);
-            return set.winner;
-        },
-    };
-}
-/** Load one target's whole corpus: every mounted store's documents in source
- *  order. A project store that does not mount is reported once (unless quiet)
- *  with its migration remedy and contributes nothing. */
-export function loadMemoryTargetView(target, opts = {}) {
-    const quiet = opts.quiet ?? false;
-    const stores = memoryStoresInPrecedence(target, opts.scope, opts.includeDescendants ?? false, opts.reportDiscovery ?? !quiet);
-    const docs = [];
-    for (const store of stores) {
-        if (store.mountStatus === 'absent')
-            continue;
-        if (store.mountStatus !== 'ready') {
-            if (!quiet && store.diagnostic !== undefined)
-                warn(`memory store not mounted: ${store.diagnostic}`);
-            continue;
-        }
-        docs.push(...loadStoreMemoryDocs(store, quiet));
-    }
-    return { target, ...makeView(stores, docs, opts.scope) };
-}
-/** Load ONE exact physical store. An undeclared/invalid project store loads
- *  under the empty namespace so lint and migration can inspect what it holds;
- *  no target view ever sees those documents. */
-export function loadMemoryStoreView(store, quiet = false) {
-    return { store, ...makeView([store], loadStoreMemoryDocs(store, quiet)) };
-}
-// Corpus listing.
-/** All project-scoped docs visible from an explicit node workspace/profile — the
- *  project-only slice of a `MemoryTarget` view, used where only workspace docs
- *  are wanted (a workspace-open render). For a full-precedence target-addressed
- *  lookup, use `resolveMemoryDocForTarget`. */
-export function listProjectMemoryDocs(startDir = process.cwd(), profileId = selectedProfileId() || null, quiet = false) {
-    return [
-        ...loadMemoryTargetView({ cwd: startDir, profileId, nodeId: null }, { scope: 'project', quiet }).docs,
-    ];
-}
-/** All memory docs across the resolved sources, in precedence order: each
- *  ancestor project `.crouter/` from nearest to farthest, then the selected
- *  profile's memory (if any), then user, then builtin. Within each source,
- *  native docs are emitted before enabled-plugin docs, and equal-canonical
- *  candidates stay in source order, so a caller's first-wins dedup yields the
- *  address winners. */
-export function listAllMemoryDocs(scope, quiet = false, includeDescendants = false) {
-    return [...loadMemoryTargetView(ambientMemoryTarget(), { ...(scope ? { scope } : {}), quiet, includeDescendants }).docs];
-}
-export function createMemoryDocSnapshot(target = ambientMemoryTarget()) {
-    // Quiet: a snapshot feeds command registration and migration planning, where
-    // another doc's frontmatter health is noise — corpus health is `lint`'s job.
-    const view = loadMemoryTargetView(target, { quiet: true });
-    return {
-        docs: view.docs,
-        resolve: (names) => {
-            const resolved = new Map();
-            for (const rawName of names) {
-                const set = view.candidates(rawName);
-                // A command registration reports its own body-read failure; one
-                // malformed/stale identity must not suppress every other slash command.
-                if (set !== null)
-                    resolved.set(rawName, set.winner);
-            }
-            return resolved;
-        },
-    };
-}
-/** Resolve several canonical names over one memory-source snapshot. Failed
- * names are omitted so callers can preserve their per-document error behavior. */
-export function resolveMemoryDocs(names) {
-    return createMemoryDocSnapshot().resolve(names);
-}
-/** Load the body at an already-resolved memory path with the same frontmatter
- * stripping and in-node path interpolation as `memory read`. Callers that
- * already have the resolved path (such as slash-command discovery) avoid
- * re-walking every memory store for each document. */
-export function readMemoryDocContent(path, includeFrontmatter = false) {
-    const raw = readText(path);
-    const content = includeFrontmatter ? raw : parseFrontmatterGeneric(raw).body;
-    const nodeId = envNodeId();
-    return nodeId ? interpolateNodePaths(content, nodeId) : content;
-}
-/** The address winner for an exact canonical name in the ambient target. */
-export function resolveMemoryDoc(rawName, opts = {}) {
-    return resolveMemoryDocForTarget(rawName, ambientMemoryTarget(), opts);
-}
-/** Resolve a memory document as ANOTHER node would see it — the same precedence
- *  chain (node-local > project stack > profile > user > builtin), read from the
- *  target's cwd/profile/node rather than the host process's. This is what crtrd
- *  resolves a `[[name]]` link through: the daemon's own cwd and env name no
- *  node, and the same name can be a different document for two nodes. */
-export function resolveMemoryDocForTarget(rawName, target, opts = {}) {
-    return resolveMemoryCandidatesForTarget(rawName, target, opts).winner;
-}
-/** Every physical candidate for an exact canonical name in the ambient target,
- *  in source order — what path-aware inventory, diagnostics, and automatic
- *  event eligibility consume instead of the winner alone. */
-export function resolveMemoryCandidates(rawName, opts = {}) {
-    return resolveMemoryCandidatesForTarget(rawName, ambientMemoryTarget(), opts);
-}
-export function resolveMemoryCandidatesForTarget(rawName, target, opts = {}) {
-    const view = loadMemoryTargetView(target, { ...opts, quiet: true });
-    const name = normalizeQuery(rawName);
-    if (name === '')
-        throw usage('memory document name required');
-    const set = view.candidates(name, opts);
-    if (set === null)
-        throw notFoundError(rawName, name, opts.scope);
-    return set;
-}
-/** The address winner for an exact canonical name inside ONE project store —
- *  the `--dir` selector's resolution. The query is still the full canonical
- *  name, including that store's namespace. */
-export function resolveMemoryDocInStore(rawName, store, opts = {}) {
-    return loadMemoryStoreView(store, true).resolve(rawName, opts);
-}
-// Physical sidecar lookup: the revision log mirrors the doc tree, so it is
-// addressed by PHYSICAL path segments, not by canonical identity.
-/** Find the direct child of `dir` — an `ext` file (matched on name minus
- *  extension) or a directory — whose NORMALIZED display name equals
- *  `segment`. An exact literal match (no prefix to strip) wins over a
- *  normalized match, so a `spine` dir sitting beside a `01-spine` dir (a
- *  malformed corpus) never masks the literal one; a well-formed corpus has at
- *  most one candidate either way. Returns the absolute child path, or null. */
-function matchNormalizedChild(dir, segment, want, ext = '.md') {
-    let entries;
-    try {
-        entries = readdirSync(dir, { withFileTypes: true });
-    }
-    catch {
-        return null;
-    }
-    let normalizedHit = null;
-    for (const e of entries) {
-        if (want === 'dir') {
-            if (!e.isDirectory())
-                continue;
-            if (e.name === segment)
-                return join(dir, e.name);
-            if (normalizedHit === null && normalizeNameSegment(e.name) === segment) {
-                normalizedHit = join(dir, e.name);
-            }
-        }
-        else {
-            if (!(e.isFile() && e.name.endsWith(ext)))
-                continue;
-            const base = e.name.slice(0, -ext.length);
-            if (base === segment)
-                return join(dir, e.name);
-            if (normalizedHit === null && normalizeNameSegment(base) === segment) {
-                normalizedHit = join(dir, e.name);
-            }
-        }
-    }
-    return normalizedHit;
-}
-/** Resolve a NORMALIZED (numeric-prefix-stripped) segment path against a
- *  physical dir: walk intermediate segments matching each as a directory by
- *  normalized name, then resolve the final segment as an `ext` file. Null when
- *  the segment path does not resolve. This is what keeps a sidecar findable
- *  when its physical path carries ordering pins — `00-topic.md` logged at
- *  `.history/00-topic.jsonl` still answers to `topic`. */
-function resolveNormalizedFile(baseDir, segments, ext) {
-    let curDir = baseDir;
-    for (let i = 0; i < segments.length - 1; i++) {
-        const next = matchNormalizedChild(curDir, segments[i], 'dir', ext);
-        if (!next)
-            return null;
-        curDir = next;
-    }
-    return matchNormalizedChild(curDir, segments[segments.length - 1], 'file', ext);
-}
-/** Resolve PHYSICAL path segments against a `.history` tree, which mirrors the
- *  doc tree segment for segment with `.jsonl` in place of `.md`. A log outlives
- *  its document, so this lookup cannot go through document resolution. */
-export function resolveHistoryLogPath(historyDir, segments) {
-    if (segments.length === 0)
-        return null;
-    return resolveNormalizedFile(historyDir, segments, '.jsonl');
-}
+var V=Object.defineProperty;var c=(e,o)=>V(e,"name",{value:o,configurable:!0});import{envNodeId as x,envProfileId as W}from"../shared/env.js";import{dirname as G,join as y,relative as H,sep as J}from"node:path";import{readdirSync as Q}from"node:fs";import{CRTR_DIR_NAME as F}from"../types.js";import{pathExists as v,readText as $,realpathOrSelf as N,walkFiles as U}from"./fs-utils.js";import{parseFrontmatterGeneric as j}from"./frontmatter.js";import{interpolateNodePaths as X}from"./canvas/paths.js";import{listInstalledPlugins as Y,listInstalledPluginsInRoot as B}from"./resolver.js";import{notFound as Z,usage as b}from"./errors.js";import{warn as M}from"./output.js";import{NEUTRAL_PROJECT_MEMORY as h,pluginMemoryDir as ee,projectScopeRoots as oe,projectScopeRootsWithMemory as ne,scopeMemoryDir as te}from"./scope.js";import{effectiveDocKind as k}from"./substrate/schema.js";import{INDEX_SEGMENT as w,canonicalSegments as C,composeCanonicalName as E,localNameFromPath as re,normalizeNameSegment as T,representationForPath as ie,resolveLocalName as ae,routingAnchorFor as se,validateNamespace as ce}from"./memory/identity.js";import{loadProfileManifest as ue,profileMemoryDir as le}from"./profiles/manifest.js";import{memoryDir as me}from"./runtime/memory.js";import{descendantStoreRoots as de}from"./nested-stores.js";import{associateRepository as fe}from"./memory/repository-association.js";function g(){return{cwd:process.cwd(),profileId:W()||null,nodeId:x()||null}}c(g,"ambientMemoryTarget");function pe(){return g().profileId??""}c(pe,"selectedProfileId");function ye(e,o){if(o)return[o];const n=[];return e.nodeId&&n.push("node"),oe(e.cwd,e.profileId).length>0&&n.push("project"),e.profileId&&n.push("profile"),n.push("user"),n.push("builtin"),n}c(ye,"scopesInPrecedence");function L(e,o,n){const t={scope:"project",storeRoot:o,ownerDir:e,projectMemory:n};if(!v(o))return{...t,namespace:"",mountStatus:"absent"};const r=fe(e);if(!r.ok){const p=`run \`crtr sys migrate --dir ${e}\``;return r.code==="no-project-root"?{...t,namespace:"",mountStatus:"undeclared",mountFailure:"association",diagnostic:`project memory store at ${o} has no repository root declaring \`namespace:\` \u2014 ${p}`}:{...t,namespace:"",mountStatus:"invalid",mountFailure:"association",diagnostic:`project memory store at ${o} cannot be associated: ${r.reason} \u2014 ${p}`}}const{association:i}=r,s={namespacePath:i.declarationPath,repositoryRoot:i.repositoryRoot,repositoryKey:i.repositoryKey,ownerRelativePath:i.ownerRelativePath},u=i.declarationPath,d=i.ownerRelativePath!=="",a=`run \`crtr sys migrate --dir ${i.repositoryRoot}\``,l=d?`nested project memory store at ${o} takes its identity from ${u}, which is missing root ${w}.md declaring \`namespace:\` \u2014 ${a}`:`project memory store has no root ${w}.md declaring \`namespace:\` \u2014 ${a}`;if(!v(u))return{...t,...s,namespace:"",mountStatus:"undeclared",mountFailure:"undeclared-root",diagnostic:l};let m;try{m=j($(u)).data?.namespace}catch(p){return{...t,...s,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store's ${u} does not parse (${z(p)}) \u2014 ${a}`}}if(m==null||m===""){const p=d?`nested project memory store at ${o} takes its identity from ${u}, which declares no \`namespace:\` \u2014 ${a}`:`project memory store's ${u} declares no \`namespace:\` \u2014 ${a}`;return{...t,...s,namespace:"",mountStatus:"undeclared",mountFailure:"undeclared-root",diagnostic:p}}if(typeof m!="string")return{...t,...s,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store declares a non-string \`namespace:\` (${JSON.stringify(m)}) \u2014 quote it in ${u}, or ${a}`};const f=ce(m);return f.ok?{...t,...s,repositoryNamespace:m,namespace:E(m,i.ownerRelativePath),mountStatus:"ready"}:{...t,...s,namespace:"",mountStatus:"invalid",mountFailure:"invalid-root",diagnostic:`project memory store declares an invalid namespace \`${m}\` (${f.reason}) \u2014 ${a}`}}c(L,"projectStoreDescriptor");function R(e,o){return o===null?{scope:e,storeRoot:"",namespace:"",mountStatus:"absent",projectMemory:h}:{scope:e,storeRoot:o,namespace:"",mountStatus:v(o)?"ready":"absent",projectMemory:h}}c(R,"plainStoreDescriptor");function I(e,o,n){const t=ee(e);return{scope:o,storeRoot:t,namespace:e.name,plugin:e.name,mountStatus:v(t)?"ready":"absent",projectMemory:n}}c(I,"pluginStoreDescriptor");function _e(e){const o=N(e);return L(o,y(o,F,"memory"),h)}c(_e,"openProjectMemoryStore");function q(e,o,n=!1,t=!0){const r=[],i=c((a,l)=>{r.push(L(G(a),y(a,"memory"),l));for(const m of B("project",a).filter(f=>f.enabled))r.push(I(m,"project",l))},"projectStores");for(const a of ye(e,o))if(a==="project"){const l=ne(e.cwd,e.profileId);for(const{root:m,memory:f}of l)i(m,f);if(n)for(const m of de(l.map(({root:f})=>f),t))i(m,h)}else if(a==="profile"){const l=e.profileId??"";if(l!=="")try{const{profileId:m}=ue(l);r.push(R("profile",le(m)))}catch{}}else if(a==="node"){const l=e.nodeId??"";l!==""&&r.push(R("node",me(l)))}else{r.push(R(a,te(a)));for(const l of Y(a).filter(m=>m.enabled))r.push(I(l,a,h))}const s=new Set,u=r.filter(a=>{if(a.storeRoot==="")return!1;const l=N(a.storeRoot);return s.has(l)?!1:(s.add(l),!0)}),d=new Map;for(const a of u){if(a.scope!=="project"||a.mountStatus!=="ready"||a.repositoryRoot===void 0||a.ownerRelativePath===void 0)continue;const l=`${a.repositoryRoot}\0${a.ownerRelativePath}`,m=d.get(l);m?m.push(a):d.set(l,[a])}return u.map(a=>{if(a.scope!=="project"||a.mountStatus!=="ready"||a.repositoryRoot===void 0||a.ownerRelativePath===void 0)return a;const l=d.get(`${a.repositoryRoot}\0${a.ownerRelativePath}`);if(l===void 0||l.length<2)return a;const m=l.map(f=>f.ownerDir??f.storeRoot).join(", ");return{...a,mountStatus:"invalid",mountFailure:"collision",diagnostic:`project memory stores at ${m} normalize to the same effective prefix \`${a.namespace}\` \u2014 rename one owner directory`}})}c(q,"memoryStoresInPrecedence");function Ke(e,o=!1){return q(g(),e,o).filter(n=>n.mountStatus==="ready"&&n.scope!=="builtin"&&n.plugin===void 0).map(n=>({scope:n.scope,memoryDir:n.storeRoot,store:n}))}c(Ke,"nativeMemoryStoresInPrecedence");function z(e){return(e instanceof Error?e.message:String(e)).split(`
+`)[0]??""}c(z,"firstLine");function he(e,o,n){const{data:t,body:r}=j($(o)),i=re(n),s=ie(n),u=i===""?"":ae(t,i),d=E(e.namespace,u);return d===""?null:{name:d,localName:u,scope:e.scope,path:o,root:e.storeRoot,physicalRelativePath:n,representation:s,routingAnchor:se(d,s),store:e,frontmatter:t,body:r,projectMemory:e.projectMemory,...e.plugin===void 0?{}:{plugin:e.plugin}}}c(he,"loadMemoryDoc");function ge(e,o){const n=e.name.localeCompare(o.name);return n!==0?n:e.representation!==o.representation?e.representation==="directory-index"?-1:1:e.physicalRelativePath.localeCompare(o.physicalRelativePath)}c(ge,"compareDocs");function D(e,o=!1){if(e.storeRoot===""||!v(e.storeRoot))return[];const n=[];for(const t of U(e.storeRoot,r=>r.endsWith(".md")&&r!=="SKILL.md",r=>r===F)){const r=H(e.storeRoot,t).split(J).join("/");try{const i=he(e,t,r);if(i===null){o||M(`${t}: a root ${w}.md has no canonical name in a store without a namespace`);continue}n.push(i)}catch(i){o||M(`invalid frontmatter in ${t}: ${z(i)}`)}}return n.sort(ge)}c(D,"loadStoreMemoryDocs");function Oe(e,o,n=!1,t=h){return D(I(e,o,t),n)}c(Oe,"listPluginMemoryDocs");function P(e){return C(e.trim()).join("/")}c(P,"normalizeQuery");function A(e,o,n){const t=C(o),r=t[t.length-1]===w;r&&t.pop();const i=t[t.length-1]??o,s=r?`A directory's own document answers at the directory name \u2014 drop the trailing /${w}. Run \`crtr memory find ${i}\` to find the canonical name.`:`Resolution takes the full canonical name (a project doc is <namespace>/<local name>). Run \`crtr memory find ${i}\` to find it.`;return Z(`memory document not found: ${e}`,{memory:o,...n?{scope:n}:{},next:s})}c(A,"notFoundError");function _(e,o,n){const t=c((r,i)=>{const s=P(r);if(s==="")return null;const u=i?.kind,d=o.filter(a=>a.name===s&&(u===void 0||k(a)===u));return d.length===0?null:{name:s,winner:d[0],candidates:d}},"candidatesFor");return{stores:e,docs:o,candidates:t,candidateSets(r){const i=r?.kind,s=new Map;for(const u of o){if(i!==void 0&&k(u)!==i)continue;const d=s.get(u.name);d?d.push(u):s.set(u.name,[u])}return[...s.entries()].sort(([u],[d])=>u.localeCompare(d)).map(([u,d])=>({name:u,winner:d[0],candidates:d}))},resolve(r,i){const s=P(r);if(s==="")throw b("memory document name required");const u=t(s,i);if(u===null)throw A(r,s,n);return u.winner}}}c(_,"makeView");function S(e,o={}){const n=o.quiet??!1,t=q(e,o.scope,o.includeDescendants??!1,o.reportDiscovery??!n),r=[];for(const i of t)if(i.mountStatus!=="absent"){if(i.mountStatus!=="ready"){!n&&i.diagnostic!==void 0&&M(`memory store not mounted: ${i.diagnostic}`);continue}r.push(...D(i,n))}return{target:e,..._(t,r,o.scope)}}c(S,"loadMemoryTargetView");function ve(e,o=!1){return{store:e,..._([e],D(e,o))}}c(ve,"loadMemoryStoreView");function Ve(e=process.cwd(),o=pe()||null,n=!1){return[...S({cwd:e,profileId:o,nodeId:null},{scope:"project",quiet:n}).docs]}c(Ve,"listProjectMemoryDocs");function We(e,o=!1,n=!1){return[...S(g(),{...e?{scope:e}:{},quiet:o,includeDescendants:n}).docs]}c(We,"listAllMemoryDocs");function we(e=g()){const o=S(e,{quiet:!0});return{docs:o.docs,resolve:c(n=>{const t=new Map;for(const r of n){const i=o.candidates(r);i!==null&&t.set(r,i.winner)}return t},"resolve")}}c(we,"createMemoryDocSnapshot");function Ge(e){return we().resolve(e)}c(Ge,"resolveMemoryDocs");function He(e,o=!1){const n=$(e),t=o?n:j(n).body,r=x();return r?X(t,r):t}c(He,"readMemoryDocContent");function Je(e,o={}){return Se(e,g(),o)}c(Je,"resolveMemoryDoc");function Se(e,o,n={}){return K(e,o,n).winner}c(Se,"resolveMemoryDocForTarget");function Qe(e,o={}){return K(e,g(),o)}c(Qe,"resolveMemoryCandidates");function K(e,o,n={}){const t=S(o,{...n,quiet:!0}),r=P(e);if(r==="")throw b("memory document name required");const i=t.candidates(r,n);if(i===null)throw A(e,r,n.scope);return i}c(K,"resolveMemoryCandidatesForTarget");function Ue(e,o,n={}){return ve(o,!0).resolve(e,n)}c(Ue,"resolveMemoryDocInStore");function O(e,o,n,t=".md"){let r;try{r=Q(e,{withFileTypes:!0})}catch{return null}let i=null;for(const s of r)if(n==="dir"){if(!s.isDirectory())continue;if(s.name===o)return y(e,s.name);i===null&&T(s.name)===o&&(i=y(e,s.name))}else{if(!(s.isFile()&&s.name.endsWith(t)))continue;const u=s.name.slice(0,-t.length);if(u===o)return y(e,s.name);i===null&&T(u)===o&&(i=y(e,s.name))}return i}c(O,"matchNormalizedChild");function $e(e,o,n){let t=e;for(let r=0;r<o.length-1;r++){const i=O(t,o[r],"dir",n);if(!i)return null;t=i}return O(t,o[o.length-1],"file",n)}c($e,"resolveNormalizedFile");function Xe(e,o){return o.length===0?null:$e(e,o,".jsonl")}c(Xe,"resolveHistoryLogPath");export{g as ambientMemoryTarget,we as createMemoryDocSnapshot,We as listAllMemoryDocs,Oe as listPluginMemoryDocs,Ve as listProjectMemoryDocs,ve as loadMemoryStoreView,S as loadMemoryTargetView,D as loadStoreMemoryDocs,q as memoryStoresInPrecedence,Ke as nativeMemoryStoresInPrecedence,_e as openProjectMemoryStore,He as readMemoryDocContent,Xe as resolveHistoryLogPath,Qe as resolveMemoryCandidates,K as resolveMemoryCandidatesForTarget,Je as resolveMemoryDoc,Se as resolveMemoryDocForTarget,Ue as resolveMemoryDocInStore,Ge as resolveMemoryDocs};