usecase e2e tests

README.md

@@ -169,6 +169,9 @@ DELETE /repos/{id}/evidence/{evidence_id}
 GET  /abilities
 GET  /capabilities
 GET  /search?q=...
+GET  /repository-comparisons?repository_ids=1&repository_ids=2
+POST /capability-gaps
+GET  /repos/{id}/export
 ```
 
 ## Agent API Loop
@@ -205,3 +208,16 @@ Search results include `match_type`, `matched_field`, `confidence`,
 source/evidence context when the match comes from implementation evidence.
 The generated OpenAPI schema at `/openapi.json` and docs at `/docs` include
 typed response schemas and examples for the main agent-facing responses.
+
+Discovery helpers are available for production-readiness workflows that compare
+approved profiles, find simple capability gaps, or export a registry entry:
+
+```bash
+curl 'http://127.0.0.1:8000/repository-comparisons?repository_ids=1&repository_ids=2'
+
+curl -X POST http://127.0.0.1:8000/capability-gaps \
+  -H 'content-type: application/json' \
+  -d '{"desired_ability":"Business Email Routing","desired_capabilities":["Classify Incoming Email","Route Email to Team"],"repository_ids":[1,2]}'
+
+curl http://127.0.0.1:8000/repos/1/export
+```