speccore 8.3.349 → 8.3.363

package/dist/core/ai-verify/result-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-parser.d.ts","sourceRoot":"","sources":["../../../src/core/ai-verify/result-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEtG,cAAc;AACd,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAK5D,CAAC;AAEF,sCAAsC;AACtC,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAS/F;AAED,gCAAgC;AAChC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,EAAE,CAG3F;AAED,cAAc;AACd,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe,GAAG,qBAAqB,CAEtG;AAED,yBAAyB;AACzB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,qBAAqB,GAAG;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAWA;AAyED,qCAAqC;AACrC,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyFxF"}

package/dist/core/ai-verify/result-parser.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * result-parser — 执行结果解析与 HTML 报告生成（v8.3.350+）
+ *
+ * 宿主 AI 执行完剧本写回 results.json，本模块负责：
+ *   1. 结构校验 + 与 plan.json 场景对齐（缺漏场景标未执行）
+ *   2. 生成 HTML 报告（复用 ui-verify 报告的视觉风格）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXECUTOR_LABELS = void 0;
+exports.parseAiVerifyResults = parseAiVerifyResults;
+exports.findMissingScenarios = findMissingScenarios;
+exports.buildReportContext = buildReportContext;
+exports.summarizeResults = summarizeResults;
+exports.generateAiVerifyReport = generateAiVerifyReport;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+/** 执行通道展示名 */
+exports.EXECUTOR_LABELS = {
+    'browser-agent': 'Browser 子代理',
+    'playwright-mcp': 'Playwright MCP',
+    'visual-judge': '视觉模型判定',
+    manual: '人工执行',
+};
+/** 解析 results.json（结构校验，非法返回 null） */
+async function parseAiVerifyResults(resultsPath) {
+    try {
+        const raw = await (0, fs_extra_1.readFile)(resultsPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || !Array.isArray(parsed.results))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** 场景对齐：找出剧本中有而结果中缺失的场景（未执行） */
+function findMissingScenarios(plan, results) {
+    const executed = new Set(results.results.map((r) => r.scenarioId));
+    return plan.scenarios.map((s) => s.id).filter((id) => !executed.has(id));
+}
+/** 组装报告上下文 */
+function buildReportContext(plan, results) {
+    return { plan, results, missing: findMissingScenarios(plan, results) };
+}
+/** 摘要统计（通过/失败/跳过/未执行） */
+function summarizeResults(ctx) {
+    const { plan, results, missing } = ctx;
+    const byId = new Map(results.results.map((r) => [r.scenarioId, r]));
+    const total = plan.scenarios.length;
+    const passed = plan.scenarios.filter((s) => byId.get(s.id)?.passed).length;
+    const failed = plan.scenarios.filter((s) => {
+        const r = byId.get(s.id);
+        return r && !r.passed && !r.skipped;
+    }).length;
+    const skipped = plan.scenarios.filter((s) => byId.get(s.id)?.skipped).length;
+    return { total, passed, failed, skipped, notRun: missing.length };
+}
+/** HTML 转义 */
+function esc(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+/** 按端分组渲染场景卡片（层内复用） */
+function renderPlatformSections(scenarios, byId) {
+    const byPlatform = new Map();
+    for (const s of scenarios) {
+        const list = byPlatform.get(s.platform) || [];
+        list.push(s);
+        byPlatform.set(s.platform, list);
+    }
+    const platformSections = [];
+    for (const [platform, list] of byPlatform) {
+        const cards = list
+            .map((s) => {
+            const r = byId.get(s.id);
+            let status;
+            let badge;
+            if (!r) {
+                status = 'notrun';
+                badge = '<span class="badge notrun">未执行</span>';
+            }
+            else if (r.skipped) {
+                status = 'skip';
+                badge = '<span class="badge skip">跳过</span>';
+            }
+            else if (r.passed) {
+                status = 'pass';
+                badge = '<span class="badge pass">通过</span>';
+            }
+            else {
+                status = 'fail';
+                badge = '<span class="badge fail">失败</span>';
+            }
+            const reason = r ? `<div class="reason">${esc(r.reason)}</div>` : '';
+            const executorLabel = r?.executor ? ` · 执行通道: ${esc(exports.EXECUTOR_LABELS[r.executor] || r.executor)}` : '';
+            const screenshots = (r?.screenshots || [])
+                .map((shot) => `<div class="shot"><img src="${esc(shot)}" onerror="this.style.display='none'" /></div>`)
+                .join('');
+            return `
+    <div class="scenario ${status}">
+      <div class="scenario-header">
+        <strong>${esc(s.title)}</strong>
+        ${badge}
+      </div>
+      <div class="scenario-body">
+        <div class="meta">${esc(s.unit)} · ${esc(s.platform)}${executorLabel} · <a href="${esc(s.entry)}" target="_blank">${esc(s.entry)}</a></div>
+        ${reason}
+        ${screenshots ? `<div class="shots">${screenshots}</div>` : ''}
+      </div>
+    </div>`;
+        })
+            .join('');
+        platformSections.push(`  <div class="section">
+    <h2>${esc(platform)}</h2>
+    ${cards}
+  </div>`);
+    }
+    return platformSections.join('\n');
+}
+/** 生成 HTML 报告并落盘 report.html，返回路径 */
+async function generateAiVerifyReport(ctx) {
+    const { plan, results } = ctx;
+    await (0, fs_extra_1.ensureDir)(plan.outDir);
+    const byId = new Map(results.results.map((r) => [r.scenarioId, r]));
+    const { total, passed, failed, skipped: skippedCount, notRun } = summarizeResults(ctx);
+    // v8.3.351+: 按层渲染（公共能力层 → 模块层）；旧剧本无 groups 时回退按端分组
+    let scenarioSections;
+    if (Array.isArray(plan.groups) && plan.groups.length > 0) {
+        scenarioSections = plan.groups
+            .map((g) => {
+            const layerHead = `  <div class="section layer">
+    <h2>${esc(g.label)}${g.enabled ? '' : '（⏭️ 已关闭）'}</h2>${g.note ? `
+    <div class="layer-note">${esc(g.note)}</div>` : ''}`;
+            const body = g.scenarios.length > 0 ? renderPlatformSections(g.scenarios, byId) : '    <div class="notes">（本层无场景）</div>';
+            return `${layerHead}
+${body}
+  </div>`;
+        })
+            .join('\n');
+    }
+    else {
+        scenarioSections = renderPlatformSections(plan.scenarios, byId);
+    }
+    const skippedNotes = plan.skipped.length
+        ? `<div class="notes"><h3>生成期跳过项</h3><ul>${plan.skipped
+            .map((s) => `<li>${esc(s.unit)}${s.platform ? '/' + esc(s.platform) : ''}: ${esc(s.reason)}</li>`)
+            .join('')}</ul></div>`
+        : '';
+    const html = `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<title>AI 浏览器验证报告 — ${esc(plan.env)}</title>
+<style>
+  body { font-family: -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; margin: 0; background: #f5f7fa; color: #1f2937; }
+  .container { max-width: 960px; margin: 0 auto; padding: 24px; }
+  h1 { font-size: 22px; margin: 0 0 8px; }
+  .summary { display: flex; gap: 12px; margin: 16px 0; flex-wrap: wrap; }
+  .stat { background: #fff; border-radius: 8px; padding: 12px 20px; box-shadow: 0 1px 3px rgba(0,0,0,.08); }
+  .stat .num { font-size: 26px; font-weight: 700; }
+  .stat.pass .num { color: #16a34a; }
+  .stat.fail .num { color: #dc2626; }
+  .stat.skip .num { color: #d97706; }
+  .stat.notrun .num { color: #6b7280; }
+  .section { background: #fff; border-radius: 10px; padding: 16px 20px; margin: 16px 0; box-shadow: 0 1px 3px rgba(0,0,0,.08); }
+  .section h2 { margin: 0 0 12px; font-size: 17px; }
+  .scenario { border: 1px solid #e5e7eb; border-radius: 8px; margin: 10px 0; overflow: hidden; }
+  .scenario-header { display: flex; justify-content: space-between; align-items: center; padding: 10px 14px; background: #fafafa; }
+  .scenario-body { padding: 10px 14px; }
+  .badge { font-size: 12px; padding: 2px 10px; border-radius: 999px; color: #fff; }
+  .badge.pass { background: #16a34a; }
+  .badge.fail { background: #dc2626; }
+  .badge.skip { background: #d97706; }
+  .badge.notrun { background: #6b7280; }
+  .meta { font-size: 12px; color: #6b7280; margin-bottom: 6px; }
+  .reason { font-size: 13px; margin: 6px 0; white-space: pre-wrap; }
+  .scenario.fail .reason { color: #b91c1c; }
+  .scenario.pass .reason { color: #15803d; }
+  .shots { display: flex; gap: 8px; flex-wrap: wrap; margin-top: 8px; }
+  .shot img { max-width: 280px; max-height: 200px; border: 1px solid #e5e7eb; border-radius: 6px; }
+  .notes { background: #fffbeb; border: 1px solid #fde68a; border-radius: 8px; padding: 12px 16px; margin: 16px 0; font-size: 13px; }
+  .notes ul { margin: 6px 0 0; padding-left: 18px; }
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>AI 浏览器验证报告</h1>
+  <div class="meta">环境: ${esc(plan.env)} · 迭代: ${esc(plan.iteration)} · 执行时间: ${esc(results.executedAt)}</div>
+  <div class="summary">
+    <div class="stat"><div>总场景</div><div class="num">${total}</div></div>
+    <div class="stat pass"><div>通过</div><div class="num">${passed}</div></div>
+    <div class="stat fail"><div>失败</div><div class="num">${failed}</div></div>
+    <div class="stat skip"><div>跳过</div><div class="num">${skippedCount}</div></div>
+    <div class="stat notrun"><div>未执行</div><div class="num">${notRun}</div></div>
+  </div>
+  ${skippedNotes}
+  ${scenarioSections}
+</div>
+</body>
+</html>
+`;
+    const reportPath = (0, path_1.join)(plan.outDir, 'report.html');
+    await (0, fs_extra_1.writeFile)(reportPath, html, 'utf-8');
+    return reportPath;
+}
+//# sourceMappingURL=result-parser.js.map

package/dist/core/ai-verify/result-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-parser.js","sourceRoot":"","sources":["../../../src/core/ai-verify/result-parser.ts"],"names":[],"mappings":"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"}

package/dist/core/ai-verify/scope-resolver.d.ts

@@ -0,0 +1,34 @@
+/**
+ * scope-resolver — AI 验证范围解析（v8.3.350+）
+ *
+ * 三种范围：
+ *   all      → 020-specs 下所有功能单元目录
+ *   deployed → 读部署清单（deploy-manifest.json）的端名，筛选含对应端子目录的单元
+ *   modules  → 精确匹配指定的功能单元目录名
+ * 均可叠加端过滤（platformFilter）。
+ */
+import type { DeployManifest, ScopeUnit } from './types';
+export interface ScopeResolveInput {
+    /** 迭代目录绝对路径（含 020-specs） */
+    iterDir: string;
+    /** scope 参数原文：all | deployed | modules:a,b */
+    scope: string;
+    /** 端过滤（CONSTITUTION 标准端名，逗号分隔），空为不过滤 */
+    platformFilter?: string;
+    /** 项目根目录（读 deploy-manifest.json 用） */
+    projectRoot: string;
+}
+export interface ScopeResolveOutput {
+    units: ScopeUnit[];
+    warnings: string[];
+}
+/** 解析 --platform 参数为端名数组 */
+export declare function parsePlatformFilter(filter?: string): string[];
+/** 读部署清单（不存在返回 null） */
+export declare function loadDeployManifest(projectRoot: string): Promise<DeployManifest | null>;
+/**
+ * 解析验证范围 → 功能单元列表。
+ * 非法 scope 抛错（由调用方捕获提示用法）。
+ */
+export declare function resolveScopeUnits(input: ScopeResolveInput): Promise<ScopeResolveOutput>;
+//# sourceMappingURL=scope-resolver.d.ts.map

package/dist/core/ai-verify/scope-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/ai-verify/scope-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,4BAA4B;AAC5B,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAM7D;AA4CD,wBAAwB;AACxB,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAU5F;AAsBD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0C7F"}

package/dist/core/ai-verify/scope-resolver.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * scope-resolver — AI 验证范围解析（v8.3.350+）
+ *
+ * 三种范围：
+ *   all      → 020-specs 下所有功能单元目录
+ *   deployed → 读部署清单（deploy-manifest.json）的端名，筛选含对应端子目录的单元
+ *   modules  → 精确匹配指定的功能单元目录名
+ * 均可叠加端过滤（platformFilter）。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePlatformFilter = parsePlatformFilter;
+exports.loadDeployManifest = loadDeployManifest;
+exports.resolveScopeUnits = resolveScopeUnits;
+const path_1 = require("path");
+const fs_extra_1 = require("fs-extra");
+/** 非功能单元的目录名（全局规格与元数据，AGENTS.md 约定） */
+const EXCLUDED_DIRS = new Set(['overview', 'requirements']);
+/** 解析 --platform 参数为端名数组 */
+function parsePlatformFilter(filter) {
+    if (!filter)
+        return [];
+    return filter
+        .split(/[,，、\s]+/)
+        .map((n) => n.trim())
+        .filter(Boolean);
+}
+/** 判断一个目录是否为功能单元目录（含端子目录或 overview 子目录） */
+async function listUnitPlatforms(unitPath) {
+    let entries;
+    try {
+        entries = await (0, fs_extra_1.readdir)(unitPath);
+    }
+    catch {
+        return [];
+    }
+    // 端目录特征：包含 UI_SPEC.md / TEST.md / TECH.md 之一的子目录（overview 除外）
+    const platforms = [];
+    for (const entry of entries) {
+        if (EXCLUDED_DIRS.has(entry))
+            continue;
+        try {
+            const stats = (await Promise.resolve().then(() => __importStar(require('fs-extra')))).statSync((0, path_1.join)(unitPath, entry));
+            if (!stats.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        platforms.push(entry);
+    }
+    return platforms;
+}
+/** 枚举 020-specs 下全部功能单元 */
+async function listAllUnits(specsDir) {
+    const entries = await (0, fs_extra_1.readdir)(specsDir);
+    const units = [];
+    for (const entry of entries) {
+        if (EXCLUDED_DIRS.has(entry))
+            continue;
+        const unitPath = (0, path_1.join)(specsDir, entry);
+        try {
+            const stats = (await Promise.resolve().then(() => __importStar(require('fs-extra')))).statSync(unitPath);
+            if (!stats.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const platforms = await listUnitPlatforms(unitPath);
+        units.push({ name: entry, path: unitPath, platforms });
+    }
+    return units;
+}
+/** 读部署清单（不存在返回 null） */
+async function loadDeployManifest(projectRoot) {
+    const manifestPath = (0, path_1.join)(projectRoot, '.speccore', 'local', 'deploy-manifest.json');
+    try {
+        const raw = await (0, fs_extra_1.readFile)(manifestPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!parsed || !Array.isArray(parsed.platforms))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+/** 按部署清单端名筛选单元：单元含任一已部署端子目录则入选 */
+function filterByDeployed(all, manifest) {
+    const deployedNames = new Set(manifest.platforms.map((p) => p.name));
+    return all.filter((u) => u.platforms.some((p) => deployedNames.has(p)));
+}
+/** 按模块名筛选：精确匹配单元目录名 */
+function filterByModules(all, modules) {
+    const wanted = new Set(modules);
+    return all.filter((u) => wanted.has(u.name));
+}
+/** 端过滤：单元保留 filter 中的端 */
+function applyPlatformFilter(units, filter) {
+    if (filter.length === 0)
+        return units;
+    return units
+        .map((u) => ({ ...u, platforms: u.platforms.filter((p) => filter.includes(p)) }))
+        .filter((u) => u.platforms.length > 0);
+}
+/**
+ * 解析验证范围 → 功能单元列表。
+ * 非法 scope 抛错（由调用方捕获提示用法）。
+ */
+async function resolveScopeUnits(input) {
+    const specsDir = (0, path_1.join)(input.iterDir, '020-specs');
+    const all = await listAllUnits(specsDir);
+    const warnings = [];
+    let units;
+    const scope = (input.scope || 'all').trim();
+    if (scope === 'all') {
+        units = all;
+    }
+    else if (scope === 'deployed') {
+        const manifest = await loadDeployManifest(input.projectRoot);
+        if (!manifest) {
+            throw new Error('未找到部署清单（.speccore/local/deploy-manifest.json）。请先执行 speccore deploy 部署，再使用 --scope deployed');
+        }
+        units = filterByDeployed(all, manifest);
+        if (units.length === 0) {
+            warnings.push(`部署清单（${manifest.time}，端: ${manifest.platforms.map((p) => p.name).join(', ')}）与 020-specs 无交集，无可验证单元`);
+        }
+    }
+    else if (scope.startsWith('modules:')) {
+        const modules = parsePlatformFilter(scope.slice('modules:'.length));
+        if (modules.length === 0) {
+            throw new Error('--scope modules: 后需跟功能单元名（逗号分隔），如 modules:订单管理,用户管理');
+        }
+        units = filterByModules(all, modules);
+        const found = new Set(units.map((u) => u.name));
+        for (const m of modules) {
+            if (!found.has(m))
+                warnings.push(`模块 "${m}" 在 020-specs 中不存在，已忽略`);
+        }
+    }
+    else {
+        throw new Error(`未知验证范围 "${scope}"，可用: all | deployed | modules:单元名(逗号分隔)`);
+    }
+    // 端过滤
+    const filter = parsePlatformFilter(input.platformFilter);
+    units = applyPlatformFilter(units, filter);
+    return { units, warnings };
+}
+//# sourceMappingURL=scope-resolver.js.map

package/dist/core/ai-verify/scope-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.js","sourceRoot":"","sources":["../../../src/core/ai-verify/scope-resolver.ts"],"names":[],"mappings":"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"}

package/dist/core/ai-verify/types.d.ts

@@ -0,0 +1,171 @@
+/**
+ * AI 浏览器验证 — 类型定义（v8.3.350+）
+ *
+ * 分工：CLI 只切片不解析语义——从 020-specs 的 UI_SPEC.md/TEST.md 按标题抓取
+ * 原文段落组装成剧本，语义理解与页面操作交给宿主 AI（Browser 子代理）执行。
+ */
+/** 部署清单（deploy 成功后落盘 .speccore/local/deploy-manifest.json，支撑 --scope deployed） */
+export interface DeployManifestPlatform {
+    name: string;
+    type?: string;
+    git?: {
+        branch?: string;
+        commit?: string;
+    };
+}
+export interface DeployManifest {
+    env: string;
+    time: string;
+    platforms: DeployManifestPlatform[];
+}
+/** 范围解析结果：一个功能单元目录 */
+export interface ScopeUnit {
+    /** 功能单元目录名（如 订单管理 或 admin-web-01-yudingguanli） */
+    name: string;
+    /** 绝对路径 */
+    path: string;
+    /** 该单元下存在的端目录名列表 */
+    platforms: string[];
+}
+/**
+ * 剧本分层 ID（v8.3.351+）：
+ *   common  = 公共能力层（入口可达性/登录态/全局导航，CLI 模板生成，先于模块层执行）
+ *   modules = 模块层（各功能单元 UI_SPEC/TEST 切片场景，逐单元推进）
+ */
+export type AiVerifyGroupId = 'common' | 'modules';
+/** 剧本分层：执行视角的分组视图（场景仍平铺在 plan.scenarios，按 scenarioId 对齐结果） */
+export interface AiVerifyGroup {
+    id: AiVerifyGroupId;
+    /** 层显示名（公共能力层 / 模块层） */
+    label: string;
+    /** 该层是否启用（settings.tests.layered 控制；关闭时无场景但保留层头供审计） */
+    enabled: boolean;
+    /** 该层场景 */
+    scenarios: AiVerifyScenario[];
+    /** 层说明（执行协议提示） */
+    note?: string;
+}
+/** 单个验证场景（剧本最小单元） */
+export interface AiVerifyScenario {
+    /** 场景 ID：{单元}__{端}__{序号}，执行结果按此对齐（公共层单元名为 common） */
+    id: string;
+    /** 所属分层 */
+    group: AiVerifyGroupId;
+    /** 功能单元目录名（公共层为 common） */
+    unit: string;
+    /** 端名（CONSTITUTION 标准端名） */
+    platform: string;
+    /** 入口 URL（environments/{env}.yaml 的 tests.base_urls） */
+    entry: string;
+    /** 账号引用（如 staging.admin），剧本不落密码；无账号时为空 */
+    account?: string;
+    /** 操作步骤原文切片（UI_SPEC 交互流程段） */
+    steps: string[];
+    /** 预期结果原文切片（TEST.md 用例段） */
+    expected: string[];
+    /** 场景标题（取源文档段落标题，无标题时用兜底描述） */
+    title: string;
+}
+/** 跳过项：无地址/空模板等无法生成剧本的单元 */
+export interface AiVerifySkipped {
+    unit: string;
+    platform?: string;
+    reason: string;
+}
+/** 账号环境变量引用提示：password/username 形如 ${VAR} 时，执行 AI 需从环境变量取明文 */
+export interface AccountEnvVarHint {
+    /** 账号引用名（如 staging.admin） */
+    ref: string;
+    /** 使用环境变量的字段 */
+    field: 'username' | 'password';
+    /** 环境变量名 */
+    varName: string;
+    /** 剧本生成时该变量是否已设置（未设置时剧本仅提示，不阻断） */
+    set: boolean;
+}
+/**
+ * 登录验证码提示（v8.3.354+）：账号配置了 verification 时，剧本头集中声明取码说明。
+ * 只落「取码通道指引」不落码本身——执行 AI 按 note 自行取码（短信网关/TOTP 工具/测试号平台）。
+ */
+export interface AccountVerificationHint {
+    /** 账号引用名（如 staging.user） */
+    ref: string;
+    /** 验证码类型（sms/totp/graphic/email；仅供执行 AI 参考取码方式） */
+    type: string;
+    /** 取码说明（人写的通道指引，如「验证码发送至测试手机 138xxxx，从短信网关读取」） */
+    note: string;
+}
+/** AI 验证剧本（机器可读，落盘 plan.json） */
+export interface AiVerifyPlan {
+    /** 生成版本号 */
+    version: '1.0';
+    /** 环境名 */
+    env: string;
+    /** 迭代名 */
+    iteration: string;
+    /** 生成时间 ISO */
+    generatedAt: string;
+    /** 账号兑底文件路径（绝对路径；权威源为环境文件 tests.accounts，见 accountSources） */
+    accountsPath: string;
+    /**
+     * 账号来源说明（v8.3.351+ 账号收敛）：执行 AI 据此定位明文。
+     * 如 ["environments/staging.yaml (tests.accounts)", "/abs/.speccore/tests/accounts.yaml"]；
+     * 环境内嵌账号引用名为账号名（如 admin），accounts.yaml 兑底引用名为 {env}.{name}（如 staging.admin）。
+     */
+    accountSources?: string[];
+    /** 场景列表（按端分组后的平铺，与结果按 scenarioId 对齐） */
+    scenarios: AiVerifyScenario[];
+    /** 分层视图（v8.3.351+）：公共能力层先行 → 模块层推进；执行 AI 按此顺序推进 */
+    groups: AiVerifyGroup[];
+    /** 跳过项 */
+    skipped: AiVerifySkipped[];
+    /** 账号环境变量引用提示（password/username 为 ${VAR} 形式时列出） */
+    accountEnvVars?: AccountEnvVarHint[];
+    /** 登录验证码提示（账号配置了 verification 时列出，执行 AI 据此取码） */
+    accountVerifications?: AccountVerificationHint[];
+    /**
+     * 原型/设计稿素材（v8.3.355+）：010-requirements 下 assets/designs、assets/prototypes、
+     * assets/screenshots、prototypes 目录中收集的图片/HTML 绝对路径；
+     * 执行 AI 打开对照理解界面，复杂流程有了视觉参照物。
+     */
+    prototypeAssets?: string[];
+    /** 输出目录（report.html / results.json / screenshots 落盘处） */
+    outDir: string;
+}
+/** 执行通道：记录场景由哪个通道执行判定（报告展示 + 兜底链路审计） */
+export type AiVerifyExecutor = 'browser-agent' | 'playwright-mcp' | 'visual-judge' | 'manual';
+/** 单个场景执行结果（宿主 AI 写回） */
+export interface AiVerifyResult {
+    scenarioId: string;
+    unit: string;
+    platform: string;
+    /** passed=false 且 skipped=true 表示跳过（验证码/支付等无法自动化） */
+    passed: boolean;
+    skipped?: boolean;
+    /** 执行通道（默认 browser-agent） */
+    executor?: AiVerifyExecutor;
+    /**
+     * 宿主 AI 是否已完成视觉判定。无多模态能力的宿主只截图不判定时写 false，
+     * 交由 speccore verify --ai-judge 用视觉模型兜底判定（executor 会改写为 visual-judge）。
+     */
+    judged?: boolean;
+    /** AI 判断理由（视觉检查 + 业务断言依据） */
+    reason: string;
+    /** 截图相对路径（相对 outDir） */
+    screenshots?: string[];
+}
+/** 执行结果汇总（宿主 AI 写回 results.json） */
+export interface AiVerifyResults {
+    version: '1.0';
+    env: string;
+    executedAt: string;
+    results: AiVerifyResult[];
+}
+/** 报告生成输入：剧本 + 结果 */
+export interface AiVerifyReportContext {
+    plan: AiVerifyPlan;
+    results: AiVerifyResults;
+    /** 结果中缺失的场景（未执行） */
+    missing: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/ai-verify/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/ai-verify/types.ts"],"names":[],"mappings":"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"}

package/dist/core/ai-verify/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * AI 浏览器验证 — 类型定义（v8.3.350+）
+ *
+ * 分工：CLI 只切片不解析语义——从 020-specs 的 UI_SPEC.md/TEST.md 按标题抓取
+ * 原文段落组装成剧本，语义理解与页面操作交给宿主 AI（Browser 子代理）执行。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/ai-verify/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/ai-verify/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}