progmune-runtime 3.6.1 → 3.7.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## [3.7.1] — 2026-08-23
+
+### 修复：词段匹配门控（仅项目函数适用）
+
+- `ssg-bridge` 的词段匹配（Strategy 2）增加 `projectFunctions` 门控：只对项目函数做词段匹配——它是为改名协议原语设计的（协议原语必然是项目内函数，如 S5 的 `create_active_session`），外部库调用（如 Node 的 `readFileSync`）经词段撞上 `read_file` 是纯噪声
+- 外部 API 的语义桥接不受影响：alias 配置（Strategy 0b）与 domain 关键词（Strategy 3）照常工作；未提供集合时保持旧行为（向后兼容）
+- 共享集合构造 `collectProjectFunctionNames`（`src/call-sequence.ts`，全名/裸名/小写变体三形态收录），生产引擎与协议盲测扫描器同款传入
+
+### 修复：合并形态 ir.json 恢复 IR-first（3.5.0 起静默回退的回归）
+
+- `extractCallSequencesFromIR` 与项目 IR 注解合并块兼容 `{ typeMap, functions }` 合并对象（execute/MCP 写盘形态）——此前 `Array.isArray` 守卫使所有 TS 项目自 3.5.0 起静默走正则回退，P4.5/P4.6 的 IR-first 语义在合并形态下未生效
+- 配合词段门控后实测：自身 1966 函数 451 入口序列，SSG 违规 346→**2**（均真实命中，`writeTrajectoryFile`→`write_file`），Trust 总分 60→83（APPROVED）
+- 协议盲测 v1.2 复测零漂移：66 可测金标 64 检出（Recall 97% / Precision 100% / 0 FP），S5 改名检测不受门控影响
+
+## [3.7.0] — 2026-08-23
+
+### 新增：P4.6 跨函数传播（入口展开 + 片段抑制）
+
+- `src/call-sequence.ts`：`buildCallSequences` 共享序列构建——入口函数（不被项目函数调用）的调用链做传递展开（内联被调项目函数体，深度 ≤4、环安全）；非入口函数的孤立片段不再单独验证（违规归因到调用它的入口），消除 helper 片段误报
+- 规则名函数与叶子原语（函数体只调外部调用）不内联——协议原语只在调用链内验证，调用名保留给匹配层
+- trust 引擎接线：`extractCallSequencesFromIR` 换用 `buildCallSequences`，规则名集合作为展开保留单元；生效范围如实记录——ir.json 为函数数组形态（协议盲测语料 / extractIR 直出）时 P4.6 生效；合并形态 `{ typeMap, functions }`（execute/MCP 写盘）沿用既有回退路径（3.5.0 起的既有行为，恢复 IR-first 需先做词段匹配门控的 FP 打磨）
+- 边界（与 C 的 L3 同类，如实记录）：展开是语法内联（调用链扁平化），不做数据流/指针/分支分析
+
+### 新增：协议盲测 v1.2（跨函数 + 任意命名变体）
+
+- 语料网格扩至 38 项目：T0–T5 × S1–S5（30）+ T6/T7 × S1–S4（8）；新增违规类 T6 cross_function_precondition、T7 cross_function_cleanup、风格 S5 renamed（无 `@progmune` 注解 + 改名协议函数，词段匹配验证）
+- **复测结果：66 可测金标，检出 64（Recall 97%）/ Precision 100% / 0 FP**；2 处漏检为 T2×S5 注解依赖前置约束（无注解项目级前置不可恢复，命名匹配本身正常），金标与基线如实单列
+- 回归测试 `tests/python-protocol-benchmark.test.ts` 扩至 6 例（T1 broken / T0 clean 含分离式清洁链 / T5 endState / T6 cross-function / S5 renamed）
+
+### 文档
+
+- 覆盖矩阵（中英）Python 协议行（Auth / Resource Lifecycle）由 ⚠️ 升级 ✅，证据引用协议盲测 v1.2；升级条件（跨函数传播、任意命名验证）全部勾选
+- 基线 `BASELINE_PROTOCOL_PYTHON_v1.md` 更新至 v1.2：语料、结果、已知缺口（注解依赖 / LLM 桥接不在测量范围 / P4.6 展开语义边界）如实记录
+
 ## [3.6.1] — 2026-08-23
 
 ### 文档

