@yasserkhanorg/impact-gate 2.0.0

package/dist/validation/output_schema.js

@@ -0,0 +1,84 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateFlowDecision = validateFlowDecision;
+exports.buildSummary = buildSummary;
+const VALID_ACTIONS = ['run_existing', 'add_scenarios', 'create_spec', 'cannot_determine'];
+const VALID_PRIORITIES = ['P0', 'P1', 'P2'];
+const VALID_SOURCES = ['ai', 'catalog', 'traceability', 'deterministic'];
+function validateFlowDecision(decision) {
+    const errors = [];
+    if (!decision || typeof decision !== 'object') {
+        return { valid: false, errors: ['Decision must be a non-null object'] };
+    }
+    const d = decision;
+    if (typeof d.flowId !== 'string' || !d.flowId) {
+        errors.push('flowId is required');
+    }
+    if (typeof d.flowName !== 'string' || !d.flowName) {
+        errors.push('flowName is required');
+    }
+    if (typeof d.routeFamily !== 'string' || !d.routeFamily) {
+        errors.push('routeFamily is required');
+    }
+    if (!Array.isArray(d.changedFiles)) {
+        errors.push('changedFiles must be an array');
+    }
+    if (typeof d.evidence !== 'string') {
+        errors.push('evidence is required');
+    }
+    if (!VALID_SOURCES.includes(d.evidenceSource)) {
+        errors.push(`evidenceSource must be one of: ${VALID_SOURCES.join(', ')}`);
+    }
+    if (typeof d.confidence !== 'number' || d.confidence < 0 || d.confidence > 100) {
+        errors.push('confidence must be a number between 0 and 100');
+    }
+    if (!VALID_ACTIONS.includes(d.action)) {
+        errors.push(`action must be one of: ${VALID_ACTIONS.join(', ')}`);
+    }
+    if (!VALID_PRIORITIES.includes(d.priority)) {
+        errors.push(`priority must be one of: ${VALID_PRIORITIES.join(', ')}`);
+    }
+    if (d.action === 'cannot_determine' && (typeof d.blockingReason !== 'string' || !d.blockingReason)) {
+        errors.push('blockingReason is required when action is cannot_determine');
+    }
+    if (d.action === 'add_scenarios' && (!Array.isArray(d.scenariosToAdd) || d.scenariosToAdd.length === 0)) {
+        errors.push('scenariosToAdd is required when action is add_scenarios');
+    }
+    return { valid: errors.length === 0, errors };
+}
+function buildSummary(decisions) {
+    const families = new Set();
+    const actions = { run_existing: 0, add_scenarios: 0, create_spec: 0, cannot_determine: 0 };
+    let covered = 0;
+    let partial = 0;
+    let uncovered = 0;
+    for (const d of decisions) {
+        families.add(d.routeFamily);
+        actions[d.action]++;
+        if (d.action === 'run_existing') {
+            covered++;
+        }
+        else if (d.action === 'add_scenarios') {
+            partial++;
+        }
+        else if (d.action === 'create_spec') {
+            uncovered++;
+        }
+    }
+    const actionable = decisions.filter((d) => d.action !== 'cannot_determine');
+    const avgConfidence = actionable.length > 0
+        ? actionable.reduce((sum, d) => sum + d.confidence, 0) / actionable.length
+        : 0;
+    return {
+        changedFiles: new Set(decisions.flatMap((d) => d.changedFiles)).size,
+        routeFamiliesImpacted: Array.from(families).sort(),
+        flowsIdentified: decisions.length,
+        flowsCovered: covered,
+        flowsPartial: partial,
+        flowsUncovered: uncovered,
+        actionsRequired: actions,
+        overallConfidence: avgConfidence >= 75 ? 'high' : avgConfidence >= 40 ? 'medium' : 'low',
+    };
+}

package/dist/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the package version by reading the nearest package.json.
+ * Cached after first call.
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAoBnC"}

