@furongjun1999/dsh-memory 0.9.16 → 0.9.18

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/md_cg/mdcos.py CHANGED
@@ -3427,7 +3427,7 @@ class MdCGOS(MdCG):
3427
3427
  return f"rev_{pid.split('_')[-1]}_r{int(round_no)}"
3428
3428
 
3429
3429
  # 生效条件:当 rec 提供 record_node_id/record_hash/pid/round/decision/status/redteam_verdict 等键时(缺键会 KeyError),构造审核裁决 body,并调用 self.add 以 layer="self"、override=True、role=AUDIT_ROLE、sensitivity=DEFAULT_SENSITIVITY(issue #522:审计件保护级由件类型固定,不随裁决者 clearance 漂移)等写入,返回 nid;
3430
- def _write_review_record(self, rec):
3430
+ def _write_review_record(self, rec, reviewers=None):
3431
3431
  """把一轮裁决写成 md 记忆节点(**structural 层**)——外部来源可读、可复核。
3432
3432
 
3433
3433
  2026-10-18 改(方案 A):此前硬编码 layer="self",后果实测为——
@@ -3472,7 +3472,13 @@ class MdCGOS(MdCG):
3472
3472
  # 769 条是这类裁决审计记录(98.6%),把真正的自我锚点挤到只剩 11 条。
3473
3473
  # 审计痕迹的语义是「结构事件」,不属「扮演依据」。
3474
3474
  # 同时打 audit_trace 标签——它是 self_surface 过滤的判据单点。
3475
+ # issue #708(2026-10-28):裁决审计节点写 structural 层,而 structural 属 2 档
3476
+ # (需 reflect + verify)。此前这里**不传 reviewers** ⇒ enforce 档下审计节点被
3477
+ # 同一个闸挡住(jsonl 还在、可复核的 md 节点没了)。
3478
+ # 修法(报告人建议 3):把**本次裁决已经取得的** reviewed_by 一并带进写入——
3479
+ # 它本来就是「本次裁决的复核单元」,不是凭空自证。
3475
3480
  self.add(nid, body, layer="structural", override=True, role=self.AUDIT_ROLE,
3481
+ reviewed_by=reviewers,
3476
3482
  tags=["audit", "audit_trace", self.AUDIT_TAG, f"pid:{rec['pid']}",
3477
3483
  f"round:{rec['round']}"],
3478
3484
  importance=0.2, verification_basis="data",
@@ -3486,7 +3492,7 @@ class MdCGOS(MdCG):
3486
3492
 
3487
3493
  # 生效条件:当 pid/item/decision/status/reason/round_no/rt_verdict/issues/vhash/result 传入时,构造 rec 并写 record_hash,把 result 中 ok/node_id/error/state 保留(result.mutation 为 dict 时另落 rec["mutation"]=变更单执行时点载荷,proposal 链无此键、rec 形状逐位不变);在 strict 锁内追加 decisions_log;随后尝试写 md 审核记录,成功补 record_node_id/record_hash,异常则补 record_error 并 audit review_record_failed;最后 audit review_decide 并返回 result;
3488
3494
  def _record_decision(self, pid, item, decision, status, reason, round_no,
3489
- rt_verdict, issues, vhash, result):
3495
+ rt_verdict, issues, vhash, result, reviewers=None):
3490
3496
  """落盘一轮裁决:jsonl(权威)+ md 审计节点(可复核、供外部审计)。"""
3491
3497
  t = time.time()
3492
3498
  rec = {"t": t, "pid": pid, "decision": decision, "status": status,
@@ -3511,7 +3517,7 @@ class MdCGOS(MdCG):
3511
3517
  append_jsonl(self.decisions_log, rec, strict=True)
3512
3518
  # md 审计节点写失败不影响裁决(jsonl 仍是权威来源)
3513
3519
  try:
3514
- self._write_review_record(rec)
3520
+ self._write_review_record(rec, reviewers=reviewers)
3515
3521
  result["record_node_id"] = rec["record_node_id"]
3516
3522
  result["record_hash"] = rec["record_hash"]
3517
3523
  except Exception as exc: # noqa: BLE001
@@ -3937,8 +3943,10 @@ class MdCGOS(MdCG):
3937
3943
  # accept/edit/merge/noop 链之前。proposal(含存量无 kind 条目)一律不
3938
3944
  # 进此支,下面整条链对它逐位不变。
3939
3945
  if autonomy_modes.order_kind(item) == autonomy_modes.KIND_MUTATION:
3946
+ # issue #709 连带:变更单桥也要把本次裁决的复核单元带下去(审计节点用它过闸)
3940
3947
  return self._decide_mutation(pid, item, decision, reason, override,
3941
- round_no, rt_v, rt_issues, expect)
3948
+ round_no, rt_v, rt_issues, expect,
3949
+ reviewers=reviewed_by)
3942
3950
 
3943
3951
  result = {"pid": pid, "decision": decision, "round": round_no,
3944
3952
  "redteam": rt_v or "absent"}
@@ -4027,8 +4035,13 @@ class MdCGOS(MdCG):
4027
4035
  "原写入者身份裁决。"}
4028
4036
  self._seal_override = ((item["id"],) + _seal_as) if _seal_as else None
4029
4037
  try:
4038
+ # issue #709 连带发现(2026-10-28):accept 落业务节点时,把**本次裁决已取得的**
4039
+ # reviewed_by 一并带入。此前只在审计节点传了、这里没传 ⇒ enforce 下裁决本身
4040
+ # 能过 dual_check,落盘却被同一个闸拒(「批了但写不进去」)。
4041
+ # 层白名单与密级检查照常;dual_check 仍在 accept 之前,复核不被削弱。
4030
4042
  nid = self.add(item["id"], content, layer=layer, tags=tags,
4031
- condition_space=item.get("condition_space"), **extra)
4043
+ condition_space=item.get("condition_space"),
4044
+ reviewed_by=reviewed_by, **extra)
4032
4045
  finally:
4033
4046
  self._seal_override = None
4034
4047
  # 索引增量收尾(2026-09-16 取证):add 只把条目放进本进程内存 _dirty,
@@ -4124,11 +4137,12 @@ class MdCGOS(MdCG):
4124
4137
  result.update(ok=True, node_id=target)
4125
4138
 
4126
4139
  return self._finish_decision(pid, item, decision, reason, round_no,
4127
- rt_v, rt_issues, expect, result)
4140
+ rt_v, rt_issues, expect, result,
4141
+ reviewers=reviewed_by)
4128
4142
 
4129
4143
  # 生效条件:result 为已定好的裁决返回体时,按其 pid/item/decision/reason/round_no/rt_v/rt_issues/expect 调 _record_decision(status 映射统一出口:reject→"rejected"、noop→"noop"、其余→"accepted")落盘 jsonl + 审计节点,再按 item 的 payload_hash(缺失时 _sig(content))调 _cascade_dedup 级联出清(有 closed 时写 result["cascade_closed"]),最后 flush 并返回 result;
4130
4144
  def _finish_decision(self, pid, item, decision, reason, round_no, rt_v,
4131
- rt_issues, expect, result):
4145
+ rt_issues, expect, result, reviewers=None):
4132
4146
  """裁决**统一收尾**(单点):proposal 链与变更单执行桥共用同一收尾。
