Edit Map
edit_mapEdit individual Map sections—destination, notes, fog, or out-of-scope—without rewriting the rest. Uses expected_revision to prevent overwriting concurrent changes.
Instructions
Read a Map's Destination and Notes, or edit one typed section — set Destination or Notes, add or graduate a fog patch, rule something out of scope — without rewriting the others. Decisions-so-far is generated from resolved Tickets and never accepted as input. Mutations pass expected_revision from a prior read so concurrent sessions cannot clobber each other.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | Workspace directory. Defaults to the session workspace. | |
| notes | No | Replace the Notes section. | |
| create | No | Start a missing Effort and its Map. Only for Effort/Map that do not exist yet — not a flag to send on every call. Does not change revision rules for mutations on an existing Map; create with no section fields reads an existing Map like a plain read. | |
| effort | Yes | Effort slug whose Map to read or edit. | |
| add_fog | No | Append a fog patch under Not yet specified. | |
| rule_out | No | Append a hand-ruled item under Out of scope. Never touches Decisions-so-far. | |
| destination | No | Replace the Destination section. | |
| graduate_fog | No | Remove a fog patch matched on its text. Fails when none match. | |
| expected_revision | No | Revision from a prior edit_map read. Required when overwriting an existing Map; omitted when creating one. |