hermium 0.1.0

package/bin/hermium.mjs

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+import { spawn, execSync } from 'child_process'
+import { resolve, dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+import { readFileSync, writeFileSync, unlinkSync, mkdirSync, openSync, existsSync, statSync } from 'fs'
+import { homedir } from 'os'
+import pc from 'picocolors'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const pkgDir = resolve(__dirname, '..')
+const serverEntry = resolve(pkgDir, 'dist', 'server', 'index.mjs')
+const WEB_UI_HOME = resolve(homedir(), '.hermium')
+const PID_FILE = join(WEB_UI_HOME, 'server.pid')
+const LOG_FILE = join(WEB_UI_HOME, 'server.log')
+const DEFAULT_PORT = 8788
+
+// ─── Helpers ───────────────────────────────────────────────────────────────
+
+function readPid() {
+  try {
+    const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim())
+    return Number.isFinite(pid) ? pid : null
+  } catch {
+    return null
+  }
+}
+
+function isRunning(pid) {
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch (err) {
+    return err?.code === 'EPERM'
+  }
+}
+
+function writePid(pid) {
+  mkdirSync(WEB_UI_HOME, { recursive: true })
+  writeFileSync(PID_FILE, String(pid))
+}
+
+function removePid() {
+  try { unlinkSync(PID_FILE) } catch {}
+}
+
+function getPid() {
+  const pid = readPid()
+  if (pid && isRunning(pid)) return pid
+  removePid()
+  return null
+}
+
+function getPort() {
+  const idx = process.argv.indexOf('--port')
+  if (idx !== -1 && process.argv[idx + 1]) {
+    const p = parseInt(process.argv[idx + 1])
+    if (!isNaN(p)) return p
+  }
+  if (process.env.HERMIUM_PORT && !isNaN(process.env.HERMIUM_PORT)) {
+    return parseInt(process.env.HERMIUM_PORT)
+  }
+  return DEFAULT_PORT
+}
+
+function getRunningPort(pid) {
+  if (!pid) return null
+
+  try {
+    if (process.platform === 'win32') {
+      const out = execSync(`netstat -aon -p tcp | findstr LISTENING | findstr " ${pid}$"`, { encoding: 'utf-8' }).trim()
+      const line = out.split('\n').find(Boolean)
+      const address = line?.trim().split(/\s+/)[1]
+      const port = address?.split(':').pop()
+      return port ? parseInt(port, 10) : null
+    }
+
+    const out = execSync(`lsof -Pan -p ${pid} -iTCP -sTCP:LISTEN`, { encoding: 'utf-8' }).trim()
+    const lines = out.split('\n').slice(1)
+    for (const line of lines) {
+      const match = line.match(/:(\d+)\s+\(LISTEN\)$/)
+      if (match) return parseInt(match[1], 10)
+    }
+  } catch {}
+  return null
+}
+
+// ─── Commands ──────────────────────────────────────────────────────────────
+
+function cmdStatus() {
+  const pid = getPid()
+  if (pid) {
+    const port = getRunningPort(pid)
+    console.log(pc.green(`  ✓ Hermium is running`))
+    console.log(`    PID  : ${pid}`)
+    console.log(`    Port : ${port || 'unknown'}`)
+    console.log(`    Log  : ${LOG_FILE}`)
+  } else {
+    console.log(pc.yellow(`  ⊘ Hermium is not running`))
+  }
+}
+
+function cmdStart() {
+  const existing = getPid()
+  if (existing) {
+    console.log(pc.yellow(`  ✗ Hermium is already running (PID: ${existing})`))
+    console.log(`    Use "hermium stop" to stop it first`)
+    process.exit(1)
+  }
+
+  if (!existsSync(serverEntry)) {
+    console.log(pc.red(`  ✗ Server not found: ${serverEntry}`))
+    console.log(`    Run "hermium build" first (or check your installation)`)
+    process.exit(1)
+  }
+
+  const port = getPort()
+  mkdirSync(WEB_UI_HOME, { recursive: true })
+
+  // Rotate log if over 3 MB
+  try {
+    const st = statSync(LOG_FILE)
+    if (st.size > 3 * 1024 * 1024) {
+      const content = readFileSync(LOG_FILE, 'utf-8')
+      const kept = content.split('\n').slice(-2000)
+      writeFileSync(LOG_FILE, kept.join('\n'))
+      console.log(pc.cyan(`  ↻ Log rotated`))
+    }
+  } catch {}
+
+  const logFd = openSync(LOG_FILE, 'a')
+  const child = spawn(process.execPath, [serverEntry], {
+    detached: true,
+    stdio: ['ignore', logFd, logFd],
+    env: {
+      ...process.env,
+      NODE_ENV: 'production',
+      WEB_STATIC_DIR: resolve(pkgDir, 'dist', 'web'),
+      HERMIUM_PORT: String(port),
+    },
+  })
+
+  child.on('error', (err) => {
+    console.error(pc.red(`  ✗ Failed to start: ${err.message}`))
+    removePid()
+    process.exit(1)
+  })
+
+  child.unref()
+  writePid(child.pid)
+
+  // Poll health endpoint
+  const healthUrl = `http://127.0.0.1:${port}/api/health`
+  const maxWait = 30000
+  const interval = 500
+  let waited = 0
+
+  console.log(pc.cyan(`  ⏳ Starting Hermium (PID: ${child.pid}, port: ${port})...`))
+
+  function poll() {
+    waited += interval
+    if (!isRunning(child.pid)) {
+      console.log(pc.red(`  ✗ Failed to start`))
+      console.log(`    Check log: ${LOG_FILE}`)
+      removePid()
+      process.exit(1)
+    }
+
+    fetch(healthUrl)
+      .then((res) => {
+        if (res.ok) {
+          const url = `http://localhost:${port}`
+          console.log(pc.green(`  ✓ Hermium started`))
+          console.log(`    ${url}`)
+          console.log(`    Log: ${LOG_FILE}`)
+          // Auto-open browser
+          const openCmd =
+            process.platform === 'win32'
+              ? `start ${url}`
+              : process.platform === 'darwin'
+                ? `open ${url}`
+                : `xdg-open ${url}`
+          try {
+            execSync(openCmd, { stdio: 'ignore' })
+          } catch {}
+        } else if (waited < maxWait) {
+          setTimeout(poll, interval)
+        } else {
+          console.log(pc.red(`  ✗ Timed out waiting for server`))
+          console.log(`    Check log: ${LOG_FILE}`)
+          removePid()
+          process.exit(1)
+        }
+      })
+      .catch(() => {
+        if (waited < maxWait) {
+          setTimeout(poll, interval)
+        } else {
+          console.log(pc.red(`  ✗ Timed out waiting for server`))
+          console.log(`    Check log: ${LOG_FILE}`)
+          removePid()
+          process.exit(1)
+        }
+      })
+  }
+
+  setTimeout(poll, interval)
+}
+
+function cmdStop() {
+  const pid = getPid()
+  if (!pid) {
+    console.log(pc.yellow(`  ⊘ Hermium is not running`))
+    return
+  }
+
+  try {
+    process.kill(pid, 'SIGTERM')
+    const start = Date.now()
+    while (isRunning(pid) && Date.now() - start < 5000) {
+      Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100)
+    }
+    if (isRunning(pid)) {
+      process.kill(pid, 'SIGKILL')
+    }
+    removePid()
+    console.log(pc.green(`  ✓ Hermium stopped (PID: ${pid})`))
+  } catch {
+    removePid()
+    console.log(pc.green(`  ✓ Hermium stopped (PID: ${pid})`))
+  }
+}
+
+function cmdRestart() {
+  cmdStop()
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 500)
+  cmdStart()
+}
+
+function cmdHelp() {
+  console.log(`
+${pc.bold('Hermium CLI')} — Self-hosted AI chat for Hermes Agent
+
+${pc.bold('Usage:')}
+  hermium <command> [options]
+
+${pc.bold('Commands:')}
+  start      Start Hermium server (daemon)
+  stop       Stop Hermium server
+  restart    Restart Hermium server
+  status     Show running status
+  help       Show this help message
+
+${pc.bold('Options:')}
+  --port <n>  Port to run on (default: 8788)
+
+${pc.bold('Examples:')}
+  hermium start
+  hermium start --port 3000
+  hermium stop
+  hermium status
+`)
+}
+
+// ─── Entrypoint ─────────────────────────────────────────────────────────────
+
+const command = process.argv[2] || 'help'
+
+switch (command) {
+  case 'start':
+    cmdStart()
+    break
+  case 'stop':
+    cmdStop()
+    break
+  case 'restart':
+    cmdRestart()
+    break
+  case 'status':
+    cmdStatus()
+    break
+  case 'help':
+  case '--help':
+  case '-h':
+    cmdHelp()
+    break
+  default:
+    console.log(pc.red(`  ✗ Unknown command: ${command}`))
+    console.log(`    Run "hermium help" for usage`)
+    process.exit(1)
+}