@geekbeer/minion 2.25.0 → 2.32.0

package/core/lib/platform.js

@@ -0,0 +1,117 @@
+/**
+ * Cross-platform utility module
+ *
+ * Provides platform-aware paths, separators, and helpers.
+ * Used by win/ modules to avoid hardcoded Unix paths.
+ * This file does NOT modify any existing Linux module behavior.
+ */
+
+const os = require('os')
+const path = require('path')
+const fs = require('fs')
+
+const IS_WINDOWS = process.platform === 'win32'
+const PATH_SEPARATOR = path.delimiter // ';' on Windows, ':' on Unix
+const TEMP_DIR = os.tmpdir()
+
+/**
+ * Resolve the data directory for minion agent persistent files.
+ * Windows: %PROGRAMDATA%\minion-agent (or fallback to %USERPROFILE%\.minion-agent)
+ * Linux:   /opt/minion-agent (existing behavior)
+ */
+function resolveDataDir() {
+  if (IS_WINDOWS) {
+    const programData = process.env.PROGRAMDATA || process.env.ALLUSERSPROFILE
+    if (programData) {
+      const dir = path.join(programData, 'minion-agent')
+      try {
+        fs.mkdirSync(dir, { recursive: true })
+        return dir
+      } catch {
+        // Fall through to home-based path
+      }
+    }
+    return path.join(os.homedir(), '.minion-agent')
+  }
+  return '/opt/minion-agent'
+}
+
+const DATA_DIR = resolveDataDir()
+const LOG_DIR = path.join(DATA_DIR, 'logs')
+const MARKER_DIR = path.join(TEMP_DIR, 'minion-executions')
+
+/**
+ * Build extended PATH including common CLI installation locations.
+ * Uses the correct platform separator.
+ * @param {string} homeDir - User home directory
+ * @returns {string} Extended PATH string
+ */
+function buildExtendedPath(homeDir) {
+  const additionalPaths = IS_WINDOWS
+    ? [
+        path.join(homeDir, '.local', 'bin'),
+        path.join(homeDir, '.npm-global'),
+        path.join(homeDir, '.claude', 'bin'),
+        path.join(homeDir, 'AppData', 'Roaming', 'npm'),
+        path.join(process.env.PROGRAMFILES || 'C:\\Program Files', 'nodejs'),
+      ]
+    : [
+        path.join(homeDir, 'bin'),
+        path.join(homeDir, '.npm-global', 'bin'),
+        path.join(homeDir, '.local', 'bin'),
+        path.join(homeDir, '.claude', 'bin'),
+        '/usr/local/bin',
+      ]
+
+  const currentPath = process.env.PATH || ''
+  return [...additionalPaths, currentPath].join(PATH_SEPARATOR)
+}
+
+/**
+ * Get exit code file path for a session.
+ * @param {string} sessionName - Session identifier
+ * @returns {string} Path to exit code file
+ */
+function getExitCodePath(sessionName) {
+  return path.join(TEMP_DIR, `minion-exit-${sessionName}`)
+}
+
+/**
+ * Get the default shell for spawning processes.
+ * @returns {string} Shell executable path
+ */
+function getDefaultShell() {
+  if (IS_WINDOWS) {
+    return process.env.COMSPEC || 'cmd.exe'
+  }
+  return process.env.SHELL || '/bin/sh'
+}
+
+/**
+ * Resolve .env file path.
+ * Prefers DATA_DIR/.env, falls back to ~/minion.env.
+ * @param {string} homeDir - User home directory
+ * @returns {string} Path to .env file
+ */
+function resolveEnvFilePath(homeDir) {
+  const dataEnv = path.join(DATA_DIR, '.env')
+  try {
+    fs.accessSync(path.dirname(dataEnv), fs.constants.W_OK)
+    return dataEnv
+  } catch {
+    return path.join(homeDir, 'minion.env')
+  }
+}
+
+module.exports = {
+  IS_WINDOWS,
+  PATH_SEPARATOR,
+  TEMP_DIR,
+  DATA_DIR,
+  LOG_DIR,
+  MARKER_DIR,
+  buildExtendedPath,
+  getExitCodePath,
+  getDefaultShell,
+  resolveEnvFilePath,
+}

