dsh-doc-preview 0.1.2 → 0.1.3

package/README.md

@@ -40,6 +40,11 @@ http://<host>/docs/<工作区id>/<相对路径>.md -> 渲染该工作区内的
   传可选参数 `rel` 时，`docs` 列出该相对目录下 `.md/.markdown/.html` 的链接；不传则只给工作区根链接。
 - **优雅降级**：缺 `cwd` / 当前 cwd 未登记 / 无 registry 时不抛错，返回 `{ workspaceUrl: null, note: '…' }`。
 - **相对路径**：返回 `/docs/...` 相对路径（前缀由宿主 Web 提供）；仅 Web 形态适用。
+- **输出 schema 约束**：`doc_preview_links` 通过 `ctx.tools.register` 以**原始 ToolDefinition** 注册，其
+  `output.schema` 必须使用 dsh 的强制 JSON-Schema 子集（`object/array/string/number/integer/boolean/null`），
+  **不能**写作者 DSL 的 `type: 'json'`（那只在 `defineTool()` 里合法，会先编译成 annotation-only 节点；
+  原样传给 `register` 会触发 `assertSupportedJsonSchema` 报错、导致宿主启动失败）。这里用的是 annotation-only
+  schema（不写 `type` = 任意 JSON），语义与 `json` 节点编译后完全一致。
 
 ## 安装
 
@@ -66,6 +71,7 @@ lib/index.js          # 构建产物（Loader 实际加载）
 cordis.patch.yml      # 插入 doc-preview 行，inject webServer + tools + workspaceRegistry
 tests/drive-route.mjs # 路由自测（mock workspaceRegistry）
 tests/tools-test.mjs  # doc_preview_links 工具自测（mock registry + exec.agent）
+tests/schema-test.mjs # 输出 schema 防回归自测（拒绝非法 type:'json'）
 tests/render-test.mjs # md 渲染自测
 tests/logic-test.mjs  # 渲染边界 + 穿越防护自测
 README.md / ENABLE.md
@@ -74,9 +80,10 @@ README.md / ENABLE.md
 ## 自测
 
 ```sh
-npm test                                          # build + 全部四套自测
+npm test                                          # build + 全部五套自测
 node tests/drive-route.mjs                        # 工作区映射/隔离/404
 node tests/tools-test.mjs                         # doc_preview_links 工具
+node tests/schema-test.mjs                        # 输出 schema 防回归
 tsx --tsconfig tsconfig.json tests/render-test.mjs
 tsx --tsconfig tsconfig.json tests/logic-test.mjs
 ```

package/lib/index.js

@@ -316,8 +316,15 @@ function createDocPreviewLinks(wsRegistry) {
                 optional: true,
             },
         },
+        // NOTE: the output schema must use the enforced JSON-Schema subset
+        // (object/array/string/number/integer/boolean/null) — NOT the author DSL
+        // `type: 'json'`. `doc_preview_links` is registered as a raw ToolDefinition
+        // through ctx.tools.register, which skips defineTool()'s DSL→subset compile;
+        // a verbatim `type: 'json'` would fail assertSupportedJsonSchema and crash
+        // host startup. An annotation-only schema (no `type`) = unconstrained JSON,
+        // the exact post-compile meaning of the DSL `json` node.
         output: {
-            schema: { type: 'json' },
+            schema: { description: 'doc_preview_links result: workspace, workspaceUrl, and optional docs list' },
             render: renderJson,
         },
         async execute(args, exec) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-doc-preview",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A dsh bundle plugin: preview local Markdown/HTML documents per workspace in the Web GUI via a /docs route on ctx.webServer + ctx.workspaceRegistry.",
   "type": "module",
   "main": "lib/index.js",
@@ -64,6 +64,7 @@
     "logic:test": "tsx --tsconfig ./tsconfig.json tests/logic-test.mjs",
     "route:test": "node tests/drive-route.mjs",
     "tools:test": "node tests/tools-test.mjs",
-    "test": "node scripts/build.mjs && node tests/drive-route.mjs && node tests/tools-test.mjs && tsx --tsconfig ./tsconfig.json tests/render-test.mjs && tsx --tsconfig ./tsconfig.json tests/logic-test.mjs"
+    "schema:test": "node tests/schema-test.mjs",
+    "test": "node scripts/build.mjs && node tests/drive-route.mjs && node tests/tools-test.mjs && node tests/schema-test.mjs && tsx --tsconfig ./tsconfig.json tests/render-test.mjs && tsx --tsconfig ./tsconfig.json tests/logic-test.mjs"
   }
 }