chore(release): 同步 v0.0.14 至 master —— GRAPH 提交记录按作者日期倒序 + README 概览图#84
Merged
Conversation
…成块致日期列回跳; (#82) - 现象：GRAPH 视图（All 范围）提交记录前段日期正常递减，中段日期回跳到最新（旁支提交被整块挤到末尾），严重不符合「按时间倒序」预期； - 根因：buildLogArgs 取数首参 --topo-order，其「分支成块」语义把不同分支线提交不相邻混排，致从较旧提交分叉但日期较新的旁支提交整块下放；管道各层（engine 解析 / adapter 装配 / webview 渲染）均无二次排序，git 输出序即最终显示序； - 修复：log-query.ts:39 单行 --topo-order → --author-date-order。选 author-date（非 committer date）以与视图日期列 row.authorDate 对齐（单一事实源）；lane 算法仅依赖「子在父之上」不变量，--author-date-order 同样保证，泳道不断裂； - 测试：log-query.test.ts 断言改 --author-date-order + 补「不含 --topo-order」回归护栏；顺带把 startsWith('--author') 改为 startsWith('--author=')，消除与 --author-date-order 的前缀碰撞隐患； - 注释：同步 log-query/graph-types/graph-layout/log-line/log-webview 共 8 处 topo-order 措辞，澄清「不变量真实要求 = 子在父之上」（非「分支成块」）； - 沉淀：CHANGELOG [Unreleased]/Fixed 记录；docs/.agents/issue.md 追加 #14（表因 / 根因 / 处理 / 防范 / 同类影响）； - 验证：pnpm run test:unit（349 全过）/ check-types / lint 全绿；git log 实测 --author-date-order 序列严格单调递减； 🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
- package.json: 版本 0.0.13 → 0.0.14; - CHANGELOG: 新增 [0.0.14] 定版节（Fixed: --topo-order → --author-date-order 修复日期回跳），[Unreleased] 清空; - docs/releases/v0.0.14.md: 新增面向用户 Release Note（GitHub Release 正文单一事实源，发布纪律闸门必需）; - docs/releases/README.md: 版本索引新增 v0.0.14 行; - docs/README.md、docs/.agents/knowledge-map.md: 「最新发布」指针修正为 v0.0.14; - 承载 PR #82（fix(Graph) 取数排序修复）内容; - 验证: pnpm run package（tsc + eslint + esbuild production）全绿; 🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist) Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
合并 v0.0.14 发布产物到 feature/1.x.x（版本 bump + CHANGELOG 定版 + Release Note + 索引指针）。 🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist) Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
- README.md: Features 章节顶部居中插入 media/overview.png 概览图; - media/overview.png: 新增项目功能概览图（3712×2098, 1.3 MiB）; - 顺带: 里程碑表格 Status 列尾部补齐空格以对齐（纯空白重排，零内容变更）; 🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist) Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
ThreeFish-AI
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概述
将
feature/1.x.x同步至master，引入 v0.0.14 正式版（GRAPH 视图提交记录排序修复）及 README Overview 概览图。本 PR 为正式版回流主分支的同步 PR，对应发布产物均已上架：GitHub Release v0.0.14 / Marketplace /.vsix。变更内容
🐛 Fixed — GRAPH 视图提交记录按作者日期倒序（v0.0.14 核心 · #82）
修复 GRAPH 视图「All」范围下提交记录未按时间倒序的问题：列表前段日期正常递减，中段却「回跳」到最新日期——较新的旁支提交被错误地挤到列表底部。
src/engine/log/log-query.ts的buildLogArgs首参--topo-order→--author-date-order（单行改动，GRAPH 取数序即最终显示序，管道各层无二次排序）--topo-order/--author-date-order均满足，非 topo 的「分支成块」特性），覆盖log-query.ts/graph-types.ts/graph-layout.ts/log-line.ts/log-webview.tstests/unit/log-query.test.ts）：断言更新为--author-date-order，补「不含--topo-order」回归护栏；并修正既有--author短前缀断言为--author=精确前缀，消除与本 flag 的前缀碰撞隐患📝 Docs — README Features 概览图
README.mdFeatures 章节顶部新增居中 Overview 截图（media/overview.png）📦 Release — v0.0.14 发布物料
package.json版本0.0.13→0.0.14docs/releases/README.md索引、docs/README.md与docs/.agents/knowledge-map.md的「最新发布」指针根因（摘要）
--topo-order语义为「子在父之上」且额外约束「不同分支线历史不相邻混排」：它把一条分支的提交整块输出后再切下一条。当仓库存在从较旧提交分叉、但提交日期较新的远端旁支（--branches --tags --remotes命中的跟踪分支），这些旁支提交会被整块挤到列表末尾，造成日期列回跳。--author-date-order同样保证 lane 算法依赖的「子在父之上」不变量（git 契约原文 "Show no parents before all of their children are shown"），且按作者日期倒序跨支正确交错，并与视图日期列（row.authorDate）显示键对齐——排序键须与显示键对齐，否则 rebase / cherry-pick 提交（committer date ≠ author date）仍会错位。完整根因与实证数据见 issue #14。验证
tests/unit/log-query.test.ts断言 + 回归护栏通过关联