@deepstorm/cli 0.10.2 → 0.11.1

package/dist/skills/sweep-run/SKILL.md

@@ -28,12 +28,12 @@ deepstorm:
 
 ### 执行模式说明
 
-| 模式 | 参数 | MCP 模式 | 说明 | 加速比 |
-|------|------|---------|------|--------|
+| 模式                 | 参数              | MCP 模式 | 说明                                                                             | 加速比  |
+| -------------------- | ----------------- | -------- | -------------------------------------------------------------------------------- | ------- |
 | **混合执行（默认）** | （无）或 `--fast` | headless | 预编译 `.flow.spec.ts` → 原生 Playwright 执行（`--reporter=line`）；失败 AI 自愈 | ~10-20x |
-| 纯原生（不自愈） | `--native` | 不启动 | 只用原生 Playwright 执行，失败不自愈 | ~20x |
-| 批量（单线程） | `--no-parallel` | headless | 原生执行 + 单线程顺序运行 | ~10x |
-| 浏览器调试 | `--browser` | headed | AI 逐步骤 MCP 调用 + 浏览器窗口可见 | 1x |
+| 纯原生（不自愈）     | `--native`        | 不启动   | 只用原生 Playwright 执行，失败不自愈                                             | ~20x    |
+| 批量（单线程）       | `--no-parallel`   | headless | 原生执行 + 单线程顺序运行                                                        | ~10x    |
+| 浏览器调试           | `--browser`       | headed   | AI 逐步骤 MCP 调用 + 浏览器窗口可见                                              | 1x      |
 
 ---
 
@@ -48,7 +48,7 @@ node scripts/env-manager.mjs --framework
 ```
 
 ```json
-{"framework":"playwright","source":"deepstorm-settings"}
+{ "framework": "playwright", "source": "deepstorm-settings" }
 ```
 
 - **playwright** → 通过 Playwright MCP（`deepstorm-playwright`）执行浏览器操作
@@ -98,9 +98,9 @@ node scripts/env-manager.mjs --project-root
    ```markdown
    📋 可用测试模块：
 
-     1. user-system/register（3 个用例：L01-L03）
-     2. user-system/login（2 个用例：L01-L02）
-     3. tasks/crud（4 个用例：T01-T04）
+   1. user-system/register（3 个用例：L01-L03）
+   2. user-system/login（2 个用例：L01-L02）
+   3. tasks/crud（4 个用例：T01-T04）
 
    请选择：全部执行 / 输入序号（如 1,3） / 输入模块名
    ```
@@ -124,19 +124,20 @@ node scripts/env-manager.mjs --project-root
 
 #### 2.2 直接参数模式
 
-| 参数 | 行为 | 示例 |
-|------|------|------|
-| `--all` | 执行 flows/ 下所有 .flow.md | `/sweep-run --all` |
-| `--path {module}` | 执行指定模块路径下的所有 .flow | `/sweep-run --path user-system/login` |
-| `{file-path}` | 执行指定文件 | `/sweep-run flows/login.flow.md` |
-| `{file-path} --flow {ID}` | 只执行文件中的某个 Flow | `/sweep-run login.flow.md --flow L02` |
-| `--env {env}` | 切换目标环境 | `/sweep-run --all --env staging` |
-| `--browser` | 打开浏览器窗口逐步骤调试 | `/sweep-run --all --browser` |
-| `--no-parallel` | 使用批量但不并行 | `/sweep-run --all --no-parallel` |
+| 参数                      | 行为                           | 示例                                  |
+| ------------------------- | ------------------------------ | ------------------------------------- |
+| `--all`                   | 执行 flows/ 下所有 .flow.md    | `/sweep-run --all`                    |
+| `--path {module}`         | 执行指定模块路径下的所有 .flow | `/sweep-run --path user-system/login` |
+| `{file-path}`             | 执行指定文件                   | `/sweep-run flows/login.flow.md`      |
+| `{file-path} --flow {ID}` | 只执行文件中的某个 Flow        | `/sweep-run login.flow.md --flow L02` |
+| `--env {env}`             | 切换目标环境                   | `/sweep-run --all --env staging`      |
+| `--browser`               | 打开浏览器窗口逐步骤调试       | `/sweep-run --all --browser`          |
+| `--no-parallel`           | 使用批量但不并行               | `/sweep-run --all --no-parallel`      |
 
 #### 2.3 文件不存在处理
 
 如指定的文件或 --path 不存在：
+
 - 提示"指定路径不存在"
 - 读取 topology.yaml 展示可用模块
 - 引导用户重新选择
@@ -165,6 +166,7 @@ Flows数组：
 ```
 
 提取每个 Flow 中的：
