akm-cli 0.9.18 → 0.9.19-alpha.2

package/dist/output/shapes.js

@@ -29,6 +29,7 @@ import { proposalDiffShapes } from "./shapes/proposal/diff.js";
 import { proposalListShapes } from "./shapes/proposal/list.js";
 import { proposalProducerShapes } from "./shapes/proposal/producer.js";
 import { proposalRejectShapes } from "./shapes/proposal/reject.js";
+import { proposalReopenShapes } from "./shapes/proposal/reopen.js";
 import { proposalShowShapes } from "./shapes/proposal/show.js";
 import { getOutputShapeHandler, registerOutputShapes } from "./shapes/registry.js";
 import { registrySearchShapes } from "./shapes/registry-search.js";
@@ -51,6 +52,7 @@ const BUILT_IN_OUTPUT_SHAPES = [
     ...proposalShowShapes,
     ...proposalAcceptShapes,
     ...proposalRejectShapes,
+    ...proposalReopenShapes,
     ...proposalDiffShapes,
     ...proposalProducerShapes,
     ...envListShapes,

package/dist/output/text/helpers.js

@@ -18,6 +18,6 @@
 export { formatAddPlain, formatBundleRenamePlain, formatBundleShowPlain, formatClonePlain, formatConfigPlain, formatCuratePlain, formatEnvCreatePlain, formatEnvExportPlain, formatEnvListPlain, formatEnvRemovePlain, formatEventLine, formatEventsPlain, formatFeedbackPlain, formatImportPlain, formatIndexPlain, formatInfoPlain, formatInitPlain, formatListPlain, formatModelsListPlain, formatRegistryAddPlain, formatRegistryListPlain, formatRegistryRemovePlain, formatRegistrySearchPlain, formatRememberPlain, formatRemovePlain, formatSearchPlain, formatSyncPlain, formatUpdatePlain, formatUpgradePlain, } from "./command-format.js";
 export { formatHealthPlain } from "./health-format.js";
 export { formatLintPlain } from "./lint-format.js";
-export { formatGateDecisionSummary, formatProposalAcceptPlain, formatProposalDiffPlain, formatProposalDrainPlain, formatProposalListPlain, formatProposalProducerPlain, formatProposalRejectPlain, formatProposalShowPlain, } from "./proposal-format.js";
+export { formatGateDecisionSummary, formatProposalAcceptPlain, formatProposalDiffPlain, formatProposalDrainPlain, formatProposalListPlain, formatProposalProducerPlain, formatProposalRejectPlain, formatProposalReopenBatchPlain, formatProposalReopenPlain, formatProposalShowPlain, } from "./proposal-format.js";
 export { formatShowPlain } from "./show-format.js";
 export { formatWorkflowCreatePlain, formatWorkflowListPlain, formatWorkflowPlanPlain, formatWorkflowResumePlain, formatWorkflowRunPlain, formatWorkflowStatusPlain, } from "./workflow-format.js";

package/dist/output/text/proposal/proposal.js

@@ -2,12 +2,14 @@
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
 // Output text formatters for `akm proposal *` (#225).
-import { formatProposalAcceptPlain, formatProposalDiffPlain, formatProposalDrainPlain, formatProposalListPlain, formatProposalRejectPlain, formatProposalShowPlain, } from "../helpers.js";
+import { formatProposalAcceptPlain, formatProposalDiffPlain, formatProposalDrainPlain, formatProposalListPlain, formatProposalRejectPlain, formatProposalReopenBatchPlain, formatProposalReopenPlain, formatProposalShowPlain, } from "../helpers.js";
 export const proposalFormatters = [
     { command: "proposal-list", handler: (r) => formatProposalListPlain(r) },
     { command: "proposal-show", handler: (r) => formatProposalShowPlain(r) },
     { command: "proposal-accept", handler: (r) => formatProposalAcceptPlain(r) },
     { command: "proposal-reject", handler: (r) => formatProposalRejectPlain(r) },
+    { command: "proposal-reopen", handler: (r) => formatProposalReopenPlain(r) },
+    { command: "proposal-reopen-batch", handler: (r) => formatProposalReopenBatchPlain(r) },
     { command: "proposal-diff", handler: (r) => formatProposalDiffPlain(r) },
     { command: "proposal-drain", handler: (r) => formatProposalDrainPlain(r) },
 ];

package/dist/output/text/proposal-format.js

@@ -113,6 +113,47 @@ export function formatProposalListPlain(r) {
     }
     return lines.join("\n").trimEnd();
 }
