@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,247 +1,247 @@
1
- # -*- coding: utf-8 -*-
2
- # 功能名:#358① 近重复比对的 MAX_COMPARE 截断必须可观测(candidate_total/truncated)
3
- # 生效条件:python -u -X utf8 -m md_cg.test_issue358_truncation_observable [--mutate]
4
- # 子功能:A1 超限落键(真值)· A2 未超限不落键(旧报文零变化)· A3 assess 透出
5
- # · A4 candidate_total 只计同层 · A5 exclude 不计入候选 · A6 边界
6
- # · A7 limit<=0 既有语义保留;E1 源码锚点自检
7
- # 执行:直接跑;--mutate 时对 forgetting.py 做 4 条定点变异并要求指定红项非空
8
- # 验证方式:断言全过 + 退出码 0;--mutate 下每条变异的红项集合必须非空且含指定项
9
- # 不适用条件:① 不测「漏比本身是否被消除」——本件只钉**可观测**(修法明确不改
10
- # limit/比对顺序/裁决,见 #358 处置口径);② 不测真实库性能(240 次读盘成本属
11
- # N276 性能面,另守卫);③ 不覆盖 scrub/writepipe 的调用点读数形状。
12
- """#358① 守卫:截断可观测。"""
13
- import argparse
14
- import importlib.util
15
- import os
16
- import sys
17
- import tempfile
18
-
19
- sys.stdout.reconfigure(encoding='utf-8', errors='replace')
20
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
21
- if _REPO not in sys.path:
22
- sys.path.insert(0, _REPO)
23
-
24
- PASSED, FAILS = [], []
25
-
26
- _TARGET = ("# 功能名:末位目标\n# 生效条件:条件末位\n# 子功能:子功能末位\n"
27
- "# 执行:执行末位\n# 验证方式:test\n# 不适用条件:无\n\n"
28
- "末位目标节点唯一正文:蓝色按钮控制字符右移三格。")
29
-
30
-
31
- def _fill(i):
32
- return ("# 功能名:填充%04d\n# 生效条件:条件%04d\n# 子功能:子功能%04d\n"
33
- "# 执行:执行%04d\n# 验证方式:test\n# 不适用条件:无\n\n"
34
- "填充节点%04d号正文:完全无关的内容%s。" % (i, i, i, i, i, "甲乙丙" * (i % 7 + 1)))
35
-
36
-
37
- def _stub(n, dup_last=True, other_layer=0):
38
- """n 个同层候选(末位正文 = _TARGET)+ other_layer 个异层同文节点。"""
39
- contents = {"n%04d" % i: _fill(i) for i in range(n)}
40
- if dup_last and n:
41
- contents["n%04d" % (n - 1)] = _TARGET
42
- for j in range(other_layer):
43
- contents["o%04d" % j] = _TARGET
44
-
45
- class _Stub:
46
- def __init__(self):
47
- nodes = {"n%04d" % i: {"layer": "contextual"} for i in range(n)}
48
- for j in range(other_layer):
49
- nodes["o%04d" % j] = {"layer": "knowledge"}
50
- self.index = {"nodes": nodes}
51
-
52
- def get(self, nid, probe=True):
53
- return {"id": nid, "content": contents.get(nid, ""),
54
- "frontmatter": {}}
55
-
56
- return _Stub()
57
-
58
-
59
- def _suite(mod=None, label=''):
60
- """返回本次 (passed, failed) 局部列表;不污染模块级聚合。"""
61
- if label:
62
- print('-- %s --' % label)
63
- if mod is None:
64
- from md_cg import forgetting as mod
65
- red = mod.redundancy
66
- passed, failed = [], []
67
-
68
- def check(name, cond, detail=''):
69
- if cond:
70
- print(' PASS ' + name)
71
- passed.append(name)
72
- else:
73
- print(' FAIL ' + name + ' ' + str(detail)[:170])
74
- failed.append(name)
75
- return bool(cond)
76
-
77
- # A1:超限(301 候选 > 240)——两键必须落,且 candidate_total 是真值
78
- r1 = red(_stub(301), _TARGET, layer="contextual")
79
- check("A1a 超限:truncated=True", r1.get("truncated") is True, r1)
80
- check("A1b 超限:candidate_total=301(真值,不是 compared)",
81
- r1.get("candidate_total") == 301, r1)
82
- check("A1c 超限:compared=240(旧读数保留)", r1.get("compared") == 240, r1)
83
- check("A1d 超限:末位命中不在前 240 ⇒ with 不为末位(截断语义未改变)",
84
- r1.get("with") != "n0300", r1)
85
-
86
- # A2:未超限(5 候选)——不落两键,返回体与改动前逐位一致
87
- r2 = red(_stub(5), _TARGET, layer="contextual")
88
- check("A2a 未超限:无 truncated 键", "truncated" not in r2, r2)
89
- check("A2b 未超限:无 candidate_total 键", "candidate_total" not in r2, r2)
90
- check("A2c 未超限:compared=5 且命中末位", r2.get("compared") == 5
91
- and r2.get("with") == "n0004", r2)
92
-
93
- # A3:assess 的 entropy 透出 + reason 带截断提示
94
- a3 = mod.assess(_stub(301), _TARGET, layer="contextual", role="command",
95
- importance_hint=0.1)
96
- ent = a3.get("entropy") or {}
97
- check("A3a assess.entropy.truncated=True(裁决读数可见)",
98
- ent.get("truncated") is True, ent)
99
- check("A3b assess.entropy.candidate_total=301",
100
- ent.get("candidate_total") == 301, ent)
101
- check("A3c assess.reason 带 truncated 提示(审计面可见)",
102
- "truncated" in str(a3.get("reason") or ""), a3.get("reason"))
103
- a3s = mod.assess(_stub(5), _TARGET, layer="contextual", role="command",
104
- importance_hint=0.1)
105
- check("A3d 未截断时 entropy 不新增键(旧读数零变化)",
106
- "truncated" not in (a3s.get("entropy") or {})
107
- and "candidate_total" not in (a3s.get("entropy") or {}),
108
- a3s.get("entropy"))
109
-
110
- # A4:candidate_total 只数同层(异层 50 个同文节点不计)
111
- r4 = red(_stub(301, other_layer=50), _TARGET, layer="contextual")
112
- check("A4 candidate_total 只计同层候选(301,不是 351)",
113
- r4.get("candidate_total") == 301, r4)
114
-
115
- # A5:exclude 不计入候选
116
- r5 = red(_stub(301), _TARGET, layer="contextual", exclude="n0000")
117
- check("A5 exclude 后 candidate_total=300", r5.get("candidate_total") == 300, r5)
118
-
119
- # A6:边界——恰好 limit 个候选不报截断;多一个才报
120
- r6a = red(_stub(mod.MAX_COMPARE), _TARGET, layer="contextual")
121
- r6b = red(_stub(mod.MAX_COMPARE + 1), _TARGET, layer="contextual")
122
- check("A6a 候选数==limit:不报截断", "truncated" not in r6a, r6a)
123
- check("A6b 候选数==limit+1:报截断且 candidate_total=limit+1",
124
- r6b.get("truncated") is True
125
- and r6b.get("candidate_total") == mod.MAX_COMPARE + 1, r6b)
126
-
127
- # A7:limit<=0 的既有语义(只比首项即停)保留,且截断仍可观测
128
- r7 = red(_stub(301), _TARGET, layer="contextual", limit=0)
129
- check("A7 limit=0:compared=1(既有语义)且 truncated=True/candidate_total=301",
130
- r7.get("compared") == 1 and r7.get("truncated") is True
131
- and r7.get("candidate_total") == 301, r7)
132
- return passed, failed
133
-
134
-
135
- def _mutations():
136
- src = open(os.path.join(_REPO, 'md_cg', 'forgetting.py'), encoding='utf-8').read()
137
- anchors = (
138
- ('M1 删截断落键块(回退为静默截断)',
139
- ' if scanned < candidate_total:\n'
140
- ' best["candidate_total"] = candidate_total\n'
141
- ' best["truncated"] = True\n',
142
- ''),
143
- ('M2 truncated 恒真(过度报告)',
144
- ' if scanned < candidate_total:',
145
- ' if True:'),
146
- ('M3 candidate_total 用 compared 冒充',
147
- ' best["candidate_total"] = candidate_total',
148
- ' best["candidate_total"] = n'),
149
- ('M4 assess 不透出截断读数',
150
- ' if red.get("truncated"):\n'
151
- ' entropy["candidate_total"] = red.get("candidate_total")\n'
152
- ' entropy["truncated"] = True',
153
- ' if False:\n'
154
- ' entropy["candidate_total"] = red.get("candidate_total")\n'
155
- ' entropy["truncated"] = True'),
156
- )
157
- out = []
158
- for tag, old, new in anchors:
159
- n = src.count(old)
160
- if n != 1:
161
- print(' [FAIL] 变异锚点「%s」命中 %d 次(应为 1)' % (tag, n))
162
- FAILS.append('变异锚点 ' + tag)
163
- continue
164
- out.append((tag, src.replace(old, new)))
165
- return out
166
-
167
-
168
- def _load_mutant(text, tag):
169
- path = os.path.join(tempfile.mkdtemp(prefix='i358mut_'),
170
- 'forgetting_%s.py' % tag)
171
- open(path, 'w', encoding='utf-8').write(text)
172
- name = 'md_cg.forgetting_mut_%s' % tag
173
- spec = importlib.util.spec_from_file_location(name, path)
174
- m = importlib.util.module_from_spec(spec)
175
- sys.modules[name] = m
176
- spec.loader.exec_module(m)
177
- return m
178
-
179
-
180
- def _run_mutations():
181
- print('== 变异腿 ==')
182
- reds = {}
183
- expect = {
184
- 'M1 删截断落键块(回退为静默截断)': 'A1a 超限:truncated=True',
185
- 'M2 truncated 恒真(过度报告)': 'A2a 未超限:无 truncated 键',
186
- 'M3 candidate_total 用 compared 冒充': 'A1b 超限:candidate_total=301(真值,不是 compared)',
187
- 'M4 assess 不透出截断读数': 'A3a assess.entropy.truncated=True(裁决读数可见)',
188
- }
189
- for i, (tag, text) in enumerate(_mutations()):
190
- mod = _load_mutant(text, 'm%d' % i)
191
- _, fail = _suite(mod, label=tag)
192
- reds[tag] = sorted(fail)
193
- print(' %s ⇒ 红项 %s' % (tag, reds[tag]))
194
- if not fail:
195
- FAILS.append('变异未转红:' + tag)
196
- elif expect.get(tag) and expect[tag] not in fail:
197
- FAILS.append('变异红项不含指定项:' + tag)
198
- print(' 变异红项集合:%s' % reds)
199
- return reds
200
-
201
-
202
- def _anchor_selfcheck():
203
- src = open(os.path.join(_REPO, 'md_cg', 'forgetting.py'),
204
- encoding='utf-8').read()
205
- need = ('candidate_total', 'truncated', 'if scanned < candidate_total:',
206
- 'entropy["truncated"] = True')
207
- miss = [x for x in need if x not in src]
208
- if miss:
209
- print(' ANCHOR-MISS 修复关键字面不在源码里:%s' % miss)
210
- return 2
211
- print(' PASS E1 源码锚点在位(candidate_total/truncated/条件落键/entropy 透出)')
212
- PASSED.append('E1 源码锚点在位')
213
- return 0
214
-
215
-
216
- def main():
217
- ap = argparse.ArgumentParser(description='#358① 截断可观测守卫')
218
- ap.add_argument('--mutate', action='store_true', help='定点变异自证')
219
- args = ap.parse_args()
220
- print('== #358① 守卫 ==')
221
- rc = _anchor_selfcheck()
222
- if rc == 2:
223
- return 2
224
- try:
225
- ps, fs = _suite()
226
- PASSED.extend(ps)
227
- FAILS.extend(fs)
228
- except Exception as e:
229
- import traceback
230
- traceback.print_exc()
231
- FAILS.append('全套判据内异常(fail-closed)')
232
- if args.mutate:
233
- try:
234
- _run_mutations()
235
- except Exception as e:
236
- import traceback
237
- traceback.print_exc()
238
- FAILS.append('变异腿内异常(fail-closed)')
239
- print('=' * 60)
240
- print('#358① 守卫:%d 通过,%d 失败' % (len(PASSED), len(FAILS)))
241
- for f in FAILS:
242
- print(' 红项:' + f)
243
- return 1 if FAILS else 0
244
-
245
-
246
- if __name__ == '__main__':
247
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:#358① 近重复比对的 MAX_COMPARE 截断必须可观测(candidate_total/truncated)
3
+ # 生效条件:python -u -X utf8 -m md_cg.test_issue358_truncation_observable [--mutate]
4
+ # 子功能:A1 超限落键(真值)· A2 未超限不落键(旧报文零变化)· A3 assess 透出
5
+ # · A4 candidate_total 只计同层 · A5 exclude 不计入候选 · A6 边界
6
+ # · A7 limit<=0 既有语义保留;E1 源码锚点自检
7
+ # 执行:直接跑;--mutate 时对 forgetting.py 做 4 条定点变异并要求指定红项非空
8
+ # 验证方式:断言全过 + 退出码 0;--mutate 下每条变异的红项集合必须非空且含指定项
9
+ # 不适用条件:① 不测「漏比本身是否被消除」——本件只钉**可观测**(修法明确不改
10
+ # limit/比对顺序/裁决,见 #358 处置口径);② 不测真实库性能(240 次读盘成本属
11
+ # N276 性能面,另守卫);③ 不覆盖 scrub/writepipe 的调用点读数形状。
12
+ """#358① 守卫:截断可观测。"""
13
+ import argparse
14
+ import importlib.util
15
+ import os
16
+ import sys
17
+ import tempfile
18
+
19
+ sys.stdout.reconfigure(encoding='utf-8', errors='replace')
20
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
21
+ if _REPO not in sys.path:
22
+ sys.path.insert(0, _REPO)
23
+
24
+ PASSED, FAILS = [], []
25
+
26
+ _TARGET = ("# 功能名:末位目标\n# 生效条件:条件末位\n# 子功能:子功能末位\n"
27
+ "# 执行:执行末位\n# 验证方式:test\n# 不适用条件:无\n\n"
28
+ "末位目标节点唯一正文:蓝色按钮控制字符右移三格。")
29
+
30
+
31
+ def _fill(i):
32
+ return ("# 功能名:填充%04d\n# 生效条件:条件%04d\n# 子功能:子功能%04d\n"
33
+ "# 执行:执行%04d\n# 验证方式:test\n# 不适用条件:无\n\n"
34
+ "填充节点%04d号正文:完全无关的内容%s。" % (i, i, i, i, i, "甲乙丙" * (i % 7 + 1)))
35
+
36
+
37
+ def _stub(n, dup_last=True, other_layer=0):
38
+ """n 个同层候选(末位正文 = _TARGET)+ other_layer 个异层同文节点。"""
39
+ contents = {"n%04d" % i: _fill(i) for i in range(n)}
40
+ if dup_last and n:
41
+ contents["n%04d" % (n - 1)] = _TARGET
42
+ for j in range(other_layer):
43
+ contents["o%04d" % j] = _TARGET
44
+
45
+ class _Stub:
46
+ def __init__(self):
47
+ nodes = {"n%04d" % i: {"layer": "contextual"} for i in range(n)}
48
+ for j in range(other_layer):
49
+ nodes["o%04d" % j] = {"layer": "knowledge"}
50
+ self.index = {"nodes": nodes}
51
+
52
+ def get(self, nid, probe=True):
53
+ return {"id": nid, "content": contents.get(nid, ""),
54
+ "frontmatter": {}}
55
+
56
+ return _Stub()
57
+
58
+
59
+ def _suite(mod=None, label=''):
60
+ """返回本次 (passed, failed) 局部列表;不污染模块级聚合。"""
61
+ if label:
62
+ print('-- %s --' % label)
63
+ if mod is None:
64
+ from md_cg import forgetting as mod
65
+ red = mod.redundancy
66
+ passed, failed = [], []
67
+
68
+ def check(name, cond, detail=''):
69
+ if cond:
70
+ print(' PASS ' + name)
71
+ passed.append(name)
72
+ else:
73
+ print(' FAIL ' + name + ' ' + str(detail)[:170])
74
+ failed.append(name)
75
+ return bool(cond)
76
+
77
+ # A1:超限(301 候选 > 240)——两键必须落,且 candidate_total 是真值
78
+ r1 = red(_stub(301), _TARGET, layer="contextual")
79
+ check("A1a 超限:truncated=True", r1.get("truncated") is True, r1)
80
+ check("A1b 超限:candidate_total=301(真值,不是 compared)",
81
+ r1.get("candidate_total") == 301, r1)
82
+ check("A1c 超限:compared=240(旧读数保留)", r1.get("compared") == 240, r1)
83
+ check("A1d 超限:末位命中不在前 240 ⇒ with 不为末位(截断语义未改变)",
84
+ r1.get("with") != "n0300", r1)
85
+
86
+ # A2:未超限(5 候选)——不落两键,返回体与改动前逐位一致
87
+ r2 = red(_stub(5), _TARGET, layer="contextual")
88
+ check("A2a 未超限:无 truncated 键", "truncated" not in r2, r2)
89
+ check("A2b 未超限:无 candidate_total 键", "candidate_total" not in r2, r2)
90
+ check("A2c 未超限:compared=5 且命中末位", r2.get("compared") == 5
91
+ and r2.get("with") == "n0004", r2)
92
+
93
+ # A3:assess 的 entropy 透出 + reason 带截断提示
94
+ a3 = mod.assess(_stub(301), _TARGET, layer="contextual", role="command",
95
+ importance_hint=0.1)
96
+ ent = a3.get("entropy") or {}
97
+ check("A3a assess.entropy.truncated=True(裁决读数可见)",
98
+ ent.get("truncated") is True, ent)
99
+ check("A3b assess.entropy.candidate_total=301",
100
+ ent.get("candidate_total") == 301, ent)
101
+ check("A3c assess.reason 带 truncated 提示(审计面可见)",
102
+ "truncated" in str(a3.get("reason") or ""), a3.get("reason"))
103
+ a3s = mod.assess(_stub(5), _TARGET, layer="contextual", role="command",
104
+ importance_hint=0.1)
105
+ check("A3d 未截断时 entropy 不新增键(旧读数零变化)",
106
+ "truncated" not in (a3s.get("entropy") or {})
107
+ and "candidate_total" not in (a3s.get("entropy") or {}),
108
+ a3s.get("entropy"))
109
+
110
+ # A4:candidate_total 只数同层(异层 50 个同文节点不计)
111
+ r4 = red(_stub(301, other_layer=50), _TARGET, layer="contextual")
112
+ check("A4 candidate_total 只计同层候选(301,不是 351)",
113
+ r4.get("candidate_total") == 301, r4)
114
+
115
+ # A5:exclude 不计入候选
116
+ r5 = red(_stub(301), _TARGET, layer="contextual", exclude="n0000")
117
+ check("A5 exclude 后 candidate_total=300", r5.get("candidate_total") == 300, r5)
118
+
119
+ # A6:边界——恰好 limit 个候选不报截断;多一个才报
120
+ r6a = red(_stub(mod.MAX_COMPARE), _TARGET, layer="contextual")
121
+ r6b = red(_stub(mod.MAX_COMPARE + 1), _TARGET, layer="contextual")
122
+ check("A6a 候选数==limit:不报截断", "truncated" not in r6a, r6a)
123
+ check("A6b 候选数==limit+1:报截断且 candidate_total=limit+1",
124
+ r6b.get("truncated") is True
125
+ and r6b.get("candidate_total") == mod.MAX_COMPARE + 1, r6b)
126
+
127
+ # A7:limit<=0 的既有语义(只比首项即停)保留,且截断仍可观测
128
+ r7 = red(_stub(301), _TARGET, layer="contextual", limit=0)
129
+ check("A7 limit=0:compared=1(既有语义)且 truncated=True/candidate_total=301",
130
+ r7.get("compared") == 1 and r7.get("truncated") is True
131
+ and r7.get("candidate_total") == 301, r7)
132
+ return passed, failed
133
+
134
+
135
+ def _mutations():
136
+ src = open(os.path.join(_REPO, 'md_cg', 'forgetting.py'), encoding='utf-8').read()
137
+ anchors = (
138
+ ('M1 删截断落键块(回退为静默截断)',
139
+ ' if scanned < candidate_total:\n'
140
+ ' best["candidate_total"] = candidate_total\n'
141
+ ' best["truncated"] = True\n',
142
+ ''),
143
+ ('M2 truncated 恒真(过度报告)',
144
+ ' if scanned < candidate_total:',
145
+ ' if True:'),
146
+ ('M3 candidate_total 用 compared 冒充',
147
+ ' best["candidate_total"] = candidate_total',
148
+ ' best["candidate_total"] = n'),
149
+ ('M4 assess 不透出截断读数',
150
+ ' if red.get("truncated"):\n'
151
+ ' entropy["candidate_total"] = red.get("candidate_total")\n'
152
+ ' entropy["truncated"] = True',
153
+ ' if False:\n'
154
+ ' entropy["candidate_total"] = red.get("candidate_total")\n'
155
+ ' entropy["truncated"] = True'),
156
+ )
157
+ out = []
158
+ for tag, old, new in anchors:
159
+ n = src.count(old)
160
+ if n != 1:
161
+ print(' [FAIL] 变异锚点「%s」命中 %d 次(应为 1)' % (tag, n))
162
+ FAILS.append('变异锚点 ' + tag)
163
+ continue
164
+ out.append((tag, src.replace(old, new)))
165
+ return out
166
+
167
+
168
+ def _load_mutant(text, tag):
169
+ path = os.path.join(tempfile.mkdtemp(prefix='i358mut_'),
170
+ 'forgetting_%s.py' % tag)
171
+ open(path, 'w', encoding='utf-8').write(text)
172
+ name = 'md_cg.forgetting_mut_%s' % tag
173
+ spec = importlib.util.spec_from_file_location(name, path)
174
+ m = importlib.util.module_from_spec(spec)
175
+ sys.modules[name] = m
176
+ spec.loader.exec_module(m)
177
+ return m
178
+
179
+
180
+ def _run_mutations():
181
+ print('== 变异腿 ==')
182
+ reds = {}
183
+ expect = {
184
+ 'M1 删截断落键块(回退为静默截断)': 'A1a 超限:truncated=True',
185
+ 'M2 truncated 恒真(过度报告)': 'A2a 未超限:无 truncated 键',
186
+ 'M3 candidate_total 用 compared 冒充': 'A1b 超限:candidate_total=301(真值,不是 compared)',
187
+ 'M4 assess 不透出截断读数': 'A3a assess.entropy.truncated=True(裁决读数可见)',
188
+ }
189
+ for i, (tag, text) in enumerate(_mutations()):
190
+ mod = _load_mutant(text, 'm%d' % i)
191
+ _, fail = _suite(mod, label=tag)
192
+ reds[tag] = sorted(fail)
193
+ print(' %s ⇒ 红项 %s' % (tag, reds[tag]))
194
+ if not fail:
195
+ FAILS.append('变异未转红:' + tag)
196
+ elif expect.get(tag) and expect[tag] not in fail:
197
+ FAILS.append('变异红项不含指定项:' + tag)
198
+ print(' 变异红项集合:%s' % reds)
199
+ return reds
200
+
201
+
202
+ def _anchor_selfcheck():
203
+ src = open(os.path.join(_REPO, 'md_cg', 'forgetting.py'),
204
+ encoding='utf-8').read()
205
+ need = ('candidate_total', 'truncated', 'if scanned < candidate_total:',
206
+ 'entropy["truncated"] = True')
207
+ miss = [x for x in need if x not in src]
208
+ if miss:
209
+ print(' ANCHOR-MISS 修复关键字面不在源码里:%s' % miss)
210
+ return 2
211
+ print(' PASS E1 源码锚点在位(candidate_total/truncated/条件落键/entropy 透出)')
212
+ PASSED.append('E1 源码锚点在位')
213
+ return 0
214
+
215
+
216
+ def main():
217
+ ap = argparse.ArgumentParser(description='#358① 截断可观测守卫')
218
+ ap.add_argument('--mutate', action='store_true', help='定点变异自证')
219
+ args = ap.parse_args()
220
+ print('== #358① 守卫 ==')
221
+ rc = _anchor_selfcheck()
222
+ if rc == 2:
223
+ return 2
224
+ try:
225
+ ps, fs = _suite()
226
+ PASSED.extend(ps)
227
+ FAILS.extend(fs)
228
+ except Exception as e:
229
+ import traceback
230
+ traceback.print_exc()
231
+ FAILS.append('全套判据内异常(fail-closed)')
232
+ if args.mutate:
233
+ try:
234
+ _run_mutations()
235
+ except Exception as e:
236
+ import traceback
237
+ traceback.print_exc()
238
+ FAILS.append('变异腿内异常(fail-closed)')
239
+ print('=' * 60)
240
+ print('#358① 守卫:%d 通过,%d 失败' % (len(PASSED), len(FAILS)))
241
+ for f in FAILS:
242
+ print(' 红项:' + f)
243
+ return 1 if FAILS else 0
244
+
245
+
246
+ if __name__ == '__main__':
247
+ sys.exit(main())