@kody-ade/kody-engine-lite 0.1.63 → 0.1.64

package/dist/bin/cli.js

@@ -96,6 +96,9 @@ function createClaudeCodeRunner() {
         "--allowedTools",
         "Bash,Edit,Read,Write,Glob,Grep"
       ];
+      if (options?.mcpConfigJson) {
+        args2.push("--mcp-config", options.mcpConfigJson);
+      }
       if (options?.sessionId) {
         if (options.resumeSession) {
           args2.push("--resume", options.sessionId);
@@ -274,7 +277,8 @@ function getProjectConfig() {
         git: { ...DEFAULT_CONFIG.git, ...raw.git },
         github: { ...DEFAULT_CONFIG.github, ...raw.github },
         agent: { ...DEFAULT_CONFIG.agent, ...raw.agent },
-        contextTiers: raw.contextTiers ? { ...DEFAULT_CONFIG.contextTiers, ...raw.contextTiers } : DEFAULT_CONFIG.contextTiers
+        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
       };
     } catch {
       logger.warn("kody.config.json is invalid JSON \u2014 using defaults");
@@ -1104,6 +1108,35 @@ var init_context_tiers = __esm({
   }
 });
 
+// src/mcp-config.ts
+function buildMcpConfigJson(mcpConfig) {
+  if (!mcpConfig?.enabled) return void 0;
+  if (Object.keys(mcpConfig.servers).length === 0) return void 0;
+  const config = { mcpServers: {} };
+  const mcpServers = config.mcpServers;
+  for (const [name, server] of Object.entries(mcpConfig.servers)) {
+    mcpServers[name] = {
+      command: server.command,
+      args: server.args ?? [],
+      ...server.env ? { env: server.env } : {}
+    };
+  }
+  return JSON.stringify(config);
+}
+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 init_mcp_config = __esm({
+  "src/mcp-config.ts"() {
+    "use strict";
+    DEFAULT_MCP_STAGES = ["build", "verify", "review", "review-fix"];
+  }
+});
+
 // src/context.ts
 import * as fs5 from "fs";
 import * as path5 from "path";
@@ -1194,18 +1227,132 @@ ${feedback}
   }
   return prompt.replace("{{TASK_CONTEXT}}", context);
 }
