@qulib/core 0.3.1 → 0.4.1

package/dist/tools/automation-maturity.js

@@ -0,0 +1,163 @@
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { AutomationMaturitySchema } from '../schemas/automation-maturity.schema.js';
+/**
+ * Dimension weights (sum = 1). Breadth + harness adoption dominate: shipping risk is mostly
+ * untested routes and missing Playwright/Cypress-level coverage.
+ */
+const W_TEST_BREADTH = 0.28;
+const W_FRAMEWORK = 0.22;
+const W_TEST_ID = 0.18;
+const W_CI = 0.14;
+const W_AUTH_TESTS = 0.1;
+const W_COMPONENT_RATIO = 0.08;
+function hasCiAtRoot(repoPath) {
+    const ev = [];
+    const gh = join(repoPath, '.github', 'workflows');
+    if (existsSync(gh) && statSync(gh).isDirectory()) {
+        try {
+            const files = readdirSync(gh).filter((f) => f.endsWith('.yml') || f.endsWith('.yaml'));
+            if (files.length > 0) {
+                ev.push(`.github/workflows (${files.length} workflow file(s))`);
+                return { ok: true, evidence: ev };
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    if (existsSync(join(repoPath, '.circleci'))) {
+        ev.push('.circleci/ present');
+        return { ok: true, evidence: ev };
+    }
+    for (const f of ['.gitlab-ci.yml', 'Jenkinsfile']) {
+        if (existsSync(join(repoPath, f))) {
+            ev.push(`${f} present`);
+            return { ok: true, evidence: ev };
+        }
+    }
+    return { ok: false, evidence: ['No GitHub Actions, CircleCI, GitLab CI, or Jenkinsfile detected at repo root'] };
+}
+function scoreLevel(overall) {
+    if (overall < 20)
+        return { level: 1, label: 'L1 — nascent automation' };
+    if (overall < 40)
+        return { level: 2, label: 'L2 — emerging coverage' };
+    if (overall < 60)
+        return { level: 3, label: 'L3 — building maturity' };
+    if (overall < 80)
+        return { level: 4, label: 'L4 — strong automation' };
+    return { level: 5, label: 'L5 — advanced QA automation' };
+}
+export function computeAutomationMaturity(repo) {
+    const routePaths = [...new Set(repo.routes.map((r) => r.path))];
+    let coveredRoutes = 0;
+    for (const p of routePaths) {
+        const covered = repo.testFiles.some((tf) => tf.coveredPaths.some((c) => p === c || (c !== '/' && p.startsWith(c))));
+        if (covered)
+            coveredRoutes++;
+    }
+    const breadthScore = routePaths.length === 0 ? 100 : Math.round((100 * coveredRoutes) / routePaths.length);
+    const breadthDim = {
+        dimension: 'test-coverage-breadth',
+        score: breadthScore,
+        weight: W_TEST_BREADTH,
+        evidence: routePaths.length === 0
+            ? ['No static routes inferred from repo layout']
+            : [
+                `${coveredRoutes}/${routePaths.length} inferred routes appear in at least one test coveredPaths`,
+            ],
+        recommendations: breadthScore >= 80
+            ? []
+            : ['Add route-level smoke tests that assert critical paths referenced in production URLs.'],
+    };
+    const types = new Set(repo.testFiles.map((t) => t.type));
+    let frameworkScore = 0;
+    const fwEvidence = [`Test runners seen: ${[...types].join(', ') || 'none'}`];
+    if (types.has('playwright') || types.has('cypress-e2e') || types.has('cypress-component')) {
+        frameworkScore = 100;
+        fwEvidence.push('Playwright or Cypress present — good browser harness signal.');
+    }
+    else if (types.has('jest') || types.has('vitest')) {
+        frameworkScore = 55;
+        fwEvidence.push('Jest/Vitest only — add Playwright or Cypress for deployment-facing checks.');
+    }
+    else if (repo.testFiles.length > 0) {
+        frameworkScore = 30;
+        fwEvidence.push('Tests exist but no recognized browser harness in scanned files.');
+    }
+    else {
+        frameworkScore = 0;
+        fwEvidence.push('No test files matched qulib scan globs.');
+    }
+    const frameworkDim = {
+        dimension: 'framework-adoption',
+        score: frameworkScore,
+        weight: W_FRAMEWORK,
+        evidence: fwEvidence,
+        recommendations: frameworkScore >= 80 ? [] : ['Standardize on Playwright or Cypress for E2E against deployed URLs.'],
+    };
+    const hygienePenalty = Math.min(100, repo.missingTestIds.length * 6);
+    const hygieneScore = Math.max(0, 100 - hygienePenalty);
+    const hygieneDim = {
+        dimension: 'test-id-hygiene',
+        score: hygieneScore,
+        weight: W_TEST_ID,
+        evidence: [
+            `${repo.missingTestIds.length} TSX file(s) with interactive markup but no data-testid (heuristic scan).`,
+        ],
+        recommendations: hygieneScore >= 85 ? [] : ['Add stable data-testid (or role-based selectors) on interactive components used in tests.'],
+    };
+    const ci = hasCiAtRoot(repo.repoPath);
+    const ciDim = {
+        dimension: 'ci-integration',
+        score: ci.ok ? 100 : 0,
+        weight: W_CI,
+        evidence: ci.evidence,
+        recommendations: ci.ok ? [] : ['Add a CI workflow that runs unit/E2E tests on every PR.'],
+    };
+    const authRe = /\/(login|auth|signin)(\/|$)/i;
+    const authCovered = repo.testFiles.some((tf) => tf.coveredPaths.some((c) => authRe.test(c)));
+    const authScore = authCovered ? 90 : 25;
+    const authDim = {
+        dimension: 'auth-test-coverage',
+        score: authScore,
+        weight: W_AUTH_TESTS,
+        evidence: authCovered
+            ? ['At least one test references /login, /auth, or /signin in coveredPaths.']
+            : ['No obvious auth-route coverage in extracted test path strings.'],
+        recommendations: authCovered ? [] : ['Add focused tests for sign-in and post-auth landing behavior.'],
+    };
+    const cypressE2e = repo.testFiles.filter((t) => t.type === 'cypress-e2e').length;
+    const cypressComp = repo.testFiles.filter((t) => t.type === 'cypress-component').length;
+    const cypressTotal = cypressE2e + cypressComp;
+    const compRatioScore = cypressTotal === 0 ? 50 : Math.round((100 * cypressComp) / cypressTotal);
+    const compDim = {
+        dimension: 'component-test-ratio',
+        score: compRatioScore,
+        weight: W_COMPONENT_RATIO,
+        evidence: [
+            `Cypress e2e files (matched): ${cypressE2e}, component: ${cypressComp}.`,
+        ],
+        recommendations: cypressComp === 0 || cypressTotal === 0
+            ? []
+            : ['Balance component vs E2E Cypress tests so critical flows stay fast in CI.'],
+    };
+    const dimensions = [breadthDim, frameworkDim, hygieneDim, ciDim, authDim, compDim];
+    const overallScore = Math.round(dimensions.reduce((s, d) => s + d.score * d.weight, 0));
+    const { level, label } = scoreLevel(overallScore);
+    const topRecommendations = [...dimensions]
+        .sort((a, b) => a.score - b.score)
+        .flatMap((d) => d.recommendations)
+        .filter(Boolean)
+        .slice(0, 8);
+    return AutomationMaturitySchema.parse({
+        computedAt: new Date().toISOString(),
+        repoPath: repo.repoPath,
+        overallScore,
+        level,
+        label,
+        dimensions,
+        topRecommendations,
+    });
+}

package/dist/tools/framework-detector.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module framework-detector
+ * @packageBoundary @qulib/core (candidate: @qulib/analyzer)
+ *
+ * Framework detection runs during the observe phase as part of repo scanning.
+ * It is a pure static analysis operation with no browser or LLM dependency.
+ * Move this to @qulib/analyzer when that package is created.
+ *
+ * // TODO(@qulib/analyzer): When @qulib/analyzer is extracted, this module should move there.
+ * // It is currently embedded in @qulib/core because repo scanning is part of the observe phase.
+ * // The package boundary decision: core = runtime QA analysis, analyzer = static repo intelligence.
+ */
+import { type FrameworkDetectionResult } from '../schemas/repo-analysis.schema.js';
+export declare function detectFramework(repoPath: string): Promise<FrameworkDetectionResult>;
+//# sourceMappingURL=framework-detector.d.ts.map

package/dist/tools/framework-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-detector.d.ts","sourceRoot":"","sources":["../../src/tools/framework-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAA4B,KAAK,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAuB7G,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA4GzF"}

package/dist/tools/framework-detector.js

@@ -0,0 +1,153 @@
+/**
+ * @module framework-detector
+ * @packageBoundary @qulib/core (candidate: @qulib/analyzer)
+ *
+ * Framework detection runs during the observe phase as part of repo scanning.
+ * It is a pure static analysis operation with no browser or LLM dependency.
+ * Move this to @qulib/analyzer when that package is created.
+ *
+ * // TODO(@qulib/analyzer): When @qulib/analyzer is extracted, this module should move there.
+ * // It is currently embedded in @qulib/core because repo scanning is part of the observe phase.
+ * // The package boundary decision: core = runtime QA analysis, analyzer = static repo intelligence.
+ */
+import { access, readFile } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { join } from 'node:path';
+import { FrameworkDetectionSchema } from '../schemas/repo-analysis.schema.js';
+async function fileExists(repoPath, rel) {
+    try {
+        await access(join(repoPath, rel), constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function depNames(pkg) {
+    return new Set([
+        ...Object.keys(pkg.dependencies ?? {}),
+        ...Object.keys(pkg.devDependencies ?? {}),
+    ]);
+}
+export async function detectFramework(repoPath) {
+    const evidence = [];
+    const testFrameworks = new Set();
+    let pkg = {};
+    try {
+        const raw = await readFile(join(repoPath, 'package.json'), 'utf8');
+        pkg = JSON.parse(raw);
+        evidence.push('read package.json');
+    }
+    catch {
+        evidence.push('package.json missing or unreadable');
+    }
+    const deps = depNames(pkg);
+    const has = (n) => deps.has(n);
+    if (has('@playwright/test') || has('playwright')) {
+        testFrameworks.add('playwright');
+        evidence.push('dependency: @playwright/test or playwright');
+    }
+    if (has('cypress')) {
+        testFrameworks.add('cypress-e2e');
+        evidence.push('dependency: cypress');
+    }
+    if (has('jest')) {
+        testFrameworks.add('jest');
+        evidence.push('dependency: jest');
+    }
+    if (has('vitest')) {
+        testFrameworks.add('vitest');
+        evidence.push('dependency: vitest');
+    }
+    if (testFrameworks.size === 0) {
+        testFrameworks.add('other');
+    }
+    const nextCfg = (await fileExists(repoPath, 'next.config.js')) ||
+        (await fileExists(repoPath, 'next.config.mjs')) ||
+        (await fileExists(repoPath, 'next.config.ts'));
+    const nuxtCfg = await fileExists(repoPath, 'nuxt.config.ts');
+    const svelteCfg = await fileExists(repoPath, 'svelte.config.js');
+    const astroCfg = await fileExists(repoPath, 'astro.config.mjs');
+    const remixCfg = await fileExists(repoPath, 'remix.config.js');
+    const viteCfg = await fileExists(repoPath, 'vite.config.ts');
+    if (nextCfg)
+        evidence.push('found next.config.*');
+    if (nuxtCfg)
+        evidence.push('found nuxt.config.ts');
+    if (svelteCfg)
+        evidence.push('found svelte.config.js');
+    if (astroCfg)
+        evidence.push('found astro.config.mjs');
+    if (remixCfg)
+        evidence.push('found remix.config.js');
+    if (viteCfg)
+        evidence.push('found vite.config.ts');
+    const hasAppDir = await fileExists(repoPath, 'app');
+    const hasPagesDir = await fileExists(repoPath, 'pages');
+    if (has('next') && hasAppDir)
+        evidence.push('Next.js app/ directory present');
+    if (has('next') && hasPagesDir)
+        evidence.push('Next.js pages/ directory present');
+    if (has('@remix-run/react') || has('@remix-run/node'))
+        evidence.push('Remix packages in package.json');
+    if (has('nuxt') || has('nuxt3'))
+        evidence.push('Nuxt in package.json');
+    if (has('@sveltejs/kit'))
+        evidence.push('@sveltejs/kit in package.json');
+    if (has('astro'))
+        evidence.push('astro in package.json');
+    if (has('vite') && !has('next'))
+        evidence.push('vite in package.json (non-Next)');
+    let primary = 'unknown';
+    let confidence = 'low';
+    if (has('next')) {
+        if (hasAppDir && (await fileExists(repoPath, join('app', 'layout.tsx')))) {
+            primary = 'nextjs-app-router';
+            confidence = nextCfg || hasAppDir ? 'high' : 'medium';
+        }
+        else if (hasPagesDir) {
+            primary = 'nextjs-pages-router';
+            confidence = nextCfg || hasPagesDir ? 'high' : 'medium';
+        }
+        else {
+            primary = 'nextjs-app-router';
+            confidence = 'medium';
+            evidence.push('next detected without clear app/ vs pages/ layout');
+        }
+    }
+    else if (has('@remix-run/react') || remixCfg) {
+        primary = 'remix';
+        confidence = remixCfg ? 'high' : 'medium';
+    }
+    else if (has('nuxt') || nuxtCfg) {
+        primary = 'nuxt';
+        confidence = nuxtCfg ? 'high' : 'medium';
+    }
+    else if (has('@sveltejs/kit') || svelteCfg) {
+        primary = 'sveltekit';
+        confidence = svelteCfg ? 'high' : 'medium';
+    }
+    else if (has('astro') || astroCfg) {
+        primary = 'astro';
+        confidence = astroCfg ? 'high' : 'medium';
+    }
+    else if (viteCfg && !has('next')) {
+        primary = 'vite';
+        confidence = 'medium';
+    }
+    else if (has('express')) {
+        primary = 'express';
+        confidence = 'medium';
+        evidence.push('express listed in dependencies');
+    }
+    else {
+        /* keep unknown */
+    }
+    const raw = {
+        primary,
+        confidence,
+        evidence,
+        testFrameworks: [...testFrameworks],
+    };
+    return FrameworkDetectionSchema.parse(raw);
+}

package/dist/tools/gap-engine.d.ts

@@ -2,7 +2,7 @@ import { type GapAnalysis, type Gap } from '../schemas/gap-analysis.schema.js';
 import type { RouteInventory } from '../schemas/route-inventory.schema.js';
 import type { RepoAnalysis } from '../schemas/repo-analysis.schema.js';
 import type { HarnessConfig } from '../schemas/config.schema.js';
-export declare function computeQualityScoreFromGaps(gaps: Gap[]): number;
+export declare function computeQualityScoreFromGaps(gaps: Gap[], scoringWeights?: HarnessConfig['scoringWeights']): number;
 export declare function computeCoverageScore(routes: RouteInventory): number | null;
 export declare function analyzeGaps(routes: RouteInventory, repo: RepoAnalysis | null, mode: 'url-only' | 'url-repo', config: HarnessConfig): Omit<GapAnalysis, 'scenarios' | 'generatedTests'>;
 //# sourceMappingURL=gap-engine.d.ts.map

package/dist/tools/gap-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gap-engine.d.ts","sourceRoot":"","sources":["../../src/tools/gap-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAY/D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAa1E;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,GAAG,IAAI,EACzB,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,MAAM,EAAE,aAAa,GACpB,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAqGnD"}
+{"version":3,"file":"gap-engine.d.ts","sourceRoot":"","sources":["../../src/tools/gap-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAQjE,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,GAAG,EAAE,EACX,cAAc,CAAC,EAAE,aAAa,CAAC,gBAAgB,CAAC,GAC/C,MAAM,CAkBR;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAa1E;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,YAAY,GAAG,IAAI,EACzB,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,MAAM,EAAE,aAAa,GACpB,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,CAAC,CAqGnD"}

package/dist/tools/gap-engine.js

@@ -1,6 +1,10 @@
 import { randomUUID } from 'node:crypto';
 import { GapSchema } from '../schemas/gap-analysis.schema.js';
-export function computeQualityScoreFromGaps(gaps) {
+// 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;
@@ -15,7 +19,13 @@ export function computeQualityScoreFromGaps(gaps) {
         else
             low++;
     }
-    return Math.max(0, 100 - critical * 25 - high * 20 - medium * 8 - low * 3);
+    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;
@@ -104,7 +114,7 @@ export function analyzeGaps(routes, repo, mode, config) {
             });
         }
     }
-    const releaseConfidence = computeQualityScoreFromGaps(gaps);
+    const releaseConfidence = computeQualityScoreFromGaps(gaps, config.scoringWeights);
     const pagesScanned = routes.routes.length;
     let coverageWarning;
     if (routes.budgetExceeded) {

package/dist/tools/repo-scanner.d.ts

@@ -1,3 +1,19 @@
+/**
+ * @module repo-scanner
+ * @packageBoundary @qulib/core (candidate: @qulib/analyzer)
+ *
+ * This module performs static analysis of a repository's file structure.
+ * It is currently embedded in @qulib/core because repo scanning is part of
+ * the observe phase and @qulib/core is the only consumer.
+ *
+ * Extraction to @qulib/analyzer is appropriate when:
+ *   1. A consumer needs repo analysis without URL crawling
+ *   2. The module grows to include PRD/Jira/Confluence ingestion
+ *   3. A standalone CLI command `qulib analyze-repo` is needed
+ *
+ * Before extraction: ensure RepoAnalysis schema is re-exported from @qulib/analyzer
+ * and @qulib/core depends on @qulib/analyzer (not the reverse).
+ */
 import { type RepoAnalysis } from '../schemas/repo-analysis.schema.js';
 export declare function scanRepo(repoPath: string): Promise<RepoAnalysis>;
 //# sourceMappingURL=repo-scanner.d.ts.map

package/dist/tools/repo-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-scanner.d.ts","sourceRoot":"","sources":["../../src/tools/repo-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAiC3F,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA4HtE"}
+{"version":3,"file":"repo-scanner.d.ts","sourceRoot":"","sources":["../../src/tools/repo-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAmC3F,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyItE"}

package/dist/tools/repo-scanner.js

@@ -1,7 +1,25 @@
+/**
+ * @module repo-scanner
+ * @packageBoundary @qulib/core (candidate: @qulib/analyzer)
+ *
+ * This module performs static analysis of a repository's file structure.
+ * It is currently embedded in @qulib/core because repo scanning is part of
+ * the observe phase and @qulib/core is the only consumer.
+ *
+ * Extraction to @qulib/analyzer is appropriate when:
+ *   1. A consumer needs repo analysis without URL crawling
+ *   2. The module grows to include PRD/Jira/Confluence ingestion
+ *   3. A standalone CLI command `qulib analyze-repo` is needed
+ *
+ * Before extraction: ensure RepoAnalysis schema is re-exported from @qulib/analyzer
+ * and @qulib/core depends on @qulib/analyzer (not the reverse).
+ */
 import { readFile } from 'node:fs/promises';
 import { relative, basename } from 'node:path';
 import glob from 'fast-glob';
 import { RepoAnalysisSchema } from '../schemas/repo-analysis.schema.js';
+import { detectFramework } from './framework-detector.js';
+import { computeAutomationMaturity } from './automation-maturity.js';
 const IGNORE_PATTERNS = ['**/node_modules/**', '**/.next/**', '**/dist/**', '**/build/**'];
 function toPosix(path) {
     return path.split('\\').join('/');
@@ -127,7 +145,7 @@ export async function scanRepo(repoPath) {
             missingTestIds.push(rel);
         }
     }
-    return RepoAnalysisSchema.parse({
+    const base = {
         scannedAt: new Date().toISOString(),
         repoPath,
         routes,
@@ -143,5 +161,16 @@ export async function scanRepo(repoPath) {
             existingE2eFiles,
             existingComponentFiles,
         },
-    });
+    };
+    let parsed = RepoAnalysisSchema.parse(base);
+    try {
+        const framework = await detectFramework(repoPath);
+        parsed = RepoAnalysisSchema.parse({ ...parsed, framework });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.warn(`[qulib] framework detection failed for ${repoPath}: ${msg}`);
+    }
+    const automationMaturity = computeAutomationMaturity(parsed);
+    return RepoAnalysisSchema.parse({ ...parsed, automationMaturity });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qulib/core",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Qulib — analyze deployed web apps for honest quality gaps (CLI + programmatic API)",
   "license": "MIT",
   "author": "Tapesh Nagarwal",
@@ -13,6 +13,16 @@
   "bugs": {
     "url": "https://github.com/TapeshN/qulib/issues"
   },
+  "keywords": [
+    "qa",
+    "quality",
+    "accessibility",
+    "gap-analysis",
+    "release-confidence",
+    "playwright",
+    "mcp",
+    "ai"
+  ],
   "publishConfig": {
     "access": "public"
   },