@furongjun1999/dsh-memory 0.9.6 → 0.9.7

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 (216) hide show
  1. package/data/policy.json +38 -38
  2. package/docs/discipline/templates/spec.txt.tmpl +1 -1
  3. package/dsh/cordis.yml.example +139 -139
  4. package/lib/hooks.d.ts +19 -0
  5. package/lib/hooks.js +29 -6
  6. package/lib/index.js +11 -2
  7. package/lib/lib/hook_audit.js +38 -2
  8. package/lib/lib/prompt_safety.js +14 -3
  9. package/lib/tools.d.ts +7 -0
  10. package/lib/tools.js +22 -1
  11. package/md_cg/_guard_kit.py +121 -121
  12. package/md_cg/anchor.py +114 -114
  13. package/md_cg/audit.py +15 -2
  14. package/md_cg/chain.py +3 -2
  15. package/md_cg/config_registry_guard.py +487 -487
  16. package/md_cg/conformance.py +747 -747
  17. package/md_cg/consolidate.py +1793 -1793
  18. package/md_cg/crypto.py +794 -794
  19. package/md_cg/hyperedge.py +262 -262
  20. package/md_cg/interface_schema.py +146 -146
  21. package/md_cg/lifecycle.py +426 -426
  22. package/md_cg/mdcos.py +12 -8
  23. package/md_cg/predict.py +1103 -1103
  24. package/md_cg/protect.py +654 -654
  25. package/md_cg/provenance.py +606 -606
  26. package/md_cg/queue_health.py +130 -130
  27. package/md_cg/refine.py +613 -613
  28. package/md_cg/retrieve.py +128 -128
  29. package/md_cg/revise.py +140 -140
  30. package/md_cg/rollback.py +657 -657
  31. package/md_cg/rollback_cli.py +124 -124
  32. package/md_cg/rotate.py +346 -346
  33. package/md_cg/routing.py +490 -490
  34. package/md_cg/self_surface.py +50 -50
  35. package/md_cg/semantic/canonical.py +144 -144
  36. package/md_cg/semantic/zh_en_atoms.py +141 -141
  37. package/md_cg/sources.py +1091 -1091
  38. package/md_cg/stg.py +3 -2
  39. package/md_cg/test_audit_rotate_parity.py +279 -279
  40. package/md_cg/test_autonomy_modes.py +2013 -2013
  41. package/md_cg/test_cn_recall_grams.py +206 -206
  42. package/md_cg/test_code_kind_forbidden.py +101 -0
  43. package/md_cg/test_condaccept.py +156 -156
  44. package/md_cg/test_condgate.py +141 -141
  45. package/md_cg/test_heartbeat_ledger.py +557 -557
  46. package/md_cg/test_i50e_readside_protection.py +658 -658
  47. package/md_cg/test_issue111_gate_order.py +76 -76
  48. package/md_cg/test_issue111_scoring_contract.py +86 -86
  49. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  50. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  51. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  52. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  53. package/md_cg/test_issue149_accel_default_face.py +248 -248
  54. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  55. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  56. package/md_cg/test_issue152_sealed_postings.py +309 -309
  57. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  58. package/md_cg/test_issue157b_index_remainder.py +344 -344
  59. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  60. package/md_cg/test_issue191_import_trust.py +382 -382
  61. package/md_cg/test_issue193_write_scope.py +378 -378
  62. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  63. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  64. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  65. package/md_cg/test_issue216_clash_routes.py +214 -214
  66. package/md_cg/test_issue217_slot_routes.py +248 -248
  67. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  68. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  69. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  70. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  71. package/md_cg/test_issue275_layer_param.py +250 -250
  72. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  73. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  74. package/md_cg/test_issue278_neg_window.py +294 -294
  75. package/md_cg/test_issue278_negative_layering.py +83 -83
  76. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  77. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  78. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  79. package/md_cg/test_issue303_design_boundaries.py +262 -262
  80. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  81. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  82. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  83. package/md_cg/test_issue322_node_write_lock.py +727 -727
  84. package/md_cg/test_issue324_write_size_fields.py +214 -214
  85. package/md_cg/test_issue325_audit_poison.py +229 -229
  86. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  87. package/md_cg/test_issue326_key_perms.py +355 -355
  88. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  89. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  90. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  91. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  92. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  93. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  94. package/md_cg/test_issue350_casefold_collision.py +235 -235
  95. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  96. package/md_cg/test_issue352_imgaudit.py +418 -418
  97. package/md_cg/test_issue352_pathsjson.py +537 -537
  98. package/md_cg/test_issue352_refindex.py +412 -412
  99. package/md_cg/test_issue352_rollback.py +604 -604
  100. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  101. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  102. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  103. package/md_cg/test_issue358_truncation_observable.py +247 -247
  104. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  105. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  106. package/md_cg/test_issue362_neg_condition.py +468 -468
  107. package/md_cg/test_issue363_lexical_idf.py +275 -275
  108. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  109. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  110. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  111. package/md_cg/test_issue378_protected_floor.py +310 -310
  112. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  113. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  114. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  115. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  116. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  117. package/md_cg/test_issue404_heal_receipt.py +389 -389
  118. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  119. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  120. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  121. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  122. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  123. package/md_cg/test_issue413_preimage_twin.py +339 -339
  124. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  125. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  126. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  127. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  128. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  129. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  130. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  131. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  132. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  133. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  134. package/md_cg/test_issue434_435_float_gate.py +90 -90
  135. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  136. package/md_cg/test_issue43_default_policy.py +874 -874
  137. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  138. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  139. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  140. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  141. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  142. package/md_cg/test_issue451_audit_actor.py +313 -313
  143. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  144. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  145. package/md_cg/test_issue466_basis_registry.py +469 -469
  146. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  147. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  148. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  149. package/md_cg/test_issue471_identity_readable.py +136 -136
  150. package/md_cg/test_issue472_audit_chain.py +90 -90
  151. package/md_cg/test_issue472_prune_ledger.py +105 -105
  152. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  153. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  154. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  155. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  156. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  157. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  158. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  159. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  160. package/md_cg/test_issue547_audit_durable.py +96 -96
  161. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  162. package/md_cg/test_issue559_refine_prefix.py +69 -69
  163. package/md_cg/test_issue562_retired_faces.py +150 -0
  164. package/md_cg/test_issue71_queue_backlog.py +376 -376
  165. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  166. package/md_cg/test_issue82_credential_rules.py +271 -271
  167. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  168. package/md_cg/test_issue93_remember_redaction.py +282 -282
  169. package/md_cg/test_logref.py +1141 -1141
  170. package/md_cg/test_md_access_parity.py +330 -330
  171. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  172. package/md_cg/test_mutation_residue.py +119 -119
  173. package/md_cg/test_mutation_rollback.py +835 -835
  174. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  175. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  176. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  177. package/md_cg/test_neg_tail_honesty.py +733 -733
  178. package/md_cg/test_p21_tokens.py +294 -294
  179. package/md_cg/test_p27_docindex.py +792 -792
  180. package/md_cg/test_p28_refcheck.py +1053 -1053
  181. package/md_cg/test_p2_six_elements.py +476 -476
  182. package/md_cg/test_p33_ccg_wiring.py +300 -300
  183. package/md_cg/test_p3_legacy_closure.py +438 -438
  184. package/md_cg/test_p40_refine_worklist.py +244 -244
  185. package/md_cg/test_p4_freshness.py +781 -781
  186. package/md_cg/test_p9c_dedup_hints.py +288 -288
  187. package/md_cg/test_policy_required_ccg.py +444 -444
  188. package/md_cg/test_retr_s5.py +312 -312
  189. package/md_cg/test_s1_ast_judge.py +109 -109
  190. package/md_cg/test_state_event_op.py +521 -521
  191. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  192. package/md_cg/test_sustain_bounded.py +652 -652
  193. package/md_cg/test_trust_edge_reachability.py +405 -405
  194. package/md_cg/test_w7_redlines.py +659 -659
  195. package/md_cg/test_write_return_shape.py +919 -919
  196. package/md_cg/test_writepipe.py +228 -228
  197. package/md_cg/trust.py +1114 -1114
  198. package/md_cg/twophase.py +303 -303
  199. package/md_cg/whitebox.py +536 -536
  200. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  201. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  202. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  203. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  204. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  205. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  206. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  207. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  208. package/md_cg/writepipe.py +1337 -1337
  209. package/package.json +3 -2
  210. package/scripts/workspace_index.py +328 -0
  211. package/src/hooks.ts +30 -6
  212. package/src/index.ts +14 -5
  213. package/src/lib/hook_audit.ts +282 -256
  214. package/src/lib/mdcg_client.ts +469 -469
  215. package/src/lib/prompt_safety.ts +17 -3
  216. package/src/tools.ts +23 -1
