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

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,7 @@
+# @tomflow/proflow-task-migration-runner — Module Setup
+
+No user or external setup is required by the current frozen Module contract. `Module.install` completes deterministic preparation; `Module.setup` only re-observes current reality and must not ask the user to supply private paths, loopback endpoints, tokens or cross-Module facts.
+
+## Completion
+
+Setup is complete only when the Module's own `status` reports `setupStatus=READY`. Re-running setup must re-observe reality; it must not resume from a blind historical step index.

package/dist/deployment/adapter.d.ts

@@ -1,367 +1,163 @@
-export declare function createBehaviorAdapter(config?: Record<string, string>): {
-    describe: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    preflight: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            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.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
-            };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    };
-    verify: () => {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            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.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
+            moduleVersion: "0.1.4";
+            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.2";
-            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.2";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "BLOCKED";
-            error: {
-                code: "VERIFY_FAILED";
-                message: string;
-                retryable: boolean;
+            moduleVersion: "0.1.4";
+            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.4";
         };
         observedEffects: never[];
-    };
-    migrate: () => {
+    }>;
+    readonly status: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
+            ok: true;
+            status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.4";
+            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.2";
-            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.4";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
+            moduleVersion: "0.1.4";
+            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.2";
-            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.2";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.4";
+            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.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            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.4";
         };
         observedEffects: never[];
-    };
-    verify: () => {
+    }>;
+    readonly stop: (_context: ModuleCommandContext) => Promise<{
         result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            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.4";
         };
         observedEffects: never[];
-    } | {
+    }>;
+    readonly migrate: (context: ModuleCommandContext) => Promise<{
         result: {
             contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            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.2";
-            ok: boolean;
-            status: "ACTION_REQUIRED";
-            actionRequired: {
-                action: string;
-                description: string;
+            moduleVersion: "0.1.4";
+            data: {
+                applied: number[];
+                pending: number[];
             };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: never[];
-    } | {
-        result: {
-            contract: "deployment.result.v1";
-            moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "BLOCKED";
+            moduleVersion: "0.1.4";
+            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.2";
-            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.2";
-            ok: boolean;
+            ok: true;
             status: "SUCCEEDED";
-            data?: {} | null;
-            checks?: unknown[];
-        } | {
-            contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.2";
-            ok: boolean;
-            status: "FAILED";
-            error: {
-                code: "APPLY_FAILED" | "VERIFY_FAILED";
-                message: string;
-                retryable: boolean;
-            };
-            data?: {} | null;
-            checks?: unknown[];
-        };
-        observedEffects: string[];
-    };
-};
-export declare function createProductionBinding(input: {
-    config: Record<string, string>;
-}): {
-    behaviorAdapter: Record<string, unknown>;
+            moduleVersion: "0.1.4";
+            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[];
+            };
+        };
+        observedEffects: never[];
+    }>;
 };

package/dist/deployment/adapter.js

