Aetheria/docs/stats-power-cut7-roles.md

Cut 7 (Roles Authored): Operator Review

Generated by dotnet run --project tools/AetherDb -- roles-migrate (dry run captures this exact table; apply landed it in GameData/Aetheria.cc). Regenerate with roles-migrate any time the catalog changes — this file is a snapshot for review, not a second source of truth.

Role vocabulary is small and shared within a kind: the same handful of part names cover every design of that kind, not one bespoke name per item. A stat is only pointed at a role when it both carries a Quality term and actually varies with quality (Min != Max) — Cut 1's flat placeholder stats (Min == Max, a harmless leftover Heat^1 term) have no observable role-vs-workmanship difference, so pointing a role at one would be authoring fiction, not content.

Product role means below are almost all generic placeholders (deterministic per product+role, not hand-tuned) flagged "needs operator review" — the one exception is Arctica/Alakrita, where docs/item-provenance-target.md already states a brand identity ("optimizing for heat efficiency"). Every other product is waiting on the operator to decide who is actually good at what; right now they only differ from each other by an arbitrary seed, not by authored intent.

Designs and their roles, by item kind

AetherDrive

Design	Roles	Stat → role
Traction	coupling, rotor	AetherDriveData.MaximumRpm → rotor · AetherDriveData.Torque → rotor · AetherDriveData.CouplingEfficiency → coupling · AetherDriveData.EnergyDraw → coupling · AetherDriveData.PassiveCoupling → coupling

Role meanings: rotor — the spinning core that produces RPM and torque. coupling — how efficiently that output couples into drive and how much bleeds off passively.

CargoBay, ControlModule, DockingBay, Hull/Station, Hull/Turret — no roles

SafeStuff II, Store-All Enterprise Edition, Store-All Plus, Store-All Plus Mini (CargoBay); Cockpit 2x2, Turret Control Module (ControlModule); Medium Docking Bay (DockingBay); Zenith (Hull/Station); Turret (Hull/Turret).

Why: none of these kinds' behaviours read StatSource.Quality at all today (cargo capacity, docking, cockpit draw and hull cross-section on these particular designs are flat or non-quality stats) — there is no per-part distinction for a role to express yet. Generic quality stays. Turret's own ReflectorData.CrossSection is present but authored flat (Heat^1, no Quality term), unlike LonginusX's.

Hull/Ship

Design	Roles	Stat → role
LonginusX	plating	ReflectorData.CrossSection → plating

Role meaning: plating — the hull's armor/stealth coating, which is what actually governs radar cross-section.

Radiator

Design	Roles	Stat → role
Arctica	fins, pump, reservoir	Emissivity→fins · WasteHeat→fins · PumpedHeat→pump · EnergyUsage→pump · ThermalMass→reservoir
cold like my heart	fins, pump, reservoir	same five fields, same roles
OK Disperser	fins, pump, reservoir	same five fields, same roles
Iapyx	reservoir	ThermalMass→reservoir only (Emissivity/PumpedHeat/WasteHeat/EnergyUsage are authored flat, Heat^1, no Quality term)
Skiron	reservoir	same as Iapyx

Role meanings: fins — the radiating surface (emissivity, waste heat). pump — the coolant pump (heat moved, its own energy cost). reservoir — the thermal mass of the coolant loop itself.

Reactor

Design	Roles	Stat → role
Core Power	core, regulator	Efficiency→core · OverloadEfficiency→regulator · ThrottlingFactor→regulator (Charge authored flat here)
Manhattan	core, regulator	Charge→core · Efficiency→core · OverloadEfficiency→regulator · ThrottlingFactor→regulator
MoveOnPro	core, regulator	same four
Notorious	core, regulator	same four
Vulcan	core, regulator	same four

Role meanings: core — the primary reaction chamber (raw charge and efficiency). regulator — the safety and throttling electronics (overload behaviour, throttling).

MoveOnPro also carries a StatModifierData.Modifier (Quality-termed) — left at generic quality: it modifies an external stat rather than the reactor's own part, so no reactor role fits it.

Sensors

Design	Roles	Stat → role
not if i see you first	emitter, receiver	Sensitivity→receiver · PingBoost,PingEnergy,PingVisibility,PingRange,PingCooldown→emitter
The Bat	emitter, receiver	Sensitivity→receiver · PingBoost,PingVisibility,PingRange,PingCooldown→emitter (PingEnergy authored flat here)
Tractor Beam	(none)	dead design (S1, Cut 1 findings): every field is flat, nothing to point

