alchemy 2.0.0-beta.84 → 2.0.0-beta.85

package/lib/Util/LogAnnotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogAnnotation.js","sourceRoot":"","sources":["../../src/Util/LogAnnotation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,iBAAiB;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,eAAe;IACtB,mEAAmE;IACnE,KAAK,EAAE,eAAe;IACtB,uDAAuD;IACvD,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,eAAe;IACtB,KAAK,EAAE,eAAe;CACd,CAAC"}

package/lib/Util/LogRecord.d.ts

@@ -0,0 +1,281 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+import * as LogLevel from "effect/LogLevel";
+import * as Schema from "effect/Schema";
+import { Event } from "../Events.ts";
+import { type TraceParent } from "./TraceParent.ts";
+/** Record levels, spelled like `--log-level`. */
+export type Level = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+/**
+ * What a record is, and the first thing a sink filters on:
+ * - `log`: a line alchemy logged;
+ * - `event`: a typed event (see `emit`);
+ * - `output`: a line a child process wrote (dev servers, workerd, the user's code);
+ * - `run`: the first line of a run log, describing the run.
+ */
+export type Kind = "log" | "event" | "output" | "run";
+/**
+ * The envelope every record shares. Every key is always present (`null`
+ * when it doesn't apply), so a reader filters on fields without guessing
+ * which ones a record carries; `data` has the shape its `kind` names.
+ */
+interface Envelope<K extends Kind, Data> {
+    /** Unix time in milliseconds. */
+    readonly time: number;
+    readonly level: Level;
+    readonly kind: K;
+    /** The alchemy process that produced it: `cli`, `exec` or `sidecar`. */
+    readonly process: string;
+    /** Which run log it belongs to: account-level work is `global`. */
+    readonly scope: "project" | "global";
+    /**
+     * The trace and span it was logged in, for joining with telemetry; outside
+     * any span, the process's trace (see `processTrace`).
+     */
+    readonly trace: TraceParent;
+    /** Annotations on the record, beyond the envelope's own fields. */
+    readonly attributes: Readonly<Record<string, unknown>>;
+    readonly data: Data;
+}
+/**
+ * One record as data. Every alchemy process logs these; only the process
+ * that owns the terminal renders them (pretty or JSON), so structure
+ * survives process boundaries instead of being baked into rendered text.
+ */
+export type LogRecord = Envelope<"log", {
+    readonly message: string;
+    readonly cause: string | null;
+}> | Envelope<"event", Event> | Envelope<"output", {
+    readonly stream: "stdout" | "stderr";
+    /** The line as the child wrote it, ANSI styling included. */
+    readonly text: string;
+}> | Envelope<"run", {
+    readonly version: string;
+    readonly pid: number;
+    readonly cwd: string;
+    readonly argv: ReadonlyArray<string>;
+}>;
+/** The name this process stamps on its records: `cli`, `exec` or `sidecar`. */
+export declare const LogProcess: Context.Reference<string>;
+/** The Effect log level of each record {@link Level}. */
+export declare const severities: Record<Level, LogLevel.Severity>;
+/**
+ * `JSON.stringify` that never throws: cycles become `"[Circular]"` and
+ * bigints their decimal string. Logging must not fail the work it reports.
+ */
+export declare const safeStringify: (value: unknown) => string;
+/** A record's {@link Kind}, read from its annotations alone. */
+export declare const kindOf: (options: Logger.Options<unknown>) => Exclude<Kind, "run">;
+/** The record a logger call describes. */
+export declare const recordOf: (options: Logger.Options<unknown>) => LogRecord;
+/**
+ * Mark the logs of `effect` as account-level: the CLI files them in the
+ * global run log (`~/.alchemy/logs`) instead of the project's. For work that
+ * isn't about one project — the state store, auth and credentials, profiles.
+ */
+export declare const globalLogs: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+/**
+ * Set to `json` on alchemy child processes (sidecars) so they log
+ * {@link LogRecord} lines instead of rendering, and on the CLI to print
+ * records as JSON.
+ */
+export declare const LOG_FORMAT_ENV = "ALCHEMY_LOG_FORMAT";
+/** The console's `--log-level`, for child processes that render the run's logs. */
+export declare const LOG_LEVEL_ENV = "ALCHEMY_LOG_LEVEL";
+/** Formats each record as one line of JSON (for `Logger.toFile`). */
+export declare const formatJsonRecord: Logger.Logger<unknown, string>;
+/** A logger that writes each record as one line of JSON. */
+export declare const jsonLogger: (write: (line: string) => void) => Logger.Logger<unknown, void>;
+/**
+ * The only logger of an alchemy child process: every record as a JSON line
+ * on stdout, down to Debug, for the parent to filter and render.
+ */
+export declare const childJsonLogLayer: Layer.Layer<never, never, never>;
+/**
+ * Set on a child process that renders its own terminal output (the
+ * `alchemy dev` exec child) to the file descriptor its parent reads log
+ * records from. The parent writes the run log; the child keeps none.
+ */
+export declare const LOG_FD_ENV = "ALCHEMY_LOG_FD";
+/**
+ * Forward every record, down to Debug, to the parent as JSON lines on the
+ * descriptor in {@link LOG_FD_ENV}, alongside the installed loggers. Empty
+ * when the variable is unset.
+ */
+export declare const parentLogLayer: () => Layer.Layer<never>;
+/**
+ * The wire form of a {@link LogRecord}: what a child process sends and the
+ * run log stores. An event is decoded with the {@link Event} union; one whose
+ * `type` this version doesn't know is kept as-is rather than rejected, so a
+ * newer process's records still pass through.
+ */
+export declare const LogRecordSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly time: Schema.Number;
+    readonly level: Schema.Literals<readonly ["trace", "debug", "info", "warn", "error", "fatal"]>;
+    readonly process: Schema.String;
+    readonly scope: Schema.Literals<readonly ["project", "global"]>;
+    readonly trace: Schema.Struct<{
+        readonly traceId: Schema.String;
+        readonly spanId: Schema.String;
+    }>;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly kind: Schema.Literal<"log">;
+    readonly data: Schema.Struct<{
+        readonly message: Schema.String;
+        readonly cause: Schema.NullOr<Schema.String>;
+    }>;
+}>, Schema.Struct<{
+    readonly time: Schema.Number;
+    readonly level: Schema.Literals<readonly ["trace", "debug", "info", "warn", "error", "fatal"]>;
+    readonly process: Schema.String;
+    readonly scope: Schema.Literals<readonly ["project", "global"]>;
+    readonly trace: Schema.Struct<{
+        readonly traceId: Schema.String;
+        readonly spanId: Schema.String;
+    }>;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly kind: Schema.Literal<"event">;
+    readonly data: Schema.Union<readonly [Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"plan.phase">;
+        readonly phase: Schema.Literals<readonly ["importing-module", "resolving-services", "loading-state", "computing-plan", "plan-ready"]>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"plan.resource.started">;
+        readonly fqn: Schema.String;
+        readonly logicalId: Schema.String;
+        readonly resourceType: Schema.String;
+        readonly total: Schema.Number;
+    }>, Schema.Struct<{
+        readonly fqn: Schema.String;
+        readonly logicalId: Schema.String;
+        readonly resourceType: Schema.String;
+        readonly action: Schema.Literals<readonly ["create", "update", "adopted", "replace", "delete", "orphaned", "noop"]>;
+        readonly bindings: Schema.$Array<Schema.Struct<{
+            readonly sid: Schema.String;
+            readonly action: Schema.Literals<readonly ["create", "update", "delete", "noop"]>;
+        }>>;
+        readonly providerMode: Schema.optionalKey<Schema.Literals<readonly ["local", "live"]>>;
+        readonly fromProviderMode: Schema.optionalKey<Schema.Literals<readonly ["local", "live"]>>;
+        readonly type: Schema.Literal<"plan.resource.completed">;
+        readonly completed: Schema.Number;
+        readonly total: Schema.Number;
+    }>, Schema.Struct<{
+        readonly fqn: Schema.String;
+        readonly logicalId: Schema.String;
+        readonly actionType: Schema.String;
+        readonly action: Schema.Literals<readonly ["run", "delete", "noop"]>;
+        readonly type: Schema.Literal<"plan.action.completed">;
+        readonly completed: Schema.Number;
+        readonly total: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"apply.resource.note">;
+        readonly fqn: Schema.String;
+        readonly id: Schema.String;
+        readonly message: Schema.String;
+        readonly kind: Schema.optionalKey<Schema.Literals<readonly ["status", "output"]>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"apply.resource.status">;
+        readonly fqn: Schema.String;
+        readonly id: Schema.String;
+        readonly resourceType: Schema.String;
+        readonly status: Schema.Literals<readonly ["attaching", "post-attach", "pending", "pre-creating", "creating", "creating replacement", "created", "updating", "updated", "adopting", "adopted", "deleting", "deleted", "orphaning", "orphaned", "replacing", "replaced", "running", "ran", "skipped", "fail"]>;
+        readonly message: Schema.optionalKey<Schema.String>;
+        readonly providerMode: Schema.optionalKey<Schema.Literals<readonly ["local", "live"]>>;
+        readonly fromProviderMode: Schema.optionalKey<Schema.Literals<readonly ["local", "live"]>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"state.bootstrap.started">;
+        readonly store: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"state.bootstrap.completed">;
+        readonly store: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"provider.configure.started">;
+        readonly provider: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"provider.configure.completed">;
+        readonly provider: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"provider.refresh.started">;
+        readonly provider: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"provider.refresh.completed">;
+        readonly provider: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.scan.started">;
+        readonly total: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.scan.provider.started">;
+        readonly provider: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.scan.provider.completed">;
+        readonly provider: Schema.String;
+        readonly resources: Schema.Number;
+        readonly error: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.pass.started">;
+        readonly pass: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.resource.deleted">;
+        readonly provider: Schema.String;
+        readonly resource: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"nuke.resource.failed">;
+        readonly provider: Schema.String;
+        readonly resource: Schema.String;
+        readonly message: Schema.String;
+    }>]>, Schema.StructWithRest<Schema.Struct<{
+        readonly type: Schema.String;
+    }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>]>;
+}>, Schema.Struct<{
+    readonly time: Schema.Number;
+    readonly level: Schema.Literals<readonly ["trace", "debug", "info", "warn", "error", "fatal"]>;
+    readonly process: Schema.String;
+    readonly scope: Schema.Literals<readonly ["project", "global"]>;
+    readonly trace: Schema.Struct<{
+        readonly traceId: Schema.String;
+        readonly spanId: Schema.String;
+    }>;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly kind: Schema.Literal<"output">;
+    readonly data: Schema.Struct<{
+        readonly stream: Schema.Literals<readonly ["stdout", "stderr"]>;
+        readonly text: Schema.String;
+    }>;
+}>, Schema.Struct<{
+    readonly time: Schema.Number;
+    readonly level: Schema.Literals<readonly ["trace", "debug", "info", "warn", "error", "fatal"]>;
+    readonly process: Schema.String;
+    readonly scope: Schema.Literals<readonly ["project", "global"]>;
+    readonly trace: Schema.Struct<{
+        readonly traceId: Schema.String;
+        readonly spanId: Schema.String;
+    }>;
+    readonly attributes: Schema.$Record<Schema.String, Schema.Unknown>;
+    readonly kind: Schema.Literal<"run">;
+    readonly data: Schema.Struct<{
+        readonly version: Schema.String;
+        readonly pid: Schema.Number;
+        readonly cwd: Schema.String;
+        readonly argv: Schema.$Array<Schema.String>;
+    }>;
+}>]>;
+/** Decode one JSON log line, or `undefined` when it isn't a log record. */
+export declare const parseRecord: (line: string) => typeof LogRecordSchema.Type | undefined;
+/**
+ * Log a record from another process through this process's loggers,
+ * keeping its envelope: the sinks here see the record the child produced.
+ */
+export declare const replayRecord: (record: typeof LogRecordSchema.Type) => Effect.Effect<void>;
+/**
+ * Log one line a child process wrote. A JSON {@link LogRecord} (an alchemy
+ * child) is replayed as-is; anything else becomes an Info `output` record,
+ * from `source.process` or, when that's unset, this process.
+ */
+export declare const logChildLine: (line: string, source: {
+    readonly stream: "stdout" | "stderr";
+    readonly resource?: string;
+    readonly process?: string;
+}) => Effect.Effect<void>;
+export {};
+//# sourceMappingURL=LogRecord.d.ts.map

