@defai.digital/config-domain 13.0.3

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @defai.digital/config-domain
+ *
+ * Configuration domain - config management following contract invariants.
+ */
+// Config Store
+export { CONFIG_PATHS, DATA_PATHS, CONFIG_SUBDIRS, expandPath, getConfigPath, createConfigStore, initConfigDirectory, isSetupComplete, } from './store.js';
+// Config Operations
+export { parsePath, getValue, setValue, removeValue, mergeConfigs, diffConfigs, hasPath, getAllPaths, } from './operations.js';
+// Config Aggregate
+export { ConfigAggregate, createConfigAggregate, createAggregateFromConfig, } from './aggregate.js';
+// Config Repository
+export { InMemoryConfigEventStore, createConfigRepository, getConfigRepository, setConfigRepository, resetConfigRepository, } from './repository.js';
+// Config Migrator
+export { CURRENT_VERSION, MIN_SUPPORTED_VERSION, VERSION_ORDER, MIGRATIONS, getConfigVersion, compareVersions, isVersionSupported, getMigrationPath, needsMigration, migrateConfig, safeMigrateConfig, getMigrationInfo, } from './migrator.js';
+// Detection Port
+export { nullDetectionAdapter, setDetectionAdapter, getDetectionAdapter, resetDetectionAdapter, } from './ports/detection.js';
+// Config Resolver (Multi-Level)
+export { ConfigResolver, createConfigResolver, resolveConfig, resolveConfigFull, } from './resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAe;AACf,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EAEd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,oBAAoB;AACpB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,WAAW,EACX,OAAO,EACP,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAEL,eAAe,EACf,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AAExB,oBAAoB;AACpB,OAAO,EAIL,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EAGL,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EAGL,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,gCAAgC;AAChC,OAAO,EAGL,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/migrator.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Config Version Migration
+ *
+ * Handles schema migrations for configuration files across versions.
+ *
+ * Invariants:
+ * - INV-CFG-MIG-001: Migrations are idempotent
+ * - INV-CFG-MIG-002: Version order is strictly increasing
+ * - INV-CFG-MIG-003: Unknown versions fail fast
+ */
+import { type AutomatosXConfig, ConfigError } from '@defai.digital/contracts';
+/**
+ * Migration function signature
+ * Takes a config of any shape and returns a transformed config
+ */
+export type ConfigMigration = (config: unknown) => unknown;
+/**
+ * Migration metadata
+ */
+export interface MigrationInfo {
+    /** Source version this migration applies to */
+    fromVersion: string;
+    /** Target version after migration */
+    toVersion: string;
+    /** Description of changes */
+    description: string;
+    /** Migration function */
+    migrate: ConfigMigration;
+}
+/**
+ * Current config schema version
+ */
+export declare const CURRENT_VERSION = "1.0.0";
+/**
+ * Minimum supported version (older versions cannot be migrated)
+ */
+export declare const MIN_SUPPORTED_VERSION = "0.9.0";
+/**
+ * Version order for migration path calculation
+ */
+export declare const VERSION_ORDER: readonly string[];
+/**
+ * Registered migrations by source version
+ * Each migration transforms config from fromVersion to toVersion
+ */
+export declare const MIGRATIONS: Record<string, MigrationInfo>;
+/**
+ * Gets the version from a config object
+ */
+export declare function getConfigVersion(config: unknown): string | undefined;
+/**
+ * Compares two version strings
+ * Returns: -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Checks if a version is supported for migration
+ */
+export declare function isVersionSupported(version: string): boolean;
+/**
+ * Gets the migration path from one version to another
+ */
+export declare function getMigrationPath(fromVersion: string, toVersion: string): MigrationInfo[];
+/**
+ * Checks if a config needs migration
+ */
+export declare function needsMigration(config: unknown): boolean;
+/**
+ * Migrates a config to the latest version
+ *
+ * @throws ConfigError if migration fails or version is unsupported
+ */
+export declare function migrateConfig(config: unknown): AutomatosXConfig;
+/**
+ * Safely migrates a config, returning undefined on failure
+ */
+export declare function safeMigrateConfig(config: unknown): {
+    success: true;
+    data: AutomatosXConfig;
+} | {
+    success: false;
+    error: ConfigError;
+};
+/**
+ * Gets migration info for a config
+ */
+export declare function getMigrationInfo(config: unknown): {
+    currentVersion: string | undefined;
+    targetVersion: string;
+    needsMigration: boolean;
+    migrationPath: MigrationInfo[];
+};
+//# sourceMappingURL=migrator.d.ts.map

