mancode 0.3.11 → 0.3.13

package/dist/cli.js

@@ -2,6 +2,25 @@
 import {
   VERSION
 } from "./chunk-57PJQDQ3.js";
+import {
+  DEFAULT_MANCODE_END_MARKER,
+  DEFAULT_MANCODE_START_MARKER,
+  V3_ADAPTER_FILE_TARGETS,
+  V3_ADAPTER_VERSION,
+  applyV3AdapterFilePlan,
+  assertV3AdapterInstallable,
+  assertV3AdapterTargetSafe,
+  hasManagedBlock,
+  inspectV3Adapter,
+  inspectV3AdapterVersions,
+  installV3Adapter,
+  planV3AdapterFiles,
+  removeManagedBlock,
+  removeV3Adapter,
+  replaceManagedBlock,
+  stageV3Adapter,
+  v3AdapterTargetPath
+} from "./chunk-L3TKSX6R.js";
 import {
   PROJECT_MANIFESTS,
   V3ContextStore,
@@ -105,25 +124,9 @@ import {
   writeOperationReservation,
   writeProjectFacts
 } from "./chunk-O3QAKAPJ.js";
-import {
-  DEFAULT_MANCODE_END_MARKER,
-  DEFAULT_MANCODE_START_MARKER,
-  V3_ADAPTER_VERSION,
-  applyV3AdapterFilePlan,
-  hasManagedBlock,
-  inspectV3Adapter,
-  inspectV3AdapterVersions,
-  installV3Adapter,
-  planV3AdapterFiles,
-  removeManagedBlock,
-  removeV3Adapter,
-  replaceManagedBlock,
-  stageV3Adapter,
-  v3AdapterTargetPath
-} from "./chunk-WAH4E2N2.js";
 
 // src/cli.ts
-import { program } from "commander";
+import { Option, program } from "commander";
 
 // src/context/publish-promote.ts
 import { lstat as lstat5, mkdir as mkdir11, rename as rename5, rm as rm5, writeFile as writeFile11 } from "fs/promises";
@@ -1442,12 +1445,9 @@ function parseMigrationStageFileAction(value) {
     targetContent
   };
 }
-var V3_ADAPTER_TARGETS = /* @__PURE__ */ new Set([
-  "claude-skill",
-  "cursor-rule",
-  "agents",
-  "copilot-instructions"
-]);
+var V3_ADAPTER_TARGETS = new Set(
+  V3_ADAPTER_FILE_TARGETS
+);
 function parseV3AdapterFileAction(value) {
   assertKnownKeys(
     value,
@@ -1459,23 +1459,27 @@ function parseV3AdapterFileAction(value) {
       "beforeContent",
       "targetContent"
     ],
-    "operation recovery V3 adapter action"
+    "operation recovery mancode adapter action"
   );
   if (value.kind !== "v3_adapter_file" || !V3_ADAPTER_TARGETS.has(value.target)) {
-    throw new Error("operation recovery V3 adapter action is invalid");
+    throw new Error("operation recovery mancode adapter action is invalid");
   }
   const target = value.target;
-  const beforeContent = value.beforeContent === null ? null : parseText(value.beforeContent, "V3 adapter beforeContent");
+  const beforeContent = value.beforeContent === null ? null : parseText(value.beforeContent, "mancode adapter beforeContent");
   const beforeDigest = parseDigestOrNull(value.beforeDigest, "beforeDigest");
   if (beforeDigest !== adapterFileContentDigest(target, beforeContent)) {
-    throw new Error("operation recovery V3 adapter before digest is invalid");
+    throw new Error(
+      "operation recovery mancode adapter before digest is invalid"
+    );
   }
   const targetContent = parseText(
     value.targetContent,
-    "V3 adapter targetContent"
+    "mancode adapter targetContent"
   );
   if (!targetContent.trim()) {
-    throw new Error("operation recovery V3 adapter target content is invalid");
+    throw new Error(
+      "operation recovery mancode adapter target content is invalid"
+    );
   }
   adapterFileContentDigest(target, targetContent);
   return {
@@ -5168,7 +5172,7 @@ function parseQuarantineCandidate(value) {
 function assertSourcePlacement(purpose, sourceTaskRef, candidateTaskRef) {
   if (purpose === "legacy_migration" && sourceTaskRef !== null) {
     throw new Error(
-      "legacy migration quarantine cannot claim a V3 source TaskRef"
+      "legacy migration quarantine cannot claim a current mancode source TaskRef"
     );
   }
   if (purpose === "publish_promote") {
@@ -11499,7 +11503,7 @@ async function activateLegacyMigration(input) {
       for (const action of payload.actions.filter(
         (action2) => action2.kind === "v3_adapter_file"
       )) {
-        const { applyV3AdapterFilePlan: applyV3AdapterFilePlan2 } = await import("./v3-adapter-HA7VR5VL.js");
+        const { applyV3AdapterFilePlan: applyV3AdapterFilePlan2 } = await import("./v3-adapter-CPZNFTJR.js");
         await applyV3AdapterFilePlan2(root, action);
       }
       journal = await completeActivationStep(
@@ -11645,6 +11649,7 @@ async function rollbackLegacyMigration(input) {
       );
       await rm7(target, { force: false });
     } else if (action.kind === "v3_adapter_file") {
+      await assertV3AdapterTargetSafe(root, action.target);
       const target = v3AdapterTargetPath(root, action.target);
       if (action.beforeContent === null) {
         await rm7(target, { force: false });
@@ -11942,6 +11947,7 @@ async function assertActivationRollbackProof(projectRoot, localStore, coordinati
         throw new Error("MANCODE_MIGRATION_ROLLBACK_FORBIDDEN");
       }
     } else if (action.kind === "v3_adapter_file") {
+      await assertV3AdapterTargetSafe(projectRoot, action.target);
       const current = await readTextOrNull(
         v3AdapterTargetPath(projectRoot, action.target)
       );
@@ -14214,6 +14220,7 @@ async function readMigrationStageFile(projectRoot, stageId) {
   ]);
 }
 async function readAdapterFile(projectRoot, target) {
+  await assertV3AdapterTargetSafe(projectRoot, target);
   const filePath = v3AdapterTargetPath(projectRoot, target);
   try {
     const entry = await lstat9(filePath);
@@ -19832,7 +19839,7 @@ async function contextBeta(rootDir, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_BETA_GATE_FAILED"),
-      error instanceof Error ? error.message : "Unable to evaluate Beta readiness."
+      error instanceof Error ? error.message : "Unable to evaluate release readiness."
     );
   }
 }
@@ -19950,7 +19957,7 @@ async function contextWorktreeRegister(rootDir, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_WORKTREE_REGISTER_FAILED"),
-      error instanceof Error ? error.message : "Unable to register this worktree for V3 coordination."
+      error instanceof Error ? error.message : "Unable to register this worktree for mancode coordination."
     );
   }
 }
@@ -20095,7 +20102,7 @@ async function contextCompact(rootDir, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_CONTEXT_COMPACT_FAILED"),
-      error instanceof Error ? error.message : "Unable to compact V3 context."
+      error instanceof Error ? error.message : "Unable to compact mancode context."
     );
   }
 }
@@ -20148,7 +20155,7 @@ async function contextPublish(rootDir, task, options) {
       return printV3Error(
         options.json,
         v3ErrorCode(error, "MANCODE_CONTEXT_PUBLISH_FAILED"),
-        error instanceof Error ? error.message : "Unable to preview the local V3 task publish."
+        error instanceof Error ? error.message : "Unable to preview the local mancode task publish."
       );
     }
   }
@@ -20178,7 +20185,7 @@ async function contextPublish(rootDir, task, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_CONTEXT_PUBLISH_FAILED"),
-      error instanceof Error ? error.message : "Unable to publish the local V3 task."
+      error instanceof Error ? error.message : "Unable to publish the local mancode task."
     );
   }
 }
@@ -20248,7 +20255,7 @@ async function contextReconcileTaskHead(rootDir, task, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_CONTEXT_RECONCILE_TASK_HEAD_FAILED"),
-      error instanceof Error ? error.message : "Unable to reconcile the V3 task head."
+      error instanceof Error ? error.message : "Unable to reconcile the mancode task head."
     );
   }
 }
@@ -24762,9 +24769,20 @@ var EXIT_NOT_A_PROJECT_DIR = 2;
 var EXIT_USER_CANCEL = 3;
 var EXIT_INIT_FAILED = 5;
 var DEFAULT_INIT_PLATFORM = "claude-code";
