mio-agent-runtime 0.5.8 → 0.5.10

package/README.md

@@ -53,6 +53,9 @@ 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 |
@@ -237,6 +240,8 @@ WorkBuddy ─┘       + Observer ......... automatic data collection
 | >= 0.3.6 | Passive observation + seamless read/write |
 | >= 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/adapters/codex.js

@@ -119,4 +119,16 @@ function install({ node, serverScript, home, workspace }) {
   }
 }
 
-module.exports = { configPath, isInstalled, install, restartWarningMessage }
+function uninstall({ serverScript }) {
+  const target = configPath()
+  if (!fs.existsSync(target) || !fs.readFileSync(target, 'utf8').includes(SERVER_SECTION)) {
+    return { changed: false, configPath: target, message: 'Codex Mio MCP not installed.' }
+  }
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  const toml = stripMioSection(fs.readFileSync(target, 'utf8'))
+  fs.writeFileSync(target, toml, 'utf8')
+  return { changed: true, configPath: target, backup, message: 'Codex Mio MCP removed. Restart Codex to apply.' }
+}
+
+module.exports = { configPath, isInstalled, install, uninstall, restartWarningMessage }

package/adapters/hermes.js

@@ -119,4 +119,22 @@ function isHermesOnPath() {
   }
 }
 
-module.exports = { hermesBin, isInstalled, install }
+function uninstall({ serverScript }) {
+  if (!hermesBin() && !isHermesOnPath()) {
+    return { changed: false, message: 'Hermes binary not found. Nothing to remove.', configPath: null }
+  }
+  if (!isInstalled()) {
+    return { changed: false, message: 'Hermes Mio MCP not installed.', configPath: null }
+  }
+  runHermes(['mcp', 'remove', SERVER_NAME])
+  const removed = !isInstalled()
+  return {
+    changed: removed,
+    configPath: null,
+    message: removed
+      ? 'Hermes Mio MCP removed. Start a new Hermes session to apply.'
+      : 'Hermes mcp remove returned but Mio is still present. Run `hermes mcp remove ' + SERVER_NAME + '` manually.'
+  }
+}
+
+module.exports = { hermesBin, isInstalled, install, uninstall }

package/adapters/opencode.js

@@ -173,4 +173,43 @@ function install({ node, serverScript, home, workspace, project }) {
   }
 }
 
-module.exports = { configPath, globalInstructionsPath, isInstalled, install, configNeedsRepair, restartWarningMessage }
+function removeGlobalInstructions() {
+  const target = globalInstructionsPath()
+  if (!fs.existsSync(target)) return { changed: false, target, backup: null }
+  const content = fs.readFileSync(target, 'utf8')
+  const start = content.indexOf(INSTRUCTIONS_BEGIN)
+  if (start === -1) return { changed: false, target, backup: null }
+  const end = content.indexOf(INSTRUCTIONS_END, start)
+  let next = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + INSTRUCTIONS_END.length)
+  next = next.trimEnd() + '\n'
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  fs.writeFileSync(target, next, 'utf8')
+  return { changed: true, target, backup }
+}
+
+function uninstall({ serverScript }) {
+  const target = configPath()
+  const config = readConfig()
+  const hadMcp = Boolean(config && config.mcp && config.mcp['mio-intelligence'])
+  let configChanged = false
+  let backup = null
+  if (hadMcp) {
+    backup = target + '.bak-mio-' + Date.now()
+    if (fs.existsSync(target)) fs.copyFileSync(target, backup)
+    delete config.mcp['mio-intelligence']
+    if (Object.keys(config.mcp).length === 0) delete config.mcp
+    fs.mkdirSync(path.dirname(target), { recursive: true })
+    fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n', 'utf8')
+    configChanged = true
+  }
+  const instr = removeGlobalInstructions()
+  const changed = configChanged || instr.changed
+  if (!changed) return { changed: false, configPath: target, message: 'OpenCode Mio MCP not installed.' }
+  let message = 'OpenCode Mio MCP removed'
+  const restartHint = restartWarningMessage()
+  if (restartHint) message += '. ' + restartHint
+  return { changed: true, configPath: target, globalInstructionsPath: instr.target, backup, message }
+}
+
+module.exports = { configPath, globalInstructionsPath, isInstalled, install, uninstall, configNeedsRepair, restartWarningMessage }

package/adapters/workbuddy.js

