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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/DOCS.md +33 -6
  3. package/dist/deployment/adapter.d.ts +19 -12
  4. package/dist/deployment/adapter.js +13 -0
  5. package/dist/deployment/descriptor.d.ts +1 -1
  6. package/dist/deployment/descriptor.js +1 -1
  7. package/package.json +3 -3
  8. package/proflow.module.json +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # @tomflow/proflow-task-migration-runner
2
2
 
3
+ ## 0.1.10
4
+
5
+ ### Patch Changes
6
+
7
+ - 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.
8
+
9
+ ## 0.1.9
10
+
11
+ ### Patch Changes
12
+
13
+ - Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
14
+
3
15
  ## 0.1.8
4
16
 
5
17
  ### Patch Changes
package/DOCS.md CHANGED
@@ -1,11 +1,38 @@
1
- # task-migration-runner
1
+ # task-migration-runner — Task 数据迁移工具
2
2
 
3
- Task Migration Runner（任务迁移工具）负责按顺序升级 Task Store（任务存储）的 SQLite 数据结构，并验证升级结果。
3
+ ## 模块定位与作用
4
+
5
+ 以受控 CLI 执行 Task SQLite Schema 迁移，确保数据库版本升级可追踪、可重复且不会混入 Runtime 启动逻辑。
4
6
 
5
7
  ## 主要能力
6
8
 
7
- - 发现尚未执行的 Migration（迁移）。
8
- - 在事务中执行升级，失败时回滚。
9
- - 记录版本并支持重复运行。
9
+ - 读取当前 Schema 版本并按顺序执行待应用迁移。
10
+ - 在事务中应用迁移，失败时停止并保留诊断信息。
11
+ - 报告已应用版本与最终状态。
12
+
13
+ ## 提供的 API 与 Public Contract
14
+
15
+ - 不提供跨 Module 逻辑 Contract。
16
+ - 提供 `proflow-task-migrate` CLI；返回强类型结果，不提供 `--json`。
17
+
18
+ ## 依赖的 Module、Contract 和外部资源
19
+
20
+ - 无上游 Module Contract 依赖。
21
+ - 依赖 Node.js、Task SQLite 文件和迁移资源。
22
+
23
+ ## 运行形态与生命周期
24
+
25
+ 类型为 CLI，按需运行后退出，没有常驻进程。
26
+
27
+ ## 使用方式
28
+
29
+ 部署或版本升级流程调用 `proflow-task-migrate`；执行前必须使用明确 Workspace 和数据库边界。
30
+
31
+ ## 职责边界与限制
32
+
33
+ 不承载 Task 业务服务、不自动猜测数据库位置，也不在失败后跳过迁移继续启动。
34
+
35
+ ## 术语
10
36
 
