# Peregrine A Rust-first object-storage engineering platform: scoped Swift compatibility, bounded deployment tooling, load generation, benchmark automation, and a web console. Current production readiness is documented explicitly. Full corpus (all pages, one document): https://docs.myswift.rs/llms-full.txt ## Pages - [Architecture](https://docs.myswift.rs/architecture/index.md) — The five cooperating programs, the three planes, and the invariants that hold the system together. - [Authentication and credentials](https://docs.myswift.rs/authentication/index.md) — TempAuth, Keystone, S3 signatures, console sessions, deploy tokens, and the rules for keeping credentials out of evidence and source control. - [autocos](https://docs.myswift.rs/autocos/index.md) — Repeatable benchmark lifecycle automation over cosbench-rs, Swift, Java COSBench, or mock backends. - [CLI reference](https://docs.myswift.rs/cli-reference/index.md) — Verified command surfaces for swift-deploy-rs, cosbench-rs, and autocos, with safe examples and output boundaries. - [Cold + Contabo S3 delivery](https://docs.myswift.rs/cold-contabo-delivery/index.md) — Historical 2026-08-12/13 delivery note for the LocalDir cold/restore subset and a bounded Contabo S3 matrix. - [Concurrency runtime](https://docs.myswift.rs/concurrency/index.md) — How Peregrine separates async network waits from bounded filesystem and database work, applies backpressure, and proves each serving path. - [Configuration reference](https://docs.myswift.rs/configuration/index.md) — Fail-closed INI loading, the async HTTP worker model, independent concurrency budgets, middleware configuration, and unsupported settings. - [Contributing and development](https://docs.myswift.rs/contributing/index.md) — Source-of-truth rules, safe branches, Rust checks, documentation checks, evidence handling, and review expectations. - [cosbench-rs](https://docs.myswift.rs/cosbench-rs/index.md) — A Rust object-storage load generator for mock, S3, and Swift targets with validated YAML workloads and JSON, CSV, timeline, and HTML reports. - [Deploy](https://docs.myswift.rs/deploy/index.md) — A one-command single-host cluster, a real multi-node deployment, and rolling binary upgrades. - [Dual-oracle verification](https://docs.myswift.rs/dual-oracle/index.md) — The strict 57-case S3 harness — methodology, the GREEN gate contract, the score timeline, and the eight explained residuals. - [Get started](https://docs.myswift.rs/getting-started/index.md) — Build the storage engine, run the test suite, and stand up a single-host cluster in one command. - [Incidents & freezes](https://docs.myswift.rs/incidents/index.md) — The AUTH_test routing incident, the frozen daemon set, leftover-resource policy, and the standing hard boundaries. - [Known limitations](https://docs.myswift.rs/known-limitations/index.md) — Current compatibility, validation, deployment, and operational limits that must remain visible until evidence closes them. - [Lab cluster](https://docs.myswift.rs/lab-cluster/index.md) — Four-node Contabo HA lab layout, EC build requirements, and cutover rules. - [Observability](https://docs.myswift.rs/observability/index.md) — Logs, metrics, recon endpoints, provenance, alerting, and the evidence needed to distinguish a healthy node from an accepted release. - [Operations](https://docs.myswift.rs/operations/index.md) — Health, replication and reconstruction, the node-down HA drill, and EC self-heal. - [Rust vs Python parity](https://docs.myswift.rs/parity/index.md) — Honest feature matrix — partial counts as not implemented. What Peregrine/swift-rust can claim against OpenStack Swift. - [Performance](https://docs.myswift.rs/performance/index.md) — Historical route-labelled throughput and latency evidence, superseded fairness boundaries, and the work still required for G8. - [Philosophy](https://docs.myswift.rs/philosophy/index.md) — Why Peregrine is built the way it is — format fidelity, no runtime Python, sealed deploys, and the Python oracle. - [Production contract (historical)](https://docs.myswift.rs/production-contract/index.md) — Historical implemented-subset contract, retained for scope and rollback context; it is not a current go-live approval. - [Failure recovery](https://docs.myswift.rs/recovery/index.md) — Triage, quarantine, replication and EC repair, database recovery, protected commits, and evidence-safe rollback boundaries. - [Releases & binary history](https://docs.myswift.rs/releases/index.md) — The dated Rust Swift release record, candidate provenance, gate truth, and rollback discipline. - [Runbooks](https://docs.myswift.rs/runbooks/index.md) — The slim rolling proxy upgrade, drain hygiene, rollback, post-change gates, and the publish checklist — as actually executed on the fleet. - [S3 API reference](https://docs.myswift.rs/s3-api/index.md) — The implemented S3 surface — authentication, bucket and object operations, multipart, versioning, object lock, errors, and the Rust-ahead extras. - [Security](https://docs.myswift.rs/security/index.md) — Access control, supply chain, the unsafe surface, and hardening notes. - [Current status — 2026-08-31](https://docs.myswift.rs/status-2026-08-31/index.md) — The dated Rust Swift release snapshot, gate truth, provenance rules, and safe boundary for the next verification run. - [Status 2026-09-15](https://docs.myswift.rs/status-2026-09-15/index.md) — Lab tip 9531eb62 G5-B census snapshot — NOT GREEN; prod untouched. - [Swift API guide](https://docs.myswift.rs/swift-api/index.md) — The native Swift REST surface, request semantics, streaming behavior, middleware boundaries, and how to validate compatibility. - [swift-console](https://docs.myswift.rs/swift-console/index.md) — The web console — files browser, deploy control, live monitoring, and a chaos / HA lab, served from one Rust binary. - [swift-deploy-rs](https://docs.myswift.rs/swift-deploy-rs/index.md) — A Rust-native, fail-closed executor for a pinned Swift Ansible v3 bundle, with sealed plans, preflight checks, and independent safety grants. - [swift-rust](https://docs.myswift.rs/swift-rust/index.md) — The 16-crate storage engine, with compatibility claims scoped to tested OpenStack Swift paths. - [Testing & verification](https://docs.myswift.rs/testing/index.md) — Verification layers, ordered G0-G8 gates, and the current G6/G7 boundary for the Rust Swift family. - [Upgrade and rollback](https://docs.myswift.rs/upgrades/index.md) — A gated, node-by-node workflow for candidate promotion, configuration changes, migrations, and exact rollback. - [G0-G8 validation gates](https://docs.myswift.rs/validation-gates/index.md) — The ordered production-acceptance contract, required evidence, stop conditions, and current red boundary. - [Versioning, WORM & cold tier](https://docs.myswift.rs/versioning-worm/index.md) — Object versioning semantics, delete markers, the version index, Object Lock legal hold and retention, and the honest state of the cold tier. - [Peregrine](https://docs.myswift.rs/welcome/index.md) — A Rust-first OpenStack Swift rewrite with scoped compatibility evidence, deployment tooling, load generation, and a web console.