akm-cli 0.9.16 → 0.9.17-alpha.10

package/dist/output/html-render.js

@@ -5,12 +5,14 @@
  * `--format html` rendering primitives (#582).
  *
  * Templates live in `src/assets/templates/html/` (mirrored to
- * `dist/assets/templates/html/` by `scripts/copy-assets.ts`). `--format html`
- * is health-only (chunk-9 WI-9.4c / Decision 4): `akm health` ships the sole
- * bespoke `<command>.html` template; every other command rejects `--format
- * html` with a `UsageError` before reaching this module (see
- * `src/cli/shared.ts`'s `output()`). Substitution is plain `%%TOKEN%%` string
- * replacement — no template engine, by design.
+ * `dist/assets/templates/html/` by `scripts/copy-assets.ts`). `akm health` is
+ * the only command with a bespoke `<command>.html` template (substituted here
+ * via plain `%%TOKEN%%` string replacement — no template engine, by design);
+ * `src/cli/shared.ts`'s `output()` calls it directly for `command === "health"`
+ * and every other command falls back to `renderGenericHtml` (`./generic-render`).
+ * `--format html` therefore works for every command (D7) — this module's
+ * template path is just health's opt-in bespoke rendering, not a format-wide
+ * gate.
  */
 import fs from "node:fs";
 import path from "node:path";
@@ -81,10 +83,11 @@ function readTemplate(templatePath) {
     }
 }
 /**
- * Minimal HTML entity escaping for text interpolated into templates. Escapes
- * the single quote as well as the double quote so escaped values are safe in
- * both `"…"` and `'…'` attribute contexts, not only the double-quoted
- * attributes the bundled templates use today.
+ * Minimal HTML entity escaping for text interpolated into a document — a
+ * template substitution here, or a value placed into `generic-render.ts`'s
+ * envelope rendering. Escapes the single quote as well as the double quote so
+ * escaped values are safe in both `"…"` and `'…'` attribute contexts, not only
+ * the double-quoted attributes the bundled templates use today.
  */
 export function escapeHtml(value) {
     return value

package/dist/output/render-registry.js

@@ -1,41 +1,12 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // 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/.
-/**
- * Per-command `md` / `html` renderer registries (D7).
- *
- * Mirrors `src/output/text/registry.ts`: a command may register a bespoke
- * renderer for a document format, and anything unregistered falls back to the
- * generic rendering of its shaped envelope (`./generic-render`). The fallback
- * is what makes all six `--format` values universal; the registry is what lets
- * a command that has something better to say — `akm health` and its report
- * templates — say it without the output pipeline knowing that command exists.
- *
- * Kept separate from the module that dispatches through it so per-command
- * renderer modules can import `registerMdRenderer` / `registerHtmlRenderer`
- * without a cycle back into the pipeline, exactly as the text registry does.
- *
- * Returning `null` from a handler means "I have nothing special for this
- * payload" and falls through to the generic renderer — `akm health` uses that
- * to keep its bespoke tables for the shapes that have them while still
- * rendering everything else.
- */
-import { createCommandRegistry } from "./command-registry.js";
-const MD_RENDERER_REGISTRY = createCommandRegistry();
-const HTML_RENDERER_REGISTRY = createCommandRegistry();
+const mdRenderers = new Map();
 /** Register a Markdown renderer for a command name. */
 export function registerMdRenderer(command, handler) {
-    MD_RENDERER_REGISTRY.register(command, handler);
+    mdRenderers.set(command, handler);
 }
 /** Look up a registered Markdown renderer, or `undefined` when unregistered. */
 export function getMdRendererHandler(command) {
-    return MD_RENDERER_REGISTRY.get(command);
-}
-/** Register an HTML renderer for a command name. */
-export function registerHtmlRenderer(command, handler) {
-    HTML_RENDERER_REGISTRY.register(command, handler);
-}
-/** Look up a registered HTML renderer, or `undefined` when unregistered. */
-export function getHtmlRendererHandler(command) {
-    return HTML_RENDERER_REGISTRY.get(command);
+    return mdRenderers.get(command);
 }

package/dist/output/shapes/helpers.js

@@ -56,11 +56,25 @@ export function shapeProposalProducerOutput(result, detail) {
 }
 export function shapeProposalEntry(entry, detail) {
     if (detail === "brief") {
-        return pickFields(entry, ["id", "ref", "status", "source", "createdAt"]);
+        // `proposal list`'s default detail level IS "brief" (no `--detail` flag
+        // given projects here, not "normal") — `retirement` itself is not
+        // projected until "normal", so a flagged retire proposal's risk would
+        // otherwise be invisible by default. A minimal boolean marker, not the
+        // full risk object, keeps brief's shape small while still letting a
+        // reviewer see it without an extra flag.
+        const retirement = entry.retirement;
+        return {
+            ...pickFields(entry, ["id", "ref", "status", "source", "createdAt"]),
+            ...(retirement?.continuityRisk ? { continuityRisk: true } : {}),
+        };
     }
     if (detail === "normal") {
         // `confidence` and `gateDecision` (#577) explain why a proposal is pending,
         // so they are projected at `normal` for `akm proposal list/show` when present.
+        // `retirement` (alpha.9) is the same kind of field for a consolidate
+        // `retire` proposal: without it, "list/show" carries no reason a reviewer
+        // could act on (its `payload.content` is empty by design — a retire
+        // proposal deletes, it does not write).
         return pickFields(entry, [
             "id",
             "ref",
@@ -72,6 +86,7 @@ export function shapeProposalEntry(entry, detail) {
             "confidence",
             "gateDecision",
             "review",
+            "retirement",
         ]);
     }
     // full: project everything including the payload.
@@ -87,6 +102,10 @@ export function shapeProposalEntry(entry, detail) {
         "gateDecision",
         "payload",
         "review",
+        "retirement",
+        "retiredArchive",
+        "promotionSource",
+        "promotionSourceHash",
     ]);
 }
 export function shapeProposalListOutput(result, detail) {
@@ -284,40 +303,14 @@ export function shapeSearchHit(hit, detail) {
     // `ref` is included at `brief` so agents can run `akm show <ref>` without
     // needing --detail full or --shape agent (REC-03).
     if (detail === "brief") {
-        return pickFields(hit, [
-            "type",
-            "name",
-            "ref",
-            "action",
-            "estimatedTokens",
-            "keys",
-            "selectedRef",
-            "parentRef",
-            "fragmentOrdinal",
-            "fragmentCount",
-            "parentEstimatedTokens",
-        ]);
+        return pickFields(hit, ["type", "name", "ref", "action", "estimatedTokens", "keys"]);
     }
     if (detail === "normal") {
         // `warnings` is projected at `normal` so non-fatal hit-level issues are
         // visible without forcing callers up to `--detail full`. Optional
         // `quality` (v1 spec §4.2) is also surfaced when present so callers
         // can see why a `proposed` entry showed up under `--include-proposed`.
-        // `matchStage` (issue #856) surfaces which stage of the progressive
-        // AND->OR lexical ladder produced the hit; cheap compact enum, worth
-        // showing without requiring `--detail full`.
-        const shaped = capDescription(pickFields(hit, [
-            "type",
-            "name",
-            "description",
-            "action",
-            "score",
-            "estimatedTokens",
-            "warnings",
-            "quality",
-            "matchStage",
-            ...FRAGMENT_PROVENANCE_FIELDS,
-        ]), NORMAL_DESCRIPTION_LIMIT);
+        const shaped = capDescription(pickFields(hit, ["type", "name", "description", "action", "score", "estimatedTokens", "warnings", "quality"]), NORMAL_DESCRIPTION_LIMIT);
         if (Array.isArray(hit.keys) && hit.keys.length > 0)
             shaped.keys = hit.keys;
         return shaped;
@@ -338,12 +331,6 @@ export function shapeSearchHitForAgent(hit) {
         "score",
         "estimatedTokens",
         "keys",
-        // Issue #856: which stage of the progressive AND->OR lexical ladder
-        // produced this hit. Agents need this to gauge how much to trust a
-        // hit (a strict-AND match is stronger signal than an OR-fallback
-        // recovery match) without going to `--detail full`.
-        "matchStage",
-        ...FRAGMENT_PROVENANCE_FIELDS,
     ]);
     if (picked.editable !== false)
         delete picked.editHint;
@@ -389,7 +376,7 @@ export function shapeShowOutput(result, detail, shape = "human") {
             "workflowParameters",
             "steps",
             "keys",
-            "related",
+            "links",
             ...FRAGMENT_PROVENANCE_FIELDS,
             ...FRAGMENT_CONTEXT_FIELDS,
         ]);
@@ -413,7 +400,7 @@ export function shapeShowOutput(result, detail, shape = "human") {
             "run",
             "origin",
             "keys",
-            "related",
+            "links",
             ...FRAGMENT_PROVENANCE_FIELDS,
             ...FRAGMENT_CONTEXT_FIELDS,
         ]);
@@ -442,7 +429,7 @@ export function shapeShowOutput(result, detail, shape = "human") {
         "cwd",
         "activeRun",
         "keys",
-        "related",
+        "links",
         ...FRAGMENT_PROVENANCE_FIELDS,
         ...FRAGMENT_CONTEXT_FIELDS,
         // ref, path, and editable are always projected — at every --detail level,

package/dist/output/shapes/passthrough.js

@@ -8,15 +8,6 @@
 // envelope. Never overwrites an existing `shape`, `schemaVersion`, or `ok`;
 // a command whose exit code grades the outcome emits through
 // `outputWithExitCode` (src/cli/shared.ts), which sets `ok` from that code.
-//
-// Builds a shallow copy rather than mutating `result` in place: several
-// command results (e.g. `akm task sync --dry-run`'s `SchedulerPlanPreview`,
-// see src/tasks/scheduler-sync-preview.ts) are deliberately `Object.freeze`d
-// by their producer as an immutability guarantee, and an in-place `obj.shape
-// = …` assignment throws ("Attempting to define property on object that is
-// not extensible") the moment it hits one. Copying tolerates both frozen and
-// mutable inputs uniformly, and `output()` never uses the result's identity
-// past this call, so a copy is safe here.
 function makeStampHandler(command) {
     return (result) => {
         if (result === null || result === undefined)
@@ -39,6 +30,7 @@ const PASSTHROUGH_COMMANDS = [
     "add",
     "agent-result",
     "bundle-create",
+    "bundle-rename",
     "bundle-show",
     "clone",
     "command-dry-run",

package/dist/{indexer/graph/graph-types.js → output/text/bundle-rename.js}

@@ -1,4 +1,7 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // 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/.
-export {};
+import { formatBundleRenamePlain } from "./helpers.js";
+export const bundleRenameFormatters = [
+    { command: "bundle-rename", handler: (r) => formatBundleRenamePlain(r) },
+];

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

@@ -20,11 +20,20 @@ export function formatInfoPlain(r) {
     const lines = [];
     if (r.version)
         lines.push(`version: ${String(r.version)}`);
+    // Only present in infoCommand's own last-resort fallback (stash-cli.ts),
+    // when assembleInfo() itself threw — every field below it belongs to the
+    // normal shape and is absent there.
+    if (typeof r.error === "string")
+        lines.push(`error: ${r.error}`);
     if (r.bundleDir)
         lines.push(`bundleDir: ${String(r.bundleDir)}`);
     if (r.defaultBundle !== undefined) {
         lines.push(`defaultBundle: ${r.defaultBundle === null ? "(none)" : String(r.defaultBundle)}`);
     }
+    if (typeof r.configError === "string")
+        lines.push(`configError: ${r.configError}`);
+    if (typeof r.bundleDirError === "string")
+        lines.push(`bundleDirError: ${r.bundleDirError}`);
     if (Array.isArray(r.assetTypes) && r.assetTypes.length > 0) {
         lines.push(`assetTypes: ${r.assetTypes.join(", ")}`);
     }
@@ -270,32 +279,10 @@ export function formatSearchPlain(r, detail) {
         // Optional v1 spec §4.2 quality marker (e.g. "curated" / "proposed").
         if (typeof hit.quality === "string" && hit.quality)
             lines.push(`  quality: ${hit.quality}`);
-        // Issue #856: which stage of the progressive AND->OR lexical ladder
-        // produced this hit ("exact" | "prefix" | "relaxed").
-        if (typeof hit.matchStage === "string" && hit.matchStage)
-            lines.push(`  matchStage: ${hit.matchStage}`);
         // Surface optional hit-level warnings (v1 spec §4.2).
         if (Array.isArray(hit.warnings) && hit.warnings.length > 0) {
             lines.push(`  warnings: ${hit.warnings.join("; ")}`);
         }
-        const graph = typeof hit.graph === "object" && hit.graph !== null ? hit.graph : undefined;
-        if (graph) {
-            const entities = Array.isArray(graph.entities) ? graph.entities : [];
-            if (entities.length > 0) {
-                const matched = entities
-                    .filter((entity) => String(entity.kind ?? "") === "matched")
-                    .map((entity) => String(entity.name ?? "?"));
-                const neighbors = entities
-                    .filter((entity) => String(entity.kind ?? "") !== "matched")
-                    .map((entity) => String(entity.name ?? "?"));
-                lines.push(`  graph: ${[
-                    matched.length > 0 ? `query match=${matched.join(", ")}` : undefined,
-                    neighbors.length > 0 ? `neighbors=${neighbors.join(", ")}` : undefined,
-                ]
-                    .filter(Boolean)
-                    .join("; ")}`);
-            }
-        }
         if (detail === "full") {
             if (hit.path)
                 lines.push(`  path: ${String(hit.path)}`);
@@ -429,14 +416,6 @@ export function formatIndexPlain(r) {
         for (const message of warnings)
             out += `\n  - ${String(message)}`;
     }
-    const notices = Array.isArray(indexResult.notices) ? indexResult.notices : [];
-    for (const notice of notices) {
-        const severity = notice.severity === "info" ? "info" : "warning";
-        const field = typeof notice.field === "string" ? ` field=${notice.field}` : "";
-        out +=
-            `\n  notice[${severity}] ${notice.code} adapter=${notice.adapter}${field}` +
-                (notice.message ? `: ${notice.message}` : "");
-    }
     const verification = indexResult.verification;
     if (verification?.ok === false && verification.message) {
         out += `\nVerification: ${String(verification.message)}`;
@@ -556,7 +535,8 @@ export function formatAddPlain(r) {
     const index = r.index;
     const scanned = index?.directoriesScanned ?? 0;
     const total = index?.totalEntries ?? 0;
-    const lines = [`Installed ${r.ref} (${scanned} directories scanned, ${total} total assets indexed)`];
+    const bundleSuffix = typeof r.bundleId === "string" && r.bundleId.length > 0 ? ` as bundle "${r.bundleId}"` : "";
+    const lines = [`Installed ${r.ref}${bundleSuffix} (${scanned} directories scanned, ${total} total assets indexed)`];
     const warnings = index?.warnings;
     if (Array.isArray(warnings) && warnings.length > 0) {
         lines.push(`Warnings (${warnings.length}):`);
@@ -589,6 +569,64 @@ export function formatRemovePlain(r) {
     const ok = r.ok !== false ? "OK" : "FAILED";
     return `remove: ${target} ${ok}`;
 }
+export function formatBundleRenamePlain(r) {
+    const oldId = String(r.oldId ?? "?");
+    const newId = String(r.newId ?? "?");
+    const applied = r.applied === true;
+    const config = r.config ?? {};
+    const state = r.state ?? {};
+    const index = r.index ?? {};
+    const schedulerRefs = Array.isArray(config.schedulerRefs) ? config.schedulerRefs.length : 0;
+    const proposalRefs = Number(state.proposalRefs ?? 0);
+    const proposalTargets = Number(state.proposalTargets ?? 0);
+    const taskHistoryRefs = Number(state.taskHistoryRefs ?? 0);
+    const entries = Number(index.entries ?? 0);
+    const contentRefs = Array.isArray(r.contentRefs) ? r.contentRefs : [];
+    const nativeSchedulerRows = Array.isArray(r.nativeSchedulerRows) ? r.nativeSchedulerRows : [];
+    const verb = applied ? "Renamed" : "Would rename";
+    const lines = [
+        `${verb} bundle "${oldId}" to "${newId}" (${entries} index entries, ${schedulerRefs} scheduler ref(s), ` +
+            `${proposalRefs + proposalTargets} proposal reference(s), ${taskHistoryRefs} task-history row(s)).`,
+    ];
+    if (!applied) {
+        lines.push("Re-run without --dry-run to apply. It also re-syncs native scheduler bindings under the new name.");
+        if (nativeSchedulerRows.length > 0) {
+            lines.push(`Native scheduler rows naming "${oldId}//" that the sync would replace:`);
+            for (const row of nativeSchedulerRows)
+                lines.push(`  - ${String(row)}`);
+        }
+    }
+    else {
+        const taskSync = r.taskSync;
+        const syncResult = taskSync?.result;
+        if (syncResult) {
+            const installed = Array.isArray(syncResult.installed) ? syncResult.installed.length : 0;
+            const updated = Array.isArray(syncResult.updated) ? syncResult.updated.length : 0;
+            const removed = Array.isArray(syncResult.removed) ? syncResult.removed.length : 0;
+            const failures = Array.isArray(syncResult.failures)
+                ? syncResult.failures
+                : [];
+            if (failures.length === 0) {
+                lines.push(`Native scheduler bindings re-synced under the new name (${installed} installed, ${updated} updated, ${removed} removed).`);
+            }
+            else {
+                lines.push(`Native scheduler sync after rename: ${installed} installed, ${updated} updated, ${removed} removed, ${failures.length} failed.`);
+                for (const failure of failures)
+                    lines.push(`  - ${failure.ref ?? failure.path}: ${failure.reason}`);
+                lines.push("Run `akm task sync` to retry.");
+            }
+        }
+        else if (taskSync?.ok === false && taskSync.error) {
+            lines.push(`Re-syncing native scheduler bindings failed: ${taskSync.error}. Run \`akm task sync\` to retry.`);
+        }
+    }
+    if (contentRefs.length > 0) {
+        lines.push(`Content still spelling "${oldId}//" (not rewritten — edit these by hand):`);
+        for (const file of contentRefs)
+            lines.push(`  - ${String(file)}`);
+    }
+    return lines.join("\n");
+}
 export function formatUpdatePlain(r) {
     // R-015: `processed` alone conflated three cases into one empty array —
     // a true no-op (--all with nothing configured), a source this call flatly

package/dist/output/text/helpers.js

@@ -15,7 +15,7 @@
  *
  * No registry imports — no circular dependencies.
  */
-export { formatAddPlain, 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 { 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";

package/dist/output/text/migrate.js

@@ -18,27 +18,18 @@ export function formatMigratePlain(result) {
     if (typeof plan.status !== "string")
         return null;
     const lines = [`${planGlyph(plan.status)} ${plan.status}`];
-    if (plan.taskV3Migration) {
-        const tasks = plan.taskV3Migration;
-        lines.push(`    task-v2->v3: ${tasks.changed} change, ${tasks.skipped} current, ${tasks.blocked} blocked`);
-    }
-    if (plan.taskV4Migration) {
-        const tasks = plan.taskV4Migration;
-        lines.push(`    task-v3->v4: ${tasks.changed} change, ${tasks.skipped} current, ${tasks.blocked} blocked`);
+    if (plan.taskFiles) {
+        const tasks = plan.taskFiles;
+        lines.push(`    task files: ${tasks.changed} change, ${tasks.skipped} current, ${tasks.blocked} blocked`);
     }
     if (plan.blockers?.length) {
         lines.push("", "blockers:", ...plan.blockers.map((blocker) => `  - ${blocker}`));
     }
     if (plan.backupPath) {
-        lines.push("", `backup (v2->v3): ${plan.backupPath}`);
+        lines.push("", `backup: ${plan.backupPath}`);
     }
     if (plan.applied !== undefined)
-        lines.push(`applied (v2->v3): ${plan.applied}`);
-    if (plan.taskV4BackupPath) {
-        lines.push(`backup (v3->v4): ${plan.taskV4BackupPath}`);
-    }
-    if (plan.taskV4Applied !== undefined)
-        lines.push(`applied (v3->v4): ${plan.taskV4Applied}`);
+        lines.push(`applied: ${plan.applied}`);
     return lines.join("\n");
 }
 export const migrateFormatters = [

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

@@ -100,7 +100,16 @@ export function formatProposalListPlain(r) {
         // #577: surface the gate verdict inline so the queue explains itself.
         const gate = formatGateDecisionSummary(p.gateDecision);
         const gateSuffix = gate ? `  ${gate}` : "";
-        lines.push(`${id}  [${status}] ${ref}  source=${source}  ${created}${gateSuffix}`);
+        // A retire proposal's continuityRisk excludes it from bulk accept —
+        // visible in the default list, not just `proposal show`, since the owner
+        // reviews the backlog list-first. `list`'s default (brief) shape
+        // projects a `continuityRisk: true` marker instead of the full
+        // `retirement` object (only present from `--detail normal` up), so both
+        // shapes are checked here.
+        const retirement = p.retirement;
+        const flagged = p.continuityRisk === true || Boolean(retirement?.continuityRisk);
+        const continuitySuffix = flagged ? "  ⚠ continuity-risk" : "";
+        lines.push(`${id}  [${status}] ${ref}  source=${source}  ${created}${gateSuffix}${continuitySuffix}`);
     }
     return lines.join("\n").trimEnd();
 }
@@ -141,6 +150,43 @@ export function formatProposalShowPlain(r) {
         if (review.decidedAt)
             lines.push(`review.decidedAt: ${String(review.decidedAt)}`);
     }
+    // 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}`);
+            }
+        }
+    }
     const validation = r.validation;
     if (validation) {
         const findings = Array.isArray(validation.findings) ? validation.findings : [];
@@ -184,7 +230,6 @@ export function formatProposalRejectPlain(r) {
     return `Rejected proposal ${String(r.id)} (${String(r.ref)})${reason}`;
 }
 export function formatProposalDrainPlain(r) {
-    const policy = String(r.policy ?? "?");
     const applyMode = String(r.applyMode ?? "queue");
     const promoted = Array.isArray(r.promoted) ? r.promoted : [];
     const rejected = Array.isArray(r.rejected) ? r.rejected : [];
@@ -194,7 +239,7 @@ export function formatProposalDrainPlain(r) {
     const failed = Array.isArray(r.failed) ? r.failed : [];
     const prefix = r.dryRun === true ? "[dry-run] " : "";
     const lines = [
-        `${prefix}Drained proposal queue (strategy=${String(r.strategy ?? "?")}, policy=${policy}, applyMode=${applyMode})`,
+        `${prefix}Drained proposal queue (strategy=${String(r.strategy ?? "?")}, applyMode=${applyMode})`,
         `  promoted: ${promoted.length}`,
         `  rejected: ${rejected.length}`,
         `  deferred: ${deferred.length}`,

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

@@ -54,17 +54,20 @@ export function formatShowPlain(r, detail) {
         if (r.schemaVersion !== undefined)
             lines.push(`schemaVersion: ${String(r.schemaVersion)}`);
     }
-    const related = typeof r.related === "object" && r.related !== null ? r.related : undefined;
-    const relatedHits = related && Array.isArray(related.hits) ? related.hits : [];
-    if (related) {
+    const links = typeof r.links === "object" && r.links !== null ? r.links : undefined;
+    if (links) {
         lines.push("");
-        lines.push(`related: ${String(related.total ?? relatedHits.length)}`);
-        for (const hit of relatedHits) {
-            lines.push(`  - ${String(hit.type ?? "?")}: ${formatRelatedLabel(hit)}`);
-            const shared = Array.isArray(hit.sharedEntities) ? hit.sharedEntities.map(String) : [];
-            if (shared.length > 0)
-                lines.push(`    shared: ${shared.join(", ")}`);
-            lines.push(`    relationCount: ${String(hit.relationCount ?? 0)}`);
+        lines.push("links:");
+        for (const part of ["outgoing", "incoming", "unresolved"]) {
+            const groups = links[part];
+            if (typeof groups !== "object" || groups === null)
+                continue;
+            lines.push(`  ${part}:`);
+            for (const [kind, group] of Object.entries(groups)) {
+                const refs = Array.isArray(group.refs) ? group.refs.map(String) : [];
+                const more = (group.total ?? refs.length) > refs.length ? ` (+${(group.total ?? 0) - refs.length} more)` : "";
+                lines.push(`    ${kind}: ${refs.join(", ")}${more}`);
+            }
         }
     }
     const payloads = [r.content, r.template, r.prompt].filter((value) => value != null).map(String);
@@ -98,10 +101,3 @@ export function formatShowPlain(r, detail) {
     appendShowDirectives(lines, r);
     return lines.length > 0 ? lines.join("\n") : null;
 }
-function formatRelatedLabel(hit) {
-    const ref = typeof hit.ref === "string" ? hit.ref : undefined;
-    if (ref)
-        return ref;
-    const pathValue = typeof hit.path === "string" ? hit.path : "?";
-    return pathValue.split("/").pop() ?? pathValue;
-}

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

@@ -108,13 +108,6 @@ export function formatWorkflowStatusPlain(result) {
             const attempts = typeof unit.attempts === "number" ? unit.attempts : undefined;
             const suffix = attempts !== undefined && attempts > 1 ? `, attempt ${attempts}` : "";
             lines.push(`  - ${id} [${node}] (${status}${suffix})`);
-            // Codex round-3 finding B: a `running` claim gone silent past the check-in
-            // window — the process holding it likely died. Surface it (with the claim
-            // holder) so a human can reclaim/re-run the unit.
-            if (unit.stale === true) {
-                const holder = typeof unit.claimHolder === "string" && unit.claimHolder.trim() ? ` claimed by ${unit.claimHolder}` : "";
-                lines.push(`    stale: claim went silent past the check-in window${holder} — its driver may have died`);
-            }
             if (typeof unit.failureReason === "string" && unit.failureReason.trim()) {
                 lines.push(`    failure_reason: ${unit.failureReason}`);
             }
@@ -126,27 +119,8 @@ export function formatWorkflowStatusPlain(result) {
             }
         }
     }
-    // Review C2: the check-in `continue` directive must survive plain-text
-    // rendering — JSON consumers saw `checkin` but the text path dropped it.
-    const checkinLine = formatWorkflowCheckinLine(result);
-    if (checkinLine) {
-        lines.push("");
-        lines.push(checkinLine);
-    }
     return lines.join("\n");
 }
-/**
- * Render the stalled-run check-in directive (#506) when present on a
- * workflow-status result. Returns null when the run is healthy.
- */
-function formatWorkflowCheckinLine(result) {
-    const checkin = typeof result.checkin === "object" && result.checkin !== null
-        ? result.checkin
-        : undefined;
-    if (!checkin || typeof checkin.directive !== "string" || !checkin.directive.trim())
-        return null;
-    return checkin.directive.trim();
-}
 /**
  * One `! lowering[<severity>] <code> (<adapter>[; <field>]): <message>` line
  * from a `{code, severity, adapter, field?, message}` lowering notice, or
@@ -346,12 +320,6 @@ export function formatWorkflowPlanPlain(result) {
     for (const [index, step] of steps.entries()) {
         renderPlanStepLines(step, index + 1, lines);
     }
-    const sourceReadSet = Array.isArray(result.sourceReadSet) ? result.sourceReadSet : [];
-    if (sourceReadSet.length > 0) {
-        lines.push("read set:");
-        for (const entry of sourceReadSet)
-            lines.push(`  ${String(entry)}`);
-    }
     const notices = Array.isArray(result.notices) ? result.notices : [];
     if (notices.length > 0) {
         lines.push("notices:");

package/dist/output/text.js

@@ -4,6 +4,7 @@
 import { writeStdout } from "./stdout.js";
 import { addFormatters } from "./text/add.js";
 import { bundleCreateFormatters } from "./text/bundle-create.js";
+import { bundleRenameFormatters } from "./text/bundle-rename.js";
 import { bundleShowFormatters } from "./text/bundle-show.js";
 import { cloneFormatters } from "./text/clone.js";
 import { configFormatters } from "./text/config.js";
@@ -40,6 +41,7 @@ import { workflowFormatters } from "./text/workflow.js";
 // compile instead of silently disappearing at runtime.
 const BUILT_IN_TEXT_FORMATTERS = [
     ...bundleCreateFormatters,
+    ...bundleRenameFormatters,
     ...bundleShowFormatters,
     ...indexFormatters,
     ...showFormatters,