@hasna/logs 0.3.9 → 0.3.10

package/dist/cli/index.js

@@ -2430,6 +2430,49 @@ Exported ${count} log(s)
 `);
   }
 });
+program2.command("stats").description("Volume overview: count, DB size, timeline, top services, error rate").option("--project <name|id>", "Scope to a project").action((opts) => {
+  const db = getDb();
+  const projectId = resolveProject(opts.project);
+  const pFilter = projectId ? `WHERE project_id = '${projectId.replace(/'/g, "''")}'` : "";
+  const pAnd = projectId ? `AND project_id = '${projectId.replace(/'/g, "''")}'` : "";
+  const total = db.query(`SELECT COUNT(*) as c FROM logs ${pFilter}`).get().c;
+  const oldest = db.query(`SELECT MIN(timestamp) as t FROM logs ${pFilter}`).get().t;
+  const newest = db.query(`SELECT MAX(timestamp) as t FROM logs ${pFilter}`).get().t;
+  const byLevel = db.query(`SELECT level, COUNT(*) as c FROM logs ${pFilter} GROUP BY level ORDER BY c DESC`).all();
+  const topServices = db.query(`SELECT COALESCE(service, '-') as service, COUNT(*) as c FROM logs ${pFilter} GROUP BY service ORDER BY c DESC LIMIT 5`).all();
+  const days = db.query(`SELECT strftime('%Y-%m-%d', timestamp) as day, COUNT(*) as c FROM logs WHERE timestamp >= datetime('now', '-7 days') ${pAnd} GROUP BY day ORDER BY day`).all();
+  const errors = byLevel.find((r) => r.level === "error")?.c ?? 0;
+  const fatals = byLevel.find((r) => r.level === "fatal")?.c ?? 0;
+  const errorRate = total > 0 ? ((errors + fatals) / total * 100).toFixed(2) : "0.00";
+  console.log(`
+${C.bold}Log Volume Stats${C.reset}${projectId ? ` [${opts.project}]` : ""}`);
+  console.log(`  Total:      ${total.toLocaleString()}`);
+  console.log(`  Oldest:     ${oldest?.slice(0, 19) ?? "-"}`);
+  console.log(`  Newest:     ${newest?.slice(0, 19) ?? "-"}`);
+  console.log(`  Error rate: ${errorRate}%  (${errors} errors, ${fatals} fatals)`);
+  if (byLevel.length) {
+    console.log(`
+${C.bold}By Level:${C.reset}`);
+    for (const r of byLevel)
+      console.log(`  ${colorLevel(r.level)}  ${r.c.toLocaleString()}`);
+  }
+  if (topServices.length) {
+    console.log(`
+${C.bold}Top Services:${C.reset}`);
+    for (const r of topServices)
+      console.log(`  ${C.cyan}${pad(r.service, 20)}${C.reset}  ${r.c.toLocaleString()}`);
+  }
+  if (days.length) {
+    const maxC = Math.max(...days.map((d) => d.c));
+    console.log(`
+${C.bold}Last 7 Days:${C.reset}`);
+    for (const d of days) {
+      const bar = "\u2588".repeat(Math.max(1, Math.round(d.c / maxC * 20)));
+      console.log(`  ${d.day}  ${C.cyan}${bar}${C.reset}  ${d.c.toLocaleString()}`);
+    }
+  }
+  console.log("");
+});
 program2.command("health").description("Show server health and DB stats").action(async () => {
   const { getHealth } = await import("../health-9792c1rc.js");
   const h = getHealth(getDb());

package/dist/mcp/index.js

@@ -28770,5 +28770,24 @@ server.tool("delete_alert_rule", { id: exports_external.string() }, ({ id }) =>
 server.tool("get_health", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(getHealth(db)) }]
 }));
+server.tool("log_stats", {
+  project_id: exports_external.string().optional().describe("Project name or ID (scope stats to a project)")
+}, (args) => {
+  const projectId = rp(args.project_id);
+  const pFilter = projectId ? `WHERE project_id = ?` : "";
+  const pAnd = projectId ? `AND project_id = ?` : "";
+  const pParam = projectId ? [projectId] : [];
+  const total = db.query(`SELECT COUNT(*) as c FROM logs ${pFilter}`).get(...pParam).c;
+  const oldest = db.query(`SELECT MIN(timestamp) as t FROM logs ${pFilter}`).get(...pParam).t;
+  const newest = db.query(`SELECT MAX(timestamp) as t FROM logs ${pFilter}`).get(...pParam).t;
+  const byLevel = db.query(`SELECT level, COUNT(*) as c FROM logs ${pFilter} GROUP BY level ORDER BY c DESC`).all(...pParam);
+  const topServices = db.query(`SELECT COALESCE(service, '-') as service, COUNT(*) as c FROM logs ${pFilter} GROUP BY service ORDER BY c DESC LIMIT 5`).all(...pParam);
+  const days = db.query(`SELECT strftime('%Y-%m-%d', timestamp) as day, COUNT(*) as c FROM logs WHERE timestamp >= datetime('now', '-7 days') ${pAnd} GROUP BY day ORDER BY day`).all(...pParam);
+  const errors3 = (byLevel.find((r) => r.level === "error")?.c ?? 0) + (byLevel.find((r) => r.level === "fatal")?.c ?? 0);
+  const error_rate_pct = total > 0 ? parseFloat((errors3 / total * 100).toFixed(2)) : 0;
+  return {
+    content: [{ type: "text", text: JSON.stringify({ total, oldest, newest, by_level: Object.fromEntries(byLevel.map((r) => [r.level, r.c])), top_services: topServices, last_7_days: days, error_rate_pct }) }]
+  };
+});
 var transport = new StdioServerTransport;
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
   "type": "module",
   "main": "./dist/index.js",

package/src/cli/index.ts

@@ -346,6 +346,63 @@ program.command("export")
     }
   })
 
+// ── logs stats ────────────────────────────────────────────
+program.command("stats")
+  .description("Volume overview: count, DB size, timeline, top services, error rate")
+  .option("--project <name|id>", "Scope to a project")
+  .action((opts) => {
+    const db = getDb()
+    const projectId = resolveProject(opts.project)
+    const pFilter = projectId ? `WHERE project_id = '${projectId.replace(/'/g, "''")}'` : ""
+    const pAnd = projectId ? `AND project_id = '${projectId.replace(/'/g, "''")}'` : ""
+
+    const total = (db.query(`SELECT COUNT(*) as c FROM logs ${pFilter}`).get() as { c: number }).c
+    const oldest = (db.query(`SELECT MIN(timestamp) as t FROM logs ${pFilter}`).get() as { t: string | null }).t
+    const newest = (db.query(`SELECT MAX(timestamp) as t FROM logs ${pFilter}`).get() as { t: string | null }).t
+
+    const byLevel = db.query(`SELECT level, COUNT(*) as c FROM logs ${pFilter} GROUP BY level ORDER BY c DESC`)
+      .all() as { level: string; c: number }[]
+
+    const topServices = db.query(
+      `SELECT COALESCE(service, '-') as service, COUNT(*) as c FROM logs ${pFilter} GROUP BY service ORDER BY c DESC LIMIT 5`
+    ).all() as { service: string; c: number }[]
+
+    // Last 7 days histogram
+    const days = db.query(
+      `SELECT strftime('%Y-%m-%d', timestamp) as day, COUNT(*) as c FROM logs WHERE timestamp >= datetime('now', '-7 days') ${pAnd} GROUP BY day ORDER BY day`
+    ).all() as { day: string; c: number }[]
+
+    const errors = byLevel.find(r => r.level === "error")?.c ?? 0
+    const fatals = byLevel.find(r => r.level === "fatal")?.c ?? 0
+    const errorRate = total > 0 ? (((errors + fatals) / total) * 100).toFixed(2) : "0.00"
+
+    console.log(`\n${C.bold}Log Volume Stats${C.reset}${projectId ? ` [${opts.project}]` : ""}`)
+    console.log(`  Total:      ${total.toLocaleString()}`)
+    console.log(`  Oldest:     ${oldest?.slice(0, 19) ?? "-"}`)
+    console.log(`  Newest:     ${newest?.slice(0, 19) ?? "-"}`)
+    console.log(`  Error rate: ${errorRate}%  (${errors} errors, ${fatals} fatals)`)
+
+    if (byLevel.length) {
+      console.log(`\n${C.bold}By Level:${C.reset}`)
+      for (const r of byLevel) console.log(`  ${colorLevel(r.level)}  ${r.c.toLocaleString()}`)
+    }
+
+    if (topServices.length) {
+      console.log(`\n${C.bold}Top Services:${C.reset}`)
+      for (const r of topServices) console.log(`  ${C.cyan}${pad(r.service, 20)}${C.reset}  ${r.c.toLocaleString()}`)
+    }
+
+    if (days.length) {
+      const maxC = Math.max(...days.map(d => d.c))
+      console.log(`\n${C.bold}Last 7 Days:${C.reset}`)
+      for (const d of days) {
+        const bar = "█".repeat(Math.max(1, Math.round((d.c / maxC) * 20)))
+        console.log(`  ${d.day}  ${C.cyan}${bar}${C.reset}  ${d.c.toLocaleString()}`)
+      }
+    }
+    console.log("")
+  })
+
 // ── logs health ───────────────────────────────────────────
 program.command("health")
   .description("Show server health and DB stats")

