Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

docs(sharing): record verified production release and cache behavior

deec8ccfef9d0e9
diff --git a/desktop/README.md b/desktop/README.md
index 1d473ec27..cf2874b2d 100644
--- a/desktop/README.md
+++ b/desktop/README.md
@@ -35,10 +35,11 @@ JavaScript/CanvasKit; WebAssembly app compilation is not validated yet.
The entry page inlines Flutter's generated bootstrap to start the app without
an extra loader request. Keep entry pages and release metadata `no-store`.
-Serve static JavaScript, CanvasKit, fonts, and images with ETags and
-`Cache-Control: public, max-age=0, must-revalidate`: browsers reuse unchanged
-bytes while checking for every deployment. Do not use `no-store` for these
-assets or long-lived immutable caching with their unversioned filenames.
+The production host serves JavaScript, CanvasKit and assets from a directory
+containing the release version and archive checksum, with immutable caching.
+Each fresh entry points to that release's assets. This matters because the CDN
+can extend cache lifetimes even when the origin requests revalidation. Local
+previews using stable filenames should use ETags and `max-age=0, must-revalidate`.
The existing backend handles browser OAuth. Local previews on `127.0.0.1`,
`localhost`, or `[::1]` use its existing loopback authorization endpoint, returning
@@ -55,7 +56,7 @@ Use `--dart-define=HARNESS_ANALYTICS_DISABLED=true` for isolated previews.
The Flutter source remains in this package. The existing website deployment in
`autonomous-ai/autonomous-code` serves its compiled files under `/harness-web/`,
-with `/` and `/auth/callback` opening the Flutter app. It also serves the desktop
+with `/`, `/s/:id` and `/auth/callback` opening the Flutter app. It also serves the desktop
downloads and installer redirects.
Push a `vX.Y.Z_web` tag on a tested commit to run **Release web bundle**. CI builds
@@ -64,6 +65,10 @@ with Flutter 3.47.2 and publishes the archive, SHA-256, and
website's `apps/web/harness-web-release.json`, verify the website build, and use
its existing `scripts/release-web.sh` release procedure. Its build checks the
archive's checksum before including it in the image; ArgoCD deploys that image.
+The host configures Flutter's entrypoint, asset and CanvasKit URLs under
+`/harness-web/releases/<version>-<archive-checksum-prefix>/` and does not start
+the deprecated generated service worker. Public routes and the base href stay
+stable; legacy asset paths remain available for tabs opened before deployment.
For a local production build, run `bash scripts/build-web-release.sh X.Y.Z`.
`FLUTTER_BIN` can select an SDK installed outside `PATH`. Output is under
`build/web-release/` and `build/web-dist/`; the ordinary local preview is separate.
diff --git a/docs/plans/2026-09-27-007-share-links-and-comments.md b/docs/plans/2026-09-27-007-share-links-and-comments.md
index dfd7f3e87..5a06f4f93 100644
--- a/docs/plans/2026-09-27-007-share-links-and-comments.md
+++ b/docs/plans/2026-09-27-007-share-links-and-comments.md
@@ -1,5 +1,7 @@
# Share links and comments
+Release versions and final verification: [September 28 release record](2026-09-28-010-sharing-release.md).
+
Requested: share an agent from desktop or web, copy a public or private link, let recipients view in a browser, and add simple collaboration through comments.
Build on existing owner-authorized E2EE observer sharing. Keep terminal input, control leases, resizing, arbitrary files, and other agents out of the observer protocol.
diff --git a/docs/plans/2026-09-27-008-web-release-readiness.md b/docs/plans/2026-09-27-008-web-release-readiness.md
index 49a3d9e85..0c1e77a5e 100644
--- a/docs/plans/2026-09-27-008-web-release-readiness.md
+++ b/docs/plans/2026-09-27-008-web-release-readiness.md
@@ -1,5 +1,7 @@
# Web release readiness
+This development record is followed by the [September 28 release record](2026-09-28-010-sharing-release.md), including the final combined validation and publication versions.
+
User objective: bring the latest desktop features to the web, test the complete browser experience, and prepare the website for a public release. Continue using the shared Flutter source; do not replace feature parity with a separate, reduced web interface.
## Current source and evidence
diff --git a/docs/plans/2026-09-28-010-sharing-release.md b/docs/plans/2026-09-28-010-sharing-release.md
new file mode 100644
index 000000000..134546493
--- /dev/null
+++ b/docs/plans/2026-09-28-010-sharing-release.md
@@ -0,0 +1,44 @@
+# Sharing release — September 28, 2026
+
+Release source: `78b5329e5d80ffc04e45f46866919ff8816c4095`, the merge of sharing PR #394 with readiness PR #395. The shipped backend, CLI, desktop and workflow trees exactly match the validated `d3ff6fee` tree. Main's later hardware documentation changes are also included.
+
+## User flow
+
+Open an agent's **Share** control in desktop or web. Choose **Private**, add invited emails and **Copy link**, or choose **Public** so anyone with the link can watch without signing in. Send the copied link yourself; adding an email does not send an invitation email.
+
+Readers can sign in to comment. Authors can delete their own comments; the owner can moderate, change access, or stop sharing. Shared viewers cannot type into or control the agent. The owner machine must stay online for live viewing and comments.
+
+Browser owners use the same Flutter UI as desktop. This release also includes linked-machine tools, phone setup, API connections, orchestration and interactive managed viewers. The machine picker opens automatically only when no machine connects; it remains available through Alt-M.
+
+## Final validation
+
+- Full native Flutter suite: **3,851 passed, 12 existing skips**.
+- Chrome: **62 passed**, including workspace startup, machine controls, auth, persistent credentials, encrypted observers, terminal framing and trust-group sync.
+- CLI: typecheck and release bundle pass; **45 sharing tests at 100% coverage**, plus **348 transport/owner/crypto tests**.
+- Backend: typecheck passes; **28 sharing tests at 100% coverage**, full suite **573 passed, 11 skipped**. Backend source did not change during the subsequent main merges.
+- Full-stack integration: real backend, disposable loopback MongoDB/Redis, three isolated owner daemons, synthetic accounts and real PTYs. Public/private admission, comments, moderation, denied controls, reconnect, immediate revocation, owner restart persistence and Stop sharing pass. The final rerun exercised the protocol fixture; earlier browser release-build checks also verified UI sign-in return, comments, responsive layout and reload.
+- Production Flutter web archive builds with the production API, `/harness-web/` asset base and bundled CanvasKit. Analysis has no errors or warnings; 12 existing vendored xterm lint notices remain.
+
+Local evidence logs use the `/private/tmp/harness-sharing-final-` prefix. The final full-stack run retained isolated logs in `harness-share-e2e-1qytBC` under the system temporary directory. No real Harness/Codex home or account credentials were used.
+
+## Publication
+
+| Component | Release | Publication |
+| --- | --- | --- |
+| Backend | `v1.2.41_backend` | [CI passed](https://github.com/autonomous-ai/openharness/actions/runs/36378090631); live health and new shared-agent admission response verified. |
+| Owner daemon | `v0.3.19_cli` | [CI passed](https://github.com/autonomous-ai/openharness/actions/runs/36378447028); live CDN update manifest verified. |
+| Desktop | `v1.2.13_desktop` | [CI passed](https://github.com/autonomous-ai/openharness/actions/runs/36378653145); all six macOS/Linux update entries and installer URLs verified. |
+| Flutter web bundle | `v0.1.4_web` | [CI passed](https://github.com/autonomous-ai/openharness/actions/runs/36378116788); archive checksum and embedded source verified. |
+| Website host | `v1.2.21_web` | [CI passed](https://github.com/autonomous-ai/autonomous-code/actions/runs/36379747617); live versioned assets, shared-link entry, callbacks, downloads and installer redirects verified. |
+
+The Flutter archive SHA-256 is `75062b96e51dc920392bf7e47b43f1d8e45566bbdc582531aa61a1865fabafbb`. Hosting source is `719343b7240333d745917e8831d2c6b41ebb6d37` on `deploy/flutter-web`, including hosting PRs #5, #7 and #8. The backend and daemon were verified live before desktop/web publication.
+
+## Returning-browser cache correction
+
+The first website rollout served the new bundle, but an existing browser still ran old JavaScript: the production CDN extended stable app-file URLs to `max-age=432000` despite the origin's revalidation policy. That older app interpreted a shared-agent URL as a workspace and removed the identity fragment. This was caught by the live browser check after the HTTP hosting checks passed.
+
+The host now puts runtime files under `/harness-web/releases/0.1.4-75062b96e51d/` and configures Flutter's JavaScript, assets/fonts and CanvasKit paths to use that archive-specific directory. Entry pages and public URLs stay stable and uncached. The host does not start Flutter's deprecated generated service worker. Legacy asset paths remain available for existing tabs.
+
+Three regression tests verify runtime startup configuration, changing cache keys, and failure on unexpected bootstrap output. The production Next.js build, versioned-asset hosting checks and local browser render pass. The same returning production browser now loads the namespaced JavaScript on an ordinary reload without clearing storage. A complete synthetic share URL preserves its identity fragment and opens the shared-agent access screen; an uninvited account is denied. No real agent was made public during verification.
+
+Final live checks also confirm the unchanged short installer redirect, `https://harness.autonomous.ai/install.sh`, and healthy production API. Refresh the web app or update desktop to **1.2.13** to use **Share → Public/Private → Copy link**. The owner daemon update is **0.3.19**.