Skip to content

docs: update for enhanced proposal data API - #12

Closed
jean-neiverth wants to merge 2 commits into
mainfrom
jean/cow-1293-enhance-proposals-data-exposed-to-subsolvers
Closed

jean-neiverth wants to merge 2 commits into
mainfrom
jean/cow-1293-enhance-proposals-data-exposed-to-subsolvers

Conversation

@jean-neiverth

Copy link
Copy Markdown
Contributor

Companion to bleu/byos-service-ts#92.

Summary

  • Stale URLs — three links in guides/sub-solver-integration.md and one in design-document.md pointed to github.com/bleu/byos-service/blob/main/crates/byos/openapi.yml (old repo name and path). Updated to byos-service-ts/blob/main/apps/byos/openapi.yml.
  • Endpoint table — expanded GET /proposal/{id} description to reflect the full response (amounts, tokens, interactions, simulation results, timestamps). Added ?includeArchived=true note to both list endpoints.
  • Terminal retention — clarified that swept proposals go to proposals_log, not deleted; GET /proposal/{id} falls back to the log automatically so a swept proposal is never a 404.
  • Retention sweep section in service.md — same clarification, plus a note that list endpoints accept ?includeArchived=true to query the log directly.

- Fix stale GitHub URLs: byos-service/crates/byos → byos-service-ts/apps/byos
- Expand GET /proposal/{id} description to reflect full response
- Document ?includeArchived=true on list endpoints
- Note proposals_log fallback for swept proposals in GET by id
- Clarify retention sweep: rows are swept from active store, not deleted;
  permanent log ensures a swept proposal is never a 404
@linear-code

linear-code Bot commented Sep 29, 2026

Copy link
Copy Markdown

COW-1293

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