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

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @tomflow/proflow-task-migration-runner
+
+## 0.1.5
+
+### Patch Changes
+
+- Align all Modules to the seven-command setup contract with executable package-owned setup guidance and full Platform setup aggregation.

package/DOCS.md

@@ -0,0 +1,27 @@
+# @tomflow/proflow-task-migration-runner — Module Docs
+
+Module ref: `task-migration-runner`  
+Domain: `task-orchestration`  
+Kind: `cli`
+
+Deterministically discovers, applies and verifies Task Store SQLite schema migrations.
+
+## Standard management surface
+
+`install / uninstall / status / setup / docs / start / stop`
+
+## Provides
+
+- None.
+
+## Requires
+
+- None.
+
+## Public setup inputs
+
+- None. Deterministic/private values and cross-Module shared facts are not public configuration.
+
+## Ownership boundary
+
+Module business APIs and any module-specific extra commands remain package-owned. Platform does not proxy or interpret them. Current human/external preparation is documented in `SETUP.md`.

package/SETUP.md

@@ -0,0 +1,19 @@
+# @tomflow/proflow-task-migration-runner — Module Setup
+
+## Goal
+
+Reach `setupStatus=READY` without user configuration.
+
+## Step 1 — Complete machine-owned preparation
+
+**Type:** automatic
+**Executable:** `platform install`
+**What happens:** No user input is required. Required schema migrations are machine-owned and must run automatically.
+
+## Step 2 — Re-observe dependency and setup state
+
+**Type:** automatic verification
+**Verify:** `platform status`
+**Success condition:** `task-migration-runner.setupStatus=READY`.
+
+There is no human setup action. A missing machine-owned artifact or producer-owned dependency is a `FAILED` condition to fix in the owning package/dependency; it must never be converted into a request for path/token/endpoint input.

package/dist/deployment/adapter.d.ts

@@ -1,343 +1,163 @@
-export declare function createBehaviorAdapter(config?: Record<string, string>): {
-    describe: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    preflight: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    status: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    verify: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    } | {
+import type { ModuleCommandContext } from "@tomflow/proflow-module-contract";
+export declare const behaviorAdapter: {
+    readonly install: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            moduleVersion: "0.1.5";
+            ok: false;
             status: "FAILED";
             error: {
-                code: "APPLY_FAILED" | "VERIFY_FAILED";
+                code: "APPLY_FAILED";
                 message: string;
                 retryable: boolean;
             };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    doctor: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
         };
         observedEffects: never[];
     } | {
         result: {
             contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "BLOCKED";
-            error: {
-                code: "VERIFY_FAILED";
-                message: string;
-                retryable: boolean;
+            moduleVersion: "0.1.5";
+            data: {
+                applied: number[];
+                pending: number[];
             };
-            data?: {} | null;
+        };
+        observedEffects: string[];
+    }>;
+    readonly uninstall: (_context: ModuleCommandContext) => Promise<{
+        result: {
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "task-migration-runner";
+            readonly moduleVersion: "0.1.5";
         };
         observedEffects: never[];
-    };
-    migrate: () => {
+    }>;
+    readonly status: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
+            ok: true;
+            status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.5";
+            data: {
+                setupStatus: "FAILED" | "READY";
+                runtimeStatus: "NOT_APPLICABLE";
             };
-            data?: {} | null;
-            checks?: unknown[];
         };
         observedEffects: never[];
-    } | {
+    }>;
+    readonly setup: (context: ModuleCommandContext) => Promise<{
         result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "task-migration-runner";
+            readonly moduleVersion: "0.1.5";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            moduleVersion: "0.1.5";
+            ok: false;
             status: "FAILED";
             error: {
-                code: "APPLY_FAILED" | "VERIFY_FAILED";
+                code: "SETUP_FAILED";
                 message: string;
                 retryable: boolean;
             };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: string[];
-    };
-};
-export declare const behaviorAdapter: {
-    describe: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
         };
         observedEffects: never[];
