@owlmeans/viable-sdk 0.1.18-rc.8 → 0.1.18

package/build/project/types.d.ts

@@ -0,0 +1,37 @@
+import type { ConnectMarker } from '@owlmeans/viable-common';
+export interface TargetEnv {
+    /** Project-relative path → the values that file declares. */
+    files: Record<string, Record<string, string>>;
+    /** Everything the target's processes see, later files overriding earlier ones. */
+    values: Record<string, string>;
+}
+export interface DiscoveredProject {
+    /** The directory holding `.viable/connect.json` — the project root, not where the search began. */
+    dir: string;
+    marker: ConnectMarker;
+}
+export interface ServiceState {
+    /** A connection string is present in the project's own half of the `.env`. */
+    configured: boolean;
+    /** Something answers where it points. False for an unset URL and for one nothing listens on. */
+    reachable: boolean;
+    /** The value, with everything between the scheme and the host removed. */
+    redacted?: string;
+}
+export interface SetupReport {
+    dir: string;
+    /** Only a project with a worker needs a queue store; for the rest it is noise. */
+    needsWorker: boolean;
+    database: ServiceState;
+    queue: ServiceState;
+    /** The command-line tools the paths below depend on. */
+    tools: {
+        bun: boolean;
+        git: boolean;
+        docker: boolean;
+    };
+    platform: NodeJS.Platform;
+    /** Whether the file holding these values is kept out of the project's history. */
+    envIgnored: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/project/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7C,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,mGAAmG;IACnG,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAA;IACnB,gGAAgG;IAChG,SAAS,EAAE,OAAO,CAAA;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,kFAAkF;IAClF,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,YAAY,CAAA;IACtB,KAAK,EAAE,YAAY,CAAA;IACnB,wDAAwD;IACxD,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;IACtD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAA;IACzB,kFAAkF;IAClF,UAAU,EAAE,OAAO,CAAA;CACpB"}

package/build/project/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/project/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/project/types.ts"],"names":[],"mappings":""}

package/build/run/consts.local.d.ts

@@ -0,0 +1,3 @@
+export declare const MIME: Record<string, string>;
+export declare const PLACEHOLDER: string;
+//# sourceMappingURL=consts.local.d.ts.map

package/build/run/consts.local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.d.ts","sourceRoot":"","sources":["../../src/run/consts.local.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBvC,CAAA;AAED,eAAO,MAAM,WAAW,QAIJ,CAAA"}

package/build/run/consts.local.js

@@ -0,0 +1,26 @@
+export const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.webmanifest': 'application/manifest+json',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.txt': 'text/plain; charset=utf-8',
+};
+export const PLACEHOLDER = '<!doctype html><html lang="en"><head><meta charset="UTF-8"/>'
+    + '<meta name="viewport" content="width=device-width, initial-scale=1.0"/>'
+    + '<title>Not built yet</title></head><body style="font-family:sans-serif">'
+    + '<p style="padding:2rem">This project has not been built yet. Run a build and reload.</p>'
+    + '</body></html>';
+//# sourceMappingURL=consts.local.js.map

package/build/run/consts.local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.local.js","sourceRoot":"","sources":["../../src/run/consts.local.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAA2B;IAC1C,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,uCAAuC;IAC/C,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,iCAAiC;IACzC,cAAc,EAAE,2BAA2B;IAC3C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,2BAA2B;CACpC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,8DAA8D;MACrF,yEAAyE;MACzE,0EAA0E;MAC1E,0FAA0F;MAC1F,gBAAgB,CAAA"}

package/build/run/index.d.ts

@@ -1,75 +1,17 @@
-import type { LocalRunRecord } from './state.js';
+import type { LocalRunStatus, RunLocalOptions, RunLocalResult } from './types.js';
 export * from './state.js';
+export type * from './state/types.js';
+export * from './process.js';
+export type * from './process/types.js';
+export * from './local.js';
+export type * from './local/types.js';
+export type * from './types.js';
 export * from './serve.js';
