@girardelli/architect 5.0.0 → 8.1.0

package/dist/scorer.js

@@ -1,229 +0,0 @@
-import { basename } from 'path';
-export class ArchitectureScorer {
-    constructor() {
-        this.modularity = 0;
-        this.coupling = 0;
-        this.cohesion = 0;
-        this.layering = 0;
-    }
-    score(edges, antiPatterns, totalFiles) {
-        this.calculateModularity(edges, totalFiles);
-        this.calculateCoupling(edges, totalFiles);
-        this.calculateCohesion(edges);
-        this.calculateLayering(antiPatterns, totalFiles);
-        const components = [
-            {
-                name: 'Modularity',
-                score: Math.round(this.modularity),
-                maxScore: 100,
-                weight: 0.4,
-                explanation: 'Measures appropriate module boundaries and single responsibility principle adherence',
-            },
-            {
-                name: 'Coupling',
-                score: Math.round(this.coupling),
-                maxScore: 100,
-                weight: 0.25,
-                explanation: 'Evaluates interdependencies between modules; lower coupling is better',
-            },
-            {
-                name: 'Cohesion',
-                score: Math.round(this.cohesion),
-                maxScore: 100,
-                weight: 0.2,
-                explanation: 'Assesses how closely related functionality is grouped together',
-            },
-            {
-                name: 'Layering',
-                score: Math.round(this.layering),
-                maxScore: 100,
-                weight: 0.15,
-                explanation: 'Checks adherence to architectural layer separation',
-            },
-        ];
-        const overall = Math.round(components[0].score * components[0].weight +
-            components[1].score * components[1].weight +
-            components[2].score * components[2].weight +
-            components[3].score * components[3].weight);
-        return {
-            overall: Math.min(100, Math.max(0, overall)),
-            components,
-            breakdown: {
-                modularity: Math.round(this.modularity),
-                coupling: Math.round(this.coupling),
-                cohesion: Math.round(this.cohesion),
-                layering: Math.round(this.layering),
-            },
-        };
-    }
-    calculateModularity(edges, totalFiles) {
-        if (totalFiles === 0) {
-            this.modularity = 50;
-            return;
-        }
-        const avgEdgesPerFile = edges.length / totalFiles;
-        if (avgEdgesPerFile < 2) {
-            this.modularity = 95;
-        }
-        else if (avgEdgesPerFile < 4) {
-            this.modularity = 85;
-        }
-        else if (avgEdgesPerFile < 6) {
-            this.modularity = 70;
-        }
-        else if (avgEdgesPerFile < 10) {
-            this.modularity = 50;
-        }
-        else {
-            this.modularity = 30;
-        }
-    }
-    calculateCoupling(edges, totalFiles) {
-        if (totalFiles === 0 || totalFiles === 1) {
-            this.coupling = 50;
-            return;
-        }
-        // Exclude barrel/index files from max-edge calculation —
-        // they naturally have many connections by design.
-        const nonBarrelEdges = edges.filter((e) => {
-            const fromFile = basename(e.from);
-            const toFile = basename(e.to);
-            return !ArchitectureScorer.BARREL_FILES.has(fromFile) &&
-                !ArchitectureScorer.BARREL_FILES.has(toFile);
-        });
-        const nodeWithMaxEdges = this.findNodeWithMaxEdges(nonBarrelEdges);
-        const maxEdgeCount = nodeWithMaxEdges ? nodeWithMaxEdges.count : 0;
-        // Use non-barrel file count for ratio calculation
-        const effectiveFiles = Math.max(totalFiles - 1, 1);
-        const couplingRatio = maxEdgeCount / effectiveFiles;
-        // More granular thresholds
-        if (couplingRatio < 0.15) {
-            this.coupling = 95;
-        }
-        else if (couplingRatio < 0.25) {
-            this.coupling = 85;
-        }
-        else if (couplingRatio < 0.35) {
-            this.coupling = 75;
-        }
-        else if (couplingRatio < 0.5) {
-            this.coupling = 65;
-        }
-        else if (couplingRatio < 0.7) {
-            this.coupling = 50;
-        }
-        else if (couplingRatio < 0.85) {
-            this.coupling = 35;
-        }
-        else {
-            this.coupling = 20;
-        }
-    }
-    findNodeWithMaxEdges(edges) {
-        const nodeEdgeCount = {};
-        for (const edge of edges) {
-            nodeEdgeCount[edge.from] = (nodeEdgeCount[edge.from] || 0) + 1;
-            nodeEdgeCount[edge.to] = (nodeEdgeCount[edge.to] || 0) + 1;
-        }
-        let maxNode = null;
-        let maxCount = 0;
-        for (const [node, count] of Object.entries(nodeEdgeCount)) {
-            if (count > maxCount) {
-                maxCount = count;
-                maxNode = node;
-            }
-        }
-        return maxNode ? { node: maxNode, count: maxCount } : null;
-    }
-    calculateCohesion(edges) {
-        if (edges.length === 0) {
-            this.cohesion = 50;
-            return;
-        }
-        const internalEdges = edges.filter((e) => this.isInternalDependency(e.from, e.to)).length;
-        const cohesionRatio = internalEdges / edges.length;
-        // More granular thresholds
-        if (cohesionRatio > 0.8) {
-            this.cohesion = 95;
-        }
-        else if (cohesionRatio > 0.6) {
-            this.cohesion = 85;
-        }
-        else if (cohesionRatio > 0.45) {
-            this.cohesion = 75;
-        }
-        else if (cohesionRatio > 0.3) {
-            this.cohesion = 65;
-        }
-        else if (cohesionRatio > 0.15) {
-            this.cohesion = 50;
-        }
-        else {
-            this.cohesion = 30;
-        }
-    }
-    /**
-     * Determines if a dependency is "internal" (cohesive).
-     * Two files are considered cohesive if they share the same top-level
-     * package/directory (e.g., deepguard/cli.py → deepguard/analyzer.py).
-     * This is crucial for Python flat packages where all files live in
-     * one directory but ARE cohesive.
-     */
-    isInternalDependency(from, to) {
-        const fromParts = from.split('/');
-        const toParts = to.split('/');
-        // If both are in root (no directory), they're cohesive
-        if (fromParts.length <= 1 && toParts.length <= 1)
-            return true;
-        // Compare top-level directory (package name)
-        // e.g., "deepguard/cli.py" and "deepguard/analyzer.py" → same package
-        const fromTopLevel = fromParts.length > 1 ? fromParts[0] : '';
-        const toTopLevel = toParts.length > 1 ? toParts[0] : '';
-        return fromTopLevel === toTopLevel;
-    }
-    calculateLayering(antiPatterns, totalFiles) {
-        const layeringViolations = antiPatterns.filter((p) => p.name === 'Leaky Abstraction' ||
-            p.name === 'Shotgun Surgery' ||
-            p.name === 'Circular Dependency').length;
-        if (layeringViolations === 0) {
-            this.layering = 95;
-            return;
-        }
-        // Use ratio-based scoring: violations per 100 files
-        // This makes scoring fair regardless of project size
-        const fileCount = Math.max(totalFiles || 50, 10);
-        const violationRatio = layeringViolations / fileCount;
-        if (violationRatio < 0.02) {
-            // < 2% — e.g. 1 violation in 50 files
-            this.layering = 90;
-        }
-        else if (violationRatio < 0.05) {
-            // < 5% — e.g. 2-3 violations in 50 files
-            this.layering = 80;
-        }
-        else if (violationRatio < 0.1) {
-            // < 10% — e.g. 5 violations in 50 files
-            this.layering = 65;
-        }
-        else if (violationRatio < 0.2) {
-            // < 20% — significant issues
-            this.layering = 50;
-        }
-        else if (violationRatio < 0.35) {
-            this.layering = 35;
-        }
-        else {
-            // > 35% — severe layering problems
-            this.layering = 20;
-        }
-    }
-}
-/**
- * Barrel/index files that naturally have many connections and should be
- * excluded from coupling max-edge penalty calculations.
- */
-ArchitectureScorer.BARREL_FILES = new Set([
-    '__init__.py', 'index.ts', 'index.js', 'index.tsx', 'index.jsx',
-    'mod.rs', '__init__.pyi',
-]);
-//# sourceMappingURL=scorer.js.map

