@faable/faable 4.18.2 → 4.18.4

package/dist/commands/deploy/inspect/open.js

@@ -1,5 +1,6 @@
 import openBrowser from 'open';
 import { requireApi } from '../../../api/context.js';
+import { dashboardAppUrl } from '../../../lib/dashboard_url.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
 
@@ -25,7 +26,7 @@ const open_app = {
         const app_id = await resolve_app_id(args.app, ctx.appId, ctx.api);
         const app = await ctx.api.getApp(app_id);
         const url = args.dashboard
-            ? `https://dashboard.faable.com/deploy/${app.team}/app/${app.id}`
+            ? dashboardAppUrl(String(app.team), app.id)
             : `https://${app.url}`;
         log.info(`🌍 Opening ${url}`);
         await openBrowser(url).catch(() => {

package/dist/commands/deploy/inspect/trigger.js

@@ -1,4 +1,5 @@
 import { requireApi } from '../../../api/context.js';
+import { dashboardAppUrl } from '../../../lib/dashboard_url.js';
 import { print_json, json_option } from '../../../lib/listing.js';
 import { log } from '../../../log.js';
 import { resolve_app_id } from '../resolve_app_id.js';
@@ -55,7 +56,7 @@ const trigger = {
         if (result.deployment_id) {
             log.info(`Follow the build: faable deploy logs --build -d ${result.deployment_id} -a ${app.id} --follow`);
         }
-        log.info(`Track it with: faable deploy status -a ${app.id}  ·  or in the dashboard: https://dashboard.faable.com/deploy/${app.team}/app/${app.id}`);
+        log.info(`Track it with: faable deploy status -a ${app.id}  ·  or in the dashboard: ${dashboardAppUrl(String(app.team), app.id)}`);
     }
 };
 

package/dist/commands/deploy/launch.js

@@ -1,15 +1,16 @@
 import { requireApi } from '../../api/context.js';
+import { requireProject } from '../../api/project.js';
 import { Configuration } from '../../lib/Configuration.js';
+import { dashboardAppUrl } from '../../lib/dashboard_url.js';
 import { CliError } from '../../lib/errors.js';
 import { is_non_interactive, confirm } from '../../lib/interactive.js';
 import { print_json } from '../../lib/listing.js';
 import { log } from '../../log.js';
-import { requireProject } from '../../api/project.js';
+import { assert_name_free } from './apps/name_free.js';
 import { git_context } from './git_context.js';
 import { show_deploy_help } from './help.js';
 import { reachable_timeout_ms, wait_reachable } from './reachable.js';
 import { propose_release } from './release_version.js';
-import { assert_name_free } from './apps/name_free.js';
 import { deploy_remote } from './remote/index.js';
 import { collect_manifest } from './remote/manifest.js';
 import { find_app_id } from './resolve_app_id.js';
@@ -142,7 +143,10 @@ const launch = {
             // Propose the release version (--release > FAABLE_RELEASE > git tag).
             // Optional: when absent the platform injects no FAABLE_RELEASE and the
             // app falls back to its own version source.
-            const proposed = await propose_release({ workdir, explicit: args.release });
+            const proposed = await propose_release({
+                workdir,
+                explicit: args.release
+            });
             if (proposed) {
                 log.info(`🏷️ Release: ${proposed.release} (from ${proposed.source})`);
             }
@@ -165,7 +169,7 @@ const launch = {
                     deployment_started = true;
                 }
             });
-            const dashboard_url = `https://dashboard.faable.com/deploy/${app.team}/app/${app.id}`;
+            const dashboard_url = dashboardAppUrl(String(app.team), app.id);
             log.info(`Preparing to deploy in faable cloud · ${deployment.id}`);
             log.info(`📊 View it in the dashboard -> ${dashboard_url}`);
             // Wait (up to 5 minutes) for the deployment to be promoted (live)
@@ -253,7 +257,10 @@ const launch = {
                             phase: failure.phase,
                             reason: failure.reason,
                             ...(fault
-                                ? { fault_owner: fault.fault_owner, error_code: fault.error_code }
+                                ? {
+                                    fault_owner: fault.fault_owner,
+                                    error_code: fault.error_code
+                                }
                                 : {})
                         }
                         : {}),

package/dist/commands/deploy/remote/follow.js

@@ -5,14 +5,34 @@ const POLL_INTERVAL_MS = 4000;
 // 30min, abandoned janitor 60min) resolve the deployment first in practice.
 const FOLLOW_TIMEOUT_MS = 45 * 60 * 1000;
 const wait = (ms) => new Promise((r) => setTimeout(r, ms));
