Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ jobs:
assets/
retention-days: 14

# Each complete opening gets a clean runner and the original bounded budget.
# Each complete opening gets a clean runner and a bounded software-render budget.
# Both matrix entries are required; every shard also verifies the lab import.
sessions:
name: sessions (${{ matrix.opening }})
Expand All @@ -49,7 +49,7 @@ jobs:
matrix:
opening: [classic, comp-60]
runs-on: ubuntu-latest
timeout-minutes: 25
timeout-minutes: 28
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v6
Expand All @@ -62,7 +62,7 @@ jobs:
- run: pip install playwright==1.57.0
- run: python -m playwright install --with-deps chromium
- run: python -u tests/playtest_browser.py --opening "${{ matrix.opening }}"
timeout-minutes: 22
timeout-minutes: 25
- name: Capture exact session sources
if: always()
run: |
Expand Down
49 changes: 49 additions & 0 deletions .github/workflows/visual-finish.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
name: Phase 4 visual finish
on:
push:
branches: [feat/phase4-visual-finish]
pull_request:
paths: ['src/scene/**', 'scripts/assets/**', 'tests/visual*', '.github/workflows/visual-finish.yml']
workflow_dispatch:
permissions:
contents: read
jobs:
native:
name: native (${{ matrix.section }})
strategy:
fail-fast: false
matrix:
section: [proof, measures]
runs-on: ubuntu-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@v6
with: {fetch-depth: 0}
- uses: actions/setup-node@v6
with: {node-version: '22'}
- uses: actions/setup-python@v6
with: {python-version: '3.12'}
- run: npm run check && npm test && npm run build
- run: npm run assets:export && node scripts/assets/export-civic.mjs && node scripts/assets/export-harmony.mjs && node scripts/assets/export-finish.mjs && npm run assets:review
- run: pip install playwright==1.57.0 && python -m playwright install --with-deps chromium
- name: Pinned actual main baseline
run: |
mkdir -p test-results/visual-baseline
git archive b5f547c97ce8387f1c31b25bef3a29952d0a94a7 | tar -x -C test-results/visual-baseline
- run: python -u tests/visual_finish_browser.py --section "${{ matrix.section }}"
timeout-minutes: 15
- name: Exact source
if: always()
run: |
git rev-parse HEAD > test-results/visual-finish/commit.txt
git archive --format=tar -o source.tar HEAD
- uses: actions/upload-artifact@v4
if: always()
with:
name: phase4-visual-${{ matrix.section }}
path: |
source.tar
dist/
assets/
test-results/visual-finish/
retention-days: 14
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -17,3 +17,6 @@ assets/districts/
assets/civic/

assets/waterfront/

assets/harmony/
assets/finish/
72 changes: 72 additions & 0 deletions docs/assets/PHASE4_VISUAL_FINISH.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Phase 4 — ville assemblée, matériaux et effets

## Base et périmètre

Base : `main b5f547c97ce8387f1c31b25bef3a29952d0a94a7`, fusion de la PR #9. Livraison sur `feat/phase4-visual-finish`, PR #10 en brouillon, sans nouvelle fusion. La branche d'équipe `feat/engagement-rhythm-0-7` reste indépendante. Les règles, le réseau, l'UI, le laboratoire, les 28 cases et les cinq workflows préexistants sont conservés. Les scripts et assertions des tests antérieurs ne sont pas remplacés.

« AAA » désigne une ambition, pas une qualité certifiée. Même dans une scène développée, la référence illustrée possède une continuité urbaine, une densité et une étendue d'eau plus grandes. Cette passe ne prétend pas les avoir reproduites. Les vues de départ conservent les terrains vacants, sans argent ni bâtiments privés offerts pour embellir les captures.

## Modèles et intégration

Jardins 4–5 : maison à terrasses plantées et orangeraie vitrée à belvédère. Nova 18–19 : campus vertical à ailettes et observatoire à tambour/coupole. Solstice 25–26 : palazzo à portique et résidence à volumes décalés. Les variantes changent de silhouette et de volume, pas seulement de couleur. Chaque bien dispose de l'état vacant, des niveaux 0–3 et de deux LOD ; origine au centre, Y vers le haut, façade principale en +Z. La projection existante assure l'orientation, l'état hypothéqué, le fanion du propriétaire et l'activité.

Roseraie 22–23 conserve son générateur et ses géométries. Les lots Marina, Rivage, Horizon et Ateliers sont réutilisés. Le casino conserve son architecture avec une frise intégrée plus lisible. La promenade et la fontaine ne sont pas refaites.

