@zq-silk/yui 0.14.0 → 0.14.2

package/dist/cli/updateOrchestrator.js

@@ -1,10 +1,8 @@
 /**
  * Side-by-side `yui update` orchestration for the current storage contract.
  *
- * The staged binary may only prove that the target Home already implements the
- * exact current contract. Updating never rewrites, normalizes, migrates, or
- * repairs storage. An older Home stays untouched so an Operator can inspect it
- * with its original Yui version and create a new current Task explicitly.
+ * The staged binary proves an exact-current Home before the exact Controller
+ * is stopped and the replacement is activated, verified, and restarted.
  */
 export function runUpdate(ports, options) {
     let staged;
@@ -105,14 +103,15 @@ function activateAndVerify(ports, staged, home, lifecycle) {
         ports.verify(staged, home);
     }
     catch (error) {
-        return restoreControllerOrReport(ports, home, lifecycle, {
+        const failure = {
             outcome: "aborted",
             phase: "post-verify",
             message: `Post-update health check failed: ${messageOf(error)}`,
             action: binaryHealthUncertainAction(),
             recoverable: false,
             version: staged.version
-        });
+        };
+        return restoreControllerOrReport(ports, home, lifecycle, failure);
     }
     if (lifecycle.ensureRunning) {
         try {
@@ -140,7 +139,10 @@ function activateAndVerify(ports, staged, home, lifecycle) {
                 : restoreControllerOrReport(ports, home, lifecycle, failure);
         }
     }
-    return { outcome: "updated", version: staged.version, path: "current-fast" };
+    return {
+        outcome: "updated",
+        version: staged.version
+    };
 }
 function captureControllerLifecycle(ports, version, home) {
     const supplied = [
@@ -186,7 +188,7 @@ function captureControllerLifecycle(ports, version, home) {
         return { lifecycle: { ensureRunning: true, wasRunning: false } };
     }
     if (!isPositivePid(status.pid) || !isControllerIdentity(status.identity)) {
-        return malformedControllerResult(version, "The running Controller did not expose an exact PID and launch identity.");
+        return malformedControllerResult(version, "The running Controller did not expose an exact PID and runtime generation identity.");
     }
     let stopped;
     try {

package/dist/cli/updatePorts.js

@@ -7,10 +7,9 @@
  * `npm install --global --prefix <tmp>`, so the live global install is never
  * touched until the binary-activation step. Preflight invokes the STAGED binary's
  * internal `yui upgrade --update-preflight` contract so the target version
- * proves that the Home already implements the exact current contract. After
- * the parent stops the exact old Controller, only the binary is promoted;
- * update never rewrites or switches storage. Post-verify invokes the actually
- * activated global binary.
+ * proves that the Home exactly matches its current storage contract. After the
+ * parent stops the exact old Controller, the binary is promoted and the
+ * activated binary verifies the unchanged Home.
  *
  * Two hardening guarantees this module enforces:
  *
@@ -514,6 +513,9 @@ function runControllerCommand(home, environment, spawn, method, cliBinary) {
         env: {
             ...environment,
             YUI_HOME: home,
+            // Lifecycle capture needs the schema-independent resource inventory,
+            // not the optional current-schema identity health verdict.
+            YUI_STATUS_IDENTITY: "0",
             // This exact lifecycle child is part of the update process that owns
             // the handover lock. Managed Sessions never receive this bypass.
             YUI_UPDATE_HANDOVER_OWNER_PID: String(process.pid)
@@ -693,7 +695,7 @@ function assertActivatedControllerIdentity(identity, activatedBinary, activatedV
     if (identity.executablePath !== process.execPath
         || identity.args.length !== 1
         || identity.args[0] !== expectedEntrypoint) {
-        throw new Error("Replacement Controller launch identity does not match the activated global binary "
+        throw new Error("Replacement Controller runtime generation identity does not match the activated global binary "
             + "runtime/entrypoint; refusing readiness.");
     }
 }
@@ -782,19 +784,21 @@ function interpretPreflight(result) {
         ...(data.sceneUnchanged === true ? { sceneUnchanged: true } : {})
     };
 }
-/** Only the exact current storage contract is a green update preflight. */
+/** Accept only an exact current Home. */
 function parseUpdatePreflightResult(data) {
-    if (data.status !== "already-current" || data.stepCount !== 0)
+    if (data.status !== "already-current"
+        || !Number.isSafeInteger(data.stepCount)
+        || data.stepCount !== 0
+        || !Array.isArray(data.steps)
+        || data.steps.length !== 0)
         return null;
     const homeClassification = data.classification;
     if (!isRecord(homeClassification) || !isRecord(homeClassification.classification))
         return null;
     const classification = homeClassification.classification;
-    if (classification.verdict !== "USABLE"
-        || classification.status !== "current") {
+    if (classification.verdict !== "USABLE" || classification.status !== "current")
         return null;
-    }
-    return { status: "already-current" };
+    return { status: "already-current", stepCount: 0 };
 }
 function parseUpdateBlockers(value) {
     if (value === undefined)
@@ -806,7 +810,7 @@ function parseUpdateBlockers(value) {
         if (!isRecord(item) || typeof item.reason !== "string" || item.reason.length === 0) {
             return undefined;
         }
-        const optional = ["taskId", "roleName", "turnId", "nativeSessionId", "launchId"];
+        const optional = ["taskId", "roleName", "turnId", "nativeSessionId", "runtimeGenerationId"];
         if (optional.some((key) => item[key] !== undefined && typeof item[key] !== "string")) {
             return undefined;
         }
@@ -817,7 +821,7 @@ function parseUpdateBlockers(value) {
             ...(typeof item.nativeSessionId === "string"
                 ? { nativeSessionId: item.nativeSessionId }
                 : {}),
-            ...(typeof item.launchId === "string" ? { launchId: item.launchId } : {}),
+            ...(typeof item.runtimeGenerationId === "string" ? { runtimeGenerationId: item.runtimeGenerationId } : {}),
             reason: item.reason
         });
     }

package/dist/cli/upgradeCommand.js

@@ -1,7 +1,4 @@
-/**
- * `yui upgrade` is now a read-only storage admission diagnostic. This release
- * opens only its exact current contract and never rewrites an historical Home.
- */
+/** `yui upgrade` validates the exact storage contract supported by this release. */
 import { latestStorageVersionState } from "../storage/upgrade/recordVersions.js";
 import { runStorageUpgrade } from "../storage/upgrade/upgradeOrchestrator.js";
 import { usageError } from "../errors/cliError.js";
@@ -41,7 +38,7 @@ export function renderUpgradeResult(result, mode) {
         case "already-current":
             return `${header}\nStorage is already at the current version; nothing to upgrade.`;
         case "update-preflight":
-            return `${header}\nUpdate preflight: already-current (0 steps). Storage was not modified.`;
+            return `${header}\nUpdate preflight: ${result.status} (${result.stepCount} steps). Storage was not modified.`;
         case "blocked": {
             return [
                 header,