@nectarcrm/ccx 0.4.2 → 0.5.0

package/README.md

@@ -17,9 +17,10 @@ ccx login                           # autoriza este computador (abre o navegador
 ccx                                 # mostra suas contas e troca a conta deste computador
 ccx claude-infra                    # troca direto
 ccx status                          # conta atual e uso de cada conta
+ccx list                            # contas que dá pra usar agora, uma por linha (--json: detalhes)
 ccx doctor                          # confere se o claude está mesmo usando a conta escolhida (e o que pode atrapalhar)
-ccx sync                            # manda pro app o resumo das sessões (roda sozinho após o login e a cada 5 min)
-ccx sair                            # o claude volta ao seu login normal
+ccx sync                            # manda pro app o resumo das sessões (sozinho às 12h00 e 17h30; assim, na hora)
+ccx off                             # o claude volta ao seu login normal
 ccx logout                          # sai do app neste computador
 ```
 

package/bin/ccx.js

@@ -6,9 +6,11 @@
 //   ccx                      mostra suas contas e troca a conta deste computador
 //   ccx <conta>              troca direto (nome curto, ex.: claude-infra)
 //   ccx status               conta atual e uso das contas liberadas pra você
+//   ccx list                 nomes curtos das contas que dá pra usar agora, a mais folgada primeiro
+//                            (--json: todas, com uso, reset, a atual e a recomendada)
 //   ccx doctor               confere se o claude está mesmo usando a conta escolhida
 //   ccx sync                 manda pro app o resumo das sessões do Claude (totais por projeto e dia; nunca o texto)
-//   ccx sair                 tira a conta deste computador (o claude volta ao login normal)
+//   ccx off                  tira a conta deste computador (o claude volta ao login normal)
 //   ccx logout               sai do app: tira a conta, a autorização e o vigia
 //   ccx --version            versão instalada (atualizar: npm install -g @nectarcrm/ccx@latest)
 //
@@ -16,7 +18,8 @@
 // (terminal, VS Code, JetBrains) usa essa conta. Claudes já abertos continuam na anterior.
 // O vigia roda sozinho a cada 5 min: avisa o app, atualiza o token se o admin trocou
 // e tira a conta se o acesso for removido. Os tokens gastos vão pro app pela telemetria.
-// O resumo dos projetos só vai pro app quando você roda ccx sync.
+// O resumo dos projetos vai sozinho depois das 12h00 e das 17h30; ccx sync manda na hora.
+// Uma vez por dia o vigia confere se há ccx novo no npm e se atualiza.
 
 import { execFileSync } from 'node:child_process'
 import { appendFileSync, chmodSync, closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, readSync, rmSync, statSync, writeFileSync } from 'node:fs'
@@ -159,7 +162,7 @@ const run = (cmd, args, input) => execFileSync(cmd, args, { input, stdio: [input
 const crontabWithout = () => { try { return run('crontab', ['-l']).split('\n').filter(l => l && !l.includes(CRON_TAG)) } catch { return [] } }
 
 function installLinuxAgent() {
-  const cmdLine = `"${process.execPath}" "${SELF}" vigia`
+  const cmdLine = `"${process.execPath}" "${SELF}" watch`
   try {
     run('systemctl', ['--user', 'show-environment']) // tem systemd do usuário?
     mkdirSync(UNIT_DIR, { recursive: true })
@@ -198,7 +201,7 @@ function installAgent() {
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0"><dict>
   <key>Label</key><string>${AGENT_ID}</string>
-  <key>ProgramArguments</key><array><string>${process.execPath}</string><string>${SELF}</string><string>vigia</string></array>
+  <key>ProgramArguments</key><array><string>${process.execPath}</string><string>${SELF}</string><string>watch</string></array>
   <key>StartInterval</key><integer>${AGENT_MINUTES * 60}</integer>
   <key>RunAtLoad</key><true/>
   <key>StandardErrorPath</key><string>${LOG}</string>
@@ -213,7 +216,7 @@ function installAgent() {
     if (WIN) {
       // node.exe é app de console: direto pelo Agendador abre uma janela a cada rodada. O conhost --headless roda sem janela.
       execFileSync('schtasks', ['/Create', '/F', '/SC', 'MINUTE', '/MO', String(AGENT_MINUTES), '/TN', AGENT_ID,
-        '/TR', `conhost.exe --headless "${process.execPath}" "${SELF}" vigia`], { stdio: 'ignore' })
+        '/TR', `conhost.exe --headless "${process.execPath}" "${SELF}" watch`], { stdio: 'ignore' })
       return true
     }
     return installLinuxAgent()
@@ -388,9 +391,9 @@ function takeLock() {
   }
 }
 
-async function sync(app, key) {
-  const say = msg => process.stderr.write(msg)
-  if (!takeLock()) return say('Outro sync já está rodando. Tente de novo daqui a pouco.\n')
+async function sync(app, key, quiet = false) {
+  const say = msg => { if (!quiet) process.stderr.write(msg) }
+  if (!takeLock()) { say('Outro sync já está rodando. Tente de novo daqui a pouco.\n'); return null }
   try {
     let state = readJson(SYNC_STATE, {})
     if (state.v !== SYNC_VERSION) state = {}
@@ -450,6 +453,81 @@ async function sync(app, key) {
   finally { rmSync(SYNC_LOCK, { force: true }) }
 }
 
+// Sync automático: o watch roda a cada 5 min e manda o resumo depois das 12h00 e das 17h30 (hora do computador).
+// Computador desligado no horário: manda na primeira rodada depois que ligar. Falhou: tenta de novo na próxima.
+const SYNC_SLOTS = [[12, 0], [17, 30]]
+const SYNC_AUTO = join(DIR, 'sync-auto.json')
+function lastSyncSlot(now = new Date()) {
+  const slots = [-1, 0].flatMap(d => SYNC_SLOTS.map(([h, m]) => new Date(now.getFullYear(), now.getMonth(), now.getDate() + d, h, m)))
+  return slots.filter(t => t <= now).at(-1)
+}
+async function autoSync() {
+  const app = readJson(APP, null)
+  const key = app && secretGet()
+  if (!app || !key) return
+  const last = readJson(SYNC_AUTO, {}).at
+  if (last && new Date(last) >= lastSyncSlot()) return
+  const log = msg => appendFileSync(LOG, `${new Date().toISOString()} ${msg}\n`)
+  try {
+    const sent = await sync(app, key, true)
+    if (sent === null) return // outro sync rodando: tenta na próxima
+    writeJson(SYNC_AUTO, { at: new Date().toISOString() })
+    log(`sync automático: ${sent} ${sent === 1 ? 'resumo' : 'resumos'}`)
+  }
+  catch (e) { log(`sync automático falhou: ${e.message}`) }
+}
+
+// ---------- atualização automática ----------
+// Uma vez por dia o watch confere a versão no npm e, se houver nova, instala no mesmo lugar onde o ccx está.
+// Não conseguiu (npm pede sudo, sem npm): o ccx avisa no terminal até alguém atualizar.
+const UPDATE = join(DIR, 'update.json')
+const PKG = '@nectarcrm/ccx'
+const myVersion = () => readJson(join(dirname(SELF), '..', 'package.json'), {}).version ?? '0'
+const newer = (a, b) => { // a é mais nova que b?
+  const pa = a.split('.').map(Number), pb = 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 false
+}
+// Pasta do npm onde o ccx foi instalado (-g): <prefixo>/lib/node_modules/@nectarcrm/ccx (Windows: sem o lib)
+function globalPrefix() {
+  const pkgDir = dirname(dirname(SELF))
+  const mods = dirname(dirname(pkgDir))
+  if (basename(dirname(pkgDir)) !== '@nectarcrm' || basename(mods) !== 'node_modules') return null // rodando de fora do npm -g
+  return WIN ? dirname(mods) : dirname(dirname(mods))
+}
+async function autoUpdate() {
+  const state = readJson(UPDATE, {})
+  if (state.checked_at && Date.now() - Date.parse(state.checked_at) < 86_400_000) return
+  const log = msg => appendFileSync(LOG, `${new Date().toISOString()} ${msg}\n`)
+  const mine = myVersion()
+  let latest
+  try {
+    const r = await fetch(`https://registry.npmjs.org/${PKG.replace('/', '%2f')}/latest`, { signal: AbortSignal.timeout(10_000) })
+    latest = (await r.json()).version
+  }
+  catch { return } // sem internet: tenta na próxima rodada
+  const save = extra => writeJson(UPDATE, { checked_at: new Date().toISOString(), latest, ...extra })
+  if (!latest || !newer(latest, mine)) return save({})
+  const prefix = globalPrefix()
+  if (!prefix) return save({ error: 'ccx não foi instalado com npm install -g' })
+  try {
+    const npm = join(dirname(process.execPath), WIN ? 'npm.cmd' : 'npm')
+    execFileSync(existsSync(npm) ? npm : 'npm', ['install', '-g', '--prefix', prefix, `${PKG}@${latest}`], { stdio: 'ignore', timeout: 180_000, shell: WIN })
+    log(`ccx atualizado: ${mine} → ${latest}`)
+    save({})
+  }
+  catch (e) {
+    const msg = e.message.split('\n')[0]
+    log(`não consegui atualizar o ccx pra ${latest}: ${msg}`)
+    save({ error: msg })
+  }
+}
+// No terminal: avisa quando a atualização automática não deu conta
+function updateNotice() {
+  const { latest } = readJson(UPDATE, {})
+  if (latest && newer(latest, myVersion())) console.error(c(33, `Tem ccx novo (${latest}). Atualize: npm install -g ${PKG}@latest`))
+}
+
 // ---------- doctor: confere se o claude está mesmo usando a conta escolhida ----------
 // Nunca mostra token: compara só a impressão digital (fingerprint).
 const AUTH_VARS = ['ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'CLAUDE_CODE_USE_BEDROCK', 'CLAUDE_CODE_USE_VERTEX']
@@ -677,14 +755,19 @@ async function useAccount(app, key, wanted) {
   if (process.env.ANTHROPIC_API_KEY) console.error(c(33, 'Aviso: ANTHROPIC_API_KEY está definida e tem prioridade sobre a conta escolhida.'))
   console.error(`\n${c(32, '✓')} Este computador agora usa a conta ${c(1, s.data.account.label)}.`)
   console.error('  Todo claude aberto a partir de agora usa essa conta. Os que já estão abertos continuam na anterior.')
-  if (!agent) console.error(c(33, '  Vigia automático indisponível neste sistema: rode "ccx vigia" de vez em quando.'))
+  if (!agent) console.error(c(33, '  Vigia automático indisponível neste sistema: rode "ccx watch" de vez em quando.'))
 }
 
 // ---------- comandos ----------
 const [cmd, ...rest] = process.argv.slice(2)
 
+// Nomes antigos em português: ainda funcionam, mas avisam (só no terminal; o agendamento chama vigia sem ninguém ver)
+const DEPRECATED = { sair: 'off', vigia: 'watch' }
+if (DEPRECATED[cmd] && isTTY) console.error(c(33, `Aviso: "ccx ${cmd}" vai deixar de existir. Use "ccx ${DEPRECATED[cmd]}".`))
+if (isTTY && cmd !== 'watch' && cmd !== 'vigia') updateNotice()
+
 if (cmd === 'help' || cmd === '-h' || cmd === '--help') {
-  console.log(readFileSync(SELF, 'utf8').split('\n').filter(l => l.startsWith('//')).slice(0, 18).map(l => l.slice(3)).join('\n'))
+  console.log(readFileSync(SELF, 'utf8').split('\n').filter(l => l.startsWith('//')).slice(0, 21).map(l => l.slice(3)).join('\n'))
   process.exit(0)
 }
 
@@ -693,8 +776,10 @@ if (cmd === '--version' || cmd === '-v' || cmd === 'version') {
   process.exit(0)
 }
 
-if (cmd === 'vigia') {
+if (cmd === 'watch' || cmd === 'vigia') { // vigia: os agendamentos já instalados ainda chamam assim
   await agentOnce()
+  await autoSync()
+  await autoUpdate()
   process.exit(0)
 }
 
@@ -715,7 +800,7 @@ if (cmd === 'logout') {
   process.exit(0)
 }
 
-if (cmd === 'sair') {
+if (cmd === 'off' || cmd === 'sair') {
   writeJson(APP, removeAccount(app))
   console.error('Pronto: este computador não usa mais conta do app. O claude volta ao seu login normal. Pra escolher de novo: ccx')
   process.exit(0)
@@ -737,5 +822,26 @@ if (cmd === 'status') {
   process.exit(0)
 }
 
+// Pra scripts e agentes: uma conta por linha, pronta pra `ccx <conta>`
+if (cmd === 'list') {
+  const r = await api(app, key, 'GET', '/api/cli/status?fresh=1')
+  if (r.status !== 200) die(r.data.message ?? `Falhou (HTTP ${r.status})`)
+  const peak = a => Math.max(a.five_hour_pct ?? 0, a.weekly_pct ?? 0)
+  const list = [...r.data.accounts].sort((a, b) => b.available - a.available || peak(a) - peak(b) || a.slug.localeCompare(b.slug))
+  if (rest.includes('--json')) {
+    console.log(JSON.stringify({
+      current: app.account ? (r.data.accounts.find(a => a.id === app.account.id)?.slug ?? null) : null,
+      recommended: r.data.recommended,
+      accounts: list.map(a => ({
+        slug: a.slug, label: a.label, available: a.available, status: a.status,
+        five_hour_pct: a.five_hour_pct, five_hour_resets_at: a.five_hour_resets_at,
+        weekly_pct: a.weekly_pct, weekly_resets_at: a.weekly_resets_at,
+      })),
+    }, null, 2))
+  }
+  else for (const a of list.filter(a => a.available)) console.log(a.slug)
+  process.exit(0)
+}
+
 // `ccx`, `ccx login ...` (depois de autorizar) ou `ccx <conta>`
 await useAccount(app, key, cmd && cmd !== 'login' ? cmd : await chooseAccount(app, key))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nectarcrm/ccx",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "Escolhe qual conta Claude este computador usa, conectado ao app Contas Claude da Nectar.",
   "type": "module",
   "bin": { "ccx": "bin/ccx.js" },