agent-gauntlet 0.10.0 → 0.11.0

package/src/commands/detect.ts

@@ -1,173 +0,0 @@
-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";
-import {
-	readExecutionState,
-	resolveFixBase,
-} from "../utils/execution-state.js";
-import {
-	hasExistingLogs,
-	performAutoClean,
-	shouldAutoClean,
-} from "./shared.js";
-
-interface ChangeOptions {
-	commit?: string;
-	uncommitted?: boolean;
-	fixBase?: string;
-}
-
-async function autoCleanIfNeeded(
-	logDir: string,
-	baseBranch: string,
-): Promise<void> {
-	const result = await shouldAutoClean(logDir, baseBranch);
-	if (result.clean) {
-		await performAutoClean(logDir, result);
-	}
-}
-
-async function resolveFreshFixBase(
-	logDir: string,
-	baseBranch: string,
-): Promise<string | undefined> {
-	const state = await readExecutionState(logDir);
-	if (!state) return undefined;
-	return (await resolveFixBase(state, baseBranch)).fixBase ?? undefined;
-}
-
-/**
- * Resolve change detection options using the same logic as run-executor.
- * Handles rerun mode (existing logs → uncommitted-only diff) and fixBase resolution.
- */
-async function resolveChangeOptions(
-	logDir: string,
-	baseBranch: string,
-	cliOptions: { commit?: string; uncommitted?: boolean },
-): Promise<ChangeOptions> {
-	await autoCleanIfNeeded(logDir, baseBranch);
-
-	const logsExist = await hasExistingLogs(logDir);
-	const isRerun = logsExist && !cliOptions.commit;
-
-	const opts: ChangeOptions = {};
-	if (isRerun) {
-		const state = await readExecutionState(logDir);
-		opts.uncommitted = true;
-		opts.fixBase = state?.working_tree_ref;
-	} else if (!logsExist) {
-		const fixBase = await resolveFreshFixBase(logDir, baseBranch);
-		if (fixBase) opts.fixBase = fixBase;
-	}
-
-	if (cliOptions.commit || cliOptions.uncommitted) {
-		return {
-			commit: cliOptions.commit,
-			uncommitted: cliOptions.uncommitted,
-			fixBase: opts.fixBase,
-		};
-	}
-	return opts;
-}
-
-export function registerDetectCommand(program: Command): void {
-	program
-		.command("detect")
-		.description(
-			"Show what gates would run for detected changes (without executing them)",
-		)
-		.option(
-			"-b, --base-branch <branch>",
-			"Override base branch for change detection",
-		)
-		.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();
-
-				// Priority: CLI override > CI env var > config
-				const effectiveBaseBranch =
-					options.baseBranch ||
-					(process.env.GITHUB_BASE_REF &&
-					(process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true")
-						? process.env.GITHUB_BASE_REF
-						: null) ||
-					config.project.base_branch;
-
-				const changeOptions = await resolveChangeOptions(
-					config.project.log_dir,
-					effectiveBaseBranch,
-					{ commit: options.commit, uncommitted: options.uncommitted },
-				);
-
-				const changeDetector = new ChangeDetector(
-					effectiveBaseBranch,
-					changeOptions,
-				);
-				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:`));
-				for (const file of changes) {
-					console.log(chalk.dim(`  - ${file}`));
-				}
-				console.log();
-
-				const entryPoints = await expander.expand(
-					config.project.entry_points,
-					changes,
-				);
-				const jobs = jobGen.generateJobs(entryPoints);
-
-				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`));
-				printJobsByWorkDir(jobs);
-			} catch (error: unknown) {
-				const err = error as { message?: string };
-				console.error(chalk.red("Error:"), err.message);
-				process.exit(1);
-			}
-		});
-}
-
-function groupByWorkDir(jobs: Job[]): Map<string, Job[]> {
-	const map = new Map<string, Job[]>();
-	for (const job of jobs) {
-		if (!map.has(job.workingDirectory)) {
-			map.set(job.workingDirectory, []);
-		}
-		map.get(job.workingDirectory)?.push(job);
-	}
-	return map;
-}
-
-function printJobsByWorkDir(jobs: Job[]): void {
-	for (const [workDir, wdJobs] of groupByWorkDir(jobs).entries()) {
-		console.log(chalk.cyan(`Working directory: ${workDir}`));
-		for (const job of wdJobs) {
-			const typeLabel =
-				job.type === "check" ? chalk.yellow("check") : chalk.blue("review");
-			console.log(`  ${typeLabel} ${chalk.bold(job.name)}`);
-		}
-		console.log();
-	}
-}

