vibestreak 0.1.0 → 0.1.1

package/bin/vibestreak.mjs

@@ -2,8 +2,8 @@
 import { fileURLToPath } from 'node:url'
 import { parseArgs } from 'node:util'
 
-import { installAutosync, removeAutosync } from '../src/autosync.mjs'
-import { notify, nudgeText, shouldNudge } from '../src/nudge.mjs'
+import { autosyncStatus, clock, installAutosync, NUDGE_TIME, nextRun, removeAutosync, SYNC_TIMES } from '../src/autosync.mjs'
+import { notify, nudgeAction, nudgeText, shouldNudge } from '../src/nudge.mjs'
 import { collect, sinceDate, summarize } from '../src/collect.mjs'
 import { CONFIG_PATH, loadConfig, saveConfig } from '../src/config.mjs'
 import { DEFAULT_ROOTS, globalEmail, scanEmails } from '../src/git.mjs'
@@ -21,9 +21,10 @@ const HELP = `${BRAND} — share your AI coding heatmap: what you shipped, and h
                                      the addresses you commit as (all of your accounts)
   ${BRAND} roots [add <dir>|remove <dir>]
                                      where to look for git repos
+  ${BRAND} status                    profile, last sync, streak, autosync and nudge
   ${BRAND} autosync [on|off]         sync in the background through the day
   ${BRAND} nudge [on|off|test]       an evening notification when your streak is
-                                     about to end (on with autosync)
+                                     about to end (on with autosync); alone, its status
   ${BRAND} whoami                    the profile this machine syncs to
 
 Reads: Claude Code, Codex, Cursor, Copilot (CLI and VS Code), Gemini CLI,
@@ -116,20 +117,24 @@ async function main() {
 
   if (command === 'collect' || command === 'sync') return sync(config, values, log, command === 'sync')
 
+  if (command === 'status') return status(config)
+
   if (command === 'nudge') {
     const bin = fileURLToPath(import.meta.url)
-    if (rest[0] === 'on' || rest[0] === 'off') {
-      config.nudge = rest[0] === 'on'
+    const action = nudgeAction(rest, values)
+    if (action === 'status') return nudgeStatus(config)
+    if (action === 'on' || action === 'off') {
+      config.nudge = action === 'on'
       await saveConfig(config)
       if (config.autosync) await installAutosync(bin, { nudge: config.nudge })
       return console.log(`Streak nudge ${config.nudge ? 'on: 20:30 each evening when your streak is at risk' : 'off'}.`)
     }
-    if (rest[0] === 'test') {
+    if (action === 'test') {
       const { streak } = await api(config, '/api/v1/me')
       await notify(nudgeText({ ...streak, current: Math.max(1, streak.current) }))
       return console.log(`Sent a test notification (your streak: ${streak.current} days; ${streak.activeToday ? 'active today' : 'not active yet today'}).`)
     }
-    // The evening run: sync, then nudge if the streak would end at midnight.
+    // `nudge run`, the evening job: sync, then nudge if the streak would end at midnight.
     const result = await sync(config, values, log, true)
     if (shouldNudge(result.streak, config)) {
       await notify(nudgeText(result.streak))
@@ -181,6 +186,7 @@ async function sync(config, values, log, isSync) {
   if (!isSync) return log(`\nNothing was sent. \`${BRAND} sync\` uploads these totals.`)
   const result = await api(config, '/api/v1/upload', { method: 'POST', body: JSON.stringify(payload) })
   config.lastSync = new Date().toISOString()
+  config.lastSyncSummary = { days: result.days, commits: result.commits, repos: s.repos }
   await saveConfig(config)
   // 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)'}` : ''
@@ -188,6 +194,60 @@ async function sync(config, values, log, isSync) {
   return result
 }
 
