monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/index.js

@@ -0,0 +1,385 @@
+#!/usr/bin/env node
+/**
+ * Monty Full-Stack Agent Framework
+ * Main entry point that routes between initializer and coding agents.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0 - Non-commercial use only
+ * https://creativecommons.org/licenses/by-nc/4.0/
+ *
+ * Based on Anthropic's best practices for effective agent harnesses:
+ * https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents
+ */
+import { existsSync, mkdirSync } from "fs";
+import { agentConfig } from "./config/agent-config.js";
+import { runInitializerAgent } from "./agents/initializer.js";
+import { runCodingAgent } from "./agents/coding.js";
+import { multiAuthManager } from "./utils/multi-auth-manager.js";
+/**
+ * Check if this is the first run (no .agent directory)
+ */
+function isFirstRun() {
+    return !existsSync(agentConfig.paths.agentDir);
+}
+/**
+ * Run a function with retry logic for transient failures
+ * Implements exponential backoff with configurable max retries
+ */
+async function runWithRetry(runFn, maxRetries = agentConfig.session.maxRetries) {
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            await runFn();
+            return;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Don't retry on certain errors that indicate configuration issues
+            if (errorMessage.includes("Feature list not found") ||
+                errorMessage.includes("not been initialized")) {
+                throw error;
+            }
+            if (attempt === maxRetries) {
+                console.error(`\n❌ All ${maxRetries} attempts failed.`);
+                throw error;
+            }
+            console.log(`\n⚠️  Attempt ${attempt}/${maxRetries} failed: ${errorMessage}`);
+            console.log(`   Retrying in ${attempt} second(s)...`);
+            // Exponential backoff
+            await new Promise(resolve => setTimeout(resolve, 1000 * attempt));
+        }
+    }
+}
+/**
+ * Valid provider names for --provider option
+ */
+const VALID_PROVIDERS = ['anthropic', 'openai', 'google', 'cursor'];
+/**
+ * Parse command line arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    // Parse --provider=<name> option
+    const providerArg = args.find(a => a.startsWith("--provider="))?.split("=")[1];
+    let provider;
+    if (providerArg) {
+        if (providerArg === 'all') {
+            provider = 'all';
+        }
+        else if (VALID_PROVIDERS.includes(providerArg)) {
+            provider = providerArg;
+        }
+        else {
+            console.error(`\n✗ Invalid provider: "${providerArg}"`);
+            console.error(`  Valid providers: ${VALID_PROVIDERS.join(', ')}, all\n`);
+            process.exit(1);
+        }
+    }
+    // Parse --set-default=<name> option
+    const setDefaultArg = args.find(a => a.startsWith("--set-default="))?.split("=")[1];
+    let setDefault;
+    if (setDefaultArg && VALID_PROVIDERS.includes(setDefaultArg)) {
+        setDefault = setDefaultArg;
+    }
+    return {
+        forceInit: args.includes("--init") || process.env.FORCE_INIT === "true",
+        forceCoding: args.includes("--code"),
+        spec: args.find(a => a.startsWith("--spec="))?.split("=").slice(1).join("="),
+        context: args.find(a => a.startsWith("--context="))?.split("=").slice(1).join("="),
+        login: args.includes("--login") || args.includes("login"),
+        logout: args.includes("--logout") || args.includes("logout"),
+        whoami: args.includes("--whoami") || args.includes("whoami"),
+        providers: args.includes("--providers") || args.includes("providers"),
+        provider,
+        setDefault,
+    };
+}
+/**
+ * Display usage information
+ */
+function showUsage() {
+    console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                    MONTY FULL-STACK AGENT FRAMEWORK                          ║
+║                                                                              ║
+║  Multi-provider AI orchestration with Claude, OpenAI, Google, and Cursor     ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+USAGE:
+  monty                        Auto-detect mode (init or coding)
+  monty init                   Force initialization mode
+  monty code                   Force coding mode
+
+AUTHENTICATION:
+  monty login                  Interactive login (auto-detects Claude Code)
+  monty login --provider=NAME  Login to specific provider
+  monty logout                 Logout from all providers
+  monty logout --provider=NAME Logout from specific provider
+  monty whoami                 Show current authentication status
+  monty providers              Show all provider status
+
+  Provider Names: anthropic, openai, google, cursor, all
+
+PROVIDER OPTIONS:
+  --provider=NAME              Target specific provider (anthropic, openai, google, cursor)
+  --provider=all               Configure all providers
+  --set-default=NAME           Set default provider for routing
+
+AGENT OPTIONS:
+  --init                       Force run initializer agent
+  --code                       Force run coding agent
+  --spec="..."                 Project specification for initializer
+  --context="..."              Additional context for coding agent
+
+ENVIRONMENT VARIABLES:
+  ANTHROPIC_API_KEY            Anthropic/Claude API key
+  OPENAI_API_KEY               OpenAI/Codex API key
+  GOOGLE_API_KEY               Google/Gemini API key
+  CURSOR_API_KEY               Cursor Cloud API key
+  FORCE_INIT=true              Force initialization mode
+
+WORKFLOW:
+  1. First run automatically triggers Initializer Agent
+  2. Subsequent runs use Coding Agent for incremental progress
+  3. Task orchestrator routes tasks to optimal provider
+  4. Multi-agent review available for code review tasks
+
+FILES:
+  ~/.monty/credentials.json    Multi-provider credentials (v2.0)
+  .agent/feature_list.json     Feature tracking (JSON)
+  .agent/claude-progress.txt   Progress log between sessions
+
+EXAMPLES:
+  monty login                      # Interactive login, auto-detect Claude Code
+  monty login --provider=openai    # Login to OpenAI only
+  monty login --provider=all       # Configure all providers
+  monty providers                  # Show status of all providers
+  monty --set-default=google       # Set Google as default provider
+`);
+}
+/**
+ * Display provider status
+ */
+function showProviderStatus() {
+    console.log('\n╔══════════════════════════════════════════════════════════════════════════════╗');
+    console.log('║                         AI PROVIDER STATUS                                   ║');
+    console.log('╚══════════════════════════════════════════════════════════════════════════════╝\n');
+    const providers = multiAuthManager.getProviderDisplayInfo();
+    const defaultProvider = multiAuthManager.getDefaultProvider();
+    console.log('  Provider          Status              Auth Method    Default');
+    console.log('  ─────────────────────────────────────────────────────────────────────────────');
+    for (const provider of providers) {
+        const status = provider.authenticated
+            ? '\x1b[32m✓ Authenticated\x1b[0m'
+            : '\x1b[90m○ Not configured\x1b[0m';
+        const method = provider.method ?? '-';
+        const isDefault = provider.name === defaultProvider ? '★' : '';
+        const keyPreview = provider.keyPreview ? ` (${provider.keyPreview})` : '';
+        console.log(`  ${provider.displayName.padEnd(18)} ${(provider.authenticated ? '✓ Authenticated' : '○ Not configured').padEnd(20)} ${method.padEnd(14)} ${isDefault}`);
+        if (provider.keyPreview) {
+            console.log(`                      Key: ${provider.keyPreview}`);
+        }
+    }
+    const authenticatedCount = providers.filter(p => p.authenticated).length;
+    console.log('\n  ─────────────────────────────────────────────────────────────────────────────');
+    console.log(`  Authenticated: ${authenticatedCount}/${providers.length} providers`);
+    console.log(`  Default: ${defaultProvider}`);
+    if (authenticatedCount === 0) {
+        console.log('\n  Run "monty login" to authenticate with a provider.');
+    }
+    else if (authenticatedCount === 1) {
+        console.log('\n  Run "monty login --provider=NAME" to add more providers.');
+    }
+    else {
+        console.log('\n  Multi-agent code review is available with multiple providers.');
+    }
+    console.log('');
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    const args = parseArgs();
+    // Show help if requested
+    if (process.argv.includes("--help") || process.argv.includes("-h")) {
+        showUsage();
+        process.exit(0);
+    }
+    // Handle set-default option
+    if (args.setDefault) {
+        multiAuthManager.setDefaultProvider(args.setDefault);
+        console.log(`\n✓ Default provider set to: ${args.setDefault}\n`);
+        process.exit(0);
+    }
+    // Handle providers command - show all provider status
+    if (args.providers) {
+        showProviderStatus();
+        process.exit(0);
+    }
+    // Handle authentication commands FIRST (before auth check)
+    if (args.login) {
+        let success;
+        if (args.provider === 'all') {
+            await multiAuthManager.loginAll();
+            success = multiAuthManager.isAnyProviderAuthenticated();
+        }
+        else if (args.provider) {
+            success = await multiAuthManager.loginProvider(args.provider);
+        }
+        else {
+            // Default: try multi-auth login (starts with Anthropic auto-detect)
+            success = await multiAuthManager.loginProvider('anthropic');
+            if (success) {
+                // Ask if user wants to configure additional providers
+                const rl = await import('readline').then(m => m.createInterface({
+                    input: process.stdin,
+                    output: process.stdout,
+                }));
+                const answer = await new Promise(resolve => {
+                    rl.question('\nWould you like to configure additional providers? (y/N): ', resolve);
+                });
+                rl.close();
+                if (answer.toLowerCase() === 'y') {
+                    for (const provider of ['openai', 'google', 'cursor']) {
+                        const configure = await new Promise(resolve => {
+                            const rl2 = require('readline').createInterface({
+                                input: process.stdin,
+                                output: process.stdout,
+                            });
+                            rl2.question(`Configure ${provider}? (y/N): `, (ans) => {
+                                rl2.close();
+                                resolve(ans);
+                            });
+                        });
+                        if (configure.toLowerCase() === 'y') {
+                            await multiAuthManager.loginProvider(provider);
+                        }
+                    }
+                }
+            }
+        }
+        process.exit(success ? 0 : 1);
+    }
+    if (args.logout) {
+        if (args.provider && args.provider !== 'all') {
+            multiAuthManager.logoutProvider(args.provider);
+        }
+        else {
+            multiAuthManager.logoutAll();
+        }
+        process.exit(0);
+    }
+    if (args.whoami) {
+        multiAuthManager.whoami();
+        process.exit(0);
+    }
+    // Check authentication for other commands - now checks any provider
+    if (!multiAuthManager.isAnyProviderAuthenticated()) {
+        console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                         AUTHENTICATION REQUIRED                              ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
+No AI provider is authenticated.
+
+To authenticate, choose one of:
+  1. Run: monty login                          (auto-detect Claude Code)
+  2. Run: monty login --provider=anthropic     (configure Anthropic/Claude)
+  3. Run: monty login --provider=openai        (configure OpenAI/Codex)
+  4. Run: monty login --provider=google        (configure Google/Gemini)
+  5. Run: monty login --provider=all           (configure all providers)
+
+Or set environment variables:
+  export ANTHROPIC_API_KEY=your-key
+  export OPENAI_API_KEY=your-key
+  export GOOGLE_API_KEY=your-key
+`);
+        process.exit(1);
+    }
+    // Validate authentication before proceeding (async to handle token refresh)
+    const defaultProvider = multiAuthManager.getDefaultProvider();
+    const apiKey = await multiAuthManager.getApiKey(defaultProvider);
+    if (!apiKey) {
+        // Try to find any authenticated provider
+        const authenticatedProviders = multiAuthManager.getAuthenticatedProviders();
+        if (authenticatedProviders.length === 0) {
+            console.error(`
+No valid authentication found for any provider.
+
+Please authenticate using: monty login
+`);
+            process.exit(1);
+        }
+        // Use the first authenticated provider
+        const fallbackProvider = authenticatedProviders[0];
+        console.log(`Default provider (${defaultProvider}) not authenticated, using ${fallbackProvider}`);
+        multiAuthManager.setDefaultProvider(fallbackProvider);
+    }
+    // Ensure API keys are set in environment for all authenticated providers
+    multiAuthManager.setEnvForChildProcess();
+    // Show provider status
+    const authenticatedProviders = multiAuthManager.getAuthenticatedProviders();
+    const providerList = authenticatedProviders.length > 1
+        ? `(${authenticatedProviders.join(', ')})`
+        : `(${defaultProvider})`;
+    console.log(`
+╔══════════════════════════════════════════════════════════════════════════════╗
+║                    MONTY FULL-STACK AGENT FRAMEWORK                          ║
+║                  Multi-Provider AI Orchestration System                      ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+  Providers: ${authenticatedProviders.length} active ${providerList}
+`);
+    // Determine which agent to run
+    const shouldInitialize = args.forceInit || (isFirstRun() && !args.forceCoding);
+    if (shouldInitialize) {
+        // Initialize mode
+        console.log("📦 Mode: INITIALIZER");
+        console.log("━".repeat(70));
+        if (!args.spec) {
+            console.log(`
+⚠️  No project specification provided.
+
+Please provide a project spec using one of these methods:
+  1. Command line: npm start -- --spec="Build a todo app with React..."
+  2. Interactive: The agent will ask for your specification
+
+For now, please describe what you want to build:
+`);
+            // In a real implementation, you'd read from stdin here
+            // For now, we'll use a placeholder that prompts the agent to ask
+            const spec = "Please ask the user for their project specification.";
+            // Ensure .agent directory exists
+            if (!existsSync(agentConfig.paths.agentDir)) {
+                mkdirSync(agentConfig.paths.agentDir, { recursive: true });
+            }
+            await runWithRetry(() => runInitializerAgent(spec));
+        }
+        else {
+            // Ensure .agent directory exists
+            if (!existsSync(agentConfig.paths.agentDir)) {
+                mkdirSync(agentConfig.paths.agentDir, { recursive: true });
+            }
+            await runWithRetry(() => runInitializerAgent(args.spec));
+        }
+    }
+    else {
+        // Coding mode
+        console.log("🔨 Mode: CODING");
+        console.log("━".repeat(70));
+        if (!existsSync(agentConfig.paths.featureList)) {
+            console.error(`
+❌ Error: Feature list not found at ${agentConfig.paths.featureList}
+
+The project has not been initialized. Run with --init flag first:
+  npm run agent:init
+`);
+            process.exit(1);
+        }
+        await runWithRetry(() => runCodingAgent(args.context));
+    }
+}
+// Run main function
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/orchestrator/arbitrator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Arbitrator Sub-Agent
+ * Resolves conflicts between multiple AI provider reviews
+ * using a designated arbitrator provider (default: Claude).
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+import { type ProviderName } from '../config/provider-config.js';
+import { type ReviewFinding, type CoordinatedReviewResult } from './review-coordinator.js';
+/**
+ * Arbitration decision for a single conflict
+ */
+export interface ConflictDecision {
+    conflictId: string;
+    winner: ProviderName;
+    reasoning: string;
+    confidence: number;
+    resolvedFinding?: ReviewFinding;
+}
+/**
+ * Full arbitration result
+ */
+export interface ArbitrationResult {
+    decisions: ConflictDecision[];
+    finalReview: {
+        findings: ReviewFinding[];
+        suggestions: string[];
+        overallSeverity: 'pass' | 'minor' | 'major' | 'critical';
+    };
+    summary: string;
+    arbitratorProvider: ProviderName;
+    executionTime: number;
+}
+/**
+ * Arbitrator configuration
+ */
+export interface ArbitratorConfig {
+    /** Provider to use for arbitration */
+    provider: ProviderName;
+    /** Maximum time for arbitration (ms) */
+    timeout: number;
+    /** Read-only tools for investigation */
+    allowedTools: string[];
+    /** Whether to investigate code directly */
+    investigateCode: boolean;
+}
+/**
+ * Arbitrator Sub-Agent
+ * Resolves conflicts between AI provider reviews
+ */
+export declare class Arbitrator {
+    private config;
+    constructor(config?: Partial<ArbitratorConfig>);
+    /**
+     * Resolve conflicts from a coordinated review
+     */
+    resolve(reviewResult: CoordinatedReviewResult, context?: string): Promise<ArbitrationResult>;
+    /**
+     * Build the arbitration prompt
+     */
+    private buildArbitrationPrompt;
+    /**
+     * Parse arbitration decisions from response
+     */
+    private parseArbitrationDecisions;
+    /**
+     * Build the final merged review
+     */
+    private buildFinalReview;
+    /**
+     * Generate arbitration summary
+     */
+    private generateSummary;
+    /**
+     * Create result when there are no conflicts
+     */
+    private createNoConflictResult;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<ArbitratorConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): ArbitratorConfig;
+}
+/**
+ * Create an arbitrator instance
+ */
+export declare function createArbitrator(config?: Partial<ArbitratorConfig>): Arbitrator;
+export default Arbitrator;
+//# sourceMappingURL=arbitrator.d.ts.map

package/dist/orchestrator/arbitrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arbitrator.d.ts","sourceRoot":"","sources":["../../src/orchestrator/arbitrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,YAAY,EAElB,MAAM,8BAA8B,CAAC;AAMtC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,aAAa,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,WAAW,EAAE;QACX,QAAQ,EAAE,aAAa,EAAE,CAAC;QAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;KAC1D,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,YAAY,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,EAAE,YAAY,CAAC;IACvB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2CAA2C;IAC3C,eAAe,EAAE,OAAO,CAAC;CAC1B;AAYD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAI9C;;OAEG;IACG,OAAO,CACX,YAAY,EAAE,uBAAuB,EACrC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,CAAC;IAyD7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmF9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAiEjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgCvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAIrD;;OAEG;IACH,SAAS,IAAI,gBAAgB;CAG9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAE/E;AAED,eAAe,UAAU,CAAC"}