Refactor: Add global error handlers to test runner

test_runner.js

@@ -1,13 +1,45 @@
 import { readdirSync, readFileSync, writeFileSync } from 'fs';
 import { join, basename } from 'path';
 import { execSync } from 'child_process';
-import { hi2js } from './transpiler.js';
 
 const testDir = 'test';
 const srcDir = join(testDir, 'src');
 const expectedDir = join(testDir, 'expected_output');
 const resultsFile = 'test-results.md';
 
+function generateCrashReport(error, step) {
+    let report = `# Hi Language Test Results\n\n`;
+    report += `**Run at:** ${new Date().toISOString()}\n\n`;
+    report += `| Test Case | Status |\n`;
+    report += `|-----------|--------|\n`;
+    report += `| ${step} | ❌ FAIL |\n`;
+    report += `\n---\n\n## Failures\n\n`;
+    report += `### \`${step}\`\n\n`;
+    report += `**Reason:** Master, the test runner encountered a fatal error.\n\n`;
+    report += `**Error:**\n\`\`\`\n${error.stack || error.message || String(error)}\n\`\`\`\n\n`;
+    report += `---\n\n`;
+    return report;
+}
+
+// Centralized fatal error handler to ensure a report is always generated.
+function handleFatalError(error, step = 'Unknown Step') {
+  console.error(`Master, a fatal error occurred during the ${step}.`);
+  console.error(error);
+  const report = generateCrashReport(error, step);
+  try {
+    writeFileSync(resultsFile, report);
+    console.log(`Failure report written to ${resultsFile}`);
+  } catch (writeError) {
+    console.error('CRITICAL: Failed to write the test results file.', writeError);
+  }
+  process.exit(1);
+}
+
+// Global handlers to catch errors outside the main execution async flow.
+process.on('uncaughtException', (err) => handleFatalError(err, 'Uncaught Exception'));
+process.on('unhandledRejection', (reason) => handleFatalError(reason, 'Unhandled Promise Rejection'));
+
+
 function generateMarkdownReport(results) {
   let report = `# Hi Language Test Results\n\n`;
   report += `**Run at:** ${new Date().toISOString()}\n\n`;
@@ -45,22 +77,11 @@ function generateMarkdownReport(results) {
   return report;
 }
 
-function generateCrashReport(error, step) {
-    let report = `# Hi Language Test Results\n\n`;
-    report += `**Run at:** ${new Date().toISOString()}\n\n`;
-    report += `| Test Case | Status |\n`;
-    report += `|-----------|--------|\n`;
-    report += `| ${step} | ❌ FAIL |\n`;
-    report += `\n---\n\n## Failures\n\n`;
-    report += `### \`${step}\`\n\n`;
-    report += `**Reason:** Master, the test runner encountered a fatal error.\n\n`;
-    report += `**Error:**\n\`\`\`\n${error.stack || error.message}\n\`\`\`\n\n`;
-    report += `---\n\n`;
-    return report;
-}
 
 async function run() {
-  try {
+  // Dynamic import allows us to catch module-level errors.
+  const { hi2js } = await import('./transpiler.js');
+
   const testFiles = readdirSync(srcDir).filter(file => file.endsWith('.hi'));
   const results = [];
 
@@ -116,17 +137,7 @@ async function run() {
   } else {
     console.log("All tests passed, Master.");
   }
-  } catch (e) {
-      // This is the global catch block for any fatal error.
-      const step = e.step || 'Initialization Step';
-      const error = e.error || e;
-      console.error(`Master, a fatal error occurred during the ${step}.`);
-      console.error(error);
-      const report = generateCrashReport(error, step);
-      writeFileSync(resultsFile, report);
-      console.log(`Failure report written to ${resultsFile}`);
-      process.exit(1);
-  }
 }
 
-run();
+// The main `run` function is now wrapped to use the fatal error handler.
+run().catch(err => handleFatalError(err, 'Initialization Step'));