package/lib/Util/LogRecord.d.ts.map

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

package/lib/Util/LogRecord.js

@@ -0,0 +1,267 @@
+import { writeSync } from "node:fs";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+import * as LogLevel from "effect/LogLevel";
+import * as Option from "effect/Option";
+import { CurrentLogAnnotations, MinimumLogLevel } from "effect/References";
+import * as Schema from "effect/Schema";
+import { Event, isKnownEventType } from "../Events.js";
+import { LogAnnotation } from "./LogAnnotation.js";
+import { processTrace, withTraceParent } from "./TraceParent.js";
+const reserved = new Set(Object.values(LogAnnotation).filter((key) => key !== LogAnnotation.fqn));
+/** The name this process stamps on its records: `cli`, `exec` or `sidecar`. */
+export const LogProcess = Context.Reference("alchemy/LogProcess", {
+    defaultValue: () => "cli",
+});
+/** The Effect log level of each record {@link Level}. */
+export const severities = {
+    trace: "Trace",
+    debug: "Debug",
+    info: "Info",
+    warn: "Warn",
+    error: "Error",
+    fatal: "Fatal",
+};
+const levelOf = (logLevel) => logLevel === "All" || logLevel === "None" ? "info" : logLevel.toLowerCase();
+/**
+ * `JSON.stringify` that never throws: cycles become `"[Circular]"` and
+ * bigints their decimal string. Logging must not fail the work it reports.
+ */
+export const safeStringify = (value) => {
+    const seen = new WeakSet();
+    try {
+        return (JSON.stringify(value, (_key, v) => {
+            if (typeof v === "bigint")
+                return v.toString();
+            if (typeof v === "object" && v !== null) {
+                if (seen.has(v))
+                    return "[Circular]";
+                seen.add(v);
+            }
+            return v;
+        }) ?? String(value));
+    }
+    catch {
+        return String(value);
+    }
+};
+const messageText = (message) => {
+    const parts = Array.isArray(message) ? message : [message];
+    return parts
+        .map((part) => typeof part === "string"
+        ? part
+        : part instanceof Error
+            ? (part.stack ?? part.message)
+            : safeStringify(part))
+        .join(" ");
+};
+/** A record's {@link Kind}, read from its annotations alone. */
+export const kindOf = (options) => {
+    const annotations = options.fiber.getRef(CurrentLogAnnotations);
+    return annotations[LogAnnotation.event] === true
+        ? "event"
+        : annotations[LogAnnotation.stream] !== undefined
+            ? "output"
+            : "log";
+};
+const isTrace = (value) => typeof value === "object" &&
+    value !== null &&
+    typeof value.traceId === "string" &&
+    typeof value.spanId === "string";
+/** The record a logger call describes. */
+export const recordOf = (options) => {
+    const all = options.fiber.getRef(CurrentLogAnnotations);
+    const string = (key) => (typeof all[key] === "string" ? all[key] : undefined);
+    const time = all[LogAnnotation.time];
+    const replayedTrace = all[LogAnnotation.trace];
+    const span = options.fiber.cache.span;
+    const head = {
+        time: typeof time === "number" ? time : options.date.getTime(),
+        level: levelOf(options.logLevel),
+    };
+    const envelope = {
+        process: string(LogAnnotation.process) ?? options.fiber.getRef(LogProcess),
+        scope: all[LogAnnotation.scope] === "global" ? "global" : "project",
+        trace: isTrace(replayedTrace)
+            ? replayedTrace
+            : span === undefined
+                ? processTrace
+                : { traceId: span.traceId, spanId: span.spanId },
+        attributes: Object.fromEntries(Object.entries(all).filter(([key]) => !reserved.has(key))),
+    };
+    const first = Array.isArray(options.message) ? options.message[0] : options.message;
+    switch (kindOf(options)) {
+        case "event":
+            // SAFETY: only `emit` (or a replayed event) sets the event annotation,
+            // and it logs one Event.
+            return { ...head, kind: "event", ...envelope, data: first };
+        case "output":
+            return {
+                ...head,
+                kind: "output",
+                ...envelope,
+                data: {
+                    stream: all[LogAnnotation.stream] === "stderr" ? "stderr" : "stdout",
+                    text: messageText(options.message),
+                },
+            };
+        case "log":
+            return {
+                ...head,
+                kind: "log",
+                ...envelope,
+                data: {
+                    message: messageText(options.message),
+                    cause: string(LogAnnotation.cause) ??
+                        (options.cause.reasons.length > 0 ? Cause.pretty(options.cause) : null),
+                },
+            };
+    }
+};
+/**
+ * Mark the logs of `effect` as account-level: the CLI files them in the
+ * global run log (`~/.alchemy/logs`) instead of the project's. For work that
+ * isn't about one project — the state store, auth and credentials, profiles.
+ */
+export const globalLogs = (effect) => Effect.annotateLogs(effect, LogAnnotation.scope, "global");
+/**
+ * Set to `json` on alchemy child processes (sidecars) so they log
+ * {@link LogRecord} lines instead of rendering, and on the CLI to print
+ * records as JSON.
+ */
+export const LOG_FORMAT_ENV = "ALCHEMY_LOG_FORMAT";
+/** The console's `--log-level`, for child processes that render the run's logs. */
+export const LOG_LEVEL_ENV = "ALCHEMY_LOG_LEVEL";
+/** Formats each record as one line of JSON (for `Logger.toFile`). */
+export const formatJsonRecord = Logger.make((options) => safeStringify(recordOf(options)));
+/** A logger that writes each record as one line of JSON. */
+export const jsonLogger = (write) => Logger.map(formatJsonRecord, write);
+/**
+ * The only logger of an alchemy child process: every record as a JSON line
+ * on stdout, down to Debug, for the parent to filter and render.
+ */
+export const childJsonLogLayer = Layer.mergeAll(Logger.layer([jsonLogger((line) => process.stdout.write(`${line}\n`))]), Layer.succeed(MinimumLogLevel, "Debug"));
+/**
+ * Set on a child process that renders its own terminal output (the
+ * `alchemy dev` exec child) to the file descriptor its parent reads log
+ * records from. The parent writes the run log; the child keeps none.
+ */
+export const LOG_FD_ENV = "ALCHEMY_LOG_FD";
+/**
+ * Forward every record, down to Debug, to the parent as JSON lines on the
+ * descriptor in {@link LOG_FD_ENV}, alongside the installed loggers. Empty
+ * when the variable is unset.
+ */
+export const parentLogLayer = () => {
+    const fd = Number(process.env[LOG_FD_ENV]);
+    if (!Number.isInteger(fd) || fd < 3)
+        return Layer.empty;
+    const write = (line) => {
+        try {
+            writeSync(fd, `${line}\n`);
+        }
+        catch {
+            // The parent is gone or stopped reading: logging must not fail the work.
+        }
+    };
+    return Logger.layer([jsonLogger(write)], {
+        mergeWithExisting: true,
+    });
+};
+/** An event of a `type` this version doesn't know: decoded, never validated. */
+const UnknownEvent = Schema.StructWithRest(Schema.Struct({
+    type: Schema.String.check(Schema.makeFilter((type) => !isKnownEventType(type) || "A known event type must decode in full.")),
+}), [Schema.Record(Schema.String, Schema.Unknown)]);
+const envelopeFields = {
+    time: Schema.Number,
+    level: Schema.Literals(["trace", "debug", "info", "warn", "error", "fatal"]),
+    process: Schema.String,
+    scope: Schema.Literals(["project", "global"]),
+    trace: Schema.Struct({ traceId: Schema.String, spanId: Schema.String }),
+    attributes: Schema.Record(Schema.String, Schema.Unknown),
+};
+/**
+ * The wire form of a {@link LogRecord}: what a child process sends and the
+ * run log stores. An event is decoded with the {@link Event} union; one whose
+ * `type` this version doesn't know is kept as-is rather than rejected, so a
+ * newer process's records still pass through.
+ */
+export const LogRecordSchema = Schema.Union([
+    Schema.Struct({
+        ...envelopeFields,
+        kind: Schema.Literal("log"),
+        data: Schema.Struct({ message: Schema.String, cause: Schema.NullOr(Schema.String) }),
+    }),
+    Schema.Struct({
+        ...envelopeFields,
+        kind: Schema.Literal("event"),
+        data: Schema.Union([Event, UnknownEvent]),
+    }),
+    Schema.Struct({
+        ...envelopeFields,
+        kind: Schema.Literal("output"),
+        data: Schema.Struct({ stream: Schema.Literals(["stdout", "stderr"]), text: Schema.String }),
+    }),
+    Schema.Struct({
+        ...envelopeFields,
+        kind: Schema.Literal("run"),
+        data: Schema.Struct({
+            version: Schema.String,
+            pid: Schema.Number,
+            cwd: Schema.String,
+            argv: Schema.Array(Schema.String),
+        }),
+    }),
+]);
+const decodeRecordLine = Schema.decodeUnknownOption(Schema.fromJsonString(LogRecordSchema));
+/** Decode one JSON log line, or `undefined` when it isn't a log record. */
+export const parseRecord = (line) => Option.getOrUndefined(decodeRecordLine(line));
+/**
+ * Log a record from another process through this process's loggers,
+ * keeping its envelope: the sinks here see the record the child produced.
+ */
+export const replayRecord = (record) => record.kind === "run"
+    ? Effect.void
+    : Effect.logWithLevel(severities[record.level])(record.kind === "log"
+        ? record.data.message
+        : record.kind === "output"
+            ? record.data.text
+            : record.data).pipe(Effect.annotateLogs({
+        ...record.attributes,
+        [LogAnnotation.time]: record.time,
+        [LogAnnotation.process]: record.process,
+        [LogAnnotation.trace]: record.trace,
+        [LogAnnotation.scope]: record.scope,
+        ...(record.kind === "event" ? { [LogAnnotation.event]: true } : {}),
+        ...(record.kind === "output" ? { [LogAnnotation.stream]: record.data.stream } : {}),
+        ...(record.kind === "log" && record.data.cause !== null
+            ? { [LogAnnotation.cause]: record.data.cause }
+            : {}),
+    }), 
+    // A record the child already let through keeps reaching the sinks,
+    // whatever this process's minimum level.
+    Effect.provideService(MinimumLogLevel, "Trace"), 
+    // Loggers that read the fiber's span (OTLP) see the child's too.
+    withTraceParent(record.trace));
+/**
+ * Log one line a child process wrote. A JSON {@link LogRecord} (an alchemy
+ * child) is replayed as-is; anything else becomes an Info `output` record,
+ * from `source.process` or, when that's unset, this process.
+ */
+export const logChildLine = (line, source) => {
+    const record = parseRecord(line);
+    if (record !== undefined) {
+        return replayRecord(source.resource !== undefined && record.attributes[LogAnnotation.fqn] === undefined
+            ? { ...record, attributes: { ...record.attributes, [LogAnnotation.fqn]: source.resource } }
+            : record);
+    }
+    return Effect.logInfo(line).pipe(Effect.annotateLogs({
+        [LogAnnotation.stream]: source.stream,
+        ...(source.resource === undefined ? {} : { [LogAnnotation.fqn]: source.resource }),
+        ...(source.process === undefined ? {} : { [LogAnnotation.process]: source.process }),
+    }));
+};
+//# sourceMappingURL=LogRecord.js.map

