@elaraai/e3-rack 0.0.0-bootstrap.0 → 1.0.94

package/dist/src/testing/lease-store-contract.js

@@ -0,0 +1,78 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { uuidv7 } from '@elaraai/e3-core';
+import { makeLeaseId } from '../lease/lease-store.js';
+/**
+ * Tests the conditional lease transitions every backend implements.
+ * @param label - The backend's name
+ * @param makeStore - Creates an empty store for each case
+ * @example
+ * leaseStoreContract('memory', () => new InMemoryRackLeaseStore());
+ */
+export function leaseStoreContract(label, makeStore) {
+    const pending = (tier = 'node') => ({
+        leaseId: makeLeaseId('a'.repeat(64), 'b'.repeat(64)), repo: 'repo', workspace: 'dev',
+        taskHash: 'a'.repeat(64), inputsHash: 'b'.repeat(64), tier, status: 'pending', createdAtMs: Date.now(),
+        event: { version: 2, workspace: 'dev', taskName: 'test', closure: { hashes: [] },
+            runnerEvent: { mode: 'task', repo: 'repo', launchId: uuidv7(), taskHash: 'a'.repeat(64), inputHashes: [], timeoutMs: 60_000 } },
+    });
+    void describe(`lease store (${label})`, () => {
+        void it('grants exactly one concurrent claim and accepts only its extensions and completion', async () => {
+            const store = await makeStore();
+            const lease = pending();
+            await store.put(lease);
+            const claims = await Promise.all(Array.from({ length: 12 }, (_, n) => store.claim('repo', lease.leaseId, `rack${n}`, Date.now() + 60_000)));
+            assert.equal(claims.filter(Boolean).length, 1);
+            const winner = claims.find((c) => c !== null);
+            assert.equal(await store.extend('repo', lease.leaseId, 'intruder', Date.now() + 60_000), false);
+            assert.equal(await store.complete('repo', lease.leaseId, 'intruder', { taskName: 'test', status: 'success' }), 'discarded');
+            assert.equal(await store.extend('repo', lease.leaseId, winner.claimedBy, Date.now() + 60_000), true);
+            assert.equal(await store.complete('repo', lease.leaseId, winner.claimedBy, { taskName: 'test', status: 'success' }), 'recorded');
+            assert.equal(await store.complete('repo', lease.leaseId, winner.claimedBy, { taskName: 'test', status: 'success' }), 'idempotent');
+            assert.equal((await store.supersede('repo', lease.leaseId))?.status, 'completed');
+            assert.equal((await store.cancel('repo', lease.leaseId))?.status, 'completed');
+        });
+        void it('reclaims expired visibility under a fresh attempt and discards the previous claimant', async () => {
+            const store = await makeStore();
+            const lease = pending();
+            await store.put(lease);
+            const first = { executionId: uuidv7(), startedAtMs: Date.now() };
+            await store.claim('repo', lease.leaseId, 'first', Date.now() - 1, first);
+            const second = { executionId: uuidv7(), startedAtMs: Date.now() };
+            assert.deepEqual((await store.claim('repo', lease.leaseId, 'second', Date.now() + 60_000, second))?.attempt, second);
+            assert.equal(await store.complete('repo', lease.leaseId, 'first', { taskName: 'test', status: 'success' }), 'discarded');
+            assert.equal(await store.recordTargets('repo', lease.leaseId, 'first', ['c'.repeat(64)]), false);
+            assert.equal(await store.recordTargets('repo', lease.leaseId, 'second', ['c'.repeat(64), 'c'.repeat(64)]), true);
+            assert.deepEqual((await store.get('repo', lease.leaseId))?.targets, ['c'.repeat(64)]);
+        });
+        for (const stop of ['cancel', 'supersede']) {
+            void it(`discards late completions after ${stop}`, async () => {
+                const store = await makeStore();
+                const lease = pending();
+                await store.put(lease);
+                await store.claim('repo', lease.leaseId, 'rack', Date.now() + 60_000);
+                await store[stop]('repo', lease.leaseId);
+                assert.equal(await store.complete('repo', lease.leaseId, 'rack', { taskName: 'test', status: 'success' }), 'discarded');
+                assert.equal(await store.findByTask('repo', lease.taskHash, lease.inputsHash), null);
+            });
+        }
+        void it('orders claimable leases oldest first and reattaches to the newest usable lease', async () => {
+            const store = await makeStore();
+            const old = { ...pending(), createdAtMs: 10 };
+            const newer = { ...pending(), createdAtMs: 20 };
+            const py = { ...pending('py'), createdAtMs: 1 };
+            await store.put(newer);
+            await store.put(py);
+            await store.put(old);
+            assert.deepEqual((await store.listClaimable(['node'], Date.now(), 5)).map((r) => r.leaseId), [old.leaseId, newer.leaseId]);
+            assert.equal((await store.findByTask('repo', old.taskHash, old.inputsHash))?.leaseId, newer.leaseId);
+            await store.supersede('repo', newer.leaseId);
+            assert.equal((await store.findByTask('repo', old.taskHash, old.inputsHash))?.leaseId, old.leaseId);
+        });
+    });
+}
+//# sourceMappingURL=lease-store-contract.js.map

