eff-u-code 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (245) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +256 -0
  3. package/bin/fuck-u-code-mcp.js +2 -0
  4. package/bin/fuck-u-code.js +2 -0
  5. package/bin/postinstall.js +53 -0
  6. package/dist/ai/index.d.ts +34 -0
  7. package/dist/ai/index.d.ts.map +1 -0
  8. package/dist/ai/index.js +227 -0
  9. package/dist/ai/index.js.map +1 -0
  10. package/dist/ai/prompts/code-review.d.ts +9 -0
  11. package/dist/ai/prompts/code-review.d.ts.map +1 -0
  12. package/dist/ai/prompts/code-review.js +61 -0
  13. package/dist/ai/prompts/code-review.js.map +1 -0
  14. package/dist/ai/providers/anthropic.d.ts +11 -0
  15. package/dist/ai/providers/anthropic.d.ts.map +1 -0
  16. package/dist/ai/providers/anthropic.js +60 -0
  17. package/dist/ai/providers/anthropic.js.map +1 -0
  18. package/dist/ai/providers/fetch.d.ts +10 -0
  19. package/dist/ai/providers/fetch.d.ts.map +1 -0
  20. package/dist/ai/providers/fetch.js +50 -0
  21. package/dist/ai/providers/fetch.js.map +1 -0
  22. package/dist/ai/providers/gemini.d.ts +12 -0
  23. package/dist/ai/providers/gemini.d.ts.map +1 -0
  24. package/dist/ai/providers/gemini.js +66 -0
  25. package/dist/ai/providers/gemini.js.map +1 -0
  26. package/dist/ai/providers/ollama.d.ts +11 -0
  27. package/dist/ai/providers/ollama.d.ts.map +1 -0
  28. package/dist/ai/providers/ollama.js +54 -0
  29. package/dist/ai/providers/ollama.js.map +1 -0
  30. package/dist/ai/providers/openai.d.ts +11 -0
  31. package/dist/ai/providers/openai.d.ts.map +1 -0
  32. package/dist/ai/providers/openai.js +52 -0
  33. package/dist/ai/providers/openai.js.map +1 -0
  34. package/dist/ai/selector.d.ts +19 -0
  35. package/dist/ai/selector.d.ts.map +1 -0
  36. package/dist/ai/selector.js +145 -0
  37. package/dist/ai/selector.js.map +1 -0
  38. package/dist/ai/types.d.ts +120 -0
  39. package/dist/ai/types.d.ts.map +1 -0
  40. package/dist/ai/types.js +6 -0
  41. package/dist/ai/types.js.map +1 -0
  42. package/dist/analyzer/concurrent-analyzer.d.ts +11 -0
  43. package/dist/analyzer/concurrent-analyzer.d.ts.map +1 -0
  44. package/dist/analyzer/concurrent-analyzer.js +67 -0
  45. package/dist/analyzer/concurrent-analyzer.js.map +1 -0
  46. package/dist/analyzer/file-discovery.d.ts +23 -0
  47. package/dist/analyzer/file-discovery.d.ts.map +1 -0
  48. package/dist/analyzer/file-discovery.js +64 -0
  49. package/dist/analyzer/file-discovery.js.map +1 -0
  50. package/dist/analyzer/index.d.ts +27 -0
  51. package/dist/analyzer/index.d.ts.map +1 -0
  52. package/dist/analyzer/index.js +64 -0
  53. package/dist/analyzer/index.js.map +1 -0
  54. package/dist/cli/commands/ai-review.d.ts +6 -0
  55. package/dist/cli/commands/ai-review.d.ts.map +1 -0
  56. package/dist/cli/commands/ai-review.js +213 -0
  57. package/dist/cli/commands/ai-review.js.map +1 -0
  58. package/dist/cli/commands/analyze.d.ts +6 -0
  59. package/dist/cli/commands/analyze.d.ts.map +1 -0
  60. package/dist/cli/commands/analyze.js +145 -0
  61. package/dist/cli/commands/analyze.js.map +1 -0
  62. package/dist/cli/commands/config.d.ts +6 -0
  63. package/dist/cli/commands/config.d.ts.map +1 -0
  64. package/dist/cli/commands/config.js +147 -0
  65. package/dist/cli/commands/config.js.map +1 -0
  66. package/dist/cli/commands/mcp-install.d.ts +9 -0
  67. package/dist/cli/commands/mcp-install.d.ts.map +1 -0
  68. package/dist/cli/commands/mcp-install.js +102 -0
  69. package/dist/cli/commands/mcp-install.js.map +1 -0
  70. package/dist/cli/index.d.ts +7 -0
  71. package/dist/cli/index.d.ts.map +1 -0
  72. package/dist/cli/index.js +69 -0
  73. package/dist/cli/index.js.map +1 -0
  74. package/dist/cli/output/ai-review-output.d.ts +20 -0
  75. package/dist/cli/output/ai-review-output.d.ts.map +1 -0
  76. package/dist/cli/output/ai-review-output.js +324 -0
  77. package/dist/cli/output/ai-review-output.js.map +1 -0
  78. package/dist/cli/output/console.d.ts +31 -0
  79. package/dist/cli/output/console.d.ts.map +1 -0
  80. package/dist/cli/output/console.js +571 -0
  81. package/dist/cli/output/console.js.map +1 -0
  82. package/dist/cli/output/html.d.ts +20 -0
  83. package/dist/cli/output/html.d.ts.map +1 -0
  84. package/dist/cli/output/html.js +339 -0
  85. package/dist/cli/output/html.js.map +1 -0
  86. package/dist/cli/output/json.d.ts +8 -0
  87. package/dist/cli/output/json.d.ts.map +1 -0
  88. package/dist/cli/output/json.js +46 -0
  89. package/dist/cli/output/json.js.map +1 -0
  90. package/dist/cli/output/markdown.d.ts +17 -0
  91. package/dist/cli/output/markdown.d.ts.map +1 -0
  92. package/dist/cli/output/markdown.js +323 -0
  93. package/dist/cli/output/markdown.js.map +1 -0
  94. package/dist/cli/output/stats.d.ts +35 -0
  95. package/dist/cli/output/stats.d.ts.map +1 -0
  96. package/dist/cli/output/stats.js +63 -0
  97. package/dist/cli/output/stats.js.map +1 -0
  98. package/dist/cli/output/terminal-markdown.d.ts +23 -0
  99. package/dist/cli/output/terminal-markdown.d.ts.map +1 -0
  100. package/dist/cli/output/terminal-markdown.js +159 -0
  101. package/dist/cli/output/terminal-markdown.js.map +1 -0
  102. package/dist/config/index.d.ts +27 -0
  103. package/dist/config/index.d.ts.map +1 -0
  104. package/dist/config/index.js +266 -0
  105. package/dist/config/index.js.map +1 -0
  106. package/dist/config/schema.d.ts +179 -0
  107. package/dist/config/schema.d.ts.map +1 -0
  108. package/dist/config/schema.js +85 -0
  109. package/dist/config/schema.js.map +1 -0
  110. package/dist/gitignore/index.d.ts +5 -0
  111. package/dist/gitignore/index.d.ts.map +1 -0
  112. package/dist/gitignore/index.js +5 -0
  113. package/dist/gitignore/index.js.map +1 -0
  114. package/dist/gitignore/parser.d.ts +32 -0
  115. package/dist/gitignore/parser.d.ts.map +1 -0
  116. package/dist/gitignore/parser.js +110 -0
  117. package/dist/gitignore/parser.js.map +1 -0
  118. package/dist/gitignore/parser.test.d.ts +2 -0
  119. package/dist/gitignore/parser.test.d.ts.map +1 -0
  120. package/dist/gitignore/parser.test.js +217 -0
  121. package/dist/gitignore/parser.test.js.map +1 -0
  122. package/dist/i18n/index.d.ts +19 -0
  123. package/dist/i18n/index.d.ts.map +1 -0
  124. package/dist/i18n/index.js +43 -0
  125. package/dist/i18n/index.js.map +1 -0
  126. package/dist/i18n/locales/en.json +320 -0
  127. package/dist/i18n/locales/ru.json +320 -0
  128. package/dist/i18n/locales/zh.json +320 -0
  129. package/dist/index.d.ts +5 -0
  130. package/dist/index.d.ts.map +1 -0
  131. package/dist/index.js +10 -0
  132. package/dist/index.js.map +1 -0
  133. package/dist/mcp/server.d.ts +9 -0
  134. package/dist/mcp/server.d.ts.map +1 -0
  135. package/dist/mcp/server.js +156 -0
  136. package/dist/mcp/server.js.map +1 -0
  137. package/dist/metrics/complexity/cognitive.d.ts +25 -0
  138. package/dist/metrics/complexity/cognitive.d.ts.map +1 -0
  139. package/dist/metrics/complexity/cognitive.js +109 -0
  140. package/dist/metrics/complexity/cognitive.js.map +1 -0
  141. package/dist/metrics/complexity/cyclomatic.d.ts +21 -0
  142. package/dist/metrics/complexity/cyclomatic.d.ts.map +1 -0
  143. package/dist/metrics/complexity/cyclomatic.js +111 -0
  144. package/dist/metrics/complexity/cyclomatic.js.map +1 -0
  145. package/dist/metrics/complexity/nesting-depth.d.ts +19 -0
  146. package/dist/metrics/complexity/nesting-depth.d.ts.map +1 -0
  147. package/dist/metrics/complexity/nesting-depth.js +97 -0
  148. package/dist/metrics/complexity/nesting-depth.js.map +1 -0
  149. package/dist/metrics/documentation/comment-ratio.d.ts +21 -0
  150. package/dist/metrics/documentation/comment-ratio.d.ts.map +1 -0
  151. package/dist/metrics/documentation/comment-ratio.js +91 -0
  152. package/dist/metrics/documentation/comment-ratio.js.map +1 -0
  153. package/dist/metrics/duplication/code-duplication.d.ts +24 -0
  154. package/dist/metrics/duplication/code-duplication.d.ts.map +1 -0
  155. package/dist/metrics/duplication/code-duplication.js +167 -0
  156. package/dist/metrics/duplication/code-duplication.js.map +1 -0
  157. package/dist/metrics/duplication/code-duplication.test.d.ts +2 -0
  158. package/dist/metrics/duplication/code-duplication.test.d.ts.map +1 -0
  159. package/dist/metrics/duplication/code-duplication.test.js +612 -0
  160. package/dist/metrics/duplication/code-duplication.test.js.map +1 -0
  161. package/dist/metrics/error/error-handling.d.ts +23 -0
  162. package/dist/metrics/error/error-handling.d.ts.map +1 -0
  163. package/dist/metrics/error/error-handling.js +164 -0
  164. package/dist/metrics/error/error-handling.js.map +1 -0
  165. package/dist/metrics/error/error-handling.test.d.ts +2 -0
  166. package/dist/metrics/error/error-handling.test.d.ts.map +1 -0
  167. package/dist/metrics/error/error-handling.test.js +349 -0
  168. package/dist/metrics/error/error-handling.test.js.map +1 -0
  169. package/dist/metrics/index.d.ts +21 -0
  170. package/dist/metrics/index.d.ts.map +1 -0
  171. package/dist/metrics/index.js +50 -0
  172. package/dist/metrics/index.js.map +1 -0
  173. package/dist/metrics/naming/convention.d.ts +22 -0
  174. package/dist/metrics/naming/convention.d.ts.map +1 -0
  175. package/dist/metrics/naming/convention.js +117 -0
  176. package/dist/metrics/naming/convention.js.map +1 -0
  177. package/dist/metrics/size/file-length.d.ts +19 -0
  178. package/dist/metrics/size/file-length.d.ts.map +1 -0
  179. package/dist/metrics/size/file-length.js +68 -0
  180. package/dist/metrics/size/file-length.js.map +1 -0
  181. package/dist/metrics/size/function-length.d.ts +20 -0
  182. package/dist/metrics/size/function-length.d.ts.map +1 -0
  183. package/dist/metrics/size/function-length.js +101 -0
  184. package/dist/metrics/size/function-length.js.map +1 -0
  185. package/dist/metrics/size/parameter-count.d.ts +19 -0
  186. package/dist/metrics/size/parameter-count.d.ts.map +1 -0
  187. package/dist/metrics/size/parameter-count.js +97 -0
  188. package/dist/metrics/size/parameter-count.js.map +1 -0
  189. package/dist/metrics/structure/structure-analysis.d.ts +24 -0
  190. package/dist/metrics/structure/structure-analysis.d.ts.map +1 -0
  191. package/dist/metrics/structure/structure-analysis.js +223 -0
  192. package/dist/metrics/structure/structure-analysis.js.map +1 -0
  193. package/dist/metrics/structure/structure-analysis.test.d.ts +2 -0
  194. package/dist/metrics/structure/structure-analysis.test.d.ts.map +1 -0
  195. package/dist/metrics/structure/structure-analysis.test.js +342 -0
  196. package/dist/metrics/structure/structure-analysis.test.js.map +1 -0
  197. package/dist/metrics/types.d.ts +71 -0
  198. package/dist/metrics/types.d.ts.map +1 -0
  199. package/dist/metrics/types.js +5 -0
  200. package/dist/metrics/types.js.map +1 -0
  201. package/dist/parser/generic-parser.d.ts +28 -0
  202. package/dist/parser/generic-parser.d.ts.map +1 -0
  203. package/dist/parser/generic-parser.js +218 -0
  204. package/dist/parser/generic-parser.js.map +1 -0
  205. package/dist/parser/index.d.ts +19 -0
  206. package/dist/parser/index.d.ts.map +1 -0
  207. package/dist/parser/index.js +52 -0
  208. package/dist/parser/index.js.map +1 -0
  209. package/dist/parser/regex-parser.d.ts +46 -0
  210. package/dist/parser/regex-parser.d.ts.map +1 -0
  211. package/dist/parser/regex-parser.js +560 -0
  212. package/dist/parser/regex-parser.js.map +1 -0
  213. package/dist/parser/tree-sitter-parser.d.ts +50 -0
  214. package/dist/parser/tree-sitter-parser.d.ts.map +1 -0
  215. package/dist/parser/tree-sitter-parser.js +707 -0
  216. package/dist/parser/tree-sitter-parser.js.map +1 -0
  217. package/dist/parser/types.d.ts +52 -0
  218. package/dist/parser/types.d.ts.map +1 -0
  219. package/dist/parser/types.js +49 -0
  220. package/dist/parser/types.js.map +1 -0
  221. package/dist/scoring/index.d.ts +14 -0
  222. package/dist/scoring/index.d.ts.map +1 -0
  223. package/dist/scoring/index.js +80 -0
  224. package/dist/scoring/index.js.map +1 -0
  225. package/dist/utils/fs.d.ts +24 -0
  226. package/dist/utils/fs.d.ts.map +1 -0
  227. package/dist/utils/fs.js +61 -0
  228. package/dist/utils/fs.js.map +1 -0
  229. package/dist/utils/logger.d.ts +13 -0
  230. package/dist/utils/logger.d.ts.map +1 -0
  231. package/dist/utils/logger.js +43 -0
  232. package/dist/utils/logger.js.map +1 -0
  233. package/dist/utils/markdown.d.ts +16 -0
  234. package/dist/utils/markdown.d.ts.map +1 -0
  235. package/dist/utils/markdown.js +303 -0
  236. package/dist/utils/markdown.js.map +1 -0
  237. package/dist/utils/progress.d.ts +24 -0
  238. package/dist/utils/progress.d.ts.map +1 -0
  239. package/dist/utils/progress.js +79 -0
  240. package/dist/utils/progress.js.map +1 -0
  241. package/dist/utils/terminal.d.ts +62 -0
  242. package/dist/utils/terminal.d.ts.map +1 -0
  243. package/dist/utils/terminal.js +207 -0
  244. package/dist/utils/terminal.js.map +1 -0
  245. package/package.json +77 -0
@@ -0,0 +1,109 @@
1
+ /**
2
+ * Cognitive complexity metric
3
+ *
4
+ * Measures how difficult code is to understand (SonarSource standard).
5
+ * Unlike cyclomatic complexity, cognitive complexity penalizes:
6
+ * - Nested control flow structures (exponential penalty)
7
+ * - Breaks in linear flow (continue, break, goto)
8
+ * - Recursion
9
+ *
10
+ * Industry thresholds (SonarQube):
11
+ * - 0-8: Low cognitive load
12
+ * - 9-15: Moderate cognitive load
13
+ * - 16-25: High cognitive load
14
+ * - 25+: Very high cognitive load
15
+ */
16
+ import { t } from '../../i18n/index.js';
17
+ const THRESHOLDS = {
18
+ EXCELLENT: 8,
19
+ GOOD: 15,
20
+ ACCEPTABLE: 25,
21
+ POOR: 40,
22
+ };
23
+ export class CognitiveComplexityMetric {
24
+ name = 'cognitive_complexity';
25
+ category = 'complexity';
26
+ weight;
27
+ constructor(weight) {
28
+ this.weight = weight;
29
+ }
30
+ calculate(parseResult) {
31
+ const { functions, filePath } = parseResult;
32
+ if (functions.length === 0) {
33
+ return {
34
+ name: this.name,
35
+ category: this.category,
36
+ value: 0,
37
+ normalizedScore: 100,
38
+ severity: 'info',
39
+ details: t('detail_no_functions'),
40
+ };
41
+ }
42
+ // Calculate cognitive complexity for each function
43
+ // Cognitive = base complexity + nesting penalty (nesting depth * 2)
44
+ let totalCognitive = 0;
45
+ let maxCognitive = 0;
46
+ const locations = [];
47
+ for (const func of functions) {
48
+ const cognitive = func.complexity + func.nestingDepth * 2;
49
+ totalCognitive += cognitive;
50
+ if (cognitive > maxCognitive) {
51
+ maxCognitive = cognitive;
52
+ }
53
+ if (cognitive > THRESHOLDS.GOOD) {
54
+ locations.push({
55
+ filePath,
56
+ line: func.startLine,
57
+ functionName: func.name,
58
+ message: `${t('metric_cognitive_complexity')}: ${cognitive}`,
59
+ });
60
+ }
61
+ }
62
+ const avgCognitive = totalCognitive / functions.length;
63
+ // Non-linear scoring curve
64
+ let normalizedScore;
65
+ if (avgCognitive <= THRESHOLDS.EXCELLENT) {
66
+ normalizedScore = 100;
67
+ }
68
+ else if (avgCognitive <= THRESHOLDS.GOOD) {
69
+ normalizedScore =
70
+ 100 -
71
+ ((avgCognitive - THRESHOLDS.EXCELLENT) / (THRESHOLDS.GOOD - THRESHOLDS.EXCELLENT)) * 20;
72
+ }
73
+ else if (avgCognitive <= THRESHOLDS.ACCEPTABLE) {
74
+ normalizedScore =
75
+ 80 - ((avgCognitive - THRESHOLDS.GOOD) / (THRESHOLDS.ACCEPTABLE - THRESHOLDS.GOOD)) * 35;
76
+ }
77
+ else if (avgCognitive <= THRESHOLDS.POOR) {
78
+ normalizedScore =
79
+ 45 -
80
+ ((avgCognitive - THRESHOLDS.ACCEPTABLE) / (THRESHOLDS.POOR - THRESHOLDS.ACCEPTABLE)) * 30;
81
+ }
82
+ else {
83
+ normalizedScore = Math.max(0, 15 * Math.exp(-(avgCognitive - THRESHOLDS.POOR) / 15));
84
+ }
85
+ let severity;
86
+ if (maxCognitive <= THRESHOLDS.GOOD) {
87
+ severity = 'info';
88
+ }
89
+ else if (maxCognitive <= THRESHOLDS.ACCEPTABLE) {
90
+ severity = 'warning';
91
+ }
92
+ else if (maxCognitive <= THRESHOLDS.POOR) {
93
+ severity = 'error';
94
+ }
95
+ else {
96
+ severity = 'critical';
97
+ }
98
+ return {
99
+ name: this.name,
100
+ category: this.category,
101
+ value: avgCognitive,
102
+ normalizedScore: Math.round(normalizedScore * 10) / 10,
103
+ severity,
104
+ details: t('detail_avg_max', { avg: avgCognitive.toFixed(1), max: String(maxCognitive) }),
105
+ locations: locations.length > 0 ? locations : undefined,
106
+ };
107
+ }
108
+ }
109
+ //# sourceMappingURL=cognitive.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cognitive.js","sourceRoot":"","sources":["../../../src/metrics/complexity/cognitive.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Cyclomatic complexity metric
3
+ *
4
+ * Industry standard thresholds (based on SonarQube, ESLint, CodeClimate):
5
+ * - 1-10: Low complexity, easy to test and maintain
6
+ * - 11-20: Moderate complexity, consider refactoring
7
+ * - 21-50: High complexity, should be refactored
8
+ * - 50+: Very high complexity, must be refactored
9
+ *
10
+ * Formula: CC = 1 + (if) + (loops) + (case) + (catch) + (&&/||) + (ternary)
11
+ */
12
+ import type { Metric, MetricResult, MetricCategory } from '../types.js';
13
+ import type { ParseResult } from '../../parser/types.js';
14
+ export declare class CyclomaticComplexityMetric implements Metric {
15
+ readonly name = "cyclomatic_complexity";
16
+ readonly category: MetricCategory;
17
+ readonly weight: number;
18
+ constructor(weight: number);
19
+ calculate(parseResult: ParseResult): MetricResult;
20
+ }
21
+ //# sourceMappingURL=cyclomatic.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cyclomatic.d.ts","sourceRoot":"","sources":["../../../src/metrics/complexity/cyclomatic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,qBAAa,0BAA2B,YAAW,MAAM;IACvD,QAAQ,CAAC,IAAI,2BAA2B;IACxC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAgB;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY;CAmFlD"}
@@ -0,0 +1,111 @@
1
+ /**
2
+ * Cyclomatic complexity metric
3
+ *
4
+ * Industry standard thresholds (based on SonarQube, ESLint, CodeClimate):
5
+ * - 1-10: Low complexity, easy to test and maintain
6
+ * - 11-20: Moderate complexity, consider refactoring
7
+ * - 21-50: High complexity, should be refactored
8
+ * - 50+: Very high complexity, must be refactored
9
+ *
10
+ * Formula: CC = 1 + (if) + (loops) + (case) + (catch) + (&&/||) + (ternary)
11
+ */
12
+ import { t } from '../../i18n/index.js';
13
+ // Industry-standard thresholds (SonarQube defaults)
14
+ const THRESHOLDS = {
15
+ EXCELLENT: 5,
16
+ GOOD: 10,
17
+ ACCEPTABLE: 20,
18
+ POOR: 30,
19
+ };
20
+ export class CyclomaticComplexityMetric {
21
+ name = 'cyclomatic_complexity';
22
+ category = 'complexity';
23
+ weight;
24
+ constructor(weight) {
25
+ this.weight = weight;
26
+ }
27
+ calculate(parseResult) {
28
+ const { functions, filePath } = parseResult;
29
+ if (functions.length === 0) {
30
+ return {
31
+ name: this.name,
32
+ category: this.category,
33
+ value: 1,
34
+ normalizedScore: 100,
35
+ severity: 'info',
36
+ details: t('detail_no_functions'),
37
+ };
38
+ }
39
+ // Calculate complexity statistics
40
+ let totalComplexity = 0;
41
+ let maxComplexity = 0;
42
+ const locations = [];
43
+ for (const func of functions) {
44
+ totalComplexity += func.complexity;
45
+ if (func.complexity > maxComplexity) {
46
+ maxComplexity = func.complexity;
47
+ }
48
+ // Flag functions exceeding acceptable threshold
49
+ if (func.complexity > THRESHOLDS.GOOD) {
50
+ locations.push({
51
+ filePath,
52
+ line: func.startLine,
53
+ functionName: func.name,
54
+ message: `${t('complexity')}: ${func.complexity}`,
55
+ });
56
+ }
57
+ }
58
+ const avgComplexity = totalComplexity / functions.length;
59
+ // Calculate normalized score using non-linear curve
60
+ // Score decreases more rapidly as complexity increases
61
+ let normalizedScore;
62
+ if (avgComplexity <= THRESHOLDS.EXCELLENT) {
63
+ normalizedScore = 100;
64
+ }
65
+ else if (avgComplexity <= THRESHOLDS.GOOD) {
66
+ // Linear decrease from 100 to 80
67
+ normalizedScore =
68
+ 100 -
69
+ ((avgComplexity - THRESHOLDS.EXCELLENT) / (THRESHOLDS.GOOD - THRESHOLDS.EXCELLENT)) * 20;
70
+ }
71
+ else if (avgComplexity <= THRESHOLDS.ACCEPTABLE) {
72
+ // Steeper decrease from 80 to 50
73
+ normalizedScore =
74
+ 80 - ((avgComplexity - THRESHOLDS.GOOD) / (THRESHOLDS.ACCEPTABLE - THRESHOLDS.GOOD)) * 30;
75
+ }
76
+ else if (avgComplexity <= THRESHOLDS.POOR) {
77
+ // Even steeper decrease from 50 to 20
78
+ normalizedScore =
79
+ 50 -
80
+ ((avgComplexity - THRESHOLDS.ACCEPTABLE) / (THRESHOLDS.POOR - THRESHOLDS.ACCEPTABLE)) * 30;
81
+ }
82
+ else {
83
+ // Exponential decay for very high complexity
84
+ normalizedScore = Math.max(0, 20 * Math.exp(-(avgComplexity - THRESHOLDS.POOR) / 20));
85
+ }
86
+ // Determine severity based on max complexity (worst case matters)
87
+ let severity;
88
+ if (maxComplexity <= THRESHOLDS.GOOD) {
89
+ severity = 'info';
90
+ }
91
+ else if (maxComplexity <= THRESHOLDS.ACCEPTABLE) {
92
+ severity = 'warning';
93
+ }
94
+ else if (maxComplexity <= THRESHOLDS.POOR) {
95
+ severity = 'error';
96
+ }
97
+ else {
98
+ severity = 'critical';
99
+ }
100
+ return {
101
+ name: this.name,
102
+ category: this.category,
103
+ value: avgComplexity,
104
+ normalizedScore: Math.round(normalizedScore * 10) / 10,
105
+ severity,
106
+ details: t('detail_avg_max', { avg: avgComplexity.toFixed(1), max: String(maxComplexity) }),
107
+ locations: locations.length > 0 ? locations : undefined,
108
+ };
109
+ }
110
+ }
111
+ //# sourceMappingURL=cyclomatic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cyclomatic.js","sourceRoot":"","sources":["../../../src/metrics/complexity/cyclomatic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,qBAAqB,CAAC;AAExC,oDAAoD;AACpD,MAAM,UAAU,GAAG;IACjB,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,EAAE;IACd,IAAI,EAAE,EAAE;CACA,CAAC;AAEX,MAAM,OAAO,0BAA0B;IAC5B,IAAI,GAAG,uBAAuB,CAAC;IAC/B,QAAQ,GAAmB,YAAY,CAAC;IACxC,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,SAAS,CAAC,WAAwB;QAChC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QAE5C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,CAAC;gBACR,eAAe,EAAE,GAAG;gBACpB,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,qBAAqB,CAAC;aAClC,CAAC;QACJ,CAAC;QAED,kCAAkC;QAClC,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,SAAS,GAAqB,EAAE,CAAC;QAEvC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,eAAe,IAAI,IAAI,CAAC,UAAU,CAAC;YACnC,IAAI,IAAI,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;gBACpC,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC;YAClC,CAAC;YACD,gDAAgD;YAChD,IAAI,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;gBACtC,SAAS,CAAC,IAAI,CAAC;oBACb,QAAQ;oBACR,IAAI,EAAE,IAAI,CAAC,SAAS;oBACpB,YAAY,EAAE,IAAI,CAAC,IAAI;oBACvB,OAAO,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC,UAAU,EAAE;iBAClD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,aAAa,GAAG,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC;QAEzD,oDAAoD;QACpD,uDAAuD;QACvD,IAAI,eAAuB,CAAC;QAC5B,IAAI,aAAa,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YAC1C,eAAe,GAAG,GAAG,CAAC;QACxB,CAAC;aAAM,IAAI,aAAa,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5C,iCAAiC;YACjC,eAAe;gBACb,GAAG;oBACH,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;QAC7F,CAAC;aAAM,IAAI,aAAa,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAClD,iCAAiC;YACjC,eAAe;gBACb,EAAE,GAAG,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QAC9F,CAAC;aAAM,IAAI,aAAa,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5C,sCAAsC;YACtC,eAAe;gBACb,EAAE;oBACF,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,kEAAkE;QAClE,IAAI,QAAkB,CAAC;QACvB,IAAI,aAAa,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YACrC,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;aAAM,IAAI,aAAa,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAClD,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,IAAI,aAAa,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5C,QAAQ,GAAG,OAAO,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,UAAU,CAAC;QACxB,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,aAAa;YACpB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC,GAAG,EAAE;YACtD,QAAQ;YACR,OAAO,EAAE,CAAC,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3F,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;SACxD,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Nesting depth metric
3
+ *
4
+ * Industry thresholds:
5
+ * - 1-3: Excellent, easy to follow
6
+ * - 4-5: Good, acceptable
7
+ * - 6-7: Moderate, consider refactoring
8
+ * - 8+: Poor, must be refactored
9
+ */
10
+ import type { Metric, MetricResult, MetricCategory } from '../types.js';
11
+ import type { ParseResult } from '../../parser/types.js';
12
+ export declare class NestingDepthMetric implements Metric {
13
+ readonly name = "nesting_depth";
14
+ readonly category: MetricCategory;
15
+ readonly weight: number;
16
+ constructor(weight: number);
17
+ calculate(parseResult: ParseResult): MetricResult;
18
+ }
19
+ //# sourceMappingURL=nesting-depth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nesting-depth.d.ts","sourceRoot":"","sources":["../../../src/metrics/complexity/nesting-depth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUzD,qBAAa,kBAAmB,YAAW,MAAM;IAC/C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAgB;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY;CAwElD"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Nesting depth metric
3
+ *
4
+ * Industry thresholds:
5
+ * - 1-3: Excellent, easy to follow
6
+ * - 4-5: Good, acceptable
7
+ * - 6-7: Moderate, consider refactoring
8
+ * - 8+: Poor, must be refactored
9
+ */
10
+ import { t } from '../../i18n/index.js';
11
+ const THRESHOLDS = {
12
+ EXCELLENT: 3,
13
+ GOOD: 5,
14
+ ACCEPTABLE: 7,
15
+ POOR: 10,
16
+ };
17
+ export class NestingDepthMetric {
18
+ name = 'nesting_depth';
19
+ category = 'complexity';
20
+ weight;
21
+ constructor(weight) {
22
+ this.weight = weight;
23
+ }
24
+ calculate(parseResult) {
25
+ const { functions, filePath } = parseResult;
26
+ if (functions.length === 0) {
27
+ return {
28
+ name: this.name,
29
+ category: this.category,
30
+ value: 0,
31
+ normalizedScore: 100,
32
+ severity: 'info',
33
+ details: t('detail_no_functions'),
34
+ };
35
+ }
36
+ let totalDepth = 0;
37
+ let maxDepth = 0;
38
+ const locations = [];
39
+ for (const func of functions) {
40
+ totalDepth += func.nestingDepth;
41
+ if (func.nestingDepth > maxDepth) {
42
+ maxDepth = func.nestingDepth;
43
+ }
44
+ if (func.nestingDepth > THRESHOLDS.EXCELLENT) {
45
+ locations.push({
46
+ filePath,
47
+ line: func.startLine,
48
+ functionName: func.name,
49
+ message: `${t('metric_nesting_depth')}: ${func.nestingDepth}`,
50
+ });
51
+ }
52
+ }
53
+ const avgDepth = totalDepth / functions.length;
54
+ let normalizedScore;
55
+ if (maxDepth <= THRESHOLDS.EXCELLENT) {
56
+ normalizedScore = 100;
57
+ }
58
+ else if (maxDepth <= THRESHOLDS.GOOD) {
59
+ normalizedScore =
60
+ 100 - ((maxDepth - THRESHOLDS.EXCELLENT) / (THRESHOLDS.GOOD - THRESHOLDS.EXCELLENT)) * 20;
61
+ }
62
+ else if (maxDepth <= THRESHOLDS.ACCEPTABLE) {
63
+ normalizedScore =
64
+ 80 - ((maxDepth - THRESHOLDS.GOOD) / (THRESHOLDS.ACCEPTABLE - THRESHOLDS.GOOD)) * 35;
65
+ }
66
+ else if (maxDepth <= THRESHOLDS.POOR) {
67
+ normalizedScore =
68
+ 45 - ((maxDepth - THRESHOLDS.ACCEPTABLE) / (THRESHOLDS.POOR - THRESHOLDS.ACCEPTABLE)) * 30;
69
+ }
70
+ else {
71
+ normalizedScore = Math.max(0, 15 * Math.exp(-(maxDepth - THRESHOLDS.POOR) / 3));
72
+ }
73
+ let severity;
74
+ if (maxDepth <= THRESHOLDS.EXCELLENT) {
75
+ severity = 'info';
76
+ }
77
+ else if (maxDepth <= THRESHOLDS.GOOD) {
78
+ severity = 'warning';
79
+ }
80
+ else if (maxDepth <= THRESHOLDS.ACCEPTABLE) {
81
+ severity = 'error';
82
+ }
83
+ else {
84
+ severity = 'critical';
85
+ }
86
+ return {
87
+ name: this.name,
88
+ category: this.category,
89
+ value: maxDepth,
90
+ normalizedScore: Math.round(normalizedScore * 10) / 10,
91
+ severity,
92
+ details: t('detail_avg_max', { avg: avgDepth.toFixed(1), max: String(maxDepth) }),
93
+ locations: locations.length > 0 ? locations : undefined,
94
+ };
95
+ }
96
+ }
97
+ //# sourceMappingURL=nesting-depth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"nesting-depth.js","sourceRoot":"","sources":["../../../src/metrics/complexity/nesting-depth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Comment ratio metric
3
+ *
4
+ * Industry thresholds
5
+ * - 10-25%: Optimal range for most codebases
6
+ * - <5%: Under-documented, may be hard to maintain
7
+ * - >40%: Over-documented, may indicate code smell
8
+ *
9
+ * Note: Quality of comments matters more than quantity.
10
+ * This metric is a heuristic, not a definitive measure.
11
+ */
12
+ import type { Metric, MetricResult, MetricCategory } from '../types.js';
13
+ import type { ParseResult } from '../../parser/types.js';
14
+ export declare class CommentRatioMetric implements Metric {
15
+ readonly name = "comment_ratio";
16
+ readonly category: MetricCategory;
17
+ readonly weight: number;
18
+ constructor(weight: number);
19
+ calculate(parseResult: ParseResult): MetricResult;
20
+ }
21
+ //# sourceMappingURL=comment-ratio.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comment-ratio.d.ts","sourceRoot":"","sources":["../../../src/metrics/documentation/comment-ratio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAY,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUzD,qBAAa,kBAAmB,YAAW,MAAM;IAC/C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAmB;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY;CA+DlD"}
@@ -0,0 +1,91 @@
1
+ /**
2
+ * Comment ratio metric
3
+ *
4
+ * Industry thresholds
5
+ * - 10-25%: Optimal range for most codebases
6
+ * - <5%: Under-documented, may be hard to maintain
7
+ * - >40%: Over-documented, may indicate code smell
8
+ *
9
+ * Note: Quality of comments matters more than quantity.
10
+ * This metric is a heuristic, not a definitive measure.
11
+ */
12
+ import { t } from '../../i18n/index.js';
13
+ const THRESHOLDS = {
14
+ MIN_OPTIMAL: 10,
15
+ MAX_OPTIMAL: 25,
16
+ MIN_ACCEPTABLE: 5,
17
+ MAX_ACCEPTABLE: 40,
18
+ };
19
+ export class CommentRatioMetric {
20
+ name = 'comment_ratio';
21
+ category = 'documentation';
22
+ weight;
23
+ constructor(weight) {
24
+ this.weight = weight;
25
+ }
26
+ calculate(parseResult) {
27
+ const { codeLines, commentLines } = parseResult;
28
+ if (codeLines === 0) {
29
+ return {
30
+ name: this.name,
31
+ category: this.category,
32
+ value: 0,
33
+ normalizedScore: 100,
34
+ severity: 'info',
35
+ details: t('detail_no_code_lines'),
36
+ };
37
+ }
38
+ const ratio = (commentLines / codeLines) * 100;
39
+ let normalizedScore;
40
+ if (ratio >= THRESHOLDS.MIN_OPTIMAL && ratio <= THRESHOLDS.MAX_OPTIMAL) {
41
+ normalizedScore = 100;
42
+ }
43
+ else if (ratio < THRESHOLDS.MIN_OPTIMAL) {
44
+ if (ratio >= THRESHOLDS.MIN_ACCEPTABLE) {
45
+ normalizedScore =
46
+ 70 +
47
+ ((ratio - THRESHOLDS.MIN_ACCEPTABLE) /
48
+ (THRESHOLDS.MIN_OPTIMAL - THRESHOLDS.MIN_ACCEPTABLE)) *
49
+ 30;
50
+ }
51
+ else {
52
+ normalizedScore = Math.max(0, ratio * 14);
53
+ }
54
+ }
55
+ else {
56
+ if (ratio <= THRESHOLDS.MAX_ACCEPTABLE) {
57
+ normalizedScore =
58
+ 100 -
59
+ ((ratio - THRESHOLDS.MAX_OPTIMAL) /
60
+ (THRESHOLDS.MAX_ACCEPTABLE - THRESHOLDS.MAX_OPTIMAL)) *
61
+ 40;
62
+ }
63
+ else {
64
+ normalizedScore = Math.max(0, 60 - (ratio - THRESHOLDS.MAX_ACCEPTABLE) * 1.5);
65
+ }
66
+ }
67
+ let severity;
68
+ if (ratio >= THRESHOLDS.MIN_OPTIMAL && ratio <= THRESHOLDS.MAX_OPTIMAL) {
69
+ severity = 'info';
70
+ }
71
+ else if (ratio >= THRESHOLDS.MIN_ACCEPTABLE && ratio <= THRESHOLDS.MAX_ACCEPTABLE) {
72
+ severity = 'warning';
73
+ }
74
+ else {
75
+ severity = 'error';
76
+ }
77
+ return {
78
+ name: this.name,
79
+ category: this.category,
80
+ value: ratio,
81
+ normalizedScore: Math.round(normalizedScore * 10) / 10,
82
+ severity,
83
+ details: t('detail_ratio', {
84
+ ratio: ratio.toFixed(1),
85
+ comments: String(commentLines),
86
+ code: String(codeLines),
87
+ }),
88
+ };
89
+ }
90
+ }
91
+ //# sourceMappingURL=comment-ratio.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comment-ratio.js","sourceRoot":"","sources":["../../../src/metrics/documentation/comment-ratio.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Code duplication metric
3
+ *
4
+ * Detects duplicate code by analyzing control flow signature patterns.
5
+ *
6
+ * Industry thresholds (based on SonarQube, PMD CPD):
7
+ * - 0-5%: Excellent, minimal duplication
8
+ * - 5-10%: Good, acceptable level
9
+ * - 10-20%: Moderate, consider refactoring
10
+ * - 20%+: Poor, significant duplication
11
+ */
12
+ import type { Metric, MetricResult, MetricCategory } from '../types.js';
13
+ import type { ParseResult } from '../../parser/types.js';
14
+ export declare class CodeDuplicationMetric implements Metric {
15
+ readonly name = "code_duplication";
16
+ readonly category: MetricCategory;
17
+ readonly weight: number;
18
+ constructor(weight: number);
19
+ calculate(parseResult: ParseResult): MetricResult;
20
+ private buildSignatureMap;
21
+ private extractControlFlowSignature;
22
+ private findDuplicates;
23
+ }
24
+ //# sourceMappingURL=code-duplication.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"code-duplication.d.ts","sourceRoot":"","sources":["../../../src/metrics/duplication/code-duplication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAA4B,MAAM,aAAa,CAAC;AAClG,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,uBAAuB,CAAC;AAYvE,qBAAa,qBAAsB,YAAW,MAAM;IAClD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAiB;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAI1B,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,YAAY;IAiEjD,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,2BAA2B;IAmCnC,OAAO,CAAC,cAAc;CAyBvB"}