@kody-ade/kody-engine-lite 0.1.100 → 0.1.102

package/README.md

@@ -154,7 +154,7 @@ kody-engine-lite rerun --issue-number 42 --from verify
 
 ## Documentation
 
-**Understand Kody:** [About](docs/ABOUT.md) · [Features](docs/FEATURES.md) · [Pipeline](docs/PIPELINE.md) · [Comparison](docs/COMPARISON.md)
+**Understand Kody:** [About](docs/ABOUT.md) · [Tech Stack](docs/TECH-STACK.md) · [Features](docs/FEATURES.md) · [Pipeline](docs/PIPELINE.md) · [Comparison](docs/COMPARISON.md)
 
 **Set up & use:** [CLI](docs/CLI.md) · [Configuration](docs/CONFIGURATION.md) · [Bootstrap](docs/BOOTSTRAP.md) · [LiteLLM](docs/LITELLM.md)
 

package/dist/bin/cli.js

@@ -305,7 +305,13 @@ function getProjectConfig() {
         },
         timeouts: raw.timeouts ?? void 0,
         contextTiers: raw.contextTiers ? { ...DEFAULT_CONFIG.contextTiers, ...raw.contextTiers } : DEFAULT_CONFIG.contextTiers,
-        mcp: raw.mcp ? { enabled: false, servers: {}, stages: ["build", "verify", "review", "review-fix"], ...raw.mcp } : void 0
+        mcp: raw.mcp ? {
+          servers: {},
+          stages: ["build", "verify", "review", "review-fix"],
+          ...raw.mcp,
+          // Auto-enable when devServer is configured (user can still set enabled: false to override)
+          enabled: raw.mcp.enabled ?? !!raw.mcp.devServer
+        } : void 0
       };
     } catch {
       logger.warn("kody.config.json is invalid JSON \u2014 using defaults");
@@ -861,7 +867,7 @@ var init_github_api = __esm({
     "use strict";
     init_logger();
     API_TIMEOUT_MS = 3e4;
-    LIFECYCLE_LABELS = ["planning", "building", "review", "done", "failed", "waiting", "low", "medium", "high"];
+    LIFECYCLE_LABELS = ["planning", "building", "review", "shipping", "done", "failed", "waiting", "low", "medium", "high"];
     KODY_MARKERS = [
       "Kody Review",
       "\u{1F916} Generated by Kody",
@@ -1281,6 +1287,20 @@ var init_context_tiers = __esm({
 });
 
 // src/mcp-config.ts
+function withPlaywrightIfNeeded(mcpConfig, hasUI) {
+  if (!mcpConfig?.enabled || !hasUI) return mcpConfig;
+  const hasPlaywright = Object.keys(mcpConfig.servers).some(
+    (name) => name.toLowerCase().includes("playwright")
+  );
+  if (hasPlaywright) return mcpConfig;
+  return {
+    ...mcpConfig,
+    servers: {
+      ...mcpConfig.servers,
+      playwright: PLAYWRIGHT_SERVER
+    }
+  };
+}
 function buildMcpConfigJson(mcpConfig) {
   if (!mcpConfig?.enabled) return void 0;
   if (Object.keys(mcpConfig.servers).length === 0) return void 0;
@@ -1297,15 +1317,18 @@ function buildMcpConfigJson(mcpConfig) {
 }
 function isMcpEnabledForStage(stageName, mcpConfig) {
   if (!mcpConfig?.enabled) return false;
-  if (Object.keys(mcpConfig.servers).length === 0) return false;
   const allowedStages = mcpConfig.stages ?? DEFAULT_MCP_STAGES;
   return allowedStages.includes(stageName);
 }
-var DEFAULT_MCP_STAGES;
+var DEFAULT_MCP_STAGES, PLAYWRIGHT_SERVER;
 var init_mcp_config = __esm({
   "src/mcp-config.ts"() {
     "use strict";
     DEFAULT_MCP_STAGES = ["build", "verify", "review", "review-fix"];
+    PLAYWRIGHT_SERVER = {
+      command: "npx",
+      args: ["-y", "@anthropic-ai/mcp-playwright"]
+    };
   }
 });
 
@@ -1523,6 +1546,11 @@ ${prompt}` : prompt;
   }
   if (isMcpEnabledForStage(stageName, config.mcp) && taskHasUI(taskDir)) {
     assembled = assembled + "\n\n" + getBrowserToolGuidance(stageName, taskDir);
+    const qaGuidePath = path5.join(projectDir, ".kody", "qa-guide.md");
+    if (fs5.existsSync(qaGuidePath)) {
+      const qaGuide = fs5.readFileSync(qaGuidePath, "utf-8").trim();
+      assembled = assembled + "\n\n" + qaGuide;
+    }
   }
   return assembled;
 }
@@ -1685,7 +1713,8 @@ async function executeAgentStage(ctx, def) {
   if (sessionInfo) {
     logger.info(`  session: ${SESSION_GROUP[def.name]} (${sessionInfo.resumeSession ? "resume" : "new"})`);
   }
-  const mcpConfigJson = isMcpEnabledForStage(def.name, config.mcp) ? buildMcpConfigJson(config.mcp) : void 0;
+  const mcpForStage = isMcpEnabledForStage(def.name, config.mcp) ? withPlaywrightIfNeeded(config.mcp, taskHasUI(ctx.taskDir)) : void 0;
+  const mcpConfigJson = buildMcpConfigJson(mcpForStage);
   if (mcpConfigJson) {
     logger.info(`  MCP servers enabled for ${def.name}`);
   }
@@ -2670,6 +2699,7 @@ function applyPreStageLabel(ctx, def) {
   if (!ctx.input.issueNumber || ctx.input.local) return;
   if (def.name === "build") setLifecycleLabel(ctx.input.issueNumber, "building");
   if (def.name === "review") setLifecycleLabel(ctx.input.issueNumber, "review");
+  if (def.name === "ship") setLifecycleLabel(ctx.input.issueNumber, "shipping");
 }
 function checkQuestionsAfterStage(ctx, def, state) {
   if (def.name !== "taskify" && def.name !== "plan") return null;
@@ -4507,12 +4537,7 @@ function detectMcpConfig(cwd, pm, pkg) {
   const defaultPort = isNext ? 3e3 : isVite ? 5173 : 3e3;
   const mcp = {
     enabled: true,
-    servers: {
-      playwright: {
-        command: "npx",
-        args: ["@playwright/mcp@latest"]
-      }
-    },
+    servers: {},
     stages: ["build", "review"]
   };
   if (hasDevScript) {
@@ -5009,6 +5034,23 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
     }
   }
   console.log(`  \u2713 Generated ${stepCount} step files in .kody/steps/`);
+  console.log("\n\u2500\u2500 QA Guide \u2500\u2500");
+  const qaGuidePath = path21.join(cwd, ".kody", "qa-guide.md");
+  if (!fs22.existsSync(qaGuidePath) || opts.force) {
+    const discovery = discoverQaContext(cwd);
+    if (discovery.routes.length > 0) {
+      const qaGuide = generateQaGuide(discovery);
+      fs22.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");
+    }
+  } else {
+    console.log("  \u25CB .kody/qa-guide.md already exists (use --force to regenerate)");
+  }
   console.log("\n\u2500\u2500 Labels \u2500\u2500");
   try {
     let repoSlug = "";
@@ -5027,6 +5069,7 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
         { name: "kody:planning", color: "c5def5", description: "Kody is analyzing and planning" },
         { name: "kody:building", color: "0e8a16", description: "Kody is building code" },
         { name: "kody:review", color: "fbca04", description: "Kody is reviewing code" },
+        { 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" },
         { name: "kody:waiting", color: "fef2c0", description: "Kody is waiting for answers" },
@@ -5085,6 +5128,7 @@ REMINDER: Output the full prompt template first (unchanged), then your three app
   const filesToCommit = [
     ".kody/memory/architecture.md",
     ".kody/memory/conventions.md",
+    ".kody/qa-guide.md",
     ...installedSkillPaths
   ].filter((f) => fs22.existsSync(path21.join(cwd, f)));
   if (fs22.existsSync(path21.join(cwd, "skills-lock.json"))) {
@@ -5198,6 +5242,178 @@ Create it manually.`, cwd);
   console.log("  \u2713 Project bootstrap complete!");
   console.log("  Kody now has project-specific memory and customized step files.\n");
 }
+function discoverQaContext(cwd) {
+  const result = {
+    routes: [],
+    authFiles: [],
+    loginPage: null,
+    adminPath: null,
+    roles: [],
+    devCommand: "",
+    devPort: 3e3
+  };
+  try {
+    const pkg = JSON.parse(fs22.readFileSync(path21.join(cwd, "package.json"), "utf-8"));
+    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const pm = fs22.existsSync(path21.join(cwd, "pnpm-lock.yaml")) ? "pnpm" : fs22.existsSync(path21.join(cwd, "yarn.lock")) ? "yarn" : "npm";
+    if (pkg.scripts?.dev) result.devCommand = `${pm} dev`;
+    if (allDeps.next || allDeps.nuxt) result.devPort = 3e3;
+    else if (allDeps.vite) result.devPort = 5173;
+  } catch {
+  }
+  const appDirs = ["src/app", "app"];
+  for (const appDir of appDirs) {
+    const fullAppDir = path21.join(cwd, appDir);
+    if (!fs22.existsSync(fullAppDir)) continue;
+    scanRoutes(fullAppDir, appDir, "", result);
+    break;
+  }
+  const authPatterns = ["middleware.ts", "middleware.js", "src/middleware.ts", "src/middleware.js"];
+  for (const p of authPatterns) {
+    if (fs22.existsSync(path21.join(cwd, p))) result.authFiles.push(p);
+  }
+  const authConfigGlobs = [
+    "src/app/api/auth",
+    "src/auth",
+    "src/lib/auth",
+    "auth.config.ts",
+    "auth.ts",
+    "src/app/api/oauth"
+  ];
+  for (const g of authConfigGlobs) {
+    if (fs22.existsSync(path21.join(cwd, g))) result.authFiles.push(g);
+  }
+  try {
+    const rolePaths = [
+      "src/types",
+      "src/lib",
+      "src/utils",
+      "src/constants",
+      "src/access",
+      "src/collections"
+    ];
+    for (const rp of rolePaths) {
+      const dir = path21.join(cwd, rp);
+      if (!fs22.existsSync(dir)) continue;
+      const files = fs22.readdirSync(dir).filter((f) => f.endsWith(".ts") || f.endsWith(".tsx"));
+      for (const f of files) {
+        try {
+          const content = fs22.readFileSync(path21.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) {
+              const val = m.match(/['"](\w+)['"]/);
+              if (val && !result.roles.includes(val[1])) result.roles.push(val[1]);
+            }
+          }
+          const enumMatch = content.match(/(?:enum|type)\s+\w*[Rr]ole\w*\s*[={]([^}]+)/s);
+          if (enumMatch) {
+            const vals = enumMatch[1].match(/['"](\w+)['"]/g);
+            if (vals) {
+              for (const v of vals) {
+                const clean = v.replace(/['"]/g, "");
+                if (!result.roles.includes(clean)) result.roles.push(clean);
+              }
+            }
+          }
+        } catch {
+        }
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+function scanRoutes(dir, baseDir, prefix, result) {
+  let entries;
+  try {
+    entries = fs22.readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+  const hasPage = entries.some((e) => e.isFile() && /^page\.(tsx?|jsx?)$/.test(e.name));
+  if (hasPage) {
+    const routePath = prefix || "/";
+    const group = prefix.startsWith("/admin") ? "admin" : prefix.includes("/login") ? "auth" : prefix.includes("/signup") ? "auth" : prefix.includes("/api") ? "api" : "frontend";
+    result.routes.push({ path: routePath, group });
+    if (prefix.includes("/login")) result.loginPage = routePath;
+    if (prefix.startsWith("/admin") && !result.adminPath) result.adminPath = prefix;
+  }
+  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(")")) {
+      scanRoutes(path21.join(dir, entry.name), baseDir, prefix, result);
+      continue;
+    }
+    if (segment.startsWith("[") && segment.endsWith("]")) {
+      segment = `:${segment.slice(1, -1)}`;
+    }
+    if (segment.startsWith("[[") && segment.endsWith("]]")) {
+      segment = `:${segment.slice(2, -2)}?`;
+    }
+    scanRoutes(path21.join(dir, entry.name), baseDir, `${prefix}/${segment}`, result);
+  }
+}
+function generateQaGuide(discovery) {
+  const lines = ["# QA Guide", "", "## Authentication", ""];
+  if (discovery.loginPage) {
+    lines.push(`- Login page: \`${discovery.loginPage}\``);
+  }
+  lines.push(
+    "",
+    "### Test Accounts",
+    "<!-- Fill in your test/preview environment credentials below -->",
+    "| Role | Email | Password |",
+    "|------|-------|----------|",
+    "| Admin | admin@example.com | CHANGE_ME |",
+    "| User | user@example.com | CHANGE_ME |",
+    "",
+    "### Login Steps",
+    `1. Navigate to \`${discovery.loginPage ?? "/login"}\``,
+    "2. Enter credentials from the test accounts table above",
+    "3. Submit the login form",
+    "4. Verify redirect to dashboard or home page"
+  );
+  if (discovery.authFiles.length > 0) {
+    lines.push("", "### Auth Files");
+    for (const f of discovery.authFiles) {
+      lines.push(`- \`${f}\``);
+    }
+  }
+  if (discovery.roles.length > 0) {
+    lines.push("", "## Roles", "");
+    for (const role of discovery.roles) {
+      lines.push(`- \`${role}\``);
+    }
+  }
+  lines.push("", "## Key Pages", "");
+  const groups = {};
+  for (const route of discovery.routes) {
+    if (!groups[route.group]) groups[route.group] = [];
+    groups[route.group].push(route.path);
+  }
+  for (const [group, routes] of Object.entries(groups)) {
+    lines.push(`### ${group.charAt(0).toUpperCase() + group.slice(1)}`);
+    const sorted = routes.sort();
+    for (const r of sorted.slice(0, 20)) {
+      lines.push(`- \`${r}\``);
+    }
+    if (sorted.length > 20) {
+      lines.push(`- ... and ${sorted.length - 20} more`);
+    }
+    lines.push("");
+  }
+  lines.push(
+    "## Dev Server",
+    "",
+    `- Command: \`${discovery.devCommand || "pnpm dev"}\``,
+    `- URL: \`http://localhost:${discovery.devPort}\``,
+    ""
+  );
+  return lines.join("\n");
+}
 function detectArchitectureBasic(cwd) {
   const detected = [];
   const pkgPath = path21.join(cwd, "package.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine-lite",
-  "version": "0.1.100",
+  "version": "0.1.102",
   "description": "Autonomous SDLC pipeline: Kody orchestration + Claude Code + LiteLLM",
   "license": "MIT",
   "type": "module",