@furongjun1999/dsh-memory 0.9.23 → 0.10.3

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 (118) hide show
  1. package/CHANGELOG.en.md +515 -404
  2. package/CHANGELOG.md +642 -449
  3. package/README.en.md +244 -240
  4. package/README.md +272 -262
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/discipline/templates/full.md.tmpl +1 -1
  7. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  8. package/docs/en/mdcg/world-model-endpoint.md +1 -1
  9. package/docs/mdcg/cogmap_ops.md +19 -16
  10. package/lib/client.js +29 -3
  11. package/lib/hooks.d.ts +12 -0
  12. package/lib/hooks.js +43 -1
  13. package/lib/tools.d.ts +2 -2
  14. package/md_cg/bucketindex.py +231 -0
  15. package/md_cg/bucketscope.py +357 -0
  16. package/md_cg/cohesion.py +337 -0
  17. package/md_cg/config_registry_bulk.py +24 -10
  18. package/md_cg/config_validate.py +14 -2
  19. package/md_cg/constraint_audit.py +231 -0
  20. package/md_cg/constraint_watch.py +206 -0
  21. package/md_cg/context_audit.py +240 -0
  22. package/md_cg/context_plan.py +142 -0
  23. package/md_cg/detrerank.py +137 -0
  24. package/md_cg/distill.py +247 -0
  25. package/md_cg/dossier.py +151 -0
  26. package/md_cg/entities.py +133 -0
  27. package/md_cg/fsutil.py +135 -0
  28. package/md_cg/govern/__init__.py +23 -0
  29. package/md_cg/iface/__init__.py +46 -0
  30. package/md_cg/iface/_verify.py +609 -0
  31. package/md_cg/iface/contracts.py +337 -0
  32. package/md_cg/judgment_manifest.py +14 -0
  33. package/md_cg/kernel/__init__.py +27 -0
  34. package/md_cg/mcp_server.py +6044 -5761
  35. package/md_cg/mdcg.py +501 -16
  36. package/md_cg/mdcos.py +546 -12
  37. package/md_cg/metacognition.py +66 -13
  38. package/md_cg/mutate_extract_shipped.py +126 -0
  39. package/md_cg/mutate_ledger_e2e.py +100 -0
  40. package/md_cg/op_table.py +22 -0
  41. package/md_cg/probe_c_ledger_integrity.py +258 -0
  42. package/md_cg/probe_d_retirement_discipline.py +263 -0
  43. package/md_cg/profiles.py +298 -0
  44. package/md_cg/protocol.py +7 -1
  45. package/md_cg/reldate.py +142 -0
  46. package/md_cg/review_cli.py +6 -1
  47. package/md_cg/run_tests.py +30 -1
  48. package/md_cg/scopeselect.py +214 -0
  49. package/md_cg/scrub.py +66 -9
  50. package/md_cg/selfstmt.py +139 -0
  51. package/md_cg/state_extract.py +149 -0
  52. package/md_cg/state_slots.py +62 -10
  53. package/md_cg/state_view.py +181 -0
  54. package/md_cg/structboost.py +179 -0
  55. package/md_cg/sustain.py +28 -2
  56. package/md_cg/test_alternatives_historical.py +165 -0
  57. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  58. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  59. package/md_cg/test_bucket_cards.py +85 -0
  60. package/md_cg/test_bucket_day_order.py +74 -0
  61. package/md_cg/test_bucket_quota.py +79 -0
  62. package/md_cg/test_bucket_recency_guards.py +75 -0
  63. package/md_cg/test_bucket_three_causes.py +83 -0
  64. package/md_cg/test_bucket_time_rounds.py +87 -0
  65. package/md_cg/test_bucketindex.py +130 -0
  66. package/md_cg/test_bucketscope_early.py +71 -0
  67. package/md_cg/test_cohesion.py +107 -0
  68. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  69. package/md_cg/test_cond_term_neg_scope.py +147 -0
  70. package/md_cg/test_constraint_audit.py +87 -0
  71. package/md_cg/test_constraint_watch.py +108 -0
  72. package/md_cg/test_context_audit.py +110 -0
  73. package/md_cg/test_context_plan.py +81 -0
  74. package/md_cg/test_detrerank.py +157 -0
  75. package/md_cg/test_gate_four_kpi.py +136 -0
  76. package/md_cg/test_generation_guard.py +14 -2
  77. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  78. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  79. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  80. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  81. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  82. package/md_cg/test_issue790_verb_negation.py +77 -0
  83. package/md_cg/test_issue810_root_guard.py +71 -0
  84. package/md_cg/test_issue812_info_index_stale.py +78 -0
  85. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  86. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  87. package/md_cg/test_kernel_iface_contracts.py +18 -0
  88. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  89. package/md_cg/test_probe_cd_shipped.py +385 -0
  90. package/md_cg/test_recent_tail.py +93 -0
  91. package/md_cg/test_run_tests_entry_gates.py +110 -0
  92. package/md_cg/test_scopeselect.py +70 -0
  93. package/md_cg/test_scopeselect_clock.py +70 -0
  94. package/md_cg/test_session_attribution_consistency.py +835 -813
  95. package/md_cg/test_state_extract_shipped.py +162 -0
  96. package/md_cg/test_state_ledger_chain.py +207 -0
  97. package/md_cg/test_state_ledger_e2e.py +145 -0
  98. package/md_cg/test_structboost.py +102 -0
  99. package/md_cg/test_timeboost.py +83 -0
  100. package/md_cg/test_timeboost_relativedate.py +71 -0
  101. package/md_cg/test_topicagg.py +129 -0
  102. package/md_cg/timeboost.py +223 -0
  103. package/md_cg/tokens.py +1 -1
  104. package/md_cg/topicagg.py +142 -0
  105. package/md_cg/version_anchor.py +84 -1
  106. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  107. package/md_cg/whitebox_kb/wisdom/code_solidified.json +6195 -6195
  108. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  109. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  110. package/package.json +1 -1
  111. package/src/hooks.ts +43 -1
  112. package/ui/minimal/payload/build-ui.mjs +41 -2
  113. package/ui/minimal/payload/lib/client.js +29 -3
  114. package/ui/minimal/payload/web/app.js +3 -1
  115. package/ui/minimal/payload/web/client.js +30 -3
  116. package/web/app.js +3 -1
  117. package/web/client.js +30 -3
  118. package/zcode/AGENTS.md +1 -1