@@ -1,53 +1,22 @@
+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,
@@ -58,94 +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: () => {
-            const data = statusData(config);
-            return {
-                result: data === undefined
-                    ? actionRequired("databasePath is required for Task migration status")
-                    : success(data),
-                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,11 +3,10 @@ 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.2";
+    readonly moduleVersion: "0.1.4";
     readonly kind: "cli";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "task-orchestration";
         readonly summary: "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.";
@@ -19,30 +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 documentation: {
+        readonly docs: "DOCS.md";
+        readonly setup: "SETUP.md";
+    };
 };

package/dist/deployment/descriptor.js

@@ -3,11 +3,10 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "task-migration-runner",
     packageName: "@tomflow/proflow-task-migration-runner",
-    moduleVersion: "0.1.2",
+    moduleVersion: "0.1.4",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
-    installClass: "core",
     identity: {
         domain: "task-orchestration",
         summary: "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
@@ -15,35 +14,13 @@ export const descriptor = {
     provides: [],
     requires: [],
     requirements: [
-        { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
-    ],
-    configSlots: [
         {
-            key: "databasePath",
-            type: "path",
-            required: true,
-            description: "Task SQLite database path",
+            kind: "runtime",
+            runtime: "node",
+            versionRange: ">=24.19.0",
         },
     ],
-    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",
@@ -51,11 +28,8 @@ export const descriptor = {
             retention: "preserve",
         },
     ],
-    documentation: [
-        {
-            id: "overview",
-            path: "./README.md",
-            description: "Package-owned module overview",
-        },
-    ],
+    documentation: {
+        docs: "DOCS.md",
+        setup: "SETUP.md",
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-migration-runner",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -12,19 +12,19 @@
     "./deployment/descriptor": "./dist/deployment/descriptor.js"
   },
   "bin": {
-    "proflow-task-migrate": "./dist/src/cli.js",
-    "proflow-task-migration-runner": "./self-install.mjs"
+    "proflow-task-migrate": "./dist/src/cli.js"
   },
   "files": [
     "dist",
     "proflow.module.json",
     "conformance.json",
     "README.md",
-    "self-install.mjs"
+    "DOCS.md",
+    "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-task-store-sqlite": "^0.1.2",
-    "@tomflow/proflow-module-contract": "^0.1.1"
+    "@tomflow/proflow-module-contract": "^0.1.4",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.4"
   },
   "description": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations.",
   "keywords": [
@@ -34,11 +34,6 @@
   ],
   "proflow": {
     "module": true,
-    "installClass": "core",
-    "installRequires": [
-      "@tomflow/proflow-module-contract",
-      "@tomflow/proflow-task-store-sqlite"
-    ],
     "descriptor": "./dist/deployment/descriptor.js",
     "manifest": "./proflow.module.json"
   },

package/proflow.module.json

@@ -3,11 +3,10 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-migration-runner",
 	"packageName": "@tomflow/proflow-task-migration-runner",
-	"moduleVersion": "0.1.2",
+	"moduleVersion": "0.1.4",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
-	"installClass": "core",
 	"identity": {
 		"domain": "task-orchestration",
 		"summary": "Deterministically discovers, applies and verifies Task Store SQLite schema migrations."
@@ -21,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",
@@ -55,11 +28,8 @@
 			"retention": "preserve"
 		}
 	],
-	"documentation": [
-		{
-			"id": "overview",
-			"path": "./README.md",
-			"description": "Package-owned module overview"
-		}
-	]
+	"documentation": {
+		"docs": "DOCS.md",
+		"setup": "SETUP.md"
+	}
 }

package/CHANGELOG.md

@@ -1,13 +0,0 @@
-# @tomflow/proflow-task-migration-runner
-
-## 0.1.2
-
-### Patch Changes
-
-- Real-1 final remediation and black-box release closure
-
-## 0.1.1
-
-### Patch Changes
-
-- 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

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-
-const [command, ...rest] = process.argv.slice(2);
-const usage = "Usage: npx @tomflow/proflow-task-migration-runner install\n";
-if (command === "--help" || command === "-h") {
-	process.stdout.write(usage);
-	process.exit(0);
-}
-if (command !== "install" || rest.length > 0) {
-	process.stderr.write(usage);
-	process.exit(2);
-}
-const executable = process.platform === "win32" ? "platform.cmd" : "platform";
-const result = spawnSync(
-	executable,
-	[
-		"install",
-		"@tomflow/proflow-task-migration-runner",
-		"--workspace",
-		process.cwd(),
-	],
-	{ cwd: process.cwd(), env: process.env, stdio: "inherit" },
-);
-if (result.error) {
-	if (result.error.code === "ENOENT") {
-		process.stderr.write(
-			"GLOBAL_PLATFORM_CLI_REQUIRED: install @tomflow/proflow-platform-cli globally before package-owned install\n",
-		);
-		process.exit(127);
-	}
-	throw result.error;
-}
-process.exit(result.status ?? 1);