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

package/src/lib/design/render.js

@@ -20,15 +20,20 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.forceMiddleware = exports.renderMiddleware = exports.createRenderer = exports.isStale = exports.FORCE_PATH = exports.RENDER_PATH = void 0;
+exports.forceMiddleware = exports.renderMiddleware = exports.createRenderer = exports.RENDER_TIMEOUT_MS = exports.isStale = exports.QUIET_HEADER = exports.SERVED_LINES_HEADER = exports.FORCE_PATH = exports.RENDER_PATH = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 const worker_threads_1 = require("worker_threads");
 const force_interactions_1 = require("./force-interactions");
-const paths_1 = require("./paths");
+const package_root_1 = require("./package-root");
+const wait_1 = require("./wait");
 const render_packages_1 = require("./render-packages");
 exports.RENDER_PATH = '/__design/render';
 exports.FORCE_PATH = '/__design/force';
+/** The header a render answer carries the worker's logged lines in, as an encoded JSON string array. */
+exports.SERVED_LINES_HEADER = 'x-et-lines';
+/** A render asked with this header does not print what the worker logged. */
+exports.QUIET_HEADER = 'x-et-quiet';
 const mtimeOf = (path) => {
     try {
         return (0, fs_1.statSync)(path).mtimeMs;
@@ -44,8 +49,9 @@ exports.isStale = isStale;
  * Renders Angular templates in a worker that loads the target checkout's own packages. The worker
  * is replaced on the first request after a package it loaded was rebuilt.
  */
+exports.RENDER_TIMEOUT_MS = 120000;
 const createRenderer = (options) => {
-    const { target, config } = options;
+    const { target, config, timeout = exports.RENDER_TIMEOUT_MS } = options;
     const workerDataOf = () => {
         var _a, _b;
         return ({
@@ -56,6 +62,7 @@ const createRenderer = (options) => {
     };
     let startedWith = '';
     const pending = new Map();
+    const sentTo = new Map();
     let worker = null;
     let watched = {};
     let nextId = 0;
@@ -63,28 +70,36 @@ const createRenderer = (options) => {
         for (const settle of pending.values())
             settle({ error });
         pending.clear();
+        sentTo.clear();
+    };
+    const answer = (id, result) => {
+        var _a;
+        (_a = pending.get(id)) === null || _a === void 0 ? void 0 : _a(result);
+        pending.delete(id);
+        sentTo.delete(id);
     };
     const start = () => {
         const workerData = workerDataOf();
         startedWith = JSON.stringify(workerData);
-        const started = new worker_threads_1.Worker((0, paths_1.packageFileOf)((0, path_1.resolve)(__dirname, 'render-worker.js')), { workerData });
+        const started = new worker_threads_1.Worker((0, package_root_1.packageFileOf)((0, path_1.resolve)(__dirname, 'render-worker.js')), { workerData });
         started.on('message', (response) => {
-            var _a;
-            const { id, watched: loaded } = response, result = __rest(response, ["id", "watched"]);
+            const { id, watched: loaded, lines } = response, result = __rest(response, ["id", "watched", "lines"]);
             if (started === worker)
                 watched = Object.assign({}, loaded);
-            (_a = pending.get(id)) === null || _a === void 0 ? void 0 : _a(result);
-            pending.delete(id);
+            answer(id, Object.assign(Object.assign({}, result), { lines }));
         });
         started.on('error', (error) => settleAll(`design-explore: the render worker failed: ${error instanceof Error ? error.message : String(error)}`));
         started.on('exit', () => {
             if (started === worker)
                 worker = null;
+            for (const [id, to] of sentTo)
+                if (to === started)
+                    answer(id, { error: 'design-explore: the render worker exited before it answered' });
         });
         watched = {};
         return started;
     };
-    const render = (ask) => {
+    const render = (ask, options = {}) => {
         var _a, _b, _c, _d, _e, _f;
         if (worker && ((0, exports.isStale)(watched) || startedWith !== JSON.stringify(workerDataOf()))) {
             void worker.terminate();
@@ -102,8 +117,30 @@ const createRenderer = (options) => {
             providers: providers ? (0, path_1.resolve)(target, providers) : null,
         };
         const result = new Promise((settle) => pending.set(request.id, settle));
-        worker.postMessage(request);
-        return result;
+        const sent = worker;
+        sentTo.set(request.id, sent);
+        sent.postMessage(request);
+        return (0, wait_1.withinLimit)(result, {
+            ms: timeout,
+            what: `the render worker to draw ${ask.call}`,
+            announceAfterMs: 10000,
+        })
+            .then((rendered) => {
+            var _a;
+            if (!options.quiet)
+                for (const line of (_a = rendered.lines) !== null && _a !== void 0 ? _a : [])
+                    console.warn(line);
+            return rendered;
+        })
+            .catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            answer(request.id, { error: message });
+            if (sent === worker) {
+                worker = null;
+                void sent.terminate();
+            }
+            return { error: message };
+        });
     };
     const close = () => __awaiter(void 0, void 0, void 0, function* () {
         const stopped = worker;
@@ -131,9 +168,11 @@ const renderMiddleware = (render) => (request, response) => {
         return;
     }
     void readBody(request)
-        .then((body) => render(JSON.parse(body)))
+        .then((body) => render(JSON.parse(body), { quiet: request.headers[exports.QUIET_HEADER] === '1' }))
         .catch((error) => ({ error: error instanceof Error ? error.message : String(error) }))
-        .then((result) => {
+        .then((_a) => {
+        var { lines } = _a, result = __rest(_a, ["lines"]);
+        response.setHeader(exports.SERVED_LINES_HEADER, encodeURIComponent(JSON.stringify(lines !== null && lines !== void 0 ? lines : [])));
         if ('error' in result) {
             response.statusCode = 500;
             response.setHeader('content-type', 'text/plain; charset=utf-8');

package/src/lib/design/render.js.map

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

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

@@ -0,0 +1,52 @@
+import { IsAlive, Discovery } from './discovery';
+import { ResidentRequest } from './server';
+/** `ETHLETE_DESIGN_RESIDENT=0` keeps every design call in its own process, as `CI` does. */
+export declare const RESIDENT_ENV = "ETHLETE_DESIGN_RESIDENT";
+/** The hidden `et design` subcommand that runs the resident process. */
+export declare const RESIDENT_SERVE = "__resident";
+export type ResidentClient = {
+    build: string;
+    env: NodeJS.ProcessEnv;
+    alive: IsAlive;
+    kill: (pid: number, signal: NodeJS.Signals) => void;
+    start: (target: string) => void;
+    out: (text: string) => void;
+    err: (text: string) => void;
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+    startTimeoutMs: number;
+    pingTimeoutMs: number;
+    stopGraceMs: number;
+    silenceMs: number;
+};
+export declare const residentLogOf: (target: string) => string;
+export declare const realResidentClient: (build: string) => ResidentClient;
+/**
+ * Whether `et design <argv>` runs in the resident design process: compare, check of a product or part (not its
+ * source-only modes), sketch check and sketch ready.
+ */
+export declare const runsInResident: (argv: string[]) => boolean;
+export declare const residentWanted: (env: NodeJS.ProcessEnv) => boolean;
+/**
+ * The live resident process of the checkout, started detached when there is none or the one there runs another CLI
+ * build; a reason string when it cannot be reached and the call must run in its own process.
+ */
+export declare const ensureResident: (target: string, client: ResidentClient) => Promise<Discovery | string>;
+/** Sends one run request and writes its output as it arrives; null when the process ends or falls silent first. */
+export declare const sendRun: ({ found, asked, client, }: {
+    found: Discovery;
+    asked: ResidentRequest;
+    client: ResidentClient;
+}) => Promise<number | null>;
+/**
+ * Runs `et design <argv>` in the resident process of the checkout and answers its exit code, or null after one printed
+ * line when the call must run in its own process: in CI, with `ETHLETE_DESIGN_RESIDENT=0`, or when the process fails.
+ */
+export declare const runThroughResident: (options: {
+    target: string;
+    argv: string[];
+    invocation: string;
+    client: ResidentClient;
+}) => Promise<number | null>;
+/** `et design stop`: ends the resident process of the checkout. */
+export declare const stopResident: (target: string, client: ResidentClient) => Promise<number>;

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

@@ -0,0 +1,263 @@
+"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.stopResident = exports.runThroughResident = exports.sendRun = exports.ensureResident = exports.residentWanted = exports.runsInResident = exports.realResidentClient = exports.residentLogOf = exports.RESIDENT_SERVE = exports.RESIDENT_ENV = void 0;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const http_1 = require("http");
+const path_1 = require("path");
+const promises_1 = require("timers/promises");
+const lock_1 = require("../../api/lock");
+const lib_build_lock_1 = require("../system/lib-build-lock");
+const discovery_1 = require("./discovery");
+const server_1 = require("./server");
+/** `ETHLETE_DESIGN_RESIDENT=0` keeps every design call in its own process, as `CI` does. */
+exports.RESIDENT_ENV = 'ETHLETE_DESIGN_RESIDENT';
+/** The hidden `et design` subcommand that runs the resident process. */
+exports.RESIDENT_SERVE = '__resident';
+const DEFAULT_COLD_START_S = 20;
+const residentLogOf = (target) => (0, path_1.join)((0, discovery_1.residentDirOf)(target), 'resident.log');
+exports.residentLogOf = residentLogOf;
+const startDetached = (target) => {
+    var _a;
+    (0, fs_1.mkdirSync)((0, discovery_1.residentDirOf)(target), { recursive: true });
+    const log = (0, fs_1.openSync)((0, exports.residentLogOf)(target), 'w');
+    const env = Object.assign({}, process.env);
+    delete env[lib_build_lock_1.LIB_READER_ENV];
+    server_1.FORWARDED_ENV.forEach((key) => delete env[key]);
+    (0, child_process_1.spawn)(process.execPath, [(_a = process.argv[1]) !== null && _a !== void 0 ? _a : '', 'design', exports.RESIDENT_SERVE, '--checkout', target], {
+        cwd: target,
+        detached: true,
+        stdio: ['ignore', log, log],
+        env,
+    }).unref();
+};
+const realResidentClient = (build) => ({
+    build,
+    env: process.env,
+    alive: discovery_1.isAlive,
+    kill: (pid, signal) => {
+        try {
+            process.kill(pid, signal);
+        }
+        catch (_a) {
+            return;
+        }
+    },
+    start: startDetached,
+    out: (text) => void process.stdout.write(text),
+    err: (text) => void process.stderr.write(text),
+    now: () => Date.now(),
+    sleep: (ms) => __awaiter(void 0, void 0, void 0, function* () { return void (yield (0, promises_1.setTimeout)(ms)); }),
+    startTimeoutMs: 120000,
+    pingTimeoutMs: 5000,
+    stopGraceMs: 5000,
+    silenceMs: 60000,
+});
+exports.realResidentClient = realResidentClient;
+const RESIDENT_SKETCH_COMMANDS = new Set(['check', 'ready']);
+const CHECK_SCOPES = ['--product', '--part'];
+const CHECK_ELSEWHERE = [
+    '--app-classes',
+    '--rules',
+    '--live',
+    '--visible-change',
+    '--slow',
+    '--receipt',
+    '--call',
+    '--lint',
+    '--tsconfig',
+    '--variant',
+];
+const drawsSystem = (argv) => argv.some((argument) => CHECK_SCOPES.includes(argument)) &&
+    !argv.some((argument) => CHECK_ELSEWHERE.includes(argument));
+/**
+ * Whether `et design <argv>` runs in the resident design process: compare, check of a product or part (not its
+ * source-only modes), sketch check and sketch ready.
+ */
+const runsInResident = (argv) => {
+    var _a;
+    return argv[0] === 'compare' ||
+        (argv[0] === 'check' && drawsSystem(argv.slice(1))) ||
+        (argv[0] === 'sketch' && RESIDENT_SKETCH_COMMANDS.has((_a = argv[1]) !== null && _a !== void 0 ? _a : ''));
+};
+exports.runsInResident = runsInResident;
+const residentWanted = (env) => !env['CI'] && env[exports.RESIDENT_ENV] !== '0';
+exports.residentWanted = residentWanted;
+const call = (options) => new Promise((done) => {
+    const { found, method, path, timeoutMs } = options;
+    const asked = (0, http_1.request)({ host: '127.0.0.1', port: found.port, method, path, headers: { [server_1.TOKEN_HEADER]: found.token } }, (response) => {
+        let body = '';
+        response.setEncoding('utf8');
+        response.on('data', (chunk) => (body += chunk));
+        response.once('end', () => done(response.statusCode === 200 ? body : null));
+        response.once('error', () => done(null));
+    });
+    asked.setTimeout(timeoutMs, () => asked.destroy());
+    asked.once('error', () => done(null));
+    asked.end();
+});
+const answers = (found, client) => __awaiter(void 0, void 0, void 0, function* () {
+    const body = yield call({ found, method: 'GET', path: '/ping', timeoutMs: client.pingTimeoutMs });
+    try {
+        return body !== null && JSON.parse(body).pid === found.pid;
+    }
+    catch (_a) {
+        return false;
+    }
+});
+const fits = ({ found, target, client }) => found.checkout === (0, path_1.resolve)(target) && found.build === client.build;
+const stopProcess = (_a) => __awaiter(void 0, [_a], void 0, function* ({ found, target, client }) {
+    yield call({ found, method: 'POST', path: '/stop', timeoutMs: client.pingTimeoutMs });
+    const until = client.now() + client.stopGraceMs;
+    while (client.alive(found.pid) && client.now() < until)
+        yield client.sleep(100);
+    if (client.alive(found.pid))
+        client.kill(found.pid, 'SIGKILL');
+    (0, discovery_1.removeDiscovery)(target, found.pid);
+});
+const coldStartFileOf = (target) => (0, path_1.join)((0, discovery_1.residentDirOf)(target), 'cold-start.json');
+const coldStartOf = (target) => {
+    try {
+        const { seconds } = JSON.parse((0, fs_1.readFileSync)(coldStartFileOf(target), 'utf8'));
+        return typeof seconds === 'number' ? seconds : DEFAULT_COLD_START_S;
+    }
+    catch (_a) {
+        return DEFAULT_COLD_START_S;
+    }
+};
+const startResident = (target, client) => __awaiter(void 0, void 0, void 0, function* () {
+    client.err(`starting the resident design process (cold start, ~${coldStartOf(target)} s)\n`);
+    const began = client.now();
+    client.start(target);
+    while (client.now() - began < client.startTimeoutMs) {
+        yield client.sleep(200);
+        const started = (0, discovery_1.liveDiscoveryOf)({ target, alive: client.alive });
+        if (started && fits({ found: started, target, client }) && (yield answers(started, client))) {
+            (0, fs_1.writeFileSync)(coldStartFileOf(target), JSON.stringify({ seconds: Math.ceil((client.now() - began) / 1000) }));
+            return started;
+        }
+    }
+    return `the resident design process did not start within ${Math.round(client.startTimeoutMs / 1000)} s (log: ${(0, exports.residentLogOf)(target)})`;
+});
+/**
+ * The live resident process of the checkout, started detached when there is none or the one there runs another CLI
+ * build; a reason string when it cannot be reached and the call must run in its own process.
+ */
+const ensureResident = (target, client) => __awaiter(void 0, void 0, void 0, function* () {
+    const first = (0, discovery_1.liveDiscoveryOf)({ target, alive: client.alive });
+    if (first && fits({ found: first, target, client }) && (yield answers(first, client)))
+        return first;
+    const directory = (0, path_1.join)((0, discovery_1.residentDirOf)(target), 'start');
+    const lock = yield (0, lock_1.acquireApiLock)({
+        directory,
+        command: 'design resident start',
+        wait: client.startTimeoutMs / 1000,
+        cwd: target,
+        onHeld: () => client.err('waiting for the resident design process to start\n'),
+    });
+    if (!lock.ok)
+        return 'the start lock of the resident design process stayed taken';
+    try {
+        const found = (0, discovery_1.liveDiscoveryOf)({ target, alive: client.alive });
+        if (found && found.checkout === (0, path_1.resolve)(target)) {
+            if (fits({ found, target, client })) {
+                if (yield answers(found, client))
+                    return found;
+                yield stopProcess({ found, target, client });
+                return `the resident design process (pid ${found.pid}) did not answer and was stopped`;
+            }
+            yield stopProcess({ found, target, client });
+        }
+        (0, discovery_1.removeDiscovery)(target);
+        return yield startResident(target, client);
+    }
+    finally {
+        (0, lock_1.releaseApiLock)(directory, lock.lock.token);
+    }
+});
+exports.ensureResident = ensureResident;
+/** Sends one run request and writes its output as it arrives; null when the process ends or falls silent first. */
+const sendRun = ({ found, asked, client, }) => new Promise((done) => {
+    let exit = null;
+    const request = (0, http_1.request)({
+        host: '127.0.0.1',
+        port: found.port,
+        method: 'POST',
+        path: '/run',
+        headers: { [server_1.TOKEN_HEADER]: found.token, 'content-type': 'application/json' },
+    }, (response) => {
+        if (response.statusCode !== 200) {
+            response.resume();
+            done(null);
+            return;
+        }
+        let buffer = '';
+        response.setEncoding('utf8');
+        response.on('data', (chunk) => {
+            var _a;
+            buffer += chunk;
+            const lines = buffer.split('\n');
+            buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : '';
+            for (const line of lines) {
+                if (!line)
+                    continue;
+                const frame = JSON.parse(line);
+                if ('o' in frame)
+                    client.out(frame.o);
+                else if ('e' in frame)
+                    client.err(frame.e);
+                else if ('exit' in frame)
+                    exit = frame.exit;
+            }
+        });
+        response.once('end', () => done(exit));
+        response.once('close', () => done(exit));
+        response.once('error', () => done(null));
+    });
+    request.setTimeout(client.silenceMs, () => request.destroy());
+    request.once('error', () => done(exit));
+    request.end(JSON.stringify(asked));
+});
+exports.sendRun = sendRun;
+/**
+ * Runs `et design <argv>` in the resident process of the checkout and answers its exit code, or null after one printed
+ * line when the call must run in its own process: in CI, with `ETHLETE_DESIGN_RESIDENT=0`, or when the process fails.
+ */
+const runThroughResident = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    const { target, argv, invocation, client } = options;
+    if (!(0, exports.residentWanted)(client.env))
+        return null;
+    const found = yield (0, exports.ensureResident)(target, client);
+    if (typeof found === 'string') {
+        client.err(`${found} - running in-process\n`);
+        return null;
+    }
+    const env = Object.fromEntries(server_1.FORWARDED_ENV.flatMap((key) => (client.env[key] ? [[key, client.env[key]]] : [])));
+    const code = yield (0, exports.sendRun)({ found, asked: { argv, invocation, env }, client });
+    if (code === null)
+        client.err(`the resident design process (pid ${found.pid}) ended without an answer - running in-process\n`);
+    return code;
+});
+exports.runThroughResident = runThroughResident;
+/** `et design stop`: ends the resident process of the checkout. */
+const stopResident = (target, client) => __awaiter(void 0, void 0, void 0, function* () {
+    const found = (0, discovery_1.liveDiscoveryOf)({ target, alive: client.alive });
+    if (!found) {
+        client.out('no resident design process runs\n');
+        return 0;
+    }
+    yield stopProcess({ found, target, client });
+    client.out(`stopped the resident design process (pid ${found.pid})\n`);
+    return 0;
+});
+exports.stopResident = stopResident;
+//# sourceMappingURL=client.js.map

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

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

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>;