package/src/commands/health.ts

@@ -1,169 +0,0 @@
-import path from "node:path";
-import chalk from "chalk";
-import type { Command } from "commander";
-import { getAdapter, getAllAdapters } from "../cli-adapters/index.js";
-import { loadConfig } from "../config/loader.js";
-import { validateConfig } from "../config/validator.js";
-
-export function registerHealthCommand(program: Command): void {
-	program
-		.command("health")
-		.description("Check CLI tool availability")
-		.action(async () => {
-			// 1. Config validation
-			console.log(chalk.bold("Config validation:"));
-			const validationResult = await validateConfig();
-
-			if (validationResult.filesChecked.length === 0) {
-				console.log(chalk.yellow("  No config files found"));
-			} else {
-				// List all files checked
-				for (const file of validationResult.filesChecked) {
-					const relativePath = path.relative(process.cwd(), file);
-					console.log(chalk.dim(`  ${relativePath}`));
-				}
-
-				// Show validation results
-				if (validationResult.valid && validationResult.issues.length === 0) {
-					console.log(chalk.green("  ✓ All config files are valid"));
-				} else {
-					// Group issues by file
-					const issuesByFile = new Map<
-						string,
-						typeof validationResult.issues
-					>();
-					for (const issue of validationResult.issues) {
-						const relativeFile = path.relative(process.cwd(), issue.file);
-						if (!issuesByFile.has(relativeFile)) {
-							issuesByFile.set(relativeFile, []);
-						}
-						issuesByFile.get(relativeFile)?.push(issue);
-					}
-
-					// Display issues
-					for (const [file, issues] of issuesByFile.entries()) {
-						for (const issue of issues) {
-							const icon =
-								issue.severity === "error" ? chalk.red("✗") : chalk.yellow("⚠");
-							const fieldInfo = issue.field
-								? chalk.dim(` (${issue.field})`)
-								: "";
-							console.log(`  ${icon} ${file}${fieldInfo}`);
-							console.log(`    ${issue.message}`);
-						}
-					}
-				}
-			}
-
-			console.log();
-
-			// 2. CLI Tool Health Check
-			console.log(chalk.bold("CLI Tool Health Check:"));
-
-			try {
-				const config = await loadConfig();
-
-				// Check for reviews configuration
-				const reviewEntries = Object.entries(config.reviews);
-
-				if (reviewEntries.length === 0) {
-					console.log(chalk.yellow("  No CLI tools configured"));
-					console.log(
-						chalk.dim(
-							"  No review gates found. Add review gates with cli_preference to check tool availability.",
-						),
-					);
-					return;
-				}
-
-				// Collect all unique agent names from review gate cli_preference settings
-				const preferredAgents = new Set<string>();
-				const reviewsWithEmptyPreference: string[] = [];
-
-				reviewEntries.forEach(([reviewName, review]) => {
-					if (!review.cli_preference || review.cli_preference.length === 0) {
-						reviewsWithEmptyPreference.push(reviewName);
-					} else {
-						review.cli_preference.forEach((agent) => {
-							preferredAgents.add(agent);
-						});
-					}
-				});
-
-				// Report Empty Preferences (Loader should handle this via default merging, but good to check)
-				if (reviewsWithEmptyPreference.length > 0) {
-					console.log(chalk.yellow("  ⚠️  Misconfiguration detected:"));
-					reviewsWithEmptyPreference.forEach((name) => {
-						console.log(
-							chalk.yellow(
-								`     Review gate "${name}" has empty cli_preference`,
-							),
-						);
-					});
-					console.log();
-				}
-
-				// If no agents are configured, show message
-				if (preferredAgents.size === 0) {
-					console.log(chalk.yellow("  No CLI tools configured"));
-					console.log(
-						chalk.dim(
-							"  All review gates have empty cli_preference. Add tools to cli_preference to check availability.",
-						),
-					);
-					return;
-				}
-
-				// Check the configured agents
-				for (const agentName of Array.from(preferredAgents).sort()) {
-					const adapter = getAdapter(agentName);
-					if (adapter) {
-						const health = await adapter.checkHealth();
-						let statusStr = "";
-
-						switch (health.status) {
-							case "healthy":
-								statusStr = chalk.green("Installed");
-								break;
-							case "missing":
-								statusStr = chalk.red("Missing");
-								break;
-							case "unhealthy":
-								statusStr = chalk.red(`${health.message || "Unhealthy"}`);
-								break;
-						}
-
-						console.log(`  ${adapter.name.padEnd(10)} : ${statusStr}`);
-					} else {
-						console.log(
-							`  ${agentName.padEnd(10)} : ${chalk.yellow("Unknown")}`,
-						);
-					}
-				}
-			} catch (_error: unknown) {
-				// If config can't be loaded, fall back to checking all adapters
-				const adapters = getAllAdapters();
-				console.log(
-					chalk.dim("  (Config not found, checking all supported agents)"),
-				);
-
-				for (const adapter of adapters) {
-					const health = await adapter.checkHealth();
-					let statusStr = "";
-
-					switch (health.status) {
-						case "healthy":
-							statusStr = chalk.green("Installed");
-							break;
-						case "missing":
-							statusStr = chalk.red("Missing");
-							break;
-						case "unhealthy":
-							statusStr = chalk.red(`${health.message || "Unhealthy"}`);
-							break;
-					}
-					console.log(`  ${adapter.name.padEnd(10)} : ${statusStr}`);
-				}
-			}
-		});
-}

