@tracecode/harness 0.6.5 → 0.6.6

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project are documented here.
 
 This repo uses Git tags as release boundaries. Version notes below summarize what shipped in each tagged release.
 
+## [0.6.6] - 2026-04-27
+
+### Fixed
+
+- Improved Java worker rewrite-failure handling so parser failures are surfaced as user-facing syntax errors instead of opaque Java object strings.
+- Added a compile probe fallback when Java source rewriting fails, allowing harness clients to receive compiler stderr/stdout diagnostics in the standard failed execution payload.
+
 ## [0.6.5] - 2026-04-26
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracecode/harness",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "license": "AGPL-3.0-only",
   "homepage": "https://tracecode.app",
   "repository": {

package/workers/java/java-worker.js

@@ -68,13 +68,19 @@ function formatWorkerErrorMessage(error) {
     } catch {}
     try {
       const tag = Object.prototype.toString.call(error);
-      if (tag && tag !== '[object Object]') {
+      if (tag && tag.includes('ParseProblemException')) {
+        return 'Java syntax error.';
+      }
+      if (tag && tag !== '[object Object]' && !tag.startsWith('[object ')) {
         return tag;
       }
     } catch {}
     try {
       if (typeof error.toString === 'function' && error.toString !== Object.prototype.toString) {
         const value = error.toString();
+        if (value.includes('ParseProblemException')) {
+          return 'Java syntax error.';
+        }
         if (typeof value === 'string' && value.length > 0 && value !== '[object Object]') {
           return value;
         }
@@ -83,6 +89,9 @@ function formatWorkerErrorMessage(error) {
   }
   try {
     const stringified = String(error);
+    if (stringified.includes('ParseProblemException')) {
+      return 'Java syntax error.';
+    }
     if (stringified && stringified !== '[object Object]') {
       return stringified;
     }
@@ -1200,6 +1209,88 @@ async function rewriteSource(payload, requestId) {
   );
 }
 
+function normalizePublicClassDeclarations(source) {
+  return String(source).replace(/(^|\n)\s*public\s+class\s+/g, '$1class ');
+}
+
+async function collectCompileProbeDiagnostics(source, requestId, options) {
+  const probeClassName = buildExportsClassName(`${requestId}RewriteProbe`);
+  const probePackageName = buildPackageName(`${requestId}RewriteProbe`);
+  const sourcePath = `/str/${probeClassName}.java`;
+  const classesDir = `/files/java-worker/${requestId}/rewrite-probe/classes`;
+
+  let compileLibraryClass;
+  try {
+    compileLibraryClass = await getCompileLibraryClass();
+  } catch (error) {
+    return {
+      consoleOutput: [],
+      error: null,
+      hostCallMs: 0,
+      diagnosticError: formatWorkerErrorMessage(error),
+    };
+  }
+
+  try {
+    await self.cheerpOSAddStringFile(sourcePath, normalizePublicClassDeclarations(source));
+  } catch (error) {
+    return {
+      consoleOutput: [],
+      error: null,
+      hostCallMs: 0,
+      diagnosticError: formatWorkerErrorMessage(error),
+    };
+  }
+
+  const startedAt = performance.now();
+  let reportText;
+  try {
+    reportText = await compileLibraryClass.compileAndTrace(
+      sourcePath,
+      classesDir,
+      `${probePackageName}.${probeClassName}`,
+      HELPER_JAR_PATH,
+      DEFAULT_COMPILER_DEBUG_PROFILE,
+      String(resolveMaxStoredEvents(options))
+    );
+  } catch (error) {
+    return {
+      consoleOutput: [],
+      error: null,
+      hostCallMs: performance.now() - startedAt,
+      diagnosticError: formatWorkerErrorMessage(error),
+    };
+  }
+
+  let report;
+  try {
+    report = JSON.parse(reportText);
+  } catch (error) {
+    return {
+      consoleOutput: [],
+      error: null,
+      hostCallMs: performance.now() - startedAt,
+      diagnosticError: `Invalid compile probe report: ${formatWorkerErrorMessage(error)}`,
+    };
+  }
+
+  const consoleOutput = [report.compilerStdout, report.compilerStderr].filter(
+    (entry) => typeof entry === 'string' && entry.trim().length > 0
+  );
+  const surfacedError =
+    report.runtimeError ||
+    report.compilerStderr ||
+    report.compilerStdout ||
+    null;
+
+  return {
+    consoleOutput,
+    error: surfacedError,
+    hostCallMs: performance.now() - startedAt,
+    diagnosticError: null,
+  };
+}
+
 function normalizeScriptTraceEvents(events, scriptMode, userCodeLineCount, sourceLineMap) {
   if (!scriptMode || !Array.isArray(events)) return events;
   return events.map((event) => {
@@ -1302,7 +1393,31 @@ async function runJavaRequest(payload, requestId) {
     rewrittenSource = self.TraceCodeJavaSourceAugmentations.augmentJavaCollectionOperations(rewrittenSource);
     rewrittenSource = augmentTraceReturnValueSnapshots(rewrittenSource);
   } catch (error) {
-    throw makeWorkerStageError('source rewrite', error);
+    const rewriteError = formatWorkerErrorMessage(error);
+    const diagnosticProbe = await collectCompileProbeDiagnostics(
+      normalizedPayload.code,
+      requestId,
+      payload.options
+    );
+    const totalEnd = performance.now();
+    const surfacedError =
+      diagnosticProbe.error ??
+      (rewriteError === 'Java syntax error.'
+        ? 'Java syntax error. Check Code Assist for parser details.'
+        : `Java source rewrite failed: ${rewriteError}`);
+    return {
+      success: false,
+      events: [],
+      ...(normalizedPayload.sourceText ? { sourceText: normalizedPayload.sourceText } : {}),
+      executionTimeMs: totalEnd - totalStart,
+      consoleOutput: diagnosticProbe.consoleOutput,
+      error: surfacedError,
+      timings: {
+        rewriteMs: totalEnd - rewriteStart,
+        hostCallMs: diagnosticProbe.hostCallMs,
+        totalMs: totalEnd - totalStart,
+      },
+    };
   }
   const rewriteEnd = performance.now();