package/lib/Util/LogRecord.js.map

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

package/lib/Util/Node.d.ts

@@ -1,4 +1,12 @@
 import * as Effect from "effect/Effect";
+declare const NodeOperationFailed_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "NodeOperationFailed";
+} & Readonly<A>;
+export declare class NodeOperationFailed extends NodeOperationFailed_base<{
+    readonly message: string;
+    readonly cause?: unknown;
+}> {
+}
 /**
  * The process's working directory, captured ONCE at module load.
  *
@@ -85,4 +93,5 @@ export declare const isRegisterHooksSupported: (version?: string) => boolean;
  * `EADDRINUSE`.
  */
 export declare const findAvailablePort: (host?: string) => Effect.Effect<number, Error, never>;
+export {};
 //# sourceMappingURL=Node.d.ts.map

package/lib/Util/Node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../src/Util/Node.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAsB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kBAAmB,MAAM,kBACY,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,sBAAsB,QAAO,IAEzC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MAAM,EAKpD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,wBAAsC,OAQ1E,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,wDAkB1B,CAAC"}
+{"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../src/Util/Node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAKxC,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;CAAG;AAEL;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MAAsB,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kBAAmB,MAAM,kBACY,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,sBAAsB,QAAO,IAEzC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MAAM,EAKpD,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,wBAAsC,OAK1E,CAAC;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,wDAsB1B,CAAC"}

