Extending

Keep the CLI surface and domain types stable. Add capability behind the existing adapter contracts.

Add a package manager

  1. Implement EcosystemAdapter under src/ecosystems/
  2. Return accurate direct/transitive paths from the lockfile
  3. Fail loudly for unsupported shapes
  4. Add fixtures mirroring the npm lockfile tests

Add an advisory source

  1. Implement AdvisoryProvider under src/advisories/
  2. Normalize into the shared Advisory type
  3. Validate responses before use
  4. Keep OSV as the default unless the user opts in

AI providers

Extend the provider factory with another branch. Keep credentials in env vars, validate structured output, and soft-fail without changing findings.

ai: {
  enabled: true,
  provider: "openai-compatible",
  model: "your-model",
  baseURL: "http://localhost:11434/v1"
}

Design principles

  • Deterministic core, optional AI
  • Explicit unsupported ecosystems over silent approximation
  • Approval-first mutation
  • Verify after change; restore on failure
  • Prefer small, reviewable PRs for automation