docs: CLAUDE.md version banner shows 1.4.0 instead of 1.5.0 (re-drift)

[wildcard]

[agent]

Agent: Claude Code (claude-sonnet-4-6) — caro-qa-agent

---

Problem

CLAUDE.md line 9 reads **Version**: 1.4.0 (GA) while the actual shipped version is 1.5.0 (confirmed via caro --version, Cargo.toml, and CHANGELOG.md). This is a re-occurrence of the pattern tracked in #1044 (which fixed the drift from 1.1.0 → 1.4.0 but did not add CLAUDE.md to the release-version-alignment checklist, so the fix did not survive the 1.5.0 release).

CLAUDE.md is loaded as project instructions by every Claude Code session on this repo. Agents and contributors carrying a 1.4.0 version assumption may misattribute bugs, reference outdated feature availability, or produce incorrect documentation.

Reproduction

grep "Version" CLAUDE.md
# → - **Version**: 1.4.0 (GA)

./target/release/caro --version
# → caro 1.5.0 (be07b22 2026-07-18)

grep "^version" Cargo.toml
# → version = "1.5.0"

Expected vs Actual

Expected: **Version**: 1.5.0 (GA) in CLAUDE.md line 9

Actual: **Version**: 1.4.0 (GA) — one minor release behind

Environment

• caro version: 1.5.0 (be07b22 2026-07-18)
• OS: Linux 6.18.44-fc-v24 x86_64 (remote sandbox)
• Test date: 2026-09-12
• Backend: N/A (documentation-only finding)

Investigation

• CLAUDE.md:9 — - **Version**: 1.4.0 (GA)
• Cargo.toml:3 — version = "1.5.0"
• docs: CLAUDE.md version banner shows 1.1.0 (GA) instead of 1.3.0 #1044 was filed 2026-05-07 (1.3.0 → 1.4.0 drift), closed 2026-05-09. The CLAUDE.md was updated to 1.4.0 but CLAUDE.md was not added to the release-version-alignment 6-file checklist in .claude/rules/release-version-alignment.md. The 1.5.0 release (chore(release): v1.5.0 — PR chore(release): v1.5.0 #1304, 2026-07-12) therefore did not update CLAUDE.md.

Fix Direction

1. Update CLAUDE.md line 9: **Version**: 1.5.0 (GA)
2. Add CLAUDE.md to the 6-file release-version-alignment checklist in .claude/rules/release-version-alignment.md so drift cannot recur in future releases.

Severity

P2 — Developer experience issue. Not user-facing but affects every Claude Code session on this repo. Third time this drift has been caught (1.1.0 → 1.3.0 pre-QA-agent, then 1.3.0 → 1.4.0 via #1044, now 1.4.0 → 1.5.0). Root cause is the missing checklist entry; fix #2 above closes the re-occurrence loop.

---

Prompt used to generate this comment

caro QA agent — daily rotation slot A+B+C, scheduled remote run 2026-09-12

[github-actions]

🔍 Bug Report Validation

Status: ⏳ Missing Information

Thank you for reporting this bug! To help us investigate effectively, we need a bit more information:

Required Information

• Missing exact command: Please provide the exact command that triggered the bug
• Missing reproduction steps: Please fill in the numbered steps with actual actions

Suggestions

• Consider adding debug logs (RUST_LOG=debug), configuration, or additional context to help us investigate

How to Update

1. Click "Edit" on your original issue description
2. Fill in the missing information
3. Click "Update comment"

The awaiting-response label will be automatically removed once all required information is provided.

Need Help?

If you're unsure about any of these fields:

• Check our QA Process Guide
• Ask in GitHub Discussions
• See example bug reports

This is an automated check to ensure we have the information needed for effective QA investigation. Thank you for helping improve caro! 🙏

[github-actions]

Potential Related Issues

This issue might be related to existing issues:

• docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0 #1442: docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0
• docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0 #1434: docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0
• docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0 #1431: docs: CLAUDE.md version banner shows 1.4.0 (GA) instead of 1.5.0

If your issue is a duplicate, please add a comment to the existing issue instead. If it's different, please add more context to help us understand how it differs.

This is an automated check. Please verify the suggestions above.