@warpgogol/forge 5.3.4 → 6.2.0

package/os/core/core.module.ts

@@ -6,16 +6,17 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-1089: rename forge.file-size.lint to file.size.lint (domain validator, no forge. prefix).</item>
-  <item>RFC-1097: step 6 — compass.migrate codemod run
+  <item>RFC-1230: docs.archive post-loop merges only RFCs moved this run (collectLiveMergeTargets on rfc.archive moved[] instead of a full-tree rescan); declared docs/specs/live/*.md in writes/reads.</item>
+  <item>RFC-1230: review findings — scoped droppedSections to namespaced headings, warn on unreadable spec, fail-fast merge on corrupt frontmatter, CHANGE_SUMMARY dedupe</item>
+  <item>RFC-1231: step 1 — rename supportsAllSites to acceptsAllFlag
 
-Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
-  <item>RFC-1097: sweep — packages/forge + services clean
-
-Sweep batch 2: real KEY_DECISIONS on 10 files, expanded purposes (CONTRACT-02/PURPOSE-02), headers on mission/index + gen-upstreams, sanitizeItemText in summary.record (literal Compass tags corrupted history), excludedPaths for wrangler types, test-fixtures testPattern. forge+services now 0 diagnostics under --mode error.</item>
-  <item>RFC-1173: declare mutatesState on all kernel commands — collectDeclarationDiagnostics emits error-severity MUTATES-STATE-DECLARED, command.manifest.validate is the blocking consumer in packages.check, sweep declares the flag on every command definition (factories hardcode false for read-only check specs)</item>
-  <item>RFC-1173: fixup: flip mutatesState to true on 19 commands that declare writes/generates — the codemod's name-suffix rules misclassified leitstand.dev-deploy, leitstand.certify, coverage.report and peers as read-only; declared writes imply mutation</item>
-  <history>ADR-0021, RFC-0374, RFC-0521, RFC-0539, RFC-0542, RFC-0543, RFC-0544, RFC-0546, RFC-0640, RFC-0662, RFC-0674, RFC-0678, RFC-0679, RFC-0680, RFC-0711, RFC-0733, RFC-0877, RFC-0940, RFC-1080, RFC-1088</history>
+Mechanical sweep: the field only ever gated --all argv acceptance; fan-out
+follows the parsed selector. Guard renamed assertAllSitesAllowed ->
+assertAllFlagAccepted, message updated. 417 declaration sites + type
+surfaces (KernelCommandMetadata, ForgeCommandMetadata) in one atomic pass.</item>
+  <item>RFC-1235: docs.archive post-loop records merge outcomes by exit code — exit-nonzero merges (incl. RFC-1230 fail-fast with populated data) land in failed[] with the merge summary as error, thrown errors record via liveMergeFailureEntry, and the spec.live.merge result block emits whenever anything was attempted; top-level result gains liveSpecFailures.</item>
+  <item>RFC-1248: VITE-CLIENT-DEP-02 lazy-import gate + SCAN-02 validator reads-root existence check (RFC-1248)</item>
+  <history>ADR-0021, RFC-0374, RFC-0521, RFC-0539, RFC-0542, RFC-0543, RFC-0544, RFC-0546, RFC-0640, RFC-0662, RFC-0674, RFC-0678, RFC-0679, RFC-0680, RFC-0711, RFC-0733, RFC-0877, RFC-0940, RFC-1080, RFC-1088, RFC-1089, RFC-1097, RFC-1173</history>
 </CHANGE_SUMMARY>
 */
 
@@ -218,7 +219,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         generates: [],
         description: "Diagnose forge state in an existing project.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           strict: {
             kind: "boolean",
@@ -234,10 +235,11 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.port.scaffold",
+        coverage: "operator" as const,
         mutatesState: true,
         description: "Generate a skeleton for a new forge skill or command.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           name: { kind: "string", description: "Skill or command name (kebab-case)." },
           type: { kind: "string", description: "Type: 'skill' or 'command' (default: skill)." },
