@aiready/cli 0.14.14 → 0.14.16

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 (98) hide show
  1. package/CONTRIBUTING.md +86 -1
  2. package/LICENSE +21 -0
  3. package/README.md +152 -52
  4. package/dist/cli.js +73 -12
  5. package/dist/cli.mjs +73 -12
  6. package/package.json +44 -14
  7. package/.aiready/aiready-report-20260227-133806.json +0 -7805
  8. package/.aiready/aiready-report-20260227-133938.json +0 -7951
  9. package/.aiready/aiready-report-20260228-003433.json +0 -7939
  10. package/.aiready/aiready-report-20260228-003613.json +0 -771
  11. package/.aiready/aiready-report-20260314-164626.json +0 -59
  12. package/.aiready/aiready-report-20260314-164741.json +0 -59
  13. package/.aiready/aiready-report-20260319-201106.json +0 -5566
  14. package/.aiready/aiready-report-20260319-201511.json +0 -5566
  15. package/.aiready/aiready-report-20260319-202017.json +0 -5708
  16. package/.github/FUNDING.yml +0 -5
  17. package/.turbo/turbo-build.log +0 -29
  18. package/.turbo/turbo-lint.log +0 -0
  19. package/.turbo/turbo-test.log +0 -76
  20. package/aiready-report.json +0 -30703
  21. package/coverage/base.css +0 -224
  22. package/coverage/block-navigation.js +0 -87
  23. package/coverage/clover.xml +0 -865
  24. package/coverage/coverage-final.json +0 -15
  25. package/coverage/favicon.png +0 -0
  26. package/coverage/index.html +0 -146
  27. package/coverage/prettify.css +0 -1
  28. package/coverage/prettify.js +0 -2
  29. package/coverage/sort-arrow-sprite.png +0 -0
  30. package/coverage/sorter.js +0 -210
  31. package/coverage/src/commands/agent-grounding.ts.html +0 -271
  32. package/coverage/src/commands/ai-signal-clarity.ts.html +0 -253
  33. package/coverage/src/commands/change-amplification.ts.html +0 -94
  34. package/coverage/src/commands/consistency.ts.html +0 -781
  35. package/coverage/src/commands/context.ts.html +0 -871
  36. package/coverage/src/commands/deps-health.ts.html +0 -280
  37. package/coverage/src/commands/doc-drift.ts.html +0 -271
  38. package/coverage/src/commands/index.html +0 -281
  39. package/coverage/src/commands/patterns.ts.html +0 -745
  40. package/coverage/src/commands/scan.ts.html +0 -1393
  41. package/coverage/src/commands/testability.ts.html +0 -304
  42. package/coverage/src/commands/upload.ts.html +0 -466
  43. package/coverage/src/commands/visualize.ts.html +0 -1027
  44. package/coverage/src/index.html +0 -116
  45. package/coverage/src/index.ts.html +0 -1372
  46. package/coverage/src/utils/helpers.ts.html +0 -559
  47. package/coverage/src/utils/index.html +0 -116
  48. package/docs/SPOKE_GUIDE.md +0 -184
  49. package/packages/core/src/.aiready/aiready-report-20260314-161145.json +0 -224
  50. package/packages/core/src/.aiready/aiready-report-20260314-161152.json +0 -235
  51. package/packages/pattern-detect/src/.aiready/aiready-report-20260314-161139.json +0 -224
  52. package/src/.aiready/aiready-report-20260312-103623.json +0 -32574
  53. package/src/.aiready/aiready-report-20260312-110843.json +0 -28740
  54. package/src/.aiready/aiready-report-20260312-110955.json +0 -28740
  55. package/src/.aiready/aiready-report-20260314-203209.json +0 -30713
  56. package/src/.aiready/aiready-report-20260314-203736.json +0 -30713
  57. package/src/.aiready/aiready-report-20260314-203857.json +0 -30713
  58. package/src/.aiready/aiready-report-20260314-204047.json +0 -30713
  59. package/src/.aiready/aiready-report-20260318-002110.json +0 -28782
  60. package/src/__tests__/cli.test.ts +0 -85
  61. package/src/__tests__/config-shape.test.ts +0 -105
  62. package/src/__tests__/unified.test.ts +0 -95
  63. package/src/cli.ts +0 -333
  64. package/src/commands/__tests__/agent-grounding.test.ts +0 -24
  65. package/src/commands/__tests__/ai-signal-clarity.test.ts +0 -32
  66. package/src/commands/__tests__/consistency.test.ts +0 -100
  67. package/src/commands/__tests__/deps-health.test.ts +0 -26
  68. package/src/commands/__tests__/doc-drift.test.ts +0 -26
  69. package/src/commands/__tests__/extra-commands.test.ts +0 -168
  70. package/src/commands/__tests__/init.test.ts +0 -51
  71. package/src/commands/__tests__/scan.test.ts +0 -153
  72. package/src/commands/__tests__/testability.test.ts +0 -36
  73. package/src/commands/__tests__/upload.test.ts +0 -50
  74. package/src/commands/__tests__/visualize.test.ts +0 -78
  75. package/src/commands/agent-grounding.ts +0 -62
  76. package/src/commands/ai-signal-clarity.ts +0 -1
  77. package/src/commands/bug.ts +0 -99
  78. package/src/commands/change-amplification.ts +0 -3
  79. package/src/commands/consistency.ts +0 -232
  80. package/src/commands/context.ts +0 -262
  81. package/src/commands/deps-health.ts +0 -1
  82. package/src/commands/doc-drift.ts +0 -1
  83. package/src/commands/index.ts +0 -20
  84. package/src/commands/init.ts +0 -199
  85. package/src/commands/patterns.ts +0 -222
  86. package/src/commands/report-formatter.ts +0 -267
  87. package/src/commands/scan.ts +0 -432
  88. package/src/commands/shared/configured-tool-action.ts +0 -35
  89. package/src/commands/shared/standard-tool-actions.ts +0 -126
  90. package/src/commands/testability.ts +0 -73
  91. package/src/commands/upload.ts +0 -129
  92. package/src/commands/visualize.ts +0 -321
  93. package/src/index.ts +0 -465
  94. package/src/utils/__tests__/helpers.test.ts +0 -35
  95. package/src/utils/helpers.ts +0 -234
  96. package/tsconfig.json +0 -11
  97. package/tsconfig.tsbuildinfo +0 -1
  98. package/vitest.config.ts +0 -13
