@xopcai/xopc 0.0.82 → 0.0.84

package/dist/src/cli/commands/config.js

@@ -1,10 +1,13 @@
 import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
+import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { formatExamples, register } from "../registry.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
-import { existsSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { Command } from "commander";
 //#region src/cli/commands/config.ts
 init_write_file_atomic();
+init_schema();
+const MISSING_CONFIG_HINT = "Run: xopc setup, xopc onboard, or xopc init";
 async function loadConfigDeps() {
 	const [{ loadConfig }, { createLogger }] = await Promise.all([import("../../config/index.js"), import("../../utils/logger.js")]);
 	return {
@@ -12,6 +15,49 @@ async function loadConfigDeps() {
 		log: createLogger("ConfigCommand")
 	};
 }
+async function runConfigShow(configPath) {
+	const { loadConfig, log } = await loadConfigDeps();
+	if (!existsSync(configPath)) {
+		log.warn(`No config file found. ${MISSING_CONFIG_HINT}`);
+		return;
+	}
+	const config = loadConfig(configPath);
+	const maskedConfig = JSON.stringify(config, (key, value) => {
+		if (key === "api_key" || key === "token") return value ? "********" : value;
+		return value;
+	}, 2);
+	console.log(maskedConfig);
+}
+async function runConfigValidate(configPath) {
+	const { log } = await loadConfigDeps();
+	if (!existsSync(configPath)) {
+		log.error("Config file not found. Run: xopc onboard");
+		return false;
+	}
+	let json;
+	try {
+		json = JSON.parse(readFileSync(configPath, "utf-8"));
+	} catch {
+		log.error("Config file is not valid JSON.");
+		return false;
+	}
+	const parsed = ConfigSchema.safeParse(json);
+	if (!parsed.success) {
+		log.error("Config does not match the expected schema.");
+		for (const issue of parsed.error.issues) console.error(`  - ${issue.path.join(".") || "(root)"}: ${issue.message}`);
+		return false;
+	}
+	const { validateChannelPluginConfigs } = await import("../../config/validate-channel-configs.js");
+	const channelErrors = validateChannelPluginConfigs(parsed.data);
+	if (channelErrors.length > 0) {
+		log.error("Channel configuration failed validation.");
+		for (const err of channelErrors) console.error(`  - ${err}`);
+		return false;
+	}
+	log.info({ path: configPath }, "Config is valid");
+	console.log("✅ Configuration is valid");
+	return true;
+}
 function getNestedValue(obj, path) {
 	return path.split(".").reduce((current, key) => {
 		if (current && typeof current === "object" && key in current) return current[key];
@@ -28,19 +74,30 @@ function setNestedValue(obj, path, value) {
 	return obj;
 }
 function createConfigCommand(ctx) {
-	const cmd = new Command("config").description("View and edit configuration").addHelpText("after", formatExamples([
+	const cmd = new Command("config").description("View and edit configuration").option("--show", "Show full configuration (alias for `config show`)").option("--validate", "Validate configuration file (alias for `config validate`)").addHelpText("after", formatExamples([
 		"xopc config get agents.defaults.model",
 		"xopc config set agents.defaults.temperature 0.8",
 		"xopc config unset agents.defaults.max_tokens",
 		"xopc config show",
+		"xopc config validate",
 		"xopc config token              # Show gateway token info",
 		"xopc config token --show       # Show full token",
 		"xopc config token --generate   # Generate new token"
-	]));
+	])).action(async (options) => {
+		if (options.show) {
+			await runConfigShow(ctx.configPath);
+			return;
+		}
+		if (options.validate) {
+			if (!await runConfigValidate(ctx.configPath)) process.exit(1);
+			return;
+		}
+		cmd.outputHelp();
+	});
 	cmd.command("get <path>").description("Get a config value by dot path").action(async (path) => {
 		const { loadConfig, log } = await loadConfigDeps();
 		if (!existsSync(ctx.configPath)) {
-			log.error("Config file not found. Run: xopc onboard");
+			log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);
 			process.exit(1);
 		}
 		const value = getNestedValue(loadConfig(ctx.configPath), path);
@@ -53,7 +110,7 @@ function createConfigCommand(ctx) {
 	cmd.command("set <path> <value>").description("Set a config value by dot path").action(async (path, value) => {
 		const { loadConfig, log } = await loadConfigDeps();
 		if (!existsSync(ctx.configPath)) {
-			log.error("Config file not found. Run: xopc onboard");
+			log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);
 			process.exit(1);
 		}
 		let parsedValue;
@@ -70,7 +127,7 @@ function createConfigCommand(ctx) {
 	cmd.command("unset <path>").description("Remove a config value by dot path").action(async (path) => {
 		const { loadConfig, log } = await loadConfigDeps();
 		if (!existsSync(ctx.configPath)) {
-			log.error("Config file not found. Run: xopc onboard");
+			log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);
 			process.exit(1);
 		}
 		const config = loadConfig(ctx.configPath);
@@ -89,22 +146,15 @@ function createConfigCommand(ctx) {
 		}
 	});
 	cmd.command("show").description("Show full configuration (sensitive values masked)").action(async () => {
-		const { loadConfig, log } = await loadConfigDeps();
-		if (!existsSync(ctx.configPath)) {
-			log.warn("No config file found. Run: xopc onboard");
-			return;
-		}
-		const config = loadConfig(ctx.configPath);
-		const maskedConfig = JSON.stringify(config, (key, value) => {
-			if (key === "api_key" || key === "token") return value ? "********" : value;
-			return value;
-		}, 2);
-		console.log(maskedConfig);
+		await runConfigShow(ctx.configPath);
+	});
+	cmd.command("validate").description("Validate configuration file against schema and channel plugins").action(async () => {
+		if (!await runConfigValidate(ctx.configPath)) process.exit(1);
 	});
 	cmd.command("token").description("Generate or view the gateway auth token").option("--generate", "Generate a new token").option("--show", "Show the current token (unmasked)").action(async (options) => {
 		const { loadConfig, log } = await loadConfigDeps();
 		if (!existsSync(ctx.configPath)) {
-			log.error("Config file not found. Run: xopc onboard");
+			log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);
 			process.exit(1);
 		}
 		const config = loadConfig(ctx.configPath);
@@ -140,7 +190,7 @@ function createConfigCommand(ctx) {
 			console.log(`  Token: ${token.slice(0, 8)}...${token.slice(-8)}`);
 			console.log("\nUse \"xopc config token --show\" to view the full token");
 			console.log("Use \"xopc config token --generate\" to generate a new token");
-		} else if (mode === "token") console.log("  Token: not set (will be auto-generated on first gateway start)");
+		} else if (mode === "token") console.log("  Token: not set (will be auto-generated on first `xopc gateway` run)");
 	});
 	cmd.command("path").description("Show configuration file path").action(() => {
 		console.log(ctx.configPath);
@@ -158,6 +208,7 @@ register({
 			"xopc config get agents.defaults.model",
 			"xopc config set agents.defaults.temperature 0.8",
 			"xopc config show",
+			"xopc config validate",
 			"xopc config token",
 			"xopc config token --show",
 			"xopc config token --generate"

package/dist/src/cli/commands/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../../src/cli/commands/config.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { existsSync } from 'fs';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { writeTextAtomic } from '../../infra/write-file-atomic.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nasync function loadConfigDeps() {\n  const [{ loadConfig }, { createLogger }] = await Promise.all([\n    import('../../config/index.js'),\n    import('../../utils/logger.js'),\n  ]);\n  return { loadConfig, log: createLogger('ConfigCommand') };\n}\n\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current: any, key: string) => {\n    if (current && typeof current === 'object' && key in current) {\n      return current[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nfunction setNestedValue(obj: any, path: string, value: any): any {\n  const keys = path.split('.');\n  const lastKey = keys.pop()!;\n  const target = keys.reduce((current: any, key: string) => {\n    if (!current[key] || typeof current[key] !== 'object') {\n      current[key] = {};\n    }\n    return current[key];\n  }, obj);\n  target[lastKey] = value;\n  return obj;\n}\n\nfunction createConfigCommand(ctx: CLIContext): Command {\n  const cmd = new Command('config')\n    .description('View and edit configuration')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc config get agents.defaults.model',\n        'xopc config set agents.defaults.temperature 0.8',\n        'xopc config unset agents.defaults.max_tokens',\n        'xopc config show',\n        'xopc config token              # Show gateway token info',\n        'xopc config token --show       # Show full token',\n        'xopc config token --generate   # Generate new token',\n      ])\n    );\n\n  cmd\n    .command('get <path>')\n    .description('Get a config value by dot path')\n    .action(async (path: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error('Config file not found. Run: xopc onboard');\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n      const value = getNestedValue(config, path);\n\n      if (value === undefined) {\n        log.error({ path }, `Config path not found`);\n        process.exit(1);\n      }\n\n      console.log(typeof value === 'object' ? JSON.stringify(value, null, 2) : value);\n    });\n\n  cmd\n    .command('set <path> <value>')\n    .description('Set a config value by dot path')\n    .action(async (path: string, value: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error('Config file not found. Run: xopc onboard');\n        process.exit(1);\n      }\n\n      let parsedValue: any;\n      try {\n        parsedValue = JSON.parse(value);\n      } catch {\n        parsedValue = value;\n      }\n\n      const config = loadConfig(ctx.configPath);\n      setNestedValue(config, path, parsedValue);\n\n      await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n\n      log.info({ path }, `Config updated`);\n    });\n\n  cmd\n    .command('unset <path>')\n    .description('Remove a config value by dot path')\n    .action(async (path: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error('Config file not found. Run: xopc onboard');\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n      const keys = path.split('.');\n      const lastKey = keys.pop()!;\n      const target = keys.reduce((current: any, key: string) => {\n        return current && current[key];\n      }, config);\n\n      if (target && typeof target === 'object' && lastKey in target) {\n        delete target[lastKey];\n        await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n        log.info({ path }, `Config removed`);\n      } else {\n        log.error({ path }, `Config path not found`);\n        process.exit(1);\n      }\n    });\n\n  cmd\n    .command('show')\n    .description('Show full configuration (sensitive values masked)')\n    .action(async () => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.warn('No config file found. Run: xopc onboard');\n        return;\n      }\n\n      const config = loadConfig(ctx.configPath);\n\n      const maskedConfig = JSON.stringify(config, (key, value) => {\n        if (key === 'api_key' || key === 'token') {\n          return value ? '********' : value;\n        }\n        return value;\n      }, 2);\n\n      console.log(maskedConfig);\n    });\n\n  cmd\n    .command('token')\n    .description('Generate or view the gateway auth token')\n    .option('--generate', 'Generate a new token')\n    .option('--show', 'Show the current token (unmasked)')\n    .action(async (options) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error('Config file not found. Run: xopc onboard');\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n\n      if (options.show) {\n        const token = config?.gateway?.auth?.token;\n        if (token) {\n          console.log(token);\n        } else {\n          console.log('No token configured. Gateway auth mode:', config?.gateway?.auth?.mode || 'not set');\n        }\n        return;\n      }\n\n      if (options.generate) {\n        const crypto = await import('crypto');\n        const newToken = crypto.randomBytes(24).toString('hex');\n\n        config.gateway = config.gateway || {};\n        config.gateway.auth = {\n          mode: 'token',\n          token: newToken,\n        };\n\n        await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n        log.info('New gateway token generated');\n        console.log(`Token: ${newToken.slice(0, 8)}...${newToken.slice(-8)}`);\n        console.log('\\nUse \"xopc config token --show\" to view the full token');\n        return;\n      }\n\n      // Default: show masked token info\n      const token = config?.gateway?.auth?.token;\n      const mode = config?.gateway?.auth?.mode;\n      const bind = config?.gateway?.bind ?? 'loopback';\n      const port = config?.gateway?.port || 18790;\n      const clientHost = config ? resolveGatewayLocalClientHost(config) : '127.0.0.1';\n\n      console.log('Gateway Configuration:');\n      console.log(`  Bind: ${bind}`);\n      console.log(`  Local URL: http://${clientHost}:${port}`);\n      console.log(`  Auth Mode: ${mode || 'not set'}`);\n      if (token) {\n        console.log(`  Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n        console.log('\\nUse \"xopc config token --show\" to view the full token');\n        console.log('Use \"xopc config token --generate\" to generate a new token');\n      } else if (mode === 'token') {\n        console.log('  Token: not set (will be auto-generated on first gateway start)');\n      }\n    });\n\n  cmd\n    .command('path')\n    .description('Show configuration file path')\n    .action(() => {\n      console.log(ctx.configPath);\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'config',\n  name: 'config',\n  description: 'View and edit configuration',\n  factory: createConfigCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc config get agents.defaults.model',\n      'xopc config set agents.defaults.temperature 0.8',\n      'xopc config show',\n      'xopc config token',\n      'xopc config token --show',\n      'xopc config token --generate',\n    ],\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../../src/cli/commands/config.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { existsSync, readFileSync } from 'fs';\nimport { resolveGatewayLocalClientHost } from '../../config/gateway-bind.js';\nimport { writeTextAtomic } from '../../infra/write-file-atomic.js';\nimport { ConfigSchema } from '../../config/schema.js';\nimport { register, formatExamples, type CLIContext } from '../registry.js';\n\nconst MISSING_CONFIG_HINT = 'Run: xopc setup, xopc onboard, or xopc init';\n\nasync function loadConfigDeps() {\n  const [{ loadConfig }, { createLogger }] = await Promise.all([\n    import('../../config/index.js'),\n    import('../../utils/logger.js'),\n  ]);\n  return { loadConfig, log: createLogger('ConfigCommand') };\n}\n\nasync function runConfigShow(configPath: string): Promise<void> {\n  const { loadConfig, log } = await loadConfigDeps();\n  if (!existsSync(configPath)) {\n    log.warn(`No config file found. ${MISSING_CONFIG_HINT}`);\n    return;\n  }\n\n  const config = loadConfig(configPath);\n  const maskedConfig = JSON.stringify(\n    config,\n    (key, value) => {\n      if (key === 'api_key' || key === 'token') {\n        return value ? '********' : value;\n      }\n      return value;\n    },\n    2,\n  );\n  console.log(maskedConfig);\n}\n\nasync function runConfigValidate(configPath: string): Promise<boolean> {\n  const { log } = await loadConfigDeps();\n  if (!existsSync(configPath)) {\n    log.error('Config file not found. Run: xopc onboard');\n    return false;\n  }\n\n  let json: unknown;\n  try {\n    json = JSON.parse(readFileSync(configPath, 'utf-8'));\n  } catch {\n    log.error('Config file is not valid JSON.');\n    return false;\n  }\n\n  const parsed = ConfigSchema.safeParse(json);\n  if (!parsed.success) {\n    log.error('Config does not match the expected schema.');\n    for (const issue of parsed.error.issues) {\n      console.error(`  - ${issue.path.join('.') || '(root)'}: ${issue.message}`);\n    }\n    return false;\n  }\n\n  const { validateChannelPluginConfigs } = await import('../../config/validate-channel-configs.js');\n  const channelErrors = validateChannelPluginConfigs(parsed.data);\n  if (channelErrors.length > 0) {\n    log.error('Channel configuration failed validation.');\n    for (const err of channelErrors) {\n      console.error(`  - ${err}`);\n    }\n    return false;\n  }\n\n  log.info({ path: configPath }, 'Config is valid');\n  console.log('✅ Configuration is valid');\n  return true;\n}\n\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current: any, key: string) => {\n    if (current && typeof current === 'object' && key in current) {\n      return current[key];\n    }\n    return undefined;\n  }, obj);\n}\n\nfunction setNestedValue(obj: any, path: string, value: any): any {\n  const keys = path.split('.');\n  const lastKey = keys.pop()!;\n  const target = keys.reduce((current: any, key: string) => {\n    if (!current[key] || typeof current[key] !== 'object') {\n      current[key] = {};\n    }\n    return current[key];\n  }, obj);\n  target[lastKey] = value;\n  return obj;\n}\n\nfunction createConfigCommand(ctx: CLIContext): Command {\n  const cmd = new Command('config')\n    .description('View and edit configuration')\n    .option('--show', 'Show full configuration (alias for `config show`)')\n    .option('--validate', 'Validate configuration file (alias for `config validate`)')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc config get agents.defaults.model',\n        'xopc config set agents.defaults.temperature 0.8',\n        'xopc config unset agents.defaults.max_tokens',\n        'xopc config show',\n        'xopc config validate',\n        'xopc config token              # Show gateway token info',\n        'xopc config token --show       # Show full token',\n        'xopc config token --generate   # Generate new token',\n      ]),\n    )\n    .action(async (options) => {\n      if (options.show) {\n        await runConfigShow(ctx.configPath);\n        return;\n      }\n      if (options.validate) {\n        const ok = await runConfigValidate(ctx.configPath);\n        if (!ok) {\n          process.exit(1);\n        }\n        return;\n      }\n      cmd.outputHelp();\n    });\n\n  cmd\n    .command('get <path>')\n    .description('Get a config value by dot path')\n    .action(async (path: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n      const value = getNestedValue(config, path);\n\n      if (value === undefined) {\n        log.error({ path }, `Config path not found`);\n        process.exit(1);\n      }\n\n      console.log(typeof value === 'object' ? JSON.stringify(value, null, 2) : value);\n    });\n\n  cmd\n    .command('set <path> <value>')\n    .description('Set a config value by dot path')\n    .action(async (path: string, value: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);\n        process.exit(1);\n      }\n\n      let parsedValue: any;\n      try {\n        parsedValue = JSON.parse(value);\n      } catch {\n        parsedValue = value;\n      }\n\n      const config = loadConfig(ctx.configPath);\n      setNestedValue(config, path, parsedValue);\n\n      await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n\n      log.info({ path }, `Config updated`);\n    });\n\n  cmd\n    .command('unset <path>')\n    .description('Remove a config value by dot path')\n    .action(async (path: string) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n      const keys = path.split('.');\n      const lastKey = keys.pop()!;\n      const target = keys.reduce((current: any, key: string) => {\n        return current && current[key];\n      }, config);\n\n      if (target && typeof target === 'object' && lastKey in target) {\n        delete target[lastKey];\n        await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n        log.info({ path }, `Config removed`);\n      } else {\n        log.error({ path }, `Config path not found`);\n        process.exit(1);\n      }\n    });\n\n  cmd\n    .command('show')\n    .description('Show full configuration (sensitive values masked)')\n    .action(async () => {\n      await runConfigShow(ctx.configPath);\n    });\n\n  cmd\n    .command('validate')\n    .description('Validate configuration file against schema and channel plugins')\n    .action(async () => {\n      const ok = await runConfigValidate(ctx.configPath);\n      if (!ok) {\n        process.exit(1);\n      }\n    });\n\n  cmd\n    .command('token')\n    .description('Generate or view the gateway auth token')\n    .option('--generate', 'Generate a new token')\n    .option('--show', 'Show the current token (unmasked)')\n    .action(async (options) => {\n      const { loadConfig, log } = await loadConfigDeps();\n      if (!existsSync(ctx.configPath)) {\n        log.error(`Config file not found. ${MISSING_CONFIG_HINT}`);\n        process.exit(1);\n      }\n\n      const config = loadConfig(ctx.configPath);\n\n      if (options.show) {\n        const token = config?.gateway?.auth?.token;\n        if (token) {\n          console.log(token);\n        } else {\n          console.log('No token configured. Gateway auth mode:', config?.gateway?.auth?.mode || 'not set');\n        }\n        return;\n      }\n\n      if (options.generate) {\n        const crypto = await import('crypto');\n        const newToken = crypto.randomBytes(24).toString('hex');\n\n        config.gateway = config.gateway || {};\n        config.gateway.auth = {\n          mode: 'token',\n          token: newToken,\n        };\n\n        await writeTextAtomic(ctx.configPath, JSON.stringify(config, null, 2));\n        log.info('New gateway token generated');\n        console.log(`Token: ${newToken.slice(0, 8)}...${newToken.slice(-8)}`);\n        console.log('\\nUse \"xopc config token --show\" to view the full token');\n        return;\n      }\n\n      // Default: show masked token info\n      const token = config?.gateway?.auth?.token;\n      const mode = config?.gateway?.auth?.mode;\n      const bind = config?.gateway?.bind ?? 'loopback';\n      const port = config?.gateway?.port || 18790;\n      const clientHost = config ? resolveGatewayLocalClientHost(config) : '127.0.0.1';\n\n      console.log('Gateway Configuration:');\n      console.log(`  Bind: ${bind}`);\n      console.log(`  Local URL: http://${clientHost}:${port}`);\n      console.log(`  Auth Mode: ${mode || 'not set'}`);\n      if (token) {\n        console.log(`  Token: ${token.slice(0, 8)}...${token.slice(-8)}`);\n        console.log('\\nUse \"xopc config token --show\" to view the full token');\n        console.log('Use \"xopc config token --generate\" to generate a new token');\n      } else if (mode === 'token') {\n        console.log('  Token: not set (will be auto-generated on first `xopc gateway` run)');\n      }\n    });\n\n  cmd\n    .command('path')\n    .description('Show configuration file path')\n    .action(() => {\n      console.log(ctx.configPath);\n    });\n\n  return cmd;\n}\n\nregister({\n  id: 'config',\n  name: 'config',\n  description: 'View and edit configuration',\n  factory: createConfigCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc config get agents.defaults.model',\n      'xopc config set agents.defaults.temperature 0.8',\n      'xopc config show',\n      'xopc config validate',\n      'xopc config token',\n      'xopc config token --show',\n      'xopc config token --generate',\n    ],\n  },\n});\n"],"mappings":"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"}

package/dist/src/cli/commands/cron-cli.d.ts

@@ -0,0 +1,2 @@
+import type { CronService } from '../../cron/service.js';
+export declare function withCronService<T>(fn: (service: CronService) => Promise<T>): Promise<T>;

package/dist/src/cli/commands/cron-cli.js

@@ -0,0 +1,15 @@
+//#region src/cli/commands/cron-cli.ts
+async function withCronService(fn) {
+	const { CronService } = await import("../../cron/index.js");
+	const cronService = new CronService();
+	await cronService.initialize();
+	try {
+		return await fn(cronService);
+	} finally {
+		await cronService.stop();
+	}
+}
+//#endregion
+export { withCronService };
+
+//# sourceMappingURL=cron-cli.js.map

package/dist/src/cli/commands/cron-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-cli.js","names":[],"sources":["../../../../src/cli/commands/cron-cli.ts"],"sourcesContent":["import type { CronService } from '../../cron/service.js';\n\nexport async function withCronService<T>(fn: (service: CronService) => Promise<T>): Promise<T> {\n  const { CronService } = await import('../../cron/index.js');\n  const cronService = new CronService();\n  await cronService.initialize();\n  try {\n    return await fn(cronService);\n  } finally {\n    await cronService.stop();\n  }\n}\n"],"mappings":";AAEA,eAAsB,gBAAmB,IAAsD;CAC7F,MAAM,EAAE,gBAAgB,MAAM,OAAO;CACrC,MAAM,cAAc,IAAI,aAAa;AACrC,OAAM,YAAY,YAAY;AAC9B,KAAI;AACF,SAAO,MAAM,GAAG,YAAY;WACpB;AACR,QAAM,YAAY,MAAM"}

package/dist/src/cli/commands/cron.d.ts

@@ -1 +1,4 @@
-export {};
+import { Command } from 'commander';
+import type { CLIContext } from '../registry.js';
+declare function createCronCommand(_ctx: CLIContext): Command;
+export { createCronCommand };

package/dist/src/cli/commands/cron.js

@@ -1,62 +1,92 @@
 import { formatExamples, register } from "../registry.js";
+import { withCronService } from "./cron-cli.js";
 import { Command } from "commander";
 //#region src/cli/commands/cron.ts
 function createCronCommand(_ctx) {
 	const cmd = new Command("cron").description("Manage scheduled tasks").addHelpText("after", formatExamples([
 		"xopc cron list                              # List all tasks",
 		"xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"",
+		"xopc cron enable <job-id>                   # Enable a task",
+		"xopc cron disable <job-id>                  # Disable a task",
+		"xopc cron run <job-id>                      # Run a task now",
 		"xopc cron remove <job-id>                   # Remove a task"
 	]));
 	cmd.addCommand(new Command("list").description("List all scheduled tasks").action(async () => {
-		const { CronService } = await import("../../cron/index.js");
-		const cronService = new CronService();
-		await cronService.initialize();
-		const jobs = await cronService.listJobs();
-		if (jobs.length === 0) {
-			console.log("No scheduled tasks.");
-			return;
-		}
-		console.log("Scheduled Tasks:\n");
-		const { getCronPayloadText } = await import("../../cron/job-content.js");
-		for (const job of jobs) {
-			console.log(`  ${job.id} - ${job.schedule}`);
-			console.log(`     ${getCronPayloadText({ payload: job.payload })}`);
-			console.log(`     Next: ${job.next_run || "N/A"}`);
-			console.log();
-		}
-		await cronService.stop();
+		await withCronService(async (cronService) => {
+			const jobs = await cronService.listJobs();
+			if (jobs.length === 0) {
+				console.log("No scheduled tasks.");
+				return;
+			}
+			console.log("Scheduled Tasks:\n");
+			const { getCronPayloadText } = await import("../../cron/job-content.js");
+			for (const job of jobs) {
+				const state = job.enabled ? "enabled " : "disabled";
+				console.log(`  ${job.id} [${state}] - ${job.schedule}`);
+				console.log(`     ${getCronPayloadText({ payload: job.payload })}`);
+				console.log(`     Next: ${job.next_run || "N/A"}`);
+				console.log();
+			}
+		});
 	}));
 	cmd.addCommand(new Command("add").description("Add a scheduled task").option("--name <text>", "Task name").option("--schedule <cron>", "Cron expression (e.g., \"0 9 * * *\")").option("--message <text>", "Message to send").action(async (options) => {
 		if (!options.schedule || !options.message) {
 			console.error("Error: --schedule and --message are required");
 			process.exit(1);
 		}
-		const { CronService } = await import("../../cron/index.js");
-		const cronService = new CronService();
-		await cronService.initialize();
-		const result = await cronService.addJob(options.schedule, {
-			name: options.name,
-			payload: {
-				kind: "systemEvent",
-				text: options.message
-			}
+		await withCronService(async (cronService) => {
+			const result = await cronService.addJob(options.schedule, {
+				name: options.name,
+				payload: {
+					kind: "systemEvent",
+					text: options.message
+				}
+			});
+			console.log(`✅ Added job ${result.id}`);
+			console.log(`   Schedule: ${result.schedule}`);
 		});
-		console.log(`✅ Added job ${result.id}`);
-		console.log(`   Schedule: ${result.schedule}`);
-		await cronService.stop();
 	}));
 	cmd.addCommand(new Command("remove").description("Remove a scheduled task").argument("<id>", "Job ID").action(async (id) => {
-		const { CronService } = await import("../../cron/index.js");
-		const cronService = new CronService();
-		await cronService.initialize();
-		const success = await cronService.removeJob(id);
-		await cronService.stop();
-		if (success) console.log(`✅ Removed job ${id}`);
-		else {
-			console.error(`Job ${id} not found`);
-			process.exit(1);
-		}
+		await withCronService(async (cronService) => {
+			if (await cronService.removeJob(id)) console.log(`✅ Removed job ${id}`);
+			else {
+				console.error(`Job ${id} not found`);
+				process.exit(1);
+			}
+		});
 	}));
+	cmd.addCommand(new Command("enable").description("Enable a scheduled task").argument("<id>", "Job ID").action(async (id) => {
+		await withCronService(async (cronService) => {
+			if (await cronService.toggleJob(id, true)) console.log(`✅ Enabled job ${id}`);
+			else {
+				console.error(`Job ${id} not found`);
+				process.exit(1);
+			}
+		});
+	}));
+	cmd.addCommand(new Command("disable").description("Disable a scheduled task").argument("<id>", "Job ID").action(async (id) => {
+		await withCronService(async (cronService) => {
+			if (await cronService.toggleJob(id, false)) console.log(`✅ Disabled job ${id}`);
+			else {
+				console.error(`Job ${id} not found`);
+				process.exit(1);
+			}
+		});
+	}));
+	const runNowAction = async (id) => {
+		await withCronService(async (cronService) => {
+			try {
+				await cronService.runJobNow(id);
+				console.log(`✅ Triggered job ${id}`);
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				console.error(message);
+				process.exit(1);
+			}
+		});
+	};
+	cmd.addCommand(new Command("run").description("Run a scheduled task immediately").argument("<id>", "Job ID").action(runNowAction));
+	cmd.addCommand(new Command("trigger").description("Alias for `cron run`").argument("<id>", "Job ID").action(runNowAction));
 	return cmd;
 }
 register({
@@ -66,10 +96,15 @@ register({
 	factory: createCronCommand,
 	metadata: {
 		category: "utility",
-		examples: ["xopc cron list", "xopc cron add --schedule \"0 9 * * *\" --message \"Hello\""]
+		examples: [
+			"xopc cron list",
+			"xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"",
+			"xopc cron enable abc12345",
+			"xopc cron run abc12345"
+		]
 	}
 });
 //#endregion
-export {};
+export { createCronCommand };
 
 //# sourceMappingURL=cron.js.map

package/dist/src/cli/commands/cron.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron.js","names":[],"sources":["../../../../src/cli/commands/cron.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\n\nfunction createCronCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('cron')\n    .description('Manage scheduled tasks')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc cron list                              # List all tasks',\n        'xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"',\n        'xopc cron remove <job-id>                   # Remove a task',\n      ])\n    );\n\n  cmd.addCommand(\n    new Command('list')\n      .description('List all scheduled tasks')\n      .action(async () => {\n        const { CronService } = await import('../../cron/index.js');\n        \n        const cronService = new CronService();\n        await cronService.initialize();\n        \n        const jobs = await cronService.listJobs();\n        \n        if (jobs.length === 0) {\n          console.log('No scheduled tasks.');\n          return;\n        }\n        \n        console.log('Scheduled Tasks:\\n');\n        const { getCronPayloadText } = await import('../../cron/job-content.js');\n        for (const job of jobs) {\n          console.log(`  ${job.id} - ${job.schedule}`);\n          console.log(`     ${getCronPayloadText({ payload: job.payload })}`);\n          console.log(`     Next: ${job.next_run || 'N/A'}`);\n          console.log();\n        }\n        \n        await cronService.stop();\n      })\n  );\n\n  cmd.addCommand(\n    new Command('add')\n      .description('Add a scheduled task')\n      .option('--name <text>', 'Task name')\n      .option('--schedule <cron>', 'Cron expression (e.g., \"0 9 * * *\")')\n      .option('--message <text>', 'Message to send')\n      .action(async (options) => {\n        if (!options.schedule || !options.message) {\n          console.error('Error: --schedule and --message are required');\n          process.exit(1);\n        }\n        \n        const { CronService } = await import('../../cron/index.js');\n        const cronService = new CronService();\n        await cronService.initialize();\n        \n        const result = await cronService.addJob(options.schedule, {\n          name: options.name,\n          payload: { kind: 'systemEvent', text: options.message },\n        });\n        \n        console.log(`✅ Added job ${result.id}`);\n        console.log(`   Schedule: ${result.schedule}`);\n        \n        await cronService.stop();\n      })\n  );\n\n  cmd.addCommand(\n    new Command('remove')\n      .description('Remove a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        const { CronService } = await import('../../cron/index.js');\n        const cronService = new CronService();\n        await cronService.initialize();\n        \n        const success = await cronService.removeJob(id);\n        \n        await cronService.stop();\n        \n        if (success) {\n          console.log(`✅ Removed job ${id}`);\n        } else {\n          console.error(`Job ${id} not found`);\n          process.exit(1);\n        }\n      })\n  );\n\n  return cmd;\n}\n\nregister({\n  id: 'cron',\n  name: 'cron',\n  description: 'Manage scheduled tasks',\n  factory: createCronCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc cron list',\n      'xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"',\n    ],\n  },\n});\n"],"mappings":";;;AAIA,SAAS,kBAAkB,MAA2B;CACpD,MAAM,MAAM,IAAI,QAAQ,OAAO,CAC5B,YAAY,yBAAyB,CACrC,YACC,SACA,eAAe;EACb;EACA;EACA;EACD,CAAC,CACH;AAEH,KAAI,WACF,IAAI,QAAQ,OAAO,CAChB,YAAY,2BAA2B,CACvC,OAAO,YAAY;EAClB,MAAM,EAAE,gBAAgB,MAAM,OAAO;EAErC,MAAM,cAAc,IAAI,aAAa;AACrC,QAAM,YAAY,YAAY;EAE9B,MAAM,OAAO,MAAM,YAAY,UAAU;AAEzC,MAAI,KAAK,WAAW,GAAG;AACrB,WAAQ,IAAI,sBAAsB;AAClC;;AAGF,UAAQ,IAAI,qBAAqB;EACjC,MAAM,EAAE,uBAAuB,MAAM,OAAO;AAC5C,OAAK,MAAM,OAAO,MAAM;AACtB,WAAQ,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW;AAC5C,WAAQ,IAAI,QAAQ,mBAAmB,EAAE,SAAS,IAAI,SAAS,CAAC,GAAG;AACnE,WAAQ,IAAI,cAAc,IAAI,YAAY,QAAQ;AAClD,WAAQ,KAAK;;AAGf,QAAM,YAAY,MAAM;GACxB,CACL;AAED,KAAI,WACF,IAAI,QAAQ,MAAM,CACf,YAAY,uBAAuB,CACnC,OAAO,iBAAiB,YAAY,CACpC,OAAO,qBAAqB,wCAAsC,CAClE,OAAO,oBAAoB,kBAAkB,CAC7C,OAAO,OAAO,YAAY;AACzB,MAAI,CAAC,QAAQ,YAAY,CAAC,QAAQ,SAAS;AACzC,WAAQ,MAAM,+CAA+C;AAC7D,WAAQ,KAAK,EAAE;;EAGjB,MAAM,EAAE,gBAAgB,MAAM,OAAO;EACrC,MAAM,cAAc,IAAI,aAAa;AACrC,QAAM,YAAY,YAAY;EAE9B,MAAM,SAAS,MAAM,YAAY,OAAO,QAAQ,UAAU;GACxD,MAAM,QAAQ;GACd,SAAS;IAAE,MAAM;IAAe,MAAM,QAAQ;IAAS;GACxD,CAAC;AAEF,UAAQ,IAAI,eAAe,OAAO,KAAK;AACvC,UAAQ,IAAI,gBAAgB,OAAO,WAAW;AAE9C,QAAM,YAAY,MAAM;GACxB,CACL;AAED,KAAI,WACF,IAAI,QAAQ,SAAS,CAClB,YAAY,0BAA0B,CACtC,SAAS,QAAQ,SAAS,CAC1B,OAAO,OAAO,OAAO;EACpB,MAAM,EAAE,gBAAgB,MAAM,OAAO;EACrC,MAAM,cAAc,IAAI,aAAa;AACrC,QAAM,YAAY,YAAY;EAE9B,MAAM,UAAU,MAAM,YAAY,UAAU,GAAG;AAE/C,QAAM,YAAY,MAAM;AAExB,MAAI,QACF,SAAQ,IAAI,iBAAiB,KAAK;OAC7B;AACL,WAAQ,MAAM,OAAO,GAAG,YAAY;AACpC,WAAQ,KAAK,EAAE;;GAEjB,CACL;AAED,QAAO;;AAGT,SAAS;CACP,IAAI;CACJ,MAAM;CACN,aAAa;CACb,SAAS;CACT,UAAU;EACR,UAAU;EACV,UAAU,CACR,kBACA,6DACD;EACF;CACF,CAAC"}
+{"version":3,"file":"cron.js","names":[],"sources":["../../../../src/cli/commands/cron.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { register, formatExamples } from '../registry.js';\nimport type { CLIContext } from '../registry.js';\nimport { withCronService } from './cron-cli.js';\n\nfunction createCronCommand(_ctx: CLIContext): Command {\n  const cmd = new Command('cron')\n    .description('Manage scheduled tasks')\n    .addHelpText(\n      'after',\n      formatExamples([\n        'xopc cron list                              # List all tasks',\n        'xopc cron add --schedule \"0 9 * * *\" --message \"Good morning\"',\n        'xopc cron enable <job-id>                   # Enable a task',\n        'xopc cron disable <job-id>                  # Disable a task',\n        'xopc cron run <job-id>                      # Run a task now',\n        'xopc cron remove <job-id>                   # Remove a task',\n      ]),\n    );\n\n  cmd.addCommand(\n    new Command('list')\n      .description('List all scheduled tasks')\n      .action(async () => {\n        await withCronService(async (cronService) => {\n          const jobs = await cronService.listJobs();\n\n          if (jobs.length === 0) {\n            console.log('No scheduled tasks.');\n            return;\n          }\n\n          console.log('Scheduled Tasks:\\n');\n          const { getCronPayloadText } = await import('../../cron/job-content.js');\n          for (const job of jobs) {\n            const state = job.enabled ? 'enabled ' : 'disabled';\n            console.log(`  ${job.id} [${state}] - ${job.schedule}`);\n            console.log(`     ${getCronPayloadText({ payload: job.payload })}`);\n            console.log(`     Next: ${job.next_run || 'N/A'}`);\n            console.log();\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('add')\n      .description('Add a scheduled task')\n      .option('--name <text>', 'Task name')\n      .option('--schedule <cron>', 'Cron expression (e.g., \"0 9 * * *\")')\n      .option('--message <text>', 'Message to send')\n      .action(async (options) => {\n        if (!options.schedule || !options.message) {\n          console.error('Error: --schedule and --message are required');\n          process.exit(1);\n        }\n\n        await withCronService(async (cronService) => {\n          const result = await cronService.addJob(options.schedule, {\n            name: options.name,\n            payload: { kind: 'systemEvent', text: options.message },\n          });\n\n          console.log(`✅ Added job ${result.id}`);\n          console.log(`   Schedule: ${result.schedule}`);\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('remove')\n      .description('Remove a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.removeJob(id);\n          if (success) {\n            console.log(`✅ Removed job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('enable')\n      .description('Enable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, true);\n          if (success) {\n            console.log(`✅ Enabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  cmd.addCommand(\n    new Command('disable')\n      .description('Disable a scheduled task')\n      .argument('<id>', 'Job ID')\n      .action(async (id) => {\n        await withCronService(async (cronService) => {\n          const success = await cronService.toggleJob(id, false);\n          if (success) {\n            console.log(`✅ Disabled job ${id}`);\n          } else {\n            console.error(`Job ${id} not found`);\n            process.exit(1);\n          }\n        });\n      }),\n  );\n\n  const runNowAction = async (id: string) => {\n    await withCronService(async (cronService) => {\n      try {\n        await cronService.runJobNow(id);\n        console.log(`✅ Triggered job ${id}`);\n      } catch (err) {\n        const message = err instanceof Error ? err.message : String(err);\n        console.error(message);\n        process.exit(1);\n      }\n    });\n  };\n\n  cmd.addCommand(\n    new Command('run')\n      .description('Run a scheduled task immediately')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  cmd.addCommand(\n    new Command('trigger')\n      .description('Alias for `cron run`')\n      .argument('<id>', 'Job ID')\n      .action(runNowAction),\n  );\n\n  return cmd;\n}\n\nregister({\n  id: 'cron',\n  name: 'cron',\n  description: 'Manage scheduled tasks',\n  factory: createCronCommand,\n  metadata: {\n    category: 'utility',\n    examples: [\n      'xopc cron list',\n      'xopc cron add --schedule \"0 9 * * *\" --message \"Hello\"',\n      'xopc cron enable abc12345',\n      'xopc cron run abc12345',\n    ],\n  },\n});\n\nexport { createCronCommand };\n"],"mappings":"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"}

package/dist/src/cli/commands/doctor/checks/channel-config.js

@@ -50,7 +50,7 @@ function checkWeixin(cfg) {
 	const hints = [];
 	if ((wx.accounts ? Object.keys(wx.accounts).filter((k) => k.trim()) : []).length === 0) {
 		messages.push("Weixin is enabled but no accounts are defined in config.");
-		hints.push("Run: xopc channels weixin login (or add channels.weixin.accounts).");
+		hints.push("Run: xopc channels login --channel weixin (or add channels.weixin.accounts).");
 	}
 	return {
 		ok: messages.length === 0,

package/dist/src/cli/commands/doctor/checks/channel-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"channel-config.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/channel-config.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\ntype TelegramCfg = {\n  enabled?: boolean;\n  accounts?: Record<string, { botToken?: string; dmPolicy?: string; enabled?: boolean }>;\n  dmPolicy?: string;\n};\n\ntype WeixinCfg = {\n  enabled?: boolean;\n  accounts?: Record<string, unknown>;\n};\n\nfunction checkTelegram(cfg: Config): { ok: boolean; messages: string[]; hints: string[] } {\n  const tg = cfg.channels?.telegram as TelegramCfg | undefined;\n  if (!tg) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const defaultAcc = tg.accounts?.default;\n  const token = defaultAcc?.botToken?.trim() ?? '';\n  const enabled = tg.enabled === true || token.length > 0;\n\n  if (!enabled) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const messages: string[] = [];\n  const hints: string[] = [];\n\n  if (!token) {\n    messages.push('Telegram is enabled but no bot token is set.');\n    hints.push('Set channels.telegram.accounts.default.botToken.');\n  }\n\n  const dm = (defaultAcc?.dmPolicy ?? tg.dmPolicy) || 'pairing';\n  if (!['pairing', 'allowlist', 'open', 'disabled'].includes(dm)) {\n    messages.push(`Telegram dmPolicy \"${dm}\" is not valid.`);\n  }\n  if (dm === 'open') {\n    messages.push('Telegram DM policy is \"open\" (any user can message the bot).');\n    hints.push('Consider \"pairing\" or \"allowlist\" for stricter access.');\n  }\n\n  return {\n    ok: messages.length === 0,\n    messages,\n    hints,\n  };\n}\n\nfunction checkWeixin(cfg: Config): { ok: boolean; messages: string[]; hints: string[] } {\n  const wx = cfg.channels?.weixin as WeixinCfg | undefined;\n  if (!wx || wx.enabled !== true) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const messages: string[] = [];\n  const hints: string[] = [];\n  const accountKeys = wx.accounts ? Object.keys(wx.accounts).filter((k) => k.trim()) : [];\n  if (accountKeys.length === 0) {\n    messages.push('Weixin is enabled but no accounts are defined in config.');\n    hints.push('Run: xopc channels weixin login (or add channels.weixin.accounts).');\n  }\n\n  return { ok: messages.length === 0, messages, hints };\n}\n\nexport async function checkChannelConfig(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const tg = checkTelegram(cfg);\n  const wx = checkWeixin(cfg);\n  const allMsg = [...tg.messages, ...wx.messages];\n  const allHints = [...tg.hints, ...wx.hints];\n\n  const tgEnabled =\n    (cfg.channels?.telegram as TelegramCfg | undefined)?.enabled === true ||\n    Boolean((cfg.channels?.telegram as TelegramCfg | undefined)?.accounts?.default?.botToken?.trim());\n  const wxOn = (cfg.channels?.weixin as WeixinCfg | undefined)?.enabled === true;\n  if (!tgEnabled && !wxOn) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'No channels enabled; skipped.',\n      hints: [],\n    };\n  }\n\n  if (allMsg.length === 0) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'pass',\n      message: 'Enabled channel configuration looks valid.',\n      hints: [],\n    };\n  }\n\n  const hasFail = allMsg.some((m) => m.includes('no bot token') || m.includes('no accounts'));\n  return {\n    id: 'channel-config',\n    label: 'Channels',\n    status: hasFail ? 'fail' : 'warn',\n    message: allMsg.join(' '),\n    hints: allHints,\n  };\n}\n"],"mappings":";;;aAE0D;AAe1D,SAAS,cAAc,KAAmE;CACxF,MAAM,KAAK,IAAI,UAAU;AACzB,KAAI,CAAC,GACH,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,aAAa,GAAG,UAAU;CAChC,MAAM,QAAQ,YAAY,UAAU,MAAM,IAAI;AAG9C,KAAI,EAFY,GAAG,YAAY,QAAQ,MAAM,SAAS,GAGpD,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,WAAqB,EAAE;CAC7B,MAAM,QAAkB,EAAE;AAE1B,KAAI,CAAC,OAAO;AACV,WAAS,KAAK,+CAA+C;AAC7D,QAAM,KAAK,mDAAmD;;CAGhE,MAAM,MAAM,YAAY,YAAY,GAAG,aAAa;AACpD,KAAI,CAAC;EAAC;EAAW;EAAa;EAAQ;EAAW,CAAC,SAAS,GAAG,CAC5D,UAAS,KAAK,sBAAsB,GAAG,iBAAiB;AAE1D,KAAI,OAAO,QAAQ;AACjB,WAAS,KAAK,iEAA+D;AAC7E,QAAM,KAAK,6DAAyD;;AAGtE,QAAO;EACL,IAAI,SAAS,WAAW;EACxB;EACA;EACD;;AAGH,SAAS,YAAY,KAAmE;CACtF,MAAM,KAAK,IAAI,UAAU;AACzB,KAAI,CAAC,MAAM,GAAG,YAAY,KACxB,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,WAAqB,EAAE;CAC7B,MAAM,QAAkB,EAAE;AAE1B,MADoB,GAAG,WAAW,OAAO,KAAK,GAAG,SAAS,CAAC,QAAQ,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,EACvE,WAAW,GAAG;AAC5B,WAAS,KAAK,2DAA2D;AACzE,QAAM,KAAK,qEAAqE;;AAGlF,QAAO;EAAE,IAAI,SAAS,WAAW;EAAG;EAAU;EAAO;;AAGvD,eAAsB,mBAAmB,KAA0C;AACjF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,KAAK,cAAc,IAAI;CAC7B,MAAM,KAAK,YAAY,IAAI;CAC3B,MAAM,SAAS,CAAC,GAAG,GAAG,UAAU,GAAG,GAAG,SAAS;CAC/C,MAAM,WAAW,CAAC,GAAG,GAAG,OAAO,GAAG,GAAG,MAAM;CAE3C,MAAM,aACH,IAAI,UAAU,WAAsC,YAAY,QACjE,SAAS,IAAI,UAAU,WAAsC,UAAU,SAAS,UAAU,MAAM,CAAC;CACnG,MAAM,QAAQ,IAAI,UAAU,SAAkC,YAAY;AAC1E,KAAI,CAAC,aAAa,CAAC,KACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAGH,KAAI,OAAO,WAAW,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAIH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAJc,OAAO,MAAM,MAAM,EAAE,SAAS,eAAe,IAAI,EAAE,SAAS,cAAc,CAIzE,GAAG,SAAS;EAC3B,SAAS,OAAO,KAAK,IAAI;EACzB,OAAO;EACR"}
+{"version":3,"file":"channel-config.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/channel-config.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\ntype TelegramCfg = {\n  enabled?: boolean;\n  accounts?: Record<string, { botToken?: string; dmPolicy?: string; enabled?: boolean }>;\n  dmPolicy?: string;\n};\n\ntype WeixinCfg = {\n  enabled?: boolean;\n  accounts?: Record<string, unknown>;\n};\n\nfunction checkTelegram(cfg: Config): { ok: boolean; messages: string[]; hints: string[] } {\n  const tg = cfg.channels?.telegram as TelegramCfg | undefined;\n  if (!tg) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const defaultAcc = tg.accounts?.default;\n  const token = defaultAcc?.botToken?.trim() ?? '';\n  const enabled = tg.enabled === true || token.length > 0;\n\n  if (!enabled) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const messages: string[] = [];\n  const hints: string[] = [];\n\n  if (!token) {\n    messages.push('Telegram is enabled but no bot token is set.');\n    hints.push('Set channels.telegram.accounts.default.botToken.');\n  }\n\n  const dm = (defaultAcc?.dmPolicy ?? tg.dmPolicy) || 'pairing';\n  if (!['pairing', 'allowlist', 'open', 'disabled'].includes(dm)) {\n    messages.push(`Telegram dmPolicy \"${dm}\" is not valid.`);\n  }\n  if (dm === 'open') {\n    messages.push('Telegram DM policy is \"open\" (any user can message the bot).');\n    hints.push('Consider \"pairing\" or \"allowlist\" for stricter access.');\n  }\n\n  return {\n    ok: messages.length === 0,\n    messages,\n    hints,\n  };\n}\n\nfunction checkWeixin(cfg: Config): { ok: boolean; messages: string[]; hints: string[] } {\n  const wx = cfg.channels?.weixin as WeixinCfg | undefined;\n  if (!wx || wx.enabled !== true) {\n    return { ok: true, messages: [], hints: [] };\n  }\n\n  const messages: string[] = [];\n  const hints: string[] = [];\n  const accountKeys = wx.accounts ? Object.keys(wx.accounts).filter((k) => k.trim()) : [];\n  if (accountKeys.length === 0) {\n    messages.push('Weixin is enabled but no accounts are defined in config.');\n    hints.push('Run: xopc channels login --channel weixin (or add channels.weixin.accounts).');\n  }\n\n  return { ok: messages.length === 0, messages, hints };\n}\n\nexport async function checkChannelConfig(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const tg = checkTelegram(cfg);\n  const wx = checkWeixin(cfg);\n  const allMsg = [...tg.messages, ...wx.messages];\n  const allHints = [...tg.hints, ...wx.hints];\n\n  const tgEnabled =\n    (cfg.channels?.telegram as TelegramCfg | undefined)?.enabled === true ||\n    Boolean((cfg.channels?.telegram as TelegramCfg | undefined)?.accounts?.default?.botToken?.trim());\n  const wxOn = (cfg.channels?.weixin as WeixinCfg | undefined)?.enabled === true;\n  if (!tgEnabled && !wxOn) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'skip',\n      message: 'No channels enabled; skipped.',\n      hints: [],\n    };\n  }\n\n  if (allMsg.length === 0) {\n    return {\n      id: 'channel-config',\n      label: 'Channels',\n      status: 'pass',\n      message: 'Enabled channel configuration looks valid.',\n      hints: [],\n    };\n  }\n\n  const hasFail = allMsg.some((m) => m.includes('no bot token') || m.includes('no accounts'));\n  return {\n    id: 'channel-config',\n    label: 'Channels',\n    status: hasFail ? 'fail' : 'warn',\n    message: allMsg.join(' '),\n    hints: allHints,\n  };\n}\n"],"mappings":";;;aAE0D;AAe1D,SAAS,cAAc,KAAmE;CACxF,MAAM,KAAK,IAAI,UAAU;AACzB,KAAI,CAAC,GACH,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,aAAa,GAAG,UAAU;CAChC,MAAM,QAAQ,YAAY,UAAU,MAAM,IAAI;AAG9C,KAAI,EAFY,GAAG,YAAY,QAAQ,MAAM,SAAS,GAGpD,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,WAAqB,EAAE;CAC7B,MAAM,QAAkB,EAAE;AAE1B,KAAI,CAAC,OAAO;AACV,WAAS,KAAK,+CAA+C;AAC7D,QAAM,KAAK,mDAAmD;;CAGhE,MAAM,MAAM,YAAY,YAAY,GAAG,aAAa;AACpD,KAAI,CAAC;EAAC;EAAW;EAAa;EAAQ;EAAW,CAAC,SAAS,GAAG,CAC5D,UAAS,KAAK,sBAAsB,GAAG,iBAAiB;AAE1D,KAAI,OAAO,QAAQ;AACjB,WAAS,KAAK,iEAA+D;AAC7E,QAAM,KAAK,6DAAyD;;AAGtE,QAAO;EACL,IAAI,SAAS,WAAW;EACxB;EACA;EACD;;AAGH,SAAS,YAAY,KAAmE;CACtF,MAAM,KAAK,IAAI,UAAU;AACzB,KAAI,CAAC,MAAM,GAAG,YAAY,KACxB,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,WAAqB,EAAE;CAC7B,MAAM,QAAkB,EAAE;AAE1B,MADoB,GAAG,WAAW,OAAO,KAAK,GAAG,SAAS,CAAC,QAAQ,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,EACvE,WAAW,GAAG;AAC5B,WAAS,KAAK,2DAA2D;AACzE,QAAM,KAAK,+EAA+E;;AAG5F,QAAO;EAAE,IAAI,SAAS,WAAW;EAAG;EAAU;EAAO;;AAGvD,eAAsB,mBAAmB,KAA0C;AACjF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,KAAK,cAAc,IAAI;CAC7B,MAAM,KAAK,YAAY,IAAI;CAC3B,MAAM,SAAS,CAAC,GAAG,GAAG,UAAU,GAAG,GAAG,SAAS;CAC/C,MAAM,WAAW,CAAC,GAAG,GAAG,OAAO,GAAG,GAAG,MAAM;CAE3C,MAAM,aACH,IAAI,UAAU,WAAsC,YAAY,QACjE,SAAS,IAAI,UAAU,WAAsC,UAAU,SAAS,UAAU,MAAM,CAAC;CACnG,MAAM,QAAQ,IAAI,UAAU,SAAkC,YAAY;AAC1E,KAAI,CAAC,aAAa,CAAC,KACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAGH,KAAI,OAAO,WAAW,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;AAIH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAJc,OAAO,MAAM,MAAM,EAAE,SAAS,eAAe,IAAI,EAAE,SAAS,cAAc,CAIzE,GAAG,SAAS;EAC3B,SAAS,OAAO,KAAK,IAAI;EACzB,OAAO;EACR"}

package/dist/src/cli/commands/doctor/checks/config-health.js

@@ -1,7 +1,7 @@
 import { ConfigSchema, init_schema } from "../../../../config/schema.js";
 import { init_loader, loadConfig, saveConfig } from "../../../../config/loader.js";
-import { dirname } from "node:path";
 import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname } from "node:path";
 //#region src/cli/commands/doctor/checks/config-health.ts
 init_loader();
 init_schema();
@@ -33,7 +33,7 @@ async function checkConfigHealth(ctx) {
 			label: "Config",
 			status: "fail",
 			message: "Config file not found.",
-			hints: [`Run: xopc init`, `Or: xopc doctor --fix`]
+			hints: [`Run: xopc init (or xopc setup)`, `Or: xopc doctor --fix`]
 		};
 	}
 	let raw;

package/dist/src/cli/commands/doctor/checks/config-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/config-health.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { mkdirSync } from 'node:fs';\n\nimport { loadConfig, saveConfig } from '../../../../config/loader.js';\nimport { ConfigSchema } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkConfigHealth(ctx: DoctorContext): Promise<CheckResult> {\n  const path = ctx.configPath;\n\n  if (!existsSync(path)) {\n    if (ctx.options.fix) {\n      try {\n        const dir = dirname(path);\n        mkdirSync(dir, { recursive: true });\n        const defaults = loadConfig(path);\n        await saveConfig(defaults, path);\n        return {\n          id: 'config-health',\n          label: 'Config',\n          status: 'pass',\n          message: 'Created default config file.',\n          hints: [path],\n          fixed: true,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          id: 'config-health',\n          label: 'Config',\n          status: 'fail',\n          message: `Config file missing and could not create default: ${msg}`,\n          hints: [path],\n        };\n      }\n    }\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config file not found.',\n      hints: [`Run: xopc init`, `Or: xopc doctor --fix`],\n    };\n  }\n\n  let raw: string;\n  try {\n    raw = readFileSync(path, 'utf-8');\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: `Cannot read config file: ${msg}`,\n      hints: [path],\n    };\n  }\n\n  let json: unknown;\n  try {\n    json = JSON.parse(raw);\n  } catch {\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config file is not valid JSON.',\n      hints: ['Fix syntax or restore from backup (.bak).', path],\n    };\n  }\n\n  const parsed = ConfigSchema.safeParse(json);\n  if (!parsed.success) {\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config does not match the expected schema.',\n      hints: parsed.error.issues.slice(0, 5).map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`),\n    };\n  }\n\n  return {\n    id: 'config-health',\n    label: 'Config',\n    status: 'pass',\n    message: 'Config file exists and validates.',\n    hints: [path],\n  };\n}\n"],"mappings":";;;;;aAIsE;aACV;AAG5D,eAAsB,kBAAkB,KAA0C;CAChF,MAAM,OAAO,IAAI;AAEjB,KAAI,CAAC,WAAW,KAAK,EAAE;AACrB,MAAI,IAAI,QAAQ,IACd,KAAI;AAEF,aADY,QAAQ,KACP,EAAE,EAAE,WAAW,MAAM,CAAC;AAEnC,SAAM,WADW,WAAW,KACH,EAAE,KAAK;AAChC,UAAO;IACL,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO,CAAC,KAAK;IACb,OAAO;IACR;WACM,GAAG;AAEV,UAAO;IACL,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,SAAS,qDALC,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;IAMpD,OAAO,CAAC,KAAK;IACd;;AAGL,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,kBAAkB,wBAAwB;GACnD;;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,aAAa,MAAM,QAAQ;UAC1B,GAAG;AAEV,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,4BALC,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;GAMpD,OAAO,CAAC,KAAK;GACd;;CAGH,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,IAAI;SAChB;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,6CAA6C,KAAK;GAC3D;;CAGH,MAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,KAAI,CAAC,OAAO,QACV,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,OAAO,MAAM,OAAO,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,EAAE,UAAU;EACnG;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,KAAK;EACd"}
+{"version":3,"file":"config-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/config-health.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { dirname } from 'node:path';\nimport { mkdirSync } from 'node:fs';\n\nimport { loadConfig, saveConfig } from '../../../../config/loader.js';\nimport { ConfigSchema } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkConfigHealth(ctx: DoctorContext): Promise<CheckResult> {\n  const path = ctx.configPath;\n\n  if (!existsSync(path)) {\n    if (ctx.options.fix) {\n      try {\n        const dir = dirname(path);\n        mkdirSync(dir, { recursive: true });\n        const defaults = loadConfig(path);\n        await saveConfig(defaults, path);\n        return {\n          id: 'config-health',\n          label: 'Config',\n          status: 'pass',\n          message: 'Created default config file.',\n          hints: [path],\n          fixed: true,\n        };\n      } catch (e) {\n        const msg = e instanceof Error ? e.message : String(e);\n        return {\n          id: 'config-health',\n          label: 'Config',\n          status: 'fail',\n          message: `Config file missing and could not create default: ${msg}`,\n          hints: [path],\n        };\n      }\n    }\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config file not found.',\n      hints: [`Run: xopc init (or xopc setup)`, `Or: xopc doctor --fix`],\n    };\n  }\n\n  let raw: string;\n  try {\n    raw = readFileSync(path, 'utf-8');\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: `Cannot read config file: ${msg}`,\n      hints: [path],\n    };\n  }\n\n  let json: unknown;\n  try {\n    json = JSON.parse(raw);\n  } catch {\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config file is not valid JSON.',\n      hints: ['Fix syntax or restore from backup (.bak).', path],\n    };\n  }\n\n  const parsed = ConfigSchema.safeParse(json);\n  if (!parsed.success) {\n    return {\n      id: 'config-health',\n      label: 'Config',\n      status: 'fail',\n      message: 'Config does not match the expected schema.',\n      hints: parsed.error.issues.slice(0, 5).map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`),\n    };\n  }\n\n  return {\n    id: 'config-health',\n    label: 'Config',\n    status: 'pass',\n    message: 'Config file exists and validates.',\n    hints: [path],\n  };\n}\n"],"mappings":";;;;;aAIsE;aACV;AAG5D,eAAsB,kBAAkB,KAA0C;CAChF,MAAM,OAAO,IAAI;AAEjB,KAAI,CAAC,WAAW,KAAK,EAAE;AACrB,MAAI,IAAI,QAAQ,IACd,KAAI;AAEF,aADY,QAAQ,KACP,EAAE,EAAE,WAAW,MAAM,CAAC;AAEnC,SAAM,WADW,WAAW,KACH,EAAE,KAAK;AAChC,UAAO;IACL,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO,CAAC,KAAK;IACb,OAAO;IACR;WACM,GAAG;AAEV,UAAO;IACL,IAAI;IACJ,OAAO;IACP,QAAQ;IACR,SAAS,qDALC,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;IAMpD,OAAO,CAAC,KAAK;IACd;;AAGL,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,kCAAkC,wBAAwB;GACnE;;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,aAAa,MAAM,QAAQ;UAC1B,GAAG;AAEV,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,4BALC,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;GAMpD,OAAO,CAAC,KAAK;GACd;;CAGH,IAAI;AACJ,KAAI;AACF,SAAO,KAAK,MAAM,IAAI;SAChB;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,6CAA6C,KAAK;GAC3D;;CAGH,MAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,KAAI,CAAC,OAAO,QACV,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,OAAO,MAAM,OAAO,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,EAAE,UAAU;EACnG;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,KAAK;EACd"}

package/dist/src/cli/commands/doctor/checks/cron-health.js

@@ -38,7 +38,7 @@ async function checkCronHealth(ctx) {
 		label: "Cron",
 		status: "warn",
 		message: "Cron directory does not exist.",
-		hints: [cronDir, "Run: xopc init"]
+		hints: [cronDir, "Run: xopc init (creates cron directory)"]
 	};
 	const jobsPath = resolveCronJobsPath();
 	if (!existsSync(jobsPath)) return {

package/dist/src/cli/commands/doctor/checks/cron-health.js.map

@@ -1 +1 @@
-{"version":3,"file":"cron-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/cron-health.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport { resolveCronDir, resolveCronJobsPath } from '../../../../config/paths.js';\nimport { JobDataSchema } from '../../../../cron/validation.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkCronHealth(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  if (cfg.cron?.enabled === false) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Cron is disabled in config; skipped.',\n      hints: [],\n    };\n  }\n\n  const cronDir = resolveCronDir();\n  if (!existsSync(cronDir)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron directory does not exist.',\n      hints: [cronDir, 'Run: xopc init'],\n    };\n  }\n\n  const jobsPath = resolveCronJobsPath();\n  if (!existsSync(jobsPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is missing.',\n      hints: [jobsPath],\n    };\n  }\n\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(jobsPath, 'utf-8'));\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is not valid JSON.',\n      hints: [jobsPath],\n    };\n  }\n\n  if (!raw || typeof raw !== 'object' || !('jobs' in raw) || !Array.isArray((raw as { jobs: unknown }).jobs)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file has invalid structure (expected { jobs: [] }).',\n      hints: [jobsPath],\n    };\n  }\n\n  const jobs = (raw as { jobs: unknown[] }).jobs;\n  const hints: string[] = [];\n  let valid = 0;\n  let enabled = 0;\n  let scheduleMissing = 0;\n\n  for (const j of jobs) {\n    const r = JobDataSchema.safeParse(j);\n    if (r.success) {\n      valid++;\n      if (r.data.enabled) {\n        enabled++;\n        const sched = r.data.schedule?.trim();\n        if (!sched) {\n          scheduleMissing++;\n          hints.push(`Job \"${r.data.name || r.data.id}\" is enabled but has no schedule.`);\n        }\n      }\n    } else {\n      hints.push('One or more job entries failed validation (check jobs.json).');\n      break;\n    }\n  }\n\n  if (valid !== jobs.length) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Some cron jobs are invalid or could not be validated.',\n      hints: hints.length ? hints.slice(0, 5) : [jobsPath],\n    };\n  }\n\n  if (scheduleMissing > 0) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: `${scheduleMissing} enabled job(s) are missing a schedule.`,\n      hints: hints.slice(0, 5),\n    };\n  }\n\n  return {\n    id: 'cron-health',\n    label: 'Cron',\n    status: 'pass',\n    message: `Cron jobs file is valid (${enabled} enabled, ${jobs.length} total).`,\n    hints: [jobsPath],\n  };\n}\n"],"mappings":";;;;;aAE0D;YAEwB;AAIlF,eAAsB,gBAAgB,KAA0C;AAC9E,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;AAGH,KAAI,IAAI,MAAM,YAAY,MACxB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,MAAM,UAAU,gBAAgB;AAChC,KAAI,CAAC,WAAW,QAAQ,CACtB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS,iBAAiB;EACnC;CAGH,MAAM,WAAW,qBAAqB;AACtC,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,MAAM,aAAa,UAAU,QAAQ,CAAC;SAC3C;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,SAAS;GAClB;;AAGH,KAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,EAAE,UAAU,QAAQ,CAAC,MAAM,QAAS,IAA0B,KAAK,CACxG,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,MAAM,OAAQ,IAA4B;CAC1C,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;CACZ,IAAI,UAAU;CACd,IAAI,kBAAkB;AAEtB,MAAK,MAAM,KAAK,MAAM;EACpB,MAAM,IAAI,cAAc,UAAU,EAAE;AACpC,MAAI,EAAE,SAAS;AACb;AACA,OAAI,EAAE,KAAK,SAAS;AAClB;AAEA,QAAI,CADU,EAAE,KAAK,UAAU,MAAM,EACzB;AACV;AACA,WAAM,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,GAAG,mCAAmC;;;SAG9E;AACL,SAAM,KAAK,+DAA+D;AAC1E;;;AAIJ,KAAI,UAAU,KAAK,OACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,MAAM,SAAS,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,SAAS;EACrD;AAGH,KAAI,kBAAkB,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,GAAG,gBAAgB;EAC5B,OAAO,MAAM,MAAM,GAAG,EAAE;EACzB;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,4BAA4B,QAAQ,YAAY,KAAK,OAAO;EACrE,OAAO,CAAC,SAAS;EAClB"}
+{"version":3,"file":"cron-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/cron-health.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport type { Config } from '../../../../config/schema.js';\nimport { resolveCronDir, resolveCronJobsPath } from '../../../../config/paths.js';\nimport { JobDataSchema } from '../../../../cron/validation.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nexport async function checkCronHealth(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  if (cfg.cron?.enabled === false) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'skip',\n      message: 'Cron is disabled in config; skipped.',\n      hints: [],\n    };\n  }\n\n  const cronDir = resolveCronDir();\n  if (!existsSync(cronDir)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron directory does not exist.',\n      hints: [cronDir, 'Run: xopc init (creates cron directory)'],\n    };\n  }\n\n  const jobsPath = resolveCronJobsPath();\n  if (!existsSync(jobsPath)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is missing.',\n      hints: [jobsPath],\n    };\n  }\n\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(jobsPath, 'utf-8'));\n  } catch {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file is not valid JSON.',\n      hints: [jobsPath],\n    };\n  }\n\n  if (!raw || typeof raw !== 'object' || !('jobs' in raw) || !Array.isArray((raw as { jobs: unknown }).jobs)) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Cron jobs file has invalid structure (expected { jobs: [] }).',\n      hints: [jobsPath],\n    };\n  }\n\n  const jobs = (raw as { jobs: unknown[] }).jobs;\n  const hints: string[] = [];\n  let valid = 0;\n  let enabled = 0;\n  let scheduleMissing = 0;\n\n  for (const j of jobs) {\n    const r = JobDataSchema.safeParse(j);\n    if (r.success) {\n      valid++;\n      if (r.data.enabled) {\n        enabled++;\n        const sched = r.data.schedule?.trim();\n        if (!sched) {\n          scheduleMissing++;\n          hints.push(`Job \"${r.data.name || r.data.id}\" is enabled but has no schedule.`);\n        }\n      }\n    } else {\n      hints.push('One or more job entries failed validation (check jobs.json).');\n      break;\n    }\n  }\n\n  if (valid !== jobs.length) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: 'Some cron jobs are invalid or could not be validated.',\n      hints: hints.length ? hints.slice(0, 5) : [jobsPath],\n    };\n  }\n\n  if (scheduleMissing > 0) {\n    return {\n      id: 'cron-health',\n      label: 'Cron',\n      status: 'warn',\n      message: `${scheduleMissing} enabled job(s) are missing a schedule.`,\n      hints: hints.slice(0, 5),\n    };\n  }\n\n  return {\n    id: 'cron-health',\n    label: 'Cron',\n    status: 'pass',\n    message: `Cron jobs file is valid (${enabled} enabled, ${jobs.length} total).`,\n    hints: [jobsPath],\n  };\n}\n"],"mappings":";;;;;aAE0D;YAEwB;AAIlF,eAAsB,gBAAgB,KAA0C;AAC9E,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;AAGH,KAAI,IAAI,MAAM,YAAY,MACxB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,MAAM,UAAU,gBAAgB;AAChC,KAAI,CAAC,WAAW,QAAQ,CACtB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS,0CAA0C;EAC5D;CAGH,MAAM,WAAW,qBAAqB;AACtC,KAAI,CAAC,WAAW,SAAS,CACvB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,MAAM,aAAa,UAAU,QAAQ,CAAC;SAC3C;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,CAAC,SAAS;GAClB;;AAGH,KAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,EAAE,UAAU,QAAQ,CAAC,MAAM,QAAS,IAA0B,KAAK,CACxG,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,CAAC,SAAS;EAClB;CAGH,MAAM,OAAQ,IAA4B;CAC1C,MAAM,QAAkB,EAAE;CAC1B,IAAI,QAAQ;CACZ,IAAI,UAAU;CACd,IAAI,kBAAkB;AAEtB,MAAK,MAAM,KAAK,MAAM;EACpB,MAAM,IAAI,cAAc,UAAU,EAAE;AACpC,MAAI,EAAE,SAAS;AACb;AACA,OAAI,EAAE,KAAK,SAAS;AAClB;AAEA,QAAI,CADU,EAAE,KAAK,UAAU,MAAM,EACzB;AACV;AACA,WAAM,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,GAAG,mCAAmC;;;SAG9E;AACL,SAAM,KAAK,+DAA+D;AAC1E;;;AAIJ,KAAI,UAAU,KAAK,OACjB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,MAAM,SAAS,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,SAAS;EACrD;AAGH,KAAI,kBAAkB,EACpB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,GAAG,gBAAgB;EAC5B,OAAO,MAAM,MAAM,GAAG,EAAE;EACzB;AAGH,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS,4BAA4B,QAAQ,YAAY,KAAK,OAAO;EACrE,OAAO,CAAC,SAAS;EAClB"}

package/dist/src/cli/commands/doctor/checks/gateway-health.js

@@ -46,7 +46,7 @@ async function checkGatewayHealth(ctx) {
 			label: "Gateway HTTP",
 			status: "warn",
 			message: `Gateway returned HTTP ${res.status} at ${url}.`,
-			hints: ["Start the gateway: xopc gateway start"]
+			hints: ["Start the gateway: xopc gateway service start (or xopc gateway for foreground)"]
 		};
 	} catch (e) {
 		clearTimeout(timer);
@@ -55,7 +55,7 @@ async function checkGatewayHealth(ctx) {
 			label: "Gateway HTTP",
 			status: "warn",
 			message: e instanceof Error && e.name === "AbortError" ? `Gateway did not respond within ${FETCH_TIMEOUT_MS / 1e3}s (${url}).` : `Gateway not reachable (${url}).`,
-			hints: ["Start the gateway: xopc gateway start", `Configured base: ${base}`]
+			hints: ["Start the gateway: xopc gateway service start (or xopc gateway for foreground)", `Configured base: ${base}`]
 		};
 	}
 }

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

@@ -1 +1 @@
-{"version":3,"file":"gateway-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/gateway-health.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport { resolveGatewayLocalClientHost } from '../../../../config/gateway-bind.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nfunction resolveGatewayBaseUrl(cfg: Config): string {\n  const host = resolveGatewayLocalClientHost(cfg);\n  const port = cfg.gateway?.port ?? 18790;\n  return `http://${host}:${port}`;\n}\n\nconst FETCH_TIMEOUT_MS = 5000;\n\nexport async function checkGatewayHealth(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const base = resolveGatewayBaseUrl(cfg);\n  const url = `${base.replace(/\\/$/, '')}/health`;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\n  try {\n    const res = await fetch(url, { signal: controller.signal });\n    clearTimeout(timer);\n    if (res.ok) {\n      return {\n        id: 'gateway-health',\n        label: 'Gateway HTTP',\n        status: 'pass',\n        message: `Gateway responded OK at ${url}.`,\n        hints: [],\n      };\n    }\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'warn',\n      message: `Gateway returned HTTP ${res.status} at ${url}.`,\n      hints: ['Start the gateway: xopc gateway start'],\n    };\n  } catch (e) {\n    clearTimeout(timer);\n    const isAbort = e instanceof Error && e.name === 'AbortError';\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'warn',\n      message: isAbort\n        ? `Gateway did not respond within ${FETCH_TIMEOUT_MS / 1000}s (${url}).`\n        : `Gateway not reachable (${url}).`,\n      hints: ['Start the gateway: xopc gateway start', `Configured base: ${base}`],\n    };\n  }\n}\n"],"mappings":";;;;aAE0D;AAK1D,SAAS,sBAAsB,KAAqB;AAGlD,QAAO,UAFM,8BAA8B,IAEtB,CAAC,GADT,IAAI,SAAS,QAAQ;;AAIpC,MAAM,mBAAmB;AAEzB,eAAsB,mBAAmB,KAA0C;AACjF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,OAAO,sBAAsB,IAAI;CACvC,MAAM,MAAM,GAAG,KAAK,QAAQ,OAAO,GAAG,CAAC;CACvC,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,QAAQ,iBAAiB,WAAW,OAAO,EAAE,iBAAiB;AAEpE,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,KAAK,EAAE,QAAQ,WAAW,QAAQ,CAAC;AAC3D,eAAa,MAAM;AACnB,MAAI,IAAI,GACN,QAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,2BAA2B,IAAI;GACxC,OAAO,EAAE;GACV;AAEH,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,yBAAyB,IAAI,OAAO,MAAM,IAAI;GACvD,OAAO,CAAC,wCAAwC;GACjD;UACM,GAAG;AACV,eAAa,MAAM;AAEnB,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SALc,aAAa,SAAS,EAAE,SAAS,eAM3C,kCAAkC,mBAAmB,IAAK,KAAK,IAAI,MACnE,0BAA0B,IAAI;GAClC,OAAO,CAAC,yCAAyC,oBAAoB,OAAO;GAC7E"}
+{"version":3,"file":"gateway-health.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/gateway-health.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\n\nimport { loadConfig } from '../../../../config/loader.js';\nimport { resolveGatewayLocalClientHost } from '../../../../config/gateway-bind.js';\nimport type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nfunction resolveGatewayBaseUrl(cfg: Config): string {\n  const host = resolveGatewayLocalClientHost(cfg);\n  const port = cfg.gateway?.port ?? 18790;\n  return `http://${host}:${port}`;\n}\n\nconst FETCH_TIMEOUT_MS = 5000;\n\nexport async function checkGatewayHealth(ctx: DoctorContext): Promise<CheckResult> {\n  if (!existsSync(ctx.configPath)) {\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'skip',\n      message: 'No config file; skipped.',\n      hints: [],\n    };\n  }\n\n  let cfg: Config;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'skip',\n      message: 'Config could not be loaded; skipped.',\n      hints: [],\n    };\n  }\n\n  const base = resolveGatewayBaseUrl(cfg);\n  const url = `${base.replace(/\\/$/, '')}/health`;\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);\n\n  try {\n    const res = await fetch(url, { signal: controller.signal });\n    clearTimeout(timer);\n    if (res.ok) {\n      return {\n        id: 'gateway-health',\n        label: 'Gateway HTTP',\n        status: 'pass',\n        message: `Gateway responded OK at ${url}.`,\n        hints: [],\n      };\n    }\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'warn',\n      message: `Gateway returned HTTP ${res.status} at ${url}.`,\n      hints: ['Start the gateway: xopc gateway service start (or xopc gateway for foreground)'],\n    };\n  } catch (e) {\n    clearTimeout(timer);\n    const isAbort = e instanceof Error && e.name === 'AbortError';\n    return {\n      id: 'gateway-health',\n      label: 'Gateway HTTP',\n      status: 'warn',\n      message: isAbort\n        ? `Gateway did not respond within ${FETCH_TIMEOUT_MS / 1000}s (${url}).`\n        : `Gateway not reachable (${url}).`,\n      hints: ['Start the gateway: xopc gateway service start (or xopc gateway for foreground)', `Configured base: ${base}`],\n    };\n  }\n}\n"],"mappings":";;;;aAE0D;AAK1D,SAAS,sBAAsB,KAAqB;AAGlD,QAAO,UAFM,8BAA8B,IAEtB,CAAC,GADT,IAAI,SAAS,QAAQ;;AAIpC,MAAM,mBAAmB;AAEzB,eAAsB,mBAAmB,KAA0C;AACjF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO;EACL,IAAI;EACJ,OAAO;EACP,QAAQ;EACR,SAAS;EACT,OAAO,EAAE;EACV;CAGH,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,OAAO,sBAAsB,IAAI;CACvC,MAAM,MAAM,GAAG,KAAK,QAAQ,OAAO,GAAG,CAAC;CACvC,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,QAAQ,iBAAiB,WAAW,OAAO,EAAE,iBAAiB;AAEpE,KAAI;EACF,MAAM,MAAM,MAAM,MAAM,KAAK,EAAE,QAAQ,WAAW,QAAQ,CAAC;AAC3D,eAAa,MAAM;AACnB,MAAI,IAAI,GACN,QAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,2BAA2B,IAAI;GACxC,OAAO,EAAE;GACV;AAEH,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SAAS,yBAAyB,IAAI,OAAO,MAAM,IAAI;GACvD,OAAO,CAAC,iFAAiF;GAC1F;UACM,GAAG;AACV,eAAa,MAAM;AAEnB,SAAO;GACL,IAAI;GACJ,OAAO;GACP,QAAQ;GACR,SALc,aAAa,SAAS,EAAE,SAAS,eAM3C,kCAAkC,mBAAmB,IAAK,KAAK,IAAI,MACnE,0BAA0B,IAAI;GAClC,OAAO,CAAC,kFAAkF,oBAAoB,OAAO;GACtH"}