Milestone 6 API completeness

README.md

@@ -69,6 +69,7 @@ Inspect recorded facts:
 
 ```bash
 curl http://127.0.0.1:8000/repos/1/analysis-runs
+curl http://127.0.0.1:8000/repos/1/analysis-runs/1
 curl http://127.0.0.1:8000/repos/1/observed-facts
 ```
 
@@ -91,3 +92,34 @@ curl -X POST http://127.0.0.1:8000/repos/1/analysis-runs/1/candidate-graph/appro
 ```
 
 Approval copies candidate abilities, capabilities, features, and evidence into the approved registry tables, marks candidates approved, and moves the repository status to `indexed`.
+
+## Review Workflow
+
+Candidate graphs are meant to be corrected before publication. The API supports:
+
+- edit candidate abilities and capabilities with `PATCH`
+- reject candidate abilities, capabilities, features, and evidence
+- relink capabilities under another ability
+- relink features or evidence under another capability
+- merge duplicate abilities, capabilities, features, or evidence
+
+Examples are available in the generated OpenAPI docs at `/docs`.
+
+## Agent-Facing Endpoints
+
+The v0.1 API covers the main registration, analysis, review, search, and inspection loop:
+
+```text
+GET  /repos
+POST /repos
+GET  /repos/{id}
+POST /repos/{id}/analysis-runs
+GET  /repos/{id}/analysis-runs
+GET  /repos/{id}/analysis-runs/{run_id}
+GET  /repos/{id}/analysis-runs/{run_id}/candidate-graph
+POST /repos/{id}/analysis-runs/{run_id}/candidate-graph/approve
+GET  /repos/{id}/ability-map
+GET  /abilities
+GET  /capabilities
+GET  /search?q=...
+```