@qulib/core 0.5.2 → 0.5.3

package/dist/tools/automation-maturity.js

@@ -1,219 +0,0 @@
-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 missingIds = repo.missingTestIds.length;
-    const interactiveTsxScanned = repo.interactiveTsxFilesScanned ?? missingIds;
-    let hygieneScore = 0;
-    let hygieneApplicability = 'applicable';
-    let hygieneReason;
-    const hygieneEvidence = [];
-    if (interactiveTsxScanned === 0) {
-        hygieneApplicability = 'unknown';
-        hygieneReason = 'No interactive TSX files scanned — cannot compute a missing-id ratio honestly.';
-        hygieneEvidence.push(hygieneReason);
-    }
-    else {
-        const missingRatio = missingIds / interactiveTsxScanned;
-        hygieneScore = Math.round(Math.max(0, 100 * (1 - missingRatio)));
-        hygieneEvidence.push(`${missingIds}/${interactiveTsxScanned} interactive TSX file(s) lacked data-testid (heuristic scan).`);
-    }
-    const hygieneDim = {
-        dimension: 'test-id-hygiene',
-        score: hygieneScore,
-        weight: W_TEST_ID,
-        evidence: hygieneEvidence,
-        recommendations: hygieneApplicability === 'applicable' && hygieneScore < 85
-            ? ['Add stable data-testid (or role-based selectors) on interactive components used in tests.']
-            : [],
-        applicability: hygieneApplicability,
-        ...(hygieneReason && { reason: hygieneReason }),
-    };
-    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 authRouteFileRe = /(login|auth|signin)/i;
-    const authCovered = repo.testFiles.some((tf) => tf.coveredPaths.some((c) => authRe.test(c)));
-    const repoHasAuthRoute = repo.routes.some((r) => authRe.test(r.path));
-    const repoHasAuthTestFile = repo.testFiles.some((tf) => authRouteFileRe.test(tf.file));
-    const repoHasAnyAuthSignal = repoHasAuthRoute || repoHasAuthTestFile || authCovered;
-    let authScore = 0;
-    let authApplicability = 'applicable';
-    let authReason;
-    const authEvidence = [];
-    if (!repoHasAnyAuthSignal) {
-        authApplicability = 'not_applicable';
-        authReason = 'No auth routes, auth-named test files, or auth path coverage detected — repo appears auth-free.';
-        authEvidence.push(authReason);
-    }
-    else {
-        authScore = authCovered ? 90 : 25;
-        authEvidence.push(authCovered
-            ? 'At least one test references /login, /auth, or /signin in coveredPaths.'
-            : 'Repo has auth-shaped routes or test files but no auth-route coverage in extracted test path strings.');
-    }
-    const authDim = {
-        dimension: 'auth-test-coverage',
-        score: authScore,
-        weight: W_AUTH_TESTS,
-        evidence: authEvidence,
-        recommendations: authApplicability === 'applicable' && !authCovered
-            ? ['Add focused tests for sign-in and post-auth landing behavior.']
-            : [],
-        applicability: authApplicability,
-        ...(authReason && { reason: authReason }),
-    };
-    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;
-    let compRatioScore = 0;
-    let compApplicability = 'applicable';
-    let compReason;
-    const compEvidence = [];
-    if (cypressTotal === 0) {
-        compApplicability = 'not_applicable';
-        compReason = 'No Cypress (e2e or component) tests detected — component-test-ratio does not apply.';
-        compEvidence.push(compReason);
-    }
-    else {
-        compRatioScore = Math.round((100 * cypressComp) / cypressTotal);
-        compEvidence.push(`Cypress e2e files (matched): ${cypressE2e}, component: ${cypressComp}.`);
-    }
-    const compDim = {
-        dimension: 'component-test-ratio',
-        score: compRatioScore,
-        weight: W_COMPONENT_RATIO,
-        evidence: compEvidence,
-        recommendations: compApplicability === 'applicable' && cypressComp > 0
-            ? ['Balance component vs E2E Cypress tests so critical flows stay fast in CI.']
-            : [],
-        applicability: compApplicability,
-        ...(compReason && { reason: compReason }),
-    };
-    const dimensions = [breadthDim, frameworkDim, hygieneDim, ciDim, authDim, compDim];
-    // Overall score normalizes over applicable dimensions only.
-    // overallScore = round( Σ score_i * weight_i / Σ weight_i ) for i ∈ applicable.
-    // If no dimension is applicable (degenerate repo), overall = 0 and level = L1.
-    const applicableDims = dimensions.filter((d) => (d.applicability ?? 'applicable') === 'applicable');
-    const weightSum = applicableDims.reduce((s, d) => s + d.weight, 0);
-    const overallScore = weightSum > 0
-        ? Math.round(applicableDims.reduce((s, d) => s + d.score * d.weight, 0) / weightSum)
-        : 0;
-    const { level, label } = scoreLevel(overallScore);
-    const topRecommendations = [...applicableDims]
-        .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,
-        scoreFormula: 'overallScore = round( Σ (score * weight) / Σ weight ) for applicable dimensions only. not_applicable and unknown dimensions are excluded from the denominator.',
-    });
-}

