clusterflux-public/scripts/node-lifecycle-contract-smoke.js

#!/usr/bin/env node

const assert = require("assert");
const fs = require("fs");
const path = require("path");

const repo = path.resolve(__dirname, "..");

function read(relativePath) {
  return fs.readFileSync(path.join(repo, relativePath), "utf8");
}

function expect(source, name, pattern) {
  assert.match(source, pattern, `missing node lifecycle evidence: ${name}`);
}

const nodeMain = read("crates/clusterflux-node/src/daemon.rs");
const nodeIdentity = read("crates/clusterflux-node/src/node_identity.rs");
const cliNode = read("crates/clusterflux-cli/src/node.rs");
const nodeTaskReports = read("crates/clusterflux-node/src/task_reports.rs");
const nodeDebugAgent = read("crates/clusterflux-node/src/debug_agent.rs");
const nodeLib = read("crates/clusterflux-node/src/lib.rs");
const sharedWasmtimeRuntime = `${read("crates/clusterflux-wasm-runtime/src/lib.rs")}\n${read("crates/clusterflux-wasm-runtime/src/task_host_linker.rs")}`;
const nodeRuntimeSurface = `${nodeLib}\n${sharedWasmtimeRuntime}`;
const nodeLifecycleSurface = `${nodeMain}\n${nodeIdentity}\n${nodeTaskReports}\n${nodeDebugAgent}`;
const nodeAssignmentRunner = `${read("crates/clusterflux-node/src/assignment_runner.rs")}\n${read("crates/clusterflux-node/src/assignment_runner/control_watcher.rs")}\n${read("crates/clusterflux-node/src/assignment_runner/process_runner.rs")}\n${read("crates/clusterflux-node/src/assignment_runner/validation.rs")}`;
const coordinatorCore = read("crates/clusterflux-coordinator/src/lib.rs");
const coordinatorService = `${read("crates/clusterflux-coordinator/src/service.rs")}\n${read("crates/clusterflux-coordinator/src/service/routing.rs")}`;
const coordinatorServiceTests = read("crates/clusterflux-coordinator/src/service/tests.rs");
const coordinatorServiceSurface = `${coordinatorService}\n${coordinatorServiceTests}`;
const cliLocalRunSmoke = read("scripts/cli-local-run-smoke.js");
const liveSmoke = read("scripts/cli-happy-path-live-smoke.js");
const wasmtimeSmoke = read("scripts/wasmtime-node-smoke.js");
const debugCore = read("crates/clusterflux-core/src/debug.rs");

assert.strictEqual(
  (nodeMain.match(/CoordinatorSession::connect/g) || []).length,
  1,
  "node runtime should open one coordinator session in the local process-boundary runtime"
);

for (const [name, pattern] of [
  ["enrollment exchange over session", /"type": "exchange_node_enrollment_grant"/],
  ["persisted node identity is reused locally", /"type": "node_identity_reused"/],
  ["heartbeat over session", /"type": "node_heartbeat"/],
  ["node-originated requests use signed envelope", /"type": "signed_node"/],
  ["capability report over session", /"type": "report_node_capabilities"/],
  ["task assignment polling over session", /"type": "poll_task_assignment"/],
  ["process start over session", /"type": "start_process"/],
  ["reconnect over session", /"type": "reconnect_node"/],
  ["debug command polling over session", /"type": "poll_debug_command"/],
  ["log event over session", /"type": "report_task_log"/],
  ["VFS metadata over session", /"type": "report_vfs_metadata"/],
  ["task control polling over session", /"type": "poll_task_control"/],
  ["completion over session", /"type": "task_completed"/],
  ["cancellation uses same session", /poll_task_cancellation\(session, args, &task, node_private_key\)/],
  ["request count is reported", /session\.requests\(\)/],
]) {
  expect(nodeLifecycleSurface, name, pattern);
}

expect(cliNode, "user-authorized node attach over Client session", /"type": "attach_node"/);
assert.doesNotMatch(
  nodeIdentity,
  /"type": "attach_node"/,
  "a persisted node must authenticate with its signed identity instead of replaying Client attach"
);

const runtimeAcceptanceSurface = `${cliLocalRunSmoke}\n${liveSmoke}\n${coordinatorServiceTests}\n${nodeLib}\n${nodeAssignmentRunner}`;
for (const [name, pattern] of [
  ["real CLI launches a coordinator main", /node_report\.run\.status, "main_launched"/],
  ["real CLI observes coordinator-main task spawning", /task_spawn_host_import, true/],
  ["real CLI keeps child task instances distinct", /every live task event must retain its unique instance identity/],
  ["signed active Wasm parent spawns and joins child", /fn signed_active_wasm_task_can_spawn_and_join_child_in_its_process_only\(\)/],
  ["controlled native process abort is exercised", /fn abort_requested[\s\S]*poll_task_control/],
  ["native lifecycle freeze and resume are exercised", /linux_task_lifecycle_supports_cancel_and_all_stop_freeze_resume/],
  ["strict live run requires a usable partial freeze", /partial_freeze\.partially_frozen/],
  ["strict live run requires hosted restart evidence", /serviceRestart\.executed === true/],
]) {
  expect(runtimeAcceptanceSurface, name, pattern);
}

