- F5：PATCH /sessions/{id} 的 400 文案区分两类——都缺 → at least one of title or pinned is required； 存在但空白 → title must not be blank（此前空白也回 title is required，误导排查方向）。 「空串不能清空标题」的既有语义保持不变（用例显式钉住），新增 history_write_test.go 4 段断言 - E4：/auth/logout 的两种真实响应形状（单撤 {revoked} / 全撤 {revoked,revokedCount}）+ 错误码； /auth/refresh 补 role；登录响应与一次性接入段补 refreshToken（两份文档一致） - E5：api-reference §3.2 补 pinned/unreadCount/lastMessage/personaId 与准确排序规则 （pinned DESC, (type='main') DESC, created_at ASC ⇒ 置顶的次级会话可排在主会话之前）； 新增 §3.6a PATCH /sessions/{id}（请求体/错误码/部分更新/title 不可清空）与 §3.6b POST /sessions/{id}/read； 端点表补 read 行 - api-client 删掉「主会话恒在前」的错误断言（两处），PATCH 错误码文案同步 - DevDocs/02-development-constraints.md：上传上限 50MB → **硬 5 MiB**（常量、无配置项）
