hermium 0.1.10 → 0.3.0

package/README.md

@@ -0,0 +1,56 @@
+# Hermium CLI
+
+Self-hosted AI chat dashboard for Hermes Agent.
+
+## Install
+
+```bash
+npm install -g hermium
+```
+
+Or with Bun:
+
+```bash
+bun install -g hermium
+```
+
+## Requirements
+
+- [Bun](https://bun.sh) >= 1.2
+
+## Commands
+
+```bash
+hermium start          # Start the server (daemon)
+hermium stop             # Stop the server
+hermium restart          # Restart the server
+hermium status           # Show running status
+hermium build            # Build from source (requires repo)
+hermium dev              # Run in dev mode (requires repo)
+hermium help             # Show help
+hermium version          # Show version
+```
+
+## Options
+
+```bash
+hermium start --port 47474    # Custom port (default: 47474)
+```
+
+## Development
+
+To run from source:
+
+```bash
+git clone https://github.com/abboskhonov/hermium.git
+cd hermium
+bun install
+bun run dev
+```
+
+To build the CLI package for publishing:
+
+```bash
+cd packages/cli
+bun run build
+```

package/bin/hermium.mjs

@@ -2,7 +2,7 @@
 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 { readFileSync, writeFileSync, unlinkSync, mkdirSync, existsSync, statSync, openSync } from 'fs'
 import { homedir } from 'os'
 import pc from 'picocolors'
 
@@ -10,15 +10,9 @@ const pkgDir = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const pkg = JSON.parse(readFileSync(resolve(pkgDir, 'package.json'), 'utf-8'))
 const CURRENT_VERSION = pkg.version
 
-const __dirname = dirname(fileURLToPath(import.meta.url))
-const apiEntry = resolve(pkgDir, 'dist', 'server', 'index.mjs')
-const webEntry = resolve(pkgDir, 'dist', 'web-server', 'index.mjs')
-const webServerDir = resolve(pkgDir, 'dist', 'web-server')
-const WEB_UI_HOME = resolve(homedir(), '.hermium')
-const API_PID_FILE = join(WEB_UI_HOME, 'api.pid')
-const WEB_PID_FILE = join(WEB_UI_HOME, 'web.pid')
-const API_LOG_FILE = join(WEB_UI_HOME, 'api.log')
-const WEB_LOG_FILE = join(WEB_UI_HOME, 'web.log')
+const HERMIUM_HOME = resolve(homedir(), '.hermium')
+const PID_FILE = join(HERMIUM_HOME, 'hermium.pid')
+const LOG_FILE = join(HERMIUM_HOME, 'hermium.log')
 const DEFAULT_API_PORT = 47474
 const DEFAULT_WEB_PORT = 42424
 
@@ -44,7 +38,7 @@ function getRuntimeCmd() {
 // ─── Version check ─────────────────────────────────────────────────────────
 
 async function checkLatestVersion() {
-  const cacheFile = join(WEB_UI_HOME, '.version-check')
+  const cacheFile = join(HERMIUM_HOME, '.version-check')
   const now = Date.now()
   try {
     const cache = JSON.parse(readFileSync(cacheFile, 'utf-8'))
@@ -74,16 +68,18 @@ async function checkLatestVersion() {
 
 // ─── Helpers ───────────────────────────────────────────────────────────────
 
-function readPid(file) {
+function readPid() {
   try {
-    const pid = parseInt(readFileSync(file, 'utf-8').trim())
-    return Number.isFinite(pid) ? pid : null
+    const raw = readFileSync(PID_FILE, 'utf-8').trim()
+    const [apiPid, webPid] = raw.split(',').map(s => parseInt(s.trim()))
+    return { apiPid: Number.isFinite(apiPid) ? apiPid : null, webPid: Number.isFinite(webPid) ? webPid : null }
   } catch {
-    return null
+    return { apiPid: null, webPid: null }
   }
 }
 
 function isRunning(pid) {
+  if (!pid) return false
   try {
     process.kill(pid, 0)
     return true
@@ -92,130 +88,136 @@ function isRunning(pid) {
   }
 }
 
-function writePid(file, pid) {
-  mkdirSync(WEB_UI_HOME, { recursive: true })
-  writeFileSync(file, String(pid))
+function getPids() {
+  const { apiPid, webPid } = readPid()
+  const apiRunning = apiPid && isRunning(apiPid)
+  const webRunning = webPid && isRunning(webPid)
+  if (!apiRunning && !webRunning) {
+    removePid()
+    return { apiPid: null, webPid: null }
+  }
+  return { apiPid: apiRunning ? apiPid : null, webPid: webRunning ? webPid : null }
 }
 
-function removePid(file) {
-  try { unlinkSync(file) } catch {}
+function writePid(apiPid, webPid) {
+  mkdirSync(HERMIUM_HOME, { recursive: true })
+  writeFileSync(PID_FILE, `${apiPid},${webPid}`)
 }
 
-function getPid(file) {
-  const pid = readPid(file)
-  if (pid && isRunning(pid)) return pid
-  removePid(file)
-  return null
+function removePid() {
+  try { unlinkSync(PID_FILE) } catch {}
 }
 
-function getApiPid() { return getPid(API_PID_FILE) }
-function getWebPid() { return getPid(WEB_PID_FILE) }
+function getApiPort() {
+  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
+  }
+  return DEFAULT_API_PORT
+}
 
-function getPort(argName, defaultPort) {
-  const idx = process.argv.indexOf(argName)
+function getWebPort() {
+  const idx = process.argv.indexOf('--web-port')
   if (idx !== -1 && process.argv[idx + 1]) {
     const p = parseInt(process.argv[idx + 1])
     if (!isNaN(p)) return p
   }
-  return defaultPort
+  return DEFAULT_WEB_PORT
 }
 
-function getRunningPort(pid) {
-  if (!pid) return null
+function rotateLog() {
   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)
+    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(`  ↻ Rotated ${LOG_FILE.replace(homedir(), '~')}`))
     }
   } catch {}
-  return null
 }
 
-function rotateLog(file) {
+function stopPid(pid) {
+  if (!pid) return false
   try {
-    const st = statSync(file)
-    if (st.size > 3 * 1024 * 1024) {
-      const content = readFileSync(file, 'utf-8')
-      const kept = content.split('\n').slice(-2000)
-      writeFileSync(file, kept.join('\n'))
-      console.log(pc.cyan(`  ↻ Rotated ${file.replace(homedir(), '~')}`))
+    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)
     }
-  } catch {}
+    if (isRunning(pid)) process.kill(pid, 'SIGKILL')
+    return true
+  } catch {
+    return true
+  }
 }
 
-function spawnServer({ name, entry, logFile, pidFile, port, env, runtime, cwd }) {
+function spawnServer({ name, entry, logFile, env, runtime }) {
   if (!existsSync(entry)) {
     console.log(pc.red(`  ✗ ${name} not found: ${entry}`))
     console.log(`    Run "hermium build" first (or check your installation)`)
     process.exit(1)
   }
 
-  rotateLog(logFile)
+  rotateLog()
 
   const logFd = openSync(logFile, 'a')
   const child = spawn(runtime, [entry], {
     detached: true,
     stdio: ['ignore', logFd, logFd],
     env: { ...process.env, ...env, NODE_ENV: 'production' },
-    cwd: cwd || dirname(entry),
+    cwd: dirname(entry),
   })
 
   child.on('error', (err) => {
     console.error(pc.red(`  ✗ Failed to start ${name}: ${err.message}`))
-    removePid(pidFile)
+    removePid()
     process.exit(1)
   })
 
   child.unref()
-  writePid(pidFile, child.pid)
   return child.pid
 }
 
-function stopPid(pid, name) {
-  if (!pid) return false
-  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')
-    return true
-  } catch {
-    return true
-  }
+// ─── Path resolution ───────────────────────────────────────────────────────
+
+function findApiEntry() {
+  const bundled = resolve(pkgDir, 'dist', 'api.mjs')
+  if (existsSync(bundled)) return bundled
+
+  const monorepo = resolve(pkgDir, '..', '..', 'packages', 'api', 'dist', 'index.js')
+  if (existsSync(monorepo)) return monorepo
+
+  return null
+}
+
+function findWebServer() {
+  const bundled = resolve(pkgDir, 'dist', 'server', 'index.mjs')
+  if (existsSync(bundled)) return bundled
+
+  const monorepo = resolve(pkgDir, '..', '..', 'packages', 'web', '.output', 'server', 'index.mjs')
+  if (existsSync(monorepo)) return monorepo
+
+  return null
 }
 
 // ─── Commands ──────────────────────────────────────────────────────────────
 
 function cmdStatus() {
-  const apiPid = getApiPid()
-  const webPid = getWebPid()
-  const apiPort = apiPid ? getRunningPort(apiPid) : null
-  const webPort = webPid ? getRunningPort(webPid) : null
-
+  const { apiPid, webPid } = getPids()
   if (apiPid || webPid) {
     console.log(pc.green(`  ✓ Hermium is running`))
-    if (apiPid) console.log(`    API  : PID ${apiPid}, port ${apiPort || 'unknown'}`)
-    if (webPid) console.log(`    Web  : PID ${webPid}, port ${webPort || 'unknown'}`)
-    console.log(`    Logs : ${WEB_UI_HOME}`)
+    if (apiPid) console.log(`    API  : PID ${apiPid}, port ${getApiPort()}`)
+    if (webPid) console.log(`    Web  : PID ${webPid}, port ${getWebPort()}`)
+    console.log(`    Logs : ${LOG_FILE.replace(homedir(), '~')}`)
   } else {
     console.log(pc.yellow(`  ⊘ Hermium is not running`))
   }
 }
 
 async function cmdStart() {
-  const existingApi = getApiPid()
-  const existingWeb = getWebPid()
+  const { apiPid: existingApi, webPid: existingWeb } = getPids()
   if (existingApi || existingWeb) {
     console.log(pc.yellow(`  ✗ Hermium is already running`))
     if (existingApi) console.log(`    API PID: ${existingApi}`)
@@ -224,80 +226,91 @@ async function cmdStart() {
     process.exit(1)
   }
 
-  const apiPort = getPort('--port', DEFAULT_API_PORT)
-  const webPort = getPort('--web-port', DEFAULT_WEB_PORT)
+  const apiPort = getApiPort()
+  const webPort = getWebPort()
   const runtime = getRuntimeCmd()
+  const apiEntry = findApiEntry()
+  const webServer = findWebServer()
 
-  mkdirSync(WEB_UI_HOME, { recursive: true })
+  if (!apiEntry) {
+    console.log(pc.red(`  ✗ API server not found. Run "hermium build" first.`))
+    process.exit(1)
+  }
 
-  console.log(pc.cyan(`  ⏳ Starting Hermium (API:${apiPort}, Web:${webPort})...`))
+  if (!webServer) {
+    console.log(pc.red(`  ✗ Web server not found. Run "hermium build" first.`))
+    process.exit(1)
+  }
+
+  mkdirSync(HERMIUM_HOME, { recursive: true })
+
+  console.log(pc.cyan(`  ⏳ Starting Hermium...`))
 
-  // 1. Start API server
   const apiPid = spawnServer({
     name: 'API server',
     entry: apiEntry,
-    logFile: API_LOG_FILE,
-    pidFile: API_PID_FILE,
-    port: apiPort,
+    logFile: LOG_FILE,
     runtime,
     env: {
-      HERMIUM_PORT: String(apiPort),
-      HERMIUM_WEB_PORT: String(webPort),
-      HERMIUM_VERSION: CURRENT_VERSION,
-      WEB_STATIC_DIR: resolve(pkgDir, 'dist', 'public'),
+      PORT: String(apiPort),
+      APP_VERSION: CURRENT_VERSION,
+      AUTH_DISABLED: '1',
     },
   })
 
-  // 2. Start web SSR server
   const webPid = spawnServer({
     name: 'Web server',
-    entry: webEntry,
-    logFile: WEB_LOG_FILE,
-    pidFile: WEB_PID_FILE,
-    port: webPort,
+    entry: webServer,
+    logFile: LOG_FILE,
     runtime,
-    cwd: webServerDir,
-    env: { PORT: String(webPort) },
+    env: {
+      PORT: String(webPort),
+      NITRO_PORT: String(webPort),
+      HERMIUM_API_URL: `http://127.0.0.1:${apiPort}`,
+      APP_VERSION: CURRENT_VERSION,
+    },
   })
 
-  console.log(`  API  PID: ${apiPid}`)
-  console.log(`  Web  PID: ${webPid}`)
+  writePid(apiPid, webPid)
+
+  console.log(`  API  PID: ${apiPid}  (port ${apiPort})`)
+  console.log(`  Web  PID: ${webPid}  (port ${webPort})`)
 
-  // Poll web server health
+  // Poll health
   const maxWait = 30000
   const interval = 500
   let waited = 0
-  const webUrl = `http://localhost:${webPort}`
+  const apiUrl = `http://127.0.0.1:${apiPort}`
+  const webUrl = `http://127.0.0.1:${webPort}`
 
   function poll() {
     waited += interval
 
-    if (!isRunning(apiPid)) {
-      console.log(pc.red(`  ✗ API server crashed`))
-      console.log(`    Check log: ${API_LOG_FILE}`)
-      stopPid(webPid, 'web')
-      removePid(API_PID_FILE)
-      removePid(WEB_PID_FILE)
-      process.exit(1)
-    }
-    if (!isRunning(webPid)) {
-      console.log(pc.red(`  ✗ Web server crashed`))
-      console.log(`    Check log: ${WEB_LOG_FILE}`)
-      stopPid(apiPid, 'api')
-      removePid(API_PID_FILE)
-      removePid(WEB_PID_FILE)
+    if (!isRunning(apiPid) || !isRunning(webPid)) {
+      console.log(pc.red(`  ✗ Server crashed`))
+      console.log(`    Check log: ${LOG_FILE}`)
+      removePid()
       process.exit(1)
     }
 
-    fetch(`${webUrl}/api/health`).catch(() => null).then((res) => {
-      // Web server doesn't have /api/health, this will 404 but we just want to check it's listening
-      if (waited < maxWait) {
-        setTimeout(poll, interval)
+    fetch(`${apiUrl}/api/hermes/sessions`).catch(() => null).then((res) => {
+      if (!res || !res.ok) {
+        if (waited < maxWait) {
+          setTimeout(poll, interval)
+        } else {
+          console.log(pc.green(`  ✓ Hermium started`))
+          console.log(`    API : ${apiUrl}`)
+          console.log(`    Web : ${webUrl}`)
+          console.log(`    Logs: ${LOG_FILE.replace(homedir(), '~')}`)
+          checkLatestVersion()
+        }
       } else {
         console.log(pc.green(`  ✓ Hermium started`))
-        console.log(`    ${webUrl}`)
-        console.log(`    Logs: ${WEB_UI_HOME}`)
-        checkLatestVersion() // non-blocking
+        console.log(`    API : ${apiUrl}`)
+        console.log(`    Web : ${webUrl}`)
+        console.log(`    Logs: ${LOG_FILE.replace(homedir(), '~')}`)
+        checkLatestVersion()
+        // Open browser
         const openCmd =
           process.platform === 'win32' ? `start ${webUrl}` :
           process.platform === 'darwin' ? `open ${webUrl}` :
@@ -311,24 +324,21 @@ async function cmdStart() {
 }
 
 function cmdStop() {
-  const apiPid = getApiPid()
-  const webPid = getWebPid()
-
+  const { apiPid, webPid } = getPids()
   if (!apiPid && !webPid) {
     console.log(pc.yellow(`  ⊘ Hermium is not running`))
     return
   }
 
   if (webPid) {
-    stopPid(webPid, 'web')
-    removePid(WEB_PID_FILE)
+    stopPid(webPid)
     console.log(pc.green(`  ✓ Web server stopped (PID: ${webPid})`))
   }
   if (apiPid) {
-    stopPid(apiPid, 'api')
-    removePid(API_PID_FILE)
+    stopPid(apiPid)
     console.log(pc.green(`  ✓ API server stopped (PID: ${apiPid})`))
   }
+  removePid()
 }
 
 function cmdRestart() {
@@ -337,6 +347,53 @@ function cmdRestart() {
   cmdStart()
 }
 
+function cmdBuild() {
+  console.log(pc.cyan(`  🔨 Building Hermium...`))
+  const runtime = getRuntimeCmd()
+
+  const rootDir = resolve(pkgDir, '..', '..')
+  const isMonorepo = existsSync(resolve(rootDir, 'packages', 'api')) && existsSync(resolve(rootDir, 'packages', 'web'))
+
+  if (!isMonorepo) {
+    console.log(pc.yellow(`  ⚠ Not in a monorepo. Build must be done from the Hermium source repository.`))
+    process.exit(1)
+  }
+
+  try {
+    console.log(`  → Building shared...`)
+    execSync(`${runtime} run build:shared`, { cwd: rootDir, stdio: 'inherit' })
+    console.log(`  → Building API...`)
+    execSync(`${runtime} run build:api`, { cwd: rootDir, stdio: 'inherit' })
+    console.log(`  → Building Web...`)
+    execSync(`${runtime} run build:web`, { cwd: rootDir, stdio: 'inherit' })
+    console.log(`  → Building CLI...`)
+    execSync(`${runtime} run build:cli`, { cwd: rootDir, stdio: 'inherit' })
+    console.log(pc.green(`  ✓ Build complete`))
+  } catch (err) {
+    console.log(pc.red(`  ✗ Build failed`))
+    process.exit(1)
+  }
+}
+
+function cmdDev() {
+  console.log(pc.cyan(`  🔥 Starting Hermium in dev mode...`))
+  const runtime = getRuntimeCmd()
+
+  const rootDir = resolve(pkgDir, '..', '..')
+  const isMonorepo = existsSync(resolve(rootDir, 'packages', 'api')) && existsSync(resolve(rootDir, 'packages', 'web'))
+
+  if (!isMonorepo) {
+    console.log(pc.yellow(`  ⚠ Not in a monorepo. Dev mode must be run from the Hermium source repository.`))
+    process.exit(1)
+  }
+
+  try {
+    execSync(`${runtime} run dev`, { cwd: rootDir, stdio: 'inherit' })
+  } catch {
+    process.exit(1)
+  }
+}
+
 function cmdHelp() {
   console.log(`
 ${pc.bold('Hermium CLI')} — Self-hosted AI chat for Hermes Agent
@@ -349,11 +406,14 @@ ${pc.bold('Commands:')}
   stop       Stop Hermium servers
   restart    Restart Hermium servers
   status     Show running status
+  build      Build from source (requires repo)
+  dev        Run in dev mode (requires repo)
   help       Show this help message
+  version    Show version
 
 ${pc.bold('Options:')}
-  --port <n>      API port (default: 47474)
-  --web-port <n>  Web port (default: 42424)
+  --port <n>      API server port (default: 47474)
+  --web-port <n>  Web server port (default: 42424)
 
 ${pc.bold('Examples:')}
   hermium start
@@ -364,8 +424,7 @@ ${pc.bold('Examples:')}
 }
 
 function cmdVersion() {
-  const pkg = JSON.parse(readFileSync(resolve(pkgDir, 'package.json'), 'utf-8'))
-  console.log(pkg.version)
+  console.log(CURRENT_VERSION)
 }
 
 // ─── Entrypoint ─────────────────────────────────────────────────────────────
@@ -385,6 +444,12 @@ switch (command) {
   case 'status':
     cmdStatus()
     break
+  case 'build':
+    cmdBuild()
+    break
+  case 'dev':
+    cmdDev()
+    break
   case 'version':
   case '--version':
   case '-v':