@devflow-tools/database 0.8.10 → 0.9.0

package/CHANGELOG.md

@@ -3,6 +3,42 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.9.0](https://github.com/shilongfeicool/dev-flow/compare/v0.8.11...v0.9.0) (2026-07-10)
+
+
+### Bug Fixes
+
+* auto-checker interface mismatch, memory cleanup, type safety, and L3 extraction ([bf3b6db](https://github.com/shilongfeicool/dev-flow/commit/bf3b6dbbabae9246b919461b40ad7e35352378b7))
+* **mcp:** route devflow_report_event to correct telemetry endpoint ([e7a4b2f](https://github.com/shilongfeicool/dev-flow/commit/e7a4b2f9a1515c199675768fb4a549fe5a00054c))
+* **telemetry:** resolve FK constraint blocking tool-call events from reaching DB ([cbfb9c3](https://github.com/shilongfeicool/dev-flow/commit/cbfb9c31d345e83fc81732053ae67a3c3c193bb7))
+
+
+### Features
+
+* add query logger + accuracy_queries table + annotation API ([a2ccc59](https://github.com/shilongfeicool/dev-flow/commit/a2ccc592b82fbc81bb25dd5c88212d7e10bde896))
+* add tool metrics pipeline — tool_metrics table, collection in post-tool-use, aggregation API ([d3452aa](https://github.com/shilongfeicool/dev-flow/commit/d3452aa195b8ec6414846432047c43bf64117c30))
+
+
+
+
+
+## [0.8.11](https://github.com/shilongfeicool/dev-flow/compare/v0.8.10...v0.8.11) (2026-07-10)
+
+
+### Bug Fixes
+
+* **database:** add kind and workflow_run_id columns, add cleanupStaleRecords method ([b93ca4e](https://github.com/shilongfeicool/dev-flow/commit/b93ca4ede19aff7ea249c1cbca05e4b6c507d628))
+* **database:** drop FK constraint, closeSession dual-path query, idempotent listSkillExecutions, session_id index ([5d9091a](https://github.com/shilongfeicool/dev-flow/commit/5d9091a9f0586c0dee247e1d8b778e4b3fa07653))
+
+
+### Features
+
+* **database:** add sessions table, add session_id to skill_executions and tool_call_events, remove tokens_used ([1decff8](https://github.com/shilongfeicool/dev-flow/commit/1decff8ff68f3581228f4f3dc31414e0acdcac66))
+
+
+
+
+
 ## [0.8.10](https://github.com/shilongfeicool/dev-flow/compare/v0.8.6...v0.8.10) (2026-07-10)
 
 

package/README.md

@@ -0,0 +1,68 @@
+# @devflow-tools/database
+
+DevFlow 数据库层 — 基于 better-sqlite3 的 SQLite + WAL 模式持久化存储，管理 runs、tool call events、skill executions、project stats 和 settings。
+
+## Installation
+
+```bash
+npm install @devflow-tools/database
+```
+
+## Usage
+
+```typescript
+import { DevFlowDatabase } from '@devflow-tools/database';
+
+const db = new DevFlowDatabase('/path/to/project');
+
+// 记录 tool call 事件
+db.insertToolCallEvent({
+  eventId: 'evt:123',
+  executionId: 'exec:456',
+  toolName: 'bash',
+  command: 'npm test',
+  exitCode: 0,
+  durationMs: 1200,
+});
+
+// 查询事件
+const events = db.listToolCallEvents('exec:456');
+
+// 项目统计
+const stats = db.getProjectStats('/path/to/project');
+```
+
+## Features
+
+- **SQLite + WAL 模式** — 高并发读写的本地持久化存储
+- **runs 表** — AI agent 执行运行记录
+- **tool_call_events 表** — 每次 tool 调用的详细事件（exitCode、stderr、output、durationMs）
+- **skill_executions 表** — skill 执行生命周期管理（start → running → completed/failed）
+- **project_stats 表** — 项目维度的聚合统计
+- **settings 表** — KV 配置存储
+
+## Tables
+
+| 表名 | 说明 |
+|------|------|
+| `runs` | Agent 运行记录（id、source、tool、status、token_used） |
+| `tool_call_events` | Tool 调用事件（event_id、execution_id、tool_name、command、exit_code、stderr、output、is_mcp_tool） |
+| `skill_executions` | Skill 执行记录（execution_id、skill_name、status、total_tool_calls、mcp_compliance_rate） |
+| `project_stats` | 项目聚合统计（total_runs、successful_runs、total_tokens） |
+| `settings` | KV 配置（key、value） |
+
+## API
+
+- `new DevFlowDatabase(projectRoot)` — 构造函数，自动创建 `.devflow/devflow.db` 并初始化 schema
+- `.insertToolCallEvent(data)` — 记录工具调用事件
+- `.updateToolCallEvent(eventId, updates)` — 更新事件（如回填 output）
+- `.listToolCallEvents(executionId)` — 列出某次执行的所有事件
+- `.insertSkillExecution(data)` — 创建 skill 执行记录
+- `.updateSkillExecution(id, data)` — 更新 skill 执行状态
+- `.getProjectStats(root)` — 获取项目统计
+- `.upsertProjectStats(root, data)` — 更新或插入项目统计
+- `.getSetting(key)` / `.setSetting(key, value)` — KV 配置读写
+
+## License
+
+MIT

package/dist/database.d.ts

@@ -15,8 +15,20 @@ export declare class DevFlowDatabase {
     setSetting(key: string, value: string): void;
     getSetting(key: string): string | null;
     deleteSetting(key: string): void;
+    insertSession(params: {
+        id: string;
+        projectRoot: string;
+        label?: string;
+        startedAt: number;
+    }): void;
+    getSession(id: string): any | null;
+    listSessions(limit: number, offset: number, projectRoot?: string): any[];
+    closeSession(id: string, finishedAt?: number): void;
+    listToolCallEventsBySession(sessionId: string): any[];
+    listToolCallEventsBySessions(sessionIds: string[]): Record<string, any[]>;
     insertSkillExecution(params: {
         executionId: string;
+        sessionId?: string;
         skillName: string;
         startedAt: number;
         status: string;
@@ -28,7 +40,6 @@ export declare class DevFlowDatabase {
         status?: string;
         finishedAt?: number;
         totalDuration?: number;
-        totalTokens?: number;
         mcpComplianceRate?: number;
         missedMcpTools?: string[];
         totalToolCalls?: number;
@@ -40,6 +51,7 @@ export declare class DevFlowDatabase {
     insertToolCallEvent(params: {
         eventId: string;
         executionId: string;
+        sessionId?: string;
         timestamp: number;
         toolName: string;
         toolType: string;
@@ -47,25 +59,67 @@ export declare class DevFlowDatabase {
         mcpToolName?: string;
         mcpEnforced: boolean;
         mcpFallback: boolean;
+        kind?: string;
         input: unknown;
         output?: unknown;
-        tokensUsed: number;
         duration: number;
         parentToolCallId?: string;
         subagentId?: string;
         error?: string;
         blocked: boolean;
         blockReason?: string;
+        workflowRunId?: string;
     }): void;
     listToolCallEvents(executionId: string): any[];
     updateToolCallEvent(eventId: string, updates: {
         output?: string;
         error?: string;
+        duration?: number;
     }): void;
     getMcpCompliance(): {
         overall: number;
         bySkill: Record<string, number>;
         missedTools: string[];
     };
+    cleanupStaleRecords(): void;
+    insertToolMetric(metric: {
+        id: string;
+        toolCallEventId: string;
+        sessionId: string;
+        toolName: string;
+        query?: string;
+        status?: string;
+        resultCount?: number;
+        resultSizeBytes?: number;
+        latencyMs?: number;
+        engine?: string;
+        accuracyQueryId?: string;
+        metadata?: string;
+        createdAt: number;
+    }): void;
+    getToolMetrics(sessionId?: string, toolName?: string, limit?: number, offset?: number): any[];
+    getToolMetricsSummary(days?: number): any[];
+    insertAccuracyQuery(q: {
+        id: string;
+        sessionId: string;
+        engine: string;
+        query: string;
+        topKResults: string;
+        selectedIds?: string;
+        createdAt: number;
+    }): void;
+    getAccuracyQueries(options: {
+        engine?: string;
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): any[];
+    updateAccuracyFeedback(id: string, feedback: {
+        relevance: 'hit' | 'partial' | 'miss';
+        note?: string;
+    }): void;
+    getAccuracyStats(engine?: string, since?: number): any;
+    all(sql: string, ...params: unknown[]): unknown[];
+    get(sql: string, ...params: unknown[]): unknown;
     close(): void;
 }