@canonical/pragma-cli 0.38.0 → 0.40.0

package/dist/src/capabilities/sources/runReset.js

@@ -0,0 +1,59 @@
+/**
+ * Build the `sources reset` Task — drop this project's built pack.
+ *
+ * The counterpart of `sources update`: update points the project at a pack it
+ * built, reset takes the pointer away, so reads go back to what the config
+ * resolves to on its own (the snapshot shipped with the CLI, or — for a project
+ * that declares its own packs — nothing until it builds them again). It is the
+ * verb a user needs after an upgrade passes over a pack an older CLI built and
+ * they would rather remove it than rebuild it.
+ *
+ * THE POINTER, AND ONLY THE POINTER. The pack cache is content-addressed and
+ * SHARED: another project on this machine may point at the same hash, and the
+ * embedded snapshot is materialized into that same cache under its own hash, so
+ * a per-project verb that deleted pack directories would be deleting bytes it
+ * does not own. The pointer is the whole of a project's store state — one line
+ * naming a hash — so removing it is exactly, and only, "this project no longer
+ * reads a pack of its own". What stays behind is a cache doing its job: a later
+ * `sources update` over the same sources finds the pack complete and reuses it
+ * without a rebuild. (No `--all` for the same reason it has no flags at all:
+ * evicting the shared cache, or the git-ref checkouts beside it, is a different
+ * job from resetting one project, and this verb would be the wrong owner.)
+ *
+ * Nothing built is not a failure: the verb reports that it found nothing and
+ * exits 0, the way `config unset` does for a field that was never set. There is
+ * no state to correct — the project already reads what a reset would leave it
+ * reading.
+ */
+import { $, deleteFile, gen } from "@canonical/task";
+import { activePackPath, readActivePack } from "../../kernel/runtime/paths.js";
+/**
+ * Build the Task that removes the project's active-pack pointer.
+ *
+ * @param runtime - The per-invocation runtime.
+ * @returns A Task yielding what was removed and what answers reads now.
+ * @note Impure — reads config and the pointer; the Task deletes the pointer.
+ */
+export async function buildResetTask(runtime) {
+    const layers = await runtime.loadConfig();
+    const priorHash = readActivePack(runtime.cwd);
+    const path = activePackPath(runtime.cwd);
+    const data = {
+        removed: priorHash !== undefined,
+        contentHash: priorHash ?? null,
+        answers: layers.origins.packs === "default" ? "embedded" : "unavailable",
+    };
+    return gen(function* () {
+        // No pointer, no effect: a Task with nothing in it is what "nothing to do"
+        // looks like, and it keeps `--dry-run` honest (an empty plan, not a delete
+        // of a file that is not there).
+        if (priorHash !== undefined) {
+            // No undo is declared: an undo re-plans from the disk, where the pointer
+            // is already gone. The way back is `sources update`, which reuses the
+            // cached pack.
+            yield* $(deleteFile(path));
+        }
+        return data;
+    });
+}
+//# sourceMappingURL=runReset.js.map

package/dist/src/capabilities/sources/runReset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runReset.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/runReset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,EAAa,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAsB;IAEtB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAqB;QAC7B,OAAO,EAAE,SAAS,KAAK,SAAS;QAChC,WAAW,EAAE,SAAS,IAAI,IAAI;QAC9B,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;KACzE,CAAC;IAEF,OAAO,GAAG,CAAC,QAAQ,CAAC;QAClB,2EAA2E;QAC3E,2EAA2E;QAC3E,gCAAgC;QAChC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,yEAAyE;YACzE,sEAAsE;YACtE,eAAe;YACf,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/capabilities/sources/runUpdate.js

@@ -21,7 +21,7 @@
  */
 import { $, deleteFile, gen, info, mkdir, symlink, writeFile, } from "@canonical/task";
 import { VERSION } from "../../constants.js";
-import { cliRecovery, PragmaError } from "../../kernel/error/index.js";
+import { callRecovery, PragmaError } from "../../kernel/error/index.js";
 // DIRECT LEAF IMPORT, not `graphpack/index.js`. The barrel re-exports
 // `embedded.ts`, which statically imports the ~1.9 MB generated pack — and
 // with per-file `tsc` output ESM evaluates that re-export when this module
@@ -30,10 +30,11 @@ import { cliRecovery, PragmaError } from "../../kernel/error/index.js";
 import { buildPack } from "../../kernel/runtime/graphpack/build.js";
 import { activePackPath, readActivePack } from "../../kernel/runtime/paths.js";
 import { detectPrefixClashes, harvestPrefixes, parsePackDeclaration, redactUrl, resolvePackage, } from "../../kernel/runtime/refs/index.js";
