sdd-flow-kit 1.3.15 → 1.3.21

package/dist/core/componentSubstance.js

@@ -0,0 +1,172 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.countEffectiveLines = countEffectiveLines;
+exports.signalPresentInComponent = signalPresentInComponent;
+exports.analyzeComponentSubstance = analyzeComponentSubstance;
+exports.checkChildComponentsImported = checkChildComponentsImported;
+exports.checkComponentSubstance = checkComponentSubstance;
+/**
+ * 组件实质门禁：防止演示迁移用空壳 .vue/.tsx + 注释塞关键词过关。
+ */
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("./fs");
+const testAssertionAnalysis_1 = require("./testAssertionAnalysis");
+const MIN_EFFECTIVE_LINES = 40;
+const VUE_TEMPLATE_RE = /<template[^>]*>([\s\S]*?)<\/template>/i;
+const INTERACTIVE_CONTROL_RE = /<(?:n-button|a-button|el-button|NButton|AButton|ElButton|button|n-input|a-input|el-input|input|n-data-table|a-table|el-table|NDataTable|ATable|n-drawer|a-drawer)[\s/>]/i;
+const API_BEHAVIOR_RE = /from\s+['"][^'"]*(?:config\/api|api\/modules)|useMutation|useQuery|Api\s*\(|financePost|financeGet/i;
+const EMIT_HANDLER_RE = /defineEmits|emit\s*\(|@\w+\s*=\s*["']|onClick|onSubmit/i;
+/** 子组件路径启发式（Section/Modal 等须被父组件引用） */
+const CHILD_COMPONENT_RE = /(?:Section|Modal|Panel|Form)\.vue$/i;
+const PARENT_CONTAINER_RE = /(?:Drawer|index)\.vue$/i;
+/**
+ * 统计去注释后的非空行数，用于识别空壳文件。
+ */
+function countEffectiveLines(content) {
+    const stripped = (0, testAssertionAnalysis_1.stripComments)(content);
+    return stripped.split("\n").filter((l) => l.trim().length > 0).length;
+}
+/**
+ * 交互信号须出现在 template 或 script（非注释），禁止只在注释中登记。
+ */
+function signalPresentInComponent(content, signal) {
+    var _a, _b;
+    if (!signal || signal.length < 2)
+        return true;
+    const stripped = (0, testAssertionAnalysis_1.stripComments)(content);
+    const template = (_b = (_a = stripped.match(VUE_TEMPLATE_RE)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : "";
+    const script = stripped.replace(VUE_TEMPLATE_RE, "");
+    return template.includes(signal) || script.includes(signal);
+}
+/**
+ * 单文件组件实质分析（Vue SFC / TSX）。
+ */
+function analyzeComponentSubstance(relPath, content, interactionSignals) {
+    var _a, _b;
+    const issues = [];
+    const stripped = (0, testAssertionAnalysis_1.stripComments)(content);
+    const effectiveLines = countEffectiveLines(content);
+    if (effectiveLines < MIN_EFFECTIVE_LINES) {
+        issues.push(`有效代码行 ${effectiveLines} < ${MIN_EFFECTIVE_LINES}（疑似空壳）`);
+    }
+    const isVue = /\.vue$/i.test(relPath);
+    const isTsx = /\.tsx$/i.test(relPath);
+    if (isVue) {
+        const template = (_b = (_a = content.match(VUE_TEMPLATE_RE)) === null || _a === void 0 ? void 0 : _a[1]) !== null && _b !== void 0 ? _b : "";
+        if (!template.trim()) {
+            issues.push("缺少 <template> 区块");
+        }
+        else if (!INTERACTIVE_CONTROL_RE.test(template)) {
+            issues.push("template 中未发现 button/input/table 等可交互控件");
+        }
+    }
+    else if (isTsx) {
+        if (!INTERACTIVE_CONTROL_RE.test(stripped) && !/<[A-Z]\w*/.test(stripped)) {
+            issues.push("tsx 中未发现可交互控件或业务组件");
+        }
+    }
+    const hasBehavior = API_BEHAVIOR_RE.test(stripped) || EMIT_HANDLER_RE.test(stripped);
+    if (!hasBehavior && interactionSignals.length > 0) {
+        issues.push("script 中未发现 API 调用或 emit/事件处理（疑似只读骨架）");
+    }
+    const meaningfulSignals = interactionSignals.filter((s) => s.length >= 2);
+    const missingSignals = meaningfulSignals.filter((s) => !signalPresentInComponent(content, s));
+    if (meaningfulSignals.length > 0 && missingSignals.length === meaningfulSignals.length) {
+        issues.push(`交互信号均未出现在 template/script: ${meaningfulSignals.join("、")}`);
+    }
+    else if (missingSignals.length > 0) {
+        issues.push(`缺少交互信号: ${missingSignals.join("、")}`);
+    }
+    return { ok: issues.length === 0, issues };
+}
+/**
+ * 子组件须被映射表中的容器组件（Drawer/index）或其它生产文件 import。
+ */
+async function checkChildComponentsImported(pkgRoot, mappings) {
+    const failures = [];
+    const paths = mappings.map((m) => m.productionPath.replace(/^\.\//, ""));
+    for (const m of mappings) {
+        const rel = m.productionPath.replace(/^\.\//, "");
+        if (!CHILD_COMPONENT_RE.test(rel))
+            continue;
+        if (PARENT_CONTAINER_RE.test(rel))
+            continue;
+        const base = path_1.default.basename(rel, path_1.default.extname(rel));
+        let imported = false;
+        for (const otherRel of paths) {
+            if (otherRel === rel)
+                continue;
+            const content = await (0, fs_1.readFileIfExists)(path_1.default.join(pkgRoot, otherRel));
+            if (!content)
+                continue;
+            if (new RegExp(`import\\s+\\w+\\s+from\\s+['"][^'"]*${base}['"]`).test(content) ||
+                content.includes(`<${base}`) ||
+                content.includes(`<${base} `)) {
+                imported = true;
+                break;
+            }
+        }
+        if (!imported) {
+            failures.push(`${m.moduleName}: ${rel} 未被父组件 import/挂载`);
+        }
+    }
+    return failures;
+}
+/**
+ * Validate/Deliver：演示映射对应的生产组件须通过实质检查。
+ */
+async function checkComponentSubstance(pkgRoot, mappings) {
+    var _a;
+    const checks = [];
+    const skip = process.env.POQUAN_SKIP_COMPONENT_SUBSTANCE === "1" ||
+        process.env.OPSX_SKIP_COMPONENT_SUBSTANCE === "1";
+    if (skip) {
+        checks.push({
+            name: "component-substance",
+            ok: true,
+            detail: "SKIP: OPSX_SKIP_COMPONENT_SUBSTANCE=1",
+        });
+        return checks;
+    }
+    if (mappings.length === 0) {
+        checks.push({
+            name: "component-substance",
+            ok: true,
+            detail: "无演示映射，跳过组件实质检查",
+        });
+        return checks;
+    }
+    const failures = [];
+    for (const m of mappings) {
+        const rel = m.productionPath.replace(/^\.\//, "");
+        const abs = path_1.default.join(pkgRoot, rel);
+        const content = await (0, fs_1.readFileIfExists)(abs);
+        if (content === null) {
+            failures.push({ moduleName: m.moduleName, path: rel, reason: "文件不存在" });
+            continue;
+        }
+        const result = analyzeComponentSubstance(rel, content, m.interactionSignals);
+        if (!result.ok) {
+            failures.push({
+                moduleName: m.moduleName,
+                path: rel,
+                reason: result.issues.join("; "),
+            });
+        }
+    }
+    const importFailures = await checkChildComponentsImported(pkgRoot, mappings);
+    for (const msg of importFailures) {
+        failures.push({ moduleName: (_a = msg.split(":")[0]) !== null && _a !== void 0 ? _a : "?", path: "", reason: msg });
+    }
+    checks.push({
+        name: "component-substance",
+        ok: failures.length === 0,
+        detail: failures.length === 0
+            ? `组件实质检查通过（${mappings.length} 个映射组件）`
+            : failures.map((f) => `${f.moduleName}(${f.path}): ${f.reason}`).join(" | "),
+    });
+    return checks;
+}

package/dist/core/demoImplementationCoverage.js

@@ -0,0 +1,244 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDemoReferenceSection = parseDemoReferenceSection;
+exports.checkDemoReferenceArtifacts = checkDemoReferenceArtifacts;
+exports.checkDemoImplementationCoverage = checkDemoImplementationCoverage;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const componentSubstance_1 = require("./componentSubstance");
+const fs_1 = require("./fs");
+const testAssertionAnalysis_1 = require("./testAssertionAnalysis");
+const DEMO_SECTION_RE = /^##\s*(演示代码参照|Demo Reference)\s*$/im;
+const DEMO_EXEMPT_RE = /^DEMO_REFERENCE_EXEMPT:\s*(.+)$/m;
+const MAPPING_HEADER_RE = /演示模块|Demo Module/i;
+const UI_SCENARIO_KEYWORDS = /上传|点击|页面|按钮|弹窗|列表|表格|展示|抽屉|详情|编辑|导出|筛选|输入框|对话框|导航|toast|保存|删除|添加/i;
+/**
+ * 从 Markdown 解析「演示代码参照」章节与模块映射表。
+ */
+function parseDemoReferenceSection(content) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const exemptMatch = content.match(DEMO_EXEMPT_RE);
+    const exempt = ((_a = exemptMatch === null || exemptMatch === void 0 ? void 0 : exemptMatch[1]) === null || _a === void 0 ? void 0 : _a.trim()) || null;
+    const sectionMatch = content.match(DEMO_SECTION_RE);
+    if (!sectionMatch || sectionMatch.index === undefined) {
+        return { hasSection: false, exempt, demoRoot: null, demoStack: null, mappings: [] };
+    }
+    const sectionBody = content.slice(sectionMatch.index);
+    const demoRoot = ((_c = (_b = sectionBody.match(/演示代码根路径[：:]\s*`?([^`\n]+)`?/i)) === null || _b === void 0 ? void 0 : _b[1]) === null || _c === void 0 ? void 0 : _c.trim()) ||
+        ((_e = (_d = sectionBody.match(/Demo Root[：:]\s*`?([^`\n]+)`?/i)) === null || _d === void 0 ? void 0 : _d[1]) === null || _e === void 0 ? void 0 : _e.trim()) ||
+        null;
+    const demoStack = ((_g = (_f = sectionBody.match(/技术栈[：:]\s*`?(vue|react|其他)[^`\n]*`?/i)) === null || _f === void 0 ? void 0 : _f[1]) === null || _g === void 0 ? void 0 : _g.trim()) ||
+        ((_j = (_h = sectionBody.match(/Stack[：:]\s*`?(vue|react|other)[^`\n]*`?/i)) === null || _h === void 0 ? void 0 : _h[1]) === null || _j === void 0 ? void 0 : _j.trim()) ||
+        null;
+    const mappings = [];
+    const lines = sectionBody.split("\n");
+    let inTable = false;
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i].trim();
+        if (line.startsWith("|") && MAPPING_HEADER_RE.test(line)) {
+            inTable = true;
+            continue;
+        }
+        if (!inTable || !line.startsWith("|"))
+            continue;
+        if (/^\|\s*[-:]+/.test(line))
+            continue;
+        const cells = line
+            .split("|")
+            .map((c) => c.trim())
+            .filter((_, idx, arr) => idx > 0 && idx < arr.length - 1);
+        if (cells.length < 4)
+            continue;
+        if (/演示模块|Demo Module/i.test(cells[0]))
+            continue;
+        const signals = ((_k = cells[3]) !== null && _k !== void 0 ? _k : "")
+            .split(/[、,，|；;]/)
+            .map((s) => s.trim())
+            .filter((s) => s.length >= 2);
+        mappings.push({
+            moduleName: cells[0],
+            demoRef: cells[1],
+            productionPath: cells[2].replace(/\\/g, "/"),
+            interactionSignals: signals,
+            rowLine: i + 1,
+        });
+    }
+    return { hasSection: true, exempt, demoRoot, demoStack, mappings };
+}
+async function readChangeDesignAndTasks(pkgRoot, changeName) {
+    const changeDir = path_1.default.join(pkgRoot, "openspec/changes", changeName);
+    const design = await (0, fs_1.readFileIfExists)(path_1.default.join(changeDir, "design.md"));
+    const tasks = await (0, fs_1.readFileIfExists)(path_1.default.join(changeDir, "tasks.md"));
+    return { design, tasks };
+}
+async function changeHasUiScenarios(pkgRoot, changeName) {
+    const specsDir = path_1.default.join(pkgRoot, "openspec/changes", changeName, "specs");
+    let entries;
+    try {
+        entries = await promises_1.default.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const cap of entries) {
+        if (!cap.isDirectory())
+            continue;
+        const specPath = path_1.default.join(specsDir, cap.name, "spec.md");
+        const content = await (0, fs_1.readFileIfExists)(specPath);
+        if (!content)
+            continue;
+        const blocks = content.split(/^####\s+Scenario:/m);
+        for (let i = 1; i < blocks.length; i += 1) {
+            if (UI_SCENARIO_KEYWORDS.test(blocks[i]))
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Propose / AC 阶段：design 须声明演示参照与模块映射表；tasks 须含演示迁移段。
+ */
+async function checkDemoReferenceArtifacts(pkgRoot, changeName) {
+    const checks = [];
+    const skip = process.env.POQUAN_SKIP_DEMO_REFERENCE === "1" ||
+        process.env.OPSX_SKIP_DEMO_REFERENCE === "1";
+    if (skip) {
+        checks.push({
+            name: "demo-reference-artifacts",
+            ok: true,
+            detail: "SKIP: OPSX_SKIP_DEMO_REFERENCE=1",
+        });
+        return checks;
+    }
+    const requiresUi = await changeHasUiScenarios(pkgRoot, changeName);
+    const { design, tasks } = await readChangeDesignAndTasks(pkgRoot, changeName);
+    if (!design) {
+        checks.push({
+            name: "demo-reference-design",
+            ok: !requiresUi,
+            detail: requiresUi
+                ? "UI change 缺少 design.md，无法声明演示代码参照"
+                : "无 UI Scenario，跳过演示参照",
+        });
+        return checks;
+    }
+    const parsed = parseDemoReferenceSection(design);
+    if (parsed.exempt) {
+        checks.push({
+            name: "demo-reference-design",
+            ok: true,
+            detail: `DEMO_REFERENCE_EXEMPT: ${parsed.exempt}`,
+        });
+        return checks;
+    }
+    if (!requiresUi) {
+        checks.push({
+            name: "demo-reference-design",
+            ok: true,
+            detail: "无 UI Scenario，不要求演示映射表",
+        });
+        return checks;
+    }
+    if (!parsed.hasSection) {
+        checks.push({
+            name: "demo-reference-design",
+            ok: false,
+            detail: "design.md 缺少 ## 演示代码参照（须映射演示模块→生产组件→关键交互）",
+        });
+        return checks;
+    }
+    if (!parsed.demoRoot) {
+        checks.push({
+            name: "demo-reference-root",
+            ok: false,
+            detail: "演示代码参照 未填写「演示代码根路径」（Vue/React 演示仓库或目录）",
+        });
+    }
+    else {
+        checks.push({
+            name: "demo-reference-root",
+            ok: true,
+            detail: `演示根路径: ${parsed.demoRoot}`,
+        });
+    }
+    if (parsed.mappings.length === 0) {
+        checks.push({
+            name: "demo-module-mapping",
+            ok: false,
+            detail: "演示模块映射表为空（至少须覆盖详情/弹窗等每个 UI 子模块一行）",
+        });
+    }
+    else {
+        checks.push({
+            name: "demo-module-mapping",
+            ok: true,
+            detail: `已登记 ${parsed.mappings.length} 个演示模块映射`,
+        });
+    }
+    const tasksText = tasks !== null && tasks !== void 0 ? tasks : "";
+    const hasMigrationSection = /##\s*演示模块迁移|演示模块迁移/.test(tasksText);
+    const missingInTasks = [];
+    for (const m of parsed.mappings) {
+        const prodBase = path_1.default.basename(m.productionPath);
+        if (!tasksText.includes(m.moduleName) && !tasksText.includes(prodBase)) {
+            missingInTasks.push(m.moduleName);
+        }
+    }
+    checks.push({
+        name: "demo-tasks-migration",
+        ok: hasMigrationSection && missingInTasks.length === 0,
+        detail: hasMigrationSection && missingInTasks.length === 0
+            ? "tasks.md 含演示模块迁移且覆盖全部映射行"
+            : `tasks 缺少演示迁移: section=${hasMigrationSection}, 未覆盖模块=${missingInTasks.join(", ") || "无"}`,
+    });
+    return checks;
+}
+/**
+ * Validate / Deliver：生产代码须实现映射表中的组件与关键交互信号。
+ */
+async function checkDemoImplementationCoverage(pkgRoot, changeName) {
+    const checks = [];
+    const artifactChecks = await checkDemoReferenceArtifacts(pkgRoot, changeName);
+    const exempt = artifactChecks.some((c) => c.ok && c.detail.startsWith("DEMO_REFERENCE_EXEMPT"));
+    if (exempt || artifactChecks.some((c) => c.name === "demo-reference-design" && c.ok && c.detail.includes("跳过"))) {
+        checks.push(...artifactChecks.filter((c) => c.ok));
+        return checks;
+    }
+    const failedArtifact = artifactChecks.filter((c) => !c.ok);
+    if (failedArtifact.length > 0) {
+        checks.push(...failedArtifact);
+        return checks;
+    }
+    const { design } = await readChangeDesignAndTasks(pkgRoot, changeName);
+    const parsed = parseDemoReferenceSection(design !== null && design !== void 0 ? design : "");
+    const failures = [];
+    for (const m of parsed.mappings) {
+        const prodRel = m.productionPath.replace(/^\.\//, "");
+        const abs = path_1.default.join(pkgRoot, prodRel);
+        const content = await (0, fs_1.readFileIfExists)(abs);
+        if (content === null) {
+            failures.push(`${m.moduleName}: 生产文件不存在 ${prodRel}`);
+            continue;
+        }
+        const code = (0, testAssertionAnalysis_1.stripComments)(content);
+        const missingSignals = m.interactionSignals.filter((s) => !code.includes(s));
+        if (m.interactionSignals.length > 0 && missingSignals.length === m.interactionSignals.length) {
+            failures.push(`${m.moduleName}: ${prodRel} 未实现任何关键交互（${m.interactionSignals.join("、")}）`);
+        }
+        else if (missingSignals.length > 0) {
+            failures.push(`${m.moduleName}: ${prodRel} 缺少交互信号: ${missingSignals.join("、")}`);
+        }
+    }
+    checks.push({
+        name: "demo-implementation-coverage",
+        ok: failures.length === 0,
+        detail: failures.length === 0
+            ? `演示模块已全部落地（${parsed.mappings.length} 项）`
+            : failures.join(" | "),
+    });
+    checks.push(...(await (0, componentSubstance_1.checkComponentSubstance)(pkgRoot, parsed.mappings)));
+    return checks;
+}

package/dist/core/e2eAssertionDepth.js

@@ -0,0 +1,237 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectChangeE2eSpecs = collectChangeE2eSpecs;
+exports.changeHasUiScenarios = changeHasUiScenarios;
+exports.checkE2eAssertionDepth = checkE2eAssertionDepth;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const acMatrix_1 = require("./acMatrix");
+const fs_1 = require("./fs");
+const testAssertionAnalysis_1 = require("./testAssertionAnalysis");
+const e2eDemoSignalClicks_1 = require("./e2eDemoSignalClicks");
+const E2E_SPEC_RE = /\be2e\/[\w/.-]+\.spec\.(?:ts|js)\b/g;
+const UI_SCENARIO_KEYWORDS = /上传|点击|页面|按钮|弹窗|列表|表格|展示|抽屉|详情|导出|筛选|输入框|对话框|导航|toast|截图/i;
+async function readChangeArtifacts(changeDir) {
+    const files = ["tasks.md", "proposal.md", "design.md"];
+    let blob = "";
+    for (const f of files) {
+        const content = await (0, fs_1.readFileIfExists)(path_1.default.join(changeDir, f));
+        if (content)
+            blob += `${content}\n`;
+    }
+    return blob;
+}
+/** 从 change 文档收集绑定的 e2e spec（须文件存在） */
+async function collectChangeE2eSpecs(pkgRoot, changeName) {
+    var _a;
+    const changeDir = path_1.default.join(pkgRoot, "openspec/changes", changeName);
+    const specs = new Set();
+    const artifactBlob = await readChangeArtifacts(changeDir);
+    let m;
+    const re = new RegExp(E2E_SPEC_RE.source, "g");
+    while ((m = re.exec(artifactBlob)) !== null) {
+        const rel = m[0];
+        const abs = path_1.default.join(pkgRoot, rel);
+        const content = await (0, fs_1.readFileIfExists)(abs);
+        if (content !== null)
+            specs.add(rel);
+    }
+    const configPath = path_1.default.join(pkgRoot, "e2e/e2e-scope.config.json");
+    const configRaw = await (0, fs_1.readFileIfExists)(configPath);
+    if (configRaw) {
+        try {
+            const config = JSON.parse(configRaw);
+            const overrides = (_a = config.changeNameToSpecs) === null || _a === void 0 ? void 0 : _a[changeName];
+            if (overrides) {
+                for (const raw of overrides) {
+                    const rel = raw.startsWith("e2e/") ? raw : `e2e/${raw}`;
+                    const content = await (0, fs_1.readFileIfExists)(path_1.default.join(pkgRoot, rel));
+                    if (content !== null)
+                        specs.add(rel);
+                }
+            }
+        }
+        catch {
+            // ignore invalid config
+        }
+    }
+    return [...specs].sort();
+}
+/** delta specs 是否含 UI 交互类 Scenario */
+async function changeHasUiScenarios(pkgRoot, changeName) {
+    const specsDir = path_1.default.join(pkgRoot, "openspec/changes", changeName, "specs");
+    let entries;
+    try {
+        entries = await promises_1.default.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return false;
+    }
+    for (const cap of entries) {
+        if (!cap.isDirectory())
+            continue;
+        const specPath = path_1.default.join(specsDir, cap.name, "spec.md");
+        const content = await (0, fs_1.readFileIfExists)(specPath);
+        if (!content)
+            continue;
+        const blocks = content.split(/^####\s+Scenario:/m);
+        for (let i = 1; i < blocks.length; i += 1) {
+            if (UI_SCENARIO_KEYWORDS.test(blocks[i]))
+                return true;
+        }
+    }
+    return false;
+}
+function hasPlaywrightExempt(tasksContent) {
+    return /^PLAYWRIGHT_E2E_EXEMPT:/m.test(tasksContent);
+}
+/**
+ * E2E 断言深度门禁：change 级 spec 须含页面可达、数据/交互断言；e2e 类型 AC 须在有效 test 块内映射。
+ */
+async function checkE2eAssertionDepth(pkgRoot, outputRoot, changeName) {
+    var _a, _b;
+    const checks = [];
+    const skip = process.env.POQUAN_SKIP_E2E_ASSERTION_DEPTH === "1" ||
+        process.env.OPSX_SKIP_E2E_ASSERTION_DEPTH === "1";
+    if (skip) {
+        checks.push({
+            name: "e2e-assertion-depth",
+            ok: true,
+            detail: "SKIP: OPSX_SKIP_E2E_ASSERTION_DEPTH=1",
+        });
+        return checks;
+    }
+    const changeDir = path_1.default.join(pkgRoot, "openspec/changes", changeName);
+    const changeExists = await (0, fs_1.readFileIfExists)(path_1.default.join(changeDir, "tasks.md"));
+    if (changeExists === null) {
+        checks.push({
+            name: "e2e-assertion-depth",
+            ok: true,
+            detail: `活跃 change 不存在，跳过深度检查: ${changeName}`,
+        });
+        return checks;
+    }
+    const tasksContent = (_a = (await (0, fs_1.readFileIfExists)(path_1.default.join(changeDir, "tasks.md")))) !== null && _a !== void 0 ? _a : "";
+    if (hasPlaywrightExempt(tasksContent)) {
+        checks.push({
+            name: "e2e-assertion-depth",
+            ok: true,
+            detail: "PLAYWRIGHT_E2E_EXEMPT 已声明，跳过 E2E 深度检查",
+        });
+        return checks;
+    }
+    const requiresUiE2e = await changeHasUiScenarios(pkgRoot, changeName);
+    const specPaths = await collectChangeE2eSpecs(pkgRoot, changeName);
+    if (!requiresUiE2e && specPaths.length === 0) {
+        checks.push({
+            name: "e2e-assertion-depth",
+            ok: true,
+            detail: "无 UI Scenario 且未绑定 change 级 e2e spec，跳过深度检查",
+        });
+        return checks;
+    }
+    if (requiresUiE2e && specPaths.length === 0) {
+        checks.push({
+            name: "e2e-assertion-depth",
+            ok: false,
+            detail: "含 UI Scenario 但未绑定 e2e/*.spec.ts，无法做断言深度验收",
+        });
+        return checks;
+    }
+    const depthFailures = [];
+    for (const rel of specPaths) {
+        const abs = path_1.default.join(pkgRoot, rel);
+        const content = (_b = (await (0, fs_1.readFileIfExists)(abs))) !== null && _b !== void 0 ? _b : "";
+        const depth = (0, testAssertionAnalysis_1.analyzeE2eSpecDepth)(rel, content);
+        if (!depth.ok) {
+            depthFailures.push(`${rel}: ${depth.issues.join("; ")}`);
+        }
+    }
+    checks.push({
+        name: "e2e-assertion-depth",
+        ok: depthFailures.length === 0,
+        detail: depthFailures.length === 0
+            ? `change 级 E2E 深度通过（${specPaths.join(", ")}）`
+            : `E2E 断言过浅: ${depthFailures.join(" | ")}`,
+    });
+    const designContent = await (0, fs_1.readFileIfExists)(path_1.default.join(pkgRoot, "openspec/changes", changeName, "design.md"));
+    const demoClickCheck = await (0, e2eDemoSignalClicks_1.checkE2eDemoSignalClicks)(pkgRoot, designContent, specPaths);
+    checks.push(demoClickCheck);
+    const acParsed = await (0, acMatrix_1.parseAcMatrix)(outputRoot);
+    if (acParsed.ok) {
+        const e2eAcs = acParsed.items.filter((i) => { var _a; return /^P0$/i.test(i.priority.trim()) || /e2e/i.test((_a = i.testType) !== null && _a !== void 0 ? _a : ""); });
+        await checkE2eAcDepth(pkgRoot, e2eAcs, checks);
+    }
+    return checks;
+}
+/** 校验声明 e2e 的 AC 是否在有效 test 块内有映射 */
+async function checkE2eAcDepth(pkgRoot, acs, checks) {
+    var _a, _b;
+    const e2eRoots = ["e2e", "playwright"];
+    const e2eFiles = [];
+    for (const root of e2eRoots) {
+        const dir = path_1.default.join(pkgRoot, root);
+        let entries;
+        try {
+            entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const ent of entries) {
+            if (!ent.isFile() || !/\.spec\.(t|j)sx?$/.test(ent.name))
+                continue;
+            const abs = path_1.default.join(dir, ent.name);
+            const content = (_a = (await (0, fs_1.readFileIfExists)(abs))) !== null && _a !== void 0 ? _a : "";
+            e2eFiles.push({ rel: `${root}/${ent.name}`, content });
+        }
+        await walkE2eSubdirs(dir, root, e2eFiles);
+    }
+    for (const ac of acs) {
+        const e2eRequired = /e2e/i.test((_b = ac.testType) !== null && _b !== void 0 ? _b : "");
+        if (!e2eRequired)
+            continue;
+        const hits = e2eFiles.filter((f) => (0, testAssertionAnalysis_1.hasMeaningfulAcCoverageInFile)(f.rel, f.content, ac.id).covered);
+        checks.push({
+            name: `ac-e2e-depth-${ac.id}`,
+            ok: hits.length > 0,
+            detail: hits.length > 0
+                ? `${ac.id} 在有效 E2E test 块内有 expect 断言: ${hits.map((h) => h.rel).join(", ")}`
+                : `${ac.id} 测试类型含 e2e，但 e2e/ 下无含 [${ac.id}] 且带 expect 的 test/it 块`,
+        });
+    }
+}
+async function walkE2eSubdirs(dir, relPrefix, out) {
+    var _a;
+    let entries;
+    try {
+        entries = await promises_1.default.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const ent of entries) {
+        if (!ent.isDirectory())
+            continue;
+        const sub = path_1.default.join(dir, ent.name);
+        const subRel = `${relPrefix}/${ent.name}`;
+        let files;
+        try {
+            files = await promises_1.default.readdir(sub, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.isFile() || !/\.spec\.(t|j)sx?$/.test(f.name))
+                continue;
+            const abs = path_1.default.join(sub, f.name);
+            const content = (_a = (await (0, fs_1.readFileIfExists)(abs))) !== null && _a !== void 0 ? _a : "";
+            out.push({ rel: `${subRel}/${f.name}`, content });
+        }
+        await walkE2eSubdirs(sub, subRel, out);
+    }
+}