v0.320.0 released: REPORT, CONTEXT
gates / gates (push) Successful in 52s

Claude-Session: https://claude.ai/code/session_0159rPz1ZhFKsS53msqPYxtS
This commit is contained in:
2026-10-16 15:49:27 +02:00
parent 1296e7aa46
commit c02c9d833a
2 changed files with 52 additions and 88 deletions
+11 -1
View File
@@ -7,7 +7,17 @@
> >
> Ask Claude Code: "Please update CONTEXT.md with what we did today" > Ask Claude Code: "Please update CONTEXT.md with what we did today"
Last updated: 2026-10-16 (v0.319.0 — app page tuning round 2: panels, the login panel, the empty-value rule) Last updated: 2026-10-16 (v0.320.0 — logins and folders: FileBrowser part of the box, one login answer per app, „Fájlok ↗")
> **2026-10-16 — v0.320.0 RELEASED by CC; the global floor 0.320.0 / MinAgent 0.158.1.** A protected infra stack is
> installed by definition on the app page (`Deployed || Protected`; v0.315.0 had shown FileBrowser „not installed" with
> Install and no login); the deploy API and `DeployStack` refuse a protected stack. FileBrowser `operator` state →
> „Új jelszó beállítása" (`stacks.ResetFileBrowserAdminPassword`: its CLI with the server stopped, verify, encrypt,
> `generated`) — pressed on demo-hp; **the N100 waits for the operator's yes**. Every installed app has ONE login answer
> (`web/app_login.go` `loginAnswerFor`; catalog `app_info.login_kind`). „Fájlok ↗" + per-drive media folders; a folder with
> no FileBrowser source is text. Decisions inside the brief (felhom.eu `REPORT-logins-folders-2026-10-16.md` §0): no backup
> sentence on media rows; no data tab for infra; „none" behind the family gate says the family sign-in. Next: R-1100
> (one sign-in), R-1101 (stale FileBrowser password), R-1102 (eight „known password" lines, decision D10).
> **2026-10-16 — v0.319.0 RELEASED by CC; the global floor 0.319.0 / MinAgent 0.158.1.** App page style A (operator > **2026-10-16 — v0.319.0 RELEASED by CC; the global floor 0.319.0 / MinAgent 0.158.1.** App page style A (operator
> 2026-10-16): the hero, the tab bar and every section are panels on `--bg-1`; the install page's form groups use the same > 2026-10-16): the hero, the tab bar and every section are panels on `--bg-1`; the install page's form groups use the same
+41 -87
View File
@@ -1,100 +1,54 @@
# REPORT — v0.319.0: the app page in panels, the login in one place, a password the box never had is said in words (2026-10-16) # REPORT — v0.320.0: FileBrowser is part of the box again, every app says where its login is, a „Fájlok" button (2026-10-16)
Written in ASD-STE100 Simplified Technical English. Task: „app page tuning, round 2" (operator brief, section style **A**). Written in ASD-STE100 Simplified Technical English. Task: „logins and folders" (operator brief). The full report, with
Design read first: felhom.eu `architecture/02-controller-module-map.md` „The app page" (now updated, `[DESIGN]`, the decisions taken, the browser check and the rows: felhom.eu `REPORT-logins-folders-2026-10-16.md`. Design read
operator-approved 2026-10-16). Evidence: felhom.eu `documentation/audits/app-page-tuning-2026-10-16/`. first: felhom.eu `architecture/02-controller-module-map.md` „The app page" (now with „Logins and folders").
Evidence: felhom.eu `documentation/audits/logins-folders-2026-10-16/`.
## 1. Plain words first ## 1. Plain words first
- **Why the Calibre-Web password was empty (Part 0, measured on demo-hp).** Calibre-Web was installed on 2026-08-21. Its - **Why FileBrowser showed „Telepítés":** it has no app.yaml, so the box marks it not deployed. Since v0.315.0 the app
template got the password field on 2026-09-29. The box adds new generated values to installed apps, but never a page read only that mark. Now a protected infra stack is installed by definition on the app page. Its login is back.
`type: password` value. So the box never had one. The user name the box shows IS the real one: a session renamed the - **The Install press could have installed the infra stack as an app** (no guard). Refused now, in the API and in
app's admin to it on 2026-10-01. So nothing was removed from demo-hp. `DeployStack`.
- **The page now:** the header, the tab bar and every section are panels. The open tab is filled and underlined. - **„Új jelszó beállítása":** when the box does not know FileBrowser's password, one press sets a new one with
One „Belépés az alkalmazásba" panel shows the name and the password side by side. If the box has no value, the page FileBrowser's own CLI (server stopped ~3 s), verifies it, and stores it encrypted. Pressed on demo-hp: it works.
says so in a sentence. It never shows an eye that fails. - **Every installed app has „Belépés az alkalmazásba" with one answer;** the catalog's new `app_info.login_kind` picks
- **Other boxes:** the hub lists Calibre-Web telemetry from demo-hp and demo-felhom only. On demo-felhom it is not installed the sentence when the box holds no login.
now (checked on the box). No customer box has this state. - **„Fájlok ↗"** opens one folder of the app in FileBrowser; the data tab lists each drive's media folders.
## 2. Baselines and commits ## 2. Commits and images
controller `8d44416` (v0.318.0) → `d170a2a` (the work) → `7adbbb1` (export panel title and inputs, seen in the browser) `39bf562` (v0.319.0) → `f30a808` (the work) → `1296e7a` (the FileBrowser line's link style, seen in the browser) →
→ `0f82eba` (16px under the hero on the install page) → this docs commit. Built from a clean clone at `0f82eba` with that this docs commit. Built from the clean clone with its own `build.sh`: `0.320.0-rc.1`, `rc.2` (demo-hp only), release
clone's own `build.sh`: test images `0.319.0-rc.1..rc.3` (demo-hp only), release **0.319.0**. **0.320.0** (MinAgent 0.158.1).
## 3. What changed ## 3. What changed
- `web/app_login.go` (new): `loginFieldIndexes` (a `type: password` field plus the `secret`/`text` field with the same - `web/app_page.go`: `installed = Deployed || Infra`; infra tabs settings/guide/logs; data tab and install page 302
prefix and `USER`/`USERNAME`/`EMAIL`), `appLoginFields`, `appSettingRows`, `storedValuePresent`. for infra; the settings tab skips the install form for infra and sets `LoginAnswer`.
- `web/handlers.go`: `deployPageData` gives the tab `LoginFields`, `SettingsRows`, `CurrentHDDLabel`; the reveal - `web/handlers.go` (`appCommonData`): `Infra`, `InfraInfo`, the infra subdomain, `FilesLink`;
handler's 404 branch uses `storedValuePresent`. `appFileBrowserResetHandler`. `web/server.go`: the reset route.
- `app_settings.html`: the login panel; „Cím és kulcsok" as rows (hint under the title, „Tárhely" row, other answers and - `web/app_login.go`: `loginAnswerFor`. `web/datapath_card.go`: media folder rows, `drivePresent`, `filesButtonLink`,
keys as rows); no `app_deploy_fields`, no `deploy-container` (700px) wrapper; every block an `.app-section`. a folder with no source is text. `web/inframeta.go`: `infraMetaIn`.
- `app_data.html`, `app_guide.html`, `app_logs.html`: every block an `.app-section` (screenshots hide their panel when none - `stacks/filebrowser_password.go`: `ResetFileBrowserAdminPassword`, `fileBrowserCLISetPassword`.
loads; export title „Exportálás", inputs in the dashboard style). `stacks/deploy.go` + `api/router.go`: the protected-stack refusal. `stacks/metadata.go`: `AppInfo.LoginKind`,
- `style.css`: style A panels; the install page's `.form-section` and progress panel share the rule. `EffectiveLoginKind`.
- `app_fields.html`: header comment only (the install page is byte-identical). - Templates: `app_settings.html` (one login panel, infra Restart only), `app_shell.html` (infra tagline, „Fájlok ↗"),
- Locales: `app_page.login_title`, `login_desc`, `login_no_password`, `login_no_name`, `value_no`; `app_export.exportalas` `app_data.html` (text rows, the FileBrowser line), `app_guide.html` (infra two lines); `style.css`.
is now „Exportálás" / "Export".
**Pairs (computed by the Go code over the catalog):** calibre-web, kimai (ADMIN_EMAIL), lubelogger, nextcloud, ## 4. Tests and gates
paperless-ngx, radicale. The other 14 password apps show the password alone.
## 4. Tests and red-proofs Red-proved: `TestAppPage_InfraAppHasNoInstall`, `_EveryInstalledAppHasOneLoginAnswer`, `_FilesButtonTarget`,
`_UnknownSourceIsTextNotLink`, `TestFileBrowserReset_SetsVerifiesAndStoresEncrypted`, `_FailedVerifyKeepsOperator`,
`_OnlyInOperatorState`, `TestDeployStack_RefusesProtectedStack` (mutations and failures: felhom.eu
`audits/logins-folders-2026-10-16/redproof.txt`). Also `TestFileBrowserResetEndpoint_Refusals`,
`TestEffectiveLoginKind_DefaultAndUnknown`. Green gate `go build/vet/test ./...` rc 0; `controller_gates.py --fast` all
OK. Parity fixtures: 25 re-captured, 6 new (named in the CHANGELOG); every other one byte-identical.
New, each seen failing by a compiling mutation, then reverted: ## 5. Observations
- `TestAppPage_LoginPairPanel` — pairing loop dropped → fails (name missing).
- `TestAppPage_NoStoredValueShowsSentence` — `Stored: true` always → fails (eye offered, endpoint 404).
- `TestAppPage_SettingsHasNoDuplicateDomain` — install form back in the tab → fails (Domain, deploy-form, HDD_PATH).
- `TestAppPage_OneSectionStyleEverywhere` — logs tab on old markup → fails.
- `TestDeployPage_DeployedSelectShowsStoredHDDPath` (re-targeted to the row) — row reads the default drive → fails.
**Caught by an old test during the work:** removing the deployed-only branches of `app_fields.html` would have put an 1. One sign-in for the dashboard and FileBrowser. FILED: R-1100.
installed app's secret into `/apps/{slug}/install` (that address still answers for an installed app). 2. FileBrowser's stored password goes stale when changed in FileBrowser. FILED: R-1101.
`TestDeployPage_DeployedApp_DoesNotCarryTheSecret` failed; the branches were restored and two parity cases now render 3. Eight apps say „starts with a known, shared password" about a generated or typed login. FILED: R-1102.
them (R-1095 filed for the route). 4. The install button could deploy a protected stack. NOT-A-FINDING: small, fixed in this release with a test.
**Parity fixtures:** 36 app-page fixtures re-captured (the per-task exception): `app_settings_*` (22), `app_data_*` (9),
`app_guide_*` (4), `app_logs`. New: `app_settings_login_not_stored`, `app_settings_login_text_name`, `deploy_installed`,
`deploy_installed_restored`. Every `deploy_new*` fixture and every other fixture byte-identical.
`go test ./...` rc=0 and `controller_gates.py --fast` green before each commit.
## 5. Live validation
- **Browser:** headless Chrome (`chrome-headless-shell` on DooPlex, driven over the DevTools protocol by a small script)
through `https://felhom.enkisfelhom.hu`, signed in through the real login form. Calibre-Web and Paperless, four tabs
each, plus the Grocy install page. Measured: active tab `--bg-2` + 2px `--blue-bright`; hero, tab bar, sections
`--bg-1`; section padding 18px/24px, 16px apart; every section 820px = the column (logs: 966 = the wide column);
login pair two columns, one column at 390px, no side scroll. Console: clean, except one 404 for a screenshot file the
catalog does not have (the panel hides it; see §7). Screenshots: `audits/app-page-tuning-2026-10-16/browser/`, before:
`…/before/`.
- **Release:** per-customer floors 0.319.0 on Tester 1, demo-hp, demo-felhom (303 `floor_set`); all three ran 0.319.0 at
10:34 UTC, the image file written by the update path. Box walk checks green on all three: https-only (`https_only_check.py`
rc 0), 0 unhealthy / restarting / exited / created containers, controller healthy, dashboards 200. Global floor
0.319.0 at 10:35:57 UTC, per-customer floors cleared, read back from the hub DB with its WAL.
## 6. One slip of my own
I first saved the global floor with MinAgent **0.157.0**. The floor before it (0.318.0) carried **0.158.1**, set by the
operator because agent 0.158.0's format wrapper is superseded. I re-saved 0.319.0 / **0.158.1** at 10:37:02 UTC (read
back: `0.319.0=0.158.1`). For 65 seconds the declared MinAgent was lower. No box runs agent 0.158.0 (the hub's hosts:
three on 0.158.1, Tester 2 on 0.142.0 and held), so no box changed. The CHANGELOG header now says 0.158.1.
## 7. Observations
1. `/apps/{slug}/install` answers for an INSTALLED app with the install form read-only.
FILED: R-1095
2. The hub's per-app „Deployments 2" counts telemetry history (demo-felhom no longer has Calibre-Web).
NOT-A-FINDING: the page labels it telemetry; the box was checked directly.
3. `InjectMissingFields` never fills a new `type: password` field for an installed app.
NOT-A-FINDING: inventing a login the app never got is R-757's defect; the page now says it in words.
4. The guide asks for three screenshots; Calibre-Web has two, so the browser logs one 404.
NOT-A-FINDING: designed graceful hiding, unchanged.
5. The data tab's „2. mentés" status grid uses the mono font for values and wraps long text.
NOT-A-FINDING: unchanged markup, outside this brief.
## 8. Teardown
Machine: demo-hp guest 9201 runs 0.319.0 (was 0.318.0 → rc.1..rc.3 by hand, Tier 0); the Part 0 scripts were deleted
from the host and the guest. Host: nothing provisioned. Hub: the per-customer floors are cleared; the global floor is
0.319.0 / 0.158.1. The test tags `0.319.0-rc.1..3` stay in the registry (an rc is never offered to a household).