fix(ci): improve AI code review workflow - fix bugs

[watney1024]

• 二进制文件现在能被正确检测并跳过
• API 请求中换行符正确（不再是 literal \n）
• 多文件审查时限流正确生效
• curl 具有超时和重试机制
• 多行 bash 字符串不再导致 YAML 解析失败

[github-actions]

🤖 AI Code Review

共审查 60 个变更文件

📁 .github/workflows/ai-code-review.yml

🔴 逻辑错误：空 diff 时生成整个文件内容 — 第 75-88 行：当 DIFF 为空时（文件未变更），代码会生成虚拟 diff 并将整个文件内容发送给 AI。这会导致大量 token 浪费，且可能暴露敏感信息。应直接 continue 跳过未变更的文件。

🟡 API Key 长度检查过短 — 第 50 行："${#SENSENOVA_API_KEY}" -lt 8 允许像 1234567 这样的弱密钥。建议将最小长度设为 32 或更多，以符合常见 API 密钥长度要求。

💭 file 命令兼容性 — 第 77 行：依赖 file -b --mime-encoding 判断二进制文件，但该命令在部分 Runner 环境中可能缺失。可考虑使用 git diff --numstat 或 git check-attr 等更可靠的方式。

---

📁 .github/workflows/ci.yml

🔴 重复代码导致维护风险 — 两个 job 中完全相同的 20+ 行同步脚本被重复定义。任何修改都需要同步两处，易遗漏。
Suggestion: 提取为可复用的 composite action 或 job 模板，如 local-sync/action.yml。

🟡 retry 函数硬编码 --depth=1 — 第 9 行 "$@" --depth=1 会强制给所有命令附加 --depth=1，但 git fetch 本身已支持 --depth=1，而 retry 调用时未显式传递该参数，导致实际执行 git fetch origin main --depth=1 两次 --depth=1（一次来自函数，一次来自命令）。Git 虽能容忍，但语义不清。
Suggestion: 移除 retry 函数中的 --depth=1，改为由调用方控制，或统一风格。

🟡 retry 函数中 shift 后未保护 $@ 的引号 — 第 9 行 if "$@" ... 在 shift 后正确，但 echo "::warning::$desc failed, retry #$i ..." 中 $i 和 $desc 均未引号包围，若包含空格会截断。
Suggestion: 使用双引号包裹，如 echo "::warning::$desc failed, retry #$i in $((i*3))s" 但 $i 本身无空格问题，更关键的是 $desc 可能含空格，应改为 echo "::warning::${desc} failed, retry #${i} in $((i*3))s"。

💭 “refs/pull/${PR_NUMBER}/merge” 可能不存在 — 对于某些事件（如 workflow_dispatch 手动触发），GITHUB_EVENT_NAME 可能非 pull_request，但即便如此，refs/pull/ 格式仅适用于 PR 事件。当前逻辑正确，但可考虑提前验证 GITHUB_REF 格式，避免静默错误。
Suggestion: 可添加守卫 if [ -z "$PR_NUMBER" ] || [ "$PR_NUMBER" = "$GITHUB_REF" ]; then ... 或使用更可靠的 github.event.pull_request.number 上下文（但 shell 中已用 GITHUB_REF 解析，可以接受）。

💭 echo "::error::GITHUB_SHA ($GITHUB_SHA) not found in local repo — checkout failed" 中破折号使用全角 — — 在 GitHub Actions 日志中可能显示异常，建议改为 ASCII 连字符 -- 或 -。

🟡 缺少对 git fetch origin 失败时的详细错误日志 — 当前 retry 在三次失败后仅输出 ::error::，但未输出 git fetch 的 stderr 内容，排查问题不便。
Suggestion: 在 retry 函数中捕获 stderr 并作为 ::error:: 输出，或至少保留子命令的原始错误输出。

---

📁 .omo/boulder.json

🔴 Potential data loss: Deletion of .omo/boulder.json — This file contains active work tracking state (active_work_id, session IDs, status). Removing it without migrating the state could drop ongoing session info and break the tool’s ability to resume work. If the deletion is intentional, verify that no other process or user depends on this file. If not, consider keeping the file or migrating the state before deleting.

---

📁 .omo/drafts/sync-zmz-debug-workflow.md

🔴 Missing fetch step in Git sync scope — The plan says git reset --hard origin/main, but origin/main may not exist locally or be stale. Without git fetch origin main (or origin/+refs/heads/main:refs/remotes/origin/main), the reset will fail.
Suggestion: Add git fetch origin main before the reset in both the Approach and Scope IN.

🟡 Inconsistent branch creation description — Approach says “reset zmz_dev to match origin/main” but Findings note local zmz_dev does NOT exist. Scope IN correctly adds “Create local zmz_dev tracking branch”, but the Approach and Decisions (D1) don’t mention this prerequisite.
Suggestion: Update Approach to explicitly say “Create local zmz_dev tracking branch then reset to origin/main”.

