{root?.statement ?? "Наблюдение, планирование и корректировка миссий в одной модульной рабочей области."} diff --git a/apps/k1-viewer/src/components/MetricCard.tsx b/apps/control-station/src/components/MetricCard.tsx similarity index 100% rename from apps/k1-viewer/src/components/MetricCard.tsx rename to apps/control-station/src/components/MetricCard.tsx diff --git a/apps/k1-viewer/src/components/RerunViewport.tsx b/apps/control-station/src/components/RerunViewport.tsx similarity index 100% rename from apps/k1-viewer/src/components/RerunViewport.tsx rename to apps/control-station/src/components/RerunViewport.tsx diff --git a/apps/k1-viewer/src/main.tsx b/apps/control-station/src/main.tsx similarity index 100% rename from apps/k1-viewer/src/main.tsx rename to apps/control-station/src/main.tsx diff --git a/apps/k1-viewer/src/messages.ts b/apps/control-station/src/messages.ts similarity index 100% rename from apps/k1-viewer/src/messages.ts rename to apps/control-station/src/messages.ts diff --git a/apps/k1-viewer/src/presentation.ts b/apps/control-station/src/presentation.ts similarity index 100% rename from apps/k1-viewer/src/presentation.ts rename to apps/control-station/src/presentation.ts diff --git a/apps/k1-viewer/src/productModel.ts b/apps/control-station/src/productModel.ts similarity index 100% rename from apps/k1-viewer/src/productModel.ts rename to apps/control-station/src/productModel.ts diff --git a/apps/k1-viewer/src/sceneSettings.ts b/apps/control-station/src/sceneSettings.ts similarity index 100% rename from apps/k1-viewer/src/sceneSettings.ts rename to apps/control-station/src/sceneSettings.ts diff --git a/apps/k1-viewer/src/styles.css b/apps/control-station/src/styles.css similarity index 100% rename from apps/k1-viewer/src/styles.css rename to apps/control-station/src/styles.css diff --git a/apps/k1-viewer/src/styles/base.css b/apps/control-station/src/styles/base.css similarity index 100% rename from apps/k1-viewer/src/styles/base.css rename to apps/control-station/src/styles/base.css diff --git a/apps/k1-viewer/src/styles/device.css b/apps/control-station/src/styles/device.css similarity index 100% rename from apps/k1-viewer/src/styles/device.css rename to apps/control-station/src/styles/device.css diff --git a/apps/k1-viewer/src/styles/responsive.css b/apps/control-station/src/styles/responsive.css similarity index 100% rename from apps/k1-viewer/src/styles/responsive.css rename to apps/control-station/src/styles/responsive.css diff --git a/apps/k1-viewer/src/styles/scene-windows.css b/apps/control-station/src/styles/scene-windows.css similarity index 100% rename from apps/k1-viewer/src/styles/scene-windows.css rename to apps/control-station/src/styles/scene-windows.css diff --git a/apps/k1-viewer/src/styles/shell.css b/apps/control-station/src/styles/shell.css similarity index 100% rename from apps/k1-viewer/src/styles/shell.css rename to apps/control-station/src/styles/shell.css diff --git a/apps/k1-viewer/src/styles/spatial.css b/apps/control-station/src/styles/spatial.css similarity index 100% rename from apps/k1-viewer/src/styles/spatial.css rename to apps/control-station/src/styles/spatial.css diff --git a/apps/k1-viewer/src/styles/workspaces.css b/apps/control-station/src/styles/workspaces.css similarity index 100% rename from apps/k1-viewer/src/styles/workspaces.css rename to apps/control-station/src/styles/workspaces.css diff --git a/apps/k1-viewer/src/useK1Console.ts b/apps/control-station/src/useK1Console.ts similarity index 100% rename from apps/k1-viewer/src/useK1Console.ts rename to apps/control-station/src/useK1Console.ts diff --git a/apps/k1-viewer/src/workspaces/DeviceWorkspace.tsx b/apps/control-station/src/workspaces/DeviceWorkspace.tsx similarity index 100% rename from apps/k1-viewer/src/workspaces/DeviceWorkspace.tsx rename to apps/control-station/src/workspaces/DeviceWorkspace.tsx diff --git a/apps/k1-viewer/src/workspaces/Workspaces.tsx b/apps/control-station/src/workspaces/Workspaces.tsx similarity index 100% rename from apps/k1-viewer/src/workspaces/Workspaces.tsx rename to apps/control-station/src/workspaces/Workspaces.tsx diff --git a/apps/k1-viewer/tsconfig.app.json b/apps/control-station/tsconfig.app.json similarity index 100% rename from apps/k1-viewer/tsconfig.app.json rename to apps/control-station/tsconfig.app.json diff --git a/apps/k1-viewer/tsconfig.json b/apps/control-station/tsconfig.json similarity index 100% rename from apps/k1-viewer/tsconfig.json rename to apps/control-station/tsconfig.json diff --git a/apps/k1-viewer/tsconfig.node.json b/apps/control-station/tsconfig.node.json similarity index 100% rename from apps/k1-viewer/tsconfig.node.json rename to apps/control-station/tsconfig.node.json diff --git a/apps/k1-viewer/vite.config.ts b/apps/control-station/vite.config.ts similarity index 100% rename from apps/k1-viewer/vite.config.ts rename to apps/control-station/vite.config.ts diff --git a/docs/06_K1_LIVE_VIEWER.md b/docs/06_K1_LIVE_VIEWER.md index 3c1681a..59b392b 100644 --- a/docs/06_K1_LIVE_VIEWER.md +++ b/docs/06_K1_LIVE_VIEWER.md @@ -30,7 +30,7 @@ Rerun gRPC/proxy on TCP 9876 +--> rerun_grpc_url in REST/WebSocket state | v -self-hosted @rerun-io/web-viewer inside NODE.DC Control Station +self-hosted @rerun-io/web-viewer inside Mission Core Control Station React console <-- REST + WebSocket state --> FastAPI on 127.0.0.1:8000 ``` @@ -52,7 +52,7 @@ Prerequisites are the repository-local Python environment and Node.js 20.19+ or ```bash uv sync --group dev -cd apps/k1-viewer +cd apps/control-station npm install npm run typecheck npm run build @@ -121,7 +121,7 @@ does not publish an application request or modeling command. On the first live or replay session, `RerunBridge`: -- creates an explicit `RecordingStream("nodedc_device_spatial")`; +- creates an explicit `RecordingStream("nodedc_mission_core_spatial")`; - installs the default spatial blueprint; - starts the gRPC/proxy server on TCP 9876 with a 512 MiB late-client buffer; - reports `rerun+http://127.0.0.1:9876/proxy` only after the server is ready; diff --git a/docs/07_MISSION_CORE_MONOREPO.md b/docs/07_MISSION_CORE_MONOREPO.md new file mode 100644 index 0000000..7ed82fa --- /dev/null +++ b/docs/07_MISSION_CORE_MONOREPO.md @@ -0,0 +1,39 @@ +# NODEDC MISSION CORE monorepo + +This document maps the renamed repository to the target Mission Core +architecture without claiming that unfinished package boundaries already +exist. + +## Current layout + +| Path | Current responsibility | Target responsibility | +| --- | --- | --- | +| `apps/control-station/` | React shell, device workflow, spatial scene | Vendor-neutral operator application | +| `src/k1link/web/` | Local FastAPI control plane and K1 session orchestration | Generic host APIs plus plugin supervisor | +| `src/k1link/viewer/` | Replay runtime and Rerun adapter | Canonical scene sink and presentation adapter | +| `src/k1link/ble/` | K1 BLE discovery and reviewed provisioning | `plugins/xgrids-k1` | +| `src/k1link/mqtt/` | Raw-first K1 MQTT capture | `plugins/xgrids-k1` behind EvidenceStore | +| `src/k1link/protocol/` | Firmware-scoped K1 codecs | `plugins/xgrids-k1` | +| `packages/plugin-sdk/` | Contract placeholder | Versioned manifests, capabilities, lifecycle, schemas | +| `plugins/xgrids-k1/` | Extraction boundary and documentation | Independently versioned device plugin | + +## Extraction order + +1. Define canonical PointCloud, Pose, DeviceStatus, RawEnvelope, and metrics + contracts in the Plugin SDK. +2. Make Rerun consume canonical frames rather than K1 MQTT topics. +3. Extract codecs and replay parity fixtures. +4. Extract raw capture with fault isolation between evidence and preview. +5. Extract BLE/Wi-Fi provisioning and MQTT into a least-privilege edge worker. +6. Replace K1-specific host routes and state with plugin/device-session APIs. +7. Drive the connection wizard from plugin capabilities and schemas. +8. Re-run native replay and the physical BLE → Wi-Fi → MQTT → scene acceptance. + +## Invariants + +- Raw evidence is durable before preview work. +- Mission Core starts when the XGRIDS plugin is absent or disabled. +- The plugin cannot add global navigation or arbitrary CSS. +- Vendor writes and commands require declared capabilities and operator gates. +- The visualization engine can be replaced without changing device plugins. +- Real captures and credentials remain outside Git. diff --git a/docs/adr/0002-mission-core-monorepo.md b/docs/adr/0002-mission-core-monorepo.md new file mode 100644 index 0000000..7f3871f --- /dev/null +++ b/docs/adr/0002-mission-core-monorepo.md @@ -0,0 +1,59 @@ +# ADR 0002: NODEDC MISSION CORE monorepo + +- Status: accepted +- Date: 2026-07-16 + +## Context + +The repository began as a focused XGRIDS/LixelKity K1 connector and then gained +a vendor-neutral control-station shell, local control plane, replay runtime, and +embedded spatial viewer. The K1 vertical is proven on real hardware, but its +names and implementation are still coupled to the host. + +## Decision + +The product, repository, and local root are named NODEDC MISSION CORE. The +canonical Git path is `SILVER/NODEDC_MISSION_CORE`, and the local checkout is +`NODEDC_MISSION_CORE`. + +Mission Core remains one monorepo while the first plugin contract stabilizes: + +```text +apps/control-station/ browser operator application +packages/plugin-sdk/ shared plugin contracts and host interfaces +plugins/xgrids-k1/ XGRIDS/LixelKity K1 device plugin +src/k1link/ transitional compatibility implementation +docs/ architecture, runbooks, ADRs, and redacted evidence +``` + +An independent plugin does not require an independent Git repository at this +stage. The XGRIDS plugin must have an explicit package/runtime boundary, +manifest, capabilities, tests, and no ownership of Mission Core navigation. +It can be split into another repository later without changing host contracts. + +The Rerun integration is a replaceable presentation adapter. It is not the +Mission Core data bus, session database, or device protocol. + +## Compatibility boundary + +The rename does not alter these proven interfaces: + +- Python import namespace and CLI `k1link`; +- native `.k1mqtt` framing and `K1MQTT` magic; +- provisioning profile `xgrids-k1-fw3-wifi-v1`; +- K1 MQTT topics and firmware-scoped protobuf/LZ4 codecs; +- current `k1_ip`, `K1Metrics`, and `useK1Console` compatibility fields; +- schema v1 `$id`, which remains an immutable legacy identifier. + +Those names move or change only during the plugin-extraction milestone with +explicit migration and regression tests. + +## Consequences + +- Product branding, repository metadata, frontend application path, API title, + and Rerun recording identity use Mission Core naming now. +- The existing K1 implementation remains operational while contracts are + extracted incrementally. +- Core must eventually boot without the XGRIDS plugin. +- Plugin failure must not terminate the Mission Core host or raw evidence plane. +- A future repository split remains possible after Plugin SDK v1 is stable. diff --git a/packages/plugin-sdk/README.md b/packages/plugin-sdk/README.md new file mode 100644 index 0000000..2a17997 --- /dev/null +++ b/packages/plugin-sdk/README.md @@ -0,0 +1,18 @@ +# Mission Core Plugin SDK + +This directory reserves the versioned host/plugin contract. It is not yet a +published SDK and must not be treated as an implemented runtime. + +The first contract will define: + +- plugin manifest, version compatibility, firmware profiles, and permissions; +- discovery candidates and opaque device references; +- provisioning requests using secret references; +- device-session lifecycle and health; +- EvidenceStore handles and raw-artifact lineage; +- canonical PointCloud, Pose, DeviceStatus, and metrics envelopes; +- SceneSink and event interfaces; +- capability-driven UI contribution data without plugin-owned layout. + +The XGRIDS K1 extraction is the first acceptance test. A synthetic reference +plugin will verify that no K1 names or protocol assumptions remain in core. diff --git a/plugins/xgrids-k1/README.md b/plugins/xgrids-k1/README.md new file mode 100644 index 0000000..26459a4 --- /dev/null +++ b/plugins/xgrids-k1/README.md @@ -0,0 +1,26 @@ +# XGRIDS / LixelKity K1 plugin + +This directory is the target package boundary for the first Mission Core device +plugin. The verified implementation remains temporarily in `src/k1link` so the +real-device path stays operational during extraction. + +The plugin owns: + +- BLE discovery hints and K1 GATT metadata; +- the reviewed firmware-3 Wi-Fi provisioning profile; +- K1 LAN status and private-address validation; +- subscribe-only MQTT transport and report-topic allowlist; +- native `.k1mqtt` capture; +- firmware-scoped protobuf/LZ4 and legacy codecs; +- normalization of K1 point cloud, pose, status, health, and artifacts; +- K1-specific operator instructions and compatibility tests. + +The plugin does not own: + +- Mission Core navigation, fleet, missions, users, roles, or audit; +- the generic spatial scene or Rerun Web Viewer; +- platform storage, remote transport, or other devices. + +Until extraction is complete, `src/k1link` is the compatibility source of +truth and every move into this package must preserve replay and real-device +acceptance. diff --git a/pyproject.toml b/pyproject.toml index c2510c3..6e3aa69 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,9 +3,9 @@ requires = ["hatchling>=1.27,<2"] build-backend = "hatchling.build" [project] -name = "ndc-xgrids-k1-connector" +name = "nodedc-mission-core" version = "0.1.0" -description = "macOS-first, evidence-led research tooling for an XGRIDS Lixel K1" +description = "NODEDC Mission Core monorepo for mission control, spatial observation, and device plugins" readme = "README.md" requires-python = ">=3.12,<3.13" license = { text = "Proprietary" } diff --git a/schemas/session-manifest.schema.json b/schemas/session-manifest.schema.json index 72e0997..137fea8 100644 --- a/schemas/session-manifest.schema.json +++ b/schemas/session-manifest.schema.json @@ -1,6 +1,7 @@ { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://git.dcserve.ru/SILVER/NDC_xgrids-k1-connector/schemas/session-manifest.schema.json", + "$comment": "The legacy v1 schema identifier is intentionally immutable after the repository rename to NODEDC_MISSION_CORE.", "title": "K1 laboratory session manifest", "type": "object", "additionalProperties": false, diff --git a/src/k1link/__init__.py b/src/k1link/__init__.py index ee4620f..1a9005c 100644 --- a/src/k1link/__init__.py +++ b/src/k1link/__init__.py @@ -1,3 +1,3 @@ -"""NDC XGRIDS K1 connector research tooling.""" +"""Mission Core runtime with the transitional XGRIDS K1 compatibility adapter.""" __version__ = "0.1.0" diff --git a/src/k1link/cli.py b/src/k1link/cli.py index 5eb1897..2550229 100644 --- a/src/k1link/cli.py +++ b/src/k1link/cli.py @@ -208,15 +208,15 @@ def serve_console( typer.Option(min=1024, max=65535, help="Loopback HTTP port for the local console."), ] = 8000, ) -> None: - """Serve the built K1 console and local-only control API on loopback.""" - frontend = Path(__file__).resolve().parents[2] / "apps" / "k1-viewer" / "dist" + """Serve the built Mission Core Control Station and loopback control API.""" + frontend = Path(__file__).resolve().parents[2] / "apps" / "control-station" / "dist" if not frontend.is_dir(): console.print( "[red]Frontend build is missing.[/red] Run npm install && npm run build " - "inside apps/k1-viewer." + "inside apps/control-station." ) raise typer.Exit(code=2) - console.print(f"K1 Live Console: http://127.0.0.1:{port}") + console.print(f"NODEDC MISSION CORE: http://127.0.0.1:{port}") console.print("The credential endpoint is bound to this Mac only.") uvicorn.run( "k1link.web.app:app", diff --git a/src/k1link/viewer/foxglove_bridge.py b/src/k1link/viewer/foxglove_bridge.py index ef92982..2049b0d 100644 --- a/src/k1link/viewer/foxglove_bridge.py +++ b/src/k1link/viewer/foxglove_bridge.py @@ -171,7 +171,7 @@ class FoxgloveBridge: ) -> None: self.metrics = metrics or BridgeMetrics() self._server = foxglove.start_server( - name="NODE.DC K1 live bridge", + name="Mission Core K1 legacy bridge", host=host, port=port, message_backlog_size=32, diff --git a/src/k1link/viewer/rerun_bridge.py b/src/k1link/viewer/rerun_bridge.py index 81d296a..f4e2c34 100644 --- a/src/k1link/viewer/rerun_bridge.py +++ b/src/k1link/viewer/rerun_bridge.py @@ -74,7 +74,7 @@ class RerunBridge: self._settings_provider = settings_provider or RerunSceneSettings self._settings = self._settings_provider() self._recording = (recording_factory or rr.RecordingStream)( - "nodedc_device_spatial" + "nodedc_mission_core_spatial" ) blueprint = _blueprint(self._settings) self._url = self._recording.serve_grpc( diff --git a/src/k1link/web/__init__.py b/src/k1link/web/__init__.py index f56acf8..0b1301a 100644 --- a/src/k1link/web/__init__.py +++ b/src/k1link/web/__init__.py @@ -1 +1 @@ -"""Local-only control API for the K1 live console.""" +"""Local Mission Core control plane with the transitional XGRIDS adapter.""" diff --git a/src/k1link/web/app.py b/src/k1link/web/app.py index c0ab206..ca38473 100644 --- a/src/k1link/web/app.py +++ b/src/k1link/web/app.py @@ -261,7 +261,7 @@ async def app_lifespan(_: FastAPI) -> AsyncIterator[None]: app = FastAPI( - title="NODE.DC Device Control API", + title="NODEDC Mission Core API", version=__version__, docs_url="/api/docs", redoc_url=None, @@ -275,7 +275,7 @@ def health() -> dict[str, Any]: return { "ok": True, "status": "ok", - "service": "k1-live-console", + "service": "mission-core-control-plane", "version": __version__, } @@ -341,7 +341,7 @@ async def events(websocket: WebSocket) -> None: return -frontend_dist = REPOSITORY_ROOT / "apps" / "k1-viewer" / "dist" +frontend_dist = REPOSITORY_ROOT / "apps" / "control-station" / "dist" if frontend_dist.is_dir(): app.mount("/", StaticFiles(directory=frontend_dist, html=True), name="frontend") diff --git a/uv.lock b/uv.lock index 5b5d8da..cc93a09 100644 --- a/uv.lock +++ b/uv.lock @@ -269,7 +269,7 @@ wheels = [ ] [[package]] -name = "ndc-xgrids-k1-connector" +name = "nodedc-mission-core" version = "0.1.0" source = { editable = "." } dependencies = [