Repository navigation
docs: finish the task-structure pass, and document two CLI paths it uncovered - #63
Merged
Mandalorian-Wang merged 1 commit intoOct 21, 2026
Conversation
Preview approval requiredThis pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit |
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars. ⚙️ Run configuration
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
…ncovered Workstream B, the remaining three pages. Headings per page, before and after: raw-streams 0 -> 4, data-across-boxes 0 -> 5, cost-controls 1 -> 4. No code or facts changed except where a surface was missing. Checking "where does the user do this?" per task — the rule the plan added after the network-policy miss — turned up two CLI paths none of these pages mentioned, and one limitation worth more than the paths. data-across-boxes now opens with the whole proof in six commands rather than a 190-line script. Run end to end before writing it: boxlite volume create --name handoff-demo boxlite create python --name box-a -v handoff-demo:/data boxlite exec box-a -- sh -c 'echo "produced by box A" > /data/handoff.txt' boxlite rm -f box-a boxlite create python --name box-b -v handoff-demo:/data boxlite exec box-b -- cat /data/handoff.txt produced by box A cost-controls: `boxlite create` takes `--auto-stop` with a friendlier grammar than the SDK — `30s`, `15m`, `2h`, `7d` instead of raw seconds. It refuses `--auto-delete`, though: $ boxlite create python --name cost-b --auto-delete 1h Error: invalid argument: remove-on-stop is incompatible with detach=true. Detached boxes should use auto_delete=0 ... for manual lifecycle control. `--auto-stop 15m` alone succeeds on the same command, so this is specific to auto-delete on a detached box, not a bad flag pair. The page says you can close the compute half of the bill from the CLI and must use an SDK for the disk half, which is the fact rather than the tidier story. Also: - raw-streams gained a return-value table for read(): data, b"" at end-of-stream, ValueError on read(0), and a closed-connection error after close(). The empty read being the only EOF signal was one sentence in a paragraph. - data-across-boxes gained a table for which paths survive a box, since writing outside the mount is the mistake this page exists to prevent. Checks: lint-docs 180 pages, llms.txt current, check-structure clean, mint broken-links none. Every box and volume created for this was removed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Mandalorian-Wang
force-pushed
the
docs/task-structure-2
branch
from
October 21, 2026 02:44
a434a67 to
3a2bab0
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Workstream B, the remaining three pages. Completes the batch started in
#62.
raw-streamsdata-across-boxescost-controlsNo code or facts changed except where a surface was missing.
The rule paid for itself again
Checking "where does the user actually do this?" per task — the discipline the plan
added after the
network-policymiss — turned up two CLI paths none of these pagesmentioned, and one limitation worth more than either.
data-across-boxesnow opens with the proof in six commandsInstead of a 190-line script. Run end to end before writing it down:
cost-controls: the CLI closes only half the billboxlite createtakes--auto-stop, with a friendlier grammar than the SDK —30s,15m,2h,7dinstead of raw seconds. It refuses--auto-delete:--auto-stop 15malone succeeds on the same command, so this is specific toauto-deleteon a detached box, not a bad flag pairing. The page now says you can closethe compute half of the bill from the CLI and need an SDK for the disk half —
the fact, rather than the tidier story of "both work everywhere".
Two tables where a sentence was doing too much work
raw-streams— a return-value table forread(): data,b""at end-of-stream,ValueErroronread(0), and a closed-connection error afterclose(). That theempty read is the only EOF signal was one clause inside a paragraph.
data-across-boxes— a table of which paths survive a box. Writing outside themount is the single mistake this page exists to prevent, and it was a trailing
sentence.
Checks
Every box and volume created for this was removed; the account is back to its two
pre-existing boxes and no volumes.
Stacked on #62.
🤖 Generated with Claude Code