annsa_board
Destructive
Tidy the board. Use it to change a priority's stage or severity, merge duplicates, move priorities between groups, fix a title, place priorities on a bet, or cut a release. A merge retires the duplicate numbers for good. Some actions, like park and assign, are for people only. It doesn't do the work on a priority; that's annsa.work.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | For cut: the release date. | |
| op | No | For bet: 'list', 'create' (title and metric_label; agents last), 'update' (bet_id), 'delete', 'reorder' (bet_ids) or 'place' (priority_ids). For direction: 'get', 'list', 'update' (document_text and reason), 'comment' (thread_id), or 'approve' and 'dismiss' (document_id and reason; a person's). For cut: 'publish', with release_number, channel and the live annsa.ai url. It marks the release's rows Shared and sends nothing. For view: 'list', 'create', 'update', 'delete', or 'keep' and 'dismiss' (a person's). | |
| url | No | For cut op=publish: the live changelog link. | |
| into | No | For merge: the priority that stays. | |
| rank | No | For a bet: its place in the list, 1 is top; the others move down. | |
| items | No | For regroup: the new group for each priority. | |
| label | No | What to call this session, up to 60 characters. Shown as who did it. | |
| picks | No | For pick: priorities in order, each with a line on why. | |
| quote | No | For direction op=comment: the line you're replying to. | |
| since | No | For cut: the start of the window the release covers. | |
| stage | No | For set_stage: open, ready or closed. | |
| title | No | For bet or view: its title. | |
| until | No | For cut: the end of that window. | |
| action | Yes | set_stage: Move a priority to open, ready or closed. assign: Set who a spec is assigned to. A person's action. correct: Fix a title, detail or ruled-out entry. The old wording is kept. park: Take a priority off the list, with a reason, until someone unparks it. A person's action. unpark: Put a parked priority back on the list. retract: Unfile feedback, or mark a shipped priority as not shipped. A person's action; without confirm it only shows the plan. regroup: Move priorities between groups; the reply carries the undo. merge: Fold duplicate priorities into one. Their numbers are retired for good. Shipped priorities can't be merged. bet: List, create, update, delete or reorder bets, or place priorities on one. op says which. direction: Read, list, update or comment on a Direction page. op says which. set_severity: Set a priority's severity, P0 to P3. From an agent it's a proposal and needs a reason; a person's typed severity wins. cut: Close a release and write its changelog. op=publish marks its rows Shared. pick: Set a person's short list of priorities, in order. approve_findings: Let through agent findings held back by the daily limit. The owner's action. view: Save a board view. An agent's is a suggestion until a person keeps or dismisses it. | |
| bet_id | No | For bet update, delete or place: which bet. | |
| bucket | No | For a bet: the group it counts toward, like Product or GTM. | |
| doc_id | No | Which Direction page; leave it out for the Overview. | |
| parent | No | The priority this one sits under. For bet op=place: the bet. | |
| person | No | The email or user id of the person whose words they are. | |
| reason | No | Why, in a line. Needed for retract, correct, merge and an agent's severity. | |
| recipe | No | For view: the annsa.priorities arguments the view runs. | |
| aim_pct | No | For a bet: how much of your effort it should get, 0 to 100. | |
| bet_ids | No | For bet reorder: every bet's id, best first. | |
| channel | No | For cut op=publish: changelog or marketing. | |
| comment | No | For direction op=comment: your words. | |
| confirm | No | For retract: true to do it. Without it the reply only shows what would change. | |
| spec_id | No | For assign and retract: the spec id. | |
| view_id | No | For view update or delete: which view, from view op=list. | |
| why_now | No | For a bet: why it matters now, in a line. | |
| evidence | No | For direction op=update: the evidence behind the change. | |
| original | No | For correct: the old category, or the ruled-out entry being replaced. | |
| question | No | For view: the question the saved view answers. | |
| severity | No | 0 broken, 1 poor, 2 could be better, 3 minor. From an agent it's a proposal until a person sets it. | |
| corrected | No | For correct: what it should say now. | |
| doc_title | No | The page title (kept if blank). | |
| thread_id | No | For direction op=comment: the thread to reply in. | |
| duplicates | No | For merge: the priorities being folded into `into`. | |
| assigned_to | No | Who gets it: an agent (like claude-code or codex) or a person's email. Empty unassigns. | |
| document_id | No | For direction approve or dismiss: which page. | |
| park_reason | No | For park: why, up to 500 characters. | |
| priority_id | No | The long id, instead of priority_number. | |
| allow_shared | No | For retract: true to retract even after customers were told. | |
| feedback_ids | No | For retract: the feedback rows to unfile. | |
| metric_label | No | For a new bet: what the measure is called. | |
| metric_query | No | For a computed bet: the name of Annsa's measure. | |
| metric_value | No | For a written bet: the number now. A person's. | |
| person_words | No | The person's exact words, not a summary. Recorded as their quote. | |
| priority_ids | No | For bet op=place or direction: the priorities. | |
| document_text | No | For direction update: the page text, at least 50 characters. | |
| metric_source | No | For a new bet: written (you type the number) or computed (Annsa measures it). | |
| owner_user_id | No | For bet update: the owner's user id; none clears it. | |
| expected_stage | No | For set_stage: only change it if the stage is still this: open, ready or closed. | |
| release_number | No | For cut op=publish: which release. | |
| correction_type | No | For correct: 'title', 'detail', 'ruled_out' or 'category'. 'category' is a person's; the old wording is kept. | |
| priority_number | No | The # number, e.g. 20 for #20. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| who | No | ||
| record | No | ||
| message | No | ||
| success | No |