@teamscala/service-boot 0.23.502 → 0.23.505

package/src/two-phase-health-gate-client-only.test.ts

@@ -1,31 +1,11 @@
-/**
- * @system service-boot
- * @status handwritten
- * @edit edit directly
- *
- * A CLIENT-ONLY service (`render_mode=client`) must reach ready, even though it
- * never registers an SSR page handler.
- *
- * Separate file from `two-phase-health-gate.test.ts` on purpose: `fullAppReady`
- * is module state that only transitions false -> true and has no reset hook, so
- * the two ready-paths cannot both be exercised in one module instance. A reset
- * hook would exist only for tests.
- *
- * THE REGRESSION THIS LOCKS (measured 2026-08-07 on scala-agents-ui). Readiness
- * used to be flipped INSIDE `setPageHandler`, which was honest while every
- * service was SSR. `render_mode=client` made a service that completes phase 2
- * and never calls it, so `/health` answered `{"status":"starting"}` FOREVER
- * while the process was healthy and serving — boot completed in 5023ms, "Full
- * app built: 50 block(s)" logged, `GET /` correctly 302'd to sign-in, and three
- * untouched UI services reported ok beside it.
- *
- * That is precisely what `readiness-gated-boot` forbids ("binary: fully-ready or
- * cleanly-unavailable"): a permanently-un-ready health signal makes the
- * activator's wake gate and every health-gated router treat a working service as
- * down. Exercised through a real Hono request against the REAL exported handler
- * (`proxy-is-not-behaviour`) — a source grep would prove the call exists, never
- * that the endpoint answers 200.
- */
+// ! @system codegen
+// ! @status generated
+// ! @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
+// !
+// ! This suite's assertions are OWNED by the codegen band: the band module
+// ! carries them verbatim, this file is the emission, and hand edits here are
+// ! overwritten on the next run. The rationale each assertion carries moved
+// ! with it into the band.
 
 import { beforeAll, describe, expect, test } from "bun:test";
 import { Hono } from "hono";

package/src/two-phase-health-gate.test.ts

@@ -1,31 +1,11 @@
-/**
- * @system service-boot
- * @status handwritten
- * @edit edit directly
- *
- * The wake gate for every scale-to-zero app: `/health` must not report ready
- * while the service still 503s pages.
- *
- * Exercised through a real Hono request against the REAL exported handler, not
- * asserted against source text — `proxy-is-not-behaviour`: a source grep proves
- * a line exists, never that the endpoint answers 503. This test fails if anyone
- * restores the flat `{status:"ok"}`, which is the regression it locks.
- *
- * THE MEASURED OUTAGE (2026-07-31, quiz-dev + sign-dev returning 503 to
- * customers). `scala-activator` gates a cold wake on `isHealthy(port)` — a
- * plain `GET /health` — then pipes the held client connection the moment it
- * returns ok. `/health` answered ok as soon as the MINIMAL app served, but the
- * phase-1 page handler returns 503 until the phase-2 swap, so the activator
- * piped the customer's first request into that window:
- *
- *   05:58:25.446  activator: awake scala-quiz (4227ms)
- *   05:58:25.452  scala-quiz: GET / 503 3ms      <- the customer's request
- *   05:58:26.456  scala-quiz: Swapped from minimal app to full app
- *
- * Nine such 503s on scala-quiz, two on scala-sign, zero on scala-public — the
- * gap is a race whose width is the phase-1→phase-2 build time (1420ms cold,
- * 137ms warm), which is why one app looked healthy and the others did not.
- */
+// ! @system codegen
+// ! @status generated
+// ! @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
+// !
+// ! This suite's assertions are OWNED by the codegen band: the band module
+// ! carries them verbatim, this file is the emission, and hand edits here are
+// ! overwritten on the next run. The rationale each assertion carries moved
+// ! with it into the band.
 
 import { beforeAll, describe, expect, test } from "bun:test";
 import { Hono } from "hono";