@rubytech/create-realagent 1.0.615 → 1.0.616

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent",
-  "version": "1.0.615",
+  "version": "1.0.616",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent": "./dist/index.js"

package/payload/platform/config/brand.json

@@ -43,5 +43,9 @@
     "defaultEnabled": ["sales"],
     "available": ["deep-research", "waitlist", "projects", "whatsapp", "replicate"],
     "excluded": ["telegram"]
+  },
+
+  "cloudflare": {
+    "zones": ["realagent.network"]
   }
 }

package/payload/platform/lib/mcp-stderr-tee/dist/index.d.ts

@@ -15,27 +15,37 @@
  * │     │                   │
  * │     ├──► original stderr (consumed by Claude Code — opaque)
  * │     │
- * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks; Task 362)
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
  * │     │
- * │     └──► claude-agent-stream-{YYYY-MM-DD}.log  (per-line, prefixed; Task 524)
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
  * │           "[<iso>] [mcp:{name}] <line>"
- * │           rotates on date boundary
  * └─────────────────────────┘
  *
- * The stream-log destination puts MCP diagnostic lines in the same file the
- * platform already writes agent events to, so a single logs-read returns a
- * complete session timeline. The per-server file is retained unchanged —
- * it remains the grep-one-plugin surface.
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced by Task 532: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
  */
 /**
- * Patch process.stderr.write to tee to both a per-server raw log and the
- * unified claude-agent-stream log (with a [mcp:<serverName>] prefix).
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
  *
- * Reads LOG_DIR from environment. When absent (dev mode, tool discovery),
- * does nothing — stderr works as before with no markers emitted.
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
  *
- * Safe to call once at MCP server module load. Not safe to call twice —
- * repeated calls would stack patches and double-log every chunk.
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
  */
 export declare function initStderrTee(serverName: string): void;
 //# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/mcp-stderr-tee/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAeH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkKtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAeH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAyItD"}

package/payload/platform/lib/mcp-stderr-tee/dist/index.js

@@ -16,17 +16,22 @@
  * │     │                   │
  * │     ├──► original stderr (consumed by Claude Code — opaque)
  * │     │
- * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks; Task 362)
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
  * │     │
- * │     └──► claude-agent-stream-{YYYY-MM-DD}.log  (per-line, prefixed; Task 524)
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
  * │           "[<iso>] [mcp:{name}] <line>"
- * │           rotates on date boundary
  * └─────────────────────────┘
  *
- * The stream-log destination puts MCP diagnostic lines in the same file the
- * platform already writes agent events to, so a single logs-read returns a
- * complete session timeline. The per-server file is retained unchanged —
- * it remains the grep-one-plugin surface.
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced by Task 532: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initStderrTee = initStderrTee;
@@ -38,19 +43,23 @@ const node_string_decoder_1 = require("node:string_decoder");
 // call would stack patches and double-log every chunk.
 const INIT_MARKER = Symbol.for("maxy.mcpStderrTee.installed");
 /**
- * Patch process.stderr.write to tee to both a per-server raw log and the
- * unified claude-agent-stream log (with a [mcp:<serverName>] prefix).
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
  *
- * Reads LOG_DIR from environment. When absent (dev mode, tool discovery),
- * does nothing — stderr works as before with no markers emitted.
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
  *
- * Safe to call once at MCP server module load. Not safe to call twice —
- * repeated calls would stack patches and double-log every chunk.
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
  */
 function initStderrTee(serverName) {
     const logDir = process.env.LOG_DIR;
-    if (!logDir)
-        return; // Dev mode or tool discovery — stderr only
+    const streamLogPath = process.env.STREAM_LOG_PATH;
     // Refuse repeat patches — stacking them would double-log every chunk
     // and corrupt the re-entrancy guard (originalWrite would capture the
     // already-patched function on the second call).
@@ -60,74 +69,59 @@ function initStderrTee(serverName) {
     // from inside this module MUST go through originalWrite to avoid
     // re-entering the patched writer (which would recurse on a tee failure).
     const originalWrite = process.stderr.write.bind(process.stderr);
-    // Per-server raw-chunk file (Task 362). Opened once, never rotated —
-    // preserves existing behaviour.
+    const tsPrefix = () => `[${new Date().toISOString()}]`;
+    const skipTee = (reason, destination) => {
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-skip] server=${serverName} destination=${destination} reason=${JSON.stringify(reason)}\n`);
+    };
+    // --- Destination 1: per-server raw file (optional, existing Task 362 behaviour)
     let perServerStream;
-    try {
-        (0, node_fs_1.mkdirSync)(logDir, { recursive: true });
-        const date = new Date().toISOString().slice(0, 10);
-        perServerStream = (0, node_fs_1.createWriteStream)((0, node_path_1.resolve)(logDir, `mcp-${serverName}-stderr-${date}.log`), { flags: "a" });
-        perServerStream.on("error", (err) => {
-            originalWrite(`[${new Date().toISOString()}] [platform] mcp stream tee per-server write error server=${serverName} reason=${err.message}\n`);
-        });
+    if (logDir) {
+        try {
+            (0, node_fs_1.mkdirSync)(logDir, { recursive: true });
+            const date = new Date().toISOString().slice(0, 10);
+            perServerStream = (0, node_fs_1.createWriteStream)((0, node_path_1.resolve)(logDir, `mcp-${serverName}-stderr-${date}.log`), { flags: "a" });
+            perServerStream.on("error", (err) => {
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=per-server reason=${JSON.stringify(err.message)}\n`);
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            skipTee(msg, "per-server");
+            perServerStream = undefined;
+        }
     }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        originalWrite(`[${new Date().toISOString()}] [platform] mcp stream tee disabled reason=${msg} server=${serverName} destination=per-server\n`);