🟡 Unclear test trigger branch — Scope IN test step says “trigger workflow_dispatch on GitHub” but doesn’t specify which branch. If triggered from main, the workflow will use BASE_REF=main (already stale concern). If from zmz_dev, the fixes are there.
Suggestion: Clarify that workflow_dispatch should be triggered on the zmz_dev branch after push.

💭 Missing line numbers in some findings — Issues 2, 4 list observations without line numbers (e.g., “Non-standard API endpoint”). For reproducibility, all findings should cite the exact line.
Suggestion: Add line numbers for issue 2 (likely ai-code-review.yml lines 89-93) and issue 4 (lines 169-173).

💭 Unclear why merge/rebase was bypassed — “Open assumptions” says “Default merge vs rebase question was bypassed by user's explicit choice of reset”. This is fine, but the rationale for why reset is preferred over a merge (which would keep the unique commit) is not explained.
Suggestion: Add a brief note in Decisions to justify discarding the 1 unique commit (e.g., “it’s a documentation-only commit unrelated to the workflow”).

---

📁 .omo/drafts/toy-cfg-peephole.md

🟡 确认引用：删除此 draft 文件可能导致链接失效，请确认 pending-action 指向的 .omo/plans/toy-cfg-peephole.md 已就位，且其他文档中没有对该 draft 的直接引用。若已确认，则删除合理。

---

📁 .omo/plans/fix-ci-sync-visibility.md

🟡 硬编码路径风险 — 脚本中 MIRROR=/opt/ScratchV 和 WORKSPACE=/opt/actions-runner/_work/README.md 是具体路径，依赖 runner 环境固定。若 runner 路径变更或迁移，脚本会静默失败。建议使用 GITHUB_WORKSPACE 环境变量替代 WORKSPACE，或通过 git rev-parse --show-toplevel 动态获取仓库根目录。

🟡 rm -rf 安全风险 — rm -rf "$WORKSPACE" 前未检查 $WORKSPACE 是否为空或指向预期目录。若因环境变量未设置导致 $WORKSPACE 为空，将删除根目录 /，造成灾难性数据丢失。建议添加守卫：[ -n "$WORKSPACE" ] && [ -d "$WORKSPACE" ] || exit 1 或使用 rm -rf "${WORKSPACE:?}" 确保非空。

🟡 fallback 无错误处理 — git checkout -f origin/main 假设 origin/main 总存在，但若 git fetch 失败（网络问题）且本地 mirror 没有该引用，则 checkout 也会失败，导致后续步骤在错误状态工作。建议在 git checkout -f origin/main 失败时打印 ::error:: 并 exit 1 明确中止 CI，而非静默继续。

💭 计划文档中示例不完整 — 文档提到“两处（test job + benchmark job）”，但 diff 只展示了一个示例代码块。建议在 After 部分明确标注两处修改的对应行号（如 L34-35 和 L82-83），或直接复制两份示例，避免混淆。

💭 ::notice:: 格式兼容性 — 示例中 echo "::notice::Checkout successful: ..." 的 ::notice:: 后紧跟空格，GitHub Actions 命令解析器可能将其视为无 title 的 notice，但更规范的写法是 echo "::notice title=Checkout successful::$(git log -1 --format='%h %ai %s')" 以利用结构化日志。建议确认预期行为并调整，避免日志解析异常。

---

📁 .omo/plans/sync-zmz-debug-workflow.md

🔴 Contradiction: Automation vs manual intervention — The plan states "Zero human intervention - all verification is agent-executed" (Verification strategy) but contradicts itself in Todo 8 ("If gh CLI not available, print instructions for manual trigger") and F3 ("Real manual QA — check the workflow run logs manually"). This undermines the core automation guarantee. Either remove the automation claim or replace manual steps with agent-executable alternatives (e.g., using curl to trigger and poll the GitHub API).

🟡 Inconsistent description in Todo 8 — The line "FIXED: Chinese filename handling, --retry-all-errors, rate-limit delay, enhanced error logging." appears as a stray note in the middle of the todo. It's unclear whether these are additional changes already applied or pending. Remove or move to a separate section to avoid confusion.

🟡 Ambiguous trigger method — Todo 8 says "Use GitHub API to trigger workflow_dispatch" but earlier notes "gh CLI unavailable in local env. Manual trigger required." The plan should provide a concrete, agent-executable command (e.g., curl -X POST -H "Authorization: Bearer $GITHUB_TOKEN" ...) or clearly state that manual trigger is acceptable and how to verify the run afterwards.

💭 Redundant TL;DR sections — The human TL;DR and the machine TL;DR convey essentially the same information. Consider keeping only one, or clearly differentiate their purpose (e.g., machine version for automated parsing).

---

📁 .omo/plans/toy-cfg-peephole.md

🔴 删除未完成的计划文档 — 此文件包含多个处于 [ ] 状态的任务（如 Todo 8, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 以及 F1-F4），且对应 Wave 2~6 尚未完成。删除将永久丢失：任务依赖关系、验收标准、QA 场景、提交策略等关键设计上下文。建议：保留文件直至所有任务完成，或将其移至归档目录（如 docs/archive/）并添加指向已完成状态的可追溯链接。

