Summary
Add status lifecycle support for page notes so agents can claim and address them through the same start_work/finish_work MCP workflow used for annotations.
Problem
Page notes currently have no status field and are excluded from the start_work/finish_work workflow. When a reviewer adds a page note like "restructure the hero section" or "navigation feels cluttered", an agent can see it via list_annotations but has no way to signal that it's working on it or mark it as addressed. The reviewer gets no feedback on whether their page-level feedback has been acted on.
Proposal
- Add status lifecycle to page notes: open → in_progress → addressed (matching annotations)
- Allow start_work to accept a page note ID — sets status to in_progress and returns full detail
- Allow finish_work to accept a page note ID — sets status to addressed, optionally with a reply message
- Add status badges and Accept/Reopen actions to page notes in the panel UI (matching annotation behaviour)
- Update list_annotations to include page note status in the response and respect the status filter parameter
Key Constraints
- Backward compatibility — existing page notes without a status field should default to open (same pattern used for annotations)
- Schema change — page notes will need inProgressAt, addressedAt, status, and replies fields added to the type definition
- REST API — the PATCH endpoint for page notes currently only accepts note updates; it will need to accept status changes and replies too
- MCP tools — start_work and finish_work currently validate against annotation IDs only; they need to check page notes as well
Complexity
Medium — touches types, storage, MCP tools, REST API, and panel UI, but each change follows existing annotation patterns closely.
Related
- The MCP workflow (list → start → finish) is documented in CLAUDE.md and the README
- Page notes are already returned by list_annotations but lack lifecycle fields
Tasks
Summary
Add status lifecycle support for page notes so agents can claim and address them through the same start_work/finish_work MCP workflow used for annotations.
Problem
Page notes currently have no status field and are excluded from the start_work/finish_work workflow. When a reviewer adds a page note like "restructure the hero section" or "navigation feels cluttered", an agent can see it via list_annotations but has no way to signal that it's working on it or mark it as addressed. The reviewer gets no feedback on whether their page-level feedback has been acted on.
Proposal
Key Constraints
Complexity
Medium — touches types, storage, MCP tools, REST API, and panel UI, but each change follows existing annotation patterns closely.
Related
Tasks