npm - soloforge - Versions diffs - 1.1.72 → 1.1.74 - Mend

soloforge 1.1.72 → 1.1.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (71) hide show

package/dist/gate/executors/executors_deviation_summary.js ADDED Viewed

@@ -0,0 +1,56 @@
+/**
+ * 交付偏差汇总执行器 — 读 .soloforge/gates/ 各 gate 的 check_results，调 summarizeDeviation 汇总四维偏差率。
+ * 输出「交付偏差 = X%」，gate 阈值 ≤5%（从 rule 提取）。
+ *
+ * 被谁调用：gate_engine（deviation_summary executor，挂 verify-gate 汇总 design+build+verify）
+ * 数据流：.soloforge/gates/*.json 的 check_results[].metric → summarizeDeviation → 偏差率 → CheckResult
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { summarizeDeviation } from "../contracts/deviation_metrics.js";
+export function registerDeviationSummaryExecutor() {
+    gateExecutors.register("deviation_summary", async (check, ctx) => {
+        try {
+            const gatesDir = join(ctx.projectRoot, ".soloforge", "gates");
+            if (!existsSync(gatesDir)) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: "无 gate 记录（.soloforge/gates/），跳过偏差汇总",
+                    metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const allResults = [];
+            for (const f of readdirSync(gatesDir)) {
+                if (!f.endsWith(".json"))
+                    continue;
+                try {
+                    const rec = JSON.parse(readFileSync(join(gatesDir, f), "utf-8"));
+                    if (Array.isArray(rec.check_results))
+                        allResults.push(...rec.check_results);
+                }
+                catch { /* skip corrupt */ }
+            }
+            if (allResults.length === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: "gate 记录无 check_results，跳过", metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const summary = summarizeDeviation(allResults);
+            const thresholdMatch = check.rule?.match(/(\d+(?:\.\d+)?)\s*%/);
+            const threshold = thresholdMatch ? parseFloat(thresholdMatch[1]) / 100 : 0.05;
+            const pct = summary.total_deviation * 100;
+            const passed = summary.total_deviation <= threshold;
+            const dimStr = Object.entries(summary.dimensions)
+                .map(([k, v]) => `${k}=${(v.rate * 100).toFixed(0)}%`).join("，");
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: Math.round((1 - summary.total_deviation) * 100), total: 100, deviation_rate: summary.total_deviation },
+                evidence: `交付偏差 = ${pct.toFixed(1)}%（阈值 ${(threshold * 100).toFixed(1)}%）；维度[${dimStr}]；采样 ${summary.sampled_checks} check`,
+                error: passed ? undefined : `交付偏差 ${pct.toFixed(1)}% > 阈值 ${(threshold * 100).toFixed(1)}%（确定性偏差未清零；语义偏差另需 AI/人工/E2E）`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `deviation_summary 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_deviation_summary.js.map

package/dist/gate/executors/executors_deviation_summary.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_deviation_summary.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_deviation_summary.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_field_mapping.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"executors_field_mapping.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_field_mapping.ts"],"names":[],"mappings":"AAiEA,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,~~CAuB9E~~;AAED;;;;mCAImC;AACnC,wBAAgB,4BAA4B,IAAI,IAAI,CAgGnD"}
1	+ {"version":3,"file":"executors_field_mapping.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_field_mapping.ts"],"names":[],"mappings":"AAiEA,oDAAoD;AACpD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAwB9E;AAED;;;;mCAImC;AACnC,wBAAgB,4BAA4B,IAAI,IAAI,CAgGnD"}

package/dist/gate/executors/executors_field_mapping.js CHANGED Viewed

@@ -69,8 +69,9 @@ export function parseSchemaSqlTables(content) {
     const fields = new Map();
     // CREATE TABLE `表` (字段 VARCHAR(128), ...) ENGINE=InnoDB... / COMMENT='表注释' / ; —— body 到“表的 ) 后跟表选项或 ;”
     // 用 )\s*(?:ENGINE|DEFAULT|CHARSET|COLLATE|COMMENT|;) 定位表的 )，避免字段 VARCHAR(128) 的 ) 让非贪婪 body 提前截断
-    // COMMENT 锚点：MySQL 允许 ) COMMENT='表注释'（无 ENGINE，默认 InnoDB）——漏则该类 DDL 全 miss 致 schemaFields 空 → 全部表不存在误报
-    const tableRe = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"]?(\w+)[`"]?\s*\(([\s\S]*?)\)\s*(?:ENGINE|DEFAULT|CHARSET|COLLATE|COMMENT|;)/gi;
+    // COMMENT 锚点：MySQL 表级注释是 `COMMENT='表注释'`（有等号），字段级注释是 `COMMENT '字段注释'`（空格无等号）。
+    // 终止锚点须用 COMMENT\s*= 只匹配表级——否则字段 `VARCHAR(64) COMMENT '简称'` 的 ) 后 COMMENT 误触发终止，body 提前截断致第5字段起全丢（waiver 81dd44a6 的真根因）。
+    const tableRe = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"]?(\w+)[`"]?\s*\(([\s\S]*?)\)\s*(?:ENGINE|DEFAULT|CHARSET|COLLATE|COMMENT\s*=|;)/gi;
     let tm;
     while ((tm = tableRe.exec(content)) !== null) {
         const table = tm[1];

package/dist/gate/executors/executors_field_mapping.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"executors_field_mapping.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_field_mapping.ts"],"names":[],"mappings":"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~~uGAAuG~~;~~IACvG~~,MAAM,OAAO,GAAG,~~6HAA6H~~,CAAC;~~IAC9I~~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"}
1	+ {"version":3,"file":"executors_field_mapping.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_field_mapping.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_openapi_conformance.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+/** 扫描代码路由 → Map<path, Set<method>>。支持 Java Spring(@XxxMapping) 与 Node(express/fastify router.method)。 */
+export declare function extractCodeRoutes(projectRoot: string, codeGlob: string): Map<string, Set<string>>;
+/** 解析 openapi.yaml paths → Set<"METHOD path">。 */
+export declare function parseOpenapiOps(content: string): Set<string>;
+export declare function registerOpenapiConformanceExecutor(): void;
+//# sourceMappingURL=executors_openapi_conformance.d.ts.map

package/dist/gate/executors/executors_openapi_conformance.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_openapi_conformance.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_openapi_conformance.ts"],"names":[],"mappings":"AAcA,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAqBjG;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAe5D;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAwCzD"}

package/dist/gate/executors/executors_openapi_conformance.js ADDED Viewed

@@ -0,0 +1,119 @@
+/**
+ * openapi conformance 执行器 — 代码实现的 API 路由 ↔ openapi.yaml operation 一致性。
+ * 确定性偏差：实现层（代码↔契约）。破 code-first 反向生成覆盖契约——代码必须正面实现 openapi 声明的每个 operation。
+ * 无代码（build 未实现）→ skip。
+ *
+ * 被谁调用：gate_engine（openapi_conformance executor）
+ * 数据流：evidence_required[0]=openapi.yaml；evidence_required[1]=backend 下 Java 代码 glob → 对比 → CheckResult
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveArtifactsByGlob } from "../../shared/glob_path.js";
+/** 扫描代码路由 → Map<path, Set<method>>。支持 Java Spring(@XxxMapping) 与 Node(express/fastify router.method)。 */
+export function extractCodeRoutes(projectRoot, codeGlob) {
+    const routes = new Map();
+    for (const rel of resolveArtifactsByGlob(projectRoot, codeGlob)) {
+        let content = "";
+        try {
+            content = readFileSync(join(projectRoot, rel), "utf-8");
+        }
+        catch {
+            continue;
+        }
+        // Java: 类级 @RequestMapping("/api/v1") 作前缀，方法级 @GetMapping("/users") 组合 → /api/v1/users
+        // （不组合则只剩 /users，与 openapi 的 /api/v1/users 对不上 → 全 operation 误报缺失）
+        const clsMatch = content.match(/@RequestMapping\s*\(\s*(?:value\s*=\s*)?["']([^"']+)["']/);
+        const prefix = clsMatch ? clsMatch[1] : "";
+        for (const m of content.matchAll(/@(Get|Post|Put|Patch|Delete)Mapping\s*\(\s*(?:value\s*=\s*)?["']([^"']+)["']/g)) {
+            const path = prefix + m[2];
+            if (!routes.has(path))
+                routes.set(path, new Set());
+            routes.get(path).add(m[1].toLowerCase());
+        }
+        // Node: router.get("/x", ...) / app.post("/x", ...)
+        for (const m of content.matchAll(/\.(get|post|put|patch|delete)\s*\(\s*["']([^"']+)["']/g)) {
+            const path = m[2];
+            if (!routes.has(path))
+                routes.set(path, new Set());
+            routes.get(path).add(m[1]);
+        }
+    }
+    return routes;
+}
+/** 解析 openapi.yaml paths → Set<"METHOD path">。 */
+export function parseOpenapiOps(content) {
+    const ops = new Set();
+    let curPath = null;
+    let inPaths = false;
+    for (const raw of content.split("\n")) {
+        if (/^paths:\s*$/.test(raw)) {
+            inPaths = true;
+            curPath = null;
+            continue;
+        }
+        if (!inPaths)
+            continue;
+        const line = raw.replace(/\s+$/, "");
+        if (line && !line.startsWith(" ") && !line.startsWith("#") && /^(components|servers|security|tags|externalDocs|info|openapi):/.test(line)) {
+            inPaths = false;
+            continue;
+        }
+        const pm = line.match(/^  (\/[^:]+):\s*$/);
+        if (pm) {
+            curPath = pm[1];
+            continue;
+        }
+        if (curPath === null)
+            continue;
+        const mm = line.match(/^    (get|post|put|patch|delete):/);
+        if (mm)
+            ops.add(`${mm[1].toUpperCase()} ${curPath}`);
+    }
+    return ops;
+}
+export function registerOpenapiConformanceExecutor() {
+    gateExecutors.register("openapi_conformance", async (check, ctx) => {
+        try {
+            const openapiRel = check.evidence_required?.[0] ?? "docs/api/openapi.yaml";
+            const codeGlob = check.evidence_required?.[1] ?? "backend/**/*.java";
+            const codeRoutes = extractCodeRoutes(ctx.projectRoot, codeGlob);
+            if (codeRoutes.size === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: `无代码路由（${codeGlob} 未匹配，build 未实现），跳过 openapi conformance`,
+                    metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            let yamlContent = "";
+            try {
+                yamlContent = readFileSync(join(ctx.projectRoot, openapiRel), "utf-8");
+            }
+            catch {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: `openapi.yaml 不存在（${openapiRel}），跳过`, metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const yamlOps = parseOpenapiOps(yamlContent);
+            // 代码路由展开为 METHOD path 集合（类级 @RequestMapping 前缀已含在 path）
+            const codeOps = new Set();
+            for (const [path, methods] of codeRoutes) {
+                for (const me of methods)
+                    codeOps.add(`${me.toUpperCase()} ${path}`);
+            }
+            const missing = [...yamlOps].filter((op) => !codeOps.has(op));
+            const deviationRate = yamlOps.size === 0 ? 0 : missing.length / yamlOps.size;
+            const passed = missing.length === 0;
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: yamlOps.size - missing.length, total: yamlOps.size, deviation_rate: deviationRate },
+                evidence: passed
+                    ? `openapi conformance：代码实现全部 ${yamlOps.size} 个 operation`
+                    : `openapi 契约未实现：${yamlOps.size - missing.length}/${yamlOps.size} 有代码；缺 ${missing.slice(0, 5).join(", ")}`,
+                error: passed ? undefined : `代码未实现这些 openapi operation（实现偏差 ${(deviationRate * 100).toFixed(1)}%）：${missing.slice(0, 3).join(", ")}`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `openapi_conformance 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_openapi_conformance.js.map

package/dist/gate/executors/executors_openapi_conformance.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_openapi_conformance.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_openapi_conformance.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_proto_interaction.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare function registerProtoInteractionExecutor(): void;
2	+ //# sourceMappingURL=executors_proto_interaction.d.ts.map

package/dist/gate/executors/executors_proto_interaction.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"executors_proto_interaction.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_proto_interaction.ts"],"names":[],"mappings":"AAwBA,wBAAgB,gCAAgC,IAAI,IAAI,CA0CvD"}

package/dist/gate/executors/executors_proto_interaction.js ADDED Viewed

@@ -0,0 +1,65 @@
+/**
+ * 原型交互覆盖率执行器 — 原型交互需求密度 vs API operation 供给的粗略比例信号（heuristic）。
+ *
+ * 确定性边界：原型无结构化交互声明（按钮/操作是自由文本），本 check 只给"交互密度 vs API 数"的
+ * 粗略比例信号，severity=warning（留痕不阻断）——比例失调（交互需求远多于 API 供给）提示可能漏接口。
+ * 精确的原型交互→API 映射需原型声明交互（未来增强），当前从交互关键词反推。
+ *
+ * 被谁调用：gate_engine（proto_interaction_coverage executor）
+ * 数据流：evidence_required=[原型 glob, openapi.yaml] → 交互关键词计数 vs operation 数 → CheckResult（warning + metric）
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveArtifactsByGlob } from "../../shared/glob_path.js";
+/** 原型交互关键词（自由文本反推交互需求）。 */
+const INTERACTION_RE = /(?:按钮|编辑|新增|删除|修改|更新|导出|查询|搜索|提交|确认|审批|上传|下载|选择|切换|勾选|点击|登录|登出|支付|结算)/g;
+/** 统计 openapi.yaml operation 数。 */
+function countOpenapiOps(content) {
+    return (content.match(/^    (get|post|put|patch|delete):/gm) ?? []).length;
+}
+export function registerProtoInteractionExecutor() {
+    gateExecutors.register("proto_interaction_coverage", async (check, ctx) => {
+        try {
+            const protoGlob = check.evidence_required?.[0] ?? "docs/analyze/*/pages/*-原型说明.md";
+            const openapiRel = check.evidence_required?.[1] ?? "docs/api/openapi.yaml";
+            const protoFiles = resolveArtifactsByGlob(ctx.projectRoot, protoGlob);
+            if (protoFiles.length === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: `无原型（${protoGlob}，scope≠frontend），跳过`, metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            let interactionCount = 0;
+            for (const rel of protoFiles) {
+                try {
+                    interactionCount += (readFileSync(join(ctx.projectRoot, rel), "utf-8").match(INTERACTION_RE) ?? []).length;
+                }
+                catch { /* skip */ }
+            }
+            const yamlAbs = join(ctx.projectRoot, openapiRel);
+            if (!existsSync(yamlAbs)) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: "无 openapi.yaml，跳过", metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const opCount = countOpenapiOps(readFileSync(yamlAbs, "utf-8"));
+            if (interactionCount === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true,
+                    evidence: "原型无交互关键词，跳过", metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            // 粗略比例：API operation / 交互需求。比例 < 0.3 视为交互需求远多于 API 供给（可能漏接口）。
+            const ratio = opCount / interactionCount;
+            const deviationRate = Math.max(0, 1 - ratio / 0.5); // 以 1:2（每2交互1API）为合理基线
+            const passed = ratio >= 0.3;
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: opCount, total: interactionCount, deviation_rate: Math.min(1, deviationRate) },
+                evidence: `原型交互关键词 ${interactionCount} vs openapi operation ${opCount}（比例 ${(ratio * 100).toFixed(0)}%）${passed ? "，比例合理" : "，交互需求远多于 API 供给，疑似漏接口"}`,
+                error: passed ? undefined : `原型交互密度 vs API 比例失调（${(ratio * 100).toFixed(0)}%，heuristic 信号，warning）`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `proto_interaction_coverage 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_proto_interaction.js.map

package/dist/gate/executors/executors_proto_interaction.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_proto_interaction.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_proto_interaction.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_required_artifact.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare function registerRequiredArtifactExecutor(): void;
2	+ //# sourceMappingURL=executors_required_artifact.d.ts.map

package/dist/gate/executors/executors_required_artifact.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"executors_required_artifact.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_required_artifact.ts"],"names":[],"mappings":"AAcA,wBAAgB,gCAAgC,IAAI,IAAI,CAoCvD"}

package/dist/gate/executors/executors_required_artifact.js ADDED Viewed

@@ -0,0 +1,49 @@
+/**
+ * 必产物存在性执行器 — 校验 evidence_required 列出的产物文件都存在（通用）。
+ *
+ * 用途：ADR-EXISTS（架构决策记录须存在）等"产物文件存在性"硬校验。
+ * 区别 file_evidence：file_evidence 校验运行时证据目录（截图/json），本 executor 校验源产物文件。
+ *
+ * 被谁调用：gate_engine（required_artifact_check executor）
+ * 数据流：evidence_required=[产物路径...] → existsSync 逐个 → CheckResult（含 metric）
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+export function registerRequiredArtifactExecutor() {
+    gateExecutors.register("required_artifact_check", async (check, ctx) => {
+        try {
+            const reqs = check.evidence_required ?? [];
+            if (reqs.length === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: "无 evidence_required，跳过", metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            // 多文件时，第一个为前提产物（如架构文档）；前提未产出 → 阶段未到，skip（不 fail，防 verify requirement_analysis 时误拦）
+            let targets = reqs;
+            if (reqs.length > 1) {
+                if (!existsSync(join(ctx.projectRoot, reqs[0]))) {
+                    return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                        evidence: `前提产物 ${reqs[0]} 未产出（阶段未到），跳过`, metric: { passed: 0, total: 0, deviation_rate: 0 } };
+                }
+                targets = reqs.slice(1);
+            }
+            const missing = [];
+            for (const rel of targets) {
+                if (!existsSync(join(ctx.projectRoot, rel)))
+                    missing.push(rel);
+            }
+            const passed = missing.length === 0;
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: targets.length - missing.length, total: targets.length, deviation_rate: missing.length / targets.length },
+                evidence: passed ? `必产物全部存在：${targets.length}/${targets.length}` : `必产物缺失：${missing.join(", ")}`,
+                error: passed ? undefined : `必产物文件不存在：${missing.join(", ")}`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `required_artifact_check 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_required_artifact.js.map

package/dist/gate/executors/executors_required_artifact.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_required_artifact.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_required_artifact.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_schema_conformance.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+/** 解析 SQL 的 CREATE TABLE → Map<表, Set<字段>>。复用 FMAP 修复后的 COMMENT= 锚点。 */
+export declare function parseTables(content: string): Map<string, Set<string>>;
+export declare function registerSchemaConformanceExecutor(): void;
+//# sourceMappingURL=executors_schema_conformance.d.ts.map

package/dist/gate/executors/executors_schema_conformance.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"executors_schema_conformance.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_schema_conformance.ts"],"names":[],"mappings":"AAcA,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAerE;AAED,wBAAgB,iCAAiC,IAAI,IAAI,CA6CxD"}

package/dist/gate/executors/executors_schema_conformance.js ADDED Viewed

@@ -0,0 +1,91 @@
+/**
+ * schema conformance 执行器 — Flyway migration 建表 ↔ schema.sql 表/字段一致性。
+ * 确定性偏差：实现层（数据↔契约）。migration 实际建表须与权威 schema.sql 一致。
+ * 无 migration（build 未实现）→ skip。
+ *
+ * 被谁调用：gate_engine（schema_conformance executor）
+ * 数据流：evidence_required[0]=schema.sql；evidence_required[1]=backend 下 migration V*.sql glob → 对比 → CheckResult
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolveArtifactsByGlob } from "../../shared/glob_path.js";
+/** 解析 SQL 的 CREATE TABLE → Map<表, Set<字段>>。复用 FMAP 修复后的 COMMENT= 锚点。 */
+export function parseTables(content) {
+    const tables = new Map();
+    const tableRe = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"]?(\w+)[`"]?\s*\(([\s\S]*?)\)\s*(?:ENGINE|DEFAULT|CHARSET|COLLATE|COMMENT\s*=|;)/gi;
+    let m;
+    while ((m = tableRe.exec(content)) !== null) {
+        const fields = new Set();
+        for (const line of m[2].split(/[,\n]/)) {
+            const t = line.trim();
+            if (!t || /\b(KEY|CONSTRAINT|PRIMARY|FOREIGN|UNIQUE|INDEX|CHECK)\b/i.test(t))
+                continue;
+            const fm = t.match(/^[`"]?(\w+)[`"]?\s+/);
+            if (fm)
+                fields.add(fm[1]);
+        }
+        tables.set(m[1], fields);
+    }
+    return tables;
+}
+export function registerSchemaConformanceExecutor() {
+    gateExecutors.register("schema_conformance", async (check, ctx) => {
+        try {
+            const schemaRel = check.evidence_required?.[0] ?? "docs/design/schema.sql";
+            const migGlob = check.evidence_required?.[1] ?? "backend/**/migration/V*.sql";
+            const migFiles = resolveArtifactsByGlob(ctx.projectRoot, migGlob);
+            if (migFiles.length === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: `无 Flyway migration（${migGlob} 未匹配，build 未实现），跳过 schema conformance`,
+                    metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const migContent = migFiles.map((r) => { try {
+                return readFileSync(join(ctx.projectRoot, r), "utf-8");
+            }
+            catch {
+                return "";
+            } }).join("\n");
+            const migTables = parseTables(migContent);
+            let schemaContent = "";
+            try {
+                schemaContent = readFileSync(join(ctx.projectRoot, schemaRel), "utf-8");
+            }
+            catch {
+                return { check_id: check.id, executed_by: "code", passed: false, error: `schema.sql 不存在: ${schemaRel}` };
+            }
+            const schemaTables = parseTables(schemaContent);
+            // 对比：migration 建的表须在 schema.sql，字段一致
+            const problems = [];
+            let consistent = 0;
+            for (const [tbl, fields] of migTables) {
+                const sf = schemaTables.get(tbl);
+                if (!sf) {
+                    problems.push(`migration 建表 ${tbl} 不在 schema.sql`);
+                    continue;
+                }
+                const missing = [...fields].filter((f) => !sf.has(f));
+                if (missing.length === 0)
+                    consistent++;
+                else
+                    problems.push(`${tbl} 字段不一致(缺 ${missing.slice(0, 3).join(",")})`);
+            }
+            const total = migTables.size;
+            const deviationRate = total === 0 ? 0 : (total - consistent) / total;
+            const passed = problems.length === 0;
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: consistent, total, deviation_rate: deviationRate },
+                evidence: passed
+                    ? `schema conformance：${consistent}/${total} migration 表与 schema.sql 一致`
+                    : `migration↔schema.sql 不一致：${consistent}/${total}；${problems.slice(0, 5).join("; ")}`,
+                error: passed ? undefined : `migration 建表与权威 schema.sql 偏差（实现偏差 ${(deviationRate * 100).toFixed(1)}%）`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `schema_conformance 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_schema_conformance.js.map

package/dist/gate/executors/executors_schema_conformance.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"executors_schema_conformance.js","sourceRoot":"","sources":["../../../src/gate/executors/executors_schema_conformance.ts"],"names":[],"mappings":"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"}

package/dist/gate/executors/executors_section_integrity.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export declare function registerSectionIntegrityExecutor(): void;
2	+ //# sourceMappingURL=executors_section_integrity.d.ts.map

package/dist/gate/executors/executors_section_integrity.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"executors_section_integrity.d.ts","sourceRoot":"","sources":["../../../src/gate/executors/executors_section_integrity.ts"],"names":[],"mappings":"AAsCA,wBAAgB,gCAAgC,IAAI,IAAI,CAmDvD"}

package/dist/gate/executors/executors_section_integrity.js ADDED Viewed

@@ -0,0 +1,95 @@
+/**
+ * section 完整性执行器 — 校验架构设计文档指定 section（§4 模块划分 / §9 状态机）有结构化内容（表格/状态图），非 bullet 空话。
+ *
+ * 确定性偏差：design_doc 结构强度。补 §4/§9 的结构约束——block_check 切块语义（匹配行到下个匹配）对单 section 不精确
+ * （§4 块会含 §5-8），故用按 ## 精确切 section + 指定 section 校验。
+ *
+ * 被谁调用：gate_engine（section_integrity_check executor）
+ * 数据流：evidence_required[0]=架构设计文档 → 切 ## section → §4 须表格≥3 行，§9 须 stateDiagram+状态表 → CheckResult
+ */
+import { gateExecutors } from "../gate_executors.js";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** 按 ## 切 section → [{title, body}]。 */
+function splitSections(content) {
+    const sections = [];
+    let cur = null;
+    for (const l of content.split("\n")) {
+        if (/^##\s/.test(l)) {
+            if (cur)
+                sections.push({ title: cur.title, body: cur.body.join("\n") });
+            cur = { title: l, body: [] };
+        }
+        else if (cur)
+            cur.body.push(l);
+    }
+    if (cur)
+        sections.push({ title: cur.title, body: cur.body.join("\n") });
+    return sections;
+}
+function findSectionBody(sections, re) {
+    const s = sections.find((x) => re.test(x.title));
+    return s ? s.body : null;
+}
+/** 表格数据行：含 | 且非分隔行（纯 |/ -/:/空格）。 */
+function countTableDataRows(text) {
+    return text.split("\n").filter((l) => l.includes("|") && !/^\s*\|?[\s\-:|]+\|?\s*$/.test(l)).length;
+}
+export function registerSectionIntegrityExecutor() {
+    gateExecutors.register("section_integrity_check", async (check, ctx) => {
+        try {
+            const archRel = check.evidence_required?.[0] ?? "docs/architecture/01-架构设计文档.md";
+            const abs = join(ctx.projectRoot, archRel);
+            if (!existsSync(abs)) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: `架构文档未产出（${archRel}），跳过 section 完整性` };
+            }
+            const sections = splitSections(readFileSync(abs, "utf-8"));
+            const problems = [];
+            let checked = 0;
+            let ok = 0;
+            const s4 = findSectionBody(sections, /^##\s+4\b/);
+            if (s4 !== null) {
+                checked++;
+                const rows = countTableDataRows(s4);
+                if (rows >= 3)
+                    ok++;
+                else
+                    problems.push(`§4 模块划分表格数据行不足（${rows}/3，禁 bullet 空话）`);
+            }
+            const s9 = findSectionBody(sections, /^##\s+9\b/);
+            if (s9 !== null) {
+                checked++;
+                const hasState = /stateDiagram(-v2)?/.test(s9);
+                const rows = countTableDataRows(s9);
+                if (hasState && rows >= 2)
+                    ok++;
+                else {
+                    const miss = [];
+                    if (!hasState)
+                        miss.push("Mermaid stateDiagram");
+                    if (rows < 2)
+                        miss.push(`状态表（${rows}/2 行）`);
+                    problems.push(`§9 状态机缺 ${miss.join(" + ")}`);
+                }
+            }
+            if (checked === 0) {
+                return { check_id: check.id, executed_by: "code", passed: true, skipped: true,
+                    evidence: "架构无 §4/§9 section（章节存在由 ARCH-STRUCT 管），跳过",
+                    metric: { passed: 0, total: 0, deviation_rate: 0 } };
+            }
+            const passed = problems.length === 0;
+            return {
+                check_id: check.id, executed_by: "code", passed,
+                metric: { passed: ok, total: checked, deviation_rate: (checked - ok) / checked },
+                evidence: passed ? `section 完整：§4/§9 均有结构化内容（表格/状态图）` : `section 不完整：${problems.join("；")}`,
+                error: passed ? undefined : `架构 §4/§9 缺结构化内容（${problems.join("；")}）`,
+            };
+        }
+        catch (err) {
+            return { check_id: check.id, executed_by: "code", passed: false,
+                error: `section_integrity_check 执行异常（fail-closed）：${err instanceof Error ? err.message : String(err)}` };
+        }
+    });
+}
+//# sourceMappingURL=executors_section_integrity.js.map