@oddington/cli 0.1.54 → 0.1.56

package/README.md

@@ -10,6 +10,10 @@ The CLI requires Node.js 22.12 or later.
 npm install --global @oddington/cli
 ```
 
+Use npm as the single global installer for this command; parallel Bun, pnpm or
+other global copies can leave an older `os` earlier on `PATH`. Confirm the
+installed release with `os --version`.
+
 ## Sign in
 
 ```sh
@@ -86,6 +90,9 @@ is a Data repository alias there. The command reads only its published normalize
 schema and writes the marked root `os-data.generated.d.ts`. It reports that path
 and the TypeScript project files it integrates. Review and commit those files;
 a fresh clone uses the types without signing in or regenerating them.
+The shared declaration contains no package import. The worktree root needs no
+package installation; each consuming project keeps its own compatible
+`@oddington/sdk` dependency.
 
 Keep importing `data` from `@oddington/sdk`. A known repository literal now gains
 schema-aware `records.select`, `pages` and `all` queries and projected values.
@@ -97,13 +104,19 @@ Run the same command explicitly after a published schema changes, then review
 and commit its diff. Other aliases in the declaration are preserved. An unchanged
 refresh leaves generated and project bytes untouched. App build/launch never
 refreshes this file. The command does not retrieve Records or commit anything.
+Exact unedited output from the first released module-augmentation format is
+upgraded atomically on refresh, preserving other aliases. Edited, malformed or
+unrecognized generated files remain protected from replacement.
 
 Project integration preserves JSONC comments and authored settings, including
 confined local inheritance, source includes and project references. Unsupported
-or ambiguous layouts (including package-based/external inheritance, symlinks,
-nested Git repositories and incompatible referenced build projects) are refused
-before writing. Access, parsing, transport or write failures preserve the prior
-complete declaration and project configuration. Generation is serialized within
+or ambiguous layouts (including package-based/external inheritance, nested Git
+repositories and incompatible referenced build projects) are refused. Discovery
+ignores unrelated symbolic links without following them, including documentation
+links. Linked or escaping configurations, references, generated declarations and
+required integration directories are refused before authentication or writes;
+local failures identify the path and condition. Access, parsing, transport or
+write failures preserve the prior complete declaration and project configuration. Generation is serialized within
 the worktree; after a process interruption, check that no generation is running
 before removing a stale `.os-data-schema.lock` directory and refreshing again.
 
@@ -586,7 +599,7 @@ provider connections retain their normal network and authority requirements;
 local execution may contact OS or providers.
 
 For modern local execution, install the workspace separately with Bun 1.3.14.
-Keep `@oddington/sdk` exactly 0.1.29 in root `devDependencies`, compatible Node,
+Keep `@oddington/sdk` exactly 0.1.30 in root `devDependencies`, compatible Node,
 the selected private ESM manifest and the shared frozen lock. OS verifies only
 the selected installed graph, stages its confined bytes and builds the same
 executable unit used by deployment, preserving declared assets and SDK ownership.