@usine/server 0.2.1 → 0.4.0

package/dist/instance/ports.js.map

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

package/dist/instance/record.d.ts

@@ -0,0 +1,82 @@
+import { Effect, FileSystem, Option, Schema } from "effect";
+import { type UpCommand } from "../cli.ts";
+/** An operating system process ID. */
+export declare const ProcessId: Schema.brand<Schema.Int, "ProcessId">;
+export type ProcessId = typeof ProcessId.Type;
+declare const InstanceLaunch_base: Schema.Class<InstanceLaunch, Schema.Struct<{
+    /** The Node.js binary, from `process.execPath`. */
+    readonly node: Schema.NonEmptyString;
+    /** The Node.js options, from `process.execArgv`. */
+    readonly nodeOptions: Schema.$Array<Schema.String>;
+    /** The CLI entry point, from `process.argv[1]`. */
+    readonly script: Schema.NonEmptyString;
+    readonly port: Schema.brand<Schema.Int, "ServerPort">;
+    /** The origin of `--origin`, which a record omits without one. */
+    readonly origin: Schema.withConstructorDefault<Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "UiOrigin">>>;
+    /** Decodes as `Info` from a record that a `usine up` without `--log-level` wrote. */
+    readonly logLevel: Schema.withDecodingDefaultKey<Schema.Literals<readonly ["Trace", "Debug", "Info", "Warn", "Error"]>, never>;
+    readonly allowVolatileInstance: Schema.Boolean;
+}>, {}>;
+/** The command that started a `usine up`, which `usine restart` runs again. */
+export declare class InstanceLaunch extends InstanceLaunch_base {
+}
+/**
+ * Returns how this process was started with the settings of `command`. Dies without
+ * `process.argv[1]`, which a CLI always has.
+ */
+export declare const currentLaunch: ({ port, origin, logLevel, allowVolatileInstance }: UpCommand) => Effect.Effect<InstanceLaunch, never, never>;
+declare const InstanceRecord_base: Schema.Class<InstanceRecord, Schema.Struct<{
+    readonly pid: Schema.brand<Schema.Int, "ProcessId">;
+    /** The `@usine/server` version of the process. */
+    readonly version: Schema.NonEmptyString;
+    readonly startedAt: Schema.DateTimeUtcFromString;
+    readonly launch: typeof InstanceLaunch;
+    /**
+     * The systemd service whose cgroup the process is in, which a record omits outside one. The CLI
+     * stops and starts the service with `systemctl` if systemd reports the process as its main one.
+     */
+    readonly systemdUnit: Schema.withConstructorDefault<Schema.OptionFromOptionalKey<Schema.brand<Schema.String, "SystemdUnit">>>;
+    /** When the process received its first `SIGINT` or `SIGTERM`. */
+    readonly stoppingSince: Schema.optionalKey<Schema.DateTimeUtcFromString>;
+}>, {}>;
+/**
+ * The running `usine up` of an instance folder, as written to `.usine/instance.json`. A newer CLI
+ * reads the record that an older engine wrote, so a field added after the first version decodes
+ * with a default.
+ */
+export declare class InstanceRecord extends InstanceRecord_base {
+}
+declare const InstanceRecordError_base: Schema.Class<InstanceRecordError, Schema.TaggedStruct<"InstanceRecordError", {
+    readonly path: Schema.String;
+    readonly reason: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** `.usine/instance.json` exists but doesn't decode as an `InstanceRecord`. */
+export declare class InstanceRecordError extends InstanceRecordError_base {
+}
+/** The files that a `usine up` keeps in the instance's `.usine` folder. */
+export interface InstanceFiles {
+    readonly folder: string;
+    readonly lock: string;
+    /** The process ID alone, for shell use such as `kill -HUP "$(cat .usine/instance.pid)"`. */
+    readonly pid: string;
+    readonly record: string;
+    /** The output of an instance that `usine up --detach` or `usine restart` started. */
+    readonly log: string;
+    readonly backups: string;
+    /** The instance's ID, which every `usine up` of the folder reuses. */
+    readonly id: string;
+}
+export declare const instanceFiles: (directory: string) => InstanceFiles;
+/**
+ * Writes the record through a temporary file and a rename, so that readers never see a partial
+ * file.
+ */
+export declare const writeRecord: (files: InstanceFiles, record: InstanceRecord) => Effect.Effect<void, import("effect/PlatformError").PlatformError, FileSystem.FileSystem>;
+/** Records `stoppingSince` synchronously, for use in a signal listener. Throws on failure. */
+export declare const markStoppingSync: (files: InstanceFiles, record: InstanceRecord) => void;
+/** Reads `.usine/instance.json`, or returns `None` if it doesn't exist. */
+export declare const readRecord: (files: InstanceFiles) => Effect.Effect<Option.Option<InstanceRecord>, InstanceRecordError, FileSystem.FileSystem>;
+/** Reads the process ID in `.usine/instance.pid`, or returns `None` if it's absent or invalid. */
+export declare const readPid: (files: InstanceFiles) => Effect.Effect<Option.Option<number & import("effect/Brand").Brand<"ProcessId">>, never, FileSystem.FileSystem>;
+export {};
+//# sourceMappingURL=record.d.ts.map

package/dist/instance/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/instance/record.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAqC,KAAK,SAAS,EAAc,MAAM,WAAW,CAAC;AAG1F,sCAAsC;AACtC,eAAO,MAAM,SAAS,uCAA4E,CAAC;AACnG,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;;IAI5C,mDAAmD;;IAEnD,oDAAoD;;IAEpD,mDAAmD;;;IAGnD,kEAAkE;;IAIlE,qFAAqF;;;;AAbvF,+EAA+E;AAC/E,qBAAa,cAAe,SAAQ,mBAelC;CAAG;AAEL;;;GAGG;AACH,eAAO,MAAM,aAAa,sDAAuD,SAAS,gDAevF,CAAC;;;IASF,kDAAkD;;;;IAIlD;;;OAGG;;IAIH,iEAAiE;;;AAlBnE;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,mBAelC;CAAG;;;;;AAEL,+EAA+E;AAC/E,qBAAa,mBAAoB,SAAQ,wBAE+B;CAAG;AAE3E,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,cAAe,MAAM,KAAG,aAWjD,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,WAAW,4IAQtB,CAAC;AAEH,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,UAAW,aAAa,UAAU,cAAc,KAAG,IAY/E,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,UAAU,oHAcrB,CAAC;AAOH,kGAAkG;AAClG,eAAO,MAAM,OAAO,0IAMlB,CAAC"}

package/dist/instance/record.js

@@ -0,0 +1,116 @@
+import { renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { DateTime, Effect, FileSystem, Option, Schema } from "effect";
+import { DEFAULT_LOG_LEVEL, Port, UiOrigin, UpLogLevel } from "../cli.js";
+import { SystemdUnit } from "./systemd.js";
+/** An operating system process ID. */
+export const ProcessId = Schema.Int.check(Schema.isGreaterThan(0)).pipe(Schema.brand("ProcessId"));
+/** The command that started a `usine up`, which `usine restart` runs again. */
+export class InstanceLaunch extends Schema.Class("@usine/server/InstanceLaunch")({
+    /** The Node.js binary, from `process.execPath`. */
+    node: Schema.NonEmptyString,
+    /** The Node.js options, from `process.execArgv`. */
+    nodeOptions: Schema.Array(Schema.String),
+    /** The CLI entry point, from `process.argv[1]`. */
+    script: Schema.NonEmptyString,
+    port: Port,
+    /** The origin of `--origin`, which a record omits without one. */
+    origin: Schema.OptionFromOptionalKey(UiOrigin).pipe(Schema.withConstructorDefault(Effect.succeed(Option.none()))),
+    /** Decodes as `Info` from a record that a `usine up` without `--log-level` wrote. */
+    logLevel: UpLogLevel.pipe(Schema.withDecodingDefaultKey(Effect.succeed(DEFAULT_LOG_LEVEL))),
+    allowVolatileInstance: Schema.Boolean,
+}) {
+}
+/**
+ * Returns how this process was started with the settings of `command`. Dies without
+ * `process.argv[1]`, which a CLI always has.
+ */
+export const currentLaunch = ({ port, origin, logLevel, allowVolatileInstance }) => Schema.decodeUnknownEffect(Schema.NonEmptyString)(process.argv[1]).pipe(Effect.map((script) => new InstanceLaunch({
+    node: process.execPath,
+    nodeOptions: process.execArgv,
+    script,
+    port,
+    origin,
+    logLevel,
+    allowVolatileInstance,
+})), Effect.orDie);
+/**
+ * The running `usine up` of an instance folder, as written to `.usine/instance.json`. A newer CLI
+ * reads the record that an older engine wrote, so a field added after the first version decodes
+ * with a default.
+ */
+export class InstanceRecord extends Schema.Class("@usine/server/InstanceRecord")({
+    pid: ProcessId,
+    /** The `@usine/server` version of the process. */
+    version: Schema.NonEmptyString,
+    startedAt: Schema.DateTimeUtcFromString,
+    launch: InstanceLaunch,
+    /**
+     * The systemd service whose cgroup the process is in, which a record omits outside one. The CLI
+     * stops and starts the service with `systemctl` if systemd reports the process as its main one.
+     */
+    systemdUnit: Schema.OptionFromOptionalKey(SystemdUnit).pipe(Schema.withConstructorDefault(Effect.succeed(Option.none()))),
+    /** When the process received its first `SIGINT` or `SIGTERM`. */
+    stoppingSince: Schema.optionalKey(Schema.DateTimeUtcFromString),
+}) {
+}
+/** `.usine/instance.json` exists but doesn't decode as an `InstanceRecord`. */
+export class InstanceRecordError extends Schema.TaggedError("@usine/server/InstanceRecordError")("InstanceRecordError", { path: Schema.String, reason: Schema.String }) {
+}
+export const instanceFiles = (directory) => {
+    const folder = join(directory, ".usine");
+    return {
+        folder,
+        lock: join(folder, "instance.lock"),
+        pid: join(folder, "instance.pid"),
+        record: join(folder, "instance.json"),
+        log: join(folder, "usine.log"),
+        backups: join(folder, "backups"),
+        id: join(folder, "instance-id"),
+    };
+};
+const encodeRecord = (record) => `${JSON.stringify(Schema.encodeSync(InstanceRecord)(record), null, 2)}\n`;
+const RecordFromJson = Schema.fromJsonString(InstanceRecord);
+/**
+ * Writes the record through a temporary file and a rename, so that readers never see a partial
+ * file.
+ */
+export const writeRecord = Effect.fn("Instance.writeRecord")(function* (files, record) {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const staging = `${files.record}.${record.pid}`;
+    yield* fileSystem.writeFileString(staging, encodeRecord(record), { mode: 0o600 });
+    yield* fileSystem.rename(staging, files.record);
+});
+/** Records `stoppingSince` synchronously, for use in a signal listener. Throws on failure. */
+export const markStoppingSync = (files, record) => {
+    const staging = `${files.record}.${record.pid}`;
+    const stopping = new InstanceRecord({
+        pid: record.pid,
+        version: record.version,
+        startedAt: record.startedAt,
+        launch: record.launch,
+        systemdUnit: record.systemdUnit,
+        stoppingSince: DateTime.nowUnsafe(),
+    });
+    writeFileSync(staging, encodeRecord(stopping), { mode: 0o600 });
+    renameSync(staging, files.record);
+};
+/** Reads `.usine/instance.json`, or returns `None` if it doesn't exist. */
+export const readRecord = Effect.fn("Instance.readRecord")(function* (files) {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const failure = (reason) => new InstanceRecordError({ path: files.record, reason });
+    if (!(yield* fileSystem.exists(files.record).pipe(Effect.mapError((e) => failure(e.message))))) {
+        return Option.none();
+    }
+    const text = yield* fileSystem
+        .readFileString(files.record)
+        .pipe(Effect.mapError((error) => failure(error.message)));
+    return Option.some(yield* Schema.decodeUnknownEffect(RecordFromJson)(text).pipe(Effect.mapError((error) => failure(error.message))));
+});
+const PidFromText = Schema.Trim.pipe(Schema.decodeTo(Schema.NumberFromString), Schema.decodeTo(ProcessId));
+/** Reads the process ID in `.usine/instance.pid`, or returns `None` if it's absent or invalid. */
+export const readPid = Effect.fn("Instance.readPid")(function* (files) {
+    const fileSystem = yield* FileSystem.FileSystem;
+    return yield* fileSystem.readFileString(files.pid).pipe(Effect.map(Schema.decodeUnknownOption(PidFromText)), Effect.orElseSucceed(() => Option.none()));
+});
+//# sourceMappingURL=record.js.map

package/dist/instance/record.js.map

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

package/dist/instance/state.d.ts

@@ -0,0 +1,45 @@
+import { Effect, Schema } from "effect";
+import { InstanceRecord, ProcessId } from "./record.ts";
+declare const Stopped_base: Schema.Class<Stopped, Schema.TaggedStruct<"Stopped", {
+    /** The PID that a process left in `.usine/` when it didn't exit cleanly. */
+    readonly stale: Schema.Option<Schema.brand<Schema.Int, "ProcessId">>;
+}>, {}>;
+/** No process holds the instance lock. */
+export declare class Stopped extends Stopped_base {
+}
+declare const Running_base: Schema.Class<Running, Schema.TaggedStruct<"Running", {
+    readonly record: typeof InstanceRecord;
+}>, {}>;
+/** A live process holds the instance lock, and its record names it. */
+export declare class Running extends Running_base {
+}
+declare const Unrecorded_base: Schema.Class<Unrecorded, Schema.TaggedStruct<"Unrecorded", {
+    readonly pid: Schema.Option<Schema.brand<Schema.Int, "ProcessId">>;
+}>, {}>;
+/**
+ * A process holds the instance lock without a record of a live process: a usine version that
+ * writes only `.usine/instance.pid`, or a process that is still starting.
+ */
+export declare class Unrecorded extends Unrecorded_base {
+}
+export declare const InstanceState: Schema.Union<readonly [typeof Stopped, typeof Running, typeof Unrecorded]>;
+export type InstanceState = typeof InstanceState.Type;
+declare const SignalError_base: Schema.Class<SignalError, Schema.TaggedStruct<"SignalError", {
+    readonly pid: Schema.brand<Schema.Int, "ProcessId">;
+    readonly signal: Schema.String;
+    readonly reason: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The process couldn't be signaled, for example because another user owns it. */
+export declare class SignalError extends SignalError_base {
+}
+/** Returns whether a process with the PID exists, including one that another user owns. */
+export declare const processAlive: (pid: ProcessId) => Effect.Effect<boolean, never, never>;
+/** Sends `signal` to the process. Succeeds if the process has already exited. */
+export declare const signalProcess: (pid: number & import("effect/Brand").Brand<"ProcessId">, signal: "SIGKILL" | "SIGTERM") => Effect.Effect<void, SignalError, never>;
+/**
+ * Reads whether `usine up` runs in the instance folder. The instance lock decides whether a process
+ * runs, so a PID that the OS reused for another process never counts.
+ */
+export declare const probeInstance: (directory: string & import("effect/Brand").Brand<"InstanceDirectory">) => Effect.Effect<Running | Stopped | Unrecorded, import("./lock.ts").InstanceLockError, import("effect/FileSystem").FileSystem>;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/instance/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/instance/state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAsC,MAAM,aAAa,CAAC;;IAMxF,4EAA4E;;;AAJhF,0CAA0C;AAC1C,qBAAa,OAAQ,SAAQ,YAM5B;CAAG;;;;AAEJ,uEAAuE;AACvE,qBAAa,OAAQ,SAAQ,YAG5B;CAAG;;;;AAEJ;;;GAGG;AACH,qBAAa,UAAW,SAAQ,eAG/B;CAAG;AAEJ,eAAO,MAAM,aAAa,4EAA+C,CAAC;AAC1E,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;;;;;;AAEtD,kFAAkF;AAClF,qBAAa,WAAY,SAAQ,gBAGhC;CAAG;AAIJ,2FAA2F;AAC3F,eAAO,MAAM,YAAY,QAAS,SAAS,yCAQvC,CAAC;AAEL,iFAAiF;AACjF,eAAO,MAAM,aAAa,qIAwBxB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,yMAoBxB,CAAC"}

package/dist/instance/state.js

@@ -0,0 +1,79 @@
+import { Effect, Option, Schema } from "effect";
+import { lockHeld } from "./lock.js";
+import { InstanceRecord, ProcessId, instanceFiles, readPid, readRecord } from "./record.js";
+/** No process holds the instance lock. */
+export class Stopped extends Schema.TaggedClass("@usine/server/InstanceStopped")("Stopped", {
+    /** The PID that a process left in `.usine/` when it didn't exit cleanly. */
+    stale: Schema.Option(ProcessId),
+}) {
+}
+/** A live process holds the instance lock, and its record names it. */
+export class Running extends Schema.TaggedClass("@usine/server/InstanceRunning")("Running", { record: InstanceRecord }) {
+}
+/**
+ * A process holds the instance lock without a record of a live process: a usine version that
+ * writes only `.usine/instance.pid`, or a process that is still starting.
+ */
+export class Unrecorded extends Schema.TaggedClass("@usine/server/InstanceUnrecorded")("Unrecorded", { pid: Schema.Option(ProcessId) }) {
+}
+export const InstanceState = Schema.Union([Stopped, Running, Unrecorded]);
+/** The process couldn't be signaled, for example because another user owns it. */
+export class SignalError extends Schema.TaggedError("@usine/server/SignalError")("SignalError", { pid: ProcessId, signal: Schema.String, reason: Schema.String }) {
+}
+const NoSuchProcess = Schema.Struct({ code: Schema.Literal("ESRCH") });
+/** Returns whether a process with the PID exists, including one that another user owns. */
+export const processAlive = (pid) => Effect.sync(() => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (cause) {
+        return !Schema.is(NoSuchProcess)(cause);
+    }
+});
+/** Sends `signal` to the process. Succeeds if the process has already exited. */
+export const signalProcess = Effect.fn("Instance.signal")(function* (pid, signal) {
+    yield* Effect.annotateCurrentSpan({ pid, signal });
+    const sent = yield* Effect.try({
+        try: () => {
+            try {
+                return process.kill(pid, signal);
+            }
+            catch (cause) {
+                if (Schema.is(NoSuchProcess)(cause))
+                    return false;
+                throw cause;
+            }
+        },
+        catch: (cause) => new SignalError({
+            pid,
+            signal,
+            reason: cause instanceof Error ? cause.message : String(cause),
+        }),
+    });
+    yield* sent
+        ? Effect.logInfo("Sent a signal to the instance process", { pid, signal })
+        : Effect.logInfo("The instance process exited before the signal", { pid, signal });
+});
+/**
+ * Reads whether `usine up` runs in the instance folder. The instance lock decides whether a process
+ * runs, so a PID that the OS reused for another process never counts.
+ */
+export const probeInstance = Effect.fn("Instance.probe")(function* (directory) {
+    const files = instanceFiles(directory);
+    const record = yield* readRecord(files).pipe(Effect.catchTag("InstanceRecordError", (error) => Effect.logWarning("The instance record is unreadable; it is ignored", {
+        path: error.path,
+        reason: error.reason,
+    }).pipe(Effect.as(Option.none()))));
+    if (!(yield* lockHeld(files))) {
+        const stale = Option.isSome(record) ? Option.some(record.value.pid) : yield* readPid(files);
+        return new Stopped({ stale });
+    }
+    if (Option.isSome(record) && (yield* processAlive(record.value.pid))) {
+        return new Running({ record: record.value });
+    }
+    const pid = yield* readPid(files);
+    const live = Option.isSome(pid) && (yield* processAlive(pid.value)) ? pid : Option.none();
+    return new Unrecorded({ pid: live });
+});
+//# sourceMappingURL=state.js.map

package/dist/instance/state.js.map

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

package/dist/instance/systemd.d.ts

@@ -0,0 +1,36 @@
+import { Effect, FileSystem, Option, Schema } from "effect";
+/** A service of the systemd system manager, such as `usine.service`. */
+export declare const SystemdUnit: Schema.brand<Schema.String, "SystemdUnit">;
+export type SystemdUnit = typeof SystemdUnit.Type;
+/**
+ * Returns the system service in the contents of `/proc/<pid>/cgroup`, or `None` for a process
+ * outside one, such as in a login session or under a user's service manager.
+ */
+export declare const systemServiceOf: (cgroup: string) => Option.Option<SystemdUnit>;
+/**
+ * Returns the system service whose cgroup this process is in, or `None` outside one and on systems
+ * without `/proc`.
+ */
+export declare const currentSystemService: () => Effect.Effect<Option.Option<string & import("effect/Brand").Brand<"SystemdUnit">>, never, FileSystem.FileSystem>;
+declare const SystemctlError_base: Schema.Class<SystemctlError, Schema.TaggedStruct<"SystemctlError", {
+    readonly command: Schema.String;
+    readonly unit: Schema.brand<Schema.String, "SystemdUnit">;
+    readonly reason: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** `systemctl` couldn't run, or exited with a non-zero status. */
+export declare class SystemctlError extends SystemctlError_base {
+}
+/** Runs `systemctl <args> <unit>` and returns its standard output. */
+export declare const systemctl: (unit: SystemdUnit, args: ReadonlyArray<string>) => Effect.Effect<string, SystemctlError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+/**
+ * Returns `unit` if systemd reports `pid` as its main process, or `None` without a unit or if
+ * the unit's main process is another one, as for a `usine up` that a service's script started.
+ */
+export declare const supervisingUnit: (pid: number & import("effect/Brand").Brand<"ProcessId">, unit: Option.Option<string & import("effect/Brand").Brand<"SystemdUnit">>) => Effect.Effect<Option.Option<string & import("effect/Brand").Brand<"SystemdUnit">>, SystemctlError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+/** Returns the state of `unit` from `systemctl show`. */
+export declare const unitState: (unit: string & import("effect/Brand").Brand<"SystemdUnit">) => Effect.Effect<{
+    active: string;
+    sub: string;
+}, SystemctlError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
+export {};
+//# sourceMappingURL=systemd.d.ts.map

package/dist/instance/systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../../src/instance/systemd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAM5D,wEAAwE;AACxE,eAAO,MAAM,WAAW,4CAEW,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAC;AAMlD;;;GAGG;AACH,eAAO,MAAM,eAAe,WAAY,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAIvE,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,oBAAoB,wHAe/B,CAAC;;;;;;AAEH,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,mBAEqD;CAAG;AAE5F,sEAAsE;AACtE,eAAO,MAAM,SAAS,SAAU,WAAW,QAAQ,aAAa,CAAC,MAAM,CAAC,4GAIrE,CAAC;AAOJ;;;GAGG;AACH,eAAO,MAAM,eAAe,8SAe1B,CAAC;AAQH,yDAAyD;AACzD,eAAO,MAAM,SAAS;;;oFAapB,CAAC"}

package/dist/instance/systemd.js

@@ -0,0 +1,61 @@
+import { Effect, FileSystem, Option, Schema } from "effect";
+import { runCommand } from "../command.js";
+const SYSTEMCTL_TIMEOUT = "30 seconds";
+/** A service of the systemd system manager, such as `usine.service`. */
+export const SystemdUnit = Schema.String.check(Schema.isPattern(/^[\w:.@\\-]+\.service$/u, { message: "Expected a systemd service name" })).pipe(Schema.brand("SystemdUnit"));
+/** Matches the cgroup v2 line of a process in a system service: `0::/system.slice/usine.service`. */
+const SYSTEM_SERVICE_CGROUP = /^0::\/system\.slice\/(?:[^/\n]+\.slice\/)*([^/\n]+\.service)(?:\/[^\n]*)?$/mu;
+/**
+ * Returns the system service in the contents of `/proc/<pid>/cgroup`, or `None` for a process
+ * outside one, such as in a login session or under a user's service manager.
+ */
+export const systemServiceOf = (cgroup) => Option.flatMap(Option.fromNullishOr(SYSTEM_SERVICE_CGROUP.exec(cgroup)?.[1]), Schema.decodeUnknownOption(SystemdUnit));
+/**
+ * Returns the system service whose cgroup this process is in, or `None` outside one and on systems
+ * without `/proc`.
+ */
+export const currentSystemService = Effect.fn("Instance.currentSystemService")(function* () {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const cgroup = yield* fileSystem.readFileString("/proc/self/cgroup").pipe(Effect.tapError((error) => Effect.logDebug("Could not read this process's cgroup; no systemd service runs it", {
+        reason: error.message,
+    })), Effect.option);
+    const unit = Option.flatMap(cgroup, systemServiceOf);
+    if (Option.isSome(unit)) {
+        yield* Effect.logInfo("usine up runs in a systemd service", { unit: unit.value });
+    }
+    return unit;
+});
+/** `systemctl` couldn't run, or exited with a non-zero status. */
+export class SystemctlError extends Schema.TaggedError("@usine/server/SystemctlError")("SystemctlError", { command: Schema.String, unit: SystemdUnit, reason: Schema.String }) {
+}
+/** Runs `systemctl <args> <unit>` and returns its standard output. */
+export const systemctl = (unit, args) => runCommand("systemctl", [...args, unit], "/", SYSTEMCTL_TIMEOUT).pipe(Effect.map(({ stdout }) => stdout), Effect.mapError(({ command, reason }) => new SystemctlError({ command, unit, reason })));
+const MainPid = Schema.Trim.pipe(Schema.decodeTo(Schema.NumberFromString), Schema.decodeTo(Schema.Int));
+/**
+ * Returns `unit` if systemd reports `pid` as its main process, or `None` without a unit or if
+ * the unit's main process is another one, as for a `usine up` that a service's script started.
+ */
+export const supervisingUnit = Effect.fn("Instance.supervisingUnit")(function* (pid, unit) {
+    if (Option.isNone(unit))
+        return Option.none();
+    yield* Effect.annotateCurrentSpan({ pid, unit: unit.value });
+    const mainPid = Schema.decodeUnknownOption(MainPid)(yield* systemctl(unit.value, ["show", "--property=MainPID", "--value"]));
+    if (Option.contains(mainPid, pid))
+        return unit;
+    yield* Effect.logInfo("The instance process isn't the main process of its systemd service; usine signals it directly", { pid, unit: unit.value, mainPid: Option.getOrUndefined(mainPid) });
+    return Option.none();
+});
+/** Returns the state of `unit` from `systemctl show`. */
+export const unitState = Effect.fn("Instance.unitState")(function* (unit) {
+    const properties = new Map((yield* systemctl(unit, ["show", "--property=ActiveState", "--property=SubState"]))
+        .split("\n")
+        .map((line) => {
+        const separator = line.indexOf("=");
+        return [line.slice(0, separator), line.slice(separator + 1).trim()];
+    }));
+    return {
+        active: properties.get("ActiveState") ?? "unknown",
+        sub: properties.get("SubState") ?? "unknown",
+    };
+});
+//# sourceMappingURL=systemd.js.map

package/dist/instance/systemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.js","sourceRoot":"","sources":["../../src/instance/systemd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAC5C,MAAM,CAAC,SAAS,CAAC,yBAAyB,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAC5F,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;AAGpC,qGAAqG;AACrG,MAAM,qBAAqB,GACzB,8EAA8E,CAAC;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,EAA8B,EAAE,CAC5E,MAAM,CAAC,OAAO,CACZ,MAAM,CAAC,aAAa,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAC7D,MAAM,CAAC,mBAAmB,CAAC,WAAW,CAAC,CACxC,CAAC;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,EAAE,CAAC,+BAA+B,CAAC,CAAC,QAAQ,CAAC;IACtF,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAChD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,IAAI,CACvE,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,MAAM,CAAC,QAAQ,CAAC,kEAAkE,EAAE;QAClF,MAAM,EAAE,KAAK,CAAC,OAAO;KACtB,CAAC,CACH,EACD,MAAM,CAAC,MAAM,CACd,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,kEAAkE;AAClE,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,CACpD,8BAA8B,CAC/B,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;CAAG;AAE5F,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAiB,EAAE,IAA2B,EAAE,EAAE,CAC1E,UAAU,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAC,IAAI,CACnE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CACxF,CAAC;AAEJ,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAC9B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,CAAC,EACxC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAC5B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,EAC5E,GAAc,EACd,IAAgC;IAEhC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC,IAAI,EAAe,CAAC;IAC3D,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CACjD,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,CAAC,CAAC,CACxE,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnB,+FAA+F,EAC/F,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CACnE,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,EAAe,CAAC;AACpC,CAAC,CAAC,CAAC;AAQH,yDAAyD;AACzD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAiB;IACnF,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,wBAAwB,EAAE,qBAAqB,CAAC,CAAC,CAAC;SAChF,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAU,CAAC;IAC/E,CAAC,CAAC,CACL,CAAC;IACF,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,SAAS;QAClD,GAAG,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,SAAS;KACzB,CAAC;AACxB,CAAC,CAAC,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+/** Replaces the default loggers of every usine command: log lines in UTC, and span events. */
+export declare const loggerLayer: import("effect/Layer").Layer<never, never, never>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAsBA,8FAA8F;AAC9F,eAAO,MAAM,WAAW,mDAAiD,CAAC"}

package/dist/logger.js

@@ -0,0 +1,27 @@
+import { Cause, Console, Logger, References } from "effect";
+/**
+ * Effect's default logger with an ISO 8601 UTC timestamp, such as `[2026-10-27T02:25:13.123Z]`, in
+ * place of the local time of day, which has no date or offset and shifts with the process's time
+ * zone (#603).
+ */
+const utcLogger = Logger.make(({ cause, date, fiber, logLevel, message }) => {
+    const parts = Array.isArray(message) ? [...message] : [message];
+    if (cause.reasons.length > 0)
+        parts.push(Cause.pretty(cause));
+    const annotations = fiber.getRef(References.CurrentLogAnnotations);
+    if (Object.keys(annotations).length > 0)
+        parts.push(annotations);
+    const spans = fiber
+        .getRef(References.CurrentLogSpans)
+        .map(([label, start]) => ` ${label.replace(/[\s="]/gu, "_")}=${date.getTime() - start}ms`)
+        .join("");
+    const console = fiber.getRef(Console.Console);
+    const line = `[${date.toISOString()}] ${logLevel.toUpperCase()} (#${fiber.id})${spans}:`;
+    if (fiber.getRef(References.LogToStderr))
+        console.error(line, ...parts);
+    else
+        console.log(line, ...parts);
+});
+/** Replaces the default loggers of every usine command: log lines in UTC, and span events. */
+export const loggerLayer = Logger.layer([utcLogger, Logger.tracerLogger]);
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE5D;;;;GAIG;AACH,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAgB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;IACzF,MAAM,KAAK,GAAmB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,KAAK;SAChB,MAAM,CAAC,UAAU,CAAC,eAAe,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;SACzF,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,EAAE,IAAI,KAAK,GAAG,CAAC;IACzF,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;;QACnE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC"}

package/dist/main.js

@@ -1,31 +1,51 @@
 #!/usr/bin/env node
 import { NodeRuntime, NodeServices } from "@effect/platform-node";
-import { Console, Effect, Match, Option } from "effect";
+import { InstanceDirectory } from "@usine/core/instance";
+import { Config, ConfigProvider, Console, Effect, Layer, Match } from "effect";
+import { FetchHttpClient } from "effect/http";
 import { CLI_USAGE, packageVersion, parseCli } from "./cli.js";
+import { failureMessage } from "./failure-message.js";
+import { instanceEnvironment } from "./instance/environment.js";
+import { loggerLayer } from "./logger.js";
+/** The exit status of `usine status` when no `usine up` runs, as for LSB init scripts. */
+const NOT_RUNNING_STATUS = 3;
 const exitWith = (message) => Console.error(message).pipe(Effect.andThen(Effect.sync(() => {
     process.exitCode = 1;
 })));
-const main = Effect.gen(function* () {
-    const command = yield* parseCli(process.argv.slice(2), {
-        port: Option.fromNullishOr(process.env.USINE_PORT),
-        allowVolatileInstance: Option.fromNullishOr(process.env.USINE_ALLOW_VOLATILE_INSTANCE),
-    });
+const cliEnvironment = Config.all({
+    port: Config.option(Config.String("USINE_PORT")),
+    origin: Config.option(Config.String("USINE_ORIGIN")),
+    logLevel: Config.option(Config.String("USINE_LOG_LEVEL")),
+    allowVolatileInstance: Config.option(Config.String("USINE_ALLOW_VOLATILE_INSTANCE")),
+});
+// Untraced: a span around `usine up`, which never returns, would parent every span it exports.
+const runCommand = Effect.fnUntraced(function* (directory) {
+    // An environment and a parsed .env don't fail to load, so a ConfigError here is a defect.
+    const environment = yield* Effect.orDie(cliEnvironment);
+    const command = yield* parseCli(process.argv.slice(2), environment);
     return yield* Match.valueTags(command, {
         HelpCommand: () => Console.log(CLI_USAGE),
         VersionCommand: () => Effect.flatMap(packageVersion(), Console.log),
         ExportRunCommand: ({ runId, output }) => Effect.flatMap(Effect.promise(() => import("./export-run.js")), ({ exportRun }) => exportRun(runId, output)),
-        BackupCommand: ({ output }) => Effect.flatMap(Effect.promise(() => import("./backup.js")), ({ backup }) => backup(output)),
-        UpCommand: ({ port, allowVolatileInstance }) => Effect.flatMap(Effect.promise(() => import("./up.js")), ({ up }) => up(port, allowVolatileInstance)),
+        BackupCommand: ({ output }) => Effect.flatMap(Effect.promise(() => import("./backup.js")), ({ backup }) => backup(directory, output)),
+        UpCommand: (command) => command.detach
+            ? Effect.flatMap(Effect.promise(() => import("./detach.js")), ({ upDetached }) => upDetached(directory, command))
+            : Effect.flatMap(Effect.promise(() => import("./up.js")), ({ up }) => up(command)),
+        StatusCommand: () => Effect.flatMap(Effect.promise(() => import("./status.js")), ({ status }) => status(directory)).pipe(Effect.flatMap(({ running, lines }) => Effect.forEach(lines, (line) => Console.log(line), { discard: true }).pipe(Effect.andThen(Effect.sync(() => {
+            if (!running)
+                process.exitCode = NOT_RUNNING_STATUS;
+        }))))),
+        StopCommand: ({ options }) => Effect.flatMap(Effect.promise(() => import("./stop.js")), ({ stop }) => stop(directory, options)),
+        RestartCommand: ({ options }) => Effect.flatMap(Effect.promise(() => import("./restart.js")), ({ restart, fallbackLaunch }) => restart(directory, options, fallbackLaunch(environment))),
+        UpgradeCommand: (upgradeCommand) => Effect.flatMap(Effect.promise(() => import("./upgrade.js")), ({ upgrade }) => upgrade(directory, upgradeCommand)),
     });
-}).pipe(Effect.provide(NodeServices.layer), Effect.catchTags({
-    CliUsageError: ({ message }) => exitWith(message),
-    RunNotFoundError: ({ runId }) => exitWith(`Run ${runId} was not found.`),
-    RunExportError: ({ runId, operation, path, reason }) => exitWith(`Could not ${operation} evidence for Run ${runId} at ${path} (${reason}). Check the instance database and choose a new writable output path.`),
-    RuntimeStoreBackupError: ({ operation, source, destination, reason }) => exitWith(Match.value(operation).pipe(Match.when("open", () => `Could not open ${source} (${reason}). Run usine backup from the instance folder containing .usine/runtime.sqlite.`), Match.when("copy", () => `Could not copy ${source} to ${destination} (${reason}). Check the source database and the output directory's free space and permissions.`), Match.when("stage", () => `Could not create a backup at ${destination} (${reason}). Choose an existing writable output directory.`), Match.when("publish", () => reason === "AlreadyExists"
-        ? `Could not save the backup to ${destination} (${reason}). Choose a different filename; the destination already exists.`
-        : `Could not save the backup to ${destination} (${reason}). Check the destination path and permissions; its filesystem must support hard links.`), Match.exhaustive)),
-    VolatileInstanceDirectoryError: ({ directory, root }) => exitWith(`Refusing to start: ${directory} sits under ${root}, which the OS clears. The runtime store there is the only copy of every Run and transcript. Move the instance folder, or pass --allow-volatile-instance (or USINE_ALLOW_VOLATILE_INSTANCE=1) to proceed anyway.`),
-    PortInUseError: ({ port }) => exitWith(`Port ${port} is already in use. Stop the process using it or run usine up --port <port>.`),
-}));
+});
+const main = Effect.gen(function* () {
+    const directory = InstanceDirectory.make(process.cwd());
+    const environment = yield* instanceEnvironment(directory, yield* ConfigProvider.ConfigProvider);
+    return yield* runCommand(directory).pipe(Effect.provideService(ConfigProvider.ConfigProvider, environment));
+}).pipe(Effect.provide(Layer.mergeAll(NodeServices.layer, FetchHttpClient.layer, loggerLayer)), 
+// Only typed failures are caught: a defect still crashes with its full cause.
+Effect.catch((failure) => exitWith(failureMessage(failure))));
 NodeRuntime.runMain(main);
 //# sourceMappingURL=main.js.map