md4ai 0.10.3 → 0.10.4

package/README.md

@@ -1,100 +1,136 @@
-# md4ai
+<p align="center">
+  <strong><span style="color:#38bdf8">MD4</span>AI</strong><br/>
+  <em>See what Claude actually reads</em>
+</p>
 
-CLI for [MD4AI](https://www.md4ai.com) — scan your Claude Code projects and sync results to a web dashboard.
+<p align="center">
+  <a href="https://www.npmjs.com/package/md4ai"><img src="https://img.shields.io/npm/v/md4ai?color=38bdf8&label=npm" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/md4ai"><img src="https://img.shields.io/npm/dm/md4ai?color=10b981" alt="monthly downloads"></a>
+  <a href="https://github.com/Media-HQ-2-Ltd/MD4AI/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Media-HQ-2-Ltd/MD4AI" alt="licence"></a>
+  <a href="https://www.md4ai.com"><img src="https://img.shields.io/badge/dashboard-md4ai.com-38bdf8" alt="web dashboard"></a>
+</p>
 
-Discovers Claude configuration files, builds dependency graphs, detects orphans and broken references, catalogues skills and marketplace plugins, and pushes everything to a shared dashboard for team visibility.
+---
 
-## Installation
+Scan your Claude Code configuration, visualise the dependency graph, catch orphan files, and track software versions — across every device and every project.
+
+**Free for individual developers.** Teams get shared dashboards and invite-based collaboration.
+
+<p align="center">
+  <img src="https://www.md4ai.com/screenshots/project-overview.png" alt="MD4AI project dashboard" width="700"/>
+</p>
+
+## Why MD4AI?
+
+As your Claude Code setup grows — CLAUDE.md, skills, hooks, MCP servers, memory files, plan docs — it becomes hard to see the full picture. MD4AI scans everything and shows you:
+
+- **Dependency graph** — which files reference which, interactively
+- **Orphan detection** — config files nothing points to
+- **Broken references** — links to files that don't exist
+- **Skills catalogue** — project-specific, machine-wide, and marketplace plugins
+- **Stale files** — anything untouched for 90+ days
+- **Environment drift** — compare `.env`, Vercel, and GitHub Secrets
+- **Software versions** — frameworks and tools detected vs latest releases
+
+## Quick Start
 
 ```bash
 npm install -g md4ai
 ```
 
-Requires **Node.js 22** or later.
+> Requires **Node.js 22** or later. Works on **Windows (WSL2)**, **Linux**, and **macOS**.
 
-## Setup
+```bash
+# 1. Create an account at md4ai.com and set your API key
+export MD4AI_SUPABASE_ANON_KEY="your-anon-key"
 
-1. **Create an account** at [md4ai.com](https://www.md4ai.com) and create a project.
+# 2. Log in
+md4ai login
 
-2. **Set the Supabase key** in your shell profile:
+# 3. Link a project (get the ID from the dashboard URL)
+cd /path/to/your-claude-project
+md4ai link <project-id>
 
-   ```bash
-   export MD4AI_SUPABASE_ANON_KEY="your-anon-key"
-   ```
+# 4. That's it — your scan results are live at md4ai.com
+```
 
-3. **Log in:**
+Or scan without an account:
 
-   ```bash
-   md4ai login
-   ```
+```bash
+md4ai scan --offline    # generates output/index.html
+```
 
-4. **Link your project:**
+## What You Get
 
-   ```bash
-   cd /path/to/your-claude-project
-   md4ai link <project-id>
-   ```
+### Dependency Graph
 
-   The project ID is in the URL when viewing your project on the dashboard.
+See how your CLAUDE.md, skills, hooks, and config files connect. Search, zoom, and print wall sheets.
 
-## Commands
+<p align="center">
+  <img src="https://www.md4ai.com/screenshots/dependency-graph.png" alt="Dependency graph" width="600"/>
+</p>
 
-### Scanning & Syncing
+### Orphan Detection
 
-| Command | Description |
-|---------|-------------|
-| `md4ai scan [path]` | Scan a Claude project and push results to the dashboard. Defaults to current directory. |
-| `md4ai scan --offline` | Scan locally only — generates `output/index.html` without pushing to Supabase. |
-| `md4ai sync` | Re-push the most recent scan data for the current project. |
-| `md4ai sync --all` | Re-scan and sync all linked projects on this device. |
-| `md4ai link <project-id>` | Link the current directory to a dashboard project and run an initial scan. |
+Find configuration files not reachable from any root. Grouped by folder with modification dates.
 
-### Analysis
+<p align="center">
+  <img src="https://www.md4ai.com/screenshots/orphan-files.png" alt="Orphan files" width="600"/>
+</p>
 
-| Command | Description |
-|---------|-------------|
-| `md4ai simulate <prompt>` | Show which files Claude Code would load for a given prompt. |
-| `md4ai print <title>` | Generate a printable A3 wall-chart HTML with the dependency graph and skills table. |
-| `md4ai init-manifest` | Scaffold an `env-manifest.md` from detected `.env` files in the project. |
+### Skills Comparison
 
-### Account & Device Management
+Every skill and plugin at a glance — machine-wide vs project-specific, with current status.
+
+<p align="center">
+  <img src="https://www.md4ai.com/screenshots/skills-table.png" alt="Skills comparison" width="600"/>
+</p>
+
+### Software Versions
+
+Track detected tool versions compared against latest stable and beta releases.
+
+<p align="center">
+  <img src="https://www.md4ai.com/screenshots/software-versions.png" alt="Software versions" width="600"/>
+</p>
+
+## Commands
+
+### Scanning & Syncing
 
 | Command | Description |
 |---------|-------------|
-| `md4ai login` | Authenticate with email and password. |
-| `md4ai logout` | Clear stored credentials. |
-| `md4ai status` | Show login status, linked folders, and last sync time. |
-| `md4ai add-folder` | Create a new project folder on the dashboard. |
-| `md4ai add-device` | Add a device path to an existing project. |
-| `md4ai list-devices` | List all devices and their linked projects. |
+| `md4ai scan [path]` | Scan a Claude project and push results to the dashboard |
+| `md4ai scan --offline` | Scan locally — generates `output/index.html` without pushing |
+| `md4ai sync --all` | Re-scan and sync all linked projects on this device |
+| `md4ai link <project-id>` | Link cwd to a dashboard project and run initial scan |
 
-### Monitoring
+### Analysis
 
 | Command | Description |
 |---------|-------------|
-| `md4ai mcp-watch` | Monitor MCP server status on this device (runs until Ctrl+C, polls every 30s). |
+| `md4ai simulate <prompt>` | Show which files Claude would load for a given prompt |
+| `md4ai print <title>` | Generate a printable A3 wall-chart HTML |
+| `md4ai init-manifest` | Scaffold an `env-manifest.md` from detected `.env` files |
 
-### Other
+### Account & Devices
 
 | Command | Description |
 |---------|-------------|
-| `md4ai import <zipfile>` | Import an exported team bundle. |
-| `md4ai update` | Check for updates and install if available. |
-| `md4ai config set <key> <value>` | Set a configuration value (e.g. `vercel-token`). |
+| `md4ai login` | Authenticate with email and password |
+| `md4ai status` | Show login status, linked folders, and last sync |
+| `md4ai list-devices` | List all devices and their linked projects |
+| `md4ai mcp-watch` | Monitor MCP server status (runs until Ctrl+C) |
 
-## What Gets Scanned
+### One Command to Rule Them All
 
-Running `md4ai scan` discovers files in `.claude/`, `CLAUDE.md`, `skills.md`, and `docs/plans/`. It then:
+```bash
+md4ai start    # or just: md4ai
+```
 
-- **Builds a dependency graph** by parsing markdown links, bare file paths, `$CLAUDE_PROJECT_DIR` references, and JSON hook configurations.
-- **Detects orphans** — files not reachable from any root configuration.
-- **Finds broken references** — links pointing to files that don't exist on disk.
-- **Catalogues skills** — both project-specific and machine-wide, including marketplace plugins.
-- **Flags stale files** — anything not modified in over 90 days.
-- **Scans environment variables** — if an `env-manifest.md` is present, checks local `.env` files, Vercel, and GitHub Secrets for drift.
-- **Detects tooling** — frameworks, runtimes, and packages from `package.json` and MCP settings.
+Checks for updates, scans the current project, and starts MCP monitoring — all in one go.
 
-Scan output:
+## Scan Output
 
 ```
 Files found:   41
@@ -109,15 +145,6 @@ Plugins:       17 (17 skills)
 Data hash:     9868c4a8b50f...
 ```
 
-## File Locations
-
-| Item | Path |
-|------|------|
-| Credentials | `~/.md4ai/credentials.json` |
-| State | `~/.md4ai/state.json` |
-| Local scan preview | `output/index.html` (in scanned project) |
-| Print exports | `output/print-<timestamp>.html` |
-
 ## Web Dashboard
 
 All scan data syncs to [md4ai.com](https://www.md4ai.com) where you can:
@@ -129,16 +156,11 @@ All scan data syncs to [md4ai.com](https://www.md4ai.com) where you can:
 - Share projects with team members
 - Compare skills across machines
 
-## Tech Stack
-
-- **TypeScript** (strict, ESM)
-- **Commander** for CLI parsing
-- **Supabase** for auth and data storage
-- **esbuild** for bundling
-
 ## Support
 
-For questions, feedback, or bug reports: [richard@mediahq2.com](mailto:richard@mediahq2.com)
+Questions, feedback, or bugs: [richard@mediahq2.com](mailto:richard@mediahq2.com)
+
+Built by [Testate Technologies Ltd](https://www.md4ai.com) · [Changelog](https://www.md4ai.com/changelog)
 
 ## Licence
 

package/dist/index.bundled.js

@@ -9,6 +9,74 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// dist/check-update.js
+import chalk from "chalk";
+async function fetchLatest() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3e3);
+    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 printUpdateBanner(latest) {
+  console.log("");
+  console.log(chalk.yellow("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
+  console.log(chalk.yellow("\u2502") + chalk.bold("  Update available! ") + chalk.dim(`${CURRENT_VERSION}`) + chalk.white(" \u2192 ") + chalk.green.bold(`${latest}`) + "              " + chalk.yellow("\u2502"));
+  console.log(chalk.yellow("\u2502") + "                                              " + chalk.yellow("\u2502"));
+  console.log(chalk.yellow("\u2502") + "  Run: " + chalk.cyan("md4ai update") + "                          " + chalk.yellow("\u2502"));
+  console.log(chalk.yellow("\u2502") + "                                              " + chalk.yellow("\u2502"));
+  console.log(chalk.yellow("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
+  console.log("");
+}
+async function checkForUpdate() {
+  const latest = await fetchLatest();
+  if (!latest)
+    return;
+  if (latest !== CURRENT_VERSION && isNewer(latest, CURRENT_VERSION)) {
+    printUpdateBanner(latest);
+  } else {
+    console.log(chalk.green(`md4ai v${CURRENT_VERSION} \u2014 you're on the latest version.`));
+  }
+}
+async function autoCheckForUpdate() {
+  try {
+    const latest = await fetchLatest();
+    if (!latest)
+      return;
+    if (latest !== CURRENT_VERSION && isNewer(latest, CURRENT_VERSION)) {
+      printUpdateBanner(latest);
+    }
+  } catch {
+  }
+}
+function isNewer(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;
+}
+var CURRENT_VERSION;
+var init_check_update = __esm({
+  "dist/check-update.js"() {
+    "use strict";
+    CURRENT_VERSION = true ? "0.10.4" : "0.0.0-dev";
+  }
+});
+
 // ../packages/shared/dist/types.js
 var init_types = __esm({
   "../packages/shared/dist/types.js"() {
@@ -152,10 +220,10 @@ var login_exports = {};
 __export(login_exports, {
   loginCommand: () => loginCommand
 });
-import chalk from "chalk";
+import chalk2 from "chalk";
 import { input, password } from "@inquirer/prompts";
 async function loginCommand() {
-  console.log(chalk.blue("MD4AI Login\n"));
+  console.log(chalk2.blue("MD4AI Login\n"));
   const email = await input({ message: "Email:" });
   const pwd = await password({ message: "Password:" });
   const anonKey = getAnonKey();
@@ -165,7 +233,7 @@ async function loginCommand() {
     password: pwd
   });
   if (error) {
-    console.error(chalk.red(`Login failed: ${error.message}`));
+    console.error(chalk2.red(`Login failed: ${error.message}`));
     process.exit(1);
   }
   await saveCredentials({
@@ -175,7 +243,7 @@ async function loginCommand() {
     userId: data.user.id,
     email: data.user.email ?? email
   });
-  console.log(chalk.green(`
+  console.log(chalk2.green(`
 Logged in as ${data.user.email}`));
 }
 var init_login = __esm({
@@ -187,14 +255,14 @@ var init_login = __esm({
 });
 
 // dist/auth.js
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 import { confirm, input as input2, password as password2 } from "@inquirer/prompts";
 async function getAuthenticatedClient() {
   const creds = await loadCredentials();
   const needsLogin = !creds?.accessToken || Date.now() > creds.expiresAt;
   if (needsLogin) {
     const reason = !creds?.accessToken ? "Not logged in." : "Session expired.";
-    console.log(chalk4.yellow(`${reason}`));
+    console.log(chalk5.yellow(`${reason}`));
     const shouldLogin = await confirm({ message: "Would you like to log in now?" });
     if (!shouldLogin) {
       process.exit(0);
@@ -226,7 +294,7 @@ async function refreshSession() {
 async function getLongLivedClient() {
   const creds = await loadCredentials();
   if (!creds?.accessToken || !creds?.refreshToken) {
-    console.log(chalk4.yellow("Not logged in."));
+    console.log(chalk5.yellow("Not logged in."));
     const shouldLogin = await confirm({ message: "Would you like to log in now?" });
     if (!shouldLogin)
       process.exit(0);
@@ -243,7 +311,7 @@ async function getLongLivedClient() {
     });
     return { supabase: result.client, userId: result.userId };
   } catch {
-    console.log(chalk4.yellow("Session expired \u2014 please log in again."));
+    console.log(chalk5.yellow("Session expired \u2014 please log in again."));
     const shouldLogin = await confirm({ message: "Would you like to log in now?" });
     if (!shouldLogin)
       process.exit(0);
@@ -261,7 +329,7 @@ async function promptLogin() {
     password: pwd
   });
   if (error) {
-    console.error(chalk4.red(`Login failed: ${error.message}`));
+    console.error(chalk5.red(`Login failed: ${error.message}`));
     process.exit(1);
   }
   await saveCredentials({
@@ -271,7 +339,7 @@ async function promptLogin() {
     userId: data.user.id,
     email: data.user.email ?? email
   });
-  console.log(chalk4.green(`Logged in as ${data.user.email}
+  console.log(chalk5.green(`Logged in as ${data.user.email}
 `));
   const authedSupabase = createSupabaseClient(anonKey, data.session.access_token);
   return { supabase: authedSupabase, userId: data.user.id };
@@ -1082,7 +1150,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { join as join9, relative as relative2 } from "node:path";
 import { existsSync as existsSync4 } from "node:fs";
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 async function scanEnvManifest(projectRoot) {
   const manifestFullPath = join9(projectRoot, MANIFEST_PATH);
   if (!existsSync4(manifestFullPath)) {
@@ -1143,16 +1211,16 @@ function tokenFixInstructions(source) {
 async function checkVercelEnvVars(projectRoot, variables) {
   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"));
+    console.log(chalk9.dim("  Vercel checks skipped (no token configured)"));
+    console.log(chalk9.dim("    To enable: md4ai config set vercel-token <token>"));
+    console.log(chalk9.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)...`));
+  console.log(chalk9.dim(`  Checking ${projects.length} Vercel project(s)...`));
   const discovered = [];
   const manifestVarNames = new Set(variables.map((v) => v.name));
   let tokenErrorShown = false;
@@ -1174,23 +1242,23 @@ async function checkVercelEnvVars(projectRoot, variables) {
           mv.vercelStatus = {};
         mv.vercelStatus[proj.projectName] = vercelKeySet.has(mv.name) ? "present" : "missing";
       }
-      console.log(chalk8.dim(`    ${proj.projectName}: ${vars.length} var(s)`));
+      console.log(chalk9.dim(`    ${proj.projectName}: ${vars.length} var(s)`));
     } catch (err) {
       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:"));
+        console.log(chalk9.red(`    ${proj.projectName}: Token is invalid or expired`));
+        console.log(chalk9.yellow(`      Token source: ${tokenSourceLabel(source)}`));
+        console.log(chalk9.yellow("      To fix:"));
         for (const step of tokenFixInstructions(source)) {
-          console.log(chalk8.yellow(`        \u2192 ${step}`));
+          console.log(chalk9.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"));
+        console.log(chalk9.yellow(`    ${proj.projectName}: ${err.message}`));
+        console.log(chalk9.dim(`      Token source: ${tokenSourceLabel(source)}`));
+        console.log(chalk9.dim("      Ensure the token has access to this team/project"));
+        console.log(chalk9.dim("      Check: https://vercel.com/account/tokens"));
       } else {
-        console.log(chalk8.yellow(`    ${proj.projectName}: ${err instanceof Error ? err.message : "API error"}`));
+        console.log(chalk9.yellow(`    ${proj.projectName}: ${err instanceof Error ? err.message : "API error"}`));
       }
     }
   }
@@ -1229,16 +1297,16 @@ async function listGitHubSecretNames(repoSlug) {
 async function checkGitHubSecrets(projectRoot, variables) {
   const slug = await detectGitHubRepoSlug(projectRoot);
   if (!slug) {
-    console.log(chalk8.dim("  GitHub checks skipped (no GitHub remote detected)"));
+    console.log(chalk9.dim("  GitHub checks skipped (no GitHub remote detected)"));
     return null;
   }
   const secretNames = await listGitHubSecretNames(slug);
   if (!secretNames) {
-    console.log(chalk8.dim("  GitHub checks skipped (gh CLI not available or not authenticated)"));
+    console.log(chalk9.dim("  GitHub checks skipped (gh CLI not available or not authenticated)"));
     return slug;
   }
   const secretSet = new Set(secretNames);
-  console.log(chalk8.dim(`  GitHub secrets: ${secretNames.length} found in ${slug}`));
+  console.log(chalk9.dim(`  GitHub secrets: ${secretNames.length} found in ${slug}`));
   for (const v of variables) {
     if (v.requiredIn.github) {
       v.githubStatus = secretSet.has(v.name) ? "present" : "missing";
@@ -1803,74 +1871,6 @@ var init_html_generator = __esm({
   }
 });
 
-// dist/check-update.js
-import chalk9 from "chalk";
-async function fetchLatest() {
-  try {
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), 3e3);
-    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 printUpdateBanner(latest) {
-  console.log("");
-  console.log(chalk9.yellow("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510"));
-  console.log(chalk9.yellow("\u2502") + chalk9.bold("  Update available! ") + chalk9.dim(`${CURRENT_VERSION}`) + chalk9.white(" \u2192 ") + chalk9.green.bold(`${latest}`) + "              " + chalk9.yellow("\u2502"));
-  console.log(chalk9.yellow("\u2502") + "                                              " + chalk9.yellow("\u2502"));
-  console.log(chalk9.yellow("\u2502") + "  Run: " + chalk9.cyan("md4ai update") + "                          " + chalk9.yellow("\u2502"));
-  console.log(chalk9.yellow("\u2502") + "                                              " + chalk9.yellow("\u2502"));
-  console.log(chalk9.yellow("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));
-  console.log("");
-}
-async function checkForUpdate() {
-  const latest = await fetchLatest();
-  if (!latest)
-    return;
-  if (latest !== CURRENT_VERSION && isNewer(latest, CURRENT_VERSION)) {
-    printUpdateBanner(latest);
-  } else {
-    console.log(chalk9.green(`md4ai v${CURRENT_VERSION} \u2014 you're on the latest version.`));
-  }
-}
-async function autoCheckForUpdate() {
-  try {
-    const latest = await fetchLatest();
-    if (!latest)
-      return;
-    if (latest !== CURRENT_VERSION && isNewer(latest, CURRENT_VERSION)) {
-      printUpdateBanner(latest);
-    }
-  } catch {
-  }
-}
-function isNewer(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;
-}
-var CURRENT_VERSION;
-var init_check_update = __esm({
-  "dist/check-update.js"() {
-    "use strict";
-    CURRENT_VERSION = true ? "0.10.3" : "0.0.0-dev";
-  }
-});
-
 // dist/commands/push-toolings.js
 async function pushToolings(supabase, folderId, toolings) {
   if (!toolings.length)
@@ -3116,28 +3116,71 @@ var init_mcp_watch = __esm({
 });
 
 // dist/index.js
-init_login();
 import { Command } from "commander";
 
+// dist/sentry.js
+init_check_update();
+import * as Sentry from "@sentry/node";
+var DSN = process.env.MD4AI_SENTRY_DSN;
+function initSentry() {
+  if (!DSN)
+    return;
+  Sentry.init({
+    dsn: DSN,
+    release: `md4ai-cli@${CURRENT_VERSION}`,
+    environment: process.env.NODE_ENV === "development" ? "development" : "production",
+    tracesSampleRate: 0,
+    beforeSend(event) {
+      if (event.exception?.values) {
+        for (const exc of event.exception.values) {
+          if (exc.stacktrace?.frames) {
+            for (const frame of exc.stacktrace.frames) {
+              if (frame.filename) {
+                const idx = frame.filename.indexOf("md4ai");
+                if (idx >= 0)
+                  frame.filename = frame.filename.slice(idx);
+              }
+            }
+          }
+        }
+      }
+      return event;
+    }
+  });
+}
+function captureException2(err) {
+  if (!DSN)
+    return;
+  Sentry.captureException(err);
+}
+async function flushSentry() {
+  if (!DSN)
+    return;
+  await Sentry.flush(2e3);
+}
+
+// dist/index.js
+init_login();
+
 // dist/commands/logout.js
 init_config();
-import chalk2 from "chalk";
+import chalk3 from "chalk";
 async function logoutCommand() {
   await clearCredentials();
-  console.log(chalk2.green("Logged out successfully."));
+  console.log(chalk3.green("Logged out successfully."));
 }
 
 // dist/commands/status.js
 init_dist();
 init_config();
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 async function statusCommand() {
   const creds = await loadCredentials();
   if (!creds?.accessToken) {
-    console.log(chalk3.yellow("Not logged in. Run: md4ai login"));
+    console.log(chalk4.yellow("Not logged in. Run: md4ai login"));
     return;
   }
-  console.log(chalk3.blue("MD4AI Status\n"));
+  console.log(chalk4.blue("MD4AI Status\n"));
   console.log(`  User:    ${creds.email}`);
   console.log(`  Expires: ${new Date(creds.expiresAt).toLocaleString()}`);
   try {
@@ -3150,13 +3193,13 @@ async function statusCommand() {
     const state = await loadState();
     console.log(`  Last sync: ${state.lastSyncAt ?? "never"}`);
   } catch {
-    console.log(chalk3.yellow("  (Could not fetch remote data)"));
+    console.log(chalk4.yellow("  (Could not fetch remote data)"));
   }
 }
 
 // dist/commands/add-folder.js
 init_auth();
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 import { input as input3, select } from "@inquirer/prompts";
 async function addFolderCommand() {
   const { supabase, userId } = await getAuthenticatedClient();
@@ -3195,11 +3238,11 @@ async function addFolderCommand() {
     team_id: teamId
   }).select().single();
   if (error) {
-    console.error(chalk5.red(`Failed to create folder: ${error.message}`));
+    console.error(chalk6.red(`Failed to create folder: ${error.message}`));
     process.exit(1);
   }
   const teamLabel = teamId ? `(team: ${allTeams.get(teamId)})` : "(personal)";
-  console.log(chalk5.green(`
+  console.log(chalk6.green(`
 Folder "${name}" created ${teamLabel} (${data.id})`));
 }
 
@@ -3207,7 +3250,7 @@ Folder "${name}" created ${teamLabel} (${data.id})`));
 init_auth();
 import { resolve } from "node:path";
 import { hostname, platform } from "node:os";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import { input as input4, select as select2 } from "@inquirer/prompts";
 function detectOs() {
   const p = platform();
@@ -3228,14 +3271,14 @@ function suggestDeviceName() {
 async function addDeviceCommand() {
   const { supabase, userId } = await getAuthenticatedClient();
   const cwd = resolve(process.cwd());
-  console.log(chalk6.blue.bold("\n\u{1F4C2} Where is this Claude project?\n"));
+  console.log(chalk7.blue.bold("\n\u{1F4C2} Where is this Claude project?\n"));
   const localPath = await input4({
     message: "Local project path:",
     default: cwd
   });
   const { data: folders, error: foldersErr } = await supabase.from("claude_folders").select("id, name").order("name");
   if (foldersErr || !folders?.length) {
-    console.error(chalk6.red("No folders found. Run: md4ai add-folder"));
+    console.error(chalk7.red("No folders found. Run: md4ai add-folder"));
     process.exit(1);
   }
   const folderId = await select2({
@@ -3268,16 +3311,16 @@ async function addDeviceCommand() {
     description: description || null
   });
   if (error) {
-    console.error(chalk6.red(`Failed to add device: ${error.message}`));
+    console.error(chalk7.red(`Failed to add device: ${error.message}`));
     process.exit(1);
   }
-  console.log(chalk6.green(`
+  console.log(chalk7.green(`
 Device "${deviceName}" added to folder.`));
 }
 
 // dist/commands/list-devices.js
 init_auth();
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 async function listDevicesCommand() {
   const { supabase } = await getAuthenticatedClient();
   const { data: devices, error } = await supabase.from("device_paths").select(`
@@ -3285,11 +3328,11 @@ async function listDevicesCommand() {
       claude_folders!inner ( name )
     `).order("device_name");
   if (error) {
-    console.error(chalk7.red(`Failed to list devices: ${error.message}`));
+    console.error(chalk8.red(`Failed to list devices: ${error.message}`));
     process.exit(1);
   }
   if (!devices?.length) {
-    console.log(chalk7.yellow("No devices found. Run: md4ai add-device"));
+    console.log(chalk8.yellow("No devices found. Run: md4ai add-device"));
     return;
   }
   const grouped = /* @__PURE__ */ new Map();
@@ -3300,12 +3343,12 @@ async function listDevicesCommand() {
   }
   for (const [deviceName, entries] of grouped) {
     const first = entries[0];
-    console.log(chalk7.bold(`
-${deviceName}`) + chalk7.dim(` (${first.os_type})`));
+    console.log(chalk8.bold(`
+${deviceName}`) + chalk8.dim(` (${first.os_type})`));
     for (const entry of entries) {
       const folderName = entry.claude_folders?.name ?? "unknown";
       const synced = entry.last_synced ? new Date(entry.last_synced).toLocaleString() : "never";
-      console.log(`  ${chalk7.cyan(folderName)} \u2192 ${entry.path}`);
+      console.log(`  ${chalk8.cyan(folderName)} \u2192 ${entry.path}`);
       console.log(`    Last synced: ${synced}`);
     }
   }
@@ -4318,6 +4361,7 @@ 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);
+initSentry();
 if (process.argv.length <= 2) {
   void startCommand();
 } else {
@@ -4328,3 +4372,11 @@ if (process.argv.length <= 2) {
     autoCheckForUpdate();
   }
 }
+process.on("uncaughtException", async (err) => {
+  captureException2(err);
+  await flushSentry();
+  process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+  captureException2(reason);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "md4ai",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "CLI for MD4AI — scan Claude projects and sync to your dashboard",
   "type": "module",
   "bin": {
@@ -14,6 +14,7 @@
     "build": "tsc",
     "bundle": "node esbuild.config.js",
     "prepublishOnly": "pnpm build && pnpm bundle",
+    "test": "vitest run",
     "dev": "tsc --watch",
     "clean": "rm -rf dist"
   },
@@ -34,6 +35,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^8.3.0",
+    "@sentry/node": "^10.42.0",
     "@supabase/supabase-js": "^2.98.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
@@ -43,6 +45,7 @@
     "@md4ai/shared": "workspace:*",
     "@types/node": "^22.19.15",
     "esbuild": "^0.27.3",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
   }
 }