-        // If the per-server file can't be opened, the LOG_DIR itself is likely
-        // unusable — give up on the whole tee rather than half-install it.
-        return;
+    else {
+        skipTee("LOG_DIR not set", "per-server");
     }
-    // Stream-log destination (Task 524). Lazily re-opened on date boundary so
-    // a long-lived MCP server started yesterday routes today's output into
-    // today's stream-log file, matching the platform's rotation semantics.
+    // --- Destination 2: per-conversation stream log (Task 532)
     let streamLogStream;
-    let streamLogDate = ""; // YYYY-MM-DD the current stream was opened for
-    let streamLogDisabledReason;
-    const openStreamLog = () => {
-        const today = new Date().toISOString().slice(0, 10);
-        if (streamLogStream && streamLogDate === today)
-            return streamLogStream;
-        // Date boundary crossed (or first open). Close the old stream before
-        // opening the new one so the file descriptor is released. Also clear
-        // any prior disabled reason — the previous failure may have been
-        // transient (EMFILE, ENOSPC), and the new day's path is fresh.
-        if (streamLogStream && streamLogDate !== today) {
-            try {
-                streamLogStream.end();
-            }
-            catch { /* ignore */ }
-            streamLogStream = undefined;
-            streamLogDisabledReason = undefined;
-        }
-        if (streamLogDisabledReason)
-            return undefined;
-        const path = (0, node_path_1.resolve)(logDir, `claude-agent-stream-${today}.log`);
+    if (streamLogPath) {
         try {
-            const s = (0, node_fs_1.createWriteStream)(path, { flags: "a" });
+            (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(streamLogPath), { recursive: true });
+            const s = (0, node_fs_1.createWriteStream)(streamLogPath, { flags: "a" });
             s.on("error", (err) => {
-                originalWrite(`[${new Date().toISOString()}] [platform] mcp stream tee stream-log write error server=${serverName} reason=${err.message}\n`);
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=stream-log reason=${JSON.stringify(err.message)}\n`);
             });
             streamLogStream = s;
-            streamLogDate = today;
-            // Startup marker lands in the stream log itself so investigators reading
-            // a session's stream-log file can confirm the tee was wired up.
-            s.write(`[${new Date().toISOString()}] [platform] attaching mcp stream tee for server=${serverName} logPath=${path}\n`);
-            return s;
+            // Attach marker lands in the stream log itself so investigators can
+            // confirm per-conversation the tee was wired up.
+            s.write(`${tsPrefix()} [platform] [mcp-tee-attach] server=${serverName} streamLogPath=${streamLogPath}\n`);
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);
-            streamLogDisabledReason = msg;
-            const line = `[${new Date().toISOString()}] [platform] mcp stream tee disabled reason=${msg} server=${serverName} destination=stream-log\n`;
-            originalWrite(line);
-            if (perServerStream && !perServerStream.destroyed)
-                perServerStream.write(line);
-            return undefined;
+            skipTee(msg, "stream-log");
+            streamLogStream = undefined;
         }
-    };
-    // Prime the stream log once so the startup marker appears immediately
-    // rather than waiting for the first stderr chunk.
-    openStreamLog();
+    }
+    else {
+        skipTee("STREAM_LOG_PATH not set", "stream-log");
+    }
+    // If neither tee target is available, leave stderr untouched — patching
+    // the writer to a no-op tee would still consume event-loop cycles on
+    // every write for zero observability gain.
+    if (!perServerStream && !streamLogStream) {
+        return;
+    }
     // Line buffer — accumulates characters written to stderr so complete
     // newline-terminated lines can be prefixed and emitted to the stream log.
     // Partial chunks are held until a newline arrives (or beforeExit flushes).
@@ -139,6 +133,8 @@ function initStderrTee(serverName) {
     // produces strings — but plugins piping child-process stderr can hit this.
     const utf8 = new node_string_decoder_1.StringDecoder("utf8");
     const emitCompleteLinesToStreamLog = (chunk) => {
+        if (!streamLogStream)
+            return;
         lineBuffer += chunk;
         let newlineIndex;
         // eslint-disable-next-line no-cond-assign
@@ -147,10 +143,9 @@ function initStderrTee(serverName) {
             lineBuffer = lineBuffer.slice(newlineIndex + 1);
             if (line.length === 0)
                 continue; // skip blank lines
-            const stream = openStreamLog();
-            if (!stream || stream.destroyed || stream.writableEnded)
+            if (streamLogStream.destroyed || streamLogStream.writableEnded)
                 continue;
-            stream.write(`[${new Date().toISOString()}] [mcp:${serverName}] ${line}\n`);
+            streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${line}\n`);
         }
     };
     process.stderr.write = (chunk, ...args) => {
@@ -158,16 +153,18 @@ function initStderrTee(serverName) {
         if (perServerStream && !perServerStream.destroyed) {
             perServerStream.write(chunk);
         }
-        // 2. Stream log — per-line, prefixed, date-rotating.
-        try {
-            const text = typeof chunk === "string"
-                ? chunk
-                : utf8.write(Buffer.from(chunk));
-            emitCompleteLinesToStreamLog(text);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            originalWrite(`[${new Date().toISOString()}] [platform] mcp stream tee emit error server=${serverName} reason=${msg}\n`);
+        // 2. Stream log — per-line, prefixed.
+        if (streamLogStream) {
+            try {
+                const text = typeof chunk === "string"
+                    ? chunk
+                    : utf8.write(Buffer.from(chunk));
+                emitCompleteLinesToStreamLog(text);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                originalWrite(`${tsPrefix()} [platform] [mcp-tee-emit-error] server=${serverName} reason=${JSON.stringify(msg)}\n`);
+            }
         }
         // 3. Original stderr — Claude Code still gets what it's always got.
         return originalWrite(chunk, ...args);
@@ -181,11 +178,11 @@ function initStderrTee(serverName) {
     // shutdown anyway. This hook exists for the rare caller that uses
     // process.stderr.write without a trailing newline.
     process.on("beforeExit", () => {
-        if (lineBuffer.length === 0)
-            return;
-        const stream = openStreamLog();
-        if (stream && !stream.destroyed && !stream.writableEnded) {
-            stream.write(`[${new Date().toISOString()}] [mcp:${serverName}] ${lineBuffer}\n`);
+        if (streamLogStream && !streamLogStream.destroyed && !streamLogStream.writableEnded) {
+            if (lineBuffer.length > 0) {
+                streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${lineBuffer}\n`);
+            }
+            streamLogStream.write(`${tsPrefix()} [platform] [mcp-tee-detach] server=${serverName} reason=process-before-exit\n`);
         }
         lineBuffer = "";
     });

package/payload/platform/lib/mcp-stderr-tee/dist/index.js.map

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

package/payload/platform/lib/mcp-stderr-tee/src/index.ts

@@ -15,17 +15,22 @@
  * │     │                   │
  * │     ├──► original stderr (consumed by Claude Code — opaque)
  * │     │
- * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks; Task 362)
+ * │     ├──► mcp-{name}-stderr-{YYYY-MM-DD}.log    (raw chunks, per-plugin)
  * │     │
- * │     └──► claude-agent-stream-{YYYY-MM-DD}.log  (per-line, prefixed; Task 524)
+ * │     └──► $STREAM_LOG_PATH                      (per-line, prefixed)
  * │           "[<iso>] [mcp:{name}] <line>"
- * │           rotates on date boundary
  * └─────────────────────────┘
  *
- * The stream-log destination puts MCP diagnostic lines in the same file the
- * platform already writes agent events to, so a single logs-read returns a
- * complete session timeline. The per-server file is retained unchanged —
- * it remains the grep-one-plugin surface.
+ * $STREAM_LOG_PATH is set by the spawner (`getMcpServers` in `claude-agent.ts`)
+ * to the per-conversation stream log file. The MCP server code itself knows
+ * nothing about conversations — it just trusts the spawner's path. This is
+ * the scope boundary introduced by Task 532: the tee is attached per spawn,
+ * not per MCP-server process lifetime. Servers spawned for conversation A
+ * write to conversation A's file; servers for B write to B's file.
+ *
+ * Every decision is logged via `[mcp-tee-*]` markers on both the target file
+ * and the original stderr so an investigator can confirm from the stream log
+ * which tees were wired up, which were skipped, and why.
  */
 
 import {
@@ -33,7 +38,7 @@ import {
   createWriteStream,
   type WriteStream,
 } from "node:fs";
-import { resolve } from "node:path";
+import { resolve, dirname } from "node:path";
 import { StringDecoder } from "node:string_decoder";
 
 // Marker on process.stderr.write so repeat calls to initStderrTee() are
@@ -42,18 +47,23 @@ import { StringDecoder } from "node:string_decoder";
 const INIT_MARKER = Symbol.for("maxy.mcpStderrTee.installed");
 
 /**
- * Patch process.stderr.write to tee to both a per-server raw log and the
- * unified claude-agent-stream log (with a [mcp:<serverName>] prefix).
+ * Patch process.stderr.write to tee to:
+ *   1. Per-server raw log (`mcp-<serverName>-stderr-<date>.log` under LOG_DIR).
+ *   2. The per-conversation stream log at `STREAM_LOG_PATH` — per-line, prefixed.
+ *   3. The original stderr (consumed by Claude Code) — always preserved.
  *
- * Reads LOG_DIR from environment. When absent (dev mode, tool discovery),
- * does nothing — stderr works as before with no markers emitted.
+ * LOG_DIR absent → skip per-server raw file (dev mode / tool discovery).
+ * STREAM_LOG_PATH absent → skip stream-log destination (older spawner or
+ *   standalone invocation). In both absent cases, stderr works unchanged —
+ *   a `[mcp-tee-skip]` marker is written to original stderr so the skip is
+ *   visible to journalctl-level readers.
  *
- * Safe to call once at MCP server module load. Not safe to call twice —
- * repeated calls would stack patches and double-log every chunk.
+ * Safe to call once at MCP server module load. Refused on second call to
+ * prevent stacking patches.
  */
 export function initStderrTee(serverName: string): void {
   const logDir = process.env.LOG_DIR;
-  if (!logDir) return; // Dev mode or tool discovery — stderr only
+  const streamLogPath = process.env.STREAM_LOG_PATH;
 
   // Refuse repeat patches — stacking them would double-log every chunk
   // and corrupt the re-entrancy guard (originalWrite would capture the
@@ -65,83 +75,61 @@ export function initStderrTee(serverName: string): void {
   // re-entering the patched writer (which would recurse on a tee failure).
   const originalWrite = process.stderr.write.bind(process.stderr);
 
-  // Per-server raw-chunk file (Task 362). Opened once, never rotated —
-  // preserves existing behaviour.
+  const tsPrefix = () => `[${new Date().toISOString()}]`;
+  const skipTee = (reason: string, destination: string) => {
+    originalWrite(`${tsPrefix()} [platform] [mcp-tee-skip] server=${serverName} destination=${destination} reason=${JSON.stringify(reason)}\n`);
+  };
+
+  // --- Destination 1: per-server raw file (optional, existing Task 362 behaviour)
   let perServerStream: WriteStream | undefined;
-  try {
-    mkdirSync(logDir, { recursive: true });
-    const date = new Date().toISOString().slice(0, 10);
-    perServerStream = createWriteStream(
-      resolve(logDir, `mcp-${serverName}-stderr-${date}.log`),
-      { flags: "a" },
-    );
-    perServerStream.on("error", (err) => {
-      originalWrite(
-        `[${new Date().toISOString()}] [platform] mcp stream tee per-server write error server=${serverName} reason=${err.message}\n`,
+  if (logDir) {
+    try {
+      mkdirSync(logDir, { recursive: true });
+      const date = new Date().toISOString().slice(0, 10);
+      perServerStream = createWriteStream(
+        resolve(logDir, `mcp-${serverName}-stderr-${date}.log`),
+        { flags: "a" },
       );
-    });
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    originalWrite(
-      `[${new Date().toISOString()}] [platform] mcp stream tee disabled reason=${msg} server=${serverName} destination=per-server\n`,
-    );
-    // If the per-server file can't be opened, the LOG_DIR itself is likely
-    // unusable — give up on the whole tee rather than half-install it.
-    return;
+      perServerStream.on("error", (err) => {
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=per-server reason=${JSON.stringify(err.message)}\n`);
+      });
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      skipTee(msg, "per-server");
+      perServerStream = undefined;
+    }
+  } else {
+    skipTee("LOG_DIR not set", "per-server");
   }
 
-  // Stream-log destination (Task 524). Lazily re-opened on date boundary so
-  // a long-lived MCP server started yesterday routes today's output into
-  // today's stream-log file, matching the platform's rotation semantics.
+  // --- Destination 2: per-conversation stream log (Task 532)
   let streamLogStream: WriteStream | undefined;
-  let streamLogDate = ""; // YYYY-MM-DD the current stream was opened for
-  let streamLogDisabledReason: string | undefined;
-
-  const openStreamLog = (): WriteStream | undefined => {
-    const today = new Date().toISOString().slice(0, 10);
-    if (streamLogStream && streamLogDate === today) return streamLogStream;
-
-    // Date boundary crossed (or first open). Close the old stream before
-    // opening the new one so the file descriptor is released. Also clear
-    // any prior disabled reason — the previous failure may have been
-    // transient (EMFILE, ENOSPC), and the new day's path is fresh.
-    if (streamLogStream && streamLogDate !== today) {
-      try { streamLogStream.end(); } catch { /* ignore */ }
-      streamLogStream = undefined;
-      streamLogDisabledReason = undefined;
-    }
-
-    if (streamLogDisabledReason) return undefined;
-
-    const path = resolve(logDir, `claude-agent-stream-${today}.log`);
+  if (streamLogPath) {
     try {
-      const s = createWriteStream(path, { flags: "a" });
+      mkdirSync(dirname(streamLogPath), { recursive: true });
+      const s = createWriteStream(streamLogPath, { flags: "a" });
       s.on("error", (err) => {
-        originalWrite(
-          `[${new Date().toISOString()}] [platform] mcp stream tee stream-log write error server=${serverName} reason=${err.message}\n`,
-        );
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-error] server=${serverName} destination=stream-log reason=${JSON.stringify(err.message)}\n`);
       });
       streamLogStream = s;
-      streamLogDate = today;
-      // Startup marker lands in the stream log itself so investigators reading
-      // a session's stream-log file can confirm the tee was wired up.
-      s.write(
-        `[${new Date().toISOString()}] [platform] attaching mcp stream tee for server=${serverName} logPath=${path}\n`,
-      );
-      return s;
+      // Attach marker lands in the stream log itself so investigators can
+      // confirm per-conversation the tee was wired up.
+      s.write(`${tsPrefix()} [platform] [mcp-tee-attach] server=${serverName} streamLogPath=${streamLogPath}\n`);
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      streamLogDisabledReason = msg;
-      const line = `[${new Date().toISOString()}] [platform] mcp stream tee disabled reason=${msg} server=${serverName} destination=stream-log\n`;
-      originalWrite(line);
-      if (perServerStream && !perServerStream.destroyed) perServerStream.write(line);
-      return undefined;
+      skipTee(msg, "stream-log");
+      streamLogStream = undefined;
     }
-  };
+  } else {
+    skipTee("STREAM_LOG_PATH not set", "stream-log");
+  }
 
-  // Prime the stream log once so the startup marker appears immediately
-  // rather than waiting for the first stderr chunk.
-  openStreamLog();
+  // If neither tee target is available, leave stderr untouched — patching
+  // the writer to a no-op tee would still consume event-loop cycles on
+  // every write for zero observability gain.
+  if (!perServerStream && !streamLogStream) {
+    return;
+  }
 
   // Line buffer — accumulates characters written to stderr so complete
   // newline-terminated lines can be prefixed and emitted to the stream log.
@@ -156,6 +144,7 @@ export function initStderrTee(serverName: string): void {
   const utf8 = new StringDecoder("utf8");
 
   const emitCompleteLinesToStreamLog = (chunk: string): void => {
+    if (!streamLogStream) return;
     lineBuffer += chunk;
     let newlineIndex: number;
     // eslint-disable-next-line no-cond-assign
@@ -163,11 +152,8 @@ export function initStderrTee(serverName: string): void {
       const line = lineBuffer.slice(0, newlineIndex);
       lineBuffer = lineBuffer.slice(newlineIndex + 1);
       if (line.length === 0) continue; // skip blank lines
-      const stream = openStreamLog();
-      if (!stream || stream.destroyed || stream.writableEnded) continue;
-      stream.write(
-        `[${new Date().toISOString()}] [mcp:${serverName}] ${line}\n`,
-      );
+      if (streamLogStream.destroyed || streamLogStream.writableEnded) continue;
+      streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${line}\n`);
     }
   };
 
@@ -179,17 +165,17 @@ export function initStderrTee(serverName: string): void {
     if (perServerStream && !perServerStream.destroyed) {
       perServerStream.write(chunk);
     }
-    // 2. Stream log — per-line, prefixed, date-rotating.
-    try {
-      const text = typeof chunk === "string"
-        ? chunk
-        : utf8.write(Buffer.from(chunk));
-      emitCompleteLinesToStreamLog(text);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      originalWrite(
-        `[${new Date().toISOString()}] [platform] mcp stream tee emit error server=${serverName} reason=${msg}\n`,
-      );
+    // 2. Stream log — per-line, prefixed.
+    if (streamLogStream) {
+      try {
+        const text = typeof chunk === "string"
+          ? chunk
+          : utf8.write(Buffer.from(chunk));
+        emitCompleteLinesToStreamLog(text);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        originalWrite(`${tsPrefix()} [platform] [mcp-tee-emit-error] server=${serverName} reason=${JSON.stringify(msg)}\n`);
+      }
     }
     // 3. Original stderr — Claude Code still gets what it's always got.
     return (originalWrite as (chunk: string | Uint8Array, ...a: unknown[]) => boolean)(chunk, ...args);
@@ -204,12 +190,11 @@ export function initStderrTee(serverName: string): void {
   // shutdown anyway. This hook exists for the rare caller that uses
   // process.stderr.write without a trailing newline.
   process.on("beforeExit", () => {
-    if (lineBuffer.length === 0) return;
-    const stream = openStreamLog();
-    if (stream && !stream.destroyed && !stream.writableEnded) {
-      stream.write(
-        `[${new Date().toISOString()}] [mcp:${serverName}] ${lineBuffer}\n`,
-      );
+    if (streamLogStream && !streamLogStream.destroyed && !streamLogStream.writableEnded) {
+      if (lineBuffer.length > 0) {
+        streamLogStream.write(`${tsPrefix()} [mcp:${serverName}] ${lineBuffer}\n`);
+      }
+      streamLogStream.write(`${tsPrefix()} [platform] [mcp-tee-detach] server=${serverName} reason=process-before-exit\n`);
     }
     lineBuffer = "";
   });