@shadowcoderr/context-graph 0.3.2 → 0.3.4

package/dist/analyzers/screenshot-capturer.d.ts

@@ -0,0 +1,73 @@
+import { Page } from '@playwright/test';
+export interface ScreenshotOptions {
+    fullPage: boolean;
+    format: 'png' | 'jpeg' | 'webp';
+    quality?: number;
+    elementTargeting: boolean;
+    maxElements: number;
+    timeout: number;
+}
+export interface ScreenshotResult {
+    fullPagePath?: string | undefined;
+    elementPaths: Array<{
+        elementId: string;
+        path: string;
+        selector: string;
+        label?: string | undefined;
+    }>;
+    capturedAt: string;
+    dimensions?: {
+        width: number;
+        height: number;
+    } | undefined;
+}
+export declare class ScreenshotCapturer {
+    private options;
+    constructor(options?: Partial<ScreenshotOptions>);
+    /**
+     * Capture a full-page screenshot and return the saved path, or null on failure.
+     */
+    captureFullPage(page: Page, outputDir: string, _captureId: string): Promise<string | null>;
+    /**
+     * Capture individual element screenshots for key interactive elements.
+     * Elements that are not visible, off-screen, or zero-size are skipped gracefully.
+     */
+    captureElementScreenshots(page: Page, outputDir: string, _captureId: string, elements: Array<{
+        elementId: string;
+        selector: string;
+        label?: string;
+    }>): Promise<ScreenshotResult['elementPaths']>;
+    /**
+     * Orchestrates capturing screenshots for a page. Returns a ScreenshotResult
+     * with all paths.  The caller is responsible for creating `pageDir`.
+     */
+    capturePageScreenshots(page: Page, pageDir: string, captureId: string, interactiveElements?: Array<{
+        elementId: string;
+        selector: string;
+        label?: string;
+    }>): Promise<ScreenshotResult>;
+    /**
+     * Build a list of element descriptors suitable for element screenshot capture
+     * from locators data.
+     */
+    static buildElementTargets(locatorsElements: Array<{
+        elementId: string;
+        tagName: string;
+        text?: string;
+        attributes: Record<string, any>;
+        computedState: {
+            isVisible: boolean;
+            isEnabled: boolean;
+        };
+        locators: Array<{
+            strategy: string;
+            value: string;
+            isUnique?: boolean;
+        }>;
+    }>): Array<{
+        elementId: string;
+        selector: string;
+        label?: string;
+    }>;
+}
+//# sourceMappingURL=screenshot-capturer.d.ts.map

package/dist/analyzers/screenshot-capturer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-capturer.d.ts","sourceRoot":"","sources":["../../src/analyzers/screenshot-capturer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAKxC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,EAAE,KAAK,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5B,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,SAAS,CAAC;CACf;AAWD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAIhD;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA6BhG;;;OAGG;IACG,yBAAyB,CAC7B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GACvE,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAmD5C;;;OAGG;IACG,sBAAsB,CAC1B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,mBAAmB,GAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAM,GACvF,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;OAGG;IACH,MAAM,CAAC,mBAAmB,CACxB,gBAAgB,EAAE,KAAK,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,aAAa,EAAE;YAAE,SAAS,EAAE,OAAO,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;QAC1D,QAAQ,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAC1E,CAAC,GACD,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA0BlE"}

package/dist/analyzers/screenshot-capturer.js

