105. Graph Kernel 设计
状态：核心与只读观测面首次随
chainlesschain@0.166.0发布；authoritative entry cutover 随0.166.7发布；耐久历史、HumanTask quorum、definition migration/retirement evidence、Team 公平性与多端 single-winner settlement 由当前完整门禁版0.166.21@1ff70b7856公开承接（2026-09-04）｜GraphDefinition v1｜Graph event v1｜Desktop/Browser 投影仍只读
1. 定位
Graph Kernel 是 ChainlessChain 的 canonical 多 Agent 执行内核。它统一描述任务依赖、动态扩展、Agent capacity、AssignmentAttempt、消息与 custody handoff、外部 Effect、Artifact、HumanTask、恢复和终态证据。
Graph Kernel 与 CC App Server 分工明确：
| 层 | 负责 | 不负责 |
|---|---|---|
| CC App Server | 产品接入、Thread/Turn/Item/Approval、协议协商、rollout | Task DAG 调度与多 Agent 资源竞争 |
| Graph Kernel | Graph IR、调度、消息、Effect、HumanTask、事件与投影 | UI transport、客户端生命周期协议 |
1.1 0.166.9 耐久化增量
- 固定客户端可以读取有界、metadata-only 的 event/snapshot history，用于 blocked-root、revision diff 与 time travel；正文和秘密不进入投影。
- definition migration 持久化 N-1 备份、旧/新 digest、rollback digest、replay validation 与 exact source evidence。
- retirement gate 验证 replacement reachability、historical reads 与 legacy writer 零成功观察，拒绝仅靠文字声明完成退役。
- HumanTask 在等待人工决定时释放 Agent capacity；claim、decision 与 cancel 绑定 exact revision/attempt/operation，并用 CAS 保证 single winner。
- Android、iOS、Web Panel、Desktop 与 IDE 只提交绑定决定；quorum、职责分离和 grant scope 仍由 canonical runtime 结算。
- Team 调度加入 dependency/scope aging、priority donation 与 fairness SLO；早到的 aging service 仍必须受 capacity、budget、lease/fence 与 write scope 约束。
1.2 0.166.21 当前公共基线与历史质量门
公开 0.166.21 完整承接上述 Graph 能力、Context/Memory Kernel、耐久 rollout store、Hooks v2、默认 sandbox/审批失败闭合和 Windows Docker-optional 启动，并增加 Evolution Workbench、Skill Retrieval、governed knowledge 与 trust ledger。这些平台能力改变 Graph adapter 的上下文、持久化和执行边界，但不改变三类图的职责分离。
v-npm-0-166-15@22db04f559 还纳入两类证据并刷新 formal eval producer digest：
- Team worktree result 保留 commit/output digest，canonical Graph trace 随 team state 一起持久化，终态不能只依赖进程内 status；
- formal quality profile 使用真实 control/candidate、独立 worktree、至少 3 轮/1,800 秒、固定 6 个任务和三平台 exact-SHA evidence，比较通过率、行为等价、无关改动、死锁/对账、message/handoff、token、时延与成本。
- control/candidate 共用冻结的
read_file/search_files/list_dir/write_file/edit_file/edit_file_hashed工具契约；shell、网络、Git、MCP、插件、IDE 与子 Agent 工具保持禁用。
正式评测还要求临时目录内的 hermetic CHAINLESSCHAIN_HOME、provider/凭据隔离、Windows ACL preflight 和 shell timeout 下限。发布后的 main@458b342f5f 再增加 Windows 每 Agent HOME/config/cache 隔离、瞬态审计重试和最终 1.65 平台时延阈值；这些不属于 0.166.15 tarball，也不构成新的公共 SLA。固定 SHA db53dc2da4 的 run 33411796790 没有形成成功 aggregate/OIDC，P2-3 是在 Windows 1.6379980224 <= 1.65、功能/安全指标通过及离线加权 aggregate 0.6008293973 < 1.5 的基础上，由发布负责人显式接受剩余证据风险后关闭。
1.3 历史未合并快照与外部证据合同
本节保留 2026-09-01 的
233e1bdc分支评审记录用于审计。当时的“未合并/source-only”判断已被后续0.166.21发布取代；当前 Skill evolution 架构与剩余生产缺口以模块 112为准，不能继续把本节快照描述为现状。
本轮核对冻结的本地功能分支快照为 233e1bdc，晚于且未合入 GitHub main@458b342f5f；该锚点不表示它永远是分支当前 head。其中 d478270c/e2b18598 为 Graph production cutover 增加 authenticated source registry、Linux/Windows/macOS collector、protected input freeze、source/host receipt、hosted aggregate、exact artifact/certificate close 和多阶段 stale-main 拒绝。它们保证陈旧 head、旁路 ref、跨 run artifact 或未登记 source 失败闭合，但不代表生产切流已经发生。
同一分支的相邻外部证据合同也必须按编号分开判断：
- P1-10（
9951afa5/5bddb9ce）要求六个实名物理 host、OS containment、不可导出 attester、签名原始事件链、1,800 秒 soak 与 exact-attempt close；当前 enrollment registry 为空，没有 fresh producer/close receipt； - P1-11（
3c4342d8）只允许受保护main当前 head 触发签名 Desktop producer；普通分支、tag、旧 head 与跨 run artifact 均拒绝。既有成功证据仍绑定ee88125256，不能授权本轮本地冻结快照233e1bdc； - P1-12/Graph production 要求真实三源 observer、五 surface staged rollout/rollback、旧 writer 观察和 authenticated close；当前 source registry 为空，也没有生产 aggregate/OIDC receipt。
所以 P1-10、P1-11、P1-12 仍为部分完成。b8490faa 的 evolution evidence projection 是独立的 Skill 治理投影，不是 Graph Artifact/Trace writer、Graph cutover receipt 或 promotion authority；d073bdf3 又新增签名 append-only segment/HEAD、独立 witness、artifact resolver 与 receipt/query/verify 的 tamper-evident EvolutionLedger，并对篡改、回滚、并发和崩溃恢复失败闭合；233e1bdc 继续绑定 mutation transition subject。Ledger 在仓库中没有 production import/实例化，整组能力都没有统一生产 wiring/正式验收，也未进入 0.166.15。
Ledger 单测共 35 项，本机为 34 pass、1 个默认 5 秒 timeout（首项实际约 18.848s，整套约 128.9s）；另一个范围的 233e1bdc 六治理文件定向回归为 6/6 files、126/126 tests 通过，耗时 28.84s。两者范围不同；后者全绿也不是 Graph、P1-10/P1-11/P1-12 或 Skill evolution 的 production qualification/关闭证据。
2. GraphRun 与三类图
GraphRun 是 authority envelope，不是把所有关系混在一起的第四种“万能图”。它绑定 run id、definition/revision digest、trace/correlation、权限、预算与事件 head；三类图共享这些身份，但各自只有一种职责：
| 平面 | 回答的问题 | 权威职责 | 明确不负责 |
|---|---|---|---|
| Task Graph / runtime | 哪些任务何时可以运行？ | 确定性依赖、condition、join、retry、ready frontier、Attempt 与终态 predicate | 表达动态 Agent 父子关系 |
| Agent Tree | 谁在执行和协作？ | spawn、capacity、AssignmentAttempt、message、handoff、wait/interrupt 与 residency | 定义 Task 依赖；父子关系不自动生成 DAG 边 |
| Artifact/Trace projection | 发生了什么，证据在哪里？ | 从 append-only 事件确定性生成 provenance、因果、timeline、replay、diff 与 Eval | 作为 scheduler source of truth 或反向写 runtime |
实线表示命令、调度或耐久事件；虚线只表示确定性只读投影。
箭头语义也不能混用：start/wake 是命令，dispatch AssignmentAttempt 是调度，指向 event store 的边是耐久事实，虚线 reduce 是只读投影。Agent 动态 spawn 只改变执行拓扑；只有通过 compile、权限/预算复验和 expected-revision CAS 的显式 append 才改变 Task Graph。
3. 架构
GraphDefinition v1
│ canonicalize + schema validate + migrate/upcast
▼
Graph Compiler
├─ reference / dependency / cycle validation
├─ port / capability / budget / write-scope validation
├─ loop / region / trigger / compensation validation
└─ revisionDigest + immutable compiled graph
│
▼
GraphKernel
├─ GraphRun + producer lease + dynamic revision CAS
├─ agent capacity + AssignmentAttempt lease/fence
├─ Effect begin/settle/reconcile + compensation
├─ Artifact provenance
├─ causal Message + dead letter
├─ custody handoff state machine
├─ HumanTask claim/quorum/separation-of-duty
└─ deadlock/livelock/quiescence classification
│
▼
GraphEventStore (append-only hash-chained rollout)
│
├─ Trace reducer / time travel / diff / blocked root
├─ Graph eval / thresholds / schedule equivalence
└─ runtime adapter shadow/cutover evidence3.1 现有执行面的收敛职责
Canonical Graph Kernel 不是再造一个平行 scheduler，而是把已有真实能力收敛到上述职责边界：
| 现有执行面 | 复用到 canonical kernel 的能力 | 收敛要求 |
|---|---|---|
| CLI Scheduler Kernel | occurrence identity、temporal admission、lease/fence、retry/dead-letter 与 unknown-outcome adjudication | 只负责 Trigger/Occurrence；以 journal 关联唯一逻辑 GraphRun，不计算 Task ready frontier |
CLI cc team | 依赖 DAG、priority、Task lease/fence、预算、scope、worktree/checkpoint/merge 与分布式恢复 | 收敛为 Task runtime/AssignmentAttempt adapter；补齐 typed contract、revision CAS 和 authoritative event writer |
| CLI Cowork / Dynamic Workflow | condition、fan-out、loop、retry/timeout、definition digest、Effect/Receipt 与 Artifact lineage | 收敛为 Graph Compiler、structured control 与 Effect adapter；并行写必须进入 scope/worktree 隔离 |
| Desktop Browser Workflow | condition、nested loop、try/catch/finally 与 sub-workflow | 作为 Region/LoopRegion/SubgraphCall adapter；补 restart hydration、parent binding、cycle/depth guard 与取消级联 |
旧 Workflow/AgentCoordinator/$team | designer、UI、模板与兼容状态 | 降级为 designer/simulator 或只读投影，不能继续声明 phantom success |
*V2 governance overlay | profile、容量与策略原型 | feature-gate，或改为耐久事件投影；进程内 Map 不能冒充可恢复 runtime |
收敛完成的判据不是“存在同名类”，而是同一 adapter contract、同一事件账本、唯一 authoritative writer、shadow projection 等价、rollback drill 通过并关闭 legacy write entrypoint。
4. GraphDefinition 与编译器
compileGraphDefinition() 接受纯 JSON GraphDefinition。当前支持版本范围为 v1；canonical JSON 对 key 排序并拒绝非有限数字、函数、Symbol、BigInt、循环/重复对象和非 plain object，随后生成 domain-separated SHA-256 digest。
编译必须在任何 Effect 前完成。验证至少包括：
- Schema、版本与 migration/upcast；
- node/edge/loop/trigger/region id 唯一性；
- 未知引用、自引用和 dependency cycle；
- 输入/输出 port 与
${node...}/${step...}引用； - capability、预算（turn/token/cost/wall/spawn）与 write scope；
- loop/region 的边界和动态扩展约束；
- compensation node 唯一归属，禁止自补偿和冲突目标；
- trigger binding 与 scheduler dispatch 身份。
失败抛出 GraphCompileError，code 为 CC_GRAPH_COMPILE_FAILED，diagnostics 按 path/code 稳定排序，并明确 effectStarted: false。
4.1 Versioned typed Graph IR
Canonical IR 至少包含以下一等实体，不能把它们压回 prompt 字符串或一个宽泛的 task.status：
| 实体 | 绑定内容 |
|---|---|
GraphDefinition / GraphRevision | version、immutable digest、typed node/edge、预算与权限上界 |
GraphRun / TriggerBinding / OccurrenceRef | 运行身份、revision、authority、correlation、event head 与幂等 admission |
TaskNode / Edge | capability/role、tools/skills、typed input/output、acceptance、permission、budget、write-set、retry、effect class 与 compensation |
Region / LoopRegion / SubgraphCall / IterationFrame | 显式 entry/exit、bounded iteration、digest pin、budget slice、cancel/compensation boundary 与 call-cycle/depth guard |
AgentRuntime / AssignmentAttempt | 真实 executor/participant、capacity slot、role、grant、lease/fence 与 participation status |
Message / Handoff / HumanTask / Decision | 因果消息、custody 状态机、人工 claim/quorum、operation digest、TTL 与 CAS |
ArtifactRef / Receipt / WaitReason | 不可变产物、外部 Effect 证据、消费者、retention 与确定性等待根因 |
边区分 control、data、message、review、merge 与 compensation，并支持 success/failure/always/timeout/cancel 传播；join 支持 all/any/quorum/race。Task 依赖保持无环，循环和递归只能通过有界 Region/Subgraph 展开为 (nodeId, iterationPath, attempt) 唯一的无环执行尝试。
Message、DataRef 与 ArtifactRef 还携带可信 dispatch 赋值的 origin/trust/sensitivity/allowedSinks。解密、降级或跨信任域发送必须绑定审计化 declassification decision；不可信内容不能自行变成 approval、Graph control edge 或新增 capability。
5. GraphRun 生命周期
GraphRun 从 immutable compiled graph 与 revision digest 启动。运行时允许在 producer lease 下追加经过编译的新图片段；append 使用 revision CAS，seal 后禁止继续扩展。
一次正常运行按以下边界推进：
- Scheduler occurrence 通过幂等 admission，仅提交 start/wake 命令；
- GraphRun 绑定 immutable revision、authority 与预算，同一 occurrence 重试仍关联同一逻辑 run；
- Task runtime 计算 ready frontier，并向 Agent Tree 分派
AssignmentAttempt； - Attempt、Message/Handoff、Effect/Receipt、Artifact 与状态转换追加到事件账本；
- terminal predicate 成立后结算 run；projector 始终只读消费事件并生成调试/Eval 投影。
created → running/open ──seal──> running/sealed
│ ├─ waiting_input / waiting_external
│ ├─ waiting_human / reconciliation_required
│ └─ succeeded / failed / partial / cancelled
│ blocked / deadlocked / budget_exhausted
└─ producer lease + revision CAS append（仅 open）Quiescence 不等于成功：当没有 ready/running work 时，还要检查 active producer lease、待处理消息、未决 handoff、HumanTask、timer/child/revision 和 unknown Effect，才能判断成功、等待、死锁或需要对账。Occurrence succeeded 只表示 start/wake 已耐久接纳，不代表 GraphRun 成功；外部 Effect 响应丢失必须依据 receipt/reconcile 裁决，不能从 Trace 投影猜测后盲目重放。
运行终态采用确定性代数：全部取消才是 cancelled，成功与失败/取消并存为 partial，失败依赖产生 upstream_failed/blocked-root，循环上限产生 budget_exhausted。reconciliation_required 是必须继续裁决的非成功状态，不能通过 UI 文案改写为 completed。
6. 调度、Attempt 与 fencing
Task node 与执行尝试采用 N:M 模型：一个 node 可以有多个 AssignmentAttempt，但只有 accepted attempt 可以结算节点。
关键字段：
- Agent
capacity：限制并行占用； - Attempt
leaseId+fence+ TTL：防止过期 Worker 回写； - priority donation / aging / critical boost：缓解反转与饥饿；
- budget reservation：尝试开始前预留，结算时核销；
- artifact/write provenance：绑定 attempt、lease 与 scope。
renewAttempt、beginEffect、settleEffect、registerArtifact 与 settleAttempt 都复核 lease/fence。取消、租约过期或新 fence 生效后的迟到结果不能改变权威状态。
调度还必须同时处理：
- 依赖后代的 priority donation、等待 aging 与 critical-path boost，避免 priority inversion 和长期饥饿；
all/any/quorum/racejoin，以及 race loser cancellation；- workspace write-set 静态冲突检查和运行时 active scope 冲突；并行可写节点默认使用独立 worktree，不能把 checkpoint 当成外部副作用补偿；
- cancel/timeout 停止新分派、级联中断 child、等待在途 settlement，再以 fencing 拒绝 late result；
- Task/Agent/Message/Scope/Lease/Timer/Human/Join wait-for graph，以及 progress digest 重复形成的 livelock 诊断。
7. Effect、Receipt 与补偿
外部副作用使用两阶段语义：
beginEffect在执行前记录 operation digest、attempt、authority 与幂等身份；- driver 执行外部操作；
settleEffect记录 receipt；响应丢失或结果不明进入 unknown；reconcileEffect依据外部证据裁决，不盲目重放；- 需要时由显式 compensation node 处理，不把“反向执行”假设成天然可逆。
Graph Kernel 不宣称全局 exactly-once。正确口径是 durable admission、幂等身份、at-least-once delivery 与 unknown-outcome reconciliation。
Graph state、lease、Message 和 Effect Receipt 之间的跨组件提交使用 transactional outbox/inbox 或等价 journal 收敛。必须覆盖“状态已提交但消息未发”“任务已派发但 lease 未落账”“Effect 已发生但 Receipt 丢失”“processed 已发生但 ACK 未持久化”等 crash cut point；恢复依靠 inbox dedup、fencing 与 reconcile，而不是进程内回调顺序。
8. Artifact
Artifact 注册绑定：
- stable id 与 digest；
- producer node/attempt；
- Graph revision；
- workspace/write scope；
- provenance 与 terminal evidence。
成功不能只依赖状态字符串。Adapter 返回 succeeded 时必须同时绑定 terminal event digest，以及 output digest、Artifact digest、commit 或 test receipt 中至少一类不可变输出证据。
9. Message 与 custody handoff
Message 生命周期区分 admitted、delivered、read、processed 与 dead-letter，携带 causation、correlation、conversation、sender attempt/lease、revision 与 payload digest。
消费语义是 at-least-once + consumer key 去重。ACK 丢失、poison message 和跨 channel 重排都必须能恢复。
Custody handoff 独立建模：
offered → accepted → committed
├────→ rejected
├────→ revoked
└────→ expiredcommit/revoke 复核双方 attempt、lease/fence 与 binding，避免已失权 Agent 继续交付。
10. HumanTask
HumanTask 是可持久恢复的图节点等待态，不占用执行 slot。它支持：
- claim / reclaim；
- revision、attempt 与 operation digest binding；
- 单人决策或多人 quorum；
- separation of duty；
- 重启快照；
- cancel/decision CAS。
UI 不能仅凭本地按钮状态结算 HumanTask；必须提交绑定当前 revision 的决定并处理冲突。
11. 事件账本与投影
GraphEventStore 复用 hash-chained rollout，每个事件包含 schema、runId、seq、type、timestamp、prevHash、hash、idempotencyKey 与 payload。
Trace reducer 生成：
- Agent Tree；
- Task Graph；
- Artifact Graph；
- Message Graph；
- Effect/Attempt/Handoff/HumanTask 列表；
- Timeline 与 critical path；
- blocked root 与 projection digest。
timeTravelGraphTrace(events, seq) 只读取指定序列前缀；diffGraphTrace(left, right) 比较两个投影；这些操作不修改权威事件。
12. Eval
单次 GraphRun 指标包括：
terminalSuccessacceptedAttemptsduplicateAttempts/duplicateWorkRatiomessageVisibilityRatehandoffCompletionRate/custodyCommitRatecriticalPathUtilizationtotalWorkMs/criticalPathMsdeadlockedreconciliationRequired
Threshold gate 支持每个指标的 min / max。多 case/seed eval suite 还比较 single-agent control 与 graph candidate 的 terminal node / Artifact schedule equivalence，并要求绑定精确 40/64 字符 commit SHA。
13. CLI 观测面
cc team graph inspect <run-id> [--at-seq <n>] [--blocked-root <node-id>]
cc team graph diff <run-id> --from-seq <n> --to-seq <n>
cc team graph eval <run-id> [--thresholds <json>]这是只读观测面，不负责创建 GraphRun。默认隐藏 Message/HumanTask 内容，--include-content 只应在受控诊断环境显式使用。
14. Adapter 与 authoritative 切换
已定义的 runtime surface：cli_team、cowork、scheduler、desktop、browser。每个 adapter 必须发布 machine-readable claims：
- execution：real / simulated / planned；
- persistence：durable / non_durable；
- isolated；
- terminalEvidence；
- authoritative；
- Browser 的 restartHydration / featureGated。
同一时刻最多一个 authoritative writer。切换前必须：
- legacy 与 canonical shadow projection 的 terminal/causal diff 全等；
- 完成可验证 rollback exercise；
- 清零 legacy write entrypoints。
不满足任一条件时 assertGraphKernelCutover 失败闭合。
14.1 CLI 0.166.7 authoritative cutover
0.166.7 将 CLI graph、Team、distributed-team、Cowork、Scheduler 与 App Server 入口统一接入持久 cutover ledger 和 authority resolver。每次入口运行绑定 checked-out source evidence、entry、store、writer 与 revision；takeover、恢复和 migration saga 复核 lease/fence 与耐久 head。过期 owner、错误 store 或不匹配源码不能继续写入。
Retired runtime 只保留显式只读历史投影；未分类或仍尝试 mutation 的 legacy route 失败闭合并返回 canonical replacement target。这里的“authoritative”只覆盖上述 CLI 产品入口，不把 Desktop、Browser 或 IDE 自动视为完成切换。
14.2 Desktop Graph Run Debugger
Desktop 源码提交 3e4d70eb52 与 8995ca2488 增加只读 Graph Run Debugger，并在 AI Chat、Workflow Monitor 与 Agent Dashboard 任务历史中消费 canonical Graph/history：
- Topology：节点依赖、状态、critical path、slack 与 blocked root；
- Timeline：耐久事件时间线；
- Budget heatmap：节点预算使用率；
- Trace overlay：Attempt、Artifact 与 Effect 证据；
- Causality：任务、消息、审批、租约与 Artifact 的元数据因果链；
- replay slider：按历史 revision/time frame 回放并展示节点增删、状态差异。
Debugger 是 Renderer 侧只读投影，不持有 writer authority。消息与 Artifact 正文不进入 overlay；历史来源没有耐久事件时必须显示缺口，不能从 UI 状态反推或补写权威事实。该 Desktop 源码增量不属于 npm CLI 0.166.7 制品。
15. 安全不变量
- 编译先于 Effect，非法图不能产生副作用；
- 权限、预算、write scope 与 data sink 在节点和动态 append 时都复验；
origin、trust、sensitivity、allowedSinks随 DataRef/ArtifactRef 传播；- lease/fence 阻止迟到 Worker、旧 Agent 与已取消 attempt 结算；
- Message/HumanTask 内容默认从 CLI 投影中省略；
- terminal success 必须有不可变证据；
- Browser 无 restart hydration 时只能 non-durable 且 feature-gated。
16. 发布状态与未决项
已发布：GraphDefinition v1 编译、Graph runtime 核心、structured Loop/Subgraph、event store、trace/time travel/diff、eval、runtime claims/shadow/cutover gate 与 CLI 只读观测面。0.166.7 完成 CLI graph、Team、distributed-team、Cowork、Scheduler 与 App Server entry 的 authoritative writer 切换；0.166.21 是当前完整门禁公共基线，并承接 worktree/trace 证据、formal quality 文件工具热修复、Workbench/Retrieval 和受治理 knowledge composition。该状态不能外推为所有 Desktop/Browser/IDE 产品面已完成切换，也不代表生产 authority 或无人值守 active promotion 已配置。
| 层级 | 当前状态 | 对外口径 |
|---|---|---|
| Compiler / Runtime / Event Store | 源码核心已发布并有聚焦测试 | 内核能力存在；不等于稳定公共 writer API |
cc team graph | inspect/diff/eval 已公开 | 只读已有 GraphRun，不创建、恢复或取消 |
| CLI Team/distributed-team/Cowork/Scheduler/App Server | 0.166.15 公共基线继续通过 cutover ledger 解析唯一 writer | entry/store/source evidence 不匹配或 legacy mutation 时失败闭合 |
| Formal collaboration quality gate | 0.166.21 承接 hermetic 文件工具热修复、Windows 隔离与 1.65 平台阈值；历史 P2-3 风险接受仍只属于原证据链 | 发布前门禁；不是用户 SLA；历史失败 run/豁免不能作为未来发布先例 |
| Desktop | Graph 执行 adapter、耐久历史与只读 Debugger 已进入源码 | 独立完成 packaged Electron、hydration、rollback 与 writer-cleanup 前不继承 CLI 发布结论 |
| Browser/IDE | claims、pilot、shadow/cutover 机制已有 | 不满足 hydration/rollback/writer-cleanup 时保持 non-authoritative 或 feature-gated |
未关闭：
- Desktop/Browser/IDE 的 authoritative 切换；
- loop/subgraph 完整生产执行语义；
- 逆依赖补偿执行器和全部 durable cut-point fault matrix；
- 真实 child Agent message/handoff 更长周期恢复与多次故障注入；
- 当前主线 formal quality matrix 的完整通过、聚合与后续发布绑定；
- IDE 原生 topology/timeline UI；Desktop 只读 Graph Debugger、HumanTask 决策、有界 App Server 工具审批卡以及 VS Code modal 审批已进入源码，但仍需真实宿主/final-SHA 资格验证。
17. 关键文件
| 路径 | 说明 |
|---|---|
packages/cli/src/lib/graph-kernel/compiler.js | GraphDefinition 编译、迁移与 digest |
packages/cli/src/lib/graph-kernel/runtime.js | GraphRun、调度、Effect、Message、Handoff、HumanTask |
packages/cli/src/lib/graph-kernel/event-store.js | append-only Graph event store |
packages/cli/src/lib/graph-kernel/trace-reducer.js | 投影、time travel、diff、blocked root |
packages/cli/src/lib/graph-kernel/eval.js | 指标、threshold 与 suite |
packages/cli/src/lib/graph-kernel/adapters.js | claims、shadow diff 与 cutover gate |
packages/cli/src/lib/graph-kernel/cutover-ledger.js | entry/store/writer authority 与耐久切换证据 |
packages/cli/src/lib/graph-kernel/authority.js | writer、lease、receipt 与恢复 authority |
packages/cli/src/lib/graph-kernel/trigger-adapter.js | Scheduler occurrence → GraphRun dispatch journal |
packages/cli/src/commands/graph.js | cc team graph 只读命令 |
packages/cli/src/lib/formal-quality-eval-runtime.js | formal quality hermetic home 与 provider binding |
packages/cli/scripts/graph-collaboration-quality-eval.mjs | control/candidate、三平台 evidence 与 threshold aggregate |
packages/cli/scripts/graph-collaboration-quality-runtime-preflight.mjs | Windows ACL 与安全运行时 preflight |
desktop-app-vue/src/renderer/components/graph/GraphRunDebugger.vue | Desktop topology/timeline/budget/trace/causality 只读调试器 |