@prisma-next/cli 0.10.0 → 0.11.0

package/dist/{init-eh2z5Tl6.mjs → init-BCJZPWE1.mjs}

@@ -1,16 +1,178 @@
-import { t as CliStructuredError } from "./cli-errors-CF60g2cG.mjs";
-import { n as formatErrorOutput, t as formatErrorJson } from "./errors-Cw6kyTyV.mjs";
-import { t as TerminalUI } from "./terminal-ui-XtOQsqe9.mjs";
+import { t as CliStructuredError } from "./cli-errors-Djtz98Vm.mjs";
+import { a as isCI, i as formatErrorOutput, r as formatErrorJson, t as createTerminalUI } from "./terminal-ui-BiB_8KNo.mjs";
 import { t as version } from "./cli.mjs";
-import { i as renderInitOutro, n as buildNextSteps, r as formatInitJson, t as InitOutputSchema } from "./output-B60Gw5fu.mjs";
+import { i as renderInitOutro, n as buildNextSteps, r as formatInitJson, t as InitOutputSchema } from "./output-BlsrGMEF.mjs";
 import { createRequire } from "node:module";
 import { basename, dirname, extname, isAbsolute, join, normalize } from "pathe";
 import * as clack from "@clack/prompts";
 import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { readUserConfig, resolveGating, writeUserConfig } from "@prisma-next/cli-telemetry";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { detect, getUserAgent } from "package-manager-detector/detect";
 import { applyEdits, modify, parse, printParseErrorCode } from "jsonc-parser";
