validpilot-oss 1.1.0

package/tools/fix_verify.json

@@ -0,0 +1,13 @@
+{
+  "name": "fix_verify",
+  "description": "执行低 Token 修复验证，返回修复前后摘要对比、pass/fail、Top errors 和 artifact 路径。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "url": { "type": "string" },
+      "beforeSummary": { "type": "object" },
+      "afterSummary": { "type": "object" },
+      "timeout": { "type": "number" }
+    }
+  }
+}

package/tools/mcp_health_check.json

@@ -0,0 +1,8 @@
+{
+  "name": "mcp_health_check",
+  "description": "检查 MCP 自身健康状态：工具注册完整性、schema 合法性、证据目录可写性、当前会话和 checkpoint 状态。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  }
+}

package/tools/mcp_self_test.json

@@ -0,0 +1,12 @@
+{
+  "name": "mcp_self_test",
+  "description": "执行 MCP 自测：创建自测会话，打开 data URL，验证 flow/assert/type/click/wait/step/events/errors/trace/artifacts 基础能力。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "sessionName": { "type": "string", "description": "自测使用的会话名称，默认 mcp-self-test" },
+      "headless": { "type": "boolean", "description": "是否无头运行，默认 false" },
+      "trace": { "type": "boolean", "description": "是否录制 trace，默认 true" }
+    }
+  }
+}

package/tools/screenshot_diff.json

@@ -0,0 +1,16 @@
+{
+  "name": "screenshot_diff",
+  "description": "比较两张截图或捕获当前截图并返回差异摘要与 artifact 路径；不输出长截图描述。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "baselinePath": { "type": "string" },
+      "actualPath": { "type": "string" },
+      "beforePath": { "type": "string" },
+      "afterPath": { "type": "string" },
+      "selector": { "type": "string" },
+      "threshold": { "type": "number" },
+      "name": { "type": "string" }
+    }
+  }
+}

package/tools/validation_check.json

@@ -0,0 +1,20 @@
+{
+  "name": "validation_check",
+  "description": "执行单项浏览器健康检查：可打开 URL、等待条件、执行断言、截图留证，并统计本轮错误。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "检查名称" },
+      "url": { "type": "string", "description": "可选，检查前打开的 URL" },
+      "wait": { "type": "object", "description": "可选，browser_wait 参数" },
+      "assertions": { "type": "object", "description": "browser_assert 参数" },
+      "textContains": { "type": "string", "description": "快捷断言：页面包含文本" },
+      "selectorVisible": { "type": "string", "description": "快捷断言：元素可见" },
+      "urlContains": { "type": "string", "description": "快捷断言：URL 包含文本" },
+      "noErrors": { "type": "boolean", "description": "是否要求本轮无错误，默认 true" },
+      "clearErrors": { "type": "boolean", "description": "检查前是否清空错误 checkpoint，默认 true" },
+      "instrument": { "type": "boolean", "description": "是否注入运行时探针，默认 false" },
+      "evidence": { "type": "boolean", "description": "是否保存步骤证据，默认 true" }
+    }
+  }
+}

package/tools/validation_decision.json

@@ -0,0 +1,24 @@
+{
+  "name": "validation_decision",
+  "description": "快速止损决策系统 - 基于页面初始错误状态，1 秒内判断是否值得继续验证，避免浪费 Token。返回决策建议（STOP/WARN/CONTINUE）、置信度、预计节省 Token 比例和估算的浪费 Token 数量。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "browserErrors": {
+        "type": "object",
+        "description": "浏览器错误统计数据",
+        "properties": {
+          "pageErrorCount": { "type": "number", "description": "页面运行时错误数" },
+          "criticalJsErrors": { "type": "number", "description": "关键 JS 资源 404 错误数" },
+          "criticalCssErrors": { "type": "number", "description": "关键 CSS 资源 404 错误数" },
+          "totalCount": { "type": "number", "description": "错误总数" }
+        }
+      },
+      "format": {
+        "type": "string",
+        "description": "返回格式：json（默认）或 text",
+        "enum": ["json", "text"]
+      }
+    }
+  }
+}

package/tools/validation_element.json

@@ -0,0 +1,13 @@
+{
+  "name": "validation_element",
+  "description": "验证特定DOM元素",
+  "input_schema": {
+    "type": "object",
+    "properties": {
+      "targetUrl": {"type": "string", "description": "目标页面URL"},
+      "elementSelector": {"type": "string", "description": "元素选择器"},
+      "expectedText": {"type": "string", "description": "预期文本"}
+    },
+    "required": ["targetUrl", "elementSelector"]
+  }
+}

package/tools/validation_flow.json

@@ -0,0 +1,12 @@
+{
+  "name": "validation_flow",
+  "description": "执行完整用户流程",
+  "input_schema": {
+    "type": "object",
+    "properties": {
+      "flowType": {"type": "string", "description": "流程类型"},
+      "credentials": {"type": "object", "properties": {"email": {"type": "string"}, "password": {"type": "string"}}}
+    },
+    "required": ["flowType"]
+  }
+}

package/tools/validation_matrix.json

