lee-spec-kit 0.9.6 → 0.9.7

package/dist/index.js

@@ -167,6 +167,7 @@ var koCli = {
   "config.fullstackRepoRequired": "Multi \uD504\uB85C\uC81D\uD2B8\uB294 --component\uB85C \uB300\uC0C1 \uCEF4\uD3EC\uB10C\uD2B8\uB97C \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4.",
   "config.projectRootSet": "\u2705 {repo} projectRoot \uC124\uC815 \uC644\uB8CC: {path}",
   "config.projectRootSetSingle": "\u2705 projectRoot \uC124\uC815 \uC644\uB8CC: {path}",
+  "config.workflowUpdated": "\u2705 \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC124\uC815\uC744 \uC5C5\uB370\uC774\uD2B8\uD588\uC2B5\uB2C8\uB2E4.",
   "update.start": "\u{1F4E6} \uD15C\uD50C\uB9BF \uC5C5\uB370\uC774\uD2B8\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4...",
   "update.langLabel": "\uC5B8\uC5B4",
   "update.typeLabel": "\uD0C0\uC785",
@@ -179,6 +180,7 @@ var koCli = {
   "update.fileUpdated": "{file} \uC5C5\uB370\uC774\uD2B8",
   "update.gitStatusUnavailable": "git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (git repo\uAC00 \uC544\uB2C8\uAC70\uB098 git \uC2E4\uD589 \uBD88\uAC00) --force\uB85C \uAC15\uC81C \uB36E\uC5B4\uC4F0\uAE30\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
   "update.docsWorktreeDirty": "docs \uC791\uC5C5\uD2B8\uB9AC\uC5D0 \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC788\uC5B4 update\uB97C \uC9C4\uD589\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBCC0\uACBD\uC0AC\uD56D\uC744 \uCEE4\uBC0B/\uC2A4\uD0DC\uC2DC \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uAC70\uB098 --force\uB85C \uB36E\uC5B4\uC4F0\uC138\uC694.",
+  "update.legacyAutomationSafe": "\uAE30\uC874 \uD504\uB85C\uC81D\uD2B8\uB294 \uBA85\uC2DC\uC801\uC73C\uB85C \uC0AC\uC6A9\uD55C \uACBD\uC6B0\uAC00 \uC544\uB2C8\uBA74 \uC0C8 Task \uC704\uC784\uACFC Plan/Task \uAC80\uC218\uB97C \uAEBC\uC9C4 \uC0C1\uD0DC\uB85C \uC720\uC9C0\uD569\uB2C8\uB2E4. `npx lee-spec-kit config --interactive` \uB610\uB294 config \uD50C\uB798\uADF8\uB85C \uC124\uC815\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
   "init.selectLangPrompt": "\uBB38\uC11C \uC5B8\uC5B4\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
   "init.currentDirectoryLabel": "\u{1F4CD} \uD604\uC7AC \uC704\uCE58",
   "init.gitDetected": "\u2705 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0\uB428",
@@ -481,6 +483,7 @@ var enCli = {
   "config.fullstackRepoRequired": "For multi projects, specify a target component via `--component`.",
   "config.projectRootSet": "\u2705 {repo} projectRoot set: {path}",
   "config.projectRootSetSingle": "\u2705 projectRoot set: {path}",
+  "config.workflowUpdated": "\u2705 Workflow configuration updated.",
   "update.start": "\u{1F4E6} Starting template update...",
   "update.langLabel": "Lang",
   "update.typeLabel": "Type",
@@ -493,6 +496,7 @@ var enCli = {
   "update.fileUpdated": "{file} updated",
   "update.gitStatusUnavailable": "Cannot determine git status (not a git repo or git unavailable). Use --force to overwrite.",
   "update.docsWorktreeDirty": "Docs working tree has changes. Commit/stash your changes, or run with --force to overwrite.",
+  "update.legacyAutomationSafe": "Existing projects keep newly introduced task delegation and Plan/Task review disabled unless they had explicitly opted in. Configure them with `npx lee-spec-kit config --interactive` or the config flags.",
   "init.selectLangPrompt": "Select docs language:",
   "init.currentDirectoryLabel": "\u{1F4CD} Current directory",
   "init.gitDetected": "\u2705 Git repository detected",
@@ -1374,9 +1378,12 @@ Before taking the next workflow step:
 16. When \`workflow-stage --json\` returns \`nextAction.category === "task_review"\` with \`executor === "subagent"\`, delegate a fresh read-only review for the returned \`taskId\`, \`baseSha\`, \`targetSha\`, and \`targetTree\`; the main agent records the returned reviewRound and evidence and moves the task from \`REVIEW\` to \`DONE\` only after an approve decision
 17. When \`workflow-stage --json\` returns \`nextAction.category === "pre_pr_review"\` and \`nextAction.executor === "subagent"\`, delegate a fresh read-only Feature review using the returned \`model\`, \`reasoningEffort\`, \`onUnavailable\`, reviewRound, and review target metadata; do not select or require a named review skill
 18. Review subagents return findings without modifying code; the main agent remediates findings and records the actual reviewer metadata, reviewed scope, evidence, decision, and exact hash/SHA/tree target metadata
-19. workflow.agentReview.maxRounds counts automatic finding-remediation passes, not the initial review. After those passes are exhausted, keep the latest changes_requested findings as residual risks and automatically complete that Plan/task/Feature review gate without asking the user for a review-approval token; blocked decisions never auto-complete
-20. For a local workflow, do not report completion directly after implementation approval; follow the exact returned \`local verify\` / \`local merge\` / \`local cleanup\` commands until \`workflow-stage\` proves verification, integration, and cleanup and returns \`done\`; review-fix and \`feature_remediation\` stages explicitly permit scoped fixes
-21. In a \`local-ff\` or \`local-squash\` workflow, keep implementation approval and local merge approval distinct when \`local_merge\` is required: the first accepts the implementation, and the second authorizes the configured integration strategy, post-merge checks, and local cleanup
+19. After delegating to a subagent, wait until it returns a terminal outcome: completed, explicit failure, cancellation, or an approval/user-input request that requires action
+20. While the subagent remains running, use repeated bounded waits, preferably longer waits. A bounded wait that returns no update, a lack of status messages, or a lack of file changes means only that the subagent is still pending; none is evidence of failure or stalled work. Read-only review subagents are expected not to modify files
+21. Do not interrupt, replace, or abandon a running subagent solely because it has been quiet or has not changed files. Stop it only after an explicit user request, a terminal failure/cancellation, or an unrecoverable runtime status
+22. workflow.agentReview.maxRounds counts automatic finding-remediation passes, not the initial review. After those passes are exhausted, keep the latest changes_requested findings as residual risks and automatically complete that Plan/task/Feature review gate without asking the user for a review-approval token; blocked decisions never auto-complete
+23. For a local workflow, do not report completion directly after implementation approval; follow the exact returned \`local verify\` / \`local merge\` / \`local cleanup\` commands until \`workflow-stage\` proves verification, integration, and cleanup and returns \`done\`; review-fix and \`feature_remediation\` stages explicitly permit scoped fixes
+24. In a \`local-ff\` or \`local-squash\` workflow, keep implementation approval and local merge approval distinct when \`local_merge\` is required: the first accepts the implementation, and the second authorizes the configured integration strategy, post-merge checks, and local cleanup
 
 Approval and remote actions:
 
@@ -1696,6 +1703,7 @@ function toProjectConfig(docsDir, configFile, projectType, components) {
   return {
     schemaId: "lee-spec",
     docsDir,
+    createdAt: configFile.createdAt,
     projectName: configFile.projectName,
     projectType,
     components: projectType === "multi" ? components : void 0,
@@ -2865,6 +2873,7 @@ async function runInit(options) {
             featureChecks: [],
             postMergeChecks: []
           } : {},
+          agentAutomationConfigured: true,
           agentExecution: {
             task: {
               ...createDefaultAgentExecutionTaskConfig(),
@@ -3816,6 +3825,50 @@ function migrateLegacyApprovalSettings(approval) {
   return { approval, changedPaths };
 }
 
+// src/config/agent-automation.ts
+var AGENT_AUTOMATION_OPT_IN_INIT_DATE = "2026-08-27";
+function isPlainRecord2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function matchesGeneratedAgentRuntime(value, options = {}) {
+  if (!isPlainRecord2(value)) return false;
+  const expectedKeys = [
+    ...typeof options.enabled === "boolean" ? ["enabled"] : [],
+    "model",
+    "onUnavailable",
+    "reasoningEffort",
+    "type"
+  ].sort();
+  if (JSON.stringify(Object.keys(value).sort()) !== JSON.stringify(expectedKeys)) {
+    return false;
+  }
+  return (typeof options.enabled !== "boolean" || value.enabled === options.enabled) && value.type === "subagent" && value.model === "inherit" && value.reasoningEffort === "high" && value.onUnavailable === "inherit";
+}
+function matchesGeneratedReviewPhase(value, enabled) {
+  if (!isPlainRecord2(value)) return false;
+  if (JSON.stringify(Object.keys(value).sort()) !== JSON.stringify(["enabled", "evidenceMode", "reviewer"])) {
+    return false;
+  }
+  return value.enabled === enabled && value.evidenceMode === "path_required" && matchesGeneratedAgentRuntime(value.reviewer);
+}
+function resolveLegacyBackfilledAgentAutomation(config) {
+  const none = { taskExecution: false, planReview: false };
+  if (!isPlainRecord2(config.workflow)) return none;
+  const workflow = config.workflow;
+  if (workflow.agentAutomationConfigured === true) return none;
+  const createdAt = typeof config.createdAt === "string" ? config.createdAt.trim() : "";
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(createdAt)) return none;
+  if (createdAt >= AGENT_AUTOMATION_OPT_IN_INIT_DATE) return none;
+  const taskExecution = isPlainRecord2(workflow.agentExecution) ? workflow.agentExecution.task : null;
+  const planReview = isPlainRecord2(workflow.agentReview) ? workflow.agentReview.plan : null;
+  return {
+    taskExecution: matchesGeneratedAgentRuntime(taskExecution, {
+      enabled: true
+    }),
+    planReview: matchesGeneratedReviewPhase(planReview, true)
+  };
+}
+
 // src/commands/update.ts
 function hasOwnKey2(value, key) {
   return Object.prototype.hasOwnProperty.call(value, key);
@@ -3903,7 +3956,9 @@ async function runUpdate(options) {
       const updateAgents = options.agents || !hasExplicitSelection;
       const updateAgentsMd = options.agentsMd || !hasExplicitSelection;
       console.log(chalk.blue(tr(lang, "cli", "update.start")));
-      console.log(chalk.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`));
+      console.log(
+        chalk.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`)
+      );
       console.log(
         chalk.gray(`  - ${tr(lang, "cli", "update.typeLabel")}: ${projectType}`)
       );
@@ -3911,7 +3966,12 @@ async function runUpdate(options) {
       let updatedCount = 0;
       if (updateAgents) {
         console.log(chalk.blue(tr(lang, "cli", "update.updatingAgents")));
-        const commonAgentsBase = path8.join(templatesDir, lang, "common", "agents");
+        const commonAgentsBase = path8.join(
+          templatesDir,
+          lang,
+          "common",
+          "agents"
+        );
         const targetAgentsBase = path8.join(docsDir, "agents");
         const commonAgents = commonAgentsBase;
         const targetAgents = targetAgentsBase;
@@ -3940,13 +4000,14 @@ async function runUpdate(options) {
           updatedCount += count;
         }
         console.log(
-          chalk.green(
-            `  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`
-          )
+          chalk.green(`  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`)
         );
       }
       if (updateAgentsMd) {
-        const agentsMdTargets = await collectAgentsMdTargets(cwd, currentConfig);
+        const agentsMdTargets = await collectAgentsMdTargets(
+          cwd,
+          currentConfig
+        );
         for (const target of agentsMdTargets) {
           const result = await upsertLeeSpecKitAgentsMd(target, {
             lang,
@@ -3975,13 +4036,24 @@ async function runUpdate(options) {
           )
         );
         console.log(
-          chalk.gray(
-            `    (${configBackfill.changedPaths.join(", ")})`
-          )
+          chalk.gray(`    (${configBackfill.changedPaths.join(", ")})`)
         );
+        if (configBackfill.changedPaths.includes(
+          "workflow.agentExecution.task.enabled"
+        ) || configBackfill.changedPaths.includes(
+          "workflow.agentReview.plan.enabled"
+        )) {
+          console.log(
+            chalk.yellow(
+              `  - ${tr(lang, "cli", "update.legacyAutomationSafe")}`
+            )
+          );
+        }
       }
       console.log(
-        chalk.green(`\u2705 ${tr(lang, "cli", "update.updatedTotal", { count: updatedCount })}`)
+        chalk.green(
+          `\u2705 ${tr(lang, "cli", "update.updatedTotal", { count: updatedCount })}`
+        )
       );
     },
     { owner: "update" }
@@ -4050,6 +4122,7 @@ async function backfillMissingConfigDefaults(cwd, docsDir) {
   }
   const workflow = raw.workflow;
   changedPaths.push(...migrateLegacyWorkflowSettings(workflow));
+  const restoreLegacyAgentAutomationDefaults = resolveLegacyBackfilledAgentAutomation(raw);
   setIfMissing(
     workflow,
     "requireWorktree",
@@ -4154,11 +4227,15 @@ async function backfillMissingConfigDefaults(cwd, docsDir) {
   setIfMissing(
     taskExecution,
     "enabled",
-    defaultTaskExecution.enabled,
+    false,
     "workflow.agentExecution.task.enabled"
   );
   if (typeof taskExecution.enabled !== "boolean") {
-    taskExecution.enabled = defaultTaskExecution.enabled;
+    taskExecution.enabled = false;
+    changedPaths.push("workflow.agentExecution.task.enabled");
+  }
+  if (restoreLegacyAgentAutomationDefaults.taskExecution && taskExecution.enabled !== false) {
+    taskExecution.enabled = false;
     changedPaths.push("workflow.agentExecution.task.enabled");
   }
   if (taskExecution.type !== "subagent") {
@@ -4248,14 +4325,17 @@ async function backfillMissingConfigDefaults(cwd, docsDir) {
       changedPaths.push(`${phasePath}.reviewer.onUnavailable`);
     }
   };
-  normalizeAgentReviewPhase("plan", true);
+  normalizeAgentReviewPhase("plan", false);
+  if (restoreLegacyAgentAutomationDefaults.planReview) {
+    const planReview = agentReview.plan;
+    if (planReview.enabled !== false) {
+      planReview.enabled = false;
+      changedPaths.push("workflow.agentReview.plan.enabled");
+    }
+  }
   normalizeAgentReviewPhase("task", false);
   const legacyFeatureEnabled = typeof legacyPrePrReview?.enabled === "boolean" ? legacyPrePrReview.enabled : workflow.mode !== "local";
-  normalizeAgentReviewPhase(
-    "feature",
-    legacyFeatureEnabled,
-    legacyPrePrReview
-  );
+  normalizeAgentReviewPhase("feature", legacyFeatureEnabled, legacyPrePrReview);
   if (hasOwnKey2(workflow, "prePrReview")) {
     delete workflow.prePrReview;
     changedPaths.push("workflow.prePrReview");
@@ -4383,11 +4463,15 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   if (!top) return null;
   const rel = path8.relative(top, docsDir) || ".";
   try {
-    const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
-      cwd: top,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "ignore"]
-    });
+    const output = execFileSync(
+      "git",
+      ["status", "--porcelain=v1", "--", rel],
+      {
+        cwd: top,
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "ignore"]
+      }
+    );
     if (ignoredAbsPaths.length === 0) {
       return output;
     }
@@ -4423,8 +4507,62 @@ async function isDocsWorktreeCleanOrThrow(docsDir, lang, ignoredAbsPaths = []) {
   }
   return true;
 }
+var CONFIG_REVIEW_PHASES = ["plan", "task", "feature"];
+function isPlainObject2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function parseReviews(value) {
+  if (typeof value === "undefined") return void 0;
+  const normalized = value.split(",").map((entry) => entry.trim().toLowerCase()).filter(Boolean);
+  if (normalized.length === 1 && normalized[0] === "none") return [];
+  if (normalized.length === 0 || normalized.includes("none") || normalized.some(
+    (entry) => !CONFIG_REVIEW_PHASES.includes(entry)
+  )) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--reviews` must be a comma-separated subset of `plan,task,feature`, or `none`."
+    );
+  }
+  return CONFIG_REVIEW_PHASES.filter((phase) => normalized.includes(phase));
+}
+function parseMaxReviewRounds(value) {
+  if (typeof value === "undefined") return void 0;
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--max-review-rounds` must be a positive integer."
+    );
+  }
+  return parsed;
+}
+function validateWorkflowOptions(options) {
+  if (options.taskAgent && !["on", "off"].includes(options.taskAgent)) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--task-agent` must be `on` or `off`."
+    );
+  }
+  if (options.completionStrategy && !["local-ff", "local-squash", "none"].includes(options.completionStrategy)) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--completion-strategy` must be `local-ff`, `local-squash`, or `none`."
+    );
+  }
+  parseReviews(options.reviews);
+  parseMaxReviewRounds(options.maxReviewRounds);
+}
 function configCommand(program2) {
-  program2.command("config").description("View or modify project configuration").option("--dir <dir>", "Docs directory or project path to target").option("--project-root <path>", "Set project root path").option("--component <component>", "Component name for multi projects").option("--non-interactive", "Fail instead of prompting for input").action(async (options) => {
+  program2.command("config").description("View or modify project configuration").option("--dir <dir>", "Docs directory or project path to target").option("--project-root <path>", "Set project root path").option("--component <component>", "Component name for multi projects").option("--task-agent <mode>", "Task implementation agent: on | off").option(
+    "--reviews <list>",
+    "Review gates: comma-separated plan,task,feature | none"
+  ).option(
+    "--max-review-rounds <count>",
+    "Automatic review finding remediation rounds before continuing with residual risks"
+  ).option(
+    "--completion-strategy <strategy>",
+    "Local completion: local-ff | local-squash | none"
+  ).option("--interactive", "Configure workflow options interactively").option("--non-interactive", "Fail instead of prompting for input").action(async (options) => {
     try {
       await runConfig(options);
     } catch (error) {
@@ -4450,6 +4588,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
   });
 }
 async function runConfig(options) {
+  validateWorkflowOptions(options);
   const cwd = process.cwd();
   const targetCwd = options.dir ? path8.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
@@ -4460,7 +4599,8 @@ async function runConfig(options) {
     );
   }
   const configPath = path8.join(config.docsDir, ".lee-spec-kit.json");
-  if (!options.projectRoot) {
+  const hasWorkflowOptions = typeof options.taskAgent !== "undefined" || typeof options.reviews !== "undefined" || typeof options.maxReviewRounds !== "undefined" || typeof options.completionStrategy !== "undefined" || !!options.interactive;
+  if (!options.projectRoot && !hasWorkflowOptions) {
     console.log();
     console.log(chalk.blue(tr(config.lang, "cli", "config.currentTitle")));
     console.log();
@@ -4475,85 +4615,21 @@ async function runConfig(options) {
     console.log();
     return;
   }
-  const projectRoot = options.projectRoot;
   await withFileLock(
     getDocsLockPath(config.docsDir),
     async () => {
       const configFile = await fs.readJson(configPath);
-      if (configFile.docsRepo !== "standalone") {
-        console.log(
-          chalk.yellow(tr(config.lang, "cli", "config.projectRootStandaloneOnly"))
+      if (!isPlainObject2(configFile)) {
+        throw createCliError(
+          "PRECONDITION_FAILED",
+          "Invalid project configuration."
         );
-        return;
       }
-      const projectType = normalizeProjectType(String(configFile.projectType || "single"));
-      const targetFromOptions = options.component?.trim().toLowerCase();
-      if (projectType === "multi") {
-        const components = resolveProjectComponents(projectType, configFile.components);
-        let targetComponent = targetFromOptions;
-        if (!targetComponent) {
-          if (components.length === 1) {
-            targetComponent = components[0];
-          } else if (options.nonInteractive) {
-            throw createCliError(
-              "PROMPT_BLOCKED",
-              "`--component` is required for multi projectRoot update when using `--non-interactive`."
-            );
-          } else {
-            const response = await prompts(
-              [
-                {
-                  type: "select",
-                  name: "component",
-                  message: tr(config.lang, "cli", "config.selectRepoToUpdate"),
-                  choices: components.map((value) => ({
-                    title: value.toUpperCase(),
-                    value
-                  }))
-                }
-              ],
-              {
-                onCancel: () => {
-                  throw new Error("canceled");
-                }
-              }
-            );
-            targetComponent = response.component;
-          }
-        }
-        if (!targetComponent) {
-          throw createCliError(
-            "INVALID_ARGUMENT",
-            "Component selection is required."
-          );
-        }
-        assertAllowedComponent(targetComponent, components);
-        const currentRoot = typeof configFile.projectRoot === "object" && configFile.projectRoot ? configFile.projectRoot : {};
-        currentRoot[targetComponent] = projectRoot;
-        configFile.projectRoot = currentRoot;
-        console.log(
-          chalk.green(
-            tr(config.lang, "cli", "config.projectRootSet", {
-              repo: targetComponent.toUpperCase(),
-              path: projectRoot
-            })
-          )
-        );
-      } else {
-        if (targetFromOptions) {
-          throw createCliError(
-            "INVALID_ARGUMENT",
-            "`--component` is only valid for multi projectRoot updates."
-          );
-        }
-        configFile.projectRoot = projectRoot;
-        console.log(
-          chalk.green(
-            tr(config.lang, "cli", "config.projectRootSetSingle", {
-              path: projectRoot
-            })
-          )
-        );
+      if (options.projectRoot) {
+        await updateProjectRoot(configFile, options, config.lang);
+      }
+      if (hasWorkflowOptions) {
+        await updateWorkflowConfig(configFile, options, config.lang);
       }
       await fs.writeJson(configPath, configFile, { spaces: 2 });
       console.log();
@@ -4561,6 +4637,255 @@ async function runConfig(options) {
     { owner: "config" }
   );
 }
+async function updateProjectRoot(configFile, options, lang) {
+  if (configFile.docsRepo !== "standalone") {
+    console.log(
+      chalk.yellow(tr(lang, "cli", "config.projectRootStandaloneOnly"))
+    );
+    return;
+  }
+  const projectRoot = options.projectRoot;
+  if (!projectRoot) return;
+  const projectType = normalizeProjectType(
+    String(configFile.projectType || "single")
+  );
+  const targetFromOptions = options.component?.trim().toLowerCase();
+  if (projectType === "multi") {
+    const components = resolveProjectComponents(
+      projectType,
+      configFile.components
+    );
+    let targetComponent = targetFromOptions;
+    if (!targetComponent) {
+      if (components.length === 1) {
+        targetComponent = components[0];
+      } else if (options.nonInteractive) {
+        throw createCliError(
+          "PROMPT_BLOCKED",
+          "`--component` is required for multi projectRoot update when using `--non-interactive`."
+        );
+      } else {
+        const response = await prompts(
+          [
+            {
+              type: "select",
+              name: "component",
+              message: tr(lang, "cli", "config.selectRepoToUpdate"),
+              choices: components.map((value) => ({
+                title: value.toUpperCase(),
+                value
+              }))
+            }
+          ],
+          {
+            onCancel: () => {
+              throw new Error("canceled");
+            }
+          }
+        );
+        targetComponent = response.component;
+      }
+    }
+    if (!targetComponent) {
+      throw createCliError(
+        "INVALID_ARGUMENT",
+        "Component selection is required."
+      );
+    }
+    assertAllowedComponent(targetComponent, components);
+    const currentRoot = isPlainObject2(
+      configFile.projectRoot
+    ) ? Object.fromEntries(
+      Object.entries(configFile.projectRoot).filter(
+        (entry) => typeof entry[1] === "string"
+      )
+    ) : {};
+    currentRoot[targetComponent] = projectRoot;
+    configFile.projectRoot = currentRoot;
+    console.log(
+      chalk.green(
+        tr(lang, "cli", "config.projectRootSet", {
+          repo: targetComponent.toUpperCase(),
+          path: projectRoot
+        })
+      )
+    );
+  } else {
+    if (targetFromOptions) {
+      throw createCliError(
+        "INVALID_ARGUMENT",
+        "`--component` is only valid for multi projectRoot updates."
+      );
+    }
+    configFile.projectRoot = projectRoot;
+    console.log(
+      chalk.green(
+        tr(lang, "cli", "config.projectRootSetSingle", {
+          path: projectRoot
+        })
+      )
+    );
+  }
+}
+function ensureWorkflow(configFile) {
+  if (!isPlainObject2(configFile.workflow)) configFile.workflow = {};
+  return configFile.workflow;
+}
+function ensureTaskExecution(workflow) {
+  if (!isPlainObject2(workflow.agentExecution)) workflow.agentExecution = {};
+  const agentExecution = workflow.agentExecution;
+  if (!isPlainObject2(agentExecution.task)) {
+    agentExecution.task = createDefaultAgentExecutionTaskConfig();
+  }
+  return agentExecution.task;
+}
+function ensureAgentReview(workflow) {
+  if (!isPlainObject2(workflow.agentReview)) workflow.agentReview = {};
+  return workflow.agentReview;
+}
+function ensureReviewPhase(agentReview, phaseName) {
+  if (!isPlainObject2(agentReview[phaseName])) {
+    agentReview[phaseName] = {
+      enabled: false,
+      evidenceMode: "path_required",
+      reviewer: createDefaultAgentReviewerConfig()
+    };
+  }
+  const phase = agentReview[phaseName];
+  if (!isPlainObject2(phase.reviewer)) {
+    phase.reviewer = createDefaultAgentReviewerConfig();
+  }
+  if (phase.evidenceMode !== "any" && phase.evidenceMode !== "path_required") {
+    phase.evidenceMode = "path_required";
+  }
+  return phase;
+}
+function currentReviewSelection(workflow) {
+  const agentReview = isPlainObject2(workflow.agentReview) ? workflow.agentReview : {};
+  const legacyFeature = isPlainObject2(workflow.prePrReview) ? workflow.prePrReview.enabled : void 0;
+  const isLocal = workflow.mode === "local" || workflow.preset === "local";
+  return CONFIG_REVIEW_PHASES.filter((phase) => {
+    const phaseConfig = isPlainObject2(agentReview[phase]) ? agentReview[phase] : {};
+    if (typeof phaseConfig.enabled === "boolean") return phaseConfig.enabled;
+    if (phase === "feature") {
+      return typeof legacyFeature === "boolean" ? legacyFeature : !isLocal;
+    }
+    return false;
+  });
+}
+async function updateWorkflowConfig(configFile, options, lang) {
+  const workflow = ensureWorkflow(configFile);
+  const legacyBackfilledAgentAutomation = resolveLegacyBackfilledAgentAutomation(configFile);
+  if (legacyBackfilledAgentAutomation.taskExecution) {
+    ensureTaskExecution(workflow).enabled = false;
+  }
+  if (legacyBackfilledAgentAutomation.planReview) {
+    ensureReviewPhase(ensureAgentReview(workflow), "plan").enabled = false;
+  }
+  const isLocal = workflow.mode === "local" || workflow.preset === "local";
+  if (options.interactive && options.nonInteractive) {
+    throw createCliError(
+      "PROMPT_BLOCKED",
+      "`--interactive` cannot be used with `--non-interactive`."
+    );
+  }
+  let taskAgentEnabled = options.taskAgent === "on" ? true : options.taskAgent === "off" ? false : void 0;
+  let reviews = parseReviews(options.reviews);
+  let maxReviewRounds = parseMaxReviewRounds(options.maxReviewRounds);
+  let completionStrategy = options.completionStrategy;
+  if (options.interactive) {
+    const selectedReviews = currentReviewSelection(workflow);
+    const currentTaskExecution = isPlainObject2(workflow.agentExecution) && isPlainObject2(workflow.agentExecution.task) ? workflow.agentExecution.task.enabled === true : false;
+    const currentAgentReview = isPlainObject2(workflow.agentReview) ? workflow.agentReview : {};
+    const currentMaxRounds = typeof currentAgentReview.maxRounds === "number" && Number.isInteger(currentAgentReview.maxRounds) && currentAgentReview.maxRounds > 0 ? currentAgentReview.maxRounds : 1;
+    const response = await prompts(
+      [
+        {
+          type: typeof options.taskAgent === "undefined" ? "select" : null,
+          name: "taskAgent",
+          message: tr(lang, "cli", "init.prompt.taskAgent"),
+          choices: [
+            { title: tr(lang, "cli", "init.choice.taskAgent.on"), value: true },
+            {
+              title: tr(lang, "cli", "init.choice.taskAgent.off"),
+              value: false
+            }
+          ],
+          initial: currentTaskExecution ? 0 : 1
+        },
+        {
+          type: typeof options.reviews === "undefined" ? "multiselect" : null,
+          name: "reviews",
+          message: tr(lang, "cli", "init.prompt.reviews"),
+          choices: CONFIG_REVIEW_PHASES.map((phase) => ({
+            title: tr(lang, "cli", `init.choice.review.${phase}`),
+            value: phase,
+            selected: selectedReviews.includes(phase)
+          }))
+        },
+        {
+          type: typeof options.maxReviewRounds === "undefined" ? "number" : null,
+          name: "maxReviewRounds",
+          message: tr(lang, "cli", "init.prompt.maxReviewRounds"),
+          initial: currentMaxRounds,
+          min: 1
+        },
+        {
+          type: isLocal && typeof options.completionStrategy === "undefined" ? "select" : null,
+          name: "completionStrategy",
+          message: tr(lang, "cli", "init.prompt.completionStrategy"),
+          choices: [
+            { title: "local-ff", value: "local-ff" },
+            { title: "local-squash", value: "local-squash" },
+            { title: "none", value: "none" }
+          ],
+          initial: ["local-ff", "local-squash", "none"].indexOf(
+            String(workflow.completionStrategy || "none")
+          )
+        }
+      ],
+      {
+        onCancel: () => {
+          throw new Error("canceled");
+        }
+      }
+    );
+    if (typeof response.taskAgent === "boolean")
+      taskAgentEnabled = response.taskAgent;
+    if (Array.isArray(response.reviews)) {
+      reviews = CONFIG_REVIEW_PHASES.filter(
+        (phase) => response.reviews.includes(phase)
+      );
+    }
+    if (Number.isInteger(response.maxReviewRounds) && response.maxReviewRounds > 0) {
+      maxReviewRounds = response.maxReviewRounds;
+    }
+    completionStrategy = response.completionStrategy || completionStrategy;
+  }
+  if (completionStrategy && !isLocal) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--completion-strategy` can only be used with a local workflow."
+    );
+  }
+  if (typeof taskAgentEnabled === "boolean") {
+    ensureTaskExecution(workflow).enabled = taskAgentEnabled;
+  }
+  if (reviews) {
+    const agentReview = ensureAgentReview(workflow);
+    for (const phase of CONFIG_REVIEW_PHASES) {
+      ensureReviewPhase(agentReview, phase).enabled = reviews.includes(phase);
+    }
+  }
+  if (typeof maxReviewRounds === "number") {
+    ensureAgentReview(workflow).maxRounds = maxReviewRounds;
+  }
+  if (completionStrategy) workflow.completionStrategy = completionStrategy;
+  if (typeof taskAgentEnabled === "boolean" || reviews) {
+    workflow.agentAutomationConfigured = true;
+  }
+  console.log(chalk.green(tr(lang, "cli", "config.workflowUpdated")));
+}
 function runProcess(bin, args, cwd) {
   const result = spawnSync(bin, args, {
     cwd,
@@ -8441,6 +8766,7 @@ var COMPLETION_MARKERS = {
 };
 function resolveWorkflowRequirements(config) {
   const workflow = config.workflow || {};
+  const legacyBackfilledAgentAutomation = resolveLegacyBackfilledAgentAutomation(config);
   const hasCanonicalMode = workflow.mode === "github" || workflow.mode === "local";
   const workflowMode = hasCanonicalMode ? workflow.mode : workflow.preset === "local" ? "local" : "github";
   const isLocalWorkflow = workflowMode === "local";
@@ -8452,10 +8778,13 @@ function resolveWorkflowRequirements(config) {
     requirePr: workflow.requirePr ?? !isLocalWorkflow,
     requireReview: workflow.requireReview ?? !isLocalWorkflow,
     requireMerge: workflow.requireMerge ?? !isLocalWorkflow,
-    planReviewEnabled: workflow.agentReview?.plan?.enabled ?? true,
+    // Missing agent automation keys identify projects created before these
+    // policies existed. Keep their historical main-agent/no-Plan-review
+    // behavior; new projects opt in explicitly through init.
+    planReviewEnabled: legacyBackfilledAgentAutomation.planReview ? false : workflow.agentReview?.plan?.enabled ?? false,
     taskReviewEnabled: workflow.agentReview?.task?.enabled ?? false,
     featureReviewEnabled: workflow.agentReview?.feature?.enabled ?? workflow.prePrReview?.enabled ?? !isLocalWorkflow,
-    taskExecutionEnabled: workflow.agentExecution?.task?.enabled ?? true
+    taskExecutionEnabled: legacyBackfilledAgentAutomation.taskExecution ? false : workflow.agentExecution?.task?.enabled ?? false
   };
 }
 function parseApprovalStatus(raw) {