feat(telemetry): add Fleet fields 260-269

Vendor the latest Fleet Telemetry fields, generate metadata and routing, normalize fixed kWh and mph values to SI, and surface new vehicle, security, navigation, and software-update signals in the live UI.

Author: atulmgupta

api/proto/tesla/CHECKSUM

@@ -1 +1 @@
-4596EBA1D26B72EB69BBF747831BF0EB2EEC106A54048D9BC7D6DE765446697C
+E8BE013478FC24DADE3B40DF10A269E6477D27FABB95C641A575A5214A101618

api/proto/tesla/SOURCE.md

@@ -17,14 +17,14 @@ rationale.
 |---|---|
 | Upstream repository | `github.com/teslamotors/fleet-telemetry` |
 | Upstream path | `protos/vehicle_data.proto` |
-| Upstream tag | **v0.8.0** |
-| Upstream commit | `031553a7d3d6952c1552ed13dc71aaf4fd4a882b` |
-| Upstream commit date | 2025-12-12 |
-| Upstream raw URL | <https://raw.githubusercontent.com/teslamotors/fleet-telemetry/031553a7d3d6952c1552ed13dc71aaf4fd4a882b/protos/vehicle_data.proto> |
-| Upstream tree URL | <https://github.com/teslamotors/fleet-telemetry/blob/v0.8.0/protos/vehicle_data.proto> |
-| File size | 21,291 bytes |
-| SHA256 | `4596EBA1D26B72EB69BBF747831BF0EB2EEC106A54048D9BC7D6DE765446697C` |
-| Fetched on | 2026-05-01 |
+| Upstream tag | untagged (`Add new streamable fields 260-269`, #546) |
+| Upstream commit | `8fbaa100bd365936dab6ecbf0e2d7070c4d765cb` |
+| Upstream commit date | 2026-09-14 |
+| Upstream raw URL | <https://raw.githubusercontent.com/teslamotors/fleet-telemetry/8fbaa100bd365936dab6ecbf0e2d7070c4d765cb/protos/vehicle_data.proto> |
+| Upstream tree URL | <https://github.com/teslamotors/fleet-telemetry/blob/8fbaa100bd365936dab6ecbf0e2d7070c4d765cb/protos/vehicle_data.proto> |
+| File size | 21,729 bytes |
+| SHA256 | `E8BE013478FC24DADE3B40DF10A269E6477D27FABB95C641A575A5214A101618` |
+| Fetched on | 2026-09-14 |
 | Vendored by | phase-42 prompt 0010 |
 | Reviewed by | Staff Engineer + Principal Engineer + Principal Architect (per ADR-004) |
 

api/proto/tesla/VERSION

@@ -1,3 +1,3 @@
-teslamotors/fleet-telemetry@v0.8.0
-commit=031553a7d3d6952c1552ed13dc71aaf4fd4a882b
-fetched=2026-05-01
+teslamotors/fleet-telemetry@8fbaa100bd365936dab6ecbf0e2d7070c4d765cb
+commit=8fbaa100bd365936dab6ecbf0e2d7070c4d765cb
+fetched=2026-09-14

api/proto/tesla/vehicle_data.proto

@@ -284,6 +284,19 @@ enum Field {
 
   MilesSinceReset = 258;
   SelfDrivingMilesSinceReset = 259;
+
+  // fields 260-269 are first available in firmware version 2026.32 (device client version 1.3.0)
+
+  GpsAccuracyMeters = 260;
+  LifetimeEnergyChargedKwh = 261;
+  BrickSocMinPercent = 262;
+  NominalFullPackEnergyKwh = 263;
+  GradeEstimatePercent = 264;
+  MaxSpeedToReachDestinationMph = 265;
+  SoftwareUpdateAvailable = 266;
+  SoftwareUpdateInProgress = 267;
+  RemoteStartActive = 268;
+  SemiCruiseSpeedLimitMph = 269; // Semi-truck only
 }
 
 // ChargingState is deprecated and not used

cmd/protogen-tesla/emit.go

@@ -569,6 +569,29 @@ func classifyExplicit(name string) fieldClass {
 		return fieldClass{cat: "safety_security", kind: "float", unit: "distance", isSettingUnit: false}
 	case "SelfDrivingMilesSinceReset":
 		return fieldClass{cat: "safety_security", kind: "float", unit: "distance", isSettingUnit: false}
+	case "GpsAccuracyMeters":
+		// Wire unit is already metres (name-encoded). Do not treat as
+		// SettingDistanceUnit-following distance — ToSI would re-scale.
+		return fieldClass{cat: "location", kind: "float", unit: "none", isSettingUnit: false}
+	case "LifetimeEnergyChargedKwh":
+		return fieldClass{cat: "charging", kind: "float", unit: "none", isSettingUnit: false}
+	case "BrickSocMinPercent":
+		return fieldClass{cat: "charging", kind: "float", unit: "charge", isSettingUnit: false}
+	case "NominalFullPackEnergyKwh":
+		return fieldClass{cat: "charging", kind: "float", unit: "none", isSettingUnit: false}
+	case "GradeEstimatePercent":
+		return fieldClass{cat: "driving", kind: "float", unit: "none", isSettingUnit: false}
+	case "MaxSpeedToReachDestinationMph":
+		// Name-encoded mph; converted to m/s via fixedMphSpeedFields.
+		return fieldClass{cat: "driving", kind: "float", unit: "none", isSettingUnit: false}
+	case "SoftwareUpdateAvailable":
+		return fieldClass{cat: "vehicle_state", kind: "bool", unit: "none", isSettingUnit: false}
+	case "SoftwareUpdateInProgress":
+		return fieldClass{cat: "vehicle_state", kind: "bool", unit: "none", isSettingUnit: false}
+	case "RemoteStartActive":
+		return fieldClass{cat: "vehicle_state", kind: "bool", unit: "none", isSettingUnit: false}
+	case "SemiCruiseSpeedLimitMph":
+		return fieldClass{cat: "driving", kind: "float", unit: "none", isSettingUnit: false}
 	}
 	return fieldClass{}
 }

