@mengzf/skillflow-mcp 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SkillFlow Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,239 @@
-# Temporary Holding Version
+# SkillFlow MCP (跨 Agent 技能命中监测与多维效能遥测中枢)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`SkillFlow MCP` 是一个统一的 **Model Context Protocol (MCP)** 服务与技能效能分析引擎。
+
+它的核心作用是：在开发者使用各类 AI 编程智能体（**Claude Code、Trae、Qoder、WorkBuddy、Codex、DSH 等**）时，**无侵入地记录每轮对话中 Skill 的命中情况，量化技能对开发流程的帮助（估算节省的交互步骤与消耗的 Token），并提供单次对话与跨 Agent 全局多维度的效能看板**。
+
+---
+
+## 🌟 核心特性
+
+1. **统一跨 Agent 共享底座**：
+   - 基于 Node.js 24 原生内置的 `node:sqlite`（`DatabaseSync`）开发，**零原生 C++ 编译依赖**（Windows/macOS/Linux 开箱即用）。
+   - 默认存储于 `~/.skillflow/skillflow.db`，开启 WAL（Write-Ahead Logging）高并发读写模式。无论你在 Trae、Claude Code 还是 Qoder 中工作，所有会话与统计数据**实时汇总互通**。
+2. **精准的技能命中与收益核算**：
+   - 记录每次 Skill 触发的执行状态（`success`、`partial`、`failed`、`skipped`）。
+   - 内置**反事实基准对比模型（Benchmark Diffing）**，自动计算节省的流程步骤（`saved_steps`）与节省的 Token 数量（`saved_tokens`）。
+3. **多维统计分析看板**：
+   - **时间维度**：当前会话（`current_session`）、今日（`today`）、近 7 天（`7days`）、近 30 天（`30days`）、全量历史（`all`）。
+   - **Agent 生态矩阵**：横向对比 Claude Code、Trae、Qoder、WorkBuddy、Codex、DSH 各自的调用频次与贡献节约量。
+   - **技能价值榜**：Top 技能排名与终端/聊天窗口友好的 ASCII 进度与柱状图。
+4. **灵活的技能基准管理**：
+   - 预设 10 大标准技能基准（`code-review`、`frontend-design`、`security-review`、`simplify`、`docx`、`xlsx`、`pptx`、`pdf-reading`、`dataviz`、`workflow-authoring`）。
+   - 支持自定义新增或动态调整团队内部技能的基准参数。
+
+---
+
+## 🛠️ 提供的 MCP Tools & Resources
+
+### 1. MCP Tools
+| MCP Tool 名称 | 核心用途 | 参数说明 |
+|:---|:---|:---|
+| `record_skill_hit` | 记录/上报一次 Skill 激活命中事件并核算收益 | `session_id` (必填), `skill_id` (必填), `agent_name`, `round_index`, `status`, `actual_tokens`, `actual_steps`, `saved_steps`, `saved_tokens`, `metadata` |
+| `get_round_skill_impact` | 查看指定轮次或当前会话的技能命中情况与明细报告 | `session_id` (可选，默认取最近会话), `round_index` (可选，默认最新轮次), `include_session_summary` (默认 true) |
+| `get_skill_dashboard` | 获取全景效能看板（按时间范围、Agent 矩阵、Skill 贡献榜聚合） | `time_range` (`current_session`/`today`/`7days`/`30days`/`all`), `session_id`, `agent_name`, `skill_id`, `group_by` |
+| `manage_skill_benchmark` | 管理技能基准库（列表、详情、新增/修改基准、删除、重置预设） | `action` (`list`/`get`/`set`/`delete`/`reset_defaults`), `skill_id`, `skill_name`, `category`, `baseline_steps`, `baseline_tokens` |
+| `get_web_dashboard_url` | 获取本地 Web 可视化看板的访问地址及运行状态 | 无必填入参，返回 `http://localhost:3000` 链接与说明 |
+
+### 2. MCP Resources (资源直读)
+| 资源 URI | 类型 | 说明 |
+|:---|:---|:---|
+| `skillflow://dashboard` | `text/html` | 自包含的 Web 可视化看板 HTML 视图，支持支持 Resource 渲染的 Client 直接嵌入 |
+| `skillflow://analytics.json` | `application/json` | 全局聚合分析指标的原始 JSON 数据 |
+| `skillflow://skills` | `application/json` | 完整技能基准清单数据 |
+
+---
+
+## 🌐 进阶增强：本地 Web 可视化看板
+
+服务启动时会在后台自动拉起一个内置的极轻量级 Web 服务器（基于 Node.js 原生 `node:http`，零第三方 HTTP 依赖）：
+- **默认地址**：`http://localhost:3000`（若端口被占用会自动顺延至 3001..）
+- **环境变量**：
+  - `SKILLFLOW_PORT=3000`（自定义端口）
+  - `SKILLFLOW_ENABLE_WEB=false`（若只想要单纯 stdio 模式可关闭 Web）
+- **看板功能**：
+  - 🎨 现代暗色主题 UI、自适应响应式布局。
+  - ⚡ 实时 5 秒自动轮询刷新。
+  - 📊 流程步骤节约与 Token 节省排行榜。
+  - 🤖 Claude Code / Trae / Qoder / WorkBuddy / Codex / DSH 各平台占比分布。
+  - ⏱️ 实时调用流水列表（展示时间、会话 ID、技能名、状态、节省指标）。
+
+---
+
+## 🚀 快速启动与编译
+
+### 环境要求
+- Node.js >= 24.0.0
+- npm >= 10.0.0
+
+### 安装与构建
+```bash
+# 1. 克隆或进入项目目录
+cd D:\code\skill
+
+# 2. 安装依赖
+npm install
+
+# 3. 运行完整测试套件 (包含单测与 MCP 协议集成测试)
+npm test
+
+# 4. 编译输出到 ./dist
+npm run build
+```
+
+---
+
+## 🔌 各 Agent 接入与配置指南
+
+由于你的 Agent 全面支持 MCP，只需将编译产物 `D:\code\skill\dist\index.js` 添加到对应 Agent 的 MCP 配置文件中即可。
+
+### 1. Claude Code
+直接使用命令行添加：
+```bash
+claude mcp add skillflow -- node D:/code/skill/dist/index.js
+```
+或直接写入用户全局配置 `~/.claude/settings.json`（或项目级 `.claude/settings.json`）：
+```json
+{
+  "mcpServers": {
+    "skillflow": {
+      "command": "node",
+      "args": ["D:/code/skill/dist/index.js"]
+    }
+  }
+}
+```
+
+### 2. Trae (ByteDance)
+在 Trae 设置面板中的 **MCP Servers** 或 `mcp.json` 中配置：
+```json
+{
+  "mcpServers": {
+    "skillflow": {
+      "command": "node",
+      "args": ["D:/code/skill/dist/index.js"],
+      "disabled": false
+    }
+  }
+}
+```
+
+### 3. Qoder (阿里通义)
+在 Qoder 的 MCP 插件设置界面添加：
+- **Name**: `skillflow`
+- **Transport**: `stdio`
+- **Command**: `node`
+- **Arguments**: `["D:/code/skill/dist/index.js"]`
+
+### 4. WorkBuddy (腾讯)
+在 WorkBuddy 的 Agent 扩展 / 工具市场中选择添加本地 MCP：
+```json
+{
+  "skillflow": {
+    "command": "node",
+    "args": ["D:/code/skill/dist/index.js"]
+  }
+}
+```
+
+### 5. Codex & DSH
+在客户端对应的 MCP Server 列表填入：
+```json
+{
+  "command": "node",
+  "args": ["D:/code/skill/dist/index.js"]
+]
+```
+
+---
+
+## 💬 实际交互使用示例
+
+配置完成后，在**任何一个 Agent** 中都可以用自然的中文直接询问：
+
+### 场景 1：探查本轮对话命中了什么 Skill
+> **用户**：“查看刚才这轮对话有没有触发 skill？帮我省了多少东西？”  
+> **Agent**：自动调用 `get_round_skill_impact`，返回如下 Markdown 报告：
+
+```markdown
+### 🎯 Skill 命中与效能分析报告 (Round #2)
+
+- **会话 ID**: `sess-20261111-trae-01`
+- **宿主 Agent**: `Trae`
+- **本轮命中技能数**: **2** 个
+- **流程步骤节省**: **+18 步**
+- **Token 节省估计**: **+8,850 Tokens** (82.3% 资源缩减, 价值 ~$0.03)
+
+#### 📋 本轮命中清单明细
+
+| 命中的 Skill | 分类 | 状态 | 实际步骤 | 基准步骤 | 步骤节省 | 实际 Token | Token 节省 | 节约比 |
+| :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| **Frontend Design** (`frontend-design`) | design | ✅ 成功 | 1 | 10 | **+9** | 620 | **+4,380** | 87.6% |
+| **Code Review** (`code-review`) | engineering | ✅ 成功 | 1 | 10 | **+9** | 530 | **+4,470** | 89.4% |
+
+---
+#### 📈 会话累计数据看板 (当前会话全轮次)
+
+- **当前总交互轮次**: 2 轮
+- **全会话技能总触发**: 3 次
+- **全会话累计节约步骤**: **+25 步**
+- **全会话累计节约 Token**: **+13,250 Tokens** (~$0.04)
+- **流程自动化压缩率**: [████████████████░░] 93%
+```
+
+---
+
+### 场景 2：跨 Agent 全局效能看板
+> **用户**：“统计一下我在所有 Agent 上的 skill 使用情况”  
+> **Agent**：自动调用 `get_skill_dashboard(time_range="all")`，返回全景大盘：
+
+```markdown
+## 📊 SkillFlow 跨平台全景效能看板
+
+> **筛选范围**: `ALL` | **Agent 维度**: `全部生态` | **主视角**: `skill`
+
+### 💡 核心效能大盘指标
+
+| 统计维度 | 数值指标 | 效能评估说明 |
+| :--- | :--- | :--- |
+| **覆盖会话** | **68** 场 | 活跃对话会话总数 |
+| **Skill 触发总量** | **184** 次 | 成功率 **97.8%** |
+| **累计精简流程** | **+1,240 步** | 消除的重复/排查交互步骤 |
+| **累计节省 Token** | **+5,420,000 Tokens** | 折合模型成本节约 **~$16.26** |
+
+### 🏆 价值贡献最大 Skill Top 5 (节省步骤榜)
+
+1. `Code Review`      [██████████████████] +540 步 (54次)
+2. `Frontend Design`  [████████████░░░░░░] +360 步 (40次)
+3. `Security Review`  [████████░░░░░░░░░░] +240 步 (20次)
+4. `Code Simplificat` [██████░░░░░░░░░░░░] +180 步 (30次)
+5. `Word Document Ge` [████░░░░░░░░░░░░░░] +120 步 (20次)
+
+### 🤖 各 Agent 生态调用与收益贡献矩阵
+
+| Agent 宿主 | 覆盖会话 | 触发次数 | 占比 | 贡献节约步骤 | 贡献节约 Token |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **Claude Code** | 28 | 82 次 | 44.6% | **+560 步** | **+2,450,000** |
+| **Trae** | 18 | 48 次 | 26.1% | **+320 步** | **+1,420,000** |
+| **WorkBuddy** | 12 | 31 次 | 16.8% | **+210 步** | **+910,000** |
+| **Qoder** | 6 | 15 次 | 8.2% | **+105 步** | **+440,000** |
+| **DSH / Codex** | 4 | 8 次 | 4.3% | **+45 步** | **+200,000** |
+```
+
+---
+
+## 📐 算法原理：如何量化“节省”？
+
+1. **基准对比（Benchmark Profile）**：
+   对于某个技能（如 `code-review`），若不使用该技能，开发者手动审查代码、多轮询问与修复通常需要 **12 个步骤** 并消耗约 **6,500 Tokens**。
+2. **结算逻辑**：
+   - 当技能执行成功（`status = 'success'`）且实际花费 1 步与 500 Token 时：
+     - **节省步骤** = $12 - 1 = 11$ 步；
+     - **节省 Token** = $6500 - 500 = 6000$ Tokens。
+   - 当技能部分成功（`status = 'partial'`）时按 50% 折算。
+   - 当执行失败（`status = 'failed'`）时节省量计为 0。
+
+---
+
+## 📄 License
+MIT License.

