csspilot 0.1.0 → 0.2.0

package/dist/bin.js

@@ -10374,10 +10374,84 @@ var {
   Help
 } = import_index.default;
 
-// src/commands/doctor.ts
-import { existsSync as existsSync2 } from "node:fs";
-import { createRequire } from "node:module";
-import { join as join5 } from "node:path";
+// src/commands/init/ci-initializer.ts
+import { access, mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+async function exists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function detectCi(root) {
+  const workflow = join(root, ".github", "workflows", "testpilot.yml");
+  return {
+    githubWorkflows: await exists(join(root, ".github", "workflows")),
+    gitlabCi: await exists(join(root, ".gitlab-ci.yml")),
+    hasTestpilotWorkflow: await exists(workflow)
+  };
+}
+var CI_TEMPLATE = `# csspilot ci init \u751F\u6210;Git Push -> TestPilot Server \u7684\u6B63\u5F0F\u540C\u6B65\u8FB9\u754C
+name: TestPilot
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  testpilot:
+    runs-on: ubuntu-latest
+    env:
+      TESTPILOT_SERVER_URL: \${{ secrets.TESTPILOT_SERVER_URL }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Validate cases
+        run: npx -y csspilot@latest validate
+
+      # sync-metadata \u662F Git Push -> Server \u7684\u6B63\u5F0F\u540C\u6B65\u8FB9\u754C;\u672A\u914D\u7F6E Server \u65F6\u8DF3\u8FC7
+      - name: Sync case metadata
+        if: \${{ env.TESTPILOT_SERVER_URL != '' }}
+        run: npx -y csspilot@latest sync-metadata
+
+      # \u9700\u8981\u5728 CI \u91CC\u8DD1\u7528\u4F8B\u65F6\u518D\u542F\u7528(Server \u89E6\u53D1\u6216\u672C\u5730\u89E6\u53D1\u5747\u53EF)
+      # - name: Run cases
+      #   run: npx -y csspilot@latest run
+`;
+async function initCi(root) {
+  const file2 = join(root, ".github", "workflows", "testpilot.yml");
+  if (await exists(file2)) {
+    return { created: false, file: file2 };
+  }
+  await mkdir(join(root, ".github", "workflows"), { recursive: true });
+  await writeFile(file2, CI_TEMPLATE, "utf8");
+  return { created: true, file: file2 };
+}
+
+// src/commands/ci.ts
+function makeCiCommand() {
+  const ci = new Command("ci").description("CI \u96C6\u6210(\u751F\u6210\u6A21\u677F,\u4E0D\u4FEE\u6539\u5DF2\u6709 CI)");
+  ci.command("init").description("\u751F\u6210 .github/workflows/testpilot.yml(validate + sync-metadata;\u5DF2\u6709\u5219\u8DF3\u8FC7)").action(async () => {
+    const result = await initCi(process.cwd());
+    if (result.created) {
+      console.log(`\u2713 CI \u5DE5\u4F5C\u6D41\u5DF2\u751F\u6210   ${result.file}`);
+      console.log("  Git Push \u540E\u81EA\u52A8\u6267\u884C csspilot validate \u4E0E sync-metadata(\u9700\u914D\u7F6E TESTPILOT_SERVER_URL Secret)");
+    } else {
+      console.log(`\u2713 CI \u5DE5\u4F5C\u6D41\u5DF2\u5B58\u5728   ${result.file}(\u8DF3\u8FC7)`);
+    }
+  });
+  return ci;
+}
+
+// src/commands/init/doctor.ts
+import { existsSync as existsSync6 } from "node:fs";
+import { join as join21 } from "node:path";
 
 // ../../packages/core/src/errors/index.ts
 var TestPilotError = class extends Error {
@@ -10390,7 +10464,7 @@ var TestPilotError = class extends Error {
 };
 
 // ../../packages/core/src/constants/index.ts
-import { join } from "node:path";
+import { join as join2 } from "node:path";
 var TESTPILOT_DIR = ".testpilot";
 var RUNS_DIR = `${TESTPILOT_DIR}/artifacts/runs`;
 var RESULT_FILE = "result.json";
@@ -10399,14 +10473,14 @@ var DEFAULT_STEP_TIMEOUT_MS = 15e3;
 var WECHAT_DEVTOOLS_CLI_PATHS = [
   "C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat",
   "C:/Program Files/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat",
-  join(process.env.LOCALAPPDATA ?? ".", "\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177", "cli.bat"),
+  join2(process.env.LOCALAPPDATA ?? ".", "\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177", "cli.bat"),
   "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"
 ];
 
 // ../../packages/core/src/config-loader.ts
 var import_yaml = __toESM(require_dist(), 1);
 import { readFile } from "node:fs/promises";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 
 // ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -15440,7 +15514,7 @@ var recursive = /* @__PURE__ */ new WeakMap();
 var NONE = 0;
 var ASSUMED = 1;
 var PROVEN = 2;
-function isRecursive(inst, stack, resolve3) {
+function isRecursive(inst, stack, resolve5) {
   const cached2 = recursive.get(inst);
   if (cached2 !== void 0)
     return cached2 ? PROVEN : NONE;
@@ -15450,7 +15524,7 @@ function isRecursive(inst, stack, resolve3) {
   let result = NONE;
   const check2 = (child) => {
     if (result !== PROVEN && child?._zod) {
-      const answer = isRecursive(child, stack, resolve3);
+      const answer = isRecursive(child, stack, resolve5);
       if (answer > result)
         result = answer;
     }
@@ -15461,7 +15535,7 @@ function isRecursive(inst, stack, resolve3) {
       const desc = Object.getOwnPropertyDescriptor(sh, key);
       if (spread && !desc.enumerable)
         continue;
-      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve3) : NONE;
+      const child = desc.get ? ASSUMED : desc.value?._zod ? isRecursive(desc.value, stack, resolve5) : NONE;
       if (child > answer)
         answer = child;
     }
@@ -15528,7 +15602,7 @@ function isRecursive(inst, stack, resolve3) {
       break;
     // `$ZodLazy` caches its inner on the def, so a resolved edge is followed exactly
     case "lazy": {
-      const inner = def._cachedInner ?? (resolve3 ? inst._zod.innerType : void 0);
+      const inner = def._cachedInner ?? (resolve5 ? inst._zod.innerType : void 0);
       merge2(inner ? isRecursive(inner, stack, false) : ASSUMED);
       break;
     }
@@ -30081,8 +30155,24 @@ function date4(params) {
 }
 
 // ../../packages/core/src/config-loader.ts
+var environmentEntrySchema = external_exports.strictObject({ baseUrl: external_exports.string().min(1).optional() }).optional();
 var configSchema = external_exports.strictObject({
+  /** 配置文件版本(csspilot init 生成为 1) */
+  version: external_exports.number().optional(),
+  /** 旧式用例目录字段;与 test.caseDirectory 等价,二选一 */
   casesDir: external_exports.string().min(1).optional(),
+  project: external_exports.strictObject({ name: external_exports.string().min(1).optional() }).optional(),
+  test: external_exports.strictObject({
+    directory: external_exports.string().min(1).optional(),
+    caseDirectory: external_exports.string().min(1).optional()
+  }).optional(),
+  /** 环境配置:default 指定默认环境名,其余键为环境名 -> { baseUrl } */
+  environment: external_exports.record(external_exports.string(), external_exports.union([external_exports.string().min(1), environmentEntrySchema])).optional(),
+  /** 项目声明的执行端(playwright / wechatide);仅作声明,实际可用性以 doctor 检测为准 */
+  adapters: external_exports.array(external_exports.string().min(1)).optional(),
+  workspace: external_exports.strictObject({ default: external_exports.string().min(1).optional() }).optional(),
+  /** TestPilot Control Plane 地址(sync-metadata / init 关联项目时使用) */
+  server: external_exports.strictObject({ baseUrl: external_exports.string().min(1).optional() }).optional(),
   web: external_exports.strictObject({ baseUrl: external_exports.string().min(1).optional() }).optional(),
   miniapp: external_exports.strictObject({
     projectPath: external_exports.string().min(1).optional(),
@@ -30090,7 +30180,7 @@ var configSchema = external_exports.strictObject({
   }).optional()
 });
 async function loadTestpilotConfig(cwd = process.cwd()) {
-  const file2 = join2(cwd, "testpilot.yaml");
+  const file2 = join3(cwd, "testpilot.yaml");
   let raw;
   try {
     raw = (0, import_yaml.parse)(await readFile(file2, "utf8"));
@@ -30106,7 +30196,15 @@ async function loadTestpilotConfig(cwd = process.cwd()) {
     throw new Error(`testpilot.yaml \u914D\u7F6E\u4E0D\u5408\u6CD5:${detail}`);
   }
   return {
-    casesDir: result.data.casesDir ?? DEFAULT_CASES_DIR,
+    version: result.data.version,
+    // 用例目录:旧字段 casesDir 优先,其次 test.caseDirectory,最后默认值
+    casesDir: result.data.casesDir ?? result.data.test?.caseDirectory ?? DEFAULT_CASES_DIR,
+    testDirectory: result.data.test?.directory,
+    projectName: result.data.project?.name,
+    environment: result.data.environment,
+    adapters: result.data.adapters,
+    workspace: result.data.workspace,
+    server: result.data.server,
     web: result.data.web,
     miniapp: result.data.miniapp
   };
@@ -30115,7 +30213,7 @@ async function loadTestpilotConfig(cwd = process.cwd()) {
 // ../../packages/core/src/wechat-devtools.ts
 import { execFile } from "node:child_process";
 import { existsSync, readdirSync } from "node:fs";
-import { join as join3 } from "node:path";
+import { join as join4 } from "node:path";
 var CLI_NAMES = ["cli.bat", "cli"];
 var REGISTRY_UNINSTALL_KEYS = [
   "HKLM\\SOFTWARE\\WOW6432Node\\Microsoft\\Windows\\CurrentVersion\\Uninstall",
@@ -30131,7 +30229,7 @@ async function findWechatDevToolsCli() {
   if (process.platform !== "win32") return void 0;
   for (const dir of candidateInstallDirs()) {
     for (const name of CLI_NAMES) {
-      const cli = join3(dir, name);
+      const cli = join4(dir, name);
       if (existsSync(cli)) return cli;
     }
   }
@@ -30144,19 +30242,19 @@ function candidateInstallDirs() {
     const drive = `${String.fromCharCode(code)}:\\`;
     if (!existsSync(drive)) continue;
     tencentParents.push(
-      join3(drive, "Program Files (x86)", "Tencent"),
-      join3(drive, "Program Files", "Tencent")
+      join4(drive, "Program Files (x86)", "Tencent"),
+      join4(drive, "Program Files", "Tencent")
     );
   }
   if (process.env.LOCALAPPDATA) {
-    tencentParents.push(join3(process.env.LOCALAPPDATA, "Programs"));
+    tencentParents.push(join4(process.env.LOCALAPPDATA, "Programs"));
   }
   for (const parent of tencentParents) {
     if (!existsSync(parent)) continue;
     try {
       for (const entry of readdirSync(parent)) {
         if (/微信web开发者工具|wechatwebdevtools/i.test(entry)) {
-          dirs.push(join3(parent, entry));
+          dirs.push(join4(parent, entry));
         }
       }
     } catch {
@@ -30179,7 +30277,7 @@ async function findFromRegistry() {
       const installDir = dirBefore(raw, /微信开发者工具\.exe|卸载微信开发者工具\.exe/i);
       if (!installDir) continue;
       for (const name of CLI_NAMES) {
-        const cli = join3(installDir, name);
+        const cli = join4(installDir, name);
         if (existsSync(cli)) return cli;
       }
     }
@@ -30202,185 +30300,12 @@ function execToString(command, args) {
   });
 }
 
-// src/lib/cases.ts
-import { readdir, stat } from "node:fs/promises";
-import { extname, join as join4 } from "node:path";
-var DEFAULT_CASES_DIR2 = "tests/e2e/cases";
-async function collectCaseFiles(paths) {
-  const files = [];
-  for (const input2 of paths) {
-    const info = await stat(input2).catch(() => void 0);
-    if (!info) continue;
-    if (info.isDirectory()) {
-      files.push(...await collectFromDir(input2));
-    } else if (isCaseFile(input2)) {
-      files.push(input2);
-    }
-  }
-  return [...new Set(files)].sort();
-}
-async function collectFromDir(dir) {
-  const entries = await readdir(dir, { withFileTypes: true });
-  const found = [];
-  for (const entry of entries) {
-    const full = join4(dir, entry.name);
-    if (entry.isDirectory()) {
-      found.push(...await collectFromDir(full));
-    } else if (isCaseFile(entry.name)) {
-      found.push(full);
-    }
-  }
-  return found;
-}
-function isCaseFile(file2) {
-  const ext = extname(file2).toLowerCase();
-  return ext === ".yaml" || ext === ".yml";
-}
-
-// src/commands/doctor.ts
-function makeDoctorCommand() {
-  return new Command("doctor").description("\u68C0\u67E5\u672C\u5730\u73AF\u5883(Node / Playwright / WeChat DevTools / \u9879\u76EE\u914D\u7F6E)").action(async () => {
-    let problems = 0;
-    const ok = (label) => console.log(`\u2713 ${label}`);
-    const fail = (label, hint) => {
-      problems++;
-      console.log(`\u2717 ${label}${hint ? `(${hint})` : ""}`);
-    };
-    console.log("TestPilot Doctor");
-    console.log("");
-    const nodeMajor = Number(process.versions.node.split(".")[0]);
-    if (nodeMajor >= 22) ok(`Node.js ${process.versions.node}`);
-    else fail(`Node.js ${process.versions.node}`, "\u9700\u8981 Node.js >= 22");
-    ok("TestPilot CLI (0.1.0)");
-    if (existsSync2("testpilot.yaml")) ok("testpilot.yaml");
-    else fail("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210");
-    const caseFiles = await collectCaseFiles([DEFAULT_CASES_DIR2]).catch(() => []);
-    if (caseFiles.length > 0) ok(`${DEFAULT_CASES_DIR2} (${caseFiles.length} \u4E2A\u7528\u4F8B)`);
-    else fail(DEFAULT_CASES_DIR2, "\u672A\u627E\u5230\u7528\u4F8B");
-    if (existsSync2(".ai/skills/testpilot/manifest.yaml")) ok("TestPilot Skill (.ai/skills/testpilot)");
-    else fail("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5");
-    console.log("");
-    console.log("Web");
-    const playwright = resolvePlaywright();
-    if (!playwright) {
-      fail("Playwright", "pnpm add -D playwright \u6216 @playwright/test");
-      fail("Chromium");
-    } else {
-      ok(`Playwright (${playwright.version})`);
-      if (chromiumInstalled(playwright.module)) ok("Chromium");
-      else fail("Chromium", "pnpm exec playwright install chromium");
-    }
-    console.log("");
-    console.log("Mini Program");
-    const devtools = await findWechatDevToolsCli();
-    if (devtools) ok(`WeChat Developer Tools (${devtools})`);
-    else fail("WeChat Developer Tools", "\u672A\u627E\u5230,\u53EF\u8BBE\u7F6E WECHAT_DEVTOOLS_CLI \u6307\u5411 cli \u53EF\u6267\u884C\u6587\u4EF6");
-    console.log("");
-    console.log(problems === 0 ? "Environment looks good." : `\u53D1\u73B0 ${problems} \u4E2A\u95EE\u9898,\u89C1\u4E0A\u8868\u3002`);
-  });
-}
-function resolvePlaywright() {
-  const require2 = createRequire(join5(process.cwd(), "package.json"));
-  for (const name of ["playwright", "@playwright/test"]) {
-    try {
-      const module = require2(name);
-      const version2 = require2(`${name}/package.json`).version;
-      return { module, version: version2 };
-    } catch {
-      continue;
-    }
-  }
-  return void 0;
-}
-function chromiumInstalled(module) {
-  try {
-    const path = module.chromium.executablePath();
-    return path !== "" && existsSync2(path);
-  } catch {
-    return false;
-  }
-}
-
-// src/commands/init.ts
-import { existsSync as existsSync3 } from "node:fs";
-import { access, cp, mkdir, writeFile } from "node:fs/promises";
-import { dirname, join as join6 } from "node:path";
-import { fileURLToPath } from "node:url";
-var TESTPILOT_YAML_TEMPLATE = `# TestPilot \u9879\u76EE\u914D\u7F6E
-# validate / list / run \u9ED8\u8BA4\u5728\u8FD9\u4E2A\u76EE\u5F55\u67E5\u627E *.yaml \u7528\u4F8B
-casesDir: tests/e2e/cases
-
-# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740
-# web:
-#   baseUrl: http://127.0.0.1:8080
-
-# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4
-# miniapp:
-#   projectPath: path/to/miniprogram
-#   cliPath: C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
-`;
-async function exists(path) {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function resolveSkillSourceDir() {
-  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
-  if (fromEnv) return fromEnv;
-  const bundled = fileURLToPath(new URL("./skills/testpilot", import.meta.url));
-  if (existsSync3(bundled)) return bundled;
-  const inRepo = fileURLToPath(new URL("../../../../skills/testpilot", import.meta.url));
-  return existsSync3(inRepo) ? inRepo : void 0;
-}
-function makeInitCommand() {
-  return new Command("init").description("\u628A TestPilot \u63A5\u5165\u5F53\u524D\u4E1A\u52A1\u9879\u76EE").action(async () => {
-    const cwd = process.cwd();
-    const skillDest = join6(cwd, ".ai", "skills", "testpilot");
-    if (await exists(join6(skillDest, "manifest.yaml"))) {
-      console.log("\u2713 Skill \u5B89\u88C5       .ai/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)");
-    } else {
-      const skillSrc = resolveSkillSourceDir();
-      if (!skillSrc) {
-        console.error("\u2717 \u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55");
-        console.error("  \u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84\u540E\u91CD\u8BD5");
-        process.exitCode = 1;
-        return;
-      }
-      await mkdir(dirname(skillDest), { recursive: true });
-      await cp(skillSrc, skillDest, { recursive: true });
-      console.log("\u2713 Skill \u5B89\u88C5       .ai/skills/testpilot/");
-    }
-    await mkdir(join6(cwd, ".testpilot", "artifacts"), { recursive: true });
-    const keep = join6(cwd, ".testpilot", "artifacts", ".gitkeep");
-    if (!await exists(keep)) {
-      await writeFile(keep, "", "utf8");
-    }
-    console.log("\u2713 Runtime \u76EE\u5F55     .testpilot/");
-    for (const dir of ["tests/e2e/cases", "tests/e2e/fixtures", "tests/e2e/data"]) {
-      await mkdir(join6(cwd, dir), { recursive: true });
-    }
-    console.log("\u2713 \u6D4B\u8BD5\u76EE\u5F55         tests/e2e/{cases,fixtures,data}");
-    const configPath = join6(cwd, "testpilot.yaml");
-    if (await exists(configPath)) {
-      console.log("\u2713 \u9879\u76EE\u914D\u7F6E         testpilot.yaml(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)");
-    } else {
-      await writeFile(configPath, TESTPILOT_YAML_TEMPLATE, "utf8");
-      console.log("\u2713 \u9879\u76EE\u914D\u7F6E         testpilot.yaml");
-    }
-    console.log("");
-    console.log("\u4E0B\u4E00\u6B65:");
-    console.log("  1. \u8BA9 AI \u9605\u8BFB .ai/skills/testpilot/SKILL.md");
-    console.log("  2. \u5728 tests/e2e/cases/ \u521B\u5EFA Case(\u9075\u5FAA SKILL.md \u4E0E rules/)");
-    console.log("  3. npx csspilot validate");
-    console.log("  4. npx csspilot run");
-  });
-}
+// ../../packages/sdk/src/client.ts
+import { isAbsolute as isAbsolute3, join as join17 } from "node:path";
 
-// src/commands/list.ts
-import { readFile as readFile2 } from "node:fs/promises";
+// ../../packages/sdk/src/cases.ts
+import { mkdir as mkdir3, readFile as readFile3, readdir, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname, extname, isAbsolute, join as join6, resolve as resolve2 } from "node:path";
 
 // ../../packages/dsl/src/schema/index.ts
 var STEP_TARGETS = ["web", "miniapp"];
@@ -30413,6 +30338,12 @@ var caseSchema = external_exports.strictObject({
   id: external_exports.string().regex(/^[a-z0-9][a-z0-9-]*$/, "id \u9700\u4E3A kebab-case(\u5C0F\u5199\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u8FDE\u5B57\u7B26)"),
   name: external_exports.string().min(1, "name \u4E0D\u80FD\u4E3A\u7A7A"),
   description: external_exports.string().optional(),
+  /** 引用 Test Workspace(多系统环境组合);Case 只表达测试意图,环境由 Workspace 提供 */
+  workspace: external_exports.string().min(1).optional(),
+  /** 引用项目环境(testpilot.yaml environment 段);Case 不写死地址 */
+  environment: external_exports.string().min(1).optional(),
+  /** 引用测试账号标识;凭据由 Environment + Server/CI Secret 管理,禁止写进 Case */
+  accountRef: external_exports.string().min(1).optional(),
   tags: external_exports.array(external_exports.string().min(1)).optional(),
   steps: external_exports.array(stepSchema).min(1, "Case \u81F3\u5C11\u5305\u542B\u4E00\u4E2A step")
 });
@@ -30578,61 +30509,142 @@ function checkVariableRefs(step, at, declared, issues) {
   }
 }
 
-// src/commands/list.ts
-function makeListCommand() {
-  return new Command("list").description("\u5217\u51FA\u6D4B\u8BD5\u7528\u4F8B").option("--tag <tag>", "\u6309\u6807\u7B7E\u8FC7\u6EE4").action(async (options) => {
-    const tag = options.tag;
-    const config2 = await loadTestpilotConfig().catch((err) => {
-      console.error(err.message);
-      process.exitCode = 1;
-      return void 0;
-    });
-    if (!config2) return;
-    const files = await collectCaseFiles([config2.casesDir]);
-    if (files.length === 0) {
-      console.error(`\u672A\u627E\u5230\u7528\u4F8B\u76EE\u5F55 ${config2.casesDir}`);
-      console.error("\u63D0\u793A:\u5148\u8FD0\u884C npx csspilot init \u63A5\u5165 TestPilot");
-      process.exitCode = 1;
-      return;
-    }
-    const cases = [];
-    const broken = [];
-    for (const file2 of files) {
-      const source = await readFile2(file2, "utf8");
-      const parsed = parseCase(source);
-      if (parsed.ok) {
-        cases.push({ id: parsed.data.id, file: file2, tags: parsed.data.tags ?? [] });
-      } else {
-        broken.push({ file: file2, message: parsed.issues[0]?.message ?? "\u89E3\u6790\u5931\u8D25" });
-      }
+// ../../packages/sdk/src/project.ts
+import { mkdir as mkdir2, readFile as readFile2, stat, writeFile as writeFile2 } from "node:fs/promises";
+import { join as join5, resolve } from "node:path";
+function resolveRoot(root) {
+  return resolve(root ?? process.cwd());
+}
+async function loadProjectConfig(root) {
+  return loadTestpilotConfig(resolveRoot(root));
+}
+async function inspectProject(root) {
+  const dir = resolveRoot(root);
+  const config2 = await loadTestpilotConfig(dir);
+  const casesDir = join5(dir, config2.casesDir);
+  const artifactsDir = join5(dir, TESTPILOT_DIR, "artifacts");
+  const [hasConfig, casesDirExists, skillInstalled] = await Promise.all([
+    exists2(join5(dir, "testpilot.yaml")),
+    exists2(casesDir),
+    exists2(join5(dir, ".agents", "skills", "testpilot"))
+  ]);
+  return {
+    root: dir,
+    hasConfig,
+    config: config2,
+    casesDir,
+    casesDirExists,
+    artifactsDir,
+    runsDir: join5(artifactsDir, "runs"),
+    skillInstalled,
+    targets: config2.miniapp ? ["web", "miniapp"] : ["web"]
+  };
+}
+async function exists2(path) {
+  return await stat(path).catch(() => void 0) !== void 0;
+}
+var PROJECT_LINK_FILE = join5(TESTPILOT_DIR, "project.json");
+async function readProjectLink(root) {
+  const file2 = join5(resolveRoot(root), PROJECT_LINK_FILE);
+  try {
+    const raw = JSON.parse(await readFile2(file2, "utf8"));
+    if (!raw.projectId) return void 0;
+    return raw;
+  } catch {
+    return void 0;
+  }
+}
+async function writeProjectLink(link, root) {
+  const file2 = join5(resolveRoot(root), PROJECT_LINK_FILE);
+  await mkdir2(join5(file2, ".."), { recursive: true });
+  await writeFile2(file2, `${JSON.stringify(link, null, 2)}
+`, "utf8");
+  return file2;
+}
+
+// ../../packages/sdk/src/cases.ts
+async function collectCaseFiles(paths) {
+  const files = [];
+  for (const input2 of paths) {
+    const info = await stat2(input2).catch(() => void 0);
+    if (!info) continue;
+    if (info.isDirectory()) {
+      files.push(...await collectFromDir(input2));
+    } else if (isCaseFile(input2)) {
+      files.push(input2);
     }
-    const visible = tag ? cases.filter((item) => item.tags.includes(tag)) : cases;
-    console.log("TestPilot Cases");
-    console.log("");
-    for (const item of visible) {
-      const tagLabel = item.tags.length > 0 ? `  [${item.tags.join(", ")}]` : "";
-      console.log(`\u2713 ${item.id}${tagLabel}`);
-      console.log(`  ${item.file}`);
-      console.log("");
+  }
+  return [...new Set(files)].sort();
+}
+async function collectFromDir(dir) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const found = [];
+  for (const entry of entries) {
+    const full = join6(dir, entry.name);
+    if (entry.isDirectory()) {
+      found.push(...await collectFromDir(full));
+    } else if (isCaseFile(entry.name)) {
+      found.push(full);
     }
-    for (const item of broken) {
-      console.log(`\u2717 ${item.file}`);
-      console.log(`  ${item.message}`);
-      console.log("");
+  }
+  return found;
+}
+function isCaseFile(file2) {
+  const ext = extname(file2).toLowerCase();
+  return ext === ".yaml" || ext === ".yml";
+}
+function resolveAgainstRoot(root, file2) {
+  return isAbsolute(file2) ? file2 : resolve2(resolveRoot(root), file2);
+}
+async function collectCases(paths, options = {}) {
+  const files = await collectCaseFiles(
+    paths.map((input2) => resolveAgainstRoot(options.root, input2))
+  );
+  const infos = [];
+  for (const file2 of files) {
+    const validation = await validateCaseFile(file2);
+    infos.push({
+      file: file2,
+      valid: validation.ok,
+      case: validation.data,
+      issues: validation.issues
+    });
+  }
+  return infos;
+}
+async function readCaseFile(file2, options = {}) {
+  const target = resolveAgainstRoot(options.root, file2);
+  const source = await readFile3(target, "utf8");
+  return { file: target, source, validation: validateCaseSource(source) };
+}
+async function validateCaseFile(file2) {
+  const source = await readFile3(file2, "utf8");
+  return validateCaseSource(source);
+}
+async function writeCaseFile(file2, source, options = {}) {
+  const target = resolveAgainstRoot(options.root, file2);
+  const validation = validateCaseSource(source);
+  if (!validation.ok) {
+    return { file: target, written: false, validation };
+  }
+  if (!options.overwrite) {
+    const existing = await stat2(target).catch(() => void 0);
+    if (existing) {
+      throw new Error(`\u7528\u4F8B\u6587\u4EF6\u5DF2\u5B58\u5728:${target}(\u8986\u76D6\u9700\u663E\u5F0F overwrite: true)`);
     }
-    const brokenNote = broken.length > 0 ? `,${broken.length} \u4E2A\u6587\u4EF6\u89E3\u6790\u5931\u8D25` : "";
-    console.log(`\u5171 ${visible.length} \u4E2A\u7528\u4F8B${tag ? `(tag: ${tag})` : ""}${brokenNote}`);
-  });
+  }
+  await mkdir3(dirname(target), { recursive: true });
+  await writeFile3(target, source, "utf8");
+  return { file: target, written: true, validation };
 }
 
-// src/commands/report.ts
-import { exec } from "node:child_process";
-import { readFile as readFile3, readdir as readdir2 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+// ../../packages/sdk/src/reports.ts
+import { readFile as readFile6 } from "node:fs/promises";
+import { join as join16 } from "node:path";
 
 // ../../packages/reporter/src/report.ts
-import { writeFile as writeFile2 } from "node:fs/promises";
-import { join as join7, resolve } from "node:path";
+import { writeFile as writeFile4 } from "node:fs/promises";
+import { join as join7, resolve as resolve3 } from "node:path";
 
 // ../../packages/reporter/src/summary.ts
 function toSummaryView(summary) {
@@ -30652,12 +30664,12 @@ function toSummaryView(summary) {
 
 // ../../packages/reporter/src/report.ts
 async function writeReports(runDir, summary) {
-  const dir = resolve(runDir);
+  const dir = resolve3(runDir);
   const jsonPath = join7(dir, "report.json");
   const htmlPath = join7(dir, "report.html");
   const payload = { generatedAt: (/* @__PURE__ */ new Date()).toISOString(), summary };
-  await writeFile2(jsonPath, JSON.stringify(payload, null, 2), "utf8");
-  await writeFile2(htmlPath, renderHtml(summary), "utf8");
+  await writeFile4(jsonPath, JSON.stringify(payload, null, 2), "utf8");
+  await writeFile4(htmlPath, renderHtml(summary), "utf8");
   return { json: jsonPath, html: htmlPath };
 }
 function renderHtml(summary) {
@@ -30726,91 +30738,549 @@ function escapeHtml(input2) {
   return input2.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
 }
 
-// src/commands/report.ts
-function makeReportCommand() {
-  return new Command("report").description("\u751F\u6210\u6D4B\u8BD5\u62A5\u544A(JSON + HTML)").option("--run <id>", "\u8FD0\u884C\u8BB0\u5F55 ID,\u9ED8\u8BA4\u6700\u8FD1\u4E00\u6B21").option("--open", "\u751F\u6210\u540E\u5728\u6D4F\u89C8\u5668\u6253\u5F00", false).action(async (options) => {
-    const runId = options.run ?? await latestRunId();
-    if (!runId) {
-      console.error(`\u672A\u627E\u5230\u8FD0\u884C\u8BB0\u5F55(${RUNS_DIR} \u4E3A\u7A7A,\u5148\u8FD0\u884C npx csspilot run)`);
-      process.exitCode = 1;
-      return;
-    }
-    const runDir = join8(RUNS_DIR, runId);
-    let summary;
-    try {
-      summary = JSON.parse(await readFile3(join8(runDir, RESULT_FILE), "utf8"));
-    } catch {
-      console.error(`\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${join8(runDir, RESULT_FILE)}`);
-      process.exitCode = 1;
-      return;
-    }
-    const written = await writeReports(runDir, summary);
-    console.log(`\u2713 report.json  ${written.json}`);
-    console.log(`\u2713 report.html  ${written.html}`);
-    if (options.open) await openInBrowser(written.html);
-  });
-}
-async function latestRunId() {
-  const entries = await readdir2(RUNS_DIR).catch(() => []);
-  return entries.sort().at(-1);
-}
-function openInBrowser(file2) {
-  const command = process.platform === "win32" ? `start "" "${file2}"` : process.platform === "darwin" ? `open "${file2}"` : `xdg-open "${file2}"`;
-  return new Promise((resolvePromise) => {
-    exec(command, () => resolvePromise());
-  });
-}
+// ../../packages/sdk/src/runs.ts
+import { readFile as readFile5, readdir as readdir3 } from "node:fs/promises";
+import { isAbsolute as isAbsolute2, join as join15 } from "node:path";
 
-// src/commands/run.ts
-import { readFile as readFile5 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+// ../../packages/execution-engine/src/artifacts/index.ts
+import { mkdir as mkdir8 } from "node:fs/promises";
+import { join as join11 } from "node:path";
 
-// ../../packages/adapter-playwright/src/browser.ts
-import { chromium } from "playwright";
-function resolveHeadless(options) {
-  if (options.headless !== void 0) return options.headless;
-  return process.env.TESTPILOT_HEADLESS !== "false";
-}
-function stepTimeout(options) {
-  const fromEnv = Number(process.env.TESTPILOT_STEP_TIMEOUT);
-  if (options.timeout !== void 0) return options.timeout;
-  return Number.isFinite(fromEnv) && fromEnv > 0 ? fromEnv : DEFAULT_STEP_TIMEOUT_MS;
-}
-async function launchBrowser(options = {}) {
-  const browser = await chromium.launch({ headless: resolveHeadless(options) });
-  return { browser };
-}
-async function openCaseContext(bundle, options, evidenceTmpDir) {
-  const context = await bundle.browser.newContext({
-    ...evidenceTmpDir ? { recordVideo: { dir: evidenceTmpDir } } : {}
-  });
-  context.setDefaultTimeout(stepTimeout(options));
-  if (evidenceTmpDir) {
-    await context.tracing.start({ screenshots: true, snapshots: true });
+// ../../packages/evidence/src/log.ts
+import { appendFile, mkdir as mkdir4 } from "node:fs/promises";
+import { dirname as dirname2 } from "node:path";
+var RunLogger = class {
+  constructor(filePath) {
+    this.filePath = filePath;
   }
-  const page = await context.newPage();
-  return { context, page };
-}
-
-// ../../packages/adapter-playwright/src/page.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { mkdtemp, readFile as readFile4, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join as join9 } from "node:path";
-var PlaywrightAdapter = class {
-  constructor(bundle, options = {}) {
-    this.bundle = bundle;
-    this.options = options;
+  info(message) {
+    return this.write("INFO", message);
   }
-  target = "web";
-  current;
+  warn(message) {
+    return this.write("WARN", message);
+  }
+  error(message) {
+    return this.write("ERROR", message);
+  }
+  async write(level, message) {
+    await mkdir4(dirname2(this.filePath), { recursive: true });
+    const line = `${(/* @__PURE__ */ new Date()).toISOString()} ${level} ${message}
+`;
+    await appendFile(this.filePath, line, "utf8");
+  }
+};
+
+// ../../packages/evidence/src/screenshot.ts
+import { mkdir as mkdir5, writeFile as writeFile5 } from "node:fs/promises";
+import { dirname as dirname3, join as join8 } from "node:path";
+async function saveScreenshot(dir, fileName, data) {
+  const file2 = join8(dir, fileName);
+  await mkdir5(dirname3(file2), { recursive: true });
+  await writeFile5(file2, data);
+  return file2;
+}
+
+// ../../packages/evidence/src/trace.ts
+import { mkdir as mkdir6, writeFile as writeFile6 } from "node:fs/promises";
+import { dirname as dirname4, join as join9 } from "node:path";
+async function saveTrace(dir, fileName, data) {
+  const file2 = join9(dir, fileName);
+  await mkdir6(dirname4(file2), { recursive: true });
+  await writeFile6(file2, data);
+  return file2;
+}
+
+// ../../packages/evidence/src/video.ts
+import { mkdir as mkdir7, writeFile as writeFile7 } from "node:fs/promises";
+import { dirname as dirname5, join as join10 } from "node:path";
+async function saveVideo(dir, fileName, data) {
+  const file2 = join10(dir, fileName);
+  await mkdir7(dirname5(file2), { recursive: true });
+  await writeFile7(file2, data);
+  return file2;
+}
+
+// ../../packages/execution-engine/src/artifacts/index.ts
+var ArtifactManager = class {
+  constructor(runDir) {
+    this.runDir = runDir;
+    this.screenshotsDir = join11(runDir, "screenshots");
+    this.videosDir = join11(runDir, "videos");
+    this.tracesDir = join11(runDir, "traces");
+    this.logsDir = join11(runDir, "logs");
+    this.logger = new RunLogger(join11(this.logsDir, "run.log"));
+  }
+  screenshotsDir;
+  videosDir;
+  tracesDir;
+  logsDir;
+  logger;
+  async prepare() {
+    await mkdir8(this.screenshotsDir, { recursive: true });
+    await mkdir8(this.logsDir, { recursive: true });
+  }
+  /** 保存步骤截图,返回相对 run 目录的路径(screenshots/xxx.png,统一正斜杠供报告链接使用) */
+  async saveStepScreenshot(fileName, data) {
+    await saveScreenshot(this.screenshotsDir, fileName, data);
+    return `screenshots/${fileName}`;
+  }
+  /** 保存用例录屏,返回相对 run 目录的路径(videos/xxx.webm) */
+  async saveVideo(fileName, data) {
+    await saveVideo(this.videosDir, fileName, data);
+    return `videos/${fileName}`;
+  }
+  /** 保存用例 trace 包,返回相对 run 目录的路径(traces/xxx.zip) */
+  async saveTrace(fileName, data) {
+    await saveTrace(this.tracesDir, fileName, data);
+    return `traces/${fileName}`;
+  }
+};
+
+// ../../packages/execution-engine/src/context/index.ts
+var ExecutionContext = class {
+  variables = /* @__PURE__ */ new Map();
+  set(name, value) {
+    this.variables.set(name, value);
+  }
+  get(name) {
+    return this.variables.get(name);
+  }
+  /** 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用保持原样(校验阶段已拦截) */
+  resolve(template) {
+    return template.replace(
+      /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,
+      (match, name) => this.variables.get(name) ?? match
+    );
+  }
+};
+
+// ../../packages/execution-engine/src/lifecycle/index.ts
+import { mkdir as mkdir9, readdir as readdir2 } from "node:fs/promises";
+import { join as join12 } from "node:path";
+function dateStamp(date5 = /* @__PURE__ */ new Date()) {
+  const year = date5.getFullYear();
+  const month = String(date5.getMonth() + 1).padStart(2, "0");
+  const day = String(date5.getDate()).padStart(2, "0");
+  return `${year}${month}${day}`;
+}
+async function allocateRunId(runsRoot2) {
+  const stamp = dateStamp();
+  const existing = await readdir2(runsRoot2).catch(() => []);
+  let max = 0;
+  for (const name of existing) {
+    const match = /^(\d{8})-(\d{3})$/.exec(name);
+    if (match && match[1] === stamp) {
+      max = Math.max(max, Number(match[2]));
+    }
+  }
+  return `${stamp}-${String(max + 1).padStart(3, "0")}`;
+}
+async function ensureRunDir(runsRoot2, runId) {
+  const runDir = join12(runsRoot2, runId);
+  await mkdir9(runDir, { recursive: true });
+  return runDir;
+}
+
+// ../../packages/execution-engine/src/events/index.ts
+import { appendFile as appendFile2, mkdir as mkdir10 } from "node:fs/promises";
+import { dirname as dirname6 } from "node:path";
+var EventBus = class {
+  subscribers = [];
+  subscribe(subscriber) {
+    this.subscribers.push(subscriber);
+  }
+  async emit(event) {
+    for (const subscriber of this.subscribers) {
+      await subscriber(event);
+    }
+  }
+};
+function ndjsonSubscriber(filePath) {
+  return async (event) => {
+    await mkdir10(dirname6(filePath), { recursive: true });
+    await appendFile2(filePath, `${JSON.stringify(event)}
+`, "utf8");
+  };
+}
+
+// ../../packages/adapter-core/src/session.ts
+var AdapterSession = class {
+  constructor(target, factory) {
+    this.target = target;
+    this.factory = factory;
+  }
+  adapter;
+  get opened() {
+    return this.adapter !== void 0;
+  }
+  /** 惰性创建;已创建则复用 */
+  async get() {
+    if (!this.adapter) {
+      this.adapter = await this.factory.create();
+      await this.adapter.launch();
+    }
+    return this.adapter;
+  }
+  async close() {
+    if (this.adapter) {
+      await this.adapter.close().catch(() => void 0);
+      this.adapter = void 0;
+    }
+  }
+};
+
+// ../../packages/execution-engine/src/engine/adapter-resolver.ts
+var AdapterResolver = class {
+  factories = /* @__PURE__ */ new Map();
+  sessions = /* @__PURE__ */ new Map();
+  register(factory) {
+    this.factories.set(factory.target, factory);
+  }
+  /** 取得(或创建)target 的会话 */
+  async session(target) {
+    let session = this.sessions.get(target);
+    if (!session) {
+      const factory = this.factories.get(target);
+      if (!factory) {
+        throw new TestPilotError("ADAPTER_NOT_FOUND", `\u672A\u6CE8\u518C target "${target}" \u7684 adapter,\u8BE5\u7AEF\u6B65\u9AA4\u65E0\u6CD5\u6267\u884C`);
+      }
+      session = new AdapterSession(target, factory);
+      this.sessions.set(target, session);
+    }
+    return session;
+  }
+  async closeAll() {
+    for (const session of this.sessions.values()) {
+      await session.close();
+    }
+    this.sessions.clear();
+  }
+};
+
+// ../../packages/execution-engine/src/engine/step-executor.ts
+async function executeStep(step, index, adapter, context, artifacts, options) {
+  const startedAt = Date.now();
+  const result = {
+    index,
+    target: step.target,
+    action: step.action,
+    status: "passed",
+    durationMs: 0
+  };
+  try {
+    const locator = step.locator ? {
+      text: step.locator.text !== void 0 ? context.resolve(step.locator.text) : void 0,
+      css: step.locator.css !== void 0 ? context.resolve(step.locator.css) : void 0
+    } : void 0;
+    switch (step.action) {
+      case "launch":
+        await adapter.launch();
+        break;
+      case "navigate":
+        await adapter.navigate(context.resolve(step.url ?? ""));
+        break;
+      case "click":
+        await adapter.click(locator);
+        break;
+      case "input":
+        await adapter.input(locator, context.resolve(step.value ?? ""));
+        break;
+      case "select":
+        await adapter.select(locator, context.resolve(step.value ?? ""));
+        break;
+      case "wait":
+        await adapter.wait(locator, step.timeout);
+        break;
+      case "assert":
+        await adapter.assert(locator, context.resolve(step.expected ?? ""));
+        break;
+      case "extract": {
+        const value = await adapter.extract(locator);
+        if (step.variable) {
+          context.set(step.variable, value);
+          result.extracted = { [step.variable]: value };
+        }
+        break;
+      }
+      case "screenshot": {
+        const data = await adapter.screenshot();
+        result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}.png`, data);
+        break;
+      }
+      default: {
+        const exhaustive = step.action;
+        throw new Error(`\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
+      }
+    }
+  } catch (err) {
+    result.status = "failed";
+    result.error = err instanceof Error ? err.message : String(err);
+    try {
+      const data = await adapter.screenshot();
+      result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}-failed.png`, data);
+    } catch {
+    }
+  }
+  result.durationMs = Date.now() - startedAt;
+  return result;
+}
+
+// ../../packages/execution-engine/src/engine/execution-engine.ts
+var ExecutionEngine = class {
+  async runCase(data, options) {
+    const { runId, file: file2, artifacts, bus, resolver } = options;
+    const startedAt = /* @__PURE__ */ new Date();
+    const context = new ExecutionContext();
+    const steps = [];
+    const evidenceAdapters = /* @__PURE__ */ new Map();
+    let caseError;
+    await bus.emit({ type: "case-started", runId, caseId: data.id, file: file2, ts: startedAt.toISOString() });
+    await artifacts.logger.info(`case ${data.id} started (${file2})`);
+    for (const [index, step] of data.steps.entries()) {
+      await bus.emit({
+        type: "step-started",
+        runId,
+        caseId: data.id,
+        index,
+        target: step.target,
+        action: step.action,
+        ts: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      let result;
+      try {
+        const adapter = await (await resolver.session(step.target)).get();
+        if (adapter.startEvidence && !evidenceAdapters.has(step.target)) {
+          try {
+            await adapter.startEvidence(data.id);
+            evidenceAdapters.set(step.target, adapter);
+          } catch (err) {
+            await artifacts.logger.info(
+              `evidence start failed for ${step.target}: ${err instanceof Error ? err.message : String(err)}`
+            );
+          }
+        }
+        result = await executeStep(step, index, adapter, context, artifacts, {
+          screenshotName: `${data.id}-step-${String(index).padStart(2, "0")}`
+        });
+      } catch (err) {
+        result = {
+          index,
+          target: step.target,
+          action: step.action,
+          status: "failed",
+          durationMs: 0,
+          error: err instanceof Error ? err.message : String(err)
+        };
+      }
+      steps.push(result);
+      await artifacts.logger.info(`step ${index} ${step.action} -> ${result.status}${result.error ? ` - ${result.error}` : ""}`);
+      await bus.emit({
+        type: "step-finished",
+        runId,
+        caseId: data.id,
+        index,
+        target: step.target,
+        action: step.action,
+        status: result.status,
+        durationMs: result.durationMs,
+        error: result.error,
+        ts: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      if (result.status === "failed") {
+        caseError = result.error;
+        for (const [skipIndex, skippedStep] of data.steps.entries()) {
+          if (skipIndex <= index) continue;
+          steps.push({
+            index: skipIndex,
+            target: skippedStep.target,
+            action: skippedStep.action,
+            status: "skipped",
+            durationMs: 0
+          });
+        }
+        break;
+      }
+    }
+    const finishedAt = /* @__PURE__ */ new Date();
+    const status = caseError ? "failed" : "passed";
+    const caseResult = {
+      caseId: data.id,
+      caseName: data.name,
+      file: file2,
+      status,
+      steps,
+      startedAt: startedAt.toISOString(),
+      finishedAt: finishedAt.toISOString(),
+      durationMs: finishedAt.getTime() - startedAt.getTime()
+    };
+    if (caseError) caseResult.error = caseError;
+    for (const [target, adapter] of evidenceAdapters) {
+      if (!adapter.stopEvidence) continue;
+      try {
+        const evidence = await adapter.stopEvidence(data.id);
+        if (evidence.video) {
+          caseResult.video = await artifacts.saveVideo(`${data.id}-${target}.webm`, evidence.video);
+        }
+        if (evidence.trace) {
+          caseResult.trace = await artifacts.saveTrace(`${data.id}-${target}.zip`, evidence.trace);
+        }
+      } catch (err) {
+        await artifacts.logger.info(
+          `evidence stop failed for ${target}: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+    }
+    await bus.emit({
+      type: "case-finished",
+      runId,
+      caseId: data.id,
+      status,
+      durationMs: finishedAt.getTime() - startedAt.getTime(),
+      ts: finishedAt.toISOString()
+    });
+    await artifacts.logger.info(`case ${data.id} ${status}`);
+    return caseResult;
+  }
+};
+
+// ../../packages/execution-engine/src/engine/result-collector.ts
+function buildRunSummary(runId, startedAt, cases, options = {}) {
+  const finishedAt = /* @__PURE__ */ new Date();
+  const totals = {
+    cases: cases.length,
+    passed: cases.filter((item) => item.status === "passed").length,
+    failed: cases.filter((item) => item.status === "failed").length,
+    steps: 0,
+    stepsPassed: 0,
+    stepsFailed: 0,
+    stepsSkipped: 0
+  };
+  for (const item of cases) {
+    for (const step of item.steps) {
+      totals.steps++;
+      if (step.status === "passed") totals.stepsPassed++;
+      else if (step.status === "failed") totals.stepsFailed++;
+      else totals.stepsSkipped++;
+    }
+  }
+  return {
+    runId,
+    startedAt: startedAt.toISOString(),
+    finishedAt: finishedAt.toISOString(),
+    durationMs: finishedAt.getTime() - startedAt.getTime(),
+    status: totals.failed > 0 ? "failed" : "passed",
+    ...options.cancelled ? { cancelled: true } : {},
+    cases,
+    totals
+  };
+}
+
+// ../../packages/execution-engine/src/engine/test-runner.ts
+import { writeFile as writeFile8 } from "node:fs/promises";
+import { join as join13, resolve as resolve4 } from "node:path";
+var TestRunner = class {
+  resolver;
+  runsRoot;
+  customRunId;
+  extraSubscriber;
+  signal;
+  constructor(options) {
+    this.resolver = options.resolver;
+    this.runsRoot = resolve4(options.runsRoot ?? join13(process.cwd(), ".testpilot", "artifacts", "runs"));
+    this.customRunId = options.runId;
+    this.extraSubscriber = options.onEvent;
+    this.signal = options.signal;
+  }
+  async run(cases) {
+    const startedAt = /* @__PURE__ */ new Date();
+    const runId = this.customRunId ?? await allocateRunId(this.runsRoot);
+    const runDir = await ensureRunDir(this.runsRoot, runId);
+    const artifacts = new ArtifactManager(runDir);
+    await artifacts.prepare();
+    const bus = new EventBus();
+    bus.subscribe(ndjsonSubscriber(join13(runDir, "events.ndjson")));
+    if (this.extraSubscriber) bus.subscribe(this.extraSubscriber);
+    await bus.emit({ type: "run-started", runId, totalCases: cases.length, ts: startedAt.toISOString() });
+    await artifacts.logger.info(`run ${runId} started with ${cases.length} case(s)`);
+    const engine = new ExecutionEngine();
+    const results = [];
+    for (const item of cases) {
+      if (this.signal?.aborted) {
+        await artifacts.logger.info(`run ${runId} cancelled before case ${item.data.id}`);
+        break;
+      }
+      results.push(
+        await engine.runCase(item.data, {
+          runId,
+          file: item.file,
+          artifacts,
+          bus,
+          resolver: this.resolver
+        })
+      );
+    }
+    const cancelled = this.signal?.aborted === true;
+    await this.resolver.closeAll();
+    const summary = buildRunSummary(runId, startedAt, results, { cancelled });
+    await bus.emit({
+      type: "run-finished",
+      runId,
+      status: summary.status,
+      totals: { cases: summary.totals.cases, passed: summary.totals.passed, failed: summary.totals.failed },
+      ts: (/* @__PURE__ */ new Date()).toISOString()
+    });
+    await artifacts.logger.info(`run ${runId} finished: ${summary.status}`);
+    await writeFile8(join13(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
+    return summary;
+  }
+};
+
+// ../../packages/adapter-playwright/src/browser.ts
+import { chromium } from "playwright";
+function resolveHeadless(options) {
+  if (options.headless !== void 0) return options.headless;
+  return process.env.TESTPILOT_HEADLESS !== "false";
+}
+function stepTimeout(options) {
+  const fromEnv = Number(process.env.TESTPILOT_STEP_TIMEOUT);
+  if (options.timeout !== void 0) return options.timeout;
+  return Number.isFinite(fromEnv) && fromEnv > 0 ? fromEnv : DEFAULT_STEP_TIMEOUT_MS;
+}
+async function launchBrowser(options = {}) {
+  const browser = await chromium.launch({ headless: resolveHeadless(options) });
+  return { browser };
+}
+async function openCaseContext(bundle, options, evidenceTmpDir) {
+  const context = await bundle.browser.newContext({
+    ...evidenceTmpDir ? { recordVideo: { dir: evidenceTmpDir } } : {}
+  });
+  context.setDefaultTimeout(stepTimeout(options));
+  if (evidenceTmpDir) {
+    await context.tracing.start({ screenshots: true, snapshots: true });
+  }
+  const page = await context.newPage();
+  return { context, page };
+}
+
+// ../../packages/adapter-playwright/src/page.ts
+import { existsSync as existsSync2 } from "node:fs";
+import { mkdtemp, readFile as readFile4, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join as join14 } from "node:path";
+var PlaywrightAdapter = class {
+  constructor(bundle, options = {}) {
+    this.bundle = bundle;
+    this.options = options;
+  }
+  target = "web";
+  current;
   /** 浏览器在 create() 时已启动;context/page 按用例惰性创建,launch 保持幂等 */
   async launch() {
   }
   /** 开始用例级取证:为本用例创建独立 context(录屏 + trace) */
   async startEvidence(_caseId) {
     await this.closeContextQuietly();
-    const evidenceTmpDir = await mkdtemp(join9(tmpdir(), "testpilot-pw-"));
+    const evidenceTmpDir = await mkdtemp(join14(tmpdir(), "testpilot-pw-"));
     this.current = {
       ...await openCaseContext(this.bundle, this.options, evidenceTmpDir),
       evidenceTmpDir
@@ -30821,12 +31291,12 @@ var PlaywrightAdapter = class {
     if (!this.current) return {};
     const { context, page, evidenceTmpDir } = this.current;
     this.current = void 0;
-    const traceZipPath = join9(evidenceTmpDir ?? tmpdir(), "trace.zip");
+    const traceZipPath = join14(evidenceTmpDir ?? tmpdir(), "trace.zip");
     await context.tracing.stop({ path: traceZipPath }).catch(() => void 0);
     const recordedVideoPath = await page.video()?.path().catch(() => void 0);
     await context.close().catch(() => void 0);
-    const video = recordedVideoPath && existsSync4(recordedVideoPath) ? await readFile4(recordedVideoPath) : void 0;
-    const trace = evidenceTmpDir && existsSync4(traceZipPath) ? await readFile4(traceZipPath) : void 0;
+    const video = recordedVideoPath && existsSync2(recordedVideoPath) ? await readFile4(recordedVideoPath) : void 0;
+    const trace = evidenceTmpDir && existsSync2(traceZipPath) ? await readFile4(traceZipPath) : void 0;
     if (evidenceTmpDir) await rm(evidenceTmpDir, { recursive: true, force: true }).catch(() => void 0);
     return { video, trace };
   }
@@ -30930,7 +31400,7 @@ var automatorLauncher = {
   }
 };
 function delay(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 async function connectWithRetry(wsEndpoint, timeoutMs) {
   const startedAt = Date.now();
@@ -31111,11 +31581,11 @@ var MiniAppAdapter = class {
 };
 
 // ../../packages/adapter-wechatide/src/project.ts
-import { existsSync as existsSync5 } from "node:fs";
+import { existsSync as existsSync3 } from "node:fs";
 async function resolveMiniappConfig(input2) {
   const projectPath = input2.projectPath ?? process.env.TESTPILOT_MINIPROGRAM_PROJECT_PATH;
   if (!projectPath) return void 0;
-  if (!existsSync5(projectPath)) {
+  if (!existsSync3(projectPath)) {
     throw new Error(`\u5C0F\u7A0B\u5E8F\u9879\u76EE\u8DEF\u5F84\u4E0D\u5B58\u5728:${projectPath}`);
   }
   const cliPath = input2.cliPath ?? process.env.WECHAT_DEVTOOLS_CLI ?? await findWechatDevToolsCli();
@@ -31139,564 +31609,860 @@ function wechatideAdapterFactory(input2 = {}) {
       }
       return new MiniAppAdapter(config2);
     }
-  };
-}
-
-// ../../packages/execution-engine/src/artifacts/index.ts
-import { mkdir as mkdir6 } from "node:fs/promises";
-import { join as join13 } from "node:path";
-
-// ../../packages/evidence/src/log.ts
-import { appendFile, mkdir as mkdir2 } from "node:fs/promises";
-import { dirname as dirname2 } from "node:path";
-var RunLogger = class {
-  constructor(filePath) {
-    this.filePath = filePath;
-  }
-  info(message) {
-    return this.write("INFO", message);
-  }
-  warn(message) {
-    return this.write("WARN", message);
-  }
-  error(message) {
-    return this.write("ERROR", message);
-  }
-  async write(level, message) {
-    await mkdir2(dirname2(this.filePath), { recursive: true });
-    const line = `${(/* @__PURE__ */ new Date()).toISOString()} ${level} ${message}
-`;
-    await appendFile(this.filePath, line, "utf8");
-  }
-};
-
-// ../../packages/evidence/src/screenshot.ts
-import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname3, join as join10 } from "node:path";
-async function saveScreenshot(dir, fileName, data) {
-  const file2 = join10(dir, fileName);
-  await mkdir3(dirname3(file2), { recursive: true });
-  await writeFile3(file2, data);
-  return file2;
-}
-
-// ../../packages/evidence/src/trace.ts
-import { mkdir as mkdir4, writeFile as writeFile4 } from "node:fs/promises";
-import { dirname as dirname4, join as join11 } from "node:path";
-async function saveTrace(dir, fileName, data) {
-  const file2 = join11(dir, fileName);
-  await mkdir4(dirname4(file2), { recursive: true });
-  await writeFile4(file2, data);
-  return file2;
-}
-
-// ../../packages/evidence/src/video.ts
-import { mkdir as mkdir5, writeFile as writeFile5 } from "node:fs/promises";
-import { dirname as dirname5, join as join12 } from "node:path";
-async function saveVideo(dir, fileName, data) {
-  const file2 = join12(dir, fileName);
-  await mkdir5(dirname5(file2), { recursive: true });
-  await writeFile5(file2, data);
-  return file2;
-}
-
-// ../../packages/execution-engine/src/artifacts/index.ts
-var ArtifactManager = class {
-  constructor(runDir) {
-    this.runDir = runDir;
-    this.screenshotsDir = join13(runDir, "screenshots");
-    this.videosDir = join13(runDir, "videos");
-    this.tracesDir = join13(runDir, "traces");
-    this.logsDir = join13(runDir, "logs");
-    this.logger = new RunLogger(join13(this.logsDir, "run.log"));
-  }
-  screenshotsDir;
-  videosDir;
-  tracesDir;
-  logsDir;
-  logger;
-  async prepare() {
-    await mkdir6(this.screenshotsDir, { recursive: true });
-    await mkdir6(this.logsDir, { recursive: true });
-  }
-  /** 保存步骤截图,返回相对 run 目录的路径(screenshots/xxx.png,统一正斜杠供报告链接使用) */
-  async saveStepScreenshot(fileName, data) {
-    await saveScreenshot(this.screenshotsDir, fileName, data);
-    return `screenshots/${fileName}`;
-  }
-  /** 保存用例录屏,返回相对 run 目录的路径(videos/xxx.webm) */
-  async saveVideo(fileName, data) {
-    await saveVideo(this.videosDir, fileName, data);
-    return `videos/${fileName}`;
-  }
-  /** 保存用例 trace 包,返回相对 run 目录的路径(traces/xxx.zip) */
-  async saveTrace(fileName, data) {
-    await saveTrace(this.tracesDir, fileName, data);
-    return `traces/${fileName}`;
-  }
-};
-
-// ../../packages/execution-engine/src/context/index.ts
-var ExecutionContext = class {
-  variables = /* @__PURE__ */ new Map();
-  set(name, value) {
-    this.variables.set(name, value);
-  }
-  get(name) {
-    return this.variables.get(name);
-  }
-  /** 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用保持原样(校验阶段已拦截) */
-  resolve(template) {
-    return template.replace(
-      /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g,
-      (match, name) => this.variables.get(name) ?? match
-    );
-  }
-};
-
-// ../../packages/execution-engine/src/lifecycle/index.ts
-import { mkdir as mkdir7, readdir as readdir3 } from "node:fs/promises";
-import { join as join14 } from "node:path";
-function dateStamp(date5 = /* @__PURE__ */ new Date()) {
-  const year = date5.getFullYear();
-  const month = String(date5.getMonth() + 1).padStart(2, "0");
-  const day = String(date5.getDate()).padStart(2, "0");
-  return `${year}${month}${day}`;
-}
-async function allocateRunId(runsRoot) {
-  const stamp = dateStamp();
-  const existing = await readdir3(runsRoot).catch(() => []);
-  let max = 0;
-  for (const name of existing) {
-    const match = /^(\d{8})-(\d{3})$/.exec(name);
-    if (match && match[1] === stamp) {
-      max = Math.max(max, Number(match[2]));
-    }
-  }
-  return `${stamp}-${String(max + 1).padStart(3, "0")}`;
-}
-async function ensureRunDir(runsRoot, runId) {
-  const runDir = join14(runsRoot, runId);
-  await mkdir7(runDir, { recursive: true });
-  return runDir;
+  };
 }
 
-// ../../packages/execution-engine/src/events/index.ts
-import { appendFile as appendFile2, mkdir as mkdir8 } from "node:fs/promises";
-import { dirname as dirname6 } from "node:path";
-var EventBus = class {
-  subscribers = [];
-  subscribe(subscriber) {
-    this.subscribers.push(subscriber);
-  }
-  async emit(event) {
-    for (const subscriber of this.subscribers) {
-      await subscriber(event);
-    }
+// ../../packages/sdk/src/runs.ts
+var RunError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "RunError";
+    this.code = code;
   }
 };
-function ndjsonSubscriber(filePath) {
-  return async (event) => {
-    await mkdir8(dirname6(filePath), { recursive: true });
-    await appendFile2(filePath, `${JSON.stringify(event)}
-`, "utf8");
-  };
+function createDefaultAdapters(config2) {
+  return [
+    playwrightAdapterFactory({ baseUrl: config2.web?.baseUrl }),
+    wechatideAdapterFactory({
+      projectPath: config2.miniapp?.projectPath,
+      cliPath: config2.miniapp?.cliPath
+    })
+  ];
+}
+async function runCases(options = {}) {
+  const root = resolveRoot(options.root);
+  const config2 = await loadProjectConfig(root);
+  const inputs = options.paths && options.paths.length > 0 ? options.paths.map((input2) => isAbsolute2(input2) ? input2 : join15(root, input2)) : [join15(root, config2.casesDir)];
+  const cases = await collectCases(inputs, { root });
+  if (cases.length === 0) {
+    throw new RunError("ENO_CASES", `\u672A\u627E\u5230\u7528\u4F8B\u6587\u4EF6(\u67E5\u627E:${inputs.join(", ")})`);
+  }
+  const invalid = cases.filter((item) => !item.valid);
+  const runnable = cases.filter(
+    (item) => item.valid && item.case && (!options.tag || (item.case.tags ?? []).includes(options.tag))
+  );
+  const tagFiltered = cases.length - invalid.length - runnable.length;
+  if (runnable.length === 0) {
+    throw new RunError(
+      "EINVALID_CASES",
+      invalid.length > 0 ? "\u6240\u6709\u7528\u4F8B\u6821\u9A8C\u5931\u8D25,\u65E0\u53EF\u6267\u884C\u7528\u4F8B" : "\u6CA1\u6709\u5339\u914D\u7684\u7528\u4F8B"
+    );
+  }
+  const factories = options.adapters ?? createDefaultAdapters(config2);
+  const resolver = new AdapterResolver();
+  for (const factory of factories) resolver.register(factory);
+  const runner = new TestRunner({
+    resolver,
+    runsRoot: join15(root, RUNS_DIR),
+    runId: options.runId,
+    onEvent: options.onEvent,
+    signal: options.signal
+  });
+  const summary = await runner.run(
+    runnable.map((item) => ({ data: item.case, file: item.file }))
+  );
+  return { summary, invalid, tagFiltered };
+}
+function runsRoot(root) {
+  return join15(resolveRoot(root), RUNS_DIR);
+}
+async function listRuns(options = {}) {
+  const base = runsRoot(options.root);
+  const entries = await readdir3(base).catch(() => []);
+  const metas = [];
+  for (const entry of entries.filter((name) => /^\d{8}-\d{3}$/.test(name)).sort().reverse()) {
+    metas.push({ ...await readRunMeta(base, entry), runId: entry, dir: join15(base, entry) });
+  }
+  return metas;
+}
+async function latestRunId(options = {}) {
+  const runs = await listRuns(options);
+  return runs[0]?.runId;
+}
+async function getRun(runId, options = {}) {
+  const base = runsRoot(options.root);
+  const file2 = join15(base, runId, RESULT_FILE);
+  try {
+    return JSON.parse(await readFile5(file2, "utf8"));
+  } catch {
+    throw new RunError("ENO_CASES", `\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${file2}(\u8FD0\u884C\u672A\u5B8C\u6210\u6216 runId \u4E0D\u5B58\u5728)`);
+  }
+}
+async function getRunEvents(runId, options = {}) {
+  const file2 = join15(runsRoot(options.root), runId, "events.ndjson");
+  const source = await readFile5(file2, "utf8").catch(() => "");
+  return source.split("\n").filter((line) => line.trim().length > 0).map((line) => JSON.parse(line));
+}
+async function readRunMeta(base, runId) {
+  try {
+    const summary = JSON.parse(
+      await readFile5(join15(base, runId, RESULT_FILE), "utf8")
+    );
+    return {
+      status: summary.status,
+      cancelled: summary.cancelled,
+      startedAt: summary.startedAt,
+      finishedAt: summary.finishedAt,
+      durationMs: summary.durationMs,
+      totals: summary.totals
+    };
+  } catch {
+    return { status: "unknown" };
+  }
 }
 
-// ../../packages/execution-engine/src/scheduler/index.ts
-async function runSequential(items, handler) {
-  const results = [];
-  for (const [index, item] of items.entries()) {
-    results.push(await handler(item, index));
+// ../../packages/sdk/src/reports.ts
+async function generateReport(runId, options = {}) {
+  const id = runId ?? await latestRunId(options);
+  if (!id) {
+    throw new Error("\u672A\u627E\u5230\u8FD0\u884C\u8BB0\u5F55(\u5148\u8FD0\u884C\u4E00\u6B21\u7528\u4F8B)");
+  }
+  const runDir = join16(resolveRoot(options.root), RUNS_DIR, id);
+  let summary;
+  try {
+    summary = JSON.parse(await readFile6(join16(runDir, "result.json"), "utf8"));
+  } catch {
+    throw new Error(`\u8BFB\u53D6\u8FD0\u884C\u7ED3\u679C\u5931\u8D25:${join16(runDir, "result.json")}(\u8FD0\u884C\u672A\u5B8C\u6210\u6216 runId \u4E0D\u5B58\u5728)`);
   }
-  return results;
+  const written = await writeReports(runDir, summary);
+  return { runId: id, json: written.json, html: written.html };
+}
+async function readReport(runId, options = {}) {
+  const file2 = join16(resolveRoot(options.root), RUNS_DIR, runId, "report.json");
+  const source = await readFile6(file2, "utf8").catch(() => void 0);
+  return source ? JSON.parse(source) : void 0;
 }
 
-// ../../packages/adapter-core/src/session.ts
-var AdapterSession = class {
-  constructor(target, factory) {
-    this.target = target;
-    this.factory = factory;
+// ../../packages/sdk/src/client.ts
+function resolveInput(root, input2) {
+  return isAbsolute3(input2) ? input2 : join17(root, input2);
+}
+var TestPilotClient = class {
+  /** 业务项目根目录(绝对路径) */
+  root;
+  constructor(options = {}) {
+    this.root = resolveRoot(options.root);
+  }
+  // ---- project ----
+  /** 读取项目配置(testpilot.yaml 不存在时返回默认配置) */
+  getConfig() {
+    return loadProjectConfig(this.root);
+  }
+  /** 项目自检:目录结构 / 配置 / Skill 安装状态 / 可用执行端 */
+  inspect() {
+    return inspectProject(this.root);
+  }
+  /** 读取本地项目与 Server Project 的关联(.testpilot/project.json) */
+  getProjectLink() {
+    return readProjectLink(this.root);
+  }
+  /** 写入本地项目与 Server Project 的关联 */
+  linkProject(link) {
+    return writeProjectLink(link, this.root);
+  }
+  // ---- cases ----
+  /** 收集并校验用例;paths 相对本项目根目录,默认按配置的 casesDir */
+  async listCases(paths, tag) {
+    const config2 = await this.getConfig();
+    const inputs = paths && paths.length > 0 ? paths : [config2.casesDir];
+    const infos = await collectCases(inputs.map((input2) => resolveInput(this.root, input2)), {
+      root: this.root
+    });
+    return tag ? infos.filter((item) => item.case?.tags?.includes(tag)) : infos;
   }
-  adapter;
-  get opened() {
-    return this.adapter !== void 0;
+  /** 读取单个用例:source 原文 + 校验结果 */
+  readCase(file2) {
+    return readCaseFile(file2, { root: this.root });
   }
-  /** 惰性创建;已创建则复用 */
-  async get() {
-    if (!this.adapter) {
-      this.adapter = await this.factory.create();
-      await this.adapter.launch();
-    }
-    return this.adapter;
+  /** 写入用例(供 Agent 的 create_case 工具使用):先校验后落盘 */
+  writeCase(file2, source, options = {}) {
+    return writeCaseFile(file2, source, { root: this.root, ...options });
   }
-  async close() {
-    if (this.adapter) {
-      await this.adapter.close().catch(() => void 0);
-      this.adapter = void 0;
-    }
+  // ---- runs ----
+  /** 执行一次运行 */
+  runCases(options = {}) {
+    return runCases({ ...options, root: this.root });
   }
-};
-
-// ../../packages/execution-engine/src/engine/adapter-resolver.ts
-var AdapterResolver = class {
-  factories = /* @__PURE__ */ new Map();
-  sessions = /* @__PURE__ */ new Map();
-  register(factory) {
-    this.factories.set(factory.target, factory);
+  /** 历史运行列表(最近的在前) */
+  listRuns() {
+    return listRuns({ root: this.root });
   }
-  /** 取得(或创建)target 的会话 */
-  async session(target) {
-    let session = this.sessions.get(target);
-    if (!session) {
-      const factory = this.factories.get(target);
-      if (!factory) {
-        throw new TestPilotError("ADAPTER_NOT_FOUND", `\u672A\u6CE8\u518C target "${target}" \u7684 adapter,\u8BE5\u7AEF\u6B65\u9AA4\u65E0\u6CD5\u6267\u884C`);
-      }
-      session = new AdapterSession(target, factory);
-      this.sessions.set(target, session);
-    }
-    return session;
+  /** 读取一次运行的汇总结果(result.json) */
+  getRun(runId) {
+    return getRun(runId, { root: this.root });
   }
-  async closeAll() {
-    for (const session of this.sessions.values()) {
-      await session.close();
-    }
-    this.sessions.clear();
+  /** 读取一次运行的完整事件流(events.ndjson) */
+  getRunEvents(runId) {
+    return getRunEvents(runId, { root: this.root });
+  }
+  // ---- reports ----
+  /** 生成报告(默认最近一次运行) */
+  generateReport(runId) {
+    return generateReport(runId, { root: this.root });
+  }
+  /** 读取已生成的报告 */
+  readReport(runId) {
+    return readReport(runId, { root: this.root });
   }
 };
 
-// ../../packages/execution-engine/src/engine/step-executor.ts
-async function executeStep(step, index, adapter, context, artifacts, options) {
-  const startedAt = Date.now();
-  const result = {
-    index,
-    target: step.target,
-    action: step.action,
-    status: "passed",
-    durationMs: 0
-  };
-  try {
-    const locator = step.locator ? {
-      text: step.locator.text !== void 0 ? context.resolve(step.locator.text) : void 0,
-      css: step.locator.css !== void 0 ? context.resolve(step.locator.css) : void 0
-    } : void 0;
-    switch (step.action) {
-      case "launch":
-        await adapter.launch();
-        break;
-      case "navigate":
-        await adapter.navigate(context.resolve(step.url ?? ""));
-        break;
-      case "click":
-        await adapter.click(locator);
-        break;
-      case "input":
-        await adapter.input(locator, context.resolve(step.value ?? ""));
-        break;
-      case "select":
-        await adapter.select(locator, context.resolve(step.value ?? ""));
-        break;
-      case "wait":
-        await adapter.wait(locator, step.timeout);
-        break;
-      case "assert":
-        await adapter.assert(locator, context.resolve(step.expected ?? ""));
-        break;
-      case "extract": {
-        const value = await adapter.extract(locator);
-        if (step.variable) {
-          context.set(step.variable, value);
-          result.extracted = { [step.variable]: value };
-        }
-        break;
-      }
-      case "screenshot": {
-        const data = await adapter.screenshot();
-        result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}.png`, data);
-        break;
-      }
-      default: {
-        const exhaustive = step.action;
-        throw new Error(`\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
-      }
+// src/commands/init/adapter-detector.ts
+import { existsSync as existsSync4, readFileSync } from "node:fs";
+import { join as join18 } from "node:path";
+async function detectAdapters(root, projectType) {
+  const required2 = projectType === "hybrid" ? ["playwright", "wechatide"] : projectType === "wechat-miniapp" ? ["wechatide"] : projectType === "web" ? ["playwright"] : [];
+  const pkg = readPackageJsonDeps(root);
+  const hasPlaywrightDep = pkg !== void 0 && ("playwright" in pkg || "@playwright/test" in pkg);
+  const playwrightInstalled = hasPlaywrightDep || existsSync4(join18(root, "node_modules", "playwright"));
+  const devtoolsCli = await findWechatDevToolsCli().catch(() => void 0);
+  return [
+    {
+      id: "playwright",
+      available: playwrightInstalled,
+      detail: playwrightInstalled ? pkg?.["playwright"] ?? pkg?.["@playwright/test"] ?? "\u5DF2\u5B89\u88C5" : "\u672A\u68C0\u6D4B\u5230(pnpm add -D playwright)",
+      required: required2.includes("playwright")
+    },
+    {
+      id: "wechatide",
+      available: devtoolsCli !== void 0,
+      detail: devtoolsCli ?? "\u672A\u627E\u5230\u5FAE\u4FE1\u5F00\u53D1\u8005\u5DE5\u5177(\u53EF\u8BBE\u7F6E WECHAT_DEVTOOLS_CLI \u6307\u5411 cli \u53EF\u6267\u884C\u6587\u4EF6)",
+      required: required2.includes("wechatide")
     }
-  } catch (err) {
-    result.status = "failed";
-    result.error = err instanceof Error ? err.message : String(err);
+  ];
+}
+function readPackageJsonDeps(root) {
+  const file2 = join18(root, "package.json");
+  if (!existsSync4(file2)) return void 0;
+  try {
+    const pkg = JSON.parse(readFileSync(file2, "utf8"));
+    return { ...pkg.dependencies, ...pkg.devDependencies };
+  } catch {
+    return void 0;
+  }
+}
+
+// src/commands/init/environment-initializer.ts
+import { readFile as readFile7 } from "node:fs/promises";
+import { join as join19 } from "node:path";
+var ENV_REF_PATTERN = /\$\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
+async function collectEnvVarRefs(root) {
+  let text;
+  try {
+    text = await readFile7(join19(root, "testpilot.yaml"), "utf8");
+  } catch {
+    return [];
+  }
+  const names = /* @__PURE__ */ new Set();
+  for (const match of text.matchAll(ENV_REF_PATTERN)) {
+    names.add(match[1]);
+  }
+  return [...names].sort();
+}
+
+// src/commands/init/project-detector.ts
+import { existsSync as existsSync5, readFileSync as readFileSync2 } from "node:fs";
+import { basename, join as join20 } from "node:path";
+
+// src/lib/git.ts
+import { execFile as execFile2 } from "node:child_process";
+import { promisify } from "node:util";
+var execFileAsync = promisify(execFile2);
+async function readGitInfo(root) {
+  const run = async (args) => {
     try {
-      const data = await adapter.screenshot();
-      result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}-failed.png`, data);
+      const { stdout } = await execFileAsync("git", args, { cwd: root });
+      return stdout.trim() || void 0;
     } catch {
+      return void 0;
     }
+  };
+  const [branch, commit, repositoryUrl] = await Promise.all([
+    run(["rev-parse", "--abbrev-ref", "HEAD"]),
+    run(["rev-parse", "HEAD"]),
+    run(["remote", "get-url", "origin"])
+  ]);
+  return { branch, commit, repositoryUrl };
+}
+
+// src/commands/init/project-detector.ts
+var WEB_DEP_MARKERS = [
+  "playwright",
+  "@playwright/test",
+  "vite",
+  "next",
+  "react",
+  "vue",
+  "@angular/core",
+  "nuxt",
+  "svelte"
+];
+var E2E_DIR_CANDIDATES = ["tests/e2e", "test/e2e", "e2e", "cypress"];
+function readPackageJson(root) {
+  const file2 = join20(root, "package.json");
+  if (!existsSync5(file2)) return void 0;
+  try {
+    return JSON.parse(readFileSync2(file2, "utf8"));
+  } catch {
+    return void 0;
   }
-  result.durationMs = Date.now() - startedAt;
-  return result;
+}
+function detectProjectType(root) {
+  const pkg = readPackageJson(root);
+  const deps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+  const isWechat = existsSync5(join20(root, "project.config.json")) || existsSync5(join20(root, "app.json")) || existsSync5(join20(root, "miniprogram", "app.json"));
+  const isWeb = existsSync5(join20(root, "index.html")) || WEB_DEP_MARKERS.some((marker) => deps?.[marker] !== void 0) || [".ts", ".tsx", ".js", ".jsx"].some((ext) => existsSync5(join20(root, "src", `index${ext}`)));
+  if (isWechat && isWeb) return "hybrid";
+  if (isWechat) return "wechat-miniapp";
+  if (isWeb) return "web";
+  return "unknown";
+}
+async function detectProject(root) {
+  const pkg = readPackageJson(root);
+  const type = detectProjectType(root);
+  const language = existsSync5(join20(root, "tsconfig.json")) ? "TypeScript" : pkg || existsSync5(join20(root, "src")) ? "JavaScript" : "Unknown";
+  const packageManager = existsSync5(join20(root, "pnpm-lock.yaml")) ? "pnpm" : existsSync5(join20(root, "yarn.lock")) ? "yarn" : existsSync5(join20(root, "package-lock.json")) ? "npm" : "npx";
+  const existingE2eDirs = E2E_DIR_CANDIDATES.filter((dir) => existsSync5(join20(root, dir)));
+  return {
+    root,
+    name: pkg?.name ?? basename(root),
+    type,
+    language,
+    packageManager,
+    git: await readGitInfo(root),
+    hasTestsE2e: existingE2eDirs.includes("tests/e2e"),
+    existingE2eDirs,
+    hasTestpilotConfig: existsSync5(join20(root, "testpilot.yaml")),
+    hasProjectLink: existsSync5(join20(root, ".testpilot", "project.json"))
+  };
+}
+function defaultAdapterFor(type) {
+  if (type === "wechat-miniapp") return "wechatide";
+  return "playwright";
+}
+function adaptersFor(type) {
+  if (type === "hybrid") return ["playwright", "wechatide"];
+  if (type === "wechat-miniapp") return ["wechatide"];
+  if (type === "web") return ["playwright"];
+  return ["playwright"];
 }
 
-// ../../packages/execution-engine/src/engine/execution-engine.ts
-var ExecutionEngine = class {
-  async runCase(data, options) {
-    const { runId, file: file2, artifacts, bus, resolver } = options;
-    const startedAt = /* @__PURE__ */ new Date();
-    const context = new ExecutionContext();
-    const steps = [];
-    const evidenceAdapters = /* @__PURE__ */ new Map();
-    let caseError;
-    await bus.emit({ type: "case-started", runId, caseId: data.id, file: file2, ts: startedAt.toISOString() });
-    await artifacts.logger.info(`case ${data.id} started (${file2})`);
-    for (const [index, step] of data.steps.entries()) {
-      await bus.emit({
-        type: "step-started",
-        runId,
-        caseId: data.id,
-        index,
-        target: step.target,
-        action: step.action,
-        ts: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      let result;
-      try {
-        const adapter = await (await resolver.session(step.target)).get();
-        if (adapter.startEvidence && !evidenceAdapters.has(step.target)) {
-          try {
-            await adapter.startEvidence(data.id);
-            evidenceAdapters.set(step.target, adapter);
-          } catch (err) {
-            await artifacts.logger.info(
-              `evidence start failed for ${step.target}: ${err instanceof Error ? err.message : String(err)}`
-            );
-          }
-        }
-        result = await executeStep(step, index, adapter, context, artifacts, {
-          screenshotName: `${data.id}-step-${String(index).padStart(2, "0")}`
-        });
-      } catch (err) {
-        result = {
-          index,
-          target: step.target,
-          action: step.action,
-          status: "failed",
-          durationMs: 0,
-          error: err instanceof Error ? err.message : String(err)
-        };
-      }
-      steps.push(result);
-      await artifacts.logger.info(`step ${index} ${step.action} -> ${result.status}${result.error ? ` - ${result.error}` : ""}`);
-      await bus.emit({
-        type: "step-finished",
-        runId,
-        caseId: data.id,
-        index,
-        target: step.target,
-        action: step.action,
-        status: result.status,
-        durationMs: result.durationMs,
-        error: result.error,
-        ts: (/* @__PURE__ */ new Date()).toISOString()
+// src/commands/init/doctor.ts
+async function runDoctor(root) {
+  const sections = [];
+  const push = (name, items) => {
+    if (items.length > 0) sections.push({ name, items });
+  };
+  const ok = (label) => ({ status: "ok", label });
+  const warn = (label, hint) => ({ status: "warn", label, hint });
+  const error62 = (label, hint) => ({ status: "error", label, hint });
+  const nodeMajor = Number(process.versions.node.split(".")[0]);
+  push("Runtime", [
+    nodeMajor >= 22 ? ok(`Node.js ${process.versions.node}`) : error62(`Node.js ${process.versions.node}`, "\u9700\u8981 Node.js >= 22")
+  ]);
+  const info = await detectProject(root);
+  const projectItems = [
+    ok(`Project ${info.name}(${info.type})`),
+    info.git.commit ? ok(`Git repository(${info.git.branch ?? "detached"} \xB7 ${info.git.commit.slice(0, 7)})`) : warn("Git repository \u672A\u68C0\u6D4B\u5230", "Case Metadata \u65E0\u6CD5\u540C\u6B65\u5230 Server"),
+    existsSync6(join21(root, ".testpilot", "project.json")) ? ok(".testpilot/project.json") : error62(".testpilot/project.json", "\u8FD0\u884C npx csspilot init \u751F\u6210"),
+    existsSync6(join21(root, "testpilot.yaml")) ? ok("testpilot.yaml") : error62("testpilot.yaml", "\u8FD0\u884C npx csspilot init \u751F\u6210")
+  ];
+  push("Project", projectItems);
+  const config2 = await loadTestpilotConfig(root).catch(() => void 0);
+  const casesDir = config2?.casesDir ?? "tests/e2e/cases";
+  const cases = await collectCases([casesDir], { root }).catch(() => []);
+  const invalidCount = cases.filter((item) => !item.valid).length;
+  const testDir = join21(root, "tests", "e2e");
+  push("Test", [
+    existsSync6(testDir) ? ok("tests/e2e") : error62("tests/e2e", "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    existsSync6(join21(root, casesDir)) ? ok(`cases directory(${casesDir})`) : error62(`cases directory(${casesDir})`, "\u8FD0\u884C npx csspilot init \u521B\u5EFA"),
+    cases.length === 0 ? warn("Case validation \u8DF3\u8FC7(\u672A\u627E\u5230\u7528\u4F8B)", "\u5728 tests/e2e/cases \u521B\u5EFA Case") : invalidCount === 0 ? ok(`Case validation(${cases.length} \u4E2A\u7528\u4F8B\u5168\u90E8\u6709\u6548)`) : error62(`Case validation(${invalidCount}/${cases.length} \u4E2A\u7528\u4F8B\u6821\u9A8C\u5931\u8D25)`, "\u8FD0\u884C npx csspilot validate \u67E5\u770B\u8BE6\u60C5")
+  ]);
+  const skillDir = join21(root, ".agents", "skills", "testpilot");
+  push("Agent", [
+    existsSync6(join21(skillDir, "manifest.yaml")) ? ok("TestPilot Skill(.agents/skills/testpilot)") : error62("TestPilot Skill", "\u8FD0\u884C npx csspilot init \u5B89\u88C5"),
+    existsSync6(join21(skillDir, "references", "project.md")) ? ok("Project testing guide(references/)") : warn("Project testing guide \u7F3A\u5931", "references/ \u7531 init \u751F\u6210;\u53EF\u91CD\u65B0\u8FD0\u884C npx csspilot init")
+  ]);
+  const adapters = await detectAdapters(root, info.type);
+  push(
+    "Adapters",
+    adapters.map(
+      (item) => item.available ? ok(`${item.id}(${item.detail})`) : item.required ? warn(`${item.id} \u4E0D\u53EF\u7528`, item.detail) : warn(`${item.id} \u672A\u5B89\u88C5(\u53EF\u9009)`, item.detail)
+    )
+  );
+  const refs = await collectEnvVarRefs(root);
+  if (refs.length > 0) {
+    push(
+      "Environment",
+      refs.map(
+        (name) => process.env[name] !== void 0 ? ok(name) : error62(`${name} missing`, "\u5728\u8FD0\u884C\u73AF\u5883(.env / CI Secret)\u4E2D\u8BBE\u7F6E")
+      )
+    );
+  }
+  const serverUrl = process.env.TESTPILOT_SERVER_URL ?? config2?.server?.baseUrl;
+  if (serverUrl) {
+    const link = await readProjectLink(root);
+    const serverItems = [];
+    try {
+      const res = await fetch(`${serverUrl.replace(/\/$/, "")}/api/health`, {
+        signal: AbortSignal.timeout(3e3)
       });
-      if (result.status === "failed") {
-        caseError = result.error;
-        for (const [skipIndex, skippedStep] of data.steps.entries()) {
-          if (skipIndex <= index) continue;
-          steps.push({
-            index: skipIndex,
-            target: skippedStep.target,
-            action: skippedStep.action,
-            status: "skipped",
-            durationMs: 0
-          });
-        }
-        break;
-      }
+      serverItems.push(res.ok ? ok(`Connected(${serverUrl})`) : error62(`Server ${res.status}`, serverUrl));
+    } catch (err) {
+      serverItems.push(
+        error62(`Server \u4E0D\u53EF\u8FBE(${serverUrl})`, err instanceof Error ? err.message : String(err))
+      );
     }
-    const finishedAt = /* @__PURE__ */ new Date();
-    const status = caseError ? "failed" : "passed";
-    const caseResult = {
-      caseId: data.id,
-      caseName: data.name,
-      file: file2,
-      status,
-      steps,
-      startedAt: startedAt.toISOString(),
-      finishedAt: finishedAt.toISOString(),
-      durationMs: finishedAt.getTime() - startedAt.getTime()
-    };
-    if (caseError) caseResult.error = caseError;
-    for (const [target, adapter] of evidenceAdapters) {
-      if (!adapter.stopEvidence) continue;
-      try {
-        const evidence = await adapter.stopEvidence(data.id);
-        if (evidence.video) {
-          caseResult.video = await artifacts.saveVideo(`${data.id}-${target}.webm`, evidence.video);
-        }
-        if (evidence.trace) {
-          caseResult.trace = await artifacts.saveTrace(`${data.id}-${target}.zip`, evidence.trace);
-        }
-      } catch (err) {
-        await artifacts.logger.info(
-          `evidence stop failed for ${target}: ${err instanceof Error ? err.message : String(err)}`
-        );
-      }
+    if (link?.projectId) serverItems.push(ok(`Project association(${link.projectId})`));
+    else serverItems.push(warn("Project association \u7F3A\u5931", "\u8FD0\u884C npx csspilot init \u91CD\u65B0\u5173\u8054"));
+    push("Server", serverItems);
+  }
+  const all = sections.flatMap((section) => section.items);
+  return {
+    sections,
+    errors: all.filter((item) => item.status === "error").length,
+    warnings: all.filter((item) => item.status === "warn").length
+  };
+}
+var MARK = { ok: "\u2714", warn: "\u26A0", error: "\u2717" };
+function printDoctor(report) {
+  console.log("TestPilot Doctor");
+  console.log("");
+  for (const section of report.sections) {
+    console.log(section.name);
+    console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    for (const item of section.items) {
+      const hint = item.hint ? `(${item.hint})` : "";
+      console.log(`${MARK[item.status]} ${item.label}${hint}`);
     }
-    await bus.emit({
-      type: "case-finished",
-      runId,
-      caseId: data.id,
-      status,
-      durationMs: finishedAt.getTime() - startedAt.getTime(),
-      ts: finishedAt.toISOString()
+    console.log("");
+  }
+  console.log("Result");
+  console.log("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+  console.log(`${report.errors} error${report.errors === 1 ? "" : "s"}`);
+  console.log(`${report.warnings} warning${report.warnings === 1 ? "" : "s"}`);
+}
+
+// src/commands/doctor.ts
+function makeDoctorCommand() {
+  return new Command("doctor").description("TestPilot \u5065\u5EB7\u68C0\u67E5(Runtime / \u9879\u76EE / \u7528\u4F8B / Skill / Adapter / \u73AF\u5883\u53D8\u91CF / Server)").action(async () => {
+    const report = await runDoctor(process.cwd());
+    printDoctor(report);
+    if (report.errors > 0) process.exitCode = 1;
+  });
+}
+
+// src/commands/init/index.ts
+import { join as join25 } from "node:path";
+
+// src/commands/init/config-initializer.ts
+import { access as access2, mkdir as mkdir11, writeFile as writeFile9 } from "node:fs/promises";
+import { basename as basename2, join as join22 } from "node:path";
+async function exists3(path) {
+  try {
+    await access2(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var TEST_DIR = "tests/e2e";
+var CASE_DIR = "tests/e2e/cases";
+function renderTestpilotYaml(info) {
+  const adapters = adaptersFor(info.type).map((item) => `  - ${item}`).join("\n");
+  return `# TestPilot \u9879\u76EE\u914D\u7F6E(Source of Truth)
+version: 1
+
+project:
+  name: ${info.name}
+
+test:
+  directory: ${TEST_DIR}
+  caseDirectory: ${CASE_DIR}
+
+# \u73AF\u5883\u914D\u7F6E:Case \u7528 environment: <\u540D\u79F0> \u5F15\u7528;baseUrl \u7531\u73AF\u5883\u53D8\u91CF\u6CE8\u5165,\u7981\u6B62\u5199\u660E\u6587
+environment:
+  default: test
+  test:
+    baseUrl: \${TEST_BASE_URL}
+  staging:
+    baseUrl: \${STAGING_BASE_URL}
+
+# \u9879\u76EE\u58F0\u660E\u7684\u6267\u884C\u7AEF(\u5B9E\u9645\u53EF\u7528\u6027\u4EE5 csspilot doctor \u68C0\u6D4B\u4E3A\u51C6)
+adapters:
+${adapters}
+
+# \u9ED8\u8BA4 Workspace(\u591A\u7CFB\u7EDF\u73AF\u5883\u7EC4\u5408);Case \u4E5F\u53EF\u7528 workspace \u5B57\u6BB5\u6309\u9700\u58F0\u660E
+# workspace:
+#   default: my-workspace
+
+# TestPilot Server(Control Plane)\u5730\u5740;init \u5173\u8054\u9879\u76EE\u4E0E sync-metadata \u4F7F\u7528
+# \u4E5F\u53EF\u7528\u73AF\u5883\u53D8\u91CF TESTPILOT_SERVER_URL \u8986\u76D6
+# server:
+#   baseUrl: http://127.0.0.1:3000
+
+# Web \u7AEF:navigate \u76F8\u5BF9 url \u7684\u57FA\u51C6\u5730\u5740
+# web:
+#   baseUrl: http://127.0.0.1:8080
+
+# \u5C0F\u7A0B\u5E8F\u7AEF:\u586B\u5165\u5C0F\u7A0B\u5E8F\u9879\u76EE\u76EE\u5F55\u540E\u5373\u53EF\u6267\u884C target: miniapp \u7684\u6B65\u9AA4
+# miniapp:
+#   projectPath: path/to/miniprogram
+#   cliPath: C:/Program Files (x86)/Tencent/\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177/cli.bat
+`;
+}
+async function initTestPilotConfig(root, info, adapters) {
+  const yamlPath = join22(root, "testpilot.yaml");
+  let yaml = "reused";
+  if (!await exists3(yamlPath)) {
+    await writeFile9(yamlPath, renderTestpilotYaml(info), "utf8");
+    yaml = "created";
+  }
+  const runtimeDir = join22(root, ".testpilot", "artifacts");
+  await mkdir11(runtimeDir, { recursive: true });
+  const keep = join22(runtimeDir, ".gitkeep");
+  if (!await exists3(keep)) {
+    await writeFile9(keep, "", "utf8");
+  }
+  const existing = await readProjectLink(root);
+  const defaultAdapter = defaultAdapterFor(info.type);
+  const serverUrl = process.env.TESTPILOT_SERVER_URL ?? void 0;
+  const link = existing ? { ...existing, version: existing.version ?? 1 } : {
+    ...await createProjectOnServer(root, info, adapters, serverUrl),
+    version: 1,
+    testDir: TEST_DIR,
+    caseDir: CASE_DIR,
+    defaultAdapter
+  };
+  if (link.testDir === void 0 || link.caseDir === void 0 || link.defaultAdapter === void 0) {
+    link.testDir ??= TEST_DIR;
+    link.caseDir ??= CASE_DIR;
+    link.defaultAdapter ??= defaultAdapter;
+  }
+  if (link.serverUrl === void 0 && serverUrl) link.serverUrl = serverUrl;
+  const projectLinkFile = await writeProjectLink(link, root);
+  return { yaml, runtimeDir: join22(root, ".testpilot"), projectLink: link, projectLinkFile };
+}
+async function createProjectOnServer(root, info, _adapters, serverUrl) {
+  const git = info.git;
+  const base = { repositoryUrl: git.repositoryUrl, branch: git.branch };
+  if (!serverUrl) return { ...base, projectId: `proj_${randomId()}` };
+  try {
+    const res = await fetch(`${serverUrl.replace(/\/$/, "")}/api/projects`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        name: info.name || basename2(root),
+        rootPath: root,
+        repositoryUrl: git.repositoryUrl,
+        defaultBranch: git.branch
+      })
     });
-    await artifacts.logger.info(`case ${data.id} ${status}`);
-    return caseResult;
+    if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
+    const project = await res.json();
+    return { ...base, serverUrl, projectId: `proj_${project.id}` };
+  } catch (err) {
+    console.error(`\u2717 \u9879\u76EE\u5173\u8054               Server(${serverUrl})\u4E0D\u53EF\u8FBE:${err instanceof Error ? err.message : err}`);
+    return { ...base, serverUrl, projectId: `proj_${randomId()}` };
   }
-};
+}
+function randomId() {
+  return Math.random().toString(16).slice(2, 10);
+}
 
-// ../../packages/execution-engine/src/engine/result-collector.ts
-function buildRunSummary(runId, startedAt, cases) {
-  const finishedAt = /* @__PURE__ */ new Date();
-  const totals = {
-    cases: cases.length,
-    passed: cases.filter((item) => item.status === "passed").length,
-    failed: cases.filter((item) => item.status === "failed").length,
-    steps: 0,
-    stepsPassed: 0,
-    stepsFailed: 0,
-    stepsSkipped: 0
+// src/commands/init/skill-installer.ts
+import { existsSync as existsSync7 } from "node:fs";
+import { access as access3, cp, mkdir as mkdir12, writeFile as writeFile10 } from "node:fs/promises";
+import { dirname as dirname7, join as join23 } from "node:path";
+import { fileURLToPath } from "node:url";
+async function exists4(path) {
+  try {
+    await access3(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function resolveSkillSourceDir() {
+  const fromEnv = process.env.TESTPILOT_SKILL_DIR;
+  if (fromEnv) return fromEnv;
+  const bundled = fileURLToPath(new URL("../../skills/testpilot", import.meta.url));
+  if (existsSync7(bundled)) return bundled;
+  const inRepo = fileURLToPath(new URL("../../../../../skills/testpilot", import.meta.url));
+  return existsSync7(inRepo) ? inRepo : void 0;
+}
+async function installSkill(root, info, adapters) {
+  const dest = join23(root, ".agents", "skills", "testpilot");
+  let core = "reused";
+  if (!await exists4(join23(dest, "manifest.yaml"))) {
+    const src = resolveSkillSourceDir();
+    if (!src) {
+      throw new Error(
+        "\u65E0\u6CD5\u5B9A\u4F4D TestPilot Skill \u6E90\u76EE\u5F55;\u53EF\u901A\u8FC7\u73AF\u5883\u53D8\u91CF TESTPILOT_SKILL_DIR \u6307\u5B9A skills/testpilot \u8DEF\u5F84"
+      );
+    }
+    await mkdir12(dirname7(dest), { recursive: true });
+    await cp(src, dest, { recursive: true });
+    core = "created";
+  }
+  const refsDir = join23(dest, "references");
+  const files = [
+    ["project.md", () => renderProjectMd(info, adapters)],
+    ["test-conventions.md", renderTestConventionsMd],
+    ["adapters.md", () => renderAdaptersMd(adapters)]
+  ];
+  let references = "reused";
+  for (const [name, render] of files) {
+    const file2 = join23(refsDir, name);
+    if (await exists4(file2)) continue;
+    await mkdir12(refsDir, { recursive: true });
+    await writeFile10(file2, render(), "utf8");
+    references = "created";
+  }
+  return { core, references, dest };
+}
+function renderProjectMd(info, adapters) {
+  const available = adapters.filter((item) => item.available).map((item) => item.id);
+  return `# Project
+
+\u81EA\u52A8\u751F\u6210\u4E8E \`csspilot init\`,\u63CF\u8FF0\u672C\u9879\u76EE\u7684 TestPilot \u63A5\u5165\u4FE1\u606F;Agent \u4F18\u5148\u4ECE\u8FD9\u91CC\u4E86\u89E3\u9879\u76EE\u3002
+
+- Project name: ${info.name}
+- Project type: ${info.type}
+- Language: ${info.language}
+- Package manager: ${info.packageManager}
+- Test directory: tests/e2e
+- Case directory: tests/e2e/cases
+- Available adapters: ${available.length > 0 ? available.join(", ") : "(none detected)"}
+- Default environment: test(testpilot.yaml environment.default)
+- Default workspace: \u672A\u8BBE\u7F6E(Case \u53EF\u6309\u9700\u58F0\u660E workspace \u5B57\u6BB5)
+`;
+}
+function renderTestConventionsMd() {
+  return `# Test Conventions
+
+\u672C\u9879\u76EE E2E \u6D4B\u8BD5\u7EA6\u5B9A,Agent \u751F\u6210/\u4FEE\u6539 Case \u65F6\u5FC5\u987B\u9075\u5B88:
+
+1. E2E Case \u4F4D\u4E8E tests/e2e/cases
+2. Case \u4F7F\u7528 TestPilot DSL
+3. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 Playwright
+4. \u4E0D\u5141\u8BB8\u76F4\u63A5\u8C03\u7528 WeChatIDE
+5. \u4E0D\u5141\u8BB8\u5728 Case \u4E2D\u5199\u660E\u6587\u5BC6\u7801(\u7528 accountRef \u5F15\u7528)
+6. \u4F18\u5148\u590D\u7528\u5DF2\u6709 Case
+7. \u65B0\u589E Case \u5FC5\u987B\u901A\u8FC7 csspilot validate
+8. Case ID \u5FC5\u987B\u552F\u4E00
+`;
+}
+function renderAdaptersMd(adapters) {
+  const lines = adapters.map(
+    (item) => `- ${item.id}: ${item.available ? "\u53EF\u7528" : "\u4E0D\u53EF\u7528"}${item.required ? "(\u9879\u76EE\u9700\u8981)" : "(\u53EF\u9009)"} \u2014 ${item.detail}`
+  );
+  return `# Adapters
+
+\u6267\u884C\u7AEF\u68C0\u6D4B\u7ED3\u679C(\u4EE5 \`csspilot doctor\` \u6700\u65B0\u8F93\u51FA\u4E3A\u51C6):
+
+${lines.join("\n")}
+
+Agent \u6C38\u8FDC\u4E0D\u76F4\u63A5\u64CD\u4F5C Adapter;Case \u7ECF Execution Engine \u8C03\u5EA6\u5230\u5BF9\u5E94 Adapter \u6267\u884C\u3002
+`;
+}
+
+// src/commands/init/test-structure.ts
+import { existsSync as existsSync8, readdirSync as readdirSync2 } from "node:fs";
+import { mkdir as mkdir13, writeFile as writeFile11 } from "node:fs/promises";
+import { join as join24 } from "node:path";
+async function initTestStructure(root, _info) {
+  const dirs = {
+    cases: join24(root, "tests", "e2e", "cases"),
+    fixtures: join24(root, "tests", "e2e", "fixtures"),
+    data: join24(root, "tests", "e2e", "data")
   };
-  for (const item of cases) {
-    for (const step of item.steps) {
-      totals.steps++;
-      if (step.status === "passed") totals.stepsPassed++;
-      else if (step.status === "failed") totals.stepsFailed++;
-      else totals.stepsSkipped++;
+  const existed = {
+    cases: existsSync8(dirs.cases),
+    fixtures: existsSync8(dirs.fixtures),
+    data: existsSync8(dirs.data)
+  };
+  for (const dir of Object.values(dirs)) {
+    await mkdir13(dir, { recursive: true });
+  }
+  for (const [name, dir] of Object.entries(dirs)) {
+    if (!existed[name] && readdirSync2(dir).length === 0) {
+      await writeFile11(join24(dir, ".gitkeep"), "", "utf8").catch(() => void 0);
     }
   }
   return {
-    runId,
-    startedAt: startedAt.toISOString(),
-    finishedAt: finishedAt.toISOString(),
-    durationMs: finishedAt.getTime() - startedAt.getTime(),
-    status: totals.failed > 0 ? "failed" : "passed",
-    cases,
-    totals
+    cases: existed.cases ? "reused" : "created",
+    fixtures: existed.fixtures ? "reused" : "created",
+    data: existed.data ? "reused" : "created"
   };
 }
 
-// ../../packages/execution-engine/src/engine/test-runner.ts
-import { writeFile as writeFile6 } from "node:fs/promises";
-import { join as join15, resolve as resolve2 } from "node:path";
-var TestRunner = class {
-  resolver;
-  runsRoot;
-  extraSubscriber;
-  constructor(options) {
-    this.resolver = options.resolver;
-    this.runsRoot = resolve2(options.runsRoot ?? join15(process.cwd(), ".testpilot", "artifacts", "runs"));
-    this.extraSubscriber = options.onEvent;
-  }
-  async run(cases) {
-    const startedAt = /* @__PURE__ */ new Date();
-    const runId = await allocateRunId(this.runsRoot);
-    const runDir = await ensureRunDir(this.runsRoot, runId);
-    const artifacts = new ArtifactManager(runDir);
-    await artifacts.prepare();
-    const bus = new EventBus();
-    bus.subscribe(ndjsonSubscriber(join15(runDir, "events.ndjson")));
-    if (this.extraSubscriber) bus.subscribe(this.extraSubscriber);
-    await bus.emit({ type: "run-started", runId, totalCases: cases.length, ts: startedAt.toISOString() });
-    await artifacts.logger.info(`run ${runId} started with ${cases.length} case(s)`);
-    const engine = new ExecutionEngine();
-    const results = await runSequential(
-      cases,
-      (item) => engine.runCase(item.data, {
-        runId,
-        file: item.file,
-        artifacts,
-        bus,
-        resolver: this.resolver
-      })
-    );
-    await this.resolver.closeAll();
-    const summary = buildRunSummary(runId, startedAt, results);
-    await bus.emit({
-      type: "run-finished",
-      runId,
-      status: summary.status,
-      totals: { cases: summary.totals.cases, passed: summary.totals.passed, failed: summary.totals.failed },
-      ts: (/* @__PURE__ */ new Date()).toISOString()
-    });
-    await artifacts.logger.info(`run ${runId} finished: ${summary.status}`);
-    await writeFile6(join15(runDir, RESULT_FILE), JSON.stringify(summary, null, 2), "utf8");
-    return summary;
+// src/commands/init/index.ts
+async function runInit(root, options = {}) {
+  if (options.serverUrl !== void 0) {
+    if (options.serverUrl === null) delete process.env.TESTPILOT_SERVER_URL;
+    else process.env.TESTPILOT_SERVER_URL = options.serverUrl;
+  }
+  const project = await detectProject(root);
+  console.log(`\u2714 Project:          ${project.name}`);
+  console.log(`\u2714 Type:             ${project.type}`);
+  console.log(`\u2714 Language:         ${project.language}`);
+  console.log(`\u2714 Package Manager:  ${project.packageManager}`);
+  console.log(project.git.commit ? `\u2714 Git repository    ${project.git.branch ?? "(detached)"}` : "\u2717 Git repository    \u672A\u68C0\u6D4B\u5230");
+  const adapters = await detectAdapters(root, project.type);
+  console.log("");
+  console.log("Testing adapters:");
+  for (const adapter of adapters) {
+    const mark = adapter.available ? "\u2713" : "\u2717";
+    console.log(`${mark} ${adapter.id}${adapter.available ? "" : " not detected"} \u2014 ${adapter.detail}`);
+  }
+  console.log("");
+  const config2 = await initTestPilotConfig(root, project, adapters);
+  console.log(
+    config2.yaml === "created" ? "\u2713 \u9879\u76EE\u914D\u7F6E          testpilot.yaml" : "\u2713 \u9879\u76EE\u914D\u7F6E          testpilot.yaml(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
+  );
+  console.log(`\u2713 Runtime \u76EE\u5F55      ${join25(".testpilot", "artifacts")}`);
+  const serverMode = config2.projectLink.serverUrl ? `Server:${config2.projectLink.serverUrl}` : "\u672C\u5730\u6A21\u5F0F";
+  console.log(`\u2713 \u9879\u76EE\u5173\u8054          ${config2.projectLink.projectId}(${serverMode})`);
+  const testStructure = await initTestStructure(root, project);
+  const reuseNote = project.existingE2eDirs.filter((dir) => dir !== "tests/e2e");
+  console.log(
+    testStructure.cases === "reused" ? "\u2713 \u6D4B\u8BD5\u76EE\u5F55          tests/e2e(\u5DF2\u5B58\u5728,\u590D\u7528)" : "\u2713 \u6D4B\u8BD5\u76EE\u5F55          tests/e2e/{cases,fixtures,data}"
+  );
+  if (reuseNote.length > 0) {
+    console.log(`  \u26A0 \u68C0\u6D4B\u5230\u5176\u4ED6 E2E \u76EE\u5F55:${reuseNote.join(", ")}(\u4FDD\u7559\u4E0D\u52A8,\u672A\u5F3A\u5236\u8FC1\u79FB)`);
+  }
+  const skill = await installSkill(root, project, adapters);
+  console.log(
+    skill.core === "created" ? `\u2713 Skill \u5B89\u88C5        ${join25(".agents", "skills", "testpilot")}` : "\u2713 Skill \u5B89\u88C5        .agents/skills/testpilot/(\u5DF2\u5B58\u5728,\u8DF3\u8FC7)"
+  );
+  console.log(
+    skill.references === "created" ? "\u2713 Agent \u4E0A\u4E0B\u6587      references/{project,test-conventions,adapters}.md" : "\u2713 Agent \u4E0A\u4E0B\u6587      references/(\u5DF2\u5B58\u5728,\u4FDD\u7559)"
+  );
+  console.log("\u2713 \u73AF\u5883\u914D\u7F6E          environment \u6BB5(test/staging),baseUrl \u7531 TEST_BASE_URL \u7B49\u53D8\u91CF\u6CE8\u5165");
+  const ci = await detectCi(root);
+  if (ci.hasTestpilotWorkflow) {
+    console.log("\u2713 CI               .github/workflows/testpilot.yml(\u5DF2\u5B58\u5728)");
+  } else if (ci.githubWorkflows || ci.gitlabCi) {
+    console.log("\u26A0 CI               \u68C0\u6D4B\u5230\u5DF2\u6709 CI \u914D\u7F6E,\u672A\u6539\u52A8;\u53EF\u8FD0\u884C npx csspilot ci init \u751F\u6210 TestPilot \u5DE5\u4F5C\u6D41");
+  } else {
+    console.log("\u2139 CI               \u672A\u68C0\u6D4B\u5230 CI;\u53EF\u8FD0\u884C npx csspilot ci init \u751F\u6210\u6A21\u677F");
   }
-};
+  console.log("");
+  const doctor = await runDoctor(root);
+  printDoctor(doctor);
+  console.log("\u4E0B\u4E00\u6B65:");
+  console.log("  1. \u8BA9 AI \u9605\u8BFB .agents/skills/testpilot/SKILL.md(\u9879\u76EE\u4E0A\u4E0B\u6587\u89C1 references/)");
+  console.log("  2. \u5728 tests/e2e/cases/ \u521B\u5EFA Case(\u9075\u5FAA references/test-conventions.md)");
+  console.log("  3. npx csspilot validate && npx csspilot run");
+  return { project, adapters, config: config2, testStructure, skill, doctor };
+}
+function makeInitCommand() {
+  return new Command("init").description("\u628A TestPilot \u63A5\u5165\u5F53\u524D\u4E1A\u52A1\u9879\u76EE(\u5E42\u7B49,\u53EF\u91CD\u590D\u6267\u884C)").option("--server <url>", "TestPilot Server \u5730\u5740(\u9ED8\u8BA4\u8BFB TESTPILOT_SERVER_URL / testpilot.yaml)").action(async (options) => {
+    try {
+      await runInit(process.cwd(), options.server ? { serverUrl: options.server } : {});
+    } catch (err) {
+      console.error(`\u2717 init \u5931\u8D25:${err instanceof Error ? err.message : String(err)}`);
+      process.exitCode = 1;
+    }
+  });
+}
 
-// src/commands/run.ts
-function makeRunCommand() {
-  return new Command("run").description("\u6267\u884C\u6D4B\u8BD5\u7528\u4F8B(\u9ED8\u8BA4\u8FD0\u884C testpilot.yaml \u914D\u7F6E\u7684 Case)").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").option("--tag <tag>", "\u6309\u6807\u7B7E\u8FC7\u6EE4\u7528\u4F8B").action(async (paths, options) => {
-    const config2 = await loadTestpilotConfig().catch((err) => {
+// src/commands/list.ts
+function makeListCommand() {
+  return new Command("list").description("\u5217\u51FA\u6D4B\u8BD5\u7528\u4F8B").option("--tag <tag>", "\u6309\u6807\u7B7E\u8FC7\u6EE4").action(async (options) => {
+    const client = new TestPilotClient();
+    const infos = await client.listCases(void 0, options.tag).catch((err) => {
       console.error(err.message);
       process.exitCode = 1;
       return void 0;
     });
-    if (!config2) return;
-    const inputs = paths && paths.length > 0 ? paths : [config2.casesDir];
-    const files = await collectCaseFiles(inputs);
-    if (files.length === 0) {
-      console.error(`\u672A\u627E\u5230\u7528\u4F8B\u6587\u4EF6(\u67E5\u627E:${inputs.join(", ")})`);
+    if (!infos) return;
+    if (infos.length === 0) {
+      const config2 = await client.getConfig();
+      console.error(`\u672A\u627E\u5230\u7528\u4F8B\u76EE\u5F55 ${config2.casesDir}`);
+      console.error("\u63D0\u793A:\u5148\u8FD0\u884C npx csspilot init \u63A5\u5165 TestPilot");
       process.exitCode = 1;
       return;
     }
-    const cases = [];
-    let invalid = 0;
-    let tagFiltered = 0;
-    for (const file2 of files) {
-      const source = await readFile5(file2, "utf8");
-      const result = validateCaseSource(source);
-      if (!result.ok || !result.data) {
-        invalid++;
-        console.log(`\u2717 ${file2}(\u6821\u9A8C\u672A\u901A\u8FC7,\u5DF2\u8DF3\u8FC7;\u8FD0\u884C npx csspilot validate \u67E5\u770B\u8BE6\u60C5)`);
-        continue;
-      }
-      if (options.tag && !(result.data.tags ?? []).includes(options.tag)) {
-        tagFiltered++;
-        continue;
+    console.log("TestPilot Cases");
+    console.log("");
+    for (const item of infos) {
+      if (item.valid) {
+        const tags = item.case?.tags ?? [];
+        const tagLabel = tags.length > 0 ? `  [${tags.join(", ")}]` : "";
+        console.log(`\u2713 ${item.case?.id}${tagLabel}`);
+        console.log(`  ${item.file}`);
+      } else {
+        console.log(`\u2717 ${item.file}`);
+        console.log(`  ${item.issues[0]?.message ?? "\u89E3\u6790\u5931\u8D25"}`);
       }
-      cases.push({ data: result.data, file: file2 });
+      console.log("");
+    }
+    const broken = infos.filter((item) => !item.valid).length;
+    const brokenNote = broken > 0 ? `,${broken} \u4E2A\u6587\u4EF6\u89E3\u6790\u5931\u8D25` : "";
+    const visible = infos.length - broken;
+    console.log(`\u5171 ${visible} \u4E2A\u7528\u4F8B${options.tag ? `(tag: ${options.tag})` : ""}${brokenNote}`);
+  });
+}
+
+// src/commands/report.ts
+import { exec } from "node:child_process";
+function makeReportCommand() {
+  return new Command("report").description("\u751F\u6210\u6D4B\u8BD5\u62A5\u544A(JSON + HTML)").option("--run <id>", "\u8FD0\u884C\u8BB0\u5F55 ID,\u9ED8\u8BA4\u6700\u8FD1\u4E00\u6B21").option("--open", "\u751F\u6210\u540E\u5728\u6D4F\u89C8\u5668\u6253\u5F00", false).action(async (options) => {
+    const client = new TestPilotClient();
+    try {
+      const report = await client.generateReport(options.run);
+      console.log(`\u2713 report.json  ${report.json}`);
+      console.log(`\u2713 report.html  ${report.html}`);
+      if (options.open) await openInBrowser(report.html);
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : err);
+      process.exitCode = 1;
     }
-    if (cases.length === 0) {
-      console.error("\u6CA1\u6709\u53EF\u6267\u884C\u7684\u7528\u4F8B");
+  });
+}
+function openInBrowser(file2) {
+  const command = process.platform === "win32" ? `start "" "${file2}"` : process.platform === "darwin" ? `open "${file2}"` : `xdg-open "${file2}"`;
+  return new Promise((resolvePromise) => {
+    exec(command, () => resolvePromise());
+  });
+}
+
+// src/commands/run.ts
+import { join as join26 } from "node:path";
+function makeRunCommand() {
+  return new Command("run").description("\u6267\u884C\u6D4B\u8BD5\u7528\u4F8B(\u9ED8\u8BA4\u8FD0\u884C testpilot.yaml \u914D\u7F6E\u7684 Case)").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").option("--tag <tag>", "\u6309\u6807\u7B7E\u8FC7\u6EE4\u7528\u4F8B").action(async (paths, options) => {
+    const client = new TestPilotClient();
+    try {
+      const { summary, invalid, tagFiltered } = await client.runCases({
+        paths,
+        tag: options.tag,
+        onEvent: consoleEventHandler
+      });
+      const notes = [
+        invalid.length > 0 ? `${invalid.length} \u4E2A\u6821\u9A8C\u5931\u8D25\u8DF3\u8FC7` : "",
+        tagFiltered > 0 ? `${tagFiltered} \u4E2A\u88AB --tag \u8FC7\u6EE4` : ""
+      ].filter(Boolean).join(",");
+      console.log("");
+      console.log(
+        `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u7528\u4F8B \u2713${summary.totals.passed} \u2717${summary.totals.failed},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped}${notes ? `(${notes})` : ""}`
+      );
+      console.log(`\u4EA7\u7269\u76EE\u5F55:${join26(".testpilot", "artifacts", "runs", summary.runId)}`);
+      console.log("\u67E5\u770B\u62A5\u544A:npx csspilot report");
+      if (summary.status === "failed") process.exitCode = 1;
+    } catch (err) {
+      console.error(err instanceof Error ? err.message : err);
       process.exitCode = 1;
-      return;
     }
-    const resolver = new AdapterResolver();
-    resolver.register(playwrightAdapterFactory({ baseUrl: config2.web?.baseUrl }));
-    resolver.register(
-      wechatideAdapterFactory({
-        projectPath: config2.miniapp?.projectPath,
-        cliPath: config2.miniapp?.cliPath
-      })
-    );
-    const runner = new TestRunner({ resolver, onEvent: consoleEventHandler });
-    const notes = [
-      invalid > 0 ? `${invalid} \u4E2A\u6821\u9A8C\u5931\u8D25\u8DF3\u8FC7` : "",
-      tagFiltered > 0 ? `${tagFiltered} \u4E2A\u88AB --tag \u8FC7\u6EE4` : ""
-    ].filter(Boolean).join(",");
-    console.log(`\u8FD0\u884C ${cases.length} \u4E2A\u7528\u4F8B${notes ? `(${notes})` : ""}
-`);
-    const summary = await runner.run(cases);
-    console.log("");
-    console.log(
-      `Run ${summary.runId}: ${summary.status.toUpperCase()} \u2014 \u7528\u4F8B \u2713${summary.totals.passed} \u2717${summary.totals.failed},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped}`
-    );
-    console.log(`\u4EA7\u7269\u76EE\u5F55:${join16(".testpilot", "artifacts", "runs", summary.runId)}`);
-    console.log("\u67E5\u770B\u62A5\u544A:npx csspilot report");
-    if (summary.status === "failed") process.exitCode = 1;
   });
 }
 function consoleEventHandler(event) {
   switch (event.type) {
+    case "run-started":
+      console.log(`\u8FD0\u884C ${event.totalCases} \u4E2A\u7528\u4F8B
+`);
+      break;
     case "case-started":
       console.log(`\u25B6 ${event.caseId} (${event.file})`);
       break;
@@ -31712,49 +32478,117 @@ function consoleEventHandler(event) {
   }
 }
 
+// src/commands/sync-metadata.ts
+import { relative } from "node:path";
+function makeSyncMetadataCommand() {
+  return new Command("sync-metadata").description("\u540C\u6B65 Case Metadata \u5FEB\u7167\u5230 TestPilot Server(CI / git push \u540E\u4F7F\u7528)").option("--server <url>", "TestPilot Server \u5730\u5740(\u9ED8\u8BA4\u53D6 project.json \u6216 testpilot.yaml)").action(async (options) => {
+    const client = new TestPilotClient();
+    const link = await client.getProjectLink();
+    if (!link) {
+      console.error("\u672A\u627E\u5230 .testpilot/project.json(\u5148\u8FD0\u884C npx csspilot init \u5173\u8054\u9879\u76EE)");
+      process.exitCode = 1;
+      return;
+    }
+    const config2 = await client.getConfig().catch(() => void 0);
+    const serverUrl = options.server ?? process.env.TESTPILOT_SERVER_URL ?? link.serverUrl ?? config2?.server?.baseUrl;
+    if (!serverUrl) {
+      console.error("\u672A\u914D\u7F6E TestPilot Server \u5730\u5740(testpilot.yaml server.baseUrl \u6216 TESTPILOT_SERVER_URL)");
+      process.exitCode = 1;
+      return;
+    }
+    const git = await readGitInfo(process.cwd());
+    if (!git.commit || !git.branch) {
+      console.error("\u5F53\u524D\u76EE\u5F55\u4E0D\u662F Git \u4ED3\u5E93(\u6216\u6CA1\u6709\u4EFB\u4F55\u63D0\u4EA4);sync-metadata \u4EE5 Git Commit \u4E3A\u540C\u6B65\u5355\u5143");
+      process.exitCode = 1;
+      return;
+    }
+    const infos = await client.listCases();
+    const cases = infos.filter((item) => item.valid && item.case).map((item) => ({
+      id: item.case.id,
+      title: item.case.name,
+      file: relative(process.cwd(), item.file).split("\\").join("/"),
+      tags: item.case.tags ?? []
+    }));
+    const skipped = infos.length - cases.length;
+    const numericId = /(\d+)$/.exec(link.projectId ?? "")?.[1];
+    if (!numericId) {
+      console.error(
+        `\u9879\u76EE\u5173\u8054 ${link.projectId} \u4E0D\u662F Server \u6CE8\u518C\u7684\u9879\u76EE(\u672C\u5730\u6A21\u5F0F);\u8BF7\u91CD\u65B0\u8FD0\u884C npx csspilot init \u5E76\u914D\u7F6E server.baseUrl`
+      );
+      process.exitCode = 1;
+      return;
+    }
+    try {
+      const res = await fetch(
+        `${serverUrl.replace(/\/$/, "")}/api/projects/${numericId}/cases/sync`,
+        {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            repository: git.repositoryUrl,
+            branch: git.branch,
+            commit: git.commit,
+            cases
+          })
+        }
+      );
+      if (!res.ok) {
+        throw new Error(`${res.status} ${(await res.text()).slice(0, 200)}`);
+      }
+      const result = await res.json();
+      console.log(`\u2713 \u5DF2\u540C\u6B65 ${serverUrl}`);
+      console.log(`  \u5206\u652F/\u63D0\u4EA4:${result.branch} \xB7 ${result.commit.slice(0, 7)}`);
+      console.log(
+        `  \u65B0\u589E ${result.added} \xB7 \u66F4\u65B0 ${result.updated} \xB7 \u5220\u9664 ${result.deleted},\u5F53\u524D active \u5171 ${result.activeTotal} \u4E2A`
+      );
+      if (skipped > 0) console.log(`  (\u8DF3\u8FC7 ${skipped} \u4E2A\u6821\u9A8C\u5931\u8D25\u7684\u7528\u4F8B\u6587\u4EF6)`);
+    } catch (err) {
+      console.error(`\u2717 \u540C\u6B65\u5931\u8D25:${err instanceof Error ? err.message : err}`);
+      process.exitCode = 1;
+    }
+  });
+}
+
 // src/commands/validate.ts
-import { readFile as readFile6 } from "node:fs/promises";
 function makeValidateCommand() {
   return new Command("validate").description("\u6821\u9A8C\u7528\u4F8B DSL").argument("[paths...]", "\u7528\u4F8B\u6587\u4EF6\u6216\u76EE\u5F55,\u9ED8\u8BA4\u6309\u9879\u76EE\u914D\u7F6E").action(async (paths) => {
-    const config2 = await loadTestpilotConfig().catch((err) => {
+    const client = new TestPilotClient();
+    const infos = await client.listCases(paths).catch((err) => {
       console.error(err.message);
       process.exitCode = 1;
       return void 0;
     });
-    if (!config2) return;
-    const inputs = paths && paths.length > 0 ? paths : [config2.casesDir];
-    const files = await collectCaseFiles(inputs);
-    if (files.length === 0) {
-      console.error(`\u672A\u627E\u5230\u7528\u4F8B\u6587\u4EF6(\u67E5\u627E:${inputs.join(", ")})`);
+    if (!infos) return;
+    if (infos.length === 0) {
+      console.error(`\u672A\u627E\u5230\u7528\u4F8B\u6587\u4EF6(\u67E5\u627E:${(paths ?? []).join(", ") || "\u9879\u76EE\u914D\u7F6E\u7684 casesDir"})`);
       console.error("\u63D0\u793A:\u5148\u8FD0\u884C npx csspilot init \u63A5\u5165 TestPilot");
       process.exitCode = 1;
       return;
     }
     let failed = 0;
-    for (const file2 of files) {
-      const source = await readFile6(file2, "utf8");
-      const result = validateCaseSource(source);
-      if (result.ok) {
-        console.log(`\u2713 ${result.data?.id ?? "(unknown)"}  ${file2}`);
+    for (const item of infos) {
+      if (item.valid) {
+        console.log(`\u2713 ${item.case?.id ?? "(unknown)"}  ${item.file}`);
       } else {
         failed++;
-        console.log(`\u2717 ${file2}`);
-        for (const issue2 of result.issues) {
+        console.log(`\u2717 ${item.file}`);
+        for (const issue2 of item.issues) {
           const prefix = issue2.code === "yaml" ? "" : `${issue2.path}: `;
           console.log(`    - ${prefix}${issue2.message}`);
         }
       }
     }
     console.log("");
-    console.log(`${files.length - failed}/${files.length} \u4E2A\u7528\u4F8B\u901A\u8FC7\u6821\u9A8C`);
+    console.log(`${infos.length - failed}/${infos.length} \u4E2A\u7528\u4F8B\u901A\u8FC7\u6821\u9A8C`);
     if (failed > 0) process.exitCode = 1;
   });
 }
 
 // src/cli.ts
+var CLI_VERSION = "0.2.0";
 async function createCli() {
   const program2 = new Command();
-  program2.name("csspilot").description("TestPilot \u2014 AI Native \u8DE8\u7AEF\u4E1A\u52A1\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD").version("0.1.0").addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeDoctorCommand());
+  program2.name("csspilot").description("TestPilot \u2014 AI Native \u8DE8\u7AEF\u4E1A\u52A1\u6D4B\u8BD5\u57FA\u7840\u8BBE\u65BD CLI").version(CLI_VERSION).addCommand(makeInitCommand()).addCommand(makeValidateCommand()).addCommand(makeListCommand()).addCommand(makeRunCommand()).addCommand(makeReportCommand()).addCommand(makeSyncMetadataCommand()).addCommand(makeDoctorCommand()).addCommand(makeCiCommand());
   return program2;
 }