@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,77 +1,77 @@
1
- # -*- coding: utf-8 -*-
2
- r"""test_issue111_gate_order · #111 检查③(换算法不得放宽资格闸)的**结构性契约**守卫。
3
-
4
- 背景:外部 RRF3 v1.1 + ChronicleDM 与 #111 的采纳验证里,第 ③ 项要求「换检索打分层,
5
- DEFER/BLINDSPOT 与密级/会话/层过滤不得放宽」。本仓的实现结构是「打分 → 资格判定 → 过滤」,
6
- 即资格闸在打分**下游**;只要这一顺序不被打破,换打分函数天然不影响四态资格。
7
-
8
- 本守卫只钉结构(不钉分数、不钉算法):
9
- ① 判据入口 `judge_qualification` 存在;
10
- ② 它在 `search_rrf` 的函数体**之内**被调用(资格判定不是另起一条平行管线);
11
- ③ `search_rrf` 的返回装配里,`state` 取自 `qualification` 变量(不是各处自写 state)。
12
- 若将来有人把资格判定挪到打分上游或旁路,本守卫转红。
13
- """
14
- import ast
15
- import io
16
- import os
17
- import sys
18
-
19
- HERE = os.path.dirname(os.path.abspath(__file__))
20
- SRC = os.path.join(HERE, "mdcos.py")
21
- PASS = 0
22
- FAIL = 0
23
- FAILS = []
24
-
25
-
26
- def check(name, ok, detail=""):
27
- global PASS, FAIL
28
- if ok:
29
- PASS += 1
30
- print("[PASS] %s%s" % (name, (" · " + detail) if detail else ""))
31
- else:
32
- FAIL += 1
33
- FAILS.append(name)
34
- print("[FAIL] %s · %s" % (name, detail))
35
-
36
-
37
- src = io.open(SRC, encoding="utf-8").read()
38
- tree = ast.parse(src)
39
- lines = src.splitlines()
40
-
41
-
42
- def find_func(name):
43
- for node in ast.walk(tree):
44
- if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)) and node.name == name:
45
- return node
46
- return None
47
-
48
-
49
- jq = find_func("judge_qualification")
50
- check("① 判据入口 judge_qualification 存在", jq is not None,
51
- "line %s" % (jq.lineno if jq else "n/a"))
52
-
53
- rrf = find_func("search_rrf")
54
- check("② search_rrf 存在", rrf is not None, "line %s" % (rrf.lineno if rrf else "n/a"))
55
-
56
- if rrf is not None:
57
- lo = rrf.lineno
58
- hi = max(getattr(n, "lineno", lo) for n in ast.walk(rrf))
59
- calls = [n for n in ast.walk(rrf)
60
- if isinstance(n, ast.Call) and isinstance(n.func, ast.Attribute)
61
- and n.func.attr == "judge_qualification"]
62
- check("② 资格判定在 search_rrf 函数体内被调用(下游,不是平行管线)",
63
- bool(calls), "calls=%d body=[%d,%d]" % (len(calls), lo, hi))
64
- body_src = ast.get_source_segment(src, rrf) or ""
65
- hand_written = body_src.count("STATE_DEFER") + body_src.count("STATE_BLINDSPOT")
66
- # 允许恰 1 处:判据不可得时的保守回落(DEFER);新增任何手写四态都必须红。
67
- check("③ search_rrf 的手写四态常量不超过既定基线 1(新增即红)",
68
- hand_written <= 1, "手写 STATE_DEFER/BLINDSPOT %d 次(基线 1)" % hand_written)
69
-
70
- print()
71
- print("=" * 64)
72
- print("通过 %d / 失败 %d" % (PASS, FAIL))
73
- if FAILS:
74
- for f in FAILS:
75
- print(" - " + f)
76
- print("=" * 64)
1
+ # -*- coding: utf-8 -*-
2
+ r"""test_issue111_gate_order · #111 检查③(换算法不得放宽资格闸)的**结构性契约**守卫。
3
+
4
+ 背景:外部 RRF3 v1.1 + ChronicleDM 与 #111 的采纳验证里,第 ③ 项要求「换检索打分层,
5
+ DEFER/BLINDSPOT 与密级/会话/层过滤不得放宽」。本仓的实现结构是「打分 → 资格判定 → 过滤」,
6
+ 即资格闸在打分**下游**;只要这一顺序不被打破,换打分函数天然不影响四态资格。
7
+
8
+ 本守卫只钉结构(不钉分数、不钉算法):
9
+ ① 判据入口 `judge_qualification` 存在;
10
+ ② 它在 `search_rrf` 的函数体**之内**被调用(资格判定不是另起一条平行管线);
11
+ ③ `search_rrf` 的返回装配里,`state` 取自 `qualification` 变量(不是各处自写 state)。
12
+ 若将来有人把资格判定挪到打分上游或旁路,本守卫转红。
13
+ """
14
+ import ast
15
+ import io
16
+ import os
17
+ import sys
18
+
19
+ HERE = os.path.dirname(os.path.abspath(__file__))
20
+ SRC = os.path.join(HERE, "mdcos.py")
21
+ PASS = 0
22
+ FAIL = 0
23
+ FAILS = []
24
+
25
+
26
+ def check(name, ok, detail=""):
27
+ global PASS, FAIL
28
+ if ok:
29
+ PASS += 1
30
+ print("[PASS] %s%s" % (name, (" · " + detail) if detail else ""))
31
+ else:
32
+ FAIL += 1
33
+ FAILS.append(name)
34
+ print("[FAIL] %s · %s" % (name, detail))
35
+
36
+
37
+ src = io.open(SRC, encoding="utf-8").read()
38
+ tree = ast.parse(src)
39
+ lines = src.splitlines()
40
+
41
+
42
+ def find_func(name):
43
+ for node in ast.walk(tree):
44
+ if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)) and node.name == name:
45
+ return node
46
+ return None
47
+
48
+
49
+ jq = find_func("judge_qualification")
50
+ check("① 判据入口 judge_qualification 存在", jq is not None,
51
+ "line %s" % (jq.lineno if jq else "n/a"))
52
+
53
+ rrf = find_func("search_rrf")
54
+ check("② search_rrf 存在", rrf is not None, "line %s" % (rrf.lineno if rrf else "n/a"))
55
+
56
+ if rrf is not None:
57
+ lo = rrf.lineno
58
+ hi = max(getattr(n, "lineno", lo) for n in ast.walk(rrf))
59
+ calls = [n for n in ast.walk(rrf)
60
+ if isinstance(n, ast.Call) and isinstance(n.func, ast.Attribute)
61
+ and n.func.attr == "judge_qualification"]
62
+ check("② 资格判定在 search_rrf 函数体内被调用(下游,不是平行管线)",
63
+ bool(calls), "calls=%d body=[%d,%d]" % (len(calls), lo, hi))
64
+ body_src = ast.get_source_segment(src, rrf) or ""
65
+ hand_written = body_src.count("STATE_DEFER") + body_src.count("STATE_BLINDSPOT")
66
+ # 允许恰 1 处:判据不可得时的保守回落(DEFER);新增任何手写四态都必须红。
67
+ check("③ search_rrf 的手写四态常量不超过既定基线 1(新增即红)",
68
+ hand_written <= 1, "手写 STATE_DEFER/BLINDSPOT %d 次(基线 1)" % hand_written)
69
+
70
+ print()
71
+ print("=" * 64)
72
+ print("通过 %d / 失败 %d" % (PASS, FAIL))
73
+ if FAILS:
74
+ for f in FAILS:
75
+ print(" - " + f)
76
+ print("=" * 64)
77
77
  sys.exit(0 if FAIL == 0 else 1)
