Skip to content

docker: name the memory and scratch controls in the entrypoint's usage text - #543

Merged
luisleo526 merged 2 commits into
mainfrom
docker/entrypoint-help-4c113fc6
Oct 27, 2026
Merged

luisleo526 merged 2 commits into
mainfrom
docker/entrypoint-help-4c113fc6

Conversation

@luisleo526

Copy link
Copy Markdown
Collaborator

What

The release entrypoint's usage text is its header comment. This adds one paragraph that names the memory and scratch environment variables an operator can set (PINEFORGE_COMMAND_SCRATCH_MAX_BYTES, PINEFORGE_COMMAND_SCRATCH_DIR or TMPDIR, PF_SCRATCH_ARENA_FD with PF_SCRATCH_ARENA_BYTES, PF_SCRATCH_ARENA_JAILED, PF_SCRATCH_WINDOW_BYTES, PINEFORGE_RUN_JSON_PROFILE) and points to docs/pages/memory-management.md for defaults, units and limits.

Comment-only: every code line of docker/entrypoint.sh is unchanged (nine comment lines are added before set -euo pipefail; no line is removed).

Because the block moves the lines below it by nine, the docker/entrypoint.sh:A-B citations in tests/ownership/driver.py and docs/design/BARS-BIN-INPUT.md are re-pinned to the same lines of code (found by the text of the first and last line, not by adding nine blindly). The driver.py runtime-command citation was already one line stale on main (it named 287-300; the run_json.py call is 288-301 since the report-descriptor line was added at 263) and now names the right lines, so the five-line driver.py change is not a pure shift.

Checks

  • Scope: three files; git diff --summary against the base is empty (no mode change); no code line of the entrypoint changes.
  • Each re-pinned citation names the same code as before (each read at the new file).
  • The documentation preflight guards (file:line anchors) run on the PR tree in CI.

🤖 Generated with Claude Code

luisleo526 and others added 2 commits October 27, 2026 05:14
…e text

The release entrypoint's usage text is its header comment. Add one paragraph
that names the memory and scratch environment variables an operator can set
(PINEFORGE_COMMAND_SCRATCH_MAX_BYTES, PINEFORGE_COMMAND_SCRATCH_DIR or TMPDIR,
PF_SCRATCH_ARENA_FD with PF_SCRATCH_ARENA_BYTES, PF_SCRATCH_ARENA_JAILED,
PF_SCRATCH_WINDOW_BYTES, PINEFORGE_RUN_JSON_PROFILE) and points to
docs/pages/memory-management.md for defaults, units and limits. All of them
reach the engine by inheritance: the entrypoint takes no command-line flags and
does not scrub the environment.

Comment-only: every code line of docker/entrypoint.sh is unchanged. The nine
inserted lines shift the later line numbers, so the citations of
docker/entrypoint.sh by line number in tests/ownership/driver.py and
docs/design/BARS-BIN-INPUT.md are re-pinned to the same lines of code.

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
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]>
@luisleo526
luisleo526 marked this pull request as ready for review October 26, 2026 21:50
@luisleo526
luisleo526 merged commit bf0811b into main Oct 27, 2026
18 of 19 checks passed
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