---

📁 .omo/run-continuation/ses_068151cb9ffea4BFhBqXkKo7Hq.json

💭 文件末尾缺少换行符。许多工具（如 git diff、POSIX 定义）和 linter 要求文本文件以换行符结尾，建议添加。

---

📁 .omo/run-continuation/ses_06816e2c6ffefb4mkD05s96F4z.json

💭 文件末尾缺少换行符 — 建议在文件最后添加一个换行符，以符合 POSIX 标准和减少 diff 噪声。

---

📁 .omo/run-continuation/ses_068463410ffe5ivGcndKWzPF8g.json

💭 Missing trailing newline — 文件末尾缺少换行符，这可能导致某些工具（如 cat、git diff）行为不一致。建议添加一个换行符。

🟡 状态值可能应为枚举 — "state": "idle" 是字符串，但没有定义可接受的值集合。如果将来扩展（如 "running", "failed"），建议通过类型定义或文档明确枚举值，避免拼写错误或歧义。

🟡 重复的 updatedAt 字段 — 根对象和 sources.background-task 都包含 updatedAt，且时间相同。如果它们是独立更新的，则当前设计可能暗示它们总是同步，但实际可能会不同步。建议明确语义：是共享更新时间戳，还是各自独立？若独立，则根对象的 updatedAt 可能冗余。

💭 字段命名风格 — sessionID 使用驼峰，而 updatedAt 也是驼峰，但 JSON 中常见的是全小写（如 session_id、updated_at）。如果项目已有约定，建议保持一致；若无，则当前风格也可接受，但最好统一团队规范。

---

📁 .omo/run-continuation/ses_068b28a4fffen3fN49J9FxFNQ4.json

💭 Missing trailing newline — The file ends without a newline. Many tools expect a final newline at the end of text files; consider adding it to avoid potential issues with diff tools or linters.

---

📁 .omo/run-continuation/ses_068b4139bffeVghNnZQ10hvwEA.json

💭 Nit: Missing trailing newline — File ends without a newline. While not strictly required for JSON, many tools and linters prefer a final newline for consistency.

---

📁 .omo/run-continuation/ses_068b46067ffeHibbuaYLpI52w6.json

💭 Missing trailing newline — File ends without a newline. While not a functional issue, many tools (POSIX, linters, git diff) expect a trailing newline. Consider adding one for consistency.

---

📁 .omo/run-continuation/ses_06b63b966ffe3OS8VROMt9yn3u.json

💭 Missing trailing newline — File ends without newline; standard practice is to include one for POSIX compatibility and cleaner diffs.

---

📁 .omo/run-continuation/ses_06b643018ffe6ij7Kl5Lj2FdVl.json

💭 Missing newline at end of file — 最后一行缺少换行符，建议添加以符合 POSIX 标准，并避免 cat 等工具输出异常。

---

📁 .omo/run-continuation/ses_06b726330ffeftGTnmmyd5wfJ9.json

💭 Missing trailing newline — JSON file should end with a newline for POSIX compliance and to avoid diff noise. Add a newline at end of file.

💭 Future timestamp — updatedAt is set to 2026-07-24. If this is intentional (e.g., test data), leave as is; otherwise, ensure it reflects the actual current time to avoid confusion.

---

📁 .omo/run-continuation/ses_06b77709affeBwCYr9IsosB7jN.json

No issues found.

---

📁 .omo/run-continuation/ses_06b7a576fffe77XtHhQhMQTWfD.json

💭 Nit: Missing trailing newline — File ends without a newline. While JSON parsers generally accept this, adding a trailing newline is standard POSIX practice and prevents diff noise in future changes.

---

📁 .omo/run-continuation/ses_06b7bf0b8ffex0J6JGA0Ma4XfF.json

💭 Missing trailing newline — The file ends without a newline at EOF. While not strictly required, many tools (e.g., linters, POSIX utilities) expect one. Consider adding \n.

---

📁 .omo/run-continuation/ses_06b7bf94cffeqNmY4pTI24UAWk.json

🔴 潜在安全风险：会话ID硬编码在文件名和JSON中 — 如果此文件被提交到公共仓库，sessionID ses_06b7bf94cffeqNmY4pTI24UAWk 可能被泄露，导致会话劫持或信息泄露。建议：将 .omo 目录加入 .gitignore，或确保文件中不包含敏感标识符。

🟡 缺少文件末尾换行符 — 文件最后一行没有换行符，不符合POSIX标准，可能导致某些工具（如diff、git）产生额外警告。建议：在末尾添加换行符。

💭 冗余的 updatedAt 字段 — 顶层 updatedAt 与内部 background-task.updatedAt 值完全相同。如果设计上两者独立，则无问题；否则可考虑移除其中一个，减少冗余。

---

📁 .omo/run-continuation/ses_06b7c4623ffe1x2Ps1vTewaFjD.json

