vibestreak 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# Changelog
+
+Any version runs with `npx vibestreak@<version>`; `npx vibestreak@latest autosync on`
+moves the background sync to the newest one.
+
+## 0.3.2 (2026-10-25)
+
+- Linking says up front that your profile is public (and how to hide it), and
+  that linking means agreeing to the Terms and Privacy policy.
+- If the server ever stops accepting this version, the background sync shows
+  a notification (once a day) with the command that updates it, instead of
+  failing quietly while your streak runs out.
+
+## 0.3.1 (2026-10-25)
+
+- `vibestreak --version` (or `-v`), and the version in `help` and `status`.
+- Says when a newer version is out: after `vibestreak`, `sync` and in `status`.
+- Sends its version with each sync. Settings shows each machine's version, and
+  the server can turn away versions too old to count correctly, with the
+  command that updates them.
+
+## 0.3.0 (2026-10-25)
+
+- First run: plain `npx vibestreak` signs in through the browser (no token to
+  copy), syncs, and offers background sync and the evening nudge.
+- `vibestreak setup [--token <t>]`: all of that with the defaults and no
+  questions; commit addresses come from git config.
+- `vibestreak login` signs in through the browser; `--token` still works.
+- `vibestreak pause [1h|3d|tomorrow]` and `resume`: the background syncs and
+  nudge skip their runs for up to 7 days, and nothing is lost.
+
+## 0.2.0 (2026-10-25)
+
+- `vibestreak` shows a dashboard: streak, level, a 12-week heatmap and your rank.
+- `vibestreak me`, `profile <handle>`, `board`, `today` in the terminal.
+- Syncs after the first one send only the last 7 days: about 3 seconds.
+
+## 0.1.2 (2026-10-25)
+
+- `vibestreak nudge at <time>`: when the evening streak check runs (17:00 to
+  23:30; 20:30 by default).
+
+## 0.1.1 (2026-10-25)
+
+- `vibestreak status`; plain `vibestreak nudge` shows the nudge's status.
+- The evening job runs `nudge run` (older schedules keep working).
+
+## 0.1.0 (2026-10-25)
+
+- First release: reads Claude Code, Codex, Cursor, Copilot (CLI and VS Code),
+  Gemini CLI, Antigravity and OpenCode history and git; syncs daily totals.
+- Background sync on macOS (launchd), Linux (systemd or cron) and Windows
+  (Task Scheduler), with the evening streak nudge.

package/bin/vibestreak.mjs

@@ -10,12 +10,13 @@ import { CONFIG_PATH, loadConfig, saveConfig } from '../src/config.mjs'
 import { configuredEmails, DEFAULT_ROOTS, globalEmail, scanEmails } from '../src/git.mjs'
 import { deviceLogin } from '../src/login.mjs'
 import { parsePause, pausedUntil, untilText } from '../src/pause.mjs'
+import { updateCommand, updateNotice, VERSION } from '../src/version.mjs'
 import { boardView, dashboardView, profileView, todayView } from '../src/views.mjs'
 
 const BRAND = process.env.VIBESTREAK_BRAND ?? 'vibestreak'
 const DEFAULT_SERVER = process.env.VIBESTREAK_SERVER ?? 'https://vibestreak.kingsbridge-consultancy.com'
 
-const HELP = `${BRAND} — share your AI coding heatmap: what you shipped, and how steadily.
+const HELP = `${BRAND} ${VERSION} — share your AI coding heatmap: what you shipped, and how steadily.
 
   ${BRAND}                           your streak, heatmap and rank at a glance
                                      (the first time: sets this machine up)
