npm - @polderlabs/bizar - Versions diffs - 4.5.1 → 4.7.0 - Mend

@polderlabs/bizar 4.5.1 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (94) hide show

package/bizar-dash/dist/assets/__vite-browser-external-BIHI7g3E.js +0 -1
package/bizar-dash/dist/assets/main-DAlLdW8I.css +1 -0
package/bizar-dash/dist/assets/main-DGGq-iZI.js +361 -0
package/bizar-dash/dist/assets/main-DGGq-iZI.js.map +1 -0
package/bizar-dash/dist/assets/{mobile-O6ANdD4W.js → mobile-CWqPoGaT.js} +18 -19
package/bizar-dash/dist/assets/mobile-CWqPoGaT.js.map +1 -0
package/bizar-dash/dist/assets/{mobile-DQLFCjwJ.js → mobile-i4Uv9eW8.js} +1 -2
package/bizar-dash/dist/assets/{mobile-DQLFCjwJ.js.map → mobile-i4Uv9eW8.js.map} +1 -1
package/bizar-dash/dist/index.html +3 -3
package/bizar-dash/dist/mobile.html +2 -2
package/bizar-dash/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json +1 -0
package/bizar-dash/src/server/headroom.mjs +37 -35
package/bizar-dash/src/server/logger.mjs +71 -0
package/bizar-dash/src/server/memory-lightrag.mjs +84 -37
package/bizar-dash/src/server/metrics.mjs +193 -0
package/bizar-dash/src/server/mods-loader.mjs +13 -5
package/bizar-dash/src/server/providers-store.mjs +73 -1
package/bizar-dash/src/server/routes/chat.mjs +41 -0
package/bizar-dash/src/server/routes/lightrag.mjs +7 -2
package/bizar-dash/src/server/routes/memory.mjs +13 -4
package/bizar-dash/src/server/routes/misc.mjs +2 -1
package/bizar-dash/src/server/routes/overview.mjs +2 -1
package/bizar-dash/src/server/schedules-runner.mjs +4 -4
package/bizar-dash/src/server/server.mjs +101 -37
package/bizar-dash/src/server/watcher.mjs +2 -2
package/bizar-dash/src/web/App.tsx +40 -6
package/bizar-dash/src/web/components/SearchModal.tsx +3 -2
package/bizar-dash/src/web/components/Toast.tsx +1 -1
package/bizar-dash/src/web/components/Topbar.tsx +1 -1
package/bizar-dash/src/web/components/VirtualList.tsx +53 -0
package/bizar-dash/src/web/components/chat/ChatThread.tsx +17 -11
package/bizar-dash/src/web/hooks/useI18n.ts +13 -0
package/bizar-dash/src/web/lib/api.ts +12 -11
package/bizar-dash/src/web/lib/i18n.ts +25 -0
package/bizar-dash/src/web/locales/en.json +52 -0
package/bizar-dash/src/web/main.tsx +5 -0
package/bizar-dash/src/web/styles/chat.css +2 -0
package/bizar-dash/src/web/styles/main.css +52 -23
package/bizar-dash/src/web/styles/tasks.css +2 -0
package/bizar-dash/src/web/views/Activity.tsx +24 -17
package/bizar-dash/src/web/views/History.tsx +90 -75
package/bizar-dash/src/web/views/Memory.tsx +4 -3
package/bizar-dash/src/web/views/MiniMaxUsage.tsx +3 -2
package/bizar-dash/src/web/views/Overview.tsx +15 -10
package/bizar-dash/src/web/views/Settings.tsx +9 -2
package/bizar-dash/src/web/views/Skills.tsx +3 -2
package/bizar-dash/src/web/views/Tasks.tsx +4 -3
package/bizar-dash/src/web/views/memory/MemoryOverview.tsx +8 -6
package/bizar-dash/tests/cli-bugfixes.test.mjs +151 -0
package/bizar-dash/tests/cli-refactor.test.mjs +184 -0
package/bizar-dash/tests/components/Button.test.tsx +41 -0
package/bizar-dash/tests/components/Card.test.tsx +42 -0
package/bizar-dash/tests/components/Modal.test.tsx +104 -0
package/bizar-dash/tests/components/Spinner.test.tsx +32 -0
package/bizar-dash/tests/components/StatusBadge.test.tsx +35 -0
package/bizar-dash/tests/components/Toast.test.tsx +108 -0
package/bizar-dash/tests/frontend-bugfixes.test.mjs +151 -0
package/bizar-dash/tests/hooks/useModal.test.tsx +84 -0
package/bizar-dash/tests/hooks/useToast.test.tsx +50 -0
package/bizar-dash/tests/lib/i18n.test.ts +46 -0
package/bizar-dash/tests/lib/utils.test.ts +194 -0
package/bizar-dash/tests/logger.test.mjs +207 -0
package/bizar-dash/tests/metrics.test.mjs +183 -0
package/bizar-dash/tests/server-bugfixes.test.mjs +318 -0
package/bizar-dash/tests/setup.ts +7 -0
package/bizar-dash/vitest.config.ts +13 -0
package/cli/artifact-cli.mjs +605 -0
package/cli/artifact-render.mjs +621 -0
package/cli/artifact-server.mjs +847 -0
package/cli/artifact.mjs +38 -2089
package/cli/bg.mjs +5 -13
package/cli/bin.mjs +170 -1348
package/cli/commands/artifact.mjs +20 -0
package/cli/commands/dash.mjs +160 -0
package/cli/commands/headroom.mjs +204 -0
package/cli/commands/install.mjs +169 -0
package/cli/commands/memory.mjs +25 -0
package/cli/commands/minimax.mjs +265 -0
package/cli/commands/mod.mjs +185 -0
package/cli/commands/service.mjs +65 -0
package/cli/commands/usage.mjs +109 -0
package/cli/commands/util.mjs +306 -0
package/cli/doctor.mjs +6 -16
package/cli/memory.mjs +65 -21
package/cli/provision.mjs +10 -15
package/cli/service-controller.mjs +1 -11
package/cli/service.mjs +1 -11
package/cli/utils.mjs +41 -1
package/install.sh +1 -2
package/package.json +8 -3
package/bizar-dash/dist/assets/main-eWZ4NlCL.css +0 -1
package/bizar-dash/dist/assets/main-usWhlPWa.js +0 -362
package/bizar-dash/dist/assets/main-usWhlPWa.js.map +0 -1
package/bizar-dash/dist/assets/mobile-O6ANdD4W.js.map +0 -1