package/dist/tools/browser.d.ts

@@ -1,3 +0,0 @@
-import { type Browser } from '@playwright/test';
-export declare function launchBrowser(): Promise<Browser>;
-//# sourceMappingURL=browser.d.ts.map

package/dist/tools/browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/tools/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE1D,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAYtD"}

package/dist/tools/browser.js

@@ -1,13 +0,0 @@
-import { chromium } from '@playwright/test';
-export async function launchBrowser() {
-    try {
-        return await chromium.launch({ headless: true });
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        if (message.includes("Executable doesn't exist") || message.includes('chromium')) {
-            throw new Error(`Playwright Chromium browser is not installed. Run:\n\n  npx playwright install chromium\n\nThen retry your qulib command. This is a one-time setup step.`);
-        }
-        throw err;
-    }
-}

package/dist/tools/cypress-explorer.d.ts

@@ -1,8 +0,0 @@
-import type { AppExplorer } from './explorer.interface.js';
-import type { HarnessConfig } from '../schemas/config.schema.js';
-import type { RouteInventory } from '../schemas/route-inventory.schema.js';
-import type { RunArtifactsOptions } from '../harness/run-options.js';
-export declare class CypressExplorer implements AppExplorer {
-    explore(_baseUrl: string, _config: HarnessConfig, _artifacts?: RunArtifactsOptions): Promise<RouteInventory>;
-}
-//# sourceMappingURL=cypress-explorer.d.ts.map

package/dist/tools/cypress-explorer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cypress-explorer.d.ts","sourceRoot":"","sources":["../../src/tools/cypress-explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,qBAAa,eAAgB,YAAW,WAAW;IAC3C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;CAGnH"}

package/dist/tools/cypress-explorer.js

@@ -1,5 +0,0 @@
-export class CypressExplorer {
-    async explore(_baseUrl, _config, _artifacts) {
-        throw new Error('Not implemented');
-    }
-}

package/dist/tools/explorer-factory.d.ts

@@ -1,4 +0,0 @@
-import type { ExplorerType } from '../schemas/config.schema.js';
-import type { AppExplorer } from './explorer.interface.js';
-export declare function createExplorer(type: ExplorerType): AppExplorer;
-//# sourceMappingURL=explorer-factory.d.ts.map

package/dist/tools/explorer-factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explorer-factory.d.ts","sourceRoot":"","sources":["../../src/tools/explorer-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAS9D"}

package/dist/tools/explorer-factory.js

@@ -1,12 +0,0 @@
-import { PlaywrightExplorer } from './playwright-explorer.js';
-import { CypressExplorer } from './cypress-explorer.js';
-export function createExplorer(type) {
-    switch (type) {
-        case 'playwright':
-            return new PlaywrightExplorer();
-        case 'cypress':
-            return new CypressExplorer();
-        default:
-            throw new Error(`Unknown explorer type: ${type}`);
-    }
-}

package/dist/tools/explorer.interface.d.ts

@@ -1,7 +0,0 @@
-import type { HarnessConfig } from '../schemas/config.schema.js';
-import type { RouteInventory } from '../schemas/route-inventory.schema.js';
-import type { RunArtifactsOptions } from '../harness/run-options.js';
-export interface AppExplorer {
-    explore(baseUrl: string, config: HarnessConfig, artifacts?: RunArtifactsOptions): Promise<RouteInventory>;
-}
-//# sourceMappingURL=explorer.interface.d.ts.map

package/dist/tools/explorer.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explorer.interface.d.ts","sourceRoot":"","sources":["../../src/tools/explorer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3G"}

package/dist/tools/explorer.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/tools/explorers/cypress-explorer.d.ts

