@tomflow/proflow-task-migration-runner 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-task-migration-runner
 
+## 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,38 @@
-# task-migration-runner
+# task-migration-runner — Task 数据迁移工具
 
-Task Migration Runner（任务迁移工具）负责按顺序升级 Task Store（任务存储）的 SQLite 数据结构，并验证升级结果。
+## 模块定位与作用
+
+以受控 CLI 执行 Task SQLite Schema 迁移，确保数据库版本升级可追踪、可重复且不会混入 Runtime 启动逻辑。
 
 ## 主要能力
 
-- 发现尚未执行的 Migration（迁移）。
-- 在事务中执行升级，失败时回滚。
-- 记录版本并支持重复运行。
+- 读取当前 Schema 版本并按顺序执行待应用迁移。
+- 在事务中应用迁移，失败时停止并保留诊断信息。
+- 报告已应用版本与最终状态。
+
+## 提供的 API 与 Public Contract
+
+- 不提供跨 Module 逻辑 Contract。
+- 提供 `proflow-task-migrate` CLI；返回强类型结果，不提供 `--json`。
+
+## 依赖的 Module、Contract 和外部资源
+
+- 无上游 Module Contract 依赖。
+- 依赖 Node.js、Task SQLite 文件和迁移资源。
+
+## 运行形态与生命周期
+
+类型为 CLI，按需运行后退出，没有常驻进程。
+
+## 使用方式
+
+部署或版本升级流程调用 `proflow-task-migrate`；执行前必须使用明确 Workspace 和数据库边界。
+
+## 职责边界与限制
+
+不承载 Task 业务服务、不自动猜测数据库位置，也不在失败后跳过迁移继续启动。
+
+## 术语
 
-平台安装时会自动调用它；普通用户通常不需要手工执行。
+- Migration（迁移）：把持久化结构从一个已知版本升级到下一版本的操作。
+- Schema Version（结构版本）：当前数据库结构对应的有序版本号。

package/dist/deployment/adapter.d.ts

@@ -4,7 +4,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             ok: false;
             status: "FAILED";
             error: {
@@ -20,7 +20,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             data: {
                 applied: number[];
                 pending: number[];
@@ -34,7 +34,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.9";
         };
         observedEffects: never[];
     }>;
@@ -44,7 +44,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             data: {
                 setupStatus: "FAILED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -58,11 +58,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.9";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             ok: false;
             status: "FAILED";
             error: {
@@ -79,7 +79,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             data: {
                 docs: string;
             };
@@ -92,7 +92,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.9";
         };
         observedEffects: never[];
     }>;
@@ -102,7 +102,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.8";
+            readonly moduleVersion: "0.1.9";
         };
         observedEffects: never[];
     }>;
@@ -112,7 +112,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             data: {
                 applied: number[];
                 pending: number[];
@@ -120,7 +120,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             ok: false;
             status: "FAILED";
             error: {
@@ -137,7 +137,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.8";
+            moduleVersion: "0.1.9";
             data: {
                 migrated: boolean;
                 appliedVersions: number[];

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "task-migration-runner";
     readonly packageName: "@tomflow/proflow-task-migration-runner";
-    readonly moduleVersion: "0.1.8";
+    readonly moduleVersion: "0.1.9";
     readonly kind: "cli";
     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-migration-runner",
     packageName: "@tomflow/proflow-task-migration-runner",
-    moduleVersion: "0.1.8",
+    moduleVersion: "0.1.9",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-migration-runner",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -23,8 +23,8 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.10",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.8"
+    "@tomflow/proflow-module-contract": "^0.1.11",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.9"
   },
   "description": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-migration-runner",
 	"packageName": "@tomflow/proflow-task-migration-runner",
-	"moduleVersion": "0.1.8",
+	"moduleVersion": "0.1.9",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",