package/bizar-dash/dist/assets/{mobile-DQLFCjwJ.js → mobile-i4Uv9eW8.js} RENAMED Viewed

@@ -1,2 +1 @@
-import{al as r,j as o,r as e,am as n}from"./mobile-O6ANdD4W.js";const t=document.getElementById("root");if(!t)throw new Error("Root element #root not found");r(t).render(o.jsx(e.StrictMode,{children:o.jsx(n,{})}));
-//# sourceMappingURL=mobile-DQLFCjwJ.js.map
+import{am as r,j as o,r as e,an as n}from"./mobile-CWqPoGaT.js";const t=document.getElementById("root");if(!t)throw new Error("Root element #root not found");r(t).render(o.jsx(e.StrictMode,{children:o.jsx(n,{})}));

package/bizar-dash/dist/assets/{mobile-DQLFCjwJ.js.map → mobile-i4Uv9eW8.js.map} RENAMED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"mobile-~~DQLFCjwJ~~.js","sources":["../../src/web/mobile.tsx"],"sourcesContent":["// src/mobile.tsx — entry point for mobile dashboard.\nimport { StrictMode } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { MobileApp } from './MobileApp';\nimport './styles/mobile.css';\n\nconst root = document.getElementById('root');\nif (!root) throw new Error('Root element #root not found');\ncreateRoot(root).render(\n <StrictMode>\n <MobileApp />\n </StrictMode>,\n);\n"],"names":["root","createRoot","jsx","StrictMode","MobileApp"],"mappings":"gEAMA,MAAMA,EAAO,SAAS,eAAe,MAAM,EAC3C,GAAI,CAACA,EAAM,MAAM,IAAI,MAAM,8BAA8B,EACzDC,EAAWD,CAAI,EAAE,OACfE,EAAAA,IAACC,EAAAA,WAAA,CACC,SAAAD,EAAAA,IAACE,EAAA,CAAA,CAAU,CAAA,CACb,CACF"}
1	+ {"version":3,"file":"mobile-i4Uv9eW8.js","sources":["../../src/web/mobile.tsx"],"sourcesContent":["// src/mobile.tsx — entry point for mobile dashboard.\nimport { StrictMode } from 'react';\nimport { createRoot } from 'react-dom/client';\nimport { MobileApp } from './MobileApp';\nimport './styles/mobile.css';\n\nconst root = document.getElementById('root');\nif (!root) throw new Error('Root element #root not found');\ncreateRoot(root).render(\n <StrictMode>\n <MobileApp />\n </StrictMode>,\n);\n"],"names":["root","createRoot","jsx","StrictMode","MobileApp"],"mappings":"gEAMA,MAAMA,EAAO,SAAS,eAAe,MAAM,EAC3C,GAAI,CAACA,EAAM,MAAM,IAAI,MAAM,8BAA8B,EACzDC,EAAWD,CAAI,EAAE,OACfE,EAAAA,IAACC,EAAAA,WAAA,CACC,SAAAD,EAAAA,IAACE,EAAA,CAAA,CAAU,CAAA,CACb,CACF"}

