@stoneforge/quarry 0.1.0

package/dist/config/file.js

@@ -0,0 +1,365 @@
+/**
+ * Configuration File Loading
+ *
+ * Handles YAML configuration file parsing, discovery, and writing.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import * as yaml from 'yaml';
+import { ValidationError, ErrorCode } from '@stoneforge/core';
+import { isValidIdentityMode } from '../systems/identity.js';
+import { parseDurationValue } from './duration.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default config file name */
+export const CONFIG_FILE_NAME = 'config.yaml';
+/** Default .stoneforge directory name */
+export const STONEFORGE_DIR = '.stoneforge';
+// ============================================================================
+// File Discovery
+// ============================================================================
+/**
+ * Finds the nearest .stoneforge directory by walking up from the given directory.
+ *
+ * This function first checks the STONEFORGE_ROOT environment variable, which
+ * is used to support agents working in git worktrees. When an agent is spawned
+ * in a worktree, STONEFORGE_ROOT points to the main workspace root where the
+ * SQLite database lives.
+ *
+ * @param startDir - Directory to start searching from
+ * @returns Path to .stoneforge directory, or undefined if not found
+ */
+export function findStoneforgeDir(startDir) {
+    // Check STONEFORGE_ROOT env var first - used for worktree root-finding
+    // When agents work in git worktrees, they need to access the main
+    // workspace's .stoneforge directory where the SQLite database lives
+    const envRoot = process.env.STONEFORGE_ROOT;
+    if (envRoot) {
+        const stoneforgePath = path.join(envRoot, STONEFORGE_DIR);
+        if (fs.existsSync(stoneforgePath) && fs.statSync(stoneforgePath).isDirectory()) {
+            return stoneforgePath;
+        }
+    }
+    // Fall back to walk-up search
+    let currentDir = path.resolve(startDir);
+    const root = path.parse(currentDir).root;
+    while (currentDir !== root) {
+        const stoneforgePath = path.join(currentDir, STONEFORGE_DIR);
+        if (fs.existsSync(stoneforgePath) && fs.statSync(stoneforgePath).isDirectory()) {
+            return stoneforgePath;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    // Check root
+    const rootStoneforgePath = path.join(root, STONEFORGE_DIR);
+    if (fs.existsSync(rootStoneforgePath) && fs.statSync(rootStoneforgePath).isDirectory()) {
+        return rootStoneforgePath;
+    }
+    return undefined;
+}
+/**
+ * Gets the global config directory path
+ */
+export function getGlobalConfigDir() {
+    return path.join(os.homedir(), STONEFORGE_DIR);
+}
+/**
+ * Gets the global config file path
+ */
+export function getGlobalConfigPath() {
+    return path.join(getGlobalConfigDir(), CONFIG_FILE_NAME);
+}
+/**
+ * Discovers the configuration file location
+ *
+ * @param overridePath - Optional override path to use
+ * @param startDir - Directory to start searching from (default: cwd)
+ * @returns Discovery result with path and existence info
+ */
+export function discoverConfigFile(overridePath, startDir = process.cwd()) {
+    // If override path is provided, use it directly
+    if (overridePath) {
+        const resolvedPath = path.resolve(overridePath);
+        const exists = fs.existsSync(resolvedPath);
+        return {
+            path: resolvedPath,
+            exists,
+            stoneforgeDir: exists ? path.dirname(resolvedPath) : undefined,
+        };
+    }
+    // Try to find .stoneforge directory
+    const stoneforgeDir = findStoneforgeDir(startDir);
+    if (stoneforgeDir) {
+        const configPath = path.join(stoneforgeDir, CONFIG_FILE_NAME);
+        return {
+            path: configPath,
+            exists: fs.existsSync(configPath),
+            stoneforgeDir,
+        };
+    }
+    // Fall back to global config
+    const globalPath = getGlobalConfigPath();
+    return {
+        path: globalPath,
+        exists: fs.existsSync(globalPath),
+        stoneforgeDir: fs.existsSync(getGlobalConfigDir()) ? getGlobalConfigDir() : undefined,
+    };
+}
+// ============================================================================
+// YAML Parsing
+// ============================================================================
+/**
+ * Parses YAML content into a config file structure
+ *
+ * @param content - YAML string content
+ * @param filePath - Path to file (for error messages)
+ * @returns Parsed YAML config object
+ */
+export function parseYamlConfig(content, filePath) {
+    try {
+        const parsed = yaml.parse(content);
+        if (parsed === null || parsed === undefined) {
+            return {};
+        }
+        if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new ValidationError(`Configuration file must contain an object${filePath ? ` (${filePath})` : ''}`, ErrorCode.INVALID_INPUT, { value: parsed });
+        }
+        return parsed;
+    }
+    catch (err) {
+        if (err instanceof ValidationError) {
+            throw err;
+        }
+        throw new ValidationError(`Failed to parse YAML configuration${filePath ? ` (${filePath})` : ''}: ${err instanceof Error ? err.message : String(err)}`, ErrorCode.INVALID_INPUT, { filePath });
+    }
+}
+/**
+ * Converts YAML config (snake_case) to internal format (camelCase)
+ *
+ * @param yamlConfig - Parsed YAML config
+ * @returns Partial configuration in internal format
+ */
+export function convertYamlToConfig(yamlConfig) {
+    const result = {};
+    // Direct fields
+    if (yamlConfig.actor !== undefined) {
+        result.actor = yamlConfig.actor;
+    }
+    if (yamlConfig.database !== undefined) {
+        result.database = yamlConfig.database;
+    }
+    // Sync section
+    if (yamlConfig.sync) {
+        result.sync = {};
+        if (yamlConfig.sync.auto_export !== undefined) {
+            result.sync.autoExport = yamlConfig.sync.auto_export;
+        }
+        if (yamlConfig.sync.export_debounce !== undefined) {
+            result.sync.exportDebounce = parseDurationValue(yamlConfig.sync.export_debounce);
+        }
+        if (yamlConfig.sync.elements_file !== undefined) {
+            result.sync.elementsFile = yamlConfig.sync.elements_file;
+        }
+        if (yamlConfig.sync.dependencies_file !== undefined) {
+            result.sync.dependenciesFile = yamlConfig.sync.dependencies_file;
+        }
+    }
+    // Playbooks section
+    if (yamlConfig.playbooks?.paths) {
+        result.playbooks = {
+            paths: yamlConfig.playbooks.paths,
+        };
+    }
+    // Tombstone section
+    if (yamlConfig.tombstone) {
+        result.tombstone = {};
+        if (yamlConfig.tombstone.ttl !== undefined) {
+            result.tombstone.ttl = parseDurationValue(yamlConfig.tombstone.ttl);
+        }
+        if (yamlConfig.tombstone.min_ttl !== undefined) {
+            result.tombstone.minTtl = parseDurationValue(yamlConfig.tombstone.min_ttl);
+        }
+    }
+    // Identity section
+    if (yamlConfig.identity) {
+        result.identity = {};
+        if (yamlConfig.identity.mode !== undefined) {
+            if (!isValidIdentityMode(yamlConfig.identity.mode)) {
+                throw new ValidationError(`Invalid identity mode: '${yamlConfig.identity.mode}'. Must be one of: soft, cryptographic, hybrid`, ErrorCode.INVALID_INPUT, { field: 'identity.mode', value: yamlConfig.identity.mode });
+            }
+            result.identity.mode = yamlConfig.identity.mode;
+        }
+        if (yamlConfig.identity.time_tolerance !== undefined) {
+            result.identity.timeTolerance = parseDurationValue(yamlConfig.identity.time_tolerance);
+        }
+    }
+    // Plugins section
+    if (yamlConfig.plugins?.packages) {
+        result.plugins = {
+            packages: yamlConfig.plugins.packages,
+        };
+    }
+    return result;
+}
+/**
+ * Reads and parses a configuration file
+ *
+ * @param filePath - Path to the configuration file
+ * @returns Partial configuration from the file
+ */
+export function readConfigFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return {};
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const yamlConfig = parseYamlConfig(content, filePath);
+        return convertYamlToConfig(yamlConfig);
+    }
+    catch (err) {
+        if (err instanceof ValidationError) {
+            throw err;
+        }
+        throw new ValidationError(`Failed to read configuration file '${filePath}': ${err instanceof Error ? err.message : String(err)}`, ErrorCode.INVALID_INPUT, { filePath });
+    }
+}
+// ============================================================================
+// YAML Writing
+// ============================================================================
+/**
+ * Converts internal config (camelCase) to YAML format (snake_case)
+ *
+ * @param config - Configuration in internal format
+ * @returns YAML config object
+ */
+export function convertConfigToYaml(config) {
+    const result = {};
+    // Direct fields
+    if (config.actor !== undefined) {
+        result.actor = config.actor;
+    }
+    if (config.database !== undefined) {
+        result.database = config.database;
+    }
+    // Sync section
+    if (config.sync) {
+        result.sync = {};
+        if (config.sync.autoExport !== undefined) {
+            result.sync.auto_export = config.sync.autoExport;
+        }
+        if (config.sync.exportDebounce !== undefined) {
+            result.sync.export_debounce = config.sync.exportDebounce;
+        }
+        if (config.sync.elementsFile !== undefined) {
+            result.sync.elements_file = config.sync.elementsFile;
+        }
+        if (config.sync.dependenciesFile !== undefined) {
+            result.sync.dependencies_file = config.sync.dependenciesFile;
+        }
+    }
+    // Playbooks section
+    if (config.playbooks?.paths) {
+        result.playbooks = {
+            paths: config.playbooks.paths,
+        };
+    }
+    // Tombstone section
+    if (config.tombstone) {
+        result.tombstone = {};
+        if (config.tombstone.ttl !== undefined) {
+            result.tombstone.ttl = config.tombstone.ttl;
+        }
+        if (config.tombstone.minTtl !== undefined) {
+            result.tombstone.min_ttl = config.tombstone.minTtl;
+        }
+    }
+    // Identity section
+    if (config.identity) {
+        result.identity = {};
+        if (config.identity.mode !== undefined) {
+            result.identity.mode = config.identity.mode;
+        }
+        if (config.identity.timeTolerance !== undefined) {
+            result.identity.time_tolerance = config.identity.timeTolerance;
+        }
+    }
+    // Plugins section
+    if (config.plugins?.packages && config.plugins.packages.length > 0) {
+        result.plugins = {
+            packages: config.plugins.packages,
+        };
+    }
+    return result;
+}
+/**
+ * Serializes configuration to YAML string
+ *
+ * @param config - Configuration to serialize
+ * @returns YAML string
+ */
+export function serializeConfigToYaml(config) {
+    const yamlConfig = convertConfigToYaml(config);
+    return yaml.stringify(yamlConfig, {
+        indent: 2,
+        lineWidth: 120,
+    });
+}
+/**
+ * Writes configuration to a file
+ *
+ * @param filePath - Path to write to
+ * @param config - Configuration to write
+ */
+export function writeConfigFile(filePath, config) {
+    const dir = path.dirname(filePath);
+    // Ensure directory exists
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const content = `# Stoneforge Configuration\n\n${serializeConfigToYaml(config)}`;
+    fs.writeFileSync(filePath, content, 'utf-8');
+}
+/**
+ * Updates a configuration file by merging with existing content
+ *
+ * @param filePath - Path to the configuration file
+ * @param updates - Partial configuration to merge
+ */
+export function updateConfigFile(filePath, updates) {
+    // Read existing config
+    const existing = readConfigFile(filePath);
+    // Merge updates with the help of deep merge
+    const merged = {
+        ...existing,
+        ...updates,
+        sync: updates.sync ? { ...existing.sync, ...updates.sync } : existing.sync,
+        playbooks: updates.playbooks ? { ...existing.playbooks, ...updates.playbooks } : existing.playbooks,
+        tombstone: updates.tombstone ? { ...existing.tombstone, ...updates.tombstone } : existing.tombstone,
+        identity: updates.identity ? { ...existing.identity, ...updates.identity } : existing.identity,
+    };
+    writeConfigFile(filePath, merged);
+}
+// ============================================================================
+// Path Expansion
+// ============================================================================
+/**
+ * Expands ~ to home directory in a path
+ */
+export function expandPath(filePath) {
+    if (filePath.startsWith('~/')) {
+        return path.join(os.homedir(), filePath.slice(2));
+    }
+    if (filePath === '~') {
+        return os.homedir();
+    }
+    return filePath;
+}
+/**
+ * Expands ~ in all playbook paths
+ */
+export function expandPlaybookPaths(paths) {
+    return paths.map(expandPath);
+}
+//# sourceMappingURL=file.js.map