+
 - 前置条件（描述性文本，用于理解上下文）
 - 步骤列表（有序操作 + 验证点）
 - 环境要求（用于 --env 默认值）
@@ -184,10 +186,14 @@ node scripts/env-manager.mjs --env staging
 输出示例：
 
 ```json
-{"env":"staging","baseUrl":"https://staging.example.com","availableEnvs":[
-  {"name":"test","key":"BASE_URL_TEST","url":"https://test.example.com"},
-  {"name":"staging","key":"BASE_URL_STAGING","url":"https://staging.example.com"}
-]}
+{
+  "env": "staging",
+  "baseUrl": "https://staging.example.com",
+  "availableEnvs": [
+    { "name": "test", "key": "BASE_URL_TEST", "url": "https://test.example.com" },
+    { "name": "staging", "key": "BASE_URL_STAGING", "url": "https://staging.example.com" }
+  ]
+}
 ```
 
 - `--env staging` → 从 `settings.json` 的 `sweep.environments.staging` 读取
@@ -201,6 +207,7 @@ export BASE_URL=$(node scripts/env-manager.mjs --env test --print 2>/dev/null |
 ```
 
 或从 JSON 结果提取：
+
 ```bash
 BASE_URL=$(node scripts/env-manager.mjs --env test | node -pe "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')).baseUrl")
 ```
@@ -246,8 +253,9 @@ node scripts/mcp-manager.mjs --mode=skip
 ```
 
 输出 JSON：
+
 ```json
-{"action":"started","mode":"headless","pid":12345,"port":54321}
+{ "action": "started", "mode": "headless", "pid": 12345, "port": 54321 }
 ```
 
 `action` 取值：`started`（新启动）/ `already-ok`（已在正确模式）/ `switched`（切换后重启）/ `skipped`（跳过）。
@@ -333,13 +341,13 @@ flowchart LR
 
 **操作类型：**
 
-| 操作 | MCP 调用 | 验证方式 |
-|------|---------|---------|
-| 导航 | navigate/goto | 检查页面标题/URL |
-| 点击 | click | 检查预期元素/状态变化 |
-| 输入 | fill | 检查输入回显或后续页面状态 |
-| 选择 | select | 检查选项是否生效 |
-| 等待 | waitFor | 检查超时或条件满足 |
+| 操作 | MCP 调用      | 验证方式                   |
+| ---- | ------------- | -------------------------- |
+| 导航 | navigate/goto | 检查页面标题/URL           |
+| 点击 | click         | 检查预期元素/状态变化      |
+| 输入 | fill          | 检查输入回显或后续页面状态 |
+| 选择 | select        | 检查选项是否生效           |
+| 等待 | waitFor       | 检查超时或条件满足         |
 
 **执行完成后：** 杀掉 headed 进程，以 `--headless` 重启恢复默认模式。
 
@@ -364,12 +372,12 @@ flowchart LR
 
 **判定与处理：**
 
-| 判定结果 | 操作 | 报告中标注 |
-|----------|------|-----------|
-| **元素选择器失效**（元素存在但 CSS class/data-testid 变化） | 更新定位器；添加 `// auto-repaired: {timestamp} - {old} -> {new}` 注释；**重跑**确认 | 自愈成功 |
-| **数据累积**（多次运行导致同名元素重复，`.first()`/`.last()` 选错目标） | 通过 `page.evaluate()` 调用 API 清理历史残留数据后重跑 | 自愈成功 |
-| **真 Bug**（元素不存在、页面行为不符合预期） | 不修改 spec 文件 | 确认 Bug |
-| **修复无效**（更新后重跑仍然失败） | 放弃修复 | 自愈放弃 |
+| 判定结果                                                                | 操作                                                                                 | 报告中标注 |
+| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ---------- |
+| **元素选择器失效**（元素存在但 CSS class/data-testid 变化）             | 更新定位器；添加 `// auto-repaired: {timestamp} - {old} -> {new}` 注释；**重跑**确认 | 自愈成功   |
+| **数据累积**（多次运行导致同名元素重复，`.first()`/`.last()` 选错目标） | 通过 `page.evaluate()` 调用 API 清理历史残留数据后重跑                               | 自愈成功   |
+| **真 Bug**（元素不存在、页面行为不符合预期）                            | 不修改 spec 文件                                                                     | 确认 Bug   |
+| **修复无效**（更新后重跑仍然失败）                                      | 放弃修复                                                                             | 自愈放弃   |
 
 **循环保护：** 同一 Flow 最多重试 **3 次**，超限则停止并保留最后一次失败报告。
 
@@ -417,16 +425,17 @@ Flow: L01 - 正常登录成功
 
 ## Flow: L01 - 正常登录成功 X
 
-| 步骤 | 操作 | 验证 | 结果 |
-|------|------|------|------|
-| 1/4 | 打开登录页面 | 页面加载完成 | OK |
-| 2/4 | 输入邮箱 | 输入框显示 | OK |
-| 3/4 | 点击登录按钮 | URL 跳转 /dashboard | X |
-| 4/4 | （跳过） | - | > |
+| 步骤 | 操作         | 验证                | 结果 |
+| ---- | ------------ | ------------------- | ---- |
+| 1/4  | 打开登录页面 | 页面加载完成        | OK   |
+| 2/4  | 输入邮箱     | 输入框显示          | OK   |
+| 3/4  | 点击登录按钮 | URL 跳转 /dashboard | X    |
+| 4/4  | （跳过）     | -                   | >    |
 
 ### 失败详情
 
 **步骤 3/4：** 点击登录按钮
+
 - 期望：URL 跳转到 /dashboard
 - 实际：URL 保持在 /login
 - 可能原因：登录失败或页面未正确响应
@@ -435,14 +444,14 @@ Flow: L01 - 正常登录成功
 
 ## 汇总
 
-| 项目 | 值 |
-|------|-----|
-| 总 Flow 数 | 1 |
-| 总步骤数 | 3 |
-| 通过 | 2 |
-| 失败 | 1 |
-| 跳过 | 1 |
-| 通过率 | 66% |
+| 项目       | 值  |
+| ---------- | --- |
+| 总 Flow 数 | 1   |
+| 总步骤数   | 3   |
+| 通过       | 2   |
+| 失败       | 1   |
+| 跳过       | 1   |
+| 通过率     | 66% |
 ```
 
 #### 8.3 报告文件名格式

package/dist/skills/sweep-run/scripts/env-manager.mjs

@@ -107,8 +107,7 @@ export function parseDotEnv(content) {
     const key = trimmed.slice(0, sepIdx).trim();
     let value = trimmed.slice(sepIdx + 1).trim();
     // Strip surrounding quotes
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
       value = value.slice(1, -1);
     }
     env[key] = value;
@@ -306,7 +305,7 @@ if (process.argv[1] === import.meta.filename) {
   }
 
   if (args.includes('--check-mcp')) {
-    const mcpName = args.find(a => a.startsWith('--mcp='))?.split('=')[1] || 'deepstorm-playwright';
+    const mcpName = args.find((a) => a.startsWith('--mcp='))?.split('=')[1] || 'deepstorm-playwright';
     const result = checkMcpAvailable(mcpName);
     console.log(JSON.stringify(result));
     process.exit(0);
@@ -333,7 +332,7 @@ if (process.argv[1] === import.meta.filename) {
   }
 
   // Default: resolve env
-  const envFlag = args.find(a => a.startsWith('--env='));
+  const envFlag = args.find((a) => a.startsWith('--env='));
   const envName = envFlag ? envFlag.split('=')[1] : undefined;
   const result = resolveEnv(envName);
 
@@ -342,7 +341,7 @@ if (process.argv[1] === import.meta.filename) {
       console.log(`export BASE_URL=${result.baseUrl}`);
     } else {
       console.error(`# No base URL found for environment "${result.env}"`);
-      console.error(`# Available: ${result.availableEnvs.map(e => e.name).join(', ')}`);
+      console.error(`# Available: ${result.availableEnvs.map((e) => e.name).join(', ')}`);
       process.exit(1);
     }
   } else {

package/dist/skills/sweep-run/scripts/flow-parser.mjs

@@ -62,7 +62,10 @@ function parseScenarios(content) {
   let inBody = false;
   for (const line of lines) {
     // Skip header and separator
-    if (/^\|[-]+\|/.test(line) && line.includes('---')) { inBody = true; continue; }
+    if (/^\|[-]+\|/.test(line) && line.includes('---')) {
+      inBody = true;
+      continue;
+    }
     if (!inBody) continue;
 
     const m = line.match(SCENARIO_ROW_RE);
@@ -172,9 +175,7 @@ function parseFlows(content) {
 
     // Get content between this flow heading and the next, or end of file
     const startIdx = heading.index + heading[0].length;
-    const endIdx = i + 1 < flowHeadings.length
-      ? flowHeadings[i + 1].index
-      : content.length;
+    const endIdx = i + 1 < flowHeadings.length ? flowHeadings[i + 1].index : content.length;
     const flowContent = content.slice(startIdx, endIdx);
 
     const preconditionsMatch = flowContent.match(PRECONDITIONS_RE);
@@ -186,8 +187,8 @@ function parseFlows(content) {
     if (preconditionsMatch) {
       const precondLines = preconditionsMatch[1]
         .split('\n')
-        .map(l => l.replace(/^-\s*/, '').trim())
-        .filter(l => l.length > 0);
+        .map((l) => l.replace(/^-\s*/, '').trim())
+        .filter((l) => l.length > 0);
       flow.preconditions = precondLines.join('\n');
     }
 

package/dist/skills/sweep-run/scripts/flow-selector.mjs

@@ -41,11 +41,7 @@ async function getCheckbox() {
 // ── TTY detection ───────────────────────────────────────────────────
 
 function isTtyAvailable() {
-  return Boolean(
-    process.stdout.isTTY &&
-    process.stdin.isTTY &&
-    process.stdin.setRawMode
-  );
+  return Boolean(process.stdout.isTTY && process.stdin.isTTY && process.stdin.setRawMode);
 }
 
 // ── YAML 解析（轻量，不依赖 yaml 包） ──────────────────────────
@@ -98,14 +94,10 @@ function resolveFlowFile(modulePath, baseFlowsDir) {
 
   const parts = modulePath.split('/');
   const leafName = parts[parts.length - 1];
-  const parentDir = parts.length > 1
-    ? join(baseFlowsDir, parts.slice(0, -1).join('/'))
-    : baseFlowsDir;
+  const parentDir = parts.length > 1 ? join(baseFlowsDir, parts.slice(0, -1).join('/')) : baseFlowsDir;
   if (existsSync(parentDir)) {
     const files = readdirSync(parentDir);
-    const found = files.find(
-      (f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase())
-    );
+    const found = files.find((f) => f.endsWith('.flow.md') && f.toLowerCase().includes(leafName.toLowerCase()));
     if (found) return join(parentDir, found);
   }
 
@@ -442,10 +434,7 @@ async function main() {
       }
     }
 
-    choices = [
-      { name: '📋 全部执行', value: '__all__' },
-      ...choices,
-    ];
+    choices = [{ name: '📋 全部执行', value: '__all__' }, ...choices];
 
     // ── Decide mode: text vs checkbox ──────────────────────
 

package/dist/skills/sweep-run/scripts/generate-report.mjs

@@ -30,8 +30,7 @@ import { resolve } from 'node:path';
  */
 export function generateReport(data) {
   const total = data.passed + data.failed + data.skipped;
-  const passRate = total > 0
-    ? Math.round((data.passed / total) * 100) : 0;
+  const passRate = total > 0 ? Math.round((data.passed / total) * 100) : 0;
 
   const lines = [];
   lines.push('# 测试执行报告\n');

package/dist/skills/sweep-run/scripts/mcp-manager.mjs

@@ -13,6 +13,10 @@
  *   node mcp-manager.mjs --status [--port 54321]
  *   node mcp-manager.mjs --stop [--port 54321]
  *   import { ensureMcp, stopMcp, getStatus } from './mcp-manager.mjs'
+ *
+ * Cross-platform note:
+ *   所有系统调用均兼容 macOS / Linux / Windows。
+ *   使用 Node.js 内置 API 替代 lsof / ps / sleep / SIGKILL 等 Unix-only 命令。
  */
 
 import { execSync, spawn } from 'node:child_process';
@@ -20,16 +24,39 @@ import { execSync, spawn } from 'node:child_process';
 const DEFAULT_PORT = 54321;
 const MCP_PACKAGE = '@playwright/mcp';
 
-// ── Process helpers ────────────────────────────────────────────────
+// ── Cross-platform helpers ─────────────────────────────────────────
 
 /**
- * Find PID of process listening on a given TCP port.
- * Returns null if nothing is listening.
+ * 跨平台同步 sleep — 使用 Atomics.wait 实现，不依赖 shell sleep 命令。
+ * @param {number} ms
+ */
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+// ── Cross-platform process helpers ──────────────────────────────────
+
+/**
+ * 跨平台查找监听指定 TCP 端口的进程 PID。
+ *
+ * - macOS/Linux: lsof -ti tcp:<port>
+ * - Windows: netstat -ano | findstr LISTENING
+ *
+ * @param {number} port
+ * @returns {number|null}
  */
 export function findPidByPort(port) {
+  if (process.platform === 'win32') {
+    return findPidByPortWin(port);
+  }
+  return findPidByPortUnix(port);
+}
+
+function findPidByPortUnix(port) {
   try {
-    const stdout = execSync(`lsof -ti tcp:${port} 2>/dev/null`, {
+    const stdout = execSync(`lsof -ti tcp:${port}`, {
       encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
       timeout: 3000,
     }).trim();
     return stdout ? parseInt(stdout.split('\n')[0], 10) : null;
@@ -38,13 +65,47 @@ export function findPidByPort(port) {
   }
 }
 
+function findPidByPortWin(port) {
+  try {
+    const stdout = execSync(`netstat -ano | findstr "LISTENING" | findstr ":${port} "`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 5000,
+    }).trim();
+    // netstat output: TCP    0.0.0.0:8080    0.0.0.0:0    LISTENING    12345
+    const lines = stdout.split('\n');
+    for (const line of lines) {
+      const parts = line.trim().split(/\s+/);
+      const pid = parseInt(parts[parts.length - 1], 10);
+      if (Number.isFinite(pid)) return pid;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 /**
- * Get the command line of a process by PID.
+ * 跨平台获取进程命令行。
+ *
+ * - macOS/Linux: ps -p <pid> -o args=
+ * - Windows: wmic process where processid=<pid> get commandline
+ *
+ * @param {number} pid
+ * @returns {string}
  */
 export function getProcessCommand(pid) {
+  if (process.platform === 'win32') {
+    return getProcessCommandWin(pid);
+  }
+  return getProcessCommandUnix(pid);
+}
+
+function getProcessCommandUnix(pid) {
   try {
-    return execSync(`ps -p ${pid} -o args= 2>/dev/null`, {
+    return execSync(`ps -p ${pid} -o args=`, {
       encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
       timeout: 3000,
     }).trim();
   } catch {
@@ -52,6 +113,20 @@ export function getProcessCommand(pid) {
   }
 }
 
+function getProcessCommandWin(pid) {
+  try {
+    const stdout = execSync(`wmic process where processid=${pid} get commandline`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'ignore'],
+      timeout: 5000,
+    }).trim();
+    const lines = stdout.split('\n').filter(Boolean);
+    return lines.length >= 2 ? lines[1].trim() : '';
+  } catch {
+    return '';
+  }
+}
+
 /**
  * Check if a process command indicates headless mode.
  */
@@ -60,12 +135,17 @@ export function isHeadless(cmd) {
 }
 
 /**
- * Kill a process by PID with escalation (SIGTERM -> SIGKILL).
+ * 跨平台终止进程。
+ *
+ * - macOS/Linux: SIGTERM → wait → SIGKILL (force)
+ * - Windows: process.kill SIGTERM → taskkill /F (force fallback)
+ *
+ * @param {number} pid
  */
 export function killProcess(pid) {
   try {
     process.kill(pid, 'SIGTERM');
-    // Wait briefly for graceful shutdown
+    // Wait briefly for graceful shutdown — polling with setTimeout
     const start = Date.now();
     while (Date.now() - start < 2000) {
       try {
@@ -73,10 +153,23 @@ export function killProcess(pid) {
       } catch {
         return; // process is gone
       }
-      execSync('sleep 0.2', { timeout: 1000 });
+      // Busy-wait with micro-pause to avoid CPU spin
+      const pollStart = Date.now();
+      while (Date.now() - pollStart < 50) {
+        /* yield */
+      }
     }
     // Force kill
-    process.kill(pid, 'SIGKILL');
+    if (process.platform === 'win32') {
+      // Windows: SIGKILL unsupported, use taskkill /F
+      try {
+        execSync(`taskkill /F /PID ${pid}`, { stdio: 'ignore', timeout: 5000 });
+      } catch {
+        // already dead
+      }
+    } else {
+      process.kill(pid, 'SIGKILL');
+    }
   } catch {
     // already dead
   }
@@ -142,7 +235,7 @@ export function ensureMcp(options = {}) {
     }
     // Running in wrong mode -- restart
     stopMcp(port);
-    execSync('sleep 1', { timeout: 2000 });
+    sleepSync(1000);
   }
 
   // Start MCP
@@ -161,7 +254,7 @@ export function ensureMcp(options = {}) {
   const deadline = Date.now() + 10000;
   let startedPid = null;
   while (Date.now() < deadline) {
-    execSync('sleep 0.3', { timeout: 1000 });
+    sleep(300);
     const found = findPidByPort(port);
     if (found) {
       startedPid = found;
@@ -181,8 +274,8 @@ export function ensureMcp(options = {}) {
 
 if (process.argv[1] === import.meta.filename) {
   const args = process.argv.slice(2);
-  const modeFlag = args.find(a => a.startsWith('--mode='));
-  const portFlag = args.find(a => a.startsWith('--port='));
+  const modeFlag = args.find((a) => a.startsWith('--mode='));
+  const portFlag = args.find((a) => a.startsWith('--port='));
   const mode = modeFlag ? modeFlag.split('=')[1] : 'headless';
   const port = portFlag ? parseInt(portFlag.split('=')[1], 10) : DEFAULT_PORT;
 

package/dist/skills/sweep-run/scripts/spec-compiler.mjs

@@ -24,7 +24,7 @@ function inferAction(description, index) {
   // Navigation
   if (/导航|打开|goto/i.test(desc)) {
     const urlMatch = desc.match(/`([^`]+)`/);
-    const url = urlMatch ? urlMatch[1] : 'process.env.BASE_URL || \'/\'';
+    const url = urlMatch ? urlMatch[1] : "process.env.BASE_URL || '/'";
     return {
       comment: desc,
       action: 'page.goto',
@@ -48,7 +48,9 @@ function inferAction(description, index) {
     const valueMatch = desc.match(/`([^`]+)`/);
     const value = valueMatch ? valueMatch[1] : '';
     const targetMatch = desc.match(/[""「」](.+?)[""」』]/);
-    const selector = targetMatch ? `[placeholder="${targetMatch[1]}" i]` : `input${index > 0 ? `:nth-child(${index})` : ''}`;
+    const selector = targetMatch
+      ? `[placeholder="${targetMatch[1]}" i]`
+      : `input${index > 0 ? `:nth-child(${index})` : ''}`;
     return {
       comment: desc,
       action: 'page.fill',
@@ -155,7 +157,9 @@ export function compile(parsed) {
   lines.push('');
 
   for (const flow of parsed.flows) {
-    lines.push(`${indent}test('${escapeStr(parsed.featureName)} - ${escapeStr(flow.id + ' - ' + flow.title)}', async ({ page }) => {`);
+    lines.push(
+      `${indent}test('${escapeStr(parsed.featureName)} - ${escapeStr(flow.id + ' - ' + flow.title)}', async ({ page }) => {`,
+    );
 
     // Preconditions as comments
     if (flow.preconditions) {
@@ -166,8 +170,8 @@ export function compile(parsed) {
     }
 
     // AI_REQUIRED marker — skip entire flow if any step needs AI
-    const hasAiRequired = flow.steps.some(s =>
-      s.description.includes('AI_REQUIRED') || s.description.includes('<!-- AI_REQUIRED -->')
+    const hasAiRequired = flow.steps.some(
+      (s) => s.description.includes('AI_REQUIRED') || s.description.includes('<!-- AI_REQUIRED -->'),
     );
     if (hasAiRequired) {
       lines.push(`${indent}${indent}// AI_REQUIRED — cannot execute natively, AI will handle`);
@@ -181,7 +185,7 @@ export function compile(parsed) {
 
       const action = inferAction(desc, step.order);
       if (action.action) {
-        const args = action.args.map(a => typeof a === 'string' ? `'${escapeStr(a)}'` : a).join(', ');
+        const args = action.args.map((a) => (typeof a === 'string' ? `'${escapeStr(a)}'` : a)).join(', ');
         lines.push(`${indent}${indent}await ${action.action}(${args});`);
       } else {
         // Cannot map to Playwright API — keep as TODO comment
@@ -196,11 +200,17 @@ export function compile(parsed) {
         if (va.assertion === 'toBeVisible') {
           lines.push(`${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toBeVisible();`);
         } else if (va.assertion === 'toHaveText') {
-          lines.push(`${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toHaveText('${escapeStr(va.args[1])}');`);
+          lines.push(
+            `${indent}${indent}await expect(page.locator('${escapeStr(va.args[0])}')).toHaveText('${escapeStr(va.args[1])}');`,
+          );
         } else if (va.assertion === 'toHaveTitle') {
-          lines.push(`${indent}${indent}await expect(page).toHaveTitle(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`);
+          lines.push(
+            `${indent}${indent}await expect(page).toHaveTitle(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`,
+          );
         } else if (va.assertion === 'toHaveURL') {
-          lines.push(`${indent}${indent}await expect(page).toHaveURL(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`);
+          lines.push(
+            `${indent}${indent}await expect(page).toHaveURL(${typeof va.args[0] === 'string' ? `'${escapeStr(va.args[0])}'` : va.args[0]});`,
+          );
         }
       }