@xopcai/xopc 0.0.6 → 0.0.8

package/dist/src/agent/tools/read.js

@@ -77,9 +77,7 @@ async function executeReadFile(workspace, bootstrapDir, params) {
 		};
 	}
 }
-/** @deprecated Use {@link createReadFileTool}(process.cwd()) — default cwd; prefer factory with workspace. */
-const readFileTool = createReadFileTool(process.cwd());
 //#endregion
-export { createReadFileTool, readFileTool };
+export { createReadFileTool };
 
 //# sourceMappingURL=read.js.map

package/dist/src/agent/tools/read.js.map

@@ -1 +1 @@
-{"version":3,"file":"read.js","names":[],"sources":["../../../../src/agent/tools/read.ts"],"sourcesContent":["// Read file tool\nimport { Type, type Static } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport { readFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport { truncateHead, formatSize, DEFAULT_MAX_BYTES } from './truncate.js';\nimport {\n  isBareBootstrapFileName,\n  resolveBootstrapPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\nconst DEFAULT_MAX_LINES = 500;\n\nconst ReadFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to read' }),\n  limit: Type.Optional(Type.Number({ description: 'Max lines (default: 500)' })),\n});\n\nexport interface CreateReadFileToolOptions {\n  /** When set and the path is a bare bootstrap name (e.g. SOUL.md), try this dir if not in workspace. */\n  bootstrapDir?: string;\n}\n\nexport function createReadFileTool(\n  workspace: string,\n  options?: CreateReadFileToolOptions,\n): AgentTool<typeof ReadFileSchema, {}> {\n  return {\n    name: 'read_file',\n    description:\n      'Read file contents. Relative paths are from the current agent workspace; persona files (SOUL.md, etc.) may live in agent bootstrap and are found automatically when given by filename.',\n    parameters: ReadFileSchema,\n    label: '📄 Read',\n\n    async execute(\n      _toolCallId: string,\n      params: Static<typeof ReadFileSchema>,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      return executeReadFile(workspace, options?.bootstrapDir, params);\n    },\n  };\n}\n\nasync function executeReadFile(\n  workspace: string,\n  bootstrapDir: string | undefined,\n  params: Static<typeof ReadFileSchema>,\n): Promise<AgentToolResult<{}>> {\n  try {\n    const safety = checkFileSafety('read', params.path);\n    if (!safety.allowed) {\n      return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n    }\n\n    let normalized = resolvePathUnderWorkspace(params.path, workspace);\n    let stats;\n    try {\n      stats = await stat(normalized);\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException)?.code;\n      if (\n        code === 'ENOENT' &&\n        bootstrapDir &&\n        isBareBootstrapFileName(params.path)\n      ) {\n        const alt = resolveBootstrapPathIfBareName(params.path, bootstrapDir);\n        try {\n          stats = await stat(alt);\n          normalized = alt;\n        } catch {\n          throw e;\n        }\n      } else {\n        throw e;\n      }\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      return { content: [{ type: 'text', text: `🚫 File too large: ${formatSize(stats.size)}` }], details: {} };\n    }\n\n    const content = await readFile(normalized, 'utf-8');\n    const truncation = truncateHead(content, { maxLines: params.limit || DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n\n    let outputText = truncation.content;\n    if (truncation.truncated) {\n      if (truncation.firstLineExceedsLimit) {\n        outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;\n      } else {\n        outputText += `\\n\\n[${truncation.outputLines}/${truncation.totalLines} lines]`;\n      }\n    }\n\n    return { content: [{ type: 'text', text: outputText }], details: {} };\n  } catch (error) {\n    return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };\n  }\n}\n\n/** @deprecated Use {@link createReadFileTool}(process.cwd()) — default cwd; prefer factory with workspace. */\nexport const readFileTool: AgentTool<typeof ReadFileSchema, {}> = createReadFileTool(process.cwd());\n"],"mappings":";;;;;;AAYA,MAAM,gBAAgB,KAAK,OAAO;AAClC,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,KAAK,OAAO;CACjC,MAAM,KAAK,OAAO,EAAE,aAAa,qBAAqB,CAAC;CACvD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,4BAA4B,CAAC,CAAC;CAC/E,CAAC;AAOF,SAAgB,mBACd,WACA,SACsC;AACtC,QAAO;EACL,MAAM;EACN,aACE;EACF,YAAY;EACZ,OAAO;EAEP,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,UAAO,gBAAgB,WAAW,SAAS,cAAc,OAAO;;EAEnE;;AAGH,eAAe,gBACb,WACA,cACA,QAC8B;AAC9B,KAAI;EACF,MAAM,SAAS,gBAAgB,QAAQ,OAAO,KAAK;AACnD,MAAI,CAAC,OAAO,QACV,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,OAAO;IAAW,CAAC;GAAE,SAAS,EAAE;GAAE;EAGnF,IAAI,aAAa,0BAA0B,OAAO,MAAM,UAAU;EAClE,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,KAAK,WAAW;WACvB,GAAG;AAEV,OADc,GAA6B,SAEhC,YACT,gBACA,wBAAwB,OAAO,KAAK,EACpC;IACA,MAAM,MAAM,+BAA+B,OAAO,MAAM,aAAa;AACrE,QAAI;AACF,aAAQ,MAAM,KAAK,IAAI;AACvB,kBAAa;YACP;AACN,WAAM;;SAGR,OAAM;;AAIV,MAAI,MAAM,OAAO,cACf,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,sBAAsB,WAAW,MAAM,KAAK;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE;EAI3G,MAAM,aAAa,aADH,MAAM,SAAS,YAAY,QAAQ,EACV;GAAE,UAAU,OAAO,SAAS;GAAmB,UAAU;GAAmB,CAAC;EAEtH,IAAI,aAAa,WAAW;AAC5B,MAAI,WAAW,UACb,KAAI,WAAW,sBACb,cAAa,iBAAiB,WAAW,kBAAkB,CAAC;MAE5D,eAAc,QAAQ,WAAW,YAAY,GAAG,WAAW,WAAW;AAI1E,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAY,CAAC;GAAE,SAAS,EAAE;GAAE;UAC9D,OAAO;AACd,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE;;;;AAKjI,MAAa,eAAqD,mBAAmB,QAAQ,KAAK,CAAC"}
+{"version":3,"file":"read.js","names":[],"sources":["../../../../src/agent/tools/read.ts"],"sourcesContent":["// Read file tool\nimport { Type, type Static } from '@sinclair/typebox';\nimport type { AgentTool, AgentToolResult } from '@mariozechner/pi-agent-core';\nimport { readFile, stat } from 'fs/promises';\nimport { checkFileSafety } from '../prompt/safety.js';\nimport { truncateHead, formatSize, DEFAULT_MAX_BYTES } from './truncate.js';\nimport {\n  isBareBootstrapFileName,\n  resolveBootstrapPathIfBareName,\n  resolvePathUnderWorkspace,\n} from './tool-paths.js';\n\nconst MAX_FILE_SIZE = 10 * 1024 * 1024;\nconst DEFAULT_MAX_LINES = 500;\n\nconst ReadFileSchema = Type.Object({\n  path: Type.String({ description: 'File path to read' }),\n  limit: Type.Optional(Type.Number({ description: 'Max lines (default: 500)' })),\n});\n\nexport interface CreateReadFileToolOptions {\n  /** When set and the path is a bare bootstrap name (e.g. SOUL.md), try this dir if not in workspace. */\n  bootstrapDir?: string;\n}\n\nexport function createReadFileTool(\n  workspace: string,\n  options?: CreateReadFileToolOptions,\n): AgentTool<typeof ReadFileSchema, {}> {\n  return {\n    name: 'read_file',\n    description:\n      'Read file contents. Relative paths are from the current agent workspace; persona files (SOUL.md, etc.) may live in agent bootstrap and are found automatically when given by filename.',\n    parameters: ReadFileSchema,\n    label: '📄 Read',\n\n    async execute(\n      _toolCallId: string,\n      params: Static<typeof ReadFileSchema>,\n      _signal?: AbortSignal,\n    ): Promise<AgentToolResult<{}>> {\n      return executeReadFile(workspace, options?.bootstrapDir, params);\n    },\n  };\n}\n\nasync function executeReadFile(\n  workspace: string,\n  bootstrapDir: string | undefined,\n  params: Static<typeof ReadFileSchema>,\n): Promise<AgentToolResult<{}>> {\n  try {\n    const safety = checkFileSafety('read', params.path);\n    if (!safety.allowed) {\n      return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };\n    }\n\n    let normalized = resolvePathUnderWorkspace(params.path, workspace);\n    let stats;\n    try {\n      stats = await stat(normalized);\n    } catch (e) {\n      const code = (e as NodeJS.ErrnoException)?.code;\n      if (\n        code === 'ENOENT' &&\n        bootstrapDir &&\n        isBareBootstrapFileName(params.path)\n      ) {\n        const alt = resolveBootstrapPathIfBareName(params.path, bootstrapDir);\n        try {\n          stats = await stat(alt);\n          normalized = alt;\n        } catch {\n          throw e;\n        }\n      } else {\n        throw e;\n      }\n    }\n\n    if (stats.size > MAX_FILE_SIZE) {\n      return { content: [{ type: 'text', text: `🚫 File too large: ${formatSize(stats.size)}` }], details: {} };\n    }\n\n    const content = await readFile(normalized, 'utf-8');\n    const truncation = truncateHead(content, { maxLines: params.limit || DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });\n\n    let outputText = truncation.content;\n    if (truncation.truncated) {\n      if (truncation.firstLineExceedsLimit) {\n        outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;\n      } else {\n        outputText += `\\n\\n[${truncation.outputLines}/${truncation.totalLines} lines]`;\n      }\n    }\n\n    return { content: [{ type: 'text', text: outputText }], details: {} };\n  } catch (error) {\n    return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };\n  }\n}\n"],"mappings":";;;;;;AAYA,MAAM,gBAAgB,KAAK,OAAO;AAClC,MAAM,oBAAoB;AAE1B,MAAM,iBAAiB,KAAK,OAAO;CACjC,MAAM,KAAK,OAAO,EAAE,aAAa,qBAAqB,CAAC;CACvD,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,aAAa,4BAA4B,CAAC,CAAC;CAC/E,CAAC;AAOF,SAAgB,mBACd,WACA,SACsC;AACtC,QAAO;EACL,MAAM;EACN,aACE;EACF,YAAY;EACZ,OAAO;EAEP,MAAM,QACJ,aACA,QACA,SAC8B;AAC9B,UAAO,gBAAgB,WAAW,SAAS,cAAc,OAAO;;EAEnE;;AAGH,eAAe,gBACb,WACA,cACA,QAC8B;AAC9B,KAAI;EACF,MAAM,SAAS,gBAAgB,QAAQ,OAAO,KAAK;AACnD,MAAI,CAAC,OAAO,QACV,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,MAAM,OAAO;IAAW,CAAC;GAAE,SAAS,EAAE;GAAE;EAGnF,IAAI,aAAa,0BAA0B,OAAO,MAAM,UAAU;EAClE,IAAI;AACJ,MAAI;AACF,WAAQ,MAAM,KAAK,WAAW;WACvB,GAAG;AAEV,OADc,GAA6B,SAEhC,YACT,gBACA,wBAAwB,OAAO,KAAK,EACpC;IACA,MAAM,MAAM,+BAA+B,OAAO,MAAM,aAAa;AACrE,QAAI;AACF,aAAQ,MAAM,KAAK,IAAI;AACvB,kBAAa;YACP;AACN,WAAM;;SAGR,OAAM;;AAIV,MAAI,MAAM,OAAO,cACf,QAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,sBAAsB,WAAW,MAAM,KAAK;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE;EAI3G,MAAM,aAAa,aADH,MAAM,SAAS,YAAY,QAAQ,EACV;GAAE,UAAU,OAAO,SAAS;GAAmB,UAAU;GAAmB,CAAC;EAEtH,IAAI,aAAa,WAAW;AAC5B,MAAI,WAAW,UACb,KAAI,WAAW,sBACb,cAAa,iBAAiB,WAAW,kBAAkB,CAAC;MAE5D,eAAc,QAAQ,WAAW,YAAY,GAAG,WAAW,WAAW;AAI1E,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM;IAAY,CAAC;GAAE,SAAS,EAAE;GAAE;UAC9D,OAAO;AACd,SAAO;GAAE,SAAS,CAAC;IAAE,MAAM;IAAQ,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAAI,CAAC;GAAE,SAAS,EAAE;GAAE"}

