software-mansion__argent/packages/configuration-core/tests/config.test.ts

import { describe, it, expect, beforeEach, afterEach } from "vitest";
import * as fs from "node:fs";
import * as path from "node:path";
import * as os from "node:os";
import { argentHomeDir, configFilePath } from "../src/paths.js";
import { readConfigObject, updateConfig } from "../src/config.js";
import {
  getRememberedAgent,
  setRememberedAgent,
  clearRememberedAgent,
} from "../src/config-access.js";

// Redirect the `~/.argent` home into a tmp dir by mutating process.env.HOME
// (consumed by os.homedir() via argentHomeDir).
let tmpHome: string;
let originalHome: string | undefined;
let originalUserProfile: string | undefined;

beforeEach(() => {
  tmpHome = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "argent-config-home-")));
  originalHome = process.env.HOME;
  originalUserProfile = process.env.USERPROFILE;
  process.env.HOME = tmpHome;
  process.env.USERPROFILE = tmpHome;
});

afterEach(() => {
  if (originalHome === undefined) delete process.env.HOME;
  else process.env.HOME = originalHome;
  if (originalUserProfile === undefined) delete process.env.USERPROFILE;
  else process.env.USERPROFILE = originalUserProfile;
  fs.rmSync(tmpHome, { recursive: true, force: true });
});

function readConfigFile(): unknown {
  return JSON.parse(fs.readFileSync(configFilePath(), "utf8"));
}

describe("paths", () => {
  it("locates config.json under the argent home", () => {
    expect(configFilePath()).toBe(path.join(argentHomeDir(), "config.json"));
    expect(argentHomeDir()).toBe(path.join(tmpHome, ".argent"));
  });
});

describe("readConfigObject / updateConfig", () => {
  it("returns an empty object when the file is missing", () => {
    expect(readConfigObject()).toEqual({});
  });

  it("returns an empty object when the file is malformed", () => {
    fs.mkdirSync(argentHomeDir(), { recursive: true });
    fs.writeFileSync(configFilePath(), "not json{", "utf8");
    expect(readConfigObject()).toEqual({});
  });

  it("creates and persists a new key", () => {
    updateConfig((c) => {
      c.telemetry = { enabled: false };
    });
    expect(readConfigFile()).toEqual({ telemetry: { enabled: false } });
  });

  it("merges rather than clobbering keys it does not touch", () => {
    updateConfig((c) => {
      c.telemetry = { enabled: false };
    });
    updateConfig((c) => {
      c.notices = { firstRun: true };
    });
    expect(readConfigFile()).toEqual({
      telemetry: { enabled: false },
      notices: { firstRun: true },
    });
  });
});

describe("remembered agent (lens config)", () => {
  it("returns null when nothing is stored", () => {
    expect(getRememberedAgent()).toBeNull();
  });

  it("persists and reads back the chosen agent", () => {
    setRememberedAgent("claude");
    expect(getRememberedAgent()).toBe("claude");
    expect(readConfigFile()).toEqual({ lens: { agent: "claude" } });
  });

  it("overwrites a previously remembered agent", () => {
    setRememberedAgent("claude");
    setRememberedAgent("codex");
    expect(getRememberedAgent()).toBe("codex");
  });

  it("treats a blank stored agent as none", () => {
    updateConfig((c) => {
      c.lens = { agent: "   " };
    });
    expect(getRememberedAgent()).toBeNull();
  });

  it("clears the remembered agent without dropping sibling keys", () => {
    updateConfig((c) => {
      c.telemetry = { enabled: true };
    });
    setRememberedAgent("claude");
    clearRememberedAgent();
    expect(getRememberedAgent()).toBeNull();
    expect(readConfigFile()).toEqual({ telemetry: { enabled: true }, lens: {} });
  });

  it("clearing when nothing is stored is a no-op that doesn't throw", () => {
    expect(() => clearRememberedAgent()).not.toThrow();
    expect(getRememberedAgent()).toBeNull();
  });
});