naro-cli 0.21.0 → 0.22.0

package/README.md

@@ -100,14 +100,16 @@ naro env import .env.qa qa         Upload every variable in a dotenv file to one
                                    stops it before any request, and so does a key a storage binding already uses
                                    when there are over 100 variables; an empty value is uploaded and shown (empty))
 
-naro environments                  List the project's environments: address, branch, protection, and how many the plan allows
+naro environments                  List the project's environments: address, branch, protection, data, and how many the plan allows
 naro environments create qa --branch qa
                                    A QA or staging surface served at <subdomain>--qa; --copy-env preview|production|none
                                    picks where its variables start, --database schema|empty how its database does
 naro environments set qa --no-branch --protection off
                                    Change the branch whose pushes deploy here (--branch <b>, or --no-branch for none)
                                    and who can open it (--protection on|off; off asks first, --yes in CI)
-naro environments delete qa        Delete it with its worker and protection key (asks first; --yes in CI)
+naro environments delete qa        Delete it with its worker, protection key and data (asks first; --yes in CI)
+naro environments provision qa     Make its data (database, backend, Storage), or go on after a stop
+naro db query "select 1" --env qa  Any data command on an environment's data: db, migration, gen, backend, policy, storage, realtime
 
 naro domains list
 naro domains add www.example.com   Prints the CNAME to create; naro connects
@@ -853,6 +855,55 @@ An `--update-check` you give replaces the default: without
 
 ## Release notes
 
+### 0.22.0
+
+0.21.0 went out without this.
+
+- `naro deploy --env <name>` builds with the values the control plane
+  chose for the environment, over the ones it sent (named environments 3d).
+  The control plane saves what the deploy sends for that environment first,
+  so the two differ only where naro sets a name itself: for a project with a
+  Naro backend, an environment's build gets `NARO_URL`,
+  `NEXT_PUBLIC_NARO_URL`, `VITE_NARO_URL`, `PUBLIC_NARO_URL` and the four
+  `…_NARO_ANON_KEY` names set to that environment's own address and anon key.
+  0.21.0 and earlier let a value the deploy sent — typed at the prompt for a
+  missing key, or read from `.env.local` after you agreed — win in the local
+  build, so an environment's app could be built to call the production
+  backend while its worker was given the environment's. `naro deploy --prod`
+  and preview deploys still build with a value sent over the stored one.
+- naro-mcp 0.21.0 goes out with it, with no change of its own: its `deploy` tool sends no env, so the new order does not change what it builds.
+- `--env <name>` on the data commands — `naro db`, `naro migration`,
+  `naro gen types`, `naro backend` (status, keys, auth, users), `naro policy`,
+  `naro storage` and `naro realtime` — acts on that named environment's own
+  database and backend instead of production's (named environments 3e). No
+  `--env`, or `--env production`, is production, which preview shares; this
+  default is not `naro deploy`'s and `naro env pull`'s, which is preview.
+  `--env preview` fails before anything is sent:
+  `--env preview has no data of its own: preview deployments use production's. Drop --env, or name an environment.`,
+  and a value that is no environment's name with
+  `--env must be production or an environment name.` `naro backend enable`
+  and `disable` refuse `--env` (`--env is not an option of naro backend enable: turning the backend on or off applies to every environment.`):
+  every environment's backend follows production's switch. Prompts and result
+  lines name the environment's database (`Reset the qa environment's database?`),
+  and the way back they print carries the `--env` (`naro db restore --bookmark <b> --env qa`).
+  `naro backend --env qa` shows the environment's address and anon key — what a
+  local `.env.local` needs to call that environment's backend.
+  **0.21.0 and earlier ignore `--env` on these commands and act on production**:
+  the control plane cannot tell which CLI sent a request. Update before you
+  use an environment's data.
+- `naro environments` has a `data` column — `provisioning`, `ready`, `error`,
+  or `—` for a project with no Naro database or backend — and prints a stopped
+  run's sentence under the table. `naro environments provision <slug>` makes the
+  environment's data or goes on from where it stopped (`POST …/environments/{id}/provision`).
+  `naro environments delete` now says it removes the environment's data too.
+- `naro deploy --env <name>` no longer asks for `NARO_URL`,
+  `NEXT_PUBLIC_NARO_URL`, `VITE_NARO_URL`, `PUBLIC_NARO_URL` or the four
+  `…_NARO_ANON_KEY` names when the project has a Naro backend: naro sets them
+  for the environment over any value, so a typed one only lost. It reads the
+  project's backend once, and only when one of those names is missing
+  (`▸ naro sets … for qa to its own backend's: not asked for`); a role that
+  cannot read the backend is asked as before.
+
 ### 0.21.0
 
 0.20.0 went out on 2026-10-26 without these.