MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]

# The version update script updates all Cargo.toml files consistently
./scripts/bump-version.sh 1.3.0

# Or manually update each Cargo.toml:
# 1. Root Cargo.toml (workspace.package.version)
# 2. Each crate's Cargo.toml (package.version)
# 3. Inter-crate dependency versions

cargo build --release
cargo test

cargo build --release

# Install cross
cargo install cross

# Build for Linux aarch64 from a Linux x86_64 or macOS host
cross build --release --target aarch64-unknown-linux-gnu

# Add the musl target
rustup target add x86_64-unknown-linux-musl

# Build statically linked binary
cargo build --release --target x86_64-unknown-linux-musl

# Check the binary exists and is the expected type
file target/release/thunder-server

# Check the binary size (should be 30-80MB depending on features)
ls -lh target/release/thunder-server

# Verify the version string is correct
./target/release/thunder-server --version

# Run a quick smoke test
./target/release/thunder-server --config config/test.toml &
sleep 2
curl http://localhost:8080/api/v1/health
kill %1

# Strip debug symbols for smaller production binary (optional)
strip target/release/thunder-server

# Build the production image
docker build -t thunderdb:1.3.0 .

# Also tag as latest
docker tag thunderdb:1.3.0 thunderdb:latest

# Stage 1: Build
FROM rust:1.75 AS builder
WORKDIR /app
COPY . .
RUN cargo build --release

