@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,250 +1,250 @@
1
- # -*- coding: utf-8 -*-
2
- """检索 layer 参数的 fail-closed 守卫(issue #275)。
3
-
4
- 【守什么】
5
- #275 报:非法层名与「合法但空」的层**返回逐字节相同** ⇒ 调用方无法区分
6
- 「我传了非法层名」与「那一层确实没有节点」,**不会去查自己的参数**。
7
-
8
- 同一签名的另两个参数是 fail-closed(view / time_axis 都抛 ValueError),
9
- add(layer=) 也有校验(未知层:…(允许:…))—— 只有 search 侧漏接。
10
-
11
- 判据:
12
- L1 非法层名 **报错**(不再是静默空结果)。
13
- L2 报错文案与 add 侧**同口径**(未知层:…(允许:…))——不发明第二套话术。
14
- L3 **反向判据**:合法层的**空结果**行为**不得**改变(防把「真空结果」也报成错误)。
15
- L4 **反向判据**:不传 layer ⇒ **仍须**正常检索。
16
- L5 **反向判据**:假值(None / 空串)一律视为「未指定」,逐位保留原行为。
17
- L6 **同签名一致性**:view / time_axis 的非法值同样报错(本条对照的立足点)。
18
- L7 非法层名**即使查询本可命中**也报错(防「先过滤再看有没有结果」的实现漏网)。
19
- L8 MCP 面 schema 不约束 layer ⇒ 模型可控输入必须靠本校验兜底(实测 schema 无 enum)。
20
-
21
- 运行:python -X utf8 -m md_cg.test_issue275_layer_param
22
- python -X utf8 -m md_cg.test_issue275_layer_param --mutate # 定点变异自证
23
-
24
- 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
25
-
26
- 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
27
- """
28
- from __future__ import annotations
29
-
30
- import io
31
- import os
32
- import sys
33
- import tempfile
34
-
35
- from .mdcos import MdCGOS
36
- from .mdcg import LAYERS
37
-
38
- _HERE = os.path.dirname(os.path.abspath(__file__))
39
- _REPO = os.path.dirname(_HERE)
40
-
41
- _PASS: list = []
42
- _FAIL: list = []
43
-
44
-
45
- def ok(cond, msg, extra=""):
46
- (_PASS if cond else _FAIL).append(msg)
47
- print((" PASS " if cond else " FAIL ") + msg
48
- + ((" -> " + str(extra)) if (extra and not cond) else ""))
49
-
50
-
51
- def _cg(tag):
52
- root = tempfile.mkdtemp(prefix="l275_%s_" % tag)
53
- cg = MdCGOS(root)
54
- cg.add(content="# 一条知识\n\n内容。", layer="knowledge", node_id="k1",
55
- importance=0.5, consistency=False, on_conflict="defer")
56
- return cg
57
-
58
-
59
- def l1():
60
- print("== L1 非法层名报错(不再静默空结果)==")
61
- cg = _cg("l1")
62
- for bad in ("bogus", "knowledg", "Knowledge", "knowledge ", "锚点"):
63
- try:
64
- r = cg.search("知识", layer=bad)
65
- ok(False, "L1 非法层名 %r 应当报错(实际静默返回 %r)" % (bad, r[1]), r)
66
- except ValueError:
67
- ok(True, "L1 非法层名 %r 报 ValueError" % bad)
68
- except Exception as exc: # noqa: BLE001
69
- ok(False, "L1 非法层名 %r 抛了非 ValueError:%r" % (bad, exc), exc)
70
-
71
-
72
- def l2():
73
- print("== L2 报错文案与 add 侧同口径 ==")
74
- cg = _cg("l2")
75
- try:
76
- cg.search("知识", layer="bogus")
77
- ok(False, "L2 未报错,无法比对文案")
78
- return
79
- except ValueError as exc:
80
- msg = str(exc)
81
- try:
82
- cg.add(content="x", layer="bogus", node_id="b1",
83
- consistency=False, on_conflict="defer")
84
- ok(False, "L2 add 侧未报错,无法比对")
85
- return
86
- except ValueError as exc2:
87
- msg2 = str(exc2)
88
- ok(msg == msg2, "L2 search 与 add 报错文案逐字一致", (msg, msg2))
89
- ok("未知层" in msg and "允许" in msg, "L2 文案含「未知层」「允许」", msg)
90
-
91
-
92
- def l3():
93
- print("== L3 反向判据:合法层的空结果行为不变 ==")
94
- cg = _cg("l3")
95
- for lay in LAYERS:
96
- if lay == "knowledge":
97
- continue
98
- r = cg.search("知识", layer=lay)
99
- ok(isinstance(r, tuple) and len(r) == 2 and r[0] == [],
100
- "L3 合法空层 %r 仍返回空结果(不报错)" % lay, r)
101
- ok(r[1].get("reason") == "no_candidates",
102
- "L3 合法空层 %r 的 meta.reason 仍为 no_candidates" % lay, r[1])
103
- r = cg.search("知识", layer="knowledge")
104
- ok(len(r[0]) == 1, "L3 有节点的合法层仍正常返回 1 条", len(r[0]))
105
-
106
-
107
- def l4():
108
- print("== L4 反向判据:不传 layer 仍正常检索 ==")
109
- cg = _cg("l4")
110
- r = cg.search("知识")
111
- ok(len(r[0]) == 1, "L4 不传 layer 命中 1 条", len(r[0]))
112
-
113
-
114
- def l5():
115
- print("== L5 反向判据:假值一律视为「未指定」 ==")
116
- cg = _cg("l5")
117
- for falsy in (None, ""):
118
- r = cg.search("知识", layer=falsy)
119
- ok(len(r[0]) == 1, "L5 layer=%r 视为未指定,仍命中 1 条" % (falsy,), len(r[0]))
120
-
121
-
122
- def l6():
123
- print("== L6 同签名一致性:view / time_axis 同样报错 ==")
124
- cg = _cg("l6")
125
- for kw, name in (({"view": "bogus"}, "view"),
126
- ({"time_axis": "bogus"}, "time_axis")):
127
- try:
128
- cg.search("知识", **kw)
129
- ok(False, "L6 %s 非法值应当报错" % name)
130
- except ValueError:
131
- ok(True, "L6 %s 非法值报 ValueError(与本条同处置)" % name)
132
- except Exception as exc: # noqa: BLE001
133
- ok(False, "L6 %s 抛了非 ValueError:%r" % (name, exc), exc)
134
-
135
-
136
- def l7():
137
- print("== L7 非法层名即使查询本可命中也报错 ==")
138
- cg = _cg("l7")
139
- ok(len(cg.search("知识")[0]) == 1, "L7 前置:该查询在无 layer 时确可命中")
140
- try:
141
- cg.search("知识", layer="knowledg")
142
- ok(False, "L7 拼错层名 + 可命中查询:应当报错(防先过滤后判定)")
143
- except ValueError:
144
- ok(True, "L7 拼错层名 + 可命中查询:报 ValueError")
145
-
146
-
147
- def l8():
148
- print("== L8 MCP 面 schema 不约束 layer ⇒ 靠本校验兜底 ==")
149
- p = os.path.join(_REPO, "md_cg", "mcp_server.py")
150
- with io.open(p, encoding="utf-8", errors="replace") as f:
151
- text = f.read()
152
- i = text.find('"name": "mdcg_search"')
153
- ok(i > 0, "L8 前置:找到 mdcg_search 工具定义", i)
154
- seg = text[i:i + 900]
155
- ok('layer=_p("string", "限定层")' in seg,
156
- "L8 MCP schema 的 layer 无 enum 约束(模型可控输入)", seg[:160])
157
-
158
-
159
- _GROUPS = (l1, l2, l3, l4, l5, l6, l7, l8)
160
-
161
-
162
- def _run_groups() -> int:
163
- _PASS.clear()
164
- _FAIL.clear()
165
- for g in _GROUPS:
166
- try:
167
- g()
168
- except Exception as exc: # noqa: BLE001
169
- ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
170
- import traceback
171
- print(traceback.format_exc()[-800:])
172
- return len(_FAIL)
173
-
174
-
175
- def main() -> int:
176
- n = _run_groups()
177
- print("\nlayer 参数 fail-closed 守卫:%d 通过,%d 失败" % (len(_PASS), n))
178
- return 1 if n else 0
179
-
180
-
181
- # --------------------------------------------------------------- 定点变异自证
182
- # 变异在**源码**上做(本守卫的判据是「真跑 search」),故须写盘 + reload,
183
- # 跑完 finally 复原。锚点漂移即判 BAD(不静默跳过)。
184
- _MUTATIONS = (
185
- ("V1 去掉 layer 校验(退回静默空结果)", "drop_guard"),
186
- ("V2 把校验放宽为「只在命中为空时才报」(先过滤后判定)", "late_guard"),
187
- )
188
-
189
-
190
- def _reload():
191
- import importlib
192
- from . import mdcg as _m
193
- from . import mdcos as _o
194
- importlib.reload(_m)
195
- importlib.reload(_o)
196
- globals()["LAYERS"] = _m.LAYERS
197
- globals()["MdCGOS"] = _o.MdCGOS
198
-
199
-
200
- def _mutate() -> int:
201
- bad = []
202
- src_p = os.path.join(_REPO, "md_cg", "mdcos.py")
203
- for name, kind in _MUTATIONS:
204
- with io.open(src_p, encoding="utf-8", newline="") as f:
205
- orig = f.read()
206
- NL = "\r\n" if "\r\n" in orig else "\n"
207
- try:
208
- if kind == "drop_guard":
209
- anchor = NL.join([
210
- ' if layer and layer not in LAYERS:',
211
- ' raise ValueError(f"未知层:{layer}(允许:{LAYERS})")',
212
- ])
213
- repl = ""
214
- else:
215
- anchor = NL.join([
216
- ' if layer and layer not in LAYERS:',
217
- ' raise ValueError(f"未知层:{layer}(允许:{LAYERS})")',
218
- ])
219
- repl = NL.join([
220
- ' _bad_layer = bool(layer and layer not in LAYERS)',
221
- ])
222
- if anchor not in orig:
223
- print(" ANCHOR-MISS %s" % name)
224
- bad.append(name)
225
- continue
226
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
227
- f.write(orig.replace(anchor, repl))
228
- _reload()
229
- _run_groups()
230
- reds = list(_FAIL)
231
- hit = any("L1" in r for r in reds)
232
- print(" %-4s %-46s 红项=%-3d 命中L1=%s"
233
- % ("OK" if hit else "BAD", name, len(reds), "是" if hit else "否"))
234
- if not hit:
235
- bad.append(name)
236
- finally:
237
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
238
- f.write(orig)
239
- _reload()
240
- if bad:
241
- print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
242
- return 1
243
- print("\n定点变异自证:PASS(每处判据都被打红)")
244
- return 0
245
-
246
-
247
- if __name__ == "__main__":
248
- if "--mutate" in sys.argv:
249
- sys.exit(_mutate())
250
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """检索 layer 参数的 fail-closed 守卫(issue #275)。
3
+
4
+ 【守什么】
5
+ #275 报:非法层名与「合法但空」的层**返回逐字节相同** ⇒ 调用方无法区分
6
+ 「我传了非法层名」与「那一层确实没有节点」,**不会去查自己的参数**。
7
+
8
+ 同一签名的另两个参数是 fail-closed(view / time_axis 都抛 ValueError),
9
+ add(layer=) 也有校验(未知层:…(允许:…))—— 只有 search 侧漏接。
10
+
11
+ 判据:
12
+ L1 非法层名 **报错**(不再是静默空结果)。
13
+ L2 报错文案与 add 侧**同口径**(未知层:…(允许:…))——不发明第二套话术。
14
+ L3 **反向判据**:合法层的**空结果**行为**不得**改变(防把「真空结果」也报成错误)。
15
+ L4 **反向判据**:不传 layer ⇒ **仍须**正常检索。
16
+ L5 **反向判据**:假值(None / 空串)一律视为「未指定」,逐位保留原行为。
17
+ L6 **同签名一致性**:view / time_axis 的非法值同样报错(本条对照的立足点)。
18
+ L7 非法层名**即使查询本可命中**也报错(防「先过滤再看有没有结果」的实现漏网)。
19
+ L8 MCP 面 schema 不约束 layer ⇒ 模型可控输入必须靠本校验兜底(实测 schema 无 enum)。
20
+
21
+ 运行:python -X utf8 -m md_cg.test_issue275_layer_param
22
+ python -X utf8 -m md_cg.test_issue275_layer_param --mutate # 定点变异自证
23
+
24
+ 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
25
+
26
+ 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
27
+ """
28
+ from __future__ import annotations
29
+
30
+ import io
31
+ import os
32
+ import sys
33
+ import tempfile
34
+
35
+ from .mdcos import MdCGOS
36
+ from .mdcg import LAYERS
37
+
38
+ _HERE = os.path.dirname(os.path.abspath(__file__))
39
+ _REPO = os.path.dirname(_HERE)
40
+
41
+ _PASS: list = []
42
+ _FAIL: list = []
43
+
44
+
45
+ def ok(cond, msg, extra=""):
46
+ (_PASS if cond else _FAIL).append(msg)
47
+ print((" PASS " if cond else " FAIL ") + msg
48
+ + ((" -> " + str(extra)) if (extra and not cond) else ""))
49
+
50
+
51
+ def _cg(tag):
52
+ root = tempfile.mkdtemp(prefix="l275_%s_" % tag)
53
+ cg = MdCGOS(root)
54
+ cg.add(content="# 一条知识\n\n内容。", layer="knowledge", node_id="k1",
55
+ importance=0.5, consistency=False, on_conflict="defer")
56
+ return cg
57
+
58
+
59
+ def l1():
60
+ print("== L1 非法层名报错(不再静默空结果)==")
61
+ cg = _cg("l1")
62
+ for bad in ("bogus", "knowledg", "Knowledge", "knowledge ", "锚点"):
63
+ try:
64
+ r = cg.search("知识", layer=bad)
65
+ ok(False, "L1 非法层名 %r 应当报错(实际静默返回 %r)" % (bad, r[1]), r)
66
+ except ValueError:
67
+ ok(True, "L1 非法层名 %r 报 ValueError" % bad)
68
+ except Exception as exc: # noqa: BLE001
69
+ ok(False, "L1 非法层名 %r 抛了非 ValueError:%r" % (bad, exc), exc)
70
+
71
+
72
+ def l2():
73
+ print("== L2 报错文案与 add 侧同口径 ==")
74
+ cg = _cg("l2")
75
+ try:
76
+ cg.search("知识", layer="bogus")
77
+ ok(False, "L2 未报错,无法比对文案")
78
+ return
79
+ except ValueError as exc:
80
+ msg = str(exc)
81
+ try:
82
+ cg.add(content="x", layer="bogus", node_id="b1",
83
+ consistency=False, on_conflict="defer")
84
+ ok(False, "L2 add 侧未报错,无法比对")
85
+ return
86
+ except ValueError as exc2:
87
+ msg2 = str(exc2)
88
+ ok(msg == msg2, "L2 search 与 add 报错文案逐字一致", (msg, msg2))
89
+ ok("未知层" in msg and "允许" in msg, "L2 文案含「未知层」「允许」", msg)
90
+
91
+
92
+ def l3():
93
+ print("== L3 反向判据:合法层的空结果行为不变 ==")
94
+ cg = _cg("l3")
95
+ for lay in LAYERS:
96
+ if lay == "knowledge":
97
+ continue
98
+ r = cg.search("知识", layer=lay)
99
+ ok(isinstance(r, tuple) and len(r) == 2 and r[0] == [],
100
+ "L3 合法空层 %r 仍返回空结果(不报错)" % lay, r)
101
+ ok(r[1].get("reason") == "no_candidates",
102
+ "L3 合法空层 %r 的 meta.reason 仍为 no_candidates" % lay, r[1])
103
+ r = cg.search("知识", layer="knowledge")
104
+ ok(len(r[0]) == 1, "L3 有节点的合法层仍正常返回 1 条", len(r[0]))
105
+
106
+
107
+ def l4():
108
+ print("== L4 反向判据:不传 layer 仍正常检索 ==")
109
+ cg = _cg("l4")
110
+ r = cg.search("知识")
111
+ ok(len(r[0]) == 1, "L4 不传 layer 命中 1 条", len(r[0]))
112
+
113
+
114
+ def l5():
115
+ print("== L5 反向判据:假值一律视为「未指定」 ==")
116
+ cg = _cg("l5")
117
+ for falsy in (None, ""):
118
+ r = cg.search("知识", layer=falsy)
119
+ ok(len(r[0]) == 1, "L5 layer=%r 视为未指定,仍命中 1 条" % (falsy,), len(r[0]))
120
+
121
+
122
+ def l6():
123
+ print("== L6 同签名一致性:view / time_axis 同样报错 ==")
124
+ cg = _cg("l6")
125
+ for kw, name in (({"view": "bogus"}, "view"),
126
+ ({"time_axis": "bogus"}, "time_axis")):
127
+ try:
128
+ cg.search("知识", **kw)
129
+ ok(False, "L6 %s 非法值应当报错" % name)
130
+ except ValueError:
131
+ ok(True, "L6 %s 非法值报 ValueError(与本条同处置)" % name)
132
+ except Exception as exc: # noqa: BLE001
133
+ ok(False, "L6 %s 抛了非 ValueError:%r" % (name, exc), exc)
134
+
135
+
136
+ def l7():
137
+ print("== L7 非法层名即使查询本可命中也报错 ==")
138
+ cg = _cg("l7")
139
+ ok(len(cg.search("知识")[0]) == 1, "L7 前置:该查询在无 layer 时确可命中")
140
+ try:
141
+ cg.search("知识", layer="knowledg")
142
+ ok(False, "L7 拼错层名 + 可命中查询:应当报错(防先过滤后判定)")
143
+ except ValueError:
144
+ ok(True, "L7 拼错层名 + 可命中查询:报 ValueError")
145
+
146
+
147
+ def l8():
148
+ print("== L8 MCP 面 schema 不约束 layer ⇒ 靠本校验兜底 ==")
149
+ p = os.path.join(_REPO, "md_cg", "mcp_server.py")
150
+ with io.open(p, encoding="utf-8", errors="replace") as f:
151
+ text = f.read()
152
+ i = text.find('"name": "mdcg_search"')
153
+ ok(i > 0, "L8 前置:找到 mdcg_search 工具定义", i)
154
+ seg = text[i:i + 900]
155
+ ok('layer=_p("string", "限定层")' in seg,
156
+ "L8 MCP schema 的 layer 无 enum 约束(模型可控输入)", seg[:160])
157
+
158
+
159
+ _GROUPS = (l1, l2, l3, l4, l5, l6, l7, l8)
160
+
161
+
162
+ def _run_groups() -> int:
163
+ _PASS.clear()
164
+ _FAIL.clear()
165
+ for g in _GROUPS:
166
+ try:
167
+ g()
168
+ except Exception as exc: # noqa: BLE001
169
+ ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
170
+ import traceback
171
+ print(traceback.format_exc()[-800:])
172
+ return len(_FAIL)
173
+
174
+
175
+ def main() -> int:
176
+ n = _run_groups()
177
+ print("\nlayer 参数 fail-closed 守卫:%d 通过,%d 失败" % (len(_PASS), n))
178
+ return 1 if n else 0
179
+
180
+
181
+ # --------------------------------------------------------------- 定点变异自证
182
+ # 变异在**源码**上做(本守卫的判据是「真跑 search」),故须写盘 + reload,
183
+ # 跑完 finally 复原。锚点漂移即判 BAD(不静默跳过)。
184
+ _MUTATIONS = (
185
+ ("V1 去掉 layer 校验(退回静默空结果)", "drop_guard"),
186
+ ("V2 把校验放宽为「只在命中为空时才报」(先过滤后判定)", "late_guard"),
187
+ )
188
+
189
+
190
+ def _reload():
191
+ import importlib
192
+ from . import mdcg as _m
193
+ from . import mdcos as _o
194
+ importlib.reload(_m)
195
+ importlib.reload(_o)
196
+ globals()["LAYERS"] = _m.LAYERS
197
+ globals()["MdCGOS"] = _o.MdCGOS
198
+
199
+
200
+ def _mutate() -> int:
201
+ bad = []
202
+ src_p = os.path.join(_REPO, "md_cg", "mdcos.py")
203
+ for name, kind in _MUTATIONS:
204
+ with io.open(src_p, encoding="utf-8", newline="") as f:
205
+ orig = f.read()
206
+ NL = "\r\n" if "\r\n" in orig else "\n"
207
+ try:
208
+ if kind == "drop_guard":
209
+ anchor = NL.join([
210
+ ' if layer and layer not in LAYERS:',
211
+ ' raise ValueError(f"未知层:{layer}(允许:{LAYERS})")',
212
+ ])
213
+ repl = ""
214
+ else:
215
+ anchor = NL.join([
216
+ ' if layer and layer not in LAYERS:',
217
+ ' raise ValueError(f"未知层:{layer}(允许:{LAYERS})")',
218
+ ])
219
+ repl = NL.join([
220
+ ' _bad_layer = bool(layer and layer not in LAYERS)',
221
+ ])
222
+ if anchor not in orig:
223
+ print(" ANCHOR-MISS %s" % name)
224
+ bad.append(name)
225
+ continue
226
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
227
+ f.write(orig.replace(anchor, repl))
228
+ _reload()
229
+ _run_groups()
230
+ reds = list(_FAIL)
231
+ hit = any("L1" in r for r in reds)
232
+ print(" %-4s %-46s 红项=%-3d 命中L1=%s"
233
+ % ("OK" if hit else "BAD", name, len(reds), "是" if hit else "否"))
234
+ if not hit:
235
+ bad.append(name)
236
+ finally:
237
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
238
+ f.write(orig)
239
+ _reload()
240
+ if bad:
241
+ print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
242
+ return 1
243
+ print("\n定点变异自证:PASS(每处判据都被打红)")
244
+ return 0
245
+
246
+
247
+ if __name__ == "__main__":
248
+ if "--mutate" in sys.argv:
249
+ sys.exit(_mutate())
250
+ sys.exit(main())