@aventara/cli 0.1.0-pilot.4 → 1.0.0-rc.0

package/dist/catalog/adapter.catalog.generated.d.ts

@@ -1,20 +0,0 @@
-export declare const ADAPTER_CATALOG: readonly [{
-    readonly id: "prisma7";
-    readonly alias: "prisma7";
-    readonly adapterPackage: "@aventara/prisma7-adapter";
-    readonly orm: {
-        readonly family: "prisma";
-        readonly label: "Prisma";
-        readonly package: "@prisma/client";
-        readonly major: 7;
-    };
-    readonly range: "^7.10.0";
-    readonly familyPackages: readonly ["prisma", "@prisma/client", "@prisma/prisma7", "@prisma/orm-*"];
-    readonly providers: readonly ["sqlite", "postgresql"];
-    readonly drivers: {
-        readonly sqlite: "@prisma/adapter-better-sqlite3";
-        readonly postgresql: "@prisma/adapter-pg";
-    };
-    readonly generators: readonly ["prisma-client"];
-    readonly bin: "aventara-prisma7-generate";
-}];

package/dist/catalog/catalog-entry.interface.d.ts

@@ -1,54 +0,0 @@
-import type { ADAPTER_CATALOG } from "./adapter.catalog.generated.js";
-/**
- * One entry per Aventara adapter package that exists: what the CLI may offer and
- * what it must refuse, every value traced to that adapter's own manifest — its
- * `aventara.adapter` declaration, its `peerDependencies` and its `bin`. The
- * entries are **generated** at this package's build by
- * `scripts/adapter-catalog.generator.ts` into `adapter.catalog.generated.ts` and
- * never edited. The CLI holds no list of ORMs, majors, providers or drivers of its
- * own.
- */
-export type CatalogEntry = {
-    /**
-     * The adapter package's ORM stem, e.g. `prisma7`: the wizard's value and the
-     * templates' key.
-     */
-    readonly id: string;
-    /**
-     * `aventara.adapter.alias`, e.g. `prisma7`: what `--orm` takes. Always
-     * `<orm><major>`, the generator refuses any other.
-     */
-    readonly alias: string;
-    /** The adapter package a project installs, e.g. `@aventara/prisma7-adapter`. */
-    readonly adapterPackage: string;
-    readonly orm: {
-        /** `aventara.adapter.orm`, e.g. `prisma`: the family the wizard groups majors under. */
-        readonly family: string;
-        /** `aventara.adapter.ormLabel`, e.g. `Prisma`: how the wizard names the family. */
-        readonly label: string;
-        /** `aventara.adapter.ormPackage`, e.g. `@prisma/client`: whose installed version selects the entry. */
-        readonly package: string;
-        /** The one major `range` admits. */
-        readonly major: number;
-    };
-    /** `peerDependencies[orm.package]`: the ORM versions the adapter supports. */
-    readonly range: string;
-    /** Packages that identify the ORM family in a project. */
-    readonly familyPackages: readonly string[];
-    /** Database providers, in the adapter's order; the first is the default. */
-    readonly providers: readonly string[];
-    /** Provider → the driver adapter package for it. */
-    readonly drivers: Readonly<Record<string, string>>;
-    /** The ORM generators whose output the adapter reads. */
-    readonly generators: readonly string[];
-    /** The adapter's generate step: its one `bin`. */
-    readonly bin: string;
-};
-export type AdapterCatalog = readonly CatalogEntry[];
-/** The generated catalog's literal type: what the template registry is checked against. */
-export type Catalog = typeof ADAPTER_CATALOG;
-export type EntryId = Catalog[number]["id"];
-/** The providers one entry declares, as literals. */
-export type ProviderOf<I extends EntryId> = Extract<Catalog[number], {
-    readonly id: I;
-}>["providers"][number];

package/dist/catalog/catalog.matcher.d.ts

