@gencode/web 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @gencode/web
+
+## 0.0.1
+
+### Patch Changes
+
+- Establish the initial changelog baseline for the current package version.

package/README.md

@@ -0,0 +1,65 @@
+# @gencode/web
+
+## 包定位
+
+`@gencode/web` 负责 AIMax 的 Web 服务集成边界。
+它在架构上的角色，是模拟爱码Max后台这一侧的服务行为，同时严格尊重 CLI 进程边界。
+
+## 负责内容
+
+这个包适合承载：
+- 面向 Web 的集成行为
+- 模拟爱码Max后台的服务侧逻辑
+- 在 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 等对外接口应优先使用显式共享契约
+
+## 验证
+
+本包当前实现面较小，可先使用工作区级验证：
+
+```bash
+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`

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@gencode/web",
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "@gencode/console": "0.0.16",
+    "@gencode/shared": "0.0.20"
+  },
+  "devDependencies": {},
+  "scripts": {
+    "build": "node -e \"process.exit(0)\"",
+    "test": "node -e \"process.exit(0)\"",
+    "typecheck": "node -e \"process.exit(0)\""
+  }
+}