csspilot 0.6.0 → 0.7.0

package/dist/index.js

@@ -8102,7 +8102,7 @@ var require_composer = __commonJS({
     var node_process = __require("process");
     var directives = require_directives();
     var Document = require_Document();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var identity = require_identity();
     var composeDoc = require_compose_doc();
     var resolveEnd = require_resolve_end();
@@ -8149,9 +8149,9 @@ var require_composer = __commonJS({
         this.onError = (source, code, message, warning) => {
           const pos = getErrorPos(source);
           if (warning)
-            this.warnings.push(new errors.YAMLWarning(pos, code, message));
+            this.warnings.push(new errors2.YAMLWarning(pos, code, message));
           else
-            this.errors.push(new errors.YAMLParseError(pos, code, message));
+            this.errors.push(new errors2.YAMLParseError(pos, code, message));
         };
         this.directives = new directives.Directives({ version: options.version || "1.2" });
         this.options = options;
@@ -8249,7 +8249,7 @@ ${cb}` : comment;
             break;
           case "error": {
             const msg = token.source ? `${token.message}: ${JSON.stringify(token.source)}` : token.message;
-            const error62 = new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
+            const error62 = new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg);
             if (this.atDirectives || !this.doc)
               this.errors.push(error62);
             else
@@ -8259,7 +8259,7 @@ ${cb}` : comment;
           case "doc-end": {
             if (!this.doc) {
               const msg = "Unexpected doc-end without preceding document";
-              this.errors.push(new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
+              this.errors.push(new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", msg));
               break;
             }
             this.doc.directives.docEnd = true;
@@ -8274,7 +8274,7 @@ ${end.comment}` : end.comment;
             break;
           }
           default:
-            this.errors.push(new errors.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
+            this.errors.push(new errors2.YAMLParseError(getErrorPos(token), "UNEXPECTED_TOKEN", `Unsupported token ${token.type}`));
         }
       }
       /**
@@ -8309,7 +8309,7 @@ var require_cst_scalar = __commonJS({
     "use strict";
     var resolveBlockScalar = require_resolve_block_scalar();
     var resolveFlowScalar = require_resolve_flow_scalar();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var stringifyString = require_stringifyString();
     function resolveAsScalar(token, strict = true, onError) {
       if (token) {
@@ -8318,7 +8318,7 @@ var require_cst_scalar = __commonJS({
           if (onError)
             onError(offset, code, message);
           else
-            throw new errors.YAMLParseError([offset, offset + 1], code, message);
+            throw new errors2.YAMLParseError([offset, offset + 1], code, message);
         };
         switch (token.type) {
           case "scalar":
@@ -10213,7 +10213,7 @@ var require_public_api = __commonJS({
     "use strict";
     var composer = require_composer();
     var Document = require_Document();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var log = require_log();
     var identity = require_identity();
     var lineCounter = require_line_counter();
@@ -10230,8 +10230,8 @@ var require_public_api = __commonJS({
       const docs = Array.from(composer$1.compose(parser$1.parse(source)));
       if (prettyErrors && lineCounter2)
         for (const doc of docs) {
-          doc.errors.forEach(errors.prettifyError(source, lineCounter2));
-          doc.warnings.forEach(errors.prettifyError(source, lineCounter2));
+          doc.errors.forEach(errors2.prettifyError(source, lineCounter2));
+          doc.warnings.forEach(errors2.prettifyError(source, lineCounter2));
         }
       if (docs.length > 0)
         return docs;
@@ -10246,13 +10246,13 @@ var require_public_api = __commonJS({
         if (!doc)
           doc = _doc;
         else if (doc.options.logLevel !== "silent") {
-          doc.errors.push(new errors.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
+          doc.errors.push(new errors2.YAMLParseError(_doc.range.slice(0, 2), "MULTIPLE_DOCS", "Source contains multiple documents; please use YAML.parseAllDocuments()"));
           break;
         }
       }
       if (prettyErrors && lineCounter2) {
-        doc.errors.forEach(errors.prettifyError(source, lineCounter2));
-        doc.warnings.forEach(errors.prettifyError(source, lineCounter2));
+        doc.errors.forEach(errors2.prettifyError(source, lineCounter2));
+        doc.warnings.forEach(errors2.prettifyError(source, lineCounter2));
       }
       return doc;
     }
@@ -10311,7 +10311,7 @@ var require_dist = __commonJS({
     var composer = require_composer();
     var Document = require_Document();
     var Schema = require_Schema();
-    var errors = require_errors();
+    var errors2 = require_errors();
     var Alias = require_Alias();
     var identity = require_identity();
     var Pair = require_Pair();
@@ -10327,9 +10327,9 @@ var require_dist = __commonJS({
     exports.Composer = composer.Composer;
     exports.Document = Document.Document;
     exports.Schema = Schema.Schema;
-    exports.YAMLError = errors.YAMLError;
-    exports.YAMLParseError = errors.YAMLParseError;
-    exports.YAMLWarning = errors.YAMLWarning;
+    exports.YAMLError = errors2.YAMLError;
+    exports.YAMLParseError = errors2.YAMLParseError;
+    exports.YAMLWarning = errors2.YAMLWarning;
     exports.Alias = Alias.Alias;
     exports.isAlias = identity.isAlias;
     exports.isCollection = identity.isCollection;
@@ -10462,6 +10462,28 @@ var TestPilotError = class extends Error {
   }
 };
 
+// ../../packages/core/src/verdict.ts
+var INFRA_CODES = /* @__PURE__ */ new Set([
+  "ENVIRONMENT_UNAVAILABLE",
+  "ADAPTER_NOT_FOUND",
+  "UNSUPPORTED_ACTION",
+  "FIXTURE_MISSING",
+  "ACCOUNT_UNAVAILABLE",
+  "CONFIG_MISSING"
+]);
+var UNVERIFIED_CODES = /* @__PURE__ */ new Set(["PREREQ_VARIABLE_MISSING"]);
+function verdictFromErrorCode(code) {
+  if (code !== void 0 && INFRA_CODES.has(code)) return "infra";
+  if (code !== void 0 && UNVERIFIED_CODES.has(code)) return "unverified";
+  return "product";
+}
+function caseStatusFromErrorCode(code) {
+  const verdict = verdictFromErrorCode(code);
+  if (verdict === "infra") return "blocked";
+  if (verdict === "unverified") return "inconclusive";
+  return "failed";
+}
+
 // ../../packages/core/src/constants/index.ts
 import { join as join2 } from "node:path";
 var TESTPILOT_DIR = ".testpilot";
@@ -30716,6 +30738,9 @@ async function loadCaseDataFile(reference, options) {
   const [realDataDir, realTarget] = await Promise.all([
     realpath(dataDir).catch(() => dataDir),
     realpath(target).catch((error62) => {
+      if (error62 instanceof Error && error62.code === "ENOENT") {
+        throw new TestPilotError("FIXTURE_MISSING", `\u6570\u636E\u6587\u4EF6\u4E0D\u5B58\u5728:${reference}`);
+      }
       throw new Error(
         `\u8BFB\u53D6\u6570\u636E\u6587\u4EF6\u5931\u8D25:${reference}:${error62 instanceof Error ? error62.message : String(error62)}`
       );
@@ -30943,6 +30968,9 @@ async function validateCaseDataSource(source, file2, root) {
     );
     return validation;
   } catch (error62) {
+    if (error62 instanceof TestPilotError && error62.code === "FIXTURE_MISSING") {
+      return validation;
+    }
     return {
       ok: false,
       data: validation.data,
@@ -30991,6 +31019,24 @@ function classifyFailure(message) {
   }
   return "other";
 }
+var CODE_CATEGORIES = {
+  ASSERTION_FAILED: "assert",
+  REQUEST_COUNT_MISMATCH: "assert",
+  STATUS_MISMATCH: "assert",
+  STEP_TIMEOUT: "assert",
+  ELEMENT_NOT_FOUND: "element",
+  ADAPTER_NOT_FOUND: "adapter",
+  UNSUPPORTED_ACTION: "adapter",
+  CONFIG_MISSING: "adapter",
+  ENVIRONMENT_UNAVAILABLE: "env",
+  FIXTURE_MISSING: "env",
+  ACCOUNT_UNAVAILABLE: "env",
+  PREREQ_VARIABLE_MISSING: "other"
+};
+function classifyFromCode(code) {
+  if (code === void 0) return void 0;
+  return CODE_CATEGORIES[code];
+}
 
 // ../../packages/reporter/src/history.ts
 import { readFile as readFile5, readdir as readdir2 } from "node:fs/promises";
@@ -31048,7 +31094,7 @@ async function writeReports(runDir, summary, options = {}) {
   const cases = summary.cases.map((item) => {
     const categories = /* @__PURE__ */ new Set();
     const steps = item.steps.map((step) => {
-      const category = step.status === "failed" ? classifyFailure(step.error) : void 0;
+      const category = classifyFromCode(step.errorCode) ?? (step.status === "failed" ? classifyFailure(step.error) : void 0);
       if (category) {
         categories.add(category);
         failures.push({
@@ -31056,7 +31102,8 @@ async function writeReports(runDir, summary, options = {}) {
           label: categoryLabel(category),
           caseId: item.caseId,
           index: step.index,
-          message: step.error ?? ""
+          message: step.error ?? "",
+          verdict: verdictFromErrorCode(step.errorCode ?? item.errorCode)
         });
       }
       return { ...step, category };
@@ -31079,6 +31126,20 @@ async function writeReports(runDir, summary, options = {}) {
   await writeFile4(htmlPath, renderHtml(data), "utf8");
   return { json: jsonPath, html: htmlPath };
 }
+var VERDICT_GROUPS = [
+  { verdict: "product", title: "\u4EA7\u54C1\u5931\u8D25" },
+  { verdict: "infra", title: "\u73AF\u5883\u4E0E\u524D\u7F6E(\u975E\u4EA7\u54C1\u56DE\u5F52)" },
+  { verdict: "unverified", title: "\u672A\u9A8C\u8BC1" }
+];
+function verdictGroupsHtml(data) {
+  return VERDICT_GROUPS.map((group) => {
+    const items = data.failures.filter((failure2) => failure2.verdict === group.verdict);
+    const list = items.length > 0 ? items.map(
+      (failure2) => `<li><code>${escapeHtml(failure2.caseId)}</code> #${failure2.index} ${escapeHtml(failure2.message.slice(0, 160))}</li>`
+    ).join("\n") : '<li class="muted">\u65E0</li>';
+    return `<div class="verdict-group"><h3>${escapeHtml(group.title)}(${items.length})</h3><ul>${list}</ul></div>`;
+  }).join("\n");
+}
 function categoryChips(data) {
   const counts = /* @__PURE__ */ new Map();
   for (const failure2 of data.failures) {
@@ -31104,19 +31165,20 @@ function renderHtml(data) {
   const trendSvg = renderTrend(data);
   const casesHtml = groupedCasesHtml(summary.cases);
   const chips = categoryChips(data);
+  const verdictHtml = verdictGroupsHtml(data);
   return `<!doctype html>
 <html lang="zh-CN">
 <head>
 <meta charset="utf-8" />
 <title>TestPilot Report ${escapeHtml(summary.runId)}</title>
 <style>
-  :root { --ok:#1a7f37; --fail:#cf222e; --warn:#9a6700; --skip:#6e7781; --line:#d0d7de; --muted:#59636e; }
+  :root { --ok:#1a7f37; --fail:#cf222e; --warn:#9a6700; --skip:#6e7781; --blocked:#8250df; --inconclusive:#9a6700; --line:#d0d7de; --muted:#59636e; }
   * { box-sizing: border-box; }
   body { font-family: system-ui, "Segoe UI", sans-serif; margin: 0; color: #1f2328; background: #f6f8fa; }
   .wrap { max-width: 1080px; margin: 0 auto; padding: 20px 16px 48px; }
   h1 { font-size: 20px; margin: 8px 0; } h2 { font-size: 15px; margin: 24px 0 8px; }
   .badge { display: inline-block; padding: 2px 10px; border-radius: 10px; color: #fff; font-size: 12px; }
-  .passed { background: var(--ok); } .failed { background: var(--fail); } .warning { background: var(--warn); } .skipped { background: var(--skip); }
+  .passed { background: var(--ok); } .failed { background: var(--fail); } .warning { background: var(--warn); } .skipped { background: var(--skip); } .blocked { background: var(--blocked); } .inconclusive { background: var(--inconclusive); }
   code { background: #eef1f4; padding: 1px 5px; border-radius: 4px; font-size: 12px; }
   .cards { display: flex; gap: 12px; flex-wrap: wrap; margin: 14px 0; }
   .card { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 10px 16px; min-width: 130px; }
@@ -31143,6 +31205,11 @@ function renderHtml(data) {
   .muted { color: var(--muted); }
   .hide { display: none !important; }
   .meta { color: var(--muted); font-size: 12px; margin: 6px 0; }
+  .verdicts { display: flex; gap: 14px; flex-wrap: wrap; }
+  .verdict-group { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 10px 14px; flex: 1; min-width: 220px; }
+  .verdict-group h3 { font-size: 13px; margin: 0 0 6px; }
+  .verdict-group ul { margin: 0; padding-left: 18px; font-size: 12px; }
+  .verdict-group li { margin: 3px 0; }
 </style>
 </head>
 <body>
@@ -31163,6 +31230,9 @@ function renderHtml(data) {
   <h2>\u5386\u53F2\u8D8B\u52BF(\u6700\u8FD1 ${data.history.length + 1} \u6B21\u8FD0\u884C)</h2>
   <div class="trend">${trendSvg}</div>
 
+  <h2>\u5931\u8D25\u4E09\u6876</h2>
+  <div class="verdicts">${verdictHtml}</div>
+
   <h2>\u5931\u8D25\u5206\u7C7B</h2>
   <div class="toolbar" id="cat-chips">${chips}</div>
 
@@ -31371,7 +31441,7 @@ function buildSummaryData(runs) {
     for (const item of summary.cases) {
       const platforms = [...new Set(item.steps.map((step) => step.target))];
       const failedStep = item.steps.find((step) => step.status === "failed");
-      const category = item.status === "failed" ? classifyFailure(failedStep?.error) : void 0;
+      const category = classifyFromCode(item.errorCode ?? failedStep?.errorCode) ?? (item.status === "failed" ? classifyFailure(failedStep?.error) : void 0);
       executions.push({
         runId,
         caseId: item.caseId,
@@ -31434,6 +31504,10 @@ function buildSummaryData(runs) {
   })).filter((item) => item.count > 0);
   const durations = runs.map((item) => item.summary.durationMs).filter((value) => typeof value === "number");
   return {
+    buckets: {
+      blocked: executions.filter((exec2) => exec2.status === "blocked").length,
+      inconclusive: executions.filter((exec2) => exec2.status === "inconclusive").length
+    },
     window: {
       runs: runs.length,
       from: runPoints[0]?.startedAt,
@@ -31518,7 +31592,7 @@ function renderSummaryHtml(data) {
   th.num, td.num { text-align: right; }
   code { background: #eef1f4; padding: 1px 5px; border-radius: 4px; font-size: 12px; cursor: pointer; }
   .badge { display: inline-block; padding: 1px 9px; border-radius: 10px; color: #fff; font-size: 11px; }
-  .passed { background: #1a7f37; } .failed { background: #cf222e; } .unknown { background: #6e7781; }
+  .passed { background: #1a7f37; } .failed { background: #cf222e; } .unknown { background: #6e7781; } .blocked { background: #8250df; } .inconclusive { background: #9a6700; }
   .toolbar { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin: 10px 0; }
   .chip { border: 1px solid var(--line); background: #fff; border-radius: 14px; padding: 3px 12px; font-size: 12px; cursor: pointer; }
   .chip.active { background: #0969da; color: #fff; border-color: #0969da; }
@@ -31544,6 +31618,8 @@ function renderSummaryHtml(data) {
     <div class="card"><b>${rateText}</b><span>\u6574\u4F53\u901A\u8FC7\u7387</span></div>
     <div class="card"><b>${(kpis.avgDurationMs / 1e3).toFixed(1)}s</b><span>\u5E73\u5747\u8FD0\u884C\u8017\u65F6</span></div>
     <div class="card"><b>${kpis.flakyCount}</b><span>Flaky \u7528\u4F8B</span></div>
+    ${data.buckets.blocked > 0 ? `<div class="card"><b>${data.buckets.blocked} \u2298</b><span>\u73AF\u5883/\u524D\u7F6E\u963B\u585E(\u975E\u4EA7\u54C1)</span></div>` : ""}
+    ${data.buckets.inconclusive > 0 ? `<div class="card"><b>${data.buckets.inconclusive} ?</b><span>\u672A\u9A8C\u8BC1(\u8BC1\u636E\u4E0D\u8DB3)</span></div>` : ""}
   </div>
 
   <h2>\u8D8B\u52BF(\u6BCF\u6B21\u8FD0\u884C\u7ED3\u679C\u4E0E\u901A\u8FC7\u7387,\u60AC\u6D6E\u770B\u8BE6\u60C5)</h2>
@@ -31752,14 +31828,23 @@ var ExecutionContext = class {
     }
   }
   /**
-   * 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用保持原样(校验阶段已拦截)。
-   * 名字允许点号,用于引擎注入的 account.username 一类凭据变量(用户 extract 变量名不含点号)。
+   * 将字符串中的 ${name} 替换为已提取的变量值;未定义的引用抛 TestPilotError——
+   * 校验阶段已静态拦截"从未声明"的引用,运行时未命中即数据未兑现
+   * (前置 extract 未执行或 fixture/dataset/凭据缺失),按三态归 unverified/account 桶。
+   * 凭据桶仅限 `account` 整值或 `account.*` 字段;用户变量撞 account 前缀(如 accountId)
+   * 不误归凭据桶。名字允许点号,用于引擎注入的 account.username 一类凭据变量
+   * (用户 extract 变量名不含点号)。
    */
   resolve(template) {
-    return template.replace(
-      /\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g,
-      (match, name) => this.variables.get(name) ?? match
-    );
+    return template.replace(/\$\{([A-Za-z_][A-Za-z0-9_.]*)\}/g, (_match, name) => {
+      const value = this.variables.get(name);
+      if (value !== void 0) return value;
+      const isAccount = name === "account" || name.startsWith("account.");
+      throw new TestPilotError(
+        isAccount ? "ACCOUNT_UNAVAILABLE" : "PREREQ_VARIABLE_MISSING",
+        `\u53D8\u91CF "${name}" \u672A\u5B9A\u4E49(\u524D\u7F6E extract \u672A\u6267\u884C\u6216 fixture/dataset/\u51ED\u636E\u7F3A\u5931)`
+      );
+    });
   }
   /**
    * 注入 accountRef 凭据:值为 JSON 对象时按 `${account.<字段>}` 展开为字符串,
@@ -31918,7 +32003,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
     } : void 0;
     if (step.expectRequests) {
       if (!adapter.startRequestCapture || !adapter.stopRequestCapture) {
-        throw new Error(`\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301\u8BF7\u6C42\u6B21\u6570\u65AD\u8A00`);
+        throw new TestPilotError("UNSUPPORTED_ACTION", `\u5F53\u524D ${step.target} adapter \u4E0D\u652F\u6301\u8BF7\u6C42\u6B21\u6570\u65AD\u8A00`);
       }
       await adapter.startRequestCapture();
       captureStarted = true;
@@ -31944,7 +32029,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         break;
       case "assert":
         if (step.target === "api") {
-          if (!adapter.assertResponse) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u65AD\u8A00");
+          if (!adapter.assertResponse) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u65AD\u8A00");
           await adapter.assertResponse(context.resolve(step.expected ?? ""));
         } else {
           await adapter.assert(locator, context.resolve(step.expected ?? ""));
@@ -31964,7 +32049,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         break;
       }
       case "request": {
-        if (!adapter.request) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api request");
+        if (!adapter.request) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api request");
         const method = step.method ?? "GET";
         const url2 = context.resolve(step.url ?? "");
         const headers = resolveHeaders(step.headers, context);
@@ -31981,7 +32066,8 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
         if (step.expected !== void 0) {
           const expectedStatus = context.resolve(step.expected);
           if (String(response.status) !== expectedStatus) {
-            throw new Error(
+            throw new TestPilotError(
+              "STATUS_MISMATCH",
               `HTTP \u72B6\u6001\u7801 ${response.status} ${response.statusText},\u671F\u671B ${expectedStatus}:${snippet(response.bodyText, 200)}`
             );
           }
@@ -31990,7 +32076,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
       }
       default: {
         const exhaustive = step.action;
-        throw new Error(`\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
+        throw new TestPilotError("UNSUPPORTED_ACTION", `\u4E0D\u652F\u6301\u7684 action:${String(exhaustive)}`);
       }
     }
     if (step.expectRequests) {
@@ -32001,7 +32087,8 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
       result.requestAssertions = buildRequestAssertions(step, requests, context);
       const mismatches = result.requestAssertions.filter((item) => item.actualCount !== item.count);
       if (mismatches.length > 0) {
-        throw new Error(
+        throw new TestPilotError(
+          "REQUEST_COUNT_MISMATCH",
           mismatches.map(
             (item) => `\u8BF7\u6C42\u6B21\u6570\u4E0D\u5339\u914D:${item.method ?? "*"} ${item.urlContains},\u5B9E\u9645 ${item.actualCount},\u671F\u671B ${item.count}`
           ).join("; ")
@@ -32018,6 +32105,7 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
     }
     result.status = "failed";
     result.error = err instanceof Error ? err.message : String(err);
+    result.errorCode = err instanceof TestPilotError ? err.code : void 0;
     try {
       const data = await adapter.screenshot();
       result.screenshot = await artifacts.saveStepScreenshot(`${options.screenshotName}-failed.png`, data);
@@ -32028,8 +32116,8 @@ async function executeStep(step, index, adapter, context, artifacts, options) {
   return result;
 }
 async function extractApiResponse(adapter, path) {
-  if (!adapter.extractResponse) throw new Error("\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u63D0\u53D6");
-  if (!path) throw new Error("api \u7AEF extract \u9700\u8981\u63D0\u4F9B value(\u70B9\u53F7 JSON path)");
+  if (!adapter.extractResponse) throw new TestPilotError("UNSUPPORTED_ACTION", "\u5F53\u524D adapter \u4E0D\u652F\u6301 api \u63D0\u53D6");
+  if (!path) throw new TestPilotError("UNSUPPORTED_ACTION", "api \u7AEF extract \u9700\u8981\u63D0\u4F9B value(\u70B9\u53F7 JSON path)");
   return adapter.extractResponse(path);
 }
 function resolveHeaders(headers, context) {
@@ -32103,6 +32191,7 @@ var ExecutionEngine = class {
     const warnings = [];
     const evidenceAdapters = /* @__PURE__ */ new Map();
     let caseError;
+    let caseErrorCode;
     const executionId = safeArtifactName(`${data.id}-${rowId}`);
     await bus.emit({
       type: "case-started",
@@ -32180,7 +32269,8 @@ var ExecutionEngine = class {
             action: step.action,
             status: "failed",
             durationMs: 0,
-            error: err instanceof Error ? err.message : String(err)
+            error: err instanceof Error ? err.message : String(err),
+            errorCode: err instanceof TestPilotError ? err.code : void 0
           };
         }
         result.phase = phase;
@@ -32209,6 +32299,7 @@ var ExecutionEngine = class {
         if (result.status === "failed") {
           passed = false;
           caseError = result.error;
+          caseErrorCode = result.errorCode;
           for (const [skipIndex, skippedStep] of phaseSteps.entries()) {
             if (skipIndex <= index) continue;
             steps.push({
@@ -32225,24 +32316,42 @@ var ExecutionEngine = class {
       }
       return passed;
     };
-    const setupPassed = await runPhase("setup", data.setup ?? []);
-    if (setupPassed) {
-      await runPhase("steps", data.steps);
-    } else {
-      for (const [index, step] of data.steps.entries()) {
+    if (options.blockedError) {
+      const first = data.setup?.[0] ?? data.steps[0];
+      if (first) {
         steps.push({
-          index,
-          phase: "steps",
-          target: step.target,
-          action: step.action,
-          status: "skipped",
-          durationMs: 0
+          index: 0,
+          phase: "setup",
+          target: first.target,
+          action: first.action,
+          status: "failed",
+          durationMs: 0,
+          error: options.blockedError.message,
+          errorCode: options.blockedError.code
         });
       }
+      caseError = options.blockedError.message;
+      caseErrorCode = options.blockedError.code;
+    } else {
+      const setupPassed = await runPhase("setup", data.setup ?? []);
+      if (setupPassed) {
+        await runPhase("steps", data.steps);
+      } else {
+        for (const [index, step] of data.steps.entries()) {
+          steps.push({
+            index,
+            phase: "steps",
+            target: step.target,
+            action: step.action,
+            status: "skipped",
+            durationMs: 0
+          });
+        }
+      }
+      await runPhase("teardown", data.teardown ?? []);
     }
-    await runPhase("teardown", data.teardown ?? []);
     const finishedAt = /* @__PURE__ */ new Date();
-    const status = caseError ? "failed" : "passed";
+    const status = caseError ? caseStatusFromErrorCode(caseErrorCode) : "passed";
     const caseResult = {
       caseId: data.id,
       caseName: data.name,
@@ -32256,6 +32365,7 @@ var ExecutionEngine = class {
       durationMs: finishedAt.getTime() - startedAt.getTime()
     };
     if (caseError) caseResult.error = caseError;
+    if (caseErrorCode) caseResult.errorCode = caseErrorCode;
     if (warnings.length > 0) caseResult.warnings = warnings;
     for (const [target, adapter] of evidenceAdapters) {
       if (!adapter.stopEvidence) continue;
@@ -32299,6 +32409,8 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
     passed: cases.filter((item) => item.status === "passed").length,
     failed: cases.filter((item) => item.status === "failed").length,
     skipped: cases.filter((item) => item.status === "skipped").length,
+    ...cases.some((item) => item.status === "blocked") ? { blocked: cases.filter((item) => item.status === "blocked").length } : {},
+    ...cases.some((item) => item.status === "inconclusive") ? { inconclusive: cases.filter((item) => item.status === "inconclusive").length } : {},
     warnings: 0,
     steps: 0,
     stepsPassed: 0,
@@ -32323,7 +32435,8 @@ function buildRunSummary(runId, startedAt, cases, options = {}) {
     startedAt: startedAt.toISOString(),
     finishedAt: finishedAt.toISOString(),
     durationMs: finishedAt.getTime() - startedAt.getTime(),
-    status: totals.failed > 0 ? "failed" : totals.passed > 0 || totals.cases === 0 ? "passed" : "skipped",
+    // run 状态按三桶优先级推导:产品失败 > 证据不足 > 环境阻塞 > 通过 > 跳过
+    status: totals.failed > 0 ? "failed" : (totals.inconclusive ?? 0) > 0 ? "inconclusive" : (totals.blocked ?? 0) > 0 ? "blocked" : totals.passed > 0 || totals.cases === 0 ? "passed" : "skipped",
     ...options.cancelled ? { cancelled: true } : {},
     cases,
     totals
@@ -32375,6 +32488,7 @@ var TestRunner = class {
           rowIndex: item.rowIndex ?? 0,
           initialVariables: item.initialVariables ?? {},
           missingDependencies: item.missingDependencies ?? [],
+          blockedError: item.blockedError,
           artifacts,
           bus,
           resolver: this.resolver,
@@ -32431,6 +32545,7 @@ import { existsSync as existsSync3 } from "node:fs";
 import { mkdtemp, readFile as readFile6, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join as join16 } from "node:path";
+import { errors } from "playwright";
 var PlaywrightAdapter = class {
   constructor(bundle, options = {}) {
     this.bundle = bundle;
@@ -32487,36 +32602,50 @@ var PlaywrightAdapter = class {
     const options = this.options;
     const page = await this.ensurePage();
     const target = options.baseUrl && !/^https?:\/\//i.test(url2) ? new URL(url2, options.baseUrl).toString() : url2;
-    await page.goto(target);
+    try {
+      await page.goto(target);
+    } catch (err) {
+      if (err instanceof errors.TimeoutError) {
+        throw new TestPilotError("STEP_TIMEOUT", err.message, { cause: err });
+      }
+      if (err instanceof Error && err.message.includes("net::ERR")) {
+        throw new TestPilotError("ENVIRONMENT_UNAVAILABLE", err.message, { cause: err });
+      }
+      throw err;
+    }
   }
   async click(locator) {
-    await (await this.toLocator(locator)).click();
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.click());
   }
   async input(locator, value) {
-    await (await this.toLocator(locator)).fill(value);
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.fill(value));
   }
   async select(locator, value) {
-    await (await this.toLocator(locator)).selectOption(value);
+    const target = await this.toLocator(locator);
+    await this.coded(() => target.selectOption(value));
   }
   async wait(locator, timeoutMs) {
     const page = await this.ensurePage();
     if (locator) {
-      await this.toLocatorOn(page, locator).waitFor({ state: "visible", timeout: timeoutMs });
+      await this.coded(() => this.toLocatorOn(page, locator).waitFor({ state: "visible", timeout: timeoutMs }));
       return;
     }
     await page.waitForTimeout(timeoutMs ?? 1e3);
   }
   async assert(locator, expected) {
     const target = await this.toLocator(locator);
-    await target.waitFor({ state: "visible" });
-    const actual = (await target.innerText()).trim();
+    await this.coded(() => target.waitFor({ state: "visible" }));
+    const actual = (await this.coded(() => target.innerText())).trim();
     const wanted = expected.trim();
     if (!actual.includes(wanted)) {
-      throw new Error(`\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
+      throw new TestPilotError("ASSERTION_FAILED", `\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
     }
   }
   async extract(locator) {
-    return (await this.toLocator(locator)).innerText().then((text) => text.trim());
+    const target = await this.toLocator(locator);
+    return this.coded(() => target.innerText()).then((text) => text.trim());
   }
   async screenshot() {
     return (await this.ensurePage()).screenshot();
@@ -32534,6 +32663,17 @@ var PlaywrightAdapter = class {
   async toLocator(locator) {
     return this.toLocatorOn(await this.ensurePage(), locator);
   }
+  /** 定位类操作的统一兜底:等待超时按「元素没等到」归类(可能是回归也可能是 selector 腐烂,不允许静默) */
+  async coded(fn) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (err instanceof errors.TimeoutError) {
+        throw new TestPilotError("ELEMENT_NOT_FOUND", err.message, { cause: err });
+      }
+      throw err;
+    }
+  }
   toLocatorOn(page, locator) {
     if (locator.text !== void 0) {
       return page.getByText(locator.text, { exact: true });
@@ -32611,12 +32751,12 @@ function startCliAuto(cliPath, projectPath, port) {
     child.stderr?.on("data", (chunk) => {
       output2 += chunk.toString("utf8");
     });
-    child.once("error", (err) => rejectPromise(new Error(`\u62C9\u8D77\u5F00\u53D1\u8005\u5DE5\u5177 cli \u5931\u8D25:${err.message}`)));
+    child.once("error", (err) => rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `\u62C9\u8D77\u5F00\u53D1\u8005\u5DE5\u5177 cli \u5931\u8D25:${err.message}`)));
     child.once("exit", (code) => {
       if (code === 0) {
         resolvePromise();
       } else {
-        rejectPromise(new Error(`cli auto \u9000\u51FA\u7801 ${code}:${output2.slice(-400)}`));
+        rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `cli auto \u9000\u51FA\u7801 ${code}:${output2.slice(-400)}`));
       }
     });
     const startedAt = Date.now();
@@ -32629,7 +32769,7 @@ function startCliAuto(cliPath, projectPath, port) {
       socket.once("error", () => {
         socket.destroy();
         if (Date.now() - startedAt > AUTO_PORT_FALLBACK_WAIT_MS) {
-          rejectPromise(new Error(`\u7B49\u5F85\u5F00\u53D1\u8005\u5DE5\u5177\u81EA\u52A8\u5316\u7AEF\u53E3 ${port} \u8D85\u65F6;\u8BF7\u786E\u8BA4:1) \u5DE5\u5177\u5DF2\u767B\u5F55 2) \u8BBE\u7F6E->\u5B89\u5168\u8BBE\u7F6E->\u670D\u52A1\u7AEF\u53E3\u5DF2\u5F00\u542F`));
+          rejectPromise(new TestPilotError("ENVIRONMENT_UNAVAILABLE", `\u7B49\u5F85\u5F00\u53D1\u8005\u5DE5\u5177\u81EA\u52A8\u5316\u7AEF\u53E3 ${port} \u8D85\u65F6;\u8BF7\u786E\u8BA4:1) \u5DE5\u5177\u5DF2\u767B\u5F55 2) \u8BBE\u7F6E->\u5B89\u5168\u8BBE\u7F6E->\u670D\u52A1\u7AEF\u53E3\u5DF2\u5F00\u542F`));
         } else {
           setTimeout(poll, 500);
         }
@@ -32678,7 +32818,7 @@ var MiniAppAdapter = class {
     await this.runWithReconnect(async () => (await this.element(locator)).input(value));
   }
   async select() {
-    throw new Error("\u5C0F\u7A0B\u5E8F\u7AEF\u6682\u4E0D\u652F\u6301 select(picker \u4EA4\u4E92),\u8BF7\u6539\u7528 click \u5B8C\u6210\u9009\u62E9");
+    throw new TestPilotError("UNSUPPORTED_ACTION", "\u5C0F\u7A0B\u5E8F\u7AEF\u6682\u4E0D\u652F\u6301 select(picker \u4EA4\u4E92),\u8BF7\u6539\u7528 click \u5B8C\u6210\u9009\u62E9");
   }
   async wait(locator, timeoutMs) {
     await this.runWithReconnect(async () => {
@@ -32696,7 +32836,7 @@ var MiniAppAdapter = class {
       const actual = (await element.text()).trim();
       const wanted = expected.trim();
       if (!actual.includes(wanted)) {
-        throw new Error(`\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
+        throw new TestPilotError("ASSERTION_FAILED", `\u65AD\u8A00\u5931\u8D25:\u671F\u671B\u5305\u542B "${wanted}",\u5B9E\u9645\u4E3A "${actual.slice(0, 200)}"`);
       }
     });
   }
@@ -32794,7 +32934,7 @@ var MiniAppAdapter = class {
       const element = await page.$(selector);
       if (element) return element;
       if (Date.now() - startedAt > ELEMENT_WAIT_MS) {
-        throw new Error(`\u7B49\u5F85\u5143\u7D20\u8D85\u65F6(${ELEMENT_WAIT_MS}ms):${selector}`);
+        throw new TestPilotError("ELEMENT_NOT_FOUND", `\u7B49\u5F85\u5143\u7D20\u8D85\u65F6(${ELEMENT_WAIT_MS}ms):${selector}`);
       }
       await delay2(500);
     }
@@ -32872,7 +33012,7 @@ var ApiAdapter = class {
         signal: AbortSignal.timeout(this.options.timeoutMs ?? 15e3)
       });
     } catch (err) {
-      throw new Error(`API \u8BF7\u6C42\u5931\u8D25 ${request.method.toUpperCase()} ${url2}:${err instanceof Error ? err.message : String(err)}`);
+      throw new TestPilotError("ENVIRONMENT_UNAVAILABLE", `API \u8BF7\u6C42\u5931\u8D25 ${request.method.toUpperCase()} ${url2}:${err instanceof Error ? err.message : String(err)}`, { cause: err });
     }
     const bodyText = await res.text();
     let json2;
@@ -32894,7 +33034,7 @@ var ApiAdapter = class {
     if (!this.last) throw new Error("\u5C1A\u672A\u53D1\u8D77\u4EFB\u4F55 API \u8BF7\u6C42,\u65E0\u6CD5\u65AD\u8A00\u54CD\u5E94");
     if (!this.last.bodyText.includes(expected)) {
       const snippet2 = this.last.bodyText.slice(0, 200);
-      throw new Error(`\u54CD\u5E94\u4F53\u4E0D\u5305\u542B "${expected}":HTTP ${this.last.status} ${snippet2}`);
+      throw new TestPilotError("ASSERTION_FAILED", `\u54CD\u5E94\u4F53\u4E0D\u5305\u542B "${expected}":HTTP ${this.last.status} ${snippet2}`);
     }
   }
   async extractResponse(path) {
@@ -33023,7 +33163,23 @@ async function runCases(options = {}) {
           variables: config2.variables,
           accounts: options.accounts
         }
-      )
+      ).catch((err) => {
+        if (err instanceof TestPilotError && err.code === "FIXTURE_MISSING") {
+          return [
+            {
+              data: item.case,
+              file: item.file,
+              templateId: item.case.id,
+              rowId: "default",
+              rowIndex: 0,
+              initialVariables: {},
+              missingDependencies: [],
+              blockedError: { code: err.code, message: err.message }
+            }
+          ];
+        }
+        throw err;
+      })
     )
   )).flat();
   const summary = await runner.run(
@@ -33989,6 +34145,11 @@ function openInBrowser(file2) {
 
 // src/commands/run.ts
 import { join as join28 } from "node:path";
+function exitCodeForSummary(status) {
+  if (status === "failed" || status === "inconclusive") return 1;
+  if (status === "blocked") return 2;
+  return 0;
+}
 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();
@@ -34010,11 +34171,11 @@ function makeRunCommand() {
       ].filter(Boolean).join(",");
       console.log("");
       console.log(
-        `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u6A21\u677F ${summary.totals.templates ?? summary.totals.cases},\u6570\u636E\u884C \u2713${summary.totals.passed} \u2717${summary.totals.failed} \u21B7${summary.totals.skipped ?? 0} \u26A0${summary.totals.warnings ?? 0},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped} \u26A0${summary.totals.stepsWarning ?? 0}${notes ? `(${notes})` : ""}`
+        `Run ${summary.runId}${summary.cancelled ? "(\u5DF2\u53D6\u6D88)" : ""}: ${summary.status.toUpperCase()} \u2014 \u6A21\u677F ${summary.totals.templates ?? summary.totals.cases},\u6570\u636E\u884C \u2713${summary.totals.passed} \u2717${summary.totals.failed} \u2298${summary.totals.blocked ?? 0} ?${summary.totals.inconclusive ?? 0} \u21B7${summary.totals.skipped ?? 0} \u26A0${summary.totals.warnings ?? 0},\u6B65\u9AA4 \u2713${summary.totals.stepsPassed} \u2717${summary.totals.stepsFailed} \u21B7${summary.totals.stepsSkipped} \u26A0${summary.totals.stepsWarning ?? 0}${notes ? `(${notes})` : ""}`
       );
       console.log(`\u4EA7\u7269\u76EE\u5F55:${join28(".testpilot", "artifacts", "runs", summary.runId)}`);
       console.log("\u67E5\u770B\u62A5\u544A:npx csspilot report");
-      if (summary.status === "failed") process.exitCode = 1;
+      process.exitCode = exitCodeForSummary(summary.status);
     } catch (err) {
       console.error(err instanceof Error ? err.message : err);
       process.exitCode = 1;
@@ -34189,7 +34350,7 @@ function makeValidateCommand() {
 }
 
 // src/cli.ts
-var CLI_VERSION = "0.6.0";
+var CLI_VERSION = "0.7.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 CLI").version(CLI_VERSION, "-v, --version", "output the current version").option("-V", "output the current version", () => {