@@ -253,30 +255,33 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "Validate all forge skills against frontmatter contract and invariants SKILL-01..SKILL-20.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {},
         reads: ["packages/forge/src/**/*.ts", "packages/forge/os/**/*.ts"],
         execute: skillValidateWrapper,
       },
       {
         name: "forge.skill.list",
+        coverage: "operator" as const,
         mutatesState: false,
         description: "List all registered forge skills.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {},
         reads: ["packages/forge/src/registry.ts"],
         execute: skillListWrapper,
       },
       {
         name: "forge.port.validate",
+        coverage: "operator" as const,
+        coverageNote: "requires --name",
         mutatesState: false,
         contract: "forge",
         rules: [],
         description:
           "Validate a single ported skill or command for compliance with forge contracts.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           name: { kind: "string", description: "Skill or command name to validate." },
         },
@@ -285,11 +290,12 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.agents.generate",
+        coverage: "operator" as const,
         mutatesState: true,
         description:
           "Regenerate AGENTS.md deterministically from forge.yaml and the skill registry.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {},
         writes: ["AGENTS.md", "**/AGENTS.md"],
         generates: [],
@@ -298,11 +304,13 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "memory.compact",
+        coverage: "operator" as const,
+        coverageNote: "agent memory compaction",
         mutatesState: true,
         description:
           "Enforce the MEMORY.md character budget by removing oldest Environment notes bullets (RFC-1151).",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {},
         cacheable: false,
         execute: runMemoryCompact,
@@ -313,7 +321,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "Additive sync for npm consumers: refresh .agents/skills/ from installed forge, add missing binding defaults, update forge.syncedVersion, run doctor.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -333,11 +341,12 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.scaffold",
+        coverage: "operator" as const,
         mutatesState: true,
         description:
           "Create a working pnpm + Turborepo monorepo from a stack profile in an empty directory. Required flags: `--profile`, `--name`.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           profile: {
             kind: "string",
@@ -360,7 +369,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "Create a forge project in-place: scaffold + init + binding defaults. The target directory must be empty (only .git/ tolerated). Usage: forge create --in-place --profile <profile-id> [--name <name>] [--package-manager pnpm]",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "in-place": {
             kind: "boolean",
@@ -396,7 +405,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "Deploy forge into a project: create forge.yaml, PREFERENCES.md, copy skills, create docs dirs. Hidden recovery command — normally called by forge.create.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         hidden: true,
         flags: {
           "ai-language": {
@@ -420,7 +429,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "Validate profile YAML files under packages/forge/profiles/ against the stack-profile schema (RFC-0640).",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           id: {
             kind: "string",
@@ -433,11 +442,12 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.dev",
+        coverage: "operator" as const,
         mutatesState: true,
         description:
           "Start the dev/preview server declared in the active stack profile. Use --dry-run to print the resolved command without executing.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         longRunning: true,
         flags: {
           "dry-run": {
@@ -455,11 +465,12 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.build",
+        coverage: "operator" as const,
         mutatesState: true,
         description:
           "Execute produce commands for all artifacts declared in the active stack profile. Use --dry-run to print resolved commands.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -476,13 +487,15 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.validate",
+        coverage: "operator" as const,
+        coverageNote: "artifact validator — typescript profile declares no artifacts by design",
         mutatesState: false,
         contract: "forge",
         rules: [],
         description:
           "Execute validate commands for all artifacts declared in the active stack profile. Use --dry-run to print resolved commands. Use --artifact to validate a single artifact.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -503,13 +516,15 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.determinism.check",
+        coverage: "operator" as const,
+        coverageNote: "forge determinism audit",
         mutatesState: true,
         contract: "forge",
         rules: [],
         description:
           "Verify artifact determinism by building twice and comparing output hashes. Reads determinism.inputs glob patterns from the active stack profile. Use --dry-run to print resolved inputs, --artifact to check a single artifact.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -524,19 +539,21 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
             description: "Check only the specified artifact id.",
           },
         },
-        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "dist/.determinism-cache.json"],
-        writes: ["dist/.determinism-cache.json"],
+        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "dist/.determinism-cache.json"], // scan-coverage: post-build artifact — dist/ exists only after forge build
+        writes: ["dist/.determinism-cache.json"], // scan-coverage: post-build artifact — dist/ exists only after forge build
         generates: [],
         cacheable: false,
         execute: runDeterminismCheck,
       },
       {
         name: "forge.assets.list",
+        coverage: "operator" as const,
+        coverageNote: "asset listing for asset-declaring forge profiles",
         mutatesState: false,
         description:
           "List all assets declared in the active stack profile, grouped by type. Use --dry-run to skip hashing, --type to filter by asset type.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -551,19 +568,21 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
             description: "Filter assets by type id (e.g. video, audio, image).",
           },
         },
