Skip to content

Document scoped snapshot import host-read errors #76

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
janrysavy merged 1 commit into from
Oct 6, 2026
Merged

Document scoped snapshot import host-read errors #76

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions JSON_RPC_API.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -959,6 +959,10 @@ are not serialized. Live external input after restore changes subsequent play.
Bundles have a 1 GiB total uncompressed data limit and a 4 MiB JSON limit.
Malformed bundles/hashes are rejected before live installation. Disk I/O failure
can leave a partial new output directory; the live machine stays unchanged.
Archive/reference host-file open, metadata or read failures return -32603.
Invalid checksums, dependency lengths and request guards remain -32602.
This documents import host reads; other backends' export/output I/O errors need
their own explicit contract and are not covered by this compatibility scope.
Host ACLs, permissions, timestamps and external applications are not captured.

Archive publication uses an atomic hard link from a completed temporary file;
Expand Down
10 changes: 9 additions & 1 deletion docs/HANDOFF.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
# Handoff - snapshot host-read contract, 2026-10-06

FINISHED documentation: import archive/reference host I/O reads return -32603;
checksum/length/request refusals remain -32602. Runtime is unchanged; 14 focused
API/snapshot tests and 13 subtests pass. Require final-head public CI before
integration. Cross-backend export/output I/O normalization remains OPEN.

# Handoff - device operation epochs, 2026-10-06

FINISHED local: successful serial.write batches and io.read bus operations advance
Expand All @@ -12,7 +19,8 @@ control accept the old revision; exact restored source passes. Invalid parameter
full queue and loopback refusals preserve complete Machine/control state.
Initial scoped review found no runtime defect; its running-loop proof and central
revision-summary gaps are fixed with an actual JSON-lines/CPU-loop UART test.
WIP: targeted final review and final-head public CI/integration.
PR77 rebase-integrated at b7e69ff after final-head public CI and no-defect
targeted review.
Parent source pin remains fixed until the combined repair/compiler witness.

Earlier handoff notes below describe their historical slices.
Expand Down
Loading