+import { existingGlobalSkillDirs } from "../setup/operations/setupSkills.js";
 // The global scope's EXISTING link directories, from the module that owns the
 // scope covenant — so `sources update` cannot drift away from what
 // `setup skills --global` links, or widen the scope on its own.
-import { existingGlobalSkillDirs } from "../setup/operations/setupSkills.js";
+import { VERBOSE_BUILD_CALL } from "../shared/calls.js";
 import { globalSkillRoots, installedSkillsDir } from "../skill/discover.js";
 import { planHarnessSkillLinks, planSkillInstall } from "./installSkills.js";
 /** Generic-core prefixes; config `prefixes` merge over them (config wins). */
@@ -153,7 +154,7 @@ export async function buildUpdateTask(runtime, skipInvalid = false) {
         throw PragmaError.configError(entries.length === 0
             ? "No packs are configured, so there are no sources to build a store from. The embedded pack answers reads until you add a pack."
             : `The ${entries.length} configured pack(s) resolved 0 RDF sources (no definitions/**.ttl or data/**.ttl). Refusing to build an empty store.`, {
-            recovery: cliRecovery("sources update --verbose", "Add a pack that ships `.ttl` under definitions/ or data/, then re-run."),
+            recovery: callRecovery(VERBOSE_BUILD_CALL, "Add a pack that ships `.ttl` under definitions/ or data/, then re-run."),
         });
     }
     const prefixes = buildPackPrefixes(inputs, layers.config.prefixes);
