@neocompose/cli 0.62.1 → 0.63.0

package/dist/neo.mjs

@@ -19678,6 +19678,7 @@ var init_project_schema_contract_generated = __esm({
           "argumentTypes",
           "dispatch",
           "bodyMode",
+          "effect",
           "uiAction",
           "templateId",
           "genericParamId"
@@ -19881,6 +19882,10 @@ var init_project_schema_contract_generated = __esm({
           "Sprite",
           "Audio"
         ],
+        "NeoEffectKind": [
+          "None",
+          "Auto"
+        ],
         "NeoProjectRecordKind": [
           "Project",
           "Member",
@@ -24245,6 +24250,9 @@ function fieldsForAnnotation(name, context, environment) {
   if (context.kind === "type") return null;
   if (name === "storage") return storageFields(context);
   if (name === "distribution") return distributionFields(context);
+  if (name === "effect") {
+    return context.kind === "member" && context.memberKind === "function" ? [{ name: "kind", type: "NeoEffectKind" }] : null;
+  }
   if (name === "relations") return relationFields(context, environment);
   if (name === "system") {
     return context.kind === "class" || context.kind === "schema" || context.kind === "member" ? markerFields("NeoSystemAttribute") : null;
@@ -27804,11 +27812,23 @@ function validateMembers(environment, diagnostics) {
         );
       }
     }
+    for (const member of ref.declaration.members) {
+      const effect = effectAnnotation(member);
+      if (effect === void 0) continue;
+      diagnose(
+        diagnostics,
+        ref.uri,
+        effect.nameRange,
+        "invalid-effect",
+        `Interface member '${ref.declaration.name}.${member.name}' cannot be an @effect; only class member functions can.`
+      );
+    }
     validateInterfaceMemberConflicts(ref, environment, diagnostics);
   }
   for (const ref of environment.classes.values()) {
     validateClassMemberModifiers(ref, environment, diagnostics);
     validateClassOverrides(ref, environment, diagnostics);
+    validateEffects(ref, environment, diagnostics);
     if (ref.declaration.modifiers.includes("abstract")) {
       validateAbstractInterfaceMembers(ref, environment, diagnostics);
     } else {
@@ -28234,6 +28254,70 @@ function validateClassOverrides(ref, environment, diagnostics) {
     }
   }
 }
+function validateEffects(ref, environment, diagnostics) {
+  let inherited;
+  for (const member of ref.declaration.members) {
+    if (member.kind !== "function") continue;
+    const annotation2 = effectAnnotation(member);
+    let kind = annotation2 === void 0 ? void 0 : effectKind(annotation2);
+    if (annotation2 === void 0) {
+      if (!member.modifiers.includes("override") || !member.modifiers.includes("native")) {
+        continue;
+      }
+      inherited ??= inheritedClassMembers(ref, environment);
+      kind = inheritedEffectKind(inherited, member.name);
+    }
+    if (kind !== "Auto") continue;
+    const problem = effectIneligibility(member);
+    if (problem === null) continue;
+    diagnose(
+      diagnostics,
+      ref.uri,
+      annotation2?.nameRange ?? member.nameRange,
+      "invalid-effect",
+      `'${ref.declaration.name}.${member.name}' cannot be an @effect: ${problem}.`
+    );
+  }
+}
+function effectAnnotation(member) {
+  return member.annotations.find((entry) => entry.name === "effect");
+}
+function effectKind(annotation2) {
+  if (annotation2.arguments.length === 0) return "Auto";
+  const argument2 = annotation2.arguments.find((entry) => entry.name === "kind") ?? annotation2.arguments.find((entry) => entry.name === void 0);
+  if (argument2 === void 0) return void 0;
+  let expression;
+  try {
+    expression = parseExpression(argument2.text);
+  } catch (error) {
+    if (error instanceof CompileError) return void 0;
+    throw error;
+  }
+  return expression.kind === "contextualEnum" ? expression.name : void 0;
+}
+function inheritedEffectKind(inherited, name) {
+  for (let index = inherited.length - 1; index >= 0; index -= 1) {
+    const view = inherited[index];
+    if (!namesEqual(view.member.name, name)) continue;
+    const annotation2 = effectAnnotation(view.member);
+    if (annotation2 !== void 0) return effectKind(annotation2);
+  }
+  return void 0;
+}
+function effectIneligibility(member) {
+  if (member.modifiers.includes("static")) {
+    return "a static function has no instance to run for";
+  }
+  if (member.modifiers.includes("native")) {
+    return "a native function has no NeoScript reads to track";
+  }
+  if (member.modifiers.includes("async")) {
+    return "an effect runs immediately and cannot be async";
+  }
+  if (member.type.name !== "void") return "an effect must return void";
+  if (member.parameters.length > 0) return "an effect takes no parameters";
+  return null;
+}
 function isPlatformImplementedSystemMember(member) {
   if (!member.modifiers.includes("protected")) return false;
   return member.annotations.some((entry) => entry.name === "system");
@@ -28699,6 +28783,8 @@ var init_project_source_type_checker = __esm({
     init_language_spec();
     init_project_source_ast();
     init_lexer();
+    init_executable_parser();
+    init_strict_compile_error();
     init_project_source_accessors();
     init_project_source_identifiers();
     BUILTIN_ARITY = /* @__PURE__ */ new Map([
@@ -30106,6 +30192,7 @@ function projectDeclarationAnnotationNames(declaration) {
 }
 function projectMemberAnnotationNames(member) {
   const names = ["id", "settings", "storage", "distribution"];
+  if (member?.kind === "function") names.push("effect");
   if (member?.type.name === "List") names.push("index", "column");
   return names;
 }
@@ -31770,6 +31857,8 @@ function annotationSignatureParameters(name) {
       return ["StorageKind allowed"];
     case "distribution":
       return ["NeoSubtreeDistribution kind"];
+    case "effect":
+      return ["NeoEffectKind kind"];
     case "relations":
       return ["relation descriptors"];
     case "incomplete":
@@ -38122,6 +38211,7 @@ var init_args = __esm({
       "generate-ids",
       "help",
       "passWithNoTests",
+      "runInBand",
       "no-verify",
       "fix",
       "yes"
@@ -38173,9 +38263,11 @@ var init_args = __esm({
       "outputFile",
       "output-file",
       "testNamePattern",
+      "maxWorkers",
       "test-timeout",
       "testTimeout",
       "passWithNoTests",
+      "runInBand",
       "no-verify"
     ]);
     TEST_ONLY_FLAGS = /* @__PURE__ */ new Set([
@@ -38183,9 +38275,11 @@ var init_args = __esm({
       "outputFile",
       "output-file",
       "testNamePattern",
+      "maxWorkers",
       "test-timeout",
       "testTimeout",
-      "passWithNoTests"
+      "passWithNoTests",
+      "runInBand"
     ]);
   }
 });
@@ -40016,7 +40110,7 @@ function assertMemberInvariants(member, path) {
       fail2("script", "is required for a concrete scripted member.");
   }
 }
-var nonEmptyString, nullableString2, nullableId, finiteNumber, nullableNumber, nullableInteger, jsonValueSchema, schemaSourcePositionSchema, schemaSourceSpanSchema, schemaSourceSymbolKinds, schemaSourceIdentitySchema, memberSourceIdentitySchema, systemProtectionKindSchema, worldSystemClassKindSchema, schemaSystemMetadataSchema, schemaGenericBindingSchema, schemaGenericBindingRecordSchema, genericConstraintSchema, schemaGenericParameterSchema, primitiveTypeKinds, schemaTypeCache, returnTypeCache, schemaTypeSchema, schemaFunctionReturnTypeSchema, schemaParameterDefaultSchema, schemaFunctionArgumentSchema, memberOwnerSchema, schemaDefaultValueSchema, propertyScriptSchema, functionScriptSchema, commonMemberEntries, schemaMemberCommonSchema, simpleMemberSchemas, dictionaryKeySchema, schemaListIndexSchema, schemaListColumnSchema, callableEntries, schemaMemberSchema, SchemaMemberContractError;
+var nonEmptyString, nullableString2, nullableId, finiteNumber, nullableNumber, nullableInteger, jsonValueSchema, schemaSourcePositionSchema, schemaSourceSpanSchema, schemaSourceSymbolKinds, schemaSourceIdentitySchema, memberSourceIdentitySchema, systemProtectionKindSchema, worldSystemClassKindSchema, schemaSystemMetadataSchema, schemaGenericBindingSchema, schemaGenericBindingRecordSchema, genericConstraintSchema, schemaGenericParameterSchema, primitiveTypeKinds, schemaTypeCache, returnTypeCache, schemaTypeSchema, schemaFunctionReturnTypeSchema, schemaParameterDefaultSchema, schemaFunctionArgumentSchema, memberOwnerSchema, schemaDefaultValueSchema, propertyScriptSchema, functionScriptSchema, commonMemberEntries, schemaMemberCommonSchema, simpleMemberSchemas, dictionaryKeySchema, schemaListIndexSchema, schemaListColumnSchema, callableEntries, functionEffectSchema, schemaMemberSchema, SchemaMemberContractError;
 var init_schema_member = __esm({
   "../packages/manifest/src/schema-member.ts"() {
     "use strict";
@@ -40341,6 +40435,7 @@ var init_schema_member = __esm({
       returnType: schemaFunctionReturnTypeSchema,
       arguments: array2(schemaFunctionArgumentSchema)
     };
+    functionEffectSchema = optional(picklist(["none", "auto"]));
     schemaMemberSchema = variant("kind", [
       ...simpleMemberSchemas,
       memberSchema("int", {
@@ -40403,11 +40498,13 @@ var init_schema_member = __esm({
       }),
       memberSchema("function", {
         ...callableEntries,
-        deferred: boolean2()
+        deferred: boolean2(),
+        effect: functionEffectSchema
       }),
       memberSchema("scriptFunction", {
         ...callableEntries,
         deferred: boolean2(),
+        effect: functionEffectSchema,
         bodyMode: optional(literal2("ui")),
         uiAction: optional(jsonValueSchema),
         script: nullable(functionScriptSchema)
@@ -40498,6 +40595,7 @@ var init_document_contracts = __esm({
           "argumentTypes",
           "dispatch",
           "bodyMode",
+          "effect",
           "uiAction",
           "templateId",
           "genericParamId"
@@ -42202,12 +42300,24 @@ function memberFromDocument(record6, members, owners, classNames, context) {
         FUNCTION_DISPATCH,
         record6,
         "dispatch"
-      ) === "asynchronous"
+      ) === "asynchronous",
+      // The row's own value, not the chain's: an override without `@effect`
+      // inherits, and resolving here would emit the ancestor's kind back
+      // into the override's source as phantom drift.
+      ...data.effect === void 0 || data.effect === null ? {} : {
+        effect: ordinalValue(
+          data.effect,
+          FUNCTION_EFFECT,
+          record6,
+          "effect"
+        )
+      }
     };
     if (kind === MEMBER_KIND.Function) {
       return { ...common, kind: "function", ...signature };
     }
-    const code = optionalStringOrNull(field("code", null));
+    const codeValue = field("code", null);
+    const code = codeValue === "" ? "" : optionalStringOrNull(codeValue);
     const bodyModeValue = ordinalValue(
       field("bodyMode", 0),
       FUNCTION_BODY,
@@ -42453,6 +42563,9 @@ function memberToDocumentFields(member, baseData3) {
     if (member.deferred || isOverride) {
       fields.dispatch = member.deferred ? 1 : 0;
     }
+    if (member.effect !== void 0) {
+      fields.effect = FUNCTION_EFFECT.indexOf(member.effect);
+    }
     if (member.kind === "scriptFunction" && member.script !== null && member.bodyMode !== "ui") {
       fields.code = member.script.sourceText;
     }
@@ -43247,7 +43360,7 @@ function invalidDocument(record6, path, message) {
     `${record6.recordKind}:${record6.recordId}.${path} ${message}.`
   );
 }
-var MEMBER_KIND, MEMBER_MODIFIERS, MEMBER_ACCESS, MEMBER_STORAGE, MEMBER_DISTRIBUTION, STRING_FORMAT, MEMBER_SEARCH_BY, MEMBER_SELECTION, FUNCTION_DISPATCH, FUNCTION_BODY, MEMBER_PAYLOAD, DICTIONARY_KEY, LIST_KIND, LIST_INDEX, COLUMN_VISIBILITY, COLUMN_PIN, COLUMN_OVERFLOW, GENERIC_BINDING, TYPE_KIND_BY_MEMBER_KIND, SIMPLE_MEMBER_KIND_BY_KIND, MEMBER_KIND_BY_KIND, TYPE_MEMBER_KIND_BY_KIND, MEMBER_IDENTITY_FIELDS, INHERITED_MEMBER_ORDINAL_FIELDS, NULLABLE_OVERRIDE_MEMBER_FIELDS;
+var MEMBER_KIND, MEMBER_MODIFIERS, MEMBER_ACCESS, MEMBER_STORAGE, MEMBER_DISTRIBUTION, STRING_FORMAT, MEMBER_SEARCH_BY, MEMBER_SELECTION, FUNCTION_DISPATCH, FUNCTION_BODY, FUNCTION_EFFECT, MEMBER_PAYLOAD, DICTIONARY_KEY, LIST_KIND, LIST_INDEX, COLUMN_VISIBILITY, COLUMN_PIN, COLUMN_OVERFLOW, GENERIC_BINDING, TYPE_KIND_BY_MEMBER_KIND, SIMPLE_MEMBER_KIND_BY_KIND, MEMBER_KIND_BY_KIND, TYPE_MEMBER_KIND_BY_KIND, MEMBER_IDENTITY_FIELDS, INHERITED_MEMBER_ORDINAL_FIELDS, NULLABLE_OVERRIDE_MEMBER_FIELDS;
 var init_codecs = __esm({
   "src/project-manifest/record-adapters/codecs.ts"() {
     "use strict";
@@ -43298,6 +43411,7 @@ var init_codecs = __esm({
     MEMBER_SELECTION = ["single", "multi"];
     FUNCTION_DISPATCH = ["synchronous", "asynchronous"];
     FUNCTION_BODY = ["code", "ui"];
+    FUNCTION_EFFECT = ["none", "auto"];
     MEMBER_PAYLOAD = ["full", "partial"];
     DICTIONARY_KEY = ["string", "enum"];
     LIST_KIND = ["ordered", "unordered"];
@@ -49165,6 +49279,9 @@ var init_structured_leaf_fields = __esm({
 });
 
 // ../src/models/members/member-kinds.ts
+function isFunctionEffectKind(value) {
+  return value === 0 /* None */ || value === 1 /* Auto */;
+}
 function isMemberAccessKind(value) {
   return MEMBER_ACCESS_KINDS.includes(value);
 }
@@ -49913,6 +50030,11 @@ function hasValidStorageField(v, allowNull) {
   if (typeof v.kind !== "number") return false;
   return memberKindSupportsStorage(v.kind);
 }
+function hasValidEffectField(v) {
+  if (v.effect === void 0) return true;
+  if (!isFunctionEffectKind(v.effect)) return false;
+  return v.kind === 13 /* Function */ || v.kind === 23 /* NSFunction */;
+}
 function hasValidDistributionField(v) {
   if (v.distribution === void 0) return true;
   if (!isNeoSubtreeDistributionKind(v.distribution)) return false;
@@ -49943,6 +50065,7 @@ function isMemberBase(value) {
   }
   if (!hasValidStorageField(v, true)) return false;
   if (!hasValidDistributionField(v)) return false;
+  if (!hasValidEffectField(v)) return false;
   const storageKey = getField(value, "storageKey");
   if (storageKey !== void 0 && storageKey !== null && typeof storageKey !== "string")
     return false;
@@ -50042,6 +50165,7 @@ function isMemberOverrideBase(value) {
   }
   if (!hasValidStorageField(v, false)) return false;
   if (!hasValidDistributionField(v)) return false;
+  if (!hasValidEffectField(v)) return false;
   if (v.defaultValue !== void 0 && v.defaultValue !== null && !isMemberValueBase(v.defaultValue)) {
     return false;
   }
@@ -59701,6 +59825,7 @@ function emitMember(context, member, enclosingClassId) {
     // P76 §1 is never materialized into source, so a member that omits the
     // annotation round-trips as an omission.
     ...member.distribution ? [`@distribution(kind: .${enumCase(member.distribution)})`] : [],
+    ...(member.kind === "function" || member.kind === "scriptFunction") && member.effect !== void 0 ? [member.effect === "auto" ? "@effect" : "@effect(kind: .None)"] : [],
     ...memberSettings(context, member),
     ...listAnnotations(member),
     ...member.system ? [systemAnnotation2(member.system)] : []
@@ -62573,6 +62698,11 @@ function lowerMemberKind(context, ownerClass, declaration, id2, owner) {
         };
       }
     );
+    const effect = functionEffectValue(
+      annotation(declaration.annotations, "effect"),
+      ownerClass,
+      declaration
+    );
     const settings = annotation(declaration.annotations, "settings");
     const logicMode = contextualEnumArgument(settings, "logic");
     if (logicMode !== null && logicMode !== "UI") {
@@ -62599,6 +62729,7 @@ function lowerMemberKind(context, ownerClass, declaration, id2, owner) {
         returnType,
         arguments: argumentsValue,
         deferred: declaration.modifiers.includes("async"),
+        ...effect,
         ...logicMode === "UI" ? { bodyMode: "ui", uiAction } : {},
         script: {
           kind: "function",
@@ -62616,6 +62747,7 @@ function lowerMemberKind(context, ownerClass, declaration, id2, owner) {
         returnType,
         arguments: argumentsValue,
         deferred: declaration.modifiers.includes("async"),
+        ...effect,
         bodyMode: "ui",
         ...uiAction === void 0 ? {} : { uiAction },
         script: null
@@ -62628,6 +62760,7 @@ function lowerMemberKind(context, ownerClass, declaration, id2, owner) {
         returnType,
         arguments: argumentsValue,
         deferred: declaration.modifiers.includes("async"),
+        ...effect,
         script: null
       };
     }
@@ -62636,7 +62769,8 @@ function lowerMemberKind(context, ownerClass, declaration, id2, owner) {
       kind: "function",
       returnType,
       arguments: argumentsValue,
-      deferred: declaration.modifiers.includes("async")
+      deferred: declaration.modifiers.includes("async"),
+      ...effect
     };
   }
   return lowerFieldMember(
@@ -62766,6 +62900,16 @@ function distributionValue(value, ownerClass, declaration) {
     `@distribution on ${site} has unknown kind ".${kind}". Valid kinds are .Sparse and .Packed.`
   );
 }
+function functionEffectValue(value, ownerClass, declaration) {
+  if (value === void 0) return {};
+  if (value.arguments.length === 0) return { effect: "auto" };
+  const kind = contextualEnumArgument(value, "kind");
+  if (kind === "None") return { effect: "none" };
+  if (kind === "Auto") return { effect: "auto" };
+  throw new Error(
+    `@effect on ${ownerClass.name}.${declaration.name} has unknown kind${kind === null ? "" : ` ".${kind}"`}. Valid kinds are .None and .Auto.`
+  );
+}
 function resolvedMemberStorage(context, memberId, visited = /* @__PURE__ */ new Set()) {
   if (visited.has(memberId)) return null;
   visited.add(memberId);
@@ -145290,6 +145434,113 @@ var init_project_integrity = __esm({
   }
 });
 
+// src/test-worker-pool.ts
+import { Worker as Worker5 } from "node:worker_threads";
+var TestWorkerPool;
+var init_test_worker_pool = __esm({
+  "src/test-worker-pool.ts"() {
+    "use strict";
+    TestWorkerPool = class {
+      constructor(workerUrl) {
+        this.workerUrl = workerUrl;
+      }
+      workerUrl;
+      interrupted = false;
+      workers = [];
+      failures = /* @__PURE__ */ new Map();
+      pending = /* @__PURE__ */ new Map();
+      async start(document, count) {
+        await Promise.all(
+          Array.from({ length: count }, async () => {
+            const worker = new Worker5(this.workerUrl);
+            this.workers.push(worker);
+            worker.on(
+              "error",
+              (error) => this.fail(
+                worker,
+                error instanceof Error ? error : new Error(String(error))
+              )
+            );
+            worker.on(
+              "exit",
+              (code) => this.fail(
+                worker,
+                new Error(
+                  `Test worker exited before completing its file (code ${code}).`
+                )
+              )
+            );
+            const response = await this.request(worker, { kind: "init", document });
+            if (response.kind !== "ready")
+              throw new Error("Test worker did not initialize its project.");
+          })
+        );
+      }
+      fail(worker, error) {
+        this.failures.set(worker, error);
+        this.pending.get(worker)?.(error);
+      }
+      request(worker, request) {
+        const failure = this.failures.get(worker);
+        if (failure !== void 0) return Promise.reject(failure);
+        return new Promise((resolve5, reject) => {
+          const cleanup = () => {
+            worker.off("message", onMessage);
+            this.pending.delete(worker);
+          };
+          const onMessage = (response) => {
+            cleanup();
+            if (response.kind === "error") reject(new Error(response.message));
+            else resolve5(response);
+          };
+          const onError = (error) => {
+            cleanup();
+            reject(error);
+          };
+          this.pending.set(worker, onError);
+          worker.once("message", onMessage);
+          try {
+            worker.postMessage(request);
+          } catch (error) {
+            onError(error instanceof Error ? error : new Error(String(error)));
+          }
+        });
+      }
+      async run(jobs, timeoutMs, onResult) {
+        let next = 0;
+        await Promise.all(
+          this.workers.map(async (worker) => {
+            while (!this.interrupted && next < jobs.length) {
+              const job = jobs[next++];
+              const response = await this.request(worker, {
+                kind: "run",
+                ...job,
+                timeoutMs
+              });
+              if (response.kind !== "result")
+                throw new Error("Test worker returned no file result.");
+              onResult(job.spec, response.result);
+            }
+          })
+        );
+      }
+      interrupt() {
+        this.interrupted = true;
+        for (const worker of this.workers) {
+          worker.postMessage({ kind: "interrupt" });
+        }
+      }
+      async stop() {
+        for (const reject of this.pending.values())
+          reject(new Error("Test worker stopped."));
+        await Promise.all(this.workers.map((worker) => worker.terminate()));
+        this.workers.length = 0;
+        this.failures.clear();
+      }
+    };
+  }
+});
+
 // src/neoscript-language-adapter.ts
 function createCliNeoScriptContext(options) {
   const members = [...options.documents.members];
@@ -145299,12 +145550,7 @@ function createCliNeoScriptContext(options) {
     members,
     classes: [...options.documents.classes],
     enums: [...options.documents.enums],
-    interfaces: [...options.documents.interfaces],
-    databaseVM: {
-      memberById: (id2) => members.find(
-        (member) => member.id === id2
-      ) ?? null
-    }
+    interfaces: [...options.documents.interfaces]
   };
   const compilerContext = createNeoScriptDocumentContext({
     vm,
@@ -145346,7 +145592,7 @@ async function validateCliNeoScript(uri, source, context) {
     service.closeDocument(uri);
   }
 }
-function compileCliNeoScript(uri, source, context) {
+function compileCliNeoScript(uri, source, context, projectIndex) {
   const result = compileNeoScriptStrict(
     {
       uri,
@@ -145354,7 +145600,8 @@ function compileCliNeoScript(uri, source, context) {
       version: 1,
       text: source
     },
-    context
+    context,
+    { projectIndex }
   );
   const error = result.diagnostics.find(
     (diagnostic) => diagnostic.severity === "error"
@@ -147354,7 +147601,7 @@ var init_registry2 = __esm({
   "../packages/manifest/schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.62.1",
+      cliVersion: "0.63.0",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -147406,6 +147653,10 @@ var init_registry2 = __esm({
             "argumentTypes",
             "dispatch",
             "bodyMode",
+            // P97 §1.1. No normalization rule, like `distribution`: absence means
+            // unset (a declaration resolves to `.None`, an override inherits) and
+            // explicit ordinal 0 is an authored `.None` that stops inheritance.
+            "effect",
             "uiAction",
             "templateId",
             "genericParamId"
@@ -147708,7 +147959,8 @@ var init_registry2 = __esm({
             NeoColumnVisibility: ["Visible", "Hidden"],
             NeoColumnPin: ["None", "Leading"],
             NeoColumnOverflow: ["Clip", "Wrap"],
-            NeoFileKind: ["Sprite", "Audio"]
+            NeoFileKind: ["Sprite", "Audio"],
+            NeoEffectKind: ["None", "Auto"]
           },
           markers: {
             NeoSchemaClassAttribute: {
@@ -148773,8 +149025,10 @@ var init_registry2 = __esm({
 // src/commands/test.ts
 var test_exports = {};
 __export(test_exports, {
+  executeTestFile: () => executeTestFile,
   inspectNeoTestCompilation: () => inspectNeoTestCompilation,
   maintainNeoTestBuildCache: () => maintainNeoTestBuildCache,
+  prepareTestEvaluator: () => prepareTestEvaluator,
   runTest: () => runTest
 });
 import { createHash as createHash10, randomUUID as randomUUID6 } from "node:crypto";
@@ -148798,6 +149052,7 @@ import {
   resolve as resolve4,
   sep as sep8
 } from "node:path";
+import { availableParallelism } from "node:os";
 import { isDeepStrictEqual } from "node:util";
 function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -149119,8 +149374,28 @@ function cacheTestCandidate(workspace, inputFingerprint, candidate) {
   );
   return { ...candidate, documentSha256 };
 }
-function compileSpec(workspace, document, absolutePath, projectCompilationHash2) {
-  const scriptDocument = readDocumentArrays(document);
+function createSpecCompiler(document) {
+  const context = withNeoTestPrelude({
+    ...createCliNeoScriptContext({
+      documents: readDocumentArrays(document),
+      kind: "function",
+      thisClass: null
+    }),
+    kind: "function",
+    projectSourceKind: "spec",
+    returnType: { kind: "primitive", name: "void" }
+  });
+  const projectIndex = createProjectIndex(context.project);
+  return (uri, source) => compileCliNeoScript(uri, source, context, projectIndex);
+}
+function lazySpecCompiler(document) {
+  let compiler;
+  return (uri, source) => {
+    compiler ??= createSpecCompiler(document);
+    return compiler(uri, source);
+  };
+}
+function compileSpec(workspace, compile, absolutePath, projectCompilationHash2) {
   const path = relative8(workspace.root, absolutePath).split(sep8).join("/");
   const source = readFileSync19(absolutePath, "utf8");
   const sourceHash = createHash10("sha256").update(source).digest("hex");
@@ -149143,21 +149418,10 @@ function compileSpec(workspace, document, absolutePath, projectCompilationHash2)
     }
   } catch {
   }
-  const baseContext2 = createCliNeoScriptContext({
-    documents: scriptDocument,
-    kind: "function",
-    thisClass: null
-  });
-  const context = withNeoTestPrelude({
-    ...baseContext2,
-    kind: "function",
-    projectSourceKind: "spec",
-    returnType: { kind: "primitive", name: "void" }
-  });
   const compiled = {
     path,
     source,
-    action: compileCliNeoScript(`file://${absolutePath}`, source, context)
+    action: compile(`file://${absolutePath}`, source)
   };
   atomicWrite(
     artifactPath,
@@ -149837,6 +150101,18 @@ function failureFor(error, file, position, member = null) {
 function suiteHasSelectedTests(suite, selected) {
   return suite.tests.some((test) => selected.has(test.id)) || suite.suites.some((child) => suiteHasSelectedTests(child, selected));
 }
+function prepareTestEvaluator(document) {
+  sharedEvaluatorBase(document);
+}
+async function executeTestFile(spec, document, selected, timeoutMs, interrupted = () => false) {
+  return executeRegisteredSpec(
+    registerSpec(spec, document),
+    document,
+    selected,
+    timeoutMs,
+    interrupted
+  );
+}
 async function executeRegisteredSpec(registered, document, selected, timeoutMs, interrupted) {
   const results = [];
   const fileFailures = [];
@@ -150035,8 +150311,11 @@ async function runTest(workspace, options, dependencies = {}) {
   let testDurationMs = 0;
   let exitCode = 0;
   let interrupted = false;
+  let workerPool;
+  let parallelExecution = false;
   const handleSigint = () => {
     interrupted = true;
+    workerPool?.interrupt();
   };
   const assertNotInterrupted = () => {
     if (interrupted) {
@@ -150051,6 +150330,7 @@ async function runTest(workspace, options, dependencies = {}) {
     select: 0,
     compile: 0,
     register: 0,
+    workers: 0,
     execute: 0,
     finalize: 0
   };
@@ -150081,6 +150361,9 @@ async function runTest(workspace, options, dependencies = {}) {
       }
       if (candidate === null) {
         const prepared = dependencies.prepareLocalCandidate === void 0 ? await prepareLocalCandidateV4(workspace, {
+          // Tests need the compiled, validated candidate. Serializing it
+          // back to source and re-lowering is a push dry-run check.
+          fullValidation: false,
           onPhase: (label) => {
             dependencies.progress?.update(label);
           }
@@ -150132,8 +150415,9 @@ async function runTest(workspace, options, dependencies = {}) {
       );
     }
     enterPhase("compile", "Compiling test files\u2026");
+    const compile = lazySpecCompiler(rawDocument);
     specs = selectedPaths.map(
-      (path) => compileSpec(workspace, rawDocument, path, compilationHash)
+      (path) => compileSpec(workspace, compile, path, compilationHash)
     );
     let pattern = null;
     if (options.testNamePattern !== null) {
@@ -150162,21 +150446,54 @@ async function runTest(workspace, options, dependencies = {}) {
       );
     }
     const selectedIds = new Set(selectedTests.map((test) => test.id));
-    enterPhase("execute", "Running tests\u2026");
     const timeoutMs = options.timeoutMs ?? workspace.config.test?.timeoutMs ?? 5e3;
-    for (const entry of registered) {
-      const executed = await executeRegisteredSpec(
-        entry,
-        rawDocument,
-        selectedIds,
-        timeoutMs,
-        () => interrupted
-      );
+    const maxWorkers = options.maxWorkers ?? workspace.config.test?.maxWorkers ?? Math.min(4, availableParallelism());
+    if (!Number.isSafeInteger(maxWorkers) || maxWorkers <= 0) {
+      throw new NeoTestUsageError("--maxWorkers must be a positive integer.");
+    }
+    const jobs = registered.filter(
+      (entry) => (selectedTestCountByFile.get(entry.spec.path) ?? 0) > 0
+    );
+    const workerCount = options.runInBand === true ? 1 : Math.min(maxWorkers, jobs.length);
+    const recordResult = (spec, executed) => {
       results.push(...executed.tests);
       testDurationMs += executed.testDurationMs;
-      fileFailuresByPath.set(entry.spec.path, executed.failures);
+      fileFailuresByPath.set(spec.path, executed.failures);
+    };
+    if (workerCount > 1) {
+      enterPhase("workers", "Starting test workers\u2026");
+      workerPool = new TestWorkerPool(
+        new URL("./test-worker.mjs", import.meta.url)
+      );
+      await workerPool.start(rawDocument, workerCount);
       assertNotInterrupted();
+      parallelExecution = true;
+      enterPhase("execute", "Running tests\u2026");
+      await workerPool.run(
+        jobs.map((entry) => ({
+          spec: entry.spec,
+          selectedIds: entry.tests.filter((test) => selectedIds.has(test.id)).map((test) => test.id)
+        })),
+        timeoutMs,
+        recordResult
+      );
+    } else {
+      enterPhase("execute", "Running tests\u2026");
+      for (const entry of jobs) {
+        recordResult(
+          entry.spec,
+          await executeRegisteredSpec(
+            entry,
+            rawDocument,
+            selectedIds,
+            timeoutMs,
+            () => interrupted
+          )
+        );
+        assertNotInterrupted();
+      }
     }
+    assertNotInterrupted();
     if (results.some((result) => result.status === "failed") || [...fileFailuresByPath.values()].some((failures) => failures.length > 0)) {
       exitCode = 1;
     }
@@ -150184,7 +150501,7 @@ async function runTest(workspace, options, dependencies = {}) {
     const buildManifest = {
       version: 1,
       cliVersion: PROJECT_SCHEMA_CONTRACT.cliVersion,
-      runnerRevision: 3,
+      runnerRevision: 4,
       compilerRevision: NEOSCRIPT_COMPILER_REVISION,
       evaluatorRevision: 4,
       projectFingerprint,
@@ -150204,12 +150521,12 @@ async function runTest(workspace, options, dependencies = {}) {
 `
     );
   } catch (error) {
-    const diagnosticCode = error instanceof NeoTestInterruptedError ? "NEO_TEST_INTERRUPTED" : error instanceof NeoTestPreparedCandidateError ? "NEO_TEST_PREPARED_CANDIDATE" : error instanceof NeoTestUsageError ? "NEO_TEST_USAGE" : error instanceof NeoTestNoTestsError ? "NEO_TEST_NO_TESTS" : error instanceof NeoTestRegistrationError ? "NEO_TEST_REGISTRATION" : phase === "prepare" ? "NEO_TEST_PREPARATION" : phase === "compile" ? "NEO_TEST_COMPILE" : "NEO_TEST_RUNNER";
-    exitCode = error instanceof NeoTestInterruptedError ? 130 : error instanceof NeoTestUsageError || error instanceof NeoTestReportWriteError || error instanceof NeoTestPreparedCandidateError || diagnosticCode === "NEO_TEST_RUNNER" ? 2 : 1;
+    const diagnosticCode = interrupted || error instanceof NeoTestInterruptedError ? "NEO_TEST_INTERRUPTED" : error instanceof NeoTestPreparedCandidateError ? "NEO_TEST_PREPARED_CANDIDATE" : error instanceof NeoTestUsageError ? "NEO_TEST_USAGE" : error instanceof NeoTestNoTestsError ? "NEO_TEST_NO_TESTS" : error instanceof NeoTestRegistrationError ? "NEO_TEST_REGISTRATION" : phase === "prepare" ? "NEO_TEST_PREPARATION" : phase === "compile" ? "NEO_TEST_COMPILE" : "NEO_TEST_RUNNER";
+    exitCode = interrupted || error instanceof NeoTestInterruptedError ? 130 : error instanceof NeoTestUsageError || error instanceof NeoTestReportWriteError || error instanceof NeoTestPreparedCandidateError || diagnosticCode === "NEO_TEST_RUNNER" ? 2 : 1;
     diagnostics.push({
       severity: "error",
       code: diagnosticCode,
-      message: errorMessage2(error),
+      message: interrupted ? "Neo test was interrupted by SIGINT; partial results were written." : errorMessage2(error),
       file: null,
       line: null,
       column: null,
@@ -150217,6 +150534,7 @@ async function runTest(workspace, options, dependencies = {}) {
     });
   }
   finishPhase();
+  await workerPool?.stop();
   dependencies.progress?.stop();
   process.off("SIGINT", handleSigint);
   const failed = results.filter((result) => result.status === "failed").length;
@@ -150226,21 +150544,33 @@ async function runTest(workspace, options, dependencies = {}) {
   );
   const skipped = Math.max(0, selectedTestTotal - results.length);
   const durationMs = performance.now() - performanceStarted;
-  const startupDurationMs = Math.max(0, durationMs - testDurationMs);
+  const startupDurationMs = parallelExecution ? Math.max(0, durationMs - phaseDurations.execute) : Math.max(0, durationMs - testDurationMs);
   const perTestStartupDurationMs = results.reduce(
     (sum, result) => sum + result.startupDurationMs,
     0
   );
   const sharedStartupDurationMs = Math.max(
     0,
-    startupDurationMs - perTestStartupDurationMs
+    startupDurationMs - (parallelExecution ? 0 : perTestStartupDurationMs)
   );
+  const testsByFile = /* @__PURE__ */ new Map();
+  for (const result of results) {
+    const tests = testsByFile.get(result.file) ?? [];
+    tests.push(result);
+    testsByFile.set(result.file, tests);
+  }
   const testFiles = specs.map((spec) => {
-    const tests = results.filter((result) => result.file === spec.path);
+    const tests = testsByFile.get(spec.path) ?? [];
     const failures = fileFailuresByPath.get(spec.path) ?? [];
+    let status = "passed";
+    if (tests.some((test) => test.status === "failed") || failures.length > 0) {
+      status = "failed";
+    } else if (tests.length < (selectedTestCountByFile.get(spec.path) ?? 0) && exitCode !== 0) {
+      status = interrupted ? "interrupted" : "failed";
+    }
     return {
       path: spec.path,
-      status: tests.some((test) => test.status === "failed") || failures.length > 0 ? "failed" : interrupted && tests.length < (selectedTestCountByFile.get(spec.path) ?? 0) ? "interrupted" : "passed",
+      status,
       tests,
       failures
     };
@@ -150276,6 +150606,7 @@ async function runTest(workspace, options, dependencies = {}) {
       selectMs: phaseDurations.select,
       compileMs: phaseDurations.compile,
       registerMs: phaseDurations.register,
+      workerStartupMs: phaseDurations.workers,
       executeMs: phaseDurations.execute,
       finalizeMs: phaseDurations.finalize
     },
@@ -150357,8 +150688,9 @@ async function runTest(workspace, options, dependencies = {}) {
     console.log(
       ` ${color.bold(pad("Tests", 11))} ${formatStatusCounts(report.summary.passed, report.summary.failed, report.summary.tests, report.summary.skipped)}`
     );
+    const timingDetail = parallelExecution ? `test work ${formatTestDuration(report.summary.testDurationMs)}, execution ${formatTestDuration(report.timings.executeMs)}, startup ${formatTestDuration(report.summary.startupDurationMs)}` : `test ${formatTestDuration(report.summary.testDurationMs)}, startup ${formatTestDuration(report.summary.startupDurationMs)}`;
     console.log(
-      ` ${color.bold(pad("Duration", 11))} ${color.bold(`total ${formatTestDuration(report.summary.durationMs)}`)} ${color.dim(`(test ${formatTestDuration(report.summary.testDurationMs)}, startup ${formatTestDuration(report.summary.startupDurationMs)})`)}`
+      ` ${color.bold(pad("Duration", 11))} ${color.bold(`total ${formatTestDuration(report.summary.durationMs)}`)} ${color.dim(`(${timingDetail})`)}`
     );
   }
   if (!report.success) process.exitCode = exitCode;
@@ -150388,9 +150720,10 @@ async function inspectNeoTestCompilation(workspace, dependencies = {}) {
     document
   );
   const errors = [];
+  const compile = lazySpecCompiler(document);
   for (const path of selectedPaths) {
     try {
-      compileSpec(workspace, document, path, compilationHash);
+      compileSpec(workspace, compile, path, compilationHash);
     } catch (error) {
       errors.push({
         file: relative8(workspace.root, path).split(sep8).join("/"),
@@ -150409,6 +150742,7 @@ var TEST_BUILD_CACHE_LIMIT_BYTES, ABANDONED_TEMP_MAX_AGE_MS, TEST_CANDIDATE_CACH
 var init_test = __esm({
   "src/commands/test.ts"() {
     "use strict";
+    init_test_worker_pool();
     init_src();
     init_members();
     init_neoscript2();
@@ -155345,7 +155679,7 @@ function readManifest(path) {
   });
   return { projectId: data.projectId, files };
 }
-function writeUnityGeneratedFiles(directory, projectId, files) {
+function writeUnityGeneratedFiles(directory, projectId, files, codegenRevision) {
   if (!Array.isArray(files) || files.length === 0)
     throw new Error(
       "The export returned no generated files. Update the server before exporting Unity code."
@@ -155409,6 +155743,7 @@ function writeUnityGeneratedFiles(directory, projectId, files) {
       {
         schemaVersion: 1,
         projectId,
+        codegenRevision,
         files: [...files].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0).map((file) => ({
           id: file.id,
           path: file.path,
@@ -155490,7 +155825,8 @@ async function runExportUnity(workspace, outDir) {
   writeUnityGeneratedFiles(
     scriptsDir,
     response.projectId,
-    response.generatedFiles
+    response.generatedFiles,
+    response.codegenRevision
   );
   writeFileSync16(join19(resourcesDir, "project.json"), response.projectJson);
   for (const file of response.localizationFiles ?? []) {
@@ -155947,6 +156283,11 @@ ${h("Usage")}
   neo test ${d("[file-or-directory ...]")}
   neo test -t ${d('"name pattern"')}
   neo test ${d("--reporter=json --outputFile=output.json")}
+  neo test ${d("--maxWorkers=4")}
+  neo test ${d("--runInBand")}
+
+Files run in parallel, using up to four available CPU workers by default.
+--maxWorkers overrides neo.json test.maxWorkers; --runInBand runs serially.
 
 Tests execute against the locally compiled candidate graph, including changes
 that have not been pushed. Test files are never included in a push.
@@ -156034,7 +156375,7 @@ There is no --keep-current: preserving current semantic state defines flatten.
 async function main() {
   const args = parseArgs(process.argv.slice(2));
   if (args.command === "--version") {
-    console.log("0.62.1");
+    console.log("0.63.0");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {
@@ -156360,6 +156701,11 @@ async function main() {
           "--testTimeout must be a positive number of milliseconds."
         );
       }
+      const maxWorkersValue = stringFlag(args, "maxWorkers");
+      const maxWorkers = maxWorkersValue === null ? void 0 : Number(maxWorkersValue);
+      if (maxWorkers !== void 0 && (!Number.isSafeInteger(maxWorkers) || maxWorkers <= 0)) {
+        throw new NeoCliUsageError("--maxWorkers must be a positive integer.");
+      }
       const progress = reporterValue === "default" && process.stdout.isTTY === true ? spinner("Reading local workspace\u2026") : null;
       try {
         const workspace = loadWorkspaceForCommand(args);
@@ -156372,6 +156718,8 @@ async function main() {
             reporter: reporterValue,
             outputFile: stringFlag(args, "outputFile") ?? stringFlag(args, "output-file"),
             passWithNoTests: boolFlag(args, "passWithNoTests"),
+            runInBand: boolFlag(args, "runInBand"),
+            ...maxWorkers === void 0 ? {} : { maxWorkers },
             ...timeoutMs === void 0 ? {} : { timeoutMs }
           },
           progress === null ? {} : { progress }