@the-meridian/cli 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @the-meridian/cli
 
+## 1.0.3
+
+### Patch Changes
+
+- faaf2bf: Clarify punctuation in the README.
+
+## 1.0.2
+
+### Patch Changes
+
+- 5eb0d4f: Clarify punctuation in developer-facing messages.
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -17,7 +17,7 @@ meridian dev            # every day
 - Node.js 20 or newer
 - A Meridian account with access to at least one organization and app
 
-You do **not** need Docker, a local MySQL server, `gcloud`, or the Cloud SQL Auth Proxy — the CLI downloads and manages the proxy for you.
+You do **not** need Docker, a local MySQL server, `gcloud`, or the Cloud SQL Auth Proxy. The CLI downloads and manages the proxy for you.
 
 ## How it works
 
@@ -144,7 +144,7 @@ SHADOW_DATABASE_URL="mysql://devu_88_15:<password>@127.0.0.1:3307/devdb_88_u15_s
 ```
 
 - `SHADOW_DATABASE_URL` points at a second database provisioned for you, which `prisma migrate dev` needs (see below). It is reachable with the same credentials and is dropped when your dev database is.
-- Every other line — comments, ordering, blank lines, quoting style — is preserved; only these two are replaced.
+- Every other line (comments, ordering, blank lines, quoting style) is preserved; only these two are replaced.
 - The first time a file is modified, a one-time copy is saved as `.env.backup`, with the same permissions as the file it copies.
 - An existing file keeps its permissions; a file the CLI creates is `0600`, because the line it writes contains a live password.
 - The port changes between runs when the preferred port is busy, so re-running `meridian dev` rewrites the line.
@@ -167,13 +167,13 @@ datasource db {
 
 `meridian migrate` offers to add the `shadowDatabaseUrl` line for you the first time it finds it missing, and writes it in place. It asks rather than just doing it, because a schema is source you keep in git, unlike the generated `.env`. A datasource that already names some other variable is left alone.
 
-`shadowDatabaseUrl` is required because `prisma migrate dev` does not apply migrations directly: it replays your migration history into a throwaway shadow database and diffs that against your schema to detect drift. Prisma creates that database itself when it can, and your dev user cannot — it holds privileges on its own two databases and nothing else, so `CREATE DATABASE` is denied and Prisma reports `P3014`. Meridian provisions the shadow database per developer instead of granting the privilege, because Prisma names shadow databases with a fixed `prisma_migrate_shadow_db_*` prefix: a grant broad enough to cover that would be shared by every developer on the instance.
+`shadowDatabaseUrl` is required because `prisma migrate dev` does not apply migrations directly: it replays your migration history into a throwaway shadow database and diffs that against your schema to detect drift. Prisma creates that database itself when it can, and your dev user cannot: it holds privileges on its own two databases and nothing else, so `CREATE DATABASE` is denied and Prisma reports `P3014`. Meridian provisions the shadow database per developer instead of granting the privilege, because Prisma names shadow databases with a fixed `prisma_migrate_shadow_db_*` prefix: a grant broad enough to cover that would be shared by every developer on the instance.
 
 Only `meridian migrate` needs it. `dev`, `db seed` and `db shell` run fine without it.
 
 ## Non-interactive and CI use
 
-Prompts are skipped automatically when stdin/stderr aren't TTYs, when `CI` is set, or when `MERIDIAN_NON_INTERACTIVE` is set — in that mode a command that would have prompted fails with a message naming the flag or variable to set instead.
+Prompts are skipped automatically when stdin/stderr aren't TTYs, when `CI` is set, or when `MERIDIAN_NON_INTERACTIVE` is set. In that mode a command that would have prompted fails with a message naming the flag or variable to set instead.
 
 | Variable | Purpose |
 | --- | --- |
@@ -184,7 +184,7 @@ Prompts are skipped automatically when stdin/stderr aren't TTYs, when `CI` is se
 | `MERIDIAN_NON_INTERACTIVE` | Same as `--no-input` |
 | `MERIDIAN_NO_BROWSER` | Same as `login --no-browser` |
 | `MERIDIAN_DEV_ACTIVE` | Set to `1` in every process `meridian dev` starts. Read it to detect that your script is already inside a session; setting it yourself makes `meridian dev` refuse to start |
-| `MERIDIAN_DEV_DATABASE_ID` | Exported (alongside `DATABASE_URL`) into the children of `meridian dev`, `migrate` and `db …`, holding the id of the dev database that session provisioned. The Meridian SDK sends it as `devDatabaseId` on its identify call, so installs a locally-run app creates are billed to your dev database. Set by the CLI only — never set it yourself |
+| `MERIDIAN_DEV_DATABASE_ID` | Exported (alongside `DATABASE_URL`) into the children of `meridian dev`, `migrate` and `db …`, holding the id of the dev database that session provisioned. The Meridian SDK sends it as `devDatabaseId` on its identify call, so installs a locally-run app creates are billed to your dev database. Set by the CLI only. Never set it yourself |
 | `MERIDIAN_PROXY_PATH` | Use an existing proxy binary instead of downloading one |
 | `MERIDIAN_PROXY_VERSION` | Pin a different proxy version (checksum is fetched from that release) |
 | `MERIDIAN_PROXY_SKIP_CHECKSUM=1` | Allow install when no checksum is published. Use only if you trust the source |
@@ -198,39 +198,39 @@ Read commands support `--json`. Errors are also JSON in that mode:
 
 ## Troubleshooting
 
-**`You are not logged in to Meridian.`** — Run `meridian login`.
+**`You are not logged in to Meridian.`**: Run `meridian login`.
 
-**`This project is not linked to a Meridian app.`** — Run `meridian link` in the project root. The CLI looks for `.meridian/project.json` in the current directory and its parents.
+**`This project is not linked to a Meridian app.`**: Run `meridian link` in the project root. The CLI looks for `.meridian/project.json` in the current directory and its parents.
 
-**`Your Meridian CLI token is no longer valid (401).`** — The token was revoked or expired. Run `meridian login` again.
+**`Your Meridian CLI token is no longer valid (401).`**: The token was revoked or expired. Run `meridian login` again.
 
-**`Provisioning the development database failed.`** — Provisioning ended in an error state on Meridian's side; the reason the API reports is appended to the message. Check the dashboard for the full history, then re-run `meridian dev` to retry.
+**`Provisioning the development database failed.`**: Provisioning ended in an error state on Meridian's side; the reason the API reports is appended to the message. Check the dashboard for the full history, then re-run `meridian dev` to retry.
 
-**`The development database is not ready yet.`** — A credentials or reset call arrived before provisioning finished (HTTP 409). `meridian dev` polls for you, so this normally only appears when a command runs against a database that is still being created.
+**`The development database is not ready yet.`**: A credentials or reset call arrived before provisioning finished (HTTP 409). `meridian dev` polls for you, so this normally only appears when a command runs against a database that is still being created.
 
-**`Could not reach 127.0.0.1:<port>/<db> (ECONNREFUSED).`** — Nothing is listening. `meridian dev` and `meridian migrate` start the proxy themselves; if you're running Prisma directly, keep `meridian dev` running in another terminal.
+**`Could not reach 127.0.0.1:<port>/<db> (ECONNREFUSED).`**: Nothing is listening. `meridian dev` and `meridian migrate` start the proxy themselves; if you're running Prisma directly, keep `meridian dev` running in another terminal.
 
-**`Timed out waiting for MySQL …`** — The proxy is up but can't reach Cloud SQL. Check whether a VPN, firewall, or corporate proxy blocks outbound connections, then retry with `--verbose` to see the proxy's own logs.
+**`Timed out waiting for MySQL …`**: The proxy is up but can't reach Cloud SQL. Check whether a VPN, firewall, or corporate proxy blocks outbound connections, then retry with `--verbose` to see the proxy's own logs.
 
-**`Another process is already listening on that port.`** — Pass `--port` to choose a different one.
+**`Another process is already listening on that port.`**: Pass `--port` to choose a different one.
 
-**Proxy download fails** (air-gapped network, blocked storage.googleapis.com) — Install the [Cloud SQL Auth Proxy](https://github.com/GoogleCloudPlatform/cloud-sql-proxy) yourself and set `MERIDIAN_PROXY_PATH` to it.
+**Proxy download fails** (air-gapped network, blocked storage.googleapis.com): Install the [Cloud SQL Auth Proxy](https://github.com/GoogleCloudPlatform/cloud-sql-proxy) yourself and set `MERIDIAN_PROXY_PATH` to it.
 
-**Checksum verification failed** — A cached binary that no longer matches its published SHA-256 is deleted and downloaded again automatically. If a fresh download also fails verification the CLI refuses to install it, which usually means something on the network is rewriting the response. Don't reach for `MERIDIAN_PROXY_SKIP_CHECKSUM` in that situation.
+**Checksum verification failed**: A cached binary that no longer matches its published SHA-256 is deleted and downloaded again automatically. If a fresh download also fails verification the CLI refuses to install it, which usually means something on the network is rewriting the response. Don't reach for `MERIDIAN_PROXY_SKIP_CHECKSUM` in that situation.
 
-**A migration failed and left the schema half-applied** — `meridian migrate` restores the pre-migration snapshot automatically. To redo it by hand, use the newest file in `.meridian/snapshots/`, or run `meridian db reset` for a clean slate.
+**A migration failed and left the schema half-applied**: `meridian migrate` restores the pre-migration snapshot automatically. To redo it by hand, use the newest file in `.meridian/snapshots/`, or run `meridian db reset` for a clean slate.
 
-**The rollback itself failed** — Treat the database as unsafe: the reset succeeded but the replay didn't finish, so the schema is partial. Start the proxy with `meridian dev` in another terminal and replay the snapshot by hand (`mysql … < .meridian/snapshots/<timestamp>.sql`, or `meridian db shell` and paste it), or take the clean slate with `meridian db reset --migrate`. The failing statement's index is in the error message.
+**The rollback itself failed**: Treat the database as unsafe: the reset succeeded but the replay didn't finish, so the schema is partial. Start the proxy with `meridian dev` in another terminal and replay the snapshot by hand (`mysql … < .meridian/snapshots/<timestamp>.sql`, or `meridian db shell` and paste it), or take the clean slate with `meridian db reset --migrate`. The failing statement's index is in the error message.
 
-**`meridian dev` says it would call itself** — Your `npm run dev` script invokes `meridian dev`. Point `dev_command` in `.meridian/project.json` at the real dev server (for example `next dev`), or run `meridian dev -- next dev`.
+**`meridian dev` says it would call itself**: Your `npm run dev` script invokes `meridian dev`. Point `dev_command` in `.meridian/project.json` at the real dev server (for example `next dev`), or run `meridian dev -- next dev`.
 
-**"…would not touch the managed development database"** — Your Prisma datasource does not read `DATABASE_URL`, so Prisma would ignore the database the CLI just connected you to and use whatever the schema hardcodes (typically `file:dev.sqlite`). Set `provider = "mysql"` and `url = env("DATABASE_URL")`, and regenerate any migrations created for the old database — their SQL is dialect-specific and MySQL will reject it. Projects that deliberately manage their datasource some other way can set `"skip_datasource_check": true` in `.meridian/project.json`.
+**"…would not touch the managed development database"**: Your Prisma datasource does not read `DATABASE_URL`, so Prisma would ignore the database the CLI just connected you to and use whatever the schema hardcodes (typically `file:dev.sqlite`). Set `provider = "mysql"` and `url = env("DATABASE_URL")`, and regenerate any migrations created for the old database, because their SQL is dialect-specific and MySQL will reject it. Projects that deliberately manage their datasource some other way can set `"skip_datasource_check": true` in `.meridian/project.json`.
 
-**"written for a different database engine"** — `migrate` screens `prisma/migrations` before it provisions anything, because a history generated for another engine cannot apply to MySQL. SQLite and Postgres quote identifiers as `"Session"`, which MySQL reads as a string literal, and SQLite's `TEXT` primary keys are invalid as MySQL keys. Migration SQL is dialect-specific, so the history has to be regenerated: if it has only ever run locally, delete `prisma/migrations` and re-run. This is the normal state of a Shopify app template, which ships SQLite migrations. `--allow-foreign-migrations` waives the check.
+**"written for a different database engine"**: `migrate` screens `prisma/migrations` before it provisions anything, because a history generated for another engine cannot apply to MySQL. SQLite and Postgres quote identifiers as `"Session"`, which MySQL reads as a string literal, and SQLite's `TEXT` primary keys are invalid as MySQL keys. Migration SQL is dialect-specific, so the history has to be regenerated: if it has only ever run locally, delete `prisma/migrations` and re-run. This is the normal state of a Shopify app template, which ships SQLite migrations. `--allow-foreign-migrations` waives the check.
 
 If an earlier attempt already failed against the database, run `meridian db reset` before retrying. Prisma records the failure in `_prisma_migrations`, and once the history is deleted that row names a migration that no longer exists on disk, which Prisma reports as drift and refuses to work past.
 
-**"declares no `shadowDatabaseUrl`"**, or Prisma's **`P3014`** — `prisma migrate dev` needs a shadow database and your dev user cannot create one. Meridian provisions it and exports `SHADOW_DATABASE_URL`; add `shadowDatabaseUrl = env("SHADOW_DATABASE_URL")` to your datasource. If you hit `P3014` despite having that line, your dev database predates shadow databases — `meridian db reset` re-provisions it.
+**"declares no `shadowDatabaseUrl`"**, or Prisma's **`P3014`**: `prisma migrate dev` needs a shadow database and your dev user cannot create one. Meridian provisions it and exports `SHADOW_DATABASE_URL`; add `shadowDatabaseUrl = env("SHADOW_DATABASE_URL")` to your datasource. If you hit `P3014` despite having that line, your dev database predates shadow databases. `meridian db reset` re-provisions it.
 
 ## Development
 

package/dist/index.js

@@ -453,7 +453,7 @@ function extractErrorCode(body) {
 }
 var HINTS_BY_ERROR_CODE = {
   dev_database_limit_reached: "Your plan does not include a development database for you on this app. Every collaborator gets their own out of the plan's allowance, so upgrading the organization's plan in the Meridian dashboard is what unlocks it.",
-  dev_database_over_storage_limit: "Run `meridian db reset` to drop and recreate the schema \u2014 reset and delete stay available while you're over the limit.",
+  dev_database_over_storage_limit: "Run `meridian db reset` to drop and recreate the schema. Reset and delete stay available while you're over the limit.",
   FEATURE_NOT_ENTITLED: "Your organization's plan does not include managed development databases; upgrade it in the Meridian dashboard."
 };
 function hintForError(status, errorCode) {
@@ -465,7 +465,7 @@ function hintForError(status, errorCode) {
   if (status === 403) return "You may not have access to this organization or app; check your Meridian membership.";
   if (status === 404) return "Run `meridian link` to select a valid organization and app.";
   if (status === 409) {
-    return "The development database is not ready yet. Wait for provisioning to finish, then try again \u2014 `meridian dev` polls for you.";
+    return "The development database is not ready yet. Wait for provisioning to finish, then try again. `meridian dev` polls for you.";
   }
   if (status === 422) return "Check the request for validation errors and try again.";
   if (status === 429) return "You're being rate limited by the Meridian API; wait a moment and try again.";
@@ -720,7 +720,7 @@ function toDatabaseError(error2, info) {
   if (code === "ER_ACCESS_DENIED_ERROR") {
     return build(
       `Access denied connecting to ${target} as "${info.user}".`,
-      "Database credentials are short-lived and rotate automatically \u2014 run `meridian dev` again to fetch fresh ones."
+      "Database credentials are short-lived and rotate automatically. Run `meridian dev` again to fetch fresh ones."
     );
   }
   if (code === "ER_BAD_DB_ERROR") {
@@ -1508,7 +1508,7 @@ import {
 } from "fs";
 import { dirname as dirname3 } from "path";
 var CREATED_ENV_MODE = 384;
-var MANAGED_HEADER = "# Managed by the Meridian CLI \u2014 DATABASE_URL is rewritten by `meridian dev`.";
+var MANAGED_HEADER = "# Managed by the Meridian CLI. DATABASE_URL is rewritten by `meridian dev`.";
 var LINE_RE = /^([ \t]*)(export[ \t]+)?([A-Za-z_][A-Za-z0-9_]*)([ \t]*=[ \t]*)(.*)$/;
 function splitLines(content) {
   const lines = [];
@@ -1883,7 +1883,7 @@ function assertShadowDatasource(root) {
   if (shadow !== null && shadow.kind === "env" && shadow.name === REQUIRED_SHADOW_URL_ENV) return;
   const problem = shadow === null ? "declares no `shadowDatabaseUrl`" : shadow.kind === "literal" ? `hardcodes \`shadowDatabaseUrl = "${shadow.value}"\`` : `reads \`env("${shadow.name}")\` for its shadow database, but Meridian sets \`${REQUIRED_SHADOW_URL_ENV}\``;
   throw new CliError(`\`${datasource.schemaPath}\` ${problem}.`, {
-    hint: `\`prisma migrate dev\` diffs your migrations in a throwaway shadow database, and your dev user cannot create one \u2014 so Meridian provisions it for you and exports \`${REQUIRED_SHADOW_URL_ENV}\`. Add \`shadowDatabaseUrl = env("${REQUIRED_SHADOW_URL_ENV}")\` to the \`${datasource.name}\` datasource. ${BYPASS_HINT}`
+    hint: `\`prisma migrate dev\` diffs your migrations in a throwaway shadow database, and your dev user cannot create one, so Meridian provisions it for you and exports \`${REQUIRED_SHADOW_URL_ENV}\`. Add \`shadowDatabaseUrl = env("${REQUIRED_SHADOW_URL_ENV}")\` to the \`${datasource.name}\` datasource. ${BYPASS_HINT}`
   });
 }
 var FOREIGN_DIALECT_DDL = /\b(?:CREATE\s+(?:UNIQUE\s+)?(?:TABLE|INDEX)|ALTER\s+TABLE|REFERENCES)\s+"/i;
