chore: rebuild release package

.planning/session-item-title-tooltip/findings.md

@@ -0,0 +1,7 @@
+# 会话卡片完整标题悬停提示：发现
+
+- `createSessionListItem()` 创建侧边栏会话卡片。
+- 当前实现仅在存在有效工作目录时执行 `item.title = sessionCwd`，因此浏览器原生提示只显示项目路径。
+- 卡片正文的 `.session-item-title` 会因布局宽度省略，完整 `session.title` 没有进入可访问提示。
+- `getSessionProjectName(session)` 已统一优先读取 `session.projectName`，否则从有效 cwd 取末级目录，适合作为提示中的项目名来源。
+- 推荐提示格式：`项目：<项目名>\n标题：<完整标题>`；若缺少项目名，则只显示标题行。

.planning/session-item-title-tooltip/progress.md

@@ -0,0 +1,18 @@
+# 会话卡片完整标题悬停提示：进度
+
+## 2026-07-27
+
+- 已恢复当前用户意图，排除根目录旧 CSV 与已完成标题历史任务的干扰。
+- 已使用 codebase-memory 确认索引 ready，并定位 `createSessionListItem()` 与 `getSessionProjectName()`。
+- 已确认根因是卡片 `title` 属性仅使用 cwd，完整会话标题未进入悬停提示。
+- 已新增 `session-item-tooltip` 专项回归，首次运行在缺少 `buildSessionItemTooltip` 处按预期失败。
+- 回归断言阶段完成，进入最小实现。
+- 已实现两行悬停提示：项目名复用统一解析逻辑，标题使用完整原文并保留无项目兜底。
+- 已更新前端缓存版本；`session-item-tooltip` 专项回归通过。
+- 进入全量验证与最终影响面审查。
+- `node --check`（app/regression/server）、`git diff --check`、标题历史专项和 tooltip 专项全部通过。
+- 完整 `npm run regression` 通过并输出 `Regression checks passed.`。
+- 独立只读审查确认根因、实现位置和回归覆盖一致，没有发现需要扩大的改动。
+- PM2 显示 ccweb online，但本地静态页请求超时；随后运行中会话查询也超时，无法满足安全重启前置条件，因此未重启。
+- 最终代码审查确认卡片提示固定为两行“项目 + 完整标题”，无项目时仍完整显示标题；缓存版本已同步。
+- 任务完成，删除临时 TODO CSV，保留 scoped planning 记录。

.planning/session-item-title-tooltip/task_plan.md

@@ -0,0 +1,29 @@
+# 会话卡片完整标题悬停提示
+
+## 目标
+
+当侧边栏会话标题因宽度不足被省略时，悬停会话卡片应同时显示项目名和完整会话标题，不能只显示项目路径。
+
+## 阶段
+
+| 阶段 | 状态 | 验收标准 |
+|---|---|---|
+| 1. 定位悬停提示与项目名来源 | complete | 找到会话卡片 DOM 构建函数及现有 title 属性来源 |
+| 2. 补充回归断言 | complete | 测试明确要求提示包含项目名和完整标题 |
+| 3. 实现完整悬停提示 | complete | 卡片 title 使用两行“项目 + 标题”，标题不截断 |
+| 4. 验证与审查 | complete | 专项、全量回归、语法和 diff 检查通过 |
+
+## 约束
+
+- 不改变侧边栏会话卡片的现有布局和截断行为。
+- 使用会话已有的项目名解析逻辑，避免重复路径解析规则。
+- 保留工作区内其他任务的未提交改动。
+- 未确认没有其他 running 会话前不重启 ccweb。
+
+## 错误记录
+
+| 错误 | 尝试 | 处理 |
+|---|---|---|
+| 专项回归因缺少 `buildSessionItemTooltip` 失败 | 1 | 失败符合 TDD 预期，进入最小实现 |
+| `curl http://127.0.0.1:8002/` 3 秒无响应 | 1 | PM2 显示服务 online；不重复相同失败，转为检查重启安全条件 |
+| `ccweb_list_conversations(status=running)` 60 秒超时 | 1 | 无法证明当前之外没有其他 running 会话，按仓库约束不重启服务 |

.planning/title-history-locator/findings.md

