@krawlup/cli 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to `@krawlup/cli` are documented here. The format
 follows [Keep a Changelog](https://keepachangelog.com/) and the package
 uses [semantic versioning](https://semver.org/).
 
+## 1.2.2 - 2026-11-03
+
+### Added
+
+- **Colored output across the CLI.** Battery marks read at a glance —
+  ✓ green, ! yellow, ✗ red, – gray — with section titles bold cyan,
+  `fix:` values cyan, and summary counts in their own colors. Success
+  messages print green, errors red, and the login URL cyan.
+- **Pace-colored loading screens** ("lower is better"): the free-report
+  progress bar and elapsed clock run green while a stage is within its
+  expected time, yellow up to twice over, red beyond — completed, green.
+- `NO_COLOR` is honored everywhere; `FORCE_COLOR=1`/`FORCE_COLOR=0`
+  forces color on or off past the TTY auto-detection. `--json` and
+  `--md` output never carry escape codes, and pipes stay byte-clean.
+- The interactive TUI renders battery results as a structured colored
+  view (same palette) instead of pasting the plain text render.
+
+## 1.2.1 - 2026-11-03
+
+### Added
+
+- **`--version` / `-v`** prints the CLI version and exits — read from
+  `package.json` at runtime, and the battery's User-Agent string
+  (`krawlup-cli/x.y.z`) now derives from the same source so the two can
+  never drift.
+
 ## 1.2.0 - 2026-11-03
 
 ### Added

package/dist/entry.js

@@ -41209,7 +41209,7 @@ import { join as join2 } from "node:path";
 // package.json
 var package_default = {
   name: "@krawlup/cli",
-  version: "1.2.0",
+  version: "1.2.2",
   description: "Official CLI for krawlup — manage products, insights and analytics from the terminal, with a free no-account site battery.",
   license: "MIT",
   author: "Nowshad Hossain Rahat",
@@ -42631,6 +42631,31 @@ function severityTone(severity) {
   }
 }
 
+// src/checks/verdict.ts
+var MARKS = {
+  pass: "✓",
+  warn: "!",
+  fail: "✗",
+  unknown: "–"
+};
+var STATUS_COLOR = {
+  pass: "green",
+  warn: "yellow",
+  fail: "red",
+  unknown: "gray"
+};
+function summarize(sections) {
+  const s = { pass: 0, warn: 0, fail: 0, unknown: 0 };
+  for (const sec of sections) {
+    for (const c of sec.checks)
+      s[c.status]++;
+  }
+  return s;
+}
+function exitFor(summary) {
+  return summary.fail > 0 ? 1 : 0;
+}
+
 // src/ui/components.tsx
 var jsx_dev_runtime = __toESM(require_jsx_dev_runtime(), 1);
 var SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
@@ -42864,6 +42889,110 @@ function IssueLine({ issue: issue2 }) {
     ]
   }, undefined, true, undefined, this);
 }
+var LOCAL_DETAIL_CAP = 240;
+function LocalResultView({ result: result2 }) {
+  const s = result2.summary;
+  return /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Box_default, {
+    flexDirection: "column",
+    children: [
+      /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+        bold: true,
+        children: result2.title
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+        children: [
+          s.fail ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "red",
+            children: [
+              s.fail,
+              " fail"
+            ]
+          }, "f", true, undefined, this) : null,
+          s.warn ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "yellow",
+            children: [
+              s.warn,
+              " warn"
+            ]
+          }, "w", true, undefined, this) : null,
+          s.unknown ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "gray",
+            children: [
+              s.unknown,
+              " unknown"
+            ]
+          }, "u", true, undefined, this) : null,
+          s.pass ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            color: "green",
+            children: [
+              s.pass,
+              " pass"
+            ]
+          }, "p", true, undefined, this) : null
+        ].filter(Boolean).map((node2, i) => /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+          children: [
+            i > 0 ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+              dimColor: true,
+              children: " · "
+            }, undefined, false, undefined, this) : null,
+            node2
+          ]
+        }, i, true, undefined, this))
+      }, undefined, false, undefined, this),
+      result2.sections.map((sec) => /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Box_default, {
+        flexDirection: "column",
+        marginTop: 1,
+        children: [
+          /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            bold: true,
+            color: "cyan",
+            children: sec.title
+          }, undefined, false, undefined, this),
+          sec.checks.map((ch) => /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Box_default, {
+            flexDirection: "column",
+            children: [
+              /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                children: [
+                  "  ",
+                  /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                    color: STATUS_COLOR[ch.status],
+                    bold: ch.status !== "unknown",
+                    children: MARKS[ch.status]
+                  }, undefined, false, undefined, this),
+                  " ",
+                  ch.label.padEnd(18),
+                  ch.detail.slice(0, LOCAL_DETAIL_CAP)
+                ]
+              }, undefined, true, undefined, this),
+              ch.fix ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                children: [
+                  "    ",
+                  /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                    dimColor: true,
+                    children: "fix: "
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+                    color: "cyan",
+                    children: ch.fix
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this) : null
+            ]
+          }, ch.id, true, undefined, this)),
+          sec.note ? /* @__PURE__ */ jsx_dev_runtime.jsxDEV(Text, {
+            dimColor: true,
+            children: [
+              "  ",
+              sec.note.split(`
+`).map((l) => l.slice(0, LOCAL_DETAIL_CAP)).join(`
+  `)
+            ]
+          }, undefined, true, undefined, this) : null
+        ]
+      }, sec.id, true, undefined, this))
+    ]
+  }, undefined, true, undefined, this);
+}
 
 // src/ui/live-pane.tsx
 var import_react32 = __toESM(require_react(), 1);
