statelyai 0.11.5 → 0.12.0

package/README.md

@@ -98,6 +98,22 @@ Push re-reads and retries when it observes a concurrent Studio edit. Registry
 updates do not yet expose an atomic revision precondition, so avoid editing the
 same machine in Studio during a push.
 
+`open` restores layout, colors, annotations, and canvas assets from Studio for
+machines with an `@statelyai id`. Unlinked machines keep only non-inferable
+presentation values (canonical coordinates, colors, annotations, and canvas
+assets) in `.statelyai/local.json` at the project root; machine structure is
+not duplicated. The CLI uses Git's repository-local `.git/info/exclude`
+mechanism for this local-only file. It is available to the CLI and VS Code on
+this checkout, and file locking preserves both hosts' concurrent updates, but
+it is not shared until the machine is linked to Studio. Linked presentation
+saves merge into Studio's current structure with an atomic `updatedAt` guard.
+Outside a Git repository, run `statelyai open` from the VS Code workspace root
+so both hosts use the same sidecar.
+Where unambiguous, older CLI sidecars keyed by display name are read and
+migrated to the shared machine key on the next save.
+New states keep their generated coordinates when clear, or move beside
+existing states when they would overlap restored layout.
+
 ## Authentication
 
 <!-- authentication flags, environment resolution, and credential storage from src/cli.ts and src/credentials.ts -->
@@ -279,11 +295,15 @@ statelyai open
 The workspace sidebar starts collapsed. Select a machine there without opening
 a separate browser tab.
 
+<!-- local open and source budget from src/cliHost.ts and ../editor-sync/src/localBackend.ts -->
+
 Saved file changes refresh the editor. Saving visual edits writes them back to
-the source file. Editor sync sends the opened file, its reachable relative
-imports, and ancestor package manifests; unrelated sibling files are excluded.
-The CLI verifies the visual editor protocol before sending source data and
-versions remote Editor Sync requests automatically.
+the source file. Editor Sync loads the opened file, its reachable relative
+imports, and ancestor package manifests locally; unrelated sibling files are
+excluded. The CLI checks access once per session and verifies the editor
+protocol before exchanging machine data. Parsing and writeback run locally.
+By default, the CLI loads up to 1,000 reachable files and 64 MiB of source;
+`STATELY_SYNC_MAX_FILES` and `STATELY_SYNC_MAX_BYTES` adjust these limits.
 If a visual edit cannot be written or a saved source change cannot be parsed,
 the editor keeps the current graph visible and offers retry, copy-details, and
 diagnostic-download actions. Use `--debug` to include the structured diagnostic
@@ -456,8 +476,9 @@ adapter; no verification engine is bundled.
 
 Skip login when the server has authentication disabled. The CLI sends no
 authorization header when no credential exists; the server decides whether
-authentication is required. This also applies to `open` editor-sync requests
-and CI commands.
+authentication is required. `open` checks Editor Sync access once per session,
+then parses and applies source edits locally. CI commands use the same credential
+policy.
 
 For OAuth, point login at the deployment's protected resource:
 

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { S as run } from "./cli-DNPoG2A0.mjs";
+import { C as run } from "./cli-Dr85YlA5.mjs";
 
 //#region src/bin.ts
 run();