kushi-agents 4.3.0 → 4.4.0

package/src/seed-config.test.mjs

@@ -0,0 +1,150 @@
+// Tests for seed-config.mjs — verifies the two-tier shared/ + user/ seeding.
+
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { seedConfig } from './seed-config.mjs';
+import {
+  CONFIG_DOCTRINE_FILES,
+  CONFIG_EXAMPLE_FILES,
+  CONFIG_USER_SEED_FILES,
+  CONFIG_SHARED_SEED_FILES,
+} from './constants.mjs';
+import { loadKushiConfig, resolveKushiConfigPath } from './config-loader.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PKG = path.resolve(__dirname, '..');
+
+function tmp() {
+  return fs.mkdtempSync(path.join(os.tmpdir(), 'kushi-seed-'));
+}
+
+test('seedConfig: fresh install populates shared/ and user/ correctly', () => {
+  const dest = tmp();
+  try {
+    const r = seedConfig(PKG, dest);
+
+    const userTargets    = CONFIG_USER_SEED_FILES.map((f) => f.target);
+    const sharedTargets  = CONFIG_SHARED_SEED_FILES.map((f) => f.target);
+    const doctrineTargets = CONFIG_DOCTRINE_FILES.map((f) => f.target);
+    const exampleTargets = CONFIG_EXAMPLE_FILES.map((f) => f.target);
+
+    for (const t of userTargets)    assert.ok(r.seededUser.includes(t),   `seededUser includes ${t}`);
+    for (const t of sharedTargets)  assert.ok(r.seededShared.includes(t), `seededShared includes ${t}`);
+    for (const t of doctrineTargets) assert.ok(r.doctrine.includes(t),    `doctrine includes ${t}`);
+    for (const t of exampleTargets) assert.ok(r.examples.includes(t),     `examples includes ${t}`);
+
+    for (const t of userTargets) {
+      assert.ok(fs.existsSync(path.join(dest, 'config', 'user', t)), `user/${t} on disk`);
+    }
+    for (const t of [...sharedTargets, ...doctrineTargets, ...exampleTargets]) {
+      assert.ok(fs.existsSync(path.join(dest, 'config', 'shared', t)), `shared/${t} on disk`);
+    }
+
+    assert.equal(r.gitignore, 'created');
+    const gi = fs.readFileSync(path.join(dest, '.gitignore'), 'utf8');
+    assert.ok(gi.includes('config/user/'), '.gitignore contains config/user/');
+  } finally {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+});
+
+test('seedConfig: re-run preserves user/ and shared/ seed-once files', () => {
+  const dest = tmp();
+  try {
+    seedConfig(PKG, dest);
+    const userFile = path.join(dest, 'config', 'user', 'project-evidence.yml');
+    const sharedSeed = path.join(dest, 'config', 'shared', 'integrations.yml');
+    fs.writeFileSync(userFile, 'alias: edited-by-user\n');
+    fs.writeFileSync(sharedSeed, '# team-edited\n');
+
+    const r2 = seedConfig(PKG, dest);
+
+    assert.ok(r2.preservedUser.includes('project-evidence.yml'));
+    assert.ok(r2.preservedShared.includes('integrations.yml'));
+    assert.equal(fs.readFileSync(userFile, 'utf8'), 'alias: edited-by-user\n');
+    assert.equal(fs.readFileSync(sharedSeed, 'utf8'), '# team-edited\n');
+    assert.equal(r2.gitignore, 'unchanged');
+  } finally {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+});
+
+test('seedConfig: doctrine and examples are overwritten on every install', () => {
+  const dest = tmp();
+  try {
+    seedConfig(PKG, dest);
+    const doc = path.join(dest, 'config', 'shared', 'azuredevops.json');
+    const ex  = path.join(dest, 'config', 'shared', 'm365-auth.json.example');
+    fs.writeFileSync(doc, '{"tampered":true}');
+    fs.writeFileSync(ex, '{}');
+
+    const r2 = seedConfig(PKG, dest);
+
+    assert.ok(r2.doctrine.includes('azuredevops.json'));
+    assert.ok(r2.examples.includes('m365-auth.json.example'));
+    const docRe = fs.readFileSync(doc, 'utf8');
+    const exRe  = fs.readFileSync(ex, 'utf8');
+    assert.ok(!docRe.includes('tampered'), 'doctrine restored');
+    assert.ok(exRe.length > 10, 'example restored');
+  } finally {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+});
+
+test('seedConfig: .gitignore is appended when file exists without marker', () => {
+  const dest = tmp();
+  try {
+    fs.writeFileSync(path.join(dest, '.gitignore'), '# pre-existing\nnode_modules/\n');
+    const r = seedConfig(PKG, dest);
+    assert.equal(r.gitignore, 'appended');
+    const gi = fs.readFileSync(path.join(dest, '.gitignore'), 'utf8');
+    assert.ok(gi.includes('node_modules/'), 'preserved existing content');
+    assert.ok(gi.includes('config/user/'), 'appended Kushi marker');
+  } finally {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+});
+
+test('config-loader: resolves user/ before shared/', () => {
+  const workspace = tmp();
+  const dest = path.join(workspace, '.kushi');
+  try {
+    seedConfig(PKG, dest);
+    const sharedResolved = resolveKushiConfigPath('azuredevops', { workspace });
+    assert.ok(sharedResolved.includes(path.join('config', 'shared', 'azuredevops.json')));
+
+    const userShadow = path.join(dest, 'config', 'user', 'azuredevops.json');
+    fs.writeFileSync(userShadow, '{"override":true}');
+    const userResolved = resolveKushiConfigPath('azuredevops', { workspace });
+    assert.equal(userResolved, userShadow);
+  } finally {
+    fs.rmSync(workspace, { recursive: true, force: true });
+  }
+});
+
+test('config-loader: throws on placeholder by default; -allowPlaceholders bypasses', () => {
+  const workspace = tmp();
+  const dest = path.join(workspace, '.kushi');
+  try {
+    seedConfig(PKG, dest);
+    assert.throws(() => loadKushiConfig('project-evidence', { workspace, raw: true }),
+      /placeholder/i);
+    const txt = loadKushiConfig('project-evidence', { workspace, raw: true, allowPlaceholders: true });
+    assert.equal(typeof txt, 'string');
+  } finally {
+    fs.rmSync(workspace, { recursive: true, force: true });
+  }
+});
+
+test('config-loader: throws with actionable message when missing', () => {
+  const dest = tmp();
+  try {
+    assert.throws(() => loadKushiConfig('nonexistent-config', { workspace: dest }), /not found/i);
+  } finally {
+    fs.rmSync(dest, { recursive: true, force: true });
+  }
+});