@neocompose/cli 0.53.4 → 0.53.7

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.53.7] - 2026-09-22
+
+- Adding a value under a row that stores packed children, such as a new list on an item whose sprite is packed, keeps those children readable in `neo test`, `neo status`, and `neo push --dry-run`. A constructed instance replayed from that row used to receive the child's id instead of its value and fail with "NSFunction argument 1 does not match its declared runtime type."
+- Editing a function's or property's source drops its stale compiled body before local verification. Changing a function's parameters while keeping its `@id` no longer fails with 'Convex project document field "members" has an invalid shape'.
+
+## [0.53.6] - 2026-09-19
+
+- Full project reads, including initial pulls and resyncs, fetch published snapshots directly in bounded pages, reducing Convex requests and duplicate database reads. Normal incremental pulls keep their existing delta transport.
+
+## [0.53.5] - 2026-09-19
+
+- `neo test` and `neo push --dry-run` compile pending member initializers and their newly authored callable dependencies when a deletion replays a surviving constructed instance. Adding a computed default and deleting an owned row in one push no longer fails with "has no compiled body".
+- Clearing a stored list, dictionary, or nested object override, or resetting a scalar to its declared default, preserves its stored binding during source verification. `neo test` and `neo push --dry-run` no longer reject these edits as omitted parent changes.
+
 ## [0.53.4] - 2026-09-19
 
 - `neo test` preserves runtime types and getter overrides for nested save objects after writes rebuild the evaluator ownership index. Virtual children reuse their known owning graph when no stored parent link exists.

package/dist/neo.mjs

@@ -38465,16 +38465,26 @@ function composeDocumentRecord(recordKind, recordId, authoredFields, baseRecord)
     }
     assertKnownDocumentFields(recordKind, baseRecord.data);
     const base = partitionDocumentFields(recordKind, baseRecord.data);
-    const invalidatesDerivedConstructor = recordKind === "constructor" && !schemaDocumentAuthoredSemanticallyEqual(
+    const derived = Object.entries(base.derived);
+    const authoredEdited = derived.length > 0 && !schemaDocumentAuthoredSemanticallyEqual(
       recordKind,
       baseRecord.data,
       normalizedAuthored
     );
-    if (!invalidatesDerivedConstructor) Object.assign(data, base.derived);
+    for (const [field, value] of derived) {
+      if (authoredEdited && compiledFromAuthoredBody(recordKind, field)) {
+        continue;
+      }
+      data[field] = value;
+    }
     Object.assign(data, base.volatile);
   }
   return { recordKind, recordId, data };
 }
