ai-mind-map 1.6.0 → 1.6.2

package/dist/change-tracker/change-log.js

@@ -46,109 +46,109 @@ export class ChangeLog {
     }
     // ----------------------------------------------------------- schema ---
     initSchema() {
-        this.db.exec(`
-      -- Sessions table
-      CREATE TABLE IF NOT EXISTS change_sessions (
-        session_id   TEXT PRIMARY KEY,
-        started_at   INTEGER NOT NULL,
-        ended_at     INTEGER,
-        total_changes INTEGER NOT NULL DEFAULT 0,
-        files_modified TEXT NOT NULL DEFAULT '[]',
-        summary      TEXT NOT NULL DEFAULT ''
-      );
-
-      -- Change records table
-      CREATE TABLE IF NOT EXISTS change_records (
-        id               INTEGER PRIMARY KEY AUTOINCREMENT,
-        file_path        TEXT NOT NULL,
-        change_type      TEXT NOT NULL,
-        old_path         TEXT,
-        summary          TEXT NOT NULL DEFAULT '',
-        symbols_affected TEXT NOT NULL DEFAULT '[]',
-        lines_added      INTEGER NOT NULL DEFAULT 0,
-        lines_removed    INTEGER NOT NULL DEFAULT 0,
-        timestamp        INTEGER NOT NULL,
-        session_id       TEXT NOT NULL,
-        FOREIGN KEY (session_id) REFERENCES change_sessions(session_id)
-          ON DELETE CASCADE
-      );
-
-      -- Indexes for common query patterns
-      CREATE INDEX IF NOT EXISTS idx_change_records_session
-        ON change_records(session_id);
-      CREATE INDEX IF NOT EXISTS idx_change_records_file
-        ON change_records(file_path);
-      CREATE INDEX IF NOT EXISTS idx_change_records_timestamp
-        ON change_records(timestamp);
-      CREATE INDEX IF NOT EXISTS idx_change_records_change_type
-        ON change_records(change_type);
-
-      -- FTS5 virtual table for full-text search across summaries and symbols
-      CREATE VIRTUAL TABLE IF NOT EXISTS change_records_fts USING fts5(
-        file_path,
-        summary,
-        symbols_affected,
-        content = 'change_records',
-        content_rowid = 'id',
-        tokenize = 'porter unicode61'
-      );
-
-      -- Triggers to keep FTS index in sync
-      CREATE TRIGGER IF NOT EXISTS trg_change_records_ai
-        AFTER INSERT ON change_records BEGIN
-          INSERT INTO change_records_fts(rowid, file_path, summary, symbols_affected)
-          VALUES (new.id, new.file_path, new.summary, new.symbols_affected);
-        END;
-
-      CREATE TRIGGER IF NOT EXISTS trg_change_records_ad
-        AFTER DELETE ON change_records BEGIN
-          INSERT INTO change_records_fts(change_records_fts, rowid, file_path, summary, symbols_affected)
-          VALUES ('delete', old.id, old.file_path, old.summary, old.symbols_affected);
-        END;
-
-      CREATE TRIGGER IF NOT EXISTS trg_change_records_au
-        AFTER UPDATE ON change_records BEGIN
-          INSERT INTO change_records_fts(change_records_fts, rowid, file_path, summary, symbols_affected)
-          VALUES ('delete', old.id, old.file_path, old.summary, old.symbols_affected);
-          INSERT INTO change_records_fts(rowid, file_path, summary, symbols_affected)
-          VALUES (new.id, new.file_path, new.summary, new.symbols_affected);
-        END;
+        this.db.exec(`
+      -- Sessions table
+      CREATE TABLE IF NOT EXISTS change_sessions (
+        session_id   TEXT PRIMARY KEY,
+        started_at   INTEGER NOT NULL,
+        ended_at     INTEGER,
+        total_changes INTEGER NOT NULL DEFAULT 0,
+        files_modified TEXT NOT NULL DEFAULT '[]',
+        summary      TEXT NOT NULL DEFAULT ''
+      );
+
+      -- Change records table
+      CREATE TABLE IF NOT EXISTS change_records (
+        id               INTEGER PRIMARY KEY AUTOINCREMENT,
+        file_path        TEXT NOT NULL,
+        change_type      TEXT NOT NULL,
+        old_path         TEXT,
+        summary          TEXT NOT NULL DEFAULT '',
+        symbols_affected TEXT NOT NULL DEFAULT '[]',
+        lines_added      INTEGER NOT NULL DEFAULT 0,
+        lines_removed    INTEGER NOT NULL DEFAULT 0,
+        timestamp        INTEGER NOT NULL,
+        session_id       TEXT NOT NULL,
+        FOREIGN KEY (session_id) REFERENCES change_sessions(session_id)
+          ON DELETE CASCADE
+      );
+
+      -- Indexes for common query patterns
+      CREATE INDEX IF NOT EXISTS idx_change_records_session
+        ON change_records(session_id);
+      CREATE INDEX IF NOT EXISTS idx_change_records_file
+        ON change_records(file_path);
+      CREATE INDEX IF NOT EXISTS idx_change_records_timestamp
+        ON change_records(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_change_records_change_type
+        ON change_records(change_type);
+
+      -- FTS5 virtual table for full-text search across summaries and symbols
+      CREATE VIRTUAL TABLE IF NOT EXISTS change_records_fts USING fts5(
+        file_path,
+        summary,
+        symbols_affected,
+        content = 'change_records',
+        content_rowid = 'id',
+        tokenize = 'porter unicode61'
+      );
+
+      -- Triggers to keep FTS index in sync
+      CREATE TRIGGER IF NOT EXISTS trg_change_records_ai
+        AFTER INSERT ON change_records BEGIN
+          INSERT INTO change_records_fts(rowid, file_path, summary, symbols_affected)
+          VALUES (new.id, new.file_path, new.summary, new.symbols_affected);
+        END;
+
+      CREATE TRIGGER IF NOT EXISTS trg_change_records_ad
+        AFTER DELETE ON change_records BEGIN
+          INSERT INTO change_records_fts(change_records_fts, rowid, file_path, summary, symbols_affected)
+          VALUES ('delete', old.id, old.file_path, old.summary, old.symbols_affected);
+        END;
+
+      CREATE TRIGGER IF NOT EXISTS trg_change_records_au
+        AFTER UPDATE ON change_records BEGIN
+          INSERT INTO change_records_fts(change_records_fts, rowid, file_path, summary, symbols_affected)
+          VALUES ('delete', old.id, old.file_path, old.summary, old.symbols_affected);
+          INSERT INTO change_records_fts(rowid, file_path, summary, symbols_affected)
+          VALUES (new.id, new.file_path, new.summary, new.symbols_affected);
+        END;
     `);
     }
     prepareStatements() {
-        this.stmtInsertChange = this.db.prepare(`
-      INSERT INTO change_records
-        (file_path, change_type, old_path, summary, symbols_affected,
-         lines_added, lines_removed, timestamp, session_id)
-      VALUES
-        (@filePath, @changeType, @oldPath, @summary, @symbolsAffected,
-         @linesAdded, @linesRemoved, @timestamp, @sessionId)
+        this.stmtInsertChange = this.db.prepare(`
+      INSERT INTO change_records
+        (file_path, change_type, old_path, summary, symbols_affected,
+         lines_added, lines_removed, timestamp, session_id)
+      VALUES
+        (@filePath, @changeType, @oldPath, @summary, @symbolsAffected,
+         @linesAdded, @linesRemoved, @timestamp, @sessionId)
     `);
-        this.stmtInsertSession = this.db.prepare(`
-      INSERT INTO change_sessions (session_id, started_at)
-      VALUES (@sessionId, @startedAt)
+        this.stmtInsertSession = this.db.prepare(`
+      INSERT INTO change_sessions (session_id, started_at)
+      VALUES (@sessionId, @startedAt)
     `);
-        this.stmtEndSession = this.db.prepare(`
-      UPDATE change_sessions
-      SET ended_at = @endedAt,
-          total_changes = (
-            SELECT COUNT(*) FROM change_records WHERE session_id = @sessionId
-          ),
-          files_modified = (
-            SELECT json_group_array(DISTINCT file_path)
-            FROM change_records WHERE session_id = @sessionId
-          ),
-          summary = @summary
-      WHERE session_id = @sessionId
+        this.stmtEndSession = this.db.prepare(`
+      UPDATE change_sessions
+      SET ended_at = @endedAt,
+          total_changes = (
+            SELECT COUNT(*) FROM change_records WHERE session_id = @sessionId
+          ),
+          files_modified = (
+            SELECT json_group_array(DISTINCT file_path)
+            FROM change_records WHERE session_id = @sessionId
+          ),
+          summary = @summary
+      WHERE session_id = @sessionId
     `);
-        this.stmtGetSession = this.db.prepare(`
-      SELECT * FROM change_sessions WHERE session_id = ?
+        this.stmtGetSession = this.db.prepare(`
+      SELECT * FROM change_sessions WHERE session_id = ?
     `);
-        this.stmtDeleteOldChanges = this.db.prepare(`
-      DELETE FROM change_records WHERE timestamp < ?
+        this.stmtDeleteOldChanges = this.db.prepare(`
+      DELETE FROM change_records WHERE timestamp < ?
     `);
-        this.stmtDeleteOldSessions = this.db.prepare(`
-      DELETE FROM change_sessions WHERE ended_at IS NOT NULL AND ended_at < ?
+        this.stmtDeleteOldSessions = this.db.prepare(`
+      DELETE FROM change_sessions WHERE ended_at IS NOT NULL AND ended_at < ?
     `);
     }
     // ----------------------------------------------------- sessions ------
@@ -271,11 +271,11 @@ export class ChangeLog {
         const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
         const limit = options.limit ?? 100;
         const offset = options.offset ?? 0;
-        const sql = `
-      SELECT * FROM change_records
-      ${where}
-      ORDER BY timestamp DESC
-      LIMIT @limit OFFSET @offset
+        const sql = `
+      SELECT * FROM change_records
+      ${where}
+      ORDER BY timestamp DESC
+      LIMIT @limit OFFSET @offset
     `;
         const rows = this.db.prepare(sql).all({ ...params, limit, offset });
         return rows.map(rowToFileChange);
@@ -307,15 +307,15 @@ export class ChangeLog {
         if (!sanitised)
             return [];
         try {
-            const sql = `
-        SELECT
-          cr.*,
-          bm25(change_records_fts, 1.0, 2.0, 1.5) AS rank
-        FROM change_records_fts fts
-        JOIN change_records cr ON cr.id = fts.rowid
-        WHERE change_records_fts MATCH @query
-        ORDER BY rank
-        LIMIT @limit
+            const sql = `
+        SELECT
+          cr.*,
+          bm25(change_records_fts, 1.0, 2.0, 1.5) AS rank
+        FROM change_records_fts fts
+        JOIN change_records cr ON cr.id = fts.rowid
+        WHERE change_records_fts MATCH @query
+        ORDER BY rank
+        LIMIT @limit
       `;
             const rows = this.db.prepare(sql).all({ query: sanitised, limit: maxResults });
             return rows.map((r) => ({
@@ -408,26 +408,26 @@ export class ChangeLog {
         const totalSessions = this.db.prepare('SELECT COUNT(*) AS cnt FROM change_sessions').get().cnt;
         const activeSessions = this.db.prepare('SELECT COUNT(*) AS cnt FROM change_sessions WHERE ended_at IS NULL').get().cnt;
         const mostChangedFiles = this.db
-            .prepare(`SELECT file_path AS filePath, COUNT(*) AS changeCount
-         FROM change_records
-         GROUP BY file_path
-         ORDER BY changeCount DESC
+            .prepare(`SELECT file_path AS filePath, COUNT(*) AS changeCount
+         FROM change_records
+         GROUP BY file_path
+         ORDER BY changeCount DESC
          LIMIT ?`)
             .all(topN);
         const mostActiveSessions = this.db
-            .prepare(`SELECT cs.session_id AS sessionId,
-                COUNT(cr.id) AS changeCount,
-                cs.started_at AS startedAt
-         FROM change_sessions cs
-         LEFT JOIN change_records cr ON cr.session_id = cs.session_id
-         GROUP BY cs.session_id
-         ORDER BY changeCount DESC
+            .prepare(`SELECT cs.session_id AS sessionId,
+                COUNT(cr.id) AS changeCount,
+                cs.started_at AS startedAt
+         FROM change_sessions cs
+         LEFT JOIN change_records cr ON cr.session_id = cs.session_id
+         GROUP BY cs.session_id
+         ORDER BY changeCount DESC
          LIMIT ?`)
             .all(topN);
         const lineStats = this.db
-            .prepare(`SELECT
-           COALESCE(SUM(lines_added), 0) AS linesAdded,
-           COALESCE(SUM(lines_removed), 0) AS linesRemoved
+            .prepare(`SELECT
+           COALESCE(SUM(lines_added), 0) AS linesAdded,
+           COALESCE(SUM(lines_removed), 0) AS linesRemoved
          FROM change_records`)
             .get();
         return {

package/dist/cli.js

@@ -50,10 +50,10 @@ const c = {
     gray: supportsColor ? '\x1b[90m' : '',
 };
 function success(msg) {
-    console.log(`${c.green}✔${c.reset} ${msg}`);
+    console.log(`${c.green}${c.reset} ${msg}`);
 }
 function error(msg) {
-    console.log(`${c.red}✖${c.reset} ${msg}`);
+    console.log(`${c.red}${c.reset} ${msg}`);
 }
 function info(msg) {
     console.log(`${c.blue}ℹ${c.reset} ${msg}`);
@@ -193,7 +193,7 @@ async function cmdServe() {
 /** ai-mind-map index <project-path> — Index a project */
 async function cmdIndex(args) {
     const projectPath = args.positional[0] || process.cwd();
-    heading('🗂️  Indexing Project');
+    heading('  Indexing Project');
     info(`Project: ${path.resolve(projectPath)}`);
     divider();
     const config = await resolveConfig(projectPath);
@@ -221,7 +221,7 @@ async function cmdIndex(args) {
         // Clear the progress line
         process.stdout.write('\r' + ' '.repeat(60) + '\r');
         const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
-        heading('📊 Index Results');
+        heading(' Index Results');
         divider();
         console.log(`  ${pad('Files scanned:', 20)} ${c.bold}${formatNum(stats.filesScanned)}${c.reset}`);
         console.log(`  ${pad('Files parsed:', 20)} ${c.bold}${formatNum(stats.filesParsed)}${c.reset}`);
@@ -260,7 +260,7 @@ async function cmdSearch(args) {
             results = results.filter((n) => n.type === typeFilter);
         }
         results = results.slice(0, limit);
-        heading(`🔍 Search Results for "${query}"`);
+        heading(` Search Results for "${query}"`);
         if (typeFilter)
             info(`Type filter: ${typeFilter}`);
         divider();
@@ -321,7 +321,7 @@ async function cmdTrace(args) {
             info('Try running "ai-mind-map index" first, or search with "ai-mind-map search".');
             return;
         }
-        heading(`🔗 Trace: ${symbolName}`);
+        heading(` Trace: ${symbolName}`);
         info(`Direction: ${direction} | Depth: ${depth}`);
         divider();
         for (const node of nodes) {
@@ -362,7 +362,7 @@ async function cmdTrace(args) {
             // Blast radius
             const blast = graph.blastRadius(node.id, depth);
             if (blast.length > 0) {
-                console.log(`\n  ${c.red}💥 Blast Radius${c.reset} (${blast.length} affected nodes):`);
+                console.log(`\n  ${c.red} Blast Radius${c.reset} (${blast.length} affected nodes):`);
                 for (const affected of blast.slice(0, 10)) {
                     console.log(`    ${c.yellow}⚡${c.reset} ${affected.qualifiedName} ` +
                         `${c.dim}(${affected.type})${c.reset}`);
@@ -385,7 +385,7 @@ async function cmdStructure(args) {
     const graph = openGraph(config);
     try {
         const overview = graph.getProjectOverview();
-        heading('🏗️  Project Structure');
+        heading('  Project Structure');
         info(`Project: ${config.projectRoot}`);
         divider();
         if (overview.size === 0) {
@@ -420,7 +420,7 @@ async function cmdStructure(args) {
 async function cmdStatus(args) {
     const projectPath = args.positional[0];
     const config = await resolveConfig(projectPath);
-    heading('📈 AI Mind Map Status');
+    heading(' AI Mind Map Status');
     info(`Project: ${config.projectRoot}`);
     info(`Database: ${config.dbPath}`);
     divider();
@@ -509,7 +509,7 @@ async function cmdRecall(args) {
     try {
         const memory = new PersistentMemory(db, config.memory);
         const results = memory.queryMemories({ text: query, limit });
-        heading(`🧠 Memory Recall: "${query}"`);
+        heading(` Memory Recall: "${query}"`);
         divider();
         if (results.length === 0) {
             warn('No memories found matching your query.');
@@ -582,7 +582,7 @@ async function cmdRemember(args) {
             tags,
             source: 'user',
         });
-        heading('💾 Memory Stored');
+        heading(' Memory Stored');
         divider();
         console.log(`  ${pad('ID:', 14)} ${c.bold}#${created.id}${c.reset}`);
         console.log(`  ${pad('Category:', 14)} ${getCategoryColor(created.category)}${created.category}${c.reset}`);
@@ -611,7 +611,7 @@ async function cmdDecisions(args) {
             status: statusFilter,
             limit: 50,
         });
-        heading('📋 Decision Log');
+        heading(' Decision Log');
         if (statusFilter)
             info(`Filter: status = ${statusFilter}`);
         divider();
@@ -646,7 +646,7 @@ async function cmdChanges(args) {
     const sinceRaw = typeof args.flags['since'] === 'string' ? args.flags['since'] : undefined;
     const limit = typeof args.flags['limit'] === 'string' ? parseInt(args.flags['limit'], 10) : 30;
     const config = await resolveConfig();
-    heading('📝 Change History');
+    heading(' Change History');
     divider();
     if (!existsSync(config.dbPath)) {
         warn('Database not found. Run "ai-mind-map index" first.');
@@ -707,7 +707,7 @@ async function cmdConfig(args) {
     const subCommand = args.positional[0] || 'list';
     if (subCommand === 'list') {
         const config = await resolveConfig();
-        heading('⚙️  Configuration');
+        heading('⚙  Configuration');
         divider();
         printConfigRecursive(config, '');
         divider();
@@ -767,7 +767,7 @@ function getNestedValue(obj, path) {
 }
 /** ai-mind-map sync — Sync local memories/decisions/rules with team-shared file */
 async function cmdSync(args) {
-    heading('🔄 Team Shared Context Synchronization');
+    heading(' Team Shared Context Synchronization');
     divider();
     const config = await loadConfig({
         projectRoot: args.flags['project-root'],
@@ -814,7 +814,7 @@ async function cmdSync(args) {
 }
 /** ai-mind-map update — Check for updates */
 async function cmdUpdate() {
-    heading('🔄 AI Mind Map — Update');
+    heading(' AI Mind Map — Update');
     divider();
     const currentVersion = getVersion();
     info(`Current version: ${c.bold}v${currentVersion}${c.reset}`);
@@ -837,7 +837,7 @@ async function cmdUpdate() {
     // 2. Compare versions
     if (currentVersion === latestVersion) {
         console.log('');
-        console.log(`  ${c.green}✔${c.reset} You are already on the latest version!`);
+        console.log(`  ${c.green}${c.reset} You are already on the latest version!`);
         console.log('');
         divider();
         return;
@@ -861,7 +861,7 @@ async function cmdUpdate() {
     const isNpx = process.argv[1]?.includes('_npx') || process.argv[1]?.includes('npm-cache');
     if (isNpx) {
         // npx always uses latest on next run
-        console.log(`  ${c.green}✔${c.reset} You're using npx — next run will automatically use v${latestVersion}`);
+        console.log(`  ${c.green}${c.reset} You're using npx — next run will automatically use v${latestVersion}`);
         info('To force a cache refresh now:');
         console.log(`\n  ${c.bold}npx -y ai-mind-map@latest install${c.reset}\n`);
     }
@@ -875,7 +875,7 @@ async function cmdUpdate() {
             console.log(`  ${c.dim}$ ${updateCmd}${c.reset}`);
             execSync(updateCmd, { stdio: 'inherit', timeout: 60_000 });
             console.log('');
-            console.log(`  ${c.green}✔${c.reset} Updated to v${latestVersion}!`);
+            console.log(`  ${c.green}${c.reset} Updated to v${latestVersion}!`);
         }
         catch (err) {
             warn('Auto-update failed. Update manually:');
@@ -903,75 +903,75 @@ async function cmdUpdate() {
     }
     console.log('');
     divider();
-    console.log(`  ${c.green}✔${c.reset} ${c.bold}Update complete!${c.reset} Restart your AI agent to use the new version.`);
+    console.log(`  ${c.green}${c.reset} ${c.bold}Update complete!${c.reset} Restart your AI agent to use the new version.`);
     console.log('');
 }
 /** ai-mind-map --help — Show help text */
 function showHelp() {
     const version = getVersion();
-    console.log(`
-${c.bold}${c.cyan}AI Mind Map${c.reset} ${c.dim}v${version}${c.reset}
-${c.dim}MCP server that reduces AI coding agent token usage by 80-99%.${c.reset}
-
-${c.bold}USAGE${c.reset}
-  ${c.cyan}ai-mind-map${c.reset} <command> [options]
-
-${c.bold}COMMANDS${c.reset}
-  ${c.cyan}serve${c.reset}                          Start MCP server (default)
-  ${c.cyan}index${c.reset} <project-path>            Index a project's codebase
-  ${c.cyan}search${c.reset} <query>                  Search the knowledge graph
-    ${c.dim}--type <type>                  Filter: func, class, method, etc.${c.reset}
-    ${c.dim}--limit <N>                    Max results (default: 20)${c.reset}
-  ${c.cyan}trace${c.reset} <symbol-name>             Trace symbol dependencies
-    ${c.dim}--direction <dir>              both, callers, or callees (default: both)${c.reset}
-    ${c.dim}--depth <N>                    Traversal depth (default: 3)${c.reset}
-  ${c.cyan}structure${c.reset} [<project-path>]      Show project structure overview
-  ${c.cyan}status${c.reset} [<project-path>]         Show index and memory stats
-  ${c.cyan}recall${c.reset} <query>                  Search stored memories
-  ${c.cyan}remember${c.reset} <content>              Store a new memory
-    ${c.dim}--category <cat>               Category (default: convention)${c.reset}
-    ${c.dim}--tags <tag1,tag2>             Comma-separated tags${c.reset}
-  ${c.cyan}decisions${c.reset}                       List architectural decisions
-    ${c.dim}--status <status>              Filter: active, superseded, reversed${c.reset}
-  ${c.cyan}changes${c.reset}                         Show change history
-    ${c.dim}--since <last_session|epoch>   Filter changes since timestamp${c.reset}
-    ${c.dim}--limit <N>                    Max results (default: 30)${c.reset}
-  ${c.cyan}sync${c.reset}                            Sync memories, decisions, and rules with shared file
-
-${c.bold}AGENT MANAGEMENT${c.reset}
-  ${c.cyan}install${c.reset}                         Auto-detect and configure AI agents
-  ${c.cyan}uninstall${c.reset}                       Remove agent configurations
-  ${c.cyan}update${c.reset}                          Check for updates + auto-update
-  ${c.cyan}doctor${c.reset}                          Run diagnostics check
-  ${c.cyan}doctor --fix${c.reset}                    Auto-repair broken configurations
-
-${c.bold}CONFIGURATION${c.reset}
-  ${c.cyan}config list${c.reset}                     Show current configuration
-  ${c.cyan}config set${c.reset} <key> <value>        Set a config value
-  ${c.cyan}config reset${c.reset} <key>              Reset a key to default
-
-${c.bold}OTHER${c.reset}
-  ${c.dim}--help, -h${c.reset}                       Show this help message
-  ${c.dim}--version, -v${c.reset}                    Show version
-
-${c.bold}EXAMPLES${c.reset}
-  ${c.dim}# Index current directory${c.reset}
-  ${c.cyan}ai-mind-map index .${c.reset}
-
-  ${c.dim}# Search for a function${c.reset}
-  ${c.cyan}ai-mind-map search "handleAuth" --type function${c.reset}
-
-  ${c.dim}# Trace who calls a function${c.reset}
-  ${c.cyan}ai-mind-map trace parseConfig --direction callers${c.reset}
-
-  ${c.dim}# Store a convention${c.reset}
-  ${c.cyan}ai-mind-map remember "Always use snake_case for DB columns" --category convention${c.reset}
-
-  ${c.dim}# Install MCP config for all detected agents${c.reset}
-  ${c.cyan}ai-mind-map install${c.reset}
-
-  ${c.dim}# Run diagnostics${c.reset}
-  ${c.cyan}ai-mind-map doctor${c.reset}
+    console.log(`
+${c.bold}${c.cyan}AI Mind Map${c.reset} ${c.dim}v${version}${c.reset}
+${c.dim}MCP server that reduces AI coding agent token usage by 80-99%.${c.reset}
+
+${c.bold}USAGE${c.reset}
+  ${c.cyan}ai-mind-map${c.reset} <command> [options]
+
+${c.bold}COMMANDS${c.reset}
+  ${c.cyan}serve${c.reset}                          Start MCP server (default)
+  ${c.cyan}index${c.reset} <project-path>            Index a project's codebase
+  ${c.cyan}search${c.reset} <query>                  Search the knowledge graph
+    ${c.dim}--type <type>                  Filter: func, class, method, etc.${c.reset}
+    ${c.dim}--limit <N>                    Max results (default: 20)${c.reset}
+  ${c.cyan}trace${c.reset} <symbol-name>             Trace symbol dependencies
+    ${c.dim}--direction <dir>              both, callers, or callees (default: both)${c.reset}
+    ${c.dim}--depth <N>                    Traversal depth (default: 3)${c.reset}
+  ${c.cyan}structure${c.reset} [<project-path>]      Show project structure overview
+  ${c.cyan}status${c.reset} [<project-path>]         Show index and memory stats
+  ${c.cyan}recall${c.reset} <query>                  Search stored memories
+  ${c.cyan}remember${c.reset} <content>              Store a new memory
+    ${c.dim}--category <cat>               Category (default: convention)${c.reset}
+    ${c.dim}--tags <tag1,tag2>             Comma-separated tags${c.reset}
+  ${c.cyan}decisions${c.reset}                       List architectural decisions
+    ${c.dim}--status <status>              Filter: active, superseded, reversed${c.reset}
+  ${c.cyan}changes${c.reset}                         Show change history
+    ${c.dim}--since <last_session|epoch>   Filter changes since timestamp${c.reset}
+    ${c.dim}--limit <N>                    Max results (default: 30)${c.reset}
+  ${c.cyan}sync${c.reset}                            Sync memories, decisions, and rules with shared file
+
+${c.bold}AGENT MANAGEMENT${c.reset}
+  ${c.cyan}install${c.reset}                         Auto-detect and configure AI agents
+  ${c.cyan}uninstall${c.reset}                       Remove agent configurations
+  ${c.cyan}update${c.reset}                          Check for updates + auto-update
+  ${c.cyan}doctor${c.reset}                          Run diagnostics check
+  ${c.cyan}doctor --fix${c.reset}                    Auto-repair broken configurations
+
+${c.bold}CONFIGURATION${c.reset}
+  ${c.cyan}config list${c.reset}                     Show current configuration
+  ${c.cyan}config set${c.reset} <key> <value>        Set a config value
+  ${c.cyan}config reset${c.reset} <key>              Reset a key to default
+
+${c.bold}OTHER${c.reset}
+  ${c.dim}--help, -h${c.reset}                       Show this help message
+  ${c.dim}--version, -v${c.reset}                    Show version
+
+${c.bold}EXAMPLES${c.reset}
+  ${c.dim}# Index current directory${c.reset}
+  ${c.cyan}ai-mind-map index .${c.reset}
+
+  ${c.dim}# Search for a function${c.reset}
+  ${c.cyan}ai-mind-map search "handleAuth" --type function${c.reset}
+
+  ${c.dim}# Trace who calls a function${c.reset}
+  ${c.cyan}ai-mind-map trace parseConfig --direction callers${c.reset}
+
+  ${c.dim}# Store a convention${c.reset}
+  ${c.cyan}ai-mind-map remember "Always use snake_case for DB columns" --category convention${c.reset}
+
+  ${c.dim}# Install MCP config for all detected agents${c.reset}
+  ${c.cyan}ai-mind-map install${c.reset}
+
+  ${c.dim}# Run diagnostics${c.reset}
+  ${c.cyan}ai-mind-map doctor${c.reset}
 `);
 }
 // ============================================================