@kody-ade/kody-engine-lite 0.1.125 → 0.1.126

package/dist/bin/cli.js

@@ -180,8 +180,8 @@ var init_validators = __esm({
 });
 
 // src/config.ts
-import * as fs7 from "fs";
-import * as path6 from "path";
+import * as fs8 from "fs";
+import * as path7 from "path";
 function resolveStageConfig(config, stageName, modelTier) {
   const stageOverride = config.agent.stages?.[stageName];
   if (stageOverride) return stageOverride;
@@ -225,10 +225,10 @@ function setConfigDir(dir) {
 }
 function getProjectConfig() {
   if (_config) return _config;
-  const configPath = path6.join(_configDir ?? process.cwd(), "kody.config.json");
-  if (fs7.existsSync(configPath)) {
+  const configPath = path7.join(_configDir ?? process.cwd(), "kody.config.json");
+  if (fs8.existsSync(configPath)) {
     try {
-      const result2 = parseJsonSafe(fs7.readFileSync(configPath, "utf-8"));
+      const result2 = parseJsonSafe(fs8.readFileSync(configPath, "utf-8"));
       if (!result2.ok) {
         logger.warn(`kody.config.json: ${result2.error} \u2014 using defaults`);
         _config = { ...DEFAULT_CONFIG };
@@ -304,22 +304,22 @@ var init_config = __esm({
 // src/agent-runner.ts
 import { spawn, execFileSync as execFileSync6 } from "child_process";
 function writeStdin(child, prompt) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     if (!child.stdin) {
-      resolve5();
+      resolve6();
       return;
     }
     child.stdin.write(prompt, (err) => {
       if (err) reject(err);
       else {
         child.stdin.end();
-        resolve5();
+        resolve6();
       }
     });
   });
 }
 function waitForProcess(child, timeout) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const stdoutChunks = [];
     const stderrChunks = [];
     child.stdout?.on("data", (chunk) => stdoutChunks.push(chunk));
@@ -332,7 +332,7 @@ function waitForProcess(child, timeout) {
     }, timeout);
     child.on("exit", (code) => {
       clearTimeout(timer);
-      resolve5({
+      resolve6({
         code,
         stdout: Buffer.concat(stdoutChunks).toString(),
         stderr: Buffer.concat(stderrChunks).toString()
@@ -340,7 +340,7 @@ function waitForProcess(child, timeout) {
     });
     child.on("error", (err) => {
       clearTimeout(timer);
-      resolve5({ code: -1, stdout: "", stderr: err.message });
+      resolve6({ code: -1, stdout: "", stderr: err.message });
     });
   });
 }
@@ -934,7 +934,7 @@ var init_github_api = __esm({
     "use strict";
     init_logger();
     API_TIMEOUT_MS = 3e4;
-    LIFECYCLE_LABELS = ["planning", "building", "review", "shipping", "done", "failed", "waiting", "low", "medium", "high"];
+    LIFECYCLE_LABELS = ["backlog", "planning", "building", "verifying", "review", "fixing", "shipping", "done", "failed", "waiting", "low", "medium", "high"];
     KODY_MARKERS = [
       "Kody Review",
       "\u{1F916} Generated by Kody",
@@ -949,13 +949,13 @@ var init_github_api = __esm({
 });
 
 // src/cli/task-resolution.ts
-import * as fs9 from "fs";
-import * as path8 from "path";
+import * as fs10 from "fs";
+import * as path9 from "path";
 import { execFileSync as execFileSync8 } from "child_process";
 function findLatestTaskForIssue(issueNumber, projectDir) {
-  const tasksDir = path8.join(projectDir, ".kody", "tasks");
-  if (!fs9.existsSync(tasksDir)) return null;
-  const allDirs = fs9.readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
+  const tasksDir = path9.join(projectDir, ".kody", "tasks");
+  if (!fs10.existsSync(tasksDir)) return null;
+  const allDirs = fs10.readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
   const prefix = `${issueNumber}-`;
   const direct = allDirs.find((d) => d.startsWith(prefix));
   if (direct) return direct;
@@ -999,14 +999,14 @@ function resolveTaskIdFromComments(issueNumber) {
   }
 }
 function findPausedTaskifyForIssue(issueNumber, projectDir) {
-  const tasksDir = path8.join(projectDir, ".kody", "tasks");
-  if (!fs9.existsSync(tasksDir)) return null;
-  const allDirs = fs9.readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
+  const tasksDir = path9.join(projectDir, ".kody", "tasks");
+  if (!fs10.existsSync(tasksDir)) return null;
+  const allDirs = fs10.readdirSync(tasksDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort().reverse();
   for (const dir of allDirs) {
-    const markerPath = path8.join(tasksDir, dir, "taskify.marker");
-    if (!fs9.existsSync(markerPath)) continue;
+    const markerPath = path9.join(tasksDir, dir, "taskify.marker");
+    if (!fs10.existsSync(markerPath)) continue;
     try {
-      const marker = JSON.parse(fs9.readFileSync(markerPath, "utf-8"));
+      const marker = JSON.parse(fs10.readFileSync(markerPath, "utf-8"));
       if (marker.issueNumber === issueNumber) return dir;
     } catch {
     }
@@ -1030,9 +1030,9 @@ var init_task_resolution = __esm({
 });
 
 // src/cli/litellm.ts
-import * as fs10 from "fs";
+import * as fs11 from "fs";
 import * as os from "os";
-import * as path9 from "path";
+import * as path10 from "path";
 import { execFileSync as execFileSync9 } from "child_process";
 async function checkLitellmHealth(url) {
   try {
@@ -1132,8 +1132,8 @@ async function tryStartLitellm(url, projectDir, generatedConfig) {
     logger.warn("No provider configured in kody.config.json \u2014 cannot start LiteLLM proxy");
     return null;
   }
-  const configPath = path9.join(os.tmpdir(), "kody-litellm-config.yaml");
-  fs10.writeFileSync(configPath, generatedConfig);
+  const configPath = path10.join(os.tmpdir(), "kody-litellm-config.yaml");
+  fs11.writeFileSync(configPath, generatedConfig);
   const portMatch = url.match(/:(\d+)/);
   const port = portMatch ? portMatch[1] : "4000";
   let litellmFound = false;
@@ -1162,10 +1162,10 @@ async function tryStartLitellm(url, projectDir, generatedConfig) {
     cmd = "python3";
     args2 = ["-m", "litellm", "--config", configPath, "--port", port];
   }
-  const dotenvPath = path9.join(projectDir, ".env");
+  const dotenvPath = path10.join(projectDir, ".env");
   const dotenvVars = {};
-  if (fs10.existsSync(dotenvPath)) {
-    for (const rawLine of fs10.readFileSync(dotenvPath, "utf-8").split("\n")) {
+  if (fs11.existsSync(dotenvPath)) {
+    for (const rawLine of fs11.readFileSync(dotenvPath, "utf-8").split("\n")) {
       const line = rawLine.trim();
       if (!line || line.startsWith("#")) continue;
       const match = line.match(/^([A-Z_][A-Z0-9_]*_API_KEY)=(.*)$/);
@@ -1225,8 +1225,8 @@ __export(taskify_command_exports, {
   taskifyCommand: () => taskifyCommand,
   topoSort: () => topoSort
 });
-import * as fs11 from "fs";
-import * as path10 from "path";
+import * as fs12 from "fs";
+import * as path11 from "path";
 import { fileURLToPath } from "url";
 import { execSync } from "child_process";
 function topoSort(tasks) {
@@ -1270,10 +1270,10 @@ function hasFlag(args2, flag) {
 async function runTaskifyCommand() {
   const args2 = process.argv.slice(3);
   const cwdArg = getArg(args2, "--cwd") ?? process.cwd();
-  const projectDir = path10.resolve(cwdArg);
+  const projectDir = path11.resolve(cwdArg);
   const ticketId = getArg(args2, "--ticket") ?? process.env.TICKET_ID;
   const prdFileArg = getArg(args2, "--file") ?? process.env.PRD_FILE;
-  const prdFile = prdFileArg ? path10.resolve(projectDir, prdFileArg) : void 0;
+  const prdFile = prdFileArg ? path11.resolve(projectDir, prdFileArg) : void 0;
   const issueNumberStr = getArg(args2, "--issue-number") ?? process.env.ISSUE_NUMBER ?? "";
   const issueNumber = issueNumberStr ? parseInt(issueNumberStr, 10) : void 0;
   const feedback = getArg(args2, "--feedback") ?? process.env.FEEDBACK;
@@ -1284,7 +1284,7 @@ async function runTaskifyCommand() {
     logger.error("Usage: kody taskify --ticket <ticket-id>  OR  kody taskify --file <prd.md>  OR  kody taskify --issue-number <n>");
     process.exit(1);
   }
-  if (prdFile && !fs11.existsSync(prdFile)) {
+  if (prdFile && !fs12.existsSync(prdFile)) {
     logger.error(`File not found: ${prdFile}`);
     process.exit(1);
   }
@@ -1325,8 +1325,8 @@ async function runTaskifyCommand() {
 async function taskifyCommand(opts) {
   const { ticketId, prdFile, issueNumber, feedback, local, projectDir, taskId } = opts;
   const config = getProjectConfig();
-  const taskDir = path10.join(projectDir, ".kody", "tasks", taskId);
-  fs11.mkdirSync(taskDir, { recursive: true });
+  const taskDir = path11.join(projectDir, ".kody", "tasks", taskId);
+  fs12.mkdirSync(taskDir, { recursive: true });
   const mode = prdFile ? "file" : ticketId ? "ticket" : "issue";
   logger.info(`[taskify] mode=${mode} source=${ticketId ?? prdFile ?? `issue#${issueNumber}`} issue=${issueNumber ?? "none"} task=${taskId}`);
   let mcpConfigJson;
@@ -1350,7 +1350,7 @@ Add the required MCP server config to \`kody.config.json\` and try again.`
   }
   const sc = resolveStageConfig(config, "taskify", "strong");
   const model = sc.model;
-  const fileContent = prdFile ? fs11.readFileSync(prdFile, "utf-8") : void 0;
+  const fileContent = prdFile ? fs12.readFileSync(prdFile, "utf-8") : void 0;
   let issueBody;
   if (mode === "issue" && issueNumber) {
     const issue = getIssue(issueNumber);
@@ -1366,10 +1366,10 @@ ${issue.body}`;
   let projectContext;
   {
     const parts = [];
-    const memoryPath = path10.join(projectDir, ".kody", "memory.md");
-    if (fs11.existsSync(memoryPath)) {
+    const memoryPath = path11.join(projectDir, ".kody", "memory.md");
+    if (fs12.existsSync(memoryPath)) {
       try {
-        const content = fs11.readFileSync(memoryPath, "utf-8").slice(0, 2e3);
+        const content = fs12.readFileSync(memoryPath, "utf-8").slice(0, 2e3);
         if (content.trim()) parts.push(`### Project Memory
 ${content}`);
       } catch {
@@ -1388,14 +1388,14 @@ ${lines.join("\n")}
   }
   const prompt = buildPrompt({ ticketId, fileContent, issueBody, taskDir, feedback, projectContext });
   if (issueNumber && !local) {
-    const src = mode === "file" ? `file \`${path10.basename(prdFile)}\`` : mode === "ticket" ? `ticket **${ticketId}**` : `issue #${issueNumber} description`;
+    const src = mode === "file" ? `file \`${path11.basename(prdFile)}\`` : mode === "ticket" ? `ticket **${ticketId}**` : `issue #${issueNumber} description`;
     const runUrl = process.env.RUN_URL ? ` ([logs](${process.env.RUN_URL}))` : "";
     postComment(issueNumber, `\u{1F680} Kody pipeline started: \`${taskId}\`${runUrl}
 
 Kody is decomposing ${src} into tasks...`);
     setLifecycleLabel(issueNumber, "planning");
   }
-  fs11.writeFileSync(path10.join(taskDir, MARKER_FILE), JSON.stringify({ ticketId, prdFile, issueNumber }));
+  fs12.writeFileSync(path11.join(taskDir, MARKER_FILE), JSON.stringify({ ticketId, prdFile, issueNumber }));
   const runner = opts.runner ?? createClaudeCodeRunner();
   logger.info(`  model=${model} timeout=${TASKIFY_TIMEOUT_MS / 1e3}s`);
   const result2 = await runner.run("taskify", prompt, model, TASKIFY_TIMEOUT_MS, taskDir, {
@@ -1413,8 +1413,8 @@ Kody is decomposing ${src} into tasks...`);
     }
     throw new TaskifyError(errMsg);
   }
-  const resultPath = path10.join(taskDir, RESULT_FILE);
-  if (!fs11.existsSync(resultPath)) {
+  const resultPath = path11.join(taskDir, RESULT_FILE);
+  if (!fs12.existsSync(resultPath)) {
     const errMsg = `Claude did not write ${RESULT_FILE}. Output:
 
 ${result2.output?.slice(0, 500) ?? "(none)"}`;
@@ -1428,7 +1428,7 @@ ${errMsg}`);
   }
   let parsed;
   try {
-    parsed = JSON.parse(fs11.readFileSync(resultPath, "utf-8"));
+    parsed = JSON.parse(fs12.readFileSync(resultPath, "utf-8"));
   } catch {
     const errMsg = `Could not parse ${RESULT_FILE} as JSON.`;
     if (issueNumber && !local) {
@@ -1437,7 +1437,7 @@ ${errMsg}`);
     }
     throw new TaskifyError(errMsg);
   }
-  const sourceLabel = ticketId ?? (prdFile ? path10.basename(prdFile) : issueNumber ? `issue #${issueNumber}` : "spec");
+  const sourceLabel = ticketId ?? (prdFile ? path11.basename(prdFile) : issueNumber ? `issue #${issueNumber}` : "spec");
   if (parsed.status === "questions") {
     handleQuestions(parsed, sourceLabel, issueNumber, local ?? false);
   } else if (parsed.status === "ready") {
@@ -1537,15 +1537,15 @@ function buildPrompt(opts) {
   const { ticketId, fileContent, issueBody, taskDir, feedback, projectContext } = opts;
   const scriptDir = new URL(".", import.meta.url).pathname;
   const candidates = [
-    path10.resolve(scriptDir, "..", "prompts", "taskify-ticket.md"),
-    path10.resolve(scriptDir, "..", "..", "prompts", "taskify-ticket.md"),
-    path10.resolve(__dirname, "..", "..", "prompts", "taskify-ticket.md"),
-    path10.resolve(__dirname, "..", "prompts", "taskify-ticket.md")
+    path11.resolve(scriptDir, "..", "prompts", "taskify-ticket.md"),
+    path11.resolve(scriptDir, "..", "..", "prompts", "taskify-ticket.md"),
+    path11.resolve(__dirname, "..", "..", "prompts", "taskify-ticket.md"),
+    path11.resolve(__dirname, "..", "prompts", "taskify-ticket.md")
   ];
   let template = "";
   for (const candidate of candidates) {
-    if (fs11.existsSync(candidate)) {
-      template = fs11.readFileSync(candidate, "utf-8");
+    if (fs12.existsSync(candidate)) {
+      template = fs12.readFileSync(candidate, "utf-8");
       break;
     }
   }
@@ -1569,13 +1569,13 @@ function buildPrompt(opts) {
   return template;
 }
 function isTaskifyRun(taskDir) {
-  return fs11.existsSync(path10.join(taskDir, MARKER_FILE));
+  return fs12.existsSync(path11.join(taskDir, MARKER_FILE));
 }
 function readTaskifyMarker(taskDir) {
-  const markerPath = path10.join(taskDir, MARKER_FILE);
-  if (!fs11.existsSync(markerPath)) return null;
+  const markerPath = path11.join(taskDir, MARKER_FILE);
+  if (!fs12.existsSync(markerPath)) return null;
   try {
-    return JSON.parse(fs11.readFileSync(markerPath, "utf-8"));
+    return JSON.parse(fs12.readFileSync(markerPath, "utf-8"));
   } catch {
     return null;
   }
@@ -1591,7 +1591,7 @@ var init_taskify_command = __esm({
     init_logger();
     init_task_resolution();
     init_litellm();
-    __dirname = path10.dirname(fileURLToPath(import.meta.url));
+    __dirname = path11.dirname(fileURLToPath(import.meta.url));
     TaskifyError = class extends Error {
       constructor(message) {
         super(message);
@@ -1607,9 +1607,9 @@ var init_taskify_command = __esm({
 });
 
 // src/cli/test-model-tests.ts
-import * as fs12 from "fs";
+import * as fs13 from "fs";
 import * as os2 from "os";
-import * as path11 from "path";
+import * as path12 from "path";
 import * as zlib from "zlib";
 import { spawnSync, execSync as execSync2 } from "child_process";
 function canRunApiTests(ctx) {
@@ -1937,8 +1937,8 @@ async function testExtendedThinking(ctx) {
 async function testToolRead(ctx) {
   if (!canRunApiTests(ctx)) {
     const t2 = Date.now();
-    const testFile2 = path11.join(os2.tmpdir(), "kody-test-model-read.txt");
-    fs12.writeFileSync(testFile2, "KODY_SECRET_CONTENT_42");
+    const testFile2 = path12.join(os2.tmpdir(), "kody-test-model-read.txt");
+    fs13.writeFileSync(testFile2, "KODY_SECRET_CONTENT_42");
     try {
       const r = runClaudeTest(ctx, `Read the file ${testFile2} and tell me its exact contents. Reply with ONLY the file contents.`);
       const ok = r.stdout.includes("KODY_SECRET_CONTENT_42");
@@ -1952,12 +1952,12 @@ async function testToolRead(ctx) {
         { toolSelection: ok ? 100 : 0 }
       );
     } finally {
-      fs12.rmSync(testFile2, { force: true });
+      fs13.rmSync(testFile2, { force: true });
     }
   }
   const t = Date.now();
-  const testFile = path11.join(os2.tmpdir(), "kody-test-model-read.txt");
-  fs12.writeFileSync(testFile, "KODY_SECRET_CONTENT_42");
+  const testFile = path12.join(os2.tmpdir(), "kody-test-model-read.txt");
+  fs13.writeFileSync(testFile, "KODY_SECRET_CONTENT_42");
   try {
     const conv = await runToolConversation(
       ctx,
@@ -1986,17 +1986,17 @@ async function testToolRead(ctx) {
       { toolSelection: calledRead ? 100 : 0 }
     );
   } finally {
-    fs12.rmSync(testFile, { force: true });
+    fs13.rmSync(testFile, { force: true });
   }
 }
 async function testToolEdit(ctx) {
   if (!canRunApiTests(ctx)) {
     const t2 = Date.now();
-    const testFile = path11.join(os2.tmpdir(), "kody-test-model-edit.txt");
-    fs12.writeFileSync(testFile, "hello world");
+    const testFile = path12.join(os2.tmpdir(), "kody-test-model-edit.txt");
+    fs13.writeFileSync(testFile, "hello world");
     try {
       const r = runClaudeTest(ctx, `Use the Edit tool to replace "hello" with "goodbye" in ${testFile}. Do nothing else.`);
-      const content = fs12.existsSync(testFile) ? fs12.readFileSync(testFile, "utf-8") : "";
+      const content = fs13.existsSync(testFile) ? fs13.readFileSync(testFile, "utf-8") : "";
       const ok = content.includes("goodbye");
       return result(
         "tool_edit",
@@ -2008,7 +2008,7 @@ async function testToolEdit(ctx) {
         { toolSelection: ok ? 100 : 0 }
       );
     } finally {
-      fs12.rmSync(testFile, { force: true });
+      fs13.rmSync(testFile, { force: true });
     }
   }
   const t = Date.now();
@@ -2082,8 +2082,8 @@ async function testToolBash(ctx) {
 async function testImageAttachment(ctx) {
   if (!canRunApiTests(ctx)) {
     const t2 = Date.now();
-    const tmpPng = path11.join(os2.tmpdir(), "kody-test-image.png");
-    fs12.writeFileSync(tmpPng, createRedPng());
+    const tmpPng = path12.join(os2.tmpdir(), "kody-test-image.png");
+    fs13.writeFileSync(tmpPng, createRedPng());
     try {
       const r = runClaudeTest(ctx, `Read the image file at ${tmpPng} and tell me what color it is. Reply with just the color name.`);
       const text2 = r.stdout.toLowerCase();
@@ -2097,7 +2097,7 @@ async function testImageAttachment(ctx) {
         ok ? "Image processed correctly via CLI" : `Got: ${text2.slice(0, 80)}`
       );
     } finally {
-      fs12.rmSync(tmpPng, { force: true });
+      fs13.rmSync(tmpPng, { force: true });
     }
   }
   const t = Date.now();
@@ -2312,10 +2312,10 @@ async function testReviewStage(ctx) {
 }
 async function testMcpTools(ctx) {
   const t = Date.now();
-  const mcpConfig = path11.join(os2.tmpdir(), `kody-test-mcp-${Date.now()}.json`);
-  const testFile = path11.join(ctx.projectDir, "kody-mcp-compat-test.txt");
+  const mcpConfig = path12.join(os2.tmpdir(), `kody-test-mcp-${Date.now()}.json`);
+  const testFile = path12.join(ctx.projectDir, "kody-mcp-compat-test.txt");
   try {
-    fs12.writeFileSync(mcpConfig, JSON.stringify({
+    fs13.writeFileSync(mcpConfig, JSON.stringify({
       mcpServers: {
         filesystem: { command: "npx", args: ["-y", "@modelcontextprotocol/server-filesystem", ctx.projectDir] }
       }
@@ -2326,8 +2326,8 @@ async function testMcpTools(ctx) {
       ["--mcp-config", mcpConfig],
       12e4
     );
-    const created = fs12.existsSync(testFile);
-    const content = created ? fs12.readFileSync(testFile, "utf-8").trim() : "";
+    const created = fs13.existsSync(testFile);
+    const content = created ? fs13.readFileSync(testFile, "utf-8").trim() : "";
     const correct = content.includes("mcp-ok");
     return result(
       "mcp_tools",
@@ -2340,8 +2340,8 @@ async function testMcpTools(ctx) {
   } catch (err) {
     return result("mcp_tools", "advanced", "warn", 0, Date.now() - t, `MCP test error: ${err instanceof Error ? err.message : String(err)}`);
   } finally {
-    fs12.rmSync(mcpConfig, { force: true });
-    fs12.rmSync(testFile, { force: true });
+    fs13.rmSync(mcpConfig, { force: true });
+    fs13.rmSync(testFile, { force: true });
     revertChanges(ctx.projectDir);
   }
 }
@@ -2522,9 +2522,9 @@ var test_model_command_exports = {};
 __export(test_model_command_exports, {
   runTestModelCommand: () => runTestModelCommand
 });
-import * as fs13 from "fs";
+import * as fs14 from "fs";
 import * as os3 from "os";
-import * as path12 from "path";
+import * as path13 from "path";
 import { execFileSync as execFileSync10 } from "child_process";
 function parseTestModelArgs() {
   const args2 = process.argv.slice(3);
@@ -2607,7 +2607,7 @@ async function startProxy(config, url) {
       return null;
     }
   }
-  fs13.writeFileSync(CONFIG_PATH, config);
+  fs14.writeFileSync(CONFIG_PATH, config);
   const portMatch = url.match(/:(\d+)/);
   const port = portMatch ? portMatch[1] : "4099";
   const { spawn: spawn2 } = await import("child_process");
@@ -2649,7 +2649,7 @@ async function quickApiTest(url, model, apiKey) {
   }
 }
 function delay(ms) {
-  return new Promise((resolve5) => setTimeout(resolve5, ms));
+  return new Promise((resolve6) => setTimeout(resolve6, ms));
 }
 async function runTestModelCommand() {
   const opts = parseTestModelArgs();
@@ -2663,7 +2663,7 @@ async function runTestModelCommand() {
       proxyProcess.kill();
       proxyProcess = null;
     }
-    fs13.rmSync(CONFIG_PATH, { force: true });
+    fs14.rmSync(CONFIG_PATH, { force: true });
   };
   process.on("SIGINT", () => {
     cleanup();
@@ -2757,7 +2757,7 @@ var init_test_model_command = __esm({
     init_test_model_report();
     TEST_PORT = 4099;
     TEST_URL = `http://localhost:${TEST_PORT}`;
-    CONFIG_PATH = path12.join(os3.tmpdir(), "kody-test-model-config.yaml");
+    CONFIG_PATH = path13.join(os3.tmpdir(), "kody-test-model-config.yaml");
   }
 });
 
@@ -2768,7 +2768,7 @@ __export(parse_inputs_exports, {
   runCiParse: () => runCiParse,
   writeOutputs: () => writeOutputs
 });
-import * as fs14 from "fs";
+import * as fs15 from "fs";
 function generateTimestamp() {
   const now = /* @__PURE__ */ new Date();
   const pad2 = (n) => String(n).padStart(2, "0");
@@ -2917,12 +2917,12 @@ function writeOutputs(result2) {
   function output(key, value) {
     if (outputFile) {
       if (value.includes("\n")) {
-        fs14.appendFileSync(outputFile, `${key}<<KODY_EOF
+        fs15.appendFileSync(outputFile, `${key}<<KODY_EOF
 ${value}
 KODY_EOF
 `);
       } else {
-        fs14.appendFileSync(outputFile, `${key}=${value}
+        fs15.appendFileSync(outputFile, `${key}=${value}
 `);
       }
     }
@@ -3241,14 +3241,14 @@ var init_git_utils = __esm({
 });
 
 // src/pipeline/state.ts
-import * as fs15 from "fs";
-import * as path13 from "path";
+import * as fs16 from "fs";
+import * as path14 from "path";
 function loadState(taskId, taskDir) {
-  const p = path13.join(taskDir, "status.json");
-  if (!fs15.existsSync(p)) return null;
+  const p = path14.join(taskDir, "status.json");
+  if (!fs16.existsSync(p)) return null;
   try {
     const result2 = parseJsonSafe(
-      fs15.readFileSync(p, "utf-8"),
+      fs16.readFileSync(p, "utf-8"),
       ["taskId", "state", "stages", "createdAt", "updatedAt"]
     );
     if (!result2.ok) {
@@ -3266,10 +3266,10 @@ function writeState(state, taskDir) {
     ...state,
     updatedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
-  const target = path13.join(taskDir, "status.json");
+  const target = path14.join(taskDir, "status.json");
   const tmp = target + ".tmp";
-  fs15.writeFileSync(tmp, JSON.stringify(updated, null, 2));
-  fs15.renameSync(tmp, target);
+  fs16.writeFileSync(tmp, JSON.stringify(updated, null, 2));
+  fs16.renameSync(tmp, target);
   return updated;
 }
 function initState(taskId) {
@@ -3310,16 +3310,16 @@ var init_complexity = __esm({
 });
 
 // src/memory.ts
-import * as fs16 from "fs";
-import * as path14 from "path";
+import * as fs17 from "fs";
+import * as path15 from "path";
 function readProjectMemory(projectDir) {
-  const memoryDir = path14.join(projectDir, ".kody", "memory");
-  if (!fs16.existsSync(memoryDir)) return "";
-  const files = fs16.readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort();
+  const memoryDir = path15.join(projectDir, ".kody", "memory");
+  if (!fs17.existsSync(memoryDir)) return "";
+  const files = fs17.readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort();
   if (files.length === 0) return "";
   const sections = [];
   for (const file of files) {
-    const content = fs16.readFileSync(path14.join(memoryDir, file), "utf-8").trim();
+    const content = fs17.readFileSync(path15.join(memoryDir, file), "utf-8").trim();
     if (content) {
       sections.push(`## ${file.replace(".md", "")}
 ${content}`);
@@ -3338,8 +3338,8 @@ var init_memory = __esm({
 });
 
 // src/context-tiers.ts
-import * as fs17 from "fs";
-import * as path15 from "path";
+import * as fs18 from "fs";
+import * as path16 from "path";
 function estimateTokens(text) {
   return Math.ceil(text.length / 4);
 }
@@ -3430,7 +3430,7 @@ function generateL1Json(content) {
   }
 }
 function getTieredContent(filePath, content) {
-  const key = path15.basename(filePath);
+  const key = path16.basename(filePath);
   return {
     source: filePath,
     L0: generateL0(content, key),
@@ -3442,15 +3442,15 @@ function selectTier(tiered, tier) {
   return tiered[tier];
 }
 function readProjectMemoryTiered(projectDir, tier) {
-  const memoryDir = path15.join(projectDir, ".kody", "memory");
-  if (!fs17.existsSync(memoryDir)) return "";
-  const files = fs17.readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort();
+  const memoryDir = path16.join(projectDir, ".kody", "memory");
+  if (!fs18.existsSync(memoryDir)) return "";
+  const files = fs18.readdirSync(memoryDir).filter((f) => f.endsWith(".md")).sort();
   if (files.length === 0) return "";
   const tierLabel2 = tier === "L2" ? "full" : tier === "L1" ? "overview" : "abstract";
   const sections = [];
   for (const file of files) {
-    const filePath = path15.join(memoryDir, file);
-    const content = fs17.readFileSync(filePath, "utf-8").trim();
+    const filePath = path16.join(memoryDir, file);
+    const content = fs18.readFileSync(filePath, "utf-8").trim();
     if (!content) continue;
     const tiered = getTieredContent(filePath, content);
     const selected = selectTier(tiered, tier);
@@ -3473,9 +3473,9 @@ function injectTaskContextTiered(prompt, taskId, taskDir, policy, feedback) {
 `;
   context += `Task Directory: ${taskDir}
 `;
-  const taskMdPath = path15.join(taskDir, "task.md");
-  if (fs17.existsSync(taskMdPath)) {
-    const content = fs17.readFileSync(taskMdPath, "utf-8");
+  const taskMdPath = path16.join(taskDir, "task.md");
+  if (fs18.existsSync(taskMdPath)) {
+    const content = fs18.readFileSync(taskMdPath, "utf-8");
     const selected = selectContent(taskMdPath, content, policy.taskDescription);
     const label = tierLabel("Task Description", policy.taskDescription);
     context += `
@@ -3483,9 +3483,9 @@ function injectTaskContextTiered(prompt, taskId, taskDir, policy, feedback) {
 ${selected}
 `;
   }
-  const taskJsonPath = path15.join(taskDir, "task.json");
-  if (fs17.existsSync(taskJsonPath)) {
-    const content = fs17.readFileSync(taskJsonPath, "utf-8");
+  const taskJsonPath = path16.join(taskDir, "task.json");
+  if (fs18.existsSync(taskJsonPath)) {
+    const content = fs18.readFileSync(taskJsonPath, "utf-8");
     if (policy.taskClassification === "L2") {
       try {
         const taskDef = JSON.parse(content.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, ""));
@@ -3511,9 +3511,9 @@ ${selected}
       }
     }
   }
-  const specPath = path15.join(taskDir, "spec.md");
-  if (fs17.existsSync(specPath)) {
-    const content = fs17.readFileSync(specPath, "utf-8");
+  const specPath = path16.join(taskDir, "spec.md");
+  if (fs18.existsSync(specPath)) {
+    const content = fs18.readFileSync(specPath, "utf-8");
     const selected = selectContent(specPath, content, policy.spec);
     const label = tierLabel("Spec", policy.spec);
     context += `
@@ -3521,9 +3521,9 @@ ${selected}
 ${selected}
 `;
   }
-  const planPath = path15.join(taskDir, "plan.md");
-  if (fs17.existsSync(planPath)) {
-    const content = fs17.readFileSync(planPath, "utf-8");
+  const planPath = path16.join(taskDir, "plan.md");
+  if (fs18.existsSync(planPath)) {
+    const content = fs18.readFileSync(planPath, "utf-8");
     const selected = selectContent(planPath, content, policy.plan);
     const label = tierLabel("Plan", policy.plan);
     context += `
@@ -3531,9 +3531,9 @@ ${selected}
 ${selected}
 `;
   }
-  const contextMdPath = path15.join(taskDir, "context.md");
-  if (fs17.existsSync(contextMdPath)) {
-    const content = fs17.readFileSync(contextMdPath, "utf-8");
+  const contextMdPath = path16.join(taskDir, "context.md");
+  if (fs18.existsSync(contextMdPath)) {
+    const content = fs18.readFileSync(contextMdPath, "utf-8");
     const selected = selectContent(contextMdPath, content, policy.accumulatedContext);
     const label = tierLabel("Previous Stage Context", policy.accumulatedContext);
     context += `
@@ -3618,25 +3618,117 @@ var init_context_tiers = __esm({
   }
 });
 
+// src/tools.ts
+import * as fs19 from "fs";
+import * as path17 from "path";
+import { execSync as execSync3 } from "child_process";
+import { parse as parseYaml } from "yaml";
+function loadToolDeclarations(projectDir) {
+  const toolsPath = path17.join(projectDir, ".kody", "tools.yml");
+  if (!fs19.existsSync(toolsPath)) return [];
+  try {
+    const raw = fs19.readFileSync(toolsPath, "utf-8");
+    const parsed = parseYaml(raw);
+    if (!parsed || typeof parsed !== "object") return [];
+    return Object.entries(parsed).map(([name, value]) => {
+      const v = value;
+      return {
+        name,
+        detect: Array.isArray(v.detect) ? v.detect : [],
+        stages: Array.isArray(v.stages) ? v.stages : [],
+        setup: typeof v.setup === "string" ? v.setup : "",
+        skill: typeof v.skill === "string" ? v.skill : ""
+      };
+    });
+  } catch (err) {
+    logger.warn(`Failed to parse .kody/tools.yml: ${err instanceof Error ? err.message : String(err)}`);
+    return [];
+  }
+}
+function resolveSkillContent(skillFilename, projectDir) {
+  if (!skillFilename) return "";
+  const projectSkill = path17.join(projectDir, ".kody", "skills", skillFilename);
+  if (fs19.existsSync(projectSkill)) {
+    return fs19.readFileSync(projectSkill, "utf-8");
+  }
+  const scriptDir = new URL(".", import.meta.url).pathname;
+  const candidates = [
+    path17.resolve(scriptDir, "..", "skills", skillFilename),
+    path17.resolve(scriptDir, "..", "..", "skills", skillFilename)
+  ];
+  for (const candidate of candidates) {
+    if (fs19.existsSync(candidate)) {
+      return fs19.readFileSync(candidate, "utf-8");
+    }
+  }
+  logger.warn(`Skill file not found: ${skillFilename}`);
+  return "";
+}
+function detectTools(declarations, projectDir) {
+  const resolved = [];
+  for (const decl of declarations) {
+    const detected = decl.detect.some((pattern) => fs19.existsSync(path17.join(projectDir, pattern)));
+    if (!detected) continue;
+    const skillContent = resolveSkillContent(decl.skill, projectDir);
+    resolved.push({
+      name: decl.name,
+      stages: decl.stages,
+      setup: decl.setup,
+      skillContent
+    });
+  }
+  return resolved;
+}
+function runToolSetup(tools, projectDir) {
+  for (const tool of tools) {
+    if (!tool.setup) continue;
+    try {
+      logger.info(`  Setting up ${tool.name}: ${tool.setup}`);
+      execSync3(tool.setup, { cwd: projectDir, timeout: 12e4, stdio: "pipe" });
+      logger.info(`  \u2713 ${tool.name} setup complete`);
+    } catch (err) {
+      logger.warn(`  \u26A0 ${tool.name} setup failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+}
+function getToolSkillsForStage(tools, stageName) {
+  const matched = tools.filter((t) => t.stages.includes(stageName) && t.skillContent);
+  if (matched.length === 0) return "";
+  const sections = matched.map((t) => `### ${t.name}
+
+${t.skillContent}`);
+  return `## Available Tools
+
+The following tools are installed and ready to use in this environment.
+
+${sections.join("\n\n")}`;
+}
+var init_tools = __esm({
+  "src/tools.ts"() {
+    "use strict";
+    init_logger();
+  }
+});
+
 // src/context.ts
-import * as fs18 from "fs";
-import * as path16 from "path";
+import * as fs20 from "fs";
+import * as path18 from "path";
 function readPromptFile(stageName, projectDir) {
   if (projectDir) {
-    const stepFile = path16.join(projectDir, ".kody", "steps", `${stageName}.md`);
-    if (fs18.existsSync(stepFile)) {
-      return fs18.readFileSync(stepFile, "utf-8");
+    const stepFile = path18.join(projectDir, ".kody", "steps", `${stageName}.md`);
+    if (fs20.existsSync(stepFile)) {
+      return fs20.readFileSync(stepFile, "utf-8");
     }
     console.warn(`  \u26A0 No step file at ${stepFile}, falling back to engine defaults. Run 'kody-engine-lite init --force' to generate step files.`);
   }
   const scriptDir = new URL(".", import.meta.url).pathname;
   const candidates = [
-    path16.resolve(scriptDir, "..", "prompts", `${stageName}.md`),
-    path16.resolve(scriptDir, "..", "..", "prompts", `${stageName}.md`)
+    path18.resolve(scriptDir, "..", "prompts", `${stageName}.md`),
+    path18.resolve(scriptDir, "..", "..", "prompts", `${stageName}.md`)
   ];
   for (const candidate of candidates) {
-    if (fs18.existsSync(candidate)) {
-      return fs18.readFileSync(candidate, "utf-8");
+    if (fs20.existsSync(candidate)) {
+      return fs20.readFileSync(candidate, "utf-8");
     }
   }
   throw new Error(`Prompt file not found: tried ${candidates.join(", ")}`);
@@ -3648,18 +3740,18 @@ function injectTaskContext(prompt, taskId, taskDir, feedback) {
 `;
   context += `Task Directory: ${taskDir}
 `;
-  const taskMdPath = path16.join(taskDir, "task.md");
-  if (fs18.existsSync(taskMdPath)) {
-    const taskMd = fs18.readFileSync(taskMdPath, "utf-8");
+  const taskMdPath = path18.join(taskDir, "task.md");
+  if (fs20.existsSync(taskMdPath)) {
+    const taskMd = fs20.readFileSync(taskMdPath, "utf-8");
     context += `
 ## Task Description
 ${taskMd}
 `;
   }
-  const taskJsonPath = path16.join(taskDir, "task.json");
-  if (fs18.existsSync(taskJsonPath)) {
+  const taskJsonPath = path18.join(taskDir, "task.json");
+  if (fs20.existsSync(taskJsonPath)) {
     try {
-      const taskDef = JSON.parse(fs18.readFileSync(taskJsonPath, "utf-8"));
+      const taskDef = JSON.parse(fs20.readFileSync(taskJsonPath, "utf-8"));
       context += `
 ## Task Classification
 `;
@@ -3672,27 +3764,27 @@ ${taskMd}
     } catch {
     }
   }
-  const specPath = path16.join(taskDir, "spec.md");
-  if (fs18.existsSync(specPath)) {
-    const spec = fs18.readFileSync(specPath, "utf-8");
+  const specPath = path18.join(taskDir, "spec.md");
+  if (fs20.existsSync(specPath)) {
+    const spec = fs20.readFileSync(specPath, "utf-8");
     const truncated = spec.slice(0, MAX_TASK_CONTEXT_SPEC);
     context += `
 ## Spec Summary
 ${truncated}${spec.length > MAX_TASK_CONTEXT_SPEC ? "\n..." : ""}
 `;
   }
-  const planPath = path16.join(taskDir, "plan.md");
-  if (fs18.existsSync(planPath)) {
-    const plan = fs18.readFileSync(planPath, "utf-8");
+  const planPath = path18.join(taskDir, "plan.md");
+  if (fs20.existsSync(planPath)) {
+    const plan = fs20.readFileSync(planPath, "utf-8");
     const truncated = plan.slice(0, MAX_TASK_CONTEXT_PLAN);
     context += `
 ## Plan Summary
 ${truncated}${plan.length > MAX_TASK_CONTEXT_PLAN ? "\n..." : ""}
 `;
   }
-  const contextMdPath = path16.join(taskDir, "context.md");
-  if (fs18.existsSync(contextMdPath)) {
-    const accumulated = fs18.readFileSync(contextMdPath, "utf-8");
+  const contextMdPath = path18.join(taskDir, "context.md");
+  if (fs20.existsSync(contextMdPath)) {
+    const accumulated = fs20.readFileSync(contextMdPath, "utf-8");
     const truncated = accumulated.slice(-MAX_ACCUMULATED_CONTEXT);
     const prefix = accumulated.length > MAX_ACCUMULATED_CONTEXT ? "...(earlier context truncated)\n" : "";
     context += `
@@ -3710,17 +3802,17 @@ ${feedback}
 }
 function inferHasUIFromScope(scope) {
   return scope.some((filePath) => {
-    const ext = path16.extname(filePath).toLowerCase();
+    const ext = path18.extname(filePath).toLowerCase();
     if (UI_EXTENSIONS.has(ext)) return true;
     const normalized = filePath.replace(/\\/g, "/");
     return UI_PATH_SEGMENTS.some((seg) => normalized.includes(seg));
   });
 }
 function taskHasUI(taskDir) {
-  const taskJsonPath = path16.join(taskDir, "task.json");
-  if (!fs18.existsSync(taskJsonPath)) return true;
+  const taskJsonPath = path18.join(taskDir, "task.json");
+  if (!fs20.existsSync(taskJsonPath)) return true;
   try {
-    const taskDef = JSON.parse(fs18.readFileSync(taskJsonPath, "utf-8"));
+    const taskDef = JSON.parse(fs20.readFileSync(taskJsonPath, "utf-8"));
     const scope = Array.isArray(taskDef.scope) ? taskDef.scope : [];
     if (scope.length === 0) return true;
     return inferHasUIFromScope(scope);
@@ -3826,7 +3918,7 @@ ${devServerBlock}
 
 Use browser tools to navigate to pages and take snapshots to verify UI output.`;
 }
-function buildFullPrompt(stageName, taskId, taskDir, projectDir, feedback) {
+function buildFullPrompt(stageName, taskId, taskDir, projectDir, feedback, tools) {
   const config = getProjectConfig();
   let assembled;
   if (config.contextTiers?.enabled) {
@@ -3842,12 +3934,18 @@ ${prompt}` : prompt;
   }
   if (isMcpEnabledForStage(stageName, config.mcp) && taskHasUI(taskDir)) {
     assembled = assembled + "\n\n" + getBrowserToolGuidance(stageName, taskDir);
-    const qaGuidePath = path16.join(projectDir, ".kody", "qa-guide.md");
-    if (fs18.existsSync(qaGuidePath)) {
-      const qaGuide = fs18.readFileSync(qaGuidePath, "utf-8").trim();
+    const qaGuidePath = path18.join(projectDir, ".kody", "qa-guide.md");
+    if (fs20.existsSync(qaGuidePath)) {
+      const qaGuide = fs20.readFileSync(qaGuidePath, "utf-8").trim();
       assembled = assembled + "\n\n" + qaGuide;
     }
   }
+  if (tools?.length) {
+    const toolSkills = getToolSkillsForStage(tools, stageName);
+    if (toolSkills) {
+      assembled = assembled + "\n\n" + toolSkills;
+    }
+  }
   return assembled;
 }
 function buildFullPromptTiered(stageName, taskId, taskDir, projectDir, feedback) {
@@ -3887,6 +3985,7 @@ var init_context = __esm({
     init_config();
     init_context_tiers();
     init_mcp_config();
+    init_tools();
     MAX_TASK_CONTEXT_PLAN = 1500;
     MAX_TASK_CONTEXT_SPEC = 2e3;
     MAX_ACCUMULATED_CONTEXT = 4e3;
@@ -3936,8 +4035,8 @@ var init_runner_selection = __esm({
 });
 
 // src/stages/agent.ts
-import * as fs19 from "fs";
-import * as path17 from "path";
+import * as fs21 from "fs";
+import * as path19 from "path";
 function getSessionInfo(stageName, sessions) {
   const group = SESSION_GROUP[stageName];
   if (!group) return void 0;
@@ -3966,7 +4065,7 @@ async function executeAgentStage(ctx, def) {
     logger.info(`  [dry-run] skipping ${def.name}`);
     return { outcome: "completed", retries: 0 };
   }
-  const prompt = buildFullPrompt(def.name, ctx.taskId, ctx.taskDir, ctx.projectDir, ctx.input.feedback);
+  const prompt = buildFullPrompt(def.name, ctx.taskId, ctx.taskDir, ctx.projectDir, ctx.input.feedback, ctx.tools);
   let currentModelTier = def.modelTier;
   if (ctx.input.feedback && def.name === "build") {
     logger.info(`  feedback: ${ctx.input.feedback.slice(0, 200)}${ctx.input.feedback.length > 200 ? "..." : ""}`);
@@ -4024,27 +4123,27 @@ async function executeAgentStage(ctx, def) {
   }
   const result2 = lastResult;
   if (def.outputFile && result2.output) {
-    fs19.writeFileSync(path17.join(ctx.taskDir, def.outputFile), result2.output);
+    fs21.writeFileSync(path19.join(ctx.taskDir, def.outputFile), result2.output);
   }
   if (def.outputFile) {
-    const outputPath = path17.join(ctx.taskDir, def.outputFile);
-    if (!fs19.existsSync(outputPath)) {
-      const ext = path17.extname(def.outputFile);
-      const base = path17.basename(def.outputFile, ext);
-      const files = fs19.readdirSync(ctx.taskDir);
+    const outputPath = path19.join(ctx.taskDir, def.outputFile);
+    if (!fs21.existsSync(outputPath)) {
+      const ext = path19.extname(def.outputFile);
+      const base = path19.basename(def.outputFile, ext);
+      const files = fs21.readdirSync(ctx.taskDir);
       const variant = files.find(
         (f) => f.startsWith(base + "-") && f.endsWith(ext)
       );
       if (variant) {
-        fs19.renameSync(path17.join(ctx.taskDir, variant), outputPath);
+        fs21.renameSync(path19.join(ctx.taskDir, variant), outputPath);
         logger.info(`  Renamed variant ${variant} \u2192 ${def.outputFile}`);
       }
     }
   }
   if (def.outputFile) {
-    const outputPath = path17.join(ctx.taskDir, def.outputFile);
-    if (fs19.existsSync(outputPath)) {
-      const content = fs19.readFileSync(outputPath, "utf-8");
+    const outputPath = path19.join(ctx.taskDir, def.outputFile);
+    if (fs21.existsSync(outputPath)) {
+      const content = fs21.readFileSync(outputPath, "utf-8");
       const validation = validateStageOutput(def.name, content);
       if (!validation.valid) {
         if (def.name === "taskify") {
@@ -4058,7 +4157,7 @@ async function executeAgentStage(ctx, def) {
             const stripped = stripFences(retryResult.output);
             const retryValidation = validateTaskJson(stripped);
             if (retryValidation.valid) {
-              fs19.writeFileSync(outputPath, retryResult.output);
+              fs21.writeFileSync(outputPath, retryResult.output);
               logger.info(`  taskify retry produced valid JSON`);
             } else {
               logger.warn(`  taskify retry still invalid: ${retryValidation.error}`);
@@ -4071,7 +4170,7 @@ async function executeAgentStage(ctx, def) {
                 risk_level: "low",
                 questions: []
               }, null, 2);
-              fs19.writeFileSync(outputPath, fallback);
+              fs21.writeFileSync(outputPath, fallback);
               logger.info(`  taskify fallback: generated minimal task.json (risk_level=low)`);
             }
           }
@@ -4085,7 +4184,7 @@ async function executeAgentStage(ctx, def) {
   return { outcome: "completed", outputFile: def.outputFile, retries };
 }
 function appendStageContext(taskDir, stageName, output) {
-  const contextPath = path17.join(taskDir, "context.md");
+  const contextPath = path19.join(taskDir, "context.md");
   const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19);
   let summary;
   if (output && output.trim()) {
@@ -4098,7 +4197,7 @@ function appendStageContext(taskDir, stageName, output) {
 ### ${stageName} (${timestamp2})
 ${summary}
 `;
-  fs19.appendFileSync(contextPath, entry);
+  fs21.appendFileSync(contextPath, entry);
 }
 var SESSION_GROUP;
 var init_agent = __esm({
@@ -4378,8 +4477,8 @@ Error context:
 });
 
 // src/stages/gate.ts
-import * as fs20 from "fs";
-import * as path18 from "path";
+import * as fs22 from "fs";
+import * as path20 from "path";
 function executeGateStage(ctx, def) {
   if (ctx.input.dryRun) {
     logger.info(`  [dry-run] skipping ${def.name}`);
@@ -4422,7 +4521,7 @@ ${output}
 `);
     }
   }
-  fs20.writeFileSync(path18.join(ctx.taskDir, "verify.md"), lines.join(""));
+  fs22.writeFileSync(path20.join(ctx.taskDir, "verify.md"), lines.join(""));
   return {
     outcome: verifyResult.pass ? "completed" : "failed",
     retries: 0
@@ -4437,8 +4536,8 @@ var init_gate = __esm({
 });
 
 // src/stages/verify.ts
-import * as fs21 from "fs";
-import * as path19 from "path";
+import * as fs23 from "fs";
+import * as path21 from "path";
 import { execFileSync as execFileSync14 } from "child_process";
 async function executeVerifyWithAutofix(ctx, def) {
   const maxAttempts = def.maxRetries ?? 2;
@@ -4449,8 +4548,8 @@ async function executeVerifyWithAutofix(ctx, def) {
       return { ...gateResult, retries: attempt };
     }
     if (attempt < maxAttempts) {
-      const verifyPath = path19.join(ctx.taskDir, "verify.md");
-      const errorOutput = fs21.existsSync(verifyPath) ? fs21.readFileSync(verifyPath, "utf-8") : "Unknown error";
+      const verifyPath = path21.join(ctx.taskDir, "verify.md");
+      const errorOutput = fs23.existsSync(verifyPath) ? fs23.readFileSync(verifyPath, "utf-8") : "Unknown error";
       const modifiedFiles = getModifiedFiles(ctx.projectDir);
       const defaultRunner = getRunnerForStage(ctx, "taskify");
       const diagConfig = getProjectConfig();
@@ -4546,8 +4645,8 @@ var init_verify = __esm({
 });
 
 // src/review-standalone.ts
-import * as fs22 from "fs";
-import * as path20 from "path";
+import * as fs24 from "fs";
+import * as path22 from "path";
 function resolveReviewTarget(input) {
   if (input.prs.length === 0) {
     return {
@@ -4571,8 +4670,8 @@ Or comment on the specific PR: \`@kody review\``
 }
 async function runStandaloneReview(input) {
   const taskId = input.taskId ?? `review-${generateTaskId()}`;
-  const taskDir = path20.join(input.projectDir, ".kody", "tasks", taskId);
-  fs22.mkdirSync(taskDir, { recursive: true });
+  const taskDir = path22.join(input.projectDir, ".kody", "tasks", taskId);
+  fs24.mkdirSync(taskDir, { recursive: true });
   let diffInstruction = "";
   let filesChangedSection = "";
   if (input.baseBranch) {
@@ -4599,7 +4698,7 @@ ${fileList}`;
   const taskContent = `# ${input.prTitle}
 
 ${input.prBody ?? ""}${diffInstruction}${filesChangedSection}`;
-  fs22.writeFileSync(path20.join(taskDir, "task.md"), taskContent);
+  fs24.writeFileSync(path22.join(taskDir, "task.md"), taskContent);
   const reviewDef = STAGES.find((s) => s.name === "review");
   const ctx = {
     taskId,
@@ -4621,10 +4720,10 @@ ${input.prBody ?? ""}${diffInstruction}${filesChangedSection}`;
       error: result2.error ?? "Review stage failed"
     };
   }
-  const reviewPath = path20.join(taskDir, "review.md");
+  const reviewPath = path22.join(taskDir, "review.md");
   let reviewContent;
-  if (fs22.existsSync(reviewPath)) {
-    reviewContent = fs22.readFileSync(reviewPath, "utf-8");
+  if (fs24.existsSync(reviewPath)) {
+    reviewContent = fs24.readFileSync(reviewPath, "utf-8");
   }
   return {
     outcome: "completed",
@@ -4664,8 +4763,8 @@ var init_review_standalone = __esm({
 });
 
 // src/stages/review.ts
-import * as fs23 from "fs";
-import * as path21 from "path";
+import * as fs25 from "fs";
+import * as path23 from "path";
 async function executeReviewWithFix(ctx, def) {
   if (ctx.input.dryRun) {
     return { outcome: "completed", retries: 0 };
@@ -4679,11 +4778,11 @@ async function executeReviewWithFix(ctx, def) {
     if (reviewResult.outcome !== "completed") {
       return reviewResult;
     }
-    const reviewFile = path21.join(ctx.taskDir, "review.md");
-    if (!fs23.existsSync(reviewFile)) {
+    const reviewFile = path23.join(ctx.taskDir, "review.md");
+    if (!fs25.existsSync(reviewFile)) {
       return { outcome: "failed", retries: iteration, error: "review.md not found" };
     }
-    const content = fs23.readFileSync(reviewFile, "utf-8");
+    const content = fs25.readFileSync(reviewFile, "utf-8");
     if (detectReviewVerdict(content) !== "fail") {
       return { ...reviewResult, retries: iteration };
     }
@@ -4712,15 +4811,15 @@ var init_review = __esm({
 });
 
 // src/stages/ship.ts
-import * as fs24 from "fs";
-import * as path22 from "path";
+import * as fs26 from "fs";
+import * as path24 from "path";
 import { execFileSync as execFileSync15 } from "child_process";
 function buildPrBody(ctx) {
   const sections = [];
-  const taskJsonPath = path22.join(ctx.taskDir, "task.json");
-  if (fs24.existsSync(taskJsonPath)) {
+  const taskJsonPath = path24.join(ctx.taskDir, "task.json");
+  if (fs26.existsSync(taskJsonPath)) {
     try {
-      const raw = fs24.readFileSync(taskJsonPath, "utf-8");
+      const raw = fs26.readFileSync(taskJsonPath, "utf-8");
       const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
       const task = JSON.parse(cleaned);
       if (task.description) {
@@ -4739,9 +4838,9 @@ ${task.scope.map((s) => `- \`${s}\``).join("\n")}`);
     } catch {
     }
   }
-  const reviewPath = path22.join(ctx.taskDir, "review.md");
-  if (fs24.existsSync(reviewPath)) {
-    const review = fs24.readFileSync(reviewPath, "utf-8");
+  const reviewPath = path24.join(ctx.taskDir, "review.md");
+  if (fs26.existsSync(reviewPath)) {
+    const review = fs26.readFileSync(reviewPath, "utf-8");
     const summaryMatch = review.match(/## Summary\s*\n([\s\S]*?)(?=\n## |\n*$)/);
     if (summaryMatch) {
       const summary = summaryMatch[1].trim();
@@ -4758,14 +4857,14 @@ ${summary}`);
 **Review:** ${verdictMatch[1].toUpperCase() === "PASS" ? "\u2705 PASS" : "\u274C FAIL"}`);
     }
   }
-  const verifyPath = path22.join(ctx.taskDir, "verify.md");
-  if (fs24.existsSync(verifyPath)) {
-    const verify = fs24.readFileSync(verifyPath, "utf-8");
+  const verifyPath = path24.join(ctx.taskDir, "verify.md");
+  if (fs26.existsSync(verifyPath)) {
+    const verify = fs26.readFileSync(verifyPath, "utf-8");
     if (/PASS/i.test(verify)) sections.push(`**Verify:** \u2705 typecheck + tests + lint passed`);
   }
-  const planPath = path22.join(ctx.taskDir, "plan.md");
-  if (fs24.existsSync(planPath)) {
-    const plan = fs24.readFileSync(planPath, "utf-8").trim();
+  const planPath = path24.join(ctx.taskDir, "plan.md");
+  if (fs26.existsSync(planPath)) {
+    const plan = fs26.readFileSync(planPath, "utf-8").trim();
     if (plan) {
       const truncated = plan.length > 800 ? plan.slice(0, 800) + "\n..." : plan;
       sections.push(`
@@ -4785,13 +4884,13 @@ Closes #${ctx.input.issueNumber}`);
   return sections.join("\n");
 }
 function executeShipStage(ctx, _def) {
-  const shipPath = path22.join(ctx.taskDir, "ship.md");
+  const shipPath = path24.join(ctx.taskDir, "ship.md");
   if (ctx.input.dryRun) {
-    fs24.writeFileSync(shipPath, "# Ship\n\nShip stage skipped \u2014 dry run.\n");
+    fs26.writeFileSync(shipPath, "# Ship\n\nShip stage skipped \u2014 dry run.\n");
     return { outcome: "completed", outputFile: "ship.md", retries: 0 };
   }
   if (ctx.input.local && !ctx.input.issueNumber) {
-    fs24.writeFileSync(shipPath, "# Ship\n\nShip stage skipped \u2014 local mode, no issue number.\n");
+    fs26.writeFileSync(shipPath, "# Ship\n\nShip stage skipped \u2014 local mode, no issue number.\n");
     return { outcome: "completed", outputFile: "ship.md", retries: 0 };
   }
   try {
@@ -4838,28 +4937,28 @@ function executeShipStage(ctx, _def) {
       chore: "chore"
     };
     let prefix = "chore";
-    const taskJsonPath = path22.join(ctx.taskDir, "task.json");
-    if (fs24.existsSync(taskJsonPath)) {
+    const taskJsonPath = path24.join(ctx.taskDir, "task.json");
+    if (fs26.existsSync(taskJsonPath)) {
       try {
-        const raw = fs24.readFileSync(taskJsonPath, "utf-8");
+        const raw = fs26.readFileSync(taskJsonPath, "utf-8");
         const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
         const task = JSON.parse(cleaned);
         prefix = TYPE_PREFIX[task.task_type] ?? "chore";
       } catch {
       }
     }
-    const taskMdPath = path22.join(ctx.taskDir, "task.md");
-    if (fs24.existsSync(taskMdPath)) {
-      const content = fs24.readFileSync(taskMdPath, "utf-8");
+    const taskMdPath = path24.join(ctx.taskDir, "task.md");
+    if (fs26.existsSync(taskMdPath)) {
+      const content = fs26.readFileSync(taskMdPath, "utf-8");
       const heading = content.split("\n").find((l) => l.startsWith("# "));
       if (heading) {
         title = `${prefix}: ${heading.replace(/^#\s*/, "").trim()}`.slice(0, 72);
       }
     }
     if (title === "Update") {
-      if (fs24.existsSync(taskJsonPath)) {
+      if (fs26.existsSync(taskJsonPath)) {
         try {
-          const raw = fs24.readFileSync(taskJsonPath, "utf-8");
+          const raw = fs26.readFileSync(taskJsonPath, "utf-8");
           const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
           const task = JSON.parse(cleaned);
           if (task.title) title = `${prefix}: ${task.title}`.slice(0, 72);
@@ -4882,7 +4981,7 @@ function executeShipStage(ctx, _def) {
         } catch {
         }
       }
-      fs24.writeFileSync(shipPath, `# Ship
+      fs26.writeFileSync(shipPath, `# Ship
 
 Updated existing PR: ${existingPr.url}
 PR #${existingPr.number}
@@ -4903,20 +5002,20 @@ PR #${existingPr.number}
           } catch {
           }
         }
-        fs24.writeFileSync(shipPath, `# Ship
+        fs26.writeFileSync(shipPath, `# Ship
 
 PR created: ${pr.url}
 PR #${pr.number}
 `);
       } else {
-        fs24.writeFileSync(shipPath, "# Ship\n\nPushed branch but failed to create PR.\n");
+        fs26.writeFileSync(shipPath, "# Ship\n\nPushed branch but failed to create PR.\n");
       }
     }
     return { outcome: "completed", outputFile: "ship.md", retries: 0 };
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     try {
-      fs24.writeFileSync(shipPath, `# Ship
+      fs26.writeFileSync(shipPath, `# Ship
 
 Failed: ${msg}
 `);
@@ -4965,15 +5064,15 @@ var init_executor_registry = __esm({
 });
 
 // src/pipeline/questions.ts
-import * as fs25 from "fs";
-import * as path23 from "path";
+import * as fs27 from "fs";
+import * as path25 from "path";
 function checkForQuestions(ctx, stageName) {
   if (ctx.input.local || !ctx.input.issueNumber) return false;
   try {
     if (stageName === "taskify") {
-      const taskJsonPath = path23.join(ctx.taskDir, "task.json");
-      if (!fs25.existsSync(taskJsonPath)) return false;
-      const raw = fs25.readFileSync(taskJsonPath, "utf-8");
+      const taskJsonPath = path25.join(ctx.taskDir, "task.json");
+      if (!fs27.existsSync(taskJsonPath)) return false;
+      const raw = fs27.readFileSync(taskJsonPath, "utf-8");
       const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
       const taskJson = JSON.parse(cleaned);
       if (taskJson.questions && Array.isArray(taskJson.questions) && taskJson.questions.length > 0) {
@@ -4988,9 +5087,9 @@ Reply with \`@kody approve\` and your answers in the comment body.`;
       }
     }
     if (stageName === "plan") {
-      const planPath = path23.join(ctx.taskDir, "plan.md");
-      if (!fs25.existsSync(planPath)) return false;
-      const plan = fs25.readFileSync(planPath, "utf-8");
+      const planPath = path25.join(ctx.taskDir, "plan.md");
+      if (!fs27.existsSync(planPath)) return false;
+      const plan = fs27.readFileSync(planPath, "utf-8");
       const questionsMatch = plan.match(/## Questions\s*\n([\s\S]*?)(?=\n## |\n*$)/);
       if (questionsMatch) {
         const questionsText = questionsMatch[1].trim();
@@ -5019,12 +5118,15 @@ var init_questions = __esm({
 });
 
 // src/pipeline/hooks.ts
-import * as fs26 from "fs";
-import * as path24 from "path";
+import * as fs28 from "fs";
+import * as path26 from "path";
 function applyPreStageLabel(ctx, def) {
   if (!ctx.input.issueNumber || ctx.input.local) return;
+  if (def.name === "plan") setLifecycleLabel(ctx.input.issueNumber, "planning");
   if (def.name === "build") setLifecycleLabel(ctx.input.issueNumber, "building");
+  if (def.name === "verify") setLifecycleLabel(ctx.input.issueNumber, "verifying");
   if (def.name === "review") setLifecycleLabel(ctx.input.issueNumber, "review");
+  if (def.name === "review-fix") setLifecycleLabel(ctx.input.issueNumber, "fixing");
   if (def.name === "ship") setLifecycleLabel(ctx.input.issueNumber, "shipping");
 }
 function checkQuestionsAfterStage(ctx, def, state) {
@@ -5058,9 +5160,9 @@ function autoDetectComplexity(ctx, def) {
     return { complexity, activeStages };
   }
   try {
-    const taskJsonPath = path24.join(ctx.taskDir, "task.json");
-    if (!fs26.existsSync(taskJsonPath)) return null;
-    const raw = fs26.readFileSync(taskJsonPath, "utf-8");
+    const taskJsonPath = path26.join(ctx.taskDir, "task.json");
+    if (!fs28.existsSync(taskJsonPath)) return null;
+    const raw = fs28.readFileSync(taskJsonPath, "utf-8");
     const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
     const taskJson = JSON.parse(cleaned);
     if (!taskJson.risk_level || !isValidComplexity(taskJson.risk_level)) return null;
@@ -5090,8 +5192,8 @@ function checkRiskGate(ctx, def, state, complexity) {
   if (ctx.input.dryRun || ctx.input.local) return null;
   if (ctx.input.mode === "rerun") return null;
   if (!ctx.input.issueNumber) return null;
-  const planPath = path24.join(ctx.taskDir, "plan.md");
-  const plan = fs26.existsSync(planPath) ? fs26.readFileSync(planPath, "utf-8").slice(0, 1500) : "(plan not available)";
+  const planPath = path26.join(ctx.taskDir, "plan.md");
+  const plan = fs28.existsSync(planPath) ? fs28.readFileSync(planPath, "utf-8").slice(0, 1500) : "(plan not available)";
   try {
     postComment(
       ctx.input.issueNumber,
@@ -5158,22 +5260,22 @@ var init_hooks = __esm({
 });
 
 // src/learning/auto-learn.ts
-import * as fs27 from "fs";
-import * as path25 from "path";
+import * as fs29 from "fs";
+import * as path27 from "path";
 function stripAnsi(str) {
   return str.replace(/\x1b\[[0-9;]*m/g, "");
 }
 function autoLearn(ctx) {
   try {
-    const memoryDir = path25.join(ctx.projectDir, ".kody", "memory");
-    if (!fs27.existsSync(memoryDir)) {
-      fs27.mkdirSync(memoryDir, { recursive: true });
+    const memoryDir = path27.join(ctx.projectDir, ".kody", "memory");
+    if (!fs29.existsSync(memoryDir)) {
+      fs29.mkdirSync(memoryDir, { recursive: true });
     }
     const learnings = [];
     const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-    const verifyPath = path25.join(ctx.taskDir, "verify.md");
-    if (fs27.existsSync(verifyPath)) {
-      const verify = stripAnsi(fs27.readFileSync(verifyPath, "utf-8"));
+    const verifyPath = path27.join(ctx.taskDir, "verify.md");
+    if (fs29.existsSync(verifyPath)) {
+      const verify = stripAnsi(fs29.readFileSync(verifyPath, "utf-8"));
       if (/vitest/i.test(verify)) learnings.push("- Uses vitest for testing");
       if (/jest/i.test(verify)) learnings.push("- Uses jest for testing");
       if (/eslint/i.test(verify)) learnings.push("- Uses eslint for linting");
@@ -5182,18 +5284,18 @@ function autoLearn(ctx) {
       if (/jsdom/i.test(verify)) learnings.push("- Test environment: jsdom");
       if (/node/i.test(verify) && /environment/i.test(verify)) learnings.push("- Test environment: node");
     }
-    const reviewPath = path25.join(ctx.taskDir, "review.md");
-    if (fs27.existsSync(reviewPath)) {
-      const review = fs27.readFileSync(reviewPath, "utf-8");
+    const reviewPath = path27.join(ctx.taskDir, "review.md");
+    if (fs29.existsSync(reviewPath)) {
+      const review = fs29.readFileSync(reviewPath, "utf-8");
       if (/\.js extension/i.test(review)) learnings.push("- Imports use .js extensions (ESM)");
       if (/barrel export/i.test(review)) learnings.push("- Uses barrel exports (index.ts)");
       if (/timezone/i.test(review)) learnings.push("- Timezone handling is a concern in this codebase");
       if (/UTC/i.test(review)) learnings.push("- Date operations should consider UTC vs local time");
     }
-    const taskJsonPath = path25.join(ctx.taskDir, "task.json");
-    if (fs27.existsSync(taskJsonPath)) {
+    const taskJsonPath = path27.join(ctx.taskDir, "task.json");
+    if (fs29.existsSync(taskJsonPath)) {
       try {
-        const raw = stripAnsi(fs27.readFileSync(taskJsonPath, "utf-8"));
+        const raw = stripAnsi(fs29.readFileSync(taskJsonPath, "utf-8"));
         const cleaned = raw.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
         const task = JSON.parse(cleaned);
         if (task.scope && Array.isArray(task.scope)) {
@@ -5204,12 +5306,12 @@ function autoLearn(ctx) {
       }
     }
     if (learnings.length > 0) {
-      const conventionsPath = path25.join(memoryDir, "conventions.md");
+      const conventionsPath = path27.join(memoryDir, "conventions.md");
       const entry = `
 ## Learned ${timestamp2} (task: ${ctx.taskId})
 ${learnings.join("\n")}
 `;
-      fs27.appendFileSync(conventionsPath, entry);
+      fs29.appendFileSync(conventionsPath, entry);
       logger.info(`Auto-learned ${learnings.length} convention(s)`);
     }
     autoLearnArchitecture(ctx.projectDir, memoryDir, timestamp2);
@@ -5217,8 +5319,8 @@ ${learnings.join("\n")}
   }
 }
 function autoLearnArchitecture(projectDir, memoryDir, timestamp2) {
-  const archPath = path25.join(memoryDir, "architecture.md");
-  if (fs27.existsSync(archPath)) return;
+  const archPath = path27.join(memoryDir, "architecture.md");
+  if (fs29.existsSync(archPath)) return;
   const detected = detectArchitectureBasic(projectDir);
   if (detected.length > 0) {
     const content = `# Architecture (auto-detected ${timestamp2})
@@ -5226,7 +5328,7 @@ function autoLearnArchitecture(projectDir, memoryDir, timestamp2) {
 ## Overview
 ${detected.join("\n")}
 `;
-    fs27.writeFileSync(archPath, content);
+    fs29.writeFileSync(archPath, content);
     logger.info(`Auto-detected architecture (${detected.length} items)`);
   }
 }
@@ -5239,13 +5341,13 @@ var init_auto_learn = __esm({
 });
 
 // src/retrospective.ts
-import * as fs28 from "fs";
-import * as path26 from "path";
+import * as fs30 from "fs";
+import * as path28 from "path";
 function readArtifact(taskDir, filename, maxChars) {
-  const p = path26.join(taskDir, filename);
-  if (!fs28.existsSync(p)) return null;
+  const p = path28.join(taskDir, filename);
+  if (!fs30.existsSync(p)) return null;
   try {
-    const content = fs28.readFileSync(p, "utf-8");
+    const content = fs30.readFileSync(p, "utf-8");
     return content.length > maxChars ? content.slice(0, maxChars) + "\n...(truncated)" : content;
   } catch {
     return null;
@@ -5298,13 +5400,13 @@ function collectRunContext(ctx, state, pipelineStartTime) {
   return lines.join("\n");
 }
 function getLogPath(projectDir) {
-  return path26.join(projectDir, ".kody", "memory", "observer-log.jsonl");
+  return path28.join(projectDir, ".kody", "memory", "observer-log.jsonl");
 }
 function readPreviousRetrospectives(projectDir, limit = 10) {
   const logPath = getLogPath(projectDir);
-  if (!fs28.existsSync(logPath)) return [];
+  if (!fs30.existsSync(logPath)) return [];
   try {
-    const content = fs28.readFileSync(logPath, "utf-8");
+    const content = fs30.readFileSync(logPath, "utf-8");
     const lines = content.split("\n").filter(Boolean);
     const entries = [];
     const start = Math.max(0, lines.length - limit);
@@ -5331,11 +5433,11 @@ function formatPreviousEntries(entries) {
 }
 function appendRetrospectiveEntry(projectDir, entry) {
   const logPath = getLogPath(projectDir);
-  const dir = path26.dirname(logPath);
-  if (!fs28.existsSync(dir)) {
-    fs28.mkdirSync(dir, { recursive: true });
+  const dir = path28.dirname(logPath);
+  if (!fs30.existsSync(dir)) {
+    fs30.mkdirSync(dir, { recursive: true });
   }
-  fs28.appendFileSync(logPath, JSON.stringify(entry) + "\n");
+  fs30.appendFileSync(logPath, JSON.stringify(entry) + "\n");
 }
 async function runRetrospective(ctx, state, pipelineStartTime) {
   if (ctx.input.dryRun) return;
@@ -5503,8 +5605,8 @@ var init_summary = __esm({
 });
 
 // src/pipeline.ts
-import * as fs29 from "fs";
-import * as path27 from "path";
+import * as fs31 from "fs";
+import * as path29 from "path";
 function ensureFeatureBranchIfNeeded(ctx) {
   if (ctx.input.dryRun) return;
   if (ctx.input.prNumber) {
@@ -5517,8 +5619,8 @@ function ensureFeatureBranchIfNeeded(ctx) {
   }
   if (!ctx.input.issueNumber) return;
   try {
-    const taskMdPath = path27.join(ctx.taskDir, "task.md");
-    const title = fs29.existsSync(taskMdPath) ? fs29.readFileSync(taskMdPath, "utf-8").split("\n")[0].slice(0, 50) : ctx.taskId;
+    const taskMdPath = path29.join(ctx.taskDir, "task.md");
+    const title = fs31.existsSync(taskMdPath) ? fs31.readFileSync(taskMdPath, "utf-8").split("\n")[0].slice(0, 50) : ctx.taskId;
     ensureFeatureBranch(ctx.input.issueNumber, title, ctx.projectDir);
     syncWithDefault(ctx.projectDir);
   } catch (err) {
@@ -5532,10 +5634,10 @@ function ensureFeatureBranchIfNeeded(ctx) {
   }
 }
 function acquireLock(taskDir) {
-  const lockPath = path27.join(taskDir, ".lock");
-  if (fs29.existsSync(lockPath)) {
+  const lockPath = path29.join(taskDir, ".lock");
+  if (fs31.existsSync(lockPath)) {
     try {
-      const pid = parseInt(fs29.readFileSync(lockPath, "utf-8").trim(), 10);
+      const pid = parseInt(fs31.readFileSync(lockPath, "utf-8").trim(), 10);
       if (!isNaN(pid)) {
         try {
           process.kill(pid, 0);
@@ -5552,14 +5654,14 @@ function acquireLock(taskDir) {
       logger.warn(`  Corrupt lock file \u2014 overwriting`);
     }
     try {
-      fs29.unlinkSync(lockPath);
+      fs31.unlinkSync(lockPath);
     } catch {
     }
   }
   try {
-    const fd = fs29.openSync(lockPath, fs29.constants.O_WRONLY | fs29.constants.O_CREAT | fs29.constants.O_EXCL);
-    fs29.writeSync(fd, String(process.pid));
-    fs29.closeSync(fd);
+    const fd = fs31.openSync(lockPath, fs31.constants.O_WRONLY | fs31.constants.O_CREAT | fs31.constants.O_EXCL);
+    fs31.writeSync(fd, String(process.pid));
+    fs31.closeSync(fd);
   } catch (err) {
     if (err.code === "EEXIST") {
       throw new Error("Pipeline already running (lock acquired by another process)");
@@ -5569,7 +5671,7 @@ function acquireLock(taskDir) {
 }
 function releaseLock(taskDir) {
   try {
-    fs29.unlinkSync(path27.join(taskDir, ".lock"));
+    fs31.unlinkSync(path29.join(taskDir, ".lock"));
   } catch {
   }
 }
@@ -5628,6 +5730,11 @@ async function runPipelineInner(ctx) {
     setLifecycleLabel(ctx.input.issueNumber, initialPhase);
   }
   ensureFeatureBranchIfNeeded(ctx);
+  if (ctx.tools?.length) {
+    ciGroup("Tool Setup");
+    runToolSetup(ctx.tools, ctx.projectDir);
+    ciGroupEnd();
+  }
   let complexity = ctx.input.complexity ?? "high";
   let activeStages = filterByComplexity(STAGES, complexity);
   let skippedStagesCommentPosted = false;
@@ -5773,12 +5880,13 @@ var init_pipeline = __esm({
     init_retrospective();
     init_summary();
     init_config();
+    init_tools();
   }
 });
 
 // src/preflight.ts
 import { execFileSync as execFileSync16 } from "child_process";
-import * as fs30 from "fs";
+import * as fs32 from "fs";
 function check(name, fn) {
   try {
     const detail = fn() ?? void 0;
@@ -5831,7 +5939,7 @@ function runPreflight() {
       return v;
     }),
     check("package.json", () => {
-      if (!fs30.existsSync("package.json")) throw new Error("not found");
+      if (!fs32.existsSync("package.json")) throw new Error("not found");
     })
   ];
   const failed = checks.filter((c) => !c.ok);
@@ -5908,8 +6016,8 @@ var init_args = __esm({
 });
 
 // src/cli/task-state.ts
-import * as fs31 from "fs";
-import * as path28 from "path";
+import * as fs33 from "fs";
+import * as path30 from "path";
 function resolveTaskAction(issueNumber, existingTaskId, existingState) {
   if (!existingTaskId || !existingState) {
     return { action: "start-fresh", taskId: `${issueNumber}-${generateTaskId()}` };
@@ -5941,11 +6049,11 @@ function resolveTaskAction(issueNumber, existingTaskId, existingState) {
 function resolveForIssue(issueNumber, projectDir) {
   const existingTaskId = findLatestTaskForIssue(issueNumber, projectDir);
   if (existingTaskId) {
-    const statusPath = path28.join(projectDir, ".kody", "tasks", existingTaskId, "status.json");
+    const statusPath = path30.join(projectDir, ".kody", "tasks", existingTaskId, "status.json");
     let existingState = null;
-    if (fs31.existsSync(statusPath)) {
+    if (fs33.existsSync(statusPath)) {
       try {
-        existingState = JSON.parse(fs31.readFileSync(statusPath, "utf-8"));
+        existingState = JSON.parse(fs33.readFileSync(statusPath, "utf-8"));
       } catch {
       }
     }
@@ -6102,8 +6210,8 @@ var init_resolve = __esm({
 
 // src/entry.ts
 var entry_exports = {};
-import * as fs32 from "fs";
-import * as path29 from "path";
+import * as fs34 from "fs";
+import * as path31 from "path";
 async function ensureLitellmProxy(config, projectDir) {
   if (!anyStageNeedsProxy(config)) return null;
   const litellmUrl = getLitellmUrl();
@@ -6158,9 +6266,9 @@ async function runModelHealthCheck(config) {
 }
 async function main() {
   const input = parseArgs();
-  const projectDir = input.cwd ? path29.resolve(input.cwd) : process.cwd();
+  const projectDir = input.cwd ? path31.resolve(input.cwd) : process.cwd();
   if (input.cwd) {
-    if (!fs32.existsSync(projectDir)) {
+    if (!fs34.existsSync(projectDir)) {
       console.error(`--cwd path does not exist: ${projectDir}`);
       process.exit(1);
     }
@@ -6220,8 +6328,8 @@ async function main() {
       process.exit(1);
     }
   }
-  const taskDir = path29.join(projectDir, ".kody", "tasks", taskId);
-  fs32.mkdirSync(taskDir, { recursive: true });
+  const taskDir = path31.join(projectDir, ".kody", "tasks", taskId);
+  fs34.mkdirSync(taskDir, { recursive: true });
   if (input.command === "rerun" && isTaskifyRun(taskDir)) {
     const marker = readTaskifyMarker(taskDir);
     if (marker) {
@@ -6353,31 +6461,31 @@ async function main() {
   logger.info("Preflight checks:");
   runPreflight();
   if (input.task) {
-    fs32.writeFileSync(path29.join(taskDir, "task.md"), input.task);
+    fs34.writeFileSync(path31.join(taskDir, "task.md"), input.task);
   }
-  const taskMdPath = path29.join(taskDir, "task.md");
-  if (!fs32.existsSync(taskMdPath) && isPRFix && input.prNumber) {
+  const taskMdPath = path31.join(taskDir, "task.md");
+  if (!fs34.existsSync(taskMdPath) && isPRFix && input.prNumber) {
     logger.info(`Fetching PR #${input.prNumber} details as task context...`);
     const prDetails = getPRDetails(input.prNumber);
     if (prDetails) {
       const taskContent = `# ${prDetails.title}
 
 ${prDetails.body ?? ""}`;
-      fs32.writeFileSync(taskMdPath, taskContent);
+      fs34.writeFileSync(taskMdPath, taskContent);
       logger.info(`  Task loaded from PR #${input.prNumber}: ${prDetails.title}`);
     }
-  } else if (!fs32.existsSync(taskMdPath) && input.issueNumber) {
+  } else if (!fs34.existsSync(taskMdPath) && input.issueNumber) {
     logger.info(`Fetching issue #${input.issueNumber} body as task...`);
     const issue = getIssue(input.issueNumber);
     if (issue) {
       const taskContent = `# ${issue.title}
 
 ${issue.body ?? ""}`;
-      fs32.writeFileSync(taskMdPath, taskContent);
+      fs34.writeFileSync(taskMdPath, taskContent);
       logger.info(`  Task loaded from issue #${input.issueNumber}: ${issue.title}`);
     }
   }
-  if (!fs32.existsSync(taskMdPath)) {
+  if (!fs34.existsSync(taskMdPath)) {
     console.error("No task.md found. Provide --task, --issue-number, or ensure .kody/tasks/<id>/task.md exists.");
     process.exit(1);
   }
@@ -6481,11 +6589,17 @@ ${input.feedback}`);
       prBaseBranch = prDetails.baseBranch;
     }
   }
+  const toolDeclarations = loadToolDeclarations(projectDir);
+  const detectedTools = detectTools(toolDeclarations, projectDir);
+  if (detectedTools.length > 0) {
+    logger.info(`Tools detected: ${detectedTools.map((t) => t.name).join(", ")}`);
+  }
   const ctx = {
     taskId,
     taskDir,
     projectDir,
     runners,
+    tools: detectedTools.length > 0 ? detectedTools : void 0,
     input: {
       mode: input.command === "rerun" || input.command === "fix" || input.command === "fix-ci" ? "rerun" : "full",
       fromStage: input.fromStage,
@@ -6515,7 +6629,7 @@ To rerun: \`@kody rerun ${taskId} --from <stage>\``
     }
   }
   const state = await runPipeline(ctx);
-  const files = fs32.readdirSync(taskDir);
+  const files = fs34.readdirSync(taskDir);
   console.log(`
 Artifacts in ${taskDir}:`);
   for (const f of files) {
@@ -6563,6 +6677,7 @@ var init_entry = __esm({
     init_task_state();
     init_taskify_command();
     init_config();
+    init_tools();
     main().catch(async (err) => {
       const msg = err instanceof Error ? err.message : String(err);
       console.error(msg);
@@ -6580,8 +6695,8 @@ var init_entry = __esm({
 });
 
 // src/bin/cli.ts
-import * as fs33 from "fs";
-import * as path30 from "path";
+import * as fs35 from "fs";
+import * as path32 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/bin/commands/init.ts
@@ -6953,13 +7068,239 @@ function initCommand(opts, pkgRoot) {
 
 // src/bin/commands/bootstrap.ts
 init_architecture_detection();
-import * as fs8 from "fs";
-import * as path7 from "path";
+import * as fs9 from "fs";
+import * as path8 from "path";
 import { execFileSync as execFileSync5 } from "child_process";
 
 // src/bin/qa-guide.ts
+import * as fs6 from "fs";
+import * as path5 from "path";
+
+// src/bin/framework-detectors.ts
 import * as fs5 from "fs";
 import * as path4 from "path";
+function detectFrameworks(cwd) {
+  const frameworks = [];
+  let deps = {};
+  try {
+    const pkg = JSON.parse(fs5.readFileSync(path4.join(cwd, "package.json"), "utf-8"));
+    deps = { ...pkg.dependencies, ...pkg.devDependencies };
+  } catch {
+    return frameworks;
+  }
+  if (deps.payload || deps["@payloadcms/next"]) {
+    frameworks.push({
+      name: "payload-cms",
+      version: deps.payload ?? deps["@payloadcms/next"] ?? null,
+      configFile: findFile(cwd, ["payload.config.ts", "payload-config.ts", "src/payload.config.ts"])
+    });
+  }
+  if (deps["next-auth"]) {
+    frameworks.push({
+      name: "nextauth",
+      version: deps["next-auth"] ?? null,
+      configFile: findFile(cwd, ["auth.ts", "auth.config.ts", "src/auth.ts", "src/auth.config.ts"])
+    });
+  }
+  if (deps.prisma || deps["@prisma/client"]) {
+    frameworks.push({
+      name: "prisma",
+      version: deps.prisma ?? deps["@prisma/client"] ?? null,
+      configFile: findFile(cwd, ["prisma/schema.prisma"])
+    });
+  }
+  return frameworks;
+}
+function findFile(cwd, candidates) {
+  for (const c of candidates) {
+    if (fs5.existsSync(path4.join(cwd, c))) return c;
+  }
+  return null;
+}
+var COLLECTION_DIRS = [
+  "src/server/payload/collections",
+  "src/payload/collections",
+  "src/collections",
+  "payload/collections"
+];
+function discoverPayloadCollections(cwd) {
+  const collections = [];
+  for (const dir of COLLECTION_DIRS) {
+    const fullDir = path4.join(cwd, dir);
+    if (!fs5.existsSync(fullDir)) continue;
+    let files;
+    try {
+      files = fs5.readdirSync(fullDir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+    } catch {
+      continue;
+    }
+    for (const file of files) {
+      try {
+        const filePath = path4.join(fullDir, file);
+        const content = fs5.readFileSync(filePath, "utf-8").slice(0, 1e4);
+        const slugMatch = content.match(/slug:\s*['"]([a-z0-9-]+)['"]/);
+        if (!slugMatch) continue;
+        const slug = slugMatch[1];
+        const name = file.replace(/\.(ts|tsx)$/, "");
+        const fields = [];
+        const fieldMatches = content.matchAll(/name:\s*['"]([a-zA-Z_][a-zA-Z0-9_]*)['"]/g);
+        for (const m of fieldMatches) {
+          if (!fields.includes(m[1])) fields.push(m[1]);
+        }
+        const hasAdmin = /components:\s*\{/.test(content) || /Field:\s*['"]/.test(content) || /Cell:\s*['"]/.test(content) || /views:\s*\{/.test(content);
+        collections.push({
+          name,
+          slug,
+          filePath: path4.relative(cwd, filePath),
+          fields: fields.slice(0, 20),
+          hasAdmin
+        });
+      } catch {
+      }
+    }
+  }
+  return collections;
+}
+var ADMIN_COMPONENT_DIRS = [
+  "src/ui/admin",
+  "src/admin/components",
+  "src/components/admin"
+];
+function discoverAdminComponents(cwd, collections) {
+  const components = [];
+  for (const dir of ADMIN_COMPONENT_DIRS) {
+    const fullDir = path4.join(cwd, dir);
+    if (!fs5.existsSync(fullDir)) continue;
+    let entries;
+    try {
+      entries = fs5.readdirSync(fullDir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const entryPath = path4.join(fullDir, entry.name);
+      let name;
+      let filePath;
+      if (entry.isDirectory()) {
+        const indexFile = ["index.tsx", "index.ts", "index.jsx", "index.js"].find((f) => fs5.existsSync(path4.join(entryPath, f)));
+        if (!indexFile) continue;
+        name = entry.name;
+        filePath = path4.relative(cwd, path4.join(entryPath, indexFile));
+      } else if (/\.(tsx?|jsx?)$/.test(entry.name)) {
+        name = entry.name.replace(/\.(tsx?|jsx?)$/, "");
+        filePath = path4.relative(cwd, entryPath);
+      } else {
+        continue;
+      }
+      let usedInCollection = null;
+      if (collections) {
+        for (const col of collections) {
+          try {
+            const colContent = fs5.readFileSync(path4.join(cwd, col.filePath), "utf-8");
+            if (colContent.includes(name)) {
+              usedInCollection = col.slug;
+              break;
+            }
+          } catch {
+          }
+        }
+      }
+      components.push({ name, filePath, usedInCollection });
+    }
+  }
+  return components;
+}
+var HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+function scanApiRoutes(cwd) {
+  const routes = [];
+  const appDirs = ["src/app", "app"];
+  for (const appDir of appDirs) {
+    const apiDir = path4.join(cwd, appDir, "api");
+    if (!fs5.existsSync(apiDir)) continue;
+    walkApiRoutes(apiDir, "/api", cwd, routes);
+    break;
+  }
+  return routes;
+}
+function walkApiRoutes(dir, prefix, cwd, routes) {
+  let entries;
+  try {
+    entries = fs5.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  const routeFile = entries.find((e) => e.isFile() && /^route\.(ts|js|tsx|jsx)$/.test(e.name));
+  if (routeFile) {
+    try {
+      const content = fs5.readFileSync(path4.join(dir, routeFile.name), "utf-8").slice(0, 5e3);
+      const methods = HTTP_METHODS.filter(
+        (m) => new RegExp(`export\\s+(?:async\\s+)?function\\s+${m}\\b`).test(content)
+      );
+      if (methods.length > 0) {
+        routes.push({
+          path: prefix,
+          methods,
+          filePath: path4.relative(cwd, path4.join(dir, routeFile.name))
+        });
+      }
+    } catch {
+    }
+  }
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name === "node_modules" || entry.name === ".next") continue;
+    let segment = entry.name;
+    if (segment.startsWith("(") && segment.endsWith(")")) {
+      walkApiRoutes(path4.join(dir, entry.name), prefix, cwd, routes);
+      continue;
+    }
+    if (segment.startsWith("[[") && segment.endsWith("]]")) {
+      segment = `:${segment.slice(2, -2)}?`;
+    } else if (segment.startsWith("[") && segment.endsWith("]")) {
+      segment = `:${segment.slice(1, -1)}`;
+    }
+    walkApiRoutes(path4.join(dir, entry.name), `${prefix}/${segment}`, cwd, routes);
+  }
+}
+var BUILTIN_ENV_VARS = /* @__PURE__ */ new Set([
+  "NODE_ENV",
+  "HOME",
+  "PATH",
+  "USER",
+  "SHELL",
+  "TERM",
+  "LANG",
+  "PWD",
+  "HOSTNAME",
+  "PORT",
+  "CI",
+  "GITHUB_ACTIONS"
+]);
+function scanEnvVars(cwd) {
+  const envFiles = [".env.example", ".env.local.example", ".env.template"];
+  for (const envFile of envFiles) {
+    const envPath = path4.join(cwd, envFile);
+    if (!fs5.existsSync(envPath)) continue;
+    try {
+      const content = fs5.readFileSync(envPath, "utf-8");
+      const vars = [];
+      for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const match = trimmed.match(/^([A-Z][A-Z0-9_]*)=/);
+        if (match && !BUILTIN_ENV_VARS.has(match[1])) {
+          vars.push(match[1]);
+        }
+      }
+      return vars;
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+
+// src/bin/qa-guide.ts
 function discoverQaContext(cwd) {
   const result2 = {
     routes: [],
@@ -6968,12 +7309,17 @@ function discoverQaContext(cwd) {
     adminPath: null,
     roles: [],
     devCommand: "",
-    devPort: 3e3
+    devPort: 3e3,
+    frameworks: [],
+    collections: [],
+    adminComponents: [],
+    apiRoutes: [],
+    envVars: []
   };
   try {
-    const pkg = JSON.parse(fs5.readFileSync(path4.join(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(fs6.readFileSync(path5.join(cwd, "package.json"), "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    const pm = fs5.existsSync(path4.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs5.existsSync(path4.join(cwd, "yarn.lock")) ? "yarn" : "npm";
+    const pm = fs6.existsSync(path5.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs6.existsSync(path5.join(cwd, "yarn.lock")) ? "yarn" : "npm";
     if (pkg.scripts?.dev) result2.devCommand = `${pm} dev`;
     if (allDeps.next || allDeps.nuxt) result2.devPort = 3e3;
     else if (allDeps.vite) result2.devPort = 5173;
@@ -6981,14 +7327,14 @@ function discoverQaContext(cwd) {
   }
   const appDirs = ["src/app", "app"];
   for (const appDir of appDirs) {
-    const fullAppDir = path4.join(cwd, appDir);
-    if (!fs5.existsSync(fullAppDir)) continue;
+    const fullAppDir = path5.join(cwd, appDir);
+    if (!fs6.existsSync(fullAppDir)) continue;
     scanRoutes(fullAppDir, appDir, "", result2);
     break;
   }
   const authPatterns = ["middleware.ts", "middleware.js", "src/middleware.ts", "src/middleware.js"];
   for (const p of authPatterns) {
-    if (fs5.existsSync(path4.join(cwd, p))) result2.authFiles.push(p);
+    if (fs6.existsSync(path5.join(cwd, p))) result2.authFiles.push(p);
   }
   const authConfigGlobs = [
     "src/app/api/auth",
@@ -6999,7 +7345,7 @@ function discoverQaContext(cwd) {
     "src/app/api/oauth"
   ];
   for (const g of authConfigGlobs) {
-    if (fs5.existsSync(path4.join(cwd, g))) result2.authFiles.push(g);
+    if (fs6.existsSync(path5.join(cwd, g))) result2.authFiles.push(g);
   }
   try {
     const rolePaths = [
@@ -7011,12 +7357,12 @@ function discoverQaContext(cwd) {
       "src/collections"
     ];
     for (const rp of rolePaths) {
-      const dir = path4.join(cwd, rp);
-      if (!fs5.existsSync(dir)) continue;
-      const files = fs5.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      const dir = path5.join(cwd, rp);
+      if (!fs6.existsSync(dir)) continue;
+      const files = fs6.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
       for (const f of files) {
         try {
-          const content = fs5.readFileSync(path4.join(dir, f), "utf-8").slice(0, 5e3);
+          const content = fs6.readFileSync(path5.join(dir, f), "utf-8").slice(0, 5e3);
           const roleMatches = content.match(/(?:role|Role|ROLE)\s*[=:]\s*['"](\w+)['"]/g);
           if (roleMatches) {
             for (const m of roleMatches) {
@@ -7040,12 +7386,20 @@ function discoverQaContext(cwd) {
     }
   } catch {
   }
+  result2.frameworks = detectFrameworks(cwd);
+  const hasPayload = result2.frameworks.some((f) => f.name === "payload-cms");
+  if (hasPayload) {
+    result2.collections = discoverPayloadCollections(cwd);
+  }
+  result2.adminComponents = discoverAdminComponents(cwd, result2.collections.length > 0 ? result2.collections : void 0);
+  result2.apiRoutes = scanApiRoutes(cwd);
+  result2.envVars = scanEnvVars(cwd);
   return result2;
 }
 function scanRoutes(dir, baseDir, prefix, result2) {
   let entries;
   try {
-    entries = fs5.readdirSync(dir, { withFileTypes: true });
+    entries = fs6.readdirSync(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -7062,19 +7416,18 @@ function scanRoutes(dir, baseDir, prefix, result2) {
     if (entry.name === "node_modules" || entry.name === ".next") continue;
     let segment = entry.name;
     if (segment.startsWith("(") && segment.endsWith(")")) {
-      scanRoutes(path4.join(dir, entry.name), baseDir, prefix, result2);
+      scanRoutes(path5.join(dir, entry.name), baseDir, prefix, result2);
       continue;
     }
-    if (segment.startsWith("[") && segment.endsWith("]")) {
-      segment = `:${segment.slice(1, -1)}`;
-    }
     if (segment.startsWith("[[") && segment.endsWith("]]")) {
       segment = `:${segment.slice(2, -2)}?`;
+    } else if (segment.startsWith("[") && segment.endsWith("]")) {
+      segment = `:${segment.slice(1, -1)}`;
     }
-    scanRoutes(path4.join(dir, entry.name), baseDir, `${prefix}/${segment}`, result2);
+    scanRoutes(path5.join(dir, entry.name), baseDir, `${prefix}/${segment}`, result2);
   }
 }
-function generateQaGuide(discovery) {
+function generateQaGuideFallback(discovery) {
   const lines = ["# QA Guide", "", "## Authentication", ""];
   if (discovery.loginPage) {
     lines.push(`- Login page: \`${discovery.loginPage}\``);
@@ -7123,6 +7476,39 @@ function generateQaGuide(discovery) {
     }
     lines.push("");
   }
+  if (discovery.collections.length > 0) {
+    lines.push("## Admin Collections", "");
+    for (const col of discovery.collections) {
+      lines.push(`### \`/admin/collections/${col.slug}\``);
+      lines.push(`- **Name:** ${col.name}`);
+      lines.push(`- **Fields:** ${col.fields.join(", ")}`);
+      if (col.hasAdmin) lines.push("- **Custom admin components:** yes");
+      lines.push("");
+    }
+  }
+  if (discovery.apiRoutes.length > 0) {
+    lines.push("## API Endpoints", "");
+    for (const route of discovery.apiRoutes) {
+      lines.push(`- \`${route.methods.join(", ")} ${route.path}\` \u2014 \`${route.filePath}\``);
+    }
+    lines.push("");
+  }
+  if (discovery.adminComponents.length > 0) {
+    lines.push("## Custom Admin Components", "");
+    for (const comp of discovery.adminComponents) {
+      let line = `- **${comp.name}** (\`${comp.filePath}\`)`;
+      if (comp.usedInCollection) line += ` \u2014 used in \`${comp.usedInCollection}\` collection`;
+      lines.push(line);
+    }
+    lines.push("");
+  }
+  if (discovery.envVars.length > 0) {
+    lines.push("## Required Environment Variables", "");
+    for (const v of discovery.envVars) {
+      lines.push(`- \`${v}\``);
+    }
+    lines.push("");
+  }
   lines.push(
     "## Dev Server",
     "",
@@ -7132,10 +7518,71 @@ function generateQaGuide(discovery) {
   );
   return lines.join("\n");
 }
+var MAX_SERIALIZED_LENGTH = 8e3;
+function serializeDiscoveryForLLM(discovery) {
+  const sections = [];
+  sections.push(`Dev server: ${discovery.devCommand || "pnpm dev"} at http://localhost:${discovery.devPort}`);
+  if (discovery.loginPage) sections.push(`Login page: ${discovery.loginPage}`);
+  if (discovery.adminPath) sections.push(`Admin panel: ${discovery.adminPath}`);
+  if (discovery.roles.length > 0) sections.push(`Roles: ${discovery.roles.join(", ")}`);
+  if (discovery.frameworks.length > 0) {
+    sections.push(`
+Frameworks: ${discovery.frameworks.map((f) => `${f.name}${f.version ? ` (${f.version})` : ""}`).join(", ")}`);
+  }
+  if (discovery.collections.length > 0) {
+    sections.push("\nCollections (Payload CMS):");
+    for (const col of discovery.collections.slice(0, 15)) {
+      const fields = col.fields.slice(0, 10).join(", ");
+      let line = `- ${col.slug}: fields=[${fields}]`;
+      if (col.hasAdmin) line += " (has custom admin components)";
+      line += ` \u2014 ${col.filePath}`;
+      sections.push(line);
+    }
+    if (discovery.collections.length > 15) {
+      sections.push(`- ... and ${discovery.collections.length - 15} more collections`);
+    }
+  }
+  if (discovery.adminComponents.length > 0) {
+    sections.push("\nCustom Admin Components:");
+    for (const comp of discovery.adminComponents.slice(0, 10)) {
+      let line = `- ${comp.name} (${comp.filePath})`;
+      if (comp.usedInCollection) line += ` \u2192 used in "${comp.usedInCollection}" collection`;
+      sections.push(line);
+    }
+  }
+  if (discovery.apiRoutes.length > 0) {
+    sections.push("\nAPI Routes:");
+    for (const route of discovery.apiRoutes.slice(0, 20)) {
+      sections.push(`- ${route.methods.join("/")} ${route.path} \u2014 ${route.filePath}`);
+    }
+    if (discovery.apiRoutes.length > 20) {
+      sections.push(`- ... and ${discovery.apiRoutes.length - 20} more routes`);
+    }
+  }
+  if (discovery.routes.length > 0) {
+    sections.push("\nFrontend Routes:");
+    for (const route of discovery.routes.slice(0, 30)) {
+      sections.push(`- [${route.group}] ${route.path}`);
+    }
+    if (discovery.routes.length > 30) {
+      sections.push(`- ... and ${discovery.routes.length - 30} more routes`);
+    }
+  }
+  if (discovery.envVars.length > 0) {
+    sections.push(`
+Required env vars: ${discovery.envVars.join(", ")}`);
+  }
+  let result2 = sections.join("\n");
+  if (result2.length > MAX_SERIALIZED_LENGTH) {
+    const cutoff = result2.lastIndexOf("\n", MAX_SERIALIZED_LENGTH - 20);
+    result2 = result2.slice(0, cutoff > 0 ? cutoff : MAX_SERIALIZED_LENGTH - 20) + "\n... (truncated)";
+  }
+  return result2;
+}
 
 // src/bin/skills.ts
-import * as fs6 from "fs";
-import * as path5 from "path";
+import * as fs7 from "fs";
+import * as path6 from "path";
 import { execFileSync as execFileSync4 } from "child_process";
 var SKILL_MAPPINGS = [
   {
@@ -7158,10 +7605,10 @@ var SKILL_MAPPINGS = [
   }
 ];
 function detectSkillsForProject(cwd) {
-  const pkgPath = path5.join(cwd, "package.json");
-  if (!fs6.existsSync(pkgPath)) return [];
+  const pkgPath = path6.join(cwd, "package.json");
+  if (!fs7.existsSync(pkgPath)) return [];
   try {
-    const pkg = JSON.parse(fs6.readFileSync(pkgPath, "utf-8"));
+    const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf-8"));
     const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
     const seen = /* @__PURE__ */ new Set();
     const skills = [];
@@ -7187,10 +7634,10 @@ function installSkillsForProject(cwd) {
     return [];
   }
   let installedSkills = {};
-  const lockPath = path5.join(cwd, "skills-lock.json");
-  if (fs6.existsSync(lockPath)) {
+  const lockPath = path6.join(cwd, "skills-lock.json");
+  if (fs7.existsSync(lockPath)) {
     try {
-      const lock = JSON.parse(fs6.readFileSync(lockPath, "utf-8"));
+      const lock = JSON.parse(fs7.readFileSync(lockPath, "utf-8"));
       installedSkills = lock.skills ?? {};
     } catch {
     }
@@ -7202,8 +7649,8 @@ function installSkillsForProject(cwd) {
       console.log(`  \u25CB ${skill.label} \u2014 already installed`);
       const agentPath = `.agents/skills/${skillName}`;
       const claudePath = `.claude/skills/${skillName}`;
-      if (fs6.existsSync(path5.join(cwd, agentPath))) installedPaths.push(agentPath);
-      if (fs6.existsSync(path5.join(cwd, claudePath))) installedPaths.push(claudePath);
+      if (fs7.existsSync(path6.join(cwd, agentPath))) installedPaths.push(agentPath);
+      if (fs7.existsSync(path6.join(cwd, claudePath))) installedPaths.push(claudePath);
       continue;
     }
     try {
@@ -7217,8 +7664,8 @@ function installSkillsForProject(cwd) {
       const installedName = skill.package.split("@").pop() ?? "";
       const agentPath = `.agents/skills/${installedName}`;
       const claudePath = `.claude/skills/${installedName}`;
-      if (fs6.existsSync(path5.join(cwd, agentPath))) installedPaths.push(agentPath);
-      if (fs6.existsSync(path5.join(cwd, claudePath))) installedPaths.push(claudePath);
+      if (fs7.existsSync(path6.join(cwd, agentPath))) installedPaths.push(agentPath);
+      if (fs7.existsSync(path6.join(cwd, claudePath))) installedPaths.push(claudePath);
       console.log(`  \u2713 ${skill.label}`);
     } catch {
       console.log(`  \u2717 ${skill.label} \u2014 failed to install`);
@@ -7229,22 +7676,47 @@ function installSkillsForProject(cwd) {
 
 // src/bin/commands/bootstrap.ts
 init_config();
+
+// src/bin/extend-helpers.ts
+var MAX_EXISTING_CONTENT_LENGTH = 6e3;
+function buildExtendInstruction(existingContent, fileDescription) {
+  if (!existingContent.trim()) return "";
+  let content = existingContent;
+  if (content.length > MAX_EXISTING_CONTENT_LENGTH) {
+    const cutoff = content.lastIndexOf("\n", MAX_EXISTING_CONTENT_LENGTH);
+    content = content.slice(0, cutoff > 0 ? cutoff : MAX_EXISTING_CONTENT_LENGTH) + "\n... (truncated)";
+  }
+  return `
+## Existing ${fileDescription} (EXTEND, do not replace)
+You are UPDATING an existing ${fileDescription}. Follow these rules strictly:
+- PRESERVE all existing sections and content that are still accurate \u2014 keep them verbatim
+- PRESERVE any manually-added sections, custom notes, or user edits
+- REMOVE only lines that reference files, patterns, or dependencies that no longer exist in the project
+- APPEND new sections or lines for newly discovered patterns, files, or conventions
+- Do NOT rewrite sections that are still correct
+
+### Existing content:
+${content}
+`;
+}
+
+// src/bin/commands/bootstrap.ts
 var STEP_STAGES = ["taskify", "plan", "build", "autofix", "review", "review-fix"];
 function gatherSampleSourceFiles(cwd, maxFiles = 3, maxCharsEach = 2e3) {
-  const srcDir = path7.join(cwd, "src");
-  const baseDir = fs8.existsSync(srcDir) ? srcDir : cwd;
+  const srcDir = path8.join(cwd, "src");
+  const baseDir = fs9.existsSync(srcDir) ? srcDir : cwd;
   const results = [];
   function walk(dir) {
     const entries = [];
     try {
-      for (const entry of fs8.readdirSync(dir, { withFileTypes: true })) {
+      for (const entry of fs9.readdirSync(dir, { withFileTypes: true })) {
         if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
-        const full = path7.join(dir, entry.name);
+        const full = path8.join(dir, entry.name);
         if (entry.isDirectory()) {
           entries.push(...walk(full));
         } else if (/\.(ts|js)$/.test(entry.name) && !/\.(test|spec|config|d)\.(ts|js)$/.test(entry.name)) {
           try {
-            const stat = fs8.statSync(full);
+            const stat = fs9.statSync(full);
             if (stat.size >= 200 && stat.size <= 5e3) {
               entries.push({ filePath: full, size: stat.size });
             }
@@ -7258,8 +7730,8 @@ function gatherSampleSourceFiles(cwd, maxFiles = 3, maxCharsEach = 2e3) {
   }
   const files = walk(baseDir).sort((a, b) => b.size - a.size).slice(0, maxFiles);
   for (const { filePath } of files) {
-    const rel = path7.relative(cwd, filePath);
-    const content = fs8.readFileSync(filePath, "utf-8").slice(0, maxCharsEach);
+    const rel = path8.relative(cwd, filePath);
+    const content = fs9.readFileSync(filePath, "utf-8").slice(0, maxCharsEach);
     results.push(`### File: ${rel}
 \`\`\`typescript
 ${content}
@@ -7271,9 +7743,9 @@ function ghComment(issueNumber, body, cwd) {
   try {
     let repoSlug = "";
     try {
-      const configPath = path7.join(cwd, "kody.config.json");
-      if (fs8.existsSync(configPath)) {
-        const config = JSON.parse(fs8.readFileSync(configPath, "utf-8"));
+      const configPath = path8.join(cwd, "kody.config.json");
+      if (fs9.existsSync(configPath)) {
+        const config = JSON.parse(fs9.readFileSync(configPath, "utf-8"));
         if (config.github?.owner && config.github?.repo) {
           repoSlug = `${config.github.owner}/${config.github.repo}`;
         }
@@ -7310,8 +7782,8 @@ function bootstrapCommand(opts, pkgRoot) {
     ghComment(issueNumber, "\u{1F527} **Bootstrap started** \u2014 analyzing project and generating configuration...", cwd);
   }
   const readIfExists = (rel, maxChars = 3e3) => {
-    const p = path7.join(cwd, rel);
-    if (fs8.existsSync(p)) return fs8.readFileSync(p, "utf-8").slice(0, maxChars);
+    const p = path8.join(cwd, rel);
+    if (fs9.existsSync(p)) return fs9.readFileSync(p, "utf-8").slice(0, maxChars);
     return null;
   };
   let repoContext = "";
@@ -7346,14 +7818,14 @@ ${sampleFiles}
 
 `;
   try {
-    const topDirs = fs8.readdirSync(cwd, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules").map((e) => e.name);
+    const topDirs = fs9.readdirSync(cwd, { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules").map((e) => e.name);
     repoContext += `## Top-level directories
 ${topDirs.join(", ")}
 
 `;
-    const srcDir = path7.join(cwd, "src");
-    if (fs8.existsSync(srcDir)) {
-      const srcDirs = fs8.readdirSync(srcDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
+    const srcDir = path8.join(cwd, "src");
+    if (fs9.existsSync(srcDir)) {
+      const srcDirs = fs9.readdirSync(srcDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name);
       if (srcDirs.length > 0) repoContext += `## src/ subdirectories
 ${srcDirs.join(", ")}
 
@@ -7363,34 +7835,28 @@ ${srcDirs.join(", ")}
   }
   const existingFiles = [];
   for (const f of [".env.example", "CLAUDE.md", ".ai-docs", "vitest.config.ts", "vitest.config.mts", "jest.config.ts", "playwright.config.ts", ".eslintrc.js", "eslint.config.mjs", ".prettierrc"]) {
-    if (fs8.existsSync(path7.join(cwd, f))) existingFiles.push(f);
+    if (fs9.existsSync(path8.join(cwd, f))) existingFiles.push(f);
   }
   if (existingFiles.length) repoContext += `## Config files present
 ${existingFiles.join(", ")}
 
 `;
   console.log("\u2500\u2500 Project Memory \u2500\u2500");
-  const memoryDir = path7.join(cwd, ".kody", "memory");
-  fs8.mkdirSync(memoryDir, { recursive: true });
-  const archPath = path7.join(memoryDir, "architecture.md");
-  const conventionsPath = path7.join(memoryDir, "conventions.md");
-  const existingArch = fs8.existsSync(archPath) ? fs8.readFileSync(archPath, "utf-8") : "";
-  const existingConv = fs8.existsSync(conventionsPath) ? fs8.readFileSync(conventionsPath, "utf-8") : "";
+  const memoryDir = path8.join(cwd, ".kody", "memory");
+  fs9.mkdirSync(memoryDir, { recursive: true });
+  const archPath = path8.join(memoryDir, "architecture.md");
+  const conventionsPath = path8.join(memoryDir, "conventions.md");
+  const existingArch = fs9.existsSync(archPath) ? fs9.readFileSync(archPath, "utf-8") : "";
+  const existingConv = fs9.existsSync(conventionsPath) ? fs9.readFileSync(conventionsPath, "utf-8") : "";
   const hasExisting = !!(existingArch || existingConv);
-  const extendInstruction = hasExisting && !opts.force ? `
-## Existing Documentation (EXTEND, do not replace)
-You are UPDATING existing documentation. Follow these rules strictly:
-- PRESERVE all existing sections and content that are still accurate
-- REMOVE only lines that reference files, patterns, or dependencies that no longer exist in the project
-- APPEND new sections or lines for newly discovered patterns, files, or conventions
-- Do NOT rewrite sections that are still correct \u2014 keep them verbatim
-
-### Existing architecture.md:
+  const extendInstruction = hasExisting && !opts.force ? buildExtendInstruction(
+    `### architecture.md:
 ${existingArch}
 
-### Existing conventions.md:
-${existingConv}
-` : "";
+### conventions.md:
+${existingConv}`,
+    "project documentation"
+  ) : "";
   const memoryPrompt = `You are analyzing a project to generate documentation for an autonomous SDLC pipeline.
 
 Given this project context, output ONLY a JSON object with EXACTLY this structure:
@@ -7431,12 +7897,12 @@ ${repoContext}`;
     const cleaned = output.replace(/^```json\s*\n?/m, "").replace(/\n?```\s*$/m, "");
     const parsed = JSON.parse(cleaned);
     if (parsed.architecture) {
-      fs8.writeFileSync(archPath, parsed.architecture);
+      fs9.writeFileSync(archPath, parsed.architecture);
       const lineCount = parsed.architecture.split("\n").length;
       console.log(`  \u2713 .kody/memory/architecture.md (${lineCount} lines)`);
     }
     if (parsed.conventions) {
-      fs8.writeFileSync(conventionsPath, parsed.conventions);
+      fs9.writeFileSync(conventionsPath, parsed.conventions);
       const lineCount = parsed.conventions.split("\n").length;
       console.log(`  \u2713 .kody/memory/conventions.md (${lineCount} lines)`);
     }
@@ -7445,45 +7911,44 @@ ${repoContext}`;
     const detected = detectArchitectureBasic(cwd);
     if (detected.length > 0) {
       const timestamp2 = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-      fs8.writeFileSync(archPath, `# Architecture (auto-detected ${timestamp2})
+      fs9.writeFileSync(archPath, `# Architecture (auto-detected ${timestamp2})
 
 ## Overview
 ${detected.join("\n")}
 `);
       console.log(`  \u2713 .kody/memory/architecture.md (${detected.length} items, basic detection)`);
     }
-    fs8.writeFileSync(conventionsPath, "# Conventions\n\n<!-- Auto-learned conventions will be appended here -->\n");
+    fs9.writeFileSync(conventionsPath, "# Conventions\n\n<!-- Auto-learned conventions will be appended here -->\n");
     console.log("  \u2713 .kody/memory/conventions.md (seed)");
   }
   console.log("\n\u2500\u2500 Step Files \u2500\u2500");
-  const stepsDir = path7.join(cwd, ".kody", "steps");
-  fs8.mkdirSync(stepsDir, { recursive: true });
-  const arch = fs8.existsSync(archPath) ? fs8.readFileSync(archPath, "utf-8") : "";
-  const conv = fs8.existsSync(conventionsPath) ? fs8.readFileSync(conventionsPath, "utf-8") : "";
+  const stepsDir = path8.join(cwd, ".kody", "steps");
+  fs9.mkdirSync(stepsDir, { recursive: true });
+  const arch = fs9.existsSync(archPath) ? fs9.readFileSync(archPath, "utf-8") : "";
+  const conv = fs9.existsSync(conventionsPath) ? fs9.readFileSync(conventionsPath, "utf-8") : "";
   console.log("  \u23F3 Customizing step files...");
   let stepCount = 0;
   for (const stage of STEP_STAGES) {
-    const templatePath = path7.join(pkgRoot, "prompts", `${stage}.md`);
-    if (!fs8.existsSync(templatePath)) {
+    const templatePath = path8.join(pkgRoot, "prompts", `${stage}.md`);
+    if (!fs9.existsSync(templatePath)) {
       console.log(`  \u2717 ${stage}.md \u2014 template not found in engine`);
       continue;
     }
-    const stepOutputPath = path7.join(stepsDir, `${stage}.md`);
-    if (fs8.existsSync(stepOutputPath) && !opts.force) {
-      console.log(`  \u25CB ${stage}.md \u2014 already exists (use --force to regenerate)`);
-      continue;
-    }
-    const defaultPrompt = fs8.readFileSync(templatePath, "utf-8");
+    const stepOutputPath = path8.join(stepsDir, `${stage}.md`);
+    const existingStep = fs9.existsSync(stepOutputPath) ? fs9.readFileSync(stepOutputPath, "utf-8") : "";
+    const isExtend = !!existingStep && !opts.force;
+    const defaultPrompt = fs9.readFileSync(templatePath, "utf-8");
     const contextPlaceholder = "{{TASK_CONTEXT}}";
     const placeholderIdx = defaultPrompt.indexOf(contextPlaceholder);
     if (placeholderIdx === -1) {
-      fs8.copyFileSync(templatePath, stepOutputPath);
+      fs9.copyFileSync(templatePath, stepOutputPath);
       stepCount++;
       console.log(`  \u2713 ${stage}.md`);
       continue;
     }
     const beforePlaceholder = defaultPrompt.slice(0, placeholderIdx).trimEnd();
     const afterPlaceholder = defaultPrompt.slice(placeholderIdx);
+    const stepExtendBlock = isExtend ? buildExtendInstruction(existingStep, `${stage} step file`) : "";
     const customizationPrompt = `You are customizing a Kody pipeline prompt for a specific repository.
 
 ## Your Task
@@ -7499,7 +7964,7 @@ Take the prompt template below and APPEND repository-specific sections to it.
 4. Keep each appended section concise (10-20 lines max).
 5. Output ONLY the customized prompt markdown. No explanation before or after.
 6. Do NOT include the text "${contextPlaceholder}" \u2014 it will be appended automatically after your output.
-
+${stepExtendBlock}
 ## Stage Being Customized
 Stage: ${stage}
 
@@ -7534,40 +7999,130 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
       let cleaned = output.replace(/^```(?:markdown|md)?\s*\n?/, "").replace(/\n?```\s*$/, "");
       cleaned = cleaned.replace(/\n*\{\{TASK_CONTEXT\}\}\s*$/, "").trimEnd();
       const finalPrompt = cleaned + "\n\n" + afterPlaceholder;
-      fs8.writeFileSync(stepOutputPath, finalPrompt);
+      fs9.writeFileSync(stepOutputPath, finalPrompt);
       stepCount++;
-      console.log(`  \u2713 ${stage}.md`);
+      console.log(`  \u2713 ${stage}.md (${isExtend ? "extended" : "generated"})`);
     } catch {
-      console.log(`  \u26A0 ${stage}.md \u2014 customization failed, using default template`);
-      fs8.copyFileSync(templatePath, stepOutputPath);
-      stepCount++;
+      if (!isExtend) {
+        console.log(`  \u26A0 ${stage}.md \u2014 customization failed, using default template`);
+        fs9.copyFileSync(templatePath, stepOutputPath);
+        stepCount++;
+      } else {
+        console.log(`  \u26A0 ${stage}.md \u2014 extend failed, keeping existing`);
+      }
     }
   }
   console.log(`  \u2713 Generated ${stepCount} step files in .kody/steps/`);
   console.log("\n\u2500\u2500 QA Guide \u2500\u2500");
-  const qaGuidePath = path7.join(cwd, ".kody", "qa-guide.md");
-  if (!fs8.existsSync(qaGuidePath) || opts.force) {
-    const discovery = discoverQaContext(cwd);
-    if (discovery.routes.length > 0) {
-      const qaGuide = generateQaGuide(discovery);
-      fs8.writeFileSync(qaGuidePath, qaGuide);
-      console.log(`  \u2713 .kody/qa-guide.md (${discovery.routes.length} routes, ${discovery.roles.length} roles)`);
-      if (discovery.loginPage) console.log(`  \u2713 Login page detected: ${discovery.loginPage}`);
-      if (discovery.adminPath) console.log(`  \u2713 Admin panel detected: ${discovery.adminPath}`);
-      console.log("  \u2139 Add QA_ADMIN_EMAIL, QA_ADMIN_PASSWORD, QA_USER_EMAIL, QA_USER_PASSWORD as GitHub secrets");
-    } else {
-      console.log("  \u25CB No routes detected \u2014 skipping QA guide");
-    }
+  const qaGuidePath = path8.join(cwd, ".kody", "qa-guide.md");
+  const discovery = discoverQaContext(cwd);
+  const hasRoutes = discovery.routes.length > 0 || discovery.collections.length > 0;
+  if (hasRoutes) {
+    const existingQaGuide = fs9.existsSync(qaGuidePath) ? fs9.readFileSync(qaGuidePath, "utf-8") : "";
+    const isQaExtend = !!existingQaGuide && !opts.force;
+    const serializedDiscovery = serializeDiscoveryForLLM(discovery);
+    const qaExtendBlock = isQaExtend ? buildExtendInstruction(existingQaGuide, "QA guide") : "";
+    const qaPrompt = `You are generating a QA guide for an autonomous coding agent that will use Playwright browser tools to visually verify UI changes.
+
+## Discovery Data
+${serializedDiscovery}
+
+## Architecture
+${arch}
+
+## Conventions
+${conv}
+${qaExtendBlock}
+## Output Format
+Generate a markdown QA guide with EXACTLY these sections:
+
+# QA Guide
+
+## Quick Reference
+- Dev server command and URL
+- Login page URL
+- Admin panel URL (if applicable)
+
+## Authentication
+### Test Accounts
+Table with Role, Email, Password columns.
+Use env var references (QA_ADMIN_EMAIL, QA_ADMIN_PASSWORD, etc.) \u2014 NOT hardcoded credentials.
+If the existing guide has real credentials, PRESERVE them exactly.
+
+### Login Steps
+Specific steps for this project's auth system.
+
+### Auth Files
+List of auth-related source files.
+
+## Navigation Map
+### Admin Panel
+For each collection/admin page: the exact URL path, what elements to expect on the page, key fields visible in the form, any custom components.
+Example: "/admin/collections/courses \u2014 Course edit form with title, slug, description fields. Custom CourseLessonsSorter component shows drag-sortable lessons grouped by chapter."
+
+### Frontend Pages
+For each key public route: path, expected content, key interactions to test.
+
+### API Endpoints
+For each API route: path, HTTP methods, purpose.
+
+## Component Verification Patterns
+For each custom admin component: where to find it in the UI, how to navigate there, what visual elements to verify, interaction tests (click, drag, type).
+
+## Common Test Scenarios
+CRUD workflows, auth flows, specific feature verification patterns relevant to this project.
+
+## Environment Setup
+Required env vars to start the dev server successfully.
+
+## Dev Server
+Command and URL.
+
+## Rules
+- Be SPECIFIC to this project \u2014 reference actual URLs, collection names, component names
+- For admin panels (Payload CMS, etc.), include the exact /admin/collections/{slug} paths
+- Include visual assertions: "you should see X", "verify Y is visible"
+- Include interaction tests: "click button X", "fill field Y", "drag item Z"
+- Keep under 200 lines total
+- Output ONLY the markdown. No explanation before or after.`;
+    console.log("  \u23F3 Generating QA guide...");
+    try {
+      const output = execFileSync5("claude", [
+        "--print",
+        "--model",
+        bootstrapModel,
+        "--dangerously-skip-permissions",
+        qaPrompt
+      ], {
+        encoding: "utf-8",
+        timeout: 9e4,
+        cwd,
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+      const cleaned = output.replace(/^```(?:markdown|md)?\s*\n?/, "").replace(/\n?```\s*$/, "");
+      fs9.writeFileSync(qaGuidePath, cleaned);
+      console.log(`  \u2713 .kody/qa-guide.md (${isQaExtend ? "extended" : "generated"}, ${discovery.routes.length} routes, ${discovery.collections.length} collections)`);
+    } catch {
+      console.log("  \u26A0 LLM QA generation failed \u2014 using template fallback");
+      const qaGuide = generateQaGuideFallback(discovery);
+      fs9.writeFileSync(qaGuidePath, qaGuide);
+      console.log(`  \u2713 .kody/qa-guide.md (fallback, ${discovery.routes.length} routes)`);
+    }
+    if (discovery.loginPage) console.log(`  \u2713 Login page detected: ${discovery.loginPage}`);
+    if (discovery.adminPath) console.log(`  \u2713 Admin panel detected: ${discovery.adminPath}`);
+    if (discovery.collections.length > 0) console.log(`  \u2713 ${discovery.collections.length} Payload CMS collections detected`);
+    if (discovery.adminComponents.length > 0) console.log(`  \u2713 ${discovery.adminComponents.length} custom admin components detected`);
+    console.log("  \u2139 Add QA_ADMIN_EMAIL, QA_ADMIN_PASSWORD, QA_USER_EMAIL, QA_USER_PASSWORD as GitHub secrets");
   } else {
-    console.log("  \u25CB .kody/qa-guide.md already exists (use --force to regenerate)");
+    console.log("  \u25CB No routes or collections detected \u2014 skipping QA guide");
   }
   console.log("\n\u2500\u2500 Labels \u2500\u2500");
   try {
     let repoSlug = "";
     try {
-      const configPath = path7.join(cwd, "kody.config.json");
-      if (fs8.existsSync(configPath)) {
-        const config = JSON.parse(fs8.readFileSync(configPath, "utf-8"));
+      const configPath = path8.join(cwd, "kody.config.json");
+      if (fs9.existsSync(configPath)) {
+        const config = JSON.parse(fs9.readFileSync(configPath, "utf-8"));
         if (config.github?.owner && config.github?.repo) {
           repoSlug = `${config.github.owner}/${config.github.repo}`;
         }
@@ -7576,9 +8131,12 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
     }
     if (repoSlug) {
       const labels = [
+        { name: "kody:backlog", color: "e4e669", description: "Issue created, not yet assigned to Kody" },
         { name: "kody:planning", color: "c5def5", description: "Kody is analyzing and planning" },
         { name: "kody:building", color: "0e8a16", description: "Kody is building code" },
+        { name: "kody:verifying", color: "fbca04", description: "Kody is verifying (lint/test/typecheck)" },
         { name: "kody:review", color: "fbca04", description: "Kody is reviewing code" },
+        { name: "kody:fixing", color: "0e8a16", description: "Kody is applying review fixes" },
         { name: "kody:shipping", color: "1d76db", description: "Kody is creating the pull request" },
         { name: "kody:done", color: "0e8a16", description: "Kody completed successfully" },
         { name: "kody:failed", color: "d93f0b", description: "Kody pipeline failed" },
@@ -7632,6 +8190,24 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
   } catch {
     console.log("  \u25CB Label creation skipped");
   }
+  console.log("\n\u2500\u2500 Tools \u2500\u2500");
+  const toolsYmlPath = path8.join(cwd, ".kody", "tools.yml");
+  if (!fs9.existsSync(toolsYmlPath) || opts.force) {
+    const toolsTemplate = `# Kody Tools Configuration
+# Uncomment and configure tools that your project uses.
+# The engine will detect, install, and inject tool skills into pipeline stages.
+#
+# playwright:
+#   detect: ["playwright.config.ts", "playwright.config.js"]
+#   stages: [verify]
+#   setup: "npx playwright install --with-deps chromium"
+#   skill: playwright-cli.md
+`;
+    fs9.writeFileSync(toolsYmlPath, toolsTemplate);
+    console.log("  \u2713 .kody/tools.yml (template created)");
+  } else {
+    console.log("  \u25CB .kody/tools.yml (already exists, keeping)");
+  }
   console.log("\n\u2500\u2500 Skills \u2500\u2500");
   const installedSkillPaths = installSkillsForProject(cwd);
   console.log("\n\u2500\u2500 Git \u2500\u2500");
@@ -7639,20 +8215,21 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
     ".kody/memory/architecture.md",
     ".kody/memory/conventions.md",
     ".kody/qa-guide.md",
+    ".kody/tools.yml",
     ...installedSkillPaths
-  ].filter((f) => fs8.existsSync(path7.join(cwd, f)));
-  if (fs8.existsSync(path7.join(cwd, "skills-lock.json"))) {
+  ].filter((f) => fs9.existsSync(path8.join(cwd, f)));
+  if (fs9.existsSync(path8.join(cwd, "skills-lock.json"))) {
     filesToCommit.push("skills-lock.json");
   }
   for (const stage of STEP_STAGES) {
     const stepFile = `.kody/steps/${stage}.md`;
-    if (fs8.existsSync(path7.join(cwd, stepFile))) {
+    if (fs9.existsSync(path8.join(cwd, stepFile))) {
       filesToCommit.push(stepFile);
     }
   }
   if (filesToCommit.length > 0) {
     try {
-      const fullPaths = filesToCommit.map((f) => path7.join(cwd, f));
+      const fullPaths = filesToCommit.map((f) => path8.join(cwd, f));
       for (let pass = 0; pass < 2; pass++) {
         execFileSync5("npx", ["prettier", "--write", ...fullPaths], {
           cwd,
@@ -7679,9 +8256,9 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
           console.log(`  \u2713 Pushed branch: ${branchName}`);
           let baseBranch = "main";
           try {
-            const configPath = path7.join(cwd, "kody.config.json");
-            if (fs8.existsSync(configPath)) {
-              const config = JSON.parse(fs8.readFileSync(configPath, "utf-8"));
+            const configPath = path8.join(cwd, "kody.config.json");
+            if (fs9.existsSync(configPath)) {
+              const config = JSON.parse(fs9.readFileSync(configPath, "utf-8"));
               baseBranch = config.git?.defaultBranch ?? "main";
             }
           } catch {
@@ -7755,11 +8332,11 @@ Create it manually.`, cwd);
 
 // src/bin/cli.ts
 init_architecture_detection();
-var __dirname2 = path30.dirname(fileURLToPath2(import.meta.url));
-var PKG_ROOT = path30.resolve(__dirname2, "..", "..");
+var __dirname2 = path32.dirname(fileURLToPath2(import.meta.url));
+var PKG_ROOT = path32.resolve(__dirname2, "..", "..");
 function getVersion() {
-  const pkgPath = path30.join(PKG_ROOT, "package.json");
-  const pkg = JSON.parse(fs33.readFileSync(pkgPath, "utf-8"));
+  const pkgPath = path32.join(PKG_ROOT, "package.json");
+  const pkg = JSON.parse(fs35.readFileSync(pkgPath, "utf-8"));
   return pkg.version;
 }
 var args = process.argv.slice(2);