Harden post-refactor test and check guardrails

scripts/check-syntax.mjs

@@ -0,0 +1,95 @@
+import { readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+
+const SOURCE_ROOTS = [
+  "index.js",
+  "ena-planner",
+  "graph",
+  "host",
+  "llm",
+  "maintenance",
+  "prompting",
+  "retrieval",
+  "runtime",
+  "scripts",
+  "sync",
+  "ui",
+  "vector",
+];
+
+async function collectFiles(targetPath) {
+  const absolutePath = path.resolve(process.cwd(), targetPath);
+  const fileStat = await stat(absolutePath);
+  if (fileStat.isFile()) {
+    return [absolutePath];
+  }
+
+  const files = [];
+  const entries = await readdir(absolutePath, { withFileTypes: true });
+  for (const entry of entries) {
+    const nextRelative = path.join(targetPath, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await collectFiles(nextRelative)));
+      continue;
+    }
+    if (entry.isFile() && /\.(js|mjs)$/.test(entry.name)) {
+      files.push(path.resolve(process.cwd(), nextRelative));
+    }
+  }
+  return files;
+}
+
+function toPosixPath(filePath) {
+  return path.relative(process.cwd(), filePath).split(path.sep).join("/");
+}
+
+async function runNodeCheck(filePath) {
+  return await new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, ["--check", filePath], {
+      cwd: process.cwd(),
+      stdio: "inherit",
+      windowsHide: true,
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (signal) {
+        reject(new Error(`${filePath} terminated by signal ${signal}`));
+        return;
+      }
+      if (code !== 0) {
+        reject(new Error(`${filePath} exited with code ${code}`));
+        return;
+      }
+      resolve();
+    });
+  });
+}
+
+async function main() {
+  const files = [];
+  for (const root of SOURCE_ROOTS) {
+    files.push(...(await collectFiles(root)));
+  }
+
+  const uniqueFiles = Array.from(new Set(files)).sort((left, right) =>
+    toPosixPath(left).localeCompare(toPosixPath(right), "en"),
+  );
+  console.log(`[ST-BME][check] syntax-checking ${uniqueFiles.length} files`);
+
+  for (const filePath of uniqueFiles) {
+    console.log(`[ST-BME][check] -> ${toPosixPath(filePath)}`);
+    await runNodeCheck(filePath);
+  }
+
+  console.log("[ST-BME][check] syntax checks passed");
+}
+
+main().catch((error) => {
+  console.error(
+    "[ST-BME][check] failed:",
+    error instanceof Error ? error.message : String(error),
+  );
+  process.exitCode = 1;
+});