Role meanings: receiver — passive sensitivity. emitter — the active ping subsystem (boost, cost, visibility, range, cooldown).

Thruster

Design	Roles	Stat → role
deep space burnout	injector, nozzle	Thrust→nozzle · Visibility→nozzle · Heat→injector (EnergyUsage authored flat 0/0, no terms)
Large Drive	(none)	every field authored flat (Heat^1/Quality^1 but Min == Max throughout)

Role meanings: nozzle — exhaust output and plume (thrust, visibility). injector — fuel/power feed, whose byproduct is heat.

Tool

Tool is not a shared kind the way a laser or radiator is — each design is its own bespoke gadget, so roles are authored per design rather than from one shared field map.

Design	Roles	Stat → role
Industrial Thermostatic Heater	heating element	EnergyDrawData.EnergyDraw→heating element · HeatData.Heat→heating element
PotaT+-	converter, storage cell	CapacitorData.Capacity→storage cell · CapacitorData.Efficiency→converter
Assembly Line, Deep Ore Extractor, Refinery, Shipyard, Surface Ore Extractor	(none)	carry no PerformanceStat behaviour at all in the current catalog

Weapon/Ballistic

Design	Roles	Stat → role
6k Shooter	barrel, feed mechanism	Damage,Range,Velocity→barrel · Heat,Visibility,Spread→feed mechanism
Earp	barrel, feed mechanism	same shape as 6k Shooter
ClearPath	barrel, feed mechanism	Damage,Range,Velocity→barrel · Cooldown,Energy,Heat,Visibility,Spread→feed mechanism
DeathCluster	barrel, feed mechanism	same shape as ClearPath
pretty pretty bang bang	barrel, feed mechanism	same shape as ClearPath (charged weapon, same field names)
Autocannon	(none)	dead design (S1, Cut 1 findings): every field flat

Role meanings: barrel — the part that decides damage, range and muzzle velocity. feed mechanism — cycling: rate of fire, spread, heat and signature it generates, and (where authored) its energy cost.

Weapon/Energy

Design	Roles	Stat → role
CShot RainbowLite Lazer	focusing array, power coupling	Damage,Range→focusing array · Cooldown,Energy,Heat,Visibility,Spread→power coupling
ColdFire	focusing array, power coupling	same shape
Spectra	focusing array, power coupling	same shape
FastBlast+-	focusing array, power coupling	Damage,Range,Velocity→focusing array · Cooldown,Heat,Visibility,Spread→power coupling
ChargeBlast SG	focusing array, power coupling	Damage,Range,Velocity→focusing array · ChargeTime,ChargeHeat,Cooldown,Visibility,Spread→power coupling
ChargeBlast+-	focusing array, power coupling	same shape as ChargeBlast SG
plight	focusing array, power coupling	Damage,Range→focusing array · ChargeTime,ChargeEnergy,ChargeHeat,Cooldown,Heat,Visibility→power coupling

Role meanings: focusing array — the beam optics that decide damage, range and velocity. power coupling — everything about how the weapon draws, stores and discharges energy (including charge-up on charged lasers) and the heat/signature that produces.

Weapon/Launcher

Design	Roles	Stat → role
GT 3K	guidance system, thruster, warhead	Damage,DamageSpread→warhead · LockSpeed,SensorImpact,LockAngle,DirectionImpact,Decay,Range,Cooldown,Energy,Heat,Visibility→guidance system · Thrust,MissileVelocity,Velocity→thruster
pswarm	guidance system, thruster, warhead	Damage,DamageSpread→warhead · Cooldown,Range,Energy,Heat,Visibility→guidance system · Thrust,MissileVelocity,Velocity→thruster
scorched void policy	guidance system, thruster, warhead	same shape as pswarm
LRMM72, SRMM72	(none)	dumbfire volleys authored fully flat: every field Heat^1, nothing varies

Role meanings: warhead — payload (damage, damage spread, penetration). guidance system — the seeker (lock speed/angle, sensor and direction sensitivity, decay, targeting range, cooldown, its own energy/heat/ signature). thruster — the missile's own motor (thrust, flight/missile velocity).

Product role quality authored

