quiver-cli 1.2.0 → 1.3.1

package/dist/cli.js

@@ -2499,6 +2499,31 @@ var init_update = __esm({
   }
 });
 
+// src/mcp/tokens.ts
+var estimateTokens, formatTokens, sumTokens;
+var init_tokens = __esm({
+  "src/mcp/tokens.ts"() {
+    "use strict";
+    init_digest();
+    estimateTokens = (tool) => Math.ceil(
+      canonicalJson({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema
+      }).length / 4
+    );
+    formatTokens = (n) => n < 1e3 ? `~${n} tok` : `~${(n / 1e3).toFixed(1)}k tok`;
+    sumTokens = (tools) => {
+      let total = 0;
+      for (const tool of Object.values(tools)) {
+        if (tool.tokens === void 0) return null;
+        total += tool.tokens;
+      }
+      return total;
+    };
+  }
+});
+
 // src/commands/list.ts
 var list_exports = {};
 __export(list_exports, {
@@ -2511,6 +2536,7 @@ var init_list = __esm({
     init_repo();
     init_io();
     init_schema();
+    init_tokens();
     init_local_config();
     init_prompts();
     truncate = (s, max) => {
@@ -2570,6 +2596,7 @@ var init_list = __esm({
                 enabled: !disabled.has(name),
                 detail: serverDetail2.get(name) ?? null,
                 toolCount: entry.tools ? Object.keys(entry.tools).length : null,
+                tokenEstimate: entry.tools ? sumTokens(entry.tools) : null,
                 authRequired: entry.authRequired ?? false
               })),
               plugins: plugins.map(({ name, entry }) => ({
@@ -2619,22 +2646,35 @@ var init_list = __esm({
             return `${n ?? "?"} tools`.length;
           })
         );
+        const tokenCell = (entry) => {
+          const total = entry.tools ? sumTokens(entry.tools) : null;
+          return total === null ? "? tok" : formatTokens(total);
+        };
+        const tokW = Math.max(...mcp.map((e) => tokenCell(e.entry).length));
         lines.push("", `  ${c.bold("mcp servers")}`);
         for (const { name, entry } of mcp) {
           const count = entry.tools ? Object.keys(entry.tools).length : null;
+          const tokenTotal = entry.tools ? sumTokens(entry.tools) : null;
           if (count === null) {
             if (entry.authRequired) needsAuth.push(name);
             else missingTools = true;
+          } else if (tokenTotal === null) {
+            missingTools = true;
           }
           const tools = padCell(
             `${count ?? "?"} tools`,
             toolW,
             count === null ? c.dim : c.green
           );
+          const tokens = padCell(
+            tokenCell(entry),
+            tokW,
+            tokenTotal === null ? c.dim : c.cyan
+          );
           const detail = serverDetail2.get(name);
           const off = disabled.has(name) ? `  ${c.yellow("disabled")}` : "";
           lines.push(
-            `    ${name.padEnd(nameW)} ${entry.transport.padEnd(5)} ${tools}` + (detail ? `  ${c.dim(detail)}` : "") + off
+            `    ${name.padEnd(nameW)} ${entry.transport.padEnd(5)} ${tools}  ${tokens}` + (detail ? `  ${c.dim(detail)}` : "") + off
           );
         }
       }
@@ -2660,7 +2700,173 @@ var init_list = __esm({
         );
       }
       if (missingTools) {
-        lines.push(`  ${c.dim("run 'quiver-cli check' to populate tool counts")}`);
+        lines.push(
+          `  ${c.dim("run 'quiver-cli check' to populate tool counts and token estimates")}`
+        );
+      }
+      lines.push("");
+      block(lines);
+    };
+  }
+});
+
+// src/commands/inspect.ts
+var inspect_exports = {};
+__export(inspect_exports, {
+  inspect: () => inspect
+});
+var truncate2, padCell2, byCost, inspect;
+var init_inspect = __esm({
+  "src/commands/inspect.ts"() {
+    "use strict";
+    init_repo();
+    init_io();
+    init_tokens();
+    init_local_config();
+    init_prompts();
+    truncate2 = (s, max) => {
+      const flat = s.replace(/\s+/g, " ").trim();
+      if (max < 1) return "";
+      return flat.length > max ? flat.slice(0, max - 1) + "\u2026" : flat;
+    };
+    padCell2 = (text, width, color) => color(text.padEnd(width));
+    byCost = (a, b) => (b.tool.tokens ?? -1) - (a.tool.tokens ?? -1) || a.name.localeCompare(b.name);
+    inspect = async (options) => {
+      const arg = options.positionals[0];
+      if (!arg) {
+        if (options.json) {
+          console.log(JSON.stringify({ ok: false, error: "missing-argument" }));
+        } else {
+          await error("Usage: quiver-cli inspect <mcp-name>");
+        }
+        process.exitCode = 1;
+        return;
+      }
+      const name = arg.startsWith("mcp:") ? arg.slice("mcp:".length) : arg;
+      const lock = readLockfile(options.targetRoot);
+      if (!lock) {
+        if (options.json) console.log(JSON.stringify({ ok: false, error: "no-lockfile" }));
+        else await error("No quiver.lock found. Run `quiver-cli init` first.");
+        process.exitCode = 1;
+        return;
+      }
+      const entry = lock.entries[`mcp:${name}`];
+      if (!entry || entry.type !== "mcp") {
+        const available = Object.keys(lock.entries).filter((id) => id.startsWith("mcp:")).map((id) => id.slice("mcp:".length)).sort();
+        if (options.json) {
+          console.log(
+            JSON.stringify({ ok: false, error: "unknown-server", available })
+          );
+        } else {
+          await error(
+            `Unknown MCP server "${name}".` + (available.length ? ` Available: ${available.join(", ")}` : "")
+          );
+        }
+        process.exitCode = 1;
+        return;
+      }
+      const mcpEntry = entry;
+      let detail = null;
+      if (repoCatalogExists(options.targetRoot)) {
+        const { catalog } = loadRepoCatalog(options.targetRoot, lock.catalog.source);
+        const cat = catalog.mcp.find((m) => m.name === name);
+        if (cat) {
+          detail = cat.server.transport === "http" ? cat.server.url : [cat.server.command, ...cat.server.args ?? []].join(" ");
+        }
+      }
+      const enabled = !disabledMcpServers(options.targetRoot).has(name);
+      const tools = mcpEntry.tools ? Object.entries(mcpEntry.tools).map(([toolName, tool]) => ({ name: toolName, tool })).sort(byCost) : null;
+      const total = mcpEntry.tools ? sumTokens(mcpEntry.tools) : null;
+      if (options.json) {
+        console.log(
+          JSON.stringify(
+            {
+              ok: true,
+              name,
+              transport: mcpEntry.transport,
+              detail,
+              enabled,
+              authRequired: mcpEntry.authRequired ?? false,
+              toolsFetchedAt: mcpEntry.toolsFetchedAt,
+              toolCount: tools ? tools.length : null,
+              tokenEstimate: total,
+              tools: tools ? tools.map(({ name: toolName, tool }) => ({
+                name: toolName,
+                description: tool.description,
+                tokens: tool.tokens ?? null,
+                inputSchemaHash: tool.inputSchemaHash
+              })) : null
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const c = palette();
+      const term = process.stdout.columns ?? 80;
+      const lines = [""];
+      lines.push(
+        `  ${c.bold(name)} ${mcpEntry.transport}` + (detail ? `  ${c.dim(detail)}` : "") + (enabled ? "" : `  ${c.yellow("disabled")}`)
+      );
+      if (!tools) {
+        lines.push("", `  ${c.dim("no tool snapshot recorded yet")}`);
+        if (mcpEntry.authRequired) {
+          lines.push(
+            `  ${c.yellow(`${name} requires OAuth`)} ${c.dim(
+              `\u2014 run 'opencode mcp auth ${name}', then 'quiver-cli check'`
+            )}`
+          );
+        } else {
+          lines.push(`  ${c.dim("run 'quiver-cli check' to introspect this server")}`);
+        }
+        lines.push("");
+        block(lines);
+        return;
+      }
+      const summary = `${tools.length} tools` + (total !== null ? ` \xB7 ${formatTokens(total)}` : "");
+      lines.push(
+        `  ${c.bold(summary)}` + (mcpEntry.toolsFetchedAt ? `  ${c.dim(`snapshot from ${mcpEntry.toolsFetchedAt}`)}` : ""),
+        ""
+      );
+      const nameW = Math.max(...tools.map((t) => t.name.length));
+      const tokW = Math.max(
+        ...tools.map(
+          ({ tool }) => (tool.tokens === void 0 ? "? tok" : formatTokens(tool.tokens)).length
+        )
+      );
+      const descMax = term - (4 + nameW + 2 + tokW + 2) - 1;
+      let missingTokens = false;
+      for (const { name: toolName, tool } of tools) {
+        if (tool.tokens === void 0) missingTokens = true;
+        const tokens = padCell2(
+          tool.tokens === void 0 ? "? tok" : formatTokens(tool.tokens),
+          tokW,
+          tool.tokens === void 0 ? c.dim : c.cyan
+        );
+        if (options.verbose) {
+          lines.push(`    ${c.bold(toolName.padEnd(nameW))}  ${tokens}`);
+          for (const descLine of tool.description.split("\n")) {
+            lines.push(`      ${c.dim(descLine)}`);
+          }
+          lines.push("");
+        } else {
+          lines.push(
+            `    ${toolName.padEnd(nameW)}  ${tokens}  ${c.dim(
+              truncate2(tool.description, descMax)
+            )}`.trimEnd()
+          );
+        }
+      }
+      if (!options.verbose) lines.push("");
+      lines.push(`  ${c.dim("token counts are chars/4 estimates of name + description + input schema")}`);
+      if (!options.verbose) {
+        lines.push(`  ${c.dim("use --verbose for full descriptions")}`);
+      }
+      if (missingTokens) {
+        lines.push(
+          `  ${c.dim("run 'quiver-cli check' to populate missing token estimates")}`
+        );
       }
       lines.push("");
       block(lines);
@@ -2839,21 +3045,34 @@ var init_opencode_auth = __esm({
 });
 
 // src/mcp/snapshot.ts
-var toSnapshot;
+var toSnapshot, backfillTokens;
 var init_snapshot = __esm({
   "src/mcp/snapshot.ts"() {
     "use strict";
     init_digest();
+    init_tokens();
     toSnapshot = (tools) => {
       const snapshot = {};
       for (const tool of tools) {
         snapshot[tool.name] = {
           description: tool.description,
-          inputSchemaHash: jsonDigest(tool.inputSchema)
+          inputSchemaHash: jsonDigest(tool.inputSchema),
+          tokens: estimateTokens(tool)
         };
       }
       return snapshot;
     };
+    backfillTokens = (stored, current) => {
+      let changed = false;
+      for (const [name, tool] of Object.entries(stored)) {
+        const estimate = current[name]?.tokens;
+        if (tool.tokens === void 0 && estimate !== void 0) {
+          tool.tokens = estimate;
+          changed = true;
+        }
+      }
+      return changed;
+    };
   }
 });
 
@@ -2867,7 +3086,7 @@ __export(check_exports, {
 });
 import { accessSync as accessSync2, constants as constants2 } from "fs";
 import { delimiter, resolve as resolve19 } from "path";
-var check, report2, driftLines, list2, recommend, summarize, authHint, hasCommand, truncate2, fail;
+var check, report2, driftLines, list2, recommend, summarize, authHint, hasCommand, truncate3, fail;
 var init_check = __esm({
   "src/commands/check.ts"() {
     "use strict";
@@ -2970,6 +3189,7 @@ var init_check = __esm({
         }
         const diff = diffSnapshots(mcpEntry.tools, current);
         if (isEmptyDiff(diff)) {
+          if (backfillTokens(mcpEntry.tools, current)) lockChanged = true;
           mcpReports.push({ id, status: "ok" });
         } else if (options.accept) {
           mcpEntry.tools = current;
@@ -3086,8 +3306,8 @@ var init_check = __esm({
           for (const d of dc) {
             lines.push(
               `  "${d.name}":
-      before: ${truncate2(d.before)}
-      after:  ${truncate2(d.after)}`
+      before: ${truncate3(d.before)}
+      after:  ${truncate3(d.after)}`
             );
           }
         }
@@ -3151,7 +3371,7 @@ var init_check = __esm({
       }
       return false;
     };
-    truncate2 = (s, max = 120) => s.length > max ? s.slice(0, max) + "\u2026" : s;
+    truncate3 = (s, max = 120) => s.length > max ? s.slice(0, max) + "\u2026" : s;
     fail = async (options, code, message) => {
       if (options.json) console.log(JSON.stringify({ ok: false, error: code }));
       else await error(message);
@@ -3661,6 +3881,7 @@ Commands:
   providers [a,b]  Change which tools get configs (claude, opencode, codex)
   update [id]      Pull newer catalog content into .agents/ (all or one entry)
   list             Show installed entries (skills, commands, plugins, MCP tool counts)
+  inspect <name>   Show an MCP server's tools with descriptions and token cost
   check            Detect drift: skill digests, provider shims, MCP tool
                    snapshots (--offline skips MCP re-introspection)
   upstream         Catalog maintenance: check source repos for skill updates
@@ -3672,8 +3893,9 @@ Commands:
 Options:
   -f, --force          Overwrite existing files
   --all, -y            Keep everything without prompting (non-interactive)
-  --json               Machine-readable output (check/upstream/list)
-  -V, --verbose        Show full tool lists and description diffs (check)
+  --json               Machine-readable output (check/upstream/list/inspect)
+  -V, --verbose        Show full tool lists and description diffs (check);
+                       full tool descriptions (inspect)
   --accept             Record the current MCP tool snapshots as the new baseline (check)
   --offline            Skip MCP re-introspection; check digests + shims only (check)
   --dry-run            Report what would change without writing (update)
@@ -3797,6 +4019,11 @@ var run = async () => {
       await list3(options);
       break;
     }
+    case "inspect": {
+      const { inspect: inspect2 } = await Promise.resolve().then(() => (init_inspect(), inspect_exports));
+      await inspect2(options);
+      break;
+    }
     case "check": {
       const { check: check2 } = await Promise.resolve().then(() => (init_check(), check_exports));
       await check2(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quiver-cli",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Compose selected skills, commands, plugins and MCP servers from a central catalog into any repo as native configs for opencode, Claude Code and Codex - with lockfile-based drift awareness.",
   "type": "module",
   "bin": {

package/template/.agents/skills/agent-browser/SKILL.md

@@ -32,6 +32,7 @@ agent-browser skills get slack             # Slack workspace automation
 agent-browser skills get dogfood           # Exploratory testing / QA / bug hunts
 agent-browser skills get derive-client     # Record a HAR, derive a standalone API client for a site
 agent-browser skills get vercel-sandbox    # agent-browser inside Vercel Sandbox microVMs
+agent-browser skills get protected-vercel-deployments  # Access protected Vercel deployments
 agent-browser skills get agentcore         # AWS Bedrock AgentCore cloud browsers
 ```
 

package/template/.agents/skills/apps/skybridge/SKILL.md

@@ -20,6 +20,8 @@ SPEC.md keeps track of the app's requirements and design decisions. Keep it up t
 
 **Migrating from Skybridge `< 0.36.x`?** → Read [migrate-to-v1.md](references/migrate-to-v1.md) first. Users may reference `skybridge >= 0.36.x` as v1.
 
+**Building an ecommerce app?** → Read [ecommerce.md](references/ecommerce.md) first.
+
 ## Setup
 
 1. **Copy template** → [copy-template.md](references/copy-template.md): when starting a new project with ready SPEC.md

package/template/.agents/skills/data/prisma-cli/SKILL.md

@@ -1,19 +1,19 @@
 ---
 name: prisma-cli
-description: Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, studio, validate, format, debug, and mcp. Use for ORM/database CLI workflows, not Prisma Compute app deployment. For Prisma Compute, `@prisma/cli app deploy`, `compute:deploy`, `create-prisma --deploy`, apps, deployments, logs, or domains, use the `prisma-compute` skill instead. Triggers on "prisma init", "prisma generate", "prisma migrate", "prisma db", "prisma studio", "prisma mcp".
+description: Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, complete, studio, validate, format, debug, and mcp. Use for ORM/database CLI workflows, not the Prisma Platform CLI. Triggers on "prisma init", "prisma generate", "prisma migrate", "prisma db", "prisma complete", "prisma studio", "prisma mcp".
 license: MIT
 metadata:
   author: prisma
-  version: "7.6.0"
+  version: "7.9.1"
 ---
 
 # Prisma CLI Reference
 
 Reference for Prisma ORM CLI commands. This skill provides guidance on command usage, options, and best practices for current Prisma ORM releases.
 
-## Boundary: Compute
+## Boundary: Platform and Compute
 
-Do not use this skill for Prisma Compute app deployment. Use `prisma-compute` for `@prisma/cli app deploy`, `compute:deploy`, `create-prisma --deploy`, Compute apps, deployments, logs, domains, and framework deploy readiness.
+Do not confuse the stable ORM command (`prisma`) with the public-beta Platform package (`@prisma/cli`, binary `prisma-cli`). Use `prisma-compute` for Compute apps and workspace auth, and `prisma-postgres` for Platform projects and databases.
 
 ## When to Apply
 
@@ -24,6 +24,7 @@ Reference this skill when:
 - Managing database state (`prisma db push/pull`)
 - Using local development database (`prisma dev`)
 - Debugging Prisma issues (`prisma debug`)
+- Generating shell completions (`prisma complete`)
 
 ## Rule Categories by Priority
 
@@ -34,19 +35,19 @@ Reference this skill when:
 | 3 | Development | HIGH | `dev` |
 | 4 | Database | HIGH | `db-` |
 | 5 | Migrations | CRITICAL | `migrate-` |
-| 6 | Utility | MEDIUM | `studio`, `validate`, `format`, `debug`, `mcp` |
+| 6 | Utility | MEDIUM | `complete`, `studio`, `validate`, `format`, `debug`, `mcp` |
 
 ## Command Categories
 
 | Category | Commands | Purpose |
 |----------|----------|---------|
-| Setup | `init` | Bootstrap new Prisma project |
+| Setup | `init` | Initialize a Prisma project |
 | Generation | `generate` | Generate Prisma Client |
 | Validation | `validate`, `format` | Schema validation and formatting |
 | Development | `dev` | Local Prisma Postgres for development |
 | Database | `db pull`, `db push`, `db seed`, `db execute` | Direct database operations |
 | Migrations | `migrate dev`, `migrate deploy`, `migrate reset`, `migrate status`, `migrate diff`, `migrate resolve` | Schema migrations |
-| Utility | `studio`, `mcp`, `version`, `debug` | Development and AI tooling |
+| Utility | `complete`, `studio`, `mcp`, `version`, `debug` | Shell, development, and AI tooling |
 
 ## Quick Reference
 
@@ -66,6 +67,7 @@ prisma init --db
 
 # Initialize with an example model
 prisma init --with-model
+
 ```
 
 ### Client Generation
@@ -178,8 +180,22 @@ prisma validate
 
 # Format schema
 prisma format
+
+# Generate shell completion code
+prisma complete zsh
 ```
 
+## AI Safety Checkpoint
+
+Prisma blocks destructive commands when it detects an AI agent until the agent has obtained explicit user consent. This covers `migrate reset`, `db push --force-reset`, and `db push --accept-data-loss`.
+
+- Explain the exact data-loss impact and ask for consent immediately before running the command.
+- Do not infer consent from earlier or unrelated messages.
+- If automation needs the consent variable, set `PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION` to the user's exact consent message. Do not invent the text.
+- The Prisma MCP server deliberately has no `migrate-reset` tool.
+
+Read `references/agent-safety.md` before any destructive Prisma command.
+
 ## Current Prisma CLI Setup
 
 ### New Configuration File
@@ -237,6 +253,8 @@ references/migrate-resolve.md - Migration resolution
 references/migrate-diff.md   - Schema diffing
 references/studio.md         - Database GUI
 references/mcp.md            - Prisma MCP server
+references/complete.md       - Shell completion generation
+references/agent-safety.md   - AI consent checkpoint for destructive commands
 references/validate.md       - Schema validation
 references/format.md         - Schema formatting
 references/debug.md          - Debug info

package/template/.agents/skills/data/prisma-cli/references/agent-safety.md

@@ -0,0 +1,27 @@
+# AI safety checkpoint for destructive commands
+
+Prisma detects common AI-agent environments and blocks these commands until the user gives explicit consent:
+
+- `prisma migrate reset`
+- `prisma db push --force-reset`
+- `prisma db push --accept-data-loss`
+
+## Required workflow
+
+1. Inspect the target database/config and explain exactly what can be deleted or reset.
+2. Ask the user for explicit consent immediately before the action.
+3. Run the command only after that consent.
+
+For an agent-run subprocess, Prisma accepts the exact consent text through:
+
+```bash
+PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION='<exact user consent message>' prisma migrate reset --force
+```
+
+The value must match the user's message exactly and must not contain added quotes or newlines. Never fabricate consent, reuse an old unrelated approval, or bypass the checkpoint by hiding agent-detection environment variables.
+
+The MCP server has no `migrate-reset` tool. Use the shell command only after consent.
+
+## Reference
+
+- [Prisma ORM 7.9.0 release](https://github.com/prisma/prisma/releases/tag/7.9.0)

package/template/.agents/skills/data/prisma-cli/references/complete.md

@@ -0,0 +1,22 @@
+# prisma complete
+
+Prints a shell completion script.
+
+```bash
+prisma complete zsh
+prisma complete bash
+prisma complete fish
+prisma complete powershell
+```
+
+For a direct global CLI installation, load the output using the shell's normal startup mechanism. For example, in zsh:
+
+```bash
+source <(prisma complete zsh)
+```
+
+Prisma also integrates with supported package-manager completion flows. `npx` and `bunx` do not themselves provide completion; invoke the installed binary or the package manager's supported execution form such as `npm exec` or `bun x`.
+
+## Reference
+
+- [Prisma ORM 7.9.0 release](https://github.com/prisma/prisma/releases/tag/7.9.0)

package/template/.agents/skills/data/prisma-cli/references/db-push.md

@@ -25,6 +25,8 @@ prisma db push [options]
 | `--config` | Custom path to your Prisma config file |
 | `--url` | Override the datasource URL from the Prisma config file |
 
+When Prisma detects an AI agent, `--force-reset` and `--accept-data-loss` require explicit user consent. Follow `agent-safety.md`; never infer or fabricate the consent text.
+
 ### Follow-up Command
 
 - Run `prisma generate` explicitly when you need refreshed client output

package/template/.agents/skills/data/prisma-cli/references/init.md

@@ -34,6 +34,9 @@ bunx --bun prisma init
 | `--output` | Define Prisma Client generator output path to use | - |
 | `--preview-feature` | Define a preview feature to use | - |
 | `--with-model` | Add example model to created schema file | - |
+| `--no-skills` | Skip the best-effort installation of Prisma agent skills | - |
+
+`prisma init` attempts to install `prisma/skills` for detected agents. This is best-effort and does not make project initialization fail. Use `--no-skills` in minimal or controlled environments.
 
 ## Examples
 

package/template/.agents/skills/data/prisma-cli/references/mcp.md

@@ -30,7 +30,8 @@ prisma mcp
 
 - Run this from the project that contains your Prisma schema and `prisma.config.ts`
 - The command is separate from Prisma Studio and does not open a browser UI
-- The MCP server wraps Prisma CLI commands. For exact behavior of commands like `migrate dev` or `migrate reset`, follow the underlying CLI command docs rather than relying only on the MCP tool descriptions.
+- The MCP server exposes `migrate-status`, `migrate-dev`, and Prisma Studio tooling. It does not expose the destructive `migrate-reset` tool; do not claim it is available or try to bypass that safety boundary.
+- For destructive shell commands, follow `agent-safety.md` and obtain explicit user consent.
 
 ## References
 

package/template/.agents/skills/data/prisma-cli/references/migrate-dev.md

@@ -31,7 +31,7 @@ prisma migrate dev [options]
 - Run `prisma generate` explicitly when you need refreshed client output
 - Run `prisma db seed` explicitly when you need seed data
 
-Note: Prisma CLI help for `7.6.0` still says `migrate dev` "trigger[s] generators", but local verification in a temp Prisma 7.6.0 project did not emit generated client files. Treat `prisma generate` as an explicit follow-up step when you need generated artifacts on disk.
+Run `prisma generate` as an explicit follow-up when you need refreshed generated artifacts. Do not rely on historical CLI help that described generators as part of `migrate dev`.
 
 ## Examples
 

package/template/.agents/skills/data/prisma-cli/references/migrate-reset.md

@@ -17,6 +17,8 @@ prisma migrate reset [options]
 
 **Warning: All data will be lost.**
 
+When Prisma detects an AI agent, this command is blocked until the user gives explicit consent. Follow `agent-safety.md`; `--force` skips the ordinary prompt but does not constitute user consent for an agent.
+
 ## Options
 
 | Option | Description |

package/template/.agents/skills/data/prisma-client-api/SKILL.md

@@ -4,7 +4,7 @@ description: Prisma Client API reference covering model queries, filters, operat
 license: MIT
 metadata:
   author: prisma
-  version: "7.6.0"
+  version: "7.9.1"
 ---
 
 # Prisma Client API Reference

package/template/.agents/skills/data/prisma-client-api/references/constructor.md

@@ -127,6 +127,19 @@ const prisma = new PrismaClient({
 })
 ```
 
+### queryPlanCacheMaxSize
+
+Use `queryPlanCacheMaxSize` to limit the in-memory query-plan cache:
+
+```typescript
+const prisma = new PrismaClient({
+  adapter,
+  queryPlanCacheMaxSize: 2_000,
+})
+```
+
+The value must be a non-negative integer. Set it to `0` to disable query-plan caching; omit it to use Prisma's default. Treat this as a process-local memory/performance control, not a database prepared-statement setting.
+
 ## Singleton Pattern
 
 Prevent multiple client instances in development:

package/template/.agents/skills/data/prisma-client-api/references/raw-queries.md

@@ -192,3 +192,7 @@ const users = await prisma.$queryRaw<Result[]>`
 `
 // createdAt is already a Date object
 ```
+
+Invalid JavaScript `Date` values passed to raw queries fail validation instead of being silently serialized as `null`. Validate date input at the application boundary; do not rely on `new Date(badValue)` reaching the database.
+
+When a driver adapter returns an unmapped database-specific error, Prisma surfaces `P2039` with the adapter's preserved original code/message. If those details are missing, fix the adapter mapping rather than parsing rendered error text.