@shadowcoderr/context-graph 0.3.3 → 0.3.5

package/dist/exporters/ai-context-bundler.js

@@ -0,0 +1,380 @@
+"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.AIContextBundler = void 0;
+// Developer: Shadow Coderr, Architect
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const version_1 = require("../utils/version");
+const DEFAULT_OPTIONS = {
+    format: 'markdown',
+    maxElementsPerPage: 30,
+    maxA11yDepth: 5,
+    includeNetwork: true,
+    includeConsoleErrors: true,
+    outputFileName: 'ai_context_bundle',
+};
+/**
+ * AIContextBundler
+ *
+ * Packages one or all captured pages into a single Markdown (or JSON) file
+ * that can be pasted directly into an AI IDE agent (Copilot, Cursor, Claude)
+ * for immediate test generation or analysis.
+ *
+ * Usage (after a ContextGraph capture session):
+ *
+ *   const bundler = new AIContextBundler(outputDir);
+ *   await bundler.bundle();
+ *   // → context-graph-output/bundles/ai_context_bundle.md
+ *
+ * The resulting file contains:
+ *   - Session summary (domain, page count, captured timestamp)
+ *   - Per-page: interactive element table, condensed a11y tree,
+ *     API calls observed, console errors, and form field details
+ *   - Ready-to-use prompt template at the end
+ */
+class AIContextBundler {
+    outputDir;
+    options;
+    constructor(outputDir, options) {
+        this.outputDir = path.resolve(outputDir);
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    // ── Public API ────────────────────────────────────────────────────────────────
+    /**
+     * Bundle all captured pages in the output directory into a single file.
+     * Returns the path to the generated bundle.
+     */
+    async bundle() {
+        logger_1.logger.info('AIContextBundler: starting bundle generation');
+        const manifest = await this.loadManifest();
+        const domain = this.detectDomain();
+        if (!domain) {
+            throw new Error('No captured domain found in output directory');
+        }
+        const pagesDir = path.join(this.outputDir, domain, 'pages');
+        if (!(await fs.pathExists(pagesDir))) {
+            throw new Error(`Pages directory not found: ${pagesDir}`);
+        }
+        const pageDirs = (await fs.readdir(pagesDir, { withFileTypes: true }))
+            .filter(d => d.isDirectory())
+            .map(d => d.name)
+            .sort();
+        const bundledPages = [];
+        for (const pageName of pageDirs) {
+            try {
+                const bundledPage = await this.bundlePage(path.join(pagesDir, pageName), pageName);
+                if (bundledPage)
+                    bundledPages.push(bundledPage);
+            }
+            catch (error) {
+                logger_1.logger.warn(`AIContextBundler: skipping page ${pageName}: ${error.message}`);
+            }
+        }
+        if (bundledPages.length === 0) {
+            throw new Error('No pages could be bundled — ensure at least one capture has been performed');
+        }
+        const outputPath = await this.write(bundledPages, domain, manifest);
+        logger_1.logger.info(`AIContextBundler: bundle saved to ${outputPath}`);
+        return outputPath;
+    }
+    /**
+     * Bundle a single specific page by page name.
+     */
+    async bundleSinglePage(pageName) {
+        const domain = this.detectDomain();
+        if (!domain)
+            throw new Error('No captured domain found');
+        const pageDir = path.join(this.outputDir, domain, 'pages', pageName);
+        if (!(await fs.pathExists(pageDir))) {
+            throw new Error(`Page directory not found: ${pageDir}`);
+        }
+        const bundledPage = await this.bundlePage(pageDir, pageName);
+        if (!bundledPage)
+            throw new Error(`Could not bundle page: ${pageName}`);
+        return this.write([bundledPage], domain, null);
+    }
+    // ── Private: loading and parsing ──────────────────────────────────────────────
+    async loadManifest() {
+        const manifestPath = path.join(this.outputDir, 'global_manifest.json');
+        if (!(await fs.pathExists(manifestPath)))
+            return null;
+        return fs.readJson(manifestPath).catch(() => null);
+    }
+    detectDomain() {
+        try {
+            const entries = fs.readdirSync(this.outputDir, { withFileTypes: true });
+            const domainDir = entries.find(e => e.isDirectory() && !['scripts', 'bundles', 'logs'].includes(e.name));
+            return domainDir?.name || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async bundlePage(pageDir, pageName) {
+        const metadataPath = path.join(pageDir, 'metadata.json');
+        const locatorsPath = path.join(pageDir, 'locators.json');
+        const a11yPath = path.join(pageDir, 'a11y_tree.json');
+        const consolePath = path.join(pageDir, 'console_errors.json');
+        if (!(await fs.pathExists(metadataPath)))
+            return null;
+        const metadata = await fs.readJson(metadataPath);
+        const locators = await fs.readJson(locatorsPath).catch(() => ({ elements: [] }));
+        const a11y = await fs.readJson(a11yPath).catch(() => null);
+        const consoleData = await fs.readJson(consolePath).catch(() => null);
+        // ── Interactive elements ──
+        const elements = this.extractElements(locators.elements || [], this.options.maxElementsPerPage);
+        // ── Form fields ──
+        const formFields = this.extractFormFields(locators.formFields || [], locators.elements || []);
+        // ── A11y summary ──
+        const a11ySummary = a11y ? this.summarizeA11y(a11y, 0, this.options.maxA11yDepth) : '(unavailable)';
+        // ── API calls from network summary ──
+        const apiCalls = this.extractApiCalls(metadata.networkSummary);
+        // ── Console errors ──
+        const consoleErrors = consoleData?.errors?.slice(0, 5) || [];
+        return {
+            url: metadata.url,
+            title: metadata.title,
+            pageName,
+            capturedAt: metadata.timestamp,
+            elements,
+            a11ySummary,
+            apiCalls,
+            consoleErrors,
+            formFields,
+        };
+    }
+    extractElements(rawElements, maxCount) {
+        if (!rawElements)
+            return [];
+        return rawElements
+            .filter(e => e.computedState?.isVisible)
+            .slice(0, maxCount)
+            .map(e => {
+            const best = e.locators?.find((l) => l.isUnique && l.strategy === 'testid') ||
+                e.locators?.find((l) => l.isUnique && l.strategy === 'role') ||
+                e.locators?.find((l) => l.isUnique) ||
+                e.locators?.[0];
+            const states = [];
+            if (!e.computedState?.isEnabled)
+                states.push('disabled');
+            if (e.computedState?.isChecked)
+                states.push('checked');
+            if (e.computedState?.isEditable)
+                states.push('editable');
+            return {
+                role: e.tagName,
+                name: e.text?.trim().substring(0, 50) || e.attributes?.['aria-label'] || undefined,
+                bestLocator: best?.value || `locator('[data-cc-element-id="${e.elementId}"]')`,
+                state: states.join(', ') || 'enabled',
+                position: e.position?.x != null && e.position?.y != null
+                    ? `(${e.position.x}, ${e.position.y})`
+                    : undefined,
+            };
+        });
+    }
+    extractFormFields(formFields, elements) {
+        const result = [];
+        for (const field of formFields) {
+            const el = elements.find(e => e.elementId === field.elementId);
+            const best = el?.locators?.find((l) => l.isUnique && l.strategy === 'label') ||
+                el?.locators?.find((l) => l.isUnique) ||
+                el?.locators?.[0];
+            result.push({
+                label: field.label,
+                type: field.fieldType || 'text',
+                required: field.required || false,
+                locator: best?.value || field.elementId,
+            });
+        }
+        return result;
+    }
+    summarizeA11y(node, depth, maxDepth) {
+        if (!node || depth > maxDepth)
+            return '';
+        const indent = '  '.repeat(depth);
+        const name = node.name ? ` "${node.name.substring(0, 60)}"` : '';
+        const states = [];
+        if (node.required)
+            states.push('required');
+        if (node.disabled)
+            states.push('disabled');
+        if (node.checked)
+            states.push('checked');
+        if (node.expanded !== undefined)
+            states.push(node.expanded ? 'expanded' : 'collapsed');
+        const stateStr = states.length ? ` [${states.join(', ')}]` : '';
+        let result = `${indent}${node.role}${name}${stateStr}\n`;
+        const children = node.children || [];
+        for (const child of children.slice(0, 10)) {
+            result += this.summarizeA11y(child, depth + 1, maxDepth);
+        }
+        return result;
+    }
+    extractApiCalls(networkSummary) {
+        if (!networkSummary?.apiEndpoints)
+            return [];
+        return networkSummary.apiEndpoints.slice(0, 15).map((ep) => ({
+            method: 'GET/POST',
+            path: ep,
+        }));
+    }
+    // ── Private: output generation ────────────────────────────────────────────────
+    async write(pages, domain, manifest) {
+        const bundlesDir = path.join(this.outputDir, 'bundles');
+        await fs.ensureDir(bundlesDir);
+        const ext = this.options.format === 'json' ? 'json' : 'md';
+        const outputPath = path.join(bundlesDir, `${this.options.outputFileName}.${ext}`);
+        const content = this.options.format === 'json'
+            ? this.renderJson(pages, domain, manifest)
+            : this.renderMarkdown(pages, domain, manifest);
+        await fs.writeFile(outputPath, content, 'utf8');
+        return outputPath;
+    }
+    renderJson(pages, domain, manifest) {
+        return JSON.stringify({
+            generatedAt: new Date().toISOString(),
+            contextGraphVersion: (0, version_1.getVersion)(),
+            domain,
+            pageCount: pages.length,
+            manifest: manifest?.statistics || null,
+            pages,
+        }, null, 2);
+    }
+    renderMarkdown(pages, domain, manifest) {
+        const stats = manifest?.statistics;
+        const lines = [];
+        // ── Header ──
+        lines.push(`# Application Context: ${domain}`);
+        lines.push('');
+        lines.push(`> **Generated by ContextGraph v${(0, version_1.getVersion)()}** — ${new Date().toLocaleString()}`);
+        lines.push(`> Pages captured: **${pages.length}** | Paste this file into your AI agent as context.`);
+        lines.push('');
+        if (stats) {
+            lines.push('## Session Summary');
+            lines.push('');
+            lines.push(`| Metric | Value |`);
+            lines.push(`|--------|-------|`);
+            lines.push(`| Total pages | ${stats.totalPages} |`);
+            lines.push(`| Network requests | ${stats.totalNetworkRequests ?? 'n/a'} |`);
+            lines.push(`| Screenshots | ${stats.totalScreenshots ?? 0} |`);
+            lines.push(`| Storage size | ${stats.storageSize} |`);
+            lines.push('');
+        }
+        // ── Per-page sections ──
+        for (let i = 0; i < pages.length; i++) {
+            const page = pages[i];
+            lines.push(`---`);
+            lines.push('');
+            lines.push(`## Page ${i + 1} of ${pages.length}: ${page.title || page.pageName}`);
+            lines.push('');
+            lines.push(`**URL:** \`${page.url}\``);
+            lines.push(`**Captured:** ${new Date(page.capturedAt).toLocaleString()}`);
+            lines.push('');
+            // Interactive elements
+            if (page.elements.length > 0) {
+                lines.push('### Interactive Elements');
+                lines.push('');
+                lines.push('| Element | Label/Text | Best Locator | State |');
+                lines.push('|---------|------------|-------------|-------|');
+                for (const el of page.elements) {
+                    const name = el.name ? el.name.replace(/\|/g, '\\|') : '—';
+                    const loc = el.bestLocator.replace(/\|/g, '\\|');
+                    lines.push(`| \`${el.role}\` | ${name} | \`${loc}\` | ${el.state} |`);
+                }
+                lines.push('');
+            }
+            // Form fields
+            if (page.formFields.length > 0) {
+                lines.push('### Form Fields');
+                lines.push('');
+                lines.push('| Label | Type | Required | Locator |');
+                lines.push('|-------|------|----------|---------|');
+                for (const field of page.formFields) {
+                    const label = (field.label || '—').replace(/\|/g, '\\|');
+                    lines.push(`| ${label} | \`${field.type}\` | ${field.required ? '✓' : '—'} | \`${field.locator.replace(/\|/g, '\\|')}\` |`);
+                }
+                lines.push('');
+            }
+            // Page structure (a11y)
+            lines.push('### Page Structure (Accessibility Tree)');
+            lines.push('');
+            lines.push('```');
+            lines.push(page.a11ySummary.trimEnd());
+            lines.push('```');
+            lines.push('');
+            // API calls
+            if (this.options.includeNetwork && page.apiCalls.length > 0) {
+                lines.push('### API Calls Observed on This Page');
+                lines.push('');
+                for (const call of page.apiCalls) {
+                    lines.push(`- \`${call.method}\` \`${call.path}\``);
+                }
+                lines.push('');
+            }
+            // Console errors
+            if (this.options.includeConsoleErrors && page.consoleErrors.length > 0) {
+                lines.push('### ⚠️ Console Errors');
+                lines.push('');
+                for (const err of page.consoleErrors) {
+                    lines.push(`- \`${err.message.substring(0, 150)}\``);
+                }
+                lines.push('');
+            }
+        }
+        // ── Prompt template ──
+        lines.push('---');
+        lines.push('');
+        lines.push('## Ready-to-Use AI Prompt');
+        lines.push('');
+        lines.push('> Copy everything above (from "Application Context") and paste into your AI agent, then append:');
+        lines.push('');
+        lines.push('```');
+        lines.push(`I am testing the ${domain} web application.`);
+        lines.push('');
+        lines.push('Using the page context above, generate Playwright TypeScript tests that:');
+        lines.push('1. Navigate to each captured page');
+        lines.push('2. Use ONLY the locators listed in the "Interactive Elements" tables');
+        lines.push('3. Assert that key elements are visible and enabled');
+        lines.push('4. Include a happy-path test for every form field listed');
+        lines.push('5. Group tests by page using test.describe()');
+        lines.push('```');
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+exports.AIContextBundler = AIContextBundler;
+//# sourceMappingURL=ai-context-bundler.js.map

package/dist/exporters/ai-context-bundler.js.map

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

package/dist/security/redactor.d.ts

@@ -16,11 +16,27 @@ export declare class SecurityRedactor {
     private sensitiveKeys;
     private auditLog;
     constructor(customRules?: RedactionRule[]);
+    /**
+     * Sanitize a URL by replacing the values of sensitive query parameters with
+     * [REDACTED].  Returns the original URL string unchanged if parsing fails.
+     *
+     * Examples:
+     *   https://api.example.com/users?api_key=sk_live_123  →  …?api_key=[REDACTED]
+     *   https://example.com/callback?code=abc&state=xyz    →  …?code=[REDACTED]&state=[REDACTED]
+     */
+    sanitizeUrl(url: string): string;
     redact(data: any, context: string, url?: string): Promise<RedactionResult>;
+    /**
+     * Redact a plain string in-place and return the sanitised version.
+     * Useful for response bodies before they are stored.
+     */
+    redactString(value: string, _context: string, _url?: string): Promise<string>;
     private redactSensitiveKeys;
     private redactHeaders;
     private applyRule;
     getAuditLog(): RedactionAuditEntry[];
     clearAuditLog(): void;
+    /** Returns the number of distinct redaction events across all contexts */
+    getTotalRedactionCount(): number;
 }
 //# sourceMappingURL=redactor.d.ts.map

package/dist/security/redactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redactor.d.ts","sourceRoot":"","sources":["../../src/security/redactor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,aAAa,CAA2G;IAChI,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,WAAW,GAAE,aAAa,EAAO;IAKvC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAiDhF,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,SAAS;IA2BjB,WAAW,IAAI,mBAAmB,EAAE;IAIpC,aAAa,IAAI,IAAI;CAGtB"}
+{"version":3,"file":"redactor.d.ts","sourceRoot":"","sources":["../../src/security/redactor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAqBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,aAAa,CAGnB;IACF,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,WAAW,GAAE,aAAa,EAAO;IAO7C;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAgC1B,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAsChF;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAanF,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,SAAS;IAiCjB,WAAW,IAAI,mBAAmB,EAAE;IAIpC,aAAa,IAAI,IAAI;IAIrB,0EAA0E;IAC1E,sBAAsB,IAAI,MAAM;CAKjC"}