+
## Production failures should make your system smarter.
**Traces tell you what happened. ControlSurface helps you decide what to do next.**
@@ -110,14 +120,6 @@ Group recurring production failures by execution signature and open a representa
-
-Watch the 12-second real-product walkthrough
-
-
-
-
-
-
## What ControlSurface does
| Area | Working capability |
diff --git a/ROADMAP.md b/ROADMAP.md
index d204cf1..3aef5c4 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -26,9 +26,8 @@ Remaining release work is intentionally narrow:
1. Run GitHub Actions on the exact candidate commit in the remote repository.
2. Review the final staged diff and repeat secret/naming scans after staging.
-3. Capture a concise real-product hero demo from the synthetic refund workflow.
-4. Complete artifact-specific license/SBOM review before publishing Python or container artifacts.
-5. Tag `v0.1.0-rc.1` only after the remote pipeline is green.
+3. Complete artifact-specific license/SBOM review before publishing Python or container artifacts.
+4. Tag `v0.1.0-rc.1` only after the exact remote candidate is green and the final launch review is approved.
## v0.2: always-on reliability automation
diff --git a/SUPPORT.md b/SUPPORT.md
new file mode 100644
index 0000000..a7092b6
--- /dev/null
+++ b/SUPPORT.md
@@ -0,0 +1,19 @@
+# Support
+
+ControlSurface is an early open-source release candidate. The fastest path to useful help is to choose the channel that matches the problem.
+
+## Questions and setup help
+
+Use [GitHub Discussions](https://github.com/DevChiniwala/ControlSurface/discussions/categories/q-a) for installation, configuration, instrumentation, and workflow questions. Include the ControlSurface version, deployment method, operating system, and sanitized diagnostics.
+
+## Reproducible defects
+
+Open a [bug report](https://github.com/DevChiniwala/ControlSurface/issues/new?template=bug.yml) when current behavior differs from documented behavior and can be reproduced. Search existing issues first.
+
+## Security vulnerabilities
+
+Follow [SECURITY.md](SECURITY.md) and use a [private security advisory](https://github.com/DevChiniwala/ControlSurface/security/advisories/new). Never publish a credential, exploit, sensitive trace, prompt, model output, customer record, or other private telemetry in an issue or discussion.
+
+## Operational emergencies
+
+The public repository does not provide a commercial support SLA or an emergency response channel. Operators remain responsible for backups, retention, access controls, TLS termination, and recovery procedures described in [docs/OPERATIONS.md](docs/OPERATIONS.md).
diff --git a/docs/RELEASE_AUDIT.md b/docs/RELEASE_AUDIT.md
index 0d8dcc3..5d1fc22 100644
--- a/docs/RELEASE_AUDIT.md
+++ b/docs/RELEASE_AUDIT.md
@@ -1,10 +1,10 @@
# v0.1.0-rc.1 release audit
-Audit date: 2026-09-27
+Audit date: 2026-09-28
Scope: local source tree and locally built Linux/amd64 Compose artifacts
-Status: **local and GitHub Actions release-candidate checks pass; binary distribution packaging remains**
+Status: **engineering candidate checks pass; launch-only changes require exact-commit remote verification; binary distribution packaging remains**
This record reports executed checks. It is not a promise that defects cannot exist, a security certification, or legal advice.
@@ -22,8 +22,8 @@ This record reports executed checks. It is not a promise that defects cannot exi
| Check | Result |
| --- | --- |
| Ruff lint and format (server, SDK, example, tests, benchmarks, scripts) | Pass |
-| mypy (server, SDK, recovery operator) | Pass, 23 source files |
-| Backend and SDK unit tests | Pass, 57 tests |
+| mypy (server and SDK) | Pass, 22 source files |
+| Backend and SDK unit tests | Pass, 59 tests |
| TypeScript type check | Pass |
| ESLint | Pass |
| Prettier | Pass |
@@ -112,10 +112,8 @@ Known limits remain: trusted-host/single-owner model, best-effort free-text reda
## Release decision
-The exact source candidate at `8d3f1b795f7d1aeeb1fb8fe4b1cce37897744295` passed both remote jobs in [GitHub Actions run 36322748409](https://github.com/DevChiniwala/ControlSurface/actions/runs/36322748409). It is ready for a **public source release candidate** after these product-release actions:
+The engineering candidate at `8d3f1b795f7d1aeeb1fb8fe4b1cce37897744295` passed both remote jobs in [GitHub Actions run 36322748409](https://github.com/DevChiniwala/ControlSurface/actions/runs/36322748409). A captioned 70-second real-product demo has since been recorded from the synthetic refund workflow, and the repository's launch governance and public presentation have been prepared.
-1. Record the planned short real-product hero demo.
-2. Change repository visibility only when Dev Chiniwala is ready for public disclosure.
-3. Tag `v0.1.0-rc.1` from the verified source candidate after the public-release decision.
+The final launch commit must pass `quality` and `hero-e2e` again before tagging. Tag `v0.1.0-rc.1` only from that exact verified commit after Dev Chiniwala approves the final launch review.
Not approved by this audit: public Python package publication, public container publication, production HA claims, or hosted multi-tenant operation.
diff --git a/docs/assets/readme/hero-demo.gif b/docs/assets/readme/hero-demo.gif
index 95f277d..119c481 100644
Binary files a/docs/assets/readme/hero-demo.gif and b/docs/assets/readme/hero-demo.gif differ
diff --git a/docs/assets/social/controlsurface-social-preview.png b/docs/assets/social/controlsurface-social-preview.png
new file mode 100644
index 0000000..02e4fdd
Binary files /dev/null and b/docs/assets/social/controlsurface-social-preview.png differ
diff --git a/docs/assets/social/controlsurface-social-preview.svg b/docs/assets/social/controlsurface-social-preview.svg
new file mode 100644
index 0000000..3a2d18a
--- /dev/null
+++ b/docs/assets/social/controlsurface-social-preview.svg
@@ -0,0 +1,40 @@
+
diff --git a/docs/releases/v0.1.0-rc.1.md b/docs/releases/v0.1.0-rc.1.md
new file mode 100644
index 0000000..86c8318
--- /dev/null
+++ b/docs/releases/v0.1.0-rc.1.md
@@ -0,0 +1,29 @@
+# ControlSurface v0.1.0-rc.1
+
+First public release candidate of ControlSurface, an open-source production engineering platform for AI agents.
+
+## Highlights
+
+- OTLP-native agent tracing with source spans and AgentRunGraph projections.
+- Production Health and AI-specific SLO evaluation.
+- Deterministic structural failure clustering.
+- Incidents with inspectable Change Ledger evidence.
+- Production-derived, human-reviewed regression cases.
+- Paired candidate evaluation.
+- Reproducible release gates with content-addressed evidence.
+
+## Run it locally
+
+Follow the [Quickstart](../../README.md#quickstart) to start the supported Docker Compose deployment, create the owner, and send the first trace.
+
+The [refund-agent lifecycle](../../examples/refund_agent/README.md) demonstrates healthy traffic, a breaking tool-schema update, failure clustering, incident evidence, regression review, a fixed candidate, and a passing release gate.
+
+## Release status
+
+This is an early source release candidate. Docker Compose is the supported V1 self-hosting path. The trust model is a trusted single owner on a trusted host; see [Security and telemetry privacy](../../SECURITY.md) and [Operations](../OPERATIONS.md).
+
+Public Python-package and container-image distribution are intentionally deferred until the artifact-specific license bundle is complete. The tag includes source archives generated by GitHub; the full real-product demo is attached to the release separately.
+
+## Verification
+
+The tagged commit must pass the `quality` and `hero-e2e` GitHub Actions checks and a clean-volume Compose boot before this release is published. Detailed evidence is maintained in the [release audit](../RELEASE_AUDIT.md).
+
+
+