stitch-forge 0.3.1

package/dist/commands/init.js

@@ -0,0 +1,99 @@
+import { writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { log } from '../utils/logger.js';
+import { saveConfig, getConfigPath } from '../utils/config.js';
+export async function runInit() {
+    log.info('Initializing Stitch Forge project...');
+    log.info('');
+    // Step 1: API Key
+    const apiKey = process.env.STITCH_API_KEY;
+    if (apiKey) {
+        log.success('API key found in environment.');
+        // Validate API key with a test call
+        try {
+            const response = await fetch('https://stitch.googleapis.com/mcp', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Goog-Api-Key': apiKey,
+                },
+                body: JSON.stringify({ method: 'tools/call', params: { name: 'list_projects', arguments: {} } }),
+            });
+            if (response.ok) {
+                log.success('API key verified — connection to Stitch works!');
+            }
+            else {
+                log.warn('API key set but connection test failed. It may still work with MCP proxy.');
+            }
+        }
+        catch {
+            log.warn('Could not reach Stitch API directly. This is fine if using MCP proxy.');
+        }
+    }
+    else {
+        log.warn('No API key found. You need one to generate screens.');
+        log.info('');
+        log.info('How to get your API key:');
+        log.info('  1. Go to stitch.withgoogle.com');
+        log.info('  2. Open Settings (gear icon)');
+        log.info('  3. Copy your API Key');
+        log.info('  4. Add it to your .env file: STITCH_API_KEY=your-key-here');
+        log.info('');
+    }
+    // Step 2: Create config
+    if (existsSync(getConfigPath())) {
+        log.warn('.forgerc.json already exists. Keeping current config.');
+    }
+    else {
+        const config = {
+            apiKey: apiKey || undefined,
+            defaultModel: 'GEMINI_2_5_FLASH',
+            framework: 'static',
+            screens: [],
+            quota: {
+                flashUsed: 0,
+                proUsed: 0,
+                resetDate: new Date(new Date().getFullYear(), new Date().getMonth() + 1, 1)
+                    .toISOString().split('T')[0],
+            },
+        };
+        saveConfig(config);
+        log.success('Created .forgerc.json');
+        log.info('Default build framework: static (change with --framework or in .forgerc.json)');
+    }
+    // Step 3: Create .env if missing
+    if (!existsSync('.env') && !apiKey) {
+        writeFileSync('.env', 'STITCH_API_KEY=\nGOOGLE_CLOUD_PROJECT=\n');
+        log.success('Created .env — add your API key there.');
+    }
+    // Step 4: Create screens directory
+    if (!existsSync('screens')) {
+        mkdirSync('screens');
+        log.success('Created screens/ directory');
+    }
+    // Step 5: Create .mcp.json for Claude Code if missing
+    if (!existsSync('.mcp.json')) {
+        const mcpConfig = {
+            mcpServers: {
+                stitch: {
+                    command: 'npx',
+                    args: ['@_davideast/stitch-mcp', 'proxy'],
+                    env: { STITCH_API_KEY: '${STITCH_API_KEY}' },
+                },
+            },
+        };
+        writeFileSync('.mcp.json', JSON.stringify(mcpConfig, null, 2) + '\n');
+        log.success('Created .mcp.json for Claude Code integration.');
+    }
+    // Next steps
+    log.info('');
+    log.success('Project initialized!');
+    log.info('');
+    log.info('Next steps:');
+    log.info('  1. forge design "Company, Industry, Audience, Style"  — Create your design system');
+    log.info('  2. forge generate "A landing page for..."              — Generate a screen');
+    log.info('  3. forge build --auto                                  — Build your site');
+    log.info('');
+    log.info('Or run `forge workflow` to see guided step-by-step workflows.');
+    log.info('Or run `forge tui` for the interactive terminal interface.');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/preview.d.ts

@@ -0,0 +1,5 @@
+interface PreviewOptions {
+    all?: boolean;
+}
+export declare function runPreview(screenName?: string, opts?: PreviewOptions): Promise<void>;
+export {};

package/dist/commands/preview.js

