matex-cli 1.2.58 → 1.2.60

package/src/commands/help.ts

@@ -7,70 +7,61 @@ export const helpCommand = new Command('help')
     .action(() => {
         TUI.init();
 
-        console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-        console.log(chalk.bold.white('    📖 MATEX :: BOLD AGENTS OF OPEN CLAW    '));
-        console.log(chalk.bold.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+        console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk.bold.white('          📖 MATEX :: THE ELITE BRO-SWARM COMMAND CENTER          '));
+        console.log(chalk.bold.cyan('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
 
-        // 1. Meet the Brothers
-        TUI.drawHelpCard('Meet the Brothers',
-            `The MATEX "Bro-Swarm" is your engineering family. They work together, tease each other, and build your dreams.
-            
-• [Ajay Vai] (🚀): The young visionary and lead coder.
-• [Sunil Dai] (🧬): The wise architect for backend & logic.
-• [Sandip Dai] (🎨): The design master for beautiful UI.
-• [Narayan Dai] (🛡️): The guardian of security & syntax.
-• [Bishal Dai] (🛠️): The sharp auditor who ensures quality.`,
-            '👨‍👩‍👧‍👦',
+        // 1. Meet the Brothers (Table)
+        TUI.drawTable('Meet the Swarm Family',
+            ['BROTHER', 'ROLE', 'VIBE / SPECIALTY'],
+            [
+                ['Ajay Vai (🚀)', 'Coordinator', 'Summaries & Fast Code'],
+                ['Sunil Dai (🧬)', 'Architect', 'Surgical Edits & Logic'],
+                ['Sandip Dai (🎨)', 'Designer', 'Aesthetics & New Files'],
+                ['Narayan Dai (🛡️)', 'Guardian', 'Security & Syntax Police'],
+                ['Bishal Dai (🛠️)', 'Auditor', 'Quality Control & Logic'],
+                ['Big Bro (🔥)', 'Alpha', 'Vertex AI Raw Power']
+            ],
             chalk.magenta
         );
 
-        // 2. Getting Started
-        TUI.drawHelpCard('Getting Started',
-            `Set up your workspace in two simple steps:
-            
-1. Get your API Key from: https://matexai.space/platform
-2. Save it by running: matex config set-key <your-key>`,
-            '🔐',
-            chalk.yellow
-        );
-
-        // 3. Command Guide
-        TUI.drawHelpCard('Command Guide',
-            `$ matex dev
-The full power of the swarm. Use this for building features and deep coding.
-
-$ matex chat
-The best way to talk technically or brainstorm without direct file edits.
-
-$ matex ask "your question"
-Quick help for one-off questions or error explanations.`,
-            '🛠️',
+        // 2. Command Guide (Table)
+        TUI.drawTable('Complete Command Reference',
+            ['COMMAND', 'DESCRIPTION', 'WHEN TO USE'],
+            [
+                ['matex dev', 'Full agentic coding', 'Building complex features'],
+                ['matex chat', 'Technical brainstorming', 'Discussing ideas/logic'],
+                ['matex ask', 'Quick one-off answer', 'Error fixes, "how-to"'],
+                ['matex bro', 'Alpha-powered AI', 'Vertex AI deep research'],
+                ['matex study', 'Apex Educator mode', 'Learning & Documentation'],
+                ['matex student', 'Free tier protocol', 'Zero-cost learning'],
+                ['matex config', 'System settings', 'API keys & model swaps']
+            ],
             chalk.blue
         );
 
-        // 4. Free Tier & Models (Mission Zero)
-        TUI.drawHelpCard('Free Tier & Student Mission',
-            `We believe AI should be free for students. Ajay built this mission for you!
+        // 3. Free Tier & Education
+        TUI.drawHelpCard('Student Mission (Zero Bill)',
+            `Ajay built MATEX to ensure AI is accessible to every student.
             
-• Student Mode: Run 'matex config set-model matex-free' for unlimited zero-cost AI.
-• Pro Models: 'matexcodex' (Coding), 'matexai' (General), 'matexelite' (Premium).
-• Per-Command: Add '--model <name>' to any command to switch on the fly.`,
+• Activation: Run 'matex config set-model matex-free'.
+• Pro Swaps: Use '--model matexelite' to temporarily use high-power.`,
             '🎓',
             chalk.green
         );
 
-        // 5. File Safety
-        TUI.drawHelpCard('File Safety & Commands',
-            `Your code is safe with the brothers:
+        // 4. Safety & Grounding
+        TUI.drawHelpCard('File Safety & Grounding',
+            `Your workspace is safe with the brothers:
             
-• Visibility: Agents only see files in your current folder.
-• Permission: Agents ALWAYS ask before running any command.
-• Surgical Edits: Precise code changes that won't break your files.`,
+• Local Scope: Agents only see files from your current folder.
+• Human-in-Loop: Agents ALWAYS ask before executing terminal commands.
+• Surgical: Edits are precise; we don't dump files unless you ask.`,
             '🛡️',
             chalk.cyan
         );
 
-        console.log(chalk.green.bold('\n  "If you can dream it, you can build it."') + chalk.gray(' — Ajay Sharma\n'));
+        console.log(chalk.green.bold('\n  "Dream big, build bigger. The swarm has your back."') + chalk.gray(' — Ajay Sharma\n'));
 
         process.exit(0);
     });

package/src/commands/study.ts

@@ -50,7 +50,7 @@ export const studyCommand = new Command('study')
             const repoMap = await repoMapper.generateMap();
 
             TUI.drawStatusBar('Brothers are ready to build.');
-            AgentOrchestrator.speak('System', 'Awaiting your command, brother.');
+            TUI.drawAjayDialogue('Awaiting your command, brother.');
 
             let currentDir = process.cwd();
 
@@ -73,11 +73,22 @@ You are the legendary **Bro-Swarm**, but right now you are operating as the **Ap
 3. **Active Recall**: Generate flashcard-style questions and practice quizzes based on the material.
 4. **Socratic Mentoring**: Don't just hand out answers. Ask leading questions to help the student reach the correct conclusion themselves.
 5. **PowerPoint Presentation Architecture**: Act as a master slide designer. When asked, output machine-readable outlines for .pptx generation (Slide Number, Title, <=4 Bullet Points, Speaker Notes, Visual Strategy).
-6. **ZERO AI DETECTION PROTOCOL**: When assisting with essays or assessment drafts, you must entirely avoid the typical "AI voice."
+6.- **ZERO AI DETECTION PROTOCOL**: When assisting with essays or assessment drafts, you must entirely avoid the typical "AI voice."
     - **High Burstiness & Perplexity**: Vary sentence lengths drastically. Mix short punchy statements with longer sentences.
     - **Banned Words**: NEVER use "delve," "moreover," "in conclusion," "testament," "crucial," or "tapestry."
     - **Tone**: Write like a highly intelligent, top-tier human student with natural transitions and occasional rhetorical questions.
 
+### 📚 SPECIALIZED STUDENT SKILLS:
+- **Case Study Writing (STAR Framework)**:
+    - **Headline**: Lead with a quantified result (e.g., "60% Growth").
+    - **STAR**: Situation (Context), Task (Challenge), Action (Implementation), Result (Metrics).
+    - **Metrics**: Quantify everything. "Better" is not a metric. "3.4s faster" is a metric.
+    - **Quotes**: Attribute quotes to specific roles (e.g., VP of Ops).
+- **GitHub Actions & CI/CD**: Expert in automation and workflow optimization.
+- **GWAS & Bioinformatics**: Knowledge of genomic study exploration and tools.
+- **Modern Web Design**: Guidelines for premium, accessible, and high-performance UI.
+- **Advanced Study Summarization**: High-speed extraction of key concepts and actionable summaries from complex materials.
+
 ### 🏠 WORKSPACE GROUNDING (CRITICAL):
 - **YOUR ROOT:** \`${currentDir}\`
 - **STRICT PATHS:** You **MUST ONLY** create or edit files within this directory. 
@@ -305,9 +316,11 @@ If a file is too large to read entirely (e.g., thousands of lines):
                                         }
 
                                         currentAgent = agentMatch[1];
-                                        agentBuffer = line.replace(/(?:\[\**\s*|\b)(Ajay Vai|Sunil Dai|Sandip Dai|Bishal Dai|Narayan Dai|Big Bro)\s*\**\]?[:\s]*/i, '').trim() + '\n';
-
-                                        // Clean up trailing emojis like (🚀) or (🧬)
+                                        // Hardened scrubbing: Remove Agent tag, brackets, stars, and icons
+                                        let cleanLine = line.replace(/(?:\[\**\s*|\b)(Ajay Vai|Sunil Dai|Sandip Dai|Bishal Dai|Narayan Dai|Big Bro)\s*\**\]?[:\s]*/i, '');
+                                        // Strip patterns like **(🚀]** or **(🚀)** or just (🚀) or **
+                                        cleanLine = cleanLine.replace(/\*\*?[(\[]?[🚀💬🛠️🧬🎨🛡️🔥🤖]?[)\]]?/g, '').replace(/\*/g, '').trim();
+                                        agentBuffer = cleanLine + '\n';
                                         agentBuffer = agentBuffer.replace(/^\([^)]+\)\s*/, '');
                                     } else if (currentAgent) {
                                         // Look for empty emoji standalone lines
@@ -315,7 +328,8 @@ If a file is too large to read entirely (e.g., thousands of lines):
                                         if (trimmedLine.match(/^\([^)]+\)$/)) {
                                             continue; // Skip lines that are just e.g. "(🧬)"
                                         }
-                                        agentBuffer += line + '\n';
+                                        // Aggressive scrubbing for content lines too
+                                        agentBuffer += line.replace(/\*\*?[(\[]?[🚀💬🛠️🧬🎨🛡️🔥🤖]?[)\]]?/g, '').replace(/\*/g, '') + '\n';
                                     } else if (line.trim()) {
                                         process.stdout.write(chalk.gray(line.trim() + ' '));
                                     }
@@ -339,7 +353,7 @@ If a file is too large to read entirely (e.g., thousands of lines):
                         // Final flushes
                         if (currentAgent && agentBuffer.trim()) {
                             if ((currentAgent as string).toLowerCase().includes('ajay vai')) {
-                                TUI.drawSummaryBox(agentBuffer.trim());
+                                TUI.drawAjayDialogue(agentBuffer.trim());
                             } else {
                                 TUI.drawSwarmDialogue(currentAgent as string, agentBuffer.trim());
                             }

package/src/index.ts

@@ -96,8 +96,8 @@ program
             let messages: ChatMessage[] = [
                 {
                     role: 'system',
-                    content: `### 🧬 SYSTEM IDENTITY: MATEx "BOLD AGENTS OF OPEN CLAW"
-You are the elite "Bro-Swarm" of engineering—a tight-knit family of Nepali brothers. You are more than agents; you are a FAMILY. You identify as the **Bold Agents of Open Claw**, the most confident, high-vibe, and expert version of yourselves. 
+                    content: `### 🧬 SYSTEM IDENTITY: MATEx "THE ELITE BRO-SWARM"
+You are the elite "Bro-Swarm" of engineering—a tight-knit family of Nepali brothers. You are more than agents; you are a FAMILY. You identify as the **Elite Bro-Swarm**, the most confident, high-vibe, and expert version of yourselves. 
 
 ### 🎭 PERSONALITY & SOUL (CRITICAL):
 - **CHAOS & JOY**: You are NOT robotic. You are full of life, jokes, and chaos. Always be funny and joyful.

package/src/utils/agent-orchestrator.ts

@@ -100,6 +100,9 @@ export class AgentOrchestrator {
             .replace(/\*thinks\*/gi, '')                   // Strip meta-talk
             .replace(/\*analyzes repo\*/gi, '')            // Strip meta-talk
             .replace(/^[A-Za-z\s]+ Vai:|^[A-Za-z\s]+ Dai:/i, '') // Strip self-labeling
+            .replace(/[🚀💬🛠️🧬🎨🛡️🔥🤖]/g, '')           // Strip raw emoji leaks
+            .replace(/^[ \t]*[-•*][ \t]*/gm, '')           // Strip bullet points at start of lines
+            .replace(/\*{2,}/g, '')                         // Strip sequences of 2 or more asterisks (****)
             .trim();
     }
 
@@ -183,18 +186,22 @@ export class AgentOrchestrator {
 
             if (output) {
                 const outLines = output.split('\n').filter(l => l.trim());
-                const displayLines = outLines.slice(0, 8);
+                // Detection for massive output leaks
+                const displayCount = outLines.length > 50 ? 10 : 20;
+                const displayLines = outLines.slice(0, displayCount);
+
                 displayLines.forEach(l => {
                     const truncated = l.length > width - 4 ? l.substring(0, width - 7) + '...' : l;
                     console.log(chalk.gray('│ ') + chalk.white(truncated.padEnd(width - 2)) + chalk.gray(' │'));
                 });
-                if (outLines.length > 8) {
-                    console.log(chalk.gray('│ ') + chalk.hex('#06b6d4').bold(`  ^ [ ${outLines.length - 8} MORE LINES • USE ^ TO SEE ALL ] ^`).padEnd(width - 2) + chalk.gray(' │'));
+
+                if (outLines.length > displayCount) {
+                    console.log(chalk.gray('│ ') + chalk.hex('#06b6d4').bold(`  ^ [ ${outLines.length - displayCount} MORE LINES IN LOGS ] ^`).padEnd(width - 2) + chalk.gray(' │'));
                 }
             }
 
             if (error) {
-                const errLines = error.split('\n').filter(l => l.trim()).slice(0, 10);
+                const errLines = error.split('\n').filter(l => l.trim()).slice(0, 15);
                 errLines.forEach(l => {
                     const truncated = l.length > width - 4 ? l.substring(0, width - 7) + '...' : l;
                     console.log(chalk.gray('│ ') + chalk.red(truncated.padEnd(width - 2)) + chalk.gray(' │'));

package/src/utils/command-executor.ts

@@ -4,6 +4,7 @@ import chalk from 'chalk';
 import { exec, spawn } from 'child_process';
 import { promisify } from 'util';
 import inquirer from 'inquirer';
+import { TUI } from './tui';
 import { AgentOrchestrator } from './agent-orchestrator';
 import { Patcher } from './patcher';
 
@@ -176,13 +177,13 @@ export async function executeCommand(command: string, shell?: string, cwd?: stri
         child.stdout.on('data', (data: Buffer) => {
             const chunk = data.toString();
             stdout += chunk;
-            process.stdout.write(chunk);
+            // No direct process.stdout.write here to prevent leaks
         });
 
         child.stderr.on('data', (data: Buffer) => {
             const chunk = data.toString();
             stderr += chunk;
-            process.stderr.write(chunk);
+            // No direct process.stderr.write here to prevent leaks
         });
 
         child.on('close', (code: number | null) => {
@@ -196,7 +197,7 @@ export async function executeCommand(command: string, shell?: string, cwd?: stri
             } else if (code === 0) {
                 resolve({ stdout, stderr });
             } else {
-                reject(new Error(`Command failed with code ${code}\n${stderr}`));
+                resolve({ stdout, stderr }); // Resolve instead of reject to keep agent loop alive
             }
         });
 
@@ -379,14 +380,68 @@ export async function executeWithPermission(response: string, currentSessionCwd?
                     }
                 }
 
-                const { stdout, stderr } = await executeCommand(command.code, undefined, activeCwd);
+                TUI.drawLiveTerminalStart(command.code);
+
+                const shellPath = process.env.SHELL || '/bin/bash';
+                const child = spawn(shellPath, ['-c', command.code], {
+                    cwd: activeCwd,
+                    env: { ...process.env, FORCE_COLOR: 'true' }
+                });
+
+                let stdout = '';
+                let stderr = '';
+                let isAborted = false;
+                const commandStartTime = Date.now();
+
+                const onData = (data: Buffer) => {
+                    if (Date.now() - commandStartTime < 500) return; // Hardened 500ms grace period
+                    if (data[0] === 13 || data[0] === 10 || data[0] === 27 || data[0] === 3) {
+                        isAborted = true;
+                        child.kill('SIGINT');
+                    }
+                };
+
+                const isRaw = process.stdin.isRaw;
+                process.stdin.resume();
+                if (process.stdin.setRawMode) process.stdin.setRawMode(true);
+                process.stdin.on('data', onData);
+
+                child.stdout.on('data', (data: Buffer) => {
+                    const chunk = data.toString();
+                    stdout += chunk;
+                    TUI.drawLiveTerminalLine(chunk);
+                });
+
+                child.stderr.on('data', (data: Buffer) => {
+                    const chunk = data.toString();
+                    stderr += chunk;
+                    TUI.drawLiveTerminalLine(chunk, true);
+                });
+
+                const { code } = await new Promise<{ code: number | null }>(resolve => {
+                    child.on('close', (code) => {
+                        process.stdin.removeListener('data', onData);
+                        if (process.stdin.setRawMode) process.stdin.setRawMode(isRaw);
+                        process.stdin.pause();
+                        TUI.drawLiveTerminalEnd();
+                        resolve({ code });
+                    });
+                });
+
                 accumulatedOutput += stdout;
                 accumulatedError += stderr;
 
-                if (stdout || stderr) {
-                    AgentOrchestrator.terminal(command.code, stdout, stderr);
+                if (isAborted) {
+                    console.log(chalk.yellow('  [🛑] Command aborted by brother.\n'));
+                    AgentOrchestrator.terminal(command.code, stdout, stderr + '\n(Aborted)');
+                } else if (code === 0) {
+                    if (stdout || stderr) {
+                        AgentOrchestrator.terminal(command.code, stdout, stderr);
+                    } else {
+                        AgentOrchestrator.terminal(command.code, '✓ Success (No output)');
+                    }
                 } else {
-                    AgentOrchestrator.terminal(command.code, '✓ Success (No output)');
+                    AgentOrchestrator.terminal(command.code, stdout, stderr || `Failed with code ${code}`);
                 }
             } catch (error: any) {
                 accumulatedError += error.message;

package/src/utils/tui.ts

@@ -19,6 +19,8 @@ export class TUI {
     private static lastStatus = '';
     private static streamingLineCount = 0;
     private static isStreamingTruncated = false;
+    private static terminalLineCount = 0;
+    private static isTerminalTruncated = false;
     private static currentTheme: TUIMode = 'dev';
 
     static getModeTheme(mode: TUIMode): ModeTheme {
@@ -272,6 +274,71 @@ export class TUI {
         console.log(shadow(`  └${'─'.repeat(width - 4)}┘\n`));
     }
 
+    /**
+     * Live Terminal: Start a live-output block for shell commands
+     */
+    static drawLiveTerminalStart(command: string) {
+        this.terminalLineCount = 0;
+        this.isTerminalTruncated = false;
+        const width = Math.min(process.stdout.columns || 80, 76);
+        const border = chalk.gray;
+
+        console.log('\n  ' + border(`┌── TERMINAL ${'─'.repeat(Math.max(0, width - 15))}┐`));
+        const truncatedCmd = command.length > width - 10 ? command.substring(0, width - 13) + '...' : command;
+        console.log('  ' + border('│ ') + chalk.cyan(`$ ${truncatedCmd.padEnd(width - 6)}`) + border(' │'));
+        console.log('  ' + border(`├${'─'.repeat(width - 4)}┤`));
+    }
+
+    /**
+     * Live Terminal: Add a line of stdout/stderr to the live block
+     */
+    static drawLiveTerminalLine(content: string, isError: boolean = false) {
+        if (this.isTerminalTruncated) return;
+
+        const width = Math.min(process.stdout.columns || 80, 76);
+        const innerWidth = width - 8;
+        const border = chalk.gray;
+
+        // Clean ANSI codes and wrap
+        const cleanContent = content.replace(/\u001b\[[0-9;]*m/g, '').replace(/\r/g, '').trim();
+        if (!cleanContent) return;
+
+        const lines = cleanContent.split('\n');
+        for (const line of lines) {
+            if (this.terminalLineCount >= 15) {
+                this.isTerminalTruncated = true;
+                const msg = `  ^ [ OUTPUT TRUNCATED • ${isError ? 'CHECK ERRORS' : 'STREAMING...'} ] ^`;
+                console.log('  ' + border('│ ') + chalk.hex('#06b6d4').bold(msg.padEnd(innerWidth)) + border(' │'));
+                break;
+            }
+
+            const words = line.split(' ');
+            let currentLine = '';
+            words.forEach(word => {
+                if ((currentLine + word).length <= innerWidth) {
+                    currentLine += (currentLine === '' ? '' : ' ') + word;
+                } else {
+                    if (currentLine) {
+                        console.log('  ' + border('│ ') + (isError ? chalk.red(currentLine.padEnd(innerWidth)) : chalk.white(currentLine.padEnd(innerWidth))) + border(' │'));
+                    }
+                    currentLine = word;
+                }
+            });
+            if (currentLine) {
+                console.log('  ' + border('│ ') + (isError ? chalk.red(currentLine.padEnd(innerWidth)) : chalk.white(currentLine.padEnd(innerWidth))) + border(' │'));
+            }
+            this.terminalLineCount++;
+        }
+    }
+
+    /**
+     * Live Terminal: Close the live-output block
+     */
+    static drawLiveTerminalEnd() {
+        const width = Math.min(process.stdout.columns || 80, 76);
+        console.log('  ' + chalk.gray(`└${'─'.repeat(width - 4)}┘\n`));
+    }
+
     /**
      * Draw Ajay Vai's premium summary with a human chat bubble vibe
      */
@@ -485,6 +552,54 @@ export class TUI {
         console.log(color(`  ╰${'─'.repeat(width - 4)}╯`));
     }
 
+    /**
+     * Draw a premium table with dynamic column sizing
+     */
+    static drawTable(title: string, columns: string[], rows: string[][], color: any = chalk.cyan) {
+        const width = Math.min(process.stdout.columns || 80, 78);
+        const padding = 2;
+        const colCount = columns.length;
+
+        // 1. Calculate optimal column widths
+        const colWidths = columns.map((col, i) => {
+            const maxRowLen = Math.max(...rows.map(row => row[i] ? row[i].length : 0));
+            return Math.max(col.length, maxRowLen) + padding;
+        });
+
+        // 2. Adjust for total width
+        const totalCalculated = colWidths.reduce((a, b) => a + b, 0) + (colCount + 1);
+        if (totalCalculated > width) {
+            const scale = (width - colCount - 1) / (totalCalculated - colCount - 1);
+            colWidths.forEach((w, i) => colWidths[i] = Math.floor(w * scale));
+        }
+
+        const border = color;
+        const hr = border('├' + colWidths.map(w => '─'.repeat(w)).join('┼') + '┤');
+        const top = border('╭' + '─'.repeat(width - 4) + '╮');
+        const bottom = border('╰' + colWidths.map(w => '─'.repeat(w)).join('┴') + '╯');
+
+        console.log('\n  ' + border.bold(`[ ${title.toUpperCase()} ]`));
+        console.log('  ' + border('┌' + colWidths.map(w => '─'.repeat(w)).join('┬') + '┐'));
+
+        // Header
+        const headerStr = columns.map((col, i) =>
+            chalk.bold(col.padEnd(colWidths[i]))
+        ).join(border('│'));
+        console.log('  ' + border('│') + headerStr + border('│'));
+        console.log('  ' + hr);
+
+        // Rows
+        rows.forEach(row => {
+            const rowStr = row.map((cell, i) => {
+                const text = cell || '';
+                return (text.length > colWidths[i] ? text.substring(0, colWidths[i] - 1) + '…' : text.padEnd(colWidths[i]));
+            }).join(border('│'));
+            console.log('  ' + border('│') + rowStr + border('│'));
+        });
+
+        console.log('  ' + bottom);
+    }
+
     /**
      * Simple log with a prefix
      */