ghost-qa 1.3.1 → 2.0.0

package/dist/src/types.d.ts

@@ -5,10 +5,22 @@
  * rendered for a human (terminal), serialised for CI (JSON), or fed back to a
  * coding agent (Markdown diagnostic) without any translation layer.
  */
-export type ViewportName = 'desktop' | 'mobile';
-export type IssueCategory = 'console' | 'network' | 'layout' | 'accessibility' | 'performance' | 'interaction' | 'navigation';
+export type ViewportName = 'desktop' | 'tablet' | 'mobile';
+export type ColorScheme = 'light' | 'dark';
+export type IssueCategory = 'console' | 'network' | 'layout' | 'accessibility' | 'performance' | 'interaction' | 'navigation' | 'links' | 'seo' | 'theme';
+/** The eight specialised traps of the v2 Deep Browser Inspection Engine. */
+export type TrapName = 'console' | 'network' | 'layout' | 'accessibility' | 'performance' | 'links' | 'seo' | 'theme';
+export declare const TRAP_LABELS: Record<TrapName, string>;
+/** Which trap owns a category (interaction/navigation fold into Links/UX). */
+export declare const CATEGORY_TO_TRAP: Record<IssueCategory, TrapName>;
 export type IssueSeverity = 'critical' | 'major' | 'minor';
