@xopcai/xopc 0.0.82 → 0.0.83

package/dist/src/cli/commands/gateway/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":[],"sources":["../../../../../src/cli/commands/gateway/lifecycle.ts"],"sourcesContent":["/**\n * Gateway lifecycle orchestration — OpenClaw-aligned service + unmanaged fallback.\n */\n\nimport { isRestartEnabled } from '../../../config/commands.flags.js';\nimport { loadConfig } from '../../../config/index.js';\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { resolveGatewayService } from '../../../daemon/service.js';\nimport {\n  findVerifiedGatewayListenerPidsOnPortSync,\n  formatGatewayPidList,\n  signalVerifiedGatewayPidSync,\n} from '../../../infra/gateway-processes.js';\nimport { authorizeGatewaySigusr1Restart } from '../../../infra/restart.js';\nimport {\n  DEFAULT_RESTART_HEALTH_ATTEMPTS,\n  DEFAULT_RESTART_HEALTH_DELAY_MS,\n  renderGatewayPortHealthDiagnostics,\n  waitForGatewayHealthyListener,\n} from './restart-health.js';\nimport {\n  parsePortFromArgs,\n  renderGatewayServiceStartHints,\n  resolveGatewayPortFromConfig,\n} from './shared.js';\nimport {\n  runServiceRestart,\n  runServiceStop,\n  type ServiceRecoveryResult,\n} from './lifecycle-core.js';\n\nconst POST_RESTART_HEALTH_ATTEMPTS = DEFAULT_RESTART_HEALTH_ATTEMPTS;\nconst POST_RESTART_HEALTH_DELAY_MS = DEFAULT_RESTART_HEALTH_DELAY_MS;\n\nasync function resolveGatewayLifecyclePort(service?: Awaited<ReturnType<typeof resolveGatewayService>>): Promise<number> {\n  const resolvedService = service ?? (await resolveGatewayService());\n  const command = await resolvedService.readCommand(process.env).catch(() => null);\n  const portFromArgs = parsePortFromArgs(command?.programArguments);\n  return portFromArgs ?? resolveGatewayPortFromConfig();\n}\n\nfunction resolveVerifiedGatewayListenerPids(port: number): number[] {\n  return findVerifiedGatewayListenerPidsOnPortSync(port).filter(\n    (pid): pid is number => Number.isFinite(pid) && pid > 0,\n  );\n}\n\nasync function assertUnmanagedGatewayRestartEnabled(port: number): Promise<void> {\n  const config = loadConfig(resolveConfigPath());\n  if (!isRestartEnabled(config)) {\n    throw new Error(\n      'Gateway restart is disabled in config (commands.restart=false); unmanaged SIGUSR1 restart would be ignored',\n    );\n  }\n\n  try {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 1000);\n    const response = await fetch(`http://127.0.0.1:${port}/api/health`, {\n      method: 'GET',\n      signal: controller.signal,\n    });\n    clearTimeout(timeout);\n    if (!response.ok) {\n      return;\n    }\n  } catch {\n    // Best-effort probe; unmanaged restart may still target a starting gateway.\n  }\n}\n\nasync function stopGatewayWithoutServiceManager(port: number): Promise<ServiceRecoveryResult | null> {\n  const pids = resolveVerifiedGatewayListenerPids(port);\n  if (pids.length === 0) {\n    return null;\n  }\n  for (const pid of pids) {\n    signalVerifiedGatewayPidSync(pid, 'SIGTERM');\n  }\n  return {\n    result: 'stopped',\n    message: `Gateway stop signal sent to unmanaged process${pids.length === 1 ? '' : 'es'} on port ${port}: ${formatGatewayPidList(pids)}.`,\n  };\n}\n\nasync function restartGatewayWithoutServiceManager(port: number): Promise<ServiceRecoveryResult | null> {\n  await assertUnmanagedGatewayRestartEnabled(port);\n  const pids = resolveVerifiedGatewayListenerPids(port);\n  if (pids.length === 0) {\n    return null;\n  }\n  if (pids.length > 1) {\n    throw new Error(\n      `multiple gateway processes are listening on port ${port}: ${formatGatewayPidList(pids)}; use \"xopc gateway status\" before retrying restart`,\n    );\n  }\n  authorizeGatewaySigusr1Restart();\n  signalVerifiedGatewayPidSync(pids[0], 'SIGUSR1');\n  return {\n    result: 'restarted',\n    message: `Gateway restart signal sent to unmanaged process on port ${port}: ${pids[0]}.`,\n  };\n}\n\nexport async function runDaemonStop(options: { json?: boolean; disable?: boolean } = {}): Promise<void> {\n  const service = await resolveGatewayService();\n  let gatewayPortPromise: Promise<number> | undefined;\n\n  await runServiceStop({\n    service,\n    opts: options,\n    onNotLoaded: async () => {\n      gatewayPortPromise ??= resolveGatewayLifecyclePort(service);\n      return stopGatewayWithoutServiceManager(await gatewayPortPromise);\n    },\n  });\n}\n\nexport async function runDaemonRestart(options: {\n  json?: boolean;\n  wait?: string;\n} = {}): Promise<void> {\n  const service = await resolveGatewayService();\n  let restartedWithoutServiceManager = false;\n  const restartPort = await resolveGatewayLifecyclePort(service);\n  const restartHealthAttempts = POST_RESTART_HEALTH_ATTEMPTS;\n  const restartWaitSeconds = Math.round(\n    (restartHealthAttempts * POST_RESTART_HEALTH_DELAY_MS) / 1000,\n  );\n\n  await runServiceRestart({\n    service,\n    opts: options,\n    renderStartHints: renderGatewayServiceStartHints,\n    checkTokenDrift: true,\n    onNotLoaded: async () => {\n      const handled = await restartGatewayWithoutServiceManager(restartPort);\n      if (handled) {\n        restartedWithoutServiceManager = true;\n      }\n      return handled;\n    },\n    postRestartCheck: async ({ options: opts, fail }) => {\n      if (!restartedWithoutServiceManager) {\n        return;\n      }\n      const health = await waitForGatewayHealthyListener({\n        port: restartPort,\n        attempts: restartHealthAttempts,\n        delayMs: POST_RESTART_HEALTH_DELAY_MS,\n      });\n      if (health.healthy) {\n        return;\n      }\n      const diagnostics = renderGatewayPortHealthDiagnostics(health);\n      fail(\n        `Gateway restart timed out after ${restartWaitSeconds}s waiting for health checks.`,\n        ['xopc gateway status', 'xopc doctor'],\n        diagnostics,\n        opts,\n      );\n    },\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;YAM6D;AAyB7D,MAAM,+BAA+B;AACrC,MAAM,+BAAA;AAEN,eAAe,4BAA4B,SAA8E;AAIvH,QADqB,mBAAkB,OAFf,WAAY,MAAM,uBAAuB,EAC3B,YAAY,QAAQ,IAAI,CAAC,YAAY,KAAK,GAChC,iBAC7B,IAAI,8BAA8B;;AAGvD,SAAS,mCAAmC,MAAwB;AAClE,QAAO,0CAA0C,KAAK,CAAC,QACpD,QAAuB,OAAO,SAAS,IAAI,IAAI,MAAM,EACvD;;AAGH,eAAe,qCAAqC,MAA6B;AAE/E,KAAI,CAAC,iBADU,WAAW,mBAAmB,CACjB,CAAC,CAC3B,OAAM,IAAI,MACR,6GACD;AAGH,KAAI;EACF,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,UAAU,iBAAiB,WAAW,OAAO,EAAE,IAAK;EAC1D,MAAM,WAAW,MAAM,MAAM,oBAAoB,KAAK,cAAc;GAClE,QAAQ;GACR,QAAQ,WAAW;GACpB,CAAC;AACF,eAAa,QAAQ;AACrB,MAAI,CAAC,SAAS,GACZ;SAEI;;AAKV,eAAe,iCAAiC,MAAqD;CACnG,MAAM,OAAO,mCAAmC,KAAK;AACrD,KAAI,KAAK,WAAW,EAClB,QAAO;AAET,MAAK,MAAM,OAAO,KAChB,8BAA6B,KAAK,UAAU;AAE9C,QAAO;EACL,QAAQ;EACR,SAAS,gDAAgD,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,KAAK,IAAI,qBAAqB,KAAK,CAAC;EACvI;;AAGH,eAAe,oCAAoC,MAAqD;AACtG,OAAM,qCAAqC,KAAK;CAChD,MAAM,OAAO,mCAAmC,KAAK;AACrD,KAAI,KAAK,WAAW,EAClB,QAAO;AAET,KAAI,KAAK,SAAS,EAChB,OAAM,IAAI,MACR,oDAAoD,KAAK,IAAI,qBAAqB,KAAK,CAAC,qDACzF;AAEH,iCAAgC;AAChC,8BAA6B,KAAK,IAAI,UAAU;AAChD,QAAO;EACL,QAAQ;EACR,SAAS,4DAA4D,KAAK,IAAI,KAAK,GAAG;EACvF;;AAGH,eAAsB,cAAc,UAAiD,EAAE,EAAiB;CACtG,MAAM,UAAU,MAAM,uBAAuB;CAC7C,IAAI;AAEJ,OAAM,eAAe;EACnB;EACA,MAAM;EACN,aAAa,YAAY;AACvB,0BAAuB,4BAA4B,QAAQ;AAC3D,UAAO,iCAAiC,MAAM,mBAAmB;;EAEpE,CAAC;;AAGJ,eAAsB,iBAAiB,UAGnC,EAAE,EAAiB;CACrB,MAAM,UAAU,MAAM,uBAAuB;CAC7C,IAAI,iCAAiC;CACrC,MAAM,cAAc,MAAM,4BAA4B,QAAQ;CAC9D,MAAM,wBAAwB;CAC9B,MAAM,qBAAqB,KAAK,MAC7B,wBAAwB,+BAAgC,IAC1D;AAED,OAAM,kBAAkB;EACtB;EACA,MAAM;EACN,kBAAkB;EAClB,iBAAiB;EACjB,aAAa,YAAY;GACvB,MAAM,UAAU,MAAM,oCAAoC,YAAY;AACtE,OAAI,QACF,kCAAiC;AAEnC,UAAO;;EAET,kBAAkB,OAAO,EAAE,SAAS,MAAM,WAAW;AACnD,OAAI,CAAC,+BACH;GAEF,MAAM,SAAS,MAAM,8BAA8B;IACjD,MAAM;IACN,UAAU;IACV,SAAS;IACV,CAAC;AACF,OAAI,OAAO,QACT;GAEF,MAAM,cAAc,mCAAmC,OAAO;AAC9D,QACE,mCAAmC,mBAAmB,+BACtD,CAAC,uBAAuB,cAAc,EACtC,aACA,KACD;;EAEJ,CAAC"}

package/dist/src/cli/commands/gateway/logs.js

@@ -1,4 +1,4 @@
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { execSync, spawn } from "child_process";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/logs.ts

package/dist/src/cli/commands/gateway/logs.js.map

@@ -1 +1 @@
-{"version":3,"file":"logs.js","names":[],"sources":["../../../../../src/cli/commands/gateway/logs.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { spawn, execSync } from 'child_process';\nimport { getContextWithOpts } from '../../index.js';\n\n/**\n * Create logs subcommand\n */\nexport function createLogsCommand(): Command {\n  return new Command('logs')\n    .description('View gateway logs')\n    .option('--lines <n>', 'Number of lines to show', '50')\n    .option('--follow', 'Follow log output (like tail -f)')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      \n      // Determine log directory from environment or default\n      const logDir = process.env.XOPC_LOG_DIR || \n        `${ctx.configPath.replace('/config.json', '')}/logs`;\n\n      try {\n        if (options.follow) {\n          // Follow mode: use tail -f\n          console.log(`📜 Following gateway logs (Ctrl+C to exit)...\\n`);\n          const tail = spawn('tail', ['-f', '-n', options.lines, `${logDir}/app.log`], {\n            stdio: 'inherit',\n          });\n          \n          tail.on('error', (err) => {\n            console.error('❌ Failed to tail logs:', err.message);\n            process.exit(1);\n          });\n        } else {\n          // Static mode: read last N lines\n          const output = execSync(\n            `tail -n ${options.lines} ${logDir}/app.log 2>/dev/null || echo \"No logs found\"`,\n            { encoding: 'utf-8' }\n          );\n          \n          console.log(`📜 Last ${options.lines} lines of gateway logs:\\n`);\n          console.log(output);\n          process.exit(0);\n        }\n      } catch (err) {\n        console.error('❌ Failed to read logs:', err);\n        process.exit(1);\n      }\n    });\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,oBAAoB,CAChC,OAAO,eAAe,2BAA2B,KAAK,CACtD,OAAO,YAAY,mCAAmC,CACtD,OAAO,OAAO,YAAY;EACzB,MAAM,MAAM,oBAAoB;EAGhC,MAAM,SAAS,QAAQ,IAAI,gBACzB,GAAG,IAAI,WAAW,QAAQ,gBAAgB,GAAG,CAAC;AAEhD,MAAI;AACF,OAAI,QAAQ,QAAQ;AAElB,YAAQ,IAAI,kDAAkD;AACjD,UAAM,QAAQ;KAAC;KAAM;KAAM,QAAQ;KAAO,GAAG,OAAO;KAAU,EAAE,EAC3E,OAAO,WACR,CAEG,CAAC,GAAG,UAAU,QAAQ;AACxB,aAAQ,MAAM,0BAA0B,IAAI,QAAQ;AACpD,aAAQ,KAAK,EAAE;MACf;UACG;IAEL,MAAM,SAAS,SACb,WAAW,QAAQ,MAAM,GAAG,OAAO,+CACnC,EAAE,UAAU,SAAS,CACtB;AAED,YAAQ,IAAI,WAAW,QAAQ,MAAM,2BAA2B;AAChE,YAAQ,IAAI,OAAO;AACnB,YAAQ,KAAK,EAAE;;WAEV,KAAK;AACZ,WAAQ,MAAM,0BAA0B,IAAI;AAC5C,WAAQ,KAAK,EAAE;;GAEjB"}
+{"version":3,"file":"logs.js","names":[],"sources":["../../../../../src/cli/commands/gateway/logs.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { spawn, execSync } from 'child_process';\nimport { getContextWithOpts } from '../../context.js';\n\n/**\n * Create logs subcommand\n */\nexport function createLogsCommand(): Command {\n  return new Command('logs')\n    .description('View gateway logs')\n    .option('--lines <n>', 'Number of lines to show', '50')\n    .option('--follow', 'Follow log output (like tail -f)')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      \n      // Determine log directory from environment or default\n      const logDir = process.env.XOPC_LOG_DIR || \n        `${ctx.configPath.replace('/config.json', '')}/logs`;\n\n      try {\n        if (options.follow) {\n          // Follow mode: use tail -f\n          console.log(`📜 Following gateway logs (Ctrl+C to exit)...\\n`);\n          const tail = spawn('tail', ['-f', '-n', options.lines, `${logDir}/app.log`], {\n            stdio: 'inherit',\n          });\n          \n          tail.on('error', (err) => {\n            console.error('❌ Failed to tail logs:', err.message);\n            process.exit(1);\n          });\n        } else {\n          // Static mode: read last N lines\n          const output = execSync(\n            `tail -n ${options.lines} ${logDir}/app.log 2>/dev/null || echo \"No logs found\"`,\n            { encoding: 'utf-8' }\n          );\n          \n          console.log(`📜 Last ${options.lines} lines of gateway logs:\\n`);\n          console.log(output);\n          process.exit(0);\n        }\n      } catch (err) {\n        console.error('❌ Failed to read logs:', err);\n        process.exit(1);\n      }\n    });\n}\n"],"mappings":";;;;;;;AAOA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,oBAAoB,CAChC,OAAO,eAAe,2BAA2B,KAAK,CACtD,OAAO,YAAY,mCAAmC,CACtD,OAAO,OAAO,YAAY;EACzB,MAAM,MAAM,oBAAoB;EAGhC,MAAM,SAAS,QAAQ,IAAI,gBACzB,GAAG,IAAI,WAAW,QAAQ,gBAAgB,GAAG,CAAC;AAEhD,MAAI;AACF,OAAI,QAAQ,QAAQ;AAElB,YAAQ,IAAI,kDAAkD;AACjD,UAAM,QAAQ;KAAC;KAAM;KAAM,QAAQ;KAAO,GAAG,OAAO;KAAU,EAAE,EAC3E,OAAO,WACR,CAEG,CAAC,GAAG,UAAU,QAAQ;AACxB,aAAQ,MAAM,0BAA0B,IAAI,QAAQ;AACpD,aAAQ,KAAK,EAAE;MACf;UACG;IAEL,MAAM,SAAS,SACb,WAAW,QAAQ,MAAM,GAAG,OAAO,+CACnC,EAAE,UAAU,SAAS,CACtB;AAED,YAAQ,IAAI,WAAW,QAAQ,MAAM,2BAA2B;AAChE,YAAQ,IAAI,OAAO;AACnB,YAAQ,KAAK,EAAE;;WAEV,KAAK;AACZ,WAAQ,MAAM,0BAA0B,IAAI;AAC5C,WAAQ,KAAK,EAAE;;GAEjB"}

package/dist/src/cli/commands/gateway/probe.js

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { addGatewayClientOptions, parseGatewayClientOptions } from "../../utils/gateway-client-options.js";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/probe.ts

package/dist/src/cli/commands/gateway/probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"probe.js","names":[],"sources":["../../../../../src/cli/commands/gateway/probe.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\nimport { getContextWithOpts } from '../../index.js';\n\ntype GatewayClientModule = typeof import('../../utils/gateway-client.js');\n\ninterface ProbeTarget {\n  label: string;\n  url: string;\n}\n\ninterface ProbeResultEntry {\n  label: string;\n  url: string;\n  reachable: boolean;\n  authenticated: boolean;\n  durationMs: number;\n  version?: string;\n  error?: string;\n}\n\nfunction resolveProbeTargets(opts: { url?: string; port: number }): ProbeTarget[] {\n  const targets: ProbeTarget[] = [];\n  const port = opts.port;\n  targets.push({ label: 'localhost', url: `http://127.0.0.1:${port}` });\n\n  if (opts.url) {\n    const normalized = opts.url.replace(/\\/+$/, '');\n    if (!normalized.includes('127.0.0.1') && !normalized.includes('localhost')) {\n      targets.push({ label: 'remote', url: normalized });\n    }\n  }\n\n  return targets;\n}\n\nasync function probeTarget(\n  callGatewayApi: GatewayClientModule['callGatewayApi'],\n  target: ProbeTarget,\n  token?: string,\n  timeoutMs?: number,\n): Promise<ProbeResultEntry> {\n  const healthResult = await callGatewayApi<{ status: string; version?: string }>('GET', '/api/health', {\n    url: target.url,\n    timeoutMs: timeoutMs ?? 5000,\n  });\n\n  if (!healthResult.ok) {\n    return {\n      label: target.label,\n      url: target.url,\n      reachable: false,\n      authenticated: false,\n      durationMs: healthResult.durationMs,\n      error: healthResult.error,\n    };\n  }\n\n  let authenticated = false;\n  if (token) {\n    const statusResult = await callGatewayApi('GET', '/api/status', {\n      url: target.url,\n      token,\n      timeoutMs: timeoutMs ?? 5000,\n    });\n    authenticated = statusResult.ok;\n  }\n\n  return {\n    label: target.label,\n    url: target.url,\n    reachable: true,\n    authenticated,\n    durationMs: healthResult.durationMs,\n    version: healthResult.data?.version,\n  };\n}\n\nexport function createProbeCommand(): Command {\n  const cmd = new Command('probe').description('Probe gateway reachability and auth capability');\n\n  addGatewayClientOptions(cmd);\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [{ loadConfig }, { callGatewayApi, resolveGatewayToken }] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../utils/gateway-client.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const token = resolveGatewayToken(clientOpts);\n    const targets = resolveProbeTargets({ url: clientOpts.url, port });\n    const results: ProbeResultEntry[] = [];\n\n    for (const target of targets) {\n      const result = await probeTarget(callGatewayApi, target, token, clientOpts.timeoutMs);\n      results.push(result);\n    }\n\n    if (clientOpts.json) {\n      console.log(JSON.stringify({ targets: results }, null, 2));\n      const anyReachable = results.some((r) => r.reachable);\n      process.exit(anyReachable ? 0 : 1);\n    }\n\n    console.log('🔍 Gateway Probe');\n    console.log('');\n\n    for (const result of results) {\n      if (result.reachable) {\n        console.log(`✅ ${result.label} (${result.url})`);\n        console.log(`   Reachable: yes (${result.durationMs}ms)`);\n        console.log(\n          `   Auth: ${result.authenticated ? '✅ authenticated' : '🔒 not authenticated (pass --token)'}`,\n        );\n        if (result.version) {\n          console.log(`   Version: ${result.version}`);\n        }\n      } else {\n        console.log(`❌ ${result.label} (${result.url})`);\n        console.log('   Reachable: no');\n        console.log(`   Error: ${result.error}`);\n      }\n      console.log('');\n    }\n\n    const anyReachable = results.some((r) => r.reachable);\n    if (!anyReachable) {\n      console.log('💡 Is the gateway running? Try: xopc gateway');\n    }\n    process.exit(anyReachable ? 0 : 1);\n  });\n\n  return cmd;\n}\n"],"mappings":";;;;;YAE6D;AAwB7D,SAAS,oBAAoB,MAAqD;CAChF,MAAM,UAAyB,EAAE;CACjC,MAAM,OAAO,KAAK;AAClB,SAAQ,KAAK;EAAE,OAAO;EAAa,KAAK,oBAAoB;EAAQ,CAAC;AAErE,KAAI,KAAK,KAAK;EACZ,MAAM,aAAa,KAAK,IAAI,QAAQ,QAAQ,GAAG;AAC/C,MAAI,CAAC,WAAW,SAAS,YAAY,IAAI,CAAC,WAAW,SAAS,YAAY,CACxE,SAAQ,KAAK;GAAE,OAAO;GAAU,KAAK;GAAY,CAAC;;AAItD,QAAO;;AAGT,eAAe,YACb,gBACA,QACA,OACA,WAC2B;CAC3B,MAAM,eAAe,MAAM,eAAqD,OAAO,eAAe;EACpG,KAAK,OAAO;EACZ,WAAW,aAAa;EACzB,CAAC;AAEF,KAAI,CAAC,aAAa,GAChB,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX,eAAe;EACf,YAAY,aAAa;EACzB,OAAO,aAAa;EACrB;CAGH,IAAI,gBAAgB;AACpB,KAAI,MAMF,kBAAgB,MALW,eAAe,OAAO,eAAe;EAC9D,KAAK,OAAO;EACZ;EACA,WAAW,aAAa;EACzB,CAAC,EAC2B;AAG/B,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX;EACA,YAAY,aAAa;EACzB,SAAS,aAAa,MAAM;EAC7B;;AAGH,SAAgB,qBAA8B;CAC5C,MAAM,MAAM,IAAI,QAAQ,QAAQ,CAAC,YAAY,iDAAiD;AAE9F,yBAAwB,IAAI;AAE5B,KAAI,OAAO,OAAO,YAAY;EAE5B,MAAM,aADM,oBACU,CAAC,cAAc,mBAAmB;EACxD,MAAM,CAAC,EAAE,cAAc,EAAE,gBAAgB,yBAAyB,MAAM,QAAQ,IAAI,CAClF,OAAO,6BACP,OAAO,iCACR,CAAC;EAEF,MAAM,OADS,WAAW,WACP,EAAE,SAAS,QAAQ;EAEtC,MAAM,aAAa;GAAE,GAAG,0BAA0B,QAAmC;GAAE;GAAY;EACnG,MAAM,QAAQ,oBAAoB,WAAW;EAC7C,MAAM,UAAU,oBAAoB;GAAE,KAAK,WAAW;GAAK;GAAM,CAAC;EAClE,MAAM,UAA8B,EAAE;AAEtC,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,gBAAgB,QAAQ,OAAO,WAAW,UAAU;AACrF,WAAQ,KAAK,OAAO;;AAGtB,MAAI,WAAW,MAAM;AACnB,WAAQ,IAAI,KAAK,UAAU,EAAE,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC;GAC1D,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,WAAQ,KAAK,eAAe,IAAI,EAAE;;AAGpC,UAAQ,IAAI,mBAAmB;AAC/B,UAAQ,IAAI,GAAG;AAEf,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,WAAW;AACpB,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,sBAAsB,OAAO,WAAW,KAAK;AACzD,YAAQ,IACN,YAAY,OAAO,gBAAgB,oBAAoB,wCACxD;AACD,QAAI,OAAO,QACT,SAAQ,IAAI,eAAe,OAAO,UAAU;UAEzC;AACL,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,mBAAmB;AAC/B,YAAQ,IAAI,aAAa,OAAO,QAAQ;;AAE1C,WAAQ,IAAI,GAAG;;EAGjB,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,MAAI,CAAC,aACH,SAAQ,IAAI,+CAA+C;AAE7D,UAAQ,KAAK,eAAe,IAAI,EAAE;GAClC;AAEF,QAAO"}
+{"version":3,"file":"probe.js","names":[],"sources":["../../../../../src/cli/commands/gateway/probe.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\nimport { getContextWithOpts } from '../../context.js';\n\ntype GatewayClientModule = typeof import('../../utils/gateway-client.js');\n\ninterface ProbeTarget {\n  label: string;\n  url: string;\n}\n\ninterface ProbeResultEntry {\n  label: string;\n  url: string;\n  reachable: boolean;\n  authenticated: boolean;\n  durationMs: number;\n  version?: string;\n  error?: string;\n}\n\nfunction resolveProbeTargets(opts: { url?: string; port: number }): ProbeTarget[] {\n  const targets: ProbeTarget[] = [];\n  const port = opts.port;\n  targets.push({ label: 'localhost', url: `http://127.0.0.1:${port}` });\n\n  if (opts.url) {\n    const normalized = opts.url.replace(/\\/+$/, '');\n    if (!normalized.includes('127.0.0.1') && !normalized.includes('localhost')) {\n      targets.push({ label: 'remote', url: normalized });\n    }\n  }\n\n  return targets;\n}\n\nasync function probeTarget(\n  callGatewayApi: GatewayClientModule['callGatewayApi'],\n  target: ProbeTarget,\n  token?: string,\n  timeoutMs?: number,\n): Promise<ProbeResultEntry> {\n  const healthResult = await callGatewayApi<{ status: string; version?: string }>('GET', '/api/health', {\n    url: target.url,\n    timeoutMs: timeoutMs ?? 5000,\n  });\n\n  if (!healthResult.ok) {\n    return {\n      label: target.label,\n      url: target.url,\n      reachable: false,\n      authenticated: false,\n      durationMs: healthResult.durationMs,\n      error: healthResult.error,\n    };\n  }\n\n  let authenticated = false;\n  if (token) {\n    const statusResult = await callGatewayApi('GET', '/api/status', {\n      url: target.url,\n      token,\n      timeoutMs: timeoutMs ?? 5000,\n    });\n    authenticated = statusResult.ok;\n  }\n\n  return {\n    label: target.label,\n    url: target.url,\n    reachable: true,\n    authenticated,\n    durationMs: healthResult.durationMs,\n    version: healthResult.data?.version,\n  };\n}\n\nexport function createProbeCommand(): Command {\n  const cmd = new Command('probe').description('Probe gateway reachability and auth capability');\n\n  addGatewayClientOptions(cmd);\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [{ loadConfig }, { callGatewayApi, resolveGatewayToken }] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../utils/gateway-client.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const token = resolveGatewayToken(clientOpts);\n    const targets = resolveProbeTargets({ url: clientOpts.url, port });\n    const results: ProbeResultEntry[] = [];\n\n    for (const target of targets) {\n      const result = await probeTarget(callGatewayApi, target, token, clientOpts.timeoutMs);\n      results.push(result);\n    }\n\n    if (clientOpts.json) {\n      console.log(JSON.stringify({ targets: results }, null, 2));\n      const anyReachable = results.some((r) => r.reachable);\n      process.exit(anyReachable ? 0 : 1);\n    }\n\n    console.log('🔍 Gateway Probe');\n    console.log('');\n\n    for (const result of results) {\n      if (result.reachable) {\n        console.log(`✅ ${result.label} (${result.url})`);\n        console.log(`   Reachable: yes (${result.durationMs}ms)`);\n        console.log(\n          `   Auth: ${result.authenticated ? '✅ authenticated' : '🔒 not authenticated (pass --token)'}`,\n        );\n        if (result.version) {\n          console.log(`   Version: ${result.version}`);\n        }\n      } else {\n        console.log(`❌ ${result.label} (${result.url})`);\n        console.log('   Reachable: no');\n        console.log(`   Error: ${result.error}`);\n      }\n      console.log('');\n    }\n\n    const anyReachable = results.some((r) => r.reachable);\n    if (!anyReachable) {\n      console.log('💡 Is the gateway running? Try: xopc gateway');\n    }\n    process.exit(anyReachable ? 0 : 1);\n  });\n\n  return cmd;\n}\n"],"mappings":";;;;;YAE6D;AAwB7D,SAAS,oBAAoB,MAAqD;CAChF,MAAM,UAAyB,EAAE;CACjC,MAAM,OAAO,KAAK;AAClB,SAAQ,KAAK;EAAE,OAAO;EAAa,KAAK,oBAAoB;EAAQ,CAAC;AAErE,KAAI,KAAK,KAAK;EACZ,MAAM,aAAa,KAAK,IAAI,QAAQ,QAAQ,GAAG;AAC/C,MAAI,CAAC,WAAW,SAAS,YAAY,IAAI,CAAC,WAAW,SAAS,YAAY,CACxE,SAAQ,KAAK;GAAE,OAAO;GAAU,KAAK;GAAY,CAAC;;AAItD,QAAO;;AAGT,eAAe,YACb,gBACA,QACA,OACA,WAC2B;CAC3B,MAAM,eAAe,MAAM,eAAqD,OAAO,eAAe;EACpG,KAAK,OAAO;EACZ,WAAW,aAAa;EACzB,CAAC;AAEF,KAAI,CAAC,aAAa,GAChB,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX,eAAe;EACf,YAAY,aAAa;EACzB,OAAO,aAAa;EACrB;CAGH,IAAI,gBAAgB;AACpB,KAAI,MAMF,kBAAgB,MALW,eAAe,OAAO,eAAe;EAC9D,KAAK,OAAO;EACZ;EACA,WAAW,aAAa;EACzB,CAAC,EAC2B;AAG/B,QAAO;EACL,OAAO,OAAO;EACd,KAAK,OAAO;EACZ,WAAW;EACX;EACA,YAAY,aAAa;EACzB,SAAS,aAAa,MAAM;EAC7B;;AAGH,SAAgB,qBAA8B;CAC5C,MAAM,MAAM,IAAI,QAAQ,QAAQ,CAAC,YAAY,iDAAiD;AAE9F,yBAAwB,IAAI;AAE5B,KAAI,OAAO,OAAO,YAAY;EAE5B,MAAM,aADM,oBACU,CAAC,cAAc,mBAAmB;EACxD,MAAM,CAAC,EAAE,cAAc,EAAE,gBAAgB,yBAAyB,MAAM,QAAQ,IAAI,CAClF,OAAO,6BACP,OAAO,iCACR,CAAC;EAEF,MAAM,OADS,WAAW,WACP,EAAE,SAAS,QAAQ;EAEtC,MAAM,aAAa;GAAE,GAAG,0BAA0B,QAAmC;GAAE;GAAY;EACnG,MAAM,QAAQ,oBAAoB,WAAW;EAC7C,MAAM,UAAU,oBAAoB;GAAE,KAAK,WAAW;GAAK;GAAM,CAAC;EAClE,MAAM,UAA8B,EAAE;AAEtC,OAAK,MAAM,UAAU,SAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,gBAAgB,QAAQ,OAAO,WAAW,UAAU;AACrF,WAAQ,KAAK,OAAO;;AAGtB,MAAI,WAAW,MAAM;AACnB,WAAQ,IAAI,KAAK,UAAU,EAAE,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC;GAC1D,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,WAAQ,KAAK,eAAe,IAAI,EAAE;;AAGpC,UAAQ,IAAI,mBAAmB;AAC/B,UAAQ,IAAI,GAAG;AAEf,OAAK,MAAM,UAAU,SAAS;AAC5B,OAAI,OAAO,WAAW;AACpB,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,sBAAsB,OAAO,WAAW,KAAK;AACzD,YAAQ,IACN,YAAY,OAAO,gBAAgB,oBAAoB,wCACxD;AACD,QAAI,OAAO,QACT,SAAQ,IAAI,eAAe,OAAO,UAAU;UAEzC;AACL,YAAQ,IAAI,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;AAChD,YAAQ,IAAI,mBAAmB;AAC/B,YAAQ,IAAI,aAAa,OAAO,QAAQ;;AAE1C,WAAQ,IAAI,GAAG;;EAGjB,MAAM,eAAe,QAAQ,MAAM,MAAM,EAAE,UAAU;AACrD,MAAI,CAAC,aACH,SAAQ,IAAI,+CAA+C;AAE7D,UAAQ,KAAK,eAAe,IAAI,EAAE;GAClC;AAEF,QAAO"}

package/dist/src/cli/commands/gateway/restart-health.d.ts

@@ -11,6 +11,7 @@ import type { GatewayServiceRuntime } from '../../../daemon/types.js';
 import type { PortUsage } from '../../../infra/ports.js';
 export declare const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 60000;
 export declare const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;
+export declare const DEFAULT_RESTART_HEALTH_ATTEMPTS: number;
 export type GatewayRestartWaitOutcome = 'healthy' | 'version-mismatch' | 'stale-pids' | 'stopped-free' | 'timeout';
 export interface GatewayRestartSnapshot {
     runtime?: GatewayServiceRuntime;
@@ -47,4 +48,15 @@ export declare function waitForRestartHealth(params: {
     token?: string;
     onProgress?: (snapshot: GatewayRestartSnapshot) => void;
 }): Promise<GatewayRestartSnapshot>;
+export type GatewayPortHealthSnapshot = {
+    portUsage?: PortUsage;
+    healthy: boolean;
+};
+export declare function waitForGatewayHealthyListener(params: {
+    port: number;
+    attempts?: number;
+    delayMs?: number;
+    token?: string;
+}): Promise<GatewayPortHealthSnapshot>;
+export declare function renderGatewayPortHealthDiagnostics(snapshot: GatewayPortHealthSnapshot): string[];
 export {};

package/dist/src/cli/commands/gateway/restart-health.js

@@ -1,10 +1,12 @@
 import { createLogger } from "../../../utils/logger/index.js";
 import { init_logger } from "../../../utils/logger.js";
+import { formatPortDiagnostics, inspectPortUsage } from "../../../infra/ports.js";
 //#region src/cli/commands/gateway/restart-health.ts
 init_logger();
 const log = createLogger("RestartHealth");
 const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 6e4;
 const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;
+const DEFAULT_RESTART_HEALTH_ATTEMPTS = Math.ceil(DEFAULT_RESTART_HEALTH_TIMEOUT_MS / 500);
 /**
 * Wait for gateway restart to complete and verify health.
 *
@@ -148,7 +150,49 @@ async function probeHealth(port, token) {
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
+async function inspectGatewayPortHealth(port, token) {
+	let portUsage;
+	try {
+		portUsage = await inspectPortUsage(port);
+	} catch (err) {
+		portUsage = {
+			port,
+			status: "unknown",
+			listeners: [],
+			hints: [],
+			errors: [String(err)]
+		};
+	}
+	let healthy = false;
+	if (portUsage.status === "busy") healthy = (await probeHealth(port, token)).ok;
+	return {
+		portUsage,
+		healthy
+	};
+}
+async function waitForGatewayHealthyListener(params) {
+	const attempts = params.attempts ?? DEFAULT_RESTART_HEALTH_ATTEMPTS;
+	const delayMs = params.delayMs ?? 500;
+	let snapshot = await inspectGatewayPortHealth(params.port, params.token);
+	for (let attempt = 0; attempt < attempts; attempt += 1) {
+		if (snapshot.healthy) return snapshot;
+		await sleep(delayMs);
+		snapshot = await inspectGatewayPortHealth(params.port, params.token);
+	}
+	return snapshot;
+}
+function renderGatewayPortHealthDiagnostics(snapshot) {
+	const lines = [];
+	if (!snapshot.portUsage) {
+		lines.push("Gateway port health unavailable.");
+		return lines;
+	}
+	if (snapshot.portUsage.status === "busy") lines.push(...formatPortDiagnostics(snapshot.portUsage));
+	else lines.push(`Gateway port ${snapshot.portUsage.port} status: ${snapshot.portUsage.status}.`);
+	if (snapshot.portUsage.errors?.length) lines.push(`Port diagnostics errors: ${snapshot.portUsage.errors.join("; ")}`);
+	return lines;
+}
 //#endregion
-export { DEFAULT_RESTART_HEALTH_DELAY_MS, DEFAULT_RESTART_HEALTH_TIMEOUT_MS, waitForRestartHealth };
+export { DEFAULT_RESTART_HEALTH_ATTEMPTS, DEFAULT_RESTART_HEALTH_DELAY_MS, DEFAULT_RESTART_HEALTH_TIMEOUT_MS, renderGatewayPortHealthDiagnostics, waitForGatewayHealthyListener, waitForRestartHealth };
 
 //# sourceMappingURL=restart-health.js.map

package/dist/src/cli/commands/gateway/restart-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"restart-health.js","names":[],"sources":["../../../../../src/cli/commands/gateway/restart-health.ts"],"sourcesContent":["/**\n * Restart Health - Wait loop after restart to verify gateway is healthy\n *\n * Polls service runtime + port usage + HTTP health probe to confirm:\n * 1. Service is running with a new PID\n * 2. Port is being listened on by the new process\n * 3. HTTP /api/health responds successfully\n * 4. Version matches expected (optional)\n */\n\nimport { createLogger } from '../../../utils/logger.js';\nimport type { GatewayServiceRuntime } from '../../../daemon/types.js';\nimport type { PortUsage } from '../../../infra/ports.js';\n\nconst log = createLogger('RestartHealth');\n\nexport const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 60_000;\nexport const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;\n\nexport type GatewayRestartWaitOutcome =\n  | 'healthy'\n  | 'version-mismatch'\n  | 'stale-pids'\n  | 'stopped-free'\n  | 'timeout';\n\nexport interface GatewayRestartSnapshot {\n  runtime?: GatewayServiceRuntime;\n  portUsage?: PortUsage;\n  healthy: boolean;\n  staleGatewayPids: number[];\n  gatewayVersion?: string | null;\n  expectedVersion?: string;\n  versionMismatch?: { expected: string; actual: string | null };\n  waitOutcome?: GatewayRestartWaitOutcome;\n  elapsedMs?: number;\n}\n\ninterface RestartHealthService {\n  readRuntime: (env?: Record<string, string | undefined>) => Promise<GatewayServiceRuntime>;\n}\n\n/**\n * Wait for gateway restart to complete and verify health.\n *\n * Loop:\n * 1. Check service runtime → get PID\n * 2. inspectPortUsage → confirm port is busy with new process\n * 3. HTTP probe /api/health → confirm reachable\n * 4. Version match (if expectedVersion provided)\n */\nexport async function waitForRestartHealth(params: {\n  service: RestartHealthService;\n  port: number;\n  expectedVersion?: string;\n  timeoutMs?: number;\n  delayMs?: number;\n  token?: string;\n  onProgress?: (snapshot: GatewayRestartSnapshot) => void;\n}): Promise<GatewayRestartSnapshot> {\n  const {\n    service,\n    port,\n    expectedVersion,\n    timeoutMs = DEFAULT_RESTART_HEALTH_TIMEOUT_MS,\n    delayMs = DEFAULT_RESTART_HEALTH_DELAY_MS,\n    token,\n    onProgress,\n  } = params;\n\n  const { inspectPortUsage, classifyPortListener } = await import('../../../infra/ports.js');\n\n  const startedAt = Date.now();\n\n  while (Date.now() - startedAt < timeoutMs) {\n    const elapsed = Date.now() - startedAt;\n\n    // 1. Check service runtime\n    const runtime = await service.readRuntime();\n\n    if (runtime.status !== 'running' || !runtime.pid) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        healthy: false,\n        staleGatewayPids: [],\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 2. Check port usage\n    const portUsage = await inspectPortUsage(port);\n\n    if (portUsage.status !== 'busy') {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids: [],\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 3. Verify port listener matches runtime PID\n    const gatewayListeners = portUsage.listeners.filter(\n      (l) => classifyPortListener(l, runtime.pid) === 'gateway',\n    );\n    const staleListeners = portUsage.listeners.filter(\n      (l) => l.pid && l.pid !== runtime.pid && classifyPortListener(l) === 'gateway',\n    );\n    const staleGatewayPids = staleListeners.map((l) => l.pid!).filter(Boolean);\n\n    if (gatewayListeners.length === 0) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 4. HTTP health probe\n    const healthResult = await probeHealth(port, token);\n\n    if (!healthResult.ok) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 5. Version check (optional)\n    const gatewayVersion = healthResult.version ?? null;\n\n    if (expectedVersion && gatewayVersion && gatewayVersion !== expectedVersion) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        gatewayVersion,\n        expectedVersion,\n        versionMismatch: { expected: expectedVersion, actual: gatewayVersion },\n        waitOutcome: 'version-mismatch',\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      return snapshot;\n    }\n\n    // Success!\n    const snapshot: GatewayRestartSnapshot = {\n      runtime,\n      portUsage,\n      healthy: true,\n      staleGatewayPids,\n      gatewayVersion,\n      expectedVersion,\n      waitOutcome: 'healthy',\n      elapsedMs: elapsed,\n    };\n    onProgress?.(snapshot);\n\n    log.info({ pid: runtime.pid, elapsedMs: elapsed, port }, 'Restart health confirmed');\n    return snapshot;\n  }\n\n  // Timeout\n  const finalRuntime = await service.readRuntime();\n  const finalSnapshot: GatewayRestartSnapshot = {\n    runtime: finalRuntime,\n    healthy: false,\n    staleGatewayPids: [],\n    waitOutcome: 'timeout',\n    elapsedMs: Date.now() - startedAt,\n  };\n\n  log.warn({ timeoutMs, port }, 'Restart health check timed out');\n  return finalSnapshot;\n}\n\n// ─── HTTP Health Probe ───\n\ninterface HealthProbeResult {\n  ok: boolean;\n  version?: string;\n  error?: string;\n}\n\nasync function probeHealth(port: number, token?: string): Promise<HealthProbeResult> {\n  try {\n    const headers: Record<string, string> = {};\n    if (token) {\n      headers['Authorization'] = `Bearer ${token}`;\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 3000);\n\n    const response = await fetch(`http://127.0.0.1:${port}/api/health`, {\n      method: 'GET',\n      headers,\n      signal: controller.signal,\n    });\n\n    clearTimeout(timeout);\n\n    if (!response.ok) {\n      return { ok: false, error: `HTTP ${response.status}` };\n    }\n\n    const body = await response.json() as { version?: string };\n    return { ok: true, version: body.version };\n  } catch (err) {\n    return { ok: false, error: err instanceof Error ? err.message : String(err) };\n  }\n}\n\n// ─── Utility ───\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":"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"}
+{"version":3,"file":"restart-health.js","names":[],"sources":["../../../../../src/cli/commands/gateway/restart-health.ts"],"sourcesContent":["/**\n * Restart Health - Wait loop after restart to verify gateway is healthy\n *\n * Polls service runtime + port usage + HTTP health probe to confirm:\n * 1. Service is running with a new PID\n * 2. Port is being listened on by the new process\n * 3. HTTP /api/health responds successfully\n * 4. Version matches expected (optional)\n */\n\nimport { createLogger } from '../../../utils/logger.js';\nimport type { GatewayServiceRuntime } from '../../../daemon/types.js';\nimport type { PortUsage } from '../../../infra/ports.js';\nimport { formatPortDiagnostics, inspectPortUsage } from '../../../infra/ports.js';\n\nconst log = createLogger('RestartHealth');\n\nexport const DEFAULT_RESTART_HEALTH_TIMEOUT_MS = 60_000;\nexport const DEFAULT_RESTART_HEALTH_DELAY_MS = 500;\nexport const DEFAULT_RESTART_HEALTH_ATTEMPTS = Math.ceil(\n  DEFAULT_RESTART_HEALTH_TIMEOUT_MS / DEFAULT_RESTART_HEALTH_DELAY_MS,\n);\n\nexport type GatewayRestartWaitOutcome =\n  | 'healthy'\n  | 'version-mismatch'\n  | 'stale-pids'\n  | 'stopped-free'\n  | 'timeout';\n\nexport interface GatewayRestartSnapshot {\n  runtime?: GatewayServiceRuntime;\n  portUsage?: PortUsage;\n  healthy: boolean;\n  staleGatewayPids: number[];\n  gatewayVersion?: string | null;\n  expectedVersion?: string;\n  versionMismatch?: { expected: string; actual: string | null };\n  waitOutcome?: GatewayRestartWaitOutcome;\n  elapsedMs?: number;\n}\n\ninterface RestartHealthService {\n  readRuntime: (env?: Record<string, string | undefined>) => Promise<GatewayServiceRuntime>;\n}\n\n/**\n * Wait for gateway restart to complete and verify health.\n *\n * Loop:\n * 1. Check service runtime → get PID\n * 2. inspectPortUsage → confirm port is busy with new process\n * 3. HTTP probe /api/health → confirm reachable\n * 4. Version match (if expectedVersion provided)\n */\nexport async function waitForRestartHealth(params: {\n  service: RestartHealthService;\n  port: number;\n  expectedVersion?: string;\n  timeoutMs?: number;\n  delayMs?: number;\n  token?: string;\n  onProgress?: (snapshot: GatewayRestartSnapshot) => void;\n}): Promise<GatewayRestartSnapshot> {\n  const {\n    service,\n    port,\n    expectedVersion,\n    timeoutMs = DEFAULT_RESTART_HEALTH_TIMEOUT_MS,\n    delayMs = DEFAULT_RESTART_HEALTH_DELAY_MS,\n    token,\n    onProgress,\n  } = params;\n\n  const { inspectPortUsage, classifyPortListener } = await import('../../../infra/ports.js');\n\n  const startedAt = Date.now();\n\n  while (Date.now() - startedAt < timeoutMs) {\n    const elapsed = Date.now() - startedAt;\n\n    // 1. Check service runtime\n    const runtime = await service.readRuntime();\n\n    if (runtime.status !== 'running' || !runtime.pid) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        healthy: false,\n        staleGatewayPids: [],\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 2. Check port usage\n    const portUsage = await inspectPortUsage(port);\n\n    if (portUsage.status !== 'busy') {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids: [],\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 3. Verify port listener matches runtime PID\n    const gatewayListeners = portUsage.listeners.filter(\n      (l) => classifyPortListener(l, runtime.pid) === 'gateway',\n    );\n    const staleListeners = portUsage.listeners.filter(\n      (l) => l.pid && l.pid !== runtime.pid && classifyPortListener(l) === 'gateway',\n    );\n    const staleGatewayPids = staleListeners.map((l) => l.pid!).filter(Boolean);\n\n    if (gatewayListeners.length === 0) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 4. HTTP health probe\n    const healthResult = await probeHealth(port, token);\n\n    if (!healthResult.ok) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      await sleep(delayMs);\n      continue;\n    }\n\n    // 5. Version check (optional)\n    const gatewayVersion = healthResult.version ?? null;\n\n    if (expectedVersion && gatewayVersion && gatewayVersion !== expectedVersion) {\n      const snapshot: GatewayRestartSnapshot = {\n        runtime,\n        portUsage,\n        healthy: false,\n        staleGatewayPids,\n        gatewayVersion,\n        expectedVersion,\n        versionMismatch: { expected: expectedVersion, actual: gatewayVersion },\n        waitOutcome: 'version-mismatch',\n        elapsedMs: elapsed,\n      };\n      onProgress?.(snapshot);\n      return snapshot;\n    }\n\n    // Success!\n    const snapshot: GatewayRestartSnapshot = {\n      runtime,\n      portUsage,\n      healthy: true,\n      staleGatewayPids,\n      gatewayVersion,\n      expectedVersion,\n      waitOutcome: 'healthy',\n      elapsedMs: elapsed,\n    };\n    onProgress?.(snapshot);\n\n    log.info({ pid: runtime.pid, elapsedMs: elapsed, port }, 'Restart health confirmed');\n    return snapshot;\n  }\n\n  // Timeout\n  const finalRuntime = await service.readRuntime();\n  const finalSnapshot: GatewayRestartSnapshot = {\n    runtime: finalRuntime,\n    healthy: false,\n    staleGatewayPids: [],\n    waitOutcome: 'timeout',\n    elapsedMs: Date.now() - startedAt,\n  };\n\n  log.warn({ timeoutMs, port }, 'Restart health check timed out');\n  return finalSnapshot;\n}\n\n// ─── HTTP Health Probe ───\n\ninterface HealthProbeResult {\n  ok: boolean;\n  version?: string;\n  error?: string;\n}\n\nasync function probeHealth(port: number, token?: string): Promise<HealthProbeResult> {\n  try {\n    const headers: Record<string, string> = {};\n    if (token) {\n      headers['Authorization'] = `Bearer ${token}`;\n    }\n\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 3000);\n\n    const response = await fetch(`http://127.0.0.1:${port}/api/health`, {\n      method: 'GET',\n      headers,\n      signal: controller.signal,\n    });\n\n    clearTimeout(timeout);\n\n    if (!response.ok) {\n      return { ok: false, error: `HTTP ${response.status}` };\n    }\n\n    const body = await response.json() as { version?: string };\n    return { ok: true, version: body.version };\n  } catch (err) {\n    return { ok: false, error: err instanceof Error ? err.message : String(err) };\n  }\n}\n\n// ─── Utility ───\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport type GatewayPortHealthSnapshot = {\n  portUsage?: PortUsage;\n  healthy: boolean;\n};\n\nasync function inspectGatewayPortHealth(port: number, token?: string): Promise<GatewayPortHealthSnapshot> {\n  let portUsage: PortUsage;\n  try {\n    portUsage = await inspectPortUsage(port);\n  } catch (err) {\n    portUsage = {\n      port,\n      status: 'unknown',\n      listeners: [],\n      hints: [],\n      errors: [String(err)],\n    };\n  }\n\n  let healthy = false;\n  if (portUsage.status === 'busy') {\n    const healthResult = await probeHealth(port, token);\n    healthy = healthResult.ok;\n  }\n\n  return { portUsage, healthy };\n}\n\nexport async function waitForGatewayHealthyListener(params: {\n  port: number;\n  attempts?: number;\n  delayMs?: number;\n  token?: string;\n}): Promise<GatewayPortHealthSnapshot> {\n  const attempts = params.attempts ?? DEFAULT_RESTART_HEALTH_ATTEMPTS;\n  const delayMs = params.delayMs ?? DEFAULT_RESTART_HEALTH_DELAY_MS;\n\n  let snapshot = await inspectGatewayPortHealth(params.port, params.token);\n  for (let attempt = 0; attempt < attempts; attempt += 1) {\n    if (snapshot.healthy) {\n      return snapshot;\n    }\n    await sleep(delayMs);\n    snapshot = await inspectGatewayPortHealth(params.port, params.token);\n  }\n  return snapshot;\n}\n\nexport function renderGatewayPortHealthDiagnostics(snapshot: GatewayPortHealthSnapshot): string[] {\n  const lines: string[] = [];\n  if (!snapshot.portUsage) {\n    lines.push('Gateway port health unavailable.');\n    return lines;\n  }\n  if (snapshot.portUsage.status === 'busy') {\n    lines.push(...formatPortDiagnostics(snapshot.portUsage));\n  } else {\n    lines.push(`Gateway port ${snapshot.portUsage.port} status: ${snapshot.portUsage.status}.`);\n  }\n  if (snapshot.portUsage.errors?.length) {\n    lines.push(`Port diagnostics errors: ${snapshot.portUsage.errors.join('; ')}`);\n  }\n  return lines;\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/restart.js

@@ -4,9 +4,9 @@ import { Command } from "commander";
 * Create restart subcommand - delegates to daemon lifecycle core
 */
 function createRestartCommand() {
-	return new Command("restart").description("Restart the gateway service").option("--force", "Force restart (kill if needed)").option("--wait <timeout>", "Wait for health after restart (e.g. \"30s\", \"1m\")").option("--json", "Output JSON").action(async (options) => {
-		const { executeDaemonRestart } = await import("./lifecycle-core.js");
-		await executeDaemonRestart(options);
+	return new Command("restart").description("Restart the gateway service").option("--wait <timeout>", "Wait for health after restart (e.g. \"30s\", \"1m\")").option("--json", "Output JSON").action(async (options) => {
+		const { runDaemonRestart } = await import("./lifecycle.js");
+		await runDaemonRestart(options);
 	});
 }
 //#endregion

package/dist/src/cli/commands/gateway/restart.js.map

@@ -1 +1 @@
-{"version":3,"file":"restart.js","names":[],"sources":["../../../../../src/cli/commands/gateway/restart.ts"],"sourcesContent":["import { Command } from 'commander';\n\n/**\n * Create restart subcommand - delegates to daemon lifecycle core\n */\nexport function createRestartCommand(): Command {\n  return new Command('restart')\n    .description('Restart the gateway service')\n    .option('--force', 'Force restart (kill if needed)')\n    .option('--wait <timeout>', 'Wait for health after restart (e.g. \"30s\", \"1m\")')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { executeDaemonRestart } = await import('./lifecycle-core.js');\n      await executeDaemonRestart(options);\n    });\n}\n"],"mappings":";;;;;AAKA,SAAgB,uBAAgC;AAC9C,QAAO,IAAI,QAAQ,UAAU,CAC1B,YAAY,8BAA8B,CAC1C,OAAO,WAAW,iCAAiC,CACnD,OAAO,oBAAoB,uDAAmD,CAC9E,OAAO,UAAU,cAAc,CAC/B,OAAO,OAAO,YAAY;EACzB,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,QAAM,qBAAqB,QAAQ;GACnC"}
+{"version":3,"file":"restart.js","names":[],"sources":["../../../../../src/cli/commands/gateway/restart.ts"],"sourcesContent":["import { Command } from 'commander';\n\n/**\n * Create restart subcommand - delegates to daemon lifecycle core\n */\nexport function createRestartCommand(): Command {\n  return new Command('restart')\n    .description('Restart the gateway service')\n    .option('--wait <timeout>', 'Wait for health after restart (e.g. \"30s\", \"1m\")')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { runDaemonRestart } = await import('./lifecycle.js');\n      await runDaemonRestart(options);\n    });\n}\n"],"mappings":";;;;;AAKA,SAAgB,uBAAgC;AAC9C,QAAO,IAAI,QAAQ,UAAU,CAC1B,YAAY,8BAA8B,CAC1C,OAAO,oBAAoB,uDAAmD,CAC9E,OAAO,UAAU,cAAc,CAC/B,OAAO,OAAO,YAAY;EACzB,MAAM,EAAE,qBAAqB,MAAM,OAAO;AAC1C,QAAM,iBAAiB,QAAQ;GAC/B"}

package/dist/src/cli/commands/gateway/run-foreground.d.ts

@@ -7,7 +7,6 @@ export type GatewayRunCliOptions = {
     tailscaleResetOnExit?: boolean;
     force?: boolean;
     hotReload?: boolean;
-    background?: boolean;
     foreground?: boolean;
 };
 export declare function runGatewayFromCliOptions(options: GatewayRunCliOptions, ctx: CLIContext): Promise<void>;

package/dist/src/cli/commands/gateway/run-foreground.js

@@ -1,4 +1,3 @@
-import { spawn } from "node:child_process";
 //#region src/cli/commands/gateway/run-foreground.ts
 async function ensureGatewayReady(configPath, workspacePath, port) {
 	const [{ initWorkspace }, { seedMainAgentProfileMarkdown }] = await Promise.all([import("../../utils/init-workspace.js"), import("../../../agent/context/workspace-seed.js")]);
@@ -103,40 +102,6 @@ async function runGatewayFromCliOptions(options, ctx) {
 		console.error(`Port ${port} is already in use. Use --force to kill existing process.`);
 		process.exit(1);
 	}
-	if (options.background === true) {
-		console.log("🚀 Starting xopc gateway in background...");
-		console.log(`   Bind: ${listenPlan.bindMode} (${bindHost})`);
-		console.log(`   Port: ${port}`);
-		console.log("");
-		const args = [
-			...process.execArgv,
-			...process.argv.slice(1).filter((arg) => arg !== "--background"),
-			"--foreground"
-		];
-		const child = spawn(process.execPath, args, {
-			detached: true,
-			stdio: "ignore",
-			env: process.env
-		});
-		child.unref();
-		await new Promise((resolve) => setTimeout(resolve, 500));
-		if (child.pid && !child.killed) {
-			const displayHost = bindHost === "0.0.0.0" ? "localhost" : bindHost;
-			console.log("✅ Gateway started in background");
-			console.log(`   PID: ${child.pid}`);
-			console.log(`   URL: http://${displayHost}:${port}`);
-			const token = options.token || config?.gateway?.auth?.token;
-			if (token) console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);
-			console.log("");
-			console.log("📝 Management commands:");
-			console.log(`   xopc gateway status     # Check status`);
-			console.log(`   xopc gateway stop       # Stop gateway`);
-			console.log(`   xopc gateway restart    # Restart gateway`);
-			process.exit(0);
-		}
-		console.error("❌ Failed to start gateway in background");
-		process.exit(1);
-	}
 	console.log("🚀 Starting xopc gateway...");
 	console.log(`   Bind: ${listenPlan.bindMode} (${bindHost})`);
 	console.log(`   Port: ${port}`);

package/dist/src/cli/commands/gateway/run-foreground.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-foreground.js","names":[],"sources":["../../../../../src/cli/commands/gateway/run-foreground.ts"],"sourcesContent":["import { spawn } from 'node:child_process';\n\nimport type { CLIContext } from '../../registry.js';\n\nexport type GatewayRunCliOptions = {\n  bind?: string;\n  port?: string | number;\n  token?: string;\n  tailscale?: string;\n  tailscaleResetOnExit?: boolean;\n  force?: boolean;\n  hotReload?: boolean;\n  background?: boolean;\n  foreground?: boolean;\n};\n\nasync function ensureGatewayReady(\n  configPath: string,\n  workspacePath: string,\n  port: number,\n): Promise<void> {\n  const [{ initWorkspace }, { seedMainAgentProfileMarkdown }] = await Promise.all([\n    import('../../utils/init-workspace.js'),\n    import('../../../agent/context/workspace-seed.js'),\n  ]);\n  const result = await initWorkspace({\n    configPath,\n    workspacePath,\n    gatewayPort: port,\n  });\n\n  if (result.configCreated || result.workspaceCreated) {\n    console.log('');\n    console.log('👋 Welcome to xopc! Running first-time setup before starting the gateway...');\n    console.log('');\n    console.log('✅ First-time setup complete!');\n    console.log(`   Config:    ${configPath}`);\n    console.log(`   Workspace: ${workspacePath}`);\n    console.log(`   Token:     ${result.token.slice(0, 8)}...${result.token.slice(-8)}`);\n    console.log('');\n    console.log('💡 Tip: run `xopc onboard` anytime to configure models, channels, and more.');\n    console.log('');\n    seedMainAgentProfileMarkdown(result.config);\n  }\n}\n\nexport async function runGatewayFromCliOptions(\n  options: GatewayRunCliOptions,\n  ctx: CLIContext,\n): Promise<void> {\n  const tailscaleModes = new Set(['off', 'serve', 'funnel']);\n  const tailscaleRaw =\n    typeof options.tailscale === 'string' ? options.tailscale.trim().toLowerCase() : undefined;\n  const tailscaleOverride =\n    tailscaleRaw && tailscaleModes.has(tailscaleRaw)\n      ? (tailscaleRaw as 'off' | 'serve' | 'funnel')\n      : undefined;\n  if (tailscaleRaw && !tailscaleOverride) {\n    console.error(`Invalid --tailscale mode \"${tailscaleRaw}\". Use: off, serve, funnel.`);\n    process.exit(1);\n  }\n\n  if (tailscaleOverride && tailscaleOverride !== 'off') {\n    process.env.XOPC_GATEWAY_TAILSCALE_MODE = tailscaleOverride;\n  }\n  if (options.tailscaleResetOnExit === true) {\n    process.env.XOPC_GATEWAY_TAILSCALE_RESET_ON_EXIT = '1';\n  }\n\n  const [{ loadConfig }, { resolveConfigPath }, { runGatewayLoop }, gatewayPorts] = await Promise.all([\n    import('../../../config/index.js'),\n    import('../../../config/paths.js'),\n    import('../../../gateway/run-loop.js'),\n    import('../../../gateway/ports.js'),\n  ]);\n  const { checkPortAvailable, forceFreePortAndWait } = gatewayPorts;\n  const config = loadConfig(ctx.configPath);\n\n  const bindFromFlagRaw =\n    typeof options.bind === 'string' && options.bind.trim().length > 0\n      ? options.bind.trim().toLowerCase()\n      : undefined;\n  const bindModes = new Set(['auto', 'loopback', 'lan', 'tailnet', 'custom']);\n  const bindFromFlag = bindFromFlagRaw && bindModes.has(bindFromFlagRaw)\n    ? (bindFromFlagRaw as import('../../../config/schema.js').GatewayBindMode)\n    : undefined;\n  if (bindFromFlagRaw && !bindFromFlag) {\n    console.error(`Invalid --bind mode \"${bindFromFlagRaw}\". Use: loopback, lan, auto, custom, tailnet.`);\n    process.exit(1);\n  }\n\n  const portRaw = options.port;\n  const portFromFlag =\n    portRaw !== undefined && portRaw !== null && String(portRaw).trim().length > 0\n      ? parseInt(String(portRaw), 10)\n      : undefined;\n\n  const { resolveGatewayListenPlan } = await import('../../../gateway/listen.js');\n  const listenPlan = resolveGatewayListenPlan({\n    cfg: config,\n    bindOverride: bindFromFlag,\n  });\n  const bindHost = listenPlan.bindHost;\n  const port =\n    portFromFlag !== undefined && Number.isFinite(portFromFlag)\n      ? portFromFlag\n      : (typeof config.gateway.port === 'number' ? config.gateway.port : 18790);\n\n  await ensureGatewayReady(ctx.configPath, ctx.workspacePath, port);\n\n  const effectiveConfig = loadConfig(ctx.configPath);\n  const { resolveGatewayAuth, assertGatewayAuthConfigured } = await import('../../../gateway/auth.js');\n  const { assertGatewayRuntimeConfig } = await import('../../../gateway/runtime-config.js');\n\n  let auth = resolveGatewayAuth({ authConfig: effectiveConfig.gateway?.auth });\n  if (typeof options.token === 'string' && options.token.trim().length > 0) {\n    auth = { mode: 'token', token: options.token.trim() };\n  }\n  try {\n    assertGatewayAuthConfigured(auth);\n    assertGatewayRuntimeConfig({\n      cfg: effectiveConfig,\n      auth,\n      bindOverride: bindFromFlag,\n      port,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(`Gateway refused to start: ${message}`);\n    process.exit(1);\n  }\n\n  if (options.force) {\n    try {\n      const result = await forceFreePortAndWait(port, {\n        timeoutMs: 2000,\n        sigtermTimeoutMs: 700,\n      });\n      if (result.killed.length > 0) {\n        console.log(`Force killed ${result.killed.length} process(es) on port ${port}`);\n        if (result.escalatedToSigkill) {\n          console.log('Escalated to SIGKILL');\n        }\n      }\n    } catch (err) {\n      console.error(`Failed to free port ${port}: ${String(err)}`);\n      process.exit(1);\n    }\n  }\n\n  const portAvailable = await checkPortAvailable(port, bindHost);\n  if (!portAvailable) {\n    console.error(`Port ${port} is already in use. Use --force to kill existing process.`);\n    process.exit(1);\n  }\n\n  if (options.background === true) {\n    console.log('🚀 Starting xopc gateway in background...');\n    console.log(`   Bind: ${listenPlan.bindMode} (${bindHost})`);\n    console.log(`   Port: ${port}`);\n    console.log('');\n\n    const args = [\n      ...process.execArgv,\n      ...process.argv.slice(1).filter((arg) => arg !== '--background'),\n      '--foreground',\n    ];\n\n    const child = spawn(process.execPath, args, {\n      detached: true,\n      stdio: 'ignore',\n      env: process.env,\n    });\n\n    child.unref();\n\n    await new Promise((resolve) => setTimeout(resolve, 500));\n\n    if (child.pid && !child.killed) {\n      const displayHost = bindHost === '0.0.0.0' ? 'localhost' : bindHost;\n      console.log('✅ Gateway started in background');\n      console.log(`   PID: ${child.pid}`);\n      console.log(`   URL: http://${displayHost}:${port}`);\n      const token = options.token || config?.gateway?.auth?.token;\n      if (token) {\n        console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n      }\n      console.log('');\n      console.log('📝 Management commands:');\n      console.log(`   xopc gateway status     # Check status`);\n      console.log(`   xopc gateway stop       # Stop gateway`);\n      console.log(`   xopc gateway restart    # Restart gateway`);\n      process.exit(0);\n    }\n\n    console.error('❌ Failed to start gateway in background');\n    process.exit(1);\n  }\n\n  console.log('🚀 Starting xopc gateway...');\n  console.log(`   Bind: ${listenPlan.bindMode} (${bindHost})`);\n  console.log(`   Port: ${port}`);\n  console.log('');\n  console.log('Press Ctrl+C to stop');\n  console.log('');\n\n  await runGatewayLoop({\n    configPath: ctx.configPath || resolveConfigPath(),\n    port,\n    start: async () => {\n      const { GatewayServer } = await import('../../../gateway/index.js');\n      const server = new GatewayServer({\n        bindHost: listenPlan.bindHost,\n        bind: listenPlan.bindMode,\n        customBindHost: listenPlan.customBindHost,\n        port,\n        token: options.token || config?.gateway?.auth?.token,\n        verbose: ctx.isVerbose,\n        configPath: ctx.configPath,\n        enableHotReload: options.hotReload,\n      });\n      await server.start();\n\n      const displayHost = bindHost === '0.0.0.0' ? 'localhost' : bindHost;\n      const token = options.token || config?.gateway?.auth?.token;\n      console.log('✅ Gateway started');\n      console.log(`   URL: http://${displayHost}:${port}`);\n      if (token) {\n        console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n      }\n      console.log('');\n\n      return server;\n    },\n  });\n}\n"],"mappings":";;AAgBA,eAAe,mBACb,YACA,eACA,MACe;CACf,MAAM,CAAC,EAAE,iBAAiB,EAAE,kCAAkC,MAAM,QAAQ,IAAI,CAC9E,OAAO,kCACP,OAAO,4CACR,CAAC;CACF,MAAM,SAAS,MAAM,cAAc;EACjC;EACA;EACA,aAAa;EACd,CAAC;AAEF,KAAI,OAAO,iBAAiB,OAAO,kBAAkB;AACnD,UAAQ,IAAI,GAAG;AACf,UAAQ,IAAI,8EAA8E;AAC1F,UAAQ,IAAI,GAAG;AACf,UAAQ,IAAI,+BAA+B;AAC3C,UAAQ,IAAI,iBAAiB,aAAa;AAC1C,UAAQ,IAAI,iBAAiB,gBAAgB;AAC7C,UAAQ,IAAI,iBAAiB,OAAO,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,OAAO,MAAM,MAAM,GAAG,GAAG;AACpF,UAAQ,IAAI,GAAG;AACf,UAAQ,IAAI,8EAA8E;AAC1F,UAAQ,IAAI,GAAG;AACf,+BAA6B,OAAO,OAAO;;;AAI/C,eAAsB,yBACpB,SACA,KACe;CACf,MAAM,iBAAiB,IAAI,IAAI;EAAC;EAAO;EAAS;EAAS,CAAC;CAC1D,MAAM,eACJ,OAAO,QAAQ,cAAc,WAAW,QAAQ,UAAU,MAAM,CAAC,aAAa,GAAG,KAAA;CACnF,MAAM,oBACJ,gBAAgB,eAAe,IAAI,aAAa,GAC3C,eACD,KAAA;AACN,KAAI,gBAAgB,CAAC,mBAAmB;AACtC,UAAQ,MAAM,6BAA6B,aAAa,6BAA6B;AACrF,UAAQ,KAAK,EAAE;;AAGjB,KAAI,qBAAqB,sBAAsB,MAC7C,SAAQ,IAAI,8BAA8B;AAE5C,KAAI,QAAQ,yBAAyB,KACnC,SAAQ,IAAI,uCAAuC;CAGrD,MAAM,CAAC,EAAE,cAAc,EAAE,qBAAqB,EAAE,kBAAkB,gBAAgB,MAAM,QAAQ,IAAI;EAClG,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO;EACR,CAAC;CACF,MAAM,EAAE,oBAAoB,yBAAyB;CACrD,MAAM,SAAS,WAAW,IAAI,WAAW;CAEzC,MAAM,kBACJ,OAAO,QAAQ,SAAS,YAAY,QAAQ,KAAK,MAAM,CAAC,SAAS,IAC7D,QAAQ,KAAK,MAAM,CAAC,aAAa,GACjC,KAAA;CAEN,MAAM,eAAe,mBAAmB,IADlB,IAAI;EAAC;EAAQ;EAAY;EAAO;EAAW;EAAS,CACzB,CAAC,IAAI,gBAAgB,GACjE,kBACD,KAAA;AACJ,KAAI,mBAAmB,CAAC,cAAc;AACpC,UAAQ,MAAM,wBAAwB,gBAAgB,+CAA+C;AACrG,UAAQ,KAAK,EAAE;;CAGjB,MAAM,UAAU,QAAQ;CACxB,MAAM,eACJ,YAAY,KAAA,KAAa,YAAY,QAAQ,OAAO,QAAQ,CAAC,MAAM,CAAC,SAAS,IACzE,SAAS,OAAO,QAAQ,EAAE,GAAG,GAC7B,KAAA;CAEN,MAAM,EAAE,6BAA6B,MAAM,OAAO;CAClD,MAAM,aAAa,yBAAyB;EAC1C,KAAK;EACL,cAAc;EACf,CAAC;CACF,MAAM,WAAW,WAAW;CAC5B,MAAM,OACJ,iBAAiB,KAAA,KAAa,OAAO,SAAS,aAAa,GACvD,eACC,OAAO,OAAO,QAAQ,SAAS,WAAW,OAAO,QAAQ,OAAO;AAEvE,OAAM,mBAAmB,IAAI,YAAY,IAAI,eAAe,KAAK;CAEjE,MAAM,kBAAkB,WAAW,IAAI,WAAW;CAClD,MAAM,EAAE,oBAAoB,gCAAgC,MAAM,OAAO;CACzE,MAAM,EAAE,+BAA+B,MAAM,OAAO;CAEpD,IAAI,OAAO,mBAAmB,EAAE,YAAY,gBAAgB,SAAS,MAAM,CAAC;AAC5E,KAAI,OAAO,QAAQ,UAAU,YAAY,QAAQ,MAAM,MAAM,CAAC,SAAS,EACrE,QAAO;EAAE,MAAM;EAAS,OAAO,QAAQ,MAAM,MAAM;EAAE;AAEvD,KAAI;AACF,8BAA4B,KAAK;AACjC,6BAA2B;GACzB,KAAK;GACL;GACA,cAAc;GACd;GACD,CAAC;UACK,KAAK;EACZ,MAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI;AAChE,UAAQ,MAAM,6BAA6B,UAAU;AACrD,UAAQ,KAAK,EAAE;;AAGjB,KAAI,QAAQ,MACV,KAAI;EACF,MAAM,SAAS,MAAM,qBAAqB,MAAM;GAC9C,WAAW;GACX,kBAAkB;GACnB,CAAC;AACF,MAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,WAAQ,IAAI,gBAAgB,OAAO,OAAO,OAAO,uBAAuB,OAAO;AAC/E,OAAI,OAAO,mBACT,SAAQ,IAAI,uBAAuB;;UAGhC,KAAK;AACZ,UAAQ,MAAM,uBAAuB,KAAK,IAAI,OAAO,IAAI,GAAG;AAC5D,UAAQ,KAAK,EAAE;;AAKnB,KAAI,CAAC,MADuB,mBAAmB,MAAM,SAAS,EAC1C;AAClB,UAAQ,MAAM,QAAQ,KAAK,2DAA2D;AACtF,UAAQ,KAAK,EAAE;;AAGjB,KAAI,QAAQ,eAAe,MAAM;AAC/B,UAAQ,IAAI,4CAA4C;AACxD,UAAQ,IAAI,YAAY,WAAW,SAAS,IAAI,SAAS,GAAG;AAC5D,UAAQ,IAAI,YAAY,OAAO;AAC/B,UAAQ,IAAI,GAAG;EAEf,MAAM,OAAO;GACX,GAAG,QAAQ;GACX,GAAG,QAAQ,KAAK,MAAM,EAAE,CAAC,QAAQ,QAAQ,QAAQ,eAAe;GAChE;GACD;EAED,MAAM,QAAQ,MAAM,QAAQ,UAAU,MAAM;GAC1C,UAAU;GACV,OAAO;GACP,KAAK,QAAQ;GACd,CAAC;AAEF,QAAM,OAAO;AAEb,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,IAAI,CAAC;AAExD,MAAI,MAAM,OAAO,CAAC,MAAM,QAAQ;GAC9B,MAAM,cAAc,aAAa,YAAY,cAAc;AAC3D,WAAQ,IAAI,kCAAkC;AAC9C,WAAQ,IAAI,WAAW,MAAM,MAAM;AACnC,WAAQ,IAAI,kBAAkB,YAAY,GAAG,OAAO;GACpD,MAAM,QAAQ,QAAQ,SAAS,QAAQ,SAAS,MAAM;AACtD,OAAI,MACF,SAAQ,IAAI,aAAa,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,MAAM,GAAG,GAAG;AAEpE,WAAQ,IAAI,GAAG;AACf,WAAQ,IAAI,0BAA0B;AACtC,WAAQ,IAAI,4CAA4C;AACxD,WAAQ,IAAI,4CAA4C;AACxD,WAAQ,IAAI,+CAA+C;AAC3D,WAAQ,KAAK,EAAE;;AAGjB,UAAQ,MAAM,0CAA0C;AACxD,UAAQ,KAAK,EAAE;;AAGjB,SAAQ,IAAI,8BAA8B;AAC1C,SAAQ,IAAI,YAAY,WAAW,SAAS,IAAI,SAAS,GAAG;AAC5D,SAAQ,IAAI,YAAY,OAAO;AAC/B,SAAQ,IAAI,GAAG;AACf,SAAQ,IAAI,uBAAuB;AACnC,SAAQ,IAAI,GAAG;AAEf,OAAM,eAAe;EACnB,YAAY,IAAI,cAAc,mBAAmB;EACjD;EACA,OAAO,YAAY;GACjB,MAAM,EAAE,kBAAkB,MAAM,OAAO;GACvC,MAAM,SAAS,IAAI,cAAc;IAC/B,UAAU,WAAW;IACrB,MAAM,WAAW;IACjB,gBAAgB,WAAW;IAC3B;IACA,OAAO,QAAQ,SAAS,QAAQ,SAAS,MAAM;IAC/C,SAAS,IAAI;IACb,YAAY,IAAI;IAChB,iBAAiB,QAAQ;IAC1B,CAAC;AACF,SAAM,OAAO,OAAO;GAEpB,MAAM,cAAc,aAAa,YAAY,cAAc;GAC3D,MAAM,QAAQ,QAAQ,SAAS,QAAQ,SAAS,MAAM;AACtD,WAAQ,IAAI,oBAAoB;AAChC,WAAQ,IAAI,kBAAkB,YAAY,GAAG,OAAO;AACpD,OAAI,MACF,SAAQ,IAAI,aAAa,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,MAAM,GAAG,GAAG;AAEpE,WAAQ,IAAI,GAAG;AAEf,UAAO;;EAEV,CAAC"}
+{"version":3,"file":"run-foreground.js","names":[],"sources":["../../../../../src/cli/commands/gateway/run-foreground.ts"],"sourcesContent":["import type { CLIContext } from '../../registry.js';\n\nexport type GatewayRunCliOptions = {\n  bind?: string;\n  port?: string | number;\n  token?: string;\n  tailscale?: string;\n  tailscaleResetOnExit?: boolean;\n  force?: boolean;\n  hotReload?: boolean;\n  foreground?: boolean;\n};\n\nasync function ensureGatewayReady(\n  configPath: string,\n  workspacePath: string,\n  port: number,\n): Promise<void> {\n  const [{ initWorkspace }, { seedMainAgentProfileMarkdown }] = await Promise.all([\n    import('../../utils/init-workspace.js'),\n    import('../../../agent/context/workspace-seed.js'),\n  ]);\n  const result = await initWorkspace({\n    configPath,\n    workspacePath,\n    gatewayPort: port,\n  });\n\n  if (result.configCreated || result.workspaceCreated) {\n    console.log('');\n    console.log('👋 Welcome to xopc! Running first-time setup before starting the gateway...');\n    console.log('');\n    console.log('✅ First-time setup complete!');\n    console.log(`   Config:    ${configPath}`);\n    console.log(`   Workspace: ${workspacePath}`);\n    console.log(`   Token:     ${result.token.slice(0, 8)}...${result.token.slice(-8)}`);\n    console.log('');\n    console.log('💡 Tip: run `xopc onboard` anytime to configure models, channels, and more.');\n    console.log('');\n    seedMainAgentProfileMarkdown(result.config);\n  }\n}\n\nexport async function runGatewayFromCliOptions(\n  options: GatewayRunCliOptions,\n  ctx: CLIContext,\n): Promise<void> {\n  const tailscaleModes = new Set(['off', 'serve', 'funnel']);\n  const tailscaleRaw =\n    typeof options.tailscale === 'string' ? options.tailscale.trim().toLowerCase() : undefined;\n  const tailscaleOverride =\n    tailscaleRaw && tailscaleModes.has(tailscaleRaw)\n      ? (tailscaleRaw as 'off' | 'serve' | 'funnel')\n      : undefined;\n  if (tailscaleRaw && !tailscaleOverride) {\n    console.error(`Invalid --tailscale mode \"${tailscaleRaw}\". Use: off, serve, funnel.`);\n    process.exit(1);\n  }\n\n  if (tailscaleOverride && tailscaleOverride !== 'off') {\n    process.env.XOPC_GATEWAY_TAILSCALE_MODE = tailscaleOverride;\n  }\n  if (options.tailscaleResetOnExit === true) {\n    process.env.XOPC_GATEWAY_TAILSCALE_RESET_ON_EXIT = '1';\n  }\n\n  const [{ loadConfig }, { resolveConfigPath }, { runGatewayLoop }, gatewayPorts] = await Promise.all([\n    import('../../../config/index.js'),\n    import('../../../config/paths.js'),\n    import('../../../gateway/run-loop.js'),\n    import('../../../gateway/ports.js'),\n  ]);\n  const { checkPortAvailable, forceFreePortAndWait } = gatewayPorts;\n  const config = loadConfig(ctx.configPath);\n\n  const bindFromFlagRaw =\n    typeof options.bind === 'string' && options.bind.trim().length > 0\n      ? options.bind.trim().toLowerCase()\n      : undefined;\n  const bindModes = new Set(['auto', 'loopback', 'lan', 'tailnet', 'custom']);\n  const bindFromFlag = bindFromFlagRaw && bindModes.has(bindFromFlagRaw)\n    ? (bindFromFlagRaw as import('../../../config/schema.js').GatewayBindMode)\n    : undefined;\n  if (bindFromFlagRaw && !bindFromFlag) {\n    console.error(`Invalid --bind mode \"${bindFromFlagRaw}\". Use: loopback, lan, auto, custom, tailnet.`);\n    process.exit(1);\n  }\n\n  const portRaw = options.port;\n  const portFromFlag =\n    portRaw !== undefined && portRaw !== null && String(portRaw).trim().length > 0\n      ? parseInt(String(portRaw), 10)\n      : undefined;\n\n  const { resolveGatewayListenPlan } = await import('../../../gateway/listen.js');\n  const listenPlan = resolveGatewayListenPlan({\n    cfg: config,\n    bindOverride: bindFromFlag,\n  });\n  const bindHost = listenPlan.bindHost;\n  const port =\n    portFromFlag !== undefined && Number.isFinite(portFromFlag)\n      ? portFromFlag\n      : (typeof config.gateway.port === 'number' ? config.gateway.port : 18790);\n\n  await ensureGatewayReady(ctx.configPath, ctx.workspacePath, port);\n\n  const effectiveConfig = loadConfig(ctx.configPath);\n  const { resolveGatewayAuth, assertGatewayAuthConfigured } = await import('../../../gateway/auth.js');\n  const { assertGatewayRuntimeConfig } = await import('../../../gateway/runtime-config.js');\n\n  let auth = resolveGatewayAuth({ authConfig: effectiveConfig.gateway?.auth });\n  if (typeof options.token === 'string' && options.token.trim().length > 0) {\n    auth = { mode: 'token', token: options.token.trim() };\n  }\n  try {\n    assertGatewayAuthConfigured(auth);\n    assertGatewayRuntimeConfig({\n      cfg: effectiveConfig,\n      auth,\n      bindOverride: bindFromFlag,\n      port,\n    });\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err);\n    console.error(`Gateway refused to start: ${message}`);\n    process.exit(1);\n  }\n\n  if (options.force) {\n    try {\n      const result = await forceFreePortAndWait(port, {\n        timeoutMs: 2000,\n        sigtermTimeoutMs: 700,\n      });\n      if (result.killed.length > 0) {\n        console.log(`Force killed ${result.killed.length} process(es) on port ${port}`);\n        if (result.escalatedToSigkill) {\n          console.log('Escalated to SIGKILL');\n        }\n      }\n    } catch (err) {\n      console.error(`Failed to free port ${port}: ${String(err)}`);\n      process.exit(1);\n    }\n  }\n\n  const portAvailable = await checkPortAvailable(port, bindHost);\n  if (!portAvailable) {\n    console.error(`Port ${port} is already in use. Use --force to kill existing process.`);\n    process.exit(1);\n  }\n\n  console.log('🚀 Starting xopc gateway...');\n  console.log(`   Bind: ${listenPlan.bindMode} (${bindHost})`);\n  console.log(`   Port: ${port}`);\n  console.log('');\n  console.log('Press Ctrl+C to stop');\n  console.log('');\n\n  await runGatewayLoop({\n    configPath: ctx.configPath || resolveConfigPath(),\n    port,\n    start: async () => {\n      const { GatewayServer } = await import('../../../gateway/index.js');\n      const server = new GatewayServer({\n        bindHost: listenPlan.bindHost,\n        bind: listenPlan.bindMode,\n        customBindHost: listenPlan.customBindHost,\n        port,\n        token: options.token || config?.gateway?.auth?.token,\n        verbose: ctx.isVerbose,\n        configPath: ctx.configPath,\n        enableHotReload: options.hotReload,\n      });\n      await server.start();\n\n      const displayHost = bindHost === '0.0.0.0' ? 'localhost' : bindHost;\n      const token = options.token || config?.gateway?.auth?.token;\n      console.log('✅ Gateway started');\n      console.log(`   URL: http://${displayHost}:${port}`);\n      if (token) {\n        console.log(`   Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n      }\n      console.log('');\n\n      return server;\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/service.js

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/service.ts
 init_paths();

package/dist/src/cli/commands/gateway/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/cli/commands/gateway/service.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { getContextWithOpts } from '../../index.js';\n\n/**\n * Create service install subcommand - actually installs the OS service\n */\nexport function createInstallCommand(): Command {\n  return new Command('install')\n    .description('Install gateway as OS service (LaunchAgent / systemd / Task)')\n    .option('--port <port>', 'Gateway port')\n    .option('--token <token>', 'Gateway auth token')\n    .option('--force', 'Force reinstall if already installed')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      const configPath = ctx.configPath || resolveConfigPath();\n\n      const [{ loadConfig }, { resolveGatewayService, isDaemonAvailableAsync, getPlatformName }, { buildGatewayInstallArgs }] =\n        await Promise.all([\n          import('../../../config/index.js'),\n          import('../../../daemon/service.js'),\n          import('../../../daemon/install-plan.js'),\n        ]);\n\n      const config = loadConfig(configPath);\n      const port = options.port ? parseInt(options.port, 10) : (config?.gateway?.port || 18790);\n      const bind = config?.gateway?.bind ?? 'loopback';\n      const token = options.token || config?.gateway?.auth?.token;\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        if (options.json) {\n          console.log(JSON.stringify({ ok: false, error: 'Daemon not available' }));\n        } else {\n          console.error(`❌ OS service not available on ${getPlatformName()}`);\n        }\n        process.exit(1);\n      }\n\n      const service = await resolveGatewayService();\n\n      // Check if already installed\n      const loaded = await service.isLoaded({ env: process.env });\n      if (loaded && !options.force) {\n        if (options.json) {\n          console.log(JSON.stringify({ ok: true, result: 'already-installed' }));\n        } else {\n          console.log('ℹ️  Service already installed. Use --force to reinstall.');\n        }\n        return;\n      }\n\n      // Uninstall first if force\n      if (loaded && options.force) {\n        try {\n          await service.uninstall({ env: process.env });\n        } catch {\n          // Best-effort\n        }\n      }\n\n      // Build install args and install\n      const installArgs = buildGatewayInstallArgs({ port, bind, token });\n      installArgs.stdout = process.stdout;\n\n      try {\n        await service.install(installArgs);\n\n        if (options.json) {\n          console.log(JSON.stringify({ ok: true, result: 'installed', label: service.label, port }));\n        } else {\n          console.log('');\n          console.log(`✅ Gateway service installed`);\n          console.log(`   Service: ${service.label}`);\n          console.log(`   Port: ${port}`);\n          console.log('');\n          console.log('💡 The service will start automatically on login.');\n          console.log('   Use `xopc gateway status` to verify.');\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        if (options.json) {\n          console.log(JSON.stringify({ ok: false, error: message }));\n        } else {\n          console.error(`❌ Failed to install service: ${message}`);\n        }\n        process.exit(1);\n      }\n    });\n}\n\n/**\n * Create service uninstall subcommand\n */\nexport function createUninstallCommand(): Command {\n  return new Command('uninstall')\n    .description('Uninstall gateway OS service')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { executeDaemonUninstall } = await import('./lifecycle-core.js');\n      await executeDaemonUninstall(options);\n    });\n}\n\n/**\n * Create service start subcommand - starts via daemon service manager\n */\nexport function createServiceStartCommand(): Command {\n  return new Command('start')\n    .description('Start gateway via OS service manager')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const [{ resolveGatewayService, startGatewayService, isDaemonAvailableAsync }] =\n        await Promise.all([import('../../../daemon/service.js')]);\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        console.error('❌ Daemon not available on this platform');\n        process.exit(1);\n      }\n\n      const service = await resolveGatewayService();\n      const result = await startGatewayService({ service });\n\n      if (options.json) {\n        console.log(JSON.stringify({ ok: result.outcome === 'started', outcome: result.outcome }));\n        return;\n      }\n\n      switch (result.outcome) {\n        case 'started':\n          console.log('✅ Gateway service started');\n          break;\n        case 'missing-install':\n          console.error('❌ Service not installed. Run: xopc gateway service install');\n          process.exit(1);\n          break;\n        case 'repair-required':\n          console.error('⚠️  Service needs repair:');\n          for (const issue of result.issues || []) {\n            console.error(`   - ${issue.message}`);\n          }\n          console.log('💡 Run: xopc gateway service install --force');\n          process.exit(1);\n          break;\n        default:\n          console.log(`ℹ️  Service start outcome: ${result.outcome}`);\n      }\n    });\n}\n\n/**\n * Create service status subcommand\n */\nexport function createServiceStatusCommand(): Command {\n  return new Command('service-status')\n    .description('Show OS service status')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const [{ resolveGatewayService, isDaemonAvailableAsync, getPlatformName }] =\n        await Promise.all([import('../../../daemon/service.js')]);\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        if (options.json) {\n          console.log(JSON.stringify({ available: false, platform: process.platform }));\n        } else {\n          console.log(`ℹ️  Daemon not available on ${getPlatformName()}`);\n        }\n        return;\n      }\n\n      const service = await resolveGatewayService();\n      const [loaded, runtime, command] = await Promise.all([\n        service.isLoaded({ env: process.env }),\n        service.readRuntime(),\n        service.readCommand(),\n      ]);\n\n      if (options.json) {\n        console.log(JSON.stringify({ available: true, loaded, runtime, command, label: service.label }, null, 2));\n        return;\n      }\n\n      console.log('📊 Gateway Service Status');\n      console.log('');\n      console.log(`   Platform: ${getPlatformName()}`);\n      console.log(`   Service:  ${loaded ? service.loadedText : service.notLoadedText}`);\n      console.log(`   Runtime:  ${runtime.status}${runtime.pid ? ` (pid ${runtime.pid})` : ''}`);\n\n      if (command) {\n        const portMatch = command.programArguments.join(' ').match(/--port\\s+(\\d+)/);\n        if (portMatch) {\n          console.log(`   Port:     ${portMatch[1]}`);\n        }\n        const version = command.environment?.XOPC_SERVICE_VERSION;\n        if (version) {\n          console.log(`   Version:  ${version}`);\n        }\n      }\n\n      if (!loaded) {\n        console.log('');\n        console.log('💡 Install with: xopc gateway service install');\n      }\n    });\n}\n"],"mappings":"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"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../../../src/cli/commands/gateway/service.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { getContextWithOpts } from '../../context.js';\n\n/**\n * Create service install subcommand - actually installs the OS service\n */\nexport function createInstallCommand(): Command {\n  return new Command('install')\n    .description('Install gateway as OS service (LaunchAgent / systemd / Task)')\n    .option('--port <port>', 'Gateway port')\n    .option('--token <token>', 'Gateway auth token')\n    .option('--force', 'Force reinstall if already installed')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const ctx = getContextWithOpts();\n      const configPath = ctx.configPath || resolveConfigPath();\n\n      const [{ loadConfig }, { resolveGatewayService, isDaemonAvailableAsync, getPlatformName }, { buildGatewayInstallArgs }] =\n        await Promise.all([\n          import('../../../config/index.js'),\n          import('../../../daemon/service.js'),\n          import('../../../daemon/install-plan.js'),\n        ]);\n\n      const config = loadConfig(configPath);\n      const port = options.port ? parseInt(options.port, 10) : (config?.gateway?.port || 18790);\n      const bind = config?.gateway?.bind ?? 'loopback';\n      const token = options.token || config?.gateway?.auth?.token;\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        if (options.json) {\n          console.log(JSON.stringify({ ok: false, error: 'Daemon not available' }));\n        } else {\n          console.error(`❌ OS service not available on ${getPlatformName()}`);\n        }\n        process.exit(1);\n      }\n\n      const service = await resolveGatewayService();\n\n      // Check if already installed\n      const loaded = await service.isLoaded({ env: process.env });\n      if (loaded && !options.force) {\n        if (options.json) {\n          console.log(JSON.stringify({ ok: true, result: 'already-installed' }));\n        } else {\n          console.log('ℹ️  Service already installed. Use --force to reinstall.');\n        }\n        return;\n      }\n\n      // Uninstall first if force\n      if (loaded && options.force) {\n        try {\n          await service.uninstall({ env: process.env });\n        } catch {\n          // Best-effort\n        }\n      }\n\n      // Build install args and install\n      const installArgs = buildGatewayInstallArgs({ port, bind, token });\n      installArgs.stdout = process.stdout;\n\n      try {\n        await service.install(installArgs);\n\n        if (options.json) {\n          console.log(JSON.stringify({ ok: true, result: 'installed', label: service.label, port }));\n        } else {\n          console.log('');\n          console.log(`✅ Gateway service installed`);\n          console.log(`   Service: ${service.label}`);\n          console.log(`   Port: ${port}`);\n          console.log('');\n          console.log('💡 The service will start automatically on login.');\n          console.log('   Use `xopc gateway status` to verify.');\n        }\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        if (options.json) {\n          console.log(JSON.stringify({ ok: false, error: message }));\n        } else {\n          console.error(`❌ Failed to install service: ${message}`);\n        }\n        process.exit(1);\n      }\n    });\n}\n\n/**\n * Create service uninstall subcommand\n */\nexport function createUninstallCommand(): Command {\n  return new Command('uninstall')\n    .description('Uninstall gateway OS service')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { executeDaemonUninstall } = await import('./lifecycle-core.js');\n      await executeDaemonUninstall(options);\n    });\n}\n\n/**\n * Create service start subcommand - starts via daemon service manager\n */\nexport function createServiceStartCommand(): Command {\n  return new Command('start')\n    .description('Start gateway via OS service manager')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const [{ resolveGatewayService, startGatewayService, isDaemonAvailableAsync }] =\n        await Promise.all([import('../../../daemon/service.js')]);\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        console.error('❌ Daemon not available on this platform');\n        process.exit(1);\n      }\n\n      const service = await resolveGatewayService();\n      const result = await startGatewayService({ service });\n\n      if (options.json) {\n        console.log(JSON.stringify({ ok: result.outcome === 'started', outcome: result.outcome }));\n        return;\n      }\n\n      switch (result.outcome) {\n        case 'started':\n          console.log('✅ Gateway service started');\n          break;\n        case 'missing-install':\n          console.error('❌ Service not installed. Run: xopc gateway service install');\n          process.exit(1);\n          break;\n        case 'repair-required':\n          console.error('⚠️  Service needs repair:');\n          for (const issue of result.issues || []) {\n            console.error(`   - ${issue.message}`);\n          }\n          console.log('💡 Run: xopc gateway service install --force');\n          process.exit(1);\n          break;\n        default:\n          console.log(`ℹ️  Service start outcome: ${result.outcome}`);\n      }\n    });\n}\n\n/**\n * Create service status subcommand\n */\nexport function createServiceStatusCommand(): Command {\n  return new Command('service-status')\n    .description('Show OS service status')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const [{ resolveGatewayService, isDaemonAvailableAsync, getPlatformName }] =\n        await Promise.all([import('../../../daemon/service.js')]);\n\n      const available = await isDaemonAvailableAsync();\n      if (!available) {\n        if (options.json) {\n          console.log(JSON.stringify({ available: false, platform: process.platform }));\n        } else {\n          console.log(`ℹ️  Daemon not available on ${getPlatformName()}`);\n        }\n        return;\n      }\n\n      const service = await resolveGatewayService();\n      const [loaded, runtime, command] = await Promise.all([\n        service.isLoaded({ env: process.env }),\n        service.readRuntime(),\n        service.readCommand(),\n      ]);\n\n      if (options.json) {\n        console.log(JSON.stringify({ available: true, loaded, runtime, command, label: service.label }, null, 2));\n        return;\n      }\n\n      console.log('📊 Gateway Service Status');\n      console.log('');\n      console.log(`   Platform: ${getPlatformName()}`);\n      console.log(`   Service:  ${loaded ? service.loadedText : service.notLoadedText}`);\n      console.log(`   Runtime:  ${runtime.status}${runtime.pid ? ` (pid ${runtime.pid})` : ''}`);\n\n      if (command) {\n        const portMatch = command.programArguments.join(' ').match(/--port\\s+(\\d+)/);\n        if (portMatch) {\n          console.log(`   Port:     ${portMatch[1]}`);\n        }\n        const version = command.environment?.XOPC_SERVICE_VERSION;\n        if (version) {\n          console.log(`   Version:  ${version}`);\n        }\n      }\n\n      if (!loaded) {\n        console.log('');\n        console.log('💡 Install with: xopc gateway service install');\n      }\n    });\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/shared.d.ts

@@ -0,0 +1,3 @@
+export declare function parsePortFromArgs(programArguments: string[] | undefined): number | null;
+export declare function resolveGatewayPortFromConfig(configPath?: string): number;
+export declare function renderGatewayServiceStartHints(env?: NodeJS.ProcessEnv): string[];

package/dist/src/cli/commands/gateway/shared.js

@@ -0,0 +1,54 @@
+import { init_paths, resolveConfigPath } from "../../../config/paths.js";
+import { loadConfig } from "../../../config/loader.js";
+import "../../../config/index.js";
+import { resolveGatewayLaunchAgentLabel, resolveGatewaySystemdServiceName, resolveGatewayWindowsTaskName } from "../../../daemon/constants.js";
+//#region src/cli/commands/gateway/shared.ts
+init_paths();
+function parsePortFromArgs(programArguments) {
+	if (!programArguments?.length) return null;
+	for (let i = 0; i < programArguments.length; i += 1) {
+		const arg = programArguments[i];
+		if (arg === "--port") {
+			const next = programArguments[i + 1];
+			const parsed = parseInt(String(next), 10);
+			if (Number.isFinite(parsed) && parsed > 0) return parsed;
+		}
+		if (arg?.startsWith("--port=")) {
+			const parsed = parseInt(arg.split("=", 2)[1] ?? "", 10);
+			if (Number.isFinite(parsed) && parsed > 0) return parsed;
+		}
+	}
+	return null;
+}
+function resolveGatewayPortFromConfig(configPath) {
+	const config = loadConfig(configPath ?? resolveConfigPath());
+	return typeof config.gateway?.port === "number" ? config.gateway.port : 18790;
+}
+function renderGatewayServiceStartHints(env = process.env) {
+	const profile = env.XOPC_PROFILE;
+	const systemdName = resolveGatewaySystemdServiceName(profile);
+	const launchAgent = resolveGatewayLaunchAgentLabel(profile);
+	const windowsTask = resolveGatewayWindowsTaskName(profile);
+	switch (process.platform) {
+		case "darwin": return [
+			"xopc gateway service install",
+			"xopc gateway",
+			`LaunchAgent: ~/Library/LaunchAgents/${launchAgent}.plist`
+		];
+		case "linux": return [
+			"xopc gateway service install",
+			"xopc gateway",
+			`systemd user service: ${systemdName}.service`
+		];
+		case "win32": return [
+			"xopc gateway service install",
+			"xopc gateway",
+			`Scheduled task: ${windowsTask}`
+		];
+		default: return ["xopc gateway service install", "xopc gateway"];
+	}
+}
+//#endregion
+export { parsePortFromArgs, renderGatewayServiceStartHints, resolveGatewayPortFromConfig };
+
+//# sourceMappingURL=shared.js.map

package/dist/src/cli/commands/gateway/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","names":[],"sources":["../../../../../src/cli/commands/gateway/shared.ts"],"sourcesContent":["import { loadConfig } from '../../../config/index.js';\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport {\n  resolveGatewayLaunchAgentLabel,\n  resolveGatewaySystemdServiceName,\n  resolveGatewayWindowsTaskName,\n} from '../../../daemon/constants.js';\n\nexport function parsePortFromArgs(programArguments: string[] | undefined): number | null {\n  if (!programArguments?.length) {\n    return null;\n  }\n  for (let i = 0; i < programArguments.length; i += 1) {\n    const arg = programArguments[i];\n    if (arg === '--port') {\n      const next = programArguments[i + 1];\n      const parsed = parseInt(String(next), 10);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n    if (arg?.startsWith('--port=')) {\n      const parsed = parseInt(arg.split('=', 2)[1] ?? '', 10);\n      if (Number.isFinite(parsed) && parsed > 0) {\n        return parsed;\n      }\n    }\n  }\n  return null;\n}\n\nexport function resolveGatewayPortFromConfig(configPath?: string): number {\n  const config = loadConfig(configPath ?? resolveConfigPath());\n  return typeof config.gateway?.port === 'number' ? config.gateway.port : 18790;\n}\n\nexport function renderGatewayServiceStartHints(env: NodeJS.ProcessEnv = process.env): string[] {\n  const profile = env.XOPC_PROFILE;\n  const systemdName = resolveGatewaySystemdServiceName(profile);\n  const launchAgent = resolveGatewayLaunchAgentLabel(profile);\n  const windowsTask = resolveGatewayWindowsTaskName(profile);\n\n  switch (process.platform) {\n    case 'darwin':\n      return [\n        'xopc gateway service install',\n        'xopc gateway',\n        `LaunchAgent: ~/Library/LaunchAgents/${launchAgent}.plist`,\n      ];\n    case 'linux':\n      return [\n        'xopc gateway service install',\n        'xopc gateway',\n        `systemd user service: ${systemdName}.service`,\n      ];\n    case 'win32':\n      return [\n        'xopc gateway service install',\n        'xopc gateway',\n        `Scheduled task: ${windowsTask}`,\n      ];\n    default:\n      return ['xopc gateway service install', 'xopc gateway'];\n  }\n}\n"],"mappings":";;;;;YAC6D;AAO7D,SAAgB,kBAAkB,kBAAuD;AACvF,KAAI,CAAC,kBAAkB,OACrB,QAAO;AAET,MAAK,IAAI,IAAI,GAAG,IAAI,iBAAiB,QAAQ,KAAK,GAAG;EACnD,MAAM,MAAM,iBAAiB;AAC7B,MAAI,QAAQ,UAAU;GACpB,MAAM,OAAO,iBAAiB,IAAI;GAClC,MAAM,SAAS,SAAS,OAAO,KAAK,EAAE,GAAG;AACzC,OAAI,OAAO,SAAS,OAAO,IAAI,SAAS,EACtC,QAAO;;AAGX,MAAI,KAAK,WAAW,UAAU,EAAE;GAC9B,MAAM,SAAS,SAAS,IAAI,MAAM,KAAK,EAAE,CAAC,MAAM,IAAI,GAAG;AACvD,OAAI,OAAO,SAAS,OAAO,IAAI,SAAS,EACtC,QAAO;;;AAIb,QAAO;;AAGT,SAAgB,6BAA6B,YAA6B;CACxE,MAAM,SAAS,WAAW,cAAc,mBAAmB,CAAC;AAC5D,QAAO,OAAO,OAAO,SAAS,SAAS,WAAW,OAAO,QAAQ,OAAO;;AAG1E,SAAgB,+BAA+B,MAAyB,QAAQ,KAAe;CAC7F,MAAM,UAAU,IAAI;CACpB,MAAM,cAAc,iCAAiC,QAAQ;CAC7D,MAAM,cAAc,+BAA+B,QAAQ;CAC3D,MAAM,cAAc,8BAA8B,QAAQ;AAE1D,SAAQ,QAAQ,UAAhB;EACE,KAAK,SACH,QAAO;GACL;GACA;GACA,uCAAuC,YAAY;GACpD;EACH,KAAK,QACH,QAAO;GACL;GACA;GACA,yBAAyB,YAAY;GACtC;EACH,KAAK,QACH,QAAO;GACL;GACA;GACA,mBAAmB;GACpB;EACH,QACE,QAAO,CAAC,gCAAgC,eAAe"}

package/dist/src/cli/commands/gateway/status.js

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import { addGatewayClientOptions, parseGatewayClientOptions } from "../../utils/gateway-client-options.js";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/status.ts

package/dist/src/cli/commands/gateway/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","names":["optsProbe"],"sources":["../../../../../src/cli/commands/gateway/status.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { getContextWithOpts } from '../../index.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\n\ninterface StatusResponse {\n  status: string;\n  version?: string;\n  channels?: Record<string, { status: string }>;\n  uptime?: number;\n}\n\nfunction formatUptime(seconds?: number): string {\n  if (!seconds || seconds <= 0) return 'unknown';\n  const days = Math.floor(seconds / 86400);\n  const hours = Math.floor((seconds % 86400) / 3600);\n  const minutes = Math.floor((seconds % 3600) / 60);\n  const parts: string[] = [];\n  if (days > 0) parts.push(`${days}d`);\n  if (hours > 0) parts.push(`${hours}h`);\n  parts.push(`${minutes}m`);\n  return parts.join(' ');\n}\n\nexport function createStatusCommand(): Command {\n  const cmd = new Command('status').description('Check gateway status (service + connectivity)');\n\n  addGatewayClientOptions(cmd);\n  cmd.option('--no-probe', 'Skip HTTP probe (only check service/lock)');\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [\n      { loadConfig },\n      { acquireGatewayLock, GatewayLockError },\n      { callGatewayApi, resolveGatewayUrl },\n      { resolveGatewayService, isDaemonAvailableAsync, getPlatformName },\n    ] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../../gateway/lock.js'),\n      import('../../utils/gateway-client.js'),\n      import('../../../daemon/service.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const gatewayUrl = resolveGatewayUrl({ url: clientOpts.url, configPath });\n\n    // ─── Service Status ───\n    let serviceLoaded = false;\n    let serviceRuntime: { status: string; pid?: number; lastExitStatus?: number } | null = null;\n    let serviceVersion: string | undefined;\n\n    const daemonAvailable = await isDaemonAvailableAsync();\n    if (daemonAvailable) {\n      try {\n        const service = await resolveGatewayService();\n        serviceLoaded = await service.isLoaded({ env: process.env });\n        if (serviceLoaded) {\n          serviceRuntime = await service.readRuntime();\n          const command = await service.readCommand();\n          serviceVersion = command?.environment?.XOPC_SERVICE_VERSION;\n        }\n      } catch {\n        // Best-effort service check\n      }\n    }\n\n    // ─── Lock Check ───\n    let lockAlive = false;\n    let lockPid: number | undefined;\n\n    try {\n      const lock = await acquireGatewayLock(configPath, { timeoutMs: 100, port });\n      await lock.release();\n      lockAlive = false;\n    } catch (err) {\n      if (err instanceof GatewayLockError) {\n        lockAlive = true;\n        const pidMatch = err.message.match(/pid\\s+(\\d+)/);\n        if (pidMatch) lockPid = parseInt(pidMatch[1], 10);\n      } else {\n        console.error('❌ Failed to check status:', err);\n        process.exit(1);\n      }\n    }\n\n    // ─── HTTP Probe ───\n    const optsProbe = options as { probe?: boolean };\n    const shouldProbe = optsProbe.probe !== false;\n\n    let probeResult: {\n      ok: boolean;\n      data?: StatusResponse;\n      error?: string;\n      durationMs: number;\n    } | null = null;\n\n    if (shouldProbe) {\n      const healthProbe = await callGatewayApi<{ status: string }>('GET', '/api/health', {\n        ...clientOpts,\n        timeoutMs: clientOpts.timeoutMs ?? 5000,\n      });\n\n      if (healthProbe.ok) {\n        const statusProbe = await callGatewayApi<StatusResponse>('GET', '/api/status', clientOpts);\n        probeResult = statusProbe.ok\n          ? statusProbe\n          : { ok: true, durationMs: healthProbe.durationMs, data: { status: 'ok' } };\n      } else {\n        probeResult = { ok: false, error: healthProbe.error, durationMs: healthProbe.durationMs };\n      }\n    }\n\n    // ─── JSON Output ───\n    if (clientOpts.json) {\n      console.log(\n        JSON.stringify(\n          {\n            running: lockAlive || (probeResult?.ok ?? false),\n            service: daemonAvailable\n              ? {\n                  platform: getPlatformName(),\n                  loaded: serviceLoaded,\n                  runtime: serviceRuntime,\n                  version: serviceVersion,\n                }\n              : null,\n            lock: { alive: lockAlive, pid: lockPid },\n            probe: probeResult\n              ? {\n                  reachable: probeResult.ok,\n                  durationMs: probeResult.durationMs,\n                  ...(probeResult.data ?? {}),\n                  ...(probeResult.error ? { error: probeResult.error } : {}),\n                }\n              : null,\n            url: gatewayUrl,\n            port,\n          },\n          null,\n          2,\n        ),\n      );\n      process.exit(probeResult?.ok || lockAlive ? 0 : 1);\n    }\n\n    // ─── Human Output ───\n    const isRunning = lockAlive || (probeResult?.ok ?? false) || serviceRuntime?.status === 'running';\n\n    if (!isRunning) {\n      console.log('⚠️  Gateway is not running');\n      if (daemonAvailable) {\n        console.log(`   Service: ${serviceLoaded ? 'installed (not running)' : 'not installed'}`);\n      }\n      if (probeResult && !probeResult.ok) {\n        console.log(`   Probe: ${probeResult.error} (${probeResult.durationMs}ms)`);\n      }\n      console.log('');\n      console.log('💡 Start with: xopc gateway');\n      if (!serviceLoaded && daemonAvailable) {\n        console.log('   Or install service: xopc gateway service install');\n      }\n      process.exit(1);\n    }\n\n    console.log('Gateway Status');\n    console.log('');\n\n    // Service info\n    if (daemonAvailable && serviceLoaded) {\n      const runtimeStatus = serviceRuntime?.status ?? 'unknown';\n      const pid = serviceRuntime?.pid || lockPid;\n      console.log(`  Service:  ${getPlatformName()} (loaded)`);\n      console.log(`  Runtime:  ${runtimeStatus}${pid ? ` (pid ${pid})` : ''}`);\n    } else if (lockPid) {\n      console.log(`  PID:      ${lockPid}`);\n    }\n\n    console.log(`  Port:     ${port}`);\n    console.log(`  URL:      ${gatewayUrl}`);\n\n    // Version from service or probe\n    const version = probeResult?.data?.version || serviceVersion;\n    if (version) {\n      console.log(`  Version:  ${version}`);\n    }\n\n    // Uptime from probe\n    if (probeResult?.ok && probeResult.data?.uptime != null) {\n      console.log(`  Uptime:   ${formatUptime(probeResult.data.uptime)}`);\n    }\n\n    // Probe result\n    if (probeResult?.ok) {\n      console.log(`  Probe:    OK (${probeResult.durationMs}ms)`);\n    } else if (probeResult && !probeResult.ok) {\n      console.log(`  Probe:    Failed (${probeResult.error})`);\n    } else if (!shouldProbe) {\n      console.log('  Probe:    skipped');\n    }\n\n    // Token\n    const token = config?.gateway?.auth?.token;\n    if (token) {\n      console.log(`  Token:    configured ✓`);\n    }\n\n    // Channels\n    if (probeResult?.ok && probeResult.data?.channels) {\n      const channels = probeResult.data.channels;\n      if (Object.keys(channels).length > 0) {\n        console.log('');\n        console.log('Channels:');\n        for (const [name, info] of Object.entries(channels)) {\n          const icon = info.status === 'connected' ? '✅' : info.status === 'disabled' ? '⚪' : '❌';\n          console.log(`  ${icon} ${name}: ${info.status}`);\n        }\n      }\n    }\n\n    process.exit(0);\n  });\n\n  return cmd;\n}\n"],"mappings":"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"}
+{"version":3,"file":"status.js","names":["optsProbe"],"sources":["../../../../../src/cli/commands/gateway/status.ts"],"sourcesContent":["import { Command } from 'commander';\n\nimport { resolveConfigPath } from '../../../config/paths.js';\nimport { getContextWithOpts } from '../../context.js';\nimport {\n  addGatewayClientOptions,\n  parseGatewayClientOptions,\n} from '../../utils/gateway-client-options.js';\n\ninterface StatusResponse {\n  status: string;\n  version?: string;\n  channels?: Record<string, { status: string }>;\n  uptime?: number;\n}\n\nfunction formatUptime(seconds?: number): string {\n  if (!seconds || seconds <= 0) return 'unknown';\n  const days = Math.floor(seconds / 86400);\n  const hours = Math.floor((seconds % 86400) / 3600);\n  const minutes = Math.floor((seconds % 3600) / 60);\n  const parts: string[] = [];\n  if (days > 0) parts.push(`${days}d`);\n  if (hours > 0) parts.push(`${hours}h`);\n  parts.push(`${minutes}m`);\n  return parts.join(' ');\n}\n\nexport function createStatusCommand(): Command {\n  const cmd = new Command('status').description('Check gateway status (service + connectivity)');\n\n  addGatewayClientOptions(cmd);\n  cmd.option('--no-probe', 'Skip HTTP probe (only check service/lock)');\n\n  cmd.action(async (options) => {\n    const ctx = getContextWithOpts();\n    const configPath = ctx.configPath || resolveConfigPath();\n    const [\n      { loadConfig },\n      { acquireGatewayLock, GatewayLockError },\n      { callGatewayApi, resolveGatewayUrl },\n      { resolveGatewayService, isDaemonAvailableAsync, getPlatformName },\n    ] = await Promise.all([\n      import('../../../config/index.js'),\n      import('../../../gateway/lock.js'),\n      import('../../utils/gateway-client.js'),\n      import('../../../daemon/service.js'),\n    ]);\n    const config = loadConfig(configPath);\n    const port = config?.gateway?.port ?? 18790;\n    const clientOpts = { ...parseGatewayClientOptions(options as Record<string, unknown>), configPath };\n    const gatewayUrl = resolveGatewayUrl({ url: clientOpts.url, configPath });\n\n    // ─── Service Status ───\n    let serviceLoaded = false;\n    let serviceRuntime: { status: string; pid?: number; lastExitStatus?: number } | null = null;\n    let serviceVersion: string | undefined;\n\n    const daemonAvailable = await isDaemonAvailableAsync();\n    if (daemonAvailable) {\n      try {\n        const service = await resolveGatewayService();\n        serviceLoaded = await service.isLoaded({ env: process.env });\n        if (serviceLoaded) {\n          serviceRuntime = await service.readRuntime();\n          const command = await service.readCommand();\n          serviceVersion = command?.environment?.XOPC_SERVICE_VERSION;\n        }\n      } catch {\n        // Best-effort service check\n      }\n    }\n\n    // ─── Lock Check ───\n    let lockAlive = false;\n    let lockPid: number | undefined;\n\n    try {\n      const lock = await acquireGatewayLock(configPath, { timeoutMs: 100, port });\n      await lock.release();\n      lockAlive = false;\n    } catch (err) {\n      if (err instanceof GatewayLockError) {\n        lockAlive = true;\n        const pidMatch = err.message.match(/pid\\s+(\\d+)/);\n        if (pidMatch) lockPid = parseInt(pidMatch[1], 10);\n      } else {\n        console.error('❌ Failed to check status:', err);\n        process.exit(1);\n      }\n    }\n\n    // ─── HTTP Probe ───\n    const optsProbe = options as { probe?: boolean };\n    const shouldProbe = optsProbe.probe !== false;\n\n    let probeResult: {\n      ok: boolean;\n      data?: StatusResponse;\n      error?: string;\n      durationMs: number;\n    } | null = null;\n\n    if (shouldProbe) {\n      const healthProbe = await callGatewayApi<{ status: string }>('GET', '/api/health', {\n        ...clientOpts,\n        timeoutMs: clientOpts.timeoutMs ?? 5000,\n      });\n\n      if (healthProbe.ok) {\n        const statusProbe = await callGatewayApi<StatusResponse>('GET', '/api/status', clientOpts);\n        probeResult = statusProbe.ok\n          ? statusProbe\n          : { ok: true, durationMs: healthProbe.durationMs, data: { status: 'ok' } };\n      } else {\n        probeResult = { ok: false, error: healthProbe.error, durationMs: healthProbe.durationMs };\n      }\n    }\n\n    // ─── JSON Output ───\n    if (clientOpts.json) {\n      console.log(\n        JSON.stringify(\n          {\n            running: lockAlive || (probeResult?.ok ?? false),\n            service: daemonAvailable\n              ? {\n                  platform: getPlatformName(),\n                  loaded: serviceLoaded,\n                  runtime: serviceRuntime,\n                  version: serviceVersion,\n                }\n              : null,\n            lock: { alive: lockAlive, pid: lockPid },\n            probe: probeResult\n              ? {\n                  reachable: probeResult.ok,\n                  durationMs: probeResult.durationMs,\n                  ...(probeResult.data ?? {}),\n                  ...(probeResult.error ? { error: probeResult.error } : {}),\n                }\n              : null,\n            url: gatewayUrl,\n            port,\n          },\n          null,\n          2,\n        ),\n      );\n      process.exit(probeResult?.ok || lockAlive ? 0 : 1);\n    }\n\n    // ─── Human Output ───\n    const isRunning = lockAlive || (probeResult?.ok ?? false) || serviceRuntime?.status === 'running';\n\n    if (!isRunning) {\n      console.log('⚠️  Gateway is not running');\n      if (daemonAvailable) {\n        console.log(`   Service: ${serviceLoaded ? 'installed (not running)' : 'not installed'}`);\n      }\n      if (probeResult && !probeResult.ok) {\n        console.log(`   Probe: ${probeResult.error} (${probeResult.durationMs}ms)`);\n      }\n      console.log('');\n      console.log('💡 Start with: xopc gateway');\n      if (!serviceLoaded && daemonAvailable) {\n        console.log('   Or install service: xopc gateway service install');\n      }\n      process.exit(1);\n    }\n\n    console.log('Gateway Status');\n    console.log('');\n\n    // Service info\n    if (daemonAvailable && serviceLoaded) {\n      const runtimeStatus = serviceRuntime?.status ?? 'unknown';\n      const pid = serviceRuntime?.pid || lockPid;\n      console.log(`  Service:  ${getPlatformName()} (loaded)`);\n      console.log(`  Runtime:  ${runtimeStatus}${pid ? ` (pid ${pid})` : ''}`);\n    } else if (lockPid) {\n      console.log(`  PID:      ${lockPid}`);\n    }\n\n    console.log(`  Port:     ${port}`);\n    console.log(`  URL:      ${gatewayUrl}`);\n\n    // Version from service or probe\n    const version = probeResult?.data?.version || serviceVersion;\n    if (version) {\n      console.log(`  Version:  ${version}`);\n    }\n\n    // Uptime from probe\n    if (probeResult?.ok && probeResult.data?.uptime != null) {\n      console.log(`  Uptime:   ${formatUptime(probeResult.data.uptime)}`);\n    }\n\n    // Probe result\n    if (probeResult?.ok) {\n      console.log(`  Probe:    OK (${probeResult.durationMs}ms)`);\n    } else if (probeResult && !probeResult.ok) {\n      console.log(`  Probe:    Failed (${probeResult.error})`);\n    } else if (!shouldProbe) {\n      console.log('  Probe:    skipped');\n    }\n\n    // Token\n    const token = config?.gateway?.auth?.token;\n    if (token) {\n      console.log(`  Token:    configured ✓`);\n    }\n\n    // Channels\n    if (probeResult?.ok && probeResult.data?.channels) {\n      const channels = probeResult.data.channels;\n      if (Object.keys(channels).length > 0) {\n        console.log('');\n        console.log('Channels:');\n        for (const [name, info] of Object.entries(channels)) {\n          const icon = info.status === 'connected' ? '✅' : info.status === 'disabled' ? '⚪' : '❌';\n          console.log(`  ${icon} ${name}: ${info.status}`);\n        }\n      }\n    }\n\n    process.exit(0);\n  });\n\n  return cmd;\n}\n"],"mappings":"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"}

package/dist/src/cli/commands/gateway/stop.js

@@ -5,8 +5,8 @@ import { Command } from "commander";
 */
 function createStopCommand() {
 	return new Command("stop").description("Stop the gateway service").option("--disable", "Disable KeepAlive so gateway does not respawn").option("--json", "Output JSON").action(async (options) => {
-		const { executeDaemonStop } = await import("./lifecycle-core.js");
-		await executeDaemonStop(options);
+		const { runDaemonStop } = await import("./lifecycle.js");
+		await runDaemonStop(options);
 	});
 }
 //#endregion

package/dist/src/cli/commands/gateway/stop.js.map

@@ -1 +1 @@
-{"version":3,"file":"stop.js","names":[],"sources":["../../../../../src/cli/commands/gateway/stop.ts"],"sourcesContent":["import { Command } from 'commander';\n\n/**\n * Create stop subcommand - delegates to daemon lifecycle core\n */\nexport function createStopCommand(): Command {\n  return new Command('stop')\n    .description('Stop the gateway service')\n    .option('--disable', 'Disable KeepAlive so gateway does not respawn')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { executeDaemonStop } = await import('./lifecycle-core.js');\n      await executeDaemonStop(options);\n    });\n}\n"],"mappings":";;;;;AAKA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,2BAA2B,CACvC,OAAO,aAAa,gDAAgD,CACpE,OAAO,UAAU,cAAc,CAC/B,OAAO,OAAO,YAAY;EACzB,MAAM,EAAE,sBAAsB,MAAM,OAAO;AAC3C,QAAM,kBAAkB,QAAQ;GAChC"}
+{"version":3,"file":"stop.js","names":[],"sources":["../../../../../src/cli/commands/gateway/stop.ts"],"sourcesContent":["import { Command } from 'commander';\n\n/**\n * Create stop subcommand - delegates to daemon lifecycle core\n */\nexport function createStopCommand(): Command {\n  return new Command('stop')\n    .description('Stop the gateway service')\n    .option('--disable', 'Disable KeepAlive so gateway does not respawn')\n    .option('--json', 'Output JSON')\n    .action(async (options) => {\n      const { runDaemonStop } = await import('./lifecycle.js');\n      await runDaemonStop(options);\n    });\n}\n"],"mappings":";;;;;AAKA,SAAgB,oBAA6B;AAC3C,QAAO,IAAI,QAAQ,OAAO,CACvB,YAAY,2BAA2B,CACvC,OAAO,aAAa,gDAAgD,CACpE,OAAO,UAAU,cAAc,CAC/B,OAAO,OAAO,YAAY;EACzB,MAAM,EAAE,kBAAkB,MAAM,OAAO;AACvC,QAAM,cAAc,QAAQ;GAC5B"}

package/dist/src/cli/commands/gateway/token.js

@@ -1,5 +1,5 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
-import { getContextWithOpts } from "../../index.js";
+import { getContextWithOpts } from "../../context.js";
 import crypto from "crypto";
 import { Command } from "commander";
 //#region src/cli/commands/gateway/token.ts