@furongjun1999/dsh-memory 0.9.22 → 0.10.1

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 (179) hide show
  1. package/CHANGELOG.en.md +450 -0
  2. package/CHANGELOG.md +112 -0
  3. package/README.en.md +244 -0
  4. package/README.md +272 -260
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/README.md +2 -0
  7. package/docs/discipline/templates/full.md.tmpl +1 -1
  8. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  9. package/docs/en/README.md +190 -0
  10. package/docs/en/TRANSLATION.md +78 -0
  11. package/docs/en/TRANSLATION_MANIFEST.json +170 -0
  12. package/docs/en/TRANSLATION_REPORT.md +11 -0
  13. package/docs/en/dev/README.md +10 -0
  14. package/docs/en/dev/coding-testing.md +72 -0
  15. package/docs/en/dev/switch-matrix.md +10 -0
  16. package/docs/en/glossary.md +97 -0
  17. package/docs/en/harnesses/claude.md +100 -0
  18. package/docs/en/harnesses/codebuddy.md +93 -0
  19. package/docs/en/harnesses/codex.md +88 -0
  20. package/docs/en/harnesses/dsh.md +84 -0
  21. package/docs/en/harnesses/zcode.md +42 -0
  22. package/docs/en/mdcg/ccg.md +32 -0
  23. package/docs/en/mdcg/generated-docs.md +20 -0
  24. package/docs/en/mdcg/guardrail-charter.md +170 -0
  25. package/docs/en/mdcg/mcp-tool-names.md +43 -0
  26. package/docs/en/mdcg/multi-harness.md +43 -0
  27. package/docs/en/mdcg/recall-metadata.md +30 -0
  28. package/docs/en/mdcg/world-model-endpoint.md +379 -0
  29. package/docs/en/mdcg/write-aliases.md +130 -0
  30. package/docs/en/ops/README.md +11 -0
  31. package/docs/en/ops/environment-known-issues.md +244 -0
  32. package/docs/en/ops/install.md +72 -0
  33. package/docs/en/ops/operations-troubleshooting.md +86 -0
  34. package/docs/en/ops/permissions-review.md +79 -0
  35. package/docs/en/ops/release-governance.md +49 -0
  36. package/docs/en/ops/tool-name-migration.md +30 -0
  37. package/docs/en/ops/ui-install-troubleshooting.md +53 -0
  38. package/docs/en/standards/ai-coding-standard-checklist.md +71 -0
  39. package/docs/en/standards/ai-coding-standard-lingshu.md +47 -0
  40. package/docs/en/standards/ai-coding-standard.md +185 -0
  41. package/docs/en/ui/minimal.md +62 -0
  42. package/docs/mdcg/cogmap_ops.md +16 -15
  43. package/lib/client.js +29 -3
  44. package/lib/hooks.d.ts +34 -0
  45. package/lib/hooks.js +167 -33
  46. package/lib/index.js +19 -3
  47. package/lib/lib/console_web.mjs +30 -3
  48. package/lib/lib/hook_audit.d.ts +3 -2
  49. package/lib/lib/hook_audit.js +14 -4
  50. package/lib/lib/mdcg_client.d.ts +5 -2
  51. package/lib/lib/mdcg_client.js +8 -4
  52. package/lib/lib/prompt_safety.d.ts +24 -0
  53. package/lib/lib/prompt_safety.js +77 -1
  54. package/lib/lib/token_store.js +5 -2
  55. package/lib/tools.js +5 -3
  56. package/md_cg/bucketindex.py +231 -0
  57. package/md_cg/bucketscope.py +339 -0
  58. package/md_cg/config_registry_bulk.py +19 -10
  59. package/md_cg/config_validate.py +14 -2
  60. package/md_cg/detrerank.py +137 -0
  61. package/md_cg/fsutil.py +215 -25
  62. package/md_cg/govern/__init__.py +23 -0
  63. package/md_cg/iface/__init__.py +46 -0
  64. package/md_cg/iface/_verify.py +609 -0
  65. package/md_cg/iface/contracts.py +337 -0
  66. package/md_cg/judgment_manifest.py +14 -0
  67. package/md_cg/kernel/__init__.py +27 -0
  68. package/md_cg/mcp_server.py +457 -23
  69. package/md_cg/mdcg.py +1034 -79
  70. package/md_cg/mdcos.py +263 -21
  71. package/md_cg/metacognition.py +66 -13
  72. package/md_cg/mutate_extract_shipped.py +126 -0
  73. package/md_cg/mutate_ledger_e2e.py +100 -0
  74. package/md_cg/nodefile.py +147 -23
  75. package/md_cg/op_table.py +22 -4
  76. package/md_cg/probe_c_ledger_integrity.py +258 -0
  77. package/md_cg/probe_d_retirement_discipline.py +263 -0
  78. package/md_cg/reconcile.py +9 -11
  79. package/md_cg/review_cli.py +6 -1
  80. package/md_cg/rollback.py +16 -1
  81. package/md_cg/run_tests.py +30 -1
  82. package/md_cg/scopeselect.py +214 -0
  83. package/md_cg/scrub.py +160 -23
  84. package/md_cg/security.py +4 -2
  85. package/md_cg/state_extract.py +149 -0
  86. package/md_cg/state_slots.py +58 -10
  87. package/md_cg/structboost.py +179 -0
  88. package/md_cg/test_alternatives_historical.py +162 -0
  89. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  90. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  91. package/md_cg/test_bucket_cards.py +85 -0
  92. package/md_cg/test_bucket_day_order.py +74 -0
  93. package/md_cg/test_bucket_quota.py +79 -0
  94. package/md_cg/test_bucket_recency_guards.py +75 -0
  95. package/md_cg/test_bucket_three_causes.py +83 -0
  96. package/md_cg/test_bucketindex.py +130 -0
  97. package/md_cg/test_bucketscope_early.py +71 -0
  98. package/md_cg/test_cond_term_fold.py +183 -0
  99. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  100. package/md_cg/test_cond_term_neg_scope.py +147 -0
  101. package/md_cg/test_cond_terms_colon.py +348 -0
  102. package/md_cg/test_detrerank.py +157 -0
  103. package/md_cg/test_gate_four_kpi.py +136 -0
  104. package/md_cg/test_generation_guard.py +76 -43
  105. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  106. package/md_cg/test_issue362_neg_condition.py +44 -7
  107. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  108. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  109. package/md_cg/test_issue444_scrub_evidence_plaintext.py +14 -8
  110. package/md_cg/test_issue677_flush_batch_io.py +139 -0
  111. package/md_cg/test_issue677_info_fast.py +82 -0
  112. package/md_cg/test_issue677_remember_dedupe.py +106 -0
  113. package/md_cg/test_issue712_tokens_sessions_read.py +199 -0
  114. package/md_cg/test_issue722_strict_conditions.py +96 -0
  115. package/md_cg/test_issue730_narrowing_audit.py +121 -0
  116. package/md_cg/test_issue733_verify_override.py +193 -0
  117. package/md_cg/test_issue733_verify_override_and_overwrite_inherit.py +315 -0
  118. package/md_cg/test_issue740_filelock_fd_leak.py +218 -0
  119. package/md_cg/test_issue741_content_hash_same_source.py +158 -0
  120. package/md_cg/test_issue747_slot_contradiction.py +125 -0
  121. package/md_cg/test_issue754_nested_root_guard.py +197 -0
  122. package/md_cg/test_issue757_index_hash_compare.py +85 -0
  123. package/md_cg/test_issue758_disk_hash_single.py +67 -0
  124. package/md_cg/test_issue759_twophase_hash.py +67 -0
  125. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  126. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  127. package/md_cg/test_issue790_verb_negation.py +77 -0
  128. package/md_cg/test_issue810_root_guard.py +71 -0
  129. package/md_cg/test_issue812_info_index_stale.py +78 -0
  130. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  131. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  132. package/md_cg/test_kernel_iface_contracts.py +18 -0
  133. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  134. package/md_cg/test_n204_n205_n226_n227_n228_n229_exit_gates.py +545 -542
  135. package/md_cg/test_n209_verify_write_face_gates.py +5 -2
  136. package/md_cg/test_neg_condition_hits.py +336 -333
  137. package/md_cg/test_probe_cd_shipped.py +385 -0
  138. package/md_cg/test_recent_tail.py +93 -0
  139. package/md_cg/test_run_tests_entry_gates.py +110 -0
  140. package/md_cg/test_scopeselect.py +70 -0
  141. package/md_cg/test_scopeselect_clock.py +70 -0
  142. package/md_cg/test_scrub_source_line_false_positive.py +64 -0
  143. package/md_cg/test_session_attribution_consistency.py +835 -813
  144. package/md_cg/test_state_extract_shipped.py +162 -0
  145. package/md_cg/test_state_ledger_chain.py +207 -0
  146. package/md_cg/test_state_ledger_e2e.py +145 -0
  147. package/md_cg/test_structboost.py +102 -0
  148. package/md_cg/test_timeboost.py +83 -0
  149. package/md_cg/test_timeboost_relativedate.py +71 -0
  150. package/md_cg/test_topicagg.py +129 -0
  151. package/md_cg/test_twophase.py +286 -286
  152. package/md_cg/timeboost.py +223 -0
  153. package/md_cg/tokens.py +55 -7
  154. package/md_cg/topicagg.py +142 -0
  155. package/md_cg/twophase.py +15 -6
  156. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  157. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  158. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  159. package/md_cg/writepipe.py +35 -3
  160. package/package.json +4 -1
  161. package/scripts/workspace_index.py +2 -0
  162. package/src/hooks.ts +182 -34
  163. package/src/index.ts +19 -3
  164. package/src/lib/console_web.mjs +30 -3
  165. package/src/lib/hook_audit.ts +15 -5
  166. package/src/lib/mdcg_client.ts +8 -4
  167. package/src/lib/prompt_safety.ts +73 -1
  168. package/src/lib/token_store.ts +5 -2
  169. package/src/tools.ts +5 -3
  170. package/ui/minimal/integrity.json +2 -2
  171. package/ui/minimal/payload/build-ui.mjs +41 -2
  172. package/ui/minimal/payload/lib/client.js +29 -3
  173. package/ui/minimal/payload/lib/lib/console_web.mjs +30 -3
  174. package/ui/minimal/payload/src/lib/console_web.mjs +30 -3
  175. package/ui/minimal/payload/web/app.js +3 -1
  176. package/ui/minimal/payload/web/client.js +30 -3
  177. package/web/app.js +3 -1
  178. package/web/client.js +30 -3
  179. 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())
