@ethlete/cli 3.0.0-next.27 → 3.0.0-next.28

package/src/lib/design/resident/discovery.d.ts

@@ -0,0 +1,21 @@
+/** What a resident design process writes so the CLI of its checkout finds it. */
+export type Discovery = {
+    pid: number;
+    port: number;
+    checkout: string;
+    build: string;
+    token: string;
+    startedAt: string;
+};
+export type IsAlive = (pid: number) => boolean;
+export declare const isAlive: IsAlive;
+export declare const residentDirOf: (target: string) => string;
+export declare const readDiscovery: (target: string) => Discovery | null;
+export declare const writeDiscovery: (target: string, discovery: Discovery) => void;
+/** Removes the discovery file, or with `pid` only the one that process wrote. */
+export declare const removeDiscovery: (target: string, pid?: number) => void;
+/** The discovery file of the checkout, after removing one whose process is gone. */
+export declare const liveDiscoveryOf: (options: {
+    target: string;
+    alive?: IsAlive;
+}) => Discovery | null;

package/src/lib/design/resident/discovery.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveDiscoveryOf = exports.removeDiscovery = exports.writeDiscovery = exports.readDiscovery = exports.residentDirOf = exports.isAlive = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const isAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== 'ESRCH';
+    }
+};
+exports.isAlive = isAlive;
+const residentDirOf = (target) => (0, path_1.join)(target, 'tmp', 'design-resident');
+exports.residentDirOf = residentDirOf;
+const discoveryPathOf = (target) => (0, path_1.join)((0, exports.residentDirOf)(target), 'process.json');
+const readDiscovery = (target) => {
+    try {
+        const value = JSON.parse((0, fs_1.readFileSync)(discoveryPathOf(target), 'utf8'));
+        return typeof value.pid === 'number' &&
+            typeof value.port === 'number' &&
+            typeof value.token === 'string' &&
+            typeof value.build === 'string' &&
+            typeof value.checkout === 'string'
+            ? value
+            : null;
+    }
+    catch (_a) {
+        return null;
+    }
+};
+exports.readDiscovery = readDiscovery;
+const writeDiscovery = (target, discovery) => {
+    const file = discoveryPathOf(target);
+    const written = `${file}.${discovery.pid}`;
+    (0, fs_1.mkdirSync)((0, exports.residentDirOf)(target), { recursive: true });
+    (0, fs_1.writeFileSync)(written, `${JSON.stringify(discovery, null, 2)}\n`);
+    (0, fs_1.renameSync)(written, file);
+};
+exports.writeDiscovery = writeDiscovery;
+/** Removes the discovery file, or with `pid` only the one that process wrote. */
+const removeDiscovery = (target, pid) => {
+    var _a;
+    if (pid !== undefined && ((_a = (0, exports.readDiscovery)(target)) === null || _a === void 0 ? void 0 : _a.pid) !== pid)
+        return;
+    (0, fs_1.rmSync)(discoveryPathOf(target), { force: true });
+};
+exports.removeDiscovery = removeDiscovery;
+/** The discovery file of the checkout, after removing one whose process is gone. */
+const liveDiscoveryOf = (options) => {
+    const { target, alive = exports.isAlive } = options;
+    const found = (0, exports.readDiscovery)(target);
+    if (!found)
+        return null;
+    if (alive(found.pid))
+        return found;
+    (0, exports.removeDiscovery)(target, found.pid);
+    return null;
+};
+exports.liveDiscoveryOf = liveDiscoveryOf;
+//# sourceMappingURL=discovery.js.map

package/src/lib/design/resident/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/resident/discovery.ts"],"names":[],"mappings":"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"}

package/src/lib/design/resident/resident-process.d.ts

@@ -0,0 +1,19 @@
+import { ResidentRequest, ResidentRun } from './server';
+/**
+ * Runs `compare`, `check --product`/`--part`, `sketch check` and `sketch ready` with a design server, Chromium and a watch-built harness app that stay up
+ * between requests. Each request reads the lib build under the lib-build lock only while it runs, a changed lib build or
+ * design config restarts the design server and Chromium before it draws, and every request draws the design files as
+ * they are when it starts.
+ */
+export declare const createWarmRuns: (options: {
+    target: string;
+}) => {
+    run: ResidentRun;
+    jumps: ({ argv }: ResidentRequest) => boolean;
+    warmUp: () => Promise<void>;
+    close: () => Promise<void>;
+};
+/** `et design __resident`: the resident design process of the checkout, until it idles out or is stopped. */
+export declare const serveResident: (options: {
+    target: string;
+}) => Promise<number>;

