@tomflow/proflow-platform-cli 0.1.13 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-platform-cli
 
+## 0.1.14
+
+### Patch Changes
+
+- Gate `platform start` on managed preflight, make platform-level `restart` a stop-then-start sequence without an extra preflight, and render lifecycle / verify / doctor results clearly for human users.
+
 ## 0.1.13
 
 ### Patch Changes

package/dist/deployment/adapter.d.ts

@@ -5,7 +5,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -16,7 +16,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -27,7 +27,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -38,7 +38,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -49,7 +49,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.13";
+            moduleVersion: "0.1.14";
             data?: {} | null;
         };
         observedEffects: never[];

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "platform-cli";
     readonly packageName: "@tomflow/proflow-platform-cli";
-    readonly moduleVersion: "0.1.13";
+    readonly moduleVersion: "0.1.14";
     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: "platform-cli",
     packageName: "@tomflow/proflow-platform-cli",
-    moduleVersion: "0.1.13",
+    moduleVersion: "0.1.14",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/cli.js

@@ -907,6 +907,12 @@ async function handlePlatformInstanceUninstall(args, runtime) {
     }
 }
 async function handleLifecycle(ctx, args, primitive) {
+    if (primitive === "start") {
+        const preflight = await handlePreflight(ctx, args);
+        if (preflight.status !== "SUCCEEDED") {
+            return outcome("start", preflight.status, preflight.data);
+        }
+    }
     const modules = await discoverModules({ catalog: ctx.catalog });
     const selected = selectModules(modules, args.positional[0]);
     const result = primitive === "start"
@@ -1182,7 +1188,82 @@ function toMachineResult(outcomeResult) {
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function humanArrayLines(data) {
+    const isVerification = data.some((item) => isRecord(item) && isRecord(item.record));
+    const isDoctor = data.some((item) => isRecord(item) && Array.isArray(item.errors) && isRecord(item.nextAction));
+    const lines = [
+        isVerification ? "Verification:" : isDoctor ? "Doctor:" : "Lifecycle:",
+    ];
+    let skippedUnsupported = 0;
+    for (const item of data) {
+        if (!isRecord(item))
+            continue;
+        const moduleRef = typeof item.moduleRef === "string" ? item.moduleRef : "unknown";
+        const runStatus = typeof item.status === "string" ? item.status : "UNKNOWN";
+        if (runStatus === "SKIP_UNSUPPORTED") {
+            skippedUnsupported += 1;
+            continue;
+        }
+        const result = isRecord(item.result) ? item.result : undefined;
+        const resultStatus = result !== undefined && typeof result.status === "string"
+            ? result.status
+            : runStatus;
+        let detail = "";
+        const actionRequired = result !== undefined && isRecord(result.actionRequired)
+            ? result.actionRequired
+            : undefined;
+        const error = result !== undefined && isRecord(result.error) ? result.error : undefined;
+        if (actionRequired !== undefined) {
+            const action = typeof actionRequired.action === "string"
+                ? actionRequired.action
+                : "action-required";
+            const description = typeof actionRequired.description === "string"
+                ? actionRequired.description
+                : "human action required";
+            detail = ` — ${action}: ${description}`;
+        }
+        else if (error !== undefined) {
+            const code = typeof error.code === "string" ? error.code : "COMMAND_FAILED";
+            const message = typeof error.message === "string" ? error.message : "Unknown error";
+            detail = ` — ${code}: ${message}`;
+        }
+        else if (isRecord(item.record) &&
+            typeof item.record.summary === "string") {
+            detail = ` — ${item.record.summary}`;
+        }
+        lines.push(`- ${moduleRef}: ${resultStatus}${detail}`);
+        if (Array.isArray(item.errors)) {
+            for (const doctorError of item.errors) {
+                if (!isRecord(doctorError))
+                    continue;
+                const code = typeof doctorError.code === "string"
+                    ? doctorError.code
+                    : "COMMAND_FAILED";
+                const message = typeof doctorError.message === "string"
+                    ? doctorError.message
+                    : "Unknown error";
+                lines.push(`  Error: ${code}: ${message}`);
+            }
+        }
+        if (isRecord(item.nextAction)) {
+            if (item.nextAction.kind === "human-action" &&
+                typeof item.nextAction.action === "string" &&
+                typeof item.nextAction.description === "string") {
+                lines.push(`  Next: ${item.nextAction.action} — ${item.nextAction.description}`);
+            }
+            else if (item.nextAction.kind === "repair-plan" &&
+                typeof item.nextAction.summary === "string") {
+                lines.push(`  Next: platform plan --intent repair — ${item.nextAction.summary}`);
+            }
+        }
+    }
+    if (skippedUnsupported > 0)
+        lines.push(`Skipped unsupported: ${skippedUnsupported}`);
+    return lines;
+}
 function humanDetailLines(data) {
+    if (Array.isArray(data))
+        return humanArrayLines(data);
     if (!isRecord(data)) {
         return data === undefined ? [] : [String(data)];
     }

package/dist/src/lifecycle/dispatch.d.ts

@@ -34,9 +34,10 @@ export declare function startModules(catalog: ModuleCatalog, modules: readonly R
  */
 export declare function stopModules(catalog: ModuleCatalog, modules: readonly ResolvedModule[]): Promise<LifecycleRunResult[]>;
 /**
- * Restarts a module set in forward dependency topological order, dispatching
- * `restart` only to modules that explicitly declare it. Dependencies are
- * settled before the modules that consume them.
+ * Restarts a module set as a platform-level stop → start sequence. Stop runs in
+ * reverse dependency order; only after every executed stop succeeds does start
+ * run in forward dependency order with the same dependency blocking rules as a
+ * normal start. Module-native `restart` primitives are not used here.
  */
 export declare function restartModules(catalog: ModuleCatalog, modules: readonly ResolvedModule[]): Promise<LifecycleRunResult[]>;
 /**

package/dist/src/lifecycle/dispatch.js

@@ -172,12 +172,17 @@ export async function stopModules(catalog, modules) {
     return runInOrder(catalog, modules, order, "stop");
 }
 /**
- * Restarts a module set in forward dependency topological order, dispatching
- * `restart` only to modules that explicitly declare it. Dependencies are
- * settled before the modules that consume them.
+ * Restarts a module set as a platform-level stop → start sequence. Stop runs in
+ * reverse dependency order; only after every executed stop succeeds does start
+ * run in forward dependency order with the same dependency blocking rules as a
+ * normal start. Module-native `restart` primitives are not used here.
  */
 export async function restartModules(catalog, modules) {
-    return runInOrder(catalog, modules, buildDependencyGraph(modules).order, "restart");
+    const stopped = await stopModules(catalog, modules);
+    const stopBlocked = stopped.some((item) => item.result !== undefined && item.result.status !== "SUCCEEDED");
+    if (stopBlocked)
+        return stopped;
+    return startModules(catalog, modules);
 }
 /**
  * Queries current reality by dispatching the `status` primitive to every

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-cli",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "type": "module",
   "publishConfig": {
     "access": "public"

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "platform-cli",
 	"packageName": "@tomflow/proflow-platform-cli",
-	"moduleVersion": "0.1.13",
+	"moduleVersion": "0.1.14",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",