@@ -1,476 +1,476 @@
1
- # -*- coding: utf-8 -*-
2
- """P2 守卫 · 六要素 6 行索引(§5.1)/ 拒绝域双语义(§5.2)/ 全进默认检索(§5.4)。
3
-
4
- 覆盖判据(每条对应契约的一项):
5
-
6
- G1 **六要素那张表从 4 行长成 6 行**:`nodefile.CCG_INDEX_ROLES` 恰 6 行、
7
- 前 4 行 == 理论 `智能论3.4.md:3053-3059` 的 4 行、后 2 行 == 新增的
8
- 「验证方式(后置条件词)/ 不适用条件(拒绝域词)」;6 行字段名集合与
9
- `nodefile.CCG_MARKS` **同源**(不新造第六个要素名)。
10
- G2 **取要素文本走既有单点**:`ccg_element_terms` 吃的是
11
- `ccg_field_value` 的行语义(冒号可有可无、后接行形态),**不是**检索面
12
- 自写的正则——三条行为断言(冒号形态 / 无冒号换行形态 / 缺行)+
13
- 与 `ccg_field_value` 的对拍;并断言词长下限与 `mdcg.NEG_MIN_TERM` 同值。
14
- G3 **两个键进索引条目**(`_node_entry`,与 `time_window`/`observation_position`
15
- 同为免读文件的扁指标量):条目含两键且值 == nodefile 单点计算值;
16
- **写路径(`add`)与重建路径(`rebuild_index`)同口径**。
17
- G4 **重建协议四条硬约束**(§5.3):①幂等(`_fingerprint` 对拍 + 两次重建的
18
- `_index.json` 字节相同)②增量优先(指纹未变时 `_maybe_reload_index`
19
- 不换索引对象)③可回退(源面 .md 逐字节不变)④可对拍(重建前后同查询
20
- top-k 序列与分数**逐位不变**)。
21
- G5 **拒绝域双语义**(§5.2,前置必做):**同一节点**既被边界命中、
22
- 又**未**被资格 REJECT;`boundary_hit` 与资格 REJECT **分开计数**
23
- (两个独立键);灵敏度不变(情境真的落在拒绝域 ⇒ 非边界问句照旧 REJECT)。
24
- G6 **全进默认检索**(§5.4):默认 `search_rrf` 上,边界问句只召回「声明了
25
- 拒绝域」的节点并打 `boundary_hit`;拒绝域词**不作普通问句的召回键**
26
- (`positive_body` 的既有立场不变);`meta["boundary"]` 与
27
- `meta["judge_filtered"]` 分开呈现。
28
- G7 **旧库零破坏**:条目缺这两键(未重建的旧索引快照)时 `index_key_hits`
29
- 判 False;`_like` 的三参旧签名行为与改动前一致。
30
-
31
- 运行:
32
- python -X utf8 -m md_cg.test_p2_six_elements # 正向
33
- python -X utf8 -m md_cg.test_p2_six_elements --mutate # 定点变异自证
34
- python -X utf8 -m md_cg.test_p2_six_elements --mutate --list # 列出变异
35
-
36
- 退出码:0 = 全绿;1 = 有断言失败 / 变异未按预期转红;2 = ANCHOR-MISS
37
- (变异锚点在本源码里找不到——实现改了却没同步本表,硬失败不静默跳过)。
38
-
39
- 硬边界:不动任何在役数据根(库根一律 tempfile);不 git add/commit/push。
40
- """
41
- from __future__ import annotations
42
-
43
- import hashlib
44
- import json
45
- import os
46
- import sys
47
- import tempfile
48
-
49
- # ── 隔离前置:必须在 import md_cg 子模块之前(tokens/theory 等模块级冻 aux_root)──
50
- _TMP0 = tempfile.mkdtemp(prefix="p2_six_")
51
- os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
52
- os.environ["MDCG_MASTER_KEY"] = "ef" * 32
53
- os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
54
- os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
55
- for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
56
- "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS"):
57
- os.environ.pop(_k, None)
58
-
59
- sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
60
-
61
- try:
62
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
63
- except AttributeError:
64
- pass
65
-
66
- from md_cg import nodefile # noqa: E402
67
- from md_cg import mdcg as M # noqa: E402
68
- from md_cg.mdcos import MdCGOS # noqa: E402
69
-
70
- PASS = 0
71
- FAIL = 0
72
- FAILS = []
73
-
74
-
75
- def check(name, cond, detail=""):
76
- global PASS, FAIL
77
- if cond:
78
- PASS += 1
79
- print(f" OK {name}")
80
- else:
81
- FAIL += 1
82
- FAILS.append(name)
83
- print(f" FAIL {name} {detail}")
84
- return bool(cond)
85
-
86
-
87
- BODY = ("# 功能名:{n}\n"
88
- "# 生效条件:无条件\n"
89
- "# 子功能:无\n"
90
- "# 执行:占位\n"
91
- "# 验证方式:compiler test 复现\n"
92
- "# 不适用条件:{neg}\n\n{t}\n")
93
-
94
-
95
- #: 不适用条件按 `;` 分条(与写入面 ccgc 的拆分口径同源:每条=一个独立拒绝域条目)
96
- NEG_TWO = "其它会话;无关查询"
97
-
98
-
99
- def _mk(cg, nid, neg=NEG_TWO, tail=None, **kw):
100
- cg.add(nid, BODY.format(n=nid, neg=neg, t=tail or f"{nid} 正文 苹果 章节"),
101
- layer="knowledge", **kw)
102
-
103
-
104
- def _tree_hash(root):
105
- h = hashlib.sha256()
106
- for dirpath, dirs, files in os.walk(root):
107
- # 派生物/运行态(_index.json / _index_log/ / _access.log …)不入源面对拍
108
- dirs[:] = sorted(d for d in dirs if not d.startswith("_"))
109
- for fn in sorted(files):
110
- if fn.startswith("_"):
111
- continue
112
- p = os.path.join(dirpath, fn)
113
- h.update(os.path.relpath(p, root).replace("\\", "/").encode())
114
- with open(p, "rb") as f:
115
- h.update(f.read())
116
- return h.hexdigest()[:16]
117
-
118
-
119
- def _corpus(nd=2):
120
- root = tempfile.mkdtemp(prefix="p2_six_lib_")
121
- cg = MdCGOS(root)
122
- if nd >= 1:
123
- _mk(cg, "k_decl")
124
- if nd >= 2:
125
- _mk(cg, "k_nodecl", neg="无")
126
- cg.flush()
127
- return root, cg
128
-
129
-
130
- def g1_table_six_rows():
131
- print("== G1 六要素表:4 行 → 6 行 ==")
132
- roles = tuple(nodefile.CCG_INDEX_ROLES)
133
- check("表恰 6 行", len(roles) == 6, str(len(roles)))
134
- check("前 4 行 == 理论 4 行",
135
- [r[0] for r in roles[:4]] == ["功能名", "生效条件", "子功能", "执行"],
136
- str([r[0] for r in roles[:4]]))
137
- check("后 2 行 == 新增两要素(验证方式 / 不适用条件)",
138
- [r[0] for r in roles[4:]] == [nodefile.POSTCONDITION_FIELD,
139
- nodefile.REJECTION_FIELD],
140
- str([r[0] for r in roles[4:]]))
141
- check("后 2 行的索引键名 == 条目里的键(单一真源)",
142
- nodefile.INDEX_TERMS_KEYS == (nodefile.POSTCONDITION_TERMS_KEY,
143
- nodefile.REJECTION_TERMS_KEY),
144
- str(nodefile.INDEX_TERMS_KEYS))
145
- check("6 行字段名集合与 CCG_MARKS 同源",
146
- {r[0] for r in roles} == set(nodefile.CCG_MARKS),
147
- str({r[0] for r in roles} ^ set(nodefile.CCG_MARKS)))
148
- check("每行的索引键列非空", all(str(r[1]).strip() for r in roles))
149
-
150
-
151
- def g2_single_parse_point():
152
- print("== G2 取要素文本:走既有单点(非检索面自写正则)==")
153
- colon = "# 功能名:x\n# 验证方式:compiler test 复现\n# 不适用条件:其它会话 无关查询\n"
154
- nocolon = "# 功能名:x\n# 验证方式\ncompiler 复现\n# 不适用条件\n其它会话\n"
155
- missing = "# 功能名:x\n# 执行:无\n"
156
- check("冒号形态取值",
157
- nodefile.ccg_element_terms(colon, "验证方式") == ["compiler", "test", "复现"],
158
- str(nodefile.ccg_element_terms(colon, "验证方式")))
159
- check("无冒号换行形态取值(行语义与 ccg_field_value 一致)",
160
- nodefile.ccg_element_terms(nocolon, "验证方式") == ["compiler", "复现"],
161
- str(nodefile.ccg_element_terms(nocolon, "验证方式")))
162
- check("缺行 → 空表(不猜测)",
163
- nodefile.ccg_element_terms(missing, "验证方式") == [])
164
- # 与单点对拍:terms 必须 == element_terms_from_text(ccg_field_value(...))
165
- ok = all(nodefile.ccg_element_terms(c, f)
166
- == nodefile.element_terms_from_text(nodefile.ccg_field_value(c, f))
167
- for c in (colon, nocolon, missing)
168
- for f in ("验证方式", "不适用条件"))
169
- check("与 ccg_field_value 逐例对拍一致(取值单点未旁路)", ok)
170
- check("词长下限与 mdcg.NEG_MIN_TERM 同值(同口径)",
171
- nodefile.ELEMENT_TERM_MIN == M.NEG_MIN_TERM,
172
- f"{nodefile.ELEMENT_TERM_MIN} vs {M.NEG_MIN_TERM}")
173
- check("空值语义哨兵不入键(不适用条件:无 → 空表)",
174
- nodefile.ccg_element_terms(colon.replace("其它会话 无关查询", "无"),
175
- "不适用条件") == [],
176
- str(nodefile.ccg_element_terms(
177
- colon.replace("其它会话 无关查询", "无"), "不适用条件")))
178
-
179
-
180
- def g3_entry_keys():
181
- print("== G3 两键进索引条目(写路径 / 重建路径同口径)==")
182
- root, cg = _corpus()
183
- try:
184
- e = cg.index["nodes"]["k_decl"]
185
- check("条目含后置条件词键",
186
- nodefile.POSTCONDITION_TERMS_KEY in e and
187
- e[nodefile.POSTCONDITION_TERMS_KEY] == ["compiler", "test", "复现"],
188
- str(e.get(nodefile.POSTCONDITION_TERMS_KEY)))
189
- check("条目含拒绝域词键",
190
- e.get(nodefile.REJECTION_TERMS_KEY) == ["其它会话", "无关查询"],
191
- str(e.get(nodefile.REJECTION_TERMS_KEY)))
192
- check("不声明拒绝域的节点该键为空",
193
- (cg.index["nodes"]["k_nodecl"].get(
194
- nodefile.REJECTION_TERMS_KEY) or []) == [],
195
- str(cg.index["nodes"]["k_nodecl"].get(
196
- nodefile.REJECTION_TERMS_KEY)))
197
- # 两键是**扁指标量**:与 time_window/observation_position 同为条目直读标量
198
- check("两键为 list(扁指标量,非嵌套对象)",
199
- isinstance(e[nodefile.POSTCONDITION_TERMS_KEY], list)
200
- and isinstance(e[nodefile.REJECTION_TERMS_KEY], list))
201
- # 写路径 vs 重建路径:重建后再取,两键逐位相同
202
- before = {k: e.get(k) for k in nodefile.INDEX_TERMS_KEYS}
203
- cg.rebuild_index()
204
- after = {k: cg.index["nodes"]["k_decl"].get(k)
205
- for k in nodefile.INDEX_TERMS_KEYS}
206
- check("写路径 == 重建路径(两键逐位相同)", before == after,
207
- f"{before} vs {after}")
208
- finally:
209
- cg.close()
210
-
211
-
212
- def g4_rebuild_protocol():
213
- print("== G4 重建协议四条硬约束(§5.3)==")
214
- root, cg = _corpus()
215
- try:
216
- seq_a = [(r[0]["id"], round(float(r[1]), 6))
217
- for r in cg.search_rrf("苹果 章节", k=5, record=False)[0]]
218
- src_a = _tree_hash(root)
219
- idx_path = cg.index_path
220
- cg.rebuild_index() # 第一次:写快照(幂等对拍的左值)
221
- fp_a = cg.index.get("_fingerprint")
222
- with open(idx_path, "rb") as f:
223
- bytes_a = f.read()
224
- cg.rebuild_index() # 第二次:同源重建(对拍右值)
225
- fp_b = cg.index.get("_fingerprint")
226
- with open(idx_path, "rb") as f:
227
- bytes_b = f.read()
228
- src_b = _tree_hash(root)
229
- seq_b = [(r[0]["id"], round(float(r[1]), 6))
230
- for r in cg.search_rrf("苹果 章节", k=5, record=False)[0]]
231
- check("① 幂等:同源重建 _fingerprint 对拍相等", fp_a == fp_b,
232
- f"{fp_a} vs {fp_b}")
233
- check("① 幂等:两次重建的 _index.json 字节相同", bytes_a == bytes_b)
234
- check("③ 可回退:重建只覆盖派生物,源面逐字节不变",
235
- src_a == src_b, f"{src_a} vs {src_b}")
236
- check("④ 可对拍:重建前后合法次序逐位不变", seq_a == seq_b,
237
- f"{seq_a} vs {seq_b}")
238
- # ② 增量优先:指纹未变时 _maybe_reload_index 不换索引对象(不重扫)
239
- obj_a = cg.index
240
- cg._maybe_reload_index()
241
- check("② 增量优先:指纹未变则不重建(索引对象不变)",
242
- cg.index is obj_a)
243
- finally:
244
- cg.close()
245
-
246
-
247
- def g5_dual_semantics():
248
- print("== G5 拒绝域双语义:同一节点既边界命中、又未被资格 REJECT ==")
249
- root, cg = _corpus()
250
- try:
251
- nd = cg.get("k_decl")
252
- # ① 边界问句 + 查询自带拒绝域词面 → 边界命中 ∧ 非 REJECT
253
- q1 = "什么条件下不适用 其它会话"
254
- jb = M.MdCG.judge_with_boundary(nd, q1, None)
255
- check("边界命中为真", jb["boundary"]["hit"] is True,
256
- str(jb["boundary"]))
257
- check("同一节点未被资格 REJECT(自否定 = 0)",
258
- jb["qualification"]["state"] != M.STATE_REJECT,
259
- str(jb["qualification"]))
260
- check("可召回可展示", jb["recallable"] is True)
261
- check("分开计数:boundary_hit 与 reject 是两个独立键",
262
- jb["counts"]["boundary_hit"] == 1 and jb["counts"]["reject"] == 0,
263
- str(jb["counts"]))
264
- # ② 灵敏度不变:非边界问句 + 情境真的落在拒绝域 → 照旧 REJECT
265
- jb2 = M.MdCG.judge_with_boundary(nd, "刚才在干什么", {"scene": "其它会话"})
266
- check("非边界问句下情境落在拒绝域仍判 REJECT(灵敏度不变)",
267
- jb2["qualification"]["state"] == M.STATE_REJECT,
268
- str(jb2["qualification"]))
269
- check("该情形同样分开计数(reject=1 / boundary_hit=1)",
270
- jb2["counts"]["reject"] == 1 and jb2["counts"]["boundary_hit"] == 1,
271
- str(jb2["counts"]))
272
- # ③ 边界标记单点:两条来源(情境落在拒绝域 / 边界问句且已声明)
273
- b1 = M.boundary_mark(nd, "什么条件下不适用", None)
274
- b2 = M.boundary_mark(nd, "刚才在干什么", {"scene": "无关查询"})
275
- check("边界问句且已声明拒绝域 → 命中",
276
- b1["hit"] and b1["why"] == ["boundary_query_and_declared"],
277
- str(b1))
278
- check("情境落在拒绝域 → 命中(复用 P0-4 判据)",
279
- b2["hit"] and "scene_in_rejection_domain" in b2["why"], str(b2))
280
- check("marker 恒为 boundary_hit(展示标记,不是资格结论)",
281
- b1["marker"] == M.BOUNDARY_MARKER)
282
- finally:
283
- cg.close()
284
-
285
-
286
- def g6_default_recall():
287
- print("== G6 六要素后两行全进默认检索(§5.4)==")
288
- root, cg = _corpus()
289
- try:
290
- # 「何时不适用」:不撞 CCG 样板词面(生效条件/验证方式…),故若无索引键
291
- # 则一个都召不回——正是「索引键驱动召回」的判别用例。
292
- r, meta = cg.search_rrf("何时不适用", k=5, record=False)
293
- ids = [x[0]["id"] for x in r]
294
- check("边界问句召回「声明了拒绝域」的节点",
295
- ids == ["k_decl"], str(ids))
296
- check("该节点带 boundary_hit 标记",
297
- bool(r) and r[0][0].get("boundary_hit") is True,
298
- str([x[0].get("boundary_hit") for x in r]))
299
- check("未声明拒绝域的节点不被召回", "k_nodecl" not in ids, str(ids))
300
- check("meta 分开呈现边界读数(独立键)",
301
- (meta.get("boundary") or {}).get("hit") == 1
302
- and "boundary" in meta and "judge_filtered" in meta,
303
- str(meta.get("boundary")))
304
- check("默认路集仍为六路(不缺路)",
305
- set((meta.get("paths") or {}).keys()) == {
306
- "lexical", "bucket", "entity", "graph", "chain",
307
- "temporal"}, str(sorted((meta.get("paths") or {}).keys())))
308
- # 验证方式(第 5 行):按验证手段检索
309
- r2, _ = cg.search_rrf("compiler", k=5, record=False)
310
- check("按验证手段可召回(后置条件词索引键)",
311
- "k_decl" in [x[0]["id"] for x in r2],
312
- str([x[0]["id"] for x in r2]))
313
- # 拒绝域**不作普通问句的召回键**(positive_body 的既有立场不变)
314
- ent = cg.index["nodes"]["k_decl"]
315
- terms_norm = M.expand_query_terms("其它会话")
316
- check("普通问句:拒绝域键不参与召回",
317
- M.index_key_hits(ent, terms_norm, "其它会话")["hit"] is False,
318
- str(M.index_key_hits(ent, terms_norm, "其它会话")))
319
- check("边界问句:拒绝域键参与召回",
320
- M.index_key_hits(ent, terms_norm, "何时不适用")["reject"] is True,
321
- str(M.index_key_hits(ent, terms_norm, "何时不适用")))
322
- finally:
323
- cg.close()
324
-
325
-
326
- def g7_legacy_zero_break():
327
- print("== G7 旧库零破坏(条目缺键 / 旧签名)==")
328
- root, cg = _corpus()
329
- try:
330
- old = {"path": "knowledge/k_old.md", "tags": [], "importance": 0.5}
331
- hits = M.index_key_hits(old, ["其它会话"], "何时不适用")
332
- # issue #218(2026-10-13 DSH 端):本项原为**整字典相等**断言。
333
- # #218 在回传体上**新增**了 post_source / reject_source 两个结构化字段
334
- # (使「值命中 term」与「仅声明命中 declared」可区分),整字典相等随之
335
- # 不再成立。此处不是放宽,而是把两件事**分开钉死**:
336
- # ① 语义(本项原本要保的):缺键 ⇒ hit/post/reject 全 False、why 空
337
- # —— 即「未重建的旧快照退回旧行为」,逐位不变;
338
- # ② 形状:新增字段存在且为 None(未命中时不谎报出口)。
339
- # ②比原来的「整字典相等」更严:它同时约束了新字段的缺省值。
340
- _legacy = {k: hits[k] for k in ("hit", "post", "reject", "why")}
341
- check("条目缺两键 → 判 False(未重建的旧快照退回旧行为)",
342
- _legacy == {"hit": False, "post": False, "reject": False, "why": []},
343
- str(hits))
344
- check("条目缺两键 → 新增分支字段存在且为 None(#218 形状约束)",
345
- hits.get("post_source") is None
346
- and hits.get("reject_source") is None,
347
- str(hits))
348
- # `_like` 三参旧签名(旧调用方)行为与改动前一致
349
- body = BODY.format(n="x", neg="其它会话", t="苹果 章节")
350
- check("_like 三参旧签名:按 positive_body 命中",
351
- M.MdCG._like(body, {}, ["苹果"]) is True)
352
- check("_like 三参旧签名:不适用条件行仍不作召回键",
353
- M.MdCG._like(body, {}, ["其它会话"]) is False,
354
- "positive_body 立场被破坏")
355
- finally:
356
- cg.close()
357
-
358
-
359
- # --------------------------------------------------------------------------
360
- # 定点变异(自证断言有判别力;只改本进程内存对象,绝不改仓库文件)
361
- # --------------------------------------------------------------------------
362
-
363
- def _mut_mark_min():
364
- return _patch(nodefile, "ELEMENT_TERM_MIN", 1)
365
-
366
-
367
- def _mut_roles_4rows():
368
- return _patch(nodefile, "CCG_INDEX_ROLES",
369
- tuple(nodefile.CCG_INDEX_ROLES[:4]))
370
-
371
-
372
- def _mut_boundary_markers():
373
- return _patch(M, "BOUNDARY_QUERY_MARKERS", ())
374
-
375
-
376
- def _mut_index_key_hits_off():
377
- orig = M.index_key_hits
378
- M.index_key_hits = lambda entry, terms, query: {
379
- "hit": False, "post": False, "reject": False, "why": []}
380
-
381
- def restore():
382
- M.index_key_hits = orig
383
- return restore
384
-
385
-
386
- def _mut_boundary_no_strip():
387
- orig = M.MdCG.judge_with_boundary
388
-
389
- def shrunk(node_dict, query, context=None):
390
- qual = dict(M.MdCG.judge_qualification(node_dict, query, context))
391
- st = str(qual.get("state") or "")
392
- counts = {k: int(st == v) for k, v in
393
- (("accept", M.STATE_ACCEPT), ("reject", M.STATE_REJECT),
394
- ("defer", M.STATE_DEFER), ("blindspot", M.STATE_BLINDSPOT))}
395
- counts["boundary_hit"] = 0
396
- return {"qualification": qual, "boundary": {"hit": False, "terms": [],
397
- "marker": None},
398
- "counts": counts,
399
- "recallable": st not in (M.STATE_REJECT, M.STATE_BLINDSPOT)}
400
-
401
- M.MdCG.judge_with_boundary = staticmethod(shrunk)
402
-
403
- def restore():
404
- M.MdCG.judge_with_boundary = orig
405
- return restore
406
-
407
-
408
- def _patch(mod, name, value):
409
- orig = getattr(mod, name)
410
-
411
- def restore():
412
- setattr(mod, name, orig)
413
- setattr(mod, name, value)
414
- return restore
415
-
416
-
417
- _MUTATIONS = [
418
- ("roles_4rows", "把六要素表退回 4 行", _mut_roles_4rows),
419
- ("term_min_1", "索引词长下限改成 1(与 NEG_MIN_TERM 分叉)", _mut_mark_min),
420
- ("no_boundary_markers", "边界问句标记表清空", _mut_boundary_markers),
421
- ("index_keys_off", "索引键召回判据恒 False", _mut_index_key_hits_off),
422
- ("no_boundary_strip", "边界问句不再摘词面(自否定回归)",
423
- _mut_boundary_no_strip),
424
- ]
425
-
426
-
427
- def _collect():
428
- """跑全部断言组,返回失败清单(变异自证用同一批断言)。"""
429
- global PASS, FAIL, FAILS
430
- PASS, FAIL, FAILS = 0, 0, []
431
- g1_table_six_rows()
432
- g2_single_parse_point()
433
- g3_entry_keys()
434
- g4_rebuild_protocol()
435
- g5_dual_semantics()
436
- g6_default_recall()
437
- g7_legacy_zero_break()
438
- return list(FAILS)
439
-
440
-
441
- def main(argv):
442
- if "--mutate" in argv:
443
- if "--list" in argv:
444
- for name, desc, _fn in _MUTATIONS:
445
- print(f" {name:24s} {desc}")
446
- return 0
447
- base = _collect()
448
- if base:
449
- print(f"\n!! 基线不绿({len(base)} 条失败)——变异自证无意义:{base}")
450
- return 1
451
- bad = []
452
- for name, desc, fn in _MUTATIONS:
453
- for anchor in ():
454
- pass
455
- try:
456
- restore = fn()
457
- except AttributeError as exc: # 锚点漂移:硬失败
458
- print(f" ANCHOR-MISS {name}: {exc}")
459
- return 2
460
- got = _collect()
461
- restore()
462
- if got:
463
- print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
464
- else:
465
- bad.append(name)
466
- print(f" MUTATE-FAIL {name}({desc})→ 仍全绿(断言无判别力)")
467
- print(f"\ntest_p2_six_elements --mutate: "
468
- f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
469
- return 0 if not bad else 1
470
- fails = _collect()
471
- print(f"\ntest_p2_six_elements: {PASS} 通过 / {FAIL} 失败")
472
- return 0 if not fails else 1
473
-
474
-
475
- if __name__ == "__main__":
476
- sys.exit(main(sys.argv[1:]))
1
+ # -*- coding: utf-8 -*-
2
+ """P2 守卫 · 六要素 6 行索引(§5.1)/ 拒绝域双语义(§5.2)/ 全进默认检索(§5.4)。
3
+
4
+ 覆盖判据(每条对应契约的一项):
5
+
6
+ G1 **六要素那张表从 4 行长成 6 行**:`nodefile.CCG_INDEX_ROLES` 恰 6 行、
7
+ 前 4 行 == 理论 `智能论3.4.md:3053-3059` 的 4 行、后 2 行 == 新增的
8
+ 「验证方式(后置条件词)/ 不适用条件(拒绝域词)」;6 行字段名集合与
9
+ `nodefile.CCG_MARKS` **同源**(不新造第六个要素名)。
10
+ G2 **取要素文本走既有单点**:`ccg_element_terms` 吃的是
11
+ `ccg_field_value` 的行语义(冒号可有可无、后接行形态),**不是**检索面
12
+ 自写的正则——三条行为断言(冒号形态 / 无冒号换行形态 / 缺行)+
13
+ 与 `ccg_field_value` 的对拍;并断言词长下限与 `mdcg.NEG_MIN_TERM` 同值。
14
+ G3 **两个键进索引条目**(`_node_entry`,与 `time_window`/`observation_position`
15
+ 同为免读文件的扁指标量):条目含两键且值 == nodefile 单点计算值;
16
+ **写路径(`add`)与重建路径(`rebuild_index`)同口径**。
17
+ G4 **重建协议四条硬约束**(§5.3):①幂等(`_fingerprint` 对拍 + 两次重建的
18
+ `_index.json` 字节相同)②增量优先(指纹未变时 `_maybe_reload_index`
19
+ 不换索引对象)③可回退(源面 .md 逐字节不变)④可对拍(重建前后同查询
20
+ top-k 序列与分数**逐位不变**)。
21
+ G5 **拒绝域双语义**(§5.2,前置必做):**同一节点**既被边界命中、
22
+ 又**未**被资格 REJECT;`boundary_hit` 与资格 REJECT **分开计数**
23
+ (两个独立键);灵敏度不变(情境真的落在拒绝域 ⇒ 非边界问句照旧 REJECT)。
24
+ G6 **全进默认检索**(§5.4):默认 `search_rrf` 上,边界问句只召回「声明了
25
+ 拒绝域」的节点并打 `boundary_hit`;拒绝域词**不作普通问句的召回键**
26
+ (`positive_body` 的既有立场不变);`meta["boundary"]` 与
27
+ `meta["judge_filtered"]` 分开呈现。
28
+ G7 **旧库零破坏**:条目缺这两键(未重建的旧索引快照)时 `index_key_hits`
29
+ 判 False;`_like` 的三参旧签名行为与改动前一致。
30
+
31
+ 运行:
32
+ python -X utf8 -m md_cg.test_p2_six_elements # 正向
33
+ python -X utf8 -m md_cg.test_p2_six_elements --mutate # 定点变异自证
34
+ python -X utf8 -m md_cg.test_p2_six_elements --mutate --list # 列出变异
35
+
36
+ 退出码:0 = 全绿;1 = 有断言失败 / 变异未按预期转红;2 = ANCHOR-MISS
37
+ (变异锚点在本源码里找不到——实现改了却没同步本表,硬失败不静默跳过)。
38
+
39
+ 硬边界:不动任何在役数据根(库根一律 tempfile);不 git add/commit/push。
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import hashlib
44
+ import json
45
+ import os
46
+ import sys
47
+ import tempfile
48
+
49
+ # ── 隔离前置:必须在 import md_cg 子模块之前(tokens/theory 等模块级冻 aux_root)──
50
+ _TMP0 = tempfile.mkdtemp(prefix="p2_six_")
51
+ os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
52
+ os.environ["MDCG_MASTER_KEY"] = "ef" * 32
53
+ os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
54
+ os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
55
+ for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
56
+ "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS"):
57
+ os.environ.pop(_k, None)
58
+
59
+ sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
60
+
61
+ try:
62
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
63
+ except AttributeError:
64
+ pass
65
+
66
+ from md_cg import nodefile # noqa: E402
67
+ from md_cg import mdcg as M # noqa: E402
68
+ from md_cg.mdcos import MdCGOS # noqa: E402
69
+
70
+ PASS = 0
71
+ FAIL = 0
72
+ FAILS = []
73
+
74
+
75
+ def check(name, cond, detail=""):
76
+ global PASS, FAIL
77
+ if cond:
78
+ PASS += 1
79
+ print(f" OK {name}")
80
+ else:
81
+ FAIL += 1
82
+ FAILS.append(name)
83
+ print(f" FAIL {name} {detail}")
84
+ return bool(cond)
85
+
86
+
87
+ BODY = ("# 功能名:{n}\n"
88
+ "# 生效条件:无条件\n"
89
+ "# 子功能:无\n"
90
+ "# 执行:占位\n"
91
+ "# 验证方式:compiler test 复现\n"
92
+ "# 不适用条件:{neg}\n\n{t}\n")
93
+
94
+
95
+ #: 不适用条件按 `;` 分条(与写入面 ccgc 的拆分口径同源:每条=一个独立拒绝域条目)
96
+ NEG_TWO = "其它会话;无关查询"
97
+
98
+
99
+ def _mk(cg, nid, neg=NEG_TWO, tail=None, **kw):
100
+ cg.add(nid, BODY.format(n=nid, neg=neg, t=tail or f"{nid} 正文 苹果 章节"),
101
+ layer="knowledge", **kw)
102
+
103
+
104
+ def _tree_hash(root):
105
+ h = hashlib.sha256()
106
+ for dirpath, dirs, files in os.walk(root):
107
+ # 派生物/运行态(_index.json / _index_log/ / _access.log …)不入源面对拍
108
+ dirs[:] = sorted(d for d in dirs if not d.startswith("_"))
109
+ for fn in sorted(files):
110
+ if fn.startswith("_"):
111
+ continue
112
+ p = os.path.join(dirpath, fn)
113
+ h.update(os.path.relpath(p, root).replace("\\", "/").encode())
114
+ with open(p, "rb") as f:
115
+ h.update(f.read())
116
+ return h.hexdigest()[:16]
117
+
118
+
119
+ def _corpus(nd=2):
120
+ root = tempfile.mkdtemp(prefix="p2_six_lib_")
121
+ cg = MdCGOS(root)
122
+ if nd >= 1:
123
+ _mk(cg, "k_decl")
124
+ if nd >= 2:
125
+ _mk(cg, "k_nodecl", neg="无")
126
+ cg.flush()
127
+ return root, cg
128
+
129
+
130
+ def g1_table_six_rows():
131
+ print("== G1 六要素表:4 行 → 6 行 ==")
132
+ roles = tuple(nodefile.CCG_INDEX_ROLES)
133
+ check("表恰 6 行", len(roles) == 6, str(len(roles)))
134
+ check("前 4 行 == 理论 4 行",
135
+ [r[0] for r in roles[:4]] == ["功能名", "生效条件", "子功能", "执行"],
136
+ str([r[0] for r in roles[:4]]))
137
+ check("后 2 行 == 新增两要素(验证方式 / 不适用条件)",
138
+ [r[0] for r in roles[4:]] == [nodefile.POSTCONDITION_FIELD,
139
+ nodefile.REJECTION_FIELD],
140
+ str([r[0] for r in roles[4:]]))
141
+ check("后 2 行的索引键名 == 条目里的键(单一真源)",
142
+ nodefile.INDEX_TERMS_KEYS == (nodefile.POSTCONDITION_TERMS_KEY,
143
+ nodefile.REJECTION_TERMS_KEY),
144
+ str(nodefile.INDEX_TERMS_KEYS))
145
+ check("6 行字段名集合与 CCG_MARKS 同源",
146
+ {r[0] for r in roles} == set(nodefile.CCG_MARKS),
147
+ str({r[0] for r in roles} ^ set(nodefile.CCG_MARKS)))
148
+ check("每行的索引键列非空", all(str(r[1]).strip() for r in roles))
149
+
150
+
151
+ def g2_single_parse_point():
152
+ print("== G2 取要素文本:走既有单点(非检索面自写正则)==")
153
+ colon = "# 功能名:x\n# 验证方式:compiler test 复现\n# 不适用条件:其它会话 无关查询\n"
154
+ nocolon = "# 功能名:x\n# 验证方式\ncompiler 复现\n# 不适用条件\n其它会话\n"
155
+ missing = "# 功能名:x\n# 执行:无\n"
156
+ check("冒号形态取值",
157
+ nodefile.ccg_element_terms(colon, "验证方式") == ["compiler", "test", "复现"],
158
+ str(nodefile.ccg_element_terms(colon, "验证方式")))
159
+ check("无冒号换行形态取值(行语义与 ccg_field_value 一致)",
160
+ nodefile.ccg_element_terms(nocolon, "验证方式") == ["compiler", "复现"],
161
+ str(nodefile.ccg_element_terms(nocolon, "验证方式")))
162
+ check("缺行 → 空表(不猜测)",
163
+ nodefile.ccg_element_terms(missing, "验证方式") == [])
164
+ # 与单点对拍:terms 必须 == element_terms_from_text(ccg_field_value(...))
165
+ ok = all(nodefile.ccg_element_terms(c, f)
166
+ == nodefile.element_terms_from_text(nodefile.ccg_field_value(c, f))
167
+ for c in (colon, nocolon, missing)
168
+ for f in ("验证方式", "不适用条件"))
169
+ check("与 ccg_field_value 逐例对拍一致(取值单点未旁路)", ok)
170
+ check("词长下限与 mdcg.NEG_MIN_TERM 同值(同口径)",
171
+ nodefile.ELEMENT_TERM_MIN == M.NEG_MIN_TERM,
172
+ f"{nodefile.ELEMENT_TERM_MIN} vs {M.NEG_MIN_TERM}")
173
+ check("空值语义哨兵不入键(不适用条件:无 → 空表)",
174
+ nodefile.ccg_element_terms(colon.replace("其它会话 无关查询", "无"),
175
+ "不适用条件") == [],
176
+ str(nodefile.ccg_element_terms(
177
+ colon.replace("其它会话 无关查询", "无"), "不适用条件")))
178
+
179
+
180
+ def g3_entry_keys():
181
+ print("== G3 两键进索引条目(写路径 / 重建路径同口径)==")
182
+ root, cg = _corpus()
183
+ try:
184
+ e = cg.index["nodes"]["k_decl"]
185
+ check("条目含后置条件词键",
186
+ nodefile.POSTCONDITION_TERMS_KEY in e and
187
+ e[nodefile.POSTCONDITION_TERMS_KEY] == ["compiler", "test", "复现"],
188
+ str(e.get(nodefile.POSTCONDITION_TERMS_KEY)))
189
+ check("条目含拒绝域词键",
190
+ e.get(nodefile.REJECTION_TERMS_KEY) == ["其它会话", "无关查询"],
191
+ str(e.get(nodefile.REJECTION_TERMS_KEY)))
192
+ check("不声明拒绝域的节点该键为空",
193
+ (cg.index["nodes"]["k_nodecl"].get(
194
+ nodefile.REJECTION_TERMS_KEY) or []) == [],
195
+ str(cg.index["nodes"]["k_nodecl"].get(
196
+ nodefile.REJECTION_TERMS_KEY)))
197
+ # 两键是**扁指标量**:与 time_window/observation_position 同为条目直读标量
198
+ check("两键为 list(扁指标量,非嵌套对象)",
199
+ isinstance(e[nodefile.POSTCONDITION_TERMS_KEY], list)
200
+ and isinstance(e[nodefile.REJECTION_TERMS_KEY], list))
201
+ # 写路径 vs 重建路径:重建后再取,两键逐位相同
202
+ before = {k: e.get(k) for k in nodefile.INDEX_TERMS_KEYS}
203
+ cg.rebuild_index()
204
+ after = {k: cg.index["nodes"]["k_decl"].get(k)
205
+ for k in nodefile.INDEX_TERMS_KEYS}
206
+ check("写路径 == 重建路径(两键逐位相同)", before == after,
207
+ f"{before} vs {after}")
208
+ finally:
209
+ cg.close()
210
+
211
+
212
+ def g4_rebuild_protocol():
213
+ print("== G4 重建协议四条硬约束(§5.3)==")
214
+ root, cg = _corpus()
215
+ try:
216
+ seq_a = [(r[0]["id"], round(float(r[1]), 6))
217
+ for r in cg.search_rrf("苹果 章节", k=5, record=False)[0]]
218
+ src_a = _tree_hash(root)
219
+ idx_path = cg.index_path
220
+ cg.rebuild_index() # 第一次:写快照(幂等对拍的左值)
221
+ fp_a = cg.index.get("_fingerprint")
222
+ with open(idx_path, "rb") as f:
223
+ bytes_a = f.read()
224
+ cg.rebuild_index() # 第二次:同源重建(对拍右值)
225
+ fp_b = cg.index.get("_fingerprint")
226
+ with open(idx_path, "rb") as f:
227
+ bytes_b = f.read()
228
+ src_b = _tree_hash(root)
229
+ seq_b = [(r[0]["id"], round(float(r[1]), 6))
230
+ for r in cg.search_rrf("苹果 章节", k=5, record=False)[0]]
231
+ check("① 幂等:同源重建 _fingerprint 对拍相等", fp_a == fp_b,
232
+ f"{fp_a} vs {fp_b}")
233
+ check("① 幂等:两次重建的 _index.json 字节相同", bytes_a == bytes_b)
234
+ check("③ 可回退:重建只覆盖派生物,源面逐字节不变",
235
+ src_a == src_b, f"{src_a} vs {src_b}")
236
+ check("④ 可对拍:重建前后合法次序逐位不变", seq_a == seq_b,
237
+ f"{seq_a} vs {seq_b}")
238
+ # ② 增量优先:指纹未变时 _maybe_reload_index 不换索引对象(不重扫)
239
+ obj_a = cg.index
240
+ cg._maybe_reload_index()
241
+ check("② 增量优先:指纹未变则不重建(索引对象不变)",
242
+ cg.index is obj_a)
243
+ finally:
244
+ cg.close()
245
+
246
+
247
+ def g5_dual_semantics():
248
+ print("== G5 拒绝域双语义:同一节点既边界命中、又未被资格 REJECT ==")
249
+ root, cg = _corpus()
250
+ try:
251
+ nd = cg.get("k_decl")
252
+ # ① 边界问句 + 查询自带拒绝域词面 → 边界命中 ∧ 非 REJECT
253
+ q1 = "什么条件下不适用 其它会话"
254
+ jb = M.MdCG.judge_with_boundary(nd, q1, None)
255
+ check("边界命中为真", jb["boundary"]["hit"] is True,
256
+ str(jb["boundary"]))
257
+ check("同一节点未被资格 REJECT(自否定 = 0)",
258
+ jb["qualification"]["state"] != M.STATE_REJECT,
259
+ str(jb["qualification"]))
260
+ check("可召回可展示", jb["recallable"] is True)
261
+ check("分开计数:boundary_hit 与 reject 是两个独立键",
262
+ jb["counts"]["boundary_hit"] == 1 and jb["counts"]["reject"] == 0,
263
+ str(jb["counts"]))
264
+ # ② 灵敏度不变:非边界问句 + 情境真的落在拒绝域 → 照旧 REJECT
265
+ jb2 = M.MdCG.judge_with_boundary(nd, "刚才在干什么", {"scene": "其它会话"})
266
+ check("非边界问句下情境落在拒绝域仍判 REJECT(灵敏度不变)",
267
+ jb2["qualification"]["state"] == M.STATE_REJECT,
268
+ str(jb2["qualification"]))
269
+ check("该情形同样分开计数(reject=1 / boundary_hit=1)",
270
+ jb2["counts"]["reject"] == 1 and jb2["counts"]["boundary_hit"] == 1,
271
+ str(jb2["counts"]))
272
+ # ③ 边界标记单点:两条来源(情境落在拒绝域 / 边界问句且已声明)
273
+ b1 = M.boundary_mark(nd, "什么条件下不适用", None)
274
+ b2 = M.boundary_mark(nd, "刚才在干什么", {"scene": "无关查询"})
275
+ check("边界问句且已声明拒绝域 → 命中",
276
+ b1["hit"] and b1["why"] == ["boundary_query_and_declared"],
277
+ str(b1))
278
+ check("情境落在拒绝域 → 命中(复用 P0-4 判据)",
279
+ b2["hit"] and "scene_in_rejection_domain" in b2["why"], str(b2))
280
+ check("marker 恒为 boundary_hit(展示标记,不是资格结论)",
281
+ b1["marker"] == M.BOUNDARY_MARKER)
282
+ finally:
283
+ cg.close()
284
+
285
+
286
+ def g6_default_recall():
287
+ print("== G6 六要素后两行全进默认检索(§5.4)==")
288
+ root, cg = _corpus()
289
+ try:
290
+ # 「何时不适用」:不撞 CCG 样板词面(生效条件/验证方式…),故若无索引键
291
+ # 则一个都召不回——正是「索引键驱动召回」的判别用例。
292
+ r, meta = cg.search_rrf("何时不适用", k=5, record=False)
293
+ ids = [x[0]["id"] for x in r]
294
+ check("边界问句召回「声明了拒绝域」的节点",
295
+ ids == ["k_decl"], str(ids))
296
+ check("该节点带 boundary_hit 标记",
297
+ bool(r) and r[0][0].get("boundary_hit") is True,
298
+ str([x[0].get("boundary_hit") for x in r]))
299
+ check("未声明拒绝域的节点不被召回", "k_nodecl" not in ids, str(ids))
300
+ check("meta 分开呈现边界读数(独立键)",
301
+ (meta.get("boundary") or {}).get("hit") == 1
302
+ and "boundary" in meta and "judge_filtered" in meta,
303
+ str(meta.get("boundary")))
304
+ check("默认路集仍为六路(不缺路)",
305
+ set((meta.get("paths") or {}).keys()) == {
306
+ "lexical", "bucket", "entity", "graph", "chain",
307
+ "temporal"}, str(sorted((meta.get("paths") or {}).keys())))
308
+ # 验证方式(第 5 行):按验证手段检索
309
+ r2, _ = cg.search_rrf("compiler", k=5, record=False)
310
+ check("按验证手段可召回(后置条件词索引键)",
311
+ "k_decl" in [x[0]["id"] for x in r2],
312
+ str([x[0]["id"] for x in r2]))
313
+ # 拒绝域**不作普通问句的召回键**(positive_body 的既有立场不变)
314
+ ent = cg.index["nodes"]["k_decl"]
315
+ terms_norm = M.expand_query_terms("其它会话")
316
+ check("普通问句:拒绝域键不参与召回",
317
+ M.index_key_hits(ent, terms_norm, "其它会话")["hit"] is False,
318
+ str(M.index_key_hits(ent, terms_norm, "其它会话")))
319
+ check("边界问句:拒绝域键参与召回",
320
+ M.index_key_hits(ent, terms_norm, "何时不适用")["reject"] is True,
321
+ str(M.index_key_hits(ent, terms_norm, "何时不适用")))
322
+ finally:
323
+ cg.close()
324
+
325
+
326
+ def g7_legacy_zero_break():
327
+ print("== G7 旧库零破坏(条目缺键 / 旧签名)==")
328
+ root, cg = _corpus()
329
+ try:
330
+ old = {"path": "knowledge/k_old.md", "tags": [], "importance": 0.5}
331
+ hits = M.index_key_hits(old, ["其它会话"], "何时不适用")
332
+ # issue #218(2026-10-13 DSH 端):本项原为**整字典相等**断言。
333
+ # #218 在回传体上**新增**了 post_source / reject_source 两个结构化字段
334
+ # (使「值命中 term」与「仅声明命中 declared」可区分),整字典相等随之
335
+ # 不再成立。此处不是放宽,而是把两件事**分开钉死**:
336
+ # ① 语义(本项原本要保的):缺键 ⇒ hit/post/reject 全 False、why 空
337
+ # —— 即「未重建的旧快照退回旧行为」,逐位不变;
338
+ # ② 形状:新增字段存在且为 None(未命中时不谎报出口)。
339
+ # ②比原来的「整字典相等」更严:它同时约束了新字段的缺省值。
340
+ _legacy = {k: hits[k] for k in ("hit", "post", "reject", "why")}
341
+ check("条目缺两键 → 判 False(未重建的旧快照退回旧行为)",
342
+ _legacy == {"hit": False, "post": False, "reject": False, "why": []},
343
+ str(hits))
344
+ check("条目缺两键 → 新增分支字段存在且为 None(#218 形状约束)",
345
+ hits.get("post_source") is None
346
+ and hits.get("reject_source") is None,
347
+ str(hits))
348
+ # `_like` 三参旧签名(旧调用方)行为与改动前一致
349
+ body = BODY.format(n="x", neg="其它会话", t="苹果 章节")
350
+ check("_like 三参旧签名:按 positive_body 命中",
351
+ M.MdCG._like(body, {}, ["苹果"]) is True)
352
+ check("_like 三参旧签名:不适用条件行仍不作召回键",
353
+ M.MdCG._like(body, {}, ["其它会话"]) is False,
354
+ "positive_body 立场被破坏")
355
+ finally:
356
+ cg.close()
357
+
358
+
359
+ # --------------------------------------------------------------------------
360
+ # 定点变异(自证断言有判别力;只改本进程内存对象,绝不改仓库文件)
361
+ # --------------------------------------------------------------------------
362
+
363
+ def _mut_mark_min():
364
+ return _patch(nodefile, "ELEMENT_TERM_MIN", 1)
365
+
366
+
367
+ def _mut_roles_4rows():
368
+ return _patch(nodefile, "CCG_INDEX_ROLES",
369
+ tuple(nodefile.CCG_INDEX_ROLES[:4]))
370
+
371
+
372
+ def _mut_boundary_markers():
373
+ return _patch(M, "BOUNDARY_QUERY_MARKERS", ())
374
+
375
+
376
+ def _mut_index_key_hits_off():
377
+ orig = M.index_key_hits
378
+ M.index_key_hits = lambda entry, terms, query: {
379
+ "hit": False, "post": False, "reject": False, "why": []}
380
+
381
+ def restore():
382
+ M.index_key_hits = orig
383
+ return restore
384
+
385
+
386
+ def _mut_boundary_no_strip():
387
+ orig = M.MdCG.judge_with_boundary
388
+
389
+ def shrunk(node_dict, query, context=None):
390
+ qual = dict(M.MdCG.judge_qualification(node_dict, query, context))
391
+ st = str(qual.get("state") or "")
392
+ counts = {k: int(st == v) for k, v in
393
+ (("accept", M.STATE_ACCEPT), ("reject", M.STATE_REJECT),
394
+ ("defer", M.STATE_DEFER), ("blindspot", M.STATE_BLINDSPOT))}
395
+ counts["boundary_hit"] = 0
396
+ return {"qualification": qual, "boundary": {"hit": False, "terms": [],
397
+ "marker": None},
398
+ "counts": counts,
399
+ "recallable": st not in (M.STATE_REJECT, M.STATE_BLINDSPOT)}
400
+
401
+ M.MdCG.judge_with_boundary = staticmethod(shrunk)
402
+
403
+ def restore():
404
+ M.MdCG.judge_with_boundary = orig
405
+ return restore
406
+
407
+
408
+ def _patch(mod, name, value):
409
+ orig = getattr(mod, name)
410
+
411
+ def restore():
412
+ setattr(mod, name, orig)
413
+ setattr(mod, name, value)
414
+ return restore
415
+
416
+
417
+ _MUTATIONS = [
418
+ ("roles_4rows", "把六要素表退回 4 行", _mut_roles_4rows),
419
+ ("term_min_1", "索引词长下限改成 1(与 NEG_MIN_TERM 分叉)", _mut_mark_min),
420
+ ("no_boundary_markers", "边界问句标记表清空", _mut_boundary_markers),
421
+ ("index_keys_off", "索引键召回判据恒 False", _mut_index_key_hits_off),
422
+ ("no_boundary_strip", "边界问句不再摘词面(自否定回归)",
423
+ _mut_boundary_no_strip),
424
+ ]
425
+
426
+
427
+ def _collect():
428
+ """跑全部断言组,返回失败清单(变异自证用同一批断言)。"""
429
+ global PASS, FAIL, FAILS
430
+ PASS, FAIL, FAILS = 0, 0, []
431
+ g1_table_six_rows()
432
+ g2_single_parse_point()
433
+ g3_entry_keys()
434
+ g4_rebuild_protocol()
435
+ g5_dual_semantics()
436
+ g6_default_recall()
437
+ g7_legacy_zero_break()
438
+ return list(FAILS)
439
+
440
+
441
+ def main(argv):
442
+ if "--mutate" in argv:
443
+ if "--list" in argv:
444
+ for name, desc, _fn in _MUTATIONS:
445
+ print(f" {name:24s} {desc}")
446
+ return 0
447
+ base = _collect()
448
+ if base:
449
+ print(f"\n!! 基线不绿({len(base)} 条失败)——变异自证无意义:{base}")
450
+ return 1
451
+ bad = []
452
+ for name, desc, fn in _MUTATIONS:
453
+ for anchor in ():
454
+ pass
455
+ try:
456
+ restore = fn()
457
+ except AttributeError as exc: # 锚点漂移:硬失败
458
+ print(f" ANCHOR-MISS {name}: {exc}")
459
+ return 2
460
+ got = _collect()
461
+ restore()
462
+ if got:
463
+ print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
464
+ else:
465
+ bad.append(name)
466
+ print(f" MUTATE-FAIL {name}({desc})→ 仍全绿(断言无判别力)")
467
+ print(f"\ntest_p2_six_elements --mutate: "
468
+ f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
469
+ return 0 if not bad else 1
470
+ fails = _collect()
471
+ print(f"\ntest_p2_six_elements: {PASS} 通过 / {FAIL} 失败")
472
+ return 0 if not fails else 1
473
+
474
+
475
+ if __name__ == "__main__":
476
+ sys.exit(main(sys.argv[1:]))