@c9up/ream 0.2.25 → 0.2.26

package/dist/console/make/commands.js

@@ -0,0 +1,252 @@
+/**
+ * The `make:` commands.
+ *
+ * They used to live in the `ream` binary, which meant Rust had to render their
+ * stubs — and rendering a stub means evaluating `{{#if resourceful}}`, which is
+ * JavaScript. Two renderers is two behaviours waiting to drift, so the
+ * generators moved to where the engine already is, the way `make:migration`
+ * moved to atlas.
+ *
+ * One class per command, built from the generator table: Adonis ships a class
+ * per command too, and the table is what keeps ten of them from being ten
+ * copies. `--force` and the skip-rather-than-clobber rule are Adonis'.
+ * `--dry-run` and `--json` are ours, and they are why `@c9up/ream-mcp` can
+ * show a plan before anything is written.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand } from '../BaseCommand.js';
+import { args, flags } from '../decorators.js';
+import Eject from './eject.js';
+import { flush, outcomePayload, plannedFile } from './flush.js';
+import { GENERATORS, generatorFor } from './generators.js';
+import { nameProblem } from './naming.js';
+import { renderStubFor } from './resolve.js';
+/**
+ * Validate the names and render the stub. Shared by the single-kind commands
+ * and by `make:module`, so all four files are checked before the first write.
+ */
+function prepare(generator, module, name, extra, cwd) {
+    for (const [label, value] of [
+        ['module', module],
+        ['name', name],
+    ]) {
+        if (value === undefined)
+            continue;
+        const problem = nameProblem(value);
+        if (problem !== undefined)
+            return { error: `${label} "${value}": ${problem}` };
+    }
+    const state = generator.state(name, {
+        ...(module === undefined ? {} : { module }),
+        ...(extra.stack === undefined ? {} : { stack: extra.stack }),
+        ...(extra.event === undefined ? {} : { event: extra.event }),
+    });
+    try {
+        const rendered = renderStubFor(generator.kind, state, cwd);
+        return {
+            file: plannedFile(rendered.path, rendered.contents, cwd),
+            published: rendered.published,
+        };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * Write the plan and report it — as JSON when asked, as Adonis' action lines
+ * otherwise. `--json` prints nothing else: its whole contract is that the last
+ * line of stdout is the payload, and a stray warning above it is how that
+ * breaks.
+ */
+function report(command, entries, warnings, options) {
+    const outcome = flush(entries, warnings, options);
+    if (options.json) {
+        process.stdout.write(`${JSON.stringify(outcomePayload(outcome))}\n`);
+        return;
+    }
+    if (outcome.status === 'planned') {
+        for (const file of outcome.files) {
+            // The path AND the contents: a dry run that showed only the path would
+            // not answer the question it is asked.
+            command.logger.info(`${file.path}${file.exists ? ' (exists)' : ''} — dry run`);
+            command.logger.log(file.content);
+        }
+    }
+    else {
+        for (const file of [...outcome.createdFiles, ...outcome.modifiedFiles]) {
+            command.logger.action(`create ${file}`).succeeded();
+        }
+        for (const file of outcome.skippedFiles) {
+            command.logger.action(`create ${file}`).skipped('file already exists, use --force');
+        }
+    }
+    for (const warning of warnings)
+        command.logger.warning(warning);
+}
+/** Build the command class for one generator. */
+function makeCommand(generator) {
+    class MakeCommand extends BaseCommand {
+        static commandName = generator.commandName;
+        static description = generator.description;
+        // Filesystem only: scaffolding a file must not need a booted application,
+        // let alone a reachable database.
+        static options = { startApp: false };
+        async run() {
+            // Two positionals for a module-scoped generator, one for the rest.
+            const module = generator.moduleScoped ? this.first : undefined;
+            const name = generator.moduleScoped ? (this.second ?? '') : this.first;
+            if (generator.moduleScoped && this.second === undefined) {
+                this.logger.error(`${generator.commandName} takes a module and a name`);
+                this.exitCode = 1;
+                return;
+            }
+            const cwd = process.cwd();
+            const prepared = prepare(generator, module, name, {
+                ...(this.stack === undefined ? {} : { stack: this.stack }),
+                ...(this.event === undefined ? {} : { event: this.event }),
+            }, cwd);
+            if ('error' in prepared) {
+                this.logger.error(prepared.error);
+                this.exitCode = 1;
+                return;
+            }
+            report(this, [prepared.file], [], {
+                cwd,
+                dryRun: this.dryRun === true,
+                force: this.force === true,
+                json: this.json === true,
+            });
+            if (prepared.published && this.json !== true) {
+                // Worth saying: the output came from the project's own stub, so a
+                // surprise in it is not a bug in ream.
+                this.logger.info(`rendered from stubs/make/${generator.kind}.stub`);
+            }
+        }
+    }
+    __decorate([
+        args.string({
+            description: 'Module directory under app/',
+            required: generator.moduleScoped,
+        }),
+        __metadata("design:type", String)
+    ], MakeCommand.prototype, "first", void 0);
+    __decorate([
+        args.string({ description: 'Name of the generated file', required: false }),
+        __metadata("design:type", String)
+    ], MakeCommand.prototype, "second", void 0);
+    __decorate([
+        flags.boolean({
+            description: 'Forcefully overwrite an existing file',
+            alias: 'f',
+        }),
+        __metadata("design:type", Boolean)
+    ], MakeCommand.prototype, "force", void 0);
+    __decorate([
+        flags.boolean({
+            description: 'Print what would be written, without writing it',
+        }),
+        __metadata("design:type", Boolean)
+    ], MakeCommand.prototype, "dryRun", void 0);
+    __decorate([
+        flags.boolean({ description: 'Report the outcome as a single JSON object' }),
+        __metadata("design:type", Boolean)
+    ], MakeCommand.prototype, "json", void 0);
+    __decorate([
+        flags.string({
+            description: 'Which stack a middleware registers on: router, server or named',
+        }),
+        __metadata("design:type", String)
+    ], MakeCommand.prototype, "stack", void 0);
+    __decorate([
+        flags.string({ description: 'Event class this listener handles' }),
+        __metadata("design:type", String)
+    ], MakeCommand.prototype, "event", void 0);
+    // The class is anonymous to the debugger otherwise, and a stack trace
+    // naming `MakeCommand` ten times helps nobody.
+    Object.defineProperty(MakeCommand, 'name', {
+        value: `Make${generator.kind.charAt(0).toUpperCase()}${generator.kind.slice(1)}`,
+    });
+    return MakeCommand;
+}
+/**
+ * `make:module` — an entity, a controller and a validator in one go.
+ *
+ * NOT the migration the binary also emitted: a migration is atlas' format and
+ * atlas' directory, and ream inventing one would produce a file its own
+ * `migration:run` never reads. `make:migration` is atlas' command, and this
+ * says so rather than guessing.
+ *
+ * The three are rendered before any is written, so a stub that fails to render
+ * leaves nothing half-generated behind.
+ */
+class MakeModule extends BaseCommand {
+    static commandName = 'make:module';
+    static description = 'Generate an entity, a controller and a validator';
+    static options = { startApp: false };
+    async run() {
+        const cwd = process.cwd();
+        const entries = [];
+        for (const kind of ['entity', 'controller', 'validator']) {
+            const generator = generatorFor(kind);
+            if (generator === undefined) {
+                this.logger.error(`no generator for "${kind}"`);
+                this.exitCode = 1;
+                return;
+            }
+            const prepared = prepare(generator, this.module, this.name, {}, cwd);
+            if ('error' in prepared) {
+                this.logger.error(prepared.error);
+                this.exitCode = 1;
+                return;
+            }
+            entries.push(prepared.file);
+        }
+        const warnings = [
+            // Said, not done: a barrel is the application's file, and appending to it
+            // blindly is how an export ends up duplicated.
+            `if app/${this.module}/index.ts exists, add the new exports to it yourself`,
+            "no migration was generated — that one is atlas': run `ream make:migration`",
+        ];
+        report(this, entries, warnings, {
+            cwd,
+            dryRun: this.dryRun === true,
+            force: this.force === true,
+            json: this.json === true,
+        });
+    }
+}
+__decorate([
+    args.string({ description: 'Module directory under app/' }),
+    __metadata("design:type", String)
+], MakeModule.prototype, "module", void 0);
+__decorate([
+    args.string({ description: 'Name shared by the generated files' }),
+    __metadata("design:type", String)
+], MakeModule.prototype, "name", void 0);
+__decorate([
+    flags.boolean({ description: 'Forcefully overwrite existing files', alias: 'f' }),
+    __metadata("design:type", Boolean)
+], MakeModule.prototype, "force", void 0);
+__decorate([
+    flags.boolean({ description: 'Print what would be written, without writing it' }),
+    __metadata("design:type", Boolean)
+], MakeModule.prototype, "dryRun", void 0);
+__decorate([
+    flags.boolean({ description: 'Report the outcome as a single JSON object' }),
+    __metadata("design:type", Boolean)
+], MakeModule.prototype, "json", void 0);
+/** Every `make:` command, built once. */
+export const MAKE_COMMANDS = [
+    ...GENERATORS.map(makeCommand),
+    MakeModule,
+    Eject,
+];
+//# sourceMappingURL=commands.js.map

package/dist/console/make/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/console/make/commands.ts"],"names":[],"mappings":"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"}

package/dist/console/make/eject.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `eject` — copy a package's stub into the application so it can be edited.
+ *
+ * The other half of the override rule: `renderStub` prefers `stubs/<path>`
+ * when the application has one, and this is how it gets there. Copied
+ * verbatim, front matter included, because the `to:` line is part of what a
+ * project may want to change.
+ *
+ * Adonis' command, name and argument included — `node ace eject make/controller
+ * --pkg=@adonisjs/lucid`. `--pkg` reads the package's own `stubsRoot`, which
+ * every Ream package exports from its `./stubs` subpath, so ejecting atlas' or
+ * warden's templates needs nothing added here.
+ */
+import { BaseCommand } from '../BaseCommand.js';
+export default class Eject extends BaseCommand {
+    #private;
+    static commandName: string;
+    static description: string;
+    static options: {
+        startApp: boolean;
+    };
+    stubPath?: string;
+    pkg?: string;
+    list?: boolean;
+    force?: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=eject.d.ts.map

package/dist/console/make/eject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eject.d.ts","sourceRoot":"","sources":["../../../src/console/make/eject.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA2D/C,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,WAAW;;IAC5C,OAAgB,WAAW,SAAU;IACrC,OAAgB,WAAW,SAC0D;IACrF,OAAgB,OAAO;;MAAsB;IAMrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAGjB,GAAG,CAAC,EAAE,MAAM,CAAA;IAGZ,IAAI,CAAC,EAAE,OAAO,CAAA;IAGd,KAAK,CAAC,EAAE,OAAO,CAAA;IAEjB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkE3B"}

package/dist/console/make/eject.js

@@ -0,0 +1,161 @@
+/**
+ * `eject` — copy a package's stub into the application so it can be edited.
+ *
+ * The other half of the override rule: `renderStub` prefers `stubs/<path>`
+ * when the application has one, and this is how it gets there. Copied
+ * verbatim, front matter included, because the `to:` line is part of what a
+ * project may want to change.
+ *
+ * Adonis' command, name and argument included — `node ace eject make/controller
+ * --pkg=@adonisjs/lucid`. `--pkg` reads the package's own `stubsRoot`, which
+ * every Ream package exports from its `./stubs` subpath, so ejecting atlas' or
+ * warden's templates needs nothing added here.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { BaseCommand } from '../BaseCommand.js';
+import { args, flags } from '../decorators.js';
+import { GENERATORS } from './generators.js';
+import { isSafeStubPath, PUBLISHED_ROOT, REAM_STUBS_ROOT, readStub, splitFrontMatter, stubPathFor, } from './resolve.js';
+/** Every `{{ name }}` a stub reads, so the listing cannot advertise a wrong one. */
+function variablesOf(source) {
+    const found = new Set();
+    for (const match of source.matchAll(/\{\{\{?\s*([\w.]+)\s*\}?\}\}/g)) {
+        const name = match[1];
+        if (name !== undefined)
+            found.add(name);
+    }
+    return [...found].sort();
+}
+/** The `stubsRoot` a module exports, when it exports one. */
+async function stubsRootFrom(specifier) {
+    try {
+        const loaded = await import(specifier);
+        if (typeof loaded !== 'object' || loaded === null)
+            return undefined;
+        const root = loaded.stubsRoot;
+        return typeof root === 'string' ? root : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The `stubsRoot` a package exports, or nothing when it exports none.
+ *
+ * Read from the package rather than guessed from `node_modules/<pkg>/stubs`:
+ * a package is free to keep them elsewhere, and only its own export says
+ * where. Adonis reads the entrypoint, so that is tried first; the `./stubs`
+ * subpath is tried after, because a barrel that also runs in a browser cannot
+ * export a filesystem path — which is why Ream packages put it on a subpath.
+ */
+async function stubsRootOf(pkg) {
+    if (pkg === '@c9up/ream')
+        return REAM_STUBS_ROOT;
+    return (await stubsRootFrom(pkg)) ?? (await stubsRootFrom(`${pkg}/stubs`));
+}
+/** Every `.stub` under `root`, as paths relative to it. */
+function stubsUnder(root, prefix = '') {
+    const found = [];
+    for (const entry of fs.readdirSync(path.join(root, prefix), { withFileTypes: true })) {
+        const relative = prefix === '' ? entry.name : `${prefix}/${entry.name}`;
+        if (entry.isDirectory())
+            found.push(...stubsUnder(root, relative));
+        else if (entry.name.endsWith('.stub'))
+            found.push(relative);
+    }
+    return found.sort();
+}
+export default class Eject extends BaseCommand {
+    static commandName = 'eject';
+    static description = 'Copy a package stub into stubs/ so the project can customise what make: generates';
+    static options = { startApp: false };
+    async run() {
+        const pkg = this.pkg ?? '@c9up/ream';
+        const stubsRoot = await stubsRootOf(pkg);
+        if (stubsRoot === undefined || !fs.existsSync(stubsRoot)) {
+            this.logger.error(`"${pkg}" ships no stubs (no \`stubsRoot\` on its ./stubs subpath)`);
+            this.exitCode = 1;
+            return;
+        }
+        if (this.list === true) {
+            this.#printList(stubsRoot);
+            return;
+        }
+        const requested = this.stubPath;
+        if (requested !== undefined && !isSafeStubPath(requested)) {
+            this.logger.error(`unusable stub path: ${requested}`);
+            this.exitCode = 1;
+            return;
+        }
+        // A path with no `.stub` suffix names a directory — `eject make` takes the
+        // lot, which is what makes ejecting every generator one command.
+        const available = stubsUnder(stubsRoot);
+        const selected = requested === undefined
+            ? available
+            : requested.endsWith('.stub')
+                ? available.filter((candidate) => candidate === requested)
+                : available.filter((candidate) => candidate.startsWith(`${requested}/`));
+        if (selected.length === 0) {
+            this.logger.error(`"${pkg}" ships no stub matching "${requested ?? ''}"`);
+            this.exitCode = 1;
+            return;
+        }
+        for (const stub of selected) {
+            const destination = path.join(process.cwd(), PUBLISHED_ROOT, stub);
+            if (fs.existsSync(destination) && this.force !== true) {
+                this.logger
+                    .action(`eject ${PUBLISHED_ROOT}/${stub}`)
+                    .skipped('already ejected, use --force');
+                continue;
+            }
+            fs.mkdirSync(path.dirname(destination), { recursive: true });
+            // The shipped one, never the project's copy: ejecting over your own edit
+            // with your own edit is a no-op that reads as success.
+            fs.writeFileSync(destination, fs.readFileSync(path.join(stubsRoot, stub)));
+            this.logger.action(`eject ${PUBLISHED_ROOT}/${stub}`).succeeded();
+        }
+    }
+    /** What each generator reads, taken from the stub rather than a kept list. */
+    #printList(stubsRoot) {
+        const table = this.ui.table().head(['Stub', 'Variables']);
+        const generatorStubs = new Set(GENERATORS.map((generator) => stubPathFor(generator.kind)));
+        for (const stub of stubsUnder(stubsRoot)) {
+            const { source } = readStub(stubsRoot, stub, path.join(process.cwd(), '__none__'));
+            const variables = generatorStubs.has(stub)
+                ? variablesOf(splitFrontMatter(source).body).join(', ')
+                : '';
+            table.row([stub, variables]);
+        }
+        table.render();
+    }
+}
+__decorate([
+    args.string({
+        description: 'The stub to copy, e.g. make/controller.stub — omit for a directory or all',
+        required: false,
+    }),
+    __metadata("design:type", String)
+], Eject.prototype, "stubPath", void 0);
+__decorate([
+    flags.string({ description: 'Which package to read the stub from' }),
+    __metadata("design:type", String)
+], Eject.prototype, "pkg", void 0);
+__decorate([
+    flags.boolean({ description: 'List what can be ejected, and the variables each stub reads' }),
+    __metadata("design:type", Boolean)
+], Eject.prototype, "list", void 0);
+__decorate([
+    flags.boolean({ description: 'Overwrite a stub the project already ejected' }),
+    __metadata("design:type", Boolean)
+], Eject.prototype, "force", void 0);
+//# sourceMappingURL=eject.js.map