-        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "assets/**"],
+        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "assets/**"], // scan-coverage: consumer-workshop root — assets/ declared by stack profiles
         cacheable: false,
         execute: runAssetsList,
       },
       {
         name: "forge.assets.check",
+        coverage: "operator" as const,
+        coverageNote: "asset check for asset-declaring forge profiles",
         mutatesState: false,
         contract: "forge",
         rules: [],
         description:
           "Check for missing, orphaned, and unreferenced assets. Use --strict to fail on orphaned assets, --dry-run to skip hashing.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -578,17 +597,19 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
             description: "Override the active profile id.",
           },
         },
-        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "assets/**"],
+        reads: ["forge.yaml", "packages/forge/profiles/*.yaml", "assets/**"], // scan-coverage: consumer-workshop root — assets/ declared by stack profiles
         cacheable: false,
         execute: runAssetsCheck,
       },
       {
         name: "forge.release.prepare",
+        coverage: "operator" as const,
+        coverageNote: "forge release front door",
         mutatesState: true,
         description:
           "Bundle built artifacts into a release package with a manifest. Use --dry-run to preview without writing.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -607,11 +628,13 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.release.publish",
+        coverage: "operator" as const,
+        coverageNote: "forge release publish step",
         mutatesState: true,
         description:
           "Publish a prepared release to the declared target (local, R2, S3). Use --dry-run to preview without uploading.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           "dry-run": {
             kind: "boolean",
@@ -630,12 +653,13 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "forge.skill.knowledge.compact",
+        coverage: "operator" as const,
         mutatesState: true,
         description:
           "Compact skill knowledge files: archive expired/superseded/aged L0 entries, mark stale L2 principles. " +
           "Usage: forge.skill.knowledge.compact --all-skills [--dry-run] [--json] | --skill <name> [--dry-run] [--json]",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         flags: {
           skill: {
             kind: "string",
@@ -677,6 +701,8 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "pinned.validate",
+        coverage: "operator" as const,
+        coverageNote: "pin-file hygiene",
         mutatesState: true,
         contract: "pinned",
         rules: [],
@@ -711,6 +737,8 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "pinned.init",
+        coverage: "operator" as const,
+        coverageNote: "pin-file bootstrap for mission pinning",
         description:
           "Initialize .forge/pinned.yaml with default foundation entries, " +
           "install pre-commit hook, and add audit log to .gitignore. " +
@@ -743,7 +771,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
           "and devDependencies completeness (no hoisted tool deps). " +
           "Exits non-zero on errors. Use --json for machine-readable output.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         reads: [
           "packages/*/package.json",
           "packages/*/.github/workflows/ci.yml",
@@ -768,7 +796,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
           "Enforces FORGE-AUTONOMY-01 (RFC-0940, DNA-64). @warpgogol/werkstatt-shared is exempt. " +
           "Type-only imports (import type) are exempt.",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         reads: ["packages/forge/os/**/*.ts"],
         cacheable: false,
         flags: {},
@@ -784,7 +812,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         contract: "forge",
         rules: ["SURFACE-01", "SURFACE-02", "SURFACE-03", "SURFACE-04", "SURFACE-05"],
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         reads: ["README.md", "package.json", "docs/**"],
         cacheable: false,
         flags: {},
@@ -798,7 +826,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
         description:
           "SIZE-01: flags a packages/** .ts/.tsx source file exceeding a 600-line threshold (warning 601-1200, error 1200+), against a shrink-only ratchet baseline. Pass --write-baseline to regenerate the baseline. Pass --baseline-path to override the default baseline location (RFC-1088).",
         scope: "workspace",
-        supportsAllSites: false,
+        acceptsAllFlag: false,
         reads: ["packages/*/src/**/*.ts", "packages/*/src/**/*.tsx"],
         writes: ["file-size-lint.baseline.yaml"],
         generates: [],
@@ -818,6 +846,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
       },
       {
         name: "docs.archive",
+        coverage: "operator" as const,
         description:
           "Umbrella command that runs rfc.archive, adr.archive, plan.archive, " +
           "audit.archive, session.archive, and mission.archive in sequence. " +
@@ -839,6 +868,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
           "docs/sessions/archive/**",
           "missions/*",
           "missions/archive/**",
+          "docs/specs/live/*.md",
         ],
         generates: [],
         reads: [
@@ -847,6 +877,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
           "docs/plans/**/*.md",
           "docs/audits/**/*.md",
           "docs/sessions/**/*.md",
+          "docs/specs/live/*.md",
           "missions/**",
         ],
         cacheable: false,
@@ -902,39 +933,78 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
             }
           }
 
