@furongjun1999/dsh-memory 0.9.8 → 0.9.9

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 (56) hide show
  1. package/README.md +1 -1
  2. package/codebuddy/CODEBUDDY.md +4 -0
  3. package/docs/README.md +3 -0
  4. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +4 -0
  5. package/dsh/cordis.yml.example +2 -2
  6. package/lib/hooks.d.ts +11 -1
  7. package/lib/hooks.js +58 -3
  8. package/lib/index.d.ts +1 -1
  9. package/lib/index.js +2 -2
  10. package/lib/init.js +11 -2
  11. package/lib/lib/hook_audit.d.ts +3 -0
  12. package/lib/lib/hook_audit.js +37 -0
  13. package/md_cg/autonomy.py +1 -1
  14. package/md_cg/config_registry.py +329 -329
  15. package/md_cg/config_registry_bulk.py +483 -482
  16. package/md_cg/config_render.py +27 -0
  17. package/md_cg/config_validate.py +456 -455
  18. package/md_cg/conflict_surface.py +127 -0
  19. package/md_cg/mcp_server.py +5324 -5227
  20. package/md_cg/mdcg.py +12 -1
  21. package/md_cg/mdcos.py +7159 -7108
  22. package/md_cg/pooling.py +487 -485
  23. package/md_cg/qmd_llm.py +334 -334
  24. package/md_cg/reach.py +10 -4
  25. package/md_cg/sleep.py +2 -2
  26. package/md_cg/sustain.py +3 -3
  27. package/md_cg/test_auto_defaults.py +463 -463
  28. package/md_cg/test_autonomy_emotion.py +328 -328
  29. package/md_cg/test_bm25_default.py +56 -0
  30. package/md_cg/test_c3_transient_read_negative.py +7 -3
  31. package/md_cg/test_conflict_surface.py +75 -0
  32. package/md_cg/test_conflict_value_untrusted.py +63 -0
  33. package/md_cg/test_exact_text_cache.py +194 -191
  34. package/md_cg/test_hotcache_tool.py +121 -0
  35. package/md_cg/test_issue274_read_node_id_none.py +364 -341
  36. package/md_cg/test_issue561_pending_review.py +89 -5
  37. package/md_cg/test_issue578_service_info_gate.py +264 -0
  38. package/md_cg/test_p3_legacy_closure.py +441 -438
  39. package/md_cg/test_p43_pooling.py +419 -412
  40. package/md_cg/test_reach.py +5 -1
  41. package/md_cg/test_reach_exits.py +54 -0
  42. package/md_cg/test_reach_single_char.py +74 -0
  43. package/md_cg/test_search_bm25_default.py +60 -0
  44. package/md_cg/test_sleep_p1.py +1032 -1032
  45. package/md_cg/test_untrusted_audit.py +55 -0
  46. package/md_cg/test_untrusted_classifier.py +42 -0
  47. package/md_cg/test_untrusted_enforcement.py +66 -0
  48. package/md_cg/untrusted.py +45 -0
  49. package/md_cg/untrusted_audit.py +87 -0
  50. package/md_cg/value_conflict.py +71 -0
  51. package/package.json +7 -7
  52. package/src/hooks.ts +59 -5
  53. package/src/index.ts +2 -2
  54. package/src/init.ts +7 -2
  55. package/src/lib/hook_audit.ts +32 -0
  56. package/zcode/AGENTS.md +4 -0
