@tomflow/proflow-platform-cli 0.1.12 → 0.1.14

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @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
+
+- Fully clean Workspace uninstall artifacts by removing empty ProFlow layout directories and stale pnpm release-age entries across prior managed versions.
+
 ## 0.1.12
 
 ### 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.12";
+            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.12";
+            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.12";
+            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.12";
+            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.12";
+            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.12";
+    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.12",
+    moduleVersion: "0.1.14",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/apply/driver.js

@@ -22,8 +22,8 @@ export async function cleanupWorkspacePackageManagerArtifacts(options) {
     const manager = await readWorkspacePackageManagerSelection(options.workspaceRoot);
     if (manager.name !== "pnpm")
         return;
-    const removedPackageSpecs = new Set(options.removedModules.map((module) => `${module.packageName}@${module.moduleVersion}`));
-    await cleanupPnpmReleaseAgeExcludes(options.workspaceRoot, removedPackageSpecs);
+    const removedPackageNames = new Set(options.removedModules.map((module) => module.packageName));
+    await cleanupPnpmReleaseAgeExcludes(options.workspaceRoot, removedPackageNames);
     await normalizeEmptyPnpmRootImporter(options.workspaceRoot);
 }
 export function createWorkspacePackageManagerDriver(options) {
@@ -156,7 +156,7 @@ async function readWorkspaceManifest(workspaceRoot) {
         return undefined;
     }
 }
-async function cleanupPnpmReleaseAgeExcludes(workspaceRoot, removedPackageSpecs) {
+async function cleanupPnpmReleaseAgeExcludes(workspaceRoot, removedPackageNames) {
     const path = join(workspaceRoot, "pnpm-workspace.yaml");
     let raw;
     try {
@@ -181,7 +181,11 @@ async function cleanupPnpmReleaseAgeExcludes(workspaceRoot, removedPackageSpecs)
         if (match === null)
             return true;
         const value = stripYamlQuotes(match[1] ?? "");
-        return !removedPackageSpecs.has(value);
+        for (const packageName of removedPackageNames) {
+            if (value === packageName || value.startsWith(`${packageName}@`))
+                return false;
+        }
+        return true;
     });
     const hasListItem = retained.some((line) => /^\s*-\s+/.test(line));
     const replacement = hasListItem ? [lines[keyIndex] ?? "", ...retained] : [];

package/dist/src/cli.js

@@ -855,15 +855,26 @@ async function handlePlatformInstanceUninstall(args, runtime) {
         // into a future install of the same directory. Business/domain data outside
         // `.proflow/deployment` is intentionally preserved.
         await rm(ctx.paths.deployment, { recursive: true, force: true });
-        try {
-            await rmdir(ctx.paths.proflow);
-        }
-        catch (error) {
-            const code = typeof error === "object" && error !== null
-                ? Reflect.get(error, "code")
-                : undefined;
-            if (code !== "ENOENT" && code !== "ENOTEMPTY")
-                throw error;
+        for (const path of [
+            ctx.paths.logsDeployment,
+            ctx.paths.logs,
+            ctx.paths.config,
+            ctx.paths.data,
+            ctx.paths.runtime,
+            ctx.paths.cache,
+            ctx.paths.tmp,
+            ctx.paths.proflow,
+        ]) {
+            try {
+                await rmdir(path);
+            }
+            catch (error) {
+                const code = typeof error === "object" && error !== null
+                    ? Reflect.get(error, "code")
+                    : undefined;
+                if (code !== "ENOENT" && code !== "ENOTEMPTY")
+                    throw error;
+            }
         }
         const completed = binding;
         await clearGlobalBinding({
@@ -896,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"
@@ -1171,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.12",
+  "version": "0.1.14",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -24,8 +24,8 @@
     "@tomflow/proflow-module-contract": "^0.1.1"
   },
   "devDependencies": {
-    "@tomflow/proflow-module-template": "^0.1.2",
-    "@tomflow/proflow-deployment-conformance": "^0.1.2"
+    "@tomflow/proflow-deployment-conformance": "^0.1.2",
+    "@tomflow/proflow-module-template": "^0.1.2"
   },
   "description": "Deterministic platform-level deployment discovery, planning, lifecycle and verification CLI.",
   "keywords": [

package/proflow.module.json

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