@hasna/logs 0.3.9 → 0.3.11

package/dist/index-t97ttm0a.js

@@ -0,0 +1,543 @@
+// @bun
+import {
+  parseTime
+} from "./index-997bkzr2.js";
+
+// src/db/index.ts
+import { Database } from "bun:sqlite";
+import { join } from "path";
+import { existsSync, mkdirSync } from "fs";
+
+// src/db/migrations/001_alert_rules.ts
+function migrateAlertRules(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS alert_rules (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      name TEXT NOT NULL,
+      service TEXT,
+      level TEXT NOT NULL DEFAULT 'error' CHECK(level IN ('debug','info','warn','error','fatal')),
+      threshold_count INTEGER NOT NULL DEFAULT 10,
+      window_seconds INTEGER NOT NULL DEFAULT 60,
+      action TEXT NOT NULL DEFAULT 'webhook' CHECK(action IN ('webhook','log')),
+      webhook_url TEXT,
+      enabled INTEGER NOT NULL DEFAULT 1,
+      last_fired_at TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_alert_rules_project ON alert_rules(project_id)`);
+}
+
+// src/db/migrations/002_issues.ts
+function migrateIssues(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS issues (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      project_id TEXT REFERENCES projects(id) ON DELETE CASCADE,
+      fingerprint TEXT NOT NULL,
+      level TEXT NOT NULL,
+      service TEXT,
+      message_template TEXT NOT NULL,
+      first_seen TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      last_seen TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      count INTEGER NOT NULL DEFAULT 1,
+      status TEXT NOT NULL DEFAULT 'open' CHECK(status IN ('open','resolved','ignored')),
+      UNIQUE(project_id, fingerprint)
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_issues_project ON issues(project_id, status)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_issues_fingerprint ON issues(fingerprint)`);
+}
+
+// src/db/migrations/003_retention.ts
+var RETENTION_COLUMNS = [
+  "max_rows INTEGER NOT NULL DEFAULT 100000",
+  "debug_ttl_hours INTEGER NOT NULL DEFAULT 24",
+  "info_ttl_hours INTEGER NOT NULL DEFAULT 168",
+  "warn_ttl_hours INTEGER NOT NULL DEFAULT 720",
+  "error_ttl_hours INTEGER NOT NULL DEFAULT 2160"
+];
+function migrateRetention(db) {
+  for (const col of RETENTION_COLUMNS) {
+    try {
+      db.run(`ALTER TABLE projects ADD COLUMN ${col}`);
+    } catch {}
+  }
+}
+
+// src/db/migrations/004_page_auth.ts
+function migratePageAuth(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS page_auth (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      page_id TEXT NOT NULL UNIQUE REFERENCES pages(id) ON DELETE CASCADE,
+      type TEXT NOT NULL CHECK(type IN ('cookie','bearer','basic')),
+      credentials TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
+    )
+  `);
+}
+
+// src/db/index.ts
+var DATA_DIR = process.env.LOGS_DATA_DIR ?? join(process.env.HOME ?? "~", ".logs");
+var DB_PATH = process.env.LOGS_DB_PATH ?? join(DATA_DIR, "logs.db");
+var _db = null;
+function getDb() {
+  if (_db)
+    return _db;
+  if (!existsSync(DATA_DIR))
+    mkdirSync(DATA_DIR, { recursive: true });
+  _db = new Database(DB_PATH);
+  _db.run("PRAGMA journal_mode=WAL");
+  _db.run("PRAGMA foreign_keys=ON");
+  migrate(_db);
+  return _db;
+}
+function migrate(db) {
+  db.run(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      name TEXT NOT NULL UNIQUE,
+      github_repo TEXT,
+      base_url TEXT,
+      description TEXT,
+      github_description TEXT,
+      github_branch TEXT,
+      github_sha TEXT,
+      last_synced_at TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS pages (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      url TEXT NOT NULL,
+      path TEXT NOT NULL DEFAULT '/',
+      name TEXT,
+      last_scanned_at TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      UNIQUE(project_id, url)
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS logs (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+      timestamp TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      project_id TEXT REFERENCES projects(id) ON DELETE SET NULL,
+      page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+      level TEXT NOT NULL CHECK(level IN ('debug','info','warn','error','fatal')),
+      source TEXT NOT NULL DEFAULT 'sdk' CHECK(source IN ('sdk','script','scanner')),
+      service TEXT,
+      message TEXT NOT NULL,
+      trace_id TEXT,
+      session_id TEXT,
+      agent TEXT,
+      url TEXT,
+      stack_trace TEXT,
+      metadata TEXT
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_logs_project_level_ts ON logs(project_id, level, timestamp DESC)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_logs_trace ON logs(trace_id)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_logs_service ON logs(service)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_logs_page ON logs(page_id)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_logs_timestamp ON logs(timestamp DESC)`);
+  db.run(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS logs_fts USING fts5(
+      message, service, stack_trace,
+      content=logs, content_rowid=rowid
+    )
+  `);
+  db.run(`
+    CREATE TRIGGER IF NOT EXISTS logs_fts_insert AFTER INSERT ON logs BEGIN
+      INSERT INTO logs_fts(rowid, message, service, stack_trace)
+      VALUES (new.rowid, new.message, new.service, new.stack_trace);
+    END
+  `);
+  db.run(`
+    CREATE TRIGGER IF NOT EXISTS logs_fts_delete AFTER DELETE ON logs BEGIN
+      INSERT INTO logs_fts(logs_fts, rowid, message, service, stack_trace)
+      VALUES ('delete', old.rowid, old.message, old.service, old.stack_trace);
+    END
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS scan_jobs (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+      schedule TEXT NOT NULL DEFAULT '*/30 * * * *',
+      enabled INTEGER NOT NULL DEFAULT 1,
+      last_run_at TEXT,
+      created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now'))
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS scan_runs (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      job_id TEXT NOT NULL REFERENCES scan_jobs(id) ON DELETE CASCADE,
+      page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+      started_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      finished_at TEXT,
+      status TEXT NOT NULL DEFAULT 'running' CHECK(status IN ('running','completed','failed')),
+      logs_collected INTEGER NOT NULL DEFAULT 0,
+      errors_found INTEGER NOT NULL DEFAULT 0,
+      perf_score REAL
+    )
+  `);
+  db.run(`
+    CREATE TABLE IF NOT EXISTS performance_snapshots (
+      id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+      timestamp TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ','now')),
+      project_id TEXT NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+      page_id TEXT REFERENCES pages(id) ON DELETE SET NULL,
+      url TEXT NOT NULL,
+      lcp REAL,
+      fcp REAL,
+      cls REAL,
+      tti REAL,
+      ttfb REAL,
+      score REAL,
+      raw_audit TEXT
+    )
+  `);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_perf_project_ts ON performance_snapshots(project_id, timestamp DESC)`);
+  db.run(`CREATE INDEX IF NOT EXISTS idx_perf_page ON performance_snapshots(page_id)`);
+  migrateAlertRules(db);
+  migrateIssues(db);
+  migrateRetention(db);
+  migratePageAuth(db);
+}
+
+// src/lib/issues.ts
+import { createHash } from "crypto";
+function computeFingerprint(level, service, message, stackTrace) {
+  const normalized = message.replace(/[0-9a-f]{8,}/gi, "<id>").replace(/\d+/g, "<n>").replace(/https?:\/\/[^\s]+/g, "<url>").trim();
+  const stackFrame = stackTrace ? stackTrace.split(`
+`).slice(0, 3).join("|") : "";
+  const raw = `${level}|${service ?? ""}|${normalized}|${stackFrame}`;
+  return createHash("sha256").update(raw).digest("hex").slice(0, 16);
+}
+function upsertIssue(db, data) {
+  const fingerprint = computeFingerprint(data.level, data.service ?? null, data.message, data.stack_trace);
+  return db.prepare(`
+    INSERT INTO issues (project_id, fingerprint, level, service, message_template)
+    VALUES ($project_id, $fingerprint, $level, $service, $message_template)
+    ON CONFLICT(project_id, fingerprint) DO UPDATE SET
+      count = count + 1,
+      last_seen = strftime('%Y-%m-%dT%H:%M:%fZ','now'),
+      status = CASE WHEN status = 'resolved' THEN 'open' ELSE status END
+    RETURNING *
+  `).get({
+    $project_id: data.project_id ?? null,
+    $fingerprint: fingerprint,
+    $level: data.level,
+    $service: data.service ?? null,
+    $message_template: data.message.slice(0, 500)
+  });
+}
+function listIssues(db, projectId, status, limit = 50) {
+  const conditions = [];
+  const params = { $limit: limit };
+  if (projectId) {
+    conditions.push("project_id = $p");
+    params.$p = projectId;
+  }
+  if (status) {
+    conditions.push("status = $status");
+    params.$status = status;
+  }
+  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+  return db.prepare(`SELECT * FROM issues ${where} ORDER BY last_seen DESC LIMIT $limit`).all(params);
+}
+function getIssue(db, id) {
+  return db.prepare("SELECT * FROM issues WHERE id = $id").get({ $id: id });
+}
+function updateIssueStatus(db, id, status) {
+  return db.prepare("UPDATE issues SET status = $status WHERE id = $id RETURNING *").get({ $id: id, $status: status });
+}
+
+// src/lib/alerts.ts
+function createAlertRule(db, data) {
+  return db.prepare(`
+    INSERT INTO alert_rules (project_id, name, service, level, threshold_count, window_seconds, action, webhook_url)
+    VALUES ($project_id, $name, $service, $level, $threshold_count, $window_seconds, $action, $webhook_url)
+    RETURNING *
+  `).get({
+    $project_id: data.project_id,
+    $name: data.name,
+    $service: data.service ?? null,
+    $level: data.level ?? "error",
+    $threshold_count: data.threshold_count ?? 10,
+    $window_seconds: data.window_seconds ?? 60,
+    $action: data.action ?? "webhook",
+    $webhook_url: data.webhook_url ?? null
+  });
+}
+function listAlertRules(db, projectId) {
+  if (projectId) {
+    return db.prepare("SELECT * FROM alert_rules WHERE project_id = $p ORDER BY created_at DESC").all({ $p: projectId });
+  }
+  return db.prepare("SELECT * FROM alert_rules ORDER BY created_at DESC").all();
+}
+function updateAlertRule(db, id, data) {
+  const fields = Object.keys(data).map((k) => `${k} = $${k}`).join(", ");
+  if (!fields)
+    return db.prepare("SELECT * FROM alert_rules WHERE id = $id").get({ $id: id });
+  const params = Object.fromEntries(Object.entries(data).map(([k, v]) => [`$${k}`, v]));
+  params.$id = id;
+  return db.prepare(`UPDATE alert_rules SET ${fields} WHERE id = $id RETURNING *`).get(params);
+}
+function deleteAlertRule(db, id) {
+  db.run("DELETE FROM alert_rules WHERE id = $id", { $id: id });
+}
+async function evaluateAlerts(db, projectId, service, level) {
+  const rules = db.prepare(`
+    SELECT * FROM alert_rules
+    WHERE project_id = $p AND level = $level AND enabled = 1
+    AND ($service IS NULL OR service IS NULL OR service = $service)
+  `).all({ $p: projectId, $level: level, $service: service });
+  for (const rule of rules) {
+    const since = new Date(Date.now() - rule.window_seconds * 1000).toISOString();
+    const conditions = ["project_id = $p", "level = $level", "timestamp >= $since"];
+    const params = { $p: projectId, $level: rule.level, $since: since };
+    if (rule.service) {
+      conditions.push("service = $service");
+      params.$service = rule.service;
+    }
+    const { count } = db.prepare(`SELECT COUNT(*) as count FROM logs WHERE ${conditions.join(" AND ")}`).get(params);
+    if (count >= rule.threshold_count) {
+      await fireAlert(db, rule, count);
+    }
+  }
+}
+async function fireAlert(db, rule, count) {
+  if (rule.last_fired_at) {
+    const lastFired = new Date(rule.last_fired_at).getTime();
+    if (Date.now() - lastFired < rule.window_seconds * 1000)
+      return;
+  }
+  db.run("UPDATE alert_rules SET last_fired_at = strftime('%Y-%m-%dT%H:%M:%fZ','now') WHERE id = $id", { $id: rule.id });
+  const payload = {
+    alert: rule.name,
+    project_id: rule.project_id,
+    level: rule.level,
+    service: rule.service,
+    count,
+    threshold: rule.threshold_count,
+    window_seconds: rule.window_seconds,
+    fired_at: new Date().toISOString()
+  };
+  if (rule.action === "webhook" && rule.webhook_url) {
+    try {
+      await fetch(rule.webhook_url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(payload)
+      });
+    } catch (err) {
+      console.error(`Alert webhook failed for rule ${rule.id}:`, err);
+    }
+  } else {
+    console.warn(`[ALERT] ${rule.name}:`, JSON.stringify(payload));
+  }
+}
+
+// src/lib/ingest.ts
+var ERROR_LEVELS = new Set(["warn", "error", "fatal"]);
+function ingestLog(db, entry) {
+  const stmt = db.prepare(`
+    INSERT INTO logs (project_id, page_id, level, source, service, message, trace_id, session_id, agent, url, stack_trace, metadata)
+    VALUES ($project_id, $page_id, $level, $source, $service, $message, $trace_id, $session_id, $agent, $url, $stack_trace, $metadata)
+    RETURNING *
+  `);
+  const row = stmt.get({
+    $project_id: entry.project_id ?? null,
+    $page_id: entry.page_id ?? null,
+    $level: entry.level,
+    $source: entry.source ?? "sdk",
+    $service: entry.service ?? null,
+    $message: entry.message,
+    $trace_id: entry.trace_id ?? null,
+    $session_id: entry.session_id ?? null,
+    $agent: entry.agent ?? null,
+    $url: entry.url ?? null,
+    $stack_trace: entry.stack_trace ?? null,
+    $metadata: entry.metadata ? JSON.stringify(entry.metadata) : null
+  });
+  if (ERROR_LEVELS.has(entry.level)) {
+    if (entry.project_id) {
+      upsertIssue(db, { project_id: entry.project_id, level: entry.level, service: entry.service, message: entry.message, stack_trace: entry.stack_trace });
+      evaluateAlerts(db, entry.project_id, entry.service ?? null, entry.level).catch(() => {});
+    }
+  }
+  return row;
+}
+function ingestBatch(db, entries, sharedTraceId) {
+  if (sharedTraceId) {
+    entries = entries.map((e) => e.trace_id ? e : { ...e, trace_id: sharedTraceId });
+  }
+  const insert = db.prepare(`
+    INSERT INTO logs (project_id, page_id, level, source, service, message, trace_id, session_id, agent, url, stack_trace, metadata)
+    VALUES ($project_id, $page_id, $level, $source, $service, $message, $trace_id, $session_id, $agent, $url, $stack_trace, $metadata)
+    RETURNING *
+  `);
+  const tx = db.transaction((items) => items.map((entry) => insert.get({
+    $project_id: entry.project_id ?? null,
+    $page_id: entry.page_id ?? null,
+    $level: entry.level,
+    $source: entry.source ?? "sdk",
+    $service: entry.service ?? null,
+    $message: entry.message,
+    $trace_id: entry.trace_id ?? null,
+    $session_id: entry.session_id ?? null,
+    $agent: entry.agent ?? null,
+    $url: entry.url ?? null,
+    $stack_trace: entry.stack_trace ?? null,
+    $metadata: entry.metadata ? JSON.stringify(entry.metadata) : null
+  })));
+  const rows = tx(entries);
+  for (const entry of entries) {
+    if (ERROR_LEVELS.has(entry.level) && entry.project_id) {
+      upsertIssue(db, { project_id: entry.project_id, level: entry.level, service: entry.service, message: entry.message, stack_trace: entry.stack_trace });
+    }
+  }
+  return rows;
+}
+
+// src/lib/summarize.ts
+function summarizeLogs(db, projectId, since, until) {
+  const conditions = ["level IN ('warn','error','fatal')"];
+  const params = {};
+  if (projectId) {
+    conditions.push("project_id = $project_id");
+    params.$project_id = projectId;
+  }
+  if (since) {
+    conditions.push("timestamp >= $since");
+    params.$since = parseTime(since) ?? since;
+  }
+  if (until) {
+    conditions.push("timestamp <= $until");
+    params.$until = parseTime(until) ?? until;
+  }
+  const where = `WHERE ${conditions.join(" AND ")}`;
+  const sql = `
+    SELECT project_id, service, page_id, level,
+           COUNT(*) as count,
+           MAX(timestamp) as latest
+    FROM logs ${where}
+    GROUP BY project_id, service, page_id, level
+    ORDER BY count DESC
+  `;
+  return db.prepare(sql).all(params);
+}
+
+// src/lib/projects.ts
+function createProject(db, data) {
+  return db.prepare(`
+    INSERT INTO projects (name, github_repo, base_url, description)
+    VALUES ($name, $github_repo, $base_url, $description)
+    RETURNING *
+  `).get({
+    $name: data.name,
+    $github_repo: data.github_repo ?? null,
+    $base_url: data.base_url ?? null,
+    $description: data.description ?? null
+  });
+}
+function listProjects(db) {
+  return db.prepare("SELECT * FROM projects ORDER BY created_at DESC").all();
+}
+function getProject(db, id) {
+  return db.prepare("SELECT * FROM projects WHERE id = $id").get({ $id: id });
+}
+function updateProject(db, id, data) {
+  const fields = Object.keys(data).map((k) => `${k} = $${k}`).join(", ");
+  if (!fields)
+    return getProject(db, id);
+  const params = Object.fromEntries(Object.entries(data).map(([k, v]) => [`$${k}`, v]));
+  params.$id = id;
+  return db.prepare(`UPDATE projects SET ${fields} WHERE id = $id RETURNING *`).get(params);
+}
+function createPage(db, data) {
+  return db.prepare(`
+    INSERT INTO pages (project_id, url, path, name)
+    VALUES ($project_id, $url, $path, $name)
+    ON CONFLICT(project_id, url) DO UPDATE SET name = excluded.name
+    RETURNING *
+  `).get({
+    $project_id: data.project_id,
+    $url: data.url,
+    $path: data.path ?? new URL(data.url).pathname,
+    $name: data.name ?? null
+  });
+}
+function listPages(db, projectId) {
+  return db.prepare("SELECT * FROM pages WHERE project_id = $p ORDER BY created_at ASC").all({ $p: projectId });
+}
+function getPage(db, id) {
+  return db.prepare("SELECT * FROM pages WHERE id = $id").get({ $id: id });
+}
+function resolveProjectId(db, idOrName) {
+  if (!idOrName)
+    return null;
+  if (/^[0-9a-f]{8,}$/i.test(idOrName))
+    return idOrName;
+  const p = db.prepare("SELECT id FROM projects WHERE LOWER(name) = LOWER($n)").get({ $n: idOrName });
+  return p?.id ?? null;
+}
+function touchPage(db, id) {
+  db.run("UPDATE pages SET last_scanned_at = strftime('%Y-%m-%dT%H:%M:%fZ','now') WHERE id = $id", { $id: id });
+}
+
+// src/lib/perf.ts
+function saveSnapshot(db, data) {
+  return db.prepare(`
+    INSERT INTO performance_snapshots (project_id, page_id, url, lcp, fcp, cls, tti, ttfb, score, raw_audit)
+    VALUES ($project_id, $page_id, $url, $lcp, $fcp, $cls, $tti, $ttfb, $score, $raw_audit)
+    RETURNING *
+  `).get({
+    $project_id: data.project_id,
+    $page_id: data.page_id ?? null,
+    $url: data.url,
+    $lcp: data.lcp ?? null,
+    $fcp: data.fcp ?? null,
+    $cls: data.cls ?? null,
+    $tti: data.tti ?? null,
+    $ttfb: data.ttfb ?? null,
+    $score: data.score ?? null,
+    $raw_audit: data.raw_audit ?? null
+  });
+}
+function getLatestSnapshot(db, projectId, pageId) {
+  if (pageId) {
+    return db.prepare("SELECT * FROM performance_snapshots WHERE project_id = $p AND page_id = $pg ORDER BY timestamp DESC LIMIT 1").get({ $p: projectId, $pg: pageId });
+  }
+  return db.prepare("SELECT * FROM performance_snapshots WHERE project_id = $p ORDER BY timestamp DESC LIMIT 1").get({ $p: projectId });
+}
+function getPerfTrend(db, projectId, pageId, since, limit = 50) {
+  const conditions = ["project_id = $p"];
+  const params = { $p: projectId, $limit: limit };
+  if (pageId) {
+    conditions.push("page_id = $pg");
+    params.$pg = pageId;
+  }
+  if (since) {
+    conditions.push("timestamp >= $since");
+    params.$since = since;
+  }
+  return db.prepare(`SELECT * FROM performance_snapshots WHERE ${conditions.join(" AND ")} ORDER BY timestamp DESC LIMIT $limit`).all(params);
+}
+function scoreLabel(score) {
+  if (score === null)
+    return "unknown";
+  if (score >= 90)
+    return "green";
+  if (score >= 50)
+    return "yellow";
+  return "red";
+}
+
+export { getDb, listIssues, getIssue, updateIssueStatus, createAlertRule, listAlertRules, updateAlertRule, deleteAlertRule, ingestLog, ingestBatch, summarizeLogs, createProject, listProjects, getProject, updateProject, createPage, listPages, getPage, resolveProjectId, touchPage, saveSnapshot, getLatestSnapshot, getPerfTrend, scoreLabel };

