standout 0.5.20 → 0.5.21

package/dist/wrapped/preview.js

@@ -1,5 +1,5 @@
 // Dev preview of the proficiency finale card for every score tier.
-//   npm run preview:tiers            (from packages/agent)
+//   npm run preview:tiers            (from packages/standout)
 // One representative profile per tier so you can eyeball figures, copy, and fit.
 import { cardProficiency } from "./render.js";
 import { TIERS } from "./tiers.js";

package/dist/wrapped-client.js

@@ -1,3 +1,6 @@
+// PUBLISHING: this is shipped npm package code. Any runtime change here must bump
+// "version" in package.json in the same PR — that bump is the ONLY trigger for the
+// npm publish on merge. Land a change without it and the fix never reaches users.
 import { STANDOUT_API_URL } from "./api.js";
 import { aggregateView } from "./wrapped/aggregate.js";
 const HEADERS = {
@@ -6,31 +9,68 @@ const HEADERS = {
     // node-fetch UAs on certain paths. Set a clear identity.
     "User-Agent": "Standout/0.4.0 (node)",
 };
+// The request holds a connection open while the backend runs the wrapped's
+// LLM cards, so a transient blip shouldn't permanently drop the wrapped.
+const MAX_ATTEMPTS = 3;
+// Comfortably above the backend's worst-case critical path, below its 300s cap.
+const REQUEST_TIMEOUT_MS = 120000;
+const RETRY_BASE_DELAY_MS = 1000;
+// Wrapped creation is NOT idempotent — each POST makes a new row + LLM run. Only
+// retry failures that prove the request never reached the backend; a timeout or a
+// mid-flight drop may mean the server already created it, so replaying would
+// duplicate the wrapped.
+const RETRYABLE_CONNECT_CODES = new Set([
+    "ECONNREFUSED",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "UND_ERR_CONNECT_TIMEOUT",
+]);
+function isPreConnectError(err) {
+    for (const node of [err, err?.cause]) {
+        const code = node?.code;
+        if (typeof code === "string" && RETRYABLE_CONNECT_CODES.has(code)) {
+            return true;
+        }
+    }
+    return false;
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 export async function createWrapped(args) {
-    try {
-        const res = await fetch(`${STANDOUT_API_URL}/api/public/wrapped`, {
-            method: "POST",
-            headers: HEADERS,
-            body: JSON.stringify({
+    const body = JSON.stringify({
+        profile: args.profile,
+        submission_id: args.submissionId ?? undefined,
+    });
+    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+        try {
+            const res = await fetch(`${STANDOUT_API_URL}/api/public/wrapped`, {
+                method: "POST",
+                headers: HEADERS,
+                body,
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            // Any HTTP response means the request reached the server; don't replay it
+            // (a 5xx could land after the row was already created).
+            if (!res.ok) {
+                const text = await res.text().catch(() => "");
+                process.stderr.write(`[wrapped] backend returned ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}\n`);
+                return null;
+            }
+            const data = (await res.json());
+            const view = aggregateView({
                 profile: args.profile,
-                submission_id: args.submissionId ?? undefined,
-            }),
-        });
-        if (!res.ok) {
-            const text = await res.text().catch(() => "");
-            process.stderr.write(`[wrapped] backend returned ${res.status}${text ? `: ${text.slice(0, 200)}` : ""}\n`);
+                computed: data.computed,
+                share_url: data.share_url,
+            });
+            return { id: data.id, share_url: data.share_url, view };
+        }
+        catch (err) {
+            if (isPreConnectError(err) && attempt < MAX_ATTEMPTS) {
+                await sleep(RETRY_BASE_DELAY_MS * attempt);
+                continue;
+            }
+            process.stderr.write(`[wrapped] failed to reach backend: ${err instanceof Error ? err.message : err}\n`);
             return null;
         }
-        const data = (await res.json());
-        const view = aggregateView({
-            profile: args.profile,
-            computed: data.computed,
-            share_url: data.share_url,
-        });
-        return { id: data.id, share_url: data.share_url, view };
-    }
-    catch (err) {
-        process.stderr.write(`[wrapped] failed to reach backend: ${err instanceof Error ? err.message : err}\n`);
-        return null;
     }
+    return null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "standout",
-  "version": "0.5.20",
+  "version": "0.5.21",
   "description": "Build your developer profile with AI. One command, zero friction.",
   "type": "module",
   "main": "./dist/cli.js",