F6: bilanciamento con i bot su simulate #53

Merged
Alby96 merged 3 commits from claude/f6-bilanciamento into main 2026-11-15 11:36:50 +01:00
Owner

Cosa cambia e perché

Aggiunge un banco di prova del bilanciamento che usa dei bot, e con quello tara l'economia (ADR 0025).

Banco di prova

  • Nuovo comando railenterprise-tools balance (semi, difficoltà, bot, anni, mappa, thread). Scrive un rapporto deterministico con 14 obiettivi più i CSV per anno, mese, prezzi ed esecuzioni.
  • simulate --bot <id> fa giocare un bot in una singola partita.
  • PlayerBot è l'agente IA con una personalità da ai.json → bots (bot_competent, bot_prudent). Non entra nel salvataggio né nell'hash.

Comportamento delle IA

  • Le IA commerciano in proprio: vendono le scorte del magazzino e fanno arbitraggio con un margine minimo. Questo supera ADR 0016 §9.
  • Un trasformatore conta come sorgente solo se tutti i suoi ingressi sono serviti.
  • La linea dei ricambi si può rimandare di partsDeferYears.
  • Le compravendite nella stessa stazione ricontrollano lo spazio dei compratori.

Taratura

  • balance.json: market.world.volumeShare da 0,5 a 1,0 ed elasticity da 1,0 a 2,5.
  • ai.json: townBonus da 1,8 a 3,0 e townRoiFactor da 0,5 a 0,35.

Obiettivi

  • I semi 1–3 sono serviti per la taratura; i semi 4–9 per la verifica.
  • La verifica sui semi 4–9 è onesta, quindi alcuni obiettivi risultano non raggiunti:
    • O1: il livello 2 arriva negli anni 4, 8, 10, 4, 4 e «mai»;
    • O6: il prezzo medio per partita è fuori banda in 8 casi su 360;
    • restano aperti anche O7–O11.
  • I motivi sono nell'ADR: i lavoratori senza linee di pendolarismo, il margine dei trasformatori, le IA che nelle difficoltà alte non avviano la prima rete.
  • Restano da fare altre tarature, da una issue di seguito.

Due revisori hanno trovato 24 rilievi: 21 corretti, 2 doppioni e 1 lasciato com'è, con la motivazione nell'ADR.

Closes #47

Fase

F6

Verifica

  • scripts/build.sh verde
  • scripts/test.sh completo, lenti compresi: 244 su 244 (222 senza i lenti)
  • Client: 0 avvisi
  • Accettazione F2, F4 ed F5 verde
  • ADR 0025, docs/STATE.md

🤖 Generated with Claude Code

## Cosa cambia e perché Aggiunge un banco di prova del bilanciamento che usa dei bot, e con quello tara l'economia (ADR 0025). **Banco di prova** - Nuovo comando `railenterprise-tools balance` (semi, difficoltà, bot, anni, mappa, thread). Scrive un rapporto deterministico con 14 obiettivi più i CSV per anno, mese, prezzi ed esecuzioni. - `simulate --bot <id>` fa giocare un bot in una singola partita. - `PlayerBot` è l'agente IA con una personalità da `ai.json → bots` (`bot_competent`, `bot_prudent`). Non entra nel salvataggio né nell'hash. **Comportamento delle IA** - Le IA commerciano in proprio: vendono le scorte del magazzino e fanno arbitraggio con un margine minimo. Questo supera ADR 0016 §9. - Un trasformatore conta come sorgente solo se tutti i suoi ingressi sono serviti. - La linea dei ricambi si può rimandare di `partsDeferYears`. - Le compravendite nella stessa stazione ricontrollano lo spazio dei compratori. **Taratura** - `balance.json`: `market.world.volumeShare` da 0,5 a 1,0 ed `elasticity` da 1,0 a 2,5. - `ai.json`: `townBonus` da 1,8 a 3,0 e `townRoiFactor` da 0,5 a 0,35. **Obiettivi** - I semi 1–3 sono serviti per la taratura; i semi 4–9 per la verifica. - La verifica sui semi 4–9 è onesta, quindi alcuni obiettivi risultano non raggiunti: - **O1**: il livello 2 arriva negli anni 4, 8, 10, 4, 4 e «mai»; - **O6**: il prezzo medio per partita è fuori banda in 8 casi su 360; - restano aperti anche **O7–O11**. - I motivi sono nell'ADR: i lavoratori senza linee di pendolarismo, il margine dei trasformatori, le IA che nelle difficoltà alte non avviano la prima rete. - Restano da fare altre tarature, da una issue di seguito. Due revisori hanno trovato 24 rilievi: 21 corretti, 2 doppioni e 1 lasciato com'è, con la motivazione nell'ADR. Closes #47 ## Fase F6 ## Verifica - [x] `scripts/build.sh` verde - [x] `scripts/test.sh` completo, lenti compresi: 244 su 244 (222 senza i lenti) - [x] Client: 0 avvisi - [x] Accettazione F2, F4 ed F5 verde - [x] ADR 0025, `docs/STATE.md` 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Alby96 added 3 commits 2026-11-08 18:01:23 +01:00
Banco di prova ripetibile per tarare l'economia (ADR 0025, obiettivi O1–O14
scritti prima della taratura):

