llmtap 0.1.4 → 0.1.7

package/dist/index.js

@@ -236,65 +236,250 @@ async function exportOtlp(db, limit, options) {
   console.log(chalk3.dim(`  Import into Jaeger, Grafana Tempo, Datadog, or any OTLP-compatible backend`));
 }
 
-// src/commands/status.ts
+// src/commands/backup.ts
+import fs3 from "fs";
+import path3 from "path";
 import chalk4 from "chalk";
-async function statusCommand() {
+import { backupDb, getDbPath } from "@llmtap/collector";
+
+// src/lib/collector.ts
+async function isCollectorRunning(baseUrl = "http://localhost:4781") {
+  try {
+    const res = await fetch(`${baseUrl}/health`, {
+      signal: AbortSignal.timeout(1500)
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+async function fetchCollectorDbInfo(baseUrl = "http://localhost:4781") {
   try {
-    const res = await fetch("http://localhost:4781/v1/db-info", {
+    const res = await fetch(`${baseUrl}/v1/db-info`, {
       signal: AbortSignal.timeout(3e3)
     });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+async function ingestSpans(spans, baseUrl = "http://localhost:4781", batchSize = 250) {
+  let accepted = 0;
+  for (let index = 0; index < spans.length; index += batchSize) {
+    const batch = spans.slice(index, index + batchSize);
+    const res = await fetch(`${baseUrl}/v1/spans`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ spans: batch }),
+      signal: AbortSignal.timeout(1e4)
+    });
     if (!res.ok) {
-      console.error(chalk4.red("  Collector responded with an error."));
+      const body = await res.text().catch(() => "");
+      throw new Error(`Collector import failed with HTTP ${res.status}${body ? `: ${body.slice(0, 200)}` : ""}`);
+    }
+    const payload = await res.json();
+    accepted += payload.accepted ?? batch.length;
+  }
+  return accepted;
+}
+function formatBytes(bytes) {
+  if (bytes === 0) return "0 B";
+  const units = ["B", "KB", "MB", "GB"];
+  const index = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);
+  return `${(bytes / Math.pow(1024, index)).toFixed(index === 0 ? 0 : 1)} ${units[index]}`;
+}
+
+// src/commands/backup.ts
+async function backupCommand(options) {
+  try {
+    const sourcePath = getDbPath();
+    const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+    const output = options.output?.trim() || `llmtap-backup-${stamp}.db`;
+    const backupPath = backupDb(output);
+    const sizeBytes = fs3.statSync(backupPath).size;
+    console.log("");
+    console.log(chalk4.bold.hex("#6366f1")("  LLMTap Backup"));
+    console.log("");
+    console.log(`  ${chalk4.gray("Source:")}      ${chalk4.white(sourcePath)}`);
+    console.log(`  ${chalk4.gray("Backup file:")} ${chalk4.white(path3.resolve(backupPath))}`);
+    console.log(`  ${chalk4.gray("Size:")}        ${chalk4.white(formatBytes(sizeBytes))}`);
+    console.log("");
+    console.log(chalk4.green("  Backup completed."));
+    console.log("");
+  } catch (err) {
+    const error = err;
+    console.error(chalk4.red(`  Backup failed: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+// src/commands/restore.ts
+import chalk5 from "chalk";
+import { restoreDb } from "@llmtap/collector";
+async function restoreCommand(inputPath, options) {
+  const host = options.host ?? "http://localhost:4781";
+  try {
+    if (await isCollectorRunning(host)) {
+      console.error(chalk5.red("  Restore blocked: the collector is currently running."));
+      console.error(chalk5.yellow("  Stop LLMTap first, then run restore again."));
       process.exit(1);
     }
-    const info = await res.json();
-    const formatBytes = (bytes) => {
-      if (bytes === 0) return "0 B";
-      const units = ["B", "KB", "MB", "GB"];
-      const i = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);
-      return `${(bytes / Math.pow(1024, i)).toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
-    };
+    const restoredPath = restoreDb(inputPath);
+    console.log("");
+    console.log(chalk5.bold.hex("#6366f1")("  LLMTap Restore"));
+    console.log("");
+    console.log(`  ${chalk5.gray("Backup:")}      ${chalk5.white(inputPath)}`);
+    console.log(`  ${chalk5.gray("Restored to:")} ${chalk5.white(restoredPath)}`);
+    console.log("");
+    console.log(chalk5.green("  Restore completed. Start LLMTap to inspect the restored data."));
     console.log("");
-    console.log(chalk4.bold.hex("#6366f1")("  LLMTap") + chalk4.green(" \u2014 Running"));
+  } catch (err) {
+    const error = err;
+    console.error(chalk5.red(`  Restore failed: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+// src/commands/import.ts
+import fs4 from "fs";
+import path4 from "path";
+import chalk6 from "chalk";
+import { insertSpans, resetDb as resetDb2 } from "@llmtap/collector";
+
+// src/lib/data.ts
+function isSpanCandidate(value) {
+  if (!value || typeof value !== "object") return false;
+  const span = value;
+  return typeof span.spanId === "string" && typeof span.traceId === "string" && typeof span.name === "string" && typeof span.operationName === "string" && typeof span.providerName === "string" && typeof span.requestModel === "string" && typeof span.startTime === "number" && typeof span.status === "string";
+}
+function collectFromArray(items) {
+  if (items.every(isSpanCandidate)) {
+    return items;
+  }
+  const spans = items.flatMap((item) => {
+    if (!item || typeof item !== "object") return [];
+    const trace = item;
+    return Array.isArray(trace.spans) ? trace.spans.filter(isSpanCandidate) : [];
+  });
+  return spans;
+}
+function normalizeImportPayload(payload) {
+  if (Array.isArray(payload)) {
+    const spans = collectFromArray(payload);
+    if (spans.length > 0) return spans;
+  }
+  if (payload && typeof payload === "object") {
+    const record = payload;
+    if (Array.isArray(record.spans)) {
+      const spans = record.spans.filter(isSpanCandidate);
+      if (spans.length > 0) return spans;
+    }
+    if (Array.isArray(record.traces)) {
+      const spans = collectFromArray(record.traces);
+      if (spans.length > 0) return spans;
+    }
+  }
+  throw new Error(
+    "Unsupported import file. Expected LLMTap JSON export with traces[].spans or a raw spans array."
+  );
+}
+function summarizeImportedSpans(spans) {
+  return {
+    spanCount: spans.length,
+    traceCount: new Set(spans.map((span) => span.traceId)).size
+  };
+}
+
+// src/commands/import.ts
+async function importCommand(inputPath, options) {
+  try {
+    const resolvedPath = path4.resolve(inputPath);
+    const file = fs4.readFileSync(resolvedPath, "utf8");
+    const payload = JSON.parse(file);
+    const spans = normalizeImportPayload(payload);
+    const summary = summarizeImportedSpans(spans);
+    const host = options.host ?? "http://localhost:4781";
+    const collectorRunning = await isCollectorRunning(host);
+    if (options.replace) {
+      if (collectorRunning) {
+        console.error(chalk6.red("  Replace import blocked: the collector is currently running."));
+        console.error(chalk6.yellow("  Stop LLMTap first, then rerun with --replace."));
+        process.exit(1);
+      }
+      resetDb2();
+    }
+    const accepted = collectorRunning ? await ingestSpans(spans, host) : insertSpans(spans);
     console.log("");
-    console.log(`  ${chalk4.gray("Spans:")}       ${chalk4.white(info.spanCount.toLocaleString())}`);
-    console.log(`  ${chalk4.gray("Traces:")}      ${chalk4.white(info.traceCount.toLocaleString())}`);
-    console.log(`  ${chalk4.gray("DB size:")}     ${chalk4.white(formatBytes(info.sizeBytes))}`);
-    console.log(`  ${chalk4.gray("WAL mode:")}    ${chalk4.white(info.walMode.toUpperCase())}`);
-    console.log(`  ${chalk4.gray("DB path:")}     ${chalk4.white(info.path)}`);
+    console.log(chalk6.bold.hex("#6366f1")("  LLMTap Import"));
+    console.log("");
+    console.log(`  ${chalk6.gray("File:")}        ${chalk6.white(resolvedPath)}`);
+    console.log(`  ${chalk6.gray("Trace count:")} ${chalk6.white(summary.traceCount.toLocaleString())}`);
+    console.log(`  ${chalk6.gray("Span count:")}  ${chalk6.white(summary.spanCount.toLocaleString())}`);
+    console.log(`  ${chalk6.gray("Mode:")}        ${chalk6.white(collectorRunning ? "Live ingest via collector" : "Direct local database import")}`);
+    if (options.replace) {
+      console.log(`  ${chalk6.gray("Replace:")}     ${chalk6.white("Yes")}`);
+    }
+    console.log("");
+    console.log(chalk6.green(`  Imported ${accepted.toLocaleString()} spans.`));
+    console.log("");
+  } catch (err) {
+    const error = err;
+    console.error(chalk6.red(`  Import failed: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+// src/commands/status.ts
+import chalk7 from "chalk";
+async function statusCommand(options = {}) {
+  try {
+    const info = await fetchCollectorDbInfo(options.host ?? "http://localhost:4781");
+    if (!info) {
+      console.error(chalk7.red("  Collector responded with an error."));
+      process.exit(1);
+    }
+    console.log("");
+    console.log(chalk7.bold.hex("#6366f1")("  LLMTap") + chalk7.green(" - Running"));
+    console.log("");
+    console.log(`  ${chalk7.gray("Spans:")}       ${chalk7.white(info.spanCount.toLocaleString())}`);
+    console.log(`  ${chalk7.gray("Traces:")}      ${chalk7.white(info.traceCount.toLocaleString())}`);
+    console.log(`  ${chalk7.gray("DB size:")}     ${chalk7.white(formatBytes(info.sizeBytes))}`);
+    console.log(`  ${chalk7.gray("WAL mode:")}    ${chalk7.white(info.walMode.toUpperCase())}`);
+    console.log(`  ${chalk7.gray("DB path:")}     ${chalk7.white(info.path)}`);
     if (info.oldestSpan && info.newestSpan) {
       const oldest = new Date(info.oldestSpan).toLocaleString();
       const newest = new Date(info.newestSpan).toLocaleString();
-      console.log(`  ${chalk4.gray("Data range:")}  ${chalk4.white(`${oldest} \u2014 ${newest}`)}`);
+      console.log(`  ${chalk7.gray("Data range:")}  ${chalk7.white(`${oldest} - ${newest}`)}`);
     }
     console.log("");
   } catch {
     console.log("");
-    console.log(chalk4.bold.hex("#6366f1")("  LLMTap") + chalk4.red(" \u2014 Not running"));
+    console.log(chalk7.bold.hex("#6366f1")("  LLMTap") + chalk7.red(" - Not running"));
     console.log("");
-    console.log(chalk4.gray("  Start the collector with: ") + chalk4.cyan("npx llmtap"));
+    console.log(chalk7.gray("  Start the collector with: ") + chalk7.cyan("npx llmtap"));
     console.log("");
   }
 }
 
 // src/commands/tail.ts
-import chalk5 from "chalk";
+import chalk8 from "chalk";
 async function tailCommand(options) {
   const format = options.format ?? "pretty";
   const url = "http://localhost:4781/v1/stream";
   console.log("");
   console.log(
-    chalk5.bold.hex("#6366f1")("  LLMTap") + chalk5.gray(" \u2014 Streaming traces in real-time")
+    chalk8.bold.hex("#6366f1")("  LLMTap") + chalk8.gray(" \u2014 Streaming traces in real-time")
   );
-  console.log(chalk5.gray("  Press Ctrl+C to stop"));
+  console.log(chalk8.gray("  Press Ctrl+C to stop"));
   console.log("");
   try {
     const res = await fetch(url, {
       headers: { Accept: "text/event-stream" }
     });
     if (!res.ok || !res.body) {
-      console.error(chalk5.red("  Could not connect to collector."));
-      console.error(chalk5.gray("  Make sure the collector is running: npx llmtap"));
+      console.error(chalk8.red("  Could not connect to collector."));
+      console.error(chalk8.gray("  Make sure the collector is running: npx llmtap"));
       process.exit(1);
     }
     const decoder = new TextDecoder();
@@ -317,13 +502,13 @@ async function tailCommand(options) {
           } else {
             const dur = span.duration ? `${span.duration}ms` : "...";
             const cost = span.totalCost > 0 ? `$${span.totalCost.toFixed(4)}` : "$0";
-            const statusIcon = span.status === "error" ? chalk5.red("ERR") : chalk5.green("OK ");
+            const statusIcon = span.status === "error" ? chalk8.red("ERR") : chalk8.green("OK ");
             console.log(
-              `  ${statusIcon} ${chalk5.gray(dur.padStart(7))} ${chalk5.cyan(span.providerName.padEnd(10))} ${chalk5.white(span.requestModel.padEnd(24))} ${chalk5.yellow(String(span.totalTokens).padStart(6) + " tok")} ${chalk5.green(cost.padStart(8))} ${chalk5.gray(span.name)}`
+              `  ${statusIcon} ${chalk8.gray(dur.padStart(7))} ${chalk8.cyan(span.providerName.padEnd(10))} ${chalk8.white(span.requestModel.padEnd(24))} ${chalk8.yellow(String(span.totalTokens).padStart(6) + " tok")} ${chalk8.green(cost.padStart(8))} ${chalk8.gray(span.name)}`
             );
             if (span.errorMessage) {
               console.log(
-                `       ${chalk5.red("\u2192 " + span.errorMessage.slice(0, 120))}`
+                `       ${chalk8.red("\u2192 " + span.errorMessage.slice(0, 120))}`
               );
             }
           }
@@ -332,146 +517,183 @@ async function tailCommand(options) {
       }
     }
   } catch {
-    console.error(chalk5.red("  Could not connect to collector."));
-    console.error(chalk5.gray("  Make sure the collector is running: npx llmtap"));
+    console.error(chalk8.red("  Could not connect to collector."));
+    console.error(chalk8.gray("  Make sure the collector is running: npx llmtap"));
     process.exit(1);
   }
 }
 
 // src/commands/doctor.ts
-import chalk6 from "chalk";
-async function doctorCommand() {
+import fs5 from "fs";
+import path5 from "path";
+import { createRequire } from "module";
+import chalk9 from "chalk";
+import { getDbDirPath, getDbPath as getDbPath2 } from "@llmtap/collector";
+function formatCheck(check) {
+  const icon = check.status === "ok" ? chalk9.green("  OK ") : check.status === "warn" ? chalk9.yellow("  !  ") : chalk9.red("  X  ");
+  const label = chalk9.white(check.label.padEnd(20));
+  const detail = check.status === "ok" ? chalk9.gray(check.detail) : check.status === "warn" ? chalk9.yellow(check.detail) : chalk9.red(check.detail);
+  return `${icon}${label} ${detail}`;
+}
+function hasLocalSdkInstall() {
+  try {
+    const requireFromCwd = createRequire(path5.join(process.cwd(), "__llmtap__.js"));
+    requireFromCwd.resolve("@llmtap/sdk");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function findPackageJson() {
+  const packageJsonPath = path5.join(process.cwd(), "package.json");
+  return fs5.existsSync(packageJsonPath) ? { hasPackageJson: true, path: packageJsonPath } : { hasPackageJson: false };
+}
+async function doctorCommand(options = {}) {
+  const host = options.host ?? "http://localhost:4781";
+  const checks = [];
+  const nextSteps = [];
   console.log("");
-  console.log(chalk6.bold.hex("#6366f1")("  LLMTap Doctor"));
-  console.log(chalk6.gray("  Checking your setup..."));
+  console.log(chalk9.bold.hex("#6366f1")("  LLMTap Doctor"));
+  console.log(chalk9.gray(`  Checking runtime, storage, and onboarding state at ${host}`));
   console.log("");
-  const checks = [];
   const nodeVersion = process.version;
   const major = parseInt(nodeVersion.slice(1), 10);
-  if (major >= 18) {
-    checks.push({ label: "Node.js version", status: "ok", detail: nodeVersion });
+  checks.push(
+    major >= 18 ? { label: "Node.js version", status: "ok", detail: nodeVersion } : { label: "Node.js version", status: "fail", detail: `${nodeVersion} (requires Node 18 or newer)` }
+  );
+  const collectorRunning = await isCollectorRunning(host);
+  if (collectorRunning) {
+    checks.push({ label: "Collector", status: "ok", detail: `Running at ${host}` });
   } else {
-    checks.push({ label: "Node.js version", status: "fail", detail: `${nodeVersion} (requires >= 18)` });
+    checks.push({ label: "Collector", status: "warn", detail: "Not running right now" });
+    nextSteps.push("Start LLMTap with `npx llmtap` to open the dashboard and collector.");
   }
-  try {
-    const res = await fetch("http://localhost:4781/health", {
-      signal: AbortSignal.timeout(3e3)
-    });
-    if (res.ok) {
-      checks.push({ label: "Collector", status: "ok", detail: "Running on port 4781" });
-    } else {
-      checks.push({ label: "Collector", status: "fail", detail: `Responded with HTTP ${res.status}` });
+  const dbDir = getDbDirPath();
+  const dbPath = getDbPath2();
+  const dbDirExists = fs5.existsSync(dbDir);
+  const dbFileExists = fs5.existsSync(dbPath);
+  checks.push(
+    dbDirExists ? { label: "DB directory", status: "ok", detail: dbDir } : { label: "DB directory", status: "warn", detail: `Not created yet (${dbDir})` }
+  );
+  if (dbDirExists) {
+    try {
+      fs5.accessSync(dbDir, fs5.constants.R_OK | fs5.constants.W_OK);
+      checks.push({ label: "DB permissions", status: "ok", detail: "Readable and writable" });
+    } catch {
+      checks.push({ label: "DB permissions", status: "fail", detail: "Current user cannot read/write the data directory" });
     }
-  } catch {
-    checks.push({ label: "Collector", status: "warn", detail: "Not running (start with: npx llmtap)" });
   }
-  try {
-    const res = await fetch("http://localhost:4781/v1/db-info", {
-      signal: AbortSignal.timeout(3e3)
+  if (dbFileExists) {
+    const stat = fs5.statSync(dbPath);
+    checks.push({ label: "DB file", status: "ok", detail: `${dbPath} (${formatBytes(stat.size)})` });
+  } else {
+    checks.push({ label: "DB file", status: "warn", detail: `No local database yet (${dbPath})` });
+  }
+  const dbInfo = collectorRunning ? await fetchCollectorDbInfo(host) : null;
+  if (collectorRunning && dbInfo) {
+    const spanSummary = dbInfo.spanCount > 0 ? `${dbInfo.spanCount.toLocaleString()} spans across ${dbInfo.traceCount.toLocaleString()} traces` : "Collector is healthy, but no spans have been captured yet";
+    checks.push({
+      label: "Collector data",
+      status: dbInfo.spanCount > 0 ? "ok" : "warn",
+      detail: `${spanSummary}; WAL=${dbInfo.walMode.toUpperCase()}`
     });
-    if (res.ok) {
-      const info = await res.json();
-      checks.push({
-        label: "Database",
-        status: info.walMode === "wal" ? "ok" : "warn",
-        detail: `${info.spanCount} spans, WAL=${info.walMode.toUpperCase()}`
-      });
+    if (dbInfo.spanCount === 0) {
+      nextSteps.push("Wrap your LLM client with `@llmtap/sdk`, make one model call, then refresh the dashboard.");
     }
-  } catch {
-    checks.push({ label: "Database", status: "warn", detail: "Cannot check (collector not running)" });
+  } else if (collectorRunning) {
+    checks.push({ label: "Collector data", status: "warn", detail: "Collector is up, but /v1/db-info did not respond cleanly" });
   }
-  try {
-    await import("@llmtap/sdk");
-    checks.push({ label: "@llmtap/sdk", status: "ok", detail: "Installed" });
-  } catch {
-    checks.push({ label: "@llmtap/sdk", status: "warn", detail: "Not found in current project (install with: npm i @llmtap/sdk)" });
+  const packageJson = findPackageJson();
+  if (packageJson.hasPackageJson) {
+    checks.push({ label: "Project root", status: "ok", detail: packageJson.path });
+  } else {
+    checks.push({ label: "Project root", status: "warn", detail: "No package.json in the current directory" });
+    nextSteps.push("Run `doctor` from the app you want to instrument so LLMTap can verify local dependencies.");
   }
-  if (checks.find((c) => c.label === "Collector")?.status !== "ok") {
-    try {
-      const res = await fetch("http://localhost:4781", {
-        signal: AbortSignal.timeout(1e3)
-      });
-      if (!res.ok) {
-        checks.push({ label: "Port 4781", status: "warn", detail: "Something is running but not LLMTap" });
-      }
-    } catch {
-      checks.push({ label: "Port 4781", status: "ok", detail: "Available" });
-    }
+  if (hasLocalSdkInstall()) {
+    checks.push({ label: "@llmtap/sdk", status: "ok", detail: "Installed in the current project" });
+  } else {
+    checks.push({ label: "@llmtap/sdk", status: "warn", detail: "Not installed in the current project" });
+    nextSteps.push("Install the SDK in your app with `npm i @llmtap/sdk` or `pnpm add @llmtap/sdk`.");
   }
   for (const check of checks) {
-    const icon = check.status === "ok" ? chalk6.green("  \u2713") : check.status === "warn" ? chalk6.yellow("  !") : chalk6.red("  \u2717");
-    const label = chalk6.white(check.label.padEnd(20));
-    const detail = check.status === "ok" ? chalk6.gray(check.detail) : check.status === "warn" ? chalk6.yellow(check.detail) : chalk6.red(check.detail);
-    console.log(`${icon} ${label} ${detail}`);
+    console.log(formatCheck(check));
   }
-  const failCount = checks.filter((c) => c.status === "fail").length;
-  const warnCount = checks.filter((c) => c.status === "warn").length;
+  const failCount = checks.filter((check) => check.status === "fail").length;
+  const warnCount = checks.filter((check) => check.status === "warn").length;
   console.log("");
+  if (nextSteps.length > 0) {
+    console.log(chalk9.bold.white("  Next steps"));
+    for (const step of nextSteps) {
+      console.log(chalk9.gray(`  - ${step}`));
+    }
+    console.log("");
+  }
   if (failCount > 0) {
-    console.log(chalk6.red(`  ${failCount} issue(s) found. Fix them to use LLMTap.`));
+    console.log(chalk9.red(`  ${failCount} blocking issue(s) found.`));
   } else if (warnCount > 0) {
-    console.log(chalk6.yellow(`  ${warnCount} warning(s). Everything should still work.`));
+    console.log(chalk9.yellow(`  ${warnCount} warning(s) found.`));
   } else {
-    console.log(chalk6.green("  All checks passed!"));
+    console.log(chalk9.green("  All checks passed."));
   }
   console.log("");
 }
 
 // src/commands/stats.ts
-import chalk7 from "chalk";
+import chalk10 from "chalk";
 async function statsCommand(options) {
   const period = Number(options.period ?? "24");
   const host = options.host ?? "http://localhost:4781";
   try {
     const res = await fetch(`${host}/v1/stats?period=${period}`);
     if (!res.ok) {
-      console.error(chalk7.red(`Error: Collector returned HTTP ${res.status}`));
-      console.error(chalk7.dim("Is the collector running? Try: npx llmtap start"));
+      console.error(chalk10.red(`Error: Collector returned HTTP ${res.status}`));
+      console.error(chalk10.dim("Is the collector running? Try: npx llmtap start"));
       process.exit(1);
     }
     const stats = await res.json();
     console.log("");
-    console.log(chalk7.bold.white(`  LLMTap Stats \u2014 Last ${period}h`));
-    console.log(chalk7.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk10.bold.white(`  LLMTap Stats \u2014 Last ${period}h`));
+    console.log(chalk10.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
     console.log("");
     const errorPct = (stats.errorRate * 100).toFixed(1);
-    console.log(`  ${chalk7.dim("Traces")}     ${chalk7.bold.white(String(stats.totalTraces))}`);
-    console.log(`  ${chalk7.dim("Spans")}      ${chalk7.bold.white(String(stats.totalSpans))}`);
-    console.log(`  ${chalk7.dim("Tokens")}     ${chalk7.bold.white(stats.totalTokens.toLocaleString())}`);
-    console.log(`  ${chalk7.dim("Total Cost")} ${chalk7.bold.green("$" + stats.totalCost.toFixed(4))}`);
-    console.log(`  ${chalk7.dim("Avg Latency")} ${chalk7.white(formatMs(stats.avgDuration))}`);
+    console.log(`  ${chalk10.dim("Traces")}     ${chalk10.bold.white(String(stats.totalTraces))}`);
+    console.log(`  ${chalk10.dim("Spans")}      ${chalk10.bold.white(String(stats.totalSpans))}`);
+    console.log(`  ${chalk10.dim("Tokens")}     ${chalk10.bold.white(stats.totalTokens.toLocaleString())}`);
+    console.log(`  ${chalk10.dim("Total Cost")} ${chalk10.bold.green("$" + stats.totalCost.toFixed(4))}`);
+    console.log(`  ${chalk10.dim("Avg Latency")} ${chalk10.white(formatMs(stats.avgDuration))}`);
     console.log(
-      `  ${chalk7.dim("Error Rate")} ${stats.errorRate > 0.05 ? chalk7.bold.red(errorPct + "%") : chalk7.green(errorPct + "%")} ${chalk7.dim(`(${stats.errorCount} errors)`)}`
+      `  ${chalk10.dim("Error Rate")} ${stats.errorRate > 0.05 ? chalk10.bold.red(errorPct + "%") : chalk10.green(errorPct + "%")} ${chalk10.dim(`(${stats.errorCount} errors)`)}`
     );
     if (stats.byProvider.length > 0) {
       console.log("");
-      console.log(chalk7.bold.white("  Top Providers"));
-      console.log(chalk7.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(chalk10.bold.white("  Top Providers"));
+      console.log(chalk10.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
       for (const p of stats.byProvider.slice(0, 5)) {
         const bar = makeBar(p.totalCost, stats.totalCost, 20);
         console.log(
-          `  ${chalk7.cyan(p.provider.padEnd(12))} ${chalk7.dim(String(p.spanCount).padStart(5) + " calls")} ${chalk7.green("$" + p.totalCost.toFixed(4).padStart(8))} ${chalk7.dim(bar)}`
+          `  ${chalk10.cyan(p.provider.padEnd(12))} ${chalk10.dim(String(p.spanCount).padStart(5) + " calls")} ${chalk10.green("$" + p.totalCost.toFixed(4).padStart(8))} ${chalk10.dim(bar)}`
         );
       }
     }
     if (stats.byModel.length > 0) {
       console.log("");
-      console.log(chalk7.bold.white("  Top Models"));
-      console.log(chalk7.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(chalk10.bold.white("  Top Models"));
+      console.log(chalk10.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
       for (const m of stats.byModel.slice(0, 8)) {
         const bar = makeBar(m.totalCost, stats.totalCost, 20);
         console.log(
-          `  ${chalk7.white(m.model.padEnd(28).slice(0, 28))} ${chalk7.dim(String(m.spanCount).padStart(5) + " calls")} ${chalk7.green("$" + m.totalCost.toFixed(4).padStart(8))} ${chalk7.dim(bar)}`
+          `  ${chalk10.white(m.model.padEnd(28).slice(0, 28))} ${chalk10.dim(String(m.spanCount).padStart(5) + " calls")} ${chalk10.green("$" + m.totalCost.toFixed(4).padStart(8))} ${chalk10.dim(bar)}`
         );
       }
     }
     console.log("");
   } catch (err) {
     if (err instanceof TypeError && err.cause) {
-      console.error(chalk7.red("Error: Cannot connect to collector"));
-      console.error(chalk7.dim("Is the collector running? Try: npx llmtap start"));
+      console.error(chalk10.red("Error: Cannot connect to collector"));
+      console.error(chalk10.dim("Is the collector running? Try: npx llmtap start"));
     } else {
-      console.error(chalk7.red("Error:"), err instanceof Error ? err.message : err);
+      console.error(chalk10.red("Error:"), err instanceof Error ? err.message : err);
     }
     process.exit(1);
   }
@@ -491,11 +713,14 @@ import { VERSION } from "@llmtap/shared";
 var program = new Command();
 program.name("llmtap").description("DevTools for AI Agents - See every LLM call, trace agent workflows, track costs").version(VERSION);
 program.command("start", { isDefault: true }).description("Start the LLMTap collector and dashboard").option("-p, --port <port>", "Port number", "4781").option("-H, --host <host>", "Host to bind to (use 0.0.0.0 to expose to network)", "127.0.0.1").option("-q, --quiet", "Suppress server logs").option("--demo", "Seed demo data on startup").option("--no-open", "Don't open browser automatically").option("-r, --retention <days>", "Auto-delete data older than N days (0 = keep forever)").action(startCommand);
-program.command("status").description("Show collector status, database info, and span count").action(statusCommand);
+program.command("status").description("Show collector status, database info, and span count").option("--host <url>", "Collector URL", "http://localhost:4781").action(statusCommand);
 program.command("reset").description("Clear all stored data").action(resetCommand);
 program.command("export").description("Export traces as JSON, CSV, or OTLP").option("-o, --output <path>", "Output file path", "llmtap-export.json").option("-f, --format <format>", "Output format (json, csv, or otlp)", "json").option("-l, --limit <count>", "Number of traces/spans to export", "100").option("-e, --endpoint <url>", "OTLP endpoint to forward spans to (e.g. http://localhost:4318/v1/traces)").option("-s, --service <name>", "service.name for OTLP export", "llmtap").action(exportCommand);
+program.command("backup").description("Create a portable SQLite backup of your local LLMTap data").option("-o, --output <path>", "Backup output path").action(backupCommand);
+program.command("restore <input>").description("Restore the local LLMTap database from a backup file").option("--host <url>", "Collector URL to check before restoring", "http://localhost:4781").action(restoreCommand);
+program.command("import <input>").description("Import LLMTap JSON exports back into local storage").option("--replace", "Replace the existing local database contents before importing").option("--host <url>", "Collector URL for live ingest when running", "http://localhost:4781").action(importCommand);
 program.command("tail").description("Stream traces to terminal in real-time").option("-f, --format <format>", "Output format (pretty or json)", "pretty").action(tailCommand);
-program.command("doctor").description("Diagnose common setup issues").action(doctorCommand);
+program.command("doctor").description("Diagnose common setup issues").option("--host <url>", "Collector URL", "http://localhost:4781").action(doctorCommand);
 program.command("stats").description("Show quick terminal stats (cost, models, errors)").option("-p, --period <hours>", "Time period in hours", "24").option("--host <url>", "Collector URL", "http://localhost:4781").action(statsCommand);
 program.parse();
 //# sourceMappingURL=index.js.map