Skip to content

docs: CLAUDE.md version banner shows 1.4.0 instead of 1.5.0 (regression of #1044) #1359

Description

@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 and Cargo.toml). This is a direct regression of #1044, which fixed the same drift from 1.1.0 → 1.3.0. The root fix direction from #1044 — adding CLAUDE.md to the 6-file release-version-alignment checklist — was apparently not implemented, so v1.5.0 shipped with the same stale banner.

Every Claude Code session on this repo loads CLAUDE.md as project instructions, so every agent and contributor carries an incorrect version assumption for the entire session.

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 in CLAUDE.md
Actual: **Version**: 1.4.0 (GA) — one minor release behind

Environment

  • caro version: 1.5.0 (be07b22 2026-07-18)
  • OS: Linux 6.18.5 x86_64 (remote sandbox)
  • Test date: 2026-07-20
  • Backend: N/A (documentation-only finding)

Investigation

  • CLAUDE.md:9- **Version**: 1.4.0 (GA)
  • Cargo.tomlversion = "1.5.0"
  • caro --versioncaro 1.5.0 (be07b22 2026-07-18)
  • CHANGELOG.md — top entry is ## [1.5.0] - 2026-07-12
  • docs: CLAUDE.md version banner shows 1.1.0 (GA) instead of 1.3.0 #1044 was closed 2026-05-09 with fix for 1.3.0 drift, but CLAUDE.md was not added to the release-version-alignment 6-file checklist, allowing identical drift to recur with v1.5.0

Fix Direction

  1. Update CLAUDE.md line 9: **Version**: 1.5.0
  2. Add CLAUDE.md to the 6-file checklist in .claude/rules/release-version-alignment.md (under the | # | File | What to update | table) so this cannot recur.

Severity

P2 — Developer experience regression: same root cause as #1044, same fix direction, not implemented. Affects every Claude Code session on this repo.


Prompt used to generate this comment
caro QA agent — daily rotation slot A+B+C, scheduled remote run 2026-07-20

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium priority - normal priority issueawaiting-responseWaiting for response from authorbackendRelated to inference backendsbugSomething isn't workingdocumentationImprovements or additions to documentationenhancementNew feature or requestplatform/linuxLinux specificqaFiled by automated QA agentregressionReintroduction of previously-fixed behavior

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions