Skip to content

docs/design: hosting-jail budget contract - #614

Closed
luisleo526 wants to merge 2 commits into
mainfrom
docs/hosting-jail-budget-contract
Closed

luisleo526 wants to merge 2 commits into
mainfrom
docs/hosting-jail-budget-contract

Conversation

@luisleo526

Copy link
Copy Markdown
Collaborator

This is the design contract between the engine and the hosting layer. It covers:

  • the per-stage resource limits (memory, disk bytes and files, descriptors, processes, CPU, wall time, compile step);
  • the installation proof that the engine reads and fails closed on;
  • the measured-usage fields;
  • the outside-in acceptance tests;
  • the procedure for verifying a real host.

It links to the report channel spec (#602). Docs only; no behaviour change.

Replaces #606 as one commit, with citations by file and symbol (no line numbers).

🤖 Generated with Claude Code

luisleo526 and others added 2 commits October 28, 2026 14:13
Design contract between the engine and the hosting layer: the per-stage
resource limit table (memory, disk bytes and files, descriptors, processes,
CPU, wall time, compile step), the installation proof the engine reads and
fails closed on, measured-usage fields, outside-in acceptance tests, and the
real-host verification procedure. Docs only; no behaviour change.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
…e doc lint

The link to the sibling report channel document pointed at a file that is
not in this tree yet, and one backticked path named a codegen-repository
test helper that does not exist here. Both references become plain words.
Only the two sentences introduced by 0ce4800 change; no requirement moves.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
@luisleo526

Copy link
Copy Markdown
Collaborator Author

Folded into #632, the combined 1.8.0 batch-2 pull request. The branch is kept.

@luisleo526 luisleo526 closed this Oct 29, 2026
luisleo526 added a commit that referenced this pull request Oct 29, 2026
…ion, metrics-only mode (#632)

Combined second batch for 1.8.0. Each member was reviewed and proven on its own branch; this branch merges them onto main and is verified as one tree.

## Members (merged in this order)

- Keep a reversal's newly credited opening when its entry id had opposite-side history (fixes wrong positions, uncapped pyramiding and missing closed-trade rows after a reversal on a reused entry id; affected releases v1.1.0 through v1.7.0).
- Window buffers for technical-analysis series kept on main.
- Report channel contract and hosting jail budget contract (docs; #613, #614).
- Annualization diagnostic uses the engine's initial capital on every report path.
- Opt-in report replay companion (#607).
- Metrics-only run mode (#630).
- Comment-only rewording of shipped source comments.
- Source clones skip the in-repo `.ccache` directory, so a whole-tree copy no longer races a running compile.
- In-process iteration of the default-path report columns: `report["trades"]` and `report["equity_curve"]` iterate lazily from the report spool again, report their length and support integer indexing; iteration must happen before the report's resources close.
- CHANGELOG entries for the above, and re-pointed source-line citations in two documentation pages (line numbers only).
- The report-sink trade-identity test reference is re-recorded: the reversal fix changes the per-bar state hash input (open-position bookkeeping), while no trade or equity row changes; the CHANGELOG says so.

## Not in this batch

The live runner's report checkpoints (#598) and report accumulator (#617) move to the next minor release: testing showed a timing case that can leave a delivered order unacknowledged and a crash for modules whose handle is not an engine. Their pull requests stay open as drafts.

## Verification

- Native live suite (all native shards, thread and address sanitizer legs) on this tree's code.
- Full verify and the corpus parity sweep on this exact head.
- Every member was reviewed independently before it was merged here.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant