@shadowcoderr/context-graph 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 shadowcoderr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,185 @@
+# ContextGraph
+
+> **A deterministic "Flight Data Recorder" for web applications** — captures rich, AI-ready context from browser sessions in restricted enterprise environments where MCP is unavailable.
+
+[![Version](https://img.shields.io/badge/version-0.3.0-blue)](package.json)
+[![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-green)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](tsconfig.json)
+[![Playwright](https://img.shields.io/badge/Playwright-1.40%2B-orange)](package.json)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey)](LICENSE)
+
+---
+
+## Why ContextGraph?
+
+IDE-based AI agents (Copilot, Cursor, etc.) are blind to your running browser. Without MCP, they cannot see the live DOM, accessibility tree, or real API traffic of the app you are testing. In enterprise environments, MCP and cloud-based recording tools are often blocked by security policy.
+
+ContextGraph solves this by acting as a **pre-processor** — it bridges the gap between manual exploration and AI-powered test generation using only Playwright, which is already whitelisted on most QA teams' machines.
+
+```
+Your Browser Session
+        │
+        ▼
+  ContextGraph          ← You are here
+  (Playwright-native)
+        │
+        ▼
+  Structured Output       ← DOM, Locators, A11y Tree, Network
+  (Local Filesystem)
+        │
+        ▼
+  AI Agent / LLM          ← Receives clean, noise-free context
+  (Copilot / Cursor / Claude)
+        │
+        ▼
+  Generated Tests         ← Playwright .spec.ts files
+```
+
+---
+
+## Quick Start
+
+### Prerequisites
+
+- **Node.js** 18.0.0 or higher
+- **Microsoft Edge** (installed — used as the capture browser)
+- **Windows 10/11** (primary support; Linux/macOS in beta)
+
+### Install
+
+```bash
+npm install -g context-graph
+```
+
+Verify:
+
+```bash
+context-graph --version
+# Context Graph v0.3.0
+```
+
+### Capture Your First Page (2 minutes)
+
+```bash
+# 1. Start a capture session
+context-graph --mode browser --url https://your-app.com
+
+# 2. Navigate through the app — every page you visit is captured
+# 3. Press Ctrl+C when done
+
+# 4. Inspect results
+cat context-graph-output/global_manifest.json
+```
+
+---
+
+## Key Features
+
+| Feature | Description |
+|---|---|
+| 🎯 **Guided Capture** | Captures only what you navigate — no autonomous crawling |
+| 🧹 **Clean DOM Output** | Scripts, event handlers, and noise stripped before saving |
+| 🔑 **Smart Locators** | 5+ selector strategies per element, ranked by resilience |
+| ♿ **Accessibility Tree** | Full ARIA/role hierarchy for semantic understanding |
+| 🌐 **Network Logging** | All HTTP traffic captured with automatic PII redaction |
+| 🔒 **Security by Design** | Credentials, tokens, PII never touch the filesystem |
+| 🧩 **Component Registry** | Tracks reusable UI patterns across captured pages |
+| 📦 **100% Offline** | Zero cloud dependencies, zero telemetry, runs inside enterprise perimeter |
+
+---
+
+## Operating Modes
+
+### Browser Mode — Passive Observer
+
+Best for: understanding app structure, feeding AI with full UI context.
+
+```bash
+context-graph --mode browser --url https://app.example.com
+```
+
+### Recorder Mode — Action Capture
+
+Best for: converting manual test walkthroughs into replayable scripts.
+
+```bash
+context-graph --mode recorder --url https://app.example.com
+```
+
+---
+
+## What You Get
+
+For each captured page, ContextGraph generates:
+
+- **Sanitized DOM** - Clean HTML with scripts removed
+- **Accessibility Tree** - Full ARIA hierarchy and semantic structure  
+- **Smart Locators** - Ranked Playwright selectors (Role → TestID → Label → Text)
+- **Network Log** - HTTP traffic with automatic PII redaction
+- **Screenshots** - Full-page visual captures
+- **Component Registry** - Cross-page UI pattern tracking
+
+---
+
+## Feeding Output to an AI Agent
+
+### What to Give the AI
+
+For test generation, provide the AI these files from a single captured page:
+
+| File | Why it Matters |
+|---|---|
+| `metadata.json` | URL, page title, timing context |
+| `a11y_tree.json` | Semantic structure — what the page *means* |
+| `locators.json` | Ready-to-use, ranked Playwright selectors |
+| `dom_snapshot.html` | Full structural HTML if deep context is needed |
+| `network/traffic_log.jsonl` | What API calls the page makes |
+
+### Example Prompt Structure
+
+```
+I am testing the following web page:
+URL: https://app.example.com/login
+
+Here is the accessibility tree:
+[paste a11y_tree.json]
+
+Here are the available locators:
+[paste locators.json]
+
+Here is the API traffic observed:
+[paste relevant entries from traffic_log.jsonl]
+
+Generate a Playwright test that:
+1. Navigates to the login page
+2. Enters valid credentials
+3. Asserts the dashboard is shown
+```
+
+---
+
+## Documentation
+
+📖 **[Complete User Guide](docs/USER_GUIDE.md)** - Advanced configuration, CLI reference, troubleshooting, and architecture details.
+
+---
+
+## Installation
+
+```bash
+npm install -g context-graph
+```
+
+---
+
+## License
+
+MIT — © Shadow Coderr
+
+---
+
+## Issues & Support
+
+🐛 **[Report Issues](https://github.com/shadowcoderr/ContextGraph/issues)** - Bug reports and feature requests
+
+💬 **[Discussions](https://github.com/shadowcoderr/ContextGraph/discussions)** - Community support and questions

package/dist/analyzers/a11y-extractor.d.ts

@@ -0,0 +1,15 @@
+import { Page } from '@playwright/test';
+import { AccessibilityTree } from '../types/capture';
+export declare class AccessibilityExtractor {
+    extract(page: Page, _includeHidden?: boolean): Promise<AccessibilityTree>;
+    /**
+     * Transform CDP accessibility tree format to our format
+     */
+    private transformCDPSnapshot;
+    /**
+     * Build accessibility tree from DOM when Playwright accessibility API is unavailable
+     */
+    private buildFromDOM;
+    private transformSnapshot;
+}
+//# sourceMappingURL=a11y-extractor.d.ts.map

package/dist/analyzers/a11y-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y-extractor.d.ts","sourceRoot":"","sources":["../../src/analyzers/a11y-extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,sBAAsB;IAC3B,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,GAAE,OAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwCtF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA0C5B;;OAEG;YACW,YAAY;IA+C1B,OAAO,CAAC,iBAAiB;CAkB1B"}

package/dist/analyzers/a11y-extractor.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccessibilityExtractor = void 0;
+class AccessibilityExtractor {
+    async extract(page, _includeHidden = false) {
+        try {
+            // Wait for page to be ready
+            await page.waitForLoadState('domcontentloaded', { timeout: 5000 }).catch(() => { });
+            // Try to get accessibility snapshot via CDP
+            let snapshot = null;
+            try {
+                // Use CDP (Chrome DevTools Protocol) for accessibility snapshot
+                const client = await page.context().newCDPSession(page);
+                snapshot = await client.send('Accessibility.getFullAXTree');
+                if (snapshot && snapshot.nodes && snapshot.nodes.length > 0) {
+                    // Transform CDP format to our format
+                    return this.transformCDPSnapshot(snapshot.nodes[0], snapshot.nodes);
+                }
+            }
+            catch (cdpError) {
+                // CDP not available, fall through to DOM-based approach
+            }
+            // Fallback: build accessibility tree from DOM
+            snapshot = await this.buildFromDOM(page);
+            return this.transformSnapshot(snapshot);
+        }
+        catch (error) {
+            // Final fallback: build from DOM
+            try {
+                const domSnapshot = await this.buildFromDOM(page);
+                return this.transformSnapshot(domSnapshot);
+            }
+            catch (domError) {
+                // Ultimate fallback
+                return {
+                    role: 'WebArea',
+                    name: await page.title().catch(() => ''),
+                    children: [],
+                };
+            }
+        }
+    }
+    /**
+     * Transform CDP accessibility tree format to our format
+     */
+    transformCDPSnapshot(rootNode, allNodes) {
+        const buildNode = (node) => {
+            const children = [];
+            if (node.childIds && node.childIds.length > 0) {
+                for (const childId of node.childIds) {
+                    const childNode = allNodes.find((n) => n.nodeId === childId);
+                    if (childNode) {
+                        children.push(buildNode(childNode));
+                    }
+                }
+            }
+            const result = {
+                role: node.role?.value || 'unknown',
+                name: node.name?.value || '',
+                children: children.length > 0 ? children : [],
+                value: node.value?.value,
+                required: node.properties?.find((p) => p.name === 'required')?.value?.value === true,
+                disabled: node.properties?.find((p) => p.name === 'disabled')?.value?.value === true,
+                focused: node.properties?.find((p) => p.name === 'focused')?.value?.value === true,
+            };
+            // Add optional properties only if they exist
+            const checked = node.properties?.find((p) => p.name === 'checked')?.value?.value;
+            if (checked !== undefined)
+                result.checked = checked;
+            const pressed = node.properties?.find((p) => p.name === 'pressed')?.value?.value;
+            if (pressed !== undefined)
+                result.pressed = pressed;
+            const selected = node.properties?.find((p) => p.name === 'selected')?.value?.value;
+            if (selected !== undefined)
+                result.selected = selected;
+            const expanded = node.properties?.find((p) => p.name === 'expanded')?.value?.value;
+            if (expanded !== undefined)
+                result.expanded = expanded;
+            return result;
+        };
+        return buildNode(rootNode);
+    }
+    /**
+     * Build accessibility tree from DOM when Playwright accessibility API is unavailable
+     */
+    async buildFromDOM(page) {
+        return await page.evaluate(() => {
+            const buildA11yNode = (element) => {
+                const role = element.getAttribute('role') ||
+                    (element.tagName === 'BUTTON' ? 'button' :
+                        element.tagName === 'INPUT' ? 'textbox' :
+                            element.tagName === 'A' ? 'link' :
+                                element.tagName === 'FORM' ? 'form' :
+                                    element.tagName === 'HEADER' ? 'banner' :
+                                        element.tagName === 'NAV' ? 'navigation' :
+                                            element.tagName === 'MAIN' ? 'main' :
+                                                element.tagName === 'FOOTER' ? 'contentinfo' : 'generic');
+                const name = element.getAttribute('aria-label') ||
+                    element.getAttribute('aria-labelledby') ||
+                    element.innerText?.trim() ||
+                    element.getAttribute('alt') ||
+                    element.getAttribute('title') ||
+                    '';
+                const children = [];
+                for (let i = 0; i < element.children.length; i++) {
+                    const child = buildA11yNode(element.children[i]);
+                    if (child)
+                        children.push(child);
+                }
+                const result = {
+                    role,
+                    name: name.substring(0, 100), // Limit name length
+                    children: children.length > 0 ? children : [],
+                    disabled: element.hasAttribute('disabled'),
+                    required: element.hasAttribute('required'),
+                };
+                const checked = element.checked;
+                if (checked)
+                    result.checked = checked;
+                const expanded = element.getAttribute('aria-expanded') === 'true';
+                if (expanded)
+                    result.expanded = expanded;
+                return result;
+            };
+            return buildA11yNode(document.documentElement);
+        });
+    }
+    transformSnapshot(snapshot) {
+        return {
+            role: snapshot.role || 'unknown',
+            name: snapshot.name || '',
+            children: snapshot.children ? snapshot.children.map((child) => this.transformSnapshot(child)) : [],
+            value: snapshot.value,
+            required: snapshot.required,
+            disabled: snapshot.disabled,
+            focused: snapshot.focused,
+            multiline: snapshot.multiline,
+            protected: snapshot.protected,
+            checked: snapshot.checked,
+            pressed: snapshot.pressed,
+            selected: snapshot.selected,
+            expanded: snapshot.expanded,
+            level: snapshot.level,
+        };
+    }
+}
+exports.AccessibilityExtractor = AccessibilityExtractor;
+//# sourceMappingURL=a11y-extractor.js.map

package/dist/analyzers/a11y-extractor.js.map

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

package/dist/analyzers/dom-analyzer.d.ts

@@ -0,0 +1,20 @@
+import { Page } from '@playwright/test';
+export declare class DOMAnalyzer {
+    private serializeFrameContent;
+    analyze(page: Page): Promise<{
+        html: string;
+        frames: Array<{
+            url: string;
+            name: string;
+            content: string;
+        }>;
+    }>;
+    getPerformanceMetrics(page: Page): Promise<{
+        domNodes: number;
+        scripts: number;
+        stylesheets: number;
+        images: number;
+        totalRequests: number;
+    }>;
+}
+//# sourceMappingURL=dom-analyzer.d.ts.map

package/dist/analyzers/dom-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-analyzer.d.ts","sourceRoot":"","sources":["../../src/analyzers/dom-analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAS,MAAM,kBAAkB,CAAC;AAE/C,qBAAa,WAAW;YAGR,qBAAqB;IAyC7B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA4D7G,qBAAqB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CAkBH"}

package/dist/analyzers/dom-analyzer.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DOMAnalyzer = void 0;
+class DOMAnalyzer {
+    async serializeFrameContent(frame) {
+        try {
+            return await frame.evaluate(() => {
+                const serialize = (node) => {
+                    if (!node)
+                        return '';
+                    const nodeType = node.nodeType;
+                    const Node = window.Node;
+                    if (nodeType === Node.DOCUMENT_NODE)
+                        return '<!DOCTYPE html>' + serialize(node.documentElement);
+                    if (nodeType === Node.ELEMENT_NODE) {
+                        const el = node;
+                        let tag = el.tagName.toLowerCase();
+                        let attrs = '';
+                        for (let i = 0; i < el.attributes.length; i++) {
+                            const a = el.attributes[i];
+                            attrs += ` ${a.name}="${a.value}"`;
+                        }
+                        let inner = '';
+                        // Shadow DOM
+                        if (el.shadowRoot) {
+                            inner += '<!--cc-shadow-start-->';
+                            const sr = el.shadowRoot;
+                            for (let i = 0; i < sr.childNodes.length; i++) {
+                                inner += serialize(sr.childNodes[i]);
+                            }
+                            inner += '<!--cc-shadow-end-->';
+                        }
+                        for (let i = 0; i < el.childNodes.length; i++) {
+                            inner += serialize(el.childNodes[i]);
+                        }
+                        return `<${tag}${attrs}>${inner}</${tag}>`;
+                    }
+                    if (nodeType === Node.TEXT_NODE)
+                        return node.nodeValue.replace(/</g, '&lt;');
+                    return '';
+                };
+                return serialize(document);
+            });
+        }
+        catch (error) {
+            return '';
+        }
+    }
+    async analyze(page) {
+        // Get the main document serialized including shadow roots
+        const html = await page.evaluate(() => {
+            const serialize = (node) => {
+                if (!node)
+                    return '';
+                const nodeType = node.nodeType;
+                const Node = window.Node;
+                if (nodeType === Node.DOCUMENT_NODE)
+                    return '<!DOCTYPE html>' + serialize(node.documentElement);
+                if (nodeType === Node.ELEMENT_NODE) {
+                    const el = node;
+                    let tag = el.tagName.toLowerCase();
+                    let attrs = '';
+                    for (let i = 0; i < el.attributes.length; i++) {
+                        const a = el.attributes[i];
+                        attrs += ` ${a.name}="${a.value}"`;
+                    }
+                    let inner = '';
+                    // Shadow DOM
+                    if (el.shadowRoot) {
+                        inner += '<!--cc-shadow-start-->';
+                        const sr = el.shadowRoot;
+                        for (let i = 0; i < sr.childNodes.length; i++) {
+                            inner += serialize(sr.childNodes[i]);
+                        }
+                        inner += '<!--cc-shadow-end-->';
+                    }
+                    for (let i = 0; i < el.childNodes.length; i++) {
+                        inner += serialize(el.childNodes[i]);
+                    }
+                    return `<${tag}${attrs}>${inner}</${tag}>`;
+                }
+                if (nodeType === Node.TEXT_NODE)
+                    return node.nodeValue ? node.nodeValue.replace(/</g, '&lt;') : '';
+                return '';
+            };
+            return serialize(document);
+        });
+        // Gather frames content
+        const frames = [];
+        const framesList = page.frames();
+        for (let i = 0; i < framesList.length; i++) {
+            const frame = framesList[i];
+            if (frame === page.mainFrame())
+                continue; // Skip main frame
+            const content = await this.serializeFrameContent(frame);
+            frames.push({ url: frame.url(), name: frame.name(), content });
+        }
+        // Remove script tags and inline JavaScript from main html
+        let sanitized = html.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '');
+        sanitized = sanitized.replace(/<script[^>]*\/\>/gi, '');
+        sanitized = sanitized.replace(/\s+on\w+="[^"]*"/gi, '');
+        sanitized = sanitized.replace(/\s+on\w+='[^']*'/gi, '');
+        // Add capture timestamp
+        const timestamp = new Date().toISOString();
+        sanitized = sanitized.replace(/<html([^>]*)>/, `<html$1 data-cc-captured="${timestamp}">`);
+        return { html: sanitized, frames };
+    }
+    async getPerformanceMetrics(page) {
+        const metrics = await page.evaluate(() => {
+            const domNodes = document.getElementsByTagName('*').length;
+            const scripts = document.querySelectorAll('script').length;
+            const stylesheets = document.querySelectorAll('link[rel="stylesheet"]').length;
+            const images = document.querySelectorAll('img').length;
+            return {
+                domNodes,
+                scripts,
+                stylesheets,
+                images,
+                totalRequests: 0, // Will be calculated from network events
+            };
+        });
+        return metrics;
+    }
+}
+exports.DOMAnalyzer = DOMAnalyzer;
+//# sourceMappingURL=dom-analyzer.js.map

package/dist/analyzers/dom-analyzer.js.map

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

package/dist/analyzers/locator-generator.d.ts

@@ -0,0 +1,13 @@
+import { Page } from '@playwright/test';
+import { LocatorsData } from '../types/capture';
+export declare class LocatorGenerator {
+    generateLocators(page: Page): Promise<LocatorsData>;
+    private generateElementLocator;
+    private getRole;
+    private getAssociatedLabel;
+    /**
+     * Calculate match count and uniqueness for a locator strategy
+     */
+    private getMatchCount;
+}
+//# sourceMappingURL=locator-generator.d.ts.map

package/dist/analyzers/locator-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locator-generator.d.ts","sourceRoot":"","sources":["../../src/analyzers/locator-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAA2B,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGzE,qBAAa,gBAAgB;IACrB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC;YAmG3C,sBAAsB;YAyKtB,OAAO;YAuCP,kBAAkB;IAoChC;;OAEG;YACW,aAAa;CA4C5B"}