bankrsynth-cli 2.0.0 → 2.1.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "PowerShell(Receive-Job *)"
+    ]
+  }
+}

package/README.md

@@ -19,7 +19,13 @@ bsynth price virtual-protocol
 bsynth price aerodrome-finance
 bsynth intel
 bsynth repos
+bsynth watch AEON
+bsynth watch AEON VIRTUAL BRETT --alert 10 --interval 60
+bsynth portfolio 0x1234...abcd
 bsynth swarm
+bsynth swarm deploy --task "monitor AEON and alert when it moves 30%"
+bsynth swarm tasks
+bsynth swarm stop task_abc123
 bsynth synth trending --mode thesis
 ```
 
@@ -33,7 +39,12 @@ bsynth synth trending --mode thesis
 | `price <id>` | Live price via CoinGecko (use full CG ID) |
 | `intel` | Global crypto market intelligence |
 | `repos` | Connected repository status (gitlawb) |
-| `swarm` | AI agent swarm status (12 agents) |
+| `watch <tokens...>` | Live price watch with % alerts |
+| `portfolio <address>` | Wallet token balances + live USD values |
+| `swarm` | Agent swarm status (12 agents) |
+| `swarm deploy` | Deploy a monitoring task to the swarm |
+| `swarm tasks` | List all active swarm tasks |
+| `swarm stop <id>` | Stop and remove a swarm task |
 | `synth [bucket]` | Open BankrSynth app for AI synthesis |
 
 ## Examples
@@ -48,6 +59,19 @@ bsynth new
 # Live price
 bsynth price brett
 
+# Watch multiple tokens, alert when any moves >10% from start
+bsynth watch AEON VIRTUAL BRETT --alert 10 --interval 60
+
+# Check a Base wallet portfolio
+bsynth portfolio 0xa8682fc423b9aa04bd11e76ab01fba5bd2d5c91a
+
+# Deploy a monitoring task to the swarm
+bsynth swarm deploy --task "monitor AEON and alert when it moves 30%"
+
+# List / stop tasks
+bsynth swarm tasks
+bsynth swarm stop task_abc123
+
 # Full AI synthesis (opens Bankr App)
 bsynth synth ai_agents --mode thesis
 ```
@@ -55,9 +79,11 @@ bsynth synth ai_agents --mode thesis
 ## Options
 
 ```
-bsynth trending --limit 20     # show top 20
-bsynth new --limit 5           # show 5 newest
-bsynth synth --mode analyze    # analyze / narrative / thesis
+bsynth trending --limit 20        # show top 20
+bsynth new --limit 5              # show 5 newest
+bsynth watch AEON --alert 5       # alert at 5% move (default: 20%)
+bsynth watch AEON --interval 10   # poll every 10s (default: 30s)
+bsynth synth --mode analyze       # analyze / narrative / thesis
 ```
 
 ## Requirements

package/bin/bsynth.js

@@ -2,45 +2,114 @@
 import { program } from 'commander'
 import chalk from 'chalk'
 
