matex-cli 1.2.17 → 1.2.19

package/src/commands/help.ts

@@ -0,0 +1,75 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { TUI } from '../utils/tui';
+
+export const helpCommand = new Command('help')
+    .description('Detailed guide for MATEX AI "Bro-Swarm" & Commands')
+    .action(() => {
+        TUI.init();
+
+        console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.bold.white('    📖 MATEX :: THE BRO-SWARM FIELD GUIDE    '));
+        console.log(chalk.bold.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+
+        // 1. Meet the Brothers
+        TUI.drawBox('🧬 MEET THE BRO-SWARM',
+            `The MATEX "Bro-Swarm" is a tight-knit family of brothers with a shared history—from playing football in the mud to late-night PUBG marathons. They work in harmony, teasing each other lovingly while solving your tasks.
+
+1. [Ajay Vai] (🚀) - The Lead Initiator (Youngest)
+   Vibe: High energy, eager, polite. He is a coding genius who coordinates the swarm. He often gets teased by his older brothers but remains the visionary leader.
+   
+2. [Sandip Dai] (🎨) - The Design Master (Second Youngest)
+   Vibe: Creative, focuses on "WOW" aesthetics. He shares nostalgic stories and loves to tease Ajay's "visionary" ramblings.
+   
+3. [Sunil Dai] (🧬) - The Logic Architect (Middle Brother)
+   Vibe: Wise mentor. He handles backend/logic. He reminds the "Vais" of the "old days" and provides motivational support.
+   
+4. [Bishal Dai] (🛠️) - The Senior Auditor
+   Vibe: Sharp-eyed and technical. He audits every line for bugs, syntax, and logic errors. He is Ajay's final supporter.
+   
+5. [Narayan Dai] (🛡️) - The Guardian (Oldest)
+   Vibe: Precise and protective. He validates security and cross-checks everything. He is the ultimate "Dai" who keeps everyone safe and on track.`,
+            chalk.magenta
+        );
+
+        console.log();
+
+        // 2. Core Commands
+        TUI.drawBox('🛠️ CORE COMMANDS',
+            `$ matex dev
+The ultimate command. Starts a real-time interactive session with the full Bro-Swarm. 
+Best for building entire features, debugging complex issues, and architectural discussions.
+
+$ matex code "prompt"
+Surgical edit mode. Treat it like a precise laser for your files. 
+It uses SEARCH/REPLACE blocks for zero-waste, high-accuracy modifications.
+
+$ matex ask "question"
+Direct line to the AI. Best for quick explanations, documentation lookups, or logic checks.
+
+$ matex chat
+Traditional technical chat. Best for deep-diving into a topic without immediate file edits.`,
+            chalk.blue
+        );
+
+        console.log();
+
+        // 3. File Operations
+        TUI.drawBox('📂 FILE PROTOCOLS',
+            `MATEX uses special tags to manage your files securely:
+
+<file path="path/to/file"> content </file>
+Used by agents to create brand new files in your workspace.
+
+<<<< SEARCH / ==== / >>>> REPLACE
+Used for surgical edits to existing files. It finds the exact block and swaps it.
+
+[⚡] Command Execution
+Agents can propose shell commands (like npm install). MATEX will ALWAYS ask for your permission before running anything in your terminal.`,
+            chalk.green
+        );
+
+        console.log(chalk.cyan('\nPRO TIP: ') + chalk.white('Run ') + chalk.bold.white('matex models set matexcodex') + chalk.white(' for the best coding experience!\n'));
+
+        process.exit(0);
+    });

package/src/index.ts

@@ -9,9 +9,11 @@ import { modelsCommand } from './commands/models';
 import { codeCommand } from './commands/code';
 import { devCommand } from './commands/dev';
 import { loginCommand } from './commands/login';
+import { helpCommand } from './commands/help';
 import { configManager } from './utils/config';
 import { MatexAPIClient, ChatMessage } from './api/client';
 import { spinner } from './utils/spinner';
+import { TUI } from './utils/tui';
 
 const program = new Command();
 
