@tomflow/proflow-task-store-sqlite 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-store-sqlite configuration
2
+
3
+ Canonical public config: `.proflow/config/task-store-sqlite.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-store-sqlite.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.
@@ -5,7 +5,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
5
5
  ok: boolean;
6
6
  status: "SUCCEEDED";
7
7
  moduleRef: "task-store-sqlite";
8
- moduleVersion: "0.1.2";
8
+ moduleVersion: "0.1.3";
9
9
  checks?: unknown[];
10
10
  };
11
11
  observedEffects: never[];
@@ -16,14 +16,14 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
16
16
  ok: boolean;
17
17
  status: "SUCCEEDED";
18
18
  moduleRef: "task-store-sqlite";
19
- moduleVersion: "0.1.2";
19
+ moduleVersion: "0.1.3";
20
20
  checks?: unknown[];
21
21
  } | {
22
22
  contract: "deployment.result.v1";
23
23
  ok: boolean;
24
24
  status: "ACTION_REQUIRED";
25
25
  moduleRef: "task-store-sqlite";
26
- moduleVersion: "0.1.2";
26
+ moduleVersion: "0.1.3";
27
27
  actionRequired: {
28
28
  action: string;
29
29
  description: string;
@@ -34,7 +34,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
34
34
  ok: boolean;
35
35
  status: "BLOCKED";
36
36
  moduleRef: "task-store-sqlite";
37
- moduleVersion: "0.1.2";
37
+ moduleVersion: "0.1.3";
38
38
  error: {
39
39
  code: "VERIFY_FAILED";
40
40
  message: string;
@@ -44,20 +44,51 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
44
44
  };
45
45
  observedEffects: never[];
46
46
  };
47
+ status: () => {
48
+ result: {
49
+ contract: "deployment.result.v1";
50
+ ok: boolean;
51
+ status: "SUCCEEDED";
52
+ moduleRef: "task-store-sqlite";
53
+ moduleVersion: "0.1.3";
54
+ checks?: unknown[];
55
+ data: {
56
+ configStatus: "INCOMPLETE";
57
+ missingConfig: string[];
58
+ runtimeStatus: "UNKNOWN";
59
+ };
60
+ };
61
+ observedEffects: never[];
62
+ } | {
63
+ result: {
64
+ contract: "deployment.result.v1";
65
+ ok: boolean;
66
+ status: "SUCCEEDED";
67
+ moduleRef: "task-store-sqlite";
68
+ moduleVersion: "0.1.3";
69
+ checks?: unknown[];
70
+ data: {
71
+ missingConfig?: never;
72
+ configStatus: "INVALID" | "READY";
73
+ runtimeStatus: "UNKNOWN";
74
+ };
75
+ };
76
+ observedEffects: never[];
77
+ };
47
78
  verify: () => {
48
79
  result: {
49
80
  contract: "deployment.result.v1";
50
81
  ok: boolean;
51
82
  status: "SUCCEEDED";
52
83
  moduleRef: "task-store-sqlite";
53
- moduleVersion: "0.1.2";
84
+ moduleVersion: "0.1.3";
54
85
  checks?: unknown[];
55
86
  } | {
56
87
  contract: "deployment.result.v1";
57
88
  ok: boolean;
58
89
  status: "ACTION_REQUIRED";
59
90
  moduleRef: "task-store-sqlite";
60
- moduleVersion: "0.1.2";
91
+ moduleVersion: "0.1.3";
61
92
  actionRequired: {
62
93
  action: string;
63
94
  description: string;
@@ -68,7 +99,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
68
99
  ok: boolean;
69
100
  status: "BLOCKED";
70
101
  moduleRef: "task-store-sqlite";
71
- moduleVersion: "0.1.2";
102
+ moduleVersion: "0.1.3";
72
103
  error: {
73
104
  code: "VERIFY_FAILED";
74
105
  message: string;
@@ -84,14 +115,14 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
84
115
  ok: boolean;
85
116
  status: "SUCCEEDED";
86
117
  moduleRef: "task-store-sqlite";
87
- moduleVersion: "0.1.2";
118
+ moduleVersion: "0.1.3";
88
119
  checks?: unknown[];
89
120
  } | {
90
121
  contract: "deployment.result.v1";
91
122
  ok: boolean;
92
123
  status: "ACTION_REQUIRED";
93
124
  moduleRef: "task-store-sqlite";
94
- moduleVersion: "0.1.2";
125
+ moduleVersion: "0.1.3";
95
126
  actionRequired: {
96
127
  action: string;
97
128
  description: string;
@@ -102,7 +133,7 @@ export declare function createBehaviorAdapter(config?: Record<string, string>):
102
133
  ok: boolean;
103
134
  status: "BLOCKED";
104
135
  moduleRef: "task-store-sqlite";
105
- moduleVersion: "0.1.2";
136
+ moduleVersion: "0.1.3";
106
137
  error: {
107
138
  code: "VERIFY_FAILED";
108
139
  message: string;
@@ -120,7 +151,7 @@ export declare const behaviorAdapter: {
120
151
  ok: boolean;
121
152
  status: "SUCCEEDED";
122
153
  moduleRef: "task-store-sqlite";
123
- moduleVersion: "0.1.2";
154
+ moduleVersion: "0.1.3";
124
155
  checks?: unknown[];
125
156
  };
126
157
  observedEffects: never[];
@@ -131,14 +162,14 @@ export declare const behaviorAdapter: {
131
162
  ok: boolean;
132
163
  status: "SUCCEEDED";
133
164
  moduleRef: "task-store-sqlite";
134
- moduleVersion: "0.1.2";
165
+ moduleVersion: "0.1.3";
135
166
  checks?: unknown[];
136
167
  } | {
137
168
  contract: "deployment.result.v1";
138
169
  ok: boolean;
139
170
  status: "ACTION_REQUIRED";
140
171
  moduleRef: "task-store-sqlite";
141
- moduleVersion: "0.1.2";
172
+ moduleVersion: "0.1.3";
142
173
  actionRequired: {
143
174
  action: string;
144
175
  description: string;
@@ -149,7 +180,7 @@ export declare const behaviorAdapter: {
149
180
  ok: boolean;
150
181
  status: "BLOCKED";
151
182
  moduleRef: "task-store-sqlite";
152
- moduleVersion: "0.1.2";
183
+ moduleVersion: "0.1.3";
153
184
  error: {
154
185
  code: "VERIFY_FAILED";
155
186
  message: string;
@@ -159,20 +190,51 @@ export declare const behaviorAdapter: {
159
190
  };
160
191
  observedEffects: never[];
161
192
  };
193
+ status: () => {
194
+ result: {
195
+ contract: "deployment.result.v1";
196
+ ok: boolean;
197
+ status: "SUCCEEDED";
198
+ moduleRef: "task-store-sqlite";
199
+ moduleVersion: "0.1.3";
200
+ checks?: unknown[];
201
+ data: {
202
+ configStatus: "INCOMPLETE";
203
+ missingConfig: string[];
204
+ runtimeStatus: "UNKNOWN";
205
+ };
206
+ };
207
+ observedEffects: never[];
208
+ } | {
209
+ result: {
210
+ contract: "deployment.result.v1";
211
+ ok: boolean;
212
+ status: "SUCCEEDED";
213
+ moduleRef: "task-store-sqlite";
214
+ moduleVersion: "0.1.3";
215
+ checks?: unknown[];
216
+ data: {
217
+ missingConfig?: never;
218
+ configStatus: "INVALID" | "READY";
219
+ runtimeStatus: "UNKNOWN";
220
+ };
221
+ };
222
+ observedEffects: never[];
223
+ };
162
224
  verify: () => {
163
225
  result: {
164
226
  contract: "deployment.result.v1";
165
227
  ok: boolean;
166
228
  status: "SUCCEEDED";
167
229
  moduleRef: "task-store-sqlite";
168
- moduleVersion: "0.1.2";
230
+ moduleVersion: "0.1.3";
169
231
  checks?: unknown[];
170
232
  } | {
171
233
  contract: "deployment.result.v1";
172
234
  ok: boolean;
173
235
  status: "ACTION_REQUIRED";
174
236
  moduleRef: "task-store-sqlite";
175
- moduleVersion: "0.1.2";
237
+ moduleVersion: "0.1.3";
176
238
  actionRequired: {
177
239
  action: string;
178
240
  description: string;
@@ -183,7 +245,7 @@ export declare const behaviorAdapter: {
183
245
  ok: boolean;
184
246
  status: "BLOCKED";
185
247
  moduleRef: "task-store-sqlite";
186
- moduleVersion: "0.1.2";
248
+ moduleVersion: "0.1.3";
187
249
  error: {
188
250
  code: "VERIFY_FAILED";
189
251
  message: string;
@@ -199,14 +261,14 @@ export declare const behaviorAdapter: {
199
261
  ok: boolean;
200
262
  status: "SUCCEEDED";
201
263
  moduleRef: "task-store-sqlite";
202
- moduleVersion: "0.1.2";
264
+ moduleVersion: "0.1.3";
203
265
  checks?: unknown[];
204
266
  } | {
205
267
  contract: "deployment.result.v1";
206
268
  ok: boolean;
207
269
  status: "ACTION_REQUIRED";
208
270
  moduleRef: "task-store-sqlite";
209
- moduleVersion: "0.1.2";
271
+ moduleVersion: "0.1.3";
210
272
  actionRequired: {
211
273
  action: string;
212
274
  description: string;
@@ -217,7 +279,7 @@ export declare const behaviorAdapter: {
217
279
  ok: boolean;
218
280
  status: "BLOCKED";
219
281
  moduleRef: "task-store-sqlite";
220
- moduleVersion: "0.1.2";
282
+ moduleVersion: "0.1.3";
221
283
  error: {
222
284
  code: "VERIFY_FAILED";
223
285
  message: string;
@@ -97,6 +97,34 @@ export function createBehaviorAdapter(config = {}) {
97
97
  const reality = inspect(config.databasePath);
98
98
  return { result: resultForReality(reality), observedEffects: [] };
99
99
  },
100
+ status: () => {
101
+ if (!config.databasePath) {
102
+ return {
103
+ result: {
104
+ ...success(),
105
+ data: {
106
+ configStatus: "INCOMPLETE",
107
+ missingConfig: ["databasePath"],
108
+ runtimeStatus: "UNKNOWN",
109
+ },
110
+ },
111
+ observedEffects: [],
112
+ };
113
+ }
114
+ const reality = inspect(config.databasePath);
115
+ return {
116
+ result: {
117
+ ...success(),
118
+ data: {
119
+ configStatus: reality.ok
120
+ ? "READY"
121
+ : "INVALID",
122
+ runtimeStatus: "UNKNOWN",
123
+ },
124
+ },
125
+ observedEffects: [],
126
+ };
127
+ },
100
128
  verify: () => {
101
129
  const reality = inspect(config.databasePath);
102
130
  const check = {
@@ -3,11 +3,10 @@ export declare const descriptor: {
3
3
  readonly contractVersion: "1.0.0";
4
4
  readonly moduleRef: "task-store-sqlite";
5
5
  readonly packageName: "@tomflow/proflow-task-store-sqlite";
6
- readonly moduleVersion: "0.1.2";
6
+ readonly moduleVersion: "0.1.3";
7
7
  readonly kind: "library";
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: "Provides the node:sqlite store and repository adapters for Task-owned structured facts.";
@@ -29,7 +28,7 @@ export declare const descriptor: {
29
28
  readonly description: "Task SQLite database path";
30
29
  }];
31
30
  readonly lifecycle: {
32
- readonly supported: readonly ["describe", "preflight", "verify", "doctor"];
31
+ readonly supported: readonly ["describe", "preflight", "status", "verify", "doctor"];
33
32
  };
34
33
  readonly verification: {
35
34
  readonly checks: readonly [{
@@ -47,5 +46,9 @@ export declare const descriptor: {
47
46
  readonly id: "overview";
48
47
  readonly path: "./README.md";
49
48
  readonly description: "Package-owned module overview";
49
+ }, {
50
+ readonly id: "configuration";
51
+ readonly path: "./CONFIGURATION.md";
52
+ readonly description: "Module configuration fields, sources and materialization instructions";
50
53
  }];
51
54
  };
@@ -3,21 +3,27 @@ export const descriptor = {
3
3
  contractVersion: "1.0.0",
4
4
  moduleRef: "task-store-sqlite",
5
5
  packageName: "@tomflow/proflow-task-store-sqlite",
6
- moduleVersion: "0.1.2",
6
+ moduleVersion: "0.1.3",
7
7
  kind: "library",
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: "Provides the node:sqlite store and repository adapters for Task-owned structured facts.",
14
13
  },
15
14
  provides: [],
16
15
  requires: [
17
- { contractRef: "task-orchestration", versionRange: ">=1.0.0 <2.0.0" },
16
+ {
17
+ contractRef: "task-orchestration",
18
+ versionRange: ">=1.0.0 <2.0.0",
19
+ },
18
20
  ],
19
21
  requirements: [
20
- { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
22
+ {
23
+ kind: "runtime",
24
+ runtime: "node",
25
+ versionRange: ">=24.19.0",
26
+ },
21
27
  ],
22
28
  configSlots: [
23
29
  {
@@ -27,7 +33,9 @@ export const descriptor = {
27
33
  description: "Task SQLite database path",
28
34
  },
29
35
  ],
30
- lifecycle: { supported: ["describe", "preflight", "verify", "doctor"] },
36
+ lifecycle: {
37
+ supported: ["describe", "preflight", "status", "verify", "doctor"],
38
+ },
31
39
  verification: {
32
40
  checks: [
33
41
  {
@@ -50,5 +58,10 @@ export const descriptor = {
50
58
  path: "./README.md",
51
59
  description: "Package-owned module overview",
52
60
  },
61
+ {
62
+ id: "configuration",
63
+ path: "./CONFIGURATION.md",
64
+ description: "Module configuration fields, sources and materialization instructions",
65
+ },
53
66
  ],
54
67
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tomflow/proflow-task-store-sqlite",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public"
@@ -16,14 +16,14 @@
16
16
  "proflow.module.json",
17
17
  "conformance.json",
18
18
  "README.md",
19
- "self-install.mjs"
19
+ "CONFIGURATION.md"
20
20
  ],
21
21
  "dependencies": {
22
- "@tomflow/proflow-module-contract": "^0.1.1",
23
- "@tomflow/proflow-task-orchestration": "^0.1.1"
22
+ "@tomflow/proflow-task-orchestration": "^0.1.2",
23
+ "@tomflow/proflow-module-contract": "^0.1.2"
24
24
  },
25
25
  "devDependencies": {
26
- "@tomflow/proflow-task-migration-runner": "^0.1.2"
26
+ "@tomflow/proflow-task-migration-runner": "^0.1.3"
27
27
  },
28
28
  "description": "Provides the node:sqlite store and repository adapters for Task-owned structured facts.",
29
29
  "keywords": [
@@ -33,17 +33,9 @@
33
33
  ],
34
34
  "proflow": {
35
35
  "module": true,
36
- "installClass": "core",
37
- "installRequires": [
38
- "@tomflow/proflow-module-contract",
39
- "@tomflow/proflow-task-orchestration"
40
- ],
41
36
  "descriptor": "./dist/deployment/descriptor.js",
42
37
  "manifest": "./proflow.module.json"
43
38
  },
44
- "bin": {
45
- "proflow-task-store-sqlite": "./self-install.mjs"
46
- },
47
39
  "scripts": {
48
40
  "test": "node --test tests/**/*.test.ts",
49
41
  "typecheck": "tsc --noEmit"
@@ -3,11 +3,10 @@
3
3
  "contractVersion": "1.0.0",
4
4
  "moduleRef": "task-store-sqlite",
5
5
  "packageName": "@tomflow/proflow-task-store-sqlite",
6
- "moduleVersion": "0.1.2",
6
+ "moduleVersion": "0.1.3",
7
7
  "kind": "library",
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": "Provides the node:sqlite store and repository adapters for Task-owned structured facts."
@@ -35,7 +34,7 @@
35
34
  }
36
35
  ],
37
36
  "lifecycle": {
38
- "supported": ["describe", "preflight", "verify", "doctor"]
37
+ "supported": ["describe", "preflight", "status", "verify", "doctor"]
39
38
  },
40
39
  "verification": {
41
40
  "checks": [
@@ -58,6 +57,11 @@
58
57
  "id": "overview",
59
58
  "path": "./README.md",
60
59
  "description": "Package-owned module overview"
60
+ },
61
+ {
62
+ "id": "configuration",
63
+ "path": "./CONFIGURATION.md",
64
+ "description": "Module configuration fields, sources and materialization instructions"
61
65
  }
62
66
  ]
63
67
  }
package/CHANGELOG.md DELETED
@@ -1,13 +0,0 @@
1
- # @tomflow/proflow-task-store-sqlite
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-store-sqlite 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-store-sqlite",
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);