@logtrace/tracker 0.1.0

package/src/index.js

@@ -0,0 +1,235 @@
+#!/usr/bin/env node
+/**
+ * packages/cli/src/index.js
+ *
+ * tracker — LogTrace CLI entry point.
+ *
+ * Uses yargs for command parsing. Each subcommand lives in its own file
+ * under commands/ and exports a single async handler function.
+ *
+ * Usage:
+ *   node packages/cli/src/index.js status
+ *   node packages/cli/src/index.js --help
+ */
+
+import yargs from 'yargs'
+import { hideBin } from 'yargs/helpers'
+import { statusCommand } from './commands/status.js'
+import { logsListCommand, logsSearchCommand } from './commands/logs.js'
+import { dockerListCommand, dockerRestartCommand, dockerLogsCommand } from './commands/docker.js'
+import { alertTestCommand } from './commands/alert.js'
+import { doctorCommand, healthCommand } from './commands/doctor.js'
+import { configListCommand, configGetCommand, configSetCommand, configUnsetCommand } from './commands/config.js'
+import { updateCommand, updateCheckCommand, checkUpdateBackground } from './commands/update.js'
+import { loginCommand } from './commands/login.js'
+import { startInteractive } from './interactive.js'
+import { VERSION } from '@logtrace/shared/constants'
+
+// No args → interactive REPL
+if (hideBin(process.argv).length === 0) {
+  startInteractive()
+} else {
+
+yargs(hideBin(process.argv))
+  .scriptName('tracker')
+  .version(VERSION)
+  .alias('v', 'version')
+  .alias('h', 'help')
+  .usage('$0 <command> [options]')
+
+  // ── status ──────────────────────────────────────────────────────────────────
+  .command(
+    'status',
+    'Show daemon version, uptime, and active modules',
+    (_yargs) => {
+      // No extra options for status yet
+    },
+    (argv) => statusCommand(argv),
+  )
+
+  // ── logs ────────────────────────────────────────────────────────────────────
+  .command(
+    'logs',
+    'Manage logs',
+    (y) => {
+      y.command(
+        'list',
+        'List stored logs with optional filters',
+        (yy) => yy
+          .option('level',   { alias: 'l', type: 'string',  describe: 'Filter by level (debug|info|warn|error|critical)' })
+          .option('service', { alias: 's', type: 'string',  describe: 'Filter by service name' })
+          .option('limit',   { alias: 'n', type: 'number',  describe: 'Number of results (default 20)', default: 20 })
+          .option('from',    { alias: 'f', type: 'string',  describe: 'Show logs from last N (e.g. 1h, 30m, 1d)' }),
+        (argv) => logsListCommand(argv),
+      )
+      y.command(
+        'search <query>',
+        'Search logs by message or service',
+        (yy) => yy
+          .positional('query', { type: 'string', describe: 'Search term' })
+          .option('limit', { alias: 'n', type: 'number', describe: 'Number of results (default 20)', default: 20 }),
+        (argv) => logsSearchCommand(argv),
+      )
+      y.demandCommand(1, 'Specify a subcommand: list, search')
+    },
+    () => {},
+  )
+
+  // ── docker ───────────────────────────────────────────────────────────────────
+  .command(
+    'docker',
+    'Manage Docker containers',
+    (y) => {
+      y.command(
+        'list',
+        'List all containers',
+        (_yy) => {},
+        (argv) => dockerListCommand(argv),
+      )
+      y.command(
+        'restart <name>',
+        'Restart a container by name',
+        (yy) => yy
+          .positional('name', { type: 'string', describe: 'Container name' }),
+        (argv) => dockerRestartCommand(argv),
+      )
+      y.command(
+        'logs <name>',
+        'Tail container log lines',
+        (yy) => yy
+          .positional('name', { type: 'string', describe: 'Container name' })
+          .option('tail', { alias: 't', type: 'number', describe: 'Number of lines (default 50)', default: 50 }),
+        (argv) => dockerLogsCommand(argv),
+      )
+      y.demandCommand(1, 'Specify a subcommand: list, restart, logs')
+    },
+    () => {},
+  )
+
+  // ── alert ────────────────────────────────────────────────────────────────────
+  .command(
+    'alert',
+    'Manage alerts',
+    (y) => {
+      y.command(
+        'test',
+        'Send a test alert through configured channels',
+        (_yy) => {},
+        (argv) => alertTestCommand(argv),
+      )
+      y.demandCommand(1, 'Specify a subcommand: test')
+    },
+    () => {},
+  )
+
+  // ── doctor ───────────────────────────────────────────────────────────────────
+  .command(
+    'doctor',
+    'Run all system health checks and show a full diagnostic table',
+    (_yy) => {},
+    (argv) => doctorCommand(argv),
+  )
+
+  // ── health ───────────────────────────────────────────────────────────────────
+  .command(
+    'health',
+    'Show only problems (warn + critical); "sistema saludable" if all OK',
+    (_yy) => {},
+    (argv) => healthCommand(argv),
+  )
+
+  // ── config ───────────────────────────────────────────────────────────────────
+  .command(
+    'config',
+    'Read and write the LogTrace .env config file',
+    (y) => {
+      y.command(
+        'list',
+        'Show all config keys (sensitive values masked)',
+        (_yy) => {},
+        (argv) => configListCommand(argv),
+      )
+      y.command(
+        'get <key>',
+        'Print the exact value for a key (no masking)',
+        (yy) => yy
+          .positional('key', { type: 'string', describe: 'Config key name' }),
+        (argv) => configGetCommand(argv),
+      )
+      y.command(
+        'set <key> <value>',
+        'Set or update a config key',
+        (yy) => yy
+          .positional('key',   { type: 'string', describe: 'Config key name' })
+          .positional('value', { type: 'string', describe: 'Value to set' }),
+        (argv) => configSetCommand(argv),
+      )
+      y.command(
+        'unset <key>',
+        'Remove a key from the config file',
+        (yy) => yy
+          .positional('key', { type: 'string', describe: 'Config key to remove' }),
+        (argv) => configUnsetCommand(argv),
+      )
+      y.demandCommand(1, 'Specify a subcommand: list, get, set, unset')
+    },
+    () => {},
+  )
+
+  // ── update ───────────────────────────────────────────────────────────────────
+  .command(
+    'update',
+    'Check for and install tracker updates',
+    (y) => {
+      y.option('check', {
+        alias:    'c',
+        type:     'boolean',
+        default:  false,
+        describe: 'Only check for updates without installing',
+      })
+    },
+    async (argv) => {
+      if (argv.check) {
+        await updateCheckCommand(argv)
+      } else {
+        await updateCommand(argv)
+      }
+    },
+  )
+
+  // ── login ─────────────────────────────────────────────────────────────────────
+  .command(
+    'login',
+    'Log in to LogTrace and save your license key',
+    (y) => {
+      y.option('key', {
+        alias:    'k',
+        type:     'string',
+        describe: 'Authenticate directly with a license key (for VPS / headless servers)',
+      })
+    },
+    (argv) => loginCommand(argv),
+  )
+
+  // ── future commands registered here in subsequent pasos ─────────────────────
+
+  .demandCommand(1, 'Please specify a command. Use --help to see available commands.')
+  .strict()
+  .help()
+  .wrap(null)
+  .parse()
+
+} // end else (non-interactive mode)
+
+// ── Background update hint (runs after yargs parses + executes the command) ──
+// We defer to next tick so the command output prints first, then the hint.
+process.on('exit', () => {
+  // Only show the hint when stdout is a TTY (suppress in scripts/piped output)
+  if (process.stdout.isTTY) {
+    try {
+      checkUpdateBackground()
+    } catch {
+      // Never crash the CLI on a background check failure
+    }
+  }
+})