💭 Nit: 文件末尾缺少换行符 — 建议在JSON文件末尾添加一个换行符，以符合POSIX标准并避免某些工具（如git diff）的警告。

---

📁 .omo/run-continuation/ses_08c6b4018ffeMDShzHstIgcgT5.json

🟡 潜在的状态丢失风险 — 删除 .omo/run-continuation/ses_...json 文件会丢失 background-task 的 idle 状态记录。如果该 session 仍被其他进程引用（如日志、监控或恢复逻辑），删除后可能导致状态不一致或无法跟踪。建议：先确认该 session 已完全结束且不再需要，或改用数据库持久化 session 状态。

---

📁 .omo/run-continuation/ses_08c6d78b1ffe5kmhdcnlSdCrLf.json

💭 确认删除意图 — 该文件是 .omo/run-continuation/ 下的会话状态 JSON，删除后需确保没有其他组件（如后台任务调度器或监控脚本）依赖该文件来追踪会话状态。如果删除是计划内的清理，则无影响；否则可能造成状态丢失或引用异常。

---

📁 .omo/run-continuation/ses_08c6d882cffeGJatP9qo8Oa7eZ.json

🔴 Missing Context — Deleting a session state file without confirmation that the session is no longer active. If this file is still referenced by another process (e.g., a background task manager), the system may lose state or crash.
🟡 Verify Dependencies — Ensure no other code reads or depends on this exact file path. If the session is still in use, the deletion is a data loss risk.
💭 Commit Message — The commit message (not shown) should explain why this session is being cleaned up (e.g., completed, expired, or manual prune).

---

📁 .omo/run-continuation/ses_08c6fae74ffe16ZuEyb5sjFJQb.json

🔴 Data Loss Risk — Deleting a session continuation file (.omo/run-continuation/ses_…) will permanently remove the session state, including any pending or idle background tasks. If this session is still in use, this will break ongoing operations.
Suggestion: Ensure the session is no longer active (e.g., check if the task has completed or the session was explicitly closed) before deleting. Consider archiving instead of immediate deletion.

---

📁 .omo/run-continuation/ses_08c71867cffeosnHoAnDJYGCeK.json

🔴 数据丢失风险 — 删除 .omo/run-continuation/ses_08c71867cffeosnHoAnDJYGCeK.json 可能导致对应会话（ses_08c71867cffeosnHoAnDJYGCeK）的持久化状态丢失。如果该会话正在被其他进程或后续操作引用，删除将引发未定义行为或状态不一致。
建议：

• 确认该会话已完全结束且不再需要其状态。
• 若非计划内清理，考虑保留或以标记方式归档（如重命名至 .trash 目录），而非直接删除。
• 若确有移除理由，在提交信息中说明删除原因（如“清理已完成会话状态”）。

---

📁 .omo/run-continuation/ses_08c72acf1ffeSkkKRbhvo0IMtI.json

🟡 潜在数据丢失风险：删除会话文件 ses_08c72acf1ffeSkkKRbhvo0IMtI.json 前未确认该会话是否仍被其他进程或后续操作引用。虽然 state 为 idle，但若存在异步引用或未清理的持有者，删除可能导致状态不一致或运行时错误。建议在删除前添加显式会话关闭/注销逻辑，或确保删除时机与进程生命周期同步。

---

📁 .omo/run-continuation/ses_08c74609cffeMB26R5ui6fBEv6.json

🔴 潜在竞态条件 — 删除 .omo/run-continuation/ses_...json 文件时，若其他进程或线程正在读取该文件（如后台任务检查状态），可能导致文件未找到或状态不一致。建议：在删除前确保对应 session 已不再被引用，或改为写入状态标记（如 "state": "removed"）后再删除，避免瞬时故障。

🔴 缺少事务一致性 — 若该文件与其他持久化存储（如数据库、缓存）同时更新，直接删除可能导致数据不同步。建议：统一通过一个状态管理服务删除 session，确保所有存储原子更新。

🟡 缺失审计日志 — 删除 session 文件通常属于重要操作，当前没有记录删除原因或操作者。建议：在删除前或删除后写入日志，便于追踪问题。

💭 硬删除 vs 软删除 — 考虑保留文件但标记为 "state": "completed" 或 "deleted"，方便后续排查历史状态，避免丢失现场信息。

---

📁 .omo/run-continuation/ses_08c746811ffexAthQgBi6NB6sx.json

🔴 潜在风险：删除可能影响依赖该文件的组件 — 该文件记录 session 状态 (background-task: idle)。如果其他模块（如监控、恢复逻辑）仍会读取或写入此路径，删除后可能导致缺失状态、错误或异常。建议验证删除意图，确认所有引用已移除，或添加迁移/清理逻辑以确保一致性。

---

📁 .omo/run-continuation/ses_08c7844baffe5OfwHFztHSaEml.json

🔴 潜在数据丢失：删除会话状态文件时未确认是否有正在运行的进程引用该 sessionID。若 background-task 尚未完全终止或其它组件依赖此文件，可能引发状态丢失或异常。

