PerformanceStat's four fixed fields (HeatExponentMultiplier, DurabilityExponentMultiplier, QualityExponent, FromRole) tombstone into a declared List<StatTerm> (source + exponent + role), walked by the one evaluation path Cut 0 unified. A stat with no terms resolves to Max (the same identity a stat with all-zero exponents already produced), so the migration is exact: a zero multiplier becomes no term, not a term with exponent 0. R-heat (operator, docs/stats-and-power-cut.md): EquippableItemData's HeatPerformanceCurve (a BezierCurve, plus the 100-sample scan that inferred OptimalTemperature and its cache) is retired in favor of an authored minimum, maximum, optimum and plateau width, with linear falloff outside the plateau. StatValidation refuses an optimum outside its bounds or a negative plateau width, loudly, at catalog load. The plateau's consequence rides along for free: Wear's thermal term is pow(ThermalPerformance, ...), and Performance() now returns exactly 1 across the plateau, so a well-managed item takes wear only from deltaTemp there -- the operational-lifespan lever the operator asked for. ConsumableItemEffect's progress-through-duration substitution for "heat" becomes its own StatSource (ConsumableProgress) rather than an unconditional override applied regardless of what a stat declares. Tests: LoadoutTests' four PerformanceStat-shaped fixtures rebuilt against Terms/authored heat fields; HeatResponseTests.cs (new) pins load validation, the plateau shape, and the three wear-lever claims (held inside takes no thermal wear, held outside does, a fast swing across still wears) each under its own mutation in tests/mutation_tests_stats_power_cut1.py (new, 10 rules including a no-op control; all pass). 64 pre-Cut-1 tests still pass unmodified; 71 total with the 7 new ones. Unity batchmode: 0 error CS. ShieldPanelCut1Verify and Cut2Verify pass; Cut3Verify fails with an unrelated pre-existing "Kernel 'KInit' not found" compute-shader error, reproduced against Cut 0's own landing state with no shader/compute file in this diff -- flagged for Soul, not fixed here. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
181 lines
8.3 KiB
C#
181 lines
8.3 KiB
C#
using System;
|
|
using System.IO;
|
|
using System.Linq;
|
|
using CultMath;
|
|
using GameCult.Caching;
|
|
using Xunit;
|
|
|
|
// Cut 1 (docs/stats-and-power-cut.md), R-heat: the authored heat-response shape (minimum, maximum, optimum,
|
|
// plateau width), its load-time validation, and the wear-lever consequence (the plateau is where Wear's thermal
|
|
// term goes to zero). Each rule here has a matching mutation in tests/mutation_tests_stats_power_cut1.py.
|
|
public sealed class HeatResponseTests : IDisposable
|
|
{
|
|
private readonly string _root = Path.Combine(Path.GetTempPath(), "aetheria-heatresponse-" + Guid.NewGuid().ToString("N"));
|
|
private string Catalog => Path.Combine(_root, "Aetheria.cc");
|
|
private static readonly int2 HardpointCell = new int2(0, 0);
|
|
|
|
public HeatResponseTests() => Directory.CreateDirectory(_root);
|
|
public void Dispose() => Directory.Delete(_root, true);
|
|
|
|
private GameplaySettings Settings() => new GameplaySettings
|
|
{
|
|
DefaultEntitySettings = new EntitySettings(),
|
|
Tiers = new[] { new RarityTier { Name = "Common", Quality = .5f, Rarity = 0, Color = new float3(1, 1, 1) } },
|
|
QualityPriceModifier = new ExponentialLerp()
|
|
};
|
|
|
|
// A hull plus one thermal gear design, equipped and settled at the given start temperature (two
|
|
// UpdatePerformance calls so deltaTemp reads 0 before the test drives its own change).
|
|
private EquippedItem BuildEquippedAt(CultCache cache, ItemManager items, float startTemperature, out Ship ship)
|
|
{
|
|
var maker = cache.RefOf(cache.GetByName<Faction>("Maker"));
|
|
var hullData = cache.GetByName<HullData>("Skiff");
|
|
var thermalData = cache.GetByName<GearData>("Thermal");
|
|
var hullItem = (EquippableItem) items.CreateInstance(items.CreateLot(hullData, maker, .5f));
|
|
ship = new Ship(items, null, hullItem, new EntitySettings());
|
|
var gearItem = (EquippableItem) items.CreateInstance(items.CreateLot(thermalData, maker, .5f));
|
|
Assert.True(ship.TryEquip(gearItem, HardpointCell));
|
|
var equipped = ship.Equipment.Single(e => e.Data is GearData);
|
|
foreach (var cell in equipped.InsetShape.Coordinates) ship.Temperature[cell.x, cell.y] = startTemperature;
|
|
equipped.UpdatePerformance();
|
|
equipped.UpdatePerformance(); // settle: oldTemperature now equals startTemperature, deltaTemp reads 0
|
|
return equipped;
|
|
}
|
|
|
|
private void SetTemperature(EquippedItem equipped, Ship ship, float temperature)
|
|
{
|
|
foreach (var cell in equipped.InsetShape.Coordinates) ship.Temperature[cell.x, cell.y] = temperature;
|
|
}
|
|
|
|
private CultCache OpenCatalogWithThermalGear()
|
|
{
|
|
var cache = AetheriaStores.Open(Catalog, catalogWritable: true);
|
|
cache.Upsert(new TestCatalogGlobal { Name = "Temperament" });
|
|
cache.Upsert(new Faction { Name = "Maker", ShortName = "MKR" });
|
|
var hullShape = new Shape(3, 3);
|
|
foreach (var cell in hullShape.AllCoordinates) hullShape[cell] = true;
|
|
cache.Upsert(new HullData
|
|
{
|
|
Name = "Skiff", HullType = HullType.Ship, Shape = hullShape, Price = 100,
|
|
Hardpoints = { new HardpointData { Type = HardpointType.Sensors, Position = HardpointCell, Shape = new Shape() } }
|
|
});
|
|
// Plateau 40-60 of a 0-100 range: full performance across it, linear falloff to the bounds outside it.
|
|
cache.Upsert(new GearData
|
|
{
|
|
Name = "Thermal", Hardpoint = HardpointType.Sensors, Shape = new Shape(), Price = 10,
|
|
Durability = 100, MinimumTemperature = 0, MaximumTemperature = 100,
|
|
OptimalTemperature = 50, PlateauWidth = 20
|
|
});
|
|
cache.FlushAsync().Wait();
|
|
return cache;
|
|
}
|
|
|
|
// --- R-heat shape: Performance() is 1 across the plateau and falls linearly to 0 at the bounds ---
|
|
|
|
[Fact]
|
|
public void PerformanceIsFullAcrossThePlateau()
|
|
{
|
|
using var cache = OpenCatalogWithThermalGear();
|
|
var data = cache.GetByName<GearData>("Thermal");
|
|
Assert.Equal(1f, data.Performance(40), 5);
|
|
Assert.Equal(1f, data.Performance(50), 5);
|
|
Assert.Equal(1f, data.Performance(60), 5);
|
|
}
|
|
|
|
[Fact]
|
|
public void PerformanceFallsLinearlyOutsideThePlateau()
|
|
{
|
|
using var cache = OpenCatalogWithThermalGear();
|
|
var data = cache.GetByName<GearData>("Thermal");
|
|
// Halfway from the plateau's low edge (40) down to the minimum (0) -> halfway performance.
|
|
Assert.Equal(.5f, data.Performance(20), 5);
|
|
Assert.Equal(0f, data.Performance(0), 5);
|
|
Assert.Equal(0f, data.Performance(100), 5);
|
|
}
|
|
|
|
// --- Validation: fails loudly at catalog load, naming the item ---
|
|
|
|
[Fact]
|
|
public void LoadRefusesAnOptimumOutsideItsBounds()
|
|
{
|
|
var root = Path.Combine(Path.GetTempPath(), "aetheria-heatresponse-invalid-" + Guid.NewGuid().ToString("N"));
|
|
Directory.CreateDirectory(root);
|
|
try
|
|
{
|
|
var catalog = Path.Combine(root, "Aetheria.cc");
|
|
using (var cache = AetheriaStores.Open(catalog, catalogWritable: true))
|
|
{
|
|
cache.Upsert(new TestCatalogGlobal { Name = "Temperament" });
|
|
cache.Upsert(new GearData
|
|
{
|
|
Name = "BadOptimum", Hardpoint = HardpointType.Sensors, Shape = new Shape(), Price = 1,
|
|
MinimumTemperature = 0, MaximumTemperature = 100, OptimalTemperature = 150, PlateauWidth = 0
|
|
});
|
|
cache.FlushAsync().Wait();
|
|
}
|
|
var ex = Assert.Throws<InvalidOperationException>(() => AetheriaStores.Open(catalog));
|
|
Assert.Contains("BadOptimum", ex.Message);
|
|
}
|
|
finally { Directory.Delete(root, true); }
|
|
}
|
|
|
|
[Fact]
|
|
public void LoadRefusesANegativePlateauWidth()
|
|
{
|
|
var root = Path.Combine(Path.GetTempPath(), "aetheria-heatresponse-invalid-" + Guid.NewGuid().ToString("N"));
|
|
Directory.CreateDirectory(root);
|
|
try
|
|
{
|
|
var catalog = Path.Combine(root, "Aetheria.cc");
|
|
using (var cache = AetheriaStores.Open(catalog, catalogWritable: true))
|
|
{
|
|
cache.Upsert(new TestCatalogGlobal { Name = "Temperament" });
|
|
cache.Upsert(new GearData
|
|
{
|
|
Name = "BadPlateau", Hardpoint = HardpointType.Sensors, Shape = new Shape(), Price = 1,
|
|
MinimumTemperature = 0, MaximumTemperature = 100, OptimalTemperature = 50, PlateauWidth = -1
|
|
});
|
|
cache.FlushAsync().Wait();
|
|
}
|
|
var ex = Assert.Throws<InvalidOperationException>(() => AetheriaStores.Open(catalog));
|
|
Assert.Contains("BadPlateau", ex.Message);
|
|
}
|
|
finally { Directory.Delete(root, true); }
|
|
}
|
|
|
|
// --- The wear lever (Entity.cs UpdatePerformance): inside the plateau the thermal term is zero ---
|
|
|
|
[Fact]
|
|
public void HeldInsidePlateauTakesNoThermalWear()
|
|
{
|
|
using var cache = OpenCatalogWithThermalGear();
|
|
var items = new ItemManager(cache, new ProvenanceLedger(), Settings(), _ => { });
|
|
var equipped = BuildEquippedAt(cache, items, 50f, out var ship);
|
|
Assert.Equal(1f, equipped.ThermalPerformance, 5);
|
|
Assert.Equal(0f, equipped.Wear, 5); // no thermal term (Performance == 1) and no deltaTemp (settled)
|
|
}
|
|
|
|
[Fact]
|
|
public void HeldOutsidePlateauTakesThermalWear()
|
|
{
|
|
using var cache = OpenCatalogWithThermalGear();
|
|
var items = new ItemManager(cache, new ProvenanceLedger(), Settings(), _ => { });
|
|
var equipped = BuildEquippedAt(cache, items, 10f, out var ship); // outside 40-60, inside 0-100
|
|
Assert.True(equipped.ThermalPerformance < 1f);
|
|
Assert.True(equipped.Wear > 0f);
|
|
}
|
|
|
|
[Fact]
|
|
public void AFastSwingAcrossThePlateauStillWears()
|
|
{
|
|
using var cache = OpenCatalogWithThermalGear();
|
|
var items = new ItemManager(cache, new ProvenanceLedger(), Settings(), _ => { });
|
|
var equipped = BuildEquippedAt(cache, items, 10f, out var ship);
|
|
// Jump straight into the plateau in one tick: ThermalPerformance ends at 1 (no thermal term), but the
|
|
// swing itself (deltaTemp) still costs.
|
|
SetTemperature(equipped, ship, 50f);
|
|
equipped.UpdatePerformance();
|
|
Assert.Equal(1f, equipped.ThermalPerformance, 5);
|
|
Assert.True(equipped.Wear > 0f);
|
|
}
|
|
}
|