@furongjun1999/dsh-memory 0.9.6 → 0.9.8

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 (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,341 +1,341 @@
1
- # -*- coding: utf-8 -*-
2
- """读面 node_id「两种显式」处置不对称的守卫(issue #274)。
3
-
4
- 【本守卫守什么】
5
- #274 报:cg(op=read) 的 node_id=None **静默降级为检索**(返回检索结果包),
6
- 而 node_id=123 正确报 node_id_not_str —— 同一个「类型错」两种相反待遇。
7
-
8
- 复核结论:**读数全部成立,但处置不对称是刻意的,不是疏漏。**
9
- · 显式 "" 是**显式** —— 旧写法会把它当没传而静默转检索,故它必须落进类型闸,
10
- 走「节点不存在」的 null。
11
- · 显式 None 是**未传** —— MCP 客户端把「没有 id」序列化成 null 是常规形态,
12
- 故它落到检索分支;由 test_read_face_input_gates 的 M2-B8 / M2-B9 钉住
13
- (M2-B9 断言名即「node_id=None 仍是「未传」,走检索(不回归)」)。
14
-
15
- ⇒ 本件的**实际缺陷是文档缺口**:源码只写了 "" 的动机、没写 None 的动机,
16
- 于是外部复审把它读成了疏漏。修法是**补文档**(+ 本守卫钉住该不对称),
17
- **不是**改行为——改行为会打红 M2-B9,属 issue #274 的 R1(行为变更)。
18
-
19
- 判据:
20
- N1 node_id=None ⇒ 走检索(**刻意**;与「不传」同处置)。
21
- N2 node_id=123 ⇒ node_id_not_str(类型错,对照)。
22
- N3 node_id="" ⇒ null(显式空串**是**显式,不转检索)。
23
- N4 不传 node_id ⇒ 走检索。
24
- N5 node_id=None 与「不传」**逐字节相同** —— 把报告读到的这一事实**钉成契约**,
25
- 以免将来有人"顺手修"成报错而不自知(要改须连带改 M2-B9 与协议表)。
26
- N6 错误里 got_type 如实(不吞类型)。
27
- N7 **跨面**:audit 面对 node_id=None 报 node_id_not_str —— 两面口径不同,
28
- 本守卫**如实记录**该差异(不是要求一致;audit 无检索分支可落)。
29
- N8 **真 MCP stdio**:JSON null ⇒ 检索包;123 ⇒ 类型错(真通路同形)。
30
- N9 **反陈化(本件修复的实质)**:源码注释必须写明 None 的动机。
31
- 只写 "" 的动机 ⇒ 红——因为那正是本件被误读成疏漏的根因。
32
- N10 交叉引用:钉住该行为的 M2-B8 / M2-B9 两条断言仍存在(若被删,本守卫须知道)。
33
-
34
- 运行:python -X utf8 -m md_cg.test_issue274_read_node_id_none
35
- python -X utf8 -m md_cg.test_issue274_read_node_id_none --mutate
36
-
37
- 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
38
-
39
- 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
40
- """
41
- from __future__ import annotations
42
-
43
- import io
44
- import json
45
- import os
46
- import subprocess
47
- import sys
48
- import tempfile
49
-
50
- from .mdcos import MdCGOS
51
- from . import mcp_server as MS
52
-
53
- _HERE = os.path.dirname(os.path.abspath(__file__))
54
- _REPO = os.path.dirname(_HERE)
55
-
56
- _PASS: list = []
57
- _FAIL: list = []
58
-
59
-
60
- def ok(cond, msg, extra=""):
61
- (_PASS if cond else _FAIL).append(msg)
62
- print((" PASS " if cond else " FAIL ") + msg
63
- + ((" -> " + str(extra)) if (extra and not cond) else ""))
64
-
65
-
66
- def _cg(tag):
67
- root = tempfile.mkdtemp(prefix="n274_%s_" % tag)
68
- cg = MdCGOS(root)
69
- cg.add(content="# alpha 知识\n\nalpha 内容。", layer="knowledge", node_id="n1",
70
- importance=0.5, consistency=False, on_conflict="defer")
71
- return cg
72
-
73
-
74
- def _call(cg, a):
75
- try:
76
- return MS._cg_call(cg, a)
77
- except Exception as exc: # noqa: BLE001
78
- return {"__exc__": type(exc).__name__, "msg": str(exc)[:90]}
79
-
80
-
81
- def _is_search_pack(o) -> bool:
82
- return isinstance(o, dict) and ("results" in o or "meta" in o or "pack" in o)
83
-
84
-
85
- def _is_type_error(o) -> bool:
86
- return isinstance(o, dict) and o.get("error") == "node_id_not_str"
87
-
88
-
89
- def n1():
90
- print("== N1 node_id=None 走检索(刻意行为)==")
91
- cg = _cg("n1")
92
- o = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
93
- ok(_is_search_pack(o), "N1 node_id=None + query ⇒ 检索结果包(刻意)",
94
- json.dumps(o, ensure_ascii=False)[:150])
95
- o2 = _call(cg, {"op": "read", "node_id": None})
96
- ok("__exc__" not in (o2 or {}), "N1b node_id=None 无 query 不抛异常",
97
- json.dumps(o2, ensure_ascii=False)[:150])
98
-
99
-
100
- def n2():
101
- print("== N2 node_id=123 报类型错(对照)==")
102
- cg = _cg("n2")
103
- o = _call(cg, {"op": "read", "node_id": 123, "query": "alpha"})
104
- ok(_is_type_error(o), "N2 node_id=123 ⇒ node_id_not_str",
105
- json.dumps(o, ensure_ascii=False)[:150])
106
-
107
-
108
- def n3():
109
- print("== N3 node_id='' 是显式 ⇒ null(不转检索)==")
110
- cg = _cg("n3")
111
- o = _call(cg, {"op": "read", "node_id": "", "query": "alpha"})
112
- ok(not _is_search_pack(o), "N3a node_id='' 不返回检索包", repr(o)[:150])
113
- ok(o is None, "N3b node_id='' ⇒ null(协议登记的 node_missing 形态)", repr(o)[:120])
114
-
115
-
116
- def n4():
117
- print("== N4 不传 node_id 走检索 ==")
118
- cg = _cg("n4")
119
- o = _call(cg, {"op": "read", "query": "alpha"})
120
- ok(_is_search_pack(o), "N4a 不传 node_id + query ⇒ 检索结果包")
121
- ok(not _is_type_error(o), "N4b 不传 node_id 不报类型错")
122
-
123
-
124
- def n5():
125
- print("== N5 node_id=None 与「不传」逐字节相同(钉成契约)==")
126
- cg = _cg("n5")
127
- a1 = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
128
- a2 = _call(cg, {"op": "read", "query": "alpha"})
129
- ok(json.dumps(a1, ensure_ascii=False, sort_keys=True)
130
- == json.dumps(a2, ensure_ascii=False, sort_keys=True),
131
- "N5 node_id=None 与不传 node_id 逐字节相同(报告读数,已钉为契约)",
132
- (json.dumps(a1, ensure_ascii=False)[:100],
133
- json.dumps(a2, ensure_ascii=False)[:100]))
134
-
135
-
136
- def n6():
137
- print("== N6 错误里 got_type 如实 ==")
138
- cg = _cg("n6")
139
- for v, want in ((123, "int"), (1.5, "float"), (True, "bool"),
140
- (["x"], "list"), ({"a": 1}, "dict")):
141
- o = _call(cg, {"op": "read", "node_id": v})
142
- ok(_is_type_error(o) and o.get("got_type") == want,
143
- "N6 node_id=%r ⇒ got_type=%s" % (v, want),
144
- (o or {}).get("got_type"))
145
-
146
-
147
- def n7():
148
- print("== N7 跨面:audit 面对 None 报类型错(如实记录差异)==")
149
- cg = _cg("n7")
150
- o = _call(cg, {"op": "audit", "node_id": None})
151
- ok(_is_type_error(o), "N7 audit 面 node_id=None ⇒ node_id_not_str(与 read 面口径不同)",
152
- json.dumps(o, ensure_ascii=False)[:150])
153
-
154
-
155
- def _wire_err(res):
156
- try:
157
- if isinstance(res, dict) and "structuredContent" in res:
158
- sc = res["structuredContent"]
159
- if isinstance(sc, dict) and "result" in sc:
160
- return sc["result"]
161
- return sc
162
- if isinstance(res, dict) and "content" in res:
163
- return json.loads(res["content"][0]["text"])
164
- except Exception: # noqa: BLE001
165
- pass
166
- return res
167
-
168
-
169
- def n8():
170
- print("== N8 真 MCP stdio:null ⇒ 检索包;123 ⇒ 类型错 ==")
171
- root = tempfile.mkdtemp(prefix="n274_stdio_")
172
- os.makedirs(os.path.join(root, "knowledge"), exist_ok=True)
173
- from . import nodefile
174
- with io.open(os.path.join(root, "knowledge", "n1.md"), "w",
175
- encoding="utf-8") as f:
176
- f.write(nodefile.dumps({"id": "n1", "layer": "knowledge",
177
- "importance": 0.4, "created_at": 1800000000.0,
178
- "tags": []}, "alpha 内容"))
179
- msgs = [
180
- {"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {
181
- "name": "cg", "arguments": {"op": "read", "node_id": None,
182
- "query": "alpha"}}},
183
- {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {
184
- "name": "cg", "arguments": {"op": "read", "node_id": 123,
185
- "query": "alpha"}}},
186
- {"jsonrpc": "2.0", "id": 3, "method": "shutdown"},
187
- ]
188
- env = dict(os.environ, MDCG_ROOT=root,
189
- MDCG_AUX_ROOT=os.path.join(root, "auxiliary"),
190
- MDCG_DATA_ROOT=os.path.join(root, "data"),
191
- PYTHONUTF8="1", PYTHONIOENCODING="utf-8",
192
- MDCG_MCP_SURFACE="kernel")
193
- env.pop("MDCG_TOKEN", None)
194
- keep = ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT", "MDCG_MCP_SURFACE")
195
- for k in list(env):
196
- if k.startswith("MDCG_") and k not in keep:
197
- env.pop(k, None)
198
- try:
199
- pr = subprocess.run([sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
200
- input="".join(json.dumps(m) + "\n" for m in msgs),
201
- env=env, cwd=_REPO, capture_output=True, text=True,
202
- encoding="utf-8", timeout=120)
203
- outs = {}
204
- for line in (pr.stdout or "").splitlines():
205
- line = line.strip()
206
- if not line.startswith("{"):
207
- continue
208
- try:
209
- m = json.loads(line)
210
- except Exception: # noqa: BLE001
211
- continue
212
- if m.get("id") in (1, 2):
213
- outs[m["id"]] = m.get("result", m)
214
- ok(pr.returncode == 0, "N8a 真 stdio 子进程正常退出",
215
- (pr.returncode, (pr.stderr or "")[-200:]))
216
- o1 = outs.get(1)
217
- ok(o1 is not None and not _is_type_error(_wire_err(o1)),
218
- "N8b 真 wire:JSON null ⇒ 走检索(不报类型错)",
219
- json.dumps(o1, ensure_ascii=False)[:220])
220
- o2 = outs.get(2)
221
- ok(o2 is not None and _is_type_error(_wire_err(o2)),
222
- "N8c 真 wire:123 ⇒ node_id_not_str",
223
- json.dumps(o2, ensure_ascii=False)[:220])
224
- except Exception as exc: # noqa: BLE001
225
- ok(False, "N8 真 stdio 腿抛异常:%r" % (exc,))
226
-
227
-
228
- def _src() -> str:
229
- with io.open(os.path.join(_REPO, "md_cg", "mcp_server.py"),
230
- encoding="utf-8", errors="replace") as f:
231
- return f.read()
232
-
233
-
234
- def n9():
235
- print("== N9 反陈化:源码必须写明 None 的动机(本件修复的实质)==")
236
- t = _src()
237
- ok("issue #274" in t, "N9a 源码标注 issue #274(可追溯)")
238
- ok("刻意保留" in t or "刻意" in t,
239
- "N9b 源码写明该不对称是**刻意**的(不是疏漏)")
240
- ok("M2-B9" in t or "M2-B8" in t,
241
- "N9c 源码点名钉住该行为的测试(M2-B8/M2-B9)——改它须连带改测试")
242
- ok("显式 None 是" in t,
243
- "N9d 源码**逐字**写明 None 的语义(显式 None 是未传)——本件被误读的根因行")
244
-
245
-
246
- def n10():
247
- print("== N10 交叉引用:钉住该行为的两条断言仍存在 ==")
248
- p = os.path.join(_REPO, "md_cg", "test_read_face_input_gates.py")
249
- with io.open(p, encoding="utf-8", errors="replace") as f:
250
- t = f.read()
251
- ok("M2-B8" in t, "N10a M2-B8(显式空串不再静默降级为检索)仍在")
252
- ok("M2-B9" in t, "N10b M2-B9(node_id=None 仍是未传,走检索)仍在")
253
- ok("不回归" in t, "N10c M2-B9 仍声明「不回归」语义")
254
-
255
-
256
- _GROUPS = (n1, n2, n3, n4, n5, n6, n7, n8, n9, n10)
257
-
258
-
259
- def _run_groups() -> int:
260
- _PASS.clear()
261
- _FAIL.clear()
262
- for g in _GROUPS:
263
- try:
264
- g()
265
- except Exception as exc: # noqa: BLE001
266
- ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
267
- import traceback
268
- print(traceback.format_exc()[-700:])
269
- return len(_FAIL)
270
-
271
-
272
- def main() -> int:
273
- n = _run_groups()
274
- print("\nnode_id 两种显式处置守卫:%d 通过,%d 失败" % (len(_PASS), n))
275
- return 1 if n else 0
276
-
277
-
278
- # --------------------------------------------------------------- 定点变异自证
279
- _MUTATIONS = (
280
- ("V1 删掉 None 的动机说明(退回「只写空串动机」= 本件被误读的根因)",
281
- " # · 显式 None 是**未传**:MCP 客户端把「没有 id」序列化成 null 是常规形态,",
282
- " # (此处原本写明 None 的动机,被变异删除)",
283
- "N9"),
284
- ("V2 判据改为键存在性(把 None 也当显式 ⇒ 行为变更)",
285
- ' if a.get("node_id") is not None:',
286
- ' if "node_id" in a:',
287
- "N1"),
288
- ("V3 判据改为真值判(把显式空串也当没传)",
289
- ' if a.get("node_id") is not None:',
290
- ' if a.get("node_id"):',
291
- "N3"),
292
- )
293
-
294
-
295
- def _reload():
296
- import importlib
297
- from . import mcp_server as _m
298
- importlib.reload(_m)
299
- globals()["MS"] = _m
300
-
301
-
302
- def _mutate() -> int:
303
- bad = []
304
- src_p = os.path.join(_REPO, "md_cg", "mcp_server.py")
305
- for name, anchor, repl, want in _MUTATIONS:
306
- with io.open(src_p, encoding="utf-8", newline="") as f:
307
- orig = f.read()
308
- NL = "\r\n" if "\r\n" in orig else "\n"
309
- a_ = anchor.replace("\n", NL)
310
- r_ = repl.replace("\n", NL)
311
- try:
312
- if a_ not in orig:
313
- print(" ANCHOR-MISS %s" % name)
314
- bad.append(name)
315
- continue
316
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
317
- f.write(orig.replace(a_, r_))
318
- _reload()
319
- _run_groups()
320
- reds = list(_FAIL)
321
- hit = any(r.startswith(want) for r in reds)
322
- print(" %-4s %-52s 红项=%-3d 命中%s=%s"
323
- % ("OK" if hit else "BAD", name, len(reds), want,
324
- "是" if hit else "否"))
325
- if not hit:
326
- bad.append(name)
327
- finally:
328
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
329
- f.write(orig)
330
- _reload()
331
- if bad:
332
- print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
333
- return 1
334
- print("\n定点变异自证:PASS(每处判据都被打红)")
335
- return 0
336
-
337
-
338
- if __name__ == "__main__":
339
- if "--mutate" in sys.argv:
340
- sys.exit(_mutate())
341
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """读面 node_id「两种显式」处置不对称的守卫(issue #274)。
3
+
4
+ 【本守卫守什么】
5
+ #274 报:cg(op=read) 的 node_id=None **静默降级为检索**(返回检索结果包),
6
+ 而 node_id=123 正确报 node_id_not_str —— 同一个「类型错」两种相反待遇。
7
+
8
+ 复核结论:**读数全部成立,但处置不对称是刻意的,不是疏漏。**
9
+ · 显式 "" 是**显式** —— 旧写法会把它当没传而静默转检索,故它必须落进类型闸,
10
+ 走「节点不存在」的 null。
11
+ · 显式 None 是**未传** —— MCP 客户端把「没有 id」序列化成 null 是常规形态,
12
+ 故它落到检索分支;由 test_read_face_input_gates 的 M2-B8 / M2-B9 钉住
13
+ (M2-B9 断言名即「node_id=None 仍是「未传」,走检索(不回归)」)。
14
+
15
+ ⇒ 本件的**实际缺陷是文档缺口**:源码只写了 "" 的动机、没写 None 的动机,
16
+ 于是外部复审把它读成了疏漏。修法是**补文档**(+ 本守卫钉住该不对称),
17
+ **不是**改行为——改行为会打红 M2-B9,属 issue #274 的 R1(行为变更)。
18
+
19
+ 判据:
20
+ N1 node_id=None ⇒ 走检索(**刻意**;与「不传」同处置)。
21
+ N2 node_id=123 ⇒ node_id_not_str(类型错,对照)。
22
+ N3 node_id="" ⇒ null(显式空串**是**显式,不转检索)。
23
+ N4 不传 node_id ⇒ 走检索。
24
+ N5 node_id=None 与「不传」**逐字节相同** —— 把报告读到的这一事实**钉成契约**,
25
+ 以免将来有人"顺手修"成报错而不自知(要改须连带改 M2-B9 与协议表)。
26
+ N6 错误里 got_type 如实(不吞类型)。
27
+ N7 **跨面**:audit 面对 node_id=None 报 node_id_not_str —— 两面口径不同,
28
+ 本守卫**如实记录**该差异(不是要求一致;audit 无检索分支可落)。
29
+ N8 **真 MCP stdio**:JSON null ⇒ 检索包;123 ⇒ 类型错(真通路同形)。
30
+ N9 **反陈化(本件修复的实质)**:源码注释必须写明 None 的动机。
31
+ 只写 "" 的动机 ⇒ 红——因为那正是本件被误读成疏漏的根因。
32
+ N10 交叉引用:钉住该行为的 M2-B8 / M2-B9 两条断言仍存在(若被删,本守卫须知道)。
33
+
34
+ 运行:python -X utf8 -m md_cg.test_issue274_read_node_id_none
35
+ python -X utf8 -m md_cg.test_issue274_read_node_id_none --mutate
36
+
37
+ 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
38
+
39
+ 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import io
44
+ import json
45
+ import os
46
+ import subprocess
47
+ import sys
48
+ import tempfile
49
+
50
+ from .mdcos import MdCGOS
51
+ from . import mcp_server as MS
52
+
53
+ _HERE = os.path.dirname(os.path.abspath(__file__))
54
+ _REPO = os.path.dirname(_HERE)
55
+
56
+ _PASS: list = []
57
+ _FAIL: list = []
58
+
59
+
60
+ def ok(cond, msg, extra=""):
61
+ (_PASS if cond else _FAIL).append(msg)
62
+ print((" PASS " if cond else " FAIL ") + msg
63
+ + ((" -> " + str(extra)) if (extra and not cond) else ""))
64
+
65
+
66
+ def _cg(tag):
67
+ root = tempfile.mkdtemp(prefix="n274_%s_" % tag)
68
+ cg = MdCGOS(root)
69
+ cg.add(content="# alpha 知识\n\nalpha 内容。", layer="knowledge", node_id="n1",
70
+ importance=0.5, consistency=False, on_conflict="defer")
71
+ return cg
72
+
73
+
74
+ def _call(cg, a):
75
+ try:
76
+ return MS._cg_call(cg, a)
77
+ except Exception as exc: # noqa: BLE001
78
+ return {"__exc__": type(exc).__name__, "msg": str(exc)[:90]}
79
+
80
+
81
+ def _is_search_pack(o) -> bool:
82
+ return isinstance(o, dict) and ("results" in o or "meta" in o or "pack" in o)
83
+
84
+
85
+ def _is_type_error(o) -> bool:
86
+ return isinstance(o, dict) and o.get("error") == "node_id_not_str"
87
+
88
+
89
+ def n1():
90
+ print("== N1 node_id=None 走检索(刻意行为)==")
91
+ cg = _cg("n1")
92
+ o = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
93
+ ok(_is_search_pack(o), "N1 node_id=None + query ⇒ 检索结果包(刻意)",
94
+ json.dumps(o, ensure_ascii=False)[:150])
95
+ o2 = _call(cg, {"op": "read", "node_id": None})
96
+ ok("__exc__" not in (o2 or {}), "N1b node_id=None 无 query 不抛异常",
97
+ json.dumps(o2, ensure_ascii=False)[:150])
98
+
99
+
100
+ def n2():
101
+ print("== N2 node_id=123 报类型错(对照)==")
102
+ cg = _cg("n2")
103
+ o = _call(cg, {"op": "read", "node_id": 123, "query": "alpha"})
104
+ ok(_is_type_error(o), "N2 node_id=123 ⇒ node_id_not_str",
105
+ json.dumps(o, ensure_ascii=False)[:150])
106
+
107
+
108
+ def n3():
109
+ print("== N3 node_id='' 是显式 ⇒ null(不转检索)==")
110
+ cg = _cg("n3")
111
+ o = _call(cg, {"op": "read", "node_id": "", "query": "alpha"})
112
+ ok(not _is_search_pack(o), "N3a node_id='' 不返回检索包", repr(o)[:150])
113
+ ok(o is None, "N3b node_id='' ⇒ null(协议登记的 node_missing 形态)", repr(o)[:120])
114
+
115
+
116
+ def n4():
117
+ print("== N4 不传 node_id 走检索 ==")
118
+ cg = _cg("n4")
119
+ o = _call(cg, {"op": "read", "query": "alpha"})
120
+ ok(_is_search_pack(o), "N4a 不传 node_id + query ⇒ 检索结果包")
121
+ ok(not _is_type_error(o), "N4b 不传 node_id 不报类型错")
122
+
123
+
124
+ def n5():
125
+ print("== N5 node_id=None 与「不传」逐字节相同(钉成契约)==")
126
+ cg = _cg("n5")
127
+ a1 = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
128
+ a2 = _call(cg, {"op": "read", "query": "alpha"})
129
+ ok(json.dumps(a1, ensure_ascii=False, sort_keys=True)
130
+ == json.dumps(a2, ensure_ascii=False, sort_keys=True),
131
+ "N5 node_id=None 与不传 node_id 逐字节相同(报告读数,已钉为契约)",
132
+ (json.dumps(a1, ensure_ascii=False)[:100],
133
+ json.dumps(a2, ensure_ascii=False)[:100]))
134
+
135
+
136
+ def n6():
137
+ print("== N6 错误里 got_type 如实 ==")
138
+ cg = _cg("n6")
139
+ for v, want in ((123, "int"), (1.5, "float"), (True, "bool"),
140
+ (["x"], "list"), ({"a": 1}, "dict")):
141
+ o = _call(cg, {"op": "read", "node_id": v})
142
+ ok(_is_type_error(o) and o.get("got_type") == want,
143
+ "N6 node_id=%r ⇒ got_type=%s" % (v, want),
144
+ (o or {}).get("got_type"))
145
+
146
+
147
+ def n7():
148
+ print("== N7 跨面:audit 面对 None 报类型错(如实记录差异)==")
149
+ cg = _cg("n7")
150
+ o = _call(cg, {"op": "audit", "node_id": None})
151
+ ok(_is_type_error(o), "N7 audit 面 node_id=None ⇒ node_id_not_str(与 read 面口径不同)",
152
+ json.dumps(o, ensure_ascii=False)[:150])
153
+
154
+
155
+ def _wire_err(res):
156
+ try:
157
+ if isinstance(res, dict) and "structuredContent" in res:
158
+ sc = res["structuredContent"]
159
+ if isinstance(sc, dict) and "result" in sc:
160
+ return sc["result"]
161
+ return sc
162
+ if isinstance(res, dict) and "content" in res:
163
+ return json.loads(res["content"][0]["text"])
164
+ except Exception: # noqa: BLE001
165
+ pass
166
+ return res
167
+
168
+
169
+ def n8():
170
+ print("== N8 真 MCP stdio:null ⇒ 检索包;123 ⇒ 类型错 ==")
171
+ root = tempfile.mkdtemp(prefix="n274_stdio_")
172
+ os.makedirs(os.path.join(root, "knowledge"), exist_ok=True)
173
+ from . import nodefile
174
+ with io.open(os.path.join(root, "knowledge", "n1.md"), "w",
175
+ encoding="utf-8") as f:
176
+ f.write(nodefile.dumps({"id": "n1", "layer": "knowledge",
177
+ "importance": 0.4, "created_at": 1800000000.0,
178
+ "tags": []}, "alpha 内容"))
179
+ msgs = [
180
+ {"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {
181
+ "name": "cg", "arguments": {"op": "read", "node_id": None,
182
+ "query": "alpha"}}},
183
+ {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {
184
+ "name": "cg", "arguments": {"op": "read", "node_id": 123,
185
+ "query": "alpha"}}},
186
+ {"jsonrpc": "2.0", "id": 3, "method": "shutdown"},
187
+ ]
188
+ env = dict(os.environ, MDCG_ROOT=root,
189
+ MDCG_AUX_ROOT=os.path.join(root, "auxiliary"),
190
+ MDCG_DATA_ROOT=os.path.join(root, "data"),
191
+ PYTHONUTF8="1", PYTHONIOENCODING="utf-8",
192
+ MDCG_MCP_SURFACE="kernel")
193
+ env.pop("MDCG_TOKEN", None)
194
+ keep = ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT", "MDCG_MCP_SURFACE")
195
+ for k in list(env):
196
+ if k.startswith("MDCG_") and k not in keep:
197
+ env.pop(k, None)
198
+ try:
199
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
200
+ input="".join(json.dumps(m) + "\n" for m in msgs),
201
+ env=env, cwd=_REPO, capture_output=True, text=True,
202
+ encoding="utf-8", timeout=120)
203
+ outs = {}
204
+ for line in (pr.stdout or "").splitlines():
205
+ line = line.strip()
206
+ if not line.startswith("{"):
207
+ continue
208
+ try:
209
+ m = json.loads(line)
210
+ except Exception: # noqa: BLE001
211
+ continue
212
+ if m.get("id") in (1, 2):
213
+ outs[m["id"]] = m.get("result", m)
214
+ ok(pr.returncode == 0, "N8a 真 stdio 子进程正常退出",
215
+ (pr.returncode, (pr.stderr or "")[-200:]))
216
+ o1 = outs.get(1)
217
+ ok(o1 is not None and not _is_type_error(_wire_err(o1)),
218
+ "N8b 真 wire:JSON null ⇒ 走检索(不报类型错)",
219
+ json.dumps(o1, ensure_ascii=False)[:220])
220
+ o2 = outs.get(2)
221
+ ok(o2 is not None and _is_type_error(_wire_err(o2)),
222
+ "N8c 真 wire:123 ⇒ node_id_not_str",
223
+ json.dumps(o2, ensure_ascii=False)[:220])
224
+ except Exception as exc: # noqa: BLE001
225
+ ok(False, "N8 真 stdio 腿抛异常:%r" % (exc,))
226
+
227
+
228
+ def _src() -> str:
229
+ with io.open(os.path.join(_REPO, "md_cg", "mcp_server.py"),
230
+ encoding="utf-8", errors="replace") as f:
231
+ return f.read()
232
+
233
+
234
+ def n9():
235
+ print("== N9 反陈化:源码必须写明 None 的动机(本件修复的实质)==")
236
+ t = _src()
237
+ ok("issue #274" in t, "N9a 源码标注 issue #274(可追溯)")
238
+ ok("刻意保留" in t or "刻意" in t,
239
+ "N9b 源码写明该不对称是**刻意**的(不是疏漏)")
240
+ ok("M2-B9" in t or "M2-B8" in t,
241
+ "N9c 源码点名钉住该行为的测试(M2-B8/M2-B9)——改它须连带改测试")
242
+ ok("显式 None 是" in t,
243
+ "N9d 源码**逐字**写明 None 的语义(显式 None 是未传)——本件被误读的根因行")
244
+
245
+
246
+ def n10():
247
+ print("== N10 交叉引用:钉住该行为的两条断言仍存在 ==")
248
+ p = os.path.join(_REPO, "md_cg", "test_read_face_input_gates.py")
249
+ with io.open(p, encoding="utf-8", errors="replace") as f:
250
+ t = f.read()
251
+ ok("M2-B8" in t, "N10a M2-B8(显式空串不再静默降级为检索)仍在")
252
+ ok("M2-B9" in t, "N10b M2-B9(node_id=None 仍是未传,走检索)仍在")
253
+ ok("不回归" in t, "N10c M2-B9 仍声明「不回归」语义")
254
+
255
+
256
+ _GROUPS = (n1, n2, n3, n4, n5, n6, n7, n8, n9, n10)
257
+
258
+
259
+ def _run_groups() -> int:
260
+ _PASS.clear()
261
+ _FAIL.clear()
262
+ for g in _GROUPS:
263
+ try:
264
+ g()
265
+ except Exception as exc: # noqa: BLE001
266
+ ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
267
+ import traceback
268
+ print(traceback.format_exc()[-700:])
269
+ return len(_FAIL)
270
+
271
+
272
+ def main() -> int:
273
+ n = _run_groups()
274
+ print("\nnode_id 两种显式处置守卫:%d 通过,%d 失败" % (len(_PASS), n))
275
+ return 1 if n else 0
276
+
277
+
278
+ # --------------------------------------------------------------- 定点变异自证
279
+ _MUTATIONS = (
280
+ ("V1 删掉 None 的动机说明(退回「只写空串动机」= 本件被误读的根因)",
281
+ " # · 显式 None 是**未传**:MCP 客户端把「没有 id」序列化成 null 是常规形态,",
282
+ " # (此处原本写明 None 的动机,被变异删除)",
283
+ "N9"),
284
+ ("V2 判据改为键存在性(把 None 也当显式 ⇒ 行为变更)",
285
+ ' if a.get("node_id") is not None:',
286
+ ' if "node_id" in a:',
287
+ "N1"),
288
+ ("V3 判据改为真值判(把显式空串也当没传)",
289
+ ' if a.get("node_id") is not None:',
290
+ ' if a.get("node_id"):',
291
+ "N3"),
292
+ )
293
+
294
+
295
+ def _reload():
296
+ import importlib
297
+ from . import mcp_server as _m
298
+ importlib.reload(_m)
299
+ globals()["MS"] = _m
300
+
301
+
302
+ def _mutate() -> int:
303
+ bad = []
304
+ src_p = os.path.join(_REPO, "md_cg", "mcp_server.py")
305
+ for name, anchor, repl, want in _MUTATIONS:
306
+ with io.open(src_p, encoding="utf-8", newline="") as f:
307
+ orig = f.read()
308
+ NL = "\r\n" if "\r\n" in orig else "\n"
309
+ a_ = anchor.replace("\n", NL)
310
+ r_ = repl.replace("\n", NL)
311
+ try:
312
+ if a_ not in orig:
313
+ print(" ANCHOR-MISS %s" % name)
314
+ bad.append(name)
315
+ continue
316
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
317
+ f.write(orig.replace(a_, r_))
318
+ _reload()
319
+ _run_groups()
320
+ reds = list(_FAIL)
321
+ hit = any(r.startswith(want) for r in reds)
322
+ print(" %-4s %-52s 红项=%-3d 命中%s=%s"
323
+ % ("OK" if hit else "BAD", name, len(reds), want,
324
+ "是" if hit else "否"))
325
+ if not hit:
326
+ bad.append(name)
327
+ finally:
328
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
329
+ f.write(orig)
330
+ _reload()
331
+ if bad:
332
+ print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
333
+ return 1
334
+ print("\n定点变异自证:PASS(每处判据都被打红)")
335
+ return 0
336
+
337
+
338
+ if __name__ == "__main__":
339
+ if "--mutate" in sys.argv:
340
+ sys.exit(_mutate())
341
+ sys.exit(main())