@bitmagic/cli 0.1.60-dev.3 → 0.1.60-dev.5

package/dist/editor/shell-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+gEtD,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AACF,CAAC"}
+{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,OAAO,EACL,qBAAqB,EAAE,kBAAkB,GAC1C,MAAM,qDAAqD,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE7F,oGAAoG;AACpG,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,SAAS,sBAAsB;IAC7B,OAAO;QACL,6BAA6B,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,GAAG;QACjE,iCAAiC,qBAAqB,CAAC,QAAQ,EAAE,GAAG;QACpE,8BAA8B,kBAAkB,CAAC,QAAQ,EAAE,GAAG;KAC/D,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC,kGAAkG;AAClG,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3B,CAAC;AA2BD,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,MAAM,OAAO,GAAG,oBAAoB,OAAO,CAAC,QAAQ,2BAA2B,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACpH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC;IAC1C,MAAM,SAAS,GAAG,OAAO;QACvB,CAAC,CAAC,YAAY,OAAO,CAAC,UAAU,uDAAuD;QACvF,CAAC,CAAC,YAAY,OAAO,CAAC,UAAU,qCAAqC,CAAC;IACxE,MAAM,KAAK,GAAG,GAAG,OAAO,CAAC,QAAQ,kBAAkB,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACnF,OAAO;;;;SAIA,UAAU,CAAC,KAAK,CAAC;EACxB,kBAAkB;;EAElB,mBAAmB;EACnB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkIrB,gBAAgB;EAChB,iBAAiB;EACjB,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE;EACpC,gBAAgB;EAChB,eAAe;;;;;;yCAMwB,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,YAAY,UAAU,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oFAC/D,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;2DACrD,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;kFACH,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;EAmB/G,SAAS,CAAC,CAAC,CAAC,4FAA4F,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;EAwB7G,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;EAyBhB,kBAAkB;EAClB,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE;EACrC,iBAAiB;EACjB,iBAAiB;;;;mBAIA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;kBACxB,gBAAgB;yBACT,qBAAqB;2BACnB,gBAAgB;;IAEvC,sBAAsB,EAAE;;;;;;;;4BAQA,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyjEtD,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqChB,CAAC;AACF,CAAC"}

package/dist/editor/tab-reuse.d.ts

@@ -0,0 +1,23 @@
+/** Comfortably past Firefox's 5 s reconnect, short enough that a closed tab costs one breath. */
+export declare const TAB_REUSE_WINDOW_MS = 7000;
+export interface DevViewRecord {
+    /** Epoch ms when a tab last attached to a `dev` on this port. */
+    watcherSeenAt: number;
+    editorPort: number;
+}
+export declare function devViewRecordPath(root: string): string;
+export declare function readDevViewRecord(root: string): DevViewRecord | null;
+export declare function writeDevViewRecord(root: string, record: DevViewRecord): void;
+export interface TabDecisionInput {
+    /** A tab attached to a previous `dev` on this very port — worth waiting for.  */
+    evidence: boolean;
+    /** Epoch ms when the sidecar began listening; the wait is measured from here, not from now. */
+    listeningAt: number;
+    hasWatcher: () => boolean;
+}
+export interface TabDecisionDeps {
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+/** True when a tab should be opened; false when one is already watching this server. */
+export declare function shouldOpenTab(input: TabDecisionInput, deps?: TabDecisionDeps): Promise<boolean>;

package/dist/editor/tab-reuse.js

@@ -0,0 +1,61 @@
+/**
+ * Whether `bitmagic dev` should open a browser tab, or whether one is already there.
+ *
+ * `dev` opens its page itself (open-browser.ts), and it is restarted often — agents start it per
+ * session, a background task gets killed, a creator Ctrl-C's it to add `--mobile`. Every restart
+ * used to open another tab while the previous one was still there: that tab polls `/api/state`
+ * every half second and holds an `EventSource` that reconnects on its own, so it comes back to the
+ * new server by itself — and then there were two. After a few prompts, ten.
+ *
+ * The signal is the SSE reconnect, not the poll. A background tab's `setTimeout` chain is throttled
+ * by Chrome to once a second, and to once a MINUTE after five minutes hidden; `EventSource`
+ * reconnects on a browser network timer — about 3 s in Chromium, 5 s in Firefox — that is not.
+ *
+ * The wait is paid only when there is EVIDENCE a tab existed: the previous server wrote
+ * `.bitmagic/dev-view.json` the first time a tab attached. A fresh project opens instantly. A
+ * restart waits until a tab reconnects, or until `TAB_REUSE_WINDOW_MS` have passed since the
+ * sidecar started listening — and the sidecar listens from before the build, so in practice the
+ * build has already spent that window and the decision is immediate either way.
+ */
+import * as path from 'path';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+/** Comfortably past Firefox's 5 s reconnect, short enough that a closed tab costs one breath. */
+export const TAB_REUSE_WINDOW_MS = 7_000;
+const POLL_MS = 100;
+export function devViewRecordPath(root) {
+    return path.join(root, '.bitmagic', 'dev-view.json');
+}
+export function readDevViewRecord(root) {
+    const parsed = readJsonFile(devViewRecordPath(root));
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    if (typeof record.watcherSeenAt !== 'number' || typeof record.editorPort !== 'number')
+        return null;
+    return { watcherSeenAt: record.watcherSeenAt, editorPort: record.editorPort };
+}
+export function writeDevViewRecord(root, record) {
+    try {
+        writeJsonAtomic(devViewRecordPath(root), record);
+    }
+    catch {
+        // A record we cannot write costs one extra tab on the next restart, nothing else.
+    }
+}
+/** True when a tab should be opened; false when one is already watching this server. */
+export async function shouldOpenTab(input, deps = {}) {
+    const now = deps.now ?? Date.now;
+    const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    if (input.hasWatcher())
+        return false;
+    if (!input.evidence)
+        return true;
+    const deadline = input.listeningAt + TAB_REUSE_WINDOW_MS;
+    while (now() < deadline) {
+        await sleep(POLL_MS);
+        if (input.hasWatcher())
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=tab-reuse.js.map

package/dist/editor/tab-reuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-reuse.js","sourceRoot":"","sources":["../../src/editor/tab-reuse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE,iGAAiG;AACjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,OAAO,GAAG,GAAG,CAAC;AAQpB,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnG,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAqB;IACpE,IAAI,CAAC;QACH,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,kFAAkF;IACpF,CAAC;AACH,CAAC;AAeD,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAuB,EAAE,OAAwB,EAAE;IACrF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACtG,IAAI,KAAK,CAAC,UAAU,EAAE;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,GAAG,mBAAmB,CAAC;IACzD,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,UAAU,EAAE;YAAE,OAAO,KAAK,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/local-port.d.ts

@@ -82,8 +82,15 @@ export declare function laneExhaustedMessage(lane: PortLane, remedy: string): st
  * and `forge` alike need a port inside the CDN's CORS window (see the file header) and have
  * nothing useful to do with a `null`. Bundling the lane lookup, the scan and the refusal here
  * keeps the three from drifting apart — a caller varies only what it tells the creator to do.
+ *
+ * Every port a project on this machine has been promised (project/dev-ports.ts) is skipped as
+ * well, whether or not that project's `dev` is up right now. A verify sitting on 3021 while
+ * project B's dev happened to be down would push B's next `dev` into a drift, which is exactly the
+ * instability the registry ends. At most 27 of the lane's hundred ports, so the scan loses nothing.
  */
-export declare function reserveLanePort(remedy: string, exclude?: ReadonlySet<number>): Promise<number>;
+export declare function reserveLanePort(remedy: string, exclude?: ReadonlySet<number>, deps?: {
+    registryDir?: string;
+}): Promise<number>;
 /**
  * The port to actually bind: `preferred` when it is free, otherwise another one in the window.
  *

package/dist/local-port.js

@@ -1,6 +1,7 @@
 import * as net from 'net';
 import { CliError } from './errors.js';
 import { currentPortLane } from './port-lane.js';
+import { registeredSlotPorts } from './project/dev-ports.js';
 /**
  * The port window the platform's bucket CORS policy allowlists as an origin.
  *
@@ -131,10 +132,16 @@ export function laneExhaustedMessage(lane, remedy) {
  * and `forge` alike need a port inside the CDN's CORS window (see the file header) and have
  * nothing useful to do with a `null`. Bundling the lane lookup, the scan and the refusal here
  * keeps the three from drifting apart — a caller varies only what it tells the creator to do.
+ *
+ * Every port a project on this machine has been promised (project/dev-ports.ts) is skipped as
+ * well, whether or not that project's `dev` is up right now. A verify sitting on 3021 while
+ * project B's dev happened to be down would push B's next `dev` into a drift, which is exactly the
+ * instability the registry ends. At most 27 of the lane's hundred ports, so the scan loses nothing.
  */
-export async function reserveLanePort(remedy, exclude = new Set()) {
+export async function reserveLanePort(remedy, exclude = new Set(), deps = {}) {
     const lane = currentPortLane();
-    const port = await reservePortInLane(lane, exclude);
+    const promised = registeredSlotPorts(lane, { baseDir: deps.registryDir });
+    const port = await reservePortInLane(lane, new Set([...exclude, ...promised]));
     if (port === null)
         throw new CliError(laneExhaustedMessage(lane, remedy));
     return port;

package/dist/local-port.js.map

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

package/dist/machine-lock.d.ts

@@ -0,0 +1,56 @@
+export interface LockHolder {
+    pid: number;
+    /** Epoch ms when the holder took the lock. */
+    startedAt: number;
+    /** The project the holder was working on, for the waiting line. */
+    root: string;
+    /** The command that took it — `verify`, `dev` — for the same line. */
+    command: string;
+}
+export interface MachineLockDeps {
+    baseDir?: string;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+    isAlive?: (pid: number) => boolean;
+    /** Epoch ms of this machine's boot, below which a holder cannot be alive. */
+    bootTime?: () => number;
+    pid?: number;
+    pollMs?: number;
+    timeoutMs?: number;
+    maxAgeMs?: number;
+    /** Called once, the first time the lock turns out to be held by someone else. */
+    onWait?: (holder: LockHolder) => void;
+    /** Called when a lock is reclaimed for being too old — the one stale case worth a warning. */
+    onStale?: (holder: LockHolder) => void;
+}
+export interface MachineLock {
+    /** Whether acquiring involved waiting for another holder at all. */
+    readonly waited: boolean;
+    /** Give it back. Idempotent; never removes a lock someone else has since taken. */
+    release(): void;
+}
+/** A poll, not a watch: cheap, portable, and a released lock is noticed within this. */
+export declare const LOCK_POLL_MS = 500;
+/** How long a waiter queues before giving up with the holder's name. */
+export declare const LOCK_TIMEOUT_MS: number;
+/** No holder legitimately keeps a lock this long; beyond it the record is treated as abandoned. */
+export declare const LOCK_MAX_AGE_MS: number;
+export declare function lockPath(name: string, baseDir?: string): string;
+/** The recorded holder, or null for a file that is missing, empty or garbage. */
+export declare function readLockHolder(file: string): LockHolder | null;
+/** Whether the holder is one no longer worth waiting for, and why. */
+export declare function staleReason(holder: LockHolder, deps: {
+    now: number;
+    isAlive: (pid: number) => boolean;
+    bootTime: number;
+    maxAgeMs: number;
+}): 'dead' | 'pre-boot' | 'too-old' | null;
+export declare function acquireMachineLock(name: string, info: {
+    root: string;
+    command: string;
+}, deps?: MachineLockDeps): Promise<MachineLock>;
+/** Hold `name` for the duration of `fn`, releasing however it ends. */
+export declare function withMachineLock<T>(name: string, info: {
+    root: string;
+    command: string;
+}, fn: (lock: MachineLock) => Promise<T>, deps?: MachineLockDeps): Promise<T>;

package/dist/machine-lock.js

@@ -0,0 +1,213 @@
+/**
+ * A lock shared by every `bitmagic` process on this machine — the one piece of cross-process
+ * coordination the CLI has.
+ *
+ * Two things need it. `bitmagic verify` measures the game's frame rate in a real browser, and two
+ * verifies at once on one laptop starve each other into a verdict about the machine rather than
+ * about the game; so verify runs one at a time, and the others wait (verify/lock.ts). The
+ * per-project port registry (project/dev-ports.ts) is a read-modify-write of one file that two
+ * `bitmagic dev`s starting in two folders at the same second must not both perform.
+ *
+ * It lives in `~/.bitmagic/locks/<name>.lock`, the directory both published lines already share
+ * for credentials, so a dev-line and a release-line install queue behind each other too — the fps
+ * problem is about the machine, not about which build is measuring.
+ *
+ * ── Why a file, and why this shape ────────────────────────────────────────────────────────────
+ *
+ * No dependency, because this package deliberately keeps `dev` and `verify` offline and light, and
+ * the primitives are enough: `open(..., 'wx')` is atomic on every platform Node runs on (it is
+ * CREATE_NEW on Windows), so the file's EXISTENCE is the lock. The descriptor is closed the moment
+ * the body is written — Windows will not unlink a file another process holds open, and a lock that
+ * cannot be reclaimed after its owner dies is worse than no lock.
+ *
+ * The body names the holder, for two reasons: so a waiter can say WHO it is waiting for (a line
+ * that turns "verify hangs" into "verify is queued behind the other project"), and so a stale lock
+ * can be told from a live one. Stale means the pid is gone, or the record predates this boot (pids
+ * are reused after a restart), or it is simply too old — no verify holds it for half an hour.
+ *
+ * Reclaiming a stale lock is a rename, then an unlink of the renamed file. Two waiters that both
+ * decide "stale" would otherwise race: one unlinks, the other creates a fresh lock, and the first
+ * unlinks THAT. Rename is atomic, so exactly one of them moves the file aside; the other gets
+ * ENOENT and simply tries `wx` again.
+ *
+ * A holder interrupted with Ctrl-C leaves its file behind — Node's default SIGINT exit runs no
+ * `finally` — and that is fine: its pid is dead, so the next waiter reclaims it on the first poll.
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { CliError } from './errors.js';
+import { defaultBaseDir } from './config/credentials.js';
+import { isProcessAlive } from './process-alive.js';
+import { readJsonFile } from './atomic-json.js';
+/** A poll, not a watch: cheap, portable, and a released lock is noticed within this. */
+export const LOCK_POLL_MS = 500;
+/** How long a waiter queues before giving up with the holder's name. */
+export const LOCK_TIMEOUT_MS = 15 * 60 * 1000;
+/** No holder legitimately keeps a lock this long; beyond it the record is treated as abandoned. */
+export const LOCK_MAX_AGE_MS = 30 * 60 * 1000;
+/**
+ * Slack on the boot-time rule. `os.uptime()` may or may not count time spent suspended, so a lock
+ * taken just before a laptop lid closed could otherwise read as "from before this boot".
+ */
+const BOOT_TOLERANCE_MS = 60 * 1000;
+export function lockPath(name, baseDir = defaultBaseDir()) {
+    return path.join(baseDir, 'locks', `${name}.lock`);
+}
+function defaultBootTime() {
+    return Date.now() - os.uptime() * 1000;
+}
+function isHolder(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return typeof v.pid === 'number' && typeof v.startedAt === 'number'
+        && typeof v.root === 'string' && typeof v.command === 'string';
+}
+/** The recorded holder, or null for a file that is missing, empty or garbage. */
+export function readLockHolder(file) {
+    const parsed = readJsonFile(file);
+    return isHolder(parsed) ? parsed : null;
+}
+/** Whether the holder is one no longer worth waiting for, and why. */
+export function staleReason(holder, deps) {
+    if (!deps.isAlive(holder.pid))
+        return 'dead';
+    if (holder.startedAt < deps.bootTime - BOOT_TOLERANCE_MS)
+        return 'pre-boot';
+    if (deps.now - holder.startedAt > deps.maxAgeMs)
+        return 'too-old';
+    return null;
+}
+/** Move a stale lock aside and delete it. False when another waiter got there first. */
+function reclaim(file, pid, now) {
+    const aside = `${file}.stale.${pid}.${now}`;
+    try {
+        fs.renameSync(file, aside);
+    }
+    catch {
+        return false;
+    }
+    fs.rmSync(aside, { force: true });
+    return true;
+}
+/** Try once to create the lock. True when this process now holds it. */
+function tryCreate(file, holder) {
+    let fd;
+    try {
+        fd = fs.openSync(file, 'wx');
+    }
+    catch (error) {
+        if (error.code === 'EEXIST')
+            return false;
+        throw error;
+    }
+    try {
+        fs.writeSync(fd, `${JSON.stringify(holder)}\n`);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return true;
+}
+/**
+ * How long an unreadable lock file is given to become readable.
+ *
+ * Between `open('wx')` and the write that follows it, the file exists and is empty; a waiter
+ * polling at that instant must not mistake a lock being taken for a corrupt one and delete it.
+ * Beyond this, an empty file is a crashed writer's, and is reclaimed.
+ */
+const UNREADABLE_GRACE_MS = 5_000;
+function fileAgeMs(file, now) {
+    try {
+        return now - fs.statSync(file).mtimeMs;
+    }
+    catch {
+        return null;
+    }
+}
+export async function acquireMachineLock(name, info, deps = {}) {
+    const now = deps.now ?? Date.now;
+    const sleep = deps.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    const isAlive = deps.isAlive ?? isProcessAlive;
+    const bootTime = deps.bootTime ?? defaultBootTime;
+    const pid = deps.pid ?? process.pid;
+    const pollMs = deps.pollMs ?? LOCK_POLL_MS;
+    const timeoutMs = deps.timeoutMs ?? LOCK_TIMEOUT_MS;
+    const maxAgeMs = deps.maxAgeMs ?? LOCK_MAX_AGE_MS;
+    const file = lockPath(name, deps.baseDir);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    const startedWaitingAt = now();
+    let waited = false;
+    let lastHolder = null;
+    for (;;) {
+        const holder = { pid, startedAt: now(), root: info.root, command: info.command };
+        if (tryCreate(file, holder)) {
+            return makeLock(file, pid, waited);
+        }
+        const current = readLockHolder(file);
+        if (current === null) {
+            // Empty or garbage. Being written right now, or left by a writer that died mid-write.
+            const age = fileAgeMs(file, now());
+            if (age === null)
+                continue; // gone between the failed create and the stat: try again.
+            if (age > UNREADABLE_GRACE_MS) {
+                reclaim(file, pid, now());
+                continue;
+            }
+        }
+        else {
+            const reason = staleReason(current, { now: now(), isAlive, bootTime: bootTime(), maxAgeMs });
+            if (reason !== null) {
+                if (reason === 'too-old')
+                    deps.onStale?.(current);
+                reclaim(file, pid, now());
+                continue;
+            }
+            if (!waited || lastHolder === null || lastHolder.pid !== current.pid) {
+                // Once per holder: a queue that moves — A finishes, B takes over — is worth a second line,
+                // a holder that is merely slow is not.
+                deps.onWait?.(current);
+            }
+            lastHolder = current;
+        }
+        waited = true;
+        if (now() - startedWaitingAt >= timeoutMs) {
+            const who = lastHolder === null
+                ? 'an unreadable lock file'
+                : `\`bitmagic ${lastHolder.command}\` (pid ${lastHolder.pid}) in ${lastHolder.root}`;
+            throw new CliError(`Gave up waiting for ${who} after ${Math.round(timeoutMs / 60_000)} minutes. `
+                + `If nothing is actually running, delete ${file} and try again.`);
+        }
+        await sleep(pollMs);
+    }
+}
+function makeLock(file, pid, waited) {
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        process.off('exit', release);
+        // Only ours. A lock this process lost to the staleness rules — a laptop asleep for an hour —
+        // may by now belong to someone else, and removing theirs would let a third run in beside them.
+        const current = readLockHolder(file);
+        if (current !== null && current.pid !== pid)
+            return;
+        fs.rmSync(file, { force: true });
+    };
+    // Best-effort on a normal exit; a signal death is covered by the dead-pid rule instead.
+    process.on('exit', release);
+    return { waited, release };
+}
+/** Hold `name` for the duration of `fn`, releasing however it ends. */
+export async function withMachineLock(name, info, fn, deps = {}) {
+    const lock = await acquireMachineLock(name, info, deps);
+    try {
+        return await fn(lock);
+    }
+    finally {
+        lock.release();
+    }
+}
+//# sourceMappingURL=machine-lock.js.map

package/dist/machine-lock.js.map

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

package/dist/port-lane.d.ts

@@ -45,6 +45,31 @@ export declare const RELEASE_LANE: PortLane;
 export declare const DEV_LANE: PortLane;
 /** The lane belonging to a published line. */
 export declare function portLaneFor(tag: UpdateTag): PortLane;
+/**
+ * How many projects a lane holds at fixed addresses — see `slotPorts`.
+ *
+ * Nine, because a slot is ten ports wide and the lane's defaults sit at x10: slots 0-8 span
+ * x10-x92, and a tenth would run past the lane's end. Nine games being developed at once on one
+ * machine is a lot; a tenth falls back to the scan, and says so.
+ */
+export declare const DEV_PORT_SLOTS = 9;
+/**
+ * The three ports a project in `slot` of `lane` serves on.
+ *
+ * `bitmagic dev` used to start every project at the lane's defaults and drift to a random port in
+ * the lane when they were busy — so which project answered on 3011 depended on start order,
+ * bookmarks went stale, and a `bitmagic reload` falling back to the default could reach the wrong
+ * project. A slot is the same numbers, one tens-digit further along per project: slot 0 is the
+ * defaults every doc names (3010/3011/3012), slot 1 is 3020/3021/3022, and so on. The hundreds
+ * digit still says which install, the tens digit now says which project, and the units digit still
+ * reads game / shell / phone. Which slot a project holds is recorded per machine in
+ * `~/.bitmagic/dev-ports.json` (project/dev-ports.ts).
+ */
+export declare function slotPorts(lane: PortLane, slot: number): {
+    gamePort: number;
+    editorPort: number;
+    mobilePort: number;
+};
 /**
  * This install's lane.
  *
@@ -57,3 +82,5 @@ export declare function portLaneFor(tag: UpdateTag): PortLane;
  * before this existed. Failing closed here keeps the numbers the docs promise.
  */
 export declare function currentPortLane(version?: string): PortLane;
+/** Which published line this install is on — the key the port registry files a project under. */
+export declare function currentLineTag(version?: string): UpdateTag;

package/dist/port-lane.js

@@ -49,6 +49,37 @@ export const DEV_LANE = {
 export function portLaneFor(tag) {
     return tag === 'dev' ? DEV_LANE : RELEASE_LANE;
 }
+/**
+ * How many projects a lane holds at fixed addresses — see `slotPorts`.
+ *
+ * Nine, because a slot is ten ports wide and the lane's defaults sit at x10: slots 0-8 span
+ * x10-x92, and a tenth would run past the lane's end. Nine games being developed at once on one
+ * machine is a lot; a tenth falls back to the scan, and says so.
+ */
+export const DEV_PORT_SLOTS = 9;
+/**
+ * The three ports a project in `slot` of `lane` serves on.
+ *
+ * `bitmagic dev` used to start every project at the lane's defaults and drift to a random port in
+ * the lane when they were busy — so which project answered on 3011 depended on start order,
+ * bookmarks went stale, and a `bitmagic reload` falling back to the default could reach the wrong
+ * project. A slot is the same numbers, one tens-digit further along per project: slot 0 is the
+ * defaults every doc names (3010/3011/3012), slot 1 is 3020/3021/3022, and so on. The hundreds
+ * digit still says which install, the tens digit now says which project, and the units digit still
+ * reads game / shell / phone. Which slot a project holds is recorded per machine in
+ * `~/.bitmagic/dev-ports.json` (project/dev-ports.ts).
+ */
+export function slotPorts(lane, slot) {
+    if (!Number.isInteger(slot) || slot < 0 || slot >= DEV_PORT_SLOTS) {
+        throw new RangeError(`dev port slot must be 0-${DEV_PORT_SLOTS - 1}, got ${slot}`);
+    }
+    const offset = 10 * slot;
+    return {
+        gamePort: lane.gamePort + offset,
+        editorPort: lane.editorPort + offset,
+        mobilePort: lane.mobilePort + offset,
+    };
+}
 /**
  * This install's lane.
  *
@@ -61,6 +92,10 @@ export function portLaneFor(tag) {
  * before this existed. Failing closed here keeps the numbers the docs promise.
  */
 export function currentPortLane(version = currentCliVersion()) {
-    return portLaneFor(updateTagFor(version));
+    return portLaneFor(currentLineTag(version));
+}
+/** Which published line this install is on — the key the port registry files a project under. */
+export function currentLineTag(version = currentCliVersion()) {
+    return updateTagFor(version);
 }
 //# sourceMappingURL=port-lane.js.map

package/dist/port-lane.js.map

@@ -1 +1 @@
-{"version":3,"file":"port-lane.js","sourceRoot":"","sources":["../src/port-lane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAc5D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,GAAc;IACxC,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;AACjD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,iBAAiB,EAAE;IACnE,OAAO,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"port-lane.js","sourceRoot":"","sources":["../src/port-lane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,YAAY,EAAkB,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAc5D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;CACjB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,GAAc;IACxC,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;AACjD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,IAAY;IACpD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,cAAc,EAAE,CAAC;QAClE,MAAM,IAAI,UAAU,CAAC,2BAA2B,cAAc,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC;IACzB,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAG,MAAM;QAChC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM;QACpC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,MAAM;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB,iBAAiB,EAAE;IACnE,OAAO,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,UAAkB,iBAAiB,EAAE;IAClE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/process-alive.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Is the process that wrote a record still running?
+ *
+ * Signal 0 performs the permission and existence checks without delivering anything. EPERM means
+ * the process exists but belongs to someone else — alive, as far as this question goes. Works on
+ * Windows too, where Node maps it onto an existence check.
+ *
+ * Its own module because three unrelated records ask it: `.bitmagic/dev.json` (project/dev-handle),
+ * `.bitmagic/jobs/` (project/jobs) and the machine-wide locks in `~/.bitmagic/locks/`
+ * (machine-lock). The lock cannot import dev-handle for it — dev-handle reads the port registry,
+ * which takes the lock, and that would be a cycle.
+ */
+export declare function isProcessAlive(pid: number): boolean;

package/dist/process-alive.js

@@ -0,0 +1,24 @@
+/**
+ * Is the process that wrote a record still running?
+ *
+ * Signal 0 performs the permission and existence checks without delivering anything. EPERM means
+ * the process exists but belongs to someone else — alive, as far as this question goes. Works on
+ * Windows too, where Node maps it onto an existence check.
+ *
+ * Its own module because three unrelated records ask it: `.bitmagic/dev.json` (project/dev-handle),
+ * `.bitmagic/jobs/` (project/jobs) and the machine-wide locks in `~/.bitmagic/locks/`
+ * (machine-lock). The lock cannot import dev-handle for it — dev-handle reads the port registry,
+ * which takes the lock, and that would be a cycle.
+ */
+export function isProcessAlive(pid) {
+    if (pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=process-alive.js.map

package/dist/process-alive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-alive.js","sourceRoot":"","sources":["../src/process-alive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,OAAO,CAAC;IACvD,CAAC;AACH,CAAC"}