package/src/commands/help.ts

@@ -1,34 +0,0 @@
-import chalk from "chalk";
-import type { Command } from "commander";
-
-export function registerHelpCommand(program: Command): void {
-	program
-		.command("help")
-		.description("Show help information")
-		.action(() => {
-			console.log(chalk.bold("Agent Gauntlet - AI-assisted quality gates\n"));
-			console.log(
-				"Agent Gauntlet runs quality gates (checks + AI reviews) for only the parts",
-			);
-			console.log(
-				"of your repo that changed, based on a configurable set of entry points.\n",
-			);
-			console.log(chalk.bold("Commands:\n"));
-			console.log("  run      Run gates for detected changes");
-			console.log("  check    Run only applicable checks");
-			console.log("  review   Run only applicable reviews");
-			console.log("  clean    Archive logs (move current logs into previous/)");
-			console.log(
-				"  detect   Show what gates would run (without executing them)",
-			);
-			console.log("  list     List configured gates");
-			console.log("  health   Check CLI tool availability");
-			console.log("  init     Initialize .gauntlet configuration");
-			console.log("  ci       CI integration commands (init, list-jobs)");
-			console.log("  help     Show this help message\n");
-			console.log(
-				"For more information, see: https://github.com/your-repo/agent-gauntlet",
-			);
-			console.log("Or run: agent-gauntlet <command> --help");
-		});
-}

package/src/commands/index.ts

@@ -1,13 +0,0 @@
-export { registerCheckCommand } from "./check.js";
-export { registerCICommand } from "./ci/index.js";
-export { registerCleanCommand } from "./clean.js";
-export { registerDetectCommand } from "./detect.js";
-export { registerHealthCommand } from "./health.js";
-export { registerHelpCommand } from "./help.js";
-export { registerInitCommand } from "./init.js";
-export { registerListCommand } from "./list.js";
-export { registerReviewCommand } from "./review.js";
-export { registerRunCommand } from "./run.js";
-export { registerStopHookCommand } from "./stop-hook.js";
-export { registerValidateCommand } from "./validate.js";
-export { registerWaitCICommand } from "./wait-ci.js";