@ash-technologia/fathom 0.1.0

package/dist/analyzers/architecture/graph.d.ts

@@ -0,0 +1,29 @@
+import type { ArchitectureGraph, ArchitectureLayer, ArchitectureRole, ArchitectureWarning, ArchitectureSummary } from './types.js';
+export interface FileData {
+    relativePath: string;
+    lineCount: number;
+    isTest: boolean;
+    imports: string[];
+    externalImports: string[];
+}
+/**
+ * Classifies a relative path into an architectural layer.
+ */
+export declare function classifyLayer(relativePath: string, isTest: boolean): ArchitectureLayer;
+/**
+ * Classifies a file into a functional role.
+ */
+export declare function classifyRole(relativePath: string): ArchitectureRole;
+/**
+ * Tarjan's algorithm for finding Strongly Connected Components (cycles) in a directed graph.
+ */
+export declare function findCircularDependencies(adjacency: Map<string, Set<string>>): string[][];
+/**
+ * Builds the in-memory architecture graph and analyzes patterns, cycles, and boundary violations.
+ */
+export declare function buildArchitectureModel(fileDataList: FileData[]): {
+    graph: ArchitectureGraph;
+    summary: ArchitectureSummary;
+    warnings: ArchitectureWarning[];
+};
+//# sourceMappingURL=graph.d.ts.map

package/dist/analyzers/architecture/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/analyzers/architecture/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAGjB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,iBAAiB,CA2EtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAuBnE;AA0BD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,EAAE,CAyDxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,QAAQ,EAAE,GAAG;IAChE,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,CA6LA"}

package/dist/analyzers/architecture/graph.js

