mycontext-cli 2.0.34 → 2.0.36

package/dist/commands/generate-screens.js

@@ -0,0 +1,323 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateScreensCommand = void 0;
+exports.registerGenerateScreensCommand = registerGenerateScreensCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const fileNames_1 = require("../constants/fileNames");
+const spinner_1 = require("../utils/spinner");
+const logger_1 = require("../utils/logger");
+const geminiClient_1 = require("../utils/geminiClient");
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+/**
+ * Generate visual screens (HTML/PNG) using Gemini API + nanobanana-style generation
+ * Reads context from .mycontext/ and generates screens with realistic previews
+ */
+class GenerateScreensCommand {
+    constructor() {
+        this.spinner = new spinner_1.EnhancedSpinner("Generating screens...");
+        this.geminiClient = new geminiClient_1.GeminiClient();
+    }
+    async execute(screenName, options = {}) {
+        const projectPath = process.cwd();
+        const contextDir = path_1.default.join(projectPath, ".mycontext");
+        const screensDir = path_1.default.join(contextDir, "screens");
+        this.spinner.start();
+        // Check if .mycontext directory exists
+        if (!fs.existsSync(contextDir)) {
+            this.spinner.fail("No .mycontext directory found");
+            console.log(chalk_1.default.red("\n❌ No .mycontext directory found. Run 'mycontext init' first."));
+            return;
+        }
+        // Check if Gemini client is available
+        if (!this.geminiClient.hasApiKey()) {
+            this.spinner.fail("Gemini API key not found");
+            console.log(chalk_1.default.red("\n❌ Gemini API key not found. Set GEMINI_API_KEY in .mycontext/.env"));
+            console.log(chalk_1.default.blue("\n💡 Get your free API key at: https://aistudio.google.com/apikey"));
+            return;
+        }
+        try {
+            // Create screens directory if it doesn't exist
+            await fs.ensureDir(screensDir);
+            // Load context files
+            const context = await this.loadContext(contextDir);
+            // Determine which screens to generate
+            const screensToGenerate = await this.determineScreens(screenName, context, options);
+            this.spinner.succeed("Context loaded");
+            console.log(chalk_1.default.blue(`\n🎨 Generating ${screensToGenerate.length} screen(s)...\n`));
+            // Generate screens
+            const generatedScreens = [];
+            for (const screen of screensToGenerate) {
+                const screenSpinner = new spinner_1.EnhancedSpinner(`Generating ${screen.name}...`);
+                screenSpinner.start();
+                try {
+                    const metadata = await this.generateScreen(screen, context, screensDir, options);
+                    generatedScreens.push(metadata);
+                    screenSpinner.succeed(`Generated ${screen.name}`);
+                }
+                catch (error) {
+                    screenSpinner.fail(`Failed to generate ${screen.name}`);
+                    logger_1.logger.error(`Screen generation error:`, error.message);
+                }
+            }
+            // Update screens manifest
+            await this.updateScreensManifest(screensDir, generatedScreens);
+            // Show summary
+            console.log(chalk_1.default.green(`\n✅ Generated ${generatedScreens.length} screen(s)`));
+            console.log(chalk_1.default.gray(`   Output: ${screensDir}`));
+            // Auto-open in browser if requested
+            if (options.open !== false && generatedScreens.length > 0) {
+                await this.openInBrowser(screensDir, generatedScreens[0]);
+            }
+        }
+        catch (error) {
+            this.spinner.fail("Screen generation failed");
+            logger_1.logger.error("Error generating screens:", error.message);
+            throw error;
+        }
+    }
+    /**
+     * Load context files for screen generation
+     */
+    async loadContext(contextDir) {
+        const context = {};
+        // Load PRD
+        const prdPath = path_1.default.join(contextDir, fileNames_1.CONTEXT_FILES.PRD);
+        if (fs.existsSync(prdPath)) {
+            context.prd = fs.readFileSync(prdPath, "utf8");
+        }
+        // Load brand guidelines
+        const brandPath = path_1.default.join(contextDir, fileNames_1.CONTEXT_FILES.BRANDING);
+        if (fs.existsSync(brandPath)) {
+            context.brand = fs.readFileSync(brandPath, "utf8");
+        }
+        // Load user flows
+        const flowsPath = path_1.default.join(contextDir, fileNames_1.CONTEXT_FILES.USER_FLOWS);
+        if (fs.existsSync(flowsPath)) {
+            context.flows = fs.readFileSync(flowsPath, "utf8");
+        }
+        // Load features
+        const featuresPath = path_1.default.join(contextDir, fileNames_1.CONTEXT_FILES.FEATURES);
+        if (fs.existsSync(featuresPath)) {
+            context.features = fs.readFileSync(featuresPath, "utf8");
+        }
+        // Load sample data
+        const sampleDataPath = path_1.default.join(contextDir, "sample-data.json");
+        if (fs.existsSync(sampleDataPath)) {
+            try {
+                context.sampleData = JSON.parse(fs.readFileSync(sampleDataPath, "utf8"));
+            }
+            catch (error) {
+                logger_1.logger.warn("Could not load sample data");
+            }
+        }
+        return context;
+    }
+    /**
+     * Determine which screens to generate based on options and context
+     */
+    async determineScreens(screenName, context, options) {
+        const screens = [];
+        if (screenName) {
+            // Generate specific screen
+            screens.push({
+                name: screenName,
+                prompt: `Generate a ${screenName} screen for this application`,
+            });
+        }
+        else if (options.all) {
+            // Generate all screens from flows
+            const screenNames = this.extractScreenNamesFromFlows(context.flows);
+            screenNames.forEach((name) => {
+                screens.push({
+                    name,
+                    prompt: `Generate a ${name} screen for this application`,
+                });
+            });
+        }
+        else {
+            // Generate common screens
+            screens.push({ name: "home", prompt: "Generate a home/landing page" }, { name: "login", prompt: "Generate a login screen" }, { name: "dashboard", prompt: "Generate a dashboard screen" });
+        }
+        return screens;
+    }
+    /**
+     * Extract screen names from user flows
+     */
+    extractScreenNamesFromFlows(flows) {
+        if (!flows)
+            return [];
+        const screenNames = [];
+        const lines = flows.split("\n");
+        // Look for screen mentions in flows
+        lines.forEach((line) => {
+            // Match patterns like "1. Login Screen", "- Dashboard", etc.
+            const match = line.match(/(?:^|\s)([A-Z][a-z]+(?:\s[A-Z][a-z]+)*)\s*(?:Screen|Page|View)/i);
+            if (match && match[1]) {
+                const name = match[1].toLowerCase().replace(/\s+/g, "-");
+                if (!screenNames.includes(name)) {
+                    screenNames.push(name);
+                }
+            }
+        });
+        return screenNames.length > 0 ? screenNames : ["home", "dashboard"];
+    }
+    /**
+     * Generate a single screen
+     */
+    async generateScreen(screen, context, screensDir, options) {
+        const includeScreenshot = options.format?.includes("png") || options.includeScreenshot || false;
+        // Generate visual screen using Gemini
+        const result = await this.geminiClient.generateVisualScreen(screen.prompt, context, { includeScreenshot });
+        // Create screen directory
+        const screenDir = path_1.default.join(screensDir, screen.name);
+        await fs.ensureDir(screenDir);
+        // Save HTML
+        const htmlPath = path_1.default.join(screenDir, "index.html");
+        await fs.writeFile(htmlPath, result.html, "utf8");
+        // Save screenshot if generated
+        if (result.screenshot) {
+            const pngPath = path_1.default.join(screenDir, "preview.png");
+            const buffer = Buffer.from(result.screenshot, "base64");
+            await fs.writeFile(pngPath, buffer);
+        }
+        // Save context metadata
+        const contextPath = path_1.default.join(screenDir, "context.json");
+        await fs.writeFile(contextPath, JSON.stringify({
+            prd: context.prd?.substring(0, 1000),
+            brand: context.brand?.substring(0, 500),
+            sampleData: context.sampleData,
+        }, null, 2), "utf8");
+        // Save generation metadata
+        const metadataPath = path_1.default.join(screenDir, "metadata.json");
+        const metadata = {
+            name: screen.name,
+            prompt: screen.prompt,
+            model: result.metadata.model,
+            timestamp: result.metadata.timestamp,
+            format: ["html", result.screenshot ? "png" : null].filter(Boolean),
+            path: screenDir,
+        };
+        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2), "utf8");
+        return metadata;
+    }
+    /**
+     * Update screens manifest file
+     */
+    async updateScreensManifest(screensDir, screens) {
+        const manifestPath = path_1.default.join(screensDir, "screens-manifest.json");
+        // Load existing manifest if it exists
+        let manifest = {
+            screens: [],
+            lastUpdated: new Date().toISOString(),
+        };
+        if (fs.existsSync(manifestPath)) {
+            try {
+                manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+            }
+            catch (error) {
+                logger_1.logger.warn("Could not load existing manifest");
+            }
+        }
+        // Update manifest with new screens
+        screens.forEach((newScreen) => {
+            const existingIndex = manifest.screens.findIndex((s) => s.name === newScreen.name);
+            if (existingIndex >= 0) {
+                manifest.screens[existingIndex] = newScreen;
+            }
+            else {
+                manifest.screens.push(newScreen);
+            }
+        });
+        manifest.lastUpdated = new Date().toISOString();
+        // Save manifest
+        await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), "utf8");
+    }
+    /**
+     * Open generated screen in browser
+     */
+    async openInBrowser(screensDir, screen) {
+        const htmlPath = path_1.default.join(screen.path, "index.html");
+        if (!fs.existsSync(htmlPath)) {
+            logger_1.logger.warn("HTML file not found, cannot open in browser");
+            return;
+        }
+        try {
+            console.log(chalk_1.default.blue("\n🌐 Opening screen in browser..."));
+            // Platform-specific open command
+            const command = process.platform === "darwin"
+                ? "open"
+                : process.platform === "win32"
+                    ? "start"
+                    : "xdg-open";
+            await execAsync(`${command} "${htmlPath}"`);
+        }
+        catch (error) {
+            logger_1.logger.warn("Could not auto-open browser:", error);
+            console.log(chalk_1.default.gray(`\n💡 Manually open: ${htmlPath}`));
+        }
+    }
+}
+exports.GenerateScreensCommand = GenerateScreensCommand;
+/**
+ * Register the generate:screens command
+ */
+function registerGenerateScreensCommand(program) {
+    program
+        .command("generate:screens [screen-name]")
+        .alias("gs")
+        .description("Generate visual screens (HTML/PNG) using Gemini API with full context")
+        .option("-a, --all", "Generate all screens from user flows")
+        .option("-f, --format <formats>", "Output formats: html, png, or both", "html")
+        .option("-o, --output <path>", "Output directory (default: .mycontext/screens)")
+        .option("-s, --screenshot", "Include PNG screenshots (requires puppeteer)")
+        .option("--no-open", "Don't auto-open in browser")
+        .option("-v, --verbose", "Show detailed output")
+        .action(async (screenName, options) => {
+        const command = new GenerateScreensCommand();
+        await command.execute(screenName, {
+            ...options,
+            includeScreenshot: options.screenshot || options.format?.includes("png"),
+        });
+    });
+}
+//# sourceMappingURL=generate-screens.js.map

package/dist/commands/generate-screens.js.map

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

package/dist/config/ai-providers.json

@@ -0,0 +1,94 @@
+{
+  "claude": {
+    "enabled": true,
+    "priority": 0,
+    "models": {
+      "default": "claude-sonnet-4-20250514",
+      "fast": "claude-3-5-haiku-20241022",
+      "advanced": "claude-opus-4-20250514"
+    },
+    "api": {
+      "baseUrl": "https://api.anthropic.com/v1",
+      "timeout": 120000,
+      "retries": 3
+    }
+  },
+  "openrouter": {
+    "enabled": true,
+    "priority": 1,
+    "models": {
+      "default": "deepseek/deepseek-r1-distill-llama-70b",
+      "fast": "deepseek/deepseek-r1-distill-qwen-32b",
+      "advanced": "deepseek/deepseek-r1"
+    },
+    "api": {
+      "baseUrl": "https://openrouter.ai/api/v1",
+      "timeout": 120000,
+      "retries": 3
+    }
+  },
+  "gemini": {
+    "enabled": true,
+    "priority": 2,
+    "models": {
+      "default": "gemini-2.0-flash-exp",
+      "fast": "gemini-1.5-flash-latest",
+      "advanced": "gemini-2.0-flash-thinking-exp-01-21"
+    },
+    "api": {
+      "baseUrl": "https://generativelanguage.googleapis.com/v1beta",
+      "timeout": 120000,
+      "retries": 3
+    }
+  },
+  "xai": {
+    "enabled": true,
+    "priority": 3,
+    "models": {
+      "default": "grok-beta",
+      "fast": "grok-beta",
+      "advanced": "grok-beta"
+    },
+    "api": {
+      "baseUrl": "https://api.x.ai/v1",
+      "timeout": 120000,
+      "retries": 3
+    }
+  },
+  "openai": {
+    "enabled": true,
+    "priority": 4,
+    "models": {
+      "default": "gpt-4o",
+      "fast": "gpt-4o-mini",
+      "advanced": "o1"
+    },
+    "api": {
+      "baseUrl": "https://api.openai.com/v1",
+      "timeout": 120000,
+      "retries": 3
+    }
+  },
+  "huggingface": {
+    "enabled": false,
+    "priority": 10,
+    "models": {
+      "default": "mistralai/Mixtral-8x7B-Instruct-v0.1"
+    },
+    "api": {
+      "baseUrl": "https://api-inference.huggingface.co",
+      "timeout": 60000,
+      "retries": 2
+    }
+  },
+  "fallback": {
+    "enabled": true,
+    "priority": 99,
+    "models": {},
+    "api": {
+      "baseUrl": "",
+      "timeout": 60000,
+      "retries": 1
+    }
+  }
+}

