@gencode/web

包定位

@gencode/web 负责 Web 服务集成边界。 它在架构上的角色，是模拟外部后台服务这一侧的行为，同时严格尊重 CLI 进程边界。

负责内容

这个包适合承载：

• 面向 Web 的集成行为
• 模拟外部后台服务侧逻辑
• 在 Web 边界接收和协调 CLI 驱动产生的输出
• 处于 agent 领域层之外的 API 与服务集成逻辑

不负责内容

这个包不应直接承担：

• agent 领域执行内部逻辑
• 对 @gencode/agents 的直接引入
• 替代 CLI 的执行逻辑
• 本应放在 @gencode/shared 的共享协议重复定义

按当前架构约束，本包应通过 CLI 调用能力，而不是绕过 CLI 直接访问 agent 层。

当前源码入口

阅读本包时，建议先看：

• src/index.ts —— 当前包入口

本包当前实现仍较薄，这是正常的。即使实现表面很小，边界也必须先定义清楚。

与其他包的关系

• @gencode/web 应通过 @gencode/cli 使用 agent 能力
• @gencode/shared 应提供可复用的对外协议结构
• @gencode/agents 处于 CLI 边界之后，不应在这里被直接引入

相关工作区包：

• source/packages/console 当前是并行存在的 UI / 控制台包
• 在专门的架构收敛任务完成前，不要把 console 与 web 混为一体

开发说明

当你扩展本包时：

• 始终保留 CLI 进程边界
• 保持服务侧集成关注点与 agent 领域所有权分离
• 不要为了省事直接把 Web 集成耦合到 @gencode/agents
• callback、websocket 等对外接口应优先使用显式共享契约

验证

本包当前实现面较小，可先使用工作区级验证：

pnpm -C source typecheck
pnpm -C source test

相关规格文档

• ../../../specs/system-overview.md
• ../../../specs/architecture-boundaries.md
• ../../../specs/repo-map.md
• ../../../specs/web-module-plan.md