package/src/mcp/index.ts

@@ -300,5 +300,26 @@ server.tool("get_health", {}, () => ({
   content: [{ type: "text", text: JSON.stringify(getHealth(db)) }]
 }))
 
+server.tool("log_stats", {
+  project_id: z.string().optional().describe("Project name or ID (scope stats to a project)"),
+}, (args) => {
+  const projectId = rp(args.project_id)
+  const pFilter = projectId ? `WHERE project_id = ?` : ""
+  const pAnd = projectId ? `AND project_id = ?` : ""
+  const pParam = projectId ? [projectId] : []
+
+  const total = (db.query(`SELECT COUNT(*) as c FROM logs ${pFilter}`).get(...pParam) as { c: number }).c
+  const oldest = (db.query(`SELECT MIN(timestamp) as t FROM logs ${pFilter}`).get(...pParam) as { t: string | null }).t
+  const newest = (db.query(`SELECT MAX(timestamp) as t FROM logs ${pFilter}`).get(...pParam) as { t: string | null }).t
+  const byLevel = db.query(`SELECT level, COUNT(*) as c FROM logs ${pFilter} GROUP BY level ORDER BY c DESC`).all(...pParam) as { level: string; c: number }[]
+  const topServices = db.query(`SELECT COALESCE(service, '-') as service, COUNT(*) as c FROM logs ${pFilter} GROUP BY service ORDER BY c DESC LIMIT 5`).all(...pParam) as { service: string; c: number }[]
+  const days = db.query(`SELECT strftime('%Y-%m-%d', timestamp) as day, COUNT(*) as c FROM logs WHERE timestamp >= datetime('now', '-7 days') ${pAnd} GROUP BY day ORDER BY day`).all(...pParam) as { day: string; c: number }[]
+  const errors = (byLevel.find(r => r.level === "error")?.c ?? 0) + (byLevel.find(r => r.level === "fatal")?.c ?? 0)
+  const error_rate_pct = total > 0 ? parseFloat(((errors / total) * 100).toFixed(2)) : 0
+  return {
+    content: [{ type: "text" as const, text: JSON.stringify({ total, oldest, newest, by_level: Object.fromEntries(byLevel.map(r => [r.level, r.c])), top_services: topServices, last_7_days: days, error_rate_pct }) }]
+  }
+})
+
 const transport = new StdioServerTransport()
 await server.connect(transport)