Files
gbrain/scripts
Garry TanandClaude Opus 4.7 c05b1c7de9 v0.41: Wave C — self-tuning fleet (E5 controller + E6 self-fix + shared election)
The "magic layer" the wave promises: workers tune their own lease cap
based on real upstream signals; failed jobs auto-heal one layer deep
for known-recoverable failure modes. Both default ON for fresh installs
+ upgrades; off-switches per CLAUDE.md.

src/core/db-lock.ts — tryWithDbElection convenience (Eng D9)
  Thin wrapper over the existing tryAcquireDbLock: acquires, runs fn,
  releases. For per-tick election use cases (controller tick chooses
  one writer per cluster). Codex pass-3 #8/#9 audit picked this shape
  over building a parallel new primitive — the existing
  gbrain_cycle_locks table works for both engines.

src/core/minions/lease-cap-controller.ts (E5 reframed + Eng D6 correction)
  Auto-adapts the rate-lease cap based on bounce rate + upstream 429s
  + latency stability. CORRECTED control law per codex pass-2 #9:
    * Ramp DOWN only when upstream pushes back (429s OR latency unstable)
    * Ramp UP fast when workers starve (bounces > 1/min + no 429s)
    * Ramp UP slow on healthy headroom (util > 50% + 0 bounces + 0 429s)
    * Deadband otherwise
  My first draft had the bounce sign inverted; would have cratered cap
  during a healthy 100-job burst — exactly the field-report case. IRON-
  RULE regression test (test/lease-cap-controller.test.ts) pins the
  correct sign so future "let's simplify" PRs can't silently regress it.

  Per-tick election via tryWithDbElection — only ONE worker per cluster
  runs the WRITE side; all workers READ lease_cap_current fresh on every
  acquire. Asymmetric AIMD steps (rampDown=8, rampUp=4) — TCP congestion
  control wisdom. Latency signal sourced from subagent job durations
  in window; full upstream-SDK-latency tracking is v0.42.

  Pinned by 14 cases including the field-report scenario simulation
  ("starving workers get MORE capacity, not less").

src/core/minions/self-fix.ts (E6 with narrowed classifier per codex pass-2 #4)
  Classifier-gated auto-resubmit on terminal failures. ONLY three
  buckets qualify: prompt_too_long, tool_schema_mismatch, malformed_json.
  Explicitly NOT recoverable: tool_crash (real bug), tool_unavailable
  (config issue), tool_permission (needs human). Chain depth cap = 2
  (D15 default); per-job opt-out via data.no_self_fix; global off-switch
  via config.

  buildSelfFixPrompt cluster-specific prep:
    prompt_too_long      → truncate-with-leaf-preservation (v0.41 ships
                            simple; semantic reduction in v0.42)
    tool_schema_mismatch → surface error verbatim + "check input_schema"
    malformed_json       → "respond with JSON only — no prose, no fences"

  Children inherit budget owner from parent (Eng D7 + D10) but DO NOT
  copy remaining cents (codex pass-3 #5 caught the original plan's
  contradiction; only owner row holds spendable balance). Pinned by 16
  cases.

scripts/e5-lease-cap-ab.ts (D11 + codex pass-2 #7 spec)
  Manually-runnable A/B harness with committed receipt-fixture baseline.
  Spec: 500 jobs, log-normal prompt distribution, $8 budget per arm,
  synthetic 429 burst at minute 15, PR-gate verdict (controller must
  beat fixed-cap by ≥5% on throughput AND match within ±2% on cost
  efficiency). v0.41 ships the spec + dry-run + fixture shape; real-run
  dispatcher deferred to v0.41.1 (filed in TODOS).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-24 00:44:37 -07:00
..