@rubytech/create-realagent 1.0.617 → 1.0.618

package/payload/server/public/index.html

@@ -5,7 +5,7 @@
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Real Agent</title>
   <link rel="icon" href="/favicon.ico">
-  <script type="module" crossorigin src="/assets/admin-Df1liz4Y.js"></script>
+  <script type="module" crossorigin src="/assets/admin-D7LRdkYB.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/chunk-Be6NvmcD.js">
   <link rel="modulepreload" crossorigin href="/assets/preload-helper-rov5CBGT.js">
   <link rel="modulepreload" crossorigin href="/assets/useVoiceRecorder-OB_Gtr0e.js">

package/payload/server/server.js

@@ -6211,14 +6211,22 @@ function purgeOldLogs(logDir, prefix) {
   }
 }
 function teeProcStderrToStreamLog(proc, streamLog) {
+  const pid = proc.pid;
   if (!proc.stderr) {
-    streamLog.write(`[${isoTs()}] [subproc-stderr-skip] reason=no-stderr
+    streamLog.write(`[${isoTs()}] [subproc-stderr-skip] reason=no-stderr pid=${pid}
 `);
     return;
   }
+  if (!streamLog.destroyed && !streamLog.writableEnded) {
+    streamLog.write(`[${isoTs()}] [subproc-stderr-tee-attached] pid=${pid}
+`);
+  }
   const utf8 = new StringDecoder("utf8");
   let buffer = "";
+  let bytesSeen = 0;
+  let linesEmitted = 0;
   proc.stderr.on("data", (chunk) => {
+    bytesSeen += typeof chunk === "string" ? Buffer.byteLength(chunk, "utf8") : chunk.length;
     const text = typeof chunk === "string" ? chunk : utf8.write(chunk);
     buffer += text;
     let idx;
@@ -6229,12 +6237,18 @@ function teeProcStderrToStreamLog(proc, streamLog) {
       if (streamLog.destroyed || streamLog.writableEnded) continue;
       streamLog.write(`[${isoTs()}] [subproc-stderr] ${line}
 `);
+      linesEmitted++;
     }
   });
   proc.stderr.on("end", () => {
     const tail = (buffer + utf8.end()).trim();
     if (tail.length > 0 && !streamLog.destroyed && !streamLog.writableEnded) {
       streamLog.write(`[${isoTs()}] [subproc-stderr] ${tail}
+`);
+      linesEmitted++;
+    }
+    if (!streamLog.destroyed && !streamLog.writableEnded) {
+      streamLog.write(`[${isoTs()}] [subproc-stderr-tee-detached] pid=${pid} bytes=${bytesSeen} lines=${linesEmitted}
 `);
     }
     buffer = "";
@@ -8284,10 +8298,11 @@ async function* runCompactionTurn(accountDir, accountId, systemPrompt, resumeSes
     env: {
       ...process.env,
       PLATFORM_ROOT: PLATFORM_ROOT4,
-      ACCOUNT_DIR: accountDir,
-      // Task 532: network traces on the compaction subprocess too — its tool
-      // calls are part of the same conversation's record.
-      NODE_DEBUG: "http,http2,net,tls,undici,dns"
+      ACCOUNT_DIR: accountDir
+      // Task 535: NODE_DEBUG removed. The Claude Code CLI is a bundled Bun
+      // binary and Bun ignores Node's NODE_DEBUG flag, so setting it here was
+      // a no-op that misled future readers. The [subproc-debug-unavailable]
+      // line below records the source-of-silence explicitly.
     }
   });
   const stderrLog = agentLogStream("claude-agent-compaction-stderr", accountDir, conversationId);
@@ -8298,6 +8313,8 @@ async function* runCompactionTurn(accountDir, accountId, systemPrompt, resumeSes
   streamLog.on("error", () => {
   });
   teeProcStderrToStreamLog(proc, streamLog);
+  streamLog.write(`[${isoTs()}] [subproc-debug-unavailable] reason=bundled-bun-binary-ignores-node-debug pid=${proc.pid} cli=claude
+`);
   streamLog.write(`[${isoTs()}] [compaction-start] resumeSessionId=${resumeSessionId}
 `);
   proc.on("error", (err) => {
@@ -9171,11 +9188,11 @@ async function* invokeAdminAgent(message, systemPrompt, accountDir, accountId, a
     env: {
       ...process.env,
       PLATFORM_ROOT: PLATFORM_ROOT4,
-      ACCOUNT_DIR: accountDir,
-      // Task 532: tee subprocess network activity into the per-conversation
-      // stream log via the existing stderr pipe. Closes the Claude Code
-      // "what was the tool actually doing?" black box during tool waits.
-      NODE_DEBUG: "http,http2,net,tls,undici,dns"
+      ACCOUNT_DIR: accountDir
+      // Task 535: NODE_DEBUG removed. The Claude Code CLI is a bundled Bun
+      // binary and Bun ignores Node's NODE_DEBUG flag, so setting it here was
+      // a no-op that misled future readers. The [subproc-debug-unavailable]
+      // line below records the source-of-silence explicitly.
     }
   });
   const stderrLog = agentLogStream("claude-agent-stderr", accountDir, spawnConvId);
@@ -9186,6 +9203,8 @@ async function* invokeAdminAgent(message, systemPrompt, accountDir, accountId, a
   streamLog.on("error", () => {
   });
   teeProcStderrToStreamLog(proc, streamLog);
+  streamLog.write(`[${isoTs()}] [subproc-debug-unavailable] reason=bundled-bun-binary-ignores-node-debug pid=${proc.pid} cli=claude
+`);
   if (sessionKey) {
     const prev = activeProcesses.get(sessionKey);
     if (prev) {
@@ -9513,10 +9532,11 @@ async function* invokeManagedAdminAgent(message, systemPrompt, accountDir, accou
     env: {
       ...process.env,
       PLATFORM_ROOT: PLATFORM_ROOT4,
-      ACCOUNT_DIR: accountDir,
-      // Task 532: tee subprocess network traces into the per-conversation
-      // stream log via the stderr pipe + dual-consume listener.
-      NODE_DEBUG: "http,http2,net,tls,undici,dns"
+      ACCOUNT_DIR: accountDir
+      // Task 535: NODE_DEBUG removed. The Claude Code CLI is a bundled Bun
+      // binary and Bun ignores Node's NODE_DEBUG flag, so setting it here was
+      // a no-op that misled future readers. The [subproc-debug-unavailable]
+      // line below records the source-of-silence explicitly.
     }
   });
   const stderrLog = agentLogStream("claude-agent-stderr", accountDir, managedConvId);
@@ -9524,6 +9544,8 @@ async function* invokeManagedAdminAgent(message, systemPrompt, accountDir, accou
   });
   proc.stderr?.pipe(stderrLog);
   teeProcStderrToStreamLog(proc, streamLog);
+  streamLog.write(`[${isoTs()}] [subproc-debug-unavailable] reason=bundled-bun-binary-ignores-node-debug pid=${proc.pid} cli=claude
+`);
   if (sessionKey) {
     const prev = activeProcesses.get(sessionKey);
     if (prev) {
@@ -10480,6 +10502,26 @@ function defaultRules() {
       scope: "session",
       suggestedAction: "A tool call has been pending for 30 seconds without a result. Read the adjacent [tool-wait-diag] and [tool-wait-proc] lines in the conversation's stream log to determine whether the network remained healthy, the subprocess held active sockets, and the HTTP request reached the wire. If diag shows a healthy network but the subprocess has no [subproc-stderr] UNDICI/HTTP activity during the wait window, the tool's internal pipeline is stalled \u2014 do not retry the same request against the same target without a change in approach."
     },
+    {
+      // Task 536: detect agents ignoring the WEBFETCH_CANNOT_READ_JS_SPA
+      // structured failure. A single SPA short-circuit per conversation is
+      // expected — the hook is doing its job. Two or more in the same
+      // conversation within 5 minutes means either (a) the agent retried
+      // WebFetch on the same SPA URL despite the directive, or (b) the
+      // owner is asking about multiple SPA URLs in one session and the
+      // pattern needs surfacing as a recurring class. Both signal that the
+      // IDENTITY.md "Tool Failure Discipline" guidance is not landing in the
+      // prompt — revise the copy rather than add mechanical enforcement.
+      id: "webfetch-spa-short-circuit-recurring",
+      name: "WebFetch JS-SPA short-circuit fired repeatedly in conversation",
+      type: "repeated-error",
+      logSource: "system",
+      pattern: "WEBFETCH_CANNOT_READ_JS_SPA",
+      thresholdCount: 2,
+      thresholdWindowMinutes: 5,
+      scope: "session",
+      suggestedAction: "The WebFetch SPA preflight has fired more than once in this conversation. Either the agent is ignoring the loud-failure directive (retrying WebFetch after seeing WEBFETCH_CANNOT_READ_JS_SPA), or multiple SPA URLs are being asked about. Read the conversation's stream log for the [tool-use] / [tool-result] sequence around each occurrence \u2014 if the agent dispatched WebFetch on the same URL or substituted Playwright silently, revisit the IDENTITY.md `Tool Failure Discipline` paragraph that names structured-error handling."
+    },
     {
       // Task 533: surface every Cloudflare-plugin refusal. The plugin emits
       // exactly one [cloudflare:refuse] line per refusal with a structured
@@ -31172,18 +31214,23 @@ async function GET9(request) {
   const accountLogDir2 = account ? resolve19(account.accountDir, "logs") : null;
   if (fileParam) {
     const safe = basename5(fileParam);
+    const searched = [];
     for (const dir of [accountLogDir2, LOG_DIR]) {
       if (!dir) continue;
       const filePath = resolve19(dir, safe);
+      searched.push(filePath);
       try {
         const content = readFileSync20(filePath, "utf-8");
         const headers = { "Content-Type": "text/plain; charset=utf-8" };
         if (download) headers["Content-Disposition"] = `attachment; filename="${safe}"`;
         return new Response(content, { headers });
-      } catch {
+      } catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        console.debug(`[admin/logs] miss dir=${dir} name=${safe} reason=${reason}`);
       }
     }
-    return Response.json({ error: `File not found: ${safe}` }, { status: 404 });
+    console.warn(`[admin/logs] not-found name=${safe} searched=[${searched.join(",")}]`);
+    return Response.json({ error: `File not found: ${safe}`, code: "NOT_FOUND" }, { status: 404 });
   }
   if (typeParam) {
     const prefixMap = {
@@ -31195,24 +31242,37 @@ async function GET9(request) {
     };
     const prefix = prefixMap[typeParam];
     if (!prefix) {
-      return Response.json({ error: `Unknown type: ${typeParam}. Valid: stream, error, session, sse, public` }, { status: 400 });
+      console.warn(`[admin/logs] rejected reason=unknown-type type=${typeParam}`);
+      return Response.json(
+        { error: `Unknown type: ${typeParam}. Valid: stream, error, session, sse, public`, code: "UNKNOWN_TYPE" },
+        { status: 400 }
+      );
     }
     if (!conversationIdParam) {
-      return Response.json({ error: `type=${typeParam} requires conversationId (per-conversation log files, no daily fallback)` }, { status: 400 });
+      console.warn(`[admin/logs] rejected type=${typeParam} reason=no-conversationId`);
+      return Response.json(
+        { error: `type=${typeParam} requires conversationId (per-conversation log files, no daily fallback)`, code: "CONVERSATION_ID_REQUIRED" },
+        { status: 400 }
+      );
     }
     const fileName = `${prefix}-${conversationIdParam}.log`;
+    const searched = [];
     for (const dir of [accountLogDir2, LOG_DIR]) {
       if (!dir) continue;
       const filePath = resolve19(dir, fileName);
+      searched.push(filePath);
       try {
         const content = readFileSync20(filePath, "utf-8");
         const headers = { "Content-Type": "text/plain; charset=utf-8" };
         if (download) headers["Content-Disposition"] = `attachment; filename="${fileName}"`;
         return new Response(content, { headers });
-      } catch {
+      } catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        console.debug(`[admin/logs] miss dir=${dir} name=${fileName} reason=${reason}`);
       }
     }
-    return Response.json({ error: `Log not found: ${fileName}` }, { status: 404 });
+    console.warn(`[admin/logs] not-found name=${fileName} searched=[${searched.join(",")}]`);
+    return Response.json({ error: `Log not found: ${fileName}`, code: "NOT_FOUND" }, { status: 404 });
   }
   const seen = /* @__PURE__ */ new Set();
   const logs = {};
@@ -31221,7 +31281,9 @@ async function GET9(request) {
     let files;
     try {
       files = readdirSync5(dir).filter((f) => f.endsWith(".log"));
-    } catch {
+    } catch (err) {
+      const reason = err instanceof Error ? err.message : String(err);
+      console.warn(`[admin/logs] readdir-fail dir=${dir} reason=${reason}`);
       continue;
     }
     files.filter((f) => !seen.has(f)).map((f) => ({ name: f, mtime: statSync7(resolve19(dir, f)).mtimeMs })).sort((a, b) => b.mtime - a.mtime).forEach(({ name }) => {
@@ -31230,8 +31292,10 @@ async function GET9(request) {
         const content = readFileSync20(resolve19(dir, name));
         const tail = content.length > TAIL_BYTES ? content.subarray(content.length - TAIL_BYTES).toString("utf-8") : content.toString("utf-8");
         logs[name] = tail.trim() || "(empty)";
-      } catch {
-        logs[name] = "(unreadable)";
+      } catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        console.debug(`[admin/logs] read-fail name=${name} reason=${reason}`);
+        logs[name] = `(unreadable: ${reason})`;
       }
     });
   }