monoai 0.2.0

package/dist/commands/git-commit.js

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import { simpleGit } from 'simple-git';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+const git = simpleGit();
+export const gitCommitCommand = new Command('git-commit')
+    .description('Sync local codebase with MonoAI with git metadata')
+    .action(async () => {
+    try {
+        console.log(chalk.blue('🔍 Analyzing codebase and git status...'));
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            console.error(chalk.red('❌ Not a git repository. Please run this inside a git project.'));
+            return;
+        }
+        // 1. Get Git Metadata
+        const log = await git.log({ maxCount: 1 });
+        const lastCommit = log.latest;
+        const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        if (!lastCommit) {
+            console.error(chalk.red('❌ No git commits found. Please commit your changes first.'));
+            return;
+        }
+        console.log(chalk.green(`✅ Found commit: ${lastCommit.hash.substring(0, 7)} on branch ${branch}`));
+        // 2. Scan Directory Structure (Simplified for demo)
+        // In real implementation, this would be a deep traversal respecting .gitignore
+        const structure = {
+            name: path.basename(process.cwd()),
+            totalFiles: 0,
+            files: []
+        };
+        const scanDir = (dir, base = '') => {
+            const items = fs.readdirSync(dir);
+            for (const item of items) {
+                if (item === 'node_modules' || item === '.git' || item === 'dist')
+                    continue;
+                const fullPath = path.join(dir, item);
+                const relativePath = path.join(base, item);
+                if (fs.statSync(fullPath).isDirectory()) {
+                    scanDir(fullPath, relativePath);
+                }
+                else {
+                    structure.totalFiles++;
+                    structure.files.push(relativePath);
+                }
+            }
+        };
+        scanDir(process.cwd());
+        // 3. Send to MonoAI (Convex)
+        console.log(chalk.blue('🚀 Syncing with MonoAI...'));
+        const payload = {
+            commitId: lastCommit.hash.substring(0, 7),
+            commitMessage: lastCommit.message,
+            branch: branch,
+            structure: JSON.stringify(structure),
+            syncStatus: 'success',
+            lastSyncedAt: Date.now()
+        };
+        // TODO: Get actual CONVEX_SITE_URL and user token from config
+        const CONVEX_SITE_URL = 'http://localhost:5173'; // Placeholder
+        console.log(chalk.yellow(`📡 Sending data to MonoAI (${CONVEX_SITE_URL}/cli/git-commit)...`));
+        // Simulating successful response for demo verification
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        console.log(chalk.green('✨ [Simulation] Successfully synced to MonoAI!'));
+        console.log(chalk.dim(`   Branch: ${branch}`));
+        console.log(chalk.dim(`   Commit: ${lastCommit.hash.substring(0, 7)}`));
+        console.log(chalk.dim(`   Message: ${lastCommit.message}`));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error during sync:'), error.message);
+    }
+});

package/dist/commands/login.js

@@ -0,0 +1,65 @@
+import { Command } from 'commander';
+import Conf from 'conf';
+import axios from 'axios';
+import chalk from 'chalk';
+import open from 'open';
+import ora from 'ora';
+const config = new Conf({ projectName: 'monoai' });
+const CONVEX_SITE_URL = 'https://majestic-crane-609.convex.site';
+export const loginCommand = new Command('login')
+    .description('Authenticate with MonoAI')
+    .action(async () => {
+    console.log(chalk.blue('🔐 Starting MonoAI Login...'));
+    try {
+        // 1. Init Session
+        const initSpinner = ora('Initializing auth session...').start();
+        const initRes = await axios.post(`${CONVEX_SITE_URL}/cli/auth/init`, {
+            deviceDescription: process.platform
+        });
+        initSpinner.succeed();
+        const { tempCode, loginUrl } = initRes.data;
+        console.log(chalk.yellow(`\n👉 Verification Code: ${chalk.bold(tempCode)}`));
+        console.log(chalk.dim(`   Opening browser... if it doesn't open, visit:`));
+        console.log(chalk.underline(loginUrl));
+        console.log('\n');
+        await open(loginUrl);
+        // 2. Poll Status
+        const pollSpinner = ora('Waiting for approval in browser...').start();
+        let attempts = 0;
+        const maxAttempts = 60; // 2 minutes (2s * 60)
+        const pollInterval = setInterval(async () => {
+            try {
+                const pollRes = await axios.post(`${CONVEX_SITE_URL}/cli/auth/poll`, { tempCode });
+                const { status, token, userId } = pollRes.data;
+                if (status === 'approved' && token) {
+                    clearInterval(pollInterval);
+                    config.set('auth_token', token);
+                    config.set('user_id', userId);
+                    config.set('convex_url', CONVEX_SITE_URL); // Store for future use
+                    pollSpinner.succeed(chalk.green('✅ Login Successful!'));
+                    console.log(chalk.dim(`   Token saved to ${config.path}`));
+                    process.exit(0);
+                }
+                else if (status === 'expired' || status === 'rejected') {
+                    clearInterval(pollInterval);
+                    pollSpinner.fail(chalk.red(`❌ Session ${status}. Please try again.`));
+                    process.exit(1);
+                }
+                else {
+                    attempts++;
+                    if (attempts >= maxAttempts) {
+                        clearInterval(pollInterval);
+                        pollSpinner.fail(chalk.red('❌ Timed out.'));
+                        process.exit(1);
+                    }
+                }
+            }
+            catch (err) {
+                // Ignore poll errors (network blips)
+            }
+        }, 2000);
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Login failed:'), error.message);
+    }
+});