package/dist/migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../src/migrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,gBAAgB,EAKrB,WAAW,EACZ,MAAM,0BAA0B,CAAC;AAMlC;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,eAAe,CAAC;CAC1B;AAMD;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAKjC,CAAC;AAMX;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAkEpD,CAAC;AAMF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUpE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBxF;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAevD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAsE/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,GACd;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAiBpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG;IACjD,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC,CAYA"}

package/dist/migrator.js

@@ -0,0 +1,263 @@
+/**
+ * Config Version Migration
+ *
+ * Handles schema migrations for configuration files across versions.
+ *
+ * Invariants:
+ * - INV-CFG-MIG-001: Migrations are idempotent
+ * - INV-CFG-MIG-002: Version order is strictly increasing
+ * - INV-CFG-MIG-003: Unknown versions fail fast
+ */
+import { validateConfig, safeValidateConfig, DEFAULT_CONFIG, ConfigErrorCode, ConfigError, } from '@defai.digital/contracts';
+// ============================================================================
+// Version Constants
+// ============================================================================
+/**
+ * Current config schema version
+ */
+export const CURRENT_VERSION = '1.0.0';
+/**
+ * Minimum supported version (older versions cannot be migrated)
+ */
+export const MIN_SUPPORTED_VERSION = '0.9.0';
+/**
+ * Version order for migration path calculation
+ */
+export const VERSION_ORDER = [
+    '0.9.0',
+    '0.9.1',
+    '0.10.0',
+    '1.0.0',
+];
+// ============================================================================
+// Migration Registry
+// ============================================================================
+/**
+ * Registered migrations by source version
+ * Each migration transforms config from fromVersion to toVersion
+ */
+export const MIGRATIONS = {
+    // Example migration from 0.9.0 to 0.9.1
+    '0.9.0': {
+        fromVersion: '0.9.0',
+        toVersion: '0.9.1',
+        description: 'Add features field with defaults',
+        migrate: (config) => {
+            const cfg = config;
+            return {
+                ...cfg,
+                features: cfg.features ?? DEFAULT_CONFIG.features,
+                version: '0.9.1',
+            };
+        },
+    },
+    // Migration from 0.9.1 to 0.10.0
+    '0.9.1': {
+        fromVersion: '0.9.1',
+        toVersion: '0.10.0',
+        description: 'Add workspace configuration field',
+        migrate: (config) => {
+            const cfg = config;
+            return {
+                ...cfg,
+                workspace: cfg.workspace ?? DEFAULT_CONFIG.workspace,
+                version: '0.10.0',
+            };
+        },
+    },
+    // Migration from 0.10.0 to 1.0.0
+    '0.10.0': {
+        fromVersion: '0.10.0',
+        toVersion: '1.0.0',
+        description: 'Stable release - normalize provider configuration to Record format',
+        migrate: (config) => {
+            const cfg = config;
+            // Convert providers from array to Record format if needed
+            let providers = {};
+            if (Array.isArray(cfg.providers)) {
+                // Convert array format to Record format
+                for (const p of cfg.providers) {
+                    const provider = p;
+                    const providerId = provider.providerId;
+                    if (providerId) {
+                        providers[providerId] = {
+                            enabled: provider.enabled ?? true,
+                            priority: provider.priority ?? 50,
+                            command: provider.command,
+                        };
+                    }
+                }
+            }
+            else if (cfg.providers && typeof cfg.providers === 'object') {
+                // Already in Record format
+                providers = cfg.providers;
+            }
+            return {
+                ...cfg,
+                providers,
+                version: '1.0.0',
+            };
+        },
+    },
+};
+// ============================================================================
+// Version Utilities
+// ============================================================================
+/**
+ * Gets the version from a config object
+ */
+export function getConfigVersion(config) {
+    if (config === null || typeof config !== 'object') {
+        return undefined;
+    }
+    const cfg = config;
+    const version = cfg.version;
+    if (typeof version !== 'string') {
+        return undefined;
+    }
+    return version;
+}
+/**
+ * Compares two version strings
+ * Returns: -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function compareVersions(a, b) {
+    const indexA = VERSION_ORDER.indexOf(a);
+    const indexB = VERSION_ORDER.indexOf(b);
+    // Unknown versions sort to end
+    if (indexA === -1 && indexB === -1)
+        return 0;
+    if (indexA === -1)
+        return 1;
+    if (indexB === -1)
+        return -1;
+    return indexA - indexB;
+}
+/**
+ * Checks if a version is supported for migration
+ */
+export function isVersionSupported(version) {
+    return VERSION_ORDER.includes(version);
+}
+/**
+ * Gets the migration path from one version to another
+ */
+export function getMigrationPath(fromVersion, toVersion) {
+    const path = [];
+    let currentVersion = fromVersion;
+    while (compareVersions(currentVersion, toVersion) < 0) {
+        const migration = MIGRATIONS[currentVersion];
+        if (migration === undefined) {
+            // No migration available for this version
+            break;
+        }
+        path.push(migration);
+        currentVersion = migration.toVersion;
+    }
+    return path;
+}
+// ============================================================================
+// Migration Functions
+// ============================================================================
+/**
+ * Checks if a config needs migration
+ */
+export function needsMigration(config) {
+    const version = getConfigVersion(config);
+    // No version field - needs migration to add it
+    if (version === undefined) {
+        return true;
+    }
+    // Already at current version
+    if (version === CURRENT_VERSION) {
+        return false;
+    }
+    // Check if we have a migration path
+    return compareVersions(version, CURRENT_VERSION) < 0;
+}
+/**
+ * Migrates a config to the latest version
+ *
+ * @throws ConfigError if migration fails or version is unsupported
+ */
+export function migrateConfig(config) {
+    // Handle null/undefined
+    if (config === null || config === undefined) {
+        return { ...DEFAULT_CONFIG, version: CURRENT_VERSION };
+    }
+    // Get current version
+    let version = getConfigVersion(config);
+    // If no version, assume oldest supported version
+    if (version === undefined) {
+        version = MIN_SUPPORTED_VERSION;
+        config = { ...config, version };
+    }
+    // Check if version is supported
+    if (!isVersionSupported(version)) {
+        throw new ConfigError(ConfigErrorCode.CONFIG_MIGRATION_FAILED, `Config version ${version} is not supported. Minimum supported version is ${MIN_SUPPORTED_VERSION}`, { version, minSupported: MIN_SUPPORTED_VERSION });
+    }
+    // Already at current version - validate and return
+    if (version === CURRENT_VERSION) {
+        const result = safeValidateConfig(config);
+        if (!result.success) {
+            throw new ConfigError(ConfigErrorCode.CONFIG_VALIDATION_ERROR, 'Config validation failed after migration', { errors: result.error.errors.map((e) => e.message) });
+        }
+        return result.data;
+    }
+    // Get migration path
+    const migrations = getMigrationPath(version, CURRENT_VERSION);
+    if (migrations.length === 0) {
+        throw new ConfigError(ConfigErrorCode.CONFIG_MIGRATION_FAILED, `No migration path found from version ${version} to ${CURRENT_VERSION}`, { fromVersion: version, toVersion: CURRENT_VERSION });
+    }
+    // Apply migrations in order
+    let migratedConfig = config;
+    for (const migration of migrations) {
+        try {
+            migratedConfig = migration.migrate(migratedConfig);
+        }
+        catch (error) {
+            throw new ConfigError(ConfigErrorCode.CONFIG_MIGRATION_FAILED, `Migration from ${migration.fromVersion} to ${migration.toVersion} failed: ${error instanceof Error ? error.message : 'Unknown error'}`, {
+                fromVersion: migration.fromVersion,
+                toVersion: migration.toVersion,
+                error: String(error),
+            });
+        }
+    }
+    // Validate final result
+    const validated = validateConfig(migratedConfig);
+    return validated;
+}
+/**
+ * Safely migrates a config, returning undefined on failure
+ */
+export function safeMigrateConfig(config) {
+    try {
+        const result = migrateConfig(config);
+        return { success: true, data: result };
+    }
+    catch (error) {
+        if (error instanceof ConfigError) {
+            return { success: false, error };
+        }
+        return {
+            success: false,
+            error: new ConfigError(ConfigErrorCode.CONFIG_MIGRATION_FAILED, error instanceof Error ? error.message : 'Unknown migration error', { error: String(error) }),
+        };
+    }
+}
+/**
+ * Gets migration info for a config
+ */
+export function getMigrationInfo(config) {
+    const currentVersion = getConfigVersion(config);
+    const effectiveVersion = currentVersion ?? MIN_SUPPORTED_VERSION;
+    const requires = needsMigration(config);
+    const path = requires ? getMigrationPath(effectiveVersion, CURRENT_VERSION) : [];
+    return {
+        currentVersion,
+        targetVersion: CURRENT_VERSION,
+        needsMigration: requires,
+        migrationPath: path,
+    };
+}
+//# sourceMappingURL=migrator.js.map

