mio-agent-runtime 0.5.9 → 0.5.10

package/README.md

@@ -54,6 +54,8 @@ Restart your agent after install. That's it.
 | `mio init` | Create `~/.mio-intelligence` and default config |
 | `mio install <host>` | Wire MCP + rules + observer into a host |
 | `mio uninstall <host>` | Remove Mio MCP, rules, approvals, and observer from a host |
+| `mio upgrade` | Upgrade Mio via npm and re-wire all installed hosts to the new server |
+| `mio doctor` | Diagnose install/runtime issues: hosts, observer, version drift, PATH |
 | `mio mcp` | Start MCP server (stdio, for agent integration) |
 | `mio status` | Show runtime state, adapter status, observer PID |
 | `mio agents` | List installed hosts |
@@ -239,6 +241,7 @@ WorkBuddy ─┘       + Observer ......... automatic data collection
 | >= 0.5.0 | Idea generation + evolution suggestions |
 | >= 0.5.6 | Rewritten documentation |
 | >= 0.5.9 | `mio uninstall <host>` command |
+| >= 0.5.10 | `mio upgrade` and `mio doctor` commands |
 
 ---
 

package/bin/mio.js

@@ -4,6 +4,7 @@
 const fs = require('fs')
 const path = require('path')
 const os = require('os')
+const { spawnSync } = require('child_process')
 
 const SERVER_SCRIPT = path.resolve(__dirname, '..', 'server', 'mio-intelligence-mcp', 'index.js')
 const MIO_HOME = process.env.MIO_HOME || path.join(os.homedir(), '.mio-intelligence')
@@ -262,6 +263,99 @@ function uninstallCommand(host, useJson) {
   console.log(result.message || `${host} adapter removed.`)
 }
 