+//#region src/commands/init/detect-package-manager.ts
+const KNOWN = new Set([
+	"pnpm",
+	"npm",
+	"yarn",
+	"bun",
+	"deno"
+]);
+/**
+* Resolves the package manager `init` should drive for `add` / `install`
+* commands. Tries, in order:
+*
+*  1. **`detect()`** — walks up from `cwd` looking for a lockfile, the
+*     `packageManager` field, the `devEngines.packageManager` field, or
+*     install metadata. This is the right answer whenever the user is
+*     anywhere inside an existing project, including a deep workspace
+*     subdirectory.
+*
+*  2. **`getUserAgent()`** — parses `npm_config_user_agent`, the env var
+*     every PM sets when it spawns a script. This catches the
+*     bare-directory case where there's no project to walk up to but the
+*     user invoked us via `pnpm dlx prisma-next init` / `bunx
+*     prisma-next init` / `yarn dlx …`. Same signal used by every
+*     `create-*` tool in the ecosystem (`create-vite`, `create-next-app`,
+*     `create-astro`, `@antfu/ni`, …).
+*
+*  3. **`npm`** — final fallback. Always present alongside Node.
+*/
+async function detectPackageManager(cwd) {
+	const detected = await detect({ cwd });
+	if (detected && KNOWN.has(detected.name)) return detected.name;
+	const userAgent = getUserAgent();
+	if (userAgent !== null && KNOWN.has(userAgent)) return userAgent;
+	return "npm";
+}
+function hasProjectManifest(cwd) {
+	return existsSync(join(cwd, "package.json")) || existsSync(join(cwd, "deno.json")) || existsSync(join(cwd, "deno.jsonc"));
+}
+function formatRunCommand(pm, bin, args) {
+	if (pm === "npm") return `npx ${bin} ${args}`;
+	if (pm === "deno") return `deno run npm:${bin} ${args}`;
+	return `${pm} ${bin} ${args}`;
+}
+function formatRunScriptCommand(pm, scriptName) {
+	switch (pm) {
+		case "deno": return `deno task ${scriptName}`;
+		case "bun": return `bun run ${scriptName}`;
+		case "pnpm": return `pnpm run ${scriptName}`;
+		case "yarn": return `yarn run ${scriptName}`;
+		default: return `npm run ${scriptName}`;
+	}
+}
+function formatAddArgs(pm, packages) {
+	if (pm === "deno") return ["add", ...packages.map((p) => `npm:${p}`)];
+	return ["add", ...packages];
+}
+function formatAddDevArgs(pm, packages) {
+	if (pm === "deno") return [
+		"add",
+		"--dev",
+		...packages.map((p) => `npm:${p}`)
+	];
+	return [
+		"add",
+		"-D",
+		...packages
+	];
+}
+//#endregion
+//#region src/commands/init/detect-pnpm-catalog.ts
+/**
+* Walks up from `baseDir` looking for `pnpm-workspace.yaml`, then scans
+* its top-level `catalog:` block for entries that match any of `packages`.
+*
+* Implements FR7.3 / Spec Decision 8 (honour-and-warn): when `init` runs
+* inside a pnpm workspace whose catalog overrides one of the packages it
+* installs, surface a structured warning so the user knows the catalog
+* version (not the published `latest`) is what ended up in their
+* `node_modules`. pnpm itself does this silently; the warning closes the
+* "looks fine, must be wrong version six months later" gap.
+*
+* Notes / scope:
+*
+* - We only inspect the unnamed top-level `catalog:` block. pnpm also
+*   supports `catalogs:` (plural — *named* catalogs referenced via
+*   `catalog:foo` specifiers); those don't apply to a vanilla
+*   `pnpm add prisma-next` invocation, so we skip them.
+* - We don't validate YAML syntax exhaustively. The file format pnpm
+*   ships is line-oriented and well-known; a minimal regex is more
+*   robust than depending on a YAML parser for one warning.
+* - We don't compare against the registry's `latest` — pnpm uses the
+*   catalog version regardless, so the warning fires whenever a match
+*   exists. The user-facing copy explains how to opt out.
+*/
+function detectPnpmCatalogOverrides(baseDir, packages) {
+	const workspaceFile = findNearestPnpmWorkspaceFile(baseDir);
+	if (workspaceFile === null) return null;
+	const catalog = extractCatalogBlock(readFileSync(workspaceFile, "utf-8"));
+	if (catalog === null) return {
+		workspaceFile,
+		entries: []
+	};
+	const wanted = new Set(packages);
+	const entries = [];
+	for (const [name, version] of catalog) if (wanted.has(name)) entries.push({
+		name,
+		version
+	});
+	return {
+		workspaceFile,
+		entries
+	};
+}
+function findNearestPnpmWorkspaceFile(baseDir) {
+	let dir = baseDir;
+	let prev = "";
+	while (dir !== prev) {
+		const candidate = join(dir, "pnpm-workspace.yaml");
+		if (existsSync(candidate)) return candidate;
+		prev = dir;
+		dir = dirname(dir);
+	}
+	return null;
+}
+/**
+* Returns the entries inside the top-level `catalog:` block as `[name, version]`
+* pairs in document order, or `null` when no `catalog:` block exists.
+*
+* The parser is intentionally minimal: it reads line-by-line, locates the
+* top-level `catalog:` line (no leading whitespace), then collects every
+* subsequent indented line of the form `<key>: <value>` until the next
+* top-level key (or end of file). Quotes around `<key>` and `<value>`
+* are stripped; comments (`#…`) are ignored.
+*/
+function extractCatalogBlock(contents) {
+	const lines = contents.split(/\r?\n/);
+	const startIdx = lines.findIndex((line) => /^catalog\s*:\s*$/.test(line));
+	if (startIdx === -1) return null;
+	const entries = [];
+	for (let i = startIdx + 1; i < lines.length; i++) {
+		const raw = lines[i] ?? "";
+		if (raw.trim() === "" || /^\s*#/.test(raw)) continue;
+		if (!/^\s/.test(raw)) break;
+		const match = raw.match(/^\s+(?:'([^']+)'|"([^"]+)"|([^:\s'"]+))\s*:\s*(.*?)\s*(?:#.*)?$/);
+		if (!match) continue;
+		const name = match[1] ?? match[2] ?? match[3];
+		if (name === void 0) continue;
+		const version = stripQuotes((match[4] ?? "").trim());
+		if (version === "") continue;
+		entries.push([name, version]);
+	}
+	return entries;
+}
+function stripQuotes(value) {
+	if (value.length >= 2) {
+		const first = value[0];
+		const last = value[value.length - 1];
+		if (first === "\"" && last === "\"" || first === "'" && last === "'") return value.slice(1, -1);
+	}
+	return value;
+}
+//#endregion
 //#region src/commands/init/errors.ts
 /**
 * Re-init in non-interactive mode without `--force`. Distinct from the
@@ -70,6 +232,26 @@ function errorInitInvalidFlagValue(options) {
 	});
 }
 /**
+* `--authoring` and `--schema-path` disagree on file extension (e.g. PSL
+* authoring with a `.ts` path). Surfaces before any scaffold files are
+* written so the project tree stays untouched.
+*/
+function errorInitAuthoringSchemaPathMismatch(options) {
+	const expectedAuthoring = options.expectedExtension === ".ts" ? "typescript" : "psl";
+	return new CliStructuredError("5014", "Authoring and schema path do not match", {
+		domain: "CLI",
+		why: `\`--authoring ${options.authoring}\` requires a schema file ending in ${options.expectedExtension}, but \`--schema-path ${options.schemaPath}\` ends in ${options.actualExtension}.`,
+		fix: `Use a matching pair, for example \`--authoring ${expectedAuthoring} --schema-path <path>${options.expectedExtension}\`, or change \`--authoring\` to match the path you supplied. You can also omit \`--schema-path\` to use the default for the chosen authoring.`,
+		docsUrl: "https://prisma-next.dev/docs/cli/init",
+		meta: {
+			authoring: options.authoring,
+			schemaPath: options.schemaPath,
+			actualExtension: options.actualExtension,
+			expectedExtension: options.expectedExtension
+		}
+	});
+}
+/**
 * The user cancelled an interactive prompt (Ctrl-C, escape, declined a
 * selection). Distinct from `errorInitReinitNeedsForce` because that path
 * applies to non-interactive mode where the user was never given the
@@ -206,367 +388,37 @@ function errorInitEmitFailed(options) {
 		domain: "CLI",
 		why: `\`prisma-next contract emit\` failed: ${options.cause}`,
 		fix: `Inspect your contract file, fix the underlying issue, then re-run \`${options.emitCommand}\`. Pass \`-v\` for the full error envelope.`,
-		docsUrl: "https://prisma-next.dev/docs/cli/contract-emit",
-		meta: {
-			filesWritten: options.filesWritten,
-			cause: options.cause
-		}
-	});
-}
-/**
-* The project-level agent-skill install (`npx skills add
-* prisma/prisma-next#v<version>`) failed after a successful dependency
-* install + emit. The project's scaffold remains on disk; the user
-* can either fix the underlying issue (network, registry, PATH) and
-* run the install command manually, or re-run `init --no-skill` to
-* proceed without the skill.
-*
-* Non-rolling-back, matching the existing install/emit failure
-* semantics. Maps to exit code `6 = SKILL_INSTALL_FAILED`.
-*/
-function errorInitSkillInstallFailed(options) {
-	return new CliStructuredError("5013", "Failed to install Prisma Next skills", {
-		domain: "CLI",
-		why: `\`${options.skillInstallCommand}\` exited with an error: ${options.cause}`,
-		fix: `Either:
-  - Re-run \`prisma-next init --no-skill${options.filesWritten.length > 0 ? " --force" : ""}\` to skip the skill install for this run, or\n  - Fix the underlying issue (network, npm registry, \`npx skills\` on PATH) and install manually:\n      ${options.skillInstallCommand}`,
-		docsUrl: "https://prisma-next.dev/docs/cli/init#agent-skill",
-		meta: {
-			filesWritten: options.filesWritten,
-			skillInstallCommand: options.skillInstallCommand,
-			cause: options.cause
-		}
-	});
-}
-//#endregion
-//#region src/commands/init/agent-skill-install.ts
-const exec = promisify(execFile);
-/**
-* Default base for the GitHub-URL form `<owner>/<repo>` consumed by
-* upstream `skills add`. Each `SkillSource` joins this base with its
-* own subpath (and optional `#ref` for version-pinned clusters).
-*/
-const DEFAULT_AGENT_SKILL_BASE = "prisma/prisma-next";
-const DEFAULT_AGENT_SKILL_SOURCES = [
-	{
-		subpath: "skills",
-		ref: "cli",
-		description: "usage skills (version-locked to installed Prisma Next)"
-	},
-	{
-		subpath: "skills/upgrade",
-		ref: null,
-		description: "upgrade skill (always tracks `main`)"
-	},
-	{
-		subpath: "skills/extension-author",
-		ref: null,
-		description: "extension-author skill (always tracks `main`)"
-	}
-];
-/**
-* Test-only escape hatch for pinning the install base to a local
-* checkout. Production runs leave this unset, so installs always use
-* `DEFAULT_AGENT_SKILL_BASE`.
-*
-* When set to an absolute filesystem path (typical for tests), the
-* `#ref` fragment is dropped — local-path mode in upstream's CLI does
-* not accept refs, and the local clone has whatever content the test
-* checked into it anyway. When set to anything else (e.g. a fork name
-* `myuser/prisma-next`), the ref policy is preserved.
-*/
-function resolveAgentSkillBase() {
-	const override = process.env["PRISMA_NEXT_SKILLS_BASE"]?.trim();
-	return override && override.length > 0 ? override : DEFAULT_AGENT_SKILL_BASE;
-}
-function isLocalPath(base) {
-	return base.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(base);
-}
-/**
-* Build the `<base>/<subpath>[#ref]` URL the `skills` CLI will
-* resolve. Exported for unit tests so the per-source format can be
-* asserted without going through the full install loop.
-*/
-function formatSkillSourceUrl(source) {
-	const base = resolveAgentSkillBase();
-	const url = `${base}/${source.subpath}`;
-	if (source.ref === null) return url;
-	if (isLocalPath(base)) return url;
-	if (source.ref === "cli") return `${url}#v${version}`;
-	return url;
-}
-/**
-* The skill-install command for one source, formatted for the
-* project's detected package manager. `npx`/`pnpm dlx`/`bunx` are
-* interchangeable to the user; we pick the variant that matches the
-* rest of the install step so a single project consistently uses one
-* runner.
-*
-* `--all` auto-selects every skill in the cluster and every detected
-* agent runtime, skipping the multi-select prompts the `skills` CLI
-* shows by default. A non-interactive scaffold step cannot present
-* prompts.
-*
-* Exported for unit tests so the per-PM dispatch can be asserted
-* without a live subprocess.
-*/
-function formatSkillInstallCommand(pm, source) {
-	return formatPackageManagerCommand(pm, [
-		"skills@latest",
-		"add",
-		formatSkillSourceUrl(source),
-		"--all"
-	]);
-}
-/**
-* `skills add --all` should cover Claude Code, but upstream currently skips
-* project-local Claude symlinks when `.claude/` does not already exist. Run
-* the explicit Claude Code install as well so fresh projects get
-* `.claude/skills` without asking users to create that folder first.
-*/
-function formatClaudeSkillInstallCommand(pm, source) {
-	return formatPackageManagerCommand(pm, [
-		"skills@latest",
-		"add",
-		formatSkillSourceUrl(source),
-		"--agent",
-		"claude-code",
-		"--skill",
-		"'*'",
-		"-y"
-	]);
-}
-function formatPackageManagerCommand(pm, args) {
-	switch (pm) {
-		case "pnpm": return `pnpm dlx ${args.join(" ")}`;
-		case "yarn": return `yarn dlx ${args.join(" ")}`;
-		case "bun": return `bunx ${args.join(" ")}`;
-		case "deno": return `deno run -A npm:${args.join(" ")}`;
-		case "npm": return `npx ${args.join(" ")}`;
-	}
-}
-/**
-* Parse the project-pm-formatted command into an exec call. The
-* format-then-parse split keeps the user-facing command string the same
-* as the surface the structured error advertises, so a user who copies
-* the error's `fix` line gets the same invocation that init just
-* attempted. Single quotes are preserved in the display form so `*` is
-* safe to copy into a shell, then stripped before `execFile`.
-*/
-function commandToExec(command) {
-	const tokens = (command.match(/'[^']*'|\S+/g) ?? []).map((token) => token.startsWith("'") && token.endsWith("'") ? token.slice(1, -1) : token);
-	return {
-		file: tokens[0] ?? "npx",
-		args: tokens.slice(1)
-	};
-}
-/**
-* Runs the project-level skill install for every source in
-* `DEFAULT_AGENT_SKILL_SOURCES`, in order. Returns
-* `{ ok: true, commands }` on success; throws a structured
-* `errorInitSkillInstallFailed` on the first failure (subsequent
-* sources are not attempted — the user opted into Prisma Next by
-* running `init` and a partial install would leave the project in an
-* ambiguous state). The throw is intentionally fatal — project-level
-* skill install is unconditional (modulo `--no-skill`).
-*/
-async function runProjectLevelSkillInstall(ctx) {
-	const commands = [];
-	const installCommands = DEFAULT_AGENT_SKILL_SOURCES.flatMap((source) => [formatSkillInstallCommand(ctx.pm, source), formatClaudeSkillInstallCommand(ctx.pm, source)]);
-	for (const command of installCommands) {
-		const { file, args } = commandToExec(command);
-		try {
-			await exec(file, args, { cwd: ctx.baseDir });
-			commands.push(command);
-		} catch (err) {
-			throw errorInitSkillInstallFailed({
-				skillInstallCommand: command,
-				filesWritten: ctx.filesWritten,
-				cause: redactSecrets$1(readChildStderr$1(err)) || (err instanceof Error ? err.message : String(err))
-			});
-		}
-	}
-	return {
-		ok: true,
-		commands
-	};
-}
-function readChildStderr$1(err) {
-	if (err instanceof Error && "stderr" in err) return String(err.stderr ?? "");
-	return "";
-}
-/**
-* Strips credentials from a `scheme://user:pass@host/...` URL anywhere
-* in `stderr`. Package-manager stderr regularly contains credentialed
-* registry URLs (private npm registries, GitHub Packages tokens), and
-* those bubble into the structured `errorInitSkillInstallFailed`
-* envelope, which ends up in logs and CI output. Redact at the
-* boundary so we never re-emit a secret.
-*
-* Exported for unit tests.
-*/
-function redactSecrets$1(stderr) {
-	if (!stderr) return stderr;
-	return stderr.replace(/([a-zA-Z][a-zA-Z0-9+.-]*:\/\/)([^/@\s]+)@/g, "$1***@");
-}
-/**
-* Hand-rolled skill stub path that init must not leave behind. Removed
-* on every init run so a project's `.agents/skills/prisma-next/` does
-* not shadow the installed Prisma Next skill cluster.
-*/
-const LEGACY_SKILL_FILE = ".agents/skills/prisma-next/SKILL.md";
-//#endregion
-//#region src/commands/init/detect-package-manager.ts
-const KNOWN = new Set([
-	"pnpm",
-	"npm",
-	"yarn",
-	"bun",
-	"deno"
-]);
-/**
-* Resolves the package manager `init` should drive for `add` / `install`
-* commands. Tries, in order:
-*
-*  1. **`detect()`** — walks up from `cwd` looking for a lockfile, the
-*     `packageManager` field, the `devEngines.packageManager` field, or
-*     install metadata. This is the right answer whenever the user is
-*     anywhere inside an existing project, including a deep workspace
-*     subdirectory.
-*
-*  2. **`getUserAgent()`** — parses `npm_config_user_agent`, the env var
-*     every PM sets when it spawns a script. This catches the
-*     bare-directory case where there's no project to walk up to but the
-*     user invoked us via `pnpm dlx prisma-next init` / `bunx
-*     prisma-next init` / `yarn dlx …`. Same signal used by every
-*     `create-*` tool in the ecosystem (`create-vite`, `create-next-app`,
-*     `create-astro`, `@antfu/ni`, …).
-*
-*  3. **`npm`** — final fallback. Always present alongside Node.
-*/
-async function detectPackageManager(cwd) {
-	const detected = await detect({ cwd });
-	if (detected && KNOWN.has(detected.name)) return detected.name;
-	const userAgent = getUserAgent();
-	if (userAgent !== null && KNOWN.has(userAgent)) return userAgent;
-	return "npm";
-}
-function hasProjectManifest(cwd) {
-	return existsSync(join(cwd, "package.json")) || existsSync(join(cwd, "deno.json")) || existsSync(join(cwd, "deno.jsonc"));
-}
-function formatRunCommand(pm, bin, args) {
-	if (pm === "npm") return `npx ${bin} ${args}`;
-	if (pm === "deno") return `deno run npm:${bin} ${args}`;
-	return `${pm} ${bin} ${args}`;
-}
-function formatAddArgs(pm, packages) {
-	if (pm === "deno") return ["add", ...packages.map((p) => `npm:${p}`)];
-	return ["add", ...packages];
-}
-function formatAddDevArgs(pm, packages) {
-	if (pm === "deno") return [
-		"add",
-		"--dev",
-		...packages.map((p) => `npm:${p}`)
-	];
-	return [
-		"add",
-		"-D",
-		...packages
-	];
-}
-//#endregion
-//#region src/commands/init/detect-pnpm-catalog.ts
-/**
-* Walks up from `baseDir` looking for `pnpm-workspace.yaml`, then scans
-* its top-level `catalog:` block for entries that match any of `packages`.
-*
-* Implements FR7.3 / Spec Decision 8 (honour-and-warn): when `init` runs
-* inside a pnpm workspace whose catalog overrides one of the packages it
-* installs, surface a structured warning so the user knows the catalog
-* version (not the published `latest`) is what ended up in their
-* `node_modules`. pnpm itself does this silently; the warning closes the
-* "looks fine, must be wrong version six months later" gap.
-*
-* Notes / scope:
-*
-* - We only inspect the unnamed top-level `catalog:` block. pnpm also
-*   supports `catalogs:` (plural — *named* catalogs referenced via
-*   `catalog:foo` specifiers); those don't apply to a vanilla
-*   `pnpm add prisma-next` invocation, so we skip them.
-* - We don't validate YAML syntax exhaustively. The file format pnpm
-*   ships is line-oriented and well-known; a minimal regex is more
-*   robust than depending on a YAML parser for one warning.
-* - We don't compare against the registry's `latest` — pnpm uses the
-*   catalog version regardless, so the warning fires whenever a match
-*   exists. The user-facing copy explains how to opt out.
-*/
-function detectPnpmCatalogOverrides(baseDir, packages) {
-	const workspaceFile = findNearestPnpmWorkspaceFile(baseDir);
-	if (workspaceFile === null) return null;
-	const catalog = extractCatalogBlock(readFileSync(workspaceFile, "utf-8"));
-	if (catalog === null) return {
-		workspaceFile,
-		entries: []
-	};
-	const wanted = new Set(packages);
-	const entries = [];
-	for (const [name, version] of catalog) if (wanted.has(name)) entries.push({
-		name,
-		version
+		docsUrl: "https://prisma-next.dev/docs/cli/contract-emit",
+		meta: {
+			filesWritten: options.filesWritten,
+			cause: options.cause
+		}
 	});
-	return {
-		workspaceFile,
-		entries
-	};
-}
-function findNearestPnpmWorkspaceFile(baseDir) {
-	let dir = baseDir;
-	let prev = "";
-	while (dir !== prev) {
-		const candidate = join(dir, "pnpm-workspace.yaml");
-		if (existsSync(candidate)) return candidate;
-		prev = dir;
-		dir = dirname(dir);
-	}
-	return null;
 }
 /**
-* Returns the entries inside the top-level `catalog:` block as `[name, version]`
-* pairs in document order, or `null` when no `catalog:` block exists.
+* The project-level skills install (`npx skills add
+* prisma/prisma-next#v<version>`) failed after a successful dependency
+* install + emit. The project's scaffold remains on disk; the user
+* can either fix the underlying issue (network, registry, PATH) and
+* run the install command manually, or re-run `init --no-skill` to
+* proceed without the skill.
 *
-* The parser is intentionally minimal: it reads line-by-line, locates the
-* top-level `catalog:` line (no leading whitespace), then collects every
-* subsequent indented line of the form `<key>: <value>` until the next
-* top-level key (or end of file). Quotes around `<key>` and `<value>`
-* are stripped; comments (`#…`) are ignored.
+* Non-rolling-back, matching the existing install/emit failure
+* semantics. Maps to exit code `6 = SKILL_INSTALL_FAILED`.
 */
-function extractCatalogBlock(contents) {
-	const lines = contents.split(/\r?\n/);
-	const startIdx = lines.findIndex((line) => /^catalog\s*:\s*$/.test(line));
-	if (startIdx === -1) return null;
-	const entries = [];
-	for (let i = startIdx + 1; i < lines.length; i++) {
-		const raw = lines[i] ?? "";
-		if (raw.trim() === "" || /^\s*#/.test(raw)) continue;
-		if (!/^\s/.test(raw)) break;
-		const match = raw.match(/^\s+(?:'([^']+)'|"([^"]+)"|([^:\s'"]+))\s*:\s*(.*?)\s*(?:#.*)?$/);
-		if (!match) continue;
-		const name = match[1] ?? match[2] ?? match[3];
-		if (name === void 0) continue;
-		const version = stripQuotes((match[4] ?? "").trim());
-		if (version === "") continue;
-		entries.push([name, version]);
-	}
-	return entries;
-}
-function stripQuotes(value) {
-	if (value.length >= 2) {
-		const first = value[0];
-		const last = value[value.length - 1];
-		if (first === "\"" && last === "\"" || first === "'" && last === "'") return value.slice(1, -1);
-	}
-	return value;
+function errorInitSkillInstallFailed(options) {
+	return new CliStructuredError("5013", "Failed to install Prisma Next skills", {
+		domain: "CLI",
+		why: `\`${options.skillInstallCommand}\` exited with an error: ${options.cause}`,
+		fix: `Either:
+  - Re-run \`prisma-next init --no-skill${options.filesWritten.length > 0 ? " --force" : ""}\` to skip the skill install for this run, or\n  - Fix the underlying issue (network, npm registry, \`npx skills\` on PATH) and install manually:\n      ${options.skillInstallCommand}`,
+		docsUrl: "https://prisma-next.dev/docs/cli/init#skills",
+		meta: {
+			filesWritten: options.filesWritten,
+			skillInstallCommand: options.skillInstallCommand,
+			cause: options.cause
+		}
+	});
 }
 //#endregion
 //#region src/commands/init/hygiene-gitattributes.ts
@@ -814,18 +666,20 @@ function schemaSample(target, authoring) {
 function schemaSamplePslPostgres() {
 	return `\`\`\`prisma
 model User {
-  id    Int     @id @default(autoincrement())
-  email String  @unique
-  name  String?
+  id       Int     @id @default(autoincrement())
+  email    String  @unique
+  username String?
+  name     String?
 }
 \`\`\``;
 }
 function schemaSamplePslMongo() {
 	return `\`\`\`prisma
 model User {
-  id    ObjectId @id @map("_id")
-  email String   @unique
-  name  String?
+  id       ObjectId @id @map("_id")
+  email    String   @unique
+  username String?
+  name     String?
   @@map("users")
 }
 \`\`\``;
@@ -833,17 +687,16 @@ model User {
 function schemaSampleTsPostgres() {
 	return `\`\`\`typescript
 import { defineContract } from '@prisma-next/postgres/contract-builder';
-import sqlFamily from '@prisma-next/postgres/family';
-import postgresTarget from '@prisma-next/postgres/target';
 
 export const contract = defineContract(
-  { family: sqlFamily, target: postgresTarget },
+  {},
   ({ field, model }) => ({
     models: {
       User: model('User', {
         fields: {
           id: field.id.uuidv7(),
           email: field.text().unique(),
+          username: field.text().optional(),
           name: field.text().optional(),
         },
       }),
@@ -855,11 +708,9 @@ export const contract = defineContract(
 function schemaSampleTsMongo() {
 	return `\`\`\`typescript
 import { defineContract } from '@prisma-next/mongo/contract-builder';
-import mongoFamily from '@prisma-next/mongo/family';
-import mongoTarget from '@prisma-next/mongo/target';
 
 export const contract = defineContract(
-  { family: mongoFamily, target: mongoTarget },
+  {},
   ({ field, model }) => ({
     models: {
       User: model('User', {
@@ -867,6 +718,7 @@ export const contract = defineContract(
         fields: {
           _id: field.objectId(),
           email: field.string(),
+          username: field.string().optional(),
           name: field.string().optional(),
         },
       }),
@@ -881,6 +733,7 @@ function starterSchemaPslPostgres() {
 model User {
   id        Int      @id @default(autoincrement())
   email     String   @unique
+  username  String?
   name      String?
   posts     Post[]
   createdAt DateTime @default(now())
@@ -902,10 +755,11 @@ function starterSchemaPslMongo() {
 	return `// use prisma-next
 
 model User {
-  id    ObjectId @id @map("_id")
-  email String   @unique
-  name  String?
-  posts Post[]
+  id       ObjectId @id @map("_id")
+  email    String   @unique
+  username String?
+  name     String?
+  posts    Post[]
   @@map("users")
 }
 
@@ -921,17 +775,16 @@ model Post {
 }
 function starterSchemaTsPostgres() {
 	return `import { defineContract } from '@prisma-next/postgres/contract-builder';
-import sqlFamily from '@prisma-next/postgres/family';
-import postgresTarget from '@prisma-next/postgres/target';
 
 export const contract = defineContract(
-  { family: sqlFamily, target: postgresTarget },
+  {},
   ({ field, model, rel }) => ({
     models: {
       User: model('User', {
         fields: {
           id: field.id.uuidv7(),
           email: field.text().unique(),
+          username: field.text().optional(),
           name: field.text().optional(),
           createdAt: field.temporal.createdAt(),
           updatedAt: field.temporal.updatedAt(),
@@ -961,11 +814,9 @@ export const contract = defineContract(
 }
 function starterSchemaTsMongo() {
 	return `import { defineContract } from '@prisma-next/mongo/contract-builder';
-import mongoFamily from '@prisma-next/mongo/family';
-import mongoTarget from '@prisma-next/mongo/target';
 
 export const contract = defineContract(
-  { family: mongoFamily, target: mongoTarget },
+  {},
   ({ field, model, rel }) => ({
     models: {
       User: model('User', {
@@ -973,6 +824,7 @@ export const contract = defineContract(
         fields: {
           _id: field.objectId(),
           email: field.string(),
+          username: field.string().optional(),
           name: field.string().optional(),
         },
         relations: {
@@ -1042,6 +894,11 @@ const AUTHORING_VALUES = new Map([
 	["typescript", "typescript"],
 	["ts", "typescript"]
 ]);
+const TELEMETRY_CONSENT_MESSAGE = [
+	"Help us prioritize features by sharing anonymous CLI usage data?",
+	"The telemetry implementation is open source and fully transparent.",
+	"(packages/1-framework/3-tooling/cli-telemetry and apps/telemetry-backend)."
+].join(" ");
 /**
 * Resolves every required input for `runInit`. In interactive mode, missing
 * inputs are prompted via clack; in non-interactive mode, missing required
@@ -1089,6 +946,10 @@ async function resolveInitInputs(ctx) {
 		canPrompt,
 		autoAcceptPrompts
 	});
+	const enableTelemetry = await resolveTelemetryConsent({
+		canPrompt,
+		autoAcceptPrompts
+	});
 	const installProjectSkill = options.skill !== false;
 	return {
 		target: finalTarget,
@@ -1100,9 +961,49 @@ async function resolveInitInputs(ctx) {
 		strictProbe: Boolean(options.strictProbe),
 		reinit,
 		removePreviousFacade,
+		enableTelemetry,
 		installProjectSkill
 	};
 }
+/**
+* The interactive telemetry consent prompt. Shown as the last
+* question of the `init` sequence iff:
+*   1. `canPrompt === true` (interactive stdin / stdout combo),
+*   2. `autoAcceptPrompts === false` (the user did not pass `--yes`),
+*   3. neither telemetry env opt-out is active,
+*   4. the process is not running in CI,
+*   5. the stored `enableTelemetry` value is `undefined` (the user
+*      has never been asked, or skipped the prompt previously).
+*
+* Outside that intersection the function returns `null` and leaves the
+* stored preference untouched. Inside it, the user's answer is
+* persisted via `writeUserConfig({ enableTelemetry })` before this
+* function returns; on an affirmative answer `writeUserConfig`
+* generates and stores the v4 `installationId` in the same write.
+*
+* The wording names CLI usage data and points to the open-source
+* client/backend paths. Default value is `true` to match precedent
+* and to make the consent answer a single keystroke once it's been
+* disclosed.
+*/
+async function resolveTelemetryConsent(opts) {
+	if (!opts.canPrompt || opts.autoAcceptPrompts || isCI()) return null;
+	const config = readUserConfig();
+	const gating = resolveGating({
+		env: process.env,
+		config
+	});
+	if (!gating.enabled && gating.reason === "env-override") return null;
+	if (config.enableTelemetry !== void 0) return null;
+	const result = await clack.confirm({
+		message: TELEMETRY_CONSENT_MESSAGE,
+		initialValue: true,
+		output: process.stderr
+	});
+	if (clack.isCancel(result)) throw errorInitUserAborted();
+	writeUserConfig({ enableTelemetry: Boolean(result) });
+	return Boolean(result);
+}
 async function resolveWriteEnv(opts) {
 	if (opts.flag !== void 0) return Boolean(opts.flag);
 	if (!opts.canPrompt || opts.autoAcceptPrompts) return false;
@@ -1214,10 +1115,11 @@ function validateSchemaPath(value, authoring) {
 	});
 	const ext = extname(trimmed).toLowerCase();
 	const expected = authoring === "typescript" ? ".ts" : ".prisma";
-	if (ext !== expected) throw errorInitInvalidFlagValue({
-		flag: "schema-path",
-		value,
-		allowed: [`<file path ending in ${expected} for --authoring ${authoring}>`]
+	if (ext !== expected) throw errorInitAuthoringSchemaPathMismatch({
+		authoring,
+		schemaPath: trimmed,
+		actualExtension: ext.length > 0 ? ext : "(none)",
+		expectedExtension: expected
 	});
 	return normalize(trimmed);
 }
@@ -1511,6 +1413,189 @@ function removeDependency(existing, depName) {
 	return `${JSON.stringify(parsed, null, 2)}${trailingNewline}`;
 }
 //#endregion
+//#region src/commands/init/skill-install.ts
+const exec = promisify(execFile);
+/**
+* Default base for the GitHub-URL form `<owner>/<repo>` consumed by
+* upstream `skills add`. Each `SkillSource` joins this base with its
+* own subpath (and optional `#ref` for version-pinned clusters).
+*/
+const DEFAULT_SKILL_BASE = "prisma/prisma-next";
+const DEFAULT_SKILL_SOURCES = [
+	{
+		subpath: "skills",
+		ref: "cli",
+		description: "usage skills (version-locked to installed Prisma Next)"
+	},
+	{
+		subpath: "skills/upgrade",
+		ref: null,
+		description: "upgrade skill (always tracks `main`)"
+	},
+	{
+		subpath: "skills/extension-author",
+		ref: null,
+		description: "extension-author skill (always tracks `main`)"
+	}
+];
+/**
+* Test-only escape hatch for pinning the install base to a local
+* checkout. Production runs leave this unset, so installs always use
+* `DEFAULT_SKILL_BASE`.
+*
+* When set to an absolute filesystem path (typical for tests), the
+* `#ref` fragment is dropped — local-path mode in upstream's CLI does
+* not accept refs, and the local clone has whatever content the test
+* checked into it anyway. When set to anything else (e.g. a fork name
+* `myuser/prisma-next`), the ref policy is preserved.
+*/
+function resolveAgentSkillBase() {
+	const override = process.env["PRISMA_NEXT_SKILLS_BASE"]?.trim();
+	return override && override.length > 0 ? override : DEFAULT_SKILL_BASE;
+}
+function isLocalPath(base) {
+	return base.startsWith("/") || /^[a-zA-Z]:[\\/]/.test(base);
+}
+/**
+* Agents passed to every project-level init install. Upstream `skills add`
+* is the source of truth for per-agent install behaviour; the CLI lists
+* every supported runtime on one invocation and delegates the rest.
+*/
+const DEFAULT_SKILL_AGENTS = [
+	"cursor",
+	"claude-code",
+	"codex",
+	"windsurf"
+];
+/**
+* Build the `<base>/<subpath>[#ref]` URL the `skills` CLI will
+* resolve. Exported for unit tests so the per-source format can be
+* asserted without going through the full install loop.
+*/
+function formatSkillSourceUrl(source) {
+	const base = resolveAgentSkillBase();
+	const url = `${base}/${source.subpath}`;
+	if (source.ref === null) return url;
+	if (isLocalPath(base)) return url;
+	if (source.ref === "cli") return `${url}#v${version}`;
+	return url;
+}
+/**
+* The skill-install command for one source, formatted for the
+* project's detected package manager. `npx`/`pnpm dlx`/`bunx` are
+* interchangeable to the user; we pick the variant that matches the
+* rest of the install step so a single project consistently uses one
+* runner.
+*
+* `--agent` takes space-separated slugs on one flag; `--skill '*'` and `-y`
+* skip the multi-select prompts a non-interactive scaffold step cannot show.
+*
+* Exported for unit tests so the per-PM dispatch can be asserted
+* without a live subprocess.
+*/
+function formatSkillInstallCommand(args) {
+	const agents = args.agents ?? DEFAULT_SKILL_AGENTS;
+	const cliArgs = [
+		"skills@latest",
+		"add",
+		formatSkillSourceUrl(args.source),
+		"--agent",
+		...agents,
+		"--skill",
+		"'*'",
+		"-y"
+	];
+	return formatPackageManagerCommand(args.pm, cliArgs);
+}
+/**
+* Ordered skill-install commands for one init run. Exported for unit tests.
+*/
+function resolveProjectSkillInstallCommands(pm) {
+	return DEFAULT_SKILL_SOURCES.map((source) => formatSkillInstallCommand({
+		pm,
+		source
+	}));
+}
+function formatPackageManagerCommand(pm, args) {
+	switch (pm) {
+		case "pnpm": return `pnpm dlx ${args.join(" ")}`;
+		case "yarn": return `yarn dlx ${args.join(" ")}`;
+		case "bun": return `bunx ${args.join(" ")}`;
+		case "deno": return `deno run -A npm:${args.join(" ")}`;
+		case "npm": return `npx ${args.join(" ")}`;
+	}
+}
+/**
+* Parse the project-pm-formatted command into an exec call. The
+* format-then-parse split keeps the user-facing command string the same
+* as the surface the structured error advertises, so a user who copies
+* the error's `fix` line gets the same invocation that init just
+* attempted. Single quotes are preserved in the display form so `*` is
+* safe to copy into a shell, then stripped before `execFile`.
+*/
+function commandToExec(command) {
+	const tokens = (command.match(/'[^']*'|\S+/g) ?? []).map((token) => token.startsWith("'") && token.endsWith("'") ? token.slice(1, -1) : token);
+	return {
+		file: tokens[0] ?? "npx",
+		args: tokens.slice(1)
+	};
+}
+/**
+* Runs the project-level skill install for every source in
+* `DEFAULT_SKILL_SOURCES`, in order. Returns
+* `{ ok: true, commands }` on success; throws a structured
+* `errorInitSkillInstallFailed` on the first failure (subsequent
+* sources are not attempted — the user opted into Prisma Next by
+* running `init` and a partial install would leave the project in an
+* ambiguous state). The throw is intentionally fatal — project-level
+* skill install is unconditional (modulo `--no-skill`).
+*/
+async function runProjectLevelSkillInstall(ctx) {
+	const commands = [];
+	const installCommands = resolveProjectSkillInstallCommands(ctx.pm);
+	for (const command of installCommands) {
+		const { file, args } = commandToExec(command);
+		try {
+			await exec(file, args, { cwd: ctx.baseDir });
+			commands.push(command);
+		} catch (err) {
+			throw errorInitSkillInstallFailed({
+				skillInstallCommand: command,
+				filesWritten: ctx.filesWritten,
+				cause: redactSecrets$1(readChildStderr$1(err)) || (err instanceof Error ? err.message : String(err))
+			});
+		}
+	}
+	return {
+		ok: true,
+		commands
+	};
+}
+function readChildStderr$1(err) {
+	if (err instanceof Error && "stderr" in err) return String(err.stderr ?? "");
+	return "";
+}
+/**
+* Strips credentials from a `scheme://user:pass@host/...` URL anywhere
+* in `stderr`. Package-manager stderr regularly contains credentialed
+* registry URLs (private npm registries, GitHub Packages tokens), and
+* those bubble into the structured `errorInitSkillInstallFailed`
+* envelope, which ends up in logs and CI output. Redact at the
+* boundary so we never re-emit a secret.
+*
+* Exported for unit tests.
+*/
+function redactSecrets$1(stderr) {
+	if (!stderr) return stderr;
+	return stderr.replace(/([a-zA-Z][a-zA-Z0-9+.-]*:\/\/)([^/@\s]+)@/g, "$1***@");
+}
+/**
+* Hand-rolled skill stub path that init must not leave behind. Removed
+* on every init run so a project's `.agents/skills/prisma-next/` does
+* not shadow the installed Prisma Next skill cluster.
+*/
+const LEGACY_SKILL_FILE = ".agents/skills/prisma-next/SKILL.md";
+//#endregion
 //#region src/commands/init/templates/env.ts
 /**
 * The minimum supported server version for each target (FR8.1). The
@@ -1548,7 +1633,12 @@ function envPlaceholderBody(target) {
 	lines.push(`# Requires ${label} >= ${minVersion}.`);
 	lines.push("");
 	if (target === "postgres") lines.push("DATABASE_URL=\"postgresql://user:password@localhost:5432/mydb\"");
-	else lines.push("DATABASE_URL=\"mongodb://localhost:27017/mydb\"");
+	else {
+		lines.push("# Standalone local mongod / `docker run mongo:7` — no replica set required for first-run queries.");
+		lines.push("# Transactions and change streams need a replica set; add ?replicaSet=... only after initiating one.");
+		lines.push("");
+		lines.push("DATABASE_URL=\"mongodb://user:password@localhost:27017/mydb\"");
+	}
 	lines.push("");
 	return lines.join("\n");
 }
@@ -1634,6 +1724,54 @@ function requirementsBlock(target) {
 	].join("\n");
 }
 //#endregion
+//#region src/commands/init/templates/readme.ts
+const sharedVariables = [
+	"projectName",
+	"contractPath",
+	"runDev",
+	"runContractEmit"
+];
+const postgresVariables = [
+	...sharedVariables,
+	"runDbInit",
+	"runDbUpdate",
+	"runMigrationPlan",
+	"runMigrate",
+	"runDbSeed"
+];
+const mongoVariables = [
+	...sharedVariables,
+	"runDbUp",
+	"runDbDown",
+	"runDbReset",
+	"runMigrationPlan",
+	"runMigrate",
+	"runDbSeed"
+];
+function minimalProjectReadmeMd(target, schemaPath, projectName, pm) {
+	const run = (script) => formatRunScriptCommand(pm, script);
+	const shared = {
+		projectName,
+		contractPath: schemaPath,
+		runDev: run("dev"),
+		runContractEmit: run("contract:emit"),
+		runMigrationPlan: run("migration:plan"),
+		runMigrate: run("migrate"),
+		runDbSeed: run("db:seed")
+	};
+	if (target === "mongo") return renderTemplate("readme-mongo.md", mongoVariables, {
+		...shared,
+		runDbUp: run("db:up"),
+		runDbDown: run("db:down"),
+		runDbReset: run("db:reset")
+	});
+	return renderTemplate("readme-postgres.md", postgresVariables, {
+		...shared,
+		runDbInit: run("db:init"),
+		runDbUpdate: run("db:update")
+	});
+}
+//#endregion
 //#region src/commands/init/templates/tsconfig.ts
 /**
 * Compiler options the scaffolded `prisma-next.config.ts` and `db.ts` need
@@ -1782,7 +1920,7 @@ function mergeTypesArray(existing) {
 * structured CLI errors raised at every phase (input resolution, install,
 * emit) and renders them via the same UI surface as success output
 * (`--json` to stdout, human to stderr). Exit codes follow the documented
-* stable set in `./exit-codes.ts` (FR1.6) and the
+* stable set in `./exit-codes.ts` and the
 * [Style Guide § Exit Codes](../../../../../../../docs/CLI%20Style%20Guide.md#exit-codes).
 *
 * Layered for testability: the action handler in `./index.ts` is
@@ -1790,11 +1928,8 @@ function mergeTypesArray(existing) {
 * function does no flag parsing of its own.
 */
 async function runInit(baseDir, runOptions) {
-	const { options, flags, canPrompt, probeOverrides } = runOptions;
-	const ui = new TerminalUI({
-		color: flags.color,
-		interactive: flags.interactive
-	});
+	const { options, flags, canPrompt, probeOverrides, afterFirstTelemetryConsent } = runOptions;
+	const ui = createTerminalUI(flags);
 	const warnings = [];
 	const filesWritten = [];
 	const filesDeleted = [];
@@ -1811,6 +1946,9 @@ async function runInit(baseDir, runOptions) {
 		if (CliStructuredError.is(error)) return emitError(ui, flags, error);
 		throw error;
 	}
+	if (inputs.enableTelemetry === true && afterFirstTelemetryConsent !== void 0) try {
+		await afterFirstTelemetryConsent(inputs);
+	} catch {}
 	const pm = await detectPackageManager(baseDir);
 	const pkgRun = formatRunCommand(pm, "prisma-next", "").trimEnd();
 	const schemaDir = dirname(inputs.schemaPath);
@@ -1920,6 +2058,13 @@ async function runInit(baseDir, runOptions) {
 		if (typeWarning !== null) warnings.push(typeWarning);
 		if (synthesisePackageJson) warnings.push("No package.json found in the target directory; created a minimal one. Edit `name` / `version` to taste.");
 	}
+	if (existsSync(join(baseDir, "src/index.ts"))) if (!existsSync(join(baseDir, "README.md"))) {
+		const rawName = parsedPackageJson !== null && typeof parsedPackageJson["name"] === "string" ? parsedPackageJson["name"] : basename(baseDir);
+		filesToWrite.push({
+			path: "README.md",
+			content: minimalProjectReadmeMd(inputs.target, inputs.schemaPath, sanitisePackageName(rawName), pm)
+		});
+	} else warnings.push("README.md already exists; leaving it untouched.");
 	for (const file of filesToWrite) {
 		const fullPath = join(baseDir, file.path);
 		mkdirSync(dirname(fullPath), { recursive: true });
@@ -1983,10 +2128,12 @@ async function runInit(baseDir, runOptions) {
 			filesWritten
 		}));
 	}
-	const manualProjectSkillSummary = DEFAULT_AGENT_SKILL_SOURCES.flatMap((source) => [formatSkillInstallCommand(install.effectivePm, source), formatClaudeSkillInstallCommand(install.effectivePm, source)]).map((c) => `\`${c}\``).join(" && ");
+	const manualProjectSkillSummary = DEFAULT_SKILL_SOURCES.map((source) => formatSkillInstallCommand({
+		pm: install.effectivePm,
+		source
+	})).map((c) => `\`${c}\``).join(" && ");
 	let skillRegistered = false;
-	if (!inputs.installProjectSkill) warnings.push(`Skipped Prisma Next agent-skill install (--no-skill). To install the skills later, run: ${manualProjectSkillSummary}`);
-	else if (install.skipped) warnings.push(`Skipped Prisma Next agent-skill install because --no-install was passed. After you run install manually, install the skills with: ${manualProjectSkillSummary}`);
+	if (!inputs.installProjectSkill) warnings.push(`Skipped Prisma Next skills install (--no-skill). To install the skills later, run: ${manualProjectSkillSummary}`);
 	else {
 		const spinner = ui.spinner();
 		spinner.start("Registering Prisma Next skills with the agent runtime...");
@@ -2077,7 +2224,8 @@ function exitCodeForError(error) {
 		case "5005":
 		case "5010":
 		case "5011":
-		case "5012": return 2;
+		case "5012":
+		case "5014": return 2;
 		case "5006": return 3;
 		case "5007": return 4;
 		case "5008": return 5;
@@ -2299,7 +2447,7 @@ async function runEmit(ctx) {
 	const spinner = ctx.ui.spinner();
 	spinner.start("Emitting contract...");
 	try {
-		const { executeContractEmit } = await import("./contract-emit-iynA3BCA.mjs").then((n) => n.t);
+		const { executeContractEmit } = await import("./contract-emit-bcrpT-wD.mjs").then((n) => n.t);
 		await executeContractEmit({ configPath: join(ctx.baseDir, "prisma-next.config.ts") });
 		spinner.stop("Contract emitted");
 	} catch (err) {
@@ -2352,4 +2500,4 @@ function sanitisePackageName(raw) {
 //#endregion
 export { runInit };
 
-//# sourceMappingURL=init-eh2z5Tl6.mjs.map
+//# sourceMappingURL=init-BCJZPWE1.mjs.map