-    };
-    preflight: () => {
+    }>;
+    readonly docs: (_context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.5";
+            data: {
+                docs: string;
+                setup: string;
             };
-            data?: {} | null;
-            checks?: unknown[];
         };
         observedEffects: never[];
-    };
-    status: () => {
+    }>;
+    readonly start: (_context: ModuleCommandContext) => Promise<{
         result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "task-migration-runner";
+            readonly moduleVersion: "0.1.5";
         };
         observedEffects: never[];
-    };
-    verify: () => {
+    }>;
+    readonly stop: (_context: ModuleCommandContext) => Promise<{
         result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
+            readonly contract: "deployment.result.v1";
+            readonly ok: true;
+            readonly status: "SUCCEEDED";
+            readonly moduleRef: "task-migration-runner";
+            readonly moduleVersion: "0.1.5";
         };
         observedEffects: never[];
-    } | {
+    }>;
+    readonly migrate: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "FAILED";
-            error: {
-                code: "APPLY_FAILED" | "VERIFY_FAILED";
-                message: string;
-                retryable: boolean;
-            };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    doctor: () => {
-        result: {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.5";
+            data: {
+                applied: number[];
+                pending: number[];
             };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    } | {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "BLOCKED";
+            moduleVersion: "0.1.5";
+            ok: false;
+            status: "FAILED";
             error: {
-                code: "VERIFY_FAILED";
+                code: "APPLY_FAILED";
                 message: string;
                 retryable: boolean;
             };
-            data?: {} | null;
-        };
-        observedEffects: never[];
-    };
-    migrate: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
         };
-        observedEffects: never[];
-    } | {
+        observedEffects: string[];
+    }>;
+    readonly migrationStatus: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.3";
-            ok: boolean;
-            status: "FAILED";
-            error: {
-                code: "APPLY_FAILED" | "VERIFY_FAILED";
-                message: string;
-                retryable: boolean;
+            moduleVersion: "0.1.5";
+            data: {
+                migrated: boolean;
+                appliedVersions: number[];
+                pendingVersions: number[];
+                metadataDrift: {
+                    version: number;
+                    expectedName: string;
+                    actualName: string;
+                }[];
+                checksumDrift: {
+                    version: number;
+                    expectedChecksum: string;
+                    actualChecksum: string;
+                }[];
+                legacyMetadataVersions: number[];
+                missingTables: string[];
+                schemaDrift: string[];
             };
-            data?: {} | null;
-            checks?: unknown[];
         };
-        observedEffects: string[];
-    };
-};
-export declare function createProductionBinding(input: {
-    config: Record<string, string>;
-}): {
-    behaviorAdapter: Record<string, unknown>;
+        observedEffects: never[];
+    }>;
 };

package/dist/deployment/adapter.js

@@ -1,54 +1,22 @@
-import { observeDeclaredModuleStatus } from "@tomflow/proflow-module-contract";
+import { join, resolve } from "node:path";
 import { taskMigrations } from "@tomflow/proflow-task-store-sqlite/migrations";
 import { applyMigrations, getMigrationStatus, verifyMigrations, } from "../src/index.js";
 import { descriptor } from "./descriptor.js";
 const base = {
     contract: "deployment.result.v1",
+    ok: true,
+    status: "SUCCEEDED",
     moduleRef: descriptor.moduleRef,
     moduleVersion: descriptor.moduleVersion,
 };
