@democratize-quality/qualitylens-core 0.1.0

package/dist/core/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/engine.ts"],"sourcesContent":["/**\n * src/core/engine.ts\n * \n * The main orchestrator. Zero I/O — all dependencies injected.\n * This design makes the engine fully unit-testable with mock sources.\n * \n * AI INSTRUCTIONS: implement run() using the step-by-step comments.\n */\n\nimport {\n  CoverageReport,\n  CoverageStatus,\n  RouteGap,\n  RouteCoverage,\n  Staleness,\n  TestEntry,\n  TestGapConfig,\n  TestHint,\n} from './types'\nimport { BaseSource } from '../sources/base.source'\nimport { RoutesSource } from '../sources/routes.source'\nimport { FuzzyMatcher } from '../matchers/fuzzy.matcher'\nimport { AreaMatcher } from '../matchers/area.matcher'\n\nexport class CoverageEngine {\n  constructor(\n    private sources: BaseSource[],\n    private routesSource: RoutesSource,\n    private matcher: FuzzyMatcher,\n    private areaMatcher: AreaMatcher,\n    private config: TestGapConfig\n  ) {}\n\n  async run(): Promise<CoverageReport> {\n    // Step 1: Collect from all sources in parallel\n    const sourceResults = await Promise.all(this.sources.map(s => s.collect()))\n    const allTests: TestEntry[] = sourceResults.flat()\n\n    // Step 2: Discover routes\n    const routes = await this.routesSource.collect()\n\n    // Step 3: Match tests to routes\n    const matchMap = this.matcher.match(routes, allTests)\n\n    // Collect all matched tests so we can find orphans after\n    const matchedTests = new Set<TestEntry>()\n    for (const tests of matchMap.values()) {\n      for (const t of tests) matchedTests.add(t)\n    }\n\n    // Step 3b: Apply testHints to fuzzy-unmatched tests\n    const hints = this.config.testHints ?? []\n    const hintMap = new Map<string, TestHint>()\n    for (const hint of hints) hintMap.set(hint.test, hint)\n\n    const routeGaps: RouteGap[] = []\n    const acknowledgedTests: TestHint[] = []\n    const hintResolved = new Set<TestEntry>()\n\n    for (const test of allTests) {\n      if (matchedTests.has(test)) continue  // already matched by fuzzy\n      const hint = hintMap.get(test.title)\n      if (!hint) continue\n\n      if (hint.status === 'resolved' && hint.route) {\n        // Inject into matchMap so RouteCoverage picks it up\n        const key = hint.method ? `${hint.method} ${hint.route}` : hint.route\n        const existing = matchMap.get(key) ?? []\n        matchMap.set(key, [...existing, test])\n        matchedTests.add(test)\n        hintResolved.add(test)\n      } else if (hint.status === 'gap') {\n        const existing = routeGaps.find(g =>\n          g.route === hint.route && g.method === hint.method\n        )\n        if (existing) {\n          existing.coveredByTests.push(test)\n        } else {\n          routeGaps.push({\n            route: hint.route ?? test.title,\n            method: hint.method,\n            reason: hint.reason,\n            coveredByTests: [test],\n          })\n        }\n        matchedTests.add(test)\n      } else if (hint.status === 'acknowledged' || hint.status === 'ignore') {\n        acknowledgedTests.push(hint)\n        matchedTests.add(test)\n      }\n    }\n\n    // Step 4: Build RouteCoverage for each route\n    const routeCoverages: RouteCoverage[] = routes.map(route => {\n      const key = route.method ? `${route.method} ${route.path}` : route.path\n      const matched = matchMap.get(key) ?? []\n      const automatedTests = matched.filter(t => t.source === 'playwright')\n      const manualTests = matched.filter(t => t.source === 'ado' || t.source === 'yaml')\n\n      const status = this.deriveStatus(automatedTests.length, manualTests.length)\n      const lastTestedAt = this.latestDate([...automatedTests, ...manualTests])\n      const staleness = this.deriveStaleness(lastTestedAt, manualTests.length)\n\n      return {\n        route,\n        status,\n        automatedTests,\n        manualTests,\n        staleness,\n        lastTestedAt,\n      }\n    })\n\n    // Step 5: Assign to functional areas\n    const { areas, uncategorised } = this.areaMatcher.assign(routeCoverages)\n\n    // Step 6: Build summary\n    const total = routeCoverages.length\n    const automated = routeCoverages.filter(r => r.status === 'automated' || r.status === 'both').length\n    const manualOnly = routeCoverages.filter(r => r.status === 'manual').length\n    const none = routeCoverages.filter(r => r.status === 'none').length\n\n    // LRM: apply rounding only to the three mutually exclusive groups so they\n    // always sum to 100. totalCoverage is derived, never independently rounded.\n    const toLRM = (counts: number[]): number[] => {\n      if (total === 0) return counts.map(() => 0)\n      const exact = counts.map(n => (n / total) * 100)\n      const floored = exact.map(n => Math.floor(n))\n      const remainder = 100 - floored.reduce((a, b) => a + b, 0)\n      const order = exact.map((n, i) => ({ i, frac: n - Math.floor(n) })).sort((a, b) => b.frac - a.frac)\n      for (let k = 0; k < remainder; k++) floored[order[k].i]++\n      return floored\n    }\n    const [automatedCoverage, manualOnlyCoverage, noCoverage] = toLRM([automated, manualOnly, none])\n    const totalCoverage = automatedCoverage + manualOnlyCoverage\n\n    return {\n      generatedAt: new Date(),\n      projectName: this.config.projectName,\n      summary: {\n        totalRoutes: total,\n        totalCoverage,\n        automatedCoverage,\n        manualOnlyCoverage,\n        noCoverage,\n      },\n      areas,\n      uncategorised,\n      unmatchedTests: allTests.filter(t => !matchedTests.has(t)),\n      routeGaps,\n      acknowledgedTests,\n    }\n  }\n\n  private deriveStatus(autoCount: number, manualCount: number): CoverageStatus {\n    if (autoCount > 0 && manualCount > 0) return 'both'\n    if (autoCount > 0) return 'automated'\n    if (manualCount > 0) return 'manual'\n    return 'none'\n  }\n\n  private deriveStaleness(lastTestedAt: Date | undefined, manualCount: number): Staleness {\n    // Only flag staleness for manual tests — automated tests run on every push\n    if (manualCount === 0) return 'unknown'\n    if (!lastTestedAt) return 'unknown'\n\n    const daysSince = (Date.now() - lastTestedAt.getTime()) / (1000 * 60 * 60 * 24)\n    return daysSince > this.config.staleThresholdDays ? 'stale' : 'fresh'\n  }\n\n  private latestDate(tests: TestEntry[]): Date | undefined {\n    const dates = tests.map(t => t.lastRun).filter((d): d is Date => d instanceof Date)\n    if (dates.length === 0) return undefined\n    return new Date(Math.max(...dates.map(d => d.getTime())))\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/engine.mjs

@@ -0,0 +1,126 @@
+// src/core/engine.ts
+var CoverageEngine = class {
+  constructor(sources, routesSource, matcher, areaMatcher, config) {
+    this.sources = sources;
+    this.routesSource = routesSource;
+    this.matcher = matcher;
+    this.areaMatcher = areaMatcher;
+    this.config = config;
+  }
+  async run() {
+    const sourceResults = await Promise.all(this.sources.map((s) => s.collect()));
+    const allTests = sourceResults.flat();
+    const routes = await this.routesSource.collect();
+    const matchMap = this.matcher.match(routes, allTests);
+    const matchedTests = /* @__PURE__ */ new Set();
+    for (const tests of matchMap.values()) {
+      for (const t of tests) matchedTests.add(t);
+    }
+    const hints = this.config.testHints ?? [];
+    const hintMap = /* @__PURE__ */ new Map();
+    for (const hint of hints) hintMap.set(hint.test, hint);
+    const routeGaps = [];
+    const acknowledgedTests = [];
+    const hintResolved = /* @__PURE__ */ new Set();
+    for (const test of allTests) {
+      if (matchedTests.has(test)) continue;
+      const hint = hintMap.get(test.title);
+      if (!hint) continue;
+      if (hint.status === "resolved" && hint.route) {
+        const key = hint.method ? `${hint.method} ${hint.route}` : hint.route;
+        const existing = matchMap.get(key) ?? [];
+        matchMap.set(key, [...existing, test]);
+        matchedTests.add(test);
+        hintResolved.add(test);
+      } else if (hint.status === "gap") {
+        const existing = routeGaps.find(
+          (g) => g.route === hint.route && g.method === hint.method
+        );
+        if (existing) {
+          existing.coveredByTests.push(test);
+        } else {
+          routeGaps.push({
+            route: hint.route ?? test.title,
+            method: hint.method,
+            reason: hint.reason,
+            coveredByTests: [test]
+          });
+        }
+        matchedTests.add(test);
+      } else if (hint.status === "acknowledged" || hint.status === "ignore") {
+        acknowledgedTests.push(hint);
+        matchedTests.add(test);
+      }
+    }
+    const routeCoverages = routes.map((route) => {
+      const key = route.method ? `${route.method} ${route.path}` : route.path;
+      const matched = matchMap.get(key) ?? [];
+      const automatedTests = matched.filter((t) => t.source === "playwright");
+      const manualTests = matched.filter((t) => t.source === "ado" || t.source === "yaml");
+      const status = this.deriveStatus(automatedTests.length, manualTests.length);
+      const lastTestedAt = this.latestDate([...automatedTests, ...manualTests]);
+      const staleness = this.deriveStaleness(lastTestedAt, manualTests.length);
+      return {
+        route,
+        status,
+        automatedTests,
+        manualTests,
+        staleness,
+        lastTestedAt
+      };
+    });
+    const { areas, uncategorised } = this.areaMatcher.assign(routeCoverages);
+    const total = routeCoverages.length;
+    const automated = routeCoverages.filter((r) => r.status === "automated" || r.status === "both").length;
+    const manualOnly = routeCoverages.filter((r) => r.status === "manual").length;
+    const none = routeCoverages.filter((r) => r.status === "none").length;
+    const toLRM = (counts) => {
+      if (total === 0) return counts.map(() => 0);
+      const exact = counts.map((n) => n / total * 100);
+      const floored = exact.map((n) => Math.floor(n));
+      const remainder = 100 - floored.reduce((a, b) => a + b, 0);
+      const order = exact.map((n, i) => ({ i, frac: n - Math.floor(n) })).sort((a, b) => b.frac - a.frac);
+      for (let k = 0; k < remainder; k++) floored[order[k].i]++;
+      return floored;
+    };
+    const [automatedCoverage, manualOnlyCoverage, noCoverage] = toLRM([automated, manualOnly, none]);
+    const totalCoverage = automatedCoverage + manualOnlyCoverage;
+    return {
+      generatedAt: /* @__PURE__ */ new Date(),
+      projectName: this.config.projectName,
+      summary: {
+        totalRoutes: total,
+        totalCoverage,
+        automatedCoverage,
+        manualOnlyCoverage,
+        noCoverage
+      },
+      areas,
+      uncategorised,
+      unmatchedTests: allTests.filter((t) => !matchedTests.has(t)),
+      routeGaps,
+      acknowledgedTests
+    };
+  }
+  deriveStatus(autoCount, manualCount) {
+    if (autoCount > 0 && manualCount > 0) return "both";
+    if (autoCount > 0) return "automated";
+    if (manualCount > 0) return "manual";
+    return "none";
+  }
+  deriveStaleness(lastTestedAt, manualCount) {
+    if (manualCount === 0) return "unknown";
+    if (!lastTestedAt) return "unknown";
+    const daysSince = (Date.now() - lastTestedAt.getTime()) / (1e3 * 60 * 60 * 24);
+    return daysSince > this.config.staleThresholdDays ? "stale" : "fresh";
+  }
+  latestDate(tests) {
+    const dates = tests.map((t) => t.lastRun).filter((d) => d instanceof Date);
+    if (dates.length === 0) return void 0;
+    return new Date(Math.max(...dates.map((d) => d.getTime())));
+  }
+};
+export {
+  CoverageEngine
+};
+//# sourceMappingURL=engine.mjs.map

package/dist/core/engine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/engine.ts"],"sourcesContent":["/**\n * src/core/engine.ts\n * \n * The main orchestrator. Zero I/O — all dependencies injected.\n * This design makes the engine fully unit-testable with mock sources.\n * \n * AI INSTRUCTIONS: implement run() using the step-by-step comments.\n */\n\nimport {\n  CoverageReport,\n  CoverageStatus,\n  RouteGap,\n  RouteCoverage,\n  Staleness,\n  TestEntry,\n  TestGapConfig,\n  TestHint,\n} from './types'\nimport { BaseSource } from '../sources/base.source'\nimport { RoutesSource } from '../sources/routes.source'\nimport { FuzzyMatcher } from '../matchers/fuzzy.matcher'\nimport { AreaMatcher } from '../matchers/area.matcher'\n\nexport class CoverageEngine {\n  constructor(\n    private sources: BaseSource[],\n    private routesSource: RoutesSource,\n    private matcher: FuzzyMatcher,\n    private areaMatcher: AreaMatcher,\n    private config: TestGapConfig\n  ) {}\n\n  async run(): Promise<CoverageReport> {\n    // Step 1: Collect from all sources in parallel\n    const sourceResults = await Promise.all(this.sources.map(s => s.collect()))\n    const allTests: TestEntry[] = sourceResults.flat()\n\n    // Step 2: Discover routes\n    const routes = await this.routesSource.collect()\n\n    // Step 3: Match tests to routes\n    const matchMap = this.matcher.match(routes, allTests)\n\n    // Collect all matched tests so we can find orphans after\n    const matchedTests = new Set<TestEntry>()\n    for (const tests of matchMap.values()) {\n      for (const t of tests) matchedTests.add(t)\n    }\n\n    // Step 3b: Apply testHints to fuzzy-unmatched tests\n    const hints = this.config.testHints ?? []\n    const hintMap = new Map<string, TestHint>()\n    for (const hint of hints) hintMap.set(hint.test, hint)\n\n    const routeGaps: RouteGap[] = []\n    const acknowledgedTests: TestHint[] = []\n    const hintResolved = new Set<TestEntry>()\n\n    for (const test of allTests) {\n      if (matchedTests.has(test)) continue  // already matched by fuzzy\n      const hint = hintMap.get(test.title)\n      if (!hint) continue\n\n      if (hint.status === 'resolved' && hint.route) {\n        // Inject into matchMap so RouteCoverage picks it up\n        const key = hint.method ? `${hint.method} ${hint.route}` : hint.route\n        const existing = matchMap.get(key) ?? []\n        matchMap.set(key, [...existing, test])\n        matchedTests.add(test)\n        hintResolved.add(test)\n      } else if (hint.status === 'gap') {\n        const existing = routeGaps.find(g =>\n          g.route === hint.route && g.method === hint.method\n        )\n        if (existing) {\n          existing.coveredByTests.push(test)\n        } else {\n          routeGaps.push({\n            route: hint.route ?? test.title,\n            method: hint.method,\n            reason: hint.reason,\n            coveredByTests: [test],\n          })\n        }\n        matchedTests.add(test)\n      } else if (hint.status === 'acknowledged' || hint.status === 'ignore') {\n        acknowledgedTests.push(hint)\n        matchedTests.add(test)\n      }\n    }\n\n    // Step 4: Build RouteCoverage for each route\n    const routeCoverages: RouteCoverage[] = routes.map(route => {\n      const key = route.method ? `${route.method} ${route.path}` : route.path\n      const matched = matchMap.get(key) ?? []\n      const automatedTests = matched.filter(t => t.source === 'playwright')\n      const manualTests = matched.filter(t => t.source === 'ado' || t.source === 'yaml')\n\n      const status = this.deriveStatus(automatedTests.length, manualTests.length)\n      const lastTestedAt = this.latestDate([...automatedTests, ...manualTests])\n      const staleness = this.deriveStaleness(lastTestedAt, manualTests.length)\n\n      return {\n        route,\n        status,\n        automatedTests,\n        manualTests,\n        staleness,\n        lastTestedAt,\n      }\n    })\n\n    // Step 5: Assign to functional areas\n    const { areas, uncategorised } = this.areaMatcher.assign(routeCoverages)\n\n    // Step 6: Build summary\n    const total = routeCoverages.length\n    const automated = routeCoverages.filter(r => r.status === 'automated' || r.status === 'both').length\n    const manualOnly = routeCoverages.filter(r => r.status === 'manual').length\n    const none = routeCoverages.filter(r => r.status === 'none').length\n\n    // LRM: apply rounding only to the three mutually exclusive groups so they\n    // always sum to 100. totalCoverage is derived, never independently rounded.\n    const toLRM = (counts: number[]): number[] => {\n      if (total === 0) return counts.map(() => 0)\n      const exact = counts.map(n => (n / total) * 100)\n      const floored = exact.map(n => Math.floor(n))\n      const remainder = 100 - floored.reduce((a, b) => a + b, 0)\n      const order = exact.map((n, i) => ({ i, frac: n - Math.floor(n) })).sort((a, b) => b.frac - a.frac)\n      for (let k = 0; k < remainder; k++) floored[order[k].i]++\n      return floored\n    }\n    const [automatedCoverage, manualOnlyCoverage, noCoverage] = toLRM([automated, manualOnly, none])\n    const totalCoverage = automatedCoverage + manualOnlyCoverage\n\n    return {\n      generatedAt: new Date(),\n      projectName: this.config.projectName,\n      summary: {\n        totalRoutes: total,\n        totalCoverage,\n        automatedCoverage,\n        manualOnlyCoverage,\n        noCoverage,\n      },\n      areas,\n      uncategorised,\n      unmatchedTests: allTests.filter(t => !matchedTests.has(t)),\n      routeGaps,\n      acknowledgedTests,\n    }\n  }\n\n  private deriveStatus(autoCount: number, manualCount: number): CoverageStatus {\n    if (autoCount > 0 && manualCount > 0) return 'both'\n    if (autoCount > 0) return 'automated'\n    if (manualCount > 0) return 'manual'\n    return 'none'\n  }\n\n  private deriveStaleness(lastTestedAt: Date | undefined, manualCount: number): Staleness {\n    // Only flag staleness for manual tests — automated tests run on every push\n    if (manualCount === 0) return 'unknown'\n    if (!lastTestedAt) return 'unknown'\n\n    const daysSince = (Date.now() - lastTestedAt.getTime()) / (1000 * 60 * 60 * 24)\n    return daysSince > this.config.staleThresholdDays ? 'stale' : 'fresh'\n  }\n\n  private latestDate(tests: TestEntry[]): Date | undefined {\n    const dates = tests.map(t => t.lastRun).filter((d): d is Date => d instanceof Date)\n    if (dates.length === 0) return undefined\n    return new Date(Math.max(...dates.map(d => d.getTime())))\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/core/types.d.mts

@@ -0,0 +1,109 @@
+/**
+ * src/core/types.ts
+ *
+ * ALL shared interfaces live here.
+ * Every other file in this project imports types from this file.
+ * Do not scatter interface definitions — keep this as the single source of truth.
+ */
+type CoverageStatus = 'automated' | 'manual' | 'both' | 'none';
+type TestSource = 'playwright' | 'ado' | 'yaml';
+type Staleness = 'fresh' | 'stale' | 'unknown';
+type TestHintStatus = 'resolved' | 'gap' | 'acknowledged' | 'ignore';
+interface TestHint {
+    test: string;
+    status: TestHintStatus;
+    route?: string;
+    method?: string;
+    reason?: string;
+    confidence?: 'high' | 'medium' | 'low';
+    resolvedBy?: string;
+}
+interface AppRoute {
+    path: string;
+    method?: string;
+    area?: string;
+}
+interface TestEntry {
+    title: string;
+    source: TestSource;
+    filePath?: string;
+    lastRun?: Date;
+    tags?: string[];
+}
+interface RouteGap {
+    route: string;
+    method?: string;
+    reason?: string;
+    coveredByTests: TestEntry[];
+}
+interface RouteCoverage {
+    route: AppRoute;
+    status: CoverageStatus;
+    automatedTests: TestEntry[];
+    manualTests: TestEntry[];
+    staleness: Staleness;
+    lastTestedAt?: Date;
+    notes?: string;
+}
+interface AreaCoverage {
+    name: string;
+    routes: RouteCoverage[];
+    totalRoutes: number;
+    coveredRoutes: number;
+    automatedCount: number;
+    manualOnlyCount: number;
+    noCoverageCount: number;
+    coveragePercent: number;
+}
+interface CoverageReport {
+    generatedAt: Date;
+    projectName: string;
+    summary: {
+        totalRoutes: number;
+        totalCoverage: number;
+        automatedCoverage: number;
+        manualOnlyCoverage: number;
+        noCoverage: number;
+    };
+    areas: AreaCoverage[];
+    uncategorised: RouteCoverage[];
+    unmatchedTests: TestEntry[];
+    routeGaps: RouteGap[];
+    acknowledgedTests: TestHint[];
+}
+interface TestGapConfig {
+    projectName: string;
+    staleThresholdDays: number;
+    routes: {
+        type: 'nextjs' | 'express' | 'openapi' | 'manual';
+        path: string;
+        generate?: string;
+        basePath?: string;
+    };
+    tests?: {
+        path: string;
+    };
+    areas: {
+        name: string;
+        patterns: string[];
+    }[];
+    ado?: {
+        orgUrl: string;
+        project: string;
+        planId: number;
+        patEnvVar: string;
+    };
+    manualCoverage?: {
+        route: string;
+        lastTested: string;
+        tester?: string;
+        notes?: string;
+    }[];
+    thresholds?: {
+        area?: string;
+        minCoverage: number;
+    }[];
+    testHints?: TestHint[];
+}
+
+export type { AppRoute, AreaCoverage, CoverageReport, CoverageStatus, RouteCoverage, RouteGap, Staleness, TestEntry, TestGapConfig, TestHint, TestHintStatus, TestSource };

package/dist/core/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * src/core/types.ts
+ *
+ * ALL shared interfaces live here.
+ * Every other file in this project imports types from this file.
+ * Do not scatter interface definitions — keep this as the single source of truth.
+ */
+type CoverageStatus = 'automated' | 'manual' | 'both' | 'none';
+type TestSource = 'playwright' | 'ado' | 'yaml';
+type Staleness = 'fresh' | 'stale' | 'unknown';
+type TestHintStatus = 'resolved' | 'gap' | 'acknowledged' | 'ignore';
+interface TestHint {
+    test: string;
+    status: TestHintStatus;
+    route?: string;
+    method?: string;
+    reason?: string;
+    confidence?: 'high' | 'medium' | 'low';
+    resolvedBy?: string;
+}
+interface AppRoute {
+    path: string;
+    method?: string;
+    area?: string;
+}
+interface TestEntry {
+    title: string;
+    source: TestSource;
+    filePath?: string;
+    lastRun?: Date;
+    tags?: string[];
+}
+interface RouteGap {
+    route: string;
+    method?: string;
+    reason?: string;
+    coveredByTests: TestEntry[];
+}
+interface RouteCoverage {
+    route: AppRoute;
+    status: CoverageStatus;
+    automatedTests: TestEntry[];
+    manualTests: TestEntry[];
+    staleness: Staleness;
+    lastTestedAt?: Date;
+    notes?: string;
+}
+interface AreaCoverage {
+    name: string;
+    routes: RouteCoverage[];
+    totalRoutes: number;
+    coveredRoutes: number;
+    automatedCount: number;
+    manualOnlyCount: number;
+    noCoverageCount: number;
+    coveragePercent: number;
+}
+interface CoverageReport {
+    generatedAt: Date;
+    projectName: string;
+    summary: {
+        totalRoutes: number;
+        totalCoverage: number;
+        automatedCoverage: number;
+        manualOnlyCoverage: number;
+        noCoverage: number;
+    };
+    areas: AreaCoverage[];
+    uncategorised: RouteCoverage[];
+    unmatchedTests: TestEntry[];
+    routeGaps: RouteGap[];
+    acknowledgedTests: TestHint[];
+}
+interface TestGapConfig {
+    projectName: string;
+    staleThresholdDays: number;
+    routes: {
+        type: 'nextjs' | 'express' | 'openapi' | 'manual';
+        path: string;
+        generate?: string;
+        basePath?: string;
+    };
+    tests?: {
+        path: string;
+    };
+    areas: {
+        name: string;
+        patterns: string[];
+    }[];
+    ado?: {
+        orgUrl: string;
+        project: string;
+        planId: number;
+        patEnvVar: string;
+    };
+    manualCoverage?: {
+        route: string;
+        lastTested: string;
+        tester?: string;
+        notes?: string;
+    }[];
+    thresholds?: {
+        area?: string;
+        minCoverage: number;
+    }[];
+    testHints?: TestHint[];
+}
+
+export type { AppRoute, AreaCoverage, CoverageReport, CoverageStatus, RouteCoverage, RouteGap, Staleness, TestEntry, TestGapConfig, TestHint, TestHintStatus, TestSource };

package/dist/core/types.js

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * src/core/types.ts\n * \n * ALL shared interfaces live here.\n * Every other file in this project imports types from this file.\n * Do not scatter interface definitions — keep this as the single source of truth.\n */\n\nexport type CoverageStatus = 'automated' | 'manual' | 'both' | 'none'\nexport type TestSource = 'playwright' | 'ado' | 'yaml'\nexport type Staleness = 'fresh' | 'stale' | 'unknown'\nexport type TestHintStatus = 'resolved' | 'gap' | 'acknowledged' | 'ignore'\n\nexport interface TestHint {\n  test: string                              // exact test title to match\n  status: TestHintStatus                   // resolved | gap | acknowledged | ignore\n  route?: string                            // route path — for resolved + gap\n  method?: string                           // HTTP method — for gap (e.g. DELETE, PATCH)\n  reason?: string\n  confidence?: 'high' | 'medium' | 'low'\n  resolvedBy?: string                       // 'agent' | 'human' | 'ai'\n}\n\nexport interface AppRoute {\n  path: string       // e.g. /checkout/payment\n  method?: string    // GET | POST | etc — from OpenAPI\n  area?: string      // populated by AreaMatcher\n}\n\nexport interface TestEntry {\n  title: string\n  source: TestSource\n  filePath?: string  // playwright: which spec file\n  lastRun?: Date     // manual: from yaml or ADO\n  tags?: string[]\n}\n\nexport interface RouteGap {\n  route: string\n  method?: string\n  reason?: string\n  coveredByTests: TestEntry[]\n}\n\nexport interface RouteCoverage {\n  route: AppRoute\n  status: CoverageStatus\n  automatedTests: TestEntry[]\n  manualTests: TestEntry[]\n  staleness: Staleness\n  lastTestedAt?: Date\n  notes?: string\n}\n\nexport interface AreaCoverage {\n  name: string\n  routes: RouteCoverage[]\n  totalRoutes: number\n  coveredRoutes: number\n  automatedCount: number\n  manualOnlyCount: number\n  noCoverageCount: number\n  coveragePercent: number  // 0-100, rounded integer\n}\n\nexport interface CoverageReport {\n  generatedAt: Date\n  projectName: string\n  summary: {\n    totalRoutes: number\n    totalCoverage: number\n    automatedCoverage: number\n    manualOnlyCoverage: number\n    noCoverage: number\n  }\n  areas: AreaCoverage[]\n  uncategorised: RouteCoverage[]\n  unmatchedTests: TestEntry[]    // still unresolved — no hint applied\n  routeGaps: RouteGap[]          // tests targeting routes not in schema (gap hints)\n  acknowledgedTests: TestHint[]  // acknowledged or ignored hints\n}\n\nexport interface TestGapConfig {\n  projectName: string\n  staleThresholdDays: number\n  routes: {\n    type: 'nextjs' | 'express' | 'openapi' | 'manual'\n    path: string\n    generate?: string   // shell command to run before route discovery (e.g. to produce openapi.json)\n    basePath?: string   // prefix stripped when grouping routes into areas (e.g. /api, /api/v1)\n  }\n  tests?: {\n    path: string       // directory to scan for *.spec.ts / *.test.ts files\n                       // relative to qualitylens.yaml location\n                       // default: same directory as qualitylens.yaml\n  }\n  areas: {\n    name: string\n    patterns: string[]\n  }[]\n  ado?: {\n    orgUrl: string\n    project: string\n    planId: number\n    patEnvVar: string  // env var name — never hardcode the PAT value\n  }\n  manualCoverage?: {\n    route: string\n    lastTested: string  // ISO date string\n    tester?: string\n    notes?: string\n  }[]\n  thresholds?: {\n    area?: string       // area name or '*' for global\n    minCoverage: number // 0-100\n  }[]\n  testHints?: TestHint[]\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/core/types.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=types.mjs.map

package/dist/core/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/matchers/area.matcher.d.mts

@@ -0,0 +1,38 @@
+import { TestGapConfig, RouteCoverage, AreaCoverage } from '../core/types.mjs';
+
+/**
+ * src/matchers/area.matcher.ts
+ *
+ * Groups routes into functional areas based on path prefix patterns.
+ * Most-specific pattern wins (longest prefix match).
+ *
+ * AI INSTRUCTIONS: implement assign() using the skeleton below.
+ */
+
+declare class AreaMatcher {
+    private areaConfigs;
+    constructor(areaConfigs: TestGapConfig['areas']);
+    assign(routes: RouteCoverage[]): {
+        areas: AreaCoverage[];
+        uncategorised: RouteCoverage[];
+    };
+    /**
+     * AI INSTRUCTIONS:
+     * 1. For each area config, check if route path starts with any of its patterns
+     * 2. Among all matching areas, return the one with the LONGEST matching pattern
+     *    (most specific wins — /checkout/payment should prefer /checkout over /)
+     * 3. Return undefined if no area matches
+     */
+    private findBestArea;
+    /**
+     * AI INSTRUCTIONS: compute AreaCoverage statistics from a list of RouteCoverage.
+     * - coveredRoutes: routes where status !== 'none'
+     * - automatedCount: routes where status === 'automated' or 'both'
+     * - manualOnlyCount: routes where status === 'manual'
+     * - noCoverageCount: routes where status === 'none'
+     * - coveragePercent: Math.round((coveredRoutes / totalRoutes) * 100)
+     */
+    private buildAreaCoverage;
+}
+
+export { AreaMatcher };

package/dist/matchers/area.matcher.d.ts

@@ -0,0 +1,38 @@
+import { TestGapConfig, RouteCoverage, AreaCoverage } from '../core/types.js';
+
+/**
+ * src/matchers/area.matcher.ts
+ *
+ * Groups routes into functional areas based on path prefix patterns.
+ * Most-specific pattern wins (longest prefix match).
+ *
+ * AI INSTRUCTIONS: implement assign() using the skeleton below.
+ */
+
+declare class AreaMatcher {
+    private areaConfigs;
+    constructor(areaConfigs: TestGapConfig['areas']);
+    assign(routes: RouteCoverage[]): {
+        areas: AreaCoverage[];
+        uncategorised: RouteCoverage[];
+    };
+    /**
+     * AI INSTRUCTIONS:
+     * 1. For each area config, check if route path starts with any of its patterns
+     * 2. Among all matching areas, return the one with the LONGEST matching pattern
+     *    (most specific wins — /checkout/payment should prefer /checkout over /)
+     * 3. Return undefined if no area matches
+     */
+    private findBestArea;
+    /**
+     * AI INSTRUCTIONS: compute AreaCoverage statistics from a list of RouteCoverage.
+     * - coveredRoutes: routes where status !== 'none'
+     * - automatedCount: routes where status === 'automated' or 'both'
+     * - manualOnlyCount: routes where status === 'manual'
+     * - noCoverageCount: routes where status === 'none'
+     * - coveragePercent: Math.round((coveredRoutes / totalRoutes) * 100)
+     */
+    private buildAreaCoverage;
+}
+
+export { AreaMatcher };

package/dist/matchers/area.matcher.js

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/matchers/area.matcher.ts
+var area_matcher_exports = {};
+__export(area_matcher_exports, {
+  AreaMatcher: () => AreaMatcher
+});
+module.exports = __toCommonJS(area_matcher_exports);
+var AreaMatcher = class {
+  constructor(areaConfigs) {
+    this.areaConfigs = areaConfigs;
+  }
+  assign(routes) {
+    const areaMap = /* @__PURE__ */ new Map();
+    const uncategorised = [];
+    for (const area of this.areaConfigs) {
+      areaMap.set(area.name, []);
+    }
+    for (const route of routes) {
+      const areaName = this.findBestArea(route.route.path);
+      if (areaName) {
+        areaMap.get(areaName).push(route);
+      } else {
+        uncategorised.push(route);
+      }
+    }
+    const areas = [];
+    for (const [name, areaRoutes] of areaMap.entries()) {
+      if (areaRoutes.length === 0) continue;
+      areas.push(this.buildAreaCoverage(name, areaRoutes));
+    }
+    return { areas, uncategorised };
+  }
+  /**
+   * AI INSTRUCTIONS:
+   * 1. For each area config, check if route path starts with any of its patterns
+   * 2. Among all matching areas, return the one with the LONGEST matching pattern
+   *    (most specific wins — /checkout/payment should prefer /checkout over /)
+   * 3. Return undefined if no area matches
+   */
+  findBestArea(routePath) {
+    let bestArea;
+    let bestLength = 0;
+    for (const area of this.areaConfigs) {
+      for (const pattern of area.patterns) {
+        if (routePath.startsWith(pattern) && pattern.length > bestLength) {
+          bestArea = area.name;
+          bestLength = pattern.length;
+        }
+      }
+    }
+    return bestArea;
+  }
+  /**
+   * AI INSTRUCTIONS: compute AreaCoverage statistics from a list of RouteCoverage.
+   * - coveredRoutes: routes where status !== 'none'
+   * - automatedCount: routes where status === 'automated' or 'both'
+   * - manualOnlyCount: routes where status === 'manual'
+   * - noCoverageCount: routes where status === 'none'
+   * - coveragePercent: Math.round((coveredRoutes / totalRoutes) * 100)
+   */
+  buildAreaCoverage(name, routes) {
+    const totalRoutes = routes.length;
+    const coveredRoutes = routes.filter((r) => r.status !== "none").length;
+    const automatedCount = routes.filter((r) => r.status === "automated" || r.status === "both").length;
+    const manualOnlyCount = routes.filter((r) => r.status === "manual").length;
+    const noCoverageCount = routes.filter((r) => r.status === "none").length;
+    const coveragePercent = totalRoutes > 0 ? Math.round(coveredRoutes / totalRoutes * 100) : 0;
+    return {
+      name,
+      routes,
+      totalRoutes,
+      coveredRoutes,
+      automatedCount,
+      manualOnlyCount,
+      noCoverageCount,
+      coveragePercent
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AreaMatcher
+});
+//# sourceMappingURL=area.matcher.js.map

package/dist/matchers/area.matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/matchers/area.matcher.ts"],"sourcesContent":["/**\n * src/matchers/area.matcher.ts\n * \n * Groups routes into functional areas based on path prefix patterns.\n * Most-specific pattern wins (longest prefix match).\n * \n * AI INSTRUCTIONS: implement assign() using the skeleton below.\n */\n\nimport { AreaCoverage, RouteCoverage, TestGapConfig } from '../core/types'\n\nexport class AreaMatcher {\n  constructor(private areaConfigs: TestGapConfig['areas']) {}\n\n  assign(routes: RouteCoverage[]): {\n    areas: AreaCoverage[]\n    uncategorised: RouteCoverage[]\n  } {\n    const areaMap = new Map<string, RouteCoverage[]>()\n    const uncategorised: RouteCoverage[] = []\n\n    // Initialise area buckets\n    for (const area of this.areaConfigs) {\n      areaMap.set(area.name, [])\n    }\n\n    // Assign each route to the best-matching area\n    for (const route of routes) {\n      const areaName = this.findBestArea(route.route.path)\n      if (areaName) {\n        areaMap.get(areaName)!.push(route)\n      } else {\n        uncategorised.push(route)\n      }\n    }\n\n    // Build AreaCoverage objects\n    const areas: AreaCoverage[] = []\n    for (const [name, areaRoutes] of areaMap.entries()) {\n      if (areaRoutes.length === 0) continue\n      areas.push(this.buildAreaCoverage(name, areaRoutes))\n    }\n\n    return { areas, uncategorised }\n  }\n\n  /**\n   * AI INSTRUCTIONS:\n   * 1. For each area config, check if route path starts with any of its patterns\n   * 2. Among all matching areas, return the one with the LONGEST matching pattern\n   *    (most specific wins — /checkout/payment should prefer /checkout over /)\n   * 3. Return undefined if no area matches\n   */\n  private findBestArea(routePath: string): string | undefined {\n    // TODO (AI): implement\n    let bestArea: string | undefined\n    let bestLength = 0\n\n    for (const area of this.areaConfigs) {\n      for (const pattern of area.patterns) {\n        if (routePath.startsWith(pattern) && pattern.length > bestLength) {\n          bestArea = area.name\n          bestLength = pattern.length\n        }\n      }\n    }\n\n    return bestArea\n  }\n\n  /**\n   * AI INSTRUCTIONS: compute AreaCoverage statistics from a list of RouteCoverage.\n   * - coveredRoutes: routes where status !== 'none'\n   * - automatedCount: routes where status === 'automated' or 'both'\n   * - manualOnlyCount: routes where status === 'manual'\n   * - noCoverageCount: routes where status === 'none'\n   * - coveragePercent: Math.round((coveredRoutes / totalRoutes) * 100)\n   */\n  private buildAreaCoverage(name: string, routes: RouteCoverage[]): AreaCoverage {\n    // TODO (AI): implement\n    const totalRoutes = routes.length\n    const coveredRoutes = routes.filter(r => r.status !== 'none').length\n    const automatedCount = routes.filter(r => r.status === 'automated' || r.status === 'both').length\n    const manualOnlyCount = routes.filter(r => r.status === 'manual').length\n    const noCoverageCount = routes.filter(r => r.status === 'none').length\n    const coveragePercent = totalRoutes > 0 ? Math.round((coveredRoutes / totalRoutes) * 100) : 0\n\n    return {\n      name,\n      routes,\n      totalRoutes,\n      coveredRoutes,\n      automatedCount,\n      manualOnlyCount,\n      noCoverageCount,\n      coveragePercent,\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAWO,IAAM,cAAN,MAAkB;AAAA,EACvB,YAAoB,aAAqC;AAArC;AAAA,EAAsC;AAAA,EAE1D,OAAO,QAGL;AACA,UAAM,UAAU,oBAAI,IAA6B;AACjD,UAAM,gBAAiC,CAAC;AAGxC,eAAW,QAAQ,KAAK,aAAa;AACnC,cAAQ,IAAI,KAAK,MAAM,CAAC,CAAC;AAAA,IAC3B;AAGA,eAAW,SAAS,QAAQ;AAC1B,YAAM,WAAW,KAAK,aAAa,MAAM,MAAM,IAAI;AACnD,UAAI,UAAU;AACZ,gBAAQ,IAAI,QAAQ,EAAG,KAAK,KAAK;AAAA,MACnC,OAAO;AACL,sBAAc,KAAK,KAAK;AAAA,MAC1B;AAAA,IACF;AAGA,UAAM,QAAwB,CAAC;AAC/B,eAAW,CAAC,MAAM,UAAU,KAAK,QAAQ,QAAQ,GAAG;AAClD,UAAI,WAAW,WAAW,EAAG;AAC7B,YAAM,KAAK,KAAK,kBAAkB,MAAM,UAAU,CAAC;AAAA,IACrD;AAEA,WAAO,EAAE,OAAO,cAAc;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,aAAa,WAAuC;AAE1D,QAAI;AACJ,QAAI,aAAa;AAEjB,eAAW,QAAQ,KAAK,aAAa;AACnC,iBAAW,WAAW,KAAK,UAAU;AACnC,YAAI,UAAU,WAAW,OAAO,KAAK,QAAQ,SAAS,YAAY;AAChE,qBAAW,KAAK;AAChB,uBAAa,QAAQ;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,kBAAkB,MAAc,QAAuC;AAE7E,UAAM,cAAc,OAAO;AAC3B,UAAM,gBAAgB,OAAO,OAAO,OAAK,EAAE,WAAW,MAAM,EAAE;AAC9D,UAAM,iBAAiB,OAAO,OAAO,OAAK,EAAE,WAAW,eAAe,EAAE,WAAW,MAAM,EAAE;AAC3F,UAAM,kBAAkB,OAAO,OAAO,OAAK,EAAE,WAAW,QAAQ,EAAE;AAClE,UAAM,kBAAkB,OAAO,OAAO,OAAK,EAAE,WAAW,MAAM,EAAE;AAChE,UAAM,kBAAkB,cAAc,IAAI,KAAK,MAAO,gBAAgB,cAAe,GAAG,IAAI;AAE5F,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;","names":[]}