code-ai-installer 1.2.0 → 1.3.0

package/locales/en/.agents/dependency_supply_chain_review/SKILL.md

@@ -1,20 +1,300 @@
 ---
 name: dependency_supply_chain_review
-description: Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.
+description: Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages.
 ---
 
 #Skill: Dependency & Supply Chain Review
 
-## Check
-- New dependencies are really needed (no unnecessary ones)
-- Versions are not outdated/vulnerable (according to available reports/project audit)
-- Lockfile updated correctly
-- No “questionable” packages for critical functions
-- Licenses are acceptable (if the project requires)
+Audit npm-dependencies: vulnerabilities, licenses, suspicious packages.
 
-## Exit
-- List of suspicious/unnecessary packages
-- Recommendations: delete/replace/fix version
+**Sections:**
+1. [When to activate](#1-when)
+2. [Audit Commands](#2-audit)
+3. [Checklist](#3-checklist)
+4. [Red Flags](#4-red-flags)
+5. [License Policy](#5-licenses)
+6. [Decision Framework](#6-decision)
+7. [CI Integration](#7-ci)
+8. [Output Template](#8-output)
+
+---
+
+## 1. When to activate
+
+| Trigger | Action |
+|---------|--------|
+| New dependency added | Full review of the package |
+| PR with `package.json` / `package-lock.json` changes | Diff review + audit |
+| Periodic review (monthly) | Full audit |
+| Security alert (GitHub Dependabot, npm advisory) | Targeted review |
+| Major version upgrade | Changelog review + test |
+| Pre-release gate | Full audit as part of RG checklist |
+
+---
+
+## 2. Audit Commands
+
+### Essential commands
+
+```bash
+# Vulnerability audit (fail on high/critical)
+npm audit --audit-level=high
+
+# Detailed audit (JSON for parsing)
+npm audit --json
+
+# List outdated packages
+npm outdated
+
+# Check licenses
+npx license-checker --summary
+
+# Check licenses with allowed list
+npx license-checker --onlyAllow "MIT;ISC;BSD-2-Clause;BSD-3-Clause;Apache-2.0"
+
+# Find unused dependencies
+npx depcheck
+
+# Package size analysis
+npx cost-of-modules
+
+# Check package popularity/health
+npx npm-check
+
+# Lock file integrity
+npm ci --dry-run
+```
+
+### Grep for suspicious patterns
+
+```bash
+# Postinstall scripts (supply chain attack vector)
+grep_search: Query="postinstall" SearchPath="package.json"
+grep_search: Query="preinstall" SearchPath="package.json"
+
+# Native bindings (potential security risk)
+grep_search: Query="node-gyp" SearchPath="package-lock.json"
+grep_search: Query="prebuild" SearchPath="package-lock.json"
+```
+
+---
+
+## 3. Checklist
+
+### 3.1 Necessity
+
+| # | Check | Severity | Status |
+|---|-------|----------|--------|
+| DEP-01 | Each dependency is actually used (no dead deps) | 🟠 P1 | ☐ |
+| DEP-02 | No duplicate packages for same purpose (e.g. 2 date libs) | 🟠 P1 | ☐ |
+| DEP-03 | Could be replaced with native API (e.g. `fetch` vs `axios`, `crypto` vs `uuid`) | 🟡 P2 | ☐ |
+| DEP-04 | Dev dependencies are in `devDependencies`, not `dependencies` | 🟠 P1 | ☐ |
+
+### 3.2 Security
+
+| # | Check | Severity | Status |
+|---|-------|----------|--------|
+| DEP-05 | `npm audit` — no high/critical vulnerabilities | 🔴 P0 | ☐ |
+| DEP-06 | `package-lock.json` committed and up to date | 🔴 P0 | ☐ |
+| DEP-07 | No `npm install` with `--force` or `--legacy-peer-deps` (unless justified) | 🟠 P1 | ☐ |
+| DEP-08 | No postinstall scripts from untrusted packages | 🔴 P0 | ☐ |
+| DEP-09 | Packages use well-known publishers (npm org verified) | 🟠 P1 | ☐ |
+
+### 3.3 Maintenance
+
+| # | Check | Severity | Status |
+|---|-------|----------|--------|
+| DEP-10 | No abandoned packages (last publish > 2 years, no maintainer) | 🟠 P1 | ☐ |
+| DEP-11 | Major version not overly outdated (< 2 major versions behind) | 🟠 P1 | ☐ |
+| DEP-12 | Critical deps have alternatives identified (bus factor) | 🟡 P2 | ☐ |
+| DEP-13 | Version pinning strategy defined (exact vs range vs caret) | 🟡 P2 | ☐ |
+
+### 3.4 License
+
+| # | Check | Severity | Status |
+|---|-------|----------|--------|
+| DEP-14 | All licenses are permissive (MIT, ISC, BSD, Apache-2.0) | 🟠 P1 | ☐ |
+| DEP-15 | No GPL/AGPL/SSPL in production dependencies (if proprietary project) | 🔴 P0 | ☐ |
+| DEP-16 | No UNLICENSED packages in production | 🟠 P1 | ☐ |
+
+---
+
+## 4. Red Flags
+
+### Package red flags
+
+| 🚩 Red Flag | Risk | Example |
+|------------|------|---------|
+| **Typosquatting** | Malicious package with similar name | `lodahs` instead of `lodash` |
+| **No README / empty repo** | Placeholder for attack | New package with 0 downloads |
+| **Excessive permissions** | postinstall runs arbitrary code | `"postinstall": "curl | sh"` |
+| **Single maintainer, no org** | Bus factor = 1, takeover risk | Unmaintained personal project |
+| **Version 0.0.x** | Unstable, breaking changes | Not ready for production |
+| **Last publish > 2 years** | Abandoned, no security patches | `is-promise` (1 line, 3M downloads) |
+| **Huge transitive deps** | Giant attack surface | One util bringing 100+ sub-deps |
+| **Native bindings** | Build-time vulnerabilities | `node-gyp` based packages |
+| **Filesystem / network access** | Unexpected side effects | Package writes to disk or phones home |
+
+### Quick health check for new dependency
+
+```markdown
+Before adding `npm install <package>`:
+
+1. ☐ npm page: weekly downloads > 10K? last publish < 1 year?
+2. ☐ GitHub: stars > 100? open issues managed? CI passing?
+3. ☐ License: MIT/ISC/BSD/Apache?
+4. ☐ Bundle size: acceptable? (bundlephobia.com)
+5. ☐ Alternatives: is there a smaller/native option?
+6. ☐ Transitive deps: how many sub-dependencies?
+```
+
+---
+
+## 5. License Policy
+
+### Allowed licenses (production)
+
+| License | Status | Notes |
+|---------|--------|-------|
+| MIT | ✅ Allowed | Most permissive |
+| ISC | ✅ Allowed | npm default |
+| BSD-2-Clause | ✅ Allowed | Permissive |
+| BSD-3-Clause | ✅ Allowed | Permissive |
+| Apache-2.0 | ✅ Allowed | Patent grant included |
+| 0BSD | ✅ Allowed | Public domain equivalent |
+| CC0-1.0 | ✅ Allowed | Public domain |
+| Unlicense | ⚠️ Review | May have legal ambiguity |
+| GPL-2.0 | ❌ Blocked | Copyleft, infectious |
+| GPL-3.0 | ❌ Blocked | Copyleft, infectious |
+| AGPL-3.0 | ❌ Blocked | Most restrictive copyleft |
+| SSPL | ❌ Blocked | MongoDB's copyleft variant |
+| UNLICENSED | ❌ Blocked | No license = all rights reserved |
+
+---
+
+## 6. Decision Framework
+
+### Keep vs Remove vs Replace
+
+```
+New dependency request:
+                          ┌──────────────────────────┐
+                          │ Is it actually needed?     │
+                          └────┬────────────┬──────────┘
+                               │ Yes        │ No
+                               ▼            ▼
+                          ┌────────┐    REMOVE
+                          │ Native │
+                          │ API?   │
+                          └─┬────┬─┘
+                       Yes  │    │ No
+                            ▼    ▼
+                         REMOVE  ┌────────────┐
+                                 │ Audit pass? │
+                                 └─┬────────┬──┘
+                              Yes  │        │ No
+                                   ▼        ▼
+                              ┌─────────┐  FIND
+                              │ License │  ALTERNATIVE
+                              │  OK?    │
+                              └─┬─────┬─┘
+                             Yes │    │ No
+                                 ▼    ▼
+                               ADD   FIND
+                                     ALTERNATIVE
+```
+
+### Alternatives for common packages
+
+| Package | Size | Alternative | Size |
+|---------|------|-------------|------|
+| `moment` | 290KB | `dayjs` (2KB) or native `Intl` | 0-2KB |
+| `lodash` | 530KB | `lodash-es` (tree-shakeable) or native | 0-70KB |
+| `axios` | 29KB | native `fetch` | 0KB |
+| `uuid` | 18KB | `crypto.randomUUID()` | 0KB |
+| `chalk` | 15KB | `picocolors` (2KB) | 2KB |
+| `dotenv` | 7KB | native `--env-file` (Node 20.6+) | 0KB |
+| `express-validator` | 35KB | `zod` (already in stack) | 0KB extra |
+
+---
+
+## 7. CI Integration
+
+### GitHub Actions
+
+```yaml
+dependency-review:
+  runs-on: ubuntu-latest
+  steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with: { node-version: 20 }
+
+    # Vulnerability check
+    - name: npm audit
+      run: npm audit --audit-level=high
+
+    # License check
+    - name: License compliance
+      run: npx license-checker --onlyAllow "MIT;ISC;BSD-2-Clause;BSD-3-Clause;Apache-2.0;0BSD"
+
+    # Unused deps
+    - name: Depcheck
+      run: npx depcheck --ignores="@types/*,vitest"
+
+    # PR dependency review (for pull requests)
+    - name: Dependency Review
+      if: github.event_name == 'pull_request'
+      uses: actions/dependency-review-action@v4
+      with:
+        fail-on-severity: high
+        deny-licenses: GPL-2.0, GPL-3.0, AGPL-3.0
+```
+
+---
+
+## 8. Output Template
+
+```markdown
+# Dependency & Supply Chain Review
+
+**Date:** YYYY-MM-DD
+**Reviewer:** Reviewer Agent
+**Total deps:** production: XX, dev: YY
+
+## Audit Results
+| Check | Result |
+|-------|--------|
+| npm audit | ✅ No high/critical |
+| License check | ⚠️ 1 GPL package found |
+| Unused deps | ✅ All used |
+| Outdated (major) | ⚠️ 3 packages behind |
+
+## Findings
+
+| # | Severity | Package | Finding | Action |
+|---|----------|---------|---------|--------|
+| 1 | 🔴 P0 | `event-stream@3.3.6` | Known supply chain attack | Remove immediately |
+| 2 | 🟠 P1 | `moment@2.29.1` | 290KB, abandoned | Replace with dayjs |
+| 3 | 🟠 P1 | `some-lib@0.1.0` | GPL-3.0 license | Replace or get legal approval |
+| 4 | 🟡 P2 | `lodash@4.17.21` | Only using `debounce` | Replace with `lodash.debounce` or native |
+
+## New Dependencies (this PR)
+| Package | Version | Size | License | Downloads/week | Verdict |
+|---------|---------|------|---------|----------------|---------|
+| `zod` | 3.22.0 | 13KB | MIT | 8M | ✅ Approved |
+
+## Summary
+- P0: X findings (must fix)
+- P1: Y findings (should fix)
+- P2: Z findings (optional)
+- Total bundle impact: +XX KB
+```
+
+---
 
 ## See also
-- Examples and anti-examples: $review_reference_snippets
+- `$security_review` — application security review
+- `$security_baseline_dev` — secure coding patterns
+- `$cloud_infrastructure_security` — CI/CD pipeline security
+- `$tooling_bun_biome` — package manager setup

package/locales/en/.agents/dependency_supply_chain_review/agents/claude.json

@@ -1,12 +1,13 @@
 {
   "name": "dependency_supply_chain_review",
-  "display_name": "Dependency review",
-  "description": "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.",
-  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill.",
+  "display_name": "Vulnerability audit (fail on high/critical)",
+  "description": "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages.",
+  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill.",
   "triggers": [
     "dependency_supply_chain_review",
     "dependency supply chain review",
-    "Dependency review"
+    "Vulnerability audit (fail on high/critical)",
+    "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages"
   ],
   "capabilities": [
     "dependency",

package/locales/en/.agents/dependency_supply_chain_review/agents/copilot.json

@@ -1,12 +1,13 @@
 {
   "name": "dependency_supply_chain_review",
-  "display_name": "Dependency review",
-  "description": "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.",
-  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill.",
+  "display_name": "Vulnerability audit (fail on high/critical)",
+  "description": "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages.",
+  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill.",
   "triggers": [
     "dependency_supply_chain_review",
     "dependency supply chain review",
-    "Dependency review"
+    "Vulnerability audit (fail on high/critical)",
+    "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages"
   ],
   "capabilities": [
     "dependency",

package/locales/en/.agents/dependency_supply_chain_review/agents/gemini.json

@@ -1,12 +1,13 @@
 {
   "name": "dependency_supply_chain_review",
-  "display_name": "Dependency review",
-  "description": "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.",
-  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill.",
+  "display_name": "Vulnerability audit (fail on high/critical)",
+  "description": "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages.",
+  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill.",
   "triggers": [
     "dependency_supply_chain_review",
     "dependency supply chain review",
-    "Dependency review"
+    "Vulnerability audit (fail on high/critical)",
+    "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages"
   ],
   "capabilities": [
     "dependency",

package/locales/en/.agents/dependency_supply_chain_review/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
-  display_name: "Dependency review"
-  short_description: "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe pack…"
-  default_prompt: "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill."
+  display_name: "Vulnerability audit (fail on high/critical)"
+  short_description: "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages."
+  default_prompt: "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill."
 dependencies:
   tools: []
 policy:

package/locales/en/.agents/dependency_supply_chain_review/agents/qwen.json

@@ -1,12 +1,13 @@
 {
   "name": "dependency_supply_chain_review",
-  "display_name": "Dependency review",
-  "description": "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages.",
-  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill.",
+  "display_name": "Vulnerability audit (fail on high/critical)",
+  "description": "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages.",
+  "default_prompt": "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill.",
   "triggers": [
     "dependency_supply_chain_review",
     "dependency supply chain review",
-    "Dependency review"
+    "Vulnerability audit (fail on high/critical)",
+    "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages"
   ],
   "capabilities": [
     "dependency",

package/locales/en/.agents/dependency_supply_chain_review/agents/skill.yaml

@@ -1,12 +1,13 @@
 version: 1
 name: "dependency_supply_chain_review"
-display_name: "Dependency review"
-description: "Dependency review: minimization, updates, vulnerability audit, licenses, banning of unsafe packages."
-default_prompt: "Use $dependency_supply_chain_review when the task matches the \"Dependency review\" skill."
+display_name: "Vulnerability audit (fail on high/critical)"
+description: "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages."
+default_prompt: "Use $dependency_supply_chain_review when the task matches the \"Vulnerability audit (fail on high/critical)\" skill."
 triggers:
   - "dependency_supply_chain_review"
   - "dependency supply chain review"
-  - "Dependency review"
+  - "Vulnerability audit (fail on high/critical)"
+  - "Review dependencies — minimization, updates, audit vulnerability, licenses, ban unsafe packages"
 capabilities:
   - "dependency"
   - "supply"