prisma-next 0.7.0 → 0.8.0-dev.2

package/dist/{output-B16Kefzx.mjs → output-nBJ6NvsE.mjs}

@@ -90,20 +90,21 @@ function renderInitOutro(ui, output, flags) {
 */
 function buildNextSteps(options) {
 	const steps = [];
-	steps.push("1. Set DATABASE_URL in your environment (export it or add it to .env).");
+	let stepNumber = 1;
+	const push = (text) => {
+		steps.push(`${stepNumber}. ${text}`);
+		stepNumber += 1;
+	};
+	push("Set DATABASE_URL in your environment (export it or add it to .env).");
 	if (!options.contractEmitted) {
-		steps.push(`2. Emit the contract: \`${options.emitCommand}\``);
-		steps.push(`3. Edit your schema at ${options.schemaPath}, then re-run the emit command.`);
-		steps.push("4. Open prisma-next.md for a quick reference on how to write your first typed query.");
-		steps.push("5. The .agents/skills/prisma-next/SKILL.md file is wired up for AI-coding agents in this project.");
-	} else {
-		steps.push(`2. Edit your schema at ${options.schemaPath}, then re-run \`${options.emitCommand}\`.`);
-		steps.push("3. Open prisma-next.md for a quick reference on how to write your first typed query.");
-		steps.push("4. The .agents/skills/prisma-next/SKILL.md file is wired up for AI-coding agents in this project.");
-	}
+		push(`Emit the contract: \`${options.emitCommand}\``);
+		push(`Edit your schema at ${options.schemaPath}, then re-run the emit command.`);
+	} else push(`Edit your schema at ${options.schemaPath}, then re-run \`${options.emitCommand}\`.`);
+	push("Open prisma-next.md for a quick reference on how to write your first typed query.");
+	if (options.skillRegistered) push("@prisma-next/skills is registered with your agent runtime — open the project in your IDE and ask the agent to add a model, run a query, or plan a migration.");
 	return steps;
 }
 //#endregion
 export { renderInitOutro as i, buildNextSteps as n, formatInitJson as r, InitOutputSchema as t };
 
-//# sourceMappingURL=output-B16Kefzx.mjs.map
+//# sourceMappingURL=output-nBJ6NvsE.mjs.map

