FR Contribuer Decisions

Décisions et ADR

English · Type : référence · Public : contributeur · Contexte : dépôt du moteur · Statut : prête · S'applique depuis : 4.5.0

Un index des décisions consignées du projet : les décisions datées du mainteneur (D1 à D50) et les ADR, les enregistrements de décisions d'architecture (ADR 0001 à 0030). Les deux vivent dans la documentation publique de développement, docs/dev/, en anglais ; cette page les indexe, elle ne les recopie pas. Les titres des ADR ci-dessous sont ceux des fichiers, en anglais.

Où elles vivent

Registre	Fichier	Ce qu'est une entrée
Décisions	docs/dev/DECISIONS.md	Une ligne par décision, datée, écrite par l'assistant qui l'a reçue, jamais sans décision humaine ; les mots du mainteneur cités (souvent en français, avec l'anglais à côté)
ADR	docs/dev/adr/	Un fichier par décision qui semble surprenante sans son contexte : le contexte, la décision, ce qu'elle coûte, ce qui la ferait changer
L'échange	docs/dev/LOG.md	Des entrées numérotées, datées, jamais réécrites (propositions, relectures, réponses) qui mènent aux décisions

DECISIONS.md se termine par une liste « Pending (asked, not decided) » ; au 23 octobre 2026 elle dit « (none) ». Il n'y a pas de D6 : la numérotation passe de D5 à D7.

Les ADR

ADR	Décision
0001	The DOM is the reference renderer
0002	Content is data; code a game needs is trusted and named
0003	The solver runs the real engine
0004	A session is the unit of reproduction
0005	A save is read back before it counts
0006	A double tap acts with the verb a player means
0007	Biscuit authorises a connector; a signature attests an event (4.1.1)
0008	A connector is a process of its own, behind one small SDK (4.1.9)
0009	The Bridge keeps its state behind an asynchronous RealityStore (4.1.10)
0010	SignalV2: a signed signal names the context it was signed for (4.1.10)
0011	A scene frame, intentions and a semantic journal (4.1.11)
0012	Canvas 2D stays the complete backend; WebGL/Pixi not measured in 4.1.11
0013	One intermediate representation of a game (GameIR) and its fingerprint (4.1.12)
0014	Objectives and the quest journal, the one primitive family admitted in 4.1.12
0015	A search stores its states by index, with exact interned keys (4.1.13 "Solver Research")
0016	A run clock that observes, a seeded generator, a chained proof of a run (4.1.14)
0017	Speedrun verdicts and trust levels (4.1.14)
0018	A variation manifest compiles to an immutable world (4.1.15)
0019	A run is bound to the world it was played in (4.1.16)
0020	A minigame's result is computed again from its transcript (4.1.17)
0021	A backup is one snapshot; a restore is all or nothing (4.1.19)
0022	The player chooses the hero: variant names, text switches, portraits in a choice (4.3.0)
0023	A backup says what it holds; a restore says its mode (4.1.20)
0024	A pass is bound to its surface, and carried only by a signed attestation (4.1.20)
0025	One shared game, edited live: transactions, one owner per file, revisions (4.2.1)
0026	Saves across revisions: the envelope unchanged, a question before resuming (4.2.2)
0027	The Studio Server's identity: OIDC for who, the Studio for what (4.2.1)
0028	Where a hosted Studio runs the game's code: a worker without secrets (4.2.1)
0029	The remote MCP: the same checks as the API, by going through it (4.2.3)
0030	The documentation is generated from one source in the repository, and published per release (4.5.0)

Les décisions du mainteneur, par période

Une ligne chacune ; le texte complet, avec les mots du mainteneur, est dans DECISIONS.md.

Décisions	Dates	Ce qu'elles tranchent
D1–D4	4 oct. 2026	La v3 peut casser la v2, chaque rupture avec sa migration (D1) ; le modèle de branches de la v3 (D2) ; le mainteneur tranche chaque désaccord et l'échange est committé dans docs/dev/, en anglais (D3) ; le but : une v3 à laquelle un petit studio ferait confiance (D4)
D5, D7–D9	4 oct. 2026	Le jeu entier hors ligne après la première visite (D5) ; main est la branche de release après la v3.0.0, WebKit bloquant après trois exécutions vertes (D7) ; le jeu privé de référence reste en 3.1.0 (D8) ; une branche à la fois, fusionnée sur CI verte, relue ensuite (D9)
D10–D13	5 oct. 2026	Un rendu Canvas 2D à côté de celui du DOM (D10) ; les versions 3.3.1 à 3.5 (D11) ; les barrières humaines rapportées, non bloquantes (D12) ; le chapitre de référence reprend l'art de la démo (D13)
D14–D17	6 oct. 2026	La ligne 4.1.x avant la 4.2 (D14) ; l'enveloppe signée du Reality Bridge (D15), Biscuit sur le Bridge seulement (D16), Server-Sent Events, pas de WebSocket (D17)
D18–D29	7–8 oct. 2026	Le programme 4.1.8–4.1.15 (D18) ; les connecteurs en processus séparés (D19) ; le stockage du Bridge (D20) ; le rendu n'est pas une source d'état (D21) ; le DSL stabilisé puis gelé (D22, D28) ; LiveSplit et OBS en local (D23) ; l'horloge du run observe (D24) ; les stratégies de Remix, les graines Mystery et Daily, la variance de présentation (D25–D27) ; une catégorie de speedrun nomme son monde (D29)
D30–D37	8–14 oct. 2026	La signature des tags repoussée à la 4.2 (D30) ; le résultat d'un mini-jeu prouvé (D31) ; 4.1.18, 4.1.19, 4.1.20 (D32–D34) ; une passe qualifie une surface (D35) ; deux modes de restauration (D36) ; la racine de confiance est la clé logicielle du mainteneur, chaque tag signé demande son propre oui explicite (D37)
D38–D46	15–20 oct. 2026	La 4.2.0 sort avant les passes humaines, sur un périmètre stable réduit (D38) ; le Studio Server en trois correctifs 4.2.x, hébergé derrière OIDC (D39–D41) ; les choix de la 4.2.2 et de la 4.2.3 (D42–D45) ; des champs facultatifs de présentation seulement en 4.2.x (D46)
D47–D50	20–23 oct. 2026	Le projet devient quest'n'click (D47) ; main est la ligne 4.3 (D48) ; la 4.3 « Hero Choice » (D49) ; la documentation passe à un wiki généré depuis wiki/, et le oui pour signer la v4.5.0 (D50)

Identifiants liés

• Gouvernance : qui décide, et comment une décision est consignée.
• Architecture relie les ADR qui fondent la conception du moteur.

---

Modifier la source de cette page · Signaler une erreur