@@ -1,40 +0,0 @@
-import type { AdapterCatalog, CatalogEntry } from "./catalog-entry.interface.js";
-/**
- * 1. The ORM family: the catalog entries whose family packages the project depends
- *    on (a pattern ending in `*` is a prefix).
- * 2. Every other family package installed must be of that same major — a Prisma 8
- *    CLI or an `@prisma/orm-*` beside a Prisma 7 client is a project
- *    mid-migration, refused.
- * 3. The entry for that major, or a refusal naming what exists.
- * 4. The installed version inside the entry's declared range.
- * 5. Then what the project's ORM setup declares — provider, driver, generator —
- *    against the entry's providers, drivers and generators.
- *
- * Every refusal is one sentence naming what was found and what the catalog offers.
- * Nothing has been written when one is raised.
- */
-export type MatchVerdict = {
-    readonly kind: "matched";
-    readonly entry: CatalogEntry;
-} | {
-    readonly kind: "refused";
-    readonly sentence: string;
-};
-export type InstalledOrm = {
-    /** The project's dependency names (dependencies and devDependencies). */
-    readonly dependencies: readonly string[];
-    /** The installed version of a package, or `undefined` when it is not installed. */
-    readonly installedVersion: (name: string) => string | undefined;
-    /** The command that installs the project's dependencies. */
-    readonly installCommand: string;
-};
-/** What the project's ORM setup states, read by the entry's templates. */
-export type OrmSetup = {
-    readonly provider: string | undefined;
-    readonly generator: string | undefined;
-    /** The driver-adapter packages the project depends on. */
-    readonly drivers: readonly string[];
-};
-export declare function matchInstalledOrm(catalog: AdapterCatalog, project: InstalledOrm): MatchVerdict;
-/** Step 5: the project's provider, driver and generator against what `entry` declares. */
-export declare function matchOrmSetup(entry: CatalogEntry, setup: OrmSetup): string | undefined;

package/dist/catalog/range.reader.d.ts

@@ -1,11 +0,0 @@
-/** `^7.10.0` → `7.10.0`; `>=7.10.0 <8` → `7.10.0`. */
-export declare function lowestVersionOf(range: string): string;
-/** `^12.0.1` → 12; `~6.0.2` → 6; a range with no number (`latest`, `*`) → `undefined`. */
-export declare function lowestMajorOf(range: string): number | undefined;
-/**
- * Whether an installed `version` is in a declared `range`. Reads the comparator
- * forms an adapter's peer range uses; a pre-release never satisfies (semver's rule
- * for a range whose comparators carry none). Any other form is refused rather than
- * guessed.
- */
-export declare function satisfiesRange(version: string, range: string): boolean;

package/dist/cli.d.ts

@@ -1,29 +0,0 @@
-import type { AdapterCatalog } from "./catalog/catalog-entry.interface.js";
-import { type CommandRunner } from "./run/command.runner.js";
-import { type Prompter } from "./wizard/answer.resolver.js";
-/**
- * `aventara` — the bin: `new` and `init`. A refusal is one sentence on stderr and
- * exit 1, never a stack; anything else is a defect and keeps its stack.
- *
- * `init` initializes the project in the working directory
- * (`run/init.orchestrator.ts`); `new` creates one with the pinned `nest new` and
- * then runs the same pipeline over it (`run/new.orchestrator.ts`).
- */
-export type CliIo = {
-    /** The working directory: where `init` initializes and `new` creates. */
-    readonly cwd: string;
-    readonly env: Readonly<Record<string, string | undefined>>;
-    readonly stdout: (text: string) => void;
-    readonly stderr: (text: string) => void;
-    readonly prompter: Prompter;
-    readonly runner?: CommandRunner;
-    readonly catalog?: AdapterCatalog;
-};
-export declare function runCli(argv: readonly string[], io: CliIo): Promise<number>;
-/**
- * Runs `aventara` over this process — its arguments, its terminal, its exit
- * code. Called by the bin's entry (`aventara.bin.ts`) once the Node guard has
- * admitted this Node; importing this module runs nothing, which lets `runCli`
- * be tested in process.
- */
-export declare function runFromProcess(): Promise<void>;

package/dist/command/command.parser.d.ts

@@ -1,38 +0,0 @@
-import type { AdapterCatalog } from "../catalog/catalog-entry.interface.js";
-import { type QuestionId } from "../wizard/wizard.questions.js";
-/**
- * The `aventara` command line: `new <name>` and `init`, each question's flag from
- * the wizard's table, and the options that are not questions. Unknown, misplaced
- * or repeated arguments are refused in one sentence; a flag's VALUE is the
- * question's to judge, because what is valid (`--db`'s providers) depends on the
- * catalog and on earlier answers.
- */
-export type ScaffoldCommandName = "new" | "init";
-export type ScaffoldCommand = {
-    readonly command: ScaffoldCommandName;
-    /** Raw answers by question, from flags and `new`'s positional `<name>`. */
-    readonly given: Readonly<Partial<Record<QuestionId, string>>>;
-    readonly skipInstall: boolean;
-    /** `new` only: passed through to `nest new`. */
-    readonly skipGit: boolean;
-    /** Accepts each unanswered question's default and confirms overwrites. */
-    readonly yes: boolean;
-};
-export type CliCommand = 
-/** `--help`; with `topic`, `aventara <topic> --help` (pilot.1). */
-{
-    readonly command: "help";
-    readonly topic?: ScaffoldCommandName;
-} | {
-    readonly command: "version";
-} | ScaffoldCommand;
-/** The command line cannot be understood. A refusal: one sentence, exit 1. */
-export declare class CliCommandError extends Error {
-    readonly name = "CliCommandError";
-}
-/** `aventara <command> --help` (pilot.1): that command's usage alone. */
-export declare function commandUsage(command: ScaffoldCommandName, catalog: AdapterCatalog): string;
-/** `aventara --help`: both commands, each flag with the values `catalog` offers. */
-export declare function usage(catalog: AdapterCatalog): string;
-/** @throws CliCommandError when `argv` is not a command this CLI has. */
-export declare function parseCliCommand(argv: readonly string[]): CliCommand;

package/dist/node-version.guard.d.ts

@@ -1,8 +0,0 @@
-/** The sentence a bin answers on `version`, or `undefined` when `range` admits it. */
-export declare function nodeVersionRefusal(bin: string, packageName: string, range: string, version: string): string | undefined;
-/**
- * Reads the manifest at `manifestUrl`; on a Node its `engines.node` does not
- * admit, writes the sentence to stderr, sets exit code 1 and answers `true` —
- * the bin then loads nothing else.
- */
-export declare function refuseUnsupportedNode(bin: string, manifestUrl: URL): boolean;

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

