Muse spark

.github/scripts/si_canonical_gate.py

@@ -50,6 +50,16 @@
     "web/src/hooks/useSettings.test.ts",
 }
 
+# Tesla Fleet Telemetry Field enum identifiers are upstream-owned (ADR-004 R2).
+# Wire names may contain Kwh/Mph even though TeslaSync stores SI (Wh, m/s).
+TESLA_PROTO_FIELD_ALLOWLIST = (
+    "NominalFullPackEnergyKwh",
+    "LifetimeEnergyChargedKwh",
+    "MaxSpeedToReachDestinationMph",
+    "SemiCruiseSpeedLimitMph",
+    "ChargeRateMilePerHour",
+)
+
 
 def iter_added_lines(diff_text: str):
     current_file = None
@@ -77,6 +87,8 @@ def check_go(diff_text: str) -> list[str]:
         s = added.lstrip()
         if s.startswith("//") or s.startswith("#") or s.startswith("--"):
             continue
+        if any(name in added for name in TESLA_PROTO_FIELD_ALLOWLIST):
+            continue
         for pat in BANNED:
             if pat.search(added):
                 violations.append(f"{current_file}: {added.rstrip()}")

.github/workflows/codec-coverage-gate.yml

@@ -46,7 +46,9 @@ permissions:
 jobs:
   routing-coverage:
     name: TestRoutingCoverage (every proto field is routed)
-    runs-on: ${{ inputs.runner || 'arc-runner' }}
+    # ubuntu-latest: `go test -race` needs CGO/gcc. arc-runner does not ship gcc
+    # (same pin as CI "Backend (lint + test + build)").
+    runs-on: ${{ github.event_name == 'workflow_dispatch' && inputs.runner || 'ubuntu-latest' }}
     steps:
       - uses: actions/checkout@v4
 

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/router/routing.yaml

@@ -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/units/conversions.go

@@ -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]
+}

internal/tesla/units/units.go

@@ -85,6 +85,10 @@ func ToSI(field string, raw float64, active ActiveUnit) (float64, error) {
 		return raw * 1000.0, nil
 	}
 
+	if IsFixedMphSpeedField(field) {
+		return raw * 0.44704, nil
+	}
+
 	if meta.UnitKind == protomodel.UnitKindNone {
 		return 0, fmt.Errorf("%w: %q", ErrUnsupportedField, field)
 	}