package/dist/migrator.js.map

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

package/dist/operations.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Configuration Operations
+ *
+ * Pure functions for config manipulation (immutable operations).
+ */
+import type { AutomatosXConfig } from '@defai.digital/contracts';
+/**
+ * Parses a config path into segments
+ * @example parsePath('providers.0.providerId') => ['providers', '0', 'providerId']
+ */
+export declare function parsePath(path: string): string[];
+/**
+ * Gets a value from config by path
+ * @example getValue(config, 'providers.0.providerId') => 'claude'
+ */
+export declare function getValue<T>(config: AutomatosXConfig, path: string): T | undefined;
+/**
+ * Sets a value in config by path (immutable)
+ * @example setValue(config, 'logLevel', 'debug') => new config with updated logLevel
+ */
+export declare function setValue(config: AutomatosXConfig, path: string, value: unknown): AutomatosXConfig;
+/**
+ * Removes a value from config by path (immutable)
+ */
+export declare function removeValue(config: AutomatosXConfig, path: string): AutomatosXConfig;
+/**
+ * Deep merges two configs (immutable)
+ * Override values take precedence
+ */
+export declare function mergeConfigs(base: AutomatosXConfig, override: Partial<AutomatosXConfig>): AutomatosXConfig;
+/**
+ * Compares two configs and returns the differences
+ */
+export declare function diffConfigs(oldConfig: AutomatosXConfig, newConfig: AutomatosXConfig): {
+    path: string;
+    oldValue: unknown;
+    newValue: unknown;
+}[];
+/**
+ * Checks if a path exists in the config
+ */
+export declare function hasPath(config: AutomatosXConfig, path: string): boolean;
+/**
+ * Gets all paths in a config (flattened)
+ */
+export declare function getAllPaths(config: AutomatosXConfig): string[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../src/operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAMjE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKhD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,CAAC,GAAG,SAAS,CAyBf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,gBAAgB,CAOlB;AA6CD;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,GACX,gBAAgB,CAOlB;AA8DD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAClC,gBAAgB,CAElB;AA2CD;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,gBAAgB,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAAE,CAmD1D;AAMD;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAkC9D"}