+/**
+ * A retire proposal's verdict lines — the pair judge's label and reason, and
+ * the continuity check's failing queries — as `proposal show` and `proposal
+ * diff` both print them. `retirement` is the stored block, which `proposal
+ * diff` reports under the same keys.
+ */
+function retireVerdictLines(retirement) {
+    const lines = [
+        `retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`,
+        `retire.reason: ${String(retirement.judgeReason)}`,
+    ];
+    // Item 1 (continuity check): flagged, but still minted — never swept by a
+    // bulk accept, only acceptable by id, so a reviewer must see it.
+    const continuityRisk = retirement.continuityRisk;
+    if (continuityRisk) {
+        const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
+        const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
+        const summary = [];
+        if (failingQueries > 0) {
+            summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
+        }
+        // S2: a query the search call never ran, or that fell back to
+        // keyword-only ranking, is never silently trusted OR silently
+        // dropped — it excludes the proposal from bulk accept on its own.
+        if (unverifiedQueries > 0) {
+            summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
+        }
+        lines.push(`retire.continuityRisk: ${summary.join("; ")} — excluded from bulk accept`);
+        // N3 / S4: the actual failing query text, not just the count — a
+        // reviewer deciding whether to accept by id needs to see what would
+        // stop resolving, not just how many queries.
+        const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
+        for (const rank of ranks) {
+            const successorRank = rank.successorRank === null || rank.successorRank === undefined
+                ? "absent from top 10"
+                : `#${String(rank.successorRank)}`;
+            lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
+        }
+    }
+    return lines;
+}
 export function formatProposalShowPlain(r) {
     const p = r.proposal;
     const lines = [];
@@ -150,42 +191,24 @@ export function formatProposalShowPlain(r) {
         if (review.decidedAt)
             lines.push(`review.decidedAt: ${String(review.decidedAt)}`);
     }
+    // `akm proposal reopen` (#997): the rejection each reopen undid, so a
+    // pending proposal that was once rejected says so.
+    const history = Array.isArray(p.reviewHistory) ? p.reviewHistory : [];
+    for (const entry of history) {
+        const undone = entry.review;
+        const was = undone
+            ? `${String(undone.outcome ?? "?")}${undone.reason ? `: ${String(undone.reason)}` : ""} (${String(undone.decidedAt ?? "?")})`
+            : "an unrecorded review";
+        const why = entry.reopenReason ? ` (${String(entry.reopenReason)})` : "";
+        lines.push(`reopened: ${String(entry.reopenedAt)}${why}, undoing ${was}`);
+    }
     // alpha.9: a consolidate retire proposal writes no content (`payload.content`
     // is empty by design) — this is the reason a reviewer needs instead. `diff`
     // shows the body being retired.
     const retirement = p.retirement;
     if (retirement) {
         lines.push(`retire: ${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}`);
-        lines.push(`retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`);
-        lines.push(`retire.reason: ${String(retirement.judgeReason)}`);
-        // Item 1 (continuity check): flagged, but still minted — never swept by a
-        // bulk accept, only acceptable by id, so a reviewer must see it here.
-        const continuityRisk = retirement.continuityRisk;
-        if (continuityRisk) {
-            const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
-            const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
-            const summary = [];
-            if (failingQueries > 0) {
-                summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
-            }
-            // S2: a query the search call never ran, or that fell back to
-            // keyword-only ranking, is never silently trusted OR silently
-            // dropped — it excludes the proposal from bulk accept on its own.
-            if (unverifiedQueries > 0) {
-                summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
-            }
-            lines.push(`retire.continuityRisk: ${summary.join("; ")} — excluded from bulk accept`);
-            // N3 / S4: the actual failing query text, not just the count — a
-            // reviewer deciding whether to accept by id needs to see what would
-            // stop resolving, not just how many queries.
-            const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
-            for (const rank of ranks) {
-                const successorRank = rank.successorRank === null || rank.successorRank === undefined
-                    ? "absent from top 10"
-                    : `#${String(rank.successorRank)}`;
-                lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
-            }
-        }
+        lines.push(...retireVerdictLines(retirement));
     }
     const validation = r.validation;
     if (validation) {
@@ -215,7 +238,10 @@ export function formatProposalShowPlain(r) {
         }
     }
     const payload = p.payload;
-    if (payload && typeof payload.content === "string") {
+    // A retire proposal's payload is empty by design (it archives a file, it
+    // writes none): a bare `payload:` heading reads as "replaced by nothing" —
+    // the misreading #997 is about — so the retirement lines above stand alone.
+    if (!retirement && payload && typeof payload.content === "string") {
         lines.push("");
         lines.push("payload:");
         lines.push(payload.content);
@@ -229,6 +255,18 @@ export function formatProposalRejectPlain(r) {
     const reason = r.reason ? ` (${String(r.reason)})` : "";
     return `Rejected proposal ${String(r.id)} (${String(r.ref)})${reason}`;
 }
+export function formatProposalReopenPlain(r) {
+    const reason = r.reason ? ` (${String(r.reason)})` : "";
+    return `Reopened proposal ${String(r.id)} (${String(r.ref)}) [pending]${reason}`;
+}
+export function formatProposalReopenBatchPlain(r) {
+    const results = Array.isArray(r.results) ? r.results : [];
+    const reason = results[0]?.reason ? ` (${String(results[0].reason)})` : "";
+    return [
+        `Reopened ${results.length} proposal(s) [pending]${reason}`,
+        ...results.map((result) => `  ${String(result.id)}  ${String(result.ref)}`),
+    ].join("\n");
+}
 export function formatProposalDrainPlain(r) {
     const applyMode = String(r.applyMode ?? "queue");
     const promoted = Array.isArray(r.promoted) ? r.promoted : [];
@@ -257,10 +295,27 @@ export function formatProposalDrainPlain(r) {
     return lines.join("\n").trimEnd();
 }
 export function formatProposalDiffPlain(r) {
+    const unified = typeof r.unified === "string" ? r.unified : "";
+    if (r.op === "delete") {
+        // #997: a retire proposal archives its target — it does not "update" it —
+        // so the header says so, and the pair verdict and the accept/revert note
+        // sit above the file that is leaving.
+        const retirement = r.retirement;
+        const subject = retirement
+            ? `${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}`
+            : String(r.ref);
+        const lines = [`# proposal ${String(r.id)} (retire: ${subject})`];
+        if (retirement)
+            lines.push(...retireVerdictLines(retirement));
+        if (typeof r.note === "string")
+            lines.push(`note: ${r.note}`);
+        if (unified)
+            lines.push(unified);
+        return lines.join("\n");
+    }
     const header = r.isNew
         ? `# proposal ${String(r.id)} (new asset: ${String(r.ref)})`
         : `# proposal ${String(r.id)} (update: ${String(r.ref)})`;
-    const unified = typeof r.unified === "string" ? r.unified : "";
     if (!unified)
         return `${header}\n(no changes)`;
     return `${header}\n${unified}`;

package/dist/scripts/akm-migrate-node.js

@@ -28540,6 +28540,7 @@ function shapeProposalEntry(entry, detail) {
       "confidence",
       "gateDecision",
       "review",
+      "reviewHistory",
       "retirement"
     ]);
   }
@@ -28555,6 +28556,7 @@ function shapeProposalEntry(entry, detail) {
     "gateDecision",
     "payload",
     "review",
+    "reviewHistory",
     "retirement",
     "retiredArchive",
     "promotionSource",
@@ -28619,7 +28621,10 @@ function shapeProposalDiffOutput(result, detail) {
     ref: result.ref,
     isNew: result.isNew,
     unified: result.unified,
-    ...result.targetPath !== undefined ? { targetPath: result.targetPath } : {}
+    ...result.targetPath !== undefined ? { targetPath: result.targetPath } : {},
+    ...result.op !== undefined ? { op: result.op } : {},
+    ...result.retirement !== undefined ? { retirement: result.retirement } : {},
+    ...result.note !== undefined ? { note: result.note } : {}
   };
   if (detail === "full") {
     return { schemaVersion: result.schemaVersion, ...base };
@@ -29041,6 +29046,7 @@ var PASSTHROUGH_COMMANDS = [
   "proposal-accept-batch",
   "proposal-drain",
   "proposal-reject-batch",
+  "proposal-reopen-batch",
   "proposal-revert",
   "registry-add",
   "registry-list",
@@ -29112,6 +29118,14 @@ var proposalRejectShapes = [
   }
 ];
 
+// src/output/shapes/proposal/reopen.ts
+var proposalReopenShapes = [
+  {
+    command: "proposal-reopen",
+    handler: (result, detail) => shapeProposalRejectOutput(result, detail)
+  }
+];
+
 // src/output/shapes/proposal/show.ts
 var proposalShowShapes = [
   {
@@ -29202,6 +29216,7 @@ var BUILT_IN_OUTPUT_SHAPES = [
   ...proposalShowShapes,
   ...proposalAcceptShapes,
   ...proposalRejectShapes,
+  ...proposalReopenShapes,
   ...proposalDiffShapes,
   ...proposalProducerShapes,
   ...envListShapes,
@@ -30423,6 +30438,31 @@ Generate one with \`akm improve <ref>\` or \`akm proposal new <type> <name> --ta
   return lines.join(`
 `).trimEnd();
 }
+function retireVerdictLines(retirement) {
+  const lines = [
+    `retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`,
+    `retire.reason: ${String(retirement.judgeReason)}`
+  ];
+  const continuityRisk = retirement.continuityRisk;
+  if (continuityRisk) {
+    const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
+    const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
+    const summary = [];
+    if (failingQueries > 0) {
+      summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
+    }
+    if (unverifiedQueries > 0) {
+      summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
+    }
+    lines.push(`retire.continuityRisk: ${summary.join("; ")} — excluded from bulk accept`);
+    const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
+    for (const rank of ranks) {
+      const successorRank = rank.successorRank === null || rank.successorRank === undefined ? "absent from top 10" : `#${String(rank.successorRank)}`;
+      lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
+    }
+  }
+  return lines;
+}
 function formatProposalShowPlain(r) {
   const p = r.proposal;
   const lines = [];
@@ -30458,29 +30498,17 @@ function formatProposalShowPlain(r) {
     if (review.decidedAt)
       lines.push(`review.decidedAt: ${String(review.decidedAt)}`);
   }
+  const history = Array.isArray(p.reviewHistory) ? p.reviewHistory : [];
+  for (const entry of history) {
+    const undone = entry.review;
+    const was = undone ? `${String(undone.outcome ?? "?")}${undone.reason ? `: ${String(undone.reason)}` : ""} (${String(undone.decidedAt ?? "?")})` : "an unrecorded review";
+    const why = entry.reopenReason ? ` (${String(entry.reopenReason)})` : "";
+    lines.push(`reopened: ${String(entry.reopenedAt)}${why}, undoing ${was}`);
+  }
   const retirement = p.retirement;
   if (retirement) {
     lines.push(`retire: ${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}`);
-    lines.push(`retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`);
-    lines.push(`retire.reason: ${String(retirement.judgeReason)}`);
-    const continuityRisk = retirement.continuityRisk;
-    if (continuityRisk) {
-      const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
-      const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
-      const summary = [];
-      if (failingQueries > 0) {
-        summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
-      }
-      if (unverifiedQueries > 0) {
-        summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
-      }
-      lines.push(`retire.continuityRisk: ${summary.join("; ")} — excluded from bulk accept`);
-      const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
-      for (const rank of ranks) {
-        const successorRank = rank.successorRank === null || rank.successorRank === undefined ? "absent from top 10" : `#${String(rank.successorRank)}`;
-        lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
-      }
-    }
+    lines.push(...retireVerdictLines(retirement));
   }
   const validation = r.validation;
   if (validation) {
@@ -30504,7 +30532,7 @@ function formatProposalShowPlain(r) {
     }
   }
   const payload = p.payload;
-  if (payload && typeof payload.content === "string") {
+  if (!retirement && payload && typeof payload.content === "string") {
     lines.push("");
     lines.push("payload:");
     lines.push(payload.content);
@@ -30519,6 +30547,19 @@ function formatProposalRejectPlain(r) {
   const reason = r.reason ? ` (${String(r.reason)})` : "";
   return `Rejected proposal ${String(r.id)} (${String(r.ref)})${reason}`;
 }
+function formatProposalReopenPlain(r) {
+  const reason = r.reason ? ` (${String(r.reason)})` : "";
+  return `Reopened proposal ${String(r.id)} (${String(r.ref)}) [pending]${reason}`;
+}
+function formatProposalReopenBatchPlain(r) {
+  const results = Array.isArray(r.results) ? r.results : [];
+  const reason = results[0]?.reason ? ` (${String(results[0].reason)})` : "";
+  return [
+    `Reopened ${results.length} proposal(s) [pending]${reason}`,
+    ...results.map((result) => `  ${String(result.id)}  ${String(result.ref)}`)
+  ].join(`
+`);
+}
 function formatProposalDrainPlain(r) {
   const applyMode = String(r.applyMode ?? "queue");
   const promoted = Array.isArray(r.promoted) ? r.promoted : [];
@@ -30548,8 +30589,21 @@ function formatProposalDrainPlain(r) {
 `).trimEnd();
 }
 function formatProposalDiffPlain(r) {
-  const header = r.isNew ? `# proposal ${String(r.id)} (new asset: ${String(r.ref)})` : `# proposal ${String(r.id)} (update: ${String(r.ref)})`;
   const unified = typeof r.unified === "string" ? r.unified : "";
+  if (r.op === "delete") {
+    const retirement = r.retirement;
+    const subject = retirement ? `${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}` : String(r.ref);
+    const lines = [`# proposal ${String(r.id)} (retire: ${subject})`];
+    if (retirement)
+      lines.push(...retireVerdictLines(retirement));
+    if (typeof r.note === "string")
+      lines.push(`note: ${r.note}`);
+    if (unified)
+      lines.push(unified);
+    return lines.join(`
+`);
+  }
+  const header = r.isNew ? `# proposal ${String(r.id)} (new asset: ${String(r.ref)})` : `# proposal ${String(r.id)} (update: ${String(r.ref)})`;
   if (!unified)
     return `${header}
 (no changes)`;
@@ -52915,6 +52969,8 @@ var proposalFormatters = [
   { command: "proposal-show", handler: (r) => formatProposalShowPlain(r) },
   { command: "proposal-accept", handler: (r) => formatProposalAcceptPlain(r) },
   { command: "proposal-reject", handler: (r) => formatProposalRejectPlain(r) },
+  { command: "proposal-reopen", handler: (r) => formatProposalReopenPlain(r) },
+  { command: "proposal-reopen-batch", handler: (r) => formatProposalReopenBatchPlain(r) },
   { command: "proposal-diff", handler: (r) => formatProposalDiffPlain(r) },
   { command: "proposal-drain", handler: (r) => formatProposalDrainPlain(r) }
 ];

package/dist/scripts/akm-migrate.js

@@ -27868,6 +27868,7 @@ function shapeProposalEntry(entry, detail) {
       "confidence",
       "gateDecision",
       "review",
+      "reviewHistory",
       "retirement"
     ]);
   }
@@ -27883,6 +27884,7 @@ function shapeProposalEntry(entry, detail) {
     "gateDecision",
     "payload",
     "review",
+    "reviewHistory",
     "retirement",
     "retiredArchive",
     "promotionSource",
@@ -27947,7 +27949,10 @@ function shapeProposalDiffOutput(result, detail) {
     ref: result.ref,
     isNew: result.isNew,
     unified: result.unified,
-    ...result.targetPath !== undefined ? { targetPath: result.targetPath } : {}
+    ...result.targetPath !== undefined ? { targetPath: result.targetPath } : {},
+    ...result.op !== undefined ? { op: result.op } : {},
+    ...result.retirement !== undefined ? { retirement: result.retirement } : {},
+    ...result.note !== undefined ? { note: result.note } : {}
   };
   if (detail === "full") {
     return { schemaVersion: result.schemaVersion, ...base };
@@ -28369,6 +28374,7 @@ var PASSTHROUGH_COMMANDS = [
   "proposal-accept-batch",
   "proposal-drain",
   "proposal-reject-batch",
+  "proposal-reopen-batch",
   "proposal-revert",
   "registry-add",
   "registry-list",
@@ -28440,6 +28446,14 @@ var proposalRejectShapes = [
   }
 ];
 
+// src/output/shapes/proposal/reopen.ts
+var proposalReopenShapes = [
+  {
+    command: "proposal-reopen",
+    handler: (result, detail) => shapeProposalRejectOutput(result, detail)
+  }
+];
+
 // src/output/shapes/proposal/show.ts
 var proposalShowShapes = [
   {
@@ -28530,6 +28544,7 @@ var BUILT_IN_OUTPUT_SHAPES = [
   ...proposalShowShapes,
   ...proposalAcceptShapes,
   ...proposalRejectShapes,
+  ...proposalReopenShapes,
   ...proposalDiffShapes,
   ...proposalProducerShapes,
   ...envListShapes,
@@ -29751,6 +29766,31 @@ Generate one with \`akm improve <ref>\` or \`akm proposal new <type> <name> --ta
   return lines.join(`
 `).trimEnd();
 }
+function retireVerdictLines(retirement) {
+  const lines = [
+    `retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`,
+    `retire.reason: ${String(retirement.judgeReason)}`
+  ];
+  const continuityRisk = retirement.continuityRisk;
+  if (continuityRisk) {
+    const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
+    const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
+    const summary = [];
+    if (failingQueries > 0) {
+      summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
+    }
+    if (unverifiedQueries > 0) {
+      summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
+    }
+    lines.push(`retire.continuityRisk: ${summary.join("; ")} \u2014 excluded from bulk accept`);
+    const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
+    for (const rank of ranks) {
+      const successorRank = rank.successorRank === null || rank.successorRank === undefined ? "absent from top 10" : `#${String(rank.successorRank)}`;
+      lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
+    }
+  }
+  return lines;
+}
 function formatProposalShowPlain(r) {
   const p = r.proposal;
   const lines = [];
@@ -29786,29 +29826,17 @@ function formatProposalShowPlain(r) {
     if (review.decidedAt)
       lines.push(`review.decidedAt: ${String(review.decidedAt)}`);
   }
+  const history = Array.isArray(p.reviewHistory) ? p.reviewHistory : [];
+  for (const entry of history) {
+    const undone = entry.review;
+    const was = undone ? `${String(undone.outcome ?? "?")}${undone.reason ? `: ${String(undone.reason)}` : ""} (${String(undone.decidedAt ?? "?")})` : "an unrecorded review";
+    const why = entry.reopenReason ? ` (${String(entry.reopenReason)})` : "";
+    lines.push(`reopened: ${String(entry.reopenedAt)}${why}, undoing ${was}`);
+  }
   const retirement = p.retirement;
   if (retirement) {
     lines.push(`retire: ${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}`);
-    lines.push(`retire.label: ${String(retirement.judgeLabel)} (cosine=${String(retirement.cosine)})`);
-    lines.push(`retire.reason: ${String(retirement.judgeReason)}`);
-    const continuityRisk = retirement.continuityRisk;
-    if (continuityRisk) {
-      const failingQueries = typeof continuityRisk.failingQueries === "number" ? continuityRisk.failingQueries : 0;
-      const unverifiedQueries = typeof continuityRisk.unverifiedQueries === "number" ? continuityRisk.unverifiedQueries : 0;
-      const summary = [];
-      if (failingQueries > 0) {
-        summary.push(`${failingQueries} of the retired asset's own quer${failingQueries === 1 ? "y" : "ies"} would not have found the successor top 10`);
-      }
-      if (unverifiedQueries > 0) {
-        summary.push(`${unverifiedQueries} quer${unverifiedQueries === 1 ? "y" : "ies"} unverified (search failed or used the keyword-only fallback)`);
-      }
-      lines.push(`retire.continuityRisk: ${summary.join("; ")} \u2014 excluded from bulk accept`);
-      const ranks = Array.isArray(continuityRisk.ranks) ? continuityRisk.ranks : [];
-      for (const rank of ranks) {
-        const successorRank = rank.successorRank === null || rank.successorRank === undefined ? "absent from top 10" : `#${String(rank.successorRank)}`;
-        lines.push(`  - "${String(rank.query)}": retired #${String(rank.retiredRank)}, successor ${successorRank}`);
-      }
-    }
+    lines.push(...retireVerdictLines(retirement));
   }
   const validation = r.validation;
   if (validation) {
@@ -29832,7 +29860,7 @@ function formatProposalShowPlain(r) {
     }
   }
   const payload = p.payload;
-  if (payload && typeof payload.content === "string") {
+  if (!retirement && payload && typeof payload.content === "string") {
     lines.push("");
     lines.push("payload:");
     lines.push(payload.content);
@@ -29847,6 +29875,19 @@ function formatProposalRejectPlain(r) {
   const reason = r.reason ? ` (${String(r.reason)})` : "";
   return `Rejected proposal ${String(r.id)} (${String(r.ref)})${reason}`;
 }
+function formatProposalReopenPlain(r) {
+  const reason = r.reason ? ` (${String(r.reason)})` : "";
+  return `Reopened proposal ${String(r.id)} (${String(r.ref)}) [pending]${reason}`;
+}
+function formatProposalReopenBatchPlain(r) {
+  const results = Array.isArray(r.results) ? r.results : [];
+  const reason = results[0]?.reason ? ` (${String(results[0].reason)})` : "";
+  return [
+    `Reopened ${results.length} proposal(s) [pending]${reason}`,
+    ...results.map((result) => `  ${String(result.id)}  ${String(result.ref)}`)
+  ].join(`
+`);
+}
 function formatProposalDrainPlain(r) {
   const applyMode = String(r.applyMode ?? "queue");
   const promoted = Array.isArray(r.promoted) ? r.promoted : [];
@@ -29876,8 +29917,21 @@ function formatProposalDrainPlain(r) {
 `).trimEnd();
 }
 function formatProposalDiffPlain(r) {
-  const header = r.isNew ? `# proposal ${String(r.id)} (new asset: ${String(r.ref)})` : `# proposal ${String(r.id)} (update: ${String(r.ref)})`;
   const unified = typeof r.unified === "string" ? r.unified : "";
+  if (r.op === "delete") {
+    const retirement = r.retirement;
+    const subject = retirement ? `${String(retirement.retiredRef)} -> ${String(retirement.successorRef)}` : String(r.ref);
+    const lines = [`# proposal ${String(r.id)} (retire: ${subject})`];
+    if (retirement)
+      lines.push(...retireVerdictLines(retirement));
+    if (typeof r.note === "string")
+      lines.push(`note: ${r.note}`);
+    if (unified)
+      lines.push(unified);
+    return lines.join(`
+`);
+  }
+  const header = r.isNew ? `# proposal ${String(r.id)} (new asset: ${String(r.ref)})` : `# proposal ${String(r.id)} (update: ${String(r.ref)})`;
   if (!unified)
     return `${header}
 (no changes)`;
@@ -52910,6 +52964,8 @@ var proposalFormatters = [
   { command: "proposal-show", handler: (r) => formatProposalShowPlain(r) },
   { command: "proposal-accept", handler: (r) => formatProposalAcceptPlain(r) },
   { command: "proposal-reject", handler: (r) => formatProposalRejectPlain(r) },
+  { command: "proposal-reopen", handler: (r) => formatProposalReopenPlain(r) },
+  { command: "proposal-reopen-batch", handler: (r) => formatProposalReopenBatchPlain(r) },
   { command: "proposal-diff", handler: (r) => formatProposalDiffPlain(r) },
   { command: "proposal-drain", handler: (r) => formatProposalDrainPlain(r) }
 ];