lee-spec-kit 0.7.0 → 0.7.2

package/dist/index.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import path12 from 'path';
+import path13 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import fs from 'fs-extra';
 import prompts from 'prompts';
-import chalk8 from 'chalk';
+import chalk9 from 'chalk';
 import { spawn, spawnSync, execFileSync, execSync } from 'child_process';
 import os from 'os';
 import { createHash, randomUUID } from 'crypto';
-import fs9 from 'fs';
+import fs10 from 'fs';
 import { Buffer as Buffer$1 } from 'buffer';
 
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path12.dirname(getFilename());
+var getDirname = () => path13.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function walkFiles(fsAdapter, rootDir, options = {}) {
   const out = [];
@@ -25,7 +25,7 @@ async function walkFiles(fsAdapter, rootDir, options = {}) {
   async function visit(current) {
     const entries = await fsAdapter.readdir(current);
     for (const entryName of entries) {
-      const absolute = path12.join(current, entryName);
+      const absolute = path13.join(current, entryName);
       const stat = await fsAdapter.stat(absolute);
       if (stat.isDirectory()) {
         if (ignored.has(entryName.trim().toLowerCase())) continue;
@@ -34,7 +34,7 @@ async function walkFiles(fsAdapter, rootDir, options = {}) {
       }
       if (!stat.isFile()) continue;
       if (normalizedExtensions.size > 0) {
-        const ext = path12.extname(entryName).toLowerCase();
+        const ext = path13.extname(entryName).toLowerCase();
         if (!normalizedExtensions.has(ext)) continue;
       }
       out.push(absolute);
@@ -50,7 +50,7 @@ async function listSubdirectories(fsAdapter, rootDir) {
   const entries = await fsAdapter.readdir(rootDir);
   const dirs = [];
   for (const entryName of entries) {
-    const absolute = path12.join(rootDir, entryName);
+    const absolute = path13.join(rootDir, entryName);
     const stat = await fsAdapter.stat(absolute);
     if (stat.isDirectory()) {
       dirs.push(absolute);
@@ -151,10 +151,10 @@ var DefaultFileSystemAdapter = class {
   }
 };
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path12.dirname(__filename2);
+var __dirname2 = path13.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path12.resolve(__dirname2, "..");
-  return path12.join(rootDir, "templates");
+  const rootDir = path13.resolve(__dirname2, "..");
+  return path13.join(rootDir, "templates");
 }
 
 // src/utils/locales/ko/cli.ts
@@ -175,6 +175,8 @@ var koCli = {
   "feature.nextSteps1": "  1. {path}/spec.md \uC791\uC131",
   "feature.nextSteps2": "  2. \uC0AC\uC6A9\uC790 \uB9AC\uBDF0 \uC694\uCCAD",
   "feature.nextSteps3": "  3. \uC2B9\uC778 \uD6C4 plan.md \uC791\uC131",
+  "feature.ideaNotFound": "Idea \uBB38\uC11C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {ref}",
+  "feature.ideaAmbiguous": "{ref}\uC640 \uB9E4\uCE6D\uB418\uB294 Idea \uBB38\uC11C\uAC00 \uC5EC\uB7EC \uAC1C\uC785\uB2C8\uB2E4. \uC815\uD655\uD55C \uACBD\uB85C\uB098 \uC804\uCCB4 indexed \uC774\uB984\uC744 \uC0AC\uC6A9\uD558\uC138\uC694.",
   "config.currentTitle": "\u{1F4CB} \uD604\uC7AC \uC124\uC815:",
   "config.pathLabel": "\uACBD\uB85C",
   "config.projectRootStandaloneOnly": "\u26A0\uFE0F  projectRoot\uB294 standalone \uBAA8\uB4DC\uC5D0\uC11C\uB9CC \uC124\uC815 \uAC00\uB2A5\uD569\uB2C8\uB2E4.",
@@ -268,6 +270,13 @@ var koCli = {
   "init.log.gitInitialCommitDone": "\u2705 Git \uCD08\uAE30 \uCEE4\uBC0B \uC644\uB8CC!",
   "init.warn.skipGitInit": "\u26A0\uFE0F  Git \uCD08\uAE30\uD654\uB97C \uAC74\uB108\uB701\uB2C8\uB2E4 (\uC218\uB3D9\uC73C\uB85C \uCEE4\uBC0B\uD574\uC8FC\uC138\uC694)",
   "init.error.templateNotFound": "\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
+  "idea.fileExists": "\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 Idea \uBB38\uC11C\uC785\uB2C8\uB2E4: {path}",
+  "idea.templateNotFound": "CLI \uB0B4\uC7A5 idea \uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "idea.created": "\u2705 Idea \uBB38\uC11C \uC0DD\uC131 \uC644\uB8CC: {path}",
+  "idea.nextStepsTitle": "\uB2E4\uC74C \uB2E8\uACC4:",
+  "idea.nextSteps1": "  1. \uBC94\uC704, PRD Refs, \uC2B9\uACA9 \uBA54\uBAA8\uB97C \uC791\uC131",
+  "idea.nextSteps2": "  2. Feature\uB85C \uC2B9\uACA9: npx lee-spec-kit feature <name> --idea {ideaId}",
+  "idea.nextSteps3": "  3. Feature\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uC744 \uACBD\uC6B0 Dropped\uB85C \uD45C\uC2DC",
   "github.cmdGithubDescription": "GitHub \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uB3C4\uC6B0\uBBF8 (issue/pr \uBCF8\uBB38 \uD15C\uD50C\uB9BF \uC0DD\uC131, \uAC80\uC99D, merge \uC7AC\uC2DC\uB3C4)",
   "github.cmdIssueDescription": "feature \uBB38\uC11C \uAE30\uBC18 GitHub issue \uBCF8\uBB38 \uC0DD\uC131/\uC0DD\uC131",
   "github.cmdPrDescription": "GitHub PR \uBCF8\uBB38 \uC0DD\uC131/\uC0DD\uC131 + tasks \uB3D9\uAE30\uD654 + merge \uC7AC\uC2DC\uB3C4",
@@ -434,11 +443,15 @@ var koCli = {
   "validation.workflowModeInvalid": "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uBAA8\uB4DC\uB294 {values} \uC911 \uD558\uB098\uC5EC\uC57C \uD569\uB2C8\uB2E4.",
   "validation.featureIdEmpty": "Feature ID\uB294 \uBE44\uC5B4\uC788\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "validation.featureIdFormat": "Feature ID\uB294 'F' + \uC22B\uC790 \uD615\uC2DD\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4 (\uC608: F001).",
+  "validation.ideaIdEmpty": "Idea ID\uB294 \uBE44\uC5B4\uC788\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+  "validation.ideaIdFormat": "Idea ID\uB294 'I' + \uC22B\uC790 \uD615\uC2DD\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4 (\uC608: I001).",
   "validation.pathEmpty": "\uACBD\uB85C\uB294 \uBE44\uC5B4\uC788\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "validation.pathNullByte": "\uACBD\uB85C\uC5D0 null \uBB38\uC790\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "validation.genericFailed": "\uAC80\uC99D \uC2E4\uD328",
   "validation.context.featureName": "\uAE30\uB2A5 \uC774\uB984",
   "validation.context.featureId": "Feature ID",
+  "validation.context.ideaName": "Idea \uC774\uB984",
+  "validation.context.ideaId": "Idea ID",
   "validation.context.projectName": "\uD504\uB85C\uC81D\uD2B8 \uC774\uB984",
   "validation.context.projectType": "\uD504\uB85C\uC81D\uD2B8 \uD0C0\uC785",
   "validation.context.language": "\uC5B8\uC5B4",
@@ -626,9 +639,9 @@ var koMessages = {
   taskCommitGateReasonMismatchLastDone: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B\uC774 \uC9C1\uC804 \uC644\uB8CC \uD0DC\uC2A4\uD06C\uC640 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4",
   prLegacyAsk: "tasks.md\uC5D0 PR/PR \uC0C1\uD0DC \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uD15C\uD50C\uB9BF\uC744 \uCD5C\uC2E0 \uD3EC\uB9F7\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD560\uAE4C\uC694? (\uD655\uC778 \uD544\uC694)",
   prePrReviewFieldMissing: "tasks.md\uC5D0 `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uC804 \uB9AC\uBDF0**: Pending | Running | Done` \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewRun: "\uCF54\uB4DC \uB9AC\uBDF0 \uC5D0\uC774\uC804\uD2B8\uB97C \uC2E4\uD589\uD574 `spec.md`/`plan.md`/`tasks.md` \uB300\uBE44 \uAD6C\uD604 \uC801\uD569\uC131\uC744 \uAC80\uD1A0\uD558\uACE0, `Summary`/`Feature Intent Summary`/`Implementation Fit`/`Missing Cases`/`Spec Alignment Checked`/`Finding Count`/`Blocking Findings`/`Findings`/`Residual Risks`\uAC00 \uD3EC\uD568\uB41C `review-trace.json`\uC744 \uC0DD\uC131\uD55C \uB4A4 `pre-pr-review`\uB85C \uB9AC\uBDF0 \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. `pre-pr-review-run` \uC790\uCCB4\uB294 evidence\uB97C \uC0DD\uC131\uD558\uAC70\uB098 \uC0C1\uD0DC\uB97C \uBC14\uB85C \uB118\uAE30\uC9C0 \uC54A\uC73C\uBA70, \uD604\uC7AC evidence \uC815\uCC45\uC774 \uACBD\uB85C\uB97C \uC694\uAD6C\uD560 \uB54C\uB9CC `--evidence review-trace.json`\uC744 \uD568\uAED8 \uC0AC\uC6A9\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewRunning: "Pre-PR \uB9AC\uBDF0 handoff\uAC00 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. delegated review\uB97C \uB9C8\uCE58\uACE0 `review-trace.json`\uC744 \uB9CC\uB4E0 \uB4A4 `pre-pr-review`\uB85C \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewEvidenceMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC2E4\uC81C \uD30C\uC77C \uACBD\uB85C\uC640 `Pre-PR Review Log`(\uB610\uB294 `PR \uC804 \uB9AC\uBDF0 \uB85C\uADF8`)\uC5D0 placeholder\uAC00 \uC544\uB2CC `Summary`/`Feature Intent Summary`/`Implementation Fit`/`Missing Cases`/`Spec Alignment Checked`/`Finding Count`/`Blocking Findings`/`Decision`/`Findings`(\uB610\uB294 \uBA85\uC2DC\uC801 `0 findings`)/`Residual Risks`\uB97C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewRun: "Pre-PR \uB9AC\uBDF0 handoff\uB97C \uC900\uBE44\uD55C \uB4A4 \uC2E4\uC81C \uB9AC\uBDF0\uB97C \uC774\uC5B4\uC11C \uC218\uD589\uD558\uC138\uC694. `review-trace.json`\uC5D0\uB294 `baseSha`, `headSha`, `changedFiles`, `reviewedFiles`, `riskSummaries`, `Approval Rationale`, \uD30C\uC77C\uBCC4 findings, `Residual Risks`\uB97C \uAD6C\uC870\uD654\uD574 \uB123\uACE0, \uC774\uD6C4 `pre-pr-review`\uB85C \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. `pre-pr-review-run` \uC790\uCCB4\uB294 \uB9AC\uBDF0 \uC644\uB8CC\uB098 \uC0C1\uD0DC \uC804\uC774\uB97C \uC758\uBBF8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewRunning: "Pre-PR \uB9AC\uBDF0\uAC00 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. \uAE30\uC874 delegated review\uB97C \uC7AC\uC0AC\uC6A9\uD558\uAC70\uB098 \uC774\uC5B4\uC11C \uC218\uD589\uD574 \uAD6C\uC870\uD654\uB41C `review-trace.json`\uC744 \uB9CC\uB4E0 \uB4A4 `pre-pr-review`\uB85C \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. \uAC19\uC740 \uB77C\uBCA8\uC744 \uB2E4\uC2DC \uC2B9\uC778 \uB8E8\uD504\uB85C \uC5F4\uC9C0 \uB9C8\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewEvidenceMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. repo \uB8E8\uD2B8 \uAE30\uC900 \uC0C1\uB300\uACBD\uB85C\uB97C \uC4F0\uB294 \uC2E4\uC81C JSON \uD30C\uC77C\uC744 \uAC00\uB9AC\uD0A4\uACE0, `baseSha`, `headSha`, `changedFiles`, `reviewedFiles`, `riskSummaries`, `Approval Rationale`, \uD30C\uC77C\uBCC4 findings, `Residual Risks`\uB97C \uD3EC\uD568\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prePrReviewDecisionMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 \uBE44\uC5B4\uC788\uAC70\uB098 \uACB0\uC815 \uD615\uC2DD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `\uACB0\uC815: ...`(\uB610\uB294 `decision: ...`) \uD615\uC2DD\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prePrReviewFixRequired: "\uD604\uC7AC `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 `{decision}`\uC785\uB2C8\uB2E4. PR \uC0DD\uC131 \uB2E8\uACC4\uB85C \uC774\uB3D9\uD558\uAE30 \uC804\uC5D0 pre-PR \uC9C0\uC801\uC0AC\uD56D\uC744 \uCF54\uB4DC\uC5D0 \uBC18\uC601\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prePrReviewDecisionReconfirm: "\uD604\uC7AC `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 `{decision}`\uC785\uB2C8\uB2E4. \uC9C0\uC801\uC0AC\uD56D\uC744 \uBC18\uC601\uD55C \uB4A4 \uC774\uC804 \uC0C1\uD0DC \uC7AC\uC0AC\uC6A9\uC744 \uB9C9\uAE30 \uC704\uD574 \uBA85\uC2DC\uC801\uC73C\uB85C Decision\uC744 \uC9C0\uC815\uD574 \uC7AC\uC2E4\uD589\uD558\uC138\uC694: `{command}` (\uD655\uC778 \uD544\uC694)",
@@ -731,6 +744,8 @@ var enCli = {
   "feature.nextSteps1": "  1. Write {path}/spec.md",
   "feature.nextSteps2": "  2. Ask for review",
   "feature.nextSteps3": "  3. After approval, write plan.md",
+  "feature.ideaNotFound": "Idea document not found: {ref}",
+  "feature.ideaAmbiguous": "Multiple idea documents matched {ref}. Use an exact path or full indexed name.",
   "config.currentTitle": "\u{1F4CB} Current config:",
   "config.pathLabel": "Path",
   "config.projectRootStandaloneOnly": "\u26A0\uFE0F  projectRoot can only be set in standalone mode.",
@@ -824,6 +839,13 @@ var enCli = {
   "init.log.gitInitialCommitDone": "\u2705 Initial Git commit created!",
   "init.warn.skipGitInit": "\u26A0\uFE0F  Skipping Git initialization (please commit manually)",
   "init.error.templateNotFound": "Template not found: {path}",
+  "idea.fileExists": "Idea document already exists: {path}",
+  "idea.templateNotFound": "Built-in idea template not found.",
+  "idea.created": "\u2705 Idea document created: {path}",
+  "idea.nextStepsTitle": "Next steps:",
+  "idea.nextSteps1": "  1. Fill scope, PRD refs, and promotion notes",
+  "idea.nextSteps2": "  2. Promote it with: npx lee-spec-kit feature <name> --idea {ideaId}",
+  "idea.nextSteps3": "  3. Mark it dropped if it should not become a feature",
   "github.cmdGithubDescription": "GitHub workflow helpers (issue/pr templates, validation, merge retry)",
   "github.cmdIssueDescription": "Generate/create GitHub issue body from feature docs with validation",
   "github.cmdPrDescription": "Generate/create GitHub PR body with validation, tasks PR sync, and merge retry",
@@ -990,11 +1012,15 @@ var enCli = {
   "validation.workflowModeInvalid": "Workflow mode must be one of: {values}.",
   "validation.featureIdEmpty": "Feature ID cannot be empty.",
   "validation.featureIdFormat": "Feature ID must be 'F' + digits (e.g., F001).",
+  "validation.ideaIdEmpty": "Idea ID cannot be empty.",
+  "validation.ideaIdFormat": "Idea ID must be 'I' + digits (e.g., I001).",
   "validation.pathEmpty": "Path cannot be empty.",
   "validation.pathNullByte": "Path cannot contain null bytes.",
   "validation.genericFailed": "Validation failed",
   "validation.context.featureName": "Feature name",
   "validation.context.featureId": "Feature ID",
+  "validation.context.ideaName": "Idea name",
+  "validation.context.ideaId": "Idea ID",
   "validation.context.projectName": "Project name",
   "validation.context.projectType": "Project type",
   "validation.context.language": "Language",
@@ -1182,9 +1208,9 @@ var enMessages = {
   taskCommitGateReasonMismatchLastDone: "The latest project code commit does not match the last completed task",
   prLegacyAsk: "tasks.md is missing PR/PR Status fields. Update to the latest template format? (CHECK required)",
   prePrReviewFieldMissing: "tasks.md is missing the `Pre-PR Review` field. Add `- **Pre-PR Review**: Pending | Running | Done` and run context again. (CHECK required)",
-  prePrReviewRun: "Run the code review agent, compare the implementation against `spec.md`/`plan.md`/`tasks.md`, and generate `review-trace.json` with `Summary`, `Feature Intent Summary`, `Implementation Fit`, `Missing Cases`, `Spec Alignment Checked`, `Finding Count`, `Blocking Findings`, `Findings`, and `Residual Risks`. Then record findings with `pre-pr-review`; `pre-pr-review-run` itself does not generate evidence or advance state, and you should use `--evidence review-trace.json` only when the active evidence policy requires a path. (CHECK required)",
-  prePrReviewRunning: "Pre-PR review handoff is already in progress. Finish the delegated review, generate `review-trace.json`, then record the result with `pre-pr-review`. (CHECK required)",
-  prePrReviewEvidenceMissing: "tasks.md `Pre-PR Evidence` is empty/invalid. Point to a real file and include a `Pre-PR Review Log` section with non-placeholder `Summary`, `Feature Intent Summary`, `Implementation Fit`, `Missing Cases`, `Spec Alignment Checked`, `Finding Count`, `Blocking Findings`, `Decision`, `Findings` (or explicit `0 findings`), and `Residual Risks`. (CHECK required)",
+  prePrReviewRun: "Prepare the pre-PR review handoff, then continue the real review before recording anything. Generate structured `review-trace.json` evidence with `baseSha`, `headSha`, `changedFiles`, `reviewedFiles`, `riskSummaries`, `Approval Rationale`, per-file findings, and `Residual Risks`, then record the outcome with `pre-pr-review`. `pre-pr-review-run` itself does not complete the review or advance state. (CHECK required)",
+  prePrReviewRunning: "A pre-PR review is already in progress. Reuse or resume the delegated review, generate structured `review-trace.json` evidence, then record the result with `pre-pr-review`. Do not re-approve the same label. (CHECK required)",
+  prePrReviewEvidenceMissing: "tasks.md `Pre-PR Evidence` is empty/invalid. Point it to a real JSON file that uses repo-relative paths and includes `baseSha`, `headSha`, `changedFiles`, `reviewedFiles`, `riskSummaries`, `Approval Rationale`, per-file findings, and `Residual Risks`. (CHECK required)",
   prePrReviewDecisionMissing: "tasks.md `Pre-PR Decision` is empty/placeholder or missing decision format. Record it as `decision: ...` (or `\uACB0\uC815: ...`). (CHECK required)",
   prePrReviewFixRequired: "Current `Pre-PR Decision` is `{decision}`. Apply the requested fixes from pre-PR findings before moving to PR creation. (CHECK required)",
   prePrReviewDecisionReconfirm: "Current `Pre-PR Decision` is `{decision}`. After fixing findings, rerun pre-PR review with an explicit decision to avoid replaying the prior state: `{command}` (CHECK required)",
@@ -1674,6 +1700,19 @@ function validateFeatureIdWithLang(id, lang) {
   }
   return { valid: true };
 }
+function validateIdeaIdWithLang(id, lang) {
+  if (!id || id.trim().length === 0) {
+    return { valid: false, error: tr(lang, "cli", "validation.ideaIdEmpty") };
+  }
+  const ideaIdPattern = /^I\d{3,}$/;
+  if (!ideaIdPattern.test(id)) {
+    return {
+      valid: false,
+      error: tr(lang, "cli", "validation.ideaIdFormat")
+    };
+  }
+  return { valid: true };
+}
 function validatePathWithLang(inputPath, lang) {
   if (!inputPath || inputPath.trim().length === 0) {
     return { valid: false, error: tr(lang, "cli", "validation.pathEmpty") };
@@ -1702,10 +1741,10 @@ var DEFAULT_STALE_MS = 2 * 6e4;
 var RUNTIME_GIT_DIRNAME = "lee-spec-kit.runtime";
 var RUNTIME_TEMP_DIRNAME = "lee-spec-kit-runtime";
 function toScopeKey(value) {
-  return createHash("sha1").update(path12.resolve(value)).digest("hex").slice(0, 16);
+  return createHash("sha1").update(path13.resolve(value)).digest("hex").slice(0, 16);
 }
 function getTempRuntimeDir(scopePath) {
-  return path12.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
+  return path13.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
 }
 function resolveGitRuntimeDir(cwd) {
   try {
@@ -1719,38 +1758,38 @@ function resolveGitRuntimeDir(cwd) {
       }
     ).trim();
     if (!out) return null;
-    return path12.isAbsolute(out) ? out : path12.resolve(cwd, out);
+    return path13.isAbsolute(out) ? out : path13.resolve(cwd, out);
   } catch {
     return null;
   }
 }
 function getRuntimeStateDir(cwd) {
-  const resolved = path12.resolve(cwd);
+  const resolved = path13.resolve(cwd);
   return resolveGitRuntimeDir(resolved) ?? getTempRuntimeDir(resolved);
 }
 function getDocsLockPath(docsDir) {
-  return path12.join(
+  return path13.join(
     getRuntimeStateDir(docsDir),
     "locks",
     `docs-${toScopeKey(docsDir)}.lock`
   );
 }
 function getInitLockPath(targetDir) {
-  return path12.join(
-    getRuntimeStateDir(path12.dirname(path12.resolve(targetDir))),
+  return path13.join(
+    getRuntimeStateDir(path13.dirname(path13.resolve(targetDir))),
     "locks",
     `init-${toScopeKey(targetDir)}.lock`
   );
 }
 function getApprovalTicketStorePath(docsDir) {
-  return path12.join(
+  return path13.join(
     getRuntimeStateDir(docsDir),
     "tickets",
     `approval-${toScopeKey(docsDir)}.json`
   );
 }
 function getProjectExecutionLockPath(cwd) {
-  return path12.join(getRuntimeStateDir(cwd), "locks", "project.lock");
+  return path13.join(getRuntimeStateDir(cwd), "locks", "project.lock");
 }
 async function isStaleLock(lockPath, staleMs) {
   try {
@@ -1791,7 +1830,7 @@ function isProcessAlive(pid) {
   }
 }
 async function tryAcquire(lockPath, owner) {
-  await fs.ensureDir(path12.dirname(lockPath));
+  await fs.ensureDir(path13.dirname(lockPath));
   try {
     const fd = await fs.open(lockPath, "wx");
     const payload = JSON.stringify(
@@ -1868,30 +1907,30 @@ var ENGINE_MANAGED_AGENT_FILES = [
   "pr-template.md"
 ];
 var ENGINE_MANAGED_AGENT_DIRS = ["skills"];
-var ENGINE_MANAGED_FEATURE_PATH = path12.join(
+var ENGINE_MANAGED_FEATURE_PATH = path13.join(
   "features",
   "feature-base"
 );
 async function pruneEngineManagedDocs(docsDir) {
   const removed = [];
   for (const file of ENGINE_MANAGED_AGENT_FILES) {
-    const target = path12.join(docsDir, "agents", file);
+    const target = path13.join(docsDir, "agents", file);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path12.relative(docsDir, target));
+      removed.push(path13.relative(docsDir, target));
     }
   }
   for (const dir of ENGINE_MANAGED_AGENT_DIRS) {
-    const target = path12.join(docsDir, "agents", dir);
+    const target = path13.join(docsDir, "agents", dir);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path12.relative(docsDir, target));
+      removed.push(path13.relative(docsDir, target));
     }
   }
-  const featureBasePath = path12.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
+  const featureBasePath = path13.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
   if (await fs.pathExists(featureBasePath)) {
     await fs.remove(featureBasePath);
-    removed.push(path12.relative(docsDir, featureBasePath));
+    removed.push(path13.relative(docsDir, featureBasePath));
   }
   return removed;
 }
@@ -1990,6 +2029,7 @@ In approval-waiting state:
 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. Treat \`currentActionShouldDelegate\` as a compatibility mirror for older consumers.
+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.
 
 In non-approval state (progress updates, analysis, tool execution logs, unrelated Q&A):
 
@@ -2004,23 +2044,35 @@ If approval is still pending after answering an unrelated question:
   - \`actionOptions[*].approvalPrompt\` (label meaning included), and
   - \`approvalRequest.finalPrompt\` (format line).
 - Never output \`finalPrompt\` alone without the matching \`A: ...\` prompt.`;
-function renderManagedBlock(lang, docsRepo) {
+function renderManagedSegment(lang, docsRepo) {
   return `${LEE_SPEC_KIT_AGENTS_BEGIN}
 ${CANONICAL_LEE_SPEC_KIT_AGENTS_TEXT}
-${LEE_SPEC_KIT_AGENTS_END}
+${LEE_SPEC_KIT_AGENTS_END}`;
+}
+function renderManagedBlock(lang, docsRepo) {
+  return `${renderManagedSegment()}
 
 `;
 }
 async function upsertLeeSpecKitAgentsMd(filePath, options) {
   const block = renderManagedBlock(options.lang, options.docsRepo);
+  const segment = renderManagedSegment(options.lang, options.docsRepo);
   const exists = await fs.pathExists(filePath);
   if (!exists) {
     await fs.writeFile(filePath, block, "utf-8");
     return { changed: true, action: "created" };
   }
   const current = await fs.readFile(filePath, "utf-8");
-  if (current.includes(LEE_SPEC_KIT_AGENTS_BEGIN)) {
-    return { changed: false, action: "noop" };
+  const beginIndex = current.indexOf(LEE_SPEC_KIT_AGENTS_BEGIN);
+  const endIndex = current.indexOf(LEE_SPEC_KIT_AGENTS_END);
+  if (beginIndex !== -1 && endIndex !== -1 && beginIndex <= endIndex) {
+    const replaceEnd = endIndex + LEE_SPEC_KIT_AGENTS_END.length;
+    const next2 = `${current.slice(0, beginIndex)}${segment}${current.slice(replaceEnd)}`;
+    if (next2 === current) {
+      return { changed: false, action: "noop" };
+    }
+    await fs.writeFile(filePath, next2, "utf-8");
+    return { changed: true, action: "updated" };
   }
   let next = current;
   if (next.length > 0 && !next.endsWith("\n")) next += "\n";
@@ -2158,7 +2210,7 @@ function initCommand(program2) {
     } catch (error) {
       if (error instanceof Error && error.message === "canceled") {
         const lang2 = options.lang ?? DEFAULT_LANG;
-        console.log(chalk8.yellow(`
+        console.log(chalk9.yellow(`
 ${tr(lang2, "cli", "common.canceled")}`));
         return;
       }
@@ -2166,8 +2218,8 @@ ${tr(lang2, "cli", "common.canceled")}`));
       const cliError = toCliError(error);
       const suggestions = getCliErrorSuggestions(cliError.code, lang);
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       printCliErrorSuggestions(suggestions, lang);
       process.exitCode = 1;
@@ -2177,7 +2229,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path12.basename(cwd);
+  const defaultName = path13.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let components = parseComponentsOption(options.components);
@@ -2188,7 +2240,7 @@ async function runInit(options) {
   let docsRemote = options.docsRemote;
   let projectRoot;
   const componentProjectRoots = options.componentProjectRoots ? parseComponentProjectRootsOption(options.componentProjectRoots) : {};
-  const targetDir = path12.resolve(cwd, options.dir || "./docs");
+  const targetDir = path13.resolve(cwd, options.dir || "./docs");
   const skipPrompts = !!options.yes || !!options.nonInteractive;
   if (options.docsRepo && !["embedded", "standalone"].includes(options.docsRepo)) {
     throw createCliError(
@@ -2228,18 +2280,18 @@ async function runInit(options) {
     }
     console.log();
     console.log(
-      chalk8.blue(`${tr(lang, "cli", "init.currentDirectoryLabel")}: ${cwd}`)
+      chalk9.blue(`${tr(lang, "cli", "init.currentDirectoryLabel")}: ${cwd}`)
     );
     if (isInsideGitRepo) {
-      console.log(chalk8.green(tr(lang, "cli", "init.gitDetected")));
+      console.log(chalk9.green(tr(lang, "cli", "init.gitDetected")));
       console.log();
-      console.log(chalk8.gray(tr(lang, "cli", "init.insideProjectRoot")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.modeEmbeddedDesc")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.modeStandaloneDesc")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.modeStandaloneMove")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.insideProjectRoot")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.modeEmbeddedDesc")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.modeStandaloneDesc")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.modeStandaloneMove")));
     } else {
-      console.log(chalk8.yellow(tr(lang, "cli", "init.gitNotDetected")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.gitNotDetectedDetail")));
+      console.log(chalk9.yellow(tr(lang, "cli", "init.gitNotDetected")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.gitNotDetectedDetail")));
     }
     console.log();
     const response = await prompts(
@@ -2561,31 +2613,31 @@ async function runInit(options) {
               initial: false
             });
             if (!overwrite) {
-              console.log(chalk8.yellow(tr(lang, "cli", "common.canceled")));
+              console.log(chalk9.yellow(tr(lang, "cli", "common.canceled")));
               return;
             }
           }
         }
       }
       console.log();
-      console.log(chalk8.blue(tr(lang, "cli", "init.log.creatingDocs")));
+      console.log(chalk9.blue(tr(lang, "cli", "init.log.creatingDocs")));
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `  ${tr(lang, "cli", "init.log.projectLabel")}: ${projectName}`
         )
       );
       console.log(
-        chalk8.gray(`  ${tr(lang, "cli", "init.log.typeLabel")}: ${projectType}`)
+        chalk9.gray(`  ${tr(lang, "cli", "init.log.typeLabel")}: ${projectType}`)
       );
       console.log(
-        chalk8.gray(`  ${tr(lang, "cli", "init.log.langLabel")}: ${lang}`)
+        chalk9.gray(`  ${tr(lang, "cli", "init.log.langLabel")}: ${lang}`)
       );
       console.log(
-        chalk8.gray(`  ${tr(lang, "cli", "init.log.pathLabel")}: ${targetDir}`)
+        chalk9.gray(`  ${tr(lang, "cli", "init.log.pathLabel")}: ${targetDir}`)
       );
       console.log();
       const templatesDir = getTemplatesDir();
-      const commonPath = path12.join(templatesDir, lang, "common");
+      const commonPath = path13.join(templatesDir, lang, "common");
       if (!await fs.pathExists(commonPath)) {
         throw new Error(
           tr(lang, "cli", "init.error.templateNotFound", { path: commonPath })
@@ -2594,11 +2646,11 @@ async function runInit(options) {
       const fsAdapter = new DefaultFileSystemAdapter();
       await copyTemplates(fsAdapter, commonPath, targetDir);
       if (projectType === "multi") {
-        const featuresRoot = path12.join(targetDir, "features");
+        const featuresRoot = path13.join(targetDir, "features");
         for (const component of components) {
-          const componentDir = path12.join(featuresRoot, component);
+          const componentDir = path13.join(featuresRoot, component);
           await fs.ensureDir(componentDir);
-          const readmePath = path12.join(componentDir, "README.md");
+          const readmePath = path13.join(componentDir, "README.md");
           if (!await fs.pathExists(readmePath)) {
             await fs.writeFile(
               readmePath,
@@ -2659,20 +2711,20 @@ async function runInit(options) {
           config.projectRoot = projectRoot;
         }
       }
-      const configPath = path12.join(targetDir, ".lee-spec-kit.json");
+      const configPath = path13.join(targetDir, ".lee-spec-kit.json");
       await fs.writeJson(configPath, config, { spaces: 2 });
       const extraCommitPathsAbs = [];
       try {
         if (docsRepo === "embedded") {
           const repoRoot = getGitTopLevelOrNull(cwd) || cwd;
-          const agentsMdPath = path12.join(repoRoot, "AGENTS.md");
+          const agentsMdPath = path13.join(repoRoot, "AGENTS.md");
           const result = await upsertLeeSpecKitAgentsMd(agentsMdPath, {
             lang,
             docsRepo
           });
           if (result.changed) extraCommitPathsAbs.push(agentsMdPath);
         } else {
-          await upsertLeeSpecKitAgentsMd(path12.join(targetDir, "AGENTS.md"), {
+          await upsertLeeSpecKitAgentsMd(path13.join(targetDir, "AGENTS.md"), {
             lang,
             docsRepo
           });
@@ -2682,16 +2734,16 @@ async function runInit(options) {
           } else if (projectRoot && typeof projectRoot === "object") {
             roots.push(...Object.values(projectRoot));
           }
-          const resolvedCwd = path12.resolve(cwd);
+          const resolvedCwd = path13.resolve(cwd);
           for (const raw of roots) {
             const value = String(raw || "").trim();
             if (!value) continue;
-            const abs = path12.resolve(cwd, value);
-            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path12.sep}`)) {
+            const abs = path13.resolve(cwd, value);
+            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path13.sep}`)) {
               if (await fs.pathExists(abs)) {
                 const stat = await fs.stat(abs);
                 if (stat.isDirectory()) {
-                  await upsertLeeSpecKitAgentsMd(path12.join(abs, "AGENTS.md"), {
+                  await upsertLeeSpecKitAgentsMd(path13.join(abs, "AGENTS.md"), {
                     lang,
                     docsRepo
                   });
@@ -2702,7 +2754,7 @@ async function runInit(options) {
         }
       } catch {
       }
-      console.log(chalk8.green(tr(lang, "cli", "init.log.docsCreated")));
+      console.log(chalk9.green(tr(lang, "cli", "init.log.docsCreated")));
       console.log();
       await initGit(
         cwd,
@@ -2713,14 +2765,14 @@ async function runInit(options) {
         docsRemote,
         extraCommitPathsAbs
       );
-      console.log(chalk8.blue(tr(lang, "cli", "init.log.nextStepsTitle")));
+      console.log(chalk9.blue(tr(lang, "cli", "init.log.nextStepsTitle")));
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           tr(lang, "cli", "init.log.nextSteps1", { docsDir: targetDir })
         )
       );
-      console.log(chalk8.gray(tr(lang, "cli", "init.log.nextSteps2")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.log.nextSteps3")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.log.nextSteps2")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.log.nextSteps3")));
       console.log();
     },
     { owner: "init" }
@@ -2775,31 +2827,31 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
     try {
       runGitOrThrow(["rev-parse", "--is-inside-work-tree"], gitWorkdir);
       console.log(
-        chalk8.blue(tr(lang, "cli", "init.log.gitRepoDetectedCommit"))
+        chalk9.blue(tr(lang, "cli", "init.log.gitRepoDetectedCommit"))
       );
     } catch {
-      console.log(chalk8.blue(tr(lang, "cli", "init.log.gitInit")));
+      console.log(chalk9.blue(tr(lang, "cli", "init.log.gitInit")));
       runGitOrThrow(["init"], gitWorkdir);
     }
-    const relativePath = docsRepo === "standalone" ? "." : path12.relative(gitWorkdir, targetDir);
+    const relativePath = docsRepo === "standalone" ? "." : path13.relative(gitWorkdir, targetDir);
     const stagedBeforeAdd = getCachedStagedFiles(gitWorkdir);
     if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
-      console.log(chalk8.yellow(tr(lang, "cli", "init.warn.stagedChangesSkip")));
-      console.log(chalk8.gray(tr(lang, "cli", "init.warn.commitManually")));
+      console.log(chalk9.yellow(tr(lang, "cli", "init.warn.stagedChangesSkip")));
+      console.log(chalk9.gray(tr(lang, "cli", "init.warn.commitManually")));
       console.log();
       return;
     }
     if (relativePath !== "." && isPathIgnored(gitWorkdir, relativePath)) {
       const repoRelativePath = toRepoRelativePath(gitWorkdir, relativePath);
       console.log(
-        chalk8.yellow(
+        chalk9.yellow(
           tr(lang, "cli", "init.warn.docsPathIgnoredSkipCommit", {
             path: repoRelativePath
           })
         )
       );
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           tr(lang, "cli", "init.warn.docsPathIgnoredHint", {
             path: repoRelativePath
           })
@@ -2808,7 +2860,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       console.log();
       return;
     }
-    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path12.relative(gitWorkdir, absPath)).map((p) => p.replace(/\\/g, "/").trim()).filter((p) => !!p && p !== "." && !p.startsWith("../"));
+    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path13.relative(gitWorkdir, absPath)).map((p) => p.replace(/\\/g, "/").trim()).filter((p) => !!p && p !== "." && !p.startsWith("../"));
     const pathsToStage = [relativePath, ...extraRelativePaths];
     for (const p of pathsToStage) {
       runGitOrThrow(["add", p], gitWorkdir);
@@ -2827,34 +2879,34 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       try {
         runGitOrThrow(["remote", "add", "origin", docsRemote], gitWorkdir);
         console.log(
-          chalk8.green(
+          chalk9.green(
             tr(lang, "cli", "init.log.gitRemoteSet", { remote: docsRemote })
           )
         );
       } catch {
-        console.log(chalk8.yellow(tr(lang, "cli", "init.warn.gitRemoteExists")));
+        console.log(chalk9.yellow(tr(lang, "cli", "init.warn.gitRemoteExists")));
       }
     }
-    console.log(chalk8.green(tr(lang, "cli", "init.log.gitInitialCommitDone")));
+    console.log(chalk9.green(tr(lang, "cli", "init.log.gitInitialCommitDone")));
     console.log();
   } catch {
-    console.log(chalk8.yellow(tr(lang, "cli", "init.warn.skipGitInit")));
+    console.log(chalk9.yellow(tr(lang, "cli", "init.warn.skipGitInit")));
     console.log();
   }
 }
 function getAncestorDirs(startDir) {
   const dirs = [];
-  let current = path12.resolve(startDir);
+  let current = path13.resolve(startDir);
   while (true) {
     dirs.push(current);
-    const parent = path12.dirname(current);
+    const parent = path13.dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return dirs;
 }
 function hasWorkspaceBoundary(dir) {
-  return fs.existsSync(path12.join(dir, "package.json")) || fs.existsSync(path12.join(dir, ".git"));
+  return fs.existsSync(path13.join(dir, "package.json")) || fs.existsSync(path13.join(dir, ".git"));
 }
 function getSearchBaseDirs(cwd) {
   const ancestors = getAncestorDirs(cwd);
@@ -2870,7 +2922,7 @@ function normalizeComponentKeys(value) {
   return Object.keys(value).map((key) => key.trim().toLowerCase()).filter(Boolean);
 }
 async function inferComponentsFromFeaturesDir(docsDir) {
-  const featuresPath = path12.join(docsDir, "features");
+  const featuresPath = path13.join(docsDir, "features");
   if (!await fs.pathExists(featuresPath)) return [];
   const entries = await fs.readdir(featuresPath, { withFileTypes: true });
   const inferred = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name.trim().toLowerCase()).filter(
@@ -2881,21 +2933,21 @@ async function inferComponentsFromFeaturesDir(docsDir) {
 async function getConfig(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
-    ...explicitDocsDir ? [path12.resolve(explicitDocsDir)] : [],
+    ...explicitDocsDir ? [path13.resolve(explicitDocsDir)] : [],
     ...getSearchBaseDirs(cwd)
   ];
   const visitedBaseDirs = /* @__PURE__ */ new Set();
   const visitedDocsDirs = /* @__PURE__ */ new Set();
   for (const baseDir of baseDirs) {
-    const resolvedBaseDir = path12.resolve(baseDir);
+    const resolvedBaseDir = path13.resolve(baseDir);
     if (visitedBaseDirs.has(resolvedBaseDir)) continue;
     visitedBaseDirs.add(resolvedBaseDir);
-    const possibleDocsDirs = [path12.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    const possibleDocsDirs = [path13.join(resolvedBaseDir, "docs"), resolvedBaseDir];
     for (const docsDir of possibleDocsDirs) {
-      const resolvedDocsDir = path12.resolve(docsDir);
+      const resolvedDocsDir = path13.resolve(docsDir);
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
-      const configPath = path12.join(resolvedDocsDir, ".lee-spec-kit.json");
+      const configPath = path13.join(resolvedDocsDir, ".lee-spec-kit.json");
       if (await fs.pathExists(configPath)) {
         try {
           const configFile = await fs.readJson(configPath);
@@ -2925,16 +2977,16 @@ async function getConfig(cwd) {
         } catch {
         }
       }
-      const agentsPath = path12.join(resolvedDocsDir, "agents");
-      const featuresPath = path12.join(resolvedDocsDir, "features");
+      const agentsPath = path13.join(resolvedDocsDir, "agents");
+      const featuresPath = path13.join(resolvedDocsDir, "features");
       if (await fs.pathExists(agentsPath) && await fs.pathExists(featuresPath)) {
         const inferredComponents = await inferComponentsFromFeaturesDir(resolvedDocsDir);
         const projectType = inferredComponents.length > 0 ? "multi" : "single";
         const components = projectType === "multi" ? resolveProjectComponents("multi", inferredComponents) : void 0;
         const langProbeCandidates = [
-          path12.join(agentsPath, "custom.md"),
-          path12.join(agentsPath, "constitution.md"),
-          path12.join(agentsPath, "agents.md")
+          path13.join(agentsPath, "custom.md"),
+          path13.join(agentsPath, "constitution.md"),
+          path13.join(agentsPath, "agents.md")
         ];
         let lang = "en";
         for (const candidate of langProbeCandidates) {
@@ -3005,18 +3057,18 @@ async function patchMarkdownIfExists(filePath, transform) {
   await fs.writeFile(filePath, transform(content), "utf-8");
 }
 async function applyLocalWorkflowTemplateToFeatureDir(featureDir, lang) {
-  await patchMarkdownIfExists(path12.join(featureDir, "spec.md"), sanitizeSpecForLocal);
+  await patchMarkdownIfExists(path13.join(featureDir, "spec.md"), sanitizeSpecForLocal);
   await patchMarkdownIfExists(
-    path12.join(featureDir, "tasks.md"),
+    path13.join(featureDir, "tasks.md"),
     (content) => sanitizeTasksForLocal(content, lang)
   );
-  await fs.remove(path12.join(featureDir, "issue.md"));
-  await fs.remove(path12.join(featureDir, "pr.md"));
+  await fs.remove(path13.join(featureDir, "issue.md"));
+  await fs.remove(path13.join(featureDir, "pr.md"));
 }
 
 // src/commands/feature.ts
 function featureCommand(program2) {
-  program2.command("feature <name>").description("Create a new feature folder").option("--component <component>", "Component name (multi only)").option("--id <id>", "Feature ID (default: auto)").option("-d, --desc <description>", "Feature description for spec.md").option("--non-interactive", "Fail instead of prompting for input").option("--json", "Output in JSON format for agents").action(async (name, options) => {
+  program2.command("feature <name>").description("Create a new feature folder").option("--component <component>", "Component name (multi only)").option("--id <id>", "Feature ID (default: auto)").option("-d, --desc <description>", "Feature description for spec.md").option("--idea <ref>", "Idea reference to promote (I001 | I001-slug | docs/ideas/...)").option("--non-interactive", "Fail instead of prompting for input").option("--json", "Output in JSON format for agents").action(async (name, options) => {
     try {
       const result = await runFeature(name, options);
       if (options.json) {
@@ -3049,7 +3101,7 @@ function featureCommand(program2) {
           );
           return;
         }
-        console.log(chalk8.yellow(`
+        console.log(chalk9.yellow(`
 ${tr(lang2, "cli", "common.canceled")}`));
         return;
       }
@@ -3070,8 +3122,8 @@ ${tr(lang2, "cli", "common.canceled")}`));
         return;
       }
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       printCliErrorSuggestions(suggestions, lang);
       process.exitCode = 1;
@@ -3097,6 +3149,7 @@ async function runFeature(name, options) {
     projectType,
     config.components
   );
+  const linkedIdea = options.idea ? await resolveIdeaReference(docsDir, options.idea, lang) : null;
   assertValid(
     validateSafeNameWithLang(name, lang),
     tr(lang, "cli", "validation.context.featureName"),
@@ -3162,19 +3215,19 @@ async function runFeature(name, options) {
       }
       let featuresDir;
       if (projectType === "multi") {
-        featuresDir = path12.join(docsDir, "features", component);
+        featuresDir = path13.join(docsDir, "features", component);
       } else {
-        featuresDir = path12.join(docsDir, "features");
+        featuresDir = path13.join(docsDir, "features");
       }
       const featureFolderName = `${featureId}-${name}`;
-      const featureDir = path12.join(featuresDir, featureFolderName);
+      const featureDir = path13.join(featuresDir, featureFolderName);
       if (await fs.pathExists(featureDir)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "feature.folderExists", { path: featureDir })
         );
       }
-      const featureBasePath = path12.join(
+      const featureBasePath = path13.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -3219,23 +3272,30 @@ async function runFeature(name, options) {
       }
       const fsAdapter = new DefaultFileSystemAdapter();
       await replaceInFiles(fsAdapter, featureDir, replacements);
+      if (linkedIdea) {
+        await stampIdeaReferenceInSpec(
+          path13.join(featureDir, "spec.md"),
+          path13.relative(featureDir, linkedIdea.path)
+        );
+        await markIdeaAsFeatureized(linkedIdea.path, featureFolderName);
+      }
       if (config.workflow?.mode === "local") {
         await applyLocalWorkflowTemplateToFeatureDir(featureDir, lang);
       }
       if (!options.json) {
         console.log();
         console.log(
-          chalk8.green(tr(lang, "cli", "feature.created", { path: featureDir }))
+          chalk9.green(tr(lang, "cli", "feature.created", { path: featureDir }))
         );
         console.log();
-        console.log(chalk8.blue(tr(lang, "cli", "feature.nextStepsTitle")));
+        console.log(chalk9.blue(tr(lang, "cli", "feature.nextStepsTitle")));
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             tr(lang, "cli", "feature.nextSteps1", { path: featureDir })
           )
         );
-        console.log(chalk8.gray(tr(lang, "cli", "feature.nextSteps2")));
-        console.log(chalk8.gray(tr(lang, "cli", "feature.nextSteps3")));
+        console.log(chalk9.gray(tr(lang, "cli", "feature.nextSteps2")));
+        console.log(chalk9.gray(tr(lang, "cli", "feature.nextSteps3")));
         console.log();
       }
       return {
@@ -3243,18 +3303,115 @@ async function runFeature(name, options) {
         featureName: name,
         component: projectType === "multi" ? component : void 0,
         featurePath: featureDir,
-        featurePathFromDocs: path12.relative(docsDir, featureDir)
+        featurePathFromDocs: path13.relative(docsDir, featureDir)
       };
     },
     { owner: "feature" }
   );
 }
+async function resolveIdeaReference(docsDir, ref, lang) {
+  const ideasDir = path13.join(docsDir, "ideas");
+  const trimmedRef = ref.trim();
+  if (!trimmedRef) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      tr(lang, "cli", "feature.ideaNotFound", { ref })
+    );
+  }
+  if (trimmedRef.includes("/") || trimmedRef.endsWith(".md")) {
+    const candidate = path13.resolve(process.cwd(), trimmedRef);
+    if (await fs.pathExists(candidate)) {
+      return { path: candidate };
+    }
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      tr(lang, "cli", "feature.ideaNotFound", { ref: trimmedRef })
+    );
+  }
+  if (!await fs.pathExists(ideasDir)) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      tr(lang, "cli", "feature.ideaNotFound", { ref: trimmedRef })
+    );
+  }
+  const entries = await fs.readdir(ideasDir, { withFileTypes: true });
+  const files = entries.filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".md")).map((entry) => entry.name);
+  const exactName = `${trimmedRef}.md`;
+  if (files.includes(exactName)) {
+    return { path: path13.join(ideasDir, exactName) };
+  }
+  const byId = /^I\d{3,}$/.test(trimmedRef) ? files.filter((name) => name.startsWith(`${trimmedRef}-`)) : [];
+  if (byId.length === 1) {
+    return { path: path13.join(ideasDir, byId[0]) };
+  }
+  if (byId.length > 1) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      tr(lang, "cli", "feature.ideaAmbiguous", { ref: trimmedRef })
+    );
+  }
+  throw createCliError(
+    "INVALID_ARGUMENT",
+    tr(lang, "cli", "feature.ideaNotFound", { ref: trimmedRef })
+  );
+}
+async function stampIdeaReferenceInSpec(specPath, relativeIdeaPath) {
+  const normalizedPath = relativeIdeaPath.replace(/\\/g, "/");
+  const ideaLine = `- Idea: \`${normalizedPath}\``;
+  let content = await fs.readFile(specPath, "utf-8");
+  if (content.includes(ideaLine)) {
+    return;
+  }
+  if (content.includes("## Related Documents")) {
+    content = content.replace(
+      "## Related Documents\n\n",
+      `## Related Documents
+
+${ideaLine}
+`
+    );
+  } else {
+    content = `${content.trimEnd()}
+
+${ideaLine}
+`;
+  }
+  await fs.writeFile(specPath, content, "utf-8");
+}
+async function markIdeaAsFeatureized(ideaPath, featureFolderName) {
+  let content = await fs.readFile(ideaPath, "utf-8");
+  content = replaceOrAppendIdeaMetadata(content, "Status", "Featureized");
+  content = replaceOrAppendIdeaMetadata(content, "Feature", featureFolderName);
+  await fs.writeFile(ideaPath, content, "utf-8");
+}
+function replaceOrAppendIdeaMetadata(content, label, value) {
+  const pattern = new RegExp(`^- \\*\\*${escapeRegExp(label)}\\*\\*:.*$`, "m");
+  const line = `- **${label}**: ${value}`;
+  if (pattern.test(content)) {
+    return content.replace(pattern, line);
+  }
+  const heading = "## Promotion Tracking";
+  if (content.includes(heading)) {
+    return content.replace(heading, `${heading}
+
+${line}`);
+  }
+  return `${content.trimEnd()}
+
+${heading}
+
+${line}
+`;
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const candidates = [
-    ...explicitDocsDir ? [path12.resolve(explicitDocsDir)] : [],
-    path12.resolve(cwd, "docs"),
-    path12.resolve(cwd)
+    ...explicitDocsDir ? [path13.resolve(explicitDocsDir)] : [],
+    path13.resolve(cwd, "docs"),
+    path13.resolve(cwd)
   ];
   const endAt = Date.now() + timeoutMs;
   while (Date.now() < endAt) {
@@ -3281,12 +3438,12 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   return getConfig(cwd);
 }
 async function getNextFeatureId(docsDir, projectType, components) {
-  const featuresDir = path12.join(docsDir, "features");
+  const featuresDir = path13.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "multi") {
     scanDirs.push(
-      ...components.map((component) => path12.join(featuresDir, component))
+      ...components.map((component) => path13.join(featuresDir, component))
     );
   } else {
     scanDirs.push(featuresDir);
@@ -3307,6 +3464,167 @@ async function getNextFeatureId(docsDir, projectType, components) {
   const width = Math.max(3, String(next).length);
   return `F${String(next).padStart(width, "0")}`;
 }
+function ideaCommand(program2) {
+  program2.command("idea <name>").description("Create a new indexed idea document").option("--component <component>", "Component name (optional)").option("--id <id>", "Idea ID (default: auto)").option("-d, --desc <description>", "Idea description for the document").option("--non-interactive", "Reserved for parity with other generators").option("--json", "Output in JSON format for agents").action(async (name, options) => {
+    try {
+      const result = await runIdea(name, options);
+      if (options.json) {
+        console.log(
+          JSON.stringify(
+            {
+              status: "ok",
+              reasonCode: "IDEA_CREATED",
+              ideaId: result.ideaId,
+              ideaName: result.ideaName,
+              component: result.component,
+              ideaPath: result.ideaPath,
+              ideaPathFromDocs: result.ideaPathFromDocs
+            },
+            null,
+            2
+          )
+        );
+      }
+    } 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
+          })
+        );
+        process.exitCode = 1;
+        return;
+      }
+      console.error(
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
+      );
+      printCliErrorSuggestions(suggestions, lang);
+      process.exitCode = 1;
+    }
+  });
+}
+async function runIdea(name, options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    throw createCliError(
+      "DOCS_NOT_FOUND",
+      tr(DEFAULT_LANG, "cli", "common.docsNotFound")
+    );
+  }
+  const { docsDir, projectType, lang } = config;
+  const configuredComponents = resolveProjectComponents(
+    projectType,
+    config.components
+  );
+  assertValid(
+    validateSafeNameWithLang(name, lang),
+    tr(lang, "cli", "validation.context.ideaName"),
+    lang
+  );
+  let component = (options.component || "").trim().toLowerCase();
+  if (component && projectType === "single") {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--component` can only be used in multi mode."
+    );
+  }
+  if (projectType === "multi" && component) {
+    assertAllowedComponent(component, configuredComponents);
+  }
+  return withFileLock(
+    getDocsLockPath(docsDir),
+    async () => {
+      const ideaId = options.id ? validateProvidedIdeaId(options.id, lang) : await getNextIdeaId(docsDir);
+      const ideasDir = path13.join(docsDir, "ideas");
+      const ideaFileName = `${ideaId}-${name}.md`;
+      const ideaPath = path13.join(ideasDir, ideaFileName);
+      if (await fs.pathExists(ideaPath)) {
+        throw createCliError(
+          "INVALID_ARGUMENT",
+          tr(lang, "cli", "idea.fileExists", { path: ideaPath })
+        );
+      }
+      const templatePath = path13.join(
+        getTemplatesDir(),
+        lang,
+        "common",
+        "ideas",
+        "idea.md"
+      );
+      if (!await fs.pathExists(templatePath)) {
+        throw createCliError(
+          "DOCS_NOT_FOUND",
+          tr(lang, "cli", "idea.templateNotFound")
+        );
+      }
+      await fs.mkdir(ideasDir, { recursive: true });
+      const template = await fs.readFile(templatePath, "utf-8");
+      const content = applyIdeaTemplate(template, {
+        ideaId,
+        name,
+        description: options.desc || "",
+        component: component || "-",
+        created: getLocalDateString()
+      });
+      await fs.writeFile(ideaPath, content, "utf-8");
+      if (!options.json) {
+        console.log();
+        console.log(chalk9.green(tr(lang, "cli", "idea.created", { path: ideaPath })));
+        console.log();
+        console.log(chalk9.blue(tr(lang, "cli", "idea.nextStepsTitle")));
+        console.log(chalk9.gray(tr(lang, "cli", "idea.nextSteps1")));
+        console.log(chalk9.gray(tr(lang, "cli", "idea.nextSteps2", { ideaId })));
+        console.log(chalk9.gray(tr(lang, "cli", "idea.nextSteps3")));
+        console.log();
+      }
+      return {
+        ideaId,
+        ideaName: name,
+        component: component || void 0,
+        ideaPath,
+        ideaPathFromDocs: path13.relative(docsDir, ideaPath)
+      };
+    },
+    { owner: "idea" }
+  );
+}
+function validateProvidedIdeaId(id, lang) {
+  assertValid(
+    validateIdeaIdWithLang(id, lang),
+    tr(lang, "cli", "validation.context.ideaId"),
+    lang
+  );
+  return id;
+}
+function applyIdeaTemplate(template, values) {
+  return template.replaceAll("{idea-id}", values.ideaId).replaceAll("{idea-name}", values.name).replaceAll("{YYYY-MM-DD}", values.created).replaceAll("{{description}}", values.description).replaceAll("{component}", values.component);
+}
+async function getNextIdeaId(docsDir) {
+  const ideasDir = path13.join(docsDir, "ideas");
+  let max = 0;
+  if (await fs.pathExists(ideasDir)) {
+    const entries = await fs.readdir(ideasDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isFile()) continue;
+      const match = entry.name.match(/^I(\d+)-/);
+      if (!match) continue;
+      const num = parseInt(match[1], 10);
+      if (num > max) max = num;
+    }
+  }
+  const next = max + 1;
+  const width = Math.max(3, String(next).length);
+  return `I${String(next).padStart(width, "0")}`;
+}
 var DefaultCommandAdapter = class {
   execSync(command, options) {
     return execSync(command, options);
@@ -3566,15 +3884,15 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 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'
    - worktree \uAE30\uC900: 'git diff --name-only', 'git diff --name-only --cached', 'git ls-files --others --exclude-standard'
-3. \uAD6C\uD604\uC774 feature \uC758\uB3C4\uC5D0 \uB9DE\uB294\uC9C0 \uD3C9\uAC00\uD558\uC138\uC694. \uD2B9\uD788 \`featureIntentSummary\`, \`implementationFit\`, \`missingCases\`, \`residualRisks\`\uB97C \uAD6C\uCCB4\uC801\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694.
-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.
+    3. \uAD6C\uD604\uC774 feature \uC758\uB3C4\uC5D0 \uB9DE\uB294\uC9C0 \uD3C9\uAC00\uD558\uC138\uC694. \uD2B9\uD788 \`featureIntentSummary\`, \`implementationFit\`, \`missingCases\`, \`residualRisks\`, \`approvalRationale\`\uB97C \uAD6C\uCCB4\uC801\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694.
+    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. \uC99D\uAC70\uC5D0\uB294 \uBC18\uB4DC\uC2DC \`baseSha\`, \`headSha\`, \`changedFiles\`, \`reviewedFiles\`, \`riskSummaries\`(blocking/important/minor)\uAC00 \uD3EC\uD568\uB418\uC5B4\uC57C \uD569\uB2C8\uB2E4.
 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\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.`;
+    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\uB294 \uBC18\uB4DC\uC2DC \uAD6C\uC870\uD654\uB41C evidence\uC640 \uD568\uAED8 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694. approve\uB294 evidence \uC5C6\uC774 \uAE30\uB85D\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`;
   }
   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.
@@ -3582,15 +3900,15 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 2. Split and check the review scope.
    - Main scope: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
    - Worktree scope: 'git diff --name-only', 'git diff --name-only --cached', 'git ls-files --others --exclude-standard'
-3. Evaluate whether the implementation actually fits the feature intent. Capture concrete \`featureIntentSummary\`, \`implementationFit\`, \`missingCases\`, and \`residualRisks\`, and explicitly set \`specAlignmentChecked\`.
-4. Generate a 'review-trace.json' file for all changed files, including \`findingCount\`, \`blockingFindings\`, evaluations for risk, security, perf, maintainability, and specific fileLine locators.
+    3. Evaluate whether the implementation actually fits the feature intent. Capture concrete \`featureIntentSummary\`, \`implementationFit\`, \`missingCases\`, \`residualRisks\`, and \`approvalRationale\`, and explicitly set \`specAlignmentChecked\`.
+    4. Generate a 'review-trace.json' file for all changed files, including \`baseSha\`, \`headSha\`, \`changedFiles\`, \`reviewedFiles\`, \`riskSummaries\` (blocking/important/minor), \`findingCount\`, \`blockingFindings\`, per-file risk/security/perf/maintainability evaluations, 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 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.`;
+    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> --evidence review-trace.json --decision approve' for final pre-PR approval. Approve never records without structured evidence.`;
 }
 function getCodeReviewPrompt(lang) {
   if (lang === "ko") {
@@ -3730,7 +4048,7 @@ function isNonNegativeIntegerValue(value) {
 }
 function isLikelyCurrentPrePrReviewEvidence(evidencePath, feature) {
   try {
-    const raw = fs9.readFileSync(evidencePath, "utf-8");
+    const raw = fs10.readFileSync(evidencePath, "utf-8");
     const parsed = JSON.parse(raw);
     const evidenceFeature = (parsed.feature || "").toString().trim();
     if (evidenceFeature && evidenceFeature !== feature.folderName) {
@@ -3746,31 +4064,31 @@ function resolvePrePrReviewEvidencePath(feature) {
   const candidates = [];
   const explicit = (feature.prePrReview.evidence || "").trim();
   if (explicit && explicit !== "-") {
-    if (path12.isAbsolute(explicit)) {
+    if (path13.isAbsolute(explicit)) {
       candidates.push(explicit);
     } else {
-      candidates.push(path12.resolve(feature.path, explicit));
-      candidates.push(path12.resolve(docsRoot, explicit));
+      candidates.push(path13.resolve(feature.path, explicit));
+      candidates.push(path13.resolve(docsRoot, explicit));
       const normalizedExplicit = explicit.replace(/\\/g, "/");
       if (normalizedExplicit.startsWith("docs/")) {
         const withoutDocsPrefix = normalizedExplicit.slice("docs/".length);
         if (withoutDocsPrefix) {
-          candidates.push(path12.resolve(docsRoot, withoutDocsPrefix));
+          candidates.push(path13.resolve(docsRoot, withoutDocsPrefix));
         }
       }
     }
   }
-  candidates.push(path12.join(feature.path, "review-trace.json"));
-  candidates.push(path12.join(docsRoot, "review-trace.json"));
+  candidates.push(path13.join(feature.path, "review-trace.json"));
+  candidates.push(path13.join(docsRoot, "review-trace.json"));
   const seen = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
-    const abs = path12.resolve(candidate);
+    const abs = path13.resolve(candidate);
     if (seen.has(abs)) continue;
     seen.add(abs);
-    if (!fs9.existsSync(abs)) continue;
+    if (!fs10.existsSync(abs)) continue;
     if (!abs.toLowerCase().endsWith(".json")) continue;
     if (!isLikelyCurrentPrePrReviewEvidence(abs, feature)) continue;
-    const rel = path12.relative(docsRoot, abs).replace(/\\/g, "/");
+    const rel = path13.relative(docsRoot, abs).replace(/\\/g, "/");
     if (rel && !rel.startsWith("../")) {
       return rel;
     }
@@ -3811,8 +4129,8 @@ function getReviewFixCommitGuidance(feature, lang, options) {
 }
 function resolveManagedWorktreeCleanupPaths(projectGitCwd) {
   if (!projectGitCwd) return null;
-  const normalized = path12.resolve(projectGitCwd);
-  const marker = `${path12.sep}.worktrees${path12.sep}`;
+  const normalized = path13.resolve(projectGitCwd);
+  const marker = `${path13.sep}.worktrees${path13.sep}`;
   const markerIndex = normalized.lastIndexOf(marker);
   if (markerIndex <= 0) return null;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -3855,7 +4173,7 @@ function toTaskKey(rawTitle) {
 function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   const docsGitCwd = feature.git.docsGitCwd;
   const tasksRelativePath = normalizeGitRelativePath(
-    path12.join(feature.docs.featurePathFromDocs, "tasks.md")
+    path13.join(feature.docs.featurePathFromDocs, "tasks.md")
   );
   const diff = readGitText(ctx, docsGitCwd, [
     "diff",
@@ -3930,7 +4248,7 @@ function checkTaskCommitGate(ctx, feature) {
     return { pass: true };
   }
   const args = ["log", "-n", "1", "--pretty=%s", "--", "."];
-  const relativeDocsDir = path12.relative(projectGitCwd, feature.git.docsGitCwd);
+  const relativeDocsDir = path13.relative(projectGitCwd, feature.git.docsGitCwd);
   const normalizedDocsDir = normalizeGitRelativePath(relativeDocsDir);
   if (normalizedDocsDir && normalizedDocsDir !== "." && normalizedDocsDir !== ".." && !normalizedDocsDir.startsWith("../")) {
     args.push(`:(exclude)${normalizedDocsDir}/**`);
@@ -4312,9 +4630,9 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
   const isPrePrReviewCurrent = (f) => prePrReviewPolicy.enabled && workflowPolicy.requirePr && f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && isCompletionChecklistDone(f) && !f.git.docsHasCommitRequiredChanges && !f.git.projectHasUncommittedChanges && (!isPrMetadataConfigured(f) || !f.pr.link) && !isPrePrReviewSatisfied(f, prePrReviewPolicy);
   const isPrePrReviewMetadataMissing = (f) => isPrePrReviewCurrent(f) && !f.docs.prePrReviewFieldExists;
   const isPrePrReviewFixRequired = (f) => isPrePrReviewCurrent(f) && !!f.prePrReview.decisionOutcome && f.prePrReview.decisionOutcome !== "approve";
-  const isPrePrReviewRun = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status !== "Running" && !resolvePrePrReviewEvidencePath(f) && (prePrReviewPolicy.evidenceMode === "path_required" || prePrReviewPolicy.enforceExecutionEvidence);
-  const isPrePrReviewRunning = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status === "Running" && !resolvePrePrReviewEvidencePath(f) && (prePrReviewPolicy.evidenceMode === "path_required" || prePrReviewPolicy.enforceExecutionEvidence);
-  const isPrePrReviewRecord = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && (!!resolvePrePrReviewEvidencePath(f) || prePrReviewPolicy.evidenceMode === "any" && !prePrReviewPolicy.enforceExecutionEvidence);
+  const isPrePrReviewRun = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status !== "Running" && !resolvePrePrReviewEvidencePath(f);
+  const isPrePrReviewRunning = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status === "Running" && !resolvePrePrReviewEvidencePath(f);
+  const isPrePrReviewRecord = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && !!resolvePrePrReviewEvidencePath(f);
   const getPrePrReviewMetadataActions = () => [
     {
       type: "instruction",
@@ -4358,7 +4676,7 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
       cmd: buildSelfCliCommand(buildPrePrReviewRunCommandArgs(f))
     }
   ];
-  const getPrePrReviewRunningActions = () => [
+  const getPrePrReviewInProgressActions = () => [
     {
       type: "instruction",
       category: "pre_pr_review_run",
@@ -4896,15 +5214,15 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
           actions: (f) => getPrePrReviewRunActions(f)
         },
         {
-          id: "pre_pr_review_running",
+          id: "pre_pr_review_in_progress",
           phase: "running",
           owner: "subagent",
           category: "pre_pr_review_run",
           when: (f) => isPrePrReviewRunning(f),
-          actions: () => getPrePrReviewRunningActions()
+          actions: () => getPrePrReviewInProgressActions()
         },
         {
-          id: "pre_pr_review_record",
+          id: "pre_pr_review_record_pending",
           phase: "record",
           owner: "main",
           category: "pre_pr_review_record",
@@ -5546,17 +5864,17 @@ function isGitPathIgnored(ctx, cwd, relativePath) {
   }
 }
 var GIT_WORKTREE_CACHE = /* @__PURE__ */ new Map();
-var WORKTREE_MARKER = `${path12.sep}.worktrees${path12.sep}`;
+var WORKTREE_MARKER = `${path13.sep}.worktrees${path13.sep}`;
 function resetContextGitCaches() {
   GIT_WORKTREE_CACHE.clear();
 }
 function isManagedWorktreePath(cwd) {
   if (!cwd) return false;
-  const normalized = path12.resolve(cwd);
+  const normalized = path13.resolve(cwd);
   return normalized.includes(WORKTREE_MARKER);
 }
 function resolveProjectRootFromGitCwd(cwd) {
-  const normalized = path12.resolve(cwd);
+  const normalized = path13.resolve(cwd);
   const markerIndex = normalized.lastIndexOf(WORKTREE_MARKER);
   if (markerIndex <= 0) return normalized;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -5575,7 +5893,7 @@ function getGitTopLevel(ctx, cwd) {
 }
 function listGitWorktrees(ctx, cwd) {
   const topLevel = getGitTopLevel(ctx, cwd) || cwd;
-  const cacheKey = path12.resolve(topLevel);
+  const cacheKey = path13.resolve(topLevel);
   const cached = GIT_WORKTREE_CACHE.get(cacheKey);
   if (cached) return cached;
   try {
@@ -5676,12 +5994,12 @@ function countDocumentLines(content) {
   if (lines[lines.length - 1] === "") return lines.length - 1;
   return lines.length;
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractSpecValue(content, key) {
   const regex = new RegExp(
-    `^\\s*-\\s*\\*\\*${escapeRegExp(key)}\\*\\*\\s*:\\s*(.*)$`,
+    `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:\\s*(.*)$`,
     "m"
   );
   const match = content.match(regex);
@@ -5689,7 +6007,7 @@ function extractSpecValue(content, key) {
 }
 function hasSpecKey(content, key) {
   const regex = new RegExp(
-    `^\\s*-\\s*\\*\\*${escapeRegExp(key)}\\*\\*\\s*:`,
+    `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:`,
     "m"
   );
   return regex.test(content);
@@ -5881,7 +6199,7 @@ function splitReviewLogSections(content, headerRegex) {
 }
 function collectStructuredReviewEntries(section, keys) {
   const lines = section.split("\n");
-  const escaped = keys.map((key) => escapeRegExp(key));
+  const escaped = keys.map((key) => escapeRegExp2(key));
   const fieldRegex = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*(.*)$`,
     "i"
@@ -6063,17 +6381,17 @@ function resolveLocalEvidencePathCandidates(rawValue, context) {
   if (!evidencePath) return [];
   if (/^https?:\/\//i.test(evidencePath)) return [];
   const candidates = /* @__PURE__ */ new Set();
-  if (path12.isAbsolute(evidencePath)) {
-    candidates.add(path12.resolve(evidencePath));
+  if (path13.isAbsolute(evidencePath)) {
+    candidates.add(path13.resolve(evidencePath));
   } else {
-    candidates.add(path12.resolve(context.featurePath, evidencePath));
-    candidates.add(path12.resolve(context.docsDir, evidencePath));
-    candidates.add(path12.resolve(path12.dirname(context.docsDir), evidencePath));
+    candidates.add(path13.resolve(context.featurePath, evidencePath));
+    candidates.add(path13.resolve(context.docsDir, evidencePath));
+    candidates.add(path13.resolve(path13.dirname(context.docsDir), evidencePath));
     const normalizedEvidencePath = evidencePath.replace(/\\/g, "/");
     if (normalizedEvidencePath.startsWith("docs/")) {
       const withoutDocsPrefix = normalizedEvidencePath.slice("docs/".length);
       if (withoutDocsPrefix) {
-        candidates.add(path12.resolve(context.docsDir, withoutDocsPrefix));
+        candidates.add(path13.resolve(context.docsDir, withoutDocsPrefix));
       }
     }
   }
@@ -6135,13 +6453,13 @@ function parsePrLink(value) {
   return trimmed;
 }
 function normalizeGitPath(value) {
-  return value.split(path12.sep).join("/");
+  return value.split(path13.sep).join("/");
 }
 function resolveProjectStatusPaths(projectGitCwd, docsDir) {
-  const relativeDocsDir = path12.relative(projectGitCwd, docsDir);
+  const relativeDocsDir = path13.relative(projectGitCwd, docsDir);
   if (!relativeDocsDir) return [];
-  if (path12.isAbsolute(relativeDocsDir)) return [];
-  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path12.sep}`)) {
+  if (path13.isAbsolute(relativeDocsDir)) return [];
+  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path13.sep}`)) {
     return [];
   }
   const normalizedDocsDir = normalizeGitPath(relativeDocsDir).replace(
@@ -6179,7 +6497,7 @@ function getExpectedWorktreeCandidates(projectGitCwd, issueNumber, slug, folderN
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   for (const name of names) {
-    const candidate = path12.resolve(projectRoot, ".worktrees", name);
+    const candidate = path13.resolve(projectRoot, ".worktrees", name);
     if (seen.has(candidate)) continue;
     seen.add(candidate);
     out.push(candidate);
@@ -6193,7 +6511,7 @@ function resolveExistingExpectedWorktreePath(projectGitCwd, issueNumber, slug, f
     slug,
     folderName
   )) {
-    if (!fs9.existsSync(candidate)) continue;
+    if (!fs10.existsSync(candidate)) continue;
     return candidate;
   }
   return void 0;
@@ -6223,7 +6541,7 @@ function resolveFeatureWorktreePath(ctx, projectGitCwd, issueNumber, slug, folde
     slug,
     folderName
   )) {
-    if (!fs9.existsSync(candidate)) continue;
+    if (!fs10.existsSync(candidate)) continue;
     const branchName = getCurrentBranch(ctx, candidate);
     if (!expectedBranchesSet.has(branchName)) continue;
     return {
@@ -6364,10 +6682,10 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   const normalizedCandidates = uniqueNormalizedPaths(
     candidates.map((candidate) => {
       if (!candidate) return "";
-      if (!path12.isAbsolute(candidate)) return candidate;
-      const relative = path12.relative(projectGitCwd, candidate);
+      if (!path13.isAbsolute(candidate)) return candidate;
+      const relative = path13.relative(projectGitCwd, candidate);
       if (!relative) return "";
-      if (relative === ".." || relative.startsWith(`..${path12.sep}`))
+      if (relative === ".." || relative.startsWith(`..${path13.sep}`))
         return "";
       return relative;
     }).filter(Boolean)
@@ -6381,7 +6699,7 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   if (cached) return [...cached];
   const existing = [];
   for (const candidate of normalizedCandidates) {
-    if (await ctx.fs.pathExists(path12.join(projectGitCwd, candidate))) {
+    if (await ctx.fs.pathExists(path13.join(projectGitCwd, candidate))) {
       existing.push(candidate);
     }
   }
@@ -6469,16 +6787,16 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   const lang = options.lang;
   const workflowPolicy = resolveWorkflowPolicy(options.workflow);
   const prePrReviewPolicy = resolvePrePrReviewPolicy(options.workflow);
-  const folderName = path12.basename(featurePath);
+  const folderName = path13.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
   const slug = match?.[2] || folderName;
-  const specPath = path12.join(featurePath, "spec.md");
-  const planPath = path12.join(featurePath, "plan.md");
-  const tasksPath = path12.join(featurePath, "tasks.md");
-  const decisionsPath = path12.join(featurePath, "decisions.md");
-  const issueDocPath = path12.join(featurePath, "issue.md");
-  const prDocPath = path12.join(featurePath, "pr.md");
+  const specPath = path13.join(featurePath, "spec.md");
+  const planPath = path13.join(featurePath, "plan.md");
+  const tasksPath = path13.join(featurePath, "tasks.md");
+  const decisionsPath = path13.join(featurePath, "decisions.md");
+  const issueDocPath = path13.join(featurePath, "issue.md");
+  const prDocPath = path13.join(featurePath, "pr.md");
   let specStatus;
   let issueNumber;
   const specExists = await ctx.fs.pathExists(specPath);
@@ -6740,7 +7058,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   } else if (workflowPolicy.requireWorktree && tasksSummary.total > tasksSummary.done && !projectInManagedWorktree) {
     warnings.push(tr(lang, "warnings", "workflowWorktreeRequired"));
   }
-  const relativeFeaturePathFromDocs = path12.relative(
+  const relativeFeaturePathFromDocs = path13.relative(
     context.docsDir,
     featurePath
   );
@@ -7103,7 +7421,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
 async function listFeatureDirs(ctx, rootDir) {
   const dirs = await listSubdirectories(ctx.fs, rootDir);
   return dirs.filter(
-    (value) => path12.basename(value).trim().toLowerCase() !== "feature-base"
+    (value) => path13.basename(value).trim().toLowerCase() !== "feature-base"
   );
 }
 function normalizeRelPath(value) {
@@ -7244,7 +7562,7 @@ async function scanFeatures(ctx) {
   if (config.projectType === "single") {
     const featureDirs = await listFeatureDirs(
       ctx,
-      path12.join(config.docsDir, "features")
+      path13.join(config.docsDir, "features")
     );
     componentFeatureDirs.set("single", featureDirs);
     allFeatureDirs.push(...featureDirs);
@@ -7256,14 +7574,14 @@ async function scanFeatures(ctx) {
     for (const component of components) {
       const componentDirs = await listFeatureDirs(
         ctx,
-        path12.join(config.docsDir, "features", component)
+        path13.join(config.docsDir, "features", component)
       );
       componentFeatureDirs.set(component, componentDirs);
       allFeatureDirs.push(...componentDirs);
     }
   }
   const relativeFeaturePaths = allFeatureDirs.map(
-    (dir) => normalizeRelPath(path12.relative(config.docsDir, dir))
+    (dir) => normalizeRelPath(path13.relative(config.docsDir, dir))
   );
   const docsGitMeta = buildDocsFeatureGitMeta(
     ctx,
@@ -7280,7 +7598,7 @@ async function scanFeatures(ctx) {
     const parsed = await Promise.all(
       target.dirs.map(async (dir) => {
         const relativeFeaturePathFromDocs = normalizeRelPath(
-          path12.relative(config.docsDir, dir)
+          path13.relative(config.docsDir, dir)
         );
         const docsMeta = docsGitMeta.get(relativeFeaturePathFromDocs);
         return parseFeature(
@@ -7332,8 +7650,8 @@ function statusCommand(program2) {
       const cliError = toCliError(error);
       const suggestions = getCliErrorSuggestions(cliError.code, lang);
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       printCliErrorSuggestions(suggestions, lang);
       process.exitCode = 1;
@@ -7350,13 +7668,13 @@ async function runStatus(options) {
     );
   }
   const { docsDir, projectType, projectName, lang } = ctx.config;
-  const featuresDir = path12.join(docsDir, "features");
+  const featuresDir = path13.join(docsDir, "features");
   const scan = await scanFeatures(ctx);
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   for (const f of scan.features) {
     const id = f.id || "UNKNOWN";
-    const relPath = path12.relative(docsDir, f.path);
+    const relPath = path13.relative(docsDir, f.path);
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(relPath);
     if (!f.docs.specExists || !f.docs.tasksExists) continue;
@@ -7430,7 +7748,7 @@ async function runStatus(options) {
     return;
   }
   if (features.length === 0) {
-    console.log(chalk8.yellow(tr(lang, "cli", "status.noFeatures")));
+    console.log(chalk9.yellow(tr(lang, "cli", "status.noFeatures")));
     return;
   }
   features.sort((a, b) => a.id.localeCompare(b.id));
@@ -7440,14 +7758,14 @@ async function runStatus(options) {
   console.log(header);
   console.log(separator);
   for (const f of features) {
-    const statusColor = f.status === "WORKFLOW_DONE" ? chalk8.green : f.status === "DONE" ? chalk8.cyan : f.status === "DOING" ? chalk8.yellow : chalk8.gray;
+    const statusColor = f.status === "WORKFLOW_DONE" ? chalk9.green : f.status === "DONE" ? chalk9.cyan : f.status === "DOING" ? chalk9.yellow : chalk9.gray;
     console.log(
       `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${statusColor(f.status)} | ${f.progress} | ${f.step} | ${f.substate} | ${f.path} |`
     );
   }
   console.log();
   if (options.write) {
-    const outputPath = path12.join(featuresDir, "status.md");
+    const outputPath = path13.join(featuresDir, "status.md");
     const date = getLocalDateString();
     const content = [
       "# Feature Status",
@@ -7464,22 +7782,22 @@ async function runStatus(options) {
     ].join("\n");
     await ctx.fs.writeFile(outputPath, content, "utf-8");
     console.log(
-      chalk8.green(tr(lang, "cli", "status.wrote", { path: outputPath }))
+      chalk9.green(tr(lang, "cli", "status.wrote", { path: outputPath }))
     );
   }
 }
-function escapeRegExp2(value) {
+function escapeRegExp3(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 async function getFeatureNameFromSpec(fsAdapter, featureDir, fallbackSlug, fallbackFolderName) {
   try {
-    const specPath = path12.join(featureDir, "spec.md");
+    const specPath = path13.join(featureDir, "spec.md");
     if (!await fsAdapter.pathExists(specPath)) return fallbackSlug;
     const content = await fsAdapter.readFile(specPath, "utf-8");
     const keys = ["\uAE30\uB2A5\uBA85", "Feature Name"];
     for (const key of keys) {
       const regex = new RegExp(
-        `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:\\s*(.*)$`,
+        `^\\s*-\\s*\\*\\*${escapeRegExp3(key)}\\*\\*\\s*:\\s*(.*)$`,
         "m"
       );
       const match = content.match(regex);
@@ -7491,7 +7809,7 @@ async function getFeatureNameFromSpec(fsAdapter, featureDir, fallbackSlug, fallb
   return fallbackSlug || fallbackFolderName;
 }
 function updateCommand(program2) {
-  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--skills", "Cleanup legacy agents/skills copies (CLI-managed)").option("--templates", "Cleanup legacy feature-base copies (CLI-managed)").option(
+  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--agents-md", "Sync project-scoped AGENTS.md entrypoint").option("--skills", "Cleanup legacy agents/skills copies (CLI-managed)").option("--templates", "Cleanup legacy feature-base copies (CLI-managed)").option(
     "-f, --force",
     "Force overwrite even if docs has uncommitted changes"
   ).action(async (options) => {
@@ -7501,15 +7819,15 @@ function updateCommand(program2) {
       const config = await getConfig(process.cwd());
       const lang = config?.lang ?? DEFAULT_LANG;
       if (error instanceof Error && error.message === "canceled") {
-        console.log(chalk8.yellow(`
+        console.log(chalk9.yellow(`
 ${tr(lang, "cli", "common.canceled")}`));
         return;
       }
       const cliError = toCliError(error);
       const suggestions = getCliErrorSuggestions(cliError.code, lang);
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       printCliErrorSuggestions(suggestions, lang);
       process.exitCode = 1;
@@ -7534,30 +7852,31 @@ async function runUpdate(options) {
       const docsLockPath = getDocsLockPath(docsDir);
       const forceOverwrite = !!options.force || await isDocsWorktreeCleanOrThrow(docsDir, lang, [docsLockPath]);
       const configBackfill = await backfillMissingConfigDefaults(docsDir);
-      const hasExplicitSelection = !!(options.agents || options.skills || options.templates);
+      const hasExplicitSelection = !!(options.agents || options.agentsMd || options.skills || options.templates);
       const updateAgents = options.agents || options.skills || !hasExplicitSelection;
+      const updateAgentsMd = options.agentsMd || !hasExplicitSelection;
       const updateTemplates = options.templates || !hasExplicitSelection;
       const agentsMode = options.skills && !options.agents ? "skills" : "all";
-      console.log(chalk8.blue(tr(lang, "cli", "update.start")));
-      console.log(chalk8.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`));
+      console.log(chalk9.blue(tr(lang, "cli", "update.start")));
+      console.log(chalk9.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`));
       console.log(
-        chalk8.gray(`  - ${tr(lang, "cli", "update.typeLabel")}: ${projectType}`)
+        chalk9.gray(`  - ${tr(lang, "cli", "update.typeLabel")}: ${projectType}`)
       );
       console.log();
       let updatedCount = 0;
       if (updateAgents) {
         if (agentsMode === "skills") {
-          console.log(chalk8.blue(tr(lang, "cli", "update.updatingSkills")));
+          console.log(chalk9.blue(tr(lang, "cli", "update.updatingSkills")));
           console.log(
-            chalk8.gray(tr(lang, "cli", "update.engineManagedSkillsBuiltin"))
+            chalk9.gray(tr(lang, "cli", "update.engineManagedSkillsBuiltin"))
           );
-          console.log(chalk8.green(`  \u2705 ${tr(lang, "cli", "update.skillsUpdated")}`));
+          console.log(chalk9.green(`  \u2705 ${tr(lang, "cli", "update.skillsUpdated")}`));
         } else {
-          console.log(chalk8.blue(tr(lang, "cli", "update.updatingAgents")));
+          console.log(chalk9.blue(tr(lang, "cli", "update.updatingAgents")));
         }
         if (agentsMode === "all") {
-          const commonAgentsBase = path12.join(templatesDir, lang, "common", "agents");
-          const targetAgentsBase = path12.join(docsDir, "agents");
+          const commonAgentsBase = path13.join(templatesDir, lang, "common", "agents");
+          const targetAgentsBase = path13.join(docsDir, "agents");
           const commonAgents = commonAgentsBase;
           const targetAgents = targetAgentsBase;
           const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
@@ -7585,20 +7904,32 @@ async function runUpdate(options) {
             updatedCount += count;
           }
           console.log(
-            chalk8.green(
+            chalk9.green(
               `  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`
             )
           );
         }
       }
+      if (updateAgentsMd) {
+        const agentsMdTargets = await collectAgentsMdTargets(cwd, config);
+        for (const target of agentsMdTargets) {
+          const result = await upsertLeeSpecKitAgentsMd(target, {
+            lang,
+            docsRepo: config.docsRepo ?? "embedded"
+          });
+          if (result.changed) {
+            updatedCount += 1;
+          }
+        }
+      }
       if (updateTemplates) {
-        console.log(chalk8.blue(tr(lang, "cli", "update.updatingFeatureBase")));
-        console.log(chalk8.gray(tr(lang, "cli", "update.engineManagedFeatureBaseBuiltin")));
+        console.log(chalk9.blue(tr(lang, "cli", "update.updatingFeatureBase")));
+        console.log(chalk9.gray(tr(lang, "cli", "update.engineManagedFeatureBaseBuiltin")));
       }
       const pruned = await pruneEngineManagedDocs(docsDir);
       if (pruned.length > 0) {
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `  - ${tr(lang, "cli", "update.engineManagedPruned", {
               count: pruned.length
             })}`
@@ -7608,23 +7939,59 @@ async function runUpdate(options) {
       console.log();
       if (configBackfill.changed) {
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `  - ${tr(lang, "cli", "update.fileUpdated", { file: ".lee-spec-kit.json" })}`
           )
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `    (${configBackfill.changedPaths.join(", ")})`
           )
         );
       }
       console.log(
-        chalk8.green(`\u2705 ${tr(lang, "cli", "update.updatedTotal", { count: updatedCount })}`)
+        chalk9.green(`\u2705 ${tr(lang, "cli", "update.updatedTotal", { count: updatedCount })}`)
       );
     },
     { owner: "update" }
   );
 }
+function getGitTopLevelOrNull2(cwd) {
+  try {
+    const out = execFileSync("git", ["rev-parse", "--show-toplevel"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "ignore"]
+    });
+    const value = String(out || "").trim();
+    return value ? value : null;
+  } catch {
+    return null;
+  }
+}
+async function collectAgentsMdTargets(cwd, config) {
+  if (!config) return [];
+  const targets = /* @__PURE__ */ new Set();
+  const docsRepo = config.docsRepo ?? "embedded";
+  if (docsRepo === "embedded") {
+    const repoRoot = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || path13.resolve(config.docsDir, "..");
+    targets.add(path13.join(repoRoot, "AGENTS.md"));
+    return [...targets];
+  }
+  targets.add(path13.join(config.docsDir, "AGENTS.md"));
+  const baseDir = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || process.cwd();
+  const rawRoots = typeof config.projectRoot === "string" ? [config.projectRoot] : config.projectRoot && typeof config.projectRoot === "object" ? Object.values(config.projectRoot) : [];
+  for (const rawRoot of rawRoots) {
+    const value = String(rawRoot || "").trim();
+    if (!value) continue;
+    const resolved = path13.resolve(baseDir, value);
+    if (!await fs.pathExists(resolved)) continue;
+    const stat = await fs.stat(resolved);
+    if (!stat.isDirectory()) continue;
+    targets.add(path13.join(resolved, "AGENTS.md"));
+  }
+  return [...targets];
+}
 function isPlainObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -7661,7 +8028,7 @@ function normalizeDecisionEnumList2(raw) {
   return [...deduped];
 }
 async function backfillMissingConfigDefaults(docsDir) {
-  const configPath = path12.join(docsDir, ".lee-spec-kit.json");
+  const configPath = path13.join(docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     return { changed: false, changedPaths: [] };
   }
@@ -7784,8 +8151,8 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
   const files = await fs.readdir(sourceDir);
   let updatedCount = 0;
   for (const file of files) {
-    const sourcePath = path12.join(sourceDir, file);
-    const targetPath = path12.join(targetDir, file);
+    const sourcePath = path13.join(sourceDir, file);
+    const targetPath = path13.join(targetDir, file);
     const stat = await fs.stat(sourcePath);
     if (stat.isFile()) {
       if (protectedFiles.has(file)) {
@@ -7803,7 +8170,7 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
         }
         if (!force) {
           console.log(
-            chalk8.yellow(
+            chalk9.yellow(
               `  \u26A0\uFE0F ${file} - ${tr(lang, "cli", "update.changeDetected")}`
             )
           );
@@ -7813,7 +8180,7 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
       if (shouldUpdate) {
         await fs.writeFile(targetPath, sourceContent);
         console.log(
-          chalk8.gray(`  \u{1F4C4} ${tr(lang, "cli", "update.fileUpdated", { file })}`)
+          chalk9.gray(`  \u{1F4C4} ${tr(lang, "cli", "update.fileUpdated", { file })}`)
         );
         updatedCount++;
       }
@@ -7868,7 +8235,7 @@ function extractPorcelainPaths(line) {
 function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   const top = getGitTopLevel2(docsDir);
   if (!top) return null;
-  const rel = path12.relative(top, docsDir) || ".";
+  const rel = path13.relative(top, docsDir) || ".";
   try {
     const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
       cwd: top,
@@ -7880,7 +8247,7 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
     }
     const ignoredRelPaths = new Set(
       ignoredAbsPaths.map(
-        (absPath) => normalizeGitPath2(path12.relative(top, absPath) || ".")
+        (absPath) => normalizeGitPath2(path13.relative(top, absPath) || ".")
       )
     );
     const filtered = output.split("\n").filter((line) => {
@@ -7918,7 +8285,7 @@ function configCommand(program2) {
       if (error instanceof Error && error.message === "canceled") {
         const config2 = await getConfig(process.cwd());
         const lang2 = config2?.lang ?? DEFAULT_LANG;
-        console.log(chalk8.yellow(`
+        console.log(chalk9.yellow(`
 ${tr(lang2, "cli", "common.canceled")}`));
         return;
       }
@@ -7927,8 +8294,8 @@ ${tr(lang2, "cli", "common.canceled")}`));
       const cliError = toCliError(error);
       const suggestions = getCliErrorSuggestions(cliError.code, lang);
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       printCliErrorSuggestions(suggestions, lang);
       process.exitCode = 1;
@@ -7938,7 +8305,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runConfig(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path12.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path13.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   if (!config) {
     throw createCliError(
@@ -7946,13 +8313,13 @@ async function runConfig(options) {
       tr(DEFAULT_LANG, "cli", "common.configNotFound")
     );
   }
-  const configPath = path12.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
   if (!options.projectRoot) {
     console.log();
-    console.log(chalk8.blue(tr(config.lang, "cli", "config.currentTitle")));
+    console.log(chalk9.blue(tr(config.lang, "cli", "config.currentTitle")));
     console.log();
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `  ${tr(config.lang, "cli", "config.pathLabel")}: ${configPath}`
       )
     );
@@ -7969,7 +8336,7 @@ async function runConfig(options) {
       const configFile = await fs.readJson(configPath);
       if (configFile.docsRepo !== "standalone") {
         console.log(
-          chalk8.yellow(tr(config.lang, "cli", "config.projectRootStandaloneOnly"))
+          chalk9.yellow(tr(config.lang, "cli", "config.projectRootStandaloneOnly"))
         );
         return;
       }
@@ -8019,7 +8386,7 @@ async function runConfig(options) {
         currentRoot[targetComponent] = projectRoot;
         configFile.projectRoot = currentRoot;
         console.log(
-          chalk8.green(
+          chalk9.green(
             tr(config.lang, "cli", "config.projectRootSet", {
               repo: targetComponent.toUpperCase(),
               path: projectRoot
@@ -8035,7 +8402,7 @@ async function runConfig(options) {
         }
         configFile.projectRoot = projectRoot;
         console.log(
-          chalk8.green(
+          chalk9.green(
             tr(config.lang, "cli", "config.projectRootSetSingle", {
               path: projectRoot
             })
@@ -8052,47 +8419,47 @@ var BUILTIN_DOC_DEFINITIONS = [
   {
     id: "agents",
     title: { ko: "\uC5D0\uC774\uC804\uD2B8 \uC6B4\uC601 \uADDC\uCE59", en: "Agent Operating Rules" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "agents.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "agents.md")
   },
   {
     id: "git-workflow",
     title: { ko: "Git \uC6CC\uD06C\uD50C\uB85C\uC6B0", en: "Git Workflow" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "git-workflow.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "git-workflow.md")
   },
   {
     id: "issue-doc",
     title: { ko: "Issue \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "Issue Document Template" },
-    relativePath: (_, lang) => path12.join(lang, "common", "features", "feature-base", "issue.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "features", "feature-base", "issue.md")
   },
   {
     id: "pr-doc",
     title: { ko: "PR \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "PR Document Template" },
-    relativePath: (_, lang) => path12.join(lang, "common", "features", "feature-base", "pr.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "features", "feature-base", "pr.md")
   },
   {
     id: "create-feature",
     title: { ko: "create-feature \uC2A4\uD0AC", en: "create-feature skill" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "create-feature.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-feature.md")
   },
   {
     id: "execute-task",
     title: { ko: "execute-task \uC2A4\uD0AC", en: "execute-task skill" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "execute-task.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "execute-task.md")
   },
   {
     id: "create-issue",
     title: { ko: "create-issue \uC2A4\uD0AC", en: "create-issue skill" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "create-issue.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-issue.md")
   },
   {
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "create-pr.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-pr.md")
   },
   {
     id: "split-feature",
     title: { ko: "feature \uBD84\uD560 \uAC00\uC774\uB4DC", en: "feature split guide" },
-    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "split-feature.md")
+    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "split-feature.md")
   }
 ];
 var DOC_FOLLOWUPS = {
@@ -8189,7 +8556,7 @@ function listBuiltinDocs(projectType, lang) {
       id: doc.id,
       title: doc.title[lang],
       relativePath,
-      absolutePath: path12.join(templatesDir, relativePath)
+      absolutePath: path13.join(templatesDir, relativePath)
     };
   });
 }
@@ -8610,7 +8977,7 @@ function getActionExecutionMetadata(action) {
     return {
       handoffOnly: true,
       advancesWorkflow: false,
-      nextMainState: "pre_pr_review_running"
+      nextMainState: "pre_pr_review_in_progress"
     };
   }
   return null;
@@ -8749,6 +9116,73 @@ function buildApprovalCommand(state, featureName, selectedComponent, execute) {
   }
   return `npx lee-spec-kit context ${featureRef}${componentArg} --approve <LABEL>`;
 }
+function buildFeatureComponentArgs(feature) {
+  return feature.type && feature.type !== "single" ? ["--component", feature.type] : [];
+}
+function buildPrePrRecordCommand(feature, decision) {
+  const args = [
+    "pre-pr-review",
+    feature.folderName,
+    ...buildFeatureComponentArgs(feature),
+    "--evidence",
+    "review-trace.json",
+    "--decision",
+    decision
+  ];
+  return `npx lee-spec-kit ${args.join(" ")}`;
+}
+function buildDelegatedActionContract(state) {
+  const feature = state.matchedFeature;
+  const substateId = feature?.currentSubstateId;
+  if (!feature || !substateId) return null;
+  if (substateId === "pre_pr_review_run" || substateId === "pre_pr_review_in_progress") {
+    return {
+      required: true,
+      mode: "command",
+      category: "pre_pr_review_run",
+      currentSubstateId: substateId,
+      delegatedWorkRequired: true,
+      handoffOnly: true,
+      advancesWorkflow: false,
+      doNotReapproveSameLabel: substateId === "pre_pr_review_in_progress",
+      nextMainState: "pre_pr_review_in_progress",
+      reuseKey: `pre-pr:${feature.folderName}`,
+      evidenceFile: "review-trace.json",
+      nextStepRequirement: "generate_review_trace_then_record",
+      recordCommands: {
+        changesRequested: buildPrePrRecordCommand(
+          feature,
+          "changes_requested"
+        ),
+        approve: buildPrePrRecordCommand(feature, "approve")
+      },
+      guidance: substateId === "pre_pr_review_in_progress" ? "A pre-PR review is already in progress. Reuse or resume the delegated review, generate structured review evidence, then record the result with pre-pr-review. Do not re-approve the same label." : "After approval, spawn_agent first and hand off the delegated pre-PR review. Handoff-only execution only prepares the review session; continue the delegated review immediately after approval."
+    };
+  }
+  if (substateId === "code_review_run" || substateId === "code_review_running") {
+    return {
+      required: true,
+      mode: "command",
+      category: "code_review_run",
+      currentSubstateId: substateId,
+      delegatedWorkRequired: true,
+      handoffOnly: true,
+      advancesWorkflow: false,
+      doNotReapproveSameLabel: substateId === "code_review_running",
+      nextMainState: "code_review_running",
+      reuseKey: `code-review:${feature.folderName}`,
+      guidance: substateId === "code_review_running" ? "A PR review handoff is already prepared. Reuse or resume the delegated review-fix work, then refresh PR Review Evidence and PR Review Decision before continuing. Do not re-approve the same label." : "After approval, spawn_agent first and hand off the delegated PR review-fix work. Handoff-only execution only prepares the delegated session; continue the delegated work immediately after approval."
+    };
+  }
+  return null;
+}
+function buildDelegatedApprovalGuidance(handoffRequired, handoffMode) {
+  const base = "Before asking for approval, show only `actionOptions[].approvalPrompt` lines and `approvalRequest.finalPrompt` to the user. Keep `requiredDocs`, `checkPolicy`, and raw execution commands as internal guidance. For commit actions, include scope (`docs`/`project`) and commit message in the visible prompt. User replies should include the label token (e.g. `A`, `A OK`, `A proceed`, `A \uC9C4\uD589\uD574`).";
+  const delegatedCommand = handoffRequired && handoffMode === "command" ? ' 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, `--execute` only prepares the handoff; continue the delegated work immediately and do not re-approve the same label.' : "";
+  const nonDelegated = " For non-delegated command actions, prefer one-shot `npx lee-spec-kit flow <featureRef> --approve <LABEL> --execute` to avoid session mismatch after context compression/reset. Use ticket-based `context --execute --ticket` only when explicitly needed.";
+  const orchestration = ' Use main-agent orchestration: keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT; `currentActionShouldDelegate` is a compatibility mirror. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.';
+  return `${base}${delegatedCommand}${nonDelegated}${orchestration}`;
+}
 function buildFinalApprovalPrompt(lang, actionOptions) {
   if (actionOptions.length === 0) return "";
   const labels = listLabels(actionOptions);
@@ -8954,12 +9388,12 @@ function printSuggestionOptions(lang, suggestionOptions) {
   if (suggestionOptions.length === 0) return;
   const finalPrompt = buildSuggestionFinalPrompt(lang, suggestionOptions);
   console.log(
-    chalk8.green(chalk8.bold(`\u{1F449} ${tr(lang, "cli", "context.suggestionHeader")}`))
+    chalk9.green(chalk9.bold(`\u{1F449} ${tr(lang, "cli", "context.suggestionHeader")}`))
   );
   suggestionOptions.forEach((option) => {
     console.log(`   ${option.label}: ${option.summary}`);
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `   \u21B3 ${tr(lang, "cli", "context.suggestionCommandHint", {
           command: option.command
         })}`
@@ -8967,7 +9401,7 @@ function printSuggestionOptions(lang, suggestionOptions) {
     );
   });
   if (finalPrompt) {
-    console.log(chalk8.cyan(`   \u21B3 ${finalPrompt}`));
+    console.log(chalk9.cyan(`   \u21B3 ${finalPrompt}`));
   }
 }
 function buildRequiredDocHints(actionOptions) {
@@ -9159,7 +9593,7 @@ function getApprovalSessionId() {
 function getApprovalTicketPaths(config) {
   return {
     runtimePath: getApprovalTicketStorePath(config.docsDir),
-    legacyPath: path12.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
+    legacyPath: path13.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
   };
 }
 async function loadApprovalTicketStore(storePath) {
@@ -9173,7 +9607,7 @@ async function loadApprovalTicketStore(storePath) {
   }
 }
 async function saveApprovalTicketStore(storePath, payload) {
-  await fs.ensureDir(path12.dirname(storePath));
+  await fs.ensureDir(path13.dirname(storePath));
   await fs.writeJson(storePath, payload, { spaces: 2 });
 }
 function pruneApprovalTickets(tickets, nowMs) {
@@ -9358,6 +9792,28 @@ function getCommandExecutionLockPath(action, config) {
   }
   return getProjectExecutionLockPath(action.cwd);
 }
+function buildApprovedHandoffMetadata(action, featureRef) {
+  if (action.category === "pre_pr_review_run") {
+    return {
+      delegatedWorkRequired: true,
+      doNotReapproveSameLabel: true,
+      reuseKey: `pre-pr:${featureRef}`,
+      nextStepRequirement: "generate_review_trace_then_record",
+      evidenceFile: "review-trace.json"
+    };
+  }
+  if (action.category === "code_review_run") {
+    return {
+      delegatedWorkRequired: true,
+      doNotReapproveSameLabel: true,
+      reuseKey: `code-review:${featureRef}`
+    };
+  }
+  return {
+    delegatedWorkRequired: true,
+    doNotReapproveSameLabel: true
+  };
+}
 async function runApprovedOption(state, config, lang, featureName, selectionOptions, options) {
   const approval = options.approve || "";
   const ticketToken = (options.ticket || "").trim();
@@ -9482,10 +9938,10 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
       return;
     }
     console.log();
-    console.log(chalk8.green(`\u2705 Approved option: ${parsedLabel}`));
-    console.log(chalk8.gray(`   - Action: ${freshSelected.detail}`));
+    console.log(chalk9.green(`\u2705 Approved option: ${parsedLabel}`));
+    console.log(chalk9.gray(`   - Action: ${freshSelected.detail}`));
     if (userRequest) {
-      console.log(chalk8.gray(`   - User request: ${userRequest}`));
+      console.log(chalk9.gray(`   - User request: ${userRequest}`));
     }
     if (selectedAction.type === "command") {
       const selectedComponent = selectionOptions.component || "";
@@ -9496,24 +9952,24 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
           `--ticket ${ticket.token}`
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `   - Ticket: ${ticket.token} (expires: ${ticket.expiresAt})`
           )
         );
       } else {
         executeCommand = executeCommand.replace(" [--ticket <TICKET>]", "");
       }
-      console.log(chalk8.gray(`   - Run with: ${executeCommand}`));
+      console.log(chalk9.gray(`   - Run with: ${executeCommand}`));
       if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             "   - This command prepares a handoff only; complete the delegated work and update workflow evidence before re-running context."
           )
         );
       }
     } else {
       console.log(
-        chalk8.gray("   - Instruction-only action (no command execution).")
+        chalk9.gray("   - Instruction-only action (no command execution).")
       );
     }
     console.log();
@@ -9564,19 +10020,19 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     }
     console.log();
     console.log(
-      chalk8.yellow(`\u26A0\uFE0F  Approved label ${parsedLabel} is instruction-only.`)
+      chalk9.yellow(`\u26A0\uFE0F  Approved label ${parsedLabel} is instruction-only.`)
     );
     if (userRequest) {
-      console.log(chalk8.gray(`   User request: ${userRequest}`));
+      console.log(chalk9.gray(`   User request: ${userRequest}`));
     }
-    console.log(chalk8.gray(`   ${selectedAction.message}`));
+    console.log(chalk9.gray(`   ${selectedAction.message}`));
     console.log();
     return;
   }
   if (!jsonMode) {
     console.log();
-    console.log(chalk8.blue(`\u25B6 Executing option ${parsedLabel}...`));
-    console.log(chalk8.gray(`   ${selectedAction.cmd}`));
+    console.log(chalk9.blue(`\u25B6 Executing option ${parsedLabel}...`));
+    console.log(chalk9.gray(`   ${selectedAction.cmd}`));
     console.log();
   }
   try {
@@ -9588,6 +10044,10 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     );
     if (jsonMode) {
       if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
+        const handoffMetadata = buildApprovedHandoffMetadata(
+          selectedAction,
+          freshState.matchedFeature?.folderName ?? featureRef
+        );
         console.log(
           JSON.stringify(
             {
@@ -9602,6 +10062,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
               handoffOnly: true,
               advancesWorkflow: false,
               nextMainState: executionMetadata.nextMainState,
+              ...handoffMetadata,
               stdout: execResult.stdout?.trim() || void 0,
               stderr: execResult.stderr?.trim() || void 0
             },
@@ -9633,14 +10094,14 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     }
     if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
       console.log(
-        chalk8.yellow(
+        chalk9.yellow(
           "Prepared handoff only. Complete the delegated work and update workflow evidence before re-running context."
         )
       );
       console.log();
       return;
     }
-    console.log(chalk8.green(`\u2705 Executed option ${parsedLabel}.`));
+    console.log(chalk9.green(`\u2705 Executed option ${parsedLabel}.`));
     console.log();
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -9688,8 +10149,8 @@ function contextCommand(program2) {
           );
         } else {
           console.error(
-            chalk8.red(tr(lang, "cli", "common.errorLabel")),
-            chalk8.red(`[${cliError.code}] ${cliError.message}`)
+            chalk9.red(tr(lang, "cli", "common.errorLabel")),
+            chalk9.red(`[${cliError.code}] ${cliError.message}`)
           );
           printCliErrorSuggestions(suggestions, lang);
         }
@@ -9782,6 +10243,11 @@ async function runContext(featureName, options) {
     state.matchedFeature?.folderName || null,
     state.matchedFeature?.currentSubstateOwner
   );
+  const delegatedAction = buildDelegatedActionContract(state);
+  const approvalGuidance = buildDelegatedApprovalGuidance(
+    agentOrchestration.subAgentHandoff.required,
+    agentOrchestration.subAgentHandoff.mode
+  );
   if (options.approve || options.execute) {
     await runApprovedOption(
       state,
@@ -9840,6 +10306,7 @@ async function runContext(featureName, options) {
         agentOrchestration: {
           subAgentHandoff: agentOrchestration.subAgentHandoff
         },
+        delegatedAction,
         autoRun: {
           available: autoRunPlan.available,
           policyEligible: autoRunPlan.policyEligible,
@@ -9975,13 +10442,14 @@ async function runContext(featureName, options) {
           "actionOptions[].detail",
           "actionOptions[].approvalPrompt"
         ] : [],
-        recommendation: 'Before asking for approval, show only `actionOptions[].approvalPrompt` lines and `approvalRequest.finalPrompt` to the user. Keep `requiredDocs`, `checkPolicy`, and raw execution commands as internal guidance. For commit actions, include scope (`docs`/`project`) and commit message in the visible prompt. User replies should include the label token (e.g. `A`, `A OK`, `A proceed`, `A \uC9C4\uD589\uD574`). For command execution, prefer one-shot `npx lee-spec-kit flow <featureRef> --approve <LABEL> --execute` to avoid session mismatch after context compression/reset. Use ticket-based `context --execute --ticket` only when explicitly needed. Use main-agent orchestration: keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT; `currentActionShouldDelegate` is a compatibility mirror. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.',
+        recommendation: approvalGuidance,
         oneApprovalPerAction: approvalRequired,
         requireFreshContext: true,
         contextVersion: state.contextVersion,
         config: config.approval ?? { mode: "builtin" }
       },
       agentOrchestration,
+      delegatedAction,
       autoRun: {
         available: autoRunPlan.available,
         policyEligible: autoRunPlan.policyEligible,
@@ -9995,7 +10463,10 @@ async function runContext(featureName, options) {
         guidance: 'Use auto-run only when `autoRun.available=true`. If `autoRun.policyEligible=true` but `autoRun.executableNow=false`, resolve `autoRun.manualBoundary` first. Do not treat `autoRun.available` alone as a delegation trigger; use `agentOrchestration.subAgentHandoff.required` + `mode="auto_run"` for actual delegation. Stop and request approval when `approvalRequest.required=true` or when auto mode reaches configured gate categories.'
       },
       approvalRequest: {
-        guidance: 'User-facing output must include only approval prompts (`A: ...`) and `finalPrompt`. Do not expose `requiredDocs`, `checkPolicy`, or raw `cmd` unless explicitly requested. For approved command actions, prefer one-shot `flow --approve <LABEL> --execute`. Keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT; `currentActionShouldDelegate` is a compatibility mirror. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.',
+        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`."
+        ),
         required: approvalRequired,
         finalPrompt: finalApprovalPrompt,
         userFacingLines: approvalUserFacingLines,
@@ -10048,11 +10519,11 @@ async function runContext(featureName, options) {
     return;
   }
   console.log();
-  console.log(chalk8.bold(tr(lang, "cli", "context.header")));
+  console.log(chalk9.bold(tr(lang, "cli", "context.header")));
   if (config.projectType === "single") {
     if (state.branches.project.single) {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   (Detected from Project Branch: ${state.branches.project.single})`
         )
       );
@@ -10061,7 +10532,7 @@ async function runContext(featureName, options) {
     const branchName = state.branches.project[selectedComponent] || "";
     if (branchName) {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   (Detected from Project Branch: ${selectedComponent.toUpperCase()} ${branchName})`
         )
       );
@@ -10070,37 +10541,37 @@ async function runContext(featureName, options) {
     const parts = Object.entries(state.branches.project).filter(([key, value]) => key !== "single" && !!value).map(([key, value]) => `${key.toUpperCase()} ${value}`);
     if (parts.length > 0) {
       console.log(
-        chalk8.gray(`   (Detected from Project Branch: ${parts.join(" / ")})`)
+        chalk9.gray(`   (Detected from Project Branch: ${parts.join(" / ")})`)
       );
     }
   }
   if (config.docsRepo === "standalone" && state.branches.docs) {
-    console.log(chalk8.gray(`   (Docs Branch: ${state.branches.docs})`));
+    console.log(chalk9.gray(`   (Docs Branch: ${state.branches.docs})`));
   }
-  console.log(chalk8.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+  console.log(chalk9.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
   console.log();
   if (state.features.length === 0) {
-    console.log(chalk8.yellow(tr(lang, "cli", "context.noActiveFeatures")));
+    console.log(chalk9.yellow(tr(lang, "cli", "context.noActiveFeatures")));
     console.log();
     printSuggestionOptions(lang, suggestionOptions);
     console.log();
     return;
   }
   if (state.warnings.length > 0) {
-    console.log(chalk8.yellow(tr(lang, "cli", "context.envWarnings")));
-    state.warnings.forEach((w) => console.log(chalk8.yellow(`   - ${w}`)));
+    console.log(chalk9.yellow(tr(lang, "cli", "context.envWarnings")));
+    state.warnings.forEach((w) => console.log(chalk9.yellow(`   - ${w}`)));
     console.log();
   }
   if (state.targetFeatures.length === 0) {
-    console.log(chalk8.yellow(tr(lang, "cli", "context.noActiveFeatures")));
+    console.log(chalk9.yellow(tr(lang, "cli", "context.noActiveFeatures")));
     if (state.status === "no_open") {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   $ npx lee-spec-kit context --done  # ${tr(lang, "cli", "context.tipShowDone")}`
         )
       );
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   $ npx lee-spec-kit context --all   # ${tr(lang, "cli", "context.tipShowAll")}`
         )
       );
@@ -10113,7 +10584,7 @@ async function runContext(featureName, options) {
   if (state.targetFeatures.length > 1) {
     if (state.selectionMode === "open") {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   ${tr(lang, "cli", "context.openFallbackSummary", {
             inProgress: state.inProgressFeatures.length,
             readyToClose: state.readyToCloseFeatures.length,
@@ -10125,7 +10596,7 @@ async function runContext(featureName, options) {
     }
     if (state.selectionMode === "open") {
       console.log(
-        chalk8.blue(
+        chalk9.blue(
           `\u{1F539} ${tr(lang, "cli", "context.sectionInProgress")} (${state.inProgressFeatures.length})`
         )
       );
@@ -10137,14 +10608,14 @@ async function runContext(featureName, options) {
           workflowPolicy,
           prePrReviewPolicy
         );
-        const typeStr = config.projectType === "multi" ? chalk8.cyan(`(${f2.type})`) : "";
+        const typeStr = config.projectType === "multi" ? chalk9.cyan(`(${f2.type})`) : "";
         console.log(
-          `   \u2022 ${chalk8.bold(f2.folderName)} ${typeStr} - ${chalk8.yellow(stepName2)}`
+          `   \u2022 ${chalk9.bold(f2.folderName)} ${typeStr} - ${chalk9.yellow(stepName2)}`
         );
       });
       console.log();
       console.log(
-        chalk8.blue(
+        chalk9.blue(
           `\u{1F538} ${tr(lang, "cli", "context.sectionReadyToClose")} (${state.readyToCloseFeatures.length})`
         )
       );
@@ -10156,14 +10627,14 @@ async function runContext(featureName, options) {
           workflowPolicy,
           prePrReviewPolicy
         );
-        const typeStr = config.projectType === "multi" ? chalk8.cyan(`(${f2.type})`) : "";
+        const typeStr = config.projectType === "multi" ? chalk9.cyan(`(${f2.type})`) : "";
         console.log(
-          `   \u2022 ${chalk8.bold(f2.folderName)} ${typeStr} - ${chalk8.yellow(stepName2)}`
+          `   \u2022 ${chalk9.bold(f2.folderName)} ${typeStr} - ${chalk9.yellow(stepName2)}`
         );
       });
     } else {
       const title = state.selectionMode === "all" ? `\u{1F539} ${state.targetFeatures.length} Features:` : state.selectionMode === "done" ? `\u{1F539} ${state.targetFeatures.length} Done Features:` : `\u{1F539} ${state.targetFeatures.length} Features Detected:`;
-      console.log(chalk8.blue(title));
+      console.log(chalk9.blue(title));
       console.log();
       state.targetFeatures.forEach((f2) => {
         const stepName2 = getListLabel(
@@ -10173,24 +10644,24 @@ async function runContext(featureName, options) {
           workflowPolicy,
           prePrReviewPolicy
         );
-        const typeStr = config.projectType === "multi" ? chalk8.cyan(`(${f2.type})`) : "";
+        const typeStr = config.projectType === "multi" ? chalk9.cyan(`(${f2.type})`) : "";
         console.log(
-          `   \u2022 ${chalk8.bold(f2.folderName)} ${typeStr} - ${chalk8.yellow(stepName2)}`
+          `   \u2022 ${chalk9.bold(f2.folderName)} ${typeStr} - ${chalk9.yellow(stepName2)}`
         );
       });
     }
     console.log();
-    console.log(chalk8.gray(tr(lang, "cli", "context.tipDetails")));
+    console.log(chalk9.gray(tr(lang, "cli", "context.tipDetails")));
     const selectorTip = config.projectType === "multi" ? selectedComponent ? `   $ npx lee-spec-kit context <slug|F001|F001-slug> --component ${selectedComponent}` : "   $ npx lee-spec-kit context <slug|F001|F001-slug> [--component <component>]" : "   $ npx lee-spec-kit context <slug|F001|F001-slug>";
-    console.log(chalk8.gray(selectorTip));
+    console.log(chalk9.gray(selectorTip));
     if (state.selectionMode === "open") {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   $ npx lee-spec-kit context --all   # ${tr(lang, "cli", "context.tipShowAll")}`
         )
       );
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   $ npx lee-spec-kit context --done  # ${tr(lang, "cli", "context.tipShowDone")}`
         )
       );
@@ -10202,47 +10673,47 @@ async function runContext(featureName, options) {
   }
   const f = state.targetFeatures[0];
   const stepName = stepsMap[f.currentStep] || "Unknown";
-  const checkTag = (requiresUserCheck) => requiresUserCheck ? chalk8.yellow(tr(lang, "cli", "context.checkRequired")) : "";
+  const checkTag = (requiresUserCheck) => requiresUserCheck ? chalk9.yellow(tr(lang, "cli", "context.checkRequired")) : "";
   const hasCheckAction = approvalRequired;
   console.log(
-    `\u{1F539} Feature: ${chalk8.bold(f.folderName)} ${config.projectType === "multi" ? chalk8.cyan(`(${f.type})`) : ""}`
+    `\u{1F539} Feature: ${chalk9.bold(f.folderName)} ${config.projectType === "multi" ? chalk9.cyan(`(${f.type})`) : ""}`
   );
   console.log(
-    `   \u2022 Completion: ${f.completion.implementationDone ? chalk8.green("Implementation \u2705") : chalk8.gray("Implementation \u25EF")} / ${f.completion.workflowDone ? chalk8.green("Workflow \u2705") : chalk8.yellow("Workflow \u25EF")}`
+    `   \u2022 Completion: ${f.completion.implementationDone ? chalk9.green("Implementation \u2705") : chalk9.gray("Implementation \u25EF")} / ${f.completion.workflowDone ? chalk9.green("Workflow \u2705") : chalk9.yellow("Workflow \u25EF")}`
   );
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
-  console.log(`   \u2022 Path: ${path12.relative(cwd, f.path)}`);
+  console.log(`   \u2022 Path: ${path13.relative(cwd, f.path)}`);
   if (f.git.projectBranch) {
     console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
   }
   console.log();
   console.log(
-    `\u{1F539} Progress: ${chalk8.yellow(`Step ${f.currentStep}. ${stepName}`)}`
+    `\u{1F539} Progress: ${chalk9.yellow(`Step ${f.currentStep}. ${stepName}`)}`
   );
   if (f.activeTask) {
     console.log(
-      `   \u2022 Active Task: ${chalk8.yellow(`[${f.activeTask.status}]`)} ${f.activeTask.title}`
+      `   \u2022 Active Task: ${chalk9.yellow(`[${f.activeTask.status}]`)} ${f.activeTask.title}`
     );
   } else if (f.nextTodoTask && f.currentStep === 10) {
     console.log(
-      `   \u2022 Next TODO: ${chalk8.gray(`[${f.nextTodoTask.status}]`)} ${f.nextTodoTask.title}`
+      `   \u2022 Next TODO: ${chalk9.gray(`[${f.nextTodoTask.status}]`)} ${f.nextTodoTask.title}`
     );
   }
   printChecklist(f, stepDefinitions);
   if (f.warnings.length > 0) {
     console.log();
-    console.log(chalk8.yellow("\u26A0\uFE0F  Feature Warnings:"));
-    f.warnings.forEach((w) => console.log(chalk8.yellow(`   - ${w}`)));
+    console.log(chalk9.yellow("\u26A0\uFE0F  Feature Warnings:"));
+    f.warnings.forEach((w) => console.log(chalk9.yellow(`   - ${w}`)));
   }
   console.log();
-  console.log(chalk8.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+  console.log(chalk9.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
   if (hasCheckAction) {
-    console.log(chalk8.gray(tr(lang, "cli", "context.checkPolicyHint")));
+    console.log(chalk9.gray(tr(lang, "cli", "context.checkPolicyHint")));
   }
   if (!f.actions || f.actions.length === 0) {
-    console.log(`\u{1F449} Next Action: ${chalk8.green(chalk8.bold(f.nextAction))}`);
+    console.log(`\u{1F449} Next Action: ${chalk9.green(chalk9.bold(f.nextAction))}`);
     console.log();
     return;
   }
@@ -10255,7 +10726,7 @@ async function runContext(featureName, options) {
     f.currentSubstateOwner
   );
   const showOptionLabels = hasCheckAction;
-  console.log(chalk8.green(chalk8.bold("\u{1F449} Next Options (Atomic):")));
+  console.log(chalk9.green(chalk9.bold("\u{1F449} Next Options (Atomic):")));
   let hasDocsCommand = false;
   actionOptions.forEach((option) => {
     const requiresCheck = option.action.requiresUserCheck;
@@ -10268,26 +10739,26 @@ async function runContext(featureName, options) {
   });
   if (hasDocsCommand) {
     console.log(
-      chalk8.gray(`   \u21B3 ${tr(lang, "cli", "context.tipDocsCommitRules")}`)
+      chalk9.gray(`   \u21B3 ${tr(lang, "cli", "context.tipDocsCommitRules")}`)
     );
   }
   if (hasCommandOption && longRunningDelegation.shouldDelegate) {
     console.log(
-      chalk8.gray(`   \u21B3 ${tr(lang, "cli", "context.subAgentOrchestrationHint")}`)
+      chalk9.gray(`   \u21B3 ${tr(lang, "cli", "context.subAgentOrchestrationHint")}`)
     );
   }
   if (hasCheckAction) {
     console.log(
-      chalk8.gray(`   \u21B3 ${tr(lang, "cli", "context.actionOptionHint")}`)
+      chalk9.gray(`   \u21B3 ${tr(lang, "cli", "context.actionOptionHint")}`)
     );
     console.log(
-      chalk8.gray(`   \u21B3 ${tr(lang, "cli", "context.actionExplainHint")}`)
+      chalk9.gray(`   \u21B3 ${tr(lang, "cli", "context.actionExplainHint")}`)
     );
   }
   if (requiredDocs.length > 0) {
     for (const requiredDoc of requiredDocs) {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   \u21B3 ${tr(lang, "cli", "context.readBuiltinDocFirst", {
             command: requiredDoc.command
           })}`
@@ -10296,9 +10767,9 @@ async function runContext(featureName, options) {
     }
   }
   if (autoRunPlan.available) {
-    console.log(chalk8.gray(`   \u21B3 ${autoRunPlan.summary}`));
+    console.log(chalk9.gray(`   \u21B3 ${autoRunPlan.summary}`));
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `   \u21B3 ${tr(lang, "cli", "context.autoRunCommandHint", {
           command: autoRunPlan.command
         })}`
@@ -10318,16 +10789,16 @@ async function runContext(featureName, options) {
       selectedComponent,
       true
     );
-    console.log(chalk8.cyan(`   \u21B3 ${finalApprovalPrompt}`));
+    console.log(chalk9.cyan(`   \u21B3 ${finalApprovalPrompt}`));
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `   \u21B3 ${tr(lang, "cli", "context.finalLabelCommandHint", {
           command: approveCommand
         })}`
       )
     );
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `   \u21B3 ${tr(lang, "cli", "context.finalTicketCommandHint", {
           command: executeCommand
         })}`
@@ -10341,8 +10812,8 @@ function printChecklist(f, stepDefinitions) {
   checklistSteps.forEach((definition) => {
     const done = definition.checklist.done(f);
     const detail = definition.checklist.detail?.(f) ?? "";
-    const mark = done ? chalk8.green("\u2705") : chalk8.gray("\u25EF");
-    const label = definition.step === f.currentStep ? chalk8.bold(definition.name) : definition.name;
+    const mark = done ? chalk9.green("\u2705") : chalk9.gray("\u25EF");
+    const label = definition.step === f.currentStep ? chalk9.bold(definition.name) : definition.name;
     console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
   });
 }
@@ -10365,7 +10836,7 @@ function extractTitleAfterId(line, id) {
   return cleaned ? cleaned : void 0;
 }
 async function scanPrdRequirements(fsAdapter, docsDir) {
-  const prdDir = path12.join(docsDir, "prd");
+  const prdDir = path13.join(docsDir, "prd");
   const files = await walkFiles(fsAdapter, prdDir, {
     extensions: [".md"],
     ignoreDirs: [".git", "node_modules", "dist", "tmp"]
@@ -10373,7 +10844,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
   const definitions = /* @__PURE__ */ new Map();
   const duplicates = [];
   for (const filePath of files) {
-    if (path12.basename(filePath).toLowerCase() === "readme.md") {
+    if (path13.basename(filePath).toLowerCase() === "readme.md") {
       continue;
     }
     let content = "";
@@ -10382,7 +10853,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
     } catch {
       continue;
     }
-    const relFile = normalizeRelPath2(path12.relative(docsDir, filePath));
+    const relFile = normalizeRelPath2(path13.relative(docsDir, filePath));
     const lines = content.split(/\r?\n/);
     let inCodeBlock = false;
     for (let i = 0; i < lines.length; i += 1) {
@@ -10457,7 +10928,7 @@ var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
 ]);
 function formatPath(cwd, p) {
   if (!p) return "";
-  return path12.isAbsolute(p) ? path12.relative(cwd, p) : p;
+  return path13.isAbsolute(p) ? path13.relative(cwd, p) : p;
 }
 function detectPlaceholders(content) {
   const patterns = [
@@ -10616,7 +11087,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
     const placeholderContext = {
       projectName: config.projectName,
       featureName: f.slug,
-      featurePath: f.docs.featurePathFromDocs || path12.relative(config.docsDir, f.path),
+      featurePath: f.docs.featurePathFromDocs || path13.relative(config.docsDir, f.path),
       repoType: f.type,
       featureNumber
     };
@@ -10626,7 +11097,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       "tasks.md"
     ];
     for (const file of files) {
-      const fullPath = path12.join(f.path, file);
+      const fullPath = path13.join(f.path, file);
       if (!await fs.pathExists(fullPath)) continue;
       const original = await fs.readFile(fullPath, "utf-8");
       let next = original;
@@ -10679,7 +11150,7 @@ async function checkDocsStructure(config, cwd) {
   const issues = [];
   const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
   for (const dir of requiredDirs) {
-    const p = path12.join(config.docsDir, dir);
+    const p = path13.join(config.docsDir, dir);
     if (!await fs.pathExists(p)) {
       issues.push({
         level: "error",
@@ -10691,7 +11162,7 @@ async function checkDocsStructure(config, cwd) {
       });
     }
   }
-  const configPath = path12.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     issues.push({
       level: "warn",
@@ -10719,7 +11190,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   }
   const idMap = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const rel = f.docs.featurePathFromDocs || path12.relative(config.docsDir, f.path);
+    const rel = f.docs.featurePathFromDocs || path13.relative(config.docsDir, f.path);
     const id = f.id || "UNKNOWN";
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(rel);
@@ -10727,7 +11198,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
     if (!isInitialTemplateState) {
       const featureDocs = ["spec.md", "plan.md", "tasks.md"];
       for (const file of featureDocs) {
-        const p = path12.join(f.path, file);
+        const p = path13.join(f.path, file);
         if (!await fs.pathExists(p)) continue;
         const content = await fs.readFile(p, "utf-8");
         const placeholders = detectPlaceholders(content);
@@ -10742,7 +11213,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         });
       }
       if (decisionsPlaceholderMode !== "off") {
-        const decisionsPath = path12.join(f.path, "decisions.md");
+        const decisionsPath = path13.join(f.path, "decisions.md");
         if (await fs.pathExists(decisionsPath)) {
           const content = await fs.readFile(decisionsPath, "utf-8");
           const placeholders = detectPlaceholders(content);
@@ -10771,7 +11242,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "spec_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.specStatusUnset"),
-        path: formatPath(cwd, path12.join(f.path, "spec.md"))
+        path: formatPath(cwd, path13.join(f.path, "spec.md"))
       });
     }
     if (f.docs.planExists && !f.planStatus && !isInitialTemplateState) {
@@ -10779,7 +11250,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "plan_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.planStatusUnset"),
-        path: formatPath(cwd, path12.join(f.path, "plan.md"))
+        path: formatPath(cwd, path13.join(f.path, "plan.md"))
       });
     }
     if (f.docs.tasksExists && f.tasks.total === 0 && !isInitialTemplateState) {
@@ -10787,11 +11258,11 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_empty",
         message: tr(config.lang, "cli", "doctor.issue.tasksEmpty"),
-        path: formatPath(cwd, path12.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path13.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists) {
-      const tasksPath = path12.join(f.path, "tasks.md");
+      const tasksPath = path13.join(f.path, "tasks.md");
       const tasksContent = await fs.readFile(tasksPath, "utf-8");
       const unknownPrdTags = [...new Set(
         parseTaskLines(tasksContent).flatMap((task) => task.tags).filter((tag) => isPrdRequirementId(tag)).map((tag) => tag.trim().toUpperCase()).filter((tag) => !prdDefinitions.has(tag))
@@ -10813,7 +11284,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_doc_status_missing",
         message: tr(config.lang, "cli", "doctor.issue.tasksDocStatusMissing"),
-        path: formatPath(cwd, path12.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path13.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && f.docs.tasksDocStatusFieldExists && !f.tasksDocStatus && !isInitialTemplateState) {
@@ -10821,7 +11292,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_doc_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.tasksDocStatusUnset"),
-        path: formatPath(cwd, path12.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path13.join(f.path, "tasks.md"))
       });
     }
   }
@@ -10845,7 +11316,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
       level: "warn",
       code: "missing_feature_id",
       message: tr(config.lang, "cli", "doctor.issue.missingFeatureId"),
-      path: formatPath(cwd, path12.join(config.docsDir, p))
+      path: formatPath(cwd, path13.join(config.docsDir, p))
     });
   }
   return issues;
@@ -10975,25 +11446,25 @@ function doctorCommand(program2) {
         return;
       }
       console.log();
-      console.log(chalk8.bold(tr(lang, "cli", "doctor.title")));
-      console.log(chalk8.gray(`- Docs: ${path12.relative(cwd, docsDir)}`));
-      console.log(chalk8.gray(`- Type: ${projectType}`));
-      console.log(chalk8.gray(`- Lang: ${lang}`));
+      console.log(chalk9.bold(tr(lang, "cli", "doctor.title")));
+      console.log(chalk9.gray(`- Docs: ${path13.relative(cwd, docsDir)}`));
+      console.log(chalk9.gray(`- Type: ${projectType}`));
+      console.log(chalk9.gray(`- Lang: ${lang}`));
       console.log();
       if (warnings.length > 0) {
-        console.log(chalk8.yellow(tr(lang, "cli", "doctor.envWarnings")));
-        warnings.forEach((w) => console.log(chalk8.yellow(`  - ${w}`)));
+        console.log(chalk9.yellow(tr(lang, "cli", "doctor.envWarnings")));
+        warnings.forEach((w) => console.log(chalk9.yellow(`  - ${w}`)));
         console.log();
       }
       if (fixResult) {
         const label = fixResult.dryRun ? "\u{1F9EA} Doctor Fix (dry-run)" : "\u{1F6E0}\uFE0F  Doctor Fix";
         console.log(
-          chalk8.blue(`${label}: ${fixResult.changedFiles} file(s)`)
+          chalk9.blue(`${label}: ${fixResult.changedFiles} file(s)`)
         );
         if (fixResult.changedFiles > 0) {
           fixResult.entries.forEach(
             (entry) => console.log(
-              chalk8.gray(`  - ${entry.path}: ${entry.changes.join(", ")}`)
+              chalk9.gray(`  - ${entry.path}: ${entry.changes.join(", ")}`)
             )
           );
         }
@@ -11003,51 +11474,51 @@ function doctorCommand(program2) {
       const warns = issues.filter((i) => i.level === "warn");
       const infos = issues.filter((i) => i.level === "info");
       if (!hasIssues && infos.length === 0) {
-        console.log(chalk8.green(tr(lang, "cli", "doctor.noIssues")));
+        console.log(chalk9.green(tr(lang, "cli", "doctor.noIssues")));
         console.log();
         return;
       }
       if (!hasIssues && infos.length > 0) {
-        console.log(chalk8.green(tr(lang, "cli", "doctor.noIssues")));
+        console.log(chalk9.green(tr(lang, "cli", "doctor.noIssues")));
         console.log();
       }
       if (errors.length > 0) {
         console.log(
-          chalk8.red(
+          chalk9.red(
             `\u274C ${tr(lang, "cli", "doctor.errorsTitle")} (${errors.length})`
           )
         );
         errors.forEach(
           (i) => console.log(
-            chalk8.red(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
+            chalk9.red(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
           )
         );
         console.log();
       }
       if (warns.length > 0) {
         console.log(
-          chalk8.yellow(
+          chalk9.yellow(
             `\u26A0\uFE0F  ${tr(lang, "cli", "doctor.warningsTitle")} (${warns.length})`
           )
         );
         warns.forEach(
           (i) => console.log(
-            chalk8.yellow(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
+            chalk9.yellow(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
           )
         );
         console.log();
       }
       if (infos.length > 0) {
-        console.log(chalk8.blue(`\u2139\uFE0F  Info (${infos.length})`));
+        console.log(chalk9.blue(`\u2139\uFE0F  Info (${infos.length})`));
         infos.forEach(
           (i) => console.log(
-            chalk8.blue(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
+            chalk9.blue(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
           )
         );
         console.log();
       }
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           tr(lang, "cli", "doctor.tipJson", {
             strictFlag: options.strict ? " --strict" : ""
           })
@@ -11076,8 +11547,8 @@ function doctorCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -11106,8 +11577,8 @@ function viewCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -11156,49 +11627,49 @@ async function runView(featureName, options) {
     return;
   }
   console.log();
-  console.log(chalk8.bold("\u{1F4CA} Workflow View"));
-  console.log(chalk8.gray(`- Docs: ${path12.relative(cwd, config.docsDir)}`));
+  console.log(chalk9.bold("\u{1F4CA} Workflow View"));
+  console.log(chalk9.gray(`- Docs: ${path13.relative(cwd, config.docsDir)}`));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- Features: ${state.features.length} (open ${state.openFeatures.length} / done ${state.doneFeatures.length})`
     )
   );
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- In Progress: ${state.inProgressFeatures.length}, Ready To Close: ${state.readyToCloseFeatures.length}`
     )
   );
   if (state.warnings.length > 0) {
     console.log();
-    console.log(chalk8.yellow("\u26A0\uFE0F  Environment warnings:"));
+    console.log(chalk9.yellow("\u26A0\uFE0F  Environment warnings:"));
     for (const warning of state.warnings) {
-      console.log(chalk8.yellow(`  - ${warning}`));
+      console.log(chalk9.yellow(`  - ${warning}`));
     }
   }
   if (state.features.length === 0) {
     console.log();
-    console.log(chalk8.yellow("No features found."));
-    console.log(chalk8.gray("Try: npx lee-spec-kit feature <name>"));
+    console.log(chalk9.yellow("No features found."));
+    console.log(chalk9.gray("Try: npx lee-spec-kit feature <name>"));
     console.log();
     return;
   }
   if (!state.matchedFeature) {
     console.log();
     console.log(
-      chalk8.blue(`Selection: ${state.status} (${toReasonCode(state.status)})`)
+      chalk9.blue(`Selection: ${state.status} (${toReasonCode(state.status)})`)
     );
     const rows = state.targetFeatures.length > 0 ? state.targetFeatures : state.features;
     for (const f2 of rows) {
-      const statusText = f2.completion.workflowDone ? chalk8.green("WORKFLOW_DONE") : f2.completion.implementationDone ? chalk8.cyan("DONE") : chalk8.yellow("IN_PROGRESS");
+      const statusText = f2.completion.workflowDone ? chalk9.green("WORKFLOW_DONE") : f2.completion.implementationDone ? chalk9.cyan("DONE") : chalk9.yellow("IN_PROGRESS");
       const substateText = f2.currentSubstateId ? `${f2.currentSubstateId} (${f2.currentSubstateOwner ?? "-"} / ${f2.currentSubstatePhase ?? "-"})` : "-";
       console.log(
         `- ${f2.folderName} (${f2.tasks.done}/${f2.tasks.total}) ${statusText} step:${f2.currentStep} substate:${substateText}`
       );
-      console.log(chalk8.gray(`  next: ${f2.nextAction}`));
+      console.log(chalk9.gray(`  next: ${f2.nextAction}`));
     }
     console.log();
     const selectorTip = config.projectType === "multi" ? selectedComponent ? `Tip: npx lee-spec-kit view <slug|F001|F001-slug> --component ${selectedComponent}` : "Tip: npx lee-spec-kit view <slug|F001|F001-slug> [--component <component>]" : "Tip: npx lee-spec-kit view <slug|F001|F001-slug>";
-    console.log(chalk8.gray(selectorTip));
+    console.log(chalk9.gray(selectorTip));
     console.log();
     return;
   }
@@ -11206,7 +11677,7 @@ async function runView(featureName, options) {
   const completion = `${f.tasks.done}/${f.tasks.total}`;
   const stateLabel = f.completion.workflowDone ? "WORKFLOW_DONE" : f.completion.implementationDone ? "DONE" : "IN_PROGRESS";
   console.log();
-  console.log(chalk8.blue(`Feature: ${chalk8.bold(f.folderName)}`));
+  console.log(chalk9.blue(`Feature: ${chalk9.bold(f.folderName)}`));
   console.log(`- State: ${stateLabel}`);
   console.log(`- Progress: ${completion}`);
   console.log(`- Step: ${f.currentStep}`);
@@ -11217,14 +11688,14 @@ async function runView(featureName, options) {
   console.log(`- Next: ${nextSummary}`);
   if (state.actionOptions.length > 0) {
     console.log();
-    console.log(chalk8.green("Atomic options:"));
+    console.log(chalk9.green("Atomic options:"));
     for (const option of state.actionOptions) {
       const lang = config.lang ?? DEFAULT_LANG;
       const requiresCheck = option.action.requiresUserCheck ? tr(lang, "cli", "context.checkRequired") : "";
       console.log(`  ${option.label}. ${requiresCheck}${option.detail}`);
     }
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `Approve with: npx lee-spec-kit context ${f.folderName} --approve <LABEL>`
       )
     );
@@ -11242,13 +11713,13 @@ function normalizeRunId(raw) {
   return value;
 }
 function getFlowRunBaseDir(cwd) {
-  return path12.join(getRuntimeStateDir(cwd), "flow-runs");
+  return path13.join(getRuntimeStateDir(cwd), "flow-runs");
 }
 function getFlowRunPath(cwd, runId) {
-  return path12.join(getFlowRunBaseDir(cwd), `${runId}.json`);
+  return path13.join(getFlowRunBaseDir(cwd), `${runId}.json`);
 }
 function getFlowRunLockPath(cwd, runId) {
-  return path12.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
+  return path13.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
 }
 async function readFlowRunRecordUnsafe(cwd, runId) {
   const normalized = normalizeRunId(runId);
@@ -11274,7 +11745,7 @@ async function readFlowRunRecordUnsafe(cwd, runId) {
 }
 async function writeFlowRunRecord(cwd, record) {
   const filePath = getFlowRunPath(cwd, record.runId);
-  await fs.ensureDir(path12.dirname(filePath));
+  await fs.ensureDir(path13.dirname(filePath));
   await fs.writeJson(filePath, record, { spaces: 2 });
 }
 async function createFlowRunRecord(cwd, input) {
@@ -11403,6 +11874,7 @@ function toCompactFlowContextSnapshot(state) {
     actionOptions: state.actionOptions.map(
       (option) => toCompactFlowActionOption(option)
     ),
+    delegatedAction: buildDelegatedActionContract(state),
     primaryActionLabel: primaryAction?.label ?? null,
     primaryActionType: primaryAction?.action.type ?? null,
     primaryActionCategory: primaryAction?.action.category ?? null,
@@ -12068,8 +12540,8 @@ function flowCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -12388,16 +12860,16 @@ async function runFlow(featureName, options) {
     return;
   }
   console.log();
-  console.log(chalk8.bold("\u{1F501} Flow Summary"));
+  console.log(chalk9.bold("\u{1F501} Flow Summary"));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- Before: ${before.status} (${toReasonCode(before.status)}) / After: ${after.status} (${toReasonCode(after.status)})`
     )
   );
   if (approvalResult && typeof approvalResult === "object") {
     const result = approvalResult;
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `- Approval: ${result.status ?? "unknown"} (${result.reasonCode ?? "-"})`
       )
     );
@@ -12405,18 +12877,18 @@ async function runFlow(featureName, options) {
   if (autoRun) {
     const presetSuffix = autoRun.preset ? `, preset ${autoRun.preset}` : "";
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `- Auto: ${autoRun.status} (${autoRun.reasonCode}), iterations ${autoRun.iterations}, executions ${autoRun.executions.length}${presetSuffix}`
       )
     );
-    console.log(chalk8.gray(`- Auto resume: ${autoRun.resume.flowCommand}`));
+    console.log(chalk9.gray(`- Auto resume: ${autoRun.resume.flowCommand}`));
     if (autoRun.run) {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `- Auto run: ${autoRun.run.mode} ${autoRun.run.runId} (${autoRun.run.status})`
         )
       );
-      console.log(chalk8.gray(`- Resume with: ${autoRun.run.resumeCommand}`));
+      console.log(chalk9.gray(`- Resume with: ${autoRun.run.resumeCommand}`));
     }
   }
   const agentOrchestration = buildAgentOrchestrationPolicy2(
@@ -12424,21 +12896,21 @@ async function runFlow(featureName, options) {
     resolvedFeatureName || null
   );
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- Orchestration: ${agentOrchestration.mode}, prefer substate-owner delegation and fall back to legacy long-running categories`
     )
   );
   const statusCounts = statusReport.counts;
   const doctorCounts = doctorReport.counts;
-  console.log(chalk8.gray(`- Status features: ${statusCounts?.features ?? 0}`));
+  console.log(chalk9.gray(`- Status features: ${statusCounts?.features ?? 0}`));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- Doctor issues: ${doctorCounts?.issues ?? 0} (errors ${doctorCounts?.errors ?? 0}, warnings ${doctorCounts?.warnings ?? 0})`
     )
   );
   if (strictChecks) {
-    const strictLabel = strictChecks.statusStrictOk && strictChecks.doctorStrictOk ? chalk8.green("PASS") : chalk8.red("FAIL");
-    console.log(chalk8.gray(`- Strict checks: ${strictLabel}`));
+    const strictLabel = strictChecks.statusStrictOk && strictChecks.doctorStrictOk ? chalk9.green("PASS") : chalk9.red("FAIL");
+    console.log(chalk9.gray(`- Strict checks: ${strictLabel}`));
   }
   console.log();
   if (autoRun?.status === "gate_reached" && autoRun.gate?.userFacingLines?.length) {
@@ -12446,7 +12918,7 @@ async function runFlow(featureName, options) {
       console.log(line);
     }
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         "Auto gate reached. Reply with one of the labels shown above (example: A OK)."
       )
     );
@@ -12457,15 +12929,15 @@ async function runFlow(featureName, options) {
   }
   if (after.matchedFeature) {
     console.log(
-      chalk8.blue(
+      chalk9.blue(
         `Next: npx lee-spec-kit context ${after.matchedFeature.folderName}${componentHint}`
       )
     );
   } else {
-    console.log(chalk8.blue(`Next: npx lee-spec-kit context${componentHint}`));
+    console.log(chalk9.blue(`Next: npx lee-spec-kit context${componentHint}`));
   }
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       "Tip: add --approve <LABEL> [--execute] to run the selected atomic action."
     )
   );
@@ -12584,27 +13056,27 @@ function tg(lang, key, vars = {}) {
 function detectGithubCliLangSync(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const startDirs = [
-    explicitDocsDir ? path12.resolve(explicitDocsDir) : "",
-    path12.resolve(cwd)
+    explicitDocsDir ? path13.resolve(explicitDocsDir) : "",
+    path13.resolve(cwd)
   ].filter(Boolean);
   const scanOrder = [];
   const seen = /* @__PURE__ */ new Set();
   for (const start of startDirs) {
     let current = start;
     while (true) {
-      const abs = path12.resolve(current);
+      const abs = path13.resolve(current);
       if (!seen.has(abs)) {
         scanOrder.push(abs);
         seen.add(abs);
       }
-      const parent = path12.dirname(abs);
+      const parent = path13.dirname(abs);
       if (parent === abs) break;
       current = parent;
     }
   }
   for (const base of scanOrder) {
-    for (const docsDir of [path12.join(base, "docs"), base]) {
-      const configPath = path12.join(docsDir, ".lee-spec-kit.json");
+    for (const docsDir of [path13.join(base, "docs"), base]) {
+      const configPath = path13.join(docsDir, ".lee-spec-kit.json");
       if (fs.existsSync(configPath)) {
         try {
           const parsed = fs.readJsonSync(configPath);
@@ -12613,11 +13085,11 @@ function detectGithubCliLangSync(cwd) {
         } catch {
         }
       }
-      const agentsPath = path12.join(docsDir, "agents");
-      const featuresPath = path12.join(docsDir, "features");
+      const agentsPath = path13.join(docsDir, "agents");
+      const featuresPath = path13.join(docsDir, "features");
       if (!fs.existsSync(agentsPath) || !fs.existsSync(featuresPath)) continue;
       for (const probe of ["custom.md", "constitution.md", "agents.md"]) {
-        const file = path12.join(agentsPath, probe);
+        const file = path13.join(agentsPath, probe);
         if (!fs.existsSync(file)) continue;
         try {
           const content = fs.readFileSync(file, "utf-8");
@@ -12637,13 +13109,13 @@ function parseLabels(raw, lang) {
   }
   return [...new Set(labels)];
 }
-function escapeRegExp3(value) {
+function escapeRegExp4(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractDraftMetadataValue(content, keys) {
   for (const key of keys) {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp3(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp4(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
       "mi"
     );
     const match = content.match(re);
@@ -12722,7 +13194,7 @@ async function prepareGithubBody(params) {
       };
     }
   }
-  await fs.ensureDir(path12.dirname(defaultBodyFile));
+  await fs.ensureDir(path13.dirname(defaultBodyFile));
   await fs.writeFile(defaultBodyFile, generatedBody, "utf-8");
   return {
     body: generatedBody,
@@ -12762,7 +13234,7 @@ function ensureSections(body, sections, kind, lang) {
   };
   const hasMetadataField = (field) => {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp3(field)}\\*\\*\\s*:`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp4(field)}\\*\\*\\s*:`,
       "m"
     );
     return re.test(body);
@@ -12792,7 +13264,7 @@ function ensureSections(body, sections, kind, lang) {
 }
 function ensureDocsExist(docsDir, relativePaths, lang) {
   const missing = relativePaths.filter(
-    (relativePath) => !fs.existsSync(path12.join(docsDir, relativePath))
+    (relativePath) => !fs.existsSync(path13.join(docsDir, relativePath))
   );
   if (missing.length > 0) {
     throw createCliError(
@@ -12802,18 +13274,18 @@ function ensureDocsExist(docsDir, relativePaths, lang) {
   }
 }
 function buildDefaultBodyFileName(kind, docsDir, component) {
-  const key = `${path12.resolve(docsDir)}::${component.trim().toLowerCase()}`;
+  const key = `${path13.resolve(docsDir)}::${component.trim().toLowerCase()}`;
   const digest = createHash("sha1").update(key).digest("hex").slice(0, 12);
   return `lee-spec-kit.${digest}.${kind}.md`;
 }
 function toBodyFilePath(raw, kind, docsDir, component, lang) {
-  const selected = raw?.trim() || path12.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
+  const selected = raw?.trim() || path13.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
   assertValid(
     validatePathWithLang(selected, lang),
     `github.${kind}.bodyFile`,
     lang
   );
-  return path12.resolve(selected);
+  return path13.resolve(selected);
 }
 function toProjectRootDocsPath(relativePathFromDocs) {
   const normalized = relativePathFromDocs.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
@@ -13650,7 +14122,7 @@ function stripMarkdownCodeContexts(body) {
 function hasIssueClosingKeyword(body, issueNumber) {
   if (!issueNumber) return false;
   const cleaned = stripMarkdownCodeContexts(body);
-  const issue = escapeRegExp3(issueNumber);
+  const issue = escapeRegExp4(issueNumber);
   const closeKeywordRegex = new RegExp(
     `\\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\\b\\s*(?:[a-zA-Z0-9_.-]+\\/)?#\\s*${issue}\\b`,
     "i"
@@ -13868,7 +14340,7 @@ function ensureCleanWorktree(cwd, lang) {
 function commitAndPushPaths(cwd, absPaths, message, lang, options) {
   const uniqueRelativePaths = [
     ...new Set(
-      absPaths.filter((absPath) => !!absPath && fs.existsSync(absPath)).map((absPath) => path12.relative(cwd, absPath) || absPath)
+      absPaths.filter((absPath) => !!absPath && fs.existsSync(absPath)).map((absPath) => path13.relative(cwd, absPath) || absPath)
     )
   ];
   if (uniqueRelativePaths.length === 0) return;
@@ -14064,15 +14536,15 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path12.join(config.docsDir, paths.specPath),
+          path13.join(config.docsDir, paths.specPath),
           "utf-8"
         );
         const planContent = await fs.readFile(
-          path12.join(config.docsDir, paths.planPath),
+          path13.join(config.docsDir, paths.planPath),
           "utf-8"
         );
         const tasksContent = await fs.readFile(
-          path12.join(config.docsDir, paths.tasksPath),
+          path13.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -14115,7 +14587,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path12.join(config.docsDir, paths.issuePath),
+          workflowDraftPath: path13.join(config.docsDir, paths.issuePath),
           generatedBody,
           requiredSections: getRequiredIssueSections(config.lang),
           kindLabel: tg(config.lang, "kindIssue"),
@@ -14131,7 +14603,7 @@ function githubCommand(program2) {
             `${feature.type}-issue-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path12.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path13.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -14180,12 +14652,12 @@ function githubCommand(program2) {
           const syncedIssueNumber = extractIssueNumberFromUrl(issueUrl);
           if (syncedIssueNumber) {
             const synced = syncTasksIssueMetadata(
-              path12.join(config.docsDir, paths.tasksPath),
+              path13.join(config.docsDir, paths.tasksPath),
               syncedIssueNumber,
               config.lang
             );
             const draftSynced = syncIssueDraftMetadata(
-              path12.join(config.docsDir, paths.issuePath),
+              path13.join(config.docsDir, paths.issuePath),
               syncedIssueNumber
             );
             syncChanged = synced.changed || draftSynced.changed;
@@ -14213,31 +14685,31 @@ function githubCommand(program2) {
           return;
         }
         console.log();
-        console.log(chalk8.bold(tg(config.lang, "issueHeader")));
+        console.log(chalk9.bold(tg(config.lang, "issueHeader")));
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelFeature")}: ${feature.folderName}`
           )
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelBodyFile")}: ${bodyFile}`
           )
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelLabels")}: ${labels.join(", ")}`
           )
         );
         if (issueUrl) {
           console.log(
-            chalk8.green(
+            chalk9.green(
               tg(config.lang, "issueCreated", { url: issueUrl })
             )
           );
         } else {
           console.log(
-            chalk8.blue(tg(config.lang, "issueTemplateGenerated"))
+            chalk9.blue(tg(config.lang, "issueTemplateGenerated"))
           );
         }
         console.log();
@@ -14256,8 +14728,8 @@ function githubCommand(program2) {
           );
         } else {
           console.error(
-            chalk8.red(tr(lang, "cli", "common.errorLabel")),
-            chalk8.red(`[${cliError.code}] ${cliError.message}`)
+            chalk9.red(tr(lang, "cli", "common.errorLabel")),
+            chalk9.red(`[${cliError.code}] ${cliError.message}`)
           );
           printCliErrorSuggestions(suggestions, lang);
         }
@@ -14296,13 +14768,13 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path12.join(config.docsDir, paths.specPath),
+          path13.join(config.docsDir, paths.specPath),
           "utf-8"
         );
-        const planPath = path12.join(config.docsDir, paths.planPath);
+        const planPath = path13.join(config.docsDir, paths.planPath);
         const planContent = await fs.pathExists(planPath) ? await fs.readFile(planPath, "utf-8") : "";
         const tasksContent = await fs.readFile(
-          path12.join(config.docsDir, paths.tasksPath),
+          path13.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -14350,7 +14822,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path12.join(config.docsDir, paths.prPath),
+          workflowDraftPath: path13.join(config.docsDir, paths.prPath),
           generatedBody,
           requiredSections: getRequiredPrSections(config.lang),
           kindLabel: tg(config.lang, "kindPr"),
@@ -14368,7 +14840,7 @@ function githubCommand(program2) {
             `${feature.type}-pr-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path12.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path13.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -14396,7 +14868,7 @@ function githubCommand(program2) {
             if (preparedBody.source === "generated") {
               await fs.writeFile(bodyFile, body, "utf-8");
             } else {
-              await fs.ensureDir(path12.dirname(fallbackBodyFile));
+              await fs.ensureDir(path13.dirname(fallbackBodyFile));
               await fs.writeFile(fallbackBodyFile, body, "utf-8");
               bodyFile = fallbackBodyFile;
             }
@@ -14457,13 +14929,13 @@ function githubCommand(program2) {
         }
         if (prUrl && options.syncTasks !== false) {
           const syncedTasks = syncTasksPrMetadata(
-            path12.join(config.docsDir, paths.tasksPath),
+            path13.join(config.docsDir, paths.tasksPath),
             prUrl,
             "Review",
             config.lang
           );
           const syncedDraft = syncPrDraftMetadata(
-            path12.join(config.docsDir, paths.prPath),
+            path13.join(config.docsDir, paths.prPath),
             prUrl,
             "Review"
           );
@@ -14504,13 +14976,13 @@ function githubCommand(program2) {
           mergeAlreadyMerged = merged.alreadyMerged;
           if (prUrl && options.syncTasks !== false) {
             const mergedTasksSync = syncTasksPrMetadata(
-              path12.join(config.docsDir, paths.tasksPath),
+              path13.join(config.docsDir, paths.tasksPath),
               prUrl,
               "Approved",
               config.lang
             );
             const mergedDraftSync = syncPrDraftMetadata(
-              path12.join(config.docsDir, paths.prPath),
+              path13.join(config.docsDir, paths.prPath),
               prUrl,
               "Approved"
             );
@@ -14594,35 +15066,35 @@ function githubCommand(program2) {
           return;
         }
         console.log();
-        console.log(chalk8.bold(tg(config.lang, "prHeader")));
+        console.log(chalk9.bold(tg(config.lang, "prHeader")));
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelFeature")}: ${feature.folderName}`
           )
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelBodyFile")}: ${bodyFile}`
           )
         );
         console.log(
-          chalk8.gray(
+          chalk9.gray(
             `- ${tg(config.lang, "labelLabels")}: ${labels.join(", ")}`
           )
         );
         if (prUrl) {
           console.log(
-            chalk8.gray(`- ${tg(config.lang, "labelPr")}: ${prUrl}`)
+            chalk9.gray(`- ${tg(config.lang, "labelPr")}: ${prUrl}`)
           );
         }
         if (syncChanged) {
           console.log(
-            chalk8.green(tg(config.lang, "prTasksSynced"))
+            chalk9.green(tg(config.lang, "prTasksSynced"))
           );
         }
         if (options.merge) {
           console.log(
-            chalk8.green(
+            chalk9.green(
               tg(config.lang, "prMerged", {
                 attempts: mergedAttempts ?? 1
               })
@@ -14630,15 +15102,15 @@ function githubCommand(program2) {
           );
           if (mergeAlreadyMerged) {
             console.log(
-              chalk8.yellow(tg(config.lang, "prAlreadyMergedNotice"))
+              chalk9.yellow(tg(config.lang, "prAlreadyMergedNotice"))
             );
           }
           for (const warning of postMergeWarnings) {
-            console.log(chalk8.yellow(`\u26A0\uFE0F  ${warning}`));
+            console.log(chalk9.yellow(`\u26A0\uFE0F  ${warning}`));
           }
         } else if (!options.create) {
           console.log(
-            chalk8.blue(tg(config.lang, "prTemplateGenerated"))
+            chalk9.blue(tg(config.lang, "prTemplateGenerated"))
           );
         }
         console.log();
@@ -14657,8 +15129,8 @@ function githubCommand(program2) {
           );
         } else {
           console.error(
-            chalk8.red(tr(lang, "cli", "common.errorLabel")),
-            chalk8.red(`[${cliError.code}] ${cliError.message}`)
+            chalk9.red(tr(lang, "cli", "common.errorLabel")),
+            chalk9.red(`[${cliError.code}] ${cliError.message}`)
           );
           printCliErrorSuggestions(suggestions, lang);
         }
@@ -14716,10 +15188,10 @@ function docsCommand(program2) {
         return;
       }
       console.log();
-      console.log(chalk8.bold(tr(config.lang, "cli", "docs.listHeader")));
+      console.log(chalk9.bold(tr(config.lang, "cli", "docs.listHeader")));
       for (const doc of docsList) {
         console.log(`- ${doc.id}: ${doc.title}`);
-        console.log(chalk8.gray(`  ${doc.command}`));
+        console.log(chalk9.gray(`  ${doc.command}`));
       }
       console.log();
     } catch (error) {
@@ -14738,8 +15210,8 @@ function docsCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -14781,25 +15253,25 @@ function docsCommand(program2) {
         );
         return;
       }
-      const relativeFromCwd = path12.relative(process.cwd(), loaded.entry.absolutePath);
+      const relativeFromCwd = path13.relative(process.cwd(), loaded.entry.absolutePath);
       console.log();
-      console.log(chalk8.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
+      console.log(chalk9.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `${tr(config.lang, "cli", "docs.sourceLabel")}: ${relativeFromCwd || loaded.entry.absolutePath}`
         )
       );
       console.log(
-        chalk8.gray(`${tr(config.lang, "cli", "docs.hashLabel")}: ${loaded.hash}`)
+        chalk9.gray(`${tr(config.lang, "cli", "docs.hashLabel")}: ${loaded.hash}`)
       );
       console.log();
       process.stdout.write(loaded.content.endsWith("\n") ? loaded.content : `${loaded.content}
 `);
       if (followups.length > 0) {
         console.log();
-        console.log(chalk8.blue(`${tr(config.lang, "cli", "docs.nextDocs")}:`));
+        console.log(chalk9.blue(`${tr(config.lang, "cli", "docs.nextDocs")}:`));
         for (const followup of followups) {
-          console.log(chalk8.gray(`- ${followup.command}`));
+          console.log(chalk9.gray(`- ${followup.command}`));
         }
         console.log();
       }
@@ -14819,8 +15291,8 @@ function docsCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -14849,8 +15321,8 @@ function detectCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -14861,7 +15333,7 @@ function detectCommand(program2) {
 }
 async function runDetect(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path12.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path13.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   const detected = !!config;
   const reasonCode = detected ? "PROJECT_DETECTED" : "PROJECT_NOT_DETECTED";
@@ -14888,7 +15360,7 @@ async function runDetect(options) {
       );
       return;
     }
-    const configPath2 = path12.join(config.docsDir, ".lee-spec-kit.json");
+    const configPath2 = path13.join(config.docsDir, ".lee-spec-kit.json");
     const configFilePresent2 = await fs.pathExists(configPath2);
     const detectionSource2 = configFilePresent2 ? "config" : "heuristic";
     console.log(
@@ -14914,26 +15386,26 @@ async function runDetect(options) {
   }
   const lang = config?.lang ?? DEFAULT_LANG;
   console.log();
-  console.log(chalk8.blue(tr(lang, "cli", "detect.header")));
-  console.log(chalk8.gray(`- ${tr(lang, "cli", "detect.labelTarget")}: ${targetCwd}`));
+  console.log(chalk9.blue(tr(lang, "cli", "detect.header")));
+  console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.labelTarget")}: ${targetCwd}`));
   if (!config) {
-    console.log(chalk8.yellow(`- ${tr(lang, "cli", "detect.resultNotDetected")}`));
-    console.log(chalk8.gray(`- ${tr(lang, "cli", "detect.notDetectedHint")}`));
+    console.log(chalk9.yellow(`- ${tr(lang, "cli", "detect.resultNotDetected")}`));
+    console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.notDetectedHint")}`));
     console.log();
     return;
   }
-  const configPath = path12.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
   const configFilePresent = await fs.pathExists(configPath);
   const detectionSource = configFilePresent ? "config" : "heuristic";
-  console.log(chalk8.green(`- ${tr(lang, "cli", "detect.resultDetected")}`));
-  console.log(chalk8.gray(`- ${tr(lang, "cli", "detect.labelDocsDir")}: ${config.docsDir}`));
+  console.log(chalk9.green(`- ${tr(lang, "cli", "detect.resultDetected")}`));
+  console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.labelDocsDir")}: ${config.docsDir}`));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- ${tr(lang, "cli", "detect.labelConfigPath")}: ${configFilePresent ? configPath : "-"}`
     )
   );
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- ${tr(lang, "cli", "detect.labelSource")}: ${tr(
         lang,
         "cli",
@@ -14942,14 +15414,14 @@ async function runDetect(options) {
     )
   );
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- ${tr(lang, "cli", "detect.labelProjectType")}: ${config.projectType}`
     )
   );
-  console.log(chalk8.gray(`- ${tr(lang, "cli", "detect.labelLang")}: ${config.lang}`));
+  console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.labelLang")}: ${config.lang}`));
   if (config.projectName) {
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         `- ${tr(lang, "cli", "detect.labelProjectName")}: ${config.projectName}`
       )
     );
@@ -14999,19 +15471,19 @@ function hasTemplateMarkers(content) {
   return patterns.some((pattern) => pattern.test(content));
 }
 async function countFeatureDirs(ctx, docsDir, projectType) {
-  const featuresRoot = path12.join(docsDir, "features");
+  const featuresRoot = path13.join(docsDir, "features");
   if (projectType === "single") {
     const dirs = await listSubdirectories(ctx.fs, featuresRoot);
-    return dirs.filter((value) => path12.basename(value) !== "feature-base").length;
+    return dirs.filter((value) => path13.basename(value) !== "feature-base").length;
   }
   const components = await listSubdirectories(ctx.fs, featuresRoot);
   let total = 0;
   for (const componentDir of components) {
-    const componentName = path12.basename(componentDir).trim().toLowerCase();
+    const componentName = path13.basename(componentDir).trim().toLowerCase();
     if (!componentName || componentName === "feature-base") continue;
     const dirs = await listSubdirectories(ctx.fs, componentDir);
     total += dirs.filter(
-      (value) => path12.basename(value) !== "feature-base"
+      (value) => path13.basename(value) !== "feature-base"
     ).length;
   }
   return total;
@@ -15023,7 +15495,7 @@ async function hasUserPrdFile(ctx, prdDir) {
     ignoreDirs: ["node_modules"]
   });
   return files.some(
-    (absolutePath) => path12.basename(absolutePath).toLowerCase() !== "readme.md"
+    (absolutePath) => path13.basename(absolutePath).toLowerCase() !== "readme.md"
   );
 }
 function finalizeChecks(checks) {
@@ -15040,17 +15512,17 @@ function finalizeChecks(checks) {
 function printOnboardResult(lang, result) {
   console.log();
   console.log(
-    chalk8.bold(t(lang, "\u{1F9ED} Onboarding \uC810\uAC80", "\u{1F9ED} Onboarding Checks"))
+    chalk9.bold(t(lang, "\u{1F9ED} Onboarding \uC810\uAC80", "\u{1F9ED} Onboarding Checks"))
   );
   for (const check of result.checks) {
-    const mark = check.status === "ok" ? chalk8.green("\u2705") : check.status === "warn" ? chalk8.yellow("\u26A0\uFE0F") : chalk8.red("\u274C");
-    const level = check.status === "ok" ? chalk8.green("OK") : check.status === "warn" ? chalk8.yellow("WARN") : chalk8.red("BLOCK");
+    const mark = check.status === "ok" ? chalk9.green("\u2705") : check.status === "warn" ? chalk9.yellow("\u26A0\uFE0F") : chalk9.red("\u274C");
+    const level = check.status === "ok" ? chalk9.green("OK") : check.status === "warn" ? chalk9.yellow("WARN") : chalk9.red("BLOCK");
     console.log(`${mark} [${level}] ${check.title}`);
     console.log(`   ${check.message}`);
-    if (check.path) console.log(chalk8.gray(`   path: ${check.path}`));
+    if (check.path) console.log(chalk9.gray(`   path: ${check.path}`));
     if (check.suggestedCommand) {
       console.log(
-        chalk8.gray(
+        chalk9.gray(
           `   ${t(lang, "\uB2E4\uC74C \uBA85\uB839", "next")}: ${check.suggestedCommand}`
         )
       );
@@ -15058,7 +15530,7 @@ function printOnboardResult(lang, result) {
   }
   console.log();
   console.log(
-    chalk8.bold(
+    chalk9.bold(
       t(
         lang,
         `\uC694\uC57D: OK ${result.summary.ok}, WARN ${result.summary.warn}, BLOCK ${result.summary.block}`,
@@ -15068,13 +15540,13 @@ function printOnboardResult(lang, result) {
   );
   if (result.status === "ready") {
     console.log(
-      chalk8.green(
+      chalk9.green(
         t(lang, "\uC628\uBCF4\uB529 \uC900\uBE44\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "Onboarding checks passed.")
       )
     );
   } else if (result.status === "needs_action") {
     console.log(
-      chalk8.yellow(
+      chalk9.yellow(
         t(
           lang,
           "\uCD94\uAC00 \uC815\uB9AC\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
@@ -15084,7 +15556,7 @@ function printOnboardResult(lang, result) {
     );
   } else {
     console.log(
-      chalk8.red(
+      chalk9.red(
         t(
           lang,
           "\uC628\uBCF4\uB529 \uC120\uD589 \uC791\uC5C5\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.",
@@ -15192,7 +15664,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const constitutionPath = path12.join(docsDir, "agents", "constitution.md");
+  const constitutionPath = path13.join(docsDir, "agents", "constitution.md");
   if (!await fs.pathExists(constitutionPath)) {
     checks.push({
       id: "constitution_exists",
@@ -15234,7 +15706,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const customPath = path12.join(docsDir, "agents", "custom.md");
+  const customPath = path13.join(docsDir, "agents", "custom.md");
   if (await fs.pathExists(customPath)) {
     const content = await fs.readFile(customPath, "utf-8");
     if (hasTemplateMarkers(content)) {
@@ -15263,7 +15735,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const prdDir = path12.join(docsDir, "prd");
+  const prdDir = path13.join(docsDir, "prd");
   const featureCount = await countFeatureDirs(ctx, docsDir, config.projectType);
   const prdReady = await hasUserPrdFile(ctx, prdDir);
   if (!prdReady) {
@@ -15281,7 +15753,7 @@ async function runOnboardChecks(ctx) {
         "PRD is empty. If features already exist, fill PRD as soon as possible."
       ),
       path: prdDir,
-      suggestedCommand: `touch ${quotePath(path12.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
+      suggestedCommand: `touch ${quotePath(path13.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
     });
   } else {
     checks.push({
@@ -15422,8 +15894,8 @@ function onboardCommand(program2) {
         );
       } else {
         console.error(
-          chalk8.red(tr(lang, "cli", "common.errorLabel")),
-          chalk8.red(`[${cliError.code}] ${cliError.message}`)
+          chalk9.red(tr(lang, "cli", "common.errorLabel")),
+          chalk9.red(`[${cliError.code}] ${cliError.message}`)
         );
         printCliErrorSuggestions(suggestions, lang);
       }
@@ -15466,6 +15938,14 @@ function asNonEmptyString(value, fallback) {
   const trimmed = value.trim();
   return trimmed || fallback;
 }
+function asRequiredNonEmptyString(value, field) {
+  const normalized = asNonEmptyString(value, "");
+  if (normalized) return normalized;
+  throw createCliError(
+    "VALIDATION_FAILED",
+    `Evidence JSON ${field} is required.`
+  );
+}
 function asRequiredBoolean(value, field) {
   if (typeof value === "boolean") return value;
   throw createCliError(
@@ -15544,6 +16024,61 @@ function normalizeCommandsExecuted(value) {
     return entry.trim();
   });
 }
+function normalizeRequiredPathList(value, field) {
+  if (!Array.isArray(value)) {
+    throw createCliError(
+      "VALIDATION_FAILED",
+      `Evidence JSON ${field} must be a non-empty array of repo-relative paths.`
+    );
+  }
+  const out = value.map((entry, index) => {
+    if (typeof entry !== "string" || !entry.trim()) {
+      throw createCliError(
+        "VALIDATION_FAILED",
+        `Evidence JSON ${field}[${index}] must be a non-empty repo-relative path string.`
+      );
+    }
+    return normalizeGitPath3(entry);
+  }).filter(Boolean);
+  if (out.length === 0) {
+    throw createCliError(
+      "VALIDATION_FAILED",
+      `Evidence JSON ${field} must include at least one repo-relative path.`
+    );
+  }
+  return uniquePaths(out);
+}
+function normalizeRiskSummaries(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw createCliError(
+      "VALIDATION_FAILED",
+      'Evidence JSON "riskSummaries" is required and must include blocking, important, and minor fields.'
+    );
+  }
+  const riskSummaries = value;
+  return {
+    blocking: asRequiredReviewField(
+      riskSummaries.blocking,
+      '"riskSummaries.blocking"',
+      { allowExplicitNone: true }
+    ),
+    important: asRequiredReviewField(
+      riskSummaries.important,
+      '"riskSummaries.important"',
+      { allowExplicitNone: true }
+    ),
+    minor: asRequiredReviewField(
+      riskSummaries.minor,
+      '"riskSummaries.minor"',
+      { allowExplicitNone: true }
+    )
+  };
+}
+function formatMissingPathGuidance(field, missingFiles) {
+  return `Evidence JSON ${field} is missing these repo-relative paths:
+${missingFiles.map((file) => `- ${file}`).join("\n")}
+Use paths relative to the project git root, matching files.path entries.`;
+}
 function normalizeGitPath3(value) {
   return value.trim().replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/\/+$/, "");
 }
@@ -15656,7 +16191,7 @@ var PrePrReviewValidator = class {
     return result.evidence;
   }
   async validateEvidenceWithScope(evidencePath, projectRoot) {
-    const fullPath = path12.resolve(evidencePath);
+    const fullPath = path13.resolve(evidencePath);
     if (!await fs.pathExists(fullPath)) {
       throw createCliError(
         "INVALID_ARGUMENT",
@@ -15699,6 +16234,27 @@ var PrePrReviewValidator = class {
         evidence.blockingFindings,
         '"blockingFindings"'
       ),
+      baseSha: asRequiredNonEmptyString(evidence.baseSha, '"baseSha"'),
+      headSha: asRequiredNonEmptyString(evidence.headSha, '"headSha"'),
+      changedFiles: normalizeRequiredPathList(
+        evidence.changedFiles,
+        '"changedFiles"'
+      ),
+      reviewedFiles: normalizeRequiredPathList(
+        evidence.reviewedFiles,
+        '"reviewedFiles"'
+      ),
+      riskSummaries: normalizeRiskSummaries(evidence.riskSummaries),
+      approvalRationale: asRequiredReviewField(
+        evidence.approvalRationale,
+        '"approvalRationale"'
+      ),
+      coverage: {
+        changedFileCount: 0,
+        reviewedFileCount: 0,
+        reviewCoverageRatio: 0,
+        missingFiles: []
+      },
       files: normalizeEvidenceFiles(evidence.files),
       residualRisks: normalizeResidualRisks(evidence.residualRisks),
       commandsExecuted: normalizeCommandsExecuted(evidence.commandsExecuted)
@@ -15733,9 +16289,9 @@ var PrePrReviewValidator = class {
     ]);
     const reviewedFiles = new Set(
       normalizedEvidence.files.map(
-        (f) => path12.relative(
+        (f) => path13.relative(
           projectRoot,
-          path12.resolve(projectRoot, f.path)
+          path13.resolve(projectRoot, f.path)
         )
       ).map((entry) => normalizeGitPath3(entry)).filter(Boolean)
     );
@@ -15747,6 +16303,36 @@ var PrePrReviewValidator = class {
 ${missingFiles.map((f) => `- ${f}`).join("\n")}`
       );
     }
+    const changedFilesInEvidence = new Set(
+      normalizedEvidence.changedFiles.map((entry) => normalizeGitPath3(entry))
+    );
+    const missingChangedFiles = changedFiles.filter(
+      (file) => !changedFilesInEvidence.has(file)
+    );
+    if (missingChangedFiles.length > 0) {
+      throw createCliError(
+        "VALIDATION_FAILED",
+        formatMissingPathGuidance('"changedFiles"', missingChangedFiles)
+      );
+    }
+    const reviewedFilesInEvidence = new Set(
+      normalizedEvidence.reviewedFiles.map((entry) => normalizeGitPath3(entry))
+    );
+    const missingReviewedFiles = changedFiles.filter(
+      (file) => !reviewedFilesInEvidence.has(file)
+    );
+    if (missingReviewedFiles.length > 0) {
+      throw createCliError(
+        "VALIDATION_FAILED",
+        formatMissingPathGuidance('"reviewedFiles"', missingReviewedFiles)
+      );
+    }
+    normalizedEvidence.coverage = {
+      changedFileCount: changedFiles.length,
+      reviewedFileCount: normalizedEvidence.reviewedFiles.length,
+      reviewCoverageRatio: changedFiles.length === 0 ? 1 : normalizedEvidence.reviewedFiles.length / changedFiles.length,
+      missingFiles: missingReviewedFiles
+    };
     return {
       evidence: normalizedEvidence,
       scope
@@ -15881,11 +16467,27 @@ var DEFAULT_EVIDENCE_FOR_ANY_MODE = {
   specAlignmentChecked: true,
   findingCount: 0,
   blockingFindings: 0,
+  baseSha: "unrecorded",
+  headSha: "unrecorded",
+  changedFiles: [],
+  reviewedFiles: [],
+  riskSummaries: {
+    blocking: "none",
+    important: "manual direct record without structured evidence",
+    minor: "manual direct record without structured evidence"
+  },
+  approvalRationale: "manual direct record without structured evidence; not valid for approve",
+  coverage: {
+    changedFileCount: 0,
+    reviewedFileCount: 0,
+    reviewCoverageRatio: 0,
+    missingFiles: []
+  },
   files: [],
   residualRisks: ["none"],
   commandsExecuted: []
 };
-function escapeRegExp4(value) {
+function escapeRegExp5(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function normalizeDecision(raw) {
@@ -15899,14 +16501,14 @@ function normalizeDecision(raw) {
   return null;
 }
 function findSpecLineIndex(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp4(key));
+  const escaped = keys.map((key) => escapeRegExp5(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) => escapeRegExp4(key));
+  const escaped = keys.map((key) => escapeRegExp5(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -15996,11 +16598,28 @@ ${normalizedCommands.map((c) => `  - \`${c}\``).join("\n")}
 - **Spec Alignment Checked**: ${input.evidence.specAlignmentChecked ? "yes" : "no"}
 - **Finding Count**: ${input.evidence.findingCount}
 - **Blocking Findings**: ${input.evidence.blockingFindings}
+- **Base SHA**: ${input.evidence.baseSha}
+- **Head SHA**: ${input.evidence.headSha}
+- **Approval Rationale**: ${input.evidence.approvalRationale}
 ${commandsRun}
 
 - **Residual Risks**:
 ${residualRisksSection}
 
+- **Risk Summaries**:
+  - Blocking: ${input.evidence.riskSummaries.blocking}
+  - Important: ${input.evidence.riskSummaries.important}
+  - Minor: ${input.evidence.riskSummaries.minor}
+
+- **Evidence Coverage**:
+  - Changed File Count: ${input.evidence.coverage.changedFileCount}
+  - Reviewed File Count: ${input.evidence.coverage.reviewedFileCount}
+  - Review Coverage Ratio: ${input.evidence.coverage.reviewCoverageRatio.toFixed(2)}
+  - Reviewed Files:
+${input.evidence.reviewedFiles.length > 0 ? input.evidence.reviewedFiles.map((entry) => `    - ${entry}`).join("\n") : "    - (none)"}
+  - Evidence Changed Files:
+${input.evidence.changedFiles.length > 0 ? input.evidence.changedFiles.map((entry) => `    - ${entry}`).join("\n") : "    - (none)"}
+
 - **Review Scope**:
   - **Main Base Ref**: ${input.scope.baseRef}
   - **Main Merge Base**: ${input.scope.mergeBase ?? "unresolved"}
@@ -16054,7 +16673,7 @@ function prePrReviewCommand(program2) {
             })
           );
         } else {
-          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
           printCliErrorSuggestions(suggestions, lang);
         }
         process.exitCode = 1;
@@ -16066,7 +16685,7 @@ function prePrReviewCommand(program2) {
     "Decision outcome: approve | changes_requested | blocked"
   ).option("--note <text>", "Decision note text").option(
     "--evidence <path>",
-    "Optional review evidence path (for example review-trace.json); required only when policy demands it"
+    "Structured review evidence path (for example review-trace.json); required for approve and whenever policy demands it"
   ).option("--json", "Output JSON").action(
     async (featureName, options) => {
       try {
@@ -16086,7 +16705,7 @@ function prePrReviewCommand(program2) {
             })
           );
         } else {
-          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
           printCliErrorSuggestions(suggestions, lang);
         }
         process.exitCode = 1;
@@ -16133,7 +16752,7 @@ async function runPrePrReviewRun(featureName, options) {
   );
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
-  const tasksPath = path12.join(feature.path, "tasks.md");
+  const tasksPath = path13.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -16183,7 +16802,8 @@ async function runPrePrReviewRun(featureName, options) {
           suggestedParallelism: 1,
           fallbackToMainAgentWhenQuotaExceeded: true,
           nextStepRequirement: "generate_review_trace_then_record",
-          nextMainState: "pre_pr_review_running",
+          delegatedWorkRequired: true,
+          nextMainState: "pre_pr_review_in_progress",
           evidenceFile: "review-trace.json",
           tasksUpdated,
           tasksPath,
@@ -16202,24 +16822,27 @@ async function runPrePrReviewRun(featureName, options) {
   console.log(prompt);
   console.log();
   console.log(
-    chalk8.yellow(
-      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."
+    chalk9.yellow(
+      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 complete the review or advance workflow state by itself."
     )
   );
   console.log(
-    chalk8.gray(
+    chalk9.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(
+    chalk9.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(`Next main state: pre_pr_review_running`);
+  console.log(`Next main state: pre_pr_review_in_progress`);
   console.log(`Evidence file: review-trace.json`);
+  console.log(
+    config.lang === "ko" ? "Next required: delegated review\uB97C \uC774\uC5B4\uC11C \uC218\uD589\uD558\uACE0 \uAD6C\uC870\uD654\uB41C review-trace.json\uC744 \uB9CC\uB4E0 \uB4A4 pre-pr-review\uB85C \uAE30\uB85D" : "Next required: continue the delegated review, generate structured review-trace.json, then record the result with pre-pr-review"
+  );
   if (tasksUpdated) {
     console.log(`tasks.md updated: ${tasksPath}`);
     console.log(
@@ -16240,7 +16863,7 @@ async function runPrePrReview(featureName, options) {
       `tasks.md not found for feature: ${feature.folderName}`
     );
   }
-  const tasksPath = path12.join(feature.path, "tasks.md");
+  const tasksPath = path13.join(feature.path, "tasks.md");
   const tasksContent = await fs.readFile(tasksPath, "utf-8");
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
@@ -16273,6 +16896,12 @@ async function runPrePrReview(featureName, options) {
       "`--evidence <path>` is required when workflow.prePrReview.enforceExecutionEvidence=true."
     );
   }
+  if (decision === "approve" && !options.evidence) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--evidence <path>` is required for approve decisions. Generate structured review evidence first, for example `--evidence review-trace.json`."
+    );
+  }
   if (options.evidence) {
     const validator = new PrePrReviewValidator(ctx);
     const validationResult = await validator.validateEvidenceWithScope(
@@ -16332,7 +16961,7 @@ async function runPrePrReview(featureName, options) {
       }
     }
   }
-  const decisionsPath = path12.join(feature.path, "decisions.md");
+  const decisionsPath = path13.join(feature.path, "decisions.md");
   const decisionLogEntry = buildReportContent({
     folderName: feature.folderName,
     date,
@@ -16348,9 +16977,9 @@ async function runPrePrReview(featureName, options) {
     await fs.writeFile(decisionsPath, nextDecisions, "utf-8");
   }
   const decisionsPathFromDocs = normalizePathForDoc(
-    path12.join(feature.docs.featurePathFromDocs, "decisions.md")
+    path13.join(feature.docs.featurePathFromDocs, "decisions.md")
   );
-  const evidencePath = path12.basename(config.docsDir) === "docs" ? normalizePathForDoc(path12.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
+  const evidencePath = path13.basename(config.docsDir) === "docs" ? normalizePathForDoc(path13.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
   let nextTasks = tasksContent;
   nextTasks = upsertSpecLine(
     nextTasks,
@@ -16397,26 +17026,26 @@ async function runPrePrReview(featureName, options) {
     return;
   }
   console.log();
-  console.log(chalk8.green(`\u2705 pre-pr-review completed: ${feature.folderName}`));
-  console.log(chalk8.gray(`- Decision: ${decision}`));
-  console.log(chalk8.gray(`- Decisions log: ${decisionsPath}`));
+  console.log(chalk9.green(`\u2705 pre-pr-review completed: ${feature.folderName}`));
+  console.log(chalk9.gray(`- Decision: ${decision}`));
+  console.log(chalk9.gray(`- Decisions log: ${decisionsPath}`));
   if (nextTasks !== tasksContent) {
-    console.log(chalk8.gray(`- tasks.md updated: ${tasksPath}`));
+    console.log(chalk9.gray(`- tasks.md updated: ${tasksPath}`));
   }
   console.log();
 }
-function escapeRegExp5(value) {
+function escapeRegExp6(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function findSpecLineIndex2(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp5(key));
+  const escaped = keys.map((key) => escapeRegExp6(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) => escapeRegExp5(key));
+  const escaped = keys.map((key) => escapeRegExp6(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -16491,7 +17120,7 @@ async function runCodeReviewRun(featureName, options) {
     );
   }
   const feature = state.matchedFeature;
-  const tasksPath = path12.join(feature.path, "tasks.md");
+  const tasksPath = path13.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -16526,7 +17155,7 @@ async function runCodeReviewRun(featureName, options) {
     nextMainState: "code_review_running",
     tasksUpdated,
     tasksPath,
-    decisionsPath: path12.join(feature.path, "decisions.md"),
+    decisionsPath: path13.join(feature.path, "decisions.md"),
     prompt,
     recordedAt: getLocalDateString()
   };
@@ -16537,30 +17166,30 @@ async function runCodeReviewRun(featureName, options) {
   console.log(prompt);
   console.log();
   console.log(
-    chalk8.yellow(
+    chalk9.yellow(
       config.lang === "ko" ? "\uC774 \uBA85\uB839\uC740 PR \uB9AC\uBDF0 \uCF54\uBA58\uD2B8 \uB300\uC751\uC6A9 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. \uCF54\uBA58\uD2B8\uB97C \uC9C1\uC811 \uC77D\uC5B4\uC624\uAC70\uB098 evidence/decision\uC744 \uC790\uB3D9 \uAE30\uB85D\uD558\uC9C0 \uC54A\uC73C\uBA70, \uC0C1\uD0DC\uB3C4 \uBC14\uB85C \uB118\uAE30\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." : "This command only prepares a handoff for addressing PR review comments. It does not fetch comments automatically, record review evidence/decision, or advance workflow state by itself."
     )
   );
-  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(chalk9.gray(`- substate: ${payload.substateId}`));
+  console.log(chalk9.gray(`- owner: ${payload.owner}`));
+  console.log(chalk9.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk9.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
     )
   );
-  console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
+  console.log(chalk9.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
-    console.log(chalk8.gray(`- tasks.md updated: ${payload.tasksPath}`));
+    console.log(chalk9.gray(`- tasks.md updated: ${payload.tasksPath}`));
     console.log(
-      chalk8.gray(
+      chalk9.gray(
         config.lang === "ko" ? "- PR \uB9AC\uBDF0 \uC0C1\uD0DC: Running" : "- PR Review status: Running"
       )
     );
   }
-  console.log(chalk8.gray(`- tasks.md: ${payload.tasksPath}`));
-  console.log(chalk8.gray(`- decisions.md: ${payload.decisionsPath}`));
+  console.log(chalk9.gray(`- tasks.md: ${payload.tasksPath}`));
+  console.log(chalk9.gray(`- decisions.md: ${payload.decisionsPath}`));
 }
 function codeReviewRunCommand(program2) {
   program2.command("code-review-run [feature-name]").description("Prepare a PR review execution handoff for sub-agent work").option("--component <component>", "Component name for multi projects").option("--json", "Output JSON").action(
@@ -16582,7 +17211,7 @@ function codeReviewRunCommand(program2) {
             })
           );
         } else {
-          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
           printCliErrorSuggestions(suggestions, lang);
         }
         process.exitCode = 1;
@@ -16617,8 +17246,8 @@ function requirementsCommand(program2) {
       const lang = ctx?.config?.lang ?? DEFAULT_LANG;
       const cliError = toCliError(error);
       console.error(
-        chalk8.red(tr(lang, "cli", "common.errorLabel")),
-        chalk8.red(`[${cliError.code}] ${cliError.message}`)
+        chalk9.red(tr(lang, "cli", "common.errorLabel")),
+        chalk9.red(`[${cliError.code}] ${cliError.message}`)
       );
       process.exitCode = 1;
     }
@@ -16651,7 +17280,7 @@ async function runRequirements(options) {
   }
   for (const feature of scan.features) {
     if (!feature.docs.tasksExists) continue;
-    const tasksPath = path12.join(feature.path, "tasks.md");
+    const tasksPath = path13.join(feature.path, "tasks.md");
     let tasksContent = "";
     try {
       tasksContent = await ctx.fs.readFile(tasksPath, "utf-8");
@@ -16785,10 +17414,10 @@ async function runRequirements(options) {
   process.stdout.write(`${lines.join("\n")}
 `);
   if (options.write) {
-    const outputPath = path12.join(docsDir, "prd", "status.md");
+    const outputPath = path13.join(docsDir, "prd", "status.md");
     await ctx.fs.writeFile(outputPath, `${lines.join("\n")}
 `, "utf-8");
-    console.log(chalk8.green(`\u2705 wrote: ${outputPath}`));
+    console.log(chalk9.green(`\u2705 wrote: ${outputPath}`));
   }
   if (options.strict && issuesFound) process.exitCode = 1;
 }
@@ -16870,7 +17499,7 @@ async function resolveTaskRunContext(featureName, options) {
 }
 async function runTaskRun(featureName, options) {
   const { config, feature } = await resolveTaskRunContext(featureName, options);
-  const tasksPath = path12.join(feature.path, "tasks.md");
+  const tasksPath = path13.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -16941,20 +17570,20 @@ async function runTaskRun(featureName, options) {
   }
   console.log(prompt);
   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(chalk9.gray(`- substate: ${payload.substateId}`));
+  console.log(chalk9.gray(`- owner: ${payload.owner}`));
+  console.log(chalk9.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk9.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
   console.log(
-    chalk8.gray(
+    chalk9.gray(
       `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
     )
   );
-  console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
+  console.log(chalk9.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
     console.log();
-    console.log(chalk8.gray(`- tasks.md updated: ${tasksPath}`));
-    console.log(chalk8.gray(`- task status: TODO -> DOING`));
+    console.log(chalk9.gray(`- tasks.md updated: ${tasksPath}`));
+    console.log(chalk9.gray(`- task status: TODO -> DOING`));
   }
 }
 function taskRunCommand(program2) {
@@ -16978,7 +17607,7 @@ function taskRunCommand(program2) {
           })
         );
       } else {
-        console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+        console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
         printCliErrorSuggestions(suggestions, lang);
       }
       process.exitCode = 1;
@@ -17029,7 +17658,7 @@ async function resolveTaskCompleteContext(featureName, options) {
 }
 async function runTaskComplete(featureName, options) {
   const { feature } = await resolveTaskCompleteContext(featureName, options);
-  const tasksPath = path12.join(feature.path, "tasks.md");
+  const tasksPath = path13.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -17089,13 +17718,13 @@ async function runTaskComplete(featureName, options) {
     return;
   }
   console.log(
-    chalk8.green(
+    chalk9.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}`));
+  console.log(chalk9.gray(`- tasks.md updated: ${tasksPath}`));
+  console.log(chalk9.gray(`- status: ${resolvedTask.status} -> DONE`));
+  console.log(chalk9.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(
@@ -17117,7 +17746,7 @@ function taskCompleteCommand(program2) {
             })
           );
         } else {
-          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          console.error(chalk9.red(`[${cliError.code}] ${cliError.message}`));
           printCliErrorSuggestions(suggestions, lang);
         }
         process.exitCode = 1;
@@ -17164,15 +17793,15 @@ function getBanner(opts) {
 ${version}
 ` : "\n";
   if (process.stdout.isTTY) {
-    return `${chalk8.cyan(ascii)}${chalk8.gray(footer)}`;
+    return `${chalk9.cyan(ascii)}${chalk9.gray(footer)}`;
   }
   return `${ascii}${footer}`;
 }
-var CACHE_FILE = path12.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+var CACHE_FILE = path13.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path12.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path13.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       return pkg.version;
@@ -17206,8 +17835,8 @@ function resolveUpdateNoticeLang() {
 }
 function printUpdateNotice(current, latest, lang) {
   console.log();
-  console.log(chalk8.yellow(tr(lang, "cli", "versionCheck.noticeAvailable", { latest, current })));
-  console.log(chalk8.gray(tr(lang, "cli", "versionCheck.updateCommand")));
+  console.log(chalk9.yellow(tr(lang, "cli", "versionCheck.noticeAvailable", { latest, current })));
+  console.log(chalk9.gray(tr(lang, "cli", "versionCheck.updateCommand")));
   console.log();
 }
 function spawnBackgroundVersionCheck() {
@@ -17276,7 +17905,7 @@ function shouldCheckForUpdates() {
 if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
-    const packageJsonPath = path12.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path13.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);
@@ -17294,6 +17923,7 @@ if (shouldShowBanner()) {
 }
 initCommand(program);
 featureCommand(program);
+ideaCommand(program);
 statusCommand(program);
 updateCommand(program);
 configCommand(program);