From f7c9ec35b3e444620dc209e722de284200f8e275 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C4=9Bj=20Such=C3=A1nek?= <jsem@matejsuchanek.cz>
Date: Sat, 3 Oct 2026 17:02:38 +0200
Subject: [PATCH 1/3] docs: record the decided Lazurio shell loader in the fork
 runbook

The Lazurio shell decisions of 2026-10-03 keep T3 Code's upstream look and
branding until upstream's stable releases and let the overlay add only a
loader for /.lazurio/shell.js: the rail, the app switch in T3's sidebar and
the Buddy bubble as Web Components, with data from /.lazurio/shell.json on
the Environment's origin. About 20 lines in apps/web, listed in
allowed_upstream_changes; nothing renders outside Lazurio. The runbook
records this as decided, implementation pending.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/operations/lazurio-fork-release.md | 39 +++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/docs/operations/lazurio-fork-release.md b/docs/operations/lazurio-fork-release.md
index 12548ffe7acc..486daa153c2a 100644
--- a/docs/operations/lazurio-fork-release.md
+++ b/docs/operations/lazurio-fork-release.md
@@ -8,6 +8,8 @@ Admin (Matěj, `immakermatty`) ho jen schválí v GitHub environmentu.
 Lazurio Mašiny. T3 vždy běží v kořeni vlastního hostname
 (`https://t3code.<vm>.<org>.lazurio.io/`) za TLS reverse proxy. Oficiální
 desktop a mobilní aplikace se připojují jako neupravení upstream klienti.
