@furongjun1999/dsh-memory 0.9.22 → 0.10.1

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 (179) hide show
  1. package/CHANGELOG.en.md +450 -0
  2. package/CHANGELOG.md +112 -0
  3. package/README.en.md +244 -0
  4. package/README.md +272 -260
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/README.md +2 -0
  7. package/docs/discipline/templates/full.md.tmpl +1 -1
  8. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  9. package/docs/en/README.md +190 -0
  10. package/docs/en/TRANSLATION.md +78 -0
  11. package/docs/en/TRANSLATION_MANIFEST.json +170 -0
  12. package/docs/en/TRANSLATION_REPORT.md +11 -0
  13. package/docs/en/dev/README.md +10 -0
  14. package/docs/en/dev/coding-testing.md +72 -0
  15. package/docs/en/dev/switch-matrix.md +10 -0
  16. package/docs/en/glossary.md +97 -0
  17. package/docs/en/harnesses/claude.md +100 -0
  18. package/docs/en/harnesses/codebuddy.md +93 -0
  19. package/docs/en/harnesses/codex.md +88 -0
  20. package/docs/en/harnesses/dsh.md +84 -0
  21. package/docs/en/harnesses/zcode.md +42 -0
  22. package/docs/en/mdcg/ccg.md +32 -0
  23. package/docs/en/mdcg/generated-docs.md +20 -0
  24. package/docs/en/mdcg/guardrail-charter.md +170 -0
  25. package/docs/en/mdcg/mcp-tool-names.md +43 -0
  26. package/docs/en/mdcg/multi-harness.md +43 -0
  27. package/docs/en/mdcg/recall-metadata.md +30 -0
  28. package/docs/en/mdcg/world-model-endpoint.md +379 -0
  29. package/docs/en/mdcg/write-aliases.md +130 -0
  30. package/docs/en/ops/README.md +11 -0
  31. package/docs/en/ops/environment-known-issues.md +244 -0
  32. package/docs/en/ops/install.md +72 -0
  33. package/docs/en/ops/operations-troubleshooting.md +86 -0
  34. package/docs/en/ops/permissions-review.md +79 -0
  35. package/docs/en/ops/release-governance.md +49 -0
  36. package/docs/en/ops/tool-name-migration.md +30 -0
  37. package/docs/en/ops/ui-install-troubleshooting.md +53 -0
  38. package/docs/en/standards/ai-coding-standard-checklist.md +71 -0
  39. package/docs/en/standards/ai-coding-standard-lingshu.md +47 -0
  40. package/docs/en/standards/ai-coding-standard.md +185 -0
  41. package/docs/en/ui/minimal.md +62 -0
  42. package/docs/mdcg/cogmap_ops.md +16 -15
  43. package/lib/client.js +29 -3
  44. package/lib/hooks.d.ts +34 -0
  45. package/lib/hooks.js +167 -33
  46. package/lib/index.js +19 -3
  47. package/lib/lib/console_web.mjs +30 -3
  48. package/lib/lib/hook_audit.d.ts +3 -2
  49. package/lib/lib/hook_audit.js +14 -4
  50. package/lib/lib/mdcg_client.d.ts +5 -2
  51. package/lib/lib/mdcg_client.js +8 -4
  52. package/lib/lib/prompt_safety.d.ts +24 -0
  53. package/lib/lib/prompt_safety.js +77 -1
  54. package/lib/lib/token_store.js +5 -2
  55. package/lib/tools.js +5 -3
  56. package/md_cg/bucketindex.py +231 -0
  57. package/md_cg/bucketscope.py +339 -0
  58. package/md_cg/config_registry_bulk.py +19 -10
  59. package/md_cg/config_validate.py +14 -2
  60. package/md_cg/detrerank.py +137 -0
  61. package/md_cg/fsutil.py +215 -25
  62. package/md_cg/govern/__init__.py +23 -0
  63. package/md_cg/iface/__init__.py +46 -0
  64. package/md_cg/iface/_verify.py +609 -0
  65. package/md_cg/iface/contracts.py +337 -0
  66. package/md_cg/judgment_manifest.py +14 -0
  67. package/md_cg/kernel/__init__.py +27 -0
  68. package/md_cg/mcp_server.py +457 -23
  69. package/md_cg/mdcg.py +1034 -79
  70. package/md_cg/mdcos.py +263 -21
  71. package/md_cg/metacognition.py +66 -13
  72. package/md_cg/mutate_extract_shipped.py +126 -0
  73. package/md_cg/mutate_ledger_e2e.py +100 -0
  74. package/md_cg/nodefile.py +147 -23
  75. package/md_cg/op_table.py +22 -4
  76. package/md_cg/probe_c_ledger_integrity.py +258 -0
  77. package/md_cg/probe_d_retirement_discipline.py +263 -0
  78. package/md_cg/reconcile.py +9 -11
  79. package/md_cg/review_cli.py +6 -1
  80. package/md_cg/rollback.py +16 -1
  81. package/md_cg/run_tests.py +30 -1
  82. package/md_cg/scopeselect.py +214 -0
  83. package/md_cg/scrub.py +160 -23
  84. package/md_cg/security.py +4 -2
  85. package/md_cg/state_extract.py +149 -0
  86. package/md_cg/state_slots.py +58 -10
  87. package/md_cg/structboost.py +179 -0
  88. package/md_cg/test_alternatives_historical.py +162 -0
  89. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  90. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  91. package/md_cg/test_bucket_cards.py +85 -0
  92. package/md_cg/test_bucket_day_order.py +74 -0
  93. package/md_cg/test_bucket_quota.py +79 -0
  94. package/md_cg/test_bucket_recency_guards.py +75 -0
  95. package/md_cg/test_bucket_three_causes.py +83 -0
  96. package/md_cg/test_bucketindex.py +130 -0
  97. package/md_cg/test_bucketscope_early.py +71 -0
  98. package/md_cg/test_cond_term_fold.py +183 -0
  99. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  100. package/md_cg/test_cond_term_neg_scope.py +147 -0
  101. package/md_cg/test_cond_terms_colon.py +348 -0
  102. package/md_cg/test_detrerank.py +157 -0
  103. package/md_cg/test_gate_four_kpi.py +136 -0
  104. package/md_cg/test_generation_guard.py +76 -43
  105. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  106. package/md_cg/test_issue362_neg_condition.py +44 -7
  107. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  108. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  109. package/md_cg/test_issue444_scrub_evidence_plaintext.py +14 -8
  110. package/md_cg/test_issue677_flush_batch_io.py +139 -0
  111. package/md_cg/test_issue677_info_fast.py +82 -0
  112. package/md_cg/test_issue677_remember_dedupe.py +106 -0
  113. package/md_cg/test_issue712_tokens_sessions_read.py +199 -0
  114. package/md_cg/test_issue722_strict_conditions.py +96 -0
  115. package/md_cg/test_issue730_narrowing_audit.py +121 -0
  116. package/md_cg/test_issue733_verify_override.py +193 -0
  117. package/md_cg/test_issue733_verify_override_and_overwrite_inherit.py +315 -0
  118. package/md_cg/test_issue740_filelock_fd_leak.py +218 -0
  119. package/md_cg/test_issue741_content_hash_same_source.py +158 -0
  120. package/md_cg/test_issue747_slot_contradiction.py +125 -0
  121. package/md_cg/test_issue754_nested_root_guard.py +197 -0
  122. package/md_cg/test_issue757_index_hash_compare.py +85 -0
  123. package/md_cg/test_issue758_disk_hash_single.py +67 -0
  124. package/md_cg/test_issue759_twophase_hash.py +67 -0
  125. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  126. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  127. package/md_cg/test_issue790_verb_negation.py +77 -0
  128. package/md_cg/test_issue810_root_guard.py +71 -0
  129. package/md_cg/test_issue812_info_index_stale.py +78 -0
  130. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  131. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  132. package/md_cg/test_kernel_iface_contracts.py +18 -0
  133. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  134. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +545 -542
  135. package/md_cg/test_n209_verify_write_face_gates.py +5 -2
  136. package/md_cg/test_neg_condition_hits.py +336 -333
  137. package/md_cg/test_probe_cd_shipped.py +385 -0
  138. package/md_cg/test_recent_tail.py +93 -0
  139. package/md_cg/test_run_tests_entry_gates.py +110 -0
  140. package/md_cg/test_scopeselect.py +70 -0
  141. package/md_cg/test_scopeselect_clock.py +70 -0
  142. package/md_cg/test_scrub_source_line_false_positive.py +64 -0
  143. package/md_cg/test_session_attribution_consistency.py +835 -813
  144. package/md_cg/test_state_extract_shipped.py +162 -0
  145. package/md_cg/test_state_ledger_chain.py +207 -0
  146. package/md_cg/test_state_ledger_e2e.py +145 -0
  147. package/md_cg/test_structboost.py +102 -0
  148. package/md_cg/test_timeboost.py +83 -0
  149. package/md_cg/test_timeboost_relativedate.py +71 -0
  150. package/md_cg/test_topicagg.py +129 -0
  151. package/md_cg/test_twophase.py +286 -286
  152. package/md_cg/timeboost.py +223 -0
  153. package/md_cg/tokens.py +55 -7
  154. package/md_cg/topicagg.py +142 -0
  155. package/md_cg/twophase.py +15 -6
  156. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  157. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  158. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  159. package/md_cg/writepipe.py +35 -3
  160. package/package.json +4 -1
  161. package/scripts/workspace_index.py +2 -0
  162. package/src/hooks.ts +182 -34
  163. package/src/index.ts +19 -3
  164. package/src/lib/console_web.mjs +30 -3
  165. package/src/lib/hook_audit.ts +15 -5
  166. package/src/lib/mdcg_client.ts +8 -4
  167. package/src/lib/prompt_safety.ts +73 -1
  168. package/src/lib/token_store.ts +5 -2
  169. package/src/tools.ts +5 -3
  170. package/ui/minimal/integrity.json +2 -2
  171. package/ui/minimal/payload/build-ui.mjs +41 -2
  172. package/ui/minimal/payload/lib/client.js +29 -3
  173. package/ui/minimal/payload/lib/lib/console_web.mjs +30 -3
  174. package/ui/minimal/payload/src/lib/console_web.mjs +30 -3
  175. package/ui/minimal/payload/web/app.js +3 -1
  176. package/ui/minimal/payload/web/client.js +30 -3
  177. package/web/app.js +3 -1
  178. package/web/client.js +30 -3
  179. package/zcode/AGENTS.md +1 -1