@@ -1,53 +0,0 @@
-import type { CatalogEntry } from "../catalog/catalog-entry.interface.js";
-import { type ProjectInspection } from "../project/project.inspector.js";
-import { type OrmScaffold } from "../templates/template.registry.js";
-import type { PackageManager } from "../wizard/wizard.questions.js";
-/**
- * Pure apart from reading the files it would replace.
- */
-/**
- * The name of the script that regenerates the ORM client and the discovery
- * artifact.
- */
-export declare const PREPARE_SCRIPT = "aventara:prepare";
-export type PlannedWrite = {
-    readonly path: string;
-    readonly content: string;
-    /** `create` a new file, or `replace` one whose content changes. */
-    readonly change: "create" | "replace";
-};
-export type ProjectPlan = {
-    /** What is written when the conflicts are kept as they are. */
-    readonly keeping: readonly PlannedWrite[];
-    /** What is written once the conflicts are confirmed (`--yes`, or a yes). */
-    readonly replacing: readonly PlannedWrite[];
-    /** Existing content that differs from what would be written. */
-    readonly conflicts: readonly string[];
-    readonly warnings: readonly string[];
-    /** Printed when the anchored edit could not be made. */
-    readonly instructions: string | undefined;
-    readonly nextSteps: readonly string[];
-};
-export type PlanInput = {
-    readonly inspection: ProjectInspection;
-    readonly entry: CatalogEntry;
-    readonly scaffold: OrmScaffold;
-    readonly packageManager: PackageManager;
-    /** 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. */
-    readonly wiringByHand?: string;
-    /** Said before the write, beside the planner's own. */
-    readonly warnings?: readonly string[];
-};
-/**
- * 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 declare function frontendInitCommand(packageManager: PackageManager, cliVersion: string): string;
-export declare function planInit(input: PlanInput): ProjectPlan;

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

@@ -1,5 +0,0 @@
-import type { PackageManager } from "../wizard/wizard.questions.js";
-export declare function detectPackageManager(signals: {
-    readonly lockfile?: PackageManager | undefined;
-    readonly userAgent?: string | undefined;
-}): PackageManager;

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

@@ -1,32 +0,0 @@
-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";
-/** 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. */
-export type OrmPresence = {
-    readonly kind: "absent";
-} | {
-    readonly kind: "present";
-    /** The family packages found among its dependencies. */
-    readonly packages: readonly string[];
-    /** The catalog entries whose family they belong to. */
-    readonly families: readonly CatalogEntry["orm"]["label"][];
-};
-export type ProjectInspection = {
-    readonly directory: string;
-    readonly manifest: PackageManifest;
-    readonly manifestText: string;
-    readonly moduleKind: ModuleKind;
-    /** 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. */
-    readonly usesNestConfig: boolean;
-};
-/** 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/service.detector.d.ts

@@ -1,40 +0,0 @@
-/**
- * 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()`.
- *
- * Which of them is *the* service is the caller's question (the wizard's).
- */
-export type ExportReference = {
-    /** Relative to the project root, POSIX separators. */
-    readonly file: string;
-    readonly exportName: string;
-};
-export type ServiceComposition = ExportReference & {
-    /** The member that holds the client. */
-    readonly member: string;
-};
-export type ModuleDeclaration = ExportReference & {
-    readonly providers: readonly string[];
-    readonly exports: readonly string[];
-    readonly global: boolean;
-};
-export type ServiceScan = {
-    readonly candidates: readonly ExportReference[];
-    readonly compositions: readonly ServiceComposition[];
-    readonly modules: readonly ModuleDeclaration[];
-};
-export type ClientShape = {
-    /** The client class a service extends, e.g. the ORM's generated client. */
-    readonly clientClass: string;
-    /** Whether `specifier`, imported by `file` (project-relative), is the client's module. */
-    readonly importsClient: (specifier: string, file: string) => boolean;
-    /** Directories under `src/` that hold generated code, skipped. */
-    readonly skip: readonly string[];
-};
-export declare function scanServices(directory: string, shape: ClientShape): ServiceScan;
-/** The modules that make `service` injectable elsewhere: providing and exporting it, or global. */
-export declare function modulesProviding(scan: ServiceScan, service: ExportReference): readonly ModuleDeclaration[];

package/dist/project/source.scanner.d.ts

@@ -1,16 +0,0 @@
-/**
- * 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 declare function codeMask(text: string): boolean[];
-/** Every index where `token` starts in code. */
-export declare function codeIndexes(text: string, code: boolean[], token: RegExp): number[];
-export declare const OPENERS: Readonly<Record<string, string>>;
-/** The index of the bracket closing the one at `open`, counting code brackets only. */
-export declare function closing(text: string, code: boolean[], open: number): number;
-export declare function nextCode(text: string, code: boolean[], from: number): number;

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

@@ -1,15 +0,0 @@
-/**
- * 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;
-    readonly stdout: string;
-    readonly stderr: string;
-};
-export type CommandRunner = (command: string, args: readonly string[], options: {
-    readonly cwd: string;
-}) => Promise<CommandResult>;
-export declare const runCommand: CommandRunner;

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

@@ -1,27 +0,0 @@
-import type { AdapterCatalog } from "../catalog/catalog-entry.interface.js";
-import type { ScaffoldCommand } from "../command/command.parser.js";
-import { type Prompter } from "../wizard/answer.resolver.js";
-import type { CommandRunner } from "./command.runner.js";
-/**
- * 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;
-    readonly env: Readonly<Record<string, string | undefined>>;
-    readonly stdout: (text: string) => void;
-    readonly stderr: (text: string) => void;
-    readonly prompter: Prompter;
-    readonly runner: CommandRunner;
-    readonly catalog: AdapterCatalog;
-    /** This CLI's own version. */
-    readonly aventaraVersion: string;
-    /** Next steps that come before init's own (`new`'s `cd <name>`). */
-    readonly firstSteps?: readonly string[];
-};
-/** The install step failed after the files were written. Reported, exit 1. */
-export declare class InstallFailedError extends Error {
-    readonly name = "InstallFailedError";
-}
-export declare function runInit(command: ScaffoldCommand, io: InitIo): Promise<number>;

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

