@hasna/logs 0.3.17 → 0.3.19

package/dist/{index-2sbhn1ye.js → index-sgg59p1t.js}

@@ -5,7 +5,7 @@ import {
   listPages,
   saveSnapshot,
   touchPage
-} from "./index-t97ttm0a.js";
+} from "./index-9n6bpjxf.js";
 import {
   createScanRun,
   finishScanRun,
@@ -894,7 +894,7 @@ var require_scheduled_task = __commonJS((exports, module) => {
 
 // node_modules/node-cron/src/background-scheduled-task/index.js
 var require_background_scheduled_task = __commonJS((exports, module) => {
-  var __dirname = "/Users/hasna/Workspace/hasna/opensource/opensourcedev/open-logs/node_modules/node-cron/src/background-scheduled-task";
+  var __dirname = "/home/hasna/workspace/hasna/opensource/opensourcedev/open-logs/node_modules/node-cron/src/background-scheduled-task";
   var EventEmitter = __require("events");
   var path = __require("path");
   var { fork } = __require("child_process");

package/dist/mcp/index.js

@@ -4,10 +4,12 @@ import {
   getHealth
 } from "../index-cpvq9np9.js";
 import {
+  PACKAGE_VERSION,
   createAlertRule,
   createPage,
   createProject,
   deleteAlertRule,
+  exitIfMetadataRequest,
   getDb,
   getLatestSnapshot,
   getPerfTrend,
@@ -17,11 +19,12 @@ import {
   listIssues,
   listPages,
   listProjects,
+  registerCloudTools,
   resolveProjectId,
   scoreLabel,
   summarizeLogs,
   updateIssueStatus
-} from "../index-vmr85wa1.js";
+} from "../index-9n6bpjxf.js";
 import {
   createJob,
   listJobs
@@ -6523,69 +6526,6 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
-// package.json
-var require_package = __commonJS((exports, module) => {
-  module.exports = {
-    name: "@hasna/logs",
-    version: "0.3.16",
-    description: "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
-    type: "module",
-    main: "./dist/index.js",
-    types: "./dist/index.d.ts",
-    bin: {
-      logs: "./dist/cli/index.js",
-      "logs-mcp": "./dist/mcp/index.js",
-      "logs-serve": "./dist/server/index.js"
-    },
-    scripts: {
-      build: "bun build src/cli/index.ts src/mcp/index.ts src/server/index.ts --outdir dist --target bun --splitting --external playwright --external playwright-core --external electron --external chromium-bidi --external lighthouse",
-      "build:dashboard": "cd dashboard && bun run build",
-      "build:all": "bun run build:dashboard && bun run build",
-      dev: "bun run src/server/index.ts",
-      test: "bun test",
-      "test:coverage": "bun test --coverage",
-      lint: "biome check src/",
-      postinstall: "mkdir -p $HOME/.hasna/logs 2>/dev/null || true"
-    },
-    repository: {
-      type: "git",
-      url: "https://github.com/hasna/logs.git"
-    },
-    publishConfig: {
-      registry: "https://registry.npmjs.org",
-      access: "public"
-    },
-    keywords: [
-      "logs",
-      "monitoring",
-      "mcp",
-      "ai-agents",
-      "sentry",
-      "performance",
-      "lighthouse"
-    ],
-    author: "Andrei Hasna <andrei@hasna.com>",
-    license: "Apache-2.0",
-    dependencies: {
-      "@hasna/cloud": "0.1.5",
-      "@modelcontextprotocol/sdk": "^1.12.1",
-      commander: "^14.0.0",
-      hono: "^4.7.11",
-      ink: "^5.1.0",
-      "node-cron": "^3.0.3",
-      playwright: "^1.52.0",
-      react: "^19.1.0"
-    },
-    devDependencies: {
-      "@biomejs/biome": "^1.9.4",
-      "@types/bun": "latest",
-      "@types/node-cron": "^3.0.11",
-      "@types/react": "^19.1.4",
-      typescript: "^5.9.3"
-    }
-  };
-});
-
 // node_modules/@modelcontextprotocol/sdk/node_modules/zod/v3/helpers/util.js
 var util;
 (function(util2) {
@@ -23995,8 +23935,12 @@ async function getSessionContext(db, sessionId) {
 }
 
 // src/mcp/index.ts
+exitIfMetadataRequest({
+  name: "logs-mcp",
+  description: "Start the @hasna/logs MCP server over stdio."
+});
 var db = getDb();
-var server = new McpServer({ name: "logs", version: "0.3.0" });
+var server = new McpServer({ name: "logs", version: PACKAGE_VERSION });
 var _logsAgents = new Map;
 function applyBrief(rows, brief = true) {
   if (!brief)
@@ -24325,12 +24269,11 @@ server.tool("send_feedback", "Send feedback about this service", {
   category: exports_external.enum(["bug", "feature", "general"]).optional()
 }, async (params) => {
   try {
-    const pkg = require_package();
     db.run("INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)", [
       params.message,
       params.email || null,
       params.category || "general",
-      pkg.version
+      PACKAGE_VERSION
     ]);
     return { content: [{ type: "text", text: "Feedback saved. Thank you!" }] };
   } catch (e) {
@@ -24376,4 +24319,5 @@ server.tool("list_agents", "List all registered agents.", {}, async () => {
   return { content: [{ type: "text", text: JSON.stringify([..._logsAgents.values()]) }] };
 });
 var transport = new StdioServerTransport;
+registerCloudTools(server, "logs");
 await server.connect(transport);

package/dist/server/index.js

@@ -6,7 +6,7 @@ import {
   setPageAuth,
   setRetentionPolicy,
   startScheduler
-} from "../index-4ba0sabv.js";
+} from "../index-sgg59p1t.js";
 import {
   getHealth
 } from "../index-cpvq9np9.js";
@@ -15,6 +15,7 @@ import {
   createPage,
   createProject,
   deleteAlertRule,
+  exitIfMetadataRequest,
   getDb,
   getIssue,
   getLatestSnapshot,
@@ -26,12 +27,13 @@ import {
   listIssues,
   listPages,
   listProjects,
+  readOptionValue,
   resolveProjectId,
   summarizeLogs,
   updateAlertRule,
   updateIssueStatus,
   updateProject
-} from "../index-vmr85wa1.js";
+} from "../index-9n6bpjxf.js";
 import {
   createJob,
   deleteJob,
@@ -2442,7 +2444,13 @@ function streamRoutes(db) {
 }
 
 // src/server/index.ts
-var PORT = Number(process.env.LOGS_PORT ?? 3460);
+exitIfMetadataRequest({
+  name: "logs-serve",
+  description: "Start the @hasna/logs REST API server.",
+  options: ["  -p, --port <n>  Port to listen on (default: LOGS_PORT or 3460)"]
+});
+var portArg = readOptionValue(["--port", "-p"]);
+var PORT = Number(portArg ?? process.env.LOGS_PORT ?? 3460);
 var db = getDb();
 var app = new Hono2;
 app.use("*", cors());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/logs",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "description": "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
   "author": "Andrei Hasna <andrei@hasna.com>",
   "license": "Apache-2.0",
   "dependencies": {
-    "@hasna/cloud": "0.1.5",
+    "@hasna/cloud": "^0.1.24",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "commander": "^14.0.0",
     "hono": "^4.7.11",
@@ -56,4 +56,4 @@
     "@types/react": "^19.1.4",
     "typescript": "^5.9.3"
   }
-}
+}

package/src/cli/entrypoints.test.ts

@@ -0,0 +1,63 @@
+import { expect, test } from "bun:test"
+import { readFileSync } from "node:fs"
+import { fileURLToPath } from "node:url"
+
+const packageJson = JSON.parse(
+  readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
+) as { version: string }
+
+async function runEntrypoint(entryRelativePath: string, args: string[]) {
+  const entry = fileURLToPath(new URL(entryRelativePath, import.meta.url))
+  const proc = Bun.spawn(["bun", entry, ...args], {
+    env: {
+      ...process.env,
+      LOGS_PORT: "0",
+    },
+    stdout: "pipe",
+    stderr: "pipe",
+  })
+
+  const timeout = new Promise<never>((_, reject) => {
+    const timer = setTimeout(() => {
+      proc.kill()
+      reject(new Error(`Timed out running ${entryRelativePath} ${args.join(" ")}`.trim()))
+    }, 2000)
+
+    proc.exited.finally(() => clearTimeout(timer))
+  })
+
+  const exitCode = await Promise.race([proc.exited, timeout])
+  const stdout = await new Response(proc.stdout).text()
+  const stderr = await new Response(proc.stderr).text()
+
+  return { exitCode, stdout, stderr }
+}
+
+test("logs --version matches package.json", async () => {
+  const result = await runEntrypoint("./index.ts", ["--version"])
+
+  expect(result.exitCode).toBe(0)
+  expect(result.stdout.trim()).toBe(packageJson.version)
+  expect(result.stderr.trim()).toBe("")
+})
+
+test("logs-mcp --help prints usage and exits without starting stdio transport", async () => {
+  const result = await runEntrypoint("../mcp/index.ts", ["--help"])
+
+  expect(result.exitCode).toBe(0)
+  expect(result.stdout).toContain("Usage: logs-mcp [options]")
+  expect(result.stdout).toContain("Start the @hasna/logs MCP server over stdio.")
+  expect(result.stdout).not.toContain("Listening")
+  expect(result.stderr.trim()).toBe("")
+})
+
+test("logs-serve --help prints usage and exits without starting the server", async () => {
+  const result = await runEntrypoint("../server/index.ts", ["--help"])
+
+  expect(result.exitCode).toBe(0)
+  expect(result.stdout).toContain("Usage: logs-serve [options]")
+  expect(result.stdout).toContain("Start the @hasna/logs REST API server.")
+  expect(result.stdout).not.toContain("server running")
+  expect(result.stdout).not.toContain("Scheduler started")
+  expect(result.stderr.trim()).toBe("")
+})

package/src/cli/index.ts

@@ -2,6 +2,7 @@
 import { Command } from "commander"
 import { getDb } from "../db/index.ts"
 import { ingestLog } from "../lib/ingest.ts"
+import { PACKAGE_VERSION } from "../lib/package-meta.ts"
 import { searchLogs, tailLogs } from "../lib/query.ts"
 import { summarizeLogs } from "../lib/summarize.ts"
 import { createJob, listJobs } from "../lib/jobs.ts"
@@ -39,7 +40,7 @@ function resolveProject(nameOrId: string | undefined): string | undefined {
 const program = new Command()
   .name("logs")
   .description("@hasna/logs — log aggregation and monitoring")
-  .version("0.0.1")
+  .version(PACKAGE_VERSION)
 
 // ── logs list ──────────────────────────────────────────────
 program.command("list")

package/src/lib/ingest.ts

@@ -1,11 +1,11 @@
-import type { Database } from "bun:sqlite"
+import type { DbAdapter } from "@hasna/cloud"
 import type { LogEntry, LogRow } from "../types/index.ts"
 import { upsertIssue } from "./issues.ts"
 import { evaluateAlerts } from "./alerts.ts"
 
 const ERROR_LEVELS = new Set(["warn", "error", "fatal"])
 
-export function ingestLog(db: Database, entry: LogEntry): LogRow {
+export function ingestLog(db: DbAdapter, entry: LogEntry): LogRow {
   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)
@@ -37,7 +37,7 @@ export function ingestLog(db: Database, entry: LogEntry): LogRow {
   return row
 }
 
-export function ingestBatch(db: Database, entries: LogEntry[], sharedTraceId?: string | null): LogRow[] {
+export function ingestBatch(db: DbAdapter, entries: LogEntry[], sharedTraceId?: string | null): LogRow[] {
   // Apply shared trace_id to entries that don't have their own
   if (sharedTraceId) {
     entries = entries.map(e => e.trace_id ? e : { ...e, trace_id: sharedTraceId })
@@ -47,8 +47,9 @@ export function ingestBatch(db: Database, entries: LogEntry[], sharedTraceId?: s
     VALUES ($project_id, $page_id, $level, $source, $service, $message, $trace_id, $session_id, $agent, $url, $stack_trace, $metadata)
     RETURNING *
   `)
-  const tx = db.transaction((items: LogEntry[]) =>
-    items.map(entry =>
+  // @hasna/cloud executes the callback inside the transaction immediately.
+  const rows = db.transaction(() =>
+    entries.map(entry =>
       insert.get({
         $project_id: entry.project_id ?? null,
         $page_id: entry.page_id ?? null,
@@ -65,7 +66,6 @@ export function ingestBatch(db: Database, entries: LogEntry[], sharedTraceId?: s
       }) as LogRow
     )
   )
-  const rows = tx(entries)
 
   // Issue grouping for error-level entries (outside transaction for perf)
   for (const entry of entries) {

package/src/lib/package-meta.ts

@@ -0,0 +1,62 @@
+import { readFileSync } from "node:fs"
+
+type StandaloneCliSpec = {
+  name: string
+  description: string
+  options?: string[]
+}
+
+type PackageJson = {
+  version?: string
+}
+
+const packageJson = JSON.parse(
+  readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
+) as PackageJson
+
+export const PACKAGE_VERSION = packageJson.version ?? "0.0.0"
+
+export function exitIfMetadataRequest(spec: StandaloneCliSpec, argv = process.argv.slice(2)): void {
+  if (argv.includes("--version") || argv.includes("-V")) {
+    console.log(PACKAGE_VERSION)
+    process.exit(0)
+  }
+
+  if (argv.includes("--help") || argv.includes("-h")) {
+    const options = spec.options ?? []
+    const renderedOptions = [
+      "  -V, --version  output the version number",
+      "  -h, --help     display help for command",
+      ...options,
+    ]
+
+    console.log(
+      [
+        `Usage: ${spec.name} [options]`,
+        "",
+        spec.description,
+        "",
+        "Options:",
+        ...renderedOptions,
+      ].join("\n"),
+    )
+    process.exit(0)
+  }
+}
+
+export function readOptionValue(names: string[], argv = process.argv.slice(2)): string | undefined {
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index]
+    if (!arg) continue
+
+    const inline = names.find((name) => arg.startsWith(`${name}=`))
+    if (inline) return arg.slice(inline.length + 1)
+
+    if (names.includes(arg)) {
+      const next = argv[index + 1]
+      if (next && !next.startsWith("-")) return next
+    }
+  }
+
+  return undefined
+}

package/src/mcp/index.ts

@@ -1,8 +1,10 @@
 #!/usr/bin/env bun
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
+import { registerCloudTools } from "@hasna/cloud"
 import { z } from "zod"
 import { getDb } from "../db/index.ts"
+import { exitIfMetadataRequest, PACKAGE_VERSION } from "../lib/package-meta.ts"
 import { ingestBatch, ingestLog } from "../lib/ingest.ts"
 import { getLogContext, getLogContextFromId, searchLogs, tailLogs } from "../lib/query.ts"
 import { summarizeLogs } from "../lib/summarize.ts"
@@ -20,8 +22,13 @@ import { getSessionContext } from "../lib/session-context.ts"
 import { parseTime } from "../lib/parse-time.ts"
 import type { LogLevel, LogRow } from "../types/index.ts"
 
+exitIfMetadataRequest({
+  name: "logs-mcp",
+  description: "Start the @hasna/logs MCP server over stdio.",
+})
+
 const db = getDb()
-const server = new McpServer({ name: "logs", version: "0.3.0" })
+const server = new McpServer({ name: "logs", version: PACKAGE_VERSION })
 
 // --- in-memory agent registry ---
 interface _LogsAgent { id: string; name: string; session_id?: string; last_seen_at: string; project_id?: string }
@@ -354,9 +361,8 @@ server.tool(
   },
   async (params) => {
     try {
-      const pkg = require("../../package.json")
       db.run("INSERT INTO feedback (message, email, category, version) VALUES (?, ?, ?, ?)", [
-        params.message, params.email || null, params.category || "general", pkg.version,
+        params.message, params.email || null, params.category || "general", PACKAGE_VERSION,
       ])
       return { content: [{ type: "text" as const, text: "Feedback saved. Thank you!" }] }
     } catch (e) {
@@ -403,4 +409,5 @@ server.tool("list_agents", "List all registered agents.", {}, async () => {
 })
 
 const transport = new StdioServerTransport()
+registerCloudTools(server, "logs")
 await server.connect(transport)

package/src/server/index.ts

@@ -5,6 +5,7 @@ import { serveStatic } from "hono/bun"
 import { getDb } from "../db/index.ts"
 import { getBrowserScript } from "../lib/browser-script.ts"
 import { getHealth } from "../lib/health.ts"
+import { exitIfMetadataRequest, readOptionValue } from "../lib/package-meta.ts"
 import { startScheduler } from "../lib/scheduler.ts"
 import { alertsRoutes } from "./routes/alerts.ts"
 import { issuesRoutes } from "./routes/issues.ts"
@@ -14,7 +15,14 @@ import { perfRoutes } from "./routes/perf.ts"
 import { projectsRoutes } from "./routes/projects.ts"
 import { streamRoutes } from "./routes/stream.ts"
 
-const PORT = Number(process.env.LOGS_PORT ?? 3460)
+exitIfMetadataRequest({
+  name: "logs-serve",
+  description: "Start the @hasna/logs REST API server.",
+  options: ["  -p, --port <n>  Port to listen on (default: LOGS_PORT or 3460)"],
+})
+
+const portArg = readOptionValue(["--port", "-p"])
+const PORT = Number(portArg ?? process.env.LOGS_PORT ?? 3460)
 const db = getDb()
 const app = new Hono()
 

package/dist/export-yjaar93b.js

@@ -1,10 +0,0 @@
-// @bun
-import {
-  exportToCsv,
-  exportToJson
-} from "./index-eh9bkbpa.js";
-import"./index-g8dczzvv.js";
-export {
-  exportToJson,
-  exportToCsv
-};

package/dist/health-9792c1rc.js

@@ -1,8 +0,0 @@
-// @bun
-import {
-  getHealth
-} from "./index-xjn8gam3.js";
-import"./index-re3ntm60.js";
-export {
-  getHealth
-};

package/dist/health-egdb00st.js

@@ -1,8 +0,0 @@
-// @bun
-import {
-  getHealth
-} from "./index-yb8yd4j6.js";
-import"./index-g8dczzvv.js";
-export {
-  getHealth
-};

package/dist/index-14dvwcf1.js

@@ -1,45 +0,0 @@
-// @bun
-import {
-  parseTime
-} from "./index-997bkzr2.js";
-
-// src/lib/count.ts
-function countLogs(db, opts) {
-  const conditions = [];
-  const params = {};
-  if (opts.project_id) {
-    conditions.push("project_id = $p");
-    params.$p = opts.project_id;
-  }
-  if (opts.service) {
-    conditions.push("service = $service");
-    params.$service = opts.service;
-  }
-  if (opts.level) {
-    conditions.push("level = $level");
-    params.$level = opts.level;
-  }
-  const since = parseTime(opts.since);
-  const until = parseTime(opts.until);
-  if (since) {
-    conditions.push("timestamp >= $since");
-    params.$since = since;
-  }
-  if (until) {
-    conditions.push("timestamp <= $until");
-    params.$until = until;
-  }
-  const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
-  const byLevel = db.prepare(`SELECT level, COUNT(*) as c FROM logs ${where} GROUP BY level`).all(params);
-  const by_level = Object.fromEntries(byLevel.map((r) => [r.level, r.c]));
-  const total = byLevel.reduce((s, r) => s + r.c, 0);
-  return {
-    total,
-    errors: by_level["error"] ?? 0,
-    warns: by_level["warn"] ?? 0,
-    fatals: by_level["fatal"] ?? 0,
-    by_level
-  };
-}
-
-export { countLogs };