Skip to content

docs: cut CHANGELOG [0.2.0] for the first release - #77

Merged
Navi Bot (project-navi-bot) merged 2 commits into
mainfrom
docs/changelog-v0.2.0
May 26, 2026
Merged

docs: cut CHANGELOG [0.2.0] for the first release#77
Navi Bot (project-navi-bot) merged 2 commits into
mainfrom
docs/changelog-v0.2.0

Conversation

@Fieldnote-Echo

Copy link
Copy Markdown
Member

Release-prep changelog curation for the first crates.io / PyPI publish of 0.2.0.

What

Folds the curated [Unreleased] entries into a single [0.2.0] - 2026-05-26
section (the first-publish date). The crate was never published, so the
post-rebrand hardening that had collected under [Unreleased] is part of this
first 0.2.0 and belongs in its changelog — and a plain rename would have collided
with the existing [0.2.0] - 2026-05-22 rebrand section, so the two are merged
into one section.

Editorial decisions (flagging for review)

  • Merge [Unreleased][0.2.0], re-dated 2026-05-26.
  • Entry prose preserved verbatim except two trims:
    • dropped the redundant "Crate version bumped to 0.2.0" bullet (implicit for a first publish);
    • removed the now-stale "in-progress Python bindings noted" clause (they ship as pip install ordvec).
  • [0.1.0] kept as internal history; empty [Unreleased] retained on top; compare links unchanged.
  • Not added: PR Pre-publish: correct the crates.io README snapshot + harden release gates #76's publish-snapshot / release-gate work is not separately listed — say the word if you want a line for it.

After merge (release sequence)

  1. This merge moves main HEAD → new release candidate; all four gated workflows (ci / python / fuzz / codeql) run on it (python.yml now always runs on main per Pre-publish: correct the crates.io README snapshot + harden release gates #76).
  2. Wait for them green.
  3. Push v0.2.0 tag → changelog.yml creates a draft GitHub Release via git-cliff (review/trim — with no prior tag, --latest spans all history).
  4. Dispatch release-crate.yml + release-python.yml; approve the crates-io / pypi environments.

Publish stays held on your dispatch + environment approval.

Fold the curated [Unreleased] entries into a single [0.2.0] section dated
2026-05-26 (the first crates.io/PyPI publish date). The crate was never
published, so the post-rebrand hardening that accumulated under [Unreleased]
(crate-wide unsafe_op_in_unsafe_fn, CI fuzz smoke, rank_to_bucket fail-loud, the
Python 3.10 / numpy 2.0 floor, the pytest CVE remediation) is all part of this
first 0.2.0 release and belongs in its changelog.

A plain [Unreleased] -> [0.2.0] rename would have collided with the existing
[0.2.0] - 2026-05-22 rebrand section, so the two are merged. Entry prose is
preserved verbatim except: the redundant "Crate version bumped to 0.2.0" bullet
is dropped (implicit for a first publish) and the now-stale "in-progress Python
bindings noted" clause is removed (they ship as `pip install ordvec`). [0.1.0]
is kept as internal history.

git-cliff still authors the GitHub Release notes on the v0.2.0 tag push; this is
the in-repo CHANGELOG curation the release PR is for (CONTRIBUTING.md "Releases").

Signed-off-by: Nelson Spence <nelson@projectnavi.ai>
@qodo-code-review

Copy link
Copy Markdown

Review Summary by Qodo

Merge Unreleased into [0.2.0] for first public release

📝 Documentation

Grey Divider

Walkthroughs

Description
• Merges [Unreleased] entries into [0.2.0] section dated 2026-05-26
• Consolidates two 0.2.0 sections (rebrand + hardening) into single release entry
• Removes redundant "Crate version bumped" bullet and stale Python bindings note
• Reorganizes subsections: moves Security and Documentation to end of [0.2.0]
Diagram
flowchart LR
  A["[Unreleased] entries"] -->|"Fold into"| B["[0.2.0] - 2026-05-26"]
  C["Old [0.2.0] - 2026-05-22"] -->|"Merge with"| B
  B -->|"Consolidate as"| D["Single first release"]

Loading

Grey Divider

File Changes

1. CHANGELOG.md 📝 Documentation +30/-34

Consolidate changelog for 0.2.0 first release

• Merges [Unreleased] section into [0.2.0] dated 2026-05-26 for first public release
• Consolidates two separate 0.2.0 sections (rebrand + post-rebrand hardening) into one
• Removes redundant "Crate version bumped to 0.2.0" bullet and stale "in-progress Python bindings
 noted" clause
• Reorganizes subsections within [0.2.0]: moves Security and Documentation subsections to end,
 preserves Added/Changed/Deprecated/Breaking Changes structure

CHANGELOG.md


Grey Divider

Qodo Logo

@qodo-code-review

qodo-code-review Bot commented May 26, 2026

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

Qodo Logo

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the CHANGELOG.md file to consolidate the changes for the upcoming 0.2.0 release, which is the first public release on crates.io and PyPI. It documents the OrdVec ontology rebrand (dropping the 'Index' suffix from index types and flattening the rank_index module), security fixes, and documentation updates. There are no review comments to address.

@codecov

codecov Bot commented May 26, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR prepares the curated changelog for the first public 0.2.0 release by promoting prior unreleased entries into the release section.

Changes:

  • Adds ## [0.2.0] - 2026-05-26 as the first public release entry.
  • Merges the prior rebrand notes and pre-publish hardening notes into one section.
  • Keeps an empty [Unreleased] section for future changes.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CHANGELOG.md Outdated
After folding [Unreleased] into [0.2.0], the intro still read "the earlier
0.1.0 / 0.2.0 entries below were internal milestones ... so this is the first
version people see" — self-contradictory: this *is* the [0.2.0] section (there
is no [0.2.0] below, only [0.1.0]), and it cannot call 0.2.0 both an internal
milestone and the first public version.

Rewrite the intro to state it plainly: 0.2.0 is the first public release (the
crate was not published before), pairing the rebrand with the pre-publish
hardening that followed; the [0.1.0] section below is the pre-publish internal
history.

(Codex stop-gate review finding.)

Signed-off-by: Nelson Spence <nelson@projectnavi.ai>
@project-navi-bot
Navi Bot (project-navi-bot) merged commit a12cd4a into main May 26, 2026
25 checks passed
@project-navi-bot
Navi Bot (project-navi-bot) deleted the docs/changelog-v0.2.0 branch May 26, 2026 16:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants