Skip to content

Nested key layout for archive manifests and reports#307

Open
probably-jaden wants to merge 1 commit into
mainfrom
feat/nested-archive-keys
Open

Nested key layout for archive manifests and reports#307
probably-jaden wants to merge 1 commit into
mainfrom
feat/nested-archive-keys

Conversation

@probably-jaden

Copy link
Copy Markdown
Contributor

Flat manifests/<run_id>.jsonl / reports/<run_id>.json keys pile every run into one folder. This adds a small layout.py helper and nests new writes by run family:

  • an explicit group pins the folder (e.g. manifests/sprints/myrun/<run_id>.jsonl)
  • daily-YYYY-MM-DD run ids nest under daily/<YYYY-MM>/
  • everything else lands under adhoc/

Writers (capture --upload-manifest, ingest-traces --upload, write_run_report, write_cost_report) go through the helper, and the capture / ingest-traces commands gain a --group option (e.g. --group sprints/myrun).

Old archives keep working: prefix-listing readers (catalog, coverage, viewer) already pick up nested keys recursively on both the S3 and local stores (verified by test), and exact-key manifest reads (manifest.read_blob) now try the nested candidates first, then fall back to the legacy flat key.

Tests: code_tests/unit_tests/test_agents_and_tools/test_source_archive/ — 138 passed (new test_layout.py covers the key helpers, the reader fallback, and nested+flat pickup by catalog/coverage readers).

🤖 Generated with Claude Code

Flat manifests/<run_id>.jsonl and reports/<run_id>.json keys pile every
run into one folder. Add a small layout helper that nests new writes:
an explicit --group (e.g. sprints/myrun) pins the folder, daily-YYYY-MM-DD
run ids nest under daily/<YYYY-MM>/, everything else under adhoc/.

Writers (capture --upload-manifest, ingest-traces --upload,
write_run_report, write_cost_report) use the helper and gain a group
parameter; the capture and ingest-traces commands gain --group.
Prefix-listing readers (catalog, coverage, viewer) pick up both layouts
already; exact-key manifest reads now try the nested key first and fall
back to the legacy flat key, so existing archives keep working.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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