Le pavillon municipal remplace l'ancien volume aux mêmes coordonnées : ouvertures profondes, portique, fronton, tambour vitré et coupole profilée. Les deux portails de métro possèdent marches, murets, garde-corps, verrières courbes et un petit M intégré. Leurs cheminements, plantations, bancs et lampes forment un maillage public partagé par LOD, sans empiéter sur les cases.

## Matériaux et VFX

`src/scene/finish/shader.js` fournit une réponse stylisée commune en espace linéaire, éclairage direct et hémisphérique, spéculaire GGX/Schlick pour les surfaces brillantes, réflexion de ciel analytique et courbe de sortie filmique. Il ne s'agit pas d'une chaîne PBR complète avec HDRI/GI. Les surfaces mates évitent le calcul d'un lobe spéculaire peu perceptible. Le bassin conserve son reflet planaire borné ; la nappe extérieure emploie des ondulations analytiques et un fondu spatial vers le fond. Aucun bloom ou flou plein écran n'est ajouté.

Un atlas RGBA8 256² encode micro-normales et rugosité des huit surfaces existantes. Le mode bas ne l'échantillonne pas ; les textures restent partagées. Un autre atlas RGBA8 256² encode les contacts et les petites zones de lumière au sol. Ce champ se reconstruit lors des changements immobiliers, pas à chaque frame ou lancer de dés. Ce n'est pas du SSAO ni de la GI. Les quatre sources analytiques de proximité sont conservées ; les lampes supplémentaires ne créent pas de nouvelles shadow maps.

Les transitions économiques existantes déclenchent un ruban de construction, une poussière légère et des gerbes teintées. Petits triangles regroupés, animation au vertex shader, âge en uniforme : aucun upload par particule ou par frame. Quatre constructions visibles maximum en haut, deux en bas ; poussière seulement en haut ; deux célébrations simultanées. Les effets disparaissent en mode mouvements réduits ou ville figée. Ils ne créent ni monnaie, ni commande réseau, ni récompense. L'état du mélange alpha et de l'écriture de profondeur est restauré après les effets.

## Budgets des modèles effectivement générés

| Modèle/famille | Maximum de triangles bas / haut |
|---|---:|
| Jardins, un bien | 2 748 / 4 644 |
| Nova, un bien | 2 908 / 4 912 |
| Roseraie conservée, un bien | 2 534 / 4 362 |
| Solstice, un bien | 3 024 / 5 188 |
| Pavillon municipal | 2 119 / 3 583 |
| Un portail de métro | 564 / 700 |
| Cheminements et mobilier nouveaux | 4 592 / 6 340 |

Les silhouettes, toits et ouvertures visibles ont priorité sur les micro-objets. Un bien est un maillage indexé plus son fanion. Le lot public est un seul maillage par LOD. Le cache Harmony est limité à 16 maillages et 4 Mio, sans évincer un modèle visible. Les huit variantes actives au détail haut totalisent au maximum 3 616 392 octets ; les LOD inactifs les moins récents sont supprimés. Les autres lots gardent leurs caches bornés.

Ressources GPU ajoutées : 349 525 octets pour le détail avec mipmaps, 262 144 pour le champ au sol, soit environ 597 Kio. Ce dernier possède une copie CPU de 256 Kio. Les buffers géométriques, leur copie CPU de restauration, l'atlas du plateau, les ombres, le reflet, le framebuffer et les allocations inconnues du pilote sont comptés séparément. Le mode bas libère la shadow map et la cible de reflet ; le changement de qualité et la restauration du contexte restent testés.

Les GLB sont des exports d'échange des mêmes modèles natifs, pas des téléchargements obligatoires au démarrage. Les matériaux glTF de base sont exportés ; un lecteur générique ne reproduit pas les shaders natifs ou le champ de lumière. Le PNG RG-normal/B-rugosité est un format empaqueté pour ce moteur, pas une normal map glTF directement branchable.

## Régénérer et vérifier

```sh
npm run check
npm test
npm run build
npm run assets:export
node scripts/assets/export-civic.mjs
node scripts/assets/export-harmony.mjs
node scripts/assets/export-finish.mjs
npm run assets:review
```

Sources : `src/scene/harmony/extensions.js`, `src/scene/finish/`, `scripts/assets/`. Exports : `assets/harmony/`, `assets/finish/`, et kits précédents. Galerie : `assets/districts/review.html`. Les binaires reproductibles sont dans les artefacts CI et la livraison, pas dupliqués dans Git.

