@mgamil/mapx 0.2.4 → 0.2.6

package/README.md

@@ -2,7 +2,7 @@
 
 **Local code graph memory for LLMs.** Scan your codebase once — instantly query symbols, trace dependencies, analyze impact, and generate structured summaries without re-reading files.
 
-MapX uses [tree-sitter](https://tree-sitter.github.io/) to parse source files across **22 languages**, builds a PageRank-weighted dependency graph, and persists everything to a local SQLite database. Works as a standalone CLI or as an [MCP server](https://modelcontextprotocol.io/) with **25 tools** for Claude Desktop, Cursor, VS Code, and any other MCP-compatible client.
+MapXGraph _-also known as MapX-_ uses [tree-sitter](https://tree-sitter.github.io/) to parse source files across **22 languages**, builds a PageRank-weighted dependency graph, and persists everything to a local SQLite database. Works as a standalone CLI or as an [MCP server](https://modelcontextprotocol.io/) with **25 tools** for Claude Desktop, Cursor, VS Code, and any other MCP-compatible client.
 
 ---
 
@@ -26,7 +26,27 @@ MapX uses [tree-sitter](https://tree-sitter.github.io/) to parse source files ac
 
 ## Installation
 
-### Pre-built binary (recommended)
+### From npm (Global Installation)
+
+Install MapX globally (recommended):
+
+```bash
+npm install -g @mgamil/mapx
+```
+
+### Zero Installation (via npx)
+
+Run MapX directly without installing it globally:
+
+```bash
+# Initialize project
+npx @mgamil/mapx init
+
+# Scan files
+npx @mgamil/mapx scan
+```
+
+### Pre-built binary
 
 Download the latest release for your platform from the [Releases](../../releases) page and place it on your `PATH`:
 
@@ -47,12 +67,6 @@ cd mapx-<version>
 ./install.sh --system         # installs to /usr/local/bin (needs sudo)
 ```
 
-### From npm
-
-```bash
-npm install -g mapx
-```
-
 ### From source
 
 Requires [Node.js](https://nodejs.org/) ≥ 20 or [Bun](https://bun.sh/).
@@ -68,6 +82,9 @@ npx tsx src/main.ts --help
 
 ## Quick Start
 
+> [!TIP]
+> If using the zero-installation method, replace `mapx` with `npx @mgamil/mapx` in the commands below (e.g. `npx @mgamil/mapx init`, `npx @mgamil/mapx scan`).
+
 ```bash
 # 1. Initialize mapx in your project (auto-adds .mapx/ to .gitignore)
 cd /path/to/your/project
@@ -469,20 +486,6 @@ make install-local
 
 ---
 
-## Publishing to npm
-
-To publish new releases of the npm package:
-
-1. Create a tag matching the version in `package.json` and push it:
-   ```bash
-   git tag v0.1.7
-   git push origin v0.1.7
-   ```
-2. The GitHub Actions publish workflow will automatically run, verify version synchronization, build WASM grammars, compile the TypeScript code using `tsup`, and publish to the npm registry with provenance.
-3. **Important**: The workflow requires a repository secret named `NPM_TOKEN`. This token must be generated on `npmjs.com` as an **Automation** access token.
-
----
-
 ## License
 
 Apache 2.0 — see [LICENSE](LICENSE).

package/VERSION

@@ -1 +1 @@
-0.2.4
+0.2.6

package/dist/cli.js

@@ -3,7 +3,6 @@ import { resolve, join, dirname, relative, basename } from "node:path";
 import { existsSync, readFileSync, writeFileSync, readdirSync, rmSync } from "node:fs";
 import { createRequire } from "node:module";
 import { fileURLToPath } from "node:url";
-import * as readline from "node:readline";
 import { Store } from "./core/store.js";
 import { MapxGraph } from "./core/graph.js";
 import { Scanner, buildMatcher } from "./core/scanner.js";
@@ -21,6 +20,7 @@ import { getChangedFiles, isGitRepo } from "./core/git-tracker.js";
 import { getBuiltinLanguages } from "./languages/registry.js";
 import { isLanguageInstalled, installLanguage, uninstallLanguage } from "./languages/installer.js";
 import { RouteRegistry } from "./frameworks/route-registry.js";
+import * as clack from "@clack/prompts";
 const dynamicRequire = createRequire(import.meta.url);
 function readVersion() {
   const base = dirname(fileURLToPath(import.meta.url));
@@ -44,49 +44,81 @@ const PHASE_LABELS = {
   detect: { active: "Detecting changes", done: "Detected changes" },
   cluster: { active: "Detecting clusters", done: "Detected clusters" }
 };
-const SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2E26", "\u28BC", "\u28F4", "\u28F7", "\u28EF", "\u28DF", "\u287F", "\u28BF", "\u28FB", "\u28FD", "\u28FE"];
-let spinnerIdx = 0;
+function truncatePath(path, maxLength) {
+  if (path.length <= maxLength) return path;
+  if (maxLength <= 3) return "...";
+  return "..." + path.slice(path.length - maxLength + 3);
+}
 function createProgressRenderer() {
   let lastPhase = null;
-  let lastLineLen = 0;
-  const writeLine = (line) => {
-    const clear = lastLineLen > 0 ? "\r" + " ".repeat(lastLineLen) + "\r" : "\r";
-    process.stderr.write(clear + line);
-    lastLineLen = line.length;
-  };
-  const renderBar = (current, total, width = 20) => {
-    if (total === 0) {
-      const frame = SPINNER_FRAMES[spinnerIdx++ % SPINNER_FRAMES.length];
-      return `${frame} `;
-    }
-    const filled = Math.min(width, Math.max(0, Math.round(current / total * width)));
-    const empty = width - filled;
-    const bar = "\u2588".repeat(filled) + "\u2591".repeat(empty);
-    const pct = Math.round(current / total * 100);
-    return `${bar} ${pct}%`;
-  };
-  return (progress) => {
-    const { phase, current, total, file } = progress;
+  let p = null;
+  let s = null;
+  let lastCurrent = 0;
+  const callback = (progressData) => {
+    const { phase, current, total, file } = progressData;
     const label = PHASE_LABELS[phase];
+    if (!label) return;
     const isNewPhase = phase !== lastPhase;
-    if (isNewPhase && lastPhase !== null) {
-      const prevLabel = PHASE_LABELS[lastPhase];
-      writeLine(`  \u2714 ${prevLabel.done}
-`);
+    if (isNewPhase) {
+      if (s) {
+        const prevLabel = lastPhase ? PHASE_LABELS[lastPhase] : null;
+        s.stop(prevLabel ? `\u2714 ${prevLabel.done}` : "\u2714 Done");
+        s = null;
+      }
+      if (p) {
+        const prevLabel = lastPhase ? PHASE_LABELS[lastPhase] : null;
+        p.stop(prevLabel ? `\u2714 ${prevLabel.done}` : "\u2714 Done");
+        p = null;
+      }
+      lastPhase = phase;
+      lastCurrent = 0;
+      if (total > 0) {
+        p = clack.progress({
+          style: "heavy",
+          max: total,
+          size: 40
+        });
+        p.start(label.active);
+      } else {
+        s = clack.spinner();
+        s.start(label.active);
+      }
     }
-    lastPhase = phase;
-    const bar = renderBar(current, total);
-    const counter = total > 0 ? `${current}/${total}` : `${current}`;
-    let line = `  ${label.active} ${bar} ${counter}`;
+    const cols = process.stdout.columns || 80;
+    let fileLabel = "";
     if (file) {
-      const maxFileLen = Math.max(0, 60 - line.length);
-      const displayFile = file.length > maxFileLen && maxFileLen > 3 ? "\u2026" + file.slice(-(maxFileLen - 1)) : file.length <= maxFileLen ? file : "";
-      if (displayFile) {
-        line += ` ${displayFile}`;
+      const prefixText = p ? `${label.active} (${current}/${total}) - ` : `${label.active} (${current}) - `;
+      const clackDecorationLength = p ? 45 : 5;
+      const reserved = prefixText.length + clackDecorationLength;
+      const maxFileLen = Math.max(10, cols - reserved - 3);
+      fileLabel = ` - ${truncatePath(file, maxFileLen)}`;
+    }
+    if (p) {
+      const diff = current - lastCurrent;
+      const msg = `${label.active} (${current}/${total})${fileLabel}`;
+      if (diff > 0) {
+        p.advance(diff, msg);
+        lastCurrent = current;
+      } else {
+        p.message(msg);
       }
+    } else if (s) {
+      s.message(`${label.active} (${current})${fileLabel}`);
+    }
+  };
+  callback.stop = (title) => {
+    if (s) {
+      const prevLabel = lastPhase ? PHASE_LABELS[lastPhase] : null;
+      s.stop(title || (prevLabel ? `\u2714 ${prevLabel.done}` : "\u2714 Done"));
+      s = null;
+    }
+    if (p) {
+      const prevLabel = lastPhase ? PHASE_LABELS[lastPhase] : null;
+      p.stop(title || (prevLabel ? `\u2714 ${prevLabel.done}` : "\u2714 Done"));
+      p = null;
     }
-    writeLine(line);
   };
+  return callback;
 }
 const MAPX_MARKER_START = "<!-- mapx -->";
 const MAPX_MARKER_END = "<!-- /mapx -->";
@@ -177,47 +209,20 @@ function replaceBetweenMarkers(existing, block) {
   }
   return existing.slice(0, startIdx) + block + existing.slice(endIdx + MAPX_MARKER_END.length);
 }
-function prompt(question, options) {
-  return new Promise((res) => {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-    const labels = options.map((o, i) => `  ${i + 1}) ${o}`);
-    process.stderr.write(question + "\n" + labels.join("\n") + "\n> ");
-    rl.question("", (answer) => {
-      rl.close();
-      const num = parseInt(answer.trim(), 10);
-      res(num >= 1 && num <= options.length ? num - 1 : options.length - 1);
-    });
-  });
-}
-function askQuestion(query) {
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve2) => rl.question(query, (ans) => {
-    rl.close();
-    resolve2(ans);
-  }));
-}
 async function selectProvidersInteractive() {
   const generator = new AgentGenerator();
   const providers = generator.listProviders();
-  console.log("\nWhich LLM/agent tools do you use in this project?");
-  console.log('Enter numbers separated by commas (e.g. 1,3), type "all" for all, or press Enter for default [1 (generic)]:');
-  providers.forEach((p, idx) => {
-    console.log(`  [${idx + 1}] ${p}`);
+  const selected = await clack.multiselect({
+    message: "Which LLM/agent tools do you use in this project?",
+    options: providers.map((p) => ({ value: p, label: p })),
+    required: false
   });
-  const answer = await askQuestion("\nSelection: ");
-  const input = answer.trim().toLowerCase();
-  if (!input) {
-    return ["generic"];
-  }
-  if (input === "all") {
-    return providers;
+  if (clack.isCancel(selected)) {
+    clack.cancel("Operation cancelled.");
+    process.exit(0);
   }
-  const parts = input.split(",").map((s) => parseInt(s.trim(), 10)).filter((n) => !isNaN(n) && n >= 1 && n <= providers.length);
-  const selected = parts.map((n) => providers[n - 1]);
-  return selected.length === 0 ? ["generic"] : selected;
+  const result = selected;
+  return result.length === 0 ? ["generic"] : result;
 }
 function buildCLI() {
   const program = new Command();
@@ -260,8 +265,15 @@ function buildCLI() {
     console.log("  \u2713 public/**                (web assets)");
     console.log("  \u2713 resources/views/**       (Blade templates \u2014 not yet supported)");
     console.log("  \u2713 **/*.blade.php           (Blade files)");
-    const answer = await askQuestion("\nAdd these to .mapx/config.json? [Y/n] ");
-    return answer.toLowerCase() !== "n";
+    const answer = await clack.confirm({
+      message: "Add these to .mapx/config.json?",
+      initialValue: true
+    });
+    if (clack.isCancel(answer)) {
+      clack.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+    return answer;
   }
   program.command("init").description("Initialize mapx for a project").argument("[path]", "Target directory").option("--name <name>", "Repository name").option("--no-agents", "Skip AGENTS.md creation").option("--no-suggestions", "Skip interactive framework suggestions").option("--no-mcp-configs", "Skip auto-generating MCP config files for detected agent tools").action(async (path, opts) => {
     const dir = path ? resolve(path) : resolveDir(opts, program.opts());
@@ -274,19 +286,19 @@ function buildCLI() {
     if (opts.agents !== false) {
       if (process.stdin.isTTY && opts.suggestions !== false) {
         const selected = await selectProvidersInteractive();
-        console.log(`Generating integration files for: ${selected.join(", ")}...`);
+        clack.log.step(`Generating integration files for: ${selected.join(", ")}...`);
         const generator = new AgentGenerator();
         const actions = generator.plan(selected, { dir });
         for (const action of actions) {
           generator.execute(action);
-          console.log(`  \u2713 Generated ${action.filename} (${action.status})`);
+          clack.log.success(`Generated ${action.filename} (${action.status})`);
         }
       } else {
         const generator = new AgentGenerator();
         const actions = generator.plan(["generic"], { dir });
         for (const action of actions) {
           generator.execute(action);
-          console.log(`  \u2713 Generated ${action.filename} (${action.status})`);
+          clack.log.success(`Generated ${action.filename} (${action.status})`);
         }
       }
     }
@@ -299,7 +311,7 @@ function buildCLI() {
           if (action.status === "up_to_date") continue;
           generator.executeMcpConfig(action);
           const verb = action.status === "merge" ? "merged into" : action.status === "create" ? "created" : "updated";
-          console.log(`  \u2713 MCP config ${verb} ${action.filename} (${action.tool})`);
+          clack.log.success(`MCP config ${verb} ${action.filename} (${action.tool})`);
         }
       }
     }
@@ -312,19 +324,22 @@ function buildCLI() {
       if (!lines.includes(".mapx/") && !lines.includes(".mapx")) {
         const entry = content.length > 0 && !content.endsWith("\n") ? "\n.mapx/\n" : ".mapx/\n";
         writeFileSync(gitignorePath, content + entry);
-        console.log(`  \u2713 Added .mapx/ to .gitignore`);
+        clack.log.success(`Added .mapx/ to .gitignore`);
       }
     }
-    console.log(`Initialized mapx in ${dir}/.mapx/`);
-    console.log(`Repo: ${config.repo.name}`);
+    clack.log.success(`Initialized mapx in ${dir}/.mapx/`);
+    clack.log.info(`Repo: ${config.repo.name}`);
   });
   program.command("uninit").description("Remove .mapx/ directory and reverse project integration changes").argument("[path]", "Target directory").option("-f, --force", "Skip confirmation prompt").action(async (path, opts) => {
     const dir = path ? resolve(path) : resolveDir(opts, program.opts());
     const hasMapx = existsSync(join(dir, ".mapx"));
     if (!opts.force && process.stdin.isTTY) {
-      const answer = await askQuestion(`Are you sure you want to remove .mapx/ and reverse all mapx integrations in ${dir}? [y/N] `);
-      if (answer.trim().toLowerCase() !== "y") {
-        console.log("Aborted.");
+      const answer = await clack.confirm({
+        message: `Are you sure you want to remove .mapx/ and reverse all mapx integrations in ${dir}?`,
+        initialValue: false
+      });
+      if (clack.isCancel(answer) || !answer) {
+        clack.cancel("Aborted.");
         return;
       }
     }
@@ -347,21 +362,21 @@ function buildCLI() {
         });
         if (removed) {
           writeFileSync(gitignorePath, filteredLines.join("\n"), "utf-8");
-          console.log(`  \u2713 Removed .mapx/ from .gitignore`);
+          clack.log.success(`Removed .mapx/ from .gitignore`);
         }
       } catch (err) {
-        console.error(`  \u2717 Failed to update .gitignore: ${err.message}`);
+        clack.log.error(`Failed to update .gitignore: ${err.message}`);
       }
     }
     if (hasMapx) {
       try {
         rmSync(join(dir, ".mapx"), { recursive: true, force: true });
-        console.log(`  \u2713 Removed .mapx/ directory`);
+        clack.log.success(`Removed .mapx/ directory`);
       } catch (err) {
-        console.error(`  \u2717 Failed to remove .mapx/ directory: ${err.message}`);
+        clack.log.error(`Failed to remove .mapx/ directory: ${err.message}`);
       }
     }
-    console.log(`Successfully uninitialized mapx for project: ${dir}`);
+    clack.log.success(`Successfully uninitialized mapx for project: ${dir}`);
   });
   program.command("scan").description("Full scan: parse all files, build graph").argument("[path]", "Target directory").option("--exclude <glob>", "Exclude glob pattern(s)", collectPatterns, []).option("--include <glob>", "Include glob pattern(s)", collectPatterns, []).option("--repo <name>", "Scan only a specific registered repository").option("--all", "Scan all registered repositories").option("--force", "Force re-parsing of all files (bypass cache)", false).action(async (path, opts) => {
     const dir = path ? resolve(path) : resolveDir({}, program.opts());
@@ -373,6 +388,7 @@ function buildCLI() {
     });
     const onSigInt = () => {
       scanner.abort();
+      onProgress.stop("Canceled");
       process.stderr.write("\n");
     };
     process.once("SIGINT", onSigInt);
@@ -383,21 +399,22 @@ function buildCLI() {
       repoNames = ["all"];
     }
     const result = await scanner.scanFull(repoNames, { force: !!opts.force }).catch((err) => {
+      onProgress.stop();
       if (err.message.includes("Another scan is already running")) {
-        console.error(`Error: ${err.message}`);
+        clack.log.error(`Error: ${err.message}`);
         process.exit(1);
       }
       throw err;
     });
     process.removeListener("SIGINT", onSigInt);
-    process.stderr.write("\r" + " ".repeat(80) + "\r");
+    onProgress.stop();
     if (result.interrupted) {
-      console.log(`Scan interrupted after ${result.filesScanned}/${result.totalFiles} files. Progress saved \u2014 run \`scan\` again to resume.`);
+      clack.log.warn(`Scan interrupted after ${result.filesScanned}/${result.totalFiles} files. Progress saved \u2014 run \`scan\` again to resume.`);
     } else {
-      console.log(`Scanned ${result.filesScanned} files in ${result.durationMs}ms`);
+      clack.log.success(`Scanned ${result.filesScanned} files in ${result.durationMs}ms`);
     }
-    console.log(`Languages: ${Object.entries(result.languageBreakdown).map(([l, c]) => `${l}: ${c}`).join(", ")}`);
-    console.log(`Found ${result.symbolsFound} symbols, ${result.edgesFound} edges`);
+    clack.log.info(`Languages: ${Object.entries(result.languageBreakdown).map(([l, c]) => `${l}: ${c}`).join(", ")}`);
+    clack.log.info(`Found ${result.symbolsFound} symbols, ${result.edgesFound} edges`);
   });
   program.command("update").alias("sync").description("Incremental scan: re-scan only changed files").argument("[path]", "Target directory").option("--exclude <glob>", "Exclude glob pattern(s)", collectPatterns, []).option("--include <glob>", "Include glob pattern(s)", collectPatterns, []).option("--repo <name>", "Update only a specific registered repository").option("--all", "Update all registered repositories").action(async (path, opts) => {
     const dir = path ? resolve(path) : resolveDir({}, program.opts());
@@ -420,14 +437,23 @@ function buildCLI() {
       excludes: opts.exclude,
       includes: opts.include
     });
-    process.once("SIGINT", () => scanner.abort());
-    const result = await scanner.scanIncremental(repoNames).catch(handleLockError);
-    process.stderr.write("\r" + " ".repeat(80) + "\r");
+    const onSigInt = () => {
+      scanner.abort();
+      onProgress.stop("Canceled");
+    };
+    process.once("SIGINT", onSigInt);
+    const result = await scanner.scanIncremental(repoNames).catch((err) => {
+      onProgress.stop();
+      handleLockError(err);
+      throw err;
+    });
+    process.removeListener("SIGINT", onSigInt);
+    onProgress.stop();
     if (result.interrupted) {
-      console.log(`Update interrupted after ${result.filesScanned} files.`);
+      clack.log.warn(`Update interrupted after ${result.filesScanned} files.`);
     } else {
-      console.log(`Updated ${result.filesScanned} files in ${result.durationMs}ms`);
-      console.log(`${result.symbolsFound} symbols updated, ${result.edgesFound} edges updated`);
+      clack.log.success(`Updated ${result.filesScanned} files in ${result.durationMs}ms`);
+      clack.log.info(`${result.symbolsFound} symbols updated, ${result.edgesFound} edges updated`);
     }
   });
   program.command("status").description("Show scan status, collected metrics, and changed files").argument("[path]", "Target directory").option("--exclude <glob>", "Exclude glob pattern(s)", collectPatterns, []).option("--include <glob>", "Include glob pattern(s)", collectPatterns, []).action(async (path, opts) => {
@@ -1165,21 +1191,21 @@ Trace: ${start}  ${dirSymbol}  depth\u2264${parsedDepth}`);
   });
   langCmd.command("install <lang>").description("Install grammar and query files for an installable language").action(async (lang) => {
     try {
-      console.log(`Installing language '${lang}'...`);
+      clack.log.step(`Installing language '${lang}'...`);
       await installLanguage(lang);
-      console.log(`Successfully installed language '${lang}'.`);
+      clack.log.success(`Successfully installed language '${lang}'.`);
     } catch (err) {
-      console.error(`Error installing language '${lang}':`, err.message);
+      clack.log.error(`Error installing language '${lang}': ${err.message}`);
       process.exit(1);
     }
   });
   langCmd.command("uninstall <lang>").description("Uninstall grammar and query files for an installable language").action(async (lang) => {
     try {
-      console.log(`Uninstalling language '${lang}'...`);
+      clack.log.step(`Uninstalling language '${lang}'...`);
       await uninstallLanguage(lang);
-      console.log(`Successfully uninstalled language '${lang}'.`);
+      clack.log.success(`Successfully uninstalled language '${lang}'.`);
     } catch (err) {
-      console.error(`Error uninstalling language '${lang}':`, err.message);
+      clack.log.error(`Error uninstalling language '${lang}': ${err.message}`);
       process.exit(1);
     }
   });
@@ -1450,34 +1476,36 @@ Detected Hooks (${hooks.length}):`);
       }
     }
     if (targets.length === 0) {
-      console.error("No valid providers specified.");
+      clack.log.error("No valid providers specified.");
       process.exit(1);
     }
     const actions = generator.plan(targets, { dir, mcpPort: parseInt(opts.mcpPort, 10) });
     for (const action of actions) {
       if (action.status === "up_to_date") {
-        console.log(`  - ${action.filename}: Up to date. Skipping.`);
+        clack.log.info(`${action.filename}: Up to date. Skipping.`);
         continue;
       }
       if (action.status === "update_conflict" || action.status === "no_sentinel") {
-        console.log(`
-\u26A0\uFE0F Conflict/Modification detected in ${action.filename}:`);
+        clack.log.warn(`Conflict/Modification detected in ${action.filename}:`);
         if (action.diff) {
           console.log(action.diff);
         }
         if (!opts.force) {
-          const confirm = await askQuestion(`Overwrite ${action.filename}? [y/N] `);
-          if (confirm.trim().toLowerCase() !== "y") {
-            console.log(`Skipped ${action.filename}.`);
+          const confirm = await clack.confirm({
+            message: `Overwrite ${action.filename}?`,
+            initialValue: false
+          });
+          if (clack.isCancel(confirm) || !confirm) {
+            clack.log.warn(`Skipped ${action.filename}.`);
             continue;
           }
         }
       }
       if (opts.dryRun) {
-        console.log(`[DRY RUN] Would write to ${action.filepath} (status: ${action.status})`);
+        clack.log.info(`[DRY RUN] Would write to ${action.filepath} (status: ${action.status})`);
       } else {
         generator.execute(action);
-        console.log(`\u2713 Wrote to ${action.filename} (status: ${action.status})`);
+        clack.log.success(`Wrote to ${action.filename} (status: ${action.status})`);
       }
     }
   });
@@ -1490,7 +1518,7 @@ Detected Hooks (${hooks.length}):`);
       return temp && existsSync(join(dir, temp.filename));
     });
     if (existingProviders.length === 0) {
-      console.log("No existing LLM integration files found to update.");
+      clack.log.info("No existing LLM integration files found to update.");
       return;
     }
     const actions = generator.plan(existingProviders, { dir, mcpPort: parseInt(opts.mcpPort, 10) });
@@ -1500,29 +1528,31 @@ Detected Hooks (${hooks.length}):`);
         continue;
       }
       if (action.status === "update_conflict") {
-        console.log(`
-\u26A0\uFE0F Customized content detected in ${action.filename}:`);
+        clack.log.warn(`Customized content detected in ${action.filename}:`);
         if (action.diff) {
           console.log(action.diff);
         }
         if (!opts.force) {
-          const confirm = await askQuestion(`Overwrite customizations in ${action.filename}? [y/N] `);
-          if (confirm.trim().toLowerCase() !== "y") {
-            console.log(`Skipped ${action.filename}.`);
+          const confirm = await clack.confirm({
+            message: `Overwrite customizations in ${action.filename}?`,
+            initialValue: false
+          });
+          if (clack.isCancel(confirm) || !confirm) {
+            clack.log.warn(`Skipped ${action.filename}.`);
             continue;
           }
         }
       }
       if (opts.dryRun) {
-        console.log(`[DRY RUN] Would update ${action.filepath}`);
+        clack.log.info(`[DRY RUN] Would update ${action.filepath}`);
       } else {
         generator.execute(action);
-        console.log(`\u2713 Updated ${action.filename}`);
+        clack.log.success(`Updated ${action.filename}`);
         updatedCount++;
       }
     }
     if (updatedCount === 0 && !opts.dryRun) {
-      console.log("All integration files are already up to date.");
+      clack.log.success("All integration files are already up to date.");
     }
   });
   agentsCmd.command("mcp").description("Auto-detect agent tools and generate/update MCP config files").option("--tools <list>", "Comma-separated list of tools to generate configs for (opencode, gemini-cli, cursor-mcp, vscode-mcp)").option("--all", "Generate MCP configs for all supported tools").option("--detect", "Only detect agent tools without writing files").option("--dry-run", "Show actions without writing files").action(async (opts) => {
@@ -1540,39 +1570,37 @@ Detected Hooks (${hooks.length}):`);
     }
     if (opts.detect) {
       if (targets.length === 0) {
-        console.log("No agent tools detected in this project.");
+        clack.log.info("No agent tools detected in this project.");
       } else {
-        console.log(`
-Detected agent tools (${targets.length}):`);
+        clack.log.info(`Detected agent tools (${targets.length}):`);
         for (const t of targets) {
-          console.log(`  \u2713 ${t.name.padEnd(15)} \u2192 ${t.filename}`);
+          clack.log.success(`${t.name.padEnd(15)} \u2192 ${t.filename}`);
         }
       }
-      console.log(`
-All available targets:`);
+      clack.log.info(`All available targets:`);
       for (const c of allConfigs) {
         const detected = targets.includes(c);
         const icon = detected ? "\u2713" : "\xB7";
-        console.log(`  ${icon} ${c.name.padEnd(15)} \u2192 ${c.filename}`);
+        clack.log.info(`${icon} ${c.name.padEnd(15)} \u2192 ${c.filename}`);
       }
       return;
     }
     if (targets.length === 0) {
-      console.log("No agent tools detected. Use --all or --tools to specify targets.");
+      clack.log.warn("No agent tools detected. Use --all or --tools to specify targets.");
       return;
     }
     const actions = generator.generateMcpConfigs(targets, { dir });
     for (const action of actions) {
       if (action.status === "up_to_date") {
-        console.log(`  - ${action.filename}: Up to date.`);
+        clack.log.info(`${action.filename}: Up to date.`);
         continue;
       }
       if (opts.dryRun) {
-        console.log(`[DRY RUN] Would ${action.status} ${action.filename} (${action.tool})`);
+        clack.log.info(`[DRY RUN] Would ${action.status} ${action.filename} (${action.tool})`);
       } else {
         generator.executeMcpConfig(action);
         const verb = action.status === "merge" ? "merged into" : action.status === "create" ? "created" : "updated";
-        console.log(`  \u2713 MCP config ${verb} ${action.filename} (${action.tool})`);
+        clack.log.success(`MCP config ${verb} ${action.filename} (${action.tool})`);
       }
     }
   });
@@ -1623,43 +1651,53 @@ All available targets:`);
     const { config, store, graph } = await loadContext(dir);
     const absPath = resolve(dir, repoPath);
     if (!existsSync(absPath)) {
-      console.error(`Error: Path ${repoPath} does not exist.`);
+      clack.log.error(`Path ${repoPath} does not exist.`);
       process.exit(1);
     }
     if (!isGitRepo(absPath)) {
-      console.error(`Error: Path ${repoPath} is not a git repository.`);
+      clack.log.error(`Path ${repoPath} is not a git repository.`);
       process.exit(1);
     }
     const relPath = relative(dir, absPath);
     const name = opts.name || basename(absPath);
     if (config.repos.some((r) => r.name === name || r.path === relPath)) {
-      console.log(`Repository already registered: ${name} (${relPath})`);
+      clack.log.warn(`Repository already registered: ${name} (${relPath})`);
       return;
     }
     config.addRepo(name, relPath);
     await config.save();
-    console.log(`Registered repository: ${name} -> ${relPath}`);
-    console.log("Running initial full scan for the new repository...");
+    clack.log.success(`Registered repository: ${name} -> ${relPath}`);
+    clack.log.step("Running initial full scan for the new repository...");
     const onProgress = createProgressRenderer();
     const scanner = new Scanner(store, config, graph, onProgress);
-    const result = await scanner.scanFull([name]);
-    console.log(`Scanned ${result.filesScanned} files, ${result.symbolsFound} symbols, ${result.edgesFound} edges in ${result.durationMs}ms`);
+    const onSigInt = () => {
+      scanner.abort();
+      onProgress.stop("Canceled");
+    };
+    process.once("SIGINT", onSigInt);
+    const result = await scanner.scanFull([name]).catch((err) => {
+      onProgress.stop();
+      throw err;
+    });
+    process.removeListener("SIGINT", onSigInt);
+    onProgress.stop();
+    clack.log.success(`Scanned ${result.filesScanned} files, ${result.symbolsFound} symbols, ${result.edgesFound} edges in ${result.durationMs}ms`);
   });
   workspacesCmd.command("remove <name>").description("Unregister a repository by name or path").action(async (name) => {
     const dir = resolveDir({}, program.opts());
     const { config, store } = await loadContext(dir);
     const repo = config.repos.find((r) => r.name === name || r.path === name);
     if (!repo) {
-      console.error(`Error: Repository ${name} is not registered.`);
+      clack.log.error(`Repository ${name} is not registered.`);
       process.exit(1);
     }
     const repoName = repo.name;
     config.removeRepo(name);
     await config.save();
-    console.log(`Unregistered repository: ${repoName}`);
-    console.log(`Cleaning up stored data for repository: ${repoName}...`);
+    clack.log.success(`Unregistered repository: ${repoName}`);
+    clack.log.step(`Cleaning up stored data for repository: ${repoName}...`);
     store.deleteRepo(repoName);
-    console.log(`Done.`);
+    clack.log.success(`Done.`);
   });
   workspacesCmd.command("discover").description("Discover unregistered submodules, peer repos, and VS Code workspace folders (read-only)").action(async () => {
     const dir = resolveDir({}, program.opts());
@@ -1750,20 +1788,31 @@ ${found} unregistered repositor${found === 1 ? "y" : "ies"} discovered. Use \`ma
       }
     }
     if (toAdd.length === 0) {
-      console.log("No new repositories discovered to sync.");
+      clack.log.info("No new repositories discovered to sync.");
       return;
     }
-    console.log(`Syncing ${toAdd.length} newly discovered repositories:`);
-    const scanner = new Scanner(store, config, graph, createProgressRenderer());
+    clack.log.step(`Syncing ${toAdd.length} newly discovered repositories:`);
     for (const item of toAdd) {
       config.addRepo(item.name, item.path);
-      console.log(`  + Registered: ${item.name} -> ${item.path}`);
+      clack.log.success(`Registered: ${item.name} -> ${item.path}`);
     }
     await config.save();
-    console.log("\nRunning initial full scan for new repositories...");
+    clack.log.step("Running initial full scan for new repositories...");
     const newNames = toAdd.map((item) => item.name);
-    const result = await scanner.scanFull(newNames);
-    console.log(`Scanned ${result.filesScanned} files, ${result.symbolsFound} symbols, ${result.edgesFound} edges in ${result.durationMs}ms`);
+    const onProgress = createProgressRenderer();
+    const scanner = new Scanner(store, config, graph, onProgress);
+    const onSigInt = () => {
+      scanner.abort();
+      onProgress.stop("Canceled");
+    };
+    process.once("SIGINT", onSigInt);
+    const result = await scanner.scanFull(newNames).catch((err) => {
+      onProgress.stop();
+      throw err;
+    });
+    process.removeListener("SIGINT", onSigInt);
+    onProgress.stop();
+    clack.log.success(`Scanned ${result.filesScanned} files, ${result.symbolsFound} symbols, ${result.edgesFound} edges in ${result.durationMs}ms`);
   });
   return program;
 }

package/dist/core/config.js

@@ -9,15 +9,63 @@ const DEFAULT_CONFIG = {
   settings: {
     maxTokenBudget: 16384,
     excludePatterns: [
-      "node_modules/**",
-      "vendor/**",
       ".git/**",
-      "dist/**",
       ".mapx/**",
+      "node_modules/**",
+      "**/node_modules/**",
+      "dist/**",
+      "**/dist/**",
+      "vendor/**",
+      "**/vendor/**",
+      "Vendor/**",
+      "**/Vendor/**",
+      "__pycache__/**",
+      "**/__pycache__/**",
+      ".venv/**",
+      ".next/**",
+      "res/**",
+      "**/res/**",
+      "gradle/**",
+      "**/gradle/**",
+      "build/**",
+      "**/build/**",
       "*.min.js",
-      "*.min.css",
+      "monaco/vs/**/*.js",
+      "bootstrap-*/bootstrap.js",
+      "bootstrap-*/bootstrap.min.js",
+      "bootstrap-*/bootstrap.bundle.js",
+      "bootstrap-*/bootstrap.bundle.min.js",
+      "vue.global.js",
+      "vue.esm-browser.js",
+      "vue.runtime.esm-browser.js",
+      "vue.runtime.esm-browser.prod.js",
+      "react.development.js",
+      "react.production.min.js",
+      "react-dom.development.js",
+      "react-dom.production.min.js",
+      "package.json",
       "package-lock.json",
-      "composer.lock"
+      "yarn.lock",
+      "pnpm-lock.yaml",
+      "composer.json",
+      "composer.lock",
+      "pyproject.toml",
+      "Pipfile",
+      "Pipfile.lock",
+      "poetry.lock",
+      "go.mod",
+      "go.sum",
+      "Cargo.toml",
+      "Cargo.lock",
+      "bun.lock",
+      "AndroidManifest.xml",
+      "AndroidManifest.xml",
+      "**/*.log",
+      "**/*.lock",
+      "**/*.tmp",
+      "**/*.swp",
+      "**/*.swo",
+      "**/*.DS_Store"
     ],
     includePatterns: []
   }

package/dist/core/scanner.js

@@ -245,7 +245,21 @@ class Scanner {
       const activeDetectors = await registry.detectActiveFrameworks(repoRoot, filePaths);
       const activeFrameworks = activeDetectors.map((d) => d.name);
       const ignoredSymbols = buildIgnoredSymbols(activeFrameworks);
-      const parseResults = await this.parseFilesParallel(toParse, workspaceRoot, ignoredSymbols);
+      let parsedFilesCount = 0;
+      const parseResults = await this.parseFilesParallel(
+        toParse,
+        workspaceRoot,
+        ignoredSymbols,
+        (relPath) => {
+          parsedFilesCount++;
+          this.onProgress?.({
+            phase: "parse",
+            current: unchangedFiles.length + resumedCompleted.size + parsedFilesCount,
+            total: discovered.length,
+            file: relPath
+          });
+        }
+      );
       const fileMap = this.workspaceFileMap.size > 0 ? this.workspaceFileMap : (() => {
         const allTrackedFiles = this.store.getAllFiles();
         const map = /* @__PURE__ */ new Map();
@@ -266,12 +280,6 @@ class Scanner {
           totalEdges += parseResults[i].references.length;
           completed.add(toParse[i].relativePath);
         }
-        this.onProgress?.({
-          phase: "parse",
-          current: completed.size,
-          total: discovered.length,
-          file: toParse[batchEnd - 1].relativePath
-        });
         this.saveResumeState(repo.name, {
           totalFiles: discovered.length,
           completedFiles: [...completed],
@@ -441,10 +449,20 @@ class Scanner {
     const activeDetectors = await registry.detectActiveFrameworks(repoRoot, allFilePaths);
     const activeFrameworks = activeDetectors.map((d) => d.name);
     const ignoredSymbols = buildIgnoredSymbols(activeFrameworks);
+    let parsedFilesCount = 0;
     const parseResults = await this.parseFilesParallel(
       toReindex.map((r) => r.fileInfo),
       workspaceRoot,
-      ignoredSymbols
+      ignoredSymbols,
+      (relPath) => {
+        parsedFilesCount++;
+        this.onProgress?.({
+          phase: "parse",
+          current: parsedFilesCount,
+          total: toReindex.length,
+          file: relPath
+        });
+      }
     );
     let totalSymbols = 0;
     let totalEdges = 0;
@@ -456,12 +474,6 @@ class Scanner {
       totalSymbols += result.symbols.length;
       totalEdges += result.references.length;
       langBreakdown[fileInfo.language] = (langBreakdown[fileInfo.language] || 0) + 1;
-      this.onProgress?.({
-        phase: "parse",
-        current: i + 1,
-        total: changes.length,
-        file: relPath
-      });
     }
     if (!this.aborted) {
       const commitSha = getCurrentCommitSha(repoRoot);
@@ -564,14 +576,14 @@ class Scanner {
     }
     return deleted;
   }
-  async parseFilesParallel(files, workspaceRoot, ignoredSymbols) {
+  async parseFilesParallel(files, workspaceRoot, ignoredSymbols, onFileParsed) {
     if (files.length === 0) return [];
-    return this.parseOnMainThread(files, workspaceRoot, ignoredSymbols);
+    return this.parseOnMainThread(files, workspaceRoot, ignoredSymbols, onFileParsed);
   }
-  async parseWithWorkers(files, workspaceRoot, ignoredSymbols) {
-    return this.parseOnMainThread(files, workspaceRoot, ignoredSymbols);
+  async parseWithWorkers(files, workspaceRoot, ignoredSymbols, onFileParsed) {
+    return this.parseOnMainThread(files, workspaceRoot, ignoredSymbols, onFileParsed);
   }
-  async parseOnMainThread(files, workspaceRoot, ignoredSymbols) {
+  async parseOnMainThread(files, workspaceRoot, ignoredSymbols, onFileParsed) {
     const results = new Array(files.length);
     const sources = await Promise.all(
       files.map(async (f) => {
@@ -592,6 +604,8 @@ class Scanner {
         const relPath = relative(workspaceRoot, fileInfo.absolutePath).replace(/\\/g, "/");
         if (sources[i] === null) {
           results[i] = { symbols: [], references: [], errors: [{ message: `Failed to read ${relPath}` }] };
+          onFileParsed?.(relPath);
+          await new Promise((resolve2) => setImmediate(resolve2));
           continue;
         }
         try {
@@ -603,6 +617,8 @@ class Scanner {
         } catch {
           results[i] = { symbols: [], references: [], errors: [{ message: `Failed to parse ${relPath}` }] };
         }
+        onFileParsed?.(relPath);
+        await new Promise((resolve2) => setImmediate(resolve2));
       }
     };
     await Promise.all(Array.from({ length: Math.min(CONCURRENCY, files.length) }, runWorker));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mgamil/mapx",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "license": "Apache-2.0",
   "description": "Multi-language code graph memory system for LLMs",
   "author": {
@@ -94,6 +94,8 @@
     "test": "tsx src/main.ts scan && tsx src/main.ts export"
   },
   "dependencies": {
+    "@clack/prompts": "^1.4.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.10.0",
     "commander": "^13.1.0",
     "cytoscape": "^3.33.4",
@@ -110,10 +112,8 @@
     "tree-sitter-typescript": "^0.23.2",
     "uplot": "^1.6.32",
     "web-tree-sitter": "^0.26.9",
-    "zod": "^3.25.0",
-    "@modelcontextprotocol/sdk": "^1.29.0"
+    "zod": "^3.25.0"
   },
-  "optionalDependencies": {},
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/cytoscape": "^3.21.9",