+function resolveInitAuthority(options) {
+  if (options.legacy) return "legacy";
+  if (options.v3 || options.fromCli) return "v3";
+  return "legacy";
+}
 async function init(rootDir = process5.cwd(), options = {}) {
+  if (options.v3 && options.legacy) {
+    console.error("\u2717  --v3 and --legacy cannot be used together.");
+    return EXIT_INIT_FAILED;
+  }
+  const authority = resolveInitAuthority(options);
   const mancodeDir = path46.join(rootDir, ".mancode");
   const stateFile = path46.join(mancodeDir, "state.json");
+  const v3SchemaFile = path46.join(mancodeDir, "schema.json");
   const wasInitialized = await pathExists6(stateFile);
   let mutationSnapshots = [];
   let directorySnapshots = [];
@@ -24774,7 +24792,16 @@ async function init(rootDir = process5.cwd(), options = {}) {
     console.error("   Supported values: zh-CN, en");
     return EXIT_INIT_FAILED;
   }
-  if (wasInitialized && !options.v3) {
+  if (authority === "legacy" && await pathExists6(v3SchemaFile)) {
+    console.error(
+      "\u2717  mancode authority is already present; refusing to create legacy state.json."
+    );
+    console.error(
+      "   Use `mancode status` or `mancode install <platform>` to inspect or repair this project."
+    );
+    return EXIT_INIT_FAILED;
+  }
+  if (wasInitialized && authority === "legacy") {
     if (!options.force) {
       console.log(
         localize(
@@ -24811,7 +24838,16 @@ async function init(rootDir = process5.cwd(), options = {}) {
     );
     return EXIT_NOT_A_PROJECT_DIR;
   }
-  if (options.v3) {
+  if (authority === "v3") {
+    if (options.fromCli) {
+      const projectBoundaryExit = await validateV3CliProjectBoundary(
+        rootDir,
+        options,
+        locale,
+        wasInitialized
+      );
+      if (projectBoundaryExit !== null) return projectBoundaryExit;
+    }
     return initializeV3(rootDir, options);
   }
   const isGitRepo = await pathExists6(path46.join(rootDir, ".git"));
@@ -25184,17 +25220,73 @@ async function init(rootDir = process5.cwd(), options = {}) {
 async function initializeV3(rootDir, options) {
   if (options.force) {
     console.error(
-      "\u2717  --force is not supported for journaled V3 initialization."
+      "\u2717  --force is not supported for journaled mancode initialization."
     );
     return EXIT_INIT_FAILED;
   }
-  const selectedPlatforms = options.platform === void 0 ? [] : parsePlatformSelection(options.platform);
+  if (options.style !== void 0) {
+    console.error("\u2717  --style is only supported by `mancode init --legacy`.");
+    console.error(
+      "   mancode detects project facts; run `mancode refresh-style` after initialization to refresh local style tokens."
+    );
+    return EXIT_INIT_FAILED;
+  }
+  const schemaPath = path46.join(rootDir, ".mancode", "schema.json");
+  let existingV3 = false;
+  if (await pathExists6(schemaPath)) {
+    try {
+      const manifest = parseSchemaManifest(
+        JSON.parse(await fs4.readFile(schemaPath, "utf8"))
+      );
+      if (manifest.activationState !== "v3_active") {
+        throw new Error(
+          `MANCODE_V3_INIT_UNAVAILABLE_DURING_${manifest.activationState.toUpperCase()}`
+        );
+      }
+      existingV3 = true;
+      if (options.platform === void 0) {
+        console.log("\u2139\uFE0F  mancode is already initialized.");
+        return EXIT_ALREADY_INITIALIZED;
+      }
+    } catch (error) {
+      printV3InitError(error);
+      return EXIT_INIT_FAILED;
+    }
+  } else if ((await scanLegacyAuthority(rootDir)).authorityPresent) {
+    printV3InitError(new Error("MANCODE_LEGACY_AUTHORITY_PRESENT"));
+    return EXIT_INIT_FAILED;
+  }
+  const selectedPlatforms = options.platform !== void 0 ? parsePlatformSelection(options.platform) : options.fromCli ? await selectInitPlatforms({
+    existingPlatform: null,
+    hints: await detectPlatformHints(rootDir),
+    interactive: options.interactive,
+    prompter: options.prompter,
+    locale: detectInitLocale(options.lang) ?? "en",
+    yes: options.yes
+  }) : [];
   if (selectedPlatforms === null) {
-    console.error(`\u2717  Unsupported platform selection: ${options.platform}`);
+    console.error(
+      options.platform === void 0 ? "\u2717  No platform selected. Choose one interactively or pass --platform <name>." : `\u2717  Unsupported platform selection: ${options.platform}`
+    );
     console.error("   Use one or more supported platform names, or all.");
     return EXIT_INIT_FAILED;
   }
   try {
+    for (const platform of selectedPlatforms) {
+      await assertV3AdapterInstallable(rootDir, platform);
+    }
+    if (existingV3) {
+      for (const platform of selectedPlatforms) {
+        await installV3Adapter(rootDir, platform);
+      }
+      console.log("\u2139\uFE0F  mancode is already initialized.");
+      if (selectedPlatforms.length > 0) {
+        console.log(
+          `   mancode bootstrap repaired: ${selectedPlatforms.join(", ")}`
+        );
+      }
+      return EXIT_ALREADY_INITIALIZED;
+    }
     const result2 = await initializeV3Project({
       projectRoot: rootDir,
       teamPolicy: options.team === void 0 ? "auto" : options.team ? "on" : "off"
@@ -25202,7 +25294,7 @@ async function initializeV3(rootDir, options) {
     for (const platform of selectedPlatforms) {
       await installV3Adapter(rootDir, platform);
     }
-    console.log("\u2713  Initialized mancode V3 greenfield project.");
+    console.log("\u2713  Initialized mancode project.");
     console.log(`   workspace: ${result2.runtime.workspaceId}`);
     console.log(`   operation: ${result2.journal.operationId}`);
     if (options.team !== void 0) {
@@ -25215,18 +25307,21 @@ async function initializeV3(rootDir, options) {
         "   No platform bootstrap selected. Run `mancode install <platform>`."
       );
     } else {
-      console.log(`   V3 bootstrap: ${selectedPlatforms.join(", ")}`);
+      console.log(`   mancode bootstrap: ${selectedPlatforms.join(", ")}`);
     }
     return EXIT_OK;
   } catch (error) {
-    const message = error instanceof Error ? error.message : "V3 initialization failed";
-    console.error(`\u2717  ${message}`);
-    if (message === "MANCODE_LEGACY_AUTHORITY_PRESENT") {
-      console.error("   Run `mancode migrate context --dry-run` instead.");
-    }
+    printV3InitError(error);
     return EXIT_INIT_FAILED;
   }
 }
+function printV3InitError(error) {
+  const message = error instanceof Error ? error.message : "mancode initialization failed";
+  console.error(`\u2717  ${message}`);
+  if (message === "MANCODE_LEGACY_AUTHORITY_PRESENT") {
+    console.error("   Run `mancode migrate context --dry-run` instead.");
+  }
+}
 async function updateConfigOptions(mancodeDir, patch, preserveInstalledPlatforms) {
   const configPath = path46.join(mancodeDir, "config.json");
   let config = {};
@@ -25346,6 +25441,28 @@ async function canInitializeGenericProject(rootDir) {
     return { ok: false, reason: "unsafe" };
   }
 }
+async function validateV3CliProjectBoundary(rootDir, options, locale, legacyInitialized) {
+  const isGitRepo = await pathExists6(path46.join(rootDir, ".git"));
+  const hasManifest = await hasProjectManifest(rootDir);
+  if (isGitRepo || hasManifest) return null;
+  const v3Initialized = await pathExists6(
+    path46.join(rootDir, ".mancode", "schema.json")
+  );
+  const legacyAuthorityPresent = legacyInitialized || (await scanLegacyAuthority(rootDir)).authorityPresent;
+  const genericSafety = await canInitializeGenericProject(rootDir);
+  if (!genericSafety.ok && !((legacyAuthorityPresent || v3Initialized) && genericSafety.reason === "nonempty")) {
+    printNotProjectDirectory(rootDir, locale, genericSafety.reason);
+    return EXIT_NOT_A_PROJECT_DIR;
+  }
+  if (legacyAuthorityPresent || v3Initialized) return null;
+  const prompter = options.prompter ?? (options.interactive ? createTerminalPrompter() : null);
+  const confirmed = options.empty || options.yes ? true : prompter ? await prompter.confirmGenericProject({ rootDir, locale }) : false;
+  if (!confirmed) {
+    printNotProjectDirectory(rootDir, locale, "empty");
+    return EXIT_NOT_A_PROJECT_DIR;
+  }
+  return null;
+}
 function printNotProjectDirectory(rootDir, locale, reason) {
   if (locale === "zh-CN") {
     console.error(`\u2717  \u5F53\u524D\u76EE\u5F55\u4E0D\u662F\u53EF\u521D\u59CB\u5316\u7684\u9879\u76EE\u76EE\u5F55\uFF1A${rootDir}`);
@@ -25577,7 +25694,9 @@ async function install(rootDir = process6.cwd(), platform = "claude-code", optio
   }
   if (options.shadow) {
     console.error("\u2717  MANCODE_V3_ADAPTER_SHADOW_REQUIRES_V3");
-    console.error("   Adapter shadow staging requires a V3 dual-read project.");
+    console.error(
+      "   Adapter shadow staging requires a mancode dual-read project."
+    );
     return EXIT_INSTALL_FAILED;
   }
   if (!await pathExists7(stateFile)) {
@@ -25674,9 +25793,12 @@ async function installV3(rootDir, platform, options) {
       }
       const staged = await stageV3Adapter(rootDir, installer.name);
       console.log(
-        `\u2713  ${formatPlatformName(platform)} V3 bootstrap staged for shadow comparison.`
+        `\u2713  ${formatPlatformName(platform)} mancode bootstrap and original mode entries staged for shadow comparison.`
       );
       console.log(`   ${staged.stagingTarget}`);
+      for (const entry of staged.modeEntries) {
+        console.log(`   ${entry.stagingTarget}`);
+      }
       return EXIT_OK2;
     }
     if (project.manifest.activationState !== "v3_active") {
@@ -25684,17 +25806,19 @@ async function installV3(rootDir, platform, options) {
     }
     if (options.minimal) {
       console.log(
-        "\u2139\uFE0F  V3 adapters are already bootstrap-only; --minimal has no additional effect."
+        "\u2139\uFE0F  mancode adapters are already bootstrap-only; --minimal has no additional effect."
       );
     }
     const installed = await installV3Adapter(rootDir, installer.name);
-    console.log(`\u2713  ${formatPlatformName(platform)} V3 bootstrap installed.`);
+    console.log(
+      `\u2713  ${formatPlatformName(platform)} mancode bootstrap installed.`
+    );
     console.log(`   ${installed.target}`);
     return EXIT_OK2;
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     console.error(
-      `\u2717  ${formatPlatformName(platform)} V3 adapter install failed: ${message}`
+      `\u2717  ${formatPlatformName(platform)} mancode adapter install failed: ${message}`
     );
     return EXIT_INSTALL_FAILED;
   }
@@ -25804,7 +25928,7 @@ async function listV3Platforms(rootDir) {
     platforms.map((platform) => inspectV3Adapter(rootDir, platform.name))
   );
   console.log("");
-  console.log("Available platforms (V3 bootstrap):");
+  console.log("Available platforms (mancode bootstrap):");
   for (const [index, platform] of platforms.entries()) {
     const status2 = statuses[index];
     if (status2 === void 0) {
@@ -25812,7 +25936,7 @@ async function listV3Platforms(rootDir) {
     }
     const marker = status2.installed ? "\u2713" : "\u25CB";
     console.log(
-      `  ${marker} ${platform.name.padEnd(12)} ${platform.displayName.padEnd(16)} V3 bootstrap; explicit session identity`
+      `  ${marker} ${platform.name.padEnd(12)} ${platform.displayName.padEnd(16)} mancode bootstrap; explicit session identity`
     );
   }
   console.log("");
@@ -25853,7 +25977,7 @@ function describePlatform(platform) {
 }
 
 // src/commands/manps.ts
-import { access as access4 } from "fs/promises";
+import { access as access4, readFile as readFile35 } from "fs/promises";
 import path50 from "path";
 import { createInterface as createInterface2 } from "readline/promises";
 
@@ -25943,20 +26067,17 @@ var SCANNERS = [
     scan: ({ projectRoot }) => scanArchitecture(projectRoot)
   }
 ];
-async function runPreseasonScan(projectRoot, area = "all") {
+async function runPreseasonScan(projectRoot, area = "all", options = {}) {
   const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
   const normalizedArea = normalizeArea(area);
   const pkg = await readPackageJson(projectRoot);
   const needsFiles = normalizedArea === "all" || normalizedArea === "dead-code" || normalizedArea === "config";
   const files = needsFiles ? await listProjectFiles(projectRoot) : [];
   const issues = (await scanArea(projectRoot, normalizedArea, pkg, files)).slice(0, 20);
-  const reportDir = path49.join(projectRoot, ".mancode", "preseason-reports");
+  const storageRoot = options.storageRoot ?? path49.join(projectRoot, ".mancode");
+  const reportDir = path49.join(storageRoot, "preseason-reports");
   await mkdir31(reportDir, { recursive: true });
-  const issueDbPath = path49.join(
-    projectRoot,
-    ".mancode",
-    "preseason-issues.json"
-  );
+  const issueDbPath = path49.join(storageRoot, "preseason-issues.json");
   const reportPath = await allocateReportPath(
     reportDir,
     `${generatedAt.replace(/[:.]/g, "-")}-${normalizedArea}`
@@ -25972,7 +26093,7 @@ async function runPreseasonScan(projectRoot, area = "all") {
   const database = await buildIssueDatabase(projectRoot, report);
   await writeFile36(reportPath, renderPreseasonReport(report), "utf-8");
   await writeFile36(
-    path49.join(projectRoot, ".mancode", "preseason-report.md"),
+    path49.join(storageRoot, "preseason-report.md"),
     renderPreseasonReport(report),
     "utf-8"
   );
@@ -25980,11 +26101,7 @@ async function runPreseasonScan(projectRoot, area = "all") {
   return report;
 }
 async function runPreseasonRemediation(projectRoot, issues, options = {}) {
-  const issueDbPath = path49.join(
-    projectRoot,
-    ".mancode",
-    "preseason-issues.json"
-  );
+  const issueDbPath = options.issueDbPath ?? path49.join(projectRoot, ".mancode", "preseason-issues.json");
   const database = await readIssueDatabase(issueDbPath);
   const keys = new Set(issues.map((issue) => issueKey(issue)));
   const targets = database.issues.filter(
@@ -26266,9 +26383,7 @@ function readTodoIssues(abs, rel, offset) {
     const lines = content.split("\n");
     const issues = [];
     for (let i = 0; i < lines.length && issues.length < 2; i++) {
-      if (/\b(TODO|FIXME|HACK|XXX|deprecated|legacy|temporary|workaround)\b/i.test(
-        lines[i] ?? ""
-      )) {
+      if (isMaintenanceMarker(lines[i] ?? "")) {
         issues.push({
           id: `todo-${offset + issues.length + 1}`,
           severity: "P2",
@@ -26285,6 +26400,12 @@ function readTodoIssues(abs, rel, offset) {
     return [];
   }
 }
+function isMaintenanceMarker(line) {
+  const trimmed = line.trim();
+  return /(?:^|\s)(?:\/\/|#|\/\*|\*|<!--)\s*(?:TODO|FIXME|HACK|XXX)\b/i.test(
+    trimmed
+  );
+}
 function scanTestGaps(files) {
   const sourceFiles = files.filter(
     (file) => file.startsWith("src/") && /\.(ts|tsx|js|jsx)$/.test(file) && !file.endsWith(".d.ts") && !file.includes("/templates/")
@@ -26781,7 +26902,21 @@ var EXIT_NOT_INITIALIZED2 = 1;
 var EXIT_SCAN_FAILED = 2;
 var EXIT_INVALID_ARG = 3;
 async function manps(rootDir, area = "all", options = {}) {
-  if (!await pathExists10(path50.join(rootDir, ".mancode", "state.json"))) {
+  const v3SchemaPath = path50.join(rootDir, ".mancode", "schema.json");
+  const v3Activation = await readV3ActivationState(v3SchemaPath);
+  if (v3Activation !== null && v3Activation !== "v3_active" && v3Activation !== "dual_read") {
+    const message = `manps is unavailable while mancode activation is ${v3Activation}`;
+    if (options.json) {
+      console.log(JSON.stringify({ error: "scan failed", message }, null, 2));
+    } else {
+      console.error("\u2717  mancode preseason scan is temporarily unavailable.");
+      console.error(`   ${message}`);
+    }
+    return EXIT_SCAN_FAILED;
+  }
+  const v3Initialized = v3Activation === "v3_active";
+  const initialized = v3Initialized || await pathExists10(path50.join(rootDir, ".mancode", "state.json"));
+  if (!initialized) {
     if (options.json) {
       console.log(JSON.stringify({ error: "not initialized" }, null, 2));
     } else {
@@ -26792,7 +26927,9 @@ async function manps(rootDir, area = "all", options = {}) {
   }
   let report;
   try {
-    report = await runPreseasonScan(rootDir, area);
+    report = await runPreseasonScan(rootDir, area, {
+      storageRoot: v3Initialized ? path50.join(rootDir, ".mancode", "local") : void 0
+    });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     const invalidArg2 = message.startsWith("invalid area:");
@@ -26888,7 +27025,8 @@ async function runRemediation(rootDir, report, options, silent = false) {
   if (options.answers) {
     return runPreseasonRemediation(rootDir, report.issues, {
       answers: options.answers,
-      write: write2
+      write: write2,
+      issueDbPath: report.issueDbPath
     });
   }
   if (!process.stdin.isTTY) {
@@ -26900,7 +27038,8 @@ async function runRemediation(rootDir, report, options, silent = false) {
     }
     return runPreseasonRemediation(rootDir, report.issues, {
       answers,
-      write: write2
+      write: write2,
+      issueDbPath: report.issueDbPath
     });
   }
   const rl = createInterface2({
@@ -26910,7 +27049,8 @@ async function runRemediation(rootDir, report, options, silent = false) {
   try {
     return await runPreseasonRemediation(rootDir, report.issues, {
       ask: (question) => rl.question(question),
-      write: write2
+      write: write2,
+      issueDbPath: report.issueDbPath
     });
   } finally {
     rl.close();
@@ -26931,9 +27071,20 @@ async function pathExists10(p) {
     return false;
   }
 }
+async function readV3ActivationState(schemaPath) {
+  if (!await pathExists10(schemaPath)) return null;
+  try {
+    const manifest = parseSchemaManifest(
+      JSON.parse(await readFile35(schemaPath, "utf8"))
+    );
+    return manifest.activationState;
+  } catch {
+    return "invalid";
+  }
+}
 
 // src/commands/migrate.ts
-import { readFile as readFile35 } from "fs/promises";
+import { readFile as readFile36 } from "fs/promises";
 import path51 from "path";
 var EXIT_OK5 = 0;
 var EXIT_INVALID_ARG2 = 2;
@@ -27067,7 +27218,7 @@ async function readScopeFile(rootDir, file) {
   }
   try {
     return JSON.parse(
-      await readFile35(resolved, "utf8")
+      await readFile36(resolved, "utf8")
     );
   } catch (error) {
     if (error instanceof SyntaxError) {
@@ -27265,17 +27416,17 @@ async function refreshV3Project(rootDir) {
       revision: (project.projectFacts?.revision ?? 0) + 1
     });
     await writeProjectFacts(rootDir, facts);
-    console.log("\u2713  V3 project facts refreshed.");
+    console.log("\u2713  mancode project facts refreshed.");
     console.log(
       `   Kind: ${facts.profile.projectKind} | Stack: ${[...facts.profile.languages, ...facts.profile.frameworks].join(" + ") || "unknown"}`
     );
     console.log(
-      "   V3 adapters remain unchanged because their bootstrap is static."
+      "   mancode adapters remain unchanged because their bootstrap is static."
     );
     return EXIT_OK6;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`\u2717  V3 project facts refresh failed: ${message}`);
+    console.error(`\u2717  mancode project facts refresh failed: ${message}`);
     return EXIT_REFRESH_FAILED;
   }
 }
@@ -27524,7 +27675,7 @@ async function refreshV3Style(rootDir) {
     if (project.manifest.activationState !== "v3_active") {
       throw new Error("MANCODE_V3_REFRESH_REQUIRES_ACTIVE");
     }
-    console.log("\u2713  \u5237\u65B0 V3 \u9879\u76EE profile...");
+    console.log("\u2713  \u5237\u65B0 mancode \u9879\u76EE profile...");
     const profile = await detectProjectProfile(rootDir);
     const uiLibraryHint = primaryUiLibrary(profile);
     await writeProjectFacts(
@@ -27548,7 +27699,7 @@ async function refreshV3Style(rootDir) {
       console.log(
         "\u2139\uFE0F  No UI assets detected in project profile. Skipping style scan."
       );
-      console.log("   Updated V3 project facts.");
+      console.log("   Updated mancode project facts.");
       return EXIT_OK7;
     }
     console.log("\u2713  \u626B\u63CF\u9879\u76EE\u8BBE\u8BA1 token...");
@@ -27568,7 +27719,7 @@ async function refreshV3Style(rootDir) {
     return EXIT_OK7;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`\u2717  V3 style refresh failed: ${message}`);
+    console.error(`\u2717  mancode style refresh failed: ${message}`);
     return EXIT_V3_REFRESH_FAILED;
   }
 }
@@ -28259,11 +28410,11 @@ function printText(r) {
 }
 function printV3Text(result2) {
   console.log("");
-  console.log(`mancode v${result2.version} (V3 authority)`);
+  console.log(`mancode v${result2.version}`);
   console.log("");
   console.log(`Project:     ${result2.project}`);
   console.log(
-    `Activation:  ${result2.activation.state} (epoch ${result2.activation.epoch})`
+    `Activation:  ${formatActivationState(result2.activation.state)} (epoch ${result2.activation.epoch})`
   );
   console.log(
     `Runtime:     ${result2.runtime.binding}${result2.runtime.error ? ` (${result2.runtime.error})` : ""}`
@@ -28293,11 +28444,11 @@ function printV3Text(result2) {
   }
   if (result2.legacyAuthorityPresent) {
     console.log(
-      "Legacy:      legacy authority detected; V3 writes may be blocked."
+      "Legacy:      legacy authority detected; mancode writes may be blocked."
     );
   }
   console.log("");
-  console.log("V3 adapter status:");
+  console.log("mancode adapter status:");
   for (const platform of getPlatformInstallers()) {
     const adapter = result2.adapters[platform.name];
     const marker = adapter.installed ? "\u2713" : "\u25CB";
@@ -28309,11 +28460,14 @@ function printV3Text(result2) {
   if (result2.runtime.binding !== "ready") {
     console.log("");
     console.log(
-      "Run `mancode context worktree register` in this checkout before V3 mutations."
+      "Run `mancode context worktree register` in this checkout before mancode mutations."
     );
   }
   console.log("");
 }
+function formatActivationState(state) {
+  return state.replace(/^v3_/, "").replaceAll("_", " ");
+}
 function formatTeamStatus(team) {
   if (team.forced) return `forced (${team.contributors} contributors)`;
   if (team.isTeam) return `detected (${team.contributors} contributors)`;
@@ -29742,7 +29896,7 @@ function isAlreadyExists21(error) {
 }
 
 // src/team/git-ref-handoff-repair.ts
-import { lstat as lstat19, mkdir as mkdir33, readFile as readFile36, readdir as readdir17, writeFile as writeFile38 } from "fs/promises";
+import { lstat as lstat19, mkdir as mkdir33, readFile as readFile37, readdir as readdir17, writeFile as writeFile38 } from "fs/promises";
 import path56 from "path";
 
 // src/team/git-ref-operation.ts
@@ -32474,7 +32628,7 @@ async function replaceJournal3(projectRoot, journal) {
 async function requireJournal2(projectRoot, operationId) {
   try {
     return parseJournal3(
-      JSON.parse(await readFile36(journalPath3(projectRoot, operationId), "utf8"))
+      JSON.parse(await readFile37(journalPath3(projectRoot, operationId), "utf8"))
     );
   } catch (error) {
     if (error instanceof SyntaxError || isNotFound25(error)) {
@@ -32497,7 +32651,7 @@ async function listJournals2(projectRoot) {
     journals.push(
       parseJournal3(
         JSON.parse(
-          await readFile36(
+          await readFile37(
             path56.join(journalDirectory2(projectRoot), entry),
             "utf8"
           )
@@ -32512,7 +32666,7 @@ async function readSafeFile2(target) {
   if (!before.isFile() || before.isSymbolicLink()) {
     throw new Error("MANCODE_ARTIFACT_PATH_UNSAFE");
   }
-  const content = await readFile36(target, "utf8");
+  const content = await readFile37(target, "utf8");
   const after = await lstat19(target);
   if (!after.isFile() || after.isSymbolicLink() || before.dev !== after.dev || before.ino !== after.ino) {
     throw new Error("MANCODE_ARTIFACT_PATH_UNSAFE");
@@ -32984,7 +33138,7 @@ function isNotFound26(error) {
 import {
   lstat as lstat21,
   mkdir as mkdir35,
-  readFile as readFile37,
+  readFile as readFile38,
   readdir as readdir19,
   rename as rename10,
   unlink as unlink4,
@@ -35135,7 +35289,7 @@ function projectConfigPath2(projectRoot) {
 async function readProjectConfigFile(projectRoot) {
   try {
     return parseProjectConfig(
-      JSON.parse(await readFile37(projectConfigPath2(projectRoot), "utf8"))
+      JSON.parse(await readFile38(projectConfigPath2(projectRoot), "utf8"))
     );
   } catch (error) {
     if (error instanceof SyntaxError) {
@@ -35182,7 +35336,7 @@ async function readJsonOrNull5(target, parser, corruptCode) {
     if (!before.isFile() || before.isSymbolicLink()) {
       throw new Error("MANCODE_TRANSPORT_MIGRATION_STAGE_UNSAFE");
     }
-    const parsed = parser(JSON.parse(await readFile37(target, "utf8")));
+    const parsed = parser(JSON.parse(await readFile38(target, "utf8")));
     const after = await lstat21(target);
     if (!after.isFile() || after.isSymbolicLink() || before.dev !== after.dev || before.ino !== after.ino) {
       throw new Error("MANCODE_TRANSPORT_MIGRATION_STAGE_UNSAFE");
@@ -36714,7 +36868,7 @@ function parsePositiveInteger5(value) {
 }
 
 // src/commands/uninstall.ts
-import { access as access5, readFile as readFile38, rm as rm17, writeFile as writeFile41 } from "fs/promises";
+import { access as access5, readFile as readFile39, rm as rm17, writeFile as writeFile41 } from "fs/promises";
 import path59 from "path";
 import process11 from "process";
 var EXIT_OK9 = 0;
@@ -36759,9 +36913,9 @@ async function uninstall(rootDir = process11.cwd(), platform, options = {}) {
 }
 async function uninstallV3(rootDir, platform, options) {
   if (!platform || options.all) {
-    console.error("\u2717  V3 authority is protected from bulk uninstall.");
+    console.error("\u2717  mancode authority is protected from bulk uninstall.");
     console.error(
-      "   Remove a single bootstrap with `mancode uninstall <platform>`, or complete an explicit V3 archive/migration workflow first."
+      "   Remove a single bootstrap with `mancode uninstall <platform>`, or complete an explicit mancode archive/migration workflow first."
     );
     return EXIT_V3_AUTHORITY_PROTECTED;
   }
@@ -36775,17 +36929,21 @@ async function uninstallV3(rootDir, platform, options) {
   }
   if (!options.force) {
     console.log(
-      `\u2139\uFE0F  This will remove only the ${formatPlatformName(platform)} V3 bootstrap.`
+      `\u2139\uFE0F  This will remove only the ${formatPlatformName(platform)} mancode bootstrap.`
+    );
+    console.log(
+      "   mancode task, session, and shared authority are preserved."
     );
-    console.log("   V3 task, session, and shared authority are preserved.");
   }
   try {
     await removeV3Adapter(rootDir, installer.name);
-    console.log(`\u2713  Removed ${formatPlatformName(platform)} V3 bootstrap.`);
+    console.log(
+      `\u2713  Removed ${formatPlatformName(platform)} mancode bootstrap.`
+    );
     return EXIT_OK9;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    console.error(`\u2717  V3 bootstrap removal failed: ${message}`);
+    console.error(`\u2717  mancode bootstrap removal failed: ${message}`);
     return EXIT_V3_AUTHORITY_PROTECTED;
   }
 }
@@ -36823,7 +36981,7 @@ async function cleanClaudeSettings(rootDir) {
   const settingsPath = path59.join(rootDir, ".claude", "settings.json");
   let content;
   try {
-    content = await readFile38(settingsPath, "utf-8");
+    content = await readFile39(settingsPath, "utf-8");
   } catch {
     return;
   }
@@ -36900,7 +37058,7 @@ async function uninstallCursor(rootDir) {
 async function uninstallCodex(rootDir) {
   const agentsPath = path59.join(rootDir, "AGENTS.md");
   try {
-    const content = await readFile38(agentsPath, "utf-8");
+    const content = await readFile39(agentsPath, "utf-8");
     const cleaned = removeManagedBlock(content);
     if (cleaned.trim()) {
       await writeFile41(agentsPath, `${cleaned}
@@ -36919,7 +37077,7 @@ async function uninstallCopilot(rootDir) {
     "copilot-instructions.md"
   );
   try {
-    const content = await readFile38(instructionsPath, "utf-8");
+    const content = await readFile39(instructionsPath, "utf-8");
     const cleaned = removeManagedBlock(content);
     if (cleaned.trim()) {
       await writeFile41(instructionsPath, `${cleaned}
@@ -36934,7 +37092,7 @@ async function uninstallCopilot(rootDir) {
 async function uninstallZcode(rootDir) {
   const agentsPath = path59.join(rootDir, "AGENTS.md");
   try {
-    const content = await readFile38(agentsPath, "utf-8");
+    const content = await readFile39(agentsPath, "utf-8");
     const cleaned = removeManagedBlock(
       content,
       ZCODE_MANCODE_START_MARKER,
@@ -36953,7 +37111,7 @@ async function uninstallZcode(rootDir) {
 async function removeFromConfig(rootDir, platform) {
   const configPath = path59.join(rootDir, ".mancode", "config.json");
   try {
-    const raw = await readFile38(configPath, "utf-8");
+    const raw = await readFile39(configPath, "utf-8");
     const config = JSON.parse(raw);
     if (Array.isArray(config.platforms)) {
       config.platforms = config.platforms.filter((p) => p !== platform);
@@ -36998,7 +37156,7 @@ function version() {
 }
 
 // src/commands/workflow.ts
-import { access as access6, readFile as readFile40, rm as rm19, writeFile as writeFile43 } from "fs/promises";
+import { access as access6, readFile as readFile41, rm as rm19, writeFile as writeFile43 } from "fs/promises";
 import path61 from "path";
 
 // src/context/child-result-merge.ts
@@ -39456,7 +39614,7 @@ function updateMetadata4(previous, verification, operationId, updatedAt) {
 import {
   lstat as lstat22,
   mkdir as mkdir36,
-  readFile as readFile39,
+  readFile as readFile40,
   rename as rename11,
   rm as rm18,
   writeFile as writeFile42
@@ -40241,7 +40399,7 @@ async function readStagedJson(stagingDirectory, fileName, parser) {
   if (!before.isFile() || before.isSymbolicLink()) {
     throw new Error("MANCODE_ARTIFACT_PATH_UNSAFE");
   }
-  const parsed = parser(JSON.parse(await readFile39(target, "utf8")));
+  const parsed = parser(JSON.parse(await readFile40(target, "utf8")));
   const after = await lstat22(target);
   if (!after.isFile() || after.isSymbolicLink() || before.dev !== after.dev || before.ino !== after.ino) {
     throw new Error("MANCODE_ARTIFACT_PATH_UNSAFE");
@@ -41225,12 +41383,86 @@ function compareUtf816(left, right) {
   return Buffer.from(left, "utf8").compare(Buffer.from(right, "utf8"));
 }
 
+// src/commands/requirements-input.ts
+function normalizeRequirementsInput(value, requestedTaskRef, now = /* @__PURE__ */ new Date()) {
+  if (isRecord13(value) && "schemaVersion" in value) {
+    return parseRequirementsLedger(value);
+  }
+  const serialized = JSON.stringify(value);
+  if (serialized === void 0) {
+    throw new Error("requirements input must be valid JSON");
+  }
+  const semantic = parseRequirementsLedger2(serialized);
+  return buildCanonicalRequirements(semantic, requestedTaskRef, now);
+}
+function buildCanonicalRequirements(semantic, requestedTaskRef, now) {
+  const taskRef = parseTaskRefValue(requestedTaskRef);
+  let allocatedIds = 0;
+  const allocateId = () => createUlid(now.getTime() + allocatedIds++);
+  const draft = {
+    schemaVersion: 1,
+    canonicalizationVersion: "mancode-jcs-v1",
+    taskRef,
+    revision: 1,
+    status: semantic.blockingUnknowns.length === 0 ? "confirmed" : "draft",
+    goal: semantic.goal,
+    functionalScope: {
+      inScope: semantic.confirmedScope,
+      outOfScope: semantic.excludedScope
+    },
+    technicalDecisions: semantic.technicalDecisions.map((statement, index) => ({
+      displayId: `TD-${index + 1}`,
+      legacyId: null,
+      decisionId: allocateId(),
+      statement
+    })),
+    defaults: semantic.defaults.map((statement, index) => ({
+      displayId: `D-${index + 1}`,
+      legacyId: null,
+      defaultId: allocateId(),
+      statement
+    })),
+    coverage: semantic.coverage.map((item) => ({
+      coverageId: allocateId(),
+      ...item
+    })),
+    requirements: [],
+    acceptanceCriteria: semantic.acceptanceCriteria.map((item) => ({
+      displayId: item.id,
+      legacyId: item.id,
+      criterionId: allocateId(),
+      requirementIds: [],
+      statement: item.description,
+      required: item.required,
+      verificationRequirement: item.method
+    })),
+    blockingUnknowns: semantic.blockingUnknowns.map((statement, index) => ({
+      displayId: `U-${index + 1}`,
+      legacyId: null,
+      unknownId: allocateId(),
+      statement,
+      status: "open"
+    })),
+    legacySource: null,
+    contentDigest: "",
+    lastOperationId: null,
+    updatedAt: now.toISOString()
+  };
+  return parseRequirementsLedger({
+    ...draft,
+    contentDigest: requirementsLedgerDigest(draft)
+  });
+}
+function isRecord13(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
 // src/commands/workflow.ts
 var EXIT_OK10 = 0;
 var EXIT_NOT_INITIALIZED7 = 1;
 var EXIT_INVALID_ARG3 = 2;
 async function workflow(rootDir, subcommand, args = [], options = {}) {
-  const v3Activation = await readV3ActivationState(rootDir);
+  const v3Activation = await readV3ActivationState2(rootDir);
   if (v3Activation === "v3_active") {
     return workflowV3(rootDir, subcommand, args, options);
   }
@@ -41239,7 +41471,7 @@ async function workflow(rootDir, subcommand, args = [], options = {}) {
       return printV3Error(
         options.json,
         "MANCODE_V3_WRITE_REQUIRES_ACTIVATION",
-        "This project has staged V3 context but remains in dual-read migration. Use legacy workflows until activation."
+        "This project has staged mancode context but remains in dual-read migration. Use legacy workflows until activation."
       );
     }
     if (options.json) {
@@ -41326,7 +41558,7 @@ async function workflowV3(rootDir, subcommand, args, options) {
   return printV3Error(
     options.json,
     "MANCODE_V3_OPERATION_NOT_IMPLEMENTED",
-    `workflow ${subcommand} is not yet implemented for V3 authority.`
+    `workflow ${subcommand} is not yet implemented for mancode authority.`
   );
 }
 async function workflowUpdateV3(rootDir, args, options) {
@@ -41343,7 +41575,7 @@ async function workflowUpdateV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       "MANCODE_WORKFLOW_UPDATE_EMPTY",
-      "V3 workflow update requires --status or --blocking-reason.",
+      "Workflow update requires --status or --blocking-reason.",
       EXIT_INVALID_ARG3
     );
   }
@@ -41351,7 +41583,7 @@ async function workflowUpdateV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       "MANCODE_V3_WORKFLOW_UPDATE_FIELD_UNSUPPORTED",
-      "V3 workflow update only changes lifecycle status and a blocked reason. Use the dedicated requirements, plan, review, verification, scope, complete, or promote command for governed fields.",
+      "Workflow update only changes lifecycle status and a blocked reason. Use the dedicated requirements, plan, review, verification, scope, complete, or promote command for governed fields.",
       EXIT_INVALID_ARG3
     );
   }
@@ -41360,7 +41592,7 @@ async function workflowUpdateV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       "MANCODE_EXPECTED_REVISION_REQUIRED",
-      "V3 workflow update requires --expected-revision <positive integer>.",
+      "Workflow update requires --expected-revision <positive integer>.",
       EXIT_INVALID_ARG3
     );
   }
@@ -41415,7 +41647,7 @@ async function workflowUpdateV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_WORKFLOW_UPDATE_FAILED"),
-      error instanceof Error ? error.message : "Unable to update the V3 workflow lifecycle."
+      error instanceof Error ? error.message : "Unable to update the mancode workflow lifecycle."
     );
   }
 }
@@ -41467,7 +41699,7 @@ async function workflowChildResultMergeV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_CHILD_RESULT_MERGE_FAILED"),
-      error instanceof Error ? error.message : "Unable to merge the V3 child diagnostic result."
+      error instanceof Error ? error.message : "Unable to merge the mancode child diagnostic result."
     );
   }
 }
@@ -41524,7 +41756,7 @@ async function workflowSoloHandoffV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_SOLO_HANDOFF_FAILED"),
-      error instanceof Error ? error.message : "Unable to run the V3 solo handoff."
+      error instanceof Error ? error.message : "Unable to run the mancode solo handoff."
     );
   }
 }
@@ -41584,7 +41816,7 @@ async function workflowPromoteV3(rootDir, args, options) {
       return printV3Error(
         options.json,
         v3ErrorCode(error, "MANCODE_V3_WORKFLOW_PROMOTE_FAILED"),
-        error instanceof Error ? error.message : "Unable to preview the V3 workflow promotion."
+        error instanceof Error ? error.message : "Unable to preview the mancode workflow promotion."
       );
     }
   }
@@ -41614,7 +41846,7 @@ async function workflowPromoteV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_WORKFLOW_PROMOTE_FAILED"),
-      error instanceof Error ? error.message : "Unable to promote the local V3 workflow."
+      error instanceof Error ? error.message : "Unable to promote the local mancode workflow."
     );
   }
 }
@@ -41696,7 +41928,7 @@ async function workflowScopeChangeV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_SCOPE_CHANGE_FAILED"),
-      error instanceof Error ? error.message : "Unable to change the V3 workflow scope."
+      error instanceof Error ? error.message : "Unable to change the mancode workflow scope."
     );
   }
 }
@@ -41769,7 +42001,7 @@ async function workflowCompleteV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_TASK_COMPLETE_FAILED"),
-      error instanceof Error ? error.message : "Unable to complete the V3 task."
+      error instanceof Error ? error.message : "Unable to complete the mancode task."
     );
   }
 }
@@ -41819,7 +42051,7 @@ async function workflowVerifyV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_VERIFICATION_RECORD_FAILED"),
-      error instanceof Error ? error.message : "Unable to record V3 verification."
+      error instanceof Error ? error.message : "Unable to record mancode verification."
     );
   }
 }
@@ -41870,7 +42102,7 @@ async function workflowReviewV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_REVIEW_APPLY_FAILED"),
-      error instanceof Error ? error.message : "Unable to apply the V3 review."
+      error instanceof Error ? error.message : "Unable to apply the mancode review."
     );
   }
 }
@@ -41944,7 +42176,7 @@ async function workflowPlanV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_PLAN_REVISION_FAILED"),
-      error instanceof Error ? error.message : "Unable to revise the V3 plan."
+      error instanceof Error ? error.message : "Unable to revise the mancode plan."
     );
   }
 }
@@ -41971,13 +42203,15 @@ async function workflowRequirementsV3(rootDir, args, options) {
   try {
     const project = await readV3CommandProject(rootDir);
     const session = await resolveV3CommandSession(project, options);
-    const requirements = await readWorkflowJsonInputFile(
+    const taskRef = parseTaskRef(task);
+    const requirementsInput = await readWorkflowJsonInputFile(
       project.projectRoot,
       options.file
     );
+    const requirements = normalizeRequirementsInput(requirementsInput, taskRef);
     const result2 = await finalizeV3Requirements({
       projectRoot: project.projectRoot,
-      taskRef: parseTaskRef(task),
+      taskRef,
       sessionId: session.sessionId,
       expectedTaskRevision,
       requirements
@@ -41997,7 +42231,7 @@ async function workflowRequirementsV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_REQUIREMENTS_FINALIZE_FAILED"),
-      error instanceof Error ? error.message : "Unable to finalize V3 requirements."
+      error instanceof Error ? error.message : "Unable to finalize mancode requirements."
     );
   }
 }
@@ -42032,7 +42266,7 @@ function parseV3ParticipantActorIds(values) {
 }
 async function readWorkflowInputFile(projectRoot, value) {
   const inputPath = path61.isAbsolute(value) ? value : path61.resolve(projectRoot, value);
-  return readFile40(inputPath, "utf8");
+  return readFile41(inputPath, "utf8");
 }
 async function readWorkflowJsonInputFile(projectRoot, value) {
   return JSON.parse(await readWorkflowInputFile(projectRoot, value));
@@ -42091,15 +42325,15 @@ async function workflowCreateV3(rootDir, args, options) {
     return printV3Error(
       options.json,
       v3ErrorCode(error, "MANCODE_V3_WORKFLOW_CREATE_FAILED"),
-      error instanceof Error ? error.message : "Unable to create V3 workflow."
+      error instanceof Error ? error.message : "Unable to create mancode workflow."
     );
   }
 }
-async function readV3ActivationState(rootDir) {
+async function readV3ActivationState2(rootDir) {
   try {
     const manifest = parseSchemaManifest(
       JSON.parse(
-        await readFile40(path61.join(rootDir, ".mancode", "schema.json"), "utf8")
+        await readFile41(path61.join(rootDir, ".mancode", "schema.json"), "utf8")
       )
     );
     return manifest.activationState === "v3_active" ? "v3_active" : "other";
@@ -42153,12 +42387,12 @@ async function workflowRequirements(rootDir, args, options) {
   let originalMetadata;
   try {
     const inputPath = path61.isAbsolute(options.file) ? options.file : path61.resolve(rootDir, options.file);
-    const input = await readFile40(inputPath, "utf-8");
+    const input = await readFile41(inputPath, "utf-8");
     const requirements = parseRequirementsLedger2(input);
     [originalJson, originalMarkdown, originalMetadata] = await Promise.all([
       readOptionalText2(jsonPath),
       readOptionalText2(markdownPath),
-      readFile40(metadataPath3, "utf-8")
+      readFile41(metadataPath3, "utf-8")
     ]);
     await writeRequirementsArtifacts(rootDir, taskId, requirements);
     await updateWorkflow(rootDir, taskId, {
@@ -42346,7 +42580,7 @@ async function commitVerificationTransition(rootDir, meta, ledger) {
   const specPath = path61.join(rootDir, ".mancode", "memory", "spec.md");
   const [originalLedger, originalMetadata, originalSpec] = await Promise.all([
     readOptionalText2(ledgerPath),
-    readFile40(metadataPath3, "utf-8"),
+    readFile41(metadataPath3, "utf-8"),
     readOptionalText2(specPath)
   ]);
   const wasVerificationBlocked = meta.status === "blocked" && meta.blockingReason?.startsWith("[verification]");
@@ -42516,7 +42750,7 @@ async function commitReviewSkip(rootDir, meta, reason) {
   );
   const [originalLedger, originalMetadata] = await Promise.all([
     readOptionalText2(ledgerPath),
-    readFile40(metadataPath3, "utf-8")
+    readFile41(metadataPath3, "utf-8")
   ]);
   try {
     await initializeSkippedReview(rootDir, meta.taskId, reason);
@@ -42758,7 +42992,7 @@ async function workflowHandoff(rootDir, taskId, options) {
   let originalState;
   let state;
   try {
-    originalState = await readFile40(statePath, "utf-8");
+    originalState = await readFile41(statePath, "utf-8");
     state = JSON.parse(originalState);
   } catch {
     return invalidArg(
@@ -42833,7 +43067,7 @@ async function workflowCompleteHandoff(rootDir, taskId, options) {
   let originalState;
   let state;
   try {
-    originalState = await readFile40(statePath, "utf-8");
+    originalState = await readFile41(statePath, "utf-8");
     state = JSON.parse(originalState);
   } catch {
     return invalidArg(
@@ -42907,7 +43141,7 @@ async function workflowDecide(rootDir, taskId, options) {
   let originalState;
   let state;
   try {
-    originalState = await readFile40(statePath, "utf-8");
+    originalState = await readFile41(statePath, "utf-8");
     state = JSON.parse(originalState);
   } catch {
     return invalidArg(
@@ -42970,7 +43204,7 @@ async function commitPlanningTransition(args) {
   let originalMetadata;
   let originalSpec;
   try {
-    originalMetadata = await readFile40(metadataPath3, "utf-8");
+    originalMetadata = await readFile41(metadataPath3, "utf-8");
     originalSpec = await readOptionalText2(specPath);
   } catch (error) {
     return error instanceof Error ? `unable to prepare planning transition: ${error.message}` : "unable to prepare planning transition";
@@ -43001,7 +43235,7 @@ async function commitPlanningTransition(args) {
 }
 async function readOptionalText2(filePath) {
   try {
-    return await readFile40(filePath, "utf-8");
+    return await readFile41(filePath, "utf-8");
   } catch (error) {
     if (isNodeError10(error) && error.code === "ENOENT") return null;
     throw error;
@@ -43266,9 +43500,10 @@ async function pathExists16(p) {
 program.name("mancode").description(
   "AI coding agent harness. Modes: solo, man, manba, manteam, manps."
 ).version(VERSION);
-program.command("init").description("Initialize mancode in the current project").option("--force", "Reinstall even if already initialized").option("--yes", "Skip all confirmations (CI mode)").option("--team", "Force enable team mode (MVP-2)").option("--no-team", "Force disable team mode (MVP-2)").option("--style <name>", "Specify aesthetic style (MVP-2)").option("--platform <platforms>", "Adapters: comma-separated names or all").option("--empty", "Initialize a safe empty directory as a generic project").option("--v3", "Use the journaled V3 greenfield initializer").option("--lang <locale>", "Initialization language: zh-CN or en").action(async (options) => {
+program.command("init").description("Initialize mancode in the current project").option("--force", "Reinstall even if already initialized").option("--yes", "Skip all confirmations (CI mode)").option("--team", "Force enable team mode (MVP-2)").option("--no-team", "Force disable team mode (MVP-2)").option("--style <name>", "Specify aesthetic style (MVP-2)").option("--platform <platforms>", "Adapters: comma-separated names or all").option("--empty", "Initialize a safe empty directory as a generic project").addOption(new Option("--v3").hideHelp()).option("--legacy", "Use the legacy state.json initializer").option("--lang <locale>", "Initialization language: zh-CN or en").action(async (options) => {
   const code = await init(process.cwd(), {
     ...options,
+    fromCli: true,
     interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY)
   });
   process.exitCode = code;
@@ -43277,7 +43512,7 @@ program.command("install [platform]").description(
   "Install platform adapter (claude-code, cursor, codex, copilot, zcode)"
 ).option("--force", "Reinstall even if already installed").option("--minimal", "Minimal install (MVP-2)").option(
   "--shadow",
-  "Stage a V3 bootstrap candidate without changing live files"
+  "Stage a mancode bootstrap candidate without changing live files"
 ).action(async (platform, options) => {
   const code = await install(
     process.cwd(),
@@ -43301,15 +43536,15 @@ program.command("uninstall [platform]").description("Remove platform adapter or
 program.command("workflow <subcommand> [args...]").description("Manage mancode workflows").option("--dry-run", "Preview clean without deleting").option("--older-than <duration>", "Clean workflows older than (e.g. 30d)").option("--step <n>", "Update workflow current step").option("--status <status>", "Update workflow status").option(
   "--parent-task <taskId>",
   "Parent /man or /manteam workflow for manba"
-).option("--parent <namespace:id>", "V3 parent TaskRef for a manba child").option(
+).option("--parent <namespace:id>", "Parent TaskRef for a manba child").option(
   "--participant <actorId>",
   "Invite a joined team participant",
   collectOption,
   []
-).option("--visibility <visibility>", "V3: local or shared").option("--coordination <coordination>", "V3: single or team").option("--session <id>", "V3 session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "V3 client identity (default: mancode-cli)").option("--expected-revision <n>", "V3 expected task revision for mutations").option("--child-revision <n>", "V3 expected child task revision for merge").option("--summary <text>", "Privacy-screened child result summary").option("--next-action <text>", "Next parent action after a child merge").option("--sync", "Publish shared V3 mutations through git-ref transport").option(
+).option("--visibility <visibility>", "Task visibility: local or shared").option("--coordination <coordination>", "Task coordination: single or team").option("--session <id>", "mancode session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--expected-revision <n>", "Expected task revision for mutations").option("--child-revision <n>", "Expected child task revision for merge").option("--summary <text>", "Privacy-screened child result summary").option("--next-action <text>", "Next parent action after a child merge").option("--sync", "Publish shared mutations through git-ref transport").option(
   "--confirm-shared",
-  "Confirm that task metadata may enter shared V3 authority"
-).option("--blocking-reason <reason>", "Explain why a workflow is blocked").option("--outcome <outcome>", "Set manba outcome when completing a V3 task").option("--plan-version <n>", "Set the next man/manteam plan revision").option(
+  "Confirm that task metadata may enter shared mancode authority"
+).option("--blocking-reason <reason>", "Explain why a workflow is blocked").option("--outcome <outcome>", "Set manba outcome when completing a task").option("--plan-version <n>", "Set the next man/manteam plan revision").option(
   "--requirements-status <status>",
   "Planning readiness: ready or needs_clarification"
 ).option(
@@ -43324,21 +43559,24 @@ program.command("workflow <subcommand> [args...]").description("Manage mancode w
 ).option("--blockers <ids>", "Comma-separated blocker ids found by a review").option(
   "--resolved <ids>",
   "Comma-separated blocker ids resolved in remediation"
-).option("--file <path>", "Structured requirements JSON input file").option("--acceptance <id>", "Acceptance criterion id (for example AC-1)").option("--method <method>", "Verification method: automated or manual").option("--result <result>", "Verification result").option("--evidence <text>", "Verification evidence or user confirmation").option("--command <command>", "Command used for automated verification").option("--exit-code <code>", "Exit code from automated verification").option("--evidence-file <path>", "Existing verification report or artifact").option("--reason <reason>", "Reason for an explicit review skip").option("--json", "Output as JSON (for scripts)").action(async (subcommand, args, options) => {
+).option(
+  "--file <path>",
+  "Semantic or canonical structured requirements JSON input file"
+).option("--acceptance <id>", "Acceptance criterion id (for example AC-1)").option("--method <method>", "Verification method: automated or manual").option("--result <result>", "Verification result").option("--evidence <text>", "Verification evidence or user confirmation").option("--command <command>", "Command used for automated verification").option("--exit-code <code>", "Exit code from automated verification").option("--evidence-file <path>", "Existing verification report or artifact").option("--reason <reason>", "Reason for an explicit review skip").option("--json", "Output as JSON (for scripts)").action(async (subcommand, args, options) => {
   const code = await workflow(process.cwd(), subcommand, args ?? [], {
     ...options,
     participants: options.participant.length === 0 ? void 0 : options.participant
   });
   process.exitCode = code;
 });
-var contextProgram = program.command("context").description("Resolve V3 task context and manage explicit sessions");
-contextProgram.command("show").description("Resolve one V3 Context Pack").option("--task <namespace:id>", "Explicit TaskRef").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--level <level>", "bootstrap, task, or full").option(
+var contextProgram = program.command("context").description("Resolve mancode task context and manage explicit sessions");
+contextProgram.command("show").description("Resolve one mancode Context Pack").option("--task <namespace:id>", "Explicit TaskRef").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--level <level>", "bootstrap, task, or full").option(
   "--purpose <purpose>",
   "orient, plan, implement, review, verify, or handoff"
 ).option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextShow(process.cwd(), options);
 });
-var contextSessionProgram = contextProgram.command("session").description("Manage V3 session identities");
+var contextSessionProgram = contextProgram.command("session").description("Manage mancode session identities");
 contextSessionProgram.command("new").description("Create an explicit bootstrap session").requiredOption("--client <name>", "Client identity").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextSessionNew(process.cwd(), options);
 });
@@ -43369,13 +43607,13 @@ contextSessionProgram.command("spike").description("Record real-host session evi
 ).option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextSessionSpike(process.cwd(), options);
 });
-contextProgram.command("resume <namespace:id>").description("Validate and bind the current session to a V3 TaskRef").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--sync", "Publish shared V3 mutations through git-ref transport").option("--json", "Output as JSON (for scripts)").action(async (task, options) => {
+contextProgram.command("resume <namespace:id>").description("Validate and bind the current session to a mancode TaskRef").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--sync", "Publish shared mutations through git-ref transport").option("--json", "Output as JSON (for scripts)").action(async (task, options) => {
   process.exitCode = await contextResume(process.cwd(), task, options);
 });
 contextProgram.command("close").description("Close one explicit session without affecting other sessions").requiredOption("--session <id>", "Session ID").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextClose(process.cwd(), options);
 });
-contextProgram.command("doctor").description("Inspect unfinished V3 operations or repair one explicitly").option(
+contextProgram.command("doctor").description("Inspect unfinished mancode operations or repair one explicitly").option(
   "--repair <operationId>",
   "Repair this operation with its original session"
 ).option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--json", "Output as JSON (for scripts)").action(async (options) => {
@@ -43384,10 +43622,10 @@ contextProgram.command("doctor").description("Inspect unfinished V3 operations o
 contextProgram.command("diagnostics [action]").description("Show or configure local aggregate diagnostics").option("--json", "Output as JSON (for scripts)").action(async (action, options) => {
   process.exitCode = await contextDiagnostics(process.cwd(), action, options);
 });
-contextProgram.command("compact").description("List and remove eligible V3 runtime retention candidates").option("--task <namespace:id>", "Compact checkpoints for one completed task").option("--dry-run", "Show the deletion list without changing files").option("--apply-shared", "Permit deletion for shared completed tasks").option("--json", "Output as JSON (for scripts)").action(async (options) => {
+contextProgram.command("compact").description("List and remove eligible mancode runtime retention candidates").option("--task <namespace:id>", "Compact checkpoints for one completed task").option("--dry-run", "Show the deletion list without changing files").option("--apply-shared", "Permit deletion for shared completed tasks").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextCompact(process.cwd(), options);
 });
-contextProgram.command("beta").description("Evaluate hard V3 Beta readiness gates").requiredOption(
+contextProgram.command("beta", { hidden: true }).description("Evaluate internal release-evidence gates").requiredOption(
   "--release-candidate <id>",
   "Release candidate that must match every platform evidence record"
 ).option("--json", "Output as JSON (for scripts)").action(async (options) => {
@@ -43414,11 +43652,13 @@ contextProgram.command("reconcile-task-head <shared:id>").description(
     options
   );
 });
-var contextWorktreeProgram = contextProgram.command("worktree").description("Register and inspect the current V3 checkout binding");
-contextWorktreeProgram.command("register").description("Register this linked worktree before using V3 coordination").option("--json", "Output as JSON (for scripts)").action(async (options) => {
+var contextWorktreeProgram = contextProgram.command("worktree").description("Register and inspect the current mancode checkout binding");
+contextWorktreeProgram.command("register").description(
+  "Register this linked worktree before using mancode coordination"
+).option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await contextWorktreeRegister(process.cwd(), options);
 });
-var operationProgram = program.command("operation").description("Inspect and recover durable V3 operations");
+var operationProgram = program.command("operation").description("Inspect and recover durable mancode operations");
 operationProgram.command("show <operationId>").description("Show one operation journal and its recovery disposition").option("--json", "Output as JSON (for scripts)").action(async (operationId, options) => {
   process.exitCode = await operationShow(process.cwd(), operationId, options);
 });
@@ -43438,11 +43678,11 @@ operationProgram.command("abort <operationId>").description(
     options
   );
 });
-var teamProgram = program.command("team").description("Manage V3 local identity and local-team membership");
-teamProgram.command("status").description("Show V3 team policy, transport, and local identity state").option("--json", "Output as JSON (for scripts)").action(async (options) => {
+var teamProgram = program.command("team").description("Manage mancode local identity and local-team membership");
+teamProgram.command("status").description("Show mancode team policy, transport, and local identity state").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await teamStatus(process.cwd(), options);
 });
-teamProgram.command("policy <mode>").description("Set the V3 team recommendation policy with a revision CAS").requiredOption("--expected-revision <n>", "Current team policy revision").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--json", "Output as JSON (for scripts)").action(async (policy, options) => {
+teamProgram.command("policy <mode>").description("Set the mancode team recommendation policy with a revision CAS").requiredOption("--expected-revision <n>", "Current team policy revision").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--json", "Output as JSON (for scripts)").action(async (policy, options) => {
   process.exitCode = await teamPolicy(process.cwd(), {
     ...options,
     policy
@@ -43516,7 +43756,7 @@ teamProgram.command("join").description(
 ).requiredOption("--name <displayName>", "Must match the local actor identity").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--sync", "Request explicit remote sync when transport supports it").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   process.exitCode = await teamJoin(process.cwd(), options);
 });
-teamProgram.command("checkpoint <namespace:id>").description("Create a journaled immutable checkpoint for a shared V3 task").requiredOption(
+teamProgram.command("checkpoint <namespace:id>").description("Create a journaled immutable checkpoint for a shared task").requiredOption(
   "--expected-task-revision <n>",
   "Current shared task revision"
 ).requiredOption("--kind <kind>", "Checkpoint kind").requiredOption("--summary <text>", "Privacy-safe checkpoint summary").option("--next-action <text>", "Next action for the receiving workflow").option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--json", "Output as JSON (for scripts)").action(async (task, options) => {
@@ -43525,7 +43765,7 @@ teamProgram.command("checkpoint <namespace:id>").description("Create a journaled
     task
   });
 });
-teamProgram.command("claim <namespace:id>").description("Acquire a scoped claim for a shared V3 task").requiredOption(
+teamProgram.command("claim <namespace:id>").description("Acquire a scoped claim for a shared task").requiredOption(
   "--expected-task-revision <n>",
   "Current shared task revision"
 ).option("--path <glob>", "Repository-relative path glob", collectOption, []).option("--module <name>", "Implementation module", collectOption, []).option("--api <name>", "Public API boundary", collectOption, []).option("--schema <name>", "Shared schema boundary", collectOption, []).option("--session <id>", "Session ID (otherwise MANCODE_SESSION_ID)").option("--client <name>", "Client identity (default: mancode-cli)").option("--sync", "Publish through the active git-ref authority").option("--json", "Output as JSON (for scripts)").action(async (task, options) => {
@@ -43602,18 +43842,21 @@ teamHandoffProgram.command("cancel <handoffId>").description("Cancel a draft or
     handoffId
   });
 });
-var migrateProgram = program.command("migrate").description("Inspect and migrate legacy mancode context into V3 staging");
-var migrateContextProgram = migrateProgram.command("context").description("Manage the isolated legacy-to-V3 context migration stage").option("--dry-run", "Inspect legacy authority without writing files").option("--stage", "Create or refresh an isolated local migration stage").option("--status", "Show local migration stages").option("--activate", "Attempt the journaled V3 activation").option("--rollback <operationId>", "Roll back an untouched V3 activation").option("--stage-id <id>", "Migration stage ID (required if more than one)").option(
+var migrateProgram = program.command("migrate").description("Inspect and migrate legacy context into mancode staging");
+var migrateContextProgram = migrateProgram.command("context").description("Manage the isolated legacy-to-mancode context migration stage").option("--dry-run", "Inspect legacy authority without writing files").option("--stage", "Create or refresh an isolated local migration stage").option("--status", "Show local migration stages").option("--activate", "Attempt the journaled mancode activation").option(
+  "--rollback <operationId>",
+  "Roll back an untouched mancode activation"
+).option("--stage-id <id>", "Migration stage ID (required if more than one)").option(
   "--expected-stage-revision <n>",
   "Expected stage revision for activation"
-).option("--session <id>", "Active session required for activation").option("--confirm", "Explicitly confirm the V3 cutover").option("--confirm-shared", "Confirm promotion of staged shared authority").option("--json", "Output as JSON (for scripts)").action(async (options) => {
+).option("--session <id>", "Active session required for activation").option("--confirm", "Explicitly confirm the mancode cutover").option("--confirm-shared", "Confirm promotion of staged shared authority").option("--json", "Output as JSON (for scripts)").action(async (options) => {
   const code = await migrateContext(process.cwd(), options);
   process.exitCode = code;
 });
 migrateContextProgram.command("resolve <legacyTaskId>").description("Resolve missing owner or implementation scope in one stage").requiredOption(
   "--expected-stage-revision <n>",
   "Expected local migration stage revision"
-).option("--stage-id <id>", "Migration stage ID (required if more than one)").option("--owner <actorId>", "Explicit V3 owner actor ID").option(
+).option("--stage-id <id>", "Migration stage ID (required if more than one)").option("--owner <actorId>", "Explicit owner actor ID").option(
   "--scope-file <path>",
   "JSON implementation scope {include,exclude,modules}"
 ).option("--json", "Output as JSON (for scripts)").action(async (legacyTaskId, options) => {