Function addProviderToConfig

src/setup/provider-writer.ts:30–71

(
  entry: CustomProviderEntry,
  opts?: { setDefault?: boolean; defaultModel?: string },
)

 * touching disk.
 */
export async function addProviderToConfig(
  entry: CustomProviderEntry,
  opts?: { setDefault?: boolean; defaultModel?: string },
): Promise<AddProviderResult> {
  return withLock(QODEX_CONFIG_FILE + '.lock', async () => {
    let raw = '';
    try {
      raw = await fs.readFile(QODEX_CONFIG_FILE, 'utf-8');
    } catch (e: any) {
      // Only a missing file means "no config yet — start fresh". Any other read
      // error (permission denied, IO failure) must NOT be swallowed: doing so
      // would merge into an empty object and overwrite the file, dropping every
      // previously-configured provider. Surface it before the merge-and-write.
      if (e?.code !== 'ENOENT') {
        throw new Error(
          `Could not read ${QODEX_CONFIG_FILE} (${e?.message ?? e}). ` +
          `Refusing to overwrite it to avoid dropping existing providers. Fix the file/permissions, then retry.`,
        );
      }
      raw = ''; // no config yet — start fresh
    }

    let parsed: any = {};
    if (raw.trim()) {
      try {
        parsed = yaml.load(raw) ?? {};
      } catch (e: any) {
        throw new Error(`Could not parse ${QODEX_CONFIG_FILE}: ${e?.message ?? e}. Fix the YAML or move it aside, then retry.`);
      }
    }

    const merged = mergeCustomProvider(parsed, entry, opts);
    const out = yaml.dump(merged, { lineWidth: 100, noRefs: true });

    // Ensure the directory exists (first-run case).
    const dir = QODEX_CONFIG_FILE.slice(0, QODEX_CONFIG_FILE.lastIndexOf('/'));
    await fs.mkdir(dir, { recursive: true });
    await writeFileAtomic(QODEX_CONFIG_FILE, out);

    return { configPath: QODEX_CONFIG_FILE, name: entry.name, setDefault: !!opts?.setDefault };
  });
}