@bitmagic/cli 0.1.60-dev.2 → 0.1.60-dev.4

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"}

package/dist/project/dev-handle.d.ts

@@ -14,49 +14,21 @@ export interface DevHandle {
      */
     mobileUrl?: string;
 }
-/**
- * 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. Shared with
- * `project/jobs.ts`, which asks it of a generation rather than of a server.
- */
-export declare function isProcessAlive(pid: number): boolean;
+export { isProcessAlive } from '../process-alive.js';
 /** A `bitmagic dev` currently serving this project, or null. */
 export declare function readLiveDevHandle(root: string): DevHandle | null;
 /**
  * The editor port, owned here rather than by any one command.
  *
- * `dev` binds it, `reload` falls back to it when there is no handle to read, and the probe below
- * uses it for the same reason. It was three separate literals; a fourth reader would have made
- * four. Whoever changes the default changes it once.
+ * `dev` names it in its help text and it is what slot 0 of the port registry resolves to
+ * (project/dev-ports.ts). Nothing falls back to it any more: a project that has never run `dev`
+ * has no port to probe, and probing the lane default reached whichever OTHER project happened to
+ * hold slot 0 — `reload` from project B reloading project A's tab.
  *
  * A function rather than a constant since the number depends on which release line is running
- * (port-lane.ts). That matters most for the two readers BELOW a missing handle: a dev-line `reload`
- * that fell back to a fixed 3011 would probe — and reload — a release-line `bitmagic dev`, serving
- * somebody else's project in another window.
+ * (port-lane.ts).
  */
 export declare function defaultEditorPort(): number;
-/**
- * Is a `bitmagic dev` serving this project — asked the way `reload` asks it?
- *
- * There were two answers to this question and they disagreed in the field: `reload` probes the
- * port (recorded, else the default), while the "nobody can see this happen" nudge only read
- * `.bitmagic/dev.json`. A server from a build predating that file therefore reloaded tabs on
- * request while every generation in the same minute announced that nothing was watching. That
- * particular cause fixes itself on restart; two detections drifting apart does not, so there is
- * now one.
- *
- * The handle is still the fast path, and deliberately: it answers without touching the network,
- * and a live pid holding it is not something a probe can contradict. The probe is what the file's
- * ABSENCE means — which is "no record", never "no server".
- *
- * `GET /api/state` is the probe because it is the cheapest read-only route the dev view serves.
- * Reaching for `/api/reload` would answer the same question by doing the thing being asked about.
- */
-export declare function isDevServerRunning(root: string, deps?: {
-    fetch?: typeof globalThis.fetch;
-}): Promise<boolean>;
 export declare function devHandlePath(root: string): string;
 export declare function writeDevHandle(root: string, handle: DevHandle): void;
 /** Best-effort: a handle we cannot remove is a stale file, never a failed shutdown. */

package/dist/project/dev-handle.js

