Skip to content

docs(results): clarify remote sync CLI contract#1345

Merged
christso merged 1 commit into
mainfrom
feat/remote-results-cli-contract
Jun 10, 2026
Merged

docs(results): clarify remote sync CLI contract#1345
christso merged 1 commit into
mainfrom
feat/remote-results-cli-contract

Conversation

@christso

Copy link
Copy Markdown
Collaborator

Summary

The remote results contract is now explicit: agentv results is for local run workspaces, while manual remote status/sync stays with Dashboard/API and eval auto-export covers the publisher path.

This avoids adding a second CLI sync surface for project-scoped git behavior that already has a production API contract, while giving users concrete automation endpoints and a direct recovery escape hatch.

What changed

  • Documents the decision and future extension trigger in docs/plans/2026-06-10-remote-results-cli-contract.md.
  • Updates Results and Dashboard docs to name the Dashboard/API-only manual sync contract and list the status/sync endpoints.
  • Narrows agentv results --help wording to “local evaluation results” so the CLI surface matches the decision.

Red/green evidence

  • Red: before this branch, bun apps/cli/src/cli.ts results --help described the command as Inspect, export, and manage evaluation results while listing only local subcommands.
  • Green: after this branch, the same command says Inspect, export, and manage local evaluation results and still lists only local result artifact subcommands.

Verification

  • bun apps/cli/src/cli.ts results --help
  • bun test ./test/commands/results/serve.test.ts ./test/commands/results/summary.test.ts from apps/cli — 92 pass
  • bun --filter agentv test — 606 pass
  • bunx biome check apps/cli/src/commands/results/index.ts apps/web/src/content/docs/docs/tools/results.mdx apps/web/src/content/docs/docs/tools/dashboard.mdx docs/plans/2026-06-10-remote-results-cli-contract.md
  • bun --filter agentv typecheck
  • bun run lint
  • Push hook also ran workspace typecheck and lint successfully.

Code review: skipped (no Tier 1 tool; Tier 2 criteria not met for a small docs/CLI-help wording change).

Post-Deploy Monitoring & Validation

No additional operational monitoring required. This is a documentation and CLI help contract clarification; runtime remote sync behavior is unchanged.


Compound Engineering
GPT--5

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying agentv with  Cloudflare Pages  Cloudflare Pages

Latest commit: f2dc402
Status: ✅  Deploy successful!
Preview URL: https://233aa1b4.agentv.pages.dev
Branch Preview URL: https://feat-remote-results-cli-cont.agentv.pages.dev

View logs

@christso christso merged commit 5946428 into main Jun 10, 2026
8 checks passed
@christso christso deleted the feat/remote-results-cli-contract branch June 10, 2026 05:13
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