package/src/lib/design/resident/resident-process.js

@@ -0,0 +1,189 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serveResident = exports.createWarmRuns = void 0;
+const crypto_1 = require("crypto");
+const check_1 = require("../check");
+const design_config_1 = require("../design-config");
+const stamp_1 = require("../stamp");
+const serve_1 = require("../serve");
+const thumb_1 = require("../thumb");
+const sketch_command_1 = require("../sketch-command");
+const compare_command_1 = require("../system/compare-command");
+const harness_server_1 = require("../system/harness-server");
+const harness_watch_1 = require("../system/harness-watch");
+const stale_design_mocks_1 = require("../system/stale-design-mocks");
+const stale_dist_1 = require("../system/stale-dist");
+const run_abort_1 = require("../run-abort");
+const run_yield_1 = require("../run-yield");
+const timings_1 = require("../timings");
+const client_1 = require("./client");
+const discovery_1 = require("./discovery");
+const server_1 = require("./server");
+/**
+ * Runs `compare`, `check --product`/`--part`, `sketch check` and `sketch ready` with a design server, Chromium and a watch-built harness app that stay up
+ * between requests. Each request reads the lib build under the lib-build lock only while it runs, a changed lib build or
+ * design config restarts the design server and Chromium before it draws, and every request draws the design files as
+ * they are when it starts.
+ */
+const createWarmRuns = (options) => {
+    const { target } = options;
+    let stamp = null;
+    let server = null;
+    let queue = null;
+    let active = 0;
+    const harness = (0, harness_watch_1.createHarnessWatch)({ target });
+    const closeDraw = () => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const [closingServer, closingQueue] = [server, queue];
+        server = null;
+        queue = null;
+        yield (closingQueue === null || closingQueue === void 0 ? void 0 : closingQueue.close());
+        yield ((_a = (yield (closingServer === null || closingServer === void 0 ? void 0 : closingServer.catch(() => null)))) === null || _a === void 0 ? void 0 : _a.close());
+    });
+    const startServer = (config) => __awaiter(void 0, void 0, void 0, function* () {
+        const started = yield (0, serve_1.createDesignServer)({ target, config, listen: true, port: 0 });
+        try {
+            yield started.listen();
+        }
+        catch (error) {
+            yield started.close();
+            throw error;
+        }
+        return started;
+    });
+    const warm = {
+        server: (config) => {
+            server !== null && server !== void 0 ? server : (server = startServer(config).catch((error) => {
+                server = null;
+                throw error;
+            }));
+            return server;
+        },
+        queue: () => (queue !== null && queue !== void 0 ? queue : (queue = (0, thumb_1.createDrawQueue)({ target }))),
+    };
+    const start = (_a) => __awaiter(void 0, [_a], void 0, function* ({ product }) {
+        const served = yield (0, run_abort_1.unlessAborted)((0, run_abort_1.runSignal)(), harness.current(product));
+        if (served === null)
+            return (0, harness_server_1.startHarnessServer)({ target, product });
+        return typeof served === 'string' ? served : { url: served.url, root: served.root, stop: () => __awaiter(void 0, void 0, void 0, function* () { return undefined; }) };
+    });
+    const stampOf = (config) => `${(0, stale_dist_1.libBuildStampOf)({ target, config })}#${JSON.stringify(config)}`;
+    const refresh = (config) => __awaiter(void 0, void 0, void 0, function* () {
+        var _a;
+        const next = stampOf(config);
+        if (stamp !== null && stamp !== next && (server || queue)) {
+            console.error('the lib build or the design config changed - restarting the warm design server and Chromium');
+            yield closeDraw();
+        }
+        stamp = next;
+        (_a = (yield (server === null || server === void 0 ? void 0 : server.catch(() => null)))) === null || _a === void 0 ? void 0 : _a.forgetDrawn();
+    });
+    const runIn = (_a) => __awaiter(void 0, [_a], void 0, function* ({ argv, invocation }) {
+        var _b;
+        if (!(0, client_1.runsInResident)(argv)) {
+            console.error(`the resident design process runs compare, check --product/--part, sketch check and sketch ready only, not ${argv.join(' ')}`);
+            return 2;
+        }
+        if ((0, stale_design_mocks_1.guardsDesignMocks)(argv) && !(0, stale_design_mocks_1.designMocksFresh)({ target }))
+            return 1;
+        const config = (0, design_config_1.readConfig)(target);
+        const inside = active > 0;
+        const read = inside ? { ok: true, release: () => undefined } : yield (0, stale_dist_1.readFreshDist)({ target, config });
+        if (!read.ok)
+            return 1;
+        active++;
+        try {
+            if (inside)
+                (_b = (yield (server === null || server === void 0 ? void 0 : server.catch(() => null)))) === null || _b === void 0 ? void 0 : _b.forgetDrawn();
+            else
+                yield refresh(config);
+            const rest = argv.slice(1);
+            if (argv[0] === 'sketch')
+                return yield (0, sketch_command_1.designSketch)({ target, argv: rest, invocation, warm });
+            if (argv[0] === 'check')
+                return yield (0, check_1.checkDesign)({ target, argv: rest, invocation, warm });
+            return yield (0, compare_command_1.designCompare)(Object.assign({ target, argv: rest, invocation,
+                start }, (rest.includes('--live') ? {} : { shoot: (0, compare_command_1.shootStatesWith)(warm) })));
+        }
+        finally {
+            active--;
+            read.release();
+        }
+    });
+    const jumps = ({ argv }) => {
+        if (argv[0] !== 'compare' || active === 0)
+            return false;
+        const config = (0, design_config_1.readConfig)(target);
+        return stampOf(config) === stamp && (0, stale_dist_1.staleLibsOf)({ target, config }).length === 0;
+    };
+    const run = ({ argv, invocation, waitedMs, signal, yieldTurn }) => (0, timings_1.recordRun)({ file: (0, timings_1.timingsFileOf)(target), argv, resident: true }, () => {
+        if (waitedMs !== undefined)
+            (0, timings_1.recordPhase)('resident-queue-wait', waitedMs);
+        return (0, run_abort_1.withRunSignal)(signal, () => (0, run_yield_1.withRunYield)(yieldTurn, () => runIn({ argv, invocation }))).then((code) => (signal === null || signal === void 0 ? void 0 : signal.aborted) ? server_1.ABORTED_EXIT : code);
+    });
+    const warmUp = () => __awaiter(void 0, void 0, void 0, function* () {
+        const config = (0, design_config_1.readConfig)(target);
+        if (!config)
+            return;
+        yield refresh(config);
+        yield warm.server(config);
+        yield warm.queue().run(() => __awaiter(void 0, void 0, void 0, function* () { return undefined; }));
+    });
+    const close = () => __awaiter(void 0, void 0, void 0, function* () {
+        yield closeDraw();
+        yield harness.stop();
+    });
+    return { run, jumps, warmUp, close };
+};
+exports.createWarmRuns = createWarmRuns;
+/** `et design __resident`: the resident design process of the checkout, until it idles out or is stopped. */
+const serveResident = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { target } = options;
+    const build = (0, stamp_1.buildStampOf)().build;
+    const token = (0, crypto_1.randomUUID)();
+    const runs = (0, exports.createWarmRuns)({ target });
+    let exiting = false;
+    let close = () => __awaiter(void 0, void 0, void 0, function* () { return undefined; });
+    const exit = (reason) => __awaiter(void 0, void 0, void 0, function* () {
+        if (exiting)
+            return;
+        exiting = true;
+        console.error(`resident design process exits: ${reason}`);
+        (0, discovery_1.removeDiscovery)(target, process.pid);
+        yield close();
+        yield runs.close();
+        process.exit(0);
+    });
+    process.once('SIGTERM', () => void exit('SIGTERM'));
+    process.once('SIGINT', () => void exit('SIGINT'));
+    const server = yield (0, server_1.startResidentServer)({
+        token,
+        identity: { pid: process.pid, build, checkout: target },
+        run: runs.run,
+        jumps: runs.jumps,
+        onExit: (reason) => void exit(reason === 'idle' ? 'idle for 30 min' : 'stopped'),
+    });
+    close = server.close;
+    yield runs.warmUp().catch((error) => console.error(`warm-up failed: ${String(error)}`));
+    (0, discovery_1.writeDiscovery)(target, {
+        pid: process.pid,
+        port: server.port,
+        checkout: target,
+        build,
+        token,
+        startedAt: new Date().toISOString(),
+    });
+    console.error(`resident design process ${process.pid} serves on 127.0.0.1:${server.port}`);
+    return new Promise(() => undefined);
+});
+exports.serveResident = serveResident;
+//# sourceMappingURL=resident-process.js.map

