NODEDC_PLATFORM/infra/deploy-runner/build-module-foundry-consumer-policy-artifact.mjs

#!/usr/bin/env node

import { createHash } from "node:crypto";
import { spawnSync } from "node:child_process";
import { cp, lstat, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
import { tmpdir } from "node:os";
import { dirname, join, resolve } from "node:path";
import { fileURLToPath } from "node:url";

const scriptDir = dirname(fileURLToPath(import.meta.url));
const platformRoot = resolve(scriptDir, "../..");
const workspaceRoot = resolve(platformRoot, "..");
const foundryRoot = resolve(workspaceRoot, "NODEDC_DESIGN_GUIDELINE");
const artifactDir = resolve(process.env.NODEDC_DEPLOY_ARTIFACT_DIR || resolve(scriptDir, "../deploy-artifacts"));
const [patchId = "module-foundry-zone-v2-consumer-policy-20260721-001", ...extra] = process.argv.slice(2);

if (extra.length || !/^[A-Za-z0-9._-]{1,96}$/.test(patchId)) {
  throw new Error("patch_id_must_contain_only_letters_digits_dot_underscore_hyphen");
}

const files = [
  "registry/data-product-consumer-policies.json",
  "scripts/validate-registry.mjs",
  "server/foundry-data-product-consumer.mjs",
  "server/foundry-data-product-consumer.test.mjs",
];
const stage = await mkdtemp(join(tmpdir(), "nodedc-module-foundry-consumer-policy-artifact-"));
const payload = join(stage, "payload");
const artifact = join(artifactDir, `nodedc-module-foundry-${patchId}.tgz`);
const checksum = `${artifact}.sha256`;

await assertConsumerPolicyBoundary();

try {
  await mkdir(payload, { recursive: true });
  for (const relativePath of files) {
    const source = resolve(foundryRoot, relativePath);
    const sourceStat = await lstat(source);
    if (!sourceStat.isFile() || sourceStat.isSymbolicLink()) {
      throw new Error(`source_file_rejected:${relativePath}`);
    }
    const destination = join(payload, relativePath);
    await mkdir(dirname(destination), { recursive: true });
    await cp(source, destination, { force: true, verbatimSymlinks: true });
  }

  await writeFile(join(stage, "manifest.env"), `id=${patchId}\ncomponent=module-foundry\ntype=app-overlay\n`, "utf8");
  await writeFile(join(stage, "files.txt"), `${files.join("\n")}\n`, "utf8");
  await mkdir(artifactDir, { recursive: true });

  const tar = spawnSync("python3", ["-c", canonicalTarScript(), artifact, stage], {
    encoding: "utf8",
    maxBuffer: 32 * 1024 * 1024,
  });
  if (tar.status !== 0) throw new Error(`tar_failed:${tar.stderr || tar.stdout}`);

  const sha256 = createHash("sha256").update(await readFile(artifact)).digest("hex");
  await writeFile(checksum, `${sha256}  ${artifact.split("/").at(-1)}\n`, "utf8");
  console.log(JSON.stringify({ ok: true, patchId, artifact, checksum, sha256, files }, null, 2));
} finally {
  await rm(stage, { recursive: true, force: true });
}

async function assertConsumerPolicyBoundary() {
  const registry = JSON.parse(await readFile(resolve(foundryRoot, files[0]), "utf8"));
  if (registry?.schemaVersion !== "nodedc.foundry.data-product-consumer-policies/v1") {
    throw new Error("foundry_consumer_policy_registry_invalid");
  }
  const movingObjectV4Matches = registry.policies?.filter((policy) => (
    policy?.dataProductId === "fleet.positions.current.v4" && policy?.productVersion === "4.0.0"
  )) || [];
  if (movingObjectV4Matches.length !== 1) throw new Error("foundry_consumer_policy_v4_missing_or_ambiguous");
  const movingObjectV4Policy = movingObjectV4Matches[0];
  if (
    movingObjectV4Policy.id !== "map-moving-object-current-v4"
    || movingObjectV4Policy.version !== "4.0.0"
    || movingObjectV4Policy.staleAfterMs !== null
    || movingObjectV4Policy.statusContract?.attribute !== "signal_state"
    || JSON.stringify(movingObjectV4Policy.statusContract?.allowedValues) !== JSON.stringify(["active", "inactive"])
    || movingObjectV4Policy.statusContract?.missing !== "reject"
    || movingObjectV4Policy.statusContract?.freshness !== "none"
    || JSON.stringify(movingObjectV4Policy.terminalStatuses) !== JSON.stringify(["inactive"])
    || movingObjectV4Policy.removeMode !== "canonical-tombstone-or-snapshot-rebase"
  ) throw new Error("foundry_consumer_policy_v4_contract_invalid");

  const zoneV1Matches = registry.policies?.filter((policy) => (
    policy?.dataProductId === "map.zones.current.v1" && policy?.productVersion === "1.0.0"
  )) || [];
  if (zoneV1Matches.length !== 1 || JSON.stringify(zoneV1Matches[0]) !== JSON.stringify({
    id: "map-zone-current-v1",
    version: "1.0.0",
    dataProductId: "map.zones.current.v1",
    productVersion: "1.0.0",
    freshness: "none",
    staleAfterMs: null,
    terminalStatuses: [],
    removeMode: "canonical-tombstone-or-snapshot-rebase",
  })) throw new Error("foundry_consumer_policy_zone_v1_contract_changed");

  const zoneV2Matches = registry.policies?.filter((policy) => (
    policy?.dataProductId === "map.zones.current.v2" && policy?.productVersion === "2.0.0"
  )) || [];
  if (zoneV2Matches.length !== 1) throw new Error("foundry_consumer_policy_zone_v2_missing_or_ambiguous");
  const zoneV2Policy = zoneV2Matches[0];
  const expectedProjection = [
    "display_name",
    "geometry_kind",
    "max_speed_kph",
    "schedule_timezone",
    "applies_to_couriers",
    "applies_to_kicksharing",
  ];
  if (
    zoneV2Policy.id !== "map-zone-current-v2"
    || zoneV2Policy.version !== "2.0.0"
    || zoneV2Policy.freshness !== "none"
    || zoneV2Policy.staleAfterMs !== null
    || JSON.stringify(zoneV2Policy.terminalStatuses) !== JSON.stringify([])
    || zoneV2Policy.consumerContract?.ontologyRevision !== "ontology.map.zone.v1"
    || zoneV2Policy.consumerContract?.deliveryMode !== "snapshot+patch"
    || JSON.stringify(zoneV2Policy.consumerContract?.semanticTypes) !== JSON.stringify(["map.zone"])
    || JSON.stringify(zoneV2Policy.consumerContract?.fieldProjection) !== JSON.stringify(expectedProjection)
    || JSON.stringify(zoneV2Policy.consumerContract?.geometryTypes) !== JSON.stringify(["Polygon", "MultiPolygon"])
    || zoneV2Policy.consumerContract?.subjectIdentity !== "semantic-type+source-id"
    || zoneV2Policy.consumerContract?.snapshotMode !== "atomic-replace"
    || zoneV2Policy.consumerContract?.patchMode !== "atomic"
    || zoneV2Policy.removeMode !== "canonical-tombstone-or-snapshot-rebase"
  ) throw new Error("foundry_consumer_policy_zone_v2_contract_invalid");

  for (const [id, policy] of [["v4", movingObjectV4Policy], ["zone-v2", zoneV2Policy]]) {
    if (/(provider|tenant|connection|endpoint|credential|token|secret|authorization)/i.test(JSON.stringify(policy))) {
      throw new Error(`foundry_consumer_policy_${id}_transport_boundary_violation`);
    }
  }

  const consumer = await readFile(resolve(foundryRoot, files[2]), "utf8");
  for (const marker of [
    "data_product_consumer_fact_status_invalid",
    "data_product_consumer_status_field_not_projected",
    'policy.freshness === "none"',
    "assertConsumerContract(policy.consumerContract, product, target.binding)",
    "data_product_snapshot_product_mismatch",
    "data_product_patch_product_mismatch",
    "data_product_consumer_fact_contract_invalid",
  ]) {
    if (!consumer.includes(marker)) throw new Error(`foundry_consumer_policy_runtime_guard_missing:${marker}`);
  }
}

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");
}