lee-spec-kit 0.7.2 → 0.7.3

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import path13 from 'path';
+import path14 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import fs from 'fs-extra';
@@ -8,11 +8,11 @@ import chalk9 from 'chalk';
 import { spawn, spawnSync, execFileSync, execSync } from 'child_process';
 import os from 'os';
 import { createHash, randomUUID } from 'crypto';
-import fs10 from 'fs';
+import fs11 from 'fs';
 import { Buffer as Buffer$1 } from 'buffer';
 
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path13.dirname(getFilename());
+var getDirname = () => path14.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 = path13.join(current, entryName);
+      const absolute = path14.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 = path13.extname(entryName).toLowerCase();
+        const ext = path14.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 = path13.join(rootDir, entryName);
+    const absolute = path14.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 = path13.dirname(__filename2);
+var __dirname2 = path14.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path13.resolve(__dirname2, "..");
-  return path13.join(rootDir, "templates");
+  const rootDir = path14.resolve(__dirname2, "..");
+  return path14.join(rootDir, "templates");
 }
 
 // src/utils/locales/ko/cli.ts
@@ -1741,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(path13.resolve(value)).digest("hex").slice(0, 16);
+  return createHash("sha1").update(path14.resolve(value)).digest("hex").slice(0, 16);
 }
 function getTempRuntimeDir(scopePath) {
-  return path13.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
+  return path14.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
 }
 function resolveGitRuntimeDir(cwd) {
   try {
@@ -1758,38 +1758,38 @@ function resolveGitRuntimeDir(cwd) {
       }
     ).trim();
     if (!out) return null;
-    return path13.isAbsolute(out) ? out : path13.resolve(cwd, out);
+    return path14.isAbsolute(out) ? out : path14.resolve(cwd, out);
   } catch {
     return null;
   }
 }
 function getRuntimeStateDir(cwd) {
-  const resolved = path13.resolve(cwd);
+  const resolved = path14.resolve(cwd);
   return resolveGitRuntimeDir(resolved) ?? getTempRuntimeDir(resolved);
 }
 function getDocsLockPath(docsDir) {
-  return path13.join(
+  return path14.join(
     getRuntimeStateDir(docsDir),
     "locks",
     `docs-${toScopeKey(docsDir)}.lock`
   );
 }
 function getInitLockPath(targetDir) {
-  return path13.join(
-    getRuntimeStateDir(path13.dirname(path13.resolve(targetDir))),
+  return path14.join(
+    getRuntimeStateDir(path14.dirname(path14.resolve(targetDir))),
     "locks",
     `init-${toScopeKey(targetDir)}.lock`
   );
 }
 function getApprovalTicketStorePath(docsDir) {
-  return path13.join(
+  return path14.join(
     getRuntimeStateDir(docsDir),
     "tickets",
     `approval-${toScopeKey(docsDir)}.json`
   );
 }
 function getProjectExecutionLockPath(cwd) {
-  return path13.join(getRuntimeStateDir(cwd), "locks", "project.lock");
+  return path14.join(getRuntimeStateDir(cwd), "locks", "project.lock");
 }
 async function isStaleLock(lockPath, staleMs) {
   try {
@@ -1830,7 +1830,7 @@ function isProcessAlive(pid) {
   }
 }
 async function tryAcquire(lockPath, owner) {
-  await fs.ensureDir(path13.dirname(lockPath));
+  await fs.ensureDir(path14.dirname(lockPath));
   try {
     const fd = await fs.open(lockPath, "wx");
     const payload = JSON.stringify(
@@ -1907,30 +1907,30 @@ var ENGINE_MANAGED_AGENT_FILES = [
   "pr-template.md"
 ];
 var ENGINE_MANAGED_AGENT_DIRS = ["skills"];
-var ENGINE_MANAGED_FEATURE_PATH = path13.join(
+var ENGINE_MANAGED_FEATURE_PATH = path14.join(
   "features",
   "feature-base"
 );
 async function pruneEngineManagedDocs(docsDir) {
   const removed = [];
   for (const file of ENGINE_MANAGED_AGENT_FILES) {
-    const target = path13.join(docsDir, "agents", file);
+    const target = path14.join(docsDir, "agents", file);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path13.relative(docsDir, target));
+      removed.push(path14.relative(docsDir, target));
     }
   }
   for (const dir of ENGINE_MANAGED_AGENT_DIRS) {
-    const target = path13.join(docsDir, "agents", dir);
+    const target = path14.join(docsDir, "agents", dir);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path13.relative(docsDir, target));
+      removed.push(path14.relative(docsDir, target));
     }
   }
-  const featureBasePath = path13.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
+  const featureBasePath = path14.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
   if (await fs.pathExists(featureBasePath)) {
     await fs.remove(featureBasePath);
-    removed.push(path13.relative(docsDir, featureBasePath));
+    removed.push(path14.relative(docsDir, featureBasePath));
   }
   return removed;
 }
@@ -2011,7 +2011,7 @@ Auto-run continuity (main/sub-agent orchestration):
   3. Else run \`npx lee-spec-kit context --json-compact\` (fallback: \`--json\`) and continue from current \`actionOptions\`/\`autoRun\`.
 - Pause and report to user only when:
   - \`approvalRequest.required === true\`, or
-  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\` or \`AUTO_MANUAL_REQUIRED\`, or
+  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\`, \`AUTO_DELEGATED_HANDOFF\`, or \`AUTO_MANUAL_REQUIRED\`, or
   - command execution fails (non-zero/error), or
   - user explicitly asks to pause.
 
@@ -2229,7 +2229,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path13.basename(cwd);
+  const defaultName = path14.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let components = parseComponentsOption(options.components);
@@ -2240,7 +2240,7 @@ async function runInit(options) {
   let docsRemote = options.docsRemote;
   let projectRoot;
   const componentProjectRoots = options.componentProjectRoots ? parseComponentProjectRootsOption(options.componentProjectRoots) : {};
-  const targetDir = path13.resolve(cwd, options.dir || "./docs");
+  const targetDir = path14.resolve(cwd, options.dir || "./docs");
   const skipPrompts = !!options.yes || !!options.nonInteractive;
   if (options.docsRepo && !["embedded", "standalone"].includes(options.docsRepo)) {
     throw createCliError(
@@ -2637,7 +2637,7 @@ async function runInit(options) {
       );
       console.log();
       const templatesDir = getTemplatesDir();
-      const commonPath = path13.join(templatesDir, lang, "common");
+      const commonPath = path14.join(templatesDir, lang, "common");
       if (!await fs.pathExists(commonPath)) {
         throw new Error(
           tr(lang, "cli", "init.error.templateNotFound", { path: commonPath })
@@ -2646,11 +2646,11 @@ async function runInit(options) {
       const fsAdapter = new DefaultFileSystemAdapter();
       await copyTemplates(fsAdapter, commonPath, targetDir);
       if (projectType === "multi") {
-        const featuresRoot = path13.join(targetDir, "features");
+        const featuresRoot = path14.join(targetDir, "features");
         for (const component of components) {
-          const componentDir = path13.join(featuresRoot, component);
+          const componentDir = path14.join(featuresRoot, component);
           await fs.ensureDir(componentDir);
-          const readmePath = path13.join(componentDir, "README.md");
+          const readmePath = path14.join(componentDir, "README.md");
           if (!await fs.pathExists(readmePath)) {
             await fs.writeFile(
               readmePath,
@@ -2711,20 +2711,20 @@ async function runInit(options) {
           config.projectRoot = projectRoot;
         }
       }
-      const configPath = path13.join(targetDir, ".lee-spec-kit.json");
+      const configPath = path14.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 = path13.join(repoRoot, "AGENTS.md");
+          const agentsMdPath = path14.join(repoRoot, "AGENTS.md");
           const result = await upsertLeeSpecKitAgentsMd(agentsMdPath, {
             lang,
             docsRepo
           });
           if (result.changed) extraCommitPathsAbs.push(agentsMdPath);
         } else {
-          await upsertLeeSpecKitAgentsMd(path13.join(targetDir, "AGENTS.md"), {
+          await upsertLeeSpecKitAgentsMd(path14.join(targetDir, "AGENTS.md"), {
             lang,
             docsRepo
           });
@@ -2734,16 +2734,16 @@ async function runInit(options) {
           } else if (projectRoot && typeof projectRoot === "object") {
             roots.push(...Object.values(projectRoot));
           }
-          const resolvedCwd = path13.resolve(cwd);
+          const resolvedCwd = path14.resolve(cwd);
           for (const raw of roots) {
             const value = String(raw || "").trim();
             if (!value) continue;
-            const abs = path13.resolve(cwd, value);
-            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path13.sep}`)) {
+            const abs = path14.resolve(cwd, value);
+            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path14.sep}`)) {
               if (await fs.pathExists(abs)) {
                 const stat = await fs.stat(abs);
                 if (stat.isDirectory()) {
-                  await upsertLeeSpecKitAgentsMd(path13.join(abs, "AGENTS.md"), {
+                  await upsertLeeSpecKitAgentsMd(path14.join(abs, "AGENTS.md"), {
                     lang,
                     docsRepo
                   });
@@ -2833,7 +2833,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       console.log(chalk9.blue(tr(lang, "cli", "init.log.gitInit")));
       runGitOrThrow(["init"], gitWorkdir);
     }
-    const relativePath = docsRepo === "standalone" ? "." : path13.relative(gitWorkdir, targetDir);
+    const relativePath = docsRepo === "standalone" ? "." : path14.relative(gitWorkdir, targetDir);
     const stagedBeforeAdd = getCachedStagedFiles(gitWorkdir);
     if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
       console.log(chalk9.yellow(tr(lang, "cli", "init.warn.stagedChangesSkip")));
@@ -2860,7 +2860,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       console.log();
       return;
     }
-    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path13.relative(gitWorkdir, absPath)).map((p) => p.replace(/\\/g, "/").trim()).filter((p) => !!p && p !== "." && !p.startsWith("../"));
+    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path14.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);
@@ -2896,17 +2896,17 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
 }
 function getAncestorDirs(startDir) {
   const dirs = [];
-  let current = path13.resolve(startDir);
+  let current = path14.resolve(startDir);
   while (true) {
     dirs.push(current);
-    const parent = path13.dirname(current);
+    const parent = path14.dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return dirs;
 }
 function hasWorkspaceBoundary(dir) {
-  return fs.existsSync(path13.join(dir, "package.json")) || fs.existsSync(path13.join(dir, ".git"));
+  return fs.existsSync(path14.join(dir, "package.json")) || fs.existsSync(path14.join(dir, ".git"));
 }
 function getSearchBaseDirs(cwd) {
   const ancestors = getAncestorDirs(cwd);
@@ -2922,7 +2922,7 @@ function normalizeComponentKeys(value) {
   return Object.keys(value).map((key) => key.trim().toLowerCase()).filter(Boolean);
 }
 async function inferComponentsFromFeaturesDir(docsDir) {
-  const featuresPath = path13.join(docsDir, "features");
+  const featuresPath = path14.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(
@@ -2933,21 +2933,21 @@ async function inferComponentsFromFeaturesDir(docsDir) {
 async function getConfig(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
-    ...explicitDocsDir ? [path13.resolve(explicitDocsDir)] : [],
+    ...explicitDocsDir ? [path14.resolve(explicitDocsDir)] : [],
     ...getSearchBaseDirs(cwd)
   ];
   const visitedBaseDirs = /* @__PURE__ */ new Set();
   const visitedDocsDirs = /* @__PURE__ */ new Set();
   for (const baseDir of baseDirs) {
-    const resolvedBaseDir = path13.resolve(baseDir);
+    const resolvedBaseDir = path14.resolve(baseDir);
     if (visitedBaseDirs.has(resolvedBaseDir)) continue;
     visitedBaseDirs.add(resolvedBaseDir);
-    const possibleDocsDirs = [path13.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    const possibleDocsDirs = [path14.join(resolvedBaseDir, "docs"), resolvedBaseDir];
     for (const docsDir of possibleDocsDirs) {
-      const resolvedDocsDir = path13.resolve(docsDir);
+      const resolvedDocsDir = path14.resolve(docsDir);
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
-      const configPath = path13.join(resolvedDocsDir, ".lee-spec-kit.json");
+      const configPath = path14.join(resolvedDocsDir, ".lee-spec-kit.json");
       if (await fs.pathExists(configPath)) {
         try {
           const configFile = await fs.readJson(configPath);
@@ -2977,16 +2977,16 @@ async function getConfig(cwd) {
         } catch {
         }
       }
-      const agentsPath = path13.join(resolvedDocsDir, "agents");
-      const featuresPath = path13.join(resolvedDocsDir, "features");
+      const agentsPath = path14.join(resolvedDocsDir, "agents");
+      const featuresPath = path14.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 = [
-          path13.join(agentsPath, "custom.md"),
-          path13.join(agentsPath, "constitution.md"),
-          path13.join(agentsPath, "agents.md")
+          path14.join(agentsPath, "custom.md"),
+          path14.join(agentsPath, "constitution.md"),
+          path14.join(agentsPath, "agents.md")
         ];
         let lang = "en";
         for (const candidate of langProbeCandidates) {
@@ -3057,13 +3057,85 @@ async function patchMarkdownIfExists(filePath, transform) {
   await fs.writeFile(filePath, transform(content), "utf-8");
 }
 async function applyLocalWorkflowTemplateToFeatureDir(featureDir, lang) {
-  await patchMarkdownIfExists(path13.join(featureDir, "spec.md"), sanitizeSpecForLocal);
+  await patchMarkdownIfExists(path14.join(featureDir, "spec.md"), sanitizeSpecForLocal);
   await patchMarkdownIfExists(
-    path13.join(featureDir, "tasks.md"),
+    path14.join(featureDir, "tasks.md"),
     (content) => sanitizeTasksForLocal(content, lang)
   );
-  await fs.remove(path13.join(featureDir, "issue.md"));
-  await fs.remove(path13.join(featureDir, "pr.md"));
+  await fs.remove(path14.join(featureDir, "issue.md"));
+  await fs.remove(path14.join(featureDir, "pr.md"));
+}
+var IDEA_REF_PATTERN = /\b(I\d{3,}(?:-[A-Za-z0-9._-]+)?)\b/;
+var IDEA_PATH_PATTERN = /\b(?:\.\/)?docs\/ideas\/[^\s]+\.md\b/;
+function extractExplicitIdeaRef(requestText) {
+  const pathMatch = requestText.match(IDEA_PATH_PATTERN);
+  if (pathMatch) return pathMatch[0];
+  const refMatch = requestText.match(IDEA_REF_PATTERN);
+  if (refMatch) return refMatch[1];
+  return null;
+}
+async function resolveIdeaReference(docsDir, ref, lang) {
+  const ideasDir = path14.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 = path14.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: path14.join(ideasDir, exactName) };
+  }
+  const byId = /^I\d{3,}$/.test(trimmedRef) ? files.filter((name) => name.startsWith(`${trimmedRef}-`)) : [];
+  if (byId.length === 1) {
+    return { path: path14.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 readIdeaMetadataValue(ideaPath, label) {
+  const content = await fs.readFile(ideaPath, "utf-8");
+  const pattern = new RegExp(`^- \\*\\*${escapeRegExp(label)}\\*\\*:\\s*(.+)$`, "m");
+  const match = content.match(pattern);
+  if (!match) return null;
+  const value = match[1].trim();
+  return value.length > 0 ? value : null;
+}
+async function deriveFeatureNameFromIdea(ideaPath) {
+  const ideaName = await readIdeaMetadataValue(ideaPath, "Idea Name");
+  if (ideaName && ideaName !== "-") return ideaName;
+  const basename = path14.basename(ideaPath, ".md");
+  return basename.replace(/^I\d{3,}-/, "");
+}
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
 // src/commands/feature.ts
@@ -3215,19 +3287,19 @@ async function runFeature(name, options) {
       }
       let featuresDir;
       if (projectType === "multi") {
-        featuresDir = path13.join(docsDir, "features", component);
+        featuresDir = path14.join(docsDir, "features", component);
       } else {
-        featuresDir = path13.join(docsDir, "features");
+        featuresDir = path14.join(docsDir, "features");
       }
       const featureFolderName = `${featureId}-${name}`;
-      const featureDir = path13.join(featuresDir, featureFolderName);
+      const featureDir = path14.join(featuresDir, featureFolderName);
       if (await fs.pathExists(featureDir)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "feature.folderExists", { path: featureDir })
         );
       }
-      const featureBasePath = path13.join(
+      const featureBasePath = path14.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -3274,8 +3346,8 @@ async function runFeature(name, options) {
       await replaceInFiles(fsAdapter, featureDir, replacements);
       if (linkedIdea) {
         await stampIdeaReferenceInSpec(
-          path13.join(featureDir, "spec.md"),
-          path13.relative(featureDir, linkedIdea.path)
+          path14.join(featureDir, "spec.md"),
+          path14.relative(featureDir, linkedIdea.path)
         );
         await markIdeaAsFeatureized(linkedIdea.path, featureFolderName);
       }
@@ -3303,58 +3375,12 @@ async function runFeature(name, options) {
         featureName: name,
         component: projectType === "multi" ? component : void 0,
         featurePath: featureDir,
-        featurePathFromDocs: path13.relative(docsDir, featureDir)
+        featurePathFromDocs: path14.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}\``;
@@ -3385,7 +3411,7 @@ async function markIdeaAsFeatureized(ideaPath, featureFolderName) {
   await fs.writeFile(ideaPath, content, "utf-8");
 }
 function replaceOrAppendIdeaMetadata(content, label, value) {
-  const pattern = new RegExp(`^- \\*\\*${escapeRegExp(label)}\\*\\*:.*$`, "m");
+  const pattern = new RegExp(`^- \\*\\*${escapeRegExp2(label)}\\*\\*:.*$`, "m");
   const line = `- **${label}**: ${value}`;
   if (pattern.test(content)) {
     return content.replace(pattern, line);
@@ -3403,15 +3429,15 @@ ${heading}
 ${line}
 `;
 }
-function escapeRegExp(value) {
+function escapeRegExp2(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const candidates = [
-    ...explicitDocsDir ? [path13.resolve(explicitDocsDir)] : [],
-    path13.resolve(cwd, "docs"),
-    path13.resolve(cwd)
+    ...explicitDocsDir ? [path14.resolve(explicitDocsDir)] : [],
+    path14.resolve(cwd, "docs"),
+    path14.resolve(cwd)
   ];
   const endAt = Date.now() + timeoutMs;
   while (Date.now() < endAt) {
@@ -3438,12 +3464,12 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   return getConfig(cwd);
 }
 async function getNextFeatureId(docsDir, projectType, components) {
-  const featuresDir = path13.join(docsDir, "features");
+  const featuresDir = path14.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "multi") {
     scanDirs.push(
-      ...components.map((component) => path13.join(featuresDir, component))
+      ...components.map((component) => path14.join(featuresDir, component))
     );
   } else {
     scanDirs.push(featuresDir);
@@ -3544,16 +3570,16 @@ async function runIdea(name, options) {
     getDocsLockPath(docsDir),
     async () => {
       const ideaId = options.id ? validateProvidedIdeaId(options.id, lang) : await getNextIdeaId(docsDir);
-      const ideasDir = path13.join(docsDir, "ideas");
+      const ideasDir = path14.join(docsDir, "ideas");
       const ideaFileName = `${ideaId}-${name}.md`;
-      const ideaPath = path13.join(ideasDir, ideaFileName);
+      const ideaPath = path14.join(ideasDir, ideaFileName);
       if (await fs.pathExists(ideaPath)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "idea.fileExists", { path: ideaPath })
         );
       }
-      const templatePath = path13.join(
+      const templatePath = path14.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -3591,7 +3617,7 @@ async function runIdea(name, options) {
         ideaName: name,
         component: component || void 0,
         ideaPath,
-        ideaPathFromDocs: path13.relative(docsDir, ideaPath)
+        ideaPathFromDocs: path14.relative(docsDir, ideaPath)
       };
     },
     { owner: "idea" }
@@ -3609,7 +3635,7 @@ 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");
+  const ideasDir = path14.join(docsDir, "ideas");
   let max = 0;
   if (await fs.pathExists(ideasDir)) {
     const entries = await fs.readdir(ideasDir, { withFileTypes: true });
@@ -4048,7 +4074,7 @@ function isNonNegativeIntegerValue(value) {
 }
 function isLikelyCurrentPrePrReviewEvidence(evidencePath, feature) {
   try {
-    const raw = fs10.readFileSync(evidencePath, "utf-8");
+    const raw = fs11.readFileSync(evidencePath, "utf-8");
     const parsed = JSON.parse(raw);
     const evidenceFeature = (parsed.feature || "").toString().trim();
     if (evidenceFeature && evidenceFeature !== feature.folderName) {
@@ -4064,31 +4090,31 @@ function resolvePrePrReviewEvidencePath(feature) {
   const candidates = [];
   const explicit = (feature.prePrReview.evidence || "").trim();
   if (explicit && explicit !== "-") {
-    if (path13.isAbsolute(explicit)) {
+    if (path14.isAbsolute(explicit)) {
       candidates.push(explicit);
     } else {
-      candidates.push(path13.resolve(feature.path, explicit));
-      candidates.push(path13.resolve(docsRoot, explicit));
+      candidates.push(path14.resolve(feature.path, explicit));
+      candidates.push(path14.resolve(docsRoot, explicit));
       const normalizedExplicit = explicit.replace(/\\/g, "/");
       if (normalizedExplicit.startsWith("docs/")) {
         const withoutDocsPrefix = normalizedExplicit.slice("docs/".length);
         if (withoutDocsPrefix) {
-          candidates.push(path13.resolve(docsRoot, withoutDocsPrefix));
+          candidates.push(path14.resolve(docsRoot, withoutDocsPrefix));
         }
       }
     }
   }
-  candidates.push(path13.join(feature.path, "review-trace.json"));
-  candidates.push(path13.join(docsRoot, "review-trace.json"));
+  candidates.push(path14.join(feature.path, "review-trace.json"));
+  candidates.push(path14.join(docsRoot, "review-trace.json"));
   const seen = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
-    const abs = path13.resolve(candidate);
+    const abs = path14.resolve(candidate);
     if (seen.has(abs)) continue;
     seen.add(abs);
-    if (!fs10.existsSync(abs)) continue;
+    if (!fs11.existsSync(abs)) continue;
     if (!abs.toLowerCase().endsWith(".json")) continue;
     if (!isLikelyCurrentPrePrReviewEvidence(abs, feature)) continue;
-    const rel = path13.relative(docsRoot, abs).replace(/\\/g, "/");
+    const rel = path14.relative(docsRoot, abs).replace(/\\/g, "/");
     if (rel && !rel.startsWith("../")) {
       return rel;
     }
@@ -4129,8 +4155,8 @@ function getReviewFixCommitGuidance(feature, lang, options) {
 }
 function resolveManagedWorktreeCleanupPaths(projectGitCwd) {
   if (!projectGitCwd) return null;
-  const normalized = path13.resolve(projectGitCwd);
-  const marker = `${path13.sep}.worktrees${path13.sep}`;
+  const normalized = path14.resolve(projectGitCwd);
+  const marker = `${path14.sep}.worktrees${path14.sep}`;
   const markerIndex = normalized.lastIndexOf(marker);
   if (markerIndex <= 0) return null;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -4173,7 +4199,7 @@ function toTaskKey(rawTitle) {
 function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   const docsGitCwd = feature.git.docsGitCwd;
   const tasksRelativePath = normalizeGitRelativePath(
-    path13.join(feature.docs.featurePathFromDocs, "tasks.md")
+    path14.join(feature.docs.featurePathFromDocs, "tasks.md")
   );
   const diff = readGitText(ctx, docsGitCwd, [
     "diff",
@@ -4248,7 +4274,7 @@ function checkTaskCommitGate(ctx, feature) {
     return { pass: true };
   }
   const args = ["log", "-n", "1", "--pretty=%s", "--", "."];
-  const relativeDocsDir = path13.relative(projectGitCwd, feature.git.docsGitCwd);
+  const relativeDocsDir = path14.relative(projectGitCwd, feature.git.docsGitCwd);
   const normalizedDocsDir = normalizeGitRelativePath(relativeDocsDir);
   if (normalizedDocsDir && normalizedDocsDir !== "." && normalizedDocsDir !== ".." && !normalizedDocsDir.startsWith("../")) {
     args.push(`:(exclude)${normalizedDocsDir}/**`);
@@ -5864,17 +5890,17 @@ function isGitPathIgnored(ctx, cwd, relativePath) {
   }
 }
 var GIT_WORKTREE_CACHE = /* @__PURE__ */ new Map();
-var WORKTREE_MARKER = `${path13.sep}.worktrees${path13.sep}`;
+var WORKTREE_MARKER = `${path14.sep}.worktrees${path14.sep}`;
 function resetContextGitCaches() {
   GIT_WORKTREE_CACHE.clear();
 }
 function isManagedWorktreePath(cwd) {
   if (!cwd) return false;
-  const normalized = path13.resolve(cwd);
+  const normalized = path14.resolve(cwd);
   return normalized.includes(WORKTREE_MARKER);
 }
 function resolveProjectRootFromGitCwd(cwd) {
-  const normalized = path13.resolve(cwd);
+  const normalized = path14.resolve(cwd);
   const markerIndex = normalized.lastIndexOf(WORKTREE_MARKER);
   if (markerIndex <= 0) return normalized;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -5893,7 +5919,7 @@ function getGitTopLevel(ctx, cwd) {
 }
 function listGitWorktrees(ctx, cwd) {
   const topLevel = getGitTopLevel(ctx, cwd) || cwd;
-  const cacheKey = path13.resolve(topLevel);
+  const cacheKey = path14.resolve(topLevel);
   const cached = GIT_WORKTREE_CACHE.get(cacheKey);
   if (cached) return cached;
   try {
@@ -5994,12 +6020,12 @@ function countDocumentLines(content) {
   if (lines[lines.length - 1] === "") return lines.length - 1;
   return lines.length;
 }
-function escapeRegExp2(value) {
+function escapeRegExp3(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractSpecValue(content, key) {
   const regex = new RegExp(
-    `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:\\s*(.*)$`,
+    `^\\s*-\\s*\\*\\*${escapeRegExp3(key)}\\*\\*\\s*:\\s*(.*)$`,
     "m"
   );
   const match = content.match(regex);
@@ -6007,7 +6033,7 @@ function extractSpecValue(content, key) {
 }
 function hasSpecKey(content, key) {
   const regex = new RegExp(
-    `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:`,
+    `^\\s*-\\s*\\*\\*${escapeRegExp3(key)}\\*\\*\\s*:`,
     "m"
   );
   return regex.test(content);
@@ -6199,7 +6225,7 @@ function splitReviewLogSections(content, headerRegex) {
 }
 function collectStructuredReviewEntries(section, keys) {
   const lines = section.split("\n");
-  const escaped = keys.map((key) => escapeRegExp2(key));
+  const escaped = keys.map((key) => escapeRegExp3(key));
   const fieldRegex = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*(.*)$`,
     "i"
@@ -6381,17 +6407,17 @@ function resolveLocalEvidencePathCandidates(rawValue, context) {
   if (!evidencePath) return [];
   if (/^https?:\/\//i.test(evidencePath)) return [];
   const candidates = /* @__PURE__ */ new Set();
-  if (path13.isAbsolute(evidencePath)) {
-    candidates.add(path13.resolve(evidencePath));
+  if (path14.isAbsolute(evidencePath)) {
+    candidates.add(path14.resolve(evidencePath));
   } else {
-    candidates.add(path13.resolve(context.featurePath, evidencePath));
-    candidates.add(path13.resolve(context.docsDir, evidencePath));
-    candidates.add(path13.resolve(path13.dirname(context.docsDir), evidencePath));
+    candidates.add(path14.resolve(context.featurePath, evidencePath));
+    candidates.add(path14.resolve(context.docsDir, evidencePath));
+    candidates.add(path14.resolve(path14.dirname(context.docsDir), evidencePath));
     const normalizedEvidencePath = evidencePath.replace(/\\/g, "/");
     if (normalizedEvidencePath.startsWith("docs/")) {
       const withoutDocsPrefix = normalizedEvidencePath.slice("docs/".length);
       if (withoutDocsPrefix) {
-        candidates.add(path13.resolve(context.docsDir, withoutDocsPrefix));
+        candidates.add(path14.resolve(context.docsDir, withoutDocsPrefix));
       }
     }
   }
@@ -6453,13 +6479,13 @@ function parsePrLink(value) {
   return trimmed;
 }
 function normalizeGitPath(value) {
-  return value.split(path13.sep).join("/");
+  return value.split(path14.sep).join("/");
 }
 function resolveProjectStatusPaths(projectGitCwd, docsDir) {
-  const relativeDocsDir = path13.relative(projectGitCwd, docsDir);
+  const relativeDocsDir = path14.relative(projectGitCwd, docsDir);
   if (!relativeDocsDir) return [];
-  if (path13.isAbsolute(relativeDocsDir)) return [];
-  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path13.sep}`)) {
+  if (path14.isAbsolute(relativeDocsDir)) return [];
+  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path14.sep}`)) {
     return [];
   }
   const normalizedDocsDir = normalizeGitPath(relativeDocsDir).replace(
@@ -6497,7 +6523,7 @@ function getExpectedWorktreeCandidates(projectGitCwd, issueNumber, slug, folderN
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   for (const name of names) {
-    const candidate = path13.resolve(projectRoot, ".worktrees", name);
+    const candidate = path14.resolve(projectRoot, ".worktrees", name);
     if (seen.has(candidate)) continue;
     seen.add(candidate);
     out.push(candidate);
@@ -6511,7 +6537,7 @@ function resolveExistingExpectedWorktreePath(projectGitCwd, issueNumber, slug, f
     slug,
     folderName
   )) {
-    if (!fs10.existsSync(candidate)) continue;
+    if (!fs11.existsSync(candidate)) continue;
     return candidate;
   }
   return void 0;
@@ -6541,7 +6567,7 @@ function resolveFeatureWorktreePath(ctx, projectGitCwd, issueNumber, slug, folde
     slug,
     folderName
   )) {
-    if (!fs10.existsSync(candidate)) continue;
+    if (!fs11.existsSync(candidate)) continue;
     const branchName = getCurrentBranch(ctx, candidate);
     if (!expectedBranchesSet.has(branchName)) continue;
     return {
@@ -6682,10 +6708,10 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   const normalizedCandidates = uniqueNormalizedPaths(
     candidates.map((candidate) => {
       if (!candidate) return "";
-      if (!path13.isAbsolute(candidate)) return candidate;
-      const relative = path13.relative(projectGitCwd, candidate);
+      if (!path14.isAbsolute(candidate)) return candidate;
+      const relative = path14.relative(projectGitCwd, candidate);
       if (!relative) return "";
-      if (relative === ".." || relative.startsWith(`..${path13.sep}`))
+      if (relative === ".." || relative.startsWith(`..${path14.sep}`))
         return "";
       return relative;
     }).filter(Boolean)
@@ -6699,7 +6725,7 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   if (cached) return [...cached];
   const existing = [];
   for (const candidate of normalizedCandidates) {
-    if (await ctx.fs.pathExists(path13.join(projectGitCwd, candidate))) {
+    if (await ctx.fs.pathExists(path14.join(projectGitCwd, candidate))) {
       existing.push(candidate);
     }
   }
@@ -6787,16 +6813,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 = path13.basename(featurePath);
+  const folderName = path14.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
   const slug = match?.[2] || folderName;
-  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");
+  const specPath = path14.join(featurePath, "spec.md");
+  const planPath = path14.join(featurePath, "plan.md");
+  const tasksPath = path14.join(featurePath, "tasks.md");
+  const decisionsPath = path14.join(featurePath, "decisions.md");
+  const issueDocPath = path14.join(featurePath, "issue.md");
+  const prDocPath = path14.join(featurePath, "pr.md");
   let specStatus;
   let issueNumber;
   const specExists = await ctx.fs.pathExists(specPath);
@@ -7058,7 +7084,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 = path13.relative(
+  const relativeFeaturePathFromDocs = path14.relative(
     context.docsDir,
     featurePath
   );
@@ -7421,7 +7447,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) => path13.basename(value).trim().toLowerCase() !== "feature-base"
+    (value) => path14.basename(value).trim().toLowerCase() !== "feature-base"
   );
 }
 function normalizeRelPath(value) {
@@ -7562,7 +7588,7 @@ async function scanFeatures(ctx) {
   if (config.projectType === "single") {
     const featureDirs = await listFeatureDirs(
       ctx,
-      path13.join(config.docsDir, "features")
+      path14.join(config.docsDir, "features")
     );
     componentFeatureDirs.set("single", featureDirs);
     allFeatureDirs.push(...featureDirs);
@@ -7574,14 +7600,14 @@ async function scanFeatures(ctx) {
     for (const component of components) {
       const componentDirs = await listFeatureDirs(
         ctx,
-        path13.join(config.docsDir, "features", component)
+        path14.join(config.docsDir, "features", component)
       );
       componentFeatureDirs.set(component, componentDirs);
       allFeatureDirs.push(...componentDirs);
     }
   }
   const relativeFeaturePaths = allFeatureDirs.map(
-    (dir) => normalizeRelPath(path13.relative(config.docsDir, dir))
+    (dir) => normalizeRelPath(path14.relative(config.docsDir, dir))
   );
   const docsGitMeta = buildDocsFeatureGitMeta(
     ctx,
@@ -7598,7 +7624,7 @@ async function scanFeatures(ctx) {
     const parsed = await Promise.all(
       target.dirs.map(async (dir) => {
         const relativeFeaturePathFromDocs = normalizeRelPath(
-          path13.relative(config.docsDir, dir)
+          path14.relative(config.docsDir, dir)
         );
         const docsMeta = docsGitMeta.get(relativeFeaturePathFromDocs);
         return parseFeature(
@@ -7668,13 +7694,13 @@ async function runStatus(options) {
     );
   }
   const { docsDir, projectType, projectName, lang } = ctx.config;
-  const featuresDir = path13.join(docsDir, "features");
+  const featuresDir = path14.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 = path13.relative(docsDir, f.path);
+    const relPath = path14.relative(docsDir, f.path);
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(relPath);
     if (!f.docs.specExists || !f.docs.tasksExists) continue;
@@ -7765,7 +7791,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path13.join(featuresDir, "status.md");
+    const outputPath = path14.join(featuresDir, "status.md");
     const date = getLocalDateString();
     const content = [
       "# Feature Status",
@@ -7786,18 +7812,18 @@ async function runStatus(options) {
     );
   }
 }
-function escapeRegExp3(value) {
+function escapeRegExp4(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 async function getFeatureNameFromSpec(fsAdapter, featureDir, fallbackSlug, fallbackFolderName) {
   try {
-    const specPath = path13.join(featureDir, "spec.md");
+    const specPath = path14.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*\\*\\*${escapeRegExp3(key)}\\*\\*\\s*:\\s*(.*)$`,
+        `^\\s*-\\s*\\*\\*${escapeRegExp4(key)}\\*\\*\\s*:\\s*(.*)$`,
         "m"
       );
       const match = content.match(regex);
@@ -7875,8 +7901,8 @@ async function runUpdate(options) {
           console.log(chalk9.blue(tr(lang, "cli", "update.updatingAgents")));
         }
         if (agentsMode === "all") {
-          const commonAgentsBase = path13.join(templatesDir, lang, "common", "agents");
-          const targetAgentsBase = path13.join(docsDir, "agents");
+          const commonAgentsBase = path14.join(templatesDir, lang, "common", "agents");
+          const targetAgentsBase = path14.join(docsDir, "agents");
           const commonAgents = commonAgentsBase;
           const targetAgents = targetAgentsBase;
           const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
@@ -7974,21 +8000,21 @@ async function collectAgentsMdTargets(cwd, config) {
   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"));
+    const repoRoot = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || path14.resolve(config.docsDir, "..");
+    targets.add(path14.join(repoRoot, "AGENTS.md"));
     return [...targets];
   }
-  targets.add(path13.join(config.docsDir, "AGENTS.md"));
+  targets.add(path14.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);
+    const resolved = path14.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"));
+    targets.add(path14.join(resolved, "AGENTS.md"));
   }
   return [...targets];
 }
@@ -8028,7 +8054,7 @@ function normalizeDecisionEnumList2(raw) {
   return [...deduped];
 }
 async function backfillMissingConfigDefaults(docsDir) {
-  const configPath = path13.join(docsDir, ".lee-spec-kit.json");
+  const configPath = path14.join(docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     return { changed: false, changedPaths: [] };
   }
@@ -8151,8 +8177,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 = path13.join(sourceDir, file);
-    const targetPath = path13.join(targetDir, file);
+    const sourcePath = path14.join(sourceDir, file);
+    const targetPath = path14.join(targetDir, file);
     const stat = await fs.stat(sourcePath);
     if (stat.isFile()) {
       if (protectedFiles.has(file)) {
@@ -8235,7 +8261,7 @@ function extractPorcelainPaths(line) {
 function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   const top = getGitTopLevel2(docsDir);
   if (!top) return null;
-  const rel = path13.relative(top, docsDir) || ".";
+  const rel = path14.relative(top, docsDir) || ".";
   try {
     const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
       cwd: top,
@@ -8247,7 +8273,7 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
     }
     const ignoredRelPaths = new Set(
       ignoredAbsPaths.map(
-        (absPath) => normalizeGitPath2(path13.relative(top, absPath) || ".")
+        (absPath) => normalizeGitPath2(path14.relative(top, absPath) || ".")
       )
     );
     const filtered = output.split("\n").filter((line) => {
@@ -8305,7 +8331,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runConfig(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path13.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path14.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   if (!config) {
     throw createCliError(
@@ -8313,7 +8339,7 @@ async function runConfig(options) {
       tr(DEFAULT_LANG, "cli", "common.configNotFound")
     );
   }
-  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path14.join(config.docsDir, ".lee-spec-kit.json");
   if (!options.projectRoot) {
     console.log();
     console.log(chalk9.blue(tr(config.lang, "cli", "config.currentTitle")));
@@ -8419,47 +8445,47 @@ var BUILTIN_DOC_DEFINITIONS = [
   {
     id: "agents",
     title: { ko: "\uC5D0\uC774\uC804\uD2B8 \uC6B4\uC601 \uADDC\uCE59", en: "Agent Operating Rules" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "agents.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "agents.md")
   },
   {
     id: "git-workflow",
     title: { ko: "Git \uC6CC\uD06C\uD50C\uB85C\uC6B0", en: "Git Workflow" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "git-workflow.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "git-workflow.md")
   },
   {
     id: "issue-doc",
     title: { ko: "Issue \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "Issue Document Template" },
-    relativePath: (_, lang) => path13.join(lang, "common", "features", "feature-base", "issue.md")
+    relativePath: (_, lang) => path14.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) => path13.join(lang, "common", "features", "feature-base", "pr.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "features", "feature-base", "pr.md")
   },
   {
     id: "create-feature",
     title: { ko: "create-feature \uC2A4\uD0AC", en: "create-feature skill" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-feature.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "skills", "create-feature.md")
   },
   {
     id: "execute-task",
     title: { ko: "execute-task \uC2A4\uD0AC", en: "execute-task skill" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "execute-task.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "skills", "execute-task.md")
   },
   {
     id: "create-issue",
     title: { ko: "create-issue \uC2A4\uD0AC", en: "create-issue skill" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-issue.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "skills", "create-issue.md")
   },
   {
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
-    relativePath: (_, lang) => path13.join(lang, "common", "agents", "skills", "create-pr.md")
+    relativePath: (_, lang) => path14.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) => path13.join(lang, "common", "agents", "skills", "split-feature.md")
+    relativePath: (_, lang) => path14.join(lang, "common", "agents", "skills", "split-feature.md")
   }
 ];
 var DOC_FOLLOWUPS = {
@@ -8556,7 +8582,7 @@ function listBuiltinDocs(projectType, lang) {
       id: doc.id,
       title: doc.title[lang],
       relativePath,
-      absolutePath: path13.join(templatesDir, relativePath)
+      absolutePath: path14.join(templatesDir, relativePath)
     };
   });
 }
@@ -8966,6 +8992,13 @@ async function resolveContextSelection(ctx, featureName, options) {
 
 // src/services/ContextPresenter.ts
 function getActionExecutionMetadata(action) {
+  if (action.category === "task_execute" && action.taskExecutePhase === "start") {
+    return {
+      handoffOnly: true,
+      advancesWorkflow: false,
+      nextMainState: "task_complete"
+    };
+  }
   if (action.category === "code_review_run") {
     return {
       handoffOnly: true,
@@ -9050,6 +9083,7 @@ function buildAgentOrchestrationPolicy(actionOptions, autoRunAvailable, autoRunC
     pauseAndReportWhen: [
       "approvalRequest.required=true",
       "AUTO_GATE_REACHED",
+      "AUTO_DELEGATED_HANDOFF",
       "AUTO_MANUAL_REQUIRED",
       "command execution error"
     ],
@@ -9593,7 +9627,7 @@ function getApprovalSessionId() {
 function getApprovalTicketPaths(config) {
   return {
     runtimePath: getApprovalTicketStorePath(config.docsDir),
-    legacyPath: path13.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
+    legacyPath: path14.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
   };
 }
 async function loadApprovalTicketStore(storePath) {
@@ -9607,7 +9641,7 @@ async function loadApprovalTicketStore(storePath) {
   }
 }
 async function saveApprovalTicketStore(storePath, payload) {
-  await fs.ensureDir(path13.dirname(storePath));
+  await fs.ensureDir(path14.dirname(storePath));
   await fs.writeJson(storePath, payload, { spaces: 2 });
 }
 function pruneApprovalTickets(tickets, nowMs) {
@@ -9793,6 +9827,14 @@ function getCommandExecutionLockPath(action, config) {
   return getProjectExecutionLockPath(action.cwd);
 }
 function buildApprovedHandoffMetadata(action, featureRef) {
+  if (action.category === "task_execute" && action.taskExecutePhase === "start") {
+    const taskId = action.cmd.match(/\b--task\s+([^\s]+)/)?.[1];
+    return {
+      delegatedWorkRequired: true,
+      doNotReapproveSameLabel: true,
+      reuseKey: taskId ? `task:${featureRef}:${taskId}` : `task:${featureRef}`
+    };
+  }
   if (action.category === "pre_pr_review_run") {
     return {
       delegatedWorkRequired: true,
@@ -10460,7 +10502,7 @@ async function runContext(featureName, options) {
         untilCategories: autoRunPlan.untilCategories,
         unknownCategories: autoRunPlan.unknownCategories,
         manualBoundary: autoRunPlan.manualBoundary,
-        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.'
+        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`, when auto mode reaches configured gate categories, or when a delegated handoff pause must be resumed.'
       },
       approvalRequest: {
         guidance: approvalGuidance.replace(
@@ -10684,7 +10726,7 @@ async function runContext(featureName, options) {
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
-  console.log(`   \u2022 Path: ${path13.relative(cwd, f.path)}`);
+  console.log(`   \u2022 Path: ${path14.relative(cwd, f.path)}`);
   if (f.git.projectBranch) {
     console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
   }
@@ -10836,7 +10878,7 @@ function extractTitleAfterId(line, id) {
   return cleaned ? cleaned : void 0;
 }
 async function scanPrdRequirements(fsAdapter, docsDir) {
-  const prdDir = path13.join(docsDir, "prd");
+  const prdDir = path14.join(docsDir, "prd");
   const files = await walkFiles(fsAdapter, prdDir, {
     extensions: [".md"],
     ignoreDirs: [".git", "node_modules", "dist", "tmp"]
@@ -10844,7 +10886,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
   const definitions = /* @__PURE__ */ new Map();
   const duplicates = [];
   for (const filePath of files) {
-    if (path13.basename(filePath).toLowerCase() === "readme.md") {
+    if (path14.basename(filePath).toLowerCase() === "readme.md") {
       continue;
     }
     let content = "";
@@ -10853,7 +10895,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
     } catch {
       continue;
     }
-    const relFile = normalizeRelPath2(path13.relative(docsDir, filePath));
+    const relFile = normalizeRelPath2(path14.relative(docsDir, filePath));
     const lines = content.split(/\r?\n/);
     let inCodeBlock = false;
     for (let i = 0; i < lines.length; i += 1) {
@@ -10928,7 +10970,7 @@ var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
 ]);
 function formatPath(cwd, p) {
   if (!p) return "";
-  return path13.isAbsolute(p) ? path13.relative(cwd, p) : p;
+  return path14.isAbsolute(p) ? path14.relative(cwd, p) : p;
 }
 function detectPlaceholders(content) {
   const patterns = [
@@ -11087,7 +11129,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
     const placeholderContext = {
       projectName: config.projectName,
       featureName: f.slug,
-      featurePath: f.docs.featurePathFromDocs || path13.relative(config.docsDir, f.path),
+      featurePath: f.docs.featurePathFromDocs || path14.relative(config.docsDir, f.path),
       repoType: f.type,
       featureNumber
     };
@@ -11097,7 +11139,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       "tasks.md"
     ];
     for (const file of files) {
-      const fullPath = path13.join(f.path, file);
+      const fullPath = path14.join(f.path, file);
       if (!await fs.pathExists(fullPath)) continue;
       const original = await fs.readFile(fullPath, "utf-8");
       let next = original;
@@ -11150,7 +11192,7 @@ async function checkDocsStructure(config, cwd) {
   const issues = [];
   const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
   for (const dir of requiredDirs) {
-    const p = path13.join(config.docsDir, dir);
+    const p = path14.join(config.docsDir, dir);
     if (!await fs.pathExists(p)) {
       issues.push({
         level: "error",
@@ -11162,7 +11204,7 @@ async function checkDocsStructure(config, cwd) {
       });
     }
   }
-  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path14.join(config.docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     issues.push({
       level: "warn",
@@ -11190,7 +11232,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   }
   const idMap = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const rel = f.docs.featurePathFromDocs || path13.relative(config.docsDir, f.path);
+    const rel = f.docs.featurePathFromDocs || path14.relative(config.docsDir, f.path);
     const id = f.id || "UNKNOWN";
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(rel);
@@ -11198,7 +11240,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 = path13.join(f.path, file);
+        const p = path14.join(f.path, file);
         if (!await fs.pathExists(p)) continue;
         const content = await fs.readFile(p, "utf-8");
         const placeholders = detectPlaceholders(content);
@@ -11213,7 +11255,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         });
       }
       if (decisionsPlaceholderMode !== "off") {
-        const decisionsPath = path13.join(f.path, "decisions.md");
+        const decisionsPath = path14.join(f.path, "decisions.md");
         if (await fs.pathExists(decisionsPath)) {
           const content = await fs.readFile(decisionsPath, "utf-8");
           const placeholders = detectPlaceholders(content);
@@ -11242,7 +11284,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, path13.join(f.path, "spec.md"))
+        path: formatPath(cwd, path14.join(f.path, "spec.md"))
       });
     }
     if (f.docs.planExists && !f.planStatus && !isInitialTemplateState) {
@@ -11250,7 +11292,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, path13.join(f.path, "plan.md"))
+        path: formatPath(cwd, path14.join(f.path, "plan.md"))
       });
     }
     if (f.docs.tasksExists && f.tasks.total === 0 && !isInitialTemplateState) {
@@ -11258,11 +11300,11 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_empty",
         message: tr(config.lang, "cli", "doctor.issue.tasksEmpty"),
-        path: formatPath(cwd, path13.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path14.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists) {
-      const tasksPath = path13.join(f.path, "tasks.md");
+      const tasksPath = path14.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))
@@ -11284,7 +11326,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, path13.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path14.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && f.docs.tasksDocStatusFieldExists && !f.tasksDocStatus && !isInitialTemplateState) {
@@ -11292,7 +11334,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, path13.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path14.join(f.path, "tasks.md"))
       });
     }
   }
@@ -11316,7 +11358,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, path13.join(config.docsDir, p))
+      path: formatPath(cwd, path14.join(config.docsDir, p))
     });
   }
   return issues;
@@ -11447,7 +11489,7 @@ function doctorCommand(program2) {
       }
       console.log();
       console.log(chalk9.bold(tr(lang, "cli", "doctor.title")));
-      console.log(chalk9.gray(`- Docs: ${path13.relative(cwd, docsDir)}`));
+      console.log(chalk9.gray(`- Docs: ${path14.relative(cwd, docsDir)}`));
       console.log(chalk9.gray(`- Type: ${projectType}`));
       console.log(chalk9.gray(`- Lang: ${lang}`));
       console.log();
@@ -11628,7 +11670,7 @@ async function runView(featureName, options) {
   }
   console.log();
   console.log(chalk9.bold("\u{1F4CA} Workflow View"));
-  console.log(chalk9.gray(`- Docs: ${path13.relative(cwd, config.docsDir)}`));
+  console.log(chalk9.gray(`- Docs: ${path14.relative(cwd, config.docsDir)}`));
   console.log(
     chalk9.gray(
       `- Features: ${state.features.length} (open ${state.openFeatures.length} / done ${state.doneFeatures.length})`
@@ -11713,13 +11755,13 @@ function normalizeRunId(raw) {
   return value;
 }
 function getFlowRunBaseDir(cwd) {
-  return path13.join(getRuntimeStateDir(cwd), "flow-runs");
+  return path14.join(getRuntimeStateDir(cwd), "flow-runs");
 }
 function getFlowRunPath(cwd, runId) {
-  return path13.join(getFlowRunBaseDir(cwd), `${runId}.json`);
+  return path14.join(getFlowRunBaseDir(cwd), `${runId}.json`);
 }
 function getFlowRunLockPath(cwd, runId) {
-  return path13.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
+  return path14.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
 }
 async function readFlowRunRecordUnsafe(cwd, runId) {
   const normalized = normalizeRunId(runId);
@@ -11745,7 +11787,7 @@ async function readFlowRunRecordUnsafe(cwd, runId) {
 }
 async function writeFlowRunRecord(cwd, record) {
   const filePath = getFlowRunPath(cwd, record.runId);
-  await fs.ensureDir(path13.dirname(filePath));
+  await fs.ensureDir(path14.dirname(filePath));
   await fs.writeJson(filePath, record, { spaces: 2 });
 }
 async function createFlowRunRecord(cwd, input) {
@@ -11895,6 +11937,7 @@ function toCompactAutoRun(autoRun) {
     iterations: autoRun.iterations,
     executionCount: autoRun.executions.length,
     lastExecution,
+    delegated: autoRun.delegated ?? null,
     gate: autoRun.gate ?? null,
     manual: autoRun.manual ?? null,
     resume: autoRun.resume,
@@ -11939,6 +11982,7 @@ function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
     pauseAndReportWhen: [
       "approvalRequest.required=true",
       "AUTO_GATE_REACHED",
+      "AUTO_DELEGATED_HANDOFF",
       "AUTO_MANUAL_REQUIRED",
       "command execution error"
     ],
@@ -12164,6 +12208,7 @@ function resolveAutoMode(config, options, requestText) {
 }
 function toAutoReasonCode(status) {
   const map = {
+    delegated_handoff: "AUTO_DELEGATED_HANDOFF",
     gate_reached: "AUTO_GATE_REACHED",
     manual_required: "AUTO_MANUAL_REQUIRED",
     no_action_options: "AUTO_NO_ACTION_OPTIONS",
@@ -12187,6 +12232,7 @@ function isAutoRunFailureStatus(status) {
 }
 function toFlowRunStatus(status) {
   switch (status) {
+    case "delegated_handoff":
     case "gate_reached":
     case "manual_required":
       return "paused";
@@ -12201,6 +12247,17 @@ function toFlowRunStatus(status) {
       return "failed";
   }
 }
+function isTaskCommitCheckpointOption(option, state) {
+  if (!option || state.status !== "single_matched" || !state.matchedFeature) {
+    return false;
+  }
+  if (state.matchedFeature.currentSubstateId !== "task_commit_pending") {
+    return false;
+  }
+  if (option.action.type !== "command") return false;
+  if (option.action.category === "docs_commit") return true;
+  return option.action.category === "task_execute" && option.action.scope === "project" && /\bgit\s+commit\b/i.test(option.action.cmd);
+}
 async function runAutoUntilCategory(config, featureName, selectionOptions, untilCategories, requestText, metadata) {
   const contextArgs = [
     "context",
@@ -12378,6 +12435,29 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
         manual: null
       };
     }
+    const taskCommitCheckpoint = actionOptions.find(
+      (option) => isTaskCommitCheckpointOption(option, state)
+    );
+    if (taskCommitCheckpoint) {
+      return {
+        enabled: true,
+        untilCategories,
+        request: requestText,
+        preset: metadata?.preset ?? null,
+        source: metadata?.source ?? null,
+        resume,
+        status: "manual_required",
+        reasonCode: toAutoReasonCode("manual_required"),
+        iterations,
+        executions,
+        gate: null,
+        manual: {
+          label: taskCommitCheckpoint.label,
+          category: taskCommitCheckpoint.action.category,
+          detail: taskCommitCheckpoint.detail
+        }
+      };
+    }
     const executable = actionOptions.find(
       (option) => option.action.type === "command"
     );
@@ -12463,16 +12543,18 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
         preset: metadata?.preset ?? null,
         source: metadata?.source ?? null,
         resume,
-        status: "manual_required",
-        reasonCode: toAutoReasonCode("manual_required"),
+        status: "delegated_handoff",
+        reasonCode: toAutoReasonCode("delegated_handoff"),
         iterations,
         executions,
-        gate: null,
-        manual: {
+        delegated: {
           label: executable.label,
           category: executable.action.category,
-          detail: typeof executeResult?.nextMainState === "string" ? `Complete the delegated handoff work, then continue from ${executeResult.nextMainState}.` : executable.detail
-        }
+          detail: typeof executeResult?.nextMainState === "string" ? `Complete the delegated handoff work, then continue from ${executeResult.nextMainState}.` : executable.detail,
+          nextMainState: executeResult?.nextMainState
+        },
+        gate: null,
+        manual: null
       };
     }
     if (executeResult?.status !== "approved_executed") {
@@ -12663,6 +12745,20 @@ async function runFlow(featureName, options) {
       "`--request` requires auto mode. Use `--auto-until-category`, `--auto-preset`, or configure `workflow.auto.defaultPreset`."
     );
   }
+  if (autoMode && !resolvedFeatureName && requestText) {
+    const bootstrapped = await bootstrapFeatureFromIdeaRequest(
+      config,
+      requestText,
+      selectedComponent
+    );
+    if (bootstrapped) {
+      resolvedFeatureName = bootstrapped.featureRef;
+      if (!selectedComponent && bootstrapped.component) {
+        selectedComponent = bootstrapped.component;
+        selectionOptions.component = bootstrapped.component;
+      }
+    }
+  }
   if (autoMode && !featureName) {
     if (!resolvedFeatureName) {
       throw createCliError(
@@ -12757,7 +12853,8 @@ async function runFlow(featureName, options) {
         },
         lastAutoStatus: autoRun.status,
         lastReasonCode: autoRun.reasonCode,
-        lastError: autoRun.error
+        lastError: autoRun.error,
+        lastDelegatedHandoff: autoRun.delegated ?? null
       })
     );
     autoRun.run = {
@@ -12943,6 +13040,45 @@ async function runFlow(featureName, options) {
   );
   console.log();
 }
+async function bootstrapFeatureFromIdeaRequest(config, requestText, selectedComponent) {
+  const ideaRef = extractExplicitIdeaRef(requestText);
+  if (!ideaRef) return null;
+  const resolvedIdea = await resolveIdeaReference(
+    config.docsDir,
+    ideaRef,
+    config.lang
+  );
+  const existingFeatureRef = await readIdeaMetadataValue(
+    resolvedIdea.path,
+    "Feature"
+  );
+  if (existingFeatureRef && existingFeatureRef !== "-") {
+    return { featureRef: existingFeatureRef, component: selectedComponent };
+  }
+  let component = selectedComponent;
+  if (config.projectType === "multi" && !component) {
+    const ideaComponent = await readIdeaMetadataValue(
+      resolvedIdea.path,
+      "Component"
+    );
+    if (ideaComponent && ideaComponent !== "-" && ideaComponent !== "all") {
+      component = ideaComponent.toLowerCase();
+    } else {
+      return null;
+    }
+  }
+  const featureName = await deriveFeatureNameFromIdea(resolvedIdea.path);
+  const result = await runFeature(featureName, {
+    component,
+    idea: ideaRef,
+    nonInteractive: true,
+    json: true
+  });
+  return {
+    featureRef: `${result.featureId}-${result.featureName}`,
+    component
+  };
+}
 function runProcess(bin, args, cwd) {
   const result = spawnSync(bin, args, {
     cwd,
@@ -13056,27 +13192,27 @@ function tg(lang, key, vars = {}) {
 function detectGithubCliLangSync(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const startDirs = [
-    explicitDocsDir ? path13.resolve(explicitDocsDir) : "",
-    path13.resolve(cwd)
+    explicitDocsDir ? path14.resolve(explicitDocsDir) : "",
+    path14.resolve(cwd)
   ].filter(Boolean);
   const scanOrder = [];
   const seen = /* @__PURE__ */ new Set();
   for (const start of startDirs) {
     let current = start;
     while (true) {
-      const abs = path13.resolve(current);
+      const abs = path14.resolve(current);
       if (!seen.has(abs)) {
         scanOrder.push(abs);
         seen.add(abs);
       }
-      const parent = path13.dirname(abs);
+      const parent = path14.dirname(abs);
       if (parent === abs) break;
       current = parent;
     }
   }
   for (const base of scanOrder) {
-    for (const docsDir of [path13.join(base, "docs"), base]) {
-      const configPath = path13.join(docsDir, ".lee-spec-kit.json");
+    for (const docsDir of [path14.join(base, "docs"), base]) {
+      const configPath = path14.join(docsDir, ".lee-spec-kit.json");
       if (fs.existsSync(configPath)) {
         try {
           const parsed = fs.readJsonSync(configPath);
@@ -13085,11 +13221,11 @@ function detectGithubCliLangSync(cwd) {
         } catch {
         }
       }
-      const agentsPath = path13.join(docsDir, "agents");
-      const featuresPath = path13.join(docsDir, "features");
+      const agentsPath = path14.join(docsDir, "agents");
+      const featuresPath = path14.join(docsDir, "features");
       if (!fs.existsSync(agentsPath) || !fs.existsSync(featuresPath)) continue;
       for (const probe of ["custom.md", "constitution.md", "agents.md"]) {
-        const file = path13.join(agentsPath, probe);
+        const file = path14.join(agentsPath, probe);
         if (!fs.existsSync(file)) continue;
         try {
           const content = fs.readFileSync(file, "utf-8");
@@ -13109,13 +13245,13 @@ function parseLabels(raw, lang) {
   }
   return [...new Set(labels)];
 }
-function escapeRegExp4(value) {
+function escapeRegExp5(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractDraftMetadataValue(content, keys) {
   for (const key of keys) {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp4(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp5(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
       "mi"
     );
     const match = content.match(re);
@@ -13194,7 +13330,7 @@ async function prepareGithubBody(params) {
       };
     }
   }
-  await fs.ensureDir(path13.dirname(defaultBodyFile));
+  await fs.ensureDir(path14.dirname(defaultBodyFile));
   await fs.writeFile(defaultBodyFile, generatedBody, "utf-8");
   return {
     body: generatedBody,
@@ -13234,7 +13370,7 @@ function ensureSections(body, sections, kind, lang) {
   };
   const hasMetadataField = (field) => {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp4(field)}\\*\\*\\s*:`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp5(field)}\\*\\*\\s*:`,
       "m"
     );
     return re.test(body);
@@ -13264,7 +13400,7 @@ function ensureSections(body, sections, kind, lang) {
 }
 function ensureDocsExist(docsDir, relativePaths, lang) {
   const missing = relativePaths.filter(
-    (relativePath) => !fs.existsSync(path13.join(docsDir, relativePath))
+    (relativePath) => !fs.existsSync(path14.join(docsDir, relativePath))
   );
   if (missing.length > 0) {
     throw createCliError(
@@ -13274,18 +13410,18 @@ function ensureDocsExist(docsDir, relativePaths, lang) {
   }
 }
 function buildDefaultBodyFileName(kind, docsDir, component) {
-  const key = `${path13.resolve(docsDir)}::${component.trim().toLowerCase()}`;
+  const key = `${path14.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() || path13.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
+  const selected = raw?.trim() || path14.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
   assertValid(
     validatePathWithLang(selected, lang),
     `github.${kind}.bodyFile`,
     lang
   );
-  return path13.resolve(selected);
+  return path14.resolve(selected);
 }
 function toProjectRootDocsPath(relativePathFromDocs) {
   const normalized = relativePathFromDocs.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
@@ -14122,7 +14258,7 @@ function stripMarkdownCodeContexts(body) {
 function hasIssueClosingKeyword(body, issueNumber) {
   if (!issueNumber) return false;
   const cleaned = stripMarkdownCodeContexts(body);
-  const issue = escapeRegExp4(issueNumber);
+  const issue = escapeRegExp5(issueNumber);
   const closeKeywordRegex = new RegExp(
     `\\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\\b\\s*(?:[a-zA-Z0-9_.-]+\\/)?#\\s*${issue}\\b`,
     "i"
@@ -14340,7 +14476,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) => path13.relative(cwd, absPath) || absPath)
+      absPaths.filter((absPath) => !!absPath && fs.existsSync(absPath)).map((absPath) => path14.relative(cwd, absPath) || absPath)
     )
   ];
   if (uniqueRelativePaths.length === 0) return;
@@ -14536,15 +14672,15 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path13.join(config.docsDir, paths.specPath),
+          path14.join(config.docsDir, paths.specPath),
           "utf-8"
         );
         const planContent = await fs.readFile(
-          path13.join(config.docsDir, paths.planPath),
+          path14.join(config.docsDir, paths.planPath),
           "utf-8"
         );
         const tasksContent = await fs.readFile(
-          path13.join(config.docsDir, paths.tasksPath),
+          path14.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -14587,7 +14723,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path13.join(config.docsDir, paths.issuePath),
+          workflowDraftPath: path14.join(config.docsDir, paths.issuePath),
           generatedBody,
           requiredSections: getRequiredIssueSections(config.lang),
           kindLabel: tg(config.lang, "kindIssue"),
@@ -14603,7 +14739,7 @@ function githubCommand(program2) {
             `${feature.type}-issue-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path13.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path14.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -14652,12 +14788,12 @@ function githubCommand(program2) {
           const syncedIssueNumber = extractIssueNumberFromUrl(issueUrl);
           if (syncedIssueNumber) {
             const synced = syncTasksIssueMetadata(
-              path13.join(config.docsDir, paths.tasksPath),
+              path14.join(config.docsDir, paths.tasksPath),
               syncedIssueNumber,
               config.lang
             );
             const draftSynced = syncIssueDraftMetadata(
-              path13.join(config.docsDir, paths.issuePath),
+              path14.join(config.docsDir, paths.issuePath),
               syncedIssueNumber
             );
             syncChanged = synced.changed || draftSynced.changed;
@@ -14768,13 +14904,13 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path13.join(config.docsDir, paths.specPath),
+          path14.join(config.docsDir, paths.specPath),
           "utf-8"
         );
-        const planPath = path13.join(config.docsDir, paths.planPath);
+        const planPath = path14.join(config.docsDir, paths.planPath);
         const planContent = await fs.pathExists(planPath) ? await fs.readFile(planPath, "utf-8") : "";
         const tasksContent = await fs.readFile(
-          path13.join(config.docsDir, paths.tasksPath),
+          path14.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -14822,7 +14958,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path13.join(config.docsDir, paths.prPath),
+          workflowDraftPath: path14.join(config.docsDir, paths.prPath),
           generatedBody,
           requiredSections: getRequiredPrSections(config.lang),
           kindLabel: tg(config.lang, "kindPr"),
@@ -14840,7 +14976,7 @@ function githubCommand(program2) {
             `${feature.type}-pr-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path13.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path14.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -14868,7 +15004,7 @@ function githubCommand(program2) {
             if (preparedBody.source === "generated") {
               await fs.writeFile(bodyFile, body, "utf-8");
             } else {
-              await fs.ensureDir(path13.dirname(fallbackBodyFile));
+              await fs.ensureDir(path14.dirname(fallbackBodyFile));
               await fs.writeFile(fallbackBodyFile, body, "utf-8");
               bodyFile = fallbackBodyFile;
             }
@@ -14929,13 +15065,13 @@ function githubCommand(program2) {
         }
         if (prUrl && options.syncTasks !== false) {
           const syncedTasks = syncTasksPrMetadata(
-            path13.join(config.docsDir, paths.tasksPath),
+            path14.join(config.docsDir, paths.tasksPath),
             prUrl,
             "Review",
             config.lang
           );
           const syncedDraft = syncPrDraftMetadata(
-            path13.join(config.docsDir, paths.prPath),
+            path14.join(config.docsDir, paths.prPath),
             prUrl,
             "Review"
           );
@@ -14976,13 +15112,13 @@ function githubCommand(program2) {
           mergeAlreadyMerged = merged.alreadyMerged;
           if (prUrl && options.syncTasks !== false) {
             const mergedTasksSync = syncTasksPrMetadata(
-              path13.join(config.docsDir, paths.tasksPath),
+              path14.join(config.docsDir, paths.tasksPath),
               prUrl,
               "Approved",
               config.lang
             );
             const mergedDraftSync = syncPrDraftMetadata(
-              path13.join(config.docsDir, paths.prPath),
+              path14.join(config.docsDir, paths.prPath),
               prUrl,
               "Approved"
             );
@@ -15253,7 +15389,7 @@ function docsCommand(program2) {
         );
         return;
       }
-      const relativeFromCwd = path13.relative(process.cwd(), loaded.entry.absolutePath);
+      const relativeFromCwd = path14.relative(process.cwd(), loaded.entry.absolutePath);
       console.log();
       console.log(chalk9.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
       console.log(
@@ -15333,7 +15469,7 @@ function detectCommand(program2) {
 }
 async function runDetect(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path13.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path14.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   const detected = !!config;
   const reasonCode = detected ? "PROJECT_DETECTED" : "PROJECT_NOT_DETECTED";
@@ -15360,7 +15496,7 @@ async function runDetect(options) {
       );
       return;
     }
-    const configPath2 = path13.join(config.docsDir, ".lee-spec-kit.json");
+    const configPath2 = path14.join(config.docsDir, ".lee-spec-kit.json");
     const configFilePresent2 = await fs.pathExists(configPath2);
     const detectionSource2 = configFilePresent2 ? "config" : "heuristic";
     console.log(
@@ -15394,7 +15530,7 @@ async function runDetect(options) {
     console.log();
     return;
   }
-  const configPath = path13.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path14.join(config.docsDir, ".lee-spec-kit.json");
   const configFilePresent = await fs.pathExists(configPath);
   const detectionSource = configFilePresent ? "config" : "heuristic";
   console.log(chalk9.green(`- ${tr(lang, "cli", "detect.resultDetected")}`));
@@ -15471,19 +15607,19 @@ function hasTemplateMarkers(content) {
   return patterns.some((pattern) => pattern.test(content));
 }
 async function countFeatureDirs(ctx, docsDir, projectType) {
-  const featuresRoot = path13.join(docsDir, "features");
+  const featuresRoot = path14.join(docsDir, "features");
   if (projectType === "single") {
     const dirs = await listSubdirectories(ctx.fs, featuresRoot);
-    return dirs.filter((value) => path13.basename(value) !== "feature-base").length;
+    return dirs.filter((value) => path14.basename(value) !== "feature-base").length;
   }
   const components = await listSubdirectories(ctx.fs, featuresRoot);
   let total = 0;
   for (const componentDir of components) {
-    const componentName = path13.basename(componentDir).trim().toLowerCase();
+    const componentName = path14.basename(componentDir).trim().toLowerCase();
     if (!componentName || componentName === "feature-base") continue;
     const dirs = await listSubdirectories(ctx.fs, componentDir);
     total += dirs.filter(
-      (value) => path13.basename(value) !== "feature-base"
+      (value) => path14.basename(value) !== "feature-base"
     ).length;
   }
   return total;
@@ -15495,7 +15631,7 @@ async function hasUserPrdFile(ctx, prdDir) {
     ignoreDirs: ["node_modules"]
   });
   return files.some(
-    (absolutePath) => path13.basename(absolutePath).toLowerCase() !== "readme.md"
+    (absolutePath) => path14.basename(absolutePath).toLowerCase() !== "readme.md"
   );
 }
 function finalizeChecks(checks) {
@@ -15664,7 +15800,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const constitutionPath = path13.join(docsDir, "agents", "constitution.md");
+  const constitutionPath = path14.join(docsDir, "agents", "constitution.md");
   if (!await fs.pathExists(constitutionPath)) {
     checks.push({
       id: "constitution_exists",
@@ -15706,7 +15842,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const customPath = path13.join(docsDir, "agents", "custom.md");
+  const customPath = path14.join(docsDir, "agents", "custom.md");
   if (await fs.pathExists(customPath)) {
     const content = await fs.readFile(customPath, "utf-8");
     if (hasTemplateMarkers(content)) {
@@ -15735,7 +15871,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const prdDir = path13.join(docsDir, "prd");
+  const prdDir = path14.join(docsDir, "prd");
   const featureCount = await countFeatureDirs(ctx, docsDir, config.projectType);
   const prdReady = await hasUserPrdFile(ctx, prdDir);
   if (!prdReady) {
@@ -15753,7 +15889,7 @@ async function runOnboardChecks(ctx) {
         "PRD is empty. If features already exist, fill PRD as soon as possible."
       ),
       path: prdDir,
-      suggestedCommand: `touch ${quotePath(path13.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
+      suggestedCommand: `touch ${quotePath(path14.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
     });
   } else {
     checks.push({
@@ -16191,7 +16327,7 @@ var PrePrReviewValidator = class {
     return result.evidence;
   }
   async validateEvidenceWithScope(evidencePath, projectRoot) {
-    const fullPath = path13.resolve(evidencePath);
+    const fullPath = path14.resolve(evidencePath);
     if (!await fs.pathExists(fullPath)) {
       throw createCliError(
         "INVALID_ARGUMENT",
@@ -16289,9 +16425,9 @@ var PrePrReviewValidator = class {
     ]);
     const reviewedFiles = new Set(
       normalizedEvidence.files.map(
-        (f) => path13.relative(
+        (f) => path14.relative(
           projectRoot,
-          path13.resolve(projectRoot, f.path)
+          path14.resolve(projectRoot, f.path)
         )
       ).map((entry) => normalizeGitPath3(entry)).filter(Boolean)
     );
@@ -16487,7 +16623,7 @@ var DEFAULT_EVIDENCE_FOR_ANY_MODE = {
   residualRisks: ["none"],
   commandsExecuted: []
 };
-function escapeRegExp5(value) {
+function escapeRegExp6(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function normalizeDecision(raw) {
@@ -16501,14 +16637,14 @@ function normalizeDecision(raw) {
   return null;
 }
 function findSpecLineIndex(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 replaceSpecLine(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*)(.*)$`
   );
@@ -16752,7 +16888,7 @@ async function runPrePrReviewRun(featureName, options) {
   );
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
-  const tasksPath = path13.join(feature.path, "tasks.md");
+  const tasksPath = path14.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -16799,8 +16935,6 @@ async function runPrePrReviewRun(featureName, options) {
           handoffOnly: true,
           advancesWorkflow: false,
           reuseKey: `pre-pr:${featureRef}`,
-          suggestedParallelism: 1,
-          fallbackToMainAgentWhenQuotaExceeded: true,
           nextStepRequirement: "generate_review_trace_then_record",
           delegatedWorkRequired: true,
           nextMainState: "pre_pr_review_in_progress",
@@ -16863,7 +16997,7 @@ async function runPrePrReview(featureName, options) {
       `tasks.md not found for feature: ${feature.folderName}`
     );
   }
-  const tasksPath = path13.join(feature.path, "tasks.md");
+  const tasksPath = path14.join(feature.path, "tasks.md");
   const tasksContent = await fs.readFile(tasksPath, "utf-8");
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
@@ -16961,7 +17095,7 @@ async function runPrePrReview(featureName, options) {
       }
     }
   }
-  const decisionsPath = path13.join(feature.path, "decisions.md");
+  const decisionsPath = path14.join(feature.path, "decisions.md");
   const decisionLogEntry = buildReportContent({
     folderName: feature.folderName,
     date,
@@ -16977,9 +17111,9 @@ async function runPrePrReview(featureName, options) {
     await fs.writeFile(decisionsPath, nextDecisions, "utf-8");
   }
   const decisionsPathFromDocs = normalizePathForDoc(
-    path13.join(feature.docs.featurePathFromDocs, "decisions.md")
+    path14.join(feature.docs.featurePathFromDocs, "decisions.md")
   );
-  const evidencePath = path13.basename(config.docsDir) === "docs" ? normalizePathForDoc(path13.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
+  const evidencePath = path14.basename(config.docsDir) === "docs" ? normalizePathForDoc(path14.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
   let nextTasks = tasksContent;
   nextTasks = upsertSpecLine(
     nextTasks,
@@ -17034,18 +17168,18 @@ async function runPrePrReview(featureName, options) {
   }
   console.log();
 }
-function escapeRegExp6(value) {
+function escapeRegExp7(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function findSpecLineIndex2(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
   );
   return lines.findIndex((line) => re.test(line));
 }
 function replaceSpecLine2(line, keys, preferredKey, value) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -17120,7 +17254,7 @@ async function runCodeReviewRun(featureName, options) {
     );
   }
   const feature = state.matchedFeature;
-  const tasksPath = path13.join(feature.path, "tasks.md");
+  const tasksPath = path14.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -17150,12 +17284,10 @@ async function runCodeReviewRun(featureName, options) {
     handoffOnly: true,
     advancesWorkflow: false,
     reuseKey: `code-review:${feature.folderName}`,
-    suggestedParallelism: 1,
-    fallbackToMainAgentWhenQuotaExceeded: true,
     nextMainState: "code_review_running",
     tasksUpdated,
     tasksPath,
-    decisionsPath: path13.join(feature.path, "decisions.md"),
+    decisionsPath: path14.join(feature.path, "decisions.md"),
     prompt,
     recordedAt: getLocalDateString()
   };
@@ -17173,12 +17305,6 @@ async function runCodeReviewRun(featureName, options) {
   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(
-    chalk9.gray(
-      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
-    )
-  );
   console.log(chalk9.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
     console.log(chalk9.gray(`- tasks.md updated: ${payload.tasksPath}`));
@@ -17280,7 +17406,7 @@ async function runRequirements(options) {
   }
   for (const feature of scan.features) {
     if (!feature.docs.tasksExists) continue;
-    const tasksPath = path13.join(feature.path, "tasks.md");
+    const tasksPath = path14.join(feature.path, "tasks.md");
     let tasksContent = "";
     try {
       tasksContent = await ctx.fs.readFile(tasksPath, "utf-8");
@@ -17414,7 +17540,7 @@ async function runRequirements(options) {
   process.stdout.write(`${lines.join("\n")}
 `);
   if (options.write) {
-    const outputPath = path13.join(docsDir, "prd", "status.md");
+    const outputPath = path14.join(docsDir, "prd", "status.md");
     await ctx.fs.writeFile(outputPath, `${lines.join("\n")}
 `, "utf-8");
     console.log(chalk9.green(`\u2705 wrote: ${outputPath}`));
@@ -17499,7 +17625,7 @@ async function resolveTaskRunContext(featureName, options) {
 }
 async function runTaskRun(featureName, options) {
   const { config, feature } = await resolveTaskRunContext(featureName, options);
-  const tasksPath = path13.join(feature.path, "tasks.md");
+  const tasksPath = path14.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -17556,8 +17682,6 @@ async function runTaskRun(featureName, options) {
     owner: "subagent",
     handoffOnly: true,
     reuseKey: `task:${feature.folderName}:${resolvedTask.taskId}`,
-    suggestedParallelism: 1,
-    fallbackToMainAgentWhenQuotaExceeded: true,
     nextMainState: "task_complete",
     tasksUpdated,
     tasksPath,
@@ -17573,12 +17697,6 @@ async function runTaskRun(featureName, options) {
   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(
-    chalk9.gray(
-      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
-    )
-  );
   console.log(chalk9.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
     console.log();
@@ -17658,7 +17776,7 @@ async function resolveTaskCompleteContext(featureName, options) {
 }
 async function runTaskComplete(featureName, options) {
   const { feature } = await resolveTaskCompleteContext(featureName, options);
-  const tasksPath = path13.join(feature.path, "tasks.md");
+  const tasksPath = path14.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -17797,11 +17915,11 @@ ${version}
   }
   return `${ascii}${footer}`;
 }
-var CACHE_FILE = path13.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+var CACHE_FILE = path14.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path13.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path14.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       return pkg.version;
@@ -17905,7 +18023,7 @@ function shouldCheckForUpdates() {
 if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
-    const packageJsonPath = path13.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path14.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);