@generacy-ai/generacy 0.0.0-preview-20260304013206

package/dist/cli/utils/logger.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLI logger setup using Pino.
+ * Provides structured logging with pretty output for dev and JSON for prod.
+ */
+import pino from 'pino';
+import type { Logger as WorkflowLogger } from '@generacy-ai/workflow-engine';
+/**
+ * Log levels supported by the CLI
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' | 'silent';
+/**
+ * Logger options
+ */
+export interface LoggerOptions {
+    level?: LogLevel;
+    pretty?: boolean;
+    name?: string;
+}
+/**
+ * Create a Pino logger instance
+ */
+export declare function createLogger(options?: LoggerOptions): pino.Logger;
+/**
+ * Get or create the default logger
+ */
+export declare function getLogger(): pino.Logger;
+/**
+ * Set the default logger instance
+ */
+export declare function setLogger(logger: pino.Logger): void;
+/**
+ * Adapter to convert Pino logger to WorkflowLogger interface
+ */
+export declare class PinoWorkflowLogger implements WorkflowLogger {
+    private readonly pino;
+    constructor(pino: pino.Logger);
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    debug(message: string, ...args: unknown[]): void;
+    child(bindings: Record<string, unknown>): WorkflowLogger;
+}
+/**
+ * Create a workflow logger from a Pino logger
+ */
+export declare function createWorkflowLogger(pino: pino.Logger): WorkflowLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/cli/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAAC,MAAM,CAoBrE;AAOD;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAAC,MAAM,CAKvC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAEnD;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI,CAAC,MAAM;IAE9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQ/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQ/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAQhD,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc;CAGzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,GAAG,cAAc,CAEtE"}

package/dist/cli/utils/logger.js

@@ -0,0 +1,97 @@
+/**
+ * CLI logger setup using Pino.
+ * Provides structured logging with pretty output for dev and JSON for prod.
+ */
+import pino from 'pino';
+/**
+ * Create a Pino logger instance
+ */
+export function createLogger(options = {}) {
+    const level = options.level ?? process.env['LOG_LEVEL'] ?? 'info';
+    const pretty = options.pretty ?? process.env['NODE_ENV'] !== 'production';
+    const transport = pretty
+        ? {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                translateTime: 'SYS:standard',
+                ignore: 'pid,hostname',
+            },
+        }
+        : undefined;
+    return pino({
+        name: options.name ?? 'generacy',
+        level,
+        transport,
+    });
+}
+/**
+ * Default CLI logger instance
+ */
+let defaultLogger = null;
+/**
+ * Get or create the default logger
+ */
+export function getLogger() {
+    if (!defaultLogger) {
+        defaultLogger = createLogger();
+    }
+    return defaultLogger;
+}
+/**
+ * Set the default logger instance
+ */
+export function setLogger(logger) {
+    defaultLogger = logger;
+}
+/**
+ * Adapter to convert Pino logger to WorkflowLogger interface
+ */
+export class PinoWorkflowLogger {
+    pino;
+    constructor(pino) {
+        this.pino = pino;
+    }
+    info(message, ...args) {
+        if (args.length > 0) {
+            this.pino.info({ data: args }, message);
+        }
+        else {
+            this.pino.info(message);
+        }
+    }
+    warn(message, ...args) {
+        if (args.length > 0) {
+            this.pino.warn({ data: args }, message);
+        }
+        else {
+            this.pino.warn(message);
+        }
+    }
+    error(message, ...args) {
+        if (args.length > 0) {
+            this.pino.error({ data: args }, message);
+        }
+        else {
+            this.pino.error(message);
+        }
+    }
+    debug(message, ...args) {
+        if (args.length > 0) {
+            this.pino.debug({ data: args }, message);
+        }
+        else {
+            this.pino.debug(message);
+        }
+    }
+    child(bindings) {
+        return new PinoWorkflowLogger(this.pino.child(bindings));
+    }
+}
+/**
+ * Create a workflow logger from a Pino logger
+ */
+export function createWorkflowLogger(pino) {
+    return new PinoWorkflowLogger(pino);
+}
+//# sourceMappingURL=logger.js.map

