Delimit Ledger Update
delimit_ledger_updateUpdate any field on an existing ledger item, including status, priority, assignee, labels, and more. Pass only the fields you want to change; use separate tools to create or close items.
Instructions
Update any field on an existing ledger item.
When to use: to change state on a ledger item (status, priority, assignee, links, labels). Pass only the fields you want to change. When NOT to use: to create a new item (use delimit_ledger_add) or to mark one done (delimit_ledger_done is the convenience wrapper).
Sibling contrast: delimit_ledger_add creates; delimit_ledger_done closes; this is the general-purpose updater.
Side effects: writes to the ledger via ai.ledger_manager. Coerces
string list inputs (labels) through _coerce_list_arg. LED-5658 review
v2: a venture that resolves to UNKNOWN — no recognized slug AND no
real project directory behind it (auto-detect, an empty venture,
can never be unknown) — is rejected BEFORE any lookup or write, with
{"error", "unknown_venture", "known_ventures"} and, when item_id is
found to actually exist in some other real registered venture
(read-only check, never a write), item_found_in naming it. Every
other case — auto-detect, a recognized venture, or an explicit path
to a real (even if unregistered) project — is unchanged: it keeps the
existing cross-venture fallback search, and the response carries
venture_fallback: true when that fallback is what located the item.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Append a note/comment to the item. | |
| title | No | New title. | |
| blocks | No | Item id that this one blocks (e.g. "STR-005"). | |
| labels | No | Labels/tags as comma string or list. | |
| status | No | New status — "open", "in_progress", "blocked", "done". | |
| item_id | Yes | Ledger item id, e.g. "LED-001" or "STR-001". Required. | |
| venture | No | Project name/path. Empty = auto-detect. | |
| assignee | No | Assign to person or agent (e.g. "founder", "claude"). | |
| due_date | No | ISO date string (e.g. "2026-04-01"). | |
| evidence | No | Optional evidence object {class, kind, ref, observed_at, observed_by} (LED-5321 M4). Dict or JSON string. | |
| priority | No | New priority — "P0", "P1", "P2". | |
| worked_by | No | AI model working on this. Empty = auto-detect. | |
| blocked_by | No | Item id that blocks this one (e.g. "LED-025"). | |
| description | No | New description. | |
| review_diff_path | No | Optional diff file path the transcript must bind to. | |
| review_diff_text | No | Optional inline diff text the transcript must bind to. | |
| review_transcript | No | Optional transcript path for independently_reviewed binding. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||