@@ -0,0 +1,190 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScreenshotCapturer = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const DEFAULT_OPTIONS = {
+    fullPage: true,
+    format: 'png',
+    quality: 90,
+    elementTargeting: false,
+    maxElements: 10,
+    timeout: 15000,
+};
+class ScreenshotCapturer {
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Capture a full-page screenshot and return the saved path, or null on failure.
+     */
+    async captureFullPage(page, outputDir, _captureId) {
+        try {
+            await fs.ensureDir(outputDir);
+            const filename = `screenshot.${this.options.format}`;
+            const filepath = path.join(outputDir, filename);
+            const screenshotOpts = {
+                path: filepath,
+                fullPage: this.options.fullPage,
+                type: this.options.format === 'webp' ? 'png' : this.options.format, // Playwright screenshot doesn't support webp directly in some versions, fallback to png for type if it's webp or just cast to any
+                animations: 'disabled',
+                timeout: this.options.timeout,
+            };
+            // quality only applies to lossy formats
+            if (this.options.format !== 'png' && this.options.quality !== undefined) {
+                screenshotOpts.quality = this.options.quality;
+            }
+            await page.screenshot(screenshotOpts);
+            logger_1.logger.info(`Full-page screenshot saved: ${filepath}`);
+            return filepath;
+        }
+        catch (error) {
+            logger_1.logger.warn(`Failed to capture full-page screenshot: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Capture individual element screenshots for key interactive elements.
+     * Elements that are not visible, off-screen, or zero-size are skipped gracefully.
+     */
+    async captureElementScreenshots(page, outputDir, _captureId, elements) {
+        const results = [];
+        await fs.ensureDir(outputDir);
+        const batch = elements.slice(0, this.options.maxElements);
+        for (const element of batch) {
+            try {
+                const locator = page.locator(element.selector).first();
+                const count = await locator.count().catch(() => 0);
+                if (count === 0)
+                    continue;
+                const isVisible = await locator.isVisible({ timeout: 2000 }).catch(() => false);
+                if (!isVisible)
+                    continue;
+                const box = await locator.boundingBox().catch(() => null);
+                if (!box || box.width === 0 || box.height === 0)
+                    continue;
+                const safe = element.elementId.replace(/[^a-z0-9_-]/gi, '_');
+                const filename = `element_${safe}.${this.options.format}`;
+                const filepath = path.join(outputDir, filename);
+                const eleOpts = {
+                    path: filepath,
+                    type: this.options.format === 'webp' ? 'png' : this.options.format,
+                    animations: 'disabled',
+                    timeout: this.options.timeout,
+                };
+                if (this.options.format !== 'png' && this.options.quality !== undefined) {
+                    eleOpts.quality = this.options.quality;
+                }
+                await locator.screenshot(eleOpts);
+                results.push({
+                    elementId: element.elementId,
+                    path: filepath,
+                    selector: element.selector,
+                    label: element.label || undefined
+                });
+                logger_1.logger.debug(`Element screenshot saved: ${filepath}`);
+            }
+            catch (error) {
+                logger_1.logger.debug(`Skipping element screenshot (${element.elementId}): ${error.message}`);
+            }
+        }
+        return results;
+    }
+    /**
+     * Orchestrates capturing screenshots for a page. Returns a ScreenshotResult
+     * with all paths.  The caller is responsible for creating `pageDir`.
+     */
+    async capturePageScreenshots(page, pageDir, captureId, interactiveElements = []) {
+        const screenshotsDir = path.join(pageDir, 'screenshots');
+        const result = {
+            elementPaths: [],
+            capturedAt: new Date().toISOString(),
+        };
+        // Full-page screenshot
+        const fullPagePath = await this.captureFullPage(page, screenshotsDir, captureId);
+        if (fullPagePath) {
+            result.fullPagePath = fullPagePath;
+            // Attempt to read dimensions via viewport
+            try {
+                const vp = page.viewportSize();
+                if (vp) {
+                    result.dimensions = { width: vp.width, height: vp.height };
+                }
+            }
+            catch (error) {
+                logger_1.logger.debug(`Failed to get viewport size: ${error.message}`);
+            }
+        }
+        // Optional element-level screenshots
+        if (this.options.elementTargeting && interactiveElements.length > 0) {
+            const elementsDir = path.join(screenshotsDir, 'elements');
+            result.elementPaths = await this.captureElementScreenshots(page, elementsDir, captureId, interactiveElements);
+        }
+        return result;
+    }
+    /**
+     * Build a list of element descriptors suitable for element screenshot capture
+     * from locators data.
+     */
+    static buildElementTargets(locatorsElements) {
+        return locatorsElements
+            .filter(el => el.computedState.isVisible && el.computedState.isEnabled)
+            .filter(el => ['button', 'a', 'input', 'select', 'textarea'].includes(el.tagName))
+            .map(el => {
+            // Prefer a unique locator or fall back to the first available
+            const best = el.locators.find(l => l.isUnique && l.strategy === 'testid') ||
+                el.locators.find(l => l.isUnique && l.strategy === 'role') ||
+                el.locators.find(l => l.isUnique) ||
+                el.locators[0];
+            if (!best)
+                return null;
+            return {
+                elementId: el.elementId,
+                selector: el.attributes?.['data-testid']
+                    ? `[data-testid="${el.attributes['data-testid']}"]`
+                    : el.attributes?.id
+                        ? `#${el.attributes.id}`
+                        : best.value,
+                label: el.text?.trim().substring(0, 40) || el.attributes?.['aria-label'] || undefined,
+            };
+        })
+            .filter(Boolean);
+    }
+}
+exports.ScreenshotCapturer = ScreenshotCapturer;
+//# sourceMappingURL=screenshot-capturer.js.map