@@ -0,0 +1,27 @@
+{
+  "name": "validation_matrix",
+  "description": "执行角色 × 功能权限矩阵验证。每个角色使用独立 session，按功能步骤执行并检查预期允许/禁止结果，失败时自动调查并生成矩阵报告数据。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "矩阵验证名称" },
+      "roles": {
+        "type": "array",
+        "description": "角色列表，每个角色可包含 name、sessionName、url、setupSteps",
+        "items": { "type": "object" }
+      },
+      "features": {
+        "type": "array",
+        "description": "功能列表，每个功能可包含 name、steps、stepsByRole、expected、expectedByRole、assertions、assertionsByRole、focus",
+        "items": { "type": "object" }
+      },
+      "clearArtifacts": { "type": "boolean", "description": "执行前是否清理证据产物，默认 false" },
+      "clearErrors": { "type": "boolean", "description": "执行前是否清空错误 checkpoint，默认 true" },
+      "instrument": { "type": "boolean", "description": "是否注入运行时探针，默认 true" },
+      "har": { "type": "boolean", "description": "是否导出 HAR JSON，默认 true" },
+      "investigateOnFailure": { "type": "boolean", "description": "失败时是否自动 debug_investigate，默认 true" },
+      "continueOnFailure": { "type": "boolean", "description": "单元失败后是否继续执行后续功能，默认 false" }
+    },
+    "required": ["roles", "features"]
+  }
+}

package/tools/validation_quick_run.json

@@ -0,0 +1,13 @@
+{
+  "name": "validation_quick_run",
+  "description": "对单页执行低 Token 快速验证：Console、Network、PageError、DOM/ARIA/文本摘要和稳定选择器可达性，返回 pass/fail、Top errors、artifact 路径。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "url": { "type": "string" },
+      "headless": { "type": "boolean" },
+      "timeout": { "type": "number" }
+    },
+    "required": ["url"]
+  }
+}

package/tools/validation_report.json

@@ -0,0 +1,10 @@
+{
+  "name": "validation_report",
+  "description": "根据最近一次 validation_check、validation_run、validation_matrix 或 validation_suite_run 生成 Markdown/JSON 结构化验证报告。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "format": { "type": "string", "enum": ["markdown", "json"], "default": "markdown", "description": "报告格式" }
+    }
+  }
+}

package/tools/validation_report_export.json

@@ -0,0 +1,8 @@
+{
+  "name": "validation_report_export",
+  "description": "将最近一次 validation_check/run/matrix/suite 结果导出为本地静态 HTML 报告，包含摘要、结果表、失败分析和 artifacts 链接，输出到 .trae/mcp-server/reports/validation-<timestamp>.html。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {}
+  }
+}

package/tools/validation_run.json

@@ -0,0 +1,35 @@
+{
+  "name": "validation_run",
+  "description": "执行完整浏览器验收计划：自动清空错误、注入探针、录制 trace、按用例执行 browser_flow、断言、失败调查、导出 HAR，并保存证据产物。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "name": { "type": "string", "description": "验证计划名称" },
+      "cases": {
+        "type": "array",
+        "description": "测试用例列表",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string", "description": "用例名称" },
+            "sessionName": { "type": "string", "description": "该用例使用的浏览器会话名称，如 free-user、pro-user" },
+            "steps": { "type": "array", "description": "browser_flow 步骤列表" },
+            "assertions": { "type": "object", "description": "browser_assert 参数" },
+            "focus": { "type": "string", "description": "失败调查关注的接口 URL 关键字" },
+            "symptom": { "type": "string", "description": "失败时用于 debug_investigate 的症状描述" },
+            "expected": { "type": "string", "description": "期望结果" },
+            "continueOnError": { "type": "boolean", "description": "单个 flow 内步骤失败后是否继续" }
+          }
+        }
+      },
+      "clearArtifacts": { "type": "boolean", "description": "执行前是否清理截图、trace、har，默认 false" },
+      "clearErrors": { "type": "boolean", "description": "执行前是否清空错误 checkpoint，默认 true" },
+      "instrument": { "type": "boolean", "description": "是否注入运行时探针，默认 true" },
+      "trace": { "type": "boolean", "description": "是否录制 trace，默认 true" },
+      "har": { "type": "boolean", "description": "是否导出 HAR JSON，默认 true" },
+      "investigateOnFailure": { "type": "boolean", "description": "失败时是否自动调用 debug_investigate，默认 true" },
+      "continueOnFailure": { "type": "boolean", "description": "用例失败后是否继续执行后续用例，默认 false" }
+    },
+    "required": ["cases"]
+  }
+}

package/tools/validation_start.json

@@ -0,0 +1,12 @@
+{
+  "name": "validation_start",
+  "description": "启动端到端验证流程",
+  "input_schema": {
+    "type": "object",
+    "properties": {
+      "targetUrl": {"type": "string", "description": "目标验证页面URL"},
+      "testScenarios": {"type": "array", "items": {"type": "string"}, "description": "测试场景列表"}
+    },
+    "required": ["targetUrl", "testScenarios"]
+  }
+}

package/tools/validation_suite_run.json

@@ -0,0 +1,17 @@
+{
+  "name": "validation_suite_run",
+  "description": "执行验证资产套件。可通过 suite 名称读取 .trae/validations/suites/<suite>.json，或通过 file 指定 .trae/validations 内的套件文件，按顺序运行 check/run/matrix 并聚合结果。",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "suite": { "type": "string", "description": "套件名称，如 p5.5，将读取 .trae/validations/suites/p5.5.json" },
+      "file": { "type": "string", "description": "套件文件路径，必须位于 .trae/validations 内" },
+      "continueOnFailure": { "type": "boolean", "description": "覆盖套件文件中的失败后继续策略" },
+      "sessionName": { "type": "string", "description": "默认浏览器会话名称" }
+    },
+    "anyOf": [
+      { "required": ["suite"] },
+      { "required": ["file"] }
+    ]
+  }
+}