package/dist/cli/utils/logger.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @generacy-ai/generacy/config
+ *
+ * Configuration schema and validation for Generacy projects.
+ * Defines the .generacy/config.yaml schema and provides type-safe validation.
+ */
+export { ProjectConfigSchema, type ProjectConfig, ReposConfigSchema, type ReposConfig, DefaultsConfigSchema, type DefaultsConfig, OrchestratorSettingsSchema, type OrchestratorSettings, ClusterConfigSchema, type ClusterConfig, GeneracyConfigSchema, type GeneracyConfig, validateConfig, } from './schema.js';
+export { ConfigValidationError, validateNoDuplicateRepos, validateSemantics, } from './validator.js';
+export { loadConfig, findConfigFile, parseConfig, type LoadConfigOptions, ConfigNotFoundError, ConfigParseError, ConfigSchemaError, } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,iBAAiB,EACjB,KAAK,WAAW,EAChB,oBAAoB,EACpB,KAAK,cAAc,EACnB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,mBAAmB,EACnB,KAAK,aAAa,EAClB,oBAAoB,EACpB,KAAK,cAAc,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,KAAK,iBAAiB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,13 @@
+/**
+ * @generacy-ai/generacy/config
+ *
+ * Configuration schema and validation for Generacy projects.
+ * Defines the .generacy/config.yaml schema and provides type-safe validation.
+ */
+// Export all schemas and types
+export { ProjectConfigSchema, ReposConfigSchema, DefaultsConfigSchema, OrchestratorSettingsSchema, ClusterConfigSchema, GeneracyConfigSchema, validateConfig, } from './schema.js';
+// Export validation utilities
+export { ConfigValidationError, validateNoDuplicateRepos, validateSemantics, } from './validator.js';
+// Export loader utilities
+export { loadConfig, findConfigFile, parseConfig, ConfigNotFoundError, ConfigParseError, ConfigSchemaError, } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,OAAO,EACL,mBAAmB,EAEnB,iBAAiB,EAEjB,oBAAoB,EAEpB,0BAA0B,EAE1B,mBAAmB,EAEnB,oBAAoB,EAEpB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,0BAA0B;AAC1B,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EAEX,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,104 @@
+import { ZodError } from 'zod';
+import { type GeneracyConfig } from './schema.js';
+/**
+ * Error thrown when config file cannot be found
+ */
+export declare class ConfigNotFoundError extends Error {
+    readonly startDir: string;
+    readonly searchPath: string[];
+    constructor(startDir: string, searchPath: string[]);
+}
+/**
+ * Error thrown when config file contains invalid YAML
+ */
+export declare class ConfigParseError extends Error {
+    readonly filePath: string;
+    readonly cause: Error;
+    constructor(filePath: string, cause: Error);
+}
+/**
+ * Error thrown when config file fails schema validation
+ */
+export declare class ConfigSchemaError extends Error {
+    readonly filePath: string;
+    readonly errors: ZodError;
+    constructor(filePath: string, errors: ZodError);
+}
+/**
+ * Find the config file by walking up the directory tree
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to config file, or null if not found
+ *
+ * Discovery order:
+ * 1. Check for .generacy/config.yaml in current directory
+ * 2. Walk up parent directories until found
+ * 3. Stop at repository root (detected via .git/ directory)
+ * 4. Return null if not found
+ */
+export declare function findConfigFile(startDir?: string): string | null;
+/**
+ * Parse and validate a YAML config string
+ *
+ * @param yamlContent - YAML content as string
+ * @returns Validated configuration
+ * @throws ConfigParseError if YAML parsing fails
+ * @throws ConfigSchemaError if validation fails
+ * @throws ConfigValidationError if semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = parseConfig(`
+ *   project:
+ *     id: "proj_abc123"
+ *     name: "My Project"
+ *   repos:
+ *     primary: "github.com/acme/main"
+ * `);
+ * ```
+ */
+export declare function parseConfig(yamlContent: string): GeneracyConfig;
+/**
+ * Options for loading configuration
+ */
+export interface LoadConfigOptions {
+    /**
+     * Directory to start searching from
+     * Default: process.cwd()
+     */
+    startDir?: string;
+    /**
+     * Explicit config file path (skips discovery)
+     * Default: undefined (will search using findConfigFile)
+     */
+    configPath?: string;
+}
+/**
+ * Load and validate configuration from filesystem
+ *
+ * Discovery process:
+ * 1. If GENERACY_CONFIG_PATH env var is set, use that path
+ * 2. If options.configPath is provided, use that path
+ * 3. Otherwise, search for .generacy/config.yaml using findConfigFile
+ *
+ * @param options - Loading options
+ * @returns Validated configuration
+ * @throws ConfigNotFoundError if config file not found
+ * @throws ConfigParseError if YAML parsing fails
+ * @throws ConfigSchemaError if validation fails
+ * @throws ConfigValidationError if semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * // Auto-discover config
+ * const config = loadConfig();
+ *
+ * // Explicit path
+ * const config = loadConfig({ configPath: '/path/to/config.yaml' });
+ *
+ * // Start search from specific directory
+ * const config = loadConfig({ startDir: '/workspace/project' });
+ * ```
+ */
+export declare function loadConfig(options?: LoadConfigOptions): GeneracyConfig;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAkB,MAAM,aAAa,CAAC;AAkBlE;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,QAAQ,EAAE,MAAM;aAChB,UAAU,EAAE,MAAM,EAAE;gBADpB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE;CAQvC;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,QAAQ,EAAE,MAAM;aAChB,KAAK,EAAE,KAAK;gBADZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK;CAK/B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,QAAQ,EAAE,MAAM;aAChB,MAAM,EAAE,QAAQ;gBADhB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ;CAgBnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAsB9E;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA2B/D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CA4F1E"}

