Edit Map
edit_mapModify one Map section at a time—destination, notes, fog, or out-of-scope—without rewriting the others. Pass expected_revision from a prior read to ensure concurrent sessions do not clobber 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 the Effort and its Map if neither exists. Otherwise an unknown slug fails. | |
| 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. |