Public: anyone can read this; the crew can change it.
docs/MCP.md describes `asks_decide`, `asks_undecide` and `asks_proposal` #6942
Check · Review · Land · Live done — Landed and live in production.
scout/forge:scout/6245-docs-mcp-md-describes-asks-decide-asks-u → main 1 commit fork
4 files
changed +4
−2
docs/MCP.md +2
| @@ -43,6 +43,8 @@ for a tunnel and a forge that sleeps. | ||
| 43 | 43 | | `archive` | `{ repo | repos, archived?, dryRun? }`: archive (true) or wake (false) a repository, by name; planned first (`dryRun` is true unless `false`); only the repository's admin with an admin token, never an agent. `repos` (at most 50) runs the fleet `archive` operation over them, answers each one's outcome and the `operation` id; `limb` with `action: "undo"`, that `operation` and any one of the repositories as `app` reverts it for a day | yes | |
| 44 | 44 | | `asked` | `{ repo?, show?, order? }`: what people asked the crew for, by default nothing merged yet and oldest first: who and when, the pulls that close it, the crew's last activity, waiting/building/shipped/closed, stale when not shipped in three days and flagged when stale with nothing built; repositories you can write | | |
| 45 | 45 | | `asks_decide` | `{ item, give_back? }`: let the decider answer a parked hand-over (`parked:<id>`); with `give_back`, give a hand-over back to the crew instead (`handover:<id>`, or `assigned:<id>` for a pull a pass gave up on and assigned to you, whose ask carries the pass's reason): it is assigned to the builder that last worked on it and a comment says so; the same as the card's **Give back to the crew** and `POST /api/v1/asks/give-back` | yes | |
| 46 | | `asks_proposal` | `{ id, verb, words? }`: act on a wave proposal (`id` is the proposal's own id, not the ask row's `proposal:` id): `verb` is `approve` (opens its issues), `redirect` (with `words`), `later` or `again`; the owner only; answers what the verb did, as `POST /api/v1/asks/proposal/:id/:verb` | yes | | |
| 47 | | `asks_undecide` | `{ id }`: put a set-aside card back on your board within a day (`id` from `asks_decide`); too late or unknown answers a refusal, as `POST /api/v1/asks/decide/:id/undo` | yes | | |
| 46 | 48 | | `assign` | `{ repo, number, kind, assignee }`: assign an issue or pull (`kind` is `issue` or `pull`) to a user, or clear it with `null`, as `PUT …/assignee` and with its refusals | yes | |
| 47 | 49 | | `assigned` | `{ limit? }`: the open issues and pulls assigned to you in every repository you can still read (repository, number, title, kind, state), as `GET /api/v1/user/assigned` | | |
| 48 | 50 | | `attach_look` | `{ app, pull, width, says, image, dryRun? }`: attach a look to an open pull: a PNG or JPEG (at most 5 MB, base64 in `image`), `width` phone or desktop, one line in `says`; planned first (`dryRun` is true unless `false`) | yes | |
src/http/mcp/tools/asks_proposal.ts +1
| @@ -3,6 +3,7 @@ import { good, bad, type Tool } from "../shared.ts"; | ||
| 3 | 3 | |
| 4 | 4 | export const tool: Tool = { |
| 5 | 5 | name: "asks_proposal", |
| 6 | doc: "`{ id, verb, words? }`: act on a wave proposal (`id` is the proposal's own id, not the ask row's `proposal:` id): `verb` is `approve` (opens its issues), `redirect` (with `words`), `later` or `again`; the owner only; answers what the verb did, as `POST /api/v1/asks/proposal/:id/:verb`", | |
| 6 | 7 | description: |
| 7 | 8 | "Act on a wave proposal: `approve`, `redirect` (`words`), `later` (`again`). Owner.", |
| 8 | 9 | inputSchema: { |
src/http/mcp/tools/asks_undecide.ts +1
| @@ -3,6 +3,7 @@ import { good, bad, type Tool } from "../shared.ts"; | ||
| 3 | 3 | |
| 4 | 4 | export const tool: Tool = { |
| 5 | 5 | name: "asks_undecide", |
| 6 | doc: "`{ id }`: put a set-aside card back on your board within a day (`id` from `asks_decide`); too late or unknown answers a refusal, as `POST /api/v1/asks/decide/:id/undo`", | |
| 6 | 7 | description: |
| 7 | 8 | "Put a set-aside card back on your board, within a day. `id` from `asks_decide`.", |
| 8 | 9 | inputSchema: { |
test/mcp-docs.test.ts −2
| @@ -21,8 +21,6 @@ const undocumented = new Set<string>([ | ||
| 21 | 21 | "here", |
| 22 | 22 | "asks", |
| 23 | 23 | "asks_act", |
| 24 | "asks_proposal", | |
| 25 | "asks_undecide", | |
| 26 | 24 | "spend", |
| 27 | 25 | "report", |
| 28 | 26 | ]); |
new above
offline