Monorepo for Aesthetic.Computer
aesthetic.computer
docs: codify ac-os oven as the canonical OTA path
ac-os upload is a local-build fallback that stashes uncommitted work in
ways that can strand changes outside fedac/native/ (its cleanup
git-checkout is scoped to that subdir). The remote oven flow is what
ships releases.aesthetic.computer/os/ under normal operation.
Surfaced in CLAUDE.md and fedac/native/SCORE.md so agents land on
ac-os oven before reaching for upload.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+39
-4
+18
-1
CLAUDE.md
+18
-1
CLAUDE.md
···
101
101
102
102
### AC Native OS (fedac/native/)
103
103
104
+
**Routine OTA releases are built remotely on the oven.** When fedac/native/
105
+
changes land on `origin/main`, oven's git poller auto-triggers a build. To
106
+
trigger or observe a build explicitly:
107
+
108
+
```bash
109
+
ac-os oven # Trigger remote OTA build for HEAD
110
+
ac-os oven status # Show oven queue + recent builds
111
+
ac-os oven watch # Tail active build logs (SSE)
112
+
ac-os oven cancel # Cancel active oven job
113
+
```
114
+
115
+
**Use `ac-os oven` for OTA releases — not `ac-os upload`.** `ac-os upload`
116
+
is a local-build-and-push fallback that requires a clean tree and has
117
+
historically auto-stashed uncommitted work in ways that strand changes.
118
+
119
+
Local-only commands (rarely needed for OTA):
120
+
104
121
```bash
105
122
# Full build pipeline: binary → initramfs → kernel
106
123
ac-os build
···
108
125
# Build + flash USB
109
126
ac-os flash
110
127
111
-
# Build + upload OTA release (ALWAYS rebuilds first)
128
+
# Build + upload OTA release (legacy local path — prefer `ac-os oven`)
112
129
ac-os upload
113
130
114
131
# Build + flash + upload
+21
-3
fedac/native/SCORE.md
+21
-3
fedac/native/SCORE.md
···
14
14
15
15
## Release Procedure
16
16
17
-
### Quick commands (fish shell)
17
+
### Default path: remote OTA via oven (preferred)
18
+
19
+
OTAs are built remotely on `oven.aesthetic.computer`. After landing
20
+
fedac/native/ changes on `origin/main`, the oven git poller auto-triggers
21
+
a build — but you can also trigger and observe explicitly:
18
22
19
23
```bash
20
-
ac-os build # Build binary + initramfs + kernel
24
+
ac-os oven # Trigger remote OTA build for HEAD (or push to main)
25
+
ac-os oven status # Show oven build queue + last builds
26
+
ac-os oven watch # Tail logs for the active oven build (SSE)
27
+
ac-os oven cancel # Cancel the active oven job
28
+
```
29
+
30
+
**This is the path agents should use.** Do NOT run `ac-os upload` to ship an
31
+
OTA — that is the legacy local-build-and-push path; it requires a clean tree
32
+
and has historically clobbered uncommitted work via auto-stash. The oven
33
+
flow is the source of truth for `releases.aesthetic.computer/os/`.
34
+
35
+
### Local commands (rarely needed)
36
+
37
+
```bash
38
+
ac-os build # Build binary + initramfs + kernel locally
21
39
ac-os flash # Build + flash USB
22
-
ac-os upload # Upload current build as OTA release
40
+
ac-os upload # Local-build + push to OTA CDN (NOT for routine OTAs — use `ac-os oven`)
23
41
ac-os flash+upload # Build + flash + upload
24
42
```
25
43