@qulib/core 0.4.1 → 0.4.3

package/dist/tools/repo/detect-framework.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module tools/repo/detect-framework
+ * @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=detect-framework.d.ts.map

package/dist/tools/repo/detect-framework.d.ts.map

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

package/dist/tools/repo/detect-framework.js

@@ -0,0 +1,153 @@
+/**
+ * @module tools/repo/detect-framework
+ * @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/repo/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/repo/framework-detector.d.ts.map

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

package/dist/tools/repo/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/repo/scan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module tools/repo/scan
+ * @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=scan.d.ts.map

package/dist/tools/repo/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/tools/repo/scan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAmC9F,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA8ItE"}

package/dist/tools/repo/scan.js

@@ -0,0 +1,181 @@
+/**
+ * @module tools/repo/scan
+ * @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 './detect-framework.js';
+import { computeAutomationMaturity } from '../scoring/automation-maturity.js';
+const IGNORE_PATTERNS = ['**/node_modules/**', '**/.next/**', '**/dist/**', '**/build/**'];
+function toPosix(path) {
+    return path.split('\\').join('/');
+}
+function normalizeRoutePath(path) {
+    const normalized = `/${path}`.replace(/\/+/g, '/').replace(/\/$/, '');
+    return normalized === '' ? '/' : normalized;
+}
+function detectTestType(filePath, content) {
+    const normalizedPath = toPosix(filePath);
+    if (normalizedPath.includes('cypress/e2e'))
+        return 'cypress-e2e';
+    if (normalizedPath.includes('cypress/component'))
+        return 'cypress-component';
+    if ((normalizedPath.includes('playwright') || normalizedPath.includes('e2e')) &&
+        normalizedPath.endsWith('.spec.ts')) {
+        return 'playwright';
+    }
+    if (/\bfrom\s+['"]vitest['"]|\brequire\(['"]vitest['"]\)/.test(content))
+        return 'vitest';
+    if (/\bfrom\s+['"]jest['"]|\brequire\(['"]jest['"]\)/.test(content))
+        return 'jest';
+    return 'other';
+}
+function extractCoveredPaths(content) {
+    const matches = [...content.matchAll(/['"`](\/[a-zA-Z0-9\/_\-\[\]]+)['"`]/g)].map((m) => m[1]);
+    return [...new Set(matches)];
+}
+export async function scanRepo(repoPath) {
+    const routes = [];
+    const appRouterFiles = await glob(['app/**/page.tsx', 'app/**/page.ts'], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: true,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const file of appRouterFiles) {
+        const rel = toPosix(relative(repoPath, file));
+        const routeSegment = rel.replace(/^app\//, '').replace(/\/page\.tsx?$/, '');
+        const routePath = normalizeRoutePath(routeSegment);
+        routes.push({ path: routePath, file: rel, method: 'GET' });
+    }
+    const pagesRouterFiles = await glob(['pages/**/*.tsx', 'pages/**/*.ts'], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: true,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const file of pagesRouterFiles) {
+        const rel = toPosix(relative(repoPath, file));
+        const name = basename(rel);
+        if (name.startsWith('_'))
+            continue;
+        const routeSegment = rel.replace(/^pages\//, '').replace(/\.tsx?$/, '');
+        const routePath = routeSegment === 'index'
+            ? '/'
+            : normalizeRoutePath(routeSegment.replace(/\/index$/, ''));
+        routes.push({ path: routePath, file: rel, method: 'GET' });
+    }
+    const expressFiles = await glob(['src/**/*.ts', 'src/**/*.js'], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: true,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const file of expressFiles) {
+        const rel = toPosix(relative(repoPath, file));
+        const content = await readFile(file, 'utf8');
+        const routeRegex = /router\.(get|post|put|delete|patch)\s*\(\s*['"`]([^'"`]+)/gi;
+        for (const match of content.matchAll(routeRegex)) {
+            const method = match[1]?.toUpperCase();
+            const routePath = normalizeRoutePath(match[2] ?? '/');
+            routes.push({ path: routePath, file: rel, method });
+        }
+    }
+    const testFilePaths = await glob([
+        '**/*.spec.ts',
+        '**/*.test.ts',
+        '**/*.spec.tsx',
+        '**/*.test.tsx',
+        '**/cypress/e2e/**/*.ts',
+        '**/cypress/e2e/**/*.cy.ts',
+    ], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: true,
+        ignore: IGNORE_PATTERNS,
+    });
+    const testFiles = [];
+    for (const file of [...new Set(testFilePaths)]) {
+        const rel = toPosix(relative(repoPath, file));
+        const content = await readFile(file, 'utf8');
+        testFiles.push({
+            file: rel,
+            type: detectTestType(rel, content),
+            coveredPaths: extractCoveredPaths(content),
+        });
+    }
+    const cypressRoot = await glob(['cypress'], { cwd: repoPath, onlyDirectories: true, absolute: false, deep: 1 });
+    const e2eFolder = await glob(['cypress/e2e'], { cwd: repoPath, onlyDirectories: true, absolute: false, deep: 1 });
+    const componentFolder = await glob(['cypress/component'], { cwd: repoPath, onlyDirectories: true, absolute: false, deep: 1 });
+    const fixturesFolder = await glob(['cypress/fixtures'], { cwd: repoPath, onlyDirectories: true, absolute: false, deep: 1 });
+    const supportFolder = await glob(['cypress/support'], { cwd: repoPath, onlyDirectories: true, absolute: false, deep: 1 });
+    const commandsFile = await glob(['cypress/support/commands.ts'], { cwd: repoPath, onlyFiles: true, absolute: false });
+    const existingE2eFiles = await glob(['cypress/e2e/**/*.cy.ts'], { cwd: repoPath, onlyFiles: true, absolute: false });
+    const existingComponentFiles = await glob(['cypress/component/**/*.cy.tsx'], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: false,
+    });
+    const tsxFiles = await glob(['**/*.tsx'], {
+        cwd: repoPath,
+        onlyFiles: true,
+        absolute: true,
+        ignore: [...IGNORE_PATTERNS, '**/*.spec.tsx'],
+    });
+    const missingTestIds = [];
+    let interactiveTsxFilesScanned = 0;
+    for (const file of tsxFiles) {
+        const rel = toPosix(relative(repoPath, file));
+        const content = await readFile(file, 'utf8');
+        const hasInteractive = content.includes('<button') || content.includes('<input') || content.includes('<a ');
+        if (hasInteractive) {
+            interactiveTsxFilesScanned += 1;
+            if (!content.includes('data-testid')) {
+                missingTestIds.push(rel);
+            }
+        }
+    }
+    const base = {
+        scannedAt: new Date().toISOString(),
+        repoPath,
+        routes,
+        testFiles,
+        missingTestIds: [...new Set(missingTestIds)],
+        interactiveTsxFilesScanned,
+        cypressStructure: {
+            detected: cypressRoot.length > 0,
+            e2eFolder: e2eFolder[0],
+            componentFolder: componentFolder[0],
+            fixturesFolder: fixturesFolder[0],
+            supportFolder: supportFolder[0],
+            hasCommandsFile: commandsFile.length > 0,
+            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/dist/tools/repo/scanner.d.ts

@@ -0,0 +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=scanner.d.ts.map

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

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