@qulib/core 0.4.1 → 0.4.3

package/dist/tools/scoring/gaps.js

@@ -0,0 +1,138 @@
+import { randomUUID } from 'node:crypto';
+import { GapSchema } from '../../schemas/gap-analysis.schema.js';
+// TODO: Add category-specific weight overrides (e.g., auth-surface gaps should cost more than untested-route gaps by default).
+// Requires a 2D weight matrix: { [severity]: { [category]: number } }.
+// Deferred until there is empirical data from real scan runs to calibrate.
+const DEFAULT_SCORING_WEIGHTS = { critical: 25, high: 20, medium: 8, low: 3 };
+export function computeQualityScoreFromGaps(gaps, scoringWeights) {
+    let critical = 0;
+    let high = 0;
+    let medium = 0;
+    let low = 0;
+    for (const g of gaps) {
+        if (g.severity === 'critical')
+            critical++;
+        else if (g.severity === 'high')
+            high++;
+        else if (g.severity === 'medium')
+            medium++;
+        else
+            low++;
+    }
+    const w = {
+        critical: scoringWeights?.critical ?? DEFAULT_SCORING_WEIGHTS.critical,
+        high: scoringWeights?.high ?? DEFAULT_SCORING_WEIGHTS.high,
+        medium: scoringWeights?.medium ?? DEFAULT_SCORING_WEIGHTS.medium,
+        low: scoringWeights?.low ?? DEFAULT_SCORING_WEIGHTS.low,
+    };
+    return Math.max(0, 100 - critical * w.critical - high * w.high - medium * w.medium - low * w.low);
+}
+export function computeCoverageScore(routes) {
+    const scanned = routes.routes.length;
+    const skipped = routes.pagesSkipped;
+    const denom = scanned + skipped;
+    // TODO: return null here once the explorer exposes an explicit "discovered-but-unknown" signal
+    //       (i.e. routes were found but the full set couldn't be confirmed — a low score is misleading)
+    if (denom === 0) {
+        if (routes.budgetExceeded) {
+            return 0;
+        }
+        return scanned === 0 ? 0 : 100;
+    }
+    return Math.round((100 * scanned) / denom);
+}
+export function analyzeGaps(routes, repo, mode, config) {
+    const coveredPaths = new Set();
+    if (repo) {
+        for (const testFile of repo.testFiles) {
+            for (const path of testFile.coveredPaths) {
+                coveredPaths.add(path);
+            }
+        }
+    }
+    const gaps = [];
+    const addGap = (gap) => {
+        const validated = GapSchema.parse(gap);
+        gaps.push(validated);
+    };
+    let hasNavigationFailures = false;
+    for (const route of routes.routes) {
+        if (repo && !coveredPaths.has(route.path)) {
+            const highRisk = /checkout|payment|auth|login|order/i.test(route.path);
+            addGap({
+                id: randomUUID(),
+                path: route.path,
+                severity: highRisk ? 'high' : 'medium',
+                reason: `Route is not covered by existing tests: ${route.path}`,
+                category: 'untested-route',
+            });
+        }
+        const navErrors = route.consoleErrors.filter((e) => e.startsWith('Navigation error:'));
+        if (navErrors.length > 0) {
+            hasNavigationFailures = true;
+            addGap({
+                id: randomUUID(),
+                path: route.path,
+                severity: 'high',
+                reason: `Navigation failed: ${navErrors.join('; ')}`,
+                category: 'console-error',
+            });
+        }
+        else if (route.consoleErrors.length > 0) {
+            addGap({
+                id: randomUUID(),
+                path: route.path,
+                severity: 'high',
+                reason: `Console errors detected (${route.consoleErrors.length})`,
+                category: 'console-error',
+            });
+        }
+        if (route.brokenLinks.length > 0) {
+            addGap({
+                id: randomUUID(),
+                path: route.path,
+                severity: 'medium',
+                reason: `Broken or invalid links detected (${route.brokenLinks.length})`,
+                category: 'broken-link',
+            });
+        }
+        for (const violation of route.a11yViolations) {
+            const impact = violation.impact.toLowerCase();
+            const severity = impact === 'critical'
+                ? 'critical'
+                : impact === 'serious'
+                    ? 'high'
+                    : impact === 'moderate'
+                        ? 'medium'
+                        : 'low';
+            addGap({
+                id: randomUUID(),
+                path: route.path,
+                severity,
+                reason: `A11y violation ${violation.id} (${violation.impact}): ${violation.helpUrl}`,
+                category: 'a11y',
+            });
+        }
+    }
+    const releaseConfidence = computeQualityScoreFromGaps(gaps, config.scoringWeights);
+    const pagesScanned = routes.routes.length;
+    let coverageWarning;
+    if (routes.budgetExceeded) {
+        coverageWarning = 'budget-exceeded';
+    }
+    else if (hasNavigationFailures) {
+        coverageWarning = 'navigation-failures';
+    }
+    else if (pagesScanned < config.minPagesForConfidence) {
+        coverageWarning = 'low-coverage';
+    }
+    return {
+        analyzedAt: new Date().toISOString(),
+        mode,
+        releaseConfidence,
+        coveragePagesScanned: pagesScanned,
+        coverageBudgetExceeded: routes.budgetExceeded,
+        coverageWarning,
+        gaps,
+    };
+}

