usehour 0.4.0 → 0.4.1

package/README.md

@@ -3,7 +3,7 @@
 Your year of building with AI, as Wrapped-style cards.
 
 ```
-npx usehour@0.4.0
+npx usehour@0.4.1
 ```
 
 - Asks before it reads anything, and lists the folders it will read.
@@ -11,7 +11,7 @@ npx usehour@0.4.0
 - Counts your habits, and finds a few of your best prompts (anything that looks like a key, password, email or home folder already hidden). You can pick some for your profile and black out words, but not add or change any.
 - Opens your cards in your browser. Save any card as an image to post it.
 - Optional: claim usehour.com/@you from the cards page. You see exactly what is sent first. The script itself never connects to the internet.
-- Counts only sessions you started yourself: sub-agents and runs started by scripts or SDKs are left out. `npx usehour@0.4.0 --explain` shows what was counted and what was left out, in your terminal only.
+- Counts only sessions you started yourself: sub-agents and runs started by scripts or SDKs are left out. `npx usehour@0.4.1 --explain` shows what was counted and what was left out, in your terminal only.
 - No dependencies, nothing installed.
 
 It's one file: read [hour.mjs](https://usehour.com/hour.mjs) before you run it.

package/hour.mjs

@@ -31,7 +31,7 @@ import { spawn } from "node:child_process";
 import { Worker, isMainThread, parentPort, workerData } from "node:worker_threads";
 import { fileURLToPath } from "node:url";
 
-const VERSION = "0.4.0";
+const VERSION = "0.4.1";
 const API_DEFAULT = "https://usehour.com/api";
 
 /* ------------------------------------------------------------------ patterns */
@@ -1017,7 +1017,36 @@ function explain(summaries) {
 }
 
 /* ------------------------------------------------------------------ the run */