package/bizar-dash/dist/index.html CHANGED Viewed

@@ -29,10 +29,10 @@
         }
       })();
     </script>
-    <script type="module" crossorigin src="/assets/main-usWhlPWa.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/mobile-O6ANdD4W.js">
+    <script type="module" crossorigin src="/assets/main-DGGq-iZI.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/mobile-CWqPoGaT.js">
     <link rel="stylesheet" crossorigin href="/assets/mobile-CsZQAswA.css">
-    <link rel="stylesheet" crossorigin href="/assets/main-eWZ4NlCL.css">
+    <link rel="stylesheet" crossorigin href="/assets/main-DAlLdW8I.css">
   </head>
   <body>
     <div id="root"></div>

package/bizar-dash/dist/mobile.html CHANGED Viewed

@@ -12,8 +12,8 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link rel="stylesheet" href="https://rsms.me/inter/inter.css" />
-    <script type="module" crossorigin src="/assets/mobile-DQLFCjwJ.js"></script>
-    <link rel="modulepreload" crossorigin href="/assets/mobile-O6ANdD4W.js">
+    <script type="module" crossorigin src="/assets/mobile-i4Uv9eW8.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/mobile-CWqPoGaT.js">
     <link rel="stylesheet" crossorigin href="/assets/mobile-CsZQAswA.css">
   </head>
   <body>

package/bizar-dash/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json ADDED Viewed

@@ -0,0 +1 @@

+ {"version":"4.1.9","results":[[":tests/lib/utils.test.ts",{"duration":20.207488999999953,"failed":false}],[":tests/components/Button.test.tsx",{"duration":65.99081000000001,"failed":false}],[":tests/components/Card.test.tsx",{"duration":24.894168999999977,"failed":false}],[":tests/hooks/useModal.test.tsx",{"duration":91.24809300000004,"failed":false}],[":tests/components/Toast.test.tsx",{"duration":112.40757200000002,"failed":false}],[":tests/components/Modal.test.tsx",{"duration":113.472669,"failed":false}],[":tests/lib/i18n.test.ts",{"duration":3.547411000000011,"failed":false}],[":tests/components/StatusBadge.test.tsx",{"duration":25.80152300000003,"failed":false}],[":tests/hooks/useToast.test.tsx",{"duration":74.72992599999998,"failed":false}],[":tests/components/Spinner.test.tsx",{"duration":43.51148800000004,"failed":false}]]}

package/bizar-dash/src/server/headroom.mjs CHANGED Viewed

@@ -115,42 +115,44 @@ async function findProxyPid(port) {
     }
   } catch { /* ignore */ }
