project-knowledge 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# 知识库变更日志
+
+记录 `D:\SanQian.Xu\project-knowledge-base\` 自身的结构性变更，不记录各项目内文档的内容变更（项目内变更见各项目的 `git-summary/changelog/` 或 git history）。
+
+## 格式
+
+- **Added**：新增文件 / 目录 / 脚本
+- **Changed**：现有文件 / 目录结构调整
+- **Removed**：删除文件 / 目录
+- **Fixed**：修复错误
+
+## 2026-06-08
+
+### Changed
+- 项目从 `kb` 重命名为 `project-knowledge-base`，更新所有内部路径引用
+
+## 2026-06-07
+
+### Added
+- 建立 `project-knowledge-base/` 顶层结构（`README.md`、`INDEX.md`、`CHANGELOG.md`、`projects.json`、`iterations.json`、`.gitignore`）
+- 建立 5 个项目子目录的标准化模板（`README.md`、`framework.md`、`architecture/`、`modules/`、`commits/`、`operations/`、`references/`）
+- 创建 4 个文档模板（`templates/project-readme.md`、`framework.md`、`module.md`、`commit-feature.md`）
+- 迁移 3 个项目的 `knowledge/` 内容到 `project-knowledge-base/projects/<slug>/`：
+  - Claude-DevSprite（5 篇 project-overview + 50+ 篇 changelog）
+  - Token Consumption Leaderboard（5 篇 features + 6 篇 changelog）
+- 迁移 quant-platform 的 `docs/` 内容（`docs/progress/`、`docs/backend/`）
+- 提取 Claude-Code-UI（参考项目）的 README.zh-CN.md + CHANGELOG.md
+- 编写 `scripts/gen-commit-doc.ps1` 与 `gen-commit-doc.sh`，实现 git log → 功能文档
+- 首次对 5 个项目执行 `gen-commit-doc.ps1`，生成 `commits/*.md`
+
+### Removed
+- 删除 `D:\SanQian.Xu\Claude-DevSprite\knowledge\`（已备份到 `_backup/2026-06-07/`）
+- 删除 `D:\SanQian.Xu\Token Consumption Leaderboard\knowledge\`（已备份到 `_backup/2026-06-07/`）
+- 删除 `D:\SanQian.Xu\web-remote-control\knowledge\`（原为空目录）

package/INDEX.md

@@ -0,0 +1,53 @@
+# 项目索引
+
+> 5 个项目的速查表。按问题反查：「我想找 Python + 金融的」→ `quant-platform`；「我想找 WebRTC 的」→ `web-remote-control`。
+
+## 按角色反查
+
+| 我想找… | 项目 |
+|---------|------|
+| 量化金融数据平台 | [quant-platform](./projects/quant-platform/README.md) |
+| WebRTC 远程桌面控制 | [web-remote-control](./projects/web-remote-control/README.md) |
+| Claude Code CLI 工具 | [claude-devsprite](./projects/claude-devsprite/README.md) |
+| Claude Code Web UI（参考） | [claude-code-ui](./projects/claude-code-ui/README.md) |
+| Token 消耗排行榜 / 统计 | [token-consumption-leaderboard](./projects/token-consumption-leaderboard/README.md) |
+
+## 按技术栈反查
+
+| 技术栈 | 项目 |
+|--------|------|
+| Python + FastAPI + Vue3(CDN) + ECharts | [quant-platform](./projects/quant-platform/README.md) |
+| TypeScript + WebRTC + PeerJS + rrweb | [web-remote-control](./projects/web-remote-control/README.md) |
+| TypeScript + Node + Anthropic SDK + Vue 3 | [claude-devsprite](./projects/claude-devsprite/README.md) |
+| React + Vite + Express + PostgreSQL + pnpm | [token-consumption-leaderboard](./projects/token-consumption-leaderboard/README.md) |
+| React + Vite + Express（参考项目） | [claude-code-ui](./projects/claude-code-ui/README.md) |
+
+## 按标签反查
+
+| 标签 | 项目 |
+|------|------|
+| `node` `claude` `skill` `knowledge-graph` | claude-devsprite |
+| `react` `vite` `postgresql` `pnpm` `monorepo` | token-consumption-leaderboard |
+| `fastapi` `vue3` `echarts` `akshare` `tushare` | quant-platform |
+| `webrtc` `peerjs` `rrweb` `desktop-control` | web-remote-control |
+| `react` `vite` `websocket` `claude-code` | claude-code-ui |
+
+## 项目活跃度（最近一次提交时间）
+
+> 自动从 `projects.json` 与 `git log -1` 读取，此处为人工填充的快照。
+
+| 项目 | 最近提交 | 状态 |
+|------|---------|------|
+| Claude-DevSprite | 2026-05-17 | 活跃 |
+| Token Consumption Leaderboard | 2026-05-19 | 活跃 |
+| web-remote-control | 2026-05-19 | 活跃 |
+| Claude-Code-UI | — | 参考项目（不修改） |
+| quant-platform | 2026-03-14 | 较慢 |
+
+## 详细导航
+
+- [Claude Code UI →](./projects/claude-code-ui/README.md)
+- [Claude-DevSprite →](./projects/claude-devsprite/README.md)
+- [Token Consumption Leaderboard →](./projects/token-consumption-leaderboard/README.md)
+- [quant-platform →](./projects/quant-platform/README.md)
+- [web-remote-control →](./projects/web-remote-control/README.md)

package/README.md

@@ -0,0 +1,79 @@
+# SanQian.Xu 项目知识库
+
+> 统一管理 `D:\SanQian.Xu` 下多个项目的项目框架、功能模块、git 提交的功能变更。
+
+## 目录速览
+
+```
+project-knowledge-base/
+├── INDEX.md                # 项目速查表（按角色/技术栈/标签）
+├── projects.json           # 项目元信息（脚本读取）
+├── iterations.json         # 里程碑定义
+├── projects/
+│   ├── claude-code-ui/                # Claude Code UI（克隆参考项目）
+│   ├── claude-devsprite/              # Claude-DevSprite（CLI + Web Dashboard）
+│   ├── token-consumption-leaderboard/ # Token 消耗排行榜
+│   ├── quant-platform/                # 量化金融数据平台
+│   ├── web-remote-control/            # WebRTC 远程桌面
+│   └── tokenrank-cloud/               # TokenRank Cloud
+├── scripts/
+│   ├── gen-commit-doc.ps1  # 核心：git log → 功能文档
+│   ├── gen-commit-doc.sh   # Bash 版
+│   ├── list-features.ps1   # 列出某项目所有功能
+│   └── register-scheduled-task.bat  # 注册每日定时任务
+└── templates/              # 文档模板
+```
+
+## 阅读路径
+
+1. **第一次来** → 看 [INDEX.md](./INDEX.md) 了解项目概况
+2. **找某个项目的框架** → `projects/<slug>/framework.md`
+3. **找某个功能模块** → `projects/<slug>/modules/00-index.md`
+4. **找某次 git 提交的功能变更** → `projects/<slug>/commits/00-index.md`
+5. **找项目与源码的对应关系** → `projects/<slug>/references/source-map.md`
+
+## 项目 slug 对照
+
+| slug | 项目目录 | 显示名 |
+|------|----------|--------|
+| `claude-code-ui` | `Claude-Code-UI\Reference Project\claudecodeui` | Claude Code UI |
+| `claude-devsprite` | `Claude-DevSprite` | Claude-DevSprite |
+| `token-consumption-leaderboard` | `Token Consumption Leaderboard` | Token Consumption Leaderboard |
+| `quant-platform` | `quant-platform` | quant-platform |
+| `web-remote-control` | `web-remote-control` | web-remote-control |
+| `tokenrank-cloud` | `TokenRank Cloud` | TokenRank Cloud |
+
+## 如何更新知识库
+
+### 手动更新
+
+- 改 `projects/<slug>/modules/*.md` 的「最近一次重要变更」段：PR 作者
+- 改 `projects/<slug>/framework.md`：项目 owner（季度审查）
+- 改 `INDEX.md`、`projects.json`、`iterations.json`：知识库 owner
+
+### 自动更新（git 提交 → 功能文档）
+
+```powershell
+cd D:\SanQian.Xu\project-knowledge-base\scripts
+.\gen-commit-doc.ps1 -ProjectSlug claude-devsprite   # 单项目
+.\gen-commit-doc.ps1 -ProjectSlug ALL                # 全部项目
+```
+
+脚本行为：
+- `feat` / `fix` / `refactor` / `perf` → 写入 `commits/`
+- `docs` / `chore` / `test` / `style` → 跳过（不写入 commits/）
+- 同 feature-slug 的提交 → **追加到已有功能文件**（不新建）
+- `docs:` / `chore:` 视为维护类变更，不进 `commits/`
+
+详见 `templates/commit-feature.md` 的输出格式。
+
+## 维护约定
+
+- **路径风格**：所有内部链接用 POSIX 风格（`/` 而非 `\`）
+- **命名风格**：文件名 kebab-case 全小写 ASCII
+- **Frontmatter**：每个 `.md` 顶部带 YAML frontmatter（用 `---` 包围）
+- **每文件一职责**：一个模块一文件、一次功能交付一文件
+
+## 知识库自身的变更
+
+见 [CHANGELOG.md](./CHANGELOG.md)。

package/_site/README.md

@@ -0,0 +1,63 @@
+# KB · Management Site
+
+Visual management UI for the knowledge base at `D:\SanQian.Xu\project-knowledge-base\`.
+
+## Quick start
+
+1. Double-click `start.bat`
+2. Browser opens to <http://localhost:7777/>
+3. To stop: double-click `stop.bat` (or close the minimized "KB-Site" console)
+
+If port 7777 is busy, set `KB_SITE_PORT=8888` (or any free port) before launching.
+
+## What it does
+
+The site has four tabs:
+
+| Tab | Purpose |
+|-----|---------|
+| **Projects** | List of all projects in `project-knowledge-base/projects.json` with status badges (KB ready / missing), tags, links to README, and a tree viewer. "Remove" deletes from `projects.json` only (KB files untouched). |
+| **+ Add** | Form to register a new project: slug, display name, local/git path, language, tags, optional reference flag. With "Create KB directory structure now" checked, it also seeds `architecture/`, `modules/`, `commits/`, `operations/`, `references/` plus README/framework from templates. |
+| **Schedule & Run** | Live read of `KB-GitCommits-Daily` Windows task (state, next run, last result). Change frequency (off / hourly / every 6h / every 12h / daily / weekly). Run `gen-commit-doc.ps1` manually for a single project or ALL. |
+| **Log** | Tail of the last script run (output + status). |
+
+The page auto-refreshes every 30 seconds. The "Refresh" button forces an immediate reload.
+
+## Architecture
+
+```
+_start.bat (double-click) → node server.js (port 7777)
+                                │
+                                ├─ GET  /            → index.html
+                                ├─ GET  /api/state   → projects.json + schedule + lastRun
+                                ├─ GET  /api/projects
+                                ├─ PUT  /api/projects   (add or replace)
+                                ├─ POST /api/projects/:slug/init
+                                ├─ GET  /api/dirs/:slug (tree)
+                                ├─ GET  /api/schedule   (Get-ScheduledTaskInfo)
+                                ├─ PUT  /api/schedule   (schtasks /create or /delete)
+                                ├─ POST /api/script/run (spawn gen-commit-doc.ps1)
+                                └─ GET  /api/script/status
+```
+
+The server is **zero npm install** — uses only Node built-ins (`http`, `fs`, `path`, `child_process`). The frontend is **Vue 3 + Tailwind from CDN** — no build step.
+
+## Requirements
+
+- Node.js 18+ (already present on this machine via the pnpm monorepo)
+- Windows (uses `schtasks` and `Get-ScheduledTask` PowerShell cmdlets)
+- Knowledge base initialized at `D:\SanQian.Xu\project-knowledge-base\` with `projects.json`
+
+## Security note
+
+The server binds to `127.0.0.1` only — it is **not accessible from the network**. The endpoints can write to `projects.json` and invoke schtasks/PowerShell; do not expose this port.
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `index.html` | Vue 3 SPA (loaded from CDN) |
+| `server.js` | Node HTTP server, ~270 lines |
+| `start.bat` | Launcher (open browser, start minimized console) |
+| `stop.bat` | Kill the listening process |
+| `README.md` | This file |

package/_site/_test/ai-profile-test.js

@@ -0,0 +1,199 @@
+// TASK-005: AI profile and adapter test
+// Run: node _site/_test/ai-profile-test.js
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+const {
+  ADAPTERS, getAdapter, listAdapters,
+  validateInitialOutput, validateCommitBatchOutput,
+} = require('../lib/ai-adapter');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const SERVER = path.join(ROOT, '_site', 'server.js');
+const PROJECTS_JSON = path.join(ROOT, 'projects.json');
+const AI_PROFILES_JSON = path.join(ROOT, 'ai-profiles.json');
+const PORT = process.env.KB_AI_TEST_PORT || '7795';
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+const TEMP_SLUG = 'task-005-temp';
+
+function assert(cond, msg) { if (!cond) throw new Error(msg); }
+
+async function waitForServer() {
+  const deadline = Date.now() + 15000;
+  let lastError;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(`${BASE_URL}/api/state`);
+      if (res.ok) return;
+      lastError = new Error(`HTTP ${res.status}`);
+    } catch (e) { lastError = e; }
+    await new Promise(r => setTimeout(r, 250));
+  }
+  throw lastError || new Error('server did not start');
+}
+
+async function json(method, url, body) {
+  const res = await fetch(`${BASE_URL}${url}`, {
+    method,
+    headers: body ? { 'Content-Type': 'application/json' } : undefined,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+  const text = await res.text();
+  let data = {};
+  if (text) { try { data = JSON.parse(text); } catch { data = { raw: text }; } }
+  return { res, data };
+}
+
+async function cleanup() {
+  const base = path.join(ROOT, 'projects', TEMP_SLUG);
+  fs.rmSync(base, { recursive: true, force: true });
+  const cur = JSON.parse(fs.readFileSync(PROJECTS_JSON, 'utf-8'));
+  if (cur[TEMP_SLUG]) {
+    delete cur[TEMP_SLUG];
+    fs.writeFileSync(PROJECTS_JSON, JSON.stringify(cur, null, 2) + '\n', 'utf-8');
+  }
+}
+
+(async () => {
+  // 1. Static / unit tests on the adapter
+  assert(fs.existsSync(AI_PROFILES_JSON), 'ai-profiles.json should exist');
+  const cfg = JSON.parse(fs.readFileSync(AI_PROFILES_JSON, 'utf-8'));
+  assert(cfg.schema === 'ai-profiles/v1', 'ai-profiles schema should be v1');
+  assert(cfg.defaultProfileId, 'defaultProfileId should be set');
+  assert(Array.isArray(cfg.profiles) && cfg.profiles.length >= 1, 'at least one profile');
+
+  const adapters = listAdapters();
+  assert(adapters.length >= 1, 'at least one adapter');
+  assert(adapters.find(a => a.id === 'mock-agent'), 'mock-agent should be listed');
+
+  const mock = getAdapter('mock-agent');
+  assert(mock, 'getAdapter should return mock-agent');
+  assert(typeof mock.analyzeInitialProject === 'function', 'analyzeInitialProject should be a function');
+  assert(typeof mock.analyzeCommitBatch === 'function', 'analyzeCommitBatch should be a function');
+  assert(typeof mock.validateOutput === 'function', 'validateOutput should be a function');
+
+  // 2. Mock initial analysis: deterministic, valid output
+  const initialOut = await mock.analyzeInitialProject({
+    project: { slug: 'demo' },
+    contextPack: { entries: [{ path: 'README.md' }, { path: 'src/index.ts' }] },
+  });
+  const v1 = validateInitialOutput(initialOut);
+  assert(v1.valid, `mock initial output should validate: ${v1.errors.join('; ')}`);
+  assert(initialOut.goalDraft.oneSentenceGoal.includes('demo'), 'mock should mention project slug');
+  assert(initialOut.analysisDraft.evidence.length > 0, 'mock should cite evidence');
+
+  // 3. Mock commit batch: deterministic, valid output
+  const batchOut = await mock.analyzeCommitBatch({
+    project: { slug: 'demo' },
+    commits: [
+      { hash: 'aaaaaaaaaaaaaaaa', short: 'aaaaaaa', subject: 'feat: add foo' },
+      { hash: 'bbbbbbbbbbbbbbbb', short: 'bbbbbbb', subject: 'fix: repair foo' },
+      { hash: 'cccccccccccccccc', short: 'ccccccc', subject: 'test: add foo test' },
+      { hash: 'dddddddddddddddd', short: 'ddddddd', subject: 'refactor: rename foo' },
+      { hash: 'eeeeeeeeeeeeeeee', short: 'eeeeeee', subject: 'docs: update readme' },
+    ],
+    contextPack: { entries: [{ path: 'src/foo.ts' }] },
+  });
+  const v2 = validateCommitBatchOutput(batchOut);
+  assert(v2.valid, `mock commit output should validate: ${v2.errors.join('; ')}`);
+  assert(batchOut.changes.length === 5, 'should produce one change per commit');
+  const classes = batchOut.changes.map(c => c.classification);
+  assert(classes.includes('new-feature'), 'feat → new-feature');
+  assert(classes.includes('bug-fix'), 'fix → bug-fix');
+  assert(classes.includes('test-only'), 'test → test-only');
+  assert(classes.includes('refactor'), 'refactor → refactor');
+  assert(classes.includes('docs-only'), 'docs → docs-only');
+
+  // 4. Invalid output is rejected
+  const bad = validateInitialOutput({ goalDraft: {}, analysisDraft: {}, modules: 'nope', features: [] });
+  assert(!bad.valid, 'invalid output should be rejected');
+  const bad2 = validateCommitBatchOutput({ changes: [{ commit: 'a' }] });
+  assert(!bad2.valid, 'incomplete change entry should be rejected');
+
+  // 5. Unknown adapter id
+  assert(!getAdapter('nope'), 'unknown adapter should return null');
+
+  // 6. Server tests
+  assert(fs.existsSync(SERVER), 'server.js missing');
+  JSON.parse(fs.readFileSync(PROJECTS_JSON, 'utf-8'));
+  const child = spawn(process.execPath, [SERVER], {
+    cwd: ROOT,
+    env: { ...process.env, KB_SITE_PORT: PORT, KB_SITE_HOST: '127.0.0.1' },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+  });
+  let serverOutput = '';
+  child.stdout.on('data', d => { serverOutput += d.toString(); });
+  child.stderr.on('data', d => { serverOutput += d.toString(); });
+
+  try {
+    await cleanup();
+    await waitForServer();
+
+    // 7. GET /api/ai-profiles
+    let r = await json('GET', '/api/ai-profiles');
+    assert(r.res.ok, 'GET ai-profiles should return 200');
+    assert(r.data.ok, 'response should be ok');
+    assert(r.data.config && r.data.config.schema === 'ai-profiles/v1', 'config should be returned');
+    assert(Array.isArray(r.data.adapters) && r.data.adapters.length >= 1, 'adapters should be listed');
+
+    // 8. PUT /api/ai-profiles with invalid profile id → 400
+    r = await json('PUT', '/api/ai-profiles', {
+      schema: 'ai-profiles/v1',
+      defaultProfileId: 'nope',
+      profiles: [{ id: 'nope', name: 'nope', implementation: 'nope' }],
+    });
+    assert(!r.res.ok && r.res.status === 400, 'invalid profile id should 400');
+    assert(Array.isArray(r.data.errors), 'should return errors list');
+
+    // 9. PUT /api/ai-profiles with valid config
+    r = await json('PUT', '/api/ai-profiles', {
+      schema: 'ai-profiles/v1',
+      defaultProfileId: 'mock-agent',
+      profiles: [
+        { id: 'mock-agent', name: 'Mock', enabled: true, implementation: 'mock-agent' },
+        { id: 'claude-code-agent', name: 'Claude Code', enabled: false, implementation: 'claude-code-agent' },
+      ],
+    });
+    assert(r.res.ok, 'valid profile config should be accepted');
+
+    // 10. Per-project ai profile selection
+    r = await json('PUT', '/api/projects', {
+      slug: TEMP_SLUG,
+      config: { displayName: 'TASK-005' },
+    });
+    assert(r.res.ok, 'upsert should succeed');
+    assert(r.data.repoStatus !== undefined, 'repoStatus should be returned');
+
+    r = await json('PUT', `/api/projects/${TEMP_SLUG}/ai-profile`, { aiProfileId: 'mock-agent' });
+    assert(r.res.ok, 'set ai profile should succeed');
+    assert(r.data.aiProfileId === 'mock-agent', 'aiProfileId should be set');
+
+    r = await json('PUT', `/api/projects/${TEMP_SLUG}/settings`, {
+      aiProfileId: 'mock-agent',
+      knowledgeLanguage: 'en-US',
+    });
+    assert(r.res.ok, 'set project settings should succeed');
+    assert(r.data.aiProfileId === 'mock-agent', 'settings should return aiProfileId');
+    assert(r.data.knowledgeLanguage === 'en-US', 'settings should return knowledgeLanguage');
+
+    r = await json('PUT', `/api/projects/${TEMP_SLUG}/settings`, { knowledgeLanguage: 'fr-FR' });
+    assert(!r.res.ok && r.res.status === 400, 'invalid knowledgeLanguage should 400');
+
+    r = await json('PUT', `/api/projects/${TEMP_SLUG}/ai-profile`, { aiProfileId: 'nope' });
+    assert(!r.res.ok && r.res.status === 400, 'unknown adapter should 400');
+
+    r = await json('GET', '/api/projects');
+    assert(r.data[TEMP_SLUG].aiProfileId === 'mock-agent', 'aiProfileId should be persisted');
+    assert(r.data[TEMP_SLUG].knowledgeLanguage === 'en-US', 'knowledgeLanguage should be persisted');
+
+    console.log('TASK-005 AI profile test passed');
+  } catch (e) {
+    console.error('TASK-005 AI profile test failed:', e.message);
+    if (serverOutput) console.error(serverOutput);
+    process.exitCode = 1;
+  } finally {
+    await cleanup().catch(() => {});
+    child.kill();
+  }
+})();

package/_site/_test/baseline-schema-test.js

@@ -0,0 +1,132 @@
+// Baseline TASK-001 test: project schema normalization and API smoke checks.
+// Run from repository root: node _site/_test/baseline-schema-test.js
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const SERVER = path.join(ROOT, '_site', 'server.js');
+const PROJECTS_JSON = path.join(ROOT, 'projects.json');
+const PORT = process.env.KB_BASELINE_TEST_PORT || '7791';
+const BASE_URL = `http://127.0.0.1:${PORT}`;
+const TEMP_SLUG = 'task-001-temp';
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+async function waitForServer() {
+  const deadline = Date.now() + 15000;
+  let lastError;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(`${BASE_URL}/api/state`);
+      if (res.ok) return;
+      lastError = new Error(`HTTP ${res.status}`);
+    } catch (e) {
+      lastError = e;
+    }
+    await new Promise(resolve => setTimeout(resolve, 250));
+  }
+  throw lastError || new Error('server did not start');
+}
+
+async function json(method, url, body) {
+  const res = await fetch(`${BASE_URL}${url}`, {
+    method,
+    headers: body ? { 'Content-Type': 'application/json' } : undefined,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+  const text = await res.text();
+  let data = {};
+  if (text) {
+    try { data = JSON.parse(text); } catch { data = { raw: text }; }
+  }
+  return { res, data };
+}
+
+async function removeTempProject() {
+  const current = JSON.parse(fs.readFileSync(PROJECTS_JSON, 'utf8'));
+  if (current[TEMP_SLUG]) {
+    delete current[TEMP_SLUG];
+    const result = await json('PUT', '/api/projects', { projects: current });
+    assert(result.res.ok, 'failed to remove temp project');
+  }
+}
+
+(async () => {
+  JSON.parse(fs.readFileSync(PROJECTS_JSON, 'utf8'));
+
+  const child = spawn(process.execPath, [SERVER], {
+    cwd: ROOT,
+    env: { ...process.env, KB_SITE_PORT: PORT, KB_SITE_HOST: '127.0.0.1' },
+    stdio: ['ignore', 'pipe', 'pipe'],
+    windowsHide: true,
+  });
+
+  let serverOutput = '';
+  child.stdout.on('data', d => { serverOutput += d.toString(); });
+  child.stderr.on('data', d => { serverOutput += d.toString(); });
+
+  try {
+    await waitForServer();
+
+    const stateResult = await json('GET', '/api/state');
+    assert(stateResult.res.ok, '/api/state should return 200');
+    assert(stateResult.data.projectSchemaVersion === 'v1', 'projectSchemaVersion should be v1');
+    assert(stateResult.data.kbRoot.endsWith('project-knowledge-base'), 'kbRoot should point to project-knowledge-base');
+
+    const projects = stateResult.data.projects;
+    assert(projects && Object.keys(projects).length >= 1, 'state should include projects');
+    for (const [slug, cfg] of Object.entries(projects)) {
+      assert(Object.prototype.hasOwnProperty.call(cfg, 'enabled'), `${slug} missing enabled`);
+      assert(Object.prototype.hasOwnProperty.call(cfg, 'repoStatus'), `${slug} missing repoStatus`);
+      assert(Object.prototype.hasOwnProperty.call(cfg, 'headCommit'), `${slug} missing headCommit`);
+      assert(Object.prototype.hasOwnProperty.call(cfg, 'lastSeenCommit'), `${slug} missing lastSeenCommit`);
+      assert(Object.prototype.hasOwnProperty.call(cfg, 'lastAnalyzedCommit'), `${slug} missing lastAnalyzedCommit`);
+      assert(cfg.aiProfileId, `${slug} missing aiProfileId`);
+      assert(cfg.kbSchemaVersion === 'v1', `${slug} missing kbSchemaVersion v1`);
+      assert(cfg.goalStatus, `${slug} missing goalStatus`);
+      assert(!String(cfg.kbPath || '').includes('\\SanQian.Xu\\kb\\'), `${slug} uses legacy kbPath`);
+    }
+
+    await removeTempProject();
+    const upsertResult = await json('PUT', '/api/projects', {
+      slug: TEMP_SLUG,
+      config: {
+        displayName: 'TASK-001 Temp',
+        localPath: ROOT,
+        gitPath: ROOT,
+        kbPath: `D:\\SanQian.Xu\\kb\\projects\\${TEMP_SLUG}`,
+      },
+    });
+    assert(upsertResult.res.ok, 'temp project upsert should succeed');
+
+    const projectsResult = await json('GET', '/api/projects');
+    assert(projectsResult.res.ok, '/api/projects should return 200');
+    const temp = projectsResult.data[TEMP_SLUG];
+    assert(temp, 'temp project should exist');
+    assert(temp.kbPath.endsWith(`project-knowledge-base\\projects\\${TEMP_SLUG}`), 'legacy kbPath should be normalized');
+    assert(temp.enabled === true, 'temp project should default enabled=true');
+    // repoStatus is auto-validated on upsert; ROOT may or may not be a git repo.
+    // Accept any of the well-defined statuses that prove normalization ran.
+    assert(['ok', 'unknown', 'not-git', 'missing-path'].includes(temp.repoStatus),
+      `temp project repoStatus should be a known value, got ${temp.repoStatus}`);
+
+    const htmlResult = await fetch(`${BASE_URL}/`);
+    const html = await htmlResult.text();
+    assert(htmlResult.ok, 'site root should return 200');
+    assert(html.includes('id="app"'), 'site HTML should include Vue app root');
+    assert(html.includes('Projects'), 'site HTML should include Projects tab');
+
+    await removeTempProject();
+    console.log('TASK-001 baseline schema test passed');
+  } catch (e) {
+    console.error('TASK-001 baseline schema test failed:', e.message);
+    if (serverOutput) console.error(serverOutput);
+    process.exitCode = 1;
+  } finally {
+    await removeTempProject().catch(() => {});
+    child.kill();
+  }
+})();