11
- 平台安装时会自动调用它；普通用户通常不需要手工执行。
37
+ - Migration（迁移）：把持久化结构从一个已知版本升级到下一版本的操作。
38
+ - Schema Version（结构版本）：当前数据库结构对应的有序版本号。
package/dist/deployment/adapter.d.ts CHANGED
@@ -4,7 +4,7 @@ export declare const behaviorAdapter: {
4
4
  result: {
5
5
  contract: "deployment.result.v1";
6
6
  moduleRef: "task-migration-runner";
7
- moduleVersion: "0.1.8";
7
+ moduleVersion: "0.1.10";
8
8
  ok: false;
9
9
  status: "FAILED";
10
10
  error: {
@@ -20,7 +20,7 @@ export declare const behaviorAdapter: {
20
20
  ok: true;
21
21
  status: "SUCCEEDED";
22
22
  moduleRef: "task-migration-runner";
23
- moduleVersion: "0.1.8";
23
+ moduleVersion: "0.1.10";
24
24
  data: {
25
25
  applied: number[];
26
26
  pending: number[];
@@ -34,7 +34,7 @@ export declare const behaviorAdapter: {
34
34
  readonly ok: true;
35
35
  readonly status: "SUCCEEDED";
36
36
  readonly moduleRef: "task-migration-runner";
37
- readonly moduleVersion: "0.1.8";
37
+ readonly moduleVersion: "0.1.10";
38
38
  };
39
39
  observedEffects: never[];
40
40
  }>;
@@ -44,10 +44,17 @@ export declare const behaviorAdapter: {
44
44
  ok: true;
45
45
  status: "SUCCEEDED";
46
46
  moduleRef: "task-migration-runner";
47
- moduleVersion: "0.1.8";
47
+ moduleVersion: "0.1.10";
48
48
  data: {
49
49
  setupStatus: "FAILED" | "READY";
50
50
  runtimeStatus: "NOT_APPLICABLE";
51
+ issues?: {
52
+ scope: "SETUP";
53
+ code: string;
54
+ message: string;
55
+ relatedModuleRefs: string[];
56
+ nextCommand: string;
57
+ }[];
51
58
  };
52
59
  };
53
60
  observedEffects: never[];
@@ -58,11 +65,11 @@ export declare const behaviorAdapter: {
58
65
  readonly ok: true;
59
66
  readonly status: "SUCCEEDED";
60
67
  readonly moduleRef: "task-migration-runner";
61
- readonly moduleVersion: "0.1.8";
68
+ readonly moduleVersion: "0.1.10";
62
69
  } | {
63
70
  contract: "deployment.result.v1";
64
71
  moduleRef: "task-migration-runner";
65
- moduleVersion: "0.1.8";
72
+ moduleVersion: "0.1.10";
66
73
  ok: false;
67
74
  status: "FAILED";
68
75
  error: {
@@ -79,7 +86,7 @@ export declare const behaviorAdapter: {
79
86
  ok: true;
80
87
  status: "SUCCEEDED";
81
88
  moduleRef: "task-migration-runner";
82
- moduleVersion: "0.1.8";
89
+ moduleVersion: "0.1.10";
83
90
  data: {
84
91
  docs: string;
85
92
  };
@@ -92,7 +99,7 @@ export declare const behaviorAdapter: {
92
99
  readonly ok: true;
93
100
  readonly status: "SUCCEEDED";
94
101
  readonly moduleRef: "task-migration-runner";
95
- readonly moduleVersion: "0.1.8";
102
+ readonly moduleVersion: "0.1.10";
96
103
  };
97
104
  observedEffects: never[];
98
105
  }>;
@@ -102,7 +109,7 @@ export declare const behaviorAdapter: {
102
109
  readonly ok: true;
103
110
  readonly status: "SUCCEEDED";
104
111
  readonly moduleRef: "task-migration-runner";
105
- readonly moduleVersion: "0.1.8";
112
+ readonly moduleVersion: "0.1.10";
106
113
  };
107
114
  observedEffects: never[];
108
115
  }>;
@@ -112,7 +119,7 @@ export declare const behaviorAdapter: {
112
119
  ok: true;
113
120
  status: "SUCCEEDED";
114
121
  moduleRef: "task-migration-runner";
115
- moduleVersion: "0.1.8";
122
+ moduleVersion: "0.1.10";
116
123
  data: {
117
124
  applied: number[];
118
125
  pending: number[];
@@ -120,7 +127,7 @@ export declare const behaviorAdapter: {
120
127
  } | {
121
128
  contract: "deployment.result.v1";
122
129
  moduleRef: "task-migration-runner";
123
- moduleVersion: "0.1.8";
130
+ moduleVersion: "0.1.10";
124
131
  ok: false;
125
132
  status: "FAILED";
126
133
  error: {
@@ -137,7 +144,7 @@ export declare const behaviorAdapter: {
137
144
  ok: true;
138
145
  status: "SUCCEEDED";
139
146
  moduleRef: "task-migration-runner";
140
- moduleVersion: "0.1.8";
147
+ moduleVersion: "0.1.10";
141
148
  data: {
142
149
  migrated: boolean;
143
150
  appliedVersions: number[];
package/dist/deployment/adapter.js CHANGED
@@ -66,6 +66,19 @@ export const behaviorAdapter = {
66
66
  data: {
67
67
  setupStatus: v.ok ? "READY" : "FAILED",
68
68
  runtimeStatus: "NOT_APPLICABLE",
69
+ ...(v.ok
70
+ ? {}
71
+ : {
72
+ issues: [
73
+ {
74
+ scope: "SETUP",
75
+ code: "MIGRATION_VERIFICATION_FAILED",
76
+ message: v.error?.message ?? "Task migration 状态验证失败",
77
+ relatedModuleRefs: ["task-store-sqlite"],
78
+ nextCommand: "platform setup --module task-migration-runner",
79
+ },
80
+ ],
81
+ }),
69
82
  },
70
83
  },
71
84
  observedEffects: [],
package/dist/deployment/descriptor.d.ts CHANGED
@@ -3,7 +3,7 @@ export declare const descriptor: {
3
3
  readonly contractVersion: "1.0.0";
4
4
  readonly moduleRef: "task-migration-runner";
5
5
  readonly packageName: "@tomflow/proflow-task-migration-runner";
6
- readonly moduleVersion: "0.1.8";
6
+ readonly moduleVersion: "0.1.10";
7
7
  readonly kind: "cli";
8
8
  readonly templateVersion: "1.0.0";
9
9
  readonly platformCompatibility: ">=1.0.0 <2.0.0";
package/dist/deployment/descriptor.js CHANGED
@@ -3,7 +3,7 @@ export const descriptor = {
3
3
  contractVersion: "1.0.0",
4
4
  moduleRef: "task-migration-runner",
5
5
  packageName: "@tomflow/proflow-task-migration-runner",
6
- moduleVersion: "0.1.8",
6
+ moduleVersion: "0.1.10",
7
7
  kind: "cli",
8
8
  templateVersion: "1.0.0",
9
9
  platformCompatibility: ">=1.0.0 <2.0.0",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tomflow/proflow-task-migration-runner",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -23,8 +23,8 @@
23
23
  "SETUP.md"
24
24
  ],
25
25
  "dependencies": {
26
- "@tomflow/proflow-module-contract": "^0.1.10",
27
- "@tomflow/proflow-task-store-sqlite": "^0.1.8"
26
+ "@tomflow/proflow-module-contract": "^0.1.12",
27
+ "@tomflow/proflow-task-store-sqlite": "^0.1.10"
28
28
  },
29
29
  "description": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
30
30
  "keywords": [
package/proflow.module.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "contractVersion": "1.0.0",
4
4
  "moduleRef": "task-migration-runner",
5
5
  "packageName": "@tomflow/proflow-task-migration-runner",
6
- "moduleVersion": "0.1.8",
6
+ "moduleVersion": "0.1.10",
7
7
  "kind": "cli",
8
8
  "templateVersion": "1.0.0",
9
9
  "platformCompatibility": ">=1.0.0 <2.0.0",