4133
4147
 
4134
4148
  为何抽出来:三档自治批次② 的变更单走独立执行桥(`_decide_mutation`),
@@ -4141,7 +4155,7 @@ class MdCGOS(MdCG):
4141
4155
  pid, item, decision,
4142
4156
  {DECISION_REJECT: "rejected", DECISION_NOOP: DECISION_NOOP}
4143
4157
  .get(decision, "accepted"),
4144
- reason, round_no, rt_v, rt_issues, expect, result)
4158
+ reason, round_no, rt_v, rt_issues, expect, result, reviewers=reviewers)
4145
4159
  # 级联出清:主提案已终态,同内容兄弟提案(重复入队产物)自动关闭
4146
4160
  casc = self._cascade_dedup(
4147
4161
  pid, item.get("payload_hash") or _sig(item.get("content") or ""),
@@ -4158,7 +4172,7 @@ class MdCGOS(MdCG):
4158
4172
 
4159
4173
  # 生效条件:item 为 kind=mutation 的队列记录——decision 为 accept 时经 _mutation_execute 执行对应动作(返回 ok=False 时**原样返回该错误**、不落裁决、提案保持 pending),为 reject 时只置 ok=True 留痕;decision 非此二者时返回 {"ok": False, "error": "mutation_decision_unsupported", ...} 带 hint(fail-closed,不落裁决);通过者交 _finish_decision 收尾后返回其结果;
4160
4174
  def _decide_mutation(self, pid, item, decision, reason, override, round_no,
4161
- rt_v, rt_issues, expect):
4175
+ rt_v, rt_issues, expect, reviewers=None):
4162
4176
  """变更单的裁决分派(三档自治批次② · 设计 §四):accept 执行 / reject 留痕。
4163
4177
 
4164
4178
  本批只定义 accept/reject 两态;其余裁决(edit/merge/noop)**fail-closed
@@ -4188,7 +4202,8 @@ class MdCGOS(MdCG):
4188
4202
  else:
4189
4203
  result["ok"] = True
4190
4204
  return self._finish_decision(pid, item, decision, reason, round_no,
4191
- rt_v, rt_issues, expect, result)
4205
+ rt_v, rt_issues, expect, result,
4206
+ reviewers=reviewers)
4192
4207
 
4193
4208
  # 生效条件:无输入形参;调用即返回 list(read_jsonl(self.decisions_log)),记录内容取决于 decisions_log 可读结果;
4194
4209
  def decisions(self):
@@ -4625,7 +4640,25 @@ class MdCGOS(MdCG):
4625
4640
  pack["degraded"].append("tasks")
4626
4641
  # ③ 近期事件(原始滚动窗口)
4627
4642
  try:
4628
- evs = self.recent_events(limit=max(1, int(recent_limit or 10)))
4643
+ # issue #712(2026-10-30 使用者裁定方案 C):**取窗顺序**修正——需要按会话
4644
+ # 收窄时**先取全量、再过滤、最后截**。修前是先截末 N 条(本行)再由下方
4645
+ # 4656 过滤 ⇒ 多会话并发时本会话消息被别会话挤出窗口,`session="A"` 可能
4646
+ # 拿到**空 recent**(过滤器没错,窗口错了;false-negative,极难被现有测试
4647
+ # 发现)。选 `limit=0`(全量)而非 `recent_limit×K`:① 本函数 ② goals 段
4648
+ # 已是「全量取数 → 过滤 → 截断」形态(`active_goals(limit=None)` 后切
4649
+ # `[:_PACK_ROWS]`),倍数窗会成为本文件里的第二种形态;② 外部会话条数无
4650
+ # 上界,倍数窗只是把失败概率变小;③ `MdCGSecure.recent_events` 内部本就
4651
+ # `super().recent_events(limit=0, …)` 再 `keep[:limit]`,故此处传 0
4652
+ # **不新增读盘量**。
4653
+ _win = max(1, int(recent_limit or 10))
4654
+ _sess_arg = session if (session and str(session).strip() != "*") else None
4655
+ # issue #712 D 项:分档会话读权限。仅当 `sessions_read` 是集合且不含
4656
+ # "*" 时收窄(None = 与历史逐位相同)。can_admin 不在此处特殊处理——
4657
+ # 它按 issue #35 定稿本就全读,本判据只做「减法」。
4658
+ _sr = getattr(getattr(self, "principal", None), "sessions_read", None)
4659
+ _sr_narrow = isinstance(_sr, tuple) and bool(_sr) and "*" not in _sr
4660
+ _narrow = bool(_sess_arg) or _sr_narrow
4661
+ evs = self.recent_events(limit=0 if _narrow else _win)
4629
4662
  # issue #65(外部报告 by ducc239,对 v0.7.5 实测,本 workflow 修前复现):
4630
4663
  # 本段此前**不传会话**,而 `MdCGSecure.recent_events` 无 session 形参
4631
4664
  # (只有 private/secret 档做会话归属判断、默认档全放行)⇒ recent 恒为
@@ -4638,11 +4671,34 @@ class MdCGOS(MdCG):
4638
4671
  # 的 "*" 同款语义);
4639
4672
  # falsy(None/"")→ 退回旧行为(全局窗口,存量调用面零迁移)。
4640
4673
  # `strip()` 防空白包裹的 "*"(" * " 也按汇总处理)。
4641
- if session and str(session).strip() != "*":
4674
+ if _sess_arg:
4642
4675
  evs = [r for r in evs if (r.get("meta") or {}).get("session") == session]
4676
+ if _sr_narrow:
4677
+ evs = [r for r in evs if (r.get("meta") or {}).get("session") in _sr]
4678
+ if _narrow:
4679
+ evs = evs[:_win]
4680
+ if not session:
4681
+ # issue #712 C 项:falsy 会话**不再静默退回全局窗口**——把「你正在读
4682
+ # 全局窗口」放进 degraded,让调用方/工具面看得见(只写日志等于没留痕,
4683
+ # #708 的教训)。
4684
+ pack["degraded"].append("recent_global_window")
4685
+ # issue #712 B 项:注入面恢复**四要素**(会话/时间/身份/id)。
4686
+ # 修前只留 role/text/t,模型因此无法判断「这条是哪个会话说的、私有还是
4687
+ # 共有、谁说的」——「跨窗口串台」的用户侧困惑正源于此。
4688
+ # 取值一律防御式(meta 可能缺失/非 dict),与上一段的既有写法同款。
4643
4689
  pack["recent"] = [{"role": r.get("role"),
4644
4690
  "text": (r.get("text") or "")[:300],
4645
- "t": r.get("t")} for r in evs]
4691
+ "t": r.get("t"),
4692
+ "id": r.get("id"),
4693
+ "session": (r.get("meta") or {}).get("session"),
4694
+ "sensitivity": (r.get("meta") or {}).get("sensitivity"),
4695
+ "actor": (r.get("meta") or {}).get("actor"),
4696
+ # 2026-10-30 理论《身份与人格》:归因三维(编号/职业身份/汇报线)。
4697
+ # 只透出**归因必需**的,不透权限快照(理由见 remember_event 注释)。
4698
+ "token_id": (r.get("meta") or {}).get("token_id"),
4699
+ "identity_role": (r.get("meta") or {}).get("identity_role"),
4700
+ "parent": (r.get("meta") or {}).get("parent")}
4701
+ for r in evs]
4646
4702
  except Exception: # noqa: BLE001
4647
4703
  pack["degraded"].append("recent")
4648
4704
  # ④ 未解问题(驱动主动补全)
@@ -4710,13 +4766,20 @@ class MdCGOS(MdCG):
4710
4766
  零依赖启发式(无嵌入 / 无 LLM):按行去重 + 角色配比 + 截断。
4711
4767
  返回体显式声明 heuristic=True,不冒充语义摘要(语义归纳见 consolidate)。
4712
4768
  """
