@canonical/pragma-cli 0.34.0 → 0.35.0

package/dist/src/kernel/spec/asVerb.js

@@ -0,0 +1,21 @@
+/**
+ * Widen a strongly-typed verb to the base {@link VerbSpec} at the registry
+ * boundary.
+ *
+ * A `VerbSpec<P, R>` with a concrete `R` cannot be placed directly in a
+ * `CapabilityModule.verbs` array (`VerbSpec<…, unknown>[]`) because `Formatters`
+ * is invariant in its data type. Authoring keeps the strong `R` so the
+ * formatters in each `*.render.ts` are type-checked against the real payload;
+ * this erases only that phantom `R` where the module is composed. The
+ * projectors re-narrow through the verb's own formatters at run time.
+ */
+/**
+ * Erase a verb's concrete data type for registry composition.
+ *
+ * @param verb - A strongly-typed verb spec.
+ * @returns The same verb widened to the base `VerbSpec`.
+ */
+export function asVerb(verb) {
+    return verb;
+}
+//# sourceMappingURL=asVerb.js.map

package/dist/src/kernel/spec/asVerb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asVerb.js","sourceRoot":"","sources":["../../../../src/kernel/spec/asVerb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAO,IAAoB;IAC/C,OAAO,IAA2B,CAAC;AACrC,CAAC"}

package/dist/src/kernel/spec/emitReference.js

@@ -0,0 +1,578 @@
+/**
+ * Reference emitter: project the live capability grammar into the committed
+ * Markdown reference under `docs/reference/`.
+ *
+ * A sibling of `emitSurface` — same input (the `CapabilityModule[]` catalog),
+ * same discipline: pure, zod-free, and reads ONLY the grammar (never a run
+ * body). Where `emitSurface` freezes the machine covenant, this renders the
+ * human/agent-facing pages the build hook writes back to disk and the
+ * drift-guard (`capabilities/reference.test.ts`) pins byte-for-byte.
+ *
+ * DETERMINISM is the contract: stable sort, params in declared order, no
+ * version, no dates, no `Date.now()` — the same catalog always yields the same
+ * bytes, so a rebuild is a no-op and the drift-guard stays green. `doc` strings
+ * are kept verbatim (the project-layer `stripToolCallExample` is deliberately
+ * NOT imported — this is a kernel-layer emitter).
+ */
+import { BIN_NAME, PROJECT_CONFIG_FILENAME } from "../../constants.js";
+import { ERROR_CODES } from "../error/index.js";
+import { FIXED_SURFACE, kebabCase, toolName, verbLabel, } from "./emitSurface.js";
+/**
+ * The closed error-code → one-line meaning map. Typed as an exhaustive
+ * `Record` over the `ERROR_CODES` tuple, so a code added to the tuple without a
+ * description here is a COMPILE error — the single authoring point stays in
+ * lockstep with the error kernel. Colocated (single-use) rather than in
+ * `constants.ts`: it is only read by `renderErrorsPage`.
+ */
+const ERROR_CODE_DESCRIPTIONS = {
+    ENTITY_NOT_FOUND: "A named entity (block, standard, token, …) was not found.",
+    EMPTY_RESULTS: "A query or listing resolved to nothing under the active scope.",
+    INVALID_INPUT: "An argument was malformed, out of range, or the wrong shape.",
+    AMBIGUOUS_INPUT: "A name resolved to several entities (reserved; not yet raised).",
+    UNKNOWN_VERB: "The command noun or verb is not recognized.",
+    STORE_UNAVAILABLE: "The local store cannot be reached or is not built.",
+    CONFIG_ERROR: "The layered configuration cannot be resolved.",
+    INTERNAL_ERROR: "An unexpected failure — report it as a bug.",
+    UNSUPPORTED: "A capability is unavailable in this build or environment.",
+};
+/** Escape a value for a Markdown table cell (pipes, then newlines to spaces). */
+function escapeCell(text) {
+    return text.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+/** Flatten every non-hidden verb, sorted by noun ascending then verb-label ascending. */
+function collectDocVerbs(modules) {
+    const verbs = [];
+    for (const module of modules) {
+        for (const verb of module.verbs) {
+            if (verb.hidden)
+                continue;
+            verbs.push(verb);
+        }
+    }
+    return verbs.sort(compareDocVerbs);
+}
+/** Order two verbs by noun, then by verb-label — a total, locale-free order. */
+function compareDocVerbs(a, b) {
+    const nounA = a.path[0];
+    const nounB = b.path[0];
+    if (nounA !== nounB)
+        return nounA < nounB ? -1 : 1;
+    const labelA = verbLabel(a.path);
+    const labelB = verbLabel(b.path);
+    /* v8 ignore next -- unreachable: no registered grammar produces a `[noun,
+       noun]` path (a verb equal to its own noun), so within one noun every
+       verb-label is unique and this equal tie-break never fires. */
+    if (labelA === labelB)
+        return 0;
+    return labelA < labelB ? -1 : 1;
+}
+/** The full CLI invocation head for a verb (`<bin> <noun>` or `<bin> <noun> <verb>`). */
+function formatInvocation(verb) {
+    const sub = verb.path[1];
+    return sub === undefined
+        ? `${BIN_NAME} ${verb.path[0]}`
+        : `${BIN_NAME} ${verb.path[0]} ${sub}`;
+}
+/** Format a positional param as its usage token (`<name>`/`[name]`, `...` when variadic). */
+function formatPositionalToken(param) {
+    const variadic = param.kind === "string[]" ? "..." : "";
+    return param.required
+        ? `<${param.name}${variadic}>`
+        : `[${param.name}${variadic}]`;
+}
+/** The value placeholder a flag takes (empty for a bare boolean switch). */
+function formatFlagValue(param) {
+    switch (param.kind) {
+        case "boolean":
+            return "";
+        case "enum":
+            return `<${param.values.join("|")}>`;
+        case "number":
+            return "<number>";
+        case "string":
+            return "<string>";
+        case "string[]":
+            return "<value...>";
+    }
+}
+/**
+ * The tool-schema type label a param projects to (mirrors `buildZodSchema`).
+ * Enum values are comma-joined (never pipe-joined) so the label is safe inside
+ * a Markdown table cell without escaping.
+ */
+function formatParamType(param) {
+    switch (param.kind) {
+        case "enum":
+            return `enum(${param.values.join(", ")})`;
+        case "string[]":
+            return "string[]";
+        default:
+            return param.kind;
+    }
+}
+/** Render a default value for prose (strings verbatim, everything else stringified). */
+function formatDefault(value) {
+    return typeof value === "string" ? value : String(value);
+}
+/** A param's description cell: its doc, plus enum values and any default. */
+function describeParam(param) {
+    let description = escapeCell(param.doc);
+    if (param.kind === "enum") {
+        description += ` (one of: ${param.values.join(", ")})`;
+    }
+    if ("default" in param && param.default !== undefined) {
+        description += ` (default: ${escapeCell(formatDefault(param.default))})`;
+    }
+    return description;
+}
+/** The single-line usage string: invocation + positionals + `[options]`. */
+function formatUsage(verb) {
+    const positionals = verb.params.filter((p) => p.positional);
+    const flags = verb.params.filter((p) => !p.positional);
+    const segments = [formatInvocation(verb)];
+    for (const positional of positionals) {
+        segments.push(formatPositionalToken(positional));
+    }
+    if (flags.length > 0)
+        segments.push("[options]");
+    return segments.join(" ");
+}
+/**
+ * The Args table for a verb's positionals, or `""` when it has none. A
+ * mounted verb's {@link ReferenceCliSyntax.positionalTokens} supplies the
+ * REGISTERED token per param — the one its usage line prints — so the
+ * Argument column and the synopsis agree on the same spelling; without one,
+ * the token derives from the param name.
+ */
+function formatArgsTable(params, positionalTokens) {
+    const positionals = params.filter((p) => p.positional);
+    if (positionals.length === 0)
+        return "";
+    const rows = ["| Argument | Required | Description |", "| --- | --- | --- |"];
+    for (const param of positionals) {
+        const required = param.required ? "yes" : "no";
+        const token = positionalTokens?.[param.name] ?? formatPositionalToken(param);
+        rows.push(`| \`${token}\` | ${required} | ${describeParam(param)} |`);
+    }
+    return `**Arguments**\n\n${rows.join("\n")}`;
+}
+/**
+ * The Flags table for a verb's non-positional params, or `""` when it has
+ * none. A mounted verb's {@link ReferenceCliSyntax.flagTokens} supplies the
+ * REGISTERED token per param (e.g. a default-true boolean's `--no-` form);
+ * without one, the token derives from the param name.
+ */
+function formatFlagsTable(params, flagTokens) {
+    const flags = params.filter((p) => !p.positional);
+    if (flags.length === 0)
+        return "";
+    const rows = ["| Flag | Value | Description |", "| --- | --- | --- |"];
+    for (const param of flags) {
+        // The `<a|b|c>` enum token carries pipes — escape them so the code-span cell
+        // does not split the table column.
+        const value = formatFlagValue(param);
+        const valueCell = value === "" ? "—" : `\`${escapeCell(value)}\``;
+        const token = flagTokens?.[param.name] ?? `--${kebabCase(param.name)}`;
+        rows.push(`| \`${token}\` | ${valueCell} | ${describeParam(param)} |`);
+    }
+    return `**Flags**\n\n${rows.join("\n")}`;
+}
+/** The Examples block for a verb, or `""` when none are declared. */
+function formatExamples(examples) {
+    if (!examples || examples.length === 0)
+        return "";
+    const lines = ["```bash"];
+    for (const example of examples) {
+        lines.push(example.note ? `${example.cmd}  # ${example.note}` : example.cmd);
+    }
+    lines.push("```");
+    return `**Examples**\n\n${lines.join("\n")}`;
+}
+/** The Store / Mutation / MCP attribute bullets for one verb. */
+function formatVerbAttributes(verb) {
+    const bullets = [
+        verb.capability.needsStore
+            ? `- Store: reads the local store (\`${BIN_NAME} sources update\` builds it).`
+            : "- Store: storeless.",
+    ];
+    if (verb.capability.mutates) {
+        bullets.push("- Mutation: plan-first — preview with `--dry-run`, apply with `--yes`, reverse with `--undo`.");
+    }
+    bullets.push(verb.capability.mcp.expose
+        ? `- MCP: exposed as the \`${toolName(verb.path)}\` tool.`
+        : "- MCP: not exposed (CLI-only).");
+    return bullets.join("\n");
+}
+/** Join page blocks with blank lines, dropping empties, and end in ONE newline. */
+function assemblePage(blocks) {
+    return `${blocks.filter((block) => block.length > 0).join("\n\n")}\n`;
+}
+/** Render one verb's `commands.md` section (heading through examples). */
+function renderCommandSection(verb, syntax) {
+    const blocks = [
+        `### ${formatInvocation(verb)}`,
+        verb.summary,
+        verb.doc ?? "",
+        `\`\`\`\n${syntax ? `${BIN_NAME} ${syntax.usage}` : formatUsage(verb)}\n\`\`\``,
+        formatArgsTable(verb.params, syntax?.positionalTokens),
+        formatFlagsTable(verb.params, syntax?.flagTokens),
+        formatVerbAttributes(verb),
+        formatExamples(verb.examples),
+    ];
+    return blocks.filter((block) => block.length > 0).join("\n\n");
+}
+/**
+ * Render the CLI command reference, grouped by noun. A noun whose module
+ * declares a `cliProjection.referenceIntro` gets that Markdown inserted
+ * directly under its heading, and a verb its module supplies a
+ * `cliProjection.referenceSyntax` for renders the MOUNTED usage/flag
+ * spelling (generic module fields — the kernel renders, the module authors).
+ */
+function renderCommandsPage(verbs, nounIntros, verbSyntax) {
+    const blocks = [
+        "# CLI command reference",
+        `Every \`${BIN_NAME}\` command, grouped by noun. Generated from the live capability grammar — do not edit by hand.`,
+        "Global flags apply to every command: `--format <plain|llm|json>` (auto-detected — the llm/condensed-Markdown form turns on when output is piped), `--verbose`, `--no-headers`, `--quiet`, and `--detail <summary|standard|detailed>`.",
+    ];
+    let currentNoun = "";
+    for (const verb of verbs) {
+        const noun = verb.path[0];
+        if (noun !== currentNoun) {
+            currentNoun = noun;
+            blocks.push(`## ${noun}`);
+            const intro = nounIntros.get(noun);
+            if (intro)
+                blocks.push(intro);
+        }
+        blocks.push(renderCommandSection(verb, verbSyntax.get(verb)));
+    }
+    return assemblePage(blocks);
+}
+/** Collect each noun's declared reference intro from its module's mount. */
+function collectNounIntros(modules) {
+    const intros = new Map();
+    for (const module of modules) {
+        const intro = module.cliProjection?.referenceIntro;
+        if (!intro)
+            continue;
+        for (const verb of module.verbs) {
+            intros.set(verb.path[0], intro);
+        }
+    }
+    return intros;
+}
+/** Collect each mounted verb's registered CLI syntax from its module. */
+function collectVerbSyntax(modules) {
+    const syntax = new Map();
+    for (const module of modules) {
+        const provider = module.cliProjection?.referenceSyntax;
+        if (!provider)
+            continue;
+        for (const verb of module.verbs) {
+            const entry = provider(verb.path);
+            if (entry)
+                syntax.set(verb, entry);
+        }
+    }
+    return syntax;
+}
+/** Collect a tool's input rows: the verb's params plus the injected MCP-only ones. */
+function collectToolParams(verb) {
+    const rows = [];
+    for (const param of verb.params) {
+        rows.push({
+            name: param.name,
+            type: formatParamType(param),
+            required: param.required === true,
+            description: describeParam(param),
+        });
+    }
+    if (verb.disclosure) {
+        rows.push({
+            name: "detail",
+            type: `enum(${verb.disclosure.levels.join(", ")})`,
+            required: false,
+            description: `Progressive-disclosure level (default ${verb.disclosure.default}).`,
+        });
+    }
+    if (verb.capability.mutates) {
+        rows.push({
+            name: "confirm",
+            type: "boolean",
+            required: false,
+            description: "Set true to execute; otherwise a plan is returned (default false).",
+        });
+        rows.push({
+            name: "cwd",
+            type: "string",
+            required: false,
+            description: "Absolute project directory to write into; defaults to the server's working directory.",
+        });
+    }
+    return rows;
+}
+/** The input-params table for a tool, or a storeless-note when it takes none. */
+function formatToolParams(verb) {
+    const rows = collectToolParams(verb);
+    if (rows.length === 0)
+        return "_No input parameters._";
+    const table = [
+        "| Parameter | Type | Required | Description |",
+        "| --- | --- | --- | --- |",
+    ];
+    for (const row of rows) {
+        const required = row.required ? "yes" : "no";
+        table.push(`| \`${row.name}\` | ${row.type} | ${required} | ${row.description} |`);
+    }
+    return table.join("\n");
+}
+/** The read-only / mutation + destructive annotation line for a tool. */
+function formatToolAnnotations(verb) {
+    if (!verb.capability.mutates)
+        return "Read-only.";
+    const destructive = verb.capability.destructive === true
+        ? " Marked destructive."
+        : verb.capability.destructive === false
+            ? " Non-destructive."
+            : "";
+    return `Mutation — plan-first (set \`confirm: true\` to apply).${destructive}`;
+}
+/** Render one tool's `tools.md` section. */
+function renderToolSection(verb) {
+    const blocks = [
+        `### ${toolName(verb.path)}`,
+        verb.doc ?? verb.summary,
+        formatToolAnnotations(verb),
+        "**Input**",
+        formatToolParams(verb),
+    ];
+    return blocks.join("\n\n");
+}
+/** The non-tool MCP surface (resources + native prompts) declared by the modules. */
+function collectMcpExtras(modules) {
+    const resources = [];
+    let prompts = false;
+    for (const module of modules) {
+        if (module.mcpResources?.surface) {
+            resources.push(...module.mcpResources.surface.templates);
+        }
+        if (module.mcpPrompts)
+            prompts = true;
+    }
+    // Default lexicographic sort — deterministic, and the same idiom `emitSurface`
+    // uses for its `resources`/`tools` lists.
+    return { resources: [...resources].sort(), prompts };
+}
+/** Render the non-tool MCP surface section for `tools.md`. */
+function renderNonToolSurface(modules) {
+    const { resources, prompts } = collectMcpExtras(modules);
+    const bullets = [];
+    if (resources.length > 0) {
+        bullets.push(`- **Resources**: ${resources.map((r) => `\`${r}\``).join(", ")} — entity reads addressed by URI (listing and autocomplete are storeless over the pack index). The template — its scheme and the \`_meta\` taxonomy keys its entries carry — is frozen protocol identity, served unchanged by every distribution: clients persist resource URIs, so the scheme never follows a fork's name.`);
+    }
+    if (prompts) {
+        bullets.push("- **Prompts**: the workflow prompt templates the active graph declares are offered natively over `prompts/list` and `prompts/get`, and as the `prompt_list` / `prompt_lookup` content tools. A graph declaring none leaves both views empty.");
+    }
+    bullets.push("- **Instructions**: the server always sends handshake instructions describing the conventions and the discovery sequence.");
+    return `## Non-tool surface\n\n${bullets.join("\n")}`;
+}
+/** Render the MCP tool reference plus the non-tool surface. */
+function renderToolsPage(verbs, modules) {
+    const tools = verbs.filter((verb) => verb.capability.mcp.expose);
+    const blocks = [
+        "# MCP tool reference",
+        `Every tool the ${BIN_NAME} MCP server exposes, plus its non-tool surface. Generated from the live capability grammar — do not edit by hand. The server's \`serverInfo\` is a projection, not a constant: it introduces itself on the wire under the distribution's declared name at the package version, so a client should read \`serverInfo\` rather than assume a name.`,
+        "Mutating tools are plan-first: called without `confirm: true` they return the plan they WOULD apply; called with `confirm: true` they execute. A mutating tool also accepts an optional absolute `cwd`.",
+    ];
+    for (const verb of tools) {
+        blocks.push(renderToolSection(verb));
+    }
+    blocks.push(renderNonToolSurface(modules));
+    return assemblePage(blocks);
+}
+/** Render the exit-code table, the response envelope, and the error catalog. */
+function renderErrorsPage() {
+    const exitRows = ["| Exit code | Meaning |", "| --- | --- |"];
+    // Integer-like keys ("0".."3") are iterated in ascending numeric order by the
+    // ECMAScript own-key ordering rule, so `Object.entries` is already sorted.
+    for (const [code, meaning] of Object.entries(FIXED_SURFACE.exitCodes)) {
+        exitRows.push(`| \`${code}\` | ${meaning} |`);
+    }
+    const catalogRows = ["| Code | Meaning |", "| --- | --- |"];
+    for (const code of ERROR_CODES) {
+        const meaning = ERROR_CODE_DESCRIPTIONS[code];
+        /* v8 ignore next 3 -- exhaustiveness: ERROR_CODE_DESCRIPTIONS is a Record
+           over the ERROR_CODES tuple, so every code is present by construction. */
+        if (meaning === undefined) {
+            throw new Error(`missing error-code description for ${code}`);
+        }
+        catalogRows.push(`| \`${code}\` | ${meaning} |`);
+    }
+    return assemblePage([
+        "# Errors & exit codes",
+        "Every command returns a `{ ok, ... }` envelope and maps its failure to one of four process exit codes. Generated from the live error kernel — do not edit by hand.",
+        "## Exit codes",
+        exitRows.join("\n"),
+        "## Response envelope",
+        `\`\`\`json\n${JSON.stringify(FIXED_SURFACE.envelope, null, 2)}\n\`\`\``,
+        "## Error codes",
+        "Every `error.code` in a failure envelope is one of the following:",
+        catalogRows.join("\n"),
+    ]);
+}
+/**
+ * Every field a config layer may declare. Typed as an exhaustive `Record` over
+ * `keyof RawConfig`, so a field added to the type without a row here — or a row
+ * left behind by a field that was removed — is a COMPILE error, exactly as
+ * {@link ERROR_CODE_DESCRIPTIONS} works for the error kernel. Colocated
+ * (single-use) rather than in a module of its own: only `renderConfigPage`
+ * reads it, and a third artifact for two consumers to keep in step is what this
+ * discipline exists to avoid.
+ *
+ * The `type` column is authored prose; the page says so. Its OPTIONALITY is
+ * checked against the zod validator by `kernel/config/schema.test.ts`.
+ */
+const CONFIG_FIELD_DOCS = {
+    name: {
+        type: "string (optional)",
+        notes: "Distribution-only — see below. The program's own name, read from the distribution config at module load.",
+    },
+    help: {
+        type: "string (optional)",
+        notes: "Distribution-only — see below. The one-line blurb on the front door and in the MCP handshake.",
+    },
+    logo: {
+        type: "string[] (optional)",
+        notes: "Distribution-only — see below. ASCII-art wordmark lines shown above the header on root `--help`, tinted with the terminal palette's orange slot. Declared content, not code: a wordmark spells the distribution's name, so a fork ships its own art or omits the field and gets no wordmark. Omit or leave empty for a bare header.",
+    },
+    colophon: {
+        type: "object (optional)",
+        notes: "Distribution-only — see below. The toolchain's own story, rendered first by the `colophon` verb and titled with the distribution's name: `{ markdown, summary? }`, both Markdown bodies with no leading H1 (`summary` is the condensed `--format llm` form). Declared content, not code — a fork edits it to tell its own story.",
+    },
+    issuesUrl: {
+        type: "URL string (optional)",
+        notes: "Distribution-only — see below. Where the first-run note asks users to report problems.",
+    },
+    tier: {
+        type: "string (optional)",
+        notes: "Accepted by the validator and SCOPES NOTHING: since the block list became declared content, no read filters by tier — the value is only reported by `config show` and `info`. Set it with `config set tier <path>` and clear it with `config unset tier`; `none`, `default` and `-` are refused as values, so no string doubles as a remove-marker.",
+    },
+    channel: {
+        type: "`normal` | `experimental` | `prerelease` (optional)",
+        notes: "Selects the npm dist-tag `upgrade` and `info` check the registry with. It no longer scopes graph reads — no read filters by channel. Defaults to `normal`. Set it with `config set channel <name>`.",
+    },
+    detail: {
+        type: "`summary` | `standard` | `detailed` (optional)",
+        notes: "Default progressive-disclosure level. A closed enum, like `channel`: any other value fails at load with a `CONFIG_ERROR` naming the file and the three levels. Set it with `config set detail <level>`.",
+    },
+    packs: {
+        type: "array (optional)",
+        notes: "Semantic pack sources built by `sources update`. Each entry is a bare npm name or `{ name, source, stories? }`; `stories` are read stories the pack supplies, in the pack grammar.",
+    },
+    stories: {
+        type: "array (optional)",
+        notes: "Read stories not attached to any pack, in the pack grammar. Compiled at dispatch, and they win over the same noun declared under `packs[].stories`.",
+    },
+    prefixes: {
+        type: "record (optional)",
+        notes: "Namespace prefixes the pack is built with — they win every harvest, so this decides which IRI a prefix binds in the store and the index. Every surface uses the compiled-in display/expansion map to compact and expand prefixed names; only the DISTRIBUTION layer seeds it, because it is also read on the storeless fast path, before any config layer exists.",
+    },
+    completion: {
+        type: "object (optional)",
+        notes: "Completion policy read when `setup completions` emits a script: `minChars` and a per-noun `families` opt-out. It is the one field `config show` carries with NO origin at all.",
+    },
+};
+/**
+ * The fields `config show` prints with the layer that supplied them, in the
+ * order it prints them. NOT every field: `prefixes` and `completion` reach only
+ * the JSON payload, `stories` reaches only its `origins` key, and the four
+ * distribution-only fields reach neither. The page said the opposite — that
+ * every field but `completion` was reported — which is the claim this whole
+ * reference exists to make true rather than plausible.
+ *
+ * A literal, because the kernel emitter may not import a capability renderer.
+ * `capabilities/config/show.render.test.ts` derives the same list from the real
+ * formatter and fails if this page and that renderer disagree.
+ */
+const REPORTED_FIELDS = ["tier", "channel", "detail", "packs"];
+/** Render the layered-configuration reference: the layers, then the fields. */
+function renderConfigPage() {
+    const rows = ["| Field | Type | Notes |", "| --- | --- | --- |"];
+    for (const [field, doc] of Object.entries(CONFIG_FIELD_DOCS)) {
+        rows.push(`| \`${field}\` | ${escapeCell(doc.type)} | ${escapeCell(doc.notes)} |`);
+    }
+    return assemblePage([
+        "# Configuration reference",
+        `Every field a \`${BIN_NAME}\` config layer may declare. Generated from the config type — do not edit by hand. See [config-model.md](../config-model.md) for the authoring guide.`,
+        "## Layers",
+        "From lowest to highest precedence:",
+        [
+            `1. **Built-in defaults** — the distribution config shipped with the package.`,
+            `2. **Global config** — \`$XDG_CONFIG_HOME/${BIN_NAME}/config.json\`, written by \`${BIN_NAME} config set\`.`,
+            `3. **Project config** — the nearest \`${PROJECT_CONFIG_FILENAME}\` (or \`${BIN_NAME}.config.js\`, the JavaScript fallback), walking up from the working directory.`,
+        ].join("\n"),
+        "A higher layer REPLACES a lower one field by field. No field is deep-merged — not `packs`, not `prefixes`, not `completion`. A project declaring one prefix therefore replaces the distribution's whole prefix map, including the namespaces its own packs are built with; declare every prefix you need, not only the new one.",
+        "## Fields",
+        "The `Type` column is prose; the field set and each field's optionality are checked against the validator.",
+        rows.join("\n"),
+        "## Distribution-only fields",
+        `\`name\`, \`help\`, \`logo\` and \`issuesUrl\` are read from the distribution config when the program loads, because the surfaces that need them — \`--help\`, shell completion, the MCP handshake, the first-run note — run before or without the config layer. \`colophon\` is read from the same file at render time: the \`colophon\` verb narrates whatever the distribution declares there. The validator ACCEPTS all five in a global or project layer, and they have **no effect there and are not reported** by \`config show\`. Changing them means forking: edit the distribution config and rebuild the package. The distribution config's \`vocabulary\` export is not a config field at all — no layer may declare it, and a fork changes it in the same file it changes \`name\` in.`,
+        "## What `config show` reports",
+        `\`${BIN_NAME} config show\` prints ${REPORTED_FIELDS.map((field) => `\`${field}\``).join(", ")} — those and only those — each with the layer that supplied it. The rest resolve without being reported that way: \`prefixes\` and \`completion\` appear only in the \`--format json\` payload, \`prefixes\` with an origin and \`completion\` with none; \`stories\` carries an origin whose value the payload leaves out; and the five distribution-only fields above carry neither. The plain and llm forms print those rows and nothing else; \`--format json\` returns the resolved config and the origin map whole.`,
+        "## Renamed: `packages` → `packs`",
+        "The `packages` field was renamed to `packs`. A layer that still declares `packages:` fails loudly: the rename is detected before the schema's unknown-key stripping could hide it, and the error names it. Rename the key — the entry shape is unchanged.",
+        "## Removed: `generators`",
+        "The `generators` field was removed: it was accepted by the validator, layered, and read by nothing — the `create` verbs resolve their generators statically (they are imported by name, not looked up at run time), so declaring it changed only what `config show` printed. A layer that still declares it fails loudly at load with an error naming the removed field; delete it. Declared generators may return as a working feature in a later program.",
+        "## Removed: `completion.caseSensitive`",
+        "The `completion.caseSensitive` field was removed: it was accepted by the validator and read by nothing — completion matching is declared per parameter by the capability grammar, never configured. A layer that still sets it fails loudly at load with an error naming the removed field; delete the key. `completion.minChars` and `completion.families` are unchanged.",
+        "## Reading and writing",
+        `\`${BIN_NAME} config show\` prints the resolved config and each field's layer. \`${BIN_NAME} config set <key> <value>\` writes to the **global** layer only — project configs are authored by hand. Both are documented in the [command reference](./commands.md).`,
+    ]);
+}
+/** Render the reference index: overview, derived counts, and links. */
+function renderIndexPage(verbs, modules) {
+    const nouns = new Set(verbs.map((verb) => verb.path[0]));
+    const toolCount = verbs.filter((verb) => verb.capability.mcp.expose).length;
+    return assemblePage([
+        `# ${BIN_NAME} reference`,
+        `Machine-generated reference for the \`${BIN_NAME}\` CLI and MCP server, projected from the live capability grammar. Every page here is regenerated by the build and pinned by a drift-guard test, so it can never fall out of step with the code.`,
+        "## At a glance",
+        [
+            `- **${nouns.size}** command nouns`,
+            `- **${verbs.length}** CLI commands`,
+            `- **${toolCount}** MCP tools`,
+            `- **${collectMcpExtras(modules).resources.length}** resource template(s)`,
+        ].join("\n"),
+        "## Pages",
+        [
+            `- [CLI command reference](./commands.md) — every \`${BIN_NAME} <noun> <verb>\`, its arguments, flags, and examples.`,
+            "- [MCP tool reference](./tools.md) — every exposed tool, its input schema, and the non-tool surface.",
+            "- [Errors & exit codes](./errors.md) — the exit-code table, response envelope, and error catalog.",
+            "- [Configuration reference](./config.md) — every config field, the three layers, and how they combine.",
+        ].join("\n"),
+    ]);
+}
+/**
+ * Emit the Markdown reference doc set for a set of capability modules.
+ *
+ * Pure and deterministic: the same catalog always yields byte-identical pages
+ * (stable sort, declared param order, no version or timestamps).
+ *
+ * @param modules - The capability modules to project (hidden verbs excluded).
+ * @returns A map of `docs/reference/`-relative path → Markdown content, each
+ *   ending in exactly one trailing newline.
+ */
+export function emitReference(modules) {
+    const verbs = collectDocVerbs(modules);
+    return new Map([
+        ["index.md", renderIndexPage(verbs, modules)],
+        [
+            "commands.md",
+            renderCommandsPage(verbs, collectNounIntros(modules), collectVerbSyntax(modules)),
+        ],
+        ["tools.md", renderToolsPage(verbs, modules)],
+        ["errors.md", renderErrorsPage()],
+        ["config.md", renderConfigPage()],
+    ]);
+}
+//# sourceMappingURL=emitReference.js.map

package/dist/src/kernel/spec/emitReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitReference.js","sourceRoot":"","sources":["../../../../src/kernel/spec/emitReference.ts"],"names":[],"mappings":"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"}