package/dist/src/testing/lease-store-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-store-contract.js","sourceRoot":"","sources":["../../../src/testing/lease-store-contract.ts"],"names":[],"mappings":"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"}

package/dist/src/testing/protocol-suite.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import type { RackDispatch } from '../lease/rack-dispatch.js';
+/** Supplies a fresh real-listener control plane for each protocol case. */
+export interface RackProtocolFixture {
+    /** Origin serving /api/rack. */
+    baseUrl: string;
+    /** Repository identifier; defaults to 'repo'. */
+    repo?: string;
+    /** Optional transport for non-HTTP object URLs in a test bridge. */
+    fetch?: typeof fetch;
+    /** Mints one unconsumed enrollment credential. */
+    mintEnrollmentToken(): Promise<string>;
+    /** Creates, cancels and inspects leases through the host's real dispatch. */
+    dispatch: RackDispatch;
+    /** Writes a committed input object. */
+    seedObject(repo: string, bytes: Uint8Array): Promise<string>;
+    /** Reads a committed output, or null when absent. */
+    readObject(repo: string, hash: string): Promise<Uint8Array | null>;
+    /** Reads the attempt's persisted stream. */
+    readLog(repo: string, taskHash: string, inputsHash: string, executionId: string, stream: 'stdout' | 'stderr'): Promise<string>;
+    /** Advances the host's identity clock when supported. */
+    advanceClock?(ms: number): void;
+    /** Closes the listener and removes temporary state. */
+    teardown(): Promise<void>;
+}
+/**
+ * Registers shared v2 wire, auth, transfer and attempt-log contracts.
+ * Each case uses a fresh fixture and always tears it down, even on failure.
+ * @param label - Host implementation under test
+ * @param setup - Starts an isolated control plane; use a short empty poll window
+ * @example
+ * rackProtocolSuite('local', () => startProtocolFixture());
+ */
+export declare function rackProtocolSuite(label: string, setup: () => Promise<RackProtocolFixture>): void;
+//# sourceMappingURL=protocol-suite.d.ts.map

package/dist/src/testing/protocol-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-suite.d.ts","sourceRoot":"","sources":["../../../src/testing/protocol-suite.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAS9D,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,kDAAkD;IAClD,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,EAAE,YAAY,CAAC;IACvB,uCAAuC;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,qDAAqD;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnE,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/H,yDAAyD;IACzD,YAAY,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,uDAAuD;IACvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAyIhG"}

package/dist/src/testing/protocol-suite.js

