@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,298 @@
1
+ # -*- coding: utf-8 -*-
2
+ """资料树(档 1):把散落节点聚合成**可召回的一等节点**——人物 / 地点 / 事件。
3
+
4
+ 判据(使用者 2026-11-12):人物·地点·时间·事件是核心状态;物品与情绪是辅助(只进 facet,不建树)。
5
+
6
+ 为什么必须写成**真节点**而不是渲染期拼装:外测归因(弱项 19 题)证明「要素不在 pack」——
7
+ 单点事实(姓名/年龄/职业)散在某几轮原话里,召回不命中。资料卡的价值是**给单点事实造一个
8
+ 稠密的可召回容器**:查询提到「沈知夏」时,一张 20 字的卡同时带着姓名/年龄/职业。
9
+
10
+ 设计约束:
11
+ · **增量 + 幂等**:重跑只在内容真的变了才写(按渲染结果逐字比对);
12
+ · **只增不改事实**:事实行按 (日期, 节点 id) 稳定排序,新增节点只会追加行;
13
+ · **不判断真假/归属**:抽取只产候选(见 entities),本层只做聚合与去重;
14
+ · **辅助面只进 tags**:`obj:` / `emo:` 前缀标签,用于辅助检索,不参与状态。
15
+
16
+ 节点命名(可预测、可回查):
17
+ profile:person:<人名> profile:place:<地点> profile:event:<YYYY-MM-DD>
18
+
19
+ 不适用条件:实体抽取为确定性规则(见 entities 的不适用条件);同一人多名(昵称/全名)不合并;
20
+ 跨人物同名歧义不消解。
21
+ """
22
+ from __future__ import annotations
23
+
24
+ import hashlib
25
+ import os
26
+ import time
27
+
28
+ from . import distill as _dis
29
+ from . import dossier as _dos
30
+ from . import entities as _en
31
+
32
+ # 落盘 id 只允许 ^[A-Za-z0-9_.@\u4e00-\u9fff,-]{1,128}$(**冒号非法**,会拼进路径),
33
+ # 故用 `profile-<kind>-<slug>` 形态;实体名里的非法字符按 _ 归一。
34
+ PREFIX = "profile-"
35
+ #: 角色名(闭集):未配置则为空串 ⇒ 不建角色卡(不猜名字)。
36
+ _ROLE_USER = (os.environ.get("MDCG_ROLE_USER") or "").strip()
37
+ _ROLE_AI = (os.environ.get("MDCG_ROLE_AI") or "").strip()
38
+ LAYER = "knowledge"
39
+
40
+ #: 渲染时单条事实的最大字数(资料卡要稠密,不能变成原文堆)。
41
+ SNIPPET_MAX = 60
42
+ #: 单个资料卡最多保留的事实条数(超出按最近保留)。
43
+ MAX_FACTS = 40
44
+
45
+
46
+ # 生效条件:s 为任意实体名;返回只含合法 node_id 字符的 slug(长度 ≤48)
47
+ def _slug(s):
48
+ out = []
49
+ for ch in str(s or ""):
50
+ if ch.isalnum() or ch in "_.@,-" or "\u4e00" <= ch <= "\u9fff":
51
+ out.append(ch)
52
+ else:
53
+ out.append("_")
54
+ return "".join(out)[:48] or "x"
55
+
56
+
57
+ # 生效条件:kind ∈ {person, place, event}、name 为实体名;返回资料卡节点 id(可预测,便于回查与幂等覆写)
58
+ def card_id(kind, name):
59
+ return "%s%s-%s" % (PREFIX, kind, _slug(name))
60
+
61
+
62
+ # 生效条件:text 为正文;返回压成单行的片段(去换行/去 CCG 头,截 SNIPPET_MAX)
63
+ def _snippet(text):
64
+ lines = [l.strip() for l in str(text or "").splitlines()]
65
+ body = [l for l in lines if l and not l.startswith("#")]
66
+ return (" ".join(body) or "")[:SNIPPET_MAX]
67
+
68
+
69
+ # 生效条件:facts 为 [(日期, 节点id, 片段)];返回渲染后的资料卡正文(CCG 六要素 + 事实序列)
70
+ def render(kind, name, facts, dossier=None):
71
+ title = {"role": "角色资料", "person": "人物资料", "place": "地点资料", "event": "事件资料"}[kind]
72
+ head = [
73
+ "# 功能名:%s:%s" % (title, name),
74
+ "# 生效条件:查询提到「%s」或其属性(姓名/年龄/职业/地点/日期)时" % name,
75
+ "# 子功能:① 事实序列(按日期升序,每条带来源节点)",
76
+ "# 执行:由 profiles.build 从既有节点确定性聚合(无模型抽取)",
77
+ "# 验证方式:tests/test_profiles.py",
78
+ "# 不适用条件:正文未出现的属性不在本卡;同名不合并",
79
+ "",
80
+ ]
81
+ #: 档案字段的展示顺序(基本信息 → 身份职业 → 家庭)
82
+ _ORDER = ("姓名", "年龄", "城市", "职业", "单位", "学历", "专业",
83
+ "父", "母", "配偶", "子女")
84
+ _LIST_ORDER = ("经历", "家庭")
85
+ body = []
86
+ if dossier:
87
+ body.append(dept_line := "【档案】")
88
+ for k in _ORDER:
89
+ v = dossier.get(k)
90
+ if v in (None, "", [], {}):
91
+ continue
92
+ # 形态容错:标量可能是 {value,t} 也可能是裸值(写入方不止一个)。
93
+ _vv = v.get("value") if isinstance(v, dict) else v
94
+ _tt = v.get("t") if isinstance(v, dict) else None
95
+ _stamp = ""
96
+ if _tt:
97
+ try:
98
+ _stamp = "(%s)" % time.strftime("%Y-%m", time.localtime(float(_tt)))
99
+ except (TypeError, ValueError, OSError):
100
+ _stamp = ""
101
+ body.append("- %s:%s%s" % (k, _vv, _stamp))
102
+ for k in _LIST_ORDER:
103
+ v = dossier.get(k)
104
+ # 形态容错:{"value": [...]} / 裸 list / 裸字符串 三种都认。
105
+ if isinstance(v, list):
106
+ items = v
107
+ elif isinstance(v, dict):
108
+ items = v.get("value") or []
109
+ if isinstance(items, str):
110
+ items = [items]
111
+ elif isinstance(v, str):
112
+ items = [v]
113
+ else:
114
+ items = []
115
+ if not items:
116
+ continue
117
+ body.append("【%s】" % k)
118
+ for it in items:
119
+ if isinstance(it, dict):
120
+ # 跳过 `_raw` 这类内部证据键(键名以 _ 开头),不要把证据片段渲染成值
121
+ parts = [str(x) for _kk, x in it.items()
122
+ if not str(_kk).startswith("_")
123
+ and x not in (None, "")]
124
+ txt = " | ".join(parts)
125
+ else:
126
+ txt = str(it)
127
+ if txt.strip():
128
+ body.append("- " + txt)
129
+ body.append("")
130
+ for date, nid, snip in facts:
131
+ body.append("- %s | %s(来源 %s)" % (date or "日期不明", snip, nid))
132
+ return "\n".join(head + body) + "\n"
133
+
134
+
135
+ # 生效条件:cg 提供 index/get/add;返回 {"scanned", "cards", "written", "skipped", "facts"}
136
+ def build(cg, dry_run=True, limit=None):
137
+ """扫描既有节点 → 按实体聚合 → 写成资料卡(幂等;dry_run 只算不写)。"""
138
+ from . import reldate
139
+ nodes = (cg.index.get("nodes") or {})
140
+ buckets = {} # (kind, name) -> [(date, nid, snippet)]
141
+ _declared_nids = set() # 带 diary 声明的来源节点(用于卡来源标记)
142
+ st = {"scanned": 0, "cards": 0, "written": 0, "skipped": 0, "facts": 0,
143
+ "dry_run": bool(dry_run), "declared": 0, "extracted": 0}
144
+ for nid, e in list(nodes.items()):
145
+ if str(nid).startswith(PREFIX):
146
+ continue
147
+ if limit and st["scanned"] >= int(limit):
148
+ break
149
+ node = cg.get(nid)
150
+ if not node:
151
+ continue
152
+ st["scanned"] += 1
153
+ fm = node.get("frontmatter") or {}
154
+ content = node.get("content") or ""
155
+ ts = fm.get("created_at")
156
+ day = ""
157
+ if ts is not None:
158
+ try:
159
+ day = time.strftime("%Y-%m-%d", time.localtime(float(ts)))
160
+ except (TypeError, ValueError, OSError):
161
+ day = ""
162
+ tags = fm.get("tags") or []
163
+ snip = _snippet(content)
164
+ # 【情景层 v0.1】diary 声明优先:角色名是闭集,由写入声明(零抽取)。
165
+ # 外测实证:靠正则猜名字会抽出 profile-person-号你 这类错卡,正确卡反被淹没。
166
+ diary = fm.get("diary") if isinstance(fm.get("diary"), dict) else None
167
+ if diary:
168
+ _declared_nids.add(nid)
169
+ day = str(diary.get("date") or day or "")
170
+ for key in ("speaker", "listener"):
171
+ v = str(diary.get(key) or "").strip()
172
+ if v:
173
+ buckets.setdefault(("role", v), []).append((day, nid, snip))
174
+ for pp in (diary.get("participants") or []):
175
+ v = str(pp or "").strip()
176
+ if v and _en.gate_name(v):
177
+ buckets.setdefault(("person", v), []).append((day, nid, snip))
178
+ pl = str(diary.get("place") or "").strip()
179
+ if pl:
180
+ buckets.setdefault(("place", pl), []).append((day, nid, snip))
181
+ if day:
182
+ buckets.setdefault(("event", day), []).append((day, nid, snip))
183
+ continue
184
+ # 【外测实证 2026-11-12】只传 diary 的节点极少时,role/person 卡会**完全不产出**,
185
+ # 注入就只能塞事件卡(对属性题无用)。故补一条**角色兜底**:
186
+ # 节点带 role=user/assistant 且配置了角色名(MDCG_ROLE_USER / MDCG_ROLE_AI)⇒ 归到角色卡。
187
+ # 未配置则不做——**不猜角色名**。
188
+ _role = str(fm.get("role") or "").strip().lower()
189
+ if _role in ("user", "assistant"):
190
+ _rname = ((os.environ.get("MDCG_ROLE_USER") or _ROLE_USER).strip()
191
+ if _role == "user" else
192
+ (os.environ.get("MDCG_ROLE_AI") or _ROLE_AI).strip())
193
+ if _rname:
194
+ buckets.setdefault(("role", _rname), []).append((day, nid, snip))
195
+ # 回落:无 diary 的存量节点按确定性抽取(卡标 extracted,与 declared 不混报)
196
+ for name in _en.persons(content, tags):
197
+ buckets.setdefault(("person", name), []).append((day, nid, snip))
198
+ for name in _en.places(content, tags):
199
+ buckets.setdefault(("place", name), []).append((day, nid, snip))
200
+ if day and any(k in content for k in ("约定", "约好", "碰面", "聚餐", "改期", "会议")):
201
+ buckets.setdefault(("event", day), []).append((day, nid, snip))
202
+ for (kind, name), facts in sorted(buckets.items()):
203
+ # 去重 + 稳定排序(日期, 节点 id)⇒ 增量:新节点只会往后追加
204
+ seen, uniq = set(), []
205
+ for f in sorted(facts, key=lambda x: (x[0] or "", x[1])):
206
+ if f[1] in seen:
207
+ continue
208
+ seen.add(f[1])
209
+ uniq.append(f)
210
+ uniq = uniq[-MAX_FACTS:]
211
+ # 档案:从本卡来源节点里抽字段并增量合并(只对 role/person 卡建)
212
+ # 【外测 2026-11-12】必须扫**未截断的全量 facts**:早期自我介绍(w=3)曾因
213
+ # MAX_FACTS 窗口只保留最近 N 条而被丢弃 ⇒ 卡的档案里只剩弱证据的误填。
214
+ _dos_all = {}
215
+ if kind in ("role", "person"):
216
+ _seen_dos = set()
217
+ for _d, _nid, _snip in facts:
218
+ if _nid in _seen_dos:
219
+ continue
220
+ _seen_dos.add(_nid)
221
+ _n = cg.get(_nid) or {}
222
+ _fm = _n.get("frontmatter") or {}
223
+ # ① 先并入**声明/LLM 填表**的档案(fm.dossier,带 ev_span、经原文复核)
224
+ # 档案可能落在 fm.dossier,也可能被未知 kwarg 收进 fm.extra.dossier,
225
+ # 两处都读(口径单点:先顶层,后 extra)。
226
+ _dec = _fm.get("dossier")
227
+ if not isinstance(_dec, dict):
228
+ _dec = (_fm.get("extra") or {}).get("dossier")
229
+ # ② 再补**规则抽取**的档案(LLM 没填的字段由规则兜底;不覆盖已有值)
230
+ _rule = _dos.extract(_n.get("content") or "", _fm.get("created_at"), _nid)
231
+ # 【证据权重】自我介绍/声明的条目权重大于泛提;合并时弱者不得覆盖强者。
232
+ _w = _dos.weight_of(_n.get("content") or "")
233
+ for _fk, _fv in _rule.items():
234
+ _fv = dict(_fv)
235
+ _fv["w"] = _w
236
+ if _fk == "城市" and not _dis.is_place(_fv.get("value")):
237
+ continue # 合并期同样过地名闸(旧节点可能绕过写入期复核)
238
+ _dos_all = _dos.merge(_dos_all, {_fk: _fv})
239
+ # 声明/LLM 填表的档案同样按该节点权重入账
240
+ if isinstance(_dec, dict) and _dec:
241
+ for _fk, _fv in _dec.items():
242
+ if _fk.startswith("_"):
243
+ continue
244
+ _fv = dict(_fv) if isinstance(_fv, dict) else {"value": _fv}
245
+ _fv.setdefault("w", _w)
246
+ if _fk == "城市" and not _dis.is_place(_fv.get("value")):
247
+ continue # 声明/LLM 的旧档案也过闸
248
+ _dos_all = _dos.merge(_dos_all, {_fk: _fv})
249
+ st["cards"] += 1
250
+ st["facts"] += len(uniq)
251
+ text = render(kind, name, uniq, dossier=_dos_all)
252
+ nid = card_id(kind, name)
253
+ prev = cg.get(nid)
254
+ if prev and (prev.get("content") or "") == text:
255
+ st["skipped"] += 1
256
+ continue
257
+ if dry_run:
258
+ continue
259
+ # 辅助面(物品/情绪)只进 tags:用于辅助检索,不参与状态
260
+ aux = _en.auxiliary(" ".join(f[2] for f in uniq))
261
+ tags = ["%s%s" % (kind, ":" + name if kind != "event" else ""),
262
+ "profile", "%s:%s" % (kind, name)]
263
+ _src = "declared" if any(nid in _declared_nids for _d, nid, _s in uniq) else "extracted"
264
+ st[_src] = st.get(_src, 0) + 1
265
+ tags.append("card_source:" + _src)
266
+ tags += ["obj:" + o for o in aux["objects"][:8]]
267
+ tags += ["emo:" + w for w in aux["emotions"][:5]]
268
+ # created_at 只在**已有卡**时透传(保持出生时刻);新卡交给 add 取 now。
269
+ # 传 None 会落到 add 的观测窗锚点计算上(`None + float` 直接炸)。
270
+ # 【外测请求 #2/#3】卡的 created_at 不能是**建卡时刻**:库历史到 2026-05、卡却落在 2026-11-11,
271
+ # 桶/日路径因此 bucket=0,卡只能靠词法进——而词法长句只给 1 条。
272
+ # 现取**最早事实日**(有 diary.date 就用它),并把它换算成时刻;推不出则不传(交给 add 取 now)。
273
+ _dates = sorted(f[0] for f in uniq if f[0])
274
+ _first_day = _dates[0] if _dates else ""
275
+ _kw = {"layer": LAYER, "tags": tags, "importance": 0.6,
276
+ "consistency": False}
277
+ # session 继承:取来源节点里出现最多的 session(多人物隔离时卡才不会被 session 过滤掉)。
278
+ import time as _t
279
+ _sess = {}
280
+ for _f in uniq:
281
+ _n = cg.get(_f[1]) or {}
282
+ _s = ((_n.get("frontmatter") or {}).get("session"))
283
+ if _s:
284
+ _sess[_s] = _sess.get(_s, 0) + 1
285
+ if _sess:
286
+ _kw["session"] = sorted(_sess.items(), key=lambda x: -x[1])[0][0]
287
+ _prev_has_ts = (((prev or {}).get("frontmatter") or {}).get("created_at") is not None)
288
+ if _first_day and not _prev_has_ts:
289
+ try:
290
+ _kw["created_at"] = _t.mktime(_t.strptime(_first_day, "%Y-%m-%d"))
291
+ except ValueError:
292
+ pass
293
+ _prev_ts = ((prev or {}).get("frontmatter") or {}).get("created_at")
294
+ if _prev_ts is not None:
295
+ _kw["created_at"] = _prev_ts
296
+ cg.add(nid, text, **_kw)
297
+ st["written"] += 1
298
+ return st
package/md_cg/protocol.py CHANGED
@@ -196,7 +196,13 @@ VERB_SPECS = {
196
196
  # (持久验证状态)**语义不同**,同一条可同时是 ACCEPT + unverified。
197
197
  "entry_required": ("id", "score", "state", "tokens", "content",
198
198
  "frontmatter", "provenance", "metadata"),
199
- "entry_optional": ("truncated",),
199
+ # created_at_date(2026-11-12):pack 条目的**格式化日期**(YYYY-MM-DD)。
200
+ # 存在理由:`frontmatter.created_at` 是 epoch 浮点,下游 `str(v)[:10]` 会截出
201
+ # `1784043360` 这种假日期(外测脚手架真实踩过)。此字段是唯一正确格式化的出口。
202
+ # content_dated(2026-11-12):正文里相对日期**内联补绝对日期**的版本
203
+ # (「上周五」→「上周五(2026-11-06)」)。存在理由:平行章节会被模型忽略,
204
+ # 只有正文内联标注才会被读到;换算必须由算法做,不能交给模型。
205
+ "entry_optional": ("truncated", "created_at_date", "content_dated"),
200
206
  "entry_metadata_required": ("state", "reason", "verification_state"),
201
207
  "entry_metadata_optional": ("verification_basis", "check_strength",
202
208
  "derived_from", "derived_relation",
@@ -0,0 +1,142 @@
1
+ # -*- coding: utf-8 -*-
2
+ """相对日期绝对化——把文本里的「上周五」补成「上周五(2026-11-06)」。
3
+
4
+ 判据(使用者 2026-11-12 定):**所有相对日期后,用确定性规则补绝对日期。**
5
+
6
+ 为什么必须由算法做、且必须内联在正文里:
7
+ · 外测实证(Ornn8 B 类):模型面对「周一/昨天」这类相对表述会照抄,不换算;
8
+ 状态视图那节明明给了绝对日期,判官仍写「只按周一/昨天相对表述,未给出具体日期」
9
+ ——**平行章节会被忽略,只有正文里的内联标注才会被读到**。
10
+ · 整条路线的立足点就是「时序归纳不该由模型做」,相对日期换算同理。
11
+
12
+ 确定性规则(全部以**陈述时刻**为锚,即节点 created_at;不用"今天"):
13
+ 今天/今日 0 · 昨天/昨日 −1 · 前天 −2 · 大前天 −3 · 明天 +1 · 后天 +2
14
+ N 天前/N 天后(中文数字或阿拉伯数字)
15
+ 上周X/这周X/本周X/下周X(X = 一二三四五六日天,周一为周首)
16
+ 上个月/下个月(按整月区间标注)
17
+
18
+ 不适用与边界(不猜):
19
+ · 锚点缺失或不可解析 ⇒ 原样返回,不标注;
20
+ · 文本里已有紧随其后的(YYYY-MM-DD)⇒ 跳过(幂等,重复调用不叠加);
21
+ · 无年份的裸「周五」不标注(可属任一周,标了就是编造);
22
+ · 「上周」「今年」这类区间只在能确定起止时标注,否则不动。
23
+ """
24
+ from __future__ import annotations
25
+
26
+ import datetime as _dt
27
+ import re
28
+
29
+ _CN_NUM = {"一": 1, "二": 2, "两": 2, "三": 3, "四": 4, "五": 5, "六": 6, "七": 7,
30
+ "八": 8, "九": 9, "十": 10}
31
+ _CN_NUM.update({"十" + c: 10 + v for c, v in zip("一二三四五六七八九", range(1, 10))})
32
+ _CN_NUM.update({"二十": 20, "二十一": 21, "二十二": 22, "二十三": 23, "二十四": 24,
33
+ "二十五": 25, "二十六": 26, "二十七": 27, "二十八": 28,
34
+ "二十九": 29, "三十": 30, "三十一": 31})
35
+
36
+ _WD = {"一": 0, "二": 1, "三": 2, "四": 3, "五": 4, "六": 5, "日": 6, "天": 6}
37
+
38
+ _FIXED = (("大前天", -3), ("大后天", 3), ("前天", -2), ("后天", 2),
39
+ ("昨天", -1), ("昨日", -1), ("今天", 0), ("今日", 0),
40
+ ("明天", 1), ("明日", 1))
41
+
42
+ # 【issue #875】必须带**左边界**并放宽到 3 位:早先 `\d{1,2}` 无边界,
43
+ # 「120天前」会跳过首位匹配成「20天前」,把 20 交给换算器 ⇒ **交付确定但错误的日期**。
44
+ # 左边界同时挡住中文数字(「一百二十天前」不该被当成「二十天前」)。
45
+ _NDAY = re.compile(r"(?<![\d一二两三四五六七八九十百零])"
46
+ r"(\d{1,3}|[一二两三四五六七八九十]{1,3})\s*天\s*([前后])")
47
+ # 左边界挡「以上周四」这类非时间用法(与 _NDAY 同思路)。
48
+ _WEEKX = re.compile(r"(?<![以每本这])(上|这|本|下)\s*(?:个)?\s*周\s*([一二三四五六日天])")
49
+ # 左边界挡「以下月份」、右边界挡「月**份**」——那都不是相对月份,标了就是编造。
50
+ _MONTH = re.compile(r"(?<![以每半])(上|下)\s*个?\s*月(?![份])")
51
+ _ANNOTATED = re.compile(r"^\s*[((]\d{4}-\d{2}-\d{2}[))]")
52
+
53
+
54
+ def _num(s):
55
+ """中文/阿拉伯数字 → int;不能解析返回 None。"""
56
+ s = (s or "").strip()
57
+ if not s:
58
+ return None
59
+ if s.isdigit():
60
+ return int(s)
61
+ return _CN_NUM.get(s)
62
+
63
+
64
+ def anchor_date(ts):
65
+ """陈述时刻 → date;不可解析返回 None(**不猜今天**)。"""
66
+ if ts is None:
67
+ return None
68
+ try:
69
+ return _dt.datetime.fromtimestamp(float(ts)).date()
70
+ except (TypeError, ValueError, OSError, OverflowError):
71
+ return None
72
+
73
+
74
+ def _resolve(expr, base):
75
+ """单个相对表达式 → (起始 date, 结束 date);区间表达式起止不同,点日期相同。"""
76
+ for word, delta in _FIXED:
77
+ if expr == word:
78
+ d = base + _dt.timedelta(days=delta)
79
+ return (d, d)
80
+ m = _NDAY.fullmatch(expr)
81
+ if m:
82
+ n = _num(m.group(1))
83
+ # 【issue #875】范围闸:只支持 1..3660 天(10 年)。超范围/不可解析 ⇒ 不标注,
84
+ # 宁缺不错——本模块的价值在「确定性」,给出错日期比不标注更坏。
85
+ if not n or n < 1 or n > 3660:
86
+ return None
87
+ d = base + _dt.timedelta(days=(-n if m.group(2) == "前" else n))
88
+ return (d, d)
89
+ m = _WEEKX.fullmatch(expr)
90
+ if m:
91
+ rel = {"上": -1, "这": 0, "本": 0, "下": 1}[m.group(1)]
92
+ monday = base - _dt.timedelta(days=base.weekday())
93
+ d = monday + _dt.timedelta(days=7 * rel + _WD[m.group(2)])
94
+ return (d, d)
95
+ m = _MONTH.fullmatch(expr)
96
+ if m:
97
+ y, mo = base.year, base.month + (-1 if m.group(1) == "上" else 1)
98
+ y, mo = (y + (mo - 1) // 12, (mo - 1) % 12 + 1)
99
+ first = _dt.date(y, mo, 1)
100
+ nxt = _dt.date(y + (mo // 12), mo % 12 + 1, 1)
101
+ return (first, nxt - _dt.timedelta(days=1))
102
+ return None
103
+
104
+
105
+ def _fmt(span):
106
+ a, b = span
107
+ if a == b:
108
+ return a.isoformat()
109
+ return "%s~%s" % (a.isoformat(), b.isoformat())
110
+
111
+
112
+ def annotate(text, ts):
113
+ """在相对日期后**内联**补(YYYY-MM-DD)——幂等;锚点不可解析则原样返回。"""
114
+ body = str(text or "")
115
+ base = anchor_date(ts)
116
+ if not body or base is None:
117
+ return body
118
+ hit = []
119
+ for word, _delta in _FIXED:
120
+ for m in re.finditer(re.escape(word), body):
121
+ hit.append((m.start(), m.end(), word))
122
+ for rx in (_NDAY, _WEEKX, _MONTH):
123
+ for m in rx.finditer(body):
124
+ hit.append((m.start(), m.end(), m.group(0)))
125
+ if not hit:
126
+ return body
127
+ hit.sort(key=lambda x: (x[0], -(x[1] - x[0])))
128
+ picked, last_end = [], -1
129
+ for st, en, expr in hit:
130
+ if st < last_end:
131
+ continue
132
+ picked.append((st, en, expr))
133
+ last_end = en
134
+ out, cursor = [], 0
135
+ for st, en, expr in picked:
136
+ out.append(body[cursor:en])
137
+ span = _resolve(expr, base)
138
+ if span is not None and not _ANNOTATED.match(body[en:en + 16]):
139
+ out.append("(%s)" % _fmt(span))
140
+ cursor = en
141
+ out.append(body[cursor:])
142
+ return "".join(out)
@@ -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 才追加 "…",返回该字符串。
@@ -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