md4ai 0.9.9 → 0.10.0

package/dist/index.bundled.js

@@ -887,20 +887,26 @@ var init_tooling_detector = __esm({
 import { readFile as readFile5 } from "node:fs/promises";
 import { join as join7 } from "node:path";
 import { homedir as homedir5 } from "node:os";
-async function resolveVercelToken() {
+async function resolveVercelTokenWithSource() {
   const creds = await loadCredentials();
-  if (creds?.vercelToken)
-    return creds.vercelToken;
+  if (creds?.vercelToken) {
+    return {
+      token: creds.vercelToken,
+      source: "md4ai-credentials",
+      sourcePath: join7(homedir5(), ".md4ai", "credentials.json")
+    };
+  }
   const possiblePaths = [
-    join7(homedir5(), ".config", "com.vercel.cli", "auth.json"),
-    join7(homedir5(), ".local", "share", "com.vercel.cli", "auth.json")
+    { path: join7(homedir5(), ".config", "com.vercel.cli", "auth.json"), source: "vercel-cli-config" },
+    { path: join7(homedir5(), ".local", "share", "com.vercel.cli", "auth.json"), source: "vercel-cli-local-share" }
   ];
-  for (const authPath of possiblePaths) {
+  for (const { path: authPath, source } of possiblePaths) {
     try {
       const data = await readFile5(authPath, "utf-8");
       const parsed = JSON.parse(data);
-      if (parsed.token)
-        return parsed.token;
+      if (parsed.token) {
+        return { token: parsed.token, source, sourcePath: authPath };
+      }
     } catch {
     }
   }
@@ -956,7 +962,21 @@ async function fetchVercelEnvVars(projectId, orgId, token) {
   });
   if (!res.ok) {
     const body = await res.text().catch(() => "");
-    throw new Error(`Vercel API ${res.status}: ${body.slice(0, 200)}`);
+    let errorCode = null;
+    let invalidToken = false;
+    try {
+      const parsed = JSON.parse(body);
+      errorCode = parsed.error?.code ?? null;
+      invalidToken = parsed.error?.invalidToken === true;
+    } catch {
+    }
+    if (invalidToken || res.status === 401) {
+      throw new VercelApiError("Token is invalid or expired", res.status, errorCode, true);
+    }
+    if (res.status === 403) {
+      throw new VercelApiError("Token lacks permission for this project/team", res.status, errorCode, false);
+    }
+    throw new VercelApiError(`Vercel API ${res.status}: ${body.slice(0, 200)}`, res.status, errorCode, false);
   }
   const data = await res.json();
   const envs = data.envs ?? [];
@@ -968,9 +988,22 @@ async function fetchVercelEnvVars(projectId, orgId, token) {
     // populated later by the scanner
   }));
 }
+var VercelApiError;
 var init_fetch_env_vars = __esm({
   "dist/vercel/fetch-env-vars.js"() {
     "use strict";
+    VercelApiError = class extends Error {
+      statusCode;
+      errorCode;
+      isInvalidToken;
+      constructor(message, statusCode, errorCode, isInvalidToken) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.isInvalidToken = isInvalidToken;
+        this.name = "VercelApiError";
+      }
+    };
   }
 });
 
@@ -1012,18 +1045,48 @@ async function scanEnvManifest(projectRoot) {
     checkedAt: (/* @__PURE__ */ new Date()).toISOString()
   };
 }