-  // Try to find process listening on the port via /proc/net/tcp (Linux)
+  // Try to find process listening on the port via /proc/net/tcp (Linux only).
+  // On macOS/Windows /proc does not exist — return null early to avoid noisy errors.
+  if (process.platform !== 'linux') {
+    return null;
+  }
   try {
-    if (process.platform === 'linux') {
-      const netTcp = readFileSync('/proc/net/tcp', 'utf8');
-      const portHex = port.toString(16).toUpperCase().padStart(4, '0');
-      const lines = netTcp.split('\n');
-      for (const line of lines.slice(1)) {
-        // Format: sl  local_address rem_address   st tx_queue rx_queue ... inode
-        const parts = line.trim().split(/\s+/);
-        if (parts.length < 10) continue;
-        const local = parts[1];
-        const localPortHex = local.split(':')[1];
-        if (localPortHex?.toUpperCase() === portHex) {
-          // Try to get PID from the socket inode
-          const inode = parts[9];
-          if (inode && inode !== '0') {
-            // Scan /proc/*/fd/* for socket inodes
-            const { readdirSync, readlinkSync } = await import('node:fs');
-            const procDir = '/proc';
-            const pids = readdirSync(procDir).filter(
-              (n) => /^\d+$/.test(n) && !isNaN(parseInt(n, 10)),
-            );
-            for (const pid of pids) {
-              try {
-                const fdDir = join(procDir, pid, 'fd');
-                const fds = readdirSync(fdDir);
-                for (const fd of fds) {
-                  try {
-                    const link = readlinkSync(join(fdDir, fd));
-                    if (link.includes(`socket:[${inode}]`)) {
-                      return parseInt(pid, 10);
-                    }
-                  } catch { /* skip */ }
-                }
-              } catch { /* skip */ }
-            }
+    const netTcp = readFileSync('/proc/net/tcp', 'utf8');
+    const portHex = port.toString(16).toUpperCase().padStart(4, '0');
+    const lines = netTcp.split('\n');
+    for (const line of lines.slice(1)) {
+      // Format: sl  local_address rem_address   st tx_queue rx_queue ... inode
+      const parts = line.trim().split(/\s+/);
+      if (parts.length < 10) continue;
+      const local = parts[1];
+      const localPortHex = local.split(':')[1];
+      if (localPortHex?.toUpperCase() === portHex) {
+        // Try to get PID from the socket inode
+        const inode = parts[9];
+        if (inode && inode !== '0') {
+          // Scan /proc/*/fd/* for socket inodes
+          const { readdirSync, readlinkSync } = await import('node:fs');
+          const procDir = '/proc';
+          const pids = readdirSync(procDir).filter(
+            (n) => /^\d+$/.test(n) && !isNaN(parseInt(n, 10)),
+          );
+          for (const pid of pids) {
+            try {
+              const fdDir = join(procDir, pid, 'fd');
+              const fds = readdirSync(fdDir);
+              for (const fd of fds) {
+                try {
+                  const link = readlinkSync(join(fdDir, fd));
+                  if (link.includes(`socket:[${inode}]`)) {
+                    return parseInt(pid, 10);
+                  }
+                } catch { /* skip */ }
+              }
+            } catch { /* skip */ }
           }
         }
       }

package/bizar-dash/src/server/logger.mjs ADDED Viewed

@@ -0,0 +1,71 @@
+/**
+ * src/server/logger.mjs
+ *
+ * v4.7.0 — Structured JSON logger with level filtering.
+ *
+ * Replaces ad-hoc `console.log('[module] message')` calls across the
+ * server with a single, level-gated logger that emits one JSON object
+ * per line. Output goes to the matching console.* stream (log/warn/
+ * error) so existing terminal capture keeps working, but the body is
+ * machine-parseable.
+ *
+ * Level selection: BIZAR_LOG_LEVEL env var (debug | info | warn | error).
+ * Default `info` matches the existing behaviour — everything but debug
+ * is visible. Set `debug` to surface verbose tracing during development.
+ *
+ * Usage:
+ *   import { info, warn, error, child } from './logger.mjs';
+ *   info('server started', { port: 4317 });
+ *   warn('rate limited', { module: 'lightrag', err: e.message });
+ *   const log = child({ module: 'overview' });
+ *   log.info('snapshot built', { size: 1234 });
+ */
+const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
+const ENV_LEVEL = process.env.BIZAR_LOG_LEVEL;
+const currentLevel = LEVELS[ENV_LEVEL] !== undefined ? ENV_LEVEL : 'info';
+function format(level, msg, ctx) {
+  const entry = {
+    ts: new Date().toISOString(),
+    level,
+    msg,
+    ...(ctx && typeof ctx === 'object' ? ctx : {}),
+  };
+  return JSON.stringify(entry);
+}
+function shouldLog(level) {
+  return LEVELS[currentLevel] <= LEVELS[level];
+}
+export function debug(msg, ctx) {
+  if (shouldLog('debug')) console.log(format('debug', msg, ctx));
+}
+export function info(msg, ctx) {
+  if (shouldLog('info')) console.log(format('info', msg, ctx));
+}
+export function warn(msg, ctx) {
+  if (shouldLog('warn')) console.warn(format('warn', msg, ctx));
+}
+export function error(msg, ctx) {
+  if (shouldLog('error')) console.error(format('error', msg, ctx));
+}
+/**
+ * Build a child logger that binds a context object to every log call.
+ * Useful for tagging a series of related entries with a module/session id.
+ */
+export function child(ctx) {
+  return {
+    debug: (m, c) => debug(m, { ...ctx, ...(c && typeof c === 'object' ? c : {}) }),
+    info: (m, c) => info(m, { ...ctx, ...(c && typeof c === 'object' ? c : {}) }),
+    warn: (m, c) => warn(m, { ...ctx, ...(c && typeof c === 'object' ? c : {}) }),
+    error: (m, c) => error(m, { ...ctx, ...(c && typeof c === 'object' ? c : {}) }),
+  };
+}
+export { currentLevel };

package/bizar-dash/src/server/memory-lightrag.mjs CHANGED Viewed

@@ -52,9 +52,32 @@ import https from 'node:https';
 import { atomicWriteJson } from './routes/_shared.mjs';
 import { parseFrontmatter } from './yaml.mjs';
+import { warn as logWarn } from './logger.mjs';
 // ── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * v4.7.0 — Per-site log rate limiter for hot-path catches.
+ *
+ * Several empty catches below sit on stdout/stderr `data` handlers
+ * that can fire dozens of times per second when LightRAG is chatty
+ * (or the disk is slow). Without rate-limiting, a transient disk
+ * hiccup floods the log with thousands of identical warnings and
+ * hides the real problem underneath.
+ *
+ * Returns true the first time it's called for a key within `intervalMs`,
+ * then false until the window passes. Default 60s — matches the
+ * "if it's still broken, say it again a minute later" pattern.
+ */
+const _lastLog = new Map();
+function _rateLimit(key, intervalMs = 60_000) {
+  const now = Date.now();
+  const last = _lastLog.get(key) || 0;
+  if (now - last < intervalMs) return false;
+  _lastLog.set(key, now);
+  return true;
+}
 function deepMerge(target, source) {
   const out = { ...target };
   if (source === null || source === undefined) return out;
@@ -84,7 +107,8 @@ function readLogTail(filePath, n = 30) {
     const content = readFileSync(filePath, 'utf8');
     const lines = content.split('\n');
     return lines.slice(-n);
-  } catch {
+  } catch (err) {
+    console.warn('[lightrag] swallowed in readLogTail:', err?.message || err);
     return [];
   }
 }
@@ -206,7 +230,8 @@ export function resolveLightRAGConfig(projectRoot) {
   if (existsSync(path)) {
     try {
       userCfg = JSON.parse(readFileSync(path, 'utf8')).lightrag || {};
-    } catch {
+    } catch (err) {
+      console.warn('[lightrag] swallowed in resolveLightRAGConfig.readMemoryJson:', err?.message || err);
       userCfg = {};
     }
   }
@@ -269,8 +294,9 @@ export function findLightragBinary() {
       timeout: 3000,
     }).trim();
     if (path) return path;
-  } catch {
+  } catch (err) {
     // command returned non-zero — fall through
+    console.warn('[lightrag] swallowed in findLightragBinary.which:', err?.message || err);
   }
   return null;
 }
@@ -336,7 +362,8 @@ export async function isRunning(config) {
   try {
     const res = await httpGet(`http://${config.host}:${config.port}/health`, 3000);
     return res.status === 200;
-  } catch {
+  } catch (err) {
+    console.warn('[lightrag] swallowed in isRunning.healthCheck:', err?.message || err);
     return false;
   }
 }
@@ -361,7 +388,8 @@ function readPidAlive(pidFile) {
     if (!Number.isFinite(pid) || pid <= 0) return { pid: null, alive: false };
     const alive = killPid(pid, 0); // signal 0 = probe
     return { pid, alive };
-  } catch {
+  } catch (err) {
+    console.warn('[lightrag] swallowed in readPidAlive:', err?.message || err);
     return { pid: null, alive: false };
   }
 }
@@ -387,7 +415,9 @@ export async function startServer(config, { logger } = {}) {
   if (existing && !existingAlive) {
     try {
       unlinkSync(pidFile);
-    } catch {}
+    } catch (err) {
+      console.warn('[lightrag] swallowed in startServer.unlinkStalePid:', err?.message || err);
+    }
   }
   if (!findLightragBinary()) {
@@ -437,11 +467,23 @@ export async function startServer(config, { logger } = {}) {
   let fd = -1;
   try {
     fd = openSync(logFile, 'a');
-    child.stdout?.on('data', (d) => { try { writeSync(fd, d); } catch {} });
-    child.stderr?.on('data', (d) => { try { writeSync(fd, d); } catch {} });
+    child.stdout?.on('data', (d) => {
+      try { writeSync(fd, d); } catch (err) {
+        if (_rateLimit('lightrag-write-stdout')) logWarn('lightrag stream write failed (stdout)', { module: 'lightrag', err: err?.message || String(err) });
+      }
+    });
+    child.stderr?.on('data', (d) => {
+      try { writeSync(fd, d); } catch (err) {
+        if (_rateLimit('lightrag-write-stderr')) logWarn('lightrag stream write failed (stderr)', { module: 'lightrag', err: err?.message || String(err) });
+      }
+    });
     child.on('exit', (code, signal) => {
-      try { closeSync(fd); } catch {}
-      try { unlinkSync(pidFile); } catch {}
+      try { closeSync(fd); } catch (err) {
+        if (_rateLimit('lightrag-close-fd')) logWarn('lightrag close fd failed', { module: 'lightrag', err: err?.message || String(err) });
+      }
+      try { unlinkSync(pidFile); } catch (err) {
+        if (_rateLimit('lightrag-exit-unlink')) logWarn('lightrag pid unlink failed', { module: 'lightrag', err: err?.message || String(err) });
+      }
       log(`lightrag-server exited (code=${code}, signal=${signal})`);
     });
   } catch (openErr) {
@@ -476,7 +518,9 @@ export async function stopServer(config, { logger } = {}) {
   const pidFile = join(config.workingDir, 'lightrag.pid');
   const { pid, alive } = readPidAlive(pidFile);
   if (!pid || !alive) {
-    try { unlinkSync(pidFile); } catch {}
+    try { unlinkSync(pidFile); } catch (err) {
+      if (_rateLimit('lightrag-stop-notrunning-unlink')) logWarn('lightrag pid unlink failed (not running)', { module: 'lightrag', err: err?.message || String(err) });
+    }
     return { ok: true, message: 'not running' };
   }
   log(`stopping lightrag-server (pid ${pid})`);
@@ -486,7 +530,9 @@ export async function stopServer(config, { logger } = {}) {
     log(`escalating to SIGKILL (pid ${pid})`);
     killPid(pid, 'SIGKILL');
   }
-  try { unlinkSync(pidFile); } catch {}
+  try { unlinkSync(pidFile); } catch (err) {
+    if (_rateLimit('lightrag-stop-unlink')) logWarn('lightrag pid unlink failed (stop)', { module: 'lightrag', err: err?.message || String(err) });
+  }
   return { ok: true, message: 'stopped' };
 }
@@ -818,7 +864,8 @@ export async function stats(projectRoot) {
       try {
         process.kill(parsed, 0);
         pid = parsed;
-      } catch {
+      } catch (err) {
+        console.warn('[lightrag] swallowed in stats.pidProbe:', err?.message || err);
         pid = null;
       }
     }
@@ -835,8 +882,8 @@ export async function stats(projectRoot) {
       lastReindexOk = m.ok === true;
       lastReindexInserted = typeof m.inserted === 'number' ? m.inserted : null;
       lastReindexFailed = typeof m.failed === 'number' ? m.failed : null;
-    } catch {
-      /* marker corrupt — ignore */
+    } catch (err) {
+      console.warn('[lightrag] swallowed in stats.markerRead:', err?.message || err);
     }
   }
@@ -853,13 +900,13 @@ export async function stats(projectRoot) {
         try {
           const obj = JSON.parse(readFileSync(p, 'utf8'));
           indexedApprox += Object.keys(obj || {}).length;
-        } catch {
-          /* skip */
+        } catch (err) {
+          console.warn('[lightrag] swallowed in stats.kvStoreRead:', err?.message || err);
         }
       }
     }
-  } catch {
-    /* ignore */
+  } catch (err) {
+    console.warn('[lightrag] swallowed in stats.kvStoreScan:', err?.message || err);
   }
   // Note count = listNotes from the vault.
@@ -895,8 +942,8 @@ export async function stats(projectRoot) {
         walk(vaultRoot);
       }
     }
-  } catch {
-    /* ignore — leave noteCount at 0 */
+  } catch (err) {
+    console.warn('[lightrag] swallowed in stats.noteCount:', err?.message || err);
   }
   // Query stats: best-effort — LightRAG's /query endpoint doesn't expose
@@ -920,12 +967,12 @@ export async function stats(projectRoot) {
               counted++;
             }
           }
-        } catch {
-          /* skip */
+        } catch (err) {
+          console.warn('[lightrag] swallowed in stats.queryLogLine:', err?.message || err);
         }
       }
-    } catch {
-      /* ignore */
+    } catch (err) {
+      console.warn('[lightrag] swallowed in stats.queryLogRead:', err?.message || err);
     }
   }
   const avgResponseMs = counted > 0 ? Math.round(totalResponseMs / counted) : null;
@@ -974,24 +1021,24 @@ export function recordQuery(projectRoot, durationMs) {
         const keep = lines.slice(-50000).join('\n');
         writeFileSync(path, keep);
       }
-    } catch {
-      /* ignore */
+    } catch (err) {
+      console.warn('[lightrag] swallowed in recordQuery.truncate:', err?.message || err);
     }
-  } catch {
-    /* never throw */
+  } catch (err) {
+    console.warn('[lightrag] swallowed in recordQuery:', err?.message || err);
   }
 }
 function appendFileSafe(path, content) {
   try {
     appendFileSync(path, content);
-  } catch {
-    /* fall back to manual write */
+  } catch (err) {
+    console.warn('[lightrag] appendFileSync failed, falling back to read+write:', err?.message || err);
     try {
       const cur = existsSync(path) ? readFileSync(path, 'utf8') : '';
       writeFileSync(path, cur + content);
-    } catch {
-      /* swallow — stats are best-effort */
+    } catch (err2) {
+      console.warn('[lightrag] swallowed in appendFileSafe.manualWrite:', err2?.message || err2);
     }
   }
 }