-const success = (data, checks) => ({
-    ...base,
-    ok: true,
-    status: "SUCCEEDED",
-    ...(data === undefined ? {} : { data }),
-    ...(checks === undefined ? {} : { checks }),
-});
-const actionRequired = (description, data, checks) => ({
-    ...base,
-    ok: false,
-    status: "ACTION_REQUIRED",
-    actionRequired: { action: "configure-task-migrations", description },
-    ...(data === undefined ? {} : { data }),
-    ...(checks === undefined ? {} : { checks }),
-});
-const failed = (message, data, checks, code = "APPLY_FAILED") => ({
-    ...base,
-    ok: false,
-    status: "FAILED",
-    error: { code, message, retryable: false },
-    ...(data === undefined ? {} : { data }),
-    ...(checks === undefined ? {} : { checks }),
+const input = (context) => ({
+    databasePath: join(resolve(context.workspaceRoot), ".proflow", "state", "task.sqlite"),
+    migrations: taskMigrations,
 });
-const blocked = (message, data) => ({
-    ...base,
-    ok: false,
-    status: "BLOCKED",
-    error: { code: "VERIFY_FAILED", message, retryable: true },
-    ...(data === undefined ? {} : { data }),
-});
-function migrationInput(config) {
-    const databasePath = config.databasePath;
-    if (!databasePath)
-        return undefined;
-    return { databasePath, migrations: taskMigrations };
-}
-function statusData(config) {
-    const input = migrationInput(config);
-    if (input === undefined)
-        return undefined;
-    const status = getMigrationStatus(input);
-    const verification = verifyMigrations(input);
+const data = (context) => {
+    const i = input(context);
+    const status = getMigrationStatus(i);
+    const verification = verifyMigrations(i);
     return {
         migrated: verification.ok,
         appliedVersions: status.appliedVersions,
@@ -59,89 +27,104 @@ function statusData(config) {
         missingTables: status.missingTables,
         schemaDrift: status.schemaDrift,
     };
-}
-export function createBehaviorAdapter(config = {}) {
-    return {
-        describe: () => ({ result: success(), observedEffects: [] }),
-        preflight: () => ({
-            result: migrationInput(config) === undefined
-                ? actionRequired("databasePath is required for Task migrations")
-                : success(),
-            observedEffects: [],
-        }),
-        status: () => ({
-            result: success(observeDeclaredModuleStatus(descriptor, config, "STOPPED")),
-            observedEffects: [],
-        }),
-        verify: () => {
-            const input = migrationInput(config);
-            if (input === undefined) {
-                const check = {
-                    id: "migration-state-pass",
-                    status: "FAIL",
-                    message: "databasePath is required for Task migration verification",
-                };
-                return {
-                    result: actionRequired(check.message, undefined, [check]),
-                    observedEffects: [],
-                };
-            }
-            const verification = verifyMigrations(input);
-            const data = statusData(config);
-            const check = {
-                id: "migration-state-pass",
-                status: verification.ok ? "PASS" : "FAIL",
-                message: verification.ok
-                    ? "Task migration state and SQLite integrity match the current schema"
-                    : (verification.error?.message ??
-                        "Task migration verification failed"),
-            };
-            return {
-                result: verification.ok
-                    ? success(data, [check])
-                    : failed(check.message, data, [check], "VERIFY_FAILED"),
-                observedEffects: [],
-            };
-        },
-        doctor: () => {
-            const data = statusData(config);
-            if (data === undefined) {
-                return {
-                    result: actionRequired("databasePath is required for Task migration diagnostics"),
-                    observedEffects: [],
-                };
-            }
+};
+export const behaviorAdapter = {
+    install: async (context) => {
+        const migration = applyMigrations(input(context));
+        if (!migration.ok)
             return {
-                result: data.migrated
-                    ? success(data)
-                    : blocked("Task migration state requires a repair/migration plan before readiness", data),
+                result: {
+                    ...base,
+                    ok: false,
+                    status: "FAILED",
+                    error: {
+                        code: "APPLY_FAILED",
+                        message: migration.error?.message ?? "Task migration failed",
+                        retryable: false,
+                    },
+                },
                 observedEffects: [],
             };
-        },
-        migrate: () => {
-            const input = migrationInput(config);
-            if (input === undefined) {
-                return {
-                    result: actionRequired("databasePath is required before Task migrations can run"),
-                    observedEffects: [],
-                };
-            }
-            const migration = applyMigrations(input);
-            return {
-                result: migration.ok
-                    ? success({ applied: migration.applied, pending: migration.pending })
-                    : failed(migration.error?.message ?? "Task migration failed", {
-                        applied: migration.applied,
-                        pending: migration.pending,
-                    }),
-                observedEffects: migration.ok
-                    ? ["Applies Task Store migration SQL to SQLite"]
-                    : [],
-            };
-        },
-    };
-}
-export const behaviorAdapter = createBehaviorAdapter();
-export function createProductionBinding(input) {
-    return { behaviorAdapter: createBehaviorAdapter(input.config) };
-}
+        return {
+            result: {
+                ...base,
+                data: { applied: migration.applied, pending: migration.pending },
+            },
+            observedEffects: ["Applies Task Store migration SQL to SQLite"],
+        };
+    },
+    uninstall: async (_context) => ({
+        result: base,
+        observedEffects: [],
+    }),
+    status: async (context) => {
+        const v = verifyMigrations(input(context));
+        return {
+            result: {
+                ...base,
+                data: {
+                    setupStatus: v.ok ? "READY" : "FAILED",
+                    runtimeStatus: "NOT_APPLICABLE",
+                },
+            },
+            observedEffects: [],
+        };
+    },
+    setup: async (context) => {
+        const v = verifyMigrations(input(context));
+        return {
+            result: v.ok
+                ? base
+                : {
+                    ...base,
+                    ok: false,
+                    status: "FAILED",
+                    error: {
+                        code: "SETUP_FAILED",
+                        message: v.error?.message ?? "Task migration state is not ready",
+                        retryable: true,
+                    },
+                },
+            observedEffects: [],
+        };
+    },
+    docs: async (_context) => ({
+        result: { ...base, data: { docs: "DOCS.md", setup: "SETUP.md" } },
+        observedEffects: [],
+    }),
+    start: async (_context) => ({
+        result: base,
+        observedEffects: [],
+    }),
+    stop: async (_context) => ({
+        result: base,
+        observedEffects: [],
+    }),
+    migrate: async (context) => {
+        const migration = applyMigrations(input(context));
+        return {
+            result: migration.ok
+                ? {
+                    ...base,
+                    data: { applied: migration.applied, pending: migration.pending },
+                }
+                : {
+                    ...base,
+                    ok: false,
+                    status: "FAILED",
+                    error: {
+                        code: "APPLY_FAILED",
+                        message: migration.error?.message ?? "Task migration failed",
+                        retryable: false,
+                    },
+                },
+            observedEffects: migration.ok
+                ? ["Applies Task Store migration SQL to SQLite"]
+                : [],
+        };
+    },
+    migrationStatus: async (context) => ({
+        result: { ...base, data: data(context) },
+        observedEffects: [],
+    }),
+};

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.3";
+    readonly moduleVersion: "0.1.5";
     readonly kind: "cli";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
@@ -18,34 +18,14 @@ export declare const descriptor: {
         readonly runtime: "node";
         readonly versionRange: ">=24.19.0";
     }];
-    readonly configSlots: readonly [{
-        readonly key: "databasePath";
-        readonly type: "path";
-        readonly required: true;
-        readonly description: "Task SQLite database path";
-    }];
-    readonly lifecycle: {
-        readonly supported: readonly ["describe", "preflight", "status", "verify", "doctor", "migrate"];
-    };
-    readonly verification: {
-        readonly checks: readonly [{
-            readonly id: "migration-state-pass";
-            readonly description: "Migration state matches the Task schema";
-            readonly lifecycle: "verify";
-        }];
-    };
+    readonly configSlots: readonly [];
     readonly effects: readonly [{
         readonly kind: "filesystem";
         readonly description: "Applies Task Store migration SQL to SQLite";
         readonly retention: "preserve";
     }];
-    readonly documentation: readonly [{
-        readonly id: "overview";
-        readonly path: "./README.md";
-        readonly description: "Package-owned module overview";
-    }, {
-        readonly id: "configuration";
-        readonly path: "./CONFIGURATION.md";
-        readonly description: "Module configuration fields, sources and materialization instructions";
-    }];
+    readonly documentation: {
+        readonly docs: "DOCS.md";
+        readonly setup: "SETUP.md";
+    };
 };

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.3",
+    moduleVersion: "0.1.5",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
@@ -20,33 +20,7 @@ export const descriptor = {
             versionRange: ">=24.19.0",
         },
     ],
