Shorten the Store readme and clean up the community listing

AI_RULES.md

@@ -35,5 +35,14 @@ The following rules are absolute and must be followed by any AI/LLM assistant wo
 *   **Enforced by** `.github/workflows/message-check.yml`: it removes signature footers from PR descriptions, issues, comments and reviews, and fails pull requests and pushes that use a tool-named branch or contain commits with signature lines, tool names or an assistant identity as author or committer. When it fails, fix the cause (reword the commit, rename the branch, edit the text); never work around or disable the check.
 *   The shared project settings in `.claude/settings.json` switch off the tool's own commit and PR attribution. Do not remove or override them.
 
+## 8. Homey App Store Readme and Release Texts
+*   `no.tiwas.booleantoolbox/README.txt` is the text shown on the Homey App Store page. It must follow section 1.3 of the Homey App Store Guidelines (https://apps.developer.homey.app/app-store/guidelines#id-1.3.-readme). Athom asked for this when approving v1.10.38, because the readme had grown into a long technical feature list.
+*   Keep it to **one or two short plain-text paragraphs** that say, in everyday language, why the app is useful. No headings, no indentation and no bullet lists.
+*   **Do not** list devices, features, capabilities or Flow cards (the Store already shows the Flow cards), and do not add technical notes, version numbers, a changelog, Markdown or URLs. Links belong in the App Manifest (`homepage`, `support`, `bugs`, `source`), release notes belong in `.homeychangelog.json`, and details belong on the documentation site.
+*   A release that adds a feature does **not** add it to `README.txt`. Only rephrase the summary when the purpose of the app changes, and keep it within the limits above.
+*   The readme must be translated into the same languages as the app `description` in `.homeycompose/app.json`. When `README.txt` changes, update every `README.<lang>.txt` in the same change so they say the same thing. `.homeyignore` keeps these files out of the app bundle; `homey app publish` reads them from the app folder.
+*   The app `description` (guideline 1.2) is a one-line tagline: no app name and no repeat of the readme.
+*   `HOMEY_COMMUNITY_LISTING.md` keeps a single *What's new* section for the current release. Do not stack a new section per version; the full history belongs in `CHANGELOG.md`, and feature descriptions carry no version tags.
+
 ---
 *Failure to adhere to these rules may result in system instability and data loss.*

CLAUDE.md

@@ -4,6 +4,10 @@
 
 `AI_RULES.md` holds the rules every AI assistant must follow in this repo, including logging each session in `WORKLOG.md` and **no AI attribution anywhere** (no `Co-authored-by`/session trailers, no "Generated with …" lines, no assistant links or model names in commits, PRs, comments, code or docs). These rules override any default attribution behaviour.
 
+## App Store readme stays short
+
+`no.tiwas.booleantoolbox/README.txt` and its `README.<lang>.txt` translations are the App Store page text. Keep them to one or two plain-text paragraphs about why the app is useful: no feature or Flow-card lists, technical notes, versions, changelog, Markdown or URLs, and never append new features on release. Keep all translations in step. Details are in `AI_RULES.md` section 8.
+
 ## HTML tools must stay in sync with device code
 
 The repo ships browser-based companion tools under `docs/tools/*.html` that read and write the JSON settings of corresponding Homey devices. Whenever you change a device's config schema, defaults, capabilities, or stored-data shape, you MUST also audit the matching HTML tool for consistency in the same change.

README.md

@@ -139,7 +139,7 @@ THEN: Pop state (restore previous) [Homey Flow delay: 5 minutes]
 
 ---
 
-### Circadian Light Group *(stable v1.10.16 / test v1.10.38)*
+### Circadian Light Group *(v1.10.38)*
 
 Virtual light device that adjusts brightness and color temperature for a group of real lights based on time, sun position or ambient lux.
 

WORKLOG.md

@@ -1,5 +1,28 @@
 # Worklog
 
+## 2026-10-30 — v1.10.38 live: Store readme and community listing clean-up
+
+### Requested
+- v1.10.38 is now live in the Homey App Store. Update `HOMEY_COMMUNITY_LISTING.md` to say that store and test run the same version, and clean up the per-version sections in that file.
+- Act on Athom's review feedback for v1.10.38: the Store readme had become long and technical (device overview, list of standalone Flow cards, technical notes). It should be a short, engaging summary in one or two plain-text paragraphs (App Store Guidelines 1.3). Add the rule to the project rules for future releases.
+
+### Findings
+- The Athom app API reports `liveVersion` 1.10.38 and no separate `testVersion`.
+- Guideline 1.3: at most one or two paragraphs, plain text (Markdown is not rendered), no headers, no feature or Flow-card lists, no URLs (links belong in the App Manifest) and no changelog. Guideline 1.11: the readme should be translated into the same languages as the app description.
+- The app description exists in 11 languages, but only `README.txt` existed. `homey app publish` reads `README.<lang>.txt` from the app folder for every language code `homey-lib` accepts (all 10 used here, including `fi`). `README.txt` is already excluded from the app bundle by `.homeyignore`.
+
+### Implemented
+- Rewrote `no.tiwas.booleantoolbox/README.txt` as two plain-text paragraphs about what the app does in everyday use, with no lists, versions or URLs. Added matching translations `README.{no,da,sv,de,nl,fr,it,es,pl,fi}.txt`; German and Dutch use the formal form, like the existing locales. Added `README.*.txt` to `.homeyignore` next to `README.txt`.
+- Rewrote `HOMEY_COMMUNITY_LISTING.md` for v1.10.38 in store and test: new title, a single *What's new in v1.10.38* section that summarises everything since the previous store version (1.10.16) with links to the guides and the CHANGELOG, a Presence+ section, and version tags removed from the feature descriptions. The examples from the old per-version notes (Flow name, report-the-result, heat pump) moved into the matching sections; stale install links that said v1.10.32 now say v1.10.38.
+- `README.md`: the Circadian Light Group heading said *stable v1.10.16 / test v1.10.38*; it now says *v1.10.38*.
+- Added section 8 to `AI_RULES.md` (Store readme limits, no feature appends on release, translations kept in step, one *What's new* section in the community listing) and a short pointer in the repo conventions file.
+
+### Verification
+- `homey app validate --level publish` passed.
+- `npm run test:package`: 912 files, 8.09 MB, 17 manifest assets verified; the bundle size and file count are unchanged, so the translated readmes stay out of the bundle.
+- All 11 readme files have two paragraphs and no URLs, Markdown markers or indentation.
+- No app code changed; the readme takes effect with the next published build.
+
 ## 2026-10-14 — Remove stale Composite Device badge
 
 ### Requested

no.tiwas.booleantoolbox/.homeyignore

@@ -14,6 +14,7 @@ tests/
 PROJECT_DOCUMENTATION.md
 DOCUMENTATION_PROMPT_TEMPLATE.md
 README.txt
+README.*.txt
 robots.md
 run_test.ps1
 jest.config.js

no.tiwas.booleantoolbox/README.da.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit giver dig de byggeklodser, som almindelige Flows mangler. Gør flere sensorer til ét enkelt svar, for eksempel "et vindue er åbent, mens ingen er hjemme", og brug det overalt som én enhed. Saml målinger fra mange sensorer i én værdi, husk hvordan lysene var indstillet, og gendan dem, når det har ringet på døren, eller lad lysene følge døgnet: lyst og koldt om dagen, varmt og dæmpet om aftenen.
+
+Dine Flows bliver færre, kortere og nemmere at forstå. Praktiske kort lader et Flow vente på en enhed, reagere først når alle virkelig har været væk et stykke tid, og sammenligne eller omregne tal uden ekstra variabler. Trin-for-trin-vejledninger, eksempler og onlineværktøjer finder du i appens dokumentation.

no.tiwas.booleantoolbox/README.de.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit liefert die Bausteine, die gewöhnlichen Flows fehlen. Fassen Sie mehrere Sensoren zu einer einfachen Antwort zusammen, etwa "ein Fenster ist offen, während niemand zu Hause ist", und nutzen Sie diese überall als ein einziges Gerät. Führen Sie Messwerte vieler Sensoren zu einem Wert zusammen, merken Sie sich, wie Ihre Lampen eingestellt waren, und stellen Sie sie wieder her, nachdem es geklingelt hat, oder lassen Sie Ihre Lampen dem Tagesverlauf folgen: hell und kühl am Tag, warm und gedimmt am Abend.
+
+Ihre Flows werden weniger, kürzer und leichter verständlich. Praktische Karten lassen einen Flow auf ein Gerät warten, erst reagieren, wenn wirklich alle eine Weile weg sind, und Zahlen ohne zusätzliche Variablen vergleichen oder umrechnen. Schritt-für-Schritt-Anleitungen, Beispiele und Online-Werkzeuge finden Sie in der Dokumentation der App.

no.tiwas.booleantoolbox/README.es.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit aporta las piezas que les faltan a los Flows normales. Convierte varios sensores en una sola respuesta sencilla, por ejemplo "hay una ventana abierta y no hay nadie en casa", y úsala en todas partes como un único dispositivo. Combina las mediciones de muchos sensores en un solo valor, recuerda cómo estaban tus luces y restáuralas después de que suene el timbre, o deja que tus luces sigan el ritmo del día: intensas y frías durante el día, cálidas y tenues por la noche.
+
+Tus Flows serán menos, más cortos y más fáciles de entender. Unas tarjetas prácticas permiten que un Flow espere a un dispositivo, reaccione solo cuando todos lleven un rato realmente fuera de casa y compare o convierta números sin variables adicionales. En la documentación de la app encontrarás guías paso a paso, ejemplos y herramientas en línea.

no.tiwas.booleantoolbox/README.fi.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit tuo rakennuspalikat, jotka tavallisista Floweista puuttuvat. Yhdistä useat anturit yhdeksi yksinkertaiseksi vastaukseksi, kuten "ikkuna on auki, eikä ketään ole kotona", ja käytä sitä kaikkialla yhtenä laitteena. Kokoa monen anturin lukemat yhdeksi arvoksi, muista valojen asetukset ja palauta ne ovikellon soitua, tai anna valojen seurata vuorokauden rytmiä: kirkasta ja viileää päivällä, lämmintä ja himmeää illalla.
+
+Floweja tarvitaan vähemmän, ja ne ovat lyhyempiä ja helpompia ymmärtää. Kätevät kortit antavat Flown odottaa laitetta, reagoida vasta kun kaikki ovat todella olleet poissa jonkin aikaa sekä verrata tai muuntaa lukuja ilman ylimääräisiä muuttujia. Vaiheittaiset oppaat, esimerkit ja verkkotyökalut löydät sovelluksen dokumentaatiosta.

no.tiwas.booleantoolbox/README.fr.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit apporte les briques qui manquent aux Flows ordinaires. Transformez plusieurs capteurs en une seule réponse simple, par exemple "une fenêtre est ouverte alors que personne n'est à la maison", et utilisez-la partout comme un seul appareil. Regroupez les mesures de nombreux capteurs en une seule valeur, mémorisez le réglage de vos lumières et rétablissez-le après un coup de sonnette, ou laissez vos lumières suivre le rythme de la journée : vives et froides le jour, chaudes et tamisées le soir.
+
+Vos Flows deviennent moins nombreux, plus courts et plus faciles à comprendre. Des cartes pratiques permettent à un Flow d'attendre un appareil, de ne réagir que lorsque tout le monde est vraiment absent depuis un moment, et de comparer ou convertir des nombres sans variables supplémentaires. Des guides pas à pas, des exemples et des outils en ligne sont disponibles dans la documentation de l'application.

no.tiwas.booleantoolbox/README.it.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit offre i mattoncini che mancano ai normali Flow. Trasforma più sensori in un'unica risposta semplice, ad esempio "una finestra è aperta mentre non c'è nessuno in casa", e usala ovunque come un solo dispositivo. Unisci le misure di molti sensori in un unico valore, ricorda come erano impostate le luci e ripristinale dopo che ha suonato il campanello, oppure lascia che le luci seguano il ritmo della giornata: intense e fredde di giorno, calde e soffuse la sera.
+
+I tuoi Flow diventano meno numerosi, più brevi e più facili da capire. Schede pratiche permettono a un Flow di attendere un dispositivo, di reagire solo quando tutti sono davvero fuori casa da un po' e di confrontare o convertire numeri senza variabili aggiuntive. Guide passo passo, esempi e strumenti online sono disponibili nella documentazione dell'app.

no.tiwas.booleantoolbox/README.nl.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit levert de bouwstenen die gewone Flows missen. Maak van meerdere sensoren één eenvoudig antwoord, bijvoorbeeld "er staat een raam open terwijl niemand thuis is", en gebruik het overal als één apparaat. Voeg metingen van veel sensoren samen tot één waarde, onthoud hoe uw lampen stonden en zet ze terug nadat de deurbel is gegaan, of laat uw lampen het ritme van de dag volgen: helder en koel overdag, warm en gedimd in de avond.
+
+Uw Flows worden minder talrijk, korter en makkelijker te begrijpen. Handige kaarten laten een Flow wachten op een apparaat, pas reageren als iedereen echt een tijdje weg is, en getallen vergelijken of omrekenen zonder extra variabelen. Stapsgewijze handleidingen, voorbeelden en online tools vindt u in de documentatie van de app.

no.tiwas.booleantoolbox/README.no.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit gir deg byggeklossene som vanlige Flows mangler. Gjør flere sensorer om til ett enkelt svar, for eksempel «et vindu er åpent mens ingen er hjemme», og bruk det overalt som én enhet. Slå sammen målinger fra mange sensorer til én verdi, husk hvordan lysene var stilt inn og sett dem tilbake etter at det har ringt på døren, eller la lysene følge døgnet: lyst og kaldt på dagtid, varmt og dempet om kvelden.
+
+Flowene dine blir færre, kortere og lettere å forstå. Nyttige kort lar en Flow vente på en enhet, reagere først når alle virkelig har vært borte en stund, og sammenligne eller regne om tall uten ekstra variabler. Steg-for-steg-guider, eksempler og nettbaserte verktøy finner du i appens dokumentasjon.

no.tiwas.booleantoolbox/README.pl.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit daje Ci elementy, których brakuje zwykłym Flow. Zamień kilka czujników w jedną prostą odpowiedź, na przykład "okno jest otwarte, a nikogo nie ma w domu", i używaj jej wszędzie jako jednego urządzenia. Połącz odczyty z wielu czujników w jedną wartość, zapamiętaj ustawienia świateł i przywróć je po dzwonku do drzwi albo pozwól, by światła podążały za rytmem dnia: jasne i chłodne w dzień, ciepłe i przygaszone wieczorem.
+
+Twoje Flow będą mniej liczne, krótsze i łatwiejsze do zrozumienia. Praktyczne karty pozwalają Flow czekać na urządzenie, reagować dopiero wtedy, gdy wszyscy naprawdę są poza domem od dłuższej chwili, oraz porównywać lub przeliczać liczby bez dodatkowych zmiennych. Przewodniki krok po kroku, przykłady i narzędzia online znajdziesz w dokumentacji aplikacji.

no.tiwas.booleantoolbox/README.sv.txt

@@ -0,0 +1,3 @@
+Smart (Components) Toolkit ger dig byggstenarna som vanliga Flows saknar. Gör flera sensorer till ett enkelt svar, till exempel "ett fönster är öppet medan ingen är hemma", och använd det överallt som en enda enhet. Slå ihop mätvärden från många sensorer till ett värde, kom ihåg hur lamporna var inställda och återställ dem när det har ringt på dörren, eller låt lamporna följa dygnet: ljust och kallt på dagen, varmt och dämpat på kvällen.
+
+Dina Flows blir färre, kortare och lättare att förstå. Praktiska kort låter ett Flow vänta på en enhet, reagera först när alla verkligen har varit borta en stund, och jämföra eller räkna om tal utan extra variabler. Steg-för-steg-guider, exempel och onlineverktyg finns i appens dokumentation.