@@ -44,6 +45,7 @@ const HELP = `${BRAND} — share your AI coding heatmap: what you shipped, and h
                                      days; default until tomorrow 06:00)
   ${BRAND} resume                    end a pause now
   ${BRAND} whoami                    the profile this machine syncs to
+  ${BRAND} --version                 this CLI's version
 
 Reads: Claude Code, Codex, Cursor, Copilot (CLI and VS Code), Gemini CLI,
 Antigravity and OpenCode history, and git.
@@ -59,10 +61,10 @@ async function api(config, path, init = {}) {
   if (!config.server || !config.token) throw new Error(`Not linked yet: run \`${BRAND} login\`.`)
   const response = await fetch(new URL(path, config.server), {
     ...init,
-    headers: { authorization: `Bearer ${config.token}`, 'content-type': 'application/json', ...init.headers },
+    headers: { authorization: `Bearer ${config.token}`, 'content-type': 'application/json', 'x-vibestreak-cli': VERSION, 'user-agent': `${BRAND}/${VERSION}`, ...init.headers },
   })
   const body = await response.json().catch(() => ({}))
-  if (!response.ok) throw new Error(body.error ?? `${response.status} ${response.statusText}`)
+  if (!response.ok) throw Object.assign(new Error(body.error ?? `${response.status} ${response.statusText}`), { status: response.status })
   return body
 }
 
@@ -83,6 +85,7 @@ async function main() {
       // Set by the background jobs, so a pause skips them and nothing else.
       scheduled: { type: 'boolean' },
       yes: { type: 'boolean', short: 'y' },
+      version: { type: 'boolean', short: 'v' },
     },
   })
   const [command = 'dashboard', ...rest] = positionals
