@c9up/ream 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 C9up
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @c9up/ream
+
+Rust-powered Node.js application framework. Convention over configuration with native performance.
+
+`@c9up/ream` ships as a single package containing both the TypeScript framework and prebuilt Rust (NAPI) binaries — consumers never compile anything.
+
+## Features
+
+- **IoC Container** — `@Service()`, `@Inject()`, auto-resolution, scopes
+- **Lifecycle** — register → boot → start → ready → shutdown
+- **Router** — fluent chaining, groups, params, guards, versioning
+- **Middleware pipeline** — onion pattern, global + named, guard enforcement
+- **HTTP server** — Rust Hyper via NAPI
+- **Event bus** — in-process emitter with optional Redis store (`@c9up/ream/events`)
+- **Scheduler** — cron/interval tasks via the `@Schedule()` decorator (Rust-backed)
+- **GraphQL & RPC** — built-in GraphQL engine and typed RPC router
+- **Security primitives** — signed cookies, HMAC, signed URLs, trusted-proxy config (request-filter security — XSS / CSRF / rate-limiting — lives in [@c9up/blackhole](https://github.com/C9up/blackhole))
+- **Error DX** — structured errors, fuzzy matching, pipeline stage context
+- **Health check** — Kubernetes-compatible `/health` endpoint
+- **Graceful shutdown** — SIGTERM/SIGINT with drain timeout
+
+## Quick Start
+
+```typescript
+import { Ignitor } from '@c9up/ream'
+
+const app = new Ignitor({ port: 3000 })
+  .httpServer()
+  .routes((router) => {
+    router.get('/hello/:name', async ({ params, response }) => {
+      response.status(200).send(`Hello, ${params.name}!`)
+    })
+  })
+
+await app.start()
+```
+
+## Ecosystem
+
+Every package is standalone and publishable on its own; they consume the Ream
+universe through the container, never via a static import.
+
+| Package | Description |
+|---------|-------------|
+| [@c9up/atlas](https://github.com/C9up/atlas) | Data Mapper ORM |
+| [@c9up/rune](https://github.com/C9up/rune) | Validation engine |
+| [@c9up/warden](https://github.com/C9up/warden) | Authentication |
+| [@c9up/sigil](https://github.com/C9up/sigil) | Password hashing (argon2, bcrypt, scrypt) |
+| [@c9up/blackhole](https://github.com/C9up/blackhole) | Security filter — XSS, CSRF, rate-limiting (Rust-native) |
+| [@c9up/spectrum](https://github.com/C9up/spectrum) | Structured logging |
+| [@c9up/rosetta](https://github.com/C9up/rosetta) | Internationalization (i18n) |
+| [@c9up/chronos](https://github.com/C9up/chronos) | Date/time & recurrence engine |
+| [@c9up/atom](https://github.com/C9up/atom) | Exact decimal arithmetic |
+| [@c9up/bay](https://github.com/C9up/bay) | Job queue (memory + Redis drivers) |
+| [@c9up/echo](https://github.com/C9up/echo) | Cache (memory + Redis drivers) |
+| [@c9up/archive](https://github.com/C9up/archive) | File storage (Local + S3-compatible) |
+| [@c9up/rover](https://github.com/C9up/rover) | Mail transport (SMTP, log, pluggable) |
+| [@c9up/nova](https://github.com/C9up/nova) | Web Push notifications (VAPID) |
+| [@c9up/relay](https://github.com/C9up/relay) | Realtime transport (SSE + WebSocket) |
+| [@c9up/aurora](https://github.com/C9up/aurora) | Reactive UI runtime (SSR + hydration) |
+| [@c9up/photon](https://github.com/C9up/photon) | Frontend rendering engine |
+| [@c9up/inker](https://github.com/C9up/inker) | Server-side templating |
+| [@c9up/station](https://github.com/C9up/station) | Admin scaffolding |
+| [@c9up/helix](https://github.com/C9up/helix) | Framework-agnostic test runtime |
+| [@c9up/ream-cli](https://github.com/C9up/ream-cli) | CLI & code generators (Rust binary, `ream` command) |
+| [@c9up/ream-mcp](https://github.com/C9up/ream-mcp) | MCP server — agent-ready framework assistant |
+
+## License
+
+MIT

package/dist/Application.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Application — manages providers, config, lifecycle, and signal handling.
+ *
+ * Like AdonisJS Application:
+ * - app.booting(callback) — register hooks that run during boot
+ * - app.booted(callback) — register hooks that run after boot completes
+ * - app.listen(signal, callback) — listen for process signals
+ * - app.listenIf(condition, signal, callback) — conditional signal listener
+ * - app.terminate() — graceful shutdown
+ * - app.managedByPm2 — PM2 detection
+ * - app.inProduction / app.inDev / app.inTest
+ *
+ * @implements FR17, FR20
+ */
+import { ConfigStore } from './ConfigLoader.js';
+import { Container } from './container/Container.js';
+import type { AppContext, ProviderContract } from './Provider.js';
+export declare class Application implements AppContext {
+    readonly container: Container;
+    readonly config: ConfigStore;
+    private providers;
+    private _booted;
+    private _bootingHooks;
+    private _bootedHooks;
+    private _shutdownHooks;
+    constructor();
+    /** Check if running in production. */
+    get inProduction(): boolean;
+    /** Check if running in development. */
+    get inDev(): boolean;
+    /** Check if running in test mode. */
+    get inTest(): boolean;
+    /** Check if managed by PM2. */
+    get managedByPm2(): boolean;
+    /**
+     * Register a callback that runs during the boot phase (before providers boot).
+     * Like AdonisJS app.booting().
+     */
+    booting(callback: () => Promise<void> | void): void;
+    /**
+     * Register a callback that runs after boot completes.
+     * Like AdonisJS app.booted().
+     */
+    booted(callback: () => Promise<void> | void): void;
+    /**
+     * Listen for a process signal.
+     * Like AdonisJS app.listen('SIGTERM', () => app.terminate()).
+     */
+    listen(signal: NodeJS.Signals, callback: () => void): void;
+    /**
+     * Conditionally listen for a process signal.
+     * Like AdonisJS app.listenIf(app.managedByPm2, 'SIGINT', ...).
+     */
+    listenIf(condition: boolean, signal: NodeJS.Signals, callback: () => void): void;
+    /**
+     * Graceful shutdown — stop all providers and exit.
+     * Like AdonisJS app.terminate().
+     */
+    terminate(): Promise<void>;
+    /** Register a provider instance. */
+    register(provider: ProviderContract): void;
+    /** Boot all registered providers. Runs booting/booted hooks. */
+    boot(): Promise<void>;
+    /** Shutdown all providers in reverse order. */
+    shutdown(): Promise<void>;
+    /** Register a shutdown hook. */
+    onShutdown(callback: () => Promise<void> | void): void;
+    get isBooted(): boolean;
+    get providerCount(): number;
+}
+//# sourceMappingURL=Application.d.ts.map

package/dist/Application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../src/Application.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGjE,qBAAa,WAAY,YAAW,UAAU;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,cAAc,CAAwC;;IAS9D,sCAAsC;IACtC,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,uCAAuC;IACvC,IAAI,KAAK,IAAI,OAAO,CAGnB;IAED,qCAAqC;IACrC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,+BAA+B;IAC/B,IAAI,YAAY,IAAI,OAAO,CAE1B;IAID;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAInD;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAmBlD;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAI1D;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAMhF;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAO1C,gEAAgE;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,+CAA+C;IACzC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,gCAAgC;IAChC,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAItD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}

package/dist/Application.js

@@ -0,0 +1,151 @@
+/**
+ * Application — manages providers, config, lifecycle, and signal handling.
+ *
+ * Like AdonisJS Application:
+ * - app.booting(callback) — register hooks that run during boot
+ * - app.booted(callback) — register hooks that run after boot completes
+ * - app.listen(signal, callback) — listen for process signals
+ * - app.listenIf(condition, signal, callback) — conditional signal listener
+ * - app.terminate() — graceful shutdown
+ * - app.managedByPm2 — PM2 detection
+ * - app.inProduction / app.inDev / app.inTest
+ *
+ * @implements FR17, FR20
+ */
+import { ConfigStore } from './ConfigLoader.js';
+import { Container } from './container/Container.js';
+import { callProviderPhase } from './Provider.js';
+export class Application {
+    container;
+    config;
+    providers = [];
+    _booted = false;
+    _bootingHooks = [];
+    _bootedHooks = [];
+    _shutdownHooks = [];
+    constructor() {
+        this.container = new Container();
+        this.config = new ConfigStore();
+    }
+    // ─── Environment ──────────────────────────────────────────
+    /** Check if running in production. */
+    get inProduction() {
+        return process.env.NODE_ENV === 'production';
+    }
+    /** Check if running in development. */
+    get inDev() {
+        const env = process.env.NODE_ENV;
+        return env !== 'production' && env !== 'test';
+    }
+    /** Check if running in test mode. */
+    get inTest() {
+        return process.env.NODE_ENV === 'test';
+    }
+    /** Check if managed by PM2. */
+    get managedByPm2() {
+        return 'PM2_HOME' in process.env || 'pm_id' in process.env;
+    }
+    // ─── Lifecycle hooks ──────────────────────────────────────
+    /**
+     * Register a callback that runs during the boot phase (before providers boot).
+     * Like AdonisJS app.booting().
+     */
+    booting(callback) {
+        this._bootingHooks.push(callback);
+    }
+    /**
+     * Register a callback that runs after boot completes.
+     * Like AdonisJS app.booted().
+     */
+    booted(callback) {
+        if (this._booted) {
+            // Already booted — run immediately. Invoke callback() INSIDE the
+            // promise chain (not as `Promise.resolve(callback())`, which
+            // evaluates callback() eagerly and lets a synchronous throw
+            // escape to the caller) so both sync throws and async rejections
+            // are funnelled to the logger.
+            Promise.resolve()
+                .then(() => callback())
+                .catch((err) => {
+                process.stderr.write(`[Ream] booted() callback error: ${err}\n`);
+            });
+            return;
+        }
+        this._bootedHooks.push(callback);
+    }
+    // ─── Signal handling ──────────────────────────────────────
+    /**
+     * Listen for a process signal.
+     * Like AdonisJS app.listen('SIGTERM', () => app.terminate()).
+     */
+    listen(signal, callback) {
+        process.on(signal, callback);
+    }
+    /**
+     * Conditionally listen for a process signal.
+     * Like AdonisJS app.listenIf(app.managedByPm2, 'SIGINT', ...).
+     */
+    listenIf(condition, signal, callback) {
+        if (condition) {
+            process.on(signal, callback);
+        }
+    }
+    /**
+     * Graceful shutdown — stop all providers and exit.
+     * Like AdonisJS app.terminate().
+     */
+    async terminate() {
+        await this.shutdown();
+        process.exit(0);
+    }
+    // ─── Provider lifecycle ───────────────────────────────────
+    /** Register a provider instance. */
+    register(provider) {
+        this.providers.push(provider);
+        if (typeof provider.register === 'function') {
+            provider.register();
+        }
+    }
+    /** Boot all registered providers. Runs booting/booted hooks. */
+    async boot() {
+        if (this._booted)
+            return;
+        // Run booting hooks
+        for (const hook of this._bootingHooks) {
+            await hook();
+        }
+        // Boot providers. `callProviderPhase` skips providers that don't
+        // declare the phase — duck-typed packages (spectrum, warden, etc.)
+        // implement only what they need.
+        for (const provider of this.providers) {
+            await callProviderPhase(provider, 'boot');
+        }
+        this._booted = true;
+        // Run booted hooks
+        for (const hook of this._bootedHooks) {
+            await hook();
+        }
+    }
+    /** Shutdown all providers in reverse order. */
+    async shutdown() {
+        // Run shutdown hooks
+        for (const hook of this._shutdownHooks) {
+            await hook();
+        }
+        for (const provider of [...this.providers].reverse()) {
+            await callProviderPhase(provider, 'shutdown');
+        }
+        this._booted = false;
+    }
+    /** Register a shutdown hook. */
+    onShutdown(callback) {
+        this._shutdownHooks.push(callback);
+    }
+    get isBooted() {
+        return this._booted;
+    }
+    get providerCount() {
+        return this.providers.length;
+    }
+}
+//# sourceMappingURL=Application.js.map

package/dist/Application.js.map

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

package/dist/Codemods.d.ts

@@ -0,0 +1,16 @@
+export interface Codemods {
+    addProvider(importPath: string): Promise<void>;
+    addEnvVars(vars: Record<string, string>): Promise<void>;
+    writeFile(filePath: string, content: string, options?: {
+        force?: boolean;
+    }): Promise<void>;
+    registerCommand(importPath: string): Promise<void>;
+    registerMiddleware(importPath: string, options?: {
+        tier?: 'server' | 'router';
+    }): Promise<void>;
+}
+export declare function createCodemods(options?: {
+    force?: boolean;
+    cwd?: string;
+}): Codemods;
+//# sourceMappingURL=Codemods.d.ts.map

package/dist/Codemods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Codemods.d.ts","sourceRoot":"","sources":["../src/Codemods.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1F,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChG;AA0DD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAmRpF"}

package/dist/Codemods.js

@@ -0,0 +1,277 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function isMiddlewareTier(value) {
+    return value === 'server' || value === 'router';
+}
+function findTierBlock(content, tier) {
+    // Word-boundary prefix `(?:^|[^A-Za-z0-9_$.])` rejects `customServer.use` / `myRouter.use`
+    // when scanning for the canonical `server` / `router` tier. The `.` exclusion also rejects
+    // `obj.server.use` shapes. Match[1] captures the literal `<tier>.use([` so we can compute
+    // the post-`[` cursor without including the boundary char.
+    const marker = new RegExp(`(?:^|[^A-Za-z0-9_$.])(${tier}\\.use\\s*\\(\\s*(?:\\/\\*[\\s\\S]*?\\*\\/\\s*)?\\[)`);
+    const match = marker.exec(content);
+    if (match === null || match[1] === undefined)
+        return null;
+    const start = match.index + match[0].length;
+    // The array close pattern `\]\s*,?\s*\)` matches `])`, `],)`, `],\n)`, `]\n)` — every
+    // canonical kernel shape produced by `ream new` or hand-formatted by Prettier. Using
+    // this pattern (vs a bare `]`) avoids early-truncating the slice on nested `]` inside
+    // an array entry — important for the dedup window since we read the slice content for
+    // cross-tier collision detection AND per-tier idempotency.
+    const closeMatch = /\]\s*,?\s*\)/.exec(content.slice(start));
+    if (closeMatch === null)
+        return null;
+    return { start, end: start + closeMatch.index };
+}
+/**
+ * Detect line ending (CRLF on Windows checkouts, LF elsewhere) so codemods preserve the file's existing convention.
+ * Majority-based: a stray CRLF in an otherwise-LF file must not flip the whole insertion to CRLF.
+ */
+function detectLineEnding(content) {
+    const crlfCount = (content.match(/\r\n/g) ?? []).length;
+    const bareLfCount = (content.match(/(?<!\r)\n/g) ?? []).length;
+    return crlfCount > bareLfCount ? '\r\n' : '\n';
+}
+/**
+ * Refuse to follow a symlink that escapes the project root. Mirrors the guard `writeFile` enforces
+ * (lines 137-155) so `registerCommand` and `registerMiddleware` cannot be tricked into writing
+ * outside `root` via a symlinked `reamrc.ts` or `start/kernel.ts`.
+ */
+function assertCanonicallyInside(root, filePath, displayName) {
+    if (!fs.existsSync(filePath))
+        return;
+    const canonRoot = fs.realpathSync(root);
+    const canonFile = fs.realpathSync(filePath);
+    if (!canonFile.startsWith(canonRoot + path.sep) && canonFile !== canonRoot) {
+        throw new Error(`[configure] Symlink escape detected: ${displayName} resolves outside project root`);
+    }
+}
+export function createCodemods(options) {
+    const force = options?.force ?? false;
+    const root = path.resolve(options?.cwd ?? process.cwd());
+    return {
+        /**
+         * Insert a provider import into `reamrc.ts` by string manipulation.
+         *
+         * KNOWN LIMITATION: this is a regex-based codemod, not a TS AST
+         * transform. It works for the canonical `providers: [ ... ]` shape
+         * emitted by `ream new` and tolerates comments/whitespace around
+         * the array literal. It does NOT handle unusual shapes such as
+         * providers declared via a spread, a ternary, a `const providers =
+         * [...]` extracted above the config object, or a `providers:`
+         * identifier that appears inside a string literal or block comment
+         * elsewhere in the file. For those cases, edit `reamrc.ts` by hand.
+         * A full AST-based rewrite is tracked separately.
+         */
+        async addProvider(importPath) {
+            const rcPath = path.join(root, 'reamrc.ts');
+            if (!fs.existsSync(rcPath)) {
+                throw new Error(`[configure] reamrc.ts not found — cannot register provider ${importPath}. Run 'ream new' first.`);
+            }
+            // Same symlink-containment guard registerCommand/registerMiddleware/
+            // writeFile apply — a symlinked reamrc.ts must not redirect the
+            // write outside the project root.
+            assertCanonicallyInside(root, rcPath, 'reamrc.ts');
+            let content = fs.readFileSync(rcPath, 'utf8');
+            // Dedup check — any mention of the exact import path is treated
+            // as an existing registration. This is a coarse heuristic but
+            // safe because `importPath` is typically a package path like
+            // `@c9up/atlas/providers`, which should not appear in comments
+            // or unrelated strings in a typical `reamrc.ts`.
+            if (content.includes(`'${importPath}'`) || content.includes(`"${importPath}"`))
+                return;
+            const entry = `    () => import('${importPath}'),`;
+            // Marker tolerates extra whitespace and optional trailing comments
+            // between `providers:` and `[`. Still brittle to string-literal
+            // false-positives (see doc above).
+            const marker = /providers\s*:\s*(?:\/\*[\s\S]*?\*\/\s*)?\[/;
+            const match = marker.exec(content);
+            if (!match) {
+                throw new Error(`[configure] Could not find 'providers: [' in reamrc.ts — provider ${importPath} not added. Check your reamrc.ts format.`);
+            }
+            const insertAt = match.index + match[0].length;
+            const eol = detectLineEnding(content);
+            content = `${content.slice(0, insertAt)}${eol}${entry}${content.slice(insertAt)}`;
+            fs.writeFileSync(rcPath, content);
+        },
+        async addEnvVars(vars) {
+            const envPath = path.join(root, '.env');
+            // A symlinked .env must not redirect the write outside the root.
+            assertCanonicallyInside(root, envPath, '.env');
+            let content = fs.existsSync(envPath) ? fs.readFileSync(envPath, 'utf8') : '';
+            let added = 0;
+            for (const [key, value] of Object.entries(vars)) {
+                const pattern = new RegExp(`^${key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}=`, 'm');
+                if (!pattern.test(content)) {
+                    content += `${key}=${value}\n`;
+                    added++;
+                }
+            }
+            if (added > 0)
+                fs.writeFileSync(envPath, content);
+        },
+        async writeFile(filePath, content, opts) {
+            if (path.isAbsolute(filePath)) {
+                throw new Error(`[configure] Absolute paths not allowed: ${filePath}`);
+            }
+            const resolved = path.resolve(root, filePath);
+            if (!resolved.startsWith(root + path.sep) && resolved !== root) {
+                throw new Error(`[configure] Refusing to write outside project root: ${filePath}`);
+            }
+            const shouldForce = opts?.force ?? force;
+            if (fs.existsSync(resolved) && !shouldForce)
+                return;
+            const dir = path.dirname(resolved);
+            fs.mkdirSync(dir, { recursive: true });
+            const canonRoot = fs.realpathSync(root);
+            if (fs.existsSync(dir)) {
+                const canonDir = fs.realpathSync(dir);
+                if (!canonDir.startsWith(canonRoot + path.sep) && canonDir !== canonRoot) {
+                    throw new Error(`[configure] Symlink escape detected: ${filePath} — directory resolves outside project root`);
+                }
+            }
+            if (fs.existsSync(resolved)) {
+                const canonFile = fs.realpathSync(resolved);
+                if (!canonFile.startsWith(canonRoot + path.sep)) {
+                    throw new Error(`[configure] Symlink escape detected: ${filePath} — file resolves outside project root`);
+                }
+            }
+            fs.writeFileSync(resolved, content);
+        },
+        /**
+         * Insert a command import into `reamrc.ts` `commands: [ ... ]` array.
+         *
+         * Mirrors `addProvider`'s shape: regex-based codemod (NOT a TS AST
+         * transform), idempotent string-match dedup against the exact import
+         * path quoted, `[configure]` error prefix on failure.
+         *
+         * Bootstraps the `commands:` field when absent — inserts immediately
+         * after the existing `providers: [...]` block when present, otherwise
+         * before the closing `})` of `defineConfig({...})`. The field is
+         * optional in `ReamrcConfig` (Ignitor.ts:55), so adding it is
+         * non-breaking.
+         *
+         * Indent convention: inserted entries use 4-space indent, matching the
+         * canonical depth-2 nesting inside `defineConfig({ providers: [ ... ] })`.
+         * (registerMiddleware uses 2-space indent because its target is the
+         * depth-1 `<tier>.use([ ... ])` call in `start/kernel.ts`.)
+         *
+         * Marker anchoring: top-level fields of `defineConfig({...})` are
+         * anchored to start-of-line + ≤4 leading spaces to reject false matches
+         * inside nested objects (e.g. a `tests: { commands: [...] }` field
+         * higher in `reamrc.ts`).
+         */
+        async registerCommand(importPath) {
+            const rcPath = path.join(root, 'reamrc.ts');
+            if (!fs.existsSync(rcPath)) {
+                throw new Error(`[configure] reamrc.ts not found — cannot register command ${importPath}. Run 'ream new' first.`);
+            }
+            assertCanonicallyInside(root, rcPath, 'reamrc.ts');
+            let content = fs.readFileSync(rcPath, 'utf8');
+            if (content.includes(`'${importPath}'`) || content.includes(`"${importPath}"`))
+                return;
+            const eol = detectLineEnding(content);
+            const entry = `    () => import('${importPath}'),`;
+            // Anchor `commands:` to start-of-line + ≤4 leading spaces (top-level field of
+            // `defineConfig({...})`). Rejects nested matches like `tests: { commands: [...] }`.
+            const arrayMarker = /^[ \t]{0,4}commands\s*:\s*(?:\/\*[\s\S]*?\*\/\s*)?\[/m;
+            const arrayMatch = arrayMarker.exec(content);
+            if (arrayMatch !== null) {
+                const insertAt = arrayMatch.index + arrayMatch[0].length;
+                content = `${content.slice(0, insertAt)}${eol}${entry}${content.slice(insertAt)}`;
+                fs.writeFileSync(rcPath, content);
+                return;
+            }
+            const block = `  commands: [${eol}${entry}${eol}  ],${eol}`;
+            // Same start-of-line anchor as the commands marker — rejects nested `providers:`.
+            // Note: the non-greedy `\[[\s\S]*?\]` still finds the FIRST `]` after `providers:`,
+            // so a top-level `providers: [...]` containing nested `]` (e.g. tuple-typed entries)
+            // can still mis-match. Rare in practice; if hit, the user's reamrc.ts is in a shape
+            // the regex codemod cannot safely manipulate — they should add `commands: []`
+            // manually and re-run, or fall through to the defineConfig-close fallback below.
+            const providersEndMarker = /^[ \t]{0,4}providers\s*:\s*\[[\s\S]*?\],?[ \t]*\r?\n/m;
+            const providersEnd = providersEndMarker.exec(content);
+            if (providersEnd !== null) {
+                const insertAt = providersEnd.index + providersEnd[0].length;
+                content = `${content.slice(0, insertAt)}${block}${content.slice(insertAt)}`;
+                fs.writeFileSync(rcPath, content);
+                return;
+            }
+            // Use the LAST `})` in the file (conventionally the `defineConfig({...})` close in a
+            // canonical `export default defineConfig({...})` reamrc). `lastIndexOf` avoids the
+            // /m-anchored `exec` returning the FIRST line ending in `})` — which would mis-target
+            // a helper above defineConfig like `const helper = makeProviders({ eager: true })`.
+            const defineCloseIdx = content.lastIndexOf('})');
+            if (defineCloseIdx !== -1) {
+                content = `${content.slice(0, defineCloseIdx)}${block}${content.slice(defineCloseIdx)}`;
+                fs.writeFileSync(rcPath, content);
+                return;
+            }
+            throw new Error(`[configure] Could not find 'defineConfig({ ... })' in reamrc.ts — command ${importPath} not added. Check your reamrc.ts format.`);
+        },
+        /**
+         * Insert a middleware import into `start/kernel.ts` `<tier>.use([ ... ])`
+         * array. `tier` defaults to `'router'` (matched routes only) — the
+         * conservative choice that does not run on 404s. Set `tier: 'server'`
+         * for middleware that must run on every request including 404s
+         * (security headers, request-id, structured logging).
+         *
+         * Mirrors `addProvider`'s shape: regex-based codemod, idempotent
+         * per-tier string-match dedup, `[configure]` error prefix.
+         *
+         * KNOWN LIMITATION: does NOT bootstrap a missing `<tier>.use([])`
+         * block. Unlike `commands`, the `server.use` / `router.use` calls
+         * are user-authored idiom in `start/kernel.ts`, not a config-shape
+         * contract — synthesising them would require also synthesising the
+         * `import server from '@c9up/ream/services/server'` boilerplate, and
+         * is footgun-prone if the user has renamed identifiers. When the
+         * targeted block is absent, this method errors and asks the user
+         * to add the block manually.
+         *
+         * Cross-tier collision is rejected: registering the same import path
+         * in BOTH `server` and `router` tiers is almost certainly a mistake;
+         * the second call throws `[configure] middleware <importPath> is
+         * already registered in <other-tier> tier`.
+         *
+         * Indent convention: inserted entries use 2-space indent, matching
+         * the canonical depth-1 nesting inside `<tier>.use([ ... ])` at the
+         * top of `start/kernel.ts`. (registerCommand uses 4-space indent
+         * because its target is the depth-2 `defineConfig({ commands: [ ... ] })`
+         * block in `reamrc.ts`.)
+         */
+        async registerMiddleware(importPath, options) {
+            const requestedTier = options?.tier ?? 'router';
+            if (!isMiddlewareTier(requestedTier)) {
+                throw new Error(`[configure] Invalid middleware tier: '${String(requestedTier)}'. Expected 'server' or 'router'.`);
+            }
+            const tier = requestedTier;
+            const otherTier = tier === 'server' ? 'router' : 'server';
+            const kernelPath = path.join(root, 'start', 'kernel.ts');
+            if (!fs.existsSync(kernelPath)) {
+                throw new Error(`[configure] start/kernel.ts not found — cannot register middleware ${importPath}. Run 'ream new' first or create the file from the installation guide.`);
+            }
+            assertCanonicallyInside(root, kernelPath, 'start/kernel.ts');
+            let content = fs.readFileSync(kernelPath, 'utf8');
+            const otherBlock = findTierBlock(content, otherTier);
+            if (otherBlock !== null) {
+                const otherSlice = content.slice(otherBlock.start, otherBlock.end);
+                if (otherSlice.includes(`'${importPath}'`) || otherSlice.includes(`"${importPath}"`)) {
+                    throw new Error(`[configure] middleware ${importPath} is already registered in ${otherTier} tier — cannot also register in ${tier} tier. Choose one tier or remove the existing registration.`);
+                }
+            }
+            const targetBlock = findTierBlock(content, tier);
+            if (targetBlock === null) {
+                throw new Error(`[configure] Could not find '${tier}.use([' in start/kernel.ts — middleware ${importPath} not added. Add the block manually or check your start/kernel.ts format.`);
+            }
+            const targetSlice = content.slice(targetBlock.start, targetBlock.end);
+            if (targetSlice.includes(`'${importPath}'`) || targetSlice.includes(`"${importPath}"`)) {
+                return;
+            }
+            const eol = detectLineEnding(content);
+            const entry = `  () => import('${importPath}'),`;
+            content = `${content.slice(0, targetBlock.start)}${eol}${entry}${content.slice(targetBlock.start)}`;
+            fs.writeFileSync(kernelPath, content);
+        },
+    };
+}
+//# sourceMappingURL=Codemods.js.map

package/dist/Codemods.js.map

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