sdd-flow-kit 1.3.14 → 1.3.18

package/dist/core/techDocQuality.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * 04-技术文档草稿 结构质量门禁：与 artifacts/04-技术文档.template.md 对齐，禁止摘要版替换完整模板。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUIRED_TECH_DOC_SECTIONS = void 0;
+exports.checkTechDocStructure = checkTechDocStructure;
+/** 与模板一致的必备二级章节（允许「## 1. 改造范围」类带后缀标题） */
+exports.REQUIRED_TECH_DOC_SECTIONS = [
+    { id: "meta", pattern: /##\s*文档元信息/m, label: "文档元信息" },
+    { id: "scope", pattern: /##\s*1\.\s*改造范围/m, label: "1. 改造范围" },
+    { id: "ui", pattern: /##\s*2\.\s*页面与交互设计/m, label: "2. 页面与交互设计" },
+    { id: "demo", pattern: /###\s*2\.4\s*演示代码参照/m, label: "2.4 演示代码参照" },
+    { id: "state", pattern: /##\s*3\.\s*前端状态与数据模型设计/m, label: "3. 前端状态与数据模型设计" },
+    { id: "api", pattern: /##\s*4\.\s*接口与数据交互设计/m, label: "4. 接口与数据交互设计" },
+    { id: "form", pattern: /##\s*5\.\s*表单与校验设计/m, label: "5. 表单与校验设计" },
+    { id: "edge", pattern: /##\s*6\.\s*异常、边界与降级方案/m, label: "6. 异常、边界与降级方案" },
+    { id: "files", pattern: /##\s*7\.\s*改造清单/m, label: "7. 改造清单" },
+    { id: "risk", pattern: /##\s*8\.\s*风险点与应对策略/m, label: "8. 风险点与应对策略" },
+    { id: "release", pattern: /##\s*9\.\s*发布、灰度与回滚/m, label: "9. 发布、灰度与回滚" },
+    { id: "test", pattern: /##\s*10\.\s*测试与验收要点/m, label: "10. 测试与验收要点" },
+    { id: "pending", pattern: /##\s*11\.\s*待确认事项/m, label: "11. 待确认事项" },
+];
+const MIN_LINES = 150;
+const MIN_H3_UNDER_SCOPE = 2;
+const API_TABLE_RE = /\|\s*接口\s*\|\s*Method\s*\|/m;
+const DEMO_TABLE_RE = /\|\s*演示模块\s*\|\s*演示文件\/组件\s*\|/m;
+const AC_REF_RE = /\[AC-\d{2,}\]/g;
+/** 典型「摘要版」反模式：仅若干条顶层 [AC-xx]  bullet，无三级标题 */
+const SUMMARY_ANTIPATTERN_RE = /^#\s*04-技术文档草稿\s*\n+##\s*文档元信息[\s\S]{0,800}##\s*7\.\s*权限/m;
+/**
+ * 校验 04 技术文档是否按模板填满（非摘要替换版）。
+ */
+function checkTechDocStructure(content) {
+    var _a, _b, _c, _d;
+    const missingSections = [];
+    const warnings = [];
+    if (!content || content.trim().length < 80) {
+        return {
+            ok: false,
+            detail: "04-技术文档草稿.md 缺失或过短",
+            missingSections: exports.REQUIRED_TECH_DOC_SECTIONS.map((s) => s.label),
+            warnings: [],
+        };
+    }
+    const lines = content.split("\n");
+    if (lines.length < MIN_LINES) {
+        warnings.push(`行数 ${lines.length} < ${MIN_LINES}（模板级文档通常 ≥150 行）`);
+    }
+    for (const sec of exports.REQUIRED_TECH_DOC_SECTIONS) {
+        if (!sec.pattern.test(content)) {
+            missingSections.push(sec.label);
+        }
+    }
+    const h3InScope = ((_b = (_a = content.match(/##\s*1\.\s*改造范围[\s\S]*?(?=##\s*2\.)/m)) === null || _a === void 0 ? void 0 : _a[0]) !== null && _b !== void 0 ? _b : "").match(/^###\s+/gm);
+    if (!h3InScope || h3InScope.length < MIN_H3_UNDER_SCOPE) {
+        missingSections.push("1.x 改造目标/In Scope 等三级小节");
+    }
+    if (!API_TABLE_RE.test(content)) {
+        missingSections.push("4.1 接口清单表格（| 接口 | Method |）");
+    }
+    if (!DEMO_TABLE_RE.test(content)) {
+        missingSections.push("2.4 演示模块映射表格（| 演示模块 | 演示文件/组件 |）");
+    }
+    const acRefs = (_c = content.match(AC_REF_RE)) !== null && _c !== void 0 ? _c : [];
+    if (acRefs.length < 3) {
+        warnings.push("文中 [AC-XX] 引用过少（建议在各章节分散标注）");
+    }
+    if (SUMMARY_ANTIPATTERN_RE.test(content) && lines.length < 80) {
+        missingSections.push("禁止摘要版：须保留模板全部 11 章并逐节填写");
+    }
+    const placeholderHeavy = ((_d = content.match(/（填写）|待填写|TBD|示例：/g)) !== null && _d !== void 0 ? _d : []).length > 25 &&
+        lines.length < MIN_LINES;
+    if (placeholderHeavy) {
+        warnings.push("占位符过多且篇幅过短，疑似未按 PRD/接口/演示填充");
+    }
+    const ok = missingSections.length === 0 && lines.length >= MIN_LINES;
+    const detail = ok
+        ? `04 技术文档结构合格（${lines.length} 行，${exports.REQUIRED_TECH_DOC_SECTIONS.length} 章齐全）`
+        : `04 技术文档不符合模板: 缺 ${missingSections.join("、")}${warnings.length ? `；${warnings.join("；")}` : ""}`;
+    return {
+        ok,
+        detail,
+        missingSections,
+        warnings,
+    };
+}

package/dist/core/testAssertionAnalysis.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * 测试断言深度分析：用于 PRD 语义覆盖、AC 映射与 E2E 深度门禁。
+ * 禁止仅靠注释登记 PRD/AC；要求 test/it 块内存在 expect 等有效断言。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripComments = stripComments;
+exports.parseTestBlocks = parseTestBlocks;
+exports.isRegistryStubFile = isRegistryStubFile;
+exports.testBlockHasExpect = testBlockHasExpect;
+exports.testBlockReferencesAc = testBlockReferencesAc;
+exports.testBlockReferencesAtom = testBlockReferencesAtom;
+exports.hasMeaningfulAtomCoverageInFile = hasMeaningfulAtomCoverageInFile;
+exports.hasMeaningfulAcCoverageInFile = hasMeaningfulAcCoverageInFile;
+exports.testBlockIsPlaceholderOnly = testBlockIsPlaceholderOnly;
+exports.analyzeE2eSpecDepth = analyzeE2eSpecDepth;
+const TEST_TITLE_RE = /(?:^|\n)\s*(?:test|it)(?:\.(?:only|skip))?\s*\(\s*(?:async\s*)?[`'"]([^`'"]*)[`'"]/g;
+const EXPECT_RE = /\bexpect\s*\(/;
+const E2E_DIR_RE = /(^|\/)(e2e|playwright)(\/|$)/i;
+/** 仅用于登记 PRD 原子、无真实 UI 断言的伪覆盖文件 */
+const REGISTRY_STUB_FILE_RE = /prd-atoms-coverage|prd-atoms-registry|semantic-registry/i;
+/** 浅层 E2E：仅有占位符可见性断言 */
+const PLACEHOLDER_ONLY_RE = /getByPlaceholder|getByLabel|getByTestId/i;
+const DATA_ASSERTION_RE = /getByRole\s*\(\s*['"]cell|getByRole\s*\(\s*['"]row|toContainText|waitForResponse|\.n-data-table|data-table-tbody|data-table-body/i;
+const HOOK_TITLE_RE = /^(?:beforeEach|afterEach|beforeAll|afterAll)$/i;
+/** 移除行注释与块注释，避免注释中的 PRD 或 AC 标识误计为覆盖 */
+function stripComments(content) {
+    let out = "";
+    let i = 0;
+    while (i < content.length) {
+        if (content[i] === "/" && content[i + 1] === "/") {
+            while (i < content.length && content[i] !== "\n")
+                i += 1;
+            continue;
+        }
+        if (content[i] === "/" && content[i + 1] === "*") {
+            i += 2;
+            while (i < content.length && !(content[i] === "*" && content[i + 1] === "/"))
+                i += 1;
+            i += 2;
+            continue;
+        }
+        out += content[i];
+        i += 1;
+    }
+    return out;
+}
+/** 解析 test/it 块（标题 + 回调体近似区间） */
+function parseTestBlocks(content) {
+    var _a, _b, _c;
+    const stripped = stripComments(content);
+    const blocks = [];
+    const re = new RegExp(TEST_TITLE_RE.source, "g");
+    let m;
+    const indices = [];
+    let idx = 0;
+    while ((m = re.exec(stripped)) !== null) {
+        indices.push({ title: (_a = m[1]) !== null && _a !== void 0 ? _a : "", start: m.index, index: idx });
+        idx += 1;
+    }
+    for (let i = 0; i < indices.length; i += 1) {
+        const cur = indices[i];
+        const nextStart = (_c = (_b = indices[i + 1]) === null || _b === void 0 ? void 0 : _b.start) !== null && _c !== void 0 ? _c : stripped.length;
+        const slice = stripped.slice(cur.start, Math.min(cur.start + 4000, nextStart));
+        blocks.push({ title: cur.title, body: slice, index: cur.index });
+    }
+    return blocks;
+}
+/** 是否为 PRD 原子登记类伪覆盖文件 */
+function isRegistryStubFile(relPath, content) {
+    const norm = relPath.replace(/\\/g, "/");
+    if (REGISTRY_STUB_FILE_RE.test(norm))
+        return true;
+    if (!E2E_DIR_RE.test(norm))
+        return false;
+    const blocks = parseTestBlocks(content);
+    if (blocks.length === 0)
+        return false;
+    const allShallow = blocks.every((b) => {
+        const hasExpect = EXPECT_RE.test(b.body);
+        const onlyCount = /expect\s*\([^)]*\)\s*\.toBeGreaterThan\s*\(\s*0\s*\)/.test(b.body) &&
+            !DATA_ASSERTION_RE.test(b.body) &&
+            !/\bpage\.goto\b/.test(b.body);
+        return !hasExpect || onlyCount;
+    });
+    return allShallow && blocks.length >= 3;
+}
+function testBlockHasExpect(block) {
+    return EXPECT_RE.test(block.body);
+}
+/** test 块是否引用 AC（标题或块内显式标注） */
+function testBlockReferencesAc(block, acId) {
+    const bracket = `[${acId}]`;
+    const upper = acId.toUpperCase();
+    return (block.title.includes(bracket) ||
+        block.title.toUpperCase().includes(upper) ||
+        block.body.includes(bracket));
+}
+/** test 块是否引用 PRD 原子或可核对信号 */
+function testBlockReferencesAtom(block, atomId, signals) {
+    const hasId = block.title.includes(atomId) ||
+        block.title.includes(`[${atomId}]`) ||
+        block.body.includes(atomId);
+    if (hasId)
+        return true;
+    return signals.some((s) => s.length >= 4 && (block.title.includes(s) || block.body.includes(s)));
+}
+/**
+ * 判断单条测试文件是否对 PRD 原子有「有效」自动化覆盖（非注释、非 stub、含 expect）。
+ */
+function hasMeaningfulAtomCoverageInFile(relPath, content, atomId, signals) {
+    if (isRegistryStubFile(relPath, content)) {
+        return { covered: false, hasE2e: false };
+    }
+    const isE2e = E2E_DIR_RE.test(relPath);
+    const blocks = parseTestBlocks(content);
+    for (const block of blocks) {
+        if (!testBlockHasExpect(block))
+            continue;
+        if (!testBlockReferencesAtom(block, atomId, signals))
+            continue;
+        return { covered: true, hasE2e: isE2e };
+    }
+    return { covered: false, hasE2e: false };
+}
+/**
+ * 判断单条测试文件是否对 AC 有有效覆盖（test 块内 [AC-XX] + expect）。
+ */
+function hasMeaningfulAcCoverageInFile(relPath, content, acId) {
+    if (isRegistryStubFile(relPath, content)) {
+        return { covered: false, isE2e: false };
+    }
+    const isE2e = E2E_DIR_RE.test(relPath);
+    const blocks = parseTestBlocks(content);
+    for (const block of blocks) {
+        if (!testBlockReferencesAc(block, acId))
+            continue;
+        if (!testBlockHasExpect(block))
+            continue;
+        return { covered: true, isE2e };
+    }
+    return { covered: false, isE2e: false };
+}
+function testBlockIsPlaceholderOnly(block) {
+    if (HOOK_TITLE_RE.test(block.title.trim()))
+        return false;
+    if (!EXPECT_RE.test(block.body))
+        return false;
+    const hasPlaceholder = PLACEHOLDER_ONLY_RE.test(block.body);
+    const hasData = DATA_ASSERTION_RE.test(block.body);
+    const hasInteraction = /\b(?:click|dblclick|fill|press|selectOption)\b/.test(block.body);
+    return hasPlaceholder && !hasData && !hasInteraction;
+}
+/**
+ * 评估单个 E2E spec 的断言深度（L3 最低要求）。
+ * 每个非 hook 的 test 块不得仅断言 placeholder；至少一个 test 块须含数据或交互断言。
+ */
+function analyzeE2eSpecDepth(relPath, content) {
+    const issues = [];
+    if (isRegistryStubFile(relPath, content)) {
+        return {
+            ok: false,
+            issues: ["伪覆盖登记文件，不能作为 change 级 E2E 验收"],
+            stats: {
+                testCount: 0,
+                testsWithExpect: 0,
+                hasGoto: false,
+                hasDataAssertion: false,
+                hasInteraction: false,
+            },
+        };
+    }
+    const stripped = stripComments(content);
+    const blocks = parseTestBlocks(content);
+    const hookBlocks = blocks.filter((b) => HOOK_TITLE_RE.test(b.title.trim()));
+    const testBlocks = blocks.filter((b) => !HOOK_TITLE_RE.test(b.title.trim()));
+    const testsWithExpect = testBlocks.filter((b) => testBlockHasExpect(b)).length;
+    const hasGoto = /\bpage\.goto\b/.test(stripped);
+    const hasDataInTests = testBlocks.some((b) => DATA_ASSERTION_RE.test(b.body));
+    const hasInteractionInTests = testBlocks.some((b) => /\b(?:click|dblclick|fill|press|selectOption)\b/.test(b.body));
+    const placeholderOnlyTests = testBlocks.filter((b) => testBlockIsPlaceholderOnly(b));
+    if (testBlocks.length === 0) {
+        issues.push("未解析到 test/it 用例（不含 hook）");
+    }
+    if (testsWithExpect === 0) {
+        issues.push("无含 expect( 的 test/it 块");
+    }
+    if (!hasGoto && !hookBlocks.some((b) => /\bpage\.goto\b/.test(b.body))) {
+        issues.push("缺少 page.goto（页面可达性未验证）");
+    }
+    if (placeholderOnlyTests.length > 0) {
+        issues.push(`以下用例仅断言 placeholder/label，缺少数据或交互: ${placeholderOnlyTests.map((t) => t.title).join(", ")}`);
+    }
+    if (!hasDataInTests && !hasInteractionInTests) {
+        issues.push("所有 test 块均缺少数据展示断言（cell/row/toContainText/waitForResponse）或交互操作");
+    }
+    const ok = testBlocks.length > 0 &&
+        testsWithExpect > 0 &&
+        (hasGoto || hookBlocks.some((b) => /\bpage\.goto\b/.test(b.body))) &&
+        placeholderOnlyTests.length === 0 &&
+        (hasDataInTests || hasInteractionInTests);
+    return {
+        ok,
+        issues,
+        stats: {
+            testCount: testBlocks.length,
+            testsWithExpect,
+            hasGoto,
+            hasDataAssertion: hasDataInTests,
+            hasInteraction: hasInteractionInTests,
+        },
+    };
+}

package/dist/core/versionIntent.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseVersionIntent = parseVersionIntent;
+exports.normalizeProductName = normalizeProductName;
+exports.isVersionDevelopmentIntent = isVersionDevelopmentIntent;
+exports.getVersionIntentInvokeCommand = getVersionIntentInvokeCommand;
+/**
+ * 解析“开发某产品某版本”的自然语言意图。
+ * 该解析器只负责提取产品与版本，不承担后续流程执行。
+ */
+function parseVersionIntent(text) {
+    const normalized = text.trim();
+    if (!normalized)
+        return null;
+    const normalizedText = normalized
+        .replace(/[：:，,。；;！!？?]/g, " ")
+        .replace(/[_-]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const patterns = [
+        /(?:开发|进行|实现|处理|做)\s*([\u4e00-\u9fa5A-Za-z][\u4e00-\u9fa5A-Za-z\s]*?)\s*[Vv]?\s*([0-9]+(?:\.[0-9]+){1,3})\s*(?:版本|需求|PRD)?/i,
+        /([\u4e00-\u9fa5A-Za-z][\u4e00-\u9fa5A-Za-z\s]*?)\s*[Vv]?\s*([0-9]+(?:\.[0-9]+){1,3})\s*(?:版本|需求)?\s*(?:开发|进行|实现|处理|做)?/i,
+    ];
+    for (const re of patterns) {
+        const match = normalizedText.match(re);
+        if (!match)
+            continue;
+        const product = normalizeProductName(match[1]);
+        const version = match[2];
+        if (!product || !version)
+            continue;
+        return { product, version };
+    }
+    return null;
+}
+function normalizeProductName(raw) {
+    const value = raw
+        .replace(/\b(PRD|需求|版本|开发|进行|实现|处理|做)\b/gi, " ")
+        .replace(/需求|版本|开发|进行|实现|处理|做/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (!value)
+        return "";
+    const upper = value.toUpperCase();
+    if (upper === "ADI" || /ADINSIGHT/i.test(value))
+        return "ADI";
+    if (upper === "OMS" || /OPERATION/i.test(value))
+        return "OMS";
+    if (/BREAK\s*X/i.test(value) || /BREAKX/i.test(value))
+        return "BreakX";
+    if (/欢盟|HUANMENG|HM/i.test(value))
+        return "欢盟";
+    if (/AD\s*TOOLS/i.test(value) || /ADTOOLS/i.test(value))
+        return "AD Tools";
+    return value;
+}
+function isVersionDevelopmentIntent(text) {
+    return parseVersionIntent(text) !== null;
+}
+function getVersionIntentInvokeCommand(options) {
+    const parsed = parseVersionIntent(options.rawText);
+    if (!parsed)
+        return null;
+    return `npx sdd-flow-kit invoke "开发 ${parsed.product} ${parsed.version} 需求" -y --agent ${options.agent}`;
+}

package/dist/core/writeNext.js

@@ -35,7 +35,7 @@ async function writeInitialNext(outputRoot, projectRoot, runId) {
         "| `tasks.md` | AC 的可执行映射（`[AC-XX]`） |",
         "",
         "## 1. Step1 — 拉取 PRD",
-        "按 `01-获取需求文档指引.md` 执行 confluence 脚本；脚本和 gate 会拒绝 `技术文档`/`后端`/`详细设计` 等非 PRD 页面，然后：",
+        "按 `01-获取需求文档指引.md` 执行 confluence 脚本（设置 `SDD_SYNC_SOURCE_DIR` 后自动同步到 `source/PRD.md` + `source/image/`）；脚本和 gate 会拒绝 `技术文档`/`后端`/`详细设计` 等非 PRD 页面，然后：",
         "```bash",
         `npx sdd-flow-kit gate --project-root "${pr}" --run-id ${runId} --expect prd-fetched`,
         `npx sdd-flow-kit phase advance --project-root "${pr}" --run-id ${runId} --to after-prd`,

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadRunSession = exports.resolveRunDir = exports.runDeliver = exports.runPropose = exports.runPhaseAdvance = exports.printGateResult = exports.runGate = exports.toRunOptions = exports.parseInvokeText = exports.runDoctor = exports.setupProject = exports.runFlow = exports.startFlowScaffold = void 0;
+exports.loadRunSession = exports.resolveRunDir = exports.tryAutoSyncSourcePrd = exports.syncSourcePrdFromDocs = exports.runSyncSourcePrd = exports.runDeliver = exports.runPropose = exports.runPhaseAdvance = exports.printGateResult = exports.runGate = exports.toRunOptions = exports.parseInvokeText = exports.runDoctor = exports.setupProject = exports.runFlow = exports.startFlowScaffold = void 0;
 var startFlow_1 = require("./steps/startFlow");
 Object.defineProperty(exports, "startFlowScaffold", { enumerable: true, get: function () { return startFlow_1.startFlowScaffold; } });
 var runFlow_1 = require("./steps/runFlow");
@@ -21,6 +21,11 @@ var runPropose_1 = require("./steps/runPropose");
 Object.defineProperty(exports, "runPropose", { enumerable: true, get: function () { return runPropose_1.runPropose; } });
 var runDeliver_1 = require("./steps/runDeliver");
 Object.defineProperty(exports, "runDeliver", { enumerable: true, get: function () { return runDeliver_1.runDeliver; } });
+var runSyncSourcePrd_1 = require("./steps/runSyncSourcePrd");
+Object.defineProperty(exports, "runSyncSourcePrd", { enumerable: true, get: function () { return runSyncSourcePrd_1.runSyncSourcePrd; } });
+var syncSourcePrd_1 = require("./core/syncSourcePrd");
+Object.defineProperty(exports, "syncSourcePrdFromDocs", { enumerable: true, get: function () { return syncSourcePrd_1.syncSourcePrdFromDocs; } });
+Object.defineProperty(exports, "tryAutoSyncSourcePrd", { enumerable: true, get: function () { return syncSourcePrd_1.tryAutoSyncSourcePrd; } });
 var resolveRun_1 = require("./steps/resolveRun");
 Object.defineProperty(exports, "resolveRunDir", { enumerable: true, get: function () { return resolveRun_1.resolveRunDir; } });
 Object.defineProperty(exports, "loadRunSession", { enumerable: true, get: function () { return resolveRun_1.loadRunSession; } });

package/dist/steps/invokeFlow.js

@@ -2,26 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseInvokeText = parseInvokeText;
 exports.toRunOptions = toRunOptions;
+const versionIntent_1 = require("../core/versionIntent");
 function parseInvokeText(text) {
-    const normalized = text.trim();
-    const patterns = [
-        /(?:开发|进行)\s*(.+?)(?:[-_\s]*)V?([0-9]+(?:\.[0-9]+){1,3})\s*(?:版本)?\s*(?:需求|PRD)?/i,
-        /([A-Za-z\u4e00-\u9fa5]+)[_\s-]?V?([0-9]+(?:\.[0-9]+){1,3})\s*版本/i,
-        /([A-Za-z]+)[_\s-]([0-9]+(?:\.[0-9]+){2,3})(?:\s|$)/i,
-    ];
-    for (const re of patterns) {
-        const match = normalized.match(re);
-        if (!match)
-            continue;
-        let product = match[1].replace(/[-_\s]+$/g, "").trim();
-        product = product.replace(/^进行/, "").trim();
-        if (/^adi$/i.test(product) || product.toUpperCase() === "ADI")
-            product = "ADI";
-        if (/^oms$/i.test(product))
-            product = "OMS";
-        return { product: product.toUpperCase(), version: match[2] };
-    }
-    return null;
+    const parsed = (0, versionIntent_1.parseVersionIntent)(text);
+    if (!parsed)
+        return null;
+    return { product: parsed.product, version: parsed.version };
 }
 function toRunOptions(args) {
     var _a, _b;

package/dist/steps/runGate.js

@@ -7,11 +7,14 @@ exports.runGate = runGate;
 exports.printGateResult = printGateResult;
 const path_1 = __importDefault(require("path"));
 const prdArtifacts_1 = require("../core/prdArtifacts");
+const syncSourcePrd_1 = require("../core/syncSourcePrd");
 const prdCoverage_1 = require("../core/prdCoverage");
 const gitDiffGuard_1 = require("../core/gitDiffGuard");
 const acMatrix_1 = require("../core/acMatrix");
 const projectRoots_1 = require("../core/projectRoots");
 const openspecGate_1 = require("../core/openspecGate");
+const demoImplementationCoverage_1 = require("../core/demoImplementationCoverage");
+const techDocQuality_1 = require("../core/techDocQuality");
 const resolveRun_1 = require("./resolveRun");
 const fs_1 = require("../core/fs");
 function fail(checks, expect, runId) {
@@ -73,7 +76,7 @@ async function resolveImplRoots(projectRoot) {
  * 脚本门禁：失败时 process.exitCode=1，成功 exit 0。
  */
 async function runGate(options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e, _f, _g;
     const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
     const checks = [];
     if (!loaded || !loaded.resolved) {
@@ -85,7 +88,27 @@ async function runGate(options) {
     const runId = resolved.runId;
     const implRoots = await resolveImplRoots(options.projectRoot);
     if (options.expect === "prd-fetched") {
-        const prd = await (0, prdArtifacts_1.isPrdFetched)(outputRoot);
+        let prd = await (0, prdArtifacts_1.isPrdFetched)(outputRoot);
+        if (!prd.ok) {
+            const product = (_b = (_a = session === null || session === void 0 ? void 0 : session.product) !== null && _a !== void 0 ? _a : runId.split("-")[1]) !== null && _b !== void 0 ? _b : "ADI";
+            const version = (_d = (_c = session === null || session === void 0 ? void 0 : session.version) !== null && _c !== void 0 ? _c : runId.split("-").slice(2).join("-")) !== null && _d !== void 0 ? _d : "";
+            const sync = await (0, syncSourcePrd_1.tryAutoSyncSourcePrd)({
+                projectRoot: options.projectRoot,
+                outputRoot,
+                product,
+                version,
+            });
+            if (sync.attempted) {
+                checks.push({
+                    name: "source-prd-sync",
+                    ok: sync.ok,
+                    detail: sync.detail,
+                });
+            }
+            if (sync.ok) {
+                prd = await (0, prdArtifacts_1.isPrdFetched)(outputRoot);
+            }
+        }
         checks.push({ name: "prd-fetched", ...prd });
         return pass(checks, options.expect, runId);
     }
@@ -105,6 +128,14 @@ async function runGate(options) {
         checks.push({ name: "questions-closed", ...closed });
         const docs = await (0, prdArtifacts_1.areAnalysisDocsReady)(outputRoot);
         checks.push({ name: "analysis-docs", ...docs });
+        const techRaw = await (0, fs_1.readFileIfExists)(path_1.default.join(outputRoot, "04-技术文档草稿.md"));
+        if (process.env.OPSX_SKIP_TECH_DOC_QUALITY !== "1") {
+            const techStruct = (0, techDocQuality_1.checkTechDocStructure)(techRaw !== null && techRaw !== void 0 ? techRaw : "");
+            checks.push({ name: "tech-doc-structure", ok: techStruct.ok, detail: techStruct.detail });
+        }
+        else {
+            checks.push({ name: "tech-doc-structure", ok: true, detail: "OPSX_SKIP_TECH_DOC_QUALITY=1 已跳过" });
+        }
         const acDefined = await (0, prdArtifacts_1.isAcceptanceChecklistDefined)(outputRoot);
         checks.push({ name: "acceptance-checklist-defined", ...acDefined });
         if (session && session.docModeOnly === false) {
@@ -173,6 +204,11 @@ async function runGate(options) {
                 detail: `openspec/changes/${changeName} 不存在，无法校验 AC 映射`,
             });
         }
+        const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+        const demoArtifactChecks = await (0, demoImplementationCoverage_1.checkDemoReferenceArtifacts)(pkgRoot, changeName);
+        for (const c of demoArtifactChecks) {
+            checks.push({ name: c.name, ok: c.ok, detail: c.detail });
+        }
         return pass(checks, options.expect, runId);
     }
     if (options.expect === "ac-signed") {
@@ -183,7 +219,10 @@ async function runGate(options) {
     if (options.expect === "prd-coverage") {
         const installRoot = (0, projectRoots_1.resolveInstallRoot)(options.projectRoot);
         const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
-        const coverage = await (0, prdCoverage_1.checkPrdCoverage)(outputRoot, pkgRoot);
+        const changeName = await readActiveChange(options.projectRoot, session, options.change);
+        const coverage = await (0, prdCoverage_1.checkPrdCoverage)(outputRoot, pkgRoot, {
+            changeName: changeName !== null && changeName !== void 0 ? changeName : undefined,
+        });
         for (const c of coverage.checks) {
             checks.push({ name: c.name, ok: c.ok, detail: c.detail });
         }
@@ -211,6 +250,11 @@ async function runGate(options) {
                 found = true;
                 const st = (0, openspecGate_1.checkOpenspecApplyReady)(root, changeName);
                 checks.push({ name: "openspec-apply-ready", ok: st.applyReady, detail: st.detail });
+                const pkgRoot = await (0, projectRoots_1.resolvePackageRoot)(installRoot);
+                const demoArtifactChecks = await (0, demoImplementationCoverage_1.checkDemoReferenceArtifacts)(pkgRoot, changeName);
+                for (const c of demoArtifactChecks) {
+                    checks.push({ name: c.name, ok: c.ok, detail: c.detail });
+                }
                 break;
             }
         }
@@ -330,8 +374,8 @@ async function runGate(options) {
                     name: "validate-report",
                     ok,
                     detail: ok
-                        ? `验收通过 (pipeline=${(_a = j.pipelineShortExitCode) !== null && _a !== void 0 ? _a : "?"}, e2e=${(_b = j.e2eExitCode) !== null && _b !== void 0 ? _b : "?"})`
-                        : `验收结果: ${(_c = j.verdict) !== null && _c !== void 0 ? _c : "unknown"}`,
+                        ? `验收通过 (pipeline=${(_e = j.pipelineShortExitCode) !== null && _e !== void 0 ? _e : "?"}, e2e=${(_f = j.e2eExitCode) !== null && _f !== void 0 ? _f : "?"})`
+                        : `验收结果: ${(_g = j.verdict) !== null && _g !== void 0 ? _g : "unknown"}`,
                 });
             }
             catch {

package/dist/steps/runGuard.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGuard = runGuard;
+const runFlow_1 = require("./runFlow");
+const invokeFlow_1 = require("./invokeFlow");
+const runSessionMode_1 = require("./runSessionMode");
+/**
+ * 识别“开发产品版本”的自然语言入口，并在命中时直接启动 SDD 流程。
+ * 该守卫用于压过普通 OpenSpec/OPSX 入口，避免版本需求误走自由提案流程。
+ */
+async function runGuard(options) {
+    const text = options.text.trim();
+    const parsed = (0, invokeFlow_1.parseInvokeText)(text);
+    if (!parsed) {
+        return {
+            ok: false,
+            action: "noop",
+            input: text,
+            detail: "未识别到版本开发意图，无需启动 sdd-flow-kit invoke。",
+        };
+    }
+    const runOptions = (0, invokeFlow_1.toRunOptions)({
+        parsed,
+        projectRoot: options.projectRoot,
+        branch: options.branch,
+        yes: options.yes,
+        dryRun: options.dryRun,
+        agent: options.agent,
+    });
+    const result = await (0, runFlow_1.runFlow)(runOptions);
+    if (!options.dryRun) {
+        await (0, runSessionMode_1.applyInvokeTextToSession)(options.projectRoot, result.runId, text);
+    }
+    return {
+        ok: true,
+        action: "invoke",
+        input: text,
+        product: parsed.product,
+        version: parsed.version,
+        runId: result.runId,
+        nextPath: `openspec/PRD/${result.runId}/NEXT.md`,
+        detail: `已识别版本开发意图并启动 SDD 流程：${parsed.product} ${parsed.version} -> runId=${result.runId}`,
+    };
+}

package/dist/steps/runSyncSourcePrd.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSyncSourcePrd = runSyncSourcePrd;
+const syncSourcePrd_1 = require("../core/syncSourcePrd");
+const resolveRun_1 = require("./resolveRun");
+/**
+ * CLI：将 docs 版本目录 PRD 同步到 openspec run 的 source/。
+ */
+async function runSyncSourcePrd(options) {
+    var _a, _b, _c, _d;
+    const loaded = await (0, resolveRun_1.loadRunSession)(options.projectRoot, options.runId);
+    if (!(loaded === null || loaded === void 0 ? void 0 : loaded.resolved)) {
+        return { ok: false, detail: "未找到 openspec/PRD/<runId> 目录", runId: null };
+    }
+    const { resolved, session } = loaded;
+    const parts = resolved.runId.split("-");
+    const product = (_b = (_a = session === null || session === void 0 ? void 0 : session.product) !== null && _a !== void 0 ? _a : parts[1]) !== null && _b !== void 0 ? _b : "ADI";
+    const version = (_d = (_c = session === null || session === void 0 ? void 0 : session.version) !== null && _c !== void 0 ? _c : parts.slice(2).join("-")) !== null && _d !== void 0 ? _d : "";
+    if (options.dryRun) {
+        return {
+            ok: true,
+            detail: `dry-run: 将把 docs 版本 PRD 同步到 ${resolved.outputRoot}/source/`,
+            runId: resolved.runId,
+        };
+    }
+    const result = await (0, syncSourcePrd_1.syncSourcePrdFromDocs)({
+        projectRoot: options.projectRoot,
+        outputRoot: resolved.outputRoot,
+        product,
+        version,
+    });
+    return {
+        ok: result.ok,
+        detail: result.detail,
+        runId: resolved.runId,
+        imageCount: result.imageCount,
+    };
+}

package/dist/steps/runValidate.js

@@ -114,7 +114,9 @@ async function runValidate(options) {
     if (remediateLoop.escalated) {
         needUserConfirmFromRemediate = true;
     }
-    let prdCoverage = await (0, prdCoverage_1.checkPrdCoverage)(loaded.resolved.outputRoot, pkgRoot);
+    let prdCoverage = await (0, prdCoverage_1.checkPrdCoverage)(loaded.resolved.outputRoot, pkgRoot, {
+        changeName: options.change,
+    });
     if (!prdCoverage.ok) {
         const failed = prdCoverage.checks.filter((c) => !c.ok).map((c) => `${c.name}: ${c.detail}`);
         const payload = {
@@ -210,7 +212,7 @@ async function runValidate(options) {
     }
     return {
         ok: true,
-        detail: "验收通过（prd-coverage + lint+type+unit + 强制 e2e），可进入交付",
+        detail: "验收通过（prd-coverage 含 E2E 深度与 API 契约 + lint+type+unit + 强制 e2e），可进入交付",
         needUserConfirm: false,
     };
 }