Premier commit
Cette révision appartient à :
révision
84a72fe30c
200 fichiers modifiés
+61602
Aucun fichier ne correspond à votre recherche
@@ -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).
|
||||
Référencer dans un nouveau ticket
Bloquer un utilisateur