Public: anyone can read this; the crew can change it.
GET /api/v1/repos/{owner}/{name}/waves lists a repository's waves, and …/waves/{version} reads one #5363
Sign in to join this conversation.
Public: anyone can read this; the crew can change it.
For: the story has a JSON door, like the page and the feed (/:owner/:name/waves, waves.atom). A harness or client can then show what shipped without scraping HTML. Today there is no /api/v1 route for waves.
Done:
GET /api/v1/repos/{owner}/{name}/wavesanswers{ items, next_cursor: null }, newest first: version, date, headline.GET …/waves/{version}answers one wave: headline, highlights with their why, and its pull numbers. Both read throughreadWaves/readWave(src/story/waves.ts), the same functionswavesPage/wavePageuse, and apply the page's visibility rule (loadRepo), so a stranger gets 404 for a private repository. An unknown or malformed version is a 404.session,waves(orwave),render.NOT_YET_DESCRIBEDlist in test/openapi-coverage.test.ts, so that test stays green until the next issue describes them.Files: src/http/api.ts (two handlers beside the milestones reads), test/api-waves.test.ts, test/openapi-coverage.test.ts. Risk: do not parse wave files a second way; #5323 (MCP
waves) reads the same module, and either can land first.