@@ -0,0 +1,63 @@
+# 标题历史定位时间线：发现记录
+
+## 用户意图
+
+- “定位”弹层当前只列可跳转的消息步骤。
+- 左侧会话标题由 LLM 通过标题 MCP 修改；每次实际修改都要保留历史。
+- 定位弹层需要插入标题变更节点，用于标识主题变化发生的位置。
+- 标题节点只读、不能选中或触发滚动定位，但需要在视觉上明显区别于消息项。
+- 定位弹层还要按消息时间显示日期分隔节点，参考横线中间承载日期的气泡样式。
+- 日期仅显示到天（`YYYY-MM-DD`），不显示截图示例中的时分秒；日期节点同样不可点击、不编号。
+- 计划审查确认日期时区必须明确：采用浏览器当前用户本地时区，与消息时间的前端展示语义保持一致。
+- 日期视觉明确为两侧横线、中间承载 `YYYY-MM-DD` 的气泡；测试覆盖本地 23:59/00:01 边界。
+
+## 工作区与流程约束
+
+- 当前 Trellis 指向另一个仍在进行的主题任务，不能擅自切换或覆盖。
+- 根目录已有旧的 `task_plan.md`、`findings.md`、`progress.md`，因此本任务使用 `.planning/title-history-locator/` 隔离。
+- 根目录已有他人未跟踪的 `修复会话切换表单不渲染 TO DO list.csv`，必须保留。
+- 项目约定：代码理解先用 `codebase-memory-mcp`，`rg/sed` 仅做行号与文本校验；禁止使用 graphify。
+- `codebase-memory-mcp` 的 `home-cc-web` 索引状态为 `ready`（4093 nodes / 8699 edges）。
+- Trellis 前后端规范入口及相关组件/数据库规范仍是占位模板，没有额外的项目专属实现约束。
+
+## 待确认的技术事实
+
+- `ccweb_set_title` 的后端实现、标题锁定与会话持久化结构。
+- “定位”按钮和弹层的前端构建函数、消息序号、消息时间和点击逻辑。
+- 会话详情接口是否已有适合承载时间线元数据的字段。
+- 现有回归脚本中标题 MCP 与定位列表相关 target。
+
+## 已定位的实现链路
+
+### 标题 MCP
+
+- 入口是 `server.js` 的 `callInternalMcpTool()`，`ccweb_set_title` 路由到 `setCurrentConversationTitle()`。
+- `setCurrentConversationTitle()` 会加载会话、拒绝空标题、尊重 `titleSource === 'manual'` 锁定，并在实际处理后保存 `session.title/titleSource`、发送 `session_renamed`、广播列表。
+- 当前成功路径即使标题未变化也会保存并广播；历史事件必须只在 `changed === true` 时追加，避免重复标题伪事件。
+- 手动 UI 改名走 `handleRenameSession()`，写入 `titleSource = 'manual'`；本需求只要求记录 LLM 调用实际生效的标题，因此不把手动改名写入该事件历史。
+- 现有集成回归已经覆盖 MCP 成功、空标题、手动锁定和 `updated` 排序时间不变，适合直接扩展标题历史断言。
+
+### 定位弹层
+
+- `public/app.js` 的 `buildUserOutlineItems()` 当前从已渲染的 `.msg.user[data-message-id]` DOM 构建纯用户消息数组，通过 `userMessageIndex` 取完整内容。
+- `updateUserOutlinePanel()` 当前把所有项渲染成可点击 `<button class="user-outline-item">`，并以数组位置生成 1-based 编号。
+- 新实现需要把数据模型扩展为 `message/title/date` 三种 item；只有 `message` 渲染成按钮并计数，`title/date` 使用非交互 DOM。
+- 标题事件需要带能与对话顺序合并的锚点；仅有时间戳在同毫秒或历史回放时不够稳，宜在后端记录 `messageIndex`（标题调用发生时已有消息数量）并以时间戳作为辅助信息。
+- 日期可直接来自用户消息索引中的原始 `timestamp`，按浏览器本地年月日格式化；不需要后端新增日期字段。
+
+### 会话传输与视觉复用
+
+- 会话由 `normalizeSession()` 统一归一化、`sanitizeSessionForPersist()` 自动保留受限的顶层字段；新增标题历史需要在 `normalizeSession()` 做类型/长度清洗，避免旧文件或异常数据直接进入前端。
+- `handleLoadSession()` 的 `session_info` 当前显式列出返回字段，因此必须显式附带标题历史；前端 `normalizeSessionSnapshot()` 也要克隆该字段，才能进入 session cache。
+- 实时 `session_renamed` 事件目前只同步当前标题元数据；应同时携带本次标题事件，前端追加到当前/缓存 snapshot 并立即刷新已打开的定位弹层。
+- 每个消息 DOM 已由 `markSessionMessageElement()` 标注全局 session message index，可用于标题事件与用户消息的稳定顺序合并；分批加载旧历史后 `updateUserOutlinePanel()` 会重建列表。
+- 项目已有 `.agent-message-divider` 的“两侧横线 + 中间等宽时间”视觉，日期项可复用其构图语言，但使用定位弹层专属类，且不受“隐藏代理分隔时间”偏好影响。
+- 点击委托只匹配 `.user-outline-item`，因此标题/日期节点只要不使用该 class 和 `<button>`，天然不会触发定位；仍需回归锁定这一契约。
+- 现有 `assertSetTitleMcpContract()` 适合增加静态/纯函数契约，集成主流程可断言标题历史只在 changed 时追加、锁定时不追加、session_info 可恢复。
+
+### 并行后端审计结论与取舍
+
+- 独立审计确认顶层 `titleHistory` 是最小、兼容性最好的持久化位置；不应塞进 `messages`，也不应改造 `titleSource` 的手动锁语义。
+- 通用持久化 sanitizer 会保留顶层数组，但可能按通用上限从头截断，因此历史 helper 必须主动只保留最近 100 条。
+- 审计建议扩展记录 manual/system/derived、unchanged 和 ignored 尝试；本任务不采纳。用户要看的是“标题在哪一步变了”，因此只写入 `ccweb_set_title` 且 `changed === true` 的实际 LLM 标题变化，避免假主题节点与范围膨胀。
+- MCP 标题历史写入不得修改 `session.updated`，继续保持现有“改标题不改变会话排序”的契约。

.planning/title-history-locator/progress.md

@@ -0,0 +1,31 @@
+# 标题历史定位时间线：进度
+
+## 2026-07-27
+
+- 已读取 `planning-with-files` 与 `todo-list-csv` 技能全文。
+- 已运行 session catchup；未发现需要接管的未同步计划。
+- 已检查 Trellis 工作流、当前任务与工作区状态；为避免干扰并行工作，采用独立 scoped planning 目录。
+- 已确认用户给出的核心交互：标题历史进入定位列表，但标题项不可点击。
+- 用户补充日期时间线：按天显示横线气泡，只显示日期，不显示时分秒；同样为只读节点。
+- 第一次独立计划审查要求明确时区、横线气泡形态与跨天边界；已按“浏览器用户本地时区 + 本地 23:59/00:01 回归”修订。
+- `home-cc-web` 代码索引已确认 ready；Trellis 相关规范目前未提供额外项目约束。
+- 第二次独立计划审查已通过；阶段 1 完成，进入前后端链路定位。
+- codebase-memory 已定位 `setCurrentConversationTitle()`、`handleRenameSession()`、`buildUserOutlineItems()`、`updateUserOutlinePanel()` 及现有 `assertSetTitleMcpContract()` 回归入口。
+- 初步数据设计：会话新增标题事件数组；事件包含标题、时间戳和调用时消息索引，前端与用户消息按索引合并；日期从用户消息时间派生。
+- 已确认 session_info、snapshot cache、实时 session_renamed 和分批历史渲染都需要同步标题历史；定位节点可复用既有 agent divider 的横线视觉。
+- 阶段 2 完成：确定使用 `titleHistory[{ title, changedAt, messageIndex }]`；`messageIndex` 表示事件发生前已持久化的消息数量，时间戳负责日期与异常回退。
+- 进入阶段 3：先补纯函数、静态契约与 MCP 集成失败回归，再写实现。
+- 并行后端审计完成并与本地结论一致；明确拒绝把未生效/手动/系统标题写入本次定位时间线。
+- 已新增 `title-history-outline` 专项回归和全量集成断言；首次运行在缺少 `normalizeTitleHistory` 处按预期失败（exit 1）。
+- 阶段 3 完成，进入后端标题事件持久化与 session_info/实时事件传输实现。
+- 后端已实现事件清洗、最近 100 条裁剪、仅 changed 追加、session_info 恢复与实时 `titleEvent` 推送；专项回归已越过后端断言并按预期停在缺少前端 helper。
+- 阶段 4 完成，进入定位列表标题/日期时间线与样式实现。
+- 前端已实现浏览器本地日期格式化、消息/标题稳定合并、只读 DOM、横线日期气泡、实时事件刷新与 snapshot cache 恢复。
+- `node --check`（server/app/regression）和 `title-history-outline` 专项回归通过；阶段 5 完成，进入全量集成验证。
+- 全量 `npm run regression` 通过并输出 `Regression checks passed.`；再次运行语法检查与 `git diff --check` 均为 exit 0。
+- 运行会话 MCP 查询超时；本机降级检查发现除当前 `91b7...` 外，另有 `745d...` 会话于 15:38 收到用户消息且常驻服务高负载，无法证明无其他 running 会话，因此未重启 ccweb。
+- codebase-memory 变更影响检测 transport closed；此前函数级检索结果和本地全量回归有效，已记录但不重复失败调用。
+- 阶段 6 完成，进入最终代码审查与临时跟踪清理。
+- 最终 diff 审查确认：标题/日期输出均转义，只有消息节点使用按钮与 `data-target`；旧会话默认空历史；MCP unchanged/invalid/manual-lock 均不产生伪事件；缓存版本已同步。
+- 最终状态：7 个阶段全部完成；保留 scoped planning 记录，删除本任务 TODO CSV。服务重启因另一条活跃会话被明确暂缓。
+- 下一步：审查计划，并通过 codebase-memory 定位前后端链路。