package/src/lib/design/resident/resident-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resident-process.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/resident/resident-process.ts"],"names":[],"mappings":"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"}

package/src/lib/design/resident/server.d.ts

@@ -0,0 +1,52 @@
+export declare const RESIDENT_IDLE_MS: number;
+export declare const RESIDENT_BEAT_MS = 10000;
+export declare const TOKEN_HEADER = "x-et-design-token";
+/** The environment variables of the calling CLI a request carries into the resident process. */
+export declare const FORWARDED_ENV: readonly ["ETHLETE_DESIGN_PHASES", "CLAUDE_CODE_SESSION_ID", "TMUX_PANE", "ETHLETE_AGENT_ROLE"];
+export type ResidentRequest = {
+    argv: string[];
+    invocation: string;
+    env: Partial<Record<(typeof FORWARDED_ENV)[number], string>>;
+};
+/**
+ * The run gets `signal`, which aborts when the client closes its connection before the answer ends, and `yieldTurn`,
+ * which runs the waiting requests `jumps` lets go first and settles when they are done.
+ */
+export type ResidentRun = (request: ResidentRequest & {
+    waitedMs?: number;
+    signal?: AbortSignal;
+    yieldTurn?: () => Promise<void>;
+}) => Promise<number>;
+export declare const ABORTED_EXIT = 130;
+/** One line of the newline-delimited JSON answer to a run request. */
+export type ResidentFrame = {
+    o: string;
+} | {
+    e: string;
+} | {
+    beat: true;
+} | {
+    exit: number;
+};
+type Write = (stream: 'o' | 'e', text: string) => void;
+/** Sends what the process writes to stdout and stderr to `write` until the returned function restores them. */
+export declare const captureOutput: (write: Write) => () => void;
+/**
+ * Serves run requests on 127.0.0.1, one at a time, streaming what each run writes back as `ResidentFrame` lines. A
+ * waiting request that `jumps` accepts runs inside a running one when that one calls its `yieldTurn`.
+ * Calls `onExit('idle')` after `idleMs` without a request and `onExit('stop')` on a stop request.
+ */
+export declare const startResidentServer: (options: {
+    token: string;
+    identity: Record<string, unknown>;
+    run: ResidentRun;
+    onExit: (reason: "idle" | "stop") => void;
+    idleMs?: number;
+    beatMs?: number;
+    capture?: typeof captureOutput;
+    jumps?: (request: ResidentRequest) => boolean;
+}) => Promise<{
+    port: number;
+    close: () => Promise<void>;
+}>;
+export {};

