[acgetchell]

Prepare v0.5.1 with synchronized Cargo, citation, and README release metadata, the generated changelog, and retained v0.5.1 versus v0.5.0 performance evidence.

• Update the performance report, README benchmark table, and SVG/CSV chart assets from the completed full measurement run.
• Save independent source assertions during performance-prepare so performance-readme can reuse them without shell variables or repeated measurements.
• Default prospective changelog dates to the prepared citation metadata while retaining explicit date overrides.
• Update release/benchmark documentation, adapter tests, and the uv requirement to 0.13.5.

Validation

• Full benchmark measurement completed: 1,422 cases across baseline and current phases; both correctness gates passed.
• just performance-promote passed using the saved measurement bundle.
• just performance-readme passed using the retained evidence and prepared source assertions.
• GitHub checks have not reported on the release commit yet; no additional test suite was run while opening this PR.

Release benchmark runtime improvements are tracked separately in #301 for v0.5.2.

Summary by CodeRabbit

• Documentation
  • Updated installation examples and release information for version 0.5.1.
  • Published benchmark results comparing version 0.5.1 with 0.5.0, including timing data and links to supporting evidence.
  • Clarified release and benchmarking guidance, including how release dates and benchmark reports are handled.
• Maintenance
  • Updated the project’s recorded version and release date to 0.5.1.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

• Source mode: Auto
• Repository: acgetchell/la-stack
• Branch: release/v0.5.1
• File: .coderabbit.yaml
• Commit: 03c59fc
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Essentials
• Run ID: a7708a6c-c872-4362-872d-3185f08c58ac

📥 Commits

Reviewing files that changed from the base of the PR and between eb6f071 and 03c59fc.

⛔ Files ignored due to path filters: 3

• Cargo.lock is excluded by !**/*.lock
• docs/assets/bench/vs_linalg_lu_solve_median_log.csv is excluded by !**/*.csv
• docs/assets/bench/vs_linalg_lu_solve_median_log.svg is excluded by !**/*.svg

📒 Files selected for processing: 23

• CHANGELOG.md
• CITATION.cff
• Cargo.toml
• README.md
• docs/BENCHMARKING.md
• docs/RELEASING.md
• docs/code_organization.md
• docs/performance-runs/README.md
• docs/performance-runs/index.json
• docs/performance-runs/latest.json
• docs/performance-runs/runs/26cb584886988dc4a95c717e49f27147bfc68a3edf9b495e944ccf751d0cd413/evidence.json
• docs/performance-runs/runs/26cb584886988dc4a95c717e49f27147bfc68a3edf9b495e944ccf751d0cd413/report.md
• docs/performance-runs/runs/26cb584886988dc4a95c717e49f27147bfc68a3edf9b495e944ccf751d0cd413/run.json
• docs/performance.md
• justfile
• pyproject.toml
• tooling/README.md
• tooling/release_changelog.py
• tooling/release_performance.py
• tooling/tests/test_changelog_integration.py
• tooling/tests/test_performance_workflow.py
• tooling/tests/test_release_changelog.py
• tooling/tests/test_release_performance.py

Included review availability: This review used your included allowance. 3 included reviews remain after this review. Your included PR review attempts over the past 7 days set your current allowance at 4 reviews per hour.

📝 Walkthrough

The release updates version 0.5.1 records and benchmark evidence. It adds adapters for citation-based changelog dates and saved performance-release inputs, with updated recipes, documentation, and tests.

Changes: Release Metadata and Changelog

Layer / File(s)	Summary
Changelog date resolution and delegation tooling/release_changelog.py, justfile, CITATION.cff, docs/RELEASING.md, docs/code_organization.md, tooling/README.md, tooling/tests/*changelog*	Tagged changelog generation uses the citation release date when no date is supplied. The adapter validates citation metadata and delegates generation to the shared CLI. Explicit dates remain supported.
v0.5.1 release record and benchmark report CHANGELOG.md, Cargo.toml, README.md, pyproject.toml, docs/performance-runs/*	Release metadata and installation examples use version 0.5.1. The changelog and performance-run records include the v0.5.1 release and benchmark comparison with v0.5.0.

Performance Release Preparation and Publication

Layer / File(s)	Summary
Capture and save release identities tooling/release_performance.py, justfile, docs/BENCHMARKING.md, docs/RELEASING.md, tooling/tests/test_release_performance.py	performance-prepare resolves and validates release tags and commits, then saves them in target/bench-reports/release-inputs.json. Tests cover release selection and capture failures.
Publish README from saved assertions tooling/release_performance.py, justfile, docs/BENCHMARKING.md, docs/RELEASING.md, docs/code_organization.md, tooling/README.md, tooling/tests/*performance*	performance-readme loads validated saved assertions or accepts four explicit values, then delegates publication. The documentation and tests describe and verify publication separately from measurement and report promotion.

Priority: ➖ Normal

Estimated code review effort: 3 (Moderate) | ~25 minutes

Change: Other

Sequence Diagram(s)

sequenceDiagram
  participant Maintainer
  participant PerformancePrepare
  participant ReleasePerformance
  participant GitAndReleaseHistory
  participant ReleaseInputs
  participant PerformanceRelease
  participant PerformanceReadme
  participant PublicationCLI
  Maintainer->>PerformancePrepare: Select optional current and baseline tags
  PerformancePrepare->>ReleasePerformance: Run capture
  ReleasePerformance->>GitAndReleaseHistory: Resolve release pair and commit identities
  ReleasePerformance->>ReleaseInputs: Save validated assertions
  Maintainer->>PerformanceRelease: Measure and promote report
  Maintainer->>PerformanceReadme: Publish README after promotion
  PerformanceReadme->>ReleaseInputs: Load saved assertions
  PerformanceReadme->>PublicationCLI: Publish using selected tags and revisions

Loading

Possibly related issues

• Issue 130 in acgetchell/research-repo-tools: This change adds the citation-date fallback and retains explicit date overrides.
• Issue 129 in acgetchell/research-repo-tools: This change saves release assertions for later README publication and separates that step from measurement.

Possibly related PRs

• acgetchell/la-stack#297: This PR continues the shared-tooling transition by adding repository adapters and updating release recipes and documentation.

Merge Risk: ⚪ Minimal · up to 03c59

The release metadata and publication workflow show no established merge-blocking issue. Normal checks can proceed before merging.

Pre-merge checks: 4

Check name	Status	Explanation
Description Check		Check skipped - CodeRabbit’s high-level summary is enabled.
Title check		The title clearly and concisely identifies the primary change: preparing the v0.5.1 release.
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

📝 Generate docstrings

• Commit to this branch
• Create a new PR

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

_{Comment @coderabbitai help to get the list of available commands.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.18%. Comparing base (eb6f071) to head (03c59fc).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #302   +/-   ##
=======================================
  Coverage   98.18%   98.18%           
=======================================
  Files          14       14           
  Lines        7215     7215           
=======================================
  Hits         7084     7084           
  Misses        131      131           

Flag	Coverage Δ
unittests	98.18% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.