@@ -64,15 +64,13 @@ def trace_path(cg) -> str:
64
64
  return os.path.join(cg.root, TRACE_FILE)
65
65
 
66
66
 
67
- # 生效条件:text 为假值(None/"")时按空串处理,返回去尾换行后的字符串(仅剥 "\n")。
68
- def _norm(text: str) -> str:
69
- return (text or "").rstrip("\n")
70
-
71
-
72
- # 生效条件:content(nodefile.loads 切出的盘面正文,含尾换行)非 None 时返回 (content_hash(content), content_hash(_norm(content))) 二元组——**双形态接受集**:add 写路径入索引的指纹按封存原文(mdcg.py `_stage` 面,正文不带尾换行时等于 norm 形态),rebuild 重建路径按 loads 读回原文(带尾换行)——两 producers 各自稳定,diff 两侧都认,否则无尾换行节点会在每次启动被误报漂移(假阳性洪水,twophase._norm 文档串同款教训)。
73
- def _disk_hashes(content: str) -> tuple:
74
- raw = nodefile.content_hash(content or "")
75
- return raw, nodefile.content_hash(_norm(content))
67
+ # 生效条件:content(nodefile.loads 切出的盘面正文,含尾换行)为 str 时返回 nodefile.content_hash(content)(单值)。
68
+ def _disk_hash(content: str) -> str:
69
+ # issue #758(在 #741 之后收单值):content_hash 内部已先 normalize_body(补一个尾换行)再哈希,
70
+ # 与索引条目口径**同源** ⇒ 「双形态接受集」的第二元素(对去尽尾换行的正文再哈希)在常盘形态下
71
+ # 恒等、仅在「≥2 个尾换行」时不等——而**索引侧**已无写点产出该形态(normalize_body 只补不剥) ⇒ 第二元素不可达,收成单值。
72
+ # 副作用(既定意图):收紧了旧容忍面——仅在「索引与盘面形态不一致」(手改/外部写者/#741 前 legacy 条目)时判 drift;经写路径落盘的 ≥2 尾换行两侧一致,不误报,旧行为靠第二元素蒙混。
73
+ return nodefile.content_hash(content or "")
76
74
 