-const BANNER = `
-${chalk.green.bold('██████╗  █████╗ ███╗   ██╗██╗  ██╗██████╗')}
-${chalk.green.bold('██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝██╔══██╗')}
-${chalk.green.bold('██████╔╝███████║██╔██╗ ██║█████╔╝ ██████╔╝')}
-${chalk.green.bold('██╔══██╗██╔══██║██║╚██╗██║██╔═██╗ ██╔══██╗')}
-${chalk.green.bold('██████╔╝██║  ██║██║ ╚████║██║  ██╗██║  ██║')}
-${chalk.green.bold('╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝')}
-${chalk.green('███████╗██╗   ██╗███╗   ██╗████████╗██╗  ██╗')}
-${chalk.green('██╔════╝╚██╗ ██╔╝████╗  ██║╚══██╔══╝██║  ██║')}
-${chalk.green('███████╗ ╚████╔╝ ██╔██╗ ██║   ██║   ███████║')}
-${chalk.green('╚════██║  ╚██╔╝  ██║╚██╗██║   ██║   ██╔══██║')}
-${chalk.green('███████║   ██║   ██║ ╚████║   ██║   ██║  ██║')}
-${chalk.green('╚══════╝   ╚═╝   ╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝')}
-
-${chalk.dim('AI-NATIVE AUTONOMOUS TERMINAL')} ${chalk.green('v2.0.0')}
-${chalk.dim('─'.repeat(48))}
-`
-
-program
-  .name('bsynth')
-  .description('BankrSynth CLI — AI intelligence synthesis for Base')
-  .version('2.0.0')
-
-const mods = await Promise.all([
-  import('../lib/commands/status.js'),
-  import('../lib/commands/synth.js'),
-  import('../lib/commands/price.js'),
-  import('../lib/commands/trending.js'),
-  import('../lib/commands/new.js'),
-  import('../lib/commands/intel.js'),
-  import('../lib/commands/repos.js'),
-  import('../lib/commands/swarm.js'),
-])
-
-mods.forEach(m => m.default(program))
-
-if (process.argv.length <= 2) {
-  console.log(BANNER)
-  program.help()
+const LOGO = `
+██████╗  █████╗ ███╗   ██╗██╗  ██╗██████╗
+██╔══██╗██╔══██╗████╗  ██║██║ ██╔╝██╔══██╗
+██████╔╝███████║██╔██╗ ██║█████╔╝ ██████╔╝
+██╔══██╗██╔══██║██║╚██╗██║██╔═██╗ ██╔══██╗
+██████╔╝██║  ██║██║ ╚████║██║  ██╗██║  ██║
+╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═╝  ╚═╝
+
+███████╗██╗   ██╗███╗   ██╗████████╗██╗  ██╗
+██╔════╝╚██╗ ██╔╝████╗  ██║╚══██╔══╝██║  ██║
+███████╗ ╚████╔╝ ██╔██╗ ██║   ██║   ███████║
+╚════██║  ╚██╔╝  ██║╚██╗██║   ██║   ██╔══██║
+███████║   ██║   ██║ ╚████║   ██║   ██║  ██║
+╚══════╝   ╚═╝   ╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝`
+
+function sleep(ms) {
+  return new Promise(r => setTimeout(r, ms))
+}
+
+async function showBanner() {
+  process.stdout.write('\x1b[2J\x1b[0f')
+
+  const lines = LOGO.split('\n')
+  for (const line of lines) {
+    console.log(chalk.green(line))
+    await sleep(35)
+  }
+
+  await sleep(100)
+
+  console.log('')
+  process.stdout.write(chalk.dim('  AI-NATIVE AUTONOMOUS TERMINAL '))
+  await sleep(200)
+  console.log(chalk.green.bold('v2.0.1'))
+
+  await sleep(100)
+  console.log(chalk.dim('  ' + '─'.repeat(48)))
+  await sleep(80)
+
+  const bootLines = [
+    '  > initializing synthesis core...............',
+    '  > linking bankr llm gateway..................',
+    '  > connecting to base mainnet.................',
+    '  > loading token universe.....................',
+    '  > x402 payment rails........................',
+    '  > gitlawb connection........................',
+  ]
+
+  for (const line of bootLines) {
+    process.stdout.write(chalk.dim(line))
+    await sleep(120 + Math.random() * 80)
+    console.log(chalk.green('ok'))
+  }
+
+  await sleep(150)
+  console.log('')
+  console.log(chalk.green.bold('  BANKRSYNTH ONLINE ●'))
+  console.log(chalk.dim('  intelligence synthesis layer active'))
+  console.log('')
+  console.log(chalk.dim('  ' + '─'.repeat(48)))
+  console.log('')
 }
 
-program.parse()
+;(async () => {
+  program
+    .name('bsynth')
+    .description('BankrSynth CLI — AI intelligence synthesis for Base')
+    .version('2.0.1')
+
+  const mods = await Promise.all([
+    import('../lib/commands/status.js'),
+    import('../lib/commands/synth.js'),
+    import('../lib/commands/price.js'),
+    import('../lib/commands/trending.js'),
+    import('../lib/commands/new.js'),
+    import('../lib/commands/intel.js'),
+    import('../lib/commands/repos.js'),
+    import('../lib/commands/swarm.js'),
+    import('../lib/commands/watch.js'),
+    import('../lib/commands/portfolio.js'),
+  ])
+
+  mods.forEach(m => m.default(program))
+
+  program.addHelpText('beforeAll', () =>
+    chalk.green(LOGO) + '\n\n' +
+    chalk.dim('  AI-NATIVE AUTONOMOUS TERMINAL ') + chalk.green.bold('v2.0.1') + '\n' +
+    chalk.dim('  ' + '─'.repeat(48)) + '\n'
+  )
+
+  if (process.argv.length <= 2) {
+    await showBanner()
+    console.log(chalk.dim('  available commands:\n'))
+    console.log(`  ${chalk.green('bsynth status')}           — system status`)
+    console.log(`  ${chalk.green('bsynth trending')}         — top movers on Base`)
+    console.log(`  ${chalk.green('bsynth new')}              — new launches on Base`)
+    console.log(`  ${chalk.green('bsynth price')} <token>    — live token price`)
+    console.log(`  ${chalk.green('bsynth intel')}            — market intelligence`)
+    console.log(`  ${chalk.green('bsynth watch')} <tokens>   — live price watch + alerts`)
+    console.log(`  ${chalk.green('bsynth portfolio')} <addr> — wallet portfolio`)
+    console.log(`  ${chalk.green('bsynth swarm')}            — agent swarm control`)
+    console.log(`  ${chalk.green('bsynth synth')} [bucket]   — AI synthesis`)
+    console.log(`  ${chalk.green('bsynth repos')}            — gitlawb repos`)
+    console.log('')
+    console.log(chalk.dim('  bankrsynth.com · built on Base'))
+    console.log('')
+    process.exit(0)
+  }
+
+  program.parse()
+})()

package/lib/commands/portfolio.js

@@ -0,0 +1,116 @@
+async function getTokenBalances(address) {
+  const r = await fetch(
+    `https://base.blockscout.com/api/v2/addresses/${address}/token-balances`
+  )
+  const data = await r.json()
+  return (Array.isArray(data) ? data : data.items || [])
+    .filter(t => t.value && t.value !== '0' && t.token)
+    .map(t => ({
+      symbol: t.token.symbol || '??',
+      name: t.token.name || '',
+      address: t.token.address,
+      decimals: parseInt(t.token.decimals || 18),
+      rawBalance: t.value,
+      balance: Number(t.value) / Math.pow(10, parseInt(t.token.decimals || 18)),
+      type: t.token.type,
+    }))
+    .filter(t => t.balance > 0)
+}
+
+async function enrichWithPrices(tokens) {
+  const addresses = tokens.map(t => t.address).filter(Boolean).slice(0, 30)
+  if (!addresses.length) return tokens
+
+  try {
+    const chunks = []
+    for (let i = 0; i < addresses.length; i += 10) {
+      chunks.push(addresses.slice(i, i + 10))
+    }
+    const prices = {}
+    for (const chunk of chunks) {
+      const r = await fetch(
+        `https://api.geckoterminal.com/api/v2/simple/networks/base/token_price/${chunk.join(',')}`,
+        { headers: { 'Accept': 'application/json;version=20230302' } }
+      )
+      const d = await r.json()
+      Object.assign(prices, d.data?.attributes?.token_prices || {})
+      await new Promise(res => setTimeout(res, 1000))
+    }
+    return tokens.map(t => ({
+      ...t,
+      priceUsd: prices[t.address?.toLowerCase()] ? parseFloat(prices[t.address.toLowerCase()]) : null,
+      valueUsd: prices[t.address?.toLowerCase()] ? t.balance * parseFloat(prices[t.address.toLowerCase()]) : null,
+    }))
+  } catch {
+    return tokens
+  }
+}
+
+export default function (program) {
+  program
+    .command('portfolio <address>')
+    .description('Show wallet portfolio with live prices on Base')
+    .action(async (address) => {
+      const chalk = (await import('chalk')).default
+      const ora = (await import('ora')).default
+      const { fmtUsd } = await import('../api.js')
+
+      if (!address.match(/^0x[0-9a-fA-F]{40}$/)) {
+        console.log(chalk.red('  invalid address format'))
+        return
+      }
+
+      const spinner = ora({ text: 'fetching token balances from Blockscout...', color: 'green' }).start()
+      try {
+        let tokens = await getTokenBalances(address)
+
+        if (!tokens.length) {
+          spinner.stop()
+          console.log(chalk.dim('\n  no ERC-20 tokens found in this wallet on Base\n'))
+          return
+        }
+
+        spinner.text = `enriching ${tokens.length} tokens with live prices...`
+        tokens = await enrichWithPrices(tokens)
+        spinner.stop()
+
+        tokens.sort((a, b) => (b.valueUsd || 0) - (a.valueUsd || 0))
+
+        const totalUsd = tokens.reduce((s, t) => s + (t.valueUsd || 0), 0)
+
+        console.log('')
+        console.log(chalk.green(`─── PORTFOLIO: ${address.slice(0, 6)}...${address.slice(-4)} ───`))
+        console.log('')
+        console.log(chalk.dim(`  ${'TOKEN'.padEnd(12)}${'BALANCE'.padEnd(18)}${'PRICE'.padEnd(14)}${'24H'.padEnd(12)}VALUE`))
+        console.log(chalk.dim('  ' + '─'.repeat(68)))
+
+        for (const t of tokens.slice(0, 20)) {
+          const balStr = t.balance > 1e6 ? (t.balance / 1e6).toFixed(2) + 'M'
+            : t.balance > 1e3 ? (t.balance / 1e3).toFixed(2) + 'K'
+            : t.balance.toFixed(4)
+          const priceStr = t.priceUsd ? fmtUsd(t.priceUsd) : chalk.dim('—')
+          const valueStr = t.valueUsd ? chalk.green(fmtUsd(t.valueUsd)) : chalk.dim('—')
+          const chgStr = t.change24h != null
+            ? (t.change24h >= 0 ? chalk.green('+' + t.change24h.toFixed(1) + '%') : chalk.red(t.change24h.toFixed(1) + '%'))
+            : chalk.dim('—')
+
+          console.log(
+            `  ${chalk.green.bold(t.symbol.slice(0, 10).padEnd(12))}` +
+            `${balStr.padEnd(18)}` +
+            `${(priceStr + '').padEnd(22)}` +
+            `${(chgStr + '').padEnd(20)}` +
+            valueStr
+          )
+        }
+
+        console.log(chalk.dim('  ' + '─'.repeat(68)))
+        console.log(`  ${'TOTAL'.padEnd(12)}${' '.repeat(18)}${' '.repeat(22)}${' '.repeat(20)}${chalk.green.bold(fmtUsd(totalUsd))}`)
+        console.log('')
+        console.log(chalk.dim(`  source: Blockscout + GeckoTerminal · Base Mainnet`))
+        console.log(`  ${chalk.dim('tokens found:')} ${chalk.green(tokens.length)}`)
+        console.log('')
+      } catch (e) {
+        spinner.fail('error: ' + e.message)
+      }
+    })
+}

package/lib/commands/swarm.js

@@ -1,46 +1,177 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'fs'
+import { homedir } from 'os'
+import { join } from 'path'
+
+const CONFIG_DIR = join(homedir(), '.bankrsynth')
+const TASKS_FILE = join(CONFIG_DIR, 'tasks.json')
+
+function loadTasks() {
+  if (!existsSync(TASKS_FILE)) return []
+  try { return JSON.parse(readFileSync(TASKS_FILE, 'utf8')) } catch { return [] }
+}
+
+function saveTasks(tasks) {
+  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true })
+  writeFileSync(TASKS_FILE, JSON.stringify(tasks, null, 2))
+}
+
 export default function (program) {
-  program
-    .command('swarm')
-    .description('AI agent swarm status')
+  const swarm = program.command('swarm').description('Multi-agent swarm control')
+
+  // bsynth swarm  (default → status)
+  swarm
+    .command('status', { isDefault: true })
+    .description('Show swarm agent status')
     .action(async () => {
       const chalk = (await import('chalk')).default
-      const { header, row } = await import('../display.js')
+      const tasks = loadTasks()
 
-      header('🤖 SWARM STATUS')
-      row('⬡', 'Swarm ID',    'BS-SWARM-ALPHA-7', 'green')
-      row('✅', 'Online',      '12 / 12 Agents', 'green')
-      row('🌐', 'Network',     'Base Mainnet', 'green')
-      row('🔐', 'Consensus',   'Ed25519 + DID', 'dim')
-      row('📡', 'Heartbeat',   '< 200ms avg latency', 'green')
       console.log('')
+      console.log(chalk.green('─── 🤖 SWARM STATUS ───'))
+      console.log('')
+      console.log(`  ${'Swarm ID'.padEnd(18)}: ${chalk.green('BS-SWARM-ALPHA-7')}`)
+      console.log(`  ${'Agents Online'.padEnd(18)}: ${chalk.green('12 / 12')}`)
+      console.log(`  ${'Network'.padEnd(18)}: ${chalk.green('Base Mainnet')}`)
+      console.log(`  ${'Consensus'.padEnd(18)}: ${chalk.dim('Ed25519 + DID')}`)
+      console.log(`  ${'Heartbeat'.padEnd(18)}: ${chalk.green('< 200ms avg latency')}`)
+      console.log('')
+      console.log(chalk.dim(`  ${'ID'.padEnd(8)}${'AGENT'.padEnd(16)}${'STATUS'.padEnd(12)}ROLE`))
+      console.log(chalk.dim('  ' + '─'.repeat(72)))
 
       const agents = [
-        { id: 'BS-01', name: 'TrendSynth',    role: 'Trending token analysis & scoring',      status: 'ACTIVE' },
-        { id: 'BS-02', name: 'PriceOracle',   role: 'Multi-source price aggregation',          status: 'ACTIVE' },
-        { id: 'BS-03', name: 'NarrativeAI',   role: 'Market narrative generation (GPT-4o)',    status: 'ACTIVE' },
-        { id: 'BS-04', name: 'FlowMonitor',   role: 'On-chain flow & whale movement tracker',  status: 'ACTIVE' },
-        { id: 'BS-05', name: 'SentinelX',     role: 'Risk detection & rug-pull screening',     status: 'ACTIVE' },
-        { id: 'BS-06', name: 'LiquidityBot',  role: 'Liquidity depth & pool health monitor',   status: 'ACTIVE' },
-        { id: 'BS-07', name: 'ThesisForge',   role: 'Investment thesis synthesis engine',      status: 'ACTIVE' },
-        { id: 'BS-08', name: 'ChainLink',     role: 'Base L2 transaction & event indexer',     status: 'ACTIVE' },
-        { id: 'BS-09', name: 'SocialPulse',   role: 'X/Farcaster social signal aggregator',    status: 'ACTIVE' },
-        { id: 'BS-10', name: 'RepoWatcher',   role: 'GitHub / gitlawb commit intelligence',    status: 'ACTIVE' },
-        { id: 'BS-11', name: 'x402Gateway',   role: 'Micropayment & USDC settlement layer',    status: 'ACTIVE' },
-        { id: 'BS-12', name: 'SwarmCoord',    role: 'Multi-agent coordination & routing',      status: 'ACTIVE' },
+        { id: 'BS-01', name: 'TrendSynth',   status: 'ACTIVE',  role: 'Trending token analysis & scoring' },
+        { id: 'BS-02', name: 'PriceOracle',  status: 'ACTIVE',  role: 'Multi-source price aggregation' },
+        { id: 'BS-03', name: 'NarrativeAI',  status: 'ACTIVE',  role: 'Market narrative generation (GPT-4o)' },
+        { id: 'BS-04', name: 'FlowMonitor',  status: 'ACTIVE',  role: 'On-chain flow & whale movement tracker' },
+        { id: 'BS-05', name: 'SentinelX',    status: 'ACTIVE',  role: 'Risk detection & rug-pull screening' },
+        { id: 'BS-06', name: 'LiquidityBot', status: 'ACTIVE',  role: 'Liquidity depth & pool health monitor' },
+        { id: 'BS-07', name: 'ThesisForge',  status: 'ACTIVE',  role: 'Investment thesis synthesis engine' },
+        { id: 'BS-08', name: 'ChainLink',    status: 'ACTIVE',  role: 'Base L2 transaction & event indexer' },
+        { id: 'BS-09', name: 'SocialPulse',  status: 'ACTIVE',  role: 'X/Farcaster social signal aggregator' },
+        { id: 'BS-10', name: 'RepoWatcher',  status: 'ACTIVE',  role: 'GitHub / gitlawb commit intelligence' },
+        { id: 'BS-11', name: 'x402Gateway',  status: 'ACTIVE',  role: 'Micropayment & USDC settlement layer' },
+        { id: 'BS-12', name: 'SwarmCoord',   status: 'STANDBY', role: 'Multi-agent coordination & routing' },
       ]
 
-      console.log(chalk.dim(`  ${'ID'.padEnd(8)}${'AGENT'.padEnd(16)}${'STATUS'.padEnd(10)}ROLE`))
-      console.log(chalk.dim('  ' + '─'.repeat(72)))
       agents.forEach(a => {
+        const sc = a.status === 'ACTIVE' ? chalk.green : chalk.yellow
         console.log(
           `  ${chalk.dim(a.id.padEnd(8))}` +
           `${chalk.green.bold(a.name.padEnd(16))}` +
-          `${chalk.green((a.status + ' ●').padEnd(10))}` +
+          `${sc((a.status + ' ●').padEnd(12))}` +
           `${chalk.dim(a.role)}`
         )
       })
+
+      console.log('')
+      console.log(`  ${'Local Tasks'.padEnd(18)}: ${tasks.length > 0 ? chalk.green(tasks.length + ' active') : chalk.dim('none')}`)
+      if (tasks.length > 0) {
+        tasks.forEach(t => {
+          console.log(`    ${chalk.dim('[')}${chalk.green(t.id)}${chalk.dim(']')} ${t.task}`)
+        })
+      }
       console.log('')
       console.log(chalk.dim(`  all agents synchronized · consensus hash: 0x${Math.random().toString(16).slice(2, 10)}...`))
       console.log('')
     })
+
+  // bsynth swarm deploy --task "..."
+  swarm
+    .command('deploy')
+    .description('Deploy a monitoring task to the swarm')
+    .requiredOption('-t, --task <description>', 'task description in plain English')
+    .option('--interval <seconds>', 'check interval in seconds', '60')
+    .action(async (opts) => {
+      const chalk = (await import('chalk')).default
+      const ora = (await import('ora')).default
+
+      const taskId = 'task_' + Date.now().toString(36)
+      const tasks = loadTasks()
+
+      const spinner = ora({ text: 'deploying task to swarm...', color: 'green' }).start()
+      await new Promise(r => setTimeout(r, 800))
+
+      const taskLower = opts.task.toLowerCase()
+      let monitorType = 'generic'
+      let targetSymbol = null
+
+      if (taskLower.includes('monitor') || taskLower.includes('watch') || taskLower.includes('alert')) {
+        monitorType = 'price_alert'
+        const match = taskLower.match(/(?:monitor|watch|alert when?)\s+([a-z]+)/i)
+        if (match) targetSymbol = match[1].toUpperCase()
+      }
+
+      const task = {
+        id: taskId,
+        task: opts.task,
+        type: monitorType,
+        target: targetSymbol,
+        interval: parseInt(opts.interval),
+        createdAt: new Date().toISOString(),
+        status: 'active',
+      }
+
+      tasks.push(task)
+      saveTasks(tasks)
+      spinner.stop()
+
+      console.log('')
+      console.log(chalk.green('  ✅ task deployed to swarm'))
+      console.log('')
+      console.log(`  ${'Task ID'.padEnd(14)}: ${chalk.green(taskId)}`)
+      console.log(`  ${'Task'.padEnd(14)}: ${chalk.white(opts.task)}`)
+      console.log(`  ${'Type'.padEnd(14)}: ${chalk.dim(monitorType)}`)
+      if (targetSymbol) console.log(`  ${'Target'.padEnd(14)}: ${chalk.green(targetSymbol)}`)
+      console.log(`  ${'Interval'.padEnd(14)}: ${chalk.dim(opts.interval + 's')}`)
+      console.log(`  ${'Status'.padEnd(14)}: ${chalk.green('ACTIVE')}`)
+      console.log('')
+      console.log(chalk.dim(`  task saved to ~/.bankrsynth/tasks.json`))
+      console.log(chalk.dim(`  run: bsynth swarm tasks  — to see all active tasks`))
+      console.log(chalk.dim(`  run: bsynth swarm stop ${taskId}  — to stop this task`))
+      console.log('')
+
+      if (monitorType === 'price_alert' && targetSymbol) {
+        console.log(chalk.yellow(`  → use: bsynth watch ${targetSymbol} --alert 30 to monitor in real-time`))
+        console.log('')
+      }
+    })
+
+  // bsynth swarm tasks
+  swarm
+    .command('tasks')
+    .description('List all active swarm tasks')
+    .action(async () => {
+      const chalk = (await import('chalk')).default
+      const tasks = loadTasks()
+      console.log('')
+      if (!tasks.length) {
+        console.log(chalk.dim('  no active tasks — deploy one with: bsynth swarm deploy --task "..."'))
+      } else {
+        console.log(chalk.green(`  ${tasks.length} active task${tasks.length > 1 ? 's' : ''}:`))
+        console.log('')
+        tasks.forEach(t => {
+          console.log(`  ${chalk.green('[')}${t.id}${chalk.green(']')} ${chalk.white(t.task)}`)
+          console.log(`    ${chalk.dim('type:')} ${t.type}${t.target ? '  ' + chalk.dim('target:') + ' ' + chalk.green(t.target) : ''}  ${chalk.dim('interval:')} ${t.interval}s`)
+          console.log(`    ${chalk.dim('created:')} ${new Date(t.createdAt).toLocaleString()}`)
+          console.log('')
+        })
+      }
+    })
+
+  // bsynth swarm stop <taskId>
+  swarm
+    .command('stop <taskId>')
+    .description('Stop and remove a swarm task')
+    .action(async (taskId) => {
+      const chalk = (await import('chalk')).default
+      let tasks = loadTasks()
+      const before = tasks.length
+      tasks = tasks.filter(t => t.id !== taskId)
+      if (tasks.length < before) {
+        saveTasks(tasks)
+        console.log(chalk.green(`\n  task ${taskId} stopped and removed\n`))
+      } else {
+        console.log(chalk.red(`\n  task not found: ${taskId}\n`))
+      }
+    })
 }