package/dist/mcp/index.js

@@ -21,7 +21,7 @@ import {
   scoreLabel,
   summarizeLogs,
   updateIssueStatus
-} from "../index-1f2ghyhm.js";
+} from "../index-t97ttm0a.js";
 import {
   createJob,
   listJobs
@@ -28583,10 +28583,16 @@ server.tool("log_push_batch", {
     service: exports_external.string().optional(),
     trace_id: exports_external.string().optional(),
     metadata: exports_external.record(exports_external.unknown()).optional()
-  }))
-}, ({ entries }) => {
-  const rows = ingestBatch(db, entries.map((e) => ({ ...e, project_id: rp(e.project_id) })));
-  return { content: [{ type: "text", text: `Logged ${rows.length} entries` }] };
+  })),
+  trace_id: exports_external.string().optional().describe("Shared trace_id applied to all entries that don't have their own trace_id"),
+  project_id: exports_external.string().optional().describe("Shared project_id applied to all entries (individual entry project_id takes precedence)")
+}, ({ entries, trace_id, project_id }) => {
+  const mapped = entries.map((e) => ({
+    ...e,
+    project_id: rp(e.project_id ?? project_id)
+  }));
+  const rows = ingestBatch(db, mapped, trace_id);
+  return { content: [{ type: "text", text: `Logged ${rows.length} entries${trace_id ? ` (trace: ${trace_id})` : ""}` }] };
 });
 server.tool("log_search", {
   project_id: exports_external.string().optional(),
@@ -28770,5 +28776,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/dist/server/index.js

@@ -6,7 +6,7 @@ import {
   setPageAuth,
   setRetentionPolicy,
   startScheduler
-} from "../index-7qhh666n.js";
+} from "../index-2sbhn1ye.js";
 import {
   getHealth
 } from "../index-xjn8gam3.js";
@@ -31,7 +31,7 @@ import {
   updateAlertRule,
   updateIssueStatus,
   updateProject
-} from "../index-1f2ghyhm.js";
+} from "../index-t97ttm0a.js";
 import {
   createJob,
   deleteJob,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.9",
+  "version": "0.3.11",
   "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")