@@ -1,87 +1,87 @@
1
- # -*- coding: utf-8 -*-
2
- r"""test_issue111_scoring_contract · #111 打分层可换**接口契约**的结构守卫(第 10 轮)。
3
-
4
- 权威件 `docs/mdcg/检索标准算法_RRF3_ChronicleDM_v1.0.md` §三·补二 定了「只换打分层」的契约。
5
- 本守卫把其中三条可静态判定的条款钉住(不碰行为、不碰算法):
6
-
7
- ① **纯函数面**:`search_rrf` 内不得有落盘调用(open/append_jsonl/dump/replace/rename/remove/mkdir…);
8
- ② **state 不自造**:`search_rrf` 内 `"state"` 键字面量恰 1 处,且其取值引用了 `qual`(= judge_qualification 的结果);
9
- ③ **时钟显式**:`search_rrf` 内取时钟调用数 = 1(基线),新增隐式 `now()/time()` 即红——换算法时时钟必须显式传入。
10
-
11
- 任何一条转红都意味着「打分层不再可换」,须先改生产代码或先改契约,不得直接调基线数字了事。
12
- """
13
- import ast
14
- import io
15
- import os
16
- import sys
17
-
18
- HERE = os.path.dirname(os.path.abspath(__file__))
19
- SRC = os.path.join(HERE, "mdcos.py")
20
- PASS = 0
21
- FAIL = 0
22
- FAILS = []
23
-
24
-
25
- def check(name, ok, detail=""):
26
- global PASS, FAIL
27
- if ok:
28
- PASS += 1
29
- print("[PASS] %s%s" % (name, (" · " + detail) if detail else ""))
30
- else:
31
- FAIL += 1
32
- FAILS.append(name)
33
- print("[FAIL] %s · %s" % (name, detail))
34
-
35
-
36
- src = io.open(SRC, encoding="utf-8").read()
37
- tree = ast.parse(src)
38
- fn = None
39
- for n in ast.walk(tree):
40
- if isinstance(n, ast.FunctionDef) and n.name == "search_rrf":
41
- fn = n
42
- break
43
- check("前置:search_rrf 存在", fn is not None, "line %s" % (fn.lineno if fn else "n/a"))
44
-
45
- if fn is not None:
46
- def name_of(c):
47
- f = c.func
48
- if isinstance(f, ast.Attribute):
49
- return f.attr
50
- if isinstance(f, ast.Name):
51
- return f.id
52
- return "?"
53
-
54
- calls = [name_of(c) for c in ast.walk(fn) if isinstance(c, ast.Call)]
55
- WRITE = {"open", "append_jsonl", "write_text", "write_bytes", "dump", "flush",
56
- "fsync", "replace", "rename", "remove", "mkdir", "makedirs"}
57
- w = [c for c in calls if c in WRITE]
58
- check("① 打分层无落盘调用(纯函数面)", not w, "落盘调用: %s" % w)
59
-
60
- TIME = {"time", "now", "today", "monotonic", "perf_counter"}
61
- tl = [c for c in calls if c in TIME]
62
- check("③ 打分层取时钟处数 = 基线 1(新增隐式时钟即红)", len(tl) == 1,
63
- "时钟调用 %d 次: %s" % (len(tl), tl))
64
-
65
- state_sites = []
66
- for n in ast.walk(fn):
67
- if isinstance(n, ast.Dict):
68
- for k, v in zip(n.keys, n.values):
69
- if isinstance(k, ast.Constant) and k.value == "state":
70
- seg = ast.get_source_segment(src, v) or ""
71
- state_sites.append(seg)
72
- check('② "state" 键字面量恰 1 处(基线)', len(state_sites) == 1,
73
- "site=%r" % (state_sites[:2],))
74
- # 该处是占位(None):真正的 state 由后续装配从 judge_qualification 的结果填入。
75
- # 本守卫只钉「打分层不得在此处自造非 None 的 state」。
76
- check("② 该处为占位(None),打分层不自造 state",
77
- bool(state_sites) and state_sites[0] == "None",
78
- "取值源码=%r" % (state_sites[0][:60] if state_sites else ""))
79
-
80
- print()
81
- print("=" * 64)
82
- print("通过 %d / 失败 %d" % (PASS, FAIL))
83
- if FAILS:
84
- for f in FAILS:
85
- print(" - " + f)
86
- print("=" * 64)
1
+ # -*- coding: utf-8 -*-
2
+ r"""test_issue111_scoring_contract · #111 打分层可换**接口契约**的结构守卫(第 10 轮)。
3
+
4
+ 权威件 `docs/mdcg/检索标准算法_RRF3_ChronicleDM_v1.0.md` §三·补二 定了「只换打分层」的契约。
5
+ 本守卫把其中三条可静态判定的条款钉住(不碰行为、不碰算法):
6
+
7
+ ① **纯函数面**:`search_rrf` 内不得有落盘调用(open/append_jsonl/dump/replace/rename/remove/mkdir…);
8
+ ② **state 不自造**:`search_rrf` 内 `"state"` 键字面量恰 1 处,且其取值引用了 `qual`(= judge_qualification 的结果);
9
+ ③ **时钟显式**:`search_rrf` 内取时钟调用数 = 1(基线),新增隐式 `now()/time()` 即红——换算法时时钟必须显式传入。
10
+
11
+ 任何一条转红都意味着「打分层不再可换」,须先改生产代码或先改契约,不得直接调基线数字了事。
12
+ """
13
+ import ast
14
+ import io
15
+ import os
16
+ import sys
17
+
18
+ HERE = os.path.dirname(os.path.abspath(__file__))
19
+ SRC = os.path.join(HERE, "mdcos.py")
20
+ PASS = 0
21
+ FAIL = 0
22
+ FAILS = []
23
+
24
+
25
+ def check(name, ok, detail=""):
26
+ global PASS, FAIL
27
+ if ok:
28
+ PASS += 1
29
+ print("[PASS] %s%s" % (name, (" · " + detail) if detail else ""))
30
+ else:
31
+ FAIL += 1
32
+ FAILS.append(name)
33
+ print("[FAIL] %s · %s" % (name, detail))
34
+
35
+
36
+ src = io.open(SRC, encoding="utf-8").read()
37
+ tree = ast.parse(src)
38
+ fn = None
39
+ for n in ast.walk(tree):
40
+ if isinstance(n, ast.FunctionDef) and n.name == "search_rrf":
41
+ fn = n
42
+ break
43
+ check("前置:search_rrf 存在", fn is not None, "line %s" % (fn.lineno if fn else "n/a"))
44
+
45
+ if fn is not None:
46
+ def name_of(c):
47
+ f = c.func
48
+ if isinstance(f, ast.Attribute):
49
+ return f.attr
50
+ if isinstance(f, ast.Name):
51
+ return f.id
52
+ return "?"
53
+
54
+ calls = [name_of(c) for c in ast.walk(fn) if isinstance(c, ast.Call)]
55
+ WRITE = {"open", "append_jsonl", "write_text", "write_bytes", "dump", "flush",
56
+ "fsync", "replace", "rename", "remove", "mkdir", "makedirs"}
57
+ w = [c for c in calls if c in WRITE]
58
+ check("① 打分层无落盘调用(纯函数面)", not w, "落盘调用: %s" % w)
59
+
60
+ TIME = {"time", "now", "today", "monotonic", "perf_counter"}
61
+ tl = [c for c in calls if c in TIME]
62
+ check("③ 打分层取时钟处数 = 基线 1(新增隐式时钟即红)", len(tl) == 1,
63
+ "时钟调用 %d 次: %s" % (len(tl), tl))
64
+
65
+ state_sites = []
66
+ for n in ast.walk(fn):
67
+ if isinstance(n, ast.Dict):
68
+ for k, v in zip(n.keys, n.values):
69
+ if isinstance(k, ast.Constant) and k.value == "state":
70
+ seg = ast.get_source_segment(src, v) or ""
71
+ state_sites.append(seg)
72
+ check('② "state" 键字面量恰 1 处(基线)', len(state_sites) == 1,
73
+ "site=%r" % (state_sites[:2],))
74
+ # 该处是占位(None):真正的 state 由后续装配从 judge_qualification 的结果填入。
75
+ # 本守卫只钉「打分层不得在此处自造非 None 的 state」。
76
+ check("② 该处为占位(None),打分层不自造 state",
77
+ bool(state_sites) and state_sites[0] == "None",
78
+ "取值源码=%r" % (state_sites[0][:60] if state_sites else ""))
79
+
80
+ print()
81
+ print("=" * 64)
82
+ print("通过 %d / 失败 %d" % (PASS, FAIL))
83
+ if FAILS:
84
+ for f in FAILS:
85
+ print(" - " + f)
86
+ print("=" * 64)
87
87
  sys.exit(0 if FAIL == 0 else 1)