@@ -1,8 +0,0 @@
-import type { AppExplorer } from './explorer.interface.js';
-import type { HarnessConfig } from '../../schemas/config.schema.js';
-import type { RouteInventory } from '../../schemas/route-inventory.schema.js';
-import type { RunArtifactsOptions } from '../../harness/run-options.js';
-export declare class CypressExplorer implements AppExplorer {
-    explore(_baseUrl: string, _config: HarnessConfig, _artifacts?: RunArtifactsOptions): Promise<RouteInventory>;
-}
-//# sourceMappingURL=cypress-explorer.d.ts.map

package/dist/tools/explorers/cypress-explorer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cypress-explorer.d.ts","sourceRoot":"","sources":["../../../src/tools/explorers/cypress-explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,qBAAa,eAAgB,YAAW,WAAW;IAC3C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;CAGnH"}

package/dist/tools/explorers/cypress-explorer.js

@@ -1,5 +0,0 @@
-export class CypressExplorer {
-    async explore(_baseUrl, _config, _artifacts) {
-        throw new Error('Not implemented');
-    }
-}

package/dist/tools/explorers/explorer.interface.d.ts

@@ -1,7 +0,0 @@
-import type { HarnessConfig } from '../../schemas/config.schema.js';
-import type { RouteInventory } from '../../schemas/route-inventory.schema.js';
-import type { RunArtifactsOptions } from '../../harness/run-options.js';
-export interface AppExplorer {
-    explore(baseUrl: string, config: HarnessConfig, artifacts?: RunArtifactsOptions): Promise<RouteInventory>;
-}
-//# sourceMappingURL=explorer.interface.d.ts.map

package/dist/tools/explorers/explorer.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explorer.interface.d.ts","sourceRoot":"","sources":["../../../src/tools/explorers/explorer.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC3G"}

package/dist/tools/explorers/explorer.interface.js

@@ -1 +0,0 @@
-export {};

package/dist/tools/explorers/playwright-explorer.d.ts

@@ -1,8 +0,0 @@
-import type { AppExplorer } from './explorer.interface.js';
-import { type RouteInventory } from '../../schemas/route-inventory.schema.js';
-import type { HarnessConfig } from '../../schemas/config.schema.js';
-import type { RunArtifactsOptions } from '../../harness/run-options.js';
-export declare class PlaywrightExplorer implements AppExplorer {
-    explore(baseUrl: string, config: HarnessConfig, artifacts?: RunArtifactsOptions): Promise<RouteInventory>;
-}
-//# sourceMappingURL=playwright-explorer.d.ts.map

package/dist/tools/explorers/playwright-explorer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"playwright-explorer.d.ts","sourceRoot":"","sources":["../../../src/tools/explorers/playwright-explorer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAwB,KAAK,cAAc,EAAc,MAAM,yCAAyC,CAAC;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAoBxE,qBAAa,kBAAmB,YAAW,WAAW;IAC9C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC;CAsKhH"}

package/dist/tools/explorers/playwright-explorer.js