@@ -0,0 +1,473 @@
1
+ # -*- coding: utf-8 -*-
2
+ r"""#829 守卫:calibration() 分母里没有正例时**不得判方向**。
3
+
4
+ 缺陷(本件修复,2026-11-08)
5
+ --------------------------
6
+ `calibration()` 的判据是 `Σ正例 / Σ(正例+负例)`,而本仓没有任何生产路径
7
+ 写 `confirmed`(只有测试与外部裁决会发)。故活库 Σ正例 恒为 0 ⇒
8
+ `actual_accuracy` 数学上恒为 0.0、`gap` 恒等于 `expected_accuracy` ⇒
9
+ `verdict` **恒为 overconfident**。这不是「读数偏低」,是**该字段不携带信息**。
10
+
11
+ 活库实测(2026-11-09,修前):
12
+ n_nodes=77 / n_evidence=409 / expected=0.3234 / actual=0.0
13
+ gap=0.3234 / verdict=overconfident
14
+ 逐层人口:contextual 42 节点 0 正 218 负;knowledge 35 节点 0 正 191 负
15
+
16
+ 两层危害(本守卫各钉一条):
17
+ ① **读数面**:恒红比不报更有害——下游 `self_state` / `report` 把它当真读数消费;
18
+ ② **事实面**:`scrub.calibrate(apply=True)` 会据这个退化的 gap 把全库
19
+ confidence 一律下调(gap 恒正 ⇒ 偏置恒负)。一个不携带信息的读数
20
+ 直接改写事实层,比不调更有害。
21
+
22
+ 本守卫钉四条
23
+ -----------
24
+ A 组 **不判方向**:无正例 ⇒ verdict=insufficient_data /
25
+ calibration_defined=False / reason=no_positive_evidence,
26
+ 但 expected/actual/gap/ece **照旧如实算并透出**(不隐藏、不编造)
27
+ B 组 **正向对照**:有正例时方向照旧可判(不得把缺陷修成「永不判」)
28
+ C 组 **人口可观测**:n_by_layer 逐层 n_nodes/pos/neg,且三条不变量成立
29
+ D 组 **零写回**:scrub.calibrate 在 calibration_defined=False 时
30
+ 拒绝出偏置、apply=True 也不改任何节点的 confidence
31
+ E 组 **建议面**:_advise 不产出方向建议,改产出 no_positive_evidence
32
+
33
+ 运行:python -X utf8 -m md_cg.test_issue829_calibration_positive_gate
34
+ python -X utf8 -m md_cg.test_issue829_calibration_positive_gate --mutate
35
+ 退出码:0 全绿 / 1 有失败
36
+ """
37
+ from __future__ import annotations
38
+
39
+ import argparse
40
+ import shutil
41
+ import sys
42
+ import tempfile
43
+
44
+ from . import metacognition as mc
45
+ from . import scrub
46
+ from .mdcg import MdCG
47
+
48
+ PASS = FAIL = 0
49
+ FAILS = []
50
+ _SANDBOXES = []
51
+
52
+ BODY = "# 功能名:t\n# 生效条件:t\n\n正文"
53
+
54
+
55
+ def check(name, cond, detail=""):
56
+ global PASS, FAIL
57
+ if cond:
58
+ PASS += 1
59
+ print(" [PASS] %s%s" % (name, (" · " + str(detail)) if detail else ""))
60
+ else:
61
+ FAIL += 1
62
+ FAILS.append(name)
63
+ print(" [FAIL] %s · %s" % (name, detail))
64
+ return bool(cond)
65
+
66
+
67
+ # 生效条件:pos/neg 为要造的正例/负例条数(neg 用 weakened 造、pos 用 confirmed
68
+ # 造,走真实 API 而非改写 frontmatter),返回 (root, cg);调用方负责 close。
69
+ def _mk_lib(pos=0, neg=0, confidence=0.6):
70
+ root = tempfile.mkdtemp(prefix="i829_")
71
+ _SANDBOXES.append(root)
72
+ cg = MdCG(root)
73
+ i = 0
74
+ for _ in range(int(pos)):
75
+ nid = "pos%d" % i
76
+ i += 1
77
+ cg.add(nid, BODY, layer="knowledge", importance=0.5,
78
+ confidence=confidence)
79
+ cg.verify(nid, "外部裁决通过", "confirmed")
80
+ for _ in range(int(neg)):
81
+ nid = "neg%d" % i
82
+ i += 1
83
+ cg.add(nid, BODY, layer="knowledge", importance=0.5,
84
+ confidence=confidence)
85
+ cg.verify(nid, "外部裁决不成立", "weakened")
86
+ return root, cg
87
+
88
+
89
+ # 生效条件:入参为 calibration() 返回体,返回违规描述列表(空列表=合规)。
90
+ # **这是 A 组唯一判据函数**(变异打在此层之上)。
91
+ def no_pos_violations(rep):
92
+ bad = []
93
+ if rep.get("n_positive") != 0:
94
+ bad.append("前置破:本组库应当没有正例,实得 n_positive=%r"
95
+ % (rep.get("n_positive"),))
96
+ if rep.get("verdict") != "insufficient_data":
97
+ bad.append("无正例却判了方向:verdict=%r(修前恒 overconfident)"
98
+ % (rep.get("verdict"),))
99
+ if rep.get("calibration_defined") is not False:
100
+ bad.append("calibration_defined 应为 False:%r"
101
+ % (rep.get("calibration_defined"),))
102
+ if rep.get("reason") != "no_positive_evidence":
103
+ bad.append("reason 应为 no_positive_evidence:%r" % (rep.get("reason"),))
104
+ # 「不判方向」不等于「隐藏读数」:三个数值必须照旧如实透出。
105
+ for k in ("expected_accuracy", "actual_accuracy", "gap", "ece"):
106
+ if rep.get(k) is None:
107
+ bad.append("读数被隐藏了:%s 为 None(应如实透出)" % k)
108
+ exp, act, gap = (rep.get("expected_accuracy"), rep.get("actual_accuracy"),
109
+ rep.get("gap"))
110
+ if act is not None and abs(float(act)) > 1e-9:
111
+ bad.append("无正例时 actual 应恰为 0:%r" % (act,))
112
+ if None not in (exp, act, gap) and abs(float(gap) - (float(exp) - float(act))) > 1e-6:
113
+ bad.append("gap 仍须自洽 expected-actual:%r vs %r-%r"
114
+ % (gap, exp, act))
115
+ return bad
116
+
117
+
118
+ # 生效条件:入参为「有正例」库的 calibration() 返回体,返回违规描述列表。
119
+ def has_pos_violations(rep):
120
+ bad = []
121
+ if int(rep.get("n_positive") or 0) <= 0:
122
+ bad.append("前置破:本组库应当有正例,实得 n_positive=%r"
123
+ % (rep.get("n_positive"),))
124
+ if rep.get("calibration_defined") is not True:
125
+ bad.append("有正例却判 calibration_defined=%r(修过头:永不判)"
126
+ % (rep.get("calibration_defined"),))
127
+ if rep.get("verdict") == "insufficient_data":
128
+ bad.append("有正例且样本够却仍 insufficient_data(修过头)")
129
+ exp, act, gap = (rep.get("expected_accuracy"), rep.get("actual_accuracy"),
130
+ rep.get("gap"))
131
+ if None not in (exp, act, gap) and abs(float(gap) - (float(exp) - float(act))) > 1e-6:
132
+ bad.append("gap 与 expected-actual 不自洽")
133
+ return bad
134
+
135
+
136
+ # 生效条件:入参为 calibration() 返回体,返回 n_by_layer 不变量违规描述列表。
137
+ def layer_violations(rep):
138
+ bad = []
139
+ nbl = rep.get("n_by_layer")
140
+ if not isinstance(nbl, dict):
141
+ bad.append("缺 n_by_layer(人口构成不可观测):%r" % (nbl,))
142
+ return bad
143
+ s_nodes = sum(int(v.get("n_nodes") or 0) for v in nbl.values())
144
+ s_pos = sum(int(v.get("pos") or 0) for v in nbl.values())
145
+ s_neg = sum(int(v.get("neg") or 0) for v in nbl.values())
146
+ if s_nodes != rep.get("n_nodes"):
147
+ bad.append("Σlayer.n_nodes(%d) != n_nodes(%r)" % (s_nodes, rep.get("n_nodes")))
148
+ if s_pos != rep.get("n_positive"):
149
+ bad.append("Σlayer.pos(%d) != n_positive(%r)" % (s_pos, rep.get("n_positive")))
150
+ if s_neg != rep.get("n_negative"):
151
+ bad.append("Σlayer.neg(%d) != n_negative(%r)" % (s_neg, rep.get("n_negative")))
152
+ for k, v in nbl.items():
153
+ for kk in ("n_nodes", "pos", "neg"):
154
+ if kk not in v:
155
+ bad.append("layer %r 缺 %s" % (k, kk))
156
+ return bad
157
+
158
+
159
+ # 生效条件:rep 为 scrub.calibrate 返回体、before/after 为前后 confidence 映射;
160
+ # 返回违规描述列表(无正例时应当零偏置、零写回)。
161
+ def scrub_violations(rep, before, after):
162
+ bad = []
163
+ if rep.get("ok") is not False:
164
+ bad.append("无正例时 calibrate 仍返回 ok=True(会出偏置)")
165
+ if rep.get("reason") != "no_positive_evidence":
166
+ bad.append("reason 应为 no_positive_evidence:%r" % (rep.get("reason"),))
167
+ if abs(float(rep.get("suggested_offset") or 0.0)) > 1e-9:
168
+ bad.append("仍给出非零偏置:%r" % (rep.get("suggested_offset"),))
169
+ if rep.get("applied"):
170
+ bad.append("applied 应为 False")
171
+ if int(rep.get("n_adjusted") or 0) != 0:
172
+ bad.append("n_adjusted 应为 0:%r" % (rep.get("n_adjusted"),))
173
+ changed = [k for k in before if before[k] != after.get(k)]
174
+ if changed:
175
+ bad.append("零写回破:这些节点 confidence 被改了 %s" % (changed[:5],))
176
+ return bad
177
+
178
+
179
+ # 生效条件:adv 为 _advise 返回的建议列表;无正例库上不得出现方向建议。
180
+ def advise_violations(adv):
181
+ codes = [a.get("code") for a in adv or []]
182
+ bad = []
183
+ if "overconfident" in codes:
184
+ bad.append("无正例仍产出 overconfident 建议")
185
+ if "underconfident" in codes:
186
+ bad.append("无正例仍产出 underconfident 建议")
187
+ if "no_positive_evidence" not in codes:
188
+ bad.append("未产出 no_positive_evidence 提示:%s" % (codes,))
189
+ if not all("why" in a and "action" in a for a in adv or []):
190
+ bad.append("建议缺 why/action(不可复核)")
191
+ return bad
192
+
193
+
194
+ def _conf_of(cg, ids):
195
+ out = {}
196
+ for nid in ids:
197
+ node = cg.get(nid) or {}
198
+ out[nid] = (node.get("frontmatter") or {}).get("confidence")
199
+ return out
200
+
201
+
202
+ # --------------------------------------------------------------------------
203
+ # A 组:不判方向(核心)
204
+ # --------------------------------------------------------------------------
205
+
206
+ def g_a_no_positive():
207
+ """A1/A2/A3 无正例 ⇒ 不判方向,但读数如实透出。"""
208
+ root, cg = _mk_lib(pos=0, neg=8)
209
+ try:
210
+ rep = mc.calibration(cg)
211
+ bad = no_pos_violations(rep)
212
+ check("A1 无正例 ⇒ 不判方向(verdict/calibration_defined/reason 三键齐)",
213
+ not bad, bad)
214
+ check("A2 读数未被隐藏(expected/actual/gap/ece 四值照旧透出)",
215
+ all(rep.get(k) is not None
216
+ for k in ("expected_accuracy", "actual_accuracy", "gap", "ece")),
217
+ {k: rep.get(k) for k in ("expected_accuracy", "actual_accuracy",
218
+ "gap", "ece")})
219
+ check("A3 无正例不影响 n_nodes/n_evidence 口径",
220
+ rep.get("n_nodes") == 8 and rep.get("n_evidence") == 8,
221
+ (rep.get("n_nodes"), rep.get("n_evidence")))
222
+ finally:
223
+ cg.close()
224
+
225
+
226
+ def g_a_mixed_no_positive():
227
+ """A4 负例跨两层仍无正例 ⇒ 同样不判(人口不是原因,缺正例才是)。"""
228
+ root = tempfile.mkdtemp(prefix="i829_mix_")
229
+ _SANDBOXES.append(root)
230
+ cg = MdCG(root)
231
+ try:
232
+ for i in range(3):
233
+ cg.add("k%d" % i, BODY, layer="knowledge", importance=0.5)
234
+ cg.verify("k%d" % i, "不成立", "weakened")
235
+ for i in range(3):
236
+ cg.add("c%d" % i, BODY, layer="contextual", importance=0.5)
237
+ cg.verify("c%d" % i, "不成立", "weakened")
238
+ rep = mc.calibration(cg)
239
+ bad = no_pos_violations(rep)
240
+ check("A4 跨层全负例 ⇒ 仍不判方向", not bad, bad)
241
+ finally:
242
+ cg.close()
243
+
244
+
245
+ # --------------------------------------------------------------------------
246
+ # B 组:正向对照(不得修成「永不判」)
247
+ # --------------------------------------------------------------------------
248
+
249
+ def g_b_has_positive():
250
+ """B1 全正例高置信 ⇒ 方向可判;B2 gap 仍自洽。"""
251
+ root, cg = _mk_lib(pos=6, neg=0, confidence=0.9)
252
+ try:
253
+ rep = mc.calibration(cg)
254
+ bad = has_pos_violations(rep)
255
+ check("B1 有正例 ⇒ 方向照旧可判(不得修成永不判)", not bad, bad)
256
+ check("B1b 全正例 ⇒ actual=1.0",
257
+ abs(float(rep.get("actual_accuracy")) - 1.0) < 1e-9,
258
+ rep.get("actual_accuracy"))
259
+ finally:
260
+ cg.close()
261
+
262
+
263
+ def g_b_mixed():
264
+ """B3 正负混合 ⇒ 方向按 gap 判(与修前口径一字不改)。"""
265
+ root, cg = _mk_lib(pos=3, neg=9, confidence=0.6)
266
+ try:
267
+ rep = mc.calibration(cg)
268
+ bad = has_pos_violations(rep)
269
+ check("B3 正负混合 ⇒ 方向可判且 gap 自洽", not bad, bad)
270
+ # actual = 3/(3+9) = 0.25
271
+ check("B3b actual == 正例/(正例+负例)",
272
+ abs(float(rep.get("actual_accuracy")) - 3.0 / 12.0) < 1e-6,
273
+ rep.get("actual_accuracy"))
274
+ finally:
275
+ cg.close()
276
+
277
+
278
+ # --------------------------------------------------------------------------
279
+ # C 组:人口可观测
280
+ # --------------------------------------------------------------------------
281
+
282
+ def g_c_n_by_layer():
283
+ """C1 逐层人口 + 三条不变量。"""
284
+ root, cg = _mk_lib(pos=0, neg=8)
285
+ try:
286
+ rep = mc.calibration(cg)
287
+ bad = layer_violations(rep)
288
+ check("C1 n_by_layer 产出且三条不变量成立", not bad, bad)
289
+ check("C1b 逐层 pos 全 0(活库口径复刻)",
290
+ all(int(v.get("pos") or 0) == 0
291
+ for v in (rep.get("n_by_layer") or {}).values()),
292
+ rep.get("n_by_layer"))
293
+ finally:
294
+ cg.close()
295
+
296
+
297
+ def g_c_insufficient_shape():
298
+ """C2 无样本分支形状稳定(也带 n_by_layer / calibration_defined)。"""
299
+ root = tempfile.mkdtemp(prefix="i829_empty_")
300
+ _SANDBOXES.append(root)
301
+ cg = MdCG(root)
302
+ try:
303
+ rep = mc.calibration(cg)
304
+ check("C2 无样本 ⇒ ok False / insufficient_data",
305
+ rep.get("ok") is False and rep.get("reason") == "insufficient_data",
306
+ rep)
307
+ check("C2b 该分支同样带 n_by_layer / calibration_defined 两键",
308
+ "n_by_layer" in rep and rep.get("calibration_defined") is False,
309
+ sorted(rep))
310
+ finally:
311
+ cg.close()
312
+
313
+
314
+ # --------------------------------------------------------------------------
315
+ # D 组:零写回(事实面)
316
+ # --------------------------------------------------------------------------
317
+
318
+ def g_d_scrub_no_writeback():
319
+ """D1 apply=True 在无正例库上零写回;D2 有正例时偏置照旧可出。"""
320
+ root, cg = _mk_lib(pos=0, neg=8)
321
+ try:
322
+ ids = ["neg%d" % i for i in range(1, 9)]
323
+ before = _conf_of(cg, ids)
324
+ rep = scrub.calibrate(cg, apply=True)
325
+ after = _conf_of(cg, ids)
326
+ bad = scrub_violations(rep, before, after)
327
+ check("D1 无正例 ⇒ 拒绝出偏置且 apply=True 零写回", not bad, bad)
328
+ finally:
329
+ cg.close()
330
+ # 正向对照:有正例时,偏置路径必须仍然工作(不得一律拒绝)
331
+ root2, cg2 = _mk_lib(pos=2, neg=6, confidence=0.9)
332
+ try:
333
+ rep2 = scrub.calibrate(cg2)
334
+ check("D2 有正例 ⇒ 偏置路径照旧工作(ok=True 且有 suggested_offset)",
335
+ rep2.get("ok") is True and "suggested_offset" in rep2,
336
+ {k: rep2.get(k) for k in ("ok", "verdict", "suggested_offset")})
337
+ finally:
338
+ cg2.close()
339
+
340
+
341
+ # --------------------------------------------------------------------------
342
+ # E 组:建议面
343
+ # --------------------------------------------------------------------------
344
+
345
+ def g_e_advise():
346
+ """E1 无正例 ⇒ 不产出方向建议,改产出 no_positive_evidence。"""
347
+ root, cg = _mk_lib(pos=0, neg=8)
348
+ try:
349
+ cal = mc.calibration(cg)
350
+ adv = mc._advise({"ok": True, "d2": 0.0, "emotion": "stable",
351
+ "state_rates": {}}, cal, {"unresolved_count": 0}, {})
352
+ bad = advise_violations(adv)
353
+ check("E1 无正例 ⇒ 建议面不产出方向建议", not bad, bad)
354
+ # 正向对照:calibration_defined=True 的夹具必须照旧产出方向建议
355
+ adv2 = mc._advise(
356
+ {"ok": True, "d2": 0.0, "emotion": "stable", "state_rates": {}},
357
+ {"verdict": "overconfident", "expected_accuracy": 0.8,
358
+ "actual_accuracy": 0.5, "gap": 0.3, "calibration_defined": True},
359
+ {"unresolved_count": 0}, {})
360
+ check("E2 可判时方向建议照旧产出(正向对照)",
361
+ any(a["code"] == "overconfident" for a in adv2), str(adv2))
362
+ finally:
363
+ cg.close()
364
+
365
+
366
+ _CASES = (g_a_no_positive, g_a_mixed_no_positive, g_b_has_positive, g_b_mixed,
367
+ g_c_n_by_layer, g_c_insufficient_shape, g_d_scrub_no_writeback,
368
+ g_e_advise)
369
+
370
+
371
+ def _run_all():
372
+ global PASS, FAIL
373
+ PASS = FAIL = 0
374
+ del FAILS[:]
375
+ for fn in _CASES:
376
+ try:
377
+ fn()
378
+ except Exception as exc: # noqa: BLE001
379
+ check(False, "%s 组抛异常:%s: %s"
380
+ % (fn.__name__, type(exc).__name__, exc))
381
+ return list(FAILS)
382
+
383
+
384
+ # 生效条件:无入参;对同一份真实返回体做 5 个「破坏契约」的替身改写,
385
+ # 断言判据函数逐条转红;返回失败条数。
386
+ def _run_mutations():
387
+ print(chr(10) + "=== 定点变异自证(变异前 → 变异后) ===")
388
+ root, cg = _mk_lib(pos=0, neg=8)
389
+ bad_total = 0
390
+ try:
391
+ rep0 = mc.calibration(cg)
392
+ base = no_pos_violations(rep0)
393
+ print(" [基线] 变异前违规项 = %s(应为空)" % (base or "无"))
394
+ ids = ["neg%d" % i for i in range(1, 9)]
395
+ before = _conf_of(cg, ids)
396
+ scrub0 = scrub.calibrate(cg, apply=False)
397
+ adv0 = mc._advise({"ok": True, "d2": 0.0, "emotion": "stable",
398
+ "state_rates": {}}, rep0, {"unresolved_count": 0}, {})
399
+
400
+ def _shim_verdict(rep):
401
+ r = dict(rep)
402
+ r["verdict"] = "overconfident" # 退回修前:恒判过度自信
403
+ return r
404
+
405
+ def _shim_drop_reason(rep):
406
+ r = dict(rep)
407
+ r.pop("reason", None)
408
+ return r
409
+
410
+ def _shim_layer_count(rep):
411
+ r = dict(rep)
412
+ nbl = {k: dict(v) for k, v in (rep.get("n_by_layer") or {}).items()}
413
+ for v in nbl.values():
414
+ v["pos"] = int(v.get("pos") or 0) + 1 # 人口造假
415
+ break
416
+ r["n_by_layer"] = nbl
417
+ return r
418
+
419
+ def _shim_scrub(rep):
420
+ r = dict(rep)
421
+ r.update({"ok": True, "reason": None, "suggested_offset": -0.3234,
422
+ "applied": True, "n_adjusted": 8})
423
+ return r
424
+
425
+ def _shim_advise(adv):
426
+ return list(adv) + [{"code": "overconfident",
427
+ "why": "期望 > 实际", "action": "抽查复核"}]
428
+
429
+ cases = (
430
+ ("M1 verdict 退回恒 overconfident(修前病象)",
431
+ lambda: no_pos_violations(_shim_verdict(rep0))),
432
+ ("M2 reason 被吞(不可观测)",
433
+ lambda: no_pos_violations(_shim_drop_reason(rep0))),
434
+ ("M3 n_by_layer 计数造假(人口不可信)",
435
+ lambda: layer_violations(_shim_layer_count(rep0))),
436
+ ("M4 scrub 照旧出偏置并写回(事实面破)",
437
+ lambda: scrub_violations(_shim_scrub(scrub0), before, before)),
438
+ ("M5 建议面仍产出方向建议",
439
+ lambda: advise_violations(_shim_advise(adv0))),
440
+ )
441
+ for label, run in cases:
442
+ got = run()
443
+ hit = bool(got)
444
+ if not check(label, hit, "变异后违规项为空 ⇒ 判据无判别力"):
445
+ bad_total += 1
446
+ print(" 变异前:违规项=[] | 变异后:违规项=%d 项 %s ⇒ %s"
447
+ % (len(got), got[:2], "命中" if hit else "未命中"))
448
+ print(" 变异自证结论:%s" % ("全部按预期转红" if bad_total == 0
449
+ else "存在 %d 条未按预期" % bad_total))
450
+ return bad_total
451
+ finally:
452
+ cg.close()
453
+
454
+
455
+ def main() -> int:
456
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
457
+ ap = argparse.ArgumentParser(description="#829 calibration 正例入口守卫")
458
+ ap.add_argument("--mutate", action="store_true", help="定点变异自证")
459
+ a = ap.parse_args()
460
+ print("[1] 判据面")
461
+ reds = _run_all()
462
+ rc = 1 if reds else 0
463
+ if a.mutate:
464
+ rc = 1 if (_run_mutations() or reds) else 0
465
+ print(chr(10) + "SUMMARY: #829 calibration 正例入口守卫:%d 通过,%d 失败%s"
466
+ % (PASS, FAIL, (";失败项=" + "; ".join(FAILS)) if FAILS else ""))
467
+ for d in _SANDBOXES:
468
+ shutil.rmtree(d, ignore_errors=True)
469
+ return rc
470
+
471
+
472
+ if __name__ == "__main__":
473
+ sys.exit(main())
@@ -0,0 +1,18 @@
1
+ # -*- coding: utf-8 -*-
2
+ """W1 守卫入口(`scripts/run_tests.py` 以 `test_*.py` 发现,故此处为薄壳)。
3
+
4
+ 实际断言在 `md_cg/iface/_verify.py`——文件名以下划线开头,不被运行器当作
5
+ 独立测试收集,但由本薄壳调用,因此仍进入全量套件。
6
+
7
+ 生效条件:直接运行 `python -X utf8 -m md_cg.test_kernel_iface_contracts`
8
+ 即执行全部 11 条断言;任一条失败退出码 1。
9
+ """
10
+
11
+ from __future__ import annotations
12
+
13
+ import sys
14
+
15
+ from md_cg.iface._verify import main
16
+
17
+ if __name__ == "__main__":
18
+ sys.exit(main())