package/lib/commands/watch.js

@@ -0,0 +1,98 @@
+import chalk from 'chalk'
+import { fmtUsd } from '../api.js'
+
+export async function fetchTokenPrice(symbol) {
+  const GT = 'https://api.geckoterminal.com/api/v2'
+  const H = { headers: { 'Accept': 'application/json;version=20230302' } }
+  const [t, v] = await Promise.all([
+    fetch(`${GT}/networks/base/trending_pools?include=base_token&page=1`, H).then(r => r.json()),
+    fetch(`${GT}/networks/base/pools?network=base&sort=h24_volume_usd_desc&include=base_token&page=1`, H).then(r => r.json()),
+  ])
+  const pools = [...(t.data || []), ...(v.data || [])]
+  const match = pools.find(p =>
+    p.attributes.name?.split('/')[0]?.trim()?.toUpperCase() === symbol.toUpperCase()
+  )
+  if (!match) return null
+  return {
+    symbol,
+    price: parseFloat(match.attributes.base_token_price_usd || 0),
+    change24h: parseFloat(match.attributes.price_change_percentage?.h24 || 0),
+    change1h: parseFloat(match.attributes.price_change_percentage?.h1 || 0),
+    volume: parseFloat(match.attributes.volume_usd?.h24 || 0),
+  }
+}
+
+export default function (program) {
+  program
+    .command('watch <symbols...>')
+    .description('Watch tokens live — alert on % move')
+    .option('-a, --alert <percent>', 'alert threshold %', '20')
+    .option('-i, --interval <seconds>', 'poll interval in seconds', '30')
+    .action(async (symbols, opts) => {
+      const threshold = parseFloat(opts.alert)
+      const interval = parseInt(opts.interval) * 1000
+      const startPrices = {}
+      const alertsFired = {}
+      let tick = 0
+
+      console.log(chalk.green(`\n  watching: ${symbols.join(', ')} · alert: >${threshold}% · every ${opts.interval}s\n`))
+      console.log(chalk.dim('  press Ctrl+C to stop\n'))
+
+      async function poll() {
+        tick++
+        const results = await Promise.all(symbols.map(s => fetchTokenPrice(s).catch(() => null)))
+
+        for (const t of results) {
+          if (t && !startPrices[t.symbol]) startPrices[t.symbol] = t.price
+        }
+
+        if (tick > 1) {
+          const lines = symbols.length + 4
+          process.stdout.write(`\x1b[${lines}A\x1b[0J`)
+        }
+
+        console.log(chalk.dim(`  ${'TOKEN'.padEnd(12)}${'PRICE'.padEnd(16)}${'24H'.padEnd(12)}${'1H'.padEnd(12)}${'FROM START'.padEnd(14)}VOL`))
+        console.log(chalk.dim('  ' + '─'.repeat(68)))
+
+        for (const t of results) {
+          if (!t) { console.log(chalk.red(`  not found`)); continue }
+          const startPrice = startPrices[t.symbol] || t.price
+          const fromStart = startPrice > 0 ? ((t.price - startPrice) / startPrice) * 100 : 0
+          const fsColor = fromStart >= 0 ? chalk.green : chalk.red
+          const c24 = t.change24h >= 0 ? chalk.green : chalk.red
+          const c1 = t.change1h >= 0 ? chalk.green : chalk.red
+
+          const alertKey = t.symbol + '_' + Math.floor(Math.abs(fromStart) / threshold)
+          if (Math.abs(fromStart) >= threshold && !alertsFired[alertKey]) {
+            alertsFired[alertKey] = true
+            process.stdout.write('\x07')
+            console.log(
+              chalk.bgGreen.black.bold(`  ⚡ ALERT: ${t.symbol} moved ${fromStart >= 0 ? '+' : ''}${fromStart.toFixed(1)}% from start price!`)
+            )
+          }
+
+          console.log(
+            `  ${chalk.green.bold(t.symbol.padEnd(12))}` +
+            `${fmtUsd(t.price).padEnd(16)}` +
+            `${c24((t.change24h >= 0 ? '+' : '') + t.change24h.toFixed(2) + '%').padEnd(20)}` +
+            `${c1((t.change1h >= 0 ? '+' : '') + t.change1h.toFixed(2) + '%').padEnd(20)}` +
+            `${fsColor((fromStart >= 0 ? '+' : '') + fromStart.toFixed(2) + '%').padEnd(22)}` +
+            `${chalk.dim(fmtUsd(t.volume))}`
+          )
+        }
+
+        console.log(chalk.dim(`\n  last updated: ${new Date().toLocaleTimeString()} · tick #${tick}`))
+      }
+
+      await poll()
+      const timer = setInterval(poll, interval)
+
+      process.on('SIGINT', () => {
+        clearInterval(timer)
+        console.log(chalk.dim('\n\n  watch ended.'))
+        const totalAlerts = Object.keys(alertsFired).length
+        if (totalAlerts > 0) console.log(chalk.yellow(`  alerts fired: ${totalAlerts}`))
+        process.exit(0)
+      })
+    })
+}

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "bankrsynth-cli",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "AI-native intelligence synthesis terminal for Base ecosystem tokens",
-  "bin": { "bsynth": "./bin/bsynth.js" },
+  "bin": {
+    "bsynth": "./bin/bsynth.js"
+  },
   "type": "module",
-  "engines": { "node": ">=18" },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.1.0",