@avi770/testteam 1.2.0

package/core/init.ts

@@ -0,0 +1,546 @@
+import { createInterface, Interface } from 'node:readline';
+import { readFileSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { basename, resolve, join } from 'node:path';
+
+// ── Types ──────────────────────────────────────────────────────────────────
+
+type Framework = 'react' | 'next' | 'vue' | 'angular' | 'nestjs' | 'express' | 'generic';
+type TestRunner = 'vitest' | 'jest' | 'none';
+type AuthMethod = 'form-login' | 'api-token' | 'none';
+
+interface InitAnswers {
+  projectName: string;
+  framework: Framework;
+  testRunner: TestRunner;
+  alphaUrl: string;
+  betaUrl: string;
+  uatUrl: string;
+  authMethod: AuthMethod;
+  multiTenant: boolean;
+}
+
+// ── Cancellation sentinel ────────────────────────────────────────────────
+
+class CancelledError extends Error {
+  constructor() {
+    super('Setup cancelled.');
+    this.name = 'CancelledError';
+  }
+}
+
+// ── Prompt helper ──────────────────────────────────────────────────────────
+
+function prompt(
+  rl: Interface,
+  question: string,
+  defaultValue: string,
+): Promise<string> {
+  const suffix = defaultValue ? ` (${defaultValue})` : '';
+  return new Promise<string>((resolve, reject) => {
+    rl.question(`${question}${suffix}: `, (answer: string) => {
+      resolve(answer.trim() || defaultValue);
+    });
+    rl.once('close', () => reject(new CancelledError()));
+  });
+}
+
+function promptChoice<T extends string>(
+  rl: Interface,
+  question: string,
+  choices: readonly T[],
+  defaultValue: T,
+): Promise<T> {
+  const choiceStr = choices
+    .map((c) => (c === defaultValue ? `[${c}]` : c))
+    .join(' / ');
+  return new Promise<T>((resolve, reject) => {
+    rl.question(`${question} ${choiceStr}: `, (answer: string) => {
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === '') {
+        resolve(defaultValue);
+        return;
+      }
+      const match = choices.find((c) => c === trimmed);
+      if (match) {
+        resolve(match);
+        return;
+      }
+      // Partial match — first choice that starts with the input
+      const partial = choices.find((c) => c.startsWith(trimmed));
+      resolve(partial ?? defaultValue);
+    });
+    rl.once('close', () => reject(new CancelledError()));
+  });
+}
+
+function promptYesNo(
+  rl: Interface,
+  question: string,
+  defaultValue: boolean,
+): Promise<boolean> {
+  const hint = defaultValue ? '(Y/n)' : '(y/N)';
+  return new Promise<boolean>((resolve, reject) => {
+    rl.question(`${question} ${hint}: `, (answer: string) => {
+      const trimmed = answer.trim().toLowerCase();
+      if (trimmed === '') {
+        resolve(defaultValue);
+        return;
+      }
+      resolve(trimmed === 'y' || trimmed === 'yes');
+    });
+    rl.once('close', () => reject(new CancelledError()));
+  });
+}
+
+// ── Validation helpers ───────────────────────────────────────────────────
+
+function isValidUrl(value: string): boolean {
+  return /^https?:\/\/.+/.test(value);
+}
+
+// ── Detection helpers ──────────────────────────────────────────────────────
+
+interface PackageJson {
+  name?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+}
+
+function readTargetPackageJson(cwd: string): PackageJson | null {
+  const pkgPath = join(cwd, 'package.json');
+  if (!existsSync(pkgPath)) {
+    return null;
+  }
+  try {
+    const raw = readFileSync(pkgPath, 'utf-8');
+    return JSON.parse(raw) as PackageJson;
+  } catch {
+    return null;
+  }
+}
+
+function detectFramework(pkg: PackageJson | null): Framework {
+  if (!pkg) return 'generic';
+  const all: Record<string, string> = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies,
+  };
+  if ('next' in all) return 'next';
+  if ('@nestjs/core' in all) return 'nestjs';
+  if ('@angular/core' in all) return 'angular';
+  if ('vue' in all) return 'vue';
+  if ('express' in all) return 'express';
+  if ('react' in all) return 'react';
+  return 'generic';
+}
+
+function detectTestRunner(pkg: PackageJson | null): TestRunner {
+  if (!pkg) return 'none';
+  const all: Record<string, string> = {
+    ...pkg.dependencies,
+    ...pkg.devDependencies,
+  };
+  if ('vitest' in all) return 'vitest';
+  if ('jest' in all) return 'jest';
+  return 'none';
+}
+
+// ── Config generation ──────────────────────────────────────────────────────
+
+function buildConfigSource(answers: InitAnswers): string {
+  const envBlock = buildEnvironmentsBlock(answers);
+  const authBlock = buildAuthBlock(answers);
+  const tenancyBlock = buildTenancyBlock(answers);
+
+  return `import type { TestTeamConfig } from './core/config';
+
+const config: TestTeamConfig = {
+  schemaVersion: 1,
+  name: '${escapeString(answers.projectName)}',
+
+${authBlock},
+
+  modules: [
+    { id: 'home', route: '/', sidebarIcon: true },
+    // Add your app's modules here
+  ],
+
+${envBlock},
+
+  portals: [
+    { name: 'main', queryParam: null },
+  ],
+
+  breakpoints: [1920, 1366, 768, 375],
+  integrations: [],
+  workers: [],
+  workflows: [],
+
+  accuracy: {
+    enabled: false,
+    decimalPrecision: 2,
+    currencySymbol: 'USD',
+    timezone: 'UTC',
+  },
+
+${tenancyBlock},
+
+  costBudget: {
+    maxPerRun: 50,
+    maxPerAgent: 10,
+    alertThreshold: 0.8,
+    onExceeded: 'abort',
+  },
+
+  agentClassification: {
+    blocking: [1, 2, 3, 4, 5, 6, 7, 8, 11, 14, 19, 23],
+    advisory: [12, 13, 15, 16, 17, 20, 21, 22],
+  },
+
+  thresholds: {
+    unitCoverage: { lines: 80, functions: 80, branches: 70, statements: 80 },
+    lighthouse: { accessibility: 90, performance: 85, bestPractices: 85, seo: 80 },
+    apiResponseTime: 500,
+    bundleSizeLimit: 500,
+    maxConsoleErrors: 0,
+  },
+
+  disabledAgents: [],
+};
+
+export default config;
+`;
+}
+
+function escapeString(value: string): string {
+  return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+
+function buildEnvironmentsBlock(answers: InitAnswers): string {
+  const lines: string[] = ['  environments: {'];
+  lines.push(`    alpha: { baseUrl: '${escapeString(answers.alphaUrl)}', seed: true },`);
+  if (answers.betaUrl) {
+    lines.push(`    beta: { baseUrl: '${escapeString(answers.betaUrl)}', seed: false },`);
+  }
+  if (answers.uatUrl) {
+    lines.push(`    uat: { baseUrl: '${escapeString(answers.uatUrl)}', seed: false },`);
+  }
+  lines.push('  }');
+  return lines.join('\n');
+}
+
+function buildAuthBlock(answers: InitAnswers): string {
+  switch (answers.authMethod) {
+    case 'form-login':
+      return `  auth: {
+    loginUrl: '/login',
+    credentials: {
+      admin: {
+        email: process.env.TF_ADMIN_EMAIL ?? '',
+        password: process.env.TF_ADMIN_PASSWORD ?? '',
+      },
+    },
+    roles: [
+      { name: 'admin', email: process.env.TF_ROLE_ADMIN_EMAIL ?? '' },
+    ],
+  }`;
+
+    case 'api-token':
+      return `  auth: {
+    credentials: {
+      api: {
+        email: process.env.TF_API_EMAIL ?? '',
+        password: process.env.TF_API_TOKEN ?? '',
+      },
+    },
+    roles: [],
+  }`;
+
+    case 'none':
+      return `  auth: {
+    credentials: {},
+    roles: [],
+  }`;
+  }
+}
+
+function buildTenancyBlock(answers: InitAnswers): string {
+  if (answers.multiTenant) {
+    return `  tenancy: {
+    enabled: true,
+    isolationField: 'tenantId',
+    testFirms: ['firm-a', 'firm-b'],
+  }`;
+  }
+  return `  tenancy: {
+    enabled: false,
+    isolationField: 'tenantId',
+    testFirms: [],
+  }`;
+}
+
+// ── Baseline scaffolding ───────────────────────────────────────────────────
+
+function scaffoldBaselines(cwd: string): void {
+  const baseDir = join(cwd, 'testteam');
+  const dirs = [
+    baseDir,
+    join(baseDir, 'baselines'),
+    join(baseDir, 'baselines', 'screenshots'),
+    join(baseDir, 'baselines', 'api-snapshots'),
+    join(baseDir, 'baselines', 'dom-snapshots'),
+    join(baseDir, 'reports'),
+  ];
+
+  for (const dir of dirs) {
+    mkdirSync(dir, { recursive: true });
+  }
+
+  // Create .gitkeep files so empty dirs are tracked
+  const gitkeeps = [
+    join(baseDir, 'baselines', 'screenshots', '.gitkeep'),
+    join(baseDir, 'baselines', 'api-snapshots', '.gitkeep'),
+    join(baseDir, 'baselines', 'dom-snapshots', '.gitkeep'),
+    join(baseDir, 'reports', '.gitkeep'),
+  ];
+
+  for (const filepath of gitkeeps) {
+    if (!existsSync(filepath)) {
+      writeFileSync(filepath, '', 'utf-8');
+    }
+  }
+
+  // Create a starter .gitignore for the testteam directory
+  const gitignorePath = join(baseDir, '.gitignore');
+  if (!existsSync(gitignorePath)) {
+    writeFileSync(
+      gitignorePath,
+      `# TestTeam runtime artifacts
+reports/*.html
+reports/*.json
+!reports/.gitkeep
+`,
+      'utf-8',
+    );
+  }
+}
+
+// ── Summary display ─────────────────────────────────────────────────────
+
+function printSummary(answers: InitAnswers): void {
+  console.log('\n  ── Configuration Summary ──────────────────────');
+  console.log(`  Project:       ${answers.projectName}`);
+  console.log(`  Framework:     ${answers.framework}`);
+  console.log(`  Test runner:   ${answers.testRunner}`);
+  console.log(`  Alpha URL:     ${answers.alphaUrl}`);
+  if (answers.betaUrl) {
+    console.log(`  Beta URL:      ${answers.betaUrl}`);
+  }
+  if (answers.uatUrl) {
+    console.log(`  UAT URL:       ${answers.uatUrl}`);
+  }
+  console.log(`  Auth method:   ${answers.authMethod}`);
+  console.log(`  Multi-tenant:  ${answers.multiTenant ? 'yes' : 'no'}`);
+  console.log('  ────────────────────────────────────────────────\n');
+}
+
+// ── Main init wizard ───────────────────────────────────────────────────────
+
+export async function runInitWizard(): Promise<number> {
+  const cwd = process.cwd();
+  const configTarget = join(cwd, 'testteam.config.ts');
+
+  console.log('\n  TestTeam  --  Init Wizard\n');
+
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  // ── SIGINT handling: gracefully exit on Ctrl+C ─────────────────────────
+  let cancelled = false;
+  const sigintHandler = (): void => {
+    cancelled = true;
+    console.log('\n\n  Setup cancelled.');
+    rl.close();
+    process.exit(130);
+  };
+  process.on('SIGINT', sigintHandler);
+
+  const cleanup = (): void => {
+    process.removeListener('SIGINT', sigintHandler);
+    rl.close();
+  };
+
+  try {
+    // ── Existing config guard ──────────────────────────────────────────
+    if (existsSync(configTarget)) {
+      const overwrite = await promptYesNo(
+        rl,
+        'Config already exists. Overwrite?',
+        false,
+      );
+      if (!overwrite) {
+        console.log('  Setup cancelled.');
+        cleanup();
+        return 1;
+      }
+    }
+
+    // ── Missing package.json warning ─────────────────────────────────
+    const pkg = readTargetPackageJson(cwd);
+    if (pkg === null) {
+      console.log(
+        '  Warning: No package.json found in current directory.\n' +
+        '  Framework and test runner detection will use defaults.\n',
+      );
+    }
+
+    const detectedFramework = detectFramework(pkg);
+    const detectedTestRunner = detectTestRunner(pkg);
+    const dirName = basename(resolve(cwd));
+
+    // ── Gather answers ───────────────────────────────────────────────
+    const projectName = await prompt(rl, 'Project name', pkg?.name ?? dirName);
+
+    const framework = await promptChoice<Framework>(
+      rl,
+      'Framework?',
+      ['react', 'next', 'vue', 'angular', 'nestjs', 'express', 'generic'] as const,
+      detectedFramework,
+    );
+
+    const testRunner = await promptChoice<TestRunner>(
+      rl,
+      'Test runner?',
+      ['vitest', 'jest', 'none'] as const,
+      detectedTestRunner,
+    );
+
+    // Alpha URL — required, with validation
+    let alphaUrl = '';
+    const defaultAlpha = 'http://localhost:3000';
+    while (!alphaUrl) {
+      const raw = await prompt(rl, 'Alpha environment URL', defaultAlpha);
+      if (isValidUrl(raw)) {
+        alphaUrl = raw;
+      } else {
+        console.log('  Invalid URL. Must start with http:// or https://');
+      }
+    }
+
+    // Beta URL — optional, validated when provided
+    let betaUrl = '';
+    const rawBeta = await prompt(rl, 'Beta/staging URL (leave blank to skip)', '');
+    if (rawBeta !== '') {
+      if (isValidUrl(rawBeta)) {
+        betaUrl = rawBeta;
+      } else {
+        console.log('  Invalid URL — skipping beta environment.');
+      }
+    }
+
+    // UAT URL — optional, validated when provided
+    let uatUrl = '';
+    const rawUat = await prompt(rl, 'UAT/production URL (leave blank to skip)', '');
+    if (rawUat !== '') {
+      if (isValidUrl(rawUat)) {
+        uatUrl = rawUat;
+      } else {
+        console.log('  Invalid URL — skipping UAT environment.');
+      }
+    }
+
+    const authMethod = await promptChoice<AuthMethod>(
+      rl,
+      'Auth method?',
+      ['form-login', 'api-token', 'none'] as const,
+      'form-login',
+    );
+
+    const multiTenant = await promptYesNo(rl, 'Multi-tenant?', false);
+
+    const answers: InitAnswers = {
+      projectName,
+      framework,
+      testRunner,
+      alphaUrl,
+      betaUrl,
+      uatUrl,
+      authMethod,
+      multiTenant,
+    };
+
+    // ── Confirmation prompt ──────────────────────────────────────────
+    printSummary(answers);
+
+    const confirmed = await promptYesNo(
+      rl,
+      'Create config with these settings?',
+      true,
+    );
+
+    if (!confirmed) {
+      console.log('  Setup cancelled.');
+      cleanup();
+      return 1;
+    }
+
+    cleanup();
+
+    // ── Write config file ────────────────────────────────────────────
+    const configSource = buildConfigSource(answers);
+    writeFileSync(configTarget, configSource, 'utf-8');
+    console.log(`\n  Created  testteam.config.ts`);
+
+    // ── Scaffold baselines directory ─────────────────────────────────
+    scaffoldBaselines(cwd);
+    console.log('  Created  testteam/ directory with starter baselines');
+
+    // ── Print next steps ─────────────────────────────────────────────
+    printNextSteps(answers);
+
+    return 0;
+  } catch (error) {
+    cleanup();
+
+    if (cancelled || error instanceof CancelledError) {
+      console.log('\n  Setup cancelled.');
+      return 130;
+    }
+
+    console.error(
+      `Init failed: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    return 1;
+  }
+}
+
+function printNextSteps(answers: InitAnswers): void {
+  console.log(`
+  Next steps
+  ----------
+
+  1. Edit testteam.config.ts to add your app's modules and routes.
+
+  2. Set environment variables for credentials:`);
+
+  if (answers.authMethod === 'form-login') {
+    console.log(`       export TF_ADMIN_EMAIL="admin@example.com"
+       export TF_ADMIN_PASSWORD="your-password"`);
+  } else if (answers.authMethod === 'api-token') {
+    console.log(`       export TF_API_EMAIL="api@example.com"
+       export TF_API_TOKEN="your-token"`);
+  }
+
+  console.log(`
+  3. Run a dry-run to see the dispatch plan:
+       npx testteam --dry-run
+
+  4. Run the alpha phase:
+       npx testteam --phase alpha
+
+  5. Run all phases:
+       npx testteam --phase all
+`);
+}