# Stage 2: Runtime
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y \
    ca-certificates \
    libssl3 \
    && rm -rf /var/lib/apt/lists/*

COPY --from=builder /app/target/release/thunder-server /usr/local/bin/
COPY config/prod.toml /etc/thunderdb/config.toml

EXPOSE 5432 3306 6379 8080 50051 8081 8082 9090

ENTRYPOINT ["thunder-server"]
CMD ["--config", "/etc/thunderdb/config.toml"]

# Verify the image was built correctly
docker images thunderdb:1.3.0

# Run a smoke test
docker run -d --name thunder-test -p 5432:5432 -p 8080:8080 thunderdb:1.3.0
sleep 3

# Health check
curl http://localhost:8080/api/v1/health

# Connect with psql
psql -h localhost -p 5432 -U admin -d thunderdb -c "SELECT version();"

# Clean up
docker stop thunder-test && docker rm thunder-test

# Tag for registry
docker tag thunderdb:1.3.0 ghcr.io/thunderdb/thunderdb:1.3.0
docker tag thunderdb:1.3.0 ghcr.io/thunderdb/thunderdb:latest

# Push
docker push ghcr.io/thunderdb/thunderdb:1.3.0
docker push ghcr.io/thunderdb/thunderdb:latest

# Create a multi-architecture builder
docker buildx create --name thunder-builder --use

# Build and push multi-arch image
docker buildx build \
    --platform linux/amd64,linux/arm64 \
    -t ghcr.io/thunderdb/thunderdb:1.3.0 \
    -t ghcr.io/thunderdb/thunderdb:latest \
    --push .

./scripts/build-deb.sh

Package: thunderdb
Version: 1.3.0
Architecture: amd64
Maintainer: ThunderDB Team <team@thunderdb.io>
Description: ThunderDB - Distributed HTAP Database
 A high-performance distributed database that unifies transactional
 and analytical workloads with multi-protocol support.
Depends: libc6 (>= 2.31), libssl3

# Install
sudo dpkg -i thunderdb_1.3.0_amd64.deb

# Start the service
sudo systemctl start thunderdb
sudo systemctl enable thunderdb

# Check status
sudo systemctl status thunderdb

# View logs
sudo journalctl -u thunderdb -f

# List package contents
dpkg -c thunderdb_1.3.0_amd64.deb

# Verify package metadata
dpkg -I thunderdb_1.3.0_amd64.deb

# Install and verify
sudo dpkg -i thunderdb_1.3.0_amd64.deb
thunder-server --version

# Changelog

All notable changes to ThunderDB are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- Vector search support with HNSW and IVF indexes (#234)
- GraphQL API endpoint (#256)

### Changed
- Improved B+Tree prefix compression reduces index size by 15% (#245)

### Fixed
- Fixed deadlock in concurrent DDL operations (#267)

## [1.2.0] - 2025-12-15

### Added
- MySQL wire protocol support (#189)
- Change Data Capture (CDC) with Kafka output (#195)
- WebSocket API for live query subscriptions (#201)

### Changed
- Upgraded Tokio runtime to 1.35 (#210)
- WAL group commit batch size is now configurable (#215)

### Fixed
- Fixed memory leak in buffer pool eviction under high concurrency (#220)
- Fixed incorrect NULL handling in outer joins (#225)

### Security
- Fixed timing side-channel in password authentication (#230)

## [1.1.0] - 2025-09-01
...

# Ensure you are on the main branch and it is up to date
git checkout main
git pull origin main

# Verify all tests pass
cargo test

# Create an annotated tag
git tag -a v1.3.0 -m "ThunderDB v1.3.0

Highlights:
- Vector search support with HNSW indexes
- GraphQL API endpoint
- 15% reduction in index size through improved prefix compression

See CHANGELOG.md for the complete list of changes."

# Push the tag
git push origin v1.3.0

# List all tags
git tag -l

# List tags matching a pattern
git tag -l 'v1.3.*'

# Show tag details
git show v1.3.0

# ThunderDB v1.3.0

**Release date:** 2026-01-15

## Highlights

- **Vector Search:** ThunderDB now supports vector similarity search with
  HNSW and IVF indexes, enabling AI/ML workloads directly in the database.
- **GraphQL API:** A new GraphQL endpoint auto-generates a schema from your
  database tables, supporting queries, mutations, and subscriptions.
- **Smaller Indexes:** Improved B+Tree prefix compression reduces index storage
  by approximately 15%.

## What's New

### Vector Search (#234)

Store and search high-dimensional vectors directly in ThunderDB:

```sql
CREATE TABLE embeddings (
    id INT PRIMARY KEY,
    content TEXT,
    embedding VECTOR(1536)
);

CREATE INDEX ON embeddings USING hnsw (embedding vector_cosine_ops);

SELECT * FROM embeddings
ORDER BY embedding <=> '[0.1, 0.2, ...]'::vector
LIMIT 10;

query {
  users(where: { age: { gt: 21 } }, limit: 10) {
    id
    name
    email
  }
}

sudo systemctl stop thunderdb
sudo dpkg -i thunderdb_1.3.0_amd64.deb
sudo systemctl start thunderdb

sha256  abc123...  thunderdb-1.3.0-linux-amd64.tar.gz
sha256  def456...  thunderdb-1.3.0-linux-arm64.tar.gz
sha256  ghi789...  thunderdb-1.3.0-darwin-amd64.tar.gz
sha256  jkl012...  thunderdb-1.3.0-darwin-arm64.tar.gz
sha256  mno345...  thunderdb_1.3.0_amd64.deb

### Creating a GitHub Release

```bash
# Create a GitHub release from the tag
gh release create v1.3.0 \
    --title "ThunderDB v1.3.0" \
    --notes-file release-notes-1.3.0.md \
    target/release-artifacts/thunderdb-1.3.0-linux-amd64.tar.gz \
    target/release-artifacts/thunderdb-1.3.0-linux-arm64.tar.gz \
    target/release-artifacts/thunderdb-1.3.0-darwin-amd64.tar.gz \
    target/release-artifacts/thunderdb-1.3.0-darwin-arm64.tar.gz \
    target/release-artifacts/thunderdb_1.3.0_amd64.deb \
    target/release-artifacts/SHA256SUMS

# For pre-release versions
gh release create v1.3.0-beta.1 \
    --title "ThunderDB v1.3.0-beta.1" \
    --prerelease \
    --notes-file release-notes-1.3.0-beta.1.md \
    target/release-artifacts/*

# 1. Publish the leaf crate first
cargo publish -p thunder-common

# 2. Publish crates that depend only on thunder-common
cargo publish -p thunder-storage
cargo publish -p thunder-sql
cargo publish -p thunder-client

# 3. Continue up the dependency graph
cargo publish -p thunder-txn
cargo publish -p thunder-cluster
cargo publish -p thunder-cdc
cargo publish -p thunder-vector
cargo publish -p thunder-fdw

# 4. Publish crates with many dependencies
cargo publish -p thunder-query
cargo publish -p thunder-protocol
cargo publish -p thunder-api

# 5. Publish the top-level binary last
cargo publish -p thunder-server

# Dry run: verify the crate can be packaged
cargo publish -p thunder-common --dry-run

# Check what files will be included in the package
cargo package -p thunder-common --list

v* tag pushed
    |
    +-- Build release binaries (parallel matrix)
    |       +-- Linux x86_64
    |       +-- Linux aarch64
    |       +-- macOS x86_64
    |       +-- macOS aarch64
    |
    +-- Run full test suite against release binaries
    |
    +-- Build Docker image (multi-arch)
    |
    +-- Build Debian package
    |
    +-- Create GitHub Release with artifacts
    |
    +-- Push Docker image to registry
    |
    +-- Publish crates to crates.io (manual approval)

# Download the release binary on a clean machine
curl -LO https://github.com/smetal1/thunder-db/releases/download/v1.3.0/thunderdb-1.3.0-linux-amd64.tar.gz

# Verify checksum
sha256sum -c SHA256SUMS

# Extract and run
tar xzf thunderdb-1.3.0-linux-amd64.tar.gz
./thunder-server --version
./thunder-server --config config/prod.toml &

# Verify health
curl http://localhost:8080/api/v1/health

# Run basic queries
psql -h localhost -p 5432 -U admin -d thunderdb -c "
    CREATE TABLE test (id INT PRIMARY KEY, name TEXT);
    INSERT INTO test VALUES (1, 'hello');
    SELECT * FROM test;
    DROP TABLE test;
"

# Pull and run the released Docker image
docker pull ghcr.io/thunderdb/thunderdb:1.3.0
docker run -d --name thunder-verify -p 5432:5432 ghcr.io/thunderdb/thunderdb:1.3.0

# Verify
docker logs thunder-verify
psql -h localhost -p 5432 -U admin -d thunderdb -c "SELECT version();"

# Clean up
docker stop thunder-verify && docker rm thunder-verify

# Install on a clean Ubuntu/Debian system
sudo dpkg -i thunderdb_1.3.0_amd64.deb

# Verify service starts
sudo systemctl start thunderdb
sudo systemctl status thunderdb

# Verify connectivity
psql -h localhost -p 5432 -U admin -d thunderdb -c "SELECT version();"

# Uninstall
sudo dpkg -r thunderdb

# Start the previous version with data
docker run -d --name thunder-old -v thunder-data:/var/lib/thunderdb \
    ghcr.io/thunderdb/thunderdb:1.2.0

# Load test data
psql -h localhost -p 5432 -U admin -d thunderdb -c "
    CREATE TABLE upgrade_test (id INT PRIMARY KEY, data TEXT);
    INSERT INTO upgrade_test SELECT generate_series(1, 10000), 'data';
"

# Stop the old version
docker stop thunder-old && docker rm thunder-old

# Start the new version with the same data volume
docker run -d --name thunder-new -v thunder-data:/var/lib/thunderdb \
    ghcr.io/thunderdb/thunderdb:1.3.0

# Verify data is intact
psql -h localhost -p 5432 -U admin -d thunderdb -c "
    SELECT COUNT(*) FROM upgrade_test;
"
# Expected: 10000