77
75
 
78
76
  # 生效条件:遍历 mdcg.LAYERS 各层目录树(os.walk,与 _scan_nodes 同序同口径),逐个 .md 读取并 nodefile.loads 切分;成功解析的以 nid(fm.get("id") 或文件名去 .md)登入 by_nid(同 nid 后到覆盖,与 _scan_nodes dict 覆盖语义一致)并登记 path_owner[relpath]=nid;读失败(OSError)/解码失败(UnicodeDecodeError)/frontmatter 无闭合(fm 为空且原文以 "---\n" 开头)的登入 problems(kind=read_error/decode_error/frontmatter_unterminated,附 relpath),不进 by_nid 与 path_owner;返回 (by_nid, path_owner, problems)。
@@ -169,9 +167,9 @@ def reconcile_state(cg, apply: bool = True) -> dict:
169
167
  ghost.append(nid) # 盘面无其文件(或已归属他 id)
170
168
  continue
171
169
  d = by_nid[nid]
172
- h_raw, h_norm = _disk_hashes(d["content"])
170
+ h_disk = _disk_hash(d["content"])
173
171
  if entry.get("path") != d["path"] \
174
- or entry.get("content_hash") not in (h_raw, h_norm):
172
+ or entry.get("content_hash") != h_disk:
175
173
  drift.append(nid)
