@faapi/schema 7.2.0 → 7.3.0

package/CHANGELOG.md

@@ -0,0 +1,283 @@
+# @faapi/schema
+
+## 7.3.0
+
+## 7.2.0
+
+## 7.1.0
+
+## 7.0.0
+
+### Patch Changes
+
+- Updated dependencies [6e70a55]
+  - @faapi/faapi@7.0.0
+  - @faapi/mcp@7.0.0
+
+## 6.51.0
+
+## 6.50.0
+
+## 6.49.0
+
+## 6.48.0
+
+## 6.47.0
+
+## 6.46.0
+
+## 6.45.0
+
+## 6.44.0
+
+## 6.43.0
+
+## 6.42.0
+
+## 6.41.0
+
+## 6.40.0
+
+## 6.39.0
+
+## 6.38.0
+
+## 6.37.0
+
+## 6.36.0
+
+## 6.35.0
+
+## 6.34.0
+
+## 6.33.0
+
+## 6.32.0
+
+## 6.31.0
+
+## 6.30.0
+
+## 6.29.0
+
+## 6.28.0
+
+## 6.27.0
+
+## 6.26.0
+
+## 6.25.0
+
+## 6.24.0
+
+## 6.23.0
+
+## 6.22.0
+
+## 6.21.1
+
+## 6.21.0
+
+## 6.20.0
+
+## 6.19.0
+
+## 6.18.1
+
+## 6.18.0
+
+## 6.17.0
+
+## 6.16.0
+
+## 6.15.0
+
+## 6.14.0
+
+## 6.13.0
+
+## 6.12.0
+
+## 6.11.0
+
+## 6.10.1
+
+## 6.10.0
+
+## 6.9.1
+
+## 6.9.0
+
+## 6.8.0
+
+## 6.7.0
+
+## 6.6.0
+
+## 6.5.0
+
+## 6.4.1
+
+## 6.4.0
+
+## 6.3.0
+
+## 6.2.0
+
+## 6.1.0
+
+## 6.0.0
+
+### Patch Changes
+
+- Updated dependencies [c5a6775]
+  - @faapi/faapi@6.0.0
+  - @faapi/mcp@6.0.0
+
+## 5.4.0
+
+## 5.3.0
+
+## 5.2.0
+
+## 5.1.0
+
+## 5.0.1
+
+### Patch Changes
+
+- 版本线修复：此前 5.0.0 被误发布到 npm（其中 `@faapi/faapi` 与 `@faapi/mcp` 因依赖关系无法 unpublish，该版本号已作废不可复用），版本线跳过 5.0.0 对齐到 5.0.1。本版本功能内容与 4.5.0 完全一致（含移除 `config.agent` 的 `defaultAgent` / `defaultLlm` 配置——`agent.run/stream` 改为每次调用显式传 `options.agent` 与 `options.model` / `options.provider`）。
+
+## 4.5.0
+
+## 4.4.0
+
+## 4.3.0
+
+## 4.2.1
+
+## 4.2.0
+
+## 4.1.0
+
+## 4.0.0
+
+### Patch Changes
+
+- 06b1f05: 修复 resource 批量重建的 N+1 广播风暴：
+
+  - `mcpServer` 的 `removeResource` / `removeResourceTemplate` 新增 `{ silent: true }` 选项——跳过 `notifications/resources/list_changed` 逐次广播
+  - `@faapi/schema` 的 schemaServer 资源重建（先清 N 个旧 resource 再注册）改为静默删除、末尾统一广播一次——路由多的项目此前每次 dev reload 会向所有 SSE session 发送 N+1 次相同通知
+
+- Updated dependencies [0337482]
+- Updated dependencies [8947f46]
+- Updated dependencies [eadf440]
+- Updated dependencies
+- Updated dependencies [981c99f]
+- Updated dependencies [f60d137]
+- Updated dependencies [f60d137]
+- Updated dependencies [d822718]
+- Updated dependencies [c18c62e]
+- Updated dependencies [13c6297]
+- Updated dependencies [6f2903f]
+- Updated dependencies [b31a442]
+- Updated dependencies [3c12dc6]
+- Updated dependencies [4617c07]
+- Updated dependencies [5d95fdd]
+- Updated dependencies [9d5865d]
+- Updated dependencies [06b1f05]
+- Updated dependencies [a0cb30c]
+  - @faapi/faapi@4.0.0
+  - @faapi/mcp@4.0.0
+
+## 3.3.0
+
+## 3.2.1
+
+## 3.2.0
+
+## 3.1.0
+
+## 3.0.0
+
+### Patch Changes
+
+- Updated dependencies [1d54523]
+- Updated dependencies [1d54523]
+- Updated dependencies [49d7ac9]
+  - @faapi/faapi@3.0.0
+  - @faapi/mcp@3.0.0
+
+## 2.0.1
+
+## 2.0.0
+
+### Patch Changes
+
+- Updated dependencies [1258e39]
+  - @faapi/faapi@2.0.0
+  - @faapi/mcp@2.0.0
+
+## 1.5.0
+
+## 1.4.0
+
+## 1.3.1
+
+## 1.3.0
+
+### Minor Changes
+
+- 新增统一响应包装能力：ctx.ok / ctx.fail 便捷方法 + handler 返回值自动包裹
+
+  - 新增 `ctx.ok(data)`：显式包裹成功响应，等价于 `return data`（框架自动包裹）
+  - 新增 `ctx.fail({ status?, code?, message })`：返回错误响应，status 和 code 均可独立省略（无推导关系）
+  - 新增 `config.response` 配置（`ok` / `fail` 可选）：自定义成功/错误响应包装结构
+  - `invokeHandler.wrapResult` 自动包裹：handler return 非 Response 的值（含 null/undefined）时用 `config.response.ok`（默认 `(data) => ({ data })`）包裹
+  - `Response` 对象原样透传，不被包裹（`ctx.ok`/`ctx.fail`/`ctx.json` 等返回的 Response 均属此类）
+
+  **Breaking**：handler `return data` 的默认响应格式从原样返回变为 `{ data }` 包裹。如需原样返回，用 `return ctx.json(data)`。
+
+## 1.2.1
+
+## 1.2.0
+
+## 1.1.1
+
+### Patch Changes
+
+- 改进发布流程：通过 tag 区分 canary 和 stable 发布
+
+## 1.1.0
+
+### Patch Changes
+
+- Updated dependencies [853a175]
+  - @faapi/faapi@1.1.0
+  - @faapi/mcp@1.1.0
+
+## 1.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @faapi/faapi@1.0.2
+  - @faapi/mcp@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @faapi/faapi@1.0.1
+  - @faapi/mcp@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- 首次发布 @faapi/schema——基于 @faapi/mcp 实现，通过 MCP 协议（Streamable HTTP transport）暴露路由 schema 给 AI 助手。插件在 `/mcp` 路径挂载端点，AI 助手通过 HTTP 连接 `http://localhost:3000/mcp`。通过 `ctx.wrapHandler` 拦截 `/mcp` 路径，与 faapi 路由系统原生集成。`createSchemaServer` 通过 `getRoutes` getter 替代路由快照，dev 热替换后 schema 自动刷新。提供三个 tool：`list_routes`（列出所有路由）、`get_route_schema`（获取单个路由详细 schema）、`get_api_schema`（获取完整 API schema，类似 OpenAPI）。在 `faapi.config.ts` 的 `plugins` 字段声明即可加载。
+
+### Minor Changes
+
+- 删除冗余 `dependencies.zod`（不直接 import），改为 `peerDependencies` 保持一致。业务方需在项目 `package.json` 显式安装 `zod@^4`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faapi/schema",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "description": "Schema introspection for faapi — expose API schema to AI assistants via MCP",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,7 +12,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=24"
@@ -25,14 +26,14 @@
     "typescript": "^5.7.0",
     "vitest": "^5.0.3",
     "zod": "^4.4.3",
-    "@faapi/faapi": "7.2.0",
-    "@faapi/mcp": "7.2.0"
+    "@faapi/faapi": "7.3.0",
+    "@faapi/mcp": "7.3.0"
   },
   "peerDependencies": {
     "typescript": ">=5.7.0",
     "zod": "^4.4.3",
-    "@faapi/faapi": "^7.2.0",
-    "@faapi/mcp": "^7.2.0"
+    "@faapi/faapi": "^7.3.0",
+    "@faapi/mcp": "^7.3.0"
   },
   "peerDependenciesMeta": {
     "typescript": {