@@ -0,0 +1,207 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { BooleanType, StringType, decodeBeast2For, encodeBeast2For, none, some, variant } from '@elaraai/east';
+import { BEAST2_CONTENT_TYPE, ResponseType } from '@elaraai/e3-types';
+import { uuidv7 } from '@elaraai/e3-core';
+import { E3_RACK_VERSION } from '../version.js';
+import { ROTATION_AGE_MS, ROTATION_GRACE_MS } from '../identity/machine-identity.js';
+import { RackEnrollRequestType, RackEnrollResponseType, RackLeaseRequestType, RackLeaseGrantType, RackHeartbeatRequestType, RackHeartbeatResponseType, RackExtendRequestType, RackWatchRequestType, RackWatchResponseType, RACK_WATCH_MAX_LEASES, RackCompleteRequestType, RackCompleteResponseType, RackStorageRequestType, RackStorageResponseType, RackLogsRequestType } from '../protocol/index.js';
+/**
+ * Registers shared v2 wire, auth, transfer and attempt-log contracts.
+ * Each case uses a fresh fixture and always tears it down, even on failure.
+ * @param label - Host implementation under test
+ * @param setup - Starts an isolated control plane; use a short empty poll window
+ * @example
+ * rackProtocolSuite('local', () => startProtocolFixture());
+ */
+export function rackProtocolSuite(label, setup) {
+    const fixture = async (t) => {
+        const f = await setup();
+        t.after(() => f.teardown());
+        const request = f.fetch ?? fetch;
+        const repo = f.repo ?? 'repo';
+        const raw = (path, type, value, token = '') => request(`${f.baseUrl}/api/rack/${path}`, {
+            method: 'POST', headers: { 'content-type': BEAST2_CONTENT_TYPE, authorization: `Bearer ${token}` },
+            body: encodeBeast2For(type)(value), signal: AbortSignal.timeout(30000),
+        });
+        const success = async (response, type) => {
+            assert.equal(response.status, 200);
+            const value = decodeBeast2For(ResponseType(type))(new Uint8Array(await response.arrayBuffer()));
+            assert(value.type === 'success');
+            return value.value;
+        };
+        const enroll = async (enrollmentToken, ready = true) => {
+            const enrolled = await success(await raw('enroll', RackEnrollRequestType, {
+                enrollmentToken: enrollmentToken ?? await f.mintEnrollmentToken(), hostInfo: { label: 'contract', tiers: ['node'], capacity: 1n, agentVersion: `0.5.0+e3.${E3_RACK_VERSION}` },
+            }), RackEnrollResponseType);
+            if (ready)
+                await success(await heartbeat(enrolled.rackToken), RackHeartbeatResponseType);
+            return enrolled;
+        };
+        const claim = (token) => raw('lease', RackLeaseRequestType, { tiers: ['node'], bootId: 'contract-boot' }, token);
+        const heartbeat = (token, runningLeases = []) => raw('heartbeat', RackHeartbeatRequestType, {
+            healthy: true, freeCapacity: 1n, runningLeases, bootId: 'contract-boot', cacheBytes: 0n, agentVersion: `0.5.0+e3.${E3_RACK_VERSION}`,
+        }, token);
+        const create = async () => {
+            const hash = await f.seedObject(repo, encodeBeast2For(StringType)('input'));
+            return f.dispatch.createLease({ version: 2, workspace: 'dev', taskName: 'contract', e3Version: E3_RACK_VERSION,
+                closure: { hashes: [hash] }, runnerEvent: { mode: 'task', repo, taskHash: hash, inputHashes: [], launchId: uuidv7(), timeoutMs: 60000 } }, 'node');
+        };
+        const complete = (token, leaseId, result = { taskName: 'contract', status: 'failed', state: 'failed', exitCode: 1 }) => raw('complete', RackCompleteRequestType, { repo, leaseId, resultJson: JSON.stringify(result), outputUploadId: none, inlineOutput: none }, token);
+        return { ...f, repo, request, raw, success, enroll, claim, heartbeat, create, complete };
+    };
+    void describe(`rack protocol (${label})`, () => {
+        void it('consumes enrollment once and refuses missing or bad machine credentials', async (t) => {
+            const f = await fixture(t);
+            const token = await f.mintEnrollmentToken();
+            await f.enroll(token);
+            await assert.rejects(f.enroll(token));
+            for (const bearer of ['', 'e3rk_bad'])
+                assert.equal((await f.heartbeat(bearer)).status, 401);
+        });
+        void it('returns 204 from an empty poll and grants one claimant exclusive extension rights', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const b = await f.enroll();
+            assert.equal((await f.claim(a.rackToken)).status, 204);
+            const lease = await f.create();
+            const grants = await Promise.all([f.claim(a.rackToken), f.claim(b.rackToken)]);
+            assert.deepEqual(grants.map((response) => response.status).sort(), [200, 204]);
+            const winner = grants[0].status === 200 ? a : b;
+            const loser = Object.is(winner, a) ? b : a;
+            for (const [peer, allowed] of [[winner, true], [loser, false]]) {
+                assert.equal(await f.success(await f.raw('lease/extend', RackExtendRequestType, { repo: f.repo, leaseId: lease.leaseId }, peer.rackToken), BooleanType), allowed);
+            }
+        });
+        void it('requires a ready heartbeat even when enrollment declares capacity', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll(undefined, false);
+            await f.create();
+            assert.equal((await f.claim(a.rackToken)).status, 204);
+            await f.success(await f.heartbeat(a.rackToken), RackHeartbeatResponseType);
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+        });
+        void it('computes inline output hashes and makes completion idempotent', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const lease = await f.create();
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+            const bytes = encodeBeast2For(StringType)('result');
+            const hash = createHash('sha256').update(bytes).digest('hex');
+            const response = await f.raw('complete', RackCompleteRequestType, { repo: f.repo, leaseId: lease.leaseId,
+                resultJson: JSON.stringify({ taskName: 'contract', status: 'success', outputHash: 'untrusted-inline-hash' }), outputUploadId: none, inlineOutput: some(bytes) }, a.rackToken);
+            assert.equal((await f.success(response, RackCompleteResponseType)).disposition.type, 'recorded');
+            assert.deepEqual(new Uint8Array((await f.readObject(f.repo, hash))), bytes);
+            assert.equal((await f.success(await f.complete(a.rackToken, lease.leaseId), RackCompleteResponseType)).disposition.type, 'idempotent');
+        });
+        void it('checks large PUT checksums and commit receipts before exposing output', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const lease = await f.create();
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+            const bytes = encodeBeast2For(StringType)('large'.repeat(2000));
+            const hash = createHash('sha256').update(bytes).digest('hex');
+            const size = BigInt(bytes.length);
+            const storage = { repo: f.repo, leaseId: lease.leaseId, need: [], output: none, envManifest: none, outputs: [], commits: [] };
+            const declared = await f.success(await f.raw('storage', RackStorageRequestType, { ...storage, outputs: [{ hash, size }] }, a.rackToken), RackStorageResponseType);
+            const target = declared.targets[0].target;
+            assert(target.type === 'put');
+            const headers = Object.fromEntries(target.value.headers);
+            const bad = await f.request(target.value.url, { method: 'PUT', headers, body: new Uint8Array(bytes.length) });
+            assert(!bad.ok);
+            await bad.arrayBuffer();
+            const put = await f.request(target.value.url, { method: 'PUT', headers, body: bytes });
+            assert(put.ok);
+            await put.arrayBuffer();
+            const version = put.headers.get('x-amz-version-id');
+            assert(version);
+            assert.equal(await f.readObject(f.repo, hash), null);
+            for (const receipt of ['wrong', version, version]) {
+                const result = await f.success(await f.raw('storage', RackStorageRequestType, { ...storage, commits: [{ hash, size, version: receipt }] }, a.rackToken), RackStorageResponseType);
+                assert.equal(result.committed[0].committed, receipt === version);
+            }
+            assert.equal((await f.success(await f.complete(a.rackToken, lease.leaseId, { taskName: 'contract', status: 'success', state: 'success', outputHash: hash }), RackCompleteResponseType)).disposition.type, 'recorded');
+            assert.deepEqual(new Uint8Array((await f.readObject(f.repo, hash))), bytes);
+        });
+        for (const how of ['cancel', 'supersede'])
+            void it(`stops a ${how} lease and discards its late completion`, async (t) => {
+                const f = await fixture(t);
+                const a = await f.enroll();
+                const lease = await f.create();
+                await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+                await f.dispatch[how](f.repo, lease.leaseId);
+                assert.equal((await f.success(await f.complete(a.rackToken, lease.leaseId), RackCompleteResponseType)).disposition.type, 'discarded');
+                const ref = { repo: f.repo, leaseId: lease.leaseId };
+                assert.deepEqual((await f.success(await f.heartbeat(a.rackToken, [ref]), RackHeartbeatResponseType)).stop, [ref]);
+                assert.deepEqual((await f.success(await f.raw('lease/watch', RackWatchRequestType, { runningLeases: [ref] }, a.rackToken), RackWatchResponseType)).stop, [ref]);
+            });
+        void it('delivers cancellation through an open watch without a heartbeat or visibility extension', { timeout: 5000 }, async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const lease = await f.create();
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+            const ref = { repo: f.repo, leaseId: lease.leaseId };
+            const response = f.raw('lease/watch', RackWatchRequestType, { runningLeases: [ref] }, a.rackToken);
+            await new Promise(resolve => setTimeout(resolve, 50));
+            const started = performance.now();
+            await f.dispatch.cancel(f.repo, lease.leaseId);
+            assert.deepEqual((await f.success(await response, RackWatchResponseType)).stop, [ref]);
+            assert(performance.now() - started < 1500, 'cancellation should not wait for the health heartbeat');
+        });
+        void it('bounds and authenticates cancellation watches and reveals only caller-supplied references', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const b = await f.enroll();
+            const lease = await f.create();
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+            const ref = { repo: f.repo, leaseId: lease.leaseId };
+            for (const bearer of ['', 'human-jwt', 'e3rk_bad']) {
+                assert.equal((await f.raw('lease/watch', RackWatchRequestType, { runningLeases: [ref] }, bearer)).status, 401);
+            }
+            for (const refs of [[], [ref, ref], [{ ...ref, repo: 'x'.repeat(1025) }],
+                Array.from({ length: RACK_WATCH_MAX_LEASES + 1 }, (_, i) => ({ repo: f.repo, leaseId: `lease-${i}` }))]) {
+                assert.equal((await f.raw('lease/watch', RackWatchRequestType, { runningLeases: refs }, a.rackToken)).status, 400);
+            }
+            // A foreign lease is indistinguishable from an unknown lease: stop your
+            // claimed work, with no status, identity, task or result returned.
+            const unknown = { ...ref, leaseId: 'unknown' };
+            assert.deepEqual((await f.success(await f.raw('lease/watch', RackWatchRequestType, { runningLeases: [ref, unknown] }, b.rackToken), RackWatchResponseType)).stop, [ref, unknown]);
+        });
+        void it('scopes objects and logs to held leases, and addresses logs by the claim-time attempt', async (t) => {
+            const f = await fixture(t);
+            const a = await f.enroll();
+            const b = await f.enroll();
+            const lease = await f.create();
+            await f.success(await f.claim(a.rackToken), RackLeaseGrantType);
+            const ref = { repo: f.repo, leaseId: lease.leaseId };
+            assert.equal((await f.raw('storage', RackStorageRequestType, { ...ref, need: ['f'.repeat(64)], output: none, envManifest: none, outputs: [], commits: [] }, a.rackToken)).status, 403);
+            const logs = { ...ref, chunks: [{ stream: variant('stdout', null), data: 'contract log\n' }] };
+            assert.equal((await f.raw('logs', RackLogsRequestType, logs, b.rackToken)).status, 403);
+            assert.equal(await f.success(await f.raw('logs', RackLogsRequestType, logs, a.rackToken), BooleanType), true);
+            const current = await f.dispatch.getLease(f.repo, lease.leaseId);
+            assert(current?.attempt);
+            assert.equal(await f.readLog(f.repo, lease.taskHash, lease.inputsHash, current.attempt.executionId, 'stdout'), 'contract log\n');
+        });
+        void it('offers rotation, promotes a successor and expires the old credential grace', async (t) => {
+            const f = await fixture(t);
+            if (!f.advanceClock) {
+                t.skip('host has no injectable clock');
+                return;
+            }
+            const a = await f.enroll();
+            f.advanceClock(ROTATION_AGE_MS + 1);
+            const beat = await f.success(await f.heartbeat(a.rackToken), RackHeartbeatResponseType);
+            assert(beat.rotatedToken.type === 'some');
+            await f.success(await f.heartbeat(beat.rotatedToken.value), RackHeartbeatResponseType);
+            await f.success(await f.heartbeat(a.rackToken), RackHeartbeatResponseType);
+            f.advanceClock(ROTATION_GRACE_MS + 1);
+            assert.equal((await f.heartbeat(a.rackToken)).status, 401);
+        });
+    });
+}
+//# sourceMappingURL=protocol-suite.js.map

