tech-debt-score 0.1.0

package/dist/cli/commands/analyze.js

@@ -0,0 +1,58 @@
+import { resolve } from 'node:path';
+import { AnalysisService } from '../../application/services/AnalysisService.js';
+import { FileSystemReader } from '../../adapters/input/FileSystemReader.js';
+import { TypeScriptParser } from '../../adapters/input/TypeScriptParser.js';
+import { TerminalReporter } from '../../adapters/output/TerminalReporter.js';
+import { JsonExporter } from '../../adapters/output/JsonExporter.js';
+import { ComplexityRule } from '../../domain/rules/ComplexityRule.js';
+import { SizeRule } from '../../domain/rules/SizeRule.js';
+import { TypeSafetyRule } from '../../domain/rules/TypeSafetyRule.js';
+import { DuplicationRule } from '../../domain/rules/DuplicationRule.js';
+import { CircularDependencyRule } from '../../domain/rules/CircularDependencyRule.js';
+import { DEFAULT_CONFIG } from '../../application/config/AnalysisConfig.js';
+// Helper to broadcast to multiple reporters
+class CompositeReporter {
+    constructor(reporters) {
+        this.reporters = reporters;
+    }
+    async generate(report) {
+        await Promise.all(this.reporters.map(r => r.generate(report)));
+    }
+}
+export async function analyzeCommand(rootPath, jsonOutputPath) {
+    console.log('🚀 Starting technical debt analysis...\n');
+    // Wiring: Create all adapters and services (dependency injection)
+    const fileReader = new FileSystemReader();
+    const parser = new TypeScriptParser();
+    // Use both terminal and JSON reporters
+    const reporter = new CompositeReporter([
+        new TerminalReporter(),
+        new JsonExporter(jsonOutputPath)
+    ]);
+    const rules = [
+        // ... rules
+        new ComplexityRule(),
+        new SizeRule(),
+        new TypeSafetyRule(),
+        new DuplicationRule(),
+        new CircularDependencyRule(),
+    ];
+    const analysisService = new AnalysisService(fileReader, parser, rules, reporter);
+    // Build configuration
+    // Smart pattern detection:
+    // - If scanning CWD, default to looking in 'src/'
+    // - If scanning a specific directory (e.g. ./src), look for files inside it
+    const isCwd = resolve(rootPath) === process.cwd();
+    const defaultPatterns = isCwd
+        ? DEFAULT_CONFIG.patterns
+        : ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'];
+    const config = {
+        rootPath,
+        ...DEFAULT_CONFIG,
+        patterns: defaultPatterns,
+    };
+    // Execute analysis
+    await analysisService.analyze(config);
+    console.log('✅ Analysis complete!\n');
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAG5E,4CAA4C;AAC5C,MAAM,iBAAiB;IACrB,YAAoB,SAAsB;QAAtB,cAAS,GAAT,SAAS,CAAa;IAAG,CAAC;IAE9C,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,cAAuB;IAC5E,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAExD,kEAAkE;IAClE,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAEtC,uCAAuC;IACvC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAC;QACrC,IAAI,gBAAgB,EAAE;QACtB,IAAI,YAAY,CAAC,cAAc,CAAC;KACjC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,YAAY;QAEZ,IAAI,cAAc,EAAE;QACpB,IAAI,QAAQ,EAAE;QACd,IAAI,cAAc,EAAE;QACpB,IAAI,eAAe,EAAE;QACrB,IAAI,sBAAsB,EAAE;KAC7B,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,eAAe,CACzC,UAAU,EACV,MAAM,EACN,KAAK,EACL,QAAQ,CACT,CAAC;IAEF,sBAAsB;IACtB,2BAA2B;IAC3B,kDAAkD;IAClD,4EAA4E;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;IAElD,MAAM,eAAe,GAAG,KAAK;QAC3B,CAAC,CAAC,cAAc,CAAC,QAAQ;QACzB,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAmB;QAC7B,QAAQ;QACR,GAAG,cAAc;QACjB,QAAQ,EAAE,eAAe;KAC1B,CAAC;IAEF,mBAAmB;IACnB,MAAM,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AACxC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ * Command-line interface for tech-debt-score
+ *
+ * NO BUSINESS LOGIC HERE - just argument parsing and delegation
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/cli/index.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * CLI Entry Point
+ * Command-line interface for tech-debt-score
+ *
+ * NO BUSINESS LOGIC HERE - just argument parsing and delegation
+ */
+import { analyzeCommand } from './commands/analyze.js';
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        process.exit(0);
+    }
+    // Parse arguments
+    let rootPath = process.cwd();
+    let jsonOutputPath;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (!arg)
+            continue;
+        if (arg === '--json' || arg === '-j') {
+            const nextArg = args[i + 1];
+            if (nextArg && !nextArg.startsWith('-')) {
+                jsonOutputPath = nextArg;
+                i++; // Skip next arg
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            rootPath = arg;
+        }
+    }
+    try {
+        await analyzeCommand(rootPath, jsonOutputPath);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('❌ Analysis failed:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`
+┌─────────────────────────────────────────────┐
+│  tech-debt-score - Quantify Technical Debt  │
+│  Built by developers, for developers        │
+└─────────────────────────────────────────────┘
+
+Usage:
+  tech-debt-score [path]
+
+Arguments:
+  path              Path to analyze (default: current directory)
+
+Options:
+  -h, --help        Show this help message
+
+Examples:
+  tech-debt-score                    # Analyze current directory
+  tech-debt-score ./my-project       # Analyze specific directory
+  tech-debt-score /path/to/code      # Analyze absolute path
+
+Options:
+  -h, --help            Show this help message
+  -j, --json <file>     Output JSON report to specific file
+
+
+For more information, visit:
+https://github.com/panduken/tech-debt-score
+  `);
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kBAAkB;IAClB,IAAI,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,cAAkC,CAAC;IAEvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG;YAAE,SAAS;QAEnB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,cAAc,GAAG,OAAO,CAAC;gBACzB,CAAC,EAAE,CAAC,CAAC,gBAAgB;YACvB,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,QAAQ,GAAG,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BX,CAAC,CAAC;AACL,CAAC;AAED,2BAA2B;AAC3B,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/domain/entities/Finding.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Domain Entity: Finding
+ * Represents an identified issue or code smell in the codebase
+ */
+import type { SourceLocation, Severity } from '../../shared/types.js';
+export interface Finding {
+    /**
+     * ID of the rule that generated this finding
+     */
+    ruleId: string;
+    /**
+     * Severity level of the issue
+     */
+    severity: Severity;
+    /**
+     * Human-readable message describing the issue
+     */
+    message: string;
+    /**
+     * File path where the issue was found
+     */
+    filePath: string;
+    /**
+     * Optional exact location in the source code
+     */
+    location?: SourceLocation;
+    /**
+     * Optional suggestion for fixing the issue
+     */
+    suggestion?: string;
+}
+export declare class FindingBuilder {
+    private finding;
+    withRuleId(ruleId: string): this;
+    withSeverity(severity: Severity): this;
+    withMessage(message: string): this;
+    withFilePath(filePath: string): this;
+    withLocation(location: SourceLocation): this;
+    withSuggestion(suggestion: string): this;
+    build(): Finding;
+}
+//# sourceMappingURL=Finding.d.ts.map

package/dist/domain/entities/Finding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Finding.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Finding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAwB;IAEvC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKtC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK5C,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKxC,KAAK,IAAI,OAAO;CAMjB"}

package/dist/domain/entities/Finding.js

@@ -0,0 +1,40 @@
+/**
+ * Domain Entity: Finding
+ * Represents an identified issue or code smell in the codebase
+ */
+export class FindingBuilder {
+    constructor() {
+        this.finding = {};
+    }
+    withRuleId(ruleId) {
+        this.finding.ruleId = ruleId;
+        return this;
+    }
+    withSeverity(severity) {
+        this.finding.severity = severity;
+        return this;
+    }
+    withMessage(message) {
+        this.finding.message = message;
+        return this;
+    }
+    withFilePath(filePath) {
+        this.finding.filePath = filePath;
+        return this;
+    }
+    withLocation(location) {
+        this.finding.location = location;
+        return this;
+    }
+    withSuggestion(suggestion) {
+        this.finding.suggestion = suggestion;
+        return this;
+    }
+    build() {
+        if (!this.finding.ruleId || !this.finding.severity || !this.finding.message || !this.finding.filePath) {
+            throw new Error('Finding requires ruleId, severity, message, and filePath');
+        }
+        return this.finding;
+    }
+}
+//# sourceMappingURL=Finding.js.map

package/dist/domain/entities/Finding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Finding.js","sourceRoot":"","sources":["../../../src/domain/entities/Finding.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,MAAM,OAAO,cAAc;IAA3B;QACU,YAAO,GAAqB,EAAE,CAAC;IAsCzC,CAAC;IApCC,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAkB;QAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAwB;QACnC,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,UAAkB;QAC/B,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACtG,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,IAAI,CAAC,OAAkB,CAAC;IACjC,CAAC;CACF"}

package/dist/domain/entities/Metric.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Domain Entity: Metric
+ * Represents a single measurement extracted from code analysis
+ */
+import type { SourceLocation } from '../../shared/types.js';
+export interface Metric {
+    /**
+     * Unique identifier for the metric type
+     * e.g., 'cyclomatic-complexity', 'function-length', 'any-usage'
+     */
+    name: string;
+    /**
+     * The measured value
+     */
+    value: number;
+    /**
+     * File path where this metric was measured
+     */
+    filePath: string;
+    /**
+     * Optional location in the source code
+     */
+    location?: SourceLocation;
+    /**
+     * Optional context (e.g., function name, class name)
+     */
+    context?: string;
+}
+export declare class MetricBuilder {
+    private metric;
+    withName(name: string): this;
+    withValue(value: number): this;
+    withFilePath(filePath: string): this;
+    withLocation(location: SourceLocation): this;
+    withContext(context: string): this;
+    build(): Metric;
+}
+//# sourceMappingURL=Metric.d.ts.map

package/dist/domain/entities/Metric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metric.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Metric.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAuB;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK5B,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK5C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKlC,KAAK,IAAI,MAAM;CAMhB"}

package/dist/domain/entities/Metric.js

@@ -0,0 +1,36 @@
+/**
+ * Domain Entity: Metric
+ * Represents a single measurement extracted from code analysis
+ */
+export class MetricBuilder {
+    constructor() {
+        this.metric = {};
+    }
+    withName(name) {
+        this.metric.name = name;
+        return this;
+    }
+    withValue(value) {
+        this.metric.value = value;
+        return this;
+    }
+    withFilePath(filePath) {
+        this.metric.filePath = filePath;
+        return this;
+    }
+    withLocation(location) {
+        this.metric.location = location;
+        return this;
+    }
+    withContext(context) {
+        this.metric.context = context;
+        return this;
+    }
+    build() {
+        if (!this.metric.name || this.metric.value === undefined || !this.metric.filePath) {
+            throw new Error('Metric requires name, value, and filePath');
+        }
+        return this.metric;
+    }
+}
+//# sourceMappingURL=Metric.js.map

package/dist/domain/entities/Metric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metric.js","sourceRoot":"","sources":["../../../src/domain/entities/Metric.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgCH,MAAM,OAAO,aAAa;IAA1B;QACU,WAAM,GAAoB,EAAE,CAAC;IAiCvC,CAAC;IA/BC,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAwB;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC,MAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/domain/entities/Rule.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Domain Entity: Rule
+ * Represents an evaluation rule that processes metrics and generates findings
+ */
+import type { Metric } from './Metric.js';
+import type { Finding } from './Finding.js';
+export interface Rule {
+    /**
+     * Unique identifier for this rule
+     */
+    id: string;
+    /**
+     * Human-readable name
+     */
+    name: string;
+    /**
+     * Description of what this rule evaluates
+     */
+    description: string;
+    /**
+     * Evaluate metrics and produce findings
+     */
+    evaluate(metrics: Metric[]): Finding[];
+    /**
+     * Calculate a score (0-100) based on findings
+     * where 100 = no issues, 0 = maximum issues
+     */
+    calculateScore(findings: Finding[]): number;
+}
+/**
+ * Abstract base class for rules
+ */
+export declare abstract class BaseRule implements Rule {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    constructor(id: string, name: string, description: string);
+    abstract evaluate(metrics: Metric[]): Finding[];
+    abstract calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=Rule.d.ts.map

package/dist/domain/entities/Rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;IAEvC;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;CAC7C;AAED;;GAEG;AACH,8BAAsB,QAAS,YAAW,IAAI;aAE1B,EAAE,EAAE,MAAM;aACV,IAAI,EAAE,MAAM;aACZ,WAAW,EAAE,MAAM;gBAFnB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM;IAGrC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IAC/C,QAAQ,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CACrD"}

package/dist/domain/entities/Rule.js

@@ -0,0 +1,15 @@
+/**
+ * Domain Entity: Rule
+ * Represents an evaluation rule that processes metrics and generates findings
+ */
+/**
+ * Abstract base class for rules
+ */
+export class BaseRule {
+    constructor(id, name, description) {
+        this.id = id;
+        this.name = name;
+        this.description = description;
+    }
+}
+//# sourceMappingURL=Rule.js.map

package/dist/domain/entities/Rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rule.js","sourceRoot":"","sources":["../../../src/domain/entities/Rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH;;GAEG;AACH,MAAM,OAAgB,QAAQ;IAC5B,YACkB,EAAU,EACV,IAAY,EACZ,WAAmB;QAFnB,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;IAClC,CAAC;CAIL"}

package/dist/domain/entities/Score.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Domain Entity: Score
+ * Represents the technical debt score and category breakdowns
+ */
+export interface CategoryScore {
+    /**
+     * Category name (e.g., 'Complexity', 'Size', 'Type Safety')
+     */
+    name: string;
+    /**
+     * Score for this category (0-100, where 100 = no debt)
+     */
+    score: number;
+    /**
+     * Weight of this category in the overall score (0-1)
+     */
+    weight: number;
+    /**
+     * Optional description of what this category measures
+     */
+    description?: string;
+}
+export interface Score {
+    /**
+     * Overall technical debt score (0-100, where 100 = no debt)
+     */
+    overall: number;
+    /**
+     * Breakdown by category
+     */
+    categories: CategoryScore[];
+    /**
+     * When this score was calculated
+     */
+    timestamp: Date;
+    /**
+     * Optional metadata about the analysis
+     */
+    metadata?: {
+        filesAnalyzed: number;
+        totalMetrics: number;
+        totalFindings: number;
+    };
+}
+export declare class ScoreCalculator {
+    /**
+     * Calculate overall score from category scores
+     *
+     * Formula: Σ(category_score × category_weight)
+     */
+    static calculateOverall(categories: CategoryScore[]): number;
+    /**
+     * Normalize a raw value to 0-100 scale
+     *
+     * @param value - The raw value to normalize
+     * @param min - Minimum value (maps to 100)
+     * @param max - Maximum value (maps to 0)
+     * @param invert - If true, higher values = better score
+     */
+    static normalize(value: number, min: number, max: number, invert?: boolean): number;
+}
+//# sourceMappingURL=Score.d.ts.map

package/dist/domain/entities/Score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Score.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/Score.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,aAAa,EAAE,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,IAAI,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM;IAiB5D;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM;CASlF"}

package/dist/domain/entities/Score.js

@@ -0,0 +1,40 @@
+/**
+ * Domain Entity: Score
+ * Represents the technical debt score and category breakdowns
+ */
+export class ScoreCalculator {
+    /**
+     * Calculate overall score from category scores
+     *
+     * Formula: Σ(category_score × category_weight)
+     */
+    static calculateOverall(categories) {
+        // Validate weights sum to 1.0 (or close to it)
+        const totalWeight = categories.reduce((sum, cat) => sum + cat.weight, 0);
+        if (Math.abs(totalWeight - 1.0) > 0.01) {
+            throw new Error(`Category weights must sum to 1.0, got ${totalWeight}`);
+        }
+        // Calculate weighted average
+        const weightedSum = categories.reduce((sum, cat) => sum + (cat.score * cat.weight), 0);
+        // Round to 2 decimal places
+        return Math.round(weightedSum * 100) / 100;
+    }
+    /**
+     * Normalize a raw value to 0-100 scale
+     *
+     * @param value - The raw value to normalize
+     * @param min - Minimum value (maps to 100)
+     * @param max - Maximum value (maps to 0)
+     * @param invert - If true, higher values = better score
+     */
+    static normalize(value, min, max, invert = false) {
+        if (value <= min)
+            return invert ? 0 : 100;
+        if (value >= max)
+            return invert ? 100 : 0;
+        const normalized = ((value - min) / (max - min)) * 100;
+        const score = invert ? normalized : 100 - normalized;
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=Score.js.map

package/dist/domain/entities/Score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Score.js","sourceRoot":"","sources":["../../../src/domain/entities/Score.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkDH,MAAM,OAAO,eAAe;IAC1B;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,UAA2B;QACjD,+CAA+C;QAC/C,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,yCAAyC,WAAW,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,6BAA6B;QAC7B,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,EAC5C,CAAC,CACF,CAAC;QAEF,4BAA4B;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IAC7C,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,MAAM,GAAG,KAAK;QACtE,IAAI,KAAK,IAAI,GAAG;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1C,IAAI,KAAK,IAAI,GAAG;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,UAAU,CAAC;QAErD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;CACF"}

package/dist/domain/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Domain Layer - Public API
+ * Exports all domain entities and services
+ */
+export * from './entities/Metric.js';
+export * from './entities/Finding.js';
+export * from './entities/Score.js';
+export * from './entities/Rule.js';
+export * from './rules/ComplexityRule.js';
+export * from './rules/SizeRule.js';
+export * from './rules/TypeSafetyRule.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,14 @@
+/**
+ * Domain Layer - Public API
+ * Exports all domain entities and services
+ */
+// Entities
+export * from './entities/Metric.js';
+export * from './entities/Finding.js';
+export * from './entities/Score.js';
+export * from './entities/Rule.js';
+// Rules
+export * from './rules/ComplexityRule.js';
+export * from './rules/SizeRule.js';
+export * from './rules/TypeSafetyRule.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,WAAW;AACX,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AAEnC,QAAQ;AACR,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC"}

package/dist/domain/rules/CircularDependencyRule.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Domain Rule: Circular Dependency Rule
+ * Detects circular dependencies between modules
+ */
+import { BaseRule } from '../entities/Rule.js';
+import type { Metric } from '../entities/Metric.js';
+import type { Finding } from '../entities/Finding.js';
+export declare class CircularDependencyRule extends BaseRule {
+    constructor();
+    evaluate(metrics: Metric[]): Finding[];
+    calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=CircularDependencyRule.d.ts.map

package/dist/domain/rules/CircularDependencyRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularDependencyRule.d.ts","sourceRoot":"","sources":["../../../src/domain/rules/CircularDependencyRule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,qBAAa,sBAAuB,SAAQ,QAAQ;;IASlD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IA6BtC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAgB5C"}

package/dist/domain/rules/CircularDependencyRule.js

@@ -0,0 +1,47 @@
+/**
+ * Domain Rule: Circular Dependency Rule
+ * Detects circular dependencies between modules
+ */
+import { BaseRule } from '../entities/Rule.js';
+import { FindingBuilder } from '../entities/Finding.js';
+export class CircularDependencyRule extends BaseRule {
+    constructor() {
+        super('circular-dependency', 'Circular Dependency Rule', 'Detects circular dependencies between modules that can cause maintenance issues');
+    }
+    evaluate(metrics) {
+        const findings = [];
+        // Find circular dependency metrics
+        const circularDepMetrics = metrics.filter(m => m.name === 'circular-dependency');
+        for (const metric of circularDepMetrics) {
+            if (metric.value > 0) {
+                // Extract cycle information from context
+                const cycleLength = metric.value;
+                const severity = cycleLength >= 4 ? 'high' : cycleLength >= 3 ? 'medium' : 'low';
+                findings.push(new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(severity)
+                    .withMessage(`Circular dependency detected: ${metric.context || 'module cycle'} (${cycleLength} files in cycle)`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Refactor to break the circular dependency by introducing interfaces or dependency injection')
+                    .build());
+            }
+        }
+        return findings;
+    }
+    calculateScore(findings) {
+        if (findings.length === 0)
+            return 100;
+        // Circular dependencies are serious - heavy penalty
+        const penalty = findings.reduce((sum, finding) => {
+            switch (finding.severity) {
+                case 'high': return sum + 20; // Very bad
+                case 'medium': return sum + 12;
+                case 'low': return sum + 6;
+                default: return sum;
+            }
+        }, 0);
+        const score = Math.max(0, 100 - penalty);
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=CircularDependencyRule.js.map

package/dist/domain/rules/CircularDependencyRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CircularDependencyRule.js","sourceRoot":"","sources":["../../../src/domain/rules/CircularDependencyRule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IAClD;QACE,KAAK,CACH,qBAAqB,EACrB,0BAA0B,EAC1B,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAiB;QACxB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,mCAAmC;QACnC,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC;QAEjF,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrB,yCAAyC;gBACzC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC;gBACjC,MAAM,QAAQ,GAAG,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAEjF,QAAQ,CAAC,IAAI,CACX,IAAI,cAAc,EAAE;qBACjB,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;qBACnB,YAAY,CAAC,QAAQ,CAAC;qBACtB,WAAW,CACV,iCAAiC,MAAM,CAAC,OAAO,IAAI,cAAc,KAAK,WAAW,kBAAkB,CACpG;qBACA,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;qBAC7B,cAAc,CAAC,6FAA6F,CAAC;qBAC7G,KAAK,EAAE,CACX,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,cAAc,CAAC,QAAmB;QAChC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC;QAEtC,oDAAoD;QACpD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YAC/C,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACzB,KAAK,MAAM,CAAC,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC,WAAW;gBACzC,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;gBAC/B,KAAK,KAAK,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC;YACtB,CAAC;QACH,CAAC,EAAE,CAAC,CAAC,CAAC;QAEN,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;CACF"}

package/dist/domain/rules/ComplexityRule.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Domain Rule: Complexity Rule
+ * Evaluates cyclomatic complexity and nesting depth
+ */
+import { BaseRule } from '../entities/Rule.js';
+import type { Metric } from '../entities/Metric.js';
+import type { Finding } from '../entities/Finding.js';
+export declare class ComplexityRule extends BaseRule {
+    private readonly COMPLEXITY_THRESHOLD;
+    private readonly NESTING_THRESHOLD;
+    constructor();
+    evaluate(metrics: Metric[]): Finding[];
+    calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=ComplexityRule.d.ts.map

package/dist/domain/rules/ComplexityRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComplexityRule.d.ts","sourceRoot":"","sources":["../../../src/domain/rules/ComplexityRule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,qBAAa,cAAe,SAAQ,QAAQ;IAE1C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAK;;IAUvC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IA+CtC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAiB5C"}