/** * GSD Tools Tests — ~/.gsd/defaults.json fallback (#1683) * * When .planning/ does not exist (pre-project context), loadConfig() should * consult ~/.gsd/defaults.json before returning hardcoded defaults. * When .planning/ exists but config.json is missing, hardcoded defaults are used. */ const { test, describe } = require('node:test'); const assert = require('node:assert/strict'); const fs = require('fs'); const path = require('path'); const os = require('os'); const { cleanup } = require('./helpers.cjs'); const { loadConfig } = require('../gsd-core/bin/lib/config-loader.cjs'); /** Create a bare temp dir (no .planning/) to simulate pre-project context */ function createBareTmpDir() { return fs.mkdtempSync(path.join(os.tmpdir(), 'gsd-test-')); } describe('loadConfig ~/.gsd/defaults.json fallback (#1683)', () => { test('pre-project, no defaults.json → hardcoded defaults', (t) => { const tmpDir = createBareTmpDir(); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.strictEqual(config.model_profile, 'balanced'); assert.strictEqual(config.context_window, 200000); assert.strictEqual(config.research, true); assert.strictEqual(config.subagent_timeout, 300000); }); test('pre-project, defaults.json exists → merges with hardcoded defaults', (t) => { const tmpDir = createBareTmpDir(); // Create ~/.gsd/defaults.json under fake GSD_HOME const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_profile: 'quality', context_window: 1000000 }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); // Values from defaults.json assert.strictEqual(config.model_profile, 'quality'); assert.strictEqual(config.context_window, 1000000); // Hardcoded defaults for keys not in defaults.json assert.strictEqual(config.research, true); assert.strictEqual(config.subagent_timeout, 300000); assert.strictEqual(config.parallelization, true); }); test('.planning/ exists but no config.json → hardcoded defaults (not defaults.json)', (t) => { const tmpDir = createBareTmpDir(); // Create .planning/ without config.json fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true }); // Create defaults.json — should NOT be consulted const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_profile: 'quality', context_window: 1000000 }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); // Hardcoded defaults — NOT defaults.json values assert.strictEqual(config.model_profile, 'balanced'); assert.strictEqual(config.context_window, 200000); }); test('project config exists → project config wins', (t) => { const tmpDir = createBareTmpDir(); fs.mkdirSync(path.join(tmpDir, '.planning'), { recursive: true }); fs.writeFileSync( path.join(tmpDir, '.planning', 'config.json'), JSON.stringify({ model_profile: 'budget' }) ); // Also write defaults.json with a different value const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_profile: 'quality', context_window: 1000000 }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.strictEqual(config.model_profile, 'budget'); assert.strictEqual(config.context_window, 200000); }); test('defaults.json with unknown keys → unknown keys NOT passed through', (t) => { const tmpDir = createBareTmpDir(); const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_profile: 'quality', unknown_key: 'should_not_appear', another_unknown: 42, }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.strictEqual(config.model_profile, 'quality'); assert.strictEqual(config.unknown_key, undefined); assert.strictEqual(config.another_unknown, undefined); }); test('defaults.json with invalid JSON → returns hardcoded defaults', (t) => { const tmpDir = createBareTmpDir(); const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync(path.join(gsdDir, 'defaults.json'), '{ not valid json !!!'); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.strictEqual(config.model_profile, 'balanced'); assert.strictEqual(config.context_window, 200000); }); // ─── #2069: global-defaults must forward model_policy / model_profile_overrides / runtime ─ // The _globalBaseCfg whitelist in Branch D of loadConfigResolved previously omitted these // three keys, so they were silently dropped from ~/.gsd/defaults.json while the identical // keys in a project's .planning/config.json were honored. The tests below are fail-first: // each asserts the global path forwards its key, mirroring the project-config parity test. test('#2069 defaults.json model_policy → forwarded from global defaults', (t) => { const tmpDir = createBareTmpDir(); const policy = { provider: 'anthropic', budget: 'high' }; const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_policy: policy }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.deepStrictEqual(config.model_policy, policy); }); test('#2069 defaults.json model_profile_overrides → forwarded from global defaults', (t) => { const tmpDir = createBareTmpDir(); const overrides = { claude: { planner: { model: 'claude-opus-4-5' } } }; const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ model_profile_overrides: overrides }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.deepStrictEqual(config.model_profile_overrides, overrides); }); test('#2069 defaults.json runtime → forwarded from global defaults', (t) => { const tmpDir = createBareTmpDir(); const runtime = 'codex'; const gsdDir = path.join(tmpDir, '.gsd'); fs.mkdirSync(gsdDir, { recursive: true }); fs.writeFileSync( path.join(gsdDir, 'defaults.json'), JSON.stringify({ runtime }) ); process.env.GSD_HOME = tmpDir; t.after(() => { delete process.env.GSD_HOME; cleanup(tmpDir); }); const config = loadConfig(tmpDir); assert.strictEqual(config.runtime, runtime); }); test('#2069 defaults.json parity: model_policy / model_profile_overrides / runtime survive identically to project-config path', (t) => { // Identical values in ~/.gsd/defaults.json (no .planning/) vs .planning/config.json (no defaults.json) // must produce identical config. for each of the three previously-dropped keys. A future // regression breaking shape-parity for just one key — e.g. changing the project path to // `parsed['runtime'] ?? null` — would slip a single-key test, so all three are asserted here. const policy = { provider: 'anthropic', budget: 'low' }; const overrides = { claude: { planner: { model: 'claude-opus-4-5' } } }; const runtime = 'codex'; // Global path: ~/.gsd/defaults.json only, no .planning/ const globalDir = createBareTmpDir(); const globalGsdDir = path.join(globalDir, '.gsd'); fs.mkdirSync(globalGsdDir, { recursive: true }); fs.writeFileSync( path.join(globalGsdDir, 'defaults.json'), JSON.stringify({ model_policy: policy, model_profile_overrides: overrides, runtime }) ); process.env.GSD_HOME = globalDir; const globalConfig = loadConfig(globalDir); delete process.env.GSD_HOME; t.after(() => { cleanup(globalDir); }); // Project path: .planning/config.json only, no defaults.json const projectDir = createBareTmpDir(); fs.mkdirSync(path.join(projectDir, '.planning'), { recursive: true }); fs.writeFileSync( path.join(projectDir, '.planning', 'config.json'), JSON.stringify({ model_policy: policy, model_profile_overrides: overrides, runtime }) ); // GSD_HOME pointing somewhere with no defaults.json so the project path is the sole source. const emptyHome = createBareTmpDir(); process.env.GSD_HOME = emptyHome; const projectConfig = loadConfig(projectDir); delete process.env.GSD_HOME; t.after(() => { cleanup(projectDir); cleanup(emptyHome); }); assert.deepStrictEqual(globalConfig.model_policy, projectConfig.model_policy); assert.deepStrictEqual(globalConfig.model_profile_overrides, projectConfig.model_profile_overrides); assert.strictEqual(globalConfig.runtime, projectConfig.runtime); }); });