trace-mcp 1.16.1 → 1.18.0

package/dist/cli.js

@@ -88582,7 +88582,7 @@ init_schema();
 init_store();
 init_registry();
 init_config();
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 import path120 from "path";
 import fs111 from "fs";
 import { randomUUID } from "crypto";
@@ -88596,7 +88596,7 @@ import https from "https";
 import { spawnSync } from "child_process";
 import path63 from "path";
 import fs64 from "fs";
-var CURRENT_VERSION = true ? "1.16.1" : "0.0.0-dev";
+var CURRENT_VERSION = true ? "1.18.0" : "0.0.0-dev";
 var UPDATE_CACHE_PATH = path63.join(TRACE_MCP_HOME, "update-check.json");
 function readCache() {
   try {
@@ -108775,7 +108775,7 @@ function registerAdvancedTools(server, ctx) {
         symbolKinds: symbol_kinds,
         maxFiles: max_files,
         maxNodes: max_nodes,
-        topoStore: ctx.topoStore,
+        topoStore: ctx.topoStore ?? void 0,
         projectRoot
       });
       if (result.isErr()) return { content: [{ type: "text", text: j3(formatToolError(result.error)) }], isError: true };
@@ -115505,7 +115505,7 @@ var TopologyStore = class {
 };
 
 // src/server/server.ts
-var PKG_VERSION = true ? "1.16.1" : "0.0.0-dev";
+var PKG_VERSION = true ? "1.18.0" : "0.0.0-dev";
 function j2(value) {
   return JSON.stringify(value, (_key, val) => val === null || val === void 0 ? void 0 : val);
 }
@@ -116079,7 +116079,7 @@ function isServerRunning(db) {
 import http from "http";
 
 // src/cli/init.ts
-import { Command } from "commander";
+import { Command as Command2 } from "commander";
 import fs102 from "fs";
 import path113 from "path";
 import * as p from "@clack/prompts";
@@ -117766,9 +117766,13 @@ import path112 from "path";
 import os13 from "os";
 import https2 from "https";
 import { execSync as execSync6 } from "child_process";
+import { Command } from "commander";
 var GITHUB_REPO = "nikolai-vysotskyi/trace-mcp";
 var APP_NAME = "trace-mcp.app";
 var INSTALL_DIR = path112.join(os13.homedir(), "Applications");
+function sleep(ms2) {
+  return new Promise((resolve3) => setTimeout(resolve3, ms2));
+}
 function fetchLatestRelease(timeoutMs = 1e4) {
   return new Promise((resolve3, reject) => {
     const req = https2.get(
@@ -117856,17 +117860,52 @@ function downloadFile(url2, dest, timeoutMs = 6e4) {
     doGet(url2);
   });
 }
-async function installGuiApp() {
+function pinToDock(appPath) {
+  try {
+    const dockPlist = execSync6("defaults read com.apple.dock persistent-apps", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (dockPlist.includes(appPath)) return;
+    const entry = `<dict><key>tile-data</key><dict><key>file-data</key><dict><key>_CFURLString</key><string>${appPath}</string><key>_CFURLStringType</key><integer>0</integer></dict></dict></dict>`;
+    execSync6(
+      `defaults write com.apple.dock persistent-apps -array-add '${entry}'`,
+      { stdio: "pipe" }
+    );
+    execSync6("killall Dock", { stdio: "pipe" });
+  } catch {
+  }
+}
+async function installGuiApp(opts = {}) {
   if (process.platform !== "darwin") {
     return { installed: false, error: "Menu bar app is macOS only" };
   }
+  const { retries = 3, retryDelayMs = 15e3, onRetry } = opts;
   const arch = process.arch === "arm64" ? "arm64" : "x64";
-  const zipPattern = new RegExp(`trace-mcp.*${arch}\\.zip$`, "i");
+  const findAsset = (assets) => {
+    const zips = assets.filter((a) => /trace-mcp.*\.zip$/i.test(a.name));
+    if (arch === "arm64") {
+      return zips.find((a) => /arm64/i.test(a.name));
+    }
+    return zips.find((a) => !/arm64/i.test(a.name));
+  };
   try {
-    const release = await fetchLatestRelease();
-    const asset = release.assets.find((a) => zipPattern.test(a.name));
+    let release;
+    let asset;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      release = await fetchLatestRelease();
+      asset = findAsset(release.assets);
+      if (asset) break;
+      if (attempt < retries) {
+        onRetry?.(attempt + 1, retries);
+        await sleep(retryDelayMs);
+      }
+    }
     if (!asset) {
-      return { installed: false, error: `No ${arch} zip found in release ${release.tag}` };
+      return {
+        installed: false,
+        error: `No ${arch} zip found in release ${release.tag} (${release.assets.length} assets available: ${release.assets.map((a) => a.name).join(", ") || "none"}). The build may still be in progress \u2014 try again in a few minutes with: trace-mcp install-app`
+      };
     }
     const tmpDir = fs101.mkdtempSync(path112.join(os13.tmpdir(), "trace-mcp-app-"));
     const zipPath = path112.join(tmpDir, asset.name);
@@ -117879,6 +117918,7 @@ async function installGuiApp() {
     execSync6(`unzip -q -o "${zipPath}" -d "${INSTALL_DIR}"`, { stdio: "pipe" });
     fs101.writeFileSync(path112.join(INSTALL_DIR, ".trace-mcp-version"), release.tag, "utf-8");
     fs101.rmSync(tmpDir, { recursive: true, force: true });
+    pinToDock(appPath);
     return { installed: true, path: appPath };
   } catch (err47) {
     return { installed: false, error: err47.message };
@@ -117887,9 +117927,32 @@ async function installGuiApp() {
 function isAppInstalled() {
   return fs101.existsSync(path112.join(INSTALL_DIR, APP_NAME));
 }
+var installAppCommand = new Command("install-app").description("Download and install (or update) the trace-mcp menu bar app (macOS)").option("--retries <n>", "Number of retries if asset not yet uploaded", "3").option("--retry-delay <ms>", "Delay between retries in ms", "15000").action(async (opts) => {
+  if (process.platform !== "darwin") {
+    console.error("Error: Menu bar app is macOS only.");
+    process.exit(1);
+  }
+  const retries = parseInt(opts.retries, 10);
+  const retryDelayMs = parseInt(opts.retryDelay, 10);
+  const already = isAppInstalled();
+  console.log(already ? "Updating trace-mcp menu bar app\u2026" : "Installing trace-mcp menu bar app\u2026");
+  const result = await installGuiApp({
+    retries,
+    retryDelayMs,
+    onRetry: (attempt, total) => {
+      console.log(`  Asset not yet available, retrying (${attempt}/${total})\u2026`);
+    }
+  });
+  if (result.installed) {
+    console.log(`\u2713 ${already ? "Updated" : "Installed"} \u2192 ${result.path}`);
+  } else {
+    console.error(`\u2717 ${result.error}`);
+    process.exit(1);
+  }
+});
 
 // src/cli/init.ts
-var initCommand = new Command("init").description("One-time global setup: configure MCP clients, install hooks, set up CLAUDE.md").option("--yes", "Skip prompts, use recommended defaults").option("--skip-hooks", "Do not install guard hooks").option("--skip-mcp-client", "Do not configure MCP client").option("--skip-claude-md", "Do not add CLAUDE.md block").option("--mcp-client <name>", "Force MCP client: claude-code | claude-desktop | cursor | windsurf | continue").option("--force", "Overwrite existing configuration").option("--dry-run", "Show what would be done without writing files").option("--json", "Output results as JSON (implies --yes)").option("--index", "Also register and index the current project").action(async (opts) => {
+var initCommand = new Command2("init").description("One-time global setup: configure MCP clients, install hooks, set up CLAUDE.md").option("--yes", "Skip prompts, use recommended defaults").option("--skip-hooks", "Do not install guard hooks").option("--skip-mcp-client", "Do not configure MCP client").option("--skip-claude-md", "Do not add CLAUDE.md block").option("--mcp-client <name>", "Force MCP client: claude-code | claude-desktop | cursor | windsurf | continue").option("--force", "Overwrite existing configuration").option("--dry-run", "Show what would be done without writing files").option("--json", "Output results as JSON (implies --yes)").option("--index", "Also register and index the current project").action(async (opts) => {
   const nonInteractive = opts.yes || opts.json || opts.dryRun;
   let migrationStep;
   if (!opts.dryRun) {
@@ -117948,15 +118011,15 @@ var initCommand = new Command("init").description("One-time global setup: config
           {
             value: "standard",
             label: "Standard \u2014 CLAUDE.md + hooks",
-            hint: "guard hooks intercept tool calls at runtime (recommended)"
+            hint: "guard hooks intercept tool calls at runtime"
           },
           {
             value: "max",
             label: "Max \u2014 CLAUDE.md + hooks + tweakcc",
-            hint: tweakccState.installed ? "patches Claude's system prompts (strongest)" : "requires tweakcc \u2014 install with `npx tweakcc` first"
+            hint: tweakccState.installed ? "patches Claude's system prompts (recommended)" : "requires tweakcc \u2014 install with `npx tweakcc` first (recommended)"
           }
         ],
-        initialValue: "standard"
+        initialValue: "max"
       });
       if (p.isCancel(levelResult)) {
         p.cancel("Cancelled.");
@@ -118154,7 +118217,13 @@ var initCommand = new Command("init").description("One-time global setup: config
   if (installApp && !opts.dryRun) {
     const spin = p.spinner();
     spin.start("Downloading trace-mcp menu bar app\u2026");
-    const appResult = await installGuiApp();
+    const appResult = await installGuiApp({
+      retries: 3,
+      retryDelayMs: 15e3,
+      onRetry: (attempt, total) => {
+        spin.message(`App asset not uploaded yet, retrying (${attempt}/${total})\u2026`);
+      }
+    });
     if (appResult.installed) {
       spin.stop(`Installed \u2192 ${appResult.path}`);
       steps.push({ target: appResult.path, action: "created", detail: "Menu bar app installed" });
@@ -118368,10 +118437,10 @@ init_pipeline();
 init_logger();
 init_registry2();
 init_global();
-import { Command as Command2 } from "commander";
+import { Command as Command3 } from "commander";
 import fs103 from "fs";
 import path114 from "path";
-var upgradeCommand = new Command2("upgrade").description("Upgrade trace-mcp: run DB migrations, reindex with latest plugins, update hooks and CLAUDE.md").argument("[dir]", "Project directory (omit to upgrade all registered projects)").option("--skip-hooks", "Do not update guard hooks").option("--skip-reindex", "Do not trigger reindex").option("--skip-claude-md", "Do not update CLAUDE.md block").option("--dry-run", "Show what would be done without writing files").option("--json", "Output results as JSON").action(async (dir, opts) => {
+var upgradeCommand = new Command3("upgrade").description("Upgrade trace-mcp: run DB migrations, reindex with latest plugins, update hooks and CLAUDE.md").argument("[dir]", "Project directory (omit to upgrade all registered projects)").option("--skip-hooks", "Do not update guard hooks").option("--skip-reindex", "Do not trigger reindex").option("--skip-claude-md", "Do not update CLAUDE.md block").option("--dry-run", "Show what would be done without writing files").option("--json", "Output results as JSON").action(async (dir, opts) => {
   const projectRoots = [];
   if (dir) {
     projectRoots.push(path114.resolve(dir));
@@ -118475,7 +118544,7 @@ var upgradeCommand = new Command2("upgrade").description("Upgrade trace-mcp: run
 });
 
 // src/cli/add.ts
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 import fs104 from "fs";
 import path115 from "path";
 import * as p2 from "@clack/prompts";
@@ -118521,7 +118590,7 @@ function formatDuration2(ms2) {
   if (ms2 < 1e3) return `${ms2}ms`;
   return `${(ms2 / 1e3).toFixed(1)}s`;
 }
-var addCommand = new Command3("add").description("Register a project for indexing: detect root, create DB, add to registry").argument("[dir]", "Project directory (default: current directory)", ".").option("--force", "Re-register even if already registered").option("--no-index", "Skip indexing after registration").option("--json", "Output results as JSON").action(async (dir, opts) => {
+var addCommand = new Command4("add").description("Register a project for indexing: detect root, create DB, add to registry").argument("[dir]", "Project directory (default: current directory)", ".").option("--force", "Re-register even if already registered").option("--no-index", "Skip indexing after registration").option("--json", "Output results as JSON").action(async (dir, opts) => {
   const resolvedDir = path115.resolve(dir);
   if (!fs104.existsSync(resolvedDir)) {
     console.error(`Directory does not exist: ${resolvedDir}`);
@@ -118777,14 +118846,14 @@ function shortPath4(p5) {
 }
 
 // src/cli/doctor.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 import * as p3 from "@clack/prompts";
 var SEVERITY_LABEL = {
   critical: "CRITICAL",
   warning: "WARNING",
   info: "INFO"
 };
-var doctorCommand = new Command4("doctor").description("Check for competing tools that may conflict with trace-mcp").option("--fix", "Automatically fix all fixable conflicts").option("--fix-interactive", "Fix conflicts interactively (ask for each)").option("--dry-run", "Show what --fix would do without making changes").option("--json", "Output results as JSON").action(async (opts) => {
+var doctorCommand = new Command5("doctor").description("Check for competing tools that may conflict with trace-mcp").option("--fix", "Automatically fix all fixable conflicts").option("--fix-interactive", "Fix conflicts interactively (ask for each)").option("--dry-run", "Show what --fix would do without making changes").option("--json", "Output results as JSON").action(async (opts) => {
   let projectRoot;
   try {
     projectRoot = findProjectRoot(process.cwd());
@@ -118923,7 +118992,7 @@ init_pipeline();
 init_config();
 init_global();
 init_registry2();
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 import { execFileSync as execFileSync7 } from "child_process";
 import path116 from "path";
 import fs105 from "fs";
@@ -119564,7 +119633,7 @@ function resolveDbPath(projectRoot) {
   if (entry) return entry.dbPath;
   return getDbPath(projectRoot);
 }
-var ciReportCommand = new Command5("ci-report").description("Generate a change impact report for a PR/branch").option("--base <ref>", "Base git ref (default: main)", "main").option("--head <ref>", "Head git ref (default: HEAD)", "HEAD").option("--format <fmt>", "Output format: markdown | json (default: markdown)", "markdown").option("--output <path>", "Output file path (default: stdout, use - for stdout)", "-").option("--fail-on <level>", "Exit with code 1 if risk >= level: critical | high | medium", "").option("--index", "Index the project before generating the report", false).option("--no-project-aware", "Disable domain/ownership/deployment analysis").option("--save-baseline", "Save current scores as quality baseline", false).option("--fail-regression", "Exit 1 if quality regressed vs baseline", false).option("--annotations <format>", "Output annotations: github-actions | json").action(async (opts) => {
+var ciReportCommand = new Command6("ci-report").description("Generate a change impact report for a PR/branch").option("--base <ref>", "Base git ref (default: main)", "main").option("--head <ref>", "Head git ref (default: HEAD)", "HEAD").option("--format <fmt>", "Output format: markdown | json (default: markdown)", "markdown").option("--output <path>", "Output file path (default: stdout, use - for stdout)", "-").option("--fail-on <level>", "Exit with code 1 if risk >= level: critical | high | medium", "").option("--index", "Index the project before generating the report", false).option("--no-project-aware", "Disable domain/ownership/deployment analysis").option("--save-baseline", "Save current scores as quality baseline", false).option("--fail-regression", "Exit 1 if quality regressed vs baseline", false).option("--annotations <format>", "Output annotations: github-actions | json").action(async (opts) => {
   let projectRoot;
   try {
     projectRoot = findProjectRoot(process.cwd());
@@ -119696,7 +119765,7 @@ init_store();
 init_config();
 init_global();
 init_registry2();
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 init_logger();
 init_pipeline();
 init_registry();
@@ -119708,7 +119777,7 @@ function resolveDbPath2(projectRoot) {
   if (entry) return entry.dbPath;
   return getDbPath(projectRoot);
 }
-var checkCommand = new Command6("check").description("Run quality gate checks against the indexed project (exit code 0 = pass, 1 = fail)").option("--config <path>", "Path to config file with quality_gates section").option("--format <fmt>", "Output format: text | json (default: text)", "text").option("--index", "Re-index the project before checking", false).option("--fail-on <level>", "Override fail_on: error | warning | none").action(async (opts) => {
+var checkCommand = new Command7("check").description("Run quality gate checks against the indexed project (exit code 0 = pass, 1 = fail)").option("--config <path>", "Path to config file with quality_gates section").option("--format <fmt>", "Output format: text | json (default: text)", "text").option("--index", "Re-index the project before checking", false).option("--fail-on <level>", "Override fail_on: error | warning | none").action(async (opts) => {
   let projectRoot;
   try {
     projectRoot = findProjectRoot(process.cwd());
@@ -119799,7 +119868,7 @@ function getDefaultGatesConfig() {
 }
 
 // src/cli/bundles.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 init_global();
 init_registry2();
 function resolveDbPath3(projectRoot) {
@@ -119807,7 +119876,7 @@ function resolveDbPath3(projectRoot) {
   if (entry) return entry.dbPath;
   return getDbPath(projectRoot);
 }
-var bundlesCommand = new Command7("bundles").description("Manage pre-indexed bundles for dependency libraries");
+var bundlesCommand = new Command8("bundles").description("Manage pre-indexed bundles for dependency libraries");
 bundlesCommand.command("list").description("List installed bundles").action(() => {
   ensureBundlesDir();
   const bundles = listBundles();
@@ -119850,7 +119919,7 @@ bundlesCommand.command("remove").description("Remove an installed bundle").requi
 });
 
 // src/cli/federation.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 init_global();
 init_logger();
 function createManager() {
@@ -119859,7 +119928,7 @@ function createManager() {
   const manager = new FederationManager(topoStore);
   return { manager, topoStore };
 }
-var federationCommand = new Command8("federation").description("Multi-repo graph federation \u2014 link API contracts across repositories").alias("fed");
+var federationCommand = new Command9("federation").description("Multi-repo graph federation \u2014 link API contracts across repositories").alias("fed");
 federationCommand.command("add").description("Add a repository to the federation").requiredOption("--repo <path>", "Path to the repository").option("--contract <paths...>", "Explicit contract file paths (relative to repo root)").option("--name <name>", "Name for this repo (default: directory basename)").action((opts) => {
   const { manager, topoStore } = createManager();
   try {
@@ -119996,7 +120065,7 @@ federationCommand.command("impact").description("Cross-repo impact analysis: who
 });
 
 // src/cli/analytics.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 init_schema();
 init_store();
 init_global();
@@ -120049,7 +120118,7 @@ function printSingleReport(result) {
   }
   console.log("");
 }
-var analyticsCommand = new Command9("analytics").description("AI agent session analytics: sync logs, view reports, find optimizations");
+var analyticsCommand = new Command10("analytics").description("AI agent session analytics: sync logs, view reports, find optimizations");
 analyticsCommand.command("sync").description("Parse Claude Code session logs into analytics database").option("--full", "Force full rescan of all sessions", false).option("--project <path>", "Filter by project path").action(async (opts) => {
   ensureGlobalDirs();
   const analyticsStore = new AnalyticsStore();
@@ -120337,14 +120406,14 @@ analyticsCommand.command("trends").description("Show daily usage trends: tokens,
 });
 
 // src/cli/remove.ts
-import { Command as Command10 } from "commander";
+import { Command as Command11 } from "commander";
 import fs107 from "fs";
 import path117 from "path";
 import * as p4 from "@clack/prompts";
 init_registry2();
 init_config();
 init_global();
-var removeCommand = new Command10("remove").description("Unregister a project and delete its index").argument("[dir]", "Project directory (default: current directory)", ".").option("--force", "Remove without confirmation").option("--keep-db", "Keep the database file (only unregister)").option("--json", "Output results as JSON").action(async (dir, opts) => {
+var removeCommand = new Command11("remove").description("Unregister a project and delete its index").argument("[dir]", "Project directory (default: current directory)", ".").option("--force", "Remove without confirmation").option("--keep-db", "Keep the database file (only unregister)").option("--json", "Output results as JSON").action(async (dir, opts) => {
   const resolvedDir = path117.resolve(dir);
   const isInteractive = !opts.json;
   let projectRoot;
@@ -120533,7 +120602,7 @@ function shortPath6(p5) {
 // src/cli/status.ts
 init_global();
 init_registry2();
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 import fs108 from "fs";
 import Database9 from "better-sqlite3";
 function resolveDbPath5(projectRoot) {
@@ -120571,7 +120640,7 @@ function formatPipeline(name, p5) {
       return `  ${label} ${p5.phase}`;
   }
 }
-var statusCommand = new Command11("status").description("Show indexing progress for the current project").option("--json", "Output as JSON").action((opts) => {
+var statusCommand = new Command12("status").description("Show indexing progress for the current project").option("--json", "Output as JSON").action((opts) => {
   let projectRoot;
   try {
     projectRoot = findProjectRoot(process.cwd());
@@ -120631,7 +120700,7 @@ import { execSync as execSync7 } from "child_process";
 import fs109 from "fs";
 import os14 from "os";
 import path118 from "path";
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 init_registry2();
 function openInBrowser(filePath) {
   const platform = process.platform;
@@ -120642,7 +120711,7 @@ function openInBrowser(filePath) {
   } catch {
   }
 }
-var visualizeCommand = new Command12("visualize").alias("viz").description("Generate an interactive dependency graph and open it in the browser").argument("[scope]", `what to visualize
+var visualizeCommand = new Command13("visualize").alias("viz").description("Generate an interactive dependency graph and open it in the browser").argument("[scope]", `what to visualize
 
   Scope can be:
     project            whole project graph
@@ -120734,7 +120803,7 @@ visualizeCommand.command("federation").alias("fed").description("Open federation
 
 // src/cli/daemon.ts
 init_global();
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 import fs110 from "fs";
 import path119 from "path";
 import { execSync as execSync8, spawn as spawn2 } from "child_process";
@@ -120815,7 +120884,7 @@ function isPlistLoaded() {
     return false;
   }
 }
-var daemonCommand = new Command13("daemon").description("Manage the trace-mcp background daemon");
+var daemonCommand = new Command14("daemon").description("Manage the trace-mcp background daemon");
 daemonCommand.command("start").description("Start the daemon (installs launchd plist and loads it)").option("-p, --port <port>", "Port to listen on", String(DEFAULT_DAEMON_PORT)).action(async (opts) => {
   const port = parseInt(opts.port, 10);
   if (process.platform !== "darwin") {
@@ -121085,7 +121154,7 @@ var ProjectManager = class {
 
 // src/cli.ts
 init_global();
-var PKG_VERSION2 = true ? "1.16.1" : "0.0.0-dev";
+var PKG_VERSION2 = true ? "1.18.0" : "0.0.0-dev";
 function registerDefaultPlugins2(registry) {
   for (const p5 of createAllLanguagePlugins()) registry.registerLanguagePlugin(p5);
   for (const p5 of createAllIntegrationPlugins()) registry.registerFrameworkPlugin(p5);
@@ -121124,7 +121193,7 @@ function runFederationAutoSync2(projectRoot, config) {
     logger.warn({ error: e }, "Federation auto-sync failed (non-fatal)");
   }
 }
-var program = new Command14();
+var program = new Command15();
 program.name("trace-mcp").description("Framework-Aware Code Intelligence for Laravel/Vue/Inertia/Nuxt").version(PKG_VERSION2, "-v, --version");
 program.command("serve").description("Start MCP server (stdio transport)").action(async () => {
   const projectRoot = process.cwd();
@@ -122213,6 +122282,7 @@ program.addCommand(analyticsCommand);
 program.addCommand(statusCommand);
 program.addCommand(visualizeCommand);
 program.addCommand(daemonCommand);
+program.addCommand(installAppCommand);
 program.parse();
 /*! Bundled license information: