@north-light/crouter 0.3.317 → 0.3.319

package/dist/commands/memory/list.js

@@ -1,142 +1 @@
-import { defineLeaf } from '../../core/command.js';
-import { listAllMemoryDocs, loadMemoryStoreView } from '../../core/memory-resolver.js';
-import { memoryExtensionEffectiveCatalog, projectEffectiveMemoryExtensions } from '../../core/memory/extensions.js';
-import { renderResult } from '../../core/render.js';
-import { parseSubstrateDoc } from '../../core/substrate/schema.js';
-import { paginate } from '../../core/pagination.js';
-import { candidateRow } from './read.js';
-import { MEMORY_KINDS, registerMemoryListingExposure, requireMountedStore, resolveReadSelector, scopeRank, selectorParam, } from './shared.js';
-/** The inventory over one corpus. A target view is winner-only: one row per
- *  canonical identity, first in source order, because that is the document a
- *  read of the name returns. An exact store (`--dir`) is not deduped — the
- *  point of naming a store is to see what it physically holds, including a pair
- *  that shares one identity. */
-export function listMemoryDocs(kindFilter, docs, dedup) {
-    const byName = new Map();
-    for (const doc of docs) {
-        const bucket = byName.get(doc.name);
-        if (bucket !== undefined)
-            bucket.push(doc);
-        else
-            byName.set(doc.name, [doc]);
-    }
-    const seen = new Set();
-    const items = [];
-    for (const doc of docs) {
-        const sub = parseSubstrateDoc(doc);
-        if (sub === null)
-            continue;
-        if (kindFilter !== undefined && sub.kind !== kindFilter)
-            continue;
-        if (dedup) {
-            if (seen.has(sub.name))
-                continue;
-            seen.add(sub.name);
-        }
-        items.push({
-            name: sub.name,
-            kind: sub.kind,
-            scope: sub.scope,
-            path: sub.path,
-            storeRoot: doc.root,
-            physicalRelativePath: doc.physicalRelativePath,
-            shortForm: sub.shortForm,
-            slash: sub.slash,
-            extensions: projectEffectiveMemoryExtensions(doc.frontmatter?.['extensions'], memoryExtensionEffectiveCatalog(doc)),
-            candidates: byName.get(doc.name) ?? [doc],
-        });
-    }
-    items.sort((a, b) => compareMemoryListKeys(memoryListKey(a), memoryListKey(b)));
-    return items;
-}
-/** The stable key used by both inventory ordering and cursor resumption. */
-export function memoryListKey(doc) {
-    return `${String(scopeRank(doc.scope) + 10).padStart(2, '0')}:${doc.kind}:${doc.name}:${doc.physicalRelativePath}`;
-}
-/** Locale-aware total order for memory inventory keys. */
-export function compareMemoryListKeys(left, right) {
-    const [leftScope, leftKind, leftName, ...leftPath] = left.split(':');
-    const [rightScope, rightKind, rightName, ...rightPath] = right.split(':');
-    const scope = Number(leftScope) - Number(rightScope);
-    if (scope !== 0)
-        return scope;
-    const kind = leftKind.localeCompare(rightKind);
-    if (kind !== 0)
-        return kind;
-    const name = leftName.localeCompare(rightName);
-    return name !== 0 ? name : leftPath.join(':').localeCompare(rightPath.join(':'));
-}
-export const listLeaf = defineLeaf({
-    name: 'list',
-    description: 'inventory of stored memory documents',
-    whenToUse: 'browse everything stored — one row per canonical name with its short-form hook, kind, and scope. Every name is readable as-is with `crtr memory read`. This is the one surface that shows short-form. Reach for `crtr memory find` instead when you already have a topic or keyword in mind rather than wanting the whole inventory.',
-    help: {
-        name: 'memory list',
-        summary: 'inventory every memory document across the resolved scopes, one row per canonical name',
-        params: [
-            { kind: 'flag', name: 'kind', type: 'enum', choices: [...MEMORY_KINDS], required: false, constraint: 'Filter to a single kind. Default: all kinds.' },
-            selectorParam('scope-read', {}, 'Default: every resolved scope.'),
-            selectorParam('dir', {}, 'Lists that store alone, and lists it physically: two documents sharing one canonical name both appear, where the default view shows only the winner.'),
-            { kind: 'flag', name: 'paths', type: 'bool', required: false, default: false, constraint: 'Include each row\'s physical location — absolute path, store root, store-relative path, and every other physical document sharing its canonical name. Off by default.' },
-            { kind: 'flag', name: 'limit', type: 'int', required: false, default: 50, constraint: 'Default 50, max 200.' },
-            { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: 'Opaque token from next_cursor. Omit on first call.' },
-        ],
-        output: [
-            { name: 'items', type: 'object[]', required: true, constraint: 'One row per canonical name: {name, short_form, kind, scope, extensions}. extensions carries effective valid plugin-owned metadata; enabled defaults appear here without becoming frontmatter, while disabled and unresolved namespaces are omitted. With --paths each row also carries path, store_root, physical_relative_path, and — only when several physical documents share the name — candidates, one {winner, scope, store_root, physical_relative_path, path} row each in source order. Every name is readable as-is with `crtr memory read` (a name that carries members answers with its own document plus that directory listing). short_form is the abbreviated hook — shown here and nowhere else. Sorted by scope then kind then name ascending.' },
-            { name: 'next_cursor', type: 'string | null', required: true, constraint: 'Opaque token for the next page; null means no more items.' },
-            { name: 'total', type: 'integer | null', required: true, constraint: 'Exact total across all pages when cheap to compute (always cheap here); never null in practice for this leaf.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands — read a document in full or narrow the inventory.' },
-        ],
-        outputKind: 'object',
-        effects: ['Records this inventory page as listing context for the current node without marking any listed document as loaded.'],
-    },
-    run: async (input) => {
-        const kindFilter = input['kind'];
-        const dirArg = input['dir'];
-        const includePaths = input['paths'] ?? false;
-        const limitRaw = input['limit'];
-        const limit = limitRaw !== undefined ? Math.min(Math.max(1, limitRaw), 200) : 50;
-        const cursor = input['cursor'];
-        const selector = resolveReadSelector({ scope: input['scope'], dir: dirArg });
-        const items = selector.store !== null
-            ? listMemoryDocs(kindFilter, loadMemoryStoreView(requireMountedStore(selector.store), false).docs, false)
-            : listMemoryDocs(kindFilter, listAllMemoryDocs(selector.scope, false, true), true);
-        const keyOf = memoryListKey;
-        const result = paginate(items, { limit, cursor }, { defaultLimit: 50, maxLimit: 200, keyOf, compareKeys: compareMemoryListKeys, total: 'count' });
-        const output = {
-            items: result.items.map((d) => ({
-                name: d.name,
-                short_form: d.shortForm,
-                kind: d.kind,
-                scope: d.scope,
-                extensions: d.extensions,
-                ...(includePaths
-                    ? {
-                        path: d.path,
-                        store_root: d.storeRoot,
-                        physical_relative_path: d.physicalRelativePath,
-                        ...(d.candidates.length > 1
-                            ? { candidates: d.candidates.map((c) => candidateRow(c, d.candidates[0])) }
-                            : {}),
-                    }
-                    : {}),
-            })),
-            next_cursor: result.next_cursor,
-            total: result.total,
-            follow_up: 'Read one in full with `crtr memory read <name>`, or revise one with `crtr memory edit <name> --rationale "<why>"` (body, routing, frontmatter, and visibility all go through that one verb, and it records the change). Narrow with --kind / --scope, page with --cursor, or search a topic with `crtr memory find <query>`.',
-        };
-        registerMemoryListingExposure(`listing:memory-list:${JSON.stringify({
-            kind: kindFilter ?? null,
-            scope: selector.scope ?? null,
-            dir: dirArg ?? null,
-            paths: includePaths,
-            limit,
-            cursor: cursor ?? null,
-        })}`);
-        return output;
-    },
-    render: (result) => {
-        const items = result['items'].map(({ extensions: _extensions, ...item }) => item);
-        return renderResult({ ...result, items }, listLeaf.help);
-    },
-});
+var v=Object.defineProperty;var m=(t,n)=>v(t,"name",{value:n,configurable:!0});import{defineLeaf as k}from"../../core/command.js";import{listAllMemoryDocs as x,loadMemoryStoreView as b}from"../../core/memory-resolver.js";import{memoryExtensionEffectiveCatalog as _,projectEffectiveMemoryExtensions as R}from"../../core/memory/extensions.js";import{renderResult as q}from"../../core/render.js";import{parseSubstrateDoc as M}from"../../core/substrate/schema.js";import{paginate as S}from"../../core/pagination.js";import{candidateRow as E}from"./read.js";import{MEMORY_KINDS as O,registerMemoryListingExposure as L,requireMountedStore as N,resolveReadSelector as P,scopeRank as D,selectorParam as f}from"./shared.js";function y(t,n,i){const a=new Map;for(const o of n){const e=a.get(o.name);e!==void 0?e.push(o):a.set(o.name,[o])}const c=new Set,s=[];for(const o of n){const e=M(o);if(e!==null&&!(t!==void 0&&e.kind!==t)){if(i){if(c.has(e.name))continue;c.add(e.name)}s.push({name:e.name,kind:e.kind,scope:e.scope,path:e.path,storeRoot:o.root,physicalRelativePath:o.physicalRelativePath,shortForm:e.shortForm,slash:e.slash,extensions:R(o.frontmatter?.extensions,_(o)),candidates:a.get(o.name)??[o]})}}return s.sort((o,e)=>w(p(o),p(e))),s}m(y,"listMemoryDocs");function p(t){return`${String(D(t.scope)+10).padStart(2,"0")}:${t.kind}:${t.name}:${t.physicalRelativePath}`}m(p,"memoryListKey");function w(t,n){const[i,a,c,...s]=t.split(":"),[o,e,d,...u]=n.split(":"),l=Number(i)-Number(o);if(l!==0)return l;const h=a.localeCompare(e);if(h!==0)return h;const r=c.localeCompare(d);return r!==0?r:s.join(":").localeCompare(u.join(":"))}m(w,"compareMemoryListKeys");const K=k({name:"list",description:"inventory of stored memory documents",whenToUse:"browse everything stored \u2014 one row per canonical name with its short-form hook, kind, and scope. Every name is readable as-is with `crtr memory read`. This is the one surface that shows short-form. Reach for `crtr memory find` instead when you already have a topic or keyword in mind rather than wanting the whole inventory.",help:{name:"memory list",summary:"inventory every memory document across the resolved scopes, one row per canonical name",params:[{kind:"flag",name:"kind",type:"enum",choices:[...O],required:!1,constraint:"Filter to a single kind. Default: all kinds."},f("scope-read",{},"Default: every resolved scope."),f("dir",{},"Lists that store alone, and lists it physically: two documents sharing one canonical name both appear, where the default view shows only the winner."),{kind:"flag",name:"paths",type:"bool",required:!1,default:!1,constraint:"Include each row's physical location \u2014 absolute path, store root, store-relative path, and every other physical document sharing its canonical name. Off by default."},{kind:"flag",name:"limit",type:"int",required:!1,default:50,constraint:"Default 50, max 200."},{kind:"flag",name:"cursor",type:"string",required:!1,constraint:"Opaque token from next_cursor. Omit on first call."}],output:[{name:"items",type:"object[]",required:!0,constraint:"One row per canonical name: {name, short_form, kind, scope, extensions}. extensions carries effective valid plugin-owned metadata; enabled defaults appear here without becoming frontmatter, while disabled and unresolved namespaces are omitted. With --paths each row also carries path, store_root, physical_relative_path, and \u2014 only when several physical documents share the name \u2014 candidates, one {winner, scope, store_root, physical_relative_path, path} row each in source order. Every name is readable as-is with `crtr memory read` (a name that carries members answers with its own document plus that directory listing). short_form is the abbreviated hook \u2014 shown here and nowhere else. Sorted by scope then kind then name ascending."},{name:"next_cursor",type:"string | null",required:!0,constraint:"Opaque token for the next page; null means no more items."},{name:"total",type:"integer | null",required:!0,constraint:"Exact total across all pages when cheap to compute (always cheap here); never null in practice for this leaf."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands \u2014 read a document in full or narrow the inventory."}],outputKind:"object",effects:["Records this inventory page as listing context for the current node without marking any listed document as loaded."]},run:m(async t=>{const n=t.kind,i=t.dir,a=t.paths??!1,c=t.limit,s=c!==void 0?Math.min(Math.max(1,c),200):50,o=t.cursor,e=P({scope:t.scope,dir:i}),d=e.store!==null?y(n,b(N(e.store),!1).docs,!1):y(n,x(e.scope,!1,!0),!0),l=S(d,{limit:s,cursor:o},{defaultLimit:50,maxLimit:200,keyOf:p,compareKeys:w,total:"count"}),h={items:l.items.map(r=>({name:r.name,short_form:r.shortForm,kind:r.kind,scope:r.scope,extensions:r.extensions,...a?{path:r.path,store_root:r.storeRoot,physical_relative_path:r.physicalRelativePath,...r.candidates.length>1?{candidates:r.candidates.map(g=>E(g,r.candidates[0]))}:{}}:{}})),next_cursor:l.next_cursor,total:l.total,follow_up:'Read one in full with `crtr memory read <name>`, or revise one with `crtr memory edit <name> --rationale "<why>"` (body, routing, frontmatter, and visibility all go through that one verb, and it records the change). Narrow with --kind / --scope, page with --cursor, or search a topic with `crtr memory find <query>`.'};return L(`listing:memory-list:${JSON.stringify({kind:n??null,scope:e.scope??null,dir:i??null,paths:a,limit:s,cursor:o??null})}`),h},"run"),render:m(t=>{const n=t.items.map(({extensions:i,...a})=>a);return q({...t,items:n},K.help)},"render")});export{w as compareMemoryListKeys,K as listLeaf,y as listMemoryDocs,p as memoryListKey};

package/dist/commands/memory/move.js

@@ -1,223 +1 @@
-import { appendFileSync, renameSync, rmSync } from 'node:fs';
-import { dirname, resolve as resolvePath } from 'node:path';
-import { defineLeaf } from '../../core/command.js';
-import { CrtrError, notFound, usage } from '../../core/errors.js';
-import { ensureDir, pathExists, readText, realpathOrSelf, writeText } from '../../core/fs-utils.js';
-import { listAllMemoryDocs, loadMemoryStoreView, resolveMemoryCandidates } from '../../core/memory-resolver.js';
-import { findDocLinks } from '../../core/memory/doc-link-grammar.js';
-import { appendHistoryRecord, buildHistoryRecord, historyLogPathFor } from '../../core/memory/history.js';
-import { explicitLocalName } from '../../core/memory/identity.js';
-import { buildMemoryTree } from '../../core/memory/tree.js';
-import { MEMORY_WRITE_SCOPES, literalBodySegment, planNewDocumentPlacement, pruneEmptyParents, requireCanonicalName, requireLocalNameInStore, requireMountedStore, selectMutationDoc, resolveReadSelector, selectorParam, serializeMemoryDocLiteral, } from './shared.js';
-/** Replace every `[[oldName]]` doc link in a full document source with
- *  `[[newName]]`, splicing only within the literal body segment so the
- *  frontmatter block is never touched. Link spans come from the shared
- *  doc-link grammar (code blocks and inline code excluded), applied back to
- *  front so earlier offsets stay valid. */
-function rewriteRefs(source, oldName, newName) {
-    const body = literalBodySegment(source);
-    const prefixLen = source.length - body.length;
-    const links = findDocLinks(body).filter((l) => l.name === oldName);
-    let text = source;
-    for (let i = links.length - 1; i >= 0; i -= 1) {
-        const l = links[i];
-        text = text.slice(0, prefixLen + l.start) + `[[${newName}]]` + text.slice(prefixLen + l.end);
-    }
-    return { text, count: links.length };
-}
-/** Every physical document owning the source's exact canonical identity — in
- *  the target view, or inside the one store `--dir` selected — or null when
- *  nothing answers to that name. */
-function sourceCandidates(rawName, scope, storeView) {
-    if (storeView !== null)
-        return storeView.candidates(rawName);
-    try {
-        return resolveMemoryCandidates(rawName, {
-            includeDescendants: true,
-            ...(scope !== undefined ? { scope } : {}),
-        });
-    }
-    catch (e) {
-        if (e instanceof CrtrError && e.code === 'not_found')
-            return null;
-        throw e; // usage propagates with its own recovery guidance
-    }
-}
-export const moveLeaf = defineLeaf({
-    name: 'move',
-    description: 'rename or relocate a memory document, rewriting inbound links',
-    whenToUse: 'a stored document should answer to a different canonical name — renamed in place or relocated under another directory. The sanctioned way to move one, so you never mv the markdown off disk: this verb carries the document’s revision history along and rewrites every inbound `[[ref]]` across writable stores, so authored links break loudly or not at all. Source and destination are both full canonical names in the SAME store, so a move never changes which repository-relative prefix the document composes under. The repository-root document is immutable, but a nested store’s optional root guide is an ordinary document that may move. One document per move: moving a directory’s own document leaves its members where they are, so relocate a whole directory member by member. If two physical files in that store share the source identity, this verb selects the first physical path in stable lexical order and recovers the collision.',
-    help: {
-        name: 'memory move',
-        summary: 'move one document to a new canonical name inside its own store, rewriting inbound [[refs]]',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Full canonical name of the document to move — a project document is `<namespace>/<local name>`. Resolution is exact, as `read` resolves it: a file path, a bare leaf, a `<scope>/<name>` spelling, and a trailing `/INDEX` all fail. If two physical files in the selected store own the name, move selects the first path in stable lexical order and recovers the collision. Builtin and installed-plugin documents are read-only and refuse to move, as does the repository-root document, which declares the immutable namespace for every document in the repository; a nested store’s root guide is ordinary and may move.' },
-            { kind: 'flag', name: 'to', type: 'string', required: true, constraint: 'The new full canonical name, in the SAME store — the repository namespace and store path included, since a move never crosses stores. `/`-joined segments of [A-Za-z0-9_-], no trailing `INDEX` (a directory’s document answers at the directory name). A nested store’s effective prefix is a legal destination for its optional root guide. Rejected when a document in that store already answers to it, or when either `<local name>.md` or `<local name>/INDEX.md` already exists there.' },
-            selectorParam('scope-read', { choices: [...MEMORY_WRITE_SCOPES] }, 'Package-shipped documents cannot move through this writable-scope selector.'),
-            selectorParam('dir', {}, 'Source, destination, and inbound-link rewriting all stay inside that one store, so moving a non-winning duplicate leaves every other store untouched — and rewrites no link at all, because the name still resolves to the candidate that outranks it here.'),
-        ],
-        output: [
-            { name: 'name', type: 'string', required: true, constraint: 'The document’s new canonical name — `--to` after canonicalization, so it can differ from what you passed.' },
-            { name: 'previous_name', type: 'string', required: true, constraint: 'The canonical name it answered to before the move.' },
-            { name: 'scope', type: 'string', required: true, constraint: 'Scope of the store the document moved within: node, user, project, or profile.' },
-            { name: 'path', type: 'string', required: true, constraint: 'Absolute path of the document at its new location — `<local name>/INDEX.md` when that canonical directory already has members in the store, else `<local name>.md`.' },
-            { name: 'log_path', type: 'string', required: true, constraint: 'Absolute path to the revision log at its new location, ending in a `move` record that names the previous canonical name.' },
-            { name: 'refs_rewritten', type: 'object[]', required: true, constraint: 'Documents whose bodies were rewritten from `[[<previous_name>]]` to `[[<name>]]`. Each: {name, scope, path, refs}. Empty when nothing linked to the document — or when the moved file is not what that name resolves to here (another store’s candidate wins the address), in which case inbound refs keep resolving to that winner and are left alone.' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Outcome-dependent collision recovery and inbound-reference rewriting signal.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Moves the document to the physical form its new local name takes in that store (creating parent directories, pruning any it leaves empty) and moves its `.history/<physical path>.jsonl` log with it, appending a `move` record naming the previous canonical name.',
-            'Drops an explicit `name:` frontmatter pin, so the moved document answers to its path-derived identity — the name you asked for.',
-            'Rewrites every inbound `[[<name>]]` doc link to `[[<new-name>]]` — across the target view’s writable stores, or inside the one store `--dir` selected — appending an `edit` record to each rewritten document’s revision log. Aborts before any write when a read-only (builtin or installed-plugin) document carries such a link.',
-        ],
-    },
-    run: async (input) => {
-        const nameRaw = input['name'];
-        const newNameRaw = (input['to'] ?? '').trim();
-        const scopeArg = input['scope'];
-        const dirArg = input['dir'];
-        const selector = resolveReadSelector({ scope: scopeArg, dir: dirArg });
-        const storeView = selector.store === null ? null : loadMemoryStoreView(requireMountedStore(selector.store), true);
-        const set = sourceCandidates(nameRaw, selector.scope, storeView);
-        if (set === null) {
-            const tree = buildMemoryTree(storeView?.docs ?? listAllMemoryDocs(undefined, true, true));
-            if (tree.isDirectory(nameRaw)) {
-                throw usage(`${nameRaw} is a canonical directory with no document of its own, and a directory never moves as a unit — move its members individually.`, {
-                    memory: nameRaw,
-                    next: `Run \`crtr memory read ${nameRaw}\` to list the members, then \`crtr memory move <member> --to <new-name>\` per document.`,
-                });
-            }
-            throw notFound(`memory document not found: ${nameRaw}`, {
-                memory: nameRaw,
-                next: 'A move takes the full canonical name (a project document is <namespace>/<local name>), and a directory’s own document answers at the directory name. Run `crtr memory find <leaf>` to look it up, or pass --dir to reach one exact project store.',
-            });
-        }
-        const selected = selectMutationDoc(set);
-        const doc = selected.doc;
-        if (doc.plugin !== undefined) {
-            throw usage(`${doc.name} belongs to the installed plugin "${doc.plugin}" — it is not a scope doc and cannot be moved here. Manage plugin docs with \`crtr pkg\`.`, { memory: doc.name, plugin: doc.plugin });
-        }
-        if (doc.scope === 'builtin') {
-            throw usage(`${doc.name} is a builtin document shipped with the package (read-only) — it cannot be moved. Override it with a same-named doc at a writable scope instead (\`crtr memory write ${doc.name} ...\`).`, { memory: doc.name, scope: 'builtin' });
-        }
-        // Only the repository-root document declares the namespace and is
-        // immutable through the memory commands.
-        if (doc.localName === '' && doc.store.ownerRelativePath === '') {
-            throw usage(`${doc.name} is the repository-root document at ${doc.path}, which declares the namespace every document in this repository composes under — it answers at the namespace itself and cannot be moved.`, { memory: doc.name, path: doc.path });
-        }
-        if (newNameRaw === '')
-            throw usage('--to requires the new canonical name');
-        const newName = requireCanonicalName(newNameRaw);
-        if (newName === doc.name)
-            throw usage(`${doc.name} already answers to that name — nothing to move`);
-        if (doc.store.ownerRelativePath === '' && requireLocalNameInStore(doc.store, newName) === '') {
-            throw usage(`${newName} is the repository namespace of the store at ${doc.root} — its repository-root document declares that namespace and is not a destination a move can create.`, { memory: newName });
-        }
-        // Occupancy (the identity AND both physical forms of it) is checked in the
-        // one store the document lives in; another store legitimately carries the
-        // same canonical name. The source itself is excluded, so retiring an
-        // explicit `name:` pin back to the file's own path-derived identity is a
-        // legal destination.
-        const movedReal = realpathOrSelf(doc.path);
-        const placement = planNewDocumentPlacement(doc.store, newName, storeView?.docs, doc);
-        const inPlace = realpathOrSelf(placement.path) === movedReal;
-        // Two corpora, one rule each. Winner facts always come from the live target
-        // view: `--dir` picks which store may be WRITTEN, never who owns the
-        // address, so a selected non-winning duplicate keeps every inbound ref
-        // pointing at the document that still answers here. The rewrite corpus is
-        // what this move may change — that one store under `--dir`, the same target
-        // view otherwise.
-        const targetDocs = listAllMemoryDocs(undefined, true, true);
-        const corpus = storeView?.docs ?? targetDocs;
-        const winner = targetDocs.find((d) => d.name === doc.name);
-        const isWinner = winner !== undefined && realpathOrSelf(winner.path) === movedReal;
-        const referencing = [];
-        const blocked = [];
-        if (isWinner) {
-            const seenFiles = new Set([movedReal]);
-            for (const d of corpus) {
-                const real = realpathOrSelf(d.path);
-                if (seenFiles.has(real))
-                    continue;
-                seenFiles.add(real);
-                if (!findDocLinks(d.body).some((l) => l.name === doc.name))
-                    continue;
-                if (d.plugin !== undefined || d.scope === 'builtin')
-                    blocked.push(d);
-                else
-                    referencing.push(d);
-            }
-            if (blocked.length > 0) {
-                throw usage(`cannot move ${doc.name}: read-only docs link to it with [[${doc.name}]] and their refs cannot be rewritten — ` +
-                    blocked.map((d) => `${d.plugin !== undefined ? `plugin ${d.plugin}` : d.scope}: ${d.name} (${d.path})`).join('; ') +
-                    '. Nothing was changed.', { memory: doc.name });
-            }
-        }
-        // All checks passed — mutate. Inbound refs first, each an ordinary `edit`
-        // in that doc's own log; the mechanical splice touches only body bytes, so
-        // `last-updated` (recency of the knowledge itself) is deliberately not
-        // restamped.
-        const refsRewritten = [];
-        for (const d of referencing) {
-            const before = readText(d.path);
-            const { text: after, count } = rewriteRefs(before, doc.name, newName);
-            if (count === 0)
-                continue;
-            writeText(d.path, after);
-            appendHistoryRecord(historyLogPathFor(d.root, d.path), buildHistoryRecord({ op: 'edit', rationale: `\`crtr memory move\`: [[${doc.name}]] → [[${newName}]]`, before, after }));
-            refsRewritten.push({ name: d.name, scope: d.scope, path: d.path, refs: count });
-        }
-        // The doc itself: self-refs rewrite in the same motion as the move. An
-        // explicit `name` pinned identity to that string rather than the path, so
-        // the move drops it — the destination name IS the path-derived identity.
-        const before = readText(doc.path);
-        const rewritten = isWinner ? rewriteRefs(before, doc.name, newName).text : before;
-        let after = rewritten;
-        if (explicitLocalName(doc.frontmatter) !== null) {
-            const frontmatter = { ...(doc.frontmatter ?? {}) };
-            delete frontmatter['name'];
-            after = serializeMemoryDocLiteral(frontmatter, literalBodySegment(rewritten));
-        }
-        writeText(placement.path, after);
-        const physicalSegments = doc.physicalRelativePath.split('/').length;
-        if (!inPlace) {
-            rmSync(doc.path);
-            pruneEmptyParents(resolvePath(doc.path), physicalSegments);
-        }
-        // The revision log travels with the doc — history follows the file, so it
-        // moves to the sidecar mirroring the destination's physical path. A log
-        // already there (a prior, deleted life of that path) keeps its records;
-        // this doc's records append after them.
-        const oldLog = historyLogPathFor(doc.root, doc.path);
-        const newLog = historyLogPathFor(placement.store.storeRoot, placement.path);
-        if (!inPlace && pathExists(oldLog)) {
-            ensureDir(dirname(newLog));
-            if (pathExists(newLog)) {
-                appendFileSync(newLog, readText(oldLog), 'utf8');
-                rmSync(oldLog);
-            }
-            else {
-                renameSync(oldLog, newLog);
-            }
-            pruneEmptyParents(resolvePath(oldLog), physicalSegments);
-        }
-        appendHistoryRecord(newLog, buildHistoryRecord({ op: 'move', from: doc.name, before, after }));
-        const refsNote = isWinner
-            ? refsRewritten.length > 0
-                ? ` Rewrote [[${doc.name}]] in ${refsRewritten.length} doc${refsRewritten.length === 1 ? '' : 's'}.`
-                : ' No inbound refs needed rewriting.'
-            : winner === undefined
-                ? ` Inbound [[${doc.name}]] refs were left alone: no document answers to that name in this target view, so no link here pointed at the moved file.`
-                : ` Inbound [[${doc.name}]] refs were left alone: ${winner.path} answers to that name in this target view, so they still resolve to it.`;
-        return {
-            name: newName,
-            previous_name: doc.name,
-            scope: doc.scope,
-            path: placement.path,
-            log_path: newLog,
-            refs_rewritten: refsRewritten,
-            follow_up: `Moved${selected.collisionPaths.length > 0 ? ` the first physical path in stable lexical order (${doc.path}) to recover a same-store collision.` : '.'}${refsNote}`,
-        };
-    },
-});
+var Y=Object.defineProperty;var $=(r,n)=>Y(r,"name",{value:n,configurable:!0});import{appendFileSync as Z,renameSync as G,rmSync as I}from"node:fs";import{dirname as J,resolve as L}from"node:path";import{defineLeaf as Q}from"../../core/command.js";import{CrtrError as ee,notFound as te,usage as m}from"../../core/errors.js";import{ensureDir as oe,pathExists as T,readText as M,realpathOrSelf as k,writeText as O}from"../../core/fs-utils.js";import{listAllMemoryDocs as C,loadMemoryStoreView as ne,resolveMemoryCandidates as re}from"../../core/memory-resolver.js";import{findDocLinks as F}from"../../core/memory/doc-link-grammar.js";import{appendHistoryRecord as X,buildHistoryRecord as z,historyLogPathFor as q}from"../../core/memory/history.js";import{explicitLocalName as ae}from"../../core/memory/identity.js";import{buildMemoryTree as ie}from"../../core/memory/tree.js";import{MEMORY_WRITE_SCOPES as se,literalBodySegment as B,planNewDocumentPlacement as ce,pruneEmptyParents as H,requireCanonicalName as me,requireLocalNameInStore as le,requireMountedStore as de,selectMutationDoc as he,resolveReadSelector as ue,selectorParam as W,serializeMemoryDocLiteral as pe}from"./shared.js";function K(r,n,l){const s=B(r),v=r.length-s.length,d=F(s).filter(c=>c.name===n);let a=r;for(let c=d.length-1;c>=0;c-=1){const u=d[c];a=a.slice(0,v+u.start)+`[[${l}]]`+a.slice(v+u.end)}return{text:a,count:d.length}}$(K,"rewriteRefs");function fe(r,n,l){if(l!==null)return l.candidates(r);try{return re(r,{includeDescendants:!0,...n!==void 0?{scope:n}:{}})}catch(s){if(s instanceof ee&&s.code==="not_found")return null;throw s}}$(fe,"sourceCandidates");const Me=Q({name:"move",description:"rename or relocate a memory document, rewriting inbound links",whenToUse:"a stored document should answer to a different canonical name \u2014 renamed in place or relocated under another directory. The sanctioned way to move one, so you never mv the markdown off disk: this verb carries the document\u2019s revision history along and rewrites every inbound `[[ref]]` across writable stores, so authored links break loudly or not at all. Source and destination are both full canonical names in the SAME store, so a move never changes which repository-relative prefix the document composes under. The repository-root document is immutable, but a nested store\u2019s optional root guide is an ordinary document that may move. One document per move: moving a directory\u2019s own document leaves its members where they are, so relocate a whole directory member by member. If two physical files in that store share the source identity, this verb selects the first physical path in stable lexical order and recovers the collision.",help:{name:"memory move",summary:"move one document to a new canonical name inside its own store, rewriting inbound [[refs]]",params:[{kind:"positional",name:"name",required:!0,constraint:"Full canonical name of the document to move \u2014 a project document is `<namespace>/<local name>`. Resolution is exact, as `read` resolves it: a file path, a bare leaf, a `<scope>/<name>` spelling, and a trailing `/INDEX` all fail. If two physical files in the selected store own the name, move selects the first path in stable lexical order and recovers the collision. Builtin and installed-plugin documents are read-only and refuse to move, as does the repository-root document, which declares the immutable namespace for every document in the repository; a nested store\u2019s root guide is ordinary and may move."},{kind:"flag",name:"to",type:"string",required:!0,constraint:"The new full canonical name, in the SAME store \u2014 the repository namespace and store path included, since a move never crosses stores. `/`-joined segments of [A-Za-z0-9_-], no trailing `INDEX` (a directory\u2019s document answers at the directory name). A nested store\u2019s effective prefix is a legal destination for its optional root guide. Rejected when a document in that store already answers to it, or when either `<local name>.md` or `<local name>/INDEX.md` already exists there."},W("scope-read",{choices:[...se]},"Package-shipped documents cannot move through this writable-scope selector."),W("dir",{},"Source, destination, and inbound-link rewriting all stay inside that one store, so moving a non-winning duplicate leaves every other store untouched \u2014 and rewrites no link at all, because the name still resolves to the candidate that outranks it here.")],output:[{name:"name",type:"string",required:!0,constraint:"The document\u2019s new canonical name \u2014 `--to` after canonicalization, so it can differ from what you passed."},{name:"previous_name",type:"string",required:!0,constraint:"The canonical name it answered to before the move."},{name:"scope",type:"string",required:!0,constraint:"Scope of the store the document moved within: node, user, project, or profile."},{name:"path",type:"string",required:!0,constraint:"Absolute path of the document at its new location \u2014 `<local name>/INDEX.md` when that canonical directory already has members in the store, else `<local name>.md`."},{name:"log_path",type:"string",required:!0,constraint:"Absolute path to the revision log at its new location, ending in a `move` record that names the previous canonical name."},{name:"refs_rewritten",type:"object[]",required:!0,constraint:"Documents whose bodies were rewritten from `[[<previous_name>]]` to `[[<name>]]`. Each: {name, scope, path, refs}. Empty when nothing linked to the document \u2014 or when the moved file is not what that name resolves to here (another store\u2019s candidate wins the address), in which case inbound refs keep resolving to that winner and are left alone."},{name:"follow_up",type:"string",required:!0,constraint:"Outcome-dependent collision recovery and inbound-reference rewriting signal."}],outputKind:"object",effects:["Moves the document to the physical form its new local name takes in that store (creating parent directories, pruning any it leaves empty) and moves its `.history/<physical path>.jsonl` log with it, appending a `move` record naming the previous canonical name.","Drops an explicit `name:` frontmatter pin, so the moved document answers to its path-derived identity \u2014 the name you asked for.","Rewrites every inbound `[[<name>]]` doc link to `[[<new-name>]]` \u2014 across the target view\u2019s writable stores, or inside the one store `--dir` selected \u2014 appending an `edit` record to each rewritten document\u2019s revision log. Aborts before any write when a read-only (builtin or installed-plugin) document carries such a link."]},run:$(async r=>{const n=r.name,l=(r.to??"").trim(),s=r.scope,v=r.dir,d=ue({scope:s,dir:v}),a=d.store===null?null:ne(de(d.store),!0),c=fe(n,d.scope,a);if(c===null)throw ie(a?.docs??C(void 0,!0,!0)).isDirectory(n)?m(`${n} is a canonical directory with no document of its own, and a directory never moves as a unit \u2014 move its members individually.`,{memory:n,next:`Run \`crtr memory read ${n}\` to list the members, then \`crtr memory move <member> --to <new-name>\` per document.`}):te(`memory document not found: ${n}`,{memory:n,next:"A move takes the full canonical name (a project document is <namespace>/<local name>), and a directory\u2019s own document answers at the directory name. Run `crtr memory find <leaf>` to look it up, or pass --dir to reach one exact project store."});const u=he(c),e=u.doc;if(e.plugin!==void 0)throw m(`${e.name} belongs to the installed plugin "${e.plugin}" \u2014 it is not a scope doc and cannot be moved here. Manage plugin docs with \`crtr pkg\`.`,{memory:e.name,plugin:e.plugin});if(e.scope==="builtin")throw m(`${e.name} is a builtin document shipped with the package (read-only) \u2014 it cannot be moved. Override it with a same-named doc at a writable scope instead (\`crtr memory write ${e.name} ...\`).`,{memory:e.name,scope:"builtin"});if(e.localName===""&&e.store.ownerRelativePath==="")throw m(`${e.name} is the repository-root document at ${e.path}, which declares the namespace every document in this repository composes under \u2014 it answers at the namespace itself and cannot be moved.`,{memory:e.name,path:e.path});if(l==="")throw m("--to requires the new canonical name");const i=me(l);if(i===e.name)throw m(`${e.name} already answers to that name \u2014 nothing to move`);if(e.store.ownerRelativePath===""&&le(e.store,i)==="")throw m(`${i} is the repository namespace of the store at ${e.root} \u2014 its repository-root document declares that namespace and is not a destination a move can create.`,{memory:i});const x=k(e.path),p=ce(e.store,i,a?.docs,e),N=k(p.path)===x,_=C(void 0,!0,!0),U=a?.docs??_,g=_.find(t=>t.name===e.name),R=g!==void 0&&k(g.path)===x,P=[],S=[];if(R){const t=new Set([x]);for(const o of U){const y=k(o.path);t.has(y)||(t.add(y),F(o.body).some(b=>b.name===e.name)&&(o.plugin!==void 0||o.scope==="builtin"?S.push(o):P.push(o)))}if(S.length>0)throw m(`cannot move ${e.name}: read-only docs link to it with [[${e.name}]] and their refs cannot be rewritten \u2014 `+S.map(o=>`${o.plugin!==void 0?`plugin ${o.plugin}`:o.scope}: ${o.name} (${o.path})`).join("; ")+". Nothing was changed.",{memory:e.name})}const f=[];for(const t of P){const o=M(t.path),{text:y,count:b}=K(o,e.name,i);b!==0&&(O(t.path,y),X(q(t.root,t.path),z({op:"edit",rationale:`\`crtr memory move\`: [[${e.name}]] \u2192 [[${i}]]`,before:o,after:y})),f.push({name:t.name,scope:t.scope,path:t.path,refs:b}))}const D=M(e.path),A=R?K(D,e.name,i).text:D;let E=A;if(ae(e.frontmatter)!==null){const t={...e.frontmatter??{}};delete t.name,E=pe(t,B(A))}O(p.path,E);const j=e.physicalRelativePath.split("/").length;N||(I(e.path),H(L(e.path),j));const w=q(e.root,e.path),h=q(p.store.storeRoot,p.path);!N&&T(w)&&(oe(J(h)),T(h)?(Z(h,M(w),"utf8"),I(w)):G(w,h),H(L(w),j)),X(h,z({op:"move",from:e.name,before:D,after:E}));const V=R?f.length>0?` Rewrote [[${e.name}]] in ${f.length} doc${f.length===1?"":"s"}.`:" No inbound refs needed rewriting.":g===void 0?` Inbound [[${e.name}]] refs were left alone: no document answers to that name in this target view, so no link here pointed at the moved file.`:` Inbound [[${e.name}]] refs were left alone: ${g.path} answers to that name in this target view, so they still resolve to it.`;return{name:i,previous_name:e.name,scope:e.scope,path:p.path,log_path:h,refs_rewritten:f,follow_up:`Moved${u.collisionPaths.length>0?` the first physical path in stable lexical order (${e.path}) to recover a same-store collision.`:"."}${V}`}},"run")});export{Me as moveLeaf};

package/dist/commands/memory/origin.js

@@ -1,130 +1 @@
-import { defineLeaf } from '../../core/command.js';
-import { CrtrError, notFound } from '../../core/errors.js';
-import { loadMemoryStoreView, resolveMemoryCandidates } from '../../core/memory-resolver.js';
-import { ApiError } from '../../api/index.js';
-import { cliClient } from '../api-client.js';
-import { contextDir } from '../../core/canvas/paths.js';
-import { requireMountedStore, requireUnambiguousDoc, resolveReadSelector, selectorParam } from './shared.js';
-export const originLeaf = defineLeaf({
-    name: 'origin',
-    description: 'deref a memory document back to the node + conversation that created it',
-    whenToUse: 'you are looking at a stored memory and want to know WHERE it came from — which node authored it, in what conversation, when, and in which project. Reads the `origin` provenance block the runtime stamps at creation and derefs the node pointer to its live session conversation, context dir, and current state. Docs hand-authored or created before provenance capture carry no origin — the command says so rather than guessing.',
-    help: {
-        name: 'memory origin',
-        summary: 'resolve a doc name to its creation provenance and deref the originating node',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Full canonical memory name (a project document includes its namespace). Resolved exactly across the selected target view; a same-store physical collision is refused.' },
-            selectorParam('scope-read'),
-            selectorParam('dir'),
-            selectorParam('profile'),
-        ],
-        output: [
-            { name: 'name', type: 'string', required: true, constraint: 'Resolved document name.' },
-            { name: 'path', type: 'string', required: true, constraint: 'Absolute path to the document on disk.' },
-            { name: 'scope', type: 'string', required: true, constraint: 'Scope whose ordered store view supplied the document.' },
-            { name: 'local_name', type: 'string', required: true, constraint: 'Store-local identity, before project namespace composition.' },
-            { name: 'store_root', type: 'string', required: true, constraint: 'Absolute memory store root containing the document.' },
-            { name: 'physical_relative_path', type: 'string', required: true, constraint: 'Store-relative physical markdown path; sidecars preserve this shape.' },
-            { name: 'representation', type: 'string', required: true, constraint: 'Physical representation: leaf-file or directory-index.' },
-            { name: 'origin_recorded', type: 'boolean', required: true, constraint: 'true when the doc carries an `origin` provenance block; false for hand-authored or pre-provenance docs.' },
-            { name: 'created', type: 'string', required: false, constraint: 'ISO timestamp the doc was created. Absent when origin_recorded is false.' },
-            { name: 'cwd', type: 'string', required: false, constraint: 'Working directory the authoring conversation ran in.' },
-            { name: 'node', type: 'string', required: false, constraint: 'Node id that authored the doc, or null when written by the user at the CLI (no node).' },
-            { name: 'node_present', type: 'boolean', required: false, constraint: 'true when that node still exists on the canvas (deref below is live); false when it has been pruned.' },
-            { name: 'node_kind', type: 'string', required: false, constraint: 'Kind of the authoring node (only when node_present).' },
-            { name: 'node_mode', type: 'string', required: false, constraint: 'Mode of the authoring node (only when node_present).' },
-            { name: 'node_status', type: 'string', required: false, constraint: 'Current lifecycle status of the authoring node (only when node_present).' },
-            { name: 'node_description', type: 'string', required: false, constraint: 'The authoring node\u2019s description (only when node_present).' },
-            { name: 'session_file', type: 'string', required: false, constraint: 'Absolute path to the originating conversation\u2019s pi session .jsonl (only when node_present and a session was captured) \u2014 read it to see the conversation that produced the doc.' },
-            { name: 'context_dir', type: 'string', required: false, constraint: 'Absolute path to the authoring node\u2019s context dir (its shared document store).' },
-            { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands to inspect the origin.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const nameRaw = input['name'];
-        const selector = resolveReadSelector({
-            scope: input['scope'],
-            dir: input['dir'],
-            profile: input['profile'],
-        });
-        if (selector.store !== null)
-            requireMountedStore(selector.store);
-        let set;
-        try {
-            set = selector.store !== null
-                ? loadMemoryStoreView(selector.store, true).candidates(nameRaw)
-                : resolveMemoryCandidates(nameRaw, { includeDescendants: true, ...(selector.scope ? { scope: selector.scope } : {}) });
-        }
-        catch (e) {
-            if (!(e instanceof CrtrError && e.code === 'not_found'))
-                throw e;
-            set = null;
-        }
-        if (set === null) {
-            throw notFound(`memory document not found: ${nameRaw}`, {
-                memory: nameRaw,
-                next: 'Run `crtr memory find <query>` to discover documents, or `crtr memory list` to browse the inventory.',
-            });
-        }
-        const doc = requireUnambiguousDoc(set);
-        const origin = doc.frontmatter?.['origin'];
-        if (origin === undefined || typeof origin !== 'object') {
-            return {
-                name: doc.name,
-                path: doc.path,
-                scope: doc.scope,
-                local_name: doc.localName,
-                store_root: doc.root,
-                physical_relative_path: doc.physicalRelativePath,
-                representation: doc.representation,
-                origin_recorded: false,
-                follow_up: 'No provenance recorded \u2014 this doc was hand-authored or created before provenance capture. Read its body with `crtr memory read ' +
-                    doc.name +
-                    '`.',
-            };
-        }
-        const str = (v) => (typeof v === 'string' ? v : null);
-        const nodeId = str(origin['node']);
-        // Deref the authoring node through the API; a 404 means it was pruned from
-        // the canvas (node stays null, the follow-up says so).
-        let node = null;
-        if (nodeId !== null) {
-            try {
-                node = await cliClient().getNode(nodeId);
-            }
-            catch (err) {
-                if (!(err instanceof ApiError && err.status === 404))
-                    throw err;
-            }
-        }
-        const sessionFile = str(node?.pi_session_file);
-        const followUp = node !== null
-            ? `Read the originating conversation at \`${sessionFile ?? '(no session captured)'}\`, browse its shared docs at \`${contextDir(nodeId)}\`, or attach live with \`crtr surface attach ${nodeId}\`.`
-            : nodeId !== null
-                ? `The authoring node \`${nodeId}\` has been pruned from the canvas; its context dir may persist at \`${contextDir(nodeId)}\`.`
-                : 'Authored by the user at the CLI \u2014 no node conversation to deref.';
-        return {
-            name: doc.name,
-            path: doc.path,
-            scope: doc.scope,
-            local_name: doc.localName,
-            store_root: doc.root,
-            physical_relative_path: doc.physicalRelativePath,
-            representation: doc.representation,
-            origin_recorded: true,
-            created: str(origin['created']) ?? undefined,
-            cwd: str(origin['cwd']) ?? undefined,
-            node: nodeId ?? undefined,
-            node_present: nodeId !== null ? node !== null : undefined,
-            node_kind: node?.kind ?? undefined,
-            node_mode: node?.mode ?? undefined,
-            node_status: node?.status ?? undefined,
-            node_description: node?.description ?? undefined,
-            session_file: sessionFile ?? undefined,
-            context_dir: nodeId !== null ? contextDir(nodeId) : undefined,
-            follow_up: followUp,
-        };
-    },
-});
+var f=Object.defineProperty;var u=(r,i)=>f(r,"name",{value:i,configurable:!0});import{defineLeaf as y}from"../../core/command.js";import{CrtrError as g,notFound as w}from"../../core/errors.js";import{loadMemoryStoreView as _,resolveMemoryCandidates as v}from"../../core/memory-resolver.js";import{ApiError as b}from"../../api/index.js";import{cliClient as q}from"../api-client.js";import{contextDir as l}from"../../core/canvas/paths.js";import{requireMountedStore as k,requireUnambiguousDoc as x,resolveReadSelector as R,selectorParam as p}from"./shared.js";const I=y({name:"origin",description:"deref a memory document back to the node + conversation that created it",whenToUse:"you are looking at a stored memory and want to know WHERE it came from \u2014 which node authored it, in what conversation, when, and in which project. Reads the `origin` provenance block the runtime stamps at creation and derefs the node pointer to its live session conversation, context dir, and current state. Docs hand-authored or created before provenance capture carry no origin \u2014 the command says so rather than guessing.",help:{name:"memory origin",summary:"resolve a doc name to its creation provenance and deref the originating node",params:[{kind:"positional",name:"name",required:!0,constraint:"Full canonical memory name (a project document includes its namespace). Resolved exactly across the selected target view; a same-store physical collision is refused."},p("scope-read"),p("dir"),p("profile")],output:[{name:"name",type:"string",required:!0,constraint:"Resolved document name."},{name:"path",type:"string",required:!0,constraint:"Absolute path to the document on disk."},{name:"scope",type:"string",required:!0,constraint:"Scope whose ordered store view supplied the document."},{name:"local_name",type:"string",required:!0,constraint:"Store-local identity, before project namespace composition."},{name:"store_root",type:"string",required:!0,constraint:"Absolute memory store root containing the document."},{name:"physical_relative_path",type:"string",required:!0,constraint:"Store-relative physical markdown path; sidecars preserve this shape."},{name:"representation",type:"string",required:!0,constraint:"Physical representation: leaf-file or directory-index."},{name:"origin_recorded",type:"boolean",required:!0,constraint:"true when the doc carries an `origin` provenance block; false for hand-authored or pre-provenance docs."},{name:"created",type:"string",required:!1,constraint:"ISO timestamp the doc was created. Absent when origin_recorded is false."},{name:"cwd",type:"string",required:!1,constraint:"Working directory the authoring conversation ran in."},{name:"node",type:"string",required:!1,constraint:"Node id that authored the doc, or null when written by the user at the CLI (no node)."},{name:"node_present",type:"boolean",required:!1,constraint:"true when that node still exists on the canvas (deref below is live); false when it has been pruned."},{name:"node_kind",type:"string",required:!1,constraint:"Kind of the authoring node (only when node_present)."},{name:"node_mode",type:"string",required:!1,constraint:"Mode of the authoring node (only when node_present)."},{name:"node_status",type:"string",required:!1,constraint:"Current lifecycle status of the authoring node (only when node_present)."},{name:"node_description",type:"string",required:!1,constraint:"The authoring node\u2019s description (only when node_present)."},{name:"session_file",type:"string",required:!1,constraint:"Absolute path to the originating conversation\u2019s pi session .jsonl (only when node_present and a session was captured) \u2014 read it to see the conversation that produced the doc."},{name:"context_dir",type:"string",required:!1,constraint:"Absolute path to the authoring node\u2019s context dir (its shared document store)."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands to inspect the origin."}],outputKind:"object",effects:["None. Read-only."]},run:u(async r=>{const i=r.name,a=R({scope:r.scope,dir:r.dir,profile:r.profile});a.store!==null&&k(a.store);let d;try{d=a.store!==null?_(a.store,!0).candidates(i):v(i,{includeDescendants:!0,...a.scope?{scope:a.scope}:{}})}catch(n){if(!(n instanceof g&&n.code==="not_found"))throw n;d=null}if(d===null)throw w(`memory document not found: ${i}`,{memory:i,next:"Run `crtr memory find <query>` to discover documents, or `crtr memory list` to browse the inventory."});const e=x(d),s=e.frontmatter?.origin;if(s===void 0||typeof s!="object")return{name:e.name,path:e.path,scope:e.scope,local_name:e.localName,store_root:e.root,physical_relative_path:e.physicalRelativePath,representation:e.representation,origin_recorded:!1,follow_up:"No provenance recorded \u2014 this doc was hand-authored or created before provenance capture. Read its body with `crtr memory read "+e.name+"`."};const c=u(n=>typeof n=="string"?n:null,"str"),t=c(s.node);let o=null;if(t!==null)try{o=await q().getNode(t)}catch(n){if(!(n instanceof b&&n.status===404))throw n}const h=c(o?.pi_session_file),m=o!==null?`Read the originating conversation at \`${h??"(no session captured)"}\`, browse its shared docs at \`${l(t)}\`, or attach live with \`crtr surface attach ${t}\`.`:t!==null?`The authoring node \`${t}\` has been pruned from the canvas; its context dir may persist at \`${l(t)}\`.`:"Authored by the user at the CLI \u2014 no node conversation to deref.";return{name:e.name,path:e.path,scope:e.scope,local_name:e.localName,store_root:e.root,physical_relative_path:e.physicalRelativePath,representation:e.representation,origin_recorded:!0,created:c(s.created)??void 0,cwd:c(s.cwd)??void 0,node:t??void 0,node_present:t!==null?o!==null:void 0,node_kind:o?.kind??void 0,node_mode:o?.mode??void 0,node_status:o?.status??void 0,node_description:o?.description??void 0,session_file:h??void 0,context_dir:t!==null?l(t):void 0,follow_up:m}},"run")});export{I as originLeaf};