@@ -1,20 +0,0 @@
-import type { ScaffoldCommand } from "../command/command.parser.js";
-import { type InitIo } from "./init.orchestrator.js";
-/**
- * `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
- * — and, after the install, the project's first commit (`scaffold.committer.ts`,
- * pilot.3).
- *
- * 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.
- */
-export declare const NEST_CLI = "@nestjs/cli@12.0.8";
-export declare const NEST_APP_MODULE_SHA256 = "fe98c4cd2552342272494652287c02e4ef58db3072fcb18513ea831c60f85778";
-export type NewIo = Omit<InitIo, "directory"> & {
-    /** Where `new` creates the project directory. */
-    readonly cwd: string;
-};
-export declare function runNew(command: ScaffoldCommand, io: NewIo): Promise<number>;

package/dist/run/scaffold.committer.d.ts

@@ -1,28 +0,0 @@
-import type { CommandRunner } from "./command.runner.js";
-/**
- * pilot.3 — `aventara new` ends with one commit of the whole scaffold, the
- * install's lockfile included, under one fixed message. `.env` is not in it: the
- * scaffold's `.gitignore` lists it (Nest's own does too). `init` never commits:
- * the project is the developer's.
- *
- * Never a failure: where a commit cannot or should not be made, one line says why
- * and the run still succeeds —
- * - git is not installed;
- * - the directory `new` ran in is inside a git work tree already (a monorepo): the
- *   project belongs to that repository, and gets no commit of its own;
- * - git has no `user.name` and `user.email` to commit as. `--skip-git` (passed to
- *   `nest new`, which then initializes no repository) makes no commit and says
- *   nothing.
- *
- * git runs through the one process seam, `CommandRunner`.
- */
-export declare const INITIAL_COMMIT_MESSAGE = "Initial Aventara Scaffold";
-/** Where `new` runs, as git sees it — read BEFORE `nest new` initializes a repository. */
-export type GitSurroundings = "no-git" | "inside-work-tree" | "outside";
-/** Whether git is installed, and whether `directory` lies in a work tree. */
-export declare function gitSurroundings(runner: CommandRunner, directory: string): Promise<GitSurroundings>;
-/**
- * Commits the project in `directory` as its first commit, or says why not: the
- * line to print, without the `aventara: ` prefix or the final period.
- */
-export declare function commitScaffold(runner: CommandRunner, directory: string, surroundings: GitSurroundings, enclosing: string): Promise<string>;

package/dist/templates/docs.links.d.ts

@@ -1,8 +0,0 @@
-/**
- * Where the public documentation lives: the one base every link the scaffold
- * writes into a project starts from. A placeholder until the docs domain is
- * settled; changing it changes only comments in the files the CLI writes.
- */
-export declare const DOCS_BASE_URL = "https://<docs-domain>";
-/** The documentation's rate-limiting section, linked from the scaffold's `main.ts`. */
-export declare const RATE_LIMITING_DOCS = "https://<docs-domain>/docs/limits-and-safety#rate-limiting";

package/dist/templates/prisma7/prisma7.templates.d.ts

