From 5873f69459da8a94819f310b7ff92f1b5ebbccab Mon Sep 17 00:00:00 2001
From: zzstoatzz <thrast36@gmail.com>
Date: Thu, 1 Oct 2026 01:45:02 -0500
Subject: [PATCH] Document Strata ownership and independent deployment from
 Stream

---
 strata/README.md             | 24 +++++++++++++++++++++++-
 strata/service/README.md     |  4 ++++
 strata/service/src/index.ts  |  2 +-
 strata/service/src/page.html |  2 +-
 4 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/strata/README.md b/strata/README.md
index 274d466..caa0f98 100644
--- a/strata/README.md
+++ b/strata/README.md
@@ -6,7 +6,29 @@ canvas pan/zoom. It is a static page; counts come from one summary snapshot of
 [Strata](https://strata.zat.dev) taken at deploy time, so visitors make no
 archive, summary, or profile API requests.
 
-## deploy
+## service
+
+The Cloudflare API, D1 schema, R2 archive writer, and drain scripts live in
+[`service/`](service/). The service was imported with its Git history from the
+former local `zat.dev/strata` repository. This directory owns both the map and
+its backing service; they deploy independently.
+
+```sh
+cd strata/service
+npm ci
+npm run check
+npm run deploy
+```
+
+The Worker remains `strata` at `strata.zat.dev`, with the existing D1 database,
+R2 buckets, and secrets. Do not run schema migrations for a source move.
+The hourly ingestion flow stays in `my-prefect-server/flows/strata.py` and
+continues to use the same API. The deployed drain stays at `/opt/strata` on
+the Stream host: its binaries, progress file, and work directory are runtime
+state, not repository files. Deploy script updates there without replacing
+that state. See [service architecture](service/docs/how-it-works.md).
+
+## deploy the map
 
 ```sh
 cd strata && bun install     # once: pinned esbuild and @atcute/lexicons
diff --git a/strata/service/README.md b/strata/service/README.md
index 3932838..af85d44 100644
--- a/strata/service/README.md
+++ b/strata/service/README.md
@@ -5,3 +5,7 @@ from outside: per-segment, per-collection event counts, stored in D1 and
 served by a Worker. the archive process is not involved.
 
 see [docs/how-it-works.md](docs/how-it-works.md).
+
+This is Stream's Strata service. Run commands from this directory:
+`npm ci`, `npm run check`, and `npm run deploy`. See [the parent README](../README.md)
+for the map deployment and existing runtime paths.
diff --git a/strata/service/src/index.ts b/strata/service/src/index.ts
index a4d6833..d693bd0 100644
--- a/strata/service/src/index.ts
+++ b/strata/service/src/index.ts
@@ -388,7 +388,7 @@ export default {
           name: "strata",
           what: "per-segment, per-collection event counts of the stream.waow.tech archive",
           endpoints: ["/api/progress", "/api/heat?step=N&top=N&group=namespaces|collections", "/api/heat?step=N&ns=<authority>", "/api/namespaces", "/api/collections?ns=<authority>", "/api/partitions?ns=<authority>"],
-          source: "https://tangled.org/zat.dev/strata",
+          source: "https://tangled.org/zat.dev/stream/tree/main/strata",
         });
       default:
         return json({ error: "not found" }, 404);
diff --git a/strata/service/src/page.html b/strata/service/src/page.html
index bb89651..4719e28 100644
--- a/strata/service/src/page.html
+++ b/strata/service/src/page.html
@@ -156,7 +156,7 @@ footer a:hover{color:var(--hot);border-bottom-color:var(--water)}
   <a href="../">stream</a>
   <a href="../stats">stats</a>
   <a href="api">api</a>
-  <a href="https://tangled.org/zat.dev/strata">source</a>
+  <a href="https://tangled.org/zat.dev/stream/tree/main/strata">source</a>
 </footer>
 </div>
 <script type="module" src="ui.js"></script>
-- 
2.51.2