package/dist/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mycontext-cli",
-  "version": "2.0.34",
-  "description": "Component-first visual builder with zero-error guarantees. Generate and validate React/Next.js components one at a time, preview them visually, then scale to complete applications using Claude Agent SDK.",
+  "version": "2.0.36",
+  "description": "Spec-Driven Development for the AI Era - Generate comprehensive context + visual screens, then code with Claude/Cursor",
   "main": "dist/cli.js",
   "bin": {
     "mycontext-cli": "dist/cli.js",

package/dist/utils/geminiClient.d.ts

@@ -0,0 +1,92 @@
+export interface GeminiMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+export interface GeminiGenerationConfig {
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    topK?: number;
+    stopSequences?: string[];
+}
+export interface GeminiResponse {
+    content: string;
+    model: string;
+    finishReason?: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface GeminiVisualResponse {
+    html: string;
+    screenshot?: string;
+    metadata: {
+        model: string;
+        timestamp: string;
+        prompt: string;
+    };
+}
+/**
+ * Gemini API Client with nanobanana support for visual generation
+ * Supports both text generation and HTML/screenshot generation
+ */
+export declare class GeminiClient {
+    private apiKey;
+    private baseUrl;
+    private client;
+    private model;
+    constructor();
+    /**
+     * Get Gemini API key from environment
+     */
+    private getApiKey;
+    /**
+     * Check if Gemini client has a valid API key
+     */
+    hasApiKey(): boolean;
+    /**
+     * Generate text completion using Gemini
+     */
+    generateText(messages: GeminiMessage[], config?: GeminiGenerationConfig): Promise<GeminiResponse>;
+    /**
+     * Generate visual screen (HTML + optional screenshot) using Gemini + nanobanana
+     * This uses Gemini's multimodal capabilities to generate HTML
+     */
+    generateVisualScreen(prompt: string, context?: {
+        prd?: string;
+        brand?: string;
+        flows?: string;
+        sampleData?: any;
+    }, config?: GeminiGenerationConfig & {
+        includeScreenshot?: boolean;
+    }): Promise<GeminiVisualResponse>;
+    /**
+     * Build comprehensive prompt for visual screen generation
+     */
+    private buildVisualPrompt;
+    /**
+     * Extract HTML from Gemini response (handles markdown code blocks)
+     */
+    private extractHtml;
+    /**
+     * Generate screenshot from HTML using nanobanana-style approach
+     * For now, this is a placeholder - actual implementation would use puppeteer/playwright
+     * or a headless browser API
+     */
+    private generateScreenshot;
+    /**
+     * Convert messages to Gemini API format
+     */
+    private convertMessages;
+    /**
+     * Test Gemini API connection
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Get available Gemini models
+     */
+    listModels(): Promise<string[]>;
+}
+//# sourceMappingURL=geminiClient.d.ts.map

package/dist/utils/geminiClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiClient.d.ts","sourceRoot":"","sources":["../../src/utils/geminiClient.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,KAAK,CAAS;;IAgBtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,SAAS,IAAI,OAAO;IASpB;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,CAAC,EAAE,sBAAsB,GAC9B,OAAO,CAAC,cAAc,CAAC;IA+C1B;;;OAGG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QACR,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,GAAG,CAAC;KAClB,EACD,MAAM,CAAC,EAAE,sBAAsB,GAAG;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAChE,OAAO,CAAC,oBAAoB,CAAC;IA6ChC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8CzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;;OAIG;YACW,kBAAkB;IAmBhC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAexC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAWtC"}