get-shit-done/tests/kilo-install.test.cjs

// allow-test-rule: pending-migration-to-typed-ir [#2974]
// Tracked in #2974 for migration to typed-IR assertions per CONTRIBUTING.md
// "Prohibited: Raw Text Matching on Test Outputs". Per-file review may
// reclassify some entries as source-text-is-the-product during migration.

/**
 * GSD Tools Tests - Kilo Install Plumbing
 *
 * Tests for Kilo runtime directory resolution, config paths,
 * permission config, and installer source integration.
 */

process.env.GSD_TEST_MODE = '1';

const { test, describe, beforeEach, afterEach } = require('node:test');
const assert = require('node:assert/strict');
const fs = require('node:fs');
const path = require('node:path');
const os = require('node:os');

const { createTempProject, cleanup } = require('./helpers.cjs');
const {
  getDirName,
  getGlobalDir,
  getConfigDirFromHome,
  resolveKiloConfigPath,
  configureKiloPermissions,
} = require('../bin/install.js');

describe('getDirName (Kilo)', () => {
  test('returns .kilo for kilo', () => {
    assert.strictEqual(getDirName('kilo'), '.kilo');
  });
});

describe('getConfigDirFromHome (Kilo)', () => {
  test('returns .kilo for local installs', () => {
    assert.strictEqual(getConfigDirFromHome('kilo', false), "'.kilo'");
  });

  test('returns .config, kilo for global installs', () => {
    assert.strictEqual(getConfigDirFromHome('kilo', true), "'.config', 'kilo'");
  });
});

describe('getGlobalDir (Kilo)', () => {
  let savedEnv;

  beforeEach(() => {
    savedEnv = {
      KILO_CONFIG_DIR: process.env.KILO_CONFIG_DIR,
      KILO_CONFIG: process.env.KILO_CONFIG,
      XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
    };

    delete process.env.KILO_CONFIG_DIR;
    delete process.env.KILO_CONFIG;
    delete process.env.XDG_CONFIG_HOME;
  });

  afterEach(() => {
    if (savedEnv.KILO_CONFIG_DIR === undefined) {
      delete process.env.KILO_CONFIG_DIR;
    } else {
      process.env.KILO_CONFIG_DIR = savedEnv.KILO_CONFIG_DIR;
    }

    if (savedEnv.KILO_CONFIG === undefined) {
      delete process.env.KILO_CONFIG;
    } else {
      process.env.KILO_CONFIG = savedEnv.KILO_CONFIG;
    }

    if (savedEnv.XDG_CONFIG_HOME === undefined) {
      delete process.env.XDG_CONFIG_HOME;
    } else {
      process.env.XDG_CONFIG_HOME = savedEnv.XDG_CONFIG_HOME;
    }
  });

  test('returns ~/.config/kilo by default', () => {
    assert.strictEqual(getGlobalDir('kilo'), path.join(os.homedir(), '.config', 'kilo'));
  });

  test('respects KILO_CONFIG_DIR env var', () => {
    process.env.KILO_CONFIG_DIR = '~/custom-kilo';
    assert.strictEqual(getGlobalDir('kilo'), path.join(os.homedir(), 'custom-kilo'));
  });

  test('falls back to XDG_CONFIG_HOME/kilo', () => {
    process.env.XDG_CONFIG_HOME = '~/xdg-config';
    assert.strictEqual(getGlobalDir('kilo'), path.join(os.homedir(), 'xdg-config', 'kilo'));
  });

  test('uses dirname(KILO_CONFIG) when KILO_CONFIG_DIR is unset', () => {
    process.env.KILO_CONFIG = '~/profiles/work/kilo.jsonc';
    assert.strictEqual(getGlobalDir('kilo'), path.join(os.homedir(), 'profiles', 'work'));
  });

  test('KILO_CONFIG_DIR takes precedence over KILO_CONFIG', () => {
    process.env.KILO_CONFIG_DIR = '~/custom-kilo';
    process.env.KILO_CONFIG = '~/profiles/work/kilo.jsonc';
    assert.strictEqual(getGlobalDir('kilo'), path.join(os.homedir(), 'custom-kilo'));
  });

  test('explicit config-dir overrides env vars', () => {
    process.env.KILO_CONFIG_DIR = '~/from-env';
    process.env.XDG_CONFIG_HOME = '~/xdg-config';
    assert.strictEqual(getGlobalDir('kilo', '/explicit/kilo'), '/explicit/kilo');
  });
});