package/dist/analyzers/screenshot-capturer.js.map

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

package/dist/cli/index.js

@@ -13,11 +13,12 @@ const runtime_1 = require("../core/runtime");
 const loader_1 = require("../config/loader");
 const validators_1 = require("../utils/validators");
 const logger_1 = require("../utils/logger");
+const version_1 = require("../utils/version");
 const program = new commander_1.Command();
 program
     .name('context-graph')
     .description('A deterministic "Flight Data Recorder" for web applications')
-    .version('0.3.0');
+    .version((0, version_1.getVersion)());
 program
     .argument('[startUrl]', 'Starting URL (optional)')
     .option('-m, --mode <type>', 'Operating mode (browser|recorder)', 'browser')
@@ -112,13 +113,22 @@ program.action(async (startUrl, options) => {
         await runtime.setupPage(page);
         if (finalStartUrl) {
             spinner.text = `Navigating to ${finalStartUrl}...`;
-            await page.goto(finalStartUrl, { waitUntil: 'networkidle' });
-            // Give a moment for any post-load scripts to run
-            await new Promise(r => setTimeout(r, 1000));
-            // Ensure initial page is captured (fallback if events didn't fire)
-            await runtime.capturePageIfNeeded(page);
+            try {
+                await page.goto(finalStartUrl, { waitUntil: 'domcontentloaded' });
+                spinner.succeed(`Navigated to ${finalStartUrl}`);
+                // Give a moment for any post-load scripts to run
+                await new Promise(r => setTimeout(r, 1000));
+                // Ensure initial page is captured (fallback if events didn't fire)
+                await runtime.capturePageIfNeeded(page);
+            }
+            catch (error) {
+                spinner.fail(`Failed to navigate to ${finalStartUrl}`);
+                throw error;
+            }
+        }
+        else {
+            spinner.stop();
         }
-        spinner.stop();
         console.log(chalk_1.default.green('✓ Browser ready!'));
         console.log(chalk_1.default.blue('Navigate through the application. Each page will be captured automatically.'));
         console.log(chalk_1.default.yellow('Press Ctrl+C to stop and save all data...'));

package/dist/cli/index.js.map

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

package/dist/core/capture-engine.d.ts

@@ -6,47 +6,52 @@ export declare class CaptureEngine {
     private a11yExtractor;
     private locatorGenerator;
     private networkLogger;
+    private screenshotCapturer;
     private redactor;
     private validator;
     constructor(config: Config);
     attachNetworkListeners(page: Page): Promise<void>;
-    capturePageSnapshot(page: Page, config: Config, consoleMessages?: any[]): Promise<PageSnapshot>;
+    /**
+     * Capture a full snapshot of the current page state.
+     *
+     * @param page            — Playwright Page instance
+     * @param config          — Active configuration
+     * @param consoleMessages — Console messages buffered by BrowserAdapter
+     * @param pageDir         — If provided, full-page screenshots are captured here.
+     *                          The caller is responsible for ensuring the directory
+     *                          exists before passing this parameter.
+     */
+    capturePageSnapshot(page: Page, config: Config, consoleMessages?: any[], pageDir?: string): Promise<PageSnapshot>;
     private getFrameHierarchy;
-    getRedactionAudit(): import("../types/storage").RedactionAuditEntry[];
-    private generatePageName;
-    private sanitize;
     /**
-     * Compute a content hash for change detection
-     * Combines DOM, accessibility tree, and locators into a single hash
+     * Compute a structural fingerprint of the page for change detection.
+     *
+     * Instead of truncating the raw HTML at 5 000 chars (which causes SPAs with
+     * large identical `<head>` sections to hash identically across routes), we
+     * extract a token stream of `tagName[#id][@role]` from the DOM.  This is
+     * order-sensitive, compact, and captures the semantic structure without
+     * being affected by text-content changes that don't alter layout.
      */
     private computeContentHash;
     /**
-     * Normalize DOM for hashing by removing dynamic content
+     * Extract a structural token stream from HTML rather than truncating text.
+     * Produces strings like `div#app@main|button|input@textbox` — semantically
+     * rich but immune to text-content noise and `<head>` boilerplate.
+     *
+     * Up to 500 tokens are extracted to bound memory usage while covering
+     * enough of the page to reliably detect structural changes.
      */
     private normalizeDomForHash;
-    /**
-     * Normalize accessibility tree for hashing
-     */
     private normalizeA11yForHash;
-    /**
-     * Capture page state information
-     */
+    private generatePageName;
+    private sanitizeName;
     private capturePageState;
-    /**
-     * Capture network request summary
-     */
     private captureNetworkSummary;
-    /**
-     * Capture enhanced timing metrics
-     */
     private captureEnhancedTiming;
-    /**
-     * Enhance locators data with CSS styles, viewport info, and form details
-     */
     private enhanceLocatorsData;
-    /**
-     * Capture form field details
-     */
     private captureFormFieldDetails;
+    getRedactionAudit(): import("../types/storage").RedactionAuditEntry[];
+    /** Network event count — passed to StorageEngine for statistics */
+    getNetworkEventCount(): number;
 }
 //# sourceMappingURL=capture-engine.d.ts.map

package/dist/core/capture-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture-engine.d.ts","sourceRoot":"","sources":["../../src/core/capture-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAShD,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAgB;gBAErB,MAAM,EAAE,MAAM;IASpB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,YAAY,CAAC;YAwG3F,iBAAiB;IAkB/B,iBAAiB;IAIjB,OAAO,CAAC,gBAAgB;IA8CxB,OAAO,CAAC,QAAQ;IAIhB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;YACW,gBAAgB;IAgE9B;;OAEG;YACW,qBAAqB;IA2CnC;;OAEG;YACW,qBAAqB;IA6BnC;;OAEG;YACW,mBAAmB;IA8GjC;;OAEG;YACW,uBAAuB;CAuEtC"}
+{"version":3,"file":"capture-engine.d.ts","sourceRoot":"","sources":["../../src/core/capture-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhD,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAgB;gBAErB,MAAM,EAAE,MAAM;IAgBpB,sBAAsB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;;;;;;OASG;IACG,mBAAmB,CACvB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,GAAG,EAAO,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC;YAgJV,iBAAiB;IAuB/B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,YAAY;YAUN,gBAAgB;YA4DhB,qBAAqB;YAwCrB,qBAAqB;YA8BrB,mBAAmB;YAyHnB,uBAAuB;IA6DrC,iBAAiB;IAIjB,mEAAmE;IACnE,oBAAoB,IAAI,MAAM;CAG/B"}