🟡 缺少变更说明：提交信息未说明删除原因。应补充理由（如“清理已完成会话的状态文件”），以便追溯。

💭 考虑清理策略：若此为定期清理的一部分，建议实现保留策略（如仅删除状态为 idle 且超过 N 天的文件），避免误删活跃会话。

---

📁 .omo/run-continuation/ses_08c7cc8ccffe8qc3Y5MD6Ez1VR.json

🟡 潜在数据丢失风险 — 直接删除 sessionID 文件，未验证是否有其他进程正在引用该 session 或 background-task 状态。建议在删除前确认 session 已过期或不再活跃，并记录审计日志。

💭 缺少原子性处理 — 文件删除是单步操作，若被中断可能导致部分状态残留。考虑先重命名文件（如加 .bak 后缀），再删除，以支持回滚。

💭 硬编码路径 — 删除特定文件 ses_08c7cc8ccffe8qc3Y5MD6Ez1VR.json，若未来 session 文件名规则变化，此删除将失效。建议通过脚本或配置管理删除操作，避免硬编码。

---

📁 .omo/run-continuation/ses_08c7cdbb8ffeOSONd4knc9m8Yu.json

🟡 建议：确认 session 不再活跃并考虑忽略整个目录
删除单个 JSON 文件本身没有技术错误，但 .omo/ 目录似乎是内部运行状态存储，容易产生大量类似文件。建议：

1. 确认该 ses_... 对应的后台任务已完全终止，避免删除后工具报错或丢失状态。
2. 将 .omo/ 添加到 .gitignore，防止未来再次提交运行缓存，减少版本库噪音。

---

📁 .omo/run-continuation/ses_08c7f3293ffez6RdMahIo33Qx6.json

🔴 Data Loss Risk — Deleting this session state file will cause the system to lose track of ses_08c7f3293ffez6RdMahIo33Qx6's background-task state. If the session is still active or expected to resume, subsequent operations may fail silently or produce unexpected behavior.
Suggestion: Ensure the session is properly terminated (or the file is intentionally stale) before deletion, or add a migration/handler to gracefully clean up orphaned state.

🟡 Missing Validation — There's no check to confirm this session is no longer referenced by any running process or queue.
Suggestion: Add a safety check (e.g., verify the session is inactive or expired) before removing the file.

---

📁 .omo/run-continuation/ses_08c8360f5ffesamwzXY84CZMYl.json

🟡 潜在数据丢失风险 — 删除.omo/run-continuation/下的session文件前，应确保没有其他进程或任务仍引用该session ID。若该session处于活跃状态，删除可能导致状态丢失或运行时异常。

🟡 缺少清理确认 — 建议在删除前检查该session是否已确实完成或过期，可考虑添加日志记录删除操作以便追踪。若框架支持，也可通过标记“已归档”而非直接删除，保留历史记录。

---

📁 .omo/run-continuation/ses_08ca9f098ffehozxc3kvmbtR2S.json

🟡 建议：确认删除此状态文件的安全性 — 文件 .omo/run-continuation/ses_08ca9f098ffehozxc3kvmbtR2S.json 存储了会话 ses_08ca9f098ffehozxc3kvmbtR2S 的状态，其中 background-task 处于 idle 状态。删除该文件可能导致正在进行的后台任务状态丢失或引发异常，尤其是当其他进程或组件依赖该文件时。如果该会话已安全结束，删除是合理的；否则建议先确保会话已终止。此外，此类运行时状态文件通常应被加入 .gitignore 以避免意外提交到版本控制，本次删除可视为清理历史提交，但应确认后续不会再被跟踪。

---

📁 .omo/run-continuation/ses_08cb3d33bffe7lelYZ64Q356qJ.json

🔴 潜在的数据丢失风险 — 删除此文件会移除一个会话状态，但当前变更未提供任何上下文说明该 session 是否仍在被其他组件引用。如果该 session 尚在活跃使用中，删除可能导致后续恢复或任务调度失败。建议先确认 .omo/run-continuation/ 目录下所有文件的使用关系，确保该 session 已过期或不再需要。

🟡 缺少删除理由 — 变更描述中未说明为何删除该文件（例如会话自然结束、清理临时状态、修复错误等）。没有理由的删除在审查中难以验证正确性，建议在 commit message 或相关 issue 中写明原因。

💭 考虑添加校验逻辑 — 如果这是一个清理脚本产生的删除，建议在删除前检查该 session 对应的外部资源（如后台任务句柄）是否已释放，避免残留引用。

---

📁 .omo/run-continuation/ses_08cb3d4bdffe82Nd9fgl61Lo0d.json

🟡 删除运行时状态文件 — 删除 .omo/run-continuation/ses_...json 会丢失该会话的 background-task 状态记录。如果其他进程或重启后需要读取该文件以恢复状态，则可能导致意外行为或任务中断。请确认：

