@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,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())