4769
+ # issue #712(2026-10-30 验证单元复核发现):**与 session_recall 同型的取窗 bug**——
4770
+ # 修前先截末 N 条、后按会话过滤 ⇒ 多会话并发时本会话事件被挤出窗口,
4771
+ # `session_compact(session=A, note=True)` 可能压出「共 0 条事件」并**写入会话节点**
4772
+ # (比 session_recall 更严重:那只是少看到,这会**写错**一条记忆)。
4773
+ # 修法同 session_recall:需要收窄时先取全量、再过滤、最后再截回 limit。
4774
+ _lc = max(1, int(limit or 40))
4775
+ _narrow_c = bool(session)
4713
4776
  try:
4714
- evs = self.recent_events(limit=max(1, int(limit or 40)))
4777
+ evs = self.recent_events(limit=0 if _narrow_c else _lc)
4715
4778
  except Exception: # noqa: BLE001
4716
4779
  evs = []
4717
- if session:
4780
+ if _narrow_c:
4718
4781
  evs = [r for r in evs
4719
- if (r.get("meta") or {}).get("session") == session]
4782
+ if (r.get("meta") or {}).get("session") == session][:_lc]
4720
4783
  roles, seen, points = {}, set(), []
4721
4784
  for r in evs:
4722
4785
  role = r.get("role") or "user"