package/dist/version.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+let _version;
+/**
+ * Returns the package version by reading the nearest package.json.
+ * Cached after first call.
+ */
+function getVersion() {
+    if (_version)
+        return _version;
+    try {
+        // Walk up from this file's compiled location to find package.json
+        for (let d = __dirname, prev = ''; d !== prev; prev = d, d = (0, path_1.dirname)(d)) {
+            try {
+                const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(d, 'package.json'), 'utf-8'));
+                if ((pkg.name === '@yasserkhanorg/impact-gate' || pkg.name === '@yasserkhanorg/e2e-agents') && pkg.version) {
+                    _version = pkg.version;
+                    return _version;
+                }
+            }
+            catch {
+                // keep walking up
+            }
+        }
+    }
+    catch {
+        // fallback
+    }
+    _version = 'unknown';
+    return _version;
+}

package/package.json

@@ -0,0 +1,126 @@
+{
+  "name": "@yasserkhanorg/impact-gate",
+  "version": "2.0.0",
+  "description": "Diff-aware E2E impact analysis and coverage gating for Playwright/Cypress teams. Optional AI features can suggest, generate, and heal tests once your project has a route-families.json manifest.",
+  "main": "dist/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/esm/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp-server.d.ts",
+      "require": "./dist/mcp-server.js",
+      "import": "./dist/esm/mcp-server.js"
+    },
+    "./schemas/impact": "./schemas/impact.schema.json",
+    "./schemas/gap": "./schemas/gap.schema.json",
+    "./schemas/plan": "./schemas/plan.schema.json",
+    "./schemas/traceability-input": "./schemas/traceability-input.schema.json",
+    "./schemas/subsystem-risk-map": "./schemas/subsystem-risk-map.schema.json",
+    "./schemas/route-families": "./schemas/route-families.schema.json",
+    "./schemas/flow-decision": "./schemas/flow-decision.schema.json",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "impact-gate": "./dist/cli.js",
+    "e2e-ai-agents": "./dist/cli.js",
+    "impact-gate-qa": "./dist/qa-agent/cli.js",
+    "e2e-qa-agent": "./dist/qa-agent/cli.js",
+    "impact-gate-mcp": "./dist/mcp-server.js",
+    "e2e-agents-mcp": "./dist/mcp-server.js"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:cjs && npm run build:esm",
+    "postbuild": "chmod +x dist/cli.js dist/qa-agent/cli.js dist/mcp-server.js",
+    "build:cjs": "tsc -p tsconfig.json",
+    "build:esm": "tsc -p tsconfig.esm.json && node scripts/write-esm-package.js",
+    "clean": "rm -rf dist",
+    "build:scripts": "tsc -p tsconfig.scripts.json",
+    "impact:checklist": "node scripts-dist/impact-checklist.js",
+    "impact:local": "node scripts-dist/local-impact-workflow.js",
+    "prebuild": "npm run clean",
+    "build:test": "tsc -p tsconfig.test.json --noCheck",
+    "pretest": "npm run build && npm run build:scripts && npm run build:test",
+    "test": "node --test test-dist/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "mcp:server": "node dist/mcp-server.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.73.0",
+    "glob": "^11.0.0",
+    "minimatch": "^10.0.0",
+    "marked": "^15.0.6",
+    "openai": "^4.73.0"
+  },
+  "peerDependencies": {
+    "agent-browser": ">=0.18.0"
+  },
+  "peerDependenciesMeta": {
+    "agent-browser": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yasserfaraazkhan/impact-gate.git"
+  },
+  "keywords": [
+    "impact-gate",
+    "impact-analysis",
+    "coverage-gating",
+    "ci-gating",
+    "llm",
+    "ai",
+    "testing",
+    "test-automation",
+    "e2e",
+    "playwright",
+    "cypress",
+    "pytest",
+    "supertest",
+    "anthropic",
+    "claude",
+    "ollama",
+    "openai",
+    "mcp",
+    "model-context-protocol",
+    "test-agents",
+    "ai-testing",
+    "autonomous-testing",
+    "test-generation",
+    "provider-abstraction",
+    "cost-tracking",
+    "hybrid-mode",
+    "test-discovery",
+    "test-healing",
+    "coverage",
+    "qa",
+    "ci-cd"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "author": "Yasser Khan",
+  "homepage": "https://github.com/yasserfaraazkhan/impact-gate",
+  "bugs": {
+    "url": "https://github.com/yasserfaraazkhan/impact-gate/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schemas/flow-decision.schema.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Flow Decision Report",
+  "description": "Output schema for the impact analysis pipeline. Each decision represents one impacted flow.",
+  "type": "object",
+  "required": ["runId", "timestamp", "gitRef", "summary", "decisions"],
+  "properties": {
+    "runId": { "type": "string" },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "gitRef": { "type": "string" },
+    "summary": {
+      "type": "object",
+      "required": ["changedFiles", "routeFamiliesImpacted", "flowsIdentified", "actionsRequired", "overallConfidence"],
+      "properties": {
+        "changedFiles": { "type": "integer", "minimum": 0 },
+        "routeFamiliesImpacted": { "type": "array", "items": { "type": "string" } },
+        "flowsIdentified": { "type": "integer", "minimum": 0 },
+        "flowsCovered": { "type": "integer", "minimum": 0 },
+        "flowsPartial": { "type": "integer", "minimum": 0 },
+        "flowsUncovered": { "type": "integer", "minimum": 0 },
+        "actionsRequired": {
+          "type": "object",
+          "properties": {
+            "run_existing": { "type": "integer", "minimum": 0 },
+            "add_scenarios": { "type": "integer", "minimum": 0 },
+            "create_spec": { "type": "integer", "minimum": 0 },
+            "cannot_determine": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "overallConfidence": { "enum": ["high", "medium", "low"] }
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/FlowDecision" }
+    },
+    "warnings": { "type": "array", "items": { "type": "string" } },
+    "model": {
+      "type": "object",
+      "properties": {
+        "impactAgent": { "type": "string" },
+        "coverageAgent": { "type": "string" }
+      }
+    }
+  },
+  "$defs": {
+    "FlowDecision": {
+      "type": "object",
+      "required": ["flowId", "flowName", "routeFamily", "changedFiles", "evidence", "evidenceSource", "confidence", "action", "priority"],
+      "properties": {
+        "flowId": { "type": "string" },
+        "flowName": { "type": "string" },
+        "routeFamily": { "type": "string" },
+        "featureId": { "type": "string" },
+        "specificRoute": { "type": "string" },
+        "changedFiles": { "type": "array", "items": { "type": "string" } },
+        "evidence": { "type": "string" },
+        "evidenceSource": { "enum": ["ai", "catalog", "traceability", "deterministic"] },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 100 },
+        "existingSpecs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["path", "coverageLevel"],
+            "properties": {
+              "path": { "type": "string" },
+              "testTitles": { "type": "array", "items": { "type": "string" } },
+              "coverageLevel": { "enum": ["full", "partial", "none"] },
+              "missingScenarios": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "action": { "enum": ["run_existing", "add_scenarios", "create_spec", "cannot_determine"] },
+        "targetSpec": { "type": "string" },
+        "newSpecPath": { "type": "string" },
+        "scenariosToAdd": { "type": "array", "items": { "type": "string" } },
+        "blockingReason": { "type": "string" },
+        "priority": { "enum": ["P0", "P1", "P2"] },
+        "userActions": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/schemas/gap.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mattermost.com/schemas/e2e-agents/gap.schema.json",
+  "title": "GapReport",
+  "allOf": [
+    {
+      "$ref": "./impact.schema.json"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "mode": {
+          "const": "gap"
+        }
+      }
+    }
+  ]
+}