+Vzhled a branding webového klienta zůstávají upstream; jediný rozhodnutý zásah
+do jeho UI je načtení shellu Lazuria (viz [Lazurio shell](#lazurio-shell)).
 
 ## Kanál aktualizací
 
@@ -98,6 +100,43 @@ jakoukoli jinou změnu pod těmito cestami CI odmítne. Verze se razítkují jen
 upstream skriptem `scripts/update-release-package-versions.ts`, do Gitu se
 necommitují.
 
+### Lazurio shell
+
+**Rozhodnuto 2026-10-03 (rozhodnutí o shellu Lazuria), implementace čeká.**
+V tabulce overlaye ani v allowlistu zatím není.
+
+V Lazuriu je T3 Code aplikace **Chat** v přepínači Chat · Apps · Automate.
+Overlay do webového klienta přidá jen načtení shellu Lazuria: rail
+Environmentů, přepínač aplikací v sidebaru T3 a plovoucí bublinu Buddyho.
+Shell jsou Web Components se Shadow DOM, takže CSS T3 a Lazuria se navzájem
+neovlivní. Servíruje je Launchpad daného Environmentu na stejném originu, za
+bránou Environmentu:
+
+- `/.lazurio/shell.js` definuje `<lazurio-rail>`, `<lazurio-column-head>`
+  a `<lazurio-buddy>` ve verzi Launchpadu na tom Environmentu. Nový rail proto
+  nepotřebuje nové vydání forku.
+- `/.lazurio/shell.json` drží data: přihlášeného člověka, Environmenty
+  a Organizace, adresy aplikací a barvu Organizace. Fork data Lazuria nezná
+  a sám nic nenačítá.
+
+Patch bude mít zhruba 20 řádků ve zhruba třech souborech `apps/web`:
+`<script type="module" src="/.lazurio/shell.js">` v `index.html`,
+`<lazurio-rail>` vedle kořene aplikace, `<lazurio-column-head>` nahoře
+v sidebaru místo loga upstreamu, `<lazurio-buddy>` v kořeni aplikace
+a `#root { margin-left: var(--lazurio-rail-width, 0); }`. Tyto soubory
+přibudou do `allowed_upstream_changes` jako jeden zdůvodněný záznam a kontrola
+ve forku bude hlídat, že slot (skript a `<lazurio-column-head>`) existuje.
+Při přestavbě na nový upstream tag se pak konflikt ukáže jen v těchto řádcích.
+Přepínač i rail vedou obyčejnými odkazy na jiné originy Environmentu
+(`launchpad.…`, `mausbot.…`), takže router T3 se nemění.
+
+Vzhled a branding zůstávají upstream až do stabilních vydání upstreamu: T3
+Code nepřebarvujeme ani nepřejmenováváme a dál o něm mluvíme jako o T3 Code.
+Mimo Lazurio se nic nevykreslí: bez `/.lazurio/shell.js` (samostatný server,
+vývoj upstreamu) zůstanou elementy nedefinované, šířka railu je 0 a klient se
+chová jako upstream. Oficiální desktop a mobilní aplikace jsou upstream a shell
+nemají.
+
 ## Kdy vydávat
 
 - **Nový upstream stable** (`pingdotgg/t3code` vydal `vX.Y.Z`): přestav

From 0b82a8c1a477be5d6f8a3c24c4eed2ea870972fe Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C4=9Bj=20Such=C3=A1nek?= <jsem@matejsuchanek.cz>
Date: Sat, 3 Oct 2026 17:09:26 +0200
Subject: [PATCH 2/3] Docs: no client Organization names in the public fork
 runbook

The environment-label example and the canary order named client
Organizations in this public repo; they now use a neutral example and
describe the canary order without names.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/operations/lazurio-fork-release.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/operations/lazurio-fork-release.md b/docs/operations/lazurio-fork-release.md
index 486daa153c2a..28b73b70de88 100644
--- a/docs/operations/lazurio-fork-release.md
+++ b/docs/operations/lazurio-fork-release.md
@@ -87,7 +87,7 @@ nabídne normálně.
 | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
 | `hosted: configurable client session TTL`                 | `T3CODE_CLIENT_SESSION_TTL` (Machines nastavuje `365d`).                                                                                                                                                | retain: upstream má pevných 30 dní                                                  |
 | `hosted: serve behind an explicit HTTPS external origin`  | `T3CODE_EXTERNAL_ORIGIN`: server na loopbacku za proxy je dosažitelný zvenku, používá Secure cookie `__Host-t3_session` a mutace a WebSocket upgrady autentizované cookie přijímá jen z tohoto originu. | retain: upstream ekvivalent nemá                                                    |
-| `hosted: explicit environment label`                      | `T3CODE_ENVIRONMENT_LABEL` pojmenuje kontejnerový Workspace (například `Iotor / Management`).                                                                                                           | retain: upstream čte jen `PRETTY_HOSTNAME` a hostname, Machines nastavují proměnnou |
+| `hosted: explicit environment label`                      | `T3CODE_ENVIRONMENT_LABEL` pojmenuje kontejnerový Workspace (například `Acme / Management`).                                                                                                            | retain: upstream čte jen `PRETTY_HOSTNAME` a hostname, Machines nastavují proměnnou |
 | `feat: in-app update from the configured release channel` | `T3CODE_RELEASE_REPOSITORY` a server-advertised `availableServerUpdate`: Mašina nabízí aktualizaci na nejvyšší vydání z nastaveného repozitáře a instaluje ho tlačítkem Update. Navrženo upstreamu.     | retain: upstream má pevné `pingdotgg/t3code` a bere první vydání kanálu             |
 | `release: Lazurio distribution`                           | Tento dokument, `Dockerfile.lazurio`, `.dockerignore`, kontraktní test a workflow `lazurio-fork-ci.yml`, `lazurio-cli-archives.yml` a `lazurio-release.yml`.                                            | retain                                                                              |
 
@@ -255,7 +255,7 @@ změny.
    ```
 
 3. **Canary přes preview.** Vydej preview a na canary Mašinách pod launcherem
-   (Spectoda VM101, Matějova osobní VM, potom další Mašiny) ho nainstaluj přes
+   (nejdřív testovací VM klientské Organizace, potom osobní VM a další Mašiny) ho nainstaluj přes
    SSH s TTY. Lokální `t3 update` nejde přes launcherův trial ani zálohu
    databáze (ty má jen tlačítko Update, #22), proto nejdřív zálohuj databázi:
 

From cf16fa06a2806448ba99e0047e6e0264555942e5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mat=C4=9Bj=20Such=C3=A1nek?= <jsem@matejsuchanek.cz>
Date: Sat, 3 Oct 2026 18:37:27 +0200
Subject: [PATCH 3/3] Docs: rail layout uses border-box padding; one allowlist
 line per file

Addresses the exact-head review of #34:
- upstream #root is width 100% under an overflow-hidden body, so a
  margin-left for the rail would clip the right edge; the runbook now
  specifies a fixed rail and #root { box-sizing: border-box; padding-left:
  var(--lazurio-rail-width, 0px) };
- allowed_upstream_changes takes exact paths, so each changed file is its
  own line under one reason comment.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs/operations/lazurio-fork-release.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/docs/operations/lazurio-fork-release.md b/docs/operations/lazurio-fork-release.md
index 28b73b70de88..ff15793abfd0 100644
--- a/docs/operations/lazurio-fork-release.md
+++ b/docs/operations/lazurio-fork-release.md
@@ -122,10 +122,16 @@ bránou Environmentu:
 Patch bude mít zhruba 20 řádků ve zhruba třech souborech `apps/web`:
 `<script type="module" src="/.lazurio/shell.js">` v `index.html`,
 `<lazurio-rail>` vedle kořene aplikace, `<lazurio-column-head>` nahoře
-v sidebaru místo loga upstreamu, `<lazurio-buddy>` v kořeni aplikace
-a `#root { margin-left: var(--lazurio-rail-width, 0); }`. Tyto soubory
-přibudou do `allowed_upstream_changes` jako jeden zdůvodněný záznam a kontrola
-ve forku bude hlídat, že slot (skript a `<lazurio-column-head>`) existuje.
+v sidebaru místo loga upstreamu a `<lazurio-buddy>` v kořeni aplikace.
+Rail je `position: fixed` u levého okraje a místo pro něj udělá odsazení,
+ne posun: `#root { box-sizing: border-box; padding-left:
+var(--lazurio-rail-width, 0px); }`. `#root` má v upstreamu `width: 100%`
+a `body` `overflow: hidden`, takže `margin-left` by pravý okraj aplikace
+uřízl; s `border-box` se šířka obsahu zmenší o rail. Každý změněný soubor
+přibude do `allowed_upstream_changes` jako vlastní řádek s přesnou cestou
+(například `apps/web/index.html`, `apps/web/src/index.css` a soubor sidebaru),
+pod jedním komentářem s důvodem na začátku bloku. Kontrola ve forku bude
+hlídat, že slot (skript a `<lazurio-column-head>`) existuje.
 Při přestavbě na nový upstream tag se pak konflikt ukáže jen v těchto řádcích.
 Přepínač i rail vedou obyčejnými odkazy na jiné originy Environmentu
 (`launchpad.…`, `mausbot.…`), takže router T3 se nemění.