176
174
 
177
175
  # ② 以盘面为基准走一遍:缺索引条目(仅成功解析的真源参与)
@@ -117,7 +117,12 @@ def _cg(args):
117
117
  # 链路断,在役旧读面 `_load_index` 盲信既有快照即 read null。逐条落
118
118
  # 日志后任意退出形态下写入对其它进程立即可见(review_decide 自身的
119
119
  # 显式 flush 只覆盖其目标/审计节点,且与节点文件落盘之间仍有窗口)。
120
- return MdCGSecure(_root(args), principal=p, autoflush=1)
120
+ # 生效条件:以 async_flush=False 构造时,上述「逐条落日志」才是**真的**——
121
+ # #677 P2(2026-10-26)把阈值触发的 flush 挪到后台线程后,只设 autoflush=1
122
+ # 已经不够:`_request_flush` 只 set 事件即返回,写入只是**被调度**、未落盘;
123
+ # 本 CLI 是短命进程,被 kill / 崩溃时后台线程未必跑过 ⇒「任意退出形态可见」
124
+ # 落空(实测:两个 add 后 os._exit,分片日志 0 条)。同步模式把它兑现。
125
+ return MdCGSecure(_root(args), principal=p, autoflush=1, async_flush=False)
121
126
 
122
127
 
123
128
  # 生效条件:rec 支持 .get 时,取 rec.get("content") 为假值则取 rec.get("statement")、再为假值则取空串,把其中的换行替换为空格,并按 width(缺省 66)切片后仅当 len(text) > width 才追加 "…",返回该字符串。
