Function deepMerge

src/config/loader.ts:18–46

* Deep merge two configuration objects. * Rules: * - If override is undefined, keep base. * - If types mismatch (array vs object, primitive vs object), override wins outright — no merging. * - Arrays are NEVER merged element-by-element — override array replaces base array. * - Plain objects

(base: T, override: any)

 *  - Primitives: override wins.
 */
function deepMerge<T>(base: T, override: any): T {
  if (override === undefined) return base;
  if (override === null) return null as unknown as T;

  const baseIsArray = Array.isArray(base);
  const overrideIsArray = Array.isArray(override);

  // Arrays never merge — override replaces. Same when types mismatch.
  if (baseIsArray || overrideIsArray) {
    return overrideIsArray ? (override as T) : (override as T);
  }

  const baseIsObj = typeof base === 'object' && base !== null;
  const overrideIsObj = typeof override === 'object' && override !== null;

  // Type mismatch (e.g., user wrote a string where default is an object) → override wins
  if (!baseIsObj || !overrideIsObj) {
    return override as T;
  }

  // Both are plain objects → recurse per key
  const result: any = { ...(base as any) };
  for (const key of Object.keys(override)) {
    const ov = override[key];
    if (ov === undefined) continue;
    result[key] = deepMerge((base as any)[key], ov);
  }
  return result as T;
}

export async function ensureQodexHome(): Promise<void> {
  try {