describe('Kilo config file helpers', () => {
  let tmpDir;

  beforeEach(() => {
    tmpDir = createTempProject('gsd-kilo-');
  });

  afterEach(() => {
    cleanup(tmpDir);
  });

  test('resolveKiloConfigPath prefers kilo.jsonc when present', () => {
    const configDir = path.join(tmpDir, '.kilo');
    fs.mkdirSync(configDir, { recursive: true });
    fs.writeFileSync(path.join(configDir, 'kilo.jsonc'), '{\n  // comment\n}\n');

    assert.strictEqual(resolveKiloConfigPath(configDir), path.join(configDir, 'kilo.jsonc'));
  });

  test('resolveKiloConfigPath falls back to kilo.json', () => {
    const configDir = path.join(tmpDir, '.kilo');
    fs.mkdirSync(configDir, { recursive: true });

    assert.strictEqual(resolveKiloConfigPath(configDir), path.join(configDir, 'kilo.json'));
  });
});

describe('configureKiloPermissions', () => {
  let tmpDir;
  let configDir;
  let savedEnv;

  beforeEach(() => {
    tmpDir = createTempProject('gsd-kilo-perms-');
    configDir = path.join(tmpDir, '.config', 'kilo');
    savedEnv = {
      KILO_CONFIG_DIR: process.env.KILO_CONFIG_DIR,
      XDG_CONFIG_HOME: process.env.XDG_CONFIG_HOME,
    };
    process.env.KILO_CONFIG_DIR = configDir;
    delete process.env.XDG_CONFIG_HOME;
  });

  afterEach(() => {
    if (savedEnv.KILO_CONFIG_DIR === undefined) {
      delete process.env.KILO_CONFIG_DIR;
    } else {
      process.env.KILO_CONFIG_DIR = savedEnv.KILO_CONFIG_DIR;
    }

    if (savedEnv.XDG_CONFIG_HOME === undefined) {
      delete process.env.XDG_CONFIG_HOME;
    } else {
      process.env.XDG_CONFIG_HOME = savedEnv.XDG_CONFIG_HOME;
    }

    cleanup(tmpDir);
  });

  test('writes GSD permissions to kilo.json when config is missing', () => {
    configureKiloPermissions(true);

    const configPath = path.join(configDir, 'kilo.json');
    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
    const gsdPath = `${configDir.replace(/\\/g, '/')}/get-shit-done/*`;

    assert.strictEqual(config.permission.read[gsdPath], 'allow');
    assert.strictEqual(config.permission.external_directory[gsdPath], 'allow');
  });

  test('updates existing kilo.jsonc configs via JSONC parsing', () => {
    fs.mkdirSync(configDir, { recursive: true });
    const configPath = path.join(configDir, 'kilo.jsonc');
    fs.writeFileSync(configPath, '{\n  // existing config\n  "permission": {\n    "bash": "ask",\n  },\n}\n');

    configureKiloPermissions(true);

    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
    const gsdPath = `${configDir.replace(/\\/g, '/')}/get-shit-done/*`;

    assert.strictEqual(config.permission.bash, 'ask');
    assert.strictEqual(config.permission.read[gsdPath], 'allow');
    assert.strictEqual(config.permission.external_directory[gsdPath], 'allow');
  });

  test('writes permissions to an explicit config dir argument', () => {
    const explicitDir = path.join(tmpDir, 'custom-kilo-config');

    configureKiloPermissions(true, explicitDir);

    const configPath = path.join(explicitDir, 'kilo.json');
    const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
    const gsdPath = `${explicitDir.replace(/\\/g, '/')}/get-shit-done/*`;

    assert.strictEqual(config.permission.read[gsdPath], 'allow');
    assert.strictEqual(config.permission.external_directory[gsdPath], 'allow');
  });
});

