import { beforeEach, describe, expect, it } from 'vitest';
import path from 'node:path';
import { createMockFileSystemExecutor } from '../../test-utils/mock-executors.ts';
import {
__resetConfigStoreForTests,
getConfig,
initConfigStore,
persistActiveSessionDefaultsProfile,
persistSessionDefaultsPatch,
} from '../config-store.ts';
const cwd = '/repo';
const configPath = path.join(cwd, '.xcodebuildmcp', 'config.yaml');
describe('config-store', () => {
beforeEach(() => {
__resetConfigStoreForTests();
});
function createFs(readFile?: string) {
return createMockFileSystemExecutor({
existsSync: (targetPath) => targetPath === configPath && readFile != null,
readFile: async (targetPath) => {
if (targetPath !== configPath) {
throw new Error(`Unexpected readFile path: ${targetPath}`);
}
if (readFile == null) {
throw new Error('readFile called without fixture content');
}
return readFile;
},
});
}
it('uses defaults when config is missing and overrides are not provided', async () => {
await initConfigStore({ cwd, fs: createFs() });
const config = getConfig();
expect(config.debug).toBe(false);
expect(config.incrementalBuildsEnabled).toBe(false);
expect(config.dapRequestTimeoutMs).toBe(30000);
expect(config.dapLogEvents).toBe(false);
expect(config.launchJsonWaitMs).toBe(8000);
});
it('parses env values when provided', async () => {
const env = {
XCODEBUILDMCP_DEBUG: 'true',
INCREMENTAL_BUILDS_ENABLED: '1',
XCODEBUILDMCP_DAP_REQUEST_TIMEOUT_MS: '12345',
XCODEBUILDMCP_DAP_LOG_EVENTS: 'true',
XBMCP_LAUNCH_JSON_WAIT_MS: '9000',
XCODEBUILDMCP_ENABLED_WORKFLOWS: 'simulator,logging',
XCODEBUILDMCP_UI_DEBUGGER_GUARD_MODE: 'warn',
XCODEBUILDMCP_DEBUGGER_BACKEND: 'lldb',
};
await initConfigStore({ cwd, fs: createFs(), env });
const config = getConfig();
expect(config.debug).toBe(true);
expect(config.incrementalBuildsEnabled).toBe(true);
expect(config.dapRequestTimeoutMs).toBe(12345);
expect(config.dapLogEvents).toBe(true);
expect(config.launchJsonWaitMs).toBe(9000);
expect(config.enabledWorkflows).toEqual(['simulator', 'logging']);
expect(config.uiDebuggerGuardMode).toBe('warn');
expect(config.debuggerBackend).toBe('lldb-cli');
});
it('prefers overrides over config file values and config over env', async () => {
const yaml = ['schemaVersion: 1', 'debug: false', 'dapRequestTimeoutMs: 4000', ''].join('\n');
const env = {
XCODEBUILDMCP_DEBUG: 'true',
XCODEBUILDMCP_DAP_REQUEST_TIMEOUT_MS: '999',
};
await initConfigStore({
cwd,
fs: createFs(yaml),
overrides: { debug: true, dapRequestTimeoutMs: 12345 },
env,
});
const config = getConfig();
expect(config.debug).toBe(true);
expect(config.dapRequestTimeoutMs).toBe(12345);
});
it('resolves enabledWorkflows from overrides, config, then defaults', async () => {
const yamlWithoutWorkflows = ['schemaVersion: 1', 'debug: false', ''].join('\n');
await initConfigStore({ cwd, fs: createFs(yamlWithoutWorkflows) });
const config = getConfig();
expect(config.enabledWorkflows).toEqual([]);
const yamlWithExplicitEmpty = ['schemaVersion: 1', 'enabledWorkflows: []', ''].join('\n');
await initConfigStore({ cwd, fs: createFs(yamlWithExplicitEmpty) });
const explicitEmpty = getConfig();
expect(explicitEmpty.enabledWorkflows).toEqual([]);
await initConfigStore({
cwd,
fs: createFs(yamlWithExplicitEmpty),
overrides: { enabledWorkflows: ['device'] },
});
const updated = getConfig();
expect(updated.enabledWorkflows).toEqual(['device']);
});
it('merges namespaced session defaults profiles from file and overrides', async () => {
const yaml = [
'schemaVersion: 1',
'activeSessionDefaultsProfile: "ios"',
'sessionDefaultsProfiles:',
' ios:',
' scheme: "FromFile"',
' workspacePath: "./App.xcworkspace"',
'',
].join('\n');
await initConfigStore({
cwd,
fs: createFs(yaml),
overrides: {
sessionDefaultsProfiles: {
ios: { simulatorName: 'iPhone 16' },
watch: { scheme: 'WatchScheme' },
},
},
});
const config = getConfig();
expect(config.activeSessionDefaultsProfile).toBe('ios');
expect(config.sessionDefaultsProfiles?.ios?.scheme).toBe('FromFile');
expect(config.sessionDefaultsProfiles?.ios?.simulatorName).toBe('iPhone 16');
expect(config.sessionDefaultsProfiles?.watch?.scheme).toBe('WatchScheme');
});
it('persists active profile selection and updates resolved config', async () => {
const writes: { path: string; content: string }[] = [];
const fs = createMockFileSystemExecutor({
existsSync: () => true,
readFile: async () => 'schemaVersion: 1\n',
writeFile: async (targetPath, content) => {
writes.push({ path: targetPath, content });
},
});
await initConfigStore({ cwd, fs });
await persistActiveSessionDefaultsProfile('ios');
expect(getConfig().activeSessionDefaultsProfile).toBe('ios');
expect(writes).toHaveLength(1);
});
it('normalizes profile names for persisted defaults patch and resolved config', async () => {
const writes: { path: string; content: string }[] = [];
let persistedYaml = 'schemaVersion: 1\n';
const fs = createMockFileSystemExecutor({
existsSync: () => true,
readFile: async () => persistedYaml,
writeFile: async (targetPath, content) => {
writes.push({ path: targetPath, content });
persistedYaml = content;
},
});
await initConfigStore({ cwd, fs });
await persistSessionDefaultsPatch({
profile: ' ios ',
patch: { scheme: 'App' },
});
expect(getConfig().sessionDefaultsProfiles?.ios?.scheme).toBe('App');
expect(getConfig().sessionDefaultsProfiles?.[' ios ']).toBeUndefined();
expect(writes).toHaveLength(1);
});
it('normalizes profile names for active profile persistence', async () => {
const writes: { path: string; content: string }[] = [];
const fs = createMockFileSystemExecutor({
existsSync: () => true,
readFile: async () => 'schemaVersion: 1\n',
writeFile: async (targetPath, content) => {
writes.push({ path: targetPath, content });
},
});
await initConfigStore({ cwd, fs });
await persistActiveSessionDefaultsProfile(' ios ');
expect(getConfig().activeSessionDefaultsProfile).toBe('ios');
expect(writes).toHaveLength(1);
});
it('keeps non-session config immutable after init when persisting session defaults', async () => {
let persistedYaml = 'schemaVersion: 1\n';
const fs = createMockFileSystemExecutor({
existsSync: () => true,
readFile: async () => persistedYaml,
writeFile: async (_targetPath, content) => {
persistedYaml = content;
},
});
await initConfigStore({
cwd,
fs,
env: { XCODEBUILDMCP_DEBUG: 'true' },
});
expect(getConfig().debug).toBe(true);
await persistSessionDefaultsPatch({ patch: { scheme: 'App' } });
expect(getConfig().debug).toBe(true);
expect(getConfig().sessionDefaults?.scheme).toBe('App');
});
it('keeps non-session config immutable after init when persisting active profile', async () => {
let persistedYaml = 'schemaVersion: 1\n';
const fs = createMockFileSystemExecutor({
existsSync: () => true,
readFile: async () => persistedYaml,
writeFile: async (_targetPath, content) => {
persistedYaml = content;
},
});
await initConfigStore({
cwd,
fs,
env: { XCODEBUILDMCP_DEBUG: 'true' },
});
expect(getConfig().debug).toBe(true);
await persistActiveSessionDefaultsProfile('ios');
expect(getConfig().debug).toBe(true);
expect(getConfig().activeSessionDefaultsProfile).toBe('ios');
});
});
