move

docs/repository-root/control.md

@@ -0,0 +1,51 @@
+# Control
+
+This repo is the coordination and implementation ground for betterNAS.
+
+Use it for:
+
+- shared contracts
+- architecture and planning docs
+- runtime scripts
+- stack verification
+- implementation of the self-hosted stack
+
+## Current product focus
+
+The default betterNAS product is:
+
+- self-hosted on the user's NAS
+- WebDAV-first
+- Finder-mountable
+- managed through a web control plane
+
+The main parts are:
+
+- `node-service`
+  - `apps/node-agent`
+- `control-server`
+  - `apps/control-plane`
+- `web control plane`
+  - `apps/web`
+- `optional cloud adapter`
+  - `apps/nextcloud-app`
+
+## Rules
+
+- shared interface changes land in `packages/contracts` first
+- `docs/architecture.md` is the canonical architecture contract
+- the self-hosted mount flow is the critical path
+- optional Nextcloud work must not drive the main architecture
+
+## Command surface
+
+- `pnpm verify`
+  - static verification
+- `pnpm stack:up`
+  - boot the self-hosted stack
+- `pnpm stack:verify`
+  - verify the working stack
+- `pnpm stack:down --volumes`
+  - tear the stack down cleanly
+- `pnpm agent:verify`
+  - bootstrap, verify, boot, and stack-verify in one loop