internal/tesla/normalize/normalize.go

@@ -149,7 +149,8 @@ func (p *Pipeline) toSI(ctx context.Context, atomic codec.Atomic, vehicleIntID i
 	// kWh/kW. Neither family may be dropped because a vehicle has no
 	// unit_history row.
 	if units.IsFixedMileDistanceField(atomic.Field) ||
-		units.IsFixedKiloToBaseField(atomic.Field) {
+		units.IsFixedKiloToBaseField(atomic.Field) ||
+		units.IsFixedMphSpeedField(atomic.Field) {
 		raw, ok := coerceFloat(atomic.Value)
 		if !ok {
 			return codec.Atomic{}, fmt.Errorf("%w: %s value of type %T not coercible to float64", units.ErrUnsupportedField, atomic.Field, atomic.Value)
@@ -218,7 +219,7 @@ func (p *Pipeline) toSI(ctx context.Context, atomic codec.Atomic, vehicleIntID i
 // them. The SettingChargeUnit signal is recorded for UI display
 // preference only.
 func needsConversion(field string, meta *protomodel.SignalMeta) bool {
-	if isSpeedField(field) || units.IsFixedKiloToBaseField(field) {
+	if isSpeedField(field) || units.IsFixedKiloToBaseField(field) || units.IsFixedMphSpeedField(field) {
 		return true
 	}
 	if meta == nil {

internal/tesla/protomodel/coverage_test.go

@@ -163,6 +163,39 @@ func TestCoverage_SettingUnitInvariants(t *testing.T) {
 // (e.g. a temperature reading) gets misclassified into a non-measurement
 // bucket and then gets silently dropped by the unit-history /
 // unit-conversion layer, which only iterates measurement-bucket fields.
+// TestCoverage_FleetTelemetryFields260to269 pins the firmware-2026.32 Field
+// enum values (teslamotors/fleet-telemetry@8fbaa100) on the vendored generator
+// output. The teslamotors Go module is still v0.9.0 (Go 1.25), so
+// TestCoverage_EveryProtoFieldHasSignalMeta cannot see these names via
+// ftproto.Field_name until that module pin moves.
+func TestCoverage_FleetTelemetryFields260to269(t *testing.T) {
+	want := []struct {
+		num  int32
+		name string
+	}{
+		{260, "GpsAccuracyMeters"},
+		{261, "LifetimeEnergyChargedKwh"},
+		{262, "BrickSocMinPercent"},
+		{263, "NominalFullPackEnergyKwh"},
+		{264, "GradeEstimatePercent"},
+		{265, "MaxSpeedToReachDestinationMph"},
+		{266, "SoftwareUpdateAvailable"},
+		{267, "SoftwareUpdateInProgress"},
+		{268, "RemoteStartActive"},
+		{269, "SemiCruiseSpeedLimitMph"},
+	}
+	for _, w := range want {
+		meta, ok := SignalsByEnum[w.num]
+		if !ok {
+			t.Errorf("SignalsByEnum missing enum=%d (%s); re-vendor proto and run go generate", w.num, w.name)
+			continue
+		}
+		if meta.Field != w.name {
+			t.Errorf("SignalsByEnum[%d].Field=%q want %q", w.num, meta.Field, w.name)
+		}
+	}
+}
+
 func TestCoverage_UnitBearingFieldsAreMeasurements(t *testing.T) {
 	denied := sortedKeys(nonMeasurementCategories)
 

internal/tesla/protomodel/signal_metadata_gen.go

@@ -77,6 +77,8 @@ routes:
     dest: signal_log
   - field: BrickVoltageMin
     dest: signal_log
+  - field: BrickSocMinPercent
+    dest: signal_log
   - field: CabinOverheatProtectionMode
     dest: climate_snapshot
     column: cabin_overheat_protection_mode
@@ -435,6 +437,8 @@ routes:
   - field: Gear
     dest: drive_telemetry
     column: gear
+  - field: GpsAccuracyMeters
+    dest: signal_log
   - field: GpsHeading
     dest: positions
     column: heading_deg
@@ -506,6 +510,10 @@ routes:
   - field: LateralAcceleration
     dest: drive_telemetry
     column: lateral_acceleration_mps2
+  - field: GradeEstimatePercent
+    dest: signal_log
+  - field: LifetimeEnergyChargedKwh
+    dest: signal_log
   - field: LifetimeEnergyGainedRegen
     dest: drive_telemetry
     column: lifetime_energy_gained_regen_wh
@@ -602,6 +610,8 @@ routes:
   # to meters before the SI value lands in signal_log.
   - field: MilesSinceReset
     dest: signal_log
+  - field: MaxSpeedToReachDestinationMph
+    dest: signal_log
   - field: MilesToArrival
     dest: signal_log
   - field: MinutesToArrival
@@ -610,6 +620,8 @@ routes:
     dest: signal_log
   - field: ModuleTempMin
     dest: signal_log
+  - field: NominalFullPackEnergyKwh
+    dest: signal_log
   - field: NotEnoughPowerToHeat
     dest: signal_log
   - field: NumBrickVoltageMax
@@ -706,6 +718,8 @@ routes:
   # per-vehicle feature flag, and RoofColor is paint trim. Each
   # carries the change feed in signal_log; downstream readers fetch
   # the most recent value back from there. No hot column exists.
+  - field: RemoteStartActive
+    dest: signal_log
   - field: RemoteStartEnabled
     dest: signal_log
   - field: RightHandDrive
@@ -754,6 +768,8 @@ routes:
   # UnitKindDistance). Same routing rationale as MilesSinceReset —
   # the wire value is fixed in miles, normalize.toSI bypasses
   # vehicle_unit_history, and the SI value lands in signal_log.
+  - field: SemiCruiseSpeedLimitMph
+    dest: signal_log
   - field: SelfDrivingMilesSinceReset
     dest: signal_log
   - field: SemitruckPassengerSeatFoldPosition
@@ -840,10 +856,14 @@ routes:
     dest: signal_log
   # SoftwareUpdate* atomics (vehicle_state). Update-progress UI feeds
   # off the signal_log change stream; no hot column exists.
+  - field: SoftwareUpdateAvailable
+    dest: signal_log
   - field: SoftwareUpdateDownloadPercentComplete
     dest: signal_log
   - field: SoftwareUpdateExpectedDurationMinutes
     dest: signal_log
+  - field: SoftwareUpdateInProgress
+    dest: signal_log
   - field: SoftwareUpdateInstallationPercentComplete
     dest: signal_log
   - field: SoftwareUpdateScheduledStartTime

internal/tesla/router/routing.yaml

@@ -184,14 +184,30 @@ func IsFixedMileDistanceField(field string) bool {
 // AC/DCChargingEnergyIn in kWh and AC/DCChargingPower in kW:
 // https://developer.tesla.com/docs/fleet-api/fleet-telemetry/available-data
 var fixedKiloToBaseFields = map[string]bool{
-	"ACChargingEnergyIn": true,
-	"DCChargingEnergyIn": true,
-	"ACChargingPower":    true,
-	"DCChargingPower":    true,
+	"ACChargingEnergyIn":         true,
+	"DCChargingEnergyIn":         true,
+	"ACChargingPower":            true,
+	"DCChargingPower":            true,
+	"LifetimeEnergyChargedKwh":   true,
+	"NominalFullPackEnergyKwh":   true,
 }
 
 // IsFixedKiloToBaseField reports whether a Tesla field has a fixed kWh/kW
 // wire unit that must be converted to Wh/W without consulting unit history.
 func IsFixedKiloToBaseField(field string) bool {
 	return fixedKiloToBaseFields[field]
 }
+
+// fixedMphSpeedFields lists linear-velocity proto fields whose wire
+// value is ALWAYS miles per hour (name-encoded), independent of
+// SettingDistanceUnit. Canonical SI is metres per second.
+var fixedMphSpeedFields = map[string]bool{
+	"MaxSpeedToReachDestinationMph": true,
+	"SemiCruiseSpeedLimitMph":       true,
+}
+
+// IsFixedMphSpeedField reports whether a Tesla speed field is always
+// mph on the wire and must convert to m/s without unit history.
+func IsFixedMphSpeedField(field string) bool {
+	return fixedMphSpeedFields[field]
+}