agent-gauntlet 0.1.10 → 0.1.11

package/src/cli-adapters/index.ts

@@ -1,79 +1,108 @@
 export interface CLIAdapterHealth {
-  available: boolean;
-  status: 'healthy' | 'missing' | 'unhealthy';
-  message?: string;
+	available: boolean;
+	status: "healthy" | "missing" | "unhealthy";
+	message?: string;
 }
 
 export function isUsageLimit(output: string): boolean {
-  const lower = output.toLowerCase();
-  return lower.includes('usage limit') || 
-         lower.includes('quota exceeded') ||
-         lower.includes('quota will reset') ||
-         lower.includes('credit balance is too low') ||
-         lower.includes('out of extra usage') ||
-         lower.includes('out of usage');
+	const lower = output.toLowerCase();
+	return (
+		lower.includes("usage limit") ||
+		lower.includes("quota exceeded") ||
+		lower.includes("quota will reset") ||
+		lower.includes("credit balance is too low") ||
+		lower.includes("out of extra usage") ||
+		lower.includes("out of usage")
+	);
 }
 
 export interface CLIAdapter {
-  name: string;
-  isAvailable(): Promise<boolean>;
-  checkHealth(options?: { checkUsageLimit?: boolean }): Promise<CLIAdapterHealth>;
-  execute(opts: { prompt: string; diff: string; model?: string; timeoutMs?: number }): Promise<string>;
-  /**
-   * Returns the project-scoped command directory path (relative to project root).
-   * Returns null if the CLI only supports user-level commands.
-   */
-  getProjectCommandDir(): string | null;
-  /**
-   * Returns the user-level command directory path (absolute path).
-   * Returns null if the CLI doesn't support user-level commands.
-   */
-  getUserCommandDir(): string | null;
-  /**
-   * Returns the command file extension used by this CLI.
-   */
-  getCommandExtension(): string;
-  /**
-   * Returns true if this adapter can use symlinks (same format as source Markdown).
-   */
-  canUseSymlink(): boolean;
-  /**
-   * Transforms gauntlet command content to this CLI's format.
-   * The source content is always Markdown with YAML frontmatter.
-   */
-  transformCommand(markdownContent: string): string;
+	name: string;
+	isAvailable(): Promise<boolean>;
+	checkHealth(options?: {
+		checkUsageLimit?: boolean;
+	}): Promise<CLIAdapterHealth>;
+	execute(opts: {
+		prompt: string;
+		diff: string;
+		model?: string;
+		timeoutMs?: number;
+	}): Promise<string>;
+	/**
+	 * Returns the project-scoped command directory path (relative to project root).
+	 * Returns null if the CLI only supports user-level commands.
+	 */
+	getProjectCommandDir(): string | null;
+	/**
+	 * Returns the user-level command directory path (absolute path).
+	 * Returns null if the CLI doesn't support user-level commands.
+	 */
+	getUserCommandDir(): string | null;
+	/**
+	 * Returns the command file extension used by this CLI.
+	 */
+	getCommandExtension(): string;
+	/**
+	 * Returns true if this adapter can use symlinks (same format as source Markdown).
+	 */
+	canUseSymlink(): boolean;
+	/**
+	 * Transforms gauntlet command content to this CLI's format.
+	 * The source content is always Markdown with YAML frontmatter.
+	 */
+	transformCommand(markdownContent: string): string;
 }
 
-import { GeminiAdapter } from './gemini.js';
-import { CodexAdapter } from './codex.js';
-import { ClaudeAdapter } from './claude.js';
+import { ClaudeAdapter } from "./claude.js";
+import { CodexAdapter } from "./codex.js";
+import { CursorAdapter } from "./cursor.js";
+import { GeminiAdapter } from "./gemini.js";
+import { GitHubCopilotAdapter } from "./github-copilot.js";
 
-export { GeminiAdapter, CodexAdapter, ClaudeAdapter };
+export {
+	GeminiAdapter,
+	CodexAdapter,
+	ClaudeAdapter,
+	GitHubCopilotAdapter,
+	CursorAdapter,
+};
 
