@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.
- package/CHANGELOG.md +12 -0
- package/DOCS.md +33 -6
- package/dist/deployment/adapter.d.ts +19 -12
- package/dist/deployment/adapter.js +13 -0
- package/dist/deployment/descriptor.d.ts +1 -1
- package/dist/deployment/descriptor.js +1 -1
- package/package.json +3 -3
- 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
|
-
|
|
3
|
+
## 模块定位与作用
|
|
4
|
+
|
|
5
|
+
以受控 CLI 执行 Task SQLite Schema 迁移，确保数据库版本升级可追踪、可重复且不会混入 Runtime 启动逻辑。
|
|
4
6
|
|
|
5
7
|
## 主要能力
|
|
6
8
|
|
|
7
|
-
-
|
|
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（结构版本）：当前数据库结构对应的有序版本号。
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
68
|
+
readonly moduleVersion: "0.1.10";
|
|
62
69
|
} | {
|
|
63
70
|
contract: "deployment.result.v1";
|
|
64
71
|
moduleRef: "task-migration-runner";
|
|
65
|
-
moduleVersion: "0.1.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
147
|
+
moduleVersion: "0.1.10";
|
|
141
148
|
data: {
|
|
142
149
|
migrated: boolean;
|
|
143
150
|
appliedVersions: number[];
|
|
@@ -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: [],
|
|
@@ -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.
|
|
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";
|
|
@@ -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.
|
|
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.
|
|
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.
|
|
27
|
-
"@tomflow/proflow-task-store-sqlite": "^0.1.
|
|
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.
|
|
6
|
+
"moduleVersion": "0.1.10",
|
|
7
7
|
"kind": "cli",
|
|
8
8
|
"templateVersion": "1.0.0",
|
|
9
9
|
"platformCompatibility": ">=1.0.0 <2.0.0",
|