package/dist/{output-B16Kefzx.mjs.map → output-nBJ6NvsE.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"output-B16Kefzx.mjs","names":[],"sources":["../src/commands/init/output.ts"],"sourcesContent":["import { type } from 'arktype';\nimport type { GlobalFlags } from '../../utils/global-flags';\nimport type { TerminalUI } from '../../utils/terminal-ui';\n\n/**\n * arktype schema for the structured success document `init --json` writes\n * to stdout (FR1.5). The same shape backs the human-readable outro\n * renderer (FR10), so the two output modes carry identical information.\n *\n * `target` is normalised to the user-facing flag value (`mongodb` rather\n * than the internal `mongo`) so consumers can round-trip the document\n * straight into a follow-up `--target` invocation.\n *\n * The `ok: true` literal is the documented success/error discriminator —\n * see [Style Guide § JSON Semantics](../../../../../../../docs/CLI%20Style%20Guide.md#json-semantics).\n * Error envelopes (`CliErrorEnvelope`) carry `ok: false` so consumers can\n * branch with `if (doc.ok)` without inspecting the rest of the structure.\n */\nexport const InitOutputSchema = type({\n  ok: 'true',\n  target: \"'postgres'|'mongodb'\",\n  authoring: \"'psl'|'typescript'\",\n  schemaPath: 'string',\n  filesWritten: 'string[]',\n  /**\n   * FR9.1 — files removed from disk during this run. Populated only on\n   * re-init when previously-emitted contract artefacts (`contract.json`,\n   * `contract.d.ts`, `start-/end-contract.*`, `ops.json`,\n   * `migration.json`) were left behind by an earlier run. Empty on a\n   * green-field init.\n   */\n  filesDeleted: 'string[]',\n  packagesInstalled: {\n    skipped: 'boolean',\n    deps: 'string[]',\n    devDeps: 'string[]',\n  },\n  contractEmitted: 'boolean',\n  nextSteps: 'string[]',\n  warnings: 'string[]',\n});\n\nexport type InitOutput = typeof InitOutputSchema.infer;\n\n/**\n * Serialises the output document for `--json`. Sorted keys are not enforced\n * — `JSON.stringify` preserves insertion order, and the schema field order\n * is the documented order, which matches what users will see when they\n * `jq .` the result.\n */\nexport function formatInitJson(output: InitOutput): string {\n  return JSON.stringify(output, null, 2);\n}\n\n/**\n * Renders the human-readable outro on stderr (FR10.1). Re-uses the same\n * data structure as the JSON output so the two stay in lock-step.\n *\n * Warnings come before \"Next steps\" because they describe state the user\n * needs to be aware of before acting on the next-steps list.\n */\nexport function renderInitOutro(ui: TerminalUI, output: InitOutput, flags: GlobalFlags): void {\n  if (flags.quiet || flags.json) {\n    return;\n  }\n\n  for (const warning of output.warnings) {\n    ui.warn(warning);\n  }\n\n  const lines: string[] = [];\n  lines.push(`Target:    ${output.target}`);\n  lines.push(`Authoring: ${output.authoring}`);\n  lines.push(`Schema:    ${output.schemaPath}`);\n  lines.push('');\n  lines.push('Files written:');\n  for (const file of output.filesWritten) {\n    lines.push(`  • ${file}`);\n  }\n\n  if (output.filesDeleted.length > 0) {\n    lines.push('');\n    lines.push('Files deleted (stale contract artefacts):');\n    for (const file of output.filesDeleted) {\n      lines.push(`  • ${file}`);\n    }\n  }\n\n  if (!output.packagesInstalled.skipped) {\n    lines.push('');\n    lines.push('Packages installed:');\n    for (const dep of output.packagesInstalled.deps) {\n      lines.push(`  • ${dep}`);\n    }\n    for (const dep of output.packagesInstalled.devDeps) {\n      lines.push(`  • ${dep} (dev)`);\n    }\n  }\n\n  lines.push('');\n  lines.push('Next steps:');\n  for (const step of output.nextSteps) {\n    lines.push(`  ${step}`);\n  }\n\n  ui.note(lines.join('\\n'), 'Done');\n}\n\n/**\n * Builds the `nextSteps` array from the resolved scaffold state. Steps are\n * ordered by the workflow a user needs to follow: configure connection →\n * (emit if not yet done) → run a starter query → docs / agent skill.\n *\n * The strings are stable and human-readable; agents wanting to act on them\n * should match on substrings (e.g. \"DATABASE_URL\") rather than exact text,\n * since copy may evolve.\n */\nexport function buildNextSteps(options: {\n  readonly target: 'postgres' | 'mongodb';\n  readonly contractEmitted: boolean;\n  readonly emitCommand: string;\n  readonly schemaPath: string;\n}): string[] {\n  const steps: string[] = [];\n  steps.push('1. Set DATABASE_URL in your environment (export it or add it to .env).');\n  if (!options.contractEmitted) {\n    steps.push(`2. Emit the contract: \\`${options.emitCommand}\\``);\n    steps.push(`3. Edit your schema at ${options.schemaPath}, then re-run the emit command.`);\n    steps.push(\n      '4. Open prisma-next.md for a quick reference on how to write your first typed query.',\n    );\n    steps.push(\n      '5. The .agents/skills/prisma-next/SKILL.md file is wired up for AI-coding agents in this project.',\n    );\n  } else {\n    steps.push(\n      `2. Edit your schema at ${options.schemaPath}, then re-run \\`${options.emitCommand}\\`.`,\n    );\n    steps.push(\n      '3. Open prisma-next.md for a quick reference on how to write your first typed query.',\n    );\n    steps.push(\n      '4. The .agents/skills/prisma-next/SKILL.md file is wired up for AI-coding agents in this project.',\n    );\n  }\n  return steps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,MAAa,mBAAmB,KAAK;CACnC,IAAI;CACJ,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,cAAc;;;;;;;;CAQd,cAAc;CACd,mBAAmB;EACjB,SAAS;EACT,MAAM;EACN,SAAS;EACV;CACD,iBAAiB;CACjB,WAAW;CACX,UAAU;CACX,CAAC;;;;;;;AAUF,SAAgB,eAAe,QAA4B;CACzD,OAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;;;;;;;;;AAUxC,SAAgB,gBAAgB,IAAgB,QAAoB,OAA0B;CAC5F,IAAI,MAAM,SAAS,MAAM,MACvB;CAGF,KAAK,MAAM,WAAW,OAAO,UAC3B,GAAG,KAAK,QAAQ;CAGlB,MAAM,QAAkB,EAAE;CAC1B,MAAM,KAAK,cAAc,OAAO,SAAS;CACzC,MAAM,KAAK,cAAc,OAAO,YAAY;CAC5C,MAAM,KAAK,cAAc,OAAO,aAAa;CAC7C,MAAM,KAAK,GAAG;CACd,MAAM,KAAK,iBAAiB;CAC5B,KAAK,MAAM,QAAQ,OAAO,cACxB,MAAM,KAAK,OAAO,OAAO;CAG3B,IAAI,OAAO,aAAa,SAAS,GAAG;EAClC,MAAM,KAAK,GAAG;EACd,MAAM,KAAK,4CAA4C;EACvD,KAAK,MAAM,QAAQ,OAAO,cACxB,MAAM,KAAK,OAAO,OAAO;;CAI7B,IAAI,CAAC,OAAO,kBAAkB,SAAS;EACrC,MAAM,KAAK,GAAG;EACd,MAAM,KAAK,sBAAsB;EACjC,KAAK,MAAM,OAAO,OAAO,kBAAkB,MACzC,MAAM,KAAK,OAAO,MAAM;EAE1B,KAAK,MAAM,OAAO,OAAO,kBAAkB,SACzC,MAAM,KAAK,OAAO,IAAI,QAAQ;;CAIlC,MAAM,KAAK,GAAG;CACd,MAAM,KAAK,cAAc;CACzB,KAAK,MAAM,QAAQ,OAAO,WACxB,MAAM,KAAK,KAAK,OAAO;CAGzB,GAAG,KAAK,MAAM,KAAK,KAAK,EAAE,OAAO;;;;;;;;;;;AAYnC,SAAgB,eAAe,SAKlB;CACX,MAAM,QAAkB,EAAE;CAC1B,MAAM,KAAK,yEAAyE;CACpF,IAAI,CAAC,QAAQ,iBAAiB;EAC5B,MAAM,KAAK,2BAA2B,QAAQ,YAAY,IAAI;EAC9D,MAAM,KAAK,0BAA0B,QAAQ,WAAW,iCAAiC;EACzF,MAAM,KACJ,uFACD;EACD,MAAM,KACJ,oGACD;QACI;EACL,MAAM,KACJ,0BAA0B,QAAQ,WAAW,kBAAkB,QAAQ,YAAY,KACpF;EACD,MAAM,KACJ,uFACD;EACD,MAAM,KACJ,oGACD;;CAEH,OAAO"}
+{"version":3,"file":"output-nBJ6NvsE.mjs","names":[],"sources":["../src/commands/init/output.ts"],"sourcesContent":["import { type } from 'arktype';\nimport type { GlobalFlags } from '../../utils/global-flags';\nimport type { TerminalUI } from '../../utils/terminal-ui';\n\n/**\n * arktype schema for the structured success document `init --json` writes\n * to stdout (FR1.5). The same shape backs the human-readable outro\n * renderer (FR10), so the two output modes carry identical information.\n *\n * `target` is normalised to the user-facing flag value (`mongodb` rather\n * than the internal `mongo`) so consumers can round-trip the document\n * straight into a follow-up `--target` invocation.\n *\n * The `ok: true` literal is the documented success/error discriminator —\n * see [Style Guide § JSON Semantics](../../../../../../../docs/CLI%20Style%20Guide.md#json-semantics).\n * Error envelopes (`CliErrorEnvelope`) carry `ok: false` so consumers can\n * branch with `if (doc.ok)` without inspecting the rest of the structure.\n */\nexport const InitOutputSchema = type({\n  ok: 'true',\n  target: \"'postgres'|'mongodb'\",\n  authoring: \"'psl'|'typescript'\",\n  schemaPath: 'string',\n  filesWritten: 'string[]',\n  /**\n   * FR9.1 — files removed from disk during this run. Populated only on\n   * re-init when previously-emitted contract artefacts (`contract.json`,\n   * `contract.d.ts`, `start-/end-contract.*`, `ops.json`,\n   * `migration.json`) were left behind by an earlier run. Empty on a\n   * green-field init.\n   */\n  filesDeleted: 'string[]',\n  packagesInstalled: {\n    skipped: 'boolean',\n    deps: 'string[]',\n    devDeps: 'string[]',\n  },\n  contractEmitted: 'boolean',\n  nextSteps: 'string[]',\n  warnings: 'string[]',\n});\n\nexport type InitOutput = typeof InitOutputSchema.infer;\n\n/**\n * Serialises the output document for `--json`. Sorted keys are not enforced\n * — `JSON.stringify` preserves insertion order, and the schema field order\n * is the documented order, which matches what users will see when they\n * `jq .` the result.\n */\nexport function formatInitJson(output: InitOutput): string {\n  return JSON.stringify(output, null, 2);\n}\n\n/**\n * Renders the human-readable outro on stderr (FR10.1). Re-uses the same\n * data structure as the JSON output so the two stay in lock-step.\n *\n * Warnings come before \"Next steps\" because they describe state the user\n * needs to be aware of before acting on the next-steps list.\n */\nexport function renderInitOutro(ui: TerminalUI, output: InitOutput, flags: GlobalFlags): void {\n  if (flags.quiet || flags.json) {\n    return;\n  }\n\n  for (const warning of output.warnings) {\n    ui.warn(warning);\n  }\n\n  const lines: string[] = [];\n  lines.push(`Target:    ${output.target}`);\n  lines.push(`Authoring: ${output.authoring}`);\n  lines.push(`Schema:    ${output.schemaPath}`);\n  lines.push('');\n  lines.push('Files written:');\n  for (const file of output.filesWritten) {\n    lines.push(`  • ${file}`);\n  }\n\n  if (output.filesDeleted.length > 0) {\n    lines.push('');\n    lines.push('Files deleted (stale contract artefacts):');\n    for (const file of output.filesDeleted) {\n      lines.push(`  • ${file}`);\n    }\n  }\n\n  if (!output.packagesInstalled.skipped) {\n    lines.push('');\n    lines.push('Packages installed:');\n    for (const dep of output.packagesInstalled.deps) {\n      lines.push(`  • ${dep}`);\n    }\n    for (const dep of output.packagesInstalled.devDeps) {\n      lines.push(`  • ${dep} (dev)`);\n    }\n  }\n\n  lines.push('');\n  lines.push('Next steps:');\n  for (const step of output.nextSteps) {\n    lines.push(`  ${step}`);\n  }\n\n  ui.note(lines.join('\\n'), 'Done');\n}\n\n/**\n * Builds the `nextSteps` array from the resolved scaffold state. Steps are\n * ordered by the workflow a user needs to follow: configure connection →\n * (emit if not yet done) → run a starter query → docs / agent skill.\n *\n * The strings are stable and human-readable; agents wanting to act on them\n * should match on substrings (e.g. \"DATABASE_URL\") rather than exact text,\n * since copy may evolve.\n */\nexport function buildNextSteps(options: {\n  readonly target: 'postgres' | 'mongodb';\n  readonly contractEmitted: boolean;\n  readonly emitCommand: string;\n  readonly schemaPath: string;\n  /**\n   * Whether the project-level `@prisma-next/skills` install actually ran\n   * and succeeded during this `init`. When false (the user passed\n   * `--no-skill` or `--no-install`, so the install was skipped), the\n   * \"registered with your agent runtime\" step is omitted — the skip is\n   * already surfaced in the warnings array with a manual-install hint.\n   */\n  readonly skillRegistered: boolean;\n}): string[] {\n  const steps: string[] = [];\n  let stepNumber = 1;\n  const push = (text: string): void => {\n    steps.push(`${stepNumber}. ${text}`);\n    stepNumber += 1;\n  };\n  push('Set DATABASE_URL in your environment (export it or add it to .env).');\n  if (!options.contractEmitted) {\n    push(`Emit the contract: \\`${options.emitCommand}\\``);\n    push(`Edit your schema at ${options.schemaPath}, then re-run the emit command.`);\n  } else {\n    push(`Edit your schema at ${options.schemaPath}, then re-run \\`${options.emitCommand}\\`.`);\n  }\n  push('Open prisma-next.md for a quick reference on how to write your first typed query.');\n  if (options.skillRegistered) {\n    push(\n      '@prisma-next/skills is registered with your agent runtime — open the project in your IDE and ask the agent to add a model, run a query, or plan a migration.',\n    );\n  }\n  return steps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,MAAa,mBAAmB,KAAK;CACnC,IAAI;CACJ,QAAQ;CACR,WAAW;CACX,YAAY;CACZ,cAAc;;;;;;;;CAQd,cAAc;CACd,mBAAmB;EACjB,SAAS;EACT,MAAM;EACN,SAAS;EACV;CACD,iBAAiB;CACjB,WAAW;CACX,UAAU;CACX,CAAC;;;;;;;AAUF,SAAgB,eAAe,QAA4B;CACzD,OAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;;;;;;;;;AAUxC,SAAgB,gBAAgB,IAAgB,QAAoB,OAA0B;CAC5F,IAAI,MAAM,SAAS,MAAM,MACvB;CAGF,KAAK,MAAM,WAAW,OAAO,UAC3B,GAAG,KAAK,QAAQ;CAGlB,MAAM,QAAkB,EAAE;CAC1B,MAAM,KAAK,cAAc,OAAO,SAAS;CACzC,MAAM,KAAK,cAAc,OAAO,YAAY;CAC5C,MAAM,KAAK,cAAc,OAAO,aAAa;CAC7C,MAAM,KAAK,GAAG;CACd,MAAM,KAAK,iBAAiB;CAC5B,KAAK,MAAM,QAAQ,OAAO,cACxB,MAAM,KAAK,OAAO,OAAO;CAG3B,IAAI,OAAO,aAAa,SAAS,GAAG;EAClC,MAAM,KAAK,GAAG;EACd,MAAM,KAAK,4CAA4C;EACvD,KAAK,MAAM,QAAQ,OAAO,cACxB,MAAM,KAAK,OAAO,OAAO;;CAI7B,IAAI,CAAC,OAAO,kBAAkB,SAAS;EACrC,MAAM,KAAK,GAAG;EACd,MAAM,KAAK,sBAAsB;EACjC,KAAK,MAAM,OAAO,OAAO,kBAAkB,MACzC,MAAM,KAAK,OAAO,MAAM;EAE1B,KAAK,MAAM,OAAO,OAAO,kBAAkB,SACzC,MAAM,KAAK,OAAO,IAAI,QAAQ;;CAIlC,MAAM,KAAK,GAAG;CACd,MAAM,KAAK,cAAc;CACzB,KAAK,MAAM,QAAQ,OAAO,WACxB,MAAM,KAAK,KAAK,OAAO;CAGzB,GAAG,KAAK,MAAM,KAAK,KAAK,EAAE,OAAO;;;;;;;;;;;AAYnC,SAAgB,eAAe,SAalB;CACX,MAAM,QAAkB,EAAE;CAC1B,IAAI,aAAa;CACjB,MAAM,QAAQ,SAAuB;EACnC,MAAM,KAAK,GAAG,WAAW,IAAI,OAAO;EACpC,cAAc;;CAEhB,KAAK,sEAAsE;CAC3E,IAAI,CAAC,QAAQ,iBAAiB;EAC5B,KAAK,wBAAwB,QAAQ,YAAY,IAAI;EACrD,KAAK,uBAAuB,QAAQ,WAAW,iCAAiC;QAEhF,KAAK,uBAAuB,QAAQ,WAAW,kBAAkB,QAAQ,YAAY,KAAK;CAE5F,KAAK,oFAAoF;CACzF,IAAI,QAAQ,iBACV,KACE,+JACD;CAEH,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prisma-next",
-  "version": "0.7.0",
+  "version": "0.8.0-dev.2",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
@@ -14,6 +14,14 @@
   "dependencies": {
     "@clack/prompts": "^1.3.0",
     "@dagrejs/dagre": "^3.0.0",
+    "@prisma-next/config": "0.8.0-dev.2",
+    "@prisma-next/contract": "0.8.0-dev.2",
+    "@prisma-next/emitter": "0.8.0-dev.2",
+    "@prisma-next/errors": "0.8.0-dev.2",
+    "@prisma-next/framework-components": "0.8.0-dev.2",
+    "@prisma-next/migration-tools": "0.8.0-dev.2",
+    "@prisma-next/psl-printer": "0.8.0-dev.2",
+    "@prisma-next/utils": "0.8.0-dev.2",
     "arktype": "^2.1.29",
     "c12": "^3.3.4",
     "clipanion": "4.0.0-rc.4",
@@ -26,18 +34,10 @@
     "pathe": "^2.0.3",
     "string-width": "^8.2.1",
     "strip-ansi": "^7.2.0",
-    "wrap-ansi": "^10.0.0",
-    "@prisma-next/config": "0.7.0",
-    "@prisma-next/contract": "0.7.0",
-    "@prisma-next/emitter": "0.7.0",
-    "@prisma-next/errors": "0.7.0",
-    "@prisma-next/framework-components": "0.7.0",
-    "@prisma-next/migration-tools": "0.7.0",
-    "@prisma-next/psl-printer": "0.7.0",
-    "@prisma-next/utils": "0.7.0"
+    "wrap-ansi": "^10.0.0"
   },
   "devDependencies": {
-    "@prisma-next/cli": "0.7.0"
+    "@prisma-next/cli": "0.8.0-dev.2"
   },
   "publishConfig": {
     "access": "public"

package/dist/agent-skill-mongo.md

@@ -1,138 +0,0 @@
-# Prisma Next — project skill
-
-This project uses **Prisma Next** with **MongoDB** via `@prisma-next/mongo`. Prisma Next lets the user define data models in a contract file and query them with a fully typed ORM.
-
-## Files
-
-- **Contract**: `{{schemaPath}}` ({{authoringLabel}} authoring) — the user's data models. Edit this to add or change models.
-- **Config**: `prisma-next.config.ts` — tells the CLI where the contract is and how to connect to the database. Loads `.env` via `dotenv/config`.
-- **Database client**: `{{schemaDir}}/db.ts` — `import { db } from '{{dbImportPath}}'`. This is the entry point for all queries.
-- **Generated files** (do not edit by hand):
-  - `{{schemaDir}}/contract.json` — compiled contract, used at runtime
-  - `{{schemaDir}}/contract.d.ts` — TypeScript types for the contract, used for autocomplete and type checking
-
-## Commands
-
-- `{{pkgRun}} contract emit` — regenerate `contract.json` and `contract.d.ts` after changing the contract
-- `{{pkgRun}} db init` — bootstrap a database to match the contract (creates collections, indexes, constraints). Additive only — won't drop existing structures.
-- `{{pkgRun}} db update` — update the database to match the current contract. Prompts for confirmation on destructive changes. Use `--dry-run` to preview.
-- `{{pkgRun}} migration plan` — create a new migration from contract changes (offline, no database needed). Use `--name <slug>` to name it.
-- `{{pkgRun}} migration apply` — apply pending migrations to the database
-- `{{pkgRun}} migration status` — show which migrations are applied and which are pending
-- `{{pkgRun}} migration show <name>` — show details of a specific migration
-
-## How to write queries
-
-Use the ORM (`db.orm`). Each root accessor is the lowercased plural form emitted by `prisma-next contract emit` (typically the `@@map`-ped collection name) — for `model User { @@map("users") }` use `db.orm.users`, for `model Post { @@map("posts") }` use `db.orm.posts`. The Mongo facade has no raw-SQL surface. Two escape hatches exist for cases the ORM can't express; both are covered under "Escape hatches" below.
-
-```typescript
-import { db } from '{{dbImportPath}}';
-
-// Find one record
-const user = await db.orm.users
-  .where({ email: 'alice@example.com' })
-  .first();
-// Returns { _id: ObjectId; email: string; ... } | null
-
-// Find multiple records — `.all()` returns an AsyncIterableResult, consume
-// either as an async iterable (below) or by `await`ing it to materialise an Array.
-for await (const user of db.orm.users
-  .select('_id', 'email')
-  .take(10)
-  .all()) {
-  // Each `user` is { _id: ObjectId; email: string }
-}
-// Returns AsyncIterableResult<{ _id: ObjectId; email: string }>
-
-// Filter, order, limit
-const recentPosts = await db.orm.posts
-  .where({ authorId: userId })
-  .orderBy({ createdAt: -1 })
-  .select('_id', 'title', 'createdAt')
-  .take(50)
-  .all();
-
-// Include relations (reference relations only — embedded relations come back automatically)
-const usersWithPosts = await db.orm.users
-  .select('_id', 'email')
-  .include('posts')
-  .take(10)
-  .all();
-```
-
-### Key ORM methods
-
-- `.where({ field: value, ... })` — filter records by an equality object. Pass a raw filter expression for `$gt`/`$in`/`$regex` etc.
-- `.select('field1', 'field2', ...)` — pick which fields to return
-- `.orderBy({ field: 1 | -1 })` — sort results (1 = ascending, -1 = descending)
-- `.take(n)` / `.skip(n)` — limit and offset
-- `.all()` — execute and return all matching records as an `AsyncIterableResult`
-- `.first()` — execute with limit 1 and return the first matching row, or `null`
-- `.include('relationName')` — eager-load a reference relation (`$lookup`); embedded relations are already part of the row
-- `.variant('VariantName')` — narrow a polymorphic collection to a discriminator value
-
-## Escape hatches
-
-The ORM covers the common cases. When you genuinely need something it can't express, prefer these — in order — over reaching for `db.runtime()` (which is an internal executor surface, not a `mongodb`-driver handle):
-
-1. **Typed raw aggregations — `db.query`.** The facade exposes a `db.query` builder that runs aggregation pipelines through the same runtime + middleware + codec stack as `db.orm`, so results stay typed against the contract. Use this for `$lookup`/`$facet`/`$graphLookup`/window-function pipelines that the ORM doesn't surface.
-
-2. **Direct `mongodb` driver control — `mongoClient` binding.** If you need a raw `MongoClient` (e.g. for transactions, change streams, sessions, or a driver feature Prisma Next doesn't expose), construct one yourself and pass it to `mongo({ mongoClient, dbName, contractJson })`. Your code keeps the `MongoClient` reference and uses it directly, while the same `db` object still gives you the typed ORM surface:
-
-   ```typescript
-   import { MongoClient } from 'mongodb';
-   import mongo from '@prisma-next/mongo/runtime';
-   import type { Contract } from './contract.d';
-   import contractJson from './contract.json' with { type: 'json' };
-
-   const client = new MongoClient(process.env['DATABASE_URL']!);
-   await client.connect();
-
-   export const db = mongo<Contract>({ contractJson, mongoClient: client, dbName: 'mydb' });
-
-   const session = client.startSession();
-   try {
-     await session.withTransaction(async () => {
-       await db.orm.users.createAll([{ /* ... */ }]);
-     });
-   } finally {
-     await session.endSession();
-   }
-   ```
-
-## Rules
-
-- **Never hand-edit** `contract.json` or `contract.d.ts`. Always regenerate them with `contract emit`.
-- **Always emit after contract changes.** When you modify `{{schemaPath}}`, run `{{pkgRun}} contract emit` before writing any code that depends on the new or changed models.
-- **Don't restructure `db.ts`.** It's scaffolded by init and works as-is. `db` connects lazily on the first query — there is no `db.connect(...)` step.
-- **Root accessors are emitter-driven.** Use the lowercased plural collection name (e.g. `db.orm.users`, `db.orm.posts`) — not the PascalCase model name. Re-run `{{pkgRun}} contract emit` if a new model's accessor isn't appearing on `db.orm`.
-- **Connection string** is `DATABASE_URL` in `.env`. If the user reports connection errors, check this value and the `.env` file.
-- **Transactions and change streams** require a MongoDB **replica set**. The Mongo facade does not yet expose `db.transaction(...)` — for now, use the `mongoClient` escape hatch above to drive transactions/sessions directly. See the quick reference for dev-environment options; the typed transaction API is tracked under [TML-2313](https://linear.app/prisma-company/issue/TML-2313/mongo-dev-replica-set-story-is-missing-transactions-change-streams).
-- **Don't reach for `db.runtime()`** as an escape hatch. It returns the internal executor (`MongoRuntime`), not a `mongodb` `MongoClient` or `Db`. Use `db.query` for raw aggregations and the `mongoClient` binding for direct driver control.
-
-## Workflow for common tasks
-
-**User wants to add a new model or field:**
-1. Edit `{{schemaPath}}`
-2. Run `{{pkgRun}} contract emit`
-3. Write query code using `db.orm.<collection>` (lowercased plural, see Rules above)
-
-**User wants to query data:**
-1. Import `db` from `{{dbImportPath}}`
-2. Use `db.orm.<collection>` with `.where()`, `.select()`, `.all()`, `.first()`, etc.
-
-**User wants to set up or change the database connection:**
-1. Edit `DATABASE_URL` in `.env`
-2. The config file (`prisma-next.config.ts`) reads it automatically via `dotenv/config`
-
-**User wants to set up the database for the first time:**
-1. Run `{{pkgRun}} db init`
-
-**User wants to update the database after changing the contract:**
-1. Quick path: `{{pkgRun}} db update` — compares the database to the contract and applies changes directly
-2. Migration path (for production workflows):
-   - `{{pkgRun}} migration plan --name describe-the-change` — creates a migration
-   - `{{pkgRun}} migration apply` — applies pending migrations
-
-**User wants to check what migrations need to be applied:**
-1. Run `{{pkgRun}} migration status`

package/dist/agent-skill-postgres.md

@@ -1,106 +0,0 @@
-# Prisma Next — project skill
-
-This project uses **Prisma Next** with **PostgreSQL** via `@prisma-next/postgres`. Prisma Next lets the user define data models in a contract file and query them with a fully typed ORM.
-
-## Files
-
-- **Contract**: `{{schemaPath}}` ({{authoringLabel}} authoring) — the user's data models. Edit this to add or change models.
-- **Config**: `prisma-next.config.ts` — tells the CLI where the contract is and how to connect to the database. Loads `.env` via `dotenv/config`.
-- **Database client**: `{{schemaDir}}/db.ts` — `import { db } from '{{dbImportPath}}'`. This is the entry point for all queries.
-- **Generated files** (do not edit by hand):
-  - `{{schemaDir}}/contract.json` — compiled contract, used at runtime
-  - `{{schemaDir}}/contract.d.ts` — TypeScript types for the contract, used for autocomplete and type checking
-
-## Commands
-
-- `{{pkgRun}} contract emit` — regenerate `contract.json` and `contract.d.ts` after changing the contract
-- `{{pkgRun}} db init` — bootstrap a database to match the contract (creates tables, indexes, constraints). Additive only — won't drop existing structures.
-- `{{pkgRun}} db update` — update the database to match the current contract. Prompts for confirmation on destructive changes. Use `--dry-run` to preview.
-- `{{pkgRun}} migration plan` — create a new migration from contract changes (offline, no database needed). Use `--name <slug>` to name it.
-- `{{pkgRun}} migration apply` — apply pending migrations to the database
-- `{{pkgRun}} migration status` — show which migrations are applied and which are pending
-- `{{pkgRun}} migration show <name>` — show details of a specific migration
-
-## How to write queries
-
-Always use the ORM (`db.orm`). Only fall back to `db.sql` if the user explicitly asks for raw SQL or the ORM doesn't support the operation.
-
-```typescript
-import { db } from '{{dbImportPath}}';
-
-// Find one record
-const user = await db.orm.User
-  .where(user => user.email.eq('alice@example.com'))
-  .first();
-// Returns { id: number; email: string; ... } | null
-
-// Find multiple records
-const users = await db.orm.User
-  .select('id', 'email')
-  .take(10)
-  .all();
-// Returns Array<{ id: number; email: string }>
-
-// Filter, order, limit
-const recentPosts = await db.orm.Post
-  .where(post => post.authorId.eq(userId))
-  .orderBy(post => post.createdAt.desc())
-  .select('id', 'title', 'createdAt')
-  .take(50)
-  .all();
-
-// Include relations
-const usersWithPosts = await db.orm.User
-  .select('id', 'email')
-  .include('posts', post =>
-    post.select('id', 'title').orderBy(p => p.createdAt.desc()).take(5)
-  )
-  .take(10)
-  .all();
-```
-
-### Key ORM methods
-
-- `.where(predicate)` — filter records. Predicate receives a model accessor with `.eq()`, `.neq()`, `.ilike()`, `.lt()`, `.gt()`, etc.
-- `.select('field1', 'field2', ...)` — pick which fields to return
-- `.orderBy(accessor => accessor.field.asc()` or `.desc())` — sort results
-- `.take(n)` — limit number of results
-- `.all()` — execute and return all matching records as an array
-- `.first()` — execute and return the first matching record, or `null`
-- `.first({ id: value })` — find a single record by primary key, or `null`
-- `.include('relation', builder => ...)` — eager-load a relation
-
-## Rules
-
-- **Never hand-edit** `contract.json` or `contract.d.ts`. Always regenerate them with `contract emit`.
-- **Always emit after contract changes.** When you modify `{{schemaPath}}`, run `{{pkgRun}} contract emit` before writing any code that depends on the new or changed models.
-- **Don't restructure `db.ts`.** It's scaffolded by init and works as-is.
-- **Use `db.orm` for queries**, not `db.sql`. The ORM is the primary query surface.
-- **Connection string** is `DATABASE_URL` in `.env`. If the user reports connection errors, check this value and the `.env` file.
-
-## Workflow for common tasks
-
-**User wants to add a new model or field:**
-1. Edit `{{schemaPath}}`
-2. Run `{{pkgRun}} contract emit`
-3. Write query code using `db.orm.ModelName`
-
-**User wants to query data:**
-1. Import `db` from `{{dbImportPath}}`
-2. Use `db.orm.ModelName` with `.where()`, `.select()`, `.all()`, `.first()`, etc.
-
-**User wants to set up or change the database connection:**
-1. Edit `DATABASE_URL` in `.env`
-2. The config file (`prisma-next.config.ts`) reads it automatically via `dotenv/config`
-
-**User wants to set up the database for the first time:**
-1. Run `{{pkgRun}} db init`
-
-**User wants to update the database after changing the contract:**
-1. Quick path: `{{pkgRun}} db update` — compares the database to the contract and applies changes directly
-2. Migration path (for production workflows):
-   - `{{pkgRun}} migration plan --name describe-the-change` — creates a migration
-   - `{{pkgRun}} migration apply` — applies pending migrations
-
-**User wants to check what migrations need to be applied:**
-1. Run `{{pkgRun}} migration status`