@descryy/runtime-orchestrator 0.3.0 → 0.4.0

package/dist/attach-to-running-node-process.d.ts

@@ -1,85 +1,41 @@
 /**
- * Retroactive attach to an already-running **Node** process, via its own
- * inspector protocol — the specific, buildable slice
- * `documents/decisions-inbox/RT-attach-to-running-process-scope.md`
- * deliberately did not build. That entry's own "deliberately not built"
- * list names it directly: "Node's `SIGUSR1` inspector activation + a CDP
- * WebSocket client — real, but Node-only and a new protocol surface, not
- * built this pass." This is that pass, for Node only — the other two items
- * on that list (JVM Attach API, ptrace) remain out of scope, unchanged.
+ * Retroactive attach to an already-running **Node** process, via its own inspector
+ * protocol (JVM Attach API and ptrace remain out of scope, per
+ * `documents/decisions-inbox/RT-attach-to-running-process-scope.md`).
  *
- * **What makes this genuinely retroactive, unlike `attachToRunningProcess`
- * (the file-based sibling in this same package).** That one needs the
- * target to have already been told, at its own launch time, to write
- * output somewhere reachable (`> server.log 2>&1`) — narrower than "attach
- * to anything already running." This one needs nothing declared at launch:
- * `SIGUSR1` (POSIX only; Node's own signal handler, not something this
- * process installs) turns on the target's inspector **after the fact**, on
- * a process that was never started with `--inspect` and never expected to
- * be debugged. From that moment its debugger discovery endpoint is
- * reachable at `http://127.0.0.1:<port>/json`, by the target itself, not by
- * anything this collector primed in advance.
+ * Unlike the file-based `attachToRunningProcess`, this needs nothing declared at
+ * launch: `SIGUSR1` (POSIX only) turns on the target's inspector after the fact,
+ * making `http://127.0.0.1:<port>/json` reachable even on a process never started
+ * with `--inspect`.
  *
- * **The one real limit, disclosed rather than hidden.** `SIGUSR1` does not
- * report back which port the inspector actually bound — Node prints
- * `Debugger listening on ws://host:port/<uuid>` to the target's own
- * *stderr*, which is exactly the channel this module's own doc (and RT-024
- * before it) says cannot be read for a process we did not spawn. So
- * discovery is: try the default port (9229, Node's own default and the one
- * `SIGUSR1` binds to when nothing else is already listening there), and if
- * a caller already knows the target was configured for a different port
- * (`--inspect-port`, `NODE_OPTIONS`), they supply it. **If the port is
- * genuinely unknown and is not 9229, this module cannot discover it** — not
- * attempted, not guessed at by scanning a port range, which would risk
- * attaching to the wrong process's inspector entirely.
+ * **Disclosed limit:** `SIGUSR1` doesn't report which port the inspector bound —
+ * Node prints that to the target's own stderr, unreadable for a process we didn't
+ * spawn (RT-024). So discovery tries the default port (9229) unless the caller
+ * supplies `discoveryPort`; a genuinely unknown non-default port cannot be
+ * discovered (not guessed at by port-scanning, which risks attaching to the wrong
+ * process).
  *
- * **CDP client: written here, not reused, because nothing reusable
- * exists.** `packages/browser`'s console collector speaks CDP only through
- * Playwright's own browser-automation abstraction (`page.on("console")`),
- * which assumes a `Target`/`Page`-domain browser session — a Node inspector
- * session has neither domain, being a single top-level `Runtime` session
- * instead. `cdp-client.ts` in this package is the actual reusable piece:
- * protocol-family-generic, so a future browser-side raw-CDP need could
- * reuse it too, instead of a third client getting written.
+ * CDP client is `cdp-client.ts`, not Playwright's console API, which assumes a
+ * Target/Page-domain session a Node inspector doesn't have (see that file).
  *
- * **Measured: a freshly-spawned target has a brief window, sometimes under
- * 100ms, before Node installs its own `SIGUSR1` handler** — a signal sent
- * inside that window hits POSIX's default action for an unhandled
- * `SIGUSR1` (terminate) instead of toggling the inspector, killing the
- * target rather than attaching to it. Irrelevant to this module's actual
- * purpose — attaching to something genuinely already running, which by
- * definition has been alive far longer than that window — but real, and
- * worth naming for a caller tempted to attach immediately after spawning
- * something themselves.
+ * **Measured:** a freshly-spawned target has a brief window (sometimes under
+ * 100ms) before Node installs its `SIGUSR1` handler; a signal sent inside it hits
+ * POSIX's default terminate action instead of toggling the inspector. Irrelevant
+ * to attaching to something already running, but real for a caller attaching
+ * right after spawning.
  *
- * **Measured side effect: attaching changes the target's crash behaviour.**
- * Once a CDP client is connected, V8 no longer terminates the process
- * immediately on an uncaught exception — it prints "Waiting for the
- * debugger to disconnect..." to stderr and blocks, exactly as it would
- * under a launched `--inspect-brk` session, so a human debugger gets to
- * inspect the paused, crashed state before the process actually exits.
- * Measured directly (a naive test that waited for the child's own `exit`
- * event after attach hung indefinitely) rather than assumed from docs. This
- * is standard CDP/V8 behaviour, not a defect this collector introduces, and
- * not silently worked around: the process resumes its exit exactly when
- * `stop()` closes the CDP session, which is also when the exception's own
- * evidence has already been captured, so nothing about the timing costs a
- * caller the evidence. A caller relying on "did the target exit yet?" as a
- * signal must call `stop()` first.
+ * **Measured side effect:** once CDP connects, V8 no longer terminates on an
+ * uncaught exception — it blocks ("Waiting for the debugger to disconnect...")
+ * exactly as under `--inspect-brk`, until `stop()` closes the session. Standard
+ * CDP/V8 behaviour, not worked around; a caller checking "did the target exit
+ * yet?" must call `stop()` first.
  *
- * **What is captured, and under which vocabulary.** `Runtime.consoleAPICalled`
- * → `CONSOLE_MESSAGE`, `Runtime.exceptionThrown` → `EXCEPTION` — the same
- * two `RuntimeEventType`s `browser-console-collector.ts` already claims for
- * the analogous browser-page concepts, because they are the same concepts
- * (console output; an uncaught exception), observed on a different kind of
- * process. `source: "backend-process"`, not a new source value — this is a
- * backend process being observed, and `EvidenceSource` already names what
- * was observed rather than which mechanism did it (`inbound-proxy.ts`'s own
- * precedent, restated there for exactly this reason). `capabilities()`
- * reports `backendLogAccess`, not `consoleObservation` — `consoleObservation`
- * is `browser-console-collector`'s claim on a *browser page's* console,
- * kept apart from a backend process's console the same way `LogCollector`
- * already keeps them apart for its own text-based capture.
+ * **Vocabulary:** `Runtime.consoleAPICalled`→`CONSOLE_MESSAGE`,
+ * `Runtime.exceptionThrown`→`EXCEPTION`, same `RuntimeEventType`s
+ * `browser-console-collector.ts` uses for the browser-page analogues.
+ * `source: "backend-process"` (not a new value — `EvidenceSource` names what was
+ * observed, not the mechanism). `capabilities()` reports `backendLogAccess`, not
+ * `consoleObservation` (reserved for a browser page's console).
  */
 import type { Collector } from "@descryy/runtime-contracts";
 export interface AttachToRunningNodeProcessOptions {
@@ -89,28 +45,19 @@ export interface AttachToRunningNodeProcessOptions {
     readonly service?: string;
     /** Node's own default inspector bind address. Overridable for a target known to bind elsewhere. */
     readonly discoveryHost?: string;
-    /**
-     * Node's own default inspector port, and the only one `SIGUSR1` reliably
-     * produces on an unmodified target. See this file's own module doc for
-     * why a non-default port cannot be discovered from outside and must be
-     * supplied here when known.
-     */
+    /** Node's default inspector port — the only one `SIGUSR1` reliably produces on an unmodified target. See module doc: a non-default port must be supplied here. */
     readonly discoveryPort?: number;
     /** How long to poll the discovery endpoint after sending SIGUSR1 before giving up. The inspector does not bind instantaneously. */
     readonly discoveryTimeoutMs?: number;
 }
 /**
  * Sends `SIGUSR1` to `pid`, then polls `http://<host>:<port>/json` until the
- * target's inspector answers or `timeoutMs` elapses. Resolves with the
- * `webSocketDebuggerUrl` of the first entry — an already-running Node
- * process presents exactly one inspectable target for its main thread,
- * unlike a browser's `/json`, which lists one entry per open tab.
+ * inspector answers or `timeoutMs` elapses. Resolves with the first entry's
+ * `webSocketDebuggerUrl` — a Node process presents exactly one inspectable
+ * target, unlike a browser's `/json` (one per tab).
  *
- * Rejects, naming the exact blocker, rather than hanging or guessing: a pid
- * that was never alive, a POSIX-only signal on a non-POSIX platform, or a
- * port that never answers (most often because the real inspector bound
- * somewhere other than `port`, which this function has no way to learn —
- * see the module doc).
+ * Rejects naming the exact blocker rather than hanging or guessing: dead pid,
+ * non-POSIX platform, or a port that never answers (see module doc).
  */
 export declare function discoverNodeInspectorUrl(pid: number, options?: {
     readonly host?: string;
@@ -118,21 +65,16 @@ export declare function discoverNodeInspectorUrl(pid: number, options?: {
     readonly timeoutMs?: number;
 }): Promise<string>;
 /**
- * Attach to an already-running Node process via `SIGUSR1` + CDP, and start
- * capturing `CONSOLE_MESSAGE`/`EXCEPTION` evidence from that moment forward.
+ * Attach to an already-running Node process via `SIGUSR1` + CDP, capturing
+ * `CONSOLE_MESSAGE`/`EXCEPTION` evidence from that moment forward.
  *
- * **Retroactive, not historical.** Anything the target logged or threw
- * *before* this attaches is gone — `SIGUSR1` turns the inspector on, it
- * does not hand over a backlog. `attachToRunningProcess` (the file-based
- * sibling) is the one that can recover pre-attach lines, and only because a
- * file on disk already held them; nothing analogous exists for CDP, which
- * is a live event stream with no buffer of its own.
+ * **Retroactive, not historical.** Anything logged or thrown before attach is
+ * gone — CDP is a live event stream with no buffer of its own (unlike the
+ * file-based `attachToRunningProcess`, which recovers pre-attach lines from disk).
  *
- * Discovery and connection happen inside `start()`, not here — matching
- * every other `Collector` in this repo (`createBrowserConsoleCollector`,
- * `createTestRunnerCollector`): a routine failure to attach resolves as
- * `{ available: false, reason }`, never a thrown exception a caller has to
- * remember to catch.
+ * Discovery/connection happen inside `start()`, matching every other `Collector`
+ * here: a routine failure resolves as `{ available: false, reason }`, never a
+ * thrown exception.
  */
 export declare function attachToRunningNodeProcess(options: AttachToRunningNodeProcessOptions): Collector;
 //# sourceMappingURL=attach-to-running-node-process.d.ts.map

package/dist/attach-to-running-node-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attach-to-running-node-process.d.ts","sourceRoot":"","sources":["../src/attach-to-running-node-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAyG,MAAM,4BAA4B,CAAC;AAMnK,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uIAAuI;IACvI,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mIAAmI;IACnI,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5F,OAAO,CAAC,MAAM,CAAC,CAyCjB;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,SAAS,CAqHhG"}
+{"version":3,"file":"attach-to-running-node-process.d.ts","sourceRoot":"","sources":["../src/attach-to-running-node-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAyG,MAAM,4BAA4B,CAAC;AAsCnK,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uIAAuI;IACvI,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,kKAAkK;IAClK,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mIAAmI;IACnI,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAOD;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5F,OAAO,CAAC,MAAM,CAAC,CA+CjB;AAsED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,SAAS,CAmHhG"}

package/dist/attach-to-running-node-process.js

@@ -1,101 +1,85 @@
 /**
- * Retroactive attach to an already-running **Node** process, via its own
- * inspector protocol — the specific, buildable slice
- * `documents/decisions-inbox/RT-attach-to-running-process-scope.md`
- * deliberately did not build. That entry's own "deliberately not built"
- * list names it directly: "Node's `SIGUSR1` inspector activation + a CDP
- * WebSocket client — real, but Node-only and a new protocol surface, not
- * built this pass." This is that pass, for Node only — the other two items
- * on that list (JVM Attach API, ptrace) remain out of scope, unchanged.
+ * Retroactive attach to an already-running **Node** process, via its own inspector
+ * protocol (JVM Attach API and ptrace remain out of scope, per
+ * `documents/decisions-inbox/RT-attach-to-running-process-scope.md`).
  *
- * **What makes this genuinely retroactive, unlike `attachToRunningProcess`
- * (the file-based sibling in this same package).** That one needs the
- * target to have already been told, at its own launch time, to write
- * output somewhere reachable (`> server.log 2>&1`) — narrower than "attach
- * to anything already running." This one needs nothing declared at launch:
- * `SIGUSR1` (POSIX only; Node's own signal handler, not something this
- * process installs) turns on the target's inspector **after the fact**, on
- * a process that was never started with `--inspect` and never expected to
- * be debugged. From that moment its debugger discovery endpoint is
- * reachable at `http://127.0.0.1:<port>/json`, by the target itself, not by
- * anything this collector primed in advance.
+ * Unlike the file-based `attachToRunningProcess`, this needs nothing declared at
+ * launch: `SIGUSR1` (POSIX only) turns on the target's inspector after the fact,
+ * making `http://127.0.0.1:<port>/json` reachable even on a process never started
+ * with `--inspect`.
  *
- * **The one real limit, disclosed rather than hidden.** `SIGUSR1` does not
- * report back which port the inspector actually bound — Node prints
- * `Debugger listening on ws://host:port/<uuid>` to the target's own
- * *stderr*, which is exactly the channel this module's own doc (and RT-024
- * before it) says cannot be read for a process we did not spawn. So
- * discovery is: try the default port (9229, Node's own default and the one
- * `SIGUSR1` binds to when nothing else is already listening there), and if
- * a caller already knows the target was configured for a different port
- * (`--inspect-port`, `NODE_OPTIONS`), they supply it. **If the port is
- * genuinely unknown and is not 9229, this module cannot discover it** — not
- * attempted, not guessed at by scanning a port range, which would risk
- * attaching to the wrong process's inspector entirely.
+ * **Disclosed limit:** `SIGUSR1` doesn't report which port the inspector bound —
+ * Node prints that to the target's own stderr, unreadable for a process we didn't
+ * spawn (RT-024). So discovery tries the default port (9229) unless the caller
+ * supplies `discoveryPort`; a genuinely unknown non-default port cannot be
+ * discovered (not guessed at by port-scanning, which risks attaching to the wrong
+ * process).
  *
- * **CDP client: written here, not reused, because nothing reusable
- * exists.** `packages/browser`'s console collector speaks CDP only through
- * Playwright's own browser-automation abstraction (`page.on("console")`),
- * which assumes a `Target`/`Page`-domain browser session — a Node inspector
- * session has neither domain, being a single top-level `Runtime` session
- * instead. `cdp-client.ts` in this package is the actual reusable piece:
- * protocol-family-generic, so a future browser-side raw-CDP need could
- * reuse it too, instead of a third client getting written.
+ * CDP client is `cdp-client.ts`, not Playwright's console API, which assumes a
+ * Target/Page-domain session a Node inspector doesn't have (see that file).
  *
- * **Measured: a freshly-spawned target has a brief window, sometimes under
- * 100ms, before Node installs its own `SIGUSR1` handler** — a signal sent
- * inside that window hits POSIX's default action for an unhandled
- * `SIGUSR1` (terminate) instead of toggling the inspector, killing the
- * target rather than attaching to it. Irrelevant to this module's actual
- * purpose — attaching to something genuinely already running, which by
- * definition has been alive far longer than that window — but real, and
- * worth naming for a caller tempted to attach immediately after spawning
- * something themselves.
+ * **Measured:** a freshly-spawned target has a brief window (sometimes under
+ * 100ms) before Node installs its `SIGUSR1` handler; a signal sent inside it hits
+ * POSIX's default terminate action instead of toggling the inspector. Irrelevant
+ * to attaching to something already running, but real for a caller attaching
+ * right after spawning.
  *
- * **Measured side effect: attaching changes the target's crash behaviour.**
- * Once a CDP client is connected, V8 no longer terminates the process
- * immediately on an uncaught exception — it prints "Waiting for the
- * debugger to disconnect..." to stderr and blocks, exactly as it would
- * under a launched `--inspect-brk` session, so a human debugger gets to
- * inspect the paused, crashed state before the process actually exits.
- * Measured directly (a naive test that waited for the child's own `exit`
- * event after attach hung indefinitely) rather than assumed from docs. This
- * is standard CDP/V8 behaviour, not a defect this collector introduces, and
- * not silently worked around: the process resumes its exit exactly when
- * `stop()` closes the CDP session, which is also when the exception's own
- * evidence has already been captured, so nothing about the timing costs a
- * caller the evidence. A caller relying on "did the target exit yet?" as a
- * signal must call `stop()` first.
+ * **Measured side effect:** once CDP connects, V8 no longer terminates on an
+ * uncaught exception — it blocks ("Waiting for the debugger to disconnect...")
+ * exactly as under `--inspect-brk`, until `stop()` closes the session. Standard
+ * CDP/V8 behaviour, not worked around; a caller checking "did the target exit
+ * yet?" must call `stop()` first.
  *
- * **What is captured, and under which vocabulary.** `Runtime.consoleAPICalled`
- * → `CONSOLE_MESSAGE`, `Runtime.exceptionThrown` → `EXCEPTION` — the same
- * two `RuntimeEventType`s `browser-console-collector.ts` already claims for
- * the analogous browser-page concepts, because they are the same concepts
- * (console output; an uncaught exception), observed on a different kind of
- * process. `source: "backend-process"`, not a new source value — this is a
- * backend process being observed, and `EvidenceSource` already names what
- * was observed rather than which mechanism did it (`inbound-proxy.ts`'s own
- * precedent, restated there for exactly this reason). `capabilities()`
- * reports `backendLogAccess`, not `consoleObservation` — `consoleObservation`
- * is `browser-console-collector`'s claim on a *browser page's* console,
- * kept apart from a backend process's console the same way `LogCollector`
- * already keeps them apart for its own text-based capture.
+ * **Vocabulary:** `Runtime.consoleAPICalled`→`CONSOLE_MESSAGE`,
+ * `Runtime.exceptionThrown`→`EXCEPTION`, same `RuntimeEventType`s
+ * `browser-console-collector.ts` uses for the browser-page analogues.
+ * `source: "backend-process"` (not a new value — `EvidenceSource` names what was
+ * observed, not the mechanism). `capabilities()` reports `backendLogAccess`, not
+ * `consoleObservation` (reserved for a browser page's console).
  */
+import { spawnSync } from "node:child_process";
 import { connectCdp } from "./cdp-client.js";
 import { isProcessAlive } from "./attach-to-running-process.js";
 import { COLLECTOR_VERSION } from "./collector-version.js";
+/**
+ * A-F10: verifies `pid` is owned by this process's own user AND looks like a
+ * Node process, BEFORE `SIGUSR1` is sent — a wrong-kind pid with no handler hits
+ * POSIX's default terminate action; `isProcessAlive` alone doesn't rule that out.
+ *
+ * Uses `ps -o uid=,comm= -p <pid>` rather than `/proc/<pid>` since this module is
+ * POSIX-only and `ps` works on both Linux and macOS. Refuses rather than guesses
+ * when `ps` itself can't answer.
+ *
+ * Same-user, not same-session: the kernel lets any same-user process signal any
+ * other, so this check is the only backstop for `SIGUSR1` — unlike HotSpot's
+ * attach socket (the JVM sibling), which enforces uid at the OS level itself.
+ */
+function verifyLikelyNodeProcessOwnedBySelf(pid) {
+    const result = spawnSync("ps", ["-o", "uid=,comm=", "-p", String(pid)], { encoding: "utf8" });
+    const line = (result.stdout ?? "").trim().split("\n")[0]?.trim();
+    if (result.status !== 0 || line === undefined || line === "") {
+        return { ok: false, reason: `could not verify pid ${String(pid)}'s owner/command via ps (exit ${String(result.status)}) — refusing to signal a process this module cannot confirm the identity of` };
+    }
+    const [uidField, ...commFields] = line.split(/\s+/);
+    const uid = Number(uidField);
+    const comm = commFields.join(" ").toLowerCase();
+    const ownUid = process.getuid?.();
+    if (ownUid !== undefined && uid !== ownUid) {
+        return { ok: false, reason: `pid ${String(pid)} is owned by uid ${String(uid)}, not this process's own uid ${String(ownUid)} — refusing to signal a process this session does not own` };
+    }
+    if (!comm.includes("node")) {
+        return { ok: false, reason: `pid ${String(pid)}'s command is "${comm}", which does not look like a Node process — refusing to send SIGUSR1 to a process that may not handle it` };
+    }
+    return { ok: true };
+}
 /**
  * Sends `SIGUSR1` to `pid`, then polls `http://<host>:<port>/json` until the
- * target's inspector answers or `timeoutMs` elapses. Resolves with the
- * `webSocketDebuggerUrl` of the first entry — an already-running Node
- * process presents exactly one inspectable target for its main thread,
- * unlike a browser's `/json`, which lists one entry per open tab.
+ * inspector answers or `timeoutMs` elapses. Resolves with the first entry's
+ * `webSocketDebuggerUrl` — a Node process presents exactly one inspectable
+ * target, unlike a browser's `/json` (one per tab).
  *
- * Rejects, naming the exact blocker, rather than hanging or guessing: a pid
- * that was never alive, a POSIX-only signal on a non-POSIX platform, or a
- * port that never answers (most often because the real inspector bound
- * somewhere other than `port`, which this function has no way to learn —
- * see the module doc).
+ * Rejects naming the exact blocker rather than hanging or guessing: dead pid,
+ * non-POSIX platform, or a port that never answers (see module doc).
  */
 export async function discoverNodeInspectorUrl(pid, options = {}) {
     if (!isProcessAlive(pid)) {
@@ -104,6 +88,11 @@ export async function discoverNodeInspectorUrl(pid, options = {}) {
     if (process.platform === "win32") {
         throw new Error("discoverNodeInspectorUrl: SIGUSR1 inspector activation is POSIX-only; not available on win32.");
     }
+    // A-F10: verified BEFORE the signal — a wrong pid must never reach process.kill
+    const identity = verifyLikelyNodeProcessOwnedBySelf(pid);
+    if (!identity.ok) {
+        throw new Error(`discoverNodeInspectorUrl: ${identity.reason}.`);
+    }
     const host = options.host ?? "127.0.0.1";
     const port = options.port ?? 9229;
     const timeoutMs = options.timeoutMs ?? 5000;
@@ -135,7 +124,7 @@ export async function discoverNodeInspectorUrl(pid, options = {}) {
         "process, or the target was itself configured with --inspect-port/NODE_OPTIONS) — this module cannot discover a " +
         "non-default port from outside; a caller who knows the real port must supply discoveryPort.");
 }
-/** A `file://` URL is decoded to a plain filesystem path — every other adapter in this repo reports a path, never a URL, and CDP is the only source in this file that starts with one. Anything else (`node:internal/timers`, a bare module specifier) is passed through verbatim, the same "kept, not filtered" treatment `adapter-rust`'s std/core frames get. */
+/** Decodes a `file://` URL to a plain filesystem path, matching every other adapter's convention. Anything else is passed through verbatim. */
 function pathFromCdpUrl(url) {
     if (url === undefined || url === "")
         return null;
@@ -148,16 +137,14 @@ function pathFromCdpUrl(url) {
         return url;
     }
 }
-/** CDP reports 0-based line/column; every other location in this codebase is 1-based (source lines as an editor shows them). Converted here, once, rather than left for a reader to notice CDP is the one odd source. */
+/** CDP reports 0-based line/column; converted to this codebase's 1-based convention here, once. */
 function locationFromCallFrame(frame) {
     return {
         file: pathFromCdpUrl(frame.url),
         line: typeof frame.lineNumber === "number" ? frame.lineNumber + 1 : null,
         column: typeof frame.columnNumber === "number" ? frame.columnNumber + 1 : null,
         functionName: frame.functionName !== undefined && frame.functionName !== "" ? frame.functionName : null,
-        // V8's own reported state, captured live off the running process — the
-        // same class a Python traceback or Ruby backtrace gets, never a side
-        // artifact this collector resolved through.
+        // V8's own reported state, captured live -- never a side artifact resolved through
         reliability: "self-contained",
         resolvedVia: null,
     };
@@ -178,19 +165,14 @@ function notThisCollectorsJob(what) {
 }
 const CAPABILITIES = {
     domObservation: notThisCollectorsJob("DOM inspection"),
-    // Reserved for a browser page's console (browser-console-collector.ts's
-    // own claim); this observes a backend process's, reported under
-    // backendLogAccess instead, matching LogCollector's own split.
+    // reserved for a browser page's console; this is a backend process's, reported
+    // under backendLogAccess instead, matching LogCollector's own split
     consoleObservation: notThisCollectorsJob("a browser page's console"),
     networkObservation: notThisCollectorsJob("network traffic"),
     backendLogAccess: { availability: "available", reason: null },
     distributedTrace: notThisCollectorsJob("trace-id/request-id correlation — CDP's Runtime domain carries no such fields to extract"),
-    // Self-contained, from V8's own reported call-frame state, the same
-    // standing Go's/Rust's/Ruby's own rows already have — never a side
-    // artifact this collector resolved through. A target running compiled or
-    // bundled output would still report positions in that output verbatim,
-    // the same honest limit every self-contained-reliability adapter in this
-    // repo carries, not something specific to Node inspector observation.
+    // self-contained reliability: a bundled/compiled target still reports positions
+    // in that output verbatim, same limit every self-contained adapter carries
     sourceMapping: { availability: "available", reason: null },
     stackCapture: { availability: "available", reason: null },
     processLifecycle: notThisCollectorsJob("process lifecycle — spawn/ready/exit are ProcessCollector's to observe"),
@@ -198,21 +180,16 @@ const CAPABILITIES = {
     externalServiceObservation: notThisCollectorsJob("outbound external requests"),
 };
 /**
- * Attach to an already-running Node process via `SIGUSR1` + CDP, and start
- * capturing `CONSOLE_MESSAGE`/`EXCEPTION` evidence from that moment forward.
+ * Attach to an already-running Node process via `SIGUSR1` + CDP, capturing
+ * `CONSOLE_MESSAGE`/`EXCEPTION` evidence from that moment forward.
  *
- * **Retroactive, not historical.** Anything the target logged or threw
- * *before* this attaches is gone — `SIGUSR1` turns the inspector on, it
- * does not hand over a backlog. `attachToRunningProcess` (the file-based
- * sibling) is the one that can recover pre-attach lines, and only because a
- * file on disk already held them; nothing analogous exists for CDP, which
- * is a live event stream with no buffer of its own.
+ * **Retroactive, not historical.** Anything logged or thrown before attach is
+ * gone — CDP is a live event stream with no buffer of its own (unlike the
+ * file-based `attachToRunningProcess`, which recovers pre-attach lines from disk).
  *
- * Discovery and connection happen inside `start()`, not here — matching
- * every other `Collector` in this repo (`createBrowserConsoleCollector`,
- * `createTestRunnerCollector`): a routine failure to attach resolves as
- * `{ available: false, reason }`, never a thrown exception a caller has to
- * remember to catch.
+ * Discovery/connection happen inside `start()`, matching every other `Collector`
+ * here: a routine failure resolves as `{ available: false, reason }`, never a
+ * thrown exception.
  */
 export function attachToRunningNodeProcess(options) {
     let session = null;
@@ -271,10 +248,8 @@ export function attachToRunningNodeProcess(options) {
                         : (details.text ?? "Uncaught exception");
                 const callFrames = details.stackTrace?.callFrames ?? [];
                 const frames = callFrames.map((frame) => ({ location: locationFromCallFrame(frame), raw: `${frame.functionName ?? "<anonymous>"} (${frame.url ?? ""}:${String(frame.lineNumber)}:${String(frame.columnNumber)})` }));
-                // No frames from CDP means the throw site itself (url/lineNumber
-                // directly on exceptionDetails) is the only location available —
-                // still real, so it becomes a synthetic one-frame trace rather than
-                // being discarded.
+                // no frames from CDP: fall back to the throw site itself as a synthetic
+                // one-frame trace rather than discarding it
                 const stackTrace = frames.length > 0
                     ? { fidelity: "synchronous", frames, primaryFrameIndex: 0 }
                     : {

package/dist/attach-to-running-node-process.js.map

@@ -1 +1 @@
-{"version":3,"file":"attach-to-running-node-process.js","sourceRoot":"","sources":["../src/attach-to-running-node-process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"attach-to-running-node-process.js","sourceRoot":"","sources":["../src/attach-to-running-node-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,OAAO,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;;;;;;GAYG;AACH,SAAS,kCAAkC,CAAC,GAAW;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9F,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAC7D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,MAAM,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,6EAA6E,EAAE,CAAC;IACvM,CAAC;IACD,MAAM,CAAC,QAAQ,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAClC,IAAI,MAAM,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,GAAG,CAAC,gCAAgC,MAAM,CAAC,MAAM,CAAC,2DAA2D,EAAE,CAAC;IAC3L,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,MAAM,CAAC,GAAG,CAAC,kBAAkB,IAAI,2GAA2G,EAAE,CAAC;IACpL,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAoBD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAW,EACX,UAA2F,EAAE;IAE7F,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;IACnH,CAAC;IAED,gFAAgF;IAChF,MAAM,QAAQ,GAAG,kCAAkC,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,YAAY,GAAG,UAAU,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;IAE3D,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAE7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,SAAS,GAAY,IAAI,CAAC;IAC9B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;YAC3C,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;gBAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,oBAAoB,KAAK,SAAS,CAAC,CAAC;gBACzF,IAAI,MAAM,EAAE,oBAAoB,KAAK,SAAS;oBAAE,OAAO,MAAM,CAAC,oBAAoB,CAAC;YACrF,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,MAAM,IAAI,KAAK,CACb,sDAAsD,YAAY,WAAW,MAAM,CAAC,SAAS,CAAC,mBAAmB,MAAM,IAAI;QACzH,oHAAoH;QACpH,iHAAiH;QACjH,4FAA4F,CAC/F,CAAC;AACJ,CAAC;AAeD,+IAA+I;AAC/I,SAAS,cAAc,CAAC,GAAuB;IAC7C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC;AAED,mGAAmG;AACnG,SAAS,qBAAqB,CAAC,KAAmB;IAChD,OAAO;QACL,IAAI,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC;QAC/B,IAAI,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QACxE,MAAM,EAAE,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QAC9E,YAAY,EAAE,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI;QACvG,mFAAmF;QACnF,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAgC;IACzD,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1G,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,WAAW,CAAC;QAC1D,OAAO,IAAI,GAAG,CAAC,IAAI,IAAI,SAAS,GAAG,CAAC;IACtC,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,uGAAuG,IAAI,GAAG,EAAE,CAAC;AACjK,CAAC;AAED,MAAM,YAAY,GAA0B;IAC1C,cAAc,EAAE,oBAAoB,CAAC,gBAAgB,CAAC;IACtD,+EAA+E;IAC/E,oEAAoE;IACpE,kBAAkB,EAAE,oBAAoB,CAAC,0BAA0B,CAAC;IACpE,kBAAkB,EAAE,oBAAoB,CAAC,iBAAiB,CAAC;IAC3D,gBAAgB,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7D,gBAAgB,EAAE,oBAAoB,CAAC,0FAA0F,CAAC;IAClI,gFAAgF;IAChF,2EAA2E;IAC3E,aAAa,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IAC1D,YAAY,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IACzD,gBAAgB,EAAE,oBAAoB,CAAC,wEAAwE,CAAC;IAChH,mBAAmB,EAAE,oBAAoB,CAAC,kBAAkB,CAAC;IAC7D,0BAA0B,EAAE,oBAAoB,CAAC,4BAA4B,CAAC;CAC/E,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA0C;IACnF,IAAI,OAAO,GAAsB,IAAI,CAAC;IAEtC,OAAO;QACL,WAAW,EAAE,yBAAyB,OAAO,CAAC,SAAS,EAAE;QAEzD,KAAK,CAAC,KAAK,CAAC,OAAyB;YACnC,IAAI,oBAA4B,CAAC;YACjC,IAAI,CAAC;gBACH,oBAAoB,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,GAAG,EAAE;oBACjE,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/E,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/F,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,UAAU,CAAC,oBAAoB,CAAC,CAAC;YACnD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO;oBACL,SAAS,EAAE,KAAK;oBAChB,MAAM,EAAE,8FAA8F,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC/J,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAErC,OAAO,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,MAAM,EAAE,EAAE;gBAChD,MAAM,CAAC,GAAG,MAAyE,CAAC;gBACpF,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,MAAM,EAAE,iBAAiB;oBACzB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;oBAChC,OAAO,EAAE,OAAO,CAAC,SAAS;oBAC1B,SAAS,EAAE,iBAAiB;oBAC5B,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,EAAE,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;oBAC1E,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,IAAI;oBACpB,UAAU,EAAE,IAAI;oBAChB,UAAU,EAAE,CAAC;oBACb,eAAe,EAAE,mBAAmB;oBACpC,gBAAgB,EAAE,iBAAiB;iBACpC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,CAAC,EAAE,CAAC,yBAAyB,EAAE,CAAC,MAAM,EAAE,EAAE;gBAC/C,MAAM,CAAC,GAAG,MAST,CAAC;gBACF,MAAM,OAAO,GAAG,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC;gBACzC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;gBACnD,MAAM,OAAO,GACX,WAAW,KAAK,SAAS;oBACvB,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;oBAC7C,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,KAAK,SAAS;wBACtC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;wBACjC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,oBAAoB,CAAC,CAAC;gBAE/C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE,CAAC;gBACxD,MAAM,MAAM,GAAiB,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,YAAY,IAAI,aAAa,KAAK,KAAK,CAAC,GAAG,IAAI,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACnO,wEAAwE;gBACxE,4CAA4C;gBAC5C,MAAM,UAAU,GACd,MAAM,CAAC,MAAM,GAAG,CAAC;oBACf,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE;oBAC3D,CAAC,CAAC;wBACE,QAAQ,EAAE,aAAa;wBACvB,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,qBAAqB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,IAAI,OAAO,EAAE,CAAC;wBACpK,iBAAiB,EAAE,CAAC;qBACrB,CAAC;gBAER,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,MAAM,EAAE,iBAAiB;oBACzB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;oBAChC,OAAO,EAAE,OAAO,CAAC,SAAS;oBAC1B,SAAS,EAAE,WAAW;oBACtB,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,IAAI,IAAI,EAAE;oBAChD,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,IAAI;oBACnB,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,QAAQ,IAAI,IAAI;oBACjF,UAAU;oBACV,UAAU,EAAE,CAAC;oBACb,eAAe,EAAE,mBAAmB;oBACpC,gBAAgB,EAAE,iBAAiB;iBACpC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;QAED,IAAI;YACF,OAAO,EAAE,KAAK,EAAE,CAAC;YACjB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,YAAY;YACV,OAAO,YAAY,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}