@relkit/cli 0.0.0

package/dist/commands/dev-session.js

@@ -0,0 +1,161 @@
+import { resolve } from "node:path";
+import { createSupervisorObservability, createSupervisorProxy, createSupervisorStateMachine, } from "@relkit/supervisor";
+import { startInspector } from "./dev-process.js";
+import { activateCandidate, drainCandidate } from "./dev-activation.js";
+import { createDevLogger } from "./dev-logger.js";
+import { installDevSignals } from "./dev-signals.js";
+import { shutdownDev } from "./dev-shutdown.js";
+import { logDevReady } from "./dev-ready.js";
+import { assertPortAvailable } from "./port-availability.js";
+/** Owns the stable development proxy and every child generation it starts. */
+export class DevSession {
+    stateMachine;
+    proxy;
+    projectRoot;
+    options;
+    abortController = new AbortController();
+    hashes = new Map();
+    drains = new Map();
+    controllers = new Set();
+    log;
+    observability;
+    shutdownPromise;
+    resolveShutdown;
+    activationTail = Promise.resolve(true);
+    activeCandidate;
+    activeHash;
+    inspector;
+    removeSignals;
+    latestVersion = -1;
+    stopPromise;
+    started = false;
+    stopping = false;
+    constructor(options) {
+        this.options = options;
+        this.projectRoot = resolve(options.projectRoot ?? process.cwd());
+        this.log = createDevLogger(options);
+        this.observability = createSupervisorObservability({
+            ...(options.observability ?? {}),
+            graphHash: (token) => this.hashes.get(token.generationToken) ?? this.activeHash,
+        });
+        this.stateMachine = createSupervisorStateMachine({
+            onTelemetry: (event) => {
+                this.observability.emit(event);
+                this.log({
+                    level: event.type === "outcome" && event.outcome.endsWith("failed") ? "error" : "info",
+                    event: `supervisor.${event.type}`,
+                    fields: {
+                        phase: event.type === "outcome" ? event.phase : event.from,
+                        state: event.type === "transition" ? event.to : event.outcome,
+                        sourceToken: event.sourceToken,
+                        generationToken: event.generationToken,
+                    },
+                });
+            },
+        });
+        this.proxy = createSupervisorProxy({
+            ...(options.hostname === undefined ? {} : { hostname: options.hostname }),
+            ...(options.stablePort === undefined ? {} : { port: options.stablePort }),
+            track: (token) => this.drains.get(`${token.sourceToken}:${token.generationToken}`)?.track(token),
+        });
+        this.shutdownPromise = new Promise((resolveShutdown) => {
+            this.resolveShutdown = resolveShutdown;
+        });
+    }
+    get backendPort() {
+        return this.proxy.port;
+    }
+    get inspectorPort() {
+        return this.inspector?.port;
+    }
+    get activeTarget() {
+        return this.proxy.activeTarget;
+    }
+    async start() {
+        if (this.started)
+            return this;
+        if (this.options.signal?.aborted)
+            throw this.options.signal.reason ?? new Error("Development startup was aborted.");
+        this.started = true;
+        this.removeSignals = installDevSignals(this.options, this.log, (reason) => this.stop(reason));
+        try {
+            await assertPortAvailable(this.backendPort, this.options.hostname ?? "127.0.0.1", "--port");
+            await this.proxy.listen();
+            if (this.options.inspector !== undefined && this.options.inspector !== false) {
+                this.inspector = await startInspector(this.options.inspector, this.backendPort, this.log, this.options.spawn);
+                void this.inspector.process.exited.then((exitCode) => {
+                    if (!this.stopping)
+                        void this.stop(new Error(`Inspector exited with code ${exitCode}.`));
+                });
+            }
+            if (!(await this.activate(0)))
+                throw this.options.signal?.reason ?? new Error("Initial development candidate failed.");
+            logDevReady(this.log, this.options.hostname ?? "127.0.0.1", this.backendPort, this.inspectorPort);
+            return this;
+        }
+        catch (error) {
+            await this.stop(error);
+            throw error;
+        }
+    }
+    /** Queues one source version; newer versions obsolete queued work. */
+    activate(version = this.latestVersion + 1, changedFiles = []) {
+        if (version < this.latestVersion)
+            return Promise.resolve(false);
+        this.latestVersion = version;
+        for (const controller of this.controllers)
+            controller.abort(new Error("A newer source version superseded this candidate."));
+        const task = this.activationTail.then(() => this.stopping || version !== this.latestVersion
+            ? false
+            : activateCandidate(this, version, changedFiles), () => false);
+        this.activationTail = task.catch(() => false);
+        return task;
+    }
+    notifySourceChange(version, changedFiles = []) {
+        return this.activate(version, changedFiles);
+    }
+    waitForShutdown() {
+        return this.shutdownPromise;
+    }
+    stop(reason = new Error("Development session stopped.")) {
+        if (this.stopPromise !== undefined)
+            return this.stopPromise;
+        this.stopPromise = shutdownDev(this, reason);
+        return this.stopPromise;
+    }
+    async drain(previous, activeToken) {
+        await drainCandidate(this, previous, activeToken);
+    }
+    get active() {
+        return this.activeCandidate;
+    }
+    set active(candidate) {
+        this.activeCandidate = candidate;
+    }
+    get activeGraphHash() {
+        return this.activeHash;
+    }
+    set activeGraphHash(value) {
+        this.activeHash = value;
+    }
+    get isStopping() {
+        return this.stopping;
+    }
+    markStopping() {
+        this.stopping = true;
+    }
+    get pendingActivations() {
+        return this.activationTail;
+    }
+    get inspectorChild() {
+        return this.inspector;
+    }
+    clearSignals() {
+        this.removeSignals?.();
+        this.removeSignals = undefined;
+    }
+    resolveShutdownPromise() {
+        this.resolveShutdown();
+    }
+}
+//# sourceMappingURL=dev-session.js.map