@@ -6787,7 +6850,15 @@ class MdCGSecure(MdCGOS):
6787
6850
  with node_write_lock(self, node_id):
6788
6851
  sens = self._write_sensitivity(node_id, sensitivity)
6789
6852
  _rank(sens)
6790
- self.principal.require_layer_write(layer, sens)
6853
+ # issue #708/#709(2026-10-28):把调用方已经取得的复核单元透传给闸。
6854
+ # 此前这里只传 (layer, sens),`reviewed_by` 虽在 **kw 里却从未被消费 ⇒
6855
+ # 审计节点与 accept 落盘都被同一个闸挡住。
6856
+ #
6857
+ # **必须 pop 而不是 kw.get**:`reviewed_by` 是**写入闸的输入参数**,不是记忆
6858
+ # 的元数据。若留在 kw 里,它会经 super().add(**kw) 落进 frontmatter
6859
+ # (实测:`test_i50c` 的 B1 逐键对拍报出 `reviewed_by: null` 的白名单外差异)。
6860
+ _reviewers = kw.pop("reviewed_by", None)
6861
+ self.principal.require_layer_write(layer, sens, reviewers=_reviewers)
6791
6862
  self._attribution(kw, sens)
6792
6863
  # B2(2026-09-30):`sens` 是归一后的落盘值,`sensitivity` 才是调用方
6793
6864
  # 的**原始声明**(None=未声明)。两者必须分别下传——库层 `_write_node`
@@ -6836,7 +6907,12 @@ class MdCGSecure(MdCGOS):
6836
6907
  # 生效条件:调用方未声明 sensitivity 时先经 _write_sensitivity 解析出 sens(issue #297:既有节点**继承旧密级**——缺省 confirm 档下提案记录若在入队时就已降成 internal,accept 只会照抄该值,故继承必须发生在这里、不能只补落盘面),再 principal.require_layer_write(kw.get("layer", "knowledge"), sens)(缺省与基类 MdCGOS.propose 的 layer="knowledge" 一致——此前误用 or "contextual" 导致校验层与落盘层错位:knowledge-only 身份被误拒 / contextual-only 身份入队成死提案,2026-09-25 缺陷 #5),再按**既有节点真层真密级**调 protect.require_layer(#346:提案者自己落不了盘的覆写不入队),最后转 super().propose(node_id, content, sensitivity=sens) 并返回其结果。
6837
6908
  def propose(self, node_id: str, content: str, sensitivity: str = None, **kw):
6838
6909
  sens = self._write_sensitivity(node_id, sensitivity)
6839
- self.principal.require_layer_write(kw.get("layer", "knowledge"), sens)
6910
+ # issue #709 连带发现(2026-10-28):propose **不落记忆盘**(只把候选写进 inbox),
6911
+ # 却按目标层要求复核单元 ⇒ enforce 下死锁:要写 knowledge 需 reflect、要 reflect
6912
+ # 需裁决、要裁决需有提案、提案又要 reflect。故此处跳过 write_gate。
6913
+ # 注意:层白名单与密级检查照常;accept 落盘时仍走 add() 的同一道闸,复核不被削弱。
6914
+ self.principal.require_layer_write(kw.get("layer", "knowledge"), sens,
6915
+ skip_gate=True)
6840
6916
  # issue #346(2026-10-17 U05a):入队面此前只比**声明值**(上面那行是拿
6841
6917
  # `sens`——显式声明时原样返回——去比写入者自己的 clearance),不比对既有
6842
6918
  # 节点的真层真密级 ⇒ 低权身份能把「自己落不了盘的覆写」塞进审核队列,再由
@@ -6922,6 +6998,24 @@ class MdCGSecure(MdCGOS):
6922
6998
  # 归因不可辨认;且请求声明对事件面静默失效);现与节点/入队同一单点
6923
6999
  # 解析——事件面与写面同口径(显式 meta["session"] 仍不可覆盖)。
6924
7000
  m.setdefault("session", self._attributed_session(sens))