@@ -1,172 +0,0 @@
-import { launchBrowser } from './browser.js';
-import { AxeBuilder } from '@axe-core/playwright';
-import { createAuthenticatedContext } from '../auth/apply.js';
-import { RouteInventorySchema } from '../../schemas/route-inventory.schema.js';
-function crawlHostKey(hostname) {
-    return hostname.replace(/^www\./i, '').toLowerCase();
-}
-function isInternalHref(href, baseUrlStr) {
-    try {
-        const u = new URL(href);
-        const base = new URL(baseUrlStr);
-        return u.protocol === base.protocol && crawlHostKey(u.hostname) === crawlHostKey(base.hostname);
-    }
-    catch {
-        return false;
-    }
-}
-function debugMode() {
-    return process.env.QULIB_DEBUG === '1';
-}
-export class PlaywrightExplorer {
-    async explore(baseUrl, config, artifacts) {
-        const progress = artifacts?.progressLog;
-        const browser = await launchBrowser();
-        let context;
-        try {
-            context = await createAuthenticatedContext(browser, config.auth, config.timeoutMs);
-        }
-        catch (err) {
-            await browser.close();
-            throw new Error(`Authentication failed: ${String(err)}. Check your auth config and credentials.`);
-        }
-        if (config.auth) {
-            const label = config.auth.type === 'form-login' ? config.auth.credentials.username : 'storage-state';
-            progress?.info(`Authenticated context: ${label}`);
-            if (!progress) {
-                process.stderr.write(`[qulib] authenticated as ${label}\n`);
-            }
-        }
-        const visited = new Set();
-        const queue = [baseUrl];
-        const routes = [];
-        let budgetExceeded = false;
-        try {
-            while (queue.length > 0) {
-                if (visited.size >= config.maxPagesToScan) {
-                    budgetExceeded = queue.length > 0;
-                    break;
-                }
-                const url = queue.shift();
-                if (!url) {
-                    continue;
-                }
-                const normalized = url.split('?')[0].split('#')[0];
-                if (visited.has(normalized))
-                    continue;
-                visited.add(normalized);
-                const page = await context.newPage();
-                const consoleErrors = [];
-                page.on('console', (msg) => {
-                    if (msg.type() === 'error') {
-                        consoleErrors.push(msg.text());
-                    }
-                });
-                try {
-                    const navResponse = await page.goto(url, {
-                        timeout: config.timeoutMs,
-                        waitUntil: 'domcontentloaded',
-                    });
-                    const httpStatus = navResponse?.status() ?? 0;
-                    if (debugMode()) {
-                        const html = await page.content();
-                        progress?.debug(`page HTML byteLength=${Buffer.byteLength(html, 'utf8')} url=${normalized}`);
-                    }
-                    const pageTitle = await page.title();
-                    const formCount = await page.locator('form').count();
-                    const buttonLabels = await page.locator('button').allInnerTexts();
-                    const hrefs = await page.evaluate(() => Array.from(document.querySelectorAll('a[href]'))
-                        .map((a) => a.href)
-                        .filter(Boolean));
-                    const internalLinks = hrefs
-                        .filter((href) => isInternalHref(href, baseUrl))
-                        .map((href) => href.split('?')[0].split('#')[0]);
-                    const uniqueInternal = [...new Set(internalLinks)];
-                    for (const link of uniqueInternal) {
-                        if (!visited.has(link) && !queue.includes(link)) {
-                            queue.push(link);
-                        }
-                    }
-                    const brokenLinks = [];
-                    for (const link of uniqueInternal.slice(0, 20)) {
-                        try {
-                            const response = await page.request.head(link, { timeout: 5000 });
-                            if (response.status() >= 400) {
-                                brokenLinks.push({ url: link, status: response.status() });
-                            }
-                        }
-                        catch (err) {
-                            brokenLinks.push({ url: link, status: null, reason: String(err) });
-                        }
-                    }
-                    let a11yViolations = [];
-                    try {
-                        const axeResults = await new AxeBuilder({ page })
-                            .withTags(['wcag2a', 'wcag2aa'])
-                            .analyze();
-                        if (debugMode()) {
-                            progress?.debug(`raw axe violations (pre-map) count=${axeResults.violations.length} json=${JSON.stringify(axeResults.violations)}`);
-                        }
-                        a11yViolations = axeResults.violations.map((v) => ({
-                            id: v.id,
-                            impact: v.impact ?? 'unknown',
-                            helpUrl: v.helpUrl,
-                            nodeCount: v.nodes.length,
-                        }));
-                    }
-                    catch (err) {
-                        consoleErrors.push(`axe-core failure: ${String(err)}`);
-                    }
-                    const path = new URL(url).pathname || '/';
-                    progress?.info(`Crawled ${normalized} status=${httpStatus} a11yViolations=${a11yViolations.length}`);
-                    routes.push({
-                        path,
-                        pageTitle,
-                        links: uniqueInternal,
-                        formCount,
-                        buttonLabels: buttonLabels.map((b) => b.trim()).filter(Boolean),
-                        consoleErrors,
-                        brokenLinks,
-                        a11yViolations,
-                        statusCode: httpStatus,
-                    });
-                }
-                catch (err) {
-                    const path = (() => {
-                        try {
-                            return new URL(url).pathname || '/';
-                        }
-                        catch {
-                            return url;
-                        }
-                    })();
-                    progress?.info(`Crawled ${normalized} status=error a11yViolations=0 err=${String(err).slice(0, 120)}`);
-                    routes.push({
-                        path,
-                        pageTitle: '',
-                        links: [],
-                        formCount: 0,
-                        buttonLabels: [],
-                        consoleErrors: [`Navigation error: ${String(err)}`],
-                        brokenLinks: [],
-                        a11yViolations: [],
-                    });
-                }
-                finally {
-                    await page.close();
-                }
-            }
-        }
-        finally {
-            await context.close();
-            await browser.close();
-        }
-        return RouteInventorySchema.parse({
-            scannedAt: new Date().toISOString(),
-            baseUrl,
-            routes,
-            pagesSkipped: budgetExceeded ? queue.length : 0,
-            budgetExceeded,
-        });
-    }
-}

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

@@ -1,15 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}