fix(Graph): GRAPH 视图提交记录按作者日期倒序（--topo-order → --author-date-order）

[ThreeFish-AI]

背景

用户截图反馈：GRAPH 视图（All 范围）的提交记录未按时间倒序排列——前段日期正常递减，中段日期回跳到最新日期。

行	作者日期	说明
1–3	2026-07-05	master / feature/1.x / fix(perceive)
4–10	2026-06-19 → 2026-05-25	多个 Merge 提交，日期正常递减
11–18	2026-07-05	fix-github-security / msgpack / pydantic-settings 等回跳到最新

理应排在最顶部的新提交却落在列表底部，严重不符合「按时间倒序浏览」的预期。

根因

GRAPH 视图唯一的排序机制是 git log 的 --topo-order 参数（src/engine/log/log-query.ts:39），管道各层（engine 解析 / adapter 装配 / webview 渲染）均无任何二次排序——git 输出序即最终显示序。

--topo-order 语义：保证「子在父之上」（拓扑序），但额外约束「不同分支线历史不相邻混排」——它会把一条分支的提交整块输出后再切到另一条。当仓库存在从较旧提交分叉、但提交日期较新的旁支（如 origin/ThreeFish-AI/fix-github-security 等远端跟踪分支），这些旁支提交会被整块挤到列表末尾，造成日期列回跳。

本仓实测复现（git log，前 18 条作者日期）：

--topo-order（修复前/错）:     ...22:11:18, 21:42:40, 21:17:05, 20:32:35, [22:07:16] ← 旁支提交错位到第 15 位
--author-date-order（修复后）: ...22:11:18, [22:07:16], 21:42:40, 21:17:05, 20:32:35  ← 严格单调递减 ✅

修复

核心改动（1 行）：src/engine/log/log-query.ts:39 —— '--topo-order' → '--author-date-order'。

为什么是 --author-date-order

选项	排序键	lane 安全	与显示列一致
--topo-order（修复前）	拓扑序（分支成块）	✅	❌（日期回跳）
--date-order	committer date	✅	⚠️（rebase/cherry-pick 提交仍会与显示列错位）
--author-date-order（采纳）	author date	✅	✅（视图日期列显示的正是 row.authorDate）

• 单一事实源：视图日期列渲染的是 row.authorDate（log-webview.ts:771：fmtDate(row.authorDate)），排序键须与显示键对齐。
• lane 算法安全：通读 graph-layout.ts:32-145，lane 增量算法仅依赖「处理 commit 时其全部在窗口内的子已处理」这一不变量，不依赖 topo-order 的「分支成块」特性。git log --author-date-order 契约原文 "Show no parents before all of their children are shown" 同样保证「子在父之上」，故 lane 不会断裂、泳道不变形。

改动清单

• 功能性（2 处）：
  • src/engine/log/log-query.ts:39 —— 排序 flag 改为 --author-date-order（唯一逻辑改动）
  • tests/unit/log-query.test.ts —— 断言改为 --author-date-order，补「不含 --topo-order」回归护栏；顺带加固既有 --author 前缀断言（startsWith('--author') → startsWith('--author=')），消除与本 flag 的前缀碰撞
• 注释措辞同步（8 处）：log-query.ts / graph-types.ts / graph-layout.ts / log-line.ts / log-webview.ts，澄清「lane 不变量真实要求 = 子在父之上」（非「分支成块」）
• 知识沉淀：CHANGELOG.md [Unreleased]/Fixed 记录；docs/.agents/issue.md 追加 chore(Release): v0.0.1-rc.2 发布 #14（表因 / 根因 / 处理 / 后续防范 / 同类问题影响）

验证

• ✅ pnpm run test:unit：349 全过（34 个测试文件）
• ✅ pnpm run check-types（tsc --noEmit）：clean
• ✅ pnpm run lint（eslint）：clean
• ✅ git log --author-date-order --branches --tags --remotes --format='%aI %s'：作者日期严格单调递减
• ⏳ 待实机回归（建议合并前）：F5 启动 Extension Host，打开多分支仓库，确认 GRAPH 视图日期列无回跳、多分支泳道（lane）渲染正确无断裂、scope 切换 / 增量加载 / author-grep-path 过滤均正常

关联

• Issue 记录：docs/.agents/issue.md #14
• 同源前例：feat(Parity-Batch1): git CLI 通道补齐 cherry-pick/revert/reset/rename/stash-list/ignore/compare/reword #9（同在 log-query.ts 取数参数层——GRAPH 视图多项语义的单一事实源）

🤖 Generated with Claude Code, CodeX, Gemini
Co-Authored-By: Aurelius Huangthreefish.ai@gmail.com