+// Adapter registry: keys should use lowercase with hyphens for multi-word names
 const adapters: Record<string, CLIAdapter> = {
-  gemini: new GeminiAdapter(),
-  codex: new CodexAdapter(),
-  claude: new ClaudeAdapter(),
+	gemini: new GeminiAdapter(),
+	codex: new CodexAdapter(),
+	claude: new ClaudeAdapter(),
+	"github-copilot": new GitHubCopilotAdapter(),
+	cursor: new CursorAdapter(),
 };
 
 export function getAdapter(name: string): CLIAdapter | undefined {
-  return adapters[name];
+	return adapters[name];
 }
 
 export function getAllAdapters(): CLIAdapter[] {
-  return Object.values(adapters);
+	return Object.values(adapters);
 }
 
 /**
  * Returns all adapters that support project-scoped commands.
  */
 export function getProjectCommandAdapters(): CLIAdapter[] {
-  return Object.values(adapters).filter(a => a.getProjectCommandDir() !== null);
+	return Object.values(adapters).filter(
+		(a) => a.getProjectCommandDir() !== null,
+	);
 }
 
 /**
  * Returns all adapters that support user-level commands.
  */
 export function getUserCommandAdapters(): CLIAdapter[] {
-  return Object.values(adapters).filter(a => a.getUserCommandDir() !== null);
+	return Object.values(adapters).filter((a) => a.getUserCommandDir() !== null);
+}
+
+/**
+ * Returns all valid CLI tool names (adapter registry keys).
+ */
+export function getValidCLITools(): string[] {
+	return Object.keys(adapters);
 }

package/src/commands/check.test.ts

@@ -1,25 +1,29 @@
-import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
-import { Command } from 'commander';
-import { registerCheckCommand } from './check.js';
+import { beforeEach, describe, expect, it } from "bun:test";
+import { Command } from "commander";
+import { registerCheckCommand } from "./check.js";
 