for (const [name, pattern] of [
  ["cooperative cancellation and abort are distinct", /cancel_requested: false,[\s\S]*abort_requested: true/],
  ["controlled runner polls abort while command runs", /fn abort_requested[\s\S]*poll_task_control/],
  ["controlled runner creates a process group", /process\.process_group\(0\)/],
  ["controlled runner freezes the native process group", /libc::kill\(process_group, libc::SIGSTOP\)/],
  ["controlled runner resumes the native process group", /libc::kill\(process_group, libc::SIGCONT\)/],
  ["controlled runner kills the process group", /libc::kill\(process_group, libc::SIGKILL\)/],
  ["Wasm code can poll cooperative cancellation", /task_control_v1/],
  ["matched Wasm probes remain at a quiescent boundary", /TaskHostOperation::DebugProbe[\s\S]*enter_quiescent_host_boundary[\s\S]*leave_quiescent_host_boundary/],
  ["debug snapshots use the live Wasm task handle registry", /debug_handle_snapshot[\s\S]*task_handle_\{handle_id\}[\s\S]*state=active/],
  ["native command status comes from the controlled runner", /set_command_status[\s\S]*frozen command pid[\s\S]*native command exited with status/],
]) {
  expect(`${coordinatorServiceSurface}\n${nodeLifecycleSurface}\n${sharedWasmtimeRuntime}\n${nodeAssignmentRunner}`, name, pattern);
}

for (const [name, pattern] of [
  ["coordinator rejects stale process ownership", /fn node_reconnect_rejects_stale_process_epoch_after_restart\(\)/],
  ["reconnect preserves enrolled node identity", /reconnect_node\(&NodeId::from\("node"\), None\)/],
  ["stale process epoch is rejected", /CoordinatorError::StaleProcessEpoch/],
]) {
  expect(coordinatorCore, name, pattern);
}

for (const [name, pattern] of [
  ["coordinator delivers cancellation to connected node", /fn service_delivers_cancellation_to_connected_node_and_records_terminal_state\(\)/],
  ["node polls task control", /CoordinatorRequest::PollTaskControl/],
  ["cancelled terminal state is recorded", /TaskTerminalState::Cancelled/],
]) {
  expect(coordinatorServiceSurface, name, pattern);
}

for (const [name, pattern] of [
  ["native lifecycle test exists", /fn linux_task_lifecycle_supports_cancel_and_all_stop_freeze_resume\(\)/],
  ["native freeze succeeds when supported", /lifecycle\.freeze_for_debug_epoch\(\)\.unwrap\(\)/],
  ["native resume succeeds", /lifecycle\.resume_after_debug_epoch\(\)/],
  ["native cancel reaches lifecycle", /lifecycle\.cancel\(\)/],
  ["unsupported freeze errors", /BackendError::DebugFreezeUnsupported/],
  ["wasmtime runtime exposes freeze resume probe", /pub fn freeze_resume_i32_export_probe/],
  ["wasmtime runtime captures Wasm frame locals", /debug_i32_export_snapshot[\s\S]*local_values/],
  ["wasmtime runtime creates Wasm debug participant", /kind: DebugParticipantKind::WasmTask/],
  ["wasmtime debug participant carries local values", /local_values: snapshot\.local_values\.clone\(\)/],
  ["wasmtime runtime resumes after freeze", /epoch\.continue_all\(\)/],
]) {
  expect(nodeRuntimeSurface, name, pattern);
}

for (const [name, pattern] of [
  ["wasmtime smoke runs debug freeze resume mode", /--debug-freeze-resume/],
  ["wasmtime smoke verifies frozen state", /debugReport\.frozen_state, "Frozen"/],
  ["wasmtime smoke verifies resumed state", /debugReport\.resumed_state, "Running"/],
  ["wasmtime smoke verifies frame local values", /debugReport\.local_values[\s\S]*wasm_local_0/],
  ["wasmtime smoke proves node runtime reached wasm task", /node_runtime_reached_wasm_task/],
  ["wasmtime smoke proves node captured locals", /node_runtime_captured_wasm_locals/],
]) {
  expect(wasmtimeSmoke, name, pattern);
}

for (const [name, pattern] of [
  ["debug model freezes wasm and command participants", /fn breakpoint_creates_all_stop_debug_epoch_for_wasm_and_command_tasks\(\)/],
  ["debug model rejects unsupported freeze", /fn debug_epoch_reports_failure_when_no_participant_can_freeze\(\)/],
  ["debug model resumes frozen participants", /fn continue_resumes_every_frozen_participant\(\)/],
  ["debug model includes captured locals", /local_values/],
  ["wasm participants are modeled", /DebugParticipantKind::WasmTask/],
  ["controlled native command participants are modeled", /DebugParticipantKind::ControlledNativeCommand/],
]) {
  expect(debugCore, name, pattern);
}

console.log("Node lifecycle contract smoke passed");