devcompass 2.3.0 → 2.3.1
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 +52 -47
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
cd ~/devCampuss
|
|
2
|
+
cat > README.md << 'EOF'
|
|
1
3
|
# 🧭 DevCompass
|
|
2
4
|
|
|
3
5
|
**Dependency health checker with ecosystem intelligence for JavaScript/TypeScript projects**
|
|
@@ -8,16 +10,29 @@
|
|
|
8
10
|
|
|
9
11
|
Analyze your JavaScript projects to find unused dependencies, outdated packages, **detect security vulnerabilities**, **check bundle sizes**, **verify licenses**, and **automatically fix issues** with a single command. Perfect for **CI/CD pipelines** with JSON output and exit codes.
|
|
10
12
|
|
|
13
|
+
> **NEW in v2.3.1:** Fixed all security vulnerabilities! Health score: 2.5/10 → 8/10 🔒
|
|
11
14
|
> **NEW in v2.3:** Security scanning, bundle analysis & license checker! 🔐
|
|
12
15
|
> **NEW in v2.2:** CI/CD integration with JSON output & smart caching! 🚀
|
|
13
16
|
> **NEW in v2.1:** Auto-fix command! 🔧 Fix critical issues automatically!
|
|
14
17
|
> **NEW in v2.0:** Real-time ecosystem alerts for known issues! 🚨
|
|
15
18
|
|
|
19
|
+
## 🎉 Latest Update: v2.3.1
|
|
20
|
+
|
|
21
|
+
**We practice what we preach!** After releasing v2.3.0 with security scanning, we ran DevCompass on itself and found 14 vulnerabilities. We fixed them all:
|
|
22
|
+
|
|
23
|
+
- ✅ **Health score improved:** 2.5/10 → 8/10
|
|
24
|
+
- ✅ **Security vulnerabilities:** 14 → 0
|
|
25
|
+
- ✅ **Bundle size reduced:** 9.1 MB → 6.2 MB (32% smaller)
|
|
26
|
+
- ✅ **Dependencies upgraded:** npm-check-updates v16 → v20
|
|
27
|
+
- ✅ **Removed 315 vulnerable packages**
|
|
28
|
+
|
|
29
|
+
This is what "eating your own dog food" looks like. DevCompass helps you catch and fix security issues before they reach production.
|
|
30
|
+
|
|
16
31
|
## ✨ Features
|
|
17
32
|
|
|
18
|
-
- 🔐 **Security Scanning** (
|
|
19
|
-
- 📦 **Bundle Size Analysis** (
|
|
20
|
-
- ⚖️ **License Checker** (
|
|
33
|
+
- 🔐 **Security Scanning** (v2.3) - npm audit integration with severity breakdown
|
|
34
|
+
- 📦 **Bundle Size Analysis** (v2.3) - Identify heavy packages (> 1MB)
|
|
35
|
+
- ⚖️ **License Checker** (v2.3) - Detect restrictive licenses (GPL, AGPL)
|
|
21
36
|
- 🚀 **CI/CD Integration** (v2.2) - JSON output, exit codes, and silent mode
|
|
22
37
|
- ⚡ **Smart Caching** (v2.2) - 70% faster on repeated runs
|
|
23
38
|
- 🎛️ **Advanced Filtering** (v2.2) - Control alerts by severity level
|
|
@@ -65,11 +80,11 @@ devcompass analyze --ci
|
|
|
65
80
|
devcompass analyze --silent
|
|
66
81
|
```
|
|
67
82
|
|
|
68
|
-
## 🔐
|
|
83
|
+
## 🔐 Security & Compliance Features
|
|
69
84
|
|
|
70
85
|
### Security Vulnerability Scanning
|
|
71
86
|
|
|
72
|
-
DevCompass
|
|
87
|
+
DevCompass integrates with **npm audit** to detect security vulnerabilities automatically!
|
|
73
88
|
|
|
74
89
|
**Example Output:**
|
|
75
90
|
```
|
|
@@ -141,22 +156,18 @@ Detect restrictive licenses that may require legal review!
|
|
|
141
156
|
- ⚠️ **Restrictive:** GPL, AGPL, LGPL
|
|
142
157
|
- ❓ **Unknown:** Missing or custom licenses
|
|
143
158
|
|
|
144
|
-
### Combined Analysis Example
|
|
159
|
+
### Combined Analysis Example
|
|
145
160
|
|
|
146
161
|
**Full Output:**
|
|
147
162
|
```
|
|
148
|
-
🔍 DevCompass v2.3.
|
|
163
|
+
🔍 DevCompass v2.3.1 - Analyzing your project...
|
|
149
164
|
✔ Scanned 25 dependencies in project
|
|
150
165
|
|
|
151
166
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
152
167
|
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
🔴 CRITICAL: 1
|
|
156
|
-
🟠 HIGH: 2
|
|
157
|
-
🟡 MODERATE: 2
|
|
168
|
+
✅ SECURITY VULNERABILITIES
|
|
158
169
|
|
|
159
|
-
|
|
170
|
+
No vulnerabilities detected!
|
|
160
171
|
|
|
161
172
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
162
173
|
|
|
@@ -178,42 +189,36 @@ Detect restrictive licenses that may require legal review!
|
|
|
178
189
|
|
|
179
190
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
180
191
|
|
|
181
|
-
|
|
192
|
+
✅ LICENSE COMPLIANCE
|
|
182
193
|
|
|
183
|
-
|
|
194
|
+
All licenses are permissive!
|
|
184
195
|
|
|
185
196
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
186
197
|
|
|
187
198
|
📊 PROJECT HEALTH
|
|
188
199
|
|
|
189
|
-
Overall Score:
|
|
200
|
+
Overall Score: 8.5/10
|
|
190
201
|
Total Dependencies: 25
|
|
191
|
-
Security Vulnerabilities: 5
|
|
192
202
|
Ecosystem Alerts: 1
|
|
193
203
|
Unused: 0
|
|
194
|
-
Outdated:
|
|
204
|
+
Outdated: 2
|
|
195
205
|
|
|
196
206
|
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
197
207
|
|
|
198
208
|
💡 QUICK WINS
|
|
199
209
|
|
|
200
|
-
🔐 Fix security vulnerabilities:
|
|
201
|
-
|
|
202
|
-
npm audit fix
|
|
203
|
-
|
|
204
210
|
🔴 Fix critical issues:
|
|
205
211
|
|
|
206
212
|
npm install axios@1.6.2
|
|
207
213
|
|
|
208
214
|
Expected impact:
|
|
209
|
-
✓ Resolve security vulnerabilities
|
|
210
215
|
✓ Resolve critical stability issues
|
|
211
|
-
✓ Improve health score →
|
|
216
|
+
✓ Improve health score → 10/10
|
|
212
217
|
|
|
213
218
|
💡 TIP: Run 'devcompass fix' to apply these fixes automatically!
|
|
214
219
|
```
|
|
215
220
|
|
|
216
|
-
## 🚀 CI/CD Integration
|
|
221
|
+
## 🚀 CI/CD Integration
|
|
217
222
|
|
|
218
223
|
### JSON Output
|
|
219
224
|
Perfect for parsing in CI/CD pipelines:
|
|
@@ -221,28 +226,28 @@ Perfect for parsing in CI/CD pipelines:
|
|
|
221
226
|
devcompass analyze --json
|
|
222
227
|
```
|
|
223
228
|
|
|
224
|
-
**Output
|
|
229
|
+
**Output:**
|
|
225
230
|
```json
|
|
226
231
|
{
|
|
227
|
-
"version": "2.3.
|
|
232
|
+
"version": "2.3.1",
|
|
228
233
|
"timestamp": "2026-04-02T10:30:00.000Z",
|
|
229
234
|
"summary": {
|
|
230
|
-
"healthScore":
|
|
235
|
+
"healthScore": 8.5,
|
|
231
236
|
"totalDependencies": 25,
|
|
232
|
-
"securityVulnerabilities":
|
|
237
|
+
"securityVulnerabilities": 0,
|
|
233
238
|
"ecosystemAlerts": 1,
|
|
234
239
|
"unusedDependencies": 0,
|
|
235
|
-
"outdatedPackages":
|
|
240
|
+
"outdatedPackages": 2,
|
|
236
241
|
"heavyPackages": 2,
|
|
237
|
-
"licenseWarnings":
|
|
242
|
+
"licenseWarnings": 0
|
|
238
243
|
},
|
|
239
244
|
"security": {
|
|
240
|
-
"total":
|
|
241
|
-
"critical":
|
|
242
|
-
"high":
|
|
243
|
-
"moderate":
|
|
245
|
+
"total": 0,
|
|
246
|
+
"critical": 0,
|
|
247
|
+
"high": 0,
|
|
248
|
+
"moderate": 0,
|
|
244
249
|
"low": 0,
|
|
245
|
-
"vulnerabilities": [
|
|
250
|
+
"vulnerabilities": []
|
|
246
251
|
},
|
|
247
252
|
"bundleAnalysis": {
|
|
248
253
|
"heavyPackages": [
|
|
@@ -251,12 +256,10 @@ devcompass analyze --json
|
|
|
251
256
|
]
|
|
252
257
|
},
|
|
253
258
|
"licenses": {
|
|
254
|
-
"warnings": [
|
|
255
|
-
{ "package": "sharp", "license": "LGPL-3.0", "type": "restrictive" }
|
|
256
|
-
]
|
|
259
|
+
"warnings": []
|
|
257
260
|
},
|
|
258
261
|
"ecosystemAlerts": [...],
|
|
259
|
-
"unusedDependencies": [
|
|
262
|
+
"unusedDependencies": [],
|
|
260
263
|
"outdatedPackages": [...]
|
|
261
264
|
}
|
|
262
265
|
```
|
|
@@ -293,7 +296,7 @@ devcompass analyze --silent
|
|
|
293
296
|
echo $? # Check exit code
|
|
294
297
|
```
|
|
295
298
|
|
|
296
|
-
## ⚡ Smart Caching
|
|
299
|
+
## ⚡ Smart Caching
|
|
297
300
|
|
|
298
301
|
DevCompass caches results to improve performance:
|
|
299
302
|
|
|
@@ -318,7 +321,7 @@ DevCompass caches results to improve performance:
|
|
|
318
321
|
}
|
|
319
322
|
```
|
|
320
323
|
|
|
321
|
-
## 🎛️ Advanced Configuration
|
|
324
|
+
## 🎛️ Advanced Configuration
|
|
322
325
|
|
|
323
326
|
Create `devcompass.config.json` in your project root:
|
|
324
327
|
```json
|
|
@@ -373,7 +376,7 @@ Create `devcompass.config.json` in your project root:
|
|
|
373
376
|
}
|
|
374
377
|
```
|
|
375
378
|
|
|
376
|
-
## 🔧 Auto-Fix Command
|
|
379
|
+
## 🔧 Auto-Fix Command
|
|
377
380
|
|
|
378
381
|
DevCompass can **automatically fix issues** in your project!
|
|
379
382
|
|
|
@@ -415,7 +418,7 @@ devcompass fix
|
|
|
415
418
|
devcompass analyze
|
|
416
419
|
```
|
|
417
420
|
|
|
418
|
-
## 🚨 Ecosystem Intelligence
|
|
421
|
+
## 🚨 Ecosystem Intelligence
|
|
419
422
|
|
|
420
423
|
DevCompass tracks **real-world issues** in popular packages and warns you before they break production!
|
|
421
424
|
|
|
@@ -468,7 +471,7 @@ DevCompass won't flag these as unused (they're typically used in config files):
|
|
|
468
471
|
- Shows current vs latest versions
|
|
469
472
|
- Indicates update type (major/minor/patch)
|
|
470
473
|
|
|
471
|
-
### Health Score
|
|
474
|
+
### Health Score
|
|
472
475
|
Calculated from 0-10 based on:
|
|
473
476
|
- Percentage of unused dependencies (−4 points per 100%)
|
|
474
477
|
- Percentage of outdated packages (−3 points per 100%)
|
|
@@ -698,7 +701,7 @@ Check out DevCompass stats:
|
|
|
698
701
|
|
|
699
702
|
## 🌟 What's Next?
|
|
700
703
|
|
|
701
|
-
### Roadmap
|
|
704
|
+
### Roadmap
|
|
702
705
|
- [x] ~~Automatic fix command~~ ✅ **Added in v2.1!**
|
|
703
706
|
- [x] ~~CI/CD integration with JSON output~~ ✅ **Added in v2.2!**
|
|
704
707
|
- [x] ~~Smart caching system~~ ✅ **Added in v2.2!**
|
|
@@ -706,6 +709,7 @@ Check out DevCompass stats:
|
|
|
706
709
|
- [x] ~~npm audit integration~~ ✅ **Added in v2.3!**
|
|
707
710
|
- [x] ~~Bundle size analysis~~ ✅ **Added in v2.3!**
|
|
708
711
|
- [x] ~~License compliance checker~~ ✅ **Added in v2.3!**
|
|
712
|
+
- [x] ~~Fix all security vulnerabilities~~ ✅ **Fixed in v2.3.1!**
|
|
709
713
|
- [ ] GitHub Issues API for real-time issue tracking (v2.4.0)
|
|
710
714
|
- [ ] Automated security patch suggestions (v2.4.0)
|
|
711
715
|
- [ ] Dependency graph visualization (v2.5.0)
|
|
@@ -722,4 +726,5 @@ Want to contribute? Pick an item and open an issue! 🚀
|
|
|
722
726
|
|
|
723
727
|
*DevCompass - Keep your dependencies healthy!* 🧭
|
|
724
728
|
|
|
725
|
-
**Like Lighthouse for your dependencies** ⚡
|
|
729
|
+
**Like Lighthouse for your dependencies** ⚡
|
|
730
|
+
EOF
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "devcompass",
|
|
3
|
-
"version": "2.3.
|
|
3
|
+
"version": "2.3.1",
|
|
4
4
|
"description": "Dependency health checker with ecosystem intelligence for JavaScript/TypeScript projects",
|
|
5
5
|
"main": "src/index.js",
|
|
6
6
|
"bin": {
|
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
"chalk": "^4.1.2",
|
|
45
45
|
"commander": "^11.1.0",
|
|
46
46
|
"depcheck": "^1.4.7",
|
|
47
|
-
"npm-check-updates": "^
|
|
47
|
+
"npm-check-updates": "^20.0.0",
|
|
48
48
|
"ora": "^5.4.1",
|
|
49
49
|
"semver": "^7.6.0"
|
|
50
50
|
},
|