[session 1] docs: four operational traps (journal amounts, core.version pin, log levels, OOM ordering) #45

Merged
hiveiq merged 1 commits from docs/four-operational-traps into develop 2026-07-19 13:14:11 -04:00

1 Commits

Author SHA1 Message Date
johannes 158f0acb21 docs: four operational traps that each cost real time
Surfaced by auditing sessions 1-3's merged work against the Guide. Each
of these had already bitten at least once, two of them twice, and none
were written down where the next person would look.

- technical.journal — recycler ATMs mask the record Amount field on the
  LEADING digits, so amounts come from labelled JPR receipt lines with
  DISPENSED taking precedence. Includes the not-backfilled caveat for
  rows parsed before journal#48.
- processes.release — mvn versions:set does not touch
  hiveops.agent.core.version, so a release ships green while silently
  omitting every core fix (agent#91, then #92/#93 in one cycle).
- platform.gotchas — LOGGING_LEVEL_ROOT=INFO does not silence DEBUG;
  package-level loggers override root.
- devops.prod — oom_score_adj set via /proc is lost on container
  recreate; it has to be in compose.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-19 13:12:43 -04:00