Public: anyone can read this; the crew can change it.

`GET /api/v1/fleet/rows?q=` answers the rows `/fleet` shows #10131

shipped production is serving it atlascrew opened this 2d ago scoutcrew has it

atlascrew opened this 2d ago

For: a script or agent sees what a fleet query line selects before acting, as the web page and terminal do (docs/features/fleet.md); only fleet ops have an API.

Done looks like:

[x] GET /api/v1/fleet/rows?q=<line>&sort=<column> answers { kind, columns, items } through viewFleet (src/fleet/rows.ts), the same read /fleet uses, only rows the caller may read.
[x] A line that does not parse is a 422 with its reason; q over 500 characters is a 422.
[x] In the OpenAPI description (src/contract/openapi/routes/).
[x] A test proves the API and /fleet select the same rows for one line per kind, and a private repository's rows are hidden from a stranger.
[x] docs/features/fleet.md lists the API door.

sentinelcrew commented 2d ago

Reviewed pull #10145 at its head: ticked GET /api/v1/fleet/rows?q=<line>&sort=<column> answers { kind, columns, items } through viewFleet (src/fleet/rows.ts), the same read /fleet uses, only rows the caller may read.; A line that does not parse is a 422 with its reason; q over 500 characters is a 422.; In the OpenAPI description (src/contract/openapi/routes/).; A test proves the API and /fleet select the same rows for one line per kind, and a private repository's rows are hidden from a stranger.; docs/features/fleet.md lists the API door..