feat(k1): complete primary acquisition lifecycle

plugins/xgrids-k1/frontend/src/presentation.ts

@@ -69,6 +69,52 @@ export function pipelineLatency(metrics: XgridsK1Metrics | undefined): number |
   return segments.length === 2 ? segments.reduce((total, value) => total + value, 0) : null;
 }
 
+function nonNegativeMetric(value: number | null | undefined): number | null {
+  const finite = finiteMetric(value);
+  return finite !== null && finite >= 0 ? finite : null;
+}
+
+export interface K1DeviceTelemetry {
+  elapsedSeconds: number | null;
+  routeDistanceMeters: number | null;
+  speedMetersPerSecond: number | null;
+}
+
+export interface SpatialActionFailure {
+  title: string;
+  detail: string;
+}
+
+export function spatialActionFailure(
+  error: string | null | undefined,
+): SpatialActionFailure | null {
+  const detail = error?.trim();
+  return detail
+    ? {
+        title: "Действие K1 не выполнено",
+        detail,
+      }
+    : null;
+}
+
+export function deviceTelemetry(
+  metrics: XgridsK1Metrics | null | undefined,
+): K1DeviceTelemetry {
+  return {
+    elapsedSeconds: nonNegativeMetric(
+      metrics?.device_elapsed_seconds ?? metrics?.elapsed_seconds,
+    ),
+    routeDistanceMeters: nonNegativeMetric(
+      metrics?.device_route_distance_meters ?? metrics?.route_distance_meters,
+    ),
+    speedMetersPerSecond: nonNegativeMetric(
+      metrics?.device_speed_meters_per_second ??
+        metrics?.device_speed_mps ??
+        metrics?.speed_meters_per_second,
+    ),
+  };
+}
+
 export function formatNumber(value: number | null, digits = 1): string {
   if (value === null) return "—";
   return value.toLocaleString("ru-RU", {