package/dist/src/agent/tools/send-media.js

@@ -1,7 +1,7 @@
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
-import { readFile } from "fs/promises";
 import { basename } from "node:path";
+import { readFile } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
 const SendMediaSchema = Type.Object({

package/dist/src/auth/sync-provider-auth.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveOAuthPath } from "../config/paths.js";
 import { init_loader, loadConfig } from "../config/loader.js";
-import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/auth/sync-provider-auth.ts
 /**

package/dist/src/channels/plugin-types.d.ts

@@ -69,6 +69,18 @@ export interface ChannelPluginReloadMeta {
     /** Config path prefixes that hot-reload this plugin (for docs and tooling). */
     configPrefixes: string[];
 }
+export interface ChannelDoctorCheckResult {
+    id: string;
+    label: string;
+    status: 'pass' | 'warn' | 'fail' | 'skip';
+    message: string;
+    hints: string[];
+}
+export interface ChannelDoctorAdapter {
+    check(params: {
+        cfg: Config;
+    }): Promise<ChannelDoctorCheckResult[]>;
+}
 export interface ChannelPlugin<ResolvedAccount = any> {
     id: ChannelId;
     meta: ChannelMeta;
@@ -117,6 +129,8 @@ export interface ChannelPlugin<ResolvedAccount = any> {
     heartbeat?: ChannelHeartbeatAdapter;
     agentPrompt?: ChannelAgentPromptAdapter;
     agentTools?: ChannelAgentTool[];
+    /** Optional doctor health-check contributed by this channel plugin. */
+    doctor?: ChannelDoctorAdapter;
 }
 export interface ChannelConfigAdapter<ResolvedAccount> {
     /** List all account IDs */

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

@@ -1,6 +1,6 @@
+import { getWorkspacePath } from "../../config/schema.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { getWorkspacePath } from "../../config/schema.js";
 import { loadConfig } from "../../config/loader.js";
 import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";

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

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkChannelConfig(ctx: DoctorContext): Promise<CheckResult>;

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

@@ -0,0 +1,113 @@
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { existsSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/channel-config.ts
+init_loader();
+function checkTelegram(cfg) {
+	const tg = cfg.channels?.telegram;
+	if (!tg) return {
+		ok: true,
+		messages: [],
+		hints: []
+	};
+	const legacyToken = tg.botToken?.trim() ?? "";
+	const defaultAcc = tg.accounts?.default;
+	const token = (defaultAcc?.botToken?.trim() || legacyToken) ?? "";
+	if (!(tg.enabled === true || token.length > 0)) return {
+		ok: true,
+		messages: [],
+		hints: []
+	};
+	const messages = [];
+	const hints = [];
+	if (!token) {
+		messages.push("Telegram is enabled but no bot token is set.");
+		hints.push("Set channels.telegram.accounts.default.botToken or legacy channels.telegram.botToken.");
+	}
+	const dm = (defaultAcc?.dmPolicy ?? tg.dmPolicy) || "pairing";
+	if (![
+		"pairing",
+		"allowlist",
+		"open",
+		"disabled"
+	].includes(dm)) messages.push(`Telegram dmPolicy "${dm}" is not valid.`);
+	if (dm === "open") {
+		messages.push("Telegram DM policy is \"open\" (any user can message the bot).");
+		hints.push("Consider \"pairing\" or \"allowlist\" for stricter access.");
+	}
+	return {
+		ok: messages.length === 0,
+		messages,
+		hints
+	};
+}
+function checkWeixin(cfg) {
+	const wx = cfg.channels?.weixin;
+	if (!wx || wx.enabled !== true) return {
+		ok: true,
+		messages: [],
+		hints: []
+	};
+	const messages = [];
+	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).");
+	}
+	return {
+		ok: messages.length === 0,
+		messages,
+		hints
+	};
+}
+async function checkChannelConfig(ctx) {
+	if (!existsSync(ctx.configPath)) return {
+		id: "channel-config",
+		label: "Channels",
+		status: "skip",
+		message: "No config file; skipped.",
+		hints: []
+	};
+	let cfg;
+	try {
+		cfg = loadConfig(ctx.configPath);
+	} catch {
+		return {
+			id: "channel-config",
+			label: "Channels",
+			status: "skip",
+			message: "Config could not be loaded; skipped.",
+			hints: []
+		};
+	}
+	const tg = checkTelegram(cfg);
+	const wx = checkWeixin(cfg);
+	const allMsg = [...tg.messages, ...wx.messages];
+	const allHints = [...tg.hints, ...wx.hints];
+	const tgEnabled = (cfg.channels?.telegram)?.enabled === true || Boolean((cfg.channels?.telegram)?.botToken?.trim());
+	const wxOn = (cfg.channels?.weixin)?.enabled === true;
+	if (!tgEnabled && !wxOn) return {
+		id: "channel-config",
+		label: "Channels",
+		status: "skip",
+		message: "No channels enabled; skipped.",
+		hints: []
+	};
+	if (allMsg.length === 0) return {
+		id: "channel-config",
+		label: "Channels",
+		status: "pass",
+		message: "Enabled channel configuration looks valid.",
+		hints: []
+	};
+	return {
+		id: "channel-config",
+		label: "Channels",
+		status: allMsg.some((m) => m.includes("no bot token") || m.includes("no accounts")) ? "fail" : "warn",
+		message: allMsg.join(" "),
+		hints: allHints
+	};
+}
+//#endregion
+export { checkChannelConfig };
+
+//# sourceMappingURL=channel-config.js.map

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

@@ -0,0 +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  botToken?: string;\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 legacyToken = tg.botToken?.trim() ?? '';\n  const defaultAcc = tg.accounts?.default;\n  const token = (defaultAcc?.botToken?.trim() || legacyToken) ?? '';\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 or legacy channels.telegram.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)?.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;AAgB1D,SAAS,cAAc,KAAmE;CACxF,MAAM,KAAK,IAAI,UAAU;AACzB,KAAI,CAAC,GACH,QAAO;EAAE,IAAI;EAAM,UAAU,EAAE;EAAE,OAAO,EAAE;EAAE;CAG9C,MAAM,cAAc,GAAG,UAAU,MAAM,IAAI;CAC3C,MAAM,aAAa,GAAG,UAAU;CAChC,MAAM,SAAS,YAAY,UAAU,MAAM,IAAI,gBAAgB;AAG/D,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,wFAAwF;;CAGrG,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,MAAM,CAAC;CAChF,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,CAAC,GAIvE,SAAS;EAC3B,SAAS,OAAO,KAAK,IAAI;EACzB,OAAO;EACR"}

package/dist/src/cli/commands/doctor/checks/channel-plugins.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkChannelPlugins(ctx: DoctorContext): Promise<CheckResult[]>;

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

@@ -0,0 +1,47 @@
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { bundledChannelPlugins } from "../../../../generated/bundled-channel-plugins.js";
+import { existsSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/channel-plugins.ts
+init_loader();
+function toCheckResults(plugin, raw) {
+	const pid = String(plugin.id);
+	return raw.map((r) => ({
+		id: `channel:${pid}:${r.id}`,
+		label: `${pid}: ${r.label}`,
+		status: r.status,
+		message: r.message,
+		hints: r.hints
+	}));
+}
+async function checkChannelPlugins(ctx) {
+	if (!existsSync(ctx.configPath)) return [];
+	let cfg;
+	try {
+		cfg = loadConfig(ctx.configPath);
+	} catch {
+		return [];
+	}
+	const out = [];
+	for (const plugin of bundledChannelPlugins) {
+		const doctor = plugin.doctor;
+		if (!doctor?.check) continue;
+		try {
+			const res = await doctor.check({ cfg });
+			out.push(...toCheckResults(plugin, res));
+		} catch (e) {
+			const msg = e instanceof Error ? e.message : String(e);
+			out.push({
+				id: `channel:${plugin.id}:error`,
+				label: `${String(plugin.id)}: doctor`,
+				status: "warn",
+				message: `Channel doctor check failed: ${msg}`,
+				hints: []
+			});
+		}
+	}
+	return out;
+}
+//#endregion
+export { checkChannelPlugins };
+
+//# sourceMappingURL=channel-plugins.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"channel-plugins.js","names":[],"sources":["../../../../../../src/cli/commands/doctor/checks/channel-plugins.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\n\nimport type { CheckResult, DoctorContext } from '../types.js';\nimport { loadConfig } from '../../../../config/loader.js';\nimport { bundledChannelPlugins } from '../../../../generated/bundled-channel-plugins.js';\nimport type { ChannelDoctorCheckResult, ChannelPlugin } from '../../../../channels/plugin-types.js';\n\nfunction toCheckResults(plugin: ChannelPlugin, raw: ChannelDoctorCheckResult[]): CheckResult[] {\n  const pid = String(plugin.id);\n  return raw.map((r) => ({\n    id: `channel:${pid}:${r.id}`,\n    label: `${pid}: ${r.label}`,\n    status: r.status,\n    message: r.message,\n    hints: r.hints,\n  }));\n}\n\nexport async function checkChannelPlugins(ctx: DoctorContext): Promise<CheckResult[]> {\n  if (!existsSync(ctx.configPath)) {\n    return [];\n  }\n\n  let cfg;\n  try {\n    cfg = loadConfig(ctx.configPath);\n  } catch {\n    return [];\n  }\n\n  const out: CheckResult[] = [];\n  for (const plugin of bundledChannelPlugins) {\n    const doctor = plugin.doctor;\n    if (!doctor?.check) continue;\n    try {\n      const res = await doctor.check({ cfg });\n      out.push(...toCheckResults(plugin, res));\n    } catch (e) {\n      const msg = e instanceof Error ? e.message : String(e);\n      out.push({\n        id: `channel:${plugin.id}:error`,\n        label: `${String(plugin.id)}: doctor`,\n        status: 'warn',\n        message: `Channel doctor check failed: ${msg}`,\n        hints: [],\n      });\n    }\n  }\n  return out;\n}\n"],"mappings":";;;;aAG0D;AAI1D,SAAS,eAAe,QAAuB,KAAgD;CAC7F,MAAM,MAAM,OAAO,OAAO,GAAG;AAC7B,QAAO,IAAI,KAAK,OAAO;EACrB,IAAI,WAAW,IAAI,GAAG,EAAE;EACxB,OAAO,GAAG,IAAI,IAAI,EAAE;EACpB,QAAQ,EAAE;EACV,SAAS,EAAE;EACX,OAAO,EAAE;EACV,EAAE;;AAGL,eAAsB,oBAAoB,KAA4C;AACpF,KAAI,CAAC,WAAW,IAAI,WAAW,CAC7B,QAAO,EAAE;CAGX,IAAI;AACJ,KAAI;AACF,QAAM,WAAW,IAAI,WAAW;SAC1B;AACN,SAAO,EAAE;;CAGX,MAAM,MAAqB,EAAE;AAC7B,MAAK,MAAM,UAAU,uBAAuB;EAC1C,MAAM,SAAS,OAAO;AACtB,MAAI,CAAC,QAAQ,MAAO;AACpB,MAAI;GACF,MAAM,MAAM,MAAM,OAAO,MAAM,EAAE,KAAK,CAAC;AACvC,OAAI,KAAK,GAAG,eAAe,QAAQ,IAAI,CAAC;WACjC,GAAG;GACV,MAAM,MAAM,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;AACtD,OAAI,KAAK;IACP,IAAI,WAAW,OAAO,GAAG;IACzB,OAAO,GAAG,OAAO,OAAO,GAAG,CAAC;IAC5B,QAAQ;IACR,SAAS,gCAAgC;IACzC,OAAO,EAAE;IACV,CAAC;;;AAGN,QAAO"}

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

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkConfigHealth(ctx: DoctorContext): Promise<CheckResult>;

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

@@ -0,0 +1,82 @@
+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";
+//#region src/cli/commands/doctor/checks/config-health.ts
+init_loader();
+init_schema();
+async function checkConfigHealth(ctx) {
+	const path = ctx.configPath;
+	if (!existsSync(path)) {
+		if (ctx.options.fix) try {
+			mkdirSync(dirname(path), { recursive: true });
+			await saveConfig(loadConfig(path), path);
+			return {
+				id: "config-health",
+				label: "Config",
+				status: "pass",
+				message: "Created default config file.",
+				hints: [path],
+				fixed: true
+			};
+		} catch (e) {
+			return {
+				id: "config-health",
+				label: "Config",
+				status: "fail",
+				message: `Config file missing and could not create default: ${e instanceof Error ? e.message : String(e)}`,
+				hints: [path]
+			};
+		}
+		return {
+			id: "config-health",
+			label: "Config",
+			status: "fail",
+			message: "Config file not found.",
+			hints: [`Run: xopc init`, `Or: xopc doctor --fix`]
+		};
+	}
+	let raw;
+	try {
+		raw = readFileSync(path, "utf-8");
+	} catch (e) {
+		return {
+			id: "config-health",
+			label: "Config",
+			status: "fail",
+			message: `Cannot read config file: ${e instanceof Error ? e.message : String(e)}`,
+			hints: [path]
+		};
+	}
+	let json;
+	try {
+		json = JSON.parse(raw);
+	} catch {
+		return {
+			id: "config-health",
+			label: "Config",
+			status: "fail",
+			message: "Config file is not valid JSON.",
+			hints: ["Fix syntax or restore from backup (.bak).", path]
+		};
+	}
+	const parsed = ConfigSchema.safeParse(json);
+	if (!parsed.success) return {
+		id: "config-health",
+		label: "Config",
+		status: "fail",
+		message: "Config does not match the expected schema.",
+		hints: parsed.error.issues.slice(0, 5).map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`)
+	};
+	return {
+		id: "config-health",
+		label: "Config",
+		status: "pass",
+		message: "Config file exists and validates.",
+		hints: [path]
+	};
+}
+//#endregion
+export { checkConfigHealth };
+
+//# sourceMappingURL=config-health.js.map

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

@@ -0,0 +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,KAAK,EACV,EAAE,WAAW,MAAM,CAAC;AAEnC,SAAM,WADW,WAAW,KAAK,EACN,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"}

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

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkCronHealth(ctx: DoctorContext): Promise<CheckResult>;

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

@@ -0,0 +1,116 @@
+import { init_paths, resolveCronDir, resolveCronJobsPath } from "../../../../config/paths.js";
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { JobDataSchema } from "../../../../cron/validation.js";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/cron-health.ts
+init_loader();
+init_paths();
+async function checkCronHealth(ctx) {
+	if (!existsSync(ctx.configPath)) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "skip",
+		message: "No config file; skipped.",
+		hints: []
+	};
+	let cfg;
+	try {
+		cfg = loadConfig(ctx.configPath);
+	} catch {
+		return {
+			id: "cron-health",
+			label: "Cron",
+			status: "skip",
+			message: "Config could not be loaded; skipped.",
+			hints: []
+		};
+	}
+	if (cfg.cron?.enabled === false) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "skip",
+		message: "Cron is disabled in config; skipped.",
+		hints: []
+	};
+	const cronDir = resolveCronDir();
+	if (!existsSync(cronDir)) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "warn",
+		message: "Cron directory does not exist.",
+		hints: [cronDir, "Run: xopc init"]
+	};
+	const jobsPath = resolveCronJobsPath();
+	if (!existsSync(jobsPath)) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "warn",
+		message: "Cron jobs file is missing.",
+		hints: [jobsPath]
+	};
+	let raw;
+	try {
+		raw = JSON.parse(readFileSync(jobsPath, "utf-8"));
+	} catch {
+		return {
+			id: "cron-health",
+			label: "Cron",
+			status: "warn",
+			message: "Cron jobs file is not valid JSON.",
+			hints: [jobsPath]
+		};
+	}
+	if (!raw || typeof raw !== "object" || !("jobs" in raw) || !Array.isArray(raw.jobs)) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "warn",
+		message: "Cron jobs file has invalid structure (expected { jobs: [] }).",
+		hints: [jobsPath]
+	};
+	const jobs = raw.jobs;
+	const hints = [];
+	let valid = 0;
+	let enabled = 0;
+	let scheduleMissing = 0;
+	for (const j of jobs) {
+		const r = JobDataSchema.safeParse(j);
+		if (r.success) {
+			valid++;
+			if (r.data.enabled) {
+				enabled++;
+				if (!r.data.schedule?.trim()) {
+					scheduleMissing++;
+					hints.push(`Job "${r.data.name || r.data.id}" is enabled but has no schedule.`);
+				}
+			}
+		} else {
+			hints.push("One or more job entries failed validation (check jobs.json).");
+			break;
+		}
+	}
+	if (valid !== jobs.length) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "warn",
+		message: "Some cron jobs are invalid or could not be validated.",
+		hints: hints.length ? hints.slice(0, 5) : [jobsPath]
+	};
+	if (scheduleMissing > 0) return {
+		id: "cron-health",
+		label: "Cron",
+		status: "warn",
+		message: `${scheduleMissing} enabled job(s) are missing a schedule.`,
+		hints: hints.slice(0, 5)
+	};
+	return {
+		id: "cron-health",
+		label: "Cron",
+		status: "pass",
+		message: `Cron jobs file is valid (${enabled} enabled, ${jobs.length} total).`,
+		hints: [jobsPath]
+	};
+}
+//#endregion
+export { checkCronHealth };
+
+//# sourceMappingURL=cron-health.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkGatewayHealth(ctx: DoctorContext): Promise<CheckResult>;

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

@@ -0,0 +1,64 @@
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { existsSync } from "node:fs";
+//#region src/cli/commands/doctor/checks/gateway-health.ts
+init_loader();
+function resolveGatewayBaseUrl(cfg) {
+	return `http://${cfg.gateway?.host?.trim() || "127.0.0.1"}:${cfg.gateway?.port ?? 18790}`;
+}
+const FETCH_TIMEOUT_MS = 5e3;
+async function checkGatewayHealth(ctx) {
+	if (!existsSync(ctx.configPath)) return {
+		id: "gateway-health",
+		label: "Gateway HTTP",
+		status: "skip",
+		message: "No config file; skipped.",
+		hints: []
+	};
+	let cfg;
+	try {
+		cfg = loadConfig(ctx.configPath);
+	} catch {
+		return {
+			id: "gateway-health",
+			label: "Gateway HTTP",
+			status: "skip",
+			message: "Config could not be loaded; skipped.",
+			hints: []
+		};
+	}
+	const base = resolveGatewayBaseUrl(cfg);
+	const url = `${base.replace(/\/$/, "")}/health`;
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+	try {
+		const res = await fetch(url, { signal: controller.signal });
+		clearTimeout(timer);
+		if (res.ok) return {
+			id: "gateway-health",
+			label: "Gateway HTTP",
+			status: "pass",
+			message: `Gateway responded OK at ${url}.`,
+			hints: []
+		};
+		return {
+			id: "gateway-health",
+			label: "Gateway HTTP",
+			status: "warn",
+			message: `Gateway returned HTTP ${res.status} at ${url}.`,
+			hints: ["Start the gateway: xopc gateway start"]
+		};
+	} catch (e) {
+		clearTimeout(timer);
+		return {
+			id: "gateway-health",
+			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}`]
+		};
+	}
+}
+//#endregion
+export { checkGatewayHealth };
+
+//# sourceMappingURL=gateway-health.js.map

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

@@ -0,0 +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 type { Config } from '../../../../config/schema.js';\nimport type { CheckResult, DoctorContext } from '../types.js';\n\nfunction resolveGatewayBaseUrl(cfg: Config): string {\n  const host = cfg.gateway?.host?.trim() || '127.0.0.1';\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;AAI1D,SAAS,sBAAsB,KAAqB;AAGlD,QAAO,UAFM,IAAI,SAAS,MAAM,MAAM,IAAI,YAEpB,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"}

package/dist/src/cli/commands/doctor/checks/gateway-service.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkGatewayService(ctx: DoctorContext): Promise<CheckResult>;