@fuzdev/fuz_app 0.83.0 → 0.85.0

package/dist/testing/db.js

@@ -178,42 +178,22 @@ export const auth_truncate_tables = [
  */
 export const auth_integration_truncate_tables = [...auth_truncate_tables, 'audit_log'];
 /**
- * All auth tables in drop order (children first for FK safety).
- *
- * The full set created by `auth_migrations` — use for clean-slate
- * test DB initialization. `auth_truncate_tables` is the subset for
- * between-test data cleanup (excludes `audit_log`).
- *
- * When adding tables to `auth_migrations`, add them here too.
- */
-export const auth_drop_tables = [
-    'app_settings',
-    'invite',
-    'audit_log',
-    'api_token',
-    'auth_session',
-    'role_grant',
-    'role_grant_offer',
-    'actor',
-    'account',
-    'bootstrap_lock',
-];
-/**
- * Drop all auth tables and schema version tracking for a clean slate.
+ * Reset the entire `public` schema for a clean slate before re-migration.
  *
  * Recommended at the start of `init_schema` callbacks for `create_pg_factory`.
- * Persistent test databases can accumulate stale schema from previous fuz_app
- * versions — this ensures migrations run against a truly empty database.
- * Safe on fresh databases (`IF EXISTS` on all statements). No-op effect for
- * PGlite (already fresh), but harmless to call unconditionally.
- *
- * @mutates db - drops every table in `auth_drop_tables` plus `schema_version`.
+ * Persistent test databases accumulate stale DDL across fuz_app versions;
+ * `DROP SCHEMA public CASCADE; CREATE SCHEMA public` wipes every table, type,
+ * and sequence regardless of namespace, so migrations always run against a
+ * truly empty database. Drift-proof — unlike a hand-maintained drop list it
+ * needs no upkeep when the schema gains a table. Despite the historical name,
+ * this resets the whole schema, not just auth tables (the only documented use
+ * is clean-slate re-migration, which always wanted a full reset).
+ *
+ * @mutates db - drops and recreates the `public` schema; all tables gone.
  */
 export const drop_auth_schema = async (db) => {
-    for (const table of auth_drop_tables) {
-        await db.query(`DROP TABLE IF EXISTS ${assert_valid_sql_identifier(table)} CASCADE`);
-    }
-    await db.query('DROP TABLE IF EXISTS schema_version CASCADE');
+    await db.query('DROP SCHEMA public CASCADE');
+    await db.query('CREATE SCHEMA public');
 };
 /**
  * Create a `describe_db` function bound to specific factories and truncate tables.

package/dist/testing/schema_ready_fixture.d.ts

@@ -0,0 +1,46 @@
+import './assert_dev_env.js';
+import type { Db } from '../db/db.js';
+import { type ExpectedSchema } from '../db/schema_ready.js';
+/** Options for `sync_expected_schema_fixture`. */
+export interface SyncExpectedSchemaFixtureOptions {
+    /** A bootstrapped DB — the consumer has run its full migration chain on it. */
+    db: Db;
+    /** Committed fixture location — an `import.meta.url`-relative URL or a path. */
+    fixture_url: URL | string;
+    /**
+     * When true, overwrite the fixture with the live column map instead of just
+     * reading it. Drive from an env flag (e.g. `UPDATE_SCHEMA_READY === '1'`).
+     */
+    update?: boolean;
+}
+/** The live column map and the committed fixture, for a `deepEqual` assertion. */
+export interface SyncExpectedSchemaFixtureResult {
+    /** Columns introspected from the live, freshly-bootstrapped DB. */
+    live: Record<string, Array<string>>;
+    /** The committed fixture (re-read after writing when `update`). */
+    committed: ExpectedSchema;
+}
+/**
+ * Introspect the live (bootstrapped) DB's columns, write them to the committed
+ * fixture when `update`, then read the committed fixture back. The caller
+ * asserts `deepEqual(live, committed)`:
+ *
+ * ```ts
+ * const {live, committed} = await sync_expected_schema_fixture({
+ *   db,
+ *   fixture_url: new URL('../../lib/server/expected_schema.json', import.meta.url),
+ *   update: process.env.UPDATE_SCHEMA_READY === '1',
+ * });
+ * assert.deepEqual(live, committed);
+ * ```
+ *
+ * When `update` writes the fixture it emits raw `JSON.stringify` (one array
+ * element per line); Prettier collapses short arrays inline, so run `gro format`
+ * after `UPDATE_SCHEMA_READY=1` before committing or the format check will flag
+ * the regenerated file. (The content is identical either way — the regen test
+ * compares values, not formatting.)
+ *
+ * @returns the live column map and the committed map (post-write when `update`)
+ */
+export declare const sync_expected_schema_fixture: (options: SyncExpectedSchemaFixtureOptions) => Promise<SyncExpectedSchemaFixtureResult>;
+//# sourceMappingURL=schema_ready_fixture.d.ts.map

package/dist/testing/schema_ready_fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_ready_fixture.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/testing/schema_ready_fixture.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAmB7B,OAAO,KAAK,EAAC,EAAE,EAAC,MAAM,aAAa,CAAC;AACpC,OAAO,EAAuB,KAAK,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAEhF,kDAAkD;AAClD,MAAM,WAAW,gCAAgC;IAChD,+EAA+E;IAC/E,EAAE,EAAE,EAAE,CAAC;IACP,gFAAgF;IAChF,WAAW,EAAE,GAAG,GAAG,MAAM,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,+BAA+B;IAC/C,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACpC,mEAAmE;IACnE,SAAS,EAAE,cAAc,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,4BAA4B,GACxC,SAAS,gCAAgC,KACvC,OAAO,CAAC,+BAA+B,CAQzC,CAAC"}

package/dist/testing/schema_ready_fixture.js

@@ -0,0 +1,48 @@
+import './assert_dev_env.js';
+/**
+ * Gen-time helper for the `/ready` schema-drift probe's committed fixture.
+ *
+ * A consumer commits an `expected_schema.json` (the column map a fresh full
+ * migration-chain bootstrap produces) and serves it through
+ * `create_ready_route_spec`. This helper keeps the regenerate-and-verify test
+ * that guards that fixture to ~10 lines: it introspects a freshly-bootstrapped
+ * DB, writes the fixture when an update flag is set, and reads it back so the
+ * caller can assert the committed copy equals a fresh bootstrap — the assertion
+ * that fails when the fixture drifts from the DDLs, so the runtime expectation
+ * can't silently fall behind.
+ *
+ * @module
+ */
+import { readFileSync, writeFileSync } from 'node:fs';
+import { query_public_columns } from '../db/schema_ready.js';
+/**
+ * Introspect the live (bootstrapped) DB's columns, write them to the committed
+ * fixture when `update`, then read the committed fixture back. The caller
+ * asserts `deepEqual(live, committed)`:
+ *
+ * ```ts
+ * const {live, committed} = await sync_expected_schema_fixture({
+ *   db,
+ *   fixture_url: new URL('../../lib/server/expected_schema.json', import.meta.url),
+ *   update: process.env.UPDATE_SCHEMA_READY === '1',
+ * });
+ * assert.deepEqual(live, committed);
+ * ```
+ *
+ * When `update` writes the fixture it emits raw `JSON.stringify` (one array
+ * element per line); Prettier collapses short arrays inline, so run `gro format`
+ * after `UPDATE_SCHEMA_READY=1` before committing or the format check will flag
+ * the regenerated file. (The content is identical either way — the regen test
+ * compares values, not formatting.)
+ *
+ * @returns the live column map and the committed map (post-write when `update`)
+ */
+export const sync_expected_schema_fixture = async (options) => {
+    const { db, fixture_url, update } = options;
+    const live = await query_public_columns(db);
+    if (update) {
+        writeFileSync(fixture_url, JSON.stringify(live, null, '\t') + '\n');
+    }
+    const committed = JSON.parse(readFileSync(fixture_url, 'utf8'));
+    return { live, committed };
+};

package/dist/ui/ConfirmButton.svelte

@@ -50,14 +50,13 @@
 	import type {SvelteHTMLElements} from 'svelte/elements';
 	import type {ComponentProps, Snippet} from 'svelte';
 	import type {OmitStrict} from '@fuzdev/fuz_util/types.js';
-	import Glyph from '@fuzdev/fuz_ui/Glyph.svelte';
+	import {icon_remove} from '@fuzdev/fuz_ui/icons.js';
 	import PendingAnimation from '@fuzdev/fuz_ui/PendingAnimation.svelte';
+	import Svg from '@fuzdev/fuz_ui/Svg.svelte';
 
 	import PopoverButton from './PopoverButton.svelte';
 	import type {Popover} from './popover.svelte.js';
 
-	const GLYPH_REMOVE = '🗙';
-
 	const {
 		onconfirm,
 		popover_button_attrs,
@@ -140,7 +139,7 @@
 				{#if popover_button_content}
 					{@render popover_button_content(popover, () => confirm(popover))}
 				{:else}
-					<Glyph glyph={GLYPH_REMOVE} />
+					<Svg data={icon_remove} />
 				{/if}
 			</button>
 		{/if}
@@ -155,7 +154,7 @@
 			{:else if label !== undefined}
 				{label}
 			{:else}
-				<Glyph glyph={GLYPH_REMOVE} />
+				<Svg data={icon_remove} />
 			{/if}
 		</span>
 		{#if pending}

package/dist/ui/ConfirmButton.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfirmButton.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ConfirmButton.svelte"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAC,cAAc,EAAE,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAI1D,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAEhD,KAAK,gBAAgB,GAAI,UAAU,CAAC,cAAc,CAAC,OAAO,aAAa,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC,GACxG,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GAAG;IACtD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/E,qCAAqC;IACrC,sBAAsB,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACtF,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AAgGJ,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"ConfirmButton.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/ui/ConfirmButton.svelte"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAC,cAAc,EAAE,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAK1D,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAEhD,KAAK,gBAAgB,GAAI,UAAU,CAAC,cAAc,CAAC,OAAO,aAAa,CAAC,EAAE,iBAAiB,GAAG,UAAU,CAAC,GACxG,UAAU,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,GAAG;IACtD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/E,qCAAqC;IACrC,sBAAsB,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACtF,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IACxE,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,CAAC;AA+FJ,QAAA,MAAM,aAAa,sDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.83.0",
+  "version": "0.85.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",
@@ -14,8 +14,8 @@
     "build": "gro build",
     "check": "gro check",
     "test": "gro test",
-    "test:cross": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_ts_node --project cross_backend_ts_deno --project cross_backend_ts_bun",
-    "test:cross:spine-stub": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_spine_stub",
+    "test:cross:ts": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_ts_node --project cross_backend_ts_deno --project cross_backend_ts_bun",
+    "test:cross:rust-spine-stub": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_rust_spine_stub",
     "test:cross:schema-parity": "FUZ_TEST_CROSS_BACKEND=1 vitest run --project cross_backend_schema_parity",
     "benchmark:cross-impl": "gro run src/benchmarks/cross_impl.bench.ts",
     "preview": "vite preview",
@@ -70,10 +70,11 @@
     "@electric-sql/pglite": "^0.4.5",
     "@fuzdev/blake3_wasm": "^0.1.1",
     "@fuzdev/fuz_code": "^0.46.0",
-    "@fuzdev/fuz_css": "^0.62.0",
-    "@fuzdev/fuz_ui": "^0.199.0",
+    "@fuzdev/fuz_css": "^0.63.0",
+    "@fuzdev/fuz_ui": "^0.205.0",
     "@fuzdev/fuz_util": "^0.65.1",
     "@fuzdev/gro": "^0.204.0",
+    "@fuzdev/mdz": "^0.1.0",
     "@hono/node-server": "^1.19.14",
     "@hono/node-ws": "^1.3.1",
     "@node-rs/argon2": "^2.0.2",
@@ -98,7 +99,7 @@
     "prettier-plugin-svelte": "^3.5.1",
     "svelte": "^5.56.2",
     "svelte-check": "^4.6.0",
-    "svelte-docinfo": "^0.4.1",
+    "svelte-docinfo": "^0.5.1",
     "svelte2tsx": "^0.7.52",
     "tslib": "^2.8.1",
     "typescript": "^5.9.3",
@@ -146,6 +147,10 @@
       "types": "./dist/*.svelte.d.ts",
       "svelte": "./dist/*.svelte",
       "default": "./dist/*.svelte"
+    },
+    "./*.json": {
+      "types": "./dist/*.json.d.ts",
+      "default": "./dist/*.json"
     }
   }
 }

package/dist/testing/cross_backend/spine_stub_backend_config.d.ts

@@ -1,66 +0,0 @@
-import '../assert_dev_env.js';
-/**
- * Cross-process `BackendConfig` preset for the non-domain spine consumer,
- * `testing_spine_stub` — a Rust binary that mounts only the spine surface
- * (auth / account / admin / audit / role-grant offers) with no domain
- * layer. fuz_app drives it from `src/test/cross_backend/*.cross.test.ts`
- * to verify its TS spec against the Rust spine end-to-end with no domain
- * implementation in the loop — drift becomes a fuz_app failure rather than
- * a downstream consumer's failure with mixed signals.
- *
- * **Binary discovery — env-supplied, never hardcoded.** The binary lives
- * in a sibling Rust workspace, not in fuz_app, so the preset never bakes a
- * path in. `FUZ_TESTING_SPINE_STUB_BIN` (or the `binary_path` option) must
- * point at a prebuilt binary; the preset throws a clear error when neither
- * is set rather than guessing. Build once with
- * `cargo build -p testing_spine_stub --release` and point the env var at
- * the resulting `target/release/testing_spine_stub`; operators / CI cache
- * the binary across runs for fast spawns.
- *
- * **Operator setup** — the target Postgres database must exist before the
- * harness runs (the harness never issues `CREATE DATABASE`, to avoid
- * forcing a `CREATEDB` grant on the test role):
- *
- * ```bash
- * createdb fuz_app_test_spine_stub 2>/dev/null || true
- * ```
- *
- * The binary self-wipes the auth-namespace schema on every boot
- * (`FUZ_TESTING_RESET_DB_ON_STARTUP=true`, set by the Rust-family builder),
- * so no manual `DROP TABLE` between sessions is needed; per-test reset is
- * the orthogonal `_testing_reset` RPC action `default_cross_process_setup`
- * fires.
- *
- * @module
- */
-import type { BackendConfig } from './backend_config.js';
-/** Env var naming the prebuilt `testing_spine_stub` binary. Required when `binary_path` is omitted. */
-export declare const SPINE_STUB_BIN_ENV = "FUZ_TESTING_SPINE_STUB_BIN";
-/** Default listening port — slots beside zzz's 1175/1176; matches the binary's `DEFAULT_PORT`. */
-export declare const SPINE_STUB_DEFAULT_PORT = 1177;
-/** Default Postgres database — real PG (PGlite isn't reachable from `tokio-postgres`). */
-export declare const SPINE_STUB_DEFAULT_DATABASE_URL = "postgres://localhost/fuz_app_test_spine_stub";
-export interface SpineStubBackendConfigOptions {
-    /** Listening port. Default `SPINE_STUB_DEFAULT_PORT`. */
-    readonly port?: number;
-    /** Postgres connection URL. Default `SPINE_STUB_DEFAULT_DATABASE_URL`. */
-    readonly database_url?: string;
-    /**
-     * Prebuilt binary path. Overrides the `FUZ_TESTING_SPINE_STUB_BIN` env
-     * var. When neither is set the preset throws.
-     */
-    readonly binary_path?: string;
-}
-/**
- * Build the `BackendConfig` for `testing_spine_stub`. Resolves the binary
- * from `options.binary_path` or `FUZ_TESTING_SPINE_STUB_BIN`; throws when
- * neither is set so a missing build surfaces as a clear error rather than
- * a confusing spawn failure. Reconciles the binary's env contract: port
- * via `--port` (and `FUZ_SPINE_STUB_PORT`), daemon-token dir via
- * `FUZ_SPINE_STUB_DIR` (anchored to `paths.root` so the written
- * `{dir}/run/daemon_token` matches the path `spawn_backend` reads).
- *
- * @throws Error when no binary path is available.
- */
-export declare const spine_stub_backend_config: (options?: SpineStubBackendConfigOptions) => BackendConfig;
-//# sourceMappingURL=spine_stub_backend_config.d.ts.map

package/dist/testing/cross_backend/spine_stub_backend_config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spine_stub_backend_config.d.ts","sourceRoot":"../src/lib/","sources":["../../../src/lib/testing/cross_backend/spine_stub_backend_config.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAOvD,uGAAuG;AACvG,eAAO,MAAM,kBAAkB,+BAA+B,CAAC;AAE/D,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,0FAA0F;AAC1F,eAAO,MAAM,+BAA+B,iDAAiD,CAAC;AAE9F,MAAM,WAAW,6BAA6B;IAC7C,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,GACrC,UAAS,6BAAkC,KACzC,aAsCF,CAAC"}

package/dist/testing/cross_backend/spine_stub_backend_config.js

@@ -1,53 +0,0 @@
-import '../assert_dev_env.js';
-import { build_test_backend_paths } from './build_test_backend_paths.js';
-import { make_default_rust_backend_config, rust_default_capabilities, } from './default_backend_configs.js';
-/** Env var naming the prebuilt `testing_spine_stub` binary. Required when `binary_path` is omitted. */
-export const SPINE_STUB_BIN_ENV = 'FUZ_TESTING_SPINE_STUB_BIN';
-/** Default listening port — slots beside zzz's 1175/1176; matches the binary's `DEFAULT_PORT`. */
-export const SPINE_STUB_DEFAULT_PORT = 1177;
-/** Default Postgres database — real PG (PGlite isn't reachable from `tokio-postgres`). */
-export const SPINE_STUB_DEFAULT_DATABASE_URL = 'postgres://localhost/fuz_app_test_spine_stub';
-/**
- * Build the `BackendConfig` for `testing_spine_stub`. Resolves the binary
- * from `options.binary_path` or `FUZ_TESTING_SPINE_STUB_BIN`; throws when
- * neither is set so a missing build surfaces as a clear error rather than
- * a confusing spawn failure. Reconciles the binary's env contract: port
- * via `--port` (and `FUZ_SPINE_STUB_PORT`), daemon-token dir via
- * `FUZ_SPINE_STUB_DIR` (anchored to `paths.root` so the written
- * `{dir}/run/daemon_token` matches the path `spawn_backend` reads).
- *
- * @throws Error when no binary path is available.
- */
-export const spine_stub_backend_config = (options = {}) => {
-    const { port = SPINE_STUB_DEFAULT_PORT, database_url = SPINE_STUB_DEFAULT_DATABASE_URL, binary_path = process.env[SPINE_STUB_BIN_ENV], } = options;
-    if (!binary_path) {
-        throw new Error(`spine_stub_backend_config: no binary path — set ${SPINE_STUB_BIN_ENV} to a prebuilt ` +
-            '`testing_spine_stub` binary (build it with `cargo build -p testing_spine_stub --release`) ' +
-            'or pass `binary_path`.');
-    }
-    const name = 'spine_stub';
-    const paths = build_test_backend_paths(name);
-    return make_default_rust_backend_config({
-        name,
-        port,
-        // `--port` is the binary's authoritative port input; the
-        // `FUZ_SPINE_STUB_PORT` env the builder also sets (via `port_env_var`)
-        // is the lower-precedence fallback — both carry the same value.
-        start_command: [binary_path, '--port', String(port)],
-        database_url,
-        // The stub now serves `GET /api/admin/audit/stream` (the spine
-        // `fuz_realtime::SseRegistry` + audit listener), so it advertises `sse`
-        // like the TS spines — the cross-process SSE suite's three cases run.
-        capabilities: { ...rust_default_capabilities, sse: true },
-        port_env_var: 'FUZ_SPINE_STUB_PORT',
-        rust_log: 'info,testing_spine_stub=info',
-        paths,
-        extra_env: {
-            // The binary writes its daemon-token JSON to
-            // `{FUZ_SPINE_STUB_DIR}/run/daemon_token`; anchoring the dir to
-            // `paths.root` makes that equal `paths.daemon_token_path`, which
-            // `spawn_backend` reads after the health probe.
-            FUZ_SPINE_STUB_DIR: paths.root,
-        },
-    });
-};