@farris/api-wiki-toolchain 1.0.0

package/dist/commands/adapt.d.ts

@@ -0,0 +1,8 @@
+export interface AdaptOptions {
+    type: 'rest' | 'grpc' | 'graphql' | 'async' | 'component' | 'sdk';
+    input: string;
+    outputDir: string;
+    asset: string;
+    version: string;
+}
+export declare function adaptCommand(options: AdaptOptions): Promise<void>;

package/dist/commands/generate-catalog.d.ts

@@ -0,0 +1,4 @@
+export interface GenerateCatalogOptions {
+    metaDir: string;
+}
+export declare function generateCatalogCommand(options: GenerateCatalogOptions): Promise<void>;

package/dist/commands/generate-docs.d.ts

@@ -0,0 +1,6 @@
+export interface GenerateDocsOptions {
+    dir: string;
+    layout?: string;
+    outputDir?: string;
+}
+export declare function generateDocsCommand(options: GenerateDocsOptions): Promise<void>;

package/dist/commands/merge.d.ts

@@ -0,0 +1,5 @@
+export interface MergeOptions {
+    srcDir: string;
+    destDir: string;
+}
+export declare function mergeCommand(options: MergeOptions): Promise<void>;

package/dist/commands/validate.d.ts

@@ -0,0 +1,4 @@
+export interface ValidateOptions {
+    dir: string;
+}
+export declare function validateCommand(options: ValidateOptions): Promise<void>;

package/dist/extractors/vue-extractor.d.ts

@@ -0,0 +1,6 @@
+export interface VueExtractorOptions {
+    tsconfigPath: string;
+    componentFiles: string[];
+    outputPath: string;
+}
+export declare function extractVueComponents(options: VueExtractorOptions): Promise<void>;

package/dist/generator/doc-generator.d.ts