-          // ── RFC-0711: post-loop spec.live.merge for implemented RFCs with liveSpec ──
-          const { listRfcFiles, readAndParseRfc } = await import("../rfc/frontmatter-io.ts");
+          // ── RFC-0711 + RFC-1230: post-loop spec.live.merge — only RFCs moved
+          // into archive/implemented/ this run. Re-scanning the whole tree on
+          // every invocation is what produced duplicate sections/history.
+          // Merge failure stays non-fatal; V-LS-08 detects any coverage gap. ──
+          const { readAndParseRfc } = await import("../rfc/frontmatter-io.ts");
           const { RFC_DIR } = await import("../rfc/types.ts");
           const { runSpecLiveMerge } = await import("../spec/live-spec-merge.ts");
+          const {
+            collectLiveMergeTargets,
+            classifyLiveMergeOutcome,
+            liveMergeFailureEntry,
+            formatLiveMergeFailure,
+            buildLiveMergeBlock,
+          } = await import("../spec/live-spec-shared.ts");
           const rfcDirPath = path.join(context.workspaceRoot, RFC_DIR);
-          const statusFilter = input.flags["status"] as string | undefined;
-          const allRfcFiles = await listRfcFiles(rfcDirPath);
+          const rfcArchiveData = results["rfc.archive"] as
+            | {
+                moved?: Array<{
+                  id: string;
+                  status: string;
+                  direction: string;
+                  from: string;
+                  to: string;
+                }>;
+              }
+            | undefined;
+          const thisRunMoved = Array.isArray(rfcArchiveData?.moved) ? rfcArchiveData.moved : [];
+          const movedById = new Map(thisRunMoved.map((m) => [m.id, m]));
+          const selection = collectLiveMergeTargets(thisRunMoved);
           const liveMergeResults: Array<{
             id: string;
             domain: string;
             operation: string;
             conflicts: number;
           }> = [];
+          // RFC-1235: exit-nonzero merges land in failed[] — merged[] must mean
+          // "the spec was written". Thrown and exit-1-with-data paths both record.
+          const liveMergeFailures: Array<{
+            id: string;
+            exitCode?: number;
+            error: string;
+          }> = [];
           let liveMergeSkipped = 0;
 
-          for (const rfcFile of allRfcFiles) {
-            const parsed = await readAndParseRfc(rfcDirPath, rfcFile);
-            if (!parsed || "error" in parsed) continue;
-            const fm = parsed.parsed.frontmatter;
-            const rfcStatus = String(fm["status"] ?? "").trim();
-            const liveSpec = fm["liveSpec"];
-            const rfcId = String(fm["id"] ?? "");
+          const parseMovedRfc = async (id: string) => {
+            const move = movedById.get(id);
+            if (!move) return undefined;
+            const rel = (p: string) =>
+              p.startsWith(`${RFC_DIR}/`) ? p.slice(RFC_DIR.length + 1) : p;
+            // Under --dry-run the file was not renamed — `to` does not exist yet,
+            // so fall back to `from` (the still-current location).
+            for (const candidate of [rel(move.to), rel(move.from)]) {
+              const parsed = await readAndParseRfc(rfcDirPath, candidate);
+              if (parsed && "parsed" in parsed) return parsed;
+            }
+            return undefined;
+          };
 
-            if (!liveSpec || rfcStatus !== "implemented") {
-              if (liveSpec && rfcStatus === "rejected") {
-                liveMergeSkipped++;
-                if (outputFormat === "pretty") {
-                  logger.info(`  spec.live.merge: skipping ${rfcId} (status: rejected)`);
-                }
+          for (const rfcId of selection.rejected) {
+            const parsed = await parseMovedRfc(rfcId);
+            if (parsed?.parsed.frontmatter["liveSpec"]) {
+              liveMergeSkipped++;
+              if (outputFormat === "pretty") {
+                logger.info(`  spec.live.merge: skipping ${rfcId} (status: rejected)`);
               }
-              continue;
             }
-            if (statusFilter && rfcStatus !== statusFilter) continue;
+          }
+
+          for (const rfcId of selection.candidates) {
+            const parsed = await parseMovedRfc(rfcId);
+            if (!parsed) continue;
+            if (!parsed.parsed.frontmatter["liveSpec"]) continue;
 
             try {
               const mergeInput: ForgeCommandInput = {
@@ -942,31 +1012,32 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
                 flags: { id: rfcId, "dry-run": dryRun },
               };
               const mergeResult = await runSpecLiveMerge(mergeInput, context);
-              const mergeData = mergeResult.data as
-                { domain?: string; operation?: string; conflicts?: unknown[] } | undefined;
-              if (mergeData) {
-                liveMergeResults.push({
-                  id: rfcId,
-                  domain: String(mergeData.domain ?? ""),
-                  operation: String(mergeData.operation ?? ""),
-                  conflicts: Array.isArray(mergeData.conflicts) ? mergeData.conflicts.length : 0,
-                });
+              const outcome = classifyLiveMergeOutcome(rfcId, mergeResult);
+              if (outcome.kind === "merged") {
+                liveMergeResults.push(outcome.entry);
+              } else {
+                liveMergeFailures.push(outcome.entry);
+                if (outputFormat === "pretty") {
+                  logger.error(`  ${formatLiveMergeFailure(outcome.entry)}`);
+                }
               }
             } catch (err) {
+              const failure = liveMergeFailureEntry(rfcId, err);
+              liveMergeFailures.push(failure);
               if (outputFormat === "pretty") {
-                logger.error(
-                  `  spec.live.merge: failed for ${rfcId}: ${String((err as Error).message)}`,
-                );
+                logger.error(`  ${formatLiveMergeFailure(failure)}`);
               }
             }
           }
 
-          if (liveMergeResults.length > 0 || liveMergeSkipped > 0) {
-            results["spec.live.merge"] = {
-              merged: liveMergeResults,
-              skipped: liveMergeSkipped,
-              dryRun,
-            };
+          const liveMergeBlock = buildLiveMergeBlock(
+            liveMergeResults,
+            liveMergeFailures,
+            liveMergeSkipped,
+            dryRun,
+          );
+          if (liveMergeBlock) {
+            results["spec.live.merge"] = liveMergeBlock;
             if (outputFormat === "pretty") {
               for (const r of liveMergeResults) {
                 logger.info(
@@ -1032,6 +1103,7 @@ export async function createForgeCoreModule(): Promise<ForgeModule> {
               dryRun,
               liveSpecMerges: liveMergeResults.length,
               liveSpecSkipped: liveMergeSkipped,
+              liveSpecFailures: liveMergeFailures.length,
             },
             summary: dryRun
               ? `[dry-run] Would move ${totalMoved} file(s), skip ${totalSkipped}`