@north-light/crouter 0.3.317 → 0.3.319

package/dist/core/help.js

@@ -1,310 +1,9 @@
-// Descriptor types and renderers for the -h layer of the crtr CLI.
-// Pure functions — no side effects, no commander, no process.exit.
-// Rendering matches reference.md shapes exactly:
-//   root L11-32, branch L43-58, leaf L65-189.
-// Internal helpers
-/** Build a self-named runtime-state element: `<tag attr="v">body</tag>`. The
- *  subtree that owns the state authors it through this, so the tag name and any
- *  scalar metadata (e.g. a count) travel with the data and render identically
- *  at every level the block appears. The tag name carries the label, so the
- *  body never repeats it. Attribute values are controlled (counts, short
- *  tokens) and not escaped. */
-export function stateBlock(tag, attrs, body) {
-    const a = Object.entries(attrs)
-        .map(([k, v]) => ` ${k}="${v}"`)
-        .join('');
-    return `<${tag}${a}>\n${body}\n</${tag}>`;
-}
-/** Evaluate a dynamicState hook, soft-failing to null on throw or empty. */
-function evalDynamic(fn) {
-    if (fn === undefined)
-        return null;
-    try {
-        const s = fn();
-        return s !== null && s !== '' ? s : null;
-    }
-    catch {
-        return null;
-    }
-}
-/** Return the longest string length in an array of names. */
-function maxLen(names) {
-    let max = 0;
-    for (const n of names) {
-        if (n.length > max)
-            max = n.length;
-    }
-    return max;
-}
-/** Pad a string to the given width with trailing spaces. */
-function pad(s, width) {
-    return s + ' '.repeat(Math.max(0, width - s.length));
-}
-// renderRoot
-const IO_CONTRACT = 'I/O contract: flags and positional args on input; stdout is agent-ready markdown/XML you\n' +
-    'act on directly — read it as a continuation of your prompt, don\'t parse it as data.\n' +
-    'Exit 0 on success, non-zero on failure. Schemas appear at leaf -h; a leaf may route an uncommon flag to focused --flag -h guidance.';
-// Behavioral instruction (not a schema) — engrained in the appended system
-// prompt so the model treats unfamiliar capabilities as a cue to discover the
-// contract, never to guess, AND reads a command's contract before invoking it.
-// Lives in the root guide, outside any leaf -h. Scoped to state-changing
-// invocations: cheap read-only inspection doesn't need a forced preflight.
-const CAPABILITY_DISCOVERY = 'Before running a crtr command that changes state — creates, mutates, or ' +
-    "deletes anything — whose exact contract (args, flags, effects) you haven't " +
-    'verified this session, run `-h` on it and read the schema first — a reliable ' +
-    'read beats a guess that wastes a turn or triggers an unintended effect. ' +
-    'When a leaf routes a flag to focused help, read that focused help before using the flag; the compact row is discovery, not its invocation contract. ' +
-    "Same when the user names a capability you don't fully recognize: " +
-    '`-h` it before acting.';
-/** Lines for a command's subcommand affordance at root: any promoted
- *  (common/important) subcommands, then a remainder line naming how many other
- *  subcommands exist behind `crtr <name> -h`. Returns [] when the command has
- *  no listable subcommands at all. */
-function rootSubcommandLines(c) {
-    const promoted = c.subcommands ?? [];
-    const other = c.otherSubcommandCount ?? 0;
-    if (promoted.length === 0 && other === 0)
-        return [];
-    const out = [];
-    if (promoted.length > 0) {
-        const labelW = maxLen(promoted.map((s) => s.path));
-        for (const s of promoted) {
-            // important → padded name + shortform desc; common → bare name.
-            out.push(s.desc !== undefined && s.desc !== ''
-                ? `  ${pad(s.path, labelW)}  ${s.desc}`
-                : `  ${s.path}`);
-        }
-    }
-    if (other > 0) {
-        const word = promoted.length > 0 ? 'other subcommand' : 'subcommand';
-        out.push(`  [+${other} ${word}${other === 1 ? '' : 's'} — \`crtr ${c.name} -h\`]`);
-    }
-    return out;
-}
-export function renderRoot(h) {
-    const lines = [];
-    lines.push(`${h.tagline}`);
-    lines.push('');
-    // Each subtree is one <command name="…"> block. The uniform wrapper states
-    // "this is a command you invoke as `crtr <name>`" — so the model reads them
-    // by one rule, and a nested state element (which is never a <command>) can't
-    // be mistaken for a sibling command. Inside: the concept (what it is), the
-    // selection rubric (when to pick it), then any self-named state element
-    // grouped with the command it belongs to. Once injected into a system prompt,
-    // each block reads as one self-contained concern domain. Header (tagline) and
-    // footer (Globals + I/O contract + capability-discovery rule) are the only
-    // non-command areas. Two levels of nesting: <command> → <state>.
-    for (const c of h.commands) {
-        lines.push(`<command name="${c.name}">`);
-        lines.push(c.concept);
-        lines.push(`use when ${c.useWhen}`);
-        // The command's subcommand surface: promoted (common/important) children
-        // inline, plus a "[+N other subcommands]" pointer to its own -h. Sits
-        // between the selection rubric and any live state block.
-        for (const l of rootSubcommandLines(c))
-            lines.push(l);
-        // dynamicState returns a complete self-named element (e.g.
-        // <kinds count="7">…</kinds>) — emit it as-is, nested in the command.
-        const state = evalDynamic(c.dynamicState);
-        if (state !== null)
-            lines.push(state);
-        lines.push('</command>');
-        lines.push('');
-    }
-    // Globals block (footer) — rendered only when globals exist, so an empty
-    // list never leaves a bare "Globals" header. -h itself is not a global: the
-    // capability-discovery rule below teaches -h usage with its reasoning, so no
-    // per-command CTA or standalone "-h: print help" stub is needed.
-    if (h.globals.length > 0) {
-        lines.push('Globals');
-        const gNameW = maxLen(h.globals.map((g) => g.name));
-        for (const g of h.globals) {
-            lines.push(`  ${pad(g.name, gNameW)}  ${g.desc}`);
-        }
-        lines.push('');
-    }
-    lines.push(IO_CONTRACT);
-    lines.push('');
-    lines.push(CAPABILITY_DISCOVERY);
-    return lines.join('\n');
-}
-// renderBranch
-/** Escape a value for a rendered XML attribute. Output is light XML around
- *  markdown read as prose by a model, not parsed — so we only guard the
- *  double-quote that would visually break the attribute, swapping it for a
- *  single quote rather than emitting noisy entities. */
-function attr(s) {
-    return s.replace(/"/g, "'");
-}
-export function renderBranch(h) {
-    const lines = [];
-    // The branch renders as one <command> card: its own description in the
-    // opening attribute, then orientation prose / live state, then one
-    // self-closing <subcommand> per child. Each child's description + whenToUse
-    // are assembled by defineBranch from the child's own self-description, so the
-    // parent never restates what a child is — the child owns its representation.
-    lines.push(`<command name="${h.name}" description="${attr(h.summary)}">`);
-    const branchState = evalDynamic(h.dynamicState);
-    if (branchState !== null)
-        lines.push(branchState);
-    if (h.model !== undefined)
-        lines.push(h.model);
-    for (const c of h.listing ?? []) {
-        if (c.tier === 'hidden')
-            continue;
-        const plugin = c.plugin === undefined ? '' : ` plugin="${attr(c.plugin)}"`;
-        const subs = c.subCount !== undefined && c.subCount > 0 ? ` subcommands="${c.subCount}"` : '';
-        // whenToUse plainly states when to reach for this child, rendered verbatim —
-        // expansive with examples for judgment-heavy commands, concise for
-        // single-purpose ones. It does not restate "read my -h"; the
-        // capability-discovery rule in the root footer already teaches that.
-        if (lines.length > 1)
-            lines.push('');
-        lines.push(`<subcommand name="${c.name}" description="${attr(c.description)}" whenToUse="${attr(c.whenToUse)}"${plugin}${subs}/>`);
-    }
-    if (h.extensionIssue !== undefined) {
-        lines.push(`<extension-issue fragment="${attr(h.extensionIssue.fragment)}">This repository's contributed commands were rejected: ${h.extensionIssue.message}. Run \`crtr sys doctor\` for the full report.</extension-issue>`);
-    }
-    lines.push('</command>');
-    return lines.join('\n');
-}
-// renderLeafArgv
-/** Build the display label for a param entry (left column). */
-function paramLabel(p) {
-    if (p.kind === 'positional')
-        return `${p.name.toUpperCase()}${p.repeatable === true ? '...' : ''}`;
-    if (p.kind === 'stdin')
-        return 'stdin';
-    if (p.kind === 'context-file')
-        return '--context-file PATH';
-    // flag
-    const f = p;
-    if (f.type === 'bool')
-        return `--${f.name}`;
-    return `--${f.name} ${f.name.toUpperCase().replace(/-/g, '_')}`;
-}
-/** Build the description line for a param entry (right column). */
-/** The sentence a `path` param with a declared `encoding` contributes: it is the
- *  whole reason the agent can pass a local path instead of pre-encoding bytes,
- *  so the leaf's own `-h` must state it. */
-function fileEncodingNote(encoding) {
-    if (encoding === undefined)
-        return '';
-    return encoding === 'base64'
-        ? ' Local file path: the file is read and its raw bytes are base64-encoded into the request; the path itself is never sent.'
-        : ' Local file path: the file is read as UTF-8 text and its content is sent as the value; the path itself is never sent.';
-}
-/** The sentence a param with an ambient env default contributes — the agent must
- *  know the value can arrive without being typed, and from where. */
-function envDefaultNote(envVar) {
-    return envVar === undefined
-        ? ''
-        : ` Defaults to $${envVar} when that is set and non-empty in the environment, and counts as supplied.`;
-}
-function focusedFlagHelpNote(flag, leafName) {
-    if (flag.focusedHelp === undefined)
-        return '';
-    return ` Before using this flag, run \`crtr ${leafName} --${flag.name} -h\` and read its focused guidance.`;
-}
-function paramDesc(p, leafName) {
-    const req = p.required ? 'required' : 'optional';
-    if (p.kind === 'positional') {
-        const repeatable = p.repeatable === true
-            ? ' Repeatable — pass multiple values to accumulate in argv order.'
-            : '';
-        return `positional, ${req}.${fileEncodingNote(p.encoding)}${envDefaultNote(p.defaultFromEnv)} ${p.constraint}${repeatable}`;
-    }
-    if (p.kind === 'stdin')
-        return `${req}. ${p.constraint}`;
-    if (p.kind === 'context-file') {
-        const shape = p.shape !== undefined
-            ? ` Shape: ${p.shape}`
-            : '';
-        return `${req}. Path to a JSON file.${shape} ${p.constraint}`.trim();
-    }
-    // flag
-    const f = p;
-    const focusedNote = focusedFlagHelpNote(f, leafName);
-    if (f.type === 'bool')
-        return `${req} boolean. Presence means true. ${f.constraint}${focusedNote}`.trim();
-    const dflt = f.default !== undefined ? ` Default: ${String(f.default)}.` : '';
-    const choices = f.type === 'enum' && f.choices !== undefined
-        ? ` One of: ${f.choices.join(', ')}.`
-        : '';
-    const repeatable = f.repeatable === true
-        ? ' Repeatable — pass multiple times to accumulate.'
-        : '';
-    return `${f.type}, ${req}.${choices}${dflt}${fileEncodingNote(f.encoding)}${envDefaultNote(f.defaultFromEnv)} ${f.constraint}${repeatable}${focusedNote}`.trim();
-}
-/** Render one leaf's ordinary contract, or the focused continuation for one
- *  uncommon flag selected through `--flag -h`. The caller reaches focused help
- *  from the ordinary row, so that view contains only leaf identity and the new
- *  parameter detail instead of repeating information already in context. */
-export function renderLeafArgv(h, focusedFlag) {
-    const lines = [`${h.name}: ${h.summary}.`];
-    // Hidden flags are parsed but never advertised in -h (see FlagParam.hidden).
-    const params = (h.params ?? []).filter((p) => !(p.kind === 'flag' && p.hidden === true));
-    const focused = focusedFlag === undefined
-        ? undefined
-        : params.find((p) => p.kind === 'flag' && p.name === focusedFlag && p.focusedHelp !== undefined);
-    if (focused?.focusedHelp !== undefined) {
-        const detail = focused.focusedHelp;
-        lines.push('');
-        lines.push(`<parameter name="${focused.name}">`);
-        lines.push('When to use');
-        lines.push(`  ${detail.whenToUse}`);
-        lines.push('');
-        lines.push('Value');
-        lines.push(`  ${detail.value}`);
-        if ((detail.effects ?? []).length > 0) {
-            lines.push('');
-            lines.push('Effects');
-            for (const effect of detail.effects ?? [])
-                lines.push(`  ${effect}`);
-        }
-        const focusedState = evalDynamic(detail.dynamicState);
-        if (focusedState !== null) {
-            lines.push('');
-            lines.push(focusedState);
-        }
-        lines.push('</parameter>');
-        return lines.join('\n');
-    }
-    if (h.guide !== undefined) {
-        lines.push('');
-        lines.push(h.guide);
-    }
-    lines.push('');
-    if (params.length > 0) {
-        lines.push('Input');
-        const labels = params.map(paramLabel);
-        const colW = maxLen(labels);
-        for (let i = 0; i < params.length; i++) {
-            lines.push(`  ${pad(labels[i], colW)}  ${paramDesc(params[i], h.name)}`);
-        }
-    }
-    else {
-        lines.push(h.inputNote !== undefined ? h.inputNote : 'No input parameters.');
-    }
-    lines.push('');
-    // The result is rendered as instruction-shaped XML+markdown; these fields are
-    // the information it carries, in order, not a literal JSON shape.
-    lines.push('Output (fields carried in the rendered result)');
-    const outNameW = maxLen(h.output.map((f) => f.name));
-    for (const f of h.output) {
-        lines.push(`  ${pad(f.name, outNameW)}  ${f.type}. ${f.constraint}`);
-    }
-    lines.push('');
-    lines.push('Effects');
-    for (const e of h.effects) {
-        lines.push(`  ${e}`);
-    }
-    // Optional bounded runtime-state block (e.g. the live <kinds> list), appended
-    // after the schema. Soft-fails to omission on null/throw, mirroring renderBranch.
-    const state = evalDynamic(h.dynamicState);
-    if (state !== null) {
-        lines.push('');
-        lines.push(state);
-    }
-    return lines.join('\n');
-}
+var g=Object.defineProperty;var i=(e,n)=>g(e,"name",{value:n,configurable:!0});function k(e,n,t){const s=Object.entries(n).map(([a,u])=>` ${a}="${u}"`).join("");return`<${e}${s}>
+${t}
+</${e}>`}i(k,"stateBlock");function l(e){if(e===void 0)return null;try{const n=e();return n!==null&&n!==""?n:null}catch{return null}}i(l,"evalDynamic");function p(e){let n=0;for(const t of e)t.length>n&&(n=t.length);return n}i(p,"maxLen");function h(e,n){return e+" ".repeat(Math.max(0,n-e.length))}i(h,"pad");const b=`I/O contract: flags and positional args on input; stdout is agent-ready markdown/XML you
+act on directly \u2014 read it as a continuation of your prompt, don't parse it as data.
+Exit 0 on success, non-zero on failure. Schemas appear at leaf -h; a leaf may route an uncommon flag to focused --flag -h guidance.`,y="Before running a crtr command that changes state \u2014 creates, mutates, or deletes anything \u2014 whose exact contract (args, flags, effects) you haven't verified this session, run `-h` on it and read the schema first \u2014 a reliable read beats a guess that wastes a turn or triggers an unintended effect. When a leaf routes a flag to focused help, read that focused help before using the flag; the compact row is discovery, not its invocation contract. Same when the user names a capability you don't fully recognize: `-h` it before acting.";function x(e){const n=e.subcommands??[],t=e.otherSubcommandCount??0;if(n.length===0&&t===0)return[];const s=[];if(n.length>0){const a=p(n.map(u=>u.path));for(const u of n)s.push(u.desc!==void 0&&u.desc!==""?`  ${h(u.path,a)}  ${u.desc}`:`  ${u.path}`)}if(t>0){const a=n.length>0?"other subcommand":"subcommand";s.push(`  [+${t} ${a}${t===1?"":"s"} \u2014 \`crtr ${e.name} -h\`]`)}return s}i(x,"rootSubcommandLines");function C(e){const n=[];n.push(`${e.tagline}`),n.push("");for(const t of e.commands){n.push(`<command name="${t.name}">`),n.push(t.concept),n.push(`use when ${t.useWhen}`);for(const a of x(t))n.push(a);const s=l(t.dynamicState);s!==null&&n.push(s),n.push("</command>"),n.push("")}if(e.globals.length>0){n.push("Globals");const t=p(e.globals.map(s=>s.name));for(const s of e.globals)n.push(`  ${h(s.name,t)}  ${s.desc}`);n.push("")}return n.push(b),n.push(""),n.push(y),n.join(`
+`)}i(C,"renderRoot");function f(e){return e.replace(/"/g,"'")}i(f,"attr");function I(e){const n=[];n.push(`<command name="${e.name}" description="${f(e.summary)}">`);const t=l(e.dynamicState);t!==null&&n.push(t),e.model!==void 0&&n.push(e.model);for(const s of e.listing??[]){if(s.tier==="hidden")continue;const a=s.plugin===void 0?"":` plugin="${f(s.plugin)}"`,u=s.subCount!==void 0&&s.subCount>0?` subcommands="${s.subCount}"`:"";n.length>1&&n.push(""),n.push(`<subcommand name="${s.name}" description="${f(s.description)}" whenToUse="${f(s.whenToUse)}"${a}${u}/>`)}return e.extensionIssue!==void 0&&n.push(`<extension-issue fragment="${f(e.extensionIssue.fragment)}">This repository's contributed commands were rejected: ${e.extensionIssue.message}. Run \`crtr sys doctor\` for the full report.</extension-issue>`),n.push("</command>"),n.join(`
+`)}i(I,"renderBranch");function v(e){if(e.kind==="positional")return`${e.name.toUpperCase()}${e.repeatable===!0?"...":""}`;if(e.kind==="stdin")return"stdin";if(e.kind==="context-file")return"--context-file PATH";const n=e;return n.type==="bool"?`--${n.name}`:`--${n.name} ${n.name.toUpperCase().replace(/-/g,"_")}`}i(v,"paramLabel");function m(e){return e===void 0?"":e==="base64"?" Local file path: the file is read and its raw bytes are base64-encoded into the request; the path itself is never sent.":" Local file path: the file is read as UTF-8 text and its content is sent as the value; the path itself is never sent."}i(m,"fileEncodingNote");function $(e){return e===void 0?"":` Defaults to $${e} when that is set and non-empty in the environment, and counts as supplied.`}i($,"envDefaultNote");function S(e,n){return e.focusedHelp===void 0?"":` Before using this flag, run \`crtr ${n} --${e.name} -h\` and read its focused guidance.`}i(S,"focusedFlagHelpNote");function w(e,n){const t=e.required?"required":"optional";if(e.kind==="positional"){const r=e.repeatable===!0?" Repeatable \u2014 pass multiple values to accumulate in argv order.":"";return`positional, ${t}.${m(e.encoding)}${$(e.defaultFromEnv)} ${e.constraint}${r}`}if(e.kind==="stdin")return`${t}. ${e.constraint}`;if(e.kind==="context-file"){const r=e.shape!==void 0?` Shape: ${e.shape}`:"";return`${t}. Path to a JSON file.${r} ${e.constraint}`.trim()}const s=e,a=S(s,n);if(s.type==="bool")return`${t} boolean. Presence means true. ${s.constraint}${a}`.trim();const u=s.default!==void 0?` Default: ${String(s.default)}.`:"",d=s.type==="enum"&&s.choices!==void 0?` One of: ${s.choices.join(", ")}.`:"",o=s.repeatable===!0?" Repeatable \u2014 pass multiple times to accumulate.":"";return`${s.type}, ${t}.${d}${u}${m(s.encoding)}${$(s.defaultFromEnv)} ${s.constraint}${o}${a}`.trim()}i(w,"paramDesc");function T(e,n){const t=[`${e.name}: ${e.summary}.`],s=(e.params??[]).filter(o=>!(o.kind==="flag"&&o.hidden===!0)),a=n===void 0?void 0:s.find(o=>o.kind==="flag"&&o.name===n&&o.focusedHelp!==void 0);if(a?.focusedHelp!==void 0){const o=a.focusedHelp;if(t.push(""),t.push(`<parameter name="${a.name}">`),t.push("When to use"),t.push(`  ${o.whenToUse}`),t.push(""),t.push("Value"),t.push(`  ${o.value}`),(o.effects??[]).length>0){t.push(""),t.push("Effects");for(const c of o.effects??[])t.push(`  ${c}`)}const r=l(o.dynamicState);return r!==null&&(t.push(""),t.push(r)),t.push("</parameter>"),t.join(`
+`)}if(e.guide!==void 0&&(t.push(""),t.push(e.guide)),t.push(""),s.length>0){t.push("Input");const o=s.map(v),r=p(o);for(let c=0;c<s.length;c++)t.push(`  ${h(o[c],r)}  ${w(s[c],e.name)}`)}else t.push(e.inputNote!==void 0?e.inputNote:"No input parameters.");t.push(""),t.push("Output (fields carried in the rendered result)");const u=p(e.output.map(o=>o.name));for(const o of e.output)t.push(`  ${h(o.name,u)}  ${o.type}. ${o.constraint}`);t.push(""),t.push("Effects");for(const o of e.effects)t.push(`  ${o}`);const d=l(e.dynamicState);return d!==null&&(t.push(""),t.push(d)),t.join(`
+`)}i(T,"renderLeafArgv");export{I as renderBranch,T as renderLeafArgv,C as renderRoot,k as stateBlock};

package/dist/core/host-exports/builtins.js

@@ -1,68 +1,9 @@
-/**
- * Built-in export registry for crtr-generated host artifacts.
- *
- * Slash-command templates are one-way exports: code is the single source of
- * truth, so crtr renders them into host prompt/command dirs with marker-guarded
- * writes (see export.ts). Legacy generated Agent Skills are listed only as
- * cleanup targets; crouter's first-class guidance surface is memory docs.
- */
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { collectSlashSpecs } from '../command.js';
-// ── Slash commands ───────────────────────────────────────────────────────────
-const SLASH_CMD_MARKER = '<!-- crtr-mode-cmd v1 -->';
-export const SLASH_CMD_MARKER_PREFIX = '<!-- crtr-mode-cmd v';
-/** Render a SlashSpec to a full template file (frontmatter + marker + body). */
-function renderSlashTemplate(spec) {
-    const hint = spec.argumentHint !== undefined
-        ? `argument-hint: ${JSON.stringify(spec.argumentHint)}\n`
-        : '';
-    return `---\ndescription: ${spec.description}\n${hint}---\n\n${SLASH_CMD_MARKER}\n\n${spec.body}\n`;
-}
-// ── Host roots ───────────────────────────────────────────────────────────────
-function claudeSkillsRoot() {
-    return join(homedir(), '.claude', 'skills');
-}
-function piSkillsRoot() {
-    return join(homedir(), '.pi', 'agent', 'skills');
-}
-function claudeCommandsRoot() {
-    return join(homedir(), '.claude', 'commands');
-}
-function piPromptsRoot() {
-    return join(homedir(), '.pi', 'agent', 'prompts');
-}
-// ── Registry ─────────────────────────────────────────────────────────────────
-const LEGACY_BOOT_SKILL_MARKER_PREFIX = '<!-- crtr-boot-skill v';
-/** Legacy crtr-generated exports that should not survive after the memory cutover. */
-export function legacyExportArtifacts() {
-    return [
-        {
-            id: '@legacy/crtr-skills',
-            name: 'crtr-skills',
-            markerPrefix: LEGACY_BOOT_SKILL_MARKER_PREFIX,
-            targets: [
-                { host: 'claude', dir: claudeSkillsRoot, layout: 'bundle' },
-                { host: 'pi', dir: piSkillsRoot, layout: 'bundle' },
-            ],
-        },
-    ];
-}
-/** The crtr-generated export artifacts for this command tree: one pair per
- *  opted-in slash command (both hosts, file layout). */
-export function builtinExportPairs(root) {
-    const pairs = [];
-    for (const spec of collectSlashSpecs(root)) {
-        pairs.push({
-            id: `@cmd/${spec.name}`,
-            name: spec.name,
-            markerPrefix: SLASH_CMD_MARKER_PREFIX,
-            render: () => renderSlashTemplate(spec),
-            targets: [
-                { host: 'claude', dir: claudeCommandsRoot, layout: 'file' },
-                { host: 'pi', dir: piPromptsRoot, layout: 'file' },
-            ],
-        });
-    }
-    return pairs;
-}
+var l=Object.defineProperty;var t=(r,n)=>l(r,"name",{value:n,configurable:!0});import{homedir as o}from"node:os";import{join as i}from"node:path";import{collectSlashSpecs as s}from"../command.js";const c="<!-- crtr-mode-cmd v1 -->",a="<!-- crtr-mode-cmd v";function u(r){const n=r.argumentHint!==void 0?`argument-hint: ${JSON.stringify(r.argumentHint)}
+`:"";return`---
+description: ${r.description}
+${n}---
+
+${c}
+
+${r.body}
+`}t(u,"renderSlashTemplate");function d(){return i(o(),".claude","skills")}t(d,"claudeSkillsRoot");function m(){return i(o(),".pi","agent","skills")}t(m,"piSkillsRoot");function p(){return i(o(),".claude","commands")}t(p,"claudeCommandsRoot");function f(){return i(o(),".pi","agent","prompts")}t(f,"piPromptsRoot");const R="<!-- crtr-boot-skill v";function _(){return[{id:"@legacy/crtr-skills",name:"crtr-skills",markerPrefix:R,targets:[{host:"claude",dir:d,layout:"bundle"},{host:"pi",dir:m,layout:"bundle"}]}]}t(_,"legacyExportArtifacts");function y(r){const n=[];for(const e of s(r))n.push({id:`@cmd/${e.name}`,name:e.name,markerPrefix:a,render:t(()=>u(e),"render"),targets:[{host:"claude",dir:p,layout:"file"},{host:"pi",dir:f,layout:"file"}]});return n}t(y,"builtinExportPairs");export{a as SLASH_CMD_MARKER_PREFIX,y as builtinExportPairs,_ as legacyExportArtifacts};

package/dist/core/host-exports/export.js

@@ -1,124 +1,3 @@
-/**
- * One-way export of crtr-generated host artifacts — the sole writer of
- * generated slash-command templates to `~/.claude/commands` and
- * `~/.pi/agent/prompts`.
- *
- * crouter exports no Agent Skills / SKILL.md bundles. The export pass prunes
- * marker-bearing `crtr-skills` bundles so hosts stop surfacing pi/Claude native
- * skills. Markerless files are user-owned and never removed.
- *
- * Triggered per-run by cli.ts (argv-gated) so
- * first-run provisioning is preserved. Best-effort: a provisioning fault must
- * never break an unrelated `crtr` command (the deliberate, pre-existing
- * behavior of the deleted writers).
- */
-import { writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { ensureDir, pathExists, readText, removePath } from '../fs-utils.js';
-import { envNoExports } from '../../shared/env.js';
-import { builtinExportPairs, legacyExportArtifacts } from './builtins.js';
-const SKIP_SUBCOMMANDS = new Set([
-    'help',
-    '--help',
-    '-h',
-    '--version',
-    '-v',
-]);
-/** Skip provisioning side effects entirely for help/version invocations. */
-function shouldSkipAllForArgv(argv) {
-    const sub = argv[2];
-    return sub !== undefined && SKIP_SUBCOMMANDS.has(sub);
-}
-/** Skip slash-command writes for bare front-door boot; pruning still runs. */
-function shouldSkipWritesForArgv(argv) {
-    return argv[2] === undefined;
-}
-/** Whether a host runtime is in use (its root dir exists). crtr writes into a
- *  host's dirs only when present and never creates `~/.claude` or `~/.pi`. */
-function hostRootExists(host) {
-    if (host === 'claude')
-        return pathExists(join(homedir(), '.claude'));
-    return pathExists(join(homedir(), '.pi', 'agent'));
-}
-/** Resolve the on-disk path for one target from its layout. */
-function targetPath(target, name) {
-    const dir = target.dir();
-    return target.layout === 'bundle'
-        ? join(dir, name, 'SKILL.md')
-        : join(dir, `${name}.md`);
-}
-/** Write `content` to `path` unless a user-customized file is already there.
- *  Rolls forward our own (marker-bearing) versions; skips if identical. Creates
- *  only the leaf dir, never the host root. The single generalization of
- *  bootstrap.ts's two clobber-guards. */
-export function writeIfOurs(path, content, markerPrefix) {
-    if (pathExists(path)) {
-        const existing = readText(path);
-        if (!existing.includes(markerPrefix))
-            return; // user-owned → never clobber
-        if (existing === content)
-            return; // already current
-    }
-    ensureDir(dirname(path));
-    writeFileSync(path, content, 'utf8');
-}
-/** Remove a legacy artifact only when its marker proves crtr generated it. */
-function removeIfOurs(path, target, markerPrefix) {
-    if (!pathExists(path))
-        return;
-    const existing = readText(path);
-    if (!existing.includes(markerPrefix))
-        return;
-    removePath(target.layout === 'bundle' ? dirname(path) : path);
-}
-/** Render and write every built-in export artifact to every present host, while
- *  pruning legacy generated artifacts that should no longer be surfaced.
- *  Best-effort: reports errors without breaking an unrelated `crtr` command.
- *  Kill switch: `CRTR_NO_EXPORTS=1`. */
-export function pruneLegacyExports(argv = process.argv) {
-    try {
-        if (envNoExports())
-            return;
-        if (shouldSkipAllForArgv(argv))
-            return;
-        for (const artifact of legacyExportArtifacts()) {
-            for (const target of artifact.targets) {
-                if (!hostRootExists(target.host))
-                    continue;
-                removeIfOurs(targetPath(target, artifact.name), target, artifact.markerPrefix);
-            }
-        }
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        process.stderr.write(`crtr: exports prune error: ${msg}\n`);
-    }
-}
-/** Write every built-in export artifact to every present host. Split from the
- *  prune above because the prune must run BEFORE the front door boots (stale
- *  artifacts must not reach the prompt) while it needs no command tree, and
- *  bare `crtr` skips the writes outright — so the front door never has to pay
- *  for building the full command tree just to reach a no-op. */
-export function provisionExports(root, argv = process.argv) {
-    try {
-        if (envNoExports())
-            return;
-        if (shouldSkipAllForArgv(argv))
-            return;
-        if (shouldSkipWritesForArgv(argv))
-            return;
-        for (const pair of builtinExportPairs(root)) {
-            const content = pair.render();
-            for (const target of pair.targets) {
-                if (!hostRootExists(target.host))
-                    continue;
-                writeIfOurs(targetPath(target, pair.name), content, pair.markerPrefix);
-            }
-        }
-    }
-    catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        process.stderr.write(`crtr: exports error: ${msg}\n`);
-    }
-}
+var x=Object.defineProperty;var o=(r,t)=>x(r,"name",{value:t,configurable:!0});import{writeFileSync as l}from"node:fs";import{homedir as u}from"node:os";import{dirname as c,join as i}from"node:path";import{ensureDir as S,pathExists as s,readText as a,removePath as h}from"../fs-utils.js";import{envNoExports as m}from"../../shared/env.js";import{builtinExportPairs as v,legacyExportArtifacts as E}from"./builtins.js";const y=new Set(["help","--help","-h","--version","-v"]);function p(r){const t=r[2];return t!==void 0&&y.has(t)}o(p,"shouldSkipAllForArgv");function P(r){return r[2]===void 0}o(P,"shouldSkipWritesForArgv");function d(r){return r==="claude"?s(i(u(),".claude")):s(i(u(),".pi","agent"))}o(d,"hostRootExists");function g(r,t){const e=r.dir();return r.layout==="bundle"?i(e,t,"SKILL.md"):i(e,`${t}.md`)}o(g,"targetPath");function w(r,t,e){if(s(r)){const n=a(r);if(!n.includes(e)||n===t)return}S(c(r)),l(r,t,"utf8")}o(w,"writeIfOurs");function A(r,t,e){!s(r)||!a(r).includes(e)||h(t.layout==="bundle"?c(r):r)}o(A,"removeIfOurs");function D(r=process.argv){try{if(m()||p(r))return;for(const t of E())for(const e of t.targets)d(e.host)&&A(g(e,t.name),e,t.markerPrefix)}catch(t){const e=t instanceof Error?t.message:String(t);process.stderr.write(`crtr: exports prune error: ${e}
+`)}}o(D,"pruneLegacyExports");function K(r,t=process.argv){try{if(m()||p(t)||P(t))return;for(const e of v(r)){const n=e.render();for(const f of e.targets)d(f.host)&&w(g(f,e.name),n,e.markerPrefix)}}catch(e){const n=e instanceof Error?e.message:String(e);process.stderr.write(`crtr: exports error: ${n}
+`)}}o(K,"provisionExports");export{K as provisionExports,D as pruneLegacyExports,w as writeIfOurs};

package/dist/core/human/action-binding.js

@@ -1,40 +1 @@
-// The optional completion-action binding of a durable human request. Written
-// once at creation and never again: `replace` revises the page, so the approved
-// effect must not be reachable from any later write.
-import { readFileSync } from 'node:fs';
-import { z } from 'zod';
-import { actionBindingPath, publishJsonExclusive } from './convention.js';
-export const HUMAN_ACTION_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
-const bindingSchema = z.object({
-    schema: z.literal('crtr.human-action-binding/v1'),
-    name: z.string().regex(HUMAN_ACTION_NAME_PATTERN),
-    payload: z.unknown(),
-    creatorCwd: z.string().min(1),
-    configOrigin: z.string().min(1),
-    argv: z.array(z.string().min(1)).min(1),
-    cwd: z.string().min(1),
-}).strict();
-/** Publish the binding before the page exists, so a visible request is never
- * unbound. A second write is a caller bug, not a race to tolerate. */
-export function publishTicketActionBinding(dir, binding) {
-    if (!publishJsonExclusive(actionBindingPath(dir), binding)) {
-        throw new Error(`action binding already exists: ${actionBindingPath(dir)}`);
-    }
-}
-/** The frozen binding, or null for a request with no completion action. */
-export function readTicketActionBinding(dir) {
-    let raw;
-    try {
-        raw = JSON.parse(readFileSync(actionBindingPath(dir), 'utf8'));
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return null;
-        throw error;
-    }
-    const parsed = bindingSchema.parse(raw);
-    // `payload` is optional-by-absence in JSON but required in the type; z.unknown()
-    // accepts a missing key, so restore it explicitly as the JSON null the
-    // completion document must carry.
-    return { ...parsed, payload: raw.payload ?? null };
-}
+var e=Object.defineProperty;var t=(r,i)=>e(r,"name",{value:i,configurable:!0});import{readFileSync as c}from"node:fs";import{z as n}from"zod";import{actionBindingPath as o,publishJsonExclusive as s}from"./convention.js";const d=/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/,g=n.object({schema:n.literal("crtr.human-action-binding/v1"),name:n.string().regex(d),payload:n.unknown(),creatorCwd:n.string().min(1),configOrigin:n.string().min(1),argv:n.array(n.string().min(1)).min(1),cwd:n.string().min(1)}).strict();function h(r,i){if(!s(o(r),i))throw new Error(`action binding already exists: ${o(r)}`)}t(h,"publishTicketActionBinding");function A(r){let i;try{i=JSON.parse(c(o(r),"utf8"))}catch(a){if(a.code==="ENOENT")return null;throw a}return{...g.parse(i),payload:i.payload??null}}t(A,"readTicketActionBinding");export{d as HUMAN_ACTION_NAME_PATTERN,h as publishTicketActionBinding,A as readTicketActionBinding};