• 该文件不再被任何代码引用（包括未显示的隐式依赖）。
• 删除前已确保对应的后台任务已安全终止，且状态已持久化到其他位置。
• 删除操作是原子性的，避免并发写入时出现竞态条件（如先删除后又有新写入）。

---

📁 .omo/run-continuation/ses_08cb4a5aeffeaDQDlYvfZLH1Ei.json

🟡 缺少确认 — 删除 ses_08cb4a5aeffeaDQDlYvfZLH1Ei.json 文件，但未提供任何上下文。该文件记录了一个 background-task 的 idle 状态。请确认：

• 没有任何代码（包括其他会话文件或运行时逻辑）读取或依赖此文件内容。
• 删除是预期的清理行为（例如会话已过期或不再需要），而不是意外的文件丢失。
• 如果该文件由工具自动生成且不应纳入版本控制，建议在 .gitignore 中添加规则，避免未来再次误提交。

---

📁 .omo/run-continuation/ses_08cb4b320ffee93l61sZHFIpuO.json

🔴 Data Loss Risk — Deleting this session continuation file (ses_08cb4b320ffee93l61sZHFIpuO.json) could cause loss of background task state if the session is still active or referenced elsewhere. Ensure that:

• No other system component depends on this file’s existence.
• The session is truly finished or being cleaned up via a proper lifecycle mechanism.
• There is a fallback or error handling for any code that might try to read this file.

🟡 Missing Context — The diff lacks surrounding changes (e.g., addition of a cleanup mechanism, timestamp checks, or a migration plan). If this deletion is part of a larger cleanup routine, consider adding a comment in the commit message or code to explain why it's safe to remove.

💭 Trailing Newline — The original file was missing a trailing newline. If this is a recurring pattern, consider configuring your editor or linter to enforce it.

---

📁 .omo/run-continuation/ses_08cb4bbd6ffeNnymikP7SsMPtQ.json

🔴 File deletion may break dependent code — .omo/run-continuation/ses_... appears to be a session state file. If any process reads this path (e.g., to check background-task status), deleting it could cause FileNotFoundError, race conditions, or incorrect state assumptions. Must verify that no other component references this file or that a graceful fallback exists.

🟡 Missing cleanup rationale — The commit message and diff provide no context for the deletion. Consider adding a comment in the commit message or a related code change that explains why this session is safe to remove (e.g., session expired, task completed, or file is no longer used). Without context, the deletion risks data loss.

💭 Consider a migration or deprecation notice — If this file format is being retired, a phased cleanup (e.g., log a warning, then delete after a grace period) would be safer for production systems.

---

📁 .omo/run-continuation/ses_08cb4c73fffelN6IN6tpq0dQ7t.json

🔴 潜在风险：删除可能破坏并发或引用 — 文件 ses_08cb4c73fffelN6IN6tpq0dQ7t.json 被直接删除。如果其他进程或线程正在读取或写入该文件（例如，后台任务仍在读取状态），删除会导致竞态条件或文件不存在错误。建议：确认所有对该文件的操作都已结束，或在删除前加锁/标记为“已删除”而非直接删除。同时检查代码中是否有硬编码路径引用该文件，确保删除后不会引发异常。

---

📁 .omo/run-continuation/ses_08cb4d395ffeeTdfvH9yT8rzKv.json

🟡 Potential Data Loss — Deleting this session file may cause issues if any running process still references ses_08cb4d395ffeeTdfvH9yT8rzKv. Even though state is idle, the file could be used for recovery or cleanup. Confirm no other part of the system depends on this file before deletion.

🟡 Missing Rationale — The diff provides no context for why this file is removed. Include a commit message or comment explaining the reason (e.g., session expired, cleanup completed) to aid future maintainers.

💭 Cleanup Consideration — If this is part of a routine cleanup, consider adding a pattern or automated mechanism (e.g., TTL) to avoid manual deletion of individual session files.

---

📁 .omo/run-continuation/ses_08cb65201ffekiDizQwVA2oAXF.json

🟡 潜在风险：删除运行时状态文件 — 此 JSON 文件可能被其他组件（如后台任务调度器或状态恢复逻辑）依赖。直接删除可能导致运行时读取失败或状态丢失。

建议：

• 确认系统中没有其他代码通过路径 .omo/run-continuation/ses_08cb65201ffekiDizQwVA2oAXF.json 读取此文件。
• 如果该文件是自动生成的临时状态，考虑在删除前确保相关会话已彻底结束，并添加 .gitignore 规则防止未来类似文件被提交。

---

📁 cfg.dot

🟡 未清理引用 — 删除 cfg.dot 前，请确认它没有被其他文件（如文档、测试、构建脚本）引用。若此文件是自动生成的，请确保生成逻辑仍保留且能正常工作。

---

📁 docs/topics/toy-cfg/00-what-is-cfg.md

🔴 断链风险：删除此文件后，所有引用 00-what-is-cfg.md 的链接（如 01-basic-blocks.md 中的“接下来看什么？”一节）将失效。请确认已更新所有相关文档中的链接，或将内容合并到其他文档中。

