Machine-readable surfaces index¶
Use this page to find the single authoritative document for each automation or integration surface. Do not duplicate JSON field lists in secondary docs.
| Surface | Role | Authoritative document |
|---|---|---|
| Cross-command CLI JSON and exit codes | Automation across diff, stats, trace, manifest, export, import |
CLI JSON inventory |
Merge preview JSON (can_merge, conflicts, warnings) |
CI gates, MCP liel_merge_preview |
CLI merge report |
| MCP tool payloads | Agent clients | MCP tools reference; merge/diff/manifest shapes defer to the CLI references above |
| Viewer and dashboard inputs | Tools that render memory without reading raw .liel bytes |
Viewer JSON contract |
| External vector store hybrid | Embeddings live outside liel |
Vector hybrid conventions |
| Optional per-label validation | Team validators, not core enforcement | Schema profiles (optional) |
E7 operating rule (post-Phase 4)¶
When changing machine-readable CLI/MCP contracts (JSON fields or exit codes), update the relevant contract docs in the same change set:
- CLI JSON inventory
- CLI merge report (if merge preview shape changes)
- MCP tools reference (if MCP payloads change)
- Viewer JSON contract (if viewer inputs change)
- this page (if authoritative ownership mapping changes)