tech-debt-score 0.1.0

package/dist/domain/rules/ComplexityRule.js

@@ -0,0 +1,63 @@
+/**
+ * Domain Rule: Complexity Rule
+ * Evaluates cyclomatic complexity and nesting depth
+ */
+import { BaseRule } from '../entities/Rule.js';
+import { FindingBuilder } from '../entities/Finding.js';
+export class ComplexityRule extends BaseRule {
+    constructor() {
+        super('complexity', 'Complexity Rule', 'Evaluates cyclomatic complexity and nesting depth to identify overly complex code');
+        // Thresholds (configurable in future versions)
+        this.COMPLEXITY_THRESHOLD = 10;
+        this.NESTING_THRESHOLD = 4;
+    }
+    evaluate(metrics) {
+        const findings = [];
+        // Filter for complexity-related metrics
+        const complexityMetrics = metrics.filter(m => m.name === 'cyclomatic-complexity' || m.name === 'nesting-depth');
+        for (const metric of complexityMetrics) {
+            if (metric.name === 'cyclomatic-complexity' && metric.value > this.COMPLEXITY_THRESHOLD) {
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(metric.value > 20 ? 'high' : 'medium')
+                    .withMessage(`High cyclomatic complexity (${metric.value}) in ${metric.context || 'function'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Consider breaking this function into smaller, more focused functions');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+            if (metric.name === 'nesting-depth' && metric.value > this.NESTING_THRESHOLD) {
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(metric.value > 6 ? 'high' : 'medium')
+                    .withMessage(`Deep nesting (${metric.value} levels) in ${metric.context || 'function'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Reduce nesting by using early returns or extracting functions');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+        }
+        return findings;
+    }
+    calculateScore(findings) {
+        if (findings.length === 0)
+            return 100;
+        // Penalty based on severity
+        const penalty = findings.reduce((sum, finding) => {
+            switch (finding.severity) {
+                case 'high': return sum + 10;
+                case 'medium': return sum + 5;
+                case 'low': return sum + 2;
+                default: return sum;
+            }
+        }, 0);
+        // Cap the penalty and invert to get score
+        const score = Math.max(0, 100 - penalty);
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=ComplexityRule.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Domain Rule: Code Duplication Rule
+ * Detects duplicate code blocks using token-based similarity
+ */
+import { BaseRule } from '../entities/Rule.js';
+import type { Metric } from '../entities/Metric.js';
+import type { Finding } from '../entities/Finding.js';
+export declare class DuplicationRule extends BaseRule {
+    private readonly MIN_DUPLICATE_TOKENS;
+    private readonly SIMILARITY_THRESHOLD;
+    constructor();
+    evaluate(metrics: Metric[]): Finding[];
+    calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=DuplicationRule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicationRule.d.ts","sourceRoot":"","sources":["../../../src/domain/rules/DuplicationRule.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,eAAgB,SAAQ,QAAQ;IAE3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;IAC3C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;;IAU7C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IA8BtC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAgB5C"}

package/dist/domain/rules/DuplicationRule.js

@@ -0,0 +1,51 @@
+/**
+ * Domain Rule: Code Duplication Rule
+ * Detects duplicate code blocks using token-based similarity
+ */
+import { BaseRule } from '../entities/Rule.js';
+import { FindingBuilder } from '../entities/Finding.js';
+export class DuplicationRule extends BaseRule {
+    constructor() {
+        super('duplication', 'Code Duplication Rule', 'Detects duplicate or highly similar code blocks across the codebase');
+        // Thresholds
+        this.MIN_DUPLICATE_TOKENS = 50; // Minimum tokens to consider as duplication
+        this.SIMILARITY_THRESHOLD = 0.95; // 95% similarity
+    }
+    evaluate(metrics) {
+        const findings = [];
+        // Group metrics by type
+        const duplicationMetrics = metrics.filter(m => m.name === 'code-duplication');
+        for (const metric of duplicationMetrics) {
+            if (metric.value > 0) {
+                const severity = metric.value > 5 ? 'high' : metric.value > 2 ? 'medium' : 'low';
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(severity)
+                    .withMessage(`Found ${metric.value} duplicate code block(s) in ${metric.context || 'file'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Extract duplicate code into reusable functions or modules');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+        }
+        return findings;
+    }
+    calculateScore(findings) {
+        if (findings.length === 0)
+            return 100;
+        // Each duplication finding reduces score
+        const penalty = findings.reduce((sum, finding) => {
+            switch (finding.severity) {
+                case 'high': return sum + 15;
+                case 'medium': return sum + 8;
+                case 'low': return sum + 4;
+                default: return sum;
+            }
+        }, 0);
+        const score = Math.max(0, 100 - penalty);
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=DuplicationRule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DuplicationRule.js","sourceRoot":"","sources":["../../../src/domain/rules/DuplicationRule.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,eAAgB,SAAQ,QAAQ;IAK3C;QACE,KAAK,CACH,aAAa,EACb,uBAAuB,EACvB,qEAAqE,CACtE,CAAC;QATJ,aAAa;QACI,yBAAoB,GAAG,EAAE,CAAC,CAAC,4CAA4C;QACvE,yBAAoB,GAAG,IAAI,CAAC,CAAC,iBAAiB;IAQ/D,CAAC;IAED,QAAQ,CAAC,OAAiB;QACxB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,wBAAwB;QACxB,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QAE9E,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;gBAEjF,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE;qBACjC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;qBACnB,YAAY,CAAC,QAAQ,CAAC;qBACtB,WAAW,CACV,SAAS,MAAM,CAAC,KAAK,+BAA+B,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,CAC/E;qBACA,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;qBAC7B,cAAc,CAAC,2DAA2D,CAAC,CAAC;gBAE/E,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACxC,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACjC,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,yCAAyC;QACzC,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;gBAC7B,KAAK,QAAQ,CAAC,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC;gBAC9B,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/SizeRule.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Domain Rule: Size Rule
+ * Evaluates file and function size metrics
+ */
+import { BaseRule } from '../entities/Rule.js';
+import type { Metric } from '../entities/Metric.js';
+import type { Finding } from '../entities/Finding.js';
+export declare class SizeRule extends BaseRule {
+    private readonly MAX_FILE_LINES;
+    private readonly MAX_FUNCTION_LINES;
+    private readonly MAX_PARAMETERS;
+    constructor();
+    evaluate(metrics: Metric[]): Finding[];
+    calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=SizeRule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SizeRule.d.ts","sourceRoot":"","sources":["../../../src/domain/rules/SizeRule.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,QAAS,SAAQ,QAAQ;IAEpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;IACtC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAM;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAK;;IAUpC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IA0DtC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAe5C"}

package/dist/domain/rules/SizeRule.js

@@ -0,0 +1,70 @@
+/**
+ * Domain Rule: Size Rule
+ * Evaluates file and function size metrics
+ */
+import { BaseRule } from '../entities/Rule.js';
+import { FindingBuilder } from '../entities/Finding.js';
+export class SizeRule extends BaseRule {
+    constructor() {
+        super('size', 'Size Rule', 'Evaluates file and function size to identify overly large code units');
+        // Thresholds (configurable in future versions)
+        this.MAX_FILE_LINES = 300;
+        this.MAX_FUNCTION_LINES = 50;
+        this.MAX_PARAMETERS = 5;
+    }
+    evaluate(metrics) {
+        const findings = [];
+        const sizeMetrics = metrics.filter(m => m.name === 'file-length' || m.name === 'function-length' || m.name === 'parameter-count');
+        for (const metric of sizeMetrics) {
+            if (metric.name === 'file-length' && metric.value > this.MAX_FILE_LINES) {
+                findings.push(new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(metric.value > 500 ? 'high' : 'medium')
+                    .withMessage(`Large file (${metric.value} lines)`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Consider splitting this file into smaller, more focused modules')
+                    .build());
+            }
+            if (metric.name === 'function-length' && metric.value > this.MAX_FUNCTION_LINES) {
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(metric.value > 100 ? 'high' : 'medium')
+                    .withMessage(`Large function (${metric.value} lines) in ${metric.context || 'unknown'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Break this function into smaller, single-purpose functions');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+            if (metric.name === 'parameter-count' && metric.value > this.MAX_PARAMETERS) {
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity('medium')
+                    .withMessage(`Too many parameters (${metric.value}) in ${metric.context || 'function'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Consider using an options object or builder pattern');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+        }
+        return findings;
+    }
+    calculateScore(findings) {
+        if (findings.length === 0)
+            return 100;
+        const penalty = findings.reduce((sum, finding) => {
+            switch (finding.severity) {
+                case 'high': return sum + 8;
+                case 'medium': return sum + 4;
+                case 'low': return sum + 2;
+                default: return sum;
+            }
+        }, 0);
+        const score = Math.max(0, 100 - penalty);
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=SizeRule.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Domain Rule: Type Safety Rule
+ * Evaluates TypeScript type safety indicators
+ */
+import { BaseRule } from '../entities/Rule.js';
+import type { Metric } from '../entities/Metric.js';
+import type { Finding } from '../entities/Finding.js';
+export declare class TypeSafetyRule extends BaseRule {
+    constructor();
+    evaluate(metrics: Metric[]): Finding[];
+    calculateScore(findings: Finding[]): number;
+}
+//# sourceMappingURL=TypeSafetyRule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSafetyRule.d.ts","sourceRoot":"","sources":["../../../src/domain/rules/TypeSafetyRule.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;;IAS1C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;IA2BtC,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;CAgB5C"}

package/dist/domain/rules/TypeSafetyRule.js

@@ -0,0 +1,45 @@
+/**
+ * Domain Rule: Type Safety Rule
+ * Evaluates TypeScript type safety indicators
+ */
+import { BaseRule } from '../entities/Rule.js';
+import { FindingBuilder } from '../entities/Finding.js';
+export class TypeSafetyRule extends BaseRule {
+    constructor() {
+        super('type-safety', 'Type Safety Rule', 'Evaluates TypeScript type safety by detecting usage of the `any` type');
+    }
+    evaluate(metrics) {
+        const findings = [];
+        const anyUsageMetrics = metrics.filter(m => m.name === 'any-usage');
+        for (const metric of anyUsageMetrics) {
+            if (metric.value > 0) {
+                const builder = new FindingBuilder()
+                    .withRuleId(this.id)
+                    .withSeverity(metric.value > 5 ? 'high' : 'medium')
+                    .withMessage(`Found ${metric.value} usage(s) of 'any' type in ${metric.context || 'code'}`)
+                    .withFilePath(metric.filePath)
+                    .withSuggestion('Replace `any` with specific types or use `unknown` for better type safety');
+                if (metric.location) {
+                    builder.withLocation(metric.location);
+                }
+                findings.push(builder.build());
+            }
+        }
+        return findings;
+    }
+    calculateScore(findings) {
+        if (findings.length === 0)
+            return 100;
+        // Each 'any' usage reduces the score
+        const totalAnyUsages = findings.reduce((sum, finding) => {
+            // Extract count from message (hacky, but works for v1)
+            const match = finding.message.match(/Found (\d+) usage/);
+            return sum + (match ? parseInt(match[1] ?? '0', 10) : 1);
+        }, 0);
+        // Each 'any' costs 3 points
+        const penalty = Math.min(100, totalAnyUsages * 3);
+        const score = Math.max(0, 100 - penalty);
+        return Math.round(score * 100) / 100;
+    }
+}
+//# sourceMappingURL=TypeSafetyRule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeSafetyRule.js","sourceRoot":"","sources":["../../../src/domain/rules/TypeSafetyRule.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,cAAe,SAAQ,QAAQ;IAC1C;QACE,KAAK,CACH,aAAa,EACb,kBAAkB,EAClB,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAiB;QACxB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAEpE,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE;qBACjC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;qBACnB,YAAY,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;qBAClD,WAAW,CACV,SAAS,MAAM,CAAC,KAAK,8BAA8B,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,CAC9E;qBACA,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;qBAC7B,cAAc,CAAC,2EAA2E,CAAC,CAAC;gBAE/F,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACpB,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACxC,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YACjC,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,qCAAqC;QACrC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;YACtD,uDAAuD;YACvD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACzD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC,EAAE,CAAC,CAAC,CAAC;QAEN,4BAA4B;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,cAAc,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;QAEzC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACvC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

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

package/dist/index.js.map

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

package/dist/shared/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared type definitions used across the application
+ */
+export interface SourceLocation {
+    startLine: number;
+    endLine: number;
+    startColumn: number;
+    endColumn: number;
+}
+export type Severity = 'low' | 'medium' | 'high';
+export interface FileMetadata {
+    path: string;
+    size: number;
+    linesOfCode: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/shared/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions used across the application
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "tech-debt-score",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "tech-debt-score": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc && node dist/cli/index.js",
+    "analyze": "tsc && node dist/cli/index.js",
+    "scan": "npm run build && node dist/cli/index.js .",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/panduken/tech-debt-score.git"
+  },
+  "keywords": [
+    "technical-debt",
+    "code-quality",
+    "static-analysis",
+    "typescript",
+    "javascript",
+    "ast",
+    "metrics",
+    "complexity",
+    "code-analysis",
+    "developer-tools"
+  ],
+  "author": "@panduken",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/panduken/tech-debt-score/issues"
+  },
+  "homepage": "https://github.com/panduken/tech-debt-score#readme",
+  "description": "Quantify technical debt you can actually control. Built by developers, for developers.",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "fast-glob": "^3.3.3"
+  }
+}

package/src/adapters/input/FileSystemReader.ts

@@ -0,0 +1,51 @@
+/**
+ * Input Adapter: File System Reader
+ * Implements IFileReader using Node.js filesystem
+ */
+
+import { readFile } from 'node:fs/promises';
+import { stat } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+import fg from 'fast-glob';
+import type { IFileReader, FileReadResult } from '../../application/ports/IFileReader.js';
+
+export class FileSystemReader implements IFileReader {
+  async scan(rootPath: string, patterns: string[], ignore: string[]): Promise<string[]> {
+    // Resolve the root path to absolute
+    const absoluteRoot = resolve(rootPath);
+
+    // Convert patterns to absolute paths relative to root
+    const absolutePatterns = patterns.map(pattern => 
+      join(absoluteRoot, pattern)
+    );
+
+    // Scan for files matching patterns
+    const files = await fg(absolutePatterns, {
+      ignore,
+      absolute: true,
+      onlyFiles: true,
+      dot: false, // Don't include hidden files by default
+    });
+
+    return files;
+  }
+
+  async read(filePath: string): Promise<FileReadResult> {
+    const content = await readFile(filePath, 'utf-8');
+    const stats = await stat(filePath);
+    const lines = content.split('\n');
+
+    return {
+      content,
+      metadata: {
+        path: filePath,
+        size: stats.size,
+        linesOfCode: lines.length,
+      },
+    };
+  }
+
+  async readBatch(filePaths: string[]): Promise<FileReadResult[]> {
+    return Promise.all(filePaths.map(path => this.read(path)));
+  }
+}