cursedops 0.10.2 → 0.10.4

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedops",
-	"version": "0.10.2",
+	"version": "0.10.4",
 	"description": "The build-and-ops answers this generation's apps wrote independently and identically: finding a generation's roots — and printing a command that runs when pasted — without knowing a path, the generation's whole-tree laws run over one repo from a checkout or a worktree, macOS launchd agent install/replace/remove and the live port a job serves, the scaffolding and verdicts of a deployed smoke (origin probe, the smoke's own environment, a network that lies about DNS, a settled version), the static-serving helpers eight apps copied — the path-traversal guard among them — the API floor that keeps an unmatched /api/... from ever being answered with the app shell, the commit and dirty flag a checkout-served process reports, the Cloudflare Worker deploy toolkit four apps copied (the deploy sequence, exact-set secrets over a pipe, origin-first rollback, the curl edge fetch, the row-for-row D1 import proof, the billed-CPU tail check around a deploy's walk and smoke, and each app's worker:secrets and worker:smoke main as one function of its data), the relay a Worker fronts a Mac-bound app with (the Durable Object, the frames, the Mac's dialer and key rotation — lifted from station for roms), the Worker import-graph and await-port checks every Worker app's suite runs over its own source, and the public-surface ratchet three published libraries each carried a forked copy of. Mechanism only — no app knows its name from here. Bun, zero runtime dependencies (typescript is an optional peer, for public-surface only), ships source.",
 	"type": "module",
 	"scripts": {

package/src/edgeFetch.ts

@@ -54,6 +54,34 @@ export interface EdgeFetchOptions {
 	tmpDir?: string;
 	/** curl's `--max-time`. Default 60. */
 	maxTimeSec?: number;
+	/** Wait before retry `n` (1-based) of a connection-level failure. Default `500 * n` ms. */
+	retryDelayMs?: (retry: number) => number;
+}
+
+/**
+ * 🔴 How many MORE times a request is sent after a connection-level curl failure that carried
+ * no answer. Measured 2026-09-24: vault's prod deploy of `953e19a` reported "smoke FAILED" on one
+ * `curl exit 35` (TLS handshake) while the Worker was serving the new build, and `worker:smoke`
+ * straight after was green on both addresses — a green deploy reported red, pointing its reader
+ * at `wrangler rollback`.
+ */
+const EDGE_RETRIES = 2;
+
+/**
+ * Whether a curl failure may be sent again. Only when NOTHING answered (empty stdout), and then:
+ *
+ *  · 6 resolve, 7 connect, 35 TLS handshake — the request never left this machine, so a replay
+ *    is always safe, whatever the method;
+ *  · 52 empty reply, 56 receive failure — the request MAY have reached the Worker and done its
+ *    work, so these are replayed only for a method that is safe to run twice (never a POST).
+ *
+ * Every other exit — 28 (timeout) above all, where the far end may still be working — and every
+ * HTTP status, whatever it is, is returned exactly as before.
+ */
+function retryableCurlFailure(exit: number | null, stdout: Buffer, method = "GET"): boolean {
+	if (stdout.length > 0 || exit === null) return false;
+	if (exit === 6 || exit === 7 || exit === 35) return true;
+	return (exit === 52 || exit === 56) && ["GET", "HEAD", "OPTIONS", "PUT", "DELETE"].includes(method.toUpperCase());
 }
 
 function digCloudflare(host: string): string | null {
@@ -124,7 +152,11 @@ export function createEdgeFetch(options: EdgeFetchOptions = {}): (url: string, i
 			args.push("--data-binary", `@${bodyFile}`);
 		}
 		try {
-			const out = curl([...args, target.toString()]);
+			let out = curl([...args, target.toString()]);
+			for (let retry = 1; retry <= EDGE_RETRIES && retryableCurlFailure(out.status, out.stdout, init.method); retry++) {
+				await new Promise((r) => setTimeout(r, options.retryDelayMs?.(retry) ?? 500 * retry));
+				out = curl([...args, target.toString()]);
+			}
 			return parseCurlResponse(out.stdout, target.origin, out.status);
 		} finally {
 			if (bodyFile) rmSync(bodyFile, { force: true });

package/src/relayLink.ts

@@ -74,6 +74,24 @@ export function linkAccessHeaders(env: Record<string, string | undefined>): Reco
 	return id && secret ? { "CF-Access-Client-Id": id, "CF-Access-Client-Secret": secret } : {};
 }
 
+/**
+ * Why a link would dial into Access's login page instead of the Worker, or null.
+ *
+ * 🔴 Measured at station's cutover (task 2156, 2026-09-24): `station.cursedalchemy.com` is behind the
+ * owner's Access application, so a link pointed at it was refused its handshake (1002, "Expected 101")
+ * on every try — a reconnect loop with no other error while the browser half answered 503. The
+ * preview (`*.workers.dev`) is the same Worker and the same Durable Object with no Access in front —
+ * `/link`'s own guard is the bearer key. Any other host needs the Access token in the handshake
+ * headers ({@link linkAccessHeaders}). {@link dialLink} asks this before its first connect.
+ */
+export function linkUrlRefusal(url: string, headers: Record<string, string> = {}): string | null {
+	const host = new URL(url.replace(/^ws/, "http")).hostname;
+	if (host.endsWith(".workers.dev") || host === "127.0.0.1" || host === "localhost") return null;
+	const has = (name: string) => Object.keys(headers).some((k) => k.toLowerCase() === name && headers[k]?.trim());
+	if (has("cf-access-client-id") && has("cf-access-client-secret")) return null;
+	return `${host} is behind Cloudflare Access and this link carries no Access token — dial the preview (wss://<name>.<subdomain>.workers.dev/link), the same Worker without Access, or set CF_ACCESS_CLIENT_ID/CF_ACCESS_CLIENT_SECRET`;
+}
+
 /** Answer one frame with `fetch`, never throwing: a crash in a route is a 500 on the wire. */
 export async function answerFrame(
 	fetch: (request: Request) => Response | Promise<Response>,
@@ -127,8 +145,15 @@ const bunSocket = (url: string, headers: Record<string, string>): DialSocket =>
 	// Bun's WebSocket takes `{ headers }` as its second argument; the DOM typing says protocols.
 	new WebSocket(url, { headers } as unknown as string[]) as unknown as DialSocket;
 
-/** Dial, answer, and redial on close with a 1 s → 60 s backoff. See the header. */
+/**
+ * Dial, answer, and redial on close with a 1 s → 60 s backoff. See the header.
+ *
+ * THROWS before the first connect when {@link linkUrlRefusal} refuses the URL: a link that can never
+ * be let through Access must fail loudly at start, not retry 1002 forever.
+ */
 export function dialLink(options: DialOptions): DialedLink {
+	const refused = linkUrlRefusal(options.settings.url, options.headers);
+	if (refused) throw new Error(`[${options.app}-link] ✗ ${refused}`);
 	const origin = options.origin ?? publicOriginOf(options.settings.url);
 	const log = options.log ?? ((line: string) => console.log(line));
 	const open = options.openSocket ?? bunSocket;