236 lines
11 KiB
JavaScript
236 lines
11 KiB
JavaScript
#!/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");
|
|
|
|
const unitProfileV1Matches = registry.policies?.filter((policy) => (
|
|
policy?.dataProductId === "fleet.units.profile.current.v1" && policy?.productVersion === "1.0.0"
|
|
)) || [];
|
|
if (unitProfileV1Matches.length !== 1) throw new Error("foundry_consumer_policy_unit_profile_v1_missing_or_ambiguous");
|
|
const unitProfileV1Policy = unitProfileV1Matches[0];
|
|
const expectedUnitProfileProjection = [
|
|
"corrected_engine_hours_factor",
|
|
"corrected_mileage_factor",
|
|
"display_name",
|
|
"filter_by_satellite_count_enabled",
|
|
"filter_by_satellite_count_value",
|
|
"filter_emissions",
|
|
"hardware_manufacturer_name",
|
|
"hardware_port",
|
|
"hardware_type_class",
|
|
"hardware_type_name",
|
|
"limit_acceleration",
|
|
"lost_connection_enabled",
|
|
"lost_connection_time_value",
|
|
"maximum_permissible_speed",
|
|
"maximum_valid_height",
|
|
"maximum_valid_speed",
|
|
"mileage_by_ignition",
|
|
"minimum_movement_speed",
|
|
"minimum_movement_time",
|
|
"minimum_parking_time",
|
|
"minimum_stop_time",
|
|
"minimum_trip_distance",
|
|
"minimum_valid_height",
|
|
"speed_parameter",
|
|
"trip_detection_type",
|
|
"unit_type_class",
|
|
"unit_type_name",
|
|
"use_odometer",
|
|
];
|
|
if (
|
|
unitProfileV1Policy.id !== "map-moving-object-unit-profile-current-v1"
|
|
|| unitProfileV1Policy.version !== "1.0.0"
|
|
|| unitProfileV1Policy.freshness !== "none"
|
|
|| unitProfileV1Policy.staleAfterMs !== null
|
|
|| JSON.stringify(unitProfileV1Policy.terminalStatuses) !== JSON.stringify([])
|
|
|| unitProfileV1Policy.consumerContract?.ontologyRevision !== "ontology.map.moving_object.v3"
|
|
|| unitProfileV1Policy.consumerContract?.deliveryMode !== "snapshot+patch"
|
|
|| JSON.stringify(unitProfileV1Policy.consumerContract?.semanticTypes) !== JSON.stringify(["map.moving_object"])
|
|
|| JSON.stringify(unitProfileV1Policy.consumerContract?.fieldProjection) !== JSON.stringify(expectedUnitProfileProjection)
|
|
|| JSON.stringify(unitProfileV1Policy.consumerContract?.geometryTypes) !== JSON.stringify([])
|
|
|| unitProfileV1Policy.consumerContract?.subjectIdentity !== "semantic-type+source-id"
|
|
|| unitProfileV1Policy.consumerContract?.snapshotMode !== "atomic-replace"
|
|
|| unitProfileV1Policy.consumerContract?.patchMode !== "atomic"
|
|
|| unitProfileV1Policy.removeMode !== "canonical-tombstone-or-snapshot-rebase"
|
|
) throw new Error("foundry_consumer_policy_unit_profile_v1_contract_invalid");
|
|
|
|
for (const [id, policy] of [
|
|
["v4", movingObjectV4Policy],
|
|
["zone-v2", zoneV2Policy],
|
|
["unit-profile-v1", unitProfileV1Policy],
|
|
]) {
|
|
const allowedPolicyKeys = new Set([
|
|
"id",
|
|
"version",
|
|
"dataProductId",
|
|
"productVersion",
|
|
"freshness",
|
|
"staleAfterMs",
|
|
"terminalStatuses",
|
|
"statusContract",
|
|
"consumerContract",
|
|
"removeMode",
|
|
]);
|
|
if (
|
|
Object.keys(policy).some((key) => !allowedPolicyKeys.has(key))
|
|
|| /(provider|tenant|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");
|
|
}
|