package/dist/config/file.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configuration System
+ *
+ * Manages settings for Stoneforge, supporting file-based configuration,
+ * environment variables, and CLI overrides with a clear precedence hierarchy.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadConfig,
+ *   getConfig,
+ *   getValue,
+ *   setValue,
+ *   getDefaultConfig,
+ * } from './config/index.js';
+ *
+ * // Load and access configuration
+ * const config = loadConfig();
+ * const actor = getValue('actor');
+ * const mode = getValue('identity.mode');
+ *
+ * // Modify configuration
+ * setValue('actor', 'my-agent');
+ * ```
+ */
+export type { Duration, DurationString, SyncConfig, PlaybookConfig, TombstoneConfig, IdentityConfigSection, PluginsConfig, Configuration, PartialConfiguration, ConfigSource, TrackedValue, TrackedConfiguration, YamlConfigFile, ConfigFileDiscovery, ConfigValidationResult, ConfigPath, ConfigPathTypes, LoadConfigOptions, EnvVar, } from './types.js';
+export { EnvVars, ConfigSource as ConfigSourceEnum, VALID_CONFIG_PATHS, isValidConfigPath } from './types.js';
+export { DEFAULT_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_PLAYBOOK_CONFIG, DEFAULT_TOMBSTONE_CONFIG, DEFAULT_IDENTITY_CONFIG, DEFAULT_PLUGINS_CONFIG, getDefaultConfig, ONE_SECOND, ONE_MINUTE, ONE_HOUR, ONE_DAY, MIN_EXPORT_DEBOUNCE, MAX_EXPORT_DEBOUNCE, MIN_TIME_TOLERANCE, MAX_TIME_TOLERANCE, MAX_TTL, } from './defaults.js';
+export { DURATION_UNITS, isDurationString, parseDuration, parseDurationValue, tryParseDuration, formatDuration, formatDurationHuman, validateDurationRange, } from './duration.js';
+export { isValidActor, validateActor, isValidDatabase, validateDatabase, isValidJsonlFilename, validateJsonlFilename, isValidPlaybookPaths, validatePlaybookPaths, validateConfiguration, validateConfigurationSafe, validatePartialConfiguration, } from './validation.js';
+export { deepMerge, mergeConfiguration, mergeConfigurations, createConfiguration, cloneConfiguration, diffConfigurations, configurationsEqual, } from './merge.js';
+export { CONFIG_FILE_NAME, STONEFORGE_DIR, findStoneforgeDir, getGlobalConfigDir, getGlobalConfigPath, discoverConfigFile, parseYamlConfig, convertYamlToConfig, readConfigFile, convertConfigToYaml, serializeConfigToYaml, writeConfigFile, updateConfigFile, expandPath, expandPlaybookPaths, } from './file.js';
+export { parseEnvBoolean, isEnvBoolean, parseEnvDuration, getEnvVar, hasEnvVar, loadEnvConfig, getEnvConfigPath, getEnvJsonMode, getEnvVerboseMode, getEnvVarInfo, getSetEnvVars, } from './env.js';
+export { loadConfig, getConfig, getTrackedConfig, reloadConfig, clearConfigCache, getValue, getValueFromConfig, getValueSource, getValueWithSource, setValue, unsetValue, getConfigPath, configFileExists, saveConfig, } from './config.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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,YAAY,EACV,QAAQ,EACR,cAAc,EACd,UAAU,EACV,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,MAAM,GACP,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG9G,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,GACR,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,41 @@
+/**
+ * Configuration System
+ *
+ * Manages settings for Stoneforge, supporting file-based configuration,
+ * environment variables, and CLI overrides with a clear precedence hierarchy.
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   loadConfig,
+ *   getConfig,
+ *   getValue,
+ *   setValue,
+ *   getDefaultConfig,
+ * } from './config/index.js';
+ *
+ * // Load and access configuration
+ * const config = loadConfig();
+ * const actor = getValue('actor');
+ * const mode = getValue('identity.mode');
+ *
+ * // Modify configuration
+ * setValue('actor', 'my-agent');
+ * ```
+ */
+export { EnvVars, ConfigSource as ConfigSourceEnum, VALID_CONFIG_PATHS, isValidConfigPath } from './types.js';
+// Defaults
+export { DEFAULT_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_PLAYBOOK_CONFIG, DEFAULT_TOMBSTONE_CONFIG, DEFAULT_IDENTITY_CONFIG, DEFAULT_PLUGINS_CONFIG, getDefaultConfig, ONE_SECOND, ONE_MINUTE, ONE_HOUR, ONE_DAY, MIN_EXPORT_DEBOUNCE, MAX_EXPORT_DEBOUNCE, MIN_TIME_TOLERANCE, MAX_TIME_TOLERANCE, MAX_TTL, } from './defaults.js';
+// Duration utilities
+export { DURATION_UNITS, isDurationString, parseDuration, parseDurationValue, tryParseDuration, formatDuration, formatDurationHuman, validateDurationRange, } from './duration.js';
+// Validation
+export { isValidActor, validateActor, isValidDatabase, validateDatabase, isValidJsonlFilename, validateJsonlFilename, isValidPlaybookPaths, validatePlaybookPaths, validateConfiguration, validateConfigurationSafe, validatePartialConfiguration, } from './validation.js';
+// Merge utilities
+export { deepMerge, mergeConfiguration, mergeConfigurations, createConfiguration, cloneConfiguration, diffConfigurations, configurationsEqual, } from './merge.js';
+// File operations
+export { CONFIG_FILE_NAME, STONEFORGE_DIR, findStoneforgeDir, getGlobalConfigDir, getGlobalConfigPath, discoverConfigFile, parseYamlConfig, convertYamlToConfig, readConfigFile, convertConfigToYaml, serializeConfigToYaml, writeConfigFile, updateConfigFile, expandPath, expandPlaybookPaths, } from './file.js';
+// Environment variables
+export { parseEnvBoolean, isEnvBoolean, parseEnvDuration, getEnvVar, hasEnvVar, loadEnvConfig, getEnvConfigPath, getEnvJsonMode, getEnvVerboseMode, getEnvVarInfo, getSetEnvVars, } from './env.js';
+// Main configuration API
+export { loadConfig, getConfig, getTrackedConfig, reloadConfig, clearConfigCache, getValue, getValueFromConfig, getValueSource, getValueWithSource, setValue, unsetValue, getConfigPath, configFileExists, saveConfig, } from './config.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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAyBH,OAAO,EAAE,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE9G,WAAW;AACX,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,wBAAwB;AACxB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,UAAU,CAAC;AAElB,yBAAyB;AACzB,OAAO,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,QAAQ,EACR,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,GACX,MAAM,aAAa,CAAC"}