@@ -211,7 +212,7 @@ export async function buildUpdateTask(runtime, skipInvalid = false) {
         report?.(`Skipped ${bad.length} invalid source(s); building from ${usableInputs.length} of ${inputs.length}`);
         if (usableInputs.length === 0)
             throw PragmaError.configError(`None of the ${inputs.length} configured source(s) can be parsed — nothing to build.`, {
-                recovery: cliRecovery("sources update --verbose", "Fix the reported sources, then re-run."),
+                recovery: callRecovery(VERBOSE_BUILD_CALL, "Fix the reported sources, then re-run."),
             });
         try {
             built = await buildPack(usableInputs, {
@@ -236,7 +237,7 @@ export async function buildUpdateTask(runtime, skipInvalid = false) {
     // predating the triple count is left alone — `undefined` never trips this.)
     if (built.manifest.tripleCount === 0) {
         throw PragmaError.configError(`The configured sources parsed to 0 RDF triples, so the store would be empty. Refusing to build an empty store.`, {
-            recovery: cliRecovery("sources update --verbose", "Check that the pack sources actually contain RDF triples, then re-run."),
+            recovery: callRecovery(VERBOSE_BUILD_CALL, "Check that the pack sources actually contain RDF triples, then re-run."),
         });
     }
     const path = activePackPath(runtime.cwd);
@@ -399,7 +400,7 @@ export async function classifySourceBuildError(error, inputs) {
         ? `Pack source "${culprit.path}" cannot be parsed`
         : "The configured packs cannot be built into a store";
     return PragmaError.configError(`${where}: ${detail}`, {
-        recovery: cliRecovery("sources update --verbose", "Re-run with --verbose to see each file as it parses. If a pack ships malformed RDF, report it to that pack's maintainer."),
+        recovery: callRecovery(VERBOSE_BUILD_CALL, "A verbose re-run shows each file as it parses. If a pack ships malformed RDF, report it to that pack's maintainer."),
     });
 }
 /**

package/dist/src/capabilities/sources/runUpdate.js.map

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

package/dist/src/capabilities/sources/status.render.js

@@ -1,18 +1,23 @@
 /**
  * Formatters for `pragma sources status` — plain, llm, json.
  */
-import { BIN_NAME } from "../../constants.js";
 import { defaultStyle } from "../../kernel/render/style.js";
+import { describeIgnoredPack } from "../../kernel/runtime/resolveSources.js";
+import { renderCall } from "../../kernel/spec/call.js";
+import { BUILD_STORE_CALL } from "../shared/calls.js";
 /**
  * The headline for each boot decision. The `embedded` case names the update
  * explicitly: the distribution's snapshot answers reads, but it is a snapshot,
  * so reporting it as "up to date" would be a lie.
  */
-const STORE_HEADLINE = {
-    built: "ready",
-    embedded: `embedded snapshot (run \`${BIN_NAME} sources update\` to build from the configured packs)`,
-    unavailable: `not built (run \`${BIN_NAME} sources update\`)`,
-};
+function storeHeadline(store) {
+    const update = `run \`${renderCall(BUILD_STORE_CALL, "cli")}\``;
+    if (store === "built")
+        return "ready";
+    return store === "embedded"
+        ? `embedded snapshot (${update} to build from the configured packs)`
+        : `not built (${update})`;
+}
 /**
  * Render `sources status` as plain text.
  *
@@ -24,10 +29,17 @@ const STORE_HEADLINE = {
  * @returns The formatted status block.
  */
 export function renderSourcesStatusPlain(data, style = defaultStyle()) {
-    const lines = [`Store: ${STORE_HEADLINE[data.store]}`];
+    const lines = [`Store: ${storeHeadline(data.store)}`];
     if (data.contentHash !== null) {
         lines.push(`  pack: ${data.contentHash.slice(0, 12)} — ${data.entityCount ?? "?"} entities, built ${data.builtAt ?? "?"}`, `  from: ${data.sourceRef ?? "?"}`);
     }
+    // The pack this project built and is NOT reading. It says so on its own line
+    // rather than in the headline: the headline answers "what is answering", and
+    // the answer (the snapshot) is unchanged — this is the extra fact that the
+    // directory has a pack and it is being passed over.
+    if (data.ignoredPack !== null) {
+        lines.push(`  ${data.ignoredPack.contentHash.slice(0, 12)}: ${describeIgnoredPack(data.ignoredPack)}`);
+    }
     lines.push("", style.enabled ? style.bold("Sources:") : "Sources:");
     if (data.sources.length === 0) {
         lines.push("  (none configured)");
@@ -47,7 +59,11 @@ export const statusFormatters = {
         return renderSourcesStatusPlain(data);
     },
     llm(data) {
-        const lines = [`# sources`, `- Store: ${data.store}`];
+        // The next step rides the condensed form too: an agent reading `embedded`
+        // or `unavailable` bare was told a state and not what to do about it.
+        const lines = [`# sources`, `- Store: ${storeHeadline(data.store)}`];
+        if (data.ignoredPack !== null)
+            lines.push(`- Ignored: ${describeIgnoredPack(data.ignoredPack)}`);
         if (data.sourceRef !== null)
             lines.push(`- From: ${data.sourceRef}`);
         if (data.entityCount !== null)

package/dist/src/capabilities/sources/status.render.js.map

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

package/dist/src/capabilities/sources/status.verb.js

@@ -14,6 +14,7 @@ export const statusVerb = {
     path: ["sources", "status"],
     summary: "Report which pack answers reads, and the packs it was built from.",
     doc: "Storeless — reads config and the pack cache without booting the store, so it works even when the store is cold. Reports whether reads are answered by a locally built pack, by the embedded snapshot, or not at all.",
+    useWhen: "when results look empty or stale, to see which data pack is answering",
     params: [],
     output: { formatters: statusFormatters },
     examples: [

package/dist/src/capabilities/sources/status.verb.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/status.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,mEAAmE;IAC5E,GAAG,EAAE,sNAAsN;IAC3N,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,GAAG,QAAQ,iBAAiB;YACjC,IAAI,EAAE,kCAAkC;SACzC;QACD;YACE,GAAG,EAAE,GAAG,QAAQ,+BAA+B;YAC/C,IAAI,EAAE,mBAAmB;SAC1B;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK;QACnB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3C,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAC9B;CACJ,CAAC"}
+{"version":3,"file":"status.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/status.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,mEAAmE;IAC5E,GAAG,EAAE,sNAAsN;IAC3N,OAAO,EACL,uEAAuE;IACzE,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,GAAG,QAAQ,iBAAiB;YACjC,IAAI,EAAE,kCAAkC;SACzC;QACD;YACE,GAAG,EAAE,GAAG,QAAQ,+BAA+B;YAC/C,IAAI,EAAE,mBAAmB;SAC1B;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,YAAY,EAAE,KAAK;QACnB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;SAC1D;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAC3C,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAC9B;CACJ,CAAC"}

package/dist/src/capabilities/sources/update.verb.js

@@ -18,6 +18,8 @@ export const updateVerb = {
     path: ["sources", "update"],
     summary: "Resolve configured packs and build the local store from them.",
     doc: "Resolves each configured pack (git, file, or npm) and builds one local pack from them, which every later run reads without touching the network. Put a commit SHA in a pack source ref to pin it to that revision.",
+    useWhen: "when asked to fetch or rebuild the design-system data, or when a read reports that the store is unavailable",
+    example: { skipInvalid: true },
     params: [
         {
             kind: "boolean",

package/dist/src/capabilities/sources/update.verb.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/update.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,+DAA+D;IACxE,GAAG,EAAE,oNAAoN;IACzN,MAAM,EAAE;QACN;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,+GAA+G;SACrH;KACF;IACD,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE;QAChE;YACE,GAAG,EAAE,GAAG,QAAQ,gCAAgC;YAChD,IAAI,EAAE,8DAA8D;SACrE;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;SAC1D;KACF;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,+EAA+E;IAC/E,6EAA6E;IAC7E,6CAA6C;IAC7C,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACvB,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CACvB;CAC1C,CAAC"}
+{"version":3,"file":"update.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/sources/update.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,sCAAsC;AACtC,MAAM,CAAC,MAAM,UAAU,GAGnB;IACF,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,+DAA+D;IACxE,GAAG,EAAE,oNAAoN;IACzN,OAAO,EACL,6GAA6G;IAC/G,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;IAC9B,MAAM,EAAE;QACN;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,+GAA+G;SACrH;KACF;IACD,MAAM,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACxC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,iBAAiB,EAAE,IAAI,EAAE,mBAAmB,EAAE;QAChE;YACE,GAAG,EAAE,GAAG,QAAQ,gCAAgC;YAChD,IAAI,EAAE,8DAA8D;SACrE;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE;SAC1D;KACF;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,uEAAuE;IACvE,2EAA2E;IAC3E,4EAA4E;IAC5E,+EAA+E;IAC/E,6EAA6E;IAC7E,6CAA6C;IAC7C,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CACvB,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,CACvB;CAC1C,CAAC"}

package/dist/src/capabilities/upgrade/upgrade.verb.js

@@ -19,6 +19,7 @@ const upgradeVerb = {
     path: ["upgrade"],
     summary: `Upgrade the ${BIN_NAME} CLI to the latest version.`,
     doc: "Checks the registry for the active channel's latest release and runs your package manager's global-update command. Preview the update before applying it.",
+    useWhen: "when asked to update the CLI itself to the latest release",
     params: [],
     output: { formatters: upgradeFormatters },
     examples: [

package/dist/src/capabilities/upgrade/upgrade.verb.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/upgrade/upgrade.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,GAAmD;IAClE,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,eAAe,QAAQ,6BAA6B;IAC7D,GAAG,EAAE,2JAA2J;IAChK,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACzC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,UAAU,EAAE;QAC9B;YACE,GAAG,EAAE,GAAG,QAAQ,oBAAoB;YACpC,IAAI,EAAE,gCAAgC;SACvC;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE;gBACX,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE,KAAK;aACrB;SACF;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CACU;CACpC,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC7B,CAAC"}
+{"version":3,"file":"upgrade.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/upgrade/upgrade.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,GAAmD;IAClE,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,eAAe,QAAQ,6BAA6B;IAC7D,GAAG,EAAE,2JAA2J;IAChK,OAAO,EAAE,2DAA2D;IACpE,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACzC,QAAQ,EAAE;QACR,EAAE,GAAG,EAAE,GAAG,QAAQ,UAAU,EAAE;QAC9B;YACE,GAAG,EAAE,GAAG,QAAQ,oBAAoB;YACpC,IAAI,EAAE,gCAAgC;SACvC;KACF;IACD,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,IAAI;QAClB,GAAG,EAAE;YACH,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE;gBACX,YAAY,EAAE,KAAK;gBACnB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE,KAAK;aACrB;SACF;KACF;IACD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CACxB,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CACU;CACpC,CAAC;AAEF,uCAAuC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAqB;IAC7C,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;CAC7B,CAAC"}

package/dist/src/capabilities/version/version.verb.js

@@ -12,6 +12,7 @@ const versionVerb = {
     path: ["version"],
     summary: "Print the CLI version.",
     doc: "Prints the version `--version` prints — one value, two spellings of the same read.",
+    useWhen: "when asked only for the installed version number",
     params: [],
     output: {
         formatters: {

package/dist/src/capabilities/version/version.verb.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/version/version.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,MAAM,WAAW,GAA8C;IAC7D,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,wBAAwB;IACjC,GAAG,EAAE,oFAAoF;IACzF,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;YAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;YACzB,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAC/C;KACF;IACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,QAAQ,UAAU,EAAE,CAAC;IAC1C,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE;YACH,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,6DAA6D;SACtE;KACF;IACD,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO;CACzB,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"version.verb.js","sourceRoot":"","sources":["../../../../src/capabilities/version/version.verb.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAGrD,MAAM,WAAW,GAA8C;IAC7D,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,OAAO,EAAE,wBAAwB;IACjC,GAAG,EAAE,oFAAoF;IACzF,OAAO,EAAE,kDAAkD;IAC3D,MAAM,EAAE,EAAE;IACV,MAAM,EAAE;QACN,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;YAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO;YACzB,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAC/C;KACF;IACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,QAAQ,UAAU,EAAE,CAAC;IAC1C,UAAU,EAAE;QACV,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;QACd,GAAG,EAAE;YACH,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,6DAA6D;SACtE;KACF;IACD,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,OAAO;CACzB,CAAC;AAEF,0BAA0B;AAC1B,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/src/constants.js

@@ -51,9 +51,10 @@ const PROJECT_CONFIG_FILENAME = `${identity.name}.config.ts`;
 /**
  * The distribution's name plus a space: the prefix a `recovery.cli` hint carries
  * so it quotes a command the installed binary answers to (D5). Kernel hints are
- * authored through `cliRecovery`, which prepends it; `packs/schema.ts` REJECTS
- * it in a user-authored pack's `emptyRecovery.cli`, because the CONSUMING
- * distribution's renderer supplies its own. Use {@link BIN_NAME} for prose —
+ * authored through `callRecovery`, whose call renderer prepends it; a pack's
+ * `emptyRecovery.call` names a verb path and never a binary (`packs/schema.ts`
+ * rejects a command line there), because the CONSUMING distribution's renderer
+ * supplies its own. Use {@link BIN_NAME} for prose —
  * this constant's trailing space belongs to the recovery invariant, not to
  * sentences.
  */

package/dist/src/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAE3E,mDAAmD;AACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEtC,iEAAiE;AACjE,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE1C,qEAAqE;AACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC;AAEtC,oDAAoD;AACpD,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAEpC;;;;GAIG;AACH,MAAM,oBAAoB,GAAW,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,GAAG,QAAQ,CAAC,IAAI,YAAY,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC;AAEhD,oFAAoF;AACpF,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AASzD,yEAAyE;AACzE,MAAM,oBAAoB,GAAgB,UAAU,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,sEAAsE;AACtE,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,QAAQ,GAAc,QAAQ,CAAC;AAErC,MAAM,YAAY,GAAsB,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAG5D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,GACR,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACxD,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAoB,MAAM,0BAA0B,CAAC;AAE3E,mDAAmD;AACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEtC,iEAAiE;AACjE,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE1C,qEAAqE;AACrE,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC;AAEtC,oDAAoD;AACpD,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC;AAEpC;;;;GAIG;AACH,MAAM,oBAAoB,GAAW,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,uBAAuB,GAAG,GAAG,QAAQ,CAAC,IAAI,YAAY,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAG,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC;AAEhD,oFAAoF;AACpF,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AASzD,yEAAyE;AACzE,MAAM,oBAAoB,GAAgB,UAAU,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,sEAAsE;AACtE,6EAA6E;AAC7E,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,QAAQ,GAAc,QAAQ,CAAC;AAErC,MAAM,YAAY,GAAsB,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAG5D,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,OAAO,GACR,CAAC"}

package/dist/src/kernel/error/index.js

@@ -7,7 +7,7 @@
  */
 export { ERROR_CODES } from "./constants.js";
 export { PragmaError } from "./PragmaError.js";
-export { cliRecovery } from "./recovery.js";
+export { callRecovery } from "./recovery.js";
 export { renderErrorJson, renderErrorLlm, renderErrorPlain, } from "./renderError.js";
 export { serializeError } from "./serialize.js";
 //# sourceMappingURL=index.js.map

package/dist/src/kernel/error/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kernel/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kernel/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/kernel/error/recovery.js

@@ -1,52 +1,34 @@
 /**
- * The recovery-string invariant (D5).
+ * The recovery invariant (D5): a `recovery.cli` hint quotes a command the
+ * installed binary answers to, so it begins with {@link RECOVERY_CLI_PREFIX}.
  *
- * A `recovery.cli` hint quotes a command the installed binary answers to, so it
- * must begin with {@link RECOVERY_CLI_PREFIX} — the distribution's own `name`
- * plus a space. {@link cliRecovery} takes the command SUFFIX and prepends the
- * prefix itself, so a hint that names the wrong binary is unwritable rather
- * than merely detected. That is why there is no assertion here: an assertion
- * over a string the caller composed from the prefix cannot fail, and the hints
- * that were actually wrong were raw `cli:` object literals that never reached
- * this function at all. `kernel/copy.test.ts` covers those, at the position.
- *
- * A THIRD authoring route is also legal and reached by NEITHER guard: a `cli`
- * DERIVED from the program's own name at the call site. One site does this —
- * the create mount (`capabilities/create/mount.ts`,
- * `[...detail.chain, suggestion].join(" ")`), whose `chain[0]` is the root
- * Commander program's name, `BIN_NAME` by wiring. It bypasses
- * {@link cliRecovery}, and the position rule is structurally blind to it (it
- * flags QUOTED literals containing the distribution's name, never a computed
- * expression) — so D5 holds there by derivation, and the derivation is pinned
- * where the value surfaces: `createGrammar.test.ts` COMPOSES its expected
- * `cli` from {@link RECOVERY_CLI_PREFIX}, so a renamed root program reddens
- * the cell naming the constant. (A separate `startsWith` assertion cannot
- * pin it — behind an exact pin of the same value it has no reachable
- * failing input.)
- *
- * `kernel/packs/schema.ts` holds a user-authored pack's `emptyRecovery.cli` to
- * the same shape from the other side — it must NOT carry a prefix, because the
- * consuming distribution's renderer supplies one.
+ * {@link callRecovery} takes a CALL and the one call renderer spells it, prefix
+ * included, so a hint naming the wrong binary — or a `cli` and an `mcp` that
+ * disagree — is unwritable. Two routes do not pass through here:
+ * raw `cli:` object literals (`kernel/copy.test.ts` polices those at the
+ * position), and the create mount, which DERIVES its `cli` from the root
+ * program's name (`capabilities/create/mount.ts`; pinned by
+ * `createGrammar.test.ts`, whose expectation is composed from the prefix).
+ * A pack's `emptyRecovery.call` is held to the same shape from the other side
+ * by `kernel/packs/schema.ts`: a verb path, never a binary name.
  */
-import { RECOVERY_CLI_PREFIX } from "../../constants.js";
+import { callTool, renderCall } from "../spec/call.js";
 /**
- * Build a {@link Recovery} whose `cli` command carries the distribution's own
- * prefix, optionally pairing it with an MCP tool an agent can call.
+ * Build a {@link Recovery} from the call that recovers.
  *
- * A recovery may need to speak to BOTH surfaces: the `cli` string guides a human,
- * while `mcp` names the tool an agent invokes (an agent cannot run a shell
- * command). The single human `message` is shared by both.
+ * A recovery speaks to BOTH surfaces: `cli` guides a person, while `mcp` names
+ * the tool an agent invokes (an agent cannot run a shell command). Both derive
+ * from the one call, so they cannot disagree about the verb or its arguments;
+ * `mcp` is absent only when the verb is withheld from MCP. Neither spelling
+ * ever carries `confirm`: a mutating tool is plan-first, and the plan it
+ * returns says how to proceed.
  *
- * @param command - The recovery command WITHOUT the binary name (`sources update`).
+ * @param call - The verb to run and the params to run it with.
  * @param message - Human-readable guidance shown alongside the command.
- * @param mcp - The MCP tool (and optional params) an agent calls to recover.
- * @returns A recovery hint whose `cli` names this distribution's binary.
+ * @returns A recovery hint carrying the call in both spellings.
  */
-export function cliRecovery(command, message, mcp) {
-    return {
-        message,
-        cli: `${RECOVERY_CLI_PREFIX}${command}`,
-        ...(mcp ? { mcp } : {}),
-    };
+export function callRecovery(call, message) {
+    const mcp = callTool(call);
+    return { message, cli: renderCall(call, "cli"), ...(mcp ? { mcp } : {}) };
 }
 //# sourceMappingURL=recovery.js.map

package/dist/src/kernel/error/recovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../../../src/kernel/error/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,OAAe,EACf,GAAqB;IAErB,OAAO;QACL,OAAO;QACP,GAAG,EAAE,GAAG,mBAAmB,GAAG,OAAO,EAAE;QACvC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../../../src/kernel/error/recovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,OAAe;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC"}