@usine/server 0.3.0 → 0.4.0

package/dist/system-sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-sleep.d.ts","sourceRoot":"","sources":["../src/system-sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAgB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA8BnE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,2EAyB7B,CAAC"}

package/dist/system-sleep.js

@@ -0,0 +1,42 @@
+import { Duration, Effect, Option, Schema } from "effect";
+import { ChildProcess, ChildProcessSpawner } from "effect/process";
+const PMSET_TIMEOUT = Duration.seconds(5);
+/** Matches a line such as ` sleep  1 (sleep prevented by caffeinate, powerd)`. */
+const SLEEP_LINE = /^\s*sleep\s+(\d+)(?:\s+\(sleep prevented by ([^)]*)\))?/mu;
+const Minutes = Schema.NumberFromString.pipe(Schema.decodeTo(Schema.Int));
+/** Returns the `sleep` setting in `pmset -g` output, or `None` if it has no `sleep` line. */
+const systemSleepOf = (output) => {
+    const line = SLEEP_LINE.exec(output);
+    if (line === null)
+        return Option.none();
+    return Option.map(Schema.decodeUnknownOption(Minutes)(line[1]), (minutes) => ({
+        minutes,
+        preventedBy: (line[2] ?? "")
+            .split(",")
+            .map((name) => name.trim())
+            .filter((name) => name.length > 0),
+    }));
+};
+/**
+ * Logs a warning if this Mac can sleep while `usine up` runs: system sleep is on, and `caffeinate`
+ * doesn't prevent it. A sleep closes the SSH connections to Workers and to the Gateway, and the
+ * orchestrator does nothing until the Mac wakes.
+ */
+export const warnIfSystemSleeps = Effect.fn("Server.warnIfSystemSleeps")(function* () {
+    const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
+    const sleep = yield* spawner
+        .string(ChildProcess.make("pmset", ["-g"], { stdin: "ignore", stderr: "ignore" }))
+        .pipe(Effect.timeout(PMSET_TIMEOUT), Effect.map(systemSleepOf), Effect.tapError((cause) => Effect.logWarning("Could not read the system sleep setting with pmset", { cause })), Effect.orElseSucceed(() => Option.none()));
+    if (Option.isNone(sleep))
+        return yield* Effect.logDebug("pmset reported no system sleep setting; skipping the check");
+    const { minutes, preventedBy } = sleep.value;
+    if (minutes === 0)
+        return yield* Effect.logDebug("System sleep is off");
+    if (preventedBy.includes("caffeinate"))
+        return yield* Effect.logInfo("System sleep is on, and caffeinate prevents it", {
+            minutes,
+            preventedBy,
+        });
+    yield* Effect.logWarning("This Mac can sleep while runs are open. A sleep drops the SSH connections to workers and the gateway, and remote children must resume. Run `caffeinate -s` while runs are open, turn off sleep on AC power with `sudo pmset -c sleep 0`, or run the orchestrator on an always-on server: https://docs.usine.dev/guides/run-the-orchestrator-on-a-server/", { minutes, preventedBy });
+});
+//# sourceMappingURL=system-sleep.js.map

package/dist/system-sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-sleep.js","sourceRoot":"","sources":["../src/system-sleep.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAU1C,kFAAkF;AAClF,MAAM,UAAU,GAAG,2DAA2D,CAAC;AAE/E,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1E,6FAA6F;AAC7F,MAAM,aAAa,GAAG,CAAC,MAAc,EAA8B,EAAE;IACnE,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5E,OAAO;QACP,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACzB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;KACrC,CAAC,CAAC,CAAC;AACN,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC;IAChF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO;SACzB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;SACjF,IAAI,CACH,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC7B,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,EACzB,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,MAAM,CAAC,UAAU,CAAC,oDAAoD,EAAE,EAAE,KAAK,EAAE,CAAC,CACnF,EACD,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAe,CAAC,CACvD,CAAC;IACJ,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACtB,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,4DAA4D,CAAC,CAAC;IAC9F,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACxE,IAAI,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC;QACpC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,gDAAgD,EAAE;YAC7E,OAAO;YACP,WAAW;SACZ,CAAC,CAAC;IACL,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CACtB,0VAA0V,EAC1V,EAAE,OAAO,EAAE,WAAW,EAAE,CACzB,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/tracing.d.ts

