[Growth] Cut v0.5.1 patch for doctor cache wording

[luoyuctl]

Closes #240

Summary

• Bump the release candidate version to 0.5.1 for the doctor cache wording patch.
• Align README badges/sample output, site metadata/demo report metadata, and the in-repo Homebrew formula/test with v0.5.1.
• Add concise v0.5.1 release candidate notes for [Quality] Clarify doctor cache wording #239.

User-facing value

Users who install the next GitHub Release or use go install get the clarified agenttrace --doctor cache-state wording from #239.

Adoption rationale

Doctor is a first-run and support surface. Keeping the released binary and public release surfaces aligned avoids confusion between parsed session cache entries, reusable entries for the current scan, and cached directory listings.

Scope

• Version/release surfaces only.
• Includes [Quality] Clarify doctor cache wording #239 as the release payload.
• No npm wrapper/package files restored.
• No Homebrew publish, npm publish, external package publish, external posting, or automatic merge.

Test plan

• git diff --check
• go test ./...
• go build -o /tmp/agenttrace-growth-check ./cmd/agenttrace
• /tmp/agenttrace-growth-check --version -> agenttrace v0.5.1
• /tmp/agenttrace-growth-check --doctor
• /tmp/agenttrace-growth-check --demo --overview -f json
• /tmp/agenttrace-growth-check --demo --overview -f html -o /tmp/agenttrace-growth-demo.html
• scripts/ci/check-release-surfaces.sh
• scripts/ci/check-pages-artifact.sh site
• AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-docs-commands.sh
• AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-output-contract.sh
• AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-deterministic-output.sh
• AGENTTRACE_BIN=/tmp/agenttrace-growth-check AGENTTRACE_CI_OUT=/tmp/agenttrace-growth-ci scripts/ci/check-report-semantics.sh
• git ls-files 'npm/*' returned no tracked files

Safety checklist

• No tag/release/package publish performed in this PR.
• No npm package surfaces restored.
• Public notes avoid hosted tracing, uploaded logs, security enforcement, external package-publish promises, and unsupported parser claims.

[luoyuctl]

Quality Gatekeeper Review

Verdict: PASS
Risk: Medium
Lane: growth

Checks:

• One logical change: v0.5.1 release-surface/version alignment for [Release] Cut v0.5.1 patch for doctor cache wording #240
• Scope is clear and linked to [Release] Cut v0.5.1 patch for doctor cache wording #240
• Protected files unchanged
• No secret/session/prompt leakage
• No public platform-attention target wording
• GitHub mergeStateStatus=CLEAN
• GitHub CI Test and build passed for head 35cfa9e6042b629424b5f5e79a07bb607a544425
• git diff --check origin/master...HEAD passed
• go test ./... passed
• go build -o /tmp/agenttrace-review-pr-241 ./cmd/agenttrace passed
• /tmp/agenttrace-review-pr-241 --version reports agenttrace v0.5.1
• /tmp/agenttrace-review-pr-241 --doctor passed and shows clarified cache wording
• /tmp/agenttrace-review-pr-241 --demo --overview -f json passed
• /tmp/agenttrace-review-pr-241 --demo --overview -f html -o /tmp/agenttrace-review-pr-241-demo.html passed
• scripts/ci/check-release-surfaces.sh passed
• scripts/ci/check-pages-artifact.sh site passed
• docs commands, output contract, deterministic output, and report semantics checks passed

Notes: changed files are release/version surfaces only: CHANGELOG.md, README files, site metadata/demo report, in-repo Homebrew formula version/test, and internal/engine/engine.go. No npm files are tracked or restored. Public copy keeps local-first wording and does not add hosted tracing, uploaded logs, security enforcement, external package-publish promises, or unsupported parser claims.

Decision: PASS. This prepares a valid v0.5.1 release candidate surface for #240. This review does not itself create a tag, GitHub Release, npm/Homebrew publish, or external posting.

[luoyuctl]

Quality Gatekeeper Review

Verdict: PASS
Risk: High
Lane: growth
Checks:

• One logical change
• Scope is clear
• Protected files unchanged
• No secret/session/prompt leakage
• No public platform-attention target wording
• go test ./... passed
• go build passed
• doctor/demo overview passed
• Docs/tests updated if needed
  Notes: Reviewed PR [Growth] Cut v0.5.1 patch for doctor cache wording #241 from head 35cfa9e6042b629424b5f5e79a07bb607a544425. GitHub mergeStateStatus=CLEAN; CI Test and build succeeded. Changed files are release/version surfaces only: CHANGELOG.md, README files, Homebrew formula metadata/test, internal/engine/engine.go, and site metadata/demo report. No npm package surfaces restored; no tag/release/package publish performed by Quality.

Validation commands:

• git diff --check
• go test ./...
• go build -o /tmp/agenttrace-review-pr-241 ./cmd/agenttrace
• /tmp/agenttrace-review-pr-241 --version -> agenttrace v0.5.1
• /tmp/agenttrace-review-pr-241 --doctor || true
• /tmp/agenttrace-review-pr-241 --demo --overview -f json
• /tmp/agenttrace-review-pr-241 --demo --overview -f html -o /tmp/agenttrace-review-pr-241-demo.html
• scripts/ci/check-release-surfaces.sh
• scripts/ci/check-pages-artifact.sh site
• AGENTTRACE_BIN=/tmp/agenttrace-review-pr-241 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-241-output scripts/ci/check-output-contract.sh
• AGENTTRACE_BIN=/tmp/agenttrace-review-pr-241 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-241-deterministic scripts/ci/check-deterministic-output.sh
• AGENTTRACE_BIN=/tmp/agenttrace-review-pr-241 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-241-report scripts/ci/check-report-semantics.sh
• AGENTTRACE_BIN=/tmp/agenttrace-review-pr-241 AGENTTRACE_CI_OUT=/tmp/agenttrace-review-pr-241-docs scripts/ci/check-docs-commands.sh
• git ls-files 'npm/*' returned no tracked files

Decision: Quality release gate is PASS for the v0.5.1 release-candidate surfaces in this PR. Because this touches release/version surfaces, Quality will not auto-merge this high-risk release PR or create tag/release/package artifacts. Handoff to: Growth for maintainer-authorized merge/release execution after this gate.