@@ -193,4 +193,50 @@ function install({ node, serverScript, home, workspace, project }) {
   }
 }
 
-module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install }
+function removeBlock(target) {
+  if (!fs.existsSync(target)) return { changed: false, target, backup: null }
+  const content = fs.readFileSync(target, 'utf8')
+  const start = content.indexOf(MEMORY_BEGIN)
+  if (start === -1) return { changed: false, target, backup: null }
+  const end = content.indexOf(MEMORY_END, start)
+  let next = end === -1 ? content.slice(0, start) : content.slice(0, start) + content.slice(end + MEMORY_END.length)
+  next = next.trimEnd() + '\n'
+  const backup = target + '.bak-mio-' + Date.now()
+  fs.copyFileSync(target, backup)
+  fs.writeFileSync(target, next, 'utf8')
+  return { changed: true, target, backup }
+}
+
+function uninstall({ serverScript, workspace }) {
+  const target = configPath()
+  const config = readJson(target)
+  const entry = config && config.mcpServers && config.mcpServers['mio-intelligence']
+  if (!entry) return { changed: false, configPath: target, message: 'WorkBuddy Mio MCP not installed.' }
+  const backup = target + '.bak-mio-' + Date.now()
+  if (fs.existsSync(target)) fs.copyFileSync(target, backup)
+  delete config.mcpServers['mio-intelligence']
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n', 'utf8')
+  const approvalsTarget = approvalsPath()
+  const approvals = readJson(approvalsTarget) || {}
+  const key = approvalKey('mio-intelligence', entry)
+  if (approvals[key]) {
+    delete approvals[key]
+    fs.writeFileSync(approvalsTarget, JSON.stringify(approvals, null, 2) + '\n', 'utf8')
+  }
+  const userRules = removeBlock(memoryRulesPath())
+  let projectRules = null
+  const workspaceDir = workspace || process.cwd()
+  if (workspaceDir && path.isAbsolute(workspaceDir)) projectRules = removeBlock(projectInstructionsPath(workspaceDir))
+  const changed = userRules.changed || Boolean(projectRules && projectRules.changed)
+  return {
+    changed: true,
+    configPath: target,
+    approvalsPath: approvalsTarget,
+    memoryRulesPath: userRules.target,
+    projectInstructionsPath: projectRules ? projectRules.target : null,
+    message: 'WorkBuddy Mio MCP removed, approval revoked, and Mio rules stripped from CODEBUDDY.md and workspace AGENTS.md. Restart WorkBuddy to apply.'
+  }
+}
+
+module.exports = { configDir, configPath, approvalsPath, memoryRulesPath, projectInstructionsPath, approvalKey, isInstalled, install, uninstall }

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')
@@ -219,6 +220,142 @@ function observeCommand(args) {
   observer.startForeground(MIO_HOME)
 }
 
+function uninstallCommand(host, useJson) {
+  if (!host) {
+    console.error('Usage: mio uninstall <codex|opencode|workbuddy|hermes>')
+    process.exitCode = 1
+    return
+  }
+  const adapter = adapters[host]
+  if (!adapter) {
+    console.error(`Unknown host: ${host}`)
+    process.exitCode = 1
+    return
+  }
+  let result
+  try {
+    result = adapter.uninstall({
+      node: process.execPath,
+      serverScript: SERVER_SCRIPT,
+      home: MIO_HOME,
+      workspace: process.cwd(),
+    })
+  } catch (error) {
+    console.error(`Failed to uninstall ${host}: ${error.message || error}`)
+    process.exitCode = 1
+    return
+  }
+  if (result.changed) {
+    const config = readConfig()
+    if (config.agents && config.agents[host]) {
+      delete config.agents[host]
+      writeConfig(config)
+    }
+    const remaining = Object.keys(config.agents || {}).length
+    if (remaining === 0 && observer.isRunning(MIO_HOME)) {
+      observer.stopBackground(MIO_HOME)
+    }
+  }
+  if (useJson) {
+    jsonOrText(result, true)
+    return
+  }
+  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
 
@@ -227,6 +364,9 @@ Usage:
   mio init                    Initialize MIO_HOME
   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
@@ -253,6 +393,12 @@ function main() {
       return mcpCommand()
     case 'install':
       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.8",
+  "version": "0.5.10",
   "description": "Mio Agent Runtime installer and MCP intelligence layer",
   "license": "MIT",
   "type": "commonjs",