@@ -1024,13 +1071,13 @@ export async function rebuildGraph(projectRoot, opts = {}) {
       for (const e of readdirSync(config.workingDir)) {
         try {
           unlinkSync(join(config.workingDir, e));
-        } catch {
-          /* skip */
+        } catch (err) {
+          console.warn('[lightrag] swallowed in rebuildGraph.unlinkEntry:', err?.message || err);
         }
       }
     }
-  } catch {
-    /* ignore */
+  } catch (err) {
+    console.warn('[lightrag] swallowed in rebuildGraph.wipe:', err?.message || err);
   }
   // Reindex from scratch.
   return reindexVault(projectRoot, opts);

package/bizar-dash/src/server/metrics.mjs ADDED Viewed

@@ -0,0 +1,193 @@
+/**
+ * src/server/metrics.mjs
+ *
+ * v4.7.0 — Tiny Prometheus-style metrics registry.
+ *
+ * Implements the three primitive metric types we actually use:
+ *   - counter(name, help)        → { inc(labels) }
+ *   - gauge(name, help)          → { set(value, labels) }
+ *   - histogram(name, help, opts) → { observe(value, labels) }
+ *
+ * Storage is in-process: counters/gauges/histograms are kept in Maps
+ * keyed by metric name → label-set signature → values. Labels are
+ * JSON-stringified to produce a stable key (sorted-keys would be
+ * nicer but JSON.stringify of a literal object preserves insertion
+ * order, which is good enough for our use — every caller writes the
+ * same label shape for the same metric).
+ *
+ * `render()` returns the Prometheus text exposition format
+ * (Content-Type: text/plain; version=0.0.4) so it can be scraped by
+ * Prometheus or read by humans. The output includes the `# HELP` and
+ * `# TYPE` headers for every metric.
+ *
+ * `reset()` clears the registry — only intended for tests.
+ */
+const counters = new Map();
+const gauges = new Map();
+const histograms = new Map();
+// Default Prometheus-style histogram buckets in seconds (suitable for
+// HTTP latency). Override per-metric via opts.buckets.
+const DEFAULT_BUCKETS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+function labelsKey(labels) {
+  if (!labels || typeof labels !== 'object') return '{}';
+  const keys = Object.keys(labels);
+  if (keys.length === 0) return '{}';
+  const ordered = {};
+  for (const k of keys.sort()) ordered[k] = labels[k];
+  return JSON.stringify(ordered);
+}
+function labelsToString(labels) {
+  if (!labels || typeof labels !== 'object') return '';
+  const keys = Object.keys(labels);
+  if (keys.length === 0) return '';
+  return keys
+    .sort()
+    .map((k) => `${k}="${escapeLabelValue(String(labels[k]))}"`)
+    .join(',');
+}
+function escapeLabelValue(v) {
+  return v.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/"/g, '\\"');
+}
+export function counter(name, help) {
+  if (!name) throw new Error('counter(name, help): name is required');
+  return {
+    inc(labels = {}) {
+      const key = labelsKey(labels);
+      let entry = counters.get(name);
+      if (!entry) {
+        entry = { help: help || '', values: new Map() };
+        counters.set(name, entry);
+      }
+      const v = entry.values.get(key) || { labels, value: 0 };
+      v.value += 1;
+      entry.values.set(key, v);
+    },
+  };
+}
+export function gauge(name, help) {
+  if (!name) throw new Error('gauge(name, help): name is required');
+  return {
+    set(value, labels = {}) {
+      const key = labelsKey(labels);
+      let entry = gauges.get(name);
+      if (!entry) {
+        entry = { help: help || '', values: new Map() };
+        gauges.set(name, entry);
+      }
+      entry.values.set(key, { labels, value: Number(value) });
+    },
+  };
+}
+export function histogram(name, help, opts = {}) {
+  if (!name) throw new Error('histogram(name, help, opts): name is required');
+  const buckets = Array.isArray(opts.buckets) && opts.buckets.length > 0
+    ? [...opts.buckets].sort((a, b) => a - b)
+    : DEFAULT_BUCKETS;
+  return {
+    observe(value, labels = {}) {
+      const key = labelsKey(labels);
+      let entry = histograms.get(name);
+      if (!entry) {
+        entry = {
+          help: help || '',
+          buckets,
+          values: new Map(),
+        };
+        histograms.set(name, entry);
+      }
+      const v = entry.values.get(key) || {
+        labels,
+        count: 0,
+        sum: 0,
+        bucketCounts: buckets.map(() => 0),
+      };
+      v.count += 1;
+      v.sum += Number(value);
+      for (let i = 0; i < buckets.length; i += 1) {
+        if (Number(value) <= buckets[i]) v.bucketCounts[i] += 1;
+      }
+      entry.values.set(key, v);
+    },
+  };
+}
+function renderCounters() {
+  const lines = [];
+  for (const [name, entry] of counters) {
+    lines.push(`# HELP ${name} ${entry.help}`);
+    lines.push(`# TYPE ${name} counter`);
+    for (const v of entry.values.values()) {
+      const labels = labelsToString(v.labels);
+      lines.push(`${name}${labels ? '{' + labels + '}' : ''} ${v.value}`);
+    }
+  }
+  return lines;
+}
+function renderGauges() {
+  const lines = [];
+  for (const [name, entry] of gauges) {
+    lines.push(`# HELP ${name} ${entry.help}`);
+    lines.push(`# TYPE ${name} gauge`);
+    for (const v of entry.values.values()) {
+      const labels = labelsToString(v.labels);
+      lines.push(`${name}${labels ? '{' + labels + '}' : ''} ${v.value}`);
+    }
+  }
+  return lines;
+}
+function renderHistograms() {
+  const lines = [];
+  for (const [name, entry] of histograms) {
+    lines.push(`# HELP ${name} ${entry.help}`);
+    lines.push(`# TYPE ${name} histogram`);
+    for (const v of entry.values.values()) {
+      const baseLabels = labelsToString(v.labels);
+      for (let i = 0; i < entry.buckets.length; i += 1) {
+        const le = entry.buckets[i];
+        const bucketLabels = baseLabels
+          ? `${baseLabels},le="${le}"`
+          : `le="${le}"`;
+        lines.push(`${name}_bucket{${bucketLabels}} ${v.bucketCounts[i]}`);
+      }
+      const infLabels = baseLabels ? `${baseLabels},le="+Inf"` : 'le="+Inf"';
+      lines.push(`${name}_bucket{${infLabels}} ${v.count}`);
+      const sumLabels = baseLabels;
+      lines.push(
+        `${name}_sum${sumLabels ? '{' + sumLabels + '}' : ''} ${v.sum}`,
+      );
+      lines.push(
+        `${name}_count${sumLabels ? '{' + sumLabels + '}' : ''} ${v.count}`,
+      );
+    }
+  }
+  return lines;
+}
+export function render() {
+  const parts = [
+    ...renderCounters(),
+    ...renderGauges(),
+    ...renderHistograms(),
+  ];
+  return parts.length === 0 ? '' : `${parts.join('\n')}\n`;
+}
+/**
+ * Reset every metric. Intended for tests — never call this from a
+ * long-running server.
+ */
+export function reset() {
+  counters.clear();
+  gauges.clear();
+  histograms.clear();
+}