Skip to content

docs: backfill CHANGELOG.md through 3.8.6 - #740

Merged
itsbkm merged 1 commit into
mainfrom
docs/backfill-changelog-3.8.6
Sep 13, 2026
Merged

itsbkm merged 1 commit into
mainfrom
docs/backfill-changelog-3.8.6

Conversation

@itsbkm

@itsbkm itsbkm commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

Summary

  • CHANGELOG.md was last regenerated at 3.7.2; backfills the missing 3.7.5–3.8.6 entries via git-cliff for that exact range.
  • This is what broke the Mac App Store publish lane (scripts/mas-release-notes.sh reads this file and found no 3.8.6 entry).

Why

A full git-cliff regeneration would have expanded this file to the project's entire uncurated history (1.1.0 onward), which isn't what's checked in today (it's a curated, recent-releases file). Used the explicit 3.7.2..3.8.6 range instead, then restored the blank-line separator between entries that a multi-version --prepend in one pass doesn't add on its own.

Test plan

  • Diffed old vs new content from ## [3.7.2] onward — byte-identical, nothing lost
  • git diff --check — clean
  • Re-run the MAS publish workflow for 3.8.6 and confirm it passes "Prepare Mac App Store release notes"

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Added configurable business-day cutoff times.
    • Added support for refunds on completed orders and clearer refund failure reasons.
    • Added addon selection for tableside ordering.
    • Added counted-cash day closing with numbered Z reports.
    • Added thermal receipt raster layouts and floor rename/delete controls.
    • Added WhatsApp session recovery.
  • Bug Fixes

    • Improved dashboard, POS, login-screen support menu, and release-pipeline reliability.
    • Improved handling of local-network usage declarations.
  • Documentation

    • Added six release entries covering versions 3.7.5 through 3.8.6.

CHANGELOG.md was last regenerated at 3.7.2; six releases (3.7.5 through
3.8.6) were never backfilled, which broke the Mac App Store publish
lane — it reads release notes from this file via changelog-notes.sh and
found nothing for 3.8.6, failing the build.

Generated via git-cliff for the exact missing range (3.7.2..3.8.6) rather
than a full regeneration, which would have expanded this file back to
its full, uncurated project history (1.1.0 onward) instead of the
curated recent-releases-only content it already carries. Also restores
the blank line between entries that a multi-version --prepend in one
pass doesn't insert on its own (this script is normally run once per
release, where the existing content already supplies that separator).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Sep 13, 2026

Copy link
Copy Markdown

Review Change StackReview Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: f1a528ac-290b-4edf-a1e1-84b5595cf050

📥 Commits

Reviewing files that changed from the base of the PR and between 6d0b253 and d85df4a.

📒 Files selected for processing (1)
  • CHANGELOG.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The changelog adds six release entries dated from 2026-09-09 through 2026-09-13. The entries document additions, changes, fixes, test coverage, security updates, UI changes, operational workflows, and release-pipeline behavior.

Changes

Release history updates

Layer / File(s) Summary
Six release entries
CHANGELOG.md
Adds release notes for versions 3.8.6, 3.8.5, 3.8.1, 3.8.0, 3.7.6, and 3.7.5. The entries cover support tools, refunds, tableside ordering, testing, networking, settings, printing, day close, floor management, security patches, and release automation.

Priority: ➖ Normal

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to d85df

The missing release notes are restored for the targeted version range, with no demonstrated issue remaining in the changed file.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description explains the change, reason, scope decision, and completed verification. It does not follow the repository template because it omits Related work, Scope, Compatibility & data safety, S… Add the missing template sections. State the issue or 'None (trivial fix)', define the scope, document compatibility and data safety, add screenshots or state that they are not applicable, and complete the Contributor checklist. Move the ve…
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the documentation change and the release range. It accurately summarizes the primary change.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Description check

Explanation

The description explains the change, reason, scope decision, and completed verification. It does not follow the repository template because it omits Related work, Scope, Compatibility & data safety, Screenshots, and the Contributor checklist. The verification section also does not use the required Commands run and Results fields, and the MAS workflow remains unverified.

Resolution

Add the missing template sections. State the issue or 'None (trivial fix)', define the scope, document compatibility and data safety, add screenshots or state that they are not applicable, and complete the Contributor checklist. Move the verification details into Commands run and Results, and update the results after rerunning the 3.8.6 MAS publish workflow.

  • Fix all pre-merge checks with AI
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/backfill-changelog-3.8.6

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

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

@greptile-apps

greptile-apps Bot commented Sep 13, 2026

Copy link
Copy Markdown
Contributor

Greptile Summary

Backfills the curated changelog with releases from 3.7.5 through 3.8.6 so version-specific release-note extraction can locate the current release.

  • Adds generated Added, Changed, and Fixed sections for six released versions.
  • Preserves the existing changelog content beginning with version 3.7.2.
  • Formats the 3.8.6 section compatibly with the Mac App Store release-note parser.

Confidence Score: 5/5

The PR appears safe to merge; the backfilled section restores the format expected by the Mac App Store release-note extraction path.

No actionable correctness or quality issues remain: the current-version heading satisfies the parser contract, the included release sequence is consistent with repository history, and existing changelog content is preserved.

Important Files Changed

Filename Overview
CHANGELOG.md Adds correctly formatted historical release sections through version 3.8.6 without altering existing entries.

Reviews (1): Last reviewed commit: "docs: backfill CHANGELOG.md through 3.8...." | Re-trigger Greptile

@itsbkm
itsbkm merged commit 04a57a1 into main Sep 13, 2026
15 checks passed
@itsbkm
itsbkm deleted the docs/backfill-changelog-3.8.6 branch September 13, 2026 22:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant