mancode 0.3.12 → 0.3.13

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
   replaceManagedBlock,
   stageV3Adapter,
   v3AdapterTargetPath
-} from "./chunk-CFC3HBNA.js";
+} from "./chunk-L3TKSX6R.js";
 import {
   PROJECT_MANIFESTS,
   V3ContextStore,
@@ -126,7 +126,7 @@ import {
 } from "./chunk-O3QAKAPJ.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";
@@ -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-DDZB3Y6S.js");
+        const { applyV3AdapterFilePlan: applyV3AdapterFilePlan2 } = await import("./v3-adapter-CPZNFTJR.js");
         await applyV3AdapterFilePlan2(root, action);
       }
       journal = await completeActivationStep(
@@ -19835,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."
     );
   }
 }
@@ -19953,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."
     );
   }
 }
@@ -20098,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."
     );
   }
 }
@@ -20151,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."
       );
     }
   }
@@ -20181,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."
     );
   }
 }
@@ -20251,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."
     );
   }
 }
@@ -24790,7 +24794,7 @@ async function init(rootDir = process5.cwd(), options = {}) {
   }
   if (authority === "legacy" && await pathExists6(v3SchemaFile)) {
     console.error(
-      "\u2717  V3 authority is already present; refusing to create legacy state.json."
+      "\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."
@@ -25216,14 +25220,14 @@ 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;
   }
   if (options.style !== void 0) {
     console.error("\u2717  --style is only supported by `mancode init --legacy`.");
     console.error(
-      "   V3 detects project facts; run `mancode refresh-style` after initialization to refresh local style tokens."
+      "   mancode detects project facts; run `mancode refresh-style` after initialization to refresh local style tokens."
     );
     return EXIT_INIT_FAILED;
   }
@@ -25241,7 +25245,7 @@ async function initializeV3(rootDir, options) {
       }
       existingV3 = true;
       if (options.platform === void 0) {
-        console.log("\u2139\uFE0F  mancode V3 is already initialized.");
+        console.log("\u2139\uFE0F  mancode is already initialized.");
         return EXIT_ALREADY_INITIALIZED;
       }
     } catch (error) {
@@ -25275,10 +25279,10 @@ async function initializeV3(rootDir, options) {
       for (const platform of selectedPlatforms) {
         await installV3Adapter(rootDir, platform);
       }
-      console.log("\u2139\uFE0F  mancode V3 is already initialized.");
+      console.log("\u2139\uFE0F  mancode is already initialized.");
       if (selectedPlatforms.length > 0) {
         console.log(
-          `   V3 bootstrap repaired: ${selectedPlatforms.join(", ")}`
+          `   mancode bootstrap repaired: ${selectedPlatforms.join(", ")}`
         );
       }
       return EXIT_ALREADY_INITIALIZED;
@@ -25290,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) {
@@ -25303,7 +25307,7 @@ 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) {
@@ -25312,7 +25316,7 @@ async function initializeV3(rootDir, options) {
   }
 }
 function printV3InitError(error) {
-  const message = error instanceof Error ? error.message : "V3 initialization failed";
+  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.");
@@ -25690,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)) {
@@ -25787,7 +25793,7 @@ async function installV3(rootDir, platform, options) {
       }
       const staged = await stageV3Adapter(rootDir, installer.name);
       console.log(
-        `\u2713  ${formatPlatformName(platform)} V3 bootstrap and original mode entries 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) {
@@ -25800,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;
   }
@@ -25920,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) {
@@ -25928,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("");
@@ -26375,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",
@@ -26394,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/")
@@ -26893,7 +26905,7 @@ async function manps(rootDir, area = "all", options = {}) {
   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 V3 activation is ${v3Activation}`;
+    const message = `manps is unavailable while mancode activation is ${v3Activation}`;
     if (options.json) {
       console.log(JSON.stringify({ error: "scan failed", message }, null, 2));
     } else {
@@ -27404,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;
   }
 }
@@ -27663,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(
@@ -27687,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...");
@@ -27707,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;
   }
 }
@@ -28398,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})` : ""}`
@@ -28432,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";
@@ -28448,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)`;
@@ -36898,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;
   }
@@ -36914,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;
   }
 }
@@ -41364,6 +41383,80 @@ 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;
@@ -41378,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) {
@@ -41465,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) {
@@ -41482,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
     );
   }
@@ -41490,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
     );
   }
@@ -41499,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
     );
   }
@@ -41554,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."
     );
   }
 }
@@ -41606,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."
     );
   }
 }
@@ -41663,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."
     );
   }
 }
@@ -41723,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."
       );
     }
   }
@@ -41753,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."
     );
   }
 }
@@ -41835,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."
     );
   }
 }
@@ -41908,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."
     );
   }
 }
@@ -41958,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."
     );
   }
 }
@@ -42009,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."
     );
   }
 }
@@ -42083,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."
     );
   }
 }
@@ -42110,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
@@ -42136,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."
     );
   }
 }
@@ -42230,7 +42325,7 @@ 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."
     );
   }
 }
@@ -43405,7 +43500,7 @@ 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 V3 authority explicitly (the CLI default)").option("--legacy", "Use the legacy state.json 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,
@@ -43417,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(),
@@ -43441,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(
@@ -43464,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);
 });
@@ -43509,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) => {
@@ -43524,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) => {
@@ -43554,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);
 });
@@ -43578,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
@@ -43656,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) => {
@@ -43665,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) => {
@@ -43742,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) => {