@neocompose/cli 0.26.3 → 0.26.4

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.26.4] - 2026-08-10
+
+### Fixed
+
+- Read an omitted nullable member on a newly constructed class as `null`
+  instead of throwing a missing-object-key error. `neo test` can now assert
+  explicit nullable defaults without requiring an otherwise-empty value row.
+- Let local candidate validation resolve an image or audio file created in the
+  same source change. `neo doctor`, `neo test`, and push dry runs now preserve
+  the pending file identity while rehearsing the uploaded project-file row.
+
 ## [0.26.3] - 2026-08-10
 
 ### Changed

package/dist/neo.mjs

@@ -61908,6 +61908,7 @@ function dispatchSchemaMember(receiver, schemaKey, ctx) {
     };
   }
   if (!Object.prototype.hasOwnProperty.call(receiver, schemaKey)) {
+    if (!member.required) return { kind: "ok", value: null };
     return { kind: "no-info", matchedMember: true };
   }
   const at = receiver[schemaKey];
@@ -83278,6 +83279,15 @@ function applyProjectVersionWriteChanges(document, changes) {
       "constructor"
     ),
     values: applyArrayChanges(document.values ?? [], changes, "value"),
+    // Project-file staging finalizes pending uploads before schema
+    // preparation. Defaults and authored instance graphs may reference a file
+    // created by the same source transaction, so every construction pass must
+    // see that finalized row in its post-write document.
+    projectFiles: applyArrayChanges(
+      document.projectFiles ?? [],
+      changes,
+      "project-file"
+    ),
     internalRecordRelations: applyArrayChanges(
       document.internalRecordRelations ?? [],
       changes,
@@ -101055,7 +101065,11 @@ async function prepareLocalPushArtifactsV4(workspace, status, onPhase = () => vo
     );
     preparedChanges = assertServerPreparationSucceeds({
       workspace,
-      changes: transportChanges,
+      changes: completeLocallyStagedProjectFileChanges({
+        projectId: workspace.config.projectId,
+        changes: transportChanges,
+        stagedRecordIds: new Set(preparedFiles.map((file) => file.recordId))
+      }),
       authoredValueSeeds: transportSeeds,
       sourceByRecord: status.reconstructed,
       localInitializerMaterialization: pendingAssignment.localInitializerMaterialization,
@@ -101178,6 +101192,33 @@ async function prepareLocalCandidateV4(workspace, options = {}) {
     preparedLocal
   };
 }
+function completeLocallyStagedProjectFileChanges(args) {
+  return args.changes.map((change) => {
+    if (!args.stagedRecordIds.has(change.recordId)) return change;
+    if (change.recordKind !== "project-file") {
+      throw new Error(
+        `Staged project file ${change.recordId} matched a ${change.recordKind} change.`
+      );
+    }
+    if (!isObjectRecord2(change.nextData)) {
+      throw new Error(
+        `Staged project file ${change.recordId} has no local source record.`
+      );
+    }
+    const completed = {
+      ...change,
+      nextData: {
+        ...change.nextData,
+        id: change.recordId,
+        projectId: args.projectId,
+        status: "uploaded",
+        storageKey: `local-candidate/${change.recordId}`,
+        storageETag: "local-candidate"
+      }
+    };
+    return completed;
+  });
+}
 function transportChangesForStatus(status) {
   return status.changes.map((change) => ({
     recordKind: change.recordKind,
@@ -102632,7 +102673,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.9",
-      cliVersion: "0.26.3",
+      cliVersion: "0.26.4",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -109197,7 +109238,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.26.3");
+    console.log("0.26.4");
     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.26.3",
+  "version": "0.26.4",
   "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.26.3 -->
+<!-- reviewed-through-cli: 0.26.4 -->
 
 # Neo Compose CLI
 

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

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