@furongjun1999/dsh-memory 0.9.23 → 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.
- package/CHANGELOG.en.md +450 -404
- package/CHANGELOG.md +67 -0
- package/README.en.md +244 -240
- package/README.md +272 -262
- package/codebuddy/CODEBUDDY.md +1 -1
- package/docs/discipline/templates/full.md.tmpl +1 -1
- package/docs/discipline/templates/rules.mdc.tmpl +1 -1
- package/docs/en/mdcg/world-model-endpoint.md +1 -1
- package/docs/mdcg/cogmap_ops.md +16 -15
- package/lib/client.js +29 -3
- package/lib/hooks.d.ts +12 -0
- package/lib/hooks.js +43 -1
- package/md_cg/bucketindex.py +231 -0
- package/md_cg/bucketscope.py +339 -0
- package/md_cg/config_registry_bulk.py +19 -10
- package/md_cg/config_validate.py +14 -2
- package/md_cg/detrerank.py +137 -0
- package/md_cg/fsutil.py +135 -0
- package/md_cg/govern/__init__.py +23 -0
- package/md_cg/iface/__init__.py +46 -0
- package/md_cg/iface/_verify.py +609 -0
- package/md_cg/iface/contracts.py +337 -0
- package/md_cg/judgment_manifest.py +14 -0
- package/md_cg/kernel/__init__.py +27 -0
- package/md_cg/mcp_server.py +5991 -5761
- package/md_cg/mdcg.py +474 -16
- package/md_cg/mdcos.py +228 -11
- package/md_cg/metacognition.py +66 -13
- package/md_cg/mutate_extract_shipped.py +126 -0
- package/md_cg/mutate_ledger_e2e.py +100 -0
- package/md_cg/op_table.py +8 -0
- package/md_cg/probe_c_ledger_integrity.py +258 -0
- package/md_cg/probe_d_retirement_discipline.py +263 -0
- package/md_cg/review_cli.py +6 -1
- package/md_cg/run_tests.py +30 -1
- package/md_cg/scopeselect.py +214 -0
- package/md_cg/scrub.py +66 -9
- package/md_cg/state_extract.py +149 -0
- package/md_cg/state_slots.py +58 -10
- package/md_cg/structboost.py +179 -0
- package/md_cg/test_alternatives_historical.py +162 -0
- package/md_cg/test_b2_sensitivity_landing.py +226 -223
- package/md_cg/test_b3_merge_keeps_content.py +608 -583
- package/md_cg/test_bucket_cards.py +85 -0
- package/md_cg/test_bucket_day_order.py +74 -0
- package/md_cg/test_bucket_quota.py +79 -0
- package/md_cg/test_bucket_recency_guards.py +75 -0
- package/md_cg/test_bucket_three_causes.py +83 -0
- package/md_cg/test_bucketindex.py +130 -0
- package/md_cg/test_bucketscope_early.py +71 -0
- package/md_cg/test_cond_term_fold_gate.py +1210 -0
- package/md_cg/test_cond_term_neg_scope.py +147 -0
- package/md_cg/test_detrerank.py +157 -0
- package/md_cg/test_gate_four_kpi.py +136 -0
- package/md_cg/test_generation_guard.py +14 -2
- package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
- package/md_cg/test_issue39_utf8_stdio.py +572 -572
- package/md_cg/test_issue413_preimage_failclosed.py +147 -9
- package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
- package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
- package/md_cg/test_issue790_verb_negation.py +77 -0
- package/md_cg/test_issue810_root_guard.py +71 -0
- package/md_cg/test_issue812_info_index_stale.py +78 -0
- package/md_cg/test_issue827_weaken_dedup.py +361 -0
- package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
- package/md_cg/test_kernel_iface_contracts.py +18 -0
- package/md_cg/test_md_cg_no_hive_dep.py +238 -17
- package/md_cg/test_probe_cd_shipped.py +385 -0
- package/md_cg/test_recent_tail.py +93 -0
- package/md_cg/test_run_tests_entry_gates.py +110 -0
- package/md_cg/test_scopeselect.py +70 -0
- package/md_cg/test_scopeselect_clock.py +70 -0
- package/md_cg/test_session_attribution_consistency.py +835 -813
- package/md_cg/test_state_extract_shipped.py +162 -0
- package/md_cg/test_state_ledger_chain.py +207 -0
- package/md_cg/test_state_ledger_e2e.py +145 -0
- package/md_cg/test_structboost.py +102 -0
- package/md_cg/test_timeboost.py +83 -0
- package/md_cg/test_timeboost_relativedate.py +71 -0
- package/md_cg/test_topicagg.py +129 -0
- package/md_cg/timeboost.py +223 -0
- package/md_cg/topicagg.py +142 -0
- package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
- package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
- package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
- package/package.json +137 -137
- package/src/hooks.ts +43 -1
- package/ui/minimal/payload/build-ui.mjs +41 -2
- package/ui/minimal/payload/lib/client.js +29 -3
- package/ui/minimal/payload/web/app.js +3 -1
- package/ui/minimal/payload/web/client.js +30 -3
- package/web/app.js +3 -1
- package/web/client.js +30 -3
- package/zcode/AGENTS.md +1 -1
|
@@ -0,0 +1,337 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""灵枢 1.0 接口层(iface)——四个契约的类型面,W1 骨架。
|
|
3
|
+
|
|
4
|
+
真源:docs/architecture/灵枢1.0_建设路线_v0.1.md §3「四个接口契约(最小签名)」。
|
|
5
|
+
|
|
6
|
+
Write write(node_id, content, conditions, provenance) -> {id, state, receipt}
|
|
7
|
+
Read read(query, context) -> [{id, score, why, state, evidence_ref}]
|
|
8
|
+
Govern revise / retire / rollback / audit(ts_range)
|
|
9
|
+
SelfCheck status() -> {counts, lag, drift, wal_ok}
|
|
10
|
+
|
|
11
|
+
本模块只声明**契约形状与不变量**,不含任何实现(M1:建空壳 + 契约类型)。
|
|
12
|
+
M2 起把读路径接到新内核;M3 写路径;M4 治理面。
|
|
13
|
+
|
|
14
|
+
禁止项(路线稿 §2):本层**不得依赖任何 HTTP/MCP 类型**,只吃 dict/JSON;
|
|
15
|
+
适配层不得直接读写存储文件。
|
|
16
|
+
|
|
17
|
+
不变量(逐条可测,见 md_cg/test_kernel_iface_contracts.py):
|
|
18
|
+
- W1 ``provenance`` 必填(依据链);写失败必须留账。
|
|
19
|
+
- R1 ``why`` 必填(依据什么命中);``state`` 只来自治理层。
|
|
20
|
+
- R2 打分层不得输出 ``state``(#111 既定契约)。
|
|
21
|
+
- G1 任何修订可回滚;回滚**覆盖正文**。
|
|
22
|
+
- S1 ``status()`` 必须能在不读全部节点的情况下答「我坏没坏」。
|
|
23
|
+
"""
|
|
24
|
+
|
|
25
|
+
from __future__ import annotations
|
|
26
|
+
|
|
27
|
+
import hashlib
|
|
28
|
+
import json
|
|
29
|
+
from types import MappingProxyType
|
|
30
|
+
from typing import Any, Dict, Iterable, List, Mapping, Optional, Protocol, Tuple, runtime_checkable
|
|
31
|
+
|
|
32
|
+
__all__ = [
|
|
33
|
+
"CONTRACT_NAMES",
|
|
34
|
+
"IFACE_LAYER",
|
|
35
|
+
"RecordState",
|
|
36
|
+
"WriteRequest",
|
|
37
|
+
"WriteReceipt",
|
|
38
|
+
"ReadItem",
|
|
39
|
+
"ReadRequest",
|
|
40
|
+
"SelfCheckReport",
|
|
41
|
+
"WriteContract",
|
|
42
|
+
"ReadContract",
|
|
43
|
+
"GovernContract",
|
|
44
|
+
"SelfCheckContract",
|
|
45
|
+
"ContractViolation",
|
|
46
|
+
"require_provenance",
|
|
47
|
+
"require_why",
|
|
48
|
+
"reject_state_in_scoring",
|
|
49
|
+
]
|
|
50
|
+
|
|
51
|
+
IFACE_LAYER = "iface"
|
|
52
|
+
|
|
53
|
+
#: 四个契约的固定名字(路线稿 §3 只有四个;增删即破坏冻结面)。
|
|
54
|
+
CONTRACT_NAMES: Tuple[str, str, str, str] = ("Write", "Read", "Govern", "SelfCheck")
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
class ContractViolation(ValueError):
|
|
58
|
+
"""契约不变量被违反。携带稳定的 ``code`` 供守卫断言(不靠异常文案)。"""
|
|
59
|
+
|
|
60
|
+
def __init__(self, code: str, message: str) -> None:
|
|
61
|
+
super().__init__(f"[{code}] {message}")
|
|
62
|
+
self.code = code
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
#: 节点状态枚举。**只允许治理层产出**(不变量 R2)。
|
|
66
|
+
RecordState = ("active", "dormant", "retired", "tombstoned")
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def _require_mapping(value: Any, field: str) -> Mapping[str, Any]:
|
|
70
|
+
if not isinstance(value, Mapping):
|
|
71
|
+
raise ContractViolation("not_a_mapping", f"{field} 必须是 mapping,收到 {type(value).__name__}")
|
|
72
|
+
return value
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def require_provenance(provenance: Any) -> Mapping[str, Any]:
|
|
76
|
+
"""Write 不变量:``provenance`` 必填且非空(依据链)。
|
|
77
|
+
|
|
78
|
+
生效条件:``provenance`` 为 mapping 且至少有一个键值 → 原样返回;空 mapping、
|
|
79
|
+
非 mapping、None 三态均抛 ``ContractViolation``(code 分别为
|
|
80
|
+
``empty_provenance`` / ``not_a_mapping`` / ``missing_provenance``)。
|
|
81
|
+
"""
|
|
82
|
+
if provenance is None:
|
|
83
|
+
raise ContractViolation("missing_provenance", "Write 必须带 provenance(依据链),不得为空")
|
|
84
|
+
mapping = _require_mapping(provenance, "provenance")
|
|
85
|
+
if not mapping:
|
|
86
|
+
raise ContractViolation("empty_provenance", "provenance 不得为空 mapping——依据链必须可指认")
|
|
87
|
+
return mapping
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
def require_why(why: Any) -> str:
|
|
91
|
+
"""Read 不变量:``why`` 必填且非空白(依据什么命中)。"""
|
|
92
|
+
if why is None:
|
|
93
|
+
raise ContractViolation("missing_why", "Read 命中必须带 why(依据什么命中)")
|
|
94
|
+
if not isinstance(why, str):
|
|
95
|
+
raise ContractViolation("not_a_string", f"why 必须是 str,收到 {type(why).__name__}")
|
|
96
|
+
if not why.strip():
|
|
97
|
+
raise ContractViolation("empty_why", "why 不得为空白字符串")
|
|
98
|
+
return why
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
def reject_state_in_scoring(items: Iterable[Mapping[str, Any]]) -> List[Mapping[str, Any]]:
|
|
102
|
+
"""打分层不得输出 ``state``(#111 既定契约,路线稿 §4)。
|
|
103
|
+
|
|
104
|
+
生效条件:``items`` 中任一元素含非空 ``state`` 键即抛 ``ContractViolation``
|
|
105
|
+
(code=``state_in_scoring``);全部不含则原样返回列表。
|
|
106
|
+
|
|
107
|
+
为什么这条要单独成函数:路线稿 §4 把「``search_rrf`` 内含资格判定调用」
|
|
108
|
+
列为本轮要拆的耦合——拆分后打分与治理分属两层,**跨层泄漏必须可测**。
|
|
109
|
+
"""
|
|
110
|
+
out: List[Mapping[str, Any]] = []
|
|
111
|
+
for index, item in enumerate(items):
|
|
112
|
+
_require_mapping(item, f"items[{index}]")
|
|
113
|
+
if item.get("state"):
|
|
114
|
+
raise ContractViolation(
|
|
115
|
+
"state_in_scoring",
|
|
116
|
+
f"items[{index}] 含 state={item.get('state')!r}——打分层不得输出 state(#111)",
|
|
117
|
+
)
|
|
118
|
+
out.append(item)
|
|
119
|
+
return out
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
class WriteRequest:
|
|
123
|
+
"""``Write.write`` 的入参形状。**真正不可变**;``provenance`` 构造时即校验。
|
|
124
|
+
|
|
125
|
+
为什么不用「仅 ``__slots__``」:
|
|
126
|
+
``__slots__`` 只阻止**新增**属性,不阻止**重新赋值**——
|
|
127
|
+
``req.node_id = "x"`` 照样能改,而 ``digest()`` 每次重算,
|
|
128
|
+
于是指纹可被外部改写污染(实测:改完 digest 直接变)。
|
|
129
|
+
因此本类用 ``__setattr__`` 守卫封死赋值,并把两个 mapping 换成
|
|
130
|
+
``MappingProxyType``(内层也是只读视图,堵住 ``provenance["k"]=1``)。
|
|
131
|
+
"""
|
|
132
|
+
|
|
133
|
+
__slots__ = ("node_id", "content", "conditions", "provenance", "_frozen")
|
|
134
|
+
|
|
135
|
+
def __init__(
|
|
136
|
+
self,
|
|
137
|
+
node_id: str,
|
|
138
|
+
content: str,
|
|
139
|
+
conditions: Optional[Mapping[str, Any]] = None,
|
|
140
|
+
provenance: Optional[Mapping[str, Any]] = None,
|
|
141
|
+
) -> None:
|
|
142
|
+
if not isinstance(node_id, str) or not node_id.strip():
|
|
143
|
+
raise ContractViolation("bad_node_id", "node_id 必须是非空白字符串")
|
|
144
|
+
if not isinstance(content, str):
|
|
145
|
+
raise ContractViolation("bad_content", f"content 必须是 str,收到 {type(content).__name__}")
|
|
146
|
+
# 构造期写入必须绕过 __setattr__ 守卫
|
|
147
|
+
object.__setattr__(self, "node_id", node_id)
|
|
148
|
+
object.__setattr__(self, "content", content)
|
|
149
|
+
object.__setattr__(self, "conditions", MappingProxyType(dict(conditions or {})))
|
|
150
|
+
object.__setattr__(self, "provenance", MappingProxyType(dict(require_provenance(provenance))))
|
|
151
|
+
object.__setattr__(self, "_frozen", True)
|
|
152
|
+
|
|
153
|
+
def __setattr__(self, name: str, value: Any) -> None:
|
|
154
|
+
if getattr(self, "_frozen", False):
|
|
155
|
+
raise AttributeError(
|
|
156
|
+
f"WriteRequest 不可变:拒绝给 {name!r} 赋值。"
|
|
157
|
+
"指纹必须对同一份内容稳定——需要新内容请新建一个 WriteRequest。"
|
|
158
|
+
)
|
|
159
|
+
object.__setattr__(self, name, value)
|
|
160
|
+
|
|
161
|
+
def __delattr__(self, name: str) -> None:
|
|
162
|
+
raise AttributeError(f"WriteRequest 不可变:拒绝删除 {name!r}")
|
|
163
|
+
|
|
164
|
+
def as_dict(self) -> Dict[str, Any]:
|
|
165
|
+
return {
|
|
166
|
+
"node_id": self.node_id,
|
|
167
|
+
"content": self.content,
|
|
168
|
+
"conditions": dict(self.conditions),
|
|
169
|
+
"provenance": dict(self.provenance),
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
def digest(self) -> str:
|
|
173
|
+
"""内容指纹(供 receipt 与实际落盘对账)。纯计算,无 IO。"""
|
|
174
|
+
payload = json.dumps(self.as_dict(), ensure_ascii=False, sort_keys=True, separators=(",", ":"))
|
|
175
|
+
return hashlib.sha256(payload.encode("utf-8")).hexdigest()
|
|
176
|
+
|
|
177
|
+
def __repr__(self) -> str: # pragma: no cover - 仅调试
|
|
178
|
+
return f"WriteRequest(node_id={self.node_id!r}, digest={self.digest()[:12]}…)"
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
class WriteReceipt:
|
|
182
|
+
"""``Write`` 的回执。写失败**必须留账**(不变量 W1),故 ``ledger`` 为必填字段。"""
|
|
183
|
+
|
|
184
|
+
__slots__ = ("receipt_id", "node_id", "state", "digest", "ledger")
|
|
185
|
+
|
|
186
|
+
def __init__(
|
|
187
|
+
self,
|
|
188
|
+
receipt_id: str,
|
|
189
|
+
node_id: str,
|
|
190
|
+
state: str,
|
|
191
|
+
digest: str,
|
|
192
|
+
ledger: Mapping[str, Any],
|
|
193
|
+
) -> None:
|
|
194
|
+
if state not in RecordState:
|
|
195
|
+
raise ContractViolation("bad_state", f"state 必须属于 {RecordState},收到 {state!r}")
|
|
196
|
+
_require_mapping(ledger, "ledger")
|
|
197
|
+
if not ledger:
|
|
198
|
+
raise ContractViolation("empty_ledger", "写失败必须留账——ledger 不得为空")
|
|
199
|
+
self.receipt_id = receipt_id
|
|
200
|
+
self.node_id = node_id
|
|
201
|
+
self.state = state
|
|
202
|
+
self.digest = digest
|
|
203
|
+
self.ledger = dict(ledger)
|
|
204
|
+
|
|
205
|
+
def as_dict(self) -> Dict[str, Any]:
|
|
206
|
+
return {
|
|
207
|
+
"id": self.receipt_id,
|
|
208
|
+
"node_id": self.node_id,
|
|
209
|
+
"state": self.state,
|
|
210
|
+
"digest": self.digest,
|
|
211
|
+
"ledger": dict(self.ledger),
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
class ReadRequest:
|
|
216
|
+
"""``Read.read`` 的入参形状。``context`` 只吃 dict(禁止宿主类型)。"""
|
|
217
|
+
|
|
218
|
+
__slots__ = ("query", "context")
|
|
219
|
+
|
|
220
|
+
def __init__(self, query: str, context: Optional[Mapping[str, Any]] = None) -> None:
|
|
221
|
+
if not isinstance(query, str) or not query.strip():
|
|
222
|
+
raise ContractViolation("bad_query", "query 必须是非空白字符串")
|
|
223
|
+
self.query = query
|
|
224
|
+
self.context = dict(_require_mapping(context or {}, "context"))
|
|
225
|
+
|
|
226
|
+
def as_dict(self) -> Dict[str, Any]:
|
|
227
|
+
return {"query": self.query, "context": dict(self.context)}
|
|
228
|
+
|
|
229
|
+
|
|
230
|
+
class ReadItem:
|
|
231
|
+
"""``Read`` 的单条命中。``why`` / ``state`` / ``evidence_ref`` 三件套是契约核心。"""
|
|
232
|
+
|
|
233
|
+
__slots__ = ("node_id", "score", "why", "state", "evidence_ref")
|
|
234
|
+
|
|
235
|
+
def __init__(
|
|
236
|
+
self,
|
|
237
|
+
node_id: str,
|
|
238
|
+
score: float,
|
|
239
|
+
why: str,
|
|
240
|
+
state: Optional[str],
|
|
241
|
+
evidence_ref: Optional[str],
|
|
242
|
+
) -> None:
|
|
243
|
+
if not isinstance(node_id, str) or not node_id.strip():
|
|
244
|
+
raise ContractViolation("bad_node_id", "node_id 必须是非空白字符串")
|
|
245
|
+
self.node_id = node_id
|
|
246
|
+
self.score = float(score)
|
|
247
|
+
self.why = require_why(why)
|
|
248
|
+
if state is not None and state not in RecordState:
|
|
249
|
+
raise ContractViolation("bad_state", f"state 必须属于 {RecordState},收到 {state!r}")
|
|
250
|
+
self.state = state
|
|
251
|
+
if evidence_ref is not None and not isinstance(evidence_ref, str):
|
|
252
|
+
raise ContractViolation("bad_evidence_ref", "evidence_ref 必须是 str 或 None")
|
|
253
|
+
self.evidence_ref = evidence_ref
|
|
254
|
+
|
|
255
|
+
def as_dict(self) -> Dict[str, Any]:
|
|
256
|
+
return {
|
|
257
|
+
"id": self.node_id,
|
|
258
|
+
"score": self.score,
|
|
259
|
+
"why": self.why,
|
|
260
|
+
"state": self.state,
|
|
261
|
+
"evidence_ref": self.evidence_ref,
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
|
|
265
|
+
class SelfCheckReport:
|
|
266
|
+
"""``SelfCheck.status`` 的返回。四个键一个都不能少(路线稿 §3)。"""
|
|
267
|
+
|
|
268
|
+
__slots__ = ("counts", "lag", "drift", "wal_ok")
|
|
269
|
+
|
|
270
|
+
_REQUIRED = ("counts", "lag", "drift", "wal_ok")
|
|
271
|
+
|
|
272
|
+
def __init__(
|
|
273
|
+
self,
|
|
274
|
+
counts: Mapping[str, Any],
|
|
275
|
+
lag: float,
|
|
276
|
+
drift: bool,
|
|
277
|
+
wal_ok: bool,
|
|
278
|
+
) -> None:
|
|
279
|
+
_require_mapping(counts, "counts")
|
|
280
|
+
self.counts = dict(counts)
|
|
281
|
+
self.lag = float(lag)
|
|
282
|
+
self.drift = bool(drift)
|
|
283
|
+
self.wal_ok = bool(wal_ok)
|
|
284
|
+
|
|
285
|
+
def as_dict(self) -> Dict[str, Any]:
|
|
286
|
+
return {
|
|
287
|
+
"counts": dict(self.counts),
|
|
288
|
+
"lag": self.lag,
|
|
289
|
+
"drift": self.drift,
|
|
290
|
+
"wal_ok": self.wal_ok,
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
def missing_keys(self) -> List[str]:
|
|
294
|
+
"""供守卫断言「四个键齐备」;缺失即不满足 SelfCheck 契约。"""
|
|
295
|
+
present = set(self.as_dict())
|
|
296
|
+
return [key for key in self._REQUIRED if key not in present]
|
|
297
|
+
|
|
298
|
+
|
|
299
|
+
@runtime_checkable
|
|
300
|
+
class WriteContract(Protocol):
|
|
301
|
+
"""Write 契约(路线稿 §3)。M2 起由内核实现。"""
|
|
302
|
+
|
|
303
|
+
def write(self, request: WriteRequest) -> WriteReceipt: # pragma: no cover - 协议声明
|
|
304
|
+
...
|
|
305
|
+
|
|
306
|
+
|
|
307
|
+
@runtime_checkable
|
|
308
|
+
class ReadContract(Protocol):
|
|
309
|
+
"""Read 契约。返回的每一条都必须满足 ``require_why``。"""
|
|
310
|
+
|
|
311
|
+
def read(self, request: ReadRequest) -> List[ReadItem]: # pragma: no cover - 协议声明
|
|
312
|
+
...
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
@runtime_checkable
|
|
316
|
+
class GovernContract(Protocol):
|
|
317
|
+
"""Govern 契约:revise / retire / rollback / audit。回滚**覆盖正文**。"""
|
|
318
|
+
|
|
319
|
+
def revise(self, node_id: str, content: str, provenance: Mapping[str, Any]) -> Mapping[str, Any]: # pragma: no cover
|
|
320
|
+
...
|
|
321
|
+
|
|
322
|
+
def retire(self, node_id: str, reason: str) -> Mapping[str, Any]: # pragma: no cover
|
|
323
|
+
...
|
|
324
|
+
|
|
325
|
+
def rollback(self, revision_id: str) -> Mapping[str, Any]: # pragma: no cover
|
|
326
|
+
...
|
|
327
|
+
|
|
328
|
+
def audit(self, ts_range: Tuple[float, float]) -> List[Mapping[str, Any]]: # pragma: no cover
|
|
329
|
+
...
|
|
330
|
+
|
|
331
|
+
|
|
332
|
+
@runtime_checkable
|
|
333
|
+
class SelfCheckContract(Protocol):
|
|
334
|
+
"""SelfCheck 契约:不读全部节点也能答「我坏没坏」。"""
|
|
335
|
+
|
|
336
|
+
def status(self) -> SelfCheckReport: # pragma: no cover - 协议声明
|
|
337
|
+
...
|
|
@@ -68,6 +68,20 @@ PATTERNS = [
|
|
|
68
68
|
("test", "hive_exec_test.py"),
|
|
69
69
|
("test", "hive_wm_test.py"),
|
|
70
70
|
("test/chaos_injection", "run_all.py"),
|
|
71
|
+
# tests/(复数,根,2026-11-07):与 scripts/ 版逐字同步——run_tests 的
|
|
72
|
+
# ROOT_TESTS 具名裁决清单补收了该目录的 script-style 守卫,判据面
|
|
73
|
+
# 必须同步,否则「跑什么 ⊆ 冻结什么」报缺口。同样精确名冻结。
|
|
74
|
+
# 未过裁决件曾含 pytest-style 无入口的 test_relation_type_whitelist_guard.py
|
|
75
|
+
# (冻结它就是冻结假守卫)—— 该件已于 2026-11-08 补齐 script-style 入口,
|
|
76
|
+
# 直跑与 -m pytest 结果等价(8 passed 1 skipped),现按裁决收进判据面。
|
|
77
|
+
# 空壳 test_issue_580.py 已于 2026-11-08 **删除**
|
|
78
|
+
# (直跑零用例、RC 恒 0;#580 回归场景由 md_cg/test_issue561_pending_review.py
|
|
79
|
+
# 的 R00–R04 真实覆盖);防复发改由 scripts/test_gate_no_false_green.py 承担。
|
|
80
|
+
("tests", "test_hook_audit_summary.py"),
|
|
81
|
+
("tests", "test_issue721_tag_filter.py"),
|
|
82
|
+
# 2026-11-08 收(与 scripts/ 版同批同因):原 pytest-style 直跑零用例 RC 恒 0,
|
|
83
|
+
# 已补 _ENTRY_CASES+main()+if __name__,pytest 依赖降级为可选软导入。
|
|
84
|
+
("tests", "test_relation_type_whitelist_guard.py"),
|
|
71
85
|
]
|
|
72
86
|
|
|
73
87
|
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""灵枢 1.0 内核层(kernel)——W1 骨架,无实现。
|
|
3
|
+
|
|
4
|
+
真源:docs/architecture/灵枢1.0_建设路线_v0.1.md §2 解耦分层 / §5 迁移路径 M1。
|
|
5
|
+
|
|
6
|
+
适配层 dsh 插件 / MCP server / hive worker ← 只调 D2,不碰 D1/D0
|
|
7
|
+
接口层 四个契约(Write / Read / Govern / SelfCheck)
|
|
8
|
+
治理层 生命周期四档 · 审计台账 · 回滚/2PC · 资格判定
|
|
9
|
+
内核层 节点存储 · 索引 · 检索打分 · 锁/WAL ← 本包
|
|
10
|
+
|
|
11
|
+
**本包为 W1 骨架(M1「建空壳 + 契约类型,无实现」)**:只放类型与协议,
|
|
12
|
+
不含任何存储/索引/检索实现。M2 起才把读路径接到此处。
|
|
13
|
+
|
|
14
|
+
禁止项(路线稿 §2,违反即判耦合):
|
|
15
|
+
- 内核/治理层不得出现 ``from ..dsh``;
|
|
16
|
+
- 内核/治理层不得读环境变量决定行为(除路径根);
|
|
17
|
+
- 内核层不得 import 接口层之外的任何宿主类型。
|
|
18
|
+
|
|
19
|
+
边界:本包当前**零 IO、零副作用**;纯类型声明。
|
|
20
|
+
"""
|
|
21
|
+
|
|
22
|
+
__all__ = ["KERNEL_LAYER", "LAYER_ORDER"]
|
|
23
|
+
|
|
24
|
+
KERNEL_LAYER = "kernel"
|
|
25
|
+
|
|
26
|
+
#: 依赖只能自上而下(路线稿 §2);数字越小越靠上。
|
|
27
|
+
LAYER_ORDER = ("adapter", "iface", "govern", "kernel")
|