@@ -1,341 +1,364 @@
1
- # -*- coding: utf-8 -*-
2
- """读面 node_id「两种显式」处置不对称的守卫(issue #274)。
3
-
4
- 【本守卫守什么】
5
- #274 报:cg(op=read) 的 node_id=None **静默降级为检索**(返回检索结果包),
6
- 而 node_id=123 正确报 node_id_not_str —— 同一个「类型错」两种相反待遇。
7
-
8
- 复核结论:**读数全部成立,但处置不对称是刻意的,不是疏漏。**
9
- · 显式 "" 是**显式** —— 旧写法会把它当没传而静默转检索,故它必须落进类型闸,
10
- 走「节点不存在」的 null。
11
- · 显式 None 是**未传** —— MCP 客户端把「没有 id」序列化成 null 是常规形态,
12
- 故它落到检索分支;由 test_read_face_input_gates 的 M2-B8 / M2-B9 钉住
13
- (M2-B9 断言名即「node_id=None 仍是「未传」,走检索(不回归)」)。
14
-
15
- ⇒ 本件的**实际缺陷是文档缺口**:源码只写了 "" 的动机、没写 None 的动机,
16
- 于是外部复审把它读成了疏漏。修法是**补文档**(+ 本守卫钉住该不对称),
17
- **不是**改行为——改行为会打红 M2-B9,属 issue #274 的 R1(行为变更)。
18
-
19
- 判据:
20
- N1 node_id=None ⇒ 走检索(**刻意**;与「不传」同处置)。
21
- N2 node_id=123 ⇒ node_id_not_str(类型错,对照)。
22
- N3 node_id="" ⇒ null(显式空串**是**显式,不转检索)。
23
- N4 不传 node_id ⇒ 走检索。
24
- N5 node_id=None 与「不传」**逐字节相同** —— 把报告读到的这一事实**钉成契约**,
25
- 以免将来有人"顺手修"成报错而不自知(要改须连带改 M2-B9 与协议表)。
26
- N6 错误里 got_type 如实(不吞类型)。
27
- N7 **跨面**:audit 面对 node_id=None 报 node_id_not_str —— 两面口径不同,
28
- 本守卫**如实记录**该差异(不是要求一致;audit 无检索分支可落)。
29
- N8 **真 MCP stdio**:JSON null ⇒ 检索包;123 ⇒ 类型错(真通路同形)。
30
- N9 **反陈化(本件修复的实质)**:源码注释必须写明 None 的动机。
31
- 只写 "" 的动机 ⇒ 红——因为那正是本件被误读成疏漏的根因。
32
- N10 交叉引用:钉住该行为的 M2-B8 / M2-B9 两条断言仍存在(若被删,本守卫须知道)。
33
-
34
- 运行:python -X utf8 -m md_cg.test_issue274_read_node_id_none
35
- python -X utf8 -m md_cg.test_issue274_read_node_id_none --mutate
36
-
37
- 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
38
-
39
- 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
40
- """
41
- from __future__ import annotations
42
-
43
- import io
44
- import json
45
- import os
46
- import subprocess
47
- import sys
48
- import tempfile
49
-
50
- from .mdcos import MdCGOS
51
- from . import mcp_server as MS
52
-
53
- _HERE = os.path.dirname(os.path.abspath(__file__))
54
- _REPO = os.path.dirname(_HERE)
55
-
56
- _PASS: list = []
57
- _FAIL: list = []
58
-
59
-
60
- def ok(cond, msg, extra=""):
61
- (_PASS if cond else _FAIL).append(msg)
62
- print((" PASS " if cond else " FAIL ") + msg
63
- + ((" -> " + str(extra)) if (extra and not cond) else ""))
64
-
65
-
66
- def _cg(tag):
67
- root = tempfile.mkdtemp(prefix="n274_%s_" % tag)
68
- cg = MdCGOS(root)
69
- cg.add(content="# alpha 知识\n\nalpha 内容。", layer="knowledge", node_id="n1",
70
- importance=0.5, consistency=False, on_conflict="defer")
71
- return cg
72
-
73
-
74
- def _call(cg, a):
75
- try:
76
- return MS._cg_call(cg, a)
77
- except Exception as exc: # noqa: BLE001
78
- return {"__exc__": type(exc).__name__, "msg": str(exc)[:90]}
79
-
80
-
81
- def _is_search_pack(o) -> bool:
82
- return isinstance(o, dict) and ("results" in o or "meta" in o or "pack" in o)
83
-
84
-
85
- def _is_type_error(o) -> bool:
86
- return isinstance(o, dict) and o.get("error") == "node_id_not_str"
87
-
88
-
89
- def n1():
90
- print("== N1 node_id=None 走检索(刻意行为)==")
91
- cg = _cg("n1")
92
- o = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
93
- ok(_is_search_pack(o), "N1 node_id=None + query ⇒ 检索结果包(刻意)",
94
- json.dumps(o, ensure_ascii=False)[:150])
95
- o2 = _call(cg, {"op": "read", "node_id": None})
96
- ok("__exc__" not in (o2 or {}), "N1b node_id=None 无 query 不抛异常",
97
- json.dumps(o2, ensure_ascii=False)[:150])
98
-
99
-
100
- def n2():
101
- print("== N2 node_id=123 报类型错(对照)==")
102
- cg = _cg("n2")
103
- o = _call(cg, {"op": "read", "node_id": 123, "query": "alpha"})
104
- ok(_is_type_error(o), "N2 node_id=123 ⇒ node_id_not_str",
105
- json.dumps(o, ensure_ascii=False)[:150])
106
-
107
-
108
- def n3():
109
- print("== N3 node_id='' 是显式 ⇒ null(不转检索)==")
110
- cg = _cg("n3")
111
- o = _call(cg, {"op": "read", "node_id": "", "query": "alpha"})
112
- ok(not _is_search_pack(o), "N3a node_id='' 不返回检索包", repr(o)[:150])
113
- ok(o is None, "N3b node_id='' ⇒ null(协议登记的 node_missing 形态)", repr(o)[:120])
114
-
115
-
116
- def n4():
117
- print("== N4 不传 node_id 走检索 ==")
118
- cg = _cg("n4")
119
- o = _call(cg, {"op": "read", "query": "alpha"})
120
- ok(_is_search_pack(o), "N4a 不传 node_id + query ⇒ 检索结果包")
121
- ok(not _is_type_error(o), "N4b 不传 node_id 不报类型错")
122
-
123
-
124
- def n5():
125
- print("== N5 node_id=None 与「不传」逐字节相同(钉成契约)==")
126
- cg = _cg("n5")
127
- a1 = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
128
- a2 = _call(cg, {"op": "read", "query": "alpha"})
129
- ok(json.dumps(a1, ensure_ascii=False, sort_keys=True)
130
- == json.dumps(a2, ensure_ascii=False, sort_keys=True),
131
- "N5 node_id=None 与不传 node_id 逐字节相同(报告读数,已钉为契约)",
132
- (json.dumps(a1, ensure_ascii=False)[:100],
133
- json.dumps(a2, ensure_ascii=False)[:100]))
134
-
135
-
136
- def n6():
137
- print("== N6 错误里 got_type 如实 ==")
138
- cg = _cg("n6")
139
- for v, want in ((123, "int"), (1.5, "float"), (True, "bool"),
140
- (["x"], "list"), ({"a": 1}, "dict")):
141
- o = _call(cg, {"op": "read", "node_id": v})
142
- ok(_is_type_error(o) and o.get("got_type") == want,
143
- "N6 node_id=%r ⇒ got_type=%s" % (v, want),
144
- (o or {}).get("got_type"))
145
-
146
-
147
- def n7():
148
- print("== N7 跨面:audit 面对 None 报类型错(如实记录差异)==")
149
- cg = _cg("n7")
150
- o = _call(cg, {"op": "audit", "node_id": None})
151
- ok(_is_type_error(o), "N7 audit 面 node_id=None ⇒ node_id_not_str(与 read 面口径不同)",
152
- json.dumps(o, ensure_ascii=False)[:150])
153
-
154
-
155
- def _wire_err(res):
156
- try:
157
- if isinstance(res, dict) and "structuredContent" in res:
158
- sc = res["structuredContent"]
159
- if isinstance(sc, dict) and "result" in sc:
160
- return sc["result"]
161
- return sc
162
- if isinstance(res, dict) and "content" in res:
163
- return json.loads(res["content"][0]["text"])
164
- except Exception: # noqa: BLE001
165
- pass
166
- return res
167
-
168
-
169
- def n8():
170
- print("== N8 真 MCP stdio:null ⇒ 检索包;123 ⇒ 类型错 ==")
171
- root = tempfile.mkdtemp(prefix="n274_stdio_")
172
- os.makedirs(os.path.join(root, "knowledge"), exist_ok=True)
173
- from . import nodefile
174
- with io.open(os.path.join(root, "knowledge", "n1.md"), "w",
175
- encoding="utf-8") as f:
176
- f.write(nodefile.dumps({"id": "n1", "layer": "knowledge",
177
- "importance": 0.4, "created_at": 1800000000.0,
178
- "tags": []}, "alpha 内容"))
179
- msgs = [
180
- {"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {
181
- "name": "cg", "arguments": {"op": "read", "node_id": None,
182
- "query": "alpha"}}},
183
- {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {
184
- "name": "cg", "arguments": {"op": "read", "node_id": 123,
185
- "query": "alpha"}}},
186
- {"jsonrpc": "2.0", "id": 3, "method": "shutdown"},
187
- ]
188
- env = dict(os.environ, MDCG_ROOT=root,
189
- MDCG_AUX_ROOT=os.path.join(root, "auxiliary"),
190
- MDCG_DATA_ROOT=os.path.join(root, "data"),
191
- PYTHONUTF8="1", PYTHONIOENCODING="utf-8",
192
- MDCG_MCP_SURFACE="kernel")
193
- env.pop("MDCG_TOKEN", None)
194
- keep = ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT", "MDCG_MCP_SURFACE")
195
- for k in list(env):
196
- if k.startswith("MDCG_") and k not in keep:
197
- env.pop(k, None)
198
- try:
199
- pr = subprocess.run([sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
200
- input="".join(json.dumps(m) + "\n" for m in msgs),
201
- env=env, cwd=_REPO, capture_output=True, text=True,
202
- encoding="utf-8", timeout=120)
203
- outs = {}
204
- for line in (pr.stdout or "").splitlines():
205
- line = line.strip()
206
- if not line.startswith("{"):
207
- continue
208
- try:
209
- m = json.loads(line)
210
- except Exception: # noqa: BLE001
211
- continue
212
- if m.get("id") in (1, 2):
213
- outs[m["id"]] = m.get("result", m)
214
- ok(pr.returncode == 0, "N8a 真 stdio 子进程正常退出",
215
- (pr.returncode, (pr.stderr or "")[-200:]))
216
- o1 = outs.get(1)
217
- ok(o1 is not None and not _is_type_error(_wire_err(o1)),
218
- "N8b 真 wire:JSON null ⇒ 走检索(不报类型错)",
219
- json.dumps(o1, ensure_ascii=False)[:220])
220
- o2 = outs.get(2)
221
- ok(o2 is not None and _is_type_error(_wire_err(o2)),
222
- "N8c 真 wire:123 ⇒ node_id_not_str",
223
- json.dumps(o2, ensure_ascii=False)[:220])
224
- except Exception as exc: # noqa: BLE001
225
- ok(False, "N8 真 stdio 腿抛异常:%r" % (exc,))
226
-
227
-
228
- def _src() -> str:
229
- with io.open(os.path.join(_REPO, "md_cg", "mcp_server.py"),
230
- encoding="utf-8", errors="replace") as f:
231
- return f.read()
232
-
233
-
234
- def n9():
235
- print("== N9 反陈化:源码必须写明 None 的动机(本件修复的实质)==")
236
- t = _src()
237
- ok("issue #274" in t, "N9a 源码标注 issue #274(可追溯)")
238
- ok("刻意保留" in t or "刻意" in t,
239
- "N9b 源码写明该不对称是**刻意**的(不是疏漏)")
240
- ok("M2-B9" in t or "M2-B8" in t,
241
- "N9c 源码点名钉住该行为的测试(M2-B8/M2-B9)——改它须连带改测试")
242
- ok("显式 None 是" in t,
243
- "N9d 源码**逐字**写明 None 的语义(显式 None 是未传)——本件被误读的根因行")
244
-
245
-
246
- def n10():
247
- print("== N10 交叉引用:钉住该行为的两条断言仍存在 ==")
248
- p = os.path.join(_REPO, "md_cg", "test_read_face_input_gates.py")
249
- with io.open(p, encoding="utf-8", errors="replace") as f:
250
- t = f.read()
251
- ok("M2-B8" in t, "N10a M2-B8(显式空串不再静默降级为检索)仍在")
252
- ok("M2-B9" in t, "N10b M2-B9(node_id=None 仍是未传,走检索)仍在")
253
- ok("不回归" in t, "N10c M2-B9 仍声明「不回归」语义")
254
-
255
-
256
- _GROUPS = (n1, n2, n3, n4, n5, n6, n7, n8, n9, n10)
257
-
258
-
259
- def _run_groups() -> int:
260
- _PASS.clear()
261
- _FAIL.clear()
262
- for g in _GROUPS:
263
- try:
264
- g()
265
- except Exception as exc: # noqa: BLE001
266
- ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
267
- import traceback
268
- print(traceback.format_exc()[-700:])
269
- return len(_FAIL)
270
-
271
-
272
- def main() -> int:
273
- n = _run_groups()
274
- print("\nnode_id 两种显式处置守卫:%d 通过,%d 失败" % (len(_PASS), n))
275
- return 1 if n else 0
276
-
277
-
278
- # --------------------------------------------------------------- 定点变异自证
279
- _MUTATIONS = (
280
- ("V1 删掉 None 的动机说明(退回「只写空串动机」= 本件被误读的根因)",
281
- " # · 显式 None 是**未传**:MCP 客户端把「没有 id」序列化成 null 是常规形态,",
282
- " # (此处原本写明 None 的动机,被变异删除)",
283
- "N9"),
284
- ("V2 判据改为键存在性(把 None 也当显式 ⇒ 行为变更)",
285
- ' if a.get("node_id") is not None:',
286
- ' if "node_id" in a:',
287
- "N1"),
288
- ("V3 判据改为真值判(把显式空串也当没传)",
289
- ' if a.get("node_id") is not None:',
290
- ' if a.get("node_id"):',
291
- "N3"),
292
- )
293
-
294
-
295
- def _reload():
296
- import importlib
297
- from . import mcp_server as _m
298
- importlib.reload(_m)
299
- globals()["MS"] = _m
300
-
301
-
302
- def _mutate() -> int:
303
- bad = []
304
- src_p = os.path.join(_REPO, "md_cg", "mcp_server.py")
305
- for name, anchor, repl, want in _MUTATIONS:
306
- with io.open(src_p, encoding="utf-8", newline="") as f:
307
- orig = f.read()
308
- NL = "\r\n" if "\r\n" in orig else "\n"
309
- a_ = anchor.replace("\n", NL)
310
- r_ = repl.replace("\n", NL)
311
- try:
312
- if a_ not in orig:
313
- print(" ANCHOR-MISS %s" % name)
314
- bad.append(name)
315
- continue
316
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
317
- f.write(orig.replace(a_, r_))
318
- _reload()
319
- _run_groups()
320
- reds = list(_FAIL)
321
- hit = any(r.startswith(want) for r in reds)
322
- print(" %-4s %-52s 红项=%-3d 命中%s=%s"
323
- % ("OK" if hit else "BAD", name, len(reds), want,
324
- "是" if hit else "否"))
325
- if not hit:
326
- bad.append(name)
327
- finally:
328
- with io.open(src_p, "w", encoding="utf-8", newline="") as f:
329
- f.write(orig)
330
- _reload()
331
- if bad:
332
- print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
333
- return 1
334
- print("\n定点变异自证:PASS(每处判据都被打红)")
335
- return 0
336
-
337
-
338
- if __name__ == "__main__":
339
- if "--mutate" in sys.argv:
340
- sys.exit(_mutate())
341
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """读面 node_id「两种显式」处置不对称的守卫(issue #274)。
3
+
4
+ 【本守卫守什么】
5
+ #274 报:cg(op=read) 的 node_id=None **静默降级为检索**(返回检索结果包),
6
+ 而 node_id=123 正确报 node_id_not_str —— 同一个「类型错」两种相反待遇。
7
+
8
+ 复核结论:**读数全部成立,但处置不对称是刻意的,不是疏漏。**
9
+ · 显式 "" 是**显式** —— 旧写法会把它当没传而静默转检索,故它必须落进类型闸,
10
+ 走「节点不存在」的 null。
11
+ · 显式 None 是**未传** —— MCP 客户端把「没有 id」序列化成 null 是常规形态,
12
+ 故它落到检索分支;由 test_read_face_input_gates 的 M2-B8 / M2-B9 钉住
13
+ (M2-B9 断言名即「node_id=None 仍是「未传」,走检索(不回归)」)。
14
+
15
+ ⇒ 本件的**实际缺陷是文档缺口**:源码只写了 "" 的动机、没写 None 的动机,
16
+ 于是外部复审把它读成了疏漏。修法是**补文档**(+ 本守卫钉住该不对称),
17
+ **不是**改行为——改行为会打红 M2-B9,属 issue #274 的 R1(行为变更)。
18
+
19
+ 判据:
20
+ N1 node_id=None ⇒ 走检索(**刻意**;与「不传」同处置)。
21
+ N2 node_id=123 ⇒ node_id_not_str(类型错,对照)。
22
+ N3 node_id="" ⇒ null(显式空串**是**显式,不转检索)。
23
+ N4 不传 node_id ⇒ 走检索。
24
+ N5 node_id=None 与「不传」**逐字节相同** —— 把报告读到的这一事实**钉成契约**,
25
+ 以免将来有人"顺手修"成报错而不自知(要改须连带改 M2-B9 与协议表)。
26
+ N6 错误里 got_type 如实(不吞类型)。
27
+ N7 **跨面**:audit 面对 node_id=None 报 node_id_not_str —— 两面口径不同,
28
+ 本守卫**如实记录**该差异(不是要求一致;audit 无检索分支可落)。
29
+ N8 **真 MCP stdio**:JSON null ⇒ 检索包;123 ⇒ 类型错(真通路同形)。
30
+ N9 **反陈化(本件修复的实质)**:源码注释必须写明 None 的动机。
31
+ 只写 "" 的动机 ⇒ 红——因为那正是本件被误读成疏漏的根因。
32
+ N10 交叉引用:钉住该行为的 M2-B8 / M2-B9 两条断言仍存在(若被删,本守卫须知道)。
33
+
34
+ 运行:python -X utf8 -m md_cg.test_issue274_read_node_id_none
35
+ python -X utf8 -m md_cg.test_issue274_read_node_id_none --mutate
36
+
37
+ 退出码(fail-closed):0 = 全绿;1 = 有断言失败 / 变异未按预期转红。
38
+
39
+ 沙箱纪律:库根落守卫临时目录,绝不碰在役库与 ~/.mdcg。
40
+ """
41
+ from __future__ import annotations
42
+
43
+ import io
44
+ import json
45
+ import os
46
+ import subprocess
47
+ import sys
48
+ import tempfile
49
+
50
+ from .mdcos import MdCGOS
51
+ from . import mcp_server as MS
52
+
53
+ _HERE = os.path.dirname(os.path.abspath(__file__))
54
+ _REPO = os.path.dirname(_HERE)
55
+
56
+ _PASS: list = []
57
+ _FAIL: list = []
58
+
59
+
60
+ def ok(cond, msg, extra=""):
61
+ (_PASS if cond else _FAIL).append(msg)
62
+ print((" PASS " if cond else " FAIL ") + msg
63
+ + ((" -> " + str(extra)) if (extra and not cond) else ""))
64
+
65
+
66
+ def _cg(tag):
67
+ root = tempfile.mkdtemp(prefix="n274_%s_" % tag)
68
+ cg = MdCGOS(root)
69
+ cg.add(content="# alpha 知识\n\nalpha 内容。", layer="knowledge", node_id="n1",
70
+ importance=0.5, consistency=False, on_conflict="defer")
71
+ return cg
72
+
73
+
74
+ def _call(cg, a):
75
+ try:
76
+ return MS._cg_call(cg, a)
77
+ except Exception as exc: # noqa: BLE001
78
+ return {"__exc__": type(exc).__name__, "msg": str(exc)[:90]}
79
+
80
+
81
+ def _is_search_pack(o) -> bool:
82
+ return isinstance(o, dict) and ("results" in o or "meta" in o or "pack" in o)
83
+
84
+
85
+ def _is_type_error(o) -> bool:
86
+ return isinstance(o, dict) and o.get("error") == "node_id_not_str"
87
+
88
+
89
+ def n1():
90
+ print("== N1 node_id=None 走检索(刻意行为)==")
91
+ cg = _cg("n1")
92
+ o = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
93
+ ok(_is_search_pack(o), "N1 node_id=None + query ⇒ 检索结果包(刻意)",
94
+ json.dumps(o, ensure_ascii=False)[:150])
95
+ o2 = _call(cg, {"op": "read", "node_id": None})
96
+ ok("__exc__" not in (o2 or {}), "N1b node_id=None 无 query 不抛异常",
97
+ json.dumps(o2, ensure_ascii=False)[:150])
98
+
99
+
100
+ def n2():
101
+ print("== N2 node_id=123 报类型错(对照)==")
102
+ cg = _cg("n2")
103
+ o = _call(cg, {"op": "read", "node_id": 123, "query": "alpha"})
104
+ ok(_is_type_error(o), "N2 node_id=123 ⇒ node_id_not_str",
105
+ json.dumps(o, ensure_ascii=False)[:150])
106
+
107
+
108
+ def n3():
109
+ print("== N3 node_id='' 是显式 ⇒ null(不转检索)==")
110
+ cg = _cg("n3")
111
+ o = _call(cg, {"op": "read", "node_id": "", "query": "alpha"})
112
+ ok(not _is_search_pack(o), "N3a node_id='' 不返回检索包", repr(o)[:150])
113
+ ok(o is None, "N3b node_id='' ⇒ null(协议登记的 node_missing 形态)", repr(o)[:120])
114
+
115
+
116
+ def n4():
117
+ print("== N4 不传 node_id 走检索 ==")
118
+ cg = _cg("n4")
119
+ o = _call(cg, {"op": "read", "query": "alpha"})
120
+ ok(_is_search_pack(o), "N4a 不传 node_id + query ⇒ 检索结果包")
121
+ ok(not _is_type_error(o), "N4b 不传 node_id 不报类型错")
122
+
123
+
124
+ #: 结果形状相同、但**按调用次数变化**的 meta 键(2026-10-21 起 BM25 默认开、
125
+ #: 默认检索走 RRF 融合,热缓存与构建计数会被观测到)。比较 N5 时排除它们:
126
+ #: 这些字段记录的是"本次调用做了多少工作",不是"检索到了什么"。
127
+ _VOLATILE_META = ("cached", "bm25", "reach_build_docs", "reach_build_reads",
128
+ "scanned", "candidates", "pre_cap", "cut_order")
129
+
130
+
131
+ def _stable(obj):
132
+ """把响应里"随调用次数变化"的 meta 键剥掉,只留结果与稳定口径。"""
133
+ if not isinstance(obj, dict):
134
+ return obj
135
+ out = {}
136
+ for k, v in obj.items():
137
+ if k == "meta" and isinstance(v, dict):
138
+ out[k] = {kk: vv for kk, vv in v.items() if kk not in _VOLATILE_META}
139
+ else:
140
+ out[k] = v
141
+ return out
142
+
143
+
144
+ def n5():
145
+ print("== N5 node_id=None 与「不传」同处置(结果逐条相同;排除易变 meta)==")
146
+ cg = _cg("n5")
147
+ a1 = _call(cg, {"op": "read", "node_id": None, "query": "alpha"})
148
+ a2 = _call(cg, {"op": "read", "query": "alpha"})
149
+ # 意图不变:两种「未传」必须落同一条处置(都走检索、返回同一批结果)。
150
+ # 原断言要求整包逐字节相同;BM25 默认开 + 热缓存生效后,meta 会带
151
+ # cached / bm25 构建计数等"按调用次数变化"的字段,故按稳定面比较。
152
+ ok(json.dumps(_stable(a1), ensure_ascii=False, sort_keys=True)
153
+ == json.dumps(_stable(a2), ensure_ascii=False, sort_keys=True),
154
+ "N5 node_id=None 与不传 node_id 结果一致(稳定面逐字节相同)",
155
+ (json.dumps(_stable(a1), ensure_ascii=False)[:100],
156
+ json.dumps(_stable(a2), ensure_ascii=False)[:100]))
157
+
158
+
159
+ def n6():
160
+ print("== N6 错误里 got_type 如实 ==")
161
+ cg = _cg("n6")
162
+ for v, want in ((123, "int"), (1.5, "float"), (True, "bool"),
163
+ (["x"], "list"), ({"a": 1}, "dict")):
164
+ o = _call(cg, {"op": "read", "node_id": v})
165
+ ok(_is_type_error(o) and o.get("got_type") == want,
166
+ "N6 node_id=%r ⇒ got_type=%s" % (v, want),
167
+ (o or {}).get("got_type"))
168
+
169
+
170
+ def n7():
171
+ print("== N7 跨面:audit 面对 None 报类型错(如实记录差异)==")
172
+ cg = _cg("n7")
173
+ o = _call(cg, {"op": "audit", "node_id": None})
174
+ ok(_is_type_error(o), "N7 audit 面 node_id=None ⇒ node_id_not_str(与 read 面口径不同)",
175
+ json.dumps(o, ensure_ascii=False)[:150])
176
+
177
+
178
+ def _wire_err(res):
179
+ try:
180
+ if isinstance(res, dict) and "structuredContent" in res:
181
+ sc = res["structuredContent"]
182
+ if isinstance(sc, dict) and "result" in sc:
183
+ return sc["result"]
184
+ return sc
185
+ if isinstance(res, dict) and "content" in res:
186
+ return json.loads(res["content"][0]["text"])
187
+ except Exception: # noqa: BLE001
188
+ pass
189
+ return res
190
+
191
+
192
+ def n8():
193
+ print("== N8 真 MCP stdio:null ⇒ 检索包;123 ⇒ 类型错 ==")
194
+ root = tempfile.mkdtemp(prefix="n274_stdio_")
195
+ os.makedirs(os.path.join(root, "knowledge"), exist_ok=True)
196
+ from . import nodefile
197
+ with io.open(os.path.join(root, "knowledge", "n1.md"), "w",
198
+ encoding="utf-8") as f:
199
+ f.write(nodefile.dumps({"id": "n1", "layer": "knowledge",
200
+ "importance": 0.4, "created_at": 1800000000.0,
201
+ "tags": []}, "alpha 内容"))
202
+ msgs = [
203
+ {"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {
204
+ "name": "cg", "arguments": {"op": "read", "node_id": None,
205
+ "query": "alpha"}}},
206
+ {"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {
207
+ "name": "cg", "arguments": {"op": "read", "node_id": 123,
208
+ "query": "alpha"}}},
209
+ {"jsonrpc": "2.0", "id": 3, "method": "shutdown"},
210
+ ]
211
+ env = dict(os.environ, MDCG_ROOT=root,
212
+ MDCG_AUX_ROOT=os.path.join(root, "auxiliary"),
213
+ MDCG_DATA_ROOT=os.path.join(root, "data"),
214
+ PYTHONUTF8="1", PYTHONIOENCODING="utf-8",
215
+ MDCG_MCP_SURFACE="kernel")
216
+ env.pop("MDCG_TOKEN", None)
217
+ keep = ("MDCG_ROOT", "MDCG_AUX_ROOT", "MDCG_DATA_ROOT", "MDCG_MCP_SURFACE")
218
+ for k in list(env):
219
+ if k.startswith("MDCG_") and k not in keep:
220
+ env.pop(k, None)
221
+ try:
222
+ pr = subprocess.run([sys.executable, "-X", "utf8", "-m", "md_cg.mcp_server"],
223
+ input="".join(json.dumps(m) + "\n" for m in msgs),
224
+ env=env, cwd=_REPO, capture_output=True, text=True,
225
+ encoding="utf-8", timeout=120)
226
+ outs = {}
227
+ for line in (pr.stdout or "").splitlines():
228
+ line = line.strip()
229
+ if not line.startswith("{"):
230
+ continue
231
+ try:
232
+ m = json.loads(line)
233
+ except Exception: # noqa: BLE001
234
+ continue
235
+ if m.get("id") in (1, 2):
236
+ outs[m["id"]] = m.get("result", m)
237
+ ok(pr.returncode == 0, "N8a 真 stdio 子进程正常退出",
238
+ (pr.returncode, (pr.stderr or "")[-200:]))
239
+ o1 = outs.get(1)
240
+ ok(o1 is not None and not _is_type_error(_wire_err(o1)),
241
+ "N8b 真 wire:JSON null ⇒ 走检索(不报类型错)",
242
+ json.dumps(o1, ensure_ascii=False)[:220])
243
+ o2 = outs.get(2)
244
+ ok(o2 is not None and _is_type_error(_wire_err(o2)),
245
+ "N8c 真 wire:123 ⇒ node_id_not_str",
246
+ json.dumps(o2, ensure_ascii=False)[:220])
247
+ except Exception as exc: # noqa: BLE001
248
+ ok(False, "N8 真 stdio 腿抛异常:%r" % (exc,))
249
+
250
+
251
+ def _src() -> str:
252
+ with io.open(os.path.join(_REPO, "md_cg", "mcp_server.py"),
253
+ encoding="utf-8", errors="replace") as f:
254
+ return f.read()
255
+
256
+
257
+ def n9():
258
+ print("== N9 反陈化:源码必须写明 None 的动机(本件修复的实质)==")
259
+ t = _src()
260
+ ok("issue #274" in t, "N9a 源码标注 issue #274(可追溯)")
261
+ ok("刻意保留" in t or "刻意" in t,
262
+ "N9b 源码写明该不对称是**刻意**的(不是疏漏)")
263
+ ok("M2-B9" in t or "M2-B8" in t,
264
+ "N9c 源码点名钉住该行为的测试(M2-B8/M2-B9)——改它须连带改测试")
265
+ ok("显式 None 是" in t,
266
+ "N9d 源码**逐字**写明 None 的语义(显式 None 是未传)——本件被误读的根因行")
267
+
268
+
269
+ def n10():
270
+ print("== N10 交叉引用:钉住该行为的两条断言仍存在 ==")
271
+ p = os.path.join(_REPO, "md_cg", "test_read_face_input_gates.py")
272
+ with io.open(p, encoding="utf-8", errors="replace") as f:
273
+ t = f.read()
274
+ ok("M2-B8" in t, "N10a M2-B8(显式空串不再静默降级为检索)仍在")
275
+ ok("M2-B9" in t, "N10b M2-B9(node_id=None 仍是未传,走检索)仍在")
276
+ ok("不回归" in t, "N10c M2-B9 仍声明「不回归」语义")
277
+
278
+
279
+ _GROUPS = (n1, n2, n3, n4, n5, n6, n7, n8, n9, n10)
280
+
281
+
282
+ def _run_groups() -> int:
283
+ _PASS.clear()
284
+ _FAIL.clear()
285
+ for g in _GROUPS:
286
+ try:
287
+ g()
288
+ except Exception as exc: # noqa: BLE001
289
+ ok(False, "断言组 %s 抛异常:%s" % (g.__name__, exc))
290
+ import traceback
291
+ print(traceback.format_exc()[-700:])
292
+ return len(_FAIL)
293
+
294
+
295
+ def main() -> int:
296
+ n = _run_groups()
297
+ print("\nnode_id 两种显式处置守卫:%d 通过,%d 失败" % (len(_PASS), n))
298
+ return 1 if n else 0
299
+
300
+
301
+ # --------------------------------------------------------------- 定点变异自证
302
+ _MUTATIONS = (
303
+ ("V1 删掉 None 的动机说明(退回「只写空串动机」= 本件被误读的根因)",
304
+ " # · 显式 None 是**未传**:MCP 客户端把「没有 id」序列化成 null 是常规形态,",
305
+ " # (此处原本写明 None 的动机,被变异删除)",
306
+ "N9"),
307
+ ("V2 判据改为键存在性(把 None 也当显式 ⇒ 行为变更)",
308
+ ' if a.get("node_id") is not None:',
309
+ ' if "node_id" in a:',
310
+ "N1"),
311
+ ("V3 判据改为真值判(把显式空串也当没传)",
312
+ ' if a.get("node_id") is not None:',
313
+ ' if a.get("node_id"):',
314
+ "N3"),
315
+ )
316
+
317
+
318
+ def _reload():
319
+ import importlib
320
+ from . import mcp_server as _m
321
+ importlib.reload(_m)
322
+ globals()["MS"] = _m
323
+
324
+
325
+ def _mutate() -> int:
326
+ bad = []
327
+ src_p = os.path.join(_REPO, "md_cg", "mcp_server.py")
328
+ for name, anchor, repl, want in _MUTATIONS:
329
+ with io.open(src_p, encoding="utf-8", newline="") as f:
330
+ orig = f.read()
331
+ NL = "\r\n" if "\r\n" in orig else "\n"
332
+ a_ = anchor.replace("\n", NL)
333
+ r_ = repl.replace("\n", NL)
334
+ try:
335
+ if a_ not in orig:
336
+ print(" ANCHOR-MISS %s" % name)
337
+ bad.append(name)
338
+ continue
339
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
340
+ f.write(orig.replace(a_, r_))
341
+ _reload()
342
+ _run_groups()
343
+ reds = list(_FAIL)
344
+ hit = any(r.startswith(want) for r in reds)
345
+ print(" %-4s %-52s 红项=%-3d 命中%s=%s"
346
+ % ("OK" if hit else "BAD", name, len(reds), want,
347
+ "是" if hit else "否"))
348
+ if not hit:
349
+ bad.append(name)
350
+ finally:
351
+ with io.open(src_p, "w", encoding="utf-8", newline="") as f:
352
+ f.write(orig)
353
+ _reload()
354
+ if bad:
355
+ print("\n定点变异自证:FAIL -- %s" % "、".join(bad))
356
+ return 1
357
+ print("\n定点变异自证:PASS(每处判据都被打红)")
358
+ return 0
359
+
360
+
361
+ if __name__ == "__main__":
362
+ if "--mutate" in sys.argv:
363
+ sys.exit(_mutate())
364
+ sys.exit(main())