Skip to content

docs: a hosting layer may re-place an arena_exhausted run; the development service does not - #542

Merged
luisleo526 merged 3 commits into
mainfrom
docs/arena-ladder-correction
Oct 26, 2026
Merged

luisleo526 merged 3 commits into
mainfrom
docs/arena-ladder-correction

Conversation

@luisleo526

Copy link
Copy Markdown
Collaborator

What

Four docs said a hosting layer re-places a run that fails with arena_exhausted "on the next rung of a trusted ladder, escalation cap 2". The current development service has no such ladder: it makes one attempt on a fixed template arena, never retries, and returns the typed failure as engine_failed.

The docs now say what is true: a hosting layer MAY re-place the run on a larger arena, and the development service does not. Changed: docs/design/arena-bound.md, docs/design/arena-bound-corpus-census.md, docs/scratch-store.md, and two lines of docs/pages/memory-management.md. Docs only: no code, no behaviour change. (The same claim sits in a code comment in src/command_scratch_production.hpp; that is a source change and goes with the next source PR.)

Checks

  • lab remote preflight + docs on a clean tree: preflight passed (59 stages, including the doc-reverts gate: the two removed sentences are named in the commit message), docs build passed.
  • No "ladder" or "rung" is left in the four files except two unrelated probe names.

🤖 Generated with Claude Code

luisleo526 and others added 2 commits October 27, 2026 01:30
…pment service does not

Four docs stated that a hosting layer re-places a run that fails with
arena_exhausted on "the next rung of a trusted ladder, escalation cap 2".
The current development service has no such ladder: it makes one attempt on a
fixed template arena, never retries, and returns the typed failure as
engine_failed. The docs now say a hosting layer MAY re-place the run on a
larger arena, and that the development service does not:
docs/design/arena-bound.md, docs/design/arena-bound-corpus-census.md,
docs/scratch-store.md, and the two matching lines of the memory-management
page. Docs only; no code, no behaviour change.

Removed sentences, named for the doc-reverts gate (both were introduced by
commit 91353de):
- docs/design/arena-bound.md: "A typed `arena_exhausted` re-places the run on
  the next rung of COMPUTE's trusted ladder, with escalation cap 2."
- docs/design/arena-bound-corpus-census.md: "COMPUTE uses the default
  attempt-0 arena and its trusted escalation ladder: a typed `arena_exhausted`
  re-places the run on the next rung, escalation cap 2, never charged to the
  user, with an alert."

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
…policy to COMPUTE

Follow-up to the arena_exhausted re-placement correction.

- docs/design/arena-bound.md, the "Unbounded emitting loop" row: "Default
  attempt-0 arena and escalation apply." becomes "Default attempt-0 arena
  applies." (the development service has no escalation).
- docs/design/arena-bound.md and docs/design/arena-bound-corpus-census.md: "Arena
  exhaustion is never charged to the user and raises an alert" is now scoped:
  it is COMPUTE's policy, and the development service's behaviour is the one
  stated beside it (one attempt on a fixed template arena, no retry, returned as
  engine_failed). The charge and alert behaviour is not claimed for the
  development service.

Docs only; no code, no behaviour change.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
@luisleo526
luisleo526 marked this pull request as ready for review October 26, 2026 18:50
@luisleo526
luisleo526 merged commit 53e884a into main Oct 26, 2026
12 checks passed
luisleo526 added a commit that referenced this pull request Oct 26, 2026
Takes the docs-only change of #542 (docs/design/arena-bound-corpus-census.md,
docs/design/arena-bound.md, docs/pages/memory-management.md,
docs/scratch-store.md). No conflict; none of those files is touched by this
branch, and the entrypoint comment block and the re-pinned citations are
unchanged.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
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