@@ -0,0 +1,347 @@
+/**
+ * Classifies a relative path into an architectural layer.
+ */
+export function classifyLayer(relativePath, isTest) {
+    if (isTest)
+        return 'test';
+    const lower = relativePath.toLowerCase();
+    const segments = lower.split('/');
+    // Config files at root
+    if (segments.length === 1 &&
+        (lower.endsWith('.json') ||
+            lower.includes('.config.') ||
+            lower.endsWith('.rc') ||
+            lower.endsWith('.lock'))) {
+        return 'config';
+    }
+    // Explicit frontend patterns
+    if (lower.startsWith('frontend/') ||
+        lower.startsWith('client/') ||
+        lower.startsWith('web/') ||
+        lower.startsWith('ui/') ||
+        segments.includes('frontend') ||
+        segments.includes('client') ||
+        segments.includes('ui') ||
+        segments.includes('components') ||
+        segments.includes('pages') ||
+        segments.includes('views') ||
+        segments.includes('hooks') ||
+        segments.includes('styles') ||
+        lower.endsWith('.tsx') ||
+        lower.endsWith('.jsx') ||
+        lower.endsWith('.vue') ||
+        lower.endsWith('.svelte')) {
+        return 'frontend';
+    }
+    // Explicit backend patterns
+    if (lower.startsWith('backend/') ||
+        lower.startsWith('server/') ||
+        lower.startsWith('api/') ||
+        segments.includes('backend') ||
+        segments.includes('server') ||
+        segments.includes('api') ||
+        segments.includes('controllers') ||
+        segments.includes('routes') ||
+        segments.includes('services') ||
+        segments.includes('models') ||
+        segments.includes('repositories') ||
+        segments.includes('entities') ||
+        segments.includes('db') ||
+        segments.includes('database') ||
+        segments.includes('migrations')) {
+        return 'backend';
+    }
+    // Shared / Common patterns
+    if (lower.startsWith('shared/') ||
+        lower.startsWith('common/') ||
+        segments.includes('shared') ||
+        segments.includes('common') ||
+        segments.includes('utils') ||
+        segments.includes('helpers') ||
+        segments.includes('types') ||
+        segments.includes('lib')) {
+        return 'shared';
+    }
+    return 'unknown';
+}
+/**
+ * Classifies a file into a functional role.
+ */
+export function classifyRole(relativePath) {
+    const lower = relativePath.toLowerCase();
+    const segments = lower.split('/');
+    const filename = segments[segments.length - 1] ?? '';
+    if (/^(index|main|app|server|cli)\.[a-z0-9]+$/i.test(filename))
+        return 'entry';
+    if (segments.includes('components') ||
+        lower.endsWith('.component.ts') ||
+        lower.endsWith('.tsx') ||
+        lower.endsWith('.jsx'))
+        return 'component';
+    if (segments.includes('pages') || segments.includes('views') || filename.startsWith('page.'))
+        return 'page';
+    if (segments.includes('routes') || filename.startsWith('route.'))
+        return 'route';
+    if (segments.includes('controllers') || lower.endsWith('.controller.ts'))
+        return 'controller';
+    if (segments.includes('services') || lower.endsWith('.service.ts'))
+        return 'service';
+    if (segments.includes('models') || segments.includes('entities') || lower.endsWith('.model.ts'))
+        return 'model';
+    if (segments.includes('utils') || segments.includes('helpers'))
+        return 'util';
+    return 'unknown';
+}
+/**
+ * Checks if a file is an expected entry point that legitimately has no inbound imports.
+ */
+function isExpectedEntryPoint(relativePath) {
+    const lower = relativePath.toLowerCase();
+    const segments = lower.split('/');
+    const filename = segments[segments.length - 1] ?? '';
+    if (/^(index|main|app|server|cli|worker|run)\.[a-z0-9]+$/i.test(filename))
+        return true;
+    if (/^vite\.config|^webpack\.config|^rollup\.config|^jest\.config|^vitest\.config|^next\.config/i.test(filename))
+        return true;
+    if (/^(page|layout|route|loading|error|not-found)\.[a-z0-9]+$/i.test(filename))
+        return true; // Next.js
+    if (filename.startsWith('+page') || filename.startsWith('+layout'))
+        return true; // SvelteKit
+    if (lower.startsWith('scripts/') || lower.startsWith('bin/'))
+        return true;
+    if (lower.includes('__tests__') || lower.includes('/tests/') || lower.includes('/test/'))
+        return true;
+    return false;
+}
+/**
+ * Tarjan's algorithm for finding Strongly Connected Components (cycles) in a directed graph.
+ */
+export function findCircularDependencies(adjacency) {
+    let index = 0;
+    const indices = new Map();
+    const lowlink = new Map();
+    const onStack = new Set();
+    const stack = [];
+    const sccs = [];
+    function strongconnect(node) {
+        indices.set(node, index);
+        lowlink.set(node, index);
+        index++;
+        stack.push(node);
+        onStack.add(node);
+        const neighbors = adjacency.get(node) ?? new Set();
+        for (const neighbor of neighbors) {
+            if (!indices.has(neighbor)) {
+                strongconnect(neighbor);
+                const nodeLow = lowlink.get(node) ?? 0;
+                const neighborLow = lowlink.get(neighbor) ?? 0;
+                lowlink.set(node, Math.min(nodeLow, neighborLow));
+            }
+            else if (onStack.has(neighbor)) {
+                const nodeLow = lowlink.get(node) ?? 0;
+                const neighborIndex = indices.get(neighbor) ?? 0;
+                lowlink.set(node, Math.min(nodeLow, neighborIndex));
+            }
+        }
+        if (lowlink.get(node) === indices.get(node)) {
+            const scc = [];
+            let w;
+            do {
+                w = stack.pop();
+                if (w !== undefined) {
+                    onStack.delete(w);
+                    scc.push(w);
+                }
+            } while (w !== undefined && w !== node);
+            // Only SCCs with size > 1 (or self-loops) are circular cycles
+            if (scc.length > 1) {
+                sccs.push(scc);
+            }
+            else if (scc.length === 1 && scc[0] && (adjacency.get(scc[0]) ?? new Set()).has(scc[0])) {
+                sccs.push(scc);
+            }
+        }
+    }
+    for (const node of adjacency.keys()) {
+        if (!indices.has(node)) {
+            strongconnect(node);
+        }
+    }
+    // Sort cycles deterministically
+    return sccs.map((c) => [...c].sort()).sort((a, b) => (a[0] ?? '').localeCompare(b[0] ?? ''));
+}
+/**
+ * Builds the in-memory architecture graph and analyzes patterns, cycles, and boundary violations.
+ */
+export function buildArchitectureModel(fileDataList) {
+    const nodes = new Map();
+    const edges = [];
+    const adjacency = new Map();
+    const reverseAdjacency = new Map();
+    // 1. Initialize nodes
+    for (const f of fileDataList) {
+        const layer = classifyLayer(f.relativePath, f.isTest);
+        const role = classifyRole(f.relativePath);
+        nodes.set(f.relativePath, {
+            id: f.relativePath,
+            type: 'file',
+            layer,
+            role,
+            lineCount: f.lineCount,
+            inDegree: 0,
+            outDegree: 0,
+        });
+        adjacency.set(f.relativePath, new Set());
+        reverseAdjacency.set(f.relativePath, new Set());
+    }
+    // 2. Build edges
+    for (const f of fileDataList) {
+        for (const target of f.imports) {
+            if (nodes.has(target)) {
+                edges.push({
+                    source: f.relativePath,
+                    target,
+                    type: 'import',
+                });
+                const sourceAdj = adjacency.get(f.relativePath);
+                if (sourceAdj)
+                    sourceAdj.add(target);
+                const targetRev = reverseAdjacency.get(target);
+                if (targetRev)
+                    targetRev.add(f.relativePath);
+            }
+        }
+    }
+    // 3. Update inDegree & outDegree
+    for (const [id, node] of nodes) {
+        node.outDegree = adjacency.get(id)?.size ?? 0;
+        node.inDegree = reverseAdjacency.get(id)?.size ?? 0;
+    }
+    // 4. Detect Circular Dependencies
+    const cycles = findCircularDependencies(adjacency);
+    const warnings = [];
+    for (const cycle of cycles) {
+        warnings.push({
+            type: 'circular',
+            severity: 'high',
+            message: `Circular dependency candidate detected: ${cycle.join(' ⇄ ')}`,
+            files: cycle,
+        });
+    }
+    // 5. Detect Boundary Violations
+    const SERVER_ONLY_PACKAGES = new Set([
+        'fs',
+        'node:fs',
+        'child_process',
+        'node:child_process',
+        'cluster',
+        'net',
+        'dns',
+    ]);
+    for (const f of fileDataList) {
+        const sourceNode = nodes.get(f.relativePath);
+        if (!sourceNode)
+            continue;
+        // Boundary 1: Backend importing Frontend
+        if (sourceNode.layer === 'backend') {
+            for (const target of f.imports) {
+                const targetNode = nodes.get(target);
+                if (targetNode?.layer === 'frontend') {
+                    warnings.push({
+                        type: 'boundary',
+                        severity: 'high',
+                        message: `Architectural boundary violation: Backend module "${f.relativePath}" imports frontend module "${target}".`,
+                        files: [f.relativePath, target],
+                    });
+                }
+            }
+        }
+        // Boundary 2: Client code importing server-only packages
+        if (sourceNode.layer === 'frontend') {
+            for (const extPkg of f.externalImports) {
+                if (SERVER_ONLY_PACKAGES.has(extPkg)) {
+                    warnings.push({
+                        type: 'boundary',
+                        severity: 'high',
+                        message: `Architectural boundary violation: Client-side module "${f.relativePath}" imports server-only package "${extPkg}".`,
+                        files: [f.relativePath],
+                    });
+                }
+            }
+        }
+        // Boundary 3: Deep coupling (> 15 internal imports)
+        if (sourceNode.outDegree > 15 &&
+            !sourceNode.id.includes('index.') &&
+            sourceNode.layer !== 'test') {
+            warnings.push({
+                type: 'coupling',
+                severity: 'low',
+                message: `Deep coupling: "${f.relativePath}" has a high fan-out coupling, importing ${sourceNode.outDegree} distinct modules.`,
+                files: [f.relativePath],
+            });
+        }
+        // Boundary 4: Very large module (> 400 lines and outDegree > 8)
+        if (sourceNode.lineCount > 400 && sourceNode.outDegree > 8 && sourceNode.layer !== 'test') {
+            warnings.push({
+                type: 'large',
+                severity: 'low',
+                message: `Very large module: "${f.relativePath}" has ${sourceNode.lineCount} lines and imports ${sourceNode.outDegree} modules.`,
+                files: [f.relativePath],
+            });
+        }
+        // Boundary 5: Orphaned source file (inDegree == 0, not an entry point or test)
+        // Confident detection:
+        // 1) Explicit dead/orphan names: "dead-code.ts", "unused.ts", "orphan.ts", "abandoned.ts"
+        // 2) OR: nested modules in a project with >= 4 files where the file is neither an entry point,
+        //    nor a top-level root file (e.g. `src/math.ts` or `src/calc.ts` are root files directly under src)
+        const isExplicitDead = /dead|orphan|unused|abandoned/i.test(f.relativePath);
+        const isNestedSource = f.relativePath.split('/').length > 2;
+        const isOrphanCandidate = isExplicitDead || (fileDataList.length >= 4 && isNestedSource);
+        if (sourceNode.inDegree === 0 &&
+            sourceNode.layer !== 'test' &&
+            sourceNode.layer !== 'config' &&
+            !isExpectedEntryPoint(f.relativePath) &&
+            isOrphanCandidate) {
+            warnings.push({
+                type: 'orphan',
+                severity: 'info',
+                message: `Orphaned source file: "${f.relativePath}" is not imported by any module in the repository.`,
+                files: [f.relativePath],
+            });
+        }
+    }
+    // 6. Build layer summaries for reporting
+    const layerMap = new Map();
+    for (const [, node] of nodes) {
+        if (node.layer === 'test' || node.layer === 'config' || node.layer === 'unknown')
+            continue;
+        const layerName = node.layer.charAt(0).toUpperCase() + node.layer.slice(1);
+        let compMap = layerMap.get(layerName);
+        if (!compMap) {
+            compMap = new Map();
+            layerMap.set(layerName, compMap);
+        }
+        const roleKey = node.role !== 'unknown' ? `${node.role}s` : 'other';
+        compMap.set(roleKey, (compMap.get(roleKey) ?? 0) + 1);
+    }
+    const layers = [];
+    for (const [name, compMap] of layerMap) {
+        const components = [...compMap.entries()]
+            .map(([compName, fileCount]) => ({ name: compName, fileCount }))
+            .sort((a, b) => b.fileCount - a.fileCount);
+        layers.push({ name, components });
+    }
+    const summary = {
+        layers,
+        warnings,
+        nodeCount: nodes.size,
+        edgeCount: edges.length,
+        circularDependencies: cycles,
+    };
+    const graph = {
+        nodes: [...nodes.values()],
+        edges,
+    };
+    return { graph, summary, warnings };
+}
+//# sourceMappingURL=graph.js.map

package/dist/analyzers/architecture/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../../src/analyzers/architecture/graph.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/architecture/imports.d.ts

@@ -0,0 +1,24 @@
+export interface PathAliasConfig {
+    baseUrl: string;
+    paths: Record<string, string[]>;
+}
+export interface ExtractedImport {
+    specifier: string;
+    isRelative: boolean;
+    resolvedPath?: string | undefined;
+    isExternal: boolean;
+    packageName?: string | undefined;
+}
+/**
+ * Extracts tsconfig / jsconfig compilerOptions.paths and baseUrl if present.
+ */
+export declare function extractPathAliases(configContent?: string | null): PathAliasConfig | null;
+/**
+ * Parses import and export statements from source file text without executing code.
+ */
+export declare function extractRawSpecifiers(content: string, extension: string): string[];
+/**
+ * Resolves an import specifier to a known relative file in the repository if possible.
+ */
+export declare function resolveImportSpecifier(specifier: string, fromFile: string, knownFiles: Set<string>, aliasConfig?: PathAliasConfig | null): ExtractedImport;
+//# sourceMappingURL=imports.d.ts.map

package/dist/analyzers/architecture/imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../src/analyzers/architecture/imports.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAkBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAsBxF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA4CjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,WAAW,CAAC,EAAE,eAAe,GAAG,IAAI,GACnC,eAAe,CAyEjB"}