+function tokenSourceLabel(source) {
+  switch (source) {
+    case "md4ai-credentials":
+      return "md4ai credentials (~/.md4ai/credentials.json)";
+    case "vercel-cli-config":
+      return "Vercel CLI (~/.config/com.vercel.cli/auth.json)";
+    case "vercel-cli-local-share":
+      return "Vercel CLI (~/.local/share/com.vercel.cli/auth.json)";
+  }
+}
+function tokenFixInstructions(source) {
+  switch (source) {
+    case "md4ai-credentials":
+      return [
+        "Generate a new token at https://vercel.com/account/tokens",
+        "Then run: md4ai config set vercel-token <new-token>"
+      ];
+    case "vercel-cli-config":
+    case "vercel-cli-local-share":
+      return [
+        "Re-authenticate the Vercel CLI: npx vercel login",
+        "Ensure you log into the correct team account",
+        "Or set a dedicated token: md4ai config set vercel-token <token>"
+      ];
+  }
+}
 async function checkVercelEnvVars(projectRoot, variables) {
-  const token = await resolveVercelToken();
-  if (!token) {
+  const tokenResult = await resolveVercelTokenWithSource();
+  if (!tokenResult) {
     console.log(chalk8.dim("  Vercel checks skipped (no token configured)"));
+    console.log(chalk8.dim("    To enable: md4ai config set vercel-token <token>"));
+    console.log(chalk8.dim("    Generate a token at https://vercel.com/account/tokens"));
     return null;
   }
+  const { token, source } = tokenResult;
   const projects = await discoverVercelProjects(projectRoot);
   if (projects.length === 0)
     return null;
   console.log(chalk8.dim(`  Checking ${projects.length} Vercel project(s)...`));
   const discovered = [];
   const manifestVarNames = new Set(variables.map((v) => v.name));
+  let tokenErrorShown = false;
   for (const proj of projects) {
     try {
       const vars = await fetchVercelEnvVars(proj.projectId, proj.orgId, token);
@@ -1044,7 +1107,22 @@ async function checkVercelEnvVars(projectRoot, variables) {
       }
       console.log(chalk8.dim(`    ${proj.projectName}: ${vars.length} var(s)`));
     } catch (err) {
-      console.log(chalk8.yellow(`    ${proj.projectName}: ${err instanceof Error ? err.message : "API error"}`));
+      if (err instanceof VercelApiError && err.isInvalidToken && !tokenErrorShown) {
+        tokenErrorShown = true;
+        console.log(chalk8.red(`    ${proj.projectName}: Token is invalid or expired`));
+        console.log(chalk8.yellow(`      Token source: ${tokenSourceLabel(source)}`));
+        console.log(chalk8.yellow("      To fix:"));
+        for (const step of tokenFixInstructions(source)) {
+          console.log(chalk8.yellow(`        \u2192 ${step}`));
+        }
+      } else if (err instanceof VercelApiError && err.statusCode === 403) {
+        console.log(chalk8.yellow(`    ${proj.projectName}: ${err.message}`));
+        console.log(chalk8.dim(`      Token source: ${tokenSourceLabel(source)}`));
+        console.log(chalk8.dim("      Ensure the token has access to this team/project"));
+        console.log(chalk8.dim("      Check: https://vercel.com/account/tokens"));
+      } else {
+        console.log(chalk8.yellow(`    ${proj.projectName}: ${err instanceof Error ? err.message : "API error"}`));
+      }
     }
   }
   return discovered.length > 0 ? discovered : null;
@@ -1645,7 +1723,7 @@ var CURRENT_VERSION;
 var init_check_update = __esm({
   "dist/check-update.js"() {
     "use strict";
-    CURRENT_VERSION = true ? "0.9.9" : "0.0.0-dev";
+    CURRENT_VERSION = true ? "0.10.0" : "0.0.0-dev";
   }
 });
 
@@ -3825,30 +3903,122 @@ async function updateCommand(options) {
   spawnPostUpdate();
 }
 
+// dist/commands/start.js
+init_check_update();
+init_map();
+init_mcp_watch();
+import chalk23 from "chalk";
+import { resolve as resolve6 } from "node:path";
+async function fetchLatestVersion2() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5e3);
+    const res = await fetch("https://registry.npmjs.org/md4ai/latest", {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!res.ok)
+      return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewer3(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((pa[i] ?? 0) > (pb[i] ?? 0))
+      return true;
+    if ((pa[i] ?? 0) < (pb[i] ?? 0))
+      return false;
+  }
+  return false;
+}
+async function startCommand() {
+  const projectRoot = resolve6(process.cwd());
+  console.log("");
+  console.log(chalk23.bold.cyan(`  MD4AI v${CURRENT_VERSION}`));
+  console.log(chalk23.dim(`  ${projectRoot}`));
+  console.log("");
+  console.log(chalk23.blue("  \u2460 Checking for updates..."));
+  const latest = await fetchLatestVersion2();
+  if (latest && isNewer3(latest, CURRENT_VERSION)) {
+    console.log(chalk23.yellow(`     Update available: v${CURRENT_VERSION} \u2192 v${latest}`));
+    if (process.stdin.isTTY) {
+      const { confirm: confirm4 } = await import("@inquirer/prompts");
+      const wantUpdate = await confirm4({
+        message: `Install md4ai v${latest} now?`,
+        default: true
+      });
+      if (wantUpdate) {
+        const { execFileSync: execFileSync7 } = await import("node:child_process");
+        console.log(chalk23.blue("\n  Installing...\n"));
+        try {
+          execFileSync7("npm", ["install", "-g", "md4ai"], {
+            stdio: "inherit",
+            timeout: 6e4
+          });
+          console.log(chalk23.green("  Updated successfully."));
+          console.log(chalk23.dim("  Restarting with the new version...\n"));
+          const { spawn: spawn2 } = await import("node:child_process");
+          const child = spawn2("md4ai", ["start"], { stdio: "inherit", shell: false });
+          child.on("exit", (code) => process.exit(code ?? 0));
+          return;
+        } catch {
+          console.log(chalk23.yellow("  Update failed \u2014 continuing with current version.\n"));
+        }
+      } else {
+        console.log("");
+      }
+    } else {
+      console.log(chalk23.dim("     Run md4ai update to install it.\n"));
+    }
+  } else if (latest) {
+    console.log(chalk23.green("     You're on the latest version.\n"));
+  } else {
+    console.log(chalk23.dim("     Could not reach npm registry \u2014 skipping.\n"));
+  }
+  console.log(chalk23.blue("  \u2461 Scanning project files..."));
+  console.log("");
+  await mapCommand(projectRoot, {});
+  if (!process.stdin.isTTY) {
+    console.log(chalk23.dim("\n  Non-interactive mode \u2014 skipping MCP monitor."));
+    return;
+  }
+  console.log("");
+  console.log(chalk23.blue("  \u2462 Starting MCP monitor..."));
+  console.log("");
+  await mcpWatchCommand();
+}
+
 // dist/commands/config.js
 init_config();
-import chalk23 from "chalk";
+import chalk24 from "chalk";
 var ALLOWED_KEYS = ["vercel-token"];
 var KEY_MAP = {
   "vercel-token": "vercelToken"
 };
 async function configSetCommand(key, value) {
   if (!ALLOWED_KEYS.includes(key)) {
-    console.error(chalk23.red(`Unknown config key: ${key}`));
+    console.error(chalk24.red(`Unknown config key: ${key}`));
     console.log(`  Allowed keys: ${ALLOWED_KEYS.join(", ")}`);
     process.exit(1);
   }
   const credKey = KEY_MAP[key];
   await mergeCredentials({ [credKey]: value });
-  console.log(chalk23.green(`Saved ${key}.`));
+  console.log(chalk24.green(`Saved ${key}.`));
 }
 
 // dist/index.js
 init_check_update();
 var program = new Command();
 program.name("md4ai").description("MD4AI \u2014 Claude tooling visualiser").version(CURRENT_VERSION).addHelpText("after", `
-Update to the latest version:
-  md4ai update`);
+Quick start:
+  md4ai start    Check for updates, scan project, and start MCP monitoring
+  md4ai          Same as md4ai start (when run in a linked project folder)`);
+program.command("start").description("Check for updates, scan project, and start MCP monitoring \u2014 the all-in-one command").action(startCommand);
 program.command("login").description("Log in to MD4AI with email and password").action(loginCommand);
 program.command("logout").description("Log out and clear stored credentials").action(logoutCommand);
 program.command("status").description("Show login status, device count, folder count, last sync").action(statusCommand);
@@ -3871,9 +4041,13 @@ var admin = program.command("admin").description("Admin commands for managing th
 admin.command("update-tool").description("Add or update a tool in the master registry").requiredOption("--name <name>", "Canonical tool name (e.g. next, playwright)").option("--display <display>", 'Human-friendly display name (e.g. "Next.js")').option("--category <category>", "Tool category (framework|runtime|cli|mcp|package|database|other)").option("--stable <version>", "Latest stable version").option("--beta <version>", "Latest beta/RC version").option("--source <url>", "Source of truth URL for checking versions").option("--install <url>", "Download/install link").option("--notes <text>", "Compatibility notes or warnings").action(adminUpdateToolCommand);
 admin.command("list-tools").description("List all tools in the master registry").action(adminListToolsCommand);
 admin.command("fetch-versions").description("Fetch latest stable and beta versions from npm and GitHub").action(adminFetchVersionsCommand);
-program.parse();
-var ran = program.args[0];
-var skipAutoCheck = ["update", "check-update", "mcp-watch"];
-if (!skipAutoCheck.includes(ran)) {
-  autoCheckForUpdate();
+if (process.argv.length <= 2) {
+  void startCommand();
+} else {
+  program.parse();
+  const ran = program.args[0];
+  const skipAutoCheck = ["update", "check-update", "mcp-watch", "start"];
+  if (!skipAutoCheck.includes(ran)) {
+    autoCheckForUpdate();
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md4ai",
-  "version": "0.9.9",
+  "version": "0.10.0",
   "description": "CLI for MD4AI — scan Claude projects and sync to your dashboard",
   "type": "module",
   "bin": {