afterburn-cli 1.0.0

package/dist/discovery/discovery-pipeline.js

@@ -0,0 +1,256 @@
+// Discovery pipeline orchestrator: crawl + elements + SPA + links + sitemap + workflows
+import { SiteCrawler } from './crawler.js';
+import { detectSPAFramework, interceptRouteChanges } from './spa-detector.js';
+import { discoverElements, discoverHiddenElements } from './element-mapper.js';
+import { validateLinks, createLinkValidationState } from './link-validator.js';
+import { buildSitemap, printSitemapTree } from './sitemap-builder.js';
+import { WorkflowPlanner } from '../planning/index.js';
+import { generateHeuristicPlans } from '../planning/heuristic-planner.js';
+import { GeminiClient } from '../ai/index.js';
+import { BrowserManager } from '../browser/index.js';
+import { ScreenshotManager } from '../screenshots/index.js';
+import { ArtifactStorage } from '../artifacts/index.js';
+export async function resolveWorkflowPlans(planPromise, sitemap) {
+    if (!planPromise) {
+        return {
+            workflowPlans: generateHeuristicPlans(sitemap),
+            usedHeuristicFallback: true,
+        };
+    }
+    try {
+        const workflowPlans = await planPromise;
+        return {
+            workflowPlans,
+            usedHeuristicFallback: false,
+        };
+    }
+    catch {
+        return {
+            workflowPlans: generateHeuristicPlans(sitemap),
+            usedHeuristicFallback: true,
+        };
+    }
+}
+/**
+ * Runs complete Phase 2 discovery pipeline: crawl, discover elements, detect SPA,
+ * validate links, build sitemap, generate workflow plans.
+ *
+ * @param options Discovery configuration
+ * @returns Complete discovery artifact with sitemap and workflow plans
+ */
+export async function runDiscovery(options) {
+    const { targetUrl, sessionId, userHints = [], maxPages = 10, headless = true, onProgress = (msg) => console.log(msg) } = options;
+    // Step 1: Initialize managers
+    const browserManager = new BrowserManager({ headless });
+    const screenshotManager = new ScreenshotManager();
+    const artifactStorage = new ArtifactStorage();
+    let spaFramework = { framework: 'none' };
+    let spaRoutes = [];
+    const allBrokenLinks = [];
+    const linkValidationState = createLinkValidationState();
+    try {
+        // Step 2: Launch browser
+        onProgress('Launching browser...');
+        await browserManager.launch();
+        // Block heavy resources during discovery (images, fonts, video, analytics)
+        // Keep SVG — icon-only buttons need them for element discovery
+        const ctx = browserManager.getContext();
+        if (ctx) {
+            await ctx.route('**/*.{png,jpg,jpeg,gif,webp,woff,woff2,ttf,mp4,mp3}', r => r.abort());
+            await ctx.route('**/analytics**', r => r.abort());
+            await ctx.route('**/gtag**', r => r.abort());
+        }
+        // Step 3: SPA Detection (first page only)
+        onProgress(`Detecting SPA framework on ${targetUrl}...`);
+        const spaDetectionPage = await browserManager.newPage(targetUrl, { networkIdleTimeout: 5000 });
+        try {
+            // Detect framework
+            spaFramework = await detectSPAFramework(spaDetectionPage);
+            if (spaFramework.framework !== 'none') {
+                onProgress(`Detected ${spaFramework.framework} app${spaFramework.version ? ' v' + spaFramework.version : ''}`);
+                // Intercept routes if SPA detected
+                onProgress('Discovering client-side routes...');
+                spaRoutes = await interceptRouteChanges(spaDetectionPage);
+                if (spaRoutes.length > 0) {
+                    onProgress(`Found ${spaRoutes.length} client-side routes`);
+                }
+            }
+            else {
+                onProgress('No SPA framework detected');
+            }
+        }
+        finally {
+            await spaDetectionPage.close();
+        }
+        // Step 4: Define pageProcessor callback
+        // This is called by the crawler for each page BEFORE it closes the page
+        let pageIndex = 0;
+        const pageProcessor = async (page, url) => {
+            pageIndex++;
+            try {
+                // Discover visible elements
+                const visibleElements = await discoverElements(page, url);
+                // Discover hidden elements (modals, dropdowns)
+                const hiddenElements = await discoverHiddenElements(page, url);
+                // Merge visible + hidden (deduplicate by selector/href)
+                const mergedElements = {
+                    forms: [...visibleElements.forms],
+                    buttons: [...visibleElements.buttons],
+                    links: [...visibleElements.links],
+                    menus: [...visibleElements.menus],
+                    otherInteractive: [...visibleElements.otherInteractive],
+                };
+                // Merge hidden forms
+                for (const form of hiddenElements.forms) {
+                    if (!mergedElements.forms.some(f => f.selector === form.selector)) {
+                        mergedElements.forms.push(form);
+                    }
+                }
+                // Merge hidden buttons
+                for (const button of hiddenElements.buttons) {
+                    if (!mergedElements.buttons.some(b => b.selector === button.selector)) {
+                        mergedElements.buttons.push(button);
+                    }
+                }
+                // Merge hidden links
+                for (const link of hiddenElements.links) {
+                    if (!mergedElements.links.some(l => l.href === link.href)) {
+                        mergedElements.links.push(link);
+                    }
+                }
+                // Merge hidden menus
+                for (const menu of hiddenElements.menus) {
+                    if (!mergedElements.menus.some(m => m.selector === menu.selector)) {
+                        mergedElements.menus.push(menu);
+                    }
+                }
+                // Merge other interactive
+                for (const other of hiddenElements.otherInteractive) {
+                    if (!mergedElements.otherInteractive.some(o => o.selector === other.selector)) {
+                        mergedElements.otherInteractive.push(other);
+                    }
+                }
+                // Capture screenshot
+                const screenshotRef = await screenshotManager.capture(page, `page-${pageIndex}`);
+                // Validate links
+                const brokenLinksOnPage = await validateLinks(mergedElements.links, page, linkValidationState);
+                allBrokenLinks.push(...brokenLinksOnPage);
+                // Report progress
+                onProgress(`  Crawled: ${url} (${pageIndex} pages found)`);
+                // Return partial PageData to merge with crawler's base data
+                return {
+                    forms: mergedElements.forms,
+                    buttons: mergedElements.buttons,
+                    menus: mergedElements.menus,
+                    otherInteractive: mergedElements.otherInteractive,
+                    screenshotRef,
+                    spaFramework,
+                };
+            }
+            catch (error) {
+                // Log warning but continue crawl
+                console.warn(`Warning: Failed to process page ${url}:`, error instanceof Error ? error.message : String(error));
+                return {
+                    forms: [],
+                    buttons: [],
+                    menus: [],
+                    otherInteractive: [],
+                };
+            }
+        };
+        // Step 5: Construct SiteCrawler with pageProcessor and additionalUrls
+        const crawlerOptions = {
+            maxPages,
+            onPageCrawled: (url, count) => {
+                // Progress already handled in pageProcessor
+            },
+            pageProcessor,
+            additionalUrls: spaRoutes,
+        };
+        const crawler = new SiteCrawler(browserManager, crawlerOptions);
+        // Step 6: Run crawler
+        onProgress('Starting site crawl...');
+        const crawlResult = await crawler.crawl(targetUrl, spaRoutes);
+        // Update crawl result with our collected data
+        crawlResult.brokenLinks = allBrokenLinks;
+        crawlResult.totalLinksChecked = linkValidationState.checkedCount;
+        crawlResult.spaDetected = spaFramework;
+        onProgress(`Crawl complete: ${crawlResult.totalPagesDiscovered} pages discovered`);
+        // Step 7: Build sitemap
+        onProgress('Building sitemap...');
+        const sitemap = buildSitemap(crawlResult.pages, targetUrl);
+        console.log('\nSite Map:');
+        console.log(printSitemapTree(sitemap));
+        // Step 8: Generate workflow plans (overlapped with browser cleanup)
+        let workflowPlans = [];
+        // Check if GEMINI_API_KEY is set
+        const geminiApiKey = process.env.GEMINI_API_KEY;
+        // Fire off planning as a non-blocking promise (doesn't need browser)
+        let planPromise = null;
+        if (geminiApiKey) {
+            onProgress('Generating workflow plans with AI...');
+            const geminiClient = new GeminiClient(geminiApiKey);
+            const workflowPlanner = new WorkflowPlanner(geminiClient);
+            planPromise = workflowPlanner.generatePlans(sitemap, userHints);
+        }
+        // Meanwhile, close browser (planning doesn't need it)
+        onProgress('Closing browser...');
+        await browserManager.close();
+        // Now await planning result (or generate heuristic plans)
+        const { workflowPlans: resolvedPlans, usedHeuristicFallback } = await resolveWorkflowPlans(planPromise, sitemap);
+        workflowPlans = resolvedPlans;
+        if (usedHeuristicFallback) {
+            if (planPromise) {
+                console.warn('\nAI planning failed - using heuristic test plans');
+            }
+            else {
+                console.warn('\nUsing heuristic test plans (set GEMINI_API_KEY for smarter AI-driven testing)');
+            }
+            if (workflowPlans.length > 0) {
+                console.log('\nDiscovered Workflows (heuristic):');
+                workflowPlans.forEach((plan, index) => {
+                    console.log(`  ${index + 1}. ${plan.workflowName} (${plan.priority}) - ${plan.steps.length} steps`);
+                });
+            }
+        }
+        else if (workflowPlans.length > 0) {
+            console.log('\nDiscovered Workflows:');
+            workflowPlans.forEach((plan, index) => {
+                console.log(`  ${index + 1}. ${plan.workflowName} (${plan.priority}) - ${plan.steps.length} steps`);
+            });
+        }
+        else {
+            console.log('\nNo workflows generated');
+        }
+        // Step 9: Save discovery artifact (after plans are ready)
+        const artifact = {
+            version: '1.0',
+            stage: 'discovery',
+            timestamp: new Date().toISOString(),
+            sessionId,
+            targetUrl,
+            sitemap,
+            crawlResult,
+            workflowPlans,
+            userHints,
+        };
+        onProgress('Saving discovery artifact...');
+        await artifactStorage.save(artifact);
+        // Step 10: Return artifact
+        return artifact;
+    }
+    catch (error) {
+        console.error('Discovery pipeline failed:', error instanceof Error ? error.message : String(error));
+        throw error;
+    }
+    finally {
+        // Always close browser even on error
+        try {
+            await browserManager.close();
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=discovery-pipeline.js.map

package/dist/discovery/discovery-pipeline.js.map

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

package/dist/discovery/element-mapper.d.ts

@@ -0,0 +1,21 @@
+import type { Page } from 'playwright';
+import type { FormInfo, InteractiveElement, LinkInfo } from '../types/discovery.js';
+/**
+ * Container for all discovered interactive elements on a page
+ */
+export interface DiscoveredElements {
+    forms: FormInfo[];
+    buttons: InteractiveElement[];
+    links: LinkInfo[];
+    menus: InteractiveElement[];
+    otherInteractive: InteractiveElement[];
+}
+/**
+ * Discover all visible interactive elements on a page
+ */
+export declare function discoverElements(page: Page, pageUrl: string): Promise<DiscoveredElements>;
+/**
+ * Discover hidden elements by triggering interactions (buttons, menus, modals)
+ * Returns only NEWLY discovered elements (not present in initial page load)
+ */
+export declare function discoverHiddenElements(page: Page, pageUrl: string): Promise<DiscoveredElements>;