-    configSlots: [
-        {
-            key: "databasePath",
-            type: "path",
-            required: true,
-            description: "Task SQLite database path",
-        },
-    ],
-    lifecycle: {
-        supported: [
-            "describe",
-            "preflight",
-            "status",
-            "verify",
-            "doctor",
-            "migrate",
-        ],
-    },
-    verification: {
-        checks: [
-            {
-                id: "migration-state-pass",
-                description: "Migration state matches the Task schema",
-                lifecycle: "verify",
-            },
-        ],
-    },
+    configSlots: [],
     effects: [
         {
             kind: "filesystem",
@@ -54,16 +28,8 @@ export const descriptor = {
             retention: "preserve",
         },
     ],
-    documentation: [
-        {
-            id: "overview",
-            path: "./README.md",
-            description: "Package-owned module overview",
-        },
-        {
-            id: "configuration",
-            path: "./CONFIGURATION.md",
-            description: "Module configuration fields, sources and materialization instructions",
-        },
-    ],
+    documentation: {
+        docs: "DOCS.md",
+        setup: "SETUP.md",
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-migration-runner",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -19,11 +19,12 @@
     "proflow.module.json",
     "conformance.json",
     "README.md",
-    "CONFIGURATION.md"
+    "DOCS.md",
+    "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-task-store-sqlite": "^0.1.3",
-    "@tomflow/proflow-module-contract": "^0.1.2"
+    "@tomflow/proflow-module-contract": "^0.1.5",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.5"
   },
   "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.3",
+	"moduleVersion": "0.1.5",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
@@ -20,33 +20,7 @@
 			"versionRange": ">=24.19.0"
 		}
 	],
