Skip to content

docs: run-log behavior_v2 + large-file commit path — plan (no code) - #181

Merged
mbreiser merged 3 commits into
mainfrom
docs/runlog-behavior-v2-plan
Sep 6, 2026
Merged

docs: run-log behavior_v2 + large-file commit path — plan (no code)#181
mbreiser merged 3 commits into
mainfrom
docs/runlog-behavior-v2-plan

Conversation

@mbreiser

@mbreiser mbreiser commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Design/plan only, no implementation. Drafted from the 51 MB 40 s-trial run that failed to auto-commit (Contents API ~35 MiB ceiling).

  • 76% of a run log is the per-frame arena_command echo (189 B/line of mostly constant fields). behavior_v2 re-encodes those as short arrays with ms offsets — lossless (every field kept or exactly derivable; round-trip test + converter CLI required). Frames unchanged.
  • Studio commits .jsonl.gz (native CompressionStream, 6–8×) with a Git Database API fallback above 30 MiB; readers inflate + expand v2 lines to the v1 object shape at parse time so all consumers keep working.
  • Projection: 40 s run 51 MB → ~2.5 MB; 1 h run → ~4 MB.

Three implementation PRs (bridge, Studio, dashboard) follow after review. Open decisions listed at the end of the doc.

🤖 Generated with Claude Code

mbreiser and others added 3 commits September 6, 2026 11:28
…oes) + gzip/Git-Database commit path

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…idge-client whitelist, bridge ack, ship order

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…r module, test matrix

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@mbreiser
mbreiser merged commit 3e32406 into main Sep 6, 2026
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