@@ -1,34 +0,0 @@
-import type { PackageManifest } from "../../apply/manifest.merger.js";
-import type { ClientShape, ExportReference } from "../../project/service.detector.js";
-import { type OrmProjectFacts, type OrmScaffold, type ReuseInput, type ScaffoldInput } from "../template.registry.js";
-declare function scaffold(input: ScaffoldInput): OrmScaffold;
-declare function reuse(input: ReuseInput): OrmScaffold;
-declare function readProject(directory: string, manifest: PackageManifest): OrmProjectFacts;
-declare function clientShape(facts: OrmProjectFacts): ClientShape;
-export declare const PRISMA7_TEMPLATES: {
-    readonly providers: {
-        readonly sqlite: {
-            readonly driverClass: "PrismaBetterSqlite3";
-            readonly driverOptions: "{ url }";
-            readonly databaseUrl: "file:./dev.db";
-            readonly gitignore: readonly ["/dev.db*"];
-            readonly nativeBuilds: readonly ["@prisma/engines", "better-sqlite3", "prisma"];
-        };
-        readonly postgresql: {
-            readonly driverClass: "PrismaPg";
-            readonly driverOptions: "{ connectionString: url }";
-            readonly databaseUrl: "postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public";
-            readonly gitignore: readonly [];
-            readonly nativeBuilds: readonly ["@prisma/engines", "prisma"];
-        };
-    };
-    readonly scaffold: typeof scaffold;
-    readonly readProject: typeof readProject;
-    readonly clientShape: typeof clientShape;
-    readonly newService: {
-        readonly service: ExportReference;
-        readonly module: ExportReference;
-    };
-    readonly reuse: typeof reuse;
-};
-export {};

package/dist/templates/template.registry.d.ts

