@north-light/crouter 0.3.318 → 0.3.319

package/dist/commands/sys/context/admin.js

@@ -1,126 +1,2 @@
-// `crtr sys context admin` — the interactive surface over the context system:
-// dial a configuration snapshot, watch every document's resolved rung across
-// the six events, and edit the surfaces, gates, and caps that decide it.
-// Mutations route through `memory edit` / `memory move` and the profile
-// manifest, never through direct file writes.
-import { resolve as resolvePath } from 'node:path';
-import { defineLeaf } from '../../../core/command.js';
-import { InputError } from '../../../core/io.js';
-import { ApiError } from '../../../api/index.js';
-import { cliClient } from '../../api-client.js';
-import { SURFACE_EVENTS } from '../../../core/substrate/schema.js';
-import { ambientMemoryTarget } from '../../../core/memory-resolver.js';
-import { getDefaultProfileId } from '../../../core/profiles/default-binding.js';
-import { resolveProfileOperand } from '../../../core/profiles/manifest.js';
-export const adminLeaf = defineLeaf({
-    name: 'admin',
-    description: 'browse and edit the context surface interactively',
-    whenToUse: 'you are shaping what agents load rather than answering one question about it — comparing snapshots, sweeping which documents fire where, and editing surfaces, gates, or caps in place',
-    help: {
-        name: 'sys context admin',
-        summary: 'interactive browser and editor for the memory context surface',
-        params: [
-            { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Open with the snapshot derived from this live node instead of the defaults.' },
-            { kind: 'flag', name: 'kind', type: 'string', required: false, constraint: 'Opening node kind. Defaults to the --node value, else `general`.' },
-            { kind: 'flag', name: 'mode', type: 'enum', choices: ['base', 'orchestrator'], required: false, constraint: 'Opening node mode. Defaults to `base`.' },
-            { kind: 'flag', name: 'profile', type: 'string', required: false, constraint: 'Profile id whose memory store and project-memory caps apply. Defaults to the selected profile.' },
-            { kind: 'flag', name: 'cwd', type: 'path', required: false, constraint: 'Directory the project stores resolve from. Defaults to the current directory.' },
-            { kind: 'flag', name: 'event', type: 'enum', choices: [...SURFACE_EVENTS], required: false, constraint: 'Opening event for the detail panel. Defaults to `boot`.' },
-        ],
-        output: [
-            { name: 'edited', type: 'array', required: false, constraint: 'Canonical names of the documents changed during the session; absent when nothing was changed.' },
-            { name: 'cap_changes', type: 'array', required: false, constraint: 'Profile project-memory caps changed during the session, each as store path and new rung; absent when none were.' },
-        ],
-        outputKind: 'object',
-        effects: [
-            'Interactive: requires a TTY.',
-            'Edits memory documents through `memory edit` / `memory move` with rationale `editor` when you choose an edit action.',
-            'Writes profile project-memory caps to the profile manifest when you change one.',
-        ],
-    },
-    run: async (input) => {
-        if (!process.stdout.isTTY) {
-            throw new InputError({
-                error: 'not_a_tty',
-                message: 'sys context admin is interactive and needs a TTY',
-                next: 'Run it in a terminal, or use `crtr sys context resolve` and `crtr sys context doc` for scriptable reads.',
-            });
-        }
-        const node = await fetchNodeOrNull(input['node']?.trim() ?? '');
-        const ambient = ambientMemoryTarget();
-        const profileId = input['profile']?.trim();
-        const cwd = input['cwd']?.trim();
-        const resolvedCwd = cwd === undefined || cwd === '' ? (node?.cwd ?? ambient.cwd) : resolvePath(cwd);
-        const seed = {
-            kind: input['kind']?.trim() || node?.kind || 'general',
-            mode: input['mode'] ?? node?.mode ?? 'base',
-            lifecycle: node?.lifecycle ?? 'terminal',
-            hasManager: node?.parent != null,
-            profileId: profileId === undefined || profileId === ''
-                ? (node?.profile_id ?? ambient.profileId ?? getDefaultProfileId(resolvedCwd))
-                : resolveProfileOperand(profileId).profileId,
-            cwd: resolvedCwd,
-            nodeId: node?.node_id ?? null,
-            depth: node === null ? 0 : await spineDepth(node),
-            event: (input['event'] ?? 'boot'),
-            file: '',
-            docName: '',
-            command: '',
-        };
-        // Deferred so the page host, its terminal, and the whole TUI dependency
-        // chain load only for the interactive run — every other `sys context` leaf
-        // stays a plain read.
-        const { runContextAdmin } = await import('./admin/shell.js');
-        const result = await runContextAdmin(seed);
-        if (result === undefined)
-            return {};
-        return {
-            ...(result.edited.length > 0 ? { edited: result.edited } : {}),
-            ...(result.capChanges.length > 0
-                ? { cap_changes: result.capChanges.map((change) => ({ path: change.path, memory: change.memory })) }
-                : {}),
-        };
-    },
-    render: (r) => {
-        const edited = r['edited'] ?? [];
-        const caps = r['cap_changes'] ?? [];
-        if (edited.length === 0 && caps.length === 0)
-            return 'Closed the context admin with nothing changed.';
-        const lines = [
-            ...edited.map((name) => `- edited ${name}`),
-            ...caps.map((cap) => `- ceiling ${cap.path} → ${cap.memory}`),
-        ];
-        return lines.join('\n');
-    },
-});
-/** A `--node` id that no longer resolves seeds nothing rather than failing: the
- *  page is useful without a live node, and the ids an agent has to hand are the
- *  ones most likely to have been pruned. */
-async function fetchNodeOrNull(nodeId) {
-    if (nodeId === '')
-        return null;
-    try {
-        return await cliClient().getNode(nodeId);
-    }
-    catch (err) {
-        if (err instanceof ApiError && err.status === 404)
-            return null;
-        throw err;
-    }
-}
-/** Hops from a node up to its root orchestrator, walked through the API so this
- *  leaf never reaches the canvas db. A pruned ancestor ends the walk. */
-async function spineDepth(node) {
-    const seen = new Set([node.node_id]);
-    let parent = node.parent;
-    let hops = 0;
-    while (parent != null && !seen.has(parent)) {
-        seen.add(parent);
-        hops += 1;
-        const next = await fetchNodeOrNull(parent);
-        if (next === null)
-            break;
-        parent = next.parent;
-    }
-    return hops;
-}
+var f=Object.defineProperty;var i=(t,e)=>f(t,"name",{value:e,configurable:!0});import{resolve as p}from"node:path";import{defineLeaf as h}from"../../../core/command.js";import{InputError as u}from"../../../core/io.js";import{ApiError as g}from"../../../api/index.js";import{cliClient as y}from"../../api-client.js";import{SURFACE_EVENTS as w}from"../../../core/substrate/schema.js";import{ambientMemoryTarget as v}from"../../../core/memory-resolver.js";import{getDefaultProfileId as b}from"../../../core/profiles/default-binding.js";import{resolveProfileOperand as k}from"../../../core/profiles/manifest.js";const P=h({name:"admin",description:"browse and edit the context surface interactively",whenToUse:"you are shaping what agents load rather than answering one question about it \u2014 comparing snapshots, sweeping which documents fire where, and editing surfaces, gates, or caps in place",help:{name:"sys context admin",summary:"interactive browser and editor for the memory context surface",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Open with the snapshot derived from this live node instead of the defaults."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Opening node kind. Defaults to the --node value, else `general`."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,constraint:"Opening node mode. Defaults to `base`."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id whose memory store and project-memory caps apply. Defaults to the selected profile."},{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Directory the project stores resolve from. Defaults to the current directory."},{kind:"flag",name:"event",type:"enum",choices:[...w],required:!1,constraint:"Opening event for the detail panel. Defaults to `boot`."}],output:[{name:"edited",type:"array",required:!1,constraint:"Canonical names of the documents changed during the session; absent when nothing was changed."},{name:"cap_changes",type:"array",required:!1,constraint:"Profile project-memory caps changed during the session, each as store path and new rung; absent when none were."}],outputKind:"object",effects:["Interactive: requires a TTY.","Edits memory documents through `memory edit` / `memory move` with rationale `editor` when you choose an edit action.","Writes profile project-memory caps to the profile manifest when you change one."]},run:i(async t=>{if(!process.stdout.isTTY)throw new u({error:"not_a_tty",message:"sys context admin is interactive and needs a TTY",next:"Run it in a terminal, or use `crtr sys context resolve` and `crtr sys context doc` for scriptable reads."});const e=await c(t.node?.trim()??""),n=v(),o=t.profile?.trim(),r=t.cwd?.trim(),s=r===void 0||r===""?e?.cwd??n.cwd:p(r),l={kind:t.kind?.trim()||e?.kind||"general",mode:t.mode??e?.mode??"base",lifecycle:e?.lifecycle??"terminal",hasManager:e?.parent!=null,profileId:o===void 0||o===""?e?.profile_id??n.profileId??b(s):k(o).profileId,cwd:s,nodeId:e?.node_id??null,depth:e===null?0:await x(e),event:t.event??"boot",file:"",docName:"",command:""},{runContextAdmin:m}=await import("./admin/shell.js"),a=await m(l);return a===void 0?{}:{...a.edited.length>0?{edited:a.edited}:{},...a.capChanges.length>0?{cap_changes:a.capChanges.map(d=>({path:d.path,memory:d.memory}))}:{}}},"run"),render:i(t=>{const e=t.edited??[],n=t.cap_changes??[];return e.length===0&&n.length===0?"Closed the context admin with nothing changed.":[...e.map(r=>`- edited ${r}`),...n.map(r=>`- ceiling ${r.path} \u2192 ${r.memory}`)].join(`
+`)},"render")});async function c(t){if(t==="")return null;try{return await y().getNode(t)}catch(e){if(e instanceof g&&e.status===404)return null;throw e}}i(c,"fetchNodeOrNull");async function x(t){const e=new Set([t.node_id]);let n=t.parent,o=0;for(;n!=null&&!e.has(n);){e.add(n),o+=1;const r=await c(n);if(r===null)break;n=r.parent}return o}i(x,"spineDepth");export{P as adminLeaf};

