@tomflow/proflow-task-migration-runner 0.1.2 → 0.1.3

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.
@@ -0,0 +1,23 @@
1
+ # task-migration-runner configuration
2
+
3
+ Canonical public config: `.proflow/config/task-migration-runner.json`
4
+
5
+ This file is Workspace-owned data. `platform uninstall` does not delete it. Values are JSON strings. Raw secrets must not be stored here; `secretRef` fields contain opaque references only.
6
+
7
+ ## Fields
8
+
9
+ | Key | Type | Required | Sensitive | Source | Meaning |
10
+ |---|---|---:|---:|---|---|
11
+ | `databasePath` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Task SQLite database path |
12
+
13
+ ## Materialize
14
+
15
+ Create or update the canonical JSON object at:
16
+
17
+ `.proflow/config/task-migration-runner.json`
18
+
19
+ Use only declared keys and string values. Do not create a second Platform configuration database.
20
+
21
+ ## Base completion check
22
+
23
+ Run `platform modules`. This Module should no longer report required keys in `missingConfig`. `platform start` performs the authoritative Module-owned validation before starting anything.
@@ -3,7 +3,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
3
3
  result: {
4
4
  contract: "deployment.result.v1";
5
5
  moduleRef: "task-migration-runner";
6
- moduleVersion: "0.1.2";
6
+ moduleVersion: "0.1.3";
7
7
  ok: boolean;
8
8
  status: "SUCCEEDED";
9
9
  data?: {} | null;
@@ -15,7 +15,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
15
15
  result: {
16
16
  contract: "deployment.result.v1";
17
17
  moduleRef: "task-migration-runner";
18
- moduleVersion: "0.1.2";
18
+ moduleVersion: "0.1.3";
19
19
  ok: boolean;
20
20
  status: "SUCCEEDED";
21
21
  data?: {} | null;
@@ -23,7 +23,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
23
23
  } | {
24
24
  contract: "deployment.result.v1";
25
25
  moduleRef: "task-migration-runner";
26
- moduleVersion: "0.1.2";
26
+ moduleVersion: "0.1.3";
27
27
  ok: boolean;
28
28
  status: "ACTION_REQUIRED";
29
29
  actionRequired: {
@@ -39,23 +39,11 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
39
39
  result: {
40
40
  contract: "deployment.result.v1";
41
41
  moduleRef: "task-migration-runner";
42
- moduleVersion: "0.1.2";
42
+ moduleVersion: "0.1.3";
43
43
  ok: boolean;
44
44
  status: "SUCCEEDED";
45
45
  data?: {} | null;
46
46
  checks?: unknown[];
47
- } | {
48
- contract: "deployment.result.v1";
49
- moduleRef: "task-migration-runner";
50
- moduleVersion: "0.1.2";
51
- ok: boolean;
52
- status: "ACTION_REQUIRED";
53
- actionRequired: {
54
- action: string;
55
- description: string;
56
- };
57
- data?: {} | null;
58
- checks?: unknown[];
59
47
  };
60
48
  observedEffects: never[];
61
49
  };
@@ -63,7 +51,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
63
51
  result: {
64
52
  contract: "deployment.result.v1";
65
53
  moduleRef: "task-migration-runner";
66
- moduleVersion: "0.1.2";
54
+ moduleVersion: "0.1.3";
67
55
  ok: boolean;
68
56
  status: "ACTION_REQUIRED";
69
57
  actionRequired: {
@@ -78,7 +66,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
78
66
  result: {
79
67
  contract: "deployment.result.v1";
80
68
  moduleRef: "task-migration-runner";
81
- moduleVersion: "0.1.2";
69
+ moduleVersion: "0.1.3";
82
70
  ok: boolean;
83
71
  status: "SUCCEEDED";
84
72
  data?: {} | null;
@@ -86,7 +74,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
86
74
  } | {
87
75
  contract: "deployment.result.v1";
88
76
  moduleRef: "task-migration-runner";
89
- moduleVersion: "0.1.2";
77
+ moduleVersion: "0.1.3";
90
78
  ok: boolean;
91
79
  status: "FAILED";
92
80
  error: {
@@ -103,7 +91,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
103
91
  result: {
104
92
  contract: "deployment.result.v1";
105
93
  moduleRef: "task-migration-runner";
106
- moduleVersion: "0.1.2";
94
+ moduleVersion: "0.1.3";
107
95
  ok: boolean;
108
96
  status: "ACTION_REQUIRED";
109
97
  actionRequired: {
@@ -118,7 +106,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
118
106
  result: {
119
107
  contract: "deployment.result.v1";
120
108
  moduleRef: "task-migration-runner";
121
- moduleVersion: "0.1.2";
109
+ moduleVersion: "0.1.3";
122
110
  ok: boolean;
123
111
  status: "SUCCEEDED";
124
112
  data?: {} | null;
@@ -126,7 +114,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
126
114
  } | {
127
115
  contract: "deployment.result.v1";
128
116
  moduleRef: "task-migration-runner";
129
- moduleVersion: "0.1.2";
117
+ moduleVersion: "0.1.3";
130
118
  ok: boolean;
131
119
  status: "BLOCKED";
132
120
  error: {
@@ -142,7 +130,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
142
130
  result: {
143
131
  contract: "deployment.result.v1";
144
132
  moduleRef: "task-migration-runner";
145
- moduleVersion: "0.1.2";
133
+ moduleVersion: "0.1.3";
146
134
  ok: boolean;
147
135
  status: "ACTION_REQUIRED";
148
136
  actionRequired: {
@@ -157,7 +145,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
157
145
  result: {
158
146
  contract: "deployment.result.v1";
159
147
  moduleRef: "task-migration-runner";
160
- moduleVersion: "0.1.2";
148
+ moduleVersion: "0.1.3";
161
149
  ok: boolean;
162
150
  status: "SUCCEEDED";
163
151
  data?: {} | null;
@@ -165,7 +153,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
165
153
  } | {
166
154
  contract: "deployment.result.v1";
167
155
  moduleRef: "task-migration-runner";
168
- moduleVersion: "0.1.2";
156
+ moduleVersion: "0.1.3";
169
157
  ok: boolean;
170
158
  status: "FAILED";
171
159
  error: {
@@ -184,7 +172,7 @@ export declare const behaviorAdapter: {
184
172
  result: {
185
173
  contract: "deployment.result.v1";
186
174
  moduleRef: "task-migration-runner";
187
- moduleVersion: "0.1.2";
175
+ moduleVersion: "0.1.3";
188
176
  ok: boolean;
189
177
  status: "SUCCEEDED";
190
178
  data?: {} | null;
@@ -196,7 +184,7 @@ export declare const behaviorAdapter: {
196
184
  result: {
197
185
  contract: "deployment.result.v1";
198
186
  moduleRef: "task-migration-runner";
199
- moduleVersion: "0.1.2";
187
+ moduleVersion: "0.1.3";
200
188
  ok: boolean;
201
189
  status: "SUCCEEDED";
202
190
  data?: {} | null;
@@ -204,7 +192,7 @@ export declare const behaviorAdapter: {
204
192
  } | {
205
193
  contract: "deployment.result.v1";
206
194
  moduleRef: "task-migration-runner";
207
- moduleVersion: "0.1.2";
195
+ moduleVersion: "0.1.3";
208
196
  ok: boolean;
209
197
  status: "ACTION_REQUIRED";
210
198
  actionRequired: {
@@ -220,23 +208,11 @@ export declare const behaviorAdapter: {
220
208
  result: {
221
209
  contract: "deployment.result.v1";
222
210
  moduleRef: "task-migration-runner";
223
- moduleVersion: "0.1.2";
211
+ moduleVersion: "0.1.3";
224
212
  ok: boolean;
225
213
  status: "SUCCEEDED";
226
214
  data?: {} | null;
227
215
  checks?: unknown[];
228
- } | {
229
- contract: "deployment.result.v1";
230
- moduleRef: "task-migration-runner";
231
- moduleVersion: "0.1.2";
232
- ok: boolean;
233
- status: "ACTION_REQUIRED";
234
- actionRequired: {
235
- action: string;
236
- description: string;
237
- };
238
- data?: {} | null;
239
- checks?: unknown[];
240
216
  };
241
217
  observedEffects: never[];
242
218
  };
@@ -244,7 +220,7 @@ export declare const behaviorAdapter: {
244
220
  result: {
245
221
  contract: "deployment.result.v1";
246
222
  moduleRef: "task-migration-runner";
247
- moduleVersion: "0.1.2";
223
+ moduleVersion: "0.1.3";
248
224
  ok: boolean;
249
225
  status: "ACTION_REQUIRED";
250
226
  actionRequired: {
@@ -259,7 +235,7 @@ export declare const behaviorAdapter: {
259
235
  result: {
260
236
  contract: "deployment.result.v1";
261
237
  moduleRef: "task-migration-runner";
262
- moduleVersion: "0.1.2";
238
+ moduleVersion: "0.1.3";
263
239
  ok: boolean;
264
240
  status: "SUCCEEDED";
265
241
  data?: {} | null;
@@ -267,7 +243,7 @@ export declare const behaviorAdapter: {
267
243
  } | {
268
244
  contract: "deployment.result.v1";
269
245
  moduleRef: "task-migration-runner";
270
- moduleVersion: "0.1.2";
246
+ moduleVersion: "0.1.3";
271
247
  ok: boolean;
272
248
  status: "FAILED";
273
249
  error: {
@@ -284,7 +260,7 @@ export declare const behaviorAdapter: {
284
260
  result: {
285
261
  contract: "deployment.result.v1";
286
262
  moduleRef: "task-migration-runner";
287
- moduleVersion: "0.1.2";
263
+ moduleVersion: "0.1.3";
288
264
  ok: boolean;
289
265
  status: "ACTION_REQUIRED";
290
266
  actionRequired: {
@@ -299,7 +275,7 @@ export declare const behaviorAdapter: {
299
275
  result: {
300
276
  contract: "deployment.result.v1";
301
277
  moduleRef: "task-migration-runner";
302
- moduleVersion: "0.1.2";
278
+ moduleVersion: "0.1.3";
303
279
  ok: boolean;
304
280
  status: "SUCCEEDED";
305
281
  data?: {} | null;
@@ -307,7 +283,7 @@ export declare const behaviorAdapter: {
307
283
  } | {
308
284
  contract: "deployment.result.v1";
309
285
  moduleRef: "task-migration-runner";
310
- moduleVersion: "0.1.2";
286
+ moduleVersion: "0.1.3";
311
287
  ok: boolean;
312
288
  status: "BLOCKED";
313
289
  error: {
@@ -323,7 +299,7 @@ export declare const behaviorAdapter: {
323
299
  result: {
324
300
  contract: "deployment.result.v1";
325
301
  moduleRef: "task-migration-runner";
326
- moduleVersion: "0.1.2";
302
+ moduleVersion: "0.1.3";
327
303
  ok: boolean;
328
304
  status: "ACTION_REQUIRED";
329
305
  actionRequired: {
@@ -338,7 +314,7 @@ export declare const behaviorAdapter: {
338
314
  result: {
339
315
  contract: "deployment.result.v1";
340
316
  moduleRef: "task-migration-runner";
341
- moduleVersion: "0.1.2";
317
+ moduleVersion: "0.1.3";
342
318
  ok: boolean;
343
319
  status: "SUCCEEDED";
344
320
  data?: {} | null;
@@ -346,7 +322,7 @@ export declare const behaviorAdapter: {
346
322
  } | {
347
323
  contract: "deployment.result.v1";
348
324
  moduleRef: "task-migration-runner";
349
- moduleVersion: "0.1.2";
325
+ moduleVersion: "0.1.3";
350
326
  ok: boolean;
351
327
  status: "FAILED";
352
328
  error: {
@@ -1,3 +1,4 @@
1
+ import { observeDeclaredModuleStatus } from "@tomflow/proflow-module-contract";
1
2
  import { taskMigrations } from "@tomflow/proflow-task-store-sqlite/migrations";
2
3
  import { applyMigrations, getMigrationStatus, verifyMigrations, } from "../src/index.js";
3
4
  import { descriptor } from "./descriptor.js";
@@ -68,15 +69,10 @@ export function createBehaviorAdapter(config = {}) {
68
69
  : success(),
69
70
  observedEffects: [],
70
71
  }),
71
- status: () => {
72
- const data = statusData(config);
73
- return {
74
- result: data === undefined
75
- ? actionRequired("databasePath is required for Task migration status")
76
- : success(data),
77
- observedEffects: [],
78
- };
79
- },
72
+ status: () => ({
73
+ result: success(observeDeclaredModuleStatus(descriptor, config, "STOPPED")),
74
+ observedEffects: [],
75
+ }),
80
76
  verify: () => {
81
77
  const input = migrationInput(config);
82
78
  if (input === undefined) {
@@ -3,11 +3,10 @@ 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.2";
6
+ readonly moduleVersion: "0.1.3";
7
7
  readonly kind: "cli";
8
8
  readonly templateVersion: "1.0.0";
9
9
  readonly platformCompatibility: ">=1.0.0 <2.0.0";
10
- readonly installClass: "core";
11
10
  readonly identity: {
12
11
  readonly domain: "task-orchestration";
13
12
  readonly summary: "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.";
@@ -44,5 +43,9 @@ export declare const descriptor: {
44
43
  readonly id: "overview";
45
44
  readonly path: "./README.md";
46
45
  readonly description: "Package-owned module overview";
46
+ }, {
47
+ readonly id: "configuration";
48
+ readonly path: "./CONFIGURATION.md";
49
+ readonly description: "Module configuration fields, sources and materialization instructions";
47
50
  }];
48
51
  };
@@ -3,11 +3,10 @@ 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.2",
6
+ moduleVersion: "0.1.3",
7
7
  kind: "cli",
8
8
  templateVersion: "1.0.0",
9
9
  platformCompatibility: ">=1.0.0 <2.0.0",
10
- installClass: "core",
11
10
  identity: {
12
11
  domain: "task-orchestration",
13
12
  summary: "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
@@ -15,7 +14,11 @@ export const descriptor = {
15
14
  provides: [],
16
15
  requires: [],
17
16
  requirements: [
18
- { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
17
+ {
18
+ kind: "runtime",
19
+ runtime: "node",
20
+ versionRange: ">=24.19.0",
21
+ },
19
22
  ],
20
23
  configSlots: [
21
24
  {
@@ -57,5 +60,10 @@ export const descriptor = {
57
60
  path: "./README.md",
58
61
  description: "Package-owned module overview",
59
62
  },
63
+ {
64
+ id: "configuration",
65
+ path: "./CONFIGURATION.md",
66
+ description: "Module configuration fields, sources and materialization instructions",
67
+ },
60
68
  ],
61
69
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tomflow/proflow-task-migration-runner",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -12,19 +12,18 @@
12
12
  "./deployment/descriptor": "./dist/deployment/descriptor.js"
13
13
  },
14
14
  "bin": {
15
- "proflow-task-migrate": "./dist/src/cli.js",
16
- "proflow-task-migration-runner": "./self-install.mjs"
15
+ "proflow-task-migrate": "./dist/src/cli.js"
17
16
  },
18
17
  "files": [
19
18
  "dist",
20
19
  "proflow.module.json",
21
20
  "conformance.json",
22
21
  "README.md",
23
- "self-install.mjs"
22
+ "CONFIGURATION.md"
24
23
  ],
25
24
  "dependencies": {
26
- "@tomflow/proflow-task-store-sqlite": "^0.1.2",
27
- "@tomflow/proflow-module-contract": "^0.1.1"
25
+ "@tomflow/proflow-task-store-sqlite": "^0.1.3",
26
+ "@tomflow/proflow-module-contract": "^0.1.2"
28
27
  },
29
28
  "description": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
30
29
  "keywords": [
@@ -34,11 +33,6 @@
34
33
  ],
35
34
  "proflow": {
36
35
  "module": true,
37
- "installClass": "core",
38
- "installRequires": [
39
- "@tomflow/proflow-module-contract",
40
- "@tomflow/proflow-task-store-sqlite"
41
- ],
42
36
  "descriptor": "./dist/deployment/descriptor.js",
43
37
  "manifest": "./proflow.module.json"
44
38
  },
@@ -3,11 +3,10 @@
3
3
  "contractVersion": "1.0.0",
4
4
  "moduleRef": "task-migration-runner",
5
5
  "packageName": "@tomflow/proflow-task-migration-runner",
6
- "moduleVersion": "0.1.2",
6
+ "moduleVersion": "0.1.3",
7
7
  "kind": "cli",
8
8
  "templateVersion": "1.0.0",
9
9
  "platformCompatibility": ">=1.0.0 <2.0.0",
10
- "installClass": "core",
11
10
  "identity": {
12
11
  "domain": "task-orchestration",
13
12
  "summary": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations."
@@ -60,6 +59,11 @@
60
59
  "id": "overview",
61
60
  "path": "./README.md",
62
61
  "description": "Package-owned module overview"
62
+ },
63
+ {
64
+ "id": "configuration",
65
+ "path": "./CONFIGURATION.md",
66
+ "description": "Module configuration fields, sources and materialization instructions"
63
67
  }
64
68
  ]
65
69
  }
package/CHANGELOG.md DELETED
@@ -1,13 +0,0 @@
1
- # @tomflow/proflow-task-migration-runner
2
-
3
- ## 0.1.2
4
-
5
- ### Patch Changes
6
-
7
- - Real-1 final remediation and black-box release closure
8
-
9
- ## 0.1.1
10
-
11
- ### Patch Changes
12
-
13
- - Close the Real-1 global Platform control-plane contract across every published ProFlow package. Platform CLI now owns one durable global Workspace binding with canonical identity, cross-process operation locking, cwd/`--workspace` install targeting, cross-directory instance commands, whole-instance uninstall/rebind, and deterministic npm/yarn/pnpm Workspace package-manager selection. Every package-owned install entry, including newly generated Module Template packages, delegates to the Shell-global `platform` command and fails closed when that global CLI is unavailable; Deployment Conformance and the formal test plans mechanically enforce the same rule across all 24 packages.
package/self-install.mjs DELETED
@@ -1,34 +0,0 @@
1
- #!/usr/bin/env node
2
- import { spawnSync } from "node:child_process";
3
-
4
- const [command, ...rest] = process.argv.slice(2);
5
- const usage = "Usage: npx @tomflow/proflow-task-migration-runner install\n";
6
- if (command === "--help" || command === "-h") {
7
- process.stdout.write(usage);
8
- process.exit(0);
9
- }
10
- if (command !== "install" || rest.length > 0) {
11
- process.stderr.write(usage);
12
- process.exit(2);
13
- }
14
- const executable = process.platform === "win32" ? "platform.cmd" : "platform";
15
- const result = spawnSync(
16
- executable,
17
- [
18
- "install",
19
- "@tomflow/proflow-task-migration-runner",
20
- "--workspace",
21
- process.cwd(),
22
- ],
23
- { cwd: process.cwd(), env: process.env, stdio: "inherit" },
24
- );
25
- if (result.error) {
26
- if (result.error.code === "ENOENT") {
27
- process.stderr.write(
28
- "GLOBAL_PLATFORM_CLI_REQUIRED: install @tomflow/proflow-platform-cli globally before package-owned install\n",
29
- );
30
- process.exit(127);
31
- }
32
- throw result.error;
33
- }
34
- process.exit(result.status ?? 1);