@devflow-tools/database 0.17.4 → 0.17.6

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.17.6](https://github.com/shilongfeicool/dev-flow/compare/v0.17.5...v0.17.6) (2026-08-04)
+
+**Note:** Version bump only for package @devflow-tools/database
+
+
+
+
+
 ## [0.17.4](https://github.com/shilongfeicool/dev-flow/compare/v0.17.3...v0.17.4) (2026-08-04)
 
 

package/README.md

@@ -1,67 +1,43 @@
 # @devflow-tools/database
 
-DevFlow 数据库层 — 基于 better-sqlite3 的 SQLite + WAL 模式持久化存储，管理 runs、tool call events、skill executions、project stats 和 settings。
+> 基于 better-sqlite3 的本地 SQLite/WAL 持久化层，承载运行、检索、记忆和遥测记录。（v0.17.6）
 
-## Installation
+[![npm version](https://img.shields.io/npm/v/%40devflow-tools%2Fdatabase.svg)](https://www.npmjs.com/package/@devflow-tools/database)
+
+## 安装
 
 ```bash
 npm install @devflow-tools/database
 ```
 
-## Usage
+## 快速开始
 
 ```typescript
 import { DevFlowDatabase } from '@devflow-tools/database';
 
-const db = new DevFlowDatabase('/path/to/project');
+const db = new DevFlowDatabase(process.cwd());
+console.log(db);
+```
+
+## 公共 API / 命令
 
-// 记录 tool call 事件
-db.insertToolCallEvent({
-  eventId: 'evt:123',
-  executionId: 'exec:456',
-  toolName: 'bash',
-  command: 'npm test',
-  exitCode: 0,
-  durationMs: 1200,
-});
+`DevFlowDatabase`、`openGlobalDevFlowDatabase`、`openGlobalDevFlowReadOnlyDatabase` 及 task runtime、work queue、retrieval ledger、workflow worker 类型/映射器。
 
-// 查询事件
-const events = db.listToolCallEvents('exec:456');
 
-// 项目统计
-const stats = db.getProjectStats('/path/to/project');
-```
+## 配置与运行时
+
+需要 Node.js 原生 better-sqlite3 能力；数据库文件默认位于项目 `.devflow/` 目录或全局 DevFlow 数据目录。
+
+## 版本与兼容性
+
+- 当前包版本：`0.17.6`
+- Node.js：未在 package manifest 声明更高版本时，使用 Node.js 18+；原生 SQLite/Playwright 能力请按对应依赖安装
+- workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致
+
+## 相关链接
 
-## 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 配置读写
+- [DevFlow 仓库](https://github.com/shilongfeicool/dev-flow)
+- [问题反馈](https://github.com/shilongfeicool/dev-flow/issues)
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/database",
-  "version": "0.17.4",
+  "version": "0.17.6",
   "description": "DevFlow SQLite database package",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,5 +13,5 @@
     "typescript": "^5.5.0",
     "vitest": "^2.0.0"
   },
-  "gitHead": "b880054f9cef4ed62b4d02544257c9f5cbd811bc"
+  "gitHead": "669fea3aa72aa3fde14ed50d24c1fec4dfac088f"
 }