Premier commit

Cette révision appartient à :
Théo Gastinel a révisé 2026-10-11 01:54:18 +02:00
révision 84a72fe30c
200 fichiers modifiés
+61602

Aucun fichier ne correspond à votre recherche

+274
Voir le fichier
@@ -0,0 +1,274 @@
# Phase 28 - Faconnage generique et diegetique (implementation, Agent 2/4)
Session sans supervision du 2026-09-27. Conception de reference :
`NOTES-PHASE28-DESIGN.md`. Sauvegarde des sources avant la phase :
`_Vercora_backups\avant-phase28-20260927-0403`.
**Resultats** : tests headless **3636 -> 3807** (+171), tous verts.
Build Debug OK. Lancement court du jeu : **0 `[Validation]`** au demarrage
(PID arrete explicitement). `run_vulkan_check.ps1` et mesures de performance
NON lances (role de l'Agent 4).
## Architecture reelle
- **`src/world/Crafting.hpp/.cpp`** (sans Vulkan) : generalisation de
`knapStones`.
- `kRecipes` : table `constexpr` de 8 recettes `{id, label, in[3], inCount,
hasOutput, out, station, effect, successMessage}`. Ingredient =
`{kind, count, source Carried|Placed, consumed}` (`consumed=false` = outil).
- `craftAt(inventory, ground, hearths, pos, facing, nowHours)` : collecte
les objets POSES portables a `kCraftReach = 2,5 m` (nouvelle
`Ground::indicesWithin`), les postes (foyer allume / eteint a
`kStationReach = 2 m` du joueur), puis execute la PREMIERE recette
satisfaite. Verification complete avant tout retrait ; retraits Ground par
indices decroissants ; produit au barycentre des ingredients poses
consommes, sinon a 1,1 m devant (meme projection/repli que knapStones).
- Refus : recette "la plus proche" = moins d'unites manquantes, puis plus
d'unites deja reunies, puis la plus simple (plus loin dans la table). Le
message liste ce qui manque ("a porter" / "a poser a moins de 2,5 m" /
"un foyer allume ... (il faut chauffer)"). Si la plus proche est la
percussion, le message historique `knapResultMessage(NotEnoughStones)`
est rendu mot pour mot.
- `HearthSet` : etat de combustion A PART du Ground (modele ResinStand).
Foyer identifie par sa POSITION (les indices Ground ne sont pas stables).
Temps = heures de JEU (`GameClock::totalHours`). `update()` eteint les
foyers echus et depose **une cendre** au centre. `relight`, `feed`,
`remainingHours`, `nearest`.
- `chooseKindToPutDown` / `putDown` : le geste "reposer".
- **`src/world/CraftMesh.hpp/.cpp`** : 5 meshes bas-poly generes en code
(ligature = anneau, hache = manche + lame + ligature, foyer = 3 pierres +
2 branches croisees + fond noirci, cendre = tas gris plat, poix = galette
brun-noir). Dimensions absolues, bas du mesh a -rayon (teste).
- `knapStones` (Knapping.cpp) **inchange** : facade testee ; la recette
`knap` en reproduit le resultat au bit pres (test dedie).
## Recettes (ordre = priorite)
| id | ingredients | poste | produit / effet |
|---|---|---|---|
| `hearth` | 3 pierres posees + 2 branches posees (consommees), eclat PORTE (outil) | - | Foyer (fixe) ALLUME, 1 h de jeu |
| `hearth_relight` | 2 branches posees + eclat porte (outil) | foyer eteint | foyer rallume 1 h |
| `axe` | eclat + branche + ligature, POSES | - | Hache (au sol, ramassable) |
| `pitch` | 2 resines + 1 cendre, POSEES | foyer allume | Poix |
| `cord` | 3 fibres PORTEES | - | Ligature a 1,1 m devant |
| `hearth_feed_log` | 1 buche posee | foyer allume | +1 h de combustion |
| `hearth_feed_branch` | 1 branche posee | foyer allume | +1 h de combustion |
| `knap` | 2 pierres portees (1 consommee, 1 outil) | - | Eclat (Phase 6) |
## Nouveaux `GroundItemKind` (ajoutes EN FIN d'enum)
`Cord, Axe, Hearth, Ash, Pitch` ; `kGroundItemKindCount` 8 -> **13**. Mis a
jour : rayons + 3 libelles (`Ground.cpp`), table `groundMeshes` (`main.cpp`),
test de la table de rendu (`testDrawListConstruction`), nouvelle fonction
`groundItemIsPortable` (faux pour `Hearth` seul) utilisee par `findNearest`.
`Inventory::summary()` : les 8 matieres toujours affichees (comportement et
test anterieurs), les objets faconnes seulement si leur compteur est non nul.
## Controles
- **C** : faconner (inchange pour la percussion : deux pierres en poche et
rien de pose autour => meme resultat, memes messages).
- **P** (nouveau) : reposer au sol, 0,9 m devant, le dernier type ramasse s'il
en reste, sinon la premiere nature portee. Decalage en spirale d'angle d'or
(0,25 m x sqrt(n)) pour ne pas superposer les objets. Coupe en mode demo,
en vol, a velo, en escalade et en editeur, comme C et R.
- Combustion des foyers avancee a chaque image si l'horloge avance (horloge
gelee => feu fige) ; extinction journalisee.
## Decisions (non specifiees, prises par defaut)
1. **Touche P et non "R maintenu"** (proposition du §4 de la conception) : le
ramassage se declenche a l'APPUI de R ; un maintien aurait d'abord ramasse
puis repose. P est a la meme position en AZERTY et QWERTY.
2. **Foyer eteint = reste en place** (objet fixe) et peut etre **rallume**
(recette `hearth_relight`) : sans cela le test "poix refusee foyer eteint"
n'aurait pas d'objet, et un cercle de pierres qui disparait serait
invisible pour le joueur. Chaque extinction laisse UNE cendre.
3. **Portee du poste mesuree depuis le joueur** (2 m), pas depuis les
ingredients. Plus simple a lire en jeu et a tester.
4. **Alimentation** : n'importe quelle branche/buche POSEE a 2,5 m du joueur
avec un foyer allume a 2 m (le "1 m du foyer" de la conception n'a pas ete
retenu : une seule regle de portee). Consequence documentee : une branche
isolee posee pres d'un feu est brulee au prochain C si aucune recette plus
complexe n'est satisfaite.
5. **Duree 1 h de jeu, +1 h par alimentation** (valeurs proposees par la
conception), dans `HearthParams`. Pas de plafond.
6. **Pas de lumiere ni de flamme** : un seul mesh de foyer, allume ou eteint
(le renderer n'a pas de lumiere ponctuelle, §4 de la conception).
7. **Pas de sauvegarde** (aucune n'existe). `Recipe::id` stables et temps en
heures de jeu pour la suite.
8. `CraftMesh.cpp` recopie un helper de facette plutot que de modifier
`HarvestMesh.cpp` (zero risque de regression sur les meshes Phase 22).
9. Aucun fichier de `data/` touche.
## Points d'accroche pour l'Agent 3 (NON branches)
- **Chaleur** : `HearthSet::warmthAt(pos)` (pure, testee : 8 C au centre,
lineaire jusqu'a 0 a 6 m, 0 si eteint ; `HearthParams::warmthC/warmthRadius`).
A ajouter dans `main.cpp` apres `needsContext.ambientTemperatureC =
localWeather.temperatureC;` : `+= hearths.warmthAt(playerPosition)`.
`hearths` est declare dans `main.cpp` a cote de `inventory`.
- **Hache** : `inventory.count(GroundItemKind::Axe) > 0` ; `Forest::scheduleBucking`
n'a PAS ete modifie (bonus de buches a ajouter, defaut 0).
- **Abri** : rien (recette P6 non implementee) ; `groundItemIsPortable` est
pret pour un futur `Shelter` fixe.
- Scenario Vulkan K (conception §3.7) non ecrit.
## Fichiers touches
Nouveaux : `src/world/Crafting.hpp`, `src/world/Crafting.cpp`,
`src/world/CraftMesh.hpp`, `src/world/CraftMesh.cpp`, `NOTES-PHASE28.md`.
Modifies : `src/world/GroundItem.hpp`, `src/world/Ground.hpp`,
`src/world/Ground.cpp`, `src/world/Inventory.hpp`, `src/main.cpp`,
`CMakeLists.txt`, `tools/run_logic_tests.bat`, `tests/logic_tests.cpp`,
`MEMORY.md`.
## Tests ajoutes (`tests/logic_tests.cpp`)
`testCraftingRecipeTable` (ids, ordre, recettes, rayons/libelles/meshes de
toutes les natures, resume), `testCraftingKnapUnchanged` (percussion = knapStones
au bit pres, message de refus historique, regard vertical sans NaN),
`testCraftingCord`, `testCraftingHearth` (construction, eclat conserve,
barycentre, non ramassable, combustion, extinction + cendre, rallumage,
alimentation, chaleur), `testCraftingAxe` (ingredients non contigus
entrelaces, refus octet pour octet, porte vs pose, portee 2,6 m),
`testPitchNeedsLitHearth` (sans foyer, foyer eteint, foyer trop loin,
succes et consommation exacte), `testPutDown`. `testStoneKnapping` et
`testNeeds` inchanges.
---
# Agent 3/4 - effets branches (2026-09-27)
**Resultats** : tests headless **3807 -> 3877** (+70), tous verts. Build Debug
OK (tests + jeu). Lancement court (25 s, PID arrete explicitement) :
**0 `[Validation]`**. `run_vulkan_check.ps1` et mesures NON lances (Agent 4).
## Effets branches (tous sur des systemes EXISTANTS)
| Objet | Branchement | Chiffres |
|---|---|---|
| Foyer allume | `main.cpp` (bloc besoins) : `needsContext.ambientTemperatureC += hearths.warmthAt(playerPosition)` juste apres l'ambiante meteo | +8 C au centre, lineaire -> 0 a 6 m, somme des foyers allumes, 0 si eteint |
| Hache | `forest->setBuckingBonusLogs(axeBonusLogs(inventory))` avant `forest->update` ; `Forest::scheduleBucking` ajoute les buches | +1 buche par arbre (3..5 au lieu de 2..4) |
| Hache renforcee (P5, NOUVELLE) | recette `pitched_axe` : hache + poix POSEES ; meme branchement | +2 buches (pas de cumul avec la hache : le meilleur outil) |
| Abri (P6, NOUVEAU) | recette `shelter` : 4 buches + 6 branches + 2 ligatures POSEES ; `needsContext.sheltered = ground && shelterNear(*ground, playerPosition)` (premier appelant) | abrite a <= 2,5 m horizontal, tolerance verticale 3 m ; effet Needs existant : +5 C ressentis et vent annule |
**Interaction ambiante / Needs verifiee dans le code** (`Needs.cpp:171-205`) :
l'ambiante recue devient `lastAmbientC_` (journal "ambiante"), puis refroidissement
eolien (`windChillC`, seulement < 10 C et vent > 4,8 km/h, annule si abrite),
+ effort, - epuisement, + 5 C si abrite, puis marge au confort (12 C). La chaleur
du foyer passe donc par la MEME formule que la meteo, aucune seconde formule.
Le foyer rechauffe l'air AVANT le vent (le vent mord moins sur un air plus chaud).
## Decisions
1. **Poix** : la conception prevoit P5 (hache + poix -> +2 buches). Implementee
comme recette + nouvelle nature `PitchedAxe` (mesh = hache + manchon de poix).
Sans hache, la poix reste un ingredient (aucun autre effet).
2. **Hache jamais requise pour abattre** : `fell()` inchange ; bonus 0 par
defaut ; les buches bonus sont tirees APRES les buches de base et avant les
branches, avec des tirages RNG seulement si bonus > 0 -> sans hache, suite
aleatoire et journal ("Debitage en cours : N buches") identiques.
3. **Bonus lu au moment du debitage** (fin de l'amortissement), pas au coup
d'abattage : c'est l'outil porte a ce moment qui compte.
4. Buches bonus rangees a 1 m sur le cote du tronc (alternance gauche/droite),
jamais au-dela de la hauteur de l'arbre.
5. **Ordre de la table** (10 recettes) : `shelter, hearth, hearth_relight,
pitched_axe, axe, pitch, cord, hearth_feed_log, hearth_feed_branch, knap`.
6. **Abri NON solide** : pas de collision ajoutee (la conception la jugeait
necessaire ; l'ajouter touchait le CollisionSolver compose -> risque de
regression refuse en session sans supervision). Le joueur traverse l'abri.
7. Abri FIXE (`groundItemIsPortable` faux), mesh appentis 2,1 x 1,8 x 1,2 m
(`kShelterRadius = 0,6`), pose au barycentre, yaw = regard du joueur.
8. Deux assertions anterieures mises a jour (volontairement) : 8 -> 10 recettes,
13 -> 15 natures ; table de rendu du test (`testDrawListConstruction`) completee.
9. Aucun fichier de `data/` touche.
## Tests ajoutes
`testHearthWarmthEffect` (0/1,5/3/6/20 m, Needs recoit 2+6 C, jauge plus
haute pres du feu, eteint = identique au froid, rallume, deux feux additionnes),
`testAxeYieldEffect` (bonus 0/1/2, `buckingLogCount`, abattage reel 12 m :
4/5/6 buches et toujours 4 branches, abattage sans hache OK), `testShelterEffect`
(refus atomique ligature manquante, construction, barycentre, non ramassable,
portee 2,4/2,6 m, survol, ressenti > +5 C, mesh), hache renforcee.
## Pas fini / pour l'Agent 4
- Scenario Vulkan K (feu / abri au clavier) non ecrit ; A..H non relances ici.
- Collision de l'abri ; lumiere du foyer (renderer sans lumiere ponctuelle).
- Pot d'argile (P7) non fait.
- Fichiers touches : `GroundItem.hpp`, `Ground.cpp`, `Crafting.hpp/.cpp`,
`CraftMesh.hpp/.cpp`, `Forest.hpp/.cpp`, `main.cpp`, `tests/logic_tests.cpp`.
---
# Verification (Agent 4/4) - 2026-09-27
Protocole : avant chaque etape lourde, `Get-Process` sur vercora, cmake,
ninja, cl, msbuild, cargo et rustc (aucun trouve a chaque fois). Une seule
execution a la fois (lecon de la Phase 26). Aucun processus tue. `data\`
n'a pas ete touche. Aucune modification de code (aucun bug de la Phase 28 trouve).
## Resultats MESURES
| Point | Resultat |
|---|---|
| Tests headless (`tools\run_logic_tests.bat`) | **3877 / 3877**, code de retour 0 |
| Avertissements `/W4` des tests | 1 seul : `main.cpp(1280) C4244` (double -> float, `ortho.metresPerTexel()`), **anterieur** : meme ligne en 1268 dans la sauvegarde (Phase 27). Zero dans les fichiers de la Phase 28 |
| Build jeu (`clean` puis `tools\build.bat` Debug) | OK, 82/82, **zero** `warning C` |
| Suite Vulkan complete, passage 1 | 0 `[Validation]`, 0 `[ERROR]`, 4 `[WARN]` (les memes qu'avant), fermeture propre partout ; A B D E F G1-3 H I J J3 OK ; **C : arbre MANQUE** -> `[ECHEC]` |
| Suite Vulkan complete, passage 2 | identique : 0 `[Validation]`, seul C echoue, meme cause |
| `run_vulkan_check.ps1 -Only C` | **OK** : arbre abattu, 6 objets ramasses, 0 `[Validation]` |
**Diagnostic de C (harnais, pas Phase 28)** : le jeu repond "aucun arbre dans la
ligne de visee". Arrivee de la navigation a 0,82 m puis 0,84 m de la cible
(echecs) contre 0,75 m (succes). Dans le journal brut, la camera diverge
DES LE PREMIER PAS entre la Phase 27 et maintenant (x = -5,05 contre -4,97),
avant toute logique neuve ; `pickTree`, `fell`, `Camera`, collision : zero
ligne modifiee (diff). C'est la limite du canal d'entree deja mesuree
(MEMORY, Phase 26 : ~0,8 m, 0,78 abattu / 0,80 manque). **Aucune execution
complete n'a donc ete verte de bout en bout** ; chaque scenario a ete vert
au moins une fois sur le binaire final.
## Performance (mesuree, Debug + validation, meme harnais)
Comparaison des 14 lignes `Cadence de boucle (PHASE 27)` du journal brut de
la suite de la Phase 27 (`%TEMP%\vercora_run_20260924-175538.log`) et du
passage 1 (`vercora_run_20260927-043937.log`), processus par processus (us/image) :
5760->5343, 5623->4759, 6395->5532, 6685->5992, 5848->5646, 4147->3976,
1852->1804, 1689->1632, 2113->2135 (+1 %), 2096->2092, 7127->6347,
7024->6101, 4788->4030, 7030->6913. **Aucune regression** : 13 sur 14
egaux ou plus rapides, un seul a +1 % (bruit). NON mesure : Release, A/B
entrelace (`profile_phase27.ps1`) - sans foyer ni abri le cout ajoute par
image est une boucle `shelterNear` sur les objets du sol et un
`warmthAt` sur une liste vide.
## Non-regression par relecture (diff sauvegarde -> actuel)
Fichiers modifies : `main.cpp`, `Forest.cpp/.hpp`, `Ground.cpp/.hpp`,
`GroundItem.hpp`, `Inventory.hpp`, `CMakeLists.txt`, `run_logic_tests.bat`,
`logic_tests.cpp` (+790, aucune ligne retiree) ; nouveaux `Crafting.*`,
`CraftMesh.*`. **Aucune ligne changee** dans Weather, Needs, Wildlife,
Habitat, Paraglider, Bike, Climber, CollisionSolver/Camera, StoneMesh, shaders.
- Taille de pierre : `kStoneRadius`/StoneMesh intouches ; ordre de l'enum 0..7 conserve.
- Abattage sans hache (A) : `fell` intouche ; `buckingLogCount(h,0)` = ancienne
formule ; boucle bonus sans tirage RNG si bonus 0 ; message "Debitage" identique
a bonus 0. Scenario A vert dans les deux passages (2 arbres, 8 ramassages, 1 percussion).
- Needs : `+ warmthAt` = +0 sans foyer ; `sheltered` passe de "jamais ecrit"
(defaut false) a `shelterNear` = false sans abri. Scenario H vert.
- Percussion : message de succes identique mot pour mot (harnais : "eclat
tranchant se detache" trouve). Seule difference de journal : la ligne
"Inventaire : ..." dit "un eclat est au sol" au lieu de "l'eclat est au sol".
- `findNearest` ignore les objets fixes (Hearth, Shelter seulement).
- Remarque cosmetique : le BOM UTF-8 de `main.cpp` a disparu ; ses seuls octets
non ASCII sont dans des commentaires (l. 899-900), sans effet sur le binaire.
- Comportement neuf a connaitre (voulu, non bug) : C avec 3 fibres en poche fait
une ligature AVANT la percussion ; une branche posee pres d'un feu allume est
brulee au prochain C.
## Pas fini (inchange)
Collision de l'abri (le joueur le traverse) ; pot d'argile (P7) ; lumiere du
foyer (pas de lumiere ponctuelle dans le renderer) ; scenario Vulkan K (feu/abri
au clavier) non ecrit ; flakiness de navigation du scenario C (harnais).