mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-11-19 16:29:42 +01:00
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - The release process promotes a soaked beta to stable and publishes the curated notes as the GitHub Release body > - After the publish, the notes must live at `releases/v<stable-version>.md` on `master`. That path is the canonical location that the website changelog and the next release notes use > - Stable `v2026.1117.0` was published on 2026-11-18 from beta `2026.1110.0-beta.0`, through the candidate branch `candidate/release-2026.1117.0` (the beta source plus three test-only cherry-picks and the notes file) > - Because the notes resolved from the source tree (`notes_mode=source_tree`), the workflow's `canonicalize_stable_notes` job is skipped by design (it runs only for `master_beta`), so no canonicalize branch was pushed > - This pull request does by hand what that job does: it renames the beta notes file on `master` to the stable path. It changes no content > - The benefit is that `releases/v2026.1117.0.md` exists on `master` and is byte-identical to the published GitHub Release body ## Linked Issues or Issue Description Refs #22094 Refs #19770 **Issue type** Missing content **Where is the issue?** `releases/` on `master`. The stable notes for `v2026.1117.0` are only at the beta path `releases/beta/v2026.1110.0-beta.0.md`. The canonical path `releases/v2026.1117.0.md` does not exist on `master`. **What's wrong?** The GitHub Release https://github.com/paperclipai/paperclip/releases/tag/v2026.1117.0 is published. The website changelog sync reads `releases/v2026.1117.0.md` on `master`, so the changelog page for this release cannot appear until this rename is merged. **Suggested fix** Rename the beta notes file to the stable path with no content change, the same step the workflow job performs in `master_beta` mode. ## What Changed - `releases/beta/v2026.1110.0-beta.0.md` is renamed to `releases/v2026.1117.0.md`. Git reports a 100% rename - No line of the file changes. The blob is `dff612e41f915a5a2d9f3e572142e2fee56068a8`, the same blob as `releases/v2026.1117.0.md` at the release source commit `c0f132898d2a2677312d8c72096187b27a3d9a38` (tag `v2026.1117.0`) - This pull request does not change the release workflow ## Verification - `git diff --numstat -M origin/master release-notes/v2026.1117.0-canonicalize` shows one renamed file with 0 insertions and 0 deletions - `git rev-parse release-notes/v2026.1117.0-canonicalize:releases/v2026.1117.0.md` prints `dff612e41f915a5a2d9f3e572142e2fee56068a8` - `git rev-parse v2026.1117.0:releases/v2026.1117.0.md` prints the same blob - The raw `body` field of `gh api repos/paperclipai/paperclip/releases/tags/v2026.1117.0`, compared with `cmp` against the file, reports no difference - After merge, https://github.com/paperclipai/paperclip/blob/master/releases/v2026.1117.0.md should return 200 and the old beta path 404 ## Risks - Low risk: one markdown file moves and no content changes ## Model Used - Claude (Anthropic), model ID `claude-opus-5-5` (Claude Opus 5.5), tool use via Claude Code ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [ ] All Paperclip CI gates are green - [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: devinfoley <139239+devinfoley@users.noreply.github.com> Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>