package/src/interactive.js

@@ -0,0 +1,384 @@
+/**
+ * packages/cli/src/interactive.js
+ *
+ * tracker — interactive REPL mode.
+ *
+ * Run `tracker` with no arguments to enter this mode.
+ * Commands start with / — e.g. /login, /status, /logs list, /exit
+ */
+
+import readline                                                        from 'node:readline'
+import { existsSync, readFileSync, rmSync }                           from 'node:fs'
+import { homedir }                                                     from 'node:os'
+import { join }                                                        from 'node:path'
+import chalk                                                           from 'chalk'
+import { LOGTRACE_DIR }                                               from '@logtrace/shared/constants'
+import { statusCommand }                                               from './commands/status.js'
+import { logsListCommand, logsSearchCommand }                         from './commands/logs.js'
+import { dockerListCommand, dockerRestartCommand, dockerLogsCommand } from './commands/docker.js'
+import { doctorCommand, healthCommand }                               from './commands/doctor.js'
+import { configListCommand, configGetCommand, configSetCommand, configUnsetCommand } from './commands/config.js'
+import { alertTestCommand }                                           from './commands/alert.js'
+import { updateCommand, updateCheckCommand }                          from './commands/update.js'
+
+const AUTH_FILE = join(homedir(), '.logtrace', 'auth.json')
+
+// -------------------------------------------------------------------
+// Helpers
+// -------------------------------------------------------------------
+
+function _loadAuth() {
+  if (!existsSync(AUTH_FILE)) return null
+  try { return JSON.parse(readFileSync(AUTH_FILE, 'utf8')) } catch { return null }
+}
+
+function _getCentralApiUrl() {
+  if (process.env.CENTRAL_API_URL) return process.env.CENTRAL_API_URL
+  const envPath = join(LOGTRACE_DIR, '.env')
+  if (existsSync(envPath)) {
+    const line = readFileSync(envPath, 'utf8').split('\n').find((l) => l.startsWith('CENTRAL_API_URL='))
+    if (line) return line.slice('CENTRAL_API_URL='.length).trim()
+  }
+  return 'https://api.logtrace.cloud'
+}
+
+// -------------------------------------------------------------------
+// Banner
+// -------------------------------------------------------------------
+
+function _banner() {
+  const auth = _loadAuth()
+  console.log()
+  console.log(chalk.bold.white('  LogTrace') + chalk.dim(' · tracker v0.1.0'))
+  if (auth) {
+    console.log(
+      chalk.dim('  ') + chalk.green('●') +
+      chalk.dim(` Logged in as `) + chalk.white(auth.email) +
+      chalk.dim(` · Plan: ${auth.plan}`),
+    )
+  } else {
+    console.log(chalk.dim('  ○ Not logged in — type ') + chalk.cyan('/login') + chalk.dim(' to authenticate'))
+  }
+  console.log(chalk.dim('  Type /help for commands, /exit to quit'))
+  console.log()
+}
+
+// -------------------------------------------------------------------
+// /help
+// -------------------------------------------------------------------
+
+function _showHelp() {
+  console.log()
+  const row = (cmd, desc) =>
+    console.log('  ' + chalk.cyan(cmd.padEnd(28)) + chalk.dim(desc))
+
+  row('/login',                    'Authenticate with license key or browser')
+  row('/logout',                   'Remove saved credentials')
+  row('/status',                   'Daemon status — uptime, modules, version')
+  row('/doctor',                   'Full system diagnostic with all checks')
+  row('/health',                   'Show only warnings and critical issues')
+  row('/logs list',                'List recent logs (add --level, --service, --limit)')
+  row('/logs search <query>',      'Search logs by keyword')
+  row('/docker list',              'List all Docker containers')
+  row('/docker restart <name>',    'Restart a container')
+  row('/docker logs <name>',       'Tail container output')
+  row('/config list',              'Show all config keys (masked)')
+  row('/config get <key>',         'Get exact value for a key')
+  row('/config set <key> <value>', 'Set a config key')
+  row('/config unset <key>',       'Remove a config key')
+  row('/alert test',               'Send a test alert')
+  row('/update',                   'Check for and install updates')
+  row('/exit',                     'Exit tracker')
+  console.log()
+}
+
+// -------------------------------------------------------------------
+// Flag parser
+// -------------------------------------------------------------------
+
+function _parseFlags(parts) {
+  const out = {}
+  for (let i = 0; i < parts.length; i++) {
+    const p = parts[i]
+    if (p.startsWith('--') || p.startsWith('-')) {
+      const key = p.replace(/^-+/, '')
+      const val = parts[i + 1] && !parts[i + 1].startsWith('-') ? parts[++i] : true
+      out[key] = val
+    }
+  }
+  return out
+}
+
+// -------------------------------------------------------------------
+// Command dispatcher (normal state)
+// -------------------------------------------------------------------
+
+async function _dispatch(input) {
+  if (!input.startsWith('/')) {
+    console.log(chalk.dim('\n  Commands start with /  ·  try /help\n'))
+    return
+  }
+
+  const parts = input.slice(1).trim().split(/\s+/)
+  const cmd   = parts[0].toLowerCase()
+  const args  = parts.slice(1)
+
+  console.log()
+
+  switch (cmd) {
+    case 'help':
+      _showHelp()
+      return
+
+    case 'login':
+      return 'START_LOGIN'
+
+    case 'logout':
+      if (!existsSync(AUTH_FILE)) {
+        console.log(chalk.dim('  Not logged in.\n'))
+      } else {
+        rmSync(AUTH_FILE)
+        console.log(chalk.green('  ✓ Logged out.\n'))
+      }
+      return
+
+    case 'status':
+      await statusCommand({})
+      console.log()
+      return
+
+    case 'doctor':
+      await doctorCommand({})
+      console.log()
+      return
+
+    case 'health':
+      await healthCommand({})
+      console.log()
+      return
+
+    case 'logs': {
+      const sub = args[0]?.toLowerCase()
+      if (sub === 'list' || !sub) {
+        const opts = _parseFlags(args.slice(sub ? 1 : 0))
+        await logsListCommand({ level: opts.level || opts.l, service: opts.service || opts.s, limit: Number(opts.limit || opts.n) || 20, from: opts.from || opts.f })
+      } else if (sub === 'search') {
+        const query = args.slice(1).join(' ')
+        if (!query) { console.log(chalk.yellow('  Usage: /logs search <query>\n')); return }
+        await logsSearchCommand({ query, limit: 20 })
+      } else {
+        console.log(chalk.dim('  Usage: /logs list  ·  /logs search <query>\n'))
+      }
+      console.log()
+      return
+    }
+
+    case 'docker': {
+      const sub = args[0]?.toLowerCase()
+      if (sub === 'list' || !sub) {
+        await dockerListCommand({})
+      } else if (sub === 'restart') {
+        if (!args[1]) { console.log(chalk.yellow('  Usage: /docker restart <name>\n')); return }
+        await dockerRestartCommand({ name: args[1] })
+      } else if (sub === 'logs') {
+        if (!args[1]) { console.log(chalk.yellow('  Usage: /docker logs <name>\n')); return }
+        await dockerLogsCommand({ name: args[1], tail: Number(args[2]) || 50 })
+      } else {
+        console.log(chalk.dim('  Usage: /docker list  ·  /docker restart <name>  ·  /docker logs <name>\n'))
+      }
+      console.log()
+      return
+    }
+
+    case 'config': {
+      const sub = args[0]?.toLowerCase()
+      if (sub === 'list' || !sub) {
+        await configListCommand({})
+      } else if (sub === 'get') {
+        if (!args[1]) { console.log(chalk.yellow('  Usage: /config get <key>\n')); return }
+        await configGetCommand({ key: args[1] })
+      } else if (sub === 'set') {
+        if (!args[1] || !args[2]) { console.log(chalk.yellow('  Usage: /config set <key> <value>\n')); return }
+        await configSetCommand({ key: args[1], value: args.slice(2).join(' ') })
+      } else if (sub === 'unset') {
+        if (!args[1]) { console.log(chalk.yellow('  Usage: /config unset <key>\n')); return }
+        await configUnsetCommand({ key: args[1] })
+      } else {
+        console.log(chalk.dim('  Usage: /config list  ·  /config get <key>  ·  /config set <key> <value>\n'))
+      }
+      console.log()
+      return
+    }
+
+    case 'alert': {
+      const sub = args[0]?.toLowerCase()
+      if (sub === 'test') {
+        await alertTestCommand({})
+      } else {
+        console.log(chalk.dim('  Usage: /alert test\n'))
+      }
+      console.log()
+      return
+    }
+
+    case 'update': {
+      const checkOnly = args.includes('--check') || args.includes('-c')
+      await (checkOnly ? updateCheckCommand({}) : updateCommand({}))
+      console.log()
+      return
+    }
+
+    case 'exit':
+    case 'quit':
+    case 'q':
+      console.log(chalk.dim('  Bye!\n'))
+      process.exit(0)
+      return
+
+    default:
+      console.log(chalk.dim(`  Unknown command: /${cmd}  ·  type /help\n`))
+  }
+}
+
+// -------------------------------------------------------------------
+// Login state machine (runs inside the main queue)
+// -------------------------------------------------------------------
+//
+// All lines go through a single sequential queue. When _loginState is
+// not null, lines are routed to the login handler instead of dispatch.
+// This avoids the race between registering a new listener and the next
+// piped line arriving.
+
+const S = { NORMAL: 'NORMAL', METHOD: 'METHOD', KEY: 'KEY', BROWSER: 'BROWSER' }
+
+async function _loginHandleLine(line, state) {
+  const val = line.trim()
+
+  if (state.step === S.METHOD) {
+    if (val === '2') {
+      // Browser flow
+      state.step = S.BROWSER
+      process.stdout.write('\n')
+      const { loginCommand } = await import('./commands/login.js')
+      await loginCommand({})
+      return true // done
+    }
+    // Key flow (choice '1' or anything else)
+    state.step = S.KEY
+    process.stdout.write(chalk.dim('\n  License key: '))
+    return false // need one more line
+  }
+
+  if (state.step === S.KEY) {
+    process.stdout.write('\n')
+    if (!val) {
+      console.log(chalk.yellow('  No key entered.\n'))
+      return true
+    }
+    await _doKeyLogin(val)
+    return true // done
+  }
+
+  return true
+}
+
+function _showLoginPrompt() {
+  console.log()
+  console.log(chalk.dim('  How do you want to log in?'))
+  console.log('  ' + chalk.cyan('1') + chalk.dim(' · Paste license key  (VPS / servers)'))
+  console.log('  ' + chalk.cyan('2') + chalk.dim(' · Open browser       (laptop / desktop)'))
+  console.log()
+  process.stdout.write(chalk.dim('  Choice: '))
+}
+
+async function _doKeyLogin(key) {
+  const CENTRAL_API_URL = _getCentralApiUrl()
+  const isTTY = process.stdout.isTTY
+  process.stdout.write(chalk.dim('  Verifying...') + (isTTY ? '' : '\n'))
+  try {
+    const res  = await fetch(`${CENTRAL_API_URL}/api/v1/cli/auth/key-login/`, {
+      method:  'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body:    JSON.stringify({ license_key: key }),
+    })
+    const data = await res.json()
+    if (!res.ok) {
+      console.log((isTTY ? '\r' : '') + chalk.red(`  ✗ ${data.message || 'Invalid license key.'}\n`))
+      return
+    }
+    const { _saveAuthData, _writeKeyToEnv } = await import('./commands/login.js')
+    _saveAuthData(data)
+    _writeKeyToEnv(data.license_key)
+    console.log((isTTY ? '\r' : '') + chalk.green(`  ✓ Logged in as ${data.user.email}`) + chalk.dim(` · Plan: ${data.user.plan}\n`))
+  } catch (err) {
+    console.log((isTTY ? '\r' : '') + chalk.red(`  ✗ Network error: ${err.message}\n`))
+  }
+}
+
+// -------------------------------------------------------------------
+// Main REPL entry point
+// -------------------------------------------------------------------
+
+export async function startInteractive() {
+  _banner()
+
+  const rl = readline.createInterface({
+    input:  process.stdin,
+    output: process.stdout,
+    prompt: chalk.cyan('logtrace') + chalk.dim(' › '),
+  })
+
+  const prompt = () => { try { rl.prompt() } catch { /* readline closed */ } }
+  prompt()
+
+  // All lines go through one sequential queue — no concurrency, no races
+  let _queue    = Promise.resolve()
+  let _loginState = null  // null = normal, or { step: S.METHOD|S.KEY }
+
+  rl.on('line', (line) => {
+    _queue = _queue.then(async () => {
+      const input = line.trim()
+
+      // ── Login state machine ─────────────────────────────────────
+      if (_loginState !== null) {
+        const done = await _loginHandleLine(line, _loginState)
+        if (done) {
+          _loginState = null
+          prompt()
+        }
+        // if not done, don't prompt — waiting for next line
+        return
+      }
+
+      // ── Normal dispatch ─────────────────────────────────────────
+      if (!input) {
+        prompt()
+        return
+      }
+
+      try {
+        const result = await _dispatch(input)
+        if (result === 'START_LOGIN') {
+          _loginState = { step: S.METHOD }
+          _showLoginPrompt()
+          // No prompt() here — login machine will prompt when done
+        } else {
+          prompt()
+        }
+      } catch (err) {
+        console.log(chalk.red(`\n  Error: ${err.message}\n`))
+        prompt()
+      }
+    })
+  })
+
+  rl.on('SIGINT', () => {
+    console.log(chalk.dim('\n  Bye!'))
+    process.exit(0)
+  })
+
+  // When stdin closes (Ctrl+D or EOF from a pipe), drain the queue first
+  rl.on('close', () => {
+    _queue.then(() => process.exit(0))
+  })
+}