@@ -18,24 +18,10 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { currentPortLane } from '../port-lane.js';
-/**
- * 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. Shared with
- * `project/jobs.ts`, which asks it of a generation rather than of a server.
- */
-export function isProcessAlive(pid) {
-    if (pid <= 0)
-        return false;
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return error.code === 'EPERM';
-    }
-}
+import { isProcessAlive } from '../process-alive.js';
+// Re-exported for the callers that always found it here; it moved so the machine lock could use it
+// without importing this module (see process-alive.ts).
+export { isProcessAlive } from '../process-alive.js';
 /** A `bitmagic dev` currently serving this project, or null. */
 export function readLiveDevHandle(root) {
     const handle = readDevHandle(root);
@@ -44,53 +30,17 @@ export function readLiveDevHandle(root) {
 /**
  * The editor port, owned here rather than by any one command.
  *
- * `dev` binds it, `reload` falls back to it when there is no handle to read, and the probe below
- * uses it for the same reason. It was three separate literals; a fourth reader would have made
- * four. Whoever changes the default changes it once.
+ * `dev` names it in its help text and it is what slot 0 of the port registry resolves to
+ * (project/dev-ports.ts). Nothing falls back to it any more: a project that has never run `dev`
+ * has no port to probe, and probing the lane default reached whichever OTHER project happened to
+ * hold slot 0 — `reload` from project B reloading project A's tab.
  *
  * A function rather than a constant since the number depends on which release line is running
- * (port-lane.ts). That matters most for the two readers BELOW a missing handle: a dev-line `reload`
- * that fell back to a fixed 3011 would probe — and reload — a release-line `bitmagic dev`, serving
- * somebody else's project in another window.
+ * (port-lane.ts).
  */
 export function defaultEditorPort() {
     return currentPortLane().editorPort;
 }
-/** Long enough for a loopback GET, short enough that a wedged server cannot stall a command. */
-const PROBE_TIMEOUT_MS = 2_000;
-/**
- * Is a `bitmagic dev` serving this project — asked the way `reload` asks it?
- *
- * There were two answers to this question and they disagreed in the field: `reload` probes the
- * port (recorded, else the default), while the "nobody can see this happen" nudge only read
- * `.bitmagic/dev.json`. A server from a build predating that file therefore reloaded tabs on
- * request while every generation in the same minute announced that nothing was watching. That
- * particular cause fixes itself on restart; two detections drifting apart does not, so there is
- * now one.
- *
- * The handle is still the fast path, and deliberately: it answers without touching the network,
- * and a live pid holding it is not something a probe can contradict. The probe is what the file's
- * ABSENCE means — which is "no record", never "no server".
- *
- * `GET /api/state` is the probe because it is the cheapest read-only route the dev view serves.
- * Reaching for `/api/reload` would answer the same question by doing the thing being asked about.
- */
-export async function isDevServerRunning(root, deps = {}) {
-    if (readLiveDevHandle(root) !== null)
-        return true;
-    const doFetch = deps.fetch ?? globalThis.fetch;
-    const port = readDevHandle(root)?.editorPort ?? defaultEditorPort();
-    try {
-        const response = await doFetch(`http://127.0.0.1:${port}/api/state`, {
-            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
-        });
-        return response.ok;
-    }
-    catch {
-        // Nothing listening, or something that is not a dev view. Either way: not running.
-        return false;
-    }
-}
 export function devHandlePath(root) {
     return path.join(root, '.bitmagic', 'dev.json');
 }

package/dist/project/dev-handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev-handle.js","sourceRoot":"","sources":["../../src/project/dev-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAmBlD;;;;;;GAMG;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;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC,UAAU,CAAC;AACtC,CAAC;AAED,gGAAgG;AAChG,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAE/B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,OAA4C,EAAE;IAE9C,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,EAAE,UAAU,IAAI,iBAAiB,EAAE,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,oBAAoB,IAAI,YAAY,EAAE;YACnE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC;SAC9C,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAiB;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC9F,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"dev-handle.js","sourceRoot":"","sources":["../../src/project/dev-handle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmBrD,mGAAmG;AACnG,wDAAwD;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,MAAM,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC,UAAU,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,MAAiB;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,aAAa;IACf,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxF,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC9F,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/project/dev-ports.d.ts

@@ -0,0 +1,67 @@
+import { type MachineLockDeps } from '../machine-lock.js';
+import { type PortLane } from '../port-lane.js';
+import type { UpdateTag } from '../update/notice.js';
+export interface DevSlotEntry {
+    slot: number;
+    /** Epoch ms of the last `bitmagic dev` here — what decides who is evicted when the lane is full. */
+    lastUsedAt: number;
+}
+export declare function devPortsPath(baseDir?: string): string;
+/** The key a project is filed under: its real path, so a symlinked folder is the same project. */
+export declare function projectKey(root: string): string;
+export interface DevPortsReadOptions {
+    baseDir?: string;
+    tag?: UpdateTag;
+}
+/** The slot this project holds on this install's line, or null when it has never run `dev`. */
+export declare function readDevSlot(root: string, options?: DevPortsReadOptions): number | null;
+/**
+ * Every port some project on this machine has been promised in this lane.
+ *
+ * What `reserveLanePort` (local-port.ts) keeps its throwaway ports away from: a verify that
+ * happened to take 3021 while project B's dev was down would push B's next `dev` into a drift,
+ * which is the instability the registry exists to end. `excludeRoot` leaves one project's own
+ * ports out — `dev` wants to avoid its NEIGHBOURS' slots, not its own.
+ */
+export declare function registeredSlotPorts(lane: PortLane, options?: DevPortsReadOptions & {
+    excludeRoot?: string;
+}): Set<number>;
+export interface ClaimDevSlotDeps extends DevPortsReadOptions {
+    now?: () => number;
+    /** Whether a `bitmagic dev` is serving `root` right now — an entry that must not be evicted. */
+    isLive?: (root: string) => boolean;
+    lock?: MachineLockDeps;
+}
+/**
+ * The slot this project holds, taking one if it has none.
+ *
+ * An existing entry is kept and touched. A new project gets the lowest free slot. When every slot
+ * is held, the entry least recently used whose project has no live `dev` is evicted — a deleted
+ * project has no handle and simply ages out — and a lane where all nine are live right now yields
+ * null, which `dev` answers with the old drifting scan rather than with a refusal.
+ */
+export declare function claimDevSlot(root: string, deps?: ClaimDevSlotDeps): Promise<number | null>;
+/**
+ * Where a `bitmagic dev` for this project would be listening, or null when there is no reason to
+ * think one exists.
+ *
+ * The recorded handle first: it is what `dev` actually bound, explicit `--editor-port` included.
+ * Then the project's slot, which is where a `dev` started without flags lands. Then NOTHING — not
+ * the lane default. A project that has never run `dev` has no port of its own, and probing the
+ * default reached whichever other project holds slot 0.
+ */
+export declare function preferredEditorPort(root: string, options?: DevPortsReadOptions): number | null;
+/**
+ * Is a `bitmagic dev` serving this project — asked the way `reload` asks it?
+ *
+ * The handle is the fast path, and deliberately: it answers without touching the network, and a
+ * live pid holding it is not something a probe can contradict. A stale handle (a `dev` killed
+ * with SIGKILL leaves one) still names the likeliest port, so that is probed; so is the project's
+ * slot. `GET /api/state` is the probe because it is the cheapest read-only route the dev view
+ * serves, and it names the game it serves, so a server answering for some OTHER project on the
+ * same port is "not running", not "running".
+ */
+export declare function isDevServerRunning(root: string, deps?: {
+    fetch?: typeof globalThis.fetch;
+    gameId?: string;
+} & DevPortsReadOptions): Promise<boolean>;

package/dist/project/dev-ports.js

@@ -0,0 +1,204 @@
+/**
+ * `~/.bitmagic/dev-ports.json` — which fixed ports each project on this machine serves on.
+ *
+ * A creator making several games at once runs `bitmagic dev` in several folders. Before this
+ * existed every one of them started at the lane's defaults and drifted to a random port when
+ * those were busy, so which project answered on 3011 depended on start order, bookmarks pointed
+ * at the wrong game after a restart, and a `bitmagic reload` with no handle to read fell back to
+ * the default — reloading whichever OTHER project held it. The registry gives each project a
+ * slot (port-lane.ts `slotPorts`) the first time `dev` runs there, and the same slot every time
+ * after: the project in the 3020s stays in the 3020s.
+ *
+ * Per machine rather than per project, because the promise is about this machine's ports; per
+ * install line, because a dev-line and a release-line CLI have separate lanes and the slot is an
+ * offset into one. Keyed by the project's real path — the folder is the identity a creator has,
+ * and a copied project is a second project.
+ *
+ * "Remember what this project last bound" was the simpler design and does not work: B's first
+ * run while A is down takes 3010/3011 because they are free, both projects then remember the
+ * same pair, and they take turns evicting each other for ever. Exclusion between projects is the
+ * whole feature, and once the file excludes it is a slot table whichever way it is spelled.
+ *
+ * Allocation is a read-modify-write of one file under the machine lock (machine-lock.ts); two
+ * `dev`s starting in two folders at once must not both take slot 1. Reads need no lock — the file
+ * is replaced atomically (atomic-json.ts).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+import { defaultBaseDir } from '../config/credentials.js';
+import { withMachineLock } from '../machine-lock.js';
+import { DEV_PORT_SLOTS, currentLineTag, portLaneFor, slotPorts, } from '../port-lane.js';
+import { readDevHandle, readLiveDevHandle } from './dev-handle.js';
+export function devPortsPath(baseDir = defaultBaseDir()) {
+    return path.join(baseDir, 'dev-ports.json');
+}
+/** The key a project is filed under: its real path, so a symlinked folder is the same project. */
+export function projectKey(root) {
+    try {
+        return fs.realpathSync.native(root);
+    }
+    catch {
+        return path.resolve(root);
+    }
+}
+function emptyRegistry() {
+    return { version: 1, lanes: { latest: {}, dev: {} } };
+}
+function isEntry(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    return Number.isInteger(v.slot) && v.slot >= 0 && v.slot < DEV_PORT_SLOTS
+        && typeof v.lastUsedAt === 'number';
+}
+/** The registry, or an empty one for a file that is missing, malformed or from another version. */
+function readRegistry(baseDir) {
+    const parsed = readJsonFile(devPortsPath(baseDir));
+    if (typeof parsed !== 'object' || parsed === null)
+        return emptyRegistry();
+    const record = parsed;
+    if (record.version !== 1 || typeof record.lanes !== 'object' || record.lanes === null)
+        return emptyRegistry();
+    const lanes = record.lanes;
+    const registry = emptyRegistry();
+    for (const tag of ['latest', 'dev']) {
+        const lane = lanes[tag];
+        if (typeof lane !== 'object' || lane === null)
+            continue;
+        for (const [root, entry] of Object.entries(lane)) {
+            if (isEntry(entry))
+                registry.lanes[tag][root] = { slot: entry.slot, lastUsedAt: entry.lastUsedAt };
+        }
+    }
+    return registry;
+}
+/** The slot this project holds on this install's line, or null when it has never run `dev`. */
+export function readDevSlot(root, options = {}) {
+    const registry = readRegistry(options.baseDir ?? defaultBaseDir());
+    const entry = registry.lanes[options.tag ?? currentLineTag()][projectKey(root)];
+    return entry === undefined ? null : entry.slot;
+}
+/**
+ * Every port some project on this machine has been promised in this lane.
+ *
+ * What `reserveLanePort` (local-port.ts) keeps its throwaway ports away from: a verify that
+ * happened to take 3021 while project B's dev was down would push B's next `dev` into a drift,
+ * which is the instability the registry exists to end. `excludeRoot` leaves one project's own
+ * ports out — `dev` wants to avoid its NEIGHBOURS' slots, not its own.
+ */
+export function registeredSlotPorts(lane, options = {}) {
+    const registry = readRegistry(options.baseDir ?? defaultBaseDir());
+    const skip = options.excludeRoot === undefined ? null : projectKey(options.excludeRoot);
+    const ports = new Set();
+    for (const [root, entry] of Object.entries(registry.lanes[options.tag ?? currentLineTag()])) {
+        if (root === skip)
+            continue;
+        const slot = slotPorts(lane, entry.slot);
+        ports.add(slot.gamePort);
+        ports.add(slot.editorPort);
+        ports.add(slot.mobilePort);
+    }
+    return ports;
+}
+/**
+ * The slot this project holds, taking one if it has none.
+ *
+ * An existing entry is kept and touched. A new project gets the lowest free slot. When every slot
+ * is held, the entry least recently used whose project has no live `dev` is evicted — a deleted
+ * project has no handle and simply ages out — and a lane where all nine are live right now yields
+ * null, which `dev` answers with the old drifting scan rather than with a refusal.
+ */
+export async function claimDevSlot(root, deps = {}) {
+    const baseDir = deps.baseDir ?? defaultBaseDir();
+    const tag = deps.tag ?? currentLineTag();
+    const now = deps.now ?? Date.now;
+    const isLive = deps.isLive ?? ((r) => readLiveDevHandle(r) !== null);
+    const key = projectKey(root);
+    return withMachineLock('dev-ports', { root, command: 'dev' }, async () => {
+        const registry = readRegistry(baseDir);
+        const lane = registry.lanes[tag];
+        const existing = lane[key];
+        if (existing !== undefined) {
+            existing.lastUsedAt = now();
+            writeJsonAtomic(devPortsPath(baseDir), registry);
+            return existing.slot;
+        }
+        const taken = new Set(Object.values(lane).map((entry) => entry.slot));
+        let slot = null;
+        for (let candidate = 0; candidate < DEV_PORT_SLOTS; candidate += 1) {
+            if (!taken.has(candidate)) {
+                slot = candidate;
+                break;
+            }
+        }
+        if (slot === null) {
+            const evictable = Object.entries(lane)
+                .filter(([other]) => !isLive(other))
+                .sort(([, a], [, b]) => a.lastUsedAt - b.lastUsedAt);
+            const victim = evictable[0];
+            if (victim === undefined)
+                return null;
+            slot = victim[1].slot;
+            delete lane[victim[0]];
+        }
+        lane[key] = { slot, lastUsedAt: now() };
+        writeJsonAtomic(devPortsPath(baseDir), registry);
+        return slot;
+    }, { baseDir, ...deps.lock });
+}
+/**
+ * Where a `bitmagic dev` for this project would be listening, or null when there is no reason to
+ * think one exists.
+ *
+ * The recorded handle first: it is what `dev` actually bound, explicit `--editor-port` included.
+ * Then the project's slot, which is where a `dev` started without flags lands. Then NOTHING — not
+ * the lane default. A project that has never run `dev` has no port of its own, and probing the
+ * default reached whichever other project holds slot 0.
+ */
+export function preferredEditorPort(root, options = {}) {
+    const handle = readDevHandle(root);
+    if (handle !== null)
+        return handle.editorPort;
+    const slot = readDevSlot(root, options);
+    if (slot === null)
+        return null;
+    return slotPorts(portLaneFor(options.tag ?? currentLineTag()), slot).editorPort;
+}
+/** Long enough for a loopback GET, short enough that a wedged server cannot stall a command. */
+const PROBE_TIMEOUT_MS = 2_000;
+/**
+ * Is a `bitmagic dev` serving this project — asked the way `reload` asks it?
+ *
+ * The handle is the fast path, and deliberately: it answers without touching the network, and a
+ * live pid holding it is not something a probe can contradict. A stale handle (a `dev` killed
+ * with SIGKILL leaves one) still names the likeliest port, so that is probed; so is the project's
+ * slot. `GET /api/state` is the probe because it is the cheapest read-only route the dev view
+ * serves, and it names the game it serves, so a server answering for some OTHER project on the
+ * same port is "not running", not "running".
+ */
+export async function isDevServerRunning(root, deps = {}) {
+    if (readLiveDevHandle(root) !== null)
+        return true;
+    const port = preferredEditorPort(root, deps);
+    if (port === null)
+        return false;
+    const doFetch = deps.fetch ?? globalThis.fetch;
+    try {
+        const response = await doFetch(`http://127.0.0.1:${port}/api/state`, {
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!response.ok)
+            return false;
+        if (deps.gameId === undefined)
+            return true;
+        const body = (await response.json().catch(() => null));
+        // A server from before /api/state carried the id cannot be told apart; believe it.
+        return body === null || typeof body.gameId !== 'string' || body.gameId === deps.gameId;
+    }
+    catch {
+        // Nothing listening, or something that is not a dev view. Either way: not running.
+        return false;
+    }
+}
+//# sourceMappingURL=dev-ports.js.map

package/dist/project/dev-ports.js.map

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

package/dist/project/game-name.d.ts

@@ -0,0 +1,9 @@
+/**
+ * What to call this game where a human is looking — the dev view's bar and its browser tab.
+ *
+ * `gameName` in `src/work/game.json` is what bitmagic.ai catalogs the game as, so it is the name
+ * the creator chose. A project that has not named its game yet is called by its folder, which is
+ * the name the creator already uses in every terminal. Never the gameId: that is shown beside it,
+ * but nobody tells two tabs apart by a hash.
+ */
+export declare function readGameName(root: string): string;

package/dist/project/game-name.js

@@ -0,0 +1,21 @@
+import * as path from 'path';
+import { readJsonFile } from '../atomic-json.js';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+/**
+ * What to call this game where a human is looking — the dev view's bar and its browser tab.
+ *
+ * `gameName` in `src/work/game.json` is what bitmagic.ai catalogs the game as, so it is the name
+ * the creator chose. A project that has not named its game yet is called by its folder, which is
+ * the name the creator already uses in every terminal. Never the gameId: that is shown beside it,
+ * but nobody tells two tabs apart by a hash.
+ */
+export function readGameName(root) {
+    const parsed = readJsonFile(path.join(root, aliasSourceDir('work'), 'game.json'));
+    if (typeof parsed === 'object' && parsed !== null) {
+        const name = parsed.gameName;
+        if (typeof name === 'string' && name.trim() !== '')
+            return name.trim();
+    }
+    return path.basename(root);
+}
+//# sourceMappingURL=game-name.js.map

package/dist/project/game-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-name.js","sourceRoot":"","sources":["../../src/project/game-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IAClF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,GAAI,MAAkC,CAAC,QAAQ,CAAC;QAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/project/jobs.js

@@ -48,7 +48,8 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { isDevServerRunning, isProcessAlive } from './dev-handle.js';
+import { isProcessAlive } from '../process-alive.js';
+import { isDevServerRunning } from './dev-ports.js';
 export const JOBS_DIR = path.join('.bitmagic', 'jobs');
 /** Failed records are kept for the agent to read back — but not forever. */
 const FAILED_RECORD_TTL_MS = 24 * 60 * 60 * 1000;