---

📁 docs/topics/toy-cfg/01-basic-blocks.md

🟡 Missing Update: 删除文档可能破坏引用 — 此文件被删除，但未检查是否有其他文档或代码链接到该文件（例如，目录索引、交叉引用、搜索路径）。请确保所有引用已更新或清理，否则会造成断链。如果该内容已迁移到其他位置，考虑添加重定向或更新索引。

---

📁 docs/topics/toy-cfg/02-visualizing-cfg.md

🟡 文档链接断裂风险 — 此文件被直接删除，但系列中的后续文档（如 03-dominators-and-loops.md）很可能包含指向它的引用（如“接下来看 03 支配树和循环检测”之类的反向链接）。删除后这些链接将变成死链，读者无法回溯前置内容。建议：检查同一目录下所有文档的交叉引用，并更新或删除相关链接；如果内容已合并到其他文档，应提供重定向（如保留一个空文件并注明迁移路径）。

🟡 破坏学习路径 — 该文件是 toy-cfg 系列的一部分，可视化管理论是理解后续支配树、循环检测等概念的基础。直接删除会使整个系列缺少关键一环。建议：确认是否有替代文档（如合并到 01 或 03 中），并在系列索引或 README 中明确说明内容变更。

💭 缺少删除理由 — 提交消息或变更说明中未提供删除原因。如果是因为内容过时或不准确，建议在提交信息中简要说明，方便后续维护者理解。

---

📁 docs/topics/toy-cfg/03-exercises.md

🟡 Suggestion: 删除文档前请确认没有其他文件引用它 — 如果其他文档（如 README、index.md 或邻近的 01-intro.md）有链接指向此文件，删除后会导致死链。建议检查所有文档中的交叉引用，并更新或重定向链接。

💭 Nit: 如果这些练习仍然有价值，考虑将其内容合并到其他文档（如 02-exercises.md） — 删除前应确保内容没有丢失，或者迁移到合适位置。当前变更没有提供替代文档，可能让后续读者丢失这些练习的指导。

---

📁 docs/topics/toy-peephole/02-rules-and-iteration.md

🔴 断链风险 — 该文档被其他文件引用（如教程上一篇或下一篇、索引页），删除后会造成死链接。需全局搜索引用并更新或移除链接。

🟡 删除理由缺失 — 无任何说明为何移除该文件。应在 commit message 或 PR 描述中明确原因（如“内容已迁移至 XX.md”或“系列已废弃”）。

💭 内容价值损失 — 文档解释了窥孔优化原理和固定点迭代，是高质量教学材料。若仅因清理而删除，建议先移至 archive 目录或保留历史快照。

---

📁 docs/topics/toy-peephole/03-exercises.md

🔴 Breaking Change: Missing dependency analysis — Deleting 03-exercises.md removes structured exercises, hints, and self-check tests that are likely referenced from other docs (e.g., README.md, index.md, or previous chapters).
Suggestion: Verify that no hyperlinks or cross-references point to this file. If they do, update them to point to an alternative resource or add a redirect notice.

🟡 Lost educational value — The file contains three well-designed exercises (mul→slli, rem→andi, cost model) with inline test cases and pedagogical hints. Deleting them without an equivalent replacement reduces the learning path for users.
Suggestion: Either keep the file (or move it to an archive/ folder) or provide a migration path (e.g., merge content into a consolidated guide, or mark as deprecated in a changelog).

💭 Missing commit message context — The diff has no commit message or description. A deletion of this size should be justified in the commit message (e.g., "removed outdated exercises moved to separate repo", "replaced by interactive demos").
Suggestion: Add a clear commit message explaining the rationale for removal.

---

📁 tests/test_toy_cfg_phase1.py

🟡 测试覆盖缺失风险 — 删除 tests/test_toy_cfg_phase1.py 导致 415 行测试（10 个测试类、约 20 个测试用例）完全丢失，这些测试覆盖了 CFG 构建、边缘类型、可视化、不可达检测等核心功能。
建议：确认这些测试已迁移到其他文件（如 test_cfg_phase1_refactored.py）或明确标记该模块已废弃。如果未被替代，则不应删除，以免引入回归。

---

📁 tests/test_toy_peephole.py

🔴 删除关键测试文件 — 完整删除 tests/test_toy_peephole.py，该文件覆盖了 6 条 peephole 优化规则及其边界情况（如 addi+addi 融合、li+addi 融合、beq→j 转换、mv swap/chain、addi zero 消除）。若相关规则仍存在于生产代码中，此删除将导致测试覆盖损失，可能引入回归。建议：保留文件或证明规则已不再需要。

🟡 缺少删除理由 — 提交信息未说明删除原因（如“规则已移除”、“测试已迁移到新文件”）。建议：补充 commit message 解释动机，或提供替代测试方案。

---

📁 toy_cfg/__init__.py

