e2e-ai 1.1.2 → 1.2.0

package/dist/cli.js

@@ -1,10 +1,14 @@
 #!/usr/bin/env node
+import {
+  loadAgent,
+  scanCodebase
+} from "./cli-g7cc13w2.js";
 import {
   getPackageRoot,
   getProjectRoot,
   loadConfig
-} from "./cli-2rnyej02.js";
-import"./cli-qnzwv17s.js";
+} from "./cli-ba9d3pdp.js";
+import"./cli-ph82pe4b.js";
 import {
   __commonJS,
   __export,
@@ -6436,101 +6440,7 @@ function formatTime(sec) {
 }
 
 // src/commands/scenario.ts
-import { join as join7 } from "node:path";
-
-// src/agents/loadAgent.ts
-import { readFileSync as readFileSync2, existsSync as existsSync2 } from "node:fs";
-import { join as join5 } from "node:path";
-function loadAgent(agentName, config) {
-  const agentDir = join5(getPackageRoot(), "agents");
-  const filePath = join5(agentDir, `${agentName}.md`);
-  let content;
-  try {
-    content = readFileSync2(filePath, "utf-8");
-  } catch {
-    throw new Error(`Agent file not found: ${filePath}`);
-  }
-  const { frontmatter, body } = parseFrontmatter(content);
-  const agentConfig = extractConfig(frontmatter);
-  let systemPrompt = body;
-  if (config) {
-    const contextPath = join5(getProjectRoot(), config.contextFile);
-    if (existsSync2(contextPath)) {
-      const projectContext = readFileSync2(contextPath, "utf-8").trim();
-      if (projectContext) {
-        systemPrompt = `${body}
-
-## Project Context
-
-${projectContext}`;
-      }
-    }
-    if (config.llm.agentModels[agentName]) {
-      agentConfig.model = config.llm.agentModels[agentName];
-    }
-  }
-  const sections = parseSections(body);
-  return {
-    name: frontmatter.agent ?? agentName,
-    systemPrompt,
-    inputSchema: sections["Input Schema"],
-    outputSchema: sections["Output Schema"],
-    rules: sections["Rules"],
-    example: sections["Example"],
-    config: agentConfig
-  };
-}
-function parseFrontmatter(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-  if (!match)
-    return { frontmatter: {}, body: content };
-  const frontmatter = {};
-  for (const line of match[1].split(`
-`)) {
-    const colonIdx = line.indexOf(":");
-    if (colonIdx === -1)
-      continue;
-    const key = line.slice(0, colonIdx).trim();
-    let value = line.slice(colonIdx + 1).trim();
-    if (value.startsWith('"') && value.endsWith('"'))
-      value = value.slice(1, -1);
-    if (value === "true")
-      value = true;
-    if (value === "false")
-      value = false;
-    if (!isNaN(Number(value)) && value !== "")
-      value = Number(value);
-    frontmatter[key] = value;
-  }
-  return { frontmatter, body: match[2] };
-}
-function extractConfig(frontmatter) {
-  return {
-    model: frontmatter.model,
-    maxTokens: frontmatter.max_tokens ?? 4096,
-    temperature: frontmatter.temperature ?? 0.2
-  };
-}
-function parseSections(body) {
-  const sections = {};
-  const headingRegex = /^##\s+(.+)$/gm;
-  const headings = [];
-  let match;
-  while ((match = headingRegex.exec(body)) !== null) {
-    headings.push({ title: match[1].trim(), index: match.index });
-  }
-  const systemMatch = body.match(/^#\s+System Prompt\n([\s\S]*?)(?=\n##\s|$)/m);
-  if (systemMatch) {
-    sections["System Prompt"] = systemMatch[1].trim();
-  }
-  for (let i = 0;i < headings.length; i++) {
-    const start = headings[i].index + body.slice(headings[i].index).indexOf(`
-`) + 1;
-    const end = i + 1 < headings.length ? headings[i + 1].index : body.length;
-    sections[headings[i].title] = body.slice(start, end).trim();
-  }
-  return sections;
-}
+import { join as join6 } from "node:path";
 
 // src/agents/callLLM.ts
 var DEFAULT_MODELS = {
@@ -6676,9 +6586,9 @@ function extractYAML(content) {
 import { dirname as dirname3 } from "node:path";
 
 // src/integrations/jira.ts
-import { join as join6 } from "node:path";
+import { join as join5 } from "node:path";
 async function fetchJiraContext(key, config, workingDir) {
-  const jsonPath = join6(workingDir, key, `${key}-zephyr-test-case.json`);
+  const jsonPath = join5(workingDir, key, `${key}-zephyr-test-case.json`);
   if (!fileExists(jsonPath))
     return null;
   const data = JSON.parse(readFile(jsonPath));
@@ -6839,8 +6749,8 @@ function registerScenario(program2) {
     let codegenContent;
     let transcriptContent;
     if (ctx.key) {
-      const keyDir = join7(ctx.paths.workingDir, ctx.key);
-      const recordingsDir = join7(keyDir, "recordings");
+      const keyDir = join6(ctx.paths.workingDir, ctx.key);
+      const recordingsDir = join6(keyDir, "recordings");
       const codegenFile = findFileWithPattern(keyDir, /codegen-.*\.ts$/);
       const transcriptFile = findFileWithPattern(keyDir, /transcript\.json$/) ?? findFileWithPattern(recordingsDir, /voice-.*\.json$/) ?? findFileWithPattern(keyDir, /voice-.*\.json$/);
       if (codegenFile)
@@ -6848,8 +6758,8 @@ function registerScenario(program2) {
       if (transcriptFile)
         transcriptContent = readFile(transcriptFile);
     } else if (session) {
-      const codegenPath = join7(ctx.paths.recordingsDir, `${session}.ts`);
-      const transcriptPath = join7(ctx.paths.transcriptsDir, `${session}-transcript.json`);
+      const codegenPath = join6(ctx.paths.recordingsDir, `${session}.ts`);
+      const transcriptPath = join6(ctx.paths.transcriptsDir, `${session}-transcript.json`);
       if (fileExists(codegenPath))
         codegenContent = readFile(codegenPath);
       if (fileExists(transcriptPath))
@@ -6914,8 +6824,8 @@ function registerScenario(program2) {
     spinner2.stop();
     const scenarioYaml = extractYAML(scenarioResponse.content);
     const scenarioName = ctx.key ?? session ?? "scenario";
-    const scenarioDir = join7(ctx.paths.testsDir, scenarioName);
-    const scenarioPath = join7(scenarioDir, `${scenarioName}.yaml`);
+    const scenarioDir = join6(ctx.paths.testsDir, scenarioName);
+    const scenarioPath = join6(scenarioDir, `${scenarioName}.yaml`);
     ensureDir(scenarioDir);
     writeFile(scenarioPath, scenarioYaml);
     success(`Scenario saved: ${scenarioPath}`);
@@ -6923,18 +6833,18 @@ function registerScenario(program2) {
 }
 
 // src/commands/generate.ts
-import { join as join8, basename as basename2 } from "node:path";
+import { join as join7, basename as basename2 } from "node:path";
 function registerGenerate(program2) {
   program2.command("generate [scenario]").description("Generate Playwright test from YAML scenario").action(async (scenarioArg) => {
     const ctx = await resolveCommandContext(program2);
     const root = ctx.paths.projectRoot;
     let scenarioPath;
-    if (scenarioArg && fileExists(join8(root, scenarioArg))) {
-      scenarioPath = join8(root, scenarioArg);
+    if (scenarioArg && fileExists(join7(root, scenarioArg))) {
+      scenarioPath = join7(root, scenarioArg);
     } else if (ctx.key) {
-      scenarioPath = join8(ctx.paths.testsDir, ctx.key, `${ctx.key}.yaml`);
+      scenarioPath = join7(ctx.paths.testsDir, ctx.key, `${ctx.key}.yaml`);
     } else if (scenarioArg) {
-      scenarioPath = join8(ctx.paths.testsDir, scenarioArg, `${scenarioArg}.yaml`);
+      scenarioPath = join7(ctx.paths.testsDir, scenarioArg, `${scenarioArg}.yaml`);
     } else {
       error("Provide a scenario file path or --key");
       process.exit(1);
@@ -6966,8 +6876,8 @@ function registerGenerate(program2) {
       testContent = testContent.replace(/^```\w*\n/, "").replace(/\n```$/, "");
     }
     const testName = scenario.issueKey ?? ctx.key ?? basename2(scenarioPath, ".yaml");
-    const testDir = join8(ctx.paths.testsDir, testName);
-    const testPath = join8(testDir, `${testName}.test.ts`);
+    const testDir = join7(ctx.paths.testsDir, testName);
+    const testPath = join7(testDir, `${testName}.test.ts`);
     ensureDir(testDir);
     writeFile(testPath, testContent);
     success(`Test generated: ${testPath}`);
@@ -6992,16 +6902,16 @@ function registerGenerate(program2) {
 }
 
 // src/commands/refine.ts
-import { join as join9 } from "node:path";
+import { join as join8 } from "node:path";
 function registerRefine(program2) {
   program2.command("refine [test]").description("Refactor/improve test with AI").action(async (testArg) => {
     const ctx = await resolveCommandContext(program2);
     const root = ctx.paths.projectRoot;
     let testPath;
-    if (testArg && fileExists(join9(root, testArg))) {
-      testPath = join9(root, testArg);
+    if (testArg && fileExists(join8(root, testArg))) {
+      testPath = join8(root, testArg);
     } else if (ctx.key) {
-      testPath = join9(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
+      testPath = join8(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
     } else {
       error("Provide a test file path or --key");
       process.exit(1);
@@ -7038,16 +6948,16 @@ function registerRefine(program2) {
 }
 
 // src/commands/test.ts
-import { join as join10 } from "node:path";
+import { join as join9 } from "node:path";
 function registerTest(program2) {
   program2.command("test [test]").description("Run Playwright test with traces").action(async (testArg) => {
     const ctx = await resolveCommandContext(program2);
     const root = ctx.paths.projectRoot;
     let testPath;
-    if (testArg && fileExists(join10(root, testArg))) {
-      testPath = join10(root, testArg);
+    if (testArg && fileExists(join9(root, testArg))) {
+      testPath = join9(root, testArg);
     } else if (ctx.key) {
-      testPath = join10(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
+      testPath = join9(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
     } else {
       error("Provide a test file path or --key");
       process.exit(1);
@@ -7082,7 +6992,7 @@ async function runPlaywrightTest(testPath, root) {
     "--project",
     config.playwright.browser
   ];
-  const pkgConfigPath = join10(projectRoot, "packages", "e2e-ai", "playwright.e2e-ai.config.ts");
+  const pkgConfigPath = join9(projectRoot, "packages", "e2e-ai", "playwright.e2e-ai.config.ts");
   if (fileExists(pkgConfigPath)) {
     args.push("--config", pkgConfigPath);
   }
@@ -7109,17 +7019,17 @@ async function runPlaywrightTest(testPath, root) {
 }
 
 // src/commands/heal.ts
-import { join as join11 } from "node:path";
+import { join as join10 } from "node:path";
 var MAX_HEAL_RETRIES = 3;
 function registerHeal(program2) {
   program2.command("heal [test]").description("Self-heal a failing test").action(async (testArg) => {
     const ctx = await resolveCommandContext(program2);
     const root = ctx.paths.projectRoot;
     let testPath;
-    if (testArg && fileExists(join11(root, testArg))) {
-      testPath = join11(root, testArg);
+    if (testArg && fileExists(join10(root, testArg))) {
+      testPath = join10(root, testArg);
     } else if (ctx.key) {
-      testPath = join11(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
+      testPath = join10(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
     } else {
       error("Provide a test file path or --key");
       process.exit(1);
@@ -7192,16 +7102,16 @@ function registerHeal(program2) {
 }
 
 // src/commands/qa.ts
-import { join as join12 } from "node:path";
+import { join as join11 } from "node:path";
 function registerQa(program2) {
   program2.command("qa [test]").description("Generate QA documentation").action(async (testArg) => {
     const ctx = await resolveCommandContext(program2);
     const root = ctx.paths.projectRoot;
     let testPath;
-    if (testArg && fileExists(join12(root, testArg))) {
-      testPath = join12(root, testArg);
+    if (testArg && fileExists(join11(root, testArg))) {
+      testPath = join11(root, testArg);
     } else if (ctx.key) {
-      testPath = join12(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
+      testPath = join11(ctx.paths.testsDir, ctx.key, `${ctx.key}.test.ts`);
     } else {
       error("Provide a test file path or --key");
       process.exit(1);
@@ -7213,7 +7123,7 @@ function registerQa(program2) {
     const testContent = readFile(testPath);
     let scenario;
     if (ctx.key) {
-      const scenarioPath = join12(ctx.paths.testsDir, ctx.key, `${ctx.key}.yaml`);
+      const scenarioPath = join11(ctx.paths.testsDir, ctx.key, `${ctx.key}.yaml`);
       if (fileExists(scenarioPath)) {
         const yaml = await import("./index-54ycasgv.js");
         scenario = yaml.parse(readFile(scenarioPath));
@@ -7223,7 +7133,7 @@ function registerQa(program2) {
     let existingTestCase;
     if (ctx.key) {
       issueContext = await fetchIssueContext(ctx.key, ctx.config, ctx.paths);
-      const existingJsonPath = join12(ctx.paths.workingDir, ctx.key, `${ctx.key}-zephyr-test-case.json`);
+      const existingJsonPath = join11(ctx.paths.workingDir, ctx.key, `${ctx.key}-zephyr-test-case.json`);
       if (fileExists(existingJsonPath)) {
         existingTestCase = JSON.parse(readFile(existingJsonPath));
       }
@@ -7261,7 +7171,7 @@ function registerQa(program2) {
     if (qaResult.markdown && ctx.config.outputTarget !== "zephyr") {
       const qaDir = ctx.paths.qaDir;
       const testId = ctx.key ?? "test";
-      const qaMdPath = join12(qaDir, `${testId}.md`);
+      const qaMdPath = join11(qaDir, `${testId}.md`);
       ensureDir(qaDir);
       writeFile(qaMdPath, qaResult.markdown);
       success(`QA document: ${qaMdPath}`);
@@ -7271,7 +7181,7 @@ function registerQa(program2) {
 }
 
 // src/commands/run.ts
-import { join as join13 } from "node:path";
+import { join as join12 } from "node:path";
 
 // src/pipeline/runPipeline.ts
 async function runPipeline(steps, ctx, options) {
@@ -7383,7 +7293,7 @@ function buildSteps() {
           args.push("--no-voice");
         if (ctx.config.noTrace)
           args.push("--no-trace");
-        const scriptPath = join13(pkgRoot, "scripts", "codegen-env.mjs");
+        const scriptPath = join12(pkgRoot, "scripts", "codegen-env.mjs");
         const child = spawnInteractive("node", [scriptPath, ...args], {
           cwd: ctx.projectRoot,
           env: {
@@ -7397,8 +7307,8 @@ function buildSteps() {
         if (exitCode !== 0)
           return { success: false, output: null, error: new Error(`Recording exited with code ${exitCode}`) };
         if (ctx.key) {
-          ctx.codegenPath = findFileWithPattern(join13(ctx.paths.workingDir, ctx.key), /codegen-.*\.ts$/);
-          ctx.audioPath = findFileWithPattern(join13(ctx.paths.workingDir, ctx.key, "recordings"), /\.wav$/);
+          ctx.codegenPath = findFileWithPattern(join12(ctx.paths.workingDir, ctx.key), /codegen-.*\.ts$/);
+          ctx.audioPath = findFileWithPattern(join12(ctx.paths.workingDir, ctx.key, "recordings"), /\.wav$/);
         }
         return { success: true, output: { codegenPath: ctx.codegenPath, audioPath: ctx.audioPath } };
       }
@@ -7413,16 +7323,16 @@ function buildSteps() {
         if (!ctx.audioPath)
           return { success: true, output: null, nonBlocking: true };
         const pkgRoot = getPackageRoot();
-        const transcriber = await import(join13(pkgRoot, "scripts", "voice", "transcriber.mjs"));
+        const transcriber = await import(join12(pkgRoot, "scripts", "voice", "transcriber.mjs"));
         const segments = await transcriber.transcribe(ctx.audioPath);
         if (!segments?.length)
           return { success: true, output: { segments: [] }, nonBlocking: true };
-        const outputDir = ctx.key ? join13(ctx.paths.workingDir, ctx.key) : ctx.paths.transcriptsDir;
-        const jsonPath = join13(outputDir, `${ctx.sessionName}-transcript.json`);
+        const outputDir = ctx.key ? join12(ctx.paths.workingDir, ctx.key) : ctx.paths.transcriptsDir;
+        const jsonPath = join12(outputDir, `${ctx.sessionName}-transcript.json`);
         writeFile(jsonPath, JSON.stringify(segments, null, 2));
         ctx.transcriptPath = jsonPath;
         if (ctx.codegenPath) {
-          const merger = await import(join13(pkgRoot, "scripts", "voice", "merger.mjs"));
+          const merger = await import(join12(pkgRoot, "scripts", "voice", "merger.mjs"));
           const content = readFile(ctx.codegenPath);
           const merged = merger.merge(content, segments, segments[segments.length - 1].end);
           writeFile(ctx.codegenPath, merged);
@@ -7473,9 +7383,9 @@ function buildSteps() {
           maxTokens: agent.config.maxTokens,
           temperature: agent.config.temperature
         });
-        const scenarioDir = join13(ctx.paths.testsDir, ctx.sessionName);
+        const scenarioDir = join12(ctx.paths.testsDir, ctx.sessionName);
         ensureDir(scenarioDir);
-        const scenarioPath = join13(scenarioDir, `${ctx.sessionName}.yaml`);
+        const scenarioPath = join12(scenarioDir, `${ctx.sessionName}.yaml`);
         writeFile(scenarioPath, resp.content.trim());
         ctx.scenarioPath = scenarioPath;
         return { success: true, output: { scenarioPath } };
@@ -7502,8 +7412,8 @@ function buildSteps() {
         if (testContent.startsWith("```"))
           testContent = testContent.replace(/^```\w*\n/, "").replace(/\n```$/, "");
         const testName = ctx.key ?? ctx.sessionName;
-        const testDir = join13(ctx.paths.testsDir, testName);
-        ctx.testPath = join13(testDir, `${testName}.test.ts`);
+        const testDir = join12(ctx.paths.testsDir, testName);
+        ctx.testPath = join12(testDir, `${testName}.test.ts`);
         ensureDir(testDir);
         writeFile(ctx.testPath, testContent);
         return { success: true, output: { testPath: ctx.testPath } };
@@ -7633,7 +7543,8 @@ function buildSteps() {
 }
 
 // src/commands/init.ts
-import { join as join14 } from "node:path";
+import { join as join13 } from "node:path";
+import { readdirSync as readdirSync2, readFileSync as readFileSync2, existsSync as existsSync2 } from "node:fs";
 // node_modules/@inquirer/core/dist/lib/key.js
 var isUpKey = (key, keybindings = []) => key.name === "up" || keybindings.includes("vim") && key.name === "k" || keybindings.includes("emacs") && key.ctrl && key.name === "p";
 var isDownKey = (key, keybindings = []) => key.name === "down" || keybindings.includes("vim") && key.name === "j" || keybindings.includes("emacs") && key.ctrl && key.name === "n";
@@ -9149,7 +9060,7 @@ function registerInit(program2) {
     header("e2e-ai init");
     const answers = cmdOpts?.nonInteractive ? getDefaultAnswers() : await askConfigQuestions();
     const config = buildConfigFromAnswers(answers);
-    const configPath = join14(projectRoot, "e2e-ai.config.ts");
+    const configPath = join13(projectRoot, "e2e-ai.config.ts");
     if (fileExists(configPath)) {
       warn(`Config already exists: ${configPath}`);
       const overwrite = cmdOpts?.nonInteractive ? false : await dist_default4({ message: "Overwrite existing config?", default: false });
@@ -9163,29 +9074,28 @@ function registerInit(program2) {
       writeFile(configPath, generateConfigFile(config));
       success(`Config written: ${configPath}`);
     }
-    if (!cmdOpts?.nonInteractive) {
-      const opts = program2.opts();
-      const provider = opts.provider ?? process.env.AI_PROVIDER ?? answers.provider ?? "openai";
-      const model = opts.model ?? process.env.AI_MODEL;
-      const spinner = createSpinner();
-      spinner.start("Scanning codebase for test patterns...");
-      const scan = await scanCodebase(projectRoot);
-      spinner.stop();
-      if (scan.testFiles.length === 0 && scan.configFiles.length === 0) {
-        warn("No test files found. Skipping context generation.");
-        info("You can create e2e-ai.context.md manually later.");
-      } else {
-        info(`Found ${scan.testFiles.length} test files, ${scan.configFiles.length} config files`);
-        const contextContent = await runInitConversation(scan, provider, model);
-        if (contextContent) {
-          const contextPath = join14(projectRoot, config.contextFile ?? "e2e-ai.context.md");
-          writeFile(contextPath, contextContent);
-          success(`Context file written: ${contextPath}`);
-        }
-      }
-    }
-    success(`
-Initialization complete!`);
+    const spinner = createSpinner();
+    spinner.start("Scanning codebase for test patterns...");
+    const scan = await scanCodebase(projectRoot);
+    spinner.stop();
+    if (scan.testFiles.length === 0 && scan.configFiles.length === 0) {
+      warn("No test files found. Scan results will be minimal.");
+    } else {
+      info(`Found ${scan.testFiles.length} test files, ${scan.configFiles.length} config files`);
+    }
+    const instructionsContent = generateInstructionsFile(scan);
+    const instructionsPath = join13(projectRoot, "e2e-ai.instructions.md");
+    writeFile(instructionsPath, instructionsContent);
+    success(`Instructions written: ${instructionsPath}`);
+    const copiedCount = await copyAgentsToLocal(projectRoot, !!cmdOpts?.nonInteractive);
+    console.log("");
+    success(`Initialization complete!
+`);
+    console.log(import_picocolors2.default.bold("Next steps:"));
+    console.log(`  1. Open ${import_picocolors2.default.cyan("e2e-ai.instructions.md")} with your AI tool`);
+    console.log(`  2. Review the generated ${import_picocolors2.default.cyan(".e2e-ai/context.md")}`);
+    console.log(`  3. Customize agents in ${import_picocolors2.default.cyan(".e2e-ai/agents/")} if needed`);
+    console.log(`  4. Run: ${import_picocolors2.default.cyan("e2e-ai run --key PROJ-101")}`);
   });
 }
 function getDefaultAnswers() {
@@ -9248,7 +9158,7 @@ function buildConfigFromAnswers(answers) {
     outputTarget: answers.outputTarget,
     voice: { enabled: answers.voiceEnabled },
     llm: { provider: answers.provider },
-    contextFile: "e2e-ai.context.md"
+    contextFile: ".e2e-ai/context.md"
   };
   if (answers.baseUrl) {
     config.baseUrl = answers.baseUrl;
@@ -9280,124 +9190,165 @@ function generateConfigFile(config) {
   return lines.join(`
 `);
 }
-async function scanCodebase(root) {
-  const { readdirSync: readdirSync2, existsSync: existsSync3, readFileSync: readFileSync3, statSync } = await import("node:fs");
-  const { join: join15, relative } = await import("node:path");
-  const scan = {
-    testFiles: [],
-    configFiles: [],
-    fixtureFiles: [],
-    featureFiles: [],
-    tsconfigPaths: {},
-    playwrightConfig: null,
-    sampleTestContent: null
-  };
-  function walk(dir, depth = 0) {
-    if (depth > 5)
-      return [];
-    const files = [];
-    try {
-      for (const entry of readdirSync2(dir, { withFileTypes: true })) {
-        if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "dist")
-          continue;
-        const full = join15(dir, entry.name);
-        if (entry.isDirectory()) {
-          files.push(...walk(full, depth + 1));
-        } else {
-          files.push(full);
-        }
-      }
-    } catch {}
-    return files;
-  }
-  const allFiles = walk(root);
-  for (const file of allFiles) {
-    const rel = relative(root, file);
-    if (rel.endsWith(".test.ts") || rel.endsWith(".spec.ts")) {
-      scan.testFiles.push(rel);
-      if (!scan.sampleTestContent && scan.testFiles.length <= 3) {
-        try {
-          scan.sampleTestContent = readFileSync3(file, "utf-8").slice(0, 3000);
-        } catch {}
-      }
-    }
-    if (rel.endsWith(".feature.ts"))
-      scan.featureFiles.push(rel);
-    if (rel.includes("fixture") && rel.endsWith(".ts"))
-      scan.fixtureFiles.push(rel);
-    if (rel === "playwright.config.ts" || rel === "playwright.config.js")
-      scan.playwrightConfig = rel;
-    if (rel === "tsconfig.json" || rel.endsWith("/tsconfig.json")) {
-      try {
-        const tsconfig = JSON.parse(readFileSync3(file, "utf-8"));
-        if (tsconfig.compilerOptions?.paths) {
-          scan.tsconfigPaths = { ...scan.tsconfigPaths, ...tsconfig.compilerOptions.paths };
-        }
-      } catch {}
+function generateInstructionsFile(scan) {
+  const packageRoot = getPackageRoot();
+  const sections = [];
+  sections.push(`# e2e-ai: Context Generation Instructions
+
+This file was generated by \`e2e-ai init\`. It contains everything an AI tool needs to generate \`.e2e-ai/context.md\` for your project.
+
+## How to Use
+
+1. Open this file in your AI tool (Claude Code, Cursor, Gemini CLI, etc.)
+2. Ask it to follow these instructions to generate \`.e2e-ai/context.md\`
+3. Review the generated file and adjust as needed
+
+Alternatively, if the e2e-ai MCP server is configured, your AI tool can call \`e2e_ai_scan_codebase\` and \`e2e_ai_validate_context\` directly.
+
+---`);
+  sections.push(`## Task
+
+Scan this codebase and generate a file at \`.e2e-ai/context.md\` that documents the project's test infrastructure, conventions, and patterns. This context file is consumed by downstream AI agents (scenario, generator, refiner, healer, QA) to produce Playwright tests that match the project's existing style.`);
+  sections.push(`## Codebase Scan Results
+
+The following was pre-computed during \`e2e-ai init\`:
+
+### Test Files (${scan.testFiles.length} found)
+${scan.testFiles.length > 0 ? scan.testFiles.slice(0, 20).map((f) => `- \`${f}\``).join(`
+`) : "_No test files found_"}
+${scan.testFiles.length > 20 ? `
+_(${scan.testFiles.length - 20} more not shown)_` : ""}
+
+### Config Files
+${scan.configFiles.length > 0 ? scan.configFiles.map((f) => `- \`${f}\``).join(`
+`) : "_None found_"}
+
+### Fixture Files
+${scan.fixtureFiles.length > 0 ? scan.fixtureFiles.slice(0, 10).map((f) => `- \`${f}\``).join(`
+`) : "_None found_"}
+
+### Feature Files
+${scan.featureFiles.length > 0 ? scan.featureFiles.slice(0, 20).map((f) => `- \`${f}\``).join(`
+`) : "_None found_"}
+
+### Path Aliases (from tsconfig.json)
+${Object.keys(scan.tsconfigPaths).length > 0 ? Object.entries(scan.tsconfigPaths).map(([alias, targets]) => `- \`${alias}\` -> \`${targets.join(", ")}\``).join(`
+`) : "_None configured_"}
+
+### Playwright Config
+${scan.playwrightConfig ? `Found: \`${scan.playwrightConfig}\`` : "_Not found_"}
+
+### Sample Test Content
+${scan.sampleTestContent ? "```typescript\n" + scan.sampleTestContent + "\n```" : "_No sample available_"}`);
+  let agentChecklist = "";
+  try {
+    const agentContent = readFileSync2(join13(packageRoot, "agents", "init-agent.md"), "utf-8");
+    const bodyMatch = agentContent.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+    if (bodyMatch) {
+      agentChecklist = bodyMatch[1].trim();
     }
+  } catch {}
+  if (agentChecklist) {
+    sections.push(`## What to Look For
+
+The following guidance comes from the e2e-ai init agent:
+
+${agentChecklist}`);
   }
-  for (const name of ["playwright.config.ts", "vitest.config.ts", "jest.config.ts", "tsconfig.json", "package.json"]) {
-    if (existsSync3(join15(root, name)))
-      scan.configFiles.push(name);
-  }
-  return scan;
-}
-async function runInitConversation(scan, provider, model) {
-  const agent = loadAgent("init-agent");
-  const separator = import_picocolors2.default.dim("─".repeat(60));
-  const messages = [];
-  const scanMessage = JSON.stringify({
-    testFiles: scan.testFiles.slice(0, 20),
-    configFiles: scan.configFiles,
-    fixtureFiles: scan.fixtureFiles.slice(0, 10),
-    featureFiles: scan.featureFiles.slice(0, 20),
-    tsconfigPaths: scan.tsconfigPaths,
-    playwrightConfig: scan.playwrightConfig,
-    sampleTestContent: scan.sampleTestContent
-  }, null, 2);
-  messages.push({ role: "user", content: `Here are the scan results from the project:
+  sections.push(`## Output Format
 
-${scanMessage}` });
-  const MAX_TURNS = 5;
-  for (let turn = 0;turn < MAX_TURNS; turn++) {
-    const userContent = messages.filter((m) => m.role === "user").map((m) => m.content).join(`
+The generated \`.e2e-ai/context.md\` MUST contain these sections:
 
----
+\`\`\`markdown
+# Project Context for e2e-ai
+
+## Application
+<name, description, tech stack, base URL>
+
+## Test Infrastructure
+<fixtures, helpers, auth pattern>
+
+## Feature Methods
+<method signatures grouped by module>
+
+## Import Conventions
+<path aliases, standard imports>
+
+## Selector Conventions
+<preferred selector strategies, patterns>
+
+## Test Structure Template
+<code template showing standard test layout>
+
+## Utility Patterns
+<timeouts, waits, assertion patterns>
+\`\`\`
+
+All sections are required. The file should be 100-300 lines, self-contained, and use actual code from the project (not generic Playwright examples).`);
+  sections.push(`## How Context is Used
+
+Each pipeline agent reads \`.e2e-ai/context.md\` to understand project conventions:
+
+| Agent | Uses context for |
+|-------|-----------------|
+| **scenario-agent** | Structuring test steps to match project patterns |
+| **playwright-generator-agent** | Generating code with correct imports, fixtures, selectors |
+| **refactor-agent** | Applying project-specific refactoring patterns |
+| **self-healing-agent** | Understanding expected test structure when fixing failures |
+| **qa-testcase-agent** | Formatting QA documentation to match conventions |`);
+  let exampleContent = "";
+  try {
+    exampleContent = readFileSync2(join13(packageRoot, "templates", "e2e-ai.context.example.md"), "utf-8");
+  } catch {}
+  if (exampleContent) {
+    sections.push(`## Complete Example
+
+Below is a full example of a well-structured context file:
+
+${exampleContent}`);
+  }
+  return sections.join(`
 
 `);
-    const spinner = createSpinner();
-    spinner.start("Thinking...");
-    const resp = await callLLM({
-      provider,
-      model: model ?? agent.config.model,
-      systemPrompt: agent.systemPrompt,
-      userMessage: userContent,
-      maxTokens: agent.config.maxTokens,
-      temperature: agent.config.temperature
-    });
-    spinner.stop();
-    const assistantContent = resp.content.trim();
-    messages.push({ role: "assistant", content: assistantContent });
-    const contextMatch = assistantContent.match(/<context>([\s\S]*?)<\/context>/);
-    if (contextMatch) {
-      return contextMatch[1].trim();
-    }
-    console.log(`
-` + separator);
-    console.log(assistantContent);
-    console.log(separator + `
-`);
-    const answer = await dist_default5({
-      message: 'Your answer (or "done" to let the agent finalize)'
-    });
-    if (answer.toLowerCase() === "done") {
-      messages.push({ role: "user", content: "Please produce the final context document now based on what you know. Wrap it in <context> tags." });
-    } else {
-      messages.push({ role: "user", content: answer });
+}
+async function copyAgentsToLocal(projectRoot, nonInteractive) {
+  const packageRoot = getPackageRoot();
+  const sourceDir = join13(packageRoot, "agents");
+  const targetDir = join13(projectRoot, ".e2e-ai", "agents");
+  let agentFiles;
+  try {
+    agentFiles = readdirSync2(sourceDir).filter((f) => f.endsWith(".md"));
+  } catch {
+    warn("Could not read package agents directory");
+    return 0;
+  }
+  if (agentFiles.length === 0)
+    return 0;
+  const targetExists = existsSync2(targetDir);
+  if (targetExists) {
+    const existingFiles = readdirSync2(targetDir).filter((f) => f.endsWith(".md"));
+    if (existingFiles.length > 0) {
+      if (nonInteractive) {
+        info("Agent files already exist in .e2e-ai/agents/, skipping");
+        return 0;
+      }
+      const overwrite = await dist_default4({
+        message: `Agent files already exist in .e2e-ai/agents/ (${existingFiles.length} files). Overwrite?`,
+        default: false
+      });
+      if (!overwrite) {
+        info("Skipping agent copy");
+        return 0;
+      }
     }
   }
-  warn("Max conversation turns reached. Context may be incomplete.");
-  return null;
+  ensureDir(targetDir);
+  for (const file of agentFiles) {
+    const content = readFileSync2(join13(sourceDir, file), "utf-8");
+    writeFile(join13(targetDir, file), content);
+  }
+  success(`Agents copied to .e2e-ai/agents/ (${agentFiles.length} files)`);
+  return agentFiles.length;
 }
 
 // src/cli.ts