@@ -1912,7 +1912,7 @@ function findForeignDialectMigration(root) {
   return offender === void 0 ? null : relative(root, offender);
 }
 function foreignDialectExplanation(offender) {
-  return `\`${offender}\` was generated for SQLite or Postgres \u2014 it quotes identifiers with double quotes, which MySQL reads as string literals. Migration SQL is dialect-specific and cannot be replayed against MySQL. If this history has only ever run locally, delete \`prisma/migrations\` and re-run to regenerate it for MySQL; run \`meridian db reset\` first if an earlier attempt already failed, since Prisma records that failure in \`_prisma_migrations\` and will not continue while it is there.`;
+  return `\`${offender}\` was generated for SQLite or Postgres. It quotes identifiers with double quotes, which MySQL reads as string literals. Migration SQL is dialect-specific and cannot be replayed against MySQL. If this history has only ever run locally, delete \`prisma/migrations\` and re-run to regenerate it for MySQL; run \`meridian db reset\` first if an earlier attempt already failed, since Prisma records that failure in \`_prisma_migrations\` and will not continue while it is there.`;
 }
 function assertMigrationDialect(root) {
   const offender = findForeignDialectMigration(root);
@@ -3910,7 +3910,7 @@ async function runMigration(session, deps, ctx) {
       "Snapshotting the development database...",
       () => deps.createSnapshot(session.connection, { dir, now: deps.now }),
       {
-        success: (result) => result.path === null ? "Development database is empty \u2014 nothing to snapshot." : `Snapshot saved to ${style.path(result.path)} (${formatSize(result.bytes)}).`
+        success: (result) => result.path === null ? "Development database is empty. Nothing to snapshot." : `Snapshot saved to ${style.path(result.path)} (${formatSize(result.bytes)}).`
       }
     );
   }
@@ -3961,9 +3961,9 @@ async function runMigration(session, deps, ctx) {
         status = "rolled_back";
         rolledBack = true;
       } catch {
-        error("Automatic rollback failed. The development database may be in a partial state \u2014 treat it as unsafe.");
+        error("Automatic rollback failed. The development database may be in a partial state. Treat it as unsafe.");
         if (snapshotPath === null) {
-          hint("Recover by hand with `meridian db reset` \u2014 the database was empty before this migration.");
+          hint("Recover by hand with `meridian db reset`. The database was empty before this migration.");
         } else {
           detail(`Pre-migration snapshot: ${snapshotPath}`);
           hint(