.planning/title-history-locator/task_plan.md

@@ -0,0 +1,36 @@
+# 标题历史定位时间线
+
+## 目标
+
+当 LLM 通过 `ccweb_set_title` 修改会话标题时，持久化标题变更事件，并在“定位”列表中按对话顺序显示不可点击的标题分隔项；同时按消息时间插入精确到天的日期分隔项，让用户看出主题在哪一步变化以及对话发生在哪一天。
+
+## 阶段
+
+| 阶段 | 状态 | 验收标准 |
+|---|---|---|
+| 1. 建立计划并确认需求边界 | complete | 计划、发现、进度和 TODO CSV 已建立，且不覆盖现有任务文件 |
+| 2. 定位标题 MCP、消息存储与定位弹层链路 | complete | 找到精确入口、数据流、现有测试和兼容边界 |
+| 3. 补充标题历史及日期定位展示回归 | complete | 新断言覆盖持久化、接口返回、只读展示、历史兼容及浏览器本地 23:59/00:01 跨天边界 |
+| 4. 实现标题变更事件持久化与读取 | complete | 成功改名时写入事件，忽略/失败不写，旧数据可读取 |
+| 5. 实现定位列表标题与日期时间线展示 | complete | 标题项按步骤排序；日期按天去重并呈现横线中置日期气泡；两类节点均不可点击 |
+| 6. 运行专项与全量验证 | complete | 语法、专项回归、全量回归和 diff 检查通过 |
+| 7. 审查改动并清理临时跟踪文件 | complete | 代码审查通过，TODO CSV 删除，计划与进度收口 |
+
+## 关键约束
+
+- 只记录由标题 MCP 实际生效的变更；用户手动锁定导致的 ignored 不产生伪历史。
+- 标题历史是时间线元数据，不伪装成普通对话消息，不参与消息定位选中。
+- 日期节点只显示 `YYYY-MM-DD`，按浏览器当前用户本地时区分组，与现有消息时间的前端展示语义一致，不显示时分秒。
+- 日期节点采用两侧横线、中间日期气泡的分隔样式；本地时间从 23:59 跨到 00:01 时必须产生新日期节点。
+- 兼容已有会话数据；历史中没有标题事件时维持当前行为。
+- 不覆盖工作区内与本任务无关的未提交文件和规划状态。
+- 测试命令最长 60 秒；未确认无其他 running 会话前不重启服务。
+
+## 错误记录
+
+| 错误 | 尝试 | 处理 |
+|---|---|---|
+| 标题历史专项回归因缺少 `normalizeTitleHistory` 失败 | 1 | 失败符合 TDD 预期，进入最小后端实现 |
+| 后端实现后专项回归因缺少前端 `normalizeOutlineTitleHistory` 失败 | 1 | 后端纯函数契约已通过，进入前端实现 |
+| `ccweb_list_conversations(status=running)` 60 秒超时 | 1 | 降级检查 PM2、端口、近期会话文件；发现另一条 15:38 收到用户消息的 Codex App 会话，按约束暂缓重启 |
+| `codebase-memory-mcp detect_changes` 返回 transport closed | 1 | 不重复同一失败，使用已完成的函数级检索、全量回归与本地 diff 审查收口 |