dep-inspector-cli

DevOps-grade dependency, security & infrastructure scanner for Node.js projects.

What's new in v2

Version 2 transforms dep-inspector from a dependency analyzer into a full DevOps security toolkit — covering secrets, Docker, CI/CD pipelines, ports, and logging. All features work without any API key. AI insights are optional.

Features

| Command | What it does | |---|---| | dep-inspector | Dependency tree + vulnerability scan (v1) | | scan:secrets | Detect hardcoded API keys, .env leaks, private keys | | scan:vulns | npm audit wrapper with severity thresholds | | scan:docker | Dockerfile & docker-compose security analysis | | scan:ci | GitHub Actions workflow linting | | scan:ports | Open port detection & process monitoring | | scan:logs | Winston/Morgan/Pino logger health check | | scan:all | Run everything, generate a full report |

Installation

npm install -g dep-inspector-cli

Usage

Dependency Analysis (v1)

dep-inspector                   # Full analysis
dep-inspector analyze           # Same, explicit subcommand
dep-inspector --depth 3         # Limit tree depth
dep-inspector --json            # Machine-readable output
dep-inspector --ai              # AI-powered insights (optional, needs GROQ_API_KEY)

Security Scans (v2)

dep-inspector scan:secrets               # Scan current directory
dep-inspector scan:secrets --dir ./src   # Scan specific directory
dep-inspector scan:secrets --ai          # With AI explanations (optional)

dep-inspector scan:docker                # Analyze Dockerfile
dep-inspector scan:docker --file ./docker/Dockerfile

dep-inspector scan:ci                    # Lint GitHub Actions workflows
dep-inspector scan:ci --dir .github/workflows

dep-inspector scan:ports                 # Check open ports

dep-inspector scan:logs                  # Logger health check

dep-inspector scan:all                   # Full DevOps scan
dep-inspector scan:all --report          # + saves HTML report
dep-inspector scan:all --json            # + JSON output
dep-inspector scan:all --ai              # + AI summary (optional)

What gets detected

scan:secrets

• AWS Access Keys & Secret Keys
• OpenAI, Groq, GitHub tokens
• Hardcoded JWT secrets
• MongoDB / PostgreSQL connection strings
• Stripe & Razorpay live keys
• Generic password= / secret= assignments
• Accidentally committed .env files

scan:docker

• Container running as root (no USER directive)
• Missing HEALTHCHECK
• :latest tag usage (non-reproducible builds)
• Secrets hardcoded in ENV/ARG
• Missing .dockerignore
• npm install without --omit=dev in production
• Single-stage builds (image size warning)

scan:ci

• Hardcoded secrets in workflow YAML
• Deprecated ::set-output command
• pull_request_target + actions/checkout (privilege escalation risk)
• Actions pinned to @main / @latest instead of a version
• Missing dependency cache
• No timeout-minutes (stuck jobs)

scan:ports

• Lists all open/listening ports
• Flags database ports (Redis, MongoDB, PostgreSQL, MySQL) publicly exposed
• Flags FTP, Telnet, and other insecure services

scan:logs

• Detects missing logger (console.log in production)
• Checks for winston-daily-rotate-file (log rotation)
• Validates LOG_LEVEL environment variable

Output

All commands support --json for machine-readable output:

dep-inspector scan:secrets --json > secrets-report.json
dep-inspector scan:all --json > full-report.json

Severity levels: HIGH · MEDIUM · LOW

AI Setup (optional)

The --ai flag sends findings to Groq LLM for human-readable explanations and fix suggestions. It is completely optional — every scan works without it.

# Set once in your shell profile or .env
export GROQ_API_KEY=your_key_here

dep-inspector scan:secrets --ai
dep-inspector scan:all --ai

Get a free key at console.groq.com. If the key is missing, the tool runs normally and skips AI output with a note.

CI/CD Integration

# .github/workflows/security.yml
name: Security Scan

on: [push, pull_request]

jobs:
  dep-inspector:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install dep-inspector
        run: npm install -g dep-inspector-cli

      - name: Scan secrets
        run: dep-inspector scan:secrets --json > secrets.json

      - name: Scan dependencies
        run: dep-inspector --json > deps.json

      - name: Lint CI workflows
        run: dep-inspector scan:ci

      - name: Upload reports
        uses: actions/upload-artifact@v4
        with:
          name: dep-inspector-reports
          path: "*.json"

Fail build on HIGH severity secrets:

dep-inspector scan:secrets --json | node -e "
  let d = '';
  process.stdin.on('data', c => d += c);
  process.stdin.on('end', () => {
    const { findings } = JSON.parse(d);
    const high = findings.filter(f => f.severity === 'HIGH').length;
    if (high > 0) { console.error(high + ' HIGH severity secrets found. Failing build.'); process.exit(1); }
    console.log('No HIGH severity secrets found.');
  });
"

Project Structure

dep-inspector/
├── src/
│   ├── index.ts                   # CLI entry — all commands registered here
│   ├── commands/
│   │   ├── analyze.ts             # v1 dependency analysis
│   │   ├── scan-secrets.ts        # secrets & key scanner
│   │   ├── scan-docker.ts         # Dockerfile analysis
│   │   ├── scan-ci.ts             # GitHub Actions linter
│   │   ├── scan-ports.ts          # port monitor
│   │   ├── scan-logs.ts           # logger health check
│   │   └── scan-all.ts            # full scan orchestrator
│   └── utils/
│       ├── ai.ts                  # optional Groq integration
│       ├── audit.ts               # npm audit wrapper
│       ├── deps.ts                # npm ls wrapper
│       ├── tree.ts                # tree printer
│       └── version.ts             # semver comparison
├── package.json
└── tsconfig.json

Requirements

• Node.js >= 16
• npm in PATH
• GROQ_API_KEY — only needed for --ai flag

Tech Stack

• TypeScript — fully typed
• Commander.js — CLI argument parsing
• Chalk — colored output
• Ora — terminal spinners
• Groq SDK — optional AI layer (direct, no LangChain dependency)
• Semver — version comparison

Roadmap

• [ ] scan:secrets — .git history scanning (catch keys that were deleted but committed)
• [ ] scan:docker — docker-compose multi-service analysis
• [ ] --report — full HTML report with charts
• [ ] Slack / Discord webhook alerts
• [ ] GitHub App integration (PR comments)
• [ ] Custom rule config via .depinspectorrc

Contributing

git clone https://github.com/Nevin100/Dep-inspector-nevin
cd Dep-inspector-nevin
npm install
npm run build

Pull requests welcome. For major changes, open an issue first.

License

MIT © Nevin Bali