feat(device-plane): add core-initiated edge channel

2026-08-11 19:30:18 +03:00
parent 393741f1bd
commit 50b9179fe4
11 changed files with 2089 additions and 0 deletions
@@ -0,0 +1,67 @@
+{
+  "schemaVersion": "nodedc.device-edge.core-channel-source.v1",
+  "status": "source-accepted",
+  "authority": "DCPLATFORM-76/ADR-0001",
+  "designContract": "nodedc.device-edge.core-channel.v1",
+  "implementedAt": "2026-08-11",
+  "transport": {
+    "initiator": "device-gateway-core",
+    "listener": "device-edge-channel",
+    "protocol": "http2-bidirectional-ndjson",
+    "tls": "TLSv1.3-mutual-authentication",
+    "bearerAuthentication": false,
+    "genericTcpForwarding": false
+  },
+  "sourceComponents": [
+    "packages/device-edge-channel-contract",
+    "services/device-edge-channel",
+    "services/device-gateway-core"
+  ],
+  "identity": {
+    "edgeRegistrationRequired": true,
+    "edgeCertificatePinRequired": true,
+    "coreCertificateAllowlistRequired": true,
+    "unknownOrRevokedIdentity": "reject",
+    "privateKeysInSource": false,
+    "privateKeysInArtifact": false
+  },
+  "messageBoundary": {
+    "schema": "nodedc.device-edge.channel-envelope.v1",
+    "maximumEnvelopeBytes": 1048576,
+    "directionLocalSequence": true,
+    "unknownSchemaOrKind": "close-logical-session",
+    "acceptanceWindow": 128,
+    "trackerAckRule": "core-acceptance-required"
+  },
+  "realtime": {
+    "polling": false,
+    "keepaliveSeconds": 15,
+    "deadPeerSeconds": 45,
+    "reconnectMinimumSeconds": 1,
+    "reconnectMaximumSeconds": 30,
+    "delivery": "at-least-once-with-core-idempotency"
+  },
+  "sourceAcceptance": {
+    "devicePlaneTestsPassed": 189,
+    "tls13MutualAuthenticationTested": true,
+    "keepaliveTested": true,
+    "disconnectReconnectTested": true,
+    "idempotentReplayTested": true,
+    "unknownAndRevokedIdentityTested": true,
+    "oversizedEnvelopeTested": true,
+    "coreUnavailableRejectionTested": true,
+    "existingCoreImageBuild": "passed-no-cache",
+    "existingGatewayImageBuild": "passed-no-cache"
+  },
+  "runtime": {
+    "mutationInThisTransition": false,
+    "edgePort8443Published": false,
+    "trackerPort9921Published": false,
+    "synologyPublicIngress": false,
+    "trackerIngress": "disabled",
+    "commandTransport": "disabled",
+    "gelios": "untouched"
+  },
+  "nextGate": "closed-port-synthetic-runtime-transition-under-DCPLATFORM-21",
+  "rollback": "source-revert-only-runtime-unchanged"
+}