7001
+ # issue #712(2026-10-30 验证单元复核发现):**身份归属此前漏落**——
7002
+ # 同函数里 tenant/session/harness/unit/sensitivity 都从 principal 落值,
7003
+ # 唯独 `actor`(「谁说的」)没落 ⇒ 注入面拿到的 actor 恒为 None,
7004
+ # 「哪些是自己做的、哪些是别人做的」这一要素在库层是空的。
7005
+ # 用 setdefault:调用方显式传 meta["actor"] 时不被覆盖(与上面同款口径)。
7006
+ m.setdefault("actor", self.principal.actor)
7007
+ # 2026-10-30 理论《身份与人格》七要素落地:仅补**归因必需**的三维,
7008
+ # 不给事件加权限快照(clearance/layers_allow/ops_allow 一律不写——权限是
7009
+ # 当前态不是历史事实,固化进事件会造出「假的当时有权」;权限由
7010
+ # sensitivity(数据属性)+ 读取时判据承担)。
7011
+ # · token_id = **编号**(同名不同人可区分)
7012
+ # · identity_role = **职业身份**(干什么;与 role 参数的 user/assistant 不同层,
7013
+ # 故用不同键名,避免与消息角色混淆)
7014
+ # · parent = **汇报线**(有上级时才落)
7015
+ m.setdefault("token_id", getattr(self.principal, "token_id", None))
7016
+ m.setdefault("identity_role", getattr(self.principal, "role", None))
7017
+ if getattr(self.principal, "parent", None):
7018
+ m.setdefault("parent", self.principal.parent)
6925
7019
  if getattr(self.principal, "harness", None):
6926
7020
  m.setdefault("harness", self.principal.harness)
6927
7021
  if getattr(self.principal, "unit", None):
package/md_cg/security.py CHANGED
@@ -134,7 +134,7 @@ class Principal:
134
134
  theory_version —— 当前声明的协议版本(审计与 whoami 用)
135
135
  """
136
136
 
137
- # 生效条件:clearance 须为模块级常量 SENSITIVITY_ORDER 成员(否则 _rank 抛 AccessDenied),session 为假值(含 None/空串)时生成 sess_ 随机串并把 session_auto 置 True(未获声明的进程自动随机;写归因三态收口的识别位,消费方 MdCGSecure._attributed_session),session 真值时原样采用并把 session_auto 置 False(显式声明的来源),expires_at 为假值(含 None/0)时存 None 否则 float(expires_at),layers_allow/ops_allow 为 None 时存 None 否则 tuple 化。
137
+ # 生效条件:clearance 须为模块级常量 SENSITIVITY_ORDER 成员(否则 _rank 抛 AccessDenied),session 为假值(含 None/空串)时生成 sess_ 随机串并把 session_auto 置 True(未获声明的进程自动随机;写归因三态收口的识别位,消费方 MdCGSecure._attributed_session),session 真值时原样采用并把 session_auto 置 False(显式声明的来源),expires_at 为假值(含 None/0)时存 None 否则 float(expires_at),layers_allow/ops_allow 为 None 时存 None 否则 tuple 化;sessions_read 为 None 时存 None(=旧行为,不限制会话读面),为集合(含 list/tuple/set)时 tuple 化并去重(=只允许读这些会话,'*' 表示全部,见 session_recall 的 recent 段)。
138
138
  def __init__(self, tenant: str = "default", actor: str = "system",
139
139
  clearance: str = DEFAULT_SENSITIVITY, can_write: bool = True,
140
140
  can_admin: bool = False, session: str = None,
@@ -142,7 +142,7 @@ class Principal:
142
142
  role: str = None, token_id: str = None, parent: str = None,
143
143
  expires_at: float = None, layers_allow=None, ops_allow=None,
144
144
  auth_mode: str = "direct", theory_ok: bool = True,
145
- theory_version: str = None):
145
+ theory_version: str = None, sessions_read=None):
146
146
  _rank(clearance) # 校验
147
147
  self.tenant = tenant
148
148
  self.actor = actor
@@ -171,6 +171,13 @@ class Principal:
171
171
  self.unit = unit
172
172
  self.role = (role or "system")
173
173
  self.token_id = token_id
174
+ # issue #712(2026-10-30 使用者裁定方案 C):**分档会话读权限**。
175
+ # None = 旧行为逐位不变(internal/public 事件跨会话可见;私有档仍由 _readable 的
176
+ # 既有口径按 principal.session 绑定,本字段不参与);
177
+ # 集合 = 只允许读这些会话('*' 表示全部)——仅在 session_recall 的 recent 段生效;
178
+ # 注意:can_admin 仍可读所有档(issue #35「设计者豁免」定稿),本字段**不削弱**它。
179
+ self.sessions_read = (None if sessions_read is None
180
+ else tuple(dict.fromkeys(str(x) for x in sessions_read)))
174
181
  self.parent = parent
175
182
  self.expires_at = float(expires_at) if expires_at else None
176
183
  self.layers_allow = None if layers_allow is None else tuple(layers_allow)
@@ -288,7 +295,7 @@ class Principal:
288
295
  f"写入敏感度 {sensitivity} 超出 clearance {self.clearance}")
289
296
 
290
297
  # 生效条件:先要求 self.require_write(sensitivity) 未抛异常;随后将形参 layer 为假值(None/空串)时按 "knowledge" 处理,并要求 self.allows_layer(layer) 为 True;最后按 MDCG_WRITE_GATE 三档过**分层写入严格度闸**(writegate):off 零介入放行、warn 记录并放行、enforce 对 deny/require_review 抛 AccessDenied。
291
- def require_layer_write(self, layer: str, sensitivity: str, reviewers=None):
298
+ def require_layer_write(self, layer: str, sensitivity: str, reviewers=None, *, skip_gate: bool = False):
292
299
  """写层校验:密级 + 层白名单 + **分层复核闸**(2026-10-27 使用者裁定)。
