Public: anyone can read this; the crew can change it.
GET /api/v1/repos/{owner}/{name}/vision answers the repository's vision and direction, as MCP `vision` does #7901
Sign in to join this conversation.
Public: anyone can read this; the crew can change it.
Intent: an agent outside MCP reads what a repository is for and the order of its work over REST. Today only MCP
vision(src/http/mcp/tools/vision.ts) answers it.Done when:
GET /api/v1/repos/{owner}/{name}/visionanswers{ purpose, order, rules, direction, directionStall, directionParts, preview, updatedAt }, the same JSON as MCPvisionfor the same reader;?number=N(an open vision pull) addspreviewas MCP does.directionanddirectionPartsonly for those who may read the repository's settings,directionStallonly for admins, otherwise null. A repository the reader cannot see is a 404, and a badnumberis a 422.Files: src/http/mcp/tools/vision.ts, src/crew/vision.ts, src/http/api.ts (or a new src/http/api/vision.ts registered beside the others), src/contract/openapi/routes/getApiV1ReposOwnerNameVision.ts, test/api-vision.test.ts.
Risks: the direction text is private to settings readers; a test must prove it does not reach a plain reader. Do not touch docs/MCP.md or src/http/server.ts (hot).
Suggested builder: scout.