@north-light/crouter 0.3.318 → 0.3.319

package/dist/commands/sys/context/prompt-review.js

@@ -1,291 +1,11 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { defineLeaf } from '../../../core/command.js';
-import { InputError, readStdinRaw } from '../../../core/io.js';
-import { userScopeRoot } from '../../../core/scope.js';
-import { ApiError } from '../../../api/index.js';
-import { cliClient } from '../../api-client.js';
-import { readMergedLaunchConfig, subKindsAvailableTo } from '../../../core/config.js';
-import { LAUNCH_SYSTEM_PROMPT } from '../../../core/runtime/launch-prompt.js';
-// De-barreled imports: substrate/index.js re-exports subject.js (canvas-db), so
-// this CLI leaf imports the PURE render fns from render.js and the pure subject
-// fields from subject-fields.js/schema.js directly, never the barrel. Spine
-// depth is computed via the API (spineDepthViaApi), not subject.js's spineDepth.
-import { renderPreferencesForSubject, renderKnowledgeForSubject } from '../../../core/substrate/render.js';
-import { scopeForCwd, profileNameFor } from '../../../core/substrate/subject-fields.js';
-function resolveLifecycle(mode, lifecycle) {
-    if (lifecycle !== undefined)
-        return lifecycle;
-    return mode === 'orchestrator' ? 'resident' : 'terminal';
-}
-function readJson(raw) {
-    try {
-        return JSON.parse(raw);
-    }
-    catch (err) {
-        throw new InputError({
-            error: 'invalid_json',
-            message: `stdin is not valid JSON: ${String(err)}`,
-            field: 'stdin',
-            next: 'Pass the comments deck JSON on stdin.',
-        });
-    }
-}
-function parseBool(value, field, defaultValue) {
-    if (value === undefined)
-        return defaultValue;
-    if (value === true || value === false)
-        return value;
-    if (typeof value !== 'string') {
-        throw new InputError({ error: 'invalid_field', message: `${field} must be true or false`, field, next: `Use true or false for ${field}.` });
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === 'true')
-        return true;
-    if (normalized === 'false')
-        return false;
-    throw new InputError({ error: 'invalid_field', message: `${field} must be true or false`, field, next: `Use true or false for ${field}.` });
-}
-function optionalString(value) {
-    return typeof value === 'string' && value.trim() !== '' ? value : null;
-}
-function approxTokens(text) {
-    return Math.ceil(text.length / 4);
-}
-function topLevelKinds() {
-    const registry = readMergedLaunchConfig().kinds;
-    return Object.entries(registry)
-        .filter(([kind]) => !kind.includes('/'))
-        .map(([kind, cfg]) => ({ kind, whenToUse: cfg.whenToUse }))
-        .sort((a, b) => a.kind.localeCompare(b.kind));
-}
-function subKindsFor(kind) {
-    return subKindsAvailableTo(kind);
-}
-function reviewList() {
-    const kinds = topLevelKinds();
-    const subPersonas = {};
-    for (const { kind } of kinds)
-        subPersonas[kind] = subKindsFor(kind);
-    return { kinds, modes: ['base', 'orchestrator'], lifecycles: ['terminal', 'resident'], subPersonas };
-}
-/** Fetch a node's detail via the API, mapping the daemon's 404 to null so an
- *  absent/pruned `--node` id degrades to the node-less prompt (no runtime
- *  substrate layers) instead of throwing. */
-async function fetchNodeOrNull(nodeId) {
-    if (nodeId === null)
-        return null;
-    try {
-        return await cliClient().getNode(nodeId);
-    }
-    catch (err) {
-        if (err instanceof ApiError && err.status === 404)
-            return null;
-        throw err;
-    }
-}
-/** Spine distance from `nodeId` up to its root orchestrator, computed via the
- *  API (crtrd) parent-walk rather than a direct canvas-db read: count hops up
- *  the parent chain until a node with no parent (the root, depth 0). Cycle-
- *  guarded; a 404 mid-walk (a pruned ancestor) stops the walk. Mirrors
- *  subject.ts's `spineDepth` but keeps this CLI leaf off the canvas-db. */
-async function spineDepthViaApi(nodeId) {
-    let cur = nodeId;
-    const seen = new Set();
-    let hops = 0;
-    while (cur !== null) {
-        if (seen.has(cur))
-            break;
-        seen.add(cur);
-        const node = await fetchNodeOrNull(cur);
-        if (node === null || node.parent == null)
-            break;
-        cur = node.parent;
-        hops++;
-    }
-    return hops;
-}
-async function buildReviewSubject(kind, mode, lifecycle, hasManager, node) {
-    const cwd = node?.cwd ?? process.cwd();
-    return {
-        kind,
-        mode,
-        lifecycle,
-        hasManager,
-        cwd,
-        scope: scopeForCwd(cwd),
-        orchestration: { depth: node !== null ? await spineDepthViaApi(node.node_id) : 0 },
-        profile: profileNameFor(node?.profile_id),
-    };
-}
-function spliceIntoScaffold(scaffold, block) {
-    const anchor = '\n\nGuidelines:';
-    const idx = scaffold.indexOf(anchor);
-    if (idx === -1)
-        return `${scaffold}\n\n${block}`;
-    return `${scaffold.slice(0, idx)}\n\n${block}${scaffold.slice(idx)}`;
-}
-function promptReviewPath() {
-    const reviewsDir = join(userScopeRoot(), 'prompt-reviews');
-    mkdirSync(reviewsDir, { recursive: true });
-    return join(reviewsDir, `${new Date().toISOString()}.md`);
-}
-function renderExportDeck(deck) {
-    const lines = [];
-    lines.push(`# Prompt review — ${deck.config.kind}/${deck.config.mode}`);
-    lines.push('');
-    lines.push('## Config');
-    lines.push(`- timestamp: ${new Date().toISOString()}`);
-    lines.push(`- kind: ${deck.config.kind}`);
-    lines.push(`- mode: ${deck.config.mode}`);
-    lines.push(`- lifecycle: ${deck.config.lifecycle}`);
-    lines.push(`- hasManager: ${String(deck.config.hasManager)}`);
-    lines.push(`- node: ${deck.config.node ?? '(none)'}`);
-    lines.push('');
-    lines.push('## Comments');
-    if (deck.comments.length === 0) {
-        lines.push('- none');
-    }
-    else {
-        for (const comment of deck.comments) {
-            lines.push(`### ${comment.label} (${comment.layerId})`);
-            lines.push(`- source: \`${comment.sourcePath ?? '(generated)'}\` (${comment.scope})`);
-            if (comment.anchor !== null) {
-                lines.push('> ' + comment.anchor.split('\n').join('\n> '));
-            }
-            lines.push(comment.body);
-            lines.push('');
-        }
-        if (lines[lines.length - 1] === '')
-            lines.pop();
-    }
-    lines.push('');
-    lines.push('## Prompt sources (edit these)');
-    const seen = new Set();
-    for (const source of deck.sources) {
-        const key = `${source.scope}:${source.path}`;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        lines.push(`- ${source.label} — \`${source.path}\` (${source.scope})`);
-    }
-    lines.push('');
-    lines.push('These are review comments on an assembled system prompt; edit the listed source files to address them.');
-    return lines.join('\n') + '\n';
-}
-function exportReview(deck) {
-    const path = promptReviewPath();
-    writeFileSync(path, renderExportDeck(deck), 'utf8');
-    return { path };
-}
-async function resolveDeck(input) {
-    const kind = input['kind'];
-    const mode = input['mode'] ?? 'base';
-    const lifecycle = resolveLifecycle(mode, input['lifecycle']);
-    const hasManager = parseBool(input['hasManager'], 'hasManager', true);
-    const nodeId = optionalString(input['node']);
-    if (kind === undefined || kind.trim() === '') {
-        throw new InputError({ error: 'missing_parameter', message: 'kind is required', field: 'kind', next: 'Pass --kind <kind> or use --list.' });
-    }
-    const node = await fetchNodeOrNull(nodeId);
-    const subject = await buildReviewSubject(kind, mode, lifecycle, hasManager, node);
-    const { block, contentDocs, tree } = renderPreferencesForSubject(subject);
-    const layers = [
-        {
-            id: 'launch-scaffold', label: 'Launch scaffold', group: 'generated',
-            source: 'generated: launch scaffold', sourcePath: null, scope: 'generated',
-            included: true, condition: null, text: LAUNCH_SYSTEM_PROMPT,
-            tokens: approxTokens(LAUNCH_SYSTEM_PROMPT), chars: LAUNCH_SYSTEM_PROMPT.length,
-        },
-        ...contentDocs.map((d) => ({
-            id: d.name, label: d.name, group: 'substrate',
-            source: `memory: ${d.name}`, sourcePath: d.path, scope: d.scope,
-            included: true, condition: null, text: d.body,
-            tokens: approxTokens(d.body), chars: d.body.length,
-        })),
-    ];
-    if (tree !== '') {
-        layers.push({
-            id: 'preference-catalog', label: 'Preference catalog (routing entries)', group: 'substrate',
-            source: 'generated: preference catalog', sourcePath: null, scope: 'generated',
-            included: true, condition: null, text: tree, tokens: approxTokens(tree), chars: tree.length,
-        });
-    }
-    if (node !== null) {
-        const knowledge = renderKnowledgeForSubject(subject, node.node_id);
-        if (knowledge !== '') {
-            layers.push({
-                id: 'memory-knowledge', label: 'Memory (knowledge) — context message, not system prompt',
-                group: 'substrate', source: 'runtime-spliced', sourcePath: null, scope: 'runtime',
-                included: false, condition: 'session_start context message, not the system prompt',
-                text: knowledge, tokens: approxTokens(knowledge), chars: knowledge.length,
-            });
-        }
-    }
-    const assembled = spliceIntoScaffold(LAUNCH_SYSTEM_PROMPT, block);
-    const sources = [];
-    const seen = new Set();
-    for (const d of contentDocs) {
-        const key = `${d.scope}:${d.path}`;
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        sources.push({ id: d.name, label: d.name, path: d.path, scope: d.scope });
-    }
-    return {
-        config: { kind, mode, lifecycle, hasManager, node: node?.node_id ?? null },
-        layers,
-        assembled,
-        total: { tokens: approxTokens(assembled), chars: assembled.length },
-        sources,
-    };
-}
-export const promptReviewLeaf = defineLeaf({
-    name: 'prompt-review',
-    description: 'inspect an assembled prompt and export review notes',
-    whenToUse: 'you want to inspect a composed persona prompt for a kind/mode combo, compare the space around it, or export review notes back to source files',
-    help: {
-        name: 'sys context prompt-review',
-        summary: 'inspect an assembled prompt and export review notes',
-        params: [
-            { kind: 'positional', name: 'action', type: 'string', required: false, constraint: 'Optional subcommand: export. Omit for the assembled prompt contract.' },
-            { kind: 'flag', name: 'kind', type: 'string', required: false, constraint: 'Persona kind to inspect. Required unless --list or export.' },
-            { kind: 'flag', name: 'mode', type: 'enum', choices: ['base', 'orchestrator'], required: false, default: 'base', constraint: 'Persona mode. Default: base.' },
-            { kind: 'flag', name: 'lifecycle', type: 'enum', choices: ['terminal', 'resident'], required: false, constraint: 'Lifecycle axis. Default: base -> terminal, orchestrator -> resident.' },
-            { kind: 'flag', name: 'has-manager', type: 'string', required: false, default: 'true', constraint: 'Whether the node reports to a manager. Use true or false. Default: true.' },
-            { kind: 'flag', name: 'node', type: 'string', required: false, constraint: 'Optional node id. When the node exists, runtime substrate layers are appended.' },
-            { kind: 'flag', name: 'list', type: 'bool', required: false, constraint: 'List the available kinds, modes, lifecycles, and sub-personas.' },
-        ],
-        output: [
-            { name: 'config', type: 'object', required: false, constraint: 'Resolved config: {kind, mode, lifecycle, hasManager, node}.' },
-            { name: 'layers', type: 'object[]', required: false, constraint: 'Ordered prompt layers, including excluded alternatives and provenance.' },
-            { name: 'assembled', type: 'string', required: false, constraint: 'The assembled prompt string.' },
-            { name: 'total', type: 'object', required: false, constraint: 'Approximate token/char totals for included layers.' },
-            { name: 'sources', type: 'object[]', required: false, constraint: 'De-duplicated source files referenced by the prompt.' },
-            { name: 'kinds', type: 'object[]', required: false, constraint: 'Available kinds for --list.' },
-            { name: 'modes', type: 'string[]', required: false, constraint: 'Mode choices for --list.' },
-            { name: 'lifecycles', type: 'string[]', required: false, constraint: 'Lifecycle choices for --list.' },
-            { name: 'subPersonas', type: 'object', required: false, constraint: 'Available sub-personas keyed by kind for --list.' },
-            { name: 'path', type: 'string', required: false, constraint: 'Written markdown path for export.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only inspection, or writes a review markdown file under `~/.crouter/prompt-reviews/`.'],
-    },
-    run: async (input) => {
-        const action = input['action'];
-        const isList = input['list'] === true;
-        const hasManager = parseBool(input['hasManager'], 'hasManager', true);
-        if (action !== undefined && action !== 'export') {
-            throw new InputError({ error: 'unknown_action', message: `unknown action: ${action}`, field: 'action', next: 'Use `export` or omit the positional action.' });
-        }
-        if (action === 'export') {
-            const raw = await readStdinRaw();
-            const deck = readJson(raw);
-            return exportReview(deck);
-        }
-        if (isList)
-            return reviewList();
-        const deck = await resolveDeck({ ...input, hasManager });
-        return deck;
-    },
-});
+var S=Object.defineProperty;var s=(n,e)=>S(n,"name",{value:e,configurable:!0});import{mkdirSync as q,writeFileSync as P}from"node:fs";import{join as k}from"node:path";import{defineLeaf as j}from"../../../core/command.js";import{InputError as l,readStdinRaw as M}from"../../../core/io.js";import{userScopeRoot as L}from"../../../core/scope.js";import{ApiError as O}from"../../../api/index.js";import{cliClient as _}from"../../api-client.js";import{readMergedLaunchConfig as D,subKindsAvailableTo as R}from"../../../core/config.js";import{LAUNCH_SYSTEM_PROMPT as p}from"../../../core/runtime/launch-prompt.js";import{renderPreferencesForSubject as T,renderKnowledgeForSubject as C}from"../../../core/substrate/render.js";import{scopeForCwd as N,profileNameFor as U}from"../../../core/substrate/subject-fields.js";function A(n,e){return e!==void 0?e:n==="orchestrator"?"resident":"terminal"}s(A,"resolveLifecycle");function F(n){try{return JSON.parse(n)}catch(e){throw new l({error:"invalid_json",message:`stdin is not valid JSON: ${String(e)}`,field:"stdin",next:"Pass the comments deck JSON on stdin."})}}s(F,"readJson");function $(n,e,r){if(n===void 0)return r;if(n===!0||n===!1)return n;if(typeof n!="string")throw new l({error:"invalid_field",message:`${e} must be true or false`,field:e,next:`Use true or false for ${e}.`});const t=n.trim().toLowerCase();if(t==="true")return!0;if(t==="false")return!1;throw new l({error:"invalid_field",message:`${e} must be true or false`,field:e,next:`Use true or false for ${e}.`})}s($,"parseBool");function I(n){return typeof n=="string"&&n.trim()!==""?n:null}s(I,"optionalString");function u(n){return Math.ceil(n.length/4)}s(u,"approxTokens");function K(){const n=D().kinds;return Object.entries(n).filter(([e])=>!e.includes("/")).map(([e,r])=>({kind:e,whenToUse:r.whenToUse})).sort((e,r)=>e.kind.localeCompare(r.kind))}s(K,"topLevelKinds");function E(n){return R(n)}s(E,"subKindsFor");function J(){const n=K(),e={};for(const{kind:r}of n)e[r]=E(r);return{kinds:n,modes:["base","orchestrator"],lifecycles:["terminal","resident"],subPersonas:e}}s(J,"reviewList");async function x(n){if(n===null)return null;try{return await _().getNode(n)}catch(e){if(e instanceof O&&e.status===404)return null;throw e}}s(x,"fetchNodeOrNull");async function W(n){let e=n;const r=new Set;let t=0;for(;e!==null&&!r.has(e);){r.add(e);const i=await x(e);if(i===null||i.parent==null)break;e=i.parent,t++}return t}s(W,"spineDepthViaApi");async function z(n,e,r,t,i){const a=i?.cwd??process.cwd();return{kind:n,mode:e,lifecycle:r,hasManager:t,cwd:a,scope:N(a),orchestration:{depth:i!==null?await W(i.node_id):0},profile:U(i?.profile_id)}}s(z,"buildReviewSubject");function B(n,e){const t=n.indexOf(`
+
+Guidelines:`);return t===-1?`${n}
+
+${e}`:`${n.slice(0,t)}
+
+${e}${n.slice(t)}`}s(B,"spliceIntoScaffold");function G(){const n=k(L(),"prompt-reviews");return q(n,{recursive:!0}),k(n,`${new Date().toISOString()}.md`)}s(G,"promptReviewPath");function H(n){const e=[];if(e.push(`# Prompt review \u2014 ${n.config.kind}/${n.config.mode}`),e.push(""),e.push("## Config"),e.push(`- timestamp: ${new Date().toISOString()}`),e.push(`- kind: ${n.config.kind}`),e.push(`- mode: ${n.config.mode}`),e.push(`- lifecycle: ${n.config.lifecycle}`),e.push(`- hasManager: ${String(n.config.hasManager)}`),e.push(`- node: ${n.config.node??"(none)"}`),e.push(""),e.push("## Comments"),n.comments.length===0)e.push("- none");else{for(const t of n.comments)e.push(`### ${t.label} (${t.layerId})`),e.push(`- source: \`${t.sourcePath??"(generated)"}\` (${t.scope})`),t.anchor!==null&&e.push("> "+t.anchor.split(`
+`).join(`
+> `)),e.push(t.body),e.push("");e[e.length-1]===""&&e.pop()}e.push(""),e.push("## Prompt sources (edit these)");const r=new Set;for(const t of n.sources){const i=`${t.scope}:${t.path}`;r.has(i)||(r.add(i),e.push(`- ${t.label} \u2014 \`${t.path}\` (${t.scope})`))}return e.push(""),e.push("These are review comments on an assembled system prompt; edit the listed source files to address them."),e.join(`
+`)+`
+`}s(H,"renderExportDeck");function V(n){const e=G();return P(e,H(n),"utf8"),{path:e}}s(V,"exportReview");async function Y(n){const e=n.kind,r=n.mode??"base",t=A(r,n.lifecycle),i=$(n.hasManager,"hasManager",!0),a=I(n.node);if(e===void 0||e.trim()==="")throw new l({error:"missing_parameter",message:"kind is required",field:"kind",next:"Pass --kind <kind> or use --list."});const c=await x(a),h=await z(e,r,t,i,c),{block:v,contentDocs:g,tree:d}=T(h),f=[{id:"launch-scaffold",label:"Launch scaffold",group:"generated",source:"generated: launch scaffold",sourcePath:null,scope:"generated",included:!0,condition:null,text:p,tokens:u(p),chars:p.length},...g.map(o=>({id:o.name,label:o.name,group:"substrate",source:`memory: ${o.name}`,sourcePath:o.path,scope:o.scope,included:!0,condition:null,text:o.body,tokens:u(o.body),chars:o.body.length}))];if(d!==""&&f.push({id:"preference-catalog",label:"Preference catalog (routing entries)",group:"substrate",source:"generated: preference catalog",sourcePath:null,scope:"generated",included:!0,condition:null,text:d,tokens:u(d),chars:d.length}),c!==null){const o=C(h,c.node_id);o!==""&&f.push({id:"memory-knowledge",label:"Memory (knowledge) \u2014 context message, not system prompt",group:"substrate",source:"runtime-spliced",sourcePath:null,scope:"runtime",included:!1,condition:"session_start context message, not the system prompt",text:o,tokens:u(o),chars:o.length})}const m=B(p,v),y=[],b=new Set;for(const o of g){const w=`${o.scope}:${o.path}`;b.has(w)||(b.add(w),y.push({id:o.name,label:o.name,path:o.path,scope:o.scope}))}return{config:{kind:e,mode:r,lifecycle:t,hasManager:i,node:c?.node_id??null},layers:f,assembled:m,total:{tokens:u(m),chars:m.length},sources:y}}s(Y,"resolveDeck");const le=j({name:"prompt-review",description:"inspect an assembled prompt and export review notes",whenToUse:"you want to inspect a composed persona prompt for a kind/mode combo, compare the space around it, or export review notes back to source files",help:{name:"sys context prompt-review",summary:"inspect an assembled prompt and export review notes",params:[{kind:"positional",name:"action",type:"string",required:!1,constraint:"Optional subcommand: export. Omit for the assembled prompt contract."},{kind:"flag",name:"kind",type:"string",required:!1,constraint:"Persona kind to inspect. Required unless --list or export."},{kind:"flag",name:"mode",type:"enum",choices:["base","orchestrator"],required:!1,default:"base",constraint:"Persona mode. Default: base."},{kind:"flag",name:"lifecycle",type:"enum",choices:["terminal","resident"],required:!1,constraint:"Lifecycle axis. Default: base -> terminal, orchestrator -> resident."},{kind:"flag",name:"has-manager",type:"string",required:!1,default:"true",constraint:"Whether the node reports to a manager. Use true or false. Default: true."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Optional node id. When the node exists, runtime substrate layers are appended."},{kind:"flag",name:"list",type:"bool",required:!1,constraint:"List the available kinds, modes, lifecycles, and sub-personas."}],output:[{name:"config",type:"object",required:!1,constraint:"Resolved config: {kind, mode, lifecycle, hasManager, node}."},{name:"layers",type:"object[]",required:!1,constraint:"Ordered prompt layers, including excluded alternatives and provenance."},{name:"assembled",type:"string",required:!1,constraint:"The assembled prompt string."},{name:"total",type:"object",required:!1,constraint:"Approximate token/char totals for included layers."},{name:"sources",type:"object[]",required:!1,constraint:"De-duplicated source files referenced by the prompt."},{name:"kinds",type:"object[]",required:!1,constraint:"Available kinds for --list."},{name:"modes",type:"string[]",required:!1,constraint:"Mode choices for --list."},{name:"lifecycles",type:"string[]",required:!1,constraint:"Lifecycle choices for --list."},{name:"subPersonas",type:"object",required:!1,constraint:"Available sub-personas keyed by kind for --list."},{name:"path",type:"string",required:!1,constraint:"Written markdown path for export."}],outputKind:"object",effects:["Read-only inspection, or writes a review markdown file under `~/.crouter/prompt-reviews/`."]},run:s(async n=>{const e=n.action,r=n.list===!0,t=$(n.hasManager,"hasManager",!0);if(e!==void 0&&e!=="export")throw new l({error:"unknown_action",message:`unknown action: ${e}`,field:"action",next:"Use `export` or omit the positional action."});if(e==="export"){const a=await M(),c=F(a);return V(c)}return r?J():await Y({...n,hasManager:t})},"run")});export{le as promptReviewLeaf};