293
300
 
294
301
  分层严格度(writegate.LAYER_TIERS):情景/目标/未解/负记忆 = 0 档
@@ -298,6 +305,14 @@ class Principal:
298
305
 
299
306
  reviewers 为本次写入已取得的复核单元(缺省取环境声明 MDCG_REVIEWERS),
300
307
  只在闸启用(warn/enforce)时有意义;off 档完全不介入,行为与历史逐位相同。
308
+
309
+ **skip_gate(issue #709 连带发现,2026-10-28)**:只给**不落记忆盘**的入队动作用
310
+ (当前唯一调用方=`MdCGSecure.propose`)。理由:propose 只把候选写进 inbox、
311
+ 不写业务节点,却按**目标层**要求复核单元 ⇒ enforce 下形成死锁:
312
+ 「要写 knowledge 需 reflect → 要 reflect 需裁决 → 要裁决需有提案 → 提案又要 reflect」。
313
+ 跳过闸**不等于绕过写入闸**:accept 落盘时仍走 `add()` 的同一道闸,复核不被削弱。
314
+ 层白名单与密级检查**照常执行**(这里跳过的只有 write_gate 一档)。
315
+ **禁止用于任何真正落盘的路径**——那等于关闸。
301
316
  """
302
317
  self.require_write(sensitivity)
303
318
  layer = layer or "knowledge"
@@ -305,6 +320,8 @@ class Principal:
305
320
  raise AccessDenied(
306
321
  f"角色 {self.role} 无权写入 {layer} 层"
307
322
  f"(可写层 {list(self.layers_allow) if self.layers_allow is not None else '不限'})")
323
+ if skip_gate:
324
+ return None
308
325
  _wg_verdict = self._write_gate_verdict(layer, reviewers)
309
326
  if _wg_verdict and _wg_verdict.get("decision") in ("deny", "require_review"):
310
327
  if _wg_verdict.get("mode") == "enforce":
@@ -328,9 +345,15 @@ class Principal:
328
345
  reviewers = tuple(x.strip().lower() for x in raw.split(",") if x.strip())
329
346
  verdict = _wg.decide_write(layer, reviewers=reviewers, mode=mode)
330
347
  if mode == "warn" and verdict.get("decision") in ("deny", "require_review"):
348
+ # issue #708:既要 stderr(宿主愿意转发时实时可见),更要**进程内计数**
349
+ # ——后者经 `cg(op=info).write_gate` 可查,不依赖 DSH 是否转发子进程 stderr。
331
350
  import sys as _sys
332
- _sys.stderr.write("[writegate] warn:%s(未阻断,仅记录)"
351
+ _sys.stderr.write("[writegate] warn:%s(未阻断,仅记录;计数见 cg(op=info).write_gate)"
333
352
  % verdict.get("reason"))
353
+ try:
354
+ _wg.warn_record(layer, verdict.get("tier"), verdict.get("reason"))
355
+ except Exception: # noqa: BLE001 诊断面不得冒泡进写入路径
356
+ pass
334
357
  return verdict
335
358
 
336
359
  # 生效条件:要求 self._require_live() 未抛异常、self.theory_ok 为 True、self.can_admin 为 True 时通过;否则抛 AccessDenied(消息用形参 op 标记操作)。
@@ -54,7 +54,8 @@ PINNED_INFO_KEYS = frozenset({
54
54
  })
55
55
 
56
56
  NEW_INFO_KEYS = ("code_generation", "disk_generation", "stale_on_disk",
57
- "restart_required", "hint")
57
+ "restart_required", "hint",
58
+ "write_gate") # issue #708:分层写入闸的进程内计数(warn 观察期)
58
59
 
59
60
  _FAILED = []
60
61
 
@@ -445,7 +445,7 @@ _NEG_UNION = (' neg = list(fm.get("non_applicable_conditions") or
445
445
  ' neg.append(x)\n'
446
446
  ' fm["non_applicable_conditions"] = neg')
447
447
  _TAGS_MAP = ' tags = list(item.get("tags") or [])'
448
- _CS_MAP = ' condition_space=item.get("condition_space"), **extra)'
448
+ _CS_MAP = ' condition_space=item.get("condition_space"),\n reviewed_by=reviewed_by, **extra)'
449
449
 
450
450
  _MUTATIONS = (
451
451
  # ① 契约指定:DEFER 出口**不再透传 meta**(退回 issue50-b 的只传 sensitivity)。
@@ -503,7 +503,7 @@ _MUTATIONS = (
503
503
  # A3[bucket_zh](route_key 读 cs ⇒ 桶别名变)+ B1 + B2 + B3。
504
504
  ("accept 不再映射 condition_space(削弱既有映射)",
505
505
  MdCGOS, "review_decide", _CS_MAP,
506
- ' condition_space=None, **extra)',
506
+ ' condition_space=None,\n reviewed_by=reviewed_by, **extra)',
507
507
  5),
508
508
  # ⑧ 去掉幂等对账(既有职责)。预期:D2 = 1。
509
509
  ("去掉幂等对账 already_decided(既有职责)",
@@ -534,7 +534,7 @@ _ANCHORS_REQUIRED = (
534
534
  (MdCGOS, "remember_gated", '**kw, defer_reason=_why)'),
535
535
  (MdCGOS, "remember_gated", 'elif v == "DEFER":'),
536
536
  (MdCGOS, "remember_gated", 'forgetting._prefeed_id(content)'),
537
- (MdCGOS, "review_decide", 'condition_space=item.get("condition_space"), **extra)'),
537
+ (MdCGOS, "review_decide", ' condition_space=item.get("condition_space"),\n reviewed_by=reviewed_by, **extra)'),
538
538
  (MdCGOS, "review_decide", 'if pid in self._closed_pids():'),
539
539
  )
540
540
 
@@ -0,0 +1,141 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:分层写入闸的可观测性与审计链连续性守卫(issue #708)
3
+ # 生效条件:python -X utf8 -m md_cg.test_issue708_writegate_observable;被测面=writegate.warn_report、security warn 计数、_write_review_record 的 reviewers 透传
4
+ # 子功能:①warn 档写入成功且计数可读(不依赖子进程 stderr)②warn_report 形状与有界性 ③enforce 下审计节点**带** reviewers 能落、**不带**仍被拒(对照证明不是放水)④review_decide→_finish_decision→_record_decision→require_layer_write 全链透传锚点
5
+ # 执行:临时库跑三种角色/三档位,断言返回体与 warn_report;再静态断言调用链透传
6
+ # 验证方式:全部 PASS exit 0,否则 exit 1
7
+ # 不适用条件:不判 DSH 是否转发子进程 stderr(宿主面,本守卫只保证"不依赖它");不判 review_decide 的业务语义
8
+ """issue #708:warn 档不可观测 + enforce 下裁决审计节点被同一闸挡住。
9
+
10
+ 病灶(报告人 Starrain08 实测):
11
+ · warn 档只写子进程 stderr,DSH 不转发进 desktop-next.log ⇒ 用户「完全看不到」,等于没有观察期;
12
+ · enforce 档下 `_write_review_record` 写 structural,而 structural 属 2 档(需 reflect+verify),
13
+ 该调用**不传 reviewers** ⇒ 审计节点被同一个闸挡住(jsonl 还在,可复核的 md 节点没了)。
14
+ """
15
+ import os
16
+ import shutil
17
+ import sys
18
+ import tempfile
19
+
20
+ ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
21
+ sys.path.insert(0, ROOT)
22
+
23
+ _PASS, _FAIL = [], []
24
+
25
+
26
+ def ok(cond, msg, detail=""):
27
+ (_PASS if cond else _FAIL).append(msg)
28
+ print((" PASS " if cond else " FAIL ") + msg + ((" <- " + str(detail)) if detail and not cond else ""))
29
+
30
+
31
+ def _clean_env(T):
32
+ for k in list(os.environ):
33
+ if k.startswith("MDCG_"):
34
+ del os.environ[k]
35
+ os.environ.update(MDCG_ROOT=os.path.join(T, "brain"),
36
+ MDCG_STATE_ROOT=os.path.join(T, "stroot"),
37
+ MDCG_AUX_ROOT=os.path.join(T, "auxroot"),
38
+ MDCG_DATA_ROOT=os.path.join(T, "dataroot"),
39
+ MDCG_EXPORT_ROOT=T, MDCG_SUSTAIN="0", MDCG_SLEEP="0")
40
+
41
+
42
+ def main():
43
+ T = tempfile.mkdtemp(prefix="i708g_")
44
+ try:
45
+ _clean_env(T)
46
+ from md_cg import writegate as wg
47
+ from md_cg.mdcos import MdCGSecure
48
+ from md_cg.security import Principal
49
+ from md_cg.tokens import role_spec
50
+
51
+ def P(role, clr="internal"):
52
+ s = role_spec(role)
53
+ return Principal(role=role, clearance=clr, can_write=s["can_write"],
54
+ can_admin=s["can_admin"], layers_allow=s["layers_allow"],
55
+ ops_allow=s["ops_allow"])
56
+
57
+ print("== A warn 档:写入成功 + 计数可读(#708 病灶①)")
58
+ os.environ["MDCG_WRITE_GATE"] = "warn"
59
+ os.environ["MDCG_REVIEW_CHANNELS"] = "subagent"
60
+ os.environ.pop("MDCG_REVIEWERS", None)
61
+ base = wg.warn_report()
62
+ cg = MdCGSecure(os.path.join(T, "brain"), principal=P("record"), autoflush=1)
63
+ nid = cg.add("probe_k1", "probe content one", layer="knowledge")
64
+ cg.close()
65
+ ok(bool(nid), "A1 warn 档 write knowledge 成功(不阻断)", nid)
66
+ rep = wg.warn_report()
67
+ ok(rep["total"] >= base["total"] + 1,
68
+ "A2 warn 计数 +1(修前不可见:只写 stderr)", (base["total"], rep["total"]))
69
+ ok(any(k.startswith("knowledge@L1") for k in rep["by_layer"]),
70
+ "A3 计数按层分桶(knowledge@L1)", list(rep["by_layer"])[:4])
71
+ ok(bool(rep["recent"]) and "reason" in rep["recent"][-1],
72
+ "A4 recent 摘要含 reason(无内容、无节点 id)", rep["recent"][-1] if rep["recent"] else None)
73
+ ok(rep["mode"] == "warn", "A5 mode 透出", rep["mode"])
74
+
75
+ print("== B warn_report 形状与有界性")
76
+ ok(set(rep) >= {"mode", "total", "by_layer", "recent", "hint"}, "B1 键齐全", sorted(rep))
77
+ ok(len(rep["recent"]) <= 5, "B2 recent 最多 5 条", len(rep["recent"]))
78
+ ok(wg.WARN_RECENT_MAX == 20, "B3 有界常量在位", wg.WARN_RECENT_MAX)
79
+
80
+ print("== C enforce:审计节点带 reviewers 能落(#708 病灶②)")
81
+ os.environ["MDCG_WRITE_GATE"] = "enforce"
82
+ sg = role_spec("designer")
83
+ p = Principal(role="designer", clearance="secret", can_write=sg["can_write"],
84
+ can_admin=sg["can_admin"], layers_allow=sg["layers_allow"],
85
+ ops_allow=sg["ops_allow"])
86
+ cg2 = MdCGSecure(os.path.join(T, "brain"), principal=p, autoflush=1)
87
+ rec = {"pid": "p1", "round": 1, "decision": "accept", "status": "accepted",
88
+ "redteam_verdict": "absent", "issues": [], "verify_hash": "vh",
89
+ "t": 1793000000, "actor": "tester", "target_id": "n1",
90
+ "record_node_id": "audit_p1_r1", "record_hash": "a" * 64}
91
+ try:
92
+ out = cg2._write_review_record(rec, reviewers=("reflect", "verify"))
93
+ ok(bool(out), "C1 带 reviewers ⇒ 审计节点落盘成功", out)
94
+ except Exception as e: # noqa: BLE001
95
+ ok(False, "C1 带 reviewers ⇒ 审计节点落盘成功", "%s: %s" % (type(e).__name__, e))
96
+
97
+ try:
98
+ cg2._write_review_record(dict(rec, record_node_id="audit_p2_r1"), reviewers=None)
99
+ ok(False, "C2 不带 reviewers 仍应被拒(对照:不是放水)", "竟然成功了")
100
+ except Exception as e: # noqa: BLE001
101
+ ok("分层复核闸" in str(e) or "AccessDenied" in type(e).__name__,
102
+ "C2 不带 reviewers 仍被拒(对照)", "%s: %s" % (type(e).__name__, str(e)[:60]))
103
+ cg2.close()
104
+
105
+ print("== D 全链透传锚点(静态)")
106
+ src = open(os.path.join(ROOT, "md_cg", "mdcos.py"), encoding="utf-8").read()
107
+ ok("def _write_review_record(self, rec, reviewers=None)" in src,
108
+ "D1 _write_review_record 接 reviewers")
109
+ ok("reviewed_by=reviewers" in src, "D2 add(...) 透传 reviewed_by")
110
+ # 2026-10-28 改:`reviewed_by` 必须 **pop** 掉(它是闸的输入参数,不是记忆元数据),
111
+ # 否则会经 super().add(**kw) 落进 frontmatter(test_i50c 的 B1 曾因此报白名单外差异)。
112
+ ok('kw.pop("reviewed_by", None)' in src and "reviewers=_reviewers" in src,
113
+ "D3 MdCGSecure.add 用 pop 取出 reviewed_by 交给 require_layer_write(不下传 fm)")
114
+ ok("def _record_decision(self, pid, item, decision, status, reason, round_no," in src,
115
+ "D4 _record_decision 存在")
116
+ ok("_write_review_record(rec, reviewers=reviewers)" in src,
117
+ "D5 _record_decision → _write_review_record 透传")
118
+ ok(src.count("reviewers=reviewed_by)") == 2,
119
+ "D6 两处 _finish_decision 调用点都传 reviewed_by", src.count("reviewers=reviewed_by)"))
120
+
121
+ print("== E 透传后仍需齐备(不得变成万能放行)")
122
+ cg3 = MdCGSecure(os.path.join(T, "brain"), principal=p, autoflush=1)
123
+ try:
124
+ cg3._write_review_record(dict(rec, record_node_id="audit_p3_r1"), reviewers=("reflect",))
125
+ ok(False, "E1 只给 reflect(缺 verify)应被拒(2 档需两者)", "竟然成功了")
126
+ except Exception as e: # noqa: BLE001
127
+ ok("AccessDenied" in type(e).__name__, "E1 只给 reflect 仍被拒", str(e)[:60])
128
+ cg3.close()
129
+ finally:
130
+ shutil.rmtree(T, ignore_errors=True)
131
+
132
+ print()
133
+ print("issue #708 守卫:%d 通过 / %d 失败" % (len(_PASS), len(_FAIL)))
134
+ if _FAIL:
135
+ for f in _FAIL:
136
+ print(" -", f)
137
+ return 0 if not _FAIL else 1
138
+
139
+
140
+ if __name__ == "__main__":
141
+ raise SystemExit(main())