-const B = (s) => `\x1b[1m${s}\x1b[0m`, DIM = (s) => `\x1b[2m${s}\x1b[0m`;
+/* Terminal look. Colour only on a real terminal, never with NO_COLOR or
+   TERM=dumb. 24-bit colour where the terminal says it has it, otherwise the
+   nearest of the 256 standard colours. No packages: plain escape codes. */
+const COLOR = !!process.stdout.isTTY && !("NO_COLOR" in process.env) && process.env.TERM !== "dumb";
+const TRUECOLOR = /truecolor|24bit/i.test(process.env.COLORTERM || "") || /iTerm|WezTerm|vscode|ghostty|Warp/i.test(process.env.TERM_PROGRAM || "");
+const E = (c) => (COLOR ? `\x1b[${c}m` : "");
+const B = (s) => E(1) + s + E(0), DIM = (s) => E(2) + s + E(0);
+const c256 = ([r, g, b]) => { const q = (v) => (v < 48 ? 0 : v < 115 ? 1 : Math.min(5, Math.round((v - 35) / 40))); return 16 + 36 * q(r) + 6 * q(g) + q(b); };
+const FG = (rgb) => E(TRUECOLOR ? `38;2;${rgb.join(";")}` : `38;5;${c256(rgb)}`), BG = (rgb) => E(TRUECOLOR ? `48;2;${rgb.join(";")}` : `48;5;${c256(rgb)}`);
+const HUE = { lav: [176, 172, 254], green: [95, 211, 141], blue: [79, 136, 255], purple: [139, 95, 217], orange: [242, 96, 31], mustard: [219, 160, 4], pink: [251, 101, 194] };
+const tint = (h, s) => FG(HUE[h]) + s + E(0);
+const GSTOP = [[0, [79, 136, 255]], [0.38, [176, 172, 254]], [0.72, [251, 101, 194]], [1, [253, 41, 128]]];
+const gcol = (t) => { t = Math.max(0, Math.min(1, t)); let i = 0; while (i < GSTOP.length - 2 && t > GSTOP[i + 1][0]) i++; const [a, x] = GSTOP[i], [b, y] = GSTOP[i + 1], f = (t - a) / (b - a); return x.map((v, k) => Math.round(v + (y[k] - v) * f)); };
+const grad = (s, bold) => (COLOR ? [...s].map((ch, i, a) => (ch === " " ? " " : FG(gcol(i / Math.max(1, a.length - 1))) + (bold ? E(1) : "") + ch)).join("") + E(0) : s);
+const KEY = (s) => (COLOR ? E(7) + " " + s + " " + E(27) : "[" + s + "]");
+/* The Hour ring as a dot matrix, like the cards: bright dots in the logo's
+   gradient on a faint grid. Plain characters, so every terminal shows it. */
+function markLines(n = 7, R = 2.8) {
+  const c0 = (n - 1) / 2, out = [];
+  for (let r = 0; r < n; r++) {
+    let l = "";
+    for (let c = 0; c < n; c++) {
+      const d = Math.hypot(c - c0, r - c0);
+      l += (Math.abs(d - R) < 0.5 ? FG(gcol((c + r) / (2 * (n - 1)))) + "●" + E(0) : d < R + 1.1 ? DIM("·") : " ") + (c < n - 1 ? " " : "");
+    }
+    out.push(l);
+  }
+  return out;
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 /* One reader for the whole run, so answers typed ahead are never lost. */
 let RL = null, LINES = [], WAIT = null;
 function ask(q) {
@@ -1031,7 +1060,7 @@ function ask(q) {
   return new Promise((res) => { WAIT = res; });
 }
 function done() { if (RL) RL.close(); }
-const yes = (a) => /^y(es)?$/i.test(a);
+const yes = (a) => !/^n(o)?$/i.test(a); // Enter means yes: running the command was the choice
 function openFile(f) {
   const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
   const args = process.platform === "win32" ? ["/c", "start", "", f] : [f];
@@ -1050,25 +1079,45 @@ async function main() {
   ].map((s) => ({ ...s, files: walk(s.dir) }));
   const found = sources.filter((s) => s.files.length);
   const share = !flag("--no-share");
-  console.log(`\n  ${B("Hour Wrapped")} ${DIM("v" + VERSION)}  Your year of building with AI.\n`);
+  if (COLOR) {
+    const mk = markLines(), mid = Math.floor(mk.length / 2);
+    console.log("");
+    mk.forEach((l, i) => console.log("  " + l + "   " + (i === mid - 1 ? `${B("Hour Wrapped")}  ${DIM("v" + VERSION)}` : i === mid ? "Your year of building with AI." : "")));
+    console.log("");
+  } else console.log(`\n  Hour Wrapped v${VERSION}  Your year of building with AI.\n`);
   if (!found.length) {
     console.log(`  No Claude Code or Codex sessions found.\n  Looked in:\n${sources.map((s) => "    " + s.dir).join("\n")}\n\n  If yours live somewhere else, run with --claude-dir or --codex-dir.\n`);
     process.exitCode = 1; return;
   }
   const bytes = found.reduce((a, s) => a + s.files.reduce((b, f) => { try { return b + fs.statSync(f).size; } catch { return b; } }, 0), 0);
-  console.log("  This reads your session logs, on this machine only:");
-  for (const s of found) console.log(`    ${s.label.padEnd(12)} ${s.files.length} files  ${DIM(s.dir)}`);
-  console.log(`\n  ${B("Private by design.")} It keeps counts and labels only. No prompt you wrote,`);
-  console.log(`  no code and no file contents leave this computer, and this script never`);
-  console.log(`  connects to the internet. (Try it with Wi-Fi off: it still works.)\n`);
+  const here = process.platform === "darwin" ? "this Mac" : "this computer";
+  const tick = (t) => "    " + tint("green", "✓") + " " + t;
+  console.log(`  ${tint("lav", "●")} ${B("Offline.")} ${tint("lav", "Nothing leaves this computer.")}`);
+  console.log(tick(`Reads your logs here, on ${here}`));
+  console.log(tick("Keeps counts and labels only. No prompts, code or files are sent"));
+  console.log(tick(`No internet needed. ${DIM("Try it with Wi-Fi off.")}`));
+  console.log(`\n  ${DIM("Found")}`);
+  const tilde = (p) => (p.startsWith(home) ? "~" + p.slice(home.length) : p);
+  const wFiles = Math.max(...found.map((s) => String(s.files.length).length));
+  for (const s of found) console.log(`    ${s.label.padEnd(13)} ${B(String(s.files.length).padStart(wFiles))} ${s.files.length === 1 ? "file " : "files"}   ${DIM(tilde(s.dir))}`);
+  console.log("");
   if (!flag("--yes")) {
     if (!process.stdin.isTTY) { console.log("  Run this in a terminal (or add --yes)."); process.exitCode = 1; return; }
-    const a = await ask(`  Read ${(bytes / 1e9).toFixed(1)} GB of logs and make your cards? [y/N] `);
+    const size = bytes >= 1e9 ? (bytes / 1e9).toFixed(1) + " GB" : Math.max(1, Math.round(bytes / 1e6)) + " MB";
+    const a = await ask(`  Read ${B(size)} of logs and make your cards?  ${COLOR ? `${KEY("Enter")} yes ${DIM("·")} ${KEY("n")} no` : "[Y/n]"}  `);
     if (!yes(a)) { console.log("\n  Stopped. Nothing was read.\n"); return; }
   }
   const jobs = found.flatMap((s) => s.files.map((file) => ({ file, src: s.src, size: fs.statSync(file).size }))).sort((a, b) => b.size - a.size);
   const summaries = []; let done = 0, doneBytes = 0; const t0 = Date.now();
-  const tick = () => { if (process.stdout.isTTY) process.stdout.write(`\r  Reading ${done}/${jobs.length} files  ${Math.round(doneBytes / Math.max(1, bytes) * 100)}%   `); };
+  const TTY = !!process.stdout.isTTY, BAR = Math.max(10, Math.min(24, (process.stdout.columns || 80) - 50)), nf = (n) => n.toLocaleString("en");
+  let found_p = 0, last = 0;
+  const bar = (p) => { const k = Math.round(p * BAR); let o = ""; for (let i = 0; i < BAR; i++) o += i < k ? (COLOR ? FG(gcol(i / (BAR - 1))) + "●" : "●") : (COLOR ? E(2) + "·" : "·"); return o + E(0); };
+  const progress = (force) => {
+    if (!TTY) return; const now = Date.now(); if (!force && now - last < 60) return; last = now;
+    const p = doneBytes / Math.max(1, bytes);
+    process.stdout.write(`\r\x1b[K  ${bar(p)}  ${B(String(Math.round(p * 100)).padStart(3) + "%")}  ${DIM(`${nf(done)}/${nf(jobs.length)} files ·`)} ${B(nf(found_p))} ${DIM("prompts")}`);
+  };
+  if (TTY) console.log(`\n  Reading your logs ${DIM("· on this computer, offline")}\n`);
   const nWorkers = Math.max(1, Math.min(4, (os.availableParallelism ? os.availableParallelism() : os.cpus().length) - 1));
   await new Promise((resolve) => {
     let next = 0, active = 0;
@@ -1077,13 +1126,13 @@ async function main() {
     const feed = (w) => {
       if (next >= jobs.length) { w.terminate(); if (--active === 0) resolve(); return; }
       const job = jobs[next++];
-      w.once("message", (r) => { if (r.ok) summaries.push(r.s); done++; doneBytes += job.size; tick(); feed(w); });
+      w.once("message", (r) => { if (r.ok) { summaries.push(r.s); if (!r.s.sub && r.s.how !== "script") found_p += r.s.prompts.length; } done++; doneBytes += job.size; progress(); feed(w); });
       w.postMessage({ file: job.file, src: job.src, examples: false });
     };
     workers.forEach((w) => { active++; feed(w); });
   });
-  if (process.stdout.isTTY) process.stdout.write("\r" + " ".repeat(60) + "\r");
-  console.log(`  Read ${jobs.length} files in ${Math.round((Date.now() - t0) / 1000)}s.`);
+  if (TTY) { doneBytes = bytes; progress(true); process.stdout.write("\n"); }
+  console.log(`  ${tint("green", "✓")} Read ${nf(jobs.length)} files in ${Math.round((Date.now() - t0) / 1000)}s. ${DIM("Nothing was sent.")}`);
   if (flag("--explain")) { explain(summaries); return; }
   const m = compute(summaries);
   if (!m) { console.log("\n  Found the logs but no prompts in them. Nothing to make cards from.\n"); return; }
@@ -1097,13 +1146,24 @@ async function main() {
   const examples = [];
   const suggest = (() => { try { const u = os.userInfo().username.toLowerCase().replace(/[^a-z0-9-]/g, "").replace(/^-+|-+$/g, "").slice(0, 24); return ["root", "admin", "user", "ubuntu", "runner", "administrator", "guest", "owner"].includes(u) ? "" : u; } catch { return ""; } })();
   fs.writeFileSync(page, pageHTML(m, C, { api: share ? (opt("--api") || API_DEFAULT).replace(/\/+$/, "") : null, examples, suggest: suggest.length >= 3 ? suggest : "" }));
-  const type = TYPES[builderType(m)].name;
-  console.log(`\n  ${B("You're " + type + ".")}  ${m.sessions.total} sessions, ${m.prompts.total.toLocaleString("en")} prompts, busiest at ${hourLabel(m.busiestHour)}.`);
-  console.log(`  Your cards: ${page}\n`);
-  if (!flag("--no-open")) openFile(page);
+  const T = TYPES[builderType(m)], sc = hourScore(m), nf2 = (n) => Number(n).toLocaleString("en");
+  const facts = [["blue", nf2(m.sessions.total), "sessions", found.length > 1 ? "in Claude Code and Codex" : "in " + found[0].label]];
+  facts.push(["purple", nf2(m.prompts.total), "prompts", `busiest at ${hourLabel(m.busiestHour)}`]);
+  if (m.parallelMax > 1 && m.parallelMax <= MAX_AT_ONCE) facts.push(["orange", String(m.parallelMax), "agents at once", m.atOnceAt ? "at " + atOnceWhen(m.atOnceAt) : ""]);
+  if (m.shipped && m.shipped.commits) facts.push(["mustard", nf2(m.shipped.commits), "commits", m.shipped.prs ? `and ${nf2(m.shipped.prs)} pull request${m.shipped.prs > 1 ? "s" : ""}, made by your agents` : "made by your agents"]);
+  const w = Math.max(...facts.map(([, n, l]) => n.length + 1 + l.length)) + 3;
+  console.log("");
+  for (const [h, n, l, d] of facts) { console.log(`   ${tint(h, "●")} ${B(n)} ${l}${" ".repeat(w - n.length - 1 - l.length)}${DIM(d)}`); if (TTY) await sleep(140); }
+  console.log(`\n  You're ${grad(T.name + ".", true)}`);
+  const first = String(T.line || "").split(/(?<=\.)\s/)[0];
+  console.log(`  ${DIM(first + (sc ? " Hour score" : ""))}${sc ? " " + B(String(sc.total)) + DIM(".") : ""}`);
+  const open = !flag("--no-open");
+  console.log(`\n  ${B((open ? "→ Opening your " : "Your ") + C.length + " cards" + (open ? " in the browser" : " are ready"))}`);
+  console.log(`    ${DIM(page.startsWith(home) ? "~" + page.slice(home.length) : page)}\n`);
+  if (open) openFile(page);
   if (share) {
-    console.log(`  Want a profile? The last card lets you claim your handle at usehour.com/@you.`);
-    console.log(`  Nothing is sent unless you press the buttons there. You see exactly what goes first.`);
+    console.log(`  ${DIM("Want a profile? The last card lets you claim")} usehour.com/@you${DIM(".")}`);
+    console.log(`  ${DIM("Nothing is sent unless you press the buttons there. You see exactly what goes first.")}`);
     if (examples.length) console.log(DIM(`  (The cards page holds ${examples.length} of your prompts so you can choose. It stays on this computer.)`));
     console.log("");
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "usehour",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Your year of building with AI, as Wrapped-style cards, and an optional private profile. Reads your Claude Code and Codex logs locally.",
   "type": "module",
   "bin": { "usehour": "hour.mjs" },