package/dist/adapters/workbuddy.sniffer.d.ts

@@ -0,0 +1,22 @@
+import { DatabaseSync } from 'node:sqlite';
+export interface WorkBuddySniffResult {
+    syncedCount: number;
+    syncedSkills: string[];
+}
+export declare class WorkBuddySniffer {
+    private skillflowDb;
+    private telemetryService;
+    constructor(skillflowDb: DatabaseSync);
+    /**
+     * Find all WorkBuddy profile paths on the system
+     */
+    findWorkBuddyPaths(): {
+        dbPath: string;
+        cachePath: string;
+    }[];
+    /**
+     * Sync WorkBuddy sessions into SkillFlow database
+     */
+    sync(): WorkBuddySniffResult;
+}
+//# sourceMappingURL=workbuddy.sniffer.d.ts.map

package/dist/adapters/workbuddy.sniffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbuddy.sniffer.d.ts","sourceRoot":"","sources":["../../src/adapters/workbuddy.sniffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAGf,OAAO,CAAC,WAAW;IAF/B,OAAO,CAAC,gBAAgB,CAAmB;gBAEvB,WAAW,EAAE,YAAY;IAI7C;;OAEG;IACH,kBAAkB,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE;IAsC7D;;OAEG;IACH,IAAI,IAAI,oBAAoB;CA6F7B"}

