lee-spec-kit 0.6.29 → 0.6.31

package/dist/index.js

@@ -514,8 +514,8 @@ var ko = {
     reviewFixCommitIssueGuidance: "PR \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uB9AC\uBDF0 \uBC18\uC601 \uD30C\uC77C\uB9CC \uC2A4\uD14C\uC774\uC9D5\uD55C \uB4A4 `fix(#{issueNumber}): <review-fix-summary>` \uD615\uC2DD\uC73C\uB85C \uCEE4\uBC0B\uD558\uC138\uC694. `<review-fix-summary>`\uC5D0\uB294 \uC774\uBC88 \uCEE4\uBC0B\uC5D0\uC11C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9 \uC694\uC57D\uC744 \uC791\uC131\uD558\uC138\uC694. (\uD0DC\uC2A4\uD06C \uC81C\uBAA9 \uC7AC\uC0AC\uC6A9 \uAE08\uC9C0)",
     reviewFixCommitGuidance: "PR \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uB9AC\uBDF0 \uBC18\uC601 \uD30C\uC77C\uB9CC \uC2A4\uD14C\uC774\uC9D5\uD55C \uB4A4 `fix(review): <review-fix-summary>` \uD615\uC2DD\uC73C\uB85C \uCEE4\uBC0B\uD558\uC138\uC694. `<review-fix-summary>`\uC5D0\uB294 \uC774\uBC88 \uCEE4\uBC0B\uC5D0\uC11C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9 \uC694\uC57D\uC744 \uC791\uC131\uD558\uC138\uC694. (\uD0DC\uC2A4\uD06C \uC81C\uBAA9 \uC7AC\uC0AC\uC6A9 \uAE08\uC9C0)",
     standaloneNeedsProjectRoot: "standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot \uC124\uC815\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)",
-    createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
-    worktreeCleanupCommand: 'cd "{projectGitCwd}" && git worktree remove "{worktreePath}" && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
+    createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && WT="{projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}" && for f in .env .env.local .env.development .env.development.local .env.test .env.test.local .env.production .env.production.local; do [ -f "{projectGitCwd}/$f" ] && [ ! -e "$WT/$f" ] && cp "{projectGitCwd}/$f" "$WT/$f" || true; done && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
+    worktreeCleanupCommand: 'cd "{projectGitCwd}" && WT="{worktreePath}" && ROOT="$(pwd)" && case "$WT" in "$ROOT"/.worktrees/*) if git worktree list --porcelain | grep -Fxq "worktree $WT"; then git worktree remove --force "$WT" || true; fi; [ -d "$WT" ] && rm -rf "$WT" || true ;; *) echo "skip unsafe worktree path: $WT" ;; esac && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
     tasksAllDoneButNoChecklist: '\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uB97C \uC791\uC131\uD558\uC138\uC694. tasks.md\uC758 "\uC644\uB8CC \uC870\uAC74" \uC139\uC158\uC5D0 \uAC80\uC99D \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0, \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uC138\uC694. \uCD5C\uC885 \uC2B9\uC778(OK)\uB3C4 \uBC18\uC601\uD558\uC138\uC694.',
     tasksAllDoneButChecklist: "\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uC758 \uB0A8\uC740 \uD56D\uBAA9\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uD604\uC7AC \uC9C4\uD589: ({checked}/{total}) \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uACE0 \uCD5C\uC885 \uC2B9\uC778(OK)\uC744 \uBC18\uC601\uD558\uC138\uC694.",
     finishDoingTask: '\uD604\uC7AC DOING/REVIEW \uD0DC\uC2A4\uD06C\uB97C \uC218\uD589\uD558\uC138\uC694: "{title}" ({done}/{total}) \uC644\uB8CC \uC2DC \uACB0\uACFC/\uAC80\uC99D\uC744 \uACF5\uC720\uD558\uACE0 DONE \uCC98\uB9AC',
@@ -1025,8 +1025,8 @@ var en = {
     reviewFixCommitIssueGuidance: "Commit PR review fixes. Stage only review-fix files, then commit with `fix(#{issueNumber}): <review-fix-summary>`. `<review-fix-summary>` must describe review comments resolved in this commit (do not reuse task titles).",
     reviewFixCommitGuidance: "Commit PR review fixes. Stage only review-fix files, then commit with `fix(review): <review-fix-summary>`. `<review-fix-summary>` must describe review comments resolved in this commit (do not reuse task titles).",
     standaloneNeedsProjectRoot: "Standalone mode requires projectRoot. (npx lee-spec-kit config --project-root ...)",
-    createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
-    worktreeCleanupCommand: 'cd "{projectGitCwd}" && git worktree remove "{worktreePath}" && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
+    createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && WT="{projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}" && for f in .env .env.local .env.development .env.development.local .env.test .env.test.local .env.production .env.production.local; do [ -f "{projectGitCwd}/$f" ] && [ ! -e "$WT/$f" ] && cp "{projectGitCwd}/$f" "$WT/$f" || true; done && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
+    worktreeCleanupCommand: 'cd "{projectGitCwd}" && WT="{worktreePath}" && ROOT="$(pwd)" && case "$WT" in "$ROOT"/.worktrees/*) if git worktree list --porcelain | grep -Fxq "worktree $WT"; then git worktree remove --force "$WT" || true; fi; [ -d "$WT" ] && rm -rf "$WT" || true ;; *) echo "skip unsafe worktree path: $WT" ;; esac && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
     tasksAllDoneButNoChecklist: 'Create the completion checklist. Add verification items to the tasks.md "Completion Criteria" section, then mark satisfied items as [x] after user confirmation. Record final approval (OK) as well.',
     tasksAllDoneButChecklist: "Proceed with remaining completion checklist items. Current progress: ({checked}/{total}) Mark items as [x] only after user confirmation and real verification. Record final approval (OK) as well.",
     finishDoingTask: 'Continue working on the current DOING/REVIEW task: "{title}" ({done}/{total}) After it is complete, share outcome/verification and mark it DONE',
@@ -2951,13 +2951,15 @@ function resolveWorkflowPolicy(workflow) {
     requireIssue: false,
     requireBranch: false,
     requirePr: false,
-    requireReview: false
+    requireReview: false,
+    requireMerge: false
   } : {
     mode,
     requireIssue: true,
     requireBranch: true,
     requirePr: true,
-    requireReview: true
+    requireReview: true,
+    requireMerge: true
   };
   if (typeof workflow?.requireIssue === "boolean") {
     policy.requireIssue = workflow.requireIssue;
@@ -2971,13 +2973,20 @@ function resolveWorkflowPolicy(workflow) {
   if (typeof workflow?.requireReview === "boolean") {
     policy.requireReview = workflow.requireReview;
   }
+  if (typeof workflow?.requireMerge === "boolean") {
+    policy.requireMerge = workflow.requireMerge;
+  }
   if (!policy.requireIssue) {
     policy.requireBranch = false;
   }
   if (!policy.requirePr) {
     policy.requireReview = false;
+    policy.requireMerge = false;
   } else if (policy.requireReview) {
     policy.requirePr = true;
+    policy.requireMerge = true;
+  } else if (policy.requireMerge) {
+    policy.requirePr = true;
   }
   return policy;
 }
@@ -3076,7 +3085,7 @@ function isPrePrReviewSatisfied(feature, prePrReviewPolicy) {
   return true;
 }
 function isFeatureDone(feature, workflowPolicy, prePrReviewPolicy) {
-  return feature.specStatus === "Approved" && feature.planStatus === "Approved" && !feature.git.docsHasUncommittedChanges && !feature.git.projectHasUncommittedChanges && feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature) && (!workflowPolicy.requireIssue || !!feature.issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured(feature) && !!feature.pr.link) && (!workflowPolicy.requireReview || feature.pr.status === "Approved") && isPrePrReviewSatisfied(feature, prePrReviewPolicy);
+  return feature.specStatus === "Approved" && feature.planStatus === "Approved" && !feature.git.docsHasUncommittedChanges && !feature.git.projectHasUncommittedChanges && feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature) && (!workflowPolicy.requireIssue || !!feature.issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured(feature) && !!feature.pr.link) && (!workflowPolicy.requireMerge || feature.pr.status === "Approved") && isPrePrReviewSatisfied(feature, prePrReviewPolicy);
 }
 function getPrReviewRemoteBlockReasons(feature, lang) {
   const remote = feature.pr.remote;
@@ -3981,10 +3990,10 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
       step: 14,
       name: tr(lang, "steps", "codeReview"),
       checklist: {
-        done: (f) => !workflowPolicy.requireReview || isPrMetadataConfigured(f) && f.pr.status === "Approved"
+        done: (f) => !workflowPolicy.requireMerge || isPrMetadataConfigured(f) && f.pr.status === "Approved"
       },
       current: {
-        when: (f) => workflowPolicy.requireReview && isPrMetadataConfigured(f) && !!f.pr.link && f.pr.status !== "Approved",
+        when: (f) => workflowPolicy.requireMerge && isPrMetadataConfigured(f) && !!f.pr.link && f.pr.status !== "Approved",
         actions: (f) => {
           if (!f.pr.status) {
             return [
@@ -3998,7 +4007,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
             ];
           }
           if (f.pr.status === "Review") {
-            if (f.pr.remote?.available && f.pr.remote.isMerged) {
+            if (workflowPolicy.requireReview && f.pr.remote?.available && f.pr.remote.isMerged) {
               return [
                 {
                   type: "instruction",
@@ -4009,7 +4018,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 }
               ];
             }
-            if (!f.docs.prReviewEvidenceFieldExists) {
+            if (workflowPolicy.requireReview && !f.docs.prReviewEvidenceFieldExists) {
               return [
                 {
                   type: "instruction",
@@ -4020,7 +4029,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 }
               ];
             }
-            if (!f.prReview.evidenceProvided) {
+            if (workflowPolicy.requireReview && !f.prReview.evidenceProvided) {
               return [
                 {
                   type: "instruction",
@@ -4031,7 +4040,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 }
               ];
             }
-            if (!f.docs.prReviewDecisionFieldExists) {
+            if (workflowPolicy.requireReview && !f.docs.prReviewDecisionFieldExists) {
               return [
                 {
                   type: "instruction",
@@ -4042,7 +4051,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 }
               ];
             }
-            if (!f.prReview.decisionProvided) {
+            if (workflowPolicy.requireReview && !f.prReview.decisionProvided) {
               return [
                 {
                   type: "instruction",
@@ -4055,15 +4064,16 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
             }
             const remoteBlockReasons = getPrReviewRemoteBlockReasons(f, lang);
             const remoteUnavailable = workflowPolicy.mode === "github" && !!f.pr.link && (!f.pr.remote || !f.pr.remote.available);
-            const actions = [
-              {
+            const actions = [];
+            if (workflowPolicy.requireReview) {
+              actions.push({
                 type: "instruction",
                 category: "code_review",
                 requiresUserCheck: true,
                 uiDetailKey: "context.actionDetail.codeReviewResolve",
                 message: tr(lang, "messages", "prReviewResolve")
-              }
-            ];
+              });
+            }
             if (!f.git.projectGitCwd) {
               actions.push({
                 type: "instruction",
@@ -4121,7 +4131,18 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 })
               });
             }
-            return actions;
+            if (actions.length > 0) return actions;
+            return [
+              {
+                type: "instruction",
+                category: "code_review",
+                requiresUserCheck: true,
+                uiDetailKey: "context.actionDetail.codeReviewMergeAfterOk",
+                message: tr(lang, "messages", "prReviewMerge", {
+                  featureRef: f.id || f.folderName
+                })
+              }
+            ];
           }
           return [
             {
@@ -5331,7 +5352,7 @@ async function parseFeature(featurePath, type, context, options) {
     prDocPrFieldExists = hasAnySpecKey(content, ["PR", "Pull Request"]);
     prDocReviewStatusFieldExists = hasAnySpecKey(content, ["PR \uC0C1\uD0DC", "PR Status"]);
   }
-  if (workflowPolicy.requireReview && prStatus === "Review" && prLink && effectiveProjectGitCwd) {
+  if (workflowPolicy.requireMerge && prStatus === "Review" && prLink && effectiveProjectGitCwd) {
     prRemote = resolvePrRemoteStatus(prLink, effectiveProjectGitCwd) || void 0;
   }
   const warnings = [];
@@ -5473,7 +5494,7 @@ async function parseFeature(featurePath, type, context, options) {
   }
   const tasksDocApproved = !tasksDocStatusFieldExists || tasksDocStatus === "Approved";
   const implementationDone = tasksExists && tasksSummary.total > 0 && tasksSummary.total === tasksSummary.done && isCompletionChecklistDone2({ completionChecklist }) && tasksDocApproved;
-  const workflowDone = implementationDone && !docsHasUncommittedChanges && !projectHasUncommittedChanges && specStatus === "Approved" && planStatus === "Approved" && (!workflowPolicy.requireIssue || !!issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured2({ docs: { prFieldExists, prStatusFieldExists } }) && !!prLink) && (!workflowPolicy.requireReview || prStatus === "Approved") && isPrePrReviewSatisfied2(
+  const workflowDone = implementationDone && !docsHasUncommittedChanges && !projectHasUncommittedChanges && specStatus === "Approved" && planStatus === "Approved" && (!workflowPolicy.requireIssue || !!issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured2({ docs: { prFieldExists, prStatusFieldExists } }) && !!prLink) && (!workflowPolicy.requireMerge || prStatus === "Approved") && isPrePrReviewSatisfied2(
     {
       docs: {
         prePrReviewFieldExists,
@@ -5504,11 +5525,11 @@ async function parseFeature(featurePath, type, context, options) {
     }
     if (workflowPolicy.requirePr && prFieldExists && prStatusFieldExists) {
       if (!prLink) warnings.push(tr(lang, "warnings", "workflowPrLinkMissing"));
-      if (workflowPolicy.requireReview) {
+      if (workflowPolicy.requireMerge) {
         if (!prStatus) warnings.push(tr(lang, "warnings", "workflowPrStatusMissing"));
         if (prStatus && prStatus !== "Approved") {
           warnings.push(tr(lang, "warnings", "workflowPrStatusNotApproved"));
-          if (prStatus === "Review") {
+          if (workflowPolicy.requireReview && prStatus === "Review") {
             if (!prReviewEvidenceFieldExists || !prReviewEvidenceProvided) {
               warnings.push(tr(lang, "warnings", "workflowPrReviewEvidenceMissing"));
             }
@@ -7243,17 +7264,38 @@ var LONG_RUNNING_DELEGATION_CATEGORIES = [
   "review_fix_commit",
   "pre_pr_review"
 ];
+function isTaskExecuteProjectCommitCommand(option) {
+  if (!option || option.action.type !== "command") return false;
+  if (option.action.category !== "task_execute") return false;
+  if (option.action.scope !== "project") return false;
+  return /\bgit\s+commit\b/i.test(option.action.cmd);
+}
 function shouldDelegateCurrentAction(actionOptions) {
-  const primaryCategory = actionOptions[0]?.action?.category || null;
+  const primaryOption = actionOptions[0];
+  const primaryCategory = primaryOption?.action?.category || null;
   const longRunningSet = new Set(LONG_RUNNING_DELEGATION_CATEGORIES);
-  const shouldDelegate = !!primaryCategory && longRunningSet.has(primaryCategory);
+  const shouldDelegate = !!primaryCategory && longRunningSet.has(primaryCategory) && !isTaskExecuteProjectCommitCommand(primaryOption);
   return {
     shouldDelegate,
     category: primaryCategory
   };
 }
-function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable) {
+function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable, autoRunCommand, featureRef) {
   const delegation = shouldDelegateCurrentAction(actionOptions);
+  const primaryOption = actionOptions[0];
+  const delegatedCommandOption = primaryOption && primaryOption.action.type === "command" && delegation.shouldDelegate ? primaryOption : null;
+  const handoffMode = delegatedCommandOption ? "command" : autoRunAvailable ? "auto_run" : null;
+  const handoffCwd = delegatedCommandOption?.action.cwd || (autoRunAvailable ? process.cwd() : null);
+  const handoffCmd = delegatedCommandOption?.action.cmd || (autoRunAvailable ? autoRunCommand : null);
+  const handoffRequired = !!handoffMode && !!handoffCwd && !!handoffCmd;
+  const verifyCacheKey = handoffRequired ? createHash("sha1").update(
+    [
+      handoffMode,
+      featureRef || "",
+      handoffCwd || "",
+      handoffCmd || ""
+    ].join("|")
+  ).digest("hex").slice(0, 12) : "";
   return {
     mode: "main_orchestrates_subagent_execution",
     delegationPolicy: "prefer_main_delegate_long_running_fallback_main",
@@ -7285,7 +7327,23 @@ function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable) {
       "flow --resume <RUN_ID>",
       "autoRun.resume.flowCommand",
       "context --json-compact"
-    ]
+    ],
+    subAgentHandoff: {
+      required: handoffRequired,
+      mode: handoffMode,
+      featureRef,
+      category: delegation.category,
+      cwd: handoffCwd,
+      cmd: handoffCmd,
+      verify: handoffRequired ? {
+        runOncePerSession: true,
+        cacheKey: verifyCacheKey,
+        expectedCwd: handoffCwd,
+        commands: ["pwd", "git rev-parse --show-toplevel"],
+        onMismatch: "stop_and_report",
+        collectDetailedLogsOnMismatchOnly: true
+      } : null
+    }
   };
 }
 async function resolveContextState(config, featureName, options) {
@@ -7837,7 +7895,9 @@ async function runContext(featureName, options) {
   );
   const agentOrchestration = buildAgentOrchestrationPolicy(
     state.actionOptions,
-    autoRunPlan.available
+    autoRunPlan.available,
+    autoRunPlan.command,
+    state.matchedFeature?.folderName || null
   );
   if (options.approve || options.execute) {
     await runApprovedOption(
@@ -9657,8 +9717,12 @@ function toFlowRunStatus(status) {
       return "failed";
   }
 }
-function buildAgentOrchestrationPolicy2(autoRun) {
+function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
   const preferredResumeCommand = autoRun?.run?.resumeCommand || autoRun?.resume?.flowCommand || null;
+  const handoffRequired = !!autoRun && !!preferredResumeCommand;
+  const verifyCacheKey = handoffRequired ? `${(featureRef || "unknown").toLowerCase()}|${Buffer.from(
+    preferredResumeCommand
+  ).toString("base64").slice(0, 12)}` : "";
   return {
     mode: "main_orchestrates_subagent_execution",
     delegationPolicy: "prefer_main_delegate_long_running_fallback_main",
@@ -9683,7 +9747,23 @@ function buildAgentOrchestrationPolicy2(autoRun) {
       "AUTO_MANUAL_REQUIRED",
       "command execution error"
     ],
-    preferredResumeCommand
+    preferredResumeCommand,
+    subAgentHandoff: {
+      required: handoffRequired,
+      mode: handoffRequired ? "auto_run" : null,
+      featureRef,
+      category: null,
+      cwd: handoffRequired ? process.cwd() : null,
+      cmd: handoffRequired ? preferredResumeCommand : null,
+      verify: handoffRequired ? {
+        runOncePerSession: true,
+        cacheKey: verifyCacheKey,
+        expectedCwd: process.cwd(),
+        commands: ["pwd", "git rev-parse --show-toplevel"],
+        onMismatch: "stop_and_report",
+        collectDetailedLogsOnMismatchOnly: true
+      } : null
+    }
   };
 }
 function getFeatureRef2(feature) {
@@ -10334,7 +10414,10 @@ async function runFlow(featureName, options) {
   const jsonMode = !!options.json || !!options.jsonCompact;
   if (jsonMode) {
     const autoRunFailed = !!(autoRun && isAutoRunFailureStatus(autoRun.status));
-    const agentOrchestration2 = buildAgentOrchestrationPolicy2(autoRun);
+    const agentOrchestration2 = buildAgentOrchestrationPolicy2(
+      autoRun,
+      resolvedFeatureName || null
+    );
     const status = autoRunFailed ? "error" : "ok";
     const reasonCode = autoRunFailed ? autoRun?.reasonCode || "AUTO_EXECUTION_FAILED" : "FLOW_SUMMARY";
     if (options.jsonCompact) {
@@ -10429,7 +10512,10 @@ async function runFlow(featureName, options) {
       console.log(chalk6.gray(`- Resume with: ${autoRun.run.resumeCommand}`));
     }
   }
-  const agentOrchestration = buildAgentOrchestrationPolicy2(autoRun);
+  const agentOrchestration = buildAgentOrchestrationPolicy2(
+    autoRun,
+    resolvedFeatureName || null
+  );
   console.log(
     chalk6.gray(
       `- Orchestration: ${agentOrchestration.mode}, delegate long-running loops to sub-agent`
@@ -10743,8 +10829,14 @@ function runGhJson2(args, cwd, lang) {
 }
 function ensureSections(body, sections, kind, lang) {
   const hasHeading = (sectionHeading) => {
-    const re = new RegExp(`^##\\s+${escapeRegExp3(sectionHeading)}\\s*$`, "m");
-    return re.test(body);
+    const target = normalizeHeading(sectionHeading);
+    const lines = body.split("\n");
+    for (const line of lines) {
+      const match = line.match(/^\s*##\s+(.+?)\s*$/);
+      if (!match) continue;
+      if (normalizeHeading(match[1]) === target) return true;
+    }
+    return false;
   };
   const hasMetadataField = (field) => {
     const re = new RegExp(`^\\s*-\\s*\\*\\*${escapeRegExp3(field)}\\*\\*\\s*:`, "m");
@@ -10905,7 +10997,13 @@ function getFeatureDocPaths(feature) {
   };
 }
 function normalizeHeading(value) {
-  return value.trim().replace(/\s+/g, " ").toLowerCase();
+  let normalized = value.trim();
+  for (; ; ) {
+    const next = normalized.replace(/\s*\([^)]*\)\s*$/, "").replace(/\s*（[^）]*）\s*$/, "").trim();
+    if (next === normalized) break;
+    normalized = next;
+  }
+  return normalized.replace(/\s+/g, " ").toLowerCase();
 }
 function extractMarkdownByHeadings(content, headings, levels) {
   const targets = new Set(headings.map((heading) => normalizeHeading(heading)));