@hasna/logs 0.3.18 → 0.3.19

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,
@@ -22,7 +24,7 @@ import {
   scoreLabel,
   summarizeLogs,
   updateIssueStatus
-} from "../index-hwabsrfh.js";
+} from "../index-9n6bpjxf.js";
 import {
   createJob,
   listJobs
@@ -6524,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.18",
-    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.24",
-      "@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) {
@@ -23996,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)
@@ -24326,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) {

package/dist/server/index.js

@@ -6,7 +6,7 @@ import {
   setPageAuth,
   setRetentionPolicy,
   startScheduler
-} from "../index-8pwbytc6.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-hwabsrfh.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.18",
+  "version": "0.3.19",
   "description": "Log aggregation + browser script + headless page scanner + performance monitoring for AI agents",
   "type": "module",
   "main": "./dist/index.js",

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/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

@@ -4,6 +4,7 @@ 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"
@@ -21,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 }
@@ -355,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) {

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()