0101-agents 0.0.1 → 0.1.0

package/bin/cli.js

@@ -1,2 +1,325 @@
 #!/usr/bin/env node
-console.log('0101 — coming soon. See https://0101.fyi')
+// 0101-agents CLI — installs and updates curated Claude Code agents.
+//
+// Commands:
+//   0101-agents login [<license-key>]
+//   0101-agents logout
+//   0101-agents whoami
+//   0101-agents install <agent> [--force]
+//   0101-agents update <agent>
+//   0101-agents list
+//   0101-agents help
+
+import { execSync } from 'node:child_process'
+import {
+  existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync,
+  rmSync, statSync, createWriteStream,
+} from 'node:fs'
+import { homedir, tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { Readable } from 'node:stream'
+import { pipeline } from 'node:stream/promises'
+import { createInterface } from 'node:readline/promises'
+
+const HOME = homedir()
+const CONFIG_DIR = join(HOME, '.0101')
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json')
+const INSTALL_ROOT = join(HOME, '0101')
+const BACKUPS_DIR = join(INSTALL_ROOT, '.backups')
+
+const DEFAULT_API_BASE = 'https://0101.fyi'
+
+// ─── pretty output ───────────────────────────────────────────────────────────
+
+const c = (code, s) => `\x1b[${code}m${s}\x1b[0m`
+const green = s => c(32, s)
+const red = s => c(31, s)
+const dim = s => c(2, s)
+const bold = s => c(1, s)
+
+const ok = s => console.log(green('✓ ') + s)
+const err = s => console.error(red('✗ ') + s)
+const info = s => console.log(dim('  ' + s))
+
+function die(msg, code = 1) {
+  err(msg)
+  process.exit(code)
+}
+
+// ─── config ──────────────────────────────────────────────────────────────────
+
+function readConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_PATH, 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+function writeConfig(next) {
+  mkdirSync(CONFIG_DIR, { recursive: true })
+  writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2) + '\n', { mode: 0o600 })
+}
+
+function apiBase() {
+  return readConfig().api_base || process.env['0101_API_BASE'] || DEFAULT_API_BASE
+}
+
+function licenseKey() {
+  const k = readConfig().license_key
+  if (!k) die('No license key. Run: 0101-agents login')
+  return k
+}
+
+// ─── api ─────────────────────────────────────────────────────────────────────
+
+async function fetchManifest(agent) {
+  const url = `${apiBase()}/api/releases/${encodeURIComponent(agent)}`
+  const res = await fetch(url, {
+    headers: { Authorization: `Bearer ${licenseKey()}` },
+  })
+  if (res.status === 401) die('License invalid. Run: 0101-agents login')
+  if (res.status === 403) {
+    const body = await res.json().catch(() => ({}))
+    die(body.error || 'License does not cover this agent.')
+  }
+  if (res.status === 404) die(`Agent not found: ${agent}`)
+  if (!res.ok) die(`Manifest fetch failed: ${res.status} ${res.statusText}`)
+  return res.json()
+}
+
+async function downloadZip(downloadUrl, destPath) {
+  const res = await fetch(downloadUrl, {
+    headers: { Authorization: `Bearer ${licenseKey()}` },
+  })
+  if (!res.ok) die(`Download failed: ${res.status} ${res.statusText}`)
+  if (!res.body) die('Download returned empty body.')
+
+  // Node fetch returns a web ReadableStream; pipe to a file.
+  const nodeReadable = Readable.fromWeb(res.body)
+  await pipeline(nodeReadable, createWriteStream(destPath))
+}
+
+// ─── helpers ─────────────────────────────────────────────────────────────────
+
+function agentInstallDir(agent) {
+  return join(INSTALL_ROOT, agent)
+}
+
+function installedVersion(agent) {
+  const versionFile = join(agentInstallDir(agent), '.0101-version')
+  try { return readFileSync(versionFile, 'utf8').trim() } catch { return null }
+}
+
+function writeInstalledVersion(agent, version) {
+  writeFileSync(join(agentInstallDir(agent), '.0101-version'), version + '\n')
+}
+
+function listInstalled() {
+  if (!existsSync(INSTALL_ROOT)) return []
+  return readdirSync(INSTALL_ROOT)
+    .filter(name => !name.startsWith('.'))
+    .filter(name => statSync(join(INSTALL_ROOT, name)).isDirectory())
+}
+
+function ensureUnzipAvailable() {
+  try { execSync('command -v unzip', { stdio: 'ignore' }) } catch {
+    die('The `unzip` binary is required but not found.\n' +
+        '  • macOS: comes pre-installed.\n' +
+        '  • Linux: apt install unzip / dnf install unzip.\n' +
+        '  • Windows: install via WSL or 7-Zip + PATH.')
+  }
+}
+
+function unzipInto(zipPath, destDir, { skipPrefix } = {}) {
+  // Use the system unzip binary. Available everywhere except bare Windows.
+  mkdirSync(destDir, { recursive: true })
+  if (skipPrefix) {
+    // unzip with -x excludes paths matching glob patterns.
+    execSync(
+      `unzip -q -o "${zipPath}" -d "${destDir}" -x "${skipPrefix}/*" "${skipPrefix}"`,
+      { stdio: 'inherit' },
+    )
+  } else {
+    execSync(`unzip -q -o "${zipPath}" -d "${destDir}"`, { stdio: 'inherit' })
+  }
+}
+
+function backupDataDir(agent) {
+  const dataDir = join(agentInstallDir(agent), 'data')
+  if (!existsSync(dataDir)) return null
+  mkdirSync(BACKUPS_DIR, { recursive: true })
+  const ts = new Date().toISOString().replace(/[:.]/g, '-')
+  const oldVersion = installedVersion(agent) ?? 'unknown'
+  const backupPath = join(BACKUPS_DIR, `${agent}-${oldVersion}-${ts}.tar.gz`)
+  execSync(
+    `tar -czf "${backupPath}" -C "${agentInstallDir(agent)}" data`,
+    { stdio: 'inherit' },
+  )
+  return backupPath
+}
+
+async function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  try { return (await rl.question(question)).trim() } finally { rl.close() }
+}
+
+// ─── commands ────────────────────────────────────────────────────────────────
+
+async function cmdLogin(args) {
+  let key = args[0]
+  if (!key) {
+    key = await prompt('Paste your license key: ')
+  }
+  key = key.trim()
+  if (!key) die('No key provided.')
+  writeConfig({ ...readConfig(), license_key: key })
+  ok(`Saved license to ${CONFIG_PATH}`)
+}
+
+function cmdLogout() {
+  const cfg = readConfig()
+  delete cfg.license_key
+  writeConfig(cfg)
+  ok('Logged out.')
+}
+
+async function cmdWhoami() {
+  const key = readConfig().license_key
+  if (!key) die('Not logged in. Run: 0101-agents login')
+  // Don't validate against the server here — keep it offline. `install` /
+  // `update` will surface a real 401 if the key is bad.
+  console.log(dim('License: ') + key.slice(0, 6) + '…' + key.slice(-4))
+  console.log(dim('API:     ') + apiBase())
+}
+
+async function cmdInstall(args) {
+  const agent = args[0]
+  if (!agent) die('Usage: 0101-agents install <agent> [--force]')
+  const force = args.includes('--force')
+
+  ensureUnzipAvailable()
+  const installDir = agentInstallDir(agent)
+  if (existsSync(installDir) && !force) {
+    die(`${installDir} already exists. Use --force to overwrite (will wipe data/).`)
+  }
+
+  info(`Fetching manifest for ${agent}…`)
+  const manifest = await fetchManifest(agent)
+  info(`Latest: ${manifest.latest}`)
+
+  const zipPath = join(tmpdir(), `0101-${agent}-${manifest.latest}.zip`)
+  info(`Downloading…`)
+  await downloadZip(manifest.download_url, zipPath)
+
+  if (existsSync(installDir) && force) {
+    rmSync(installDir, { recursive: true, force: true })
+  }
+  mkdirSync(installDir, { recursive: true })
+  unzipInto(zipPath, installDir)
+  writeInstalledVersion(agent, manifest.latest)
+  rmSync(zipPath, { force: true })
+
+  console.log('')
+  ok(`Installed ${bold(agent)} ${manifest.latest} → ${installDir}`)
+  info(`Start: cd ${installDir} && claude`)
+}
+
+async function cmdUpdate(args) {
+  const agent = args[0]
+  if (!agent) die('Usage: 0101-agents update <agent>')
+
+  ensureUnzipAvailable()
+  const installDir = agentInstallDir(agent)
+  if (!existsSync(installDir)) die(`${agent} is not installed. Try: 0101-agents install ${agent}`)
+
+  const current = installedVersion(agent)
+  info(`Installed: ${current ?? 'unknown'}`)
+
+  info(`Fetching manifest…`)
+  const manifest = await fetchManifest(agent)
+  info(`Latest:    ${manifest.latest}`)
+
+  if (current === manifest.latest) {
+    ok('Already up to date.')
+    return
+  }
+
+  const ans = await prompt(`Update ${agent} ${current ?? '?'} → ${manifest.latest}? [Y/n] `)
+  if (ans && !/^y(es)?$/i.test(ans)) {
+    info('Cancelled.')
+    return
+  }
+
+  const backup = backupDataDir(agent)
+  if (backup) info(`Backed up data → ${backup}`)
+
+  const zipPath = join(tmpdir(), `0101-${agent}-${manifest.latest}.zip`)
+  info(`Downloading…`)
+  await downloadZip(manifest.download_url, zipPath)
+
+  // Extract into the install dir, skipping the data/ subtree so user state
+  // survives. unzip's -x flag drops matching entries.
+  unzipInto(zipPath, installDir, { skipPrefix: 'data' })
+  writeInstalledVersion(agent, manifest.latest)
+  rmSync(zipPath, { force: true })
+
+  console.log('')
+  ok(`Updated ${bold(agent)} → ${manifest.latest}`)
+}
+
+function cmdList() {
+  const installed = listInstalled()
+  if (installed.length === 0) {
+    info('No agents installed.')
+    info(`Install one: 0101-agents install <name>`)
+    return
+  }
+  for (const name of installed) {
+    const v = installedVersion(name) ?? dim('?')
+    console.log(`  ${bold(name)} ${dim(v)}`)
+  }
+}
+
+function cmdHelp() {
+  console.log(`0101-agents — install and update Claude Code agents.
+
+Commands:
+  ${bold('login')} [<key>]            Save your license key
+  ${bold('logout')}                   Forget your license key
+  ${bold('whoami')}                   Show current license
+  ${bold('install')} <agent> [--force]  Install an agent
+  ${bold('update')}  <agent>          Update an installed agent (preserves data/)
+  ${bold('list')}                     List installed agents
+  ${bold('help')}                     Show this message
+
+Install dir: ${INSTALL_ROOT}
+Config:      ${CONFIG_PATH}`)
+}
+
+// ─── dispatch ────────────────────────────────────────────────────────────────
+
+const [, , cmd, ...rest] = process.argv
+
+try {
+  switch (cmd) {
+    case 'login':    await cmdLogin(rest); break
+    case 'logout':   cmdLogout(); break
+    case 'whoami':   await cmdWhoami(); break
+    case 'install':  await cmdInstall(rest); break
+    case 'update':   await cmdUpdate(rest); break
+    case 'list':     cmdList(); break
+    case 'help':
+    case '-h':
+    case '--help':
+    case undefined:
+      cmdHelp(); break
+    default:
+      err(`Unknown command: ${cmd}`)
+      cmdHelp()
+      process.exit(1)
+  }
+} catch (e) {
+  err(e?.message ?? String(e))
+  process.exit(1)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "0101-agents",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "",
   "bin": {
     "0101-agents": "./bin/cli.js"