What Matters

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['title', 'section', 'initiated'], 'properties': {'due': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'YYYY-MM-DD.'}, 'note': {'type': 'string', 'maxLength': 10000, 'description': 'Prose context, markdown. A URL belongs in `links`, not here.'}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 1000, 'description': 'The full URL, http or https only. Up to 1000 characters.'}, 'label': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'What to call it â\x80\x94 "the Teams thread", "the signed contract". Never the raw URL.'}}}, 'maxItems': 3, 'description': 'Up to 3 named links â\x80\x94 the thread, the document, the ticket. Prefer these over pasting a URL into the note.'}, 'title': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'The thing to do.'}, 'source': {'type': 'string', 'maxLength': 200, 'description': 'Who it involves or where it came from â\x80\x94 "Dana", "Tuesday\'s standup".'}, 'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'flagged': {'type': 'boolean', 'description': 'True marks the task as urgent â\x80\x94 needing the userâ\x80\x99s attention now. Set it only when the user asked for the flag, or something genuinely cannot wait; it changes no ordering and no due date.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'initiated': {'enum': ['human', 'auto'], 'type': 'string', 'description': 'Who set this add in motion. "human" = the user asked for it in this conversation â\x80\x94 whoever is talking to you, not one specific person. "auto" = you are adding it on your own initiative with no direct instruction. Be truthful: "auto" combined with priority "high" interrupts the user\'s phone.'}, 'source_id': {'type': 'string', 'maxLength': 500, 'description': 'The stable id of whatever this came from â\x80\x94 a Teams message id, an Outlook internetMessageId, a calendar event id. Set it whenever you have one: it is how the app recognises the same thing again, across runs and after rewording.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['item_id'], 'properties': {'done': {'type': 'boolean', 'description': 'Default true.'}, 'item_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'include_rules': {'type': 'boolean', 'description': 'Include the standing rules. Default true. Read them: the server drops any suggestion an active rule excludes, so proposing one is wasted effort.'}, 'include_dismissed': {'type': 'boolean', 'description': 'Include deleted items and previously rejected suggestions. Default true, and you almost always want it: this is how you avoid proposing something again.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['terms'], 'properties': {'terms': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The complete list, in the order the user wants to see it. An empty array clears it.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation'], 'properties': {'rule': {'type': 'object', 'required': ['action', 'match', 'reason', 'origin'], 'properties': {'match': {'type': 'object', 'required': ['conditions'], 'properties': {'op': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all'}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'op', 'value'], 'properties': {'op': {'enum': ['equals', 'not_equals', 'contains'], 'type': 'string'}, 'field': {'enum': ['section', 'channel', 'source', 'title', 'priority', 'due_relative'], 'type': 'string'}, 'value': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'minItems': 1}}}, 'maxItems': 10, 'minItems': 1}}}, 'action': {'enum': ['exclude', 'recategorize', 'always_keep', 'boost'], 'type': 'string'}, 'origin': {'type': 'object', 'required': ['from'], 'properties': {'from': {'enum': ['rejections', 'manual'], 'type': 'string'}, 'count': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0}, 'rejection_ids': {'type': 'array', 'items': {'type': 'string'}, 'default': [], 'maxItems': 50}}}, 'params': {'type': 'object', 'default': {}, 'properties': {'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "Why this rule exists, in the user's terms. Shown next to it on the rules page."}, 'status': {'enum': ['active', 'paused'], 'type': 'string'}}, 'description': 'Required for create.'}, 'patch': {'type': 'object', 'properties': {'match': {'type': 'object', 'required': ['conditions'], 'properties': {'op': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all'}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'op', 'value'], 'properties': {'op': {'enum': ['equals', 'not_equals', 'contains'], 'type': 'string'}, 'field': {'enum': ['section', 'channel', 'source', 'title', 'priority', 'due_relative'], 'type': 'string'}, 'value': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'minItems': 1}}}, 'maxItems': 10, 'minItems': 1}}}, 'action': {'enum': ['exclude', 'recategorize', 'always_keep', 'boost'], 'type': 'string'}, 'params': {'type': 'object', 'properties': {'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "Why this rule exists, in the user's terms. Shown next to it on the rules page."}, 'status': {'enum': ['active', 'paused'], 'type': 'string'}}, 'description': 'Fields to change, for update.'}, 'rule_id': {'type': 'string', 'description': 'Required for update, pause, resume and delete.'}, 'operation': {'enum': ['create', 'update', 'pause', 'resume', 'delete'], 'type': 'string'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['deltas'], 'properties': {'agent': {'type': 'string', 'maxLength': 40, 'minLength': 1, 'description': 'Your name as the user knows you â\x80\x94 "Claude" â\x80\x94 shown as the review headline ("Claude suggests some changes") and in the notification. Just the name: no model version, no "AI". Omit it and the screen says "Your AI agent".'}, 'deltas': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['kind', 'item'], 'properties': {'item': {'type': 'object', 'required': ['title', 'section'], 'properties': {'due': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'YYYY-MM-DD. Anything dated today or earlier surfaces in the Today section, so only set this when there is a real deadline â\x80\x94 a speculative date drags it to the top.'}, 'note': {'type': 'string', 'maxLength': 2000, 'description': 'Optional detail or context, markdown. Leave empty unless it genuinely adds something. Up to 2000 characters â\x80\x94 a paragraph or two, not a transcript.'}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 1000, 'description': 'The full URL, http or https only. Up to 1000 characters.'}, 'label': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'What to call it â\x80\x94 "the Teams thread", "the signed contract". Never the raw URL.'}}}, 'default': [], 'maxItems': 3, 'description': 'Up to 3 named links â\x80\x94 the thread, the document, the ticket. Prefer these over pasting a URL into the note: they render as buttons rather than as a wall of text.'}, 'title': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'The thing to do, phrased as an action the user can act on. Prefer "Reply to Dana about the audit dates" over "Dana email". Keep it to one line â\x80\x94 200 characters at most, and anything approaching that belongs in the note instead.'}, 'source': {'type': 'string', 'maxLength': 200, 'description': 'Who it involves or where it came from â\x80\x94 "Dana", "You â\x86\x92 Dana", "Tuesday\'s standup". Free text: sometimes a person, sometimes an occasion.'}, 'status': {'enum': ['open', 'done'], 'type': 'string', 'description': 'open or done. Leave it out for anything the user still has to act on â\x80\x94 which is almost always. Send "done" only when adding something that ALREADY happened and is worth keeping as a record.'}, 'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'default': 'self', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'flagged': {'type': 'boolean', 'description': 'True marks this task as urgent â\x80\x94 needing the userâ\x80\x99s attention now. The user toggles it in the app, and the daily briefing offers it on critical findings. It changes no ordering and no due date: a flag is attention, not a deadline. Set it only when something genuinely cannot wait; flag everything and it means nothing. Absent means not flagged.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string', 'default': 'medium', 'description': 'How much this matters: low, medium or high. Defaults to medium â\x80\x94 most things are medium, so use high only when someone is blocked or a real deadline is close, and low for things that genuinely can wait. Marking everything high makes the list useless.'}, 'initiated': {'enum': ['human', 'auto'], 'type': 'string', 'description': 'Only two values, and only for AI adds. "human" = the user asked for this item in conversation just now â\x80\x94 any user, whoever is talking to the MCP server, not one specific person. "auto" = the AI added it on its own initiative, with no direct instruction. Absent on items the user typed into the app themselves.'}, 'source_id': {'type': 'string', 'maxLength': 500, 'description': 'The stable id of whatever this came from â\x80\x94 a Teams message id, an Outlook internetMessageId, a calendar event id. Set it whenever you have one. It is how the app recognises the same thing again after you have reworded the title, which you are otherwise told to do.'}}}, 'kind': {'type': 'string', 'const': 'add'}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}}, 'description': 'Suggest a new item the user does not have yet.'}, {'type': 'object', 'required': ['kind', 'item_id'], 'properties': {'kind': {'type': 'string', 'const': 'complete'}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'item_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest an item is already DONE â\x80\x94 the meeting happened, the reply was sent. This is almost always what you want when something looks finished. It keeps the record that he completed it; use remove only when the item should never have been there.'}, {'type': 'object', 'required': ['kind', 'item_id'], 'properties': {'kind': {'type': 'string', 'const': 'remove'}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'item_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest an item should be cleared without being done â\x80\x94 a duplicate, or something that stopped being relevant. If it was actually finished, use complete instead.'}, {'type': 'object', 'required': ['kind', 'item_id', 'patch'], 'properties': {'kind': {'type': 'string', 'const': 'update'}, 'patch': {'type': 'object', 'properties': {'due': {'anyOf': [{'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$'}, {'type': 'null'}], 'description': 'YYYY-MM-DD. Anything dated today or earlier surfaces at the top, so only set this when there is a real deadline â\x80\x94 a speculative date drags it up. Omit to leave the due date alone; null clears it.'}, 'note': {'anyOf': [{'type': 'string', 'maxLength': 2000}, {'type': 'null'}], 'description': 'Optional detail or context, markdown. Prose only â\x80\x94 a URL belongs in `links`, not here. Up to 2000 characters. Omit to leave the note alone; null clears it.'}, 'links': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 1000, 'description': 'The full URL, http or https only. Up to 1000 characters.'}, 'label': {'type': 'string', 'maxLength': 80, 'minLength': 1, 'description': 'What to call it â\x80\x94 "the Teams thread", "the signed contract". Never the raw URL.'}}}, 'maxItems': 3, 'description': 'Up to 3 named links â\x80\x94 the thread, the document, the ticket. PUT URLS HERE, never pasted into the note: they render as buttons rather than a wall of text. Replaces the whole list, so include any existing links you want to keep. Omit to leave them alone.'}, 'title': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'The thing to do, phrased as an action the user can act on. Prefer "Reply to Dana about the audit dates" over "Dana email". Keep it to one line â\x80\x94 200 characters at most, and anything approaching that belongs in the note instead.'}, 'source': {'anyOf': [{'type': 'string', 'maxLength': 200}, {'type': 'null'}], 'description': 'Who it involves or where it came from â\x80\x94 "Dana", "You â\x86\x92 Dana", "Tuesday\'s standup". Omit to leave it alone; null clears it.'}, 'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'flagged': {'type': 'boolean', 'description': 'True marks this task as urgent â\x80\x94 needing the userâ\x80\x99s attention now; false clears the flag. It changes no ordering and no due date: a flag is attention, not a deadline. Set true only when something genuinely cannot wait. Omit to leave the flag alone.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string', 'description': 'How much this matters: low, medium or high. Use high only when someone is blocked or a real deadline is close, and low for things that genuinely can wait. Marking everything high makes the list useless. Omit to leave the current priority alone.'}}}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'item_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest changing fields on an existing item â\x80\x94 a slipped due date, a better title. Include only the fields that change; anything omitted is left alone.'}, {'type': 'object', 'required': ['kind', 'rule'], 'properties': {'kind': {'type': 'string', 'const': 'add_rule'}, 'rule': {'type': 'object', 'required': ['action', 'match', 'reason', 'origin'], 'properties': {'match': {'type': 'object', 'required': ['conditions'], 'properties': {'op': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all'}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'op', 'value'], 'properties': {'op': {'enum': ['equals', 'not_equals', 'contains'], 'type': 'string'}, 'field': {'enum': ['section', 'channel', 'source', 'title', 'priority', 'due_relative'], 'type': 'string'}, 'value': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'minItems': 1}}}, 'maxItems': 10, 'minItems': 1}}}, 'action': {'enum': ['exclude', 'recategorize', 'always_keep', 'boost'], 'type': 'string'}, 'origin': {'type': 'object', 'required': ['from'], 'properties': {'from': {'enum': ['rejections', 'manual'], 'type': 'string'}, 'count': {'type': 'integer', 'default': 0, 'maximum': 9007199254740991, 'minimum': 0}, 'rejection_ids': {'type': 'array', 'items': {'type': 'string'}, 'default': [], 'maxItems': 50}}}, 'params': {'type': 'object', 'default': {}, 'properties': {'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "Why this rule exists, in the user's terms. Shown next to it on the rules page."}, 'status': {'enum': ['active', 'paused'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}}, 'description': 'Suggest a standing rule, mined from a pattern in the rejections list. Only when 3 or more rejections share a trait and no active rule already covers it â\x80\x94 one rejection is never a pattern. Never auto-applied: it does nothing until the user accepts it.'}, {'type': 'object', 'required': ['kind', 'rule_id', 'patch'], 'properties': {'kind': {'type': 'string', 'const': 'update_rule'}, 'patch': {'type': 'object', 'properties': {'match': {'type': 'object', 'required': ['conditions'], 'properties': {'op': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all'}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'op', 'value'], 'properties': {'op': {'enum': ['equals', 'not_equals', 'contains'], 'type': 'string'}, 'field': {'enum': ['section', 'channel', 'source', 'title', 'priority', 'due_relative'], 'type': 'string'}, 'value': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'minItems': 1}}}, 'maxItems': 10, 'minItems': 1}}}, 'action': {'enum': ['exclude', 'recategorize', 'always_keep', 'boost'], 'type': 'string'}, 'params': {'type': 'object', 'properties': {'channel': {'enum': ['self', 'teams', 'email', 'meeting', 'other'], 'type': 'string', 'description': 'Where it came from, which is what makes an item legible days later. self = the user thought of it themselves, no external trigger. teams = a Teams message or chat. email = an email thread. meeting = raised in or arising from a meeting. other = anywhere else. Describe the ORIGIN, not who added it â\x80\x94 an item you add from an email is still email.'}, 'section': {'enum': ['action', 'waiting', 'note'], 'type': 'string', 'description': "Which list it belongs in. action = something the user owes someone or themselves. waiting = something owed TO them; they are blocked and the next move is not theirs. note = worth knowing, no action attached. Pick waiting over action whenever the ball is in someone else's court â\x80\x94 the distinction is the whole point of the two lists."}, 'priority': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 300, 'minLength': 1, 'description': "Why this rule exists, in the user's terms. Shown next to it on the rules page."}, 'status': {'enum': ['active', 'paused'], 'type': 'string'}}}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'rule_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest changing an existing rule â\x80\x94 usually to narrow one that is too broad.'}, {'type': 'object', 'required': ['kind', 'rule_id'], 'properties': {'kind': {'type': 'string', 'const': 'remove_rule'}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'rule_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest deleting a rule outright.'}, {'type': 'object', 'required': ['kind', 'rule_id'], 'properties': {'kind': {'type': 'string', 'const': 'pause_rule'}, 'reason': {'type': 'string', 'maxLength': 500, 'description': 'Why you are suggesting this, in one line. Shown next to the row when he reviews it, so it is what he judges the suggestion on â\x80\x94 "She has asked twice and the second went unanswered" beats "found in email".'}, 'rule_id': {'type': 'string', 'format': 'uuid', 'pattern': '^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$', 'description': 'The "id" of an existing item, exactly as returned by get_document.'}}, 'description': 'Suggest pausing a rule, leaving it in the list so it can be resumed.'}]}, 'description': 'The proposed changes â\x80\x94 add, complete, remove or update, plus the rule kinds. At most 100: send the ones that matter most and let the rest wait for the next run, because a review too long to finish gets dismissed whole. An empty array clears the proposal. Prefer complete over remove for anything that actually got done.'}, 'summary': {'type': 'string', 'maxLength': 1000, 'description': 'One line on what this pass looked at.'}}}