@neocompose/cli 0.50.0 → 0.50.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## [0.50.1] - 2026-09-12
+
+- Reuse schema and symbol indexes while compiling a push, including migration bodies, and compile each changed member body once. Bulk scripted changes no longer rebuild the complete project for every body.
+
 ## [0.50.0] - 2026-09-11
 
 - Expose tile placement assets with `@tile(VoidTile)` or `@tile(asset: VoidTile)`. Pull emits the tile class beside each placement; authored bindings resolve to the existing asset metadata.

package/dist/neo.mjs

@@ -14506,8 +14506,12 @@ function compileNeoScriptStrict(document, context, options = {}) {
     };
   }
 }
-function assertNeoScriptCompiles(document, context) {
-  const result = compileNeoScriptStrict(document, context);
+function assertNeoScriptCompiles(document, context, projectIndex) {
+  const result = compileNeoScriptStrict(
+    document,
+    context,
+    projectIndex === void 0 ? {} : { projectIndex }
+  );
   const diagnostic = result.diagnostics[0];
   if (diagnostic) {
     throw new CompileError(diagnostic.message, {
@@ -14586,8 +14590,8 @@ function attachDependencyManifest(compiled, syntax, project, context) {
     recordIds.add(alias.valueId);
     collectDependencyIds(alias.type, null, recordIds);
   }
-  const typeNames = [...project.typeByName.keys()].filter(
-    (name) => identifiers.has(name)
+  const typeNames = [...identifiers].filter(
+    (name) => project.typeByName.has(name)
   );
   return {
     ...compiled,
@@ -33504,6 +33508,7 @@ var init_service = __esm({
     init_test_prelude();
     LanguageService = class {
       documents = /* @__PURE__ */ new Map();
+      specSnapshots = /* @__PURE__ */ new Set();
       projectGeneration = 0;
       cachedProjectAnalysis;
       openDocument(document, context) {
@@ -33513,6 +33518,7 @@ var init_service = __esm({
           );
         }
         const previous = this.documents.get(document.uri);
+        if (previous) this.specSnapshots.delete(previous);
         this.documents.set(document.uri, {
           document,
           context,
@@ -33538,6 +33544,7 @@ var init_service = __esm({
         state.document = document;
         const previousProjectIndex = state.snapshot?.project;
         state.snapshot = void 0;
+        this.specSnapshots.delete(state);
         if (!isProjectDocument(document, state.context) && state.context.projectSourceKind !== "spec") {
           state.snapshot = createSnapshot(
             document,
@@ -33569,6 +33576,7 @@ var init_service = __esm({
         }
         state.context = context;
         state.contextKey = contextKey;
+        this.specSnapshots.delete(state);
         state.snapshot = isProjectDocument(state.document, context) || context.projectSourceKind === "spec" ? void 0 : createSnapshot(state.document, context);
         state.validationGeneration++;
         if (isProjectDocument(state.document, context))
@@ -33577,9 +33585,11 @@ var init_service = __esm({
       closeDocument(uri) {
         const state = this.documents.get(uri);
         this.documents.delete(uri);
+        if (state) this.specSnapshots.delete(state);
         if (state && isProjectDocument(state.document, state.context)) {
           this.invalidateProjectAnalysis();
         }
+        if (this.documents.size === 0) this.cachedProjectAnalysis = void 0;
       }
       hasDocument(uri) {
         return this.documents.has(uri);
@@ -33817,7 +33827,8 @@ var init_service = __esm({
               kind: document.languageId === "neoflow" ? "flow" : context.kind === "migration" ? "migration" : "definition",
               text: document.text
             } : null
-          ).filter((input) => input !== null)
+          ).filter((input) => input !== null),
+          this.cachedProjectAnalysis?.analysis.documents
         );
         this.cachedProjectAnalysis = {
           generation: this.projectGeneration,
@@ -33827,11 +33838,8 @@ var init_service = __esm({
       }
       invalidateProjectAnalysis() {
         this.projectGeneration++;
-        this.cachedProjectAnalysis = void 0;
-        for (const state of this.documents.values()) {
-          if (state.context.projectSourceKind === "spec")
-            state.snapshot = void 0;
-        }
+        for (const state of this.specSnapshots) state.snapshot = void 0;
+        this.specSnapshots.clear();
       }
       projectReferences(document, position, includeDeclaration) {
         const token = projectTokenAt(document, position);
@@ -33883,6 +33891,8 @@ var init_service = __esm({
             project: this.projectAnalysis().project
           }) : state.context
         );
+        if (state.context.projectSourceKind === "spec")
+          this.specSnapshots.add(state);
         return state.snapshot;
       }
       requireState(uri) {
@@ -44326,36 +44336,36 @@ var MemberKind;
 var init_member_kind_enum = __esm({
   "../src/models/members/member-kind-enum.ts"() {
     "use strict";
-    MemberKind = /* @__PURE__ */ ((MemberKind15) => {
-      MemberKind15[MemberKind15["Null"] = 0] = "Null";
-      MemberKind15[MemberKind15["Bool"] = 1] = "Bool";
-      MemberKind15[MemberKind15["Int"] = 2] = "Int";
-      MemberKind15[MemberKind15["String"] = 3] = "String";
-      MemberKind15[MemberKind15["Float"] = 4] = "Float";
-      MemberKind15[MemberKind15["Dictionary"] = 5] = "Dictionary";
-      MemberKind15[MemberKind15["List"] = 6] = "List";
-      MemberKind15[MemberKind15["Class"] = 7] = "Class";
-      MemberKind15[MemberKind15["Enum"] = 8] = "Enum";
-      MemberKind15[MemberKind15["Lookup"] = 9] = "Lookup";
-      MemberKind15[MemberKind15["NSProperty"] = 10] = "NSProperty";
-      MemberKind15[MemberKind15["Sprite"] = 11] = "Sprite";
-      MemberKind15[MemberKind15["Audio"] = 12] = "Audio";
-      MemberKind15[MemberKind15["Function"] = 13] = "Function";
-      MemberKind15[MemberKind15["Vector2"] = 14] = "Vector2";
-      MemberKind15[MemberKind15["Vector2Int"] = 15] = "Vector2Int";
-      MemberKind15[MemberKind15["Vector3"] = 16] = "Vector3";
-      MemberKind15[MemberKind15["Vector3Int"] = 17] = "Vector3Int";
-      MemberKind15[MemberKind15["DialogueLookup"] = 18] = "DialogueLookup";
-      MemberKind15[MemberKind15["Color"] = 19] = "Color";
-      MemberKind15[MemberKind15["Decimal"] = 20] = "Decimal";
-      MemberKind15[MemberKind15["Generic"] = 21] = "Generic";
-      MemberKind15[MemberKind15["Interface"] = 22] = "Interface";
-      MemberKind15[MemberKind15["NSFunction"] = 23] = "NSFunction";
-      MemberKind15[MemberKind15["FunctionRef"] = 24] = "FunctionRef";
-      MemberKind15[MemberKind15["NSDelegate"] = 25] = "NSDelegate";
-      MemberKind15[MemberKind15["NSAction"] = 26] = "NSAction";
-      MemberKind15[MemberKind15["Variant"] = 27] = "Variant";
-      return MemberKind15;
+    MemberKind = /* @__PURE__ */ ((MemberKind16) => {
+      MemberKind16[MemberKind16["Null"] = 0] = "Null";
+      MemberKind16[MemberKind16["Bool"] = 1] = "Bool";
+      MemberKind16[MemberKind16["Int"] = 2] = "Int";
+      MemberKind16[MemberKind16["String"] = 3] = "String";
+      MemberKind16[MemberKind16["Float"] = 4] = "Float";
+      MemberKind16[MemberKind16["Dictionary"] = 5] = "Dictionary";
+      MemberKind16[MemberKind16["List"] = 6] = "List";
+      MemberKind16[MemberKind16["Class"] = 7] = "Class";
+      MemberKind16[MemberKind16["Enum"] = 8] = "Enum";
+      MemberKind16[MemberKind16["Lookup"] = 9] = "Lookup";
+      MemberKind16[MemberKind16["NSProperty"] = 10] = "NSProperty";
+      MemberKind16[MemberKind16["Sprite"] = 11] = "Sprite";
+      MemberKind16[MemberKind16["Audio"] = 12] = "Audio";
+      MemberKind16[MemberKind16["Function"] = 13] = "Function";
+      MemberKind16[MemberKind16["Vector2"] = 14] = "Vector2";
+      MemberKind16[MemberKind16["Vector2Int"] = 15] = "Vector2Int";
+      MemberKind16[MemberKind16["Vector3"] = 16] = "Vector3";
+      MemberKind16[MemberKind16["Vector3Int"] = 17] = "Vector3Int";
+      MemberKind16[MemberKind16["DialogueLookup"] = 18] = "DialogueLookup";
+      MemberKind16[MemberKind16["Color"] = 19] = "Color";
+      MemberKind16[MemberKind16["Decimal"] = 20] = "Decimal";
+      MemberKind16[MemberKind16["Generic"] = 21] = "Generic";
+      MemberKind16[MemberKind16["Interface"] = 22] = "Interface";
+      MemberKind16[MemberKind16["NSFunction"] = 23] = "NSFunction";
+      MemberKind16[MemberKind16["FunctionRef"] = 24] = "FunctionRef";
+      MemberKind16[MemberKind16["NSDelegate"] = 25] = "NSDelegate";
+      MemberKind16[MemberKind16["NSAction"] = 26] = "NSAction";
+      MemberKind16[MemberKind16["Variant"] = 27] = "Variant";
+      return MemberKind16;
     })(MemberKind || {});
   }
 });
@@ -53516,18 +53526,27 @@ function storedLeafExpectation(kind) {
   return "canonical decimal string";
 }
 function* storedValueChildReferences(args) {
+  for (const child of storedValueChildEntries(args)) {
+    if (typeof child.value !== "string") continue;
+    yield {
+      memberId: child.memberId,
+      valueId: child.value,
+      pathSuffix: child.pathSuffix
+    };
+  }
+}
+function* storedValueChildEntries(args) {
   const entryMemberId = args.member.entryMemberId;
   if (args.member.kind === 6 /* List */ && typeof entryMemberId === "string") {
     const ids = args.member.listKind === 1 /* Unordered */ && args.unorderedValueIds !== void 0 ? args.unorderedValueIds : Array.isArray(args.body) ? args.body : [];
     let pathIndex = 0;
     for (const valueId of ids) {
-      if (typeof valueId !== "string") continue;
       yield {
         memberId: entryMemberId,
-        valueId,
+        value: valueId,
         pathSuffix: `[${pathIndex}]`
       };
-      pathIndex++;
+      if (typeof valueId === "string") pathIndex++;
     }
     return;
   }
@@ -53536,16 +53555,14 @@ function* storedValueChildReferences(args) {
     for (const key in body) {
       if (!Object.hasOwn(body, key)) continue;
       const valueId = body[key];
-      if (typeof valueId !== "string") continue;
-      yield { memberId: entryMemberId, valueId, pathSuffix: `.${key}` };
+      yield { memberId: entryMemberId, value: valueId, pathSuffix: `.${key}` };
     }
     return;
   }
   if (args.member.kind === 7 /* Class */ && body !== null) {
     for (const { schemaKey, memberId } of args.classFields ?? []) {
       const valueId = body[schemaKey];
-      if (typeof valueId !== "string") continue;
-      yield { memberId, valueId, pathSuffix: `.${schemaKey}` };
+      yield { memberId, value: valueId, pathSuffix: `.${schemaKey}` };
     }
   }
 }
@@ -68159,25 +68176,31 @@ function clearNeoScriptBodyCompileCache() {
   neoScriptBodyCompileCache.clear();
 }
 function createNeoScriptCompilationProject(ctx) {
-  const members = [...ctx.members];
-  const membersById = new Map(members.map((member) => [member.id, member]));
-  return createNeoScriptProject({
-    vm: {
-      project: ctx.project,
-      projectFiles: [...ctx.projectFiles ?? []],
-      members,
-      classes: [...ctx.classes],
-      enums: [...ctx.enums],
-      interfaces: [...ctx.interfaces ?? []],
-      databaseVM: {
-        memberById: (id2) => membersById.get(id2) ?? null
-      }
-    },
+  const vm = createAnalyzerProject(ctx);
+  const project = createNeoScriptProject({
+    vm,
     thisClass: null,
     ...ctx.constructors ? { constructors: ctx.constructors } : {},
     ...ctx.variants ? { variants: ctx.variants } : {},
     ...ctx.variantFolders ? { variantFolders: ctx.variantFolders } : {}
   });
+  analyzerProjects.set(project, vm);
+  return project;
+}
+function createAnalyzerProject(ctx) {
+  const members = [...ctx.members];
+  const membersById = new Map(members.map((member) => [member.id, member]));
+  return {
+    project: ctx.project,
+    projectFiles: [...ctx.projectFiles ?? []],
+    members,
+    classes: [...ctx.classes],
+    enums: [...ctx.enums],
+    interfaces: [...ctx.interfaces ?? []],
+    databaseVM: {
+      memberById: (id2) => membersById.get(id2) ?? null
+    }
+  };
 }
 function compileNSGetter(code, ctx) {
   return compileStrict(
@@ -68311,7 +68334,8 @@ function compileStrict(code, context) {
       version: 1,
       text: code
     },
-    context
+    context,
+    compilationProjectIndex(context.project)
   );
   if ("getter" in compiled) {
     throw new Error(
@@ -68333,21 +68357,17 @@ function compilationProjectIdentity(project) {
   neoScriptProjectIdentityCache.set(project, identity2);
   return identity2;
 }
+function compilationProjectIndex(project) {
+  const cached = neoScriptProjectIndexes.get(project);
+  if (cached !== void 0) return cached;
+  const index = createProjectIndex(project);
+  neoScriptProjectIndexes.set(project, index);
+  return index;
+}
 function createContext(ctx, options) {
-  const members = [...ctx.members];
-  const membersById = new Map(members.map((member) => [member.id, member]));
+  const prepared = ctx.compilationProject === void 0 ? void 0 : analyzerProjects.get(ctx.compilationProject);
   const analyzer = {
-    vm: {
-      project: ctx.project,
-      projectFiles: [...ctx.projectFiles ?? []],
-      members,
-      classes: [...ctx.classes],
-      enums: [...ctx.enums],
-      interfaces: [...ctx.interfaces ?? []],
-      databaseVM: {
-        memberById: (id2) => membersById.get(id2) ?? null
-      }
-    },
+    vm: prepared ?? createAnalyzerProject(ctx),
     thisClass: ctx.thisClass,
     ...ctx.valueAliases ? { valueAliases: ctx.valueAliases } : {},
     ...ctx.constructors ? { constructors: ctx.constructors } : {},
@@ -68374,7 +68394,7 @@ function createContext(ctx, options) {
     staticMember: ctx.staticMember === true
   };
 }
-var NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT, neoScriptBodyCompileCache, neoScriptProjectIdentityCache, nextNeoScriptProjectIdentity;
+var NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT, neoScriptBodyCompileCache, neoScriptProjectIdentityCache, neoScriptProjectIndexes, analyzerProjects, nextNeoScriptProjectIdentity;
 var init_compile = __esm({
   "../src/database/neoscript/compile.ts"() {
     "use strict";
@@ -68383,6 +68403,8 @@ var init_compile = __esm({
     NEOSCRIPT_BODY_COMPILE_CACHE_LIMIT = 1024;
     neoScriptBodyCompileCache = /* @__PURE__ */ new Map();
     neoScriptProjectIdentityCache = /* @__PURE__ */ new WeakMap();
+    neoScriptProjectIndexes = /* @__PURE__ */ new WeakMap();
+    analyzerProjects = /* @__PURE__ */ new WeakMap();
     nextNeoScriptProjectIdentity = 1;
   }
 });
@@ -84253,6 +84275,108 @@ var init_project_record_migrations = __esm({
   }
 });
 
+// ../src/database/member-default-reference-ids.ts
+async function loadMemberDefaultValueClosure(args) {
+  const classes = args.classes.filter(isNeoSchemaClass);
+  const members = args.members.filter(isAnyMember);
+  const index = projectSchemaIndexFor({ classes, members });
+  const classSchemas = /* @__PURE__ */ new Map();
+  const defaultEnvironments = /* @__PURE__ */ new Map();
+  const defaultEnvironment = (classId) => {
+    let env = defaultEnvironments.get(classId);
+    if (env === void 0) {
+      env = resolveInstanceEnv(classId, void 0, classes);
+      defaultEnvironments.set(classId, env);
+    }
+    return env;
+  };
+  const pending = [];
+  const visited = /* @__PURE__ */ new Set();
+  const closure = /* @__PURE__ */ new Map();
+  const visit = (rawMember, source, ambientEnv) => {
+    if (!isLiteralValueContent(source)) return;
+    if (typeof source.value !== "object" || source.value === null || Object.keys(source.value).length === 0)
+      return;
+    const stamp = "genericBindings" in source ? source.genericBindings : void 0;
+    const withStamp = (base) => {
+      if (typeof stamp !== "object" || stamp === null) return base;
+      const stamped = new Map(base);
+      for (const [parameterId, memberId] of Object.entries(stamp)) {
+        if (typeof memberId === "string")
+          stamped.set(parameterId, { kind: "member", memberId });
+      }
+      return stamped;
+    };
+    let env = withStamp(ambientEnv);
+    const member = substituteMember(rawMember, env, members);
+    let classFields;
+    if (isMemberClassBase(member)) {
+      const classId = source.classId ?? member.classId;
+      classFields = classSchemas.get(classId);
+      if (classFields === void 0) {
+        classFields = mergeStoredInstanceSchema(classId, classes, members);
+        classSchemas.set(classId, classFields);
+      }
+      env = withStamp(
+        member.classArguments == null ? defaultEnvironment(classId) : resolveInstanceEnv(classId, member.classArguments, classes)
+      );
+    }
+    for (const child of storedValueChildEntries({
+      member,
+      body: source.value,
+      classFields
+    })) {
+      const childMember = index.member(child.memberId);
+      if (childMember === void 0) continue;
+      if (typeof child.value === "string")
+        pending.push({ id: child.value, member: childMember, env });
+      else if (isPackedValueEnvelope(child.value))
+        visit(childMember, child.value["~packed"], env);
+    }
+  };
+  for (const member of members) {
+    if (member.defaultValue === void 0) continue;
+    const placement = index.firstSchemaPlacement(member.id);
+    const env = placement === null ? /* @__PURE__ */ new Map() : defaultEnvironment(placement.ownerClass.id);
+    visit(member, member.defaultValue, env);
+  }
+  while (pending.length > 0) {
+    const missing = [];
+    while (pending.length > 0 && missing.length < 128) {
+      const item = pending.pop();
+      if (visited.has(item.id)) continue;
+      visited.add(item.id);
+      const row = args.valuesById.get(item.id);
+      if (row === void 0) missing.push(item);
+      else {
+        closure.set(item.id, row);
+        visit(item.member, args.data(row), item.env);
+      }
+    }
+    if (missing.length === 0) continue;
+    const loaded = await args.loadValues(missing.map((item) => item.id));
+    for (const item of missing) {
+      const row = loaded.get(item.id);
+      if (row === void 0) continue;
+      closure.set(item.id, row);
+      visit(item.member, args.data(row), item.env);
+    }
+  }
+  return closure;
+}
+var init_member_default_reference_ids = __esm({
+  "../src/database/member-default-reference-ids.ts"() {
+    "use strict";
+    init_classes();
+    init_inheritance();
+    init_generics();
+    init_members();
+    init_packed_value_encoding();
+    init_stored_value_shape();
+    init_project_schema_index();
+  }
+});
+
 // ../src/database/project-document-read.ts
 var project_document_read_exports = {};
 __export(project_document_read_exports, {
@@ -84262,6 +84386,7 @@ __export(project_document_read_exports, {
   fetchProjectDocumentRawChunked: () => fetchProjectDocumentRawChunked,
   fetchProjectDocumentRawChunkedOnce: () => fetchProjectDocumentRawChunkedOnce,
   fetchProjectDocumentSnapshots: () => fetchProjectDocumentSnapshots,
+  fetchProjectDocumentValueRecords: () => fetchProjectDocumentValueRecords,
   readArrayField: () => readArrayField,
   readProjectDocument: () => readProjectDocument,
   readProjectDocumentContentHashHeads: () => readProjectDocumentContentHashHeads,
@@ -84339,7 +84464,8 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       const pageResult = await runner.fetchManifestPage(
         { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor: null },
         mapKey,
-        readBase
+        readBase,
+        "omit"
       );
       if (pageResult === null) {
         throw new Error(
@@ -84351,8 +84477,34 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       await rememberRecords(page.records);
       await fetchRemainingPages(mapKey, page.continueCursor);
     }
-    const records2 = [...recordsByKey.values()];
     const snapshotsById = await snapshots.finish();
+    if (options.mapKeys !== void 0 && !options.mapKeys.includes("all")) {
+      const members = [];
+      const classes = [];
+      const valuesById = /* @__PURE__ */ new Map();
+      for (const snapshot of snapshotsById.values()) {
+        if (snapshot.recordKind === "member") members.push(snapshot.data);
+        if (snapshot.recordKind === "class") classes.push(snapshot.data);
+        if (snapshot.recordKind === "value")
+          valuesById.set(snapshot.recordId, snapshot);
+      }
+      const defaults = await loadMemberDefaultValueClosure({
+        classes,
+        members,
+        valuesById,
+        data: (snapshot) => snapshot.data,
+        loadValues: (ids) => fetchProjectDocumentValueRecords(runner, ids, readBase)
+      });
+      for (const snapshot of defaults.values()) {
+        snapshotsById.set(snapshot.id, snapshot);
+        recordsByKey.set(`value ${snapshot.recordId}`, {
+          recordKind: "value",
+          recordId: snapshot.recordId,
+          snapshotId: snapshot.id
+        });
+      }
+    }
+    const records2 = [...recordsByKey.values()];
     await runner.validateReadBase(readBase);
     return assembleProjectDocumentRaw({
       version: metadata.version,
@@ -84379,47 +84531,95 @@ async function fetchProjectDocumentPartitionRecords(runner, mapKey, readBase) {
     );
   }
   const recordsByKey = /* @__PURE__ */ new Map();
+  const snapshots = createProjectDocumentSnapshotLoader(
+    (ids) => fetchScopedSnapshotBatch(runner, ids, readBase)
+  );
+  try {
+    let cursor = null;
+    do {
+      const pageResult = await runner.fetchManifestPage(
+        { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor },
+        mapKey,
+        readBase,
+        "omit"
+      );
+      if (pageResult === null) {
+        throw new Error(
+          `Convex project document manifest returned null for partition "${mapKey}".`
+        );
+      }
+      const page = readProjectDocumentManifestPage(pageResult);
+      assertProjectReadBase(readBase, page.readBase);
+      for (const record4 of page.records) {
+        recordsByKey.set(`${record4.recordKind} ${record4.recordId}`, record4);
+      }
+      await snapshots.enqueue(page.records.map((record4) => record4.snapshotId));
+      cursor = page.continueCursor;
+    } while (cursor !== null);
+    const snapshotsById = await snapshots.finish();
+    await runner.validateReadBase(readBase);
+    return [...recordsByKey.values()].map((record4) => {
+      const snapshot = snapshotsById.get(record4.snapshotId);
+      if (snapshot === void 0) {
+        throw new Error(
+          `Partition "${mapKey}" snapshot "${record4.snapshotId}" referenced by the manifest was not returned by any snapshot batch.`
+        );
+      }
+      return {
+        recordKind: record4.recordKind,
+        recordId: record4.recordId,
+        deleted: false,
+        data: snapshot.data,
+        contentHash: snapshot.contentHash
+      };
+    });
+  } finally {
+    await snapshots.stop();
+  }
+}
+async function fetchProjectDocumentValueRecords(runner, valueIds, readBase) {
+  if (runner.fetchValueHeadsPage === void 0) {
+    throw new Error(
+      "Partition-scoped document reads require a value-head reader for member defaults."
+    );
+  }
+  const values = /* @__PURE__ */ new Map();
   let cursor = null;
   do {
-    const pageResult = await runner.fetchManifestPage(
-      { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor },
-      mapKey,
-      readBase
-    );
-    if (pageResult === null) {
+    const page = await runner.fetchValueHeadsPage(valueIds, cursor, readBase);
+    if (!isObject4(page)) throw new Error("Value-head page must be an object.");
+    const revision = readProjectDocumentRevisionMarker({
+      documentRevision: page.documentRevision
+    });
+    if (revision === null)
+      throw new Error("Value-head page has no document revision.");
+    assertProjectReadBase(readBase, revision.readBase);
+    if (!Array.isArray(page.snapshotIds) || !page.snapshotIds.every((id2) => typeof id2 === "string"))
       throw new Error(
-        `Convex project document manifest returned null for partition "${mapKey}".`
+        "Value-head page snapshotIds must be an array of strings."
       );
-    }
-    const page = readProjectDocumentManifestPage(pageResult);
-    assertProjectReadBase(readBase, page.readBase);
-    for (const record4 of page.records) {
-      recordsByKey.set(`${record4.recordKind} ${record4.recordId}`, record4);
-    }
-    cursor = page.continueCursor;
-  } while (cursor !== null);
-  const records2 = [...recordsByKey.values()];
-  const snapshotIds = [...new Set(records2.map((record4) => record4.snapshotId))];
-  const snapshotsById = await fetchProjectDocumentSnapshots(
-    (ids) => fetchScopedSnapshotBatch(runner, ids, readBase),
-    snapshotIds
-  );
-  await runner.validateReadBase(readBase);
-  return records2.map((record4) => {
-    const snapshot = snapshotsById.get(record4.snapshotId);
-    if (snapshot === void 0) {
+    if (page.continueCursor !== null && typeof page.continueCursor !== "string")
       throw new Error(
-        `Partition "${mapKey}" snapshot "${record4.snapshotId}" referenced by the manifest was not returned by any snapshot batch.`
+        "Value-head page continueCursor must be a string or null."
       );
+    const loaded = await fetchProjectDocumentSnapshots(
+      (ids) => fetchScopedSnapshotBatch(runner, ids, readBase),
+      page.snapshotIds
+    );
+    for (const snapshot of loaded.values()) {
+      if (snapshot.recordKind !== "value")
+        throw new Error("Value-head page returned a non-value snapshot.");
+      if (snapshot.deleted)
+        throw new Error("Value-head page returned a deleted snapshot.");
+      if (!valueIds.includes(snapshot.recordId))
+        throw new Error(
+          `Value-head page returned unrequested value "${snapshot.recordId}".`
+        );
+      values.set(snapshot.recordId, snapshot);
     }
-    return {
-      recordKind: record4.recordKind,
-      recordId: record4.recordId,
-      deleted: false,
-      data: snapshot.data,
-      contentHash: snapshot.contentHash
-    };
-  });
+    cursor = page.continueCursor;
+  } while (cursor !== null);
+  return values;
 }
 function assertProjectReadBase(expected, actual) {
   if (!projectReadBasesMatch(expected, actual))
@@ -84989,8 +85189,9 @@ var init_project_document_read = __esm({
     init_projectDocumentDialogueMaterialization();
     init_projectRecordBuckets();
     init_project_record_migrations();
+    init_member_default_reference_ids();
     DOCUMENT_MANIFEST_PAGE_SIZE = 2048;
-    DOCUMENT_SNAPSHOT_FETCH_CHUNK_SIZE = 512;
+    DOCUMENT_SNAPSHOT_FETCH_CHUNK_SIZE = 128;
     DOCUMENT_SNAPSHOT_FETCH_CONCURRENCY = 4;
   }
 });
@@ -129738,12 +129939,10 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
     return await buildPostPushCompileSchema(workspace, status);
   })() : null;
   const bodySourceLocator = createNeoScriptBodySourceLocator(workspace, status);
-  if (compileSchema !== null) {
-    prepareCompleteNeoScriptBodyChanges(workspace, status, compileSchema, {
-      completeSweep: options.forceRecompile === true,
-      bodySourceLocator
-    });
-  }
+  const compileContext = compileSchema === null ? null : prepareCompleteNeoScriptBodyChanges(workspace, status, compileSchema, {
+    completeSweep: options.forceRecompile === true,
+    bodySourceLocator
+  });
   const now = Date.now();
   for (const change of status.changes) {
     if (change.nextData === void 0) continue;
@@ -129751,26 +129950,12 @@ ${blockingErrors.map((error) => `  ${error.message}`).join("\n")}`
       change.nextData = {
         ...change.nextData,
         action: compileMigrationAction(
-          compileSchema,
+          compileContext,
           change.nextData,
           bodySourceLocator
         )
       };
     }
-    if (change.recordKind === "member" && change.nextData.kind === 10) {
-      change.nextData = compileNSPropertyChange(
-        compileSchema,
-        change.nextData,
-        bodySourceLocator
-      );
-    }
-    if (change.recordKind === "member" && change.nextData.kind === 23) {
-      change.nextData = compileNSFunctionChange(
-        compileSchema,
-        change.nextData,
-        bodySourceLocator
-      );
-    }
     if (change.kind === "create") {
       change.nextData = {
         ...change.nextData,
@@ -131609,8 +131794,8 @@ async function buildPostPushCompileSchema(workspace, status) {
     variantFolders: [...bucket("variant-folder").values()]
   };
 }
-function postPushCompilerProject(schema) {
-  return {
+function createPostPushCompileContext(schema) {
+  const project = {
     project: schema.project,
     projectFiles: schema.projectFiles,
     members: schema.members,
@@ -131621,24 +131806,50 @@ function postPushCompilerProject(schema) {
     variants: schema.variants,
     variantFolders: schema.variantFolders
   };
+  const membersById = /* @__PURE__ */ new Map();
+  const classesById = /* @__PURE__ */ new Map();
+  const ownersByMemberId = /* @__PURE__ */ new Map();
+  for (const member of schema.members) {
+    if (typeof member.id !== "string") continue;
+    if (!membersById.has(member.id)) membersById.set(member.id, member);
+  }
+  for (const schemaClass2 of schema.classes) {
+    if (typeof schemaClass2.id === "string" && !classesById.has(schemaClass2.id)) {
+      classesById.set(schemaClass2.id, schemaClass2);
+    }
+    if (!isObjectRecord2(schemaClass2.schema)) continue;
+    for (const memberId of Object.values(schemaClass2.schema)) {
+      if (typeof memberId !== "string") continue;
+      if (!ownersByMemberId.has(memberId))
+        ownersByMemberId.set(memberId, schemaClass2);
+    }
+  }
+  let compilationProject;
+  return {
+    membersById,
+    classesById,
+    ownersByMemberId,
+    project() {
+      compilationProject ??= createNeoScriptCompilationProject2(project);
+      return { ...project, compilationProject };
+    }
+  };
 }
-function containingClass(schema, memberId) {
-  return schema.classes.find((schemaClass2) => {
-    const classSchema = schemaClass2.schema;
-    return isObjectRecord2(classSchema) && Object.values(classSchema).includes(memberId);
-  }) ?? null;
+function containingClass(context, memberId) {
+  if (typeof memberId !== "string") return null;
+  return context.ownersByMemberId.get(memberId) ?? null;
 }
 function bodyOwnerName(thisClass) {
   if (thisClass === null) return null;
   if (typeof thisClass.name !== "string") return null;
   return thisClass.name;
 }
-function compileNSPropertyChange(schema, memberData, locator) {
+function compileNSPropertyChange(context, memberData, locator) {
   const memberId = memberData.id;
-  const thisClass = containingClass(schema, memberId);
+  const thisClass = containingClass(context, memberId);
   const returnTypeInfo = resolveNSPropertyReturnTypeInfo2(
     memberData,
-    schema.members
+    context.membersById
   );
   const bodyIdentity = {
     recordKind: "member",
@@ -131651,7 +131862,7 @@ function compileNSPropertyChange(schema, memberData, locator) {
     const code = memberData.code;
     next.getter = compileNeoScriptBodyOrThrow(
       () => compileNSGetter2(code, {
-        ...postPushCompilerProject(schema),
+        ...context.project(),
         thisClass,
         returnTypeInfo,
         dialogueContext: null,
@@ -131668,7 +131879,7 @@ function compileNSPropertyChange(schema, memberData, locator) {
     const setterCode = memberData.setterCode;
     next.setter = compileNeoScriptBodyOrThrow(
       () => compileNSSetter2(setterCode, {
-        ...postPushCompilerProject(schema),
+        ...context.project(),
         thisClass,
         valueTypeInfo: returnTypeInfo,
         implicitMemberAccess: true,
@@ -131682,18 +131893,18 @@ function compileNSPropertyChange(schema, memberData, locator) {
   }
   return next;
 }
-function compileNSFunctionChange(schema, memberData, locator) {
+function compileNSFunctionChange(context, memberData, locator) {
   const next = { ...memberData };
   if (typeof memberData.code !== "string") {
     delete next.action;
     return next;
   }
   const code = memberData.code;
-  const contract = resolveNSFunctionContract(memberData, schema.members);
-  const thisClass = containingClass(schema, memberData.id);
+  const contract = resolveNSFunctionContract(memberData, context.membersById);
+  const thisClass = containingClass(context, memberData.id);
   next.action = compileNeoScriptBodyOrThrow(
     () => compileNSFunction2(code, {
-      ...postPushCompilerProject(schema),
+      ...context.project(),
       thisClass,
       returnTypeInfo: contract.returnTypeInfo,
       argumentTypes: contract.argumentTypes,
@@ -131716,6 +131927,7 @@ function compileNSFunctionChange(schema, memberData, locator) {
 }
 function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options = {}) {
   const completeSweep = options.completeSweep ?? false;
+  const context = createPostPushCompileContext(schema);
   const locator = options.bodySourceLocator ?? createNeoScriptBodySourceLocator(workspace, status);
   const changesById = new Map(
     status.changes.filter((change) => change.recordKind === "member").map((change) => [change.recordId, change])
@@ -131726,10 +131938,10 @@ function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options
       return member;
     }
     if (member.kind === 10 /* NSProperty */) {
-      return compileNSPropertyChange(schema, member, locator);
+      return compileNSPropertyChange(context, member, locator);
     }
     if (member.kind === 23 /* NSFunction */) {
-      return compileNSFunctionChange(schema, member, locator);
+      return compileNSFunctionChange(context, member, locator);
     }
     return member;
   });
@@ -131779,6 +131991,7 @@ function prepareCompleteNeoScriptBodyChanges(workspace, status, schema, options
     status.changes.push(cascadeChange);
     changesById.set(compiled.id, cascadeChange);
   }
+  return context;
 }
 function mergeCompiledNeoScriptBody(persisted, compiled) {
   const next = { ...persisted };
@@ -131975,7 +132188,7 @@ function resolveNSPropertyReturnTypeInfo2(member, members) {
       );
     }
     visited.add(parentId);
-    current = members.find((candidate) => candidate.id === parentId);
+    current = members.get(parentId);
   }
   throw new Error(
     `Cannot compile NeoScript property "${String(member.id)}": its returnTypeInfo could not be resolved from the base chain.`
@@ -132002,7 +132215,7 @@ function resolveNSFunctionContract(member, members) {
       );
     }
     visited.add(parentId);
-    current = members.find((candidate) => candidate.id === parentId);
+    current = members.get(parentId);
     if (current === void 0) {
       throw new Error(
         `Cannot compile NeoScript function "${String(member.id)}": missing parent member "${parentId}".`
@@ -132020,15 +132233,13 @@ function resolveNSFunctionContract(member, members) {
     deferred: dispatch === 1
   };
 }
-function compileMigrationAction(schema, migrationData, locator) {
+function compileMigrationAction(context, migrationData, locator) {
   const targetClassId = migrationData.targetClassId;
-  const thisClass = typeof targetClassId === "string" ? schema.classes.find(
-    (schemaClass2) => schemaClass2.id === targetClassId
-  ) ?? null : null;
+  const thisClass = typeof targetClassId === "string" ? context.classesById.get(targetClassId) ?? null : null;
   const code = String(migrationData.code);
   return compileNeoScriptBodyOrThrow(
     () => compileNSVoidBody2(code, {
-      ...postPushCompilerProject(schema),
+      ...context.project(),
       thisClass,
       dialogueContext: null,
       migrationContext: true
@@ -132044,7 +132255,7 @@ function compileMigrationAction(schema, migrationData, locator) {
     locator
   );
 }
-var compileNSVoidBody2, compileNSFunction2, compileNSGetter2, compileNSSetter2, ProjectTransactionInterruptedError, ProjectTransactionFailedError, PROJECT_TRANSACTION_POLL_DELAYS_MS, LocalCandidateArtifactError, SERVER_MINTED_PUSH_RECORD_KINDS;
+var compileNSVoidBody2, compileNSFunction2, compileNSGetter2, compileNSSetter2, createNeoScriptCompilationProject2, ProjectTransactionInterruptedError, ProjectTransactionFailedError, PROJECT_TRANSACTION_POLL_DELAYS_MS, LocalCandidateArtifactError, SERVER_MINTED_PUSH_RECORD_KINDS;
 var init_push = __esm({
   "src/commands/push.ts"() {
     "use strict";
@@ -132090,7 +132301,8 @@ var init_push = __esm({
       compileNSVoidBody: compileNSVoidBody2,
       compileNSFunction: compileNSFunction2,
       compileNSGetter: compileNSGetter2,
-      compileNSSetter: compileNSSetter2
+      compileNSSetter: compileNSSetter2,
+      createNeoScriptCompilationProject: createNeoScriptCompilationProject2
     } = compiler_adapter_exports);
     ProjectTransactionInterruptedError = class extends Error {
       constructor(transactionId) {
@@ -132140,7 +132352,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.50.0",
+      cliVersion: "0.50.1",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -139190,7 +139402,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.50.0");
+    console.log("0.50.1");
     return;
   }
   if (args.command === null || args.command === "help" || args.command === "--help" || args.command === "-h") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.50.0",
+  "version": "0.50.1",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",

package/skills/neocompose-cli/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   `@neocompose/cli` or `node cli/bin/neo.mjs` in the neo-compose repository.
 ---
 
-<!-- reviewed-through-cli: 0.50.0 -->
+<!-- reviewed-through-cli: 0.50.1 -->
 
 # Neo Compose CLI
 

package/skills/neocompose-cli/references/cli-development.md

@@ -88,7 +88,7 @@ wrappers.
 The marker near the top of `SKILL.md` must exactly match the package version:
 
 ```html
-<!-- reviewed-through-cli: 0.50.0 -->
+<!-- reviewed-through-cli: 0.50.1 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale

package/skills/neocompose-cli/references/commands-and-sync.md

@@ -61,6 +61,10 @@ bodies affected by changed declarations. Use `--force-recompile` with either a
 dry run or a real push only when diagnosing stale derived IR: it retains the
 exhaustive project-wide body sweep and is intentionally slower.
 
+Changed member bodies and migration bodies share one schema projection and its
+indexes throughout push preparation. Each changed member body is compiled once,
+so a batch of scripted changes does not rebuild the whole schema for every body.
+
 Interactive status, diff, pull, and test commands report workspace loading and
 preparation phases. Spinners continue animating during synchronous compilation;
 `NO_COLOR` removes color without stopping the animation. JSON reporters and