@aventara/cli 0.1.0-pilot.1 → 0.1.0-pilot.2

package/dist/plan/project.planner.d.ts

@@ -3,18 +3,12 @@ import { type ProjectInspection } from "../project/project.inspector.js";
 import { type OrmScaffold } from "../templates/template.registry.js";
 import type { PackageManager } from "../wizard/wizard.questions.js";
 /**
- * §4.1's `plan`: everything `aventara init` will write, decided before anything
- * is written — the files, the anchored `app.module.ts` edit (or the printed
- * instructions), the merged manifests — and every **conflict**, computed both
- * ways so the confirmation can choose. Pure apart from reading the files it
- * would replace.
- *
- * What is Nest's (its default start scripts, `AventaraModule`'s import) and what
- * is Aventara's (its packages at this CLI's version, D1; the `aventara:prepare`
- * and `postinstall` scripts, Q16-22, D2) is decided here; what is the ORM's
- * comes from its templates (D7).
+ * Pure apart from reading the files it would replace.
+ */
+/**
+ * The name of the script that regenerates the ORM client and the discovery
+ * artifact.
  */
-/** The name of the script that regenerates the ORM client and the discovery artifact (Q16-22). */
 export declare const PREPARE_SCRIPT = "aventara:prepare";
 export type PlannedWrite = {
     readonly path: string;
@@ -39,12 +33,12 @@ export type PlanInput = {
     readonly entry: CatalogEntry;
     readonly scaffold: OrmScaffold;
     readonly packageManager: PackageManager;
-    /** This CLI's version: every Aventara package is pinned to it (D1). */
+    /** This CLI's version: every Aventara package is pinned to it. */
     readonly aventaraVersion: string;
     readonly skipInstall: boolean;
     /** The current text of a project file, or `undefined` when absent. */
     readonly read: (file: string) => string | undefined;
-    /** The anchored edit is not attempted; the wiring is printed (a service holding its client, §4.4.4). */
+    /** The anchored edit is not attempted; the wiring is printed. */
     readonly wiringByHand?: string;
     /** Said before the write, beside the planner's own. */
     readonly warnings?: readonly string[];

package/dist/plan/project.planner.js

@@ -3,21 +3,7 @@ import { E2E_SPEC, spliceContractTest } from "../apply/e2e-spec.anchor.js";
 import { mergeEnvFile, mergeGitignore, mergePackageManifest, mergePnpmWorkspace, } from "../apply/manifest.merger.js";
 import { APP_MODULE, } from "../project/project.inspector.js";
 import { SCAFFOLD_ENTRYPOINT, } from "../templates/template.registry.js";
-/**
- * §4.1's `plan`: everything `aventara init` will write, decided before anything
- * is written — the files, the anchored `app.module.ts` edit (or the printed
- * instructions), the merged manifests — and every **conflict**, computed both
- * ways so the confirmation can choose. Pure apart from reading the files it
- * would replace.
- *
- * What is Nest's (its default start scripts, `AventaraModule`'s import) and what
- * is Aventara's (its packages at this CLI's version, D1; the `aventara:prepare`
- * and `postinstall` scripts, Q16-22, D2) is decided here; what is the ORM's
- * comes from its templates (D7).
- */
-/** The name of the script that regenerates the ORM client and the discovery artifact (Q16-22). */
 export const PREPARE_SCRIPT = "aventara:prepare";
-/** D3: `nest new`'s start scripts (B1), and what each becomes so `.env` reaches the server. */
 const START_SCRIPTS = {
     start: { from: "nest start", to: "nest start --env-file .env" },
     "start:dev": {
@@ -33,11 +19,6 @@ const START_SCRIPTS = {
         to: "node --env-file-if-exists=.env dist/main",
     },
 };
-/**
- * F-853: `nest new`'s e2e script per module kind (B1, B28), and the same run with
- * the `.env` the start scripts load — the e2e spec boots `AppModule`, whose
- * service needs `DATABASE_URL`, and neither vitest nor jest loads `.env`.
- */
 const E2E_SCRIPTS = {
     esm: {
         from: "vitest run --config ./vitest.config.e2e.ts",
@@ -61,12 +42,6 @@ function writeOf(path, before, after) {
             },
         ];
 }
-/**
- * pilot.1 — the frontend's first command, as the developer can run it: the
- * package manager's own one-off runner (`npx` or `pnpm dlx`), and — while this
- * CLI is a prerelease — its dist-tag, so the client comes from the same release
- * (`0.1.0-pilot.1` → `@aventara/client@pilot`). A release has no tag to name.
- */
 export function frontendInitCommand(packageManager, cliVersion) {
     const tag = /^\d+\.\d+\.\d+-([0-9A-Za-z-]+)/.exec(cliVersion)?.[1];
     const runner = packageManager === "pnpm" ? "pnpm dlx" : "npx";
@@ -87,7 +62,6 @@ export function planInit(input) {
         keeping.push(...writeOf(path, before, kept.text));
         replacing.push(...writeOf(path, before, replaced.text));
     };
-    // The ORM's new files: identical content is no change (P3), other content a conflict.
     for (const file of scaffold.files) {
         const before = input.read(file.path);
         if (before === undefined) {
@@ -111,7 +85,6 @@ export function planInit(input) {
             });
         }
     }
-    // The one edit to developer code (R2).
     const wiring = {
         imports: [
             `import { AventaraModule } from '${NEST_HOST}';`,
@@ -132,8 +105,6 @@ export function planInit(input) {
     if (edit.kind === "edited") {
         keeping.push(...writeOf(APP_MODULE, appModule, edit.text));
         replacing.push(...writeOf(APP_MODULE, appModule, edit.text));
-        // pilot.1: Nest's own e2e spec also asks for the contract — only when
-        // AventaraModule was wired in, so the test proves what it claims.
         const spec = input.read(E2E_SPEC);
         const tested = spec === undefined
             ? undefined
@@ -157,7 +128,6 @@ export function planInit(input) {
         devDependencies: scaffold.devDependencies,
         scripts: {
             [PREPARE_SCRIPT]: scaffold.prepare,
-            // D2: the generated trees are ignored and rebuilt on every install.
             postinstall: `${packageManager} run ${PREPARE_SCRIPT}`,
         },
         rewrites: inspection.usesNestConfig
@@ -168,11 +138,15 @@ export function planInit(input) {
             },
     }, replace));
     const env = input.read(".env");
-    if (Object.keys(scaffold.env).length > 0) {
+    const writesEnv = Object.keys(scaffold.env).length > 0;
+    if (writesEnv) {
         both(".env", env, (replace) => mergeEnvFile(env, scaffold.env, replace));
     }
     const gitignore = input.read(".gitignore");
-    both(".gitignore", gitignore, () => mergeGitignore(gitignore, scaffold.gitignore));
+    both(".gitignore", gitignore, () => mergeGitignore(gitignore, [
+        ...scaffold.gitignore,
+        ...(writesEnv ? [".env"] : []),
+    ]));
     if (packageManager === "pnpm" && scaffold.nativeBuilds.length > 0) {
         const workspace = input.read("pnpm-workspace.yaml");
         both("pnpm-workspace.yaml", workspace, () => mergePnpmWorkspace(workspace, scaffold.nativeBuilds));

package/dist/project/package-manager.detector.d.ts

@@ -1,11 +1,4 @@
 import type { PackageManager } from "../wizard/wizard.questions.js";
-/**
- * Q16-5's default package manager: a lockfile says what a project already uses
- * (`init`); otherwise the package manager that launched this CLI says what the
- * developer uses — `npm_config_user_agent` is `npm/…` under `npx` and
- * `npm exec`, `pnpm/…` under `pnpm dlx` and `pnpm exec`, and unset when the bin
- * runs directly (B11); otherwise npm.
- */
 export declare function detectPackageManager(signals: {
     readonly lockfile?: PackageManager | undefined;
     readonly userAgent?: string | undefined;

package/dist/project/package-manager.detector.js

@@ -1,10 +1,3 @@
-/**
- * Q16-5's default package manager: a lockfile says what a project already uses
- * (`init`); otherwise the package manager that launched this CLI says what the
- * developer uses — `npm_config_user_agent` is `npm/…` under `npx` and
- * `npm exec`, `pnpm/…` under `pnpm dlx` and `pnpm exec`, and unset when the bin
- * runs directly (B11); otherwise npm.
- */
 export function detectPackageManager(signals) {
     if (signals.lockfile !== undefined) {
         return signals.lockfile;

package/dist/project/project.inspector.d.ts

@@ -2,17 +2,11 @@ import type { PackageManifest } from "../apply/manifest.merger.js";
 import type { AdapterCatalog, CatalogEntry } from "../catalog/catalog-entry.interface.js";
 import type { ModuleKind } from "../templates/template.registry.js";
 import type { PackageManager } from "../wizard/wizard.questions.js";
-/**
- * §4.1's `inspect`: what `aventara init` needs to know about the project in the
- * working directory, read before anything is asked or written — so every
- * refusal here leaves the directory exactly as it was (it is a property of the
- * order, not of a rollback).
- */
 /** The project is not one `aventara init` serves. A refusal: one sentence, nothing written. */
 export declare class ProjectRefusedError extends Error {
     readonly name = "ProjectRefusedError";
 }
-/** The ORM a project already has, by the catalog's family packages (R14, D10). */
+/** The ORM a project already has, by the catalog's family packages. */
 export type OrmPresence = {
     readonly kind: "absent";
 } | {
@@ -30,9 +24,9 @@ export type ProjectInspection = {
     /** The package manager the lockfile names, if exactly one does. */
     readonly lockfile: PackageManager | undefined;
     readonly orm: OrmPresence;
-    /** `@nestjs/config` loads `.env` itself, so the start scripts are left alone (P5). */
+    /** `@nestjs/config` loads `.env` itself, so the start scripts are left alone. */
     readonly usesNestConfig: boolean;
 };
-/** The file the anchored edit opens (R2). */
+/** The file the anchored edit opens. */
 export declare const APP_MODULE = "src/app.module.ts";
 export declare function inspectProject(directory: string, catalog: AdapterCatalog): ProjectInspection;

package/dist/project/project.inspector.js

@@ -1,21 +1,11 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { lowestMajorOf } from "../catalog/range.reader.js";
-/**
- * §4.1's `inspect`: what `aventara init` needs to know about the project in the
- * working directory, read before anything is asked or written — so every
- * refusal here leaves the directory exactly as it was (it is a property of the
- * order, not of a rollback).
- */
-/** The project is not one `aventara init` serves. A refusal: one sentence, nothing written. */
 export class ProjectRefusedError extends Error {
     name = "ProjectRefusedError";
 }
-/** Nest 12 only (Phase 11 Q16). */
 const NEST_MAJOR = 12;
-/** D4: TypeScript 7 has no classic compiler API. */
 const FIRST_UNSUPPORTED_TYPESCRIPT = 7;
-/** The file the anchored edit opens (R2). */
 export const APP_MODULE = "src/app.module.ts";
 const LOCKFILES = [
     ["package-lock.json", "npm"],

package/dist/project/service.detector.d.ts

@@ -1,15 +1,10 @@
 /**
- * R6 — finding the developer's own ORM service, lexically, over `src/**\/*.ts`:
- * no compiler (`aventara init` may run before anything is installed).
- *
- * 1. **Candidates**: exported classes that `extends` the ORM's client class,
- *    where the file imports that class from a specifier the ORM's templates
- *    recognise (the generated client, or the ORM package).
- * 2. **Compositions**: exported classes that hold a client instead of extending
- *    one (`client = new PrismaClient(…)`, Phase 11 S7's shape) — reported with
- *    the member, never wired.
+ * 1. **Candidates**: exported classes that `extends` the ORM's client class, where
+ *    the file imports that class from a specifier the ORM's templates recognise
+ *    (the generated client, or the ORM package).
  * 3. **Modules**: each `@Module({…})`-decorated exported class with the
- *    identifiers its `providers` and `exports` list, and whether it is `@Global()`.
+ *    identifiers its `providers` and `exports` list, and whether it is
+ *    `@Global()`.
  *
  * Which of them is *the* service is the caller's question (the wizard's).
  */

package/dist/project/service.detector.js

@@ -18,7 +18,6 @@ function sourceFiles(directory, root, skip) {
             : [];
     });
 }
-/** The identifiers the array under `key`, at `object`'s own level, names (`providers: [A, B]`). */
 function arrayNames(text, code, object, key) {
     const end = closing(text, code, object);
     let depth = 0;
@@ -99,7 +98,6 @@ export function scanServices(directory, shape) {
     }
     return { candidates, compositions, modules };
 }
-/** The modules that make `service` injectable elsewhere: providing and exporting it, or global. */
 export function modulesProviding(scan, service) {
     return scan.modules.filter((module) => module.providers.includes(service.exportName) &&
         (module.exports.includes(service.exportName) || module.global));

package/dist/project/source.scanner.js

@@ -1,15 +1,5 @@
-/**
- * A lexical view of TypeScript source — enough to find decorators, classes,
- * imports and brackets **in code**, never inside a comment, a string or a
- * template literal's text — with no compiler: `aventara new` runs before
- * anything (TypeScript included) is installed in the project, and the CLI
- * carries no TypeScript of its own. Shared by the anchored `app.module.ts` edit
- * and the detection of a developer's ORM service.
- */
-/** For each character: is it code (not inside a comment, string or template text)? */
 export function codeMask(text) {
     const code = new Array(text.length).fill(true);
-    /** Open template literals' brace depths: `${` re-enters code until its `}`. */
     const templates = [];
     let braces = 0;
     let index = 0;
@@ -19,7 +9,6 @@ export function codeMask(text) {
         }
     };
     const templateText = (from) => {
-        // Scans template text from `from` until "`" (closes) or "${" (re-enters code).
         let at = from;
         while (at < text.length) {
             if (text[at] === "\\") {
@@ -88,7 +77,6 @@ export function codeMask(text) {
     }
     return code;
 }
-/** Every index where `token` starts in code. */
 export function codeIndexes(text, code, token) {
     const found = [];
     for (const match of text.matchAll(token)) {
@@ -103,7 +91,6 @@ export const OPENERS = {
     "[": "]",
     "{": "}",
 };
-/** The index of the bracket closing the one at `open`, counting code brackets only. */
 export function closing(text, code, open) {
     const stack = [];
     for (let at = open; at < text.length; at += 1) {

package/dist/run/command.runner.d.ts

@@ -1,8 +1,8 @@
 /**
- * The one external process seam (§4.2): a command, its arguments, a working
- * directory. Its stdout is always **piped**, never inherited — `nest new` asks a
- * question it has no flag for when its stdout is a terminal (B25) — and both
- * streams are collected, so a failure can be reported with what it said.
+ * The one external process seam: a command, its arguments, a working directory.
+ * Its stdout is always **piped**, never inherited — `nest new` asks a question it
+ * has no flag for when its stdout is a terminal — and both streams are collected,
+ * so a failure can be reported with what it said.
  */
 export type CommandResult = {
     readonly code: number;

package/dist/run/init.orchestrator.d.ts

@@ -3,11 +3,9 @@ import type { ScaffoldCommand } from "../command/command.parser.js";
 import { type Prompter } from "../wizard/answer.resolver.js";
 import type { CommandRunner } from "./command.runner.js";
 /**
- * `aventara init` in §4.1's order — inspect, ask, plan, confirm, and only then
- * write and install. Every step before the write reads; so a refusal anywhere
- * before it leaves the project exactly as it was. A failure after it (the
- * install) names the command, its exit code and what to re-run; nothing is
- * rolled back.
+ * Every step before the write reads; so a refusal anywhere before it leaves the
+ * project exactly as it was. A failure after it (the install) names the command,
+ * its exit code and what to re-run; nothing is rolled back.
  */
 export type InitIo = {
     readonly directory: string;
@@ -17,7 +15,7 @@ export type InitIo = {
     readonly prompter: Prompter;
     readonly runner: CommandRunner;
     readonly catalog: AdapterCatalog;
-    /** This CLI's own version (D1). */
+    /** This CLI's own version. */
     readonly aventaraVersion: string;
     /** Next steps that come before init's own (`new`'s `cd <name>`). */
     readonly firstSteps?: readonly string[];

package/dist/run/init.orchestrator.js

@@ -9,7 +9,6 @@ import { scanServices } from "../project/service.detector.js";
 import { templatesFor, } from "../templates/template.registry.js";
 import { resolveAnswers } from "../wizard/answer.resolver.js";
 import { INIT_QUESTIONS, REUSE_QUESTIONS, } from "../wizard/wizard.questions.js";
-/** The install step failed after the files were written. Reported, exit 1. */
 export class InstallFailedError extends Error {
     name = "InstallFailedError";
 }
@@ -49,7 +48,6 @@ export async function runInit(command, io) {
         prompter: io.prompter,
     });
     const writes = plan.conflicts.length === 0 ? plan.keeping : plan.replacing;
-    // The only file I/O (§4.1 `apply`).
     for (const write of writes) {
         const target = path.join(io.directory, write.path);
         mkdirSync(path.dirname(target), { recursive: true });
@@ -76,7 +74,6 @@ export async function runInit(command, io) {
     io.stdout(`Next:\n${[...(io.firstSteps ?? []), ...plan.nextSteps].map((step, index) => `  ${index + 1}. ${step}`).join("\n")}\n`);
     return 0;
 }
-/** S6 — no ORM: the ORM and database are asked, and the entry's templates write it all. */
 async function prepareFresh(command, io, inspection, detectedPackageManager) {
     const answers = await resolveAnswers(INIT_QUESTIONS, {
         given: command.given,
@@ -101,7 +98,6 @@ async function prepareFresh(command, io, inspection, detectedPackageManager) {
         warnings: [],
     };
 }
-/** The installed version of `name`, looked up the way Node resolves it: upward from the project. */
 function installedVersion(directory, name) {
     let current = directory;
     for (;;) {
@@ -117,11 +113,6 @@ function installedVersion(directory, name) {
         current = parent;
     }
 }
-/**
- * S7 — the ORM is already set up (R6, R7): the catalog entry is matched against
- * what is installed, the setup against what the entry declares, and the
- * developer's own service is found or asked for. Nothing of theirs is written.
- */
 async function prepareReuse(command, io, inspection, detectedPackageManager) {
     const dependencies = [
         ...Object.keys(inspection.manifest.dependencies ?? {}),
@@ -146,7 +137,6 @@ async function prepareReuse(command, io, inspection, detectedPackageManager) {
     if (facts.clientOutput === undefined) {
         throw new ProjectRefusedError(`this project's ${facts.generator} generator block in ${facts.schema} has no output, and the generate step reads the client from it; give it one, such as ../src/generated/${entry.orm.family}`);
     }
-    // A flag naming the ORM or database must name what the project has.
     for (const [flag, given, found] of [
         ["--orm", command.given.orm, `${entry.orm.family}@${entry.orm.major}`],
         ["--db", command.given.db, provider],
@@ -181,7 +171,6 @@ async function prepareReuse(command, io, inspection, detectedPackageManager) {
         packageManager === undefined) {
         throw new Error("the reuse questions settled without a service, module and package manager");
     }
-    // Q16-21: beside the client's output, unless that output contains it (the adapter refuses that).
     const preferred = "src/generated/aventara/discovery.artifact.ts";
     const artifact = `${preferred}/`.startsWith(`${facts.clientOutput}/`)
         ? "src/aventara/discovery.artifact.ts"
@@ -190,7 +179,7 @@ async function prepareReuse(command, io, inspection, detectedPackageManager) {
         ...(facts.clientOutput.startsWith("src/")
             ? []
             : [
-                `the ${entry.orm.label} client is generated into ${facts.clientOutput}, outside src/, which nest build does not compile (B6); your build is your own, and init does not change it`,
+                `the ${entry.orm.label} client is generated into ${facts.clientOutput}, outside src/, which nest build does not compile; your build is your own, and init does not change it`,
             ]),
         ...(service.clientMember === undefined
             ? []

package/dist/run/new.orchestrator.d.ts

@@ -1,18 +1,15 @@
 import type { ScaffoldCommand } from "../command/command.parser.js";
 import { type InitIo } from "./init.orchestrator.js";
 /**
- * `aventara new <name>` (R2, D1): the pinned `nest new`, then **exactly**
- * `aventara init`'s pipeline over the fresh project, with the wizard's answers
- * carried in — so every `new` run exercises the anchored edit, the merges and
- * the templates `init` uses.
+ * `aventara new <name>`: the pinned `nest new`, then **exactly** `aventara init`'s
+ * pipeline over the fresh project, with the wizard's answers carried in — so every
+ * `new` run exercises the anchored edit, the merges and the templates `init` uses.
  *
- * Nest authors its own scaffold (D1): the CLI never writes Nest's files. Its
- * output is pinned by digest (B24), so a `@nestjs/cli` that writes something
- * else stops the run before anything of Aventara's is written over it.
+ * Nest authors its own scaffold: the CLI never writes Nest's files. Its output is
+ * pinned by digest, so a `@nestjs/cli` that writes something else stops the run
+ * before anything of Aventara's is written over it.
  */
-/** D1: the `nest new` this CLI was measured against (B1, B24). */
 export declare const NEST_CLI = "@nestjs/cli@12.0.8";
-/** B24: `src/app.module.ts` as `@nestjs/cli` 12.0.8 writes it — the anchored edit's file. */
 export declare const NEST_APP_MODULE_SHA256 = "fe98c4cd2552342272494652287c02e4ef58db3072fcb18513ea831c60f85778";
 export type NewIo = Omit<InitIo, "directory"> & {
     /** Where `new` creates the project directory. */

package/dist/run/new.orchestrator.js

@@ -6,21 +6,8 @@ import { ProjectRefusedError } from "../project/project.inspector.js";
 import { resolveAnswers } from "../wizard/answer.resolver.js";
 import { NEW_QUESTIONS } from "../wizard/wizard.questions.js";
 import { InstallFailedError, runInit, } from "./init.orchestrator.js";
-/**
- * `aventara new <name>` (R2, D1): the pinned `nest new`, then **exactly**
- * `aventara init`'s pipeline over the fresh project, with the wizard's answers
- * carried in — so every `new` run exercises the anchored edit, the merges and
- * the templates `init` uses.
- *
- * Nest authors its own scaffold (D1): the CLI never writes Nest's files. Its
- * output is pinned by digest (B24), so a `@nestjs/cli` that writes something
- * else stops the run before anything of Aventara's is written over it.
- */
-/** D1: the `nest new` this CLI was measured against (B1, B24). */
 export const NEST_CLI = "@nestjs/cli@12.0.8";
-/** B24: `src/app.module.ts` as `@nestjs/cli` 12.0.8 writes it — the anchored edit's file. */
 export const NEST_APP_MODULE_SHA256 = "fe98c4cd2552342272494652287c02e4ef58db3072fcb18513ea831c60f85778";
-/** The command that runs a package from the registry once, per package manager (B11, B21). */
 function oneOff(packageManager) {
     return packageManager === "pnpm" ? ["pnpm", ["dlx"]] : ["npx", ["-y"]];
 }
@@ -47,8 +34,6 @@ export async function runNew(command, io) {
     if (existsSync(directory) && readdirSync(directory).length > 0) {
         throw new ProjectRefusedError(`aventara new creates ${directory}, which already exists and is not empty; choose another name, or run aventara init inside an existing project`);
     }
-    // stdout piped by the runner (B25): on a terminal, nest new asks the module
-    // system, with no flag to answer it; piped, it asks nothing and writes ESM.
     const [runner, prefix] = oneOff(packageManager);
     const args = [
         ...prefix,
@@ -82,7 +67,6 @@ export async function runNew(command, io) {
         },
         skipInstall: command.skipInstall,
         skipGit: false,
-        // A fresh project: there is nothing of the developer's to confirm over.
         yes: true,
     }, { ...io, directory, firstSteps: [`Enter the project: cd ${name}`] });
 }

package/dist/templates/prisma7/prisma7.templates.js

@@ -2,21 +2,8 @@ import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import path from "node:path";
 import { lowestVersionOf } from "../../catalog/range.reader.js";
 import { SCAFFOLD_ENTRYPOINT, } from "../template.registry.js";
-/**
- * The `prisma7` entry's templates (D7): Prisma 7 knowledge as text the CLI
- * writes and reads, keyed by the providers `@aventara/prisma7-adapter`
- * declares. Every value that is an adapter fact — the ORM package, the driver
- * per provider, the generator, the generate bin, the version floor — is read
- * from the catalog entry handed in, not restated here.
- *
- * The texts follow the Nest scaffold's formatting (prettier, `singleQuote`,
- * `trailingComma: "all"`, B1), so the project's own `format` script leaves them
- * as they are.
- */
-/** The generated client goes under `src`, where `nest build` compiles it (B6). */
 const CLIENT_OUTPUT = "src/generated/prisma";
 const SCHEMA = "prisma/schema.prisma";
-/** B5: the Prisma CLI loads either name, and `prisma7.config.ts` wins when both exist. */
 const CONFIG_FILES = ["prisma7.config.ts", "prisma.config.ts"];
 const DRIVER_PREFIX = "@prisma/adapter-";
 const NEW_SERVICE = {
@@ -33,19 +20,16 @@ const PROVIDERS = {
         driverOptions: "{ url }",
         databaseUrl: "file:./dev.db",
         gitignore: ["/dev.db*"],
-        // B9: pnpm 12 refuses these install scripts until they are allowed.
         nativeBuilds: ["@prisma/engines", "better-sqlite3", "prisma"],
     },
     postgresql: {
         driverClass: "PrismaPg",
         driverOptions: "{ connectionString: url }",
-        // `prisma init`'s own placeholder (B5); printed in the next steps, never asked (Q16-8).
         databaseUrl: "postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public",
         gitignore: [],
         nativeBuilds: ["@prisma/engines", "prisma"],
     },
 };
-/** A relative import specifier from `from` (a project file) to `to` (a project path, no extension). */
 function specifier(from, to, js) {
     const relative = path.posix.relative(path.posix.dirname(from), to);
     return `${relative.startsWith(".") ? relative : `./${relative}`}${js}`;
@@ -62,7 +46,6 @@ function schema(input) {
         `  provider = "${input.provider}"`,
         "}",
         "",
-        // R12: Prisma's `--with-model` starter (B5).
         "model User {",
         "  id    Int     @id @default(autoincrement())",
         "  email String  @unique",
@@ -71,7 +54,6 @@ function schema(input) {
         "",
     ].join("\n");
 }
-/** `prisma.config.ts` (Q16-19). Prisma does not load `.env` itself (B5). */
 function prismaConfig() {
     return [
         "import { existsSync } from 'node:fs';",
@@ -94,7 +76,6 @@ function prismaConfig() {
         "",
     ].join("\n");
 }
-/** The developer-owned service (P2: `extends PrismaClient`, so `client: prisma`). */
 function prismaService(input) {
     const provider = PROVIDERS[input.provider];
     const driver = input.entry.drivers[input.provider];
@@ -126,7 +107,6 @@ function prismaService(input) {
         "",
     ].join("\n");
 }
-/** `src/aventara.config.ts` (R8, Q16-17): the framework's configuration. */
 function aventaraConfig(input) {
     const file = "src/aventara.config.ts";
     const service = input.service.exportName;
@@ -222,7 +202,6 @@ function scaffold(input) {
         ],
         env: { DATABASE_URL: provider.databaseUrl },
         gitignore: ["/src/generated/", ...provider.gitignore],
-        // D1, D9: exactly the version floor the adapter declares; never bare `prisma`.
         dependencies: { [input.entry.orm.package]: floor, [driver]: floor },
         devDependencies: { prisma: floor },
         prepare: prepare({
@@ -270,7 +249,6 @@ function reuse(input) {
                 }),
             },
         ],
-        // R6: the developer's Prisma files, `.env` key and versions are theirs.
         env: {},
         gitignore: [`/${path.posix.dirname(input.artifact)}/`],
         dependencies: {},
@@ -287,9 +265,6 @@ function reuse(input) {
         nextSteps: [],
     };
 }
-/* ------------------------------------------------------------------ *
- * Reading an existing Prisma 7 setup (R6)                              *
- * ------------------------------------------------------------------ */
 function schemaLocation(directory, manifest) {
     for (const config of CONFIG_FILES) {
         const file = path.join(directory, config);
@@ -305,7 +280,6 @@ function schemaLocation(directory, manifest) {
         ? path.posix.normalize(prisma.schema)
         : SCHEMA;
 }
-/** The `.prisma` files of a schema path: the file, or every file in a schema folder. */
 function schemaFiles(directory, schemaPath) {
     const full = path.join(directory, schemaPath);
     if (!existsSync(full)) {
@@ -343,7 +317,6 @@ function readProject(directory, manifest) {
         for (const block of blocks(text, "generator")) {
             const declared = setting(block, "provider");
             const output = setting(block, "output");
-            // The client generator, not a second generator (a zod or docs one) beside it.
             if (generator === undefined || /^prisma-client/.test(declared ?? "")) {
                 generator = declared;
                 clientOutput =