fix: include the local Postgres runtime in published CLI packages

docs/product/command-principles.md

@@ -93,6 +93,14 @@ No current branch command uses `use`; branch targeting follows explicit flags or
 
 Build and release an app into a target branch.
 
+### `dev`
+
+Run a built Composer app locally, including its local databases, without cloud
+credentials. Both published CLI packages (`prisma` and `@prisma/cli`) include
+`@prisma/dev` as a runtime dependency for local Postgres. Composer resolves
+the runtime from the project's installation; starting local dev must not
+require an extra emulator dependency in the app or a global installation.
+
 ### `init`
 
 Prepare the current repository for Prisma development, entirely locally: add the `postinstall` script that keeps the Prisma agent skills in sync (`prisma skills sync || exit 0`), add `prisma` to `devDependencies` at the CLI's exact version when no dependency field declares it, scaffold a `prisma.config.ts` recording which agents get skills, then sync the skills once now.

packages/cli/README.md

@@ -62,6 +62,10 @@ npx prisma-cli project env list --role preview
 The beta package exposes `prisma-cli` so it can coexist with the existing
 `prisma` executable.
 
+Both CLI packages include `@prisma/dev`, the runtime used by Composer's local
+Postgres emulator. It is a CLI dependency, not an extra dependency to add to
+your application or install globally.
+
 ---
 
 ## Commands

packages/cli/package.json

@@ -52,6 +52,7 @@
     "@prisma/cli-engine": "workspace:0.4.0",
     "@prisma/composer-cli": "0.20.0",
     "@prisma/compute-sdk": "0.42.0",
+    "@prisma/dev": "0.25.2",
     "@prisma/management-api-sdk": "1.69.0",
     "@prisma/orm-toolchain": "8.0.0-rc.11",
     "@vercel/detect-agent": "^1.2.3",

packages/cli/scripts/conformance.ts

@@ -59,12 +59,15 @@ async function importPurity(): Promise<readonly Finding[]> {
     label: "@prisma/cli",
     output: await sweepBuiltOutput(join(CLI_DIR, "dist")),
     manifest: await manifest(CLI_DIR),
+    // Composer resolves the local Postgres runtime from the installed CLI.
+    allowedUnimported: ["@prisma/dev"],
     requiredSpecifiers: ["@prisma/cli-engine", "@prisma/composer-cli/family"],
   });
   const unscoped = checkImportPurity({
     label: "prisma",
     output: await sweepBuiltOutput(join(PRISMA_DIR, "dist")),
     manifest: await manifest(PRISMA_DIR),
+    allowedUnimported: ["@prisma/dev"],
     requiredSpecifiers: ["@prisma/cli-engine", "@prisma/composer-cli/family"],
   });
   const engine = checkImportPurity({
@@ -97,8 +100,12 @@ async function tarball(): Promise<readonly Finding[]> {
   return checkTarball(
     {
       packages: [
-        { name: "@prisma/cli", dir: CLI_DIR },
-        { name: "prisma", dir: PRISMA_DIR },
+        {
+          name: "@prisma/cli",
+          dir: CLI_DIR,
+          allowedUnimported: ["@prisma/dev"],
+        },
+        { name: "prisma", dir: PRISMA_DIR, allowedUnimported: ["@prisma/dev"] },
         {
           name: "@prisma/cli-engine",
           dir: ENGINE_DIR,

packages/cli/tests/manifest-pins.test.ts

@@ -30,6 +30,7 @@ describe("the prisma wrapper's manifest", () => {
   it("declares exactly @prisma/cli's runtime dependencies", async () => {
     const cli = await dependencies(CLI_DIR);
     const wrapper = await dependencies(join(CLI_DIR, "..", "prisma"));
+    expect(cli).toHaveProperty("@prisma/dev");
     expect(wrapper).toEqual(cli);
   });
 });

packages/cli/tests/v8-conformance.test.ts

@@ -68,6 +68,7 @@ describe("conformance: import purity", () => {
         label: "@prisma/cli",
         output,
         manifest,
+        allowedUnimported: ["@prisma/dev"],
         // Anti-vacuity, and more: these two are the engine boundary this
         // package exists to compose, so a build that stopped importing
         // either one is a broken shell rather than a tidy one.

packages/prisma/README.md

@@ -40,6 +40,10 @@ npx prisma git connect git@github.com:owner/repo.git
 
 Deployments start from pushing the connected repository, the Console, or `prisma deploy`.
 
+The CLI includes `@prisma/dev`, the runtime used by Composer's local Postgres
+emulator. It is a CLI dependency, not an extra dependency to add to your
+application or install globally.
+
 With `pnpm`:
 
 ```bash

packages/prisma/package.json

@@ -53,6 +53,7 @@
     "@prisma/cli-engine": "workspace:0.4.0",
     "@prisma/composer-cli": "0.20.0",
     "@prisma/compute-sdk": "0.42.0",
+    "@prisma/dev": "0.25.2",
     "@prisma/management-api-sdk": "1.69.0",
     "@prisma/orm-toolchain": "8.0.0-rc.11",
     "@vercel/detect-agent": "^1.2.3",