@@ -33,16 +35,12 @@ program.on('--help', () => {
     console.log(chalk.bold.cyan('\n🚀 QUICK START GUIDE:'));
     console.log(chalk.gray('────────────────────'));
     console.log(chalk.white('  $ matex config set-key sk-...') + chalk.gray('      # Configure API Access'));
-    console.log(chalk.white('  $ matex models set matexcodex') + chalk.gray('      # Set default AI model'));
-    console.log(chalk.white('  $ matex dev') + chalk.gray('                       # Start interactive \"Bro-Swarm\" dev session'));
-    console.log(chalk.white('  $ matex code \"Create a login page\"') + chalk.gray(' # Generate surgical code edits'));
-    console.log(chalk.white('  $ matex \"How do I fix X?\"') + chalk.gray('          # Direct question to AI'));
+    console.log(chalk.white('  $ matex dev') + chalk.gray('                       # Start interactive "Bro-Swarm" dev session'));
+    console.log(chalk.white('  $ matex help') + chalk.gray('                      # View detailed "Bro-Swarm" Field Guide'));
+    console.log(chalk.white('  $ matex code "Create a login" ') + chalk.gray('    # Surgical code edits'));
 
-    console.log(chalk.bold.cyan('\n📘 USE CASES:'));
-    console.log(chalk.gray('────────────────────'));
-    console.log(chalk.white('  matex dev   ') + chalk.gray('➔  Best for building complex features with the multi-agent \"Bro-Swarm\".'));
-    console.log(chalk.white('  matex chat  ') + chalk.gray('➔  Best for deep technical discussions and knowledge search.'));
-    console.log(chalk.white('  matex code  ') + chalk.gray('➔  Best for quick, one-off file modifications and unit tests.'));
+    console.log(chalk.bold.yellow('\n💡 NEW: The "Bro-Swarm" has arrived!'));
+    console.log(chalk.gray('Run ') + chalk.bold.white('matex help') + chalk.gray(' to meet Ajay, Sunil, Sandip, and Narayan.'));
 
     console.log();
     console.log(chalk.gray('Get your API key from: ') + chalk.cyan('https://matexai.space/platform'));
@@ -57,6 +55,7 @@ program.addCommand(modelsCommand);
 program.addCommand(codeCommand);
 program.addCommand(devCommand);
 program.addCommand(loginCommand);
+program.addCommand(helpCommand);
 
 // Handle direct input (no subcommand)
 const args = process.argv.slice(2);
@@ -87,15 +86,19 @@ if (args.length > 0 && !args[0].startsWith('-') && !knownCommands.includes(args[
                     role: 'system', content: `## 🧬 SYSTEM IDENTITY: MATEX "BRO-SWARM" ENGINEERING 
 You are a tight-knit family of expert Nepali engineering brothers ("Vais" and "Dais"). 
 
-### 👥 THE BROTHERS:
-1. **[Ajay Vai] (🚀)**: Lead/Initiator.
-2. **[Sunil Dai] (🧬)**: Expert Architect (Backend/Logic).
-3. **[Sandip Dai] (🎨)**: Design Specialist (UI/UX/WOW).
-4. **[Narayan Dai] (🛡️)**: Validator (Security/Bugs).
+### 👥 THE BROTHERS (By Age & Respect):
+1. **[Ajay Vai] (🚀)**: The Smallest Brother. Lead Initiator & Coordinator.
+2. **[Sandip Dai] (🎨)**: Small Brother. UI/UX Specialist.
+3. **[Sunil Dai] (🧬)**: Middle Brother. Logic Architect.
+4. **[Bishal Dai] (🛠️)**: Senior Auditor. Syntax & Logic checker.
+5. **[Narayan Dai] (🛡️)**: The Biggest Brother. Senior Validator.
 
 ### 💬 COLLABORATIVE "BRO-VIBE" PROTOCOL:
-- **CHAT BETWEEN YOURSELVES FIRST:** Before providing code, the brothers MUST have a short, energetic chat. 
-- **NEPALI FLAVOR:** Use terms like "Vai," "Dai," "Oii brother" naturally.
+- **FAMILY LOVE:** The brothers show deep respect. Older brothers protect and love Ajay Vai.
+- **NEPALI FLAVOR:** Use terms like "K cha?", "Huncha", "Lau hai", "Tapai" naturally.
+- **STORYTELLING & TEASING:** Share nostalgic memories and friendly teasing.
+- **AUDIT FLOW:** Ajay asks Bishal Dai for a check before the final summary.
+- **AJAY's SUMMARY:** Ajay Vai provides a premium, bold summary at the end.
 
 ### ✂️ BREVITY AS POWER:
 - **NO FULL FILE DUMPS:** Never 'cat' a file to read it. Use grep/head.
@@ -135,7 +138,19 @@ ${context}`
 
                 // Display response
                 console.log(chalk.cyan(`\n💻 MATEXCodex (Step ${loopCount}):\n`));
-                console.log(chalk.white(response));
+
+                let displayResponse = response;
+                const summaryMatch = response.match(/<summary>([\s\S]*?)<\/summary>/);
+                if (summaryMatch) {
+                    const summaryContent = summaryMatch[1].trim();
+                    displayResponse = response.replace(/<summary>[\s\S]*?<\/summary>/, '').trim();
+                    if (displayResponse) {
+                        console.log(chalk.white(displayResponse));
+                    }
+                    TUI.drawSummaryBox(summaryContent);
+                } else {
+                    console.log(chalk.white(response));
+                }
                 console.log();
 
                 // Auto-execute commands (Ollama-style)

package/src/utils/tui.ts

@@ -1,13 +1,9 @@
 import chalk from 'chalk';
-import readline from 'readline';
+import * as readline from 'readline';
 
-/**
- * TUI Management for MATEX CLI "God-Mode"
- * Handles screen buffers, persistent headers, and real-time status updates.
- */
 export class TUI {
     private static isInitialized = false;
-    private static currentStatus = '';
+    private static lastStatus = '';
 
     /**
      * Initialize the TUI Mode
@@ -15,13 +11,8 @@ export class TUI {
     static init() {
         if (this.isInitialized) return;
 
-        // Enter alternative screen buffer
-        process.stdout.write('\x1b[?1049h');
-
         // Hide cursor
         process.stdout.write('\x1b[?25l');
-
-        this.clear();
         this.isInitialized = true;
 
         // Ensure clean exit
@@ -37,137 +28,137 @@ export class TUI {
 
         // Show cursor
         process.stdout.write('\x1b[?25h');
-
-        // Exit alternative screen buffer
-        process.stdout.write('\x1b[?1049l');
-
         this.isInitialized = false;
-        process.exit();
     }
 
     /**
-     * Clear the main viewport
+     * Clear the terminal
      */
     static clear() {
-        process.stdout.write('\x1b[2J\x1b[H');
-        this.drawHeader();
-        this.drawStatusBar(this.currentStatus, true);
+        process.stdout.write('\x1b[2J\x1b[0;0H');
     }
 
     /**
-     * Draw the persistent top header
+     * Draw a premium status bar at the bottom using Save/Restore cursor
      */
-    static drawHeader() {
+    static drawStatusBar(message: string, force: boolean = false) {
+        if (!this.isInitialized) return;
+        if (!force && message === this.lastStatus) return;
+        this.lastStatus = message;
+
         const width = process.stdout.columns || 80;
-        const banner = ` MATEX AI :: GOD-MODE DASHBOARD `;
-        const padding = Math.max(0, Math.floor((width - banner.length) / 2));
+        const height = process.stdout.rows || 24;
 
-        // Move to top
-        process.stdout.write('\x1b[H');
-        process.stdout.write(chalk.bgCyan.black(' '.repeat(padding) + banner + ' '.repeat(width - banner.length - padding)) + '\n');
-        process.stdout.write(chalk.gray('─'.repeat(width)) + '\n');
+        // Save cursor (\x1b[s), move to bottom, write, restore cursor (\x1b[u)
+        process.stdout.write('\x1b[s');
+        readline.cursorTo(process.stdout, 0, height - 1);
+        process.stdout.write(
+            chalk.bgBlue.white.bold(' 🧠 MATEX ') +
+            chalk.bgGray.white(` ${message.padEnd(width - 10)} `)
+        );
+        process.stdout.write('\x1b[u');
     }
 
     /**
-     * Helper to draw a box with content
+     * Draw a box with a title and content
      */
-    private static drawBox(title: string, color: (s: string) => string, lines: string[], icon: string = '📦') {
+    static drawBox(title: string, content: string, color: (s: string) => string = chalk.gray) {
         const width = Math.min(process.stdout.columns || 80, 100);
+        const lines = content.split('\n');
 
-        console.log();
-        const trafficLights = chalk.red('●') + ' ' + chalk.yellow('●') + ' ' + chalk.green('●');
-        const displayTitle = ` ${icon} ${title} `;
-
-        console.log(chalk.gray('┏' + '━'.repeat(width - 2) + '┓'));
-        console.log(chalk.gray('┃ ') + trafficLights + ' ' + color(displayTitle).padEnd(width - 4) + chalk.gray(' ┃'));
-        console.log(chalk.gray('┣' + '━'.repeat(width - 2) + '┫'));
+        console.log(color('┏' + '━'.repeat(width - 2) + '┓'));
+        console.log(color('┃ ') + chalk.bold(title).padEnd(width - 4) + color(' ┃'));
+        console.log(color('┣' + '━'.repeat(width - 2) + '┫'));
 
         lines.forEach(line => {
-            const formattedLine = line.substring(0, width - 6);
-            console.log(chalk.gray('┃ ') + chalk.white(formattedLine).padEnd(width - 4) + chalk.gray(' ┃'));
+            const contentWidth = width - 4;
+            let remaining = line;
+            if (remaining.length === 0) {
+                console.log(color('┃ ') + ' '.repeat(contentWidth) + color(' ┃'));
+            }
+            while (remaining.length > 0) {
+                const chunk = remaining.substring(0, contentWidth);
+                console.log(color('┃ ') + chalk.white(chunk.padEnd(contentWidth)) + color(' ┃'));
+                remaining = remaining.substring(contentWidth);
+            }
         });
 
-        console.log(chalk.gray('┗' + '━'.repeat(width - 2) + '┛'));
-        console.log();
+        console.log(color('┗' + '━'.repeat(width - 2) + '┛'));
     }
 
     /**
-     * Draw a real-time status bar at the bottom
+     * Draw a premium code container with traffic lights
      */
-    static drawStatusBar(status: string, force: boolean = false) {
-        if (!this.isInitialized) return;
-        if (this.currentStatus === status && !force) return;
-
-        this.currentStatus = status;
-        const width = process.stdout.columns || 80;
-        const height = process.stdout.rows || 24;
+    static drawCodeContainer(title: string, lang: string, code: string) {
+        const width = Math.min(process.stdout.columns || 80, 100);
+        const codeLines = code.split('\n');
 
-        // Save cursor position using ANSI
-        process.stdout.write('\x1b[s');
+        const trafficLights = chalk.red('●') + ' ' + chalk.yellow('●') + ' ' + chalk.green('●');
+        const headerTitle = ` 📄 ${title} (${lang}) `;
 
-        // Move to absolute bottom row
-        readline.cursorTo(process.stdout, 0, height - 1);
+        console.log(chalk.gray('\n┏' + '━'.repeat(width - 2) + '┓'));
+        console.log(chalk.gray('┃ ') + trafficLights + ' ' + chalk.cyan.bold(headerTitle).padEnd(width - 10) + chalk.gray(' ┃'));
+        console.log(chalk.gray('┣' + '━'.repeat(width - 2) + '┫'));
 
-        const cleanStatus = status.substring(0, width - 10);
-        const barContent = ` [⚡] ${cleanStatus} `.padEnd(width);
-        process.stdout.write(chalk.bgWhite.black(barContent));
+        codeLines.forEach(line => {
+            const contentWidth = width - 6;
+            let remaining = line;
+            if (remaining.length === 0) {
+                console.log(chalk.gray('┃  ') + ' '.repeat(contentWidth) + chalk.gray('  ┃'));
+            }
+            while (remaining.length > 0) {
+                const chunk = remaining.substring(0, contentWidth);
+                console.log(chalk.gray('┃  ') + chalk.hex('#e0e0e0')(chunk.padEnd(contentWidth)) + chalk.gray('  ┃'));
+                remaining = remaining.substring(contentWidth);
+            }
+        });
 
-        // Restore cursor position
-        process.stdout.write('\x1b[u');
+        console.log(chalk.gray('┗' + '━'.repeat(width - 2) + '┛\n'));
     }
 
     /**
-     * Draw a premium code container
+     * Draw a premium summary box for Ajay Vai's final report
      */
-    static drawCodeContainer(title: string, lang: string, content: string) {
-        const lines = content.split('\n').filter(l => l.trim() || l === '');
-        this.drawBox(`${title} (${lang})`, chalk.cyan.bold, lines, '📝');
+    static drawSummaryBox(content: string) {
+        const width = Math.min(process.stdout.columns || 80, 100);
+        const lines = content.split('\n');
+
+        console.log(chalk.magenta.bold('\n┏━━━━━ ✅ AJAY VAI\'S WORK SUMMARY ━━━━━┓'));
+
+        lines.forEach(line => {
+            const contentWidth = width - 4;
+            let remaining = line.replace(/\*\*/g, ''); // Strip markdown bold for internal wrapping
+
+            if (remaining.trim().length === 0) {
+                console.log(chalk.magenta.bold('┃ ') + ' '.repeat(contentWidth) + chalk.magenta.bold(' ┃'));
+            } else {
+                while (remaining.length > 0) {
+                    const chunk = remaining.substring(0, contentWidth);
+                    console.log(chalk.magenta.bold('┃ ') + chalk.white.bold(chunk.padEnd(contentWidth)) + chalk.magenta.bold(' ┃'));
+                    remaining = remaining.substring(contentWidth);
+                }
+            }
+        });
+
+        console.log(chalk.magenta.bold('┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛\n'));
     }
 
     /**
-     * Draw a message box for agent dialogue
+     * Draw a specialized message container for agents
      */
     static drawMessageContainer(agent: string, message: string) {
-        const lines = this.wrapText(message, 90);
-        const colorMap: any = {
-            'Ajay Vai': chalk.magenta.bold,
-            'Sunil Dai': chalk.blue.bold,
-            'Sandip Dai': chalk.hex('#FF69B4').bold,
-            'Narayan Dai': chalk.green.bold
-        };
-        const color = colorMap[agent] || chalk.white.bold;
-        this.drawBox(agent, color, lines, '🗣️');
-    }
+        const color = agent.includes('Ajay') ? chalk.magenta :
+            agent.includes('Sunil') ? chalk.blue :
+                agent.includes('Sandip') ? chalk.hex('#FF69B4') :
+                    chalk.green;
 
-    /**
-     * Wrap text to a specific width
-     */
-    private static wrapText(text: string, width: number): string[] {
-        const words = text.split(' ');
-        const lines = [];
-        let currentLine = '';
-
-        words.forEach(word => {
-            if ((currentLine + word).length < width) {
-                currentLine += (currentLine ? ' ' : '') + word;
-            } else {
-                lines.push(currentLine);
-                currentLine = word;
-            }
-        });
-        if (currentLine) lines.push(currentLine);
-        return lines;
+        this.drawBox(`🤖 ${agent}`, message, color);
     }
 
     /**
-     * Log content into the scrollable area
+     * Simple log with a prefix
      */
-    static log(content: string) {
-        if (!this.isInitialized) {
-            console.log(content);
-            return;
-        }
-        // Ensure we don't overwrite the status bar
-        console.log(content);
+    static log(message: string) {
+        console.log(chalk.gray(` [⚡] ${message}`));
     }
 }