+function taskHasUI(taskDir) {
+  const taskJsonPath = path5.join(taskDir, "task.json");
+  if (!fs5.existsSync(taskJsonPath)) return true;
+  try {
+    const taskDef = JSON.parse(fs5.readFileSync(taskJsonPath, "utf-8"));
+    return taskDef.hasUI !== false;
+  } catch {
+    return true;
+  }
+}
+function getDevServerInfo(taskDir) {
+  const config = getProjectConfig();
+  const ds = config.mcp?.devServer;
+  if (!ds) return void 0;
+  return {
+    command: ds.command,
+    url: ds.url,
+    readyPattern: ds.readyPattern ?? "Ready in|compiled|started server|Local:",
+    readyTimeout: ds.readyTimeout ?? 30
+  };
+}
+function getBrowserToolGuidance(stageName, taskDir) {
+  const devServer = getDevServerInfo(taskDir);
+  const devServerBlock = devServer ? `
+### Dev Server Setup (REQUIRED before browsing)
+You MUST start the dev server before using any browser navigation tools:
+\`\`\`bash
+# Start the dev server in the background
+${devServer.command} &
+# Wait for it to be ready (look for "${devServer.readyPattern}" in output)
+sleep 5
+\`\`\`
+The dev server URL is: ${devServer.url}
+After you are done browsing, kill the dev server: \`kill %1 2>/dev/null || true\`` : `
+### Dev Server Setup (REQUIRED before browsing)
+You MUST start the project's dev server before using any browser navigation tools.
+Check package.json for the dev command (usually \`pnpm dev\` or \`npm run dev\`).
+\`\`\`bash
+# Start the dev server in the background
+pnpm dev &
+# Wait for it to be ready
+sleep 5
+\`\`\`
+After you are done browsing, kill the dev server: \`kill %1 2>/dev/null || true\``;
+  if (stageName === "build" || stageName === "review-fix") {
+    return `## Browser Visual Verification (MANDATORY for UI tasks)
+
+This task involves UI changes. You MUST visually verify your implementation using the browser tools.
+${devServerBlock}
+
+### Available Browser Tools
+- \`mcp__playwright__browser_navigate\` \u2014 go to a URL
+- \`mcp__playwright__browser_snapshot\` \u2014 capture accessibility tree (shows all elements, text, roles)
+- \`mcp__playwright__browser_take_screenshot\` \u2014 take a visual screenshot
+- \`mcp__playwright__browser_click\` \u2014 click an element (by text, role, or ref from snapshot)
+- \`mcp__playwright__browser_type\` \u2014 type text into an input field
+- \`mcp__playwright__browser_fill_form\` \u2014 fill multiple form fields at once
+- \`mcp__playwright__browser_hover\` \u2014 hover over an element (test hover states)
+- \`mcp__playwright__browser_select_option\` \u2014 select a dropdown option
+- \`mcp__playwright__browser_press_key\` \u2014 press keyboard keys (Enter, Escape, Tab, etc.)
+- \`mcp__playwright__browser_resize\` \u2014 resize viewport (test responsive layouts)
+- \`mcp__playwright__browser_wait_for\` \u2014 wait for text to appear/disappear
+- \`mcp__playwright__browser_evaluate\` \u2014 run JavaScript on the page
+
+### Verification Steps (DO ALL OF THESE)
+1. Start the dev server (see above)
+2. Use \`browser_navigate\` to go to the affected page(s)
+3. Use \`browser_snapshot\` to capture the page and verify elements are present
+4. **Test interactions**: if the task involves buttons, forms, search, toggles, or any interactive elements \u2014 click them, type into them, and verify the result with another snapshot
+5. If the task mentions responsive behavior, use \`browser_resize\` to test at different widths (e.g., 1200px, 768px, 480px) and take snapshots at each
+6. Kill the dev server when done
+
+Do NOT skip the browser verification. The visual check AND interaction testing are required parts of implementing UI changes.`;
+  }
+  if (stageName === "review") {
+    return `## Browser Visual Verification (MANDATORY for UI review)
+
+This task involves UI changes. You MUST visually verify the implementation using the browser tools before giving your verdict.
+${devServerBlock}
+
+### Available Browser Tools
+- \`mcp__playwright__browser_navigate\` \u2014 go to a URL
+- \`mcp__playwright__browser_snapshot\` \u2014 capture accessibility tree (shows all elements, text, roles)
+- \`mcp__playwright__browser_take_screenshot\` \u2014 take a visual screenshot
+- \`mcp__playwright__browser_click\` \u2014 click an element
+- \`mcp__playwright__browser_type\` \u2014 type text into an input
+- \`mcp__playwright__browser_hover\` \u2014 hover over an element
+- \`mcp__playwright__browser_resize\` \u2014 resize viewport
+- \`mcp__playwright__browser_wait_for\` \u2014 wait for text to appear/disappear
+
+### Review Verification Steps (DO ALL OF THESE)
+1. Start the dev server (see above)
+2. Use \`browser_navigate\` to go to the affected page(s)
+3. Use \`browser_snapshot\` to verify elements, layout, and text content
+4. **Test interactions**: click buttons, fill forms, test search \u2014 verify the UI responds correctly
+5. If the task mentions responsive behavior, use \`browser_resize\` to test at different widths
+6. Include your browser verification findings in the review (what you saw, what you interacted with, what worked/failed)
+7. Kill the dev server when done
+
+Do NOT skip the browser verification. A review of UI changes without visual AND interaction verification is incomplete.`;
+  }
+  return `## Browser Tools Available
+
+You have access to Playwright MCP browser tools for visual verification.
+${devServerBlock}
+
+Use browser tools to navigate to pages and take snapshots to verify UI output.`;
+}
 function buildFullPrompt(stageName, taskId, taskDir, projectDir, feedback) {
   const config = getProjectConfig();
+  let assembled;
   if (config.contextTiers?.enabled) {
-    return buildFullPromptTiered(stageName, taskId, taskDir, projectDir, feedback);
-  }
-  const memory = readProjectMemory(projectDir);
-  const promptTemplate = readPromptFile(stageName, projectDir);
-  const prompt = injectTaskContext(promptTemplate, taskId, taskDir, feedback);
-  return memory ? `${memory}
+    assembled = buildFullPromptTiered(stageName, taskId, taskDir, projectDir, feedback);
+  } else {
+    const memory = readProjectMemory(projectDir);
+    const promptTemplate = readPromptFile(stageName, projectDir);
+    const prompt = injectTaskContext(promptTemplate, taskId, taskDir, feedback);
+    assembled = memory ? `${memory}
 ---
 
 ${prompt}` : prompt;
+  }
+  if (isMcpEnabledForStage(stageName, config.mcp) && taskHasUI(taskDir)) {
+    assembled = assembled + "\n\n" + getBrowserToolGuidance(stageName, taskDir);
+  }
+  return assembled;
 }
 function buildFullPromptTiered(stageName, taskId, taskDir, projectDir, feedback) {
   const config = getProjectConfig();
@@ -1241,6 +1388,7 @@ var init_context = __esm({
     init_memory();
     init_config();
     init_context_tiers();
+    init_mcp_config();
     DEFAULT_MODEL_MAP = {
       cheap: "haiku",
       mid: "sonnet",
@@ -1365,11 +1513,16 @@ 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;
+  if (mcpConfigJson) {
+    logger.info(`  MCP servers enabled for ${def.name}`);
+  }
   const runner = getRunnerForStage(ctx, def.name);
   const result = await runner.run(def.name, prompt, model, def.timeout, ctx.taskDir, {
     cwd: ctx.projectDir,
     env: extraEnv,
-    ...sessionInfo
+    ...sessionInfo,
+    mcpConfigJson
   });
   if (result.outcome !== "completed") {
     return { outcome: result.outcome, error: result.error, retries: 0 };
@@ -1447,6 +1600,7 @@ var init_agent = __esm({
     init_context();
     init_validators();
     init_config();
+    init_mcp_config();
     init_runner_selection();
     init_logger();
     SESSION_GROUP = {

package/kody.config.schema.json

@@ -128,6 +128,72 @@
         }
       },
       "additionalProperties": false
+    },
+    "mcp": {
+      "type": "object",
+      "description": "MCP (Model Context Protocol) server configuration. Enables external tools like browser automation.",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable MCP server integration",
+          "default": false
+        },
+        "servers": {
+          "type": "object",
+          "description": "Named MCP server definitions. Each key is a server name.",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "command": {
+                "type": "string",
+                "description": "Command to start the MCP server (e.g., 'npx')"
+              },
+              "args": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Command arguments"
+              },
+              "env": {
+                "type": "object",
+                "additionalProperties": { "type": "string" },
+                "description": "Environment variables for the server process"
+              }
+            },
+            "required": ["command"]
+          }
+        },
+        "stages": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Stages that can use MCP tools. Defaults to [\"build\", \"verify\", \"review\", \"review-fix\"]",
+          "default": ["build", "verify", "review", "review-fix"]
+        },
+        "devServer": {
+          "type": "object",
+          "description": "Dev server configuration for browser tool verification",
+          "properties": {
+            "command": {
+              "type": "string",
+              "description": "Command to start the dev server (e.g., 'pnpm dev')"
+            },
+            "url": {
+              "type": "string",
+              "description": "URL where the dev server will be accessible (e.g., 'http://localhost:3000')"
+            },
+            "readyPattern": {
+              "type": "string",
+              "description": "Regex pattern to match in stdout when server is ready. Default: 'Ready in|compiled|started server|Local:'"
+            },
+            "readyTimeout": {
+              "type": "number",
+              "description": "Seconds to wait for the server to be ready. Default: 30"
+            }
+          },
+          "required": ["command", "url"]
+        }
+      },
+      "required": ["enabled", "servers"],
+      "additionalProperties": false
     }
   },
   "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine-lite",
-  "version": "0.1.63",
+  "version": "0.1.64",
   "description": "Autonomous SDLC pipeline: Kody orchestration + Claude Code + LiteLLM",
   "license": "MIT",
   "type": "module",
@@ -13,13 +13,6 @@
     "templates",
     "kody.config.schema.json"
   ],
-  "scripts": {
-    "kody": "tsx src/entry.ts",
-    "build": "tsup",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "dotenv": "^16.4.7"
   },
@@ -32,5 +25,11 @@
   },
   "engines": {
     "node": ">=22"
+  },
+  "scripts": {
+    "kody": "tsx src/entry.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/prompts/taskify.md

@@ -18,9 +18,14 @@ Required JSON format:
   "description": "Clear description of what the task requires",
   "scope": ["list", "of", "exact/file/paths", "affected"],
   "risk_level": "low | medium | high",
+  "hasUI": true,
   "questions": []
 }
 
+hasUI heuristics:
+- true: task touches frontend files (.tsx, .jsx, .vue, .svelte, .css, .scss, .html), UI components, pages, layouts, or styles
+- false: task is purely backend, CLI, API, database, config, docs, or infrastructure
+
 Risk level heuristics:
 - low: single file change, no breaking changes, docs, config, isolated scripts, test additions, style changes
 - medium: multiple files, possible side effects, API changes, new dependencies, refactoring existing logic