@gobing-ai/ts-runtime 0.3.0 → 0.3.2

package/dist/config.js

@@ -1,6 +1,7 @@
 import { deepMerge } from '@gobing-ai/ts-utils';
 import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { z } from 'zod';
+/** Zod schema for the application configuration object, providing defaults for app, database, and logging sections. */
 export const configSchema = z.object({
     app: z
         .object({
@@ -54,6 +55,7 @@ export function parseYamlObject(text) {
 export function stringifyYamlObject(value) {
     return stringifyYaml(value);
 }
+/** Error thrown when configuration validation fails, carrying the Zod validation issues for diagnostics. */
 export class ConfigLoadError extends Error {
     issues;
     constructor(message, issues = []) {
@@ -64,22 +66,31 @@ export class ConfigLoadError extends Error {
 }
 // These accessors read `process.env` directly and are node-bun only (ADR-008). On
 // `cloudflare-workers` there is no `process`; inject config explicitly rather than calling these.
+/** Returns the value of `process.env.NODE_ENV`, or `"development"` as default. Node/Bun only. */
 export function getNodeEnv() {
     return process.env.NODE_ENV ?? 'development';
 }
+/** Returns `true` when `NODE_ENV` is `"test"`. Node/Bun only. */
 export function isTestEnv() {
     return getNodeEnv() === 'test';
 }
+/** Returns `process.env` as a plain object. Node/Bun only. */
 export function getProcessEnv() {
     return process.env;
 }
+/** Returns `process.env.DATABASE_URL`, or `undefined` if not set. Node/Bun only. */
 export function getDatabaseUrl() {
     return process.env.DATABASE_URL;
 }
+/** Returns the user's home directory (`HOME`, falling back to `USERPROFILE` on Windows), or `undefined` if unset. Node/Bun only. */
+export function getHomeDir() {
+    return process.env.HOME ?? process.env.USERPROFILE;
+}
 /** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
 export function interpolateEnv(value) {
     return value.replace(ENV_INTERPOLATION_RE, (_match, name) => process.env[name] ?? `\${${name}}`);
 }
+/** Recursively interpolates `${VAR}` environment variables in all string leaves of a nested object or array. Node/Bun only. */
 export function interpolateTree(value) {
     if (typeof value === 'string')
         return interpolateEnv(value);
@@ -90,6 +101,7 @@ export function interpolateTree(value) {
     }
     return value;
 }
+/** Interpolates env vars, merges overrides, validates against {@link configSchema}, and returns a frozen {@link Config}. */
 export function buildConfigFromObject(raw, options = {}) {
     const interpolated = interpolateTree(raw);
     const merged = options.overrides
@@ -101,6 +113,7 @@ export function buildConfigFromObject(raw, options = {}) {
     }
     return deepFreeze(result.data);
 }
+/** Parses a YAML configuration string into a raw object, throwing {@link ConfigLoadError} on failure. */
 export function parseConfigYaml(yamlText) {
     try {
         return parseYamlObject(yamlText);
@@ -111,6 +124,7 @@ export function parseConfigYaml(yamlText) {
         throw new ConfigLoadError(`Config YAML parsing failed: ${error.message}`);
     }
 }
+/** Parses YAML text and builds a validated {@link Config}, equivalent to `buildConfigFromObject(parseConfigYaml(…))`. */
 export function buildConfigFromYaml(yamlText, options = {}) {
     return buildConfigFromObject(parseConfigYaml(yamlText), options);
 }

package/dist/context.d.ts

@@ -1,18 +1,24 @@
 import type { Config } from './config';
-import type { FileSystem } from './fs';
+import type { FileSystem } from './file-system';
+import type { ProcessExecutor as ProcessExecutorService } from './process-executor';
 import type { RuntimeCapabilities, RuntimeName } from './types';
+/** Execution scope of a runtime context — determines service lifecycle and availability. */
 export type RuntimeScope = 'process' | 'server-request' | 'scheduled-event' | 'test';
+/** Map of named services available to a runtime context, including the required `config` and `fileSystem`. */
 export interface RuntimeServiceMap {
     config: Config;
     fileSystem: FileSystem;
+    processExecutor?: ProcessExecutorService;
     [serviceName: string]: unknown;
 }
+/** Options for constructing a {@link RuntimeContext}. */
 export interface RuntimeContextOptions<TServices extends RuntimeServiceMap = RuntimeServiceMap> {
     scope?: RuntimeScope;
     runtimeName?: RuntimeName;
     capabilities?: RuntimeCapabilities;
     services?: Partial<TServices>;
 }
+/** Injectable service container scoped to a runtime environment (process, request, event, or test). */
 export declare class RuntimeContext<TServices extends RuntimeServiceMap = RuntimeServiceMap> {
     readonly scope: RuntimeScope;
     readonly runtimeName: RuntimeName;
@@ -25,5 +31,26 @@ export declare class RuntimeContext<TServices extends RuntimeServiceMap = Runtim
     has<K extends keyof TServices>(key: K): boolean;
     dispose(): Promise<void>;
 }
+/**
+ * Create a {@link RuntimeContext} wired to the auto-detected runtime factory.
+ *
+ * Loads the platform-specific factory via {@link loadRuntimeFactory},
+ * auto-wires FileSystem, ProcessExecutor, and Config, then returns a
+ * ready-to-use context. Call this at the entry point of any app or worker.
+ *
+ * @example
+ * ```ts
+ * const ctx = await createRuntimeContextFromFactory();
+ * const fs = ctx.require('fileSystem');
+ * const config = ctx.require('config');
+ * ```
+ */
+export declare function createRuntimeContextFromFactory<TServices extends RuntimeServiceMap = RuntimeServiceMap>(options?: RuntimeContextOptions<TServices>): Promise<RuntimeContext<TServices>>;
+/**
+ * @deprecated Use {@link createRuntimeContextFromFactory} instead —
+ * it auto-detects the platform and wires the correct services from the factory.
+ * This function is kept for backward compatibility with synchronous callers
+ * that manually configure services.
+ */
 export declare function createRuntimeContext<TServices extends RuntimeServiceMap = RuntimeServiceMap>(options?: RuntimeContextOptions<TServices>): RuntimeContext<TServices>;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC1F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACjC;AAED,qBAAa,cAAc,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,mDAA0D;gBAE/D,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM;IAqB1D,QAAQ,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhE,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAQxD,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAIzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAejC;AAMD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB,EACxF,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC/C,cAAc,CAAC,SAAS,CAAC,CAE3B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,4FAA4F;AAC5F,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErF,8GAA8G;AAC9G,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,yDAAyD;AACzD,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC1F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACjC;AAED,uGAAuG;AACvG,qBAAa,cAAc,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,mDAA0D;gBAE/D,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM;IA2B1D,QAAQ,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhE,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAQxD,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAIzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAejC;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,+BAA+B,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB,EACzG,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAiBpC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB,EACxF,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC/C,cAAc,CAAC,SAAS,CAAC,CAE3B"}

package/dist/context.js

@@ -1,5 +1,8 @@
 import { buildConfigFromObject } from './config.js';
-import { getFs } from './fs.js';
+import { createNodeFileSystem } from './file-system-node.js';
+import { loadRuntimeFactory } from './platform.js';
+import { ProcessExecutor } from './process-executor.js';
+/** Injectable service container scoped to a runtime environment (process, request, event, or test). */
 export class RuntimeContext {
     scope;
     runtimeName;
@@ -16,7 +19,10 @@ export class RuntimeContext {
                     hasPersistentStorage: true,
                 };
         this.register('config', (options.services?.config ?? buildConfigFromObject({})));
-        this.register('fileSystem', (options.services?.fileSystem ?? getFs()));
+        this.register('fileSystem', (options.services?.fileSystem ?? createNodeFileSystem()));
+        if (this.capabilities.hasProcessExecution && options.services?.processExecutor === undefined) {
+            this.register('processExecutor', new ProcessExecutor());
+        }
         for (const [key, value] of Object.entries(options.services ?? {})) {
             if (value !== undefined) {
                 this.register(key, value);
@@ -60,6 +66,43 @@ export class RuntimeContext {
 function isDisposable(value) {
     return typeof value === 'object' && value !== null && 'dispose' in value && typeof value.dispose === 'function';
 }
+/**
+ * Create a {@link RuntimeContext} wired to the auto-detected runtime factory.
+ *
+ * Loads the platform-specific factory via {@link loadRuntimeFactory},
+ * auto-wires FileSystem, ProcessExecutor, and Config, then returns a
+ * ready-to-use context. Call this at the entry point of any app or worker.
+ *
+ * @example
+ * ```ts
+ * const ctx = await createRuntimeContextFromFactory();
+ * const fs = ctx.require('fileSystem');
+ * const config = ctx.require('config');
+ * ```
+ */
+export async function createRuntimeContextFromFactory(options) {
+    const factory = await loadRuntimeFactory();
+    const config = await factory.loadConfig();
+    const fileSystem = factory.createFileSystem();
+    const processExecutor = factory.capabilities.hasProcessExecution ? factory.createProcessExecutor() : undefined;
+    return new RuntimeContext({
+        scope: 'process',
+        runtimeName: factory.runtimeName,
+        capabilities: factory.capabilities,
+        services: {
+            config,
+            fileSystem,
+            ...(processExecutor !== undefined ? { processExecutor } : {}),
+            ...options?.services,
+        },
+    });
+}
+/**
+ * @deprecated Use {@link createRuntimeContextFromFactory} instead —
+ * it auto-detects the platform and wires the correct services from the factory.
+ * This function is kept for backward compatibility with synchronous callers
+ * that manually configure services.
+ */
 export function createRuntimeContext(options = {}) {
     return new RuntimeContext(options);
 }

package/dist/file-system-cf.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Cloudflare Workers {@link FileSystem} stub.
+ *
+ * CF Workers have only an ephemeral, per-request virtual filesystem.
+ * Persistent file operations are not available. This stub throws clear
+ * errors directing developers to use D1, KV, or R2 instead.
+ *
+ * Non-mutating operations (`resolve`, `getProjectRoot`) return
+ * Worker-appropriate values without throwing.
+ *
+ * Note: Cloudflare Workers with `nodejs_compat` + `compatibility_date >= 2025-09-01`
+ * DO expose `node:fs` as an ephemeral, per-request virtual filesystem.
+ * We deliberately do NOT use it — the ephemeral nature means files written
+ * in one request silently vanish in the next. Throwing with guidance toward
+ * D1/KV/R2 is better DX than silent data loss.
+ */
+import type { FileSystem } from './file-system';
+/**
+ * Create a Cloudflare Workers {@link FileSystem} stub.
+ *
+ * `resolve()` and `getProjectRoot()` work as path utilities.
+ * All other methods throw with guidance toward CF-native storage.
+ */
+export declare function createCfFileSystem(): FileSystem;
+//# sourceMappingURL=file-system-cf.d.ts.map

package/dist/file-system-cf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-cf.d.ts","sourceRoot":"","sources":["../src/file-system-cf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CA8C/C"}

package/dist/file-system-cf.js

@@ -0,0 +1,59 @@
+/**
+ * Cloudflare Workers {@link FileSystem} stub.
+ *
+ * CF Workers have only an ephemeral, per-request virtual filesystem.
+ * Persistent file operations are not available. This stub throws clear
+ * errors directing developers to use D1, KV, or R2 instead.
+ *
+ * Non-mutating operations (`resolve`, `getProjectRoot`) return
+ * Worker-appropriate values without throwing.
+ *
+ * Note: Cloudflare Workers with `nodejs_compat` + `compatibility_date >= 2025-09-01`
+ * DO expose `node:fs` as an ephemeral, per-request virtual filesystem.
+ * We deliberately do NOT use it — the ephemeral nature means files written
+ * in one request silently vanish in the next. Throwing with guidance toward
+ * D1/KV/R2 is better DX than silent data loss.
+ */
+const UNSUPPORTED = 'FileSystem is not available on Cloudflare Workers. Use D1, KV, or R2 for persistent storage.';
+/**
+ * Create a Cloudflare Workers {@link FileSystem} stub.
+ *
+ * `resolve()` and `getProjectRoot()` work as path utilities.
+ * All other methods throw with guidance toward CF-native storage.
+ */
+export function createCfFileSystem() {
+    return {
+        getProjectRoot: () => '/bundle',
+        resolve: (...segments) => {
+            const joined = segments.join('/').replaceAll(/\/+/g, '/');
+            return joined.startsWith('/') ? joined : `/${joined}`;
+        },
+        exists: (_path) => false,
+        readFile: (_path) => {
+            throw new Error(`FileSystem.readFile: ${UNSUPPORTED}`);
+        },
+        writeFile: (_path, _content) => {
+            throw new Error(`FileSystem.writeFile: ${UNSUPPORTED}`);
+        },
+        appendFile: (_path, _content) => {
+            throw new Error(`FileSystem.appendFile: ${UNSUPPORTED}`);
+        },
+        ensureDir: (_path) => {
+            // No-op: CF Workers virtual filesystem handles directory
+            // creation internally when files are written.
+        },
+        readDir: (_path) => {
+            throw new Error(`FileSystem.readDir: ${UNSUPPORTED}`);
+        },
+        deleteFile: (_path) => {
+            throw new Error(`FileSystem.deleteFile: ${UNSUPPORTED}`);
+        },
+        createWriteStream: (_path) => {
+            throw new Error(`FileSystem.createWriteStream: ${UNSUPPORTED}`);
+        },
+        copy: (_src, _dest) => {
+            throw new Error(`FileSystem.copy: ${UNSUPPORTED}`);
+        },
+        stat: (_path) => null,
+    };
+}

package/dist/file-system-node.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `node:fs`-backed {@link FileSystem} implementation for Bun/Node.js.
+ *
+ * This is the production implementation for local development, VPS, and
+ * any environment with a real filesystem. Tests should inject a virtual
+ * file system.
+ *
+ * The implementation uses `node:fs` sync APIs by default. Bun polyfills
+ * `node:fs` fully, so this works on both runtimes without a Bun-specific
+ * variant.
+ */
+import type { FileSystem } from './file-system';
+/**
+ * Create a {@link FileSystem} backed by `node:fs`.
+ *
+ * @param root - Project root directory (default: walks up from `process.cwd()` looking for `bun.lock` or `package.json`).
+ */
+export declare function createNodeFileSystem(root?: string): FileSystem;
+/**
+ * Find the project root by walking up from `startDir` looking for a `bun.lock`
+ * or `package.json` marker. Uses `existsSync`, so it works on both Node and Bun.
+ *
+ * This is the single project-root discovery implementation; the deprecated
+ * {@link import('./fs').getProjectRoot} delegates here.
+ *
+ * @internal — exported for reuse by config loading.
+ */
+export declare function findProjectRoot(startDir: string): string;
+//# sourceMappingURL=file-system-node.d.ts.map

package/dist/file-system-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-node.d.ts","sourceRoot":"","sources":["../src/file-system-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAuD9D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/file-system-node.js

@@ -0,0 +1,94 @@
+/**
+ * `node:fs`-backed {@link FileSystem} implementation for Bun/Node.js.
+ *
+ * This is the production implementation for local development, VPS, and
+ * any environment with a real filesystem. Tests should inject a virtual
+ * file system.
+ *
+ * The implementation uses `node:fs` sync APIs by default. Bun polyfills
+ * `node:fs` fully, so this works on both runtimes without a Bun-specific
+ * variant.
+ */
+import { appendFileSync, cpSync, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { dirname, resolve as resolvePath } from 'node:path';
+/**
+ * Create a {@link FileSystem} backed by `node:fs`.
+ *
+ * @param root - Project root directory (default: walks up from `process.cwd()` looking for `bun.lock` or `package.json`).
+ */
+export function createNodeFileSystem(root) {
+    const projectRoot = root ?? findProjectRoot(process.cwd());
+    return {
+        getProjectRoot: () => projectRoot,
+        resolve: (...segments) => resolvePath(projectRoot, ...segments),
+        exists: (path) => existsSync(path),
+        readFile: (path) => readFileSync(path, 'utf-8'),
+        writeFile: (path, content) => {
+            ensureParentDir(path);
+            writeFileSync(path, content, 'utf-8');
+        },
+        appendFile: (path, content) => {
+            ensureParentDir(path);
+            appendFileSync(path, content, 'utf-8');
+        },
+        ensureDir: (path) => {
+            mkdirSync(path, { recursive: true });
+        },
+        readDir: (path) => readdirSync(path),
+        deleteFile: (path) => {
+            rmSync(path, { recursive: true, force: true });
+        },
+        createWriteStream: (path) => {
+            ensureParentDir(path);
+            return createWriteStream(path, { flags: 'a' });
+        },
+        copy: (src, dest) => {
+            cpSync(src, dest, { recursive: true });
+        },
+        stat: (path) => {
+            try {
+                const s = statSync(path);
+                return {
+                    isFile: () => s.isFile(),
+                    isDirectory: () => s.isDirectory(),
+                    size: s.size,
+                    mtimeMs: s.mtimeMs,
+                };
+            }
+            catch {
+                return null;
+            }
+        },
+    };
+}
+// ── Helpers ──────────────────────────────────────────────────────────────
+function ensureParentDir(filePath) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Find the project root by walking up from `startDir` looking for a `bun.lock`
+ * or `package.json` marker. Uses `existsSync`, so it works on both Node and Bun.
+ *
+ * This is the single project-root discovery implementation; the deprecated
+ * {@link import('./fs.js').getProjectRoot} delegates here.
+ *
+ * @internal — exported for reuse by config loading.
+ */
+export function findProjectRoot(startDir) {
+    let dir = resolvePath(startDir);
+    const root = resolvePath('/');
+    while (dir !== root) {
+        if (existsSync(resolvePath(dir, 'bun.lock')) || existsSync(resolvePath(dir, 'package.json'))) {
+            return dir;
+        }
+        const parent = resolvePath(dir, '..');
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Fallback: return the directory we started from.
+    return startDir;
+}

package/dist/file-system.d.ts

@@ -0,0 +1,47 @@
+/** Portable file stat subset. */
+export interface FileStat {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    size: number;
+    mtimeMs: number;
+}
+/**
+ * Runtime-agnostic file system abstraction.
+ *
+ * Bun/Node backend uses `node:fs`. Cloudflare Workers backend provides stubs
+ * that throw clear "not available" errors, directing developers to use D1,
+ * KV, or R2 for persistent storage.
+ *
+ * All code outside `packages/runtime/src/file-system*.ts` MUST use this
+ * interface — never import `node:fs` or call `Bun.write`/`Bun.file` directly.
+ */
+export interface FileSystem {
+    /** Check whether a path exists. */
+    exists(path: string): boolean | Promise<boolean>;
+    /** Read file contents as UTF-8 string. Throws if not found. */
+    readFile(path: string): string | Promise<string>;
+    /** Write file contents, creating parent directories as needed. */
+    writeFile(path: string, content: string): void | Promise<void>;
+    /** Append content to a file, creating it if it doesn't exist. */
+    appendFile(path: string, content: string): void | Promise<void>;
+    /** Ensure a directory exists, creating it (and parents) recursively if needed. */
+    ensureDir(path: string): void | Promise<void>;
+    /** List directory entries (names only, not full paths). */
+    readDir(path: string): string[] | Promise<string[]>;
+    /** Delete a file or directory recursively. */
+    deleteFile(path: string): void | Promise<void>;
+    /** Recursively copy a file or directory. */
+    copy(src: string, dest: string): void | Promise<void>;
+    /** Get file or directory stats. Returns `null` if the path doesn't exist. */
+    stat(path: string): FileStat | null | Promise<FileStat | null>;
+    /** Create a writable stream for append-only output (Node/Bun only). Throws on CF Workers. */
+    createWriteStream(path: string): {
+        write(chunk: string): void;
+        end(): void;
+    };
+    /** Resolve path segments relative to the project root. */
+    resolve(...segments: string[]): string;
+    /** Get the project root directory path. */
+    getProjectRoot(): string;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACvB,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,iEAAiE;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpD,8CAA8C;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE/D,6FAA6F;IAC7F,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,IAAI,IAAI,CAAA;KAAE,CAAC;IAE7E,0DAA0D;IAC1D,OAAO,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvC,2CAA2C;IAC3C,cAAc,IAAI,MAAM,CAAC;CAC5B"}

package/dist/fs.d.ts

@@ -1,13 +1,16 @@
+/** Portable file stat interface — mirrors the subset of `node:fs.Stats` used by the runtime. */
 export interface FileStat {
     isFile(): boolean;
     isDirectory(): boolean;
     size: number;
     mtimeMs: number;
 }
+/** Write-only append stream for log output. */
 export interface LogStream {
     write(chunk: string): void;
     end(): void;
 }
+/** @deprecated Use {@link import('./file-system').FileSystem} instead — the new interface has union return types and does not require a separate SyncFileSystem. */
 export interface FileSystem {
     readFile(path: string): Promise<string>;
     writeFile(path: string, content: string): Promise<void>;
@@ -22,6 +25,7 @@ export interface FileSystem {
     rename(src: string, dest: string): Promise<void>;
     createLogStream(path: string): LogStream;
 }
+/** @deprecated Use {@link import('./file-system').FileSystem} instead — its union return types make a separate sync interface unnecessary. */
 export interface SyncFileSystem {
     readFile(path: string): string;
     writeFile(path: string, content: string): void;
@@ -31,6 +35,8 @@ export interface SyncFileSystem {
     stat(path: string): FileStat | null;
     unlink(path: string): void;
 }
+/** {@link FileSystem} backed by `node:fs/promises`. Lazy-loads the module to avoid top-level import cost. */
+/** @deprecated Use createNodeFileSystem() from './file-system-node' instead. */
 export declare class NodeFileSystem implements FileSystem {
     readFile(path: string): Promise<string>;
     writeFile(path: string, content: string): Promise<void>;
@@ -45,6 +51,8 @@ export declare class NodeFileSystem implements FileSystem {
     rename(src: string, dest: string): Promise<void>;
     createLogStream(path: string): LogStream;
 }
+/** {@link SyncFileSystem} backed by `node:fs` synchronous APIs. */
+/** @deprecated Use createNodeFileSystem() from './file-system-node' instead — its FileSystem interface has union return types, eliminating the need for a separate sync implementation. */
 export declare class NodeSyncFileSystem implements SyncFileSystem {
     readFile(path: string): string;
     writeFile(path: string, content: string): void;
@@ -54,6 +62,8 @@ export declare class NodeSyncFileSystem implements SyncFileSystem {
     stat(path: string): FileStat | null;
     unlink(path: string): void;
 }
+/** {@link FileSystem} stub for Cloudflare Workers — all file operations throw. Use D1, KV, or R2 instead. */
+/** @deprecated Use createCfFileSystem() from './file-system-cf' instead. */
 export declare class CloudflareFileSystem implements FileSystem {
     readFile(path: string): Promise<string>;
     writeFile(path: string, _content: string): Promise<void>;
@@ -68,16 +78,36 @@ export declare class CloudflareFileSystem implements FileSystem {
     rename(src: string, _dest: string): Promise<void>;
     createLogStream(path: string): LogStream;
 }
+/** Swaps the active global file system, returning a restore function for the previous instance. */
+/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. The global swap is replaced by factory-based DI. */
 export declare function setFileSystem(fileSystem: FileSystem): () => void;
+/** Returns the currently active global {@link FileSystem} instance. */
+/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. */
 export declare function getFs(): FileSystem;
+/** Creates parent directories for a file path before writing. */
 export declare function ensureDirForFile(path: string, fs?: FileSystem): Promise<void>;
+/** Synchronous variant of {@link ensureDirForFile}. */
+/** @deprecated The new createNodeFileSystem() handles parent-directory creation internally. */
 export declare function ensureDirForFileSync(path: string, fs: SyncFileSystem): void;
+/** Atomically writes a file by writing to a temp path then renaming, avoiding partial writes on crash. */
 export declare function atomicWriteFile(path: string, content: string, fs?: FileSystem): Promise<void>;
+/** Atomically writes a value as JSON with trailing newline. */
 export declare function atomicWriteJson(path: string, value: unknown, fs?: FileSystem): Promise<void>;
+/** Reads and parses a JSON file. */
 export declare function readJsonFile<T = unknown>(path: string, fs?: FileSystem): Promise<T>;
+/** Writes a value as JSON with 2-space indentation and trailing newline. */
 export declare function writeJsonFile(path: string, value: unknown, fs?: FileSystem): Promise<void>;
-export declare function walkDir(path: string, fs?: FileSystem): Promise<string[]>;
+/** Recursively walks a directory, returning sorted paths to all files, optionally excluding entries by name. */
+export declare function walkDir(path: string, fs?: FileSystem, exclude?: Set<string>): Promise<string[]>;
+/**
+ * Walks up from `startDir` looking for a `package.json` or `bun.lock` to locate the project root.
+ *
+ * @deprecated Use {@link import('./file-system-node').findProjectRoot} (or `createNodeFileSystem().getProjectRoot()`).
+ * This delegates to the single shared implementation.
+ */
 export declare function getProjectRoot(startDir?: string): string;
+/** Resolves path segments relative to the project root. */
 export declare function resolveProjectPath(...segments: string[]): string;
+/** Creates a {@link LogStream} at the given path using the active file system. */
 export declare function createLogStream(path: string, fs?: FileSystem): LogStream;
 //# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

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