Le workflow `visual-finish.yml` sépare preuve et mesures. L'avant est le vrai `main b5f547c9`, servi sur une autre origine, pas une fonction qui masque des objets. `civicFixtures()` et `waterfrontFixtures()` fournissent des historiques légaux déterministes. Dimensions 1600 × 1000, DPR 1, état, horloge et caméra identiques dans chaque paire. Caméra principale : angle 0,5, inclinaison 0,85, zoom 1, cible normale. Les vues obliques (inclinaison 0,63 / zoom 1,12) et le zoom 1,5 restent accessibles au joueur. Les vues studio servent seulement de complément.

Le diagnostic ABBA bas/haut, figé/animé, conserve six mesures après deux chauffes par bloc. Une lecture synchrone d'un pixel mesure rendu logiciel et synchronisation, pas le seul GPU matériel. Les nouvelles ressources sont testées après perte de contexte, au repos et pendant les transitions. Les scénarios WebRTC complets Classique et comp-60 restent séparés, avec leurs assertions et délais de convergence d'origine. Seule la limite globale de l'étape CI passe de 22 à 25 minutes (job borné à 28 minutes), car le rendu logiciel simultané de quatre navigateurs a dépassé l'ancien budget de quelques secondes.

## Défauts trouvés pendant la mise au point

La première preuve native a montré une eau extérieure trop striée et un contraste insuffisant derrière le titre inchangé. Les ondulations et le fondu spatial ont été corrigés. La galerie a révélé un réexport non supporté par le bundler ESM minimal : import/export explicite et test syntaxique sur les bundles produits ajoutés.

Le code `86108430` a mesuré un surcoût SwiftShader de 45–49 % par rapport au vrai main. Un premier allègement du shader n'a pas démontré de gain ; ne pas annoncer de non-régression temporelle ou de performances mobiles. La suite quartiers a également observé 18 949 206 octets de buffers après des zooms, dépassant la limite de 18 Mio. La borne en octets du cache corrige ce problème ; le seuil du test n'est pas relevé. Les résultats des anciennes exécutions échouées ne constituent pas une validation finale. Consulter le commit effectivement testé et ses rapports dans la PR #10.

Les journaux du run `34158220245` montrent la progression continue de la session Classique, 147 commandes, trace vérifiée et import du laboratoire réussi, avant une conclusion CI timeout à 22 minutes. La session comp-60 a également exporté ses 147 commandes avant son interruption. Ces sorties ne sont pas présentées comme une CI réussie ; la nouvelle limite globale est bornée, les contrôles fonctionnels et leur ordre sont inchangés, et toute la recette est relancée.

## Matériel restant à tester