package/src/lib/design/resident/server.js

@@ -0,0 +1,212 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startResidentServer = exports.captureOutput = exports.ABORTED_EXIT = exports.FORWARDED_ENV = exports.TOKEN_HEADER = exports.RESIDENT_BEAT_MS = exports.RESIDENT_IDLE_MS = void 0;
+const events_1 = require("events");
+const http_1 = require("http");
+const perf_hooks_1 = require("perf_hooks");
+const rxjs_1 = require("rxjs");
+exports.RESIDENT_IDLE_MS = 30 * 60000;
+exports.RESIDENT_BEAT_MS = 10000;
+exports.TOKEN_HEADER = 'x-et-design-token';
+/** The environment variables of the calling CLI a request carries into the resident process. */
+exports.FORWARDED_ENV = [
+    'ETHLETE_DESIGN_PHASES',
+    'CLAUDE_CODE_SESSION_ID',
+    'TMUX_PANE',
+    'ETHLETE_AGENT_ROLE',
+];
+exports.ABORTED_EXIT = 130;
+/** Sends what the process writes to stdout and stderr to `write` until the returned function restores them. */
+const captureOutput = (write) => {
+    const out = process.stdout.write;
+    const err = process.stderr.write;
+    const into = (stream) => ((chunk, ...rest) => {
+        write(stream, typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString());
+        const done = rest.find((arg) => typeof arg === 'function');
+        done === null || done === void 0 ? void 0 : done();
+        return true;
+    });
+    process.stdout.write = into('o');
+    process.stderr.write = into('e');
+    return () => {
+        process.stdout.write = out;
+        process.stderr.write = err;
+    };
+};
+exports.captureOutput = captureOutput;
+const withEnv = (env, run) => __awaiter(void 0, void 0, void 0, function* () {
+    const before = exports.FORWARDED_ENV.map((key) => [key, process.env[key]]);
+    const apply = (entries) => {
+        for (const [key, value] of entries) {
+            if (value === undefined)
+                delete process.env[key];
+            else
+                process.env[key] = value;
+        }
+    };
+    apply(exports.FORWARDED_ENV.map((key) => [key, env[key]]));
+    try {
+        return yield run();
+    }
+    finally {
+        apply(before);
+    }
+});
+const bodyOf = (request) => new Promise((done, fail) => {
+    let body = '';
+    request.setEncoding('utf8');
+    request.on('data', (chunk) => (body += chunk));
+    request.once('end', () => done(body));
+    request.once('error', fail);
+});
+const messageOf = (error) => { var _a; return (error instanceof Error ? ((_a = error.stack) !== null && _a !== void 0 ? _a : error.message) : String(error)); };
+/**
+ * Serves run requests on 127.0.0.1, one at a time, streaming what each run writes back as `ResidentFrame` lines. A
+ * waiting request that `jumps` accepts runs inside a running one when that one calls its `yieldTurn`.
+ * Calls `onExit('idle')` after `idleMs` without a request and `onExit('stop')` on a stop request.
+ */
+const startResidentServer = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b;
+    const { token, identity, run, onExit, idleMs = exports.RESIDENT_IDLE_MS, beatMs = exports.RESIDENT_BEAT_MS } = options;
+    const capture = (_a = options.capture) !== null && _a !== void 0 ? _a : exports.captureOutput;
+    const jumps = (_b = options.jumps) !== null && _b !== void 0 ? _b : (() => false);
+    const waiting = [];
+    let running = false;
+    let pending = 0;
+    let idle;
+    const arm = () => {
+        idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+        idle = (0, rxjs_1.timer)(idleMs)
+            .pipe((0, rxjs_1.tap)(() => onExit('idle')))
+            .subscribe();
+    };
+    const pump = () => __awaiter(void 0, void 0, void 0, function* () {
+        if (running)
+            return;
+        running = true;
+        try {
+            for (let turn = waiting.shift(); turn; turn = waiting.shift())
+                yield turn.go();
+        }
+        finally {
+            running = false;
+        }
+    });
+    const yieldTurn = () => __awaiter(void 0, void 0, void 0, function* () {
+        const jumping = waiting.filter((turn) => jumps(turn.request));
+        for (const turn of jumping) {
+            const at = waiting.indexOf(turn);
+            if (at === -1)
+                continue;
+            waiting.splice(at, 1);
+            yield turn.go();
+        }
+    });
+    const runRequest = (request, response) => __awaiter(void 0, void 0, void 0, function* () {
+        const asked = JSON.parse(yield bodyOf(request));
+        const send = (frame) => {
+            if (!response.writableEnded && !response.destroyed)
+                response.write(`${JSON.stringify(frame)}\n`);
+        };
+        const gone = new AbortController();
+        (0, events_1.setMaxListeners)(0, gone.signal);
+        response.once('close', () => {
+            if (!response.writableEnded)
+                gone.abort();
+        });
+        response.writeHead(200, { 'content-type': 'application/x-ndjson' });
+        if (pending > 1)
+            send({ e: 'waiting for an earlier request to the resident design process\n' });
+        const asking = perf_hooks_1.performance.now();
+        const beat = (0, rxjs_1.interval)(beatMs)
+            .pipe((0, rxjs_1.tap)(() => send({ beat: true })))
+            .subscribe();
+        const runTurn = () => __awaiter(void 0, void 0, void 0, function* () {
+            if (gone.signal.aborted)
+                return exports.ABORTED_EXIT;
+            try {
+                return yield withEnv(asked.env, () => __awaiter(void 0, void 0, void 0, function* () {
+                    const restore = capture((stream, text) => send(stream === 'o' ? { o: text } : { e: text }));
+                    try {
+                        return yield run(Object.assign(Object.assign({}, asked), { waitedMs: perf_hooks_1.performance.now() - asking, signal: gone.signal, yieldTurn }));
+                    }
+                    finally {
+                        restore();
+                    }
+                }));
+            }
+            catch (error) {
+                send({ e: `${messageOf(error)}\n` });
+                return 1;
+            }
+        });
+        const turn = new Promise((done) => {
+            waiting.push({ request: asked, go: () => __awaiter(void 0, void 0, void 0, function* () { return done(yield runTurn()); }) });
+            void pump();
+        });
+        try {
+            send({ exit: yield turn });
+        }
+        finally {
+            beat.unsubscribe();
+            response.end();
+        }
+    });
+    const server = (0, http_1.createServer)((request, response) => {
+        if (request.headers[exports.TOKEN_HEADER] !== token) {
+            response.writeHead(403).end();
+            return;
+        }
+        if (request.method === 'GET' && request.url === '/ping') {
+            response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(Object.assign(Object.assign({}, identity), { pending })));
+            return;
+        }
+        if (request.method === 'POST' && request.url === '/stop') {
+            response.writeHead(200).end();
+            setImmediate(() => onExit('stop'));
+            return;
+        }
+        if (request.method === 'POST' && request.url === '/run') {
+            idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+            pending++;
+            void runRequest(request, response)
+                .catch((error) => {
+                if (!response.headersSent)
+                    response.writeHead(400);
+                response.end(messageOf(error));
+            })
+                .finally(() => {
+                pending--;
+                if (pending === 0)
+                    arm();
+            });
+            return;
+        }
+        response.writeHead(404).end();
+    });
+    yield new Promise((done, fail) => {
+        server.once('error', fail);
+        server.listen(0, '127.0.0.1', () => done());
+    });
+    arm();
+    return {
+        port: server.address().port,
+        close: () => __awaiter(void 0, void 0, void 0, function* () {
+            idle === null || idle === void 0 ? void 0 : idle.unsubscribe();
+            const closed = new Promise((done) => server.close(done));
+            server.closeAllConnections();
+            yield closed;
+        }),
+    };
+});
+exports.startResidentServer = startResidentServer;
+//# sourceMappingURL=server.js.map

