e2e-agent-runner 1.1.0 → 1.2.0

package/discover.mjs

@@ -25,13 +25,16 @@ const PLAYWRIGHT_MCP = process.env.E2E_PLAYWRIGHT_MCP || '@playwright/mcp@0.0.84
 const ARTIFACT_MAX_BYTES = 6 * 1024 * 1024; // step_result 본문 상한(서버가 다시 정규화·절단)
 const ROUTE_FILE_MAX_BYTES = 1024 * 1024;
 
-/** 산출 폴더 준비 + 브라우저 MCP 설정 → { outDir, routesDir, extraArgs, browser, promptAddon, cleanup } */
-export function prepareDiscover({ siteUrl }) {
+/** 산출 폴더 준비 + 브라우저 MCP 설정 → { outDir, routesDir, resultsDir, extraArgs, browser, promptAddon, cleanup }
+ *  results=true(QA 페이즈)면 results/ 폴더도 만들고 산출 안내에 포함한다. */
+export function prepareDiscover({ siteUrl, results = false }) {
   const outDir = mkdtempSync(join(tmpdir(), 'e2e-fm-'));
   const routesDir = join(outDir, 'routes');
+  const resultsDir = join(outDir, 'results');
   const shotsDir = join(outDir, 'shots');
   mkdirSync(routesDir, { recursive: true });
   mkdirSync(shotsDir, { recursive: true });
+  if (results) mkdirSync(resultsDir, { recursive: true });
 
   const mode = (process.env.E2E_BROWSER_MCP || '').trim();
   let mcpPath = null;
@@ -67,6 +70,10 @@ export function prepareDiscover({ siteUrl }) {
     '# 산출물 위치(러너 지정 — 이 경로에만 쓰기)',
     `- 라우트 파일 폴더: \`${routesDir}\`  (예: ${join(routesDir, '001.json')})`,
     `- 서비스 요약 파일: \`${join(outDir, 'map.json')}\``,
+    ...(results ? [
+      `- QA 결과 파일 폴더: \`${resultsDir}\`  (예: ${join(resultsDir, '001-<id8>.json')})`,
+      `- 추가 산출 파일(QA 계획·재검증 페이즈): \`${join(outDir, 'plan.json')}\` · \`${join(outDir, 'retest.json')}\``,
+    ] : []),
     `- 스크린샷 등 브라우저 산출물은 \`${shotsDir}\` 에 저장됩니다(저장소에 저장 금지).`,
     '',
     '# 브라우저 도구',
@@ -91,7 +98,7 @@ export function prepareDiscover({ siteUrl }) {
     }
   };
 
-  return { outDir, routesDir, extraArgs, browser, promptAddon, cleanup };
+  return { outDir, routesDir, resultsDir, extraArgs, browser, promptAddon, cleanup };
 }
 
 /** 기록된 라우트 파일 수(진행률 이벤트용). */
@@ -118,6 +125,8 @@ function fallbackFromText(text) {
       const v = JSON.parse(blocks[i][1]);
       if (v && Array.isArray(v.routes)) return v;
       if (v && typeof v.path === 'string') return { routes: [v] };
+      if (v && Array.isArray(v.results)) return { results: v.results };
+      if (v && Array.isArray(v.items)) return { plan: v };
     } catch {
       /* 다음 블록 */
     }
@@ -125,8 +134,28 @@ function fallbackFromText(text) {
   return null;
 }
 
-/** 산출 폴더 수집 → artifact {map, routes[], partial, errors[], browser}. */
-export function collectArtifact({ outDir, routesDir, browser, finalText, partial }) {
+/** 폴더의 *.json 을 정렬 순서로 파싱 적재(parse 실패는 errors 기록). */
+function readJsonDir(dir, list, errors) {
+  let files = [];
+  try {
+    files = readdirSync(dir).filter((f) => f.endsWith('.json')).sort();
+  } catch {
+    return;
+  }
+  for (const f of files) {
+    try {
+      const v = readJson(join(dir, f), ROUTE_FILE_MAX_BYTES);
+      if (Array.isArray(v)) list.push(...v);
+      else list.push(v);
+    } catch (e) {
+      errors.push(`${f} 파싱 실패: ${e.message}`.slice(0, 300));
+    }
+  }
+}
+
+/** 산출 폴더 수집 → artifact {map, routes[], results[], plan, retest, partial, errors[], browser}.
+ *  feature_map 은 routes/map 을, QA 페이즈는 results/plan/retest 를 기록한다(서버가 페이즈별 해석). */
+export function collectArtifact({ outDir, routesDir, resultsDir, browser, finalText, partial }) {
   const errors = [];
   let map = null;
   const mapPath = join(outDir, 'map.json');
@@ -136,46 +165,48 @@ export function collectArtifact({ outDir, routesDir, browser, finalText, partial
     } catch (e) {
       errors.push(`map.json 파싱 실패: ${e.message}`.slice(0, 300));
     }
-  } else {
+  } else if (!resultsDir) {
     errors.push('map.json 없음(요약·커버리지 누락)');
   }
 
   const routes = [];
-  let files = [];
-  try {
-    files = readdirSync(routesDir).filter((f) => f.endsWith('.json')).sort();
-  } catch {
-    /* 폴더 없음 */
-  }
-  for (const f of files) {
-    try {
-      const v = readJson(join(routesDir, f), ROUTE_FILE_MAX_BYTES);
-      if (Array.isArray(v)) routes.push(...v); // 한 파일에 여러 라우트를 쓴 경우도 수용
-      else routes.push(v);
-    } catch (e) {
-      errors.push(`${f} 파싱 실패: ${e.message}`.slice(0, 300));
+  readJsonDir(routesDir, routes, errors);
+  const results = [];
+  if (resultsDir) readJsonDir(resultsDir, results, errors);
+
+  let plan = null;
+  let retest = null;
+  for (const [name, key] of [['plan.json', 'plan'], ['retest.json', 'retest']]) {
+    const p = join(outDir, name);
+    if (existsSync(p)) {
+      try {
+        const v = readJson(p, ROUTE_FILE_MAX_BYTES);
+        if (key === 'plan') plan = v; else retest = v;
+      } catch (e) {
+        errors.push(`${name} 파싱 실패: ${e.message}`.slice(0, 300));
+      }
     }
   }
-  if (!routes.length) {
+
+  if (!routes.length && !results.length && !plan && !retest) {
     const fb = fallbackFromText(finalText);
     if (fb) {
-      routes.push(...fb.routes);
-      if (!map && fb.map) map = fb.map;
-      errors.push('라우트 파일이 없어 최종 보고의 JSON 블록을 사용');
+      if (fb.routes) routes.push(...fb.routes);
+      if (fb.results) results.push(...fb.results);
+      if (fb.map && !map) map = fb.map;
+      errors.push('산출 파일이 없어 최종 보고의 JSON 블록을 사용');
     }
   }
 
-  const artifact = { map, routes, partial: Boolean(partial), errors, browser };
-  // 본문 상한 — 초과 시 뒤쪽 라우트부터 제외(Claude 는 핵심 화면부터 기록한다).
+  const artifact = { map, routes, results, plan, retest, partial: Boolean(partial), errors, browser };
+  // 본문 상한 — 초과 시 뒤쪽 라우트/결과부터 제외(Claude 는 핵심 항목부터 기록한다).
   let size = Buffer.byteLength(JSON.stringify(artifact));
-  while (size > ARTIFACT_MAX_BYTES && artifact.routes.length > 1) {
-    artifact.routes.pop();
+  while (size > ARTIFACT_MAX_BYTES && (artifact.routes.length > 1 || artifact.results.length > 1)) {
+    if (artifact.routes.length >= artifact.results.length) artifact.routes.pop();
+    else artifact.results.pop();
     artifact.partial = true;
     size = Buffer.byteLength(JSON.stringify(artifact));
   }
-  if (artifact.routes.length < routes.length) {
-    artifact.errors.push(`산출물 용량 상한으로 라우트 ${routes.length - artifact.routes.length}개 제외`);
-  }
   return artifact;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "e2e-agent-runner",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "suseona e2e 작업 에이전트 로컬 러너 — 내 컴퓨터의 Claude Code 로 구현→테스트→리뷰→배포와 웹사이트 기능 지도 추출을 자동 수행",
   "type": "module",
   "license": "UNLICENSED",

package/runner.mjs

@@ -166,7 +166,7 @@ async function handleStep({ step, task, project }) {
       result = await runImplement({ step, task, project, buf, cancelled });
     } else if (step.phase === 'deploy') {
       result = await runDeploy({ step, task, project, buf, cancelled });
-    } else if (step.phase === 'discover') {
+    } else if (step.phase === 'discover' || step.phase.startsWith('qa_')) {
       result = await runDiscover({ step, task, project, buf, cancelled });
     } else {
       // test / remediate / review — 서버 프롬프트(prompt_md)·세션(resume) 그대로 실행.
@@ -222,28 +222,30 @@ async function runImplement({ step, task, project, buf, cancelled }) {
   return { ...result, commits };
 }
 
-/** discover — 기능 지도 추출(읽기 전용). 브랜치·프리플라이트 없이 프로젝트 폴더에서 claude 를
- *  브라우저 MCP 와 함께 실행하고, 임시 산출 폴더의 기록분을 artifact 로 수집해 보고한다.
- *  시간 초과·실패여도 수집분이 있으면 보고(서버가 partial 로 보존). */
+/** discover — 기능 지도 추출·QA 페이즈(qa_run/qa_plan/qa_verify — 읽기 전용). 브랜치·프리플라이트
+ *  없이 프로젝트 폴더에서 claude 를 브라우저 MCP 와 함께 실행하고, 임시 산출 폴더의 기록분을
+ *  artifact 로 수집해 보고한다. 시간 초과·실패여도 수집분이 있으면 보고(서버가 partial 로 보존).
+ *  qa_plan 은 직전 qa_run 세션을 resume 한다(문제를 직접 관찰한 컨텍스트 위에서 계획). */
 async function runDiscover({ step, task, project, buf, cancelled }) {
   if (!state.claudeBin) throw new Error('claude CLI 를 찾을 수 없습니다 — CLAUDE_BIN 확인 후 러너를 재시작하세요.');
-  const prep = prepareDiscover({ siteUrl: project.site_url });
-  log(`기능 지도 탐색 시작: ${project.site_url ?? '(사이트 없음)'} — browser=${prep.browser}, out=${prep.outDir}`);
-  buf.push(step.id, 'status', { event: 'fm_started', browser: prep.browser });
+  const isQa = step.phase.startsWith('qa_');
+  const prep = prepareDiscover({ siteUrl: project.site_url, results: isQa });
+  log(`${isQa ? 'QA' : '기능 지도'} 탐색 시작: ${project.site_url ?? '(사이트 없음)'} — browser=${prep.browser}, out=${prep.outDir}`);
+  buf.push(step.id, 'status', { event: 'fm_started', phase: step.phase, browser: prep.browser });
   const before = await porcelain(project.folder_path);
   let lastCount = 0;
   const progress = setInterval(() => {
-    const n = countRouteFiles(prep.routesDir);
+    const n = countRouteFiles(prep.routesDir) + countRouteFiles(prep.resultsDir);
     if (n !== lastCount) {
       lastCount = n;
-      buf.push(step.id, 'status', { event: 'fm_progress', routes: n });
+      buf.push(step.id, 'status', { event: 'fm_progress', phase: step.phase, files: n });
     }
   }, 10_000);
   try {
     const result = await runClaude({
       cwd: project.folder_path,
       prompt: `${step.prompt_md}\n${prep.promptAddon}\n`,
-      resumeSessionId: null,
+      resumeSessionId: step.phase === 'qa_plan' ? step.session_id : null,
       maxTurns: MAX_TURNS_DISCOVER,
       timeoutS: DISCOVER_TIMEOUT_S,
       extraArgs: prep.extraArgs,
@@ -262,7 +264,8 @@ async function runDiscover({ step, task, project, buf, cancelled }) {
       partial: !result.ok || flag !== 'pass',
     });
     buf.push(step.id, 'status', {
-      event: 'fm_collected', routes: artifact.routes.length, errors: artifact.errors.slice(0, 5),
+      event: 'fm_collected', phase: step.phase,
+      routes: artifact.routes.length, results: artifact.results.length, errors: artifact.errors.slice(0, 5),
     });
     const after = await porcelain(project.folder_path);
     if (before !== null && after !== null && after !== before) {