package/lib/Util/Node.js

@@ -1,5 +1,11 @@
 import * as NodeNet from "node:net";
+import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import * as SemVer from "effect/SemVer";
+import * as SemVerRange from "effect/SemVerRange";
+export class NodeOperationFailed extends Data.TaggedError("NodeOperationFailed") {
+}
 /**
  * The process's working directory, captured ONCE at module load.
  *
@@ -83,12 +89,10 @@ export const nodeLoaderArgs = (entry) => [
  * before any `.ts` can load. Keep the two in sync.
  */
 export const isRegisterHooksSupported = (version = process.versions.node) => {
-    const [major = 0, minor = 0, patch = 0] = version.split(".").map(Number);
-    return ((major === 22 && (minor > 22 || (minor === 22 && patch >= 3))) ||
-        (major === 24 && (minor > 11 || (minor === 11 && patch >= 1))) ||
-        (major === 25 && minor >= 1) ||
-        major >= 26);
+    const parsed = Result.getOrUndefined(SemVer.parse(version));
+    return (parsed !== undefined && SemVerRange.matches(REGISTER_HOOKS, parsed, { includePrerelease: true }));
 };
+const REGISTER_HOOKS = SemVerRange.parseUnsafe(">=22.22.3 <23.0.0-0 || >=24.11.1 <25.0.0-0 || >=25.1.0");
 /**
  * Ask the OS for an unused TCP port, release it, and return its number.
  *
@@ -111,7 +115,7 @@ export const findAvailablePort = (host = "127.0.0.1") => Effect.callback((resume
                 resume(Effect.succeed(port));
             }
             else {
-                resume(Effect.fail(new Error("Failed to allocate an available port")));
+                resume(Effect.fail(new NodeOperationFailed({ message: "Failed to allocate an available port" })));
             }
         });
     });