-export type IssueType = 'page-error' | 'unhandled-rejection' | 'hydration-mismatch' | 'console-error' | 'console-warning' | 'http-error' | 'request-failed' | 'cors-error' | 'broken-asset' | 'horizontal-overflow' | 'zero-size-interactive' | 'broken-image' | 'missing-viewport-meta' | 'interaction-failed' | 'navigation-failed' | 'missing-accessible-name' | 'img-missing-alt' | 'input-missing-label' | 'missing-document-title' | 'missing-html-lang' | 'slow-page-load' | 'oversized-resource' | 'excessive-payload' | 'render-blocking-resources' | 'layout-thrashing' | 'excessive-dom-size';
+export type IssueType = 'page-error' | 'unhandled-rejection' | 'hydration-mismatch' | 'console-error' | 'console-warning' | 'duplicate-key-warning' | 'csp-violation' | 'http-error' | 'request-failed' | 'request-timeout' | 'cors-error' | 'cors-preflight-failed' | 'broken-asset' | 'broken-image' | 'broken-svg' | 'horizontal-overflow' | 'zero-size-interactive' | 'element-collision' | 'small-touch-target' | 'clipped-text' | 'offscreen-interactive' | 'interaction-failed' | 'navigation-failed' | 'missing-accessible-name' | 'img-missing-alt' | 'input-missing-label' | 'missing-document-title' | 'missing-html-lang' | 'contrast-insufficient' | 'heading-hierarchy' | 'focus-not-visible' | 'slow-page-load' | 'slow-ttfb' | 'slow-fcp' | 'slow-lcp' | 'high-cls' | 'oversized-resource' | 'unoptimized-resource' | 'excessive-payload' | 'render-blocking-resources' | 'layout-thrashing' | 'excessive-dom-size' | 'deep-dom' | 'missing-viewport-meta' | 'dead-link' | 'placeholder-link' | 'form-button-missing-type' | 'stuck-disabled' | 'title-too-short' | 'title-too-long' | 'missing-meta-description' | 'missing-canonical' | 'missing-opengraph' | 'duplicate-id' | 'theme-contrast';
+export interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 export interface QAIssue {
     /** Stable, de-duplication-friendly identifier (hash of the fingerprint). */
     id: string;
@@ -20,6 +32,12 @@ export interface QAIssue {
     /** Path of the route the issue was observed on, e.g. `/pricing`. */
     route: string;
     viewport: ViewportName;
+    /** Exact DOM selector (`#id`, `[data-testid=…]`, or CSS path) when known. */
+    selector?: string;
+    /** Live bounding box of the offending element, when geometry is relevant. */
+    boundingBox?: BoundingBox;
+    /** Which emulated colour scheme the finding belongs to, when relevant. */
+    colorScheme?: ColorScheme;
     /** Optional machine-readable context (status code, selector, geometry…). */
     details?: Record<string, string | number | boolean>;
     stack?: string;
@@ -45,6 +63,13 @@ export interface RouteRecord {
     viewports: ViewportName[];
     issueCount: number;
 }
+export interface ScreenshotRecord {
+    route: string;
+    viewport: ViewportName;
+    colorScheme: ColorScheme;
+    /** Data URI (`data:image/jpeg;base64,…`) so reports stay self-contained. */
+    dataUri: string;
+}
 export interface GhostQAOptions {
     maxDepth: number;
     maxRoutes: number;
@@ -56,8 +81,28 @@ export interface GhostQAOptions {
     interactions: boolean;
     /** Fail (exit 1) when an issue at or above this severity is found. */
     failOn: IssueSeverity;
+    /** Colour schemes to emulate (Theme Trap runs under each). */
+    colorSchemes?: ColorScheme[];
+    /** Capture a JPEG screenshot per route/viewport for the HTML dashboard. */
+    screenshots?: boolean;
 }
 export declare const DEFAULT_OPTIONS: GhostQAOptions;
+export interface TrapScore {
+    trap: TrapName;
+    label: string;
+    /** 0–100, deterministic from that trap's findings. */
+    score: number;
+    grade: string;
+    issues: number;
+    bySeverity: Record<IssueSeverity, number>;
+}
+export interface HealthScore {
+    /** Overall QA Health Score, 0–100 (mean of the eight trap scores). */
+    score: number;
+    /** Letter grade A+ … F. */
+    grade: string;
+    byTrap: TrapScore[];
+}
 export interface GhostQAReport {
     tool: 'ghost-qa';
     version: string;
@@ -70,6 +115,10 @@ export interface GhostQAReport {
     routes: RouteRecord[];
     interactions: InteractionAction[];
     issues: QAIssue[];
+    /** QA Health Score (0–100, grade A+…F) with per-trap sub-scores. */
+    health?: HealthScore;
+    /** Screenshots captured when `options.screenshots` was enabled. */
+    screenshots?: ScreenshotRecord[];
     summary: {
         routesCrawled: number;
         interactionsTested: number;
@@ -78,6 +127,9 @@ export interface GhostQAReport {
         totalIssues: number;
         bySeverity: Record<IssueSeverity, number>;
         byCategory: Record<IssueCategory, number>;
+        /** Present on v2 reports: mirrors `health.score` / `health.grade`. */
+        healthScore?: number;
+        grade?: string;
     };
 }
 export declare const SEVERITY_ORDER: Record<IssueSeverity, number>;

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3C,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,eAAe,GACf,aAAa,GACb,aAAa,GACb,YAAY,GACZ,OAAO,GACP,KAAK,GACL,OAAO,CAAC;AAEZ,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,SAAS,GACT,QAAQ,GACR,eAAe,GACf,aAAa,GACb,OAAO,GACP,KAAK,GACL,OAAO,CAAC;AAEZ,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAShD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,aAAa,EAAE,QAAQ,CAW5D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,uBAAuB,GACvB,cAAc,GACd,cAAc,GACd,YAAY,GACZ,qBAAqB,GACrB,uBAAuB,GACvB,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,GACd,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,iBAAiB,GACjB,qBAAqB,GACrB,wBAAwB,GACxB,mBAAmB,GACnB,uBAAuB,GACvB,mBAAmB,GACnB,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,UAAU,GACV,UAAU,GACV,UAAU,GACV,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,GACnB,2BAA2B,GAC3B,kBAAkB,GAClB,oBAAoB,GACpB,UAAU,GACV,uBAAuB,GACvB,WAAW,GACX,kBAAkB,GAClB,0BAA0B,GAC1B,gBAAgB,GAChB,iBAAiB,GACjB,gBAAgB,GAChB,0BAA0B,GAC1B,mBAAmB,GACnB,mBAAmB,GACnB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,aAAa,GAAG,QAAQ,CAAC;IACzE,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,WAAW,CAAC;IACzB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,sEAAsE;IACtE,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,eAAe,EAAE,cAY7B,CAAC;AAEF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mEAAmE;IACnE,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,OAAO,EAAE;QACP,aAAa,EAAE,MAAM,CAAC;QACtB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1C,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1C,sEAAsE;QACtE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAIxD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAE5F;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAUT;AAED,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAMzD;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,WAAW,EAAE,EACrB,YAAY,EAAE,iBAAiB,EAAE,EACjC,MAAM,EAAE,OAAO,EAAE,EACjB,MAAM,EAAE,aAAa,GACpB,aAAa,CAAC,SAAS,CAAC,GAAG;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CA4BhD"}

package/dist/src/types.js

@@ -5,6 +5,29 @@
  * rendered for a human (terminal), serialised for CI (JSON), or fed back to a
  * coding agent (Markdown diagnostic) without any translation layer.
  */
+export const TRAP_LABELS = {
+    console: 'Console & Framework Runtime',
+    network: 'Network & Asset Integrity',
+    layout: 'Layout, Responsive Geometry & Collision',
+    accessibility: 'Accessibility (WCAG 2.1 AA) & Keyboard Focus',
+    performance: 'Performance & Core Web Vitals',
+    links: 'Safe Interactive & Link Integrity',
+    seo: 'SEO, Metadata & Social Graph',
+    theme: 'Dark / Light Theme Emulation',
+};
+/** Which trap owns a category (interaction/navigation fold into Links/UX). */
+export const CATEGORY_TO_TRAP = {
+    console: 'console',
+    network: 'network',
+    layout: 'layout',
+    accessibility: 'accessibility',
+    performance: 'performance',
+    interaction: 'links',
+    navigation: 'links',
+    links: 'links',
+    seo: 'seo',
+    theme: 'theme',
+};
 export const DEFAULT_OPTIONS = {
     maxDepth: 2,
     maxRoutes: 25,
@@ -12,9 +35,11 @@ export const DEFAULT_OPTIONS = {
     timeoutMs: 15_000,
     settleMs: 600,
     headless: true,
-    viewports: ['desktop', 'mobile'],
+    viewports: ['desktop', 'tablet', 'mobile'],
     interactions: true,
     failOn: 'major',
+    colorSchemes: ['light', 'dark'],
+    screenshots: false,
 };
 export const SEVERITY_ORDER = {
     critical: 3,
@@ -35,7 +60,7 @@ export function fingerprint(input) {
 }
 export function makeIssue(input) {
     const detailString = input.details ? JSON.stringify(input.details) : '';
-    const id = fingerprint([input.category, input.type, input.route, input.viewport, input.message, detailString].join('|'));
+    const id = fingerprint([input.category, input.type, input.route, input.viewport, input.colorScheme ?? '', input.message, detailString].join('|'));
     return {
         ...input,
         id,
@@ -61,6 +86,9 @@ export function summarise(routes, interactions, issues, failOn) {
         performance: 0,
         interaction: 0,
         navigation: 0,
+        links: 0,
+        seo: 0,
+        theme: 0,
     };
     for (const issue of issues) {
         bySeverity[issue.severity] += 1;

package/dist/src/types.js.map

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

package/package.json

@@ -1,91 +1,99 @@
-{
-  "name": "ghost-qa",
-  "version": "1.3.1",
-  "description": "Autonomous headless browser QA & self-healing verification loop for coding agents. Crawls localhost, traps console/network/layout failures, and feeds structured diagnostics back to the agent.",
-  "type": "module",
-  "bin": {
-    "ghost-qa": "dist/bin/ghost-qa.js"
-  },
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "scripts/prepare-build.mjs",
-    "SKILL.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "prepare": "node scripts/prepare-build.mjs",
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -p tsconfig.json --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "qa": "npm run build && npm test",
-    "prepublishOnly": "npm run qa"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "claude-code",
-    "claude-skills",
-    "agent-skills",
-    "ai-agents",
-    "coding-agents",
-    "playwright",
-    "headless-browser",
-    "qa-automation",
-    "e2e-testing",
-    "self-healing",
-    "codex",
-    "cursor",
-    "cursorrules",
-    "windsurf",
-    "accessibility-testing",
-    "a11y",
-    "web-vitals",
-    "performance-testing",
-    "browser-testing",
-    "test-automation",
-    "automated-testing",
-    "typescript",
-    "cli",
-    "devtools",
-    "hydration",
-    "ci-cd",
-    "browser-verification",
-    "agent-tools",
-    "llm-agents",
-    "frontend-qa",
-    "mobile-testing"
-  ],
-  "author": "VibeFoundry",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/avivgerz-hue/ghost-qa.git"
-  },
-  "homepage": "https://github.com/avivgerz-hue/ghost-qa#readme",
-  "bugs": {
-    "url": "https://github.com/avivgerz-hue/ghost-qa/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "dependencies": {
-    "playwright": "^1.49.1"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.2",
-    "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
-  }
-}
+{
+  "name": "ghost-qa",
+  "version": "2.0.0",
+  "description": "Autonomous headless browser QA & self-healing verification loop for coding agents. 8-trap deep inspection (console, network, layout, WCAG a11y + keyboard focus, Core Web Vitals, links, SEO, theme parity) across desktop/tablet/mobile in light + dark, QA Health Score (A+ to F), interactive HTML dashboard, and regression diffing (ghost_qa_compare).",
+  "type": "module",
+  "bin": {
+    "ghost-qa": "dist/bin/ghost-qa.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts/prepare-build.mjs",
+    "SKILL.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepare": "node scripts/prepare-build.mjs",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "qa": "npm run build && npm test",
+    "prepublishOnly": "npm run qa"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude-code",
+    "claude-skills",
+    "agent-skills",
+    "ai-agents",
+    "coding-agents",
+    "playwright",
+    "headless-browser",
+    "qa-automation",
+    "e2e-testing",
+    "self-healing",
+    "codex",
+    "cursor",
+    "cursorrules",
+    "windsurf",
+    "accessibility-testing",
+    "a11y",
+    "web-vitals",
+    "performance-testing",
+    "browser-testing",
+    "test-automation",
+    "automated-testing",
+    "typescript",
+    "cli",
+    "devtools",
+    "hydration",
+    "ci-cd",
+    "browser-verification",
+    "agent-tools",
+    "llm-agents",
+    "frontend-qa",
+    "mobile-testing",
+    "tablet-testing",
+    "dark-mode-testing",
+    "core-web-vitals",
+    "regression-testing",
+    "lighthouse-alternative",
+    "seo-audit",
+    "link-checker",
+    "health-score"
+  ],
+  "author": "VibeFoundry",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avivgerz-hue/ghost-qa.git"
+  },
+  "homepage": "https://github.com/avivgerz-hue/ghost-qa#readme",
+  "bugs": {
+    "url": "https://github.com/avivgerz-hue/ghost-qa/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "playwright": "^1.49.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}