package/dist/config/merge.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Configuration Merging
+ *
+ * Deep merge utilities for combining configuration from multiple sources
+ * with precedence handling.
+ */
+import type { Configuration, PartialConfiguration } from './types.js';
+/**
+ * Deep merges two objects, with source values overriding target values
+ * Arrays are replaced, not merged
+ *
+ * @param target - Base object
+ * @param source - Override object
+ * @returns Merged object
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T;
+/**
+ * Merges partial configuration into a complete configuration
+ *
+ * @param base - Base configuration (typically defaults)
+ * @param partial - Partial configuration to merge in
+ * @returns Complete merged configuration
+ */
+export declare function mergeConfiguration(base: Configuration, partial: PartialConfiguration): Configuration;
+/**
+ * Merges multiple partial configurations in order
+ * Later configurations override earlier ones
+ *
+ * @param base - Base configuration
+ * @param partials - Partial configurations to merge, in order
+ * @returns Complete merged configuration
+ */
+export declare function mergeConfigurations(base: Configuration, ...partials: PartialConfiguration[]): Configuration;
+/**
+ * Creates a configuration by merging defaults with partial config
+ *
+ * @param partial - Partial configuration
+ * @returns Complete configuration with defaults filled in
+ */
+export declare function createConfiguration(partial?: PartialConfiguration): Configuration;
+/**
+ * Creates a deep clone of a configuration
+ */
+export declare function cloneConfiguration(config: Configuration): Configuration;
+/**
+ * Compares two configurations and returns the differences
+ */
+export declare function diffConfigurations(a: Configuration, b: Configuration): PartialConfiguration;
+/**
+ * Checks if two configurations are equal
+ */
+export declare function configurationsEqual(a: Configuration, b: Configuration): boolean;
+//# sourceMappingURL=merge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/config/merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAmBtE;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,CAAC,CAyBH;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CA0Bf;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,EACnB,GAAG,QAAQ,EAAE,oBAAoB,EAAE,GAClC,aAAa,CAMf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAMjF;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAyBvE;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,aAAa,GACf,oBAAoB,CAiEtB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAiB/E"}