+/** The clone the platform created to retry this failed build, if any. */
+const retry_of = (deployment) => {
+    const retry = deployment?.runtime_fallback_retry;
+    if (!retry?.deployment_id)
+        return null;
+    // The api stores the clone as bare hex (a `.lean()` ObjectId).
+    const id = retry.deployment_id.startsWith("deployment_")
+        ? retry.deployment_id
+        : `deployment_${retry.deployment_id}`;
+    return { id, to: retry.to };
+};
 /**
  * Follow a remote build until the image handoff: poll the phase and tail the
  * build logs the builder uploads every ~10s (replace semantics → print the
  * suffix beyond what we already showed). Returns on INITIALIZING/READY
  * (image landed — the regular promotion poll takes over); throws on
  * BUILD_ERROR/ERROR with the server-provided reason.
+ *
+ * One exception to "BUILD_ERROR throws": when the platform already retried
+ * the build on the previous Python (`runtime_fallback_retry`, api §12), the
+ * failure is not the outcome — the clone's is. Follow the clone instead and
+ * return ITS id, so the promotion poll and `--json` speak about the deployment
+ * that will go live. Until 2026-10-18 the CLI exited red for a deploy that
+ * was about to succeed (backlog §379).
  */
-const follow_remote_build = async (api, deployment_id, 
+const follow_remote_build = async (api, 
+// `let`: a platform retry switches the follow to its clone.
+initial_deployment_id, 
 // Where the build log goes. stdout for a person; stderr when stdout carries
 // a JSON document (--json, or a program driving the CLI): one build line in
 // front of it and the caller can't parse the outcome — the MCP reported a
@@ -20,6 +40,8 @@ const follow_remote_build = async (api, deployment_id,
 out = process.stdout) => {
     let printed = 0;
     let last_phase = "";
+    let followed_retry = false;
+    let deployment_id = initial_deployment_id;
     const started = Date.now();
     const tail_logs = async () => {
         try {
@@ -49,6 +71,15 @@ out = process.stdout) => {
         }
         await tail_logs();
         if (phase === "BUILD_ERROR" || phase === "ERROR") {
+            const retry = retry_of(deployment);
+            if (retry && !followed_retry) {
+                followed_retry = true;
+                log.info(`↩️ The default Python failed with your dependencies — the platform is retrying on Python ${retry.to} · ${retry.id}`);
+                deployment_id = retry.id;
+                printed = 0;
+                last_phase = "";
+                continue;
+            }
             const reason = deployment?.status?.reason;
             throw new Error(`Remote build failed${reason ? `: ${reason}` : ""}`.trim());
         }
@@ -56,7 +87,7 @@ out = process.stdout) => {
         // already live (READY) — the promotion poll takes over from here.
         if (phase === "INITIALIZING" || phase === "READY") {
             await tail_logs();
-            return;
+            return { id: deployment_id };
         }
         await wait(POLL_INTERVAL_MS);
     }

package/dist/commands/deploy/remote/index.js

@@ -34,7 +34,12 @@ const deploy_remote = async (props) => {
     });
     props.on_deployment?.(deployment.id);
     log.info(`Preparing to build in faable cloud · ${deployment.id}`);
-    await follow_remote_build(api, deployment.id, props.log_stream);
+    const landed = await follow_remote_build(api, deployment.id, props.log_stream);
+    // The platform retried the build on the previous Python (§12): what goes
+    // live is the clone, so the promotion poll must wait for IT.
+    if (landed.id !== deployment.id) {
+        return await api.getDeployment(landed.id);
+    }
     return deployment;
 };
 

package/dist/lib/dashboard_url.js

@@ -0,0 +1,11 @@
+// Dashboard links to an app, in the canonical `project_` form.
+//
+// The api returns `app.team` as `team_<hex>`. The dashboard accepts it, but a
+// session that lands on a `team_` URL keeps navigating with it and pays a 400
+// on `/project-favorites/recents` each time — so links leave as `project_`
+// (same rule as the api's emails, arch backlog §387).
+const DASHBOARD = 'https://dashboard.faable.com';
+const toProjectId = (team) => team.replace(/^team_/, 'project_');
+const dashboardAppUrl = (team, app_id) => `${DASHBOARD}/deploy/${toProjectId(team)}/app/${app_id}`;
+
+export { dashboardAppUrl, toProjectId };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faable/faable",
-  "version": "4.18.2",
+  "version": "4.18.4",
   "main": "dist/index.js",
   "license": "MIT",
   "author": "Marc Pomar <marc@faable.com>",