Skip to content

docs(adr): clarify result row sidecar identity#1556

Merged
christso merged 3 commits into
mainfrom
docs/row-id-result-layout
Jun 29, 2026
Merged

docs(adr): clarify result row sidecar identity#1556
christso merged 3 commits into
mainfrom
docs/row-id-result-layout

Conversation

@christso

@christso christso commented Jun 28, 2026

Copy link
Copy Markdown
Collaborator

Summary

Reconciles the accepted result-layout ADRs with the final merged layout from PR #1558: an AgentV invocation writes under .agentv/results/<experiment>/<timestamp>/, and each target plus optional variant gets its own nested result bundle with index.jsonl, summary.json, and deterministic <row_id>/run-1, <row_id>/run-2, etc. sidecars.

This keeps experiment as the campaign namespace and the timestamp as the invocation/batch folder, while making the target/variant folders storage isolation and manual browsing aids only. Dashboard and readers discover nested index.jsonl manifests, then use manifest and row metadata for target, variant, eval path, suite, and test identity semantics.

Changes

  • Updates ADR 0009 to document .agentv/results/<experiment>/<timestamp>/<target>/<variant?>/ bundles, each with its own index.jsonl and summary.json.
  • Defines deterministic row_id directories inside each target/variant bundle, with repeated runs under run-1, run-2, and so on.
  • States that legacy timestamp-level index.jsonl bundles remain readable.
  • Clarifies that target, variant, eval_path, suite, and test_id semantics come from summary/index metadata, not folder-name parsing.
  • Aligns ADR 0006 with ADR 0009 and removes the older imported-suite/direct-under-timestamp hierarchy guidance.
  • Keeps the explicit non-goals: no rows/ parent folder, no new experiment artifact, and no hard-coded Next/Vercel semantics.

Testing

  • git diff --check origin/main...HEAD
  • bun run beads:check (passes with existing warning: .beads/config.yaml missing in this worktree)

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 28, 2026

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: e2867cc
Status: ✅  Deploy successful!
Preview URL: https://173f84b7.agentv.pages.dev
Branch Preview URL: https://docs-row-id-result-layout.agentv.pages.dev

View logs

@christso christso force-pushed the docs/row-id-result-layout branch from ad76759 to 0456fa6 Compare June 29, 2026 06:44
@christso christso marked this pull request as ready for review June 29, 2026 06:45
@christso christso merged commit 165de9f into main Jun 29, 2026
8 checks passed
@christso christso deleted the docs/row-id-result-layout branch June 29, 2026 08:53
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