code-ai-installer 1.3.0 → 1.4.0

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

@@ -0,0 +1,300 @@
+---
+name: dependency_supply_chain_review
+description: Dependency review — minimization, updates, vulnerability audit, licenses, prohibition of unsafe packages.
+---
+
+# Skill: Dependency & Supply Chain Review
+
+Audit of npm dependencies: vulnerabilities, licenses, suspicious packages.
+
+**Sections:**
+1. [When to activate](#1-when-to-activate)
+2. [Audit Commands](#2-audit-commands)
+3. [Checklist](#3-checklist)
+4. [Red Flags](#4-red-flags)
+5. [License Policy](#5-license-policy)
+6. [Decision Framework](#6-decision-framework)
+7. [CI Integration](#7-ci-integration)
+8. [Output Template](#8-output-template)
+
+---
+
+## 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
+- `$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/skills/deployment_ci_plan/SKILL.md

@@ -0,0 +1,409 @@
+---
+name: deployment_ci_plan
+description: Deployment and CI plan — environments, configs, secrets, migrations, checks in CI (tests/lint/security), release and rollback strategy.
+---
+
+# Skill: Deployment & CI Plan
+
+Reproducible build → test → deploy process.
+
+**Sections:**
+1. [Environments](#1-environments)
+2. [Config & Secrets](#2-config-secrets)
+3. [Docker Setup](#3-docker-setup)
+4. [CI Pipeline](#4-ci-pipeline)
+5. [DB Migrations](#5-db-migrations)
+6. [Release Strategy](#6-release-strategy)
+7. [Rollback Plan](#7-rollback-plan)
+8. [Smoke Tests](#8-smoke-tests)
+9. [Example](#9-example)
+10. [Output Template](#10-output-template)
+
+---
+
+## 1. Environments
+
+| Env | Purpose | URL | Deploy trigger | Infra |
+|-----|---------|-----|---------------|-------|
+| **local** | Development | `https://localhost:5173` | Manual (`docker compose up`) | Docker Compose |
+| **staging** | Pre-release testing | `https://staging.example.com` | Push to `staging` branch | Docker Compose / K8s |
+| **production** | Live users | `https://app.example.com` | Tag `v*` or manual approval | Docker Compose / K8s |
+
+### Environment parity rule
+
+> Dev, staging, and production use **the same Docker images**. Only env vars differ.
+
+---
+
+## 2. Config & Secrets
+
+### Env vars registry
+
+| Variable | Required | Default | Env | Description |
+|----------|:--------:|---------|-----|-------------|
+| `NODE_ENV` | ✅ | — | all | `development` / `production` |
+| `PORT` | ⬜ | 3000 | all | API server port |
+| `MONGODB_URI` | ✅ | — | all | MongoDB connection string |
+| `VITE_API_URL` | ✅ | — | FE | API base URL for frontend |
+| `EXTERNAL_API_KEY` | ⬜ | — | BE | External service API key (if applicable) |
+| `EXTERNAL_API_SECRET` | ⬜ | — | BE | External service secret (sensitive!) |
+| `LOG_LEVEL` | ⬜ | info | BE | pino log level |
+
+### Secrets policy
+
+| Rule | How |
+|------|-----|
+| **Storage** | `.env` local, Docker secrets / K8s secrets / Vault for prod |
+| **Never in code** | grep check in CI |
+| **Never in logs** | pino redact config |
+| **Never in Docker image** | ARG for build, ENV for runtime only |
+| **Rotation** | Document rotation procedure per secret |
+| **.env.example** | Committed, no real values, all vars listed |
+
+---
+
+## 3. Docker Setup
+
+### Dockerfile (multi-stage, Node.js)
+
+```dockerfile
+# ── Build stage ──
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci --ignore-scripts
+COPY . .
+RUN npm run build
+
+# ── Runtime stage ──
+FROM node:20-alpine AS runtime
+WORKDIR /app
+ENV NODE_ENV=production
+RUN addgroup -g 1001 appgroup && \
+    adduser -u 1001 -G appgroup -s /bin/sh -D appuser
+COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
+COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
+COPY --from=builder --chown=appuser:appgroup /app/package.json ./
+USER appuser
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:3000/health/live || exit 1
+CMD ["node", "dist/server.js"]
+```
+
+### Docker Compose (development)
+
+```yaml
+version: "3.9"
+services:
+  api:
+    build:
+      context: ./api
+      dockerfile: Dockerfile
+    ports:
+      - "3000:3000"
+    env_file: ./api/.env
+    depends_on:
+      mongo:
+        condition: service_healthy
+    restart: unless-stopped
+
+  dashboard:
+    build:
+      context: ./dashboard
+      dockerfile: Dockerfile
+    ports:
+      - "3001:3001"
+    env_file: ./dashboard/.env
+    restart: unless-stopped
+
+  mongo:
+    image: mongo:7
+    ports:
+      - "27017:27017"
+    volumes:
+      - mongo_data:/data/db
+    healthcheck:
+      test: mongosh --eval "db.adminCommand('ping')"
+      interval: 10s
+      timeout: 5s
+      retries: 5
+
+  gateway:
+    image: caddy:2-alpine
+    ports:
+      - "5173:5173"
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+    depends_on:
+      - api
+      - dashboard
+
+volumes:
+  mongo_data:
+```
+
+### Docker rules
+
+| Rule | Description |
+|------|-------------|
+| **Multi-stage** | Builder → Runtime (smaller image, no dev deps) |
+| **Non-root** | `USER appuser` (never root in runtime) |
+| **Lockfile** | `npm ci` (deterministic installs) |
+| **HEALTHCHECK** | Built into Dockerfile or docker-compose |
+| **Cache-friendly** | Copy `package*.json` before source code |
+| **No secrets** | Never `COPY .env`, use `env_file` in compose |
+| **.dockerignore** | `node_modules`, `.env`, `.git`, `*.log` |
+
+---
+
+## 4. CI Pipeline
+
+### GitHub Actions example
+
+```yaml
+name: CI
+on:
+  push:
+    branches: [main, staging]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm ci
+      - run: npx biome check .
+
+  test:
+    runs-on: ubuntu-latest
+    needs: lint
+    services:
+      mongo:
+        image: mongo:7
+        ports: ["27017:27017"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm ci
+      - run: npm test
+        env:
+          MONGODB_URI: mongodb://localhost:27017/test
+
+  security:
+    runs-on: ubuntu-latest
+    needs: lint
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with: { node-version: 20 }
+      - run: npm ci
+      - run: npm audit --audit-level=high
+      - run: npx secretlint "**/*"
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, security]
+    steps:
+      - uses: actions/checkout@v4
+      - run: docker build -t app-api ./api
+      - run: docker build -t app-dashboard ./dashboard
+```
+
+### Pipeline stages
+
+```
+┌────────┐    ┌──────┐    ┌──────────┐    ┌───────┐    ┌────────┐
+│  Lint  │───▸│ Test │───▸│ Security │───▸│ Build │───▸│ Deploy │
+└────────┘    └──────┘    └──────────┘    └───────┘    └────────┘
+ biome check   vitest      npm audit        docker      compose
+                           secretlint       build       up -d
+```
+
+### CI rules
+
+| Rule | Description |
+|------|-------------|
+| **Block merge** | Failed CI = no merge |
+| **Parallelism** | lint ∥ security, then test, then build |
+| **Secrets** | GitHub Secrets / CI vars (never hardcoded) |
+| **Deps cache** | `actions/cache` for node_modules |
+| **Coverage** | Fail if < threshold (e.g. 70%) |
+
+---
+
+## 5. DB Migrations
+
+### Strategy (MongoDB + migrate-mongo)
+
+```bash
+# Create migration
+npx migrate-mongo create add-templateId-to-settings
+
+# Apply pending migrations
+npx migrate-mongo up
+
+# Rollback last migration
+npx migrate-mongo down
+
+# Check status
+npx migrate-mongo status
+```
+
+### Rules
+
+| Rule | Description |
+|------|-------------|
+| **Run before deploy** | Migrations applied before new code starts |
+| **Forward-compatible** | New code must work with old schema during rolling update |
+| **Reversible** | Every `up()` has matching `down()` |
+| **Tested** | Run against test DB in CI |
+| **Idempotent** | Safe to run multiple times |
+
+---
+
+## 6. Release Strategy
+
+### Versioning
+
+```
+SemVer: MAJOR.MINOR.PATCH
+- MAJOR: breaking API changes
+- MINOR: new features (backward compatible)
+- PATCH: bug fixes
+
+Git tags: v1.0.0, v1.1.0, v1.1.1
+Docker tags: app-api:v1.0.0, app-api:latest
+```
+
+### Release flow
+
+```
+feature branch → PR → main (CI green) → tag vX.Y.Z → deploy
+```
+
+### Feature flags (if needed)
+
+| Flag | Purpose | Default | How to toggle |
+|------|---------|---------|---------------|
+| `ENABLE_NEW_TEMPLATE` | Show new popup template | false | Env var |
+| `ENABLE_ANALYTICS` | Send analytics events | false | Env var |
+
+---
+
+## 7. Rollback Plan
+
+### Procedure
+
+```markdown
+## Rollback Checklist
+
+1. ☐ **Identify issue** — what broke? Check logs, alerts, user reports
+2. ☐ **Communicate** — inform team that rollback is starting
+3. ☐ **Rollback code:**
+   - Docker: `docker compose up -d --build` with previous image tag
+   - K8s: `kubectl rollout undo deployment/<name>`
+4. ☐ **Rollback DB (if migration applied):**
+   - `npx migrate-mongo down`
+   - Verify data integrity
+5. ☐ **Verify** — run smoke tests, check health endpoints
+6. ☐ **Post-mortem** — document what went wrong
+```
+
+### Time targets
+
+| Action | Target |
+|--------|--------|
+| Detection | < 5 min (alerts) |
+| Decision to rollback | < 10 min |
+| Rollback execution | < 5 min |
+| Verification | < 5 min |
+| **Total MTTR** | **< 25 min** |
+
+---
+
+## 8. Smoke Tests
+
+### Post-deploy smoke test checklist
+
+| # | Test | How | Expected |
+|---|------|-----|----------|
+| 1 | Health check | `GET /health/live` | 200 OK |
+| 2 | Ready check | `GET /health/ready` | 200 OK (DB connected) |
+| 3 | Content endpoint | `GET /api/v1/content/<testId>` | 200 + valid payload |
+| 4 | Dashboard loads | Open dashboard URL | Page renders |
+| 5 | Settings CRUD | PUT, then GET settings | Values persisted |
+| 6 | Public content | Check public content endpoint | Content served |
+
+---
+
+## 9. Example
+
+```markdown
+# Deployment & CI Plan: SaaS Admin Panel
+
+## Environments
+- local: Docker Compose + Caddy (https://localhost:5173)
+- production: Docker Compose + Cloudflare Tunnel
+
+## CI: GitHub Actions (lint → test → security → build)
+## Migrations: migrate-mongo (run before deploy)
+## Release: SemVer tags, manual production deploy
+## Rollback: Previous Docker image + migrate-mongo down
+```
+
+---
+
+## 10. Output Template
+
+```markdown
+# Deployment & CI Plan: <project-name>
+
+**Date:** YYYY-MM-DD
+
+## Environments
+<section 1 table>
+
+## Config & Secrets
+<section 2 registry + policy>
+
+## Docker Setup
+<Dockerfile + docker-compose.yml>
+
+## CI Pipeline
+<pipeline stages + YAML config>
+
+## Migrations
+<strategy + commands>
+
+## Release Strategy
+<versioning + flow>
+
+## Rollback Plan
+<procedure + time targets>
+
+## Smoke Tests
+<post-deploy checklist>
+```
+
+---
+
+## DoD (Definition of Done)
+
+- ☐ CI is green (all stages pass)
+- ☐ Migrations applied and tested
+- ☐ Smoke tests passed after deploy
+- ☐ Rollback procedure documented and executable
+- ☐ No secrets in code/images/logs
+
+---
+
+## See also
+- `$docker_kubernetes_architecture` — detailed Docker/K8s architecture
+- `$k8s_manifests_conventions` — K8s manifest standards
+- `$observability_plan` — logging/metrics/alerts
+- `$security_baseline_dev` — secrets management