-export interface RunLocalOptions {
-    /** Build before starting. On by default — starting a stale `dist/` is the confusing failure. */
-    build?: boolean;
-    log?: (line: string) => void;
-}
-export interface RunLocalResult {
-    record: LocalRunRecord | null;
-    /**
-     * The ports the run uses, so a caller can print an address without composing one.
-     *
-     * Stated even when a process did not come up: they are where the app WILL answer, and whether
-     * it does yet is what `error`, `buildError` and {@link localStatus} are for.
-     */
-    api: number;
-    web: number;
-    worker?: number;
-    /** The reason nothing was started, or the tree was refused. */
-    error?: string;
-    /** A build ran and failed. The web server still comes up so the state is visible. */
-    buildError?: string;
-}
-/** One supervised process, as a status read finds it. */
-export interface LocalProcessStatus {
-    pid: number;
-    port: number;
-    alive: boolean;
-}
-export interface LocalRunStatus {
-    running: boolean;
-    startedAt?: string;
-    /** Ports, flat, for a caller composing an address or a one-line report. */
-    api?: number;
-    worker?: number;
-    web?: number;
-    /** The target's own boot phase, when it got far enough to report one. */
-    phase?: string;
-    /** Whether the target says it is serving — never the same question as "the pid is alive". */
-    ready?: boolean;
-    /** Why it is not ready. Absent when it is. */
-    reason?: string;
-    processes: {
-        api?: LocalProcessStatus;
-        worker?: LocalProcessStatus;
-        web?: LocalProcessStatus;
-    };
-}
-/**
- * Build the target, start its processes, serve its browser app.
- *
- * A previous run is stopped first: both halves bind fixed ports, and a replacement that races the
- * process it is replacing loses the bind and exits — with nothing announcing it, since a failed
- * `listen` says nothing on its own.
- */
+export type { LocalProcessStatus, LocalRunStatus, RunLocalOptions, RunLocalResult } from './types.js';
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).runLocal(…)` */
 export declare const runLocal: (dir: string, options?: RunLocalOptions) => Promise<RunLocalResult>;
-/**
- * Stop whatever the run record names, and forget it.
- *
- * Safe to call when nothing is running: the record is the only authority, and a stale one names
- * pids that are simply not alive. The children are detached, so they outlive the process that
- * started them — which is exactly why the record is a file and this is the only way to end them.
- */
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).stopLocal()` */
 export declare const stopLocal: (dir: string) => Promise<void>;