+function runNpm(args) {
+  try {
+    const res = spawnSync('npm', args, { encoding: 'utf8', shell: true, windowsHide: true })
+    if (res.error) return { ok: false, error: res.error.message, stdout: '', stderr: '' }
+    return { ok: true, status: res.status, stdout: res.stdout || '', stderr: res.stderr || '' }
+  } catch (e) {
+    return { ok: false, error: e.message, stdout: '', stderr: '' }
+  }
+}
+
+function npmGlobalVersion() {
+  const r = runNpm(['ls', '-g', 'mio-agent-runtime'])
+  const m = r.stdout && r.stdout.match(/mio-agent-runtime@(\d+\.\d+\.\d+)/)
+  return m ? m[1] : null
+}
+
+function npmLatestVersion() {
+  const r = runNpm(['view', 'mio-agent-runtime', 'version'])
+  const m = r.stdout && r.stdout.trim().match(/(\d+\.\d+\.\d+)/)
+  return m ? m[1] : null
+}
+
+function upgradeCommand(useJson) {
+  const before = npmGlobalVersion()
+  const installRes = runNpm(['install', '-g', 'mio-agent-runtime@latest'])
+  if (!installRes.ok || installRes.status !== 0) {
+    const msg = 'npm install failed: ' + (installRes.error || installRes.stderr || 'unknown error')
+    if (useJson) return jsonOrText({ ok: false, error: msg }, true)
+    console.error(msg)
+    process.exitCode = 1
+    return
+  }
+  const after = npmGlobalVersion()
+  const prefix = (() => { const r = runNpm(['config', 'get', 'prefix']); return r.stdout ? r.stdout.trim() : '' })()
+  const isWin = process.platform === 'win32'
+  const globalServer = prefix ? path.join(prefix, 'node_modules', 'mio-agent-runtime', 'server', 'mio-intelligence-mcp', 'index.js') : SERVER_SCRIPT
+  const globalNode = prefix ? (isWin ? path.join(prefix, 'node.exe') : path.join(prefix, 'bin', 'node')) : process.execPath
+  const nodeBin = fs.existsSync(globalNode) ? globalNode : process.execPath
+  const config = readConfig()
+  const hosts = Object.keys(config.agents || {})
+  const rewired = []
+  for (const host of hosts) {
+    const adapter = adapters[host]
+    if (!adapter) continue
+    try {
+      const result = adapter.install({ node: nodeBin, serverScript: globalServer, home: MIO_HOME, workspace: process.cwd() })
+      if (result.changed) rewired.push(host)
+    } catch (_) {}
+  }
+  let observerStarted = false
+  try { observerStarted = observer.startBackground(MIO_HOME).started } catch (_) {}
+  const payload = { ok: true, before, after, rewiredHosts: rewired, observerStarted }
+  if (useJson) return jsonOrText(payload, true)
+  console.log('Upgraded Mio: ' + (before || '?') + ' -> ' + (after || '?'))
+  if (rewired.length) console.log('Re-wired hosts: ' + rewired.join(', '))
+  else console.log('All installed hosts already up to date.')
+  console.log(observerStarted ? 'Observer started.' : 'Observer already running.')
+}
+
+function doctorCommand(useJson) {
+  const checks = []
+  function add(name, ok, detail) { checks.push({ name: name, ok: Boolean(ok), detail: detail || '' }) }
+  add('MIO_HOME exists', fs.existsSync(MIO_HOME), MIO_HOME)
+  if (fs.existsSync(MIO_HOME)) {
+    try { fs.accessSync(MIO_HOME, fs.constants.W_OK); add('MIO_HOME writable', true) }
+    catch (_) { add('MIO_HOME writable', false, 'no write permission') }
+  }
+  add('MCP server present', fs.existsSync(SERVER_SCRIPT), SERVER_SCRIPT)
+  for (const host of ['codex', 'opencode', 'workbuddy', 'hermes']) {
+    const adapter = adapters[host]
+    const installed = adapter ? adapter.isInstalled() : false
+    add('host:' + host + ' installed', installed)
+  }
+  const obsRunning = observer.isRunning(MIO_HOME)
+  add('observer running', obsRunning, obsRunning ? 'pid ' + observer.readPid(MIO_HOME) : 'not running')
+  const installed = npmGlobalVersion()
+  const latest = npmLatestVersion()
+  add('npm up to date', installed === latest, 'installed ' + installed + ' / latest ' + latest)
+  const prefix = (() => { const r = runNpm(['config', 'get', 'prefix']); return r.stdout ? r.stdout.trim() : '' })()
+  const execPrefix = path.dirname(process.execPath)
+  add('global bin on PATH', prefix && execPrefix && prefix.toLowerCase() === execPrefix.toLowerCase(), 'npm prefix ' + prefix + ' / node ' + execPrefix)
+  const stray0 = path.join(process.cwd(), '0')
+  add('no stray 0 file', !fs.existsSync(stray0), fs.existsSync(stray0) ? stray0 : '')
+  const failed = checks.filter(function (c) { return !c.ok })
+  const payload = { ok: failed.length === 0, checks: checks, failedCount: failed.length }
+  if (useJson) return jsonOrText(payload, true)
+  for (const c of checks) {
+    console.log((c.ok ? 'OK   ' : 'FAIL ') + c.name + (c.detail ? '  (' + c.detail + ')' : ''))
+  }
+  console.log('')
+  console.log(failed.length === 0 ? 'All checks passed.' : failed.length + ' check(s) failed. Run `mio upgrade` or reinstall affected hosts.')
+}
+
 function help() {
   console.log(`Mio Agent Runtime CLI
 
@@ -271,6 +365,8 @@ Usage:
   mio mcp                     Start Mio MCP server (stdio)
   mio install <host>          Install Mio into a host (codex|opencode|workbuddy|hermes)
   mio uninstall <host>        Remove Mio from a host
+  mio upgrade                 Upgrade Mio and re-wire all installed hosts
+  mio doctor                  Diagnose install and runtime issues
   mio status                  Show runtime and adapter status
   mio agents                  List installed agents
   mio observe                 Watch WorkBuddy transcripts and auto-ingest task outcomes
@@ -299,6 +395,10 @@ function main() {
       return installCommand(args[1], useJson)
     case 'uninstall':
       return uninstallCommand(args[1], useJson)
+    case 'upgrade':
+      return upgradeCommand(useJson)
+    case 'doctor':
+      return doctorCommand(useJson)
     case 'status':
       return statusCommand(useJson)
     case 'agents':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mio-agent-runtime",
-  "version": "0.5.9",
+  "version": "0.5.10",
   "description": "Mio Agent Runtime installer and MCP intelligence layer",
   "license": "MIT",
   "type": "commonjs",