@neocompose/cli 0.34.1 → 0.34.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.34.2] - 2026-08-19
+
+### Fixed
+
+- Treat unknown top-level document fields with a JSON `null` value as absent
+  while continuing to reject unknown non-null authored data, so harmless fields
+  emitted by an older CLI do not block project commands.
+
 ## [0.34.1] - 2026-08-19
 
 ### Fixed

package/dist/neo.mjs

@@ -35172,8 +35172,9 @@ function fieldDisposition(recordKind, field) {
   return null;
 }
 function assertKnownDocumentFields(recordKind, value) {
-  for (const field of Object.keys(value)) {
+  for (const [field, fieldValue] of Object.entries(value)) {
     if (fieldDisposition(recordKind, field) !== null) continue;
+    if (fieldValue === null) continue;
     throw new SchemaDocumentContractError(recordKind, field);
   }
 }
@@ -35188,6 +35189,7 @@ function partitionDocumentFields(recordKind, value) {
     if (fieldValue === void 0) continue;
     const disposition = fieldDisposition(recordKind, field);
     if (disposition === null) {
+      if (fieldValue === null) continue;
       throw new SchemaDocumentContractError(recordKind, field);
     }
     result[disposition][field] = fieldValue;
@@ -35198,6 +35200,11 @@ function normalizeDocumentFields(recordKind, value) {
   assertKnownDocumentFields(recordKind, value);
   const contract = SCHEMA_DOCUMENT_FIELD_CONTRACTS[recordKind];
   const normalized = deepOmitUndefined(value);
+  for (const [field, fieldValue] of Object.entries(normalized)) {
+    if (fieldValue === null && fieldDisposition(recordKind, field) === null) {
+      delete normalized[field];
+    }
+  }
   for (const [field, rule] of Object.entries(contract.normalization)) {
     const current = normalized[field];
     if (rule === "nullIsAbsent") {
@@ -113174,7 +113181,7 @@ var init_registry2 = __esm({
     PROJECT_SCHEMA_CONTRACT = Object.freeze({
       formatVersion: 3,
       contractVersion: "3.14",
-      cliVersion: "0.34.1",
+      cliVersion: "0.34.2",
       projectFileUploadBatchSize: 32,
       documentRecords: {
         member: {
@@ -119776,7 +119783,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.34.1");
+    console.log("0.34.2");
     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.34.1",
+  "version": "0.34.2",
   "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.34.1 -->
+<!-- reviewed-through-cli: 0.34.2 -->
 
 # Neo Compose CLI
 
@@ -47,8 +47,9 @@ Treat pull followed immediately by status or dry-run as a semantic no-op. If it
 reports project changes, stop and report a round-trip bug instead of pushing.
 
 The compiler reports file:line:column diagnostics and fails closed. Unknown
-authorable server fields require a CLI contract update; never preserve them as
-opaque JSON or guessed syntax.
+non-null authorable server fields require a CLI contract update; never preserve
+them as opaque JSON or guessed syntax. An unknown top-level document field whose
+value is exactly JSON `null` is treated as absent.
 
 ## Honor hard authoring invariants
 

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.34.1 -->
+<!-- reviewed-through-cli: 0.34.2 -->
 ```
 
 The quoted version above is checked too, so this instruction cannot go stale