@@ -90,6 +93,7 @@ async function main() {
   const log = (...args) => values.quiet || console.log(...args)
 
   if (command === 'help' || values.help) return console.log(HELP)
+  if (command === 'version' || values.version) return console.log(VERSION)
   const columns = process.stdout.columns || 100
   const server = config.server ?? DEFAULT_SERVER
 
@@ -101,7 +105,8 @@ async function main() {
       return setup(config, values, { ask: !values.yes })
     }
     const me = await api(config, '/api/v1/me')
-    return dashboardView({ server, token: config.token, handle: me.handle, columns })
+    await dashboardView({ server, token: config.token, handle: me.handle, columns })
+    return notice(config, me.cli)
   }
   if (command === 'me') {
     const me = await api(config, '/api/v1/me')
@@ -175,7 +180,7 @@ async function main() {
   if (command === 'collect' || command === 'sync') {
     const until = values.scheduled && pausedUntil(config)
     if (until) return console.log(`${new Date().toISOString()} paused until ${until.toISOString()}; skipped`)
-    return sync(config, values, log, command === 'sync')
+    return sync(config, values, log, command === 'sync').catch(error => (values.scheduled ? tooOldNotice(config, error) : Promise.reject(error)))
   }
 
   if (command === 'status') return status(config)
@@ -208,7 +213,7 @@ async function main() {
     // `nudge run`, the evening job: sync, then nudge if the streak would end at midnight.
     const until = pausedUntil(config)
     if (until) return console.log(`${new Date().toISOString()} paused until ${until.toISOString()}; skipped`)
-    const result = await sync(config, values, log, true)
+    const result = await sync(config, values, log, true).catch(error => tooOldNotice(config, error))
     if (shouldNudge(result.streak, config)) {
       await notify(nudgeText(result.streak))
       config.lastNudge = result.streak.today
@@ -242,6 +247,9 @@ async function main() {
 // settings page (for machines without one).
 async function login(config, values, { addresses = true } = {}) {
   config.server = values.server ?? config.server ?? DEFAULT_SERVER
+  const site = config.server.replace(/\/$/, '')
+  console.log(`Your profile (GitHub username, avatar, heatmap, streak) will be public on ${BRAND} and its leaderboard; you can hide it in Settings.`)
+  console.log(`Linking means you agree to the Terms (${site}/terms) and Privacy policy (${site}/privacy).\n`)
   if (values.token) config.token = values.token
   else config.token = (await deviceLogin({ server: config.server, machine: config.machineName })).token
   const me = await api(config, '/api/v1/me')
@@ -323,9 +331,28 @@ async function sync(config, values, log, isSync) {
   // Always one line, quiet or not: the background sync's log is how a person sees it ran.
   const streak = result.streak ? ` · streak ${result.streak.current}d${result.streak.activeToday ? '' : ' (not yet today)'}` : ''
   console.log(`${config.lastSync} uploaded ${result.days} days, ${result.commits} commits from ${s.repos} repos${streak} → ${result.profileUrl}`)
+  if (!values.quiet) notice(config, result.cli)
   return result
 }
 
+// A background run the server turned away as too old: nobody reads the log,
+// and the streak would end unnoticed, so say so on screen, once a day.
+async function tooOldNotice(config, error) {
+  const today = new Date().toISOString().slice(0, 10)
+  if (error.status === 426 && config.lastUpdateNotice !== today) {
+    await notify({ title: 'Update to keep your streak', message: `This version can no longer sync. Run: npx ${BRAND}@latest autosync on` })
+    config.lastUpdateNotice = today
+    await saveConfig(config)
+  }
+  throw error
+}
+
+// Says so when a newer CLI is out (the server checks npm).
+function notice(config, cli) {
+  const line = updateNotice(cli, { brand: BRAND, autosync: config.autosync })
+  if (line) console.log(`\n${line}`)
+}
+
 const ago = iso => {
   if (!iso) return 'never'
   const minutes = Math.round((Date.now() - Date.parse(iso)) / 60000)
@@ -382,6 +409,8 @@ async function status(config) {
   row('Nudge', nudgeOn ? `on · checks at ${clock(nudgeTimeOf(config))} · last nudged ${config.lastNudge ?? 'never'}` : config.nudge === false ? 'off' : 'off (needs autosync)')
   const github = me.error ? 0 : (me.emails?.length ?? 0)
   row('Addresses', `${config.emails.join(', ') || 'none'}${github ? ` · +${github} from GitHub` : ''}`)
+  const update = me.error ? undefined : updateNotice(me.cli, { brand: BRAND, autosync: config.autosync })
+  row('Version', update ? `${VERSION} · ${me.cli.latest} is out: ${updateCommand(BRAND, config.autosync)}` : `${VERSION}${me.cli?.latest ? ' (latest)' : ''}`)
   row('Config', CONFIG_PATH)
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibestreak",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Your AI coding streak: a heatmap of the days you coded with Claude Code, Codex, Cursor, Copilot, Gemini and OpenCode, and the commits you shipped with them. Sends daily totals only.",
   "keywords": ["claude-code", "codex", "cursor", "copilot", "gemini", "opencode", "ai-coding", "heatmap", "streak", "leaderboard", "cli"],
   "homepage": "https://vibestreak.kingsbridge-consultancy.com/cli",
@@ -8,7 +8,7 @@
   "author": "Kingsbridge Consultancy LLC <support@kingsbridge-consultancy.com>",
   "type": "module",
   "bin": { "vibestreak": "bin/vibestreak.mjs" },
-  "files": ["bin", "src", "README.md", "LICENSE"],
+  "files": ["bin", "src", "README.md", "CHANGELOG.md", "LICENSE"],
   "engines": { "node": ">=22.13" },
   "os": ["darwin", "linux", "win32"],
   "scripts": { "test": "node --test test/*.test.mjs" }

package/src/version.mjs

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs'
+
+export const VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version
+
+// Release versions only (x.y.z): negative when a is older than b.
+export function compareVersions(a, b) {
+  const pa = String(a).split('.').map(Number)
+  const pb = String(b).split('.').map(Number)
+  for (let i = 0; i < 3; i++) if ((pa[i] || 0) !== (pb[i] || 0)) return (pa[i] || 0) - (pb[i] || 0)
+  return 0
+}
+
+// One line when the server says a newer CLI is out; nothing otherwise. With
+// autosync on, the update command also moves the background jobs to it.
+export function updateNotice(cli, { brand = 'vibestreak', autosync = false, current = VERSION } = {}) {
+  if (!cli?.latest || compareVersions(current, cli.latest) >= 0) return undefined
+  return `${brand} ${cli.latest} is out (this is ${current}): ${updateCommand(brand, autosync)}.`
+}
+
+export const updateCommand = (brand, autosync) =>
+  autosync ? `\`npx ${brand}@latest autosync on\` updates the background sync to it` : `\`npx ${brand}@latest\` runs it`