+function compiledFromAuthoredBody(recordKind, field) {
+  if (recordKind === "constructor") return true;
+  return recordKind === "member" && field !== "valueId";
+}
 function assertOnlyAuthoredFields(recordKind, fields) {
   for (const field of Object.keys(fields)) {
     const disposition = fieldDisposition(recordKind, field);
@@ -85700,6 +85710,171 @@ var init_init_source = __esm({
   }
 });
 
+// ../src/database/document-initializer-compiler.ts
+function initializerCompilerState(document, compilationProject) {
+  const existing = documentInitializerCompilerStates.get(document);
+  if (existing !== void 0) {
+    if (compilationProject !== void 0) {
+      existing.compilationProject = compilationProject;
+    }
+    return existing;
+  }
+  const created = {
+    compilationProject: compilationProject ?? null
+  };
+  documentInitializerCompilerStates.set(document, created);
+  return created;
+}
+function compilationProjectForDocument(document, state) {
+  state.compilationProject ??= createNeoScriptCompilationProject({
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? []
+  });
+  return state.compilationProject;
+}
+function documentMemberCompilationIndex(document) {
+  const existing = documentMemberCompilationIndexes.get(document);
+  if (existing !== void 0) return existing;
+  const created = {
+    membersById: new Map(
+      document.members.map((member) => [member.id, member])
+    ),
+    ownerClassesByMemberId: new Map(
+      document.classes.flatMap(
+        (schemaClass2) => Object.values(schemaClass2.schema).map(
+          (memberId) => [memberId, schemaClass2]
+        )
+      )
+    )
+  };
+  documentMemberCompilationIndexes.set(document, created);
+  return created;
+}
+function documentInitializerCompiler(document, compilationProject) {
+  const state = initializerCompilerState(document, compilationProject);
+  return (site) => {
+    if (site.sourceValueId !== null) {
+      compileValueInitializerDependency(
+        document,
+        site.sourceValueId,
+        compilationProjectForDocument(document, state)
+      );
+      return;
+    }
+    if (site.memberId === null) return;
+    compileMemberInitializerDependency(
+      document,
+      site.memberId,
+      compilationProjectForDocument(document, state)
+    );
+  };
+}
+function valueInitializerCompilationSites(document) {
+  const cached = documentValueInitializerCompilationSites.get(document);
+  if (cached !== void 0) return cached;
+  const rows = document.values.filter(isInitValueContent);
+  const valuesById = new Map(
+    document.values.map((value) => [value.id, value])
+  );
+  const ownershipTargetIds = valueIdsWithSourceChains(
+    new Set(rows.map((row) => row.id)),
+    valuesById
+  );
+  const rootOwners = /* @__PURE__ */ new Map();
+  const owners = resolveOwnerMembersForValues(
+    document,
+    ownershipTargetIds,
+    void 0,
+    rootOwners
+  );
+  const sites = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    const member = owners.get(row.id);
+    if (member === void 0) continue;
+    const ownerContext = initializerOwnerContext(
+      document,
+      row.id,
+      rootOwners,
+      valuesById
+    );
+    sites.set(row.id, {
+      row,
+      member,
+      ownerClass: ownerContext.ownerClass,
+      lexicalThisClass: ownerContext.lexicalThisClass
+    });
+  }
+  documentValueInitializerCompilationSites.set(document, sites);
+  return sites;
+}
+function compileValueInitializerDependency(document, valueId, compilationProject) {
+  const site = valueInitializerCompilationSites(document).get(valueId);
+  if (site === void 0) {
+    throw new Error(
+      "Cannot compile initializer dependency because its source value row is unresolved."
+    );
+  }
+  compileValueRowInitializerBody({
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? [],
+    member: site.member,
+    valueRow: { ...site.row },
+    valueId: site.row.id,
+    initializerOwnerClass: site.ownerClass,
+    lexicalThisClass: site.lexicalThisClass,
+    storedConstructionReplay: true,
+    ...compilationProject === void 0 ? {} : { compilationProject }
+  });
+}
+function compileMemberInitializerDependency(document, memberId, compilationProject) {
+  const compileArgs = {
+    project: document.project,
+    projectFiles: document.projectFiles,
+    members: document.members,
+    classes: document.classes,
+    enums: document.enums,
+    interfaces: document.interfaces,
+    constructors: document.constructors ?? []
+  };
+  const memberIndex = documentMemberCompilationIndex(document);
+  const member = memberIndex.membersById.get(memberId);
+  if (member === void 0) {
+    throw new Error(
+      `Cannot compile initializer dependency for missing member "${memberId}".`
+    );
+  }
+  const thisClass = memberIndex.ownerClassesByMemberId.get(memberId) ?? null;
+  compileMemberInitializerBody({
+    ...compileArgs,
+    member,
+    thisClass,
+    ...compilationProject === void 0 ? {} : { compilationProject }
+  });
+}
+var documentInitializerCompilerStates, documentMemberCompilationIndexes, documentValueInitializerCompilationSites;
+var init_document_initializer_compiler = __esm({
+  "../src/database/document-initializer-compiler.ts"() {
+    "use strict";
+    init_members();
+    init_compile_ns_property();
+    init_compiler_adapter();
+    init_value_row_owner_members();
+    documentInitializerCompilerStates = /* @__PURE__ */ new WeakMap();
+    documentMemberCompilationIndexes = /* @__PURE__ */ new WeakMap();
+    documentValueInitializerCompilationSites = /* @__PURE__ */ new WeakMap();
+  }
+});
+
 // ../src/runtime/materialize-values.ts
 function materializeInitializerValue2(args) {
   return materializeInitializerValue({
@@ -86040,8 +86215,8 @@ __export(project_document_read_exports, {
   readArrayField: () => readArrayField,
   readProjectDocument: () => readProjectDocument,
   readProjectDocumentContentHashHeads: () => readProjectDocumentContentHashHeads,
-  readProjectDocumentManifestPage: () => readProjectDocumentManifestPage,
   readProjectDocumentManifestPageRecords: () => readProjectDocumentManifestPageRecords,
+  readProjectDocumentPage: () => readProjectDocumentPage,
   readProjectDocumentRevisionMarker: () => readProjectDocumentRevisionMarker,
   withStoredValueBase: () => withStoredValueBase
 });
@@ -86059,7 +86234,7 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       "Chunked project document read received an empty partition key."
     );
   }
-  const firstPageResult = await runner.fetchManifestPage(
+  const firstPageResult = await runner.fetchPage(
     {
       numItems: DOCUMENT_MANIFEST_PAGE_SIZE,
       cursor: null
@@ -86067,7 +86242,7 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
     firstMapKey
   );
   if (firstPageResult === null) return null;
-  const firstPage = readProjectDocumentManifestPage(firstPageResult);
+  const firstPage = readProjectDocumentPage(firstPageResult);
   if (firstPage.metadata === null) {
     throw new Error(
       "Convex project document manifest first page is missing version metadata."
@@ -86079,18 +86254,20 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
   const snapshots = createProjectDocumentSnapshotLoader(
     (ids) => fetchScopedSnapshotBatch(runner, ids, readBase)
   );
-  const rememberRecords = async (records2) => {
+  const rememberRecords = async (page) => {
+    if (page.snapshots !== void 0) snapshots.seed(page.snapshots);
+    const records2 = page.records;
     for (const record6 of records2) {
       recordsByKey.set(`${record6.recordKind} ${record6.recordId}`, record6);
     }
     await snapshots.enqueue(records2.map((record6) => record6.snapshotId));
   };
   try {
-    await rememberRecords(firstPage.records);
+    await rememberRecords(firstPage);
     const fetchRemainingPages = async (mapKey, initialCursor) => {
       let cursor = initialCursor;
       while (cursor !== null) {
-        const pageResult = await runner.fetchManifestPage(
+        const pageResult = await runner.fetchPage(
           {
             numItems: DOCUMENT_MANIFEST_PAGE_SIZE,
             cursor
@@ -86103,15 +86280,15 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
             "Convex project document manifest returned null for a continuation page."
           );
         }
-        const page = readProjectDocumentManifestPage(pageResult);
+        const page = readProjectDocumentPage(pageResult);
         assertProjectReadBase(readBase, page.readBase);
-        await rememberRecords(page.records);
+        await rememberRecords(page);
         cursor = page.continueCursor;
       }
     };
     await fetchRemainingPages(firstMapKey, firstPage.continueCursor);
     for (const mapKey of mapKeys.slice(1)) {
-      const pageResult = await runner.fetchManifestPage(
+      const pageResult = await runner.fetchPage(
         { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor: null },
         mapKey,
         readBase,
@@ -86122,9 +86299,9 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
           `Convex project document manifest returned null for partition "${mapKey ?? "all"}".`
         );
       }
-      const page = readProjectDocumentManifestPage(pageResult);
+      const page = readProjectDocumentPage(pageResult);
       assertProjectReadBase(readBase, page.readBase);
-      await rememberRecords(page.records);
+      await rememberRecords(page);
       await fetchRemainingPages(mapKey, page.continueCursor);
     }
     const snapshotsById = await snapshots.finish();
@@ -86155,7 +86332,8 @@ async function fetchProjectDocumentRawChunkedOnce(runner, options = {}) {
       }
     }
     const records2 = [...recordsByKey.values()];
-    await runner.validateReadBase(readBase);
+    if (options.revisionValidation !== "live-subscription")
+      await runner.validateReadBase(readBase);
     return assembleProjectDocumentRaw({
       version: metadata.version,
       versions: metadata.versions,
@@ -86187,7 +86365,7 @@ async function fetchProjectDocumentPartitionRecords(runner, mapKey, readBase) {
   try {
     let cursor = null;
     do {
-      const pageResult = await runner.fetchManifestPage(
+      const pageResult = await runner.fetchPage(
         { numItems: DOCUMENT_MANIFEST_PAGE_SIZE, cursor },
         mapKey,
         readBase,
@@ -86198,11 +86376,12 @@ async function fetchProjectDocumentPartitionRecords(runner, mapKey, readBase) {
           `Convex project document manifest returned null for partition "${mapKey}".`
         );
       }
-      const page = readProjectDocumentManifestPage(pageResult);
+      const page = readProjectDocumentPage(pageResult);
       assertProjectReadBase(readBase, page.readBase);
       for (const record6 of page.records) {
         recordsByKey.set(`${record6.recordKind} ${record6.recordId}`, record6);
       }
+      if (page.snapshots !== void 0) snapshots.seed(page.snapshots);
       await snapshots.enqueue(page.records.map((record6) => record6.snapshotId));
       cursor = page.continueCursor;
     } while (cursor !== null);
@@ -86228,42 +86407,30 @@ async function fetchProjectDocumentPartitionRecords(runner, mapKey, readBase) {
   }
 }
 async function fetchProjectDocumentValueRecords(runner, valueIds, readBase) {
-  if (runner.fetchValueHeadsPage === void 0) {
+  if (runner.fetchValueSnapshotsPage === void 0) {
     throw new Error(
-      "Partition-scoped document reads require a value-head reader for member defaults."
+      "Partition-scoped document reads require a value-snapshot reader for member defaults."
     );
   }
   const values = /* @__PURE__ */ new Map();
   let cursor = null;
   do {
-    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(
-        "Value-head page snapshotIds must be an array of strings."
-      );
-    if (page.continueCursor !== null && typeof page.continueCursor !== "string")
-      throw new Error(
-        "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()) {
+    const page = readProjectDocumentPage(
+      await runner.fetchValueSnapshotsPage(valueIds, cursor, readBase)
+    );
+    assertProjectReadBase(readBase, page.readBase);
+    if (page.snapshots === void 0)
+      throw new Error("Value snapshot page is missing snapshots.");
+    if (page.continueCursor !== null && page.continueCursor === cursor)
+      throw new Error("Value snapshot page cursor made no progress.");
+    for (const snapshot of page.snapshots) {
       if (snapshot.recordKind !== "value")
-        throw new Error("Value-head page returned a non-value snapshot.");
+        throw new Error("Value snapshot page returned a non-value snapshot.");
       if (snapshot.deleted)
-        throw new Error("Value-head page returned a deleted snapshot.");
+        throw new Error("Value snapshot page returned a deleted snapshot.");
       if (!valueIds.includes(snapshot.recordId))
         throw new Error(
-          `Value-head page returned unrequested value "${snapshot.recordId}".`
+          `Value snapshot page returned unrequested value "${snapshot.recordId}".`
         );
       values.set(snapshot.recordId, snapshot);
     }
@@ -86281,10 +86448,23 @@ async function fetchScopedSnapshotBatch(runner, ids, readBase) {
   assertProjectReadBase(readBase, readProjectReadBase(result.readBase));
   return result;
 }
-function readProjectDocumentManifestPage(value) {
+function readProjectDocumentPage(value) {
   if (!isObject4(value)) {
     throw new Error("Convex project document manifest page must be an object.");
   }
+  let snapshots;
+  if (value.snapshots !== void 0) {
+    if (!Array.isArray(value.snapshots))
+      throw new Error("Snapshot page snapshots must be an array.");
+    const ids = value.snapshots.map((snapshot) => {
+      if (!isObject4(snapshot))
+        throw new Error("Snapshot page entry must be an object.");
+      if (typeof snapshot.id !== "string")
+        throw new Error("Snapshot page entry is missing an id.");
+      return snapshot.id;
+    });
+    snapshots = ids.length === 0 ? [] : readProjectDocumentSnapshotBatch(value, ids);
+  }
   const continueCursor = value.continueCursor;
   if (continueCursor !== null && typeof continueCursor !== "string") {
     throw new Error(
@@ -86307,7 +86487,12 @@ function readProjectDocumentManifestPage(value) {
       releaseChannels: metadata.releaseChannels,
       documentRevision: metadata.documentRevision
     },
-    records: readProjectDocumentManifestRecords(value.records),
+    ...snapshots === void 0 ? {} : { snapshots },
+    records: snapshots === void 0 ? readProjectDocumentManifestRecords(value.records) : snapshots.map((snapshot) => ({
+      recordKind: snapshot.recordKind,
+      recordId: snapshot.recordId,
+      snapshotId: snapshot.id
+    })),
     continueCursor
   };
 }
@@ -86355,7 +86540,7 @@ function readProjectDocumentManifestPageRecords(value) {
   if (!isObject4(value)) {
     throw new Error("Convex project document manifest page must be an object.");
   }
-  return readProjectDocumentManifestRecords(value.records);
+  return readProjectDocumentPage(value).records;
 }
 async function fetchProjectDocumentSnapshots(fetchBatch, snapshotIds) {
   const loader = createProjectDocumentSnapshotLoader(fetchBatch);
@@ -86401,6 +86586,12 @@ function createProjectDocumentSnapshotLoader(fetchBatch) {
     active.add(work);
   };
   return {
+    seed(snapshots) {
+      for (const snapshot of snapshots) {
+        seen.add(snapshot.id);
+        snapshotsById.set(snapshot.id, snapshot);
+      }
+    },
     async enqueue(snapshotIds) {
       checkFailure();
       for (const id2 of snapshotIds) {
@@ -96596,9 +96787,42 @@ function appendAuthoredOwnedValueCascadeDeletes(args) {
     }
   }
   if (survivingConstructionIds.size > 0) {
+    const replayMembers = documentMemberCompilationIndex(postScope.document);
+    const replayConstructors = indexRecordsById(
+      postScope.document.constructors ?? []
+    );
+    let compilationProject;
+    for (const change of args.authoredChanges) {
+      if (change.operation === "delete") continue;
+      const member = change.recordKind === "member" ? replayMembers.membersById.get(change.recordId) : void 0;
+      const constructor2 = change.recordKind === "constructor" ? replayConstructors.get(change.recordId) : void 0;
+      const callable2 = member !== void 0 && (member.kind === 23 /* NSFunction */ || member.kind === 10 /* NSProperty */ || member.kind === 26 /* NSAction */);
+      if (constructor2 === void 0 && !callable2) continue;
+      compilationProject ??= cachedServerCompilationProject(postScope.document);
+      const compileArgs = { ...postScope.document, compilationProject };
+      if (constructor2 !== void 0)
+        compileConstructorRecord({
+          ...compileArgs,
+          constructors: postScope.document.constructors ?? [],
+          constructor: constructor2
+        });
+      if (callable2)
+        compileAuthoredMemberBodies({
+          ...compileArgs,
+          member,
+          thisClass: replayMembers.ownerClassesByMemberId.get(member.id) ?? null
+        });
+    }
+    const replayDocument = {
+      ...postScope.document,
+      initializerCompiler: documentInitializerCompiler(
+        postScope.document,
+        compilationProject
+      )
+    };
     const resolverDocument = composeResolverDocument(
-      postScope.document,
-      initializerEvaluatorLookups(postScope.document)
+      replayDocument,
+      initializerEvaluatorLookups(replayDocument)
     );
     const materializedIndex = buildVirtualInstanceMaterializedIndex({
       document: resolverDocument
@@ -100831,6 +101055,7 @@ var SERVER_COMPILATION_PROJECT_CACHE_LIMIT, serverCompilationProjectCache, READ_
 var init_project_version_schema_commit = __esm({
   "../src/database/project-version-schema-commit.ts"() {
     "use strict";
+    init_document_initializer_compiler();
     init_effective_value_comparison();
     init_classes();
     init_constructor_parameter_settlement();
@@ -114574,7 +114799,7 @@ var init_stored_value_placements = __esm({
 });
 
 // src/project-source/root-source.ts
-function emitProjectRootSourceV4(records2, manifest, materializedConstructors, localValues) {
+function emitProjectRootSourceV4(records2, manifest, materializedConstructors, localValues, options = {}) {
   const project = [...records2.values()].find(
     (record6) => !record6.deleted && record6.recordKind === "project"
   );
@@ -114586,6 +114811,7 @@ function emitProjectRootSourceV4(records2, manifest, materializedConstructors, l
   );
   const classes = new Map(manifest.classes.map((entry) => [entry.id, entry]));
   const values = emitStoredValueBindingSourcesV4(records2, memberIds, {
+    ...options,
     manifest,
     targetTypedRoot: true,
     localValues
@@ -115159,7 +115385,7 @@ function cliEvaluatorLookups(document, options = {}) {
   return cliEvaluatorRuntime(document, options).databaseVM;
 }
 function cliEvaluatorRuntime(document, options = {}) {
-  const initializerCompiler = isPulledInitializerCompilationDocumentV4(document) ? pulledInitializerCompilerV4(document) : void 0;
+  const initializerCompiler = isPulledInitializerCompilationDocumentV4(document) ? documentInitializerCompiler(document) : void 0;
   const databaseVM = headlessVirtualInstanceLookups(document, {
     ...options,
     ...initializerCompiler === void 0 ? {} : { initializerCompiler }
@@ -115845,36 +116071,59 @@ function prospectiveInitializerRecordsV4(args) {
   }
   for (const seed of args.authoredValueSeeds) {
     if (seed.valueId === void 0) continue;
-    records2.set(`value:${seed.valueId}`, {
-      recordKind: "value",
-      recordId: seed.valueId,
-      contentHash: "local-seed",
-      deleted: false,
-      data: {
-        id: seed.valueId,
+    setSeedValueRecord(records2, {
+      id: seed.valueId,
+      projectId: args.workspace.config.projectId,
+      ...encodeStoredValueNode(seed),
+      createdAt: 0,
+      updatedAt: 0
+    });
+    for (const row of seed.values ?? []) {
+      setSeedValueRecord(records2, {
+        id: row.id,
         projectId: args.workspace.config.projectId,
-        ...encodeStoredValueNode(seed),
+        ...encodeStoredValueRowFields(row),
         createdAt: 0,
         updatedAt: 0
-      }
-    });
-    for (const row of seed.values ?? []) {
-      records2.set(`value:${row.id}`, {
+      });
+    }
+  }
+  return records2;
+}
+function setSeedValueRecord(records2, data) {
+  const key = `value:${data.id}`;
+  const physical = records2.get(key)?.data;
+  if (isObjectRecord2(physical) && rowCarriesPackedValueContent(physical)) {
+    const row = {
+      projectId: data.projectId,
+      createdAt: 0,
+      updatedAt: 0,
+      ...physical
+    };
+    if (!isMemberValue(row)) {
+      throw new PackedValueEncodingError(
+        `Seeded row "${key}" replaces a row that packs a child but is not a well-formed value row, so its packed children cannot be kept.`
+      );
+    }
+    for (const child of decodePackedValueRow(row).children) {
+      const childKey = `value:${child.id}`;
+      if (records2.has(childKey)) continue;
+      records2.set(childKey, {
         recordKind: "value",
-        recordId: row.id,
+        recordId: child.id,
         contentHash: "local-seed",
         deleted: false,
-        data: {
-          id: row.id,
-          projectId: args.workspace.config.projectId,
-          ...encodeStoredValueRowFields(row),
-          createdAt: 0,
-          updatedAt: 0
-        }
+        data: child
       });
     }
   }
-  return records2;
+  records2.set(key, {
+    recordKind: "value",
+    recordId: data.id,
+    contentHash: "local-seed",
+    deleted: false,
+    data
+  });
 }
 function initializerCode(records2, valueId) {
   const row = records2.get(`value:${valueId}`)?.data;
@@ -117245,7 +117494,7 @@ function collapseLocalizedSourceRevertsV4(args) {
     document: comparison,
     changes: normalized,
     editedValueIds: new Set(edited.map((change) => change.recordId)),
-    initializerCompiler: pulledInitializerCompilerV4(comparison)
+    initializerCompiler: documentInitializerCompiler(comparison)
   });
   const normalizedById = new Map(
     normalized.map((change) => [change.recordId, change])
@@ -119031,69 +119280,6 @@ function createPulledConstructionReplayContext(args) {
     valuesById: new Map(args.document.values.map((value) => [value.id, value]))
   };
 }
-function pulledInitializerCompilerStateV4(document, compilationProject) {
-  const existing = pulledInitializerCompilerStates.get(document);
-  if (existing !== void 0) {
-    if (compilationProject !== void 0) {
-      existing.compilationProject = compilationProject;
-    }
-    return existing;
-  }
-  const created = {
-    compilationProject: compilationProject ?? null
-  };
-  pulledInitializerCompilerStates.set(document, created);
-  return created;
-}
-function compilationProjectForPulledDocumentV4(document, state) {
-  state.compilationProject ??= createNeoScriptCompilationProject({
-    project: document.project,
-    projectFiles: document.projectFiles,
-    members: document.members,
-    classes: document.classes,
-    enums: document.enums,
-    interfaces: document.interfaces,
-    constructors: document.constructors ?? []
-  });
-  return state.compilationProject;
-}
-function memberCompilationIndexV4(document) {
-  const existing = pulledMemberCompilationIndexes.get(document);
-  if (existing !== void 0) return existing;
-  const created = {
-    membersById: new Map(
-      document.members.map((member) => [member.id, member])
-    ),
-    ownerClassesByMemberId: new Map(
-      document.classes.flatMap(
-        (schemaClass2) => Object.values(schemaClass2.schema).map(
-          (memberId) => [memberId, schemaClass2]
-        )
-      )
-    )
-  };
-  pulledMemberCompilationIndexes.set(document, created);
-  return created;
-}
-function pulledInitializerCompilerV4(document, compilationProject) {
-  const state = pulledInitializerCompilerStateV4(document, compilationProject);
-  return (site) => {
-    if (site.sourceValueId !== null) {
-      compilePulledValueInitializerBodyV4(
-        document,
-        site.sourceValueId,
-        compilationProjectForPulledDocumentV4(document, state)
-      );
-      return;
-    }
-    if (site.memberId === null) return;
-    compilePulledMemberInitializerBodyV4(
-      document,
-      site.memberId,
-      compilationProjectForPulledDocumentV4(document, state)
-    );
-  };
-}
 function describePulledProjectBodyCompileError(error) {
   const fallback = error instanceof Error ? error.message : String(error);
   if (!(error instanceof CompileError)) return fallback;
@@ -119210,7 +119396,7 @@ function replayStoredConstructionV4(args) {
       // Replays need distinct compiler closures but read one immutable
       // member/value graph. Share its project-sized evaluator indexes.
       evaluatorCache: { key: document, revision: void 0 },
-      initializerCompiler: pulledInitializerCompilerV4(
+      initializerCompiler: documentInitializerCompiler(
         document,
         compilationProject
       )
@@ -119264,68 +119450,6 @@ function compilePulledUncompiledConstructorsV4(document, compilationProject, rep
   }
   assertPulledConstructorsCompiled(document, replayContext);
 }
-function valueInitializerCompilationSites(document) {
-  const cached = pulledValueInitializerCompilationSites.get(document);
-  if (cached !== void 0) return cached;
-  const rows = document.values.filter(isInitValueContent);
-  const valuesById = new Map(
-    document.values.map((value) => [value.id, value])
-  );
-  const ownershipTargetIds = valueIdsWithSourceChains(
-    new Set(rows.map((row) => row.id)),
-    valuesById
-  );
-  const rootOwners = /* @__PURE__ */ new Map();
-  const owners = resolveOwnerMembersForValues(
-    document,
-    ownershipTargetIds,
-    void 0,
-    rootOwners
-  );
-  const sites = /* @__PURE__ */ new Map();
-  for (const row of rows) {
-    const member = owners.get(row.id);
-    if (member === void 0) continue;
-    const ownerContext = initializerOwnerContext(
-      document,
-      row.id,
-      rootOwners,
-      valuesById
-    );
-    sites.set(row.id, {
-      row,
-      member,
-      ownerClass: ownerContext.ownerClass,
-      lexicalThisClass: ownerContext.lexicalThisClass
-    });
-  }
-  pulledValueInitializerCompilationSites.set(document, sites);
-  return sites;
-}
-function compilePulledValueInitializerBodyV4(document, valueId, compilationProject) {
-  const site = valueInitializerCompilationSites(document).get(valueId);
-  if (site === void 0) {
-    throw new Error(
-      "Cannot compile initializer dependency because its source value row is unresolved."
-    );
-  }
-  compileValueRowInitializerBody({
-    project: document.project,
-    projectFiles: document.projectFiles,
-    members: document.members,
-    classes: document.classes,
-    enums: document.enums,
-    interfaces: document.interfaces,
-    constructors: document.constructors ?? [],
-    member: site.member,
-    valueRow: site.row,
-    valueId: String(Reflect.get(site.row, "id")),
-    initializerOwnerClass: site.ownerClass,
-    lexicalThisClass: site.lexicalThisClass,
-    storedConstructionReplay: true,
-    ...compilationProject === void 0 ? {} : { compilationProject }
-  });
-}
 function compilePulledProjectDocumentForEvaluationV4(document, compilationProject) {
   const sharedCompilationProject = compilationProject ?? createNeoScriptCompilationProject({
     project: document.project,
@@ -119336,7 +119460,7 @@ function compilePulledProjectDocumentForEvaluationV4(document, compilationProjec
     interfaces: document.interfaces,
     constructors: document.constructors ?? []
   });
-  pulledInitializerCompilerStateV4(document, sharedCompilationProject);
+  documentInitializerCompiler(document, sharedCompilationProject);
   const compileArgs = {
     project: document.project,
     projectFiles: document.projectFiles,
@@ -119351,7 +119475,7 @@ function compilePulledProjectDocumentForEvaluationV4(document, compilationProjec
     compileConstructorRecord({ ...compileArgs, constructor: constructor2 });
   }
   assertPulledConstructorsCompiled(document);
-  const memberIndex = memberCompilationIndexV4(document);
+  const memberIndex = documentMemberCompilationIndex(document);
   for (const member of compileArgs.members) {
     try {
       compileAuthoredMemberBodies({
@@ -119387,31 +119511,6 @@ function assertPulledConstructorsCompiled(document, replayContext) {
   }
   if (replayContext !== void 0) replayContext.constructorsValidated = true;
 }
-function compilePulledMemberInitializerBodyV4(document, memberId, compilationProject) {
-  const compileArgs = {
-    project: document.project,
-    projectFiles: document.projectFiles,
-    members: document.members,
-    classes: document.classes,
-    enums: document.enums,
-    interfaces: document.interfaces,
-    constructors: document.constructors ?? []
-  };
-  const memberIndex = memberCompilationIndexV4(document);
-  const member = memberIndex.membersById.get(memberId);
-  if (member === void 0) {
-    throw new Error(
-      `Cannot compile initializer dependency for missing member "${memberId}".`
-    );
-  }
-  const thisClass = memberIndex.ownerClassesByMemberId.get(memberId) ?? null;
-  compileMemberInitializerBody({
-    ...compileArgs,
-    member,
-    thisClass,
-    ...compilationProject === void 0 ? {} : { compilationProject }
-  });
-}
 function samePulledRecords(left, right) {
   if (left === right) return true;
   if (left.size !== right.size) return false;
@@ -119549,10 +119648,11 @@ function replayWorkspace(records2) {
     state: { records: stateRecords }
   };
 }
-var pulledBodyCompileSites, pulledInitializerCompilerStates, pulledMemberCompilationIndexes, pulledValueInitializerCompilationSites, recentPulledDocuments, RECENT_PULLED_DOCUMENT_LIMIT;
+var pulledBodyCompileSites, recentPulledDocuments, RECENT_PULLED_DOCUMENT_LIMIT;
 var init_initializer_replay = __esm({
   "src/project-source/initializer-replay.ts"() {
     "use strict";
+    init_document_initializer_compiler();
     init_members();
     init_compile_ns_property();
     init_materialize_values();
@@ -119565,9 +119665,6 @@ var init_initializer_replay = __esm({
     init_constructors2();
     init_compiler_adapter();
     pulledBodyCompileSites = /* @__PURE__ */ new WeakMap();
-    pulledInitializerCompilerStates = /* @__PURE__ */ new WeakMap();
-    pulledMemberCompilationIndexes = /* @__PURE__ */ new WeakMap();
-    pulledValueInitializerCompilationSites = /* @__PURE__ */ new WeakMap();
     recentPulledDocuments = [];
     RECENT_PULLED_DOCUMENT_LIMIT = 4;
   }
@@ -119580,18 +119677,19 @@ function inferredGenericClassBinding(classId) {
 function inferredGenericClassId(binding) {
   return binding?.startsWith(INFERRED_GENERIC_CLASS_PREFIX) ? binding.slice(INFERRED_GENERIC_CLASS_PREFIX.length) : null;
 }
-function emitStaticValueSourcesV4(records2, manifest, localValues) {
+function emitStaticValueSourcesV4(records2, manifest, localValues, options = {}) {
   const memberIds = [];
   for (const record6 of records2.values()) {
     if (record6.recordKind === "member" && !record6.deleted && isObjectRecord2(record6.data) && record6.data.modifier === 3 && typeof record6.data.valueId === "string")
       memberIds.push(record6.recordId);
   }
   return emitStoredValueBindingSourcesV4(records2, memberIds, {
+    ...options,
     manifest,
     localValues
   });
 }
-function buildValueEmitContext(records2, manifest) {
+function buildValueEmitContext(records2, manifest, options = {}) {
   const rawMembers = dataById(records2, "member");
   const manifestMembers = new Map(
     manifest.members.map((member) => [member.id, member])
@@ -119622,6 +119720,7 @@ function buildValueEmitContext(records2, manifest) {
   let materializedGraph;
   let effectiveValues;
   return {
+    storedValueBase: options.storedValueBase,
     records: records2,
     readDocument,
     readCompilationProject,
@@ -119629,7 +119728,7 @@ function buildValueEmitContext(records2, manifest) {
     readEffectiveValues: () => effectiveValues ??= new EffectiveValueReader({
       ...readDocument(),
       evaluatorCache: { key: readDocument(), revision: void 0 },
-      initializerCompiler: pulledInitializerCompilerV4(
+      initializerCompiler: documentInitializerCompiler(
         readDocument(),
         readCompilationProject()
       )
@@ -119685,7 +119784,7 @@ function buildValueEmitContext(records2, manifest) {
 }
 function emitStoredValueBindingSourcesV4(records2, memberIds, options) {
   const context = {
-    ...buildValueEmitContext(records2, options.manifest),
+    ...buildValueEmitContext(records2, options.manifest, options),
     localValues: options.localValues
   };
   const members = context.members;
@@ -119734,13 +119833,13 @@ function targetTypedVariantConstruction(code) {
   if (!prefix.test(code)) return code;
   return code.replace(prefix, "new(");
 }
-function emitVariantValueSourcesV4(records2, manifest) {
+function emitVariantValueSourcesV4(records2, manifest, options = {}) {
   const initializers = /* @__PURE__ */ new Map();
   const recordKeysByVariant = /* @__PURE__ */ new Map();
   if (manifest.variants.length === 0) {
     return { initializers, recordKeysByVariant };
   }
-  const context = buildValueEmitContext(records2, manifest);
+  const context = buildValueEmitContext(records2, manifest, options);
   const variantClass = [...manifest.classes].find(
     (entry) => entry.name === NEO_VARIANT_TYPE_NAME
   );
@@ -120026,8 +120125,8 @@ function rowBackedDefaultMemberIdsV4(state) {
   }
   return result;
 }
-function emitMemberDefaultSourcesV4(records2, manifest) {
-  const context = buildValueEmitContext(records2, manifest);
+function emitMemberDefaultSourcesV4(records2, manifest, options = {}) {
+  const context = buildValueEmitContext(records2, manifest, options);
   const initializers = /* @__PURE__ */ new Map();
   const recordKeysByMember = /* @__PURE__ */ new Map();
   for (const record6 of records2.values()) {
@@ -125339,11 +125438,13 @@ function classValueBody(context, member, value, visited, targetTyped, outerEnvir
     if (childMember === void 0)
       throw new Error(`Class ${name}.${key} has no member record.`);
     const preservesExternalBinding = context.collectionBindingValueIds.has(childId);
-    if (!preservesExternalBinding && emitsAsMemberDefaultDerivedAbsence(context, childMember, childId)) {
+    const baseChildBody = context.storedValueBase?.get(childId)?.value;
+    const clearedStoredClassOverrides = isObjectRecord2(baseChildBody) && Object.keys(baseChildBody).length > 0;
+    if (!preservesExternalBinding && !clearedStoredClassOverrides && emitsAsMemberDefaultDerivedAbsence(context, childMember, childId)) {
       continue;
     }
     const replayChildId = replayBody[key];
-    if (!preservesExternalBinding && replayGraph !== null && typeof replayChildId === "string" && materializedValueSubgraphsEqual(
+    if (!preservesExternalBinding && !context.storedValueBase?.has(childId) && replayGraph !== null && typeof replayChildId === "string" && materializedValueSubgraphsEqual(
       context,
       context.readEffectiveValues(),
       replayGraph,
@@ -127126,9 +127227,14 @@ function emitProjectDocumentFilesV4(records2, options = {}) {
     onInvalidStaticMemberOwnership: (recovery) => staticMemberOwnershipRecoveries.push(recovery)
   });
   const localValues = new LocalValueEmissionV4(options.localValues ?? []);
-  const staticValues = emitStaticValueSourcesV4(records2, manifest, localValues);
-  const memberDefaults = emitMemberDefaultSourcesV4(records2, manifest);
-  const variantValues = emitVariantValueSourcesV4(records2, manifest);
+  const staticValues = emitStaticValueSourcesV4(
+    records2,
+    manifest,
+    localValues,
+    options
+  );
+  const memberDefaults = emitMemberDefaultSourcesV4(records2, manifest, options);
+  const variantValues = emitVariantValueSourcesV4(records2, manifest, options);
   const baseSource = emitProjectSourcesV4(manifest, {
     staticInitializers: staticValues.initializers,
     defaultInitializers: memberDefaults.initializers,
@@ -127198,7 +127304,8 @@ function emitProjectDocumentFilesV4(records2, options = {}) {
     records2,
     manifest,
     materializedConstructors,
-    localValues
+    localValues,
+    options
   );
   const dialogueFiles = emitDialogueProjectSourcesV4(records2);
   const localFiles = localValues.files();
@@ -131995,6 +132102,9 @@ function createPendingProjectSourceIdentityV4(workspace, status, authoredValueSe
   }
   materializePendingSourceLocalization(records2, status);
   const emission = emitProjectDocumentFilesV4(records2, {
+    storedValueBase: storedValueRowsByIdV4(
+      Object.values(workspace.state.records)
+    ),
     recordFiles: projectRecordFilesV4(
       Object.values(workspace.state.records),
       status.reconstructed.values()
@@ -133445,6 +133555,7 @@ var init_push = __esm({
   "src/commands/push.ts"() {
     "use strict";
     init_packed_value_parity();
+    init_stored_value_placements();
     init_push_recovery();
     init_project_version_transaction_result();
     init_performance();
@@ -133556,7 +133667,7 @@ function readRawSingleton(raw, key) {
 async function fetchProjectDocument(workspace) {
   const convex = await createConvexClient(workspace);
   const raw = await fetchProjectDocumentRawChunked2({
-    fetchManifestPage: (paginationOpts, mapKey, readBase) => convex.query(api2.projectDocuments.getDocumentManifestPage, {
+    fetchPage: (paginationOpts, mapKey, readBase) => convex.query(api2.projectDocuments.getDocumentSnapshotPage, {
       projectId: workspace.config.projectId,
       versionId: workspace.config.versionId,
       paginationOpts,
@@ -138725,7 +138836,7 @@ var init_registry2 = __esm({
   "schema-contract/registry.mjs"() {
     "use strict";
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
-      cliVersion: "0.53.4",
+      cliVersion: "0.53.7",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -146546,7 +146657,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.53.4");
+    console.log("0.53.7");
     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.53.4",
+  "version": "0.53.7",
   "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.53.4 -->
+<!-- reviewed-through-cli: 0.53.7 -->
 
 # Neo Compose CLI
 

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

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