Docs

Troubleshooting

Most failures come from endpoint reachability, contract shape, driver configuration, unexpected output paths, or missing provider credentials for advanced features.

Target Or Driver Fails

  • Confirm the service process is running and reachable from the terminal.
  • For recommender native HTTP, confirm GET /health, GET /metadata, and POST /recommendations exist.
  • For search native HTTP, confirm GET /health, GET /metadata, and POST /search exist.
  • For agents, confirm the driver config contains the required fields for the selected driver kind.
  • Use --driver-config-path for schema-mapped HTTP and agent protocol drivers.

Generated Coverage Is Rejected

  • Generated coverage commands only accept domains with generation hooks.
  • If run-swarm rejects agents or search, use audit or compare for those domains.
  • For recommender generation, confirm provider credentials when using --mode provider.

Output Is Missing

  • Pass --output-dir explicitly when you need a predictable folder.
  • If you omit --output-dir, check ./evidpath-output/ in your current working directory.
  • For compare runs, inspect nested baseline/ and candidate/ folders too.

Need Source Material

  • Product source: https://github.com/NDETERMINA/limitation/tree/main/products/evidpath
  • Issues: https://github.com/NDETERMINA/limitation/issues
  • Releases: https://github.com/NDETERMINA/limitation/releases