package/dist/config/loader.js

@@ -0,0 +1,266 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname, join, parse } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { ZodError } from 'zod';
+import { validateConfig } from './schema.js';
+import { validateSemantics } from './validator.js';
+/**
+ * Environment variable for explicit config path override
+ */
+const CONFIG_PATH_ENV = 'GENERACY_CONFIG_PATH';
+/**
+ * Default config file name
+ */
+const CONFIG_FILE_NAME = 'config.yaml';
+/**
+ * Directory containing config file
+ */
+const CONFIG_DIR_NAME = '.generacy';
+/**
+ * Error thrown when config file cannot be found
+ */
+export class ConfigNotFoundError extends Error {
+    startDir;
+    searchPath;
+    constructor(startDir, searchPath) {
+        super(`Config file not found. Searched in:\n${searchPath.map(p => `  - ${p}`).join('\n')}\n\n` +
+            `Create a config file at: ${join(startDir, CONFIG_DIR_NAME, CONFIG_FILE_NAME)}`);
+        this.startDir = startDir;
+        this.searchPath = searchPath;
+        this.name = 'ConfigNotFoundError';
+    }
+}
+/**
+ * Error thrown when config file contains invalid YAML
+ */
+export class ConfigParseError extends Error {
+    filePath;
+    cause;
+    constructor(filePath, cause) {
+        super(`Failed to parse config file: ${filePath}\n\n${cause.message}`);
+        this.filePath = filePath;
+        this.cause = cause;
+        this.name = 'ConfigParseError';
+    }
+}
+/**
+ * Error thrown when config file fails schema validation
+ */
+export class ConfigSchemaError extends Error {
+    filePath;
+    errors;
+    constructor(filePath, errors) {
+        const errorMessages = errors.errors
+            .map(err => {
+            const path = err.path.length > 0 ? err.path.join('.') : 'root';
+            return `  - ${path}: ${err.message}`;
+        })
+            .join('\n');
+        super(`Config validation failed: ${filePath}\n\n` +
+            `Validation errors:\n${errorMessages}\n\n` +
+            `See documentation for schema reference.`);
+        this.filePath = filePath;
+        this.errors = errors;
+        this.name = 'ConfigSchemaError';
+    }
+}
+/**
+ * Find the config file by walking up the directory tree
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Absolute path to config file, or null if not found
+ *
+ * Discovery order:
+ * 1. Check for .generacy/config.yaml in current directory
+ * 2. Walk up parent directories until found
+ * 3. Stop at repository root (detected via .git/ directory)
+ * 4. Return null if not found
+ */
+export function findConfigFile(startDir = process.cwd()) {
+    let currentDir = resolve(startDir);
+    const root = parse(currentDir).root;
+    const searchPath = [];
+    while (currentDir !== root) {
+        const configPath = join(currentDir, CONFIG_DIR_NAME, CONFIG_FILE_NAME);
+        searchPath.push(configPath);
+        if (existsSync(configPath)) {
+            return configPath;
+        }
+        // Stop at repository root
+        if (existsSync(join(currentDir, '.git'))) {
+            break;
+        }
+        currentDir = dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Load configuration from a YAML file
+ *
+ * @param filePath - Path to the config file
+ * @returns Parsed configuration object (unvalidated)
+ * @throws ConfigParseError if YAML parsing fails
+ */
+function loadFromFile(filePath) {
+    const absolutePath = resolve(filePath);
+    if (!existsSync(absolutePath)) {
+        throw new Error(`Configuration file not found: ${absolutePath}`);
+    }
+    try {
+        const content = readFileSync(absolutePath, 'utf-8');
+        return parseYaml(content);
+    }
+    catch (error) {
+        throw new ConfigParseError(absolutePath, error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/**
+ * Parse and validate a YAML config string
+ *
+ * @param yamlContent - YAML content as string
+ * @returns Validated configuration
+ * @throws ConfigParseError if YAML parsing fails
+ * @throws ConfigSchemaError if validation fails
+ * @throws ConfigValidationError if semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * const config = parseConfig(`
+ *   project:
+ *     id: "proj_abc123"
+ *     name: "My Project"
+ *   repos:
+ *     primary: "github.com/acme/main"
+ * `);
+ * ```
+ */
+export function parseConfig(yamlContent) {
+    let parsed;
+    try {
+        parsed = parseYaml(yamlContent);
+    }
+    catch (error) {
+        throw new ConfigParseError('<string>', error instanceof Error ? error : new Error(String(error)));
+    }
+    // Structural validation (Zod schema)
+    let config;
+    try {
+        config = validateConfig(parsed);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            throw new ConfigSchemaError('<string>', error);
+        }
+        throw error;
+    }
+    // Semantic validation (custom validators)
+    validateSemantics(config);
+    return config;
+}
+/**
+ * Load and validate configuration from filesystem
+ *
+ * Discovery process:
+ * 1. If GENERACY_CONFIG_PATH env var is set, use that path
+ * 2. If options.configPath is provided, use that path
+ * 3. Otherwise, search for .generacy/config.yaml using findConfigFile
+ *
+ * @param options - Loading options
+ * @returns Validated configuration
+ * @throws ConfigNotFoundError if config file not found
+ * @throws ConfigParseError if YAML parsing fails
+ * @throws ConfigSchemaError if validation fails
+ * @throws ConfigValidationError if semantic validation fails
+ *
+ * @example
+ * ```typescript
+ * // Auto-discover config
+ * const config = loadConfig();
+ *
+ * // Explicit path
+ * const config = loadConfig({ configPath: '/path/to/config.yaml' });
+ *
+ * // Start search from specific directory
+ * const config = loadConfig({ startDir: '/workspace/project' });
+ * ```
+ */
+export function loadConfig(options = {}) {
+    const { startDir = process.cwd(), configPath } = options;
+    // Priority 1: Environment variable
+    const envConfigPath = process.env[CONFIG_PATH_ENV];
+    if (envConfigPath) {
+        const absolutePath = resolve(envConfigPath);
+        if (!existsSync(absolutePath)) {
+            throw new ConfigNotFoundError(startDir, [absolutePath]);
+        }
+        const rawConfig = loadFromFile(absolutePath);
+        // Structural validation
+        let config;
+        try {
+            config = validateConfig(rawConfig);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                throw new ConfigSchemaError(absolutePath, error);
+            }
+            throw error;
+        }
+        // Semantic validation
+        validateSemantics(config);
+        return config;
+    }
+    // Priority 2: Explicit path from options
+    if (configPath) {
+        const absolutePath = resolve(configPath);
+        if (!existsSync(absolutePath)) {
+            throw new ConfigNotFoundError(startDir, [absolutePath]);
+        }
+        const rawConfig = loadFromFile(absolutePath);
+        // Structural validation
+        let config;
+        try {
+            config = validateConfig(rawConfig);
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                throw new ConfigSchemaError(absolutePath, error);
+            }
+            throw error;
+        }
+        // Semantic validation
+        validateSemantics(config);
+        return config;
+    }
+    // Priority 3: Auto-discover
+    const discoveredPath = findConfigFile(startDir);
+    if (!discoveredPath) {
+        // Build search path for error message
+        const searchPath = [];
+        let currentDir = resolve(startDir);
+        const root = parse(currentDir).root;
+        while (currentDir !== root) {
+            searchPath.push(join(currentDir, CONFIG_DIR_NAME, CONFIG_FILE_NAME));
+            if (existsSync(join(currentDir, '.git'))) {
+                break;
+            }
+            currentDir = dirname(currentDir);
+        }
+        throw new ConfigNotFoundError(startDir, searchPath);
+    }
+    const rawConfig = loadFromFile(discoveredPath);
+    // Structural validation
+    let config;
+    try {
+        config = validateConfig(rawConfig);
+    }
+    catch (error) {
+        if (error instanceof ZodError) {
+            throw new ConfigSchemaError(discoveredPath, error);
+        }
+        throw error;
+    }
+    // Semantic validation
+    validateSemantics(config);
+    return config;
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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