package/dist/commands/sys/context/doc.js

@@ -1,197 +1,3 @@
-// `crtr sys context doc` — the reverse question: for ONE document, everywhere
-// it surfaces and why. Authored surface entries plus a computed row per event
-// under a single configuration snapshot, from the same plan the live renderers
-// deliver from (`planDelivery`, src/core/substrate/plan.ts).
-import { defineLeaf } from '../../../core/command.js';
-import { realpathOrSelf } from '../../../core/fs-utils.js';
-import { resolveMemoryDocForTarget } from '../../../core/memory-resolver.js';
-import { InputError } from '../../../core/io.js';
-import { planDelivery } from '../../../core/substrate/plan.js';
-import { explainRecordGate } from '../../../core/substrate/gate-explain.js';
-import { parseSubstrateDoc, SURFACE_EVENTS } from '../../../core/substrate/schema.js';
-import { buildSnapshot, cell, delivers, describeSubject, entryText, exclusionReason, gateText, optionalString, payloadFor, subjectSummary, } from './resolve.js';
-export const docLeaf = defineLeaf({
-    name: 'doc',
-    description: 'show one document\u2019s delivery across every surface event',
-    whenToUse: 'a document is reaching a node it should not, or failing to reach one it should — this says which event delivers it, at what rung, and what excluded it everywhere else',
-    help: {
-        name: 'sys context doc',
-        summary: 'show where one document delivers, at what rung, and what excludes it elsewhere',
-        params: [
-            { kind: 'positional', name: 'name', required: true, constraint: 'Canonical document name, exactly as `crtr memory read` takes it.' },
-            { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Evaluate under this live node\u2019s configuration — derives kind, mode, lifecycle, has-manager, profile, and cwd from it.' },
-            { kind: 'flag', name: 'kind', type: 'string', required: false, constraint: 'Node kind of the synthetic subject. Defaults to the --node value, else `general`.' },
-            { kind: 'flag', name: 'mode', type: 'enum', choices: ['base', 'orchestrator'], required: false, constraint: 'Node mode of the synthetic subject. Defaults to `base`.' },
-            { kind: 'flag', name: 'lifecycle', type: 'enum', choices: ['terminal', 'resident'], required: false, constraint: 'Node lifecycle of the synthetic subject. Defaults to `terminal` for base, `resident` for orchestrator.' },
-            { kind: 'flag', name: 'has-manager', type: 'enum', choices: ['true', 'false'], required: false, constraint: 'Treat the subject as having a manager (a subscriber above it). Defaults to the --node value, else true.' },
-            { kind: 'flag', name: 'profile', type: 'string', required: false, constraint: 'Profile id whose memory store and project-memory caps apply. Defaults to the selected profile.' },
-            { kind: 'flag', name: 'cwd', type: 'path', required: false, constraint: 'Directory the project stores resolve from. Defaults to the current directory.' },
-            { kind: 'flag', name: 'event', type: 'enum', choices: [...SURFACE_EVENTS], required: false, constraint: 'Report only this event instead of all six.' },
-            { kind: 'flag', name: 'file', type: 'path', required: false, constraint: 'Payload for the read event: the file being read. Without it, no read entry matches.' },
-            { kind: 'flag', name: 'read-name', type: 'string', required: false, constraint: 'Payload for the memory-read event: the exact canonical name that read resolved to.' },
-            { kind: 'flag', name: 'command', type: 'string', required: false, constraint: 'Payload for the command and pre-command events: the command string.' },
-        ],
-        output: [
-            { name: 'name', type: 'string', required: true, constraint: 'The document\u2019s canonical name.' },
-            { name: 'kind', type: 'string', required: true, constraint: 'knowledge or preference.' },
-            { name: 'scope', type: 'string', required: true, constraint: 'node, project, profile, user, or builtin.' },
-            { name: 'store_path', type: 'string', required: true, constraint: 'Absolute path to the document file.' },
-            { name: 'project_memory_cap', type: 'string', required: true, constraint: 'The profile relationship\u2019s cap on this document\u2019s store; it binds at boot and workspace-open only.' },
-            { name: 'subject', type: 'object', required: true, constraint: 'The configuration snapshot every row was computed under.' },
-            { name: 'surfaces', type: 'array', required: true, constraint: 'The document\u2019s authored surface entries: event, match globs, gate, rung.' },
-            { name: 'events', type: 'array', required: true, constraint: 'One row per event: event, delivers, authored_rung, capped_rung, final_rung, doc_gate, entry_gate, matched_entry, winner, shadowed_by, and — when the event\u2019s corpus does not carry this document at all — excluded saying so.' },
-        ],
-        outputKind: 'object',
-        effects: ['None. Read-only.'],
-    },
-    run: async (input) => {
-        const snapshot = await buildSnapshot(input);
-        const doc = resolveDoc(input['name'], snapshot.target);
-        const events = optionalString(input['event']) === null
-            ? [...SURFACE_EVENTS]
-            : [input['event']];
-        const flags = {
-            file: optionalString(input['file']),
-            readName: optionalString(input['readName']),
-            command: optionalString(input['command']),
-        };
-        const targetPath = realpathOrSelf(doc.path);
-        const recordPathCache = new Map();
-        const rows = events.map((event) => {
-            const plan = planDelivery(snapshot.subject, snapshot.target, event, payloadFor(event, flags, snapshot.target));
-            return eventRow(event, findRecord(plan.docs, targetPath, recordPathCache), plan.subject);
-        });
-        return {
-            name: doc.name,
-            kind: doc.kind,
-            scope: doc.scope,
-            store_path: doc.path,
-            project_memory_cap: doc.projectMemory,
-            subject: subjectSummary(snapshot.subject),
-            surfaces: doc.surfaces.map(surfaceRow),
-            events: rows,
-        };
-    },
-    render: (result) => renderDoc(result),
-});
-/** The document the name addresses under this snapshot's store chain — the same
- *  winner `crtr memory read` would open. A document whose frontmatter does not
- *  parse into the substrate schema has no surface behavior to report. */
-function resolveDoc(name, target) {
-    const source = resolveMemoryDocForTarget(name, target);
-    const doc = parseSubstrateDoc(source);
-    if (doc === null) {
-        throw new InputError({
-            error: 'invalid_field',
-            message: `document is not a substrate document: ${source.path}`,
-            field: 'name',
-            next: 'Give the document valid frontmatter (`kind` and `when-and-why-to-read`) with `crtr memory edit`.',
-        });
-    }
-    return doc;
-}
-/** The plan record for this exact physical document. Identity is the file, not
- *  the name: a nearer store may hold a different document under the same name,
- *  and that one is the shadower, not this row's subject. */
-function findRecord(records, targetPath, pathCache) {
-    return records.find((record) => {
-        let recordPath = pathCache.get(record.storePath);
-        if (recordPath === undefined) {
-            recordPath = realpathOrSelf(record.storePath);
-            pathCache.set(record.storePath, recordPath);
-        }
-        return recordPath === targetPath;
-    }) ?? null;
-}
-function surfaceRow(entry) {
-    return {
-        event: entry.on,
-        match: entry.match === undefined ? null : entry.match.join(', '),
-        match_frontmatter: entry.matchFrontmatter !== undefined,
-        gate: entry.gate !== undefined,
-        at: entry.at,
-    };
-}
-function eventRow(event, record, subject) {
-    if (record === null) {
-        return {
-            event,
-            delivers: false,
-            authored_rung: 'none',
-            capped_rung: 'none',
-            final_rung: 'none',
-            doc_gate: null,
-            entry_gate: null,
-            matched_entry: null,
-            winner: false,
-            shadowed_by: null,
-            excluded: `this event\u2019s corpus does not carry the document (${corpusNote(event)})`,
-        };
-    }
-    return {
-        event,
-        delivers: delivers(record),
-        authored_rung: record.authoredRung,
-        capped_rung: record.cappedRung,
-        final_rung: record.finalRung,
-        doc_gate: gateText(record.docGate, explainRecordGate(record, 'doc', subject)),
-        entry_gate: record.entryGate === null ? null : gateText(record.entryGate, explainRecordGate(record, 'entry', subject)),
-        matched_entry: entryText(record.matchedEntry),
-        winner: record.winner,
-        shadowed_by: record.shadowedBy === null ? null : `${record.shadowedBy.scope}:${record.shadowedBy.path}`,
-        excluded: delivers(record) ? null : exclusionReason(record, subject),
-    };
-}
-function corpusNote(event) {
-    if (event === 'workspace-open')
-        return 'workspace-open sees project stores only';
-    if (event === 'memory-read')
-        return 'the document being read never delivers to itself';
-    return 'it is excluded from this event\u2019s document set';
-}
-function renderDoc(result) {
-    const lines = [
-        `# ${result.name}`,
-        '',
-        `- kind: ${result.kind}`,
-        `- scope: ${result.scope}`,
-        `- path: ${result.store_path}`,
-        `- project-memory cap: ${result.project_memory_cap} (binds at boot and workspace-open only)`,
-        '',
-        `subject: ${describeSubject(result.subject)}`,
-        '',
-        '## Authored surfaces',
-        '',
-        renderSurfaces(result.surfaces),
-        '',
-        '## Delivery per event',
-        '',
-        renderEvents(result.events),
-    ];
-    return lines.join('\n');
-}
-function renderSurfaces(surfaces) {
-    if (surfaces.length === 0) {
-        return 'None. The document authors no surface entry, so it only appears in its directory listing.';
-    }
-    return table(['event', 'at', 'match', 'match-frontmatter', 'gate'], surfaces.map((s) => [s.event, s.at, s.match ?? '—', s.match_frontmatter ? 'yes' : '—', s.gate ? 'yes' : '—']));
-}
-function renderEvents(events) {
-    return table(['event', 'delivers', 'authored', 'capped', 'final', 'matched', 'gate', 'why not'], events.map((e) => [
-        e.event,
-        e.delivers ? 'yes' : 'no',
-        e.authored_rung,
-        e.capped_rung,
-        e.final_rung,
-        e.matched_entry ?? '—',
-        e.doc_gate ?? '—',
-        e.excluded ?? '—',
-    ]));
-}
-function table(cols, rows) {
-    return [
-        `| ${cols.join(' | ')} |`,
-        `| ${cols.map(() => '---').join(' | ')} |`,
-        ...rows.map((r) => `| ${r.map(cell).join(' | ')} |`),
-    ].join('\n');
-}
+var v=Object.defineProperty;var a=(t,e)=>v(t,"name",{value:e,configurable:!0});import{defineLeaf as w}from"../../../core/command.js";import{realpathOrSelf as c}from"../../../core/fs-utils.js";import{resolveMemoryDocForTarget as _}from"../../../core/memory-resolver.js";import{InputError as b}from"../../../core/io.js";import{planDelivery as j}from"../../../core/substrate/plan.js";import{explainRecordGate as u}from"../../../core/substrate/gate-explain.js";import{parseSubstrateDoc as k,SURFACE_EVENTS as l}from"../../../core/substrate/schema.js";import{buildSnapshot as q,cell as x,delivers as m,describeSubject as D,entryText as $,exclusionReason as R,gateText as h,optionalString as s,payloadFor as T,subjectSummary as P}from"./resolve.js";const H=w({name:"doc",description:"show one document\u2019s delivery across every surface event",whenToUse:"a document is reaching a node it should not, or failing to reach one it should \u2014 this says which event delivers it, at what rung, and what excluded it everywhere else",help:{name:"sys context doc",summary:"show where one document delivers, at what rung, and what excludes it elsewhere",params:[{kind:"positional",name:"name",required:!0,constraint:"Canonical document name, exactly as `crtr memory read` takes it."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Evaluate under this live node\u2019s configuration \u2014 derives kind, mode, lifecycle, has-manager, profile, and cwd from it."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Node kind of the synthetic subject. Defaults to the --node value, else `general`."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,constraint:"Node mode of the synthetic subject. Defaults to `base`."},{kind:"flag",name:"lifecycle",type:"enum",choices:["terminal","resident"],required:!1,constraint:"Node lifecycle of the synthetic subject. Defaults to `terminal` for base, `resident` for orchestrator."},{kind:"flag",name:"has-manager",type:"enum",choices:["true","false"],required:!1,constraint:"Treat the subject as having a manager (a subscriber above it). Defaults to the --node value, else true."},{kind:"flag",name:"profile",type:"string",required:!1,constraint:"Profile id whose memory store and project-memory caps apply. Defaults to the selected profile."},{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Directory the project stores resolve from. Defaults to the current directory."},{kind:"flag",name:"event",type:"enum",choices:[...l],required:!1,constraint:"Report only this event instead of all six."},{kind:"flag",name:"file",type:"path",required:!1,constraint:"Payload for the read event: the file being read. Without it, no read entry matches."},{kind:"flag",name:"read-name",type:"string",required:!1,constraint:"Payload for the memory-read event: the exact canonical name that read resolved to."},{kind:"flag",name:"command",type:"string",required:!1,constraint:"Payload for the command and pre-command events: the command string."}],output:[{name:"name",type:"string",required:!0,constraint:"The document\u2019s canonical name."},{name:"kind",type:"string",required:!0,constraint:"knowledge or preference."},{name:"scope",type:"string",required:!0,constraint:"node, project, profile, user, or builtin."},{name:"store_path",type:"string",required:!0,constraint:"Absolute path to the document file."},{name:"project_memory_cap",type:"string",required:!0,constraint:"The profile relationship\u2019s cap on this document\u2019s store; it binds at boot and workspace-open only."},{name:"subject",type:"object",required:!0,constraint:"The configuration snapshot every row was computed under."},{name:"surfaces",type:"array",required:!0,constraint:"The document\u2019s authored surface entries: event, match globs, gate, rung."},{name:"events",type:"array",required:!0,constraint:"One row per event: event, delivers, authored_rung, capped_rung, final_rung, doc_gate, entry_gate, matched_entry, winner, shadowed_by, and \u2014 when the event\u2019s corpus does not carry this document at all \u2014 excluded saying so."}],outputKind:"object",effects:["None. Read-only."]},run:a(async t=>{const e=await q(t),n=N(t.name,e.target),r=s(t.event)===null?[...l]:[t.event],o={file:s(t.file),readName:s(t.readName),command:s(t.command)},p=c(n.path),y=new Map,g=r.map(i=>{const d=j(e.subject,e.target,i,T(i,o,e.target));return G(i,S(d.docs,p,y),d.subject)});return{name:n.name,kind:n.kind,scope:n.scope,store_path:n.path,project_memory_cap:n.projectMemory,subject:P(e.subject),surfaces:n.surfaces.map(E),events:g}},"run"),render:a(t=>A(t),"render")});function N(t,e){const n=_(t,e),r=k(n);if(r===null)throw new b({error:"invalid_field",message:`document is not a substrate document: ${n.path}`,field:"name",next:"Give the document valid frontmatter (`kind` and `when-and-why-to-read`) with `crtr memory edit`."});return r}a(N,"resolveDoc");function S(t,e,n){return t.find(r=>{let o=n.get(r.storePath);return o===void 0&&(o=c(r.storePath),n.set(r.storePath,o)),o===e})??null}a(S,"findRecord");function E(t){return{event:t.on,match:t.match===void 0?null:t.match.join(", "),match_frontmatter:t.matchFrontmatter!==void 0,gate:t.gate!==void 0,at:t.at}}a(E,"surfaceRow");function G(t,e,n){return e===null?{event:t,delivers:!1,authored_rung:"none",capped_rung:"none",final_rung:"none",doc_gate:null,entry_gate:null,matched_entry:null,winner:!1,shadowed_by:null,excluded:`this event\u2019s corpus does not carry the document (${F(t)})`}:{event:t,delivers:m(e),authored_rung:e.authoredRung,capped_rung:e.cappedRung,final_rung:e.finalRung,doc_gate:h(e.docGate,u(e,"doc",n)),entry_gate:e.entryGate===null?null:h(e.entryGate,u(e,"entry",n)),matched_entry:$(e.matchedEntry),winner:e.winner,shadowed_by:e.shadowedBy===null?null:`${e.shadowedBy.scope}:${e.shadowedBy.path}`,excluded:m(e)?null:R(e,n)}}a(G,"eventRow");function F(t){return t==="workspace-open"?"workspace-open sees project stores only":t==="memory-read"?"the document being read never delivers to itself":"it is excluded from this event\u2019s document set"}a(F,"corpusNote");function A(t){return[`# ${t.name}`,"",`- kind: ${t.kind}`,`- scope: ${t.scope}`,`- path: ${t.store_path}`,`- project-memory cap: ${t.project_memory_cap} (binds at boot and workspace-open only)`,"",`subject: ${D(t.subject)}`,"","## Authored surfaces","",B(t.surfaces),"","## Delivery per event","",M(t.events)].join(`
+`)}a(A,"renderDoc");function B(t){return t.length===0?"None. The document authors no surface entry, so it only appears in its directory listing.":f(["event","at","match","match-frontmatter","gate"],t.map(e=>[e.event,e.at,e.match??"\u2014",e.match_frontmatter?"yes":"\u2014",e.gate?"yes":"\u2014"]))}a(B,"renderSurfaces");function M(t){return f(["event","delivers","authored","capped","final","matched","gate","why not"],t.map(e=>[e.event,e.delivers?"yes":"no",e.authored_rung,e.capped_rung,e.final_rung,e.matched_entry??"\u2014",e.doc_gate??"\u2014",e.excluded??"\u2014"]))}a(M,"renderEvents");function f(t,e){return[`| ${t.join(" | ")} |`,`| ${t.map(()=>"---").join(" | ")} |`,...e.map(n=>`| ${n.map(x).join(" | ")} |`)].join(`
+`)}a(f,"table");export{H as docLeaf};