@@ -0,0 +1,41 @@
+import { log } from '../utils/logger.js';
+import { openInBrowser, listScreenFiles, resolveScreenPath, openAllScreens } from '../utils/preview.js';
+export async function runPreview(screenName, opts = {}) {
+    if (opts.all) {
+        const files = listScreenFiles();
+        if (files.length === 0) {
+            log.error('No screens found in screens/. Run `forge generate` first.');
+            process.exit(1);
+        }
+        await openAllScreens();
+        log.success(`Opened ${files.length} screens in browser.`);
+        return;
+    }
+    if (screenName) {
+        const path = resolveScreenPath(screenName);
+        if (!path) {
+            log.error(`Screen not found: ${screenName}`);
+            const available = listScreenFiles();
+            if (available.length > 0) {
+                log.info('Available screens:');
+                available.forEach(s => log.info(`  ${s}`));
+            }
+            process.exit(1);
+        }
+        await openInBrowser(path);
+        log.success(`Opened ${screenName} in browser.`);
+        return;
+    }
+    // No arguments: list and let user pick
+    const files = listScreenFiles();
+    if (files.length === 0) {
+        log.error('No screens found in screens/. Run `forge generate` first.');
+        process.exit(1);
+    }
+    log.info('Available screens:');
+    files.forEach((s, i) => log.info(`  ${i + 1}. ${s}`));
+    log.info('');
+    log.info('Usage: forge preview <screen-name>');
+    log.info('       forge preview --all');
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../src/commands/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMxG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAmB,EAAE,OAAuB,EAAE;IAC7E,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,cAAc,EAAE,CAAC;QACvB,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,CAAC,MAAM,sBAAsB,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,GAAG,CAAC,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;YACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;gBAC/B,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1B,GAAG,CAAC,OAAO,CAAC,UAAU,UAAU,cAAc,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,uCAAuC;IACvC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAC/C,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;AACzC,CAAC"}

package/dist/commands/research.d.ts

@@ -0,0 +1 @@
+export declare function runResearch(topic?: string): Promise<void>;

package/dist/commands/research.js

@@ -0,0 +1,38 @@
+import { log } from '../utils/logger.js';
+import { crawlSources } from '../research/crawler.js';
+import { diffAgainstKnownState } from '../research/differ.js';
+import { getKnownState, updateKnownState, isStale, getLastUpdated } from '../research/updater.js';
+export async function runResearch(topic) {
+    const lastUpdated = getLastUpdated();
+    log.info(`Knowledge base last updated: ${lastUpdated.toISOString().split('T')[0]}`);
+    if (isStale()) {
+        log.warn('Knowledge base is over 30 days old. Running full update...');
+    }
+    log.step(1, 3, 'Crawling Stitch documentation sources...');
+    const crawlResults = await crawlSources();
+    const successCount = crawlResults.filter(r => !r.content.startsWith('[')).length;
+    const failCount = crawlResults.length - successCount;
+    log.info(`  Fetched ${successCount} sources${failCount > 0 ? `, ${failCount} failed` : ''}`);
+    log.step(2, 3, 'Comparing against known state...');
+    const knownState = getKnownState();
+    const diff = diffAgainstKnownState(crawlResults, knownState);
+    if (!diff.hasChanges) {
+        log.success('No changes detected. Knowledge base is current.');
+        return;
+    }
+    log.step(3, 3, `Found ${diff.changes.length} change(s). Updating...`);
+    for (const change of diff.changes) {
+        const icon = change.severity === 'breaking' ? '🔴' : change.severity === 'warning' ? '🟡' : '🟢';
+        log.info(`  ${icon} [${change.category}] ${change.description}`);
+    }
+    updateKnownState(diff.changes);
+    log.success(`Knowledge base updated. ${diff.changes.length} change(s) recorded.`);
+    const breaking = diff.changes.filter(c => c.severity === 'breaking');
+    if (breaking.length > 0) {
+        log.warn('BREAKING CHANGES detected. Review and update framework accordingly:');
+        for (const b of breaking) {
+            log.warn(`  → ${b.description}`);
+        }
+    }
+}
+//# sourceMappingURL=research.js.map

package/dist/commands/research.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.js","sourceRoot":"","sources":["../../src/commands/research.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAElG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAc;IAC9C,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,GAAG,CAAC,IAAI,CAAC,gCAAgC,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAEpF,IAAI,OAAO,EAAE,EAAE,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IACzE,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,0CAA0C,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,MAAM,YAAY,EAAE,CAAC;IAE1C,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,YAAY,CAAC;IACrD,GAAG,CAAC,IAAI,CAAC,aAAa,YAAY,WAAW,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAE7F,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,kCAAkC,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,qBAAqB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAE7D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,GAAG,CAAC,OAAO,CAAC,iDAAiD,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,yBAAyB,CAAC,CAAC;IAEtE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE/B,GAAG,CAAC,OAAO,CAAC,2BAA2B,IAAI,CAAC,OAAO,CAAC,MAAM,sBAAsB,CAAC,CAAC;IAElF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;IACrE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,GAAG,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAChF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/sync.d.ts

@@ -0,0 +1 @@
+export declare function runSync(projectId?: string): Promise<void>;

package/dist/commands/sync.js

@@ -0,0 +1,53 @@
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { log } from '../utils/logger.js';
+import { getConfig, updateConfig } from '../utils/config.js';
+import { StitchMcpClient } from '../mcp/client.js';
+export async function runSync(projectId) {
+    const config = getConfig();
+    const id = projectId || config.projectId;
+    let client;
+    try {
+        client = new StitchMcpClient();
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : 'Failed to initialize Stitch client.');
+        process.exit(1);
+    }
+    if (!id) {
+        log.info('No project ID. Listing available projects...');
+        const projects = await client.listProjects();
+        if (projects.length === 0) {
+            log.error('No projects found.');
+            process.exit(1);
+        }
+        for (const p of projects) {
+            log.info(`  ${p.id} — ${p.name}`);
+        }
+        log.info('Run: forge sync <project-id>');
+        return;
+    }
+    if (!existsSync('screens'))
+        mkdirSync('screens');
+    log.step(1, 2, 'Fetching screens...');
+    const screens = await client.listScreens(id);
+    log.step(2, 2, `Downloading ${screens.length} screens...`);
+    const screenRecords = [];
+    for (const screen of screens) {
+        const html = await client.getScreenCode(id, screen.id);
+        const filename = `screens/${screen.name || screen.id}.html`;
+        writeFileSync(filename, html);
+        log.info(`  ${filename}`);
+        screenRecords.push({
+            id: screen.id,
+            name: screen.name,
+            lastSynced: new Date().toISOString(),
+        });
+    }
+    updateConfig({
+        projectId: id,
+        screens: screenRecords,
+        lastSync: new Date().toISOString(),
+    });
+    log.success(`Synced ${screens.length} screens from project.`);
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,SAAkB;IAC9C,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC;IACzC,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,CAAC,CAAC;QACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAEjD,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE7C,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,eAAe,OAAO,CAAC,MAAM,aAAa,CAAC,CAAC;IAC3D,MAAM,aAAa,GAAG,EAAE,CAAC;IAEzB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,WAAW,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,OAAO,CAAC;QAC5D,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAE1B,aAAa,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC;QACX,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,aAAa;QACtB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC,CAAC;IAEH,GAAG,CAAC,OAAO,CAAC,UAAU,OAAO,CAAC,MAAM,wBAAwB,CAAC,CAAC;AAChE,CAAC"}

package/dist/commands/workflow.d.ts

@@ -0,0 +1 @@
+export declare function runWorkflow(type?: string): Promise<void>;

package/dist/commands/workflow.js

@@ -0,0 +1,38 @@
+import { log } from '../utils/logger.js';
+import { getWorkflow } from '../templates/workflows.js';
+export async function runWorkflow(type) {
+    if (!type || !['redesign', 'new-app'].includes(type)) {
+        log.info('Available workflows:');
+        log.info('');
+        log.info('  redesign   — Redesign an existing site with a fresh design system');
+        log.info('               Start from DESIGN.md, then generate screens one by one.');
+        log.info('');
+        log.info('  new-app    — Build a new app from scratch');
+        log.info('               Start with brainstorming, then refine and build.');
+        log.info('');
+        log.info('Usage: forge workflow <redesign|new-app>');
+        return;
+    }
+    const steps = getWorkflow(type);
+    const title = type === 'redesign' ? 'Website Redesign' : 'New App from Scratch';
+    log.info(`Workflow: ${title}`);
+    log.info('');
+    log.info('Follow these steps in order:');
+    log.info('');
+    for (let i = 0; i < steps.length; i++) {
+        const step = steps[i];
+        const num = `${i + 1}`.padStart(2);
+        const isManual = step.command === 'manual';
+        const tag = isManual ? ' (manual step)' : '';
+        const cmd = isManual ? '' : `  Command: ${step.command}`;
+        log.info(`  ${num}. ${step.description}${tag}`);
+        if (cmd)
+            log.info(`      ${cmd}`);
+        if (step.dependsOn) {
+            log.info(`      (after: ${step.dependsOn})`);
+        }
+        log.info('');
+    }
+    log.info('Tip: Use the TUI (`forge tui`) for a guided interactive experience.');
+}
+//# sourceMappingURL=workflow.js.map

package/dist/commands/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAqB,MAAM,2BAA2B,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAa;IAC7C,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAChF,GAAG,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QACnF,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QACxD,GAAG,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,IAA8B,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAEhF,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACb,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,OAAO,EAAE,CAAC;QAEzD,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,GAAG;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QAC/C,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;AAClF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+const program = new Command();
+program
+    .name('forge')
+    .description('Stitch Forge — CLI framework for automating web design with Google Stitch')
+    .version('0.2.0');
+program
+    .command('init')
+    .description('Setup project: authenticate and create .forgerc.json')
+    .action(async () => {
+    const { runInit } = await import('./commands/init.js');
+    await runInit();
+});
+program
+    .command('design')
+    .description('Generate a DESIGN.md from a brand brief')
+    .argument('[brief...]', 'Brand brief description')
+    .option('--force', 'Overwrite without confirmation')
+    .option('--research', 'Enable research-driven generation (same as forge discover)')
+    .action(async (brief, opts) => {
+    if (opts.research) {
+        const { runDiscover } = await import('./commands/discover.js');
+        await runDiscover(brief.join(' '), { force: opts.force });
+    }
+    else {
+        const { runDesign } = await import('./commands/design.js');
+        await runDesign(brief.join(' '), opts);
+    }
+});
+program
+    .command('discover')
+    .description('Research a business and generate a tailored DESIGN.md')
+    .argument('[brief...]', 'Business brief (name, industry, audience, aesthetic)')
+    .option('--force', 'Overwrite DESIGN.md without confirmation')
+    .option('-u, --url <url>', 'Business website URL')
+    .option('--competitors <urls>', 'Comma-separated competitor URLs')
+    .option('--locale <locale>', 'Target locale (e.g., es-MX)')
+    .option('--no-research', 'Skip research, use presets only')
+    .action(async (brief, opts) => {
+    const { runDiscover } = await import('./commands/discover.js');
+    await runDiscover(brief.join(' '), opts);
+});
+program
+    .command('generate')
+    .description('Generate a screen in Stitch from a description')
+    .argument('<description...>', 'Screen description')
+    .option('-m, --model <model>', 'Model to use (flash|pro)', 'flash')
+    .option('-p, --project <id>', 'Stitch project ID')
+    .option('--preview', 'Open screen in browser after generating')
+    .action(async (description, opts) => {
+    const { runGenerate } = await import('./commands/generate.js');
+    await runGenerate(description.join(' '), opts);
+});
+program
+    .command('build')
+    .description('Build a deployable site from Stitch screens')
+    .option('-p, --project <id>', 'Stitch project ID')
+    .option('--auto', 'Auto-map screen names to routes')
+    .option('-f, --framework <type>', 'Output framework: static, astro, nextjs')
+    .action(async (opts) => {
+    const { runBuild } = await import('./commands/build.js');
+    await runBuild(opts);
+});
+program
+    .command('preview')
+    .description('Preview generated screens in the browser')
+    .argument('[screen-name]', 'Screen to preview')
+    .option('-a, --all', 'Open all screens')
+    .action(async (screenName, opts) => {
+    const { runPreview } = await import('./commands/preview.js');
+    await runPreview(screenName, opts || {});
+});
+program
+    .command('sync')
+    .description('Sync local files with Stitch project')
+    .argument('[projectId]', 'Stitch project ID')
+    .action(async (projectId) => {
+    const { runSync } = await import('./commands/sync.js');
+    await runSync(projectId);
+});
+program
+    .command('research')
+    .description('Check for Stitch updates and refresh knowledge base')
+    .option('-t, --topic <topic>', 'Specific topic to research')
+    .action(async (opts) => {
+    const { runResearch } = await import('./commands/research.js');
+    await runResearch(opts.topic);
+});
+program
+    .command('tui')
+    .description('Launch interactive terminal UI')
+    .action(async () => {
+    const { renderApp } = await import('./tui/App.js');
+    renderApp();
+});
+program
+    .command('workflow')
+    .description('Show guided workflow steps for common design tasks')
+    .argument('[type]', 'Workflow type: redesign or new-app')
+    .action(async (type) => {
+    const { runWorkflow } = await import('./commands/workflow.js');
+    await runWorkflow(type);
+});
+program
+    .command('quota')
+    .description('Show current generation quota usage')
+    .action(async () => {
+    const { formatQuotaDisplay } = await import('./utils/quota.js');
+    console.log(formatQuotaDisplay());
+});
+program.parse();
+//# 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/mcp/auth.d.ts

@@ -0,0 +1,15 @@
+export type AuthMethod = 'api_key' | 'gcloud_oauth' | 'none';
+export interface AuthConfig {
+    method: AuthMethod;
+    apiKey?: string;
+    projectId?: string;
+}
+/**
+ * Resolve authentication for Stitch MCP.
+ * Priority: env var > .env file > .forgerc.json > none
+ */
+export declare function resolveAuth(): AuthConfig;
+/**
+ * Check if gcloud CLI is available for OAuth fallback.
+ */
+export declare function checkGcloudAvailable(): Promise<boolean>;

package/dist/mcp/auth.js

@@ -0,0 +1,56 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Resolve authentication for Stitch MCP.
+ * Priority: env var > .env file > .forgerc.json > none
+ */
+export function resolveAuth() {
+    // 1. Environment variable
+    if (process.env.STITCH_API_KEY) {
+        return {
+            method: 'api_key',
+            apiKey: process.env.STITCH_API_KEY,
+            projectId: process.env.GOOGLE_CLOUD_PROJECT,
+        };
+    }
+    // 2. .env file
+    const envPath = join(process.cwd(), '.env');
+    if (existsSync(envPath)) {
+        const envContent = readFileSync(envPath, 'utf-8');
+        const apiKeyMatch = envContent.match(/^STITCH_API_KEY=(.+)$/m);
+        const projectMatch = envContent.match(/^GOOGLE_CLOUD_PROJECT=(.+)$/m);
+        if (apiKeyMatch?.[1]?.trim()) {
+            return {
+                method: 'api_key',
+                apiKey: apiKeyMatch[1].trim(),
+                projectId: projectMatch?.[1]?.trim(),
+            };
+        }
+    }
+    // 3. .forgerc.json
+    const rcPath = join(process.cwd(), '.forgerc.json');
+    if (existsSync(rcPath)) {
+        try {
+            const rc = JSON.parse(readFileSync(rcPath, 'utf-8'));
+            if (rc.apiKey) {
+                return { method: 'api_key', apiKey: rc.apiKey, projectId: rc.projectId };
+            }
+        }
+        catch { /* ignore parse errors */ }
+    }
+    return { method: 'none' };
+}
+/**
+ * Check if gcloud CLI is available for OAuth fallback.
+ */
+export async function checkGcloudAvailable() {
+    try {
+        const { execSync } = await import('node:child_process');
+        execSync('gcloud --version', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/mcp/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/mcp/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,0BAA0B;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAClC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;SAC5C,CAAC;IACJ,CAAC;IAED,eAAe;IACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACtE,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC7B,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;aACrC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;YACrD,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC;YAC3E,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACxD,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/mcp/client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MCP Client wrapper for Stitch tools.
+ *
+ * When running inside Claude Code with the Stitch MCP server configured,
+ * tool calls are handled automatically by the MCP protocol.
+ *
+ * This module provides typed wrappers for standalone CLI usage
+ * (outside Claude Code) via direct HTTP calls to the Stitch MCP endpoint.
+ */
+export interface StitchProject {
+    id: string;
+    name: string;
+    createdAt: string;
+    screenCount: number;
+}
+export interface StitchScreen {
+    id: string;
+    name: string;
+    prompt: string;
+    createdAt: string;
+}
+export interface GenerateScreenResult {
+    screenId: string;
+    projectId: string;
+    name: string;
+    htmlCodeUrl?: string;
+    screenshotUrl?: string;
+}
+export interface BuildSiteRoute {
+    screenId: string;
+    route: string;
+}
+export interface BuildSiteResult {
+    pages: Array<{
+        route: string;
+        html: string;
+    }>;
+}
+/**
+ * Direct HTTP client for Stitch MCP endpoint.
+ * Used when running as standalone CLI (not inside Claude Code).
+ */
+export declare class StitchMcpClient {
+    private endpoint;
+    private apiKey;
+    constructor(apiKey?: string, endpoint?: string);
+    private callTool;
+    private isRetryable;
+    private formatError;
+    listProjects(): Promise<StitchProject[]>;
+    getProject(projectId: string): Promise<StitchProject>;
+    listScreens(projectId: string): Promise<StitchScreen[]>;
+    generateScreen(projectId: string, prompt: string, modelId?: string): Promise<GenerateScreenResult>;
+    /** Extract screen data directly from generate_screen_from_text response */
+    private extractScreenFromResponse;
+    getScreenCode(projectId: string, screenId: string, htmlCodeUrl?: string): Promise<string>;
+    getScreenImage(projectId: string, screenId: string): Promise<string>;
+    buildSite(projectId: string, routes: BuildSiteRoute[]): Promise<BuildSiteResult>;
+    /** Extract numeric ID from resource name like "projects/123" or "screens/456" */
+    private extractId;
+    /** Ensure value is a resource name; if it's just an ID, prepend the prefix */
+    private toResourceName;
+    /** Map internal model names to Stitch API model IDs */
+    private mapModelId;
+}