@canonical/pragma-cli 0.36.0 → 0.37.0

package/src/kernel/project/cli/dispatch.ts

@@ -411,7 +411,29 @@ export async function executeVerb(
       }
     }
     if (mutation.undo) {
-      const { undoCount } = await runUndo(task, { onLog: logSink(flags) });
+      // The truth seam. `runUndo`'s collection phase drove the verb's task
+      // with every effect mocked, so anything the task body reported was a
+      // narration of the mocked walk, not of the reversals — which have only
+      // JUST run, each isolated, each with its own outcome. Those outcomes
+      // are the one honest record of what the undo did: a verb that reports
+      // per-target results sets `undoReport` (like `exec`/`planData`) and
+      // projects them onto its own rows; a throw from it renders as the
+      // run's error, exactly like a failed real run. Verbs without a
+      // projector of their own still may not exit 0 over a failed reversal,
+      // so the outcomes are re-checked here as the backstop.
+      const { undoCount, outcomes } = await runUndo(task, {
+        onLog: logSink(flags),
+      });
+      await mutationRuntime.undoReport?.(outcomes);
+      const failed = outcomes.filter((o) => o.status === "failed");
+      if (failed.length > 0) {
+        throw new PragmaError({
+          code: "UNSUPPORTED",
+          message: `${failed.length} of ${outcomes.length} undo step(s) did not complete: ${failed
+            .map((o) => o.error.message)
+            .join("; ")}`,
+        });
+      }
       return renderUndo(flags, undoCount);
     }
     // Real execution: spread the verb's runner options into the node

package/src/kernel/project/cli/rootHelp.ts

@@ -83,6 +83,14 @@ function buildKernelGroups(programName: string): readonly HelpGroup[] {
         },
         { noun: "info", summary: "Show version, config, and update status" },
         { noun: "version", summary: "Print the CLI version" },
+        // A colophon is the note at the back of a book: the typeface, the
+        // press, the paper. Nothing depends on it, which is the point — so
+        // this line does not argue for it. Every other summary in this column
+        // promises work done; this one just invites you to look. It sits with
+        // the other commands that describe the distribution rather than act on
+        // it; "For AI agents" is for surfaces an agent drives, and credits are
+        // for a person reading.
+        { noun: "colophon", summary: "Read the credits" },
         {
           noun: "upgrade",
           summary: `Upgrade the ${programName} CLI to the latest version`,
@@ -96,11 +104,6 @@ function buildKernelGroups(programName: string): readonly HelpGroup[] {
           noun: "capabilities",
           summary: "Discover conventions, tools, and the discovery sequence",
         },
-        // A colophon is the note at the back of a book: the typeface, the
-        // press, the paper. Nothing depends on it, which is the point — so
-        // this line does not argue for it. Every other summary in this column
-        // promises work done; this one just invites you to look.
-        { noun: "colophon", summary: "Read the credits" },
         { noun: "skill", summary: "Browse agent skills from the active packs" },
         { noun: "prompt", summary: "Browse reusable prompt templates" },
         // Curated for PLACEMENT, not for existence: `mcp serve` is an

package/src/kernel/render/prefixes.test.ts

@@ -13,6 +13,8 @@ describe("DEFAULT_PREFIX_MAP", () => {
       skos: "http://www.w3.org/2004/02/skos/core#",
       ds: "https://ds.canonical.com/",
       cs: "http://pragma.canonical.com/codestandards#",
+      dt: "https://dt.canonical.com/",
+      "w3c-tokens": "https://dt.canonical.com/w3c-tokens/",
     });
   });