package/dist/commands/sync.js

@@ -0,0 +1,96 @@
+import { Command } from 'commander';
+import { simpleGit } from 'simple-git';
+import axios from 'axios';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import ignore from 'ignore';
+import Conf from 'conf';
+import { extractSkeleton } from '../utils/ast-extractor.js';
+const git = simpleGit();
+const config = new Conf({ projectName: 'monoai' });
+export const syncCommand = new Command('push')
+    .description('Push codebase integrity and AST skeleton to MonoAI')
+    .action(async () => {
+    try {
+        console.log(chalk.blue('🏎️  Starting MonoAI Strategic Push...'));
+        // 0. Auth Check
+        const token = config.get('auth_token');
+        if (!token) {
+            console.error(chalk.red('❌ Not Authenticated. Please run:'));
+            console.error(chalk.white('   npx monoai login'));
+            return;
+        }
+        const isRepo = await git.checkIsRepo();
+        if (!isRepo) {
+            console.error(chalk.red('❌ Not a git repository.'));
+            return;
+        }
+        // 1. Git Metadata (Zero-HITL Intent)
+        const log = await git.log({ maxCount: 1 });
+        const lastCommit = log.latest;
+        const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+        if (!lastCommit) {
+            console.error(chalk.red('❌ No commits found.'));
+            return;
+        }
+        console.log(chalk.dim(`   Branch: ${chalk.white(branch)}`));
+        console.log(chalk.dim(`   Commit: ${chalk.white(lastCommit.hash.substring(0, 7))}`));
+        // 2. Scan & Extract AST Skeleton
+        console.log(chalk.blue('🔍 Analyzing structural integrity (AST)...'));
+        const ig = ignore();
+        if (fs.existsSync('.gitignore')) {
+            ig.add(fs.readFileSync('.gitignore').toString());
+        }
+        // Hardcoded safety
+        ig.add(['node_modules', '.git', 'dist', '.env', 'build']);
+        const filesToAnalyze = [];
+        const scanDir = (dir) => {
+            const items = fs.readdirSync(dir);
+            for (const item of items) {
+                const fullPath = path.join(dir, item);
+                const relativePath = path.relative(process.cwd(), fullPath);
+                if (ig.ignores(relativePath))
+                    continue;
+                if (fs.statSync(fullPath).isDirectory()) {
+                    scanDir(fullPath);
+                }
+                else if (/\.(ts|tsx|js|jsx)$/.test(item)) {
+                    filesToAnalyze.push(fullPath);
+                }
+            }
+        };
+        scanDir(process.cwd());
+        const skeleton = extractSkeleton(filesToAnalyze);
+        // 3. Payload Construction
+        const payload = {
+            name: path.basename(process.cwd()),
+            branch: branch,
+            commitId: lastCommit.hash.substring(0, 7),
+            commitMessage: lastCommit.message,
+            structure: JSON.stringify(skeleton), // Now structured AST
+            syncStatus: 'success',
+        };
+        // 4. Send to Navigator (Convex)
+        console.log(chalk.blue('📡 Transmitting to Value Engine...'));
+        const CONVEX_SITE_URL = config.get('convex_url') || 'https://majestic-crane-609.convex.site';
+        await axios.post(`${CONVEX_SITE_URL}/cli/git-commit`, {
+            codebaseData: payload
+        }, {
+            headers: {
+                'Authorization': `Bearer ${token}`
+            }
+        });
+        console.log(chalk.green('✨ [Navigator] Push complete! Check your dashboard for Navigator alignment.'));
+        console.log(chalk.dim(`   Message: ${lastCommit.message.split('\n')[0]}`));
+    }
+    catch (error) {
+        if (error.response?.status === 401) {
+            console.error(chalk.red('❌ Authentication Expired. Please run:'));
+            console.error(chalk.white('   npx monoai login'));
+        }
+        else {
+            console.error(chalk.red('❌ Sync failed:'), error.message);
+        }
+    }
+});

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { syncCommand } from './commands/sync.js';
+import { loginCommand } from './commands/login.js';
+const program = new Command();
+program
+    .name('monoai')
+    .description('MonoAI CLI - Strategic Navigator')
+    .version('0.1.2');
+// Git sub-command group
+const git = new Command('git').description('Git related operations');
+git.addCommand(syncCommand.name('push'));
+program.addCommand(loginCommand);
+program.addCommand(git);
+program.parse();

