@aui.io/apollo 0.1.67 → 0.1.70

package/node_modules/@aui.io/apollo-cli/dist/src/commands/status.js

@@ -1,4 +1,4 @@
-import { getStatus } from "@aui.io/apollo-core/services/status.service.js";
+import { describeRuntimePin, getStatus, } from "@aui.io/apollo-core/services/status.service.js";
 export function registerStatus(program, runtime) {
     program
         .command("status")
@@ -39,22 +39,13 @@ function renderStatus(status) {
     return lines.join("\n");
 }
 /**
- * The pin, and — after `--check` — whether it is still served. A retired pin
- * is the one status line that names its own fix, because every
- * engine-needing verb refuses until it is re-pinned.
+ * The pin, and — after `--check` — whether it is still served and current.
+ * A retired or behind pin is the one status line that names its own fix,
+ * because every engine-needing verb refuses until it is re-pinned. Retired
+ * wins over behind.
  */
 function renderRuntime(status) {
-    const pin = status.runtimeVersion;
-    if (!pin)
-        return "gateway default (apollo runtime use)";
-    const pinned = status.runtimePinned;
-    if (!pinned)
-        return pin;
-    const shown = pinned.label && pinned.label !== pin ? `${pin} (${pinned.label})` : pin;
-    if (!pinned.available) {
-        return `${shown} — NOT AVAILABLE, run apollo runtime use ${pinned.latest ?? "latest"}`;
-    }
-    return pinned.engine ? `${shown} — serving engine ${pinned.engine}` : shown;
+    return describeRuntimePin(status) ?? "gateway default (apollo runtime use)";
 }
 function renderCheckout(status) {
     if (!status.agentRoot) {

package/node_modules/@aui.io/apollo-cli/dist/src/commands/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-cli/dist/src/meta.d.ts

@@ -1,4 +1,14 @@
-/** The only package published to npm — CLI + TUI are bundled inside it. */
+/** The public distribution — CLI + TUI are bundled inside it. */
 export declare const APOLLO_PACKAGE_NAME = "@aui.io/apollo";
+export interface PackageMeta {
+    name: string;
+    version: string;
+}
+/**
+ * The console this module ships in. A distribution bundles this package under
+ * its own node_modules, so the nearest ancestor bundling it is the installed
+ * distribution; outside one, this package's own manifest (kept in lockstep).
+ */
+export declare function resolveConsoleMeta(modulePath: string): PackageMeta;
 export declare const CLI_PACKAGE_NAME = "@aui.io/apollo";
 export declare const CLI_VERSION: string;

package/node_modules/@aui.io/apollo-cli/dist/src/meta.js

@@ -1,65 +1,69 @@
-import { createRequire } from "node:module";
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-/** The only package published to npm — CLI + TUI are bundled inside it. */
+/** The public distribution — CLI + TUI are bundled inside it. */
 export const APOLLO_PACKAGE_NAME = "@aui.io/apollo";
-function readJson(path) {
+/** This package, as the distributions name it in `bundleDependencies`. */
+const CLI_PACKAGE = "@aui.io/apollo-cli";
+function readManifest(path) {
     try {
         const raw = JSON.parse(readFileSync(path, "utf8"));
-        if (typeof raw.name === "string" && typeof raw.version === "string") {
-            return { name: raw.name, version: raw.version };
+        if (typeof raw.name !== "string" || typeof raw.version !== "string") {
+            return undefined;
         }
+        const bundled = raw.bundleDependencies ?? raw.bundledDependencies;
+        return {
+            name: raw.name,
+            version: raw.version,
+            dependencies: typeof raw.dependencies === "object" && raw.dependencies !== null
+                ? raw.dependencies
+                : {},
+            bundleDependencies: bundled === true ||
+                (Array.isArray(bundled) && bundled.every((v) => typeof v === "string"))
+                ? bundled
+                : [],
+        };
     }
     catch {
-        // missing / unreadable
+        return undefined;
     }
-    return undefined;
 }
-/**
- * Prefer the installed `@aui.io/apollo` version (global/meta install). Fall
- * back to the workspace apollo package, then the local cli package version
- * (dev / path install).
- */
-function loadApolloMeta() {
-    try {
-        const require = createRequire(import.meta.url);
-        const fromInstall = readJson(require.resolve(`${APOLLO_PACKAGE_NAME}/package.json`));
-        if (fromInstall)
-            return { name: APOLLO_PACKAGE_NAME, version: fromInstall.version };
-    }
-    catch {
-        // not installed as the meta package
-    }
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 8; i++) {
-        const sibling = readJson(join(dir, "apollo", "package.json"));
-        if (sibling?.name === APOLLO_PACKAGE_NAME) {
-            return { name: APOLLO_PACKAGE_NAME, version: sibling.version };
-        }
-        const here = readJson(join(dir, "package.json"));
-        if (here?.name === APOLLO_PACKAGE_NAME) {
-            return { name: APOLLO_PACKAGE_NAME, version: here.version };
-        }
+/** `bundleDependencies: true` bundles every dependency (npm semantics). */
+function bundlesCli(manifest) {
+    return manifest.bundleDependencies === true
+        ? CLI_PACKAGE in manifest.dependencies
+        : manifest.bundleDependencies.includes(CLI_PACKAGE);
+}
+function* ancestors(dir) {
+    for (;;) {
+        yield dir;
         const parent = dirname(dir);
         if (parent === dir)
-            break;
+            return;
         dir = parent;
     }
-    // Last resort: workspace cli version (kept in sync with apollo).
-    dir = dirname(fileURLToPath(import.meta.url));
-    for (let i = 0; i < 5; i++) {
-        const here = readJson(join(dir, "package.json"));
-        if (here)
-            return { name: APOLLO_PACKAGE_NAME, version: here.version };
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
+}
+/**
+ * The console this module ships in. A distribution bundles this package under
+ * its own node_modules, so the nearest ancestor bundling it is the installed
+ * distribution; outside one, this package's own manifest (kept in lockstep).
+ */
+export function resolveConsoleMeta(modulePath) {
+    let own;
+    for (const dir of ancestors(dirname(modulePath))) {
+        const manifest = readManifest(join(dir, "package.json"));
+        if (manifest === undefined)
+            continue;
+        if (bundlesCli(manifest)) {
+            return { name: manifest.name, version: manifest.version };
+        }
+        own ??= { name: manifest.name, version: manifest.version };
     }
-    throw new Error("Unable to locate @aui.io/apollo package version.");
+    if (own !== undefined)
+        return own;
+    throw new Error("Unable to locate the apollo console package version.");
 }
-const meta = loadApolloMeta();
+const meta = resolveConsoleMeta(fileURLToPath(import.meta.url));
 export const CLI_PACKAGE_NAME = APOLLO_PACKAGE_NAME;
 export const CLI_VERSION = meta.version;
 //# sourceMappingURL=meta.js.map

package/node_modules/@aui.io/apollo-cli/dist/src/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,iEAAiE;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAEpD,0EAA0E;AAC1E,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAYzC,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAMhD,CAAC;QACF,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,kBAAkB,IAAI,GAAG,CAAC,mBAAmB,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,YAAY,EACV,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI;gBAC/D,CAAC,CAAE,GAAG,CAAC,YAAwC;gBAC/C,CAAC,CAAC,EAAE;YACR,kBAAkB,EAChB,OAAO,KAAK,IAAI;gBAChB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;gBACrE,CAAC,CAAE,OAA2B;gBAC9B,CAAC,CAAC,EAAE;SACT,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,SAAS,UAAU,CAAC,QAAyB;IAC3C,OAAO,QAAQ,CAAC,kBAAkB,KAAK,IAAI;QACzC,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC,YAAY;QACtC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACxD,CAAC;AAED,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAW;IAC7B,SAAS,CAAC;QACR,MAAM,GAAG,CAAC;QACV,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO;QAC3B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,IAAI,GAA4B,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACrC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC5D,CAAC;QACD,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAClC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AACpD,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC"}

package/node_modules/@aui.io/apollo-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aui.io/apollo-cli",
-  "version": "0.1.67",
+  "version": "0.1.70",
   "description": "Command-line client for the Apollo runtime",
   "type": "module",
   "engines": {
@@ -33,12 +33,12 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@aui.io/apollo-core": "0.1.67",
+    "@aui.io/apollo-core": "0.1.70",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1"
   },
   "optionalDependencies": {
-    "@aui.io/apollo-tui": "0.1.67"
+    "@aui.io/apollo-tui": "0.1.70"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.5",

package/node_modules/@aui.io/apollo-core/dist/src/config/index.js

@@ -101,6 +101,15 @@ export async function resolveContext(options = {}) {
     const runtimeVersion = trimmed(flags.runtimeVersion ??
         env.APOLLO_RUNTIME_VERSION ??
         binding?.runtime_version);
+    // Same precedence as the fold above, so the source names the value that
+    // actually won (an empty flag still wins the fold and leaves it unpinned).
+    const runtimeVersionSource = flags.runtimeVersion !== undefined
+        ? "flag"
+        : env.APOLLO_RUNTIME_VERSION !== undefined
+            ? "env"
+            : binding?.runtime_version !== undefined
+                ? "binding"
+                : undefined;
     const defaults = environmentDefinition(environment).urls;
     return Object.freeze({
         environment,
@@ -140,6 +149,9 @@ export async function resolveContext(options = {}) {
         // The pin is per checkout; the flag and env var override it for one
         // command without ever being written back to `.apollorc`.
         ...(runtimeVersion === undefined ? {} : { runtimeVersion }),
+        ...(runtimeVersion === undefined || runtimeVersionSource === undefined
+            ? {}
+            : { runtimeVersionSource }),
         ...(token === undefined ? {} : { token }),
         ...(credential?.user_id ?? claims.userId
             ? { userId: credential?.user_id ?? claims.userId }

package/node_modules/@aui.io/apollo-core/dist/src/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAQpB,MAAM,kBAAkB,GAAG,MAAM,CAAC;AASlC;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAqC;IACtE;QACE,YAAY;QACZ;YACE,IAAI,EAAE;gBACJ,QAAQ,EAAE,2BAA2B;gBACrC,UAAU,EAAE,kCAAkC;gBAC9C,OAAO,EAAE,+BAA+B;gBACxC,MAAM,EAAE,mCAAmC;gBAC3C,GAAG,EAAE,8CAA8C;gBACnD,aAAa,EAAE,sCAAsC;gBACrD,OAAO,EAAE,mCAAmC;aAC7C;YACD,aAAa,EAAE,uBAAuB;SACvC;KACF;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,UAAiC;IAEjC,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,CAAC,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAiB;IAEjB,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,IAAI,WAAW,CACnB,wBAAwB,IAAI,IAAI,EAChC,kBAAkB,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpD,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AASD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjD,MAAM,IAAI,WAAW,CACnB,wBAAwB,KAAK,IAAI,EACjC,kBAAkB,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,WAAW,CAAC,GAAG,CAAC;QAChB,cAAc,CAAC,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC;IACrC,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC;IAEtC,qEAAqE;IACrE,yEAAyE;IACzE,4DAA4D;IAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC;IAC9C,MAAM,QAAQ,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACnF,MAAM,gBAAgB,GAAG,MAAM,uBAAuB,CACpD,OAAO,EAAE,WAAW,EACpB,WAAW,EACX,OAAO,CACR,CAAC;IACF,IACE,QAAQ,KAAK,SAAS;QACtB,gBAAgB,KAAK,SAAS;QAC9B,QAAQ,KAAK,gBAAgB,EAC7B,CAAC;QACD,MAAM,IAAI,WAAW,CACnB,0CAA0C,gBAAgB,WAAW,QAAQ,kBAAkB,EAC/F,uEAAuE,QAAQ,IAAI,CACpF,CAAC;IACJ,CAAC;IACD,uEAAuE;IACvE,uEAAuE;IACvE,0EAA0E;IAC1E,MAAM,gBAAgB,GACpB,UAAU,CAAC,WAAW,KAAK,SAAS;QACpC,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7C,CAAC,CAAC,UAAU,CAAC,WAAW;QACxB,CAAC,CAAC,SAAS,CAAC;IAChB,IACE,QAAQ,KAAK,SAAS;QACtB,gBAAgB,KAAK,SAAS;QAC9B,gBAAgB,KAAK,SAAS;QAC9B,UAAU,CAAC,WAAW,KAAK,SAAS,EACpC,CAAC;QACD,2BAA2B,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACtD,CAAC;IACD,MAAM,WAAW,GACf,QAAQ,IAAI,gBAAgB,IAAI,gBAAgB,IAAI,YAAY,CAAC;IACnE,MAAM,OAAO,GACX,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,IAAI,UAAU,CAAC,OAAO,IAAI,SAAS,CAAC;IACzE,wEAAwE;IACxE,yEAAyE;IACzE,uEAAuE;IACvE,6CAA6C;IAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,kBAAkB,GAAG,WAAW;QACpC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACrD,MAAM,WAAW,GACf,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,IAAI,UAAU,EAAE,YAAY,CAAC;IAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,IAAI,GAAG,CAAC,iBAAiB,CAAC;IAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,cAAc,GAAG,OAAO,CAC5B,KAAK,CAAC,cAAc;QAClB,GAAG,CAAC,sBAAsB;QAC1B,OAAO,EAAE,eAAe,CAC3B,CAAC;IACF,MAAM,QAAQ,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IAEzD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW;QACX,OAAO;QACP,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,mBAAmB,IAAI,QAAQ,CAAC,QAAQ,CAAC;YAClE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,qBAAqB,IAAI,QAAQ,CAAC,UAAU,CAAC;YACxE,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,kBAAkB,IAAI,QAAQ,CAAC,OAAO,CAAC;YAC/D,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,iBAAiB,IAAI,QAAQ,CAAC,MAAM,CAAC;YAC5D,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,GAAG,CAAC;YACnD,aAAa,EAAE,UAAU,CACvB,GAAG,CAAC,yBAAyB,IAAI,QAAQ,CAAC,aAAa,CACxD;YACD,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,kBAAkB,IAAI,QAAQ,CAAC,OAAO,CAAC;SAChE,CAAC;QACF,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,IAAI,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,cAAc;YAC5E,CAAC,CAAC;gBACE,KAAK,EACH,KAAK,CAAC,GAAG;oBACT,GAAG,CAAC,aAAa;oBACjB,OAAO,EAAE,MAAM;oBACf,MAAM,CAAC,cAAc;aACxB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,OAAO;YACjB,GAAG,CAAC,iBAAiB;YACrB,OAAO,EAAE,UAAU;YACnB,kBAAkB;YAChB,CAAC,CAAC;gBACE,SAAS,EACP,KAAK,CAAC,OAAO;oBACb,GAAG,CAAC,iBAAiB;oBACrB,OAAO,EAAE,UAAU;oBACnB,kBAAkB;aACrB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QACxC,oEAAoE;QACpE,0DAA0D;QAC1D,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM;YACtC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,EAAE;YACvC,CAAC,CAAC,EAAE,CAAC;QACP,SAAS;QACT,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;QAC9D,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrD,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,KAAK,UAAU,uBAAuB,CACpC,OAA2B,EAC3B,WAA+B,EAC/B,OAAe;IAEf,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,WAAW,CACnB,0CAA0C,OAAO,2CAA2C,EAC5F,sCAAsC,OAAO,2CAA2C,iBAAiB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC1H,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,OAAO;SACJ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;SAC7C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CACrC,CAAC;IACF,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;IAC5B,OAAO,IAAI,KAAK,SAAS,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED;oEACoE;AACpE,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE7C,SAAS,2BAA2B,CAAC,IAAY;IAC/C,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IACzC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,EAAE,CAAC,GAAG,CACP,6CAA6C,IAAI,wEAAwE,CAC1H,IAAI,CACN,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,kBAAkB,CAAC;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,WAAW,CAAC,qDAAqD,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,6EAA6E;AAC7E,SAAS,OAAO,CAAC,KAAyB;IACxC,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,eAAe,CACtB,KAAyB;IAEzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACxB,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC;QAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC;QACxD,OAAO;YACL,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAaD,OAAO,EACL,SAAS,EACT,cAAc,EACd,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/config/types.d.ts

@@ -82,6 +82,13 @@ export interface Context {
      * gateway pick.
      */
     readonly runtimeVersion?: string;
+    /**
+     * Which of the three won: the flag, the env var, or the checkout's
+     * `.apollorc`. A flag or env pin is the user's explicit choice for one
+     * command, so the drift check (`RUNTIME_BEHIND`) skips it; only a binding
+     * pin can be behind. Absent when unpinned.
+     */
+    readonly runtimeVersionSource?: "flag" | "env" | "binding";
     readonly token?: string;
     readonly userId?: string;
     readonly timeoutMs: number;

package/node_modules/@aui.io/apollo-core/dist/src/errors/index.d.ts

@@ -52,6 +52,37 @@ export declare class RuntimeUnavailableError extends CliError {
         detail?: unknown;
     });
 }
+/**
+ * The checkout's pin is an older patch of a family that has moved on. The
+ * gateway routes by family, so the engine already runs the current build —
+ * what is stale is local: the pin, the schemas/skills/AGENTS.md fetched
+ * under it, and the `runtime_version` the next push would record. Every
+ * engine-needing verb refuses on it; the fix is a re-pin and a validate, no
+ * checkpoint and no builder turn, because nothing about the engine changed.
+ *
+ * Exit 3 (configuration), not 1 like `RuntimeUnavailableError`: the runtime
+ * is fine and the checkout's record of it is what is wrong. A script can
+ * tell "re-pin and go" from "the family is gone" by the exit code alone.
+ */
+export declare class RuntimeBehindError extends CliError {
+    /** The pin as the checkout recorded it (e.g. "0.9.2"). */
+    readonly pinned: string;
+    /** The family's current build — the re-pin target (e.g. "0.9.7"). */
+    readonly current: string;
+    constructor(options: {
+        pinned: string;
+        current: string;
+        /** The catalog display name ("v2.1"); shown when it differs from the pin. */
+        label?: string;
+    });
+}
+/**
+ * The two steps that bring a behind checkout back onto its family's current
+ * build. Deliberately NOT `runtimeUpgradeSuggestion`: that one crosses to a
+ * new family and needs a checkpoint and a builder turn; this one changes no
+ * engine, so the program is only re-validated on the refreshed contract.
+ */
+export declare function runtimeRepinSuggestion(current: string): string;
 /**
  * The three steps that move a checkout off a dead runtime, in order: re-pin
  * (which refreshes the schemas/skills the new engine serves), checkpoint the

package/node_modules/@aui.io/apollo-core/dist/src/errors/index.js

@@ -83,6 +83,60 @@ export class RuntimeUnavailableError extends CliError {
             this.latest = options.latest;
     }
 }
+/**
+ * The checkout's pin is an older patch of a family that has moved on. The
+ * gateway routes by family, so the engine already runs the current build —
+ * what is stale is local: the pin, the schemas/skills/AGENTS.md fetched
+ * under it, and the `runtime_version` the next push would record. Every
+ * engine-needing verb refuses on it; the fix is a re-pin and a validate, no
+ * checkpoint and no builder turn, because nothing about the engine changed.
+ *
+ * Exit 3 (configuration), not 1 like `RuntimeUnavailableError`: the runtime
+ * is fine and the checkout's record of it is what is wrong. A script can
+ * tell "re-pin and go" from "the family is gone" by the exit code alone.
+ */
+export class RuntimeBehindError extends CliError {
+    /** The pin as the checkout recorded it (e.g. "0.9.2"). */
+    pinned;
+    /** The family's current build — the re-pin target (e.g. "0.9.7"). */
+    current;
+    constructor(options) {
+        const shown = options.label && options.label !== options.pinned
+            ? `${options.pinned} (${options.label})`
+            : options.pinned;
+        super(`This checkout is pinned to runtime ${shown}; its family's current build is ${options.current}.`, {
+            code: "RUNTIME_BEHIND",
+            exitCode: ExitCode.configuration,
+            suggestion: runtimeRepinSuggestion(options.current),
+        });
+        this.name = "RuntimeBehindError";
+        this.pinned = options.pinned;
+        this.current = options.current;
+    }
+}
+/**
+ * The two steps that bring a behind checkout back onto its family's current
+ * build. Deliberately NOT `runtimeUpgradeSuggestion`: that one crosses to a
+ * new family and needs a checkpoint and a builder turn; this one changes no
+ * engine, so the program is only re-validated on the refreshed contract.
+ */
+export function runtimeRepinSuggestion(current) {
+    const steps = [
+        [
+            `apollo runtime use ${current}`,
+            "re-pins and refreshes schemas, skills and AGENTS.md; src and build bundle untouched",
+        ],
+        [
+            "apollo validate",
+            "confirms the program and build bundle still pass on the refreshed contract",
+        ],
+    ];
+    // One column for the explanations, whatever the build's length.
+    const width = Math.max(...steps.map(([command]) => command.length)) + 4;
+    return steps
+        .map(([command, why], index) => `${index + 1}. ${command.padEnd(width)}${why}`)
+        .join("\n");
+}
 /**
  * The three steps that move a checkout off a dead runtime, in order: re-pin
  * (which refreshes the schemas/skills the new engine serves), checkpoint the

package/node_modules/@aui.io/apollo-core/dist/src/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/index.d.ts

@@ -21,7 +21,7 @@ export { environmentDefinition, knownEnvironments, parseEnvironment, registerEnv
 export { clearMockDbKeys, keyPrefixes, loadMockDbKeys, saveMockDbKeys, type MockDbKeys, } from "./config/mockdb-keys.js";
 export { apolloDir, findBinding, patchBinding, readBinding, readCredentials, readUserConfig, updateEnvironment, updateProfile, writeBinding, writeCredentials, writeUserConfig, type ConfigPaths, } from "./config/store.js";
 export { type BaseUrls, type ConfigFlags, type Context, type Credential, type CredentialsFile, type Environment, type ProjectBinding, type UserConfig, type WorkspacePreferences, } from "./config/types.js";
-export { ApiError, AuthError, CliError, ConfigError, ExitCode, RuntimeUnavailableError, ValidationError, runtimeUpgradeSuggestion, toCliError, type ExitCodeValue, type RuntimeUnavailableReason, } from "./errors/index.js";
+export { ApiError, AuthError, CliError, ConfigError, ExitCode, RuntimeBehindError, RuntimeUnavailableError, ValidationError, runtimeRepinSuggestion, runtimeUpgradeSuggestion, toCliError, type ExitCodeValue, type RuntimeUnavailableReason, } from "./errors/index.js";
 export { Output, errorEnvelope, successEnvelope, type ErrorEnvelope, type OutputOptions, type SuccessEnvelope, } from "./output/index.js";
 export { loginWithBrowser, loginWithOtp, loginWithToken, logout, requestOtp, } from "./services/auth.js";
 export { DEFAULT_SKILL_TARGETS, RUNTIME_REFRESH_DIRECTIVE, agentRoot, importBundle, listVersions, localDiff, pullBundle, pullCheckout, pushBundle, readCheckoutTree, refreshRuntimeAssets, remoteDiff, validateLocalBundle, validateProgramBundle, type BuildAreaSync, type BundleValidation, type PullCheckoutOptions, type PullCheckoutResult, type PushCheckoutResult, type RuntimeAssetsOptions, type RuntimeAssetsResult, } from "./services/bundles.js";
@@ -30,7 +30,7 @@ export { BUILD_DEADLINE_MS, buildAgent, type BuildOptions, } from "./services/bu
 export { createClients, type Clients } from "./services/clients.js";
 export { listEnvironments, setEnvironment, type EnvironmentResult, type EnvironmentSummary, } from "./services/env.service.js";
 export { agentRuntimeVersion, bindAgent, createAgent, createProject, initialVersionTag, latestPublishedRuntimeVersion, listAgents, listOrganizations, listProjects, unlinkAgent, useOrganization, useProject, useVersion, } from "./services/hierarchy.js";
-export { AVAILABILITY_CACHE_FILE, AVAILABILITY_CACHE_TTL_MS, assertRuntimeAvailable, availabilityCachePath, checkRuntimeAvailability, familyOf, probeRuntimeAvailability, verdictFromHealth, type AvailabilityOptions, type RuntimeAvailability, type RuntimeHealth, type RuntimePinCheck, } from "./runtime-version/availability.js";
+export { AVAILABILITY_CACHE_FILE, AVAILABILITY_CACHE_TTL_MS, assertRuntimeAvailable, availabilityCachePath, behindBuild, checkRuntimeAvailability, familyOf, probeRuntimeAvailability, verdictFromHealth, type AvailabilityOptions, type RuntimeAvailability, type RuntimeHealth, type RuntimePinCheck, } from "./runtime-version/availability.js";
 export { isLegacyRuntime, isRoutableRuntimeBuild, latestRuntimeVersion, matchRuntimeVersion, resolveRuntimeVersion, runtimeRouteResolver, runtimeVersionLabel, runtimeVersionOptions, RUNTIME_VERSION_HEADER, type ResolvedRuntimeVersion, type RuntimeVersionOption, } from "./runtime-version/index.js";
 export { createThread, getThread, listMessages, listThreads, parseVariables, sendMessage, trace, } from "./services/messaging.js";
 export { cloneMockDb, createCollection, createEndpoint, DEFAULT_MOCKDB_TOKEN_ENV, deleteEndpoint, deleteMockDb, describeMockDb, executeEndpoint, exportMockDb, getEndpoint, getIdentities, inspectSession, listCollections, listEndpoints, MOCKDB_GUIDE, normalizeAddColumns, normalizeSampleData, normalizeSchema, parseJsonFlag, provisionMockDb, readSampleDataInput, resetSession, resolveMockDb, rotateMgmtKey, rotateRuntimeKey, seedRows, setIdentities, statusMockDb, storedKeys, updateCollection, updateEndpoint, wireMockDbConnection, writeMockDbGuide, type CloneMockDbOptions, type MockDbProvisionResult, type MockDbResolved, type MockDbServiceOptions, type MockDbStatusReport, type MockDbStatusVerdict, type RuntimeKeyResync, type RuntimeKeySource, type WireResult, } from "./services/mockdb.js";
@@ -40,7 +40,7 @@ export { addFiles, addUrls, createHub, deleteHub, getHubByName, hubRefCheck, hub
 export { currentProfile, listProfiles, useProfile, type CurrentProfile, type ProfileSummary, } from "./services/profile.service.js";
 export { captureFailed, filterCaptures, formatCurl, readCapturedRequests, type CaptureFilters, } from "./services/requests.js";
 export { runDoctor, type DoctorCheck, type DoctorOptions, type DoctorReport, type DoctorSection, type DoctorStatus, } from "./services/doctor.js";
-export { getStatus, type ServiceCheck, type StatusResult, } from "./services/status.service.js";
+export { describeRuntimePin, getStatus, type ServiceCheck, type StatusResult, } from "./services/status.service.js";
 export { resolvePublishedVersion, upgradeCli, type NpmRunner, type UpgradeOptions, type UpgradeResult, } from "./services/upgrade.js";
 export { PUBLIC_UPDATE_TARGET, UPDATE_CHECK_FILE, UPDATE_CHECK_TTL_MS, checkForUpdate, compareVersions, formatUpdateNotice, isUpdateEntryStale, readUpdateCache, readUpdateEntry, recordLatestVersion, refreshUpdateCache, setUpdateTarget, updateCheckDisabled, updateCheckPath, updateNoticeFrom, updateTarget, upgradeCommand, writeUpdateEntry, type RefreshUpdateCacheOptions, type UpdateCheckEntry, type UpdateCheckFile, type UpdateNotice, type UpdateTarget, } from "./services/update-check.js";
 export { enterCheckout, enterKnownCheckout, listKnownCheckouts, type EnteredCheckout, } from "./services/checkouts.service.js";

package/node_modules/@aui.io/apollo-core/dist/src/index.js

@@ -19,7 +19,7 @@ export { assertValidProgram, mapRuntimeValidation, renderValidation, } from "./b
 export { environmentDefinition, knownEnvironments, parseEnvironment, registerEnvironment, resolveContext, } from "./config/index.js";
 export { clearMockDbKeys, keyPrefixes, loadMockDbKeys, saveMockDbKeys, } from "./config/mockdb-keys.js";
 export { apolloDir, findBinding, patchBinding, readBinding, readCredentials, readUserConfig, updateEnvironment, updateProfile, writeBinding, writeCredentials, writeUserConfig, } from "./config/store.js";
-export { ApiError, AuthError, CliError, ConfigError, ExitCode, RuntimeUnavailableError, ValidationError, runtimeUpgradeSuggestion, toCliError, } from "./errors/index.js";
+export { ApiError, AuthError, CliError, ConfigError, ExitCode, RuntimeBehindError, RuntimeUnavailableError, ValidationError, runtimeRepinSuggestion, runtimeUpgradeSuggestion, toCliError, } from "./errors/index.js";
 export { Output, errorEnvelope, successEnvelope, } from "./output/index.js";
 export { loginWithBrowser, loginWithOtp, loginWithToken, logout, requestOtp, } from "./services/auth.js";
 export { DEFAULT_SKILL_TARGETS, RUNTIME_REFRESH_DIRECTIVE, agentRoot, importBundle, listVersions, localDiff, pullBundle, pullCheckout, pushBundle, readCheckoutTree, refreshRuntimeAssets, remoteDiff, validateLocalBundle, validateProgramBundle, } from "./services/bundles.js";
@@ -28,7 +28,7 @@ export { BUILD_DEADLINE_MS, buildAgent, } from "./services/builds.js";
 export { createClients } from "./services/clients.js";
 export { listEnvironments, setEnvironment, } from "./services/env.service.js";
 export { agentRuntimeVersion, bindAgent, createAgent, createProject, initialVersionTag, latestPublishedRuntimeVersion, listAgents, listOrganizations, listProjects, unlinkAgent, useOrganization, useProject, useVersion, } from "./services/hierarchy.js";
-export { AVAILABILITY_CACHE_FILE, AVAILABILITY_CACHE_TTL_MS, assertRuntimeAvailable, availabilityCachePath, checkRuntimeAvailability, familyOf, probeRuntimeAvailability, verdictFromHealth, } from "./runtime-version/availability.js";
+export { AVAILABILITY_CACHE_FILE, AVAILABILITY_CACHE_TTL_MS, assertRuntimeAvailable, availabilityCachePath, behindBuild, checkRuntimeAvailability, familyOf, probeRuntimeAvailability, verdictFromHealth, } from "./runtime-version/availability.js";
 export { isLegacyRuntime, isRoutableRuntimeBuild, latestRuntimeVersion, matchRuntimeVersion, resolveRuntimeVersion, runtimeRouteResolver, runtimeVersionLabel, runtimeVersionOptions, RUNTIME_VERSION_HEADER, } from "./runtime-version/index.js";
 export { createThread, getThread, listMessages, listThreads, parseVariables, sendMessage, trace, } from "./services/messaging.js";
 export { cloneMockDb, createCollection, createEndpoint, DEFAULT_MOCKDB_TOKEN_ENV, deleteEndpoint, deleteMockDb, describeMockDb, executeEndpoint, exportMockDb, getEndpoint, getIdentities, inspectSession, listCollections, listEndpoints, MOCKDB_GUIDE, normalizeAddColumns, normalizeSampleData, normalizeSchema, parseJsonFlag, provisionMockDb, readSampleDataInput, resetSession, resolveMockDb, rotateMgmtKey, rotateRuntimeKey, seedRows, setIdentities, statusMockDb, storedKeys, updateCollection, updateEndpoint, wireMockDbConnection, writeMockDbGuide, } from "./services/mockdb.js";
@@ -38,7 +38,7 @@ export { addFiles, addUrls, createHub, deleteHub, getHubByName, hubRefCheck, hub
 export { currentProfile, listProfiles, useProfile, } from "./services/profile.service.js";
 export { captureFailed, filterCaptures, formatCurl, readCapturedRequests, } from "./services/requests.js";
 export { runDoctor, } from "./services/doctor.js";
-export { getStatus, } from "./services/status.service.js";
+export { describeRuntimePin, getStatus, } from "./services/status.service.js";
 export { resolvePublishedVersion, upgradeCli, } from "./services/upgrade.js";
 export { PUBLIC_UPDATE_TARGET, UPDATE_CHECK_FILE, UPDATE_CHECK_TTL_MS, checkForUpdate, compareVersions, formatUpdateNotice, isUpdateEntryStale, readUpdateCache, readUpdateEntry, recordLatestVersion, refreshUpdateCache, setUpdateTarget, updateCheckDisabled, updateCheckPath, updateNoticeFrom, updateTarget, upgradeCommand, writeUpdateEntry, } from "./services/update-check.js";
 export { enterCheckout, enterKnownCheckout, listKnownCheckouts, } from "./services/checkouts.service.js";

package/node_modules/@aui.io/apollo-core/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/node_modules/@aui.io/apollo-core/dist/src/runtime-version/availability.d.ts

@@ -46,11 +46,32 @@ export interface RuntimePinCheck {
     label?: string;
     /** The catalog's newest published build — the re-pin target. */
     latest?: string;
+    /**
+     * The pinned FAMILY's current build when the pin is an older (or
+     * otherwise different) patch of it — the `runtime use` target that ends
+     * the drift. Distinct from `latest`, which names the newest family.
+     * Absent when current, unpinned by build, or the catalog was not read.
+     */
+    behind?: string;
+    /** The pin came from `--runtime-version` or `APOLLO_RUNTIME_VERSION`, not
+     *  `.apollorc` — an explicit choice for this command, so `behind` is
+     *  reported but never enforced. */
+    overridden?: boolean;
     /** The catalog could not be read; see `withoutCatalog`. */
     catalogError?: string;
     /** The verdict came from the on-disk cache, not a fresh probe. */
     cached?: boolean;
 }
+/**
+ * The drift rule, pure. The family's current build when `pin` is a full
+ * build of the same family as `option` and not the build the catalog
+ * routes to; undefined otherwise. Custom records match by exact name and
+ * have no family; a family pin ("0.9"), a label ("v2.1") or any other
+ * non-build spelling is resolved to the current build at call time by the
+ * route resolver, so it cannot be behind. `!==` rather than "older than":
+ * a pin AHEAD of a rolled-back family must equal the routed build too.
+ */
+export declare function behindBuild(option: RuntimeVersionOption, pin: string): string | undefined;
 export interface AvailabilityOptions {
     fetch?: typeof globalThis.fetch;
     /** `false` bypasses the on-disk verdict cache (neither read nor written). */
@@ -73,8 +94,10 @@ export declare function checkRuntimeAvailability(context: Context, clients: {
 /**
  * The gate every engine-needing verb runs first. Throws
  * `RuntimeUnavailableError` (code `RUNTIME_UNAVAILABLE`) when the pin is no
- * longer served; returns quietly when unpinned, when the pin is served, or
- * when the catalog cannot be read.
+ * longer served, else `RuntimeBehindError` (code `RUNTIME_BEHIND`) when the
+ * `.apollorc` pin is an older patch of a served family; returns quietly
+ * when unpinned, when the pin is served and current, under a flag/env
+ * override, or when the catalog cannot be read.
  */
 export declare function assertRuntimeAvailable(context: Context, clients: {
     agentSettings: Pick<AgentSettingsClient, "listRuntimeVersions">;