37 products exist; 28 got role-quality entries this pass (the rest sell a design that authored no role, or are one of the two-missile launchers left flat). All means/deviations are generic placeholders except Arctica's fins, and every row below needs an operator pass to become real brand identity rather than an arbitrary seed.

Product (= design; content pass to split brand vs. design names is separate scope)	Role	Mean	Dev	Basis
Arctica	fins	0.78	0.07	lore: Alakrita brands on heat efficiency (item-provenance-target.md)
Arctica	pump	0.47	0.11	generic — needs review
Arctica	reservoir	0.53	0.14	generic — needs review
cold like my heart	fins, pump, reservoir	0.54 / 0.74 / 0.73	0.17 / 0.17 / 0.09	generic — needs review
OK Disperser	fins, pump, reservoir	0.61 / 0.57 / 0.59	0.14 / 0.10 / 0.18	generic — needs review
Iapyx	reservoir	0.61	0.17	generic — needs review
Skiron	reservoir	0.64	0.16	generic — needs review
Manhattan	core, regulator	0.48 / 0.63	0.08 / 0.12	generic — needs review
MoveOnPro	core, regulator	0.62 / 0.46	0.15 / 0.15	generic — needs review
Notorious	core, regulator	0.65 / 0.46	0.15 / 0.17	generic — needs review
Vulcan	core, regulator	0.75 / 0.58	0.12 / 0.16	generic — needs review
not if i see you first	emitter, receiver	0.71 / 0.75	0.09 / 0.18	generic — needs review
The Bat	emitter, receiver	0.45 / 0.57	0.09 / 0.16	generic — needs review
deep space burnout	injector, nozzle	0.64 / 0.67	0.12 / 0.14	generic — needs review
Traction	coupling, rotor	0.69 / 0.65	0.10 / 0.10	generic — needs review
LonginusX	plating	0.48	0.13	generic — needs review
PotaT+-	converter, storage cell	0.67 / 0.53	0.17 / 0.11	generic — needs review
6k Shooter	barrel, feed mechanism	0.59 / 0.46	0.14 / 0.14	generic — needs review
ClearPath	barrel, feed mechanism	0.71 / 0.57	0.10 / 0.10	generic — needs review
DeathCluster	barrel, feed mechanism	0.65 / 0.68	0.17 / 0.11	generic — needs review
Earp	barrel, feed mechanism	0.73 / 0.68	0.13 / 0.10	generic — needs review
pretty pretty bang bang	barrel, feed mechanism	0.51 / 0.63	0.10 / 0.09	generic — needs review
CShot RainbowLite Lazer	focusing array, power coupling	0.71 / 0.54	0.16 / 0.11	generic — needs review
ChargeBlast SG	focusing array, power coupling	0.51 / 0.54	0.09 / 0.10	generic — needs review
ChargeBlast+-	focusing array, power coupling	0.45 / 0.51	0.17 / 0.18	generic — needs review
ColdFire	focusing array, power coupling	0.68 / 0.58	0.10 / 0.13	generic — needs review
FastBlast+-	focusing array, power coupling	0.74 / 0.61	0.11 / 0.13	generic — needs review
Spectra	focusing array, power coupling	0.75 / 0.63	0.09 / 0.13	generic — needs review
GT 3K	guidance system, thruster, warhead	0.69 / 0.63 / 0.58	0.15 / 0.17 / 0.16	generic — needs review
scorched void policy	guidance system, thruster, warhead	0.61 / 0.61 / 0.68	0.08 / 0.12 / 0.15	generic — needs review

Not authored (no product sells the design, so nothing to author): Core Power, Industrial Thermostatic Heater, pswarm, plight (all previously flagged "no product sells" in the Cut 1 census; still true here).

O7 — what the operator should actually do with this

Everything above the "generic — needs review" line is mechanically correct (verified: census's new "(product, role) pairs where a sold, role-bearing design authors no matching spread" check reports 0, and two products of one design with different means resolve a role-termed stat to different, deterministic values — RoleAuthoringTests.TwoProductsOfOneDesignWithDifferentRoleMeansResolveDifferentValues). What it is not is real market segmentation: every design still has exactly one product, so nothing yet demonstrates "a second product with a role pumped up." That is next scope, and it needs the operator's judgment on which manufacturer is good at what — this table is the jumping-off point, not the destination.