@@ -0,0 +1,27 @@
+export interface LayoutColumn {
+    name: string;
+    key: string;
+    formatter?: 'code' | 'boolean' | 'badge' | 'link';
+}
+export interface LayoutSection {
+    id: string;
+    title: string;
+    type: 'text' | 'code_block' | 'table';
+    source?: string;
+    empty_placeholder?: string;
+    language?: string;
+    template?: string;
+    columns?: LayoutColumn[];
+}
+export interface LayoutDescriptor {
+    title?: string;
+    sections: LayoutSection[];
+}
+export declare class DocGenerator {
+    private layout;
+    constructor(layoutYaml?: string);
+    generate(data: any): string;
+    private renderTable;
+    private formatValue;
+    private getDefaultLayout;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './commands/adapt.js';
+export * from './commands/validate.js';
+export * from './commands/generate-docs.js';
+export * from './commands/merge.js';
+export * from './commands/generate-catalog.js';

package/dist/test-catalog/catalog.json

@@ -0,0 +1,17 @@
+{
+  "assets": [
+    {
+      "name": "asset-a",
+      "asset_type": "rest",
+      "title": "Asset A",
+      "summary": "",
+      "versions": [
+        "1.0.0"
+      ],
+      "visibility": "internal",
+      "coordinates": {},
+      "relations": []
+    }
+  ],
+  "last_updated": "2026-07-09T12:18:11.592Z"
+}

package/dist/test-catalog/dest-asset/1.1.0/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:my-asset/GET//test","kind":"endpoint","doc_md":"docs/test.md"}]

package/dist/test-catalog/dest-asset/catalog.json

@@ -0,0 +1,27 @@
+{
+  "urn": "asset:my-asset",
+  "type": "rest",
+  "name": "新标题",
+  "description": "这是一个非常长且符合至少三十个字规则的合格新描述，用于测试合并功能。",
+  "owner": "team-x",
+  "visibility": "internal",
+  "lifecycle": "production",
+  "versions": [
+    "1.0.0",
+    "1.1.0"
+  ],
+  "coordinates": [
+    {
+      "type": "github",
+      "version": "1.0.0",
+      "repo": "https://github.com/my-org/my-asset"
+    }
+  ],
+  "relations": [
+    {
+      "type": "uses",
+      "target": "sdk:java:cache-lib"
+    }
+  ],
+  "deployments": {}
+}

package/dist/test-catalog/dest-asset/versions.json

@@ -0,0 +1,17 @@
+{
+  "versions": [
+    "1.0.0",
+    "1.1.0"
+  ],
+  "latest": "1.1.0",
+  "assets": {
+    "1.0.0": {
+      "index.json": true,
+      "view.json": false
+    },
+    "1.1.0": {
+      "index.json": true,
+      "view.json": false
+    }
+  }
+}

package/dist/test-catalog/meta/asset-a/1.0.0/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:asset-a/GET//hello","name":"hello","title":"Hello Api","signature":"GET /hello","summary":"test"}]

package/dist/test-catalog/meta/asset-a/catalog.json

@@ -0,0 +1 @@
+{"urn":"asset:asset-a","type":"rest","name":"Asset A","description":"这是一个非常长且符合至少三十个字规则的合格新描述，用于测试合并功能。","owner":"team-a","visibility":"internal"}

package/dist/test-catalog/meta/asset-a/versions.json

@@ -0,0 +1 @@
+{"versions":["1.0.0"],"latest":"1.0.0","assets":{"1.0.0":{"index.json":true}}}

package/dist/test-catalog/meta/asset-b/catalog.json

@@ -0,0 +1 @@
+{"urn":"asset:asset-b","type":"sdk","name":"Asset B","description":"这是一个非常长且符合至少三十个字规则的合格新描述，用于测试合并功能。","owner":"team-b","visibility":"restricted"}

package/dist/test-catalog/meta/asset-b/versions.json

@@ -0,0 +1 @@
+{"versions":["1.0.0"],"latest":"1.0.0","assets":{"1.0.0":{"index.json":true}}}

package/dist/test-catalog/meta/catalog.json

@@ -0,0 +1,16 @@
+{
+  "assets": [
+    {
+      "urn": "asset:asset-a",
+      "type": "rest",
+      "name": "Asset A",
+      "description": "这是一个非常长且符合至少三十个字规则的合格新描述，用于测试合并功能。",
+      "owner": "team-a",
+      "visibility": "internal",
+      "lifecycle": "production",
+      "latest": "1.0.0",
+      "dir": "asset-a"
+    }
+  ],
+  "updated_at": "2026-07-11T03:15:12.419Z"
+}

package/dist/test-catalog/meta/search-index/asset-a.json

@@ -0,0 +1,12 @@
+[
+  {
+    "urn": "rest:asset-a/GET//hello",
+    "name": "hello",
+    "title": "Hello Api",
+    "signature": "GET /hello",
+    "summary": "test",
+    "tags": [],
+    "deprecated": false,
+    "version": "1.0.0"
+  }
+]

package/dist/test-catalog/search-index/asset-a.json

@@ -0,0 +1,12 @@
+[
+  {
+    "urn": "rest:asset-a/GET//hello",
+    "name": "hello",
+    "title": "Hello Api",
+    "signature": "GET /hello",
+    "summary": "test",
+    "tags": [],
+    "deprecated": false,
+    "version": "1.0.0"
+  }
+]

package/dist/test-catalog/src-asset/catalog.json

@@ -0,0 +1 @@
+{"urn":"asset:my-asset","type":"rest","versions":["1.1.0"],"name":"新标题","description":"这是一个非常长且符合至少三十个字规则的合格新描述，用于测试合并功能。","owner":"team-x","visibility":"internal"}

package/dist/test-catalog/src-asset/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:my-asset/GET//test","kind":"endpoint","doc_md":"docs/test.md"}]

package/dist/test-output/comp-adapted/index.json

@@ -0,0 +1,21 @@
+[
+  {
+    "urn": "component:my-comp-lib/button",
+    "asset": "my-comp-lib",
+    "asset_type": "component",
+    "kind": "component",
+    "name": "button",
+    "title": "button",
+    "signature": "<button />",
+    "summary": "",
+    "version": "1.0.0",
+    "deprecated": false,
+    "pointer": "#/components/button",
+    "doc_md": "docs/button.md",
+    "provenance": {
+      "tier": "tool",
+      "tool": "vue-component-meta",
+      "confidence": "high"
+    }
+  }
+]

package/dist/test-output/comp-adapted/view.json

@@ -0,0 +1,34 @@
+{
+  "component": "button",
+  "framework": "vue",
+  "version": "1.0.0",
+  "urn": "component:my-comp-lib/button",
+  "overview": "## button\n前端 Vue 组件。",
+  "examples": [],
+  "props": [
+    {
+      "name": "disabled",
+      "type": "boolean",
+      "default": "false",
+      "required": false,
+      "description": "是否禁用",
+      "deprecated": false
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "payload": "(e: MouseEvent) => void",
+      "description": "点击触发"
+    }
+  ],
+  "slots": [
+    {
+      "name": "default",
+      "scoped_props": "any",
+      "description": "默认内容"
+    }
+  ],
+  "methods": [],
+  "css_vars": []
+}

package/dist/test-output/comp-native.json

@@ -0,0 +1 @@
+{"button":{"filePath":"components/button/button.tsx","components":{"default":{"props":[{"name":"disabled","type":"boolean","default":"false","required":false,"description":"是否禁用"}],"events":[{"name":"click","type":"(e: MouseEvent) => void","description":"点击触发"}],"slots":[{"name":"default","type":"any","description":"默认内容"}],"exposed":[]}}}}

package/dist/test-output/rest-adapted/index.json

@@ -0,0 +1,22 @@
+[
+  {
+    "urn": "rest:my-rest-service/GET//users/{id}",
+    "asset": "my-rest-service",
+    "asset_type": "rest",
+    "kind": "endpoint",
+    "name": "getUserById",
+    "title": "获取用户",
+    "signature": "GET /users/{id}",
+    "summary": "根据 ID 获取用户详情",
+    "tags": [],
+    "version": "1.0.0",
+    "deprecated": false,
+    "pointer": "#/paths/~1users~1{id}/get",
+    "doc_md": "docs/get-users-id.md",
+    "provenance": {
+      "tier": "tool",
+      "tool": "openapi-spec@3.0.1",
+      "confidence": "high"
+    }
+  }
+]

package/dist/test-output/rest-native.json

@@ -0,0 +1 @@
+{"openapi":"3.0.1","paths":{"/users/{id}":{"get":{"summary":"获取用户","description":"根据 ID 获取用户详情","operationId":"getUserById","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"成功"}}}}}}

package/dist/test-output/sdk-adapted/index.json

@@ -0,0 +1,40 @@
+[
+  {
+    "urn": "sdk:java:my-sdk-lib/com.inspures.caf.CacheService",
+    "asset": "my-sdk-lib",
+    "asset_type": "sdk",
+    "kind": "class",
+    "name": "CacheService",
+    "title": "缓存服务接口",
+    "signature": "public interface CacheService",
+    "summary": "缓存服务接口",
+    "version": "1.0.0",
+    "deprecated": false,
+    "pointer": "#/classes/com.inspures.caf.CacheService",
+    "doc_md": "docs/com.inspures.caf.CacheService.md",
+    "provenance": {
+      "tier": "tool",
+      "tool": "javadoc-doclet",
+      "confidence": "high"
+    }
+  },
+  {
+    "urn": "sdk:java:my-sdk-lib/com.inspures.caf.CacheService#get(java.lang.String)",
+    "asset": "my-sdk-lib",
+    "asset_type": "sdk",
+    "kind": "method",
+    "name": "get",
+    "title": "根据 Key 获取缓存",
+    "signature": "String get(String key)",
+    "summary": "根据 Key 获取缓存",
+    "version": "1.0.0",
+    "deprecated": false,
+    "pointer": "#/classes/com.inspures.caf.CacheService/methods/get(java.lang.String)",
+    "doc_md": "docs/com.inspures.caf.CacheService.md#get",
+    "provenance": {
+      "tier": "tool",
+      "tool": "javadoc-doclet",
+      "confidence": "high"
+    }
+  }
+]

package/dist/test-output/sdk-native.json

@@ -0,0 +1 @@
+{"classes":{"com.inspures.caf.CacheService":{"name":"CacheService","fullName":"com.inspures.caf.CacheService","kind":"interface","signature":"public interface CacheService","summary":"缓存服务接口","description":"提供基础的缓存读写能力","methods":{"get(java.lang.String)":{"name":"get","signature":"String get(String key)","returnType":"java.lang.String","returnDescription":"缓存的值","summary":"根据 Key 获取缓存","description":"根据 Key 获取缓存，如果没有则返回 null","parameters":[{"name":"key","type":"java.lang.String","description":"缓存键"}],"isDeprecated":false}}}}}

package/dist/test-validate/1.0.0/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:my-asset/GET//ok-path","asset":"my-asset","asset_type":"rest","kind":"endpoint","name":"ok","title":"Ok Title","signature":"GET /ok-path","summary":"这是一个非常长且符合至少三十个字规则的合格摘要说明，以便于大模型检索。","version":"1.0.0","deprecated":false,"pointer":"#/paths/~1ok-path/get","doc_md":"docs/ok.md","reviewed_by":"auditor","provenance":{"tier":"tool","tool":"test","confidence":"high"}}]

package/dist/test-validate/1.0.0-SNAPSHOT/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:my-asset/GET//short","asset":"my-asset","asset_type":"rest","kind":"endpoint","name":"short","title":"Short Title","signature":"GET /short","summary":"太短了","version":"1.0.0","deprecated":false,"pointer":"#/paths/~1short/get","doc_md":"docs/short.md","reviewed_by":"auditor","provenance":{"tier":"tool","tool":"test","confidence":"high"}}]

package/dist/test-validate/1.0.0-strict/index.json

@@ -0,0 +1 @@
+[{"urn":"rest:my-asset/GET//short","asset":"my-asset","asset_type":"rest","kind":"endpoint","name":"short","title":"Short Title","signature":"GET /short","summary":"太短了","version":"1.0.0","deprecated":false,"pointer":"#/paths/~1short/get","doc_md":"docs/short.md","reviewed_by":"auditor","provenance":{"tier":"tool","tool":"test","confidence":"high"}}]

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@farris/api-wiki-toolchain",
+  "version": "1.0.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "resources"
+  ],
+  "bin": {
+    "aw-cli": "./dist/bin/aw-cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "esbuild src/bin/aw-cli.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/bin/aw-cli.js && tsc --emitDeclarationOnly && mvn -f ../javadoc-doclet/pom.xml clean package && node -e \"const fs = require('fs-extra'); fs.ensureDirSync('resources'); fs.copySync('../javadoc-doclet/target/javadoc-doclet-1.0.0.jar', 'resources/javadoc-doclet.jar');\"",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@farris/api-wiki-contract-schema": "workspace:*",
+    "ajv": "^8.17.1",
+    "commander": "^12.1.0",
+    "ejs": "^3.1.10",
+    "fs-extra": "^11.3.0",
+    "js-yaml": "^4.1.0",
+    "vue": "^3.4.21",
+    "vue-component-meta": "^1.8.27"
+  },
+  "devDependencies": {
+    "@types/ejs": "^3.1.5",
+    "@types/fs-extra": "^11.0.4",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^18.19.121",
+    "esbuild": "^0.24.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.8"
+  }
+}