package/dist/tools/scoring/public-surface.d.ts

@@ -0,0 +1,5 @@
+import type { RouteInventory } from '../../schemas/route-inventory.schema.js';
+import type { Gap } from '../../schemas/gap-analysis.schema.js';
+import type { PublicSurface } from '../../schemas/public-surface.schema.js';
+export declare function buildPublicSurface(pages: RouteInventory['routes'], gaps: Gap[]): PublicSurface;
+//# sourceMappingURL=public-surface.d.ts.map

package/dist/tools/scoring/public-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-surface.d.ts","sourceRoot":"","sources":["../../../src/tools/scoring/public-surface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,sCAAsC,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAmD,MAAM,wCAAwC,CAAC;AAE7H,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,aAAa,CAY9F"}

package/dist/tools/scoring/public-surface.js

@@ -0,0 +1,13 @@
+export function buildPublicSurface(pages, gaps) {
+    const accessibilityViolations = [];
+    const brokenLinks = [];
+    for (const r of pages) {
+        for (const v of r.a11yViolations) {
+            accessibilityViolations.push({ ...v, path: r.path });
+        }
+        for (const b of r.brokenLinks) {
+            brokenLinks.push({ ...b, path: r.path });
+        }
+    }
+    return { pages, gaps, accessibilityViolations, brokenLinks };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qulib/core",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Qulib — analyze deployed web apps for honest quality gaps (CLI + programmatic API)",
   "license": "MIT",
   "author": "Tapesh Nagarwal",
@@ -48,8 +48,8 @@
     "analyze": "tsx src/cli/index.ts analyze",
     "clean": "tsx src/cli/index.ts clean",
     "build": "tsc",
-    "test": "node --import tsx/esm --test src/llm/cost-intelligence.test.ts src/tools/gap-engine.test.ts src/tools/auth-block-gap.test.ts",
-    "test:integration": "node --import tsx/esm --test src/analyze.integration.test.ts",
+    "test": "node --import tsx/esm --test src/llm/__tests__/cost-intelligence.test.ts src/tools/scoring/__tests__/gaps.test.ts src/tools/auth/__tests__/gaps.test.ts src/tools/auth/__tests__/detect.test.ts src/tools/scoring/__tests__/automation-maturity.test.ts src/harness/__tests__/state-manager.test.ts src/telemetry/__tests__/redact-url.test.ts src/cli/__tests__/auth-login.test.ts src/cli/__tests__/cli-version.test.ts src/__tests__/analyze.storage-state-invalid.test.ts",
+    "test:integration": "node --import tsx/esm --test src/__tests__/analyze.integration.test.ts",
     "smoke": "tsx src/cli/index.ts analyze --url https://example.com --ephemeral",
     "cost-doctor": "tsx src/cli/index.ts cost doctor"
   },