spectra-cli 4.1.1 → 4.3.0

package/plugins/demo-kb-en/kb/doc-graph.json

@@ -0,0 +1,113 @@
+{
+  "schema_version": "1.0",
+  "source": "directory",
+  "built_at": "2026-06-16T06:31:36.714Z",
+  "sdk_version": "4.6.0",
+  "nodes": [
+    {
+      "id": "app-hono-object.md",
+      "title": "App - Hono",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/app-hono-object.md"
+    },
+    {
+      "id": "bearer-auth-middleware.md",
+      "title": "Bearer Auth Middleware",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/bearer-auth-middleware.md"
+    },
+    {
+      "id": "best-practices.md",
+      "title": "Best Practices",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/best-practices.md"
+    },
+    {
+      "id": "context.md",
+      "title": "Context",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/context.md"
+    },
+    {
+      "id": "cors-middleware.md",
+      "title": "CORS Middleware",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/cors-middleware.md"
+    },
+    {
+      "id": "exception-error-handling.md",
+      "title": "HTTPException",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/exception-error-handling.md"
+    },
+    {
+      "id": "getting-started.md",
+      "title": "Getting Started",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/getting-started.md"
+    },
+    {
+      "id": "jwt-helper.md",
+      "title": "JWT Authentication Helper",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/jwt-helper.md"
+    },
+    {
+      "id": "middleware-concept.md",
+      "title": "Middleware",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/middleware-concept.md"
+    },
+    {
+      "id": "request.md",
+      "title": "HonoRequest",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/request.md"
+    },
+    {
+      "id": "routing.md",
+      "title": "Routing",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/routing.md"
+    },
+    {
+      "id": "testing.md",
+      "title": "Testing",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/testing.md"
+    },
+    {
+      "id": "validation.md",
+      "title": "Validation",
+      "summary": null,
+      "tags": [],
+      "lang": "en",
+      "source_url": "/Users/connorlu/Desktop/.workspace2.nosync/cc-plugin-market/.claude/worktrees/frosty-jepsen-b346c5/plugins/demo-kb-en/source-docs/validation.md"
+    }
+  ],
+  "edges": []
+}

package/plugins/demo-kb-zh/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "demo-kb-zh",
+  "version": "0.1.0",
+  "description": "中文 SDK 知识库 demo fixture（测试用途，验证 scaffold-kb 构建与 KB MCP 分发路径）。基于某公开开源 SDK 的公开中文文档构建。",
+  "author": {
+    "name": "scaffold-kb-mvp-test"
+  },
+  "license": "Apache-2.0",
+  "keywords": ["kb", "demo", "scaffold-kb", "test-fixture"],
+  "_testOnly": true
+}

package/plugins/demo-kb-zh/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "kb-zh": {
+      "command": "spectra",
+      "args": ["scaffold-kb", "serve", "--vendor-kb", "${CLAUDE_PLUGIN_ROOT}/kb"]
+    }
+  }
+}

package/plugins/demo-kb-zh/FIXTURE.json

@@ -0,0 +1,23 @@
+{
+  "manifest_version": "1.0",
+  "plugin": "demo-kb-zh",
+  "note": "F192 demo fixture 来源清单（机械可检，W-6）。每条 source MUST 有 license 或 synthetic:true；'无真实客户内容'以此承载，非空声称。",
+  "sources": [
+    {
+      "id": "vendor-docs",
+      "kind": "vendor-doc",
+      "origin": "https://echarts.apache.org/zh + apache/echarts-doc",
+      "license": "Apache-2.0",
+      "synthetic": false,
+      "note": "公开开源 SDK 文档（13 页）→ kb/ (doc-graph + chunks.sqlite FTS5 + api-entities.json)"
+    },
+    {
+      "id": "ingest-sample-minutes",
+      "kind": "minutes",
+      "origin": "ingest-samples/meeting-notes.md",
+      "license": null,
+      "synthetic": true,
+      "note": "F192 三方导入（scaffold-kb ingest --minutes）演示用合成纪要，纯虚构、无真实客户/公司/项目信息"
+    }
+  ]
+}

package/plugins/demo-kb-zh/FIXTURE.md

