@avi770/testteam 1.2.0

package/core/__tests__/init.test.ts

@@ -0,0 +1,609 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import type { Interface } from 'node:readline';
+
+// ── Mock node:readline ────────────────────────────────────────────────────
+const mockRlQuestion = vi.fn();
+const mockRlOnce = vi.fn();
+const mockRlClose = vi.fn();
+
+const mockRl: Partial<Interface> = {
+  question: mockRlQuestion,
+  once: mockRlOnce,
+  close: mockRlClose,
+};
+
+vi.mock('node:readline', () => ({
+  createInterface: vi.fn(() => mockRl),
+}));
+
+// ── Mock node:fs ──────────────────────────────────────────────────────────
+vi.mock('node:fs', () => ({
+  readFileSync: vi.fn(),
+  mkdirSync: vi.fn(),
+  writeFileSync: vi.fn(),
+  existsSync: vi.fn(),
+}));
+
+// ── Mock node:path (pass-through with posix-like join) ────────────────────
+vi.mock('node:path', async () => {
+  const actual = await vi.importActual<typeof import('node:path')>('node:path');
+  return {
+    ...actual,
+    basename: actual.basename,
+    resolve: actual.resolve,
+    join: actual.join,
+  };
+});
+
+import { runInitWizard } from '../init';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+
+// ── Helpers ───────────────────────────────────────────────────────────────
+
+/**
+ * Queue a series of answers that will be fed to rl.question() calls in order.
+ * Each call to rl.question(prompt, callback) invokes callback with the next answer.
+ */
+function queueAnswers(answers: string[]): void {
+  let idx = 0;
+  mockRlQuestion.mockImplementation((_prompt: string, cb: (answer: string) => void) => {
+    const answer = idx < answers.length ? answers[idx] : '';
+    idx++;
+    cb(answer);
+  });
+}
+
+/**
+ * Standard set of answers for a complete happy-path wizard run:
+ * 1. Project name (default)
+ * 2. Framework (default)
+ * 3. Test runner (default)
+ * 4. Alpha URL
+ * 5. Beta URL (skip)
+ * 6. UAT URL (skip)
+ * 7. Auth method (default = form-login)
+ * 8. Multi-tenant (default = no)
+ * 9. Confirmation (yes)
+ */
+function queueHappyPathAnswers(overrides: Partial<Record<number, string>> = {}): void {
+  const defaults = [
+    '',                        // 0: project name — use default
+    '',                        // 1: framework — use detected/default
+    '',                        // 2: test runner — use detected/default
+    'http://localhost:3000',   // 3: alpha URL
+    '',                        // 4: beta URL — skip
+    '',                        // 5: UAT URL — skip
+    '',                        // 6: auth method — default (form-login)
+    '',                        // 7: multi-tenant — default (no)
+    'y',                       // 8: confirm
+  ];
+  for (const [i, v] of Object.entries(overrides)) {
+    defaults[Number(i)] = v ?? '';
+  }
+  queueAnswers(defaults);
+}
+
+beforeEach(() => {
+  vi.clearAllMocks();
+  // Default: no existing config, no package.json
+  vi.mocked(existsSync).mockReturnValue(false);
+  vi.mocked(readFileSync).mockReturnValue('{}');
+  // Suppress console output during tests
+  vi.spyOn(console, 'log').mockImplementation(() => {});
+  vi.spyOn(console, 'error').mockImplementation(() => {});
+  // Stub process.on / removeListener so SIGINT handler doesn't leak
+  vi.spyOn(process, 'on').mockImplementation(() => process);
+  vi.spyOn(process, 'removeListener').mockImplementation(() => process);
+});
+
+afterEach(() => {
+  vi.restoreAllMocks();
+});
+
+// ═══════════════════════════════════════════════════════════════════════════
+// Tests
+// ═══════════════════════════════════════════════════════════════════════════
+
+describe('runInitWizard', () => {
+  // ── Happy path ────────────────────────────────────────────────────────
+
+  it('generates config and scaffolds directories on happy path', async () => {
+    queueHappyPathAnswers();
+
+    const exitCode = await runInitWizard();
+
+    expect(exitCode).toBe(0);
+    // Config file written
+    expect(writeFileSync).toHaveBeenCalledWith(
+      expect.stringContaining('testteam.config.ts'),
+      expect.stringContaining("schemaVersion: 1"),
+      'utf-8',
+    );
+    // Directories scaffolded
+    expect(mkdirSync).toHaveBeenCalled();
+  });
+
+  it('writes config containing the project name', async () => {
+    queueHappyPathAnswers({ 0: 'my-cool-project' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    expect(configCall).toBeDefined();
+    expect(String(configCall![1])).toContain("name: 'my-cool-project'");
+  });
+
+  // ── Default values ────────────────────────────────────────────────────
+
+  it('uses directory name as default project name when no package.json', async () => {
+    vi.mocked(existsSync).mockReturnValue(false);
+    queueHappyPathAnswers();
+
+    const exitCode = await runInitWizard();
+
+    expect(exitCode).toBe(0);
+    // Config was written (project name derived from cwd basename)
+    expect(writeFileSync).toHaveBeenCalledWith(
+      expect.stringContaining('testteam.config.ts'),
+      expect.any(String),
+      'utf-8',
+    );
+  });
+
+  it('detects framework from package.json dependencies', async () => {
+    // First existsSync call = config check (false), then package.json (true), then gitkeeps etc
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return false;
+      if (s.includes('package.json')) return true;
+      return false;
+    });
+    vi.mocked(readFileSync).mockReturnValue(
+      JSON.stringify({
+        name: 'my-next-app',
+        dependencies: { next: '14.0.0', react: '18.0.0' },
+        devDependencies: { vitest: '1.0.0' },
+      }),
+    );
+
+    queueHappyPathAnswers();
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+  });
+
+  // ── Existing config guard ─────────────────────────────────────────────
+
+  it('returns 1 when config exists and user declines overwrite', async () => {
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      return String(p).includes('testteam.config.ts');
+    });
+
+    // Answer "no" to overwrite prompt
+    queueAnswers(['n']);
+
+    const exitCode = await runInitWizard();
+
+    expect(exitCode).toBe(1);
+    // Should NOT write config
+    const configWritten = vi.mocked(writeFileSync).mock.calls.some(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    expect(configWritten).toBe(false);
+  });
+
+  it('overwrites config when user confirms', async () => {
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return true;
+      if (s.includes('package.json')) return false;
+      return false;
+    });
+
+    // Answer "y" to overwrite, then normal happy path
+    queueAnswers([
+      'y',                       // overwrite
+      '',                        // project name
+      '',                        // framework
+      '',                        // test runner
+      'http://localhost:3000',   // alpha
+      '',                        // beta
+      '',                        // uat
+      '',                        // auth
+      '',                        // multi-tenant
+      'y',                       // confirm
+    ]);
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+    expect(writeFileSync).toHaveBeenCalledWith(
+      expect.stringContaining('testteam.config.ts'),
+      expect.any(String),
+      'utf-8',
+    );
+  });
+
+  // ── URL validation ────────────────────────────────────────────────────
+
+  it('rejects invalid alpha URL and retries', async () => {
+    // First alpha attempt = invalid, second = valid
+    queueAnswers([
+      '',                        // project name
+      '',                        // framework
+      '',                        // test runner
+      'not-a-url',               // invalid alpha URL
+      'http://localhost:3000',   // valid alpha URL (retry)
+      '',                        // beta
+      '',                        // uat
+      '',                        // auth
+      '',                        // multi-tenant
+      'y',                       // confirm
+    ]);
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('Invalid URL'),
+    );
+  });
+
+  it('skips beta URL when invalid', async () => {
+    queueAnswers([
+      '',                        // project name
+      '',                        // framework
+      '',                        // test runner
+      'http://localhost:3000',   // alpha
+      'not-a-url',               // invalid beta — skipped
+      '',                        // uat
+      '',                        // auth
+      '',                        // multi-tenant
+      'y',                       // confirm
+    ]);
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('Invalid URL — skipping beta'),
+    );
+  });
+
+  it('skips UAT URL when invalid', async () => {
+    queueAnswers([
+      '',                        // project name
+      '',                        // framework
+      '',                        // test runner
+      'http://localhost:3000',   // alpha
+      '',                        // beta
+      'bad-uat',                 // invalid UAT — skipped
+      '',                        // auth
+      '',                        // multi-tenant
+      'y',                       // confirm
+    ]);
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('Invalid URL — skipping UAT'),
+    );
+  });
+
+  // ── Beta and UAT URLs included ────────────────────────────────────────
+
+  it('includes beta and UAT environments in config when provided', async () => {
+    queueAnswers([
+      'my-project',
+      '',                            // framework
+      '',                            // test runner
+      'http://localhost:3000',       // alpha
+      'https://beta.example.com',   // beta
+      'https://uat.example.com',    // UAT
+      '',                            // auth
+      '',                            // multi-tenant
+      'y',                           // confirm
+    ]);
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('beta.example.com');
+    expect(content).toContain('uat.example.com');
+  });
+
+  // ── Auth methods ──────────────────────────────────────────────────────
+
+  it('generates form-login auth block', async () => {
+    queueHappyPathAnswers({ 6: 'form-login' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('loginUrl');
+    expect(content).toContain('TF_ADMIN_EMAIL');
+  });
+
+  it('generates api-token auth block', async () => {
+    queueHappyPathAnswers({ 6: 'api-token' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('TF_API_TOKEN');
+    expect(content).not.toContain('loginUrl');
+  });
+
+  it('generates none auth block', async () => {
+    queueHappyPathAnswers({ 6: 'none' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('credentials: {}');
+  });
+
+  // ── Multi-tenant ──────────────────────────────────────────────────────
+
+  it('generates multi-tenant block when enabled', async () => {
+    queueHappyPathAnswers({ 7: 'y' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('enabled: true');
+    expect(content).toContain("'firm-a'");
+  });
+
+  it('generates single-tenant block when disabled', async () => {
+    queueHappyPathAnswers({ 7: 'n' });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain('enabled: false');
+    expect(content).toContain('testFirms: []');
+  });
+
+  // ── Confirmation declined ─────────────────────────────────────────────
+
+  it('returns 1 when user declines final confirmation', async () => {
+    queueAnswers([
+      '',                        // project name
+      '',                        // framework
+      '',                        // test runner
+      'http://localhost:3000',   // alpha
+      '',                        // beta
+      '',                        // uat
+      '',                        // auth
+      '',                        // multi-tenant
+      'n',                       // decline confirmation
+    ]);
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(1);
+  });
+
+  // ── Cancellation / CancelledError ─────────────────────────────────────
+
+  it('returns 130 when readline closes (CancelledError)', async () => {
+    // Simulate rl.close being called during a question
+    mockRlQuestion.mockImplementation((_prompt: string, _cb: (answer: string) => void) => {
+      // Don't call cb — instead trigger the close listener
+    });
+    mockRlOnce.mockImplementation((_event: string, handler: () => void) => {
+      // Immediately fire close
+      handler();
+    });
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(130);
+  });
+
+  // ── Scaffold directories ──────────────────────────────────────────────
+
+  it('creates baseline directories and .gitkeep files', async () => {
+    queueHappyPathAnswers();
+
+    await runInitWizard();
+
+    // mkdirSync should be called for each directory
+    expect(mkdirSync).toHaveBeenCalledTimes(6);
+    expect(mkdirSync).toHaveBeenCalledWith(
+      expect.stringContaining('baselines'),
+      { recursive: true },
+    );
+    expect(mkdirSync).toHaveBeenCalledWith(
+      expect.stringContaining('reports'),
+      { recursive: true },
+    );
+  });
+
+  it('does not overwrite existing .gitkeep files', async () => {
+    // Config doesn't exist, but gitkeep files do
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return false;
+      if (s.includes('package.json')) return false;
+      if (s.includes('.gitkeep')) return true;
+      if (s.includes('.gitignore')) return true;
+      return false;
+    });
+
+    queueHappyPathAnswers();
+
+    await runInitWizard();
+
+    // .gitkeep files should NOT be written (they already exist)
+    const gitkeepWrites = vi.mocked(writeFileSync).mock.calls.filter(
+      (call) => String(call[0]).includes('.gitkeep'),
+    );
+    expect(gitkeepWrites).toHaveLength(0);
+  });
+
+  // ── Framework detection ───────────────────────────────────────────────
+
+  it('detects NestJS framework', async () => {
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return false;
+      if (s.includes('package.json')) return true;
+      return false;
+    });
+    vi.mocked(readFileSync).mockReturnValue(
+      JSON.stringify({
+        name: 'nest-api',
+        dependencies: { '@nestjs/core': '10.0.0' },
+      }),
+    );
+
+    queueHappyPathAnswers();
+    await runInitWizard();
+    // No assertion needed on framework detection beyond exit code 0
+    // The detection is an internal default; we just verify no crash.
+    expect(writeFileSync).toHaveBeenCalled();
+  });
+
+  it('detects jest test runner', async () => {
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return false;
+      if (s.includes('package.json')) return true;
+      return false;
+    });
+    vi.mocked(readFileSync).mockReturnValue(
+      JSON.stringify({
+        name: 'jest-app',
+        devDependencies: { jest: '29.0.0' },
+      }),
+    );
+
+    queueHappyPathAnswers();
+    await runInitWizard();
+    expect(writeFileSync).toHaveBeenCalled();
+  });
+
+  // ── Handles malformed package.json ────────────────────────────────────
+
+  it('handles malformed package.json gracefully', async () => {
+    vi.mocked(existsSync).mockImplementation((p: unknown) => {
+      const s = String(p);
+      if (s.includes('testteam.config.ts')) return false;
+      if (s.includes('package.json')) return true;
+      return false;
+    });
+    vi.mocked(readFileSync).mockReturnValue('not-valid-json{{{');
+
+    queueHappyPathAnswers();
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+    // Should have warned about missing package.json (parsing failed)
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('Warning'),
+    );
+  });
+
+  // ── Config file content structure ─────────────────────────────────────
+
+  it('generated config includes all expected sections', async () => {
+    queueHappyPathAnswers();
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+
+    expect(content).toContain("import type { TestTeamConfig }");
+    expect(content).toContain('schemaVersion: 1');
+    expect(content).toContain('environments:');
+    expect(content).toContain('modules:');
+    expect(content).toContain('portals:');
+    expect(content).toContain('breakpoints:');
+    expect(content).toContain('accuracy:');
+    expect(content).toContain('tenancy:');
+    expect(content).toContain('costBudget:');
+    expect(content).toContain('agentClassification:');
+    expect(content).toContain('thresholds:');
+    expect(content).toContain('disabledAgents:');
+    expect(content).toContain('export default config');
+  });
+
+  // ── Escaping special characters ───────────────────────────────────────
+
+  it('escapes single quotes in project name', async () => {
+    queueHappyPathAnswers({ 0: "my project's app" });
+
+    await runInitWizard();
+
+    const configCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('testteam.config.ts'),
+    );
+    const content = String(configCall![1]);
+    expect(content).toContain("my project\\'s app");
+  });
+
+  // ── Next steps output ─────────────────────────────────────────────────
+
+  it('prints next steps for form-login auth', async () => {
+    queueHappyPathAnswers({ 6: 'form-login' });
+
+    await runInitWizard();
+
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('TF_ADMIN_EMAIL'),
+    );
+  });
+
+  it('prints next steps for api-token auth', async () => {
+    queueHappyPathAnswers({ 6: 'api-token' });
+
+    await runInitWizard();
+
+    expect(console.log).toHaveBeenCalledWith(
+      expect.stringContaining('TF_API_TOKEN'),
+    );
+  });
+
+  // ── Partial match in promptChoice ─────────────────────────────────────
+
+  it('accepts partial framework input (e.g., "nes" for "nestjs")', async () => {
+    queueHappyPathAnswers({ 1: 'nes' });
+
+    const exitCode = await runInitWizard();
+    expect(exitCode).toBe(0);
+  });
+
+  // ── .gitignore creation ───────────────────────────────────────────────
+
+  it('creates .gitignore in testteam directory', async () => {
+    queueHappyPathAnswers();
+
+    await runInitWizard();
+
+    const gitignoreCall = vi.mocked(writeFileSync).mock.calls.find(
+      (call) => String(call[0]).includes('.gitignore'),
+    );
+    expect(gitignoreCall).toBeDefined();
+    expect(String(gitignoreCall![1])).toContain('reports/*.html');
+  });
+});