@tomflow/proflow-task-store-sqlite 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-task-store-sqlite
 
+## 0.1.10
+
+### Patch Changes
+
+- Distinguish dependency blocking from verified failure, expose Module-owned status diagnostics, remove automatic docs paging, consolidate start checks, add contextual help, and clarify uninstall output.
+
+## 0.1.9
+
+### Patch Changes
+
+- Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
+
 ## 0.1.8
 
 ### Patch Changes

package/DOCS.md

@@ -1,11 +1,39 @@
-# task-store-sqlite
+# task-store-sqlite — Task SQLite 存储
 
-Task Store SQLite（任务 SQLite 存储）为任务领域提供本机持久化，保存任务、节点、角色绑定、文档和幂等记录。
+## 模块定位与作用
 
-## 工作方式
+使用 Node 原生 SQLite 实现 Task 领域定义的 Repository 与事务端口，负责可靠保存任务、节点、文档和绑定事实。
 
-- 使用 SQLite 事务保证多项更新同时成功或同时失败。
-- 使用 WAL（预写日志）提高可靠性和并发读取能力。
-- 启动时检查数据库结构和完整性。
+## 主要能力
 
-数据库由模块维护，不建议直接编辑 `.proflow/state` 中的文件。
+- 提供 Schema 初始化、事务、Prepared Statement 和 WAL 配置。
+- 保存 Task 聚合、Node、TaskDocument 与 Role Binding。
+- 执行并发版本检查和原子写入，支持进程重启后的恢复。
+
+## 提供的 API 与 Public Contract
+
+- 不提供新的逻辑 Contract；实现 `task-orchestration` 中定义的持久化端口。
+- 只通过公开 Repository 接口访问，不公开内部 SQL 表作为跨域 API。
+
+## 依赖的 Module、Contract 和外部资源
+
+- 依赖 `task-orchestration`，兼容版本 `>=1.0.0 <2.0.0`。
+- 依赖 Node `node:sqlite` 与 Workspace 中受控的数据库路径。
+
+## 运行形态与生命周期
+
+类型为 Library，数据库连接由组合根管理，无独立服务进程。
+
+## 使用方式
+
+由 Platform Host 在启动时构造 Store 并注入 Task 应用服务；迁移通过专用 Migration Runner 执行。
+
+## 职责边界与限制
+
+不定义 Task 业务规则、不允许其他领域直接查询表，也不把 SQLite 文件路径作为用户配置。
+
+## 术语
+
+- Repository（仓储）：领域模型访问持久化的公开端口。
+- WAL（预写式日志）：SQLite 的并发与恢复日志模式。
+- Transaction（事务）：保证一组写入全部成功或全部撤销的边界。

package/dist/deployment/adapter.d.ts

@@ -7,7 +7,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-store-sqlite";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.10";
             data: {
                 databasePath: string;
             };
@@ -20,7 +20,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-store-sqlite";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.10";
         };
         observedEffects: never[];
     }>;
@@ -30,10 +30,17 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-store-sqlite";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.10";
             data: {
                 setupStatus: "FAILED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
+                issues?: {
+                    scope: "SETUP";
+                    code: string;
+                    message: string;
+                    relatedModuleRefs: string[];
+                    nextCommand: string;
+                }[];
             };
         };
         observedEffects: never[];
@@ -44,11 +51,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-store-sqlite";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.10";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-store-sqlite";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.10";
             ok: false;
             status: "FAILED";
             error: {
@@ -65,7 +72,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-store-sqlite";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.10";
             data: {
                 docs: string;
             };
@@ -78,7 +85,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-store-sqlite";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.10";
         };
         observedEffects: never[];
     }>;
@@ -88,7 +95,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-store-sqlite";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.10";
         };
         observedEffects: never[];
     }>;

package/dist/deployment/adapter.js

@@ -60,18 +60,32 @@ export const behaviorAdapter = {
         result: base,
         observedEffects: [],
     }),
-    status: async (context) => ({
-        result: {
-            ...base,
-            data: {
-                setupStatus: inspect(taskDatabasePath(context))
-                    ? "READY"
-                    : "FAILED",
-                runtimeStatus: "NOT_APPLICABLE",
+    status: async (context) => {
+        const ready = inspect(taskDatabasePath(context));
+        return {
+            result: {
+                ...base,
+                data: {
+                    setupStatus: ready ? "READY" : "FAILED",
+                    runtimeStatus: "NOT_APPLICABLE",
+                    ...(ready
+                        ? {}
+                        : {
+                            issues: [
+                                {
+                                    scope: "SETUP",
+                                    code: "TASK_SCHEMA_MISSING",
+                                    message: "Task SQLite schema 尚未正确初始化",
+                                    relatedModuleRefs: ["task-migration-runner"],
+                                    nextCommand: "platform setup --module task-migration-runner",
+                                },
+                            ],
+                        }),
+                },
             },
-        },
-        observedEffects: [],
-    }),
+            observedEffects: [],
+        };
+    },
     setup: async (context) => ({
         result: inspect(taskDatabasePath(context))
             ? base

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "task-store-sqlite";
     readonly packageName: "@tomflow/proflow-task-store-sqlite";
-    readonly moduleVersion: "0.1.8";
+    readonly moduleVersion: "0.1.10";
     readonly kind: "library";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

package/dist/deployment/descriptor.js

@@ -3,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "task-store-sqlite",
     packageName: "@tomflow/proflow-task-store-sqlite",
-    moduleVersion: "0.1.8",
+    moduleVersion: "0.1.10",
     kind: "library",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-store-sqlite",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,11 +20,11 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.10",
-    "@tomflow/proflow-task-orchestration": "^0.1.7"
+    "@tomflow/proflow-module-contract": "^0.1.12",
+    "@tomflow/proflow-task-orchestration": "^0.1.8"
   },
   "devDependencies": {
-    "@tomflow/proflow-task-migration-runner": "^0.1.8"
+    "@tomflow/proflow-task-migration-runner": "^0.1.10"
   },
   "description": "Provides the node:sqlite store and repository adapters for Task-owned structured facts.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-store-sqlite",
 	"packageName": "@tomflow/proflow-task-store-sqlite",
-	"moduleVersion": "0.1.8",
+	"moduleVersion": "0.1.10",
 	"kind": "library",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",