@@ -1,152 +0,0 @@
-import type { PackageManifest } from "../apply/manifest.merger.js";
-import type { CatalogEntry, EntryId, ProviderOf } from "../catalog/catalog-entry.interface.js";
-import type { ClientShape, ExportReference } from "../project/service.detector.js";
-import type { PackageManager } from "../wizard/wizard.questions.js";
-/**
- * The registry is **total** in both directions, and both are checked before a
- * project is ever scaffolded:
- * - at compile time, over the generated catalog's literal type: an entry with no
- *   template set, or a template set missing a provider its adapter declares, does
- *   not type-check;
- * - at build time, by the catalog generator: a templates directory with no
- *   adapter, or an adapter with no templates directory, fails the build.
- */
-/** What changes with the database provider an entry offers. */
-export type ProviderTemplate = {
-    /** The driver adapter's class, constructed in the written ORM service. */
-    readonly driverClass: string;
-    /** The driver class's constructor argument, given the connection string as `url`. */
-    readonly driverOptions: string;
-    /** The `DATABASE_URL` line's value; a placeholder where it cannot be known. */
-    readonly databaseUrl: string;
-    /** `.gitignore` lines this provider's files need (a SQLite database file). */
-    readonly gitignore: readonly string[];
-    /** Packages whose install scripts pnpm must be allowed to run. */
-    readonly nativeBuilds: readonly string[];
-};
-export type ModuleKind = "esm" | "cjs";
-/**
- * The entrypoint every scaffold mounts the protocol at: written into
- * `src/aventara.config.ts`, and tested by the e2e spec (pilot.1).
- */
-export declare const SCAFFOLD_ENTRYPOINT = "/api";
-/** What a template set is asked to scaffold. */
-export type ScaffoldInput = {
-    readonly entry: CatalogEntry;
-    /** One of `entry.providers`. */
-    readonly provider: string;
-    readonly moduleKind: ModuleKind;
-    readonly packageManager: PackageManager;
-};
-/**
- * What an ORM's templates contribute to a project. Everything here is the
- * ORM's; what is Nest's (the start scripts, the anchored `app.module.ts` edit,
- * `AventaraModule`'s import) and what is Aventara's (its packages, the
- * `aventara:prepare` and `postinstall` script names) is the planner's.
- */
-export type OrmScaffold = {
-    /** New, developer-owned files. */
-    readonly files: readonly {
-        readonly path: string;
-        readonly content: string;
-    }[];
-    /** `.env` entries. */
-    readonly env: Readonly<Record<string, string>>;
-    readonly gitignore: readonly string[];
-    readonly dependencies: Readonly<Record<string, string>>;
-    readonly devDependencies: Readonly<Record<string, string>>;
-    /** The command `aventara:prepare` runs. */
-    readonly prepare: string;
-    /** What the anchored `app.module.ts` edit adds: import lines, and `imports:` entries. */
-    readonly appModule: {
-        readonly imports: readonly string[];
-        readonly entries: readonly string[];
-    };
-    readonly nativeBuilds: readonly string[];
-    /** The ORM's next steps, after the install and before the server starts. */
-    readonly nextSteps: readonly string[];
-};
-/**
- * What a project's existing ORM setup states, read by the entry's templates — the
- * ORM's own file layout is template knowledge; judging it against the catalog is
- * the matcher's (`catalog.matcher.ts`).
- */
-export type OrmProjectFacts = {
-    /** The schema the generate step reads, relative to the project root. */
-    readonly schema: string;
-    readonly provider: string | undefined;
-    readonly generator: string | undefined;
-    /** The generated client's directory, relative to the project root. */
-    readonly clientOutput: string | undefined;
-    /** The driver-adapter packages the project depends on. */
-    readonly drivers: readonly string[];
-};
-/** Reusing a project's ORM setup: its schema, its output, its service. */
-export type ReuseInput = {
-    readonly entry: CatalogEntry;
-    readonly facts: OrmProjectFacts & {
-        readonly provider: string;
-        readonly clientOutput: string;
-    };
-    readonly moduleKind: ModuleKind;
-    readonly packageManager: PackageManager;
-    /** The developer's service, or the template's new one when it is to be written. */
-    readonly service: ExportReference & {
-        readonly clientMember?: string;
-    };
-    readonly module: ExportReference;
-    /** Whether `service` and `module` are the template's new file, to be written. */
-    readonly writeService: boolean;
-    /** Where the discovery artifact goes, relative to the project root. */
-    readonly artifact: string;
-};
-export type TemplateSet<I extends EntryId> = {
-    readonly providers: {
-        readonly [P in ProviderOf<I>]: ProviderTemplate;
-    };
-    readonly scaffold: (input: ScaffoldInput) => OrmScaffold;
-    /** Reads an existing setup's facts; `undefined` when there is none to read. */
-    readonly readProject: (directory: string, manifest: PackageManifest) => OrmProjectFacts;
-    /** How the developer's service is recognised in their source. */
-    readonly clientShape: (facts: OrmProjectFacts) => ClientShape;
-    /** The service init writes when the project has none: its file and names. */
-    readonly newService: {
-        readonly service: ExportReference;
-        readonly module: ExportReference;
-    };
-    /** A project with the ORM already set up: no ORM file written or edited. */
-    readonly reuse: (input: ReuseInput) => OrmScaffold;
-};
-export type TemplateRegistry = {
-    readonly [I in EntryId]: TemplateSet<I>;
-};
-export declare const TEMPLATE_REGISTRY: {
-    readonly prisma7: {
-        readonly providers: {
-            readonly sqlite: {
-                readonly driverClass: "PrismaBetterSqlite3";
-                readonly driverOptions: "{ url }";
-                readonly databaseUrl: "file:./dev.db";
-                readonly gitignore: readonly ["/dev.db*"];
-                readonly nativeBuilds: readonly ["@prisma/engines", "better-sqlite3", "prisma"];
-            };
-            readonly postgresql: {
-                readonly driverClass: "PrismaPg";
-                readonly driverOptions: "{ connectionString: url }";
-                readonly databaseUrl: "postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public";
-                readonly gitignore: readonly [];
-                readonly nativeBuilds: readonly ["@prisma/engines", "prisma"];
-            };
-        };
-        readonly scaffold: (input: ScaffoldInput) => OrmScaffold;
-        readonly readProject: (directory: string, manifest: PackageManifest) => OrmProjectFacts;
-        readonly clientShape: (facts: OrmProjectFacts) => ClientShape;
-        readonly newService: {
-            readonly service: ExportReference;
-            readonly module: ExportReference;
-        };
-        readonly reuse: (input: ReuseInput) => OrmScaffold;
-    };
-};
-/** The template set for `entry` — every catalog entry has one (checked at build). */
-export declare function templatesFor(entry: CatalogEntry): TemplateSet<EntryId>;