@hasna/logs 0.3.3 → 0.3.5

package/dist/cli/index.js

@@ -10,6 +10,7 @@ import {
   ingestLog,
   listPages,
   listProjects,
+  resolveProjectId,
   summarizeLogs
 } from "../index-5tvnhvgr.js";
 import {
@@ -2136,12 +2137,48 @@ var {
 } = import__.default;
 
 // src/cli/index.ts
+var C = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  yellow: "\x1B[33m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m",
+  bgRed: "\x1B[41m\x1B[97m",
+  magenta: "\x1B[35m"
+};
+var LEVEL_COLOR = {
+  fatal: C.bgRed,
+  error: C.red,
+  warn: C.yellow,
+  info: "",
+  debug: C.gray
+};
+function colorRow(ts, level, svc, msg) {
+  const lc = LEVEL_COLOR[level.toLowerCase()] ?? "";
+  const isTTY = process.stdout.isTTY;
+  if (!isTTY)
+    return `${ts}  ${pad(level.toUpperCase(), 5)}  ${pad(svc, 12)}  ${msg}`;
+  return `${C.dim}${ts}${C.reset}  ${lc}${C.bold}${pad(level.toUpperCase(), 5)}${C.reset}  ${C.cyan}${pad(svc, 12)}${C.reset}  ${msg}`;
+}
+function colorLevel(level) {
+  if (!process.stdout.isTTY)
+    return pad(level.toUpperCase(), 5);
+  const lc = LEVEL_COLOR[level.toLowerCase()] ?? "";
+  return `${lc}${C.bold}${pad(level.toUpperCase(), 5)}${C.reset}`;
+}
+function resolveProject(nameOrId) {
+  if (!nameOrId)
+    return;
+  return resolveProjectId(getDb(), nameOrId) ?? nameOrId;
+}
 var program2 = new Command().name("logs").description("@hasna/logs \u2014 log aggregation and monitoring").version("0.0.1");