🟡 Potential Import Issue — 删除 toy_cfg/__init__.py 会使该目录不再是显式 Python 包。如果 toy_cfg 目录下还有其他 .py 文件，它们将无法通过常规包导入（除非使用隐式命名空间包，但可能不是预期行为）。建议：确认是否计划完全移除该包，或保留空的 __init__.py 以保持包结构。

---

📁 toy_cfg/demo01_build_blocks.py

🔴 潜在破坏性删除 — 删除 demo01_build_blocks.py 后，若其他模块存在 from toy_cfg.demo01_build_blocks import BasicBlock 或 build_blocks 等导入，将引发 ModuleNotFoundError。请搜索所有代码库引用并移除或更新导入。

🟡 缺少迁移说明 — 该文件是 CFG 构建的演示和教学工具。删除后，建议在提交信息中说明理由（如代码已重构至 scratchv 库核心模块），并提供替代使用方式或文档链接，避免用户困惑。

💭 删除可执行脚本 — 该文件末尾有 if __name__ == "__main__" 入口，可能被用于手动测试或 CI 脚本。若仍有类似需求，应确保相应脚本已迁移或更新。

---

📁 toy_cfg/demo02_build_cfg.py

🔴 Breaking change: module deleted without migration — This file exports build_cfg, CFG, validate_cfg, reachable_from, and print_cfg. Any other module importing them (e.g., tests, demos, or downstream code) will crash.
Suggestion: Search for all references across the repo and either update them or keep the file until a replacement is ready.

🟡 Missing motivation in commit message — The diff provides no context for deletion. A commit message or comment explaining why this file is removed (e.g., moved to new_path.py, deprecated, merged into demo03) is essential for future maintainers.

💭 Consider keeping a stub if the functionality is still useful — The code implements a CFG data structure and reachability analysis, which are general-purpose. If it's being removed to avoid clutter, consider extracting it into a shared library module instead of deleting entirely.

---

📁 toy_cfg/demo03_verify_for.py

🟡 测试覆盖率丢失风险 — 此文件是专门验证 FOR/ENDFOR 边缘生成正确性的测试脚本。删除后，若没有其他测试覆盖该逻辑，可能导致回归未被检测。请确认已迁移或添加等效测试。
🟡 潜在引用依赖 — 其他模块（如 CI 脚本、测试运行器）可能通过文件名或路径直接引用此文件。删除后需检查无残留导入或硬编码路径，否则可能造成构建失败。

---

📁 toy_cfg/demo04_visualize.py

🔴 删除会导致导入错误 — 如果其他模块（如 demo05_*.py 或测试文件）通过 from toy_cfg.demo04_visualize import ... 引用了此文件，删除后所有导入将失败。必须检查整个仓库的导入引用，并更新或删除它们。

🟡 缺少删除理由 — 提交信息中未说明删除原因。建议在 commit message 中明确解释：是功能被合并到其他文件（如 demo06_*.py）、不再需要，还是被重构替代。否则后续维护者难以理解。

🟡 依赖的 dot 渲染功能可能被移除 — 如果其他脚本或文档依赖 PNG 渲染或 cfg_to_dot 函数，需要确保替代方案已存在。否则应保留该文件或提供迁移指南。

💭 考虑保留为历史参考 — 如果这是教学系列的一部分，删除前可考虑标记为 deprecated 或添加注释，而不是直接删除，以免破坏学习路径。

---

📁 toy_cfg/demo05_dominators.py

🔴 Breaking Change: Unjustified File Deletion — This file (demo05_dominators.py) is entirely removed without any replacement or migration plan. The module exports compute_dominators, compute_idom, and print_dominators, which are likely used by other parts of the codebase (e.g., tests, CLI scripts, or later analysis passes). Deleting it will break any import or invocation of these functions.

🟡 Suggestion: Verify No Dependencies — Before deleting, confirm that no other module imports from toy_cfg.demo05_dominators and that no tests or scripts rely on the dominator analysis. If the functionality is being moved or refactored, the diff should include the new location or a shim to maintain backward compatibility.

---

📁 toy_peephole/demo02_engine.py

🔴 Missing dependency check — Deleting this file breaks any code that imports toy_peephole.demo02_engine.
Suggestion: Run grep -r "demo02_engine" across the repo to find all imports, tests, or documentation references. If none exist, add a note in the commit message or a README update. If any exist, they must be updated or removed.

🟡 No migration plan — The file contains 6 custom peephole rules and a reusable peephole_pass engine. If the optimizer logic is still needed elsewhere, this deletion will cause feature loss.
Suggestion: Either move the engine and rules to a shared module (e.g., toy_peephole/engine.py) before deleting, or confirm the feature is deliberately discarded.

🟡 Potential test breakage — If there are unit tests for demo02_engine (e.g., test_peephole_engine.py), they will fail.
Suggestion: Check for test files that import or reference this module; delete or update them accordingly.

💭 Commit message clarity — The diff shows only a deletion with no explanation.
Suggestion: Add a commit message body explaining why this file is removed (e.g., "moved rules to engine_v2.py", "abandoned demo", "feature not used").

---