agent-detective 1.0.0

package/dist/doctor-3ZMDZLW6.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+import {
+  importPluginModuleFromSpecifier,
+  validatePluginConfig,
+  validatePluginSchema
+} from "./chunk-OIYJYLCB.js";
+import {
+  isAgentInstalled,
+  loadConfig,
+  normalizeAgent
+} from "./chunk-H2IXGHNA.js";
+
+// src/cli/doctor.ts
+import { resolve } from "path";
+import { existsSync } from "fs";
+function resolveConfigDirFromInstallRoot(installRoot) {
+  if (!installRoot) return void 0;
+  if (installRoot.split(/[\\/]/).pop() === "config") return installRoot;
+  return resolve(installRoot, "config");
+}
+function parseFlags(argv) {
+  const args = argv.slice(2);
+  return {
+    json: args.includes("--json"),
+    verbose: args.includes("--verbose")
+  };
+}
+function hasExplicitConfigRootArg(argv) {
+  const args = argv.slice(2);
+  return args.some((a) => a === "--config-root" || a.startsWith("--config-root="));
+}
+function hasExplicitConfigRootEnv() {
+  return typeof process.env.AGENT_DETECTIVE_CONFIG_ROOT === "string" && process.env.AGENT_DETECTIVE_CONFIG_ROOT.length > 0;
+}
+function coercePlugin(mod) {
+  const m = mod;
+  return (m && typeof m === "object" && "default" in m ? m.default : m) ?? mod;
+}
+function applyPluginDefaults(plugin, options) {
+  const merged = { ...options };
+  if (plugin.schema?.properties) {
+    for (const [key, prop] of Object.entries(plugin.schema.properties)) {
+      if (merged[key] === void 0 && prop.default !== void 0) {
+        merged[key] = prop.default;
+      }
+    }
+  }
+  return merged;
+}
+async function runDoctor({ installRoot, argv }) {
+  const { json, verbose } = parseFlags(argv);
+  const checks = [];
+  const configRoot = resolveConfigDirFromInstallRoot(installRoot);
+  const configRootUsed = configRoot ?? resolve(process.cwd(), "config");
+  const resolutionRoot = installRoot ?? process.cwd();
+  const explicitConfigRoot = hasExplicitConfigRootArg(argv) || hasExplicitConfigRootEnv();
+  const configDirExists = existsSync(configRootUsed);
+  const defaultJsonExists = existsSync(resolve(configRootUsed, "default.json"));
+  const localJsonExists = existsSync(resolve(configRootUsed, "local.json"));
+  if (explicitConfigRoot) {
+    const ok2 = configDirExists && (defaultJsonExists || localJsonExists);
+    checks.push({
+      id: "config.files",
+      ok: ok2,
+      message: ok2 ? "Config directory and files present" : `Config directory/files missing under ${configRootUsed} (expected default.json and/or local.json)`,
+      details: verbose ? {
+        configRootUsed,
+        configDirExists,
+        defaultJsonExists,
+        localJsonExists
+      } : { configRootUsed }
+    });
+  }
+  let config = null;
+  try {
+    config = loadConfig({ configRoot });
+    checks.push({
+      id: "config.load",
+      ok: true,
+      message: "Config loaded and validated",
+      details: { configRootUsed }
+    });
+  } catch (err) {
+    checks.push({
+      id: "config.load",
+      ok: false,
+      message: `Config failed to load/validate: ${err.message}`,
+      details: { configRootAttempted: configRoot, configRootUsed }
+    });
+  }
+  if (config) {
+    const agentId = normalizeAgent(config.agent);
+    const installed = isAgentInstalled(agentId);
+    checks.push({
+      id: "agent.installed",
+      ok: installed,
+      message: installed ? `Agent '${agentId}' is installed` : `Agent '${agentId}' is not installed or not on PATH`
+    });
+    const pluginEntries = config.plugins ?? [];
+    for (let idx = 0; idx < pluginEntries.length; idx++) {
+      const entry = pluginEntries[idx];
+      const spec = typeof entry === "string" ? entry : entry.package;
+      if (!spec) continue;
+      try {
+        const mod = await importPluginModuleFromSpecifier(spec, resolutionRoot);
+        const plugin = coercePlugin(mod);
+        validatePluginSchema(plugin);
+        const options = typeof entry === "object" && entry.options ? entry.options : {};
+        const mergedOptions = applyPluginDefaults(plugin, options);
+        validatePluginConfig(plugin, mergedOptions);
+        checks.push({
+          id: `plugin.${idx}`,
+          ok: true,
+          message: `Plugin OK: ${plugin.name}@${plugin.version}`,
+          details: verbose ? {
+            spec,
+            resolutionRoot
+          } : void 0
+        });
+      } catch (err) {
+        checks.push({
+          id: `plugin.${idx}`,
+          ok: false,
+          message: `Plugin failed (${spec}): ${err.message}`,
+          details: verbose ? {
+            spec,
+            resolutionRoot
+          } : void 0
+        });
+      }
+    }
+  }
+  const ok = checks.every((c) => c.ok);
+  if (json) {
+    console.log(JSON.stringify({ ok, configRootUsed, resolutionRoot, checks }, null, 2));
+  } else {
+    console.log(`agent-detective doctor: ${ok ? "OK" : "FAILED"}`);
+    console.log(`Using configRoot: ${configRootUsed}`);
+    for (const c of checks) {
+      console.log(`${c.ok ? "PASS" : "FAIL"} ${c.id} - ${c.message}`);
+      if (verbose && c.details) {
+        console.log(`  details: ${JSON.stringify(c.details)}`);
+      }
+    }
+  }
+  process.exitCode = ok ? 0 : 1;
+}
+async function runValidateConfig({ installRoot, argv }) {
+  const { json, verbose } = parseFlags(argv);
+  const configRoot = resolveConfigDirFromInstallRoot(installRoot);
+  const configRootUsed = configRoot ?? resolve(process.cwd(), "config");
+  const explicitConfigRoot = hasExplicitConfigRootArg(argv) || hasExplicitConfigRootEnv();
+  const configDirExists = existsSync(configRootUsed);
+  const defaultJsonExists = existsSync(resolve(configRootUsed, "default.json"));
+  const localJsonExists = existsSync(resolve(configRootUsed, "local.json"));
+  let ok = true;
+  let message = "Config loaded and validated";
+  let details;
+  if (explicitConfigRoot && (!configDirExists || !defaultJsonExists && !localJsonExists)) {
+    ok = false;
+    message = `Config directory/files missing under ${configRootUsed} (expected default.json and/or local.json)`;
+    details = verbose ? {
+      configRootUsed,
+      configDirExists,
+      defaultJsonExists,
+      localJsonExists
+    } : { configRootUsed };
+  }
+  try {
+    if (ok) {
+      loadConfig({ configRoot });
+      details = { ...details ?? {}, configRootUsed };
+    }
+  } catch (err) {
+    ok = false;
+    message = `Config failed to load/validate: ${err.message}`;
+    details = { configRootAttempted: configRoot, configRootUsed };
+  }
+  if (json) {
+    console.log(JSON.stringify({ ok, check: { id: "config.load", ok, message, details } }, null, 2));
+  } else {
+    console.log(`${ok ? "PASS" : "FAIL"} config.load - ${message}`);
+    console.log(`Using configRoot: ${configRootUsed}`);
+    if (verbose && details) {
+      console.log(`  details: ${JSON.stringify(details)}`);
+    }
+  }
+  process.exitCode = ok ? 0 : 1;
+}
+export {
+  runDoctor,
+  runValidateConfig
+};