-program2.command("list").description("Search and list logs").option("--project <id>", "Filter by project ID").option("--page <id>", "Filter by page ID").option("--level <levels>", "Comma-separated levels (error,warn,info,debug,fatal)").option("--service <name>", "Filter by service").option("--since <iso>", "Since timestamp or relative (1h, 24h, 7d)").option("--text <query>", "Full-text search").option("--limit <n>", "Max results", "100").option("--format <fmt>", "Output format: table|json|compact", "table").action((opts) => {
+program2.command("list").description("Search and list logs").option("--project <name|id>", "Filter by project name or ID").option("--page <id>", "Filter by page ID").option("--level <levels>", "Comma-separated levels (error,warn,info,debug,fatal)").option("--service <name>", "Filter by service").option("--since <iso>", "Since timestamp or relative (1h, 24h, 7d)").option("--text <query>", "Full-text search").option("--limit <n>", "Max results", "100").option("--format <fmt>", "Output format: table|json|compact", "table").action((opts) => {
   const db = getDb();
   const since = parseRelativeTime(opts.since);
   const rows = searchLogs(db, {
-    project_id: opts.project,
+    project_id: resolveProject(opts.project),
     page_id: opts.page,
     level: opts.level ? opts.level.split(",") : undefined,
     service: opts.service,
@@ -2160,27 +2197,27 @@ program2.command("list").description("Search and list logs").option("--project <
   }
   for (const r of rows) {
     const meta = r.metadata ? ` ${r.metadata}` : "";
-    console.log(`${r.timestamp}  ${pad(r.level.toUpperCase(), 5)}  ${pad(r.service ?? "-", 12)}  ${r.message}${meta}`);
+    console.log(`${colorRow(r.timestamp, r.level, r.service ?? "-", r.message)}${meta}`);
   }
   console.log(`
 ${rows.length} log(s)`);
 });
-program2.command("tail").description("Show most recent logs").option("--project <id>").option("--n <count>", "Number of logs", "50").action((opts) => {
-  const rows = tailLogs(getDb(), opts.project, Number(opts.n));
+program2.command("tail").description("Show most recent logs").option("--project <name|id>", "Project name or ID").option("--n <count>", "Number of logs", "50").action((opts) => {
+  const rows = tailLogs(getDb(), resolveProject(opts.project), Number(opts.n));
   for (const r of rows)
-    console.log(`${r.timestamp}  ${pad(r.level.toUpperCase(), 5)}  ${r.message}`);
+    console.log(colorRow(r.timestamp, r.level, r.service ?? "-", r.message));
 });
-program2.command("summary").description("Error/warn summary by service").option("--project <id>").option("--since <time>", "Relative time (1h, 24h, 7d)", "24h").action((opts) => {
-  const summary = summarizeLogs(getDb(), opts.project, parseRelativeTime(opts.since));
+program2.command("summary").description("Error/warn summary by service").option("--project <name|id>", "Project name or ID").option("--since <time>", "Relative time (1h, 24h, 7d)", "24h").action((opts) => {
+  const summary = summarizeLogs(getDb(), resolveProject(opts.project), parseRelativeTime(opts.since));
   if (!summary.length) {
     console.log("No errors/warnings in this window.");
     return;
   }
   for (const s of summary)
-    console.log(`${pad(s.level.toUpperCase(), 5)} ${pad(s.service ?? "-", 15)} count=${s.count} latest=${s.latest}`);
+    console.log(`${colorLevel(s.level)} ${C.cyan}${pad(s.service ?? "-", 15)}${C.reset} count=${s.count} latest=${s.latest}`);
 });
-program2.command("push <message>").description("Push a log entry").option("--level <level>", "Log level", "info").option("--service <name>").option("--project <id>").option("--trace <id>", "Trace ID").action((message, opts) => {
-  const row = ingestLog(getDb(), { level: opts.level, message, service: opts.service, project_id: opts.project, trace_id: opts.trace });
+program2.command("push <message>").description("Push a log entry").option("--level <level>", "Log level", "info").option("--service <name>").option("--project <name|id>", "Project name or ID").option("--trace <id>", "Trace ID").action((message, opts) => {
+  const row = ingestLog(getDb(), { level: opts.level, message, service: opts.service, project_id: resolveProject(opts.project), trace_id: opts.trace });
   console.log(`Logged: ${row.id}`);
 });
 var projectCmd = program2.command("project").description("Manage projects");
@@ -2198,38 +2235,38 @@ projectCmd.command("list").action(() => {
     console.log(`${p.id}  ${p.name}  ${p.base_url ?? ""}  ${p.github_repo ?? ""}`);
 });
 var pageCmd = program2.command("page").description("Manage pages");
-pageCmd.command("add").option("--project <id>").option("--url <url>").option("--name <name>").action((opts) => {
+pageCmd.command("add").option("--project <name|id>", "Project name or ID").option("--url <url>").option("--name <name>").action((opts) => {
   if (!opts.project || !opts.url) {
     console.error("--project and --url required");
     process.exit(1);
   }
-  const p = createPage(getDb(), { project_id: opts.project, url: opts.url, name: opts.name });
+  const p = createPage(getDb(), { project_id: resolveProject(opts.project), url: opts.url, name: opts.name });
   console.log(`Page registered: ${p.id} \u2014 ${p.url}`);
 });
-pageCmd.command("list").option("--project <id>").action((opts) => {
+pageCmd.command("list").option("--project <name|id>", "Project name or ID").action((opts) => {
   if (!opts.project) {
     console.error("--project required");
     process.exit(1);
   }
-  const pages = listPages(getDb(), opts.project);
+  const pages = listPages(getDb(), resolveProject(opts.project));
   for (const p of pages)
     console.log(`${p.id}  ${p.url}  last=${p.last_scanned_at ?? "never"}`);
 });
 var jobCmd = program2.command("job").description("Manage scan jobs");
-jobCmd.command("create").option("--project <id>").option("--schedule <cron>", "Cron expression", "*/30 * * * *").action((opts) => {
+jobCmd.command("create").option("--project <name|id>", "Project name or ID").option("--schedule <cron>", "Cron expression", "*/30 * * * *").action((opts) => {
   if (!opts.project) {
     console.error("--project required");
     process.exit(1);
   }
-  const j = createJob(getDb(), { project_id: opts.project, schedule: opts.schedule });
+  const j = createJob(getDb(), { project_id: resolveProject(opts.project), schedule: opts.schedule });
   console.log(`Job created: ${j.id} \u2014 ${j.schedule}`);
 });
-jobCmd.command("list").option("--project <id>").action((opts) => {
-  const jobs = listJobs(getDb(), opts.project);
+jobCmd.command("list").option("--project <name|id>", "Project name or ID").action((opts) => {
+  const jobs = listJobs(getDb(), resolveProject(opts.project));
   for (const j of jobs)
     console.log(`${j.id}  ${j.schedule}  enabled=${j.enabled}  last=${j.last_run_at ?? "never"}`);
 });
-program2.command("scan").description("Run an immediate scan for a job").option("--job <id>").option("--project <id>").action(async (opts) => {
+program2.command("scan").description("Run an immediate scan for a job").option("--job <id>").option("--project <name|id>", "Project name or ID").action(async (opts) => {
   if (!opts.job) {
     console.error("--job required");
     process.exit(1);
@@ -2302,12 +2339,12 @@ Errors: ${errorCount}  Warnings: ${warnCount}`);
     process.exit(0);
   });
 });
-program2.command("export").description("Export logs to JSON or CSV").option("--project <id>").option("--since <time>", "Relative time or ISO").option("--level <level>").option("--service <name>").option("--format <fmt>", "json or csv", "json").option("--output <file>", "Output file (default: stdout)").option("--limit <n>", "Max rows", "100000").action(async (opts) => {
+program2.command("export").description("Export logs to JSON or CSV").option("--project <name|id>", "Project name or ID").option("--since <time>", "Relative time or ISO").option("--level <level>").option("--service <name>").option("--format <fmt>", "json or csv", "json").option("--output <file>", "Output file (default: stdout)").option("--limit <n>", "Max rows", "100000").action(async (opts) => {
   const { exportToCsv, exportToJson } = await import("../export-c3eqjste.js");
   const { createWriteStream } = await import("fs");
   const db = getDb();
   const options = {
-    project_id: opts.project,
+    project_id: resolveProject(opts.project),
     since: parseRelativeTime(opts.since),
     level: opts.level,
     service: opts.service,

package/package.json

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

package/src/cli/index.ts

@@ -5,10 +5,37 @@ import { ingestLog } from "../lib/ingest.ts"
 import { searchLogs, tailLogs } from "../lib/query.ts"
 import { summarizeLogs } from "../lib/summarize.ts"
 import { createJob, listJobs } from "../lib/jobs.ts"
-import { createPage, createProject, listPages, listProjects } from "../lib/projects.ts"
+import { createPage, createProject, listPages, listProjects, resolveProjectId } from "../lib/projects.ts"
 import { runJob } from "../lib/scheduler.ts"
 import type { LogLevel } from "../types/index.ts"
 
+// ── Color helpers ──────────────────────────────────────────
+const C = {
+  reset: "\x1b[0m", bold: "\x1b[1m", dim: "\x1b[2m",
+  red: "\x1b[31m", yellow: "\x1b[33m", cyan: "\x1b[36m", gray: "\x1b[90m",
+  bgRed: "\x1b[41m\x1b[97m", magenta: "\x1b[35m",
+};
+const LEVEL_COLOR: Record<string, string> = {
+  fatal: C.bgRed, error: C.red, warn: C.yellow, info: "", debug: C.gray,
+};
+function colorRow(ts: string, level: string, svc: string, msg: string): string {
+  const lc = LEVEL_COLOR[level.toLowerCase()] ?? "";
+  const isTTY = process.stdout.isTTY;
+  if (!isTTY) return `${ts}  ${pad(level.toUpperCase(), 5)}  ${pad(svc, 12)}  ${msg}`;
+  return `${C.dim}${ts}${C.reset}  ${lc}${C.bold}${pad(level.toUpperCase(), 5)}${C.reset}  ${C.cyan}${pad(svc, 12)}${C.reset}  ${msg}`;
+}
+function colorLevel(level: string): string {
+  if (!process.stdout.isTTY) return pad(level.toUpperCase(), 5);
+  const lc = LEVEL_COLOR[level.toLowerCase()] ?? "";
+  return `${lc}${C.bold}${pad(level.toUpperCase(), 5)}${C.reset}`;
+}
+
+/** Resolve a project name or ID from CLI --project flag */
+function resolveProject(nameOrId: string | undefined): string | undefined {
+  if (!nameOrId) return undefined;
+  return resolveProjectId(getDb(), nameOrId) ?? nameOrId;
+}
+
 const program = new Command()
   .name("logs")
   .description("@hasna/logs — log aggregation and monitoring")
@@ -17,7 +44,7 @@ const program = new Command()
 // ── logs list ──────────────────────────────────────────────
 program.command("list")
   .description("Search and list logs")
-  .option("--project <id>", "Filter by project ID")
+  .option("--project <name|id>", "Filter by project name or ID")
   .option("--page <id>", "Filter by page ID")
   .option("--level <levels>", "Comma-separated levels (error,warn,info,debug,fatal)")
   .option("--service <name>", "Filter by service")
@@ -29,7 +56,7 @@ program.command("list")
     const db = getDb()
     const since = parseRelativeTime(opts.since)
     const rows = searchLogs(db, {
-      project_id: opts.project,
+      project_id: resolveProject(opts.project),
       page_id: opts.page,
       level: opts.level ? (opts.level.split(",") as LogLevel[]) : undefined,
       service: opts.service,
@@ -44,7 +71,7 @@ program.command("list")
     }
     for (const r of rows) {
       const meta = r.metadata ? ` ${r.metadata}` : ""
-      console.log(`${r.timestamp}  ${pad(r.level.toUpperCase(), 5)}  ${pad(r.service ?? "-", 12)}  ${r.message}${meta}`)
+      console.log(`${colorRow(r.timestamp, r.level, r.service ?? "-", r.message)}${meta}`)
     }
     console.log(`\n${rows.length} log(s)`)
   })
@@ -52,22 +79,22 @@ program.command("list")
 // ── logs tail ──────────────────────────────────────────────
 program.command("tail")
   .description("Show most recent logs")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--n <count>", "Number of logs", "50")
   .action((opts) => {
-    const rows = tailLogs(getDb(), opts.project, Number(opts.n))
-    for (const r of rows) console.log(`${r.timestamp}  ${pad(r.level.toUpperCase(), 5)}  ${r.message}`)
+    const rows = tailLogs(getDb(), resolveProject(opts.project), Number(opts.n))
+    for (const r of rows) console.log(colorRow(r.timestamp, r.level, r.service ?? "-", r.message))
   })
 
 // ── logs summary ──────────────────────────────────────────
 program.command("summary")
   .description("Error/warn summary by service")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--since <time>", "Relative time (1h, 24h, 7d)", "24h")
   .action((opts) => {
-    const summary = summarizeLogs(getDb(), opts.project, parseRelativeTime(opts.since))
+    const summary = summarizeLogs(getDb(), resolveProject(opts.project), parseRelativeTime(opts.since))
     if (!summary.length) { console.log("No errors/warnings in this window."); return }
-    for (const s of summary) console.log(`${pad(s.level.toUpperCase(), 5)} ${pad(s.service ?? "-", 15)} count=${s.count} latest=${s.latest}`)
+    for (const s of summary) console.log(`${colorLevel(s.level)} ${C.cyan}${pad(s.service ?? "-", 15)}${C.reset} count=${s.count} latest=${s.latest}`)
   })
 
 // ── logs push ─────────────────────────────────────────────
@@ -75,10 +102,10 @@ program.command("push <message>")
   .description("Push a log entry")
   .option("--level <level>", "Log level", "info")
   .option("--service <name>")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--trace <id>", "Trace ID")
   .action((message, opts) => {
-    const row = ingestLog(getDb(), { level: opts.level as LogLevel, message, service: opts.service, project_id: opts.project, trace_id: opts.trace })
+    const row = ingestLog(getDb(), { level: opts.level as LogLevel, message, service: opts.service, project_id: resolveProject(opts.project), trace_id: opts.trace })
     console.log(`Logged: ${row.id}`)
   })
 
@@ -104,18 +131,18 @@ projectCmd.command("list").action(() => {
 const pageCmd = program.command("page").description("Manage pages")
 
 pageCmd.command("add")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--url <url>")
   .option("--name <name>")
   .action((opts) => {
     if (!opts.project || !opts.url) { console.error("--project and --url required"); process.exit(1) }
-    const p = createPage(getDb(), { project_id: opts.project, url: opts.url, name: opts.name })
+    const p = createPage(getDb(), { project_id: resolveProject(opts.project), url: opts.url, name: opts.name })
     console.log(`Page registered: ${p.id} — ${p.url}`)
   })
 
-pageCmd.command("list").option("--project <id>").action((opts) => {
+pageCmd.command("list").option("--project <name|id>", "Project name or ID").action((opts) => {
   if (!opts.project) { console.error("--project required"); process.exit(1) }
-  const pages = listPages(getDb(), opts.project)
+  const pages = listPages(getDb(), resolveProject(opts.project))
   for (const p of pages) console.log(`${p.id}  ${p.url}  last=${p.last_scanned_at ?? "never"}`)
 })
 
@@ -123,16 +150,16 @@ pageCmd.command("list").option("--project <id>").action((opts) => {
 const jobCmd = program.command("job").description("Manage scan jobs")
 
 jobCmd.command("create")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--schedule <cron>", "Cron expression", "*/30 * * * *")
   .action((opts) => {
     if (!opts.project) { console.error("--project required"); process.exit(1) }
-    const j = createJob(getDb(), { project_id: opts.project, schedule: opts.schedule })
+    const j = createJob(getDb(), { project_id: resolveProject(opts.project), schedule: opts.schedule })
     console.log(`Job created: ${j.id} — ${j.schedule}`)
   })
 
-jobCmd.command("list").option("--project <id>").action((opts) => {
-  const jobs = listJobs(getDb(), opts.project)
+jobCmd.command("list").option("--project <name|id>", "Project name or ID").action((opts) => {
+  const jobs = listJobs(getDb(), resolveProject(opts.project))
   for (const j of jobs) console.log(`${j.id}  ${j.schedule}  enabled=${j.enabled}  last=${j.last_run_at ?? "never"}`)
 })
 
@@ -140,7 +167,7 @@ jobCmd.command("list").option("--project <id>").action((opts) => {
 program.command("scan")
   .description("Run an immediate scan for a job")
   .option("--job <id>")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .action(async (opts) => {
     if (!opts.job) { console.error("--job required"); process.exit(1) }
     const db = getDb()
@@ -216,7 +243,7 @@ program.command("watch")
 // ── logs export ───────────────────────────────────────────
 program.command("export")
   .description("Export logs to JSON or CSV")
-  .option("--project <id>")
+  .option("--project <name|id>", "Project name or ID")
   .option("--since <time>", "Relative time or ISO")
   .option("--level <level>")
   .option("--service <name>")
@@ -228,7 +255,7 @@ program.command("export")
     const { createWriteStream } = await import("node:fs")
     const db = getDb()
     const options = {
-      project_id: opts.project,
+      project_id: resolveProject(opts.project),
       since: parseRelativeTime(opts.since),
       level: opts.level,
       service: opts.service,