@tbox.cn/app-cli 0.1.2 → 0.4.1

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@tbox.cn/app-cli",
-  "version": "0.1.2",
+  "version": "0.4.1",
   "type": "module",
-  "description": "tbox-app CLI：create / module add|remove|list|sync|diff|doctor|update|publish（纯函数核心 + commander 薄壳）。",
+  "description": "tbox-app CLI：create / module add|remove|list|sync|diff|doctor|update|publish / start|stop|eval 智能体评测（纯函数核心 + commander 薄壳）。",
   "bin": {
     "tbox-app": "dist/index.js"
   },
@@ -14,6 +14,7 @@
   },
   "files": [
     "dist",
+    "starter",
     "README.md",
     "LICENSE"
   ],
@@ -21,17 +22,19 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "commander": "^12.1.0",
-    "diff": "^7.0.0",
-    "typescript": "^5.7.0",
-    "zod": "^3.24.0"
+    "commander": "12.1.0",
+    "diff": "7.0.0",
+    "yaml": "2.9.0",
+    "typescript": "5.9.3",
+    "zod": "3.25.76",
+    "@tbox.cn/app-toolkit": "0.1.0"
   },
   "devDependencies": {
-    "@types/diff": "^7.0.0",
-    "@types/node": "^24.0.0",
-    "tsup": "^8.0.0",
-    "tsx": "^4.19.0",
-    "vitest": "^4.1.4"
+    "@types/diff": "7.0.2",
+    "@types/node": "24.13.3",
+    "tsup": "8.5.1",
+    "vitest": "4.1.10",
+    "@tbox.cn/app-contracts": "0.9.0"
   },
   "license": "MIT",
   "publishConfig": {

package/starter/agent-mall.md

@@ -0,0 +1,56 @@
+# tbox starter: agent-mall
+
+这是商圈 AI Agent 应用的启动指南，适合构建商场导购、会员、停车、优惠和支付宝活动等商圈能力。starter 只负责告诉 agent 如何选择应用模板和模块；它不是应用模板，不能作为 `tbox-app create --source` 的源。
+
+## 初始化
+
+CLI 免安装：指南命令以 `tbox-app` 短名书写；任意 `tbox-app <cmd>` 均可换成 `npx --yes @tbox.cn/app-cli <cmd>` 直接运行（`--yes` 跳过 npx 首次安装确认）。
+
+在沙箱 `/workspace` 中直接初始化当前目录，不要把应用生成到新的子目录：
+
+```sh
+tbox-app create . --name my-mall --source @tbox.cn/app-template-agent-mall
+pnpm install
+```
+
+`--name` 会写入根 `package.json.name`。初始化会用应用模板的 `AGENTS.md` 覆盖 starter 的 `AGENTS.md`，但会保留 `.git`、`.agents/skills` 中的非冲突内容以及其他未被模板声明的文件。
+
+## Mall 模板与模块
+
+应用模板：`@tbox.cn/app-template-agent-mall`。模板提供商圈主屏、主题、商圈 scope 和 mock-only 默认配置。
+
+可按需添加以下业务模块：
+
+| 包 | 能力 |
+|---|---|
+| `@tbox.cn/app-module-shopping-guide` | 商户、商品、目录、导购和知识问答 |
+| `@tbox.cn/app-module-member` | 会员信息、积分、会员卡和入会 |
+| `@tbox.cn/app-module-parking` | 停车费用、车辆、支付、记录和开票 |
+| `@tbox.cn/app-module-promotion` | 活动、优惠、券查询、领取和优惠测算 |
+| `@tbox.cn/app-module-alipay-activity` | 支付宝碰一下活动查询与展示 |
+
+安装示例：
+
+```sh
+tbox-app module add @tbox.cn/app-module-shopping-guide --mode codegen --source @tbox.cn/app-module-shopping-guide
+tbox-app module add @tbox.cn/app-module-member --mode codegen --source @tbox.cn/app-module-member
+pnpm install
+tbox-app module doctor
+```
+
+业务模块依赖的 `@tbox.cn/app-contracts-mall` 由 CLI 按模块声明自动处理。provider 是独立的集成包，不要从业务模块中直接 import；真实接入使用 provider 包和 `tbox-app provider bind`。
+
+## 常用流程
+
+```sh
+pnpm install
+pnpm dev
+```
+
+需要重新查看本指南时运行：
+
+```sh
+tbox-app starter --type agent-mall
+```
+
+模块形态、provider、凭证和真实环境配置以生成应用中的 `AGENTS.md`、`ENV.md` 与 CLI 输出为准。凭证只使用 `credentialRef` 或平台环境注入，不写入应用源码。

package/starter/agent-support.md

@@ -0,0 +1,38 @@
+# tbox starter: agent-support
+
+这是客服支持 AI Agent 的启动指南，适合搭建面向客户答疑、知识检索、澄清确认和人工承接准备的应用。starter 只负责告诉 agent 如何选择应用模板；它不是应用模板，不能作为 `tbox-app create --source` 的源。
+
+## 初始化
+
+CLI 免安装：指南命令以 `tbox-app` 短名书写；任意 `tbox-app <cmd>` 均可换成 `npx --yes @tbox.cn/app-cli <cmd>` 直接运行（`--yes` 跳过 npx 首次安装确认）。
+
+在沙箱 `/workspace` 中直接初始化当前目录，不要把应用生成到新的子目录。Support 模板不发 npm——create 源为 tbox-app 仓本地目录，路径须 cwd 可达（绝对路径或正确的相对路径）：
+
+```sh
+tbox-app create . --name my-support --source <tbox-app 仓>/templates/template-agent-support
+pnpm install
+```
+
+`--name` 会写入根 `package.json.name`。初始化会用应用模板的 `AGENTS.md` 覆盖 starter 的 `AGENTS.md`，但会保留 `.git`、`.agents/skills` 中的非冲突内容以及其他未被模板声明的文件。
+
+## Support 模板
+
+应用模板：`@tbox.cn/app-template-agent-support`（不发 npm——create 源为 tbox-app 仓本地目录 `templates/template-agent-support`）。模板提供浏览器与支付宝小程序 web-view 共用的客服对话壳，内置 support 私有契约、`module-support-core` 骨架和客服 FAQ skill。
+
+模板为答疑、知识检索、澄清确认和受策略约束的读写动作预留统一 support 契约；真实写动作必须经过持久 plan/binding、幂等和审计或 Provider 权威收口。人工承接只保留可替换的 prepare 入口，一期不接入实际人工服务。不要把 mall 业务模块、`contracts-mall` 或第三方 provider 直接加入客服应用，也不要在客户端暴露内部工具调用、调试信息或原始错误。
+
+常用流程：
+
+```sh
+pnpm install
+tbox-app module doctor
+pnpm dev
+```
+
+需要重新查看本指南时运行：
+
+```sh
+tbox-app starter --type agent-support
+```
+
+模块形态、装配锚点、鉴权和凭证规则以生成应用中的 `AGENTS.md` 与 `ENV.md` 为准；凭证只使用 `credentialRef` 或平台环境注入，不写入应用源码。

package/starter/agent.md

@@ -0,0 +1,46 @@
+# tbox starter: agent
+
+这是通用 AI Agent 应用的启动指南，适合从零搭建不限定业务领域的智能体应用。starter 只负责告诉 agent 如何选择应用模板和模块；它不是应用模板，不能作为 `tbox-app create --source` 的源。
+
+## 初始化
+
+CLI 免安装：指南命令以 `tbox-app` 短名书写；任意 `tbox-app <cmd>` 均可换成 `npx --yes @tbox.cn/app-cli <cmd>` 直接运行（`--yes` 跳过 npx 首次安装确认）。
+
+在沙箱 `/workspace` 中直接初始化当前目录，不要把应用生成到新的子目录：
+
+```sh
+tbox-app create . --name my-agent --source @tbox.cn/app-template-agent
+pnpm install
+```
+
+`--name` 会写入根 `package.json.name`。初始化会用应用模板的 `AGENTS.md` 覆盖 starter 的 `AGENTS.md`，但会保留 `.git`、`.agents/skills` 中的非冲突内容以及其他未被模板声明的文件。
+
+## Base 模板
+
+应用模板：`@tbox.cn/app-template-agent`。
+
+模板提供浏览器与支付宝小程序 web-view 共用的 Agent 应用壳，包含 server/client、配置链、模块装配和一个内置的 `module-weather` 示例模块。
+
+模块安装使用 codegen 模式。registry 场景必须同时传包名和 `--source`：
+
+```sh
+tbox-app module add @tbox.cn/app-module-shopping-guide --mode codegen --source @tbox.cn/app-module-shopping-guide
+```
+
+商圈业务模块应优先使用 `agent-mall` starter 和 mall 模板；base 应用默认只使用模板内置能力或通用模块。
+
+## 常用流程
+
+```sh
+pnpm install
+tbox-app module doctor
+pnpm dev
+```
+
+修改模块后重新执行 `pnpm install` 和 `tbox-app module doctor`。需要重新查看本指南时运行：
+
+```sh
+tbox-app starter --type agent
+```
+
+模块形态、装配锚点和 doctor 规则以生成应用中的 `AGENTS.md` 与 CLI 输出为准；不要手写平台包或复制 SDK 源码。