@descryy/runtime-orchestrator 0.4.9 → 0.4.10

package/dist/instrumented-execution.js.map

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

package/dist/jvm-agent/build.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Compiles `Agent.java` into `agent.jar` and `Attacher.java` into `Attacher.class`,
+ * once, only when source is newer than build output (same mtime-cache rule
+ * `kotlin-server/build.ts` uses). This is shipped product code —
+ * `attach-to-running-jvm-process.ts` runs the compiled artifacts, never compiles
+ * them at call time.
+ *
+ * **`tools.jar` is JDK-8-only.** `com.sun.tools.attach.VirtualMachine` shipped in
+ * `tools.jar` through JDK 8; from JDK 9 it's in the `jdk.attach` module, no extra
+ * jar needed. `findToolsJarIfPresent` returns `null` when absent (JDK 9+ or no
+ * `tools.jar`) and `Attacher.java` compiles/runs with no extra classpath entry —
+ * correct for JDK 9+, but only exercised against JDK 8 on this machine (disclosed
+ * gap, see this module's decisions-inbox entry).
+ *
+ * **ByteBuddy is vendored** (same pattern as `junit-platform-console-standalone`
+ * for the JUnit reporter): one pinned version, fetched once from Maven Central,
+ * checksum-verified, never a build tool. `Agent.java` needs real bytecode
+ * manipulation for `DispatcherServlet` method-entry advice (RT-201) — hand-written
+ * ASM isn't realistic, and Maven/Gradle would mean resolving a dependency tree for
+ * one library. The plain `net.bytebuddy:byte-buddy` artifact (not `byte-buddy-dep`)
+ * is used because it repackages its own ASM under `net.bytebuddy.jar.asm.*`
+ * (verified via `unzip -l`) — one self-contained jar. **A version bump changes the
+ * URL AND the digest, in one reviewable diff** (plus `MANIFEST.MF`'s `Class-Path`
+ * line, which is static and version-pinned, not generated). `byte-buddy-*.jar`
+ * sits beside `agent.jar` because the JDK resolves an agent JAR's `Class-Path`
+ * relative to the agent JAR's own location.
+ *
+ * **`Agent.java`/`Attacher.java`/`MANIFEST.MF` live in `packages/orchestrator/jvm-agent/`,
+ * a sibling of `src/`/`dist/`, NOT inside `src/jvm-agent/`.** Found the hard way:
+ * `tsc` only emits `.js`/`.d.ts`, so a `.java` file nested inside `src/jvm-agent/`
+ * has no `dist/` counterpart and `import.meta.url`-relative resolution would point
+ * at a source-only directory. A relative URL walking OUT of `src/`/`dist/` to a
+ * shared sibling resolves identically from either, since both sit at the same
+ * depth under `packages/orchestrator/`.
+ */
+export declare const JVM_AGENT_DIR: string;
+export declare const BYTEBUDDY_JAR: string;
+/** Fetches the pinned ByteBuddy jar if absent or its checksum no longer matches — refuses a mismatch rather than proceeding, since this jar is both compiled against and loaded into a target JVM. */
+export declare function ensureByteBuddyJar(): Promise<string>;
+/** `$JAVA_HOME/lib/tools.jar` if it exists, else derived from `java`'s own reported `java.home`. `null` when neither yields a real file — the JDK 9+, no-`tools.jar` case. */
+export declare function findToolsJarIfPresent(): string | null;
+/** Compiles `Agent.java` and packages it as `agent.jar` with `Agent-Class` in its manifest. Returns the jar's path. */
+export declare function buildJvmAgentJar(): Promise<string>;
+/** Compiles `Attacher.java` to `Attacher.class` in this same directory. Returns the directory to put on the classpath (the class itself, not a jar — one file, no packaging step needed). */
+export declare function buildAttacherClass(): string;
+/** Ensures a directory exists (for the caller's tmp output file), mirroring the small helper every attach module in this package already needs once for its own scratch state. */
+export declare function ensureDir(path: string): void;
+//# sourceMappingURL=build.d.ts.map

package/dist/jvm-agent/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/jvm-agent/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAQH,eAAO,MAAM,aAAa,QAA6D,CAAC;AAMxF,eAAO,MAAM,aAAa,QAA6D,CAAC;AAMxF,sMAAsM;AACtM,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAe1D;AAMD,8KAA8K;AAC9K,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAYrD;AAED,uHAAuH;AACvH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuBxD;AAED,6LAA6L;AAC7L,wBAAgB,kBAAkB,IAAI,MAAM,CAY3C;AAED,kLAAkL;AAClL,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C"}

package/dist/jvm-agent/build.js

@@ -0,0 +1,129 @@
+/**
+ * Compiles `Agent.java` into `agent.jar` and `Attacher.java` into `Attacher.class`,
+ * once, only when source is newer than build output (same mtime-cache rule
+ * `kotlin-server/build.ts` uses). This is shipped product code —
+ * `attach-to-running-jvm-process.ts` runs the compiled artifacts, never compiles
+ * them at call time.
+ *
+ * **`tools.jar` is JDK-8-only.** `com.sun.tools.attach.VirtualMachine` shipped in
+ * `tools.jar` through JDK 8; from JDK 9 it's in the `jdk.attach` module, no extra
+ * jar needed. `findToolsJarIfPresent` returns `null` when absent (JDK 9+ or no
+ * `tools.jar`) and `Attacher.java` compiles/runs with no extra classpath entry —
+ * correct for JDK 9+, but only exercised against JDK 8 on this machine (disclosed
+ * gap, see this module's decisions-inbox entry).
+ *
+ * **ByteBuddy is vendored** (same pattern as `junit-platform-console-standalone`
+ * for the JUnit reporter): one pinned version, fetched once from Maven Central,
+ * checksum-verified, never a build tool. `Agent.java` needs real bytecode
+ * manipulation for `DispatcherServlet` method-entry advice (RT-201) — hand-written
+ * ASM isn't realistic, and Maven/Gradle would mean resolving a dependency tree for
+ * one library. The plain `net.bytebuddy:byte-buddy` artifact (not `byte-buddy-dep`)
+ * is used because it repackages its own ASM under `net.bytebuddy.jar.asm.*`
+ * (verified via `unzip -l`) — one self-contained jar. **A version bump changes the
+ * URL AND the digest, in one reviewable diff** (plus `MANIFEST.MF`'s `Class-Path`
+ * line, which is static and version-pinned, not generated). `byte-buddy-*.jar`
+ * sits beside `agent.jar` because the JDK resolves an agent JAR's `Class-Path`
+ * relative to the agent JAR's own location.
+ *
+ * **`Agent.java`/`Attacher.java`/`MANIFEST.MF` live in `packages/orchestrator/jvm-agent/`,
+ * a sibling of `src/`/`dist/`, NOT inside `src/jvm-agent/`.** Found the hard way:
+ * `tsc` only emits `.js`/`.d.ts`, so a `.java` file nested inside `src/jvm-agent/`
+ * has no `dist/` counterpart and `import.meta.url`-relative resolution would point
+ * at a source-only directory. A relative URL walking OUT of `src/`/`dist/` to a
+ * shared sibling resolves identically from either, since both sit at the same
+ * depth under `packages/orchestrator/`.
+ */
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const JVM_AGENT_DIR = fileURLToPath(new URL("../../jvm-agent", import.meta.url));
+/** Pinned. A version bump changes the URL, the digest, and `MANIFEST.MF`'s `Class-Path` line, in one reviewable diff. */
+const BYTEBUDDY_VERSION = "1.15.11";
+const BYTEBUDDY_SHA256 = "fa08998aae1e7bdae83bde0712c50e8444d71c0e0c196bb2247ade8d4ad0eb90";
+const BYTEBUDDY_URL = `https://repo1.maven.org/maven2/net/bytebuddy/byte-buddy/${BYTEBUDDY_VERSION}/byte-buddy-${BYTEBUDDY_VERSION}.jar`;
+export const BYTEBUDDY_JAR = join(JVM_AGENT_DIR, `byte-buddy-${BYTEBUDDY_VERSION}.jar`);
+function digestOf(path) {
+    return createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+/** Fetches the pinned ByteBuddy jar if absent or its checksum no longer matches — refuses a mismatch rather than proceeding, since this jar is both compiled against and loaded into a target JVM. */
+export async function ensureByteBuddyJar() {
+    if (existsSync(BYTEBUDDY_JAR) && digestOf(BYTEBUDDY_JAR) === BYTEBUDDY_SHA256)
+        return BYTEBUDDY_JAR;
+    mkdirSync(JVM_AGENT_DIR, { recursive: true });
+    const response = await fetch(BYTEBUDDY_URL);
+    if (!response.ok) {
+        throw new Error(`jvm-agent build: could not fetch ${BYTEBUDDY_URL} — HTTP ${String(response.status)}`);
+    }
+    writeFileSync(BYTEBUDDY_JAR, Buffer.from(await response.arrayBuffer()));
+    const actual = digestOf(BYTEBUDDY_JAR);
+    if (actual !== BYTEBUDDY_SHA256) {
+        throw new Error(`jvm-agent build: checksum mismatch for ${BYTEBUDDY_JAR}\n  expected ${BYTEBUDDY_SHA256}\n  actual   ${actual}`);
+    }
+    return BYTEBUDDY_JAR;
+}
+function newerThan(output, source) {
+    return existsSync(output) && statSync(output).mtimeMs >= statSync(source).mtimeMs;
+}
+/** `$JAVA_HOME/lib/tools.jar` if it exists, else derived from `java`'s own reported `java.home`. `null` when neither yields a real file — the JDK 9+, no-`tools.jar` case. */
+export function findToolsJarIfPresent() {
+    const fromEnv = process.env["JAVA_HOME"];
+    if (fromEnv !== undefined) {
+        const candidate = join(fromEnv, "lib", "tools.jar");
+        if (existsSync(candidate))
+            return candidate;
+    }
+    const probe = spawnSync("java", ["-XshowSettings:properties", "-version"], { encoding: "utf8" });
+    const combined = `${probe.stdout ?? ""}${probe.stderr ?? ""}`;
+    const match = /java\.home\s*=\s*(.+)/.exec(combined);
+    if (match?.[1] === undefined)
+        return null;
+    const candidate = join(match[1].trim(), "lib", "tools.jar");
+    return existsSync(candidate) ? candidate : null;
+}
+/** Compiles `Agent.java` and packages it as `agent.jar` with `Agent-Class` in its manifest. Returns the jar's path. */
+export async function buildJvmAgentJar() {
+    const source = join(JVM_AGENT_DIR, "Agent.java");
+    const jarPath = join(JVM_AGENT_DIR, "agent.jar");
+    const byteBuddyJar = await ensureByteBuddyJar();
+    // invalidates on either input changing -- a ByteBuddy version bump must rebuild
+    // too, since the compiled advice classes are compiled against it
+    if (newerThan(jarPath, source) && newerThan(jarPath, byteBuddyJar))
+        return jarPath;
+    const compiled = spawnSync("javac", ["-cp", byteBuddyJar, "-d", JVM_AGENT_DIR, source], { encoding: "utf8", timeout: 60_000 });
+    if (compiled.status !== 0) {
+        throw new Error(`javac failed to compile Agent.java. This is a toolchain failure, not a test failure:\n${compiled.stdout ?? ""}${compiled.stderr ?? ""}`);
+    }
+    // Agent.java declares nested static classes (ByteBuddy advice); javac emits one
+    // Agent$Name.class per nested class, and every one must be in the jar or the
+    // JVM throws NoClassDefFoundError when the advice class is needed.
+    const agentClassFiles = readdirSync(JVM_AGENT_DIR).filter((name) => name === "Agent.class" || name.startsWith("Agent$"));
+    const jarArgs = ["cfm", jarPath, join(JVM_AGENT_DIR, "MANIFEST.MF")];
+    for (const classFile of agentClassFiles)
+        jarArgs.push("-C", JVM_AGENT_DIR, classFile);
+    const jarred = spawnSync("jar", jarArgs, { encoding: "utf8", timeout: 30_000 });
+    if (jarred.status !== 0) {
+        throw new Error(`jar failed to package agent.jar:\n${jarred.stdout ?? ""}${jarred.stderr ?? ""}`);
+    }
+    return jarPath;
+}
+/** Compiles `Attacher.java` to `Attacher.class` in this same directory. Returns the directory to put on the classpath (the class itself, not a jar — one file, no packaging step needed). */
+export function buildAttacherClass() {
+    const source = join(JVM_AGENT_DIR, "Attacher.java");
+    const classFile = join(JVM_AGENT_DIR, "Attacher.class");
+    if (newerThan(classFile, source))
+        return JVM_AGENT_DIR;
+    const toolsJar = findToolsJarIfPresent();
+    const args = toolsJar !== null ? ["-cp", toolsJar, "-d", JVM_AGENT_DIR, source] : ["-d", JVM_AGENT_DIR, source];
+    const compiled = spawnSync("javac", args, { encoding: "utf8", timeout: 60_000 });
+    if (compiled.status !== 0) {
+        throw new Error(`javac failed to compile Attacher.java. This is a toolchain failure, not a test failure:\n${compiled.stdout ?? ""}${compiled.stderr ?? ""}`);
+    }
+    return JVM_AGENT_DIR;
+}
+/** Ensures a directory exists (for the caller's tmp output file), mirroring the small helper every attach module in this package already needs once for its own scratch state. */
+export function ensureDir(path) {
+    mkdirSync(path, { recursive: true });
+}
+//# sourceMappingURL=build.js.map

package/dist/jvm-agent/build.js.map

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

package/dist/polling-output-source.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A live `ProcessOutputSource` over a polled buffer.
+ *
+ * `ManagedProcess.readOutput()` returns the whole accumulated stdout+stderr, not a
+ * delta — re-emitting it every tick would duplicate every line. This source tracks
+ * the length already consumed and slices forward from it.
+ *
+ * Ends when `isFinished()` is true **and** the buffer has stopped growing, checked
+ * in that order: a process can exit with output still unread, so stopping at the
+ * exit event alone would drop what it printed on the way out.
+ */
+import { type ProcessOutputSource } from "@descryy/runtime-backend-observation";
+export interface PollingProcessOutputSourceOptions {
+    readonly processId: string;
+    /** Carried onto the `ProcessOutputSource` so collectors can attribute what it emits; `null` is a statement, not an omission. */
+    readonly serviceName: string | null;
+    /** The whole accumulated buffer so far — `ManagedProcess.readOutput` has exactly this shape. */
+    readonly readOutput: () => string;
+    /** True once the process has exited. Output already buffered is still drained afterwards. */
+    readonly isFinished: () => boolean;
+    readonly pollIntervalMs?: number;
+    /**
+     * How many of the lines this source will EVER yield already existed in the
+     * underlying buffer before observation began — e.g. `attachToRunningProcess`'s
+     * attach-time snapshot of an already-running target's log file (RT-N3).
+     * Counted in complete (newline-terminated) lines, not bytes: this source
+     * already reasons in lines, and byte offsets don't survive UTF-8 decoding
+     * cleanly. Default 0 — an ordinary spawned process has no pre-existing
+     * backlog. The Nth line this source yields (0-indexed, across BOTH the main
+     * loop and the final flush) is marked `preExisting: true` when N is less
+     * than this count.
+     *
+     * One disclosed edge case: a line torn exactly at the attach instant (an
+     * unterminated partial already in the file at attach, completed by content
+     * written afterward) is counted as NOT pre-existing by this index-based
+     * rule, even though its opening bytes are — the same "cannot be made
+     * perfectly correct over a plain text file" limit `attachToRunningProcess`
+     * documents, not solved here either.
+     */
+    readonly preExistingLineCount?: number;
+}
+export declare function createPollingProcessOutputSource(options: PollingProcessOutputSourceOptions): ProcessOutputSource;
+//# sourceMappingURL=polling-output-source.d.ts.map

package/dist/polling-output-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-output-source.d.ts","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEtH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gIAAgI;IAChI,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAID,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iCAAiC,GAAG,mBAAmB,CAyDhH"}

package/dist/polling-output-source.js

@@ -0,0 +1,64 @@
+/**
+ * A live `ProcessOutputSource` over a polled buffer.
+ *
+ * `ManagedProcess.readOutput()` returns the whole accumulated stdout+stderr, not a
+ * delta — re-emitting it every tick would duplicate every line. This source tracks
+ * the length already consumed and slices forward from it.
+ *
+ * Ends when `isFinished()` is true **and** the buffer has stopped growing, checked
+ * in that order: a process can exit with output still unread, so stopping at the
+ * exit event alone would drop what it printed on the way out.
+ */
+import { LineSplitter } from "@descryy/runtime-backend-observation";
+const DEFAULT_POLL_INTERVAL_MS = 50;
+export function createPollingProcessOutputSource(options) {
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const preExistingLineCount = options.preExistingLineCount ?? 0;
+    return {
+        processId: options.processId,
+        serviceName: options.serviceName,
+        lines: (async function* () {
+            const splitter = new LineSplitter();
+            let consumed = 0;
+            let lineIndex = 0;
+            function nextLine(text, observedAt) {
+                const preExisting = lineIndex < preExistingLineCount;
+                lineIndex++;
+                return { text, stream: "combined", observedAt, ...(preExisting ? { preExisting: true } : {}) };
+            }
+            for (;;) {
+                const whole = options.readOutput();
+                // Relies on the buffer only ever growing (true of `ManagedProcess` today,
+                // uncapped). If a future cap/rotation shrinks it, `consumed` would sit past
+                // the end and this source would silently emit nothing forever. Throw instead:
+                // `LogCollector`'s consume loop catches it and flips `backendLogAccess`
+                // unavailable (RT-036).
+                if (whole.length < consumed) {
+                    throw new Error(`process output buffer shrank from ${consumed} to ${whole.length} characters — this source ` +
+                        "slices forward from a consumed offset and cannot reconstruct a truncated or rotated buffer " +
+                        "without either duplicating or dropping lines. Reported rather than guessed.");
+                }
+                if (whole.length > consumed) {
+                    const chunk = whole.slice(consumed);
+                    consumed = whole.length;
+                    const observedAt = new Date().toISOString();
+                    for (const text of splitter.push(chunk)) {
+                        yield nextLine(text, observedAt);
+                    }
+                    // no sleep: a burst of output should drain at memory speed
+                    continue;
+                }
+                if (options.isFinished()) {
+                    const observedAt = new Date().toISOString();
+                    // a final unterminated line matters most -- a process dying mid-write
+                    for (const text of splitter.flush()) {
+                        yield nextLine(text, observedAt);
+                    }
+                    return;
+                }
+                await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+            }
+        })(),
+    };
+}
+//# sourceMappingURL=polling-output-source.js.map

package/dist/polling-output-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-output-source.js","sourceRoot":"","sources":["../src/polling-output-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAoD,MAAM,sCAAsC,CAAC;AAgCtH,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAEpC,MAAM,UAAU,gCAAgC,CAAC,OAA0C;IACzF,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC1E,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,CAAC,CAAC;IAE/D,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC;YACrB,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;YACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;YACjB,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,SAAS,QAAQ,CAAC,IAAY,EAAE,UAAkB;gBAChD,MAAM,WAAW,GAAG,SAAS,GAAG,oBAAoB,CAAC;gBACrD,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACjG,CAAC;YAED,SAAS,CAAC;gBACR,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;gBAEnC,0EAA0E;gBAC1E,4EAA4E;gBAC5E,8EAA8E;gBAC9E,wEAAwE;gBACxE,wBAAwB;gBACxB,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,OAAO,KAAK,CAAC,MAAM,4BAA4B;wBAC1F,6FAA6F;wBAC7F,6EAA6E,CAChF,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;oBAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACpC,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC;oBACxB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;wBACxC,MAAM,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACnC,CAAC;oBACD,2DAA2D;oBAC3D,SAAS;gBACX,CAAC;gBAED,IAAI,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;oBACzB,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;oBAC5C,sEAAsE;oBACtE,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;wBACpC,MAAM,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBACnC,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;YACtE,CAAC;QACH,CAAC,CAAC,EAAE;KACL,CAAC;AACJ,CAAC"}

package/dist/profile-backend-observation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Profile-driven backend traffic observation (RT-197, DEC-271).
+ *
+ * `InboundProxy` (RT-192) is wired into `runInstrumentedExecution` via
+ * `frontWithInboundProxy` — the local, Descry-booted half of DEC-271. This module is
+ * the other half: given an `EnvironmentProfile`, decide which of the two mechanisms
+ * (inbound proxy vs. `@descryy/runtime-remote-log-ingestion`) applies, never both.
+ *
+ * **Mutual exclusivity is structural, not asserted** — this file never imports
+ * `createInboundProxy`, so nothing here can construct a proxy. `"localBooted"` is
+ * refused with a `validationError`: DEC-271 names no ingestion mechanism for a
+ * profile Descry itself booted (its proxy path is `frontWithInboundProxy`, not this
+ * function).
+ *
+ * `"localAttached"` is refused too, disclosed rather than guessed: DEC-271's table
+ * covers only "local, booted" and "remote/production", not `"localAttached"`
+ * (RT-024's readiness-then-front sequencing doesn't apply to a process Descry didn't
+ * start). Inventing an answer here would be the guess DEC-266/DEC-271 both reject.
+ */
+import type { Evidence } from "@descryy/runtime-contracts";
+import type { EnvironmentProfile } from "@descryy/runtime-environment-profile";
+import { EvidenceStore } from "@descryy/runtime-evidence-store";
+import { type RemoteLogSourceConfig } from "@descryy/runtime-remote-log-ingestion";
+/**
+ * The mechanism decision exposed as data, not just a side effect, so a caller can
+ * inspect which mechanism a profile resolves to and "never both" is checkable
+ * structurally.
+ */
+export type BackendObservationMechanism = {
+    readonly kind: "inboundProxy";
+} | {
+    readonly kind: "remoteLogIngestion";
+    readonly config: RemoteLogSourceConfig;
+} | {
+    readonly kind: "none";
+    readonly reason: string;
+};
+/**
+ * Pure decision function — DEC-271's table read off `EnvironmentProfile.mode`.
+ * Never touches network or filesystem; `runRemoteLogObservation` below does the
+ * actual ingestion.
+ */
+export declare function backendObservationMechanismFor(profile: EnvironmentProfile): BackendObservationMechanism;
+export interface RunRemoteLogObservationInput {
+    readonly profile: EnvironmentProfile;
+    readonly executionId: string;
+    /** Where ingested lines are written. Provided rather than constructed, same discipline as `InstrumentedExecutionInput.store`. */
+    readonly store: EvidenceStore;
+}
+export interface RunRemoteLogObservationResult {
+    readonly evidence: readonly Evidence[];
+    /** Set when this function refused to ingest anything -- a profile mode this function does not handle, or a declared source this pass has no adapter for. Evidence is empty and that is a refusal, not an absence of logs. */
+    readonly validationError: string | null;
+}
+/**
+ * The remote/production half of DEC-271. Reads the profile's `remoteLogSource`
+ * **once** (`ingestFileLog` is one-shot, see `file-log-adapter.ts`) and writes each
+ * line through `EvidenceStore` as `BACKEND_LOG`, so redaction runs the same as it
+ * does for `LogCollector`'s local-process output.
+ *
+ * Refuses (via `validationError`, never silently empty) when: mode isn't
+ * remote/production; no `remoteLogSource` declared; or `location.kind` isn't
+ * `"file"` — the only built adapter (`"command"`/`"url"` are typed but unbuilt, see
+ * `log-source-config.ts`). Never constructs `InboundProxy` — not imported here.
+ */
+export declare function runRemoteLogObservation(input: RunRemoteLogObservationInput): Promise<RunRemoteLogObservationResult>;
+//# sourceMappingURL=profile-backend-observation.d.ts.map

package/dist/profile-backend-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-backend-observation.d.ts","sourceRoot":"","sources":["../src/profile-backend-observation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAA2C,KAAK,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAI5H;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,GACjC;IAAE,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,kBAAkB,GAAG,2BAA2B,CAkBvG;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iIAAiI;IACjI,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC;IACvC,6NAA6N;IAC7N,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAwDzH"}

package/dist/profile-backend-observation.js

@@ -0,0 +1,107 @@
+/**
+ * Profile-driven backend traffic observation (RT-197, DEC-271).
+ *
+ * `InboundProxy` (RT-192) is wired into `runInstrumentedExecution` via
+ * `frontWithInboundProxy` — the local, Descry-booted half of DEC-271. This module is
+ * the other half: given an `EnvironmentProfile`, decide which of the two mechanisms
+ * (inbound proxy vs. `@descryy/runtime-remote-log-ingestion`) applies, never both.
+ *
+ * **Mutual exclusivity is structural, not asserted** — this file never imports
+ * `createInboundProxy`, so nothing here can construct a proxy. `"localBooted"` is
+ * refused with a `validationError`: DEC-271 names no ingestion mechanism for a
+ * profile Descry itself booted (its proxy path is `frontWithInboundProxy`, not this
+ * function).
+ *
+ * `"localAttached"` is refused too, disclosed rather than guessed: DEC-271's table
+ * covers only "local, booted" and "remote/production", not `"localAttached"`
+ * (RT-024's readiness-then-front sequencing doesn't apply to a process Descry didn't
+ * start). Inventing an answer here would be the guess DEC-266/DEC-271 both reject.
+ */
+import { EvidenceStore } from "@descryy/runtime-evidence-store";
+import { ingestFileLog } from "@descryy/runtime-remote-log-ingestion";
+import { COLLECTOR_VERSION } from "./collector-version.js";
+/**
+ * Pure decision function — DEC-271's table read off `EnvironmentProfile.mode`.
+ * Never touches network or filesystem; `runRemoteLogObservation` below does the
+ * actual ingestion.
+ */
+export function backendObservationMechanismFor(profile) {
+    if (profile.mode === "localBooted") {
+        return { kind: "inboundProxy" };
+    }
+    if (profile.mode === "remote" || profile.mode === "production") {
+        if (profile.remoteLogSource == null) {
+            return {
+                kind: "none",
+                reason: `profile "${profile.name}" is mode "${profile.mode}" but declares no remoteLogSource -- DEC-271's honest "not observable here", not an error.`,
+            };
+        }
+        return { kind: "remoteLogIngestion", config: profile.remoteLogSource };
+    }
+    // localAttached: disclosed gap, see file header.
+    return {
+        kind: "none",
+        reason: `profile "${profile.name}" is mode "localAttached" -- DEC-271 names a mechanism for neither local-attached nor any third case; not guessed at here.`,
+    };
+}
+/**
+ * The remote/production half of DEC-271. Reads the profile's `remoteLogSource`
+ * **once** (`ingestFileLog` is one-shot, see `file-log-adapter.ts`) and writes each
+ * line through `EvidenceStore` as `BACKEND_LOG`, so redaction runs the same as it
+ * does for `LogCollector`'s local-process output.
+ *
+ * Refuses (via `validationError`, never silently empty) when: mode isn't
+ * remote/production; no `remoteLogSource` declared; or `location.kind` isn't
+ * `"file"` — the only built adapter (`"command"`/`"url"` are typed but unbuilt, see
+ * `log-source-config.ts`). Never constructs `InboundProxy` — not imported here.
+ */
+export async function runRemoteLogObservation(input) {
+    const { profile, executionId, store } = input;
+    const mechanism = backendObservationMechanismFor(profile);
+    if (mechanism.kind !== "remoteLogIngestion") {
+        const reason = mechanism.kind === "none"
+            ? mechanism.reason
+            : `profile "${profile.name}" resolves to mechanism "${mechanism.kind}", not remote log ingestion -- runRemoteLogObservation never constructs an InboundProxy, so it refuses rather than silently doing nothing.`;
+        return { evidence: [], validationError: reason };
+    }
+    const { config } = mechanism;
+    if (config.location.kind !== "file") {
+        return {
+            evidence: [],
+            validationError: `remoteLogSource.location.kind "${config.location.kind}" has no ingestion adapter yet -- only "file" is built (see file-log-adapter.ts's own doc); not observable here.`,
+        };
+    }
+    const fileConfig = { ...config, location: config.location };
+    let lines;
+    try {
+        lines = await ingestFileLog({ config: fileConfig });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return { evidence: [], validationError: `remote log ingestion failed for profile "${profile.name}": ${detail}` };
+    }
+    const evidence = [];
+    for (const line of lines) {
+        evidence.push(store.write({
+            executionId,
+            timestamp: line.timestamp ?? new Date().toISOString(),
+            source: "backend-process",
+            service: null,
+            process: null,
+            eventType: "BACKEND_LOG",
+            payload: { raw: line.raw, ingestedVia: "remote-log-ingestion", profile: profile.name },
+            traceId: line.traceId,
+            requestId: line.requestId,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            // the line itself isn't probabilistic; a later correlation to a captured
+            // request is a separate, lower-confidence question (correlateLogLine's tiers)
+            confidence: 1,
+            collectorVersion: COLLECTOR_VERSION,
+        }));
+    }
+    return { evidence, validationError: null };
+}
+//# sourceMappingURL=profile-backend-observation.js.map

package/dist/profile-backend-observation.js.map

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

package/dist/respawn-and-supervise.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Respawn-and-supervise: a separate execution mode next to attach mode, not a
+ * change to attach mode itself.
+ *
+ * **The tradeoff, stated up front — must never apply silently.** Attach mode
+ * reaches an already-running, unconfined process; there is no honest way to
+ * retroactively sandbox it (`sandbox.ts`). This module doesn't try — it kills the
+ * attached target and spawns a fresh equivalent via the existing `spawnProcess()`,
+ * which gets full sandboxing for anything it spawns. Price: in-memory state, open
+ * connections, anything unpersisted is gone the moment the old process is killed.
+ * A caller must choose this explicitly — nothing upgrades an attach into a respawn
+ * on its own.
+ *
+ * **How this learns what to respawn.** Follows RT-032's "declared, never inferred"
+ * precedent: caller-declared (`source: "caller-declared"`) is the recommended,
+ * default path. `/proc/<pid>/cmdline` readback is a real but best-effort,
+ * opt-in-only fallback (`inferRespawnCommandFromProc`), labelled `source:
+ * "proc-cmdline-inferred"` so it's never mistaken for a declaration.
+ *
+ * **Killing the old process.** Doesn't assume ownership of the target's process
+ * group — it may not even be its own group leader — so this signals the individual
+ * pid only (SIGTERM, then SIGKILL after `gracePeriodMs`), not `spawnProcess`'s
+ * group-kill escape hatch (`signalGroup`), which is only valid for a group it
+ * created itself.
+ */
+import { type ManagedProcess, type SpawnProcessOptions } from "@descryy/runtime-controller";
+export type RespawnCommandSource = "caller-declared" | "proc-cmdline-inferred";
+/**
+ * Everything `spawnProcess` needs to relaunch the killed target, plus `source`
+ * (never optional) so a real declaration is always distinguishable from a
+ * best-effort guess.
+ */
+export interface RespawnCommand {
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly cwd: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly source: RespawnCommandSource;
+}
+export interface RespawnAndSuperviseOptions {
+    readonly processId: string;
+    /** The pid of the already-running, attached-to target. Verified alive before anything is killed. */
+    readonly targetPid: number;
+    /** How the replacement process is launched. See file header: `source: "caller-declared"` is the recommended path. */
+    readonly respawn: RespawnCommand;
+    /** How long to wait for the old target to exit after SIGTERM before escalating to SIGKILL. Same default as `ManagedProcess.kill()`. */
+    readonly gracePeriodMs?: number;
+    readonly serviceName?: string;
+    readonly port?: number;
+    readonly resourceLimits?: SpawnProcessOptions["resourceLimits"];
+    readonly filesystemPolicy?: SpawnProcessOptions["filesystemPolicy"];
+    readonly networkPolicy?: SpawnProcessOptions["networkPolicy"];
+}
+export interface RespawnAndSuperviseResult {
+    /** The freshly spawned, supervised (sandboxed if declared) replacement — `spawnProcess()`'s own return, unwrapped. */
+    readonly managedProcess: ManagedProcess;
+    readonly killedPid: number;
+    /** Whether the old target was observed to exit within `gracePeriodMs` of SIGTERM, or needed SIGKILL. Either way this does not return until the old pid is confirmed dead. */
+    readonly killedViaSigkill: boolean;
+    readonly respawnSource: RespawnCommandSource;
+}
+/**
+ * Kills the process at `options.targetPid` and spawns a fresh, supervised,
+ * optionally sandboxed replacement via `spawnProcess()`.
+ *
+ * Not a silent behavior change to attach mode — reached only by explicit call,
+ * never an automatic upgrade path. `ATTACH_MODE_SCOPE_DISCLOSURE` still governs
+ * attach mode itself regardless.
+ *
+ * Throws if `targetPid` isn't alive at call time, matching `attachToRunningProcess`'s
+ * refuse-rather-than-operate-on-nonexistent-target contract.
+ */
+export declare function respawnAndSupervise(options: RespawnAndSuperviseOptions): Promise<RespawnAndSuperviseResult>;
+/**
+ * Opt-in, best-effort convenience — never the default. Reads `/proc/<pid>/cmdline`,
+ * `/cwd` and `/environ` to reconstruct a `RespawnCommand`, labelled `source:
+ * "proc-cmdline-inferred"` so it's never mistaken for a caller declaration.
+ *
+ * Disclosed limitations: Linux-only; `/proc/<pid>/environ` reflects only the
+ * environment at `execve()` time, so env vars set programmatically after exec are
+ * invisible; already-open file descriptors (inherited sockets/pipes) have no
+ * command-line representation and can't be recovered. Returns `null` — never
+ * throws, never guesses partially — when cmdline can't be read or is empty.
+ */
+export declare function inferRespawnCommandFromProc(pid: number, platform?: NodeJS.Platform): RespawnCommand | null;
+//# sourceMappingURL=respawn-and-supervise.d.ts.map