Skip to content

Align submission docs with runtime defaults - #46

Merged
batbrainy merged 2 commits into
mainfrom
codex/submission-doc-consistency
Aug 2, 2026
Merged

Align submission docs with runtime defaults#46
batbrainy merged 2 commits into
mainfrom
codex/submission-doc-consistency

Conversation

@batbrainy

Copy link
Copy Markdown
Owner

What changed

  • align the README, two-page design brief, environment template, implementation plan, ADRs, and explanatory comments with the runtime's 40-request detail-fallback allowance and 20/20 fairness guarantees
  • update representative log output to match the current defaults
  • make the local CI enrichment smoke use SEARCH_PACING_SECONDS=0 and --limit 6, matching GitHub CI so it exercises two Search batches and both payload-URL fallbacks

Why

The staged batch-enrichment merge raised CORE_DETAIL_FALLBACK_ALLOWANCE from 4 to 40, but several reviewer-facing documents and comments retained the prior 4/hour and 2/2 values. The application already enforced 40/hour correctly; this PR removes the submission-level documentation contradiction and makes the local smoke test prove the full offline enrichment chain it describes.

Impact

No production behavior changes. Reviewer-facing rate-limit explanations now match the runtime, and the local CI smoke gains complete deterministic enrichment coverage.

Validation

  • docker compose config --quiet
  • docker compose run --rm test — 1,958 examples + 10 threaded stress examples, 0 failures
  • docker compose run --rm --entrypoint bin/ci test — full fixture ingestion/enrichment smoke, queue validation, worker boot/shutdown, RuboCop, bundler-audit, and Brakeman all passed
  • current docs/DESIGN_BRIEF.md rendered as US Letter at 11pt/1.35 with 0.75-inch margins — exactly 2 pages; both pages visually checked for clipping and overlap
  • git diff --check

batbrainy and others added 2 commits August 2, 2026 16:54
Both are prose-only follow-ups to this branch's own cleanup.

budget_ledger_shared_ip_spec was the last place presenting 12 + 4 + 8 as
"the full commitment" without saying the 4 is BudgetHelpers' deliberately
small fixture value rather than the 40 a real window derives — the same
annotation the other two call sites already got here.

ADR 0013's protection bullet lost its argument in the renumber: "capped at
4 rather than 40" was the claim, and "remains capped at 40" no longer
supports it, since 40 is what the pre-Appendix-G remainder came to anyway.
The real improvement is that core enrichment spend is now an explicit cap
instead of the leftover.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@batbrainy
batbrainy marked this pull request as ready for review August 2, 2026 22:05
@batbrainy
batbrainy merged commit 252da88 into main Aug 2, 2026
3 checks passed
@batbrainy
batbrainy deleted the codex/submission-doc-consistency branch August 2, 2026 22:05
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