@furongjun1999/dsh-memory 0.4.10 → 0.5.0

package/md_cg/sustain.py

@@ -1,1139 +1,1139 @@
-# -*- coding: utf-8 -*-
-"""md_cg · 持续性自维持（记忆 OS #4）：常驻 / 心跳 / 自愈 / 会话续接
-
-路线图「常驻服务：会话 / 心跳 / 自愈」的落地。回答三个问题：
-
-① 别人怎么知道我还活着？—— **心跳戳**
-   `<net_dir>/heartbeat.<name>.stamp`（原子写，含 ts / pid / uptime / task_running）。
-   分级判定对齐 Mutual Sustain Loop v1.1：正常 / 警告 / 失联，阈值按心跳间隔的
-   2.5× / 3.5×；**任务执行中阈值放宽**（working factor），避免长任务被误判死亡。
-   戳写在仓库外（默认 ~/.mdcg/sustain），不污染知识库，也不随仓库泄露。
-
-② 进程被杀会不会留下坏状态？—— **自愈（diagnose → heal）**
-   诊断只读、不改动；修复动作幂等且逐条留审计：
-     · 索引漂移 / 孤儿索引 → 重建索引（索引是派生物，可安全重建）
-     · 索引增量分片积压 → 合并进快照
-     · 陈旧临时文件     → 清理（被杀死的写者留下的唯一命名 tmp）
-     · 日志半截行       → 补换行（否则下一条记录会粘在断行上）
-     · 私有节点不可解   → **只报告不修**（缺密钥是权限事实，不是故障）
-   原则：修复只碰派生物（索引 / 临时文件 / 日志边界），**永不删节点**。
-
-③ 重启后从哪继续？—— **会话水位（SessionLedger）**
-   `<root>/_sessions.json` 记录每个会话的 (last_t, last_seq, events)，
-   与 `sources.Ingestor` 的 `_sources.json`（源视角水位）互补；重启后
-   `resume_point(session)` 直接给出续接点，不重复摄取、不丢事件。
-
-④ 能力不会被饿死？—— **演化巡检（evolve）**
-   自我演化的三类动作（固化 `consolidate` / 重算重要性 `weights` / 去污染 `scrub`）
-   早已具备，缺的是**驱动源**：没人周期性问「现在有多少该固化 / 该重算的候选」。
-   `evolution_candidates()` 以**索引快照**为口径做只读盘点（零读节点文件、零写盘、
-   确定性），并挂到常驻循环的 `_tick_evolve()` 上。纪律与 self-heal 一致且更严：
-     · 巡检恒只读，`auto_evolve=False`（默认）时**只记账不动库**；
-     · 自愈只放行**确定性且可回滚**的动作（重要性重算，有 rollback）；
-     · 依赖 LLM 的固化**永不自动跑**——巡检报出候选数，交人工另批。
-
-⑤ 演进血缘有没有断？—— **派生溯源巡检（G8）**
-   新增节点在建链时把 `derived_from` 写进 frontmatter 并追加到 `<root>/_link.jsonl`。
-   可台账会丢、节点会被删，于是血缘会出现**悬空边**（子/父节点已不在库里）。
-   `diagnose()` 每次都做只读盘点（零读节点文件：索引已带 `derived_from`），把悬空边
-   报为 `provenance_dangling`（severity=info、**无自动修复**）——关系事实的去留由人
-   处置，不给「自动删边」这种会篡改历史的动作。
-
-⑥ 对端挂了谁来救？—— **互维闭环（P-T-110 最小投影 · #30）**
-   两个灵枢互为维生系统：`mutual_watch` 读对端心跳 → 失联则**幂等拉起**
-   （pid 探活防误判 + 冷却防风暴）→ **验戳新鲜闭合**：拉起后必须轮询到
-   对端戳变新才算救活，否则如实报 `mutual_peer_unresponsive`——这正是
-   mutual-sustain-loop v1.1 §7 的 W4 部署教训（「拉起后应验证对端戳新鲜度，
-   当时缺该校验」）的机制化：不假装成功。`mutual_status` 做双亡检测：
-   自己也失联时互维本身不可信 → 显式上报外部告警语义，绝不静默。
-
-零第三方依赖。
-"""
-from __future__ import annotations
-
-import json
-import os
-import threading
-import time
-
-from . import crypto
-from .fsutil import append_jsonl, atomic_write, ends_mid_line
-from .mdcg import LAYERS
-
-STAMP_VERSION = 1
-SUSTAIN_LOG = "_sustain.jsonl"
-LEDGER_FILE = "_sessions.json"
-
-DEFAULT_BEAT_INTERVAL = 600.0     # 心跳间隔 10min（对齐 mutual-sustain-loop）
-DEFAULT_HEAL_INTERVAL = 300.0     # 自愈巡检 5min
-DEFAULT_SCRUB_INTERVAL = 3600.0   # 记忆自净（抽查/去污染/校准）1h
-DEFAULT_EVOLVE_INTERVAL = 7200.0  # 演化巡检（固化/重要性候选盘点）2h；只读
-DEFAULT_TIDY_INTERVAL = 21600.0   # 整理巡检（contextual 同构组聚合）6h
-DEFAULT_WARN_FACTOR = 2.5         # 2.5× 心跳间隔 → 警告
-DEFAULT_DEAD_FACTOR = 3.5         # 3.5× → 失联
-DEFAULT_WORKING_FACTOR = 2.0      # 任务执行中阈值 ×2
-STALE_TEMP_AGE = 3600.0           # 临时文件超过 1h 视为陈旧
-_POLL = 0.2                       # 循环轮询步长（常驻进程 CPU 可忽略）
-
-
-# --------------------------------------------------------------------------
-# 心跳
-# --------------------------------------------------------------------------
-
-# 生效条件：d 为真值时返回 d，d 为 None/空串时回落 MDCG_SUSTAIN_DIR，该环境变量也未设或为空串时返回 os.path.join(os.path.expanduser("~"), ".mdcg", "sustain")；
-def net_dir(d: str = None) -> str:
-    """心跳戳目录：显式 → MDCG_SUSTAIN_DIR → ~/.mdcg/sustain（仓库外）。"""
-    return (d or os.environ.get("MDCG_SUSTAIN_DIR")
-            or os.path.join(os.path.expanduser("~"), ".mdcg", "sustain"))
-
-
-# 生效条件：给定必填 name，返回 net_dir(d) 下 heartbeat.<name>.stamp 的拼接路径。
-def stamp_path(name: str, d: str = None) -> str:
-    return os.path.join(net_dir(d), f"heartbeat.{name}.stamp")
-
-
-# 生效条件：name 必填，组装含模块常量 STAMP_VERSION 与 task_running 的戳记录、原子写入 stamp_path(name,d) 后返回该 rec。
-def write_stamp(name: str, d: str = None, **extra) -> dict:
-    """写一次心跳（原子替换）。extra 会并入戳内容（None 值丢弃）。"""
-    rec = {"v": STAMP_VERSION, "name": name, "ts": time.time(),
-           "pid": os.getpid(),
-           "iso": time.strftime("%Y-%m-%dT%H:%M:%S"),
-           "task_running": bool(extra.pop("task_running", False))}
-    for k, v in extra.items():
-        if v is not None:
-            rec[k] = v
-    atomic_write(stamp_path(name, d),
-                 json.dumps(rec, ensure_ascii=False, indent=1))
-    return rec
-
-
-# 生效条件：stamp_path(name, d) 所得路径上 os.path.exists 为真且 json.load 结果为 dict 时，返回该 rec 并附加 age=max(0.0, time.time() - float(rec.get("ts") or 0))；该路径不可读、json.load 抛 ValueError/OSError 或 rec 非 dict 时返回 None；
-def read_stamp(name: str, d: str = None):
-    """读心跳戳并附 age（秒）；不存在 / 损坏 → None。"""
-    p = stamp_path(name, d)
-    if not os.path.exists(p):
-        return None
-    try:
-        with open(p, encoding="utf-8") as f:
-            rec = json.load(f)
-    except (ValueError, OSError):
-        return None
-    if not isinstance(rec, dict):
-        return None
-    rec["age"] = max(0.0, time.time() - float(rec.get("ts") or 0))
-    return rec
-
-
-# 生效条件：对 stamp_path(name,d) 执行 os.remove，OSError 被静默忽略，无返回值。
-def clear_stamp(name: str, d: str = None):
-    try:
-        os.remove(stamp_path(name, d))
-    except OSError:
-        pass
-
-
-# 生效条件：age 为 None 返回 'absent'；否则以 factor=working if task_running else 1.0 比较 age 与 interval*warn*factor、interval*dead*factor，分别返回 'ok'/'warning'/'dead'。
-def judge(age, *, interval: float = DEFAULT_BEAT_INTERVAL,
-          task_running: bool = False, warn: float = DEFAULT_WARN_FACTOR,
-          dead: float = DEFAULT_DEAD_FACTOR,
-          working: float = DEFAULT_WORKING_FACTOR) -> str:
-    """按心跳年龄分级：ok / warning / dead / absent。
-
-    task_running=True 时阈值整体放宽 working 倍——长任务期间不写心跳是正常的，
-    若不放宽会把「正在干活」误判成「已死」。
-    """
-    if age is None:
-        return "absent"
-    factor = working if task_running else 1.0
-    if age <= interval * warn * factor:
-        return "ok"
-    if age <= interval * dead * factor:
-        return "warning"
-    return "dead"
-
-
-# 生效条件：net_dir(d) 可列为目录时遍历 heartbeat.*.stamp 并返回含 age 与 state 的记录列表，否则返回 []。
-def peers(d: str = None):
-    """列出本机所有心跳戳（含状态）。"""
-    base = net_dir(d)
-    if not os.path.isdir(base):
-        return []
-    out = []
-    for fn in sorted(os.listdir(base)):
-        if not (fn.startswith("heartbeat.") and fn.endswith(".stamp")):
-            continue
-        rec = read_stamp(fn[len("heartbeat."):-len(".stamp")], base)
-        if rec:
-            rec["state"] = judge(rec["age"],
-                                 task_running=bool(rec.get("task_running")))
-            out.append(rec)
-    return out
-
-
-# --------------------------------------------------------------------------
-# 互维闭环（P-T-110 最小投影 · #30）
-# --------------------------------------------------------------------------
-
-DEFAULT_RESTART_COOLDOWN = 300.0   # 同一对端两次拉起的最小间隔（防风暴）
-DEFAULT_FRESH_TIMEOUT = 60.0       # 拉起后等待对端戳变新鲜的窗口
-
-
-# 生效条件：pid 可转 int 且 >0 时按探活（os.name=='nt' 用 OpenProcess+WaitForSingleObject，否则 os.kill(pid,0)）返回 True，转 int 失败或 pid<=0 或探活失败返回 False。
-def pid_alive(pid) -> bool:
-    """进程探活（零第三方依赖）：Windows=OpenProcess+WaitForSingleObject；
-    posix=os.kill(pid,0)。pid 无效 / 已退出 / 权限外 → False（诚实）。"""
-    try:
-        pid = int(pid)
-    except (TypeError, ValueError):
-        return False
-    if pid <= 0:
-        return False
-    if os.name == "nt":
-        import ctypes
-        SYNCHRONIZE = 0x00100000
-        WAIT_TIMEOUT = 0x00000102
-        k32 = ctypes.windll.kernel32
-        h = k32.OpenProcess(SYNCHRONIZE, False, pid)
-        if not h:
-            return False
-        try:
-            return k32.WaitForSingleObject(h, 0) == WAIT_TIMEOUT
-        finally:
-            k32.CloseHandle(h)
-    try:
-        os.kill(pid, 0)
-        return True
-    except OSError:
-        return False
-
-
-# 生效条件：cmd 为 argv 列表时以 stdout/stderr=DEVNULL、不经 shell 的 subprocess.Popen 拉起（nt 附加 DETACHED|NEW_GROUP creationflags），返回该 Popen 对象。
-def _default_spawner(cmd):
-    """分离式拉起：argv 列表、不经 shell、输出弃置（Windows 完全脱离父控制台）。"""
-    import subprocess
-    kw = {}
-    if os.name == "nt":
-        kw["creationflags"] = (0x00000008 | 0x00000200)  # DETACHED|NEW_GROUP
-    return subprocess.Popen(cmd, stdout=subprocess.DEVNULL,
-                            stderr=subprocess.DEVNULL, **kw)
-
-
-# 生效条件：root 与 peer 必填，扫描 root/SUSTAIN_LOG（模块常量）返回 op='mutual'、action='restart' 且 detail 以 peer 开头的记录中最大 t，无匹配返回 0.0。
-def _last_mutual_restart(root: str, peer: str) -> float:
-    """_sustain.jsonl 里该对端最近一次互维拉起时间（无 → 0.0，审计即状态）。"""
-    last = 0.0
-    try:
-        with open(os.path.join(root, SUSTAIN_LOG), encoding="utf-8") as f:
-            for line in f:
-                try:
-                    r = json.loads(line)
-                except ValueError:
-                    continue
-                if (r.get("op") == "mutual" and r.get("action") == "restart"
-                        and str(r.get("detail") or "").startswith(str(peer))):
-                    last = max(last, float(r.get("t") or 0.0))
-    except OSError:
-        pass
-    return last
-
-
-# 生效条件：cg 与 peer 必填，读对端戳判状态：ok/warning 直接返回 action='none'；dead/absent 时依次按 pid_alive、restart_cooldown、restart_cmd 有无走 alive_but_stale/restart_cooldown/dead_unhandled/拉起并验戳，返回 out。
-def mutual_watch(cg, peer: str, *, restart_cmd=None, d: str = None,
-                 interval: float = DEFAULT_BEAT_INTERVAL,
-                 restart_cooldown: float = DEFAULT_RESTART_COOLDOWN,
-                 fresh_timeout: float = DEFAULT_FRESH_TIMEOUT, poll: float = 0.5,
-                 spawner=None) -> dict:
-    """互维守护（单侧一次检查）：读对端心跳 → 失联则幂等拉起 → 验戳闭合。
-
-    判定序（P-T-110 语义，全链路审计进 _sustain.jsonl）：
-      ok/warning        → 不动作；
-      dead/absent：
-        ① 误判防护：戳里 pid 仍存活 → `alive_but_stale`（长任务未标
-           task_running？）——**不拉起**，不杀活进程；
-        ② 冷却：距上次拉起 < restart_cooldown → `restart_cooldown`；
-        ③ 无 restart_cmd → `dead_unhandled`（ok=False，诚实上报没手段，
-           不假装能救）；
-        ④ 拉起（spawner 或分离式 Popen）→ **验戳新鲜闭合**（W4 补丁）：
-           轮询对端戳 ts 超过拉起前值才算 `recovered=True`；超时 →
-           `recovered=False` + `mutual_peer_unresponsive`——对端拉起后
-           互维未激活（v1.1 §7 的 W4 场景）会被显式暴露，不假装成功。
-    """
-    rec = read_stamp(peer, d)
-    state = (judge(rec["age"], interval=interval,
-                   task_running=bool(rec.get("task_running")))
-             if rec else "absent")
-    out = {"ok": True, "peer": peer, "state": state, "t": time.time(),
-           "action": "none", "recovered": None}
-    if state in ("ok", "warning"):
-        return out
-    if rec and pid_alive(rec.get("pid")):
-        out.update(action="alive_but_stale",
-                   note="对端进程存活但戳陈旧（长任务未标 task_running？）——不拉起")
-        _audit(cg.root, "mutual", "alive_but_stale", peer)
-        return out
-    last = _last_mutual_restart(cg.root, peer)
-    if last and (time.time() - last) < restart_cooldown:
-        out.update(action="restart_cooldown",
-                   note="距上次拉起 %.1fs，冷却中" % (time.time() - last))
-        return out
-    if not restart_cmd:
-        out.update(ok=False, action="dead_unhandled",
-                   note="对端失联且未提供 restart_cmd——诚实上报，不假装能救")
-        _audit(cg.root, "mutual", "dead_unhandled", peer)
-        return out
-    before_ts = float((rec or {}).get("ts") or 0.0)
-    spawn = spawner or _default_spawner
-    try:
-        spawn(restart_cmd)
-    except Exception as e:                                 # noqa: BLE001
-        out.update(ok=False, action="restart_error",
-                   error="%s: %s" % (type(e).__name__, e))
-        _audit(cg.root, "mutual", "restart_error", peer)
-        return out
-    deadline = time.time() + fresh_timeout
-    while time.time() < deadline:
-        r2 = read_stamp(peer, d)
-        if r2 and float(r2.get("ts") or 0.0) > before_ts:
-            out.update(action="restarted", recovered=True, fresh_ts=r2.get("ts"))
-            _audit(cg.root, "mutual", "restart", peer)
-            return out
-        time.sleep(poll)
-    out.update(ok=False, action="restarted", recovered=False,
-               note=("拉起命令已执行但对端戳未更新（互维未激活？）——"
-                     "mutual_peer_unresponsive，不假装成功"))
-    _audit(cg.root, "mutual", "restart_unverified", peer)
-    return out
-
-
-# 生效条件：cg 与 peer 必填，分别按 name 与 peer 读戳判状态，仅当自身与对端状态均属 ('dead','absent') 时返回 ok=False、both_dead=True。
-def mutual_status(cg, peer: str, *, d: str = None, name: str = "md_cg",
-                  interval: float = DEFAULT_BEAT_INTERVAL) -> dict:
-    """互维状态 + 双亡检测：自己也失联时互维不可信 → 显式外部告警语义。"""
-    mine, theirs = read_stamp(name, d), read_stamp(peer, d)
-    my_state = (judge(mine["age"], interval=interval,
-                      task_running=bool(mine.get("task_running")))
-                if mine else "absent")
-    peer_state = (judge(theirs["age"], interval=interval,
-                        task_running=bool(theirs.get("task_running")))
-                  if theirs else "absent")
-    dead = ("dead", "absent")
-    both_dead = my_state in dead and peer_state in dead
-    return {"ok": not both_dead, "self": my_state, "peer": peer_state,
-            "both_dead": both_dead,
-            "note": ("双向同时失联：互维本身已不可信，须外部告警（P-T-110 风险表）"
-                     if both_dead else "互维链路可用")}
-
-
-# --------------------------------------------------------------------------
-# 诊断（只读）
-# --------------------------------------------------------------------------
-
-# 生效条件：root 必填，对模块常量 LAYERS 各层 os.walk 统计以 .md 结尾的文件名个数并返回 n（不解析正文）。
-def _count_node_files(root: str) -> int:
-    """轻量统计磁盘节点数（只数文件名，不解析正文）。"""
-    n = 0
-    for layer in LAYERS:
-        for _dp, _dirs, files in os.walk(os.path.join(root, layer)):
-            n += sum(1 for f in files if f.endswith(".md"))
-    return n
-
-
-# 生效条件：root 与 older_than 必填，返回 root 及其 LAYERS 各层下以 '.' 开头、名含 '.tmp-' 且 mtime 早于 now-older_than 的路径列表。
-def _list_stale_temps(root: str, older_than: float):
-    now, out = time.time(), []
-    bases = [root] + [os.path.join(root, l) for l in LAYERS]
-    for base in bases:
-        if not os.path.isdir(base):
-            continue
-        for name in os.listdir(base):
-            if ".tmp-" not in name or not name.startswith("."):
-                continue
-            p = os.path.join(base, name)
-            try:
-                if now - os.path.getmtime(p) > older_than:
-                    out.append(p)
-            except OSError:
-                pass
-    return out
-
-
-# 生效条件：root 必填，返回 root 顶层以 .jsonl/.log 结尾且 ends_mid_line 为真的路径列表；root 非目录返回 []。
-def _half_line_logs(root: str):
-    """顶层行式日志里末尾不是换行的（写者被杀留下的半截记录）。"""
-    out = []
-    if not os.path.isdir(root):
-        return out
-    for name in sorted(os.listdir(root)):
-        if not (name.endswith(".jsonl") or name.endswith(".log")):
-            continue
-        p = os.path.join(root, name)
-        if os.path.isfile(p) and ends_mid_line(p):
-            out.append(p)
-    return out
-
-
-# 生效条件：root/_index_log 可列为目录时返回其中 .log 结尾的文件名列表，否则返回 []。
-def _index_log_shards(root: str):
-    d = os.path.join(root, "_index_log")
-    if not os.path.isdir(d):
-        return []
-    return [f for f in os.listdir(d) if f.endswith(".log")]
-
-
-# 生效条件：cg 具备 crypto_status 且其返回 unlocked 为假时，返回 cg.index['nodes'] 中 sensitivity 属 crypto.ENCRYPTED_LEVELS 的条目数；属性缺失、调用异常或已解锁时返回 0。
-def _locked_nodes(cg) -> int:
-    """加密引擎在「未解锁」状态下被隔离的私有节点数（缺密钥 = 权限事实）。"""
-    if not hasattr(cg, "crypto_status"):
-        return 0
-    try:
-        st = cg.crypto_status() or {}
-    except Exception:
-        return 0
-    if st.get("unlocked"):
-        return 0
-    nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
-    return sum(1 for e in nodes.values()
-               if (e.get("sensitivity") or "") in crypto.ENCRYPTED_LEVELS)
-
-
-# --------------------------------------------------------------------------
-# 演化巡检（G7：给「固化 / 重要性」能力装上驱动源）
-# --------------------------------------------------------------------------
-
-#: 演化巡检项 → 对应的写入动作（`scrub` 已有独立 tick，不并入此项）
-EVOLVE_FIXES = {"ccg_backlog": "consolidate_run",
-                "importance_drift": "importance"}
-
-
-# 生效条件：nodes 与 top 必填，遍历索引条目统计缺 verification_basis 或 has_neg_conditions 的候补数 n、no_basis、no_neg 并取最多 top 个 sample，返回含 proxy=True 与 EVOLVE_FIXES['ccg_backlog'] 的字典。
-def _ccg_backlog(nodes: dict, top: int) -> dict:
-    """固化候补量（**索引代理指标**：零读节点文件、确定性、O(N)）。
-
-    真正的固化闸门在 `consolidate`（四要素 + 验证基底 + 白箱 replay，需读正文与 LLM）。
-    巡检只要**驱动信号**：索引里的 `verification_basis` / `has_neg_conditions` 已能
-    区分「有/无验证基底」「有/无负条件」，足够回答「有没有货等着固化」。
-
-    代理指标 ≠ 判定结论：报出的是**候补量**，不是「这些节点确实该固化」。
-    """
-    n = no_basis = no_neg = 0
-    sample = []
-    for nid, e in nodes.items():
-        mb = not e.get("verification_basis")
-        mn = not e.get("has_neg_conditions")
-        no_basis += 1 if mb else 0
-        no_neg += 1 if mn else 0
-        if mb or mn:
-            n += 1
-            if len(sample) < top:
-                sample.append(nid)
-    return {"n": n, "no_basis": no_basis, "no_neg": no_neg, "sample": sample,
-            "proxy": True, "fix": EVOLVE_FIXES["ccg_backlog"]}
-
-
-# 生效条件：cg 必填，取 cg.index['nodes']（layer 非空时按 layer 过滤），经 weights.recalc(apply=False) 与 _ccg_backlog 汇总，返回 ok=True、readonly=True、dry_run=True 的候选盘点字典。
-def evolution_candidates(cg, *, layer: str = None, top: int = 8,
-                         min_delta: float = None) -> dict:
-    """演化候选盘点（G7）：**只读、零读节点文件、确定性、不写盘**。
-
-    回答「现在有多少该固化 / 该重算重要性的候选」，供常驻巡检与人工决策。
-    与 `diagnose()`（故障体检）刻意分开：这里盘的是**演化工作量**，不是故障——
-    候补多不代表库有毛病，故 `ok` 恒 True、severity 恒 info。
-
-    `importance_drift` 复用 `weights.recalc(apply=False)`（纯数学，不读文件）；
-    `ccg_backlog` 用索引代理指标。二者都不碰节点内容。
-    """
-    nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
-    if layer:
-        nodes = {k: v for k, v in nodes.items() if v.get("layer") == layer}
-    from . import weights
-    md = weights.APPLY_DELTA if min_delta is None else float(min_delta)
-    imp = weights.recalc(cg, layer=layer, apply=False, min_delta=md,
-                         dry_run_samples=top)
-    cb = _ccg_backlog(nodes, top)
-    idr = {"n": imp["changed"], "scanned": imp["nodes_scanned"],
-           "min_delta": imp["min_delta"],
-           "sample": [s["node_id"] for s in imp["samples"]],
-           "fix": EVOLVE_FIXES["importance_drift"]}
-    return {"ok": True, "action": "evolve_check", "op": "sustain",
-            "root": cg.root, "t": time.time(), "readonly": True, "dry_run": True,
-            "nodes": len(nodes), "top": top, "layer": layer,
-            "ccg_backlog": cb, "importance_drift": idr,
-            "candidates": cb["n"] + idr["n"],
-            "by_fix": {EVOLVE_FIXES["ccg_backlog"]: cb["n"],
-                       EVOLVE_FIXES["importance_drift"]: idr["n"]},
-            "note": ("只读盘点：未写盘、未改任何节点；固化需 LLM（交人工/另批），"
-                     "重要性重算为确定性动作（有 rollback）")}
-
-
-# 生效条件：给定 cg 后只读汇总（nodes 取自 cg.index、disk 计数、refindex.check_refs），stale_temp_age 传入 _list_stale_temps；check_heartbeat / check_evolution(evolve_top) / check_provenance(provenance_top) 为真时分别追加对应 issue，返回 ok = 无 severity=="warning" 的 issue 连同 stats。
-def diagnose(cg, *, name: str = "md_cg", stale_temp_age: float = STALE_TEMP_AGE,
-             check_heartbeat: bool = True, check_evolution: bool = True,
-             evolve_top: int = 5, check_provenance: bool = True,
-             provenance_top: int = 5) -> dict:
-    """只读体检：返回 issues（带 fix 名）与 stats，不改动任何文件。"""
-    root = cg.root
-    issues = []
-    nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
-    disk = _count_node_files(root)
-
-    if len(nodes) != disk:
-        issues.append({"code": "index_drift", "severity": "warning",
-                       "detail": f"索引 {len(nodes)} ≠ 磁盘 {disk}",
-                       "fix": "rebuild_index"})
-    orphans = [nid for nid, e in nodes.items()
-               if e.get("path")
-               and not os.path.exists(os.path.join(root, e["path"]))]
-    if orphans:
-        issues.append({"code": "index_orphan", "severity": "warning",
-                       "detail": f"{len(orphans)} 条索引指向不存在的文件",
-                       "sample": orphans[:5], "fix": "rebuild_index"})
-
-    shards = _index_log_shards(root)
-    if shards:
-        issues.append({"code": "index_log_backlog", "severity": "info",
-                       "detail": f"{len(shards)} 个索引增量分片未合并",
-                       "fix": "flush_index"})
-
-    temps = _list_stale_temps(root, stale_temp_age)
-    if temps:
-        issues.append({"code": "stale_temps", "severity": "info",
-                       "detail": f"{len(temps)} 个陈旧临时文件",
-                       "sample": [os.path.basename(p) for p in temps[:5]],
-                       "fix": "sweep_temps"})
-
-    half = _half_line_logs(root)
-    if half:
-        issues.append({"code": "half_line_logs", "severity": "warning",
-                       "detail": f"{len(half)} 个日志末尾半截行",
-                       "sample": [os.path.basename(p) for p in half[:5]],
-                       "fix": "seal_half_lines"})
-
-    locked = _locked_nodes(cg)
-    if locked:
-        issues.append({"code": "locked_nodes", "severity": "info",
-                       "detail": f"{locked} 个私有节点密文不可解（缺密钥）",
-                       "fix": None})   # 权限事实，不自愈
-
-    # ref 漂移 / 悬空（R3）：索引是派生物，源变了就报 stale，源没了就报 dangling。
-    # 只读、不抛；修复动作是重跑 index_code / index_doc（rebuild_refs）。
-    from . import refindex
-    refs = refindex.check_refs(cg, ledger=refindex.Ledger(root))
-    if refs["stale"]:
-        issues.append({"code": "ref_stale", "severity": "warning",
-                       "detail": f"{len(refs['stale'])} 个 ref 漂移（源文件已改动）",
-                       "sample": [r.get("path") for r in refs["stale"][:5]],
-                       "fix": "rebuild_refs"})
-    if refs["dangling"]:
-        issues.append({"code": "ref_dangling", "severity": "warning",
-                       "detail": f"{len(refs['dangling'])} 个 ref 悬空（源文件已删除）",
-                       "sample": [r.get("path") for r in refs["dangling"][:5]],
-                       "fix": "rebuild_refs"})
-    if refs.get("truncated"):
-        issues.append({"code": "ref_check_truncated", "severity": "info",
-                       "detail": f"ref 巡检只覆盖前 {refs['max_nodes']} 个节点，结果不完整",
-                       "fix": None})   # 覆盖缺口，显式说出来而非静默
-
-    if check_heartbeat:
-        st = read_stamp(name)
-        state = (judge(st["age"], task_running=bool(st.get("task_running")))
-                 if st else "absent")
-        if state != "ok":
-            issues.append({"code": "heartbeat_" + state, "severity": "info",
-                           "detail": f"本机心跳状态：{state}", "fix": "beat"})
-
-    # ---- 演化巡检（G7）：盘的是「该做多少事」，不是「库有毛病」，
-    #      故 severity 恒 info（不影响 ok），且全程只读、零读节点文件。
-    evolve = None
-    if check_evolution:
-        evolve = evolution_candidates(cg, top=evolve_top)
-        cb, idr = evolve["ccg_backlog"], evolve["importance_drift"]
-        if cb["n"]:
-            issues.append({"code": "ccg_backlog", "severity": "info",
-                           "detail": (f"{cb['n']} 个固化候补"
-                                      f"（索引代理：无验证基底 {cb['no_basis']}"
-                                      f" / 无负条件 {cb['no_neg']}）"),
-                           "sample": cb["sample"], "fix": cb["fix"],
-                           "proxy": True})
-        if idr["n"]:
-            issues.append({"code": "importance_drift", "severity": "info",
-                           "detail": (f"{idr['n']} 个节点结构重要性偏离 "
-                                      f"≥{idr['min_delta']}（可重算）"),
-                           "sample": idr["sample"], "fix": idr["fix"]})
-
-    # ---- 派生溯源巡检（G8）：只读检出悬空派生边（端点已不在索引内）。
-    #      **无自动修复**：删边等于篡改演进血缘，只报告、由人处置；
-    #      故 severity 恒 info（不影响 ok、不触发自愈），零读节点文件。
-    prov = None
-    if check_provenance:
-        from . import provenance as _pv
-        prov = _pv.check(cg, limit=provenance_top)
-        if prov["dangling_count"]:
-            issues.append({"code": "provenance_dangling", "severity": "info",
-                           "detail": (f"{prov['dangling_count']} 条派生边悬空"
-                                      f"（{prov['edges']} 条边中，端点不在索引内）"),
-                           "sample": [f"{r['child']}->{r['parent']}"
-                                      for r in prov["dangling"]],
-                           "fix": None})   # 关系事实：只检出，不自动删边
-
-    return {"ok": not any(i["severity"] == "warning" for i in issues),
-            "root": root, "issues": issues, "t": time.time(),
-            "evolve": evolve, "provenance": prov,
-            "stats": {"nodes_indexed": len(nodes), "nodes_on_disk": disk,
-                      "index_log_shards": len(shards), "stale_temps": len(temps),
-                      "half_line_logs": len(half), "locked_nodes": locked,
-                      "ref_checked": refs["checked"],
-                      "ref_stale": len(refs["stale"]),
-                      "ref_dangling": len(refs["dangling"]),
-                      "provenance_edges": (prov["edges"] if prov else 0),
-                      "provenance_dangling":
-                          (prov["dangling_count"] if prov else 0),
-                      "evolve_candidates":
-                          (evolve["candidates"] if evolve else 0)}}
-
-
-# --------------------------------------------------------------------------
-# 自愈
-# --------------------------------------------------------------------------
-
-# 生效条件：path 必填，以 'ab' 模式向该路径追加写入单个换行 b'\n'，无返回值。
-def _seal_half_line(path: str):
-    with open(path, "ab") as f:
-        f.write(b"\n")
-
-
-# 生效条件：root/op/action 必填，向 root/SUSTAIN_LOG（模块常量）追加一行含 t/op/action/detail(截断 200)/pid 的 JSONL，无返回值。
-def _audit(root: str, op: str, action: str, detail: str = ""):
-    append_jsonl(os.path.join(root, SUSTAIN_LOG),
-                 {"t": time.time(), "op": op, "action": action,
-                  "detail": str(detail)[:200], "pid": os.getpid()})
-
-
-# 生效条件：按 diagnose(cg, name=name, stale_temp_age=stale_temp_age) 的 issues code 集合分派——命中 index_drift/index_orphan 重建索引、ref_stale/ref_dangling 按 ref 重建源索引、index_log_backlog 合并索引分片、stale_temps 清理陈旧临时文件、half_line_logs 修补半截日志；ccg_backlog 仅 allow_evolve=True 且 reflect_fn 非 None 时才 consolidate（否则记 needs_llm），importance_drift 仅 allow_evolve=True 时才重算重要性（否则记 evolve_disabled）；dry_run=True 时各动作只记入 actions 不落盘，返回含 after["ok"]、dry_run、actions、before/after 的 stats 与 t 的 dict；
-def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
-         stale_temp_age: float = STALE_TEMP_AGE,
-         allow_evolve: bool = False, reflect_fn=None, verify_fn=None) -> dict:
-    """按诊断结果修复派生物。dry_run=True 时只列动作、不落盘。
-
-    演化类动作（G7）默认**不动**，须显式 `allow_evolve=True` 才放行，且只放行
-    **确定性**动作（重要性重算，有 rollback）；依赖 LLM 的固化永不自动跑。
-    """
-    before = diagnose(cg, name=name, stale_temp_age=stale_temp_age)
-    codes = {i["code"] for i in before["issues"]}
-    root = cg.root
-    actions = []
-
-# 生效条件：闭包 dry_run 为真时向 actions 追加 {"code": code, "detail": detail, "applied": False} 并返回；否则调用 fn()，成功追加 applied=True/ok=True，抛异常时追加 applied=True/ok=False 与 error，最后执行 _audit(root, "heal", code, detail)；
-    def act(code: str, detail: str, fn):
-        if dry_run:
-            actions.append({"code": code, "detail": detail, "applied": False})
-            return
-        try:
-            fn()
-            actions.append({"code": code, "detail": detail,
-                            "applied": True, "ok": True})
-        except Exception as e:                       # 自愈失败不能拖垮进程
-            actions.append({"code": code, "detail": detail, "applied": True,
-                            "ok": False, "error": f"{type(e).__name__}: {e}"})
-        _audit(root, "heal", code, detail)
-
-    if "index_drift" in codes or "index_orphan" in codes:
-        act("rebuild_index", "重建索引（漂移 / 孤儿）", cg.rebuild_index)
-    if "ref_stale" in codes or "ref_dangling" in codes:
-        from . import refindex as _ri
-        _led = _ri.Ledger(root)
-        act("rebuild_refs", "按 ref 重建源索引（修复漂移；悬空需人工处置）",
-            lambda: _ri.rebuild(cg, ledger=_led))
-    if "index_log_backlog" in codes:
-        act("flush_index", "合并索引增量分片", cg.flush)
-    if "stale_temps" in codes:
-        paths = _list_stale_temps(root, stale_temp_age)
-
-# 生效条件：对闭包变量 paths 中每个路径尝试 os.remove(p)，单个路径的 OSError 被吞掉后继续处理后续路径；
-        def _sweep():
-            for p in paths:
-                try:
-                    os.remove(p)
-                except OSError:
-                    pass
-        act("sweep_temps", f"清理 {len(paths)} 个陈旧临时文件", _sweep)
-    if "half_line_logs" in codes:
-        paths = _half_line_logs(root)
-        act("seal_half_lines", f"修补 {len(paths)} 个半截日志行",
-            lambda: [_seal_half_line(p) for p in paths])
-
-    # ---- 演化类修复（G7）：默认关闭，且只放行确定性动作 ----
-    if "ccg_backlog" in codes:
-        det = next((i for i in before["issues"] if i["code"] == "ccg_backlog"), {})
-        detail = f"{det.get('detail', '固化候补')}；固化需 LLM 反思/验证"
-        if allow_evolve and reflect_fn is not None:
-            from . import consolidate as _cd
-
-# 生效条件：调用时返回 _cd.consolidate(cg.root, apply=True, reflect_fn=reflect_fn, verify_fn=verify_fn)；
-            def _consolidate():
-                return _cd.consolidate(cg.root, apply=True,
-                                       reflect_fn=reflect_fn,
-                                       verify_fn=verify_fn)
-            act("consolidate_run", detail, _consolidate)
-        else:
-            actions.append({"code": "consolidate_run", "detail": detail,
-                            "applied": False, "reason": "needs_llm"})
-    if "importance_drift" in codes:
-        if allow_evolve:
-            from . import weights
-
-# 生效条件：调用时返回 weights.recalc(cg, apply=True, actor="sustain_evolve")；
-            def _importance():
-                return weights.recalc(cg, apply=True, actor="sustain_evolve")
-            act("importance", "重算结构重要性（确定性；可 rollback）", _importance)
-        else:
-            actions.append({"code": "importance",
-                            "detail": "重算结构重要性（确定性动作）",
-                            "applied": False, "reason": "evolve_disabled"})
-
-    after = (before if dry_run
-             else diagnose(cg, name=name, stale_temp_age=stale_temp_age))
-    return {"ok": after["ok"], "dry_run": dry_run, "actions": actions,
-            "before": before["stats"], "after": after["stats"],
-            "t": time.time()}
-
-
-# --------------------------------------------------------------------------
-# 会话水位（重启续接）
-# --------------------------------------------------------------------------
-
-# 生效条件：以 root 实例化后账本固定指向 os.path.join(root, LEDGER_FILE)，其 _load/_save/note/resume_point/sessions/summary 均以该路径为唯一读写对象；
-class SessionLedger:
-    """会话水位账本：<root>/_sessions.json。
-
-    与 sources.Ingestor 的水位互补：Ingestor 记「某个源读到哪」，
-    这里记「某个会话发生过什么」——重启后按会话给出续接点。
-    """
-
-# 生效条件：传入 root 时置 self.root=root 且 self.path=os.path.join(root, LEDGER_FILE)，不做其他校验；
-    def __init__(self, root: str):
-        self.root = root
-        self.path = os.path.join(root, LEDGER_FILE)
-
-# 生效条件：self.path（root/LEDGER_FILE）可读且 json 结果为 dict、且 d.get("sessions") 也是 dict 时返回该 d；self.path 不可读、json.load 抛 ValueError/OSError、或 d 非 dict / sessions 非 dict 时返回 {"schema": 1, "sessions": {}}；
-    def _load(self):
-        if os.path.exists(self.path):
-            try:
-                with open(self.path, encoding="utf-8") as f:
-                    d = json.load(f)
-                if isinstance(d, dict) and isinstance(d.get("sessions"), dict):
-                    return d
-            except (ValueError, OSError):
-                pass
-        return {"schema": 1, "sessions": {}}
-
-# 生效条件：传入 d 时执行 atomic_write(self.path, json.dumps(d, ensure_ascii=False, indent=1))，自身无返回值；
-    def _save(self, d):
-        atomic_write(self.path, json.dumps(d, ensure_ascii=False, indent=1))
-
-# 生效条件：以 session 为键 setdefault 会话记录后写 events=int(s.get("events") or 0)+int(n)（n 默认 1，n=0 时计数不变），t 非 None 时写 last_t 且 first_t 为空时一并写入，seq 非 None 时写 last_seq，actor 为真值时写 actor，最后写 updated_at 并 _save，返回 dict(s, session=session)；
-    def note(self, session: str, *, t=None, seq=None, n: int = 1,
-             actor: str = None) -> dict:
-        """记一笔会话活动（事件计数 + 最后 (t, seq) 水位）。"""
-        d = self._load()
-        s = d["sessions"].setdefault(
-            session, {"events": 0, "first_t": None, "last_t": None})
-        s["events"] = int(s.get("events") or 0) + int(n)
-        if t is not None:
-            s["last_t"] = float(t)
-            if s.get("first_t") is None:
-                s["first_t"] = float(t)
-        if seq is not None:
-            s["last_seq"] = seq
-        if actor:
-            s["actor"] = actor
-        s["updated_at"] = time.time()
-        self._save(d)
-        return dict(s, session=session)
-
-# 生效条件：_load()["sessions"].get(session) 为假值（键缺失或值为空 dict）时返回 {"session": session, "resume": None, "events": 0}；否则返回 {"session": session, "events": s.get("events", 0), "resume": {"t": s.get("last_t"), "seq": s.get("last_seq")}, "last_t": s.get("last_t"), "actor": s.get("actor")}；
-    def resume_point(self, session: str) -> dict:
-        """重启续接点：(t, seq) 之后的事件才是新的。"""
-        s = self._load()["sessions"].get(session)
-        if not s:
-            return {"session": session, "resume": None, "events": 0}
-        return {"session": session, "events": s.get("events", 0),
-                "resume": {"t": s.get("last_t"), "seq": s.get("last_seq")},
-                "last_t": s.get("last_t"), "actor": s.get("actor")}
-
-# 生效条件：无参调用时返回 dict(self._load()["sessions"]) 的浅拷贝，账本缺失/损坏时 _load 回落默认值故此处为 {}；
-    def sessions(self) -> dict:
-        return dict(self._load()["sessions"])
-
-# 生效条件：取 d=_load()["sessions"] 后返回 {"sessions": len(d), "events": sum(int(v.get("events") or 0)), "latest": max(v.get("last_t") or 0) if d else None}，d 为空时 latest 为 None；
-    def summary(self) -> dict:
-        d = self._load()["sessions"]
-        return {"sessions": len(d),
-                "events": sum(int(v.get("events") or 0) for v in d.values()),
-                "latest": max((v.get("last_t") or 0) for v in d.values())
-                if d else None}
-
-
-# 生效条件：os.path.exists(os.path.join(cg.root, "_sources.json")) 为真且 json.load 成功时返回 dict((d or {}).get("sources") or {})（d 或 sources 为假值即回落 {}）；该路径不可读或 json.load 抛 ValueError/OSError 时返回 {}；
-def watermarks(cg) -> dict:
-    """源视角水位快照（读 sources.Ingestor 的 _sources.json）。"""
-    p = os.path.join(cg.root, "_sources.json")
-    if not os.path.exists(p):
-        return {}
-    try:
-        with open(p, encoding="utf-8") as f:
-            d = json.load(f)
-    except (ValueError, OSError):
-        return {}
-    return dict((d or {}).get("sources") or {})
-
-
-# --------------------------------------------------------------------------
-# 常驻循环
-# --------------------------------------------------------------------------
-
-# 生效条件：传入 cg 即构造实例并把 self.cg 指向它，name/beat_interval/heal_interval/auto_heal/scrub_interval/auto_scrub/evolve_interval/auto_evolve/tidy_interval/auto_tidy 用各默认值（DEFAULT_* 与 False/True）经 float()/bool() 落为 self 属性，ledger 为假值（默认 None）时回落 SessionLedger(cg.root)，d 经 net_dir(d) 赋值，其余运行态字段初始化为 False/None/空列表/空 Event/Lock
-class SustainLoop:
-    """常驻自维持循环：后台线程周期心跳 + 周期巡检 + 必要时自愈。
-
-    daemon 线程，进程退出即消失；`stop()` 会清掉自己的心跳戳，
-    让对端立刻看到「正常下线」而不是「失联」。
-    """
-
-# 生效条件：传入 cg 时按 name 与各 DEFAULT_* 默认值初始化——self.d=net_dir(d)（d 假值时回落 MDCG_SUSTAIN_DIR/~/ .mdcg/sustain）、self.ledger=ledger or SessionLedger(cg.root)（ledger 假值时新建），beat/heal/scrub/evolve/tidy 间隔 float() 化、auto_heal/auto_scrub/auto_evolve/auto_tidy bool() 化后存为实例属性；
-    def __init__(self, cg, name: str = "md_cg", *,
-                 beat_interval: float = DEFAULT_BEAT_INTERVAL,
-                 heal_interval: float = DEFAULT_HEAL_INTERVAL,
-                 auto_heal: bool = True, d: str = None,
-                 ledger: SessionLedger = None,
-                 scrub_interval: float = DEFAULT_SCRUB_INTERVAL,
-                 auto_scrub: bool = False,
-                 evolve_interval: float = DEFAULT_EVOLVE_INTERVAL,
-                 auto_evolve: bool = False,
-                 tidy_interval: float = DEFAULT_TIDY_INTERVAL,
-                 auto_tidy: bool = False):
-        self.cg = cg
-        self.name = name
-        self.beat_interval = float(beat_interval)
-        self.heal_interval = float(heal_interval)
-        self.auto_heal = bool(auto_heal)
-        self.d = net_dir(d)
-        self.ledger = ledger or SessionLedger(cg.root)
-        self.scrub_interval = float(scrub_interval)
-        self.auto_scrub = bool(auto_scrub)
-        self.evolve_interval = float(evolve_interval)
-        self.auto_evolve = bool(auto_evolve)
-        self.tidy_interval = float(tidy_interval)
-        self.auto_tidy = bool(auto_tidy)
-        self.task_running = False
-        self.beats = 0
-        self.last_beat = None
-        self.last_diagnose = None
-        self.heals = []
-        self.last_scrub = None
-        self.scrubs = []
-        self.last_evolve = None
-        self.evolves = []
-        self.last_tidy = None
-        self.tidys = []
-        # 数据健康不变量断言集结论（Pi⑤）：与 tidy 同节奏，只取结论不落盘
-        self.last_conformance = None
-        self._started_at = None
-        self._th = None
-        self._stop = threading.Event()
-        self._lock = threading.Lock()
-
-    # ---- 心跳 ----
-
-# 生效条件：task_running 非 None 时先置 self.task_running=bool(task_running)，再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0)，beats 自增并记 last_beat=rec["ts"]，返回该 rec；
-    def beat(self, task_running: bool = None) -> dict:
-        if task_running is not None:
-            self.task_running = bool(task_running)
-        rec = write_stamp(
-            self.name, self.d, task_running=self.task_running, root=self.cg.root,
-            uptime=round(time.time() - self._started_at, 3)
-            if self._started_at else 0.0)
-        self.beats += 1
-        self.last_beat = rec["ts"]
-        return rec
-
-    # ---- 生命周期 ----
-
-# 生效条件：不适用（无必需形参与模块级常量）
-    def start(self):
-        if self._th is not None and self._th.is_alive():
-            return self
-        self._started_at = time.time()
-        self._stop.clear()
-        self.beat()
-        self._th = threading.Thread(target=self._run, name="mdcg-sustain",
-                                    daemon=True)
-        self._th.start()
-        return self
-
-# 生效条件：调用时置 _stop 事件，self._th 非 None 时 join(timeout)（默认 3.0）后置为 None，随后 clear_stamp(self.name, self.d)，返回 self；
-    def stop(self, timeout: float = 3.0):
-        self._stop.set()
-        if self._th is not None:
-            self._th.join(timeout)
-            self._th = None
-        clear_stamp(self.name, self.d)
-        return self
-
-# 生效条件：self._stop 未置位期间轮询，按 beat_interval/heal_interval/scrub_interval/evolve_interval/tidy_interval 到期分别执行 beat 与 _tick_heal/_tick_scrub/_tick_evolve/_tick_tidy，各 tick 抛出的异常被吞掉不中断循环，末尾以 _stop.wait(_POLL) 休眠；
-    def _run(self):
-        next_beat = time.time() + self.beat_interval
-        next_heal = time.time() + self.heal_interval
-        next_scrub = time.time() + self.scrub_interval
-        next_evolve = time.time() + self.evolve_interval
-        next_tidy = time.time() + self.tidy_interval
-        while not self._stop.is_set():
-            now = time.time()
-            if now >= next_beat:
-                try:
-                    self.beat()
-                except Exception:
-                    pass                       # 心跳失败不中断常驻
-                next_beat = now + self.beat_interval
-            if now >= next_heal:
-                try:
-                    self._tick_heal()
-                except Exception:
-                    pass                       # 巡检失败不中断常驻
-                next_heal = now + self.heal_interval
-            if now >= next_scrub:
-                try:
-                    self._tick_scrub()
-                except Exception:
-                    pass                       # 自净失败不中断常驻
-                next_scrub = now + self.scrub_interval
-            if now >= next_evolve:
-                try:
-                    self._tick_evolve()
-                except Exception:
-                    pass                       # 演化巡检失败不中断常驻
-                next_evolve = now + self.evolve_interval
-            if now >= next_tidy:
-                try:
-                    self._tick_tidy()
-                except Exception:
-                    pass                       # 整理巡检失败不中断常驻
-                next_tidy = now + self.tidy_interval
-            self._stop.wait(_POLL)
-
-# 生效条件：以 apply=self.auto_tidy 调 writelimit.tidy_contextual(self.cg, actor="sustain_tidy")，把 t/scanned/groups/members/applied_count/auto_tidy 记入 self.last_tidy 与 tidys（仅保留最近 20 条），随后调 _tick_conformance()；auto_tidy=False（默认）时只盘点不落盘；
-    def _tick_tidy(self):
-        """整理巡检（contextual 流水治理·读侧）：同构组聚合 + 成员降权。
-
-        确定性动作、永不删节点；`auto_tidy=False`（默认）只盘点不落盘。
-        治理对象：单日批次流水（「批次247收官记忆」×163 那类同模板写入）
-        —— 写入侧限流（writelimit.check）拦增量，本巡检收敛存量。
-        """
-        from . import writelimit
-        r = writelimit.tidy_contextual(self.cg, apply=self.auto_tidy,
-                                       actor="sustain_tidy")
-        rec = {"t": r["t"], "scanned": r["scanned"], "groups": r["groups"],
-               "members": r["members"],
-               "applied_count": r.get("applied_count", 0),
-               "auto_tidy": self.auto_tidy}
-        self.last_tidy = rec
-        with self._lock:
-            self.tidys.append(rec)
-            self.tidys = self.tidys[-20:]
-        self._tick_conformance()
-
-# 生效条件：把 conformance.report_summary(self.cg) 的结论写入 self.last_conformance；该调用抛异常时写入 {"ok": False, "verdict": "BLINDSPOT", "error": "<类型名>: <消息>"}；
-    def _tick_conformance(self):
-        """数据健康不变量断言集（Pi⑤）——与 tidy 同节奏，**只取结论**。
-
-        复用 tidy 的 6h 节奏而不新开周期：两者都是「存量数据体检」，且都是
-        只读巡检。纪律：本断言集**只告警不改数据**，故 `auto_*` 在此无意义；
-        `check_paths=False` 跳过 1.1 万次 stat，`_audit.jsonl` 只读尾窗。
-        """
-        from . import conformance
-        try:
-            self.last_conformance = conformance.report_summary(self.cg)
-        except Exception as e:                              # noqa: BLE001
-            self.last_conformance = {"ok": False, "verdict": "BLINDSPOT",
-                                     "error": f"{type(e).__name__}: {e}"}
-
-# 生效条件：恒以 evolution_candidates(self.cg) 只读盘点并记入 last_evolve 与 evolves（保留最近 20 条）；仅当 self.auto_evolve 为真且 ev["importance_drift"]["n"] 为真时才额外执行 weights.recalc(self.cg, apply=True, actor="sustain_evolve")，其异常写入 rec["applied"]；
-    def _tick_evolve(self):
-        """演化巡检（G7）：盘点固化/重要性候选 —— 让「有能力」变成「有驱动」。
-
-        恒只读盘点并记账；`auto_evolve=True` 时才额外落盘**确定性**动作
-        （仅重要性重算，可 rollback）。固化依赖 LLM，巡检只报候补量、交人工。
-        """
-        ev = evolution_candidates(self.cg)
-        rec = {"t": ev["t"], "candidates": ev["candidates"],
-               "ccg_backlog": ev["ccg_backlog"]["n"],
-               "importance_drift": ev["importance_drift"]["n"],
-               "auto_evolve": self.auto_evolve, "applied": []}
-        if self.auto_evolve and ev["importance_drift"]["n"]:
-            from . import weights
-            try:
-                r = weights.recalc(self.cg, apply=True, actor="sustain_evolve")
-                rec["applied"].append({"fix": "importance",
-                                       "written": r["written"],
-                                       "batch": r["batch"]})
-            except Exception as e:                 # 演化失败不能拖垮常驻
-                rec["applied"].append({"fix": "importance",
-                                       "error": f"{type(e).__name__}: {e}"})
-        self.last_evolve = rec
-        with self._lock:
-            self.evolves.append(rec)
-            self.evolves = self.evolves[-20:]
-
-# 生效条件：以 dry_run=not self.auto_scrub 调 scrub.sweep(self.cg)，把 t/ok/n_issues/n_high_medium/applied/dry_run 记入 last_scrub 与 scrubs（保留最近 20 条）；auto_scrub=False（默认）时 dry_run=True 只读巡检；
-    def _tick_scrub(self):
-        """记忆自净：抽查 → 联想 → 去污染 → 校准偏差。
-
-        `auto_scrub=False`（默认）时只做只读巡检并记账，不动任何节点；
-        开启后才执行去污染（仍只做可逆动作、永不删节点）。
-        """
-        from . import scrub
-        rep = scrub.sweep(self.cg, dry_run=not self.auto_scrub)
-        rec = {"t": rep["t"], "ok": rep["ok"],
-               "n_issues": rep["audit"]["n_issues"],
-               "n_high_medium": rep["n_high_medium"],
-               "applied": rep["decontaminate"]["applied"],
-               "dry_run": rep["dry_run"]}
-        self.last_scrub = rec
-        with self._lock:
-            self.scrubs.append(rec)
-            self.scrubs = self.scrubs[-20:]
-
-# 生效条件：先 diagnose(self.cg, name=self.name) 并将 ok 与 issues code 记入 last_diagnose；仅当 self.auto_heal 为真且 rep["ok"] 为假时才调 heal(self.cg, name=self.name)，其 actions 非空时把各 action 的 code 记入 heals（保留最近 20 条）；
-    def _tick_heal(self):
-        rep = diagnose(self.cg, name=self.name)
-        self.last_diagnose = {"t": time.time(), "ok": rep["ok"],
-                              "issues": [i["code"] for i in rep["issues"]]}
-        if not (self.auto_heal and not rep["ok"]):
-            return
-        res = heal(self.cg, name=self.name)
-        if res["actions"]:
-            with self._lock:
-                self.heals.append({"t": res["t"],
-                                   "actions": [a["code"] for a in res["actions"]]})
-                self.heals = self.heals[-20:]
-
-    # ---- 状态 ----
-
-# 生效条件：以 read_stamp(self.name, self.d) 判定 state（有戳走 judge(age, interval=self.beat_interval, task_running=...)，无戳为 "stopped"），返回含 name/running/pid/uptime（无 _started_at 时为 0.0）/beats/last_beat/各 interval 与 auto_* 开关/heals[-5:]/evolves[-5:]/tidys[-5:]/peers(self.d)/ledger.summary() 的 dict；
-    def status(self) -> dict:
-        st = read_stamp(self.name, self.d)
-        state = (judge(st["age"], interval=self.beat_interval,
-                       task_running=bool(st.get("task_running")))
-                 if st else "stopped")
-        return {"name": self.name, "running": bool(self._th
-                                                   and self._th.is_alive()),
-                "pid": os.getpid(),
-                "uptime": round(time.time() - self._started_at, 3)
-                if self._started_at else 0.0,
-                "beats": self.beats, "last_beat": self.last_beat,
-                "beat_interval": self.beat_interval,
-                "heal_interval": self.heal_interval,
-                "auto_heal": self.auto_heal, "state": state,
-                "task_running": self.task_running,
-                "last_diagnose": self.last_diagnose,
-                "heals": self.heals[-5:],
-                "scrub_interval": self.scrub_interval,
-                "auto_scrub": self.auto_scrub,
-                "last_scrub": self.last_scrub,
-                "evolve_interval": self.evolve_interval,
-                "auto_evolve": self.auto_evolve,
-                "last_evolve": self.last_evolve,
-                "evolves": self.evolves[-5:],
-                "last_tidy": self.last_tidy,
-                "tidys": self.tidys[-5:],
-                "last_conformance": self.last_conformance,
-                "peers": peers(self.d),
-                "sessions": self.ledger.summary()}
-
-
-_LOOPS = {}
-_LOOPS_LOCK = threading.Lock()
-
-
-# 生效条件：cg 必填，以 (os.path.abspath(cg.root), name) 为键在模块级 _LOOPS 中复用已有实例或新建 SustainLoop 并返回该实例。
-def ensure_loop(cg, name: str = "md_cg", **kw) -> SustainLoop:
-    """按 (root, name) 复用同一个常驻循环（避免重复线程 / 重复戳）。"""
-    key = (os.path.abspath(cg.root), name)
-    with _LOOPS_LOCK:
-        lp = _LOOPS.get(key)
-        if lp is None:
-            lp = SustainLoop(cg, name=name, **kw)
-            _LOOPS[key] = lp
-        return lp
-
-
-# 生效条件：cg 必填，返回 _LOOPS[(os.path.abspath(cg.root), name)]，该键未登记时返回 None。
-def get_loop(cg, name: str = "md_cg"):
-    return _LOOPS.get((os.path.abspath(cg.root), name))
-
-
-# 生效条件：模块级 _LOOPS 非空时清空该表并对每个循环调用 stop()（异常被吞），无返回值。
-def stop_all():
-    """测试 / 进程退出用：停掉本进程创建的所有常驻循环。"""
-    with _LOOPS_LOCK:
-        loops = list(_LOOPS.values())
-        _LOOPS.clear()
-    for lp in loops:
-        try:
-            lp.stop()
-        except Exception:
-            pass
-
-
-# 生效条件：以 read_stamp(name) 有戳时返回 heartbeat={'age': round(st["age"],1), 'state': judge(...), 'pid', 'task_running'}、无戳时 {'state':'absent'}，loop 取 get_loop(cg, name) 有值时给 running/beats/state、无值时 {'running': False}，并附带 SessionLedger(cg.root).summary()、scrub_summary(cg)、evolve_summary(cg)、provenance_summary(cg)；
-def summary(cg, name: str = "md_cg") -> dict:
-    """并入 health_os 的轻量摘要（只读戳与计数，不做巡检）。"""
-    st = read_stamp(name)
-    lp = get_loop(cg, name)
-    return {
-        "heartbeat": ({"age": round(st["age"], 1),
-                       "state": judge(st["age"],
-                                      task_running=bool(st.get("task_running"))),
-                       "pid": st.get("pid"),
-                       "task_running": bool(st.get("task_running"))}
-                      if st else {"state": "absent"}),
-        "loop": ({"running": bool(lp._th and lp._th.is_alive()),
-                  "beats": lp.beats, "state": lp.status()["state"]}
-                 if lp else {"running": False}),
-        "sessions": SessionLedger(cg.root).summary(),
-        "scrub": scrub_summary(cg),
-        "evolve": evolve_summary(cg),
-        "provenance": provenance_summary(cg),
-    }
-
-
-# 生效条件：cg 必填，可导入 provenance 且其 summary(cg) 调用成功时返回该摘要，异常时返回 {}。
-def provenance_summary(cg) -> dict:
-    """派生溯源摘要（G8，只读；失败不抛，避免拖垮 health_os）。"""
-    try:
-        from . import provenance as _pv
-        return _pv.summary(cg)
-    except Exception:                     # noqa: BLE001
-        return {}
-
-
-# 生效条件：cg 必填，evolution_candidates(cg, top=3) 成功时返回 candidates/ccg_backlog/importance_drift 计数摘要，异常时返回 {}。
-def evolve_summary(cg) -> dict:
-    """演化巡检摘要（只读；失败不抛，避免拖垮 health_os）。"""
-    try:
-        ev = evolution_candidates(cg, top=3)
-        return {"candidates": ev["candidates"],
-                "ccg_backlog": ev["ccg_backlog"]["n"],
-                "importance_drift": ev["importance_drift"]["n"],
-                "proxy": True}
-    except Exception:                     # noqa: BLE001
-        return {}
-
-
-# 生效条件：cg 必填，可导入 scrub 且其 summary(cg) 调用成功时返回该摘要，异常时返回 {}。
-def scrub_summary(cg) -> dict:
-    """记忆自净摘要（惰性导入，避免模块加载顺序耦合）。"""
-    try:
-        from . import scrub
-        return scrub.summary(cg)
-    except Exception:                     # noqa: BLE001
+# -*- coding: utf-8 -*-
+"""md_cg · 持续性自维持（记忆 OS #4）：常驻 / 心跳 / 自愈 / 会话续接
+
+路线图「常驻服务：会话 / 心跳 / 自愈」的落地。回答三个问题：
+
+① 别人怎么知道我还活着？—— **心跳戳**
+   `<net_dir>/heartbeat.<name>.stamp`（原子写，含 ts / pid / uptime / task_running）。
+   分级判定对齐 Mutual Sustain Loop v1.1：正常 / 警告 / 失联，阈值按心跳间隔的
+   2.5× / 3.5×；**任务执行中阈值放宽**（working factor），避免长任务被误判死亡。
+   戳写在仓库外（默认 ~/.mdcg/sustain），不污染知识库，也不随仓库泄露。
+
+② 进程被杀会不会留下坏状态？—— **自愈（diagnose → heal）**
+   诊断只读、不改动；修复动作幂等且逐条留审计：
+     · 索引漂移 / 孤儿索引 → 重建索引（索引是派生物，可安全重建）
+     · 索引增量分片积压 → 合并进快照
+     · 陈旧临时文件     → 清理（被杀死的写者留下的唯一命名 tmp）
+     · 日志半截行       → 补换行（否则下一条记录会粘在断行上）
+     · 私有节点不可解   → **只报告不修**（缺密钥是权限事实，不是故障）
+   原则：修复只碰派生物（索引 / 临时文件 / 日志边界），**永不删节点**。
+
+③ 重启后从哪继续？—— **会话水位（SessionLedger）**
+   `<root>/_sessions.json` 记录每个会话的 (last_t, last_seq, events)，
+   与 `sources.Ingestor` 的 `_sources.json`（源视角水位）互补；重启后
+   `resume_point(session)` 直接给出续接点，不重复摄取、不丢事件。
+
+④ 能力不会被饿死？—— **演化巡检（evolve）**
+   自我演化的三类动作（固化 `consolidate` / 重算重要性 `weights` / 去污染 `scrub`）
+   早已具备，缺的是**驱动源**：没人周期性问「现在有多少该固化 / 该重算的候选」。
+   `evolution_candidates()` 以**索引快照**为口径做只读盘点（零读节点文件、零写盘、
+   确定性），并挂到常驻循环的 `_tick_evolve()` 上。纪律与 self-heal 一致且更严：
+     · 巡检恒只读，`auto_evolve=False`（默认）时**只记账不动库**；
+     · 自愈只放行**确定性且可回滚**的动作（重要性重算，有 rollback）；
+     · 依赖 LLM 的固化**永不自动跑**——巡检报出候选数，交人工另批。
+
+⑤ 演进血缘有没有断？—— **派生溯源巡检（G8）**
+   新增节点在建链时把 `derived_from` 写进 frontmatter 并追加到 `<root>/_link.jsonl`。
+   可台账会丢、节点会被删，于是血缘会出现**悬空边**（子/父节点已不在库里）。
+   `diagnose()` 每次都做只读盘点（零读节点文件：索引已带 `derived_from`），把悬空边
+   报为 `provenance_dangling`（severity=info、**无自动修复**）——关系事实的去留由人
+   处置，不给「自动删边」这种会篡改历史的动作。
+
+⑥ 对端挂了谁来救？—— **互维闭环（P-T-110 最小投影 · #30）**
+   两个灵枢互为维生系统：`mutual_watch` 读对端心跳 → 失联则**幂等拉起**
+   （pid 探活防误判 + 冷却防风暴）→ **验戳新鲜闭合**：拉起后必须轮询到
+   对端戳变新才算救活，否则如实报 `mutual_peer_unresponsive`——这正是
+   mutual-sustain-loop v1.1 §7 的 W4 部署教训（「拉起后应验证对端戳新鲜度，
+   当时缺该校验」）的机制化：不假装成功。`mutual_status` 做双亡检测：
+   自己也失联时互维本身不可信 → 显式上报外部告警语义，绝不静默。
+
+零第三方依赖。
+"""
+from __future__ import annotations
+
+import json
+import os
+import threading
+import time
+
+from . import crypto
+from .fsutil import append_jsonl, atomic_write, ends_mid_line
+from .mdcg import LAYERS
+
+STAMP_VERSION = 1
+SUSTAIN_LOG = "_sustain.jsonl"
+LEDGER_FILE = "_sessions.json"
+
+DEFAULT_BEAT_INTERVAL = 600.0     # 心跳间隔 10min（对齐 mutual-sustain-loop）
+DEFAULT_HEAL_INTERVAL = 300.0     # 自愈巡检 5min
+DEFAULT_SCRUB_INTERVAL = 3600.0   # 记忆自净（抽查/去污染/校准）1h
+DEFAULT_EVOLVE_INTERVAL = 7200.0  # 演化巡检（固化/重要性候选盘点）2h；只读
+DEFAULT_TIDY_INTERVAL = 21600.0   # 整理巡检（contextual 同构组聚合）6h
+DEFAULT_WARN_FACTOR = 2.5         # 2.5× 心跳间隔 → 警告
+DEFAULT_DEAD_FACTOR = 3.5         # 3.5× → 失联
+DEFAULT_WORKING_FACTOR = 2.0      # 任务执行中阈值 ×2
+STALE_TEMP_AGE = 3600.0           # 临时文件超过 1h 视为陈旧
+_POLL = 0.2                       # 循环轮询步长（常驻进程 CPU 可忽略）
+
+
+# --------------------------------------------------------------------------
+# 心跳
+# --------------------------------------------------------------------------
+
+# 生效条件：d 为真值时返回 d，d 为 None/空串时回落 MDCG_SUSTAIN_DIR，该环境变量也未设或为空串时返回 os.path.join(os.path.expanduser("~"), ".mdcg", "sustain")；
+def net_dir(d: str = None) -> str:
+    """心跳戳目录：显式 → MDCG_SUSTAIN_DIR → ~/.mdcg/sustain（仓库外）。"""
+    return (d or os.environ.get("MDCG_SUSTAIN_DIR")
+            or os.path.join(os.path.expanduser("~"), ".mdcg", "sustain"))
+
+
+# 生效条件：给定必填 name，返回 net_dir(d) 下 heartbeat.<name>.stamp 的拼接路径。
+def stamp_path(name: str, d: str = None) -> str:
+    return os.path.join(net_dir(d), f"heartbeat.{name}.stamp")
+
+
+# 生效条件：name 必填，组装含模块常量 STAMP_VERSION 与 task_running 的戳记录、原子写入 stamp_path(name,d) 后返回该 rec。
+def write_stamp(name: str, d: str = None, **extra) -> dict:
+    """写一次心跳（原子替换）。extra 会并入戳内容（None 值丢弃）。"""
+    rec = {"v": STAMP_VERSION, "name": name, "ts": time.time(),
+           "pid": os.getpid(),
+           "iso": time.strftime("%Y-%m-%dT%H:%M:%S"),
+           "task_running": bool(extra.pop("task_running", False))}
+    for k, v in extra.items():
+        if v is not None:
+            rec[k] = v
+    atomic_write(stamp_path(name, d),
+                 json.dumps(rec, ensure_ascii=False, indent=1))
+    return rec
+
+
+# 生效条件：stamp_path(name, d) 所得路径上 os.path.exists 为真且 json.load 结果为 dict 时，返回该 rec 并附加 age=max(0.0, time.time() - float(rec.get("ts") or 0))；该路径不可读、json.load 抛 ValueError/OSError 或 rec 非 dict 时返回 None；
+def read_stamp(name: str, d: str = None):
+    """读心跳戳并附 age（秒）；不存在 / 损坏 → None。"""
+    p = stamp_path(name, d)
+    if not os.path.exists(p):
+        return None
+    try:
+        with open(p, encoding="utf-8") as f:
+            rec = json.load(f)
+    except (ValueError, OSError):
+        return None
+    if not isinstance(rec, dict):
+        return None
+    rec["age"] = max(0.0, time.time() - float(rec.get("ts") or 0))
+    return rec
+
+
+# 生效条件：对 stamp_path(name,d) 执行 os.remove，OSError 被静默忽略，无返回值。
+def clear_stamp(name: str, d: str = None):
+    try:
+        os.remove(stamp_path(name, d))
+    except OSError:
+        pass
+
+
+# 生效条件：age 为 None 返回 'absent'；否则以 factor=working if task_running else 1.0 比较 age 与 interval*warn*factor、interval*dead*factor，分别返回 'ok'/'warning'/'dead'。
+def judge(age, *, interval: float = DEFAULT_BEAT_INTERVAL,
+          task_running: bool = False, warn: float = DEFAULT_WARN_FACTOR,
+          dead: float = DEFAULT_DEAD_FACTOR,
+          working: float = DEFAULT_WORKING_FACTOR) -> str:
+    """按心跳年龄分级：ok / warning / dead / absent。
+
+    task_running=True 时阈值整体放宽 working 倍——长任务期间不写心跳是正常的，
+    若不放宽会把「正在干活」误判成「已死」。
+    """
+    if age is None:
+        return "absent"
+    factor = working if task_running else 1.0
+    if age <= interval * warn * factor:
+        return "ok"
+    if age <= interval * dead * factor:
+        return "warning"
+    return "dead"
+
+
+# 生效条件：net_dir(d) 可列为目录时遍历 heartbeat.*.stamp 并返回含 age 与 state 的记录列表，否则返回 []。
+def peers(d: str = None):
+    """列出本机所有心跳戳（含状态）。"""
+    base = net_dir(d)
+    if not os.path.isdir(base):
+        return []
+    out = []
+    for fn in sorted(os.listdir(base)):
+        if not (fn.startswith("heartbeat.") and fn.endswith(".stamp")):
+            continue
+        rec = read_stamp(fn[len("heartbeat."):-len(".stamp")], base)
+        if rec:
+            rec["state"] = judge(rec["age"],
+                                 task_running=bool(rec.get("task_running")))
+            out.append(rec)
+    return out
+
+
+# --------------------------------------------------------------------------
+# 互维闭环（P-T-110 最小投影 · #30）
+# --------------------------------------------------------------------------
+
+DEFAULT_RESTART_COOLDOWN = 300.0   # 同一对端两次拉起的最小间隔（防风暴）
+DEFAULT_FRESH_TIMEOUT = 60.0       # 拉起后等待对端戳变新鲜的窗口
+
+
+# 生效条件：pid 可转 int 且 >0 时按探活（os.name=='nt' 用 OpenProcess+WaitForSingleObject，否则 os.kill(pid,0)）返回 True，转 int 失败或 pid<=0 或探活失败返回 False。
+def pid_alive(pid) -> bool:
+    """进程探活（零第三方依赖）：Windows=OpenProcess+WaitForSingleObject；
+    posix=os.kill(pid,0)。pid 无效 / 已退出 / 权限外 → False（诚实）。"""
+    try:
+        pid = int(pid)
+    except (TypeError, ValueError):
+        return False
+    if pid <= 0:
+        return False
+    if os.name == "nt":
+        import ctypes
+        SYNCHRONIZE = 0x00100000
+        WAIT_TIMEOUT = 0x00000102
+        k32 = ctypes.windll.kernel32
+        h = k32.OpenProcess(SYNCHRONIZE, False, pid)
+        if not h:
+            return False
+        try:
+            return k32.WaitForSingleObject(h, 0) == WAIT_TIMEOUT
+        finally:
+            k32.CloseHandle(h)
+    try:
+        os.kill(pid, 0)
+        return True
+    except OSError:
+        return False
+
+
+# 生效条件：cmd 为 argv 列表时以 stdout/stderr=DEVNULL、不经 shell 的 subprocess.Popen 拉起（nt 附加 DETACHED|NEW_GROUP creationflags），返回该 Popen 对象。
+def _default_spawner(cmd):
+    """分离式拉起：argv 列表、不经 shell、输出弃置（Windows 完全脱离父控制台）。"""
+    import subprocess
+    kw = {}
+    if os.name == "nt":
+        kw["creationflags"] = (0x00000008 | 0x00000200)  # DETACHED|NEW_GROUP
+    return subprocess.Popen(cmd, stdout=subprocess.DEVNULL,
+                            stderr=subprocess.DEVNULL, **kw)
+
+
+# 生效条件：root 与 peer 必填，扫描 root/SUSTAIN_LOG（模块常量）返回 op='mutual'、action='restart' 且 detail 以 peer 开头的记录中最大 t，无匹配返回 0.0。
+def _last_mutual_restart(root: str, peer: str) -> float:
+    """_sustain.jsonl 里该对端最近一次互维拉起时间（无 → 0.0，审计即状态）。"""
+    last = 0.0
+    try:
+        with open(os.path.join(root, SUSTAIN_LOG), encoding="utf-8") as f:
+            for line in f:
+                try:
+                    r = json.loads(line)
+                except ValueError:
+                    continue
+                if (r.get("op") == "mutual" and r.get("action") == "restart"
+                        and str(r.get("detail") or "").startswith(str(peer))):
+                    last = max(last, float(r.get("t") or 0.0))
+    except OSError:
+        pass
+    return last
+
+
+# 生效条件：cg 与 peer 必填，读对端戳判状态：ok/warning 直接返回 action='none'；dead/absent 时依次按 pid_alive、restart_cooldown、restart_cmd 有无走 alive_but_stale/restart_cooldown/dead_unhandled/拉起并验戳，返回 out。
+def mutual_watch(cg, peer: str, *, restart_cmd=None, d: str = None,
+                 interval: float = DEFAULT_BEAT_INTERVAL,
+                 restart_cooldown: float = DEFAULT_RESTART_COOLDOWN,
+                 fresh_timeout: float = DEFAULT_FRESH_TIMEOUT, poll: float = 0.5,
+                 spawner=None) -> dict:
+    """互维守护（单侧一次检查）：读对端心跳 → 失联则幂等拉起 → 验戳闭合。
+
+    判定序（P-T-110 语义，全链路审计进 _sustain.jsonl）：
+      ok/warning        → 不动作；
+      dead/absent：
+        ① 误判防护：戳里 pid 仍存活 → `alive_but_stale`（长任务未标
+           task_running？）——**不拉起**，不杀活进程；
+        ② 冷却：距上次拉起 < restart_cooldown → `restart_cooldown`；
+        ③ 无 restart_cmd → `dead_unhandled`（ok=False，诚实上报没手段，
+           不假装能救）；
+        ④ 拉起（spawner 或分离式 Popen）→ **验戳新鲜闭合**（W4 补丁）：
+           轮询对端戳 ts 超过拉起前值才算 `recovered=True`；超时 →
+           `recovered=False` + `mutual_peer_unresponsive`——对端拉起后
+           互维未激活（v1.1 §7 的 W4 场景）会被显式暴露，不假装成功。
+    """
+    rec = read_stamp(peer, d)
+    state = (judge(rec["age"], interval=interval,
+                   task_running=bool(rec.get("task_running")))
+             if rec else "absent")
+    out = {"ok": True, "peer": peer, "state": state, "t": time.time(),
+           "action": "none", "recovered": None}
+    if state in ("ok", "warning"):
+        return out
+    if rec and pid_alive(rec.get("pid")):
+        out.update(action="alive_but_stale",
+                   note="对端进程存活但戳陈旧（长任务未标 task_running？）——不拉起")
+        _audit(cg.root, "mutual", "alive_but_stale", peer)
+        return out
+    last = _last_mutual_restart(cg.root, peer)
+    if last and (time.time() - last) < restart_cooldown:
+        out.update(action="restart_cooldown",
+                   note="距上次拉起 %.1fs，冷却中" % (time.time() - last))
+        return out
+    if not restart_cmd:
+        out.update(ok=False, action="dead_unhandled",
+                   note="对端失联且未提供 restart_cmd——诚实上报，不假装能救")
+        _audit(cg.root, "mutual", "dead_unhandled", peer)
+        return out
+    before_ts = float((rec or {}).get("ts") or 0.0)
+    spawn = spawner or _default_spawner
+    try:
+        spawn(restart_cmd)
+    except Exception as e:                                 # noqa: BLE001
+        out.update(ok=False, action="restart_error",
+                   error="%s: %s" % (type(e).__name__, e))
+        _audit(cg.root, "mutual", "restart_error", peer)
+        return out
+    deadline = time.time() + fresh_timeout
+    while time.time() < deadline:
+        r2 = read_stamp(peer, d)
+        if r2 and float(r2.get("ts") or 0.0) > before_ts:
+            out.update(action="restarted", recovered=True, fresh_ts=r2.get("ts"))
+            _audit(cg.root, "mutual", "restart", peer)
+            return out
+        time.sleep(poll)
+    out.update(ok=False, action="restarted", recovered=False,
+               note=("拉起命令已执行但对端戳未更新（互维未激活？）——"
+                     "mutual_peer_unresponsive，不假装成功"))
+    _audit(cg.root, "mutual", "restart_unverified", peer)
+    return out
+
+
+# 生效条件：cg 与 peer 必填，分别按 name 与 peer 读戳判状态，仅当自身与对端状态均属 ('dead','absent') 时返回 ok=False、both_dead=True。
+def mutual_status(cg, peer: str, *, d: str = None, name: str = "md_cg",
+                  interval: float = DEFAULT_BEAT_INTERVAL) -> dict:
+    """互维状态 + 双亡检测：自己也失联时互维不可信 → 显式外部告警语义。"""
+    mine, theirs = read_stamp(name, d), read_stamp(peer, d)
+    my_state = (judge(mine["age"], interval=interval,
+                      task_running=bool(mine.get("task_running")))
+                if mine else "absent")
+    peer_state = (judge(theirs["age"], interval=interval,
+                        task_running=bool(theirs.get("task_running")))
+                  if theirs else "absent")
+    dead = ("dead", "absent")
+    both_dead = my_state in dead and peer_state in dead
+    return {"ok": not both_dead, "self": my_state, "peer": peer_state,
+            "both_dead": both_dead,
+            "note": ("双向同时失联：互维本身已不可信，须外部告警（P-T-110 风险表）"
+                     if both_dead else "互维链路可用")}
+
+
+# --------------------------------------------------------------------------
+# 诊断（只读）
+# --------------------------------------------------------------------------
+
+# 生效条件：root 必填，对模块常量 LAYERS 各层 os.walk 统计以 .md 结尾的文件名个数并返回 n（不解析正文）。
+def _count_node_files(root: str) -> int:
+    """轻量统计磁盘节点数（只数文件名，不解析正文）。"""
+    n = 0
+    for layer in LAYERS:
+        for _dp, _dirs, files in os.walk(os.path.join(root, layer)):
+            n += sum(1 for f in files if f.endswith(".md"))
+    return n
+
+
+# 生效条件：root 与 older_than 必填，返回 root 及其 LAYERS 各层下以 '.' 开头、名含 '.tmp-' 且 mtime 早于 now-older_than 的路径列表。
+def _list_stale_temps(root: str, older_than: float):
+    now, out = time.time(), []
+    bases = [root] + [os.path.join(root, l) for l in LAYERS]
+    for base in bases:
+        if not os.path.isdir(base):
+            continue
+        for name in os.listdir(base):
+            if ".tmp-" not in name or not name.startswith("."):
+                continue
+            p = os.path.join(base, name)
+            try:
+                if now - os.path.getmtime(p) > older_than:
+                    out.append(p)
+            except OSError:
+                pass
+    return out
+
+
+# 生效条件：root 必填，返回 root 顶层以 .jsonl/.log 结尾且 ends_mid_line 为真的路径列表；root 非目录返回 []。
+def _half_line_logs(root: str):
+    """顶层行式日志里末尾不是换行的（写者被杀留下的半截记录）。"""
+    out = []
+    if not os.path.isdir(root):
+        return out
+    for name in sorted(os.listdir(root)):
+        if not (name.endswith(".jsonl") or name.endswith(".log")):
+            continue
+        p = os.path.join(root, name)
+        if os.path.isfile(p) and ends_mid_line(p):
+            out.append(p)
+    return out
+
+
+# 生效条件：root/_index_log 可列为目录时返回其中 .log 结尾的文件名列表，否则返回 []。
+def _index_log_shards(root: str):
+    d = os.path.join(root, "_index_log")
+    if not os.path.isdir(d):
+        return []
+    return [f for f in os.listdir(d) if f.endswith(".log")]
+
+
+# 生效条件：cg 具备 crypto_status 且其返回 unlocked 为假时，返回 cg.index['nodes'] 中 sensitivity 属 crypto.ENCRYPTED_LEVELS 的条目数；属性缺失、调用异常或已解锁时返回 0。
+def _locked_nodes(cg) -> int:
+    """加密引擎在「未解锁」状态下被隔离的私有节点数（缺密钥 = 权限事实）。"""
+    if not hasattr(cg, "crypto_status"):
+        return 0
+    try:
+        st = cg.crypto_status() or {}
+    except Exception:
+        return 0
+    if st.get("unlocked"):
+        return 0
+    nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
+    return sum(1 for e in nodes.values()
+               if (e.get("sensitivity") or "") in crypto.ENCRYPTED_LEVELS)
+
+
+# --------------------------------------------------------------------------
+# 演化巡检（G7：给「固化 / 重要性」能力装上驱动源）
+# --------------------------------------------------------------------------
+
+#: 演化巡检项 → 对应的写入动作（`scrub` 已有独立 tick，不并入此项）
+EVOLVE_FIXES = {"ccg_backlog": "consolidate_run",
+                "importance_drift": "importance"}
+
+
+# 生效条件：nodes 与 top 必填，遍历索引条目统计缺 verification_basis 或 has_neg_conditions 的候补数 n、no_basis、no_neg 并取最多 top 个 sample，返回含 proxy=True 与 EVOLVE_FIXES['ccg_backlog'] 的字典。
+def _ccg_backlog(nodes: dict, top: int) -> dict:
+    """固化候补量（**索引代理指标**：零读节点文件、确定性、O(N)）。
+
+    真正的固化闸门在 `consolidate`（四要素 + 验证基底 + 白箱 replay，需读正文与 LLM）。
+    巡检只要**驱动信号**：索引里的 `verification_basis` / `has_neg_conditions` 已能
+    区分「有/无验证基底」「有/无负条件」，足够回答「有没有货等着固化」。
+
+    代理指标 ≠ 判定结论：报出的是**候补量**，不是「这些节点确实该固化」。
+    """
+    n = no_basis = no_neg = 0
+    sample = []
+    for nid, e in nodes.items():
+        mb = not e.get("verification_basis")
+        mn = not e.get("has_neg_conditions")
+        no_basis += 1 if mb else 0
+        no_neg += 1 if mn else 0
+        if mb or mn:
+            n += 1
+            if len(sample) < top:
+                sample.append(nid)
+    return {"n": n, "no_basis": no_basis, "no_neg": no_neg, "sample": sample,
+            "proxy": True, "fix": EVOLVE_FIXES["ccg_backlog"]}
+
+
+# 生效条件：cg 必填，取 cg.index['nodes']（layer 非空时按 layer 过滤），经 weights.recalc(apply=False) 与 _ccg_backlog 汇总，返回 ok=True、readonly=True、dry_run=True 的候选盘点字典。
+def evolution_candidates(cg, *, layer: str = None, top: int = 8,
+                         min_delta: float = None) -> dict:
+    """演化候选盘点（G7）：**只读、零读节点文件、确定性、不写盘**。
+
+    回答「现在有多少该固化 / 该重算重要性的候选」，供常驻巡检与人工决策。
+    与 `diagnose()`（故障体检）刻意分开：这里盘的是**演化工作量**，不是故障——
+    候补多不代表库有毛病，故 `ok` 恒 True、severity 恒 info。
+
+    `importance_drift` 复用 `weights.recalc(apply=False)`（纯数学，不读文件）；
+    `ccg_backlog` 用索引代理指标。二者都不碰节点内容。
+    """
+    nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
+    if layer:
+        nodes = {k: v for k, v in nodes.items() if v.get("layer") == layer}
+    from . import weights
+    md = weights.APPLY_DELTA if min_delta is None else float(min_delta)
+    imp = weights.recalc(cg, layer=layer, apply=False, min_delta=md,
+                         dry_run_samples=top)
+    cb = _ccg_backlog(nodes, top)
+    idr = {"n": imp["changed"], "scanned": imp["nodes_scanned"],
+           "min_delta": imp["min_delta"],
+           "sample": [s["node_id"] for s in imp["samples"]],
+           "fix": EVOLVE_FIXES["importance_drift"]}
+    return {"ok": True, "action": "evolve_check", "op": "sustain",
+            "root": cg.root, "t": time.time(), "readonly": True, "dry_run": True,
+            "nodes": len(nodes), "top": top, "layer": layer,
+            "ccg_backlog": cb, "importance_drift": idr,
+            "candidates": cb["n"] + idr["n"],
+            "by_fix": {EVOLVE_FIXES["ccg_backlog"]: cb["n"],
+                       EVOLVE_FIXES["importance_drift"]: idr["n"]},
+            "note": ("只读盘点：未写盘、未改任何节点；固化需 LLM（交人工/另批），"
+                     "重要性重算为确定性动作（有 rollback）")}
+
+
+# 生效条件：给定 cg 后只读汇总（nodes 取自 cg.index、disk 计数、refindex.check_refs），stale_temp_age 传入 _list_stale_temps；check_heartbeat / check_evolution(evolve_top) / check_provenance(provenance_top) 为真时分别追加对应 issue，返回 ok = 无 severity=="warning" 的 issue 连同 stats。
+def diagnose(cg, *, name: str = "md_cg", stale_temp_age: float = STALE_TEMP_AGE,
+             check_heartbeat: bool = True, check_evolution: bool = True,
+             evolve_top: int = 5, check_provenance: bool = True,
+             provenance_top: int = 5) -> dict:
+    """只读体检：返回 issues（带 fix 名）与 stats，不改动任何文件。"""
+    root = cg.root
+    issues = []
+    nodes = (getattr(cg, "index", {}) or {}).get("nodes") or {}
+    disk = _count_node_files(root)
+
+    if len(nodes) != disk:
+        issues.append({"code": "index_drift", "severity": "warning",
+                       "detail": f"索引 {len(nodes)} ≠ 磁盘 {disk}",
+                       "fix": "rebuild_index"})
+    orphans = [nid for nid, e in nodes.items()
+               if e.get("path")
+               and not os.path.exists(os.path.join(root, e["path"]))]
+    if orphans:
+        issues.append({"code": "index_orphan", "severity": "warning",
+                       "detail": f"{len(orphans)} 条索引指向不存在的文件",
+                       "sample": orphans[:5], "fix": "rebuild_index"})
+
+    shards = _index_log_shards(root)
+    if shards:
+        issues.append({"code": "index_log_backlog", "severity": "info",
+                       "detail": f"{len(shards)} 个索引增量分片未合并",
+                       "fix": "flush_index"})
+
+    temps = _list_stale_temps(root, stale_temp_age)
+    if temps:
+        issues.append({"code": "stale_temps", "severity": "info",
+                       "detail": f"{len(temps)} 个陈旧临时文件",
+                       "sample": [os.path.basename(p) for p in temps[:5]],
+                       "fix": "sweep_temps"})
+
+    half = _half_line_logs(root)
+    if half:
+        issues.append({"code": "half_line_logs", "severity": "warning",
+                       "detail": f"{len(half)} 个日志末尾半截行",
+                       "sample": [os.path.basename(p) for p in half[:5]],
+                       "fix": "seal_half_lines"})
+
+    locked = _locked_nodes(cg)
+    if locked:
+        issues.append({"code": "locked_nodes", "severity": "info",
+                       "detail": f"{locked} 个私有节点密文不可解（缺密钥）",
+                       "fix": None})   # 权限事实，不自愈
+
+    # ref 漂移 / 悬空（R3）：索引是派生物，源变了就报 stale，源没了就报 dangling。
+    # 只读、不抛；修复动作是重跑 index_code / index_doc（rebuild_refs）。
+    from . import refindex
+    refs = refindex.check_refs(cg, ledger=refindex.Ledger(root))
+    if refs["stale"]:
+        issues.append({"code": "ref_stale", "severity": "warning",
+                       "detail": f"{len(refs['stale'])} 个 ref 漂移（源文件已改动）",
+                       "sample": [r.get("path") for r in refs["stale"][:5]],
+                       "fix": "rebuild_refs"})
+    if refs["dangling"]:
+        issues.append({"code": "ref_dangling", "severity": "warning",
+                       "detail": f"{len(refs['dangling'])} 个 ref 悬空（源文件已删除）",
+                       "sample": [r.get("path") for r in refs["dangling"][:5]],
+                       "fix": "rebuild_refs"})
+    if refs.get("truncated"):
+        issues.append({"code": "ref_check_truncated", "severity": "info",
+                       "detail": f"ref 巡检只覆盖前 {refs['max_nodes']} 个节点，结果不完整",
+                       "fix": None})   # 覆盖缺口，显式说出来而非静默
+
+    if check_heartbeat:
+        st = read_stamp(name)
+        state = (judge(st["age"], task_running=bool(st.get("task_running")))
+                 if st else "absent")
+        if state != "ok":
+            issues.append({"code": "heartbeat_" + state, "severity": "info",
+                           "detail": f"本机心跳状态：{state}", "fix": "beat"})
+
+    # ---- 演化巡检（G7）：盘的是「该做多少事」，不是「库有毛病」，
+    #      故 severity 恒 info（不影响 ok），且全程只读、零读节点文件。
+    evolve = None
+    if check_evolution:
+        evolve = evolution_candidates(cg, top=evolve_top)
+        cb, idr = evolve["ccg_backlog"], evolve["importance_drift"]
+        if cb["n"]:
+            issues.append({"code": "ccg_backlog", "severity": "info",
+                           "detail": (f"{cb['n']} 个固化候补"
+                                      f"（索引代理：无验证基底 {cb['no_basis']}"
+                                      f" / 无负条件 {cb['no_neg']}）"),
+                           "sample": cb["sample"], "fix": cb["fix"],
+                           "proxy": True})
+        if idr["n"]:
+            issues.append({"code": "importance_drift", "severity": "info",
+                           "detail": (f"{idr['n']} 个节点结构重要性偏离 "
+                                      f"≥{idr['min_delta']}（可重算）"),
+                           "sample": idr["sample"], "fix": idr["fix"]})
+
+    # ---- 派生溯源巡检（G8）：只读检出悬空派生边（端点已不在索引内）。
+    #      **无自动修复**：删边等于篡改演进血缘，只报告、由人处置；
+    #      故 severity 恒 info（不影响 ok、不触发自愈），零读节点文件。
+    prov = None
+    if check_provenance:
+        from . import provenance as _pv
+        prov = _pv.check(cg, limit=provenance_top)
+        if prov["dangling_count"]:
+            issues.append({"code": "provenance_dangling", "severity": "info",
+                           "detail": (f"{prov['dangling_count']} 条派生边悬空"
+                                      f"（{prov['edges']} 条边中，端点不在索引内）"),
+                           "sample": [f"{r['child']}->{r['parent']}"
+                                      for r in prov["dangling"]],
+                           "fix": None})   # 关系事实：只检出，不自动删边
+
+    return {"ok": not any(i["severity"] == "warning" for i in issues),
+            "root": root, "issues": issues, "t": time.time(),
+            "evolve": evolve, "provenance": prov,
+            "stats": {"nodes_indexed": len(nodes), "nodes_on_disk": disk,
+                      "index_log_shards": len(shards), "stale_temps": len(temps),
+                      "half_line_logs": len(half), "locked_nodes": locked,
+                      "ref_checked": refs["checked"],
+                      "ref_stale": len(refs["stale"]),
+                      "ref_dangling": len(refs["dangling"]),
+                      "provenance_edges": (prov["edges"] if prov else 0),
+                      "provenance_dangling":
+                          (prov["dangling_count"] if prov else 0),
+                      "evolve_candidates":
+                          (evolve["candidates"] if evolve else 0)}}
+
+
+# --------------------------------------------------------------------------
+# 自愈
+# --------------------------------------------------------------------------
+
+# 生效条件：path 必填，以 'ab' 模式向该路径追加写入单个换行 b'\n'，无返回值。
+def _seal_half_line(path: str):
+    with open(path, "ab") as f:
+        f.write(b"\n")
+
+
+# 生效条件：root/op/action 必填，向 root/SUSTAIN_LOG（模块常量）追加一行含 t/op/action/detail(截断 200)/pid 的 JSONL，无返回值。
+def _audit(root: str, op: str, action: str, detail: str = ""):
+    append_jsonl(os.path.join(root, SUSTAIN_LOG),
+                 {"t": time.time(), "op": op, "action": action,
+                  "detail": str(detail)[:200], "pid": os.getpid()})
+
+
+# 生效条件：按 diagnose(cg, name=name, stale_temp_age=stale_temp_age) 的 issues code 集合分派——命中 index_drift/index_orphan 重建索引、ref_stale/ref_dangling 按 ref 重建源索引、index_log_backlog 合并索引分片、stale_temps 清理陈旧临时文件、half_line_logs 修补半截日志；ccg_backlog 仅 allow_evolve=True 且 reflect_fn 非 None 时才 consolidate（否则记 needs_llm），importance_drift 仅 allow_evolve=True 时才重算重要性（否则记 evolve_disabled）；dry_run=True 时各动作只记入 actions 不落盘，返回含 after["ok"]、dry_run、actions、before/after 的 stats 与 t 的 dict；
+def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
+         stale_temp_age: float = STALE_TEMP_AGE,
+         allow_evolve: bool = False, reflect_fn=None, verify_fn=None) -> dict:
+    """按诊断结果修复派生物。dry_run=True 时只列动作、不落盘。
+
+    演化类动作（G7）默认**不动**，须显式 `allow_evolve=True` 才放行，且只放行
+    **确定性**动作（重要性重算，有 rollback）；依赖 LLM 的固化永不自动跑。
+    """
+    before = diagnose(cg, name=name, stale_temp_age=stale_temp_age)
+    codes = {i["code"] for i in before["issues"]}
+    root = cg.root
+    actions = []
+
+# 生效条件：闭包 dry_run 为真时向 actions 追加 {"code": code, "detail": detail, "applied": False} 并返回；否则调用 fn()，成功追加 applied=True/ok=True，抛异常时追加 applied=True/ok=False 与 error，最后执行 _audit(root, "heal", code, detail)；
+    def act(code: str, detail: str, fn):
+        if dry_run:
+            actions.append({"code": code, "detail": detail, "applied": False})
+            return
+        try:
+            fn()
+            actions.append({"code": code, "detail": detail,
+                            "applied": True, "ok": True})
+        except Exception as e:                       # 自愈失败不能拖垮进程
+            actions.append({"code": code, "detail": detail, "applied": True,
+                            "ok": False, "error": f"{type(e).__name__}: {e}"})
+        _audit(root, "heal", code, detail)
+
+    if "index_drift" in codes or "index_orphan" in codes:
+        act("rebuild_index", "重建索引（漂移 / 孤儿）", cg.rebuild_index)
+    if "ref_stale" in codes or "ref_dangling" in codes:
+        from . import refindex as _ri
+        _led = _ri.Ledger(root)
+        act("rebuild_refs", "按 ref 重建源索引（修复漂移；悬空需人工处置）",
+            lambda: _ri.rebuild(cg, ledger=_led))
+    if "index_log_backlog" in codes:
+        act("flush_index", "合并索引增量分片", cg.flush)
+    if "stale_temps" in codes:
+        paths = _list_stale_temps(root, stale_temp_age)
+
+# 生效条件：对闭包变量 paths 中每个路径尝试 os.remove(p)，单个路径的 OSError 被吞掉后继续处理后续路径；
+        def _sweep():
+            for p in paths:
+                try:
+                    os.remove(p)
+                except OSError:
+                    pass
+        act("sweep_temps", f"清理 {len(paths)} 个陈旧临时文件", _sweep)
+    if "half_line_logs" in codes:
+        paths = _half_line_logs(root)
+        act("seal_half_lines", f"修补 {len(paths)} 个半截日志行",
+            lambda: [_seal_half_line(p) for p in paths])
+
+    # ---- 演化类修复（G7）：默认关闭，且只放行确定性动作 ----
+    if "ccg_backlog" in codes:
+        det = next((i for i in before["issues"] if i["code"] == "ccg_backlog"), {})
+        detail = f"{det.get('detail', '固化候补')}；固化需 LLM 反思/验证"
+        if allow_evolve and reflect_fn is not None:
+            from . import consolidate as _cd
+
+# 生效条件：调用时返回 _cd.consolidate(cg.root, apply=True, reflect_fn=reflect_fn, verify_fn=verify_fn)；
+            def _consolidate():
+                return _cd.consolidate(cg.root, apply=True,
+                                       reflect_fn=reflect_fn,
+                                       verify_fn=verify_fn)
+            act("consolidate_run", detail, _consolidate)
+        else:
+            actions.append({"code": "consolidate_run", "detail": detail,
+                            "applied": False, "reason": "needs_llm"})
+    if "importance_drift" in codes:
+        if allow_evolve:
+            from . import weights
+
+# 生效条件：调用时返回 weights.recalc(cg, apply=True, actor="sustain_evolve")；
+            def _importance():
+                return weights.recalc(cg, apply=True, actor="sustain_evolve")
+            act("importance", "重算结构重要性（确定性；可 rollback）", _importance)
+        else:
+            actions.append({"code": "importance",
+                            "detail": "重算结构重要性（确定性动作）",
+                            "applied": False, "reason": "evolve_disabled"})
+
+    after = (before if dry_run
+             else diagnose(cg, name=name, stale_temp_age=stale_temp_age))
+    return {"ok": after["ok"], "dry_run": dry_run, "actions": actions,
+            "before": before["stats"], "after": after["stats"],
+            "t": time.time()}
+
+
+# --------------------------------------------------------------------------
+# 会话水位（重启续接）
+# --------------------------------------------------------------------------
+
+# 生效条件：以 root 实例化后账本固定指向 os.path.join(root, LEDGER_FILE)，其 _load/_save/note/resume_point/sessions/summary 均以该路径为唯一读写对象；
+class SessionLedger:
+    """会话水位账本：<root>/_sessions.json。
+
+    与 sources.Ingestor 的水位互补：Ingestor 记「某个源读到哪」，
+    这里记「某个会话发生过什么」——重启后按会话给出续接点。
+    """
+
+# 生效条件：传入 root 时置 self.root=root 且 self.path=os.path.join(root, LEDGER_FILE)，不做其他校验；
+    def __init__(self, root: str):
+        self.root = root
+        self.path = os.path.join(root, LEDGER_FILE)
+
+# 生效条件：self.path（root/LEDGER_FILE）可读且 json 结果为 dict、且 d.get("sessions") 也是 dict 时返回该 d；self.path 不可读、json.load 抛 ValueError/OSError、或 d 非 dict / sessions 非 dict 时返回 {"schema": 1, "sessions": {}}；
+    def _load(self):
+        if os.path.exists(self.path):
+            try:
+                with open(self.path, encoding="utf-8") as f:
+                    d = json.load(f)
+                if isinstance(d, dict) and isinstance(d.get("sessions"), dict):
+                    return d
+            except (ValueError, OSError):
+                pass
+        return {"schema": 1, "sessions": {}}
+
+# 生效条件：传入 d 时执行 atomic_write(self.path, json.dumps(d, ensure_ascii=False, indent=1))，自身无返回值；
+    def _save(self, d):
+        atomic_write(self.path, json.dumps(d, ensure_ascii=False, indent=1))
+
+# 生效条件：以 session 为键 setdefault 会话记录后写 events=int(s.get("events") or 0)+int(n)（n 默认 1，n=0 时计数不变），t 非 None 时写 last_t 且 first_t 为空时一并写入，seq 非 None 时写 last_seq，actor 为真值时写 actor，最后写 updated_at 并 _save，返回 dict(s, session=session)；
+    def note(self, session: str, *, t=None, seq=None, n: int = 1,
+             actor: str = None) -> dict:
+        """记一笔会话活动（事件计数 + 最后 (t, seq) 水位）。"""
+        d = self._load()
+        s = d["sessions"].setdefault(
+            session, {"events": 0, "first_t": None, "last_t": None})
+        s["events"] = int(s.get("events") or 0) + int(n)
+        if t is not None:
+            s["last_t"] = float(t)
+            if s.get("first_t") is None:
+                s["first_t"] = float(t)
+        if seq is not None:
+            s["last_seq"] = seq
+        if actor:
+            s["actor"] = actor
+        s["updated_at"] = time.time()
+        self._save(d)
+        return dict(s, session=session)
+
+# 生效条件：_load()["sessions"].get(session) 为假值（键缺失或值为空 dict）时返回 {"session": session, "resume": None, "events": 0}；否则返回 {"session": session, "events": s.get("events", 0), "resume": {"t": s.get("last_t"), "seq": s.get("last_seq")}, "last_t": s.get("last_t"), "actor": s.get("actor")}；
+    def resume_point(self, session: str) -> dict:
+        """重启续接点：(t, seq) 之后的事件才是新的。"""
+        s = self._load()["sessions"].get(session)
+        if not s:
+            return {"session": session, "resume": None, "events": 0}
+        return {"session": session, "events": s.get("events", 0),
+                "resume": {"t": s.get("last_t"), "seq": s.get("last_seq")},
+                "last_t": s.get("last_t"), "actor": s.get("actor")}
+
+# 生效条件：无参调用时返回 dict(self._load()["sessions"]) 的浅拷贝，账本缺失/损坏时 _load 回落默认值故此处为 {}；
+    def sessions(self) -> dict:
+        return dict(self._load()["sessions"])
+
+# 生效条件：取 d=_load()["sessions"] 后返回 {"sessions": len(d), "events": sum(int(v.get("events") or 0)), "latest": max(v.get("last_t") or 0) if d else None}，d 为空时 latest 为 None；
+    def summary(self) -> dict:
+        d = self._load()["sessions"]
+        return {"sessions": len(d),
+                "events": sum(int(v.get("events") or 0) for v in d.values()),
+                "latest": max((v.get("last_t") or 0) for v in d.values())
+                if d else None}
+
+
+# 生效条件：os.path.exists(os.path.join(cg.root, "_sources.json")) 为真且 json.load 成功时返回 dict((d or {}).get("sources") or {})（d 或 sources 为假值即回落 {}）；该路径不可读或 json.load 抛 ValueError/OSError 时返回 {}；
+def watermarks(cg) -> dict:
+    """源视角水位快照（读 sources.Ingestor 的 _sources.json）。"""
+    p = os.path.join(cg.root, "_sources.json")
+    if not os.path.exists(p):
+        return {}
+    try:
+        with open(p, encoding="utf-8") as f:
+            d = json.load(f)
+    except (ValueError, OSError):
+        return {}
+    return dict((d or {}).get("sources") or {})
+
+
+# --------------------------------------------------------------------------
+# 常驻循环
+# --------------------------------------------------------------------------
+
+# 生效条件：传入 cg 即构造实例并把 self.cg 指向它，name/beat_interval/heal_interval/auto_heal/scrub_interval/auto_scrub/evolve_interval/auto_evolve/tidy_interval/auto_tidy 用各默认值（DEFAULT_* 与 False/True）经 float()/bool() 落为 self 属性，ledger 为假值（默认 None）时回落 SessionLedger(cg.root)，d 经 net_dir(d) 赋值，其余运行态字段初始化为 False/None/空列表/空 Event/Lock
+class SustainLoop:
+    """常驻自维持循环：后台线程周期心跳 + 周期巡检 + 必要时自愈。
+
+    daemon 线程，进程退出即消失；`stop()` 会清掉自己的心跳戳，
+    让对端立刻看到「正常下线」而不是「失联」。
+    """
+
+# 生效条件：传入 cg 时按 name 与各 DEFAULT_* 默认值初始化——self.d=net_dir(d)（d 假值时回落 MDCG_SUSTAIN_DIR/~/ .mdcg/sustain）、self.ledger=ledger or SessionLedger(cg.root)（ledger 假值时新建），beat/heal/scrub/evolve/tidy 间隔 float() 化、auto_heal/auto_scrub/auto_evolve/auto_tidy bool() 化后存为实例属性；
+    def __init__(self, cg, name: str = "md_cg", *,
+                 beat_interval: float = DEFAULT_BEAT_INTERVAL,
+                 heal_interval: float = DEFAULT_HEAL_INTERVAL,
+                 auto_heal: bool = True, d: str = None,
+                 ledger: SessionLedger = None,
+                 scrub_interval: float = DEFAULT_SCRUB_INTERVAL,
+                 auto_scrub: bool = False,
+                 evolve_interval: float = DEFAULT_EVOLVE_INTERVAL,
+                 auto_evolve: bool = False,
+                 tidy_interval: float = DEFAULT_TIDY_INTERVAL,
+                 auto_tidy: bool = False):
+        self.cg = cg
+        self.name = name
+        self.beat_interval = float(beat_interval)
+        self.heal_interval = float(heal_interval)
+        self.auto_heal = bool(auto_heal)
+        self.d = net_dir(d)
+        self.ledger = ledger or SessionLedger(cg.root)
+        self.scrub_interval = float(scrub_interval)
+        self.auto_scrub = bool(auto_scrub)
+        self.evolve_interval = float(evolve_interval)
+        self.auto_evolve = bool(auto_evolve)
+        self.tidy_interval = float(tidy_interval)
+        self.auto_tidy = bool(auto_tidy)
+        self.task_running = False
+        self.beats = 0
+        self.last_beat = None
+        self.last_diagnose = None
+        self.heals = []
+        self.last_scrub = None
+        self.scrubs = []
+        self.last_evolve = None
+        self.evolves = []
+        self.last_tidy = None
+        self.tidys = []
+        # 数据健康不变量断言集结论（Pi⑤）：与 tidy 同节奏，只取结论不落盘
+        self.last_conformance = None
+        self._started_at = None
+        self._th = None
+        self._stop = threading.Event()
+        self._lock = threading.Lock()
+
+    # ---- 心跳 ----
+
+# 生效条件：task_running 非 None 时先置 self.task_running=bool(task_running)，再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0)，beats 自增并记 last_beat=rec["ts"]，返回该 rec；
+    def beat(self, task_running: bool = None) -> dict:
+        if task_running is not None:
+            self.task_running = bool(task_running)
+        rec = write_stamp(
+            self.name, self.d, task_running=self.task_running, root=self.cg.root,
+            uptime=round(time.time() - self._started_at, 3)
+            if self._started_at else 0.0)
+        self.beats += 1
+        self.last_beat = rec["ts"]
+        return rec
+
+    # ---- 生命周期 ----
+
+# 生效条件：不适用（无必需形参与模块级常量）
+    def start(self):
+        if self._th is not None and self._th.is_alive():
+            return self
+        self._started_at = time.time()
+        self._stop.clear()
+        self.beat()
+        self._th = threading.Thread(target=self._run, name="mdcg-sustain",
+                                    daemon=True)
+        self._th.start()
+        return self
+
+# 生效条件：调用时置 _stop 事件，self._th 非 None 时 join(timeout)（默认 3.0）后置为 None，随后 clear_stamp(self.name, self.d)，返回 self；
+    def stop(self, timeout: float = 3.0):
+        self._stop.set()
+        if self._th is not None:
+            self._th.join(timeout)
+            self._th = None
+        clear_stamp(self.name, self.d)
+        return self
+
+# 生效条件：self._stop 未置位期间轮询，按 beat_interval/heal_interval/scrub_interval/evolve_interval/tidy_interval 到期分别执行 beat 与 _tick_heal/_tick_scrub/_tick_evolve/_tick_tidy，各 tick 抛出的异常被吞掉不中断循环，末尾以 _stop.wait(_POLL) 休眠；
+    def _run(self):
+        next_beat = time.time() + self.beat_interval
+        next_heal = time.time() + self.heal_interval
+        next_scrub = time.time() + self.scrub_interval
+        next_evolve = time.time() + self.evolve_interval
+        next_tidy = time.time() + self.tidy_interval
+        while not self._stop.is_set():
+            now = time.time()
+            if now >= next_beat:
+                try:
+                    self.beat()
+                except Exception:
+                    pass                       # 心跳失败不中断常驻
+                next_beat = now + self.beat_interval
+            if now >= next_heal:
+                try:
+                    self._tick_heal()
+                except Exception:
+                    pass                       # 巡检失败不中断常驻
+                next_heal = now + self.heal_interval
+            if now >= next_scrub:
+                try:
+                    self._tick_scrub()
+                except Exception:
+                    pass                       # 自净失败不中断常驻
+                next_scrub = now + self.scrub_interval
+            if now >= next_evolve:
+                try:
+                    self._tick_evolve()
+                except Exception:
+                    pass                       # 演化巡检失败不中断常驻
+                next_evolve = now + self.evolve_interval
+            if now >= next_tidy:
+                try:
+                    self._tick_tidy()
+                except Exception:
+                    pass                       # 整理巡检失败不中断常驻
+                next_tidy = now + self.tidy_interval
+            self._stop.wait(_POLL)
+
+# 生效条件：以 apply=self.auto_tidy 调 writelimit.tidy_contextual(self.cg, actor="sustain_tidy")，把 t/scanned/groups/members/applied_count/auto_tidy 记入 self.last_tidy 与 tidys（仅保留最近 20 条），随后调 _tick_conformance()；auto_tidy=False（默认）时只盘点不落盘；
+    def _tick_tidy(self):
+        """整理巡检（contextual 流水治理·读侧）：同构组聚合 + 成员降权。
+
+        确定性动作、永不删节点；`auto_tidy=False`（默认）只盘点不落盘。
+        治理对象：单日批次流水（「批次247收官记忆」×163 那类同模板写入）
+        —— 写入侧限流（writelimit.check）拦增量，本巡检收敛存量。
+        """
+        from . import writelimit
+        r = writelimit.tidy_contextual(self.cg, apply=self.auto_tidy,
+                                       actor="sustain_tidy")
+        rec = {"t": r["t"], "scanned": r["scanned"], "groups": r["groups"],
+               "members": r["members"],
+               "applied_count": r.get("applied_count", 0),
+               "auto_tidy": self.auto_tidy}
+        self.last_tidy = rec
+        with self._lock:
+            self.tidys.append(rec)
+            self.tidys = self.tidys[-20:]
+        self._tick_conformance()
+
+# 生效条件：把 conformance.report_summary(self.cg) 的结论写入 self.last_conformance；该调用抛异常时写入 {"ok": False, "verdict": "BLINDSPOT", "error": "<类型名>: <消息>"}；
+    def _tick_conformance(self):
+        """数据健康不变量断言集（Pi⑤）——与 tidy 同节奏，**只取结论**。
+
+        复用 tidy 的 6h 节奏而不新开周期：两者都是「存量数据体检」，且都是
+        只读巡检。纪律：本断言集**只告警不改数据**，故 `auto_*` 在此无意义；
+        `check_paths=False` 跳过 1.1 万次 stat，`_audit.jsonl` 只读尾窗。
+        """
+        from . import conformance
+        try:
+            self.last_conformance = conformance.report_summary(self.cg)
+        except Exception as e:                              # noqa: BLE001
+            self.last_conformance = {"ok": False, "verdict": "BLINDSPOT",
+                                     "error": f"{type(e).__name__}: {e}"}
+
+# 生效条件：恒以 evolution_candidates(self.cg) 只读盘点并记入 last_evolve 与 evolves（保留最近 20 条）；仅当 self.auto_evolve 为真且 ev["importance_drift"]["n"] 为真时才额外执行 weights.recalc(self.cg, apply=True, actor="sustain_evolve")，其异常写入 rec["applied"]；
+    def _tick_evolve(self):
+        """演化巡检（G7）：盘点固化/重要性候选 —— 让「有能力」变成「有驱动」。
+
+        恒只读盘点并记账；`auto_evolve=True` 时才额外落盘**确定性**动作
+        （仅重要性重算，可 rollback）。固化依赖 LLM，巡检只报候补量、交人工。
+        """
+        ev = evolution_candidates(self.cg)
+        rec = {"t": ev["t"], "candidates": ev["candidates"],
+               "ccg_backlog": ev["ccg_backlog"]["n"],
+               "importance_drift": ev["importance_drift"]["n"],
+               "auto_evolve": self.auto_evolve, "applied": []}
+        if self.auto_evolve and ev["importance_drift"]["n"]:
+            from . import weights
+            try:
+                r = weights.recalc(self.cg, apply=True, actor="sustain_evolve")
+                rec["applied"].append({"fix": "importance",
+                                       "written": r["written"],
+                                       "batch": r["batch"]})
+            except Exception as e:                 # 演化失败不能拖垮常驻
+                rec["applied"].append({"fix": "importance",
+                                       "error": f"{type(e).__name__}: {e}"})
+        self.last_evolve = rec
+        with self._lock:
+            self.evolves.append(rec)
+            self.evolves = self.evolves[-20:]
+
+# 生效条件：以 dry_run=not self.auto_scrub 调 scrub.sweep(self.cg)，把 t/ok/n_issues/n_high_medium/applied/dry_run 记入 last_scrub 与 scrubs（保留最近 20 条）；auto_scrub=False（默认）时 dry_run=True 只读巡检；
+    def _tick_scrub(self):
+        """记忆自净：抽查 → 联想 → 去污染 → 校准偏差。
+
+        `auto_scrub=False`（默认）时只做只读巡检并记账，不动任何节点；
+        开启后才执行去污染（仍只做可逆动作、永不删节点）。
+        """
+        from . import scrub
+        rep = scrub.sweep(self.cg, dry_run=not self.auto_scrub)
+        rec = {"t": rep["t"], "ok": rep["ok"],
+               "n_issues": rep["audit"]["n_issues"],
+               "n_high_medium": rep["n_high_medium"],
+               "applied": rep["decontaminate"]["applied"],
+               "dry_run": rep["dry_run"]}
+        self.last_scrub = rec
+        with self._lock:
+            self.scrubs.append(rec)
+            self.scrubs = self.scrubs[-20:]
+
+# 生效条件：先 diagnose(self.cg, name=self.name) 并将 ok 与 issues code 记入 last_diagnose；仅当 self.auto_heal 为真且 rep["ok"] 为假时才调 heal(self.cg, name=self.name)，其 actions 非空时把各 action 的 code 记入 heals（保留最近 20 条）；
+    def _tick_heal(self):
+        rep = diagnose(self.cg, name=self.name)
+        self.last_diagnose = {"t": time.time(), "ok": rep["ok"],
+                              "issues": [i["code"] for i in rep["issues"]]}
+        if not (self.auto_heal and not rep["ok"]):
+            return
+        res = heal(self.cg, name=self.name)
+        if res["actions"]:
+            with self._lock:
+                self.heals.append({"t": res["t"],
+                                   "actions": [a["code"] for a in res["actions"]]})
+                self.heals = self.heals[-20:]
+
+    # ---- 状态 ----
+
+# 生效条件：以 read_stamp(self.name, self.d) 判定 state（有戳走 judge(age, interval=self.beat_interval, task_running=...)，无戳为 "stopped"），返回含 name/running/pid/uptime（无 _started_at 时为 0.0）/beats/last_beat/各 interval 与 auto_* 开关/heals[-5:]/evolves[-5:]/tidys[-5:]/peers(self.d)/ledger.summary() 的 dict；
+    def status(self) -> dict:
+        st = read_stamp(self.name, self.d)
+        state = (judge(st["age"], interval=self.beat_interval,
+                       task_running=bool(st.get("task_running")))
+                 if st else "stopped")
+        return {"name": self.name, "running": bool(self._th
+                                                   and self._th.is_alive()),
+                "pid": os.getpid(),
+                "uptime": round(time.time() - self._started_at, 3)
+                if self._started_at else 0.0,
+                "beats": self.beats, "last_beat": self.last_beat,
+                "beat_interval": self.beat_interval,
+                "heal_interval": self.heal_interval,
+                "auto_heal": self.auto_heal, "state": state,
+                "task_running": self.task_running,
+                "last_diagnose": self.last_diagnose,
+                "heals": self.heals[-5:],
+                "scrub_interval": self.scrub_interval,
+                "auto_scrub": self.auto_scrub,
+                "last_scrub": self.last_scrub,
+                "evolve_interval": self.evolve_interval,
+                "auto_evolve": self.auto_evolve,
+                "last_evolve": self.last_evolve,
+                "evolves": self.evolves[-5:],
+                "last_tidy": self.last_tidy,
+                "tidys": self.tidys[-5:],
+                "last_conformance": self.last_conformance,
+                "peers": peers(self.d),
+                "sessions": self.ledger.summary()}
+
+
+_LOOPS = {}
+_LOOPS_LOCK = threading.Lock()
+
+
+# 生效条件：cg 必填，以 (os.path.abspath(cg.root), name) 为键在模块级 _LOOPS 中复用已有实例或新建 SustainLoop 并返回该实例。
+def ensure_loop(cg, name: str = "md_cg", **kw) -> SustainLoop:
+    """按 (root, name) 复用同一个常驻循环（避免重复线程 / 重复戳）。"""
+    key = (os.path.abspath(cg.root), name)
+    with _LOOPS_LOCK:
+        lp = _LOOPS.get(key)
+        if lp is None:
+            lp = SustainLoop(cg, name=name, **kw)
+            _LOOPS[key] = lp
+        return lp
+
+
+# 生效条件：cg 必填，返回 _LOOPS[(os.path.abspath(cg.root), name)]，该键未登记时返回 None。
+def get_loop(cg, name: str = "md_cg"):
+    return _LOOPS.get((os.path.abspath(cg.root), name))
+
+
+# 生效条件：模块级 _LOOPS 非空时清空该表并对每个循环调用 stop()（异常被吞），无返回值。
+def stop_all():
+    """测试 / 进程退出用：停掉本进程创建的所有常驻循环。"""
+    with _LOOPS_LOCK:
+        loops = list(_LOOPS.values())
+        _LOOPS.clear()
+    for lp in loops:
+        try:
+            lp.stop()
+        except Exception:
+            pass
+
+
+# 生效条件：以 read_stamp(name) 有戳时返回 heartbeat={'age': round(st["age"],1), 'state': judge(...), 'pid', 'task_running'}、无戳时 {'state':'absent'}，loop 取 get_loop(cg, name) 有值时给 running/beats/state、无值时 {'running': False}，并附带 SessionLedger(cg.root).summary()、scrub_summary(cg)、evolve_summary(cg)、provenance_summary(cg)；
+def summary(cg, name: str = "md_cg") -> dict:
+    """并入 health_os 的轻量摘要（只读戳与计数，不做巡检）。"""
+    st = read_stamp(name)
+    lp = get_loop(cg, name)
+    return {
+        "heartbeat": ({"age": round(st["age"], 1),
+                       "state": judge(st["age"],
+                                      task_running=bool(st.get("task_running"))),
+                       "pid": st.get("pid"),
+                       "task_running": bool(st.get("task_running"))}
+                      if st else {"state": "absent"}),
+        "loop": ({"running": bool(lp._th and lp._th.is_alive()),
+                  "beats": lp.beats, "state": lp.status()["state"]}
+                 if lp else {"running": False}),
+        "sessions": SessionLedger(cg.root).summary(),
+        "scrub": scrub_summary(cg),
+        "evolve": evolve_summary(cg),
+        "provenance": provenance_summary(cg),
+    }
+
+
+# 生效条件：cg 必填，可导入 provenance 且其 summary(cg) 调用成功时返回该摘要，异常时返回 {}。
+def provenance_summary(cg) -> dict:
+    """派生溯源摘要（G8，只读；失败不抛，避免拖垮 health_os）。"""
+    try:
+        from . import provenance as _pv
+        return _pv.summary(cg)
+    except Exception:                     # noqa: BLE001
+        return {}
+
+
+# 生效条件：cg 必填，evolution_candidates(cg, top=3) 成功时返回 candidates/ccg_backlog/importance_drift 计数摘要，异常时返回 {}。
+def evolve_summary(cg) -> dict:
+    """演化巡检摘要（只读；失败不抛，避免拖垮 health_os）。"""
+    try:
+        ev = evolution_candidates(cg, top=3)
+        return {"candidates": ev["candidates"],
+                "ccg_backlog": ev["ccg_backlog"]["n"],
+                "importance_drift": ev["importance_drift"]["n"],
+                "proxy": True}
+    except Exception:                     # noqa: BLE001
+        return {}
+
+
+# 生效条件：cg 必填，可导入 scrub 且其 summary(cg) 调用成功时返回该摘要，异常时返回 {}。
+def scrub_summary(cg) -> dict:
+    """记忆自净摘要（惰性导入，避免模块加载顺序耦合）。"""
+    try:
+        from . import scrub
+        return scrub.summary(cg)
+    except Exception:                     # noqa: BLE001
         return {}