mancode 0.3.10 → 0.3.12

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-CFC3HBNA.js";
 import {
   PROJECT_MANIFESTS,
   V3ContextStore,
@@ -105,22 +124,6 @@ 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-KEIW7AEP.js";
 
 // src/cli.ts
 import { program } from "commander";
@@ -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,
@@ -11499,7 +11499,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-3GJT3AID.js");
+        const { applyV3AdapterFilePlan: applyV3AdapterFilePlan2 } = await import("./v3-adapter-DDZB3Y6S.js");
         await applyV3AdapterFilePlan2(root, action);
       }
       journal = await completeActivationStep(
@@ -11645,6 +11645,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 +11943,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 +14216,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);
@@ -24762,9 +24765,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 +24788,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  V3 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 +24834,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"));
@@ -25188,13 +25220,69 @@ async function initializeV3(rootDir, options) {
     );
     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(
+      "   V3 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 V3 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 V3 is already initialized.");
+      if (selectedPlatforms.length > 0) {
+        console.log(
+          `   V3 bootstrap repaired: ${selectedPlatforms.join(", ")}`
+        );
+      }
+      return EXIT_ALREADY_INITIALIZED;
+    }
     const result2 = await initializeV3Project({
       projectRoot: rootDir,
       teamPolicy: options.team === void 0 ? "auto" : options.team ? "on" : "off"
@@ -25219,14 +25307,17 @@ async function initializeV3(rootDir, options) {
     }
     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 : "V3 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 +25437,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}`);
@@ -25674,9 +25787,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)} V3 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") {
@@ -25853,7 +25969,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 +26059,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 +26085,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 +26093,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(
@@ -26781,7 +26890,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 V3 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 +26915,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 +27013,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 +27026,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 +27037,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 +27059,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 +27206,7 @@ async function readScopeFile(rootDir, file) {
   }
   try {
     return JSON.parse(
-      await readFile35(resolved, "utf8")
+      await readFile36(resolved, "utf8")
     );
   } catch (error) {
     if (error instanceof SyntaxError) {
@@ -29742,7 +29881,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 +32613,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 +32636,7 @@ async function listJournals2(projectRoot) {
     journals.push(
       parseJournal3(
         JSON.parse(
-          await readFile36(
+          await readFile37(
             path56.join(journalDirectory2(projectRoot), entry),
             "utf8"
           )
@@ -32512,7 +32651,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 +33123,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 +35274,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 +35321,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 +36853,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;
@@ -36823,7 +36962,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 +37039,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 +37058,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 +37073,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 +37092,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 +37137,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 +39595,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 +40380,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");
@@ -41230,7 +41369,7 @@ 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);
   }
@@ -42032,7 +42171,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));
@@ -42095,11 +42234,11 @@ async function workflowCreateV3(rootDir, args, options) {
     );
   }
 }
-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 +42292,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 +42485,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 +42655,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 +42897,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 +42972,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 +43046,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 +43109,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 +43140,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 +43405,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").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) => {
   const code = await init(process.cwd(), {
     ...options,
+    fromCli: true,
     interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY)
   });
   process.exitCode = code;