@@ -0,0 +1,258 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """C 探针:《秤》5.1 账本完整性——状态事件台账的三读数(缺口 / 无账可辨 / 变迁史可查)。
4
+
5
+ 出处:语义时空图补全 P3(《秤》v2.1 §5.1 账本完整性口径;账本面 = `md_cg/state_events.py`
6
+ 台账 `<root>/_state_events.jsonl` + `md_cg/state_slots.py` 投影 + `stg(op=state_chain)`
7
+ 查询面)。设计稿:`docs/plans/语义时空图补全_世界模型功能端_设计_v0.1.md` §4 验收跑道。
8
+
9
+ 口径(写定):
10
+ ① 事件覆盖缺口率 = `--expect-slots` 清单中「台账无任何记录」的槽位占比
11
+ (分子=无记录槽位数、分母=清单槽位数;**分子/分母都打印**)。
12
+ ② 无账可辨率 = 对「无记录槽位」+固定合成不存在槽位逐条查询 `stg(state_chain)`:
13
+ 通过判据 `count==0 且 items==[]`——**不编造、不反推**(没账就必须如实报空,
14
+ 而不是给一个猜的值)。分子=通过条数、分母=查询条数。
15
+ ③ 变迁史可查率 = 台账**有记录**槽位中,`state_chain`(include_retired=True、
16
+ history=True、limit 取足)返回的 history 条数合计 == 台账该槽位记录数 的比例
17
+ (分子=可查槽位数、分母=有记录槽位数)。
18
+
19
+ 边界(如实):
20
+ · 本探针只测**账本面**可辨性(台账/投影/查询面三者的账实一致性);
21
+ 「生成器级无账强答」(LLM 在无账时是否硬答)**不在本探针**——那需要接
22
+ 生成器侧读数,后置。
23
+ · 槽位按**标签面**精确匹配(slot 名相等;不做同义归并/模糊匹配)。
24
+ · `alternatives`/`blindspots` 判定口径后置,本探针不涉及。
25
+
26
+ 隐私与确定性(硬性):
27
+ · 脚本不内嵌任何本机路径字面量——events/expect-slots/out 一律 CLI 参数传入;
28
+ · `--out` 必须落在仓外(脚本内 fail-closed 断言:以本文件上两级为仓根判定);
29
+ · 确定性:无随机、无时间戳、无路径回显——**同一输入两次运行 stdout 与 --out
30
+ 产物字节一致**;
31
+ · 零记忆库写入:隔离 temp root(把 `--events` 拷为该 root 的
32
+ `_state_events.jsonl`)+ `MdCGOS(root)`,全程不在役库 append/落盘;
33
+ `MDCG_STG_STATE` 在进程内临时设置、结束后还原。
34
+
35
+ 用法(中性占位路径;**装机侧也可用**——本体随包):
36
+ python -X utf8 -m md_cg.probe_c_ledger_integrity \\
37
+ --events %TEMP%/state_events.jsonl --expect-slots 住所,房贷,名字 \\
38
+ [--out %TEMP%/probe_c_out]
39
+
40
+ (源码树里 `scripts/probe_c_ledger_integrity.py` 仍可照抄执行——那是**薄垫片**,
41
+ 本体只此一处。装机侧没有 `scripts/`,故文档给的是 `-m` 形态。)
42
+
43
+ stdout 末行:`PROBE_C_LEDGER_JSON {...}` 摘要(机器可读);
44
+ --out 时另落 `rates.json` + `probe_c_slots.jsonl` 两件明细(人读/对拍用)。
45
+ """
46
+ from __future__ import annotations
47
+
48
+ import argparse
49
+ import json
50
+ import os
51
+ import shutil
52
+ import sys
53
+ import tempfile
54
+
55
+ # 本体在包内(`md_cg/`)⇒ **相对导入**,不靠 sys.path 回退两级。
56
+ # 源码树薄垫片 `scripts/probe_c_ledger_integrity.py` 只 re-export 本件。
57
+ from . import state_events, stg # noqa: E402
58
+ from .mdcos import MdCGOS # noqa: E402
59
+
60
+ #: 合成不存在槽位(读数②的必空对照组;固定字面量——确定性要求)。
61
+ SYNTH_SLOTS = ("__probe_c_no_such_slot_1__", "__probe_c_no_such_slot_2__")
62
+
63
+ #: state_chain 取足条数(避免 limit 截断污染读数③的 history 条数口径)。
64
+ BIG_LIMIT = 10 ** 9
65
+
66
+
67
+ # 生效条件:out_dir 为 CLI 给出的输出目录时——以本脚本上两级目录为仓根,判定其绝对路径是否落在仓内;仓内即 sys.exit 拒绝运行(fail-closed);不同盘符(commonpath 抛 ValueError)按必在仓外处理。
68
+ def _package_root():
69
+ """向上找**含 package.json 的目录**作为包根(源码树与装机侧都成立)。
70
+
71
+ 为什么不沿用旧写法「本文件上两级」:本体从 `scripts/`(上两级=仓根)移到
72
+ `md_cg/`(上两级=仓根也对,但装机侧就变成 `node_modules/@furongjun1999/`)——
73
+ 同一表达式在两种布局下指的不是同一个东西。故改成按 `package.json` 定位,
74
+ 两种布局都对,且不依赖任何本机路径字面量。
75
+ """
76
+ d = os.path.dirname(os.path.abspath(__file__))
77
+ for _ in range(6):
78
+ if os.path.isfile(os.path.join(d, "package.json")):
79
+ return d
80
+ parent = os.path.dirname(d)
81
+ if parent == d:
82
+ break
83
+ d = parent
84
+ return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
85
+
86
+
87
+ def assert_outside_repo(out_dir):
88
+ """--out 必须在**包外**(fail-closed):以 `_package_root()` 为包根判定。"""
89
+ repo = _package_root()
90
+ out_abs = os.path.abspath(out_dir)
91
+ try:
92
+ common = os.path.commonpath([repo, out_abs])
93
+ except ValueError:
94
+ return # 不同盘符 ⇒ 必在包外
95
+ if common == repo:
96
+ sys.exit("拒绝运行(fail-closed):--out 必须落在包外,当前解析为包内路径。"
97
+ "请改用包外目录(如临时目录)。")
98
+
99
+
100
+ # 生效条件:arg 为 --expect-slots 原串(逗号分隔,可为空串)——按逗号切分、逐项 strip、去空项、按首现序去重后返回清单(空串 → [],即不做缺口读数)。
101
+ def parse_slots(arg):
102
+ """--expect-slots 解析:逗号分隔 → 去空白/去空项/保序去重。"""
103
+ out, seen = [], set()
104
+ for s in (arg or "").split(","):
105
+ s = s.strip()
106
+ if s and s not in seen:
107
+ seen.add(s)
108
+ out.append(s)
109
+ return out
110
+
111
+
112
+ # 生效条件:path 为台账 jsonl 路径时——逐行 json.loads(空行跳过;解析失败或非对象载荷按坏行跳过,与 state_events.read 同口径),返回 record 列表(落盘序)。
113
+ def load_records(path):
114
+ """读台账(坏行跳过,与 `state_events.read` 同口径——同源、不另立判据)。"""
115
+ recs = []
116
+ with open(path, encoding="utf-8", errors="replace") as f:
117
+ for line in f:
118
+ line = line.strip()
119
+ if not line:
120
+ continue
121
+ try:
122
+ rec = json.loads(line)
123
+ except ValueError:
124
+ continue
125
+ if isinstance(rec, dict):
126
+ recs.append(rec)
127
+ return recs
128
+
129
+
130
+ # 生效条件:text 为待打印行时——按 UTF-8 显式写 stdout(errors=replace);流不支持 reconfigure 时跳过(不改变输出内容)。
131
+ def _out(text):
132
+ print(text)
133
+
134
+
135
+ def main() -> int:
136
+ ap = argparse.ArgumentParser(
137
+ description="《秤》5.1 账本完整性探针(只读台账;隔离 temp root;确定性输出)")
138
+ ap.add_argument("--events", required=True,
139
+ help="state_events.jsonl 路径(**仓外**;只读输入)")
140
+ ap.add_argument("--expect-slots", dest="expect_slots", default="",
141
+ help="逗号分隔的应覆盖槽位清单(可选;省略=不做缺口读数)")
142
+ ap.add_argument("--out", default=None,
143
+ help="输出目录(可选;必须落在仓外)")
144
+ a = ap.parse_args()
145
+
146
+ if a.out:
147
+ assert_outside_repo(a.out)
148
+ if not os.path.exists(a.events):
149
+ sys.exit("输入台账不存在:%s" % a.events)
150
+ expect = parse_slots(a.expect_slots)
151
+
152
+ try:
153
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
154
+ except Exception: # noqa: BLE001
155
+ pass
156
+
157
+ root = tempfile.mkdtemp(prefix="probe_c_")
158
+ saved_state = os.environ.get("MDCG_STG_STATE")
159
+ try:
160
+ # 隔离 temp root:把输入台账拷为该 root 的正式台账名(查询面只认这个名字)。
161
+ shutil.copyfile(a.events, os.path.join(root, state_events.STATE_EVENTS_NAME))
162
+ cg = MdCGOS(root)
163
+ recs = load_records(os.path.join(root, state_events.STATE_EVENTS_NAME))
164
+ by_slot = {}
165
+ for r in recs:
166
+ by_slot.setdefault(str(r.get("slot")), []).append(r)
167
+
168
+ os.environ["MDCG_STG_STATE"] = "1" # 进程内临时开(finally 还原)
169
+
170
+ # ---- ① 事件覆盖缺口率 ----
171
+ missing = [s for s in expect if s not in by_slot]
172
+ gap = [len(missing), len(expect)]
173
+
174
+ # ---- ② 无账可辨率 ----
175
+ targets = ([("expect_missing", s) for s in missing]
176
+ + [("synthetic", s) for s in SYNTH_SLOTS])
177
+ dist = []
178
+ for kind, s in targets:
179
+ ch = stg.state_chain(cg, slot=s, include_retired=True,
180
+ history=True, limit=BIG_LIMIT)
181
+ passed = (ch.get("count") == 0 and (ch.get("items") or []) == [])
182
+ dist.append({"kind": kind, "slot": s, "count": ch.get("count"),
183
+ "kept": ch.get("kept"), "distinguishable": passed})
184
+ no_ledger = [sum(1 for d in dist if d["distinguishable"]), len(dist)]
185
+
186
+ # ---- ③ 变迁史可查率 ----
187
+ hist = []
188
+ for s in sorted(by_slot):
189
+ ch = stg.state_chain(cg, slot=s, include_retired=True,
190
+ history=True, limit=BIG_LIMIT)
191
+ total = sum(len(u.get("history") or []) for u in (ch.get("items") or []))
192
+ n = len(by_slot[s])
193
+ hist.append({"slot": s, "ledger_records": n,
194
+ "chain_count": ch.get("count"), "history_total": total,
195
+ "queryable": total == n})
196
+ history_queryable = [sum(1 for h in hist if h["queryable"]), len(hist)]
197
+ finally:
198
+ if saved_state is None:
199
+ os.environ.pop("MDCG_STG_STATE", None)
200
+ else:
201
+ os.environ["MDCG_STG_STATE"] = saved_state
202
+ shutil.rmtree(root, ignore_errors=True)
203
+
204
+ # ---- 人读读数 ----
205
+ _out("台账:events=%d slots=%d" % (len(recs), len(by_slot)))
206
+ _out("① 事件覆盖缺口率:%d/%d(无记录槽位:%s)"
207
+ % (gap[0], gap[1], "、".join(missing) if missing else "无"))
208
+ _out("② 无账可辨率:%d/%d(判据 count==0 且 items==[],不编造不反推)"
209
+ % (no_ledger[0], no_ledger[1]))
210
+ _out("③ 变迁史可查率:%d/%d(history 条数 == 台账记录数)"
211
+ % (history_queryable[0], history_queryable[1]))
212
+
213
+ # ---- 明细产物(--out,仓外)----
214
+ if a.out:
215
+ os.makedirs(a.out, exist_ok=True)
216
+ detail = {
217
+ "events_total": len(recs),
218
+ "slots_total": len(by_slot),
219
+ "expect_slots": expect,
220
+ "gap": {"num": gap[0], "den": gap[1], "missing": missing},
221
+ "no_ledger_distinguishable": {
222
+ "num": no_ledger[0], "den": no_ledger[1],
223
+ "queries": dist,
224
+ },
225
+ "history_queryable": {
226
+ "num": history_queryable[0], "den": history_queryable[1],
227
+ "slots": hist,
228
+ },
229
+ }
230
+ with open(os.path.join(a.out, "rates.json"), "w",
231
+ encoding="utf-8", newline="\n") as f:
232
+ json.dump(detail, f, ensure_ascii=False, indent=2)
233
+ f.write("\n")
234
+ with open(os.path.join(a.out, "probe_c_slots.jsonl"), "w",
235
+ encoding="utf-8", newline="\n") as f:
236
+ rows = ([{"kind": d["kind"], "slot": d["slot"],
237
+ "ledger_records": len(by_slot.get(d["slot"], [])),
238
+ "chain_count": d["count"], "history_total": None,
239
+ "distinguishable": d["distinguishable"]} for d in dist]
240
+ + [{"kind": "recorded", "slot": h["slot"],
241
+ "ledger_records": h["ledger_records"],
242
+ "chain_count": h["chain_count"],
243
+ "history_total": h["history_total"],
244
+ "distinguishable": None} for h in hist])
245
+ rows.sort(key=lambda r: (r["kind"], r["slot"]))
246
+ for r in rows:
247
+ f.write(json.dumps(r, ensure_ascii=False, sort_keys=True) + "\n")
248
+
249
+ # ---- 机器可读摘要(末行;键序固定 ⇒ 同输入同字节)----
250
+ summary = {"slots": len(expect), "gap": gap,
251
+ "no_ledger_distinguishable": no_ledger,
252
+ "history_queryable": history_queryable, "events": len(recs)}
253
+ _out("PROBE_C_LEDGER_JSON " + json.dumps(summary, ensure_ascii=False))
254
+ return 0
255
+
256
+
257
+ if __name__ == "__main__":
258
+ sys.exit(main())
@@ -0,0 +1,263 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """D 探针:《秤》v2.1 §5.2 退役纪律——登记项退役后的读面/时空面泄漏四读数。
4
+
5
+ 出处:退役纪律缺口(`lifecycle.py:42` 宣称「archived 已归档:不再参与默认检索」,
6
+ 而读面从未实现该过滤)。本探针是该宣称的**外部可复现读数**:把「退役」走完
7
+ 合法迁移表(active→demoted→archived),再看读面与时空面是否仍把它带出来。
8
+
9
+ 口径(写定,逐条可对拍):
10
+ ① 退役泄漏率 = 退役后查证步中 v2 仍出现在该面的面数 / 查证面数
11
+ (查证面 = 读面 search∪recall、时空面 timeline∪anchors;**目标 0**)。
12
+ ② 更新采纳率 = v2 写入后查证步中 v2 可见的面数 / 查证面数
13
+ (**目标 1**——写了看不见 = 反向缺陷,与①互为对照,防「一刀切全滤」)。
14
+ ③ 旧事实残留率 = 退役步之后 v1 仍在的面数 / 查证面数(**目标 1**——退役
15
+ v2 不得连带抹掉 v1;这是「不误剔」的现场读数)。
16
+ ④ 失效误判证伪率 = 退役节点被错误置 falsified/rejected 的条数 / 退役节点数
17
+ (**目标 0**——退役 ≠ 证伪:`archived` 是生命周期态,`rejected` 是裁决层;
18
+ 判据 = 索引层仍为 rejected/unresolved,或 frontmatter 带 falsified 标记)。
19
+
20
+ 序列(固定,不随机):写 v1 → 查(应见)→ 写矛盾 v2 → 查(应见)→
21
+ 退役 v2(active→demoted→archived,走 `lifecycle.set_state` 合法迁移表)→ 查。
22
+
23
+ 边界(如实):
24
+ · 本探针只测**读面/时空面**(默认检索与 stg 扫描面);`cg.get` 直读、`op=audit`
25
+ 审计面、`set_state` 恢复路径**不受退役限制**(「退役不删除、可显式恢复」的
26
+ 另一半),故**不在**①的查证面内——把它们算作泄漏是把守卫修过头。
27
+ · `converged`/`demoted` 是**降权轴**,仍参与默认检索(设计内),本探针不测。
28
+ · 只测单进程单库;跨进程他写场景不在本探针。
29
+
30
+ 隐私与确定性(硬性):
31
+ · 脚本不内嵌任何本机路径字面量——输出只含固定字面量与计数,**无临时路径回显**;
32
+ · `--out` 给定时必须落在仓外(脚本内 fail-closed 断言,与 probe_c 同款);
33
+ · 确定性:无随机、无时间戳、无 id 回显——**同一输入两次运行 stdout 字节一致**;
34
+ · 零在役库写入:隔离 temp root(`tempfile.mkdtemp`)内建库、写节点、退役、查证,
35
+ 结束后整根删除;全程不触在役库。
36
+
37
+ 用法(中性占位路径;**装机侧也可用**——本体随包):
38
+ python -X utf8 -m md_cg.probe_d_retirement_discipline [--out %TEMP%/probe_d_out]
39
+
40
+ (源码树里 `scripts/probe_d_retirement_discipline.py` 仍可照抄执行——那是**薄垫片**,
41
+ 本体只此一处。)
42
+
43
+ stdout 末行:`PROBE_D_JSON {...}` 摘要(机器可读);`--out` 时另落
44
+ `rates.json`(人读/对拍用)。
45
+ """
46
+ from __future__ import annotations
47
+
48
+ import argparse
49
+ import json
50
+ import os
51
+ import shutil
52
+ import sys
53
+ import tempfile
54
+
55
+ # 本体在包内(`md_cg/`)⇒ **相对导入**,不靠 sys.path 回退两级。
56
+ from . import stg # noqa: E402
57
+ from .mdcos import MdCGOS # noqa: E402
58
+
59
+ #: 查证用查询串(固定字面量——确定性要求;同时逐字出现在两个节点正文里)。
60
+ QUERY = "退役纪律探针槽位"
61
+
62
+ #: 两个节点 id 与正文(正文含 CCG 六要素:避免资格判 BLINDSPOT 影响可见性读数)。
63
+ NODE_V1 = "probe_d_v1"
64
+ NODE_V2 = "probe_d_v2"
65
+
66
+ V1_BODY = """# 功能名:探针 D 旧事实登记(v1)
67
+ # 生效条件:隔离 temp root 内执行退役纪律探针序列(写 v1 → 写矛盾 v2 → 退役 v2)
68
+ # 子功能:①旧事实登记 ②退役后残留率(读数③)的对照节点
69
+ # 执行:cg.add(probe_d_v1, ...) 一次
70
+ # 验证方式:读面 search/recall 与时空面 timeline/anchors 的可见性断言
71
+ # 不适用条件:在役真实记忆库内执行本序列
72
+ 正文:退役纪律探针槽位 = 甲地(初始登记)"""
73
+
74
+ V2_BODY = """# 功能名:探针 D 新事实订正(v2,与 v1 矛盾)
75
+ # 生效条件:隔离 temp root 内执行退役纪律探针序列(v1 已写入后)
76
+ # 子功能:①新事实登记 ②退役后泄漏率(读数①)的被测节点
77
+ # 执行:cg.add(probe_d_v2, ...) 一次 + lifecycle.set_state 逐级降级到 archived
78
+ # 验证方式:读面 search/recall 与时空面 timeline/anchors 的不可见性断言
79
+ # 不适用条件:在役真实记忆库内执行本序列
80
+ 正文:退役纪律探针槽位 = 乙地(订正:甲地登记作废)"""
81
+
82
+ #: 退役路径(走合法迁移表:active→demoted→archived,不跳级)。
83
+ RETIRE_PATH = ("demoted", "archived")
84
+
85
+ #: 时空面 anchors 的查询窗(全时窗哨兵:不因时间窗排除任何节点,只问「在不在候选面」)。
86
+ ANCHOR_WINDOW = [1.0, 10.0 ** 11]
87
+
88
+
89
+ # 生效条件:out_dir 为 CLI 给出的输出目录时——以本脚本上两级目录为仓根,判定其绝对路径是否落在仓内;仓内即 sys.exit 拒绝运行(fail-closed);不同盘符(commonpath 抛 ValueError)按必在仓外处理。
90
+ def _package_root():
91
+ """向上找**含 package.json 的目录**作为包根(源码树与装机侧都成立)。
92
+
93
+ 为什么不沿用旧写法「本文件上两级」:本体从 `scripts/` 移到 `md_cg/` 后,
94
+ 同一表达式在源码树与装机布局下指的不是同一个目录。按 `package.json` 定位,
95
+ 两种布局都对,且不依赖任何本机路径字面量。
96
+ """
97
+ d = os.path.dirname(os.path.abspath(__file__))
98
+ for _ in range(6):
99
+ if os.path.isfile(os.path.join(d, "package.json")):
100
+ return d
101
+ parent = os.path.dirname(d)
102
+ if parent == d:
103
+ break
104
+ d = parent
105
+ return os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
106
+
107
+
108
+ def assert_outside_repo(out_dir):
109
+ """--out 必须在**包外**(fail-closed):以 `_package_root()` 为包根判定。"""
110
+ repo = _package_root()
111
+ out_abs = os.path.abspath(out_dir)
112
+ try:
113
+ common = os.path.commonpath([repo, out_abs])
114
+ except ValueError:
115
+ return # 不同盘符 ⇒ 必在包外
116
+ if common == repo:
117
+ sys.exit("拒绝运行(fail-closed):--out 必须落在包外,当前解析为包内路径。"
118
+ "请改用包外目录(如临时目录)。")
119
+
120
+
121
+ # 生效条件:cg、query 传入——把 cg.search(T0–T3 阶梯)与 cg.recall(预算装包 / RRF 融合)两入口的结果 id 取并集返回(集合,不含顺序;无命中即空集)。
122
+ def read_face_ids(cg, query):
123
+ """读面:search ∪ recall 的命中 id 集合(默认检索的两条生产入口)。
124
+
125
+ 两条入口的返回形状不同且都取 id 键(不是节点字典):`search` 是
126
+ `[(node, score, qual)]` 三元组、`recall` 的 `pack` 项是
127
+ `{"id": ..., "content": ...}` 平铺条目——两处都**只认 id**,
128
+ 用错键名会静默变成「该面恒空」,读数失真却看不出来。
129
+ """
130
+ ids = set()
131
+ res, _meta = cg.search(query, k=20, record=False)
132
+ for n, _s, _q in res:
133
+ ids.add(str(n.get("id")))
134
+ pack = cg.recall(query, budget_tokens=4000, k=20)
135
+ for it in (pack.get("pack") or []):
136
+ ids.add(str(it.get("id")))
137
+ return ids
138
+
139
+
140
+ # 生效条件:cg 传入——把 stg.timeline(时间倒序全表视图)与 stg.anchors(全时窗)两 op 的 items id 取并集返回(集合;两 op 均经 stg._scan 候选面)。
141
+ def stg_face_ids(cg):
142
+ """时空面:timeline ∪ anchors 的命中 id 集合(均经 `stg._scan` 候选面)。"""
143
+ ids = set()
144
+ tl = stg.timeline(cg, limit=10 ** 6, max_scan=10 ** 9)
145
+ for it in (tl.get("items") or []):
146
+ ids.add(str(it.get("id")))
147
+ an = stg.anchors(cg, time_window=list(ANCHOR_WINDOW), limit=10 ** 6,
148
+ max_scan=10 ** 9)
149
+ for it in (an.get("items") or []):
150
+ ids.add(str(it.get("id")))
151
+ return ids
152
+
153
+
154
+ # 生效条件:cg、nid 传入——nid 在索引中取不到条目时返回 True(视为「不在被证伪层」的保守侧);否则当 layer 落在 ("rejected","unresolved") 或 frontmatter 的 verification_state 为 "falsified" 时返回 True,其余返回 False。
155
+ def wrongly_falsified(cg, nid):
156
+ """退役被误判为「证伪」的判据:落 negative 层,或带 falsified 标记。"""
157
+ e = (getattr(cg, "index", None) or {}).get("nodes", {}).get(nid) or {}
158
+ if e.get("layer") in ("rejected", "unresolved"):
159
+ return True
160
+ node = cg.get(nid) or {}
161
+ fm = node.get("frontmatter") or {}
162
+ return str(fm.get("verification_state") or "").lower() == "falsified"
163
+
164
+
165
+ def main() -> int:
166
+ ap = argparse.ArgumentParser(
167
+ description="《秤》5.2 退役纪律探针(隔离 temp root;确定性输出)")
168
+ ap.add_argument("--out", default=None,
169
+ help="输出目录(可选;必须落在仓外)")
170
+ a = ap.parse_args()
171
+
172
+ if a.out:
173
+ assert_outside_repo(a.out)
174
+
175
+ try:
176
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
177
+ except Exception: # noqa: BLE001
178
+ pass
179
+
180
+ root = tempfile.mkdtemp(prefix="probe_d_")
181
+ steps = {}
182
+ try:
183
+ cg = MdCGOS(root)
184
+
185
+ # ---- 步 1:写 v1 → 查(应见)----
186
+ cg.add(NODE_V1, V1_BODY, layer="knowledge",
187
+ verification_basis="test", importance=0.4)
188
+ r1, s1 = read_face_ids(cg, QUERY), stg_face_ids(cg)
189
+ steps["v1_after_write"] = {"read": NODE_V1 in r1, "stg": NODE_V1 in s1}
190
+
191
+ # ---- 步 2:写矛盾 v2 → 查(应见)----
192
+ cg.add(NODE_V2, V2_BODY, layer="knowledge",
193
+ verification_basis="test", importance=0.4)
194
+ r2, s2 = read_face_ids(cg, QUERY), stg_face_ids(cg)
195
+ steps["v2_after_write"] = {"read": NODE_V2 in r2, "stg": NODE_V2 in s2}
196
+
197
+ # ---- 步 3:退役 v2(active→demoted→archived,合法迁移表)----
198
+ retire = []
199
+ for dst in RETIRE_PATH:
200
+ retire.append(cg.set_state(NODE_V2, dst, reason="探针 D 退役序列",
201
+ actor="probe_d"))
202
+ fm2 = ((cg.get(NODE_V2) or {}).get("frontmatter")) or {}
203
+ steps["retire"] = [{"to": x.get("to"), "ok": bool(x.get("ok")),
204
+ "changed": bool(x.get("changed"))} for x in retire]
205
+
206
+ # ---- 步 4:查(应不见 v2、仍见 v1)----
207
+ r3, s3 = read_face_ids(cg, QUERY), stg_face_ids(cg)
208
+ steps["v2_after_retire"] = {"read": NODE_V2 in r3, "stg": NODE_V2 in s3}
209
+ steps["v1_after_retire"] = {"read": NODE_V1 in r3, "stg": NODE_V1 in s3}
210
+ falsified = wrongly_falsified(cg, NODE_V2)
211
+ state_after = str(fm2.get("lifecycle_state") or "")
212
+ # 退役不删除:节点文件仍在、cg.get 直读仍可达(不计入泄漏面,见模块 docstring)
213
+ direct_readable = bool(cg.get(NODE_V2))
214
+ finally:
215
+ shutil.rmtree(root, ignore_errors=True)
216
+
217
+ faces = ("read", "stg")
218
+
219
+ def _count(step):
220
+ return [sum(1 for f in faces if steps[step][f]), len(faces)]
221
+
222
+ leak = _count("v2_after_retire") # ① 目标 0
223
+ adopt = _count("v2_after_write") # ② 目标 1
224
+ keep_v1 = _count("v1_after_retire") # ③ 目标 1
225
+ misjudged = [1 if falsified else 0, 1] # ④ 目标 0
226
+
227
+ # ---- 人读读数 ----
228
+ print("退役序列(active→demoted→archived):%s"
229
+ % json.dumps(steps["retire"], ensure_ascii=False))
230
+ print("节点终态:%s(退役后 cg.get 直读可达=%s——退役不删除,不计入泄漏面)"
231
+ % (state_after or "(缺)", direct_readable))
232
+ print("① 退役泄漏率:%d/%d(面=%s;目标 0)"
233
+ % (leak[0], leak[1], "/".join(faces)))
234
+ print("② 更新采纳率:%d/%d(v2 写入后可见面;目标 %d)"
235
+ % (adopt[0], adopt[1], adopt[1]))
236
+ print("③ 旧事实残留率:%d/%d(退役后 v1 仍在面;目标 %d)"
237
+ % (keep_v1[0], keep_v1[1], keep_v1[1]))
238
+ print("④ 失效误判证伪率:%d/%d(退役 ≠ 证伪;目标 0)"
239
+ % (misjudged[0], misjudged[1]))
240
+
241
+ if a.out:
242
+ os.makedirs(a.out, exist_ok=True)
243
+ detail = {"query": QUERY, "steps": steps, "state_after_retire": state_after,
244
+ "direct_readable": direct_readable,
245
+ "leak": {"num": leak[0], "den": leak[1]},
246
+ "adoption": {"num": adopt[0], "den": adopt[1]},
247
+ "v1_residue": {"num": keep_v1[0], "den": keep_v1[1]},
248
+ "wrong_falsified": {"num": misjudged[0], "den": misjudged[1]}}
249
+ with open(os.path.join(a.out, "rates.json"), "w",
250
+ encoding="utf-8", newline="\n") as f:
251
+ json.dump(detail, f, ensure_ascii=False, indent=2, sort_keys=True)
252
+ f.write("\n")
253
+
254
+ # ---- 机器可读摘要(末行;键序固定 ⇒ 同输入同字节)----
255
+ summary = {"leak": leak, "adoption": adopt, "v1_residue": keep_v1,
256
+ "wrong_falsified": misjudged}
257
+ print("PROBE_D_JSON " + json.dumps(summary, ensure_ascii=False,
258
+ sort_keys=True))
259
+ return 0
260
+
261
+
262
+ if __name__ == "__main__":
263
+ sys.exit(main())