Repository navigation
Releases
v0.3.0
Restore Rehearsal v0.3.0
Restore Rehearsal is an open-source, local-first tool for two connected jobs:
- Backup restore testing — restore a declared backup into a disposable Docker Compose stack,
verify it, rehearse a candidate upgrade, keep share-safe evidence, and remove the stack. - Private Project Brain — statically scan any dedicated project folder, with or without Git,
into one local.rrbrainSQLite file for architecture, dependencies, tests, deployment,
recovery evidence, findings, decisions, failed attempts, and structural history.
This is an alpha prerelease. It can be used in commercial projects under Apache-2.0, but it
must not be the sole production release gate, disaster-recovery control, security assessment,
accessibility certification, or legal/compliance decision.
Highlights
- Scan websites, native apps, CLIs, APIs, documentation, data projects, infrastructure folders,
source repositories, and mixed local projects without executing their code. - Explore Graph, Changes, Findings, Recovery, Evidence, and Timeline views in a self-contained
offline visualization with no remote scripts, fonts, analytics, or network requests. - Query focused context, relationship-derived change impact, relevant tests, memories, and prior
recovery evidence from the command line or the local read-only-by-default MCP server. - Import bounded evidence from SARIF, CycloneDX/SPDX, JUnit, LCOV/Cobertura, OpenAPI, Terraform,
Kubernetes, and CI artifacts while discarding secrets and high-risk raw content. - Install nine portable Agent Skills for Project Brain, safe initialization, universal inspection,
change impact, evidence import, recovery adapters, restore rehearsals, release readiness, and
plugin authoring. - Propose non-executing recovery adapters for PostgreSQL, MySQL/MariaDB, SQLite, MongoDB,
object-storage exports, and managed-service export handoffs.
Install
Python 3.11 or newer is required. Project Brain, inspection, imports, skills, adapters, and MCP do
not require Git or Docker. Executing restore drills additionally requires Linux, Docker Engine,
and Docker Compose v2.
uv tool install "git+https://github.com/Someone006/Restore-Rehearsal.git@v0.3.0"
rehearse --versionThe release also includes a universal wheel, source distribution, fully hashed Homebrew formula,
CycloneDX and SPDX SBOMs, and SHA256SUMS.
Privacy and safety
Restore Rehearsal collects no telemetry and does not upload project data, reports, screenshots, or
backup contents. API keys, credentials, tokens, private keys, and backup contents must never be
uploaded. Any other outbound project, report, screenshot, personal, or customer information
requires explicit user approval for a named destination and scope.
Restore drills execute only reviewed commands declared in a recipe and require an isolated,
disposable environment. Read the
safety model before
configuring a drill.
Learn more
Rehearse 0.2.1 — Any local project
Project Brain now scans any dedicated local project folder; Git and Docker are optional for brain-only use.
Highlights:
- deterministic, bounded filesystem inventory for non-Git folders;
- Git-aware inventory with support for scanning a project subdirectory;
- nested
.gitignoresupport in plain folders and nested.rehearseignoreprivacy exclusions in every mode, including tracked paths; - no symlink following, cross-device refusal, strict file/directory/depth/ignore budgets, and expanded sensitive-path protection;
- inventory-mode metadata and accurate local-sensitive-file findings;
- standalone CLI plus both bundled Agent Skills at version 0.2.1;
- direct dependency license inventory in
THIRD_PARTY.md.
Verification: Python 3.11 and 3.12 CI, installed-wheel smoke tests, 59 unit tests, and the real Docker restore/upgrade/cleanup integration drill all pass.
Commercial use is allowed under Apache-2.0. This remains an alpha prerelease; teams should review the documented threat boundary and commercial-readiness checklist before production adoption.
Install:
uv tool install "git+https://github.com/Someone006/Restore-Rehearsal.git@v0.2.1"
Rehearse 0.2.0 — Project Brain
Adds the local one-file Project Brain, offline visualization, durable decision/failure memory, ten evidence-backed review lenses, expanded Agent Skill installation, and CI coverage for Python 3.11/3.12 plus the real Docker restore drill. Apache-2.0 permits commercial use; this release remains alpha and should not be the sole production, legal, accessibility, or disaster-recovery gate.