# XGRIDS K1 frontend contribution

This source tree is owned by the XGRIDS device plugin and is statically linked
into the reviewed Mission Core Control Station build. It is not part of the
generic application source tree.

The contribution contains:

- `K1ProvisioningPipeline` for explicit BLE discovery and the three local
  connection directions: Bridge, Quick Connect and Direct Connect;
- `K1AcquisitionPipeline` for explicit canonical connection/workspace/project/
  START checkpoints, local receiver preparation and compatibility file replay;
- `K1SpatialControls` for an explicit no-retry STOP followed by the separate
  READY plus steady-green completion gate;
- plugin-local diagnostics, metrics, API state, lifecycle mapping,
  observation-source mapping and scoped styles;
- typed v0.7.0 supervised connection lifecycle and interactive application-control state plus legacy shadow
  inspection contracts;
- a click-correlated, non-secret provisioning presentation latch: after Apply,
  Steps 01–02 keep their selected-device/form anatomy with disabled controls
  until the exact connection attempt becomes reachable or reaches bounded
  recovery; the Wi-Fi password is cleared before asynchronous dispatch;
- policy-gated retirement of an unavailable historical K1 as an explicit
  local ledger action; it never emits a device command and never bypasses the
  public `retire-unavailable-physical-target` decision;
- `plugin.ts`, which binds the manifest `device.connection` component key to
  the runtime provider and connection view.

Imports from the host are limited to `@mission-core/plugin-sdk`, the public
frontend host surface, plus React and the NODE.DC UI kit. The only generic
Control Station import of this plugin is the reviewed composition root.
Arbitrary runtime JavaScript discovery is intentionally unsupported.