Remove run source tree from browser repo

2026-07-14 17:23:06 +08:00
parent 4f33f761a3
commit a57a5dbfcf
61 changed files with 118 additions and 5402 deletions
@@ -0,0 +1,25 @@
+# Design
+
+## Repository Boundary
+
+The browser repository remains responsible for `platform/`, `platform_web/`, and `plugins/`. The machine-side executor implementation is owned by `git@git.npc0.com:admin343/run.git`.
+
+Browser-side code can still expose platform APIs for run endpoints, jobs, logs, artifacts, and runtime package distribution. Those are platform contracts, not embedded run implementation code.
+
+## Local Development
+
+Local debug workflows use `RUN_REPO_DIR` to find an external run checkout. The default points to `../run`, matching a sibling clone beside this repository:
+
+```bash
+git clone git@git.npc0.com:admin343/run.git ../run
+```
+
+If `RUN_REPO_DIR` is missing or does not contain a run `go.mod`, local debug scripts fail with a clear message instead of assuming `browser/run`.
+
+## Docker Compose
+
+The compose file keeps the run service for all-in-one local deployment, but its build context points at `${RUN_REPO_DIR:-../run}` and uses the external repository's `Dockerfile`.
+
+## Structure Validation
+
+`scripts/check-structure.sh` validates browser-owned roots only. It no longer requires run source paths.