dme-agent 7.4.1 → 7.4.2

package/src/postinstall-hint.mjs

@@ -8,8 +8,9 @@ try {
   const r = process.stdout.isTTY ? "\x1b[0m" : "";
   console.log("");
   console.log(`${y}  DME Agent installed.${r}`);
-  console.log(`${d}  Run:  npx dme-agent install${r}`);
-  console.log(`${d}  Or:   dme install${r}`);
+  console.log(`${d}  Run:  npx dme-agent${r}`);
+  console.log(`${d}        dme install   (detect-only)${r}`);
+  console.log(`${d}        dme scan${r}`);
   console.log("");
 } catch {
   /* ignore */

package/src/targets.mjs

@@ -1,5 +1,6 @@
 /**
- * Install targets for every major AI coding CLI / editor agent surface.
+ * Install targets for major AI coding CLI / editor agent surfaces.
+ * Each target declares the canonical AGENTS.md path.
  */
 
 import os from "node:os";
@@ -12,11 +13,13 @@ const home = os.homedir();
  * @property {string} id
  * @property {string} name
  * @property {string} root
- * @property {"claude"|"cursor"|"codex"|"zed"|"grok"|"windsurf"|"continue"|"aider"|"copilot"|"antigravity"|"generic"} kind
+ * @property {string} kind
  * @property {string[]} skillDirs
  * @property {string[]} agentFiles
  * @property {string[]} rulesFiles
+ * @property {string|null} agentsMd  Canonical AGENTS.md / CLAUDE.md path for this CLI
  * @property {boolean} [optional]
+ * @property {boolean} [projectLocal]  Install project-level files when this CLI is selected
  */
 
 /** @returns {Target[]} */
@@ -32,6 +35,8 @@ export function getTargets() {
         path.join(home, ".claude", "agents", "dme-v7.4.md"),
         path.join(home, ".claude", "CLAUDE_DME.md"),
       ],
+      // Claude Code: CLAUDE.md + Agents.md are both read in many setups
+      agentsMd: path.join(home, ".claude", "CLAUDE.md"),
       rulesFiles: [
         path.join(home, ".claude", "CLAUDE.md"),
         path.join(home, ".claude", "Agents.md"),
@@ -47,7 +52,9 @@ export function getTargets() {
         path.join(home, ".cursor", "skills-cursor"),
       ],
       agentFiles: [path.join(home, ".cursor", "agents", "dme-v7.4.md")],
+      agentsMd: path.join(home, ".cursor", "AGENTS.md"),
       rulesFiles: [
+        path.join(home, ".cursor", "AGENTS.md"),
         path.join(home, ".cursor", "rules", "dme-agent.mdc"),
         path.join(home, ".cursorrules"),
       ],
@@ -59,6 +66,7 @@ export function getTargets() {
       kind: "codex",
       skillDirs: [path.join(home, ".codex", "skills")],
       agentFiles: [path.join(home, ".codex", "agents", "dme-v7.4.md")],
+      agentsMd: path.join(home, ".codex", "AGENTS.md"),
       rulesFiles: [
         path.join(home, ".codex", "AGENTS.md"),
         path.join(home, ".codex", "instructions", "dme-v7.4.md"),
@@ -70,12 +78,11 @@ export function getTargets() {
       root: path.join(home, ".config", "zed"),
       kind: "zed",
       skillDirs: [path.join(home, ".config", "zed", "skills")],
-      agentFiles: [
-        path.join(home, ".config", "zed", "agents", "dme-v7.4.md"),
-      ],
+      agentFiles: [path.join(home, ".config", "zed", "agents", "dme-v7.4.md")],
+      agentsMd: path.join(home, ".config", "zed", "AGENTS.md"),
       rulesFiles: [
-        path.join(home, ".config", "zed", "rules", "dme.md"),
         path.join(home, ".config", "zed", "AGENTS.md"),
+        path.join(home, ".config", "zed", "rules", "dme.md"),
       ],
     },
     {
@@ -88,6 +95,7 @@ export function getTargets() {
         path.join(home, ".grok", "bundled", "agents", "dme-v7.4.md"),
         path.join(home, ".grok", "agents", "dme-v7.4.md"),
       ],
+      agentsMd: path.join(home, ".grok", "AGENTS.md"),
       rulesFiles: [path.join(home, ".grok", "AGENTS.md")],
     },
     {
@@ -99,7 +107,9 @@ export function getTargets() {
       agentFiles: [
         path.join(home, ".codeium", "windsurf", "agents", "dme-v7.4.md"),
       ],
+      agentsMd: path.join(home, ".codeium", "windsurf", "AGENTS.md"),
       rulesFiles: [
+        path.join(home, ".codeium", "windsurf", "AGENTS.md"),
         path.join(home, ".codeium", "windsurf", "memories", "dme-v7.4.md"),
         path.join(home, ".windsurfrules"),
       ],
@@ -112,7 +122,11 @@ export function getTargets() {
       kind: "continue",
       skillDirs: [path.join(home, ".continue", "skills")],
       agentFiles: [path.join(home, ".continue", "agents", "dme-v7.4.md")],
-      rulesFiles: [path.join(home, ".continue", "rules", "dme.md")],
+      agentsMd: path.join(home, ".continue", "AGENTS.md"),
+      rulesFiles: [
+        path.join(home, ".continue", "AGENTS.md"),
+        path.join(home, ".continue", "rules", "dme.md"),
+      ],
       optional: true,
     },
     {
@@ -122,19 +136,21 @@ export function getTargets() {
       kind: "aider",
       skillDirs: [],
       agentFiles: [],
+      agentsMd: path.join(home, ".aider", "CONVENTIONS.md"),
       rulesFiles: [
+        path.join(home, ".aider", "CONVENTIONS.md"),
         path.join(home, ".aider", "dme-CONVENTIONS.md"),
-        path.join(home, ".aider.conf.dme.yml"),
       ],
       optional: true,
     },
     {
       id: "copilot",
-      name: "GitHub Copilot (chat instructions)",
+      name: "GitHub Copilot",
       root: path.join(home, ".copilot"),
       kind: "copilot",
       skillDirs: [],
       agentFiles: [],
+      agentsMd: path.join(home, ".github", "copilot-instructions.md"),
       rulesFiles: [
         path.join(home, ".github", "copilot-instructions.md"),
         path.join(home, ".copilot", "dme-instructions.md"),
@@ -143,27 +159,29 @@ export function getTargets() {
     },
     {
       id: "antigravity",
-      name: "Google Antigravity / Gemini CLI",
+      name: "Gemini / Antigravity",
       root: path.join(home, ".gemini"),
       kind: "antigravity",
       skillDirs: [path.join(home, ".gemini", "skills")],
       agentFiles: [path.join(home, ".gemini", "agents", "dme-v7.4.md")],
+      agentsMd: path.join(home, ".gemini", "AGENTS.md"),
       rulesFiles: [
-        path.join(home, ".gemini", "GEMINI.md"),
         path.join(home, ".gemini", "AGENTS.md"),
+        path.join(home, ".gemini", "GEMINI.md"),
       ],
       optional: true,
     },
     {
       id: "global-agents",
-      name: "Global AGENTS.md (home)",
-      root: home,
+      name: "Global ~/AGENTS.md",
+      root: path.join(home, ".agents"),
       kind: "generic",
       skillDirs: [
         path.join(home, ".agents", "skills"),
         path.join(home, ".config", "agents", "skills"),
       ],
       agentFiles: [path.join(home, ".agents", "dme-v7.4.md")],
+      agentsMd: path.join(home, "AGENTS.md"),
       rulesFiles: [path.join(home, "AGENTS.md")],
       optional: true,
     },
@@ -175,5 +193,13 @@ export function filterTargets(ids) {
   if (!ids || ids.length === 0) return all;
   const set = new Set(ids.map((x) => x.toLowerCase()));
   if (set.has("all")) return all;
+  if (set.has("detected")) {
+    // lazy import avoided — caller should use detect.mjs
+    return all;
+  }
   return all.filter((t) => set.has(t.id));
 }
+
+export function getTargetById(id) {
+  return getTargets().find((t) => t.id === id) || null;
+}

package/src/tui.mjs

@@ -0,0 +1,352 @@
+/**
+ * Navigable TUI — pure Node raw mode, zero dependencies.
+ * Arrow keys + enter + space + q.
+ */
+
+import readline from "node:readline";
+import {
+  c,
+  clearScreen,
+  hideCursor,
+  showCursor,
+  asciiLogo,
+  detectTag,
+  keyHint,
+  hr,
+  box,
+} from "./ui.mjs";
+
+function isTTY() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+/**
+ * @param {string} question
+ * @param {string[]} choices  labels
+ * @param {number} [initial]
+ * @returns {Promise<number>} index
+ */
+export async function selectMenu(question, choices, initial = 0) {
+  if (!isTTY()) {
+    // fallback: print numbered list
+    console.log(`\n${c.bold}${question}${c.reset}`);
+    choices.forEach((ch, i) => console.log(`  ${c.yellow}${i + 1}.${c.reset} ${ch}`));
+    const ans = await readLinePlain(`  ${c.dim}number >${c.reset} `);
+    const n = parseInt(ans, 10);
+    if (Number.isFinite(n) && n >= 1 && n <= choices.length) return n - 1;
+    return initial;
+  }
+
+  return new Promise((resolve) => {
+    let idx = Math.max(0, Math.min(initial, choices.length - 1));
+    hideCursor();
+
+    const draw = () => {
+      clearScreen();
+      process.stdout.write(asciiLogo());
+      process.stdout.write(`${hr()}\n`);
+      process.stdout.write(`  ${c.brightCyan}${c.bold}${question}${c.reset}\n\n`);
+      choices.forEach((ch, i) => {
+        if (i === idx) {
+          process.stdout.write(
+            `  ${c.bgYellow}${c.black}${c.bold} ▸ ${ch.padEnd(40)} ${c.reset}\n`
+          );
+        } else {
+          process.stdout.write(`  ${c.dim}   ${ch}${c.reset}\n`);
+        }
+      });
+      process.stdout.write(`\n  ${keyHint([
+        ["↑↓", "move"],
+        ["↵", "select"],
+        ["q", "quit"],
+      ])}\n`);
+    };
+
+    const onData = (buf) => {
+      const s = buf.toString("utf8");
+      if (s === "\u0003" || s === "q" || s === "Q") {
+        cleanup();
+        showCursor();
+        process.exit(0);
+      }
+      if (s === "\u001b[A" || s === "k") {
+        idx = (idx - 1 + choices.length) % choices.length;
+        draw();
+        return;
+      }
+      if (s === "\u001b[B" || s === "j") {
+        idx = (idx + 1) % choices.length;
+        draw();
+        return;
+      }
+      if (s === "\r" || s === "\n") {
+        cleanup();
+        showCursor();
+        clearScreen();
+        resolve(idx);
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+    };
+
+    process.stdin.resume();
+    process.stdin.setRawMode?.(true);
+    process.stdin.on("data", onData);
+    draw();
+  });
+}
+
+/**
+ * Multi-select checklist
+ * @param {string} question
+ * @param {{ id: string, label: string, checked?: boolean, detail?: string }[]} items
+ * @returns {Promise<string[]>} selected ids
+ */
+export async function multiSelect(question, items) {
+  const state = items.map((it) => ({
+    ...it,
+    checked: it.checked !== false,
+  }));
+
+  if (!isTTY()) {
+    console.log(`\n${c.bold}${question}${c.reset}`);
+    console.log(c.dim + "  (non-TTY: installing all listed)" + c.reset);
+    state.forEach((it) =>
+      console.log(
+        `  ${it.checked ? c.green + "[x]" : c.gray + "[ ]"}${c.reset} ${it.label}`
+      )
+    );
+    return state.filter((s) => s.checked).map((s) => s.id);
+  }
+
+  return new Promise((resolve) => {
+    let idx = 0;
+    hideCursor();
+
+    const draw = () => {
+      clearScreen();
+      process.stdout.write(asciiLogo());
+      process.stdout.write(`${hr()}\n`);
+      process.stdout.write(`  ${c.brightMagenta}${c.bold}${question}${c.reset}\n`);
+      process.stdout.write(
+        `  ${c.dim}Only CLIs detected on this machine are listed.${c.reset}\n\n`
+      );
+      state.forEach((it, i) => {
+        const mark = it.checked
+          ? `${c.brightGreen}${c.bold}[✔]${c.reset}`
+          : `${c.gray}[ ]${c.reset}`;
+        const cursor =
+          i === idx
+            ? `${c.bgYellow}${c.black}${c.bold} ▸ ${c.reset}`
+            : "   ";
+        const detail = it.detail
+          ? ` ${c.dim}${it.detail}${c.reset}`
+          : "";
+        process.stdout.write(`${cursor}${mark} ${c.brightWhite}${it.label}${c.reset}${detail}\n`);
+      });
+      const n = state.filter((s) => s.checked).length;
+      process.stdout.write(
+        `\n  ${c.cyan}${n}${c.reset}${c.dim}/${state.length} selected${c.reset}\n`
+      );
+      process.stdout.write(
+        `  ${keyHint([
+          ["↑↓", "move"],
+          ["space", "toggle"],
+          ["a", "all"],
+          ["n", "none"],
+          ["↵", "install"],
+          ["q", "quit"],
+        ])}\n`
+      );
+    };
+
+    const onData = (buf) => {
+      const s = buf.toString("utf8");
+      if (s === "\u0003" || s === "q" || s === "Q") {
+        cleanup();
+        showCursor();
+        process.exit(0);
+      }
+      if (s === "\u001b[A" || s === "k") {
+        idx = (idx - 1 + state.length) % state.length;
+        draw();
+        return;
+      }
+      if (s === "\u001b[B" || s === "j") {
+        idx = (idx + 1) % state.length;
+        draw();
+        return;
+      }
+      if (s === " " || s === "x") {
+        state[idx].checked = !state[idx].checked;
+        draw();
+        return;
+      }
+      if (s === "a" || s === "A") {
+        state.forEach((it) => (it.checked = true));
+        draw();
+        return;
+      }
+      if (s === "n" || s === "N") {
+        state.forEach((it) => (it.checked = false));
+        draw();
+        return;
+      }
+      if (s === "\r" || s === "\n") {
+        cleanup();
+        showCursor();
+        clearScreen();
+        resolve(state.filter((it) => it.checked).map((it) => it.id));
+      }
+    };
+
+    const cleanup = () => {
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+    };
+
+    process.stdin.resume();
+    process.stdin.setRawMode?.(true);
+    process.stdin.on("data", onData);
+    draw();
+  });
+}
+
+/**
+ * Prompt when AGENTS.md already exists
+ * @returns {Promise<"merge"|"overwrite"|"skip">}
+ */
+export async function agentsConflictPrompt(filePath) {
+  const short = filePath.replace(process.env.USERPROFILE || "", "~").replace(process.env.HOME || "", "~");
+  const choices = [
+    "Merge — keep your file, inject/update DME block",
+    "Overwrite — replace entire AGENTS.md with DME doctrine",
+    "Skip — leave this AGENTS.md untouched",
+  ];
+  const idx = await selectMenu(
+    `AGENTS.md already exists:\n  ${short}`,
+    choices,
+    0
+  );
+  return ["merge", "overwrite", "skip"][idx];
+}
+
+/**
+ * Simple single-key prompt without full TUI redraw
+ * @returns {Promise<"merge"|"overwrite"|"skip">}
+ */
+export async function agentsConflictPromptInline(filePath) {
+  if (!isTTY()) {
+    console.log(
+      `${c.yellow}!${c.reset} Exists: ${filePath}\n  defaulting to MERGE (non-TTY). Use --agents overwrite|skip|merge`
+    );
+    return "merge";
+  }
+
+  console.log("");
+  console.log(
+    box(
+      "AGENTS.md already exists",
+      [filePath, "", "[M] Merge   [O] Overwrite   [S] Skip"],
+      "magenta"
+    )
+  );
+
+  return new Promise((resolve) => {
+    const onData = (buf) => {
+      const ch = buf.toString("utf8").toLowerCase();
+      if (ch === "\u0003") {
+        cleanup();
+        process.exit(0);
+      }
+      if (ch === "m" || ch === "\r" || ch === "\n") {
+        cleanup();
+        resolve("merge");
+      } else if (ch === "o") {
+        cleanup();
+        resolve("overwrite");
+      } else if (ch === "s") {
+        cleanup();
+        resolve("skip");
+      }
+    };
+    const cleanup = () => {
+      process.stdin.setRawMode?.(false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+      showCursor();
+    };
+    hideCursor();
+    process.stdin.resume();
+    process.stdin.setRawMode?.(true);
+    process.stdin.on("data", onData);
+  });
+}
+
+function readLinePlain(prompt) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    rl.question(prompt, (ans) => {
+      rl.close();
+      resolve(ans.trim());
+    });
+  });
+}
+
+/**
+ * Main navigable app shell
+ * @param {{ version: string, onInstall: Function, onDoctor: Function, onUninstall: Function, onScan: Function }} handlers
+ */
+export async function runMainTui(handlers) {
+  const { version, onInstall, onDoctor, onUninstall, onScan } = handlers;
+
+  for (;;) {
+    const idx = await selectMenu("What do you want to do?", [
+      "Install  — detect CLIs & bootstrap DME",
+      "Scan     — show which CLIs are on this PC",
+      "Doctor   — verify DME install health",
+      "Uninstall— remove DME files & blocks",
+      "Quit",
+    ]);
+
+    if (idx === 0) await onInstall();
+    else if (idx === 1) await onScan();
+    else if (idx === 2) await onDoctor();
+    else if (idx === 3) await onUninstall();
+    else break;
+
+    if (isTTY()) {
+      await selectMenu("Done. Next?", ["Back to menu", "Quit"], 0).then((i) => {
+        if (i === 1) process.exit(0);
+      });
+    } else break;
+  }
+
+  clearScreen();
+  console.log(asciiLogo(version));
+  console.log(`  ${c.dim}later.${c.reset}\n`);
+}
+
+export function printScanTable(report) {
+  console.log(asciiLogo());
+  console.log(hr());
+  console.log(`  ${c.bold}${c.brightCyan}CLI detection${c.reset}\n`);
+  for (const row of report) {
+    const tag = detectTag(row.detected);
+    const agents = row.agentsMd
+      ? `${c.dim}→ ${row.agentsMd}${c.reset}`
+      : "";
+    console.log(
+      `  ${tag} ${c.brightWhite}${row.name.padEnd(22)}${c.reset} ${c.yellow}${row.id.padEnd(14)}${c.reset} ${agents}`
+    );
+  }
+  console.log("");
+}