Vendor the command set the menu and shell depend on

docs/menu.md

@@ -27,8 +27,8 @@ which also keeps them working whichever way the web app question lands.
 
 ## Commands the menu still needs
 
-The tree references 95 commands. 72 are not in `bin/` yet - this is the
-Phase 6 vendor list, grouped by area:
+The tree references 95 commands. All of them are now in `bin/`. What follows is
+kept as the record of what Phase 6 had to fill:
 
 - **audio**: `blob-audio-restart`
 - **bar**: `blob-bar`
@@ -69,3 +69,12 @@ stay.
 `blob-capture-record-webcam` also stays a separate command rather than folding
 into `blob-capture-record --webcam` as planned, because the menu row calls it
 directly and upstream ships it as its own script.
+
+## Status
+
+Every row in this tree resolves to a command in `bin/`. The only unbacked
+`blob-*` names left anywhere in the repo are `blob-launch-webapp` and
+`blob-launch-or-focus-webapp`, both referenced from the `webapp` helper in
+`hypr/default/helpers.lua` and reachable only from a binding that uses
+`{ webapp = ... }`. No such binding ships. They stay as the hook for whichever
+way the web app question lands.

docs/upstream.md

@@ -0,0 +1,42 @@
+# Upstream base
+
+This desktop was forked from Omarchy and no longer tracks it. There is no
+automatic sync. This file exists so a future cherry-pick has a diff base.
+
+| Field | Value |
+| --- | --- |
+| Package | omarchy 4.0.4-1 |
+| Version file | 4.0.0.alpha |
+| Source | https://github.com/basecamp/omarchy |
+| Path forked from | /usr/share/omarchy |
+| Forked on | 2026-09-19 |
+
+## What was taken
+
+| Upstream path | Landed at |
+| --- | --- |
+| `shell/` | `shell/` |
+| `default/hypr/` | `hypr/default/` |
+| `default/themed/*.tpl` | `themed/` |
+| `themes/` | `themes/` |
+| `bin/` (selected) | `bin/` |
+| `default/omarchy/omarchy-menu.jsonc` | `menu/menu.jsonc` |
+
+Upstream carries 441 commands and 39,721 lines of QML/JS. This fork carries the
+subset reachable from the shell, the menu, and the theme system.
+
+## Renames applied
+
+Every identifier was rewritten. `OMARCHY_PATH` to `BLOB_PATH`, `omarchy-*`
+commands to `blob-*`, `omarchy.*` plugin ids to `blob.*`, `org.omarchy.*` app ids
+to `org.blob.*`, and the three state paths from `omarchy` to `blob`. The full map
+is `docs/renames.md`.
+
+## To compare against upstream later
+
+```
+git clone https://github.com/basecamp/omarchy /tmp/omarchy
+cd /tmp/omarchy && git log --oneline v4.0.4..HEAD -- shell/
+```
+
+Apply anything wanted by hand, through the rename map.