@@ -0,0 +1,22 @@
+import type { Tracing } from "@usine/config/factory";
+import { type FileSystem, Layer, Option, Schema } from "effect";
+import { type CliVersionError } from "./cli.ts";
+declare const ResourceAttributesError_base: Schema.Class<ResourceAttributesError, Schema.TaggedStruct<"ResourceAttributesError", {
+    readonly variable: Schema.Literal<"OTEL_RESOURCE_ATTRIBUTES">;
+    /** The parse problem, with the key at fault. */
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** `OTEL_RESOURCE_ATTRIBUTES` has a key or value that isn't valid percent-encoding. */
+export declare class ResourceAttributesError extends ResourceAttributesError_base {
+}
+/**
+ * Exports every ended span to `tracing.otlpUrl` as OTLP/HTTP protobuf, or keeps Effect's default
+ * tracer, which exports nothing, if `tracing` is `None`. Logs which of the two applies, and a
+ * warning for each failed export request, with the URL's origin and path only. A failed export,
+ * after up to 3 retries, drops the buffered spans and pauses export for 60 seconds. Closing the
+ * layer's scope flushes buffered spans for at most 3 seconds. Fails with
+ * `ResourceAttributesError` if `tracing` is set and `OTEL_RESOURCE_ATTRIBUTES` is malformed.
+ */
+export declare const tracingLayer: (tracing: Option.Option<Tracing>) => Layer.Layer<never, CliVersionError | ResourceAttributesError, FileSystem.FileSystem>;
+export {};
+//# sourceMappingURL=tracing.d.ts.map

package/dist/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,EACL,MAAM,EACN,MAAM,EAEP,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,KAAK,eAAe,EAAkB,MAAM,UAAU,CAAC;;;IAS9D,gDAAgD;;;AALlD,uFAAuF;AACvF,qBAAa,uBAAwB,SAAQ,4BAM3C;CAAG;AA+CL;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,YACd,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAC9B,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,GAAG,uBAAuB,EAAE,UAAU,CAAC,UAAU,CAgClF,CAAC"}

package/dist/tracing.js

@@ -0,0 +1,61 @@
+import { Config, ConfigProvider, Effect, Layer, Option, Schema, SchemaTransformation, } from "effect";
+import { FetchHttpClient, HttpClient } from "effect/http";
+import { OtlpSerialization, OtlpTracer } from "effect/observability";
+import { packageVersion } from "./cli.js";
+const RESOURCE_ATTRIBUTES = "OTEL_RESOURCE_ATTRIBUTES";
+/** `OTEL_RESOURCE_ATTRIBUTES` has a key or value that isn't valid percent-encoding. */
+export class ResourceAttributesError extends Schema.TaggedError("@usine/server/ResourceAttributesError")("ResourceAttributesError", {
+    variable: Schema.Literal(RESOURCE_ATTRIBUTES),
+    /** The parse problem, with the key at fault. */
+    message: Schema.String,
+}) {
+}
+/** Comma-separated `key=value` pairs with percent-encoded keys and values. */
+const ResourceAttributes = Schema.String.pipe(Schema.decodeTo(Schema.Record(Schema.StringFromUriComponent, Schema.StringFromUriComponent), SchemaTransformation.splitKeyValue()));
+/** Returns the attributes in `OTEL_RESOURCE_ATTRIBUTES`, or none if it's unset. */
+const resourceAttributes = Effect.fn("Tracing.resourceAttributes")(function* () {
+    const refuse = (error) => new ResourceAttributesError({ variable: RESOURCE_ATTRIBUTES, message: error.message });
+    const value = yield* Config.option(Config.String(RESOURCE_ATTRIBUTES)).pipe(Effect.mapError(refuse));
+    return yield* Option.match(value, {
+        onNone: () => Effect.succeed({}),
+        onSome: (attributes) => Schema.decodeUnknownEffect(ResourceAttributes)(attributes).pipe(Effect.mapError(refuse)),
+    });
+});
+/** Returns the URL's origin and path, without credentials, query string, or fragment. */
+const loggedUrl = (url) => `${url.origin}${url.pathname}`;
+const EXPORT_FAILED = "Span export to the OTLP collector failed";
+// The error message is left out because it repeats the request URL.
+const exportClientLayer = (collector) => Layer.effect(HttpClient.HttpClient, Effect.map(HttpClient.HttpClient, (client) => client.pipe(HttpClient.filterStatusOk, HttpClient.tapError((error) => {
+    const failure = { otlpUrl: collector, reason: error.reason._tag };
+    return Option.match(Option.fromUndefinedOr(error.response), {
+        onNone: () => Effect.logWarning(EXPORT_FAILED, failure),
+        onSome: ({ status }) => Effect.logWarning(EXPORT_FAILED, { ...failure, status }),
+    });
+})))).pipe(Layer.provide(FetchHttpClient.layer));
+/**
+ * Exports every ended span to `tracing.otlpUrl` as OTLP/HTTP protobuf, or keeps Effect's default
+ * tracer, which exports nothing, if `tracing` is `None`. Logs which of the two applies, and a
+ * warning for each failed export request, with the URL's origin and path only. A failed export,
+ * after up to 3 retries, drops the buffered spans and pauses export for 60 seconds. Closing the
+ * layer's scope flushes buffered spans for at most 3 seconds. Fails with
+ * `ResourceAttributesError` if `tracing` is set and `OTEL_RESOURCE_ATTRIBUTES` is malformed.
+ */
+export const tracingLayer = (tracing) => Option.match(tracing, {
+    onNone: () => Layer.effectDiscard(Effect.logInfo("Span export is off; set tracing.otlp_url in usine.yaml to turn it on")),
+    onSome: ({ otlpUrl, serviceName }) => Layer.unwrap(Effect.gen(function* () {
+        const serviceVersion = yield* packageVersion();
+        const attributes = yield* resourceAttributes();
+        return OtlpTracer.layer({
+            url: otlpUrl.href,
+            resource: { serviceName, serviceVersion, attributes },
+        }).pipe(
+        // `attributes` replaces the resource's own read of OTEL_RESOURCE_ATTRIBUTES, which dies on
+        // a malformed value.
+        Layer.provide(ConfigProvider.layer(ConfigProvider.fromUnknown({}))), Layer.provide(OtlpSerialization.layerProtobuf), Layer.provide(exportClientLayer(loggedUrl(otlpUrl))), Layer.merge(Layer.effectDiscard(Effect.logInfo("Exporting spans over OTLP", {
+            otlpUrl: loggedUrl(otlpUrl),
+            serviceName,
+            serviceVersion,
+        }))));
+    })),
+});
+//# sourceMappingURL=tracing.js.map

package/dist/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../src/tracing.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EACN,cAAc,EACd,MAAM,EAEN,KAAK,EACL,MAAM,EACN,MAAM,EACN,oBAAoB,GACrB,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAwB,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAEvD,uFAAuF;AACvF,MAAM,OAAO,uBAAwB,SAAQ,MAAM,CAAC,WAAW,CAC7D,uCAAuC,CACxC,CAAC,yBAAyB,EAAE;IAC3B,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC7C,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM;CACvB,CAAC;CAAG;AAEL,8EAA8E;AAC9E,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAC3C,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,CAAC,EAC3E,oBAAoB,CAAC,aAAa,EAAE,CACrC,CACF,CAAC;AAEF,mFAAmF;AACnF,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,4BAA4B,CAAC,CAAC,QAAQ,CAAC;IAC1E,MAAM,MAAM,GAAG,CAAC,KAAmC,EAAE,EAAE,CACrD,IAAI,uBAAuB,CAAC,EAAE,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CACzE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CACxB,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;QAChC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CACrB,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC3F,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,SAAS,GAAG,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;AAE/D,MAAM,aAAa,GAAG,0CAA0C,CAAC;AAEjE,oEAAoE;AACpE,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,EAAE,CAC9C,KAAK,CAAC,MAAM,CACV,UAAU,CAAC,UAAU,EACrB,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAC3C,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;QAC1D,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC;QACvD,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;KACjF,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CACF,CACF,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,OAA+B,EACuD,EAAE,CACxF,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,GAAG,EAAE,CACX,KAAK,CAAC,aAAa,CACjB,MAAM,CAAC,OAAO,CAAC,sEAAsE,CAAC,CACvF;IACH,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CACnC,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,cAAc,GAAG,KAAK,CAAC,CAAC,cAAc,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,kBAAkB,EAAE,CAAC;QAC/C,OAAO,UAAU,CAAC,KAAK,CAAC;YACtB,GAAG,EAAE,OAAO,CAAC,IAAI;YACjB,QAAQ,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE;SACtD,CAAC,CAAC,IAAI;QACL,2FAA2F;QAC3F,qBAAqB;QACrB,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EACnE,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAC9C,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EACpD,KAAK,CAAC,KAAK,CACT,KAAK,CAAC,aAAa,CACjB,MAAM,CAAC,OAAO,CAAC,2BAA2B,EAAE;YAC1C,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;YAC3B,WAAW;YACX,cAAc;SACf,CAAC,CACH,CACF,CACF,CAAC;IACJ,CAAC,CAAC,CACH;CACJ,CAAC,CAAC"}

package/dist/up.d.ts

@@ -1,4 +1,4 @@
 import { Effect } from "effect";
-import { type Port, VolatileInstanceDirectoryError } from "./cli.ts";
-export declare const up: (port: Port, allowVolatileInstance: boolean) => Effect.Effect<never, import("@usine/github/github-app").AppAuthenticationError | import("@usine/engine/engine").AttemptCancellationError | import("@usine/executor").CredentialUnavailableError | import("@usine/durable/harness").DurableHarnessError | import("@usine/engine/engine").EnginePersistenceError | import("@usine/executor").ExecutorOperationError | import("@usine/config/file").FactoryConfigError | import("./instance-lock.ts").InstanceInUseError | import("./instance-lock.ts").InstanceLockError | import("./cli.ts").PortInUseError | import("@usine/engine/engine").RunInterventionRejectedError | import("@usine/engine/engine").RunNotFoundError | import("@usine/engine/engine").RunOperationRejectedError | import("@usine/engine/engine").RunRetryBlockedError | import("./cli.ts").ServerStartError | import("@usine/orchestrator/scheduler").UnsupportedWorkerError | VolatileInstanceDirectoryError | import("@usine/executor").WorkerCapabilityError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner>;
+import { type UpCommand, VolatileInstanceDirectoryError } from "./cli.ts";
+export declare const up: (command: UpCommand) => Effect.Effect<never, import("@usine/github/github-app").AppAuthenticationError | import("@usine/engine/engine").AttemptCancellationError | import("./cli.ts").CliVersionError | import("@usine/executor").CredentialUnavailableError | import("@usine/durable/harness").DurableHarnessError | import("@usine/engine/engine").EnginePersistenceError | import("@usine/executor").ExecutorOperationError | import("@usine/config/file").FactoryConfigError | import("./instance/id.ts").InstanceIdError | import("./instance/lock.ts").InstanceInUseError | import("./instance/lock.ts").InstanceLockError | import("./cli.ts").PortInUseError | import("./tracing.ts").ResourceAttributesError | import("@usine/engine/engine").RunInterventionRejectedError | import("@usine/engine/engine").RunNotFoundError | import("@usine/engine/engine").RunOperationRejectedError | import("@usine/engine/engine").RunRetryBlockedError | import("./cli.ts").ServerStartError | import("@usine/orchestrator/scheduler").UnsupportedWorkerError | VolatileInstanceDirectoryError | import("@usine/executor").WorkerCapabilityError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner>;
 //# sourceMappingURL=up.d.ts.map

package/dist/up.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../src/up.ts"],"names":[],"mappings":"AAcA,OAAO,EAML,MAAM,EAKP,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,KAAK,IAAI,EACT,8BAA8B,EAO/B,MAAM,UAAU,CAAC;AAyElB,eAAO,MAAM,EAAE,SAAU,IAAI,yBAAyB,OAAO,sgCAqF1D,CAAC"}
+{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../src/up.ts"],"names":[],"mappings":"AAcA,OAAO,EAQL,MAAM,EAMP,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAGL,KAAK,SAAS,EACd,8BAA8B,EAQ/B,MAAM,UAAU,CAAC;AAsKlB,eAAO,MAAM,EAAE,YAAa,SAAS,goCAiCwC,CAAC"}

package/dist/up.js

@@ -12,13 +12,18 @@ import { CurrentInstance } from "@usine/orchestrator/current-instance";
 import { Operator, OperatorConfiguration, OperatorObservation } from "@usine/orchestrator/operator";
 import { Orchestrator } from "@usine/orchestrator/orchestrator";
 import { operatorObservationLayer, runtimeLayer } from "@usine/orchestrator/runtime";
-import { Cause, Console, Context, Duration, Deferred, Effect, FileSystem, Layer, Option, Result, } from "effect";
+import { Cause, Config, Console, Context, DateTime, Duration, Deferred, Effect, FileSystem, Layer, Option, References, Result, } from "effect";
 import { liveBackendLayer, needsSetupBackendLayer } from "./backend.js";
-import { VolatileInstanceDirectoryError, openBrowser, portInUse, refuseTakenPort, serverStartError, volatileRoot, volatileRoots, } from "./cli.js";
+import { VolatileInstanceDirectoryError, openBrowser, packageVersion, portInUse, refuseTakenPort, serverStartError, volatileRoot, volatileRoots, } from "./cli.js";
 import { serverLayer } from "./http.js";
-import { holdInstance } from "./instance-lock.js";
+import { instanceIdOf } from "./instance/id.js";
+import { holdInstance } from "./instance/lock.js";
+import { InstanceRecord, ProcessId, currentLaunch, instanceFiles } from "./instance/record.js";
+import { currentSystemService } from "./instance/systemd.js";
 import { reloadOnHangup } from "./reload-signal.js";
 import { withGracefulShutdown } from "./shutdown.js";
+import { warnIfSystemSleeps } from "./system-sleep.js";
+import { tracingLayer } from "./tracing.js";
 const instanceFolderLayer = InstanceFolder.layer.pipe(Layer.provide(ConfigParser.layer.pipe(Layer.provide(MarcbachmannCelLayer))), Layer.provide(NodeServices.layer));
 /** Loads the instance folder and keeps it reloadable. Fails if `usine.yaml` is invalid. */
 const loadInstance = Effect.fn("Server.loadInstance")(function* (directory) {
@@ -27,8 +32,9 @@ const loadInstance = Effect.fn("Server.loadInstance")(function* (directory) {
     const current = yield* Layer.build(CurrentInstance.layer(directory, initial).pipe(Layer.provide(Layer.succeedContext(context))));
     return Context.get(current, CurrentInstance);
 });
-const serve = Effect.fn("Server.serve")(function* (options) {
-    yield* Layer.build(serverLayer(options.backend, options.webRoot, options.port)).pipe(Effect.mapError((error) => serverStartError(options.port, error)), Effect.catchTag("PortInUseError", ({ port }) => portInUse(port)));
+// Untraced: a span around a server that never returns would parent every request span.
+const serve = Effect.fnUntraced(function* (options) {
+    yield* Layer.build(serverLayer(options.backend, options.webRoot, options.port, options.origin)).pipe(Effect.mapError((error) => serverStartError(options.port, error)), Effect.catchTag("PortInUseError", ({ port }) => portInUse(port)));
     yield* Console.log(options.openSetupPage
         ? `usine is running in setup mode at ${options.url}`
         : `usine is running at ${options.url}`);
@@ -43,7 +49,7 @@ const serve = Effect.fn("Server.serve")(function* (options) {
 });
 const refuseVolatileInstance = Effect.fn("Server.refuseVolatileInstance")(function* (directory, allowVolatileInstance) {
     const realDirectory = yield* Effect.flatMap(FileSystem.FileSystem, (fileSystem) => fileSystem.realPath(directory)).pipe(Effect.orElseSucceed(() => directory));
-    const roots = volatileRoots(Option.fromNullishOr(process.env.TMPDIR));
+    const roots = volatileRoots(yield* Effect.orDie(Config.option(Config.String("TMPDIR"))));
     const root = Option.orElse(volatileRoot(directory, roots), () => volatileRoot(realDirectory, roots));
     if (Option.isNone(root))
         return;
@@ -52,13 +58,8 @@ const refuseVolatileInstance = Effect.fn("Server.refuseVolatileInstance")(functi
     }
     yield* Effect.logWarning("Instance folder sits under a volatile path; its runtime store is the only copy of run history", { instanceDirectory: directory, root: root.value });
 });
-export const up = (port, allowVolatileInstance) => Effect.scoped(Effect.gen(function* () {
-    const directory = InstanceDirectory.make(process.cwd());
-    yield* refuseVolatileInstance(directory, allowVolatileInstance).pipe(Effect.provide(NodeServices.layer));
-    // Acquired before any store opens and released after every store closes.
-    yield* holdInstance(directory).pipe(Effect.provide(NodeServices.layer));
-    yield* refuseTakenPort(port).pipe(Effect.provide(NodeServices.layer));
-    const instances = yield* loadInstance(directory);
+/** Serves setup mode if the GitHub App credentials are absent, otherwise runs the factory. */
+const start = Effect.fnUntraced(function* (directory, instanceId, instances, port, origin) {
     yield* reloadOnHangup(instances);
     const credentials = yield* loadLocalCredentials(directory).pipe(Effect.provide(NodeServices.layer), Effect.result);
     const webRoot = resolve(dirname(fileURLToPath(import.meta.url)), "web");
@@ -72,11 +73,11 @@ export const up = (port, allowVolatileInstance) => Effect.scoped(Effect.gen(func
         });
         const observationContext = yield* Layer.build(operatorObservationLayer(directory));
         const backend = needsSetupBackendLayer(instances, error._tag, Context.get(observationContext, OperatorObservation), Context.get(observationContext, OperatorConfiguration));
-        return yield* serve({ backend, webRoot, port, url, openSetupPage: true });
+        return yield* serve({ backend, webRoot, port, origin, url, openSetupPage: true });
     }
     const shutdown = yield* Deferred.make();
     const startup = Effect.gen(function* () {
-        const runtime = runtimeLayer(directory).pipe(Layer.provide(Layer.succeed(GitHubCredentials, credentials.success)), Layer.provide(Layer.succeed(CurrentInstance, instances)));
+        const runtime = runtimeLayer(directory, instanceId).pipe(Layer.provide(Layer.succeed(GitHubCredentials, credentials.success)), Layer.provide(Layer.succeed(CurrentInstance, instances)));
         const context = yield* Layer.build(runtime).pipe(Effect.provideService(RunEngineShutdown, shutdown));
         const operator = Context.get(context, Operator);
         const orchestrator = Context.get(context, Orchestrator);
@@ -87,6 +88,7 @@ export const up = (port, allowVolatileInstance) => Effect.scoped(Effect.gen(func
                 backend: liveBackendLayer(instances, operator, Context.get(context, OperatorConfiguration)),
                 webRoot,
                 port,
+                origin,
                 url,
                 openSetupPage: false,
             }), orchestrator.run.pipe(Effect.tapCause((cause) => Cause.hasInterruptsOnly(cause)
@@ -100,5 +102,28 @@ export const up = (port, allowVolatileInstance) => Effect.scoped(Effect.gen(func
         onNone: () => Duration.infinity,
         onSome: Duration.minutes,
     })));
-}));
+});
+export const up = (command) => Effect.scoped(Effect.gen(function* () {
+    const { port, origin } = command;
+    const directory = InstanceDirectory.make(process.cwd());
+    yield* refuseVolatileInstance(directory, command.allowVolatileInstance).pipe(Effect.provide(NodeServices.layer));
+    const record = new InstanceRecord({
+        pid: ProcessId.make(process.pid),
+        version: yield* packageVersion().pipe(Effect.provide(NodeServices.layer)),
+        startedAt: yield* DateTime.now,
+        launch: yield* currentLaunch(command),
+        systemdUnit: yield* currentSystemService().pipe(Effect.provide(NodeServices.layer)),
+    });
+    // Acquired before any store opens and released after every store closes.
+    yield* holdInstance(directory, record).pipe(Effect.provide(NodeServices.layer));
+    const instanceId = yield* instanceIdOf(instanceFiles(directory)).pipe(Effect.provide(NodeServices.layer));
+    yield* refuseTakenPort(port).pipe(Effect.provide(NodeServices.layer));
+    if (process.platform === "darwin")
+        yield* warnIfSystemSleeps().pipe(Effect.provide(NodeServices.layer));
+    const instances = yield* loadInstance(directory);
+    const { config } = yield* instances.get;
+    // Built before the runtime, so the exporter flushes the runtime's last spans when it closes.
+    const tracer = yield* Layer.build(tracingLayer(config.tracing)).pipe(Effect.provide(NodeServices.layer));
+    return yield* start(directory, instanceId, instances, port, origin).pipe(Effect.provideContext(tracer));
+})).pipe(Effect.provideService(References.MinimumLogLevel, command.logLevel));
 //# sourceMappingURL=up.js.map

package/dist/up.js.map

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

package/dist/upgrade.d.ts

@@ -0,0 +1,58 @@
+import { Effect, FileSystem, Schema } from "effect";
+import type { UpgradeCommand } from "./cli.ts";
+import { UnrecordedInstanceError } from "./stop.ts";
+declare const EngineOutsideInstanceError_base: Schema.Class<EngineOutsideInstanceError, Schema.TaggedStruct<"EngineOutsideInstanceError", {
+    readonly script: Schema.String;
+    readonly version: Schema.String;
+    /** Whether the entry point is in a `node_modules` folder, as with a global install. */
+    readonly packaged: Schema.Boolean;
+}>, import("effect/Cause").YieldableError>;
+/** The running engine isn't installed in the instance's `node_modules`, so no pin selects it. */
+export declare class EngineOutsideInstanceError extends EngineOutsideInstanceError_base {
+}
+declare const EnginePinError_base: Schema.Class<EnginePinError, Schema.TaggedStruct<"EnginePinError", {
+    readonly path: Schema.String;
+    readonly missing: Schema.Boolean;
+    /** The local spec, such as `link:../usine/apps/server`, if `@usine/server` has one. */
+    readonly linked: Schema.Option<Schema.String>;
+}>, import("effect/Cause").YieldableError>;
+/** The instance's `package.json` is absent or doesn't pin `@usine/server` to a registry version. */
+export declare class EnginePinError extends EnginePinError_base {
+}
+declare const UpgradeFileError_base: Schema.Class<UpgradeFileError, Schema.TaggedStruct<"UpgradeFileError", {
+    readonly path: Schema.String;
+    readonly reason: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A file that `usine upgrade` reads or writes couldn't be accessed. */
+export declare class UpgradeFileError extends UpgradeFileError_base {
+}
+declare const UpgradeFailedError_base: Schema.Class<UpgradeFailedError, Schema.TaggedStruct<"UpgradeFailedError", {
+    readonly stage: Schema.Literals<readonly ["install", "start", "listen"]>;
+    readonly reason: Schema.String;
+    readonly previous: Schema.String;
+    readonly target: Schema.String;
+    readonly packageManager: Schema.Literals<readonly ["pnpm", "npm", "yarn", "bun"]>;
+    /** The runtime store copy, if the instance had a runtime store. The durable copy is next to it. */
+    readonly backup: Schema.Option<Schema.String>;
+    /** The commit of the pin change, if `usine upgrade` made one. */
+    readonly commit: Schema.Option<Schema.String>;
+    /** The last lines of `.usine/usine.log`, for a failed start. */
+    readonly tail: Schema.String;
+    /** The systemd service that runs the instance, whose journal has its output. */
+    readonly unit: Schema.Option<Schema.brand<Schema.String, "SystemdUnit">>;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * `usine upgrade` failed after it changed the pin. `install` restored the pin, `start` left the
+ * instance stopped, and `listen` left a new process that doesn't answer.
+ */
+export declare class UpgradeFailedError extends UpgradeFailedError_base {
+}
+/**
+ * Moves the instance's `@usine/*` pins to `command.version`, or to `latest`. Refuses while
+ * Attempts are live, unless `--force`. Backs up the stores to `.usine/backups/`, stops the
+ * instance, installs with the instance's package manager, commits the pin change, and starts the
+ * instance again if it was running.
+ */
+export declare const upgrade: (directory: string & import("effect/Brand").Brand<"InstanceDirectory">, command: UpgradeCommand) => Effect.Effect<void, import("./detach.ts").DetachedSpawnError | import("@usine/durable/backup").DurableStorageBackupError | EngineOutsideInstanceError | EnginePinError | import("./instance/lock.ts").InstanceLockError | import("./instance/manifest.ts").InstanceManifestError | import("./stop.ts").KillTimeoutError | import("./stop.ts").LiveAttemptsError | import("./stop.ts").MissingEnvironmentError | import("./registry.ts").PackageLookupError | import("@usine/engine/local-sqlite").RuntimeStoreBackupError | import("./instance/state.ts").SignalError | import("./stop.ts").StopTimeoutError | import("./instance/systemd.ts").SystemctlError | UnrecordedInstanceError | UpgradeFailedError | UpgradeFileError, import("effect/process/ChildProcessSpawner").ChildProcessSpawner | FileSystem.FileSystem | import("effect/http/HttpClient").HttpClient | import("effect/Path").Path>;
+export {};
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,MAAM,EAAE,UAAU,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAmB/C,OAAO,EACL,uBAAuB,EAIxB,MAAM,WAAW,CAAC;;;;IAUjB,uFAAuF;;;AANzF,iGAAiG;AACjG,qBAAa,0BAA2B,SAAQ,+BAO9C;CAAG;;;;IAQH,uFAAuF;;;AANzF,oGAAoG;AACpG,qBAAa,cAAe,SAAQ,mBAOlC;CAAG;;;;;AAEL,wEAAwE;AACxE,qBAAa,gBAAiB,SAAQ,qBAE+B;CAAG;;;;;;;IActE,mGAAmG;;IAEnG,iEAAiE;;IAEjE,gEAAgE;;IAEhE,gFAAgF;;;AAlBlF;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,uBAgBtC;CAAG;AAuDL;;;;;GAKG;AACH,eAAO,MAAM,OAAO,28BA0OlB,CAAC"}

package/dist/upgrade.js

@@ -0,0 +1,237 @@
+import { join, sep } from "node:path";
+import { Console, DateTime, Duration, Effect, FileSystem, Option, Schema } from "effect";
+import { backup } from "./backup.js";
+import { runCommand, runInTerminal } from "./command.js";
+import { startAgain, startedMessage } from "./detach.js";
+import { PackageManager, SERVER_PACKAGE, bumpPins, compareVersions, installedInInstance, parseManifest, readManifest, realPathOrSelf, serverPin, } from "./instance/manifest.js";
+import { instanceFiles } from "./instance/record.js";
+import { probeInstance } from "./instance/state.js";
+import { SystemdUnit, supervisingUnit } from "./instance/systemd.js";
+import { dependenciesOf, resolveVersion } from "./registry.js";
+import { UnrecordedInstanceError, refuseLiveAttempts, refuseMissingEnvironment, stopProcess, } from "./stop.js";
+const GIT_TIMEOUT = "30 seconds";
+/** The running engine isn't installed in the instance's `node_modules`, so no pin selects it. */
+export class EngineOutsideInstanceError extends Schema.TaggedError("@usine/server/EngineOutsideInstanceError")("EngineOutsideInstanceError", {
+    script: Schema.String,
+    version: Schema.String,
+    /** Whether the entry point is in a `node_modules` folder, as with a global install. */
+    packaged: Schema.Boolean,
+}) {
+}
+/** The instance's `package.json` is absent or doesn't pin `@usine/server` to a registry version. */
+export class EnginePinError extends Schema.TaggedError("@usine/server/EnginePinError")("EnginePinError", {
+    path: Schema.String,
+    missing: Schema.Boolean,
+    /** The local spec, such as `link:../usine/apps/server`, if `@usine/server` has one. */
+    linked: Schema.Option(Schema.String),
+}) {
+}
+/** A file that `usine upgrade` reads or writes couldn't be accessed. */
+export class UpgradeFileError extends Schema.TaggedError("@usine/server/UpgradeFileError")("UpgradeFileError", { path: Schema.String, reason: Schema.String }) {
+}
+/**
+ * `usine upgrade` failed after it changed the pin. `install` restored the pin, `start` left the
+ * instance stopped, and `listen` left a new process that doesn't answer.
+ */
+export class UpgradeFailedError extends Schema.TaggedError("@usine/server/UpgradeFailedError")("UpgradeFailedError", {
+    stage: Schema.Literals(["install", "start", "listen"]),
+    reason: Schema.String,
+    previous: Schema.String,
+    target: Schema.String,
+    packageManager: PackageManager,
+    /** The runtime store copy, if the instance had a runtime store. The durable copy is next to it. */
+    backup: Schema.Option(Schema.String),
+    /** The commit of the pin change, if `usine upgrade` made one. */
+    commit: Schema.Option(Schema.String),
+    /** The last lines of `.usine/usine.log`, for a failed start. */
+    tail: Schema.String,
+    /** The systemd service that runs the instance, whose journal has its output. */
+    unit: Schema.Option(SystemdUnit),
+}) {
+}
+const backupStamp = (now) => DateTime.formatIso(now)
+    .replace(/[-:]/gu, "")
+    .replace(/\.\d+Z$/u, "Z");
+/** Returns the versions for the pins: the server's dependency spec for each, or else `latest`. */
+const targetVersions = Effect.fn("Cli.upgradeTargets")(function* (directory, manifest, target) {
+    const serverDependencies = yield* dependenciesOf(directory, SERVER_PACKAGE, target);
+    const versions = new Map([[SERVER_PACKAGE, target]]);
+    for (const { name } of manifest.pins) {
+        if (name === SERVER_PACKAGE)
+            continue;
+        const spec = Option.getOrElse(Option.fromUndefinedOr(serverDependencies[name]), () => "latest");
+        versions.set(name, yield* resolveVersion(directory, name, spec));
+    }
+    return versions;
+});
+/** Commits `paths` alone and returns the short commit hash. */
+const commitPin = Effect.fn("Cli.commitPin")(function* (directory, paths, message) {
+    yield* runCommand("git", ["add", "--", ...paths], directory, GIT_TIMEOUT);
+    yield* runCommand("git", ["commit", "--quiet", "-m", message, "--", ...paths], directory, GIT_TIMEOUT);
+    const { stdout } = yield* runCommand("git", ["rev-parse", "--short", "HEAD"], directory, GIT_TIMEOUT);
+    return stdout.trim();
+});
+/** Prints the lines of `--check`. */
+const printLines = (lines) => Effect.forEach(lines, (line) => Console.log(line), { discard: true });
+const targetLabel = (command) => Option.isSome(command.version) ? "requested " : "latest    ";
+const runningLine = (record, from) => `running   ${SERVER_PACKAGE} ${record.version}${from}`;
+/**
+ * Moves the instance's `@usine/*` pins to `command.version`, or to `latest`. Refuses while
+ * Attempts are live, unless `--force`. Backs up the stores to `.usine/backups/`, stops the
+ * instance, installs with the instance's package manager, commits the pin change, and starts the
+ * instance again if it was running.
+ */
+export const upgrade = Effect.fn("Cli.upgrade")(function* (directory, command) {
+    const fileSystem = yield* FileSystem.FileSystem;
+    const files = instanceFiles(directory);
+    const fileError = (path) => (error) => new UpgradeFileError({ path, reason: error.message });
+    const state = yield* probeInstance(directory);
+    if (state._tag === "Unrecorded") {
+        return yield* new UnrecordedInstanceError({ command: "upgrade", directory, pid: state.pid });
+    }
+    const running = state._tag === "Running" ? Option.some(state.record) : Option.none();
+    const spec = Option.getOrElse(command.version, () => "latest");
+    yield* Effect.annotateCurrentSpan({ instanceDirectory: directory, spec });
+    // Only a running engine shows where it runs from. A stopped one is whatever the pin installs.
+    if (Option.isSome(running)) {
+        const script = running.value.launch.script;
+        if (!installedInInstance(yield* realPathOrSelf(directory), yield* realPathOrSelf(script))) {
+            if (!command.check) {
+                return yield* new EngineOutsideInstanceError({
+                    script,
+                    version: running.value.version,
+                    packaged: script.includes(`${sep}node_modules${sep}`),
+                });
+            }
+            return yield* printLines([
+                runningLine(running.value, ` from ${script}`),
+                `${targetLabel(command)}${yield* resolveVersion(directory, SERVER_PACKAGE, spec)}`,
+                "The engine runs from outside the instance's node_modules, so usine upgrade doesn't change it.",
+            ]);
+        }
+    }
+    const manifestPath = join(directory, "package.json");
+    const manifest = yield* readManifest(directory);
+    if (Option.isNone(manifest)) {
+        return yield* new EnginePinError({ path: manifestPath, missing: true, linked: Option.none() });
+    }
+    const pin = serverPin(manifest.value);
+    if (Option.isNone(pin)) {
+        return yield* new EnginePinError({
+            path: manifestPath,
+            missing: false,
+            linked: manifest.value.linkedServer,
+        });
+    }
+    const previous = pin.value.spec;
+    const target = yield* resolveVersion(directory, SERVER_PACKAGE, spec);
+    if (command.check) {
+        return yield* printLines([
+            ...Option.toArray(Option.map(running, (record) => runningLine(record, ""))),
+            `pinned    ${previous} in package.json`,
+            `${targetLabel(command)}${target}`,
+            previous === target
+                ? "The pin is up to date."
+                : `Run usine upgrade${Option.isSome(command.version) ? ` ${spec}` : ""} to move the pin to ${target}.`,
+        ]);
+    }
+    if (previous === target) {
+        yield* Console.log(`${SERVER_PACKAGE} is already pinned to ${target}.`);
+        if (Option.isSome(running) && running.value.version !== target) {
+            yield* Console.log(`The running engine is ${running.value.version}. Run usine restart to start ${target}.`);
+        }
+        return;
+    }
+    if (Option.isNone(command.version) && compareVersions(target, previous) < 0) {
+        yield* Console.log(`The latest release, ${target}, is older than the pinned ${previous}. To change the pin, run usine upgrade <version>.`);
+        return;
+    }
+    const versions = yield* targetVersions(directory, manifest.value, target);
+    const lockfiles = yield* Effect.forEach(manifest.value.lockfiles, (file) => {
+        const path = join(directory, file);
+        return fileSystem.readFileString(path).pipe(Effect.map((text) => [path, text]), Effect.mapError(fileError(path)));
+    });
+    const restore = Effect.forEach([[manifest.value.path, manifest.value.text], ...lockfiles], ([path, text]) => fileSystem.writeFileString(path, text).pipe(Effect.tapError((error) => Effect.logError("Could not restore a file after a failed install", {
+        path,
+        message: error.message,
+    })), Effect.ignore), { discard: true });
+    const bumped = bumpPins(manifest.value.text, manifest.value.pins, versions);
+    const rewritten = yield* parseManifest(manifest.value.path, bumped, manifest.value.lockfiles);
+    if (!Option.exists(serverPin(rewritten), ({ spec: pinned }) => pinned === target)) {
+        return yield* Effect.die(new Error(`Could not rewrite the ${SERVER_PACKAGE} pin`));
+    }
+    if (Option.isSome(running)) {
+        yield* refuseMissingEnvironment("upgrade", running.value.launch.port);
+        yield* refuseLiveAttempts("upgrade", running.value.launch.port, command.options.force);
+    }
+    const unit = Option.isSome(running)
+        ? yield* supervisingUnit(running.value.pid, running.value.systemdUnit)
+        : Option.none();
+    yield* Effect.logInfo("Upgrading the engine pin of the instance", {
+        from: previous,
+        to: target,
+        packageManager: manifest.value.packageManager,
+    });
+    yield* Console.log(`Upgrading ${SERVER_PACKAGE} from ${previous} to ${target}.`);
+    const runtimeStore = join(files.folder, "runtime.sqlite");
+    const hasStore = yield* fileSystem
+        .exists(runtimeStore)
+        .pipe(Effect.mapError(fileError(runtimeStore)));
+    // Named after the engine that wrote the store, which its migrations match.
+    const writer = Option.match(running, {
+        onNone: () => previous,
+        onSome: ({ version }) => version,
+    });
+    const backupPath = hasStore
+        ? Option.some(join(files.backups, `runtime-${backupStamp(yield* DateTime.now)}-${writer}.sqlite`))
+        : Option.none();
+    if (Option.isSome(backupPath)) {
+        yield* fileSystem
+            .makeDirectory(files.backups, { recursive: true, mode: 0o700 })
+            .pipe(Effect.mapError(fileError(files.backups)));
+        yield* backup(directory, backupPath.value);
+    }
+    else {
+        yield* Console.log("No runtime store to back up: .usine/runtime.sqlite does not exist.");
+    }
+    if (Option.isSome(running)) {
+        yield* stopProcess("upgrade", running.value.pid, running, unit, command.options);
+    }
+    const failure = (stage, reason, commit, tail) => new UpgradeFailedError({
+        stage,
+        reason,
+        previous,
+        target,
+        packageManager: manifest.value.packageManager,
+        backup: backupPath,
+        commit,
+        tail,
+        unit,
+    });
+    yield* fileSystem
+        .writeFileString(manifest.value.path, bumped)
+        .pipe(Effect.mapError(fileError(manifest.value.path)));
+    yield* runInTerminal(manifest.value.packageManager, ["install"], directory).pipe(Effect.catchTag("CommandError", (error) => restore.pipe(Effect.andThen(Effect.fail(failure("install", `${error.command} ${error.reason}`, Option.none(), ""))))));
+    const installed = yield* readManifest(directory);
+    const paths = [
+        "package.json",
+        ...Option.match(installed, { onNone: () => [], onSome: ({ lockfiles: present }) => present }),
+    ];
+    const commit = yield* commitPin(directory, paths, `Pin ${SERVER_PACKAGE} to ${target}`).pipe(Effect.map(Option.some), Effect.catchTag("CommandError", (error) => Console.log(`Could not commit the pin change (${error.command} ${error.reason}). Commit ${paths.join(", ")} yourself.`).pipe(Effect.as(Option.none()))));
+    if (Option.isSome(commit))
+        yield* Console.log(`Committed the pin change as ${commit.value}.`);
+    if (Option.isNone(running)) {
+        yield* Console.log(`${SERVER_PACKAGE} is now ${target}. usine wasn't running, so start it with usine up --detach.`);
+        return;
+    }
+    const started = yield* startAgain(directory, running.value.launch, unit, running.value.pid, command.options.timeout).pipe(Effect.catchTags({
+        DetachedStartError: (error) => Effect.fail(error.outcome === "exited"
+            ? failure("start", `it exited (${Option.getOrElse(error.exit, () => "unknown")}) before it listened`, commit, error.tail)
+            : failure("listen", `it didn't answer on port ${error.port}, and wrote nothing to its log for ${Duration.format(error.timeout)}`, commit, error.tail)),
+        SystemdStartError: (error) => Effect.fail(error.outcome === "failed"
+            ? failure("start", `${error.unit} was ${error.state} before it listened`, commit, "")
+            : failure("listen", `it didn't answer within ${Duration.format(error.timeout)}`, commit, "")),
+    }));
+    yield* Console.log(startedMessage(started));
+});
+//# sourceMappingURL=upgrade.js.map