-describe('Check Command', () => {
-  let program: Command;
+describe("Check Command", () => {
+	let program: Command;
 
-  beforeEach(() => {
-    program = new Command();
-    registerCheckCommand(program);
-  });
+	beforeEach(() => {
+		program = new Command();
+		registerCheckCommand(program);
+	});
 
-  it('should register the check command', () => {
-    const checkCmd = program.commands.find(cmd => cmd.name() === 'check');
-    expect(checkCmd).toBeDefined();
-    expect(checkCmd?.description()).toBe('Run only applicable checks for detected changes');
-  });
+	it("should register the check command", () => {
+		const checkCmd = program.commands.find((cmd) => cmd.name() === "check");
+		expect(checkCmd).toBeDefined();
+		expect(checkCmd?.description()).toBe(
+			"Run only applicable checks for detected changes",
+		);
+	});
 
-  it('should have correct options', () => {
-    const checkCmd = program.commands.find(cmd => cmd.name() === 'check');
-    expect(checkCmd?.options.some(opt => opt.long === '--gate')).toBe(true);
-    expect(checkCmd?.options.some(opt => opt.long === '--commit')).toBe(true);
-    expect(checkCmd?.options.some(opt => opt.long === '--uncommitted')).toBe(true);
-  });
+	it("should have correct options", () => {
+		const checkCmd = program.commands.find((cmd) => cmd.name() === "check");
+		expect(checkCmd?.options.some((opt) => opt.long === "--gate")).toBe(true);
+		expect(checkCmd?.options.some((opt) => opt.long === "--commit")).toBe(true);
+		expect(checkCmd?.options.some((opt) => opt.long === "--uncommitted")).toBe(
+			true,
+		);
+	});
 });

package/src/commands/check.ts

@@ -1,72 +1,78 @@
-import type { Command } from 'commander';
-import chalk from 'chalk';
-import { loadConfig } from '../config/loader.js';
-import { ChangeDetector } from '../core/change-detector.js';
-import { EntryPointExpander } from '../core/entry-point.js';
-import { JobGenerator } from '../core/job.js';
-import { Runner } from '../core/runner.js';
-import { Logger } from '../output/logger.js';
-import { ConsoleReporter } from '../output/console.js';
-import { rotateLogs } from './shared.js';
+import chalk from "chalk";
+import type { Command } from "commander";
+import { loadConfig } from "../config/loader.js";
+import { ChangeDetector } from "../core/change-detector.js";
+import { EntryPointExpander } from "../core/entry-point.js";
+import { JobGenerator } from "../core/job.js";
+import { Runner } from "../core/runner.js";
+import { ConsoleReporter } from "../output/console.js";
+import { Logger } from "../output/logger.js";
+import { rotateLogs } from "./shared.js";
 
 export function registerCheckCommand(program: Command): void {
-  program
-    .command('check')
-    .description('Run only applicable checks for detected changes')
-    .option('-g, --gate <name>', 'Run specific check gate only')
-    .option('-c, --commit <sha>', 'Use diff for a specific commit')
-    .option('-u, --uncommitted', 'Use diff for current uncommitted changes (staged and unstaged)')
-    .action(async (options) => {
-      try {
-        const config = await loadConfig();
+	program
+		.command("check")
+		.description("Run only applicable checks for detected changes")
+		.option("-g, --gate <name>", "Run specific check gate only")
+		.option("-c, --commit <sha>", "Use diff for a specific commit")
+		.option(
+			"-u, --uncommitted",
+			"Use diff for current uncommitted changes (staged and unstaged)",
+		)
+		.action(async (options) => {
+			try {
+				const config = await loadConfig();
 
-        // Rotate logs before starting
-        await rotateLogs(config.project.log_dir);
+				// Rotate logs before starting
+				await rotateLogs(config.project.log_dir);
 
-        const changeDetector = new ChangeDetector(config.project.base_branch, {
-          commit: options.commit,
-          uncommitted: options.uncommitted
-        });
-        const expander = new EntryPointExpander();
-        const jobGen = new JobGenerator(config);
-        
-        console.log(chalk.dim('Detecting changes...'));
-        const changes = await changeDetector.getChangedFiles();
-        
-        if (changes.length === 0) {
-          console.log(chalk.green('No changes detected.'));
-          process.exit(0);
-        }
-        
-        console.log(chalk.dim(`Found ${changes.length} changed files.`));
+				const changeDetector = new ChangeDetector(config.project.base_branch, {
+					commit: options.commit,
+					uncommitted: options.uncommitted,
+				});
+				const expander = new EntryPointExpander();
+				const jobGen = new JobGenerator(config);
 
-        const entryPoints = await expander.expand(config.project.entry_points, changes);
-        let jobs = jobGen.generateJobs(entryPoints);
+				console.log(chalk.dim("Detecting changes..."));
+				const changes = await changeDetector.getChangedFiles();
 
-        // Filter to only checks
-        jobs = jobs.filter(j => j.type === 'check');
+				if (changes.length === 0) {
+					console.log(chalk.green("No changes detected."));
+					process.exit(0);
+				}
 
-        if (options.gate) {
-          jobs = jobs.filter(j => j.name === options.gate);
-        }
+				console.log(chalk.dim(`Found ${changes.length} changed files.`));
 
-        if (jobs.length === 0) {
-          console.log(chalk.yellow('No applicable checks for these changes.'));
-          process.exit(0);
-        }
+				const entryPoints = await expander.expand(
+					config.project.entry_points,
+					changes,
+				);
+				let jobs = jobGen.generateJobs(entryPoints);
 
-        console.log(chalk.dim(`Running ${jobs.length} check(s)...`));
+				// Filter to only checks
+				jobs = jobs.filter((j) => j.type === "check");
 
-        const logger = new Logger(config.project.log_dir);
-        const reporter = new ConsoleReporter();
-        const runner = new Runner(config, logger, reporter);
+				if (options.gate) {
+					jobs = jobs.filter((j) => j.name === options.gate);
+				}
 
-        const success = await runner.run(jobs);
-        process.exit(success ? 0 : 1);
+				if (jobs.length === 0) {
+					console.log(chalk.yellow("No applicable checks for these changes."));
+					process.exit(0);
+				}
 
-      } catch (error: any) {
-        console.error(chalk.red('Error:'), error.message);
-        process.exit(1);
-      }
-    });
+				console.log(chalk.dim(`Running ${jobs.length} check(s)...`));
+
+				const logger = new Logger(config.project.log_dir);
+				const reporter = new ConsoleReporter();
+				const runner = new Runner(config, logger, reporter);
+
+				const success = await runner.run(jobs);
+				process.exit(success ? 0 : 1);
+			} catch (error: unknown) {
+				const err = error as { message?: string };
+				console.error(chalk.red("Error:"), err.message);
+				process.exit(1);
+			}
+		});
 }

package/src/commands/detect.test.ts

@@ -1,37 +1,43 @@
-import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
-import { Command } from 'commander';
-import { registerDetectCommand } from './detect.js';
+import { afterEach, beforeEach, describe, expect, it } from "bun:test";
+import { Command } from "commander";
+import { registerDetectCommand } from "./detect.js";
 
-describe('Detect Command', () => {
-  let program: Command;
-  const originalConsoleLog = console.log;
-  const originalConsoleError = console.error;
-  let logs: string[];
-  let errors: string[];
+describe("Detect Command", () => {
+	let program: Command;
+	const originalConsoleLog = console.log;
+	const originalConsoleError = console.error;
+	let logs: string[];
+	let errors: string[];
 
-  beforeEach(() => {
-    program = new Command();
-    registerDetectCommand(program);
-    logs = [];
-    errors = [];
-    console.log = (...args: any[]) => {
-      logs.push(args.join(' '));
-    };
-    console.error = (...args: any[]) => {
-      errors.push(args.join(' '));
-    };
-  });
+	beforeEach(() => {
+		program = new Command();
+		registerDetectCommand(program);
+		logs = [];
+		errors = [];
+		console.log = (...args: unknown[]) => {
+			logs.push(args.join(" "));
+		};
+		console.error = (...args: unknown[]) => {
+			errors.push(args.join(" "));
+		};
+	});
 
-  afterEach(() => {
-    console.log = originalConsoleLog;
-    console.error = originalConsoleError;
-  });
+	afterEach(() => {
+		console.log = originalConsoleLog;
+		console.error = originalConsoleError;
+	});
 
-  it('should register the detect command', () => {
-    const detectCmd = program.commands.find(cmd => cmd.name() === 'detect');
-    expect(detectCmd).toBeDefined();
-    expect(detectCmd?.description()).toBe('Show what gates would run for detected changes (without executing them)');
-    expect(detectCmd?.options.some(opt => opt.long === '--commit')).toBe(true);
-    expect(detectCmd?.options.some(opt => opt.long === '--uncommitted')).toBe(true);
-  });
+	it("should register the detect command", () => {
+		const detectCmd = program.commands.find((cmd) => cmd.name() === "detect");
+		expect(detectCmd).toBeDefined();
+		expect(detectCmd?.description()).toBe(
+			"Show what gates would run for detected changes (without executing them)",
+		);
+		expect(detectCmd?.options.some((opt) => opt.long === "--commit")).toBe(
+			true,
+		);
+		expect(detectCmd?.options.some((opt) => opt.long === "--uncommitted")).toBe(
+			true,
+		);
+	});
 });

package/src/commands/detect.ts

@@ -1,69 +1,82 @@
-import type { Command } from 'commander';
-import chalk from 'chalk';
-import { loadConfig } from '../config/loader.js';
-import { ChangeDetector } from '../core/change-detector.js';
-import { EntryPointExpander } from '../core/entry-point.js';
-import { JobGenerator, type Job } from '../core/job.js';
+import chalk from "chalk";
+import type { Command } from "commander";
+import { loadConfig } from "../config/loader.js";
+import { ChangeDetector } from "../core/change-detector.js";
+import { EntryPointExpander } from "../core/entry-point.js";
+import { type Job, JobGenerator } from "../core/job.js";
 
 export function registerDetectCommand(program: Command): void {
-  program
-    .command('detect')
-    .description('Show what gates would run for detected changes (without executing them)')
-    .option('-c, --commit <sha>', 'Use diff for a specific commit')
-    .option('-u, --uncommitted', 'Use diff for current uncommitted changes (staged and unstaged)')
-    .action(async (options) => {
-      try {
-        const config = await loadConfig();
-        const changeDetector = new ChangeDetector(config.project.base_branch, {
-          commit: options.commit,
-          uncommitted: options.uncommitted
-        });
-        const expander = new EntryPointExpander();
-        const jobGen = new JobGenerator(config);
-        
-        console.log(chalk.dim('Detecting changes...'));
-        const changes = await changeDetector.getChangedFiles();
-        
-        if (changes.length === 0) {
-          console.log(chalk.green('No changes detected.'));
-          return;
-        }
-        
-        console.log(chalk.dim(`Found ${changes.length} changed files:`));
-        changes.forEach(file => console.log(chalk.dim(`  - ${file}`)));
-        console.log();
+	program
+		.command("detect")
+		.description(
+			"Show what gates would run for detected changes (without executing them)",
+		)
+		.option("-c, --commit <sha>", "Use diff for a specific commit")
+		.option(
+			"-u, --uncommitted",
+			"Use diff for current uncommitted changes (staged and unstaged)",
+		)
+		.action(async (options) => {
+			try {
+				const config = await loadConfig();
+				const changeDetector = new ChangeDetector(config.project.base_branch, {
+					commit: options.commit,
+					uncommitted: options.uncommitted,
+				});
+				const expander = new EntryPointExpander();
+				const jobGen = new JobGenerator(config);
 
-        const entryPoints = await expander.expand(config.project.entry_points, changes);
-        const jobs = jobGen.generateJobs(entryPoints);
+				console.log(chalk.dim("Detecting changes..."));
+				const changes = await changeDetector.getChangedFiles();
 
-        if (jobs.length === 0) {
-          console.log(chalk.yellow('No applicable gates for these changes.'));
-          return;
-        }
+				if (changes.length === 0) {
+					console.log(chalk.green("No changes detected."));
+					return;
+				}
 
-        console.log(chalk.bold(`Would run ${jobs.length} gate(s):\n`));
-        
-        // Group jobs by entry point for better display
-        const jobsByEntryPoint = new Map<string, Job[]>();
-        for (const job of jobs) {
-          if (!jobsByEntryPoint.has(job.entryPoint)) {
-            jobsByEntryPoint.set(job.entryPoint, []);
-          }
-          jobsByEntryPoint.get(job.entryPoint)!.push(job);
-        }
+				console.log(chalk.dim(`Found ${changes.length} changed files:`));
+				changes.forEach((file) => {
+					console.log(chalk.dim(`  - ${file}`));
+				});
+				console.log();
 
-        for (const [entryPoint, entryJobs] of jobsByEntryPoint.entries()) {
-          console.log(chalk.cyan(`Entry point: ${entryPoint}`));
-          for (const job of entryJobs) {
-            const typeLabel = job.type === 'check' ? chalk.yellow('check') : chalk.blue('review');
-            console.log(`  ${typeLabel} ${chalk.bold(job.name)}`);
-          }
-          console.log();
-        }
+				const entryPoints = await expander.expand(
+					config.project.entry_points,
+					changes,
+				);
+				const jobs = jobGen.generateJobs(entryPoints);
 
-      } catch (error: any) {
-        console.error(chalk.red('Error:'), error.message);
-        process.exit(1);
-      }
-    });
+				if (jobs.length === 0) {
+					console.log(chalk.yellow("No applicable gates for these changes."));
+					return;
+				}
+
+				console.log(chalk.bold(`Would run ${jobs.length} gate(s):\n`));
+
+				// Group jobs by entry point for better display
+				const jobsByEntryPoint = new Map<string, Job[]>();
+				for (const job of jobs) {
+					if (!jobsByEntryPoint.has(job.entryPoint)) {
+						jobsByEntryPoint.set(job.entryPoint, []);
+					}
+					jobsByEntryPoint.get(job.entryPoint)?.push(job);
+				}
+
+				for (const [entryPoint, entryJobs] of jobsByEntryPoint.entries()) {
+					console.log(chalk.cyan(`Entry point: ${entryPoint}`));
+					for (const job of entryJobs) {
+						const typeLabel =
+							job.type === "check"
+								? chalk.yellow("check")
+								: chalk.blue("review");
+						console.log(`  ${typeLabel} ${chalk.bold(job.name)}`);
+					}
+					console.log();
+				}
+			} catch (error: unknown) {
+				const err = error as { message?: string };
+				console.error(chalk.red("Error:"), err.message);
+				process.exit(1);
+			}
+		});
 }