-	"configSlots": [
-		{
-			"key": "databasePath",
-			"type": "path",
-			"required": true,
-			"description": "Task SQLite database path"
-		}
-	],
-	"lifecycle": {
-		"supported": [
-			"describe",
-			"preflight",
-			"status",
-			"verify",
-			"doctor",
-			"migrate"
-		]
-	},
-	"verification": {
-		"checks": [
-			{
-				"id": "migration-state-pass",
-				"description": "Migration state matches the Task schema",
-				"lifecycle": "verify"
-			}
-		]
-	},
+	"configSlots": [],
 	"effects": [
 		{
 			"kind": "filesystem",
@@ -54,16 +28,8 @@
 			"retention": "preserve"
 		}
 	],
-	"documentation": [
-		{
-			"id": "overview",
-			"path": "./README.md",
-			"description": "Package-owned module overview"
-		},
-		{
-			"id": "configuration",
-			"path": "./CONFIGURATION.md",
-			"description": "Module configuration fields, sources and materialization instructions"
-		}
-	]
+	"documentation": {
+		"docs": "DOCS.md",
+		"setup": "SETUP.md"
+	}
 }

package/CONFIGURATION.md

@@ -1,23 +0,0 @@
-# task-migration-runner configuration
-
-Canonical public config: `.proflow/config/task-migration-runner.json`
-
-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.
-
-## Fields
-
-| Key | Type | Required | Sensitive | Source | Meaning |
-|---|---|---:|---:|---|---|
-| `databasePath` | `path` | yes | no | User or owning Module supplies an absolute/local path that exists on this Workspace. | Task SQLite database path |
-
-## Materialize
-
-Create or update the canonical JSON object at:
-
-`.proflow/config/task-migration-runner.json`
-
-Use only declared keys and string values. Do not create a second Platform configuration database.
-
-## Base completion check
-
-Run `platform modules`. This Module should no longer report required keys in `missingConfig`. `platform start` performs the authoritative Module-owned validation before starting anything.