读取看板完整快照：栏目定义、每列下的任务、统计（总数/已完成/百分比）。想看当前进展、或要渲染看板时用它。compact=true 时只返回任务 id 与标题，任务很多时可显著减小返回体积。

读取当前生效的看板配置：栏目、合法流转、自定义字段、数据库路径、Web 端口。在决定「能移到哪一列」「有哪些自定义字段」之前先看它。

在看板上新建一个任务。column_id 省略时放到第一列；fields 只接受在配置 board.fields 中定义过的键，传未定义的键会报错。

把任务移到另一列（状态流转）。流转合法性由配置 board.transitions 决定，非法流转会报错并列出该列允许的目标。before_task_id 可指定插到某任务之前。

更新任务的标题/说明/标签/自定义字段/优先级。只改传入的部分。

删除一个任务。会同时登记一条 delete 事件（任务数据不可恢复）。

读取单个任务的完整字段。

按列或标签筛选任务。想看「进行中都有什么」时用 column_id 过滤。默认不返回已归档的任务（完成已久、已挪出主视图的）；要看历史就传 include_archived=true。归档不是删除，数据一直都在。

列出所有栏目（列）及其顺序、颜色、在制品上限。

推进某个任务的进度字段（长耗时任务用）。进度只增不减：传入比当前更小的值会被显式拒绝并告诉你当前值是多少（对齐 MCP 规范 progress 语义）。current 传绝对值而非增量，因此重复调用是幂等的、重试不会推两遍。建议长任务周期性上报 —— 否则会被 list_stalled 判定为停滞。

列出疑似停滞的任务：仍在非终态列、且超过阈值秒数没有任何写入。语义是「上报中断」而非「进度值没变」 —— 所以长任务必须周期性调用 update_progress 上报，否则会被误标。返回里带 idle_sec（静默了多久）。

读取变更流水（谁在什么时候把什么从哪列移到哪列）。since_seq 支持增量拉取；给定 task_id 可看单个任务的完整历史。

把「完成已久」的已完成任务归档出主视图。归档 = 打标记，一条都不删，随时可用 restore_archived 拿回来。平时无需手动调：看板快照会自动巡检，按配置 board.archive_done_after_days（默认 3 天）归档。这里传 older_than_days 可以临时改用另一个保留期。

把归档的任务还原回主视图。给 task_id 还原那一个；不给则全部还原。

清空看板上的全部任务。破坏性操作，必须显式传 confirm=true 才会执行。