feat(scripts): add check-env preflight environment validation script

package.json

@@ -7,6 +7,9 @@
     "counter-cli",
     "contract"
   ],
+  "scripts": {
+    "check-env": "npx tsx scripts/check-env.ts"
+  },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/node": "^25.5.0",

scripts/check-env.ts

@@ -0,0 +1,139 @@
+// scripts/check-env.ts
+// SPDX-License-Identifier: Apache-2.0
+//
+// Preflight environment check for the Counter DApp.
+// Run before starting to catch common setup issues early.
+//
+// Usage: npm run check-env
+
+import { execSync } from "child_process";
+import { createConnection } from "net";
+
+const REQUIRED_NODE_MAJOR = 22;
+const REQUIRED_COMPACT_VERSION = "0.28.0";
+const PROOF_SERVER_PORT = 6300;
+
+let passed = 0;
+let failed = 0;
+
+function ok(label: string, detail?: string) {
+  console.log(`  ✓  ${label}${detail ? ` (${detail})` : ""}`);
+  passed++;
+}
+
+function fail(label: string, fix: string) {
+  console.log(`  ✗  ${label}`);
+  console.log(`     Fix: ${fix}`);
+  failed++;
+}
+
+function run(cmd: string): string | null {
+  try {
+    return execSync(cmd, { stdio: "pipe" }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+
+console.log("\nCounter DApp - Environment Check");
+console.log("=================================\n");
+
+const nodeVersion = process.version;
+const nodeMajor = parseInt(nodeVersion.slice(1).split(".")[0], 10);
+if (nodeMajor >= REQUIRED_NODE_MAJOR) {
+  ok("Node.js", nodeVersion);
+} else {
+  fail(
+    `Node.js ${nodeVersion} is too old (need v${REQUIRED_NODE_MAJOR}+)`,
+    `Install Node.js ${REQUIRED_NODE_MAJOR}+ from https://nodejs.org`
+  );
+}
+
+const npmVersion = run("npm --version");
+if (npmVersion) {
+  ok("npm", `v${npmVersion}`);
+} else {
+  fail("npm not found", "npm is bundled with Node.js - reinstall Node.js");
+}
+
+const dockerVersion = run("docker --version");
+if (dockerVersion) {
+  ok("Docker installed", dockerVersion.replace("Docker version ", ""));
+} else {
+  fail(
+    "Docker not found",
+    "Install Docker Desktop from https://docs.docker.com/get-docker"
+  );
+}
+
+const dockerRunning = run("docker info");
+if (dockerRunning) {
+  ok("Docker daemon is running");
+} else {
+  fail(
+    "Docker daemon is not running",
+    "Open Docker Desktop and wait for it to fully start before retrying"
+  );
+}
+
+const composeVersion =
+  run("docker compose version") ?? run("docker-compose --version");
+if (composeVersion) {
+  ok("docker compose", composeVersion.replace("Docker Compose version ", ""));
+} else {
+  fail(
+    "docker compose not found",
+    "Update Docker Desktop to a version that includes Compose V2"
+  );
+}
+
+const compactVersion = run("compact compile --version");
+if (compactVersion) {
+  if (compactVersion.includes(REQUIRED_COMPACT_VERSION)) {
+    ok("Compact compiler", compactVersion);
+  } else {
+    fail(
+      `Compact version mismatch (found: ${compactVersion}, need: ${REQUIRED_COMPACT_VERSION})`,
+      `Run: compact update ${REQUIRED_COMPACT_VERSION}`
+    );
+  }
+} else {
+  fail(
+    "Compact compiler not found",
+    `Install with: curl --proto '=https' --tlsv1.2 -LsSf https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh\n     Then run: compact update ${REQUIRED_COMPACT_VERSION}`
+  );
+}
+
+await new Promise<void>((resolve) => {
+  const socket = createConnection(PROOF_SERVER_PORT, "127.0.0.1");
+  socket.setTimeout(1500);
+  socket.on("connect", () => {
+    ok("Proof server", `reachable on port ${PROOF_SERVER_PORT}`);
+    socket.destroy();
+    resolve();
+  });
+  socket.on("error", () => {
+    console.log(`  ⚠  Proof server not running on port ${PROOF_SERVER_PORT}`);
+    console.log(
+      "     This is fine if you haven't started it yet. Run: npm run preprod-ps"
+    );
+    socket.destroy();
+    resolve();
+  });
+  socket.on("timeout", () => {
+    socket.destroy();
+    resolve();
+  });
+});
+
+console.log("\n-------------------------------------------");
+if (failed === 0) {
+  console.log(`  All ${passed} checks passed. You're good to go!\n`);
+  console.log("  Next step: cd counter-cli && npm run preprod-ps\n");
+  process.exit(0);
+} else {
+  console.log(
+    `  ${passed} passed, ${failed} failed. Fix the issues above before continuing.\n`
+  );
+  process.exit(1);
+}