package/dist/scorer.js.map

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

package/dist/types.d.ts

@@ -1,186 +0,0 @@
-export interface FileNode {
-    path: string;
-    name: string;
-    type: 'file' | 'directory';
-    extension?: string;
-    lines?: number;
-    language?: string;
-    children?: FileNode[];
-    imports?: string[];
-    exports?: string[];
-}
-export interface DependencyEdge {
-    from: string;
-    to: string;
-    type: 'import' | 'export' | 'inheritance' | 'composition';
-    weight: number;
-}
-export interface Layer {
-    name: 'API' | 'Service' | 'Data' | 'UI' | 'Infrastructure';
-    files: string[];
-    description: string;
-}
-export interface AntiPattern {
-    name: string;
-    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
-    location: string;
-    description: string;
-    suggestion: string;
-    affectedFiles?: string[];
-    metrics?: Record<string, number | string>;
-}
-export interface ScoreComponent {
-    name: string;
-    score: number;
-    maxScore: number;
-    weight: number;
-    explanation: string;
-}
-export interface ArchitectureScore {
-    overall: number;
-    components: ScoreComponent[];
-    breakdown: {
-        modularity: number;
-        coupling: number;
-        cohesion: number;
-        layering: number;
-    };
-}
-export interface WorkspaceInfo {
-    name: string;
-    path: string;
-    relativePath: string;
-    description: string;
-    version: string;
-    dependencies: Record<string, string>;
-    devDependencies: Record<string, string>;
-    bin?: Record<string, string>;
-    main?: string;
-}
-export interface ProjectInfo {
-    path: string;
-    name: string;
-    frameworks: string[];
-    totalFiles: number;
-    totalLines: number;
-    primaryLanguages: string[];
-    fileTree?: FileNode;
-    workspaces?: WorkspaceInfo[];
-}
-export interface AnalysisReport {
-    timestamp: string;
-    projectInfo: ProjectInfo;
-    score: ArchitectureScore;
-    antiPatterns: AntiPattern[];
-    layers: Layer[];
-    dependencyGraph: {
-        nodes: string[];
-        edges: DependencyEdge[];
-    };
-    suggestions: {
-        priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
-        title: string;
-        description: string;
-        impact: string;
-    }[];
-    diagram: {
-        mermaid: string;
-        type: 'component' | 'layer' | 'dependency';
-    };
-    projectSummary?: ProjectSummary;
-}
-export interface ProjectSummary {
-    description: string;
-    purpose: string;
-    modules: {
-        name: string;
-        files: number;
-        description: string;
-    }[];
-    techStack: string[];
-    entryPoints: string[];
-    keywords: string[];
-}
-export interface ArchitectConfig {
-    ignore?: string[];
-    frameworks?: {
-        detect?: boolean;
-    };
-    antiPatterns?: {
-        godClass?: {
-            linesThreshold?: number;
-            methodsThreshold?: number;
-        };
-        shotgunSurgery?: {
-            changePropagationThreshold?: number;
-        };
-    };
-    score?: {
-        modularity?: number;
-        coupling?: number;
-        cohesion?: number;
-        layering?: number;
-    };
-    monorepo?: {
-        enabled?: boolean;
-        treatPackagesAsModules?: boolean;
-    };
-}
-export interface ParsedImport {
-    source: string;
-    names: string[];
-    isDefault: boolean;
-    isNamespace: boolean;
-}
-export interface RefactoringPlan {
-    timestamp: string;
-    projectPath: string;
-    currentScore: ArchitectureScore;
-    estimatedScoreAfter: {
-        overall: number;
-        breakdown: Record<string, number>;
-    };
-    steps: RefactorStep[];
-    totalOperations: number;
-    tier1Steps: number;
-    tier2Steps: number;
-}
-export interface RefactorStep {
-    id: number;
-    tier: 1 | 2;
-    rule: string;
-    priority: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
-    title: string;
-    description: string;
-    rationale: string;
-    operations: FileOperation[];
-    scoreImpact: {
-        metric: string;
-        before: number;
-        after: number;
-    }[];
-    codePreview?: string;
-}
-export interface FileOperation {
-    type: 'CREATE' | 'MOVE' | 'MODIFY' | 'DELETE';
-    path: string;
-    newPath?: string;
-    content?: string;
-    diff?: string;
-    description: string;
-}
-export interface CodeSymbol {
-    name: string;
-    type: 'function' | 'class' | 'variable' | 'import' | 'export';
-    startLine: number;
-    endLine: number;
-    lines: number;
-    dependencies: string[];
-    usedBy: string[];
-}
-export interface RefactorRule {
-    name: string;
-    tier: 1 | 2;
-    analyze(report: AnalysisReport, projectPath: string): RefactorStep[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/sample-report.md

@@ -1,207 +0,0 @@
-# Architecture Analysis Report
-
-Generated: 2026-03-15 14:23:45
-Project: ecommerce-api
-Path: /projects/ecommerce-api
-
-## Project Summary
-
-| Metric | Value |
-|--------|-------|
-| Total Files | 147 |
-| Lines of Code | 24,583 |
-| Primary Languages | TypeScript, Python |
-| Frameworks | Express.js, React, PostgreSQL |
-
-## Architecture Quality Score
-
-### Overall Score: **72/100**
-
-Component Breakdown:
-
-- **Modularity**: 78/100 (weight: 40%)
-  Measures appropriate module boundaries and single responsibility principle adherence
-
-- **Coupling**: 65/100 (weight: 25%)
-  Evaluates interdependencies between modules; lower coupling is better
-
-- **Cohesion**: 72/100 (weight: 20%)
-  Assesses how closely related functionality is grouped together
-
-- **Layering**: 68/100 (weight: 15%)
-  Checks adherence to architectural layer separation
-
-## Anti-Patterns Detected
-
-Found **3** anti-pattern(s):
-
-### X God Class [CRITICAL]
-
-**Location**: `src/services/UserManager.ts`
-
-**Description**: Class with 834 lines and 16 methods violates single responsibility principle
-
-**Suggestion**: Consider splitting into smaller, focused classes with specific responsibilities
-
-**Metrics**:
-- lines: 834
-- methods: 16
-
-### W Circular Dependency [HIGH]
-
-**Location**: src/utils/auth.ts -> src/services/cache.ts -> src/utils/auth.ts
-
-**Description**: Circular dependency detected: auth.ts -> cache.ts -> auth.ts
-
-**Suggestion**: Refactor code to break the circular dependency using dependency injection or intermediate abstractions
-
-### o Leaky Abstraction [MEDIUM]
-
-**Location**: `src/models/Database.ts`
-
-**Description**: Exports 12 internal types that should be private
-
-**Suggestion**: Use private/internal access modifiers and facade patterns to hide implementation details
-
-**Metrics**:
-- exportedInternalTypes: 12
-
-## Architectural Layers
-
-### API Layer
-
-Handles external interfaces and routing
-
-**Files**: 12
-```
-src/routes/users.ts
-src/routes/products.ts
-src/routes/orders.ts
-src/routes/auth.ts
-src/middleware/errorHandler.ts
-... and 7 more files
-```
-
-### Service Layer
-
-Business logic and orchestration
-
-**Files**: 34
-```
-src/services/UserService.ts
-src/services/ProductService.ts
-src/services/OrderService.ts
-src/services/PaymentService.ts
-src/services/NotificationService.ts
-... and 29 more files
-```
-
-### Data Layer
-
-Database access and persistence
-
-**Files**: 18
-```
-src/repositories/UserRepository.ts
-src/repositories/ProductRepository.ts
-src/repositories/OrderRepository.ts
-src/models/User.ts
-src/models/Product.ts
-... and 13 more files
-```
-
-### UI Layer
-
-User interface components and views
-
-**Files**: 42
-```
-src/components/Header.tsx
-src/components/ProductCard.tsx
-src/components/CartItem.tsx
-src/pages/Home.tsx
-src/pages/Product.tsx
-... and 37 more files
-```
-
-### Infrastructure Layer
-
-Configuration and setup
-
-**Files**: 8
-```
-config/database.ts
-config/logging.ts
-config/cache.ts
-scripts/migrate.ts
-docker-compose.yml
-... and 3 more files
-```
-
-## Architecture Diagram
-
-Type: layer
-
-```mermaid
-graph LR
-  UI["UI<br/>(42 files)"]:::uiStyle
-  API["API<br/>(12 files)"]:::apiStyle
-  Service["Service<br/>(34 files)"]:::serviceStyle
-  Data["Data<br/>(18 files)"]:::dataStyle
-  Infrastructure["Infrastructure<br/>(8 files)"]:::infraStyle
-
-  UI --> API
-  API --> Service
-  Service --> Data
-  Data --> Infrastructure
-
-  classDef apiStyle fill:#FFB6C1,stroke:#333,color:#000
-  classDef serviceStyle fill:#87CEEB,stroke:#333,color:#000
-  classDef dataStyle fill:#90EE90,stroke:#333,color:#000
-  classDef uiStyle fill:#FFD700,stroke:#333,color:#000
-  classDef infraStyle fill:#D3D3D3,stroke:#333,color:#000
-```
-
-## Refactoring Suggestions
-
-### CRITICAL Priority
-
-1. **God Class**
-   Split UserManager into Repository, Service, and Manager classes following single responsibility principle
-   Impact: Addressing this God Class will improve overall architecture score
-
-### HIGH Priority
-
-1. **Circular Dependency**
-   Break circular dependency between auth and cache modules using dependency inversion
-   Impact: Addressing this Circular Dependency will improve overall architecture score
-
-2. **Reduce Coupling**
-   Use dependency injection and invert control to reduce module interdependencies
-   Impact: Can improve coupling score by 15-20 points
-
-### MEDIUM Priority
-
-1. **Leaky Abstraction**
-   Hide internal database types behind facade pattern
-   Impact: Addressing this Leaky Abstraction will improve overall architecture score
-
-2. **Improve Cohesion**
-   Group related functionality closer together; consider extracting utility modules
-   Impact: Can improve cohesion score by 10-15 points
-
----
-
-## Key Takeaways
-
-This e-commerce API demonstrates a reasonable architectural foundation with good modularity and separation of concerns. The main areas for improvement are:
-
-1. Breaking down the oversized UserManager class (critical issue)
-2. Resolving circular dependencies in the utility and cache modules
-3. Tightening module coupling through better dependency management
-4. Hiding internal implementation details from public APIs
-
-Implementing these suggestions could bring the overall score from 72/100 to approximately 85-90/100, achieving a highly maintainable and scalable architecture.
-
-**Estimated Effort**: 3-4 weeks for a team of 2-3 developers
-**Expected ROI**: Significantly improved code maintainability, reduced future technical debt, easier testing

package/jest.config.js

@@ -1,18 +0,0 @@
-/** @type {import('ts-jest').JestConfigWithTsJest} */
-export default {
-  preset: 'ts-jest/presets/default-esm',
-  testEnvironment: 'node',
-  extensionsToTreatAsEsm: ['.ts'],
-  moduleNameMapper: {
-    '^(\\.{1,2}/.*)\\.js$': '$1',
-  },
-  transform: {
-    '^.+\\.tsx?$': [
-      'ts-jest',
-      {
-        useESM: true,
-      },
-    ],
-  },
-  testMatch: ['**/tests/**/*.test.ts'],
-};