package/dist/analyzers/architecture/imports.js

@@ -0,0 +1,155 @@
+import path from 'node:path';
+import { normalizeSlashes } from '../../utils/paths.js';
+const JS_TS_EXTENSIONS = [
+    '',
+    '.ts',
+    '.tsx',
+    '.js',
+    '.jsx',
+    '.mjs',
+    '.cjs',
+    '/index.ts',
+    '/index.tsx',
+    '/index.js',
+    '/index.jsx',
+    '/index.mjs',
+    '/index.cjs',
+];
+/**
+ * Extracts tsconfig / jsconfig compilerOptions.paths and baseUrl if present.
+ */
+export function extractPathAliases(configContent) {
+    if (!configContent)
+        return null;
+    try {
+        // Strip single-line comments in json
+        const sanitized = configContent.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, '$1');
+        const parsed = JSON.parse(sanitized);
+        if (parsed.compilerOptions?.paths) {
+            return {
+                baseUrl: parsed.compilerOptions.baseUrl ?? '.',
+                paths: parsed.compilerOptions.paths,
+            };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Parses import and export statements from source file text without executing code.
+ */
+export function extractRawSpecifiers(content, extension) {
+    const specifiers = new Set();
+    if (['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs'].includes(extension.toLowerCase())) {
+        // 1. Static imports & re-exports: import/export ... from ['"]specifier['"]
+        const staticImportRegex = /(?:import|export)\s+(?:type\s+)?(?:[\s\w*${},]*\s+from\s+)?['"]([^'"]+)['"]/g;
+        let match;
+        while ((match = staticImportRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+        // 2. Bare imports: import ['"]specifier['"]
+        const bareImportRegex = /import\s+['"]([^'"]+)['"]/g;
+        while ((match = bareImportRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+        // 3. Dynamic imports: import(['"]specifier['"])
+        const dynamicImportRegex = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+        while ((match = dynamicImportRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+        // 4. CommonJS requires: require(['"]specifier['"])
+        const requireRegex = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+        while ((match = requireRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+    }
+    else if (['.py', '.pyw'].includes(extension.toLowerCase())) {
+        // Python imports: from foo import bar  or  import foo
+        const pyFromRegex = /^\s*from\s+([a-zA-Z0-9_.]+)\s+import/gm;
+        let match;
+        while ((match = pyFromRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+        const pyImportRegex = /^\s*import\s+([a-zA-Z0-9_.]+)/gm;
+        while ((match = pyImportRegex.exec(content)) !== null) {
+            if (match[1])
+                specifiers.add(match[1]);
+        }
+    }
+    return [...specifiers];
+}
+/**
+ * Resolves an import specifier to a known relative file in the repository if possible.
+ */
+export function resolveImportSpecifier(specifier, fromFile, knownFiles, aliasConfig) {
+    const isRelative = specifier.startsWith('./') ||
+        specifier.startsWith('../') ||
+        specifier === '.' ||
+        specifier === '..';
+    if (isRelative) {
+        const fromDir = path.dirname(fromFile);
+        const resolvedBase = normalizeSlashes(path.normalize(path.join(fromDir, specifier)));
+        const baseWithoutJs = resolvedBase.replace(/\.(js|mjs|cjs)$/, '');
+        for (const base of [resolvedBase, baseWithoutJs]) {
+            for (const ext of JS_TS_EXTENSIONS) {
+                let candidate = base + ext;
+                if (candidate.startsWith('./'))
+                    candidate = candidate.slice(2);
+                if (knownFiles.has(candidate)) {
+                    return {
+                        specifier,
+                        isRelative: true,
+                        resolvedPath: candidate,
+                        isExternal: false,
+                    };
+                }
+            }
+        }
+        return {
+            specifier,
+            isRelative: true,
+            isExternal: false,
+        };
+    }
+    // Check alias configuration (e.g. @/* -> src/*)
+    if (aliasConfig?.paths) {
+        for (const [aliasPattern, targetPatterns] of Object.entries(aliasConfig.paths)) {
+            const prefix = aliasPattern.replace(/\*$/, '');
+            if (specifier.startsWith(prefix)) {
+                const subPath = specifier.slice(prefix.length);
+                for (const target of targetPatterns) {
+                    const mappedPrefix = target.replace(/\*$/, '');
+                    const mappedTarget = normalizeSlashes(path.normalize(path.join(aliasConfig.baseUrl, mappedPrefix, subPath))).replace(/^\.\//, '');
+                    for (const ext of JS_TS_EXTENSIONS) {
+                        const candidate = mappedTarget + ext;
+                        if (knownFiles.has(candidate)) {
+                            return {
+                                specifier,
+                                isRelative: false,
+                                resolvedPath: candidate,
+                                isExternal: false,
+                            };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    // External package or standard library
+    const parts = specifier.split('/');
+    const packageName = specifier.startsWith('@') && parts.length > 1 ? `${parts[0]}/${parts[1]}` : parts[0];
+    return {
+        specifier,
+        isRelative: false,
+        isExternal: true,
+        packageName,
+    };
+}
+//# sourceMappingURL=imports.js.map

package/dist/analyzers/architecture/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.js","sourceRoot":"","sources":["../../../src/analyzers/architecture/imports.ts"],"names":[],"mappings":"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"}

package/dist/analyzers/architecture/index.d.ts

@@ -0,0 +1,13 @@
+import type { Analyzer } from '../../core/analyzer.js';
+import type { RepositoryContext } from '../../core/context.js';
+import type { AnalyzerResult } from '../../core/result.js';
+import type { ArchitectureSummary } from './types.js';
+export declare class ArchitectureAnalyzer implements Analyzer {
+    readonly id = "architecture";
+    readonly name = "Architecture";
+    readonly category: "architecture";
+    readonly description = "Analyzes repository layout, dependency graph, circular dependencies, and architectural boundary violations.";
+    analyze(context: RepositoryContext): Promise<AnalyzerResult>;
+}
+export type { ArchitectureSummary };
+//# sourceMappingURL=index.d.ts.map

package/dist/analyzers/architecture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyzers/architecture/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,sBAAsB,CAAC;AAOpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,QAAQ,CAAC,EAAE,kBAAkB;IAC7B,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,QAAQ,EAAG,cAAc,CAAU;IAC5C,QAAQ,CAAC,WAAW,iHAC4F;IAE1G,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CAoOnE;AAED,YAAY,EAAE,mBAAmB,EAAE,CAAC"}