@furongjun1999/dsh-memory 0.10.1 → 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.
- package/CHANGELOG.en.md +65 -0
- package/CHANGELOG.md +642 -516
- package/README.en.md +1 -1
- package/README.md +2 -2
- package/docs/mdcg/cogmap_ops.md +15 -13
- package/lib/tools.d.ts +2 -2
- package/md_cg/bucketscope.py +36 -18
- package/md_cg/cohesion.py +337 -0
- package/md_cg/config_registry_bulk.py +5 -0
- package/md_cg/constraint_audit.py +231 -0
- package/md_cg/constraint_watch.py +206 -0
- package/md_cg/context_audit.py +240 -0
- package/md_cg/context_plan.py +142 -0
- package/md_cg/distill.py +247 -0
- package/md_cg/dossier.py +151 -0
- package/md_cg/entities.py +133 -0
- package/md_cg/mcp_server.py +60 -7
- package/md_cg/mdcg.py +27 -0
- package/md_cg/mdcos.py +319 -2
- package/md_cg/op_table.py +14 -0
- package/md_cg/profiles.py +298 -0
- package/md_cg/protocol.py +7 -1
- package/md_cg/reldate.py +142 -0
- package/md_cg/selfstmt.py +139 -0
- package/md_cg/state_slots.py +4 -0
- package/md_cg/state_view.py +181 -0
- package/md_cg/sustain.py +28 -2
- package/md_cg/test_alternatives_historical.py +4 -1
- package/md_cg/test_bucket_time_rounds.py +87 -0
- package/md_cg/test_cohesion.py +107 -0
- package/md_cg/test_constraint_audit.py +87 -0
- package/md_cg/test_constraint_watch.py +108 -0
- package/md_cg/test_context_audit.py +110 -0
- package/md_cg/test_context_plan.py +81 -0
- package/md_cg/tokens.py +1 -1
- package/md_cg/version_anchor.py +84 -1
- package/md_cg/whitebox_kb/wisdom/code_solidified.json +6195 -6195
- package/package.json +137 -137
|
@@ -0,0 +1,181 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""状态视图(state_view)——L2 槽位寄存器的**stable 语义 + 多槽位联合投影**。
|
|
3
|
+
|
|
4
|
+
设计依据:`docs/设计_状态账本与终态投影_v0.1.md` §3.2/§3.3,理论依据《智能论 v3.4》
|
|
5
|
+
3.2.2(stable 租约)+ 5.2(混杂系统:连续衰减 dc/dt=-γ(c-c0)、dTTL/dt=-1;
|
|
6
|
+
离散跳变 guard(V_hit, t>TTL, conflict) → transition)。
|
|
7
|
+
|
|
8
|
+
与既有模块的分工(**不新增真源、不复制回放规则**):
|
|
9
|
+
· `state_events` = 账本(append-only 唯一真源,五元结构);
|
|
10
|
+
· `state_slots` = 纯回放投影(value/state/t_from/t_to/alternatives/history),**不判语义**;
|
|
11
|
+
· **本模块** = 在 `state_slots` 之上加一层**租约语义**:
|
|
12
|
+
stable ⟺ (now − t_from) < TTL 且 值非撤回
|
|
13
|
+
超时 ⇒ weak=True(**降级不删除**,值仍返回;3.2.2 P1-003)
|
|
14
|
+
并把同一 subject 的**全部槽位联合给出**(§3.3:多要素题需要一次看到全部当前值)。
|
|
15
|
+
|
|
16
|
+
为什么 TTL 放在这一层而不进 `state_slots`:后者是"回放"语义(同一账本必得同一投影),
|
|
17
|
+
TTL 是"此刻是否仍可信"的**时间相关**判断——混进回放会让历史查询随 wall clock 变化。
|
|
18
|
+
|
|
19
|
+
TTL 取值(**无理论依据,见设计稿 §7 盲区**):
|
|
20
|
+
· 理论只说「由验证单元按条件空间校准」,未给数 ⇒ 本模块用**槽位名启发式**给缺省,
|
|
21
|
+
并允许 `MDCG_STATE_TTL_DAYS` 全局覆盖(单一标量,便于校准实验);
|
|
22
|
+
· 日期/时间类 30d · 地点类 365d · 状态类 7d · 其余 180d。
|
|
23
|
+
这不是"事实",是**可调缺省**;任何读数都要带 TTL 配置一起报。
|
|
24
|
+
|
|
25
|
+
不适用条件:`pending`(未决值)**未实现**——账本行当前不带置信度字段,
|
|
26
|
+
"最后一条断言是否足以改终态"无法从 payload 判出(设计稿 §7 已列此盲区);
|
|
27
|
+
本模块只做「TTL 是否过期」这一条 guard,不臆造冲突判定。
|
|
28
|
+
"""
|
|
29
|
+
from __future__ import annotations
|
|
30
|
+
|
|
31
|
+
import os
|
|
32
|
+
import time
|
|
33
|
+
|
|
34
|
+
from . import state_slots
|
|
35
|
+
|
|
36
|
+
#: 槽位名启发式 → TTL 天数的缺省表(顺序敏感:先命中先返回)。
|
|
37
|
+
_TTL_RULES = (
|
|
38
|
+
(("时间", "日期", "time", "date", "deadline", "截止"), 30),
|
|
39
|
+
(("地点", "地址", "place", "location", "住所", "住址"), 365),
|
|
40
|
+
(("状态", "state", "status", "进度", "progress"), 7),
|
|
41
|
+
)
|
|
42
|
+
#: 兜底 TTL(天)。
|
|
43
|
+
TTL_DEFAULT_DAYS = 180
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
# 生效条件:环境变量 MDCG_STATE_TTL_DAYS 为可解析的正数时返回该值(全局覆盖),否则返回 None
|
|
47
|
+
def _env_ttl():
|
|
48
|
+
raw = (os.environ.get("MDCG_STATE_TTL_DAYS") or "").strip()
|
|
49
|
+
if not raw:
|
|
50
|
+
return None
|
|
51
|
+
try:
|
|
52
|
+
v = float(raw)
|
|
53
|
+
except ValueError:
|
|
54
|
+
return None
|
|
55
|
+
return v if v > 0 else None
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
#: `extra.ttl` 表示「永不过期」的取值(已发生事实:事件时点/交稿日期/获得日)。
|
|
59
|
+
IMMUTABLE_WORDS = ("immutable", "never", "none", "-", "0")
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
# 生效条件:slot 为字符串(可为 None);返回 TTL 天数,**None 表示不可变(永不 weak)**
|
|
63
|
+
def ttl_days_of(slot, kind=None, ttl=None):
|
|
64
|
+
"""槽位租约天数。**判据:这个值会不会被改写**(2026-11 定)。
|
|
65
|
+
|
|
66
|
+
优先级(前者胜):
|
|
67
|
+
① 调用方显式声明 `extra.ttl`:`"immutable"` ⇒ None(永不 weak);数字 ⇒ 该天数;
|
|
68
|
+
② env `MDCG_STATE_TTL_DAYS` 全局覆盖;
|
|
69
|
+
③ `kind == "migration"`(改期/变更)⇒ 30d:承诺类**会**被改写,必须复核;
|
|
70
|
+
④ 槽位名启发式(时间30/地点365/状态7/其余180)。
|
|
71
|
+
|
|
72
|
+
为什么①优先且要支持 immutable:外测实证——「7 月 20 日交的稿」是不可变历史,
|
|
73
|
+
按槽位名(含『日期』)判 30d 会在 9 月查询时被标 weak,判官看到「需核实」反而降分;
|
|
74
|
+
而「尚未寄出」是状态量,45 天后确实可能已变 ⇒ 该标 weak。**槽位名分不出这两类**,
|
|
75
|
+
只有写入方知道,故以显式声明为准,推断只做保守缺省。
|
|
76
|
+
"""
|
|
77
|
+
raw = ttl
|
|
78
|
+
if raw is not None:
|
|
79
|
+
if isinstance(raw, str) and raw.strip().lower() in IMMUTABLE_WORDS:
|
|
80
|
+
return None
|
|
81
|
+
try:
|
|
82
|
+
v = float(str(raw).strip())
|
|
83
|
+
except (TypeError, ValueError):
|
|
84
|
+
v = None
|
|
85
|
+
if v is not None and v > 0:
|
|
86
|
+
return v
|
|
87
|
+
env = _env_ttl()
|
|
88
|
+
if env is not None:
|
|
89
|
+
return env
|
|
90
|
+
if str(kind or "").strip().lower() == "migration":
|
|
91
|
+
return 30.0
|
|
92
|
+
s = str(slot or "").lower()
|
|
93
|
+
for keys, days in _TTL_RULES:
|
|
94
|
+
for k in keys:
|
|
95
|
+
if k in s:
|
|
96
|
+
return float(days)
|
|
97
|
+
return float(TTL_DEFAULT_DAYS)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
# 生效条件:unit 为 state_slots 投影单元(含 value/state/t_from);返回 {weak, age_days, ttl_days, weak_reason}
|
|
101
|
+
def lease_of(unit, now=None):
|
|
102
|
+
"""算一条槽位单元的租约状态(3.2.2 stable 租约)。"""
|
|
103
|
+
now = time.time() if now is None else float(now)
|
|
104
|
+
u = unit or {}
|
|
105
|
+
ttl = ttl_days_of(u.get("slot"), kind=u.get("kind"), ttl=u.get("ttl"))
|
|
106
|
+
t_from = (unit or {}).get("t_from")
|
|
107
|
+
age = None
|
|
108
|
+
if t_from is not None:
|
|
109
|
+
try:
|
|
110
|
+
age = max(0.0, (now - float(t_from)) / 86400.0)
|
|
111
|
+
except (TypeError, ValueError):
|
|
112
|
+
age = None
|
|
113
|
+
weak = False
|
|
114
|
+
reason = None
|
|
115
|
+
if u.get("state") == "retired":
|
|
116
|
+
reason = "retired" # 值已撤回:不是 weak,是"没有当前值"
|
|
117
|
+
elif ttl is None:
|
|
118
|
+
reason = "immutable" # 显式声明不可变:已发生事实,永不 weak
|
|
119
|
+
elif age is None:
|
|
120
|
+
weak, reason = True, "no_timestamp" # 不知道什么时候确认的 ⇒ 不敢当稳定值
|
|
121
|
+
elif age >= ttl:
|
|
122
|
+
weak, reason = True, "ttl_exceeded"
|
|
123
|
+
return {"weak": weak, "weak_reason": reason, "age_days": None if age is None else round(age, 1),
|
|
124
|
+
"ttl_days": ttl}
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
# 生效条件:units 为 state_slots 投影单元列表;返回按 subject 归并的视图(同主体全部槽位联合)
|
|
128
|
+
def build_view(units, now=None):
|
|
129
|
+
"""把槽位单元按 subject 归并成「一个主体一张卡」(设计稿 §3.3)。
|
|
130
|
+
|
|
131
|
+
为什么必须联合给:多要素题(如"周五下午谁收、放哪")要求同一主体
|
|
132
|
+
的时间/参与人/地点**同时在场**;逐槽位分开给等于让模型自己做合成。
|
|
133
|
+
"""
|
|
134
|
+
by_subject = {}
|
|
135
|
+
for u in units or []:
|
|
136
|
+
subj = u.get("subject")
|
|
137
|
+
slot = u.get("slot")
|
|
138
|
+
lease = lease_of(u, now=now)
|
|
139
|
+
card = {
|
|
140
|
+
"value": u.get("value"),
|
|
141
|
+
"state": u.get("state"),
|
|
142
|
+
"t_from": u.get("t_from"),
|
|
143
|
+
"t_to": u.get("t_to"),
|
|
144
|
+
"tier": u.get("tier"),
|
|
145
|
+
"alternatives": u.get("alternatives") or [],
|
|
146
|
+
"event_count": u.get("event_count"),
|
|
147
|
+
"kind": u.get("kind"),
|
|
148
|
+
"ttl_declared": u.get("ttl"),
|
|
149
|
+
**lease,
|
|
150
|
+
}
|
|
151
|
+
by_subject.setdefault(subj, {"subject": subj, "slots": {}, "weak_slots": []})
|
|
152
|
+
by_subject[subj]["slots"][slot] = card
|
|
153
|
+
if lease["weak"]:
|
|
154
|
+
by_subject[subj]["weak_slots"].append(slot)
|
|
155
|
+
out = list(by_subject.values())
|
|
156
|
+
# 稳定排序 + 弱值多的排前面(越需要复核的主体越先看到)
|
|
157
|
+
out.sort(key=lambda c: (-len(c["weak_slots"]), str(c["subject"])))
|
|
158
|
+
return out
|
|
159
|
+
|
|
160
|
+
|
|
161
|
+
# 生效条件:cg 提供 root;返回 {view, units_count, weak_count, ttl_env, now}
|
|
162
|
+
def state_view(cg, subject=None, slot=None, include_retired=False,
|
|
163
|
+
now=None, history=True, limit=None):
|
|
164
|
+
"""读账本 → 回放投影(state_slots)→ 加租约 → 按主体联合。
|
|
165
|
+
|
|
166
|
+
纯只读:不写盘、不建缓存;同一账本 + 同一 now 必得同一结果(可复算)。
|
|
167
|
+
"""
|
|
168
|
+
units = state_slots.project(cg, subject=subject, slot=slot,
|
|
169
|
+
include_retired=include_retired, history=history)
|
|
170
|
+
if limit:
|
|
171
|
+
units = units[:int(limit)]
|
|
172
|
+
view = build_view(units, now=now)
|
|
173
|
+
weak = sum(1 for c in view for s in c["weak_slots"])
|
|
174
|
+
return {
|
|
175
|
+
"view": view,
|
|
176
|
+
"units_count": len(units),
|
|
177
|
+
"weak_count": weak,
|
|
178
|
+
"ttl_days_default": TTL_DEFAULT_DAYS,
|
|
179
|
+
"ttl_env": _env_ttl(),
|
|
180
|
+
"now": time.time() if now is None else float(now),
|
|
181
|
+
}
|
package/md_cg/sustain.py
CHANGED
|
@@ -476,6 +476,30 @@ def _hb_prune_shards(root: str):
|
|
|
476
476
|
|
|
477
477
|
|
|
478
478
|
# 生效条件:开关关(heartbeat_ledger_enabled() 为假)时返回 None 且不写盘;否则先经 _hb_rotate_if_needed(root) 有界闸门,再向 root/HEARTBEAT_LOG 追加一行 {"t","name","pid","kind":"beat","ok"(,"error")},返回该行;任何写入异常被吞掉并返回 None(心跳不可因台账而中断)。
|
|
479
|
+
|
|
480
|
+
|
|
481
|
+
# 生效条件:e 为 tick 内捕获的异常;返回「类名: 消息 @ 文件:行(末3帧摘要)」单行字符串(≤600 字)
|
|
482
|
+
def _tick_error_summary(e: BaseException) -> str:
|
|
483
|
+
"""tick 失败的**可定位**摘要(issue #804)。
|
|
484
|
+
|
|
485
|
+
早先只记 `类名: 消息` —— `RuntimeError: dictionary changed size during iteration`
|
|
486
|
+
这种没有栈的报错等于零定位信息(实测 5 次、5 个不同 pid 全无 traceback)。
|
|
487
|
+
现在追加末 3 帧 `文件:行 函数` 与最终错误行;仍压成**一行**,不破坏 `_heartbeat.jsonl` 的逐行 JSON 契约。
|
|
488
|
+
"""
|
|
489
|
+
import traceback
|
|
490
|
+
head = "%s: %s" % (type(e).__name__, str(e)[:200])
|
|
491
|
+
try:
|
|
492
|
+
tb = traceback.extract_tb(e.__traceback__)
|
|
493
|
+
except Exception: # noqa: BLE001 —— 取栈失败也不影响主流程
|
|
494
|
+
return head
|
|
495
|
+
if not tb:
|
|
496
|
+
return head
|
|
497
|
+
frames = tb[-3:]
|
|
498
|
+
where = " <- ".join("%s:%d %s" % (os.path.basename(f.filename), f.lineno, f.name)
|
|
499
|
+
for f in frames)
|
|
500
|
+
return ("%s @ %s" % (head, where))[:600]
|
|
501
|
+
|
|
502
|
+
|
|
479
503
|
def record_heartbeat(root: str, name: str, *, ok: bool = True, error=None,
|
|
480
504
|
t=None, pid=None, extra=None,
|
|
481
505
|
kind: str = HB_KIND_BEAT) -> dict:
|
|
@@ -1583,9 +1607,11 @@ class SustainLoop:
|
|
|
1583
1607
|
if name != "beat":
|
|
1584
1608
|
# D2:失败档**必须在台账可见**——非 beat 业务档每轮失败追加
|
|
1585
1609
|
# 一条 kind="tick" 行(beat 自身失败已由 beat() 记 ok=False)。
|
|
1610
|
+
# 【issue #804】早先只记「类名: 消息」⇒ 5 次 RuntimeError 全无定位信息
|
|
1611
|
+
# (连抛在哪一行都不知道)。现追加 traceback 尾部(最后 3 帧 + 错误行),
|
|
1612
|
+
# 台账仍是一条 JSON 行(不破坏既有解析)。
|
|
1586
1613
|
record_heartbeat(self.cg.root, name, ok=False,
|
|
1587
|
-
error=
|
|
1588
|
-
str(e)[:200]),
|
|
1614
|
+
error=_tick_error_summary(e),
|
|
1589
1615
|
kind=HB_KIND_TICK)
|
|
1590
1616
|
self.last_tick_error = {"name": name, "t": time.time(),
|
|
1591
1617
|
"error": "%s: %s" % (type(e).__name__,
|
|
@@ -115,7 +115,10 @@ def main():
|
|
|
115
115
|
"E1 blindspots 仍恒空(口径后置,未被本批顺带改动)")
|
|
116
116
|
expected = {"subject", "slot", "value", "state", "t_from", "t_to",
|
|
117
117
|
"seq_from", "seq_to", "tier", "alternatives",
|
|
118
|
-
"blindspots", "event_count"
|
|
118
|
+
"blindspots", "event_count",
|
|
119
|
+
# 【2026-11】租约参数透传(与 tier 同形:取最后产生当前值的事件):
|
|
120
|
+
# kind 供 state_view 判「值会不会被改写」;ttl 是调用方 extra.ttl 声明的租约。
|
|
121
|
+
"kind", "ttl"}
|
|
119
122
|
ok(expected <= set(zs2), "E2 单元键集未减少", str(sorted(set(zs2) - expected)))
|
|
120
123
|
ok(set(zs2) - expected <= {"history"}, "E3 无未经登记的新键",
|
|
121
124
|
str(sorted(set(zs2) - expected)))
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""#856 / #857 守卫:time 导入(validity 生效)与多轮轮转(cap 补满)。
|
|
3
|
+
|
|
4
|
+
#856:`bucketscope` 用了 `time.*` 却没导入 ⇒ `validity=True` 时 `_is_expired` 抛 NameError,
|
|
5
|
+
被 mdcos 的桶召回外层 except 吞掉 ⇒ **桶补召回整体静默失效**。
|
|
6
|
+
(旧守卫 `test_bucket_recency_guards` 为何没抓到:它只断言「expired 不在 pack」,
|
|
7
|
+
而失效后 pack 里本来就没有 —— 假绿。)
|
|
8
|
+
#857:跨日桶轮转只跑一轮;某些日桶只出 0–1 条时永远补不满(9 条匹配 + cap=8 只回 6 条)。
|
|
9
|
+
"""
|
|
10
|
+
from __future__ import annotations
|
|
11
|
+
|
|
12
|
+
import os
|
|
13
|
+
import sys
|
|
14
|
+
import tempfile
|
|
15
|
+
import time
|
|
16
|
+
|
|
17
|
+
sys.stdout.reconfigure(encoding="utf-8", errors="replace")
|
|
18
|
+
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
19
|
+
|
|
20
|
+
from md_cg import bucketindex as bi # noqa: E402
|
|
21
|
+
from md_cg import bucketscope as bs # noqa: E402
|
|
22
|
+
from md_cg.mdcos import MdCGOS # noqa: E402
|
|
23
|
+
|
|
24
|
+
CCG = ('# 功能名:{n}\n# 生效条件:c\n# 子功能:s\n# 执行:e\n'
|
|
25
|
+
'# 验证方式:test\n# 不适用条件:无\n\n{body}\n')
|
|
26
|
+
FAILS = []
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def ok(cond, name, detail=""):
|
|
30
|
+
if cond:
|
|
31
|
+
print(" PASS " + name)
|
|
32
|
+
else:
|
|
33
|
+
print(" FAIL " + name + " " + str(detail)[:170])
|
|
34
|
+
FAILS.append(name)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def main():
|
|
38
|
+
print("=" * 66)
|
|
39
|
+
print("#856 time 导入 / #857 多轮轮转")
|
|
40
|
+
print("=" * 66)
|
|
41
|
+
now = time.mktime(time.strptime("2026-07-10 12:00:00", "%Y-%m-%d %H:%M:%S"))
|
|
42
|
+
|
|
43
|
+
# ---- #856 ----
|
|
44
|
+
expired = {"frontmatter": {"valid_until": "2000-01-01"}}
|
|
45
|
+
active = {"frontmatter": {"created_at": now}}
|
|
46
|
+
ok(bs._is_expired(expired, now) is True, "T1 expired 判定可用(不抛 NameError)")
|
|
47
|
+
ok(bs._is_expired(active, now) is False, "T2 无 valid_until 不算过期")
|
|
48
|
+
|
|
49
|
+
root = tempfile.mkdtemp(prefix="g856_")
|
|
50
|
+
g = MdCGOS(root, actor="test")
|
|
51
|
+
g.add("a_live", CCG.format(n="活", s="w", e="1", body="阀门 规格 现行"),
|
|
52
|
+
created_at=now, session="s")
|
|
53
|
+
g.add("a_dead", CCG.format(n="死", s="w", e="2", body="阀门 规格 旧版"),
|
|
54
|
+
created_at=now - 10, session="s", valid_until="2000-01-01")
|
|
55
|
+
bi.build(g, write=True, with_content=True)
|
|
56
|
+
# 关键:`_pick` 内部要真的调用 `_is_expired`(#856 的 NameError 就是在这里被外层吞掉的)。
|
|
57
|
+
# 用「词面无命中 + fill_rest」触发按时间兜底,同时开 validity ⇒ 必须只有活节点、且不抛异常。
|
|
58
|
+
ids = [n.get("id") for n, _s, _q, _p in bs._pick(
|
|
59
|
+
g, ["a_live", "a_dead"], bs._terms("完全无关词"), 4,
|
|
60
|
+
validity=True, now=now, fill_rest=True)]
|
|
61
|
+
ok(len(ids) > 0, "T3 validity=True 时 _pick 仍能返回候选(不抛 NameError)", ids)
|
|
62
|
+
ok("a_dead" not in ids, "T4 expired 不进入桶召回结果", ids)
|
|
63
|
+
|
|
64
|
+
# ---- #857 ----
|
|
65
|
+
root2 = tempfile.mkdtemp(prefix="g857_")
|
|
66
|
+
g2 = MdCGOS(root2, actor="test")
|
|
67
|
+
base = time.mktime(time.strptime("2026-04-01 10:00:00", "%Y-%m-%d %H:%M:%S"))
|
|
68
|
+
# 3 个日桶,共 9 条命中;cap=8 ⇒ 必须补满 8 条
|
|
69
|
+
k = 0
|
|
70
|
+
for d in range(3):
|
|
71
|
+
for j in range(3):
|
|
72
|
+
g2.add("m%d" % k, CCG.format(n="x", s="w", e=str(j), body="阀门 规格 记录"),
|
|
73
|
+
created_at=base + d * 86400, session="s%d" % d)
|
|
74
|
+
k += 1
|
|
75
|
+
bi.build(g2, write=True, with_content=True)
|
|
76
|
+
picked2 = bs.scope_recall(g2, "阀门 规格", session=None, now=now, cap=8)
|
|
77
|
+
ok(len(picked2) == 8, "T5 9 条匹配 + cap=8 ⇒ 必须补满 8 条(旧版只回 6)", len(picked2))
|
|
78
|
+
buckets = {q.get("bucket") for _n, _s, q, _p in picked2}
|
|
79
|
+
ok(len(buckets) == 3, "T6 补满的同时仍覆盖全部 3 个日桶", buckets)
|
|
80
|
+
|
|
81
|
+
print()
|
|
82
|
+
print("全部通过" if not FAILS else "失败 %d 项" % len(FAILS))
|
|
83
|
+
return 1 if FAILS else 0
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
if __name__ == "__main__":
|
|
87
|
+
sys.exit(main())
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""md_cg.cohesion 的守卫测试。
|
|
3
|
+
|
|
4
|
+
固化的行为契约(2026-10-24):
|
|
5
|
+
1. 单块 → ok=None(无接缝可言,**不得**判为断裂)
|
|
6
|
+
2. 连续句流中点切两半 → ok=True(接缝天然连续)
|
|
7
|
+
3. 不相干章节拼装 → ok=False(真断裂)
|
|
8
|
+
4. 过短内容 → ok=None(算不出,不给默认通过)
|
|
9
|
+
5. 标题行不参与重叠(曾导致同章节切分被判 0.0)
|
|
10
|
+
6. seam_ratio 在块数 <2 时返回 None,不返回 0
|
|
11
|
+
|
|
12
|
+
为什么单独立测:这些边界此前逐个踩过(三次返工),
|
|
13
|
+
任何一条回退都会让「拼装断裂」的判据失真。
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
import os
|
|
17
|
+
import sys
|
|
18
|
+
|
|
19
|
+
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
20
|
+
|
|
21
|
+
from md_cg import cohesion as co # noqa: E402
|
|
22
|
+
|
|
23
|
+
FAILS = []
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def check(name, cond, detail=""):
|
|
27
|
+
if cond:
|
|
28
|
+
print(" ok %s" % name)
|
|
29
|
+
else:
|
|
30
|
+
print(" FAIL %s %s" % (name, detail))
|
|
31
|
+
FAILS.append(name)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
# 构造:一段有明显承接的连续文本
|
|
35
|
+
CONT = (
|
|
36
|
+
"信息差是协作行为的不确定性度量。"
|
|
37
|
+
"它由四个维度加权得到。"
|
|
38
|
+
"四维度分别是信任补集、行为偏差、连接偏离与预测误差。"
|
|
39
|
+
"每个维度都有各自的归一化区间。"
|
|
40
|
+
"加权后得到综合度量 D_norm。"
|
|
41
|
+
"D_norm 越大表示不确定性越高。"
|
|
42
|
+
)
|
|
43
|
+
OTHER = "本章讨论裁决权的归属与监督方式。它规定了优先保护存在。可逆性优先也是其中一条。"
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
def main():
|
|
47
|
+
# ① 单块:无接缝
|
|
48
|
+
rep = co.check([CONT])
|
|
49
|
+
check("单块 ok=None", rep["ok"] is None, rep)
|
|
50
|
+
check("单块 cross_boundary=None", rep["cross_boundary"] is None, rep)
|
|
51
|
+
check("单块 inner_adj>0", rep["inner_adj"] > 0, rep)
|
|
52
|
+
|
|
53
|
+
# ② 连续句流中点切两半:接缝连续
|
|
54
|
+
sents = co.split_sentences(CONT)
|
|
55
|
+
half = len(sents) // 2
|
|
56
|
+
two = ["\n".join(sents[:half]), "\n".join(sents[half:])]
|
|
57
|
+
rep = co.check(two)
|
|
58
|
+
check("连续切两半 ok=True", rep["ok"] is True, rep)
|
|
59
|
+
check("连续切两半 ratio>0", (rep["ratio"] or 0) > 0, rep)
|
|
60
|
+
|
|
61
|
+
# ③ 不相干章节:判断裂
|
|
62
|
+
rep = co.check([CONT, OTHER])
|
|
63
|
+
check("不相干拼装 ok=False", rep["ok"] is False, rep)
|
|
64
|
+
|
|
65
|
+
# ④ 过短:无法判定
|
|
66
|
+
rep = co.check(["短。", "也短。"])
|
|
67
|
+
check("过短 ok=None", rep["ok"] is None, rep)
|
|
68
|
+
|
|
69
|
+
# ⑤ 标题行不参与重叠
|
|
70
|
+
body = co.split_sentences("### 2.7.1 标题\n正文第一句在这里。\n正文第二句也在这里。")
|
|
71
|
+
check("标题被过滤", not any(s.startswith("#") for s in body), body)
|
|
72
|
+
check("正文保留", len(body) >= 1, body)
|
|
73
|
+
|
|
74
|
+
# ⑥ seam_ratio 单块返回 None
|
|
75
|
+
ratio, detail = co.seam_ratio([CONT])
|
|
76
|
+
check("seam_ratio 单块=None", ratio is None, detail)
|
|
77
|
+
|
|
78
|
+
# ⑦ 空输入不炸
|
|
79
|
+
rep = co.check([])
|
|
80
|
+
check("空输入 ok=None", rep["ok"] is None, rep)
|
|
81
|
+
|
|
82
|
+
# ⑧ 信噪比读数(2026-10-24 第三十六轮补,对应「稀释」这一损失)
|
|
83
|
+
TGT = "平均段长是 5.79 句每段,摘要保留率等于 1 除以平均段长。"
|
|
84
|
+
r = co.signal_ratio(TGT, TGT + "无关内容" * 3)
|
|
85
|
+
check("信噪比 clear", r["verdict"] == "clear" and r["ok"] is True, r)
|
|
86
|
+
r = co.signal_ratio(TGT, TGT + "无关内容段落。" * 400)
|
|
87
|
+
check("信噪比 drowned", r["verdict"] == "drowned" and r["ok"] is False, r)
|
|
88
|
+
check("信噪比 drowned 给出比例", (r["ratio"] or 1) < co.SIGNAL_LOW, r)
|
|
89
|
+
# thin 必须返回 None,不得默认通过、也不得判坏
|
|
90
|
+
r = co.signal_ratio(TGT, TGT + "无关内容段落。" * 140)
|
|
91
|
+
check("信噪比 thin ok=None", r["ok"] is None, r)
|
|
92
|
+
check("信噪比 thin 标记为 thin", r["verdict"] == "thin", r)
|
|
93
|
+
r = co.signal_ratio("", "一些上下文")
|
|
94
|
+
check("信噪比空目标 ok=None", r["ok"] is None, r)
|
|
95
|
+
r = co.signal_ratio(TGT, "")
|
|
96
|
+
check("信噪比空上下文 ok=None", r["ok"] is None, r)
|
|
97
|
+
|
|
98
|
+
print("")
|
|
99
|
+
if FAILS:
|
|
100
|
+
print("失败 %d 项:%s" % (len(FAILS), FAILS))
|
|
101
|
+
return 1
|
|
102
|
+
print("全部通过")
|
|
103
|
+
return 0
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
if __name__ == "__main__":
|
|
107
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""md_cg.constraint_audit 的守卫测试。
|
|
3
|
+
|
|
4
|
+
固化的行为契约(2026-10-24 第四十七轮):
|
|
5
|
+
1. 约束能在日志里找到对应记录 → checked
|
|
6
|
+
2. 找不到 → unchecked,且**不等于没违反**(I6)
|
|
7
|
+
3. 编造的约束必须落 unchecked(不能因为日志里有别的词就误判)
|
|
8
|
+
4. 无清单 / 空日志 → ok=None(无法判定,不默认通过)
|
|
9
|
+
5. 返回必带 note,声明「有记录/无记录 ≠ 遵守/违反」
|
|
10
|
+
|
|
11
|
+
为什么单独立测:这是 H7 唯一的可行验证路径(第四十六轮),
|
|
12
|
+
若它把「没找到」当成「没违反」,结论会反向。
|
|
13
|
+
"""
|
|
14
|
+
|
|
15
|
+
import os
|
|
16
|
+
import sys
|
|
17
|
+
|
|
18
|
+
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
19
|
+
|
|
20
|
+
from md_cg import constraint_audit as cau # noqa: E402
|
|
21
|
+
|
|
22
|
+
FAILS = []
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
def check(name, cond, detail=""):
|
|
26
|
+
if cond:
|
|
27
|
+
print(" ok %s" % name)
|
|
28
|
+
else:
|
|
29
|
+
print(" FAIL %s %s" % (name, detail))
|
|
30
|
+
FAILS.append(name)
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
LOG = """abc1234 feat(cohesion): 拼装接缝检测
|
|
34
|
+
def5678 feat(constraint-watch): 约束巡检模块
|
|
35
|
+
ghi9012 docs: 补适用边界
|
|
36
|
+
"""
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def main():
|
|
40
|
+
items = cau.parse_constraints("C1 约束巡检\nC2 拼装接缝检测\n")
|
|
41
|
+
|
|
42
|
+
# ① 能找到
|
|
43
|
+
rep = cau.cross_check(items, LOG)
|
|
44
|
+
check("全部能找到 ok=True", rep["ok"] is True, rep["counts"])
|
|
45
|
+
check("checked 有证据", all(c.get("evidence") for c in rep["checked"]), rep["checked"])
|
|
46
|
+
|
|
47
|
+
# ② 编造的找不到
|
|
48
|
+
rep = cau.cross_check("C9 不得把火星数据写入木星表\n", LOG)
|
|
49
|
+
check("编造约束 unchecked", rep["ok"] is False, rep["counts"])
|
|
50
|
+
check("编造约束 cover 低",
|
|
51
|
+
rep["unchecked"][0]["cover"] < cau.MATCH_THRESHOLD, rep["unchecked"])
|
|
52
|
+
|
|
53
|
+
# ③ 空输入 → None
|
|
54
|
+
check("无清单 ok=None", cau.cross_check("", LOG)["ok"] is None)
|
|
55
|
+
check("空日志 ok=None", cau.cross_check(items, "")["ok"] is None)
|
|
56
|
+
|
|
57
|
+
# ④ 必带 I6 提示
|
|
58
|
+
rep = cau.cross_check(items, LOG)
|
|
59
|
+
check("note 含 I6 提示", "不等于" in rep["note"], rep["note"][:50])
|
|
60
|
+
|
|
61
|
+
# ⑤ 部分命中
|
|
62
|
+
rep = cau.cross_check("C1 约束巡检\nC9 火星木星\n", LOG)
|
|
63
|
+
check("部分命中 checked=1", rep["counts"]["checked"] == 1, rep["counts"])
|
|
64
|
+
check("部分命中 unchecked=1", rep["counts"]["unchecked"] == 1, rep["counts"])
|
|
65
|
+
|
|
66
|
+
# ⑥ 留痕缺口检查(2026-10-24 第四十九轮补)
|
|
67
|
+
import tempfile, subprocess, os
|
|
68
|
+
tg = cau.trace_gap(repo=os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
69
|
+
check("trace_gap 返回 ok 字段", "ok" in tg, tg)
|
|
70
|
+
check("trace_gap 有 counts", "counts" in tg or tg.get("ok") is None, tg)
|
|
71
|
+
check("trace_gap note 说明不等于违反",
|
|
72
|
+
"不等于违反" in (tg.get("note") or ""), (tg.get("note") or "")[:40])
|
|
73
|
+
# 非 git 目录 → ok=None(不默认通过)
|
|
74
|
+
with tempfile.TemporaryDirectory() as td:
|
|
75
|
+
tg2 = cau.trace_gap(repo=td)
|
|
76
|
+
check("非 git 目录 ok=None", tg2.get("ok") is None, tg2)
|
|
77
|
+
|
|
78
|
+
print("")
|
|
79
|
+
if FAILS:
|
|
80
|
+
print("失败 %d 项:%s" % (len(FAILS), FAILS))
|
|
81
|
+
return 1
|
|
82
|
+
print("全部通过")
|
|
83
|
+
return 0
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
if __name__ == "__main__":
|
|
87
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""md_cg.constraint_watch 的守卫测试。
|
|
3
|
+
|
|
4
|
+
固化的行为契约(2026-10-24,上下文管理研究第二十二、二十三轮):
|
|
5
|
+
1. 全部在场 → ok=True
|
|
6
|
+
2. 部分/全部缺失 → ok=False,且缺的逐条列出
|
|
7
|
+
3. 覆盖率 0 < c < 阈值 → 建议「回取」(有痕迹但不够)
|
|
8
|
+
4. 覆盖率 0 → 建议「报警」(连痕迹都没有)
|
|
9
|
+
5. 空文本 / 无约束 → ok=None(无法判定,**不得**默认通过)
|
|
10
|
+
6. 清单解析只认带编号短行,说明文字不算约束
|
|
11
|
+
|
|
12
|
+
为什么这些边界要立测:漏报就是静默丢约束(第三轮、第十二轮、第二十二轮
|
|
13
|
+
三次同型失败都指向「没有强制就不做」),所以「报不出」比「误报」危险得多。
|
|
14
|
+
"""
|
|
15
|
+
|
|
16
|
+
import os
|
|
17
|
+
import sys
|
|
18
|
+
|
|
19
|
+
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
|
20
|
+
|
|
21
|
+
from md_cg import constraint_watch as cw # noqa: E402
|
|
22
|
+
|
|
23
|
+
FAILS = []
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def check(name, cond, detail=""):
|
|
27
|
+
if cond:
|
|
28
|
+
print(" ok %s" % name)
|
|
29
|
+
else:
|
|
30
|
+
print(" FAIL %s %s" % (name, detail))
|
|
31
|
+
FAILS.append(name)
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
LIST = (
|
|
35
|
+
"# 约束清单\n"
|
|
36
|
+
"C1 不得覆盖旧文件\n"
|
|
37
|
+
"C2 必须留下校验记录\n"
|
|
38
|
+
"C3 不得删除中间产物\n"
|
|
39
|
+
)
|
|
40
|
+
FULL = "导出必须留下校验记录。不得覆盖旧文件,不得删除中间产物。"
|
|
41
|
+
PARTIAL = "本次操作会覆盖一些临时内容。"
|
|
42
|
+
EMPTY = "今天天气不错。"
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def main():
|
|
46
|
+
# ① 全部在场
|
|
47
|
+
rep = cw.check(LIST, FULL)
|
|
48
|
+
check("全部在场 ok=True", rep["ok"] is True, rep.get("counts"))
|
|
49
|
+
check("全部在场 missing=0", len(rep["missing"]) == 0, rep["missing"])
|
|
50
|
+
|
|
51
|
+
# ② 部分缺失:逐条列出
|
|
52
|
+
rep = cw.check(LIST, PARTIAL)
|
|
53
|
+
check("部分缺失 ok=False", rep["ok"] is False, rep.get("counts"))
|
|
54
|
+
check("部分缺失 有回取建议", any(m["advice"] == "回取" for m in rep["missing"]),
|
|
55
|
+
rep["missing"])
|
|
56
|
+
|
|
57
|
+
# ③ 全部缺失 → 报警
|
|
58
|
+
rep = cw.check(LIST, EMPTY)
|
|
59
|
+
check("全部缺失 ok=False", rep["ok"] is False, rep.get("counts"))
|
|
60
|
+
check("全部缺失 全为报警", all(m["advice"] == "报警" for m in rep["missing"]),
|
|
61
|
+
rep["missing"])
|
|
62
|
+
|
|
63
|
+
# ④ 空文本 / 无约束 → None(不默认通过)
|
|
64
|
+
check("空文本 ok=None", cw.check(LIST, "")["ok"] is None)
|
|
65
|
+
check("无约束 ok=None", cw.check("没有编号条目", FULL)["ok"] is None)
|
|
66
|
+
check("空清单 ok=None", cw.check("", FULL)["ok"] is None)
|
|
67
|
+
|
|
68
|
+
# ⑤ 解析只认带编号短行
|
|
69
|
+
items = cw.parse_constraints(LIST)
|
|
70
|
+
check("解析出 3 条", len(items) == 3, items)
|
|
71
|
+
check("编号规范化", [i["id"] for i in items] == ["C1", "C2", "C3"], items)
|
|
72
|
+
long_line = "C9 " + "这是一条很长的说明文字" * 8
|
|
73
|
+
check("超长行不算约束", len(cw.parse_constraints(long_line)) == 0)
|
|
74
|
+
|
|
75
|
+
# ⑥ 覆盖率单调性
|
|
76
|
+
c_hi = cw.coverage("不得覆盖旧文件", FULL)
|
|
77
|
+
c_lo = cw.coverage("不得覆盖旧文件", EMPTY)
|
|
78
|
+
check("在场覆盖高于缺失", c_hi > c_lo, (c_hi, c_lo))
|
|
79
|
+
|
|
80
|
+
# ⑦ 回取三态(2026-10-24 第三十三轮补)
|
|
81
|
+
r = cw.retrieve_for("不得覆盖旧文件", None)
|
|
82
|
+
check("回取未接入 ok=None", r["ok"] is None, r)
|
|
83
|
+
r = cw.retrieve_for("", None)
|
|
84
|
+
check("回取空文本 ok=None", r["ok"] is None, r)
|
|
85
|
+
|
|
86
|
+
class FakeCG:
|
|
87
|
+
def __init__(self, hits):
|
|
88
|
+
self._hits = hits
|
|
89
|
+
def search(self, q, k=3):
|
|
90
|
+
return (self._hits, {})
|
|
91
|
+
r = cw.retrieve_for("不得覆盖旧文件", FakeCG([]))
|
|
92
|
+
check("回取无候选 ok=False", r["ok"] is False, r)
|
|
93
|
+
check("无候选提示含 I6", "不等于" in r["note"], r["note"])
|
|
94
|
+
r = cw.retrieve_for("不得覆盖旧文件",
|
|
95
|
+
FakeCG([{"id": "n1", "content": "候选内容"}]))
|
|
96
|
+
check("回取有候选 ok=True", r["ok"] is True, r)
|
|
97
|
+
check("有候选仍需人判断", "需判断" in r["note"], r["note"])
|
|
98
|
+
|
|
99
|
+
print("")
|
|
100
|
+
if FAILS:
|
|
101
|
+
print("失败 %d 项:%s" % (len(FAILS), FAILS))
|
|
102
|
+
return 1
|
|
103
|
+
print("全部通过")
|
|
104
|
+
return 0
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
if __name__ == "__main__":
|
|
108
|
+
raise SystemExit(main())
|