docs: 完善协议、公共库与画布迁移注释 #13

2026-11-12T07:54:34Z

codex-bot commented

2026-11-12 07:54:34 +00:00

Foundry 协议适配器的注释需要明确各层职责，避免把响应解析、版本证明或回执摘要误认为完整验证。

改动范围：

canvas-entry/canvas-loader/browser-canvas-migration/canvas-migration/resource-loader：说明入口分流与导航结果采用、工作区级共享/独占锁、冻结迁移恢复和源映射校验范围、FIFO 资源任务与缓存引用生命周期。
应用库 api/workspace/board-directory/canvas-response/session-cookie/notifications/utils：补清请求错误与 headers 边界、并行读取和创建回调生命周期、目录引用复用、流超时清理与 Cookie 寿命约定。
src/lib/canvas-service/foundry.ts：说明账户绑定、资源读取预算与生成器清理、终结回执和冻结请求检查、编译与持久化分工、摘要前提、ACK 参与者替换及墓碑合并。仅调整注释。

验证：AST 比较确认可执行结构不变；文档服务、已生效恢复、模型流相关单测 27/27 通过；git diff --check 通过。

全项目注释任务仍在最终复核阶段，本 PR 交付 Foundry 与应用公共库的注释复核。等待用户手动合并。

应用请求/目录/会话/响应流相关单测 19/19 通过；七个应用库 AST 均无变化。

入口/迁移/资源加载相关单测 34/34 通过；五个模块 AST 均无变化，git diff --check 通过。真实多标签页 Web Locks 未在本轮运行。

Foundry 协议适配器的注释需要明确各层职责，避免把响应解析、版本证明或回执摘要误认为完整验证。改动范围： - canvas-entry/canvas-loader/browser-canvas-migration/canvas-migration/resource-loader：说明入口分流与导航结果采用、工作区级共享/独占锁、冻结迁移恢复和源映射校验范围、FIFO 资源任务与缓存引用生命周期。 - 应用库 api/workspace/board-directory/canvas-response/session-cookie/notifications/utils：补清请求错误与 headers 边界、并行读取和创建回调生命周期、目录引用复用、流超时清理与 Cookie 寿命约定。 - src/lib/canvas-service/foundry.ts：说明账户绑定、资源读取预算与生成器清理、终结回执和冻结请求检查、编译与持久化分工、摘要前提、ACK 参与者替换及墓碑合并。仅调整注释。验证：AST 比较确认可执行结构不变；文档服务、已生效恢复、模型流相关单测 27/27 通过；git diff --check 通过。全项目注释任务仍在最终复核阶段，本 PR 交付 Foundry 与应用公共库的注释复核。等待用户手动合并。应用请求/目录/会话/响应流相关单测 19/19 通过；七个应用库 AST 均无变化。入口/迁移/资源加载相关单测 34/34 通过；五个模块 AST 均无变化，git diff --check 通过。真实多标签页 Web Locks 未在本轮运行。

codex-bot added 1 commit 2026-11-12 07:54:36 +00:00

docs(service): clarify Foundry protocol validation boundaries f78618be2b

codex-bot added 1 commit 2026-11-12 07:57:38 +00:00

docs(app): explain request and directory lifecycle boundaries 84c50fe595

codex-bot changed title from ~~docs(service): 明确 Foundry 协议校验与合并边界~~ to docs: 完善 Foundry 与应用公共库的逻辑注释

2026-11-12 07:57:52 +00:00

codex-bot added 1 commit 2026-11-12 08:01:31 +00:00

docs(canvas): clarify entry and migration lifecycle 5803787910

codex-bot changed title from ~~docs: 完善 Foundry 与应用公共库的逻辑注释~~ to docs: 完善协议、公共库与画布迁移注释

2026-11-12 08:01:47 +00:00

Zayden-Jung merged commit b995e659a6 into main

2026-11-12 08:03:32 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Zayden-Jung/Endoleap#13