@girardelli/architect 1.1.0

package/dist/scorer.js

@@ -0,0 +1,172 @@
+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);
+        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) {
+            this.coupling = 50;
+            return;
+        }
+        const nodeWithMaxEdges = this.findNodeWithMaxEdges(edges);
+        const maxEdgeCount = nodeWithMaxEdges ? nodeWithMaxEdges.count : 0;
+        const couplingRatio = maxEdgeCount / (totalFiles - 1);
+        if (couplingRatio < 0.2) {
+            this.coupling = 95;
+        }
+        else if (couplingRatio < 0.4) {
+            this.coupling = 85;
+        }
+        else if (couplingRatio < 0.6) {
+            this.coupling = 70;
+        }
+        else if (couplingRatio < 0.8) {
+            this.coupling = 50;
+        }
+        else {
+            this.coupling = 30;
+        }
+    }
+    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;
+        if (cohesionRatio > 0.7) {
+            this.cohesion = 95;
+        }
+        else if (cohesionRatio > 0.5) {
+            this.cohesion = 80;
+        }
+        else if (cohesionRatio > 0.3) {
+            this.cohesion = 65;
+        }
+        else if (cohesionRatio > 0.1) {
+            this.cohesion = 45;
+        }
+        else {
+            this.cohesion = 30;
+        }
+    }
+    isInternalDependency(from, to) {
+        const fromModule = from.split('/').slice(0, -1).join('/');
+        const toModule = to.split('/').slice(0, -1).join('/');
+        return fromModule === toModule;
+    }
+    calculateLayering(antiPatterns) {
+        const layeringViolations = antiPatterns.filter((p) => p.name === 'Leaky Abstraction' ||
+            p.name === 'Shotgun Surgery' ||
+            p.name === 'Circular Dependency').length;
+        if (layeringViolations === 0) {
+            this.layering = 95;
+        }
+        else if (layeringViolations === 1) {
+            this.layering = 85;
+        }
+        else if (layeringViolations === 2) {
+            this.layering = 70;
+        }
+        else if (layeringViolations === 3) {
+            this.layering = 55;
+        }
+        else if (layeringViolations <= 5) {
+            this.layering = 40;
+        }
+        else {
+            this.layering = 25;
+        }
+    }
+}
+//# sourceMappingURL=scorer.js.map

package/dist/scorer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+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 ProjectInfo {
+    path: string;
+    name: string;
+    frameworks: string[];
+    totalFiles: number;
+    totalLines: number;
+    primaryLanguages: string[];
+    fileTree?: FileNode;
+}
+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';
+    };
+}
+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;
+    };
+}
+export interface ParsedImport {
+    source: string;
+    names: string[];
+    isDefault: boolean;
+    isNamespace: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/examples/sample-report.md

@@ -0,0 +1,207 @@
+# 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

@@ -0,0 +1,18 @@
+/** @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'],
+};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@girardelli/architect",
+  "version": "1.1.0",
+  "type": "module",
+  "description": "AI-powered architecture analysis for Claude Code",
+  "author": {
+    "name": "Camilo Girardelli",
+    "email": "contact@girardelli.tech",
+    "url": "https://girardelli.tech"
+  },
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "architect": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "analyze": "node dist/cli.js analyze",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "lint": "eslint src --ext .ts",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "dependencies": {
+    "glob": "^10.3.10",
+    "acorn": "^8.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/jest": "^29.5.0",
+    "typescript": "^5.3.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0"
+  },
+  "keywords": [
+    "architecture",
+    "analysis",
+    "Claude Code",
+    "plugin",
+    "code quality",
+    "anti-patterns",
+    "refactoring",
+    "visualization",
+    "dependency graph",
+    "mermaid"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/camilooscargbaptista/architect"
+  },
+  "bugs": {
+    "url": "https://github.com/camilooscargbaptista/architect/issues"
+  },
+  "homepage": "https://github.com/camilooscargbaptista/architect#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}