@defai.digital/ax-cli 3.3.0 → 3.4.0

package/dist/analyzers/best-practices/rules/typescript/no-implicit-any.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-implicit-any.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/no-implicit-any.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,iBAAkB,SAAQ,kBAAkB;IAC9C,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,8DAA8D,CAAC;IAC7E,QAAQ,GAAa,QAAQ,CAAC;IAC9B,QAAQ,GAAiB,aAAa,CAAC;IACvC,WAAW,GAAG,KAAK,CAAC;IAE7B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,wDAAwD;QACxD,MAAM,eAAe,GAAG,+BAA+B,CAAC;QACxD,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;QAEjD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAClE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAAC;QAEvE,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,YAAY,CAClB,OAAe,EACf,QAAgB,EAChB,OAAe,EACf,UAAuB;QAEvB,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAExB,uBAAuB;YACvB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,uDAAuD;gBACvD,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACzD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBAEnD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,cAAc,KAAK,0DAA0D,EAC7E,yBAAyB,KAAK,aAAa,CAC5C,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/analyzers/best-practices/rules/typescript/no-magic-numbers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * No Magic Numbers Rule
+ *
+ * Use named constants instead of magic numbers
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+import type { Violation, Severity } from '../../../../types/analysis.js';
+import type { RuleCategory } from '../../types.js';
+export declare class NoMagicNumbersRule extends BaseValidationRule {
+    readonly id = "no-magic-numbers";
+    readonly name = "No Magic Numbers";
+    readonly description = "Use named constants instead of magic numbers";
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable = false;
+    check(filePath: string, content: string): Promise<Violation[]>;
+}

package/dist/analyzers/best-practices/rules/typescript/no-magic-numbers.js

@@ -0,0 +1,32 @@
+/**
+ * No Magic Numbers Rule
+ *
+ * Use named constants instead of magic numbers
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+export class NoMagicNumbersRule extends BaseValidationRule {
+    id = 'no-magic-numbers';
+    name = 'No Magic Numbers';
+    description = 'Use named constants instead of magic numbers';
+    severity = 'low';
+    category = 'best-practices';
+    autoFixable = false;
+    async check(filePath, content) {
+        const violations = [];
+        // Pattern: numeric literals (excluding 0, 1, -1 which are common)
+        const magicNumberPattern = /(?<!\w)(?:[2-9]|[1-9]\d+)(?!\w|:)/g;
+        let match;
+        while ((match = magicNumberPattern.exec(content)) !== null) {
+            const number = match[0];
+            // Skip if it's part of a const declaration
+            const beforeMatch = content.substring(Math.max(0, match.index - 50), match.index);
+            if (/const\s+\w+\s*=\s*$/.test(beforeMatch)) {
+                continue; // This IS a constant declaration
+            }
+            const pos = this.getPosition(content, match.index);
+            violations.push(this.createViolation(filePath, pos.line, pos.column, `Magic number "${number}" found. Use a named constant instead.`, `const MEANINGFUL_NAME = ${number};`));
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=no-magic-numbers.js.map

package/dist/analyzers/best-practices/rules/typescript/no-magic-numbers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-magic-numbers.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/no-magic-numbers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,kBAAmB,SAAQ,kBAAkB;IAC/C,EAAE,GAAG,kBAAkB,CAAC;IACxB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,8CAA8C,CAAC;IAC7D,QAAQ,GAAa,KAAK,CAAC;IAC3B,QAAQ,GAAiB,gBAAgB,CAAC;IAC1C,WAAW,GAAG,KAAK,CAAC;IAE7B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,kEAAkE;QAClE,MAAM,kBAAkB,GAAG,oCAAoC,CAAC;QAEhE,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAExB,2CAA2C;YAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAClF,IAAI,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC5C,SAAS,CAAC,iCAAiC;YAC7C,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEnD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,iBAAiB,MAAM,wCAAwC,EAC/D,2BAA2B,MAAM,GAAG,CACrC,CACF,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analyzers/best-practices/rules/typescript/no-unused-vars.d.ts

@@ -0,0 +1,17 @@
+/**
+ * No Unused Variables Rule
+ *
+ * Remove unused variables to keep code clean
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+import type { Violation, Severity } from '../../../../types/analysis.js';
+import type { RuleCategory } from '../../types.js';
+export declare class NoUnusedVarsRule extends BaseValidationRule {
+    readonly id = "no-unused-vars";
+    readonly name = "No Unused Variables";
+    readonly description = "Remove unused variables to keep code clean";
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable = true;
+    check(filePath: string, content: string): Promise<Violation[]>;
+}

package/dist/analyzers/best-practices/rules/typescript/no-unused-vars.js

@@ -0,0 +1,36 @@
+/**
+ * No Unused Variables Rule
+ *
+ * Remove unused variables to keep code clean
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+export class NoUnusedVarsRule extends BaseValidationRule {
+    id = 'no-unused-vars';
+    name = 'No Unused Variables';
+    description = 'Remove unused variables to keep code clean';
+    severity = 'medium';
+    category = 'code-quality';
+    autoFixable = true;
+    async check(filePath, content) {
+        const violations = [];
+        // Simple heuristic: Look for variable declarations and check if they're used
+        const varPattern = /(?:const|let|var)\s+(\w+)\s*=/g;
+        let match;
+        while ((match = varPattern.exec(content)) !== null) {
+            const varName = match[1];
+            // Don't check common patterns
+            if (varName.startsWith('_'))
+                continue; // Intentionally unused
+            // Count occurrences of the variable name
+            const usagePattern = new RegExp(`\\b${varName}\\b`, 'g');
+            const usages = content.match(usagePattern);
+            // If only appears once (the declaration), it's unused
+            if (usages && usages.length === 1) {
+                const pos = this.getPosition(content, match.index);
+                violations.push(this.createViolation(filePath, pos.line, pos.column, `Variable "${varName}" is declared but never used.`, `Remove the unused variable or prefix with "_" if intentionally unused`));
+            }
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=no-unused-vars.js.map

package/dist/analyzers/best-practices/rules/typescript/no-unused-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-unused-vars.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/no-unused-vars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,gBAAiB,SAAQ,kBAAkB;IAC7C,EAAE,GAAG,gBAAgB,CAAC;IACtB,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAAG,4CAA4C,CAAC;IAC3D,QAAQ,GAAa,QAAQ,CAAC;IAC9B,QAAQ,GAAiB,cAAc,CAAC;IACxC,WAAW,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,6EAA6E;QAC7E,MAAM,UAAU,GAAG,gCAAgC,CAAC;QAEpD,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEzB,8BAA8B;YAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,uBAAuB;YAE9D,yCAAyC;YACzC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAE3C,sDAAsD;YACtD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEnD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,aAAa,OAAO,+BAA+B,EACnD,uEAAuE,CACxE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analyzers/best-practices/rules/typescript/prefer-const.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Prefer Const Rule
+ *
+ * Prefer const over let when variables are not reassigned
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+import type { Violation, Severity } from '../../../../types/analysis.js';
+import type { RuleCategory } from '../../types.js';
+export declare class PreferConstRule extends BaseValidationRule {
+    readonly id = "prefer-const";
+    readonly name = "Prefer Const";
+    readonly description = "Use \"const\" instead of \"let\" when variables are not reassigned";
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable = true;
+    check(filePath: string, content: string): Promise<Violation[]>;
+}

package/dist/analyzers/best-practices/rules/typescript/prefer-const.js

@@ -0,0 +1,33 @@
+/**
+ * Prefer Const Rule
+ *
+ * Prefer const over let when variables are not reassigned
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+export class PreferConstRule extends BaseValidationRule {
+    id = 'prefer-const';
+    name = 'Prefer Const';
+    description = 'Use "const" instead of "let" when variables are not reassigned';
+    severity = 'low';
+    category = 'best-practices';
+    autoFixable = true;
+    async check(filePath, content) {
+        const violations = [];
+        // Simple heuristic: Look for 'let' declarations
+        const letPattern = /\blet\s+(\w+)\s*=/g;
+        let match;
+        while ((match = letPattern.exec(content)) !== null) {
+            const variableName = match[1];
+            const pos = this.getPosition(content, match.index);
+            // Check if variable is reassigned later (simple check)
+            const reassignmentPattern = new RegExp(`\\b${variableName}\\s*=`, 'g');
+            const reassignments = content.match(reassignmentPattern);
+            // If only one assignment (the declaration), suggest const
+            if (reassignments && reassignments.length === 1) {
+                violations.push(this.createViolation(filePath, pos.line, pos.column, `Variable "${variableName}" is never reassigned. Use "const" instead of "let".`, `Change "let ${variableName}" to "const ${variableName}"`));
+            }
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=prefer-const.js.map

package/dist/analyzers/best-practices/rules/typescript/prefer-const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-const.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/prefer-const.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,eAAgB,SAAQ,kBAAkB;IAC5C,EAAE,GAAG,cAAc,CAAC;IACpB,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,gEAAgE,CAAC;IAC/E,QAAQ,GAAa,KAAK,CAAC;IAC3B,QAAQ,GAAiB,gBAAgB,CAAC;IAC1C,WAAW,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,gDAAgD;QAChD,MAAM,UAAU,GAAG,oBAAoB,CAAC;QAExC,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEnD,uDAAuD;YACvD,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,MAAM,YAAY,OAAO,EAAE,GAAG,CAAC,CAAC;YACvE,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;YAEzD,0DAA0D;YAC1D,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,aAAa,YAAY,sDAAsD,EAC/E,eAAe,YAAY,eAAe,YAAY,GAAG,CAC1D,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analyzers/best-practices/rules/typescript/prefer-readonly.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Prefer Readonly Rule
+ *
+ * Use readonly for properties that are not modified after initialization
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+import type { Violation, Severity } from '../../../../types/analysis.js';
+import type { RuleCategory } from '../../types.js';
+export declare class PreferReadonlyRule extends BaseValidationRule {
+    readonly id = "prefer-readonly";
+    readonly name = "Prefer Readonly";
+    readonly description = "Use readonly for properties that are not modified after initialization";
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable = true;
+    check(filePath: string, content: string): Promise<Violation[]>;
+}

package/dist/analyzers/best-practices/rules/typescript/prefer-readonly.js

@@ -0,0 +1,34 @@
+/**
+ * Prefer Readonly Rule
+ *
+ * Use readonly for properties that are not modified after initialization
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+export class PreferReadonlyRule extends BaseValidationRule {
+    id = 'prefer-readonly';
+    name = 'Prefer Readonly';
+    description = 'Use readonly for properties that are not modified after initialization';
+    severity = 'low';
+    category = 'type-safety';
+    autoFixable = true;
+    async check(filePath, content) {
+        const violations = [];
+        // Pattern: class properties without readonly
+        const propertyPattern = /^\s*(private|public|protected)\s+(?!readonly)(\w+):/gm;
+        let match;
+        while ((match = propertyPattern.exec(content)) !== null) {
+            const visibility = match[1];
+            const propertyName = match[2];
+            // Check if property is assigned after constructor (simple heuristic)
+            const assignmentPattern = new RegExp(`this\\.${propertyName}\\s*=`, 'g');
+            const assignments = content.match(assignmentPattern);
+            // If only assigned once (likely in constructor), suggest readonly
+            if (assignments && assignments.length === 1) {
+                const pos = this.getPosition(content, match.index);
+                violations.push(this.createViolation(filePath, pos.line, pos.column, `Property "${propertyName}" is never modified. Consider making it readonly.`, `${visibility} readonly ${propertyName}:`));
+            }
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=prefer-readonly.js.map

package/dist/analyzers/best-practices/rules/typescript/prefer-readonly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefer-readonly.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/prefer-readonly.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,kBAAmB,SAAQ,kBAAkB;IAC/C,EAAE,GAAG,iBAAiB,CAAC;IACvB,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,wEAAwE,CAAC;IACvF,QAAQ,GAAa,KAAK,CAAC;IAC3B,QAAQ,GAAiB,aAAa,CAAC;IACvC,WAAW,GAAG,IAAI,CAAC;IAE5B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,6CAA6C;QAC7C,MAAM,eAAe,GAAG,uDAAuD,CAAC;QAEhF,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAE9B,qEAAqE;YACrE,MAAM,iBAAiB,GAAG,IAAI,MAAM,CAAC,UAAU,YAAY,OAAO,EAAE,GAAG,CAAC,CAAC;YACzE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAErD,kEAAkE;YAClE,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;gBAEnD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,aAAa,YAAY,mDAAmD,EAC5E,GAAG,UAAU,aAAa,YAAY,GAAG,CAC1C,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analyzers/best-practices/rules/typescript/proper-error-handling.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Proper Error Handling Rule
+ *
+ * Catch blocks should not be empty and should handle errors properly
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+import type { Violation, Severity } from '../../../../types/analysis.js';
+import type { RuleCategory } from '../../types.js';
+export declare class ProperErrorHandlingRule extends BaseValidationRule {
+    readonly id = "proper-error-handling";
+    readonly name = "Proper Error Handling";
+    readonly description = "Catch blocks should not be empty and should handle errors properly";
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable = false;
+    check(filePath: string, content: string): Promise<Violation[]>;
+}

package/dist/analyzers/best-practices/rules/typescript/proper-error-handling.js

@@ -0,0 +1,27 @@
+/**
+ * Proper Error Handling Rule
+ *
+ * Catch blocks should not be empty and should handle errors properly
+ */
+import { BaseValidationRule } from '../../base-rule.js';
+export class ProperErrorHandlingRule extends BaseValidationRule {
+    id = 'proper-error-handling';
+    name = 'Proper Error Handling';
+    description = 'Catch blocks should not be empty and should handle errors properly';
+    severity = 'high';
+    category = 'code-quality';
+    autoFixable = false;
+    async check(filePath, content) {
+        const violations = [];
+        // Pattern: catch blocks with empty or minimal handling
+        const emptyCatchPattern = /catch\s*\([^)]*\)\s*\{\s*\}/g;
+        let match;
+        // Check for completely empty catch blocks
+        while ((match = emptyCatchPattern.exec(content)) !== null) {
+            const pos = this.getPosition(content, match.index);
+            violations.push(this.createViolation(filePath, pos.line, pos.column, 'Empty catch block. Handle or log the error properly.', 'Add error logging: console.error(error) or rethrow the error'));
+        }
+        return violations;
+    }
+}
+//# sourceMappingURL=proper-error-handling.js.map

