lee-spec-kit 0.6.42 → 0.6.43

package/dist/index.js

@@ -497,7 +497,8 @@ var koContext = {
   "context.actionDetail.issueCreateFromDoc": "Ready \uC0C1\uD0DC issue.md\uB85C \uC774\uC288\uB97C \uC0DD\uC131\uD558\uACE0 \uBC88\uD638\uB97C \uB3D9\uAE30\uD654\uD558\uC138\uC694",
   "context.actionDetail.taskExecute": "\uD604\uC7AC \uD0DC\uC2A4\uD06C\uB97C \uC9C4\uD589\uD558\uC138\uC694",
   "context.actionDetail.taskExecuteRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD558\uACE0 \uD0DC\uC2A4\uD06C\uB97C \uC2DC\uC791\uD558\uC138\uC694: {task}. (TODO\uBA74 DOING\uC73C\uB85C \uBCC0\uACBD)",
-  "context.actionDetail.taskExecuteContinue": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD574 \uC9C4\uD589 \uC911\uC778 \uD0DC\uC2A4\uD06C\uB97C \uC774\uC5B4\uAC00\uC138\uC694: {task}",
+  "context.actionDetail.taskExecuteContinue": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD574 \uC9C4\uD589 \uC911\uC778 \uD0DC\uC2A4\uD06C\uB97C \uB9C8\uBB34\uB9AC\uD558\uC138\uC694: {task}. (\uC644\uB8CC \uD6C4 \uACB0\uACFC/\uAC80\uC99D\uC744 \uACF5\uC720\uD558\uACE0 DONE\uC73C\uB85C \uBCC0\uACBD)",
+  "context.actionDetail.taskExecuteComplete": "\uD604\uC7AC \uD0DC\uC2A4\uD06C\uB97C \uC644\uB8CC \uCC98\uB9AC\uD558\uC138\uC694: {task}. (DOING\uC744 DONE\uC73C\uB85C \uBCC0\uACBD)",
   "context.actionDetail.reviewFixCommit": "\uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9 \uC694\uC57D\uC73C\uB85C \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uB9CC\uB4DC\uC138\uC694",
   "context.actionDetail.prePrReviewRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C PR \uC804 \uB9AC\uBDF0\uB97C \uC2E4\uD589\uD574 `review-trace.json`\uC744 \uC900\uBE44\uD558\uC138\uC694",
   "context.actionDetail.prePrReviewRecord": "PR \uC804 \uB9AC\uBDF0 evidence\uB97C decisions.md\uC640 tasks.md\uC5D0 \uAE30\uB85D\uD558\uC138\uC694",
@@ -1049,7 +1050,8 @@ var enContext = {
   "context.actionDetail.issueCreateFromDoc": "Create GitHub Issue from ready issue.md and sync Issue",
   "context.actionDetail.taskExecute": "Proceed with the current task",
   "context.actionDetail.taskExecuteRun": "Prepare helper agent/sub-agent task handoff and start the task: {task}. (TODO becomes DOING)",
-  "context.actionDetail.taskExecuteContinue": "Prepare helper agent/sub-agent handoff and continue the in-progress task: {task}",
+  "context.actionDetail.taskExecuteContinue": "Prepare helper agent/sub-agent handoff and wrap up the in-progress task: {task}. (Share outcome/verification, then mark it DONE)",
+  "context.actionDetail.taskExecuteComplete": "Mark the current task as complete: {task}. (Change DOING to DONE)",
   "context.actionDetail.reviewFixCommit": "Create a review-fix commit with resolved feedback summary",
   "context.actionDetail.prePrReviewRun": "Run the pre-PR review via a helper agent/sub-agent and prepare `review-trace.json`",
   "context.actionDetail.prePrReviewRecord": "Record pre-PR review evidence into decisions.md and tasks.md",
@@ -3553,6 +3555,7 @@ function resolvePrePrReviewPolicy(workflow) {
 function getPrePrReviewPrompt(lang, skills, fallbackText) {
   if (lang === "ko") {
     return `PR \uC0DD\uC131 \uC804 \uC0AC\uC804 \uCF54\uB4DC\uB9AC\uBDF0\uB97C \uC9C4\uD589\uD558\uC138\uC694.
+0. \uAC19\uC740 feature/pre-PR \uB9AC\uBDF0\uB97C \uB2F4\uB2F9\uD558\uB358 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC774\uBBF8 \uC788\uC73C\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0 \uC7AC\uC0AC\uC6A9\uD558\uC138\uC694. \uAE30\uBCF8\uC740 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 1\uAC1C\uC785\uB2C8\uB2E4.
 1. \`spec.md\`, \`plan.md\`, \`tasks.md\`\uB97C \uC77D\uACE0 feature \uBAA9\uD45C/\uBC94\uC704/\uC644\uB8CC \uAE30\uC900\uC744 \uBA3C\uC800 \uC694\uC57D\uD558\uC138\uC694.
 2. \uB9AC\uBDF0 \uBC94\uC704\uB97C \uBD84\uB9AC\uD574 \uD655\uC778\uD558\uC138\uC694.
    - main \uAE30\uC900: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
@@ -3561,11 +3564,14 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 4. \uD655\uC778\uB41C \uAC01 \uD30C\uC77C\uC5D0 \uB300\uD574 risk, security, perf, maintainability \uD3C9\uAC00\uC640 \uAD6C\uCCB4\uC801\uC778 fileLine \uC704\uCE58\uAC00 \uD3EC\uD568\uB41C 'review-trace.json' \uC99D\uAC70 \uD30C\uC77C\uC744 \uC0DD\uC131\uD558\uC138\uC694.
 5. \uAE30\uBCF8 \uBCA0\uC774\uC2A4\uB77C\uC778\uC740 '${fallbackText}'\uC774\uBA70, 'create-pr' \uBB38\uC11C\uC758 'Pre-PR \uAE30\uBCF8 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8' \uC139\uC158\uC744 \uC218\uD589\uD558\uC138\uC694.
 6. \uC6B0\uC120\uC21C\uC704 \uC2A4\uD0AC: ${skills.length > 0 ? skills.join(", ") : "\uC5C6\uC74C"} \uB85C \uC2EC\uD654 \uAC80\uD1A0\uB97C \uC9C4\uD589\uD558\uC138\uC694.
-7. \uCD94\uAC00 \uAC80\uC99D\uC774 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC audit/\uD0C0\uAE43 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uACE0, \uC2E4\uD589\uD588\uB2E4\uBA74 \`commandsExecuted\`\uC5D0 \uAE30\uB85D\uD558\uC138\uC694.
-8. \uC9C0\uC801\uC0AC\uD56D\uC774 \uB0A8\uC544 \uC788\uC73C\uBA74 \uBA3C\uC800 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested' \uB85C \uAE30\uB85D\uD558\uC138\uC694. \uB2E8, \`workflow.prePrReview.evidenceMode=any\` \uC774\uACE0 \uC2E4\uD589 \uC99D\uAC70 \uAC15\uC81C\uAC00 \uC5C6\uC73C\uBA74 \`--evidence\` \uC5C6\uC774 \uC9C1\uC811 \uAE30\uB85D\uD574\uB3C4 \uB429\uB2C8\uB2E4.
-9. \uC218\uC815/\uC7AC\uAC80\uC99D \uD6C4 \uCD5C\uC885 \uC2B9\uC778 \uC2DC\uC810\uC5D0 'npx lee-spec-kit pre-pr-review <feature> --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694. \`path_required\` \uC815\uCC45\uC77C \uB54C\uB9CC \`--evidence review-trace.json\` \uC744 \uD568\uAED8 \uBD99\uC774\uC138\uC694.`;
+7. \uCD94\uAC00 \uAC80\uC99D\uC774 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC audit/\uD0C0\uAE43 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uC138\uC694. \uBCC4\uB3C4 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uCD94\uAC00 \uC0DD\uC131\uB3C4 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC \uD558\uC138\uC694.
+8. \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uB9AC\uBDF0\uB97C \uC774\uC5B4\uAC00\uACE0, \uC774\uBBF8 \uC218\uC9D1\uD55C \uACB0\uACFC\uB9CC \uC815\uB9AC\uD574\uB3C4 \uB429\uB2C8\uB2E4.
+9. \uC2E4\uD589\uD55C \uBA85\uB839\uC774 \uC788\uC73C\uBA74 \`commandsExecuted\`\uC5D0 \uAE30\uB85D\uD558\uC138\uC694.
+10. \uC9C0\uC801\uC0AC\uD56D\uC774 \uB0A8\uC544 \uC788\uC73C\uBA74 \uBA3C\uC800 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested' \uB85C \uAE30\uB85D\uD558\uC138\uC694. \uB2E8, \`workflow.prePrReview.evidenceMode=any\` \uC774\uACE0 \uC2E4\uD589 \uC99D\uAC70 \uAC15\uC81C\uAC00 \uC5C6\uC73C\uBA74 \`--evidence\` \uC5C6\uC774 \uC9C1\uC811 \uAE30\uB85D\uD574\uB3C4 \uB429\uB2C8\uB2E4.
+11. \uC218\uC815/\uC7AC\uAC80\uC99D \uD6C4 \uCD5C\uC885 \uC2B9\uC778 \uC2DC\uC810\uC5D0 'npx lee-spec-kit pre-pr-review <feature> --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694. \`path_required\` \uC815\uCC45\uC77C \uB54C\uB9CC \`--evidence review-trace.json\` \uC744 \uD568\uAED8 \uBD99\uC774\uC138\uC694.`;
   }
   return `Conduct a pre-PR code review.
+0. Reuse the existing helper/sub-agent for this feature review if one already exists. Default to a single helper agent.
 1. Read \`spec.md\`, \`plan.md\`, and \`tasks.md\` first, then summarize the feature goal, scope, and done criteria.
 2. Split and check the review scope.
    - Main scope: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
@@ -3574,15 +3580,17 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 4. Generate a 'review-trace.json' file for all changed files, including \`findingCount\`, \`blockingFindings\`, evaluations for risk, security, perf, maintainability, and specific fileLine locators.
 5. The baseline is '${fallbackText}'. Always perform the 'Pre-PR Core Checklist' section of the 'create-pr' document.
 6. Priority skills: ${skills.length > 0 ? skills.join(", ") : "None"} for deeper technical review.
-7. Run extra audit/targeted verification only when the review needs more evidence, and record those commands in \`commandsExecuted\` when used.
-8. If unresolved findings remain, first record them with 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested'. When \`workflow.prePrReview.evidenceMode=any\` and execution evidence is not enforced, direct record mode without \`--evidence\` is also valid.
-9. After fixes and re-validation, run 'npx lee-spec-kit pre-pr-review <feature> --decision approve' for final pre-PR approval. Add \`--evidence review-trace.json\` only when the active evidence policy requires a path.`;
+7. Run extra audit/targeted verification only when the review truly needs more evidence. Spawn additional helper agents only when necessary.
+8. If helper-agent quota is exhausted, continue the review in the main agent and just keep the evidence consistent.
+9. Record commands in \`commandsExecuted\` only when you actually ran them.
+10. If unresolved findings remain, first record them with 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested'. When \`workflow.prePrReview.evidenceMode=any\` and execution evidence is not enforced, direct record mode without \`--evidence\` is also valid.
+11. After fixes and re-validation, run 'npx lee-spec-kit pre-pr-review <feature> --decision approve' for final pre-PR approval. Add \`--evidence review-trace.json\` only when the active evidence policy requires a path.`;
 }
 function getCodeReviewPrompt(lang) {
   if (lang === "ko") {
-    return `\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778/\uBD84\uC11D\uD55C \uB4A4 \uD544\uC694\uD55C \uC218\uC815\uC744 \uC9C4\uD589\uD558\uC138\uC694. PR \uC0C1\uD0DC\uB294 Review\uB97C \uC720\uC9C0\uD558\uACE0 'PR \uB9AC\uBDF0 Evidence/Decision'\uC744 \uCD5C\uC2E0\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. \uC6D0\uACA9 \uBC18\uC601(push)\uC740 \uBA85\uC2DC\uC801\uC778 \uBA38\uC9C0 \uC2B9\uC778(\uB77C\uBCA8) \uD6C4, \uB85C\uCEEC \uBE0C\uB79C\uCE58\uAC00 upstream\uBCF4\uB2E4 \uC55E\uC120 \uACBD\uC6B0\uC5D0\uB9CC \uC9C4\uD589\uD558\uC138\uC694.`;
+    return `\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778/\uBD84\uC11D\uD55C \uB4A4 \uD544\uC694\uD55C \uC218\uC815\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uAE30\uC874 review \uB2F4\uB2F9 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694. \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uC774\uC5B4\uAC00\uC138\uC694. PR \uC0C1\uD0DC\uB294 Review\uB97C \uC720\uC9C0\uD558\uACE0 'PR \uB9AC\uBDF0 Evidence/Decision'\uC744 \uCD5C\uC2E0\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. \uC6D0\uACA9 \uBC18\uC601(push)\uC740 \uBA85\uC2DC\uC801\uC778 \uBA38\uC9C0 \uC2B9\uC778(\uB77C\uBCA8) \uD6C4, \uB85C\uCEEC \uBE0C\uB79C\uCE58\uAC00 upstream\uBCF4\uB2E4 \uC55E\uC120 \uACBD\uC6B0\uC5D0\uB9CC \uC9C4\uD589\uD558\uC138\uC694.`;
   }
-  return `Review and analyze comments, then make necessary fixes. Keep PR status as Review and record the latest 'PR Review Evidence/Decision'. Push changes only after explicit approval (label) and only if the local branch is ahead of upstream.`;
+  return `Review and analyze comments, then make necessary fixes. Reuse the existing review helper agent if one already exists, and default to a single helper agent. If helper-agent quota is exhausted, continue in the main agent. Keep PR status as Review and record the latest 'PR Review Evidence/Decision'. Push changes only after explicit approval (label) and only if the local branch is ahead of upstream.`;
 }
 
 // src/utils/context/steps.ts
@@ -3694,6 +3702,13 @@ function buildTaskRunCommandArgs(feature, taskId) {
   }
   return commandArgs;
 }
+function buildTaskCompleteCommandArgs(feature, taskId) {
+  const commandArgs = ["task-complete", feature.folderName, "--task", taskId];
+  if (feature.type && feature.type !== "single") {
+    commandArgs.push("--component", feature.type);
+  }
+  return commandArgs;
+}
 function buildCodeReviewRunCommandArgs(feature) {
   const commandArgs = ["code-review-run", feature.folderName];
   if (feature.type && feature.type !== "single") {
@@ -3849,7 +3864,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   if (!diff.trim()) return 0;
   const removedByTask = /* @__PURE__ */ new Map();
   const addedByTask = /* @__PURE__ */ new Map();
-  const parseTaskLine2 = (line) => {
+  const parseTaskLine3 = (line) => {
     const match = line.match(
       /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\s+(.+?)\s*$/i
     );
@@ -3864,7 +3879,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   for (const line of diff.split("\n")) {
     if (line.startsWith("---") || line.startsWith("+++")) continue;
     if (line.startsWith("-")) {
-      const parsed = parseTaskLine2(line.slice(1));
+      const parsed = parseTaskLine3(line.slice(1));
       if (!parsed) continue;
       const existing = removedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -3872,7 +3887,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
       continue;
     }
     if (line.startsWith("+")) {
-      const parsed = parseTaskLine2(line.slice(1));
+      const parsed = parseTaskLine3(line.slice(1));
       if (!parsed) continue;
       const existing = addedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -4073,14 +4088,14 @@ function getStepDefinitions(ctx) {
       operationType: "local",
       requiresUserCheck: true,
       taskExecutePhase: "complete",
-      uiDetailKey: "context.actionDetail.taskExecuteContinue",
+      uiDetailKey: "context.actionDetail.taskExecuteComplete",
       uiDetailParams: {
         task: resolveTaskUiLabel(f.activeTask)
       },
       scope: "docs",
       cwd: f.git.docsGitCwd,
       cmd: buildSelfCliCommand(
-        buildTaskRunCommandArgs(
+        buildTaskCompleteCommandArgs(
           f,
           f.activeTask?.id || `T-${f.folderName}-active`
         )
@@ -4747,9 +4762,9 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
           actions: (f) => getTaskExecuteFinalizeActions(f)
         },
         {
-          id: "task_running",
-          phase: "running",
-          owner: "subagent",
+          id: "task_complete",
+          phase: "finalize",
+          owner: "main",
           category: "task_execute",
           when: (f) => isTaskExecuteCurrent(f) && !!f.activeTask,
           actions: (f) => getTaskExecuteRunningActions(f)
@@ -5206,7 +5221,7 @@ function applyApprovalPolicy(step, actions, approval, currentSubstatePhase) {
 function applyTaskExecutePhaseCheck(action, requiresUserCheck, policy, explicitlyRequired = false, currentSubstatePhase) {
   if (policy !== "start_only") return requiresUserCheck;
   if (action.category !== "task_execute") return requiresUserCheck;
-  const isCompletionPhase = currentSubstatePhase === "running" || !currentSubstatePhase && action.taskExecutePhase === "complete";
+  const isCompletionPhase = currentSubstatePhase === "running" || currentSubstatePhase === "finalize" || !currentSubstatePhase && action.taskExecutePhase === "complete";
   if (!isCompletionPhase) return requiresUserCheck;
   if (explicitlyRequired) return requiresUserCheck;
   return false;
@@ -8271,7 +8286,7 @@ function toActionOptions(actions, lang) {
     const summary = getActionSummary(action, lang);
     const detail = buildActionDetail(action, lang);
     const requiresRequestText = action.category === "user_request_replan";
-    const replyExample = requiresRequestText ? `${label}, <your request>` : `${label} OK`;
+    const replyExample = requiresRequestText ? `${label}, <your request>` : label;
     return {
       label,
       summary,
@@ -15928,6 +15943,9 @@ async function runPrePrReviewRun(featureName, options) {
           fallback: policy.fallback,
           handoffOnly: true,
           advancesWorkflow: false,
+          reuseKey: `pre-pr:${featureRef}`,
+          suggestedParallelism: 1,
+          fallbackToMainAgentWhenQuotaExceeded: true,
           nextStepRequirement: "generate_review_trace_then_record",
           evidenceFile: "review-trace.json",
           prompt,
@@ -15949,6 +15967,18 @@ async function runPrePrReviewRun(featureName, options) {
       config.lang === "ko" ? "\uC774 \uBA85\uB839\uC740 \uB9AC\uBDF0 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. review-trace.json\uC744 \uC9C1\uC811 \uC0DD\uC131\uD558\uAC70\uB098 \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0C1\uD0DC\uB97C \uBC14\uB85C \uB118\uAE30\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." : "This command only prepares the review handoff. It does not generate review-trace.json or advance workflow state by itself."
     )
   );
+  console.log(
+    chalk8.gray(
+      config.lang === "ko" ? "- \uAE30\uC874 pre-PR \uB9AC\uBDF0 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694." : "- Reuse the existing pre-PR helper agent if one already exists; default to a single helper agent."
+    )
+  );
+  console.log(
+    chalk8.gray(
+      config.lang === "ko" ? "- \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uB9AC\uBDF0\uB97C \uC774\uC5B4\uAC00\uC138\uC694." : "- If helper-agent quota is exhausted, continue the review in the main agent."
+    )
+  );
+  console.log(`Reuse key: pre-pr:${featureRef}`);
+  console.log(`Suggested parallelism: 1`);
   console.log(`Evidence file: review-trace.json`);
   console.log(`Record changes requested: ${changesRequestedCommand}`);
   console.log(`Record approval: ${approveCommand}`);
@@ -16181,6 +16211,9 @@ async function runCodeReviewRun(featureName, options) {
     owner: "subagent",
     handoffOnly: true,
     advancesWorkflow: false,
+    reuseKey: `code-review:${feature.folderName}`,
+    suggestedParallelism: 1,
+    fallbackToMainAgentWhenQuotaExceeded: true,
     nextMainState: "code_review_finalize",
     tasksPath: path12.join(feature.path, "tasks.md"),
     decisionsPath: path12.join(feature.path, "decisions.md"),
@@ -16200,6 +16233,13 @@ async function runCodeReviewRun(featureName, options) {
   );
   console.log(chalk8.gray(`- substate: ${payload.substateId}`));
   console.log(chalk8.gray(`- owner: ${payload.owner}`));
+  console.log(chalk8.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk8.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
+  console.log(
+    chalk8.gray(
+      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
+    )
+  );
   console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
   console.log(chalk8.gray(`- tasks.md: ${payload.tasksPath}`));
   console.log(chalk8.gray(`- decisions.md: ${payload.decisionsPath}`));
@@ -16451,9 +16491,10 @@ function parseTaskLine(line) {
 function buildTaskRunPrompt(input) {
   const shared = [
     "Read `spec.md`, `plan.md`, and `tasks.md` before editing code.",
-    "Use sub-agents by default for code analysis and discovery work.",
-    "Parallelize impact analysis, test-location search, and existing-pattern discovery when those can be done independently.",
+    "Reuse the existing helper/sub-agent for this task if one already exists. Default to a single helper agent.",
+    "Use additional helper agents only when parallel analysis is clearly worth the extra slot cost.",
     "Keep one writer for overlapping files; do not let multiple sub-agents edit the same files concurrently.",
+    "If helper-agent quota is exhausted, continue the task in the main agent instead of blocking progress.",
     "Update the assigned task status and verification notes in `tasks.md` before leaving this task.",
     "Mark the task `DONE` only after code changes and verification are complete."
   ];
@@ -16464,9 +16505,10 @@ function buildTaskRunPrompt(input) {
       `- Task: ${input.taskId} ${input.title}`,
       input.mode === "start" ? "- \uC774 \uBA85\uB839\uC740 `tasks.md`\uC758 \uD604\uC7AC task\uB97C `DOING`\uC73C\uB85C \uBC14\uAFB8\uACE0, \uC774\uD6C4 \uAD6C\uD604 handoff prompt\uB97C \uC900\uBE44\uD569\uB2C8\uB2E4." : "- \uC774 \uBA85\uB839\uC740 \uC9C4\uD589 \uC911 task\uC758 \uAD6C\uD604 handoff prompt\uB97C \uB2E4\uC2DC \uC900\uBE44\uD569\uB2C8\uB2E4.",
       "- \uBA3C\uC800 `spec.md`, `plan.md`, `tasks.md`\uB97C \uC77D\uACE0 \uBC94\uC704\uC640 \uC644\uB8CC \uAE30\uC900\uC744 \uC815\uB9AC\uD558\uC138\uC694.",
-      "- \uCF54\uB4DC \uBD84\uC11D\uACFC \uD0D0\uC0C9 \uC791\uC5C5\uC740 \uAE30\uBCF8\uC801\uC73C\uB85C \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
-      "- \uC601\uD5A5 \uBC94\uC704 \uBD84\uC11D, \uD14C\uC2A4\uD2B8 \uC704\uCE58 \uD0D0\uC0C9, \uAE30\uC874 \uD328\uD134 \uC870\uC0AC\uCC98\uB7FC \uB3C5\uB9BD\uC801\uC778 \uBD84\uC11D\uC740 \uBCD1\uB82C\uB85C \uC218\uD589\uD558\uC138\uC694.",
+      "- \uAE30\uC874\uC5D0 \uC774 task\uB97C \uB9E1\uB358 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.",
+      "- \uC601\uD5A5 \uBC94\uC704 \uBD84\uC11D, \uD14C\uC2A4\uD2B8 \uC704\uCE58 \uD0D0\uC0C9, \uAE30\uC874 \uD328\uD134 \uC870\uC0AC\uAC00 \uC815\uB9D0 \uB3C5\uB9BD\uC801\uC77C \uB54C\uB9CC \uCD94\uAC00 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
       "- \uAC19\uC740 \uD30C\uC77C\uAD70\uC744 \uC218\uC815\uD558\uB294 \uC791\uC131\uC790\uB294 \uD55C \uBA85\uB9CC \uB450\uC138\uC694.",
+      "- \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uAD6C\uD604\uC744 \uC774\uC5B4\uAC00\uC138\uC694.",
       "- \uC774 task\uB97C \uB9C8\uCE58\uAE30 \uC804 `tasks.md`\uC5D0 \uC0C1\uD0DC\uC640 \uAC80\uC99D \uBA54\uBAA8\uB97C \uBC18\uC601\uD558\uC138\uC694.",
       "- \uCF54\uB4DC \uBCC0\uACBD\uACFC \uAC80\uC99D\uC774 \uB05D\uB0AC\uC744 \uB54C\uB9CC task\uB97C `DONE`\uC73C\uB85C \uD45C\uC2DC\uD558\uC138\uC694."
     ].join("\n");
@@ -16565,7 +16607,11 @@ async function runTaskRun(featureName, options) {
     mode,
     substateId: mode === "start" ? "task_run" : "task_running",
     owner: "subagent",
-    nextMainState: "task_finalize",
+    handoffOnly: true,
+    reuseKey: `task:${feature.folderName}:${resolvedTask.taskId}`,
+    suggestedParallelism: 1,
+    fallbackToMainAgentWhenQuotaExceeded: true,
+    nextMainState: "task_complete",
     tasksUpdated,
     tasksPath,
     prompt,
@@ -16579,6 +16625,13 @@ async function runTaskRun(featureName, options) {
   console.log();
   console.log(chalk8.gray(`- substate: ${payload.substateId}`));
   console.log(chalk8.gray(`- owner: ${payload.owner}`));
+  console.log(chalk8.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk8.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
+  console.log(
+    chalk8.gray(
+      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
+    )
+  );
   console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
     console.log();
@@ -16614,6 +16667,146 @@ function taskRunCommand(program2) {
     }
   });
 }
+function parseTaskLine2(line) {
+  const match = line.match(
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[[^\]]+\](?:\[[^\]]+\])*\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
+  );
+  if (!match) return null;
+  return {
+    index: -1,
+    raw: line,
+    status: match[1],
+    taskId: match[2],
+    title: match[3]
+  };
+}
+function setTaskStatus2(line, nextStatus) {
+  return line.raw.replace(
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]/,
+    `- [${nextStatus}]`
+  );
+}
+async function resolveTaskCompleteContext(featureName, options) {
+  const config = await getConfig(process.cwd());
+  if (!config) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      "No lee-spec-kit config found in this workspace."
+    );
+  }
+  const ctx = await createCliContext({ cwd: process.cwd() });
+  const state = await resolveContextSelection(ctx, featureName, {
+    component: resolveComponentOption(options.component)
+  });
+  if (state.status !== "single_matched" || !state.matchedFeature) {
+    throw createCliError(
+      "CONTEXT_SELECTION_REQUIRED",
+      "task-complete requires a single matched feature. Pass <feature-name> explicitly."
+    );
+  }
+  return {
+    config,
+    feature: state.matchedFeature
+  };
+}
+async function runTaskComplete(featureName, options) {
+  const { feature } = await resolveTaskCompleteContext(featureName, options);
+  const tasksPath = path12.join(feature.path, "tasks.md");
+  if (!await fs.pathExists(tasksPath)) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `tasks.md not found for feature: ${feature.folderName}`
+    );
+  }
+  const content = await fs.readFile(tasksPath, "utf-8");
+  const lines = content.split("\n");
+  const requestedTaskId = options.task?.trim() || feature.activeTask?.id || feature.nextTodoTask?.id;
+  if (!requestedTaskId) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      "No active task is available for task-complete."
+    );
+  }
+  const resolvedTask = lines.map((line, index) => {
+    const parsed = parseTaskLine2(line);
+    return parsed ? { ...parsed, index } : null;
+  }).find((entry) => entry?.taskId === requestedTaskId);
+  if (!resolvedTask) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      `Task "${requestedTaskId}" was not found in tasks.md.`
+    );
+  }
+  if (resolvedTask.status === "DONE") {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `Task "${requestedTaskId}" is already DONE.`
+    );
+  }
+  if (resolvedTask.status !== "DOING" && resolvedTask.status !== "REVIEW") {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `Task "${requestedTaskId}" must be DOING/REVIEW before marking it DONE.`
+    );
+  }
+  lines[resolvedTask.index] = setTaskStatus2(resolvedTask, "DONE");
+  await fs.writeFile(tasksPath, lines.join("\n"), "utf-8");
+  const payload = {
+    status: "ok",
+    reasonCode: "TASK_COMPLETED",
+    feature: feature.folderName,
+    taskId: resolvedTask.taskId,
+    title: resolvedTask.title,
+    previousStatus: resolvedTask.status,
+    nextStatus: "DONE",
+    substateId: "task_complete",
+    owner: "main",
+    nextMainState: "task_finalize",
+    tasksUpdated: true,
+    tasksPath,
+    recordedAt: getLocalDateString()
+  };
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  console.log(
+    chalk8.green(
+      `Marked task ${resolvedTask.taskId} as DONE for ${feature.folderName}.`
+    )
+  );
+  console.log(chalk8.gray(`- tasks.md updated: ${tasksPath}`));
+  console.log(chalk8.gray(`- status: ${resolvedTask.status} -> DONE`));
+  console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
+}
+function taskCompleteCommand(program2) {
+  program2.command("task-complete [feature-name]").description("Mark the active DOING/REVIEW task as DONE").option("--component <component>", "Component name for multi projects").option("--task <task-id>", "Explicit task id to mark DONE").option("--json", "Output JSON").action(
+    async (featureName, options) => {
+      try {
+        await runTaskComplete(featureName, options);
+      } catch (error) {
+        const config = await getConfig(process.cwd());
+        const lang = config?.lang ?? DEFAULT_LANG;
+        const cliError = toCliError(error);
+        const suggestions = getCliErrorSuggestions(cliError.code, lang);
+        if (options.json) {
+          console.log(
+            JSON.stringify({
+              status: "error",
+              reasonCode: cliError.code,
+              error: cliError.message,
+              suggestions
+            })
+          );
+        } else {
+          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          printCliErrorSuggestions(suggestions, lang);
+        }
+        process.exitCode = 1;
+      }
+    }
+  );
+}
 function isBannerDisabled() {
   const v = (process.env.LEE_SPEC_KIT_NO_BANNER || "").trim();
   return v === "1";
@@ -16797,6 +16990,7 @@ onboardCommand(program);
 prePrReviewCommand(program);
 codeReviewRunCommand(program);
 taskRunCommand(program);
+taskCompleteCommand(program);
 requirementsCommand(program);
 await program.parseAsync();
 //# sourceMappingURL=index.js.map