scope refactoring

mcp_server/TOOLS.md

@@ -132,6 +132,23 @@ Domains are now first-class DB entities. Use `list_domains()` to discover availa
 | `register_repo(domain_slug, name, ...)` | `slug?`; `local_path?`; `remote_url?` | Register a git repo under a domain. |
 | `update_repo_path(repo_slug, path, host?)` | `repo_slug`: e.g. `"marki-docx"`; `path`: absolute local path; `host`: defaults to current hostname | Register this machine's local path for a repo. Use when the same repo lives at different paths on different machines (e.g. `/home/worsch/…` vs `/home/tegwick/…`). The consistency checker prefers this over `local_path`. |
 
+### SCOPE.md Health Contract
+
+Repo dispatch includes `scope_needs_review` and `scope_issue_details`.
+`scope_issue_details` reports C5a/C5b/C5c with machine-readable
+`missing_sections`, `invalid_capability_blocks`, and `needs_refresh_sections`.
+
+For ecosystem refresh, call:
+
+```bash
+curl "http://127.0.0.1:8000/repos/scope-health?needs_review=true&reachable_only=true"
+```
+
+The list response returns active repos with `repo_slug`, `domain_slug`,
+`local_path`, `path_available`, `scope_needs_review`, and the same
+`scope_issue_details` shape. Repo-scoping should use `needs_refresh_sections`
+to update only the affected SCOPE.md sections.
+
 ---
 
 ## Agent Inbox Tools