Aucun téléphone physique, Safari/iOS, réseau mobile/TURN, batterie ou essai humain n'est validé ici. Sur appareils réels, noter modèle, OS, navigateur, résolution/DPR, qualité, température et alimentation. Exécuter les mêmes états jour/crépuscule, trois passages de 60 secondes après chauffe, puis 10 minutes animées. Relever distributions des intervalles de frames, longues tâches, chargement, transitions, mémoire, arrière-plan et restauration. Utiliser un compteur GPU seulement s'il est disponible et non disjoint. Le protocole détaillé `PHASE3_DEVICE_PROTOCOL.md` reste applicable. L'émulation tactile valide uniquement l'affichage et les interactions.
13 changes: 13 additions & 0 deletions scripts/assets/export-finish.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
/** Exchange files for the implemented public models and generated shared textures. */
import {mkdir,writeFile,readFile} from 'node:fs/promises';
import {createHash} from 'node:crypto';
import {createPublicAsset,PUBLIC_FACTORIES,PUBLIC_BUDGETS} from '../../src/scene/finish/public.js';
import {detailAtlas} from '../../src/scene/finish/materials.js';
import {cityField} from '../../src/scene/finish/field.js';
import {encodeGLB,png} from './glb.mjs';
const out=new URL('../../assets/finish/',import.meta.url);await mkdir(out,{recursive:true});const rows=[];
for(const name of Object.keys(PUBLIC_FACTORIES))for(const lod of ['low','high']){const mesh=createPublicAsset(name,lod),{bytes,min,max}=encodeGLB(mesh);await writeFile(new URL(mesh.name+'.glb',out),bytes);rows.push({name,lod,triangles:mesh.indices.length/3,bytes:bytes.length,bounds:{min,max},sha256:createHash('sha256').update(bytes).digest('hex')});}
await writeFile(new URL('normal-roughness.png',out),png(detailAtlas()));await writeFile(new URL('public-contact-light.png',out),png(cityField()));
const sources={};for(const p of ['public.js','field.js','materials.js','shader.js','effects.js'])sources[p]=createHash('sha256').update(await readFile(new URL('../../src/scene/finish/'+p,import.meta.url))).digest('hex');
await writeFile(new URL('manifest.json',out),JSON.stringify({schema:1,budgets:PUBLIC_BUDGETS,sources,models:rows,notes:'Native runtime meshes and shaders; GLB exchange roughness descriptors are supported. Packed normal/roughness PNG is for the native shader, not a glTF normal texture. Ground field is world-space contact/lighting, not real-time GI.'},null,2));
console.table(rows);
2 changes: 1 addition & 1 deletion scripts/assets/export-harmony.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ for(const family of HARMONY_FAMILIES)for(let level=-1;level<4;level++)for(const
const min=[Infinity,Infinity,Infinity],max=min.map(x=>-x);for(let j=0;j<g.data.length;j+=12)for(let k=0;k<3;k++){min[k]=Math.min(min[k],g.data[j+k]);max[k]=Math.max(max[k],g.data[j+k]);}
rows.push({name,family,level,variant,lod,triangles:g.indices.length/3,gpuBytes:g.data.byteLength+g.indices.byteLength,glbBytes:data.length,gzipBytes:gzipSync(data).length,bounds:{min,max},sha256:createHash('sha256').update(data).digest('hex')});
}
const sources={};for(const p of ['src/scene/harmony/kit.js','src/scene/harmony/architecture.js','src/scene/marina/mesh-builder.js','src/scene/marina/surfaces.js'])sources[p]=createHash('sha256').update(await readFile(resolve(root,p))).digest('hex');
const sources={};for(const p of ['src/scene/harmony/kit.js','src/scene/harmony/architecture.js','src/scene/harmony/extensions.js','src/scene/marina/mesh-builder.js','src/scene/marina/surfaces.js'])sources[p]=createHash('sha256').update(await readFile(resolve(root,p))).digest('hex');
await writeFile(resolve(out,'manifest.json'),JSON.stringify({schema:1,coordinateSystem:'Y up, ground 0, +Z entrance, origin parcel centre, 1 unit = one board-world metre',runtime:'Deterministic native indexed geometry; exports are not loaded over the network',budgets:HARMONY_BUDGETS,sources,models:rows},null,2));
console.table(rows.map(({name,triangles,gpuBytes,glbBytes})=>({name,triangles,gpuBytes,glbBytes})));
console.log(`Executed ${rows.length} GLB exports to assets/harmony`);
12 changes: 6 additions & 6 deletions src/scene/board-scene.js
Original file line number Diff line number Diff line change
Expand Up @@ -23,11 +23,11 @@ function atlas(){
function uv(id){const x=id%8*256,y=Math.floor(id/8)*256;return [(x+2)/2048,1-(y+254)/1024,(x+254)/2048,1-(y+2)/1024];}
function cityGeometry(){
const g=new Geometry();
g.block([0,-.67,0],[150,.08,150],'#f4f2e9');
g.box([0,-.14,0],[15.3,.78,15.3],'#9bb6a7',.25);
g.box([0,.13,0],[15.18,.32,15.18],'#e3e8d8',.18);
g.box([0,.32,0],[14.98,.08,14.98],'#c8d9c4',.12);
g.box([0,.37,0],[9.54,.10,9.54],'#a5c3ac',.12);
g.material=21;g.block([0,-.67,0],[150,.08,150],'#205d70');g.material=0;
g.box([0,-.14,0],[15.3,.78,15.3],'#6a7168',.25);
g.box([0,.13,0],[15.18,.32,15.18],'#b5a483',.18);
g.box([0,.32,0],[14.98,.08,14.98],'#c9ba99',.12);
g.box([0,.37,0],[9.54,.10,9.54],'#899979',.12);
g.quad([.4,.525,2.6],2.20,.85,uv(28));
g.box([.1,.47,3.38],[2.45,.08,.95],'#d0ddc5',.1);
for(const t of BOARD){const [x,z]=tilePosition(t.id);g.box([x,.40,z],[1.49,.21,1.49],'#fffff6',.09);g.quad([x,.509,z],1.37,1.37,uv(t.id));}
Expand Down Expand Up @@ -124,7 +124,7 @@ class BoardScene {
const extent=(aspect<1.15?10.1/aspect:9.0)/this.zoom;
const target=this.captureTarget??[0,.3,0];
const eye=[target[0]+Math.sin(this.angle)*24*Math.cos(this.pitch),target[1]-.3+Math.sin(this.pitch)*24,target[2]+Math.cos(this.angle)*24*Math.cos(this.pitch)];
this.renderer.camera=eye;this.city.marina.selectDetail(rect.height/(2*extent));this.city.districts.selectDetail(rect.height/(2*extent));this.city.civic.selectDetail(rect.height/(2*extent));this.city.harmony.selectDetail(rect.height/(2*extent));
this.renderer.camera=eye;this.city.marina.selectDetail(rect.height/(2*extent));this.city.districts.selectDetail(rect.height/(2*extent));this.city.civic.selectDetail(rect.height/(2*extent));this.city.harmony.selectDetail(rect.height/(2*extent));this.city.publicRealm.selectDetail(rect.height/(2*extent));
this.vp=multiply(ortho(-extent*aspect,extent*aspect,-extent,extent,.1,80),lookAt(eye,target));
const objects=[{mesh:this.staticMesh,model:identity()},...this.city.objects(this.ambientTime,this.renderer.weather)];if(this.ownerMesh)objects.push({mesh:this.ownerMesh});
if(this.state)for(let i=0;i<this.state.players.length;i++){
Expand Down
4 changes: 2 additions & 2 deletions src/scene/civic/kit.js
Original file line number Diff line number Diff line change
Expand Up @@ -97,8 +97,8 @@ function casino(lod){
for(const x of [-.73,.73])g.rod([x-.21,.985,-.505],[x+.21,.985,-.505],.014,C.brass,M.metal,6);
// Small original lettering integrated into the canopy frieze (no giant sign).
const font={C:['111','100','100','100','111'],A:['010','101','111','101','101'],S:['111','100','111','001','111'],I:['111','010','010','010','111'],N:['101','111','111','111','101'],O:['111','101','101','101','111']};
g.box([0,.708,.696],[.57,.092,.02],C.dark,M.paint);
[...'CASINO'].forEach((c,i)=>font[c].forEach((r,y)=>[...r].forEach((v,x)=>{if(v==='1')g.box([-.254+i*.088+x*.022,.74-y*.016,.710],[.017,.012,.009],C.brass,M.metal);})));
g.box([0,.708,.696],[.76,.124,.024],C.dark,M.paint);
[...'CASINO'].forEach((c,i)=>font[c].forEach((r,y)=>[...r].forEach((v,x)=>{if(v==='1')g.box([-.338+i*.118+x*.027,.754-y*.023,.710],[.022,.018,.012],C.brass,M.lamp);})));
for(const x of [-.60,.60]){
g.box([x,.37,.395],[.028,.19,.028],C.brass,M.metal);
g.box([x,.47,.405],[.055,.072,.055],C.warm,M.lamp,.006);
Expand Down
2 changes: 2 additions & 0 deletions src/scene/districts/review.js
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import {createPublicAsset,PUBLIC_FACTORIES} from '../finish/public.js';
import { createHarmonyAsset, HARMONY_FAMILIES } from '../harmony/kit.js';
import { createCivicAsset, CIVIC_FACTORIES } from '../civic/kit.js';
/** Isolated asset inspection with the SAME Renderer and geometry factories as the game. */
Expand All @@ -11,6 +12,7 @@ for(const family of FAMILIES)for(const level of [-1,0,1,2,3])for(const variant o
for(const name of ['linden','bench','cafe-table','heritage-lamp','office-lamp','container','delivery-truck','gantry'])choices.set(name,lod=>createDistrictProp(name,lod));
for(const name of Object.keys(FACTORIES))choices.set(name,lod=>createAsset(name,lod));
for(const name of Object.keys(CIVIC_FACTORIES))choices.set(name,lod=>createCivicAsset(name,lod));
for(const name of Object.keys(PUBLIC_FACTORIES))choices.set(name,lod=>createPublicAsset(name,lod));
const canvas=document.querySelector('canvas'),atlas=document.createElement('canvas');atlas.width=atlas.height=2;
const ctx=atlas.getContext('2d');ctx.fillStyle='#ffffff';ctx.fillRect(0,0,2,2);
const renderer=new Renderer(canvas,atlas);renderer.studio=true;renderer.shadows=false;
Expand Down
Loading
Loading