proto: freeze the wire contract at 1.0.0

Schemas for the whole v1 surface: 38 methods, 9 events, 25 named types and the JSON-RPC envelope, with x-privileged / x-transports / x-deadlineMs / x-errors annotations that both generators emit as data rather than prose. Four generators over one IR (contracts/codegen/schema_ir.py), so the C++ structs, the TypeScript types and the OpenRPC document cannot disagree about what the contract says: gen_cpp.py -> core/generated/velox_proto.{hpp,cpp} gen_ts.py -> extension/src/shared/protocol/ gen_openrpc.py -> contracts/openrpc.json gen_cpp_conformance.py -> tests/conformance/cpp/fixture_dispatcher.hpp Inbound parsing never throws: parse<T>() returns std::expected<T, ParseError> and nlohmann's throwing ADL from_json is deliberately not emitted. Schema constraints (minimum, maxLength, pattern, ...) become real runtime checks in both languages — the daemon does not trust the extension and the extension does not trust the daemon. 59 golden fixtures: a success case per method, 12 error cases, 9 events. Replayed by tests/conformance/ against both the generated C++ and a live server over both transports. tools/mockd serves the same fixtures with unhappy-path flags so the GUI and EXT lanes never wait for veloxd. run.sh also proves capture.offer fails open: with a daemon answering slower than 750 ms the client gives up and lets Firefox take the download. core/generated/ is libveloxproto, a separate target from libveloxcore, which still never sees JSON — see docs/adr/0009. Co-Authored-By: Claude Opus 5 <[email protected]> Claude-Session: https://claude.ai/code/session_012fgjnqFCS5h5L7gZTZo3rV
2026-09-09 19:55:54 +04:00
parent a40585f419
commit 53421d6cb8
171 changed files with 29275 additions and 51 deletions
@@ -0,0 +1,81 @@
+{
+  "name": "download.list \u2014 the main table, unfinished first page",
+  "description": "Filtering, sorting and paging all happen daemon-side; the GUI never materializes rows it will not draw.",
+  "request": {
+    "jsonrpc": "2.0",
+    "id": 13,
+    "method": "download.list",
+    "params": {
+      "filter": {
+        "states": [
+          "downloading",
+          "paused",
+          "queued"
+        ]
+      },
+      "sort": {
+        "field": "createdAt",
+        "direction": "desc"
+      },
+      "offset": 0,
+      "limit": 50
+    }
+  },
+  "response": {
+    "jsonrpc": "2.0",
+    "id": 13,
+    "result": {
+      "total": 4,
+      "items": [
+        {
+          "taskId": "3f7a2b1c-5d6e-4f80-9a1b-2c3d4e5f6071",
+          "filename": "ubuntu-26.04-desktop-amd64.iso",
+          "saveDir": "/home/sami/Downloads/Programs",
+          "url": "https://releases.ubuntu.com/26.04/ubuntu-26.04-desktop-amd64.iso",
+          "effectiveUrl": "https://releases.ubuntu.com/26.04/ubuntu-26.04-desktop-amd64.iso",
+          "sizeBytes": 6228541440,
+          "downloadedBytes": 2941190144,
+          "state": "downloading",
+          "speedBps": 29796556,
+          "etaSeconds": 110,
+          "resumable": true,
+          "segments": 8,
+          "categoryId": "programs",
+          "queueId": null,
+          "queuePosition": null,
+          "description": null,
+          "createdAt": "$isoDate",
+          "lastTryAt": "$isoDate",
+          "completedAt": null,
+          "error": null
+        },
+        {
+          "taskId": "8c1d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
+          "filename": "film.mkv",
+          "saveDir": "/home/sami/Downloads/Video",
+          "url": "https://example.org/film.mkv",
+          "effectiveUrl": "https://example.org/film.mkv",
+          "sizeBytes": 1503238553,
+          "downloadedBytes": 402653184,
+          "state": "paused",
+          "speedBps": 0,
+          "etaSeconds": null,
+          "resumable": true,
+          "segments": 4,
+          "categoryId": "video",
+          "queueId": null,
+          "queuePosition": null,
+          "description": null,
+          "createdAt": "$isoDate",
+          "lastTryAt": "$isoDate",
+          "completedAt": null,
+          "error": null
+        }
+      ]
+    }
+  },
+  "assertions": [
+    "total counts every row matching the filter, ignoring offset and limit",
+    "the table is built from this once and maintained from events thereafter, never re-fetched per tick"
+  ]
+}