Skip to content

Prepare v0.1.0-alpha.1 release#33

Merged
frahlg merged 1 commit into
mainfrom
agent/v0.1.0-alpha.1
Jul 21, 2026
Merged

Prepare v0.1.0-alpha.1 release#33
frahlg merged 1 commit into
mainfrom
agent/v0.1.0-alpha.1

Conversation

@frahlg

@frahlg frahlg commented Jul 21, 2026

Copy link
Copy Markdown
Member

Summary

  • set the package version to 0.1.0-alpha.1
  • add the first changelog with verified features and known limits
  • define alpha, beta, release-candidate, and stable gates
  • add immutable annotated-tag rules and an incident path that never retags a release
  • add a tag-triggered workflow that verifies the version, repeats the full release checks, builds native Linux and macOS archives, writes SHA256SUMS, and creates the GitHub release
  • mark the M0 initial exit complete with its current test evidence

Why

FTWDB has no tag or release yet, while its merged code and CI now support a useful evaluation build. This change makes the first release an explicit alpha and records the gaps that still block beta or stable status.

The release stays on GitHub. Publishing to crates.io remains a separate choice.

Validation

  • actionlint .github/workflows/ci.yml .github/workflows/release.yml
  • action commit pins checked against their official GitHub tags
  • python3 -m unittest -v bench.adapters.test_questdb
  • cargo fmt --all -- --check
  • cargo clippy --all-targets --all-features --locked --offline -- -D warnings
  • cargo test --all-targets --all-features --locked --offline
  • cargo test --doc --all-features --locked --offline
  • SD-emulator format, Clippy, and all-target tests with locked offline dependencies
  • cargo build --release --locked --offline
  • cargo package --locked --offline

Local result: 151 main tests and 11 emulator tests passed. The verified crate contains 66 files and is 2.7 MiB compressed.

Release limits

  • Unix only
  • not production-ready
  • no physical target-board or SD-card power-cut evidence during commits yet
  • no long soak result or remote backup policy yet
  • no stable API or file-format promise

@frahlg
frahlg merged commit e980014 into main Jul 21, 2026
4 checks passed
@frahlg
frahlg deleted the agent/v0.1.0-alpha.1 branch July 21, 2026 17:56

@chatgpt-codex-connector chatgpt-codex-connector 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.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3fbe99baa9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

run: |
set -euo pipefail
tag="${GITHUB_REF_NAME}"
if [[ ! "${tag}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+(-(alpha|beta|rc)\.[0-9]+)?$ ]]; then

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Verify release tags are on main

The release policy added in docs/releases.md requires release tags to point at main after CI, but this workflow accepts any matching v* tag and the publish step only uses gh release create --verify-tag, which the gh manual documents as checking that the tag already exists. If a maintainer accidentally pushes a semver tag from an unmerged release-prep or feature branch, these jobs can still publish archives and a GitHub release for code that never landed on main; add a git branch --remotes --contains "$GITHUB_SHA"/origin/main containment check before publishing.

Useful? React with 👍 / 👎.

--repo "${GITHUB_REPOSITORY}" \
--verify-tag \
--title "FTWDB ${GITHUB_REF_NAME}" \
--notes-from-tag \

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Require annotated tags before using tag notes

The new process relies on annotated tags to carry the release notes, but --notes-from-tag does not enforce that: the gh manual says a non-annotated tag falls back to the commit message. If someone pushes a lightweight v... tag, this workflow still publishes a release, but the notes can omit the known limits/platform support required by the release policy; add an explicit git cat-file -t "$GITHUB_REF_NAME" check for tag in the verify job.

Useful? React with 👍 / 👎.

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.

1 participant