#!/usr/bin/env node
import { createHash } from "node:crypto";
import { spawnSync } from "node:child_process";
import { cp, lstat, mkdir, mkdtemp, readFile, readdir, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { dirname, join, relative, resolve } from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";

const scriptDir = dirname(fileURLToPath(import.meta.url));
const platformRoot = resolve(scriptDir, "../..");
const devicePlaneRoot = platformRoot;
const managerRoot = resolve(platformRoot, "apps/device-manager");
const artifactDir = resolve(process.env.NODEDC_DEPLOY_ARTIFACT_DIR || resolve(scriptDir, "../deploy-artifacts"));
const [patchId = "device-manager-release-v13-20260823-051", ...extra] = process.argv.slice(2);
if (extra.length || !/^[A-Za-z0-9._-]{1,96}$/.test(patchId)) throw new Error("usage: build-device-manager-control-plane-artifact.mjs [patch-id]");

const descriptorPath = patchId.startsWith("device-manager-release-v13-")
  ? "deployment/device-manager-release-v13.json"
  : patchId.startsWith("device-manager-release-v12-")
    ? "deployment/device-manager-release-v12.json"
    : patchId.startsWith("device-manager-release-v11-")
    ? "deployment/device-manager-release-v11.json"
    : patchId.startsWith("device-manager-release-v10-")
    ? "deployment/device-manager-release-v10.json"
  : patchId.startsWith("device-manager-release-v9-")
    ? "deployment/device-manager-release-v9.json"
  : patchId.startsWith("device-manager-release-v8-")
    ? "deployment/device-manager-release-v8.json"
  : patchId.startsWith("device-manager-release-v7-")
    ? "deployment/device-manager-release-v7.json"
  : patchId.startsWith("device-manager-release-v6-")
    ? "deployment/device-manager-release-v6.json"
  : patchId.startsWith("device-manager-release-v5-")
    ? "deployment/device-manager-release-v5.json"
    : patchId.startsWith("device-manager-release-v4-")
      ? "deployment/device-manager-release-v4.json"
      : patchId.startsWith("device-manager-release-v3-")
        ? "deployment/device-manager-release-v3.json"
        : "deployment/device-manager-release-v1.json";

const isV3 = descriptorPath.endsWith("release-v3.json");
const isV4 = descriptorPath.endsWith("release-v4.json");
const isV5 = descriptorPath.endsWith("release-v5.json");
const isV6 = descriptorPath.endsWith("release-v6.json");
const isV7 = descriptorPath.endsWith("release-v7.json");
const isV8 = descriptorPath.endsWith("release-v8.json");
const isV9 = descriptorPath.endsWith("release-v9.json");
const isV10 = descriptorPath.endsWith("release-v10.json");
const isV11 = descriptorPath.endsWith("release-v11.json");
const isV12 = descriptorPath.endsWith("release-v12.json");
const isV13 = descriptorPath.endsWith("release-v13.json");
const isPersistent = isV4 || isV5 || isV6 || isV7 || isV8 || isV9 || isV10 || isV11 || isV12 || isV13;
const isManagerOnly = isV3 || isPersistent;
const composeSource = resolve(devicePlaneRoot, "docker-compose.device-manager.yml");
const composeSourceSha256 = createHash("sha256").update(await readFile(composeSource)).digest("hex");
if (!isPersistent && composeSourceSha256 !== "4954120aaddc999798b64c304d8cf692b79714feb727d873117bd1f3434e865e") {
  throw new Error("historical_device_manager_compose_has_advanced");
}
const entries = isManagerOnly ? [
  "docker-compose.device-manager.yml",
  "services/device-manager",
  descriptorPath,
] : [
  ".dockerignore",
  "package.json",
  "package-lock.json",
  "docker-compose.device-manager.yml",
  "packages/device-protocol-contract",
  "packages/device-edge-channel-contract",
  "packages/arusnavi-b2-adapter",
  "services/device-control-core",
  "services/device-gateway/package.json",
  "services/device-edge-relay/package.json",
  "services/device-manager",
  descriptorPath,
];
const stage = await mkdtemp(join(tmpdir(), "nodedc-device-manager-control-plane-"));
const payload = join(stage, "payload");
const target = join(artifactDir, `nodedc-device-plane-${patchId}.tgz`);
try {
  const build = spawnSync("npm", ["run", "build", "--workspace", "@nodedc/device-manager"], {
    cwd: platformRoot,
    encoding: "utf8",
    maxBuffer: 64 * 1024 * 1024,
  });
  if (build.status !== 0) throw new Error(`device_manager_build_failed:${build.stderr || build.stdout}`);
  await mkdir(payload, { recursive: true });
  for (const entry of entries) {
    if (entry === descriptorPath) {
      const descriptor = JSON.parse(await readFile(resolve(devicePlaneRoot, entry), "utf8"));
      if (descriptor.releaseId !== "__PATCH_ID__") {
        throw new Error("device_manager_release_template_id_mismatch");
      }
      descriptor.releaseId = patchId;
      const destination = join(payload, entry);
      await mkdir(dirname(destination), { recursive: true });
      await writeFile(destination, `${JSON.stringify(descriptor, null, 2)}\n`, "utf8");
      continue;
    }
    if (entry === "services/device-manager") {
      const destination = join(payload, entry);
      await mkdir(destination, { recursive: true });
      await copySafe(resolve(devicePlaneRoot, "services/device-manager/Dockerfile"), join(destination, "Dockerfile"), devicePlaneRoot);
      await copySafe(resolve(managerRoot, "server"), join(destination, "server"), managerRoot);
      await copySafe(resolve(managerRoot, "dist"), join(destination, "dist"), managerRoot);
      continue;
    }
    await copySafe(resolve(devicePlaneRoot, entry), join(payload, entry), devicePlaneRoot);
  }
  if (!isManagerOnly) {
    await validateDockerCopySources(
      join(payload, "services/device-control-core/Dockerfile"),
      payload,
    );
  }
  await validateDockerCopySources(
    join(payload, "services/device-manager/Dockerfile"),
    join(payload, "services/device-manager"),
  );
  for (const modulePath of isManagerOnly ? [] : [
    "services/device-control-core/src/sensitive-reference-management.mjs",
    "services/device-control-core/src/device-gateway-core-runtime.mjs",
    "packages/device-edge-channel-contract/src/index.mjs",
  ]) {
    const coreImport = spawnSync(
      process.execPath,
      [
        "--input-type=module",
        "--eval",
        `import(${JSON.stringify(pathToFileURL(join(payload, modulePath)).href)})`,
      ],
      {
        cwd: payload,
        encoding: "utf8",
        maxBuffer: 16 * 1024 * 1024,
      },
    );
    if (coreImport.status !== 0) {
      throw new Error(
        `device_control_core_staged_module_import_failed:${modulePath}:${coreImport.stderr || coreImport.stdout}`,
      );
    }
  }
  const compose = await readFile(join(payload, "docker-compose.device-manager.yml"), "utf8");
  for (const required of [
    "device-manager:",
    "DEVICE_MANAGEMENT_API_ENABLED: \"true\"",
    "NODEDC_LAUNCHER_INTERNAL_TOKEN_FILE: /run/nodedc-secrets/device-core-internal-token",
    "NODEDC_DEVICE_CORE_TOKEN_FILE: /run/nodedc-secrets/management-core-token",
    "name: nodedc-platform_edge",
    ...(isPersistent ? [
      "NODEDC_DEVICE_MANAGER_PRESENTATION_PATH: /var/lib/nodedc-device-manager/device-manager-presentation.json",
      "NODEDC_DEVICE_MANAGER_MEDIA_ROOT: /var/lib/nodedc-device-manager/media",
      "source: /volume1/docker/nodedc-device-plane/data/device-manager",
      "target: /var/lib/nodedc-device-manager",
      "read_only: false",
      "create_host_path: false",
    ] : []),
  ]) if (!compose.includes(required)) throw new Error(`device_manager_compose_contract_missing:${required}`);
  for (const forbidden of [
    "NODEDC_INTERNAL_ACCESS_TOKEN:",
    "NODEDC_PLATFORM_SERVICE_TOKEN:",
    "PRIVATE KEY",
    "DEVICE_EDGE_CHANNEL_",
    "device-edge-channel/",
    "nodedc-device-plane-egress",
    "0.0.0.0:18122",
    "0.0.0.0:9921:9921",
    "- \"9921:9921\"",
  ]) {
    if (compose.includes(forbidden)) throw new Error(`device_manager_compose_boundary_violation:${forbidden}`);
  }
  const descriptor = JSON.parse(await readFile(join(payload, descriptorPath), "utf8"));
  const predecessor = descriptor.predecessor;
  const commonContractInvalid = (
    descriptor.releaseId !== patchId
    || !["activate", "upgrade"].includes(descriptor.action)
    || !predecessor
    || !["reconciliation", "release"].includes(predecessor.kind)
    || !/^[A-Za-z0-9._-]{1,96}$/.test(predecessor.patchId || "")
    || !/^[a-f0-9]{64}$/.test(predecessor.artifactSha256 || "")
    || (descriptor.action === "activate") !== (predecessor.kind === "reconciliation")
    || descriptor.healthGate !== (isPersistent
      ? "bounded-container-grace+core-contract+persistent-data"
      : "bounded-container-grace+core-contract")
    || descriptor.rollback !== (isPersistent
      ? "restore-preapply-snapshot-preserve-manager-data"
      : "restore-preapply-snapshot")
  );
  if (commonContractInvalid) throw new Error("device_manager_activation_successor_contract_mismatch");
  if (descriptorPath.endsWith("release-v13.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v13"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v12-20260823-050"
      || descriptor.predecessor?.artifactSha256 !== "1a49839140e5f2e49763d78f24ee47d946e244bcfde15a9c38266e8bd14c0d49"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v4-20260823-047"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "4aecceeb8d400fdd3dbec8fc86b151691f389d165e72677f396f8994823b6b5c"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.designSystem !== "nodedc-canonical-components-and-tokens-v1"
      || descriptor.missionCoreReference !== "compute-modules-workspace-71c8b04"
      || descriptor.infrastructureWorkspaceLayout !== "mission-core-system-workspace-v2"
      || descriptor.hostInventoryComposition !== "mission-core-compute-host-accordion-v2"
      || descriptor.hostInventoryOverviewSurface !== "separate-summary-soft-surface-v1"
      || descriptor.hostInventoryCollectionSurface !== "separate-host-collection-soft-surface-v1"
      || descriptor.hostInventoryRow !== "compact-centered-accordion-v1"
      || descriptor.hostInventoryFreshness !== "dot-only-v1"
      || descriptor.hostInventoryRelations !== "host-scoped-endpoint-deployment-service-v1"
      || descriptor.hostInventoryDefaultExpansion !== "collapsed"
      || descriptor.hostInventoryScaleTarget !== "five-hundred-collapsed-rows-v1"
      || descriptor.telemetryWorkspace !== "mission-core-compute-module-adaptive-window-v3"
      || descriptor.telemetrySurface !== "borderless-soft-surface-v1"
      || descriptor.telemetryStatus !== "mission-core-dot-status-v1"
      || descriptor.telemetryNavigation !== "full-workspace-back-navigation-v1"
      || descriptor.telemetryScroll !== "reset-on-workspace-transition-v1"
      || descriptor.telemetryPollInterval !== "three-seconds"
      || descriptor.telemetryFreshness !== "fifteen-seconds-missing-stale-not-unhealthy"
      || descriptor.telemetryOntologyProjection !== "observation-observed-property-provenance-freshness-v1"
      || descriptor.telemetryAgent !== "telegraf-host-observer-v1"
      || descriptor.telemetryGraphScale !== "adaptive-observed-window-explicit-domain-v1"
      || descriptor.telemetryCpuMinimumSpan !== "five-percentage-points"
      || descriptor.telemetryMemoryMinimumSpan !== "four-percentage-points"
      || descriptor.telemetryNetworkMissingSemantics !== "missing-counters-never-zero-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v13_host_inventory_accordion_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v13");
  } else if (descriptorPath.endsWith("release-v12.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v12"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v11-20260823-049"
      || descriptor.predecessor?.artifactSha256 !== "c1e2056b50bfbb0d03d077461d0c27cc56cc52967c3f5620be14871c8a6d5cf0"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v4-20260823-047"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "4aecceeb8d400fdd3dbec8fc86b151691f389d165e72677f396f8994823b6b5c"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.designSystem !== "nodedc-canonical-components-and-tokens-v1"
      || descriptor.missionCoreReference !== "compute-modules-workspace-71c8b04"
      || descriptor.infrastructureWorkspaceLayout !== "mission-core-system-workspace-v1"
      || descriptor.hostInventoryComposition !== "mission-core-compute-host-list-v1"
      || descriptor.telemetryWorkspace !== "mission-core-compute-module-adaptive-window-v3"
      || descriptor.telemetrySurface !== "borderless-soft-surface-v1"
      || descriptor.telemetryStatus !== "mission-core-dot-status-v1"
      || descriptor.telemetryNavigation !== "full-workspace-back-navigation-v1"
      || descriptor.telemetryScroll !== "reset-on-workspace-transition-v1"
      || descriptor.telemetryPollInterval !== "three-seconds"
      || descriptor.telemetryFreshness !== "fifteen-seconds-missing-stale-not-unhealthy"
      || descriptor.telemetryOntologyProjection !== "observation-observed-property-provenance-freshness-v1"
      || descriptor.telemetryAgent !== "telegraf-host-observer-v1"
      || descriptor.telemetryGraphScale !== "adaptive-observed-window-explicit-domain-v1"
      || descriptor.telemetryCpuMinimumSpan !== "five-percentage-points"
      || descriptor.telemetryMemoryMinimumSpan !== "four-percentage-points"
      || descriptor.telemetryNetworkMissingSemantics !== "missing-counters-never-zero-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v12_adaptive_telemetry_graph_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v12");
  } else if (descriptorPath.endsWith("release-v11.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v11"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v10-20260823-048"
      || descriptor.predecessor?.artifactSha256 !== "e6b983a314db4f8c27d89062dfedf5ed0523cc30421170799d181a19e2d85d4c"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v4-20260823-047"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "4aecceeb8d400fdd3dbec8fc86b151691f389d165e72677f396f8994823b6b5c"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.designSystem !== "nodedc-canonical-components-and-tokens-v1"
      || descriptor.missionCoreReference !== "compute-modules-workspace-71c8b04"
      || descriptor.infrastructureWorkspaceLayout !== "mission-core-system-workspace-v1"
      || descriptor.hostInventoryComposition !== "mission-core-compute-host-list-v1"
      || descriptor.telemetryWorkspace !== "mission-core-compute-module-visual-parity-v2"
      || descriptor.telemetrySurface !== "borderless-soft-surface-v1"
      || descriptor.telemetryStatus !== "mission-core-dot-status-v1"
      || descriptor.telemetryNavigation !== "full-workspace-back-navigation-v1"
      || descriptor.telemetryScroll !== "reset-on-workspace-transition-v1"
      || descriptor.telemetryPollInterval !== "three-seconds"
      || descriptor.telemetryFreshness !== "fifteen-seconds-missing-stale-not-unhealthy"
      || descriptor.telemetryOntologyProjection !== "observation-observed-property-provenance-freshness-v1"
      || descriptor.telemetryAgent !== "telegraf-host-observer-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v11_mission_core_visual_parity_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v11");
  } else if (descriptorPath.endsWith("release-v10.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v10"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v8-20260822-039"
      || descriptor.predecessor?.artifactSha256 !== "30a83d4c6b5c029c96c4af19fa558e0ae75e4b60bc897881457304bd17e0e465"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v4-20260823-047"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "4aecceeb8d400fdd3dbec8fc86b151691f389d165e72677f396f8994823b6b5c"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.telemetryWorkspace !== "mission-core-compute-module-parity-v1"
      || descriptor.telemetryNavigation !== "full-workspace-back-navigation-v1"
      || descriptor.telemetryPollInterval !== "three-seconds"
      || descriptor.telemetryFreshness !== "fifteen-seconds-missing-stale-not-unhealthy"
      || descriptor.telemetryOntologyProjection !== "observation-observed-property-provenance-freshness-v1"
      || descriptor.telemetryAgent !== "telegraf-host-observer-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v10_host_telemetry_workspace_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v10");
  } else if (descriptorPath.endsWith("release-v9.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v9"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v8-20260822-039"
      || descriptor.predecessor?.artifactSha256 !== "30a83d4c6b5c029c96c4af19fa558e0ae75e4b60bc897881457304bd17e0e465"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v3-20260822-040"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "08448a56cdf391076f92c5242e368fd0033b420167874645eebfa1f22184ee92"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.telemetryWorkspace !== "mission-core-compute-module-parity-v1"
      || descriptor.telemetryNavigation !== "full-workspace-back-navigation-v1"
      || descriptor.telemetryPollInterval !== "three-seconds"
      || descriptor.telemetryFreshness !== "fifteen-seconds-missing-stale-not-unhealthy"
      || descriptor.telemetryOntologyProjection !== "observation-observed-property-provenance-freshness-v1"
      || descriptor.telemetryAgent !== "telegraf-host-observer-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v9_host_telemetry_workspace_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v9");
  } else if (descriptorPath.endsWith("release-v8.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v8"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v6-20260822-035"
      || descriptor.predecessor?.artifactSha256 !== "193faabe930e2b3f212f8eb45288e39f850ec714528b28881095be654baf9a80"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260822-038"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "e2d062b82b022dba662522b5d6e192026ac964d78950d903295ca3cbbc95ab28"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.presentationPersistence !== "runner-managed-host-data-bind"
      || descriptor.presentationDataHostPath !== "/volume1/docker/nodedc-device-plane/data/device-manager"
      || descriptor.presentationDataContainerPath !== "/var/lib/nodedc-device-manager"
      || descriptor.presentationDataOwnership !== "uid-1000-gid-1000-mode-0750"
      || descriptor.presentationDataLifecycle !== "preserve-across-manager-recreate-and-source-rollback"
      || descriptor.presentationPath !== "/var/lib/nodedc-device-manager/device-manager-presentation.json"
      || descriptor.mediaRoot !== "/var/lib/nodedc-device-manager/media"
      || descriptor.defaultAccentHex !== "#f5f5f5"
      || descriptor.overviewLayout !== "mission-core-landing-stage-v1"
      || descriptor.faviconSet !== "nodedc-adaptive-v1"
      || descriptor.commandFormLayout !== "aligned-control-row-v1"
      || descriptor.secondaryEmptyTypography !== "help-text-sm-v1"
      || descriptor.infrastructureHostProjection !== "ontology-backed-host-runtime-v1"
      || descriptor.ontologyFoundation !== "ontology-core-device-foundation-20260822-001"
      || descriptor.ontologyCatalogHash !== "229c61c02a790906"
      || descriptor.assetBinding !== "temporal-device-asset-binding-v1"
      || descriptor.infrastructureRuntime !== "host-endpoint-deployment-service-instance-v1"
      || descriptor.healthEvidence !== "ttl-observation-missing-not-unhealthy-v1"
      || descriptor.interactiveShell !== "disabled-pending-managed-session-boundary"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v8_canonical_ontology_runtime_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v8");
  } else if (descriptorPath.endsWith("release-v7.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v7"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v6-20260822-035"
      || descriptor.predecessor?.artifactSha256 !== "193faabe930e2b3f212f8eb45288e39f850ec714528b28881095be654baf9a80"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260822-036"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "8708cc4b59fa0cd5e9c6e6a7b2654ba01ea60271549167aca2631f94000d3da3"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.presentationPersistence !== "runner-managed-host-data-bind"
      || descriptor.presentationDataHostPath !== "/volume1/docker/nodedc-device-plane/data/device-manager"
      || descriptor.presentationDataContainerPath !== "/var/lib/nodedc-device-manager"
      || descriptor.presentationDataOwnership !== "uid-1000-gid-1000-mode-0750"
      || descriptor.presentationDataLifecycle !== "preserve-across-manager-recreate-and-source-rollback"
      || descriptor.presentationPath !== "/var/lib/nodedc-device-manager/device-manager-presentation.json"
      || descriptor.mediaRoot !== "/var/lib/nodedc-device-manager/media"
      || descriptor.defaultAccentHex !== "#f5f5f5"
      || descriptor.overviewLayout !== "mission-core-landing-stage-v1"
      || descriptor.faviconSet !== "nodedc-adaptive-v1"
      || descriptor.commandFormLayout !== "aligned-control-row-v1"
      || descriptor.secondaryEmptyTypography !== "help-text-sm-v1"
      || descriptor.infrastructureHostProjection !== "edge-registration-live-channel-v1"
      || descriptor.ontologyStatus !== "generic-host-domain-candidate-not-canonical"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v7_infrastructure_host_projection_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v7");
  } else if (descriptorPath.endsWith("release-v6.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v6"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v5-20260822-034"
      || descriptor.predecessor?.artifactSha256 !== "acc1d2ae2cda66861054826928c25d01a2428e688cc8132a9c381831bf29ab5a"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260821-030"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "8459521a662541a5a87cb0188991cdcfb51727427db8ec2a232ce4846bfc3454"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.presentationPersistence !== "runner-managed-host-data-bind"
      || descriptor.presentationDataHostPath !== "/volume1/docker/nodedc-device-plane/data/device-manager"
      || descriptor.presentationDataContainerPath !== "/var/lib/nodedc-device-manager"
      || descriptor.presentationDataOwnership !== "uid-1000-gid-1000-mode-0750"
      || descriptor.presentationDataLifecycle !== "preserve-across-manager-recreate-and-source-rollback"
      || descriptor.presentationPath !== "/var/lib/nodedc-device-manager/device-manager-presentation.json"
      || descriptor.mediaRoot !== "/var/lib/nodedc-device-manager/media"
      || descriptor.defaultAccentHex !== "#f5f5f5"
      || descriptor.overviewLayout !== "mission-core-landing-stage-v1"
      || descriptor.faviconSet !== "nodedc-adaptive-v1"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v6_favicon_contract_mismatch");
    await validateFaviconBundle(payload, "device_manager_v6");
  } else if (descriptorPath.endsWith("release-v5.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v5"
      || descriptor.predecessor?.kind !== "release"
      || descriptor.predecessor?.patchId !== "device-manager-release-v4-20260822-033"
      || descriptor.predecessor?.artifactSha256 !== "52ba322042f1e4f595bbfea99f8bb35630b15984e0da648dc55348bc9e5b2066"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260821-030"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "8459521a662541a5a87cb0188991cdcfb51727427db8ec2a232ce4846bfc3454"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.presentationPersistence !== "runner-managed-host-data-bind"
      || descriptor.presentationDataHostPath !== "/volume1/docker/nodedc-device-plane/data/device-manager"
      || descriptor.presentationDataContainerPath !== "/var/lib/nodedc-device-manager"
      || descriptor.presentationDataOwnership !== "uid-1000-gid-1000-mode-0750"
      || descriptor.presentationDataLifecycle !== "preserve-across-manager-recreate-and-source-rollback"
      || descriptor.presentationPath !== "/var/lib/nodedc-device-manager/device-manager-presentation.json"
      || descriptor.mediaRoot !== "/var/lib/nodedc-device-manager/media"
      || descriptor.defaultAccentHex !== "#f5f5f5"
      || descriptor.overviewLayout !== "mission-core-landing-stage-v1"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v5_overview_layout_contract_mismatch");
  } else if (descriptorPath.endsWith("release-v4.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v4"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260821-030"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "8459521a662541a5a87cb0188991cdcfb51727427db8ec2a232ce4846bfc3454"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.presentationPersistence !== "runner-managed-host-data-bind"
      || descriptor.presentationDataHostPath !== "/volume1/docker/nodedc-device-plane/data/device-manager"
      || descriptor.presentationDataContainerPath !== "/var/lib/nodedc-device-manager"
      || descriptor.presentationDataOwnership !== "uid-1000-gid-1000-mode-0750"
      || descriptor.presentationDataLifecycle !== "preserve-across-manager-recreate-and-source-rollback"
      || descriptor.presentationPath !== "/var/lib/nodedc-device-manager/device-manager-presentation.json"
      || descriptor.mediaRoot !== "/var/lib/nodedc-device-manager/media"
      || descriptor.defaultAccentHex !== "#f5f5f5"
      || descriptor.rollback !== "restore-preapply-snapshot-preserve-manager-data"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v4_persistence_contract_mismatch");
  } else if (descriptorPath.endsWith("release-v3.json")) {
    if (
      descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v3"
      || descriptor.commandTransport !== "typed-service-ping-v1"
      || descriptor.commandCatalog !== "allowlisted-adapter-typed-commands-only"
      || descriptor.credentialBoundary !== "transient-core-memory-then-single-pinned-mtls-command-envelope-to-edge-never-persisted-never-logged-never-returned"
      || descriptor.controlCorePredecessor?.patchId !== "device-control-core-release-v2-20260821-030"
      || descriptor.controlCorePredecessor?.artifactSha256 !== "8459521a662541a5a87cb0188991cdcfb51727427db8ec2a232ce4846bfc3454"
      || descriptor.edgeChannelPredecessor?.patchId !== "device-edge-core-channel-upgrade-v4-20260812-023"
      || descriptor.edgeChannelPredecessor?.artifactSha256 !== "c10d5b6b7d55ab239f85b6c8130e34ce9f84985e3b46e6e5534733156c7982fc"
      || descriptor.edgeChannel !== "preserve-active-v4-core-initiated-pinned-mtls"
      || descriptor.edgeChannelEgress !== "preserve-dedicated-core-only-bridge-no-host-ingress-public-ipv4-tcp-443-only"
      || descriptor.gelios !== "untouched-legacy-only"
    ) throw new Error("device_manager_v3_typed_command_contract_mismatch");
  } else if (
    descriptor.schemaVersion !== "nodedc.device-plane.device-manager-release.v1"
    || descriptor.commandTransport !== "disabled"
    || descriptor.gelios !== "untouched"
  ) {
    throw new Error("device_manager_v1_contract_mismatch");
  }
  await writeFile(join(stage, "manifest.env"), `id=${patchId}\ncomponent=device-plane\ntype=app-overlay\n`, "utf8");
  await writeFile(join(stage, "files.txt"), `${entries.join("\n")}\n`, "utf8");
  await mkdir(artifactDir, { recursive: true });
  const tar = spawnSync("python3", ["-c", canonicalTarScript(), target, stage], { encoding: "utf8", maxBuffer: 128 * 1024 * 1024 });
  if (tar.status !== 0) throw new Error(`tar_failed:${tar.stderr || tar.stdout}`);
  const sha256 = createHash("sha256").update(await readFile(target)).digest("hex");
  console.log(JSON.stringify({
    ok: true,
    patchId,
    component: "device-plane",
    artifact: target,
    sha256,
    entries,
    services: isManagerOnly ? ["device-manager"] : ["device-control-core", "device-manager"],
    preserved: ["device-postgres", "device-gateway", "device-backhaul-target", "Gelios"],
  }, null, 2));
} finally {
  await rm(stage, { recursive: true, force: true });
}

async function validateFaviconBundle(payloadRoot, errorPrefix) {
  const faviconHashes = {
    "favicon.ico": "f8933114a85646335ea5c94944f56d3cd8c48a6032016719f7905ff244ec0aa2",
    "favicon/favicon.ico": "f8933114a85646335ea5c94944f56d3cd8c48a6032016719f7905ff244ec0aa2",
    "favicon/icon-adaptive.svg": "481984e83997d786bb0a72ad1ee80037db13aef3a0792ab3109df95c2199b38e",
    "favicon/apple-touch-icon.png": "afdccc28152a566e264e533ca218362f05d5bcec936c647f9a54f414c0bd4763",
    "favicon/icon-192.png": "5b10a24feb4754f15c69761cef42f91a01f885d04095156b1a12e254875fdd4d",
    "favicon/icon-512.png": "f98bac3dba59b7eefbe89f8bb8abc25567226a54ab7ed3b6b1a4caffbdd9ee15",
    "favicon/manifest.webmanifest.json": "2a8ecdc6e6c64833f812ae02bbc0c7bd9b435e0cfa75cc21d6edf054d41275fc",
  };
  for (const [relativePath, expectedSha256] of Object.entries(faviconHashes)) {
    const content = await readFile(join(payloadRoot, "services/device-manager/dist", relativePath));
    const actualSha256 = createHash("sha256").update(content).digest("hex");
    if (actualSha256 !== expectedSha256) {
      throw new Error(`${errorPrefix}_favicon_hash_mismatch:${relativePath}`);
    }
  }
  const indexHtml = await readFile(
    join(payloadRoot, "services/device-manager/dist/index.html"),
    "utf8",
  );
  for (const requiredLink of [
    'href="/favicon/icon-adaptive.svg"',
    'href="/favicon/favicon.ico"',
    'href="/favicon/apple-touch-icon.png"',
    'href="/favicon/icon-192.png"',
    'href="/favicon/icon-512.png"',
    'href="/favicon/manifest.webmanifest.json"',
  ]) {
    if (!indexHtml.includes(requiredLink)) {
      throw new Error(`${errorPrefix}_favicon_link_missing:${requiredLink}`);
    }
  }
}

async function copySafe(source, destination, sourceBoundary) {
  const sourceStat = await lstat(source);
  if (sourceStat.isSymbolicLink()) throw new Error(`source_symlink_rejected:${relative(sourceBoundary, source)}`);
  if (sourceStat.isFile()) {
    if (source.endsWith(".test.mjs") || source.endsWith(".map")) return;
    await mkdir(dirname(destination), { recursive: true });
    await cp(source, destination, { force: true, verbatimSymlinks: true });
    return;
  }
  if (!sourceStat.isDirectory()) throw new Error(`source_type_rejected:${source}`);
  await mkdir(destination, { recursive: true });
  for (const entry of await readdir(source, { withFileTypes: true })) {
    if ([".DS_Store", ".git", "node_modules", "test"].includes(entry.name) || entry.name.startsWith(".env")) continue;
    await copySafe(join(source, entry.name), join(destination, entry.name), sourceBoundary);
  }
}

async function validateDockerCopySources(dockerfilePath, buildContext) {
  const dockerfile = await readFile(dockerfilePath, "utf8");
  for (const [index, rawLine] of dockerfile.split("\n").entries()) {
    const line = rawLine.trim();
    if (!/^COPY\s+/i.test(line)) continue;
    if (line.endsWith("\\") || /^COPY\s+\[/i.test(line)) {
      throw new Error(`unsupported_docker_copy_syntax:${dockerfilePath}:${index + 1}`);
    }
    const tokens = line.split(/\s+/).slice(1);
    while (tokens[0]?.startsWith("--")) tokens.shift();
    if (tokens.length < 2) {
      throw new Error(`invalid_docker_copy:${dockerfilePath}:${index + 1}`);
    }
    for (const source of tokens.slice(0, -1)) {
      if (/[*?[\]{}]/.test(source)) {
        throw new Error(`docker_copy_glob_rejected:${dockerfilePath}:${index + 1}:${source}`);
      }
      const resolvedSource = resolve(buildContext, source);
      const relativeSource = relative(buildContext, resolvedSource);
      if (!relativeSource || relativeSource.startsWith("..") || resolve(buildContext, relativeSource) !== resolvedSource) {
        throw new Error(`docker_copy_source_outside_context:${dockerfilePath}:${index + 1}:${source}`);
      }
      try {
        await lstat(resolvedSource);
      } catch (error) {
        if (error?.code === "ENOENT") {
          throw new Error(`docker_copy_source_missing:${dockerfilePath}:${index + 1}:${source}`);
        }
        throw error;
      }
    }
  }
}

function canonicalTarScript() {
  return [
    "import gzip,io,pathlib,sys,tarfile",
    "root=pathlib.Path(sys.argv[2])",
    "with open(sys.argv[1],'wb') as out:",
    " with gzip.GzipFile(filename='',mode='wb',fileobj=out,compresslevel=9,mtime=0) as gz:",
    "  with tarfile.open(fileobj=gz,mode='w',format=tarfile.PAX_FORMAT) as tar:",
    "   for top in ('manifest.env','files.txt','payload'):",
    "    p=root/top; paths=[p]+(sorted(p.rglob('*')) if p.is_dir() else [])",
    "    for x in paths:",
    "     info=tar.gettarinfo(str(x),arcname=x.relative_to(root).as_posix()); info.uid=info.gid=0; info.uname=info.gname='root'; info.mtime=0; info.mode=0o755 if info.isdir() else 0o644",
    "     with (open(x,'rb') if info.isfile() else io.BytesIO()) as src: tar.addfile(info,src if info.isfile() else None)",
  ].join("\n");
}