package/{routes → core/routes}/health.js

@@ -7,7 +7,7 @@
  * - POST /api/status  - Update status
  */
 
-const { version } = require('../package.json')
+const { version } = require('../../package.json')
 const { getLlmServices, isLlmCommandConfigured } = require('../lib/llm-checker')
 
 // Shared status state

package/{routes → core/routes}/routines.js

@@ -12,8 +12,7 @@
  */
 
 const { verifyToken } = require('../lib/auth')
-const routineRunner = require('../routine-runner')
-const routineStore = require('../routine-store')
+const routineStore = require('../stores/routine-store')
 const api = require('../api')
 const { isHqConfigured } = require('../config')
 
@@ -21,7 +20,8 @@ const { isHqConfigured } = require('../config')
  * Register routine routes as Fastify plugin
  * @param {import('fastify').FastifyInstance} fastify
  */
-async function routineRoutes(fastify) {
+async function routineRoutes(fastify, opts) {
+  const { routineRunner } = opts
   // Receive routines from HQ (upsert: add new, update existing)
   fastify.post('/api/routines', async (request, reply) => {
     if (!verifyToken(request)) {

package/{routes → core/routes}/skills.js

@@ -17,8 +17,7 @@ const crypto = require('crypto')
 const { verifyToken } = require('../lib/auth')
 const api = require('../api')
 const { config, isHqConfigured } = require('../config')
-const workflowRunner = require('../workflow-runner')
-const executionStore = require('../execution-store')
+const executionStore = require('../stores/execution-store')
 const logManager = require('../lib/log-manager')
 
 /**
@@ -128,7 +127,8 @@ async function pushSkillToHQ(name) {
  * Register skill routes as Fastify plugin
  * @param {import('fastify').FastifyInstance} fastify
  */
-async function skillRoutes(fastify) {
+async function skillRoutes(fastify, opts) {
+  const { workflowRunner } = opts
   // List deployed skills from local .claude/skills directory
   fastify.get('/api/list-skills', async (request, reply) => {
     if (!verifyToken(request)) {

package/{routes → core/routes}/workflows.js

@@ -20,9 +20,8 @@ const fs = require('fs').promises
 const path = require('path')
 
 const { verifyToken } = require('../lib/auth')
-const workflowRunner = require('../workflow-runner')
-const workflowStore = require('../workflow-store')
-const executionStore = require('../execution-store')
+const workflowStore = require('../stores/workflow-store')
+const executionStore = require('../stores/execution-store')
 const logManager = require('../lib/log-manager')
 const api = require('../api')
 const { config, isHqConfigured } = require('../config')
@@ -32,7 +31,8 @@ const { writeSkillToLocal, pushSkillToHQ } = require('./skills')
  * Register workflow routes as Fastify plugin
  * @param {import('fastify').FastifyInstance} fastify
  */
-async function workflowRoutes(fastify) {
+async function workflowRoutes(fastify, opts) {
+  const { workflowRunner } = opts
   // Receive workflows from HQ (upsert: add new, update existing)
   fastify.post('/api/workflows', async (request, reply) => {
     if (!verifyToken(request)) {

package/{chat-store.js → core/stores/chat-store.js}

@@ -7,7 +7,7 @@
 const fs = require('fs').promises
 const path = require('path')
 
-const { config } = require('./config')
+const { config } = require('../config')
 
 const MAX_MESSAGES = 100
 

package/{execution-store.js → core/stores/execution-store.js}

@@ -7,7 +7,7 @@
 const fs = require('fs').promises
 const path = require('path')
 
-const { config } = require('./config')
+const { config } = require('../config')
 
 // Max executions to keep (older ones are pruned)
 const MAX_EXECUTIONS = 200

package/{routine-store.js → core/stores/routine-store.js}

@@ -7,7 +7,7 @@
 const fs = require('fs').promises
 const path = require('path')
 
-const { config } = require('./config')
+const { config } = require('../config')
 
 // Routine file location: /opt/minion-agent/routines.json (systemd/supervisord)
 // or ~/routines.json (standalone)

package/{workflow-store.js → core/stores/workflow-store.js}

@@ -7,7 +7,7 @@
 const fs = require('fs').promises
 const path = require('path')
 
-const { config } = require('./config')
+const { config } = require('../config')
 
 // Workflow file location: /opt/minion-agent/workflows.json (systemd/supervisord)
 // or ~/workflows.json (standalone)

package/{minion-cli.sh → linux/minion-cli.sh}

@@ -41,7 +41,7 @@ fi
 
 # Resolve version from package.json (installed location)
 CLI_DIR="$(cd "$(dirname "$(readlink -f "$0")")" && pwd)"
-CLI_VERSION="$(node -p "require('${CLI_DIR}/package.json').version")"
+CLI_VERSION="$(node -p "require('${CLI_DIR}/../package.json').version")"
 
 # Use sudo only when not running as root
 SUDO=""
@@ -89,6 +89,28 @@ svc_control() {
 
 AGENT_URL="${MINION_AGENT_URL:-http://localhost:8080}"
 
+# Detect LAN IPv4 address (best-effort)
+detect_lan_ip() {
+  local ip=""
+  # Method 1: Use ip route to find the source IP for default gateway
+  if command -v ip &>/dev/null; then
+    ip=$(ip route get 1.1.1.1 2>/dev/null | grep -oP 'src \K[\d.]+' | head -1)
+  fi
+  # Method 2: Parse ip addr for non-loopback, non-docker, non-APIPA addresses
+  if [ -z "$ip" ] && command -v ip &>/dev/null; then
+    ip=$(ip -4 addr show scope global 2>/dev/null \
+      | grep -oP 'inet \K[\d.]+' \
+      | grep -v '^172\.17\.' \
+      | grep -v '^169\.254\.' \
+      | head -1)
+  fi
+  # Method 3: hostname -I (available on most Linux distros)
+  if [ -z "$ip" ] && command -v hostname &>/dev/null; then
+    ip=$(hostname -I 2>/dev/null | awk '{print $1}')
+  fi
+  echo "$ip"
+}
+
 # Auto-load .env so that API_TOKEN etc. are available in interactive shells
 ENV_FILE="/opt/minion-agent/.env"
 if [ -f "$ENV_FILE" ] && [ -r "$ENV_FILE" ]; then
@@ -319,7 +341,7 @@ do_setup() {
   echo "[6/${TOTAL_STEPS}] Creating service configuration ($PROC_MGR)..."
   local NPM_ROOT
   NPM_ROOT="$(npm root -g)"
-  local SERVER_PATH="${NPM_ROOT}/@geekbeer/minion/server.js"
+  local SERVER_PATH="${NPM_ROOT}/@geekbeer/minion/linux/server.js"
 
   if [ ! -f "$SERVER_PATH" ]; then
     echo "  ERROR: server.js not found at $SERVER_PATH"
@@ -732,14 +754,33 @@ CFEOF
     echo "Notifying HQ of setup completion..."
     local NOTIFY_RESPONSE
     local HOSTNAME_VAL
+    local LAN_IP
     HOSTNAME_VAL=$(hostname 2>/dev/null || echo "")
+    LAN_IP=$(detect_lan_ip)
+
+    # Build request body with LAN IP detection
+    # Docker: use hostname (container name) for internal_ip_address (resolved via Docker DNS)
+    # Self-hosted: use LAN IP for both fields (hostname is not resolvable on LAN)
+    local BODY
+    if [ -f /.dockerenv ]; then
+      BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+    elif [ -n "$LAN_IP" ]; then
+      BODY="{\"internal_ip_address\":\"${LAN_IP}\",\"ip_address\":\"${LAN_IP}\"}"
+    else
+      BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+    fi
+
     NOTIFY_RESPONSE=$(curl -sfL -X POST "${HQ_URL}/api/minion/setup-complete" \
       -H "Content-Type: application/json" \
       -H "Authorization: Bearer ${API_TOKEN}" \
-      -d "{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}" 2>&1) || true
+      -d "$BODY" 2>&1) || true
 
     if echo "$NOTIFY_RESPONSE" | grep -q '"success":true' 2>/dev/null; then
-      echo "  -> HQ notified successfully"
+      if [ -n "$LAN_IP" ] && [ ! -f /.dockerenv ]; then
+        echo "  -> HQ notified successfully (LAN IP: ${LAN_IP})"
+      else
+        echo "  -> HQ notified successfully"
+      fi
     else
       echo "  -> HQ notification skipped (HQ may not be reachable)"
     fi
@@ -915,14 +956,30 @@ SUPEOF
   echo "[4/4] Notifying HQ..."
   local NOTIFY_RESPONSE
   local HOSTNAME_VAL
+  local LAN_IP
   HOSTNAME_VAL=$(hostname 2>/dev/null || echo "")
+  LAN_IP=$(detect_lan_ip)
+
+  local BODY
+  if [ -f /.dockerenv ]; then
+    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+  elif [ -n "$LAN_IP" ]; then
+    BODY="{\"internal_ip_address\":\"${LAN_IP}\",\"ip_address\":\"${LAN_IP}\"}"
+  else
+    BODY="{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}"
+  fi
+
   NOTIFY_RESPONSE=$(curl -sfL -X POST "${HQ_URL}/api/minion/setup-complete" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer ${API_TOKEN}" \
-    -d "{\"internal_ip_address\":\"${HOSTNAME_VAL}\"}" 2>&1) || true
+    -d "$BODY" 2>&1) || true
 
   if echo "$NOTIFY_RESPONSE" | grep -q '"success":true' 2>/dev/null; then
-    echo "  -> HQ notified successfully"
+    if [ -n "$LAN_IP" ] && [ ! -f /.dockerenv ]; then
+      echo "  -> HQ notified successfully (LAN IP: ${LAN_IP})"
+    else
+      echo "  -> HQ notified successfully"
+    fi
   else
     echo "  -> Skipped (heartbeat will notify HQ within 30s)"
   fi

package/{routes → linux/routes}/chat.js

@@ -17,9 +17,9 @@
 const { spawn } = require('child_process')
 const fs = require('fs')
 const path = require('path')
-const { verifyToken } = require('../lib/auth')
-const { config } = require('../config')
-const chatStore = require('../chat-store')
+const { verifyToken } = require('../../core/lib/auth')
+const { config } = require('../../core/config')
+const chatStore = require('../../core/stores/chat-store')
 
 /** @type {import('child_process').ChildProcess | null} */
 let activeChatChild = null

package/{routes → linux/routes}/commands.js

@@ -10,7 +10,7 @@ const { exec } = require('child_process')
 const { promisify } = require('util')
 const execAsync = promisify(exec)
 
-const { verifyToken } = require('../lib/auth')
+const { verifyToken } = require('../../core/lib/auth')
 const { detectProcessManager, buildAllowedCommands } = require('../lib/process-manager')
 
 const PROC_MGR = detectProcessManager()

package/{routes → linux/routes}/config.js

@@ -10,9 +10,9 @@
 const { execSync } = require('child_process')
 const fs = require('fs')
 const path = require('path')
-const { verifyToken } = require('../lib/auth')
-const { clearLlmCache } = require('../lib/llm-checker')
-const { config } = require('../config')
+const { verifyToken } = require('../../core/lib/auth')
+const { clearLlmCache } = require('../../core/lib/llm-checker')
+const { config } = require('../../core/config')
 
 /** Keys that can be read/written via the config API */
 const ALLOWED_ENV_KEYS = ['LLM_COMMAND']

package/{routes → linux/routes}/directives.js

@@ -12,12 +12,12 @@ const fs = require('fs').promises
 const path = require('path')
 const crypto = require('crypto')
 
-const { verifyToken } = require('../lib/auth')
-const { config } = require('../config')
-const { writeSkillToLocal } = require('./skills')
+const { verifyToken } = require('../../core/lib/auth')
+const { config } = require('../../core/config')
+const { writeSkillToLocal } = require('../../core/routes/skills')
 const workflowRunner = require('../workflow-runner')
-const executionStore = require('../execution-store')
-const logManager = require('../lib/log-manager')
+const executionStore = require('../../core/stores/execution-store')
+const logManager = require('../../core/lib/log-manager')
 
 /**
  * Parse frontmatter from skill content to extract body

package/{routes → linux/routes}/files.js

@@ -16,8 +16,8 @@ const fsSync = require('fs')
 const path = require('path')
 const { spawn } = require('child_process')
 
-const { verifyToken } = require('../lib/auth')
-const { config } = require('../config')
+const { verifyToken } = require('../../core/lib/auth')
+const { config } = require('../../core/config')
 
 /** Base directory for file storage */
 const FILES_DIR = path.join(config.HOME_DIR, 'files')

package/{routes → linux/routes}/terminal.js

@@ -20,8 +20,8 @@ const path = require('path')
 const net = require('net')
 const execAsync = promisify(exec)
 
-const { verifyToken } = require('../lib/auth')
-const { config } = require('../config')
+const { verifyToken } = require('../../core/lib/auth')
+const { config } = require('../../core/config')
 
 // Ensure consistent HOME for tmux socket path
 const homeDir = config.HOME_DIR

package/{routine-runner.js → linux/routine-runner.js}

@@ -18,10 +18,10 @@ const path = require('path')
 const fs = require('fs').promises
 const execAsync = promisify(exec)
 
-const { config } = require('./config')
-const executionStore = require('./execution-store')
-const routineStore = require('./routine-store')
-const logManager = require('./lib/log-manager')
+const { config } = require('../core/config')
+const executionStore = require('../core/stores/execution-store')
+const routineStore = require('../core/stores/routine-store')
+const logManager = require('../core/lib/log-manager')
 
 // Active cron jobs keyed by routine ID
 const activeJobs = new Map()

package/{server.js → linux/server.js}

@@ -1,24 +1,60 @@
 /**
- * Minion Agent HTTP Server
+ * Minion Agent HTTP Server (Linux)
  *
- * Entry point for the minion agent. Registers all routes and manages lifecycle.
- * See routes/index.js for API documentation.
+ * Entry point for the minion agent on Linux.
+ * Registers shared routes (from core/) and Linux-specific routes.
+ *
+ * API Overview:
+ * ─────────────────────────────────────────────────────────────────────────────
+ * Health & Status:      GET/POST /api/health, /api/status
+ * Commands:             GET /api/commands, POST /api/command
+ * Skills:               GET /api/list-skills, POST /api/deploy-skill, etc.
+ * Workflows:            GET/POST/PUT/DELETE /api/workflows, /api/workflows/trigger
+ * Routines:             GET/POST/PUT/DELETE /api/routines, /api/routines/trigger
+ * Terminal:             GET/POST /api/terminal/sessions, /send, /kill, /capture
+ * Files:                GET/POST/DELETE /api/files
+ * Directives:           POST /api/directive
+ * Auth:                 GET /api/auth/status
+ * Chat:                 POST /api/chat, GET /api/chat/session, POST /api/chat/clear
+ * Config:               GET /api/config/backup, GET/PUT /api/config/env
+ * Executions:           GET /api/executions, GET /api/executions/:id, etc.
+ * ─────────────────────────────────────────────────────────────────────────────
  */
 
 const fs = require('fs')
 const path = require('path')
 
 const fastify = require('fastify')({ logger: true })
-const { config, validate, isHqConfigured } = require('./config')
+
+// Package root (one level up from linux/)
+const PACKAGE_ROOT = path.join(__dirname, '..')
+
+// Core shared modules
+const { config, validate, isHqConfigured } = require('../core/config')
+const workflowStore = require('../core/stores/workflow-store')
+const routineStore = require('../core/stores/routine-store')
+
+// Linux-specific modules
 const workflowRunner = require('./workflow-runner')
-const workflowStore = require('./workflow-store')
 const routineRunner = require('./routine-runner')
-const routineStore = require('./routine-store')
-
-const { registerRoutes, setOffline, getProcessManager, getAllowedCommands } = require('./routes')
 const { cleanupTtyd, killStaleTtydProcesses } = require('./routes/terminal')
 const { startTerminalProxy, stopTerminalProxy } = require('./terminal-proxy')
 
+// Shared routes (from core/)
+const { healthRoutes, setOffline } = require('../core/routes/health')
+const { skillRoutes } = require('../core/routes/skills')
+const { workflowRoutes } = require('../core/routes/workflows')
+const { routineRoutes } = require('../core/routes/routines')
+const { authRoutes } = require('../core/routes/auth')
+
+// Linux-specific routes
+const { commandRoutes, getProcessManager, getAllowedCommands } = require('./routes/commands')
+const { terminalRoutes } = require('./routes/terminal')
+const { fileRoutes } = require('./routes/files')
+const { directiveRoutes } = require('./routes/directives')
+const { chatRoutes } = require('./routes/chat')
+const { configRoutes } = require('./routes/config')
+
 // Validate configuration before starting
 validate()
 const PROC_MGR = getProcessManager()
@@ -50,11 +86,9 @@ process.on('SIGINT', () => shutdown('SIGINT'))
 
 /**
  * Sync bundled permissions into ~/.claude/settings.json.
- * Merges package-defined allow/deny into the existing settings without
- * removing user-added entries or non-permission keys (e.g. mcpServers).
  */
 function syncPermissions() {
-  const bundledPath = path.join(__dirname, 'settings', 'permissions.json')
+  const bundledPath = path.join(PACKAGE_ROOT, 'settings', 'permissions.json')
   const settingsDir = path.join(config.HOME_DIR, '.claude')
   const settingsPath = path.join(settingsDir, 'settings.json')
 
@@ -63,13 +97,11 @@ function syncPermissions() {
 
     const bundled = JSON.parse(fs.readFileSync(bundledPath, 'utf-8'))
 
-    // Read existing settings or start fresh
     let settings = {}
     if (fs.existsSync(settingsPath)) {
       settings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'))
     }
 
-    // Replace permissions section with bundled values
     settings.permissions = {
       allow: bundled.allow || [],
       deny: bundled.deny || [],
@@ -85,10 +117,9 @@ function syncPermissions() {
 
 /**
  * Sync bundled tmux.conf to ~/.tmux.conf.
- * Enables mouse-driven scrollback (copy-mode) for the WebSocket terminal.
  */
 function syncTmuxConfig() {
-  const bundledPath = path.join(__dirname, 'settings', 'tmux.conf')
+  const bundledPath = path.join(PACKAGE_ROOT, 'settings', 'tmux.conf')
   const destPath = path.join(config.HOME_DIR, '.tmux.conf')
 
   try {
@@ -103,11 +134,9 @@ function syncTmuxConfig() {
 
 /**
  * Sync bundled rules from the package to ~/.claude/rules/.
- * Deploys core.md only. Role context is injected per-execution, not as rules.
- * Removes legacy files (minion.md, role-*.md) if present.
  */
 function syncBundledRules() {
-  const bundledRulesDir = path.join(__dirname, 'rules')
+  const bundledRulesDir = path.join(PACKAGE_ROOT, 'rules')
   const targetRulesDir = path.join(config.HOME_DIR, '.claude', 'rules')
 
   try {
@@ -115,14 +144,12 @@ function syncBundledRules() {
 
     fs.mkdirSync(targetRulesDir, { recursive: true })
 
-    // Always deploy core.md
     const coreSrc = path.join(bundledRulesDir, 'core.md')
     if (fs.existsSync(coreSrc)) {
       fs.copyFileSync(coreSrc, path.join(targetRulesDir, 'core.md'))
       console.log('[Rules] Synced: core.md')
     }
 
-    // Remove legacy files if present
     for (const legacy of ['minion.md', 'role-pm.md', 'role-engineer.md']) {
       const legacyPath = path.join(targetRulesDir, legacy)
       if (fs.existsSync(legacyPath)) {
@@ -137,11 +164,9 @@ function syncBundledRules() {
 
 /**
  * Sync bundled role context files to ~/.minion/roles/.
- * These are NOT loaded as Claude Code rules — they are injected
- * into the prompt at execution time based on the minion's role.
  */
 function syncBundledRoles() {
-  const bundledRolesDir = path.join(__dirname, 'roles')
+  const bundledRolesDir = path.join(PACKAGE_ROOT, 'roles')
   const targetRolesDir = path.join(config.HOME_DIR, '.minion', 'roles')
 
   try {
@@ -163,11 +188,9 @@ function syncBundledRoles() {
 
 /**
  * Sync bundled documentation files to ~/.minion/docs/.
- * These are reference documents accessed on-demand by Claude Code,
- * NOT loaded automatically as rules.
  */
 function syncBundledDocs() {
-  const bundledDocsDir = path.join(__dirname, 'docs')
+  const bundledDocsDir = path.join(PACKAGE_ROOT, 'docs')
   const targetDocsDir = path.join(config.HOME_DIR, '.minion', 'docs')
 
   try {
@@ -187,26 +210,38 @@ function syncBundledDocs() {
   }
 }
 
+/**
+ * Register all routes (shared + Linux-specific)
+ */
+async function registerAllRoutes(app) {
+  // Shared routes (from core/) - inject runners via opts
+  await app.register(healthRoutes)
+  await app.register(skillRoutes, { workflowRunner })
+  await app.register(workflowRoutes, { workflowRunner })
+  await app.register(routineRoutes, { routineRunner })
+  await app.register(authRoutes)
+
+  // Linux-specific routes
+  await app.register(commandRoutes)
+  await app.register(terminalRoutes)
+  await app.register(fileRoutes)
+  await app.register(directiveRoutes)
+  await app.register(chatRoutes)
+  await app.register(configRoutes)
+}
+
 // Start server
 async function start() {
   try {
-    // Sync bundled rules to ~/.claude/rules/ (core.md only)
+    // Sync bundled assets
     syncBundledRules()
-
-    // Sync bundled roles to ~/.minion/roles/ (injected per-execution)
     syncBundledRoles()
-
-    // Sync bundled docs to ~/.minion/docs/ (on-demand reference)
     syncBundledDocs()
-
-    // Sync bundled permissions to ~/.claude/settings.json (broad allow + deny-list)
     syncPermissions()
-
-    // Sync tmux.conf for mouse scroll support in WebSocket terminal
     syncTmuxConfig()
 
     // Register all routes
-    await registerRoutes(fastify)
+    await registerAllRoutes(fastify)
 
     // Listen on all interfaces
     await fastify.listen({ port: config.AGENT_PORT, host: '0.0.0.0' })