@hasna/logs 0.3.8 → 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

@@ -41,6 +41,10 @@ import {
 import {
   parseTime
 } from "../index-997bkzr2.js";
+import {
+  exportToCsv,
+  exportToJson
+} from "../index-eh9bkbpa.js";
 import {
   __commonJS,
   __export,
@@ -28654,6 +28658,34 @@ server.tool("log_context_from_id", {
 }, ({ log_id, brief }) => ({
   content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id), brief !== false)) }]
 }));
+server.tool("log_export", {
+  project_id: exports_external.string().optional().describe("Project name or ID"),
+  format: exports_external.enum(["json", "csv"]).optional().default("json").describe("Output format"),
+  since: exports_external.string().optional().describe("Since time (1h, 24h, 7d, ISO)"),
+  until: exports_external.string().optional(),
+  level: exports_external.array(exports_external.string()).optional().describe("Filter by levels"),
+  service: exports_external.string().optional(),
+  limit: exports_external.number().optional().default(1e5)
+}, (args) => {
+  const chunks = [];
+  const write = (s) => {
+    chunks.push(s);
+    return true;
+  };
+  const options = {
+    project_id: rp(args.project_id),
+    level: args.level,
+    service: args.service,
+    since: args.since,
+    until: args.until,
+    limit: args.limit ?? 1e5
+  };
+  if (args.format === "csv")
+    exportToCsv(db, options, write);
+  else
+    exportToJson(db, options, write);
+  return { content: [{ type: "text", text: chunks.join("") }] };
+});
 server.tool("log_diagnose", {
   project_id: exports_external.string(),
   since: exports_external.string().optional(),
@@ -28738,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.8",
+  "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

@@ -13,6 +13,7 @@ import { getLatestSnapshot, getPerfTrend, scoreLabel } from "../lib/perf.ts"
 import { createAlertRule, deleteAlertRule, listAlertRules } from "../lib/alerts.ts"
 import { listIssues, updateIssueStatus } from "../lib/issues.ts"
 import { diagnose } from "../lib/diagnose.ts"
+import { exportToJson, exportToCsv } from "../lib/export.ts"
 import { compare } from "../lib/compare.ts"
 import { getHealth } from "../lib/health.ts"
 import { getSessionContext } from "../lib/session-context.ts"
@@ -189,6 +190,30 @@ server.tool("log_context_from_id", {
   content: [{ type: "text", text: JSON.stringify(applyBrief(getLogContextFromId(db, log_id), brief !== false)) }]
 }))
 
+server.tool("log_export", {
+  project_id: z.string().optional().describe("Project name or ID"),
+  format: z.enum(["json", "csv"]).optional().default("json").describe("Output format"),
+  since: z.string().optional().describe("Since time (1h, 24h, 7d, ISO)"),
+  until: z.string().optional(),
+  level: z.array(z.string()).optional().describe("Filter by levels"),
+  service: z.string().optional(),
+  limit: z.number().optional().default(100000),
+}, (args) => {
+  const chunks: string[] = []
+  const write = (s: string) => { chunks.push(s); return true }
+  const options = {
+    project_id: rp(args.project_id),
+    level: args.level as never,
+    service: args.service,
+    since: args.since,
+    until: args.until,
+    limit: args.limit ?? 100000,
+  }
+  if (args.format === "csv") exportToCsv(db, options, write)
+  else exportToJson(db, options, write)
+  return { content: [{ type: "text" as const, text: chunks.join("") }] }
+})
+
 server.tool("log_diagnose", {
   project_id: z.string(),
   since: z.string().optional(),
@@ -275,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)