feat(devex): changelog.d 碎片化——终结 [Unreleased] 单行道冲突税 (#174)

[2233admin]

方案 (issue #174)

CHANGELOG.md 的 [Unreleased] 是所有 PR 的必撞单行道。本 PR 引入 towncrier 式碎片：

1. changelog.d/ — 每 PR 一个碎片（<pr号>.md / <slug>.md），type: feat|fix|docs|... + Keep a Changelog bullet；本 PR 自举碎片 changelog.d/174-changelog-fragments.md。
2. tools/aggregate_changelog.py — release 时把碎片按类型聚合进 CHANGELOG.md 对应版本段并删除碎片；--dry-run 只打印将写入内容；--check-pr 供 CI advisory。
3. CI advisory（ci.yml）— PR 改了 crates/** 或 orchestration/** 但无 changelog.d 碎片 → ::warning::，不阻断。自检 tests/test_aggregate_changelog.py 并入 layout 校验步骤。
4. 文档 — changelog.d/README.md 惯例；docs/public-beta.md 增加 Maintainer release 聚合步骤；docs/repository-layout.md 登记目录与脚本。

存量 [Unreleased] 条目原地保留，不在本 PR 迁移。

验证

环境：CODE_INTEL_HOME=D:/projects/code-intel-pipeline/.claude/worktrees/grok-174-changelog

命令	结果
cargo fmt --check	通过
cargo test -p code-intel --locked	通过（先前完整跑过，exit 0）
python tests/test_aggregate_changelog.py -v	12 passed
legacy/tools/check-hardcoded-paths.ps1	OK (129 files)
python tests/test_repository_layout.py -v	5 passed

python tools/aggregate_changelog.py --version 0.7.0-beta.6 --date 2026-08-04 --dry-run

# dry-run: would write into ## [0.7.0-beta.6] — 2026-08-04

### Added

- **changelog.d 碎片化** (#174)：每 PR 写独立碎片，release 时用 `tools/aggregate_changelog.py` 按类型聚合进 CHANGELOG 版本段并删除碎片；CI 对缺碎片的 crates/orchestration 变更仅 advisory 提示，终结 `[Unreleased]` 单行道连环冲突税。

# fragments that would be deleted after a successful apply:
#   - changelog.d/174-changelog-fragments.md

推分支前其它门禁

从 AGENTS.md / 仓库文档找到并执行了：check-hardcoded-paths.ps1、test_repository_layout.py、session_start（编辑前）。未找到单独的「完整推分支前门禁清单」文档；CI 全量矩阵（self-scan / package / cross-platform）依赖 GitHub Actions，本机未重跑。

Closes #174

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[repowise-bot]

🔒 Repowise is not analyzing this repository

The PR bot is free on public repositories. This one is private, which needs a Pro plan.

See plans · Manage this repository

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 1f7d504d-813c-42a9-97db-1e3271f8106f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Code Intel change risk

Score	Percentile	Level
64/100	73th (vs last 48 commits)	🟡 medium

Top signals

• Diff shape: 7 file(s), +1049/-0 (max file share 0.58)
• Test asymmetry: source changed, tests touched
• Bug-magnet: 16 fix commit(s) in touched files (180d)
• Churn: 44 commit(s) touching these files (90d)

_{revspec: origin/main..HEAD · threshold: percentile >= 90 blocks unless labeled risk-accepted · code-intel change risk}