@@ -42963,6 +43092,48 @@ function pickFirstEditAuditId(issues) {
 // src/ui/public-report.tsx
 var import_react31 = __toESM(require_react(), 1);
 
+// src/lib/ansi.ts
+var CODES = {
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m"
+};
+var RESET = "\x1B[0m";
+function colorEnabled(stream = process.stdout) {
+  if (process.env.FORCE_COLOR === "1" || process.env.FORCE_COLOR === "true")
+    return true;
+  if (process.env.FORCE_COLOR === "0" || process.env.FORCE_COLOR === "false")
+    return false;
+  if (process.env.NO_COLOR)
+    return false;
+  return !!stream?.isTTY;
+}
+function paint(preset, s, enabled) {
+  if (!enabled || s.length === 0)
+    return s;
+  return `${CODES[preset]}${s}${RESET}`;
+}
+var green = (s, enabled) => paint("green", s, enabled);
+var yellow = (s, enabled) => paint("yellow", s, enabled);
+var red = (s, enabled) => paint("red", s, enabled);
+var cyan = (s, enabled) => paint("cyan", s, enabled);
+var gray = (s, enabled) => paint("gray", s, enabled);
+var dim = (s, enabled) => paint("dim", s, enabled);
+var bold = (s, enabled) => paint("bold", s, enabled);
+function paceColor(elapsedSec, expectedSec) {
+  if (expectedSec <= 0)
+    return "green";
+  if (elapsedSec <= expectedSec)
+    return "green";
+  if (elapsedSec <= expectedSec * 2)
+    return "yellow";
+  return "red";
+}
+
 // src/ui/report-sections.tsx
 var jsx_dev_runtime2 = __toESM(require_jsx_dev_runtime(), 1);
 function safeText(v) {
@@ -43654,15 +43825,16 @@ function fmtClock(sec) {
   const s = Math.max(0, Math.floor(sec));
   return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, "0")}`;
 }
-function Bar({ pct, right, width }) {
+function Bar({ pct, right, rightTone, tone, width }) {
   const w = Math.max(6, width);
   const filled = Math.round(Math.min(100, Math.max(0, pct)) / 100 * w);
   const bar = "█".repeat(Math.min(filled, w)) + "░".repeat(Math.max(0, w - Math.min(filled, w)));
+  const color = pct >= 100 ? "green" : tone === "yellow" || tone === "red" ? tone : "cyan";
   return /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Text, {
     children: [
       "  ",
       /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Text, {
-        color: pct >= 100 ? "green" : "cyan",
+        color,
         children: bar
       }, undefined, false, undefined, this),
       " ",
@@ -43673,7 +43845,13 @@ function Bar({ pct, right, width }) {
           "%"
         ]
       }, undefined, true, undefined, this),
-      right ? /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Text, {
+      right ? rightTone && rightTone !== "green" ? /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Text, {
+        color: rightTone,
+        children: [
+          " ",
+          right
+        ]
+      }, undefined, true, undefined, this) : /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Text, {
         dimColor: true,
         children: [
           " ",
@@ -43701,6 +43879,10 @@ function PublicScanProgress({
   const elapsedInStage = (Date.now() - state.stageStartMs) / 1000;
   const barPct = Math.max(state.barPct, stageBarPct(state.stageIdx, elapsedInStage, pacing));
   const cols = useTerminalColumns();
+  const stageExpected = PUBLIC_SCAN_STAGES[state.stageIdx]?.seconds ?? 0;
+  const barTone = state.phase === "done" ? "green" : paceColor(elapsedInStage, stageExpected);
+  const plannedSec = PUBLIC_SCAN_STAGES.slice(0, state.stageIdx + 1).reduce((a, s) => a + s.seconds, 0);
+  const clockTone = state.phase === "done" ? "green" : paceColor(state.elapsedSec, plannedSec);
   const labelW = Math.max(20, Math.min(42, cols - 40));
   return /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Box_default, {
     flexDirection: "column",
@@ -43774,6 +43956,8 @@ function PublicScanProgress({
         children: /* @__PURE__ */ jsx_dev_runtime3.jsxDEV(Bar, {
           pct: barPct,
           right: fmtClock(state.elapsedSec),
+          rightTone: clockTone,
+          tone: barTone,
           width: Math.max(12, Math.min(32, cols - 44))
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this),
@@ -45162,8 +45346,23 @@ function normalizeDomainArg(raw) {
 // src/commands/local.ts
 import { Resolver } from "node:dns/promises";
 
+// src/lib/version.ts
+import { createRequire as createRequire2 } from "node:module";
+var require2 = createRequire2(import.meta.url);
+function readVersion() {
+  for (const rel of ["../package.json", "../../package.json"]) {
+    try {
+      const pkg = require2(rel);
+      if (typeof pkg?.version === "string" && pkg.version)
+        return pkg.version;
+    } catch {}
+  }
+  return "0.0.0";
+}
+var CLI_VERSION2 = readVersion();
+
 // src/checks/net.ts
-var KRAWLUP_CLI_UA = "Mozilla/5.0 (compatible; krawlup-cli/1.2; +https://krawlup.com/cli)";
+var KRAWLUP_CLI_UA = `Mozilla/5.0 (compatible; krawlup-cli/${CLI_VERSION2}; +https://krawlup.com/cli)`;
 var GPTBOT_UA = "GPTBot/1.0 (+https://openai.com/gptbot)";
 var DEFAULT_TIMEOUT_MS = 12000;
 var DEFAULT_CAP_BYTES = 2000000;
@@ -46288,25 +46487,6 @@ function defaultSnapshotDir() {
   return path.join(homedir3(), ".krawlup", "snapshots");
 }
 
-// src/checks/verdict.ts
-var MARKS = {
-  pass: "✓",
-  warn: "!",
-  fail: "✗",
-  unknown: "–"
-};
-function summarize(sections) {
-  const s = { pass: 0, warn: 0, fail: 0, unknown: 0 };
-  for (const sec of sections) {
-    for (const c of sec.checks)
-      s[c.status]++;
-  }
-  return s;
-}
-function exitFor(summary) {
-  return summary.fail > 0 ? 1 : 0;
-}
-
 // src/commands/local.ts
 class UsageError extends Error {
 }
@@ -46613,31 +46793,37 @@ async function runLocalCommand(cmd, args, io = {}) {
   }
 }
 var DETAIL_CAP = 240;
-function renderLocalText(r) {
+function renderLocalText(r, opts) {
+  const on = opts?.color ?? colorEnabled();
   const out = [];
-  out.push(r.title);
+  out.push(bold(r.title, on));
   out.push([
-    r.summary.fail ? `${r.summary.fail} fail` : null,
-    r.summary.warn ? `${r.summary.warn} warn` : null,
-    r.summary.unknown ? `${r.summary.unknown} unknown` : null,
-    r.summary.pass ? `${r.summary.pass} pass` : null
-  ].filter(Boolean).join(" · "));
+    r.summary.fail ? red(`${r.summary.fail} fail`, on) : null,
+    r.summary.warn ? yellow(`${r.summary.warn} warn`, on) : null,
+    r.summary.unknown ? gray(`${r.summary.unknown} unknown`, on) : null,
+    r.summary.pass ? green(`${r.summary.pass} pass`, on) : null
+  ].filter(Boolean).join(dim(" · ", on)));
   for (const sec of r.sections) {
     out.push("");
-    out.push(sec.title);
-    for (const c of sec.checks) {
-      out.push(`  ${MARKS[c.status]} ${c.label.padEnd(18)}${c.detail.slice(0, DETAIL_CAP)}`);
-      if (c.fix)
-        out.push(`    fix: ${c.fix}`);
+    out.push(bold(cyan(sec.title, on), on));
+    for (const ch of sec.checks) {
+      out.push(`  ${mark(ch.status, on)} ${ch.label.padEnd(18)}${ch.detail.slice(0, DETAIL_CAP)}`);
+      if (ch.fix)
+        out.push(`    ${dim("fix:", on)} ${cyan(ch.fix, on)}`);
     }
     if (sec.note)
       for (const line of sec.note.split(`
 `))
-        out.push(`  ${line.slice(0, DETAIL_CAP)}`);
+        out.push(`  ${dim(line.slice(0, DETAIL_CAP), on)}`);
   }
   return out.join(`
 `);
 }
+function mark(status, on) {
+  const preset = STATUS_COLOR[status];
+  const painter = preset === "green" ? green : preset === "yellow" ? yellow : preset === "red" ? red : gray;
+  return painter(MARKS[status], on);
+}
 function renderLocalJson(r) {
   return JSON.stringify(r, null, 2);
 }
@@ -46655,10 +46841,10 @@ function renderLocalMarkdown(r) {
   for (const sec of r.sections) {
     out.push("", `## ${sec.title}`, "");
     for (const c of sec.checks) {
-      const mark = MARKS[c.status];
+      const mark2 = MARKS[c.status];
       const fix = c.fix ? ` Fix: \`${c.fix}\`.` : "";
       const detail = c.detail.replace(/\n/g, " ").slice(0, DETAIL_CAP);
-      out.push(`- ${mark} **${c.label}** — ${detail}${/[.!?…]$/.test(detail) ? "" : "."}${fix}`);
+      out.push(`- ${mark2} **${c.label}** — ${detail}${/[.!?…]$/.test(detail) ? "" : "."}${fix}`);
     }
     if (sec.note)
       out.push("", ...sec.note.split(`
@@ -47212,8 +47398,8 @@ function App2() {
           }
           try {
             const result2 = await runLocalCommand(cmd, localArgs);
-            push(/* @__PURE__ */ jsx_dev_runtime6.jsxDEV(Text, {
-              children: renderLocalText(result2)
+            push(/* @__PURE__ */ jsx_dev_runtime6.jsxDEV(LocalResultView, {
+              result: result2
             }, undefined, false, undefined, this));
           } catch (e) {
             if (e instanceof UsageError) {
@@ -48054,6 +48240,10 @@ var LOCAL_HELP_BLOCK = `
   krawlup diff <url>            snapshot a page; next run reports the drift
 `;
 var argv = process.argv.slice(2);
+if (argv.includes("--version") || argv.includes("-v")) {
+  console.log(CLI_VERSION2);
+  process.exit(0);
+}
 var interactive = !!process.stdout.isTTY && !!process.stdin.isTTY && argv.length === 0;
 function helpText(cfg) {
   const allowance = scanAllowance(cfg);
@@ -48086,6 +48276,7 @@ function helpText(cfg) {
 ${LOCAL_HELP_BLOCK}
   --json                   machine-readable output on data commands
   --help, -h               this page
+  --version, -v            print the version and exit
 
 'krawlup report' needs no account: your device id (~/.krawlup/device-id)
 carries the free quota — ${allowanceText(cfg)} — and every report read
@@ -48131,19 +48322,20 @@ async function argvMode() {
         console.log(helpText(scanConfig.get()));
         return;
       case "login": {
+        const outOn = colorEnabled();
         const out = await runLogin({
           apiBase: args[0],
-          onUrl: (url2, opened) => console.log(opened ? `opening your browser — if it did not, sign in at: ${url2}` : `sign in: ${url2}`)
+          onUrl: (url2, opened) => console.log(opened ? `opening your browser — if it did not, sign in at: ${cyan(url2, outOn)}` : `sign in: ${cyan(url2, outOn)}`)
         });
-        console.log(`✓ signed in → ${out.api} (session stored at ~/.krawlup/session.json)`);
+        console.log(green("✓", outOn) + ` signed in → ${out.api} (session stored at ~/.krawlup/session.json)`);
         await refreshScanConfig(out.api);
         if (scanConfig.get().betaUnlimited)
-          console.log("✓ beta tester — free scans are unlimited on this account");
+          console.log(green("✓", outOn) + " beta tester — free scans are unlimited on this account");
         return;
       }
       case "logout":
         await runLogout();
-        console.log("✓ signed out");
+        console.log(green("✓", colorEnabled()) + " signed out");
         return;
       case "report": {
         let initialScanState = function() {
@@ -48326,8 +48518,10 @@ async function argvMode() {
             break;
           case "scan":
             result2 = await scanAction(product, (update2) => {
-              if (process.stderr.isTTY)
-                console.error(update2.pending ? "⏳ scan running…" : "⏳ scan finished");
+              if (process.stderr.isTTY) {
+                const errOn = colorEnabled(process.stderr);
+                console.error(update2.pending ? "⏳ scan running…" : green("⏳ scan finished", errOn));
+              }
             });
             break;
           case "publish":
@@ -48405,7 +48599,7 @@ ${helpText(scanConfig.get())}`);
     if (argv.includes("--json")) {
       console.log(JSON.stringify({ error: true, message: msg }, null, 2));
     } else {
-      console.error(`✗ ${msg}`);
+      console.error(red(`✗ ${msg}`, colorEnabled(process.stderr)));
     }
     process.exitCode = e instanceof ReLoginRequired ? 2 : 1;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krawlup/cli",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Official CLI for krawlup — manage products, insights and analytics from the terminal, with a free no-account site battery.",
   "license": "MIT",
   "author": "Nowshad Hossain Rahat",