package/src/lib/design/resident/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/design/resident/server.ts"],"names":[],"mappings":"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"}

package/src/lib/design/run-abort.d.ts

@@ -0,0 +1,9 @@
+export declare class RunAbortedError extends Error {
+    constructor();
+}
+/** Runs `run` as the design run `signal` aborts; draws asked during it stop when it does. Runs never overlap. */
+export declare const withRunSignal: <T>(signal: AbortSignal | undefined, run: () => Promise<T>) => Promise<T>;
+/** The abort signal of the design run in progress, or `null`. */
+export declare const runSignal: () => AbortSignal | null;
+/** Settles like `work`, or rejects with a `RunAbortedError` as soon as `signal` aborts. */
+export declare const unlessAborted: <T>(signal: AbortSignal | null, work: Promise<T>) => Promise<T>;

package/src/lib/design/run-abort.js

@@ -0,0 +1,45 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlessAborted = exports.runSignal = exports.withRunSignal = exports.RunAbortedError = void 0;
+const rxjs_1 = require("rxjs");
+class RunAbortedError extends Error {
+    constructor() {
+        super('design-explore: the run was aborted, its client closed the connection');
+    }
+}
+exports.RunAbortedError = RunAbortedError;
+let current = null;
+/** Runs `run` as the design run `signal` aborts; draws asked during it stop when it does. Runs never overlap. */
+const withRunSignal = (signal, run) => __awaiter(void 0, void 0, void 0, function* () {
+    const outer = current;
+    current = signal !== null && signal !== void 0 ? signal : null;
+    try {
+        return yield run();
+    }
+    finally {
+        current = outer;
+    }
+});
+exports.withRunSignal = withRunSignal;
+/** The abort signal of the design run in progress, or `null`. */
+const runSignal = () => current;
+exports.runSignal = runSignal;
+/** Settles like `work`, or rejects with a `RunAbortedError` as soon as `signal` aborts. */
+const unlessAborted = (signal, work) => {
+    if (!signal)
+        return work;
+    if (signal.aborted)
+        return Promise.reject(new RunAbortedError());
+    return (0, rxjs_1.firstValueFrom)((0, rxjs_1.race)((0, rxjs_1.from)(work), (0, rxjs_1.fromEvent)(signal, 'abort').pipe((0, rxjs_1.switchMap)(() => (0, rxjs_1.throwError)(() => new RunAbortedError())))));
+};
+exports.unlessAborted = unlessAborted;
+//# sourceMappingURL=run-abort.js.map