-/**
- * What is running, and whether the target is actually serving.
- *
- * Two independent facts, because either one alone lies. A live pid says nothing about a target
- * that bound its port and then failed to reach its database — it answers `200` with `db.ok:false`
- * and would otherwise read as healthy. A health answer says nothing about a process that died
- * while something else holds the port.
- */
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).localStatus()` */
 export declare const localStatus: (dir: string) => Promise<LocalRunStatus>;
 //# sourceMappingURL=index.d.ts.map

package/build/run/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAgB1B,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IAC7B;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE;QACT,GAAG,CAAC,EAAE,kBAAkB,CAAA;QACxB,MAAM,CAAC,EAAE,kBAAkB,CAAA;QAC3B,GAAG,CAAC,EAAE,kBAAkB,CAAA;KACzB,CAAA;CACF;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,QACd,MAAM,YAAW,eAAe,KACpC,OAAO,CAAC,cAAc,CA4DxB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,QAAe,MAAM,KAAG,OAAO,CAAC,IAAI,CAezD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,QAAe,MAAM,KAAG,OAAO,CAAC,cAAc,CAyCrE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEjF,cAAc,YAAY,CAAA;AAC1B,mBAAmB,kBAAkB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,YAAY,CAAA;AAC1B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA;AAE1B,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErG,sFAAsF;AACtF,eAAO,MAAM,QAAQ,QAAe,MAAM,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,CACjD,CAAA;AAEjD,sFAAsF;AACtF,eAAO,MAAM,SAAS,QAAe,MAAM,KAAG,OAAO,CAAC,IAAI,CAA8C,CAAA;AAExG,wFAAwF;AACxF,eAAO,MAAM,WAAW,QAAe,MAAM,KAAG,OAAO,CAAC,cAAc,CAAgD,CAAA"}

package/build/run/index.js

@@ -1,150 +1,12 @@
-import fs from 'fs-extra';
-import p from 'node:path';
-import { SlotCommandType, SlotShellCommand, TARGET_API_PORT, TARGET_WEB_PORT, TARGET_WORKER_PORT } from '@owlmeans/viable-common';
-import { makeLocalSlotExecutor } from '../executor/index.js';
-import { readTargetHealth } from '../executor/health.js';
-import { integrityRefusal } from '../executor/integrity.js';
-import { apiPath, webPath } from '../executor/layout.js';
-import { isAlive } from '../executor/spawn.js';
-import { createLocalServer } from './serve.js';
-import { apiRunning, clearRun, readRun, startApi, startWorker, stopProcess, writeRun } from './state.js';
+import { makeLocalRunHelper } from './local.js';
 export * from './state.js';
+export * from './process.js';
+export * from './local.js';
 export * from './serve.js';
-/**
- * Run the generated application on the developer's own machine.
- *
- * The slot's equivalent is a pod: a publisher supervising two children and a static server, with
- * Kubernetes underneath. None of that exists here, and the parts that were about the pod are
- * deliberately not reproduced — there is no respawn ladder, no reconciler and no health route,
- * because a developer watching their own terminal is the supervisor. What IS reproduced is the
- * shape: the same ports, the same argv marker, the same environment, and the same "port ownership
- * is the only proof" rule about restarts.
- */
-/** Servers this process is holding, so a stop can close what a run opened. */
-const _servers = new Map();
-/**
- * Build the target, start its processes, serve its browser app.
- *
- * A previous run is stopped first: both halves bind fixed ports, and a replacement that races the
- * process it is replacing loses the bind and exits — with nothing announcing it, since a failed
- * `listen` says nothing on its own.
- */
-export const runLocal = async (dir, options = {}) => {
-    const root = p.resolve(dir);
-    const log = options.log ?? (() => undefined);
-    const ports = { api: TARGET_API_PORT, web: TARGET_WEB_PORT };
-    const refused = await integrityRefusal(root, 'Refused to run');
-    if (refused != null) {
-        return { record: null, ...ports, error: refused };
-    }
-    await stopLocal(root);
-    let buildError;
-    if (options.build !== false) {
-        log('Building the target project…');
-        const result = await makeLocalSlotExecutor(root, { log }).execute({
-            type: SlotCommandType.Shell, command: SlotShellCommand.Build,
-        });
-        if (result.result != null) {
-            buildError = result.result;
-        }
-    }
-    const record = { dir: root, startedAt: new Date().toISOString() };
-    // Only when the last build left something to spawn. Starting `bun dist/index.js` against a
-    // missing bundle fails with a message about a file rather than about the build that never
-    // produced it.
-    if (await fs.pathExists(p.resolve(apiPath(root), 'dist', 'index.js'))) {
-        record.api = await startApi(root);
-        log(`Target api started on port ${record.api.port}`);
-    }
-    else {
-        buildError ??= 'The target api has no build output — nothing was started.';
-    }
-    const worker = await startWorker(root);
-    if (worker != null) {
-        record.worker = worker;
-        log(`Target worker started on port ${worker.port}`);
-    }
-    const server = createLocalServer(() => p.resolve(webPath(root), 'dist'), { apiPort: TARGET_API_PORT });
-    await server.listen(TARGET_WEB_PORT);
-    _servers.set(root, server);
-    // The web server is this process, not a child: whoever called `runLocal` is holding it, and its
-    // pid is what a later `localStatus` from another process checks for liveness.
-    record.web = { pid: process.pid, port: TARGET_WEB_PORT };
-    log(`Target app served at http://localhost:${TARGET_WEB_PORT}`);
-    await writeRun(root, record);
-    return {
-        record,
-        ...ports,
-        ...(worker != null ? { worker: worker.port } : {}),
-        ...(buildError != null ? { buildError } : {}),
-    };
-};
-/**
- * Stop whatever the run record names, and forget it.
- *
- * Safe to call when nothing is running: the record is the only authority, and a stale one names
- * pids that are simply not alive. The children are detached, so they outlive the process that
- * started them — which is exactly why the record is a file and this is the only way to end them.
- */
-export const stopLocal = async (dir) => {
-    const root = p.resolve(dir);
-    const server = _servers.get(root);
-    if (server != null) {
-        _servers.delete(root);
-        await server.close();
-    }
-    const record = await readRun(root);
-    if (record == null)
-        return;
-    await stopProcess(record.worker);
-    await stopProcess(record.api);
-    await clearRun(root);
-};
-/**
- * What is running, and whether the target is actually serving.
- *
- * Two independent facts, because either one alone lies. A live pid says nothing about a target
- * that bound its port and then failed to reach its database — it answers `200` with `db.ok:false`
- * and would otherwise read as healthy. A health answer says nothing about a process that died
- * while something else holds the port.
- */
-export const localStatus = async (dir) => {
-    const root = p.resolve(dir);
-    const record = await readRun(root);
-    if (record == null) {
-        return { running: false, processes: {} };
-    }
-    const status = {
-        running: apiRunning(record),
-        startedAt: record.startedAt,
-        processes: {},
-    };
-    if (record.api != null) {
-        const port = record.api.port ?? TARGET_API_PORT;
-        const health = await readTargetHealth(port, record.api.bootId ?? '', 2_000);
-        status.api = port;
-        status.ready = health.ready;
-        if (health.phase != null)
-            status.phase = health.phase;
-        if (!health.ready)
-            status.reason = health.reason;
-        status.processes.api = {
-            pid: record.api.pid, port, alive: isAlive(record.api.pid),
-        };
-    }
-    if (record.worker != null) {
-        const port = record.worker.port ?? TARGET_WORKER_PORT;
-        status.worker = port;
-        status.processes.worker = {
-            pid: record.worker.pid, port, alive: isAlive(record.worker.pid),
-        };
-    }
-    if (record.web != null) {
-        status.web = record.web.port;
-        status.processes.web = {
-            pid: record.web.pid, port: record.web.port, alive: isAlive(record.web.pid),
-        };
-    }
-    return status;
-};
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).runLocal(…)` */
+export const runLocal = async (dir, options = {}) => await makeLocalRunHelper(dir).runLocal(options);
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).stopLocal()` */
+export const stopLocal = async (dir) => await makeLocalRunHelper(dir).stopLocal();
+/** @deprecated compat:factory-refactor — use `makeLocalRunHelper(dir).localStatus()` */
+export const localStatus = async (dir) => await makeLocalRunHelper(dir).localStatus();
 //# sourceMappingURL=index.js.map