package/dist/call-sequence.js

@@ -13,17 +13,47 @@
  * 不做数据流/指针/分支分析；跨文件依赖 IR 的 calls[] 图。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProjectFn = isProjectFn;
+exports.collectProjectFunctionNames = collectProjectFunctionNames;
 exports.buildCallSequences = buildCallSequences;
 const MAX_DEPTH = 4;
 /** 项目函数判定：有真实文件且非外部导入条目（external 条目无函数体可内联）。 */
 function isProjectFn(f) {
     return !f.external && !!f.file && f.file !== "(external)";
 }
+/**
+ * 构建项目函数名集合——词段匹配门控用（ssg-bridge 的 projectFunctions 参数）。
+ * 每个项目函数收录三种形态：全名（FlowService.svc_x）、裸名（svc_x）与
+ * 小写变体（调用名大小写差异，如 createActiveSession vs createactivesession）。
+ */
+function collectProjectFunctionNames(ir) {
+    const names = new Set();
+    for (const f of ir) {
+        if (!isProjectFn(f))
+            continue;
+        const name = String(f.name || "");
+        if (!name)
+            continue;
+        const lower = name.toLowerCase();
+        names.add(name);
+        names.add(lower);
+        const dotIdx = name.lastIndexOf(".");
+        if (dotIdx >= 0) {
+            const bare = name.slice(dotIdx + 1);
+            names.add(bare);
+            names.add(bare.toLowerCase());
+        }
+    }
+    return names;
+}
 /**
  * 从 IR 构建验证序列：入口函数展开 + 非入口抑制。
  * @param ir - FunctionInfo 列表（TS 或 Python 提取器输出）
+ * @param keepNames - 协议规则名集合：命中这些名字的项目函数是验证单元
+ *   （其调用名保留给规则匹配），不内联其函数体——否则 create_session 等
+ *   规则函数的平凡函数体会把调用名"吞掉"
  */