package/dist/adapters/workbuddy.sniffer.js

@@ -0,0 +1,143 @@
+import { DatabaseSync } from 'node:sqlite';
+import fs from 'node:fs';
+import path from 'node:path';
+import { TelemetryService } from '../services/telemetry.service.js';
+export class WorkBuddySniffer {
+    skillflowDb;
+    telemetryService;
+    constructor(skillflowDb) {
+        this.skillflowDb = skillflowDb;
+        this.telemetryService = new TelemetryService(skillflowDb);
+    }
+    /**
+     * Find all WorkBuddy profile paths on the system
+     */
+    findWorkBuddyPaths() {
+        const results = [];
+        // Common search locations
+        const candidates = [
+            'D:/WorkBuddyProfiles/Account3/.workbuddy',
+            'D:/WorkBuddyProfiles/Account1/.workbuddy',
+            'D:/WorkBuddyProfiles/Account2/.workbuddy',
+            path.join(process.env.USERPROFILE || '', '.workbuddy'),
+            path.join(process.env.APPDATA || '', 'WorkBuddy'),
+        ];
+        // Check directory if D:/WorkBuddyProfiles exists
+        if (fs.existsSync('D:/WorkBuddyProfiles')) {
+            try {
+                const accounts = fs.readdirSync('D:/WorkBuddyProfiles');
+                for (const acc of accounts) {
+                    const p = path.join('D:/WorkBuddyProfiles', acc, '.workbuddy');
+                    if (fs.existsSync(p)) {
+                        candidates.push(p);
+                    }
+                }
+            }
+            catch { }
+        }
+        const uniquePaths = Array.from(new Set(candidates));
+        for (const dir of uniquePaths) {
+            const dbPath = path.join(dir, 'workbuddy.db');
+            const cachePath = path.join(dir, '.skill-list-cache.json');
+            if (fs.existsSync(dbPath) && fs.existsSync(cachePath)) {
+                results.push({ dbPath, cachePath });
+            }
+        }
+        return results;
+    }
+    /**
+     * Sync WorkBuddy sessions into SkillFlow database
+     */
+    sync() {
+        const locations = this.findWorkBuddyPaths();
+        if (locations.length === 0) {
+            return { syncedCount: 0, syncedSkills: [] };
+        }
+        let syncedCount = 0;
+        const syncedSkills = [];
+        for (const loc of locations) {
+            let wbDb = null;
+            try {
+                wbDb = new DatabaseSync(loc.dbPath, { readOnly: true });
+                const cacheData = JSON.parse(fs.readFileSync(loc.cachePath, 'utf8'));
+                const skillMap = new Map();
+                for (const s of cacheData.results || []) {
+                    if (s.skillId)
+                        skillMap.set(s.skillId, s);
+                    if (s.resourceId)
+                        skillMap.set(s.resourceId, s);
+                    if (s.slug)
+                        skillMap.set(s.slug, s);
+                    if (s.overrideKey)
+                        skillMap.set(s.overrideKey, s);
+                }
+                const sessions = wbDb
+                    .prepare(`
+          SELECT s.*, u.used as tokens_used
+          FROM sessions s
+          LEFT JOIN session_usage u ON s.id = u.session_id
+          WHERE s.addon_selection IS NOT NULL
+        `)
+                    .all();
+                for (const sess of sessions) {
+                    try {
+                        const addon = JSON.parse(sess.addon_selection);
+                        if (!addon.microSceneIds || !Array.isArray(addon.microSceneIds))
+                            continue;
+                        for (const scene of addon.microSceneIds) {
+                            if (scene.startsWith('skill://') || scene.startsWith('command://')) {
+                                const rawId = scene.replace(/^(skill|command):\/\//, '');
+                                const meta = skillMap.get(rawId);
+                                const skillId = meta?.slug || meta?.overrideKey || rawId;
+                                const skillName = meta?.name || meta?.slug || rawId;
+                                // Check if already synced into SkillFlow
+                                const alreadySynced = this.skillflowDb
+                                    .prepare('SELECT id FROM invocations WHERE session_id = ? AND skill_id = ?')
+                                    .get(sess.id, skillId);
+                                if (!alreadySynced) {
+                                    const actualTokens = sess.tokens_used || 0;
+                                    this.telemetryService.recordHit({
+                                        session_id: sess.id,
+                                        skill_id: skillId,
+                                        agent_name: 'WorkBuddy',
+                                        model_name: sess.model || 'deepseek-v4.1-flash',
+                                        round_index: 1,
+                                        status: 'success',
+                                        actual_tokens: actualTokens,
+                                        actual_steps: 1,
+                                        metadata: {
+                                            title: sess.title,
+                                            model: sess.model,
+                                            created_at: sess.created_at,
+                                            source: 'workbuddy_auto_sniffer',
+                                        },
+                                    });
+                                    // Ensure skill name in manifest is human-friendly
+                                    this.skillflowDb
+                                        .prepare('UPDATE skills_manifest SET skill_name = ? WHERE skill_id = ?')
+                                        .run(skillName, skillId);
+                                    syncedCount++;
+                                    syncedSkills.push(`${skillName} (${sess.title})`);
+                                }
+                            }
+                        }
+                    }
+                    catch { }
+                }
+            }
+            catch (err) {
+                process.stderr.write(`[SkillFlow Sniffer] Error syncing WorkBuddy: ${err.message}\n`);
+            }
+            finally {
+                if (wbDb) {
+                    try {
+                        wbDb.close();
+                    }
+                    catch { }
+                }
+            }
+        }
+        return { syncedCount, syncedSkills };
+    }
+}
+//# sourceMappingURL=workbuddy.sniffer.js.map

package/dist/adapters/workbuddy.sniffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbuddy.sniffer.js","sourceRoot":"","sources":["../../src/adapters/workbuddy.sniffer.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+export interface AppConfig {
+    dbPath: string;
+    isInMemory: boolean;
+    webPort: number;
+    enableWeb: boolean;
+}
+export declare function resolveDbPath(): string;
+export declare function getConfig(): AppConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,IAAI,MAAM,CAkBtC;AAED,wBAAgB,SAAS,IAAI,SAAS,CAWrC"}

package/dist/config.js

@@ -0,0 +1,33 @@
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs';
+export function resolveDbPath() {
+    if (process.env.SKILLFLOW_DB_PATH) {
+        if (process.env.SKILLFLOW_DB_PATH === ':memory:') {
+            return ':memory:';
+        }
+        const customPath = path.resolve(process.env.SKILLFLOW_DB_PATH);
+        const dir = path.dirname(customPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        return customPath;
+    }
+    const defaultDir = path.join(os.homedir(), '.skillflow');
+    if (!fs.existsSync(defaultDir)) {
+        fs.mkdirSync(defaultDir, { recursive: true });
+    }
+    return path.join(defaultDir, 'skillflow.db');
+}
+export function getConfig() {
+    const dbPath = resolveDbPath();
+    const webPort = parseInt(process.env.SKILLFLOW_PORT || '3000', 10);
+    const enableWeb = process.env.SKILLFLOW_ENABLE_WEB !== 'false';
+    return {
+        dbPath,
+        isInMemory: dbPath === ':memory:',
+        webPort: isNaN(webPort) ? 3000 : webPort,
+        enableWeb,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AASzB,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACjD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,OAAO,CAAC;IAE/D,OAAO;QACL,MAAM;QACN,UAAU,EAAE,MAAM,KAAK,UAAU;QACjC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;QACxC,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/db/index.d.ts

@@ -0,0 +1,4 @@
+import { DatabaseSync } from 'node:sqlite';
+export declare function getDatabase(customPath?: string): DatabaseSync;
+export declare function closeDatabase(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAQ3C,wBAAgB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAuB7D;AAED,wBAAgB,aAAa,IAAI,IAAI,CAUpC"}

package/dist/db/index.js

@@ -0,0 +1,39 @@
+import { DatabaseSync } from 'node:sqlite';
+import { getConfig } from '../config.js';
+import { initializeSchema } from './schema.js';
+import { seedDefaultSkills } from './seed.js';
+let instance = null;
+let currentPath = null;
+export function getDatabase(customPath) {
+    const targetPath = customPath || getConfig().dbPath;
+    if (instance && currentPath === targetPath) {
+        return instance;
+    }
+    if (instance) {
+        try {
+            instance.close();
+        }
+        catch {
+            // Ignore close error on re-initialization
+        }
+    }
+    const isInMemory = targetPath === ':memory:';
+    instance = new DatabaseSync(targetPath);
+    currentPath = targetPath;
+    initializeSchema(instance, isInMemory);
+    seedDefaultSkills(instance);
+    return instance;
+}
+export function closeDatabase() {
+    if (instance) {
+        try {
+            instance.close();
+        }
+        catch {
+            // Ignore error during shutdown
+        }
+        instance = null;
+        currentPath = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,IAAI,QAAQ,GAAwB,IAAI,CAAC;AACzC,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,MAAM,UAAU,WAAW,CAAC,UAAmB;IAC7C,MAAM,UAAU,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC,MAAM,CAAC;IAEpD,IAAI,QAAQ,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,KAAK,UAAU,CAAC;IAC7C,QAAQ,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,WAAW,GAAG,UAAU,CAAC;IAEzB,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE5B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/db/schema.d.ts

@@ -0,0 +1,3 @@
+import { DatabaseSync } from 'node:sqlite';
+export declare function initializeSchema(db: DatabaseSync, isInMemory?: boolean): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,YAAY,EAAE,UAAU,UAAQ,GAAG,IAAI,CAkG3E"}

package/dist/db/schema.js

@@ -0,0 +1,103 @@
+function tryAddColumn(db, table, colDef) {
+    try {
+        db.exec(`ALTER TABLE ${table} ADD COLUMN ${colDef};`);
+    }
+    catch {
+        // Column already exists
+    }
+}
+export function initializeSchema(db, isInMemory = false) {
+    // Concurrency and integrity pragmas
+    db.exec('PRAGMA foreign_keys = ON;');
+    db.exec('PRAGMA busy_timeout = 5000;');
+    if (!isInMemory) {
+        db.exec('PRAGMA journal_mode = WAL;');
+        db.exec('PRAGMA synchronous = NORMAL;');
+    }
+    // 1. Skills Manifest table
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS skills_manifest (
+      skill_id TEXT PRIMARY KEY,
+      skill_name TEXT NOT NULL,
+      category TEXT NOT NULL DEFAULT 'general',
+      description TEXT,
+      baseline_steps INTEGER NOT NULL DEFAULT 5,
+      baseline_tokens INTEGER NOT NULL DEFAULT 3000,
+      baseline_manual_minutes INTEGER NOT NULL DEFAULT 15,
+      default_saved_steps INTEGER NOT NULL DEFAULT 4,
+      default_saved_tokens INTEGER NOT NULL DEFAULT 2000,
+      tags TEXT DEFAULT '[]',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+  `);
+    tryAddColumn(db, 'skills_manifest', 'baseline_manual_minutes INTEGER NOT NULL DEFAULT 15');
+    // 2. Sessions table
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS sessions (
+      session_id TEXT PRIMARY KEY,
+      agent_name TEXT NOT NULL DEFAULT 'unknown',
+      title TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      last_active_at TEXT NOT NULL DEFAULT (datetime('now')),
+      round_count INTEGER NOT NULL DEFAULT 1,
+      total_invocations INTEGER NOT NULL DEFAULT 0,
+      total_saved_steps INTEGER NOT NULL DEFAULT 0,
+      total_saved_tokens INTEGER NOT NULL DEFAULT 0,
+      total_saved_hours REAL NOT NULL DEFAULT 0.0,
+      total_cost_saved_usd REAL NOT NULL DEFAULT 0.0,
+      total_cost_saved_cny REAL NOT NULL DEFAULT 0.0,
+      total_corrections INTEGER NOT NULL DEFAULT 0,
+      metadata TEXT DEFAULT '{}'
+    );
+  `);
+    tryAddColumn(db, 'sessions', 'total_saved_hours REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'sessions', 'total_cost_saved_usd REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'sessions', 'total_cost_saved_cny REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'sessions', 'total_corrections INTEGER NOT NULL DEFAULT 0');
+    // 3. Invocations table
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS invocations (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      session_id TEXT NOT NULL,
+      agent_name TEXT NOT NULL DEFAULT 'unknown',
+      model_name TEXT NOT NULL DEFAULT 'unknown',
+      skill_id TEXT NOT NULL,
+      round_index INTEGER NOT NULL DEFAULT 1,
+      status TEXT NOT NULL CHECK(status IN ('success', 'failed', 'partial', 'skipped')),
+      actual_tokens INTEGER NOT NULL DEFAULT 0,
+      actual_steps INTEGER NOT NULL DEFAULT 1,
+      saved_steps INTEGER NOT NULL DEFAULT 0,
+      saved_tokens INTEGER NOT NULL DEFAULT 0,
+      net_tokens INTEGER NOT NULL DEFAULT 0,
+      saved_hours REAL NOT NULL DEFAULT 0.0,
+      cost_saved_usd REAL NOT NULL DEFAULT 0.0,
+      cost_saved_cny REAL NOT NULL DEFAULT 0.0,
+      has_correction INTEGER NOT NULL DEFAULT 0,
+      quality_profile TEXT NOT NULL DEFAULT 'efficient',
+      execution_time_ms INTEGER DEFAULT 0,
+      metadata TEXT DEFAULT '{}',
+      timestamp TEXT NOT NULL DEFAULT (datetime('now')),
+      FOREIGN KEY (skill_id) REFERENCES skills_manifest(skill_id) ON UPDATE CASCADE,
+      FOREIGN KEY (session_id) REFERENCES sessions(session_id) ON DELETE CASCADE
+    );
+  `);
+    tryAddColumn(db, 'invocations', "model_name TEXT NOT NULL DEFAULT 'unknown'");
+    tryAddColumn(db, 'invocations', 'saved_hours REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'invocations', 'cost_saved_usd REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'invocations', 'cost_saved_cny REAL NOT NULL DEFAULT 0.0');
+    tryAddColumn(db, 'invocations', 'net_tokens INTEGER NOT NULL DEFAULT 0');
+    tryAddColumn(db, 'invocations', 'has_correction INTEGER NOT NULL DEFAULT 0');
+    tryAddColumn(db, 'invocations', "quality_profile TEXT NOT NULL DEFAULT 'efficient'");
+    tryAddColumn(db, 'sessions', 'total_corrections INTEGER NOT NULL DEFAULT 0');
+    // Indices for query performance
+    db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_invocations_session_round ON invocations(session_id, round_index);
+    CREATE INDEX IF NOT EXISTS idx_invocations_agent ON invocations(agent_name);
+    CREATE INDEX IF NOT EXISTS idx_invocations_model ON invocations(model_name);
+    CREATE INDEX IF NOT EXISTS idx_invocations_skill ON invocations(skill_id);
+    CREATE INDEX IF NOT EXISTS idx_invocations_timestamp ON invocations(timestamp);
+    CREATE INDEX IF NOT EXISTS idx_sessions_last_active ON sessions(last_active_at);
+  `);
+}
+//# sourceMappingURL=schema.js.map