package/dist/commands/dev-session.js.map

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

package/dist/commands/dev-shutdown.d.ts

@@ -0,0 +1,3 @@
+import type { DevSession } from "./dev-session.js";
+export declare function shutdownDev(session: DevSession, reason: unknown): Promise<void>;
+//# sourceMappingURL=dev-shutdown.d.ts.map

package/dist/commands/dev-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-shutdown.d.ts","sourceRoot":"","sources":["../../src/commands/dev-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBrF"}

package/dist/commands/dev-shutdown.js

@@ -0,0 +1,26 @@
+export async function shutdownDev(session, reason) {
+    session.markStopping();
+    session.log({
+        level: "info",
+        event: "dev.shutdown.started",
+        fields: { message: errorMessage(reason) },
+    });
+    session.abortController.abort(reason);
+    for (const controller of session.controllers)
+        controller.abort(reason);
+    await session.proxy.stop().catch(() => undefined);
+    const tasks = [
+        session.inspectorChild?.stop(),
+        session.inspectorChild?.output,
+        session.pendingActivations,
+        ...[...session.drains.values()].map((drain) => drain.drain()),
+    ].filter((task) => task !== undefined);
+    await Promise.allSettled(tasks);
+    await session.observability.flush().catch(() => undefined);
+    session.clearSignals();
+    session.resolveShutdownPromise();
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dev-shutdown.js.map

package/dist/commands/dev-shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-shutdown.js","sourceRoot":"","sources":["../../src/commands/dev-shutdown.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAmB,EAAE,MAAe;IACpE,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC;QACV,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,sBAAsB;QAC7B,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE;KAC1C,CAAC,CAAC;IACH,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtC,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,WAAW;QAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE;QAC9B,OAAO,CAAC,cAAc,EAAE,MAAM;QAC9B,OAAO,CAAC,kBAAkB;QAC1B,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;KAC9D,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvC,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,CAAC,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,sBAAsB,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/commands/dev-signals.d.ts

@@ -0,0 +1,3 @@
+import type { DevLog, DevOptions } from "./dev.js";
+export declare function installDevSignals(options: DevOptions, log: DevLog, stop: (reason: unknown) => void | Promise<void>): () => void;
+//# sourceMappingURL=dev-signals.d.ts.map

package/dist/commands/dev-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-signals.d.ts","sourceRoot":"","sources":["../../src/commands/dev-signals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEnD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9C,MAAM,IAAI,CAgCZ"}

package/dist/commands/dev-signals.js

@@ -0,0 +1,35 @@
+export function installDevSignals(options, log, stop) {
+    let processHandlers;
+    let abortHandler;
+    if (options.installSignalHandlers !== false) {
+        const handle = (signal) => {
+            log({ level: "info", event: "dev.shutdown.requested", fields: { signal } });
+            void stop(new Error(`Received ${signal}.`));
+        };
+        const sigint = () => handle("SIGINT");
+        const sigterm = () => handle("SIGTERM");
+        const sighup = () => handle("SIGHUP");
+        processHandlers = [sigint, sigterm, sighup];
+        process.on("SIGINT", sigint);
+        process.on("SIGTERM", sigterm);
+        process.on("SIGHUP", sighup);
+    }
+    if (options.signal !== undefined) {
+        if (options.signal.aborted)
+            void stop(options.signal.reason);
+        else {
+            abortHandler = () => void stop(options.signal?.reason);
+            options.signal.addEventListener("abort", abortHandler, { once: true });
+        }
+    }
+    return () => {
+        if (processHandlers !== undefined) {
+            process.removeListener("SIGINT", processHandlers[0]);
+            process.removeListener("SIGTERM", processHandlers[1]);
+            process.removeListener("SIGHUP", processHandlers[2]);
+        }
+        if (options.signal !== undefined && abortHandler !== undefined)
+            options.signal.removeEventListener("abort", abortHandler);
+    };
+}
+//# sourceMappingURL=dev-signals.js.map

package/dist/commands/dev-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-signals.js","sourceRoot":"","sources":["../../src/commands/dev-signals.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAC/B,OAAmB,EACnB,GAAW,EACX,IAA+C;IAE/C,IAAI,eAA0E,CAAC;IAC/E,IAAI,YAAsC,CAAC;IAC3C,IAAI,OAAO,CAAC,qBAAqB,KAAK,KAAK,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,CAAC,MAAuC,EAAQ,EAAE;YAC/D,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YAC5E,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,YAAY,MAAM,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;YAAE,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;aACxD,CAAC;YACJ,YAAY,GAAG,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvD,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,EAAE;QACV,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS;YAC5D,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/dev-watch.d.ts

@@ -0,0 +1,7 @@
+import type { DevSession } from "./dev-session.js";
+export interface DevSourceWatcher {
+    readonly close: () => void;
+}
+/** Connects project source events to the session's last-known-good activator. */
+export declare function startDevSourceWatcher(session: DevSession): DevSourceWatcher;
+//# sourceMappingURL=dev-watch.d.ts.map

package/dist/commands/dev-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-watch.d.ts","sourceRoot":"","sources":["../../src/commands/dev-watch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAuB3E"}

package/dist/commands/dev-watch.js

@@ -0,0 +1,33 @@
+import { existsSync, watch } from "node:fs";
+import { join, relative } from "node:path";
+import { createSupervisorWatcher } from "@relkit/supervisor";
+/** Connects project source events to the session's last-known-good activator. */
+export function startDevSourceWatcher(session) {
+    const sourceRoot = existsSync(join(session.projectRoot, "src"))
+        ? join(session.projectRoot, "src")
+        : session.projectRoot;
+    let version = 1;
+    const supervisor = createSupervisorWatcher({
+        debounceMs: 75,
+        compile: ({ version: nextVersion, changedFiles }) => session.notifySourceChange(nextVersion, changedFiles).then(() => undefined),
+    });
+    const fileWatcher = watch(sourceRoot, { recursive: true }, (_event, filename) => {
+        if (filename === null)
+            return;
+        const changedFile = relative(session.projectRoot, join(sourceRoot, filename.toString()));
+        if (ignored(changedFile))
+            return;
+        supervisor.notify({ version: version++, changedFiles: [changedFile] });
+    });
+    fileWatcher.on("error", () => undefined);
+    return {
+        close: () => {
+            fileWatcher.close();
+            supervisor.dispose();
+        },
+    };
+}
+function ignored(file) {
+    return file === "" || file.startsWith("node_modules/") || file.startsWith(".relkit/");
+}
+//# sourceMappingURL=dev-watch.js.map

package/dist/commands/dev-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-watch.js","sourceRoot":"","sources":["../../src/commands/dev-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAO7D,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,OAAmB;IACvD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC7D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACxB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,UAAU,GAAG,uBAAuB,CAAC;QACzC,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,CAClD,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;KAC9E,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE;QAC9E,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO;QAC9B,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACzF,IAAI,OAAO,CAAC,WAAW,CAAC;YAAE,OAAO;QACjC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO;QACL,KAAK,EAAE,GAAG,EAAE;YACV,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACxF,CAAC"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,36 @@
+import type { LoggerOptions } from "@relkit/runtime-effect";
+import type { CandidateCompile, StartedCandidate, SupervisorObservabilityOptions } from "@relkit/supervisor";
+import { DevSession } from "./dev-session.js";
+import type { DevInspectorOptions } from "./dev-process.js";
+export interface DevLogEvent {
+    readonly level: "info" | "warn" | "error";
+    readonly event: string;
+    readonly fields?: Readonly<Record<string, string | number | boolean>>;
+}
+export type DevLog = (event: DevLogEvent) => void;
+export type DevGraphHash = string | ((candidate: StartedCandidate) => string | PromiseLike<string>);
+export interface DevOptions {
+    readonly projectRoot?: string;
+    readonly compile: CandidateCompile;
+    readonly graphHash?: DevGraphHash;
+    readonly hostname?: string;
+    readonly candidateHostname?: string;
+    readonly stablePort?: number;
+    readonly generatedDirectory?: string;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly maxStartupOutputBytes?: number;
+    readonly candidateStopTimeoutMs?: number;
+    readonly healthTimeoutMs?: number;
+    readonly drainTimeoutMs?: number;
+    readonly inspector?: DevInspectorOptions | false;
+    readonly spawn?: typeof Bun.spawn;
+    readonly signal?: AbortSignal;
+    readonly installSignalHandlers?: boolean;
+    readonly logger?: Omit<LoggerOptions, "component">;
+    readonly onLog?: DevLog;
+    readonly observability?: Omit<SupervisorObservabilityOptions, "graphHash">;
+}
+export { DevSession } from "./dev-session.js";
+export declare function startDev(options: DevOptions): Promise<DevSession>;
+export declare function runDev(options: DevOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CACvE;AACD,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,gBAAgB,KAAK,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAEpG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,8BAA8B,EAAE,WAAW,CAAC,CAAC;CAC5E;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,wBAAsB,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAEvE;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/D"}

package/dist/commands/dev.js

@@ -0,0 +1,10 @@
+import { DevSession } from "./dev-session.js";
+export { DevSession } from "./dev-session.js";
+export async function startDev(options) {
+    return new DevSession(options).start();
+}
+export async function runDev(options) {
+    const session = await startDev(options);
+    await session.waitForShutdown();
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAiC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAmB;IAChD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAmB;IAC9C,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,OAAO,CAAC,eAAe,EAAE,CAAC;AAClC,CAAC"}

package/dist/commands/doctor-checks.d.ts

@@ -0,0 +1,13 @@
+import type { LoadedToolingConfig } from "@relkit/compiler";
+import type { DoctorCheck, DoctorOptions } from "./doctor-support.js";
+export declare function checkPulumi(enabled: boolean, root: string, runner?: typeof runCommand): Promise<DoctorCheck>;
+export declare function checkAws(enabled: boolean, source: Readonly<Record<string, string | undefined>>): DoctorCheck;
+export declare function checkRoots(root: string): Promise<DoctorCheck>;
+export declare function checkPorts(config: LoadedToolingConfig | undefined, options: DoctorOptions, probe: (port: number) => Promise<boolean>): Promise<DoctorCheck>;
+export declare function checkLockfile(root: string, runner?: typeof runCommand): Promise<DoctorCheck>;
+export declare function availablePort(port: number): Promise<boolean>;
+declare function runCommand(command: readonly string[], cwd: string): Promise<{
+    readonly exitCode: number;
+}>;
+export {};
+//# sourceMappingURL=doctor-checks.d.ts.map

package/dist/commands/doctor-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-checks.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-checks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGtE,wBAAsB,WAAW,CAC/B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,oBAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAatB;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GACnD,WAAW,CAsBb;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6BnE;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACxC,OAAO,CAAC,WAAW,CAAC,CAoCtB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,oBAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAa3F;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQlE;AACD,iBAAe,UAAU,CACvB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAGxC"}

package/dist/commands/doctor-checks.js

@@ -0,0 +1,132 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { resolveApplicationPort, resolveInspectorPort } from "./ports.js";
+export async function checkPulumi(enabled, root, runner = runCommand) {
+    if (!enabled)
+        return { name: "pulumi", ok: true, message: "Pulumi check skipped; deployment is disabled." };
+    const executable = Bun.which("pulumi");
+    if (executable === null)
+        return { name: "pulumi", ok: false, message: "Pulumi CLI is not available." };
+    const result = await runner([executable, "version", "--client-only"], root);
+    return {
+        name: "pulumi",
+        ok: result.exitCode === 0,
+        message: result.exitCode === 0 ? "Pulumi CLI is available." : "Pulumi CLI could not be invoked.",
+    };
+}
+export function checkAws(enabled, source) {
+    if (!enabled)
+        return {
+            name: "aws-credentials",
+            ok: true,
+            message: "AWS credential check skipped; deployment is disabled.",
+        };
+    const groups = [
+        ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"],
+        ["AWS_PROFILE"],
+        ["AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN"],
+        ["AWS_CONTAINER_CREDENTIALS_RELATIVE_URI"],
+        ["AWS_CONTAINER_CREDENTIALS_FULL_URI"],
+    ];
+    const visible = groups.find((group) => group.every((name) => Boolean(source[name])));
+    return {
+        name: "aws-credentials",
+        ok: visible !== undefined,
+        message: visible === undefined ? "AWS credentials are not visible." : "AWS credentials are visible.",
+        details: { sources: visible ?? [] },
+    };
+}
+export async function checkRoots(root) {
+    const paths = [
+        ".relkit",
+        ".relkit/generated",
+        ".relkit/build",
+        ".relkit/state",
+        ".relkit/observability",
+    ].map((path) => join(root, path));
+    const failures = [];
+    for (const path of paths) {
+        const marker = join(path, `.doctor-${crypto.randomUUID()}`);
+        try {
+            await mkdir(path, { recursive: true });
+            await writeFile(marker, "");
+        }
+        catch {
+            failures.push(path);
+        }
+        finally {
+            await rm(marker, { force: true }).catch(() => undefined);
+        }
+    }
+    return {
+        name: "relkit-roots",
+        ok: failures.length === 0,
+        message: failures.length === 0
+            ? ".relkit roots are writable."
+            : "One or more .relkit roots are not writable.",
+        ...(failures.length === 0 ? {} : { details: { failed: failures } }),
+    };
+}
+export async function checkPorts(config, options, probe) {
+    let backend;
+    let inspector;
+    try {
+        const source = options.source ?? process.env;
+        backend = resolveApplicationPort({
+            ...(options.backendPort === undefined ? {} : { flag: options.backendPort }),
+            source,
+            ...(config === undefined ? {} : { configured: config.server.port }),
+        });
+        inspector = resolveInspectorPort({
+            ...(options.inspectorPort === undefined ? {} : { flag: options.inspectorPort }),
+            source,
+            ...(config === undefined ? {} : { configured: config.inspector.port }),
+        });
+    }
+    catch (error) {
+        return {
+            name: "ports",
+            ok: false,
+            message: error instanceof Error ? error.message : "Configured ports are invalid.",
+        };
+    }
+    if (backend === inspector)
+        return {
+            name: "ports",
+            ok: false,
+            message: "Configured backend and inspector ports collide.",
+            details: { backend, inspector },
+        };
+    const ok = (await probe(backend)) && (await probe(inspector));
+    return {
+        name: "ports",
+        ok,
+        message: ok ? "Configured ports are available." : "A configured port is unavailable.",
+        details: { backend, inspector },
+    };
+}
+export async function checkLockfile(root, runner = runCommand) {
+    const result = await runner([process.execPath, "install", "--frozen-lockfile", "--dry-run"], root);
+    return {
+        name: "lockfile",
+        ok: result.exitCode === 0,
+        message: result.exitCode === 0
+            ? "Frozen lockfile is consistent."
+            : "Frozen lockfile consistency check failed.",
+    };
+}
+export async function availablePort(port) {
+    try {
+        const server = Bun.serve({ hostname: "127.0.0.1", port, fetch: () => new Response() });
+        await server.stop(true);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function runCommand(command, cwd) {
+    const child = Bun.spawn([...command], { cwd, stdout: "ignore", stderr: "ignore" });
+    return { exitCode: await child.exited };
+}
+//# sourceMappingURL=doctor-checks.js.map

package/dist/commands/doctor-checks.js.map

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

package/dist/commands/doctor-compat.d.ts

@@ -0,0 +1,7 @@
+import type { DoctorCheck } from "./doctor-support.js";
+export type PackageJson = Record<string, any>;
+export declare function readJson(path: string): Promise<PackageJson | undefined>;
+export declare function versionChecks(manifest: PackageJson | undefined, root: string): Promise<DoctorCheck[]>;
+export declare function detectDeployment(manifest: PackageJson | undefined, config: unknown): boolean;
+export declare function isAppDescriptor(value: unknown): boolean;
+//# sourceMappingURL=doctor-compat.d.ts.map

package/dist/commands/doctor-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-compat.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-compat.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE9C,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAO7E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,EAAE,CAAC,CA+BxB;AA0CD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAW5F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIvD"}