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

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @tomflow/proflow-task-migration-runner
+
+## 0.1.6
+
+### Patch Changes
+
+- Replace JSON terminal protocols with typed CLI outcomes, add real-time Chinese progress and lifecycle summaries, publish DOCS content, standardize executable setup plans and package-owned setup commands, and preserve only user-owned pnpm policy during uninstall.
+
+## 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/SETUP.md

@@ -1,7 +1,10 @@
 # @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.
+## STEP-TASK-MIGRATION-RUNNER-01 — 完成模块自动配置
 
-## 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.
+Responsible: AI
+Interactive executable: `platform setup --module task-migration-runner`
+Non-interactive executable: `platform setup --module task-migration-runner`
+Required inputs: none
+Verify: `platform status`
+Success condition: `task-migration-runner.setupStatus=READY`.

package/dist/deployment/adapter.d.ts

@@ -4,7 +4,7 @@ export declare const behaviorAdapter: {
         result: {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "FAILED";
             error: {
@@ -20,7 +20,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 applied: number[];
                 pending: number[];
@@ -34,7 +34,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     }>;
@@ -44,7 +44,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 setupStatus: "FAILED" | "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -58,11 +58,11 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "FAILED";
             error: {
@@ -79,10 +79,9 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 docs: string;
-                setup: string;
             };
         };
         observedEffects: never[];
@@ -93,7 +92,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     }>;
@@ -103,7 +102,7 @@ export declare const behaviorAdapter: {
             readonly ok: true;
             readonly status: "SUCCEEDED";
             readonly moduleRef: "task-migration-runner";
-            readonly moduleVersion: "0.1.4";
+            readonly moduleVersion: "0.1.6";
         };
         observedEffects: never[];
     }>;
@@ -113,7 +112,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 applied: number[];
                 pending: number[];
@@ -121,7 +120,7 @@ export declare const behaviorAdapter: {
         } | {
             contract: "deployment.result.v1";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             ok: false;
             status: "FAILED";
             error: {
@@ -138,7 +137,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-migration-runner";
-            moduleVersion: "0.1.4";
+            moduleVersion: "0.1.6";
             data: {
                 migrated: boolean;
                 appliedVersions: number[];

package/dist/deployment/adapter.js

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { taskMigrations } from "@tomflow/proflow-task-store-sqlite/migrations";
 import { applyMigrations, getMigrationStatus, verifyMigrations, } from "../src/index.js";
@@ -89,7 +90,12 @@ export const behaviorAdapter = {
         };
     },
     docs: async (_context) => ({
-        result: { ...base, data: { docs: "DOCS.md", setup: "SETUP.md" } },
+        result: {
+            ...base,
+            data: {
+                docs: readFileSync(new URL("../DOCS.md", import.meta.url), "utf8"),
+            },
+        },
         observedEffects: [],
     }),
     start: async (_context) => ({

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.4";
+    readonly moduleVersion: "0.1.6";
     readonly kind: "cli";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

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.4",
+    moduleVersion: "0.1.6",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -6,7 +6,12 @@ export { runCli } from "./index.js";
 if (process.argv[1] !== undefined &&
     import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
     const output = await runCli(process.argv.slice(2));
-    process.stdout.write(`${output}\n`);
-    if (JSON.parse(output).ok !== true)
+    if (output.data?.usage)
+        process.stdout.write(`${output.data.usage}\n`);
+    else
+        process.stdout.write(output.ok
+            ? `${output.checks?.[0]?.message === "migrations applied" ? "迁移已完成" : output.checks?.[0]?.message === "migrations verified" ? "迁移验证通过" : "迁移状态可读取"}\n`
+            : `迁移失败：${output.error?.message ?? output.checks?.[0]?.message ?? "未知错误"}\n`);
+    if (!output.ok)
         process.exitCode = 1;
 }

package/dist/src/index.d.ts

@@ -38,4 +38,24 @@ export declare function discoverMigrations(migrations: readonly TaskMigration[])
 export declare function getMigrationStatus(input: MigrationInput): MigrationStatus;
 export declare function applyMigrations(input: MigrationInput): MigrationResult;
 export declare function verifyMigrations(input: MigrationInput): MigrationResult;
-export declare function runCli(args: string[]): Promise<string>;
+export interface TaskMigrationCliOutcome {
+    contract: "deployment.result.v1";
+    ok: boolean;
+    status: "SUCCEEDED" | "FAILED";
+    moduleRef: string;
+    moduleVersion: string;
+    data?: {
+        usage: string;
+    };
+    checks?: Array<{
+        id: string;
+        status: "PASS" | "FAIL";
+        message: string;
+    }>;
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+export declare function runCli(args: string[]): Promise<TaskMigrationCliOutcome>;

package/dist/src/index.js

@@ -317,8 +317,21 @@ export function verifyMigrations(input) {
     }
 }
 export async function runCli(args) {
+    if (args.includes("--json"))
+        return {
+            contract: "deployment.result.v1",
+            ok: false,
+            status: "FAILED",
+            moduleRef: moduleDescriptor.moduleRef,
+            moduleVersion: moduleDescriptor.moduleVersion,
+            error: {
+                code: "INVALID_REQUEST",
+                message: "不支持的选项 --json",
+                retryable: false,
+            },
+        };
     if (args.includes("--help") || args.includes("-h")) {
-        return JSON.stringify({
+        return {
             contract: "deployment.result.v1",
             ok: true,
             status: "SUCCEEDED",
@@ -327,7 +340,7 @@ export async function runCli(args) {
             data: {
                 usage: "proflow-task-migrate [apply|status|verify] --database <path> [--legacy-role-map <json>]",
             },
-        });
+        };
     }
     const command = args.find((item) => ["apply", "status", "verify"].includes(item)) ??
         "status";
@@ -385,7 +398,7 @@ export async function runCli(args) {
     else {
         getMigrationStatus({ databasePath, migrations: taskMigrations });
     }
-    return JSON.stringify({
+    return {
         contract: "deployment.result.v1",
         ok: success,
         status: success ? "SUCCEEDED" : "FAILED",
@@ -397,5 +410,5 @@ export async function runCli(args) {
         ...(success
             ? {}
             : { error: { code: "COMMAND_FAILED", message, retryable: false } }),
-    });
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-migration-runner",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -23,8 +23,8 @@
     "SETUP.md"
   ],
   "dependencies": {
-    "@tomflow/proflow-module-contract": "^0.1.4",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.4"
+    "@tomflow/proflow-module-contract": "^0.1.8",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.6"
   },
   "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.4",
+	"moduleVersion": "0.1.6",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",