@botcord/daemon 0.2.57 → 0.2.58

package/dist/diagnostics.d.ts

@@ -15,6 +15,8 @@ export interface DiagnosticBundleResult {
     filename: string;
     sizeBytes: number;
     createdAt: string;
+    revealCommand: string;
+    copyPathCommand: string;
 }
 export interface DiagnosticUploadResult {
     bundleId: string;

package/dist/diagnostics.js

@@ -189,6 +189,28 @@ function createZip(entries) {
     ]);
     return Buffer.concat([...localParts, central, end]);
 }
+function shellQuote(s) {
+    return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+function diagnosticBundleCommands(filePath) {
+    if (process.platform === "darwin") {
+        return {
+            revealCommand: `open -R ${shellQuote(filePath)}`,
+            copyPathCommand: `printf '%s' ${shellQuote(filePath)} | pbcopy`,
+        };
+    }
+    if (process.platform === "win32") {
+        const psPath = filePath.replace(/'/g, "''");
+        return {
+            revealCommand: `explorer.exe /select,"${filePath.replace(/"/g, '""')}"`,
+            copyPathCommand: `powershell.exe -NoProfile -Command "Set-Clipboard -Value '${psPath}'"`,
+        };
+    }
+    return {
+        revealCommand: `xdg-open ${shellQuote(path.dirname(filePath))}`,
+        copyPathCommand: `printf '%s' ${shellQuote(filePath)} | xclip -selection clipboard`,
+    };
+}
 export async function createDiagnosticBundle(opts = {}) {
     const createdAt = new Date();
     const stamp = createdAt.toISOString().replace(/[:.]/g, "-");
@@ -238,11 +260,13 @@ export async function createDiagnosticBundle(opts = {}) {
     const zip = createZip(entries);
     const out = path.join(diagnosticsDir, filename);
     writeFileSync(out, zip, { mode: 0o600 });
+    const commands = diagnosticBundleCommands(out);
     return {
         path: out,
         filename,
         sizeBytes: zip.length,
         createdAt: createdAt.toISOString(),
+        ...commands,
     };
 }
 export async function uploadDiagnosticBundle(opts) {

package/dist/gateway/channels/wechat.d.ts

@@ -18,6 +18,8 @@ export interface WechatChannelOptions {
     stateDebounceMs?: number;
     /** Test hook: override Date.now() for trace cache TTL assertions. */
     now?: () => number;
+    /** Test hook: override trace context cache cap without a 5000-poll test. */
+    traceContextMax?: number;
 }
 /**
  * WeChat (iLink Bot API) channel adapter.

package/dist/gateway/channels/wechat.js

@@ -53,6 +53,9 @@ export function createWechatChannel(opts) {
     const allowedSenderIds = new Set((opts.allowedSenderIds ?? []).map((s) => String(s)));
     const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
     const now = opts.now ?? (() => Date.now());
+    const traceContextMax = opts.traceContextMax && opts.traceContextMax > 0
+        ? opts.traceContextMax
+        : TRACE_CONTEXT_MAX;
     let botToken = opts.botToken;
     let stateStore = null;
     let stopCallback = null;
@@ -103,7 +106,7 @@ export function createWechatChannel(opts) {
     }
     function rememberTrace(traceId, ctx) {
         // W1: prune oldest entry by updatedAt when cap is reached.
-        if (traceContexts.size >= TRACE_CONTEXT_MAX) {
+        if (traceContexts.size >= traceContextMax) {
             let oldestKey;
             let oldestAt = Infinity;
             for (const [k, v] of traceContexts) {

package/dist/index.js

@@ -1223,6 +1223,8 @@ async function cmdDoctor(args) {
         }
         console.log(`diagnostic bundle written: ${bundle.path}`);
         console.log(`size: ${bundle.sizeBytes} bytes`);
+        console.log(`open in Finder/file manager: ${bundle.revealCommand}`);
+        console.log(`copy path to clipboard: ${bundle.copyPathCommand}`);
         console.log("Send this zip file to the BotCord developer/support contact.");
         return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botcord/daemon",
-  "version": "0.2.57",
+  "version": "0.2.58",
   "description": "BotCord local daemon — bridges Hub inbox push to local Claude Code / Codex / Gemini CLIs",
   "type": "module",
   "bin": {

package/src/__tests__/diagnostics.test.ts

@@ -25,6 +25,12 @@ describe("diagnostics bundle", () => {
     });
     expect(bundle.filename).toMatch(/^botcord-daemon-diagnostics-.*\.zip$/);
     expect(bundle.path).toContain(diagnosticsDir);
+    if (process.platform === "linux") {
+      expect(bundle.revealCommand).toContain(diagnosticsDir);
+    } else {
+      expect(bundle.revealCommand).toContain(bundle.path);
+    }
+    expect(bundle.copyPathCommand).toContain(bundle.path);
     expect(existsSync(bundle.path)).toBe(true);
     const bytes = readFileSync(bundle.path);
     expect(bytes.subarray(0, 4).toString("binary")).toBe("PK\u0003\u0004");

package/src/__tests__/wechat-channel.test.ts

@@ -1080,7 +1080,7 @@ describe("W1: traceContexts hard cap", () => {
     rmSync(tmpCap, { recursive: true, force: true });
   });
 
-  it("inserting 5001 entries keeps the map at <= 5000 (oldest pruned)", async () => {
+  it("keeps trace context map at the configured cap (oldest pruned)", async () => {
     // Build an adapter with a fake clock so we can control updatedAt order.
     let nowMs = 1_000_000;
     const fetchImpl = buildFetchStub(
@@ -1088,8 +1088,9 @@ describe("W1: traceContexts hard cap", () => {
         {
           match: "getupdates",
           respond: (idx) => {
-            if (idx < 5001) {
-              // Each poll returns one message so we get 5001 trace entries.
+            if (idx < 3) {
+              // Each poll returns one message so we get one more entry than
+              // the test cap without looping 5001 times in CI.
               nowMs += 1;
               return {
                 body: {
@@ -1106,7 +1107,7 @@ describe("W1: traceContexts hard cap", () => {
                 },
               };
             }
-            return { body: { ret: 0, get_updates_buf: `buf-5001`, msgs: [] } };
+            return { body: { ret: 0, get_updates_buf: `buf-3`, msgs: [] } };
           },
         },
       ],
@@ -1121,11 +1122,12 @@ describe("W1: traceContexts hard cap", () => {
       stateDebounceMs: 0,
       allowedSenderIds: ["alice@im.wechat"],
       now: () => nowMs,
+      traceContextMax: 2,
     });
-    const h = startAdapter(adapter, { stopAfterEnvelopes: 5001 });
+    const h = startAdapter(adapter, { stopAfterEnvelopes: 3 });
     await h.pollDone;
-    // 5001 messages were accepted; the cap should have kept the map <= 5000.
-    expect(h.envelopes.length).toBe(5001);
+    // 3 messages were accepted; the cap should have kept the map <= 2.
+    expect(h.envelopes.length).toBe(3);
     // We can't read traceContexts directly, but we verify that the send() for
     // the very first trace ID now fails (it was evicted as the oldest entry).
     const firstTraceId = h.envelopes[0]!.message.trace!.id;

package/src/diagnostics.ts

@@ -43,6 +43,8 @@ export interface DiagnosticBundleResult {
   filename: string;
   sizeBytes: number;
   createdAt: string;
+  revealCommand: string;
+  copyPathCommand: string;
 }
 
 export interface DiagnosticUploadResult {
@@ -242,6 +244,35 @@ function createZip(entries: Array<{ name: string; data: string | Buffer }>): Buf
   return Buffer.concat([...localParts, central, end]);
 }
 
+function shellQuote(s: string): string {
+  return `'${s.replace(/'/g, `'\\''`)}'`;
+}
+
+function diagnosticBundleCommands(filePath: string): {
+  revealCommand: string;
+  copyPathCommand: string;
+} {
+  if (process.platform === "darwin") {
+    return {
+      revealCommand: `open -R ${shellQuote(filePath)}`,
+      copyPathCommand: `printf '%s' ${shellQuote(filePath)} | pbcopy`,
+    };
+  }
+
+  if (process.platform === "win32") {
+    const psPath = filePath.replace(/'/g, "''");
+    return {
+      revealCommand: `explorer.exe /select,"${filePath.replace(/"/g, '""')}"`,
+      copyPathCommand: `powershell.exe -NoProfile -Command "Set-Clipboard -Value '${psPath}'"`,
+    };
+  }
+
+  return {
+    revealCommand: `xdg-open ${shellQuote(path.dirname(filePath))}`,
+    copyPathCommand: `printf '%s' ${shellQuote(filePath)} | xclip -selection clipboard`,
+  };
+}
+
 export async function createDiagnosticBundle(
   opts: CreateDiagnosticBundleOptions = {},
 ): Promise<DiagnosticBundleResult> {
@@ -296,11 +327,13 @@ export async function createDiagnosticBundle(
   const zip = createZip(entries);
   const out = path.join(diagnosticsDir, filename);
   writeFileSync(out, zip, { mode: 0o600 });
+  const commands = diagnosticBundleCommands(out);
   return {
     path: out,
     filename,
     sizeBytes: zip.length,
     createdAt: createdAt.toISOString(),
+    ...commands,
   };
 }
 

package/src/gateway/channels/wechat.ts

@@ -65,6 +65,8 @@ export interface WechatChannelOptions {
   stateDebounceMs?: number;
   /** Test hook: override Date.now() for trace cache TTL assertions. */
   now?: () => number;
+  /** Test hook: override trace context cache cap without a 5000-poll test. */
+  traceContextMax?: number;
 }
 
 interface WechatSecret {
@@ -138,6 +140,10 @@ export function createWechatChannel(opts: WechatChannelOptions): ChannelAdapter
   const fetchImpl: FetchLike =
     opts.fetchImpl ?? ((globalThis.fetch as unknown) as FetchLike);
   const now: () => number = opts.now ?? (() => Date.now());
+  const traceContextMax =
+    opts.traceContextMax && opts.traceContextMax > 0
+      ? opts.traceContextMax
+      : TRACE_CONTEXT_MAX;
 
   let botToken: string | undefined = opts.botToken;
   let stateStore: GatewayStateStore | null = null;
@@ -195,7 +201,7 @@ export function createWechatChannel(opts: WechatChannelOptions): ChannelAdapter
 
   function rememberTrace(traceId: string, ctx: TraceContext): void {
     // W1: prune oldest entry by updatedAt when cap is reached.
-    if (traceContexts.size >= TRACE_CONTEXT_MAX) {
+    if (traceContexts.size >= traceContextMax) {
       let oldestKey: string | undefined;
       let oldestAt = Infinity;
       for (const [k, v] of traceContexts) {

package/src/index.ts

@@ -1354,6 +1354,8 @@ async function cmdDoctor(args: ParsedArgs): Promise<void> {
     }
     console.log(`diagnostic bundle written: ${bundle.path}`);
     console.log(`size: ${bundle.sizeBytes} bytes`);
+    console.log(`open in Finder/file manager: ${bundle.revealCommand}`);
+    console.log(`copy path to clipboard: ${bundle.copyPathCommand}`);
     console.log("Send this zip file to the BotCord developer/support contact.");
     return;
   }