@@ -0,0 +1,63 @@
+# demo-kb-zh — 中文 demo fixture（Apache ECharts 文档）
+
+本目录是 Feature 190 `scaffold-kb` 的**中文 demo fixture**，用作一个**公开开源 SDK 文档**的代表性样例，用于演示 / 验证 `scaffold-kb build` 把中文 Markdown 文档目录构建为 `kb/`（`doc-graph.json` + `chunks.sqlite` FTS5 全文检索），重点验证中文分词与含点号配置项符号（如 `xAxis.axisLabel.formatter`）的检索能力。
+
+> 本 fixture 仅作通用「开源 SDK 文档」演示用途，不绑定任何客户、行业或专属场景。Apache ECharts 是一个公开的 Apache-2.0 开源项目，在此作为「某个公开 SDK」的一个实例呈现。
+
+> **F192 更新**：`kb/` 现额外含 **`api-entities.json`**（API 实体层，heuristic 抽取，供 `kb_api_lookup` 据文档查签名/参数/废弃，证据级非代码级）；`ingest-samples/meeting-notes.md` 是**三方导入演示用合成纪要**（`scaffold-kb ingest --minutes`，纯虚构无客户内容）；来源清单见机械可检的 `FIXTURE.json`。
+
+## 来源
+
+- 上游项目：Apache ECharts（开源可视化图表库）
+- 文档站（中文）：https://echarts.apache.org/zh/index.html
+- 教程页源码仓库：https://github.com/apache/echarts-doc （`zh/tutorial/` 目录，原始 Markdown）
+- 配置项数据：https://echarts.apache.org/zh/documents/option-parts/option.*.json （官方文档站发布的配置项手册结构化数据）
+- License：**Apache License 2.0**（https://github.com/apache/echarts/blob/master/LICENSE ；文档仓库 apache/echarts-doc 同为 Apache-2.0）
+
+## 页数与规模
+
+- 页数：**13 页**（`source-docs/*.md`）
+  - 8 篇教程页：快速上手、基础概念、初始化 `echarts.init` / `setOption`、样式、数据集 `dataset`、视觉映射、事件、异步更新、Canvas/SVG 渲染选择
+  - 5 篇配置项页：`option.xAxis` / `option.yAxis` / `option.series`（折线）/ `option.tooltip` / `option.legend`，含大量点号配置项符号（如 `xAxis.axisLabel.formatter`、`tooltip.formatter`、`series.label.formatter`）
+- 规模：远小于 50 页上限；构建出的 `chunks.sqlite` 远小于 10MB 上限
+
+## 来源页清单（slug ← 上游来源）
+
+教程页（apache/echarts-doc 仓库 `zh/tutorial/`，对应 echarts.apache.org/zh 渲染页）：
+
+| 本地文件 | 上游来源 |
+|---------|---------|
+| `getting-started.md` | https://echarts.apache.org/handbook/zh/get-started/ （源：`zh/tutorial/getting-started.md`） |
+| `basic-concepts.md` | 源：`zh/tutorial/basic-concepts-overview.md` |
+| `styling.md` | 源：`zh/tutorial/styling.md` |
+| `dataset.md` | 源：`zh/tutorial/dataset.md` |
+| `visual-map.md` | 源：`zh/tutorial/visual-map.md` |
+| `event.md` | 源：`zh/tutorial/event.md` |
+| `dynamic-data.md` | 源：`zh/tutorial/dynamic-data.md` |
+| `renderer.md` | 源：`zh/tutorial/renderer.md` |
+
+配置项页（数据源：官方文档站 option-parts JSON）：
+
+| 本地文件 | 上游来源 |
+|---------|---------|
+| `option-xaxis.md` | https://echarts.apache.org/zh/option.html#xAxis （数据：`option-parts/option.xAxis.json`） |
+| `option-yaxis.md` | https://echarts.apache.org/zh/option.html#yAxis （数据：`option-parts/option.yAxis.json`） |
+| `option-series-line.md` | https://echarts.apache.org/zh/option.html#series-line （数据：`option-parts/option.series-line.json`） |
+| `option-tooltip.md` | https://echarts.apache.org/zh/option.html#tooltip （数据：`option-parts/option.tooltip.json`） |
+| `option-legend.md` | https://echarts.apache.org/zh/option.html#legend （数据：`option-parts/option.legend.json`） |
+
+## 处理说明
+
+- 教程页正文取自上游原始中文 Markdown，保留真实中文术语、代码示例与符号（`echarts.init`、`setOption`、`option.series`、`dataset.transform` 等）。仅清理了文档构建模板语法：`{{ target/use }}` 指令、`${...}` 站点变量、站内 `.html#` 链接折叠为可读锚文本（点号符号原样保留），代码块内 HTML/JS 示例完全未改动。
+- 配置项页由官方 option-parts JSON 的真实中文描述（`desc` 字段）转换为 Markdown：每个配置项以完整点号路径（如 `option.xAxis.axisLabel.formatter`）作为小节标题，描述中的 HTML（`<code>` / `<pre>` 代码块 / `<table>` 表格 / 列表 / 引用）转为对应 Markdown。内容为官方原文，未编造任何 API。
+- 每个文件首行为 `# <中文标题>`，供 `scaffold-kb` 提取 doc title。
+
+## 构建命令
+
+```bash
+npx tsx src/cli/index.ts scaffold-kb build \
+  --dir plugins/demo-kb-zh/source-docs \
+  --output plugins/demo-kb-zh/kb
+```
+
+产物：`kb/doc-graph.json` + `kb/chunks.sqlite`。

package/plugins/demo-kb-zh/ingest-samples/meeting-notes.md

@@ -0,0 +1,13 @@
+# 集成评审会议纪要（演示用合成内容）
+
+> 本文件为 **F192 三方导入（`scaffold-kb ingest --minutes`）演示用合成样例**，内容纯属虚构、不含任何真实客户/公司/项目信息，仅展示「把会议纪要纳入项目库」的能力与 provenance 标注。
+
+## 约定事项
+
+- `setOption` 在本项目里约定每次全量传入，不依赖增量 merge（与上游默认行为不同，属本项目现场约束）。
+- 初始化统一走 `createChart(dom, options)`，dom 必须已设置显式高度，否则渲染为 0 高。
+- 错误码 `E1001` 在本项目环境下通常是容器未挂载导致，优先排查 DOM 生命周期。
+
+## 待办
+
+- 评估 `dispose()` 后重建实例的开销，确认是否需要实例池。