lee-spec-kit 0.7.10 → 0.7.11

package/dist/index.js

@@ -9,6 +9,7 @@ import { spawn, spawnSync, execFileSync, execSync } from 'child_process';
 import os from 'os';
 import { createHash, randomUUID } from 'crypto';
 import fs13 from 'fs';
+import fs20 from 'fs/promises';
 import { Buffer as Buffer$1 } from 'buffer';
 
 var getFilename = () => fileURLToPath(import.meta.url);
@@ -212,7 +213,7 @@ var koCli = {
   "doctor.issue.tasksEmpty": "tasks.md\uC5D0 \uD0DC\uC2A4\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md\uC758 \uBB38\uC11C \uC0C1\uD0DC(Doc Status)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md\uC5D0 \uBB38\uC11C \uC0C1\uD0DC(Doc Status) \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **\uBB38\uC11C \uC0C1\uD0DC**: -`\uC640 `\uAC12: Draft | Review | Approved`\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
-  "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C PRD-FR-001 \uAC19\uC740 ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C `PRD-*` ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
   "doctor.issue.unmanagedDocsEntry": "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {path}. \uCD5C\uC885 SSOT\uB85C \uC4F0\uC9C0 \uB9D0\uACE0 feature-local docs\uB85C \uC815\uADDC\uD654\uD558\uAC70\uB098, \uC758\uB3C4\uB41C \uACBD\uB85C\uB77C\uBA74 `.lee-spec-kit.json`\uC758 `allowedDocsEntries`\uC5D0 \uCD94\uAC00\uD558\uC138\uC694.",
   "doctor.issue.duplicateFeatureId": "\uC911\uBCF5 Feature ID \uAC10\uC9C0: {id} ({count}\uAC1C)",
   "doctor.issue.missingFeatureId": "Feature \uD3F4\uB354\uBA85\uC774 F001-... \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4. (ID\uB97C \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC74C)",
@@ -478,7 +479,7 @@ var koContext = {
   "context.checkRequired": "[\uD655\uC778 \uD544\uC694] ",
   "context.checkPolicyHint": "\u2139\uFE0F  \uC0AC\uC6A9\uC790 \uD655\uC778 \uC815\uCC45\uC740 \uC138\uC158 \uC2DC\uC791(\uB610\uB294 context \uC555\uCD95/\uB9AC\uC14B \uC9C1\uD6C4)\uC5D0 1\uD68C \uD655\uC778\uD558\uACE0, \uC774\uD6C4\uC5D0\uB294 \uC815\uCC45/\uC124\uC815 \uBCC0\uACBD \uB610\uB294 \uC0AC\uC6A9\uC790 \uC0C8\uB85C\uACE0\uCE68 \uC694\uCCAD \uC2DC\uC5D0\uB9CC \uC7AC\uD655\uC778\uD558\uC138\uC694. (git push/merge/merge commit \uD3EC\uD568) [\uD655\uC778 \uD544\uC694]\uAC00 \uC788\uC73C\uBA74 \uB77C\uBCA8 \uD1A0\uD070 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC5D0 \uB9DE\uB294 \uC751\uB2F5\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589\uD558\uC138\uC694. (config: approval\uB85C \uC870\uC815 \uAC00\uB2A5)",
   "context.actionOptionHint": "\uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59: `A`, `A OK`, `A \uC9C4\uD589\uD574` \uC911 \uD558\uB098\uC758 \uD615\uC2DD\uC73C\uB85C \uC751\uB2F5",
-  "context.actionExplainHint": "CLI\uAC00 \uC900 \uC2B9\uC778 \uBB38\uAD6C\uB97C \uBA3C\uC800 \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uC138\uC694. \uCD94\uAC00 \uC124\uBA85\uC740 \uC0AC\uC6A9\uC790\uAC00 \uBB3C\uC744 \uB54C\uB9CC \uB367\uBD99\uC774\uACE0, \uC2B9\uC778 \uBB38\uAD6C \uC790\uCCB4\uB294 \uBC14\uAFB8\uC9C0 \uB9C8\uC138\uC694.",
+  "context.actionExplainHint": "\uC2B9\uC778 \uB300\uAE30 \uC0C1\uD0DC\uB77C\uBA74 `matchedFeature.currentSubstate*` \uAE30\uBC18 \uD604\uC7AC \uB2E8\uACC4 \uD55C \uC904 \uC694\uC57D\uC744 \uBA3C\uC800 \uBD99\uC77C \uC218 \uC788\uACE0, \uADF8 \uB2E4\uC74C CLI\uAC00 \uC900 \uC2B9\uC778 \uBB38\uAD6C\uB97C \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uC138\uC694. \uCD94\uAC00 \uC124\uBA85\uC740 \uC0AC\uC6A9\uC790\uAC00 \uBB3C\uC744 \uB54C\uB9CC \uB367\uBD99\uC774\uACE0, \uC2B9\uC778 \uBB38\uAD6C \uC790\uCCB4\uB294 \uBC14\uAFB8\uC9C0 \uB9C8\uC138\uC694.",
   "context.finalLabelPrompt": "\uD604\uC7AC \uC120\uD0DD \uAC00\uB2A5\uD55C \uB77C\uBCA8: {labels}. \uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC73C\uB85C \uC751\uB2F5\uD558\uC138\uC694. (\uC608: `{example}`)",
   "context.finalLabelPromptWithRequest": "\uD604\uC7AC \uC120\uD0DD \uAC00\uB2A5\uD55C \uB77C\uBCA8: {labels}. \uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC73C\uB85C \uC751\uB2F5\uD558\uC138\uC694. (\uC608: `{example}`) \uC694\uCCAD \uD14D\uC2A4\uD2B8\uAC00 \uD544\uC694\uD55C \uB77C\uBCA8\uC740 \uB2E4\uC74C \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD558\uC138\uC694: {requestExamples}",
   "context.suggestionHeader": "\uCD94\uCC9C \uB2E4\uC74C \uC120\uD0DD\uC9C0",
@@ -508,6 +509,7 @@ var koContext = {
   "context.actionDetail.tasksWriteCreate": "tasks.md\uB97C \uC0DD\uC131\uD558\uACE0 \uBB38\uC11C \uC0C1\uD0DC\uB97C Review\uB85C \uC124\uC815\uD558\uC138\uC694",
   "context.actionDetail.tasksWriteNeedAtLeastOne": "tasks.md\uC5D0 \uCD5C\uC18C 1\uAC1C \uC774\uC0C1\uC758 \uD0DC\uC2A4\uD06C\uB97C \uCD94\uAC00\uD558\uC138\uC694",
   "context.actionDetail.tasksWriteImprove": "tasks.md\uB97C \uBCF4\uC644\uD558\uACE0 \uBB38\uC11C \uC0C1\uD0DC\uB97C \uC815\uB82C\uD558\uC138\uC694",
+  "context.actionDetail.tasksWriteChangeSync": "\uCD94\uAC00 \uAD6C\uD604 \uC804\uC5D0 \uC0C8 \uC0AC\uC6A9\uC790 \uC694\uCCAD\uC744 tasks.md\uC5D0 \uBA3C\uC800 \uBC18\uC601\uD558\uC138\uC694",
   "context.actionDetail.tasksApprove": "tasks.md\uB97C \uC2B9\uC778\uD569\uB2C8\uB2E4",
   "context.actionDetail.issueCreate": "\uC774\uC288\uB97C \uC0DD\uC131\uD558\uACE0 tasks.md\uC758 \uC774\uC288 \uC815\uBCF4\uB97C \uB9DE\uCD94\uC138\uC694",
   "context.actionDetail.issueCreateAndWrite": "\uC774\uC288 \uCD08\uC548\uC744 \uBCF4\uC644\uD558\uACE0 \uB77C\uBCA8 \uC2B9\uC778(`A` \uB610\uB294 `A OK`) \uD6C4 \uC774\uC288\uB97C \uC0DD\uC131\uD574 \uBC88\uD638\uB97C \uB3D9\uAE30\uD654\uD558\uC138\uC694",
@@ -680,6 +682,7 @@ var koMessages = {
   featureScopeSplitTwo: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) \uAD8C\uC7A5 \uADDC\uCE59\uC0C1 40~79 \uD0DC\uC2A4\uD06C\uC774\uBA74\uC11C \uD558\uB4DC \uAE30\uC900 \uBBF8\uB9CC\uC774\uBA74 2\uAC1C \uC774\uC288 \uBD84\uD560\uC774 \uAE30\uBCF8\uC785\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C \uACB0\uD569\uB3C4/\uD30C\uC77C\uACB9\uCE68/\uD14C\uC2A4\uD2B8/\uBC30\uD3EC \uAE30\uC900\uC73C\uB85C \uBD84\uD560\uD558\uC138\uC694. \uAC01 \uC774\uC288\uC5D0\uB294 \uB2E4\uC74C \uD15C\uD50C\uB9BF\uC744 \uAE30\uB85D\uD558\uC138\uC694: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   featureScopeSplitFour: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}\uC774\uBA74 4\uAC1C \uC774\uC288 \uBD84\uD560\uC744 \uAC15\uD558\uAC8C \uAD8C\uC7A5\uD569\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C 4\uAC1C\uC758 \uC5F0\uAD00 \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uACE0 \uC758\uC874 \uC21C\uC11C\uB97C \uBA85\uC2DC\uD55C \uB4A4 PR\uC744 \uC21C\uCC28 \uBA38\uC9C0\uD558\uC138\uC694. \uAC01 \uC774\uC288 \uD15C\uD50C\uB9BF: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   userRequestReplan: "\uD604\uC7AC \uB2E8\uACC4\uC640 \uBCC4\uAC1C\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC81C\uC548\uD55C \uC0C8 \uC694\uAD6C\uB97C \uBA3C\uC800 \uBC18\uC601\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC694\uAD6C\uC0AC\uD56D\uC744 \uC694\uC57D\uD574 tasks.md\uC5D0 \uCD94\uAC00\uD558\uAC70\uB098 \uBCC4\uB3C4 Feature\uB85C \uBD84\uB9AC\uD55C \uB4A4, \uBB38\uC11C \uC0C1\uD0DC\uB97C \uB9DE\uCD94\uACE0 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+  changeRequestSync: 'tasks.md\uC5D0 \uC0C8 \uC0AC\uC6A9\uC790 \uC694\uCCAD\uC774 \uAE30\uB85D\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: "{request}". \uCD94\uAC00 \uAD6C\uD604 \uC804\uC5D0 \uBA3C\uC800 tasks.md\uB97C \uAC31\uC2E0\uD558\uC138\uC694. \uC601\uD5A5\uBC1B\uB294 \uD0DC\uC2A4\uD06C\uB97C \uCD94\uAC00\uD558\uAC70\uB098 \uC7AC\uD0DC\uAE45\uD558\uACE0, \uC774 \uC694\uCCAD\uC774 \uC2E4\uC81C \uC0AC\uC6A9\uC790 \uB3D9\uC791\uC774\uB098 \uBC94\uC704\uB97C \uBC14\uAFB8\uBA74 decisions.md\uC640 spec/PRD \uCC38\uC870\uB3C4 \uD568\uAED8 \uB9DE\uCD94\uC138\uC694. \uB3D9\uAE30\uD654\uAC00 \uB05D\uB098\uBA74 `\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD` \uAC12\uC744 \uBE44\uC6B0\uACE0 context/flow\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.',
   docsUnmanagedNormalize: "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {paths}. Feature `{featureRef}`\uB97C \uACC4\uC18D \uC9C4\uD589\uD558\uAE30 \uC804\uC5D0 \uC774 \uBB38\uC11C\uB4E4\uC740 reference \uC785\uB825\uC73C\uB85C\uB9CC \uCDE8\uAE09\uD558\uC138\uC694. \uC0AC\uC6A9\uC790 \uBC94\uC704/acceptance\uB294 `spec.md`, \uC544\uD0A4\uD14D\uCC98/\uD30C\uC77C/\uD14C\uC2A4\uD2B8 \uB0B4\uC6A9\uC740 `plan.md`, \uC2E4\uD589 \uC791\uC5C5\uC740 `tasks.md`, \uADFC\uAC70/\uD2B8\uB808\uC774\uB4DC\uC624\uD504\uB294 `decisions.md`\uB85C \uC815\uADDC\uD654\uD55C \uB4A4 `npx lee-spec-kit context {featureRef}`\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   featureDone: "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC694\uAD6C\uC0AC\uD56D\uACFC \uB85C\uCEEC \uC815\uB9AC\uAE4C\uC9C0 \uBAA8\uB450 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uC804\uD788 \uC885\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.",
   fallbackRerunContext: "\uC0C1\uD0DC\uB97C \uD310\uBCC4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694."
@@ -789,7 +792,7 @@ var enCli = {
   "doctor.issue.tasksEmpty": "tasks.md has no tasks.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md Doc Status is not set. (Set it to Draft, Review, or Approved.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md is missing the Doc Status field. Add `- **Doc Status**: -` and `Values: Draft | Review | Approved`.",
-  "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent IDs like PRD-FR-001 in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent `PRD-*` IDs in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
   "doctor.issue.unmanagedDocsEntry": "Unmanaged docs entry detected outside the lee-spec-kit docs surface: {path}. Treat it as reference input only, normalize it into feature-local docs, or allowlist it in `.lee-spec-kit.json` `allowedDocsEntries`.",
   "doctor.issue.duplicateFeatureId": "Duplicate Feature ID detected: {id} ({count})",
   "doctor.issue.missingFeatureId": "Feature folder name is not in F001-... format. (Cannot extract ID)",
@@ -1055,7 +1058,7 @@ var enContext = {
   "context.checkRequired": "[CHECK required] ",
   "context.checkPolicyHint": "\u2139\uFE0F  Check user-approval policy once at session start (or right after context compression/reset); re-check only when policy/config changes or the user explicitly requests refresh. (includes git push/merge and merge commits). If you see [CHECK required], wait for a reply that follows label-token rules (`A`, `A OK`, `A proceed`) before proceeding (config: approval can override)",
   "context.actionOptionHint": "Label reply rules: answer as `A`, `A OK`, or `A proceed`",
-  "context.actionExplainHint": "Use the exact approval lines from the CLI first. Add extra explanation only if the user asks, and do not paraphrase the approval prompts.",
+  "context.actionExplainHint": "If approval is pending, you may add one brief current-stage recap from `matchedFeature.currentSubstate*`, then use the exact approval lines from the CLI. Add further explanation only if the user asks, and do not paraphrase the approval prompts.",
   "context.finalLabelPrompt": "Available labels now: {labels}. Reply using label-token rules (`A`, `A OK`, `A proceed`). (e.g. `{example}`)",
   "context.finalLabelPromptWithRequest": "Available labels now: {labels}. Reply using label-token rules (`A`, `A OK`, `A proceed`). (e.g. `{example}`) Labels that require a request must be replied as: {requestExamples}",
   "context.suggestionHeader": "Suggested Next Options",
@@ -1085,6 +1088,7 @@ var enContext = {
   "context.actionDetail.tasksWriteCreate": "Create tasks.md and set Doc Status to Review",
   "context.actionDetail.tasksWriteNeedAtLeastOne": "Add at least one task to tasks.md",
   "context.actionDetail.tasksWriteImprove": "Refine tasks.md and align Doc Status",
+  "context.actionDetail.tasksWriteChangeSync": "Sync the new user request into tasks.md before more implementation",
   "context.actionDetail.tasksApprove": "Approve tasks.md",
   "context.actionDetail.issueCreate": "Create the issue and sync issue fields in tasks.md",
   "context.actionDetail.issueCreateAndWrite": "Draft issue content, get explicit OK, then create and sync Issue",
@@ -1257,6 +1261,7 @@ var enMessages = {
   featureScopeSplitTwo: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Recommendation rule: 40~79 tasks and below the hard threshold usually maps to 2 issues. Follow `{guideCommand}` and split by coupling/file-overlap/test/deploy criteria. For each new issue, document this template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   featureScopeSplitFour: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Hard recommendation is 4 issues when tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}. Follow `{guideCommand}` and split into 4 linked issues with explicit dependency order and sequential PR merges. Use the per-issue template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   userRequestReplan: "You can pause this step and handle a newly requested user requirement first. Summarize it, add it to tasks.md or split it into a separate Feature, then align document statuses and rerun context.",
+  changeRequestSync: 'A pending user request is recorded in tasks.md: "{request}". Before more implementation, update tasks.md first. Add or retag the affected task, and if this changes shipped behavior or scope, sync decisions.md plus spec/PRD references as needed. Clear `Pending Change Request` after syncing, then rerun context/flow.',
   docsUnmanagedNormalize: "Unmanaged docs entries were found outside the lee-spec-kit docs surface: {paths}. Before continuing feature `{featureRef}`, treat them as reference inputs only. Normalize user-facing scope and acceptance into `spec.md`, architecture/file/test details into `plan.md`, executable work into `tasks.md`, and rationale/trade-offs into `decisions.md`, then rerun `npx lee-spec-kit context {featureRef}`.",
   featureDone: "All workflow requirements and local cleanup are complete. This feature is fully finished.",
   fallbackRerunContext: "Cannot determine status. Check the docs and run context again."
@@ -2027,25 +2032,24 @@ Auto-run continuity (main/sub-agent orchestration):
   3. Else run \`npx lee-spec-kit context --json-compact\` (fallback: \`--json\`) and continue from current \`actionOptions\`/\`autoRun\`.
 - Pause and report to user only when:
   - \`approvalRequest.required === true\`, or
-  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\`, \`AUTO_DELEGATED_HANDOFF\`, or \`AUTO_MANUAL_REQUIRED\`, or
+  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\`, \`AUTO_DELEGATED_HANDOFF\`, \`AUTO_MANUAL_REQUIRED\`, or \`AUTO_SELECTION_REQUIRED\`, or
   - command execution fails (non-zero/error), or
   - user explicitly asks to pause.
+- Special case: if \`matchedFeature.currentSubstateId === "change_request_sync"\` or \`matchedFeature.pendingChangeRequest\` is present, treat that \`AUTO_MANUAL_REQUIRED\` state as an internal docs-sync step first, not an immediate user-facing stop. Update \`tasks.md\` first, and if shipped behavior or scope changed, sync \`decisions.md\` plus \`spec.md\` / PRD refs as needed. Clear the pending change field after syncing, then continue with fresh \`context\`/\`flow\`. Only pause/report there if approval becomes required, execution fails, or the user explicitly asked to pause.
 
 User-facing output rule (state-aware):
 
 - Treat approval as a separate state.
-- Approval-waiting state means:
-  - \`context --json-compact\` (or \`context --json\`) includes one or more \`actionOptions\`, and
-  - you are explicitly waiting for user approval before execution.
+- Approval-waiting state means the latest \`context --json-compact\` / \`flow --json-compact\` (fallback: \`context --json\` / \`flow --json\`) shows \`approvalRequest.required === true\`.
+- Do not infer approval-waiting from conversation tone, action type, or whether \`actionOptions[]\` merely exist.
 
 In approval-waiting state:
 
-1. Show \`actionOptions[*].approvalPrompt\` lines (at minimum, the primary label line like \`A: ...\`) exactly as provided.
-2. End with \`approvalRequest.finalPrompt\` exactly as provided.
-3. Do not paraphrase or omit these lines.
-4. Prefer \`approvalRequest.userFacingLines\` as the source for user-facing approval text.
-5. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT.
-6. When \`matchedFeature.currentSubstateOwner="subagent"\` and \`agentOrchestration.subAgentHandoff.required=true\` with \`mode="command"\`, call \`spawn_agent\` first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, continue the delegated work immediately and do not re-open the same approval label.
+1. If \`matchedFeature.currentSubstateId\` is present, prepend one brief current-stage recap derived from \`matchedFeature.currentSubstateId/currentSubstateOwner/currentSubstatePhase\`.
+2. Then show \`approvalRequest.userFacingLines\` exactly as provided. If those lines are unavailable, fall back to \`actionOptions[*].approvalPrompt\` plus \`approvalRequest.finalPrompt\`.
+3. Do not paraphrase, reorder, or omit the CLI-provided approval lines.
+4. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT.
+5. When \`matchedFeature.currentSubstateOwner="subagent"\` and \`agentOrchestration.subAgentHandoff.required=true\` with \`mode="command"\`, call \`spawn_agent\` first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, continue the delegated work immediately and do not re-open the same approval label.
 
 In non-approval state (progress updates, analysis, tool execution logs, unrelated Q&A):
 
@@ -2056,10 +2060,11 @@ In non-approval state (progress updates, analysis, tool execution logs, unrelate
 If approval is still pending after answering an unrelated question:
 
 - First answer the question.
-- Then re-open approval using both:
-  - \`actionOptions[*].approvalPrompt\` (label meaning included), and
-  - \`approvalRequest.finalPrompt\` (format line).
-- Never output \`finalPrompt\` alone without the matching \`A: ...\` prompt.`;
+- Re-check the latest \`approvalRequest.required\`.
+- If it is still \`true\`, re-open approval with:
+  - one brief current-stage recap from \`matchedFeature.currentSubstateId/currentSubstateOwner/currentSubstatePhase\` when available, then
+  - the exact CLI-provided approval lines from \`approvalRequest.userFacingLines\` (fallback: \`actionOptions[*].approvalPrompt\` + \`approvalRequest.finalPrompt\`).
+- Never output \`finalPrompt\` alone without the matching \`A: ...\` prompt, and do not add custom label-summary wrappers such as \`Available labels:\`.`;
 function renderManagedSegment(lang, docsRepo) {
   return `${LEE_SPEC_KIT_AGENTS_BEGIN}
 ${CANONICAL_LEE_SPEC_KIT_AGENTS_TEXT}
@@ -4282,6 +4287,9 @@ function isCompletionChecklistDone(feature) {
 function isTasksDocApproved(feature) {
   return !feature.docs.tasksDocStatusFieldExists || feature.tasksDocStatus === "Approved";
 }
+function hasPendingChangeRequest(feature) {
+  return typeof feature.pendingChangeRequest === "string" && feature.pendingChangeRequest.trim().length > 0;
+}
 function isImplementationDone(feature) {
   return feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature);
 }
@@ -4652,7 +4660,18 @@ function getStepDefinitions(ctx) {
     prePrReviewPolicy,
     taskCommitGatePolicy
   } = resolveWorkflowRuntime(ctx.config.workflow);
-  const isTaskExecuteCurrent = (f) => f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && isTasksDocApproved(f) && (!workflowPolicy.requireBranch || f.git.onExpectedBranch || f.tasks.done === f.tasks.total);
+  const isTaskExecuteCurrent = (f) => f.docs.tasksExists && f.tasks.total > 0 && (hasPendingChangeRequest(f) || f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && isTasksDocApproved(f) && (!workflowPolicy.requireBranch || f.git.onExpectedBranch || f.tasks.done === f.tasks.total);
+  const getChangeRequestSyncActions = (f) => [
+    {
+      type: "instruction",
+      category: "tasks_write",
+      requiresUserCheck: false,
+      uiDetailKey: "context.actionDetail.tasksWriteChangeSync",
+      message: tr(lang, "messages", "changeRequestSync", {
+        request: f.pendingChangeRequest || "-"
+      })
+    }
+  ];
   const isTaskExecuteWorktreeBlocked = (f) => isTaskExecuteCurrent(f) && workflowPolicy.requireWorktree && f.tasks.done < f.tasks.total && !!f.issueNumber && !f.git.projectInManagedWorktree;
   const isTaskExecuteFinalize = (f) => isTaskExecuteCurrent(f) && f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f);
   const isTaskExecuteCommitPending = (f) => isTaskExecuteCurrent(f) && (isTaskExecuteFinalize(f) && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges) || !!f.nextTodoTask && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges));
@@ -5453,6 +5472,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
         detail: (f) => f.tasks.total > 0 ? `(${f.tasks.done}/${f.tasks.total})` : ""
       },
       substates: [
+        {
+          id: "change_request_sync",
+          phase: "ready",
+          owner: "main",
+          category: "tasks_write",
+          when: (f) => isTaskExecuteCurrent(f) && hasPendingChangeRequest(f),
+          actions: (f) => getChangeRequestSyncActions(f)
+        },
         {
           id: "task_blocked",
           phase: "blocked",
@@ -6364,6 +6391,15 @@ function extractFirstSpecValue(content, keys) {
   }
   return void 0;
 }
+function parsePendingChangeRequest(value) {
+  if (!value) return void 0;
+  const normalized = value.trim().replace(/\s+/g, " ");
+  if (!normalized) return void 0;
+  if (/^(?:-|#|none|n\/a|na|없음|미정)$/i.test(normalized)) {
+    return void 0;
+  }
+  return normalized;
+}
 function parseDocStatus(value) {
   if (!value) return void 0;
   const trimmed = value.trim();
@@ -7190,6 +7226,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   let lastDoneTask;
   let nextTodoTask;
   let tasksDocStatus;
+  let pendingChangeRequest;
   let tasksDocStatusFieldExists = false;
   let completionChecklist;
   let prePrReviewStatus;
@@ -7251,6 +7288,11 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       "Doc Status"
     ]);
     tasksDocStatus = parseDocStatus(tasksDocStatusValue);
+    const pendingChangeRequestValue = extractFirstSpecValue(content, [
+      "Pending Change Request",
+      "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD"
+    ]);
+    pendingChangeRequest = parsePendingChangeRequest(pendingChangeRequestValue);
     const prValue = extractFirstSpecValue(content, ["PR", "Pull Request"]);
     prFieldExists = hasAnySpecKey(content, ["PR", "Pull Request"]);
     prLink = parsePrLink(prValue);
@@ -7657,6 +7699,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     folderName,
     type,
     path: featurePath,
+    pendingChangeRequest,
     completion: {
       implementationDone,
       workflowDone,
@@ -10186,6 +10229,81 @@ async function consumeApprovalTicket(config, token, expected) {
 }
 
 // src/services/ActionExecutor.ts
+var PENDING_CHANGE_REQUEST_KEYS = [
+  "Pending Change Request",
+  "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD"
+];
+function escapeRegExp5(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findSpecLineIndex(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:`,
+    "i"
+  );
+  return lines.findIndex((line) => re.test(line));
+}
+function replaceSpecLine(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`,
+    "i"
+  );
+  if (!re.test(line)) return line;
+  return line.replace(re, `$1${preferredKey}$2${value}`);
+}
+function computeSpecInsertIndex(lines, anchorKeys) {
+  const anchorIndex = findSpecLineIndex(lines, anchorKeys);
+  if (anchorIndex !== -1) {
+    let cursor = anchorIndex + 1;
+    while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
+      cursor += 1;
+    }
+    return cursor;
+  }
+  const sectionIndex = lines.findIndex(
+    (line) => /^\s*##\s+(Task List|태스크 목록)\s*$/.test(line)
+  );
+  if (sectionIndex !== -1) return sectionIndex;
+  return lines.length;
+}
+function upsertPendingChangeRequestLine(content, requestText, lang) {
+  const normalizedRequest = requestText.trim().replace(/\s+/g, " ");
+  const preferredKey = lang === "ko" ? "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD" : "Pending Change Request";
+  const lines = content.split("\n");
+  const index = findSpecLineIndex(lines, PENDING_CHANGE_REQUEST_KEYS);
+  if (index !== -1) {
+    lines[index] = replaceSpecLine(
+      lines[index],
+      PENDING_CHANGE_REQUEST_KEYS,
+      preferredKey,
+      normalizedRequest
+    );
+    return lines.join("\n");
+  }
+  const insertAt = computeSpecInsertIndex(lines, [
+    "Branch",
+    "\uBE0C\uB79C\uCE58",
+    "Issue",
+    "Issue Number",
+    "\uC774\uC288 \uBC88\uD638"
+  ]);
+  lines.splice(insertAt, 0, `- **${preferredKey}**: ${normalizedRequest}`);
+  return lines.join("\n");
+}
+async function persistPendingChangeRequest(featurePath, requestText, lang) {
+  const tasksPath = path16.join(featurePath, "tasks.md");
+  let content;
+  try {
+    content = await fs20.readFile(tasksPath, "utf-8");
+  } catch {
+    return;
+  }
+  const nextContent = upsertPendingChangeRequestLine(content, requestText, lang);
+  if (nextContent === content) return;
+  await fs20.writeFile(tasksPath, nextContent, "utf-8");
+}
 function executeCommandAction(cmd, jsonMode, cwd) {
   const shellPath = process.env.SHELL || (process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh");
   if (jsonMode) {
@@ -10326,6 +10444,17 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     action: freshSelected.action
   });
   const featureRef = freshState.matchedFeature.folderName;
+  if (selectedAction.category === "user_request_replan" && userRequest && freshState.matchedFeature.docs.tasksExists) {
+    await withFileLock(
+      getDocsLockPath(config.docsDir),
+      async () => persistPendingChangeRequest(
+        freshState.matchedFeature.path,
+        userRequest,
+        lang
+      ),
+      { owner: "context-approve:pending-change-request" }
+    );
+  }
   if (!options.execute) {
     const ticket = executeRequiresTicket ? await issueApprovalTicket(config, {
       contextVersion: freshState.contextVersion,
@@ -10893,7 +11022,7 @@ async function runContext(featureName, options) {
       approvalRequest: {
         guidance: approvalGuidance.replace(
           "Before asking for approval, show only `actionOptions[].approvalPrompt` lines and `approvalRequest.finalPrompt` to the user.",
-          "User-facing output must include only approval prompts (`A: ...`) and `finalPrompt`."
+          "If approval is pending, you may prepend one brief current-stage recap derived from `matchedFeature.currentSubstate*`, then user-facing output must reuse the exact approval prompts (`A: ...`) and `finalPrompt`."
         ),
         required: approvalRequired,
         finalPrompt: finalApprovalPrompt,
@@ -11245,9 +11374,10 @@ function printChecklist(f, stepDefinitions) {
     console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
   });
 }
-var PRD_REQUIREMENT_ID_RE = /\bPRD-(?:FR|US|NFR)-\d+\b/gi;
+var PRD_REQUIREMENT_ID_EXACT_RE = /^PRD-[A-Z0-9]+(?:-[A-Z0-9]+)*$/i;
+var PRD_REQUIREMENT_ID_RE = /\bPRD-[A-Z0-9]+(?:-[A-Z0-9]+)*\b/gi;
 function isPrdRequirementId(value) {
-  return /^PRD-(?:FR|US|NFR)-\d+$/i.test(value.trim());
+  return PRD_REQUIREMENT_ID_EXACT_RE.test(value.trim());
 }
 function isNonPrdTag(value) {
   const trimmed = value.trim();
@@ -12372,8 +12502,13 @@ function toCompactStatusReport(report) {
   };
 }
 function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
+  const resumableStatuses = /* @__PURE__ */ new Set([
+    "delegated_handoff",
+    "gate_reached",
+    "manual_required"
+  ]);
   const resumeCommand = autoRun?.run?.resumeCommand || autoRun?.resume?.flowCommand || null;
-  const handoffRequired = !!autoRun && !!resumeCommand;
+  const handoffRequired = !!autoRun && !!resumeCommand && resumableStatuses.has(autoRun.status);
   const verifyCacheKey = handoffRequired ? `${(featureRef || "unknown").toLowerCase()}|${Buffer$1.from(
     resumeCommand
   ).toString("base64").slice(0, 12)}` : "";
@@ -12629,7 +12764,10 @@ function resolveAutoMode(config, options, requestText) {
   if (requestText) {
     return resolveConfigDefaultAutoMode(config);
   }
-  return null;
+  if (options.approve || options.execute || options.resume) {
+    return null;
+  }
+  return resolveConfigDefaultAutoMode(config);
 }
 function toAutoReasonCode(status) {
   const map = {
@@ -12647,8 +12785,6 @@ function toAutoReasonCode(status) {
 }
 function isAutoRunFailureStatus(status) {
   return [
-    "manual_required",
-    "selection_required",
     "no_progress",
     "request_label_missing",
     "request_failed",
@@ -12660,10 +12796,10 @@ function toFlowRunStatus(status) {
     case "delegated_handoff":
     case "gate_reached":
     case "manual_required":
+    case "selection_required":
       return "paused";
     case "no_action_options":
       return "completed";
-    case "selection_required":
     case "no_progress":
     case "request_label_missing":
     case "request_failed":
@@ -12757,7 +12893,7 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
         executions,
         gate: null,
         manual: null,
-        error: "Auto-run requires a single matched feature. Specify the feature explicitly."
+        error: "Auto-run paused because a single matched feature is required before execution can continue."
       };
     }
     if (actionOptions.length === 0) {
@@ -13004,7 +13140,9 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
 
 // src/commands/flow.ts
 function flowCommand(program2) {
-  program2.command("flow [feature-name]").description("Run combined workflow checks (context + status + doctor)").option("--json", "Output in JSON format for agents").option(
+  program2.command("flow [feature-name]").description(
+    "Run the default workflow auto-loop and pause at selection/approval/manual/resume boundaries"
+  ).option("--json", "Output in JSON format for agents").option(
     "--json-compact",
     "Output compact JSON for agents (implies --json, reduced duplication)"
   ).option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option(
@@ -13184,14 +13322,6 @@ async function runFlow(featureName, options) {
       }
     }
   }
-  if (autoMode && !featureName) {
-    if (!resolvedFeatureName) {
-      throw createCliError(
-        "CONTEXT_SELECTION_REQUIRED",
-        "Auto mode requires explicit <feature-name> (e.g. F004)."
-      );
-    }
-  }
   if (options.startAuto && !autoMode) {
     throw createCliError(
       "INVALID_ARGUMENT",
@@ -13672,13 +13802,13 @@ function parseLabels(raw, lang) {
   }
   return [...new Set(labels)];
 }
-function escapeRegExp5(value) {
+function escapeRegExp6(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractDraftMetadataValue(content, keys) {
   for (const key of keys) {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp5(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp6(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
       "mi"
     );
     const match = content.match(re);
@@ -13797,7 +13927,7 @@ function ensureSections(body, sections, kind, lang) {
   };
   const hasMetadataField = (field) => {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp5(field)}\\*\\*\\s*:`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp6(field)}\\*\\*\\s*:`,
       "m"
     );
     return re.test(body);
@@ -14685,7 +14815,7 @@ function stripMarkdownCodeContexts(body) {
 function hasIssueClosingKeyword(body, issueNumber) {
   if (!issueNumber) return false;
   const cleaned = stripMarkdownCodeContexts(body);
-  const issue = escapeRegExp5(issueNumber);
+  const issue = escapeRegExp6(issueNumber);
   const closeKeywordRegex = new RegExp(
     `\\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\\b\\s*(?:[a-zA-Z0-9_.-]+\\/)?#\\s*${issue}\\b`,
     "i"
@@ -17134,7 +17264,7 @@ var DEFAULT_EVIDENCE_FOR_ANY_MODE = {
   residualRisks: ["none"],
   commandsExecuted: []
 };
-function escapeRegExp6(value) {
+function escapeRegExp7(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function normalizeDecision(raw) {
@@ -17147,15 +17277,15 @@ function normalizeDecision(raw) {
   if (value === "blocked" || value === "block") return "blocked";
   return null;
 }
-function findSpecLineIndex(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+function findSpecLineIndex2(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
   );
   return lines.findIndex((line) => re.test(line));
 }
-function replaceSpecLine(line, keys, preferredKey, value) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+function replaceSpecLine2(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -17163,7 +17293,7 @@ function replaceSpecLine(line, keys, preferredKey, value) {
   return line.replace(re, `$1${preferredKey}$2${value}`);
 }
 function computeInsertIndex(lines, anchorKeys) {
-  const anchorIndex = findSpecLineIndex(lines, anchorKeys);
+  const anchorIndex = findSpecLineIndex2(lines, anchorKeys);
   if (anchorIndex !== -1) {
     let cursor = anchorIndex + 1;
     while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
@@ -17179,9 +17309,9 @@ function computeInsertIndex(lines, anchorKeys) {
 }
 function upsertSpecLine(content, keys, preferredKey, value, anchorKeys) {
   const lines = content.split("\n");
-  const index = findSpecLineIndex(lines, keys);
+  const index = findSpecLineIndex2(lines, keys);
   if (index !== -1) {
-    lines[index] = replaceSpecLine(lines[index], keys, preferredKey, value);
+    lines[index] = replaceSpecLine2(lines[index], keys, preferredKey, value);
     return lines.join("\n");
   }
   const insertAt = computeInsertIndex(lines, anchorKeys);
@@ -17679,18 +17809,18 @@ async function runPrePrReview(featureName, options) {
   }
   console.log();
 }
-function escapeRegExp7(value) {
+function escapeRegExp8(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function findSpecLineIndex2(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp7(key));
+function findSpecLineIndex3(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp8(key));
   const re = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
   );
   return lines.findIndex((line) => re.test(line));
 }
-function replaceSpecLine2(line, keys, preferredKey, value) {
-  const escaped = keys.map((key) => escapeRegExp7(key));
+function replaceSpecLine3(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp8(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -17698,7 +17828,7 @@ function replaceSpecLine2(line, keys, preferredKey, value) {
   return line.replace(re, `$1${preferredKey}$2${value}`);
 }
 function computeInsertIndex2(lines, anchorKeys) {
-  const anchorIndex = findSpecLineIndex2(lines, anchorKeys);
+  const anchorIndex = findSpecLineIndex3(lines, anchorKeys);
   if (anchorIndex !== -1) {
     let cursor = anchorIndex + 1;
     while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
@@ -17714,9 +17844,9 @@ function computeInsertIndex2(lines, anchorKeys) {
 }
 function upsertSpecLine2(content, keys, preferredKey, value, anchorKeys) {
   const lines = content.split("\n");
-  const index = findSpecLineIndex2(lines, keys);
+  const index = findSpecLineIndex3(lines, keys);
   if (index !== -1) {
-    lines[index] = replaceSpecLine2(lines[index], keys, preferredKey, value);
+    lines[index] = replaceSpecLine3(lines[index], keys, preferredKey, value);
     return lines.join("\n");
   }
   const insertAt = computeInsertIndex2(lines, anchorKeys);
@@ -18495,7 +18625,7 @@ function normalizeTaskDetailItems(values, flagName) {
   }
   return normalized;
 }
-function escapeRegExp8(value) {
+function escapeRegExp9(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function findTaskListHeadingIndex(lines) {
@@ -18530,7 +18660,7 @@ function normalizeTaskRef(value) {
   if (!trimmed) {
     throw createCliError(
       "INVALID_ARGUMENT",
-      "`--ref` is required. Use `NON-PRD` or an existing `PRD-...` requirement ID."
+      "`--ref` is required. Use `NON-PRD` or an existing `PRD-*` requirement ID."
     );
   }
   if (isNonPrdTag(trimmed)) return "NON-PRD";
@@ -18538,14 +18668,14 @@ function normalizeTaskRef(value) {
   if (!isPrdRequirementId(normalized)) {
     throw createCliError(
       "INVALID_ARGUMENT",
-      "`--ref` must be `NON-PRD` or an existing `PRD-FR-001`-style requirement ID."
+      "`--ref` must be `NON-PRD` or an existing `PRD-*` requirement ID (for example `PRD-FR-001` or `PRD-SCOPE-V1-DESKTOP-EDITOR`)."
     );
   }
   return normalized;
 }
 function getNextTaskSequence(content, featureFolderName) {
   const taskIdPattern = new RegExp(
-    `\\bT-${escapeRegExp8(featureFolderName)}-(\\d+)\\b`,
+    `\\bT-${escapeRegExp9(featureFolderName)}-(\\d+)\\b`,
     "g"
   );
   let max = 0;
@@ -18675,7 +18805,7 @@ async function runTaskAdd(featureName, options) {
 }
 function taskCommand(program2) {
   const task = program2.command("task").description("Manage tasks");
-  task.command("add [feature-name]").description("Append a new task to the end of Task List").requiredOption("--title <title>", "Task title").requiredOption("--ref <ref>", "Requirement ref: NON-PRD or PRD-FR-001").option(
+  task.command("add [feature-name]").description("Append a new task to the end of Task List").requiredOption("--title <title>", "Task title").requiredOption("--ref <ref>", "Requirement ref: NON-PRD or existing PRD-* key").option(
     "--acceptance <text>",
     "Acceptance item. Repeat to add more than one.",
     collectRepeatableOption,