package/build/run/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAG/C,cAAc,YAAY,CAAA;AAE1B,cAAc,cAAc,CAAA;AAE5B,cAAc,YAAY,CAAA;AAG1B,cAAc,YAAY,CAAA;AAI1B,sFAAsF;AACtF,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,GAAW,EAAE,OAAO,GAAoB,EAAE,EAA2B,EAAE,CACpG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AAEjD,sFAAsF;AACtF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,CAAA;AAExG,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,GAAW,EAA2B,EAAE,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAA"}

package/build/run/local/types.d.ts

@@ -0,0 +1,39 @@
+import type { LocalRunStatus, RunLocalOptions, RunLocalResult } from '../types.js';
+/**
+ * Run the generated application of ONE project directory on the developer's own machine.
+ *
+ * The slot's equivalent is a pod: a publisher supervising two children and a static server, with
+ * Kubernetes underneath. None of that exists here, and the parts that were about the pod are
+ * deliberately not reproduced — there is no respawn ladder, no reconciler and no health route,
+ * because a developer watching their own terminal is the supervisor. What IS reproduced is the
+ * shape: the same ports, the same argv marker, the same environment, and the same "port ownership
+ * is the only proof" rule about restarts.
+ */
+export interface LocalRunHelper {
+    /**
+     * Build the target, start its processes, serve its browser app.
+     *
+     * A previous run is stopped first: both halves bind fixed ports, and a replacement that races the
+     * process it is replacing loses the bind and exits — with nothing announcing it, since a failed
+     * `listen` says nothing on its own.
+     */
+    runLocal: (options?: RunLocalOptions) => Promise<RunLocalResult>;
+    /**
+     * Stop whatever the run record names, and forget it.
+     *
+     * Safe to call when nothing is running: the record is the only authority, and a stale one names
+     * pids that are simply not alive. The children are detached, so they outlive the process that
+     * started them — which is exactly why the record is a file and this is the only way to end them.
+     */
+    stopLocal: () => Promise<void>;
+    /**
+     * What is running, and whether the target is actually serving.
+     *
+     * Two independent facts, because either one alone lies. A live pid says nothing about a target
+     * that bound its port and then failed to reach its database — it answers `200` with `db.ok:false`
+     * and would otherwise read as healthy. A health answer says nothing about a process that died
+     * while something else holds the port.
+     */
+    localStatus: () => Promise<LocalRunStatus>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/run/local/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/run/local/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAElF;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;IAChE;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAA;CAC3C"}

package/build/run/local/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/run/local/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/run/local/types.ts"],"names":[],"mappings":""}

package/build/run/local.d.ts

@@ -0,0 +1,3 @@
+import type { LocalRunHelper } from './local/types.js';
+export declare const makeLocalRunHelper: (dir: string) => LocalRunHelper;
+//# sourceMappingURL=local.d.ts.map

package/build/run/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/run/local.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAgBtD,eAAO,MAAM,kBAAkB,QAAS,MAAM,KAAG,cA4HhD,CAAA"}

package/build/run/local.js

@@ -0,0 +1,130 @@
+import fs from 'fs-extra';
+import p from 'node:path';
+import { SlotCommandType, SlotShellCommand, TARGET_API_PORT, TARGET_WEB_PORT, TARGET_WORKER_PORT } from '@owlmeans/viable-common';
+import { makeLocalSlotExecutor } from '../executor/index.js';
+import { healthHelper } from '../executor/health.js';
+import { integrityHelper } from '../executor/integrity.js';
+import { makeLayoutHelper } from '../executor/layout.js';
+import { spawnHelper } from '../executor/spawn.js';
+import { createLocalServer } from './serve.js';
+import { runProcessHelper } from './process.js';
+import { makeRunStateHelper } from './state.js';
+/**
+ * Run the generated application on the developer's own machine.
+ *
+ * The slot's equivalent is a pod: a publisher supervising two children and a static server, with
+ * Kubernetes underneath. None of that exists here, and the parts that were about the pod are
+ * deliberately not reproduced — there is no respawn ladder, no reconciler and no health route,
+ * because a developer watching their own terminal is the supervisor. What IS reproduced is the
+ * shape: the same ports, the same argv marker, the same environment, and the same "port ownership
+ * is the only proof" rule about restarts.
+ */
+/** Servers this process is holding, so a stop can close what a run opened. */
+const _servers = new Map();
+export const makeLocalRunHelper = (dir) => {
+    const root = p.resolve(dir);
+    const layout = makeLayoutHelper(root);
+    const state = makeRunStateHelper(root);
+    const runLocal = async (options = {}) => {
+        const log = options.log ?? (() => undefined);
+        const ports = { api: TARGET_API_PORT, web: TARGET_WEB_PORT };
+        const refused = await integrityHelper.integrityRefusal(root, 'Refused to run');
+        if (refused != null) {
+            return { record: null, ...ports, error: refused };
+        }
+        await stopLocal();
+        let buildError;
+        if (options.build !== false) {
+            log('Building the target project…');
+            const result = await makeLocalSlotExecutor(root, { log }).execute({
+                type: SlotCommandType.Shell, command: SlotShellCommand.Build,
+            });
+            if (result.result != null) {
+                buildError = result.result;
+            }
+        }
+        const record = { dir: root, startedAt: new Date().toISOString() };
+        // Only when the last build left something to spawn. Starting `bun dist/index.js` against a
+        // missing bundle fails with a message about a file rather than about the build that never
+        // produced it.
+        if (await fs.pathExists(p.resolve(layout.apiPath(), 'dist', 'index.js'))) {
+            record.api = await state.startApi();
+            log(`Target api started on port ${record.api.port}`);
+        }
+        else {
+            buildError ??= 'The target api has no build output — nothing was started.';
+        }
+        const worker = await state.startWorker();
+        if (worker != null) {
+            record.worker = worker;
+            log(`Target worker started on port ${worker.port}`);
+        }
+        const server = createLocalServer(() => p.resolve(layout.webPath(), 'dist'), { apiPort: TARGET_API_PORT });
+        await server.listen(TARGET_WEB_PORT);
+        _servers.set(root, server);
+        // The web server is this process, not a child: whoever called `runLocal` is holding it, and its
+        // pid is what a later `localStatus` from another process checks for liveness.
+        record.web = { pid: process.pid, port: TARGET_WEB_PORT };
+        log(`Target app served at http://localhost:${TARGET_WEB_PORT}`);
+        await state.writeRun(record);
+        return {
+            record,
+            ...ports,
+            ...(worker != null ? { worker: worker.port } : {}),
+            ...(buildError != null ? { buildError } : {}),
+        };
+    };
+    const stopLocal = async () => {
+        const server = _servers.get(root);
+        if (server != null) {
+            _servers.delete(root);
+            await server.close();
+        }
+        const record = await state.readRun();
+        if (record == null)
+            return;
+        await runProcessHelper.stopProcess(record.worker);
+        await runProcessHelper.stopProcess(record.api);
+        await state.clearRun();
+    };
+    const localStatus = async () => {
+        const record = await state.readRun();
+        if (record == null) {
+            return { running: false, processes: {} };
+        }
+        const status = {
+            running: runProcessHelper.apiRunning(record),
+            startedAt: record.startedAt,
+            processes: {},
+        };
+        if (record.api != null) {
+            const port = record.api.port ?? TARGET_API_PORT;
+            const health = await healthHelper.readTargetHealth(port, record.api.bootId ?? '', 2_000);
+            status.api = port;
+            status.ready = health.ready;
+            if (health.phase != null)
+                status.phase = health.phase;
+            if (!health.ready)
+                status.reason = health.reason;
+            status.processes.api = {
+                pid: record.api.pid, port, alive: spawnHelper.isAlive(record.api.pid),
+            };
+        }
+        if (record.worker != null) {
+            const port = record.worker.port ?? TARGET_WORKER_PORT;
+            status.worker = port;
+            status.processes.worker = {
+                pid: record.worker.pid, port, alive: spawnHelper.isAlive(record.worker.pid),
+            };
+        }
+        if (record.web != null) {
+            status.web = record.web.port;
+            status.processes.web = {
+                pid: record.web.pid, port: record.web.port, alive: spawnHelper.isAlive(record.web.pid),
+            };
+        }
+        return status;
+    };
+    return { runLocal, stopLocal, localStatus };
+};
+//# sourceMappingURL=local.js.map

package/build/run/local.js.map

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

package/build/run/process/types.d.ts

@@ -0,0 +1,15 @@
+import type { LocalProcessRecord, LocalRunRecord } from '../types.js';
+/** The liveness of the processes a run record names. */
+export interface RunProcessHelper {
+    /** Whether the api recorded here is still a live process. */
+    apiRunning: (record: LocalRunRecord | null) => boolean;
+    /**
+     * Stop a recorded process and wait for its port to actually free.
+     *
+     * The port and not the pid is what a replacement needs, so that is what is waited on.
+     */
+    stopProcess: (record: LocalProcessRecord | undefined) => Promise<void>;
+    /** Whether anything is answering on the api's port right now. */
+    apiListening: (port?: number) => Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/run/process/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/run/process/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAErE,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,KAAK,OAAO,CAAA;IACtD;;;;OAIG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,iEAAiE;IACjE,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAClD"}

package/build/run/process/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/run/process/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/run/process/types.ts"],"names":[],"mappings":""}

package/build/run/process.d.ts

@@ -0,0 +1,4 @@
+import type { RunProcessHelper } from './process/types.js';
+export declare const createRunProcessHelper: () => RunProcessHelper;
+export declare const runProcessHelper: RunProcessHelper;
+//# sourceMappingURL=process.d.ts.map

package/build/run/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/run/process.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,eAAO,MAAM,sBAAsB,QAAO,gBAqBzC,CAAA;AAED,eAAO,MAAM,gBAAgB,kBAA2B,CAAA"}

package/build/run/process.js

@@ -0,0 +1,20 @@
+import { TARGET_API_PORT } from '@owlmeans/viable-common';
+import { spawnHelper } from '../executor/spawn.js';
+export const createRunProcessHelper = () => {
+    const apiRunning = (record) => record != null && spawnHelper.isAlive(record.api?.pid);
+    const stopProcess = async (record) => {
+        if (record == null)
+            return;
+        if (spawnHelper.isAlive(record.pid)) {
+            spawnHelper.signalGroup(record.pid, 'SIGTERM');
+            if (!await spawnHelper.waitForPortFree(record.port, 5_000)) {
+                spawnHelper.signalGroup(record.pid, 'SIGKILL');
+            }
+        }
+        await spawnHelper.waitForPortFree(record.port, 5_000);
+    };
+    const apiListening = async (port = TARGET_API_PORT) => await spawnHelper.probeListening(port);
+    return { apiRunning, stopProcess, apiListening };
+};
+export const runProcessHelper = createRunProcessHelper();
+//# sourceMappingURL=process.js.map

package/build/run/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/run/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAIlD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAqB,EAAE;IAC3D,MAAM,UAAU,GAAG,CAAC,MAA6B,EAAW,EAAE,CAC5D,MAAM,IAAI,IAAI,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAExD,MAAM,WAAW,GAAG,KAAK,EAAE,MAAsC,EAAiB,EAAE;QAClF,IAAI,MAAM,IAAI,IAAI;YAAE,OAAM;QAE1B,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;YAC9C,IAAI,CAAC,MAAM,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBAC3D,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;YAChD,CAAC;QACH,CAAC;QACD,MAAM,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACvD,CAAC,CAAA;IAED,MAAM,YAAY,GAAG,KAAK,EACxB,IAAI,GAAW,eAAe,EACZ,EAAE,CAAC,MAAM,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAA;IAE7D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA;AAClD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,EAAE,CAAA"}