package/dist/console/make/eject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eject.js","sourceRoot":"","sources":["../../../src/console/make/eject.ts"],"names":[],"mappings":"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"}

package/dist/console/make/flush.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Turning rendered stubs into files on disk.
+ *
+ * Split from the commands because the rules are the same for one file and for
+ * the three `make:module` emits, and they are not the obvious ones:
+ *
+ *   - A file that is already there is SKIPPED, not overwritten and not an
+ *     error — Adonis' generators answer `SKIPPED:` and carry on, and `--force`
+ *     is how one asks for the overwrite.
+ *   - With `--force`, a failure half-way through puts back what the same run
+ *     had already written. A generator that leaves a clobbered entity behind
+ *     after failing on the controller is worse than one that writes nothing.
+ *     That rollback is ours, not Adonis': its generators never overwrite more
+ *     than one file per command.
+ */
+/** One file a generator intends to write. */
+export interface PlannedFile {
+    path: string;
+    content: string;
+    /** Was something already there? Answered while planning, not after. */
+    exists: boolean;
+}
+export interface FlushOptions {
+    cwd: string;
+    dryRun: boolean;
+    force: boolean;
+}
+/**
+ * What a run did, in the shapes `--json` prints — see {@link outcomePayload}.
+ */
+export type FlushOutcome = {
+    status: 'planned';
+    files: PlannedFile[];
+    warnings: string[];
+} | {
+    status: 'written';
+    createdFiles: string[];
+    modifiedFiles: string[];
+    skippedFiles: string[];
+    warnings: string[];
+};
+/** `exists` is read now, not at write time: a plan describes one moment. */
+export declare function plannedFile(destination: string, content: string, cwd: string): PlannedFile;
+export declare function flush(entries: readonly PlannedFile[], warnings: readonly string[], options: FlushOptions): FlushOutcome;
+/**
+ * The outcome as the JSON object `--json` prints, kept in one place because it
+ * is a contract with another package rather than a debug dump: `ream-mcp` reads
+ * the last line of stdout and dispatches on which shape it is.
+ */
+export declare function outcomePayload(outcome: FlushOutcome): Record<string, unknown>;
+//# sourceMappingURL=flush.d.ts.map

