improvement(lint): strip comment noise and add check:comment-hygiene

[waleedlatif1]

Summary

• Comment-only sweep of the 60 noisiest files: removed ~2,900 lines of section labels, comments that restate the next line, change-history narration, and scratch math; promoted ~100 genuine contract notes (units, enums, invariants) to TSDoc. Kept every non-obvious why, spec/math note, quirk, biome-ignore, and // <tag>: annotation
• Converted or removed 236 banner separators across 37 files; deleted 9 commented-out code blocks
• Deleting the commented-out greptile_search access entry fixed generated docs that advertised a disabled Greptile Search operation (regenerated greptile.mdx and integrations.json)
• New check:comment-hygiene audit: fails on banner separators and on runs of // comments that parse as TypeScript (commented-out code). Comments come from the Babel token stream so strings are never inspected; escape hatch is // comment-hygiene-allow: <reason>. Zero false positives across the tree before the sweep; no baseline since every hit was fixed
• Change-history phrasing ("previously", "no longer") was not made a check — too often describes live runtime state

Type of Change

• Improvement (code hygiene / guardrails)

Testing

• Every changed source file compared to staging with comments stripped from the Babel token stream: identical tokens in all files (comment-only sweep)
• bun run check:audits, bun run test:scripts (incl. 8 new detector tests, each guard mutation-checked to go red), bun run lint, bunx turbo run type-check
• Vitest beside changed files (apps/sim, realtime, sim-cli)

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing (new tests pass the test-audit authoring gate)
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 2, 2026 12:36am UTC

[cubic-dev-ai]

All reported issues were addressed across 94 files

<sub>Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic</sub>

[greptile-apps]

Confidence Score: 5/5

[Low risk] Removes redundant comments from code and docs.

The PR appears safe to merge based on the reviewed changes.

Summary

The PR removes comment noise across source files, removes documentation for a disabled Greptile Search operation, and adds a comment-hygiene audit. Since the previous review, it has made throwing parse failures fail the audit and increased the tracked-file listing buffer.

_{Reviews (2) · Last reviewed commit: "fix(audits): fail comment-hygiene on unp..."}

[waleedlatif1]

@greptile

[waleedlatif1]

@cubic-dev-ai review this PR

[cubic-dev-ai]

@cubic-dev-ai review this PR

@waleedlatif1 I have started the AI code review. It will take a few minutes to complete.

[cubic-dev-ai]

No issues found across 94 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Re-trigger cubic}