@girardelli/architect 2.2.0 → 5.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.
- package/README.md +105 -116
- package/architect-run.sh +431 -0
- package/assets/banner-v3.html +561 -0
- package/dist/agent-generator/context-enricher.d.ts +58 -0
- package/dist/agent-generator/context-enricher.d.ts.map +1 -0
- package/dist/agent-generator/context-enricher.js +613 -0
- package/dist/agent-generator/context-enricher.js.map +1 -0
- package/dist/agent-generator/domain-inferrer.d.ts +52 -0
- package/dist/agent-generator/domain-inferrer.d.ts.map +1 -0
- package/dist/agent-generator/domain-inferrer.js +585 -0
- package/dist/agent-generator/domain-inferrer.js.map +1 -0
- package/dist/agent-generator/framework-detector.d.ts +40 -0
- package/dist/agent-generator/framework-detector.d.ts.map +1 -0
- package/dist/agent-generator/framework-detector.js +611 -0
- package/dist/agent-generator/framework-detector.js.map +1 -0
- package/dist/agent-generator/index.d.ts +47 -0
- package/dist/agent-generator/index.d.ts.map +1 -0
- package/dist/agent-generator/index.js +545 -0
- package/dist/agent-generator/index.js.map +1 -0
- package/dist/agent-generator/stack-detector.d.ts +14 -0
- package/dist/agent-generator/stack-detector.d.ts.map +1 -0
- package/dist/agent-generator/stack-detector.js +124 -0
- package/dist/agent-generator/stack-detector.js.map +1 -0
- package/dist/agent-generator/templates/core/agents.d.ts +17 -0
- package/dist/agent-generator/templates/core/agents.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/agents.js +1256 -0
- package/dist/agent-generator/templates/core/agents.js.map +1 -0
- package/dist/agent-generator/templates/core/architecture-rules.d.ts +7 -0
- package/dist/agent-generator/templates/core/architecture-rules.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/architecture-rules.js +274 -0
- package/dist/agent-generator/templates/core/architecture-rules.js.map +1 -0
- package/dist/agent-generator/templates/core/general-rules.d.ts +8 -0
- package/dist/agent-generator/templates/core/general-rules.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/general-rules.js +301 -0
- package/dist/agent-generator/templates/core/general-rules.js.map +1 -0
- package/dist/agent-generator/templates/core/hooks-generator.d.ts +21 -0
- package/dist/agent-generator/templates/core/hooks-generator.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/hooks-generator.js +233 -0
- package/dist/agent-generator/templates/core/hooks-generator.js.map +1 -0
- package/dist/agent-generator/templates/core/index-md.d.ts +7 -0
- package/dist/agent-generator/templates/core/index-md.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/index-md.js +246 -0
- package/dist/agent-generator/templates/core/index-md.js.map +1 -0
- package/dist/agent-generator/templates/core/orchestrator.d.ts +8 -0
- package/dist/agent-generator/templates/core/orchestrator.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/orchestrator.js +422 -0
- package/dist/agent-generator/templates/core/orchestrator.js.map +1 -0
- package/dist/agent-generator/templates/core/preflight.d.ts +8 -0
- package/dist/agent-generator/templates/core/preflight.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/preflight.js +213 -0
- package/dist/agent-generator/templates/core/preflight.js.map +1 -0
- package/dist/agent-generator/templates/core/quality-gates.d.ts +11 -0
- package/dist/agent-generator/templates/core/quality-gates.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/quality-gates.js +254 -0
- package/dist/agent-generator/templates/core/quality-gates.js.map +1 -0
- package/dist/agent-generator/templates/core/security-rules.d.ts +7 -0
- package/dist/agent-generator/templates/core/security-rules.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/security-rules.js +528 -0
- package/dist/agent-generator/templates/core/security-rules.js.map +1 -0
- package/dist/agent-generator/templates/core/skills-generator.d.ts +19 -0
- package/dist/agent-generator/templates/core/skills-generator.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/skills-generator.js +546 -0
- package/dist/agent-generator/templates/core/skills-generator.js.map +1 -0
- package/dist/agent-generator/templates/core/workflow-fix-bug.d.ts +7 -0
- package/dist/agent-generator/templates/core/workflow-fix-bug.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/workflow-fix-bug.js +237 -0
- package/dist/agent-generator/templates/core/workflow-fix-bug.js.map +1 -0
- package/dist/agent-generator/templates/core/workflow-new-feature.d.ts +8 -0
- package/dist/agent-generator/templates/core/workflow-new-feature.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/workflow-new-feature.js +321 -0
- package/dist/agent-generator/templates/core/workflow-new-feature.js.map +1 -0
- package/dist/agent-generator/templates/core/workflow-review.d.ts +7 -0
- package/dist/agent-generator/templates/core/workflow-review.d.ts.map +1 -0
- package/dist/agent-generator/templates/core/workflow-review.js +104 -0
- package/dist/agent-generator/templates/core/workflow-review.js.map +1 -0
- package/dist/agent-generator/templates/domain/index.d.ts +22 -0
- package/dist/agent-generator/templates/domain/index.d.ts.map +1 -0
- package/dist/agent-generator/templates/domain/index.js +1176 -0
- package/dist/agent-generator/templates/domain/index.js.map +1 -0
- package/dist/agent-generator/templates/stack/index.d.ts +8 -0
- package/dist/agent-generator/templates/stack/index.d.ts.map +1 -0
- package/dist/agent-generator/templates/stack/index.js +695 -0
- package/dist/agent-generator/templates/stack/index.js.map +1 -0
- package/dist/agent-generator/templates/template-helpers.d.ts +75 -0
- package/dist/agent-generator/templates/template-helpers.d.ts.map +1 -0
- package/dist/agent-generator/templates/template-helpers.js +726 -0
- package/dist/agent-generator/templates/template-helpers.js.map +1 -0
- package/dist/agent-generator/types.d.ts +196 -0
- package/dist/agent-generator/types.d.ts.map +1 -0
- package/dist/agent-generator/types.js +27 -0
- package/dist/agent-generator/types.js.map +1 -0
- package/dist/analyzer.d.ts +5 -0
- package/dist/analyzer.d.ts.map +1 -1
- package/dist/analyzer.js +46 -5
- package/dist/analyzer.js.map +1 -1
- package/dist/analyzers/forecast.d.ts +85 -0
- package/dist/analyzers/forecast.d.ts.map +1 -0
- package/dist/analyzers/forecast.js +337 -0
- package/dist/analyzers/forecast.js.map +1 -0
- package/dist/analyzers/git-cache.d.ts +7 -0
- package/dist/analyzers/git-cache.d.ts.map +1 -0
- package/dist/analyzers/git-cache.js +41 -0
- package/dist/analyzers/git-cache.js.map +1 -0
- package/dist/analyzers/git-history.d.ts +113 -0
- package/dist/analyzers/git-history.d.ts.map +1 -0
- package/dist/analyzers/git-history.js +333 -0
- package/dist/analyzers/git-history.js.map +1 -0
- package/dist/analyzers/index.d.ts +10 -0
- package/dist/analyzers/index.d.ts.map +1 -0
- package/dist/analyzers/index.js +7 -0
- package/dist/analyzers/index.js.map +1 -0
- package/dist/analyzers/temporal-scorer.d.ts +72 -0
- package/dist/analyzers/temporal-scorer.d.ts.map +1 -0
- package/dist/analyzers/temporal-scorer.js +140 -0
- package/dist/analyzers/temporal-scorer.js.map +1 -0
- package/dist/anti-patterns.d.ts +7 -0
- package/dist/anti-patterns.d.ts.map +1 -1
- package/dist/anti-patterns.js +25 -6
- package/dist/anti-patterns.js.map +1 -1
- package/dist/cli.d.ts +2 -3
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +275 -113
- package/dist/cli.js.map +1 -1
- package/dist/config.d.ts +6 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +48 -11
- package/dist/config.js.map +1 -1
- package/dist/html-reporter.d.ts +3 -1
- package/dist/html-reporter.d.ts.map +1 -1
- package/dist/html-reporter.js +248 -12
- package/dist/html-reporter.js.map +1 -1
- package/dist/index.d.ts +16 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +63 -4
- package/dist/index.js.map +1 -1
- package/dist/project-summarizer.d.ts +38 -0
- package/dist/project-summarizer.d.ts.map +1 -0
- package/dist/project-summarizer.js +463 -0
- package/dist/project-summarizer.js.map +1 -0
- package/dist/refactor-reporter.js +1 -1
- package/dist/scanner.d.ts +8 -2
- package/dist/scanner.d.ts.map +1 -1
- package/dist/scanner.js +153 -113
- package/dist/scanner.js.map +1 -1
- package/dist/scorer.d.ts.map +1 -1
- package/dist/scorer.js +24 -11
- package/dist/scorer.js.map +1 -1
- package/dist/types.d.ts +29 -0
- package/dist/types.d.ts.map +1 -1
- package/package.json +12 -3
- package/src/agent-generator/context-enricher.ts +672 -0
- package/src/agent-generator/domain-inferrer.ts +635 -0
- package/src/agent-generator/framework-detector.ts +669 -0
- package/src/agent-generator/index.ts +634 -0
- package/src/agent-generator/stack-detector.ts +115 -0
- package/src/agent-generator/templates/core/agents.ts +1296 -0
- package/src/agent-generator/templates/core/architecture-rules.ts +287 -0
- package/src/agent-generator/templates/core/general-rules.ts +306 -0
- package/src/agent-generator/templates/core/hooks-generator.ts +242 -0
- package/src/agent-generator/templates/core/index-md.ts +260 -0
- package/src/agent-generator/templates/core/orchestrator.ts +459 -0
- package/src/agent-generator/templates/core/preflight.ts +215 -0
- package/src/agent-generator/templates/core/quality-gates.ts +256 -0
- package/src/agent-generator/templates/core/security-rules.ts +543 -0
- package/src/agent-generator/templates/core/skills-generator.ts +585 -0
- package/src/agent-generator/templates/core/workflow-fix-bug.ts +239 -0
- package/src/agent-generator/templates/core/workflow-new-feature.ts +323 -0
- package/src/agent-generator/templates/core/workflow-review.ts +106 -0
- package/src/agent-generator/templates/domain/index.ts +1201 -0
- package/src/agent-generator/templates/stack/index.ts +705 -0
- package/src/agent-generator/templates/template-helpers.ts +776 -0
- package/src/agent-generator/types.ts +232 -0
- package/src/analyzer.ts +51 -5
- package/src/analyzers/forecast.ts +496 -0
- package/src/analyzers/git-cache.ts +52 -0
- package/src/analyzers/git-history.ts +488 -0
- package/src/analyzers/index.ts +33 -0
- package/src/analyzers/temporal-scorer.ts +227 -0
- package/src/anti-patterns.ts +29 -6
- package/src/cli.ts +316 -117
- package/src/config.ts +52 -11
- package/src/html-reporter.ts +263 -13
- package/src/index.ts +93 -10
- package/src/project-summarizer.ts +521 -0
- package/src/refactor-reporter.ts +1 -1
- package/src/scanner.ts +136 -90
- package/src/scorer.ts +26 -11
- package/src/types.ts +27 -0
- package/tests/agent-generator.test.ts +427 -0
- package/tests/analyzers-integration.test.ts +174 -0
- package/tests/architect-adapter-enrichment.test.ts +9 -0
- package/tests/context-enricher.test.ts +971 -0
- package/tests/fixtures/monorepo/package.json +6 -0
- package/tests/fixtures/monorepo/packages/app/package.json +12 -0
- package/tests/fixtures/monorepo/packages/app/src/index.ts +6 -0
- package/tests/fixtures/monorepo/packages/core/package.json +7 -0
- package/tests/fixtures/monorepo/packages/core/src/index.ts +7 -0
- package/tests/forecast.test.ts +509 -0
- package/tests/framework-detector.test.ts +1172 -0
- package/tests/git-history.test.ts +254 -0
- package/tests/monorepo-scan.test.ts +170 -0
- package/tests/scanner.test.ts +7 -8
- package/tests/scorer.test.ts +594 -0
- package/tests/stack-detector.test.ts +241 -0
- package/tests/template-generation.test.ts +706 -0
- package/tests/template-helpers.test.ts +1152 -0
- package/tests/temporal-scorer.test.ts +307 -0
- package/dist/agent-generator.d.ts +0 -106
- package/dist/agent-generator.d.ts.map +0 -1
- package/dist/agent-generator.js +0 -1398
- package/dist/agent-generator.js.map +0 -1
- package/src/agent-generator.ts +0 -1526
|
@@ -0,0 +1,333 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Git History Analyzer — Temporal analysis of codebase evolution
|
|
3
|
+
*
|
|
4
|
+
* Reads git log to build velocity vectors, churn rates, and hotspot maps.
|
|
5
|
+
* Enables Architect v4's predictive capabilities.
|
|
6
|
+
*
|
|
7
|
+
* Key metrics per module:
|
|
8
|
+
* - Commit frequency (commits/week rolling 4-week average)
|
|
9
|
+
* - Churn rate (lines added + deleted per commit)
|
|
10
|
+
* - Author diversity (bus factor proxy)
|
|
11
|
+
* - Change coupling (files that change together)
|
|
12
|
+
*
|
|
13
|
+
* @author Camilo Girardelli — Girardelli Tecnologia
|
|
14
|
+
* @license MIT
|
|
15
|
+
*/
|
|
16
|
+
import { execSync } from 'child_process';
|
|
17
|
+
const DEFAULT_CONFIG = {
|
|
18
|
+
periodWeeks: 24,
|
|
19
|
+
rollingWindowWeeks: 4,
|
|
20
|
+
hotspotChurnThreshold: 500,
|
|
21
|
+
couplingMinCochanges: 3,
|
|
22
|
+
cacheDir: '.architect-cache',
|
|
23
|
+
};
|
|
24
|
+
// ═══════════════════════════════════════════════════════════════
|
|
25
|
+
// GIT HISTORY ANALYZER
|
|
26
|
+
// ═══════════════════════════════════════════════════════════════
|
|
27
|
+
export class GitHistoryAnalyzer {
|
|
28
|
+
constructor(config) {
|
|
29
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Analyze git history for the project at the given path.
|
|
33
|
+
* Returns a comprehensive GitHistoryReport.
|
|
34
|
+
*/
|
|
35
|
+
analyze(projectPath) {
|
|
36
|
+
this.validateGitRepo(projectPath);
|
|
37
|
+
const sinceDate = this.getSinceDate();
|
|
38
|
+
const commits = this.parseGitLog(projectPath, sinceDate);
|
|
39
|
+
const fileHistories = this.buildFileHistories(commits);
|
|
40
|
+
const modules = this.groupByModule(fileHistories);
|
|
41
|
+
const hotspots = this.detectHotspots(fileHistories);
|
|
42
|
+
const changeCouplings = this.detectChangeCoupling(commits);
|
|
43
|
+
const timeline = this.buildTimeline(commits);
|
|
44
|
+
const allAuthors = new Set();
|
|
45
|
+
commits.forEach(c => allAuthors.add(c.author));
|
|
46
|
+
return {
|
|
47
|
+
projectPath,
|
|
48
|
+
analyzedAt: new Date().toISOString(),
|
|
49
|
+
periodWeeks: this.config.periodWeeks,
|
|
50
|
+
totalCommits: commits.length,
|
|
51
|
+
totalAuthors: allAuthors.size,
|
|
52
|
+
modules,
|
|
53
|
+
hotspots,
|
|
54
|
+
changeCouplings,
|
|
55
|
+
commitTimeline: timeline,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
// ── Git Log Parsing ──
|
|
59
|
+
parseGitLog(projectPath, since) {
|
|
60
|
+
const cmd = `git log --format='%H|%an|%aI|%s' --numstat --since="${since}" -- .`;
|
|
61
|
+
let output;
|
|
62
|
+
try {
|
|
63
|
+
output = execSync(cmd, {
|
|
64
|
+
cwd: projectPath,
|
|
65
|
+
encoding: 'utf-8',
|
|
66
|
+
maxBuffer: 10 * 1024 * 1024, // 10MB buffer for large repos
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
return [];
|
|
71
|
+
}
|
|
72
|
+
return this.parseLogOutput(output);
|
|
73
|
+
}
|
|
74
|
+
parseLogOutput(output) {
|
|
75
|
+
const commits = [];
|
|
76
|
+
const lines = output.trim().split('\n');
|
|
77
|
+
let current = null;
|
|
78
|
+
for (const line of lines) {
|
|
79
|
+
if (!line.trim()) {
|
|
80
|
+
// Blank lines separate numstat blocks, but also appear between
|
|
81
|
+
// the commit header and its numstat output. Only finalize a commit
|
|
82
|
+
// on blank line if it already has file changes (otherwise it's just
|
|
83
|
+
// the gap between header and numstat).
|
|
84
|
+
if (current && current.files.length > 0) {
|
|
85
|
+
commits.push(current);
|
|
86
|
+
current = null;
|
|
87
|
+
}
|
|
88
|
+
continue;
|
|
89
|
+
}
|
|
90
|
+
// Commit header: hash|author|date|message
|
|
91
|
+
if (line.includes('|') && !line.startsWith('\t') && /^[0-9a-f]{7,}/.test(line)) {
|
|
92
|
+
if (current)
|
|
93
|
+
commits.push(current);
|
|
94
|
+
const parts = line.split('|');
|
|
95
|
+
if (parts.length >= 4) {
|
|
96
|
+
current = {
|
|
97
|
+
hash: parts[0],
|
|
98
|
+
author: parts[1],
|
|
99
|
+
date: new Date(parts[2]),
|
|
100
|
+
message: parts.slice(3).join('|'),
|
|
101
|
+
files: [],
|
|
102
|
+
};
|
|
103
|
+
}
|
|
104
|
+
continue;
|
|
105
|
+
}
|
|
106
|
+
// Numstat line: additions\tdeletions\tfilepath
|
|
107
|
+
if (current && /^\d+\t\d+\t/.test(line)) {
|
|
108
|
+
const [add, del, filePath] = line.split('\t');
|
|
109
|
+
if (filePath && !filePath.includes('{') /* skip renames */) {
|
|
110
|
+
current.files.push({
|
|
111
|
+
path: filePath,
|
|
112
|
+
additions: parseInt(add, 10) || 0,
|
|
113
|
+
deletions: parseInt(del, 10) || 0,
|
|
114
|
+
});
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
if (current)
|
|
119
|
+
commits.push(current);
|
|
120
|
+
return commits;
|
|
121
|
+
}
|
|
122
|
+
// ── File History Building ──
|
|
123
|
+
buildFileHistories(commits) {
|
|
124
|
+
const histories = new Map();
|
|
125
|
+
const now = new Date();
|
|
126
|
+
const windowMs = this.config.rollingWindowWeeks * 7 * 24 * 60 * 60 * 1000;
|
|
127
|
+
const windowStart = new Date(now.getTime() - windowMs);
|
|
128
|
+
for (const commit of commits) {
|
|
129
|
+
for (const file of commit.files) {
|
|
130
|
+
if (!histories.has(file.path)) {
|
|
131
|
+
histories.set(file.path, {
|
|
132
|
+
path: file.path,
|
|
133
|
+
commits: 0,
|
|
134
|
+
totalAdditions: 0,
|
|
135
|
+
totalDeletions: 0,
|
|
136
|
+
churnRate: 0,
|
|
137
|
+
authors: new Set(),
|
|
138
|
+
busFactor: 0,
|
|
139
|
+
lastModified: commit.date,
|
|
140
|
+
weeklyCommitRate: 0,
|
|
141
|
+
isHotspot: false,
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
const h = histories.get(file.path);
|
|
145
|
+
h.commits++;
|
|
146
|
+
h.totalAdditions += file.additions;
|
|
147
|
+
h.totalDeletions += file.deletions;
|
|
148
|
+
h.authors.add(commit.author);
|
|
149
|
+
if (commit.date > h.lastModified) {
|
|
150
|
+
h.lastModified = commit.date;
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
// Calculate derived metrics
|
|
155
|
+
const recentCommits = commits.filter(c => c.date >= windowStart);
|
|
156
|
+
const weekCount = Math.max(this.config.rollingWindowWeeks, 1);
|
|
157
|
+
for (const [filePath, h] of histories) {
|
|
158
|
+
h.churnRate = h.commits > 0
|
|
159
|
+
? (h.totalAdditions + h.totalDeletions) / h.commits
|
|
160
|
+
: 0;
|
|
161
|
+
h.busFactor = h.authors.size;
|
|
162
|
+
// Weekly commit rate from rolling window
|
|
163
|
+
const recentFileCommits = recentCommits.filter(c => c.files.some(f => f.path === filePath)).length;
|
|
164
|
+
h.weeklyCommitRate = recentFileCommits / weekCount;
|
|
165
|
+
// Hotspot: high churn + high frequency
|
|
166
|
+
h.isHotspot = (h.totalAdditions + h.totalDeletions) >= this.config.hotspotChurnThreshold
|
|
167
|
+
&& h.weeklyCommitRate >= 1;
|
|
168
|
+
}
|
|
169
|
+
return histories;
|
|
170
|
+
}
|
|
171
|
+
// ── Module Grouping ──
|
|
172
|
+
groupByModule(fileHistories) {
|
|
173
|
+
const moduleMap = new Map();
|
|
174
|
+
for (const [filePath, history] of fileHistories) {
|
|
175
|
+
const modulePath = this.getModulePath(filePath);
|
|
176
|
+
if (!moduleMap.has(modulePath)) {
|
|
177
|
+
moduleMap.set(modulePath, []);
|
|
178
|
+
}
|
|
179
|
+
moduleMap.get(modulePath).push(history);
|
|
180
|
+
}
|
|
181
|
+
return Array.from(moduleMap.entries()).map(([modulePath, files]) => {
|
|
182
|
+
const aggregateCommits = files.reduce((s, f) => s + f.commits, 0);
|
|
183
|
+
const aggregateChurn = files.reduce((s, f) => s + f.totalAdditions + f.totalDeletions, 0);
|
|
184
|
+
const avgWeeklyRate = files.reduce((s, f) => s + f.weeklyCommitRate, 0) / Math.max(files.length, 1);
|
|
185
|
+
const allAuthors = new Set();
|
|
186
|
+
files.forEach(f => f.authors.forEach(a => allAuthors.add(a)));
|
|
187
|
+
const topHotspots = files
|
|
188
|
+
.filter(f => f.isHotspot)
|
|
189
|
+
.sort((a, b) => (b.totalAdditions + b.totalDeletions) - (a.totalAdditions + a.totalDeletions))
|
|
190
|
+
.slice(0, 5);
|
|
191
|
+
return {
|
|
192
|
+
modulePath,
|
|
193
|
+
files,
|
|
194
|
+
aggregateCommits,
|
|
195
|
+
aggregateChurn,
|
|
196
|
+
avgWeeklyRate,
|
|
197
|
+
topHotspots,
|
|
198
|
+
velocityVector: this.calculateVelocity(files),
|
|
199
|
+
busFactor: allAuthors.size,
|
|
200
|
+
};
|
|
201
|
+
}).sort((a, b) => b.aggregateChurn - a.aggregateChurn);
|
|
202
|
+
}
|
|
203
|
+
// ── Velocity Calculation ──
|
|
204
|
+
calculateVelocity(files) {
|
|
205
|
+
if (files.length === 0) {
|
|
206
|
+
return { commitAcceleration: 0, churnTrend: 0, direction: 'stable' };
|
|
207
|
+
}
|
|
208
|
+
// Sort files by last modified (most recent first)
|
|
209
|
+
const sorted = [...files].sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());
|
|
210
|
+
// Split into halves: recent vs older
|
|
211
|
+
const mid = Math.floor(sorted.length / 2) || 1;
|
|
212
|
+
const recentHalf = sorted.slice(0, mid);
|
|
213
|
+
const olderHalf = sorted.slice(mid);
|
|
214
|
+
const recentAvgRate = recentHalf.reduce((s, f) => s + f.weeklyCommitRate, 0) / recentHalf.length;
|
|
215
|
+
const olderAvgRate = olderHalf.length > 0
|
|
216
|
+
? olderHalf.reduce((s, f) => s + f.weeklyCommitRate, 0) / olderHalf.length
|
|
217
|
+
: recentAvgRate;
|
|
218
|
+
const recentAvgChurn = recentHalf.reduce((s, f) => s + f.churnRate, 0) / recentHalf.length;
|
|
219
|
+
const olderAvgChurn = olderHalf.length > 0
|
|
220
|
+
? olderHalf.reduce((s, f) => s + f.churnRate, 0) / olderHalf.length
|
|
221
|
+
: recentAvgChurn;
|
|
222
|
+
const commitAcceleration = olderAvgRate > 0
|
|
223
|
+
? ((recentAvgRate - olderAvgRate) / olderAvgRate) * 100
|
|
224
|
+
: 0;
|
|
225
|
+
const churnTrend = olderAvgChurn > 0
|
|
226
|
+
? ((recentAvgChurn - olderAvgChurn) / olderAvgChurn) * 100
|
|
227
|
+
: 0;
|
|
228
|
+
let direction = 'stable';
|
|
229
|
+
if (commitAcceleration > 15)
|
|
230
|
+
direction = 'accelerating';
|
|
231
|
+
else if (commitAcceleration < -15)
|
|
232
|
+
direction = 'decelerating';
|
|
233
|
+
return {
|
|
234
|
+
commitAcceleration: Math.round(commitAcceleration * 10) / 10,
|
|
235
|
+
churnTrend: Math.round(churnTrend * 10) / 10,
|
|
236
|
+
direction,
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
// ── Hotspot Detection ──
|
|
240
|
+
detectHotspots(fileHistories) {
|
|
241
|
+
return Array.from(fileHistories.values())
|
|
242
|
+
.filter(f => f.isHotspot)
|
|
243
|
+
.sort((a, b) => (b.totalAdditions + b.totalDeletions) - (a.totalAdditions + a.totalDeletions))
|
|
244
|
+
.slice(0, 20);
|
|
245
|
+
}
|
|
246
|
+
// ── Change Coupling Detection ──
|
|
247
|
+
detectChangeCoupling(commits) {
|
|
248
|
+
const cochangeMap = new Map();
|
|
249
|
+
const fileCommitCount = new Map();
|
|
250
|
+
for (const commit of commits) {
|
|
251
|
+
const files = commit.files.map(f => f.path).sort();
|
|
252
|
+
for (const f of files) {
|
|
253
|
+
fileCommitCount.set(f, (fileCommitCount.get(f) || 0) + 1);
|
|
254
|
+
}
|
|
255
|
+
// Pairwise co-change counting (limit to 10 files per commit to avoid explosion)
|
|
256
|
+
const limited = files.slice(0, 10);
|
|
257
|
+
for (let i = 0; i < limited.length; i++) {
|
|
258
|
+
for (let j = i + 1; j < limited.length; j++) {
|
|
259
|
+
const key = `${limited[i]}|||${limited[j]}`;
|
|
260
|
+
cochangeMap.set(key, (cochangeMap.get(key) || 0) + 1);
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
const couplings = [];
|
|
265
|
+
for (const [key, count] of cochangeMap) {
|
|
266
|
+
if (count < this.config.couplingMinCochanges)
|
|
267
|
+
continue;
|
|
268
|
+
const [fileA, fileB] = key.split('|||');
|
|
269
|
+
const maxCommits = Math.max(fileCommitCount.get(fileA) || 1, fileCommitCount.get(fileB) || 1);
|
|
270
|
+
couplings.push({
|
|
271
|
+
fileA,
|
|
272
|
+
fileB,
|
|
273
|
+
cochangeCount: count,
|
|
274
|
+
confidence: Math.round((count / maxCommits) * 100) / 100,
|
|
275
|
+
});
|
|
276
|
+
}
|
|
277
|
+
return couplings
|
|
278
|
+
.sort((a, b) => b.confidence - a.confidence)
|
|
279
|
+
.slice(0, 50);
|
|
280
|
+
}
|
|
281
|
+
// ── Timeline Building ──
|
|
282
|
+
buildTimeline(commits) {
|
|
283
|
+
if (commits.length === 0)
|
|
284
|
+
return [];
|
|
285
|
+
const snapshots = new Map();
|
|
286
|
+
const toMonday = (d) => {
|
|
287
|
+
d.setHours(0, 0, 0, 0);
|
|
288
|
+
d.setDate(d.getDate() - ((d.getDay() + 6) % 7));
|
|
289
|
+
return d.toISOString().split('T')[0];
|
|
290
|
+
};
|
|
291
|
+
const now = new Date();
|
|
292
|
+
for (let w = 0; w < this.config.periodWeeks; w++) {
|
|
293
|
+
const key = toMonday(new Date(now.getTime() - w * 604800000));
|
|
294
|
+
if (!snapshots.has(key)) {
|
|
295
|
+
snapshots.set(key, { weekStart: key, commits: 0, churn: 0, activeFiles: 0 });
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
for (const commit of commits) {
|
|
299
|
+
const key = toMonday(new Date(commit.date));
|
|
300
|
+
const snap = snapshots.get(key);
|
|
301
|
+
if (snap) {
|
|
302
|
+
snap.commits++;
|
|
303
|
+
snap.churn += commit.files.reduce((s, f) => s + f.additions + f.deletions, 0);
|
|
304
|
+
snap.activeFiles += commit.files.length;
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
return Array.from(snapshots.values()).sort((a, b) => a.weekStart.localeCompare(b.weekStart));
|
|
308
|
+
}
|
|
309
|
+
// ── Utilities ──
|
|
310
|
+
validateGitRepo(projectPath) {
|
|
311
|
+
try {
|
|
312
|
+
execSync('git rev-parse --is-inside-work-tree', {
|
|
313
|
+
cwd: projectPath,
|
|
314
|
+
encoding: 'utf-8',
|
|
315
|
+
stdio: 'pipe',
|
|
316
|
+
});
|
|
317
|
+
}
|
|
318
|
+
catch {
|
|
319
|
+
throw new Error(`Not a git repository: ${projectPath}`);
|
|
320
|
+
}
|
|
321
|
+
}
|
|
322
|
+
getSinceDate() {
|
|
323
|
+
const d = new Date();
|
|
324
|
+
d.setDate(d.getDate() - (this.config.periodWeeks * 7));
|
|
325
|
+
return d.toISOString().split('T')[0];
|
|
326
|
+
}
|
|
327
|
+
getModulePath(filePath) {
|
|
328
|
+
const parts = filePath.split('/');
|
|
329
|
+
// Use first directory as module, or "root" if no directory
|
|
330
|
+
return parts.length > 1 ? parts[0] : 'root';
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
//# sourceMappingURL=git-history.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"git-history.js","sourceRoot":"","sources":["../../src/analyzers/git-history.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Architect v4.0 Analyzers — Temporal & Predictive
|
|
3
|
+
*/
|
|
4
|
+
export { GitHistoryAnalyzer } from './git-history.js';
|
|
5
|
+
export type { GitCommit, FileChange, FileHistory, ModuleHistory, VelocityVector, ChangeCoupling, GitHistoryReport, WeeklySnapshot, GitAnalyzerConfig, } from './git-history.js';
|
|
6
|
+
export { TemporalScorer } from './temporal-scorer.js';
|
|
7
|
+
export type { Trend, TemporalScore, TemporalReport, TemporalScorerConfig, } from './temporal-scorer.js';
|
|
8
|
+
export { ForecastEngine } from './forecast.js';
|
|
9
|
+
export type { PreAntiPatternType, PreAntiPattern, ModuleForecast, WeatherForecast, ForecastConfig, } from './forecast.js';
|
|
10
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EACV,KAAK,EACL,aAAa,EACb,cAAc,EACd,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAatD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAQtD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Temporal Score Dimension — Adds time-series awareness to architecture scoring
|
|
3
|
+
*
|
|
4
|
+
* Combines current static score with historical velocity to produce:
|
|
5
|
+
* - Trend per module (improving / stable / degrading)
|
|
6
|
+
* - Temporal risk score (static score penalized by negative velocity)
|
|
7
|
+
* - Projected score in N weeks
|
|
8
|
+
*
|
|
9
|
+
* @author Camilo Girardelli — Girardelli Tecnologia
|
|
10
|
+
* @license MIT
|
|
11
|
+
*/
|
|
12
|
+
import type { VelocityVector, GitHistoryReport } from './git-history.js';
|
|
13
|
+
export type Trend = 'improving' | 'stable' | 'degrading';
|
|
14
|
+
export interface TemporalScore {
|
|
15
|
+
/** Module or file path */
|
|
16
|
+
module: string;
|
|
17
|
+
/** Current static score (from ArchitectureScorer) */
|
|
18
|
+
staticScore: number;
|
|
19
|
+
/** Temporal-adjusted score (penalizes degrading trends) */
|
|
20
|
+
temporalScore: number;
|
|
21
|
+
/** Direction of change */
|
|
22
|
+
trend: Trend;
|
|
23
|
+
/** Projected score in projectionWeeks */
|
|
24
|
+
projectedScore: number;
|
|
25
|
+
/** Confidence in the projection (0-1) */
|
|
26
|
+
projectionConfidence: number;
|
|
27
|
+
/** Weeks used for projection */
|
|
28
|
+
projectionWeeks: number;
|
|
29
|
+
/** Risk level derived from temporal analysis */
|
|
30
|
+
riskLevel: 'low' | 'medium' | 'high' | 'critical';
|
|
31
|
+
/** Velocity data */
|
|
32
|
+
velocity: VelocityVector;
|
|
33
|
+
}
|
|
34
|
+
export interface TemporalReport {
|
|
35
|
+
projectPath: string;
|
|
36
|
+
analyzedAt: string;
|
|
37
|
+
overallTrend: Trend;
|
|
38
|
+
overallTemporalScore: number;
|
|
39
|
+
modules: TemporalScore[];
|
|
40
|
+
degradingModules: TemporalScore[];
|
|
41
|
+
improvingModules: TemporalScore[];
|
|
42
|
+
}
|
|
43
|
+
export interface TemporalScorerConfig {
|
|
44
|
+
/** Weeks ahead to project (default: 12) */
|
|
45
|
+
projectionWeeks?: number;
|
|
46
|
+
/** Weight of churn trend in temporal penalty (0-1, default: 0.6) */
|
|
47
|
+
churnWeight?: number;
|
|
48
|
+
/** Weight of commit acceleration in temporal penalty (0-1, default: 0.4) */
|
|
49
|
+
commitWeight?: number;
|
|
50
|
+
/** Threshold for trend classification: accelerating if > threshold % */
|
|
51
|
+
acceleratingThreshold?: number;
|
|
52
|
+
/** Threshold for trend classification: decelerating if < -threshold % */
|
|
53
|
+
deceleratingThreshold?: number;
|
|
54
|
+
}
|
|
55
|
+
export declare class TemporalScorer {
|
|
56
|
+
private config;
|
|
57
|
+
constructor(config?: TemporalScorerConfig);
|
|
58
|
+
/**
|
|
59
|
+
* Score modules temporally using git history + static scores.
|
|
60
|
+
*
|
|
61
|
+
* @param gitReport - Output from GitHistoryAnalyzer
|
|
62
|
+
* @param staticScores - Map of modulePath → static score (0-100)
|
|
63
|
+
*/
|
|
64
|
+
score(gitReport: GitHistoryReport, staticScores: Map<string, number>): TemporalReport;
|
|
65
|
+
private scoreModule;
|
|
66
|
+
private classifyTrend;
|
|
67
|
+
private classifyRisk;
|
|
68
|
+
private classifyOverallTrend;
|
|
69
|
+
/** Infer a static score when none is provided (based on churn metrics) */
|
|
70
|
+
private inferStaticScore;
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=temporal-scorer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"temporal-scorer.d.ts","sourceRoot":"","sources":["../../src/analyzers/temporal-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,oBAAoB;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,KAAK,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,gBAAgB,EAAE,aAAa,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAcD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;gBAEnC,MAAM,CAAC,EAAE,oBAAoB;IAIzC;;;;;OAKG;IACH,KAAK,CACH,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,cAAc;IAiCjB,OAAO,CAAC,WAAW;IA6CnB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,oBAAoB;IAc5B,0EAA0E;IAC1E,OAAO,CAAC,gBAAgB;CAQzB"}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Temporal Score Dimension — Adds time-series awareness to architecture scoring
|
|
3
|
+
*
|
|
4
|
+
* Combines current static score with historical velocity to produce:
|
|
5
|
+
* - Trend per module (improving / stable / degrading)
|
|
6
|
+
* - Temporal risk score (static score penalized by negative velocity)
|
|
7
|
+
* - Projected score in N weeks
|
|
8
|
+
*
|
|
9
|
+
* @author Camilo Girardelli — Girardelli Tecnologia
|
|
10
|
+
* @license MIT
|
|
11
|
+
*/
|
|
12
|
+
const DEFAULT_CONFIG = {
|
|
13
|
+
projectionWeeks: 12,
|
|
14
|
+
churnWeight: 0.6,
|
|
15
|
+
commitWeight: 0.4,
|
|
16
|
+
acceleratingThreshold: 15,
|
|
17
|
+
deceleratingThreshold: -15,
|
|
18
|
+
};
|
|
19
|
+
// ═══════════════════════════════════════════════════════════════
|
|
20
|
+
// TEMPORAL SCORER
|
|
21
|
+
// ═══════════════════════════════════════════════════════════════
|
|
22
|
+
export class TemporalScorer {
|
|
23
|
+
constructor(config) {
|
|
24
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Score modules temporally using git history + static scores.
|
|
28
|
+
*
|
|
29
|
+
* @param gitReport - Output from GitHistoryAnalyzer
|
|
30
|
+
* @param staticScores - Map of modulePath → static score (0-100)
|
|
31
|
+
*/
|
|
32
|
+
score(gitReport, staticScores) {
|
|
33
|
+
const modules = [];
|
|
34
|
+
for (const moduleHistory of gitReport.modules) {
|
|
35
|
+
const staticScore = staticScores.get(moduleHistory.modulePath)
|
|
36
|
+
?? this.inferStaticScore(moduleHistory);
|
|
37
|
+
const ts = this.scoreModule(moduleHistory, staticScore);
|
|
38
|
+
modules.push(ts);
|
|
39
|
+
}
|
|
40
|
+
// Sort by risk (worst first)
|
|
41
|
+
modules.sort((a, b) => a.temporalScore - b.temporalScore);
|
|
42
|
+
const degrading = modules.filter(m => m.trend === 'degrading');
|
|
43
|
+
const improving = modules.filter(m => m.trend === 'improving');
|
|
44
|
+
const overallTrend = this.classifyOverallTrend(modules);
|
|
45
|
+
const overallScore = modules.length > 0
|
|
46
|
+
? Math.round(modules.reduce((s, m) => s + m.temporalScore, 0) / modules.length)
|
|
47
|
+
: 0;
|
|
48
|
+
return {
|
|
49
|
+
projectPath: gitReport.projectPath,
|
|
50
|
+
analyzedAt: new Date().toISOString(),
|
|
51
|
+
overallTrend: overallTrend,
|
|
52
|
+
overallTemporalScore: overallScore,
|
|
53
|
+
modules,
|
|
54
|
+
degradingModules: degrading,
|
|
55
|
+
improvingModules: improving,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
scoreModule(module, staticScore) {
|
|
59
|
+
const velocity = module.velocityVector;
|
|
60
|
+
// Calculate temporal penalty based on velocity
|
|
61
|
+
const churnPenalty = velocity.churnTrend > 0
|
|
62
|
+
? velocity.churnTrend * this.config.churnWeight * 0.3 // 30% impact per 100% churn increase
|
|
63
|
+
: velocity.churnTrend * this.config.churnWeight * 0.1; // 10% bonus per 100% churn decrease
|
|
64
|
+
const commitPenalty = velocity.commitAcceleration > 20
|
|
65
|
+
? (velocity.commitAcceleration - 20) * this.config.commitWeight * 0.2 // penalty for excessive churn
|
|
66
|
+
: 0;
|
|
67
|
+
const totalPenalty = Math.max(-20, Math.min(30, churnPenalty + commitPenalty));
|
|
68
|
+
const temporalScore = Math.max(0, Math.min(100, Math.round(staticScore - totalPenalty)));
|
|
69
|
+
// Trend classification
|
|
70
|
+
const trend = this.classifyTrend(velocity);
|
|
71
|
+
// Linear projection
|
|
72
|
+
const weeklyDelta = totalPenalty / Math.max(this.config.projectionWeeks, 1);
|
|
73
|
+
const projectedScore = Math.max(0, Math.min(100, Math.round(temporalScore - (weeklyDelta * this.config.projectionWeeks))));
|
|
74
|
+
// Confidence decreases with projection distance and instability
|
|
75
|
+
const instability = Math.abs(velocity.churnTrend) + Math.abs(velocity.commitAcceleration);
|
|
76
|
+
const projectionConfidence = Math.max(0.1, Math.min(1, 1 - (instability / 200) - (this.config.projectionWeeks / 52)));
|
|
77
|
+
const riskLevel = this.classifyRisk(temporalScore, trend, module.busFactor);
|
|
78
|
+
return {
|
|
79
|
+
module: module.modulePath,
|
|
80
|
+
staticScore,
|
|
81
|
+
temporalScore,
|
|
82
|
+
trend,
|
|
83
|
+
projectedScore,
|
|
84
|
+
projectionConfidence: Math.round(projectionConfidence * 100) / 100,
|
|
85
|
+
projectionWeeks: this.config.projectionWeeks,
|
|
86
|
+
riskLevel,
|
|
87
|
+
velocity,
|
|
88
|
+
};
|
|
89
|
+
}
|
|
90
|
+
classifyTrend(velocity) {
|
|
91
|
+
// Degrading: churn increasing significantly or commit acceleration very high
|
|
92
|
+
if (velocity.churnTrend > 30 || velocity.commitAcceleration > 50) {
|
|
93
|
+
return 'degrading';
|
|
94
|
+
}
|
|
95
|
+
// Improving: churn decreasing and stable or decelerating
|
|
96
|
+
if (velocity.churnTrend < -10 && velocity.direction !== 'accelerating') {
|
|
97
|
+
return 'improving';
|
|
98
|
+
}
|
|
99
|
+
return 'stable';
|
|
100
|
+
}
|
|
101
|
+
classifyRisk(temporalScore, trend, busFactor) {
|
|
102
|
+
if (temporalScore < 30 || (temporalScore < 50 && trend === 'degrading')) {
|
|
103
|
+
return 'critical';
|
|
104
|
+
}
|
|
105
|
+
if (temporalScore < 50 || (trend === 'degrading' && busFactor <= 1)) {
|
|
106
|
+
return 'high';
|
|
107
|
+
}
|
|
108
|
+
if (temporalScore < 70 || trend === 'degrading') {
|
|
109
|
+
return 'medium';
|
|
110
|
+
}
|
|
111
|
+
return 'low';
|
|
112
|
+
}
|
|
113
|
+
classifyOverallTrend(modules) {
|
|
114
|
+
if (modules.length === 0)
|
|
115
|
+
return 'stable';
|
|
116
|
+
const degrading = modules.filter(m => m.trend === 'degrading').length;
|
|
117
|
+
const improving = modules.filter(m => m.trend === 'improving').length;
|
|
118
|
+
const degradingRatio = degrading / modules.length;
|
|
119
|
+
const improvingRatio = improving / modules.length;
|
|
120
|
+
if (degradingRatio > 0.3)
|
|
121
|
+
return 'degrading';
|
|
122
|
+
if (improvingRatio > 0.3)
|
|
123
|
+
return 'improving';
|
|
124
|
+
return 'stable';
|
|
125
|
+
}
|
|
126
|
+
/** Infer a static score when none is provided (based on churn metrics) */
|
|
127
|
+
inferStaticScore(module) {
|
|
128
|
+
const avgChurn = module.aggregateChurn / Math.max(module.aggregateCommits, 1);
|
|
129
|
+
if (avgChurn < 20)
|
|
130
|
+
return 85;
|
|
131
|
+
if (avgChurn < 50)
|
|
132
|
+
return 75;
|
|
133
|
+
if (avgChurn < 100)
|
|
134
|
+
return 65;
|
|
135
|
+
if (avgChurn < 200)
|
|
136
|
+
return 50;
|
|
137
|
+
return 35;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
//# sourceMappingURL=temporal-scorer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"temporal-scorer.js","sourceRoot":"","sources":["../../src/analyzers/temporal-scorer.ts"],"names":[],"mappings":"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"}
|
package/dist/anti-patterns.d.ts
CHANGED
|
@@ -2,7 +2,14 @@ import { AntiPattern, FileNode, ArchitectConfig } from './types.js';
|
|
|
2
2
|
export declare class AntiPatternDetector {
|
|
3
3
|
private config;
|
|
4
4
|
private dependencyGraph;
|
|
5
|
+
/** Paths that indicate third-party or build artifacts — never report anti-patterns here */
|
|
6
|
+
private static readonly EXCLUDED_PATH_SEGMENTS;
|
|
5
7
|
constructor(config: ArchitectConfig);
|
|
8
|
+
/**
|
|
9
|
+
* Check if a file path belongs to the project's own source code.
|
|
10
|
+
* Returns false for node_modules, dist, build artifacts, etc.
|
|
11
|
+
*/
|
|
12
|
+
private isProjectFile;
|
|
6
13
|
detect(fileTree: FileNode, dependencies: Map<string, Set<string>>): AntiPattern[];
|
|
7
14
|
private detectGodClasses;
|
|
8
15
|
private detectCircularDependencies;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"anti-patterns.d.ts","sourceRoot":"","sources":["../src/anti-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAA2B;
|
|
1
|
+
{"version":3,"file":"anti-patterns.d.ts","sourceRoot":"","sources":["../src/anti-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEpE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,eAAe,CAA2B;IAElD,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAG5C;gBAEU,MAAM,EAAE,eAAe;IAKnC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB,MAAM,CACJ,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GACrC,WAAW,EAAE;IAqBhB,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,0BAA0B;IA4BlC,OAAO,CAAC,SAAS;IAyBjB,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,iBAAiB;IA8CzB,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,oBAAoB;IAwB5B,OAAO,CAAC,YAAY;CAWrB"}
|