package/.aiready/aiready-report-20260228-003613.json DELETED
@@ -1,771 +0,0 @@
1
- {
2
- "summary": {
3
- "totalIssues": 19,
4
- "toolsRun": ["patterns", "context"],
5
- "executionTime": 267
6
- },
7
- "patterns": [
8
- {
9
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
10
- "issues": [
11
- {
12
- "type": "duplicate-pattern",
13
- "severity": "minor",
14
- "message": "utility pattern 78% similar to /Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts (435 tokens wasted)",
15
- "location": {
16
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
17
- "line": 32
18
- },
19
- "suggestion": "Move to a shared utilities file and reuse across modules"
20
- },
21
- {
22
- "type": "duplicate-pattern",
23
- "severity": "minor",
24
- "message": "utility pattern 63% similar to /Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts (381 tokens wasted)",
25
- "location": {
26
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
27
- "line": 32
28
- },
29
- "suggestion": "Move to a shared utilities file and reuse across modules"
30
- }
31
- ],
32
- "metrics": {
33
- "tokenCost": 816,
34
- "consistencyScore": 0.8
35
- }
36
- },
37
- {
38
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
39
- "issues": [
40
- {
41
- "type": "duplicate-pattern",
42
- "severity": "minor",
43
- "message": "utility pattern 63% similar to /Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts (381 tokens wasted)",
44
- "location": {
45
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
46
- "line": 35
47
- },
48
- "suggestion": "Move to a shared utilities file and reuse across modules"
49
- }
50
- ],
51
- "metrics": {
52
- "tokenCost": 381,
53
- "consistencyScore": 0.9
54
- }
55
- },
56
- {
57
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
58
- "issues": [
59
- {
60
- "type": "duplicate-pattern",
61
- "severity": "minor",
62
- "message": "utility pattern 78% similar to /Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts (435 tokens wasted)",
63
- "location": {
64
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
65
- "line": 33
66
- },
67
- "suggestion": "Move to a shared utilities file and reuse across modules"
68
- }
69
- ],
70
- "metrics": {
71
- "tokenCost": 435,
72
- "consistencyScore": 0.9
73
- }
74
- },
75
- {
76
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/cli.ts",
77
- "issues": [],
78
- "metrics": {
79
- "tokenCost": 0,
80
- "consistencyScore": 1
81
- }
82
- },
83
- {
84
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts",
85
- "issues": [],
86
- "metrics": {
87
- "tokenCost": 0,
88
- "consistencyScore": 1
89
- }
90
- },
91
- {
92
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/change-amplification.ts",
93
- "issues": [],
94
- "metrics": {
95
- "tokenCost": 0,
96
- "consistencyScore": 1
97
- }
98
- },
99
- {
100
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
101
- "issues": [],
102
- "metrics": {
103
- "tokenCost": 0,
104
- "consistencyScore": 1
105
- }
106
- },
107
- {
108
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
109
- "issues": [],
110
- "metrics": {
111
- "tokenCost": 0,
112
- "consistencyScore": 1
113
- }
114
- },
115
- {
116
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/index.ts",
117
- "issues": [],
118
- "metrics": {
119
- "tokenCost": 0,
120
- "consistencyScore": 1
121
- }
122
- },
123
- {
124
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
125
- "issues": [],
126
- "metrics": {
127
- "tokenCost": 0,
128
- "consistencyScore": 1
129
- }
130
- },
131
- {
132
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/scan.ts",
133
- "issues": [],
134
- "metrics": {
135
- "tokenCost": 0,
136
- "consistencyScore": 1
137
- }
138
- },
139
- {
140
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
141
- "issues": [],
142
- "metrics": {
143
- "tokenCost": 0,
144
- "consistencyScore": 1
145
- }
146
- },
147
- {
148
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
149
- "issues": [],
150
- "metrics": {
151
- "tokenCost": 0,
152
- "consistencyScore": 1
153
- }
154
- },
155
- {
156
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
157
- "issues": [],
158
- "metrics": {
159
- "tokenCost": 0,
160
- "consistencyScore": 1
161
- }
162
- },
163
- {
164
- "fileName": "/Users/pengcao/projects/aiready/packages/cli/src/utils/helpers.ts",
165
- "issues": [],
166
- "metrics": {
167
- "tokenCost": 0,
168
- "consistencyScore": 1
169
- }
170
- }
171
- ],
172
- "duplicates": [
173
- {
174
- "file1": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
175
- "file2": "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
176
- "line1": 32,
177
- "line2": 33,
178
- "endLine1": 62,
179
- "endLine2": 65,
180
- "similarity": 0.7777777777777778,
181
- "snippet": " recommendations: report.recommendations.map((action: string) => ({\n action,\n estimatedImpact: 5,\n priority: 'medium',\n })),\n...",
182
- "patternType": "utility",
183
- "tokenCost": 435,
184
- "linesOfCode": 28,
185
- "severity": "minor",
186
- "reason": "Moderate similarity detected",
187
- "suggestion": "Consider extracting shared patterns if code evolves together"
188
- },
189
- {
190
- "file1": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
191
- "file2": "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
192
- "line1": 32,
193
- "line2": 35,
194
- "endLine1": 62,
195
- "endLine2": 56,
196
- "similarity": 0.6341463414634146,
197
- "snippet": " recommendations: report.recommendations.map((action: string) => ({\n action,\n estimatedImpact: 5,\n priority: 'medium',\n })),\n...",
198
- "patternType": "utility",
199
- "tokenCost": 381,
200
- "linesOfCode": 28,
201
- "severity": "minor",
202
- "reason": "Minor similarity detected",
203
- "suggestion": "Monitor but refactoring may not be worthwhile"
204
- }
205
- ],
206
- "context": [
207
- {
208
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/scan.ts",
209
- "tokenCost": 8111,
210
- "linesOfCode": 915,
211
- "importDepth": 1,
212
- "dependencyCount": 4,
213
- "dependencyList": ["chalk", "fs", "path", "../index"],
214
- "circularDeps": [],
215
- "cohesionScore": 1,
216
- "domains": ["user"],
217
- "exportCount": 2,
218
- "contextBudget": 8111,
219
- "fragmentationScore": 0.255,
220
- "relatedFiles": [
221
- "/Users/pengcao/projects/aiready/packages/cli/src/utils/helpers.ts"
222
- ],
223
- "fileClassification": "cohesive-module",
224
- "severity": "minor",
225
- "issues": ["High fragmentation (26%) - scattered implementation"],
226
- "recommendations": [
227
- "Consolidate with related files in same domain",
228
- "Module has good cohesion despite its size"
229
- ],
230
- "potentialSavings": 2433
231
- },
232
- {
233
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
234
- "tokenCost": 2709,
235
- "linesOfCode": 315,
236
- "importDepth": 1,
237
- "dependencyCount": 6,
238
- "dependencyList": [
239
- "chalk",
240
- "fs",
241
- "path",
242
- "child_process",
243
- "@aiready/core",
244
- "../utils/helpers"
245
- ],
246
- "circularDeps": [],
247
- "cohesionScore": 1,
248
- "domains": ["aiready"],
249
- "exportCount": 3,
250
- "contextBudget": 2709,
251
- "fragmentationScore": 0.02963627278071722,
252
- "relatedFiles": [
253
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
254
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
255
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
256
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
257
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
258
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
259
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
260
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
261
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
262
- ],
263
- "fileClassification": "cohesive-module",
264
- "severity": "info",
265
- "issues": ["No significant issues detected"],
266
- "recommendations": [
267
- "File is well-structured for AI context usage",
268
- "Module has good cohesion despite its size"
269
- ],
270
- "potentialSavings": 0
271
- },
272
- {
273
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
274
- "tokenCost": 2628,
275
- "linesOfCode": 317,
276
- "importDepth": 1,
277
- "dependencyCount": 4,
278
- "dependencyList": [
279
- "@aiready/pattern-detect",
280
- "@aiready/context-analyzer",
281
- "@aiready/consistency",
282
- "@aiready/core"
283
- ],
284
- "circularDeps": [],
285
- "cohesionScore": 1,
286
- "domains": ["aiready"],
287
- "exportCount": 4,
288
- "contextBudget": 2628,
289
- "fragmentationScore": 0,
290
- "relatedFiles": [
291
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
292
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
293
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
294
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
295
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
296
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
297
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
298
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
299
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
300
- ],
301
- "fileClassification": "barrel-export",
302
- "severity": "info",
303
- "issues": ["No significant issues detected"],
304
- "recommendations": [
305
- "File is well-structured for AI context usage",
306
- "Barrel export file detected - multiple domains are expected here"
307
- ],
308
- "potentialSavings": 0
309
- },
310
- {
311
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/cli.ts",
312
- "tokenCost": 2344,
313
- "linesOfCode": 278,
314
- "importDepth": 1,
315
- "dependencyCount": 4,
316
- "dependencyList": ["commander", "fs", "path", "url"],
317
- "circularDeps": [],
318
- "cohesionScore": 1,
319
- "domains": [],
320
- "exportCount": 0,
321
- "contextBudget": 2344,
322
- "fragmentationScore": 0.15,
323
- "relatedFiles": [
324
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/index.ts",
325
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/change-amplification.ts"
326
- ],
327
- "fileClassification": "cohesive-module",
328
- "severity": "minor",
329
- "issues": ["High fragmentation (15%) - scattered implementation"],
330
- "recommendations": [
331
- "Consolidate with related files in same domain",
332
- "Module has good cohesion despite its size"
333
- ],
334
- "potentialSavings": 703
335
- },
336
- {
337
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
338
- "tokenCost": 2157,
339
- "linesOfCode": 263,
340
- "importDepth": 1,
341
- "dependencyCount": 4,
342
- "dependencyList": ["chalk", "path", "@aiready/core", "../utils/helpers"],
343
- "circularDeps": [],
344
- "cohesionScore": 1,
345
- "domains": ["aiready"],
346
- "exportCount": 1,
347
- "contextBudget": 2157,
348
- "fragmentationScore": 0.02963627278071722,
349
- "relatedFiles": [
350
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
351
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
352
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
353
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
354
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
355
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
356
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
357
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
358
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
359
- ],
360
- "fileClassification": "cohesive-module",
361
- "severity": "info",
362
- "issues": ["No significant issues detected"],
363
- "recommendations": [
364
- "File is well-structured for AI context usage",
365
- "Module has good cohesion despite its size"
366
- ],
367
- "potentialSavings": 0
368
- },
369
- {
370
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
371
- "tokenCost": 1904,
372
- "linesOfCode": 233,
373
- "importDepth": 1,
374
- "dependencyCount": 5,
375
- "dependencyList": [
376
- "chalk",
377
- "fs",
378
- "path",
379
- "@aiready/core",
380
- "../utils/helpers"
381
- ],
382
- "circularDeps": [],
383
- "cohesionScore": 1,
384
- "domains": ["aiready"],
385
- "exportCount": 1,
386
- "contextBudget": 1904,
387
- "fragmentationScore": 0.02963627278071722,
388
- "relatedFiles": [
389
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
390
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
391
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
392
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
393
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
394
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
395
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
396
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
397
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
398
- ],
399
- "fileClassification": "cohesive-module",
400
- "severity": "info",
401
- "issues": ["No significant issues detected"],
402
- "recommendations": [
403
- "File is well-structured for AI context usage",
404
- "Module has good cohesion despite its size"
405
- ],
406
- "potentialSavings": 0
407
- },
408
- {
409
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
410
- "tokenCost": 1750,
411
- "linesOfCode": 221,
412
- "importDepth": 1,
413
- "dependencyCount": 4,
414
- "dependencyList": ["chalk", "path", "@aiready/core", "../utils/helpers"],
415
- "circularDeps": [],
416
- "cohesionScore": 1,
417
- "domains": ["aiready"],
418
- "exportCount": 2,
419
- "contextBudget": 1750,
420
- "fragmentationScore": 0.02963627278071722,
421
- "relatedFiles": [
422
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
423
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
424
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
425
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
426
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
427
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
428
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
429
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
430
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
431
- ],
432
- "fileClassification": "cohesive-module",
433
- "severity": "info",
434
- "issues": ["No significant issues detected"],
435
- "recommendations": [
436
- "File is well-structured for AI context usage",
437
- "Module has good cohesion despite its size"
438
- ],
439
- "potentialSavings": 0
440
- },
441
- {
442
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/utils/helpers.ts",
443
- "tokenCost": 1267,
444
- "linesOfCode": 159,
445
- "importDepth": 1,
446
- "dependencyCount": 3,
447
- "dependencyList": ["path", "fs", "chalk"],
448
- "circularDeps": [],
449
- "cohesionScore": 0.975,
450
- "domains": ["user"],
451
- "exportCount": 5,
452
- "contextBudget": 1267,
453
- "fragmentationScore": 0.17,
454
- "relatedFiles": [
455
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/scan.ts"
456
- ],
457
- "fileClassification": "utility-module",
458
- "severity": "minor",
459
- "issues": ["High fragmentation (17%) - scattered implementation"],
460
- "recommendations": [
461
- "Consolidate with related files in same domain",
462
- "Utility module detected - multiple domains are acceptable here"
463
- ],
464
- "potentialSavings": 380
465
- },
466
- {
467
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
468
- "tokenCost": 508,
469
- "linesOfCode": 74,
470
- "importDepth": 1,
471
- "dependencyCount": 2,
472
- "dependencyList": ["chalk", "@aiready/core"],
473
- "circularDeps": [],
474
- "cohesionScore": 1,
475
- "domains": ["aiready"],
476
- "exportCount": 1,
477
- "contextBudget": 508,
478
- "fragmentationScore": 0.02963627278071722,
479
- "relatedFiles": [
480
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
481
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
482
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
483
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
484
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
485
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
486
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
487
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
488
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
489
- ],
490
- "fileClassification": "cohesive-module",
491
- "severity": "info",
492
- "issues": ["No significant issues detected"],
493
- "recommendations": [
494
- "File is well-structured for AI context usage",
495
- "Module has good cohesion despite its size"
496
- ],
497
- "potentialSavings": 0
498
- },
499
- {
500
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
501
- "tokenCost": 445,
502
- "linesOfCode": 66,
503
- "importDepth": 1,
504
- "dependencyCount": 2,
505
- "dependencyList": ["chalk", "@aiready/core"],
506
- "circularDeps": [],
507
- "cohesionScore": 1,
508
- "domains": ["aiready"],
509
- "exportCount": 1,
510
- "contextBudget": 445,
511
- "fragmentationScore": 0.02963627278071722,
512
- "relatedFiles": [
513
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
514
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
515
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
516
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
517
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
518
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
519
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
520
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
521
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
522
- ],
523
- "fileClassification": "cohesive-module",
524
- "severity": "info",
525
- "issues": ["No significant issues detected"],
526
- "recommendations": [
527
- "File is well-structured for AI context usage",
528
- "Module has good cohesion despite its size"
529
- ],
530
- "potentialSavings": 0
531
- },
532
- {
533
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
534
- "tokenCost": 428,
535
- "linesOfCode": 63,
536
- "importDepth": 1,
537
- "dependencyCount": 2,
538
- "dependencyList": ["chalk", "@aiready/core"],
539
- "circularDeps": [],
540
- "cohesionScore": 1,
541
- "domains": ["aiready"],
542
- "exportCount": 1,
543
- "contextBudget": 428,
544
- "fragmentationScore": 0.02963627278071722,
545
- "relatedFiles": [
546
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
547
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
548
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
549
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
550
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
551
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
552
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
553
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
554
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
555
- ],
556
- "fileClassification": "cohesive-module",
557
- "severity": "info",
558
- "issues": ["No significant issues detected"],
559
- "recommendations": [
560
- "File is well-structured for AI context usage",
561
- "Module has good cohesion despite its size"
562
- ],
563
- "potentialSavings": 0
564
- },
565
- {
566
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts",
567
- "tokenCost": 420,
568
- "linesOfCode": 63,
569
- "importDepth": 1,
570
- "dependencyCount": 2,
571
- "dependencyList": ["chalk", "@aiready/core"],
572
- "circularDeps": [],
573
- "cohesionScore": 1,
574
- "domains": ["aiready"],
575
- "exportCount": 1,
576
- "contextBudget": 420,
577
- "fragmentationScore": 0.02963627278071722,
578
- "relatedFiles": [
579
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
580
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
581
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
582
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
583
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
584
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
585
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
586
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
587
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts"
588
- ],
589
- "fileClassification": "cohesive-module",
590
- "severity": "info",
591
- "issues": ["No significant issues detected"],
592
- "recommendations": [
593
- "File is well-structured for AI context usage",
594
- "Module has good cohesion despite its size"
595
- ],
596
- "potentialSavings": 0
597
- },
598
- {
599
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/ai-signal-clarity.ts",
600
- "tokenCost": 401,
601
- "linesOfCode": 57,
602
- "importDepth": 1,
603
- "dependencyCount": 2,
604
- "dependencyList": ["chalk", "@aiready/core"],
605
- "circularDeps": [],
606
- "cohesionScore": 1,
607
- "domains": ["aiready"],
608
- "exportCount": 1,
609
- "contextBudget": 401,
610
- "fragmentationScore": 0.02963627278071722,
611
- "relatedFiles": [
612
- "/Users/pengcao/projects/aiready/packages/cli/src/index.ts",
613
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/visualize.ts",
614
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/testability.ts",
615
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/patterns.ts",
616
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/doc-drift.ts",
617
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/deps-health.ts",
618
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/context.ts",
619
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/consistency.ts",
620
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/agent-grounding.ts"
621
- ],
622
- "fileClassification": "cohesive-module",
623
- "severity": "info",
624
- "issues": ["No significant issues detected"],
625
- "recommendations": [
626
- "File is well-structured for AI context usage",
627
- "Module has good cohesion despite its size"
628
- ],
629
- "potentialSavings": 0
630
- },
631
- {
632
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/index.ts",
633
- "tokenCost": 144,
634
- "linesOfCode": 18,
635
- "importDepth": 0,
636
- "dependencyCount": 0,
637
- "dependencyList": [],
638
- "circularDeps": [],
639
- "cohesionScore": 1,
640
- "domains": [],
641
- "exportCount": 0,
642
- "contextBudget": 144,
643
- "fragmentationScore": 0.15,
644
- "relatedFiles": [
645
- "/Users/pengcao/projects/aiready/packages/cli/src/cli.ts",
646
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/change-amplification.ts"
647
- ],
648
- "fileClassification": "cohesive-module",
649
- "severity": "minor",
650
- "issues": ["High fragmentation (15%) - scattered implementation"],
651
- "recommendations": [
652
- "Consolidate with related files in same domain",
653
- "Module has good cohesion despite its size"
654
- ],
655
- "potentialSavings": 43
656
- },
657
- {
658
- "file": "/Users/pengcao/projects/aiready/packages/cli/src/commands/change-amplification.ts",
659
- "tokenCost": 32,
660
- "linesOfCode": 4,
661
- "importDepth": 1,
662
- "dependencyCount": 1,
663
- "dependencyList": ["@aiready/change-amplification/dist/cli.js"],
664
- "circularDeps": [],
665
- "cohesionScore": 1,
666
- "domains": [],
667
- "exportCount": 0,
668
- "contextBudget": 32,
669
- "fragmentationScore": 0.15,
670
- "relatedFiles": [
671
- "/Users/pengcao/projects/aiready/packages/cli/src/cli.ts",
672
- "/Users/pengcao/projects/aiready/packages/cli/src/commands/index.ts"
673
- ],
674
- "fileClassification": "cohesive-module",
675
- "severity": "minor",
676
- "issues": ["High fragmentation (15%) - scattered implementation"],
677
- "recommendations": [
678
- "Consolidate with related files in same domain",
679
- "Module has good cohesion despite its size"
680
- ],
681
- "potentialSavings": 9
682
- }
683
- ],
684
- "scoring": {
685
- "overall": 97,
686
- "rating": "Excellent",
687
- "timestamp": "2026-02-27T13:36:13.787Z",
688
- "toolsUsed": ["pattern-detect", "context-analyzer"],
689
- "breakdown": [
690
- {
691
- "toolName": "pattern-detect",
692
- "score": 95,
693
- "rawMetrics": {
694
- "totalDuplicates": 2,
695
- "totalTokenCost": 816,
696
- "highImpactDuplicates": 1,
697
- "totalFilesAnalyzed": 15,
698
- "duplicatesPerFile": 13.3,
699
- "tokenWastePerFile": 54,
700
- "estimatedMonthlyCost": 7.34,
701
- "estimatedDeveloperHours": 1
702
- },
703
- "factors": [
704
- {
705
- "name": "Duplication Density",
706
- "impact": -8,
707
- "description": "13.3 duplicates per 100 files"
708
- },
709
- {
710
- "name": "Token Waste",
711
- "impact": 0,
712
- "description": "54 tokens wasted per file"
713
- },
714
- {
715
- "name": "High-Impact Patterns",
716
- "impact": 3,
717
- "description": "1 high-impact duplicates (>1000 tokens or >70% similar)"
718
- }
719
- ],
720
- "recommendations": [
721
- {
722
- "action": "Deduplicate 1 high-impact pattern",
723
- "estimatedImpact": 3,
724
- "priority": "high"
725
- }
726
- ]
727
- },
728
- {
729
- "toolName": "context-analyzer",
730
- "score": 100,
731
- "rawMetrics": {
732
- "avgContextBudget": 1683,
733
- "maxContextBudget": 8111,
734
- "avgImportDepth": 0.9,
735
- "maxImportDepth": 1,
736
- "avgFragmentation": 0.08,
737
- "criticalIssues": 0,
738
- "majorIssues": 0,
739
- "estimatedMonthlyCost": 227.23,
740
- "estimatedDeveloperHours": 0
741
- },
742
- "factors": [
743
- {
744
- "name": "Context Budget",
745
- "impact": 0,
746
- "description": "Avg 1683 tokens per file (excellent)"
747
- },
748
- {
749
- "name": "Import Depth",
750
- "impact": 0,
751
- "description": "Avg 0.9 levels (excellent)"
752
- },
753
- {
754
- "name": "Fragmentation",
755
- "impact": 0,
756
- "description": "8% fragmentation (well-organized)"
757
- }
758
- ],
759
- "recommendations": []
760
- }
761
- ],
762
- "calculation": {
763
- "formula": "[(95 × 22) + (100 × 19)] / 41 = 97",
764
- "weights": {
765
- "pattern-detect": 22,
766
- "context-analyzer": 19
767
- },
768
- "normalized": "[(95 × 22) + (100 × 19)] / 41 = 97"
769
- }
770
- }
771
- }