Reconcile concise README with current accepted product

Hop-State: A_06FN5JYYR5XPBJ8HDHSNJG8 Hop-Proposal: R_06FN5JXX64P7BMT8Q98HHE8 Hop-Task: T_06FN3MBF98GWD4NA5PA1RWG Hop-Attempt: AT_06FN5J8NBKM5ES4ZMD5Y1CR
2026-07-11 13:08:40 -07:00
parent 011f6fa102
commit e887c8476d
3 changed files with 71 additions and 302 deletions
@@ -1,6 +1,17 @@
 # CLI reference

-Add `--json` anywhere in a command for machine-readable output.
+Add `--json` anywhere in a command for machine-readable output. Successful
+responses use this envelope:
+
+```json
+{
+  "ok": true,
+  "data": {}
+}
+```
+
+The JSON shape is an alpha contract and may evolve before the first tagged
+release.

 ## Project and prompt lifecycle