package/dist/console/make/flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush.d.ts","sourceRoot":"","sources":["../../../src/console/make/flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/D;IACE,MAAM,EAAE,SAAS,CAAA;IACjB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CAAA;AAEL,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAM1F;AAED,wBAAgB,KAAK,CACnB,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE,YAAY,GACpB,YAAY,CA+Bd;AAmBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAU7E"}

package/dist/console/make/flush.js

@@ -0,0 +1,93 @@
+/**
+ * Turning rendered stubs into files on disk.
+ *
+ * Split from the commands because the rules are the same for one file and for
+ * the three `make:module` emits, and they are not the obvious ones:
+ *
+ *   - A file that is already there is SKIPPED, not overwritten and not an
+ *     error — Adonis' generators answer `SKIPPED:` and carry on, and `--force`
+ *     is how one asks for the overwrite.
+ *   - With `--force`, a failure half-way through puts back what the same run
+ *     had already written. A generator that leaves a clobbered entity behind
+ *     after failing on the controller is worse than one that writes nothing.
+ *     That rollback is ours, not Adonis': its generators never overwrite more
+ *     than one file per command.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** `exists` is read now, not at write time: a plan describes one moment. */
+export function plannedFile(destination, content, cwd) {
+    return {
+        path: destination,
+        content,
+        exists: fs.existsSync(path.resolve(cwd, destination)),
+    };
+}
+export function flush(entries, warnings, options) {
+    if (options.dryRun) {
+        return { status: 'planned', files: [...entries], warnings: [...warnings] };
+    }
+    const createdFiles = [];
+    const modifiedFiles = [];
+    const skippedFiles = [];
+    /** What each written path held before, so a later failure can put it back. */
+    const rollbacks = [];
+    try {
+        for (const entry of entries) {
+            if (entry.exists && !options.force) {
+                skippedFiles.push(entry.path);
+                continue;
+            }
+            const target = path.resolve(options.cwd, entry.path);
+            const prior = entry.exists ? fs.readFileSync(target) : undefined;
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(target, entry.content);
+            rollbacks.push({ path: target, prior });
+            if (entry.exists)
+                modifiedFiles.push(entry.path);
+            else
+                createdFiles.push(entry.path);
+        }
+    }
+    catch (error) {
+        rollback(rollbacks);
+        throw error;
+    }
+    return { status: 'written', createdFiles, modifiedFiles, skippedFiles, warnings: [...warnings] };
+}
+/**
+ * Undo in reverse, and never throw: the caller is already reporting a failure,
+ * and a rollback error on top of it buries the one that matters. What could not
+ * be undone is named on stderr instead.
+ */
+function rollback(rollbacks) {
+    for (const entry of [...rollbacks].reverse()) {
+        try {
+            if (entry.prior === undefined)
+                fs.rmSync(entry.path, { force: true });
+            else
+                fs.writeFileSync(entry.path, entry.prior);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`  rollback: failed to restore ${entry.path}: ${detail}\n`);
+        }
+    }
+}
+/**
+ * The outcome as the JSON object `--json` prints, kept in one place because it
+ * is a contract with another package rather than a debug dump: `ream-mcp` reads
+ * the last line of stdout and dispatches on which shape it is.
+ */
+export function outcomePayload(outcome) {
+    if (outcome.status === 'planned') {
+        return { files: outcome.files, warnings: outcome.warnings };
+    }
+    return {
+        createdFiles: outcome.createdFiles,
+        modifiedFiles: outcome.modifiedFiles,
+        skippedFiles: outcome.skippedFiles,
+        warnings: outcome.warnings,
+    };
+}
+//# sourceMappingURL=flush.js.map

package/dist/console/make/flush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flush.js","sourceRoot":"","sources":["../../../src/console/make/flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AA6BjC,4EAA4E;AAC5E,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,OAAe,EAAE,GAAW;IAC3E,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;KACtD,CAAA;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,OAA+B,EAC/B,QAA2B,EAC3B,OAAqB;IAErB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAA;IAC5E,CAAC;IAED,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,8EAA8E;IAC9E,MAAM,SAAS,GAAuD,EAAE,CAAA;IAExE,IAAI,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACnC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC7B,SAAQ;YACV,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAChE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACvD,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;YACvC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;YACvC,IAAI,KAAK,CAAC,MAAM;gBAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;;gBAC3C,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,SAAS,CAAC,CAAA;QACnB,MAAM,KAAK,CAAA;IACb,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAA;AAClG,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,SAAiE;IACjF,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;;gBAChE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAA;QAClF,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAA;IAC7D,CAAC;IACD,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAA;AACH,CAAC"}