describe('Source code integration (Kilo)', () => {
  const src = fs.readFileSync(path.join(__dirname, '..', 'bin', 'install.js'), 'utf8');
  const updateWorkflowSrc = fs.readFileSync(path.join(__dirname, '..', 'get-shit-done', 'workflows', 'update.md'), 'utf8');
  // #2790: reapply-patches.md command was absorbed into update.md --reapply.
  // The Kilo-specific env-var checks (KILO_CONFIG_DIR, KILO_CONFIG, XDG_CONFIG_HOME)
  // now live in the update.md workflow (which covers both --sync and --reapply paths).
  const reapplyPatchesSrc = updateWorkflowSrc;

  test('--kilo flag parsing exists', () => {
    assert.ok(src.includes("args.includes('--kilo')"), '--kilo flag parsed');
  });

  test('help text includes --kilo', () => {
    assert.ok(src.includes('Install for Kilo only'), 'help text includes Kilo option');
  });

  test('--all array includes kilo', () => {
    assert.ok(src.includes("'kilo'"), '--all includes kilo runtime');
  });

  test('promptRuntime runtimeMap has Kilo as option 11', () => {
    // Structural assertion against exported runtimeMap rather than source-grep.
    process.env.GSD_TEST_MODE = '1';
    delete require.cache[require.resolve(path.join(__dirname, '..', 'bin', 'install.js'))];
    const { runtimeMap } = require(path.join(__dirname, '..', 'bin', 'install.js'));
    assert.strictEqual(runtimeMap['11'], 'kilo', 'runtimeMap has 11 -> kilo');
  });

  test('prompt text shows Kilo above OpenCode without marketing copy', () => {
    // Call the exported prompt builder; assert against rendered text, not raw source.
    process.env.GSD_TEST_MODE = '1';
    delete require.cache[require.resolve(path.join(__dirname, '..', 'bin', 'install.js'))];
    const { buildRuntimePromptText } = require(path.join(__dirname, '..', 'bin', 'install.js'));
    const promptText = buildRuntimePromptText();
    // Strip ANSI color codes so assertions don't depend on terminal escapes.
    // eslint-disable-next-line no-control-regex
    const plain = promptText.replace(/\x1b\[[0-9;]*m/g, '');
    assert.ok(/\b11\)\s*Kilo\b/.test(plain), 'prompt lists Kilo as option 11');
    const kiloIdx = plain.indexOf('11) Kilo');
    const opencodeIdx = plain.indexOf('OpenCode');
    assert.ok(kiloIdx > -1 && opencodeIdx > -1 && kiloIdx < opencodeIdx,
      'Kilo appears above OpenCode in prompt');
    assert.ok(!plain.includes('the #1 AI coding platform on OpenRouter'),
      'prompt does not include marketing tagline');
  });

  test('hooks are skipped for Kilo', () => {
    assert.ok(src.includes('!isOpencode && !isKilo'), 'hooks skip check includes kilo');
  });

  test('settings.json write excludes Kilo', () => {
    assert.ok(src.includes('!isCodex && !isCopilot && !isKilo && !isCursor && !isWindsurf'), 'settings write excludes kilo');
  });

  test('agent path replacement does not exclude Kilo', () => {
    assert.ok(src.includes('if (!isCopilot && !isAntigravity)'), 'generic agent path replacement still applies');
  });

  test('finishInstall passes the actual config dir to Kilo permissions', () => {
    assert.ok(src.includes('configureKiloPermissions(isGlobal, configDir);'), 'Kilo permission config uses actual install dir');
  });

  test('uninstall cleans Kilo permissions from the resolved target dir', () => {
    assert.ok(src.includes('const configPath = resolveKiloConfigPath(targetDir);'), 'Kilo uninstall cleanup uses targetDir');
  });

  test('update workflow checks preferred custom config dirs before defaults', () => {
    assert.ok(updateWorkflowSrc.includes('PREFERRED_CONFIG_DIR'), 'workflow tracks preferred config dir');
    assert.ok(updateWorkflowSrc.includes('kilo.jsonc'), 'workflow infers Kilo from config files');
    assert.ok(updateWorkflowSrc.includes('ENV_RUNTIME_DIRS'), 'workflow checks env-derived config dirs');
    assert.ok(updateWorkflowSrc.includes('KILO_CONFIG'), 'workflow checks KILO_CONFIG');
  });

  test('reapply-patches checks Kilo custom config env vars first', () => {
    assert.ok(reapplyPatchesSrc.includes('KILO_CONFIG_DIR'), 'reapply-patches checks KILO_CONFIG_DIR');
    assert.ok(reapplyPatchesSrc.includes('KILO_CONFIG'), 'reapply-patches checks KILO_CONFIG');
    assert.ok(reapplyPatchesSrc.includes('XDG_CONFIG_HOME'), 'reapply-patches checks XDG_CONFIG_HOME');
  });
});