@samva/cli 0.6.0 → 0.7.0

package/AGENTS.md

@@ -38,7 +38,7 @@ image or font as unsaved bytes at `assets/<file name>` unless `--path` names ano
 `--replace` is required to change a path that already holds a file. The Git commands remain the way
 to author a project you have cloned.
 
-`samva brands pull [slug]` writes the brand snapshot `.samva/brands/<slug>.json` that `@samva/vite`
+`samva brands pull [slug]` writes the brand snapshot `.samva/brands/<slug>.json` that the CLI
 resolves `samva:brand` from offline; bare `pull` snapshots the default brand, and `theme.css` is
 never written. Keep `.samva` gitignored. `samva brands push <file>` validates brand CSS locally,
 exits `1` with located findings when it is outside the brand grammar, and otherwise replaces the
@@ -74,3 +74,7 @@ when it is missing; other CLI commands are self-contained.
 the matching platform-specific `@samva/cli-*` executable and falls back to the packaged JavaScript
 CLI through Bun when npm omits optional dependencies. Depend on `@samva/cli`, never a native
 artifact directly.
+
+Keep Samva brand resolution in the CLI and pass `samvaBrandPlugin` to the project's authoring
+toolchain, so standalone `@samva/vite` stays independent of Samva authentication and storage.
+Standalone callers supply their own resolver. The README owns resolution order and configuration.

package/README.md

@@ -221,6 +221,14 @@ automation path.
 editor from the project's `@samva/vite/dev` under Node.js, with no `vite.config.ts`. It prints the
 editor URL and runs until interrupted; `SIGINT` and `SIGTERM` close the server.
 
+The CLI supplies Samva brand resolution to `dev`, `check`, `build`, `render`, `snapshot` and
+`export`. An imported `samva:brand` uses `SAMVA_API_KEY` from the environment or project `.env`
+(and `SAMVA_API_URL` for another endpoint), or `samva brands get --json` on `PATH` with your login
+session. Live answers refresh `.samva/brands/<slug>.json`; an unavailable live brand falls back to
+that snapshot with `brand-offline`. A changed live digest reports `brand-snapshot-stale`. With
+neither a live answer nor a snapshot, the command fails with `brand-unavailable`. Keep `.samva/`
+gitignored. Standalone `@samva/vite` callers configure a resolver themselves.
+
 `samva templates check` runs the project's TypeScript configuration, then uses the project's
 `@samva/vite/build` to compile every template, render every fixture, and report located findings
 plus email-client compatibility findings. It writes no files and exits non-zero on TypeScript,