cursedops 0.9.1 → 0.9.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedops",
-	"version": "0.9.1",
+	"version": "0.9.2",
 	"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 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/workerDeploy.ts

@@ -243,8 +243,11 @@ export interface DeployDeps {
 }
 
 export interface DeployResult {
-	/** 0 shipped and smoked; 1 refused or failed — the step says where. */
-	code: 0 | 1;
+	/**
+	 * 0 shipped and smoked; 1 refused or failed — the step says where; {@link TAIL_UNATTACHED_EXIT}
+	 * shipped and smoked green with its Worker CPU UNMEASURED (step `cpu-unmeasured`).
+	 */
+	code: 0 | 1 | typeof TAIL_UNATTACHED_EXIT;
 	/** The step it stopped at, or `"done"`. */
 	step: string;
 	/** Why it stopped, or the success line. */
@@ -280,6 +283,8 @@ export function runWorkerDeploy(spec: WorkerDeploySpec, deps: DeployDeps): Deplo
 		return { code: 1, step, detail, commit, dirty };
 	};
 	const step = (message: string): void => log(`\n▸ ${message}`);
+	/** What passed under a CPU tail that never attached — decision 6 of the CPU check. */
+	const unmeasured: string[] = [];
 
 	if (!commit) return stop("head", "this checkout has no readable HEAD — there is no commit to stamp, so nothing could prove the deploy.");
 	if (spec.env === "production" && dirty) {
@@ -297,7 +302,9 @@ export function runWorkerDeploy(spec: WorkerDeploySpec, deps: DeployDeps): Deplo
 		for (const walk of spec.stageWalk ?? []) {
 			const command = spec.cpuTail ? underCpuTail(spec.cpuTail, "stage", walk) : [...walk];
 			step(`walk the stage signed in${spec.cpuTail ? ", under a CPU tail" : ""}: ${command.join(" ")}`);
-			if (deps.run(command, {}) !== 0) return stop("stage", `\`${command.join(" ")}\` failed — production was NOT touched.`);
+			const walked = deps.run(command, {});
+			if (spec.cpuTail && walked === TAIL_UNATTACHED_EXIT) unmeasured.push("the stage walk");
+			else if (walked !== 0) return stop("stage", `\`${command.join(" ")}\` failed — production was NOT touched.`);
 		}
 	}
 	if (spec.build) {
@@ -329,7 +336,9 @@ export function runWorkerDeploy(spec: WorkerDeploySpec, deps: DeployDeps): Deplo
 	if (spec.smoke) {
 		step(`smoke every address this deployment answers on${spec.cpuTail ? ", under a CPU tail" : ""}`);
 		const smoke = spec.cpuTail ? underCpuTail(spec.cpuTail, spec.env, spec.smoke) : spec.smoke;
-		if (deps.run(smoke, {}) !== 0) {
+		const smoked = deps.run(smoke, {});
+		if (spec.cpuTail && smoked === TAIL_UNATTACHED_EXIT) unmeasured.push("the smoke");
+		else if (smoked !== 0) {
 			return stop(
 				"smoke",
 				"the Worker is deployed and its smoke FAILED. Nothing was rolled back: `bunx wrangler rollback` puts the previous version back in one command.",
@@ -337,6 +346,13 @@ export function runWorkerDeploy(spec: WorkerDeploySpec, deps: DeployDeps): Deplo
 		}
 	}
 	const detail = `${spec.workerName} deployed${spec.secrets ? ", attached" : ""}${spec.smoke ? " and smoked" : ""} @ ${commit.slice(0, 8)}.`;
+	if (unmeasured.length > 0) {
+		const why =
+			`${detail} Worker CPU UNMEASURED — the tail never attached around ${unmeasured.join(" and ")}, which PASSED. ` +
+			"Nothing is wrong with the deployment and nothing needs rolling back; rerun the smoke under the app's CPU wrapper to measure it.";
+		error(`\n🟡 ${tag} ${why}`);
+		return { code: TAIL_UNATTACHED_EXIT, step: "cpu-unmeasured", detail: why, commit, dirty };
+	}
 	log(`\n✅ ${detail}`);
 	return { code: 0, step: "done", detail, commit, dirty };
 }
@@ -400,6 +416,12 @@ export function runWorkerDeploy(spec: WorkerDeploySpec, deps: DeployDeps): Deplo
  *      excused by production's traffic on a shared tail, or the reverse.
  *   5. **A tail that never connects is a failure, never an empty pass**; neither is a runtime that
  *      stops reporting `cpuTime` (`recordTailTraces` skips it; the empty report is `no-samples`).
+ *   6. 🔴 **…but it is not the COMMAND failing (0.9.2, task 2157).** A tail that does not attach is
+ *      restarted ONCE with a fresh marker; if the second never attaches either, the command still
+ *      runs (unmeasured, so the deploy is still smoked) and the result is {@link TAIL_UNATTACHED_EXIT},
+ *      which {@link runWorkerDeploy} reports as "CPU unmeasured", never "smoke FAILED". Measured
+ *      2026-09-24: collections' production tail never delivered its marker within 60 s, the deploy
+ *      said the smoke failed, and the same smoke rerun two minutes later passed 30 checks.
  *
  * ## How it knows the tail is listening, and that it has heard everything
  *
@@ -682,11 +704,21 @@ export interface WorkerCpuTailSpec extends Omit<JudgeOpts, "scriptName"> {
 	markerWaitMs?: number;
 }
 
+/**
+ * The exit code of a CPU tail that never attached, twice, around a command that PASSED (`EX_UNAVAILABLE`):
+ * nothing was measured, and nothing was wrong with the deployment. Distinct from the command's own
+ * codes so {@link runWorkerDeploy} can say which of the two happened — decision 6.
+ */
+export const TAIL_UNATTACHED_EXIT = 69;
+
 export interface WorkerCpuTailResult {
-	/** 0 green; the command's own code when it failed; 1 for any CPU or tail failure. */
+	/**
+	 * 0 green; the command's own code when it failed; {@link TAIL_UNATTACHED_EXIT} when the command
+	 * passed and the tail never attached; 1 for any other CPU or tail failure.
+	 */
 	code: number;
-	/** Where it stopped: `connect`, `command`, `drain`, `budget` or `done`. */
-	step: "connect" | "command" | "drain" | "budget" | "done";
+	/** Where it stopped: `unmeasured`, `command`, `drain`, `budget` or `done`. */
+	step: "unmeasured" | "command" | "drain" | "budget" | "done";
 	verdict: TailVerdict | null;
 }
 
@@ -700,7 +732,7 @@ export async function runWorkerCpuTail(spec: WorkerCpuTailSpec, deps: WorkerCpuD
 	const base = spec.base.replace(/\/$/, "");
 
 	deps.log(`\n▸ ${tag} Worker CPU: tailing ${spec.workerName} around \`${spec.command.join(" ")}\``);
-	const tail = deps.startTail(spec.workerName, spec.cwd, spec.credential);
+	let tail = deps.startTail(spec.workerName, spec.cwd, spec.credential);
 
 	/** Send the marker until the tail has carried it back, or give up. */
 	const awaitMarker = async (marker: string, withinMs: number): Promise<boolean> => {
@@ -718,16 +750,27 @@ export async function runWorkerCpuTail(spec: WorkerCpuTailSpec, deps: WorkerCpuD
 		return false;
 	};
 
-	if (!(await awaitMarker(nonce, connectMs))) {
+	// Decision 6: a tail that never attaches is restarted ONCE, with a fresh marker, before anything is judged.
+	let attached = await awaitMarker(nonce, connectMs);
+	let marker = nonce;
+	if (!attached) {
+		tail.stop();
+		deps.error(`🟡 ${tag} wrangler tail never delivered a request from ${base} within ${Math.round(connectMs / 1000)}s — restarting it once.\n${tail.errors()}`);
+		marker = `${nonce}r`;
+		tail = deps.startTail(spec.workerName, spec.cwd, spec.credential);
+		attached = await awaitMarker(marker, connectMs);
+	}
+	if (!attached) {
 		tail.stop();
 		deps.error(
-			`🔴 ${tag} wrangler tail never delivered a request from ${base} within ${Math.round(connectMs / 1000)}s — nothing could be measured.\n${tail.errors()}`,
+			`🔴 ${tag} wrangler tail never attached, twice, within ${Math.round(connectMs / 1000)}s each — the command runs UNMEASURED.\n${tail.errors()}`,
 		);
-		return { code: 1, step: "connect", verdict: null };
+		const ran = deps.run(spec.command, spec.cwd);
+		return { code: ran !== 0 ? ran : TAIL_UNATTACHED_EXIT, step: ran !== 0 ? "command" : "unmeasured", verdict: null };
 	}
 
 	const ran = deps.run(spec.command, spec.cwd);
-	const drained = await awaitMarker(`${nonce}-end`, drainMs);
+	const drained = await awaitMarker(`${marker}-end`, drainMs);
 	// Traces are not strictly ordered; a moment more lets a straggler behind the end marker land.
 	await deps.sleep(2_000);
 	tail.stop();