package/dist/src/testing/protocol-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-suite.js","sourceRoot":"","sources":["../../../src/testing/protocol-suite.ts"],"names":[],"mappings":"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"}

package/dist/src/testing/rack-registry-contract.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type TestContext } from 'node:test';
+import { type RackRegistry } from '../registry/rack-registry.js';
+/**
+ * Tests conditional registration updates against a persistence implementation.
+ * @param label - Backend name included in the suite title
+ * @param setup - Fresh registry per case; registers cleanup with the test context
+ * @example
+ * rackRegistryContract('memory', () => new InMemoryRackRegistry());
+ */
+export declare function rackRegistryContract(label: string, setup: (t: TestContext) => RackRegistry | Promise<RackRegistry>): void;
+//# sourceMappingURL=rack-registry-contract.d.ts.map

package/dist/src/testing/rack-registry-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rack-registry-contract.d.ts","sourceRoot":"","sources":["../../../src/testing/rack-registry-contract.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAI3D,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAoEzH"}

package/dist/src/testing/rack-registry-contract.js

@@ -0,0 +1,106 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { equalFor, none, some } from '@elaraai/east';
+import { RackRegistrationType } from '../protocol/registration.js';
+import { updateRack } from '../registry/rack-registry.js';
+/**
+ * Tests conditional registration updates against a persistence implementation.
+ * @param label - Backend name included in the suite title
+ * @param setup - Fresh registry per case; registers cleanup with the test context
+ * @example
+ * rackRegistryContract('memory', () => new InMemoryRackRegistry());
+ */
+export function rackRegistryContract(label, setup) {
+    const registration = () => ({ rackId: 'rack-1', label: 'fixture', enrolledAt: new Date(1000),
+        tiers: ['node'], capacity: 2n, lastSeenAt: new Date(2000), agentVersion: '1.0.86', healthy: true,
+        lastBootId: some('boot-1'), approvedBootId: none });
+    void describe(`rack registry (${label})`, () => {
+        void it('round-trips independent values and replaces exactly the observed registration', async (t) => {
+            const store = await setup(t);
+            const initial = registration();
+            await store.putRack(initial);
+            initial.tiers.push('py');
+            initial.lastSeenAt.setTime(0);
+            const expected = (await store.getRack(initial.rackId));
+            assert.ok(equalFor(RackRegistrationType)(expected, registration()));
+            const next = { ...expected, healthy: false, capacity: 0n };
+            assert.equal(await store.compareAndSetRack(expected, next), true);
+            next.tiers.push('full');
+            assert.equal((await store.getRack(initial.rackId)).healthy, false);
+            assert.deepEqual((await store.getRack(initial.rackId)).tiers, ['node']);
+            assert.equal(await store.compareAndSetRack(expected, { ...expected, label: 'stale' }), false);
+        });
+        void it('allows one winner among concurrent writes and never recreates a revoked identity', async (t) => {
+            const store = await setup(t);
+            const expected = registration();
+            await store.putRack(expected);
+            const results = await Promise.all([
+                store.compareAndSetRack(expected, { ...expected, healthy: false }),
+                store.compareAndSetRack(expected, { ...expected, approvedBootId: some('boot-1') }),
+            ]);
+            assert.equal(results.filter(Boolean).length, 1);
+            const current = (await store.getRack(expected.rackId));
+            assert.equal(await store.deleteRack(expected.rackId), true);
+            assert.equal(await store.compareAndSetRack(current, expected), false);
+            assert.equal(await updateRack(store, expected.rackId, () => ({ healthy: true })), null);
+            assert.equal(await store.getRack(expected.rackId), null);
+            await assert.rejects(store.compareAndSetRack(expected, { ...expected, rackId: 'other' }), /identity/);
+        });
+        void it('recomputes tier patches after a concurrent drain and keeps heartbeat health, capacity and time', async (t) => {
+            const store = await setup(t);
+            const initial = registration();
+            await store.putRack(initial);
+            const cas = store.compareAndSetRack.bind(store);
+            let race = true;
+            store.compareAndSetRack = async (expected, next) => {
+                if (race) {
+                    race = false;
+                    await cas(expected, { ...expected, healthy: false, capacity: 0n, lastSeenAt: new Date(3000) });
+                }
+                return cas(expected, next);
+            };
+            const next = await updateRack(store, initial.rackId, () => ({ tiers: ['node', 'py'] }));
+            assert.ok(next);
+            assert.equal(next.healthy, false);
+            assert.equal(next.capacity, 0n);
+            assert.equal(next.lastSeenAt.getTime(), 3000);
+            assert.deepEqual(next.tiers, ['node', 'py']);
+        });
+        void it('rechecks first-boot approval and revocation after conflicting writes', async (t) => {
+            const store = await setup(t);
+            const initial = { ...registration(), lastBootId: none };
+            await store.putRack(initial);
+            const cas = store.compareAndSetRack.bind(store);
+            let race = true;
+            store.compareAndSetRack = async (expected, next) => {
+                if (race) {
+                    race = false;
+                    await cas(expected, { ...expected, lastBootId: some('boot-a'), approvedBootId: some('boot-a') });
+                }
+                return cas(expected, next);
+            };
+            const next = await updateRack(store, initial.rackId, current => ({ lastBootId: some('boot-b'),
+                approvedBootId: current.lastBootId.type === 'none' && current.approvedBootId.type === 'none' ? some('boot-b') : current.approvedBootId }));
+            assert.deepEqual(next?.approvedBootId, some('boot-a'));
+            store.compareAndSetRack = async (expected, next) => { await store.deleteRack(expected.rackId); return cas(expected, next); };
+            assert.equal(await updateRack(store, initial.rackId, () => ({ healthy: true })), null);
+            assert.equal(await store.getRack(initial.rackId), null);
+        });
+        void it('bounds contention and propagates storage failures', async (t) => {
+            const store = await setup(t);
+            const initial = registration();
+            await store.putRack(initial);
+            let attempts = 0;
+            store.compareAndSetRack = () => { attempts++; return Promise.resolve(false); };
+            await assert.rejects(updateRack(store, initial.rackId, () => ({ healthy: false })), /retry/);
+            assert.equal(attempts, 8);
+            store.compareAndSetRack = () => Promise.reject(new Error('offline'));
+            await assert.rejects(updateRack(store, initial.rackId, () => ({ healthy: false })), /offline/);
+        });
+    });
+}
+//# sourceMappingURL=rack-registry-contract.js.map

package/dist/src/testing/rack-registry-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rack-registry-contract.js","sourceRoot":"","sources":["../../../src/testing/rack-registry-contract.ts"],"names":[],"mappings":"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"}