package/dist/analyzers/best-practices/rules/typescript/proper-error-handling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proper-error-handling.js","sourceRoot":"","sources":["../../../../../src/analyzers/best-practices/rules/typescript/proper-error-handling.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIxD,MAAM,OAAO,uBAAwB,SAAQ,kBAAkB;IACpD,EAAE,GAAG,uBAAuB,CAAC;IAC7B,IAAI,GAAG,uBAAuB,CAAC;IAC/B,WAAW,GAAG,oEAAoE,CAAC;IACnF,QAAQ,GAAa,MAAM,CAAC;IAC5B,QAAQ,GAAiB,cAAc,CAAC;IACxC,WAAW,GAAG,KAAK,CAAC;IAE7B,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,UAAU,GAAgB,EAAE,CAAC;QAEnC,uDAAuD;QACvD,MAAM,iBAAiB,GAAG,8BAA8B,CAAC;QAEzD,IAAI,KAA6B,CAAC;QAElC,0CAA0C;QAC1C,OAAO,CAAC,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEnD,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,eAAe,CAClB,QAAQ,EACR,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,MAAM,EACV,sDAAsD,EACtD,8DAA8D,CAC/D,CACF,CAAC;QACJ,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/analyzers/best-practices/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Best Practice Validator Types
+ *
+ * Type definitions for validation rules and results
+ */
+import type { Violation, ValidationResult, BatchValidationResult } from '../../types/analysis.js';
+import type { Severity } from '../../types/analysis.js';
+/**
+ * Rule category classification
+ */
+export type RuleCategory = 'type-safety' | 'code-quality' | 'maintainability' | 'performance' | 'security' | 'best-practices';
+/**
+ * Validation rule interface
+ * All rules must implement this interface
+ */
+export interface ValidationRule {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly severity: Severity;
+    readonly category: RuleCategory;
+    readonly autoFixable: boolean;
+    /**
+     * Check a file for violations of this rule
+     */
+    check(filePath: string, content: string): Promise<Violation[]>;
+    /**
+     * Generate automated fix for a violation (if autoFixable)
+     */
+    fix?(violation: Violation, content: string): Promise<ViolationFix | null>;
+}
+/**
+ * Automated fix for a violation
+ */
+export interface ViolationFix {
+    readonly description: string;
+    readonly edits: ReadonlyArray<TextEdit>;
+}
+/**
+ * Text edit for automated fixes
+ */
+export interface TextEdit {
+    readonly range: TextRange;
+    readonly newText: string;
+}
+/**
+ * Text range
+ */
+export interface TextRange {
+    readonly start: Position;
+    readonly end: Position;
+}
+/**
+ * Position in text
+ */
+export interface Position {
+    readonly line: number;
+    readonly column: number;
+}
+/**
+ * Rule configuration
+ */
+export interface RuleConfig {
+    readonly enabled: boolean;
+    readonly severity?: Severity;
+    readonly options?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Validation options
+ */
+export interface ValidationOptions {
+    readonly rules?: Readonly<Record<string, RuleConfig>>;
+    readonly language?: 'typescript' | 'javascript';
+    readonly fix?: boolean;
+}
+/**
+ * Rule registry interface
+ * Manages all available rules
+ */
+export interface RuleRegistry {
+    register(rule: ValidationRule): void;
+    get(id: string): ValidationRule | undefined;
+    getAll(): readonly ValidationRule[];
+    getByCategory(category: RuleCategory): readonly ValidationRule[];
+}
+export type { Violation, ValidationResult, BatchValidationResult };

package/dist/analyzers/best-practices/types.js

@@ -0,0 +1,7 @@
+/**
+ * Best Practice Validator Types
+ *
+ * Type definitions for validation rules and results
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analyzers/best-practices/types.js.map

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

package/dist/analyzers/cache/analysis-cache.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Analysis Cache
+ *
+ * LRU cache for analysis results with TTL and content hash validation.
+ * Prevents re-analyzing unchanged projects.
+ */
+export declare class AnalysisCache<T> {
+    private cache;
+    private readonly ttl;
+    private readonly maxSize;
+    /**
+     * Create new analysis cache
+     * @param ttl Time-to-live in milliseconds (default: 5 minutes)
+     * @param maxSize Maximum number of entries (default: 100)
+     */
+    constructor(ttl?: number, maxSize?: number);
+    /**
+     * Get cached value if it exists and is valid
+     */
+    get(key: string, hash: string): Promise<T | null>;
+    /**
+     * Set cached value
+     */
+    set(key: string, value: T, hash: string): void;
+    /**
+     * Check if key exists in cache (doesn't validate expiration)
+     */
+    has(key: string): boolean;
+    /**
+     * Clear entire cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        ttl: number;
+    };
+}

package/dist/analyzers/cache/analysis-cache.js

@@ -0,0 +1,84 @@
+/**
+ * Analysis Cache
+ *
+ * LRU cache for analysis results with TTL and content hash validation.
+ * Prevents re-analyzing unchanged projects.
+ */
+export class AnalysisCache {
+    cache = new Map();
+    ttl;
+    maxSize;
+    /**
+     * Create new analysis cache
+     * @param ttl Time-to-live in milliseconds (default: 5 minutes)
+     * @param maxSize Maximum number of entries (default: 100)
+     */
+    constructor(ttl = 5 * 60 * 1000, maxSize = 100) {
+        this.ttl = ttl;
+        this.maxSize = maxSize;
+    }
+    /**
+     * Get cached value if it exists and is valid
+     */
+    async get(key, hash) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        if (Date.now() - entry.timestamp > this.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Check if content changed
+        if (entry.hash !== hash) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Move to end (LRU)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /**
+     * Set cached value
+     */
+    set(key, value, hash) {
+        // Implement LRU eviction if cache is full
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            // Remove oldest entry (first in map)
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(key, {
+            value,
+            timestamp: Date.now(),
+            hash,
+        });
+    }
+    /**
+     * Check if key exists in cache (doesn't validate expiration)
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+    /**
+     * Clear entire cache
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            ttl: this.ttl,
+        };
+    }
+}
+//# sourceMappingURL=analysis-cache.js.map

package/dist/analyzers/cache/analysis-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-cache.js","sourceRoot":"","sources":["../../../src/analyzers/cache/analysis-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,OAAO,aAAa;IAChB,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAChC,GAAG,CAAS;IACZ,OAAO,CAAS;IAEjC;;;;OAIG;IACH,YAAY,MAAc,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,UAAkB,GAAG;QAC5D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,IAAY;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mBAAmB;QACnB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,2BAA2B;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE3B,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,IAAY;QACrC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5D,qCAAqC;YACrC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/analyzers/errors.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Analysis Error Classes
+ *
+ * Structured error hierarchy for analysis operations.
+ * All errors extend from AnalysisError base class and include context information.
+ */
+/**
+ * Base error class for all analysis errors
+ */
+export declare abstract class AnalysisError extends Error {
+    readonly code: string;
+    readonly context?: Readonly<Record<string, unknown>> | undefined;
+    constructor(message: string, code: string, context?: Readonly<Record<string, unknown>> | undefined);
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when project structure cannot be analyzed
+ */
+export declare class ProjectStructureError extends AnalysisError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when a file cannot be parsed or read
+ */
+export declare class FileParseError extends AnalysisError {
+    readonly filePath: string;
+    constructor(message: string, filePath: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends AnalysisError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when analysis exceeds timeout
+ */
+export declare class AnalysisTimeoutError extends AnalysisError {
+    readonly timeoutMs: number;
+    constructor(message: string, timeoutMs: number, context?: Record<string, unknown>);
+}
+/**
+ * Error thrown when pattern detection fails
+ */
+export declare class PatternDetectionError extends AnalysisError {
+    readonly patternName: string;
+    constructor(message: string, patternName: string, context?: Record<string, unknown>);
+}

package/dist/analyzers/errors.js

@@ -0,0 +1,79 @@
+/**
+ * Analysis Error Classes
+ *
+ * Structured error hierarchy for analysis operations.
+ * All errors extend from AnalysisError base class and include context information.
+ */
+/**
+ * Base error class for all analysis errors
+ */
+export class AnalysisError extends Error {
+    code;
+    context;
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = this.constructor.name;
+        Error.captureStackTrace(this, this.constructor);
+    }
+    /**
+     * Convert error to JSON for logging/serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            stack: this.stack,
+        };
+    }
+}
+/**
+ * Error thrown when project structure cannot be analyzed
+ */
+export class ProjectStructureError extends AnalysisError {
+    constructor(message, context) {
+        super(message, 'PROJECT_STRUCTURE_ERROR', context);
+    }
+}
+/**
+ * Error thrown when a file cannot be parsed or read
+ */
+export class FileParseError extends AnalysisError {
+    filePath;
+    constructor(message, filePath, context) {
+        super(message, 'FILE_PARSE_ERROR', { ...context, filePath });
+        this.filePath = filePath;
+    }
+}
+/**
+ * Error thrown when validation fails
+ */
+export class ValidationError extends AnalysisError {
+    constructor(message, context) {
+        super(message, 'VALIDATION_ERROR', context);
+    }
+}
+/**
+ * Error thrown when analysis exceeds timeout
+ */
+export class AnalysisTimeoutError extends AnalysisError {
+    timeoutMs;
+    constructor(message, timeoutMs, context) {
+        super(message, 'ANALYSIS_TIMEOUT', { ...context, timeoutMs });
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Error thrown when pattern detection fails
+ */
+export class PatternDetectionError extends AnalysisError {
+    patternName;
+    constructor(message, patternName, context) {
+        super(message, 'PATTERN_DETECTION_ERROR', { ...context, patternName });
+        this.patternName = patternName;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/analyzers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/analyzers/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAgB,aAAc,SAAQ,KAAK;IAG7B;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,OAA2C;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAoC;QAG3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,yBAAyB,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAG7B;IAFlB,YACE,OAAe,EACC,QAAgB,EAChC,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAH7C,aAAQ,GAAR,QAAQ,CAAQ;IAIlC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IAGnC;IAFlB,YACE,OAAe,EACC,SAAiB,EACjC,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAH9C,cAAS,GAAT,SAAS,CAAQ;IAInC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IAGpC;IAFlB,YACE,OAAe,EACC,WAAmB,EACnC,OAAiC;QAEjC,KAAK,CAAC,OAAO,EAAE,yBAAyB,EAAE,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAHvD,gBAAW,GAAX,WAAW,CAAQ;IAIrC,CAAC;CACF"}