feat(k1): wire canonical control session to UI

plugins/xgrids-k1/frontend/src/components/K1AcquisitionPipeline.tsx

@@ -14,6 +14,7 @@ import { EXACT_PROFILE_ATTESTATION } from "../compatibility";
 import { runAutomaticSpatialSourceStart } from "../automaticSourceStart";
 import {
   isConfirmedLiveState,
+  isSoftwareCommandedAcquisition,
   isSourceRuntimeBusy,
   isVendorWriteCapable,
   recoverableAcquisition,
@@ -21,6 +22,7 @@ import {
 } from "../lifecycle";
 import { normalizeProjectName, validateProjectName } from "../projectName";
 import type { XgridsK1Controller } from "../runtimeContext";
+import type { OperatorPresenceConfirmation } from "../api";
 
 type SessionIntent = "live" | "replay";
 
@@ -29,6 +31,14 @@ const sessionItems = [
   { value: "replay", label: "Повтор записи" },
 ] satisfies Array<{ value: SessionIntent; label: string }>;
 
+const PHYSICAL_ACCEPTANCE = {
+  operator_present: true,
+  owner_controlled_device: true,
+  lixelgo_closed: true,
+  battery_storage_confirmed: true,
+  expected_physical_state_confirmed: true,
+} satisfies OperatorPresenceConfirmation;
+
 export function K1AcquisitionPipeline({
   controller,
   profileConfirmed,
@@ -43,9 +53,14 @@ export function K1AcquisitionPipeline({
   const {
     state,
     pendingAction,
-    prepareAndStartAcquisition,
+    openApplicationControlSession,
+    enterApplicationWorkspace,
+    closeApplicationControlSession,
+    prepareAcquisition,
+    startPreparedAcquisition,
     startReplay,
     stop,
+    confirmStoppedAtSteadyGreen,
     abort,
   } = controller;
   const [sessionIntent, setSessionIntent] = useState<SessionIntent>("live");
@@ -55,12 +70,15 @@ export function K1AcquisitionPipeline({
   const [replayPath, setReplayPath] = useState("");
   const [replaySpeed, setReplaySpeed] = useState("1");
   const [replayLoop, setReplayLoop] = useState(false);
+  const [physicalAcceptanceConfirmed, setPhysicalAcceptanceConfirmed] = useState(false);
   const hydratedAcquisitionId = useRef<string | null>(null);
 
   const activeAcquisition = recoverableAcquisition(state);
   const preparedAcquisition = activeAcquisition?.state === "prepared" ? activeAcquisition : null;
   const projectNameValidation = validateProjectName(projectName);
   const vendorWriteCapable = isVendorWriteCapable(state);
+  const control = state?.application_control_session;
+  const controlPhase = control?.state ?? "idle";
 
   useEffect(() => {
     if (state?.source_mode === "live" || state?.source_mode === "replay") {
@@ -103,16 +121,29 @@ export function K1AcquisitionPipeline({
     [sessionLocked],
   );
 
-  const submitLive = async () => {
+  const openControl = async () => {
+    if (!physicalAcceptanceConfirmed || !state?.k1_ip) return;
+    const timezoneName = Intl.DateTimeFormat().resolvedOptions().timeZone || "Etc/UTC";
+    await openApplicationControlSession({
+      ...PHYSICAL_ACCEPTANCE,
+      timezone_name: timezoneName,
+    });
+  };
+
+  const prepareProject = async () => {
     setProjectNameTouched(true);
     if (!profileConfirmed || sourceRuntimeBusy || projectNameValidation.error) return;
     const targetHost = liveHost.trim();
+    await prepareAcquisition({
+      project_name: projectNameValidation.value,
+      ...(targetHost ? { host: targetHost } : {}),
+      compatibility_attestation: EXACT_PROFILE_ATTESTATION,
+    });
+  };
+
+  const startLive = async () => {
     await runAutomaticSpatialSourceStart(
-      () => prepareAndStartAcquisition({
-        project_name: projectNameValidation.value,
-        ...(targetHost ? { host: targetHost } : {}),
-        compatibility_attestation: EXACT_PROFILE_ATTESTATION,
-      }),
+      () => startPreparedAcquisition(PHYSICAL_ACCEPTANCE),
       activateAutomaticSpatialSource,
       openSpatialScene,
     );
@@ -148,52 +179,114 @@ export function K1AcquisitionPipeline({
       />
       {effectiveSessionIntent === "live" ? (
         <div className="session-form">
-          <TextField
-            label="Название проекта"
-            hint="Обязательное поле · до 96 символов"
-            value={projectName}
-            onChange={(event) => {
-              setProjectName(event.target.value);
-              setProjectNameTouched(true);
-            }}
-            onBlur={() => setProjectName((value) => normalizeProjectName(value))}
-            disabled={sessionLocked}
-            autoComplete="off"
-            aria-invalid={projectNameTouched && projectNameValidation.error ? true : undefined}
-            description={projectNameTouched && projectNameValidation.error
-              ? projectNameValidation.error
-              : "Имя сохраняется в локальной сессии Mission Core для K1; в путь к файлам не подставляется."}
-            placeholder="Например, Испытание маршрута 01"
-          />
-          <TextField
-            label="Адрес устройства"
-            hint="Обычно определяется автоматически"
-            value={liveHost}
-            onChange={(event) => setLiveHost(event.target.value)}
-            disabled={sessionLocked}
-            spellCheck={false}
-            placeholder={state?.k1_ip || preparedAcquisition?.target_host || "Сначала подключите устройство к Wi‑Fi"}
-          />
-          <Button
-            variant="primary"
-            icon={<Icon name="activity" />}
-            disabled={isBusy || !profileConfirmed || !liveTargetReady || projectNameValidation.error !== null || sourceRuntimeBusy || (activeAcquisition !== null && preparedAcquisition === null)}
-            onClick={() => void submitLive()}
-          >
-            {pendingAction === "live"
-              ? vendorWriteCapable ? "Инициируем работу устройства…" : "Подготавливаем локальный приём…"
-              : vendorWriteCapable
-                ? "Инициировать приём данных и работу устройства"
-                : preparedAcquisition ? "Продолжить подготовленный приём" : "Подготовить локальный приём данных"}
-          </Button>
+          {(control?.can_open ?? controlPhase === "idle") ? (
+            <>
+              <Checker
+                checked={physicalAcceptanceConfirmed}
+                label="Я рядом с выбранным K1; LixelGO закрыт; питание и место для записи проверены; индикатор постоянно зелёный"
+                onChange={setPhysicalAcceptanceConfirmed}
+              />
+              <Button
+                variant="primary"
+                icon={<Icon name="activity" />}
+                disabled={isBusy || !profileConfirmed || !state?.k1_ip || !physicalAcceptanceConfirmed}
+                onClick={() => void openControl()}
+              >
+                {pendingAction === "control"
+                  ? "Открываем канонический диалог…"
+                  : "Подключить управление K1"}
+              </Button>
+            </>
+          ) : null}
+          {controlPhase === "connection-ready" ? (
+            <Button
+              variant="primary"
+              disabled={isBusy}
+              onClick={() => void enterApplicationWorkspace()}
+            >
+              {pendingAction === "control"
+                ? "Открываем рабочее пространство…"
+                : "Открыть рабочее пространство K1"}
+            </Button>
+          ) : null}
+          {["workspace-ready", "project-requested", "project-ready"].includes(controlPhase) || preparedAcquisition ? (
+            <>
+              <TextField
+                label="Название проекта"
+                hint="Будет отправлено только в отдельном START"
+                value={projectName}
+                onChange={(event) => {
+                  setProjectName(event.target.value);
+                  setProjectNameTouched(true);
+                }}
+                onBlur={() => setProjectName((value) => normalizeProjectName(value))}
+                disabled={controlPhase !== "workspace-ready" || preparedAcquisition !== null}
+                autoComplete="off"
+                aria-invalid={projectNameTouched && projectNameValidation.error ? true : undefined}
+                description={projectNameTouched && projectNameValidation.error
+                  ? projectNameValidation.error
+                  : "Сохранение имени само по себе не отправляет START на устройство."}
+                placeholder="Например, TEST001"
+              />
+              <TextField
+                label="Адрес устройства"
+                hint="Тот же direct-LAN адрес, который вернул выбранный K1"
+                value={liveHost}
+                onChange={(event) => setLiveHost(event.target.value)}
+                disabled={controlPhase !== "workspace-ready" || preparedAcquisition !== null}
+                spellCheck={false}
+                placeholder={state?.k1_ip || "Сначала подключите устройство к Wi‑Fi"}
+              />
+            </>
+          ) : null}
+          {controlPhase === "workspace-ready" && !preparedAcquisition ? (
+            <Button
+              variant="primary"
+              disabled={isBusy || projectNameValidation.error !== null || !liveTargetReady}
+              onClick={() => void prepareProject()}
+            >
+              {pendingAction === "live"
+                ? "Сохраняем проект и готовим приём…"
+                : "Сохранить проект и подготовить локальный приём"}
+            </Button>
+          ) : null}
+          {controlPhase === "project-ready" && preparedAcquisition ? (
+            <Button
+              variant="primary"
+              icon={<Icon name="activity" />}
+              disabled={isBusy || !physicalAcceptanceConfirmed}
+              onClick={() => void startLive()}
+            >
+              {pendingAction === "live"
+                ? "Отправляем один канонический START…"
+                : "Запустить сканирование K1"}
+            </Button>
+          ) : null}
+          {["connection-ready", "workspace-ready", "project-ready"].includes(controlPhase) && !activeAcquisition ? (
+            <Button
+              variant="ghost"
+              disabled={isBusy}
+              onClick={() => void closeApplicationControlSession()}
+            >
+              Закрыть управляющую сессию без START
+            </Button>
+          ) : null}
           <p className="live-instruction">
             {!profileConfirmed
               ? "Сначала вручную подтвердите FW 3.0.2 и direct-LAN. Интерфейс не аттестует устройство автоматически."
-              : liveTargetReady
-                ? vendorWriteCapable
-                  ? "Mission Core подготовит локальную запись и отправит профилированную команду запуска K1. После подтверждения запуска начнётся статическая инициализация — не перемещайте устройство до появления потока."
-                  : "Лабораторный профиль подготовит локальный приёмник и перейдёт в ожидание. Затем физически запустите сканирование двойным нажатием кнопки устройства. Программная команда запуска на K1 не отправляется; поток подтверждается только реальными кадрами."
-                : "Сначала подключите устройство к Wi‑Fi или укажите локальный адрес."}
+              : controlPhase === "failed"
+                ? `Диалог остановлен без автоповтора: ${control?.failure?.message || "требуется ручная проверка K1"}`
+                : controlPhase === "connecting"
+                  ? "Выполняются только операции 1–6 записанного диалога. Следующий этап начнётся только по вашей кнопке."
+                  : controlPhase === "workspace-requested"
+                    ? "Выполняется только операция входа в рабочее пространство."
+                    : controlPhase === "project-requested"
+                      ? "Выполняются операции открытия проектного шага; имя ещё не отправляется на K1."
+                      : controlPhase === "start-requested" || controlPhase === "initializing"
+                        ? "Калибровка оборудования. Не перемещайте K1; никаких временных автопереходов и повторов нет."
+                        : controlPhase === "scanning"
+                          ? "K1 подтвердил SCANNING и инициализацию. Остановка доступна в пространственной сцене."
+                          : "Каждый этап канонического диалога запускается отдельным действием оператора."}
           </p>
         </div>
       ) : (
@@ -219,7 +312,22 @@ export function K1AcquisitionPipeline({
                 : "Остановка завершает только локальный приём и сохранение. Физическое состояние сканера остаётся неизвестным."
               : "Активного источника сейчас нет."}
         </p>
-        <Button variant="secondary" disabled={isBusy || (!sourceRuntimeBusy && activeAcquisition === null)} onClick={() => void stop()}>
+        {control?.can_confirm_standby ? (
+          <Button
+            variant="primary"
+            disabled={isBusy}
+            onClick={() => void confirmStoppedAtSteadyGreen()}
+          >
+            Индикатор постоянно зелёный — завершить запись
+          </Button>
+        ) : null}
+        <Button
+          variant="secondary"
+          disabled={isBusy || (!sourceRuntimeBusy && preparedAcquisition !== null) || (!sourceRuntimeBusy && activeAcquisition === null)}
+          onClick={() => void stop(
+            isSoftwareCommandedAcquisition(state) ? PHYSICAL_ACCEPTANCE : undefined,
+          )}
+        >
           {pendingAction === "stop"
             ? state?.source_mode === "replay" ? "Останавливаем повтор…" : "Останавливаем локальный приём…"
             : state?.source_mode === "replay" ? "Остановить повтор" : preparedAcquisition ? "Завершить подготовленный приём" : "Остановить локальный приём"}

plugins/xgrids-k1/frontend/src/components/K1SpatialControls.tsx

@@ -1,7 +1,11 @@
 import { Button } from "@nodedc/ui-react";
 
 import type { DevicePluginConnectionProps } from "@mission-core/plugin-sdk";
-import type { AcquisitionState, XgridsAcquisition } from "../api";
+import type {
+  AcquisitionState,
+  OperatorPresenceConfirmation,
+  XgridsAcquisition,
+} from "../api";
 import {
   isSoftwareCommandedAcquisition,
   shouldRenderSpatialControls,
@@ -19,6 +23,14 @@ interface PhasePresentation {
   busy: boolean;
 }
 
+const PHYSICAL_ACCEPTANCE = {
+  operator_present: true,
+  owner_controlled_device: true,
+  lixelgo_closed: true,
+  battery_storage_confirmed: true,
+  expected_physical_state_confirmed: true,
+} satisfies OperatorPresenceConfirmation;
+
 function phasePresentation(
   acquisition: XgridsAcquisition,
   softwareCommanded: boolean,
@@ -58,8 +70,10 @@ function phasePresentation(
       busy: false,
     },
     awaiting_external_stop: {
-      label: "Ожидание остановки на устройстве",
-      detail: "Mission Core ждёт подтверждения физической остановки K1.",
+      label: softwareCommanded ? "K1 завершает и сохраняет" : "Ожидание остановки на устройстве",
+      detail: softwareCommanded
+        ? "STOP не повторяется. Дождитесь READY и постоянного зелёного индикатора."
+        : "Mission Core ждёт подтверждения физической остановки K1.",
       busy: true,
     },
     stopping: {
@@ -94,7 +108,7 @@ function formatDuration(seconds: number): string {
 
 export function K1SpatialControls(_props: DevicePluginConnectionProps) {
   const controller = useXgridsK1Controller();
-  const { state, pendingAction, stop } = controller;
+  const { state, pendingAction, stop, confirmStoppedAtSteadyGreen } = controller;
   const acquisition = state?.acquisition;
   const cleanupPending = acquisition?.cleanup_pending === true;
   if (!acquisition || !shouldRenderSpatialControls(state)) {
@@ -108,8 +122,14 @@ export function K1SpatialControls(_props: DevicePluginConnectionProps) {
     acquisition.state,
   );
   const stopDisabled = pendingAction !== null || stopping;
+  const controlFailure =
+    state.application_control_session?.state === "failed"
+      ? state.application_control_session.failure?.message ||
+        "Канонический диалог остановлен; автоматический повтор запрещён."
+      : null;
   const actionFailure = spatialActionFailure(
     controller.error ??
+      controlFailure ??
       (cleanupPending
         ? "Локальный поток или архив ещё не завершён. Повторите остановку."
         : null),
@@ -149,7 +169,7 @@ export function K1SpatialControls(_props: DevicePluginConnectionProps) {
         size="compact"
         variant="secondary"
         disabled={stopDisabled}
-        onClick={() => void stop()}
+        onClick={() => void stop(softwareCommanded ? PHYSICAL_ACCEPTANCE : undefined)}
       >
         {pendingAction === "stop"
           ? softwareCommanded ? "Останавливаем устройство…" : "Останавливаем приём…"
@@ -159,6 +179,16 @@ export function K1SpatialControls(_props: DevicePluginConnectionProps) {
               ? "Повторить остановку"
               : softwareCommanded ? "Остановить устройство и запись" : "Остановить локальный приём"}
       </Button>
+      {state?.application_control_session?.can_confirm_standby ? (
+        <Button
+          size="compact"
+          variant="primary"
+          disabled={pendingAction !== null}
+          onClick={() => void confirmStoppedAtSteadyGreen()}
+        >
+          Индикатор постоянно зелёный — завершить запись
+        </Button>
+      ) : null}
     </section>
   );
 }