dme-agent 7.4.1 → 7.4.2

package/src/detect.mjs

@@ -0,0 +1,260 @@
+/**
+ * Detect which AI CLIs / agent surfaces are actually installed on this machine.
+ * Does NOT treat "DME already dropped files here" as proof the CLI exists.
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { getTargets } from "./targets.mjs";
+
+const home = os.homedir();
+const isWin = process.platform === "win32";
+
+function exists(p) {
+  try {
+    return Boolean(p && fs.existsSync(p));
+  } catch {
+    return false;
+  }
+}
+
+function hasCmd(bin) {
+  if (!bin) return false;
+  try {
+    if (isWin) {
+      execSync(`where ${bin}`, { stdio: "ignore", windowsHide: true });
+    } else {
+      execSync(`command -v ${bin}`, {
+        stdio: "ignore",
+        shell: "/bin/sh",
+      });
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function anyCmd(bins = []) {
+  return bins.some((b) => hasCmd(b));
+}
+
+function anyPath(paths = []) {
+  return paths.some((p) => exists(p));
+}
+
+function winLocalAppData(...parts) {
+  const base = process.env.LOCALAPPDATA || path.join(home, "AppData", "Local");
+  return path.join(base, ...parts);
+}
+
+function winAppData(...parts) {
+  const base = process.env.APPDATA || path.join(home, "AppData", "Roaming");
+  return path.join(base, ...parts);
+}
+
+function macApp(...names) {
+  return names.map((n) => path.join("/Applications", n));
+}
+
+/** Files/dirs that prove the CLI itself (not DME) touched this root */
+const ROOT_FINGERPRINTS = {
+  claude: [
+    "settings.json",
+    "history.jsonl",
+    "projects",
+    "sessions",
+    "session-env",
+    "plugins",
+    "statsig",
+    "todos",
+  ],
+  cursor: [
+    "argv.json",
+    "extensions",
+    "ide_state.json",
+    "projects",
+    "cli-config.json",
+    "prompts",
+  ],
+  codex: ["config.toml", "config.json", "sessions", "auth.json", "history.jsonl"],
+  zed: ["settings.json", "keymap.json", "themes", "conversations"],
+  grok: [
+    "config.toml",
+    "auth.json",
+    "sessions",
+    "bin",
+    "version.json",
+    "models_cache.json",
+    "active_sessions.json",
+  ],
+  windsurf: ["config.json", "memories", "cascade", "user_settings.local.json"],
+  continue: ["config.json", "index", "sessions", "types"],
+  aider: [".aider.chat.history.md", ".aider.input.history"],
+  copilot: ["config.json", "hosts.json"],
+  antigravity: ["settings.json", "oauth_creds.json", "tmp", "history"],
+  generic: [],
+};
+
+function rootHasFingerprint(root, kind) {
+  if (!exists(root)) return false;
+  const keys = ROOT_FINGERPRINTS[kind] || [];
+  for (const k of keys) {
+    if (exists(path.join(root, k))) return true;
+  }
+  // generic: any non-DME child
+  try {
+    const entries = fs.readdirSync(root);
+    const nonDme = entries.filter(
+      (e) =>
+        !e.startsWith("DME") &&
+        e !== "skills" &&
+        e !== "agents" &&
+        e !== "AGENTS.md" &&
+        e !== "Agents.md" &&
+        e !== "CLAUDE.md" &&
+        e !== "CLAUDE_DME.md"
+    );
+    // only count as fingerprint if kind has no list and nonDme has substance
+    if (keys.length === 0 && nonDme.length > 0) return true;
+  } catch {
+    /* ignore */
+  }
+  return false;
+}
+
+/**
+ * Detection probes per target id.
+ */
+const PROBES = {
+  claude: () =>
+    anyCmd(["claude"]) ||
+    anyPath([
+      ...macApp("Claude.app"),
+      winLocalAppData("AnthropicClaude"),
+      winLocalAppData("claude-cli"),
+    ]) ||
+    rootHasFingerprint(path.join(home, ".claude"), "claude"),
+
+  cursor: () =>
+    anyCmd(["cursor", "cursor-agent"]) ||
+    anyPath([
+      ...macApp("Cursor.app"),
+      winLocalAppData("Programs", "cursor"),
+      winLocalAppData("Cursor"),
+      winAppData("Cursor"),
+    ]) ||
+    rootHasFingerprint(path.join(home, ".cursor"), "cursor"),
+
+  codex: () =>
+    anyCmd(["codex"]) ||
+    rootHasFingerprint(path.join(home, ".codex"), "codex"),
+
+  zed: () =>
+    anyCmd(["zed", "zeditor"]) ||
+    anyPath([
+      ...macApp("Zed.app"),
+      winLocalAppData("Programs", "Zed"),
+      winLocalAppData("Zed"),
+    ]) ||
+    rootHasFingerprint(path.join(home, ".config", "zed"), "zed"),
+
+  grok: () =>
+    anyCmd(["grok", "grok-cli"]) ||
+    anyPath([winLocalAppData("grok")]) ||
+    rootHasFingerprint(path.join(home, ".grok"), "grok"),
+
+  windsurf: () =>
+    anyCmd(["windsurf"]) ||
+    anyPath([
+      ...macApp("Windsurf.app"),
+      winLocalAppData("Programs", "Windsurf"),
+      winAppData("Windsurf"),
+    ]) ||
+    rootHasFingerprint(path.join(home, ".codeium", "windsurf"), "windsurf"),
+
+  continue: () =>
+    anyPath([winAppData("Continue")]) ||
+    rootHasFingerprint(path.join(home, ".continue"), "continue"),
+
+  aider: () =>
+    anyCmd(["aider"]) ||
+    anyPath([path.join(home, ".aider.conf.yml")]) ||
+    rootHasFingerprint(path.join(home, ".aider"), "aider"),
+
+  copilot: () =>
+    anyPath([
+      path.join(home, ".copilot"),
+      path.join(home, ".config", "github-copilot"),
+      winAppData("GitHub Copilot"),
+    ]),
+
+  antigravity: () =>
+    anyCmd(["gemini", "antigravity"]) ||
+    rootHasFingerprint(path.join(home, ".gemini"), "antigravity"),
+
+  // never auto — user must --targets global-agents
+  "global-agents": () => false,
+};
+
+/**
+ * @returns {{ target: object, detected: boolean, reasons: string[] }[]}
+ */
+export function scanAll() {
+  return getTargets().map((target) => {
+    const probe = PROBES[target.id];
+    const reasons = [];
+    let detected = false;
+
+    if (probe) {
+      try {
+        detected = Boolean(probe());
+        if (detected) reasons.push("probe:hit");
+      } catch {
+        detected = false;
+      }
+    }
+
+    return { target, detected, reasons };
+  });
+}
+
+export function getDetectedTargets() {
+  return scanAll()
+    .filter((s) => s.detected)
+    .map((s) => s.target);
+}
+
+export function getDetectedIds() {
+  return getDetectedTargets().map((t) => t.id);
+}
+
+/**
+ * Resolve which targets to install.
+ * - default / "detected": only detected
+ * - "all": everything
+ * - explicit list: those ids
+ */
+export function resolveInstallTargets(ids, { force = false } = {}) {
+  const all = getTargets();
+  if (!ids || ids.length === 0 || ids.includes("detected")) {
+    return getDetectedTargets();
+  }
+  if (ids.includes("all")) {
+    return all;
+  }
+  const set = new Set(ids.map((x) => x.toLowerCase()));
+  return all.filter((t) => set.has(t.id));
+}
+
+export function formatScanReport() {
+  return scanAll().map(({ target, detected, reasons }) => ({
+    id: target.id,
+    name: target.name,
+    detected,
+    agentsMd: target.agentsMd || null,
+    reasons,
+  }));
+}