release: v0.3.0

[Travis Sharp (tsharp)]

Prepped for Release v0.3.0

[Copilot]

Pull request overview

Prepares Nacelle 0.3.0 with revised telemetry, expanded validation, serving documentation, examples, and stress/profiling tooling.

Changes:

• Renames metrics, adopts base units and body-size histograms, and strengthens HTTP limits.
• Expands CI, dependency policy, API checks, tests, and runnable examples.
• Updates crate versions and release-facing documentation.

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
scripts/validate-all.sh	Expands example feature validation.
scripts/profile-linux.sh	Adds profiling and churn options.
scripts/performance-common.ps1	Corrects baseline copying.
README.md	Adds branding and stable versions.
nacelle/src/host.rs	Documents host serving APIs.
nacelle/src/app.rs	Documents application serving contracts.
nacelle/Cargo.toml	Sets version 0.3.0.
nacelle-tcp/src/server/listeners.rs	Documents listener methods.
nacelle-tcp/src/server.rs	Documents shared TCP serving.
nacelle-tcp/src/serial_server.rs	Documents serial TCP serving.
nacelle-tcp/src/runtime/rustls.rs	Documents Rustls listeners.
nacelle-tcp/src/runtime/openssl.rs	Documents OpenSSL listeners.
nacelle-tcp/src/runtime.rs	Defines runtime serving contract.
nacelle-tcp/src/connection/tests.rs	Adds framing, cancellation, and size regressions.
nacelle-tcp/src/connection.rs	Documents direct connection serving.
nacelle-tcp/Cargo.toml	Sets version 0.3.0.
nacelle-rustls/Cargo.toml	Sets version 0.3.0.
nacelle-openssl/Cargo.toml	Sets version 0.3.0.
nacelle-http/src/server.rs	Adds early body rejection, docs, and lifecycle tests.
nacelle-http/src/encoder.rs	Records completed response-body metrics.
nacelle-http/Cargo.toml	Sets version 0.3.0.
nacelle-core/src/telemetry/mod.rs	Revises metric schema and units.
nacelle-core/src/limits.rs	Renames gauges and adds concurrency coverage.
nacelle-core/Cargo.toml	Sets version 0.3.0.
nacelle-codec/Cargo.toml	Sets version 0.3.0.
examples/nacelle-stress-test/src/main.rs	Adds connection-churn measurements.
examples/nacelle-stress-test/Cargo.toml	Sets version 0.3.0.
examples/nacelle-stress-server/src/main.rs	Adapts metrics console to new schema.
examples/nacelle-stress-server/Cargo.toml	Sets version 0.3.0.
examples/nacelle-stress-common/Cargo.toml	Sets version 0.3.0.
examples/nacelle-proxy/Cargo.toml	Updates Nacelle dependency version.
examples/nacelle-examples/src/bin/unix_echo.rs	Adds Unix echo example.
examples/nacelle-examples/src/bin/tcp_memory_guard.rs	Revises memory-guard startup and rejection checks.
examples/nacelle-examples/src/bin/openssl_echo.rs	Adds OpenSSL echo example.
examples/nacelle-examples/src/bin/manual_host.rs	Adds manual-host example.
examples/nacelle-examples/src/bin/listener_tcp.rs	Adds listener-helper example.
examples/nacelle-examples/src/bin/direct_tcp.rs	Adds direct TCP example.
examples/nacelle-examples/src/bin/direct_http.rs	Adds direct HTTP example.
examples/nacelle-examples/src/bin/compiler_pressure.rs	Adds future-size regression example.
examples/nacelle-examples/Cargo.toml	Registers examples and OpenSSL feature.
docs/topics/operations.md	Documents the revised metrics schema.
docs/theme/nacelle.css	Styles the documentation logo.
docs/SUMMARY.md	Adds migration and release-note links.
docs/reference/rust-api.md	Documents serving contracts.
docs/reference/release-notes-0.3.0-rc.2.md	Adds RC.2 release notes.
docs/reference/api-stability.md	Clarifies hidden API stability.
docs/index.md	Adds documentation branding.
docs/how-to/security-scanning.md	Documents cargo-deny checks.
docs/how-to/run-stress-tests.md	Documents connection churn.
docs/how-to/migrate-rc-2.md	Adds RC.2 migration guidance.
docs/how-to/compare-performance.md	Documents profiling controls.
docs/assets/nacelle-mark.svg	Replaces the project logo.
deny.toml	Defines dependency policy.
Cargo.toml	Updates workspace crate versions.
Cargo.lock	Records stable crate versions.
.github/workflows/ci.yml	Adds docs, API, and dependency checks.
.github/scripts/miri.sh	Excludes recorder-incompatible tests.
.github/scripts/check-serving-docs.sh	Adds serving-documentation auditing.
.github/scripts/check-public-api.sh	Adds API compatibility checks.
.github/scripts/check-feature-matrix.sh	Validates explicit example feature sets.

Suppressed comments (1)

docs/reference/release-notes-0.3.0-rc.2.md:3

• This document describes and tells users to install 0.3.0-rc.2, but this PR changes every published crate and the README to stable 0.3.0. As written, the release navigation points users at an unpublished version and gives RC.2/RC.3 rollback guidance that contradicts the stated 0.3.0 release. Either keep the manifests on RC.2 or rewrite/rename the migration and release notes for the stable release (including docs/SUMMARY.md).

# 0.3.0-rc.2 release and rollback notes

RC.2 is the second `0.3.0` release candidate. It supersedes the published RC.1

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.