@topogram/cli 0.3.70 → 0.3.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/cli",
-  "version": "0.3.70",
+  "version": "0.3.72",
   "description": "Topogram CLI for checking Topogram workspaces and generating app bundles.",
   "license": "Apache-2.0",
   "repository": {

package/src/agent-brief.js

@@ -28,7 +28,7 @@ import { DEFAULT_TOPO_FOLDER_NAME, resolveTopoRoot, resolveWorkspaceContext } fr
  * @typedef {{ path: string, ownership: string, rule: string }} AgentBriefOutputBoundary
  * @typedef {{ id: string, title: string, commands: string[], rule: string }} AgentBriefWorkflow
  * @typedef {{ id: string, kind: string, projection: string|null, generator: string|null, uses_api: string|null, uses_database: string|null }} AgentBriefRuntime
- * @typedef {{ path: string, source: string|null, tracks: string[], candidateCounts: Record<string, any>, ownership: string|null }} AgentBriefImport
+ * @typedef {{ path: string, workspaceRoot: string, source: string|null, tracks: string[], candidateCounts: Record<string, any>, ownership: string|null }} AgentBriefImport
  * @typedef {{ ok: true, payload: Record<string, any> } | { ok: false, kind: "topogram", validation: any } | { ok: false, kind: "project", validation: any, configPath: string }} AgentBriefResult
  */
 
@@ -137,6 +137,7 @@ function readImportSummary(projectRoot) {
     const record = JSON.parse(fs.readFileSync(importPath, "utf8"));
     return {
       path: TOPOGRAM_IMPORT_FILE,
+      workspaceRoot: resolveTopoRoot(projectRoot),
       source: typeof record?.source?.path === "string" ? record.source.path : null,
       tracks: Array.isArray(record?.import?.tracks) ? record.import.tracks.map(String) : [],
       candidateCounts: record?.import?.candidateCounts && typeof record.import.candidateCounts === "object"
@@ -147,6 +148,7 @@ function readImportSummary(projectRoot) {
   } catch (error) {
     return {
       path: TOPOGRAM_IMPORT_FILE,
+      workspaceRoot: resolveTopoRoot(projectRoot),
       source: null,
       tracks: [],
       candidateCounts: {},
@@ -215,13 +217,13 @@ function buildWorkflows(config, hasImportRecord) {
       id: "brownfield-import",
       title: "Brownfield import adoption loop",
       commands: [
-        "topogram import check .",
-        "topogram import plan .",
-        "topogram import adopt --list .",
-        "topogram import status .",
-        "topogram import history . --verify"
+        "topogram import check . --json",
+        "topogram import plan . --json",
+        "topogram import adopt --list . --json",
+        "topogram import status . --json",
+        "topogram import history . --verify --json"
       ],
-      rule: "Imported Topogram files are editable after adoption; source hashes record trusted import evidence."
+      rule: "Imported Topogram files are editable after adoption; JSON automation should read workspaceRoot for the project-owned workspace path."
     });
   }
   return workflows;
@@ -338,10 +340,11 @@ export function buildAgentBrief(inputPath, workspaceAst) {
     commandItem("npm run generate", "Write generated-owned runtime/app outputs after validation.", "write"),
     commandItem("npm run verify", "Run generated output verification.", "verify"),
     ...(importSummary ? [
-      commandItem("topogram import check .", "Validate imported workspace provenance.", "import"),
-      commandItem("topogram import plan .", "Review import adoption plan.", "import"),
-      commandItem("topogram import adopt --list .", "List reviewable adoption selectors.", "import"),
-      commandItem("topogram import history . --verify", "Verify import history evidence.", "import")
+      commandItem("topogram import check . --json", "Validate imported workspace provenance and read workspaceRoot.", "import"),
+      commandItem("topogram import plan . --json", "Review import adoption plan and workspaceRoot.", "import"),
+      commandItem("topogram import adopt --list . --json", "List reviewable adoption selectors.", "import"),
+      commandItem("topogram import status . --json", "Check import/adoption status.", "import"),
+      commandItem("topogram import history . --verify --json", "Verify import history evidence.", "import")
     ] : [])
   ];
 
@@ -461,6 +464,12 @@ export function formatAgentBrief(brief) {
   for (const workflow of brief.workflows || []) {
     lines.push(`  - ${workflow.title}: ${workflow.rule}`);
   }
+  if (brief.import?.workspaceRoot) {
+    lines.push("");
+    lines.push("Import:");
+    lines.push(`  - Workspace root: ${brief.import.workspaceRoot}`);
+    lines.push("  - JSON import commands expose workspaceRoot; prefer it over compatibility fields.");
+  }
   lines.push("");
   lines.push("Verification gates:");
   lines.push("  - npm run check");

package/src/cli/command-parsers/project.js

@@ -43,8 +43,5 @@ export function parseProjectCommandArgs(args) {
   if (args[0] === "package" && args[1] === "update-cli") {
     return { packageCommand: "update-cli", inputPath: args.includes("--latest") ? "latest" : args[2] };
   }
-  if (args[0] === "migrate" && args[1] === "workspace-folder") {
-    return { migrateCommand: "workspace-folder", inputPath: commandPath(args, 2, ".") };
-  }
   return null;
 }

package/src/cli/commands/import/adopt.js

@@ -50,6 +50,7 @@ export function buildImportAdoptionReceipt({ artifacts, selector, options, impor
       version: readInstalledCliPackageVersion()
     },
     projectRoot: artifacts.projectRoot,
+    workspaceRoot: artifacts.topogramRoot,
     topogramRoot: artifacts.topogramRoot,
     selector,
     mode: "write",
@@ -114,6 +115,7 @@ export function buildBrownfieldImportAdoptPayload(selector, inputPath, options =
   return {
     ok: true,
     projectRoot: artifacts.projectRoot,
+    workspaceRoot: artifacts.topogramRoot,
     topogramRoot: artifacts.topogramRoot,
     selector,
     dryRun: !options.write,

package/src/cli/commands/import/check.js

@@ -12,7 +12,8 @@ import { buildTopogramImportStatus } from "../../../import/provenance.js";
 import {
   checkSummaryPayload,
   combineProjectValidationResults,
-  normalizeProjectRoot
+  normalizeProjectRoot,
+  normalizeTopogramPath
 } from "./paths.js";
 
 /**
@@ -39,7 +40,7 @@ export function buildTopogramCheckPayloadForPath(inputPath) {
 
 /**
  * @param {string} projectRoot
- * @returns {{ ok: boolean, projectRoot: string, import: ReturnType<typeof buildTopogramImportStatus>, topogram: ReturnType<typeof buildTopogramCheckPayloadForPath>, errors: any[] }}
+ * @returns {{ ok: boolean, projectRoot: string, workspaceRoot: string, import: ReturnType<typeof buildTopogramImportStatus>, topogram: ReturnType<typeof buildTopogramCheckPayloadForPath>, errors: any[] }}
  */
 export function buildBrownfieldImportCheckPayload(projectRoot) {
   const resolvedRoot = normalizeProjectRoot(projectRoot);
@@ -48,6 +49,7 @@ export function buildBrownfieldImportCheckPayload(projectRoot) {
   return {
     ok: importStatus.ok && topogramCheck.ok,
     projectRoot: resolvedRoot,
+    workspaceRoot: normalizeTopogramPath(resolvedRoot),
     import: importStatus,
     topogram: topogramCheck,
     errors: [

package/src/cli/commands/import/diff.js

@@ -17,6 +17,7 @@ export function buildBrownfieldImportDiffPayload(inputPath, options = {}) {
   return {
     ok: true,
     projectRoot: analysis.projectRoot,
+    workspaceRoot: analysis.topogramRoot,
     topogramRoot: analysis.topogramRoot,
     sourcePath: analysis.sourcePath,
     provenancePath: analysis.provenancePath,

package/src/cli/commands/import/plan.js

@@ -191,6 +191,7 @@ export function buildBrownfieldImportPlanPayload(inputPath) {
   return {
     ok: true,
     projectRoot: artifacts.projectRoot,
+    workspaceRoot: artifacts.topogramRoot,
     topogramRoot: artifacts.topogramRoot,
     artifacts: {
       adoptionPlan: artifacts.paths.adoptionPlanAgent,
@@ -254,6 +255,7 @@ export function buildBrownfieldImportAdoptListPayload(inputPath) {
   return {
     ok: true,
     projectRoot: plan.projectRoot,
+    workspaceRoot: plan.topogramRoot,
     topogramRoot: plan.topogramRoot,
     selectorCount: selectors.length,
     selectors,

package/src/cli/commands/import/refresh.js

@@ -354,7 +354,7 @@ export function buildBrownfieldImportRefreshAnalysis(inputPath, options = {}) {
 /**
  * @param {string} inputPath
  * @param {{ sourcePath?: string|null, dryRun?: boolean }} [options]
- * @returns {{ ok: boolean, dryRun: boolean, projectRoot: string, topogramRoot: string, sourcePath: string, provenancePath: string, previousImportStatus: string, currentImportStatus: string, tracks: string[], sourceFiles: number, sourceDiff: Record<string, any>, removedCandidateFiles: Record<string, number>, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], plannedFiles: string[], candidateCounts: Record<string, number>, candidateCountDeltas: Record<string, any>, adoptionPlanDeltas: Record<string, any>, receiptVerification: Record<string, any>, refreshMetadata: Record<string, any>|null, nextCommands: string[] }}
+ * @returns {{ ok: boolean, dryRun: boolean, projectRoot: string, workspaceRoot: string, topogramRoot: string, sourcePath: string, provenancePath: string, previousImportStatus: string, currentImportStatus: string, tracks: string[], sourceFiles: number, sourceDiff: Record<string, any>, removedCandidateFiles: Record<string, number>, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], plannedFiles: string[], candidateCounts: Record<string, number>, candidateCountDeltas: Record<string, any>, adoptionPlanDeltas: Record<string, any>, receiptVerification: Record<string, any>, refreshMetadata: Record<string, any>|null, nextCommands: string[] }}
  */
 export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
   const analysis = buildBrownfieldImportRefreshAnalysis(inputPath, options);
@@ -405,6 +405,7 @@ export function buildBrownfieldImportRefreshPayload(inputPath, options = {}) {
     ok: dryRun || currentImportStatus === "clean",
     dryRun,
     projectRoot: analysis.projectRoot,
+    workspaceRoot: analysis.topogramRoot,
     topogramRoot: analysis.topogramRoot,
     sourcePath: analysis.sourcePath,
     provenancePath,

package/src/cli/commands/import/status-history.js

@@ -31,6 +31,7 @@ export function buildBrownfieldImportStatusPayload(inputPath) {
   return {
     ok: importCheck.ok,
     projectRoot: artifacts.projectRoot,
+    workspaceRoot: artifacts.topogramRoot,
     topogramRoot: artifacts.topogramRoot,
     import: importCheck.import,
     topogram: importCheck.topogram,
@@ -144,6 +145,7 @@ export function verifyImportAdoptionReceipts(projectRoot, receipts) {
  */
 export function buildBrownfieldImportHistoryPayload(inputPath, options = {}) {
   const projectRoot = normalizeProjectRoot(inputPath);
+  const workspaceRoot = normalizeTopogramPath(projectRoot);
   const historyPath = importAdoptionsPath(projectRoot);
   const receipts = readImportAdoptionReceipts(projectRoot);
   const forcedWrites = receipts.filter((receipt) => receipt.forced);
@@ -151,6 +153,7 @@ export function buildBrownfieldImportHistoryPayload(inputPath, options = {}) {
   return {
     ok: true,
     projectRoot,
+    workspaceRoot,
     path: historyPath,
     exists: fs.existsSync(historyPath),
     verified: Boolean(options.verify),
@@ -162,7 +165,8 @@ export function buildBrownfieldImportHistoryPayload(inputPath, options = {}) {
       lastSelector: receipts[receipts.length - 1]?.selector || null
     },
     verification,
-    receipts
+    receipts,
+    entries: receipts
   };
 }
 

package/src/cli/commands/import/workspace.js

@@ -145,7 +145,7 @@ export function countFilesRecursive(rootPath) {
  * @param {string} sourcePath
  * @param {string} targetPath
  * @param {{ from?: string|null }} [options]
- * @returns {{ ok: boolean, sourcePath: string, targetPath: string, topogramRoot: string, projectConfigPath: string, provenancePath: string, tracks: string[], sourceFiles: number, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], candidateCounts: Record<string, number>, nextCommands: string[] }}
+ * @returns {{ ok: boolean, sourcePath: string, targetPath: string, workspaceRoot: string, topogramRoot: string, projectConfigPath: string, provenancePath: string, tracks: string[], sourceFiles: number, rawCandidateFiles: number, reconcileFiles: number, writtenFiles: string[], candidateCounts: Record<string, number>, nextCommands: string[] }}
  */
 export function buildBrownfieldImportWorkspacePayload(sourcePath, targetPath, options = {}) {
   const sourceRoot = path.resolve(sourcePath);
@@ -190,6 +190,7 @@ export function buildBrownfieldImportWorkspacePayload(sourcePath, targetPath, op
     ok: true,
     sourcePath: sourceRoot,
     targetPath: targetRoot,
+    workspaceRoot: topogramRoot,
     topogramRoot,
     projectConfigPath,
     provenancePath: provenance.path,

package/src/cli/dispatcher.js

@@ -10,7 +10,6 @@ import { runGenerateAppCommand } from "./commands/generate.js";
 import { runGeneratorCommand } from "./commands/generator.js";
 import { runGeneratorPolicyCommand } from "./commands/generator-policy.js";
 import { runImportCommand } from "./commands/import-runner.js";
-import { runMigrateCommand } from "./commands/migrate.js";
 import { runNewProjectCommand } from "./commands/new.js";
 import { runPackageCommand } from "./commands/package.js";
 import { runParseCommand, runResolveCommand } from "./commands/inspect.js";
@@ -242,10 +241,6 @@ export async function runCliDispatch(context) {
     return runPackageCommand({ commandArgs, inputPath, json: emitJson });
   }
 
-  if (commandArgs?.migrateCommand) {
-    return runMigrateCommand(inputPath, { write: shouldWrite, json: emitJson });
-  }
-
   if (commandArgs?.importCommand) {
     return runImportCommand({
       commandArgs,

package/src/cli/help.js

@@ -28,7 +28,6 @@ export function printUsage(options = {}) {
   console.log("   or: topogram catalog doctor [--json] [--catalog <path-or-source>]");
   console.log("   or: topogram catalog check <path-or-url> [--json]");
   console.log("   or: topogram catalog copy <id> <target> [--version <version>] [--json] [--catalog <path-or-source>]");
-  console.log("   or: topogram migrate workspace-folder [path] [--dry-run|--write] [--json]");
   console.log("   or: topogram package update-cli <version|--latest> [--json]");
   console.log("   or: topogram import <app-path> --out <target> [--from <track[,track]>] [--json]");
   console.log("   or: topogram import refresh [path] [--from <app-path>] [--dry-run] [--json]");

package/src/cli/migration-guidance.js

@@ -30,6 +30,9 @@ export function cliMigrationError(args) {
   if (args[0] === "component") {
     return "Command 'topogram component' was renamed to 'topogram widget'.";
   }
+  if (args[0] === "migrate") {
+    return "Command 'topogram migrate workspace-folder' was removed. Use topo/ workspaces or configure topogram.project.json workspace to a non-legacy relative path.";
+  }
   for (const [oldArg, newArg] of RENAMED_CLI_ARGS) {
     if (args.includes(oldArg)) {
       return `CLI flag '${oldArg}' was renamed to '${newArg}'.`;

package/src/generator/surfaces/databases/lifecycle-shared.js

@@ -209,8 +209,8 @@ discover_input_path() {
   )
   local candidate
   for candidate in "\${candidates[@]}"; do
-    if resolved="$(resolve_path_candidate "$candidate" "$PWD")" && [[ -d "$resolved/topogram" ]]; then
-      printf '%s\\n' "$resolved/topogram"
+    if resolved="$(resolve_path_candidate "$candidate" "$PWD")" && [[ -d "$resolved/topo" ]]; then
+      printf '%s\\n' "$resolved/topo"
       return
     fi
   done

package/src/new-project/project-files.js

@@ -335,7 +335,8 @@ npm run query:show -- widget-behavior
 ${hasImplementation ? "- This project has executable `implementation/` code. `topogram new` did not execute it. Do not refresh trust until the implementation has been reviewed.\n" : "- This template does not declare executable implementation code.\n"}
 ## Import And Adoption
 
-- If \`.topogram-import.json\` exists, run \`topogram import check .\`, \`topogram import plan .\`, \`topogram import adopt --list .\`, and \`topogram import history . --verify\`.
+- If \`.topogram-import.json\` exists, agents should run \`topogram import check . --json\`, \`topogram import plan . --json\`, \`topogram import adopt --list . --json\`, \`topogram import status . --json\`, and \`topogram import history . --verify --json\`.
+- Import JSON payloads expose \`workspaceRoot\`; prefer it as the canonical project-owned workspace path.
 - Imported Topogram files are project-owned after adoption; source hashes record trusted import evidence at the time of import.
 
 ## Verification Gates

package/src/workspace-paths.js

@@ -4,10 +4,10 @@ import fs from "node:fs";
 import path from "node:path";
 
 export const DEFAULT_TOPO_FOLDER_NAME = "topo";
-export const LEGACY_TOPOGRAM_FOLDER_NAME = "topogram";
 export const DEFAULT_WORKSPACE_PATH = `./${DEFAULT_TOPO_FOLDER_NAME}`;
 export const PROJECT_CONFIG_FILE = "topogram.project.json";
 
+const LEGACY_WORKSPACE_FOLDER_NAME = "topogram";
 const SIGNAL_SCAN_IGNORED_DIRS = new Set([
   ".git",
   ".next",
@@ -19,6 +19,7 @@ const SIGNAL_SCAN_IGNORED_DIRS = new Set([
   "coverage",
   "dist",
   "expected",
+  LEGACY_WORKSPACE_FOLDER_NAME,
   "node_modules",
   "tmp"
 ]);
@@ -128,6 +129,9 @@ export function normalizeWorkspaceConfigPath(workspacePath) {
   if (resolved === ".." || resolved.startsWith("../")) {
     throw new Error("topogram.project.json workspace must not escape the project root.");
   }
+  if (resolved === LEGACY_WORKSPACE_FOLDER_NAME || resolved.startsWith(`${LEGACY_WORKSPACE_FOLDER_NAME}/`)) {
+    throw new Error("topogram.project.json workspace must use ./topo or another non-legacy relative path.");
+  }
   return normalized;
 }
 
@@ -225,6 +229,9 @@ function signalWorkspaceCandidates(root) {
  */
 export function resolveWorkspaceContext(inputPath = ".") {
   const absolute = path.resolve(inputPath || ".");
+  if (isDirectory(absolute) && path.basename(absolute) === LEGACY_WORKSPACE_FOLDER_NAME && isWorkspaceSignalRoot(absolute)) {
+    throw new Error("Legacy workspace folders are not supported. Use topo/ or configure topogram.project.json workspace to a non-legacy relative path.");
+  }
   if (
     isDirectory(absolute) &&
     (

package/src/cli/commands/migrate.js

@@ -1,153 +0,0 @@
-// @ts-check
-
-import fs from "node:fs";
-import path from "node:path";
-
-import { stableStringify } from "../../format.js";
-import {
-  DEFAULT_TOPO_FOLDER_NAME,
-  DEFAULT_WORKSPACE_PATH,
-  LEGACY_TOPOGRAM_FOLDER_NAME,
-  PROJECT_CONFIG_FILE
-} from "../../workspace-paths.js";
-
-/**
- * @param {string|null|undefined} inputPath
- * @returns {string}
- */
-function projectRootForMigration(inputPath) {
-  const absolute = path.resolve(inputPath || ".");
-  const base = path.basename(absolute);
-  if (base === DEFAULT_TOPO_FOLDER_NAME || base === LEGACY_TOPOGRAM_FOLDER_NAME) {
-    return path.dirname(absolute);
-  }
-  return absolute;
-}
-
-/**
- * @param {string} projectRoot
- * @returns {string[]}
- */
-function caseCollisionEntries(projectRoot) {
-  if (!fs.existsSync(projectRoot) || !fs.statSync(projectRoot).isDirectory()) {
-    return [];
-  }
-  return fs.readdirSync(projectRoot)
-    .filter((/** @type {string} */ entry) => entry.toLowerCase() === DEFAULT_TOPO_FOLDER_NAME && entry !== DEFAULT_TOPO_FOLDER_NAME);
-}
-
-/**
- * @param {string} projectRoot
- * @returns {{ write: boolean, path: string|null, before: any|null, after: any|null }}
- */
-function plannedProjectConfigUpdate(projectRoot) {
-  const configPath = path.join(projectRoot, PROJECT_CONFIG_FILE);
-  if (!fs.existsSync(configPath)) {
-    return { write: false, path: null, before: null, after: null };
-  }
-  const before = JSON.parse(fs.readFileSync(configPath, "utf8"));
-  const after = { ...before };
-  const currentWorkspace = before.workspace;
-  if (currentWorkspace == null || currentWorkspace === "./topogram" || currentWorkspace === "topogram") {
-    after.workspace = DEFAULT_WORKSPACE_PATH;
-  }
-  return {
-    write: JSON.stringify(before) !== JSON.stringify(after),
-    path: configPath,
-    before,
-    after
-  };
-}
-
-/**
- * @param {string|null|undefined} inputPath
- * @param {{ write?: boolean, json?: boolean }} [options]
- * @returns {number}
- */
-export function runMigrateCommand(inputPath, options = {}) {
-  const projectRoot = projectRootForMigration(inputPath);
-  const legacyPath = path.join(projectRoot, LEGACY_TOPOGRAM_FOLDER_NAME);
-  const topoPath = path.join(projectRoot, DEFAULT_TOPO_FOLDER_NAME);
-  const write = Boolean(options.write);
-  /** @type {Array<Record<string, any>>} */
-  const diagnostics = [];
-  /** @type {Array<Record<string, any>>} */
-  const actions = [];
-
-  if (fs.existsSync(legacyPath) && fs.lstatSync(legacyPath).isSymbolicLink()) {
-    diagnostics.push({ severity: "error", message: `Refusing to migrate symlinked ${LEGACY_TOPOGRAM_FOLDER_NAME}/ at ${legacyPath}.` });
-  }
-  const collisions = caseCollisionEntries(projectRoot);
-  if (collisions.length > 0) {
-    diagnostics.push({ severity: "error", message: `Refusing to migrate because case-conflicting topo path(s) exist: ${collisions.join(", ")}.` });
-  }
-  if (fs.existsSync(legacyPath) && fs.existsSync(topoPath)) {
-    diagnostics.push({ severity: "error", message: `Refusing to migrate because both ${LEGACY_TOPOGRAM_FOLDER_NAME}/ and ${DEFAULT_TOPO_FOLDER_NAME}/ exist.` });
-  }
-  if (!fs.existsSync(legacyPath) && !fs.existsSync(topoPath)) {
-    diagnostics.push({ severity: "error", message: `No ${LEGACY_TOPOGRAM_FOLDER_NAME}/ or ${DEFAULT_TOPO_FOLDER_NAME}/ workspace folder found at ${projectRoot}.` });
-  }
-  if (fs.existsSync(topoPath) && fs.statSync(topoPath).isDirectory() && fs.readdirSync(topoPath).length > 0 && fs.existsSync(legacyPath)) {
-    diagnostics.push({ severity: "error", message: `Refusing to overwrite non-empty ${DEFAULT_TOPO_FOLDER_NAME}/ at ${topoPath}.` });
-  }
-
-  if (fs.existsSync(legacyPath) && diagnostics.length === 0) {
-    actions.push({
-      kind: "rename",
-      from: legacyPath,
-      to: topoPath
-    });
-  }
-  const configUpdate = plannedProjectConfigUpdate(projectRoot);
-  if (configUpdate.write) {
-    actions.push({
-      kind: "update_config",
-      path: configUpdate.path,
-      workspace: DEFAULT_WORKSPACE_PATH
-    });
-  }
-
-  const ok = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length === 0;
-  if (ok && write) {
-    for (const action of actions) {
-      if (action.kind === "rename") {
-        fs.renameSync(action.from, action.to);
-      }
-      if (action.kind === "update_config" && configUpdate.path && configUpdate.after) {
-        fs.writeFileSync(configUpdate.path, `${JSON.stringify(configUpdate.after, null, 2)}\n`, "utf8");
-      }
-    }
-  }
-
-  const payload = {
-    ok,
-    dryRun: !write,
-    projectRoot,
-    legacyPath,
-    topoPath,
-    actions,
-    diagnostics,
-    errors: diagnostics.filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => diagnostic.message)
-  };
-  if (options.json) {
-    console.log(stableStringify(payload));
-  } else if (payload.ok) {
-    console.log(write ? "Workspace folder migration complete." : "Workspace folder migration dry run.");
-    if (actions.length === 0) {
-      console.log("No changes needed.");
-    }
-    for (const action of actions) {
-      if (action.kind === "rename") {
-        console.log(`Rename: ${action.from} -> ${action.to}`);
-      }
-      if (action.kind === "update_config") {
-        console.log(`Update ${action.path}: workspace ${DEFAULT_WORKSPACE_PATH}`);
-      }
-    }
-  } else {
-    for (const error of payload.errors) {
-      console.error(error);
-    }
-  }
-  return payload.ok ? 0 : 1;
-}