package/md_cg/rollback.py CHANGED
@@ -597,7 +597,22 @@ def rollback_mutation(cg, mutation, reason="", actor=None, force=False,
597
597
  if cur_fp != pre_fp and not force: # 相等=幂等重放,放行(见 docstring)
598
598
  want = mutation.get("after_hash")
599
599
  if isinstance(want, dict):
600
- if cur_fp != want:
600
+ # issue #741 升级兼容:after_hash 是**执行时点持久化**的指纹(decisions.jsonl)。
601
+ # 升级前执行、升级后回滚的单子,其 content_hash 是旧口径(sha 去尾原文),
602
+ # 与「现盘面按新口径重算」的 cur_fp 恒不等 ⇒ 会被误判 drifted_since_execute
603
+ # 而 fail-closed(方向保守但阻塞运维)。此处仅对**旧口径**一次性放行:
604
+ # fm 逐键相等且 content_hash 命中「旧口径 = sha(rstrip 正文)」时才视为未漂移;
605
+ # 真漂移(正文实改)仍不等,照旧 fail-closed。
606
+ _legacy_ok = False
607
+ if (want.get("fm") == cur_fp.get("fm")
608
+ and want.get("content_hash") != cur_fp.get("content_hash")):
609
+ import hashlib as _hl741
610
+ _node741 = _node_of(cg, tgt) or {}
611
+ _legacy741 = _hl741.sha256(
612
+ (_node741.get("content") or "").rstrip("\n").encode("utf-8")
613
+ ).hexdigest()[:12]
614
+ _legacy_ok = (want.get("content_hash") == _legacy741)
615
+ if cur_fp != want and not _legacy_ok:
601
616
  drift = {"ok": False, "error": "drifted_since_execute",
602
617
  "action": act, "target": tgt, "preimage": rel,
603
618
  "current": cur_fp, "expected_after_execute": want,
@@ -203,12 +203,30 @@ def main(argv=None):
203
203
  groups = set(args.group or ()) or set(_known)
204
204
  targets = [(g, n, a) for g, n, a in _discover()
205
205
  if g in groups and (not args.k or args.k in n)]
206
+ # 零选中判定只算一次:--list 与执行路径都要用,两处各自判空会出现两份判断
207
+ #(形态漂移风险,也被守卫 E2 钉住)。
208
+ _no_targets = not targets
206
209
  if args.list:
207
210
  for g, n, _a in targets:
208
211
  print(f"{g:<9}{n}")
209
212
  print(f"共 {len(targets)} 个")
213
+ # --list 是「查看有什么」,零选中给 0,但**必须说明原因**,否则用户看到
214
+ # 「共 0 个」会以为自己拼对了而仓库里真的没有目标(静默缩面)。
215
+ if _no_targets:
216
+ print("无匹配目标:group=%s -k=%r —— 请检查选择器拼写"
217
+ % (sorted(groups), args.k), flush=True)
210
218
  return 0
211
219
 
220
+ # 零选中不得返回 0(与 scripts/run_tests.py 的 #1910 门同口径,2026-11-08 补齐):
221
+ # 本模块是**出货包入口**(安装态没有 scripts/,用户只能 `python -m md_cg.run_tests`),
222
+ # 此前只有 scripts/ 版修过零选中,包内版漏改 ⇒ 安装态用户拼错选择器会看到
223
+ # `SUMMARY 0/0 通过` + rc=0 的假绿。rc=2 与 scripts 版语义保持一致。
224
+ if not targets:
225
+ print("无匹配目标:group=%s -k=%r —— 拒绝以 0/0「通过」收场"
226
+ "(1_ai 会话报告的假绿缺陷(跨仓 #1910))" % (sorted(groups), args.k),
227
+ flush=True)
228
+ return 0 if args.list else 2
229
+
212
230
  # SKIP 探测:依赖缺失/平台不符的测试不执行(外部复核建议 #3,裸 clone 友好)
213
231
  skipped, runnable = [], []
214
232
  for g, n, a in targets:
@@ -233,12 +251,23 @@ def main(argv=None):
233
251
  for ln in tail.splitlines()[-6:]:
234
252
  print(" " + ln, flush=True)
235
253
 
236
- print(f"\n===== SUMMARY {len(runnable) - len(bad)}/{len(runnable)} 通过,"
254
+ _passed = len(runnable) - len(bad)
255
+ print(f"\n===== SUMMARY {_passed}/{len(runnable)} 通过,"
237
256
  f"{len(skipped)} 跳过(依赖缺失/平台不符) =====")
238
257
  print(f"逐用例日志:{_LOG_DIR}")
239
258
  if bad:
240
259
  print("失败:" + ", ".join(bad))
241
260
  return 1
261
+ # 全跳过不得以「通过」收场(2026-11-08,与 scripts/run_tests.py 同口径):
262
+ # 目标选中了却一条都没真跑 ⇒ 没验到任何东西,不能报绿。rc=3 与之保持一致
263
+ # (rc=2 已被本仓占为「有跳过 / 零选中」语义)。
264
+ # 注:本模块的 _run_one 不识别模块内 SKIP(无 issue #284 那条路径),故只看 skipped。
265
+ if _passed == 0 and skipped:
266
+ print("全部跳过:%d 个目标无一真正执行(%d 依赖/平台跳过)"
267
+ % (len(skipped), len(skipped)), flush=True)
268
+ print("拒绝以 0 执行「通过」收场(与 #1910 零选中、#284 SKIP 冒充 PASS 同族)。",
269
+ flush=True)
270
+ return 3
242
271
  return 0
243
272
 
244
273