package/dist/utils/ast-extractor.js

@@ -0,0 +1,112 @@
+import { Project, SyntaxKind } from 'ts-morph';
+import path from 'path';
+// 🛡️ Security: Redaction Patterns
+const SECRET_PATTERNS = [
+    /sk-[a-zA-Z0-9-_]{20,}/g, // OpenAI / Stripe style
+    /eyJ[a-zA-Z0-9-_]{20,}/g, // JWT style
+    /AIza[0-9A-Za-z-_]{35}/g, // Google Cloud style
+    /ghp_[a-zA-Z0-9]{36}/g // GitHub Personal Access Token
+];
+export function extractSkeleton(filePaths) {
+    const project = new Project();
+    // 🛡️ Security: File Filter
+    const safePaths = filePaths.filter(p => {
+        const base = path.basename(p);
+        if (base.startsWith('.env'))
+            return false;
+        if (base === '.DS_Store')
+            return false;
+        if (p.includes('node_modules'))
+            return false;
+        if (p.includes('.git/'))
+            return false;
+        return true;
+    });
+    project.addSourceFilesAtPaths(safePaths);
+    const result = {};
+    let totalPayloadSize = 0;
+    project.getSourceFiles().forEach(sourceFile => {
+        // 🛡️ Security: Secret Redaction (Active Scanning)
+        sourceFile.forEachDescendant((node) => {
+            if (node.getKind() === SyntaxKind.StringLiteral) {
+                const sl = node;
+                const text = sl.getLiteralText();
+                let redacted = text;
+                let found = false;
+                for (const pattern of SECRET_PATTERNS) {
+                    if (pattern.test(text)) {
+                        redacted = '[REDACTED_SECRET]';
+                        found = true;
+                        break;
+                    }
+                }
+                if (found) {
+                    // AST Rewrite (Memory only, does not save to disk)
+                    sl.setLiteralValue(redacted);
+                }
+            }
+        });
+        const filePath = sourceFile.getFilePath();
+        const skeleton = {
+            functions: [],
+            classes: [],
+            interfaces: [],
+            types: []
+        };
+        // Extract Functions
+        sourceFile.getFunctions().forEach(f => {
+            if (f.isExported()) {
+                skeleton.functions.push({
+                    name: f.getName(),
+                    parameters: f.getParameters().map(p => ({
+                        name: p.getName(),
+                        type: p.getType().getText()
+                    })),
+                    returnType: f.getReturnType().getText(),
+                    jsDoc: f.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+        // Extract Classes
+        sourceFile.getClasses().forEach(c => {
+            if (c.isExported()) {
+                skeleton.classes.push({
+                    name: c.getName(),
+                    methods: c.getMethods().map(m => ({
+                        name: m.getName(),
+                        parameters: m.getParameters().map(p => ({
+                            name: p.getName(),
+                            type: p.getType().getText()
+                        })),
+                        returnType: m.getReturnType().getText()
+                    })),
+                    jsDoc: c.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+        // Extract Interfaces
+        sourceFile.getInterfaces().forEach(i => {
+            if (i.isExported()) {
+                skeleton.interfaces.push({
+                    name: i.getName(),
+                    jsDoc: i.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+        // Extract Types
+        sourceFile.getTypeAliases().forEach(t => {
+            if (t.isExported()) {
+                skeleton.types.push({
+                    name: t.getName(),
+                });
+            }
+        });
+        result[filePath] = skeleton;
+    });
+    // 🛡️ Security: Payload Size Limit (DoS Prevention)
+    const payloadString = JSON.stringify(result);
+    if (payloadString.length > 5 * 1024 * 1024) { // 5MB
+        throw new Error("Payload too large. Security limit exceeded (5MB).");
+    }
+    return result;
+}

package/dist/utils/config.js

@@ -0,0 +1,19 @@
+import Conf from 'conf';
+const config = new Conf({
+    projectName: 'monoai',
+    projectSuffix: 'cli'
+});
+export const saveCredentials = (token, url) => {
+    config.set('authToken', token);
+    config.set('convexUrl', url);
+};
+export const getCredentials = () => {
+    return {
+        authToken: config.get('authToken'),
+        convexUrl: config.get('convexUrl')
+    };
+};
+export const clearCredentials = () => {
+    config.delete('authToken');
+    config.delete('convexUrl');
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "monoai",
+  "type": "module",
+  "version": "0.2.0",
+  "description": "MonoAI CLI for syncing codebase history",
+  "main": "dist/index.js",
+  "bin": {
+    "monoai": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.2",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "conf": "^15.1.0",
+    "ignore": "^7.0.5",
+    "open": "^9.1.0",
+    "ora": "^7.0.1",
+    "simple-git": "^3.21.0",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.31",
+    "typescript": "^5.3.2"
+  }
+}

package/src/commands/git-commit.ts

@@ -0,0 +1,87 @@
+import { Command } from 'commander';
+import { simpleGit } from 'simple-git';
+import axios from 'axios';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+
+const git = simpleGit();
+
+export const gitCommitCommand = new Command('git-commit')
+    .description('Sync local codebase with MonoAI with git metadata')
+    .action(async () => {
+        try {
+            console.log(chalk.blue('🔍 Analyzing codebase and git status...'));
+
+            const isRepo = await git.checkIsRepo();
+            if (!isRepo) {
+                console.error(chalk.red('❌ Not a git repository. Please run this inside a git project.'));
+                return;
+            }
+
+            // 1. Get Git Metadata
+            const log = await git.log({ maxCount: 1 });
+            const lastCommit = log.latest;
+            const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+
+            if (!lastCommit) {
+                console.error(chalk.red('❌ No git commits found. Please commit your changes first.'));
+                return;
+            }
+
+            console.log(chalk.green(`✅ Found commit: ${lastCommit.hash.substring(0, 7)} on branch ${branch}`));
+
+            // 2. Scan Directory Structure (Simplified for demo)
+            // In real implementation, this would be a deep traversal respecting .gitignore
+            const structure = {
+                name: path.basename(process.cwd()),
+                totalFiles: 0,
+                files: [] as string[]
+            };
+
+            const scanDir = (dir: string, base: string = '') => {
+                const items = fs.readdirSync(dir);
+                for (const item of items) {
+                    if (item === 'node_modules' || item === '.git' || item === 'dist') continue;
+                    const fullPath = path.join(dir, item);
+                    const relativePath = path.join(base, item);
+                    if (fs.statSync(fullPath).isDirectory()) {
+                        scanDir(fullPath, relativePath);
+                    } else {
+                        structure.totalFiles++;
+                        structure.files.push(relativePath);
+                    }
+                }
+            };
+
+            scanDir(process.cwd());
+
+            // 3. Send to MonoAI (Convex)
+            console.log(chalk.blue('🚀 Syncing with MonoAI...'));
+
+            const payload = {
+                commitId: lastCommit.hash.substring(0, 7),
+                commitMessage: lastCommit.message,
+                branch: branch,
+                structure: JSON.stringify(structure),
+                syncStatus: 'success',
+                lastSyncedAt: Date.now()
+            };
+
+            // TODO: Get actual CONVEX_SITE_URL and user token from config
+            const CONVEX_SITE_URL = 'http://localhost:5173'; // Placeholder
+
+            console.log(chalk.yellow(`📡 Sending data to MonoAI (${CONVEX_SITE_URL}/cli/git-commit)...`));
+
+            // Simulating successful response for demo verification
+            await new Promise(resolve => setTimeout(resolve, 1000));
+
+            console.log(chalk.green('✨ [Simulation] Successfully synced to MonoAI!'));
+            console.log(chalk.dim(`   Branch: ${branch}`));
+            console.log(chalk.dim(`   Commit: ${lastCommit.hash.substring(0, 7)}`));
+            console.log(chalk.dim(`   Message: ${lastCommit.message}`));
+
+        } catch (error: any) {
+            console.error(chalk.red('❌ Error during sync:'), error.message);
+        }
+    });

package/src/commands/login.ts

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import Conf from 'conf';
+import axios from 'axios';
+import chalk from 'chalk';
+import open from 'open';
+import ora from 'ora';
+
+const config = new Conf({ projectName: 'monoai' });
+const CONVEX_SITE_URL = 'https://majestic-crane-609.convex.site';
+
+export const loginCommand = new Command('login')
+    .description('Authenticate with MonoAI')
+    .action(async () => {
+        console.log(chalk.blue('🔐 Starting MonoAI Login...'));
+
+        try {
+            // 1. Init Session
+            const initSpinner = ora('Initializing auth session...').start();
+            const initRes = await axios.post(`${CONVEX_SITE_URL}/cli/auth/init`, {
+                deviceDescription: process.platform
+            });
+            initSpinner.succeed();
+
+            const { tempCode, loginUrl } = initRes.data;
+
+            console.log(chalk.yellow(`\n👉 Verification Code: ${chalk.bold(tempCode)}`));
+            console.log(chalk.dim(`   Opening browser... if it doesn't open, visit:`));
+            console.log(chalk.underline(loginUrl));
+            console.log('\n');
+
+            await open(loginUrl);
+
+            // 2. Poll Status
+            const pollSpinner = ora('Waiting for approval in browser...').start();
+
+            let attempts = 0;
+            const maxAttempts = 60; // 2 minutes (2s * 60)
+
+            const pollInterval = setInterval(async () => {
+                try {
+                    const pollRes = await axios.post(`${CONVEX_SITE_URL}/cli/auth/poll`, { tempCode });
+                    const { status, token, userId } = pollRes.data;
+
+                    if (status === 'approved' && token) {
+                        clearInterval(pollInterval);
+                        config.set('auth_token', token);
+                        config.set('user_id', userId);
+                        config.set('convex_url', CONVEX_SITE_URL); // Store for future use
+
+                        pollSpinner.succeed(chalk.green('✅ Login Successful!'));
+                        console.log(chalk.dim(`   Token saved to ${config.path}`));
+                        process.exit(0);
+                    } else if (status === 'expired' || status === 'rejected') {
+                        clearInterval(pollInterval);
+                        pollSpinner.fail(chalk.red(`❌ Session ${status}. Please try again.`));
+                        process.exit(1);
+                    } else {
+                        attempts++;
+                        if (attempts >= maxAttempts) {
+                            clearInterval(pollInterval);
+                            pollSpinner.fail(chalk.red('❌ Timed out.'));
+                            process.exit(1);
+                        }
+                    }
+                } catch (err) {
+                    // Ignore poll errors (network blips)
+                }
+            }, 2000);
+
+        } catch (error: any) {
+            console.error(chalk.red('\n❌ Login failed:'), error.message);
+        }
+    });

package/src/commands/sync.ts

@@ -0,0 +1,111 @@
+import { Command } from 'commander';
+import { simpleGit } from 'simple-git';
+import axios from 'axios';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import ignore from 'ignore';
+import Conf from 'conf';
+import { extractSkeleton } from '../utils/ast-extractor.js';
+
+const git = simpleGit();
+const config = new Conf({ projectName: 'monoai' });
+
+export const syncCommand = new Command('push')
+    .description('Push codebase integrity and AST skeleton to MonoAI')
+    .action(async () => {
+        try {
+            console.log(chalk.blue('🏎️  Starting MonoAI Strategic Push...'));
+
+            // 0. Auth Check
+            const token = config.get('auth_token');
+            if (!token) {
+                console.error(chalk.red('❌ Not Authenticated. Please run:'));
+                console.error(chalk.white('   npx monoai login'));
+                return;
+            }
+
+            const isRepo = await git.checkIsRepo();
+            if (!isRepo) {
+                console.error(chalk.red('❌ Not a git repository.'));
+                return;
+            }
+
+            // 1. Git Metadata (Zero-HITL Intent)
+            const log = await git.log({ maxCount: 1 });
+            const lastCommit = log.latest;
+            const branch = await git.revparse(['--abbrev-ref', 'HEAD']);
+
+            if (!lastCommit) {
+                console.error(chalk.red('❌ No commits found.'));
+                return;
+            }
+
+            console.log(chalk.dim(`   Branch: ${chalk.white(branch)}`));
+            console.log(chalk.dim(`   Commit: ${chalk.white(lastCommit.hash.substring(0, 7))}`));
+
+            // 2. Scan & Extract AST Skeleton
+            console.log(chalk.blue('🔍 Analyzing structural integrity (AST)...'));
+
+            const ig = ignore();
+            if (fs.existsSync('.gitignore')) {
+                ig.add(fs.readFileSync('.gitignore').toString());
+            }
+            // Hardcoded safety
+            ig.add(['node_modules', '.git', 'dist', '.env', 'build']);
+
+            const filesToAnalyze: string[] = [];
+            const scanDir = (dir: string) => {
+                const items = fs.readdirSync(dir);
+                for (const item of items) {
+                    const fullPath = path.join(dir, item);
+                    const relativePath = path.relative(process.cwd(), fullPath);
+
+                    if (ig.ignores(relativePath)) continue;
+
+                    if (fs.statSync(fullPath).isDirectory()) {
+                        scanDir(fullPath);
+                    } else if (/\.(ts|tsx|js|jsx)$/.test(item)) {
+                        filesToAnalyze.push(fullPath);
+                    }
+                }
+            };
+
+            scanDir(process.cwd());
+            const skeleton = extractSkeleton(filesToAnalyze);
+
+            // 3. Payload Construction
+            const payload = {
+                name: path.basename(process.cwd()),
+                branch: branch,
+                commitId: lastCommit.hash.substring(0, 7),
+                commitMessage: lastCommit.message,
+                structure: JSON.stringify(skeleton), // Now structured AST
+                syncStatus: 'success' as const,
+            };
+
+            // 4. Send to Navigator (Convex)
+            console.log(chalk.blue('📡 Transmitting to Value Engine...'));
+
+            const CONVEX_SITE_URL = config.get('convex_url') as string || 'https://majestic-crane-609.convex.site';
+
+            await axios.post(`${CONVEX_SITE_URL}/cli/git-commit`, {
+                codebaseData: payload
+            }, {
+                headers: {
+                    'Authorization': `Bearer ${token}`
+                }
+            });
+
+            console.log(chalk.green('✨ [Navigator] Push complete! Check your dashboard for Navigator alignment.'));
+            console.log(chalk.dim(`   Message: ${lastCommit.message.split('\n')[0]}`));
+
+        } catch (error: any) {
+            if (error.response?.status === 401) {
+                console.error(chalk.red('❌ Authentication Expired. Please run:'));
+                console.error(chalk.white('   npx monoai login'));
+            } else {
+                console.error(chalk.red('❌ Sync failed:'), error.message);
+            }
+        }
+    });

package/src/index.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { syncCommand } from './commands/sync.js';
+import { loginCommand } from './commands/login.js';
+
+const program = new Command();
+
+program
+    .name('monoai')
+    .description('MonoAI CLI - Strategic Navigator')
+    .version('0.1.2');
+
+// Git sub-command group
+const git = new Command('git').description('Git related operations');
+git.addCommand(syncCommand.name('push'));
+
+program.addCommand(loginCommand);
+program.addCommand(git);
+
+program.parse();

package/src/utils/ast-extractor.ts

@@ -0,0 +1,131 @@
+import { Project, SyntaxKind, StringLiteral } from 'ts-morph';
+import path from 'path';
+
+export interface CodeSkeleton {
+    functions: any[];
+    classes: any[];
+    interfaces: any[];
+    types: any[];
+}
+
+// 🛡️ Security: Redaction Patterns
+const SECRET_PATTERNS = [
+    /sk-[a-zA-Z0-9-_]{20,}/g,      // OpenAI / Stripe style
+    /eyJ[a-zA-Z0-9-_]{20,}/g,      // JWT style
+    /AIza[0-9A-Za-z-_]{35}/g,      // Google Cloud style
+    /ghp_[a-zA-Z0-9]{36}/g         // GitHub Personal Access Token
+];
+
+export function extractSkeleton(filePaths: string[]): Record<string, CodeSkeleton> {
+    const project = new Project();
+
+    // 🛡️ Security: File Filter
+    const safePaths = filePaths.filter(p => {
+        const base = path.basename(p);
+        if (base.startsWith('.env')) return false;
+        if (base === '.DS_Store') return false;
+        if (p.includes('node_modules')) return false;
+        if (p.includes('.git/')) return false;
+        return true;
+    });
+
+    project.addSourceFilesAtPaths(safePaths);
+
+    const result: Record<string, CodeSkeleton> = {};
+    let totalPayloadSize = 0;
+
+    project.getSourceFiles().forEach(sourceFile => {
+        // 🛡️ Security: Secret Redaction (Active Scanning)
+        sourceFile.forEachDescendant((node) => {
+            if (node.getKind() === SyntaxKind.StringLiteral) {
+                const sl = node as StringLiteral;
+                const text = sl.getLiteralText();
+                let redacted = text;
+                let found = false;
+
+                for (const pattern of SECRET_PATTERNS) {
+                    if (pattern.test(text)) {
+                        redacted = '[REDACTED_SECRET]';
+                        found = true;
+                        break;
+                    }
+                }
+
+                if (found) {
+                    // AST Rewrite (Memory only, does not save to disk)
+                    sl.setLiteralValue(redacted);
+                }
+            }
+        });
+
+        const filePath = sourceFile.getFilePath();
+        const skeleton: CodeSkeleton = {
+            functions: [],
+            classes: [],
+            interfaces: [],
+            types: []
+        };
+
+        // Extract Functions
+        sourceFile.getFunctions().forEach(f => {
+            if (f.isExported()) {
+                skeleton.functions.push({
+                    name: f.getName(),
+                    parameters: f.getParameters().map(p => ({
+                        name: p.getName(),
+                        type: p.getType().getText()
+                    })),
+                    returnType: f.getReturnType().getText(),
+                    jsDoc: f.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+
+        // Extract Classes
+        sourceFile.getClasses().forEach(c => {
+            if (c.isExported()) {
+                skeleton.classes.push({
+                    name: c.getName(),
+                    methods: c.getMethods().map(m => ({
+                        name: m.getName(),
+                        parameters: m.getParameters().map(p => ({
+                            name: p.getName(),
+                            type: p.getType().getText()
+                        })),
+                        returnType: m.getReturnType().getText()
+                    })),
+                    jsDoc: c.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+
+        // Extract Interfaces
+        sourceFile.getInterfaces().forEach(i => {
+            if (i.isExported()) {
+                skeleton.interfaces.push({
+                    name: i.getName(),
+                    jsDoc: i.getJsDocs().map(d => d.getCommentText()).join('\n')
+                });
+            }
+        });
+
+        // Extract Types
+        sourceFile.getTypeAliases().forEach(t => {
+            if (t.isExported()) {
+                skeleton.types.push({
+                    name: t.getName(),
+                });
+            }
+        });
+
+        result[filePath] = skeleton;
+    });
+
+    // 🛡️ Security: Payload Size Limit (DoS Prevention)
+    const payloadString = JSON.stringify(result);
+    if (payloadString.length > 5 * 1024 * 1024) { // 5MB
+        throw new Error("Payload too large. Security limit exceeded (5MB).");
+    }
+
+    return result;
+}

package/src/utils/config.ts

@@ -0,0 +1,28 @@
+import Conf from 'conf';
+
+interface CliConfig {
+    authToken?: string;
+    convexUrl?: string;
+}
+
+const config = new Conf<CliConfig>({
+    projectName: 'monoai',
+    projectSuffix: 'cli'
+});
+
+export const saveCredentials = (token: string, url: string) => {
+    config.set('authToken', token);
+    config.set('convexUrl', url);
+};
+
+export const getCredentials = () => {
+    return {
+        authToken: config.get('authToken'),
+        convexUrl: config.get('convexUrl')
+    };
+};
+
+export const clearCredentials = () => {
+    config.delete('authToken');
+    config.delete('convexUrl');
+};

package/test-redaction.js

@@ -0,0 +1,5 @@
+
+import { extractSkeleton } from "./src/utils/ast-extractor.js";
+const result = extractSkeleton(["cli/test-secret.ts"]);
+console.log(JSON.stringify(result, null, 2));
+

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "Node16",
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "moduleResolution": "node16",
+        "resolveJsonModule": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}