- railenterprise-tools balance: semi × difficoltà × bot × anni in parallelo,
  rapporto deterministico (rapporto.txt con gli obiettivi, anni/mesi/prezzi/
  esecuzioni.csv, tempi.txt); simulate --bot <id>.
- Bot giocatore (PlayerBot): l'agente delle IA con le personalità di
  ai.json → bots guida la compagnia del giocatore; pianifica per primo; non
  è salvato né nell'hash, il formato dei salvataggi non cambia.
- Le IA usano la compravendita in proprio (supera ADR 0016 §9) con una regola
  mensile deterministica e parametri in ai.json → trading.
- Agente corretto: un trasformatore è fonte solo con gli input alimentati
  (prima i bot fallivano su linee rimaste senza merce finite le scorte
  iniziali); la linea dei ricambi di una rete nuova esce dal budget iniziale
  se l'utile la ripaga entro planning.partsDeferYears.
- Dati: market.world volumeShare 0,5 → 1,0 ed elasticity 1,0 → 2,5;
  townBonus 1,8 → 3,0, townRoiFactor 0,5 → 0,35.

Matrice predefinita (72 esecuzioni da 12 anni, 533 s): obiettivi da 5 a 9
su 14; livello 2 del bot competente in «Imprenditore» al 4° anno (prima 7°),
nessun fallimento dei bot in «Apprendista» e «Imprenditore», prezzi medi tra
0,77 e 1,42 volte il base (prima 0,38–2,78). Restano aperti O7–O11.

EconomyTests.PriceRisesWhenDemandExceedsSupply: la soglia passa da 1,5 a
1,25 volte in 120 giorni perché il mondo a volume pieno ed elasticità 2,5
assorbe parte dello squilibrio (aumento misurato ~1,36). Accettazioni F2, F4
e F5 invariate e verdi; 222 test verdi.

Refs #47.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Tooltip «perché» (PR #52) e tutorial (PR #51) entrano nel ramo; in STATE.md restano le due sezioni di main e quella del bilanciamento, con i passi rimasti della F6.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
F6: bilanciamento, correzioni della revisione
CI / Build e test (pull_request) Successful in 1m39s
CI / Immagine Docker (pull_request) Successful in 31s
b0191e4b93
Misure del banco corrette (ADR 0025, «Correzioni della revisione»):
- O8: «trasformatori che vendono» = vendite nell'ultimo trimestre, non
  RevenueEma > 0 (la media mobile non torna a zero e contava impianti fermi
  da anni). Misurato bene il margine è positivo nel 62 % dei mesi dopo la
  taratura contro il 75 % di prima: la conclusione «logistica, non prezzo»
  non reggeva.
- O6 per partita e bene; O7 per difficoltà con la fascia allargata dalla
  volatilità del preset; O3–O5 solo sulle partite in cui il bot costruisce
  (O3 «non valutabile» se in una difficoltà non costruisce mai); O11 sulle
  IA presenti al 3° anno; O12 con gli interessi di dicembre (anno campionato
  dopo la chiusura); obiettivi del mondo su una partita per seme e
  difficoltà; mediana sui due valori centrali con un numero pari di semi.
- Verifica sui semi 4–9, mai usati nella taratura: O1 non tiene (livello 2
  al 4° anno in 3 semi su 6), O11 sì. Il test lento usa i semi 4–9.

Agente:
- il blocco in attesa della linea dei ricambi ferma solo le reti nuove e
  al più per partsDeferYears dall'apertura della rete;
- la linea dei ricambi si rimanda solo se l'utile la ripaga prima che
  finisca la dotazione del deposito (stimata dai tagliandi): con la regola
  di prima il bot competente falliva nel seme 9 di «Imprenditore»;
- il budget della compravendita vale per tutti gli affari del mese.
Una soglia minima al tasso dei prestiti per le linee urbane è stata provata
e scartata (O1 cade sul seme 3): motivazione nell'ADR.

Dati: limiti espliciti negli schemi per ai.json → planning e
balance.json → market.world, più due controlli del validatore.
Test: determinismo con più mondi in parallelo (anche con compravendita),
limiti degli schemi. ADR e STATE: 24 esecuzioni (non 72), tempi, legame
non monotono tra elasticità e accettazione F4 (un'unità di margine), tabella
prima / dopo / verifica rifatta con le misure nuove.

Matrice predefinita: 7 su 13 obiettivi (prima della taratura 4 su 13);
semi 4–9: 7 su 13. 244 test verdi (222 senza i lenti), client compilato.

Refs #47.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Alby96 merged commit f275c67688 into main 2026-11-15 11:36:50 +01:00
Alby96 deleted branch claude/f6-bilanciamento 2026-11-15 11:36:51 +01:00
Sign in to join this conversation.