-function buildCallSequences(ir) {
+function buildCallSequences(ir, keepNames) {
     const fnMap = new Map();
     for (const f of ir) {
         if (isProjectFn(f))
@@ -39,19 +69,30 @@ function buildCallSequences(ir) {
                 calledBy.add(c);
         }
     }
-    const expand = (name, depth, visiting) => {
-        if (depth > MAX_DEPTH || visiting.has(name))
-            return [];
-        const fn = fnMap.get(name);
-        if (!fn)
-            return [name]; // 外部调用：保留给规则匹配
-        visiting.add(name);
+    /** 展开函数体内的调用（入口序列 = 函数体调用，不含函数自己的名字） */
+    const expandBody = (fn, depth, visiting) => {
         const out = [];
         for (const c of fn.calls || []) {
             if (typeof c !== "string" || c.startsWith("__progmune_"))
                 continue;
-            out.push(...expand(c, depth + 1, visiting));
+            out.push(...expandCall(c, depth, visiting));
         }
+        return out;
+    };
+    const expandCall = (name, depth, visiting) => {
+        if (depth > MAX_DEPTH || visiting.has(name))
+            return [];
+        const fn = fnMap.get(name);
+        // 外部调用或规则函数：调用名保留给匹配层，不内联
+        if (!fn || (keepNames && keepNames.has(name)))
+            return [name];
+        // 叶子函数（函数体只调外部原语）是协议原语或叶子 helper：
+        // 保留名字，不内联——否则 S5 改名协议函数的平凡函数体会吞掉调用名
+        const hasProjectCalls = (fn.calls || []).some((c) => fnMap.has(c));
+        if (!hasProjectCalls)
+            return [name];
+        visiting.add(name);
+        const out = expandBody(fn, depth + 1, visiting);
         visiting.delete(name);
         return out;
     };
@@ -61,7 +102,9 @@ function buildCallSequences(ir) {
             continue;
         if (calledBy.has(f.name))
             continue; // 非入口：片段并入调用方
-        const calls = expand(f.name, 0, new Set());
+        if (keepNames && keepNames.has(f.name))
+            continue; // 协议原语不是入口：只在调用链内验证
+        const calls = expandBody(f, 0, new Set());
         if (calls.length === 0)
             continue;
         sequences.push({ calls, file: f.file, function: f.name });

package/dist/trust/engine.js

@@ -62,6 +62,7 @@ const api_semantic_mapper_1 = require("./api-semantic-mapper");
 const protocol_domain_validator_1 = require("./protocol-domain-validator");
 const call_graph_propagator_1 = require("./call-graph-propagator");
 const ssg_bridge_1 = require("./ssg-bridge");
+const call_sequence_1 = require("../call-sequence");
 // ── Main Entry Point ──
 async function evaluateTrust(ctx) {
     const engineVersion = "trust-runtime-v1.0.0";
@@ -719,12 +720,26 @@ async function collectProtocolViolations(ctx, callGraph) {
             }
             catch { /* best-effort — 回退正则扫描 */ }
         }
+        // ── SSG State Machine: load protocol rules once ──
+        protocolRulesData = (0, ssg_bridge_1.loadProtocolRules)(ctx.projectPath);
         // ── Phase 1-5 Semantic Pipeline ──
-        const callSequences = extractCallSequencesFromProject(ctx.projectPath, ctx.language);
+        // 规则名集合作为展开的保留单元：规则函数不内联（调用名保留给匹配层）
+        const callSequences = extractCallSequencesFromProject(ctx.projectPath, ctx.language, protocolRulesData ? new Set(protocolRulesData.rules.keys()) : undefined);
         const flaggedCount = { value: 0 };
         const cleanCount = { value: 0 };
-        // ── SSG State Machine: load protocol rules once ──
-        protocolRulesData = (0, ssg_bridge_1.loadProtocolRules)(ctx.projectPath);
+        // ── P4.6.1: 词段匹配门控的项目函数集合（best-effort，与注解合并共用 ir.json） ──
+        // 词段匹配只对项目函数适用（改名协议原语）；外部库调用走 alias/关键词桥接。
+        let projectFunctions;
+        try {
+            const fs = require("fs");
+            const irPath = path.join(ctx.projectPath, "ir.json");
+            if (fs.existsSync(irPath)) {
+                const ir = JSON.parse(fs.readFileSync(irPath, "utf-8"));
+                const functions = Array.isArray(ir) ? ir : (ir.functions || []);
+                projectFunctions = (0, call_sequence_1.collectProjectFunctionNames)(functions);
+            }
+        }
+        catch { /* best-effort */ }
         // ── P4.5: 合并项目 IR 注解协议（IR 优先，缺 namespace 继承内置 JSON） ──
         // 内置 protocols.json 的规则是通用弱约束（如 generate_jwt pre=[]），
         // 项目文件里的 @protocol 注解才是项目真实协议（如 pre=[PASSWORD_VERIFIED]）。
@@ -735,17 +750,18 @@ async function collectProtocolViolations(ctx, callGraph) {
                 const irPath = path.join(ctx.projectPath, "ir.json");
                 if (fs.existsSync(irPath)) {
                     const ir = JSON.parse(fs.readFileSync(irPath, "utf-8"));
-                    if (Array.isArray(ir)) {
-                        for (const f of ir) {
-                            if (!f.protocol)
-                                continue;
-                            const protocol = { ...f.protocol };
-                            const existing = protocolRulesData.rules.get(String(f.name));
-                            if (existing?.namespace && !protocol.namespace) {
-                                protocol.namespace = existing.namespace;
-                            }
-                            protocolRulesData.rules.set(String(f.name), protocol);
+                    // ir.json 两种形态：extractIR/extractIRPython 的裸数组、extractProjectIR
+                    // 的 { typeMap, functions } 合并对象（execute/MCP 写盘）——统一取函数列表。
+                    const functions = Array.isArray(ir) ? ir : (ir.functions || []);
+                    for (const f of functions) {
+                        if (!f.protocol)
+                            continue;
+                        const protocol = { ...f.protocol };
+                        const existing = protocolRulesData.rules.get(String(f.name));
+                        if (existing?.namespace && !protocol.namespace) {
+                            protocol.namespace = existing.namespace;
                         }
+                        protocolRulesData.rules.set(String(f.name), protocol);
                     }
                 }
             }
@@ -842,7 +858,7 @@ async function collectProtocolViolations(ctx, callGraph) {
                 // to bridge real API names to abstract protocol function names.
                 if (protocolRulesData) {
                     try {
-                        const ssgResult = (0, ssg_bridge_1.validateSequenceWithSSG)(semantic.steps, protocolRulesData.rules, protocolRulesData.namespaceInitialStates, seq.file, protocolRulesData.aliasIndex, protocolRulesData.wildcardAliases);
+                        const ssgResult = (0, ssg_bridge_1.validateSequenceWithSSG)(semantic.steps, protocolRulesData.rules, protocolRulesData.namespaceInitialStates, seq.file, protocolRulesData.aliasIndex, protocolRulesData.wildcardAliases, projectFunctions);
                         ssgResults.push(ssgResult);
                         ssgTotalCalls += ssgResult.stats.totalCalls;
                         ssgMatchedCalls += ssgResult.stats.matchedCalls;
@@ -904,40 +920,33 @@ async function collectProtocolViolations(ctx, callGraph) {
         } : undefined,
     };
 }
-function extractCallSequencesFromProject(projectPath, language) {
-    // P4.5: 优先 IR 精确序列（每个函数体内的真实调用，从各自入口验证）
-    const irSequences = extractCallSequencesFromIR(projectPath);
+function extractCallSequencesFromProject(projectPath, language, keepNames) {
+    // P4.5/P4.6: 优先 IR 精确序列（入口函数展开 + 非入口抑制，跨函数传播）
+    const irSequences = extractCallSequencesFromIR(projectPath, keepNames);
     if (irSequences.length > 0)
         return irSequences;
     // 回退：正则扫描（C 等无 IR 语言保持原行为）
     return extractCallSequencesRegex(projectPath, language);
 }
 /**
- * P4.5: 从 ir.json 构建 per-function 调用序列。
- * 每个函数体内的 calls[] 是一条独立序列（从协议初始状态起步验证）——
- * 函数声明名单不再是验证对象；语义 marker（__progmune_*）供规则消费，不作真实调用。
+ * P4.5/P4.6: 从 ir.json 构建验证序列——入口函数展开 + 非入口抑制
+ * （共享实现见 src/call-sequence.ts buildCallSequences）：
+ * 函数声明名单不再是验证对象；语义 marker（__progmune_*）供规则消费，
+ * 不作真实调用；被项目函数调用的函数片段并入调用方展开序列。
  */
-function extractCallSequencesFromIR(projectPath) {
+function extractCallSequencesFromIR(projectPath, keepNames) {
     try {
         const fs = require("fs");
         const irPath = path.join(projectPath, "ir.json");
         if (!fs.existsSync(irPath))
             return [];
         const ir = JSON.parse(fs.readFileSync(irPath, "utf-8"));
-        if (!Array.isArray(ir))
+        // ir.json 两种形态兼容：裸数组（extractIR / extractIRPython）与
+        // { typeMap, functions } 合并对象（extractProjectIR，execute/MCP 写盘）。
+        const functions = Array.isArray(ir) ? ir : (ir.functions || []);
+        if (!Array.isArray(functions) || functions.length === 0)
             return [];
-        const sequences = [];
-        for (const f of ir) {
-            const calls = (f.calls || []).filter((c) => typeof c === "string" && !c.startsWith("__progmune_"));
-            if (calls.length === 0)
-                continue;
-            sequences.push({
-                calls,
-                file: String(f.file || ""),
-                function: String(f.name || "unknown"),
-            });
-        }
-        return sequences;
+        return (0, call_sequence_1.buildCallSequences)(functions, keepNames);
     }
     catch {
         return [];

package/dist/trust/ssg-bridge.js

@@ -227,7 +227,7 @@ function normalizeName(name) {
  *   2. Substring match (call contains rule name or vice versa)
  *   3. Domain-guided keyword match
  */
-function inferRuleName(apiName, domain, description, ruleNames, namespace, aliases, wildcardAliases) {
+function inferRuleName(apiName, domain, description, ruleNames, namespace, aliases, wildcardAliases, projectFunctions) {
     const normalized = normalizeName(apiName);
     const lowerApi = apiName.toLowerCase();
     const lowerDesc = description.toLowerCase();
@@ -262,7 +262,20 @@ function inferRuleName(apiName, domain, description, ruleNames, namespace, alias
     // word segment in the normalized call name. This prevents "status" from
     // matching "poll_status" via raw substring, since "status" must appear
     // as a complete _-delimited segment.
+    //
+    // 门控（P4.6.1）：词段匹配只对「项目函数」适用——它是为改名协议原语设计的
+    // （协议原语必然是项目内函数，如 S5 的 create_active_session）。外部库调用
+    // （如 Node 的 readFileSync）经词段撞上 read_file 是纯噪声：外部 API 的语义
+    // 桥接走 alias 配置（Strategy 0b）或 domain 关键词（Strategy 3），不走词段。
+    // 未提供 projectFunctions 时保持旧行为（向后兼容测试与无 IR 的调用方）。
+    const isProjectFn = !projectFunctions
+        || projectFunctions.has(apiName)
+        || projectFunctions.has(lowerApi)
+        || projectFunctions.has(normalized)
+        || (dotIdx >= 0 && projectFunctions.has(lowerApi.slice(dotIdx + 1)));
     for (const ruleName of ruleNames) {
+        if (projectFunctions && !isProjectFn)
+            continue;
         const ruleWords = ruleName.split("_");
         const callWords = normalized.split("_");
         // Rule must have at least 2 words for this strategy (single-word rules
@@ -303,7 +316,9 @@ function inferRuleName(apiName, domain, description, ruleNames, namespace, alias
  * @param file — source file path (for violation reporting)
  * @returns SSG validation result with violations and trace
  */
-function validateSequenceWithSSG(steps, rules, namespaceInitialStates, file, aliasIndex, wildcardAliases) {
+function validateSequenceWithSSG(steps, rules, namespaceInitialStates, file, aliasIndex, wildcardAliases, 
+/** 项目函数名集合（含裸名/全名/小写变体由调用方构造）——提供后词段匹配只对项目函数适用 */
+projectFunctions) {
     const allRuleNames = Array.from(rules.keys());
     const aliases = aliasIndex || new Map();
     const wildcards = wildcardAliases || new Map();
@@ -361,7 +376,7 @@ function validateSequenceWithSSG(steps, rules, namespaceInitialStates, file, ali
         // Even if the semantic domain maps to "stateless", an alias may still
         // map this call to a specific protocol rule with its own namespace.
         // Priority: wildcard alias → exact alias → name match → word match → keyword
-        const ruleName = inferRuleName(step.api, step.domain, step.description, allRuleNames, namespace, aliases, wildcards);
+        const ruleName = inferRuleName(step.api, step.domain, step.description, allRuleNames, namespace, aliases, wildcards, projectFunctions);
         // Use matched rule's namespace, falling back to domain-inferred namespace
         const effectiveNamespace = ruleName
             ? (rules.get(ruleName)?.namespace || namespace)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "progmune-runtime",
-  "version": "3.6.1",
+  "version": "3.7.1",
   "description": "Progmune — AI Trust Decision Engine. Verify AI-generated code before it reaches production. Outputs APPROVED / NEEDS_REVIEW / BLOCKED with evidence.",
   "files": [
     "dist/",