refactor(linter/plugins): more debug assertions in initTokensWithComments

[overlookmotel]

Follow-on after #16071. Add more debug assertions to ensure comments and tokens are merged correctly. This code is removed in release build - just for tests.

[overlookmotel]

• perf(linter/plugins): speed up initTokensWithComments #16117
• refactor(linter/plugins): more debug assertions in initTokensWithComments #16116 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

• 0-merge - adds this PR to the back of the merge queue
• hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[Copilot]

Pull request overview

This PR refactors debug assertions in the initTokensWithComments function by extracting the validation logic into a separate debugCheckTokensWithComments function. The new function provides more comprehensive checks that verify not only the length but also the correct ordering of merged tokens and comments. These assertions are only active in debug builds and are completely removed by the minifier in production.

Key Changes:

• Extracted debug validation logic into a dedicated debugCheckTokensWithComments function
• Enhanced validation to verify both length and ordering of merged tokens/comments
• Added check to detect duplicate token/comment start positions

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[graphite-app]

Merge activity

• Nov 25, 6:32 PM UTC: overlookmotel added this pull request to the Graphite merge queue.
• Nov 25, 6:38 PM UTC: Merged by the Graphite merge queue.