@tomflow/proflow-platform-cli 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @tomflow/proflow-platform-cli
 
+## 0.1.5
+
+### Patch Changes
+
+- Preserve module-provided ACTION_REQUIRED descriptions in startup preflight findings so missing Role readiness tells the user the missing registration fact, next action, and revalidation command.
+
+## 0.1.4
+
+### Patch Changes
+
+- Make upgrade planning emit configuration writes only when a real config target exists, and fail before package mutation when new required configuration is missing.
+
 ## 0.1.3
 
 ### 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.3";
+            moduleVersion: "0.1.5";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -16,7 +16,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.5";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -27,7 +27,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.5";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -38,7 +38,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.5";
             data?: {} | null;
         };
         observedEffects: never[];
@@ -49,7 +49,7 @@ export declare const behaviorAdapter: {
             ok: boolean;
             status: "SUCCEEDED";
             moduleRef: "platform-cli";
-            moduleVersion: "0.1.3";
+            moduleVersion: "0.1.5";
             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.3";
+    readonly moduleVersion: "0.1.5";
     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.3",
+    moduleVersion: "0.1.5",
     kind: "cli",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/dist/src/planner/upgrade.js

@@ -71,8 +71,17 @@ export function planUpgrade(input) {
             throw new PlatformError("UPGRADE_FAILED", `upgrade ${ref} has breaking changes but declares no migrate lifecycle: ${assessment.breakingChanges.join("; ")}`);
         }
         const dependencies = deps.get(ref) ?? [];
+        const configTarget = input.config?.[ref];
+        const missingRequiredConfig = module.configSlots
+            .filter((slot) => slot.required &&
+            slot.default === undefined &&
+            configTarget?.[slot.key] === undefined)
+            .map((slot) => slot.key);
+        if (missingRequiredConfig.length > 0) {
+            throw new PlatformError("UPGRADE_FAILED", `upgrade ${ref} requires configuration before package mutation: ${missingRequiredConfig.join(", ")}`);
+        }
         steps.push(packageStep(seq, module, "upgrade", dependencies));
-        if (module.configSlots.length > 0) {
+        if (configTarget !== undefined) {
             steps.push(configStep(seq, module));
         }
         if (assessment?.migrationRequired === true) {

package/dist/src/preflight/preflight.js

@@ -119,7 +119,7 @@ function modulePreflightMessage(moduleRef, result) {
         case "ACTION_REQUIRED": {
             const action = result.actionRequired;
             return action !== undefined
-                ? `module ${moduleRef} preflight requires action "${action.action}"`
+                ? `module ${moduleRef} preflight requires action "${action.action}": ${action.description}`
                 : `module ${moduleRef} preflight requires an unspecified human action`;
         }
         case "BLOCKED":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-platform-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -24,8 +24,8 @@
     "@tomflow/proflow-module-contract": "^0.1.1"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.2",
-    "@tomflow/proflow-module-template": "^0.1.2"
+    "@tomflow/proflow-module-template": "^0.1.2",
+    "@tomflow/proflow-deployment-conformance": "^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.3",
+	"moduleVersion": "0.1.5",
 	"kind": "cli",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",