+const ago = iso => {
+  if (!iso) return 'never'
+  const minutes = Math.round((Date.now() - Date.parse(iso)) / 60000)
+  return minutes < 1 ? 'just now' : minutes < 60 ? `${minutes} min ago` : minutes < 48 * 60 ? `${Math.round(minutes / 60)} h ago` : `${Math.round(minutes / 1440)} days ago`
+}
+const at = ({ at, day }) => `${day} ${clock([at.getHours(), at.getMinutes()])}`
+
+// The server's view of the streak, or why it can't be had (not linked, offline).
+async function serverStatus(config) {
+  if (!config.server || !config.token) return { error: `not linked: run \`${BRAND} login --token PASTE_YOUR_TOKEN\`` }
+  try {
+    return await api(config, '/api/v1/me')
+  } catch (error) {
+    return { error: error.message }
+  }
+}
+
+function streakLine(streak) {
+  if (!streak) return 'unknown'
+  const today = streak.activeToday ? 'active today' : streak.current > 0 ? 'not yet today: ends at midnight' : 'no live streak'
+  const next = streak.next ? ` · ${streak.next.remaining} ${streak.next.remaining === 1 ? 'day' : 'days'} to ${streak.next.name}` : ''
+  return `${streak.current} ${streak.current === 1 ? 'day' : 'days'} · ${today}${next}`
+}
+
+async function nudgeStatus(config) {
+  const [scheduled, me] = await Promise.all([autosyncStatus(), serverStatus(config)])
+  const on = config.nudge !== false && scheduled.nudge
+  const why = config.nudge === false ? ` (\`${BRAND} nudge on\` turns it on)` : !scheduled.on ? ` (needs autosync: \`${BRAND} autosync on\`)` : ''
+  console.log(`Nudge       ${on ? `on · checks at ${clock(NUDGE_TIME)}` : `off${why}`}`)
+  console.log(`Last nudge  ${config.lastNudge ?? 'never'}`)
+  if (me.error) return console.log(`Tonight     unknown (${me.error})`)
+  const s = me.streak
+  const tonight = !on ? 'no check' : s.activeToday ? 'no nudge: you were active today' : s.current > 0 ? (config.lastNudge === s.today ? 'already nudged today' : `will nudge at ${clock(NUDGE_TIME)} unless you code with AI first`) : 'no nudge: no live streak'
+  console.log(`Streak      ${streakLine(s)}`)
+  console.log(`Tonight     ${tonight}`)
+}
+
+async function status(config) {
+  const [scheduled, me] = await Promise.all([autosyncStatus(), serverStatus(config)])
+  const row = (label, value) => console.log(`${label.padEnd(11)} ${value}`)
+  row('Profile', me.error ? me.error : `@${me.handle} · ${me.profileUrl}`)
+  if (!me.error && me.github?.length) row('GitHub', me.github.map(g => `github.com/${g}`).join(', '))
+  row('Machine', config.machineName)
+  const last = config.lastSyncSummary
+  row('Last sync', config.lastSync ? `${ago(config.lastSync)}${last ? ` · ${last.days} days, ${last.commits} commits from ${last.repos} repos` : ''}` : `never: run \`${BRAND} sync\``)
+  if (!me.error) row('Streak', streakLine(me.streak))
+  row('Autosync', scheduled.on ? `on (${scheduled.using}) · next sync ${at(nextRun(SYNC_TIMES))}` : `off: \`${BRAND} autosync on\` syncs at ${SYNC_TIMES.map(clock).join(', ')}`)
+  const nudgeOn = config.nudge !== false && scheduled.nudge
+  row('Nudge', nudgeOn ? `on · checks at ${clock(NUDGE_TIME)} · 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` : ''}`)
+  row('Config', CONFIG_PATH)
+}
+
 main().catch(error => {
   console.error(`${BRAND}: ${error.message}`)
   process.exitCode = 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibestreak",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",

package/src/autosync.mjs

@@ -1,4 +1,5 @@
 import { execFile } from 'node:child_process'
+import { existsSync } from 'node:fs'
 import { cp, mkdir, rm, writeFile } from 'node:fs/promises'
 import { homedir, platform } from 'node:os'
 import { dirname, join } from 'node:path'
@@ -24,7 +25,7 @@ const logPath = () => join(configDir(), 'sync.log')
 // The jobs to schedule: a sync at each sync time, and the evening nudge.
 export const jobs = nudge => [
   { name: 'sync', args: ['sync', '--quiet'], times: SYNC_TIMES },
-  ...(nudge ? [{ name: 'nudge', args: ['nudge', '--quiet'], times: [NUDGE_TIME] }] : []),
+  ...(nudge ? [{ name: 'nudge', args: ['nudge', 'run', '--quiet'], times: [NUDGE_TIME] }] : []),
 ]
 
 // A CLI run through npx lives in npm's cache, which can be cleared; a
@@ -78,6 +79,10 @@ const launchd = {
     }
     return 'launchd'
   },
+  async status() {
+    const has = name => existsSync(join(agents(), `${LAUNCHD[name]}.plist`))
+    return { on: has('sync'), using: 'launchd', nudge: has('nudge') }
+  },
   async remove() {
     for (const label of Object.values(LAUNCHD)) {
       const plist = join(agents(), `${label}.plist`)
@@ -170,6 +175,14 @@ const linux = {
     await writeCrontab(cronBlock(node, bin, nudge, logPath()))
     return 'crontab'
   },
+  async status() {
+    if (existsSync(join(units(), 'vibestreak-sync.timer'))) {
+      return { on: true, using: 'systemd', nudge: existsSync(join(units(), 'vibestreak-nudge.timer')) }
+    }
+    const cron = await run('crontab', ['-l']).then(r => r.stdout, () => '')
+    const block = cron.match(new RegExp(`${CRON_BEGIN}[\\s\\S]*?${CRON_END}`))?.[0] ?? ''
+    return { on: /\bsync\b/.test(block), using: 'crontab', nudge: /\bnudge\b/.test(block) }
+  },
   async remove() {
     for (const name of ['vibestreak-sync', 'vibestreak-nudge']) {
       await run('systemctl', ['--user', 'disable', '--now', `${name}.timer`]).catch(() => {})
@@ -204,6 +217,11 @@ const windows = {
     }
     return 'Task Scheduler'
   },
+  async status() {
+    const has = name => run('schtasks', ['/Query', '/TN', name]).then(() => true, () => false)
+    const [syncJob, nudgeJob] = jobs(true)
+    return { on: await has(windowsTaskName(syncJob, syncJob.times[0])), using: 'Task Scheduler', nudge: await has(windowsTaskName(nudgeJob, NUDGE_TIME)) }
+  },
   async remove() {
     for (const name of ALL_WINDOWS_TASKS) await run('schtasks', ['/Delete', '/F', '/TN', name]).catch(() => {})
   },
@@ -225,6 +243,21 @@ export async function installAutosync(bin, { nudge = true } = {}) {
   return { installed: true, using, times, nudgeAt, log: logPath() }
 }
 
+// What the system's scheduler holds now: whether the syncs and the nudge are scheduled.
+export async function autosyncStatus() {
+  const scheduler = SCHEDULERS[platform()]
+  return scheduler ? scheduler.status() : { on: false, using: undefined, nudge: false }
+}
+
+// The next of the given daily times after `now`: today if one is still ahead, else tomorrow's first.
+export function nextRun(times, now = new Date()) {
+  const today = times.map(([h, m]) => new Date(now.getFullYear(), now.getMonth(), now.getDate(), h, m)).sort((a, b) => a - b)
+  const later = today.find(t => t > now)
+  if (later) return { at: later, day: 'today' }
+  const [first] = today
+  return { at: new Date(first.getFullYear(), first.getMonth(), first.getDate() + 1, first.getHours(), first.getMinutes()), day: 'tomorrow' }
+}
+
 export async function removeAutosync() {
   await SCHEDULERS[platform()]?.remove()
   return { removed: true }

package/src/nudge.mjs

@@ -11,6 +11,14 @@ export function shouldNudge(streak, config) {
   return streak.atRisk === true && streak.current > 0 && config.lastNudge !== streak.today
 }
 
+// What `nudge` was asked to do. Alone it shows the nudge's status; with
+// --quiet and nothing else it is the scheduled check as 0.1.0 installed it
+// (`nudge --quiet`), so those jobs keep working until autosync is rerun.
+export function nudgeAction(rest, values) {
+  if (['on', 'off', 'test', 'run'].includes(rest[0])) return rest[0]
+  return values.quiet ? 'run' : 'status'
+}
+
 export function nudgeText(streak) {
   const days = streak.current === 1 ? '1-day streak' : `${streak.current}-day streak`
   const next = streak.next && streak.current + 1 >= streak.next.days ? ` Today makes it ${streak.next.name}.` : ''