@neocompose/cli 0.59.4 → 0.60.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neocompose/cli",
-  "version": "0.59.4",
+  "version": "0.60.0",
   "description": "Neo Compose native project-source CLI with bidirectional sync.",
   "license": "MIT",
   "type": "module",
@@ -31,11 +31,12 @@
     "publish:npm": "npm run prepublishOnly && set -a && . ./.env.prod && set +a && npm publish --ignore-scripts"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "dependencies": {
     "@inquirer/prompts": "^8.5.2",
     "convex": "^1.45.0",
+    "fflate": "^0.8.3",
     "ignore": "^7.0.6",
     "valibot": "^1.4.2"
   },

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.59.4 -->
+<!-- reviewed-through-cli: 0.60.0 -->
 
 # Neo Compose CLI
 

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

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

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

@@ -299,6 +299,12 @@ result download, and local result application. `startedMs` is relative to the
 CLI process and `durationMs` covers the named operation. Nested spans overlap;
 do not add all durations. Normal command JSON remains on stdout.
 
-Durable pushes submit compressed JSON directly to a Convex HTTP action and subscribe to completion with the scoped session's refreshing JWT. Bodies above 1 MiB and staged media use an internal Node action; requests beyond the direct transport's bounds use the existing server upload route. The CLI pins the deployment through the authenticated app origin before sending it a session token.
+Each command opens one Convex websocket, authenticated with the scoped
+session's refreshing JWT, and runs every query, mutation, and subscription over
+it. Push sends compressed JSON through `clientCommits.commit` when the request
+has no staged files and decodes to at most 512 KiB; otherwise it streams chunks
+through `begin`, `appendChunks`, and `seal`, and subscribes to completion. The
+CLI pins the deployment through the authenticated app origin before sending it
+a session token.
 Results pin the workspace to that transaction's hash, so a concurrent later commit still
 requires a pull before another push.

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

@@ -367,3 +367,8 @@ neo migrate prune
 
 Run checks before migration execution. Review storage ownership and every write
 intent; do not assume an action body is writable merely because it compiled.
+
+`neo migrate run` reads the project from the server and prepares its writes
+locally, like push. If another commit lands while it runs, the run is refused:
+run it again. `neo loc` writes work the same way: a write refused because
+another commit landed is run again.