@kyubiware/commit-mint 0.5.6 → 0.6.1

package/dist/cli.mjs

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import { cli, command } from "cleye";
-import * as p from "@clack/prompts";
-import { intro, isCancel, log, outro, spinner } from "@clack/prompts";
-import { bold, cyan, dim, green, red, yellow } from "kolorist";
-import { access, constants, mkdir, readFile, writeFile } from "node:fs/promises";
+import Groq from "groq-sdk";
+import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import { extname, join } from "node:path";
-import ini from "ini";
-import Groq from "groq-sdk";
+import { bold, cyan, dim, green, red, yellow } from "kolorist";
+import { access, constants, mkdir, readFile, writeFile } from "node:fs/promises";
 import { execa } from "execa";
-import { createHash } from "node:crypto";
-import { readFileSync } from "node:fs";
 import picomatch from "picomatch";
+import ini from "ini";
+import { createHash } from "node:crypto";
+import * as p from "@clack/prompts";
+import { intro, isCancel, log, outro, spinner } from "@clack/prompts";
 import { spawn } from "node:child_process";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
@@ -28,7 +28,7 @@ var __exportAll = (all, no_symbols) => {
 //#region package.json
 var package_default = {
 	name: "@kyubiware/commit-mint",
-	version: "0.5.6",
+	version: "0.6.1",
 	description: "🌿 A commit tool that actually handles hook failures",
 	type: "module",
 	bin: { "cmint": "./dist/cli.mjs" },
@@ -47,7 +47,8 @@ var package_default = {
 		"release:patch": "bash scripts/release.sh patch",
 		"release:minor": "bash scripts/release.sh minor",
 		"release:major": "bash scripts/release.sh major",
-		"prepublishOnly": "npm run build"
+		"prepublishOnly": "npm run build",
+		"publish:cmint": "cd packages/cmint && npm publish"
 	},
 	keywords: [
 		"git",
@@ -88,13 +89,30 @@ var package_default = {
 //#endregion
 //#region src/utils/debug.ts
 let enabled = false;
+let dirEnsured = false;
+let sessionWritten = false;
+let logFile = join(os.homedir(), ".cache", "commit-mint", "debug.log");
+const LOG_DIR = join(os.homedir(), ".cache", "commit-mint");
+function ensureLogDir() {
+	if (dirEnsured) return;
+	mkdirSync(LOG_DIR, { recursive: true });
+	dirEnsured = true;
+}
 function setDebug(value) {
 	enabled = value;
 }
+function writeSessionHeader() {
+	if (sessionWritten) return;
+	ensureLogDir();
+	writeFileSync(logFile, `--- session ${(/* @__PURE__ */ new Date()).toISOString()} ---\n`, "utf8");
+	sessionWritten = true;
+}
 function debug(...args) {
+	const prefix = `[debug ${(/* @__PURE__ */ new Date()).toISOString().slice(11, 23)}]`;
+	ensureLogDir();
+	appendFileSync(logFile, `${prefix} ${args.map(String).join(" ")}\n`, "utf8");
 	if (!enabled) return;
-	const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(11, 23);
-	console.error(dim(`[debug ${timestamp}]`), ...args);
+	console.error(dim(prefix), ...args);
 }
 //#endregion
 //#region src/services/provider.ts
@@ -174,69 +192,178 @@ function createProvider(options) {
 	};
 }
 //#endregion
-//#region src/services/config.ts
-const CONFIG_PATH = join(os.homedir(), ".commit-mint");
-const defaults = {
-	provider: "groq",
-	model: "openai/gpt-oss-20b",
-	locale: "en",
-	"max-length": "100",
-	type: "",
-	timeout: "10000"
-};
-async function readConfig() {
-	debug("readConfig: loading from %s", CONFIG_PATH);
-	try {
-		const raw = await readFile(CONFIG_PATH, "utf8");
-		const parsed = ini.parse(raw);
-		const merged = {
-			...defaults,
-			...parsed
-		};
-		debug("readConfig: loaded keys: %s", Object.keys(merged).join(", "));
-		return merged;
-	} catch {
-		debug("readConfig: no config file, using defaults");
-		return { ...defaults };
+//#region src/services/ai.ts
+const MAX_DIFF_CHARS = 2e4;
+function mapGroqError(error, providerLabel) {
+	const label = providerLabel ?? "Groq";
+	if (error instanceof Groq.AuthenticationError) return /* @__PURE__ */ new Error(`Invalid API key for ${label}. Run: cmint config set ${label.toUpperCase()}_API_KEY=<key>`);
+	if (error instanceof Groq.RateLimitError) return /* @__PURE__ */ new Error(`Rate limited by ${label}. Please wait and try again.`);
+	if (error instanceof Groq.APIConnectionTimeoutError) return /* @__PURE__ */ new Error("Request timed out. Check your network or try a smaller diff.");
+	if (error instanceof Groq.APIError) return /* @__PURE__ */ new Error(`${label} API error: ${error.message}`);
+	if (error instanceof Error && /^4\d{2}\s/.test(error.message)) return /* @__PURE__ */ new Error(`${label} API error: ${error.message}`);
+	return /* @__PURE__ */ new Error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+}
+const CONVENTIONAL_COMMIT_REGEX = /^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.+\))?!?: .+$/;
+function stripThinkTags(text) {
+	return text.replace(/<think[\s\S]*?<\/think>/gi, "").trim();
+}
+function deriveMessageFromReasoning(reasoning) {
+	const match = reasoning.match(/(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.+\))?!?: .+/i);
+	if (match) return match[0].trim();
+	const first = reasoning.split(/[.!?]/).find((s) => s.trim().length >= 10);
+	return first ? first.trim() : null;
+}
+function stripContextLines(diff) {
+	return diff.split("\n").filter((line) => !line.startsWith(" ")).join("\n");
+}
+function compressDiff(diff) {
+	if (diff.length <= MAX_DIFF_CHARS) return diff;
+	let result = stripContextLines(diff);
+	if (result.length <= MAX_DIFF_CHARS) return result;
+	result = result.split(/(?=diff --git)/).filter(Boolean).map((fd) => {
+		return fd.split(/(?=\n@@)/).map((part, idx) => {
+			if (idx === 0) return part;
+			const lines = part.split("\n");
+			return [lines[0], ...lines.slice(1).filter((l) => l.startsWith("+") || l.startsWith("-")).slice(0, 10)].join("\n");
+		}).join("");
+	}).join("");
+	if (result.length <= MAX_DIFF_CHARS) return result;
+	return `Summary of changes:\n${(diff.match(/^diff --git a\/(.+) b\/(.+)$/gm) || []).map((f) => {
+		const match = f.match(/^diff --git a\/(.+) b\/(.+)$/);
+		return match && match[1] === match[2] ? `${match[1]} | changed` : "";
+	}).filter(Boolean).join("\n")}`;
+}
+function buildStatSummary(diff) {
+	const files = [];
+	let currentFile = "";
+	let adds = 0;
+	let dels = 0;
+	for (const line of diff.split("\n")) {
+		const match = line.match(/^diff --git a\/.+ b\/(.+)$/);
+		if (match) {
+			if (currentFile) files.push({
+				name: currentFile,
+				adds,
+				dels
+			});
+			currentFile = match[1];
+			adds = 0;
+			dels = 0;
+		} else if (line.startsWith("+") && !line.startsWith("+++")) adds++;
+		else if (line.startsWith("-") && !line.startsWith("---")) dels++;
 	}
+	if (currentFile) files.push({
+		name: currentFile,
+		adds,
+		dels
+	});
+	const totalAdds = files.reduce((s, f) => s + f.adds, 0);
+	const totalDels = files.reduce((s, f) => s + f.dels, 0);
+	const lines = files.map((f) => ` ${f.name}  | +${f.adds} -${f.dels}`);
+	lines.push(` ${files.length} files changed, ${totalAdds} insertions(+), ${totalDels} deletions(-)`);
+	return lines.join("\n");
 }
-async function writeConfig(updates) {
-	const existing = await readConfig();
-	Object.assign(existing, updates);
-	await writeFile(CONFIG_PATH, ini.stringify(existing), "utf8");
+function buildSystemPrompt(type) {
+	let prompt = "You are a commit message generator. Follow the Conventional Commits specification.\nValid types: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test.\nFormat: type(scope): description\nUse imperative mood, lowercase, no trailing period.\nOutput ONLY the commit message, no markdown fences, no explanation.";
+	if (type && type.trim().length > 0) prompt += `\nYou MUST use type: ${type}`;
+	return prompt;
 }
-async function setConfigValue(key, value) {
-	await writeConfig({ [key]: value });
+function buildUserPrompt(diff, hint, statSummary) {
+	const parts = [];
+	if (hint) parts.push(`Context: ${hint}`);
+	if (statSummary) parts.push(`Change summary:\n${statSummary}`);
+	parts.push(`Generate a conventional commit for:\n\n${diff}`);
+	return parts.join("\n\n");
 }
-async function getProviderApiKey(provider) {
-	const envVar = PROVIDER_ENV_KEYS[provider];
-	if (envVar) {
-		const envValue = process.env[envVar];
-		if (envValue) {
-			debug("getProviderApiKey(%s): found in env", provider);
-			return envValue;
+function isValidConventionalCommit(message) {
+	return CONVENTIONAL_COMMIT_REGEX.test(message);
+}
+function extractContentText(content) {
+	if (content == null) return "";
+	if (typeof content === "string") return content.trim();
+	if (Array.isArray(content)) return content.filter((part) => part.type === "text" && typeof part.text === "string").map((part) => stripThinkTags(part.text)).join("").trim();
+	return "";
+}
+async function generateCommitMessage(diff, options) {
+	const timeoutMs = options.timeout ?? 6e4;
+	debug("Timeout: %d ms", timeoutMs);
+	const { client, model } = createProvider({
+		provider: options.provider ?? "groq",
+		apiKey: options.apiKey,
+		modelOverride: options.model,
+		timeout: timeoutMs,
+		baseURLOverride: options.proxy
+	});
+	debug("generateCommitMessage: model=%s, type=%s, hint=%s", model, options.type ?? "none", options.hint ?? "none");
+	const compressedDiff = compressDiff(diff);
+	const statSummary = buildStatSummary(diff);
+	const systemPrompt = buildSystemPrompt(options.type);
+	const userPrompt = buildUserPrompt(compressedDiff, options.hint, statSummary);
+	debug("Diff: %d chars → compressed to %d chars", diff.length, compressedDiff.length);
+	debug("Stat summary:\n%s", statSummary);
+	debug("User prompt length: %d chars", userPrompt.length);
+	async function callAI(strictSystemPrompt) {
+		const callStart = Date.now();
+		debug("callAI: %s — model=%s, promptLen=%d, systemLen=%d", !!strictSystemPrompt ? "RETRY (strict)" : "INITIAL", model, userPrompt.length, (strictSystemPrompt ?? systemPrompt).length);
+		try {
+			const isReasoningModel = /^(o[1-9]|.*gpt-oss.*|.*gpt-5.*)/i.test(model);
+			const isGroq = (options.provider ?? "groq") === "groq";
+			const completion = await client.chat.completions.create({
+				messages: [{
+					role: "system",
+					content: strictSystemPrompt ?? systemPrompt
+				}, {
+					role: "user",
+					content: userPrompt
+				}],
+				model,
+				temperature: .3,
+				...isReasoningModel ? { max_completion_tokens: 1024 } : { max_tokens: 1024 },
+				...isGroq && isReasoningModel ? { reasoning_format: "parsed" } : {}
+			});
+			const elapsed = Date.now() - callStart;
+			const rawContent = completion.choices[0]?.message?.content;
+			const content = extractContentText(typeof rawContent === "string" ? stripThinkTags(rawContent) : rawContent);
+			debug("callAI response (%d ms): choices=%d, finishReason=%s, contentLen=%d, rawType=%s", elapsed, completion.choices.length, completion.choices[0]?.finish_reason ?? "(none)", content.length, typeof rawContent);
+			debug("callAI raw content: %s", content.slice(0, 300) || "(empty)");
+			if (!content) {
+				const reasoning = completion.choices[0]?.message?.reasoning;
+				debug("callAI: content empty, attempting reasoning fallback (reasoningLen=%d)", reasoning?.length ?? 0);
+				if (reasoning) {
+					const derived = deriveMessageFromReasoning(reasoning);
+					if (derived) {
+						debug("callAI: derived message from reasoning: %s", derived.slice(0, 100));
+						return stripThinkTags(derived);
+					}
+					debug("callAI: could not derive message from reasoning");
+				}
+				throw new Error("AI returned an empty commit message");
+			}
+			return content;
+		} catch (error) {
+			debug("callAI FAILED after %d ms: %s", Date.now() - callStart, error instanceof Error ? `${error.name}: ${error.message}` : String(error));
+			throw error;
 		}
 	}
-	const config = await readConfig();
-	const configKey = PROVIDER_ENV_KEYS[provider];
-	if (configKey && config[configKey]) {
-		debug("getProviderApiKey(%s): found in config", provider);
-		return config[configKey];
+	try {
+		const totalStart = Date.now();
+		let message = await callAI();
+		debug("Validation: message=%s, isValid=%s", message.slice(0, 100), isValidConventionalCommit(message));
+		if (!isValidConventionalCommit(message)) {
+			debug("Initial message failed conventional commit validation, retrying with strict prompt (elapsed: %d ms)", Date.now() - totalStart);
+			const retryMessage = await callAI("You MUST output ONLY a valid conventional commit message. Format: type(scope): description. If you output anything else your response will be rejected.\nValid types: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test.");
+			debug("Retry validation: message=%s, isValid=%s", retryMessage.slice(0, 100), isValidConventionalCommit(retryMessage));
+			if (isValidConventionalCommit(retryMessage)) {
+				debug("Retry produced valid conventional commit");
+				message = retryMessage;
+			} else debug("Retry also failed validation, using original message");
+		}
+		debug("Final message (%d ms total): %s", Date.now() - totalStart, message);
+		return message;
+	} catch (error) {
+		debug("AI error: %s", error instanceof Error ? error.message : String(error));
+		throw mapGroqError(error, options.provider ? formatProviderName(options.provider) : void 0);
 	}
-	debug("getProviderApiKey(%s): not found", provider);
-	throw new Error(`Please set your ${formatProviderName(provider)} API key via \`cmint config set ${envVar}=<your token>\``);
-}
-/** Check if a model name is the default for a provider OTHER than the given one. */
-function isOtherProviderDefault(model, provider) {
-	for (const [name, config] of Object.entries(PROVIDER_CONFIGS)) if (name !== provider && config.defaultModel === model) return true;
-	return false;
-}
-function getModelForProvider(config, provider, defaultModel) {
-	const providerModel = config[`model_${provider}`];
-	if (providerModel) return providerModel;
-	const globalModel = config.model;
-	if (globalModel && !isOtherProviderDefault(globalModel, provider)) return globalModel;
-	return defaultModel;
 }
 //#endregion
 //#region src/services/hooks.ts
@@ -472,651 +599,466 @@ function findMeaningfulCommand(command) {
 	return segments[segments.length - 1] || command;
 }
 //#endregion
-//#region src/services/hook-progress.ts
-const ansiRe = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
-function createStderrParser() {
-	let buffer = "";
-	return (chunk) => {
-		buffer += chunk;
-		const steps = [];
-		const lines = buffer.split("\n");
-		buffer = lines.pop() ?? "";
-		for (const line of lines) {
-			const match = line.replace(ansiRe, "").match(/\[(STARTED|COMPLETED|FAILED)\]\s+(.+)/);
-			if (!match) continue;
-			const status = match[1].toLowerCase();
-			const command = match[2].trim();
-			if (isLintStagedMeta(command)) continue;
-			const tool = extractToolName(command) ?? command;
-			steps.push({
-				status,
-				command,
-				tool
-			});
-		}
-		return steps;
-	};
-}
-function createProgressHandler(s) {
-	return (step) => {
-		if (step.status === "started") s.message(step.command);
-		else if (step.status === "failed") s.message(step.command);
-	};
-}
-//#endregion
-//#region src/services/git.ts
-var git_exports = /* @__PURE__ */ __exportAll({
-	KnownError: () => KnownError,
-	assertGitRepo: () => assertGitRepo,
-	attemptCommit: () => attemptCommit,
-	attemptCommitNoVerify: () => attemptCommitNoVerify,
-	getChangedFiles: () => getChangedFiles,
-	getDefaultExcludes: () => getDefaultExcludes,
-	getHead: () => getHead,
-	getRepoRoot: () => getRepoRoot,
-	getStagedDiff: () => getStagedDiff,
-	getStatusShort: () => getStatusShort,
-	resetStaging: () => resetStaging,
-	stageAll: () => stageAll,
-	stageFiles: () => stageFiles
-});
-var KnownError = class extends Error {};
-async function assertGitRepo() {
-	debug("assertGitRepo");
-	const { failed } = await execa("git", ["rev-parse", "--show-toplevel"], { reject: false });
-	if (failed) throw new KnownError("The current directory must be a Git repository!");
-}
-async function getRepoRoot() {
-	const { stdout } = await execa("git", ["rev-parse", "--show-toplevel"]);
-	debug("getRepoRoot:", stdout.trim());
-	return stdout.trim();
-}
-const DEFAULT_EXCLUDES = [
-	"package-lock.json",
-	"node_modules/**",
-	"dist/**",
-	"build/**",
-	".next/**",
-	"coverage/**",
-	"*.log",
-	"*.min.js",
-	"*.min.css",
-	"*.lock",
-	".DS_Store"
+//#region src/services/checks.ts
+/** Config file names, checked in priority order (matches lint-staged naming conventions) */
+const CONFIG_FILES = [
+	".cmintrc",
+	".cmintrc.json",
+	".cmintrc.mjs",
+	".cmintrc.mts",
+	".cmintrc.js",
+	".cmintrc.ts",
+	".cmintrc.cjs",
+	".cmintrc.cts",
+	"cmint.config.mjs",
+	"cmint.config.mts",
+	"cmint.config.js",
+	"cmint.config.ts",
+	"cmint.config.cjs",
+	"cmint.config.cts"
 ];
-function getDefaultExcludes() {
-	return [...DEFAULT_EXCLUDES];
-}
-async function getStagedDiff(exclude) {
-	const excludeArgs = (exclude ?? []).map((e) => `:(exclude)${e}`);
-	const defaultExcludeArgs = DEFAULT_EXCLUDES.map((e) => `:(exclude)${e}`);
-	const { stdout: allFiles } = await execa("git", [
-		"diff",
-		"--cached",
-		"--name-only"
-	]);
-	if (!allFiles) {
-		debug("getStagedDiff: no staged files");
-		return null;
-	}
-	const { stdout: files } = await execa("git", [
-		"diff",
-		"--cached",
-		"--name-only",
-		...defaultExcludeArgs,
-		...excludeArgs
-	]);
-	if (!files) {
-		const excludedFiles = allFiles.split("\n").filter(Boolean);
-		debug("getStagedDiff: all files excluded:", excludedFiles);
-		return { excludedFiles };
-	}
-	const { stdout: diff } = await execa("git", [
-		"diff",
-		"--cached",
-		"--diff-algorithm=minimal",
-		...defaultExcludeArgs,
-		...excludeArgs
-	]);
-	debug("getStagedDiff:", files.split("\n").filter(Boolean).length, "files,", diff.length, "chars");
-	return {
-		files: files.split("\n").filter(Boolean),
-		diff
-	};
-}
-async function stageAll() {
-	debug("stageAll: git add -A");
-	await execa("git", ["add", "-A"]);
-}
-async function resetStaging() {
-	debug("resetStaging: git reset HEAD");
-	await execa("git", ["reset", "HEAD"]);
-}
-async function getHead() {
-	const { stdout } = await execa("git", ["rev-parse", "HEAD"]);
-	return stdout.trim();
-}
-async function getStatusShort() {
-	const { stdout } = await execa("git", ["status", "--short"]);
-	return stdout.trim();
-}
-async function getChangedFiles() {
-	const { stdout } = await execa("git", ["status", "--short"]);
-	if (!stdout.trim()) return [];
-	const files = stdout.split("\n").filter(Boolean).map((line) => {
-		const indexStatus = line[0];
-		return {
-			status: line.slice(0, 2).trim(),
-			path: line.slice(3),
-			staged: indexStatus !== " " && indexStatus !== "?"
-		};
-	});
-	debug("getChangedFiles:", files.length, "files");
-	return files;
+/**
+* Detect whether the repo has a cmint config file.
+* Returns the config file path, or null if none found.
+*/
+async function detectConfig(repoRoot) {
+	debug("detectConfig: checking for config in %s", repoRoot);
+	for (const name of CONFIG_FILES) try {
+		await access(join(repoRoot, name), constants.R_OK);
+		debug("detectConfig: found %s", name);
+		return join(repoRoot, name);
+	} catch {}
+	debug("detectConfig: no config file found");
+	return null;
 }
-async function stageFiles(paths) {
-	debug("stageFiles:", paths);
-	await execa("git", ["add", ...paths]);
+/**
+* Load and validate the cmint config from a repo root.
+* Throws if the loaded value is missing or not a non-null object.
+*/
+async function loadConfig(repoRoot) {
+	const configPath = await detectConfig(repoRoot);
+	if (!configPath) throw new Error("No cmint config file found");
+	debug("loadConfig: loading %s", configPath);
+	const ext = extname(configPath);
+	const isJSON = ext === ".json";
+	const needsJiti = ext === ".ts" || ext === ".mts" || ext === ".cts" || ext === ".cjs";
+	let config;
+	if (isJSON) {
+		const raw = readFileSync(configPath, "utf-8");
+		config = JSON.parse(raw);
+	} else if (needsJiti) {
+		const { createJiti } = await import("jiti");
+		const mod = await createJiti(import.meta.url, {}).import(configPath);
+		config = mod.default ?? mod;
+	} else config = (await import(configPath)).default;
+	if (!config || typeof config !== "object" || Array.isArray(config)) throw new Error("cmint config must export a non-null object with glob→command mappings");
+	debug("loadConfig: loaded %d glob patterns", Object.keys(config).length);
+	return config;
 }
-async function attemptCommit(message, extraArgs = [], onProgress) {
-	debug("attemptCommit:", message, extraArgs.length ? extraArgs : "(no extra args)");
+/**
+* Run a shell command and capture its output.
+* Returns a CheckResult with ok=true on success (exit 0), ok=false on failure.
+* Handles ENOENT (command not found) and timeout errors gracefully.
+*/
+async function runCommand(command, timeout, repoRoot) {
+	debug("runCommand: %s (timeout: %dms)", command, timeout);
+	const tool = extractToolName(command) ?? command.split(" ")[0];
 	try {
-		const subprocess = execa("git", [
-			"commit",
-			"-m",
-			message,
-			...extraArgs
-		]);
-		const stderrChunks = [];
-		const parser = onProgress ? createStderrParser() : null;
-		subprocess.stderr?.on("data", (chunk) => {
-			const text = chunk.toString();
-			stderrChunks.push(text);
-			if (parser && onProgress) for (const step of parser(text)) onProgress(step);
+		const result = await execa(command, {
+			shell: true,
+			reject: false,
+			timeout,
+			all: true,
+			preferLocal: true,
+			...repoRoot ? { localDir: repoRoot } : {}
 		});
-		await subprocess;
-		debug("attemptCommit: success");
+		const ok = !result.failed;
+		debug("runCommand: %s — ok=%s", tool, ok);
 		return {
-			ok: true,
-			stderr: stderrChunks.join("")
+			ok,
+			tool,
+			command,
+			stdout: result.stdout ?? "",
+			stderr: result.stderr ?? "",
+			files: []
 		};
-	} catch (error) {
-		const e = error;
-		debug("attemptCommit: failed —", e.message?.slice(0, 200));
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		const isTimedOut = msg.toLowerCase().includes("timed out");
+		const isNotFound = msg.toLowerCase().includes("enoent") || msg.toLowerCase().includes("not found");
+		debug("runCommand: %s — error: %s", tool, msg);
 		return {
 			ok: false,
-			error: e.message,
-			stderr: typeof e.stderr === "string" ? e.stderr : ""
+			tool,
+			command,
+			stdout: "",
+			stderr: isTimedOut ? `Check timed out after ${timeout}ms` : isNotFound ? `Command not found: ${tool}` : msg,
+			files: []
 		};
 	}
 }
-async function attemptCommitNoVerify(message, onProgress) {
-	debug("attemptCommitNoVerify:", message);
-	return attemptCommit(message, ["--no-verify"], onProgress);
+/**
+* Filter a list of file paths by a picomatch glob pattern.
+* When the pattern contains no `/`, files are matched at any depth (matchBase).
+* Dotfiles are included (dot: true).
+*/
+function matchFiles(pattern, files) {
+	if (!pattern) return [];
+	const matchBase = !pattern.includes("/");
+	const isMatch = picomatch(pattern, {
+		dot: true,
+		posixSlashes: true,
+		strictBrackets: true
+	});
+	return files.filter((f) => {
+		const parts = f.split("/");
+		return isMatch(matchBase ? parts[parts.length - 1] : f);
+	});
 }
-//#endregion
-//#region src/ui/review-message.ts
-async function reviewCommitMessage(message) {
-	const { select, text } = await import("@clack/prompts");
-	while (true) {
-		const review = await select({
-			message: `Review commit message:\n\n   ${bold(message)}\n`,
-			options: [
-				{
-					label: "Use as-is",
-					value: "use"
-				},
-				{
-					label: "Edit",
-					value: "edit"
-				},
-				{
-					label: "Cancel",
-					value: "cancel"
-				}
-			]
+/**
+* Build a shell command string from a base command and a list of file paths.
+* File paths containing spaces are wrapped in double quotes.
+* If no files are provided, the base command is returned as-is.
+*/
+function buildCommand(command, files) {
+	if (files.length === 0) return command;
+	return `${command} ${files.map((f) => f.includes(" ") ? `"${f}"` : f).join(" ")}`;
+}
+/**
+* Call a function command with matched files and normalize the result to ResolvedCommand[].
+*/
+function resolveFunction(fn, matchedFiles) {
+	const resolved = fn(matchedFiles);
+	return (Array.isArray(resolved) ? resolved : [resolved]).map((command) => ({
+		command,
+		fromFunction: true
+	}));
+}
+/**
+* Resolve config commands for a glob entry into an array of resolved commands.
+* Function commands are called with matched filenames; string commands are kept as-is.
+* Each resolved entry tracks whether it came from a function (for file-append behavior).
+*/
+function resolveCommands(commands, matchedFiles) {
+	if (typeof commands === "function") return resolveFunction(commands, matchedFiles);
+	if (Array.isArray(commands)) {
+		const result = [];
+		for (const cmd of commands) if (typeof cmd === "function") result.push(...resolveFunction(cmd, matchedFiles));
+		else result.push({
+			command: cmd,
+			fromFunction: false
 		});
-		if (isCancel(review) || review === "cancel") {
-			debug("User cancelled at review step");
-			return null;
-		}
-		if (review === "use") {
-			debug("User accepted message");
-			return message;
-		}
-		if (review === "edit") {
-			debug("User chose to edit message");
-			const edited = await text({
-				message: "Edit commit message:",
-				initialValue: message,
-				validate: (v) => v?.trim() ? void 0 : "Message cannot be empty"
-			});
-			if (isCancel(edited)) continue;
-			message = String(edited).trim();
-			debug("Edited message:", message);
-		}
+		return result;
 	}
+	return [{
+		command: commands,
+		fromFunction: false
+	}];
 }
-//#endregion
-//#region src/utils/cache.ts
-const CACHE_DIR = join(os.homedir(), ".cache", "commit-mint");
-function repoHash(repoPath) {
-	return createHash("sha256").update(repoPath).digest("hex").slice(0, 12);
-}
-function cachePath(repoPath) {
-	return join(CACHE_DIR, `${repoHash(repoPath)}.json`);
+/**
+* Run resolved commands for a single glob entry, appending results.
+* Function-originated commands run as-is; string commands get matched files appended.
+* Returns false if any command fails (for fail-fast signaling).
+*/
+async function runCommandsForGlob(cmds, matchedFiles, timeout, results, repoRoot) {
+	for (const { command, fromFunction } of cmds) {
+		const fullCommand = fromFunction ? command : buildCommand(command, matchedFiles);
+		debug("runCommandsForGlob: running '%s'", fullCommand);
+		const result = await runCommand(fullCommand, timeout, repoRoot);
+		results.push({
+			...result,
+			files: matchedFiles
+		});
+		if (!result.ok) {
+			debug("runCommandsForGlob: check failed, stopping (fail-fast)");
+			return false;
+		}
+	}
+	return true;
 }
-async function saveCachedCommit(repoPath, message) {
-	await mkdir(CACHE_DIR, { recursive: true });
-	const data = {
-		message,
-		timestamp: Date.now(),
-		repoPath
+/**
+* Run all user-defined checks from .cmintrc against staged files.
+* Returns a no-op result when no config exists.
+* Fail-fast: stops on first error.
+*/
+async function runAllChecks(repoRoot, stagedFiles, timeout) {
+	debug("runAllChecks: %d staged files, checking for config in %s", stagedFiles.length, repoRoot);
+	if (!await detectConfig(repoRoot)) {
+		debug("runAllChecks: no config found, skipping checks");
+		return {
+			ok: true,
+			results: []
+		};
+	}
+	const config = await loadConfig(repoRoot);
+	debug("runAllChecks: loaded config with %d patterns", Object.keys(config).length);
+	const results = [];
+	for (const [glob, commands] of Object.entries(config)) {
+		const matchedFiles = matchFiles(glob, stagedFiles);
+		if (matchedFiles.length === 0) {
+			debug("runAllChecks: no files matched pattern '%s'", glob);
+			continue;
+		}
+		debug("runAllChecks: pattern '%s' matched %d files", glob, matchedFiles.length);
+		if (!await runCommandsForGlob(resolveCommands(commands, matchedFiles), matchedFiles, timeout, results, repoRoot)) return {
+			ok: false,
+			results
+		};
+	}
+	const ok = results.every((r) => r.ok);
+	debug("runAllChecks: complete — ok=%s, %d results", ok, results.length);
+	return {
+		ok,
+		results
 	};
-	const path = cachePath(repoPath);
-	debug("saveCachedCommit: saving to %s", path);
-	await writeFile(path, JSON.stringify(data, null, 2), "utf8");
 }
-async function loadCachedCommit(repoPath) {
-	const path = cachePath(repoPath);
-	debug("loadCachedCommit: loading from %s", path);
+//#endregion
+//#region src/services/config.ts
+const CONFIG_PATH = join(os.homedir(), ".commit-mint");
+const defaults = {
+	provider: "groq",
+	model: "openai/gpt-oss-20b",
+	locale: "en",
+	"max-length": "100",
+	type: "",
+	timeout: "10000"
+};
+async function readConfig() {
+	debug("readConfig: loading from %s", CONFIG_PATH);
 	try {
-		const raw = await readFile(path, "utf8");
-		const data = JSON.parse(raw);
-		debug("loadCachedCommit: found message from %s", new Date(data.timestamp).toISOString());
-		return data;
+		const raw = await readFile(CONFIG_PATH, "utf8");
+		const parsed = ini.parse(raw);
+		const merged = {
+			...defaults,
+			...parsed
+		};
+		debug("readConfig: loaded keys: %s", Object.keys(merged).join(", "));
+		return merged;
 	} catch {
-		debug("loadCachedCommit: no cached commit found");
-		return null;
+		debug("readConfig: no config file, using defaults");
+		return { ...defaults };
 	}
 }
-//#endregion
-//#region src/services/ai.ts
-const MAX_DIFF_CHARS = 2e4;
-function mapGroqError(error, providerLabel) {
-	const label = providerLabel ?? "Groq";
-	if (error instanceof Groq.AuthenticationError) return /* @__PURE__ */ new Error(`Invalid API key for ${label}. Run: cmint config set ${label.toUpperCase()}_API_KEY=<key>`);
-	if (error instanceof Groq.RateLimitError) return /* @__PURE__ */ new Error(`Rate limited by ${label}. Please wait and try again.`);
-	if (error instanceof Groq.APIConnectionTimeoutError) return /* @__PURE__ */ new Error("Request timed out. Check your network or try a smaller diff.");
-	if (error instanceof Groq.APIError) return /* @__PURE__ */ new Error(`${label} API error: ${error.message}`);
-	if (error instanceof Error && /^4\d{2}\s/.test(error.message)) return /* @__PURE__ */ new Error(`${label} API error: ${error.message}`);
-	return /* @__PURE__ */ new Error(`Unexpected error: ${error instanceof Error ? error.message : String(error)}`);
+async function writeConfig(updates) {
+	const existing = await readConfig();
+	Object.assign(existing, updates);
+	await writeFile(CONFIG_PATH, ini.stringify(existing), "utf8");
 }
-const CONVENTIONAL_COMMIT_REGEX = /^(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.+\))?!?: .+$/;
-function stripThinkTags(text) {
-	return text.replace(/<think[\s\S]*?<\/think>/gi, "").trim();
+async function setConfigValue(key, value) {
+	await writeConfig({ [key]: value });
 }
-function deriveMessageFromReasoning(reasoning) {
-	const match = reasoning.match(/(build|chore|ci|docs|feat|fix|perf|refactor|revert|style|test)(\(.+\))?!?: .+/i);
-	if (match) return match[0].trim();
-	const first = reasoning.split(/[.!?]/).find((s) => s.trim().length >= 10);
-	return first ? first.trim() : null;
+async function getProviderApiKey(provider) {
+	const envVar = PROVIDER_ENV_KEYS[provider];
+	if (envVar) {
+		const envValue = process.env[envVar];
+		if (envValue) {
+			debug("getProviderApiKey(%s): found in env", provider);
+			return envValue;
+		}
+	}
+	const config = await readConfig();
+	const configKey = PROVIDER_ENV_KEYS[provider];
+	if (configKey && config[configKey]) {
+		debug("getProviderApiKey(%s): found in config", provider);
+		return config[configKey];
+	}
+	debug("getProviderApiKey(%s): not found", provider);
+	throw new Error(`Please set your ${formatProviderName(provider)} API key via \`cmint config set ${envVar}=<your token>\``);
 }
-function stripContextLines(diff) {
-	return diff.split("\n").filter((line) => !line.startsWith(" ")).join("\n");
+/** Check if a model name is the default for a provider OTHER than the given one. */
+function isOtherProviderDefault(model, provider) {
+	for (const [name, config] of Object.entries(PROVIDER_CONFIGS)) if (name !== provider && config.defaultModel === model) return true;
+	return false;
 }
-function compressDiff(diff) {
-	if (diff.length <= MAX_DIFF_CHARS) return diff;
-	let result = stripContextLines(diff);
-	if (result.length <= MAX_DIFF_CHARS) return result;
-	result = result.split(/(?=diff --git)/).filter(Boolean).map((fd) => {
-		return fd.split(/(?=\n@@)/).map((part, idx) => {
-			if (idx === 0) return part;
-			const lines = part.split("\n");
-			return [lines[0], ...lines.slice(1).filter((l) => l.startsWith("+") || l.startsWith("-")).slice(0, 10)].join("\n");
-		}).join("");
-	}).join("");
-	if (result.length <= MAX_DIFF_CHARS) return result;
-	return `Summary of changes:\n${(diff.match(/^diff --git a\/(.+) b\/(.+)$/gm) || []).map((f) => {
-		const match = f.match(/^diff --git a\/(.+) b\/(.+)$/);
-		return match && match[1] === match[2] ? `${match[1]} | changed` : "";
-	}).filter(Boolean).join("\n")}`;
+function getModelForProvider(config, provider, defaultModel) {
+	const providerModel = config[`model_${provider}`];
+	if (providerModel) return providerModel;
+	const globalModel = config.model;
+	if (globalModel && !isOtherProviderDefault(globalModel, provider)) return globalModel;
+	return defaultModel;
 }
-function buildStatSummary(diff) {
-	const files = [];
-	let currentFile = "";
-	let adds = 0;
-	let dels = 0;
-	for (const line of diff.split("\n")) {
-		const match = line.match(/^diff --git a\/.+ b\/(.+)$/);
-		if (match) {
-			if (currentFile) files.push({
-				name: currentFile,
-				adds,
-				dels
+//#endregion
+//#region src/services/hook-progress.ts
+const ansiRe = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+function createStderrParser() {
+	let buffer = "";
+	return (chunk) => {
+		buffer += chunk;
+		const steps = [];
+		const lines = buffer.split("\n");
+		buffer = lines.pop() ?? "";
+		for (const line of lines) {
+			const match = line.replace(ansiRe, "").match(/\[(STARTED|COMPLETED|FAILED)\]\s+(.+)/);
+			if (!match) continue;
+			const status = match[1].toLowerCase();
+			const command = match[2].trim();
+			if (isLintStagedMeta(command)) continue;
+			const tool = extractToolName(command) ?? command;
+			steps.push({
+				status,
+				command,
+				tool
 			});
-			currentFile = match[1];
-			adds = 0;
-			dels = 0;
-		} else if (line.startsWith("+") && !line.startsWith("+++")) adds++;
-		else if (line.startsWith("-") && !line.startsWith("---")) dels++;
-	}
-	if (currentFile) files.push({
-		name: currentFile,
-		adds,
-		dels
-	});
-	const totalAdds = files.reduce((s, f) => s + f.adds, 0);
-	const totalDels = files.reduce((s, f) => s + f.dels, 0);
-	const lines = files.map((f) => ` ${f.name}  | +${f.adds} -${f.dels}`);
-	lines.push(` ${files.length} files changed, ${totalAdds} insertions(+), ${totalDels} deletions(-)`);
-	return lines.join("\n");
+		}
+		return steps;
+	};
 }
-function buildSystemPrompt(type) {
-	let prompt = "You are a commit message generator. Follow the Conventional Commits specification.\nValid types: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test.\nFormat: type(scope): description\nUse imperative mood, lowercase, no trailing period.\nOutput ONLY the commit message, no markdown fences, no explanation.";
-	if (type && type.trim().length > 0) prompt += `\nYou MUST use type: ${type}`;
-	return prompt;
+function createProgressHandler(s) {
+	return (step) => {
+		if (step.status === "started") s.message(step.command);
+		else if (step.status === "failed") s.message(step.command);
+	};
 }
-function buildUserPrompt(diff, hint, statSummary) {
-	const parts = [];
-	if (hint) parts.push(`Context: ${hint}`);
-	if (statSummary) parts.push(`Change summary:\n${statSummary}`);
-	parts.push(`Generate a conventional commit for:\n\n${diff}`);
-	return parts.join("\n\n");
+//#endregion
+//#region src/services/git.ts
+var git_exports = /* @__PURE__ */ __exportAll({
+	KnownError: () => KnownError,
+	assertGitRepo: () => assertGitRepo,
+	attemptCommit: () => attemptCommit,
+	attemptCommitNoVerify: () => attemptCommitNoVerify,
+	getChangedFiles: () => getChangedFiles,
+	getDefaultExcludes: () => getDefaultExcludes,
+	getHead: () => getHead,
+	getRepoRoot: () => getRepoRoot,
+	getStagedDiff: () => getStagedDiff,
+	getStatusShort: () => getStatusShort,
+	resetStaging: () => resetStaging,
+	stageAll: () => stageAll,
+	stageFiles: () => stageFiles
+});
+var KnownError = class extends Error {};
+async function assertGitRepo() {
+	debug("assertGitRepo");
+	const { failed } = await execa("git", ["rev-parse", "--show-toplevel"], { reject: false });
+	if (failed) throw new KnownError("The current directory must be a Git repository!");
 }
-function isValidConventionalCommit(message) {
-	return CONVENTIONAL_COMMIT_REGEX.test(message);
+async function getRepoRoot() {
+	const { stdout } = await execa("git", ["rev-parse", "--show-toplevel"]);
+	debug("getRepoRoot:", stdout.trim());
+	return stdout.trim();
 }
-function extractContentText(content) {
-	if (content == null) return "";
-	if (typeof content === "string") return content.trim();
-	if (Array.isArray(content)) return content.filter((part) => part.type === "text" && typeof part.text === "string").map((part) => stripThinkTags(part.text)).join("").trim();
-	return "";
+const DEFAULT_EXCLUDES = [
+	"package-lock.json",
+	"node_modules/**",
+	"dist/**",
+	"build/**",
+	".next/**",
+	"coverage/**",
+	"*.log",
+	"*.min.js",
+	"*.min.css",
+	"*.lock",
+	".DS_Store"
+];
+function getDefaultExcludes() {
+	return [...DEFAULT_EXCLUDES];
 }
-async function generateCommitMessage(diff, options) {
-	const timeoutMs = options.timeout ?? 6e4;
-	debug("Timeout: %d ms", timeoutMs);
-	const { client, model } = createProvider({
-		provider: options.provider ?? "groq",
-		apiKey: options.apiKey,
-		modelOverride: options.model,
-		timeout: timeoutMs,
-		baseURLOverride: options.proxy
-	});
-	debug("generateCommitMessage: model=%s, type=%s, hint=%s", model, options.type ?? "none", options.hint ?? "none");
-	const compressedDiff = compressDiff(diff);
-	const statSummary = buildStatSummary(diff);
-	const systemPrompt = buildSystemPrompt(options.type);
-	const userPrompt = buildUserPrompt(compressedDiff, options.hint, statSummary);
-	debug("Diff: %d chars → compressed to %d chars", diff.length, compressedDiff.length);
-	debug("Stat summary:\n%s", statSummary);
-	debug("User prompt length: %d chars", userPrompt.length);
-	async function callAI(strictSystemPrompt) {
-		const callStart = Date.now();
-		debug("callAI: %s — model=%s, promptLen=%d, systemLen=%d", !!strictSystemPrompt ? "RETRY (strict)" : "INITIAL", model, userPrompt.length, (strictSystemPrompt ?? systemPrompt).length);
-		try {
-			const isReasoningModel = /^(o[1-9]|.*gpt-oss.*|.*gpt-5.*)/i.test(model);
-			const isGroq = (options.provider ?? "groq") === "groq";
-			const completion = await client.chat.completions.create({
-				messages: [{
-					role: "system",
-					content: strictSystemPrompt ?? systemPrompt
-				}, {
-					role: "user",
-					content: userPrompt
-				}],
-				model,
-				temperature: .3,
-				...isReasoningModel ? { max_completion_tokens: 1024 } : { max_tokens: 1024 },
-				...isGroq && isReasoningModel ? { reasoning_format: "parsed" } : {}
-			});
-			const elapsed = Date.now() - callStart;
-			const rawContent = completion.choices[0]?.message?.content;
-			const content = extractContentText(typeof rawContent === "string" ? stripThinkTags(rawContent) : rawContent);
-			debug("callAI response (%d ms): choices=%d, finishReason=%s, contentLen=%d, rawType=%s", elapsed, completion.choices.length, completion.choices[0]?.finish_reason ?? "(none)", content.length, typeof rawContent);
-			debug("callAI raw content: %s", content.slice(0, 300) || "(empty)");
-			if (!content) {
-				const reasoning = completion.choices[0]?.message?.reasoning;
-				debug("callAI: content empty, attempting reasoning fallback (reasoningLen=%d)", reasoning?.length ?? 0);
-				if (reasoning) {
-					const derived = deriveMessageFromReasoning(reasoning);
-					if (derived) {
-						debug("callAI: derived message from reasoning: %s", derived.slice(0, 100));
-						return stripThinkTags(derived);
-					}
-					debug("callAI: could not derive message from reasoning");
-				}
-				throw new Error("AI returned an empty commit message");
-			}
-			return content;
-		} catch (error) {
-			debug("callAI FAILED after %d ms: %s", Date.now() - callStart, error instanceof Error ? `${error.name}: ${error.message}` : String(error));
-			throw error;
-		}
+async function getStagedDiff(exclude) {
+	const excludeArgs = (exclude ?? []).map((e) => `:(exclude)${e}`);
+	const defaultExcludeArgs = DEFAULT_EXCLUDES.map((e) => `:(exclude)${e}`);
+	const { stdout: allFiles } = await execa("git", [
+		"diff",
+		"--cached",
+		"--name-only"
+	]);
+	if (!allFiles) {
+		debug("getStagedDiff: no staged files");
+		return null;
 	}
-	try {
-		const totalStart = Date.now();
-		let message = await callAI();
-		debug("Validation: message=%s, isValid=%s", message.slice(0, 100), isValidConventionalCommit(message));
-		if (!isValidConventionalCommit(message)) {
-			debug("Initial message failed conventional commit validation, retrying with strict prompt (elapsed: %d ms)", Date.now() - totalStart);
-			const retryMessage = await callAI("You MUST output ONLY a valid conventional commit message. Format: type(scope): description. If you output anything else your response will be rejected.\nValid types: build, chore, ci, docs, feat, fix, perf, refactor, revert, style, test.");
-			debug("Retry validation: message=%s, isValid=%s", retryMessage.slice(0, 100), isValidConventionalCommit(retryMessage));
-			if (isValidConventionalCommit(retryMessage)) {
-				debug("Retry produced valid conventional commit");
-				message = retryMessage;
-			} else debug("Retry also failed validation, using original message");
-		}
-		debug("Final message (%d ms total): %s", Date.now() - totalStart, message);
-		return message;
-	} catch (error) {
-		debug("AI error: %s", error instanceof Error ? error.message : String(error));
-		throw mapGroqError(error, options.provider ? formatProviderName(options.provider) : void 0);
+	const { stdout: files } = await execa("git", [
+		"diff",
+		"--cached",
+		"--name-only",
+		...defaultExcludeArgs,
+		...excludeArgs
+	]);
+	if (!files) {
+		const excludedFiles = allFiles.split("\n").filter(Boolean);
+		debug("getStagedDiff: all files excluded:", excludedFiles);
+		return { excludedFiles };
 	}
+	const { stdout: diff } = await execa("git", [
+		"diff",
+		"--cached",
+		"--diff-algorithm=minimal",
+		...defaultExcludeArgs,
+		...excludeArgs
+	]);
+	debug("getStagedDiff:", files.split("\n").filter(Boolean).length, "files,", diff.length, "chars");
+	return {
+		files: files.split("\n").filter(Boolean),
+		diff
+	};
 }
-//#endregion
-//#region src/services/checks.ts
-/** Config file names, checked in priority order (matches lint-staged naming conventions) */
-const CONFIG_FILES = [
-	".cmintrc",
-	".cmintrc.json",
-	".cmintrc.mjs",
-	".cmintrc.mts",
-	".cmintrc.js",
-	".cmintrc.ts",
-	".cmintrc.cjs",
-	".cmintrc.cts",
-	"cmint.config.mjs",
-	"cmint.config.mts",
-	"cmint.config.js",
-	"cmint.config.ts",
-	"cmint.config.cjs",
-	"cmint.config.cts"
-];
-/**
-* Detect whether the repo has a cmint config file.
-* Returns the config file path, or null if none found.
-*/
-async function detectConfig(repoRoot) {
-	debug("detectConfig: checking for config in %s", repoRoot);
-	for (const name of CONFIG_FILES) try {
-		await access(join(repoRoot, name), constants.R_OK);
-		debug("detectConfig: found %s", name);
-		return join(repoRoot, name);
-	} catch {}
-	debug("detectConfig: no config file found");
-	return null;
+async function stageAll() {
+	debug("stageAll: git add -A");
+	await execa("git", ["add", "-A"]);
+}
+async function resetStaging() {
+	debug("resetStaging: git reset HEAD");
+	await execa("git", ["reset", "HEAD"]);
 }
-/**
-* Load and validate the cmint config from a repo root.
-* Throws if the loaded value is missing or not a non-null object.
-*/
-async function loadConfig(repoRoot) {
-	const configPath = await detectConfig(repoRoot);
-	if (!configPath) throw new Error("No cmint config file found");
-	debug("loadConfig: loading %s", configPath);
-	const ext = extname(configPath);
-	const isJSON = ext === ".json";
-	const needsJiti = ext === ".ts" || ext === ".mts" || ext === ".cts" || ext === ".cjs";
-	let config;
-	if (isJSON) {
-		const raw = readFileSync(configPath, "utf-8");
-		config = JSON.parse(raw);
-	} else if (needsJiti) {
-		const { createJiti } = await import("jiti");
-		const mod = await createJiti(import.meta.url, {}).import(configPath);
-		config = mod.default ?? mod;
-	} else config = (await import(configPath)).default;
-	if (!config || typeof config !== "object" || Array.isArray(config)) throw new Error("cmint config must export a non-null object with glob→command mappings");
-	debug("loadConfig: loaded %d glob patterns", Object.keys(config).length);
-	return config;
+async function getHead() {
+	const { stdout } = await execa("git", ["rev-parse", "HEAD"]);
+	return stdout.trim();
 }
-/**
-* Run a shell command and capture its output.
-* Returns a CheckResult with ok=true on success (exit 0), ok=false on failure.
-* Handles ENOENT (command not found) and timeout errors gracefully.
-*/
-async function runCommand(command, timeout, repoRoot) {
-	debug("runCommand: %s (timeout: %dms)", command, timeout);
-	const tool = extractToolName(command) ?? command.split(" ")[0];
-	try {
-		const result = await execa(command, {
-			shell: true,
-			reject: false,
-			timeout,
-			all: true,
-			preferLocal: true,
-			...repoRoot ? { localDir: repoRoot } : {}
-		});
-		const ok = !result.failed;
-		debug("runCommand: %s — ok=%s", tool, ok);
-		return {
-			ok,
-			tool,
-			command,
-			stdout: result.stdout ?? "",
-			stderr: result.stderr ?? "",
-			files: []
-		};
-	} catch (err) {
-		const msg = err instanceof Error ? err.message : String(err);
-		const isTimedOut = msg.toLowerCase().includes("timed out");
-		const isNotFound = msg.toLowerCase().includes("enoent") || msg.toLowerCase().includes("not found");
-		debug("runCommand: %s — error: %s", tool, msg);
+async function getStatusShort() {
+	const { stdout } = await execa("git", ["status", "--short"]);
+	return stdout.trim();
+}
+async function getChangedFiles() {
+	const { stdout } = await execa("git", ["status", "--short"]);
+	if (!stdout.trim()) return [];
+	const files = stdout.split("\n").filter(Boolean).map((line) => {
+		const indexStatus = line[0];
 		return {
-			ok: false,
-			tool,
-			command,
-			stdout: "",
-			stderr: isTimedOut ? `Check timed out after ${timeout}ms` : isNotFound ? `Command not found: ${tool}` : msg,
-			files: []
+			status: line.slice(0, 2).trim(),
+			path: line.slice(3),
+			staged: indexStatus !== " " && indexStatus !== "?"
 		};
-	}
-}
-/**
-* Filter a list of file paths by a picomatch glob pattern.
-* When the pattern contains no `/`, files are matched at any depth (matchBase).
-* Dotfiles are included (dot: true).
-*/
-function matchFiles(pattern, files) {
-	if (!pattern) return [];
-	const matchBase = !pattern.includes("/");
-	const isMatch = picomatch(pattern, {
-		dot: true,
-		posixSlashes: true,
-		strictBrackets: true
-	});
-	return files.filter((f) => {
-		const parts = f.split("/");
-		return isMatch(matchBase ? parts[parts.length - 1] : f);
 	});
+	debug("getChangedFiles:", files.length, "files");
+	return files;
 }
-/**
-* Build a shell command string from a base command and a list of file paths.
-* File paths containing spaces are wrapped in double quotes.
-* If no files are provided, the base command is returned as-is.
-*/
-function buildCommand(command, files) {
-	if (files.length === 0) return command;
-	return `${command} ${files.map((f) => f.includes(" ") ? `"${f}"` : f).join(" ")}`;
-}
-/**
-* Call a function command with matched files and normalize the result to ResolvedCommand[].
-*/
-function resolveFunction(fn, matchedFiles) {
-	const resolved = fn(matchedFiles);
-	return (Array.isArray(resolved) ? resolved : [resolved]).map((command) => ({
-		command,
-		fromFunction: true
-	}));
-}
-/**
-* Resolve config commands for a glob entry into an array of resolved commands.
-* Function commands are called with matched filenames; string commands are kept as-is.
-* Each resolved entry tracks whether it came from a function (for file-append behavior).
-*/
-function resolveCommands(commands, matchedFiles) {
-	if (typeof commands === "function") return resolveFunction(commands, matchedFiles);
-	if (Array.isArray(commands)) {
-		const result = [];
-		for (const cmd of commands) if (typeof cmd === "function") result.push(...resolveFunction(cmd, matchedFiles));
-		else result.push({
-			command: cmd,
-			fromFunction: false
-		});
-		return result;
-	}
-	return [{
-		command: commands,
-		fromFunction: false
-	}];
+async function stageFiles(paths) {
+	debug("stageFiles:", paths);
+	await execa("git", ["add", ...paths]);
 }
-/**
-* Run resolved commands for a single glob entry, appending results.
-* Function-originated commands run as-is; string commands get matched files appended.
-* Returns false if any command fails (for fail-fast signaling).
-*/
-async function runCommandsForGlob(cmds, matchedFiles, timeout, results, repoRoot) {
-	for (const { command, fromFunction } of cmds) {
-		const fullCommand = fromFunction ? command : buildCommand(command, matchedFiles);
-		debug("runCommandsForGlob: running '%s'", fullCommand);
-		const result = await runCommand(fullCommand, timeout, repoRoot);
-		results.push({
-			...result,
-			files: matchedFiles
+async function attemptCommit(message, extraArgs = [], onProgress) {
+	debug("attemptCommit:", message, extraArgs.length ? extraArgs : "(no extra args)");
+	try {
+		const subprocess = execa("git", [
+			"commit",
+			"-m",
+			message,
+			...extraArgs
+		]);
+		const stderrChunks = [];
+		const parser = onProgress ? createStderrParser() : null;
+		subprocess.stderr?.on("data", (chunk) => {
+			const text = chunk.toString();
+			stderrChunks.push(text);
+			if (parser && onProgress) for (const step of parser(text)) onProgress(step);
 		});
-		if (!result.ok) {
-			debug("runCommandsForGlob: check failed, stopping (fail-fast)");
-			return false;
-		}
-	}
-	return true;
-}
-/**
-* Run all user-defined checks from .cmintrc against staged files.
-* Returns a no-op result when no config exists.
-* Fail-fast: stops on first error.
-*/
-async function runAllChecks(repoRoot, stagedFiles, timeout) {
-	debug("runAllChecks: %d staged files, checking for config in %s", stagedFiles.length, repoRoot);
-	if (!await detectConfig(repoRoot)) {
-		debug("runAllChecks: no config found, skipping checks");
+		await subprocess;
+		debug("attemptCommit: success");
 		return {
 			ok: true,
-			results: []
+			stderr: stderrChunks.join("")
 		};
-	}
-	const config = await loadConfig(repoRoot);
-	debug("runAllChecks: loaded config with %d patterns", Object.keys(config).length);
-	const results = [];
-	for (const [glob, commands] of Object.entries(config)) {
-		const matchedFiles = matchFiles(glob, stagedFiles);
-		if (matchedFiles.length === 0) {
-			debug("runAllChecks: no files matched pattern '%s'", glob);
-			continue;
-		}
-		debug("runAllChecks: pattern '%s' matched %d files", glob, matchedFiles.length);
-		if (!await runCommandsForGlob(resolveCommands(commands, matchedFiles), matchedFiles, timeout, results, repoRoot)) return {
+	} catch (error) {
+		const e = error;
+		debug("attemptCommit: failed —", e.message?.slice(0, 200));
+		return {
 			ok: false,
-			results
+			error: e.message,
+			stderr: typeof e.stderr === "string" ? e.stderr : ""
 		};
 	}
-	const ok = results.every((r) => r.ok);
-	debug("runAllChecks: complete — ok=%s, %d results", ok, results.length);
-	return {
-		ok,
-		results
-	};
+}
+async function attemptCommitNoVerify(message, onProgress) {
+	debug("attemptCommitNoVerify:", message);
+	return attemptCommit(message, ["--no-verify"], onProgress);
 }
 //#endregion
 //#region src/services/grouping.ts
@@ -1200,8 +1142,36 @@ function buildGroupingUserPrompt(summary) {
 		summary
 	].join("\n");
 }
+function buildRetryGroupingPrompt() {
+	return [
+		"PREVIOUS ATTEMPT FAILED: You grouped all files into a single group.",
+		"",
+		"You MUST split the files into at least 2 groups based on what changed and why.",
+		"",
+		"Look for these natural split points:",
+		"- Source code vs tests",
+		"- Different features or modules (e.g., different directories)",
+		"- New files vs modified files vs deleted files",
+		"- Configuration changes vs code changes",
+		"- Documentation vs implementation",
+		"",
+		"If unsure, err on the side of MORE groups, not fewer.",
+		"",
+		"Output format: JSON array of objects with keys 'name', 'description', 'files'.",
+		"name: short label (3-5 words)",
+		"description: 1-2 sentences explaining what this group changes",
+		"files: array of exact file paths from the input",
+		"",
+		"Output ONLY valid JSON. No markdown fences, no explanation."
+	].join("\n");
+}
 function parseGroupingResponse(content) {
-	const jsonText = content.replace(/^```json\s*/, "").replace(/\s*```$/, "").trim();
+	let cleaned = content.replace(/<think[\s\S]*?<\/think>/gi, "").trim();
+	cleaned = cleaned.replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
+	const start = cleaned.indexOf("[");
+	const end = cleaned.lastIndexOf("]");
+	if (start === -1 || end === -1 || end <= start) throw new Error("AI response did not contain a JSON array");
+	const jsonText = cleaned.slice(start, end + 1);
 	const parsed = JSON.parse(jsonText);
 	if (!Array.isArray(parsed)) throw new Error("AI response was not a JSON array");
 	const rawGroups = [];
@@ -1235,27 +1205,17 @@ async function generateGroups(files, apiKey, model, timeout, provider, proxy) {
 		baseURLOverride: proxy
 	});
 	try {
-		const completion = await client.chat.completions.create({
-			messages: [{
-				role: "system",
-				content: systemPrompt
-			}, {
-				role: "user",
-				content: userPrompt
-			}],
-			model: resolvedModel,
-			temperature: .3,
-			max_tokens: 2048
-		});
-		const rawContent = completion.choices[0]?.message?.content;
-		const content = typeof rawContent === "string" ? rawContent.trim() : "";
-		debug("generateGroups response: choices=%d, finishReason=%s, contentLen=%d", completion.choices.length, completion.choices[0]?.finish_reason ?? "(none)", content.length);
-		debug("generateGroups raw content: %s", content.slice(0, 500) || "(empty)");
-		if (!content) throw new Error("AI returned an empty grouping response");
-		const rawGroups = parseGroupingResponse(content);
+		let rawGroups = await callGroupingAI(client, resolvedModel, systemPrompt, userPrompt);
 		debug("generateGroups: parsed %d raw groups", rawGroups.length);
-		const validated = validateGroups(rawGroups, included);
+		let validated = validateGroups(rawGroups, included);
 		debug("generateGroups: %d validated groups", validated.length);
+		if (isLowQualityGrouping(validated, included)) {
+			debug("generateGroups: low quality result, retrying with stricter prompt");
+			rawGroups = await callGroupingAI(client, resolvedModel, buildRetryGroupingPrompt(), userPrompt);
+			debug("generateGroups retry: parsed %d raw groups", rawGroups.length);
+			validated = validateGroups(rawGroups, included);
+			debug("generateGroups retry: %d validated groups", validated.length);
+		}
 		return {
 			groups: validated,
 			excluded
@@ -1265,6 +1225,33 @@ async function generateGroups(files, apiKey, model, timeout, provider, proxy) {
 		throw mapGroqError(error, provider ? formatProviderName(provider) : void 0);
 	}
 }
+async function callGroupingAI(client, model, systemPrompt, userPrompt) {
+	const completion = await client.chat.completions.create({
+		messages: [{
+			role: "system",
+			content: systemPrompt
+		}, {
+			role: "user",
+			content: userPrompt
+		}],
+		model,
+		temperature: .3,
+		max_tokens: 2048
+	});
+	const rawContent = completion.choices[0]?.message?.content;
+	const content = typeof rawContent === "string" ? rawContent.trim() : "";
+	debug("callGroupingAI response: choices=%d, finishReason=%s, contentLen=%d", completion.choices.length, completion.choices[0]?.finish_reason ?? "(none)", content.length);
+	debug("callGroupingAI raw content: %s", content.slice(0, 500) || "(empty)");
+	if (!content) throw new Error("AI returned an empty grouping response");
+	return parseGroupingResponse(content);
+}
+/** Minimum file count where a single-group result is considered low quality */
+const MIN_FILES_FOR_QUALITY_CHECK = 5;
+function isLowQualityGrouping(groups, allFiles) {
+	if (groups.length === 0) return false;
+	if (allFiles.length < MIN_FILES_FOR_QUALITY_CHECK) return false;
+	return groups.length === 1;
+}
 function validateGroups(groups, allFiles) {
 	const validPaths = new Set(allFiles.map((f) => f.path));
 	const seen = /* @__PURE__ */ new Set();
@@ -1291,7 +1278,52 @@ function validateGroups(groups, allFiles) {
 			files: ungrouped.map((f) => f.path)
 		});
 	}
-	return validated;
+	return validated;
+}
+const EXIT_CODES = {
+	SUCCESS: 0,
+	GENERIC: 1,
+	NO_CHANGES: 2,
+	GIT: 3,
+	AI: 4,
+	CHECK: 5,
+	HOOK: 6
+};
+function writeAgentResult(result) {
+	process.stdout.write(`${JSON.stringify(result)}\n`);
+}
+//#endregion
+//#region src/utils/cache.ts
+const CACHE_DIR = join(os.homedir(), ".cache", "commit-mint");
+function repoHash(repoPath) {
+	return createHash("sha256").update(repoPath).digest("hex").slice(0, 12);
+}
+function cachePath(repoPath) {
+	return join(CACHE_DIR, `${repoHash(repoPath)}.json`);
+}
+async function saveCachedCommit(repoPath, message) {
+	await mkdir(CACHE_DIR, { recursive: true });
+	const data = {
+		message,
+		timestamp: Date.now(),
+		repoPath
+	};
+	const path = cachePath(repoPath);
+	debug("saveCachedCommit: saving to %s", path);
+	await writeFile(path, JSON.stringify(data, null, 2), "utf8");
+}
+async function loadCachedCommit(repoPath) {
+	const path = cachePath(repoPath);
+	debug("loadCachedCommit: loading from %s", path);
+	try {
+		const raw = await readFile(path, "utf8");
+		const data = JSON.parse(raw);
+		debug("loadCachedCommit: found message from %s", new Date(data.timestamp).toISOString());
+		return data;
+	} catch {
+		debug("loadCachedCommit: no cached commit found");
+		return null;
+	}
 }
 //#endregion
 //#region src/services/clipboard.ts
@@ -1374,8 +1406,10 @@ function tryCopy(cmd, args, content) {
 //#endregion
 //#region src/ui/check-failure-menu.ts
 const MAX_TSC_DIAGNOSTICS = 3;
+const MAX_ESLINT_DIAGNOSTICS = 3;
 const MAX_SUMMARY_LINE_LENGTH = 120;
 const TSC_DIAGNOSTIC = /^(.+?\.(?:ts|tsx|mts|cts|js|jsx|mjs|cjs))\((\d+),(\d+)\):\s+error\s+(TS\d+):\s+(.+)$/;
+const ESLINT_ERROR_LINE = /^\s*(\d+):(\d+)\s+(error|warning)\s+(.+)\s{2,}(\S+)\s*$/;
 function formatCheckFailureSummary(errors) {
 	if (errors.length === 0) return "No check error details were parsed. View full output for details.";
 	return errors.map((error) => formatCheckErrorSummary(error)).join("\n");
@@ -1385,6 +1419,10 @@ function formatCheckErrorSummary(error) {
 		const diagnostics = extractTscDiagnostics(error.raw || error.message);
 		if (diagnostics.length > 0) return formatTscSummary(diagnostics);
 	}
+	if (error.tool === "eslint") {
+		const diagnostics = extractEslintDiagnostics(error.raw || error.message);
+		if (diagnostics.length > 0) return formatEslintSummary(diagnostics);
+	}
 	const message = firstMeaningfulLine(error.message || error.raw);
 	return `  ${red("•")} [${error.tool}] ${truncate(message, MAX_SUMMARY_LINE_LENGTH)}`;
 }
@@ -1408,6 +1446,36 @@ function formatTscSummary(diagnostics) {
 	if (hidden > 0) lines.push(dim(`    +${hidden} more TypeScript error${hidden !== 1 ? "s" : ""}. View full output for details.`));
 	return lines.join("\n");
 }
+function extractEslintDiagnostics(raw) {
+	const diagnostics = [];
+	const lines = raw.split("\n");
+	let currentFile = "";
+	for (const line of lines) {
+		if (!/^\s/.test(line) && line.includes("/") && !ESLINT_ERROR_LINE.test(line)) {
+			currentFile = line.trim();
+			continue;
+		}
+		const match = ESLINT_ERROR_LINE.exec(line);
+		if (match) diagnostics.push({
+			file: currentFile || "unknown",
+			line: match[1] ?? "",
+			column: match[2] ?? "",
+			severity: match[3] ?? "",
+			message: (match[4] ?? "").trim(),
+			rule: match[5] ?? ""
+		});
+	}
+	return diagnostics;
+}
+function formatEslintSummary(diagnostics) {
+	const visible = diagnostics.slice(0, MAX_ESLINT_DIAGNOSTICS);
+	const hidden = diagnostics.length - visible.length;
+	const count = diagnostics.length;
+	const noun = count === 1 ? "problem" : "problems";
+	const lines = [`  ${red("•")} [eslint] ${count} ESLint ${noun}`, ...visible.map((diagnostic) => `${diagnostic.file}:${diagnostic.line}:${diagnostic.column} ${diagnostic.severity} ${diagnostic.rule} — ${truncate(diagnostic.message, MAX_SUMMARY_LINE_LENGTH)}`)];
+	if (hidden > 0) lines.push(dim(`    +${hidden} more ESLint ${hidden === 1 ? "problem" : "problems"}. View full output for details.`));
+	return lines.join("\n");
+}
 function firstMeaningfulLine(message) {
 	return message.split("\n").map((l) => l.trim()).find((l) => l.length > 0 && !l.startsWith(">") && !l.startsWith("ELIFECYCLE")) ?? message;
 }
@@ -1641,6 +1709,49 @@ async function showRecoveryMenu(errors, onRetry, onSkipHooks, onRestage, message
 	}
 }
 //#endregion
+//#region src/ui/review-message.ts
+async function reviewCommitMessage(message) {
+	const { select, text } = await import("@clack/prompts");
+	while (true) {
+		const review = await select({
+			message: `Review commit message:\n\n   ${bold(message)}\n`,
+			options: [
+				{
+					label: "Use as-is",
+					value: "use"
+				},
+				{
+					label: "Edit",
+					value: "edit"
+				},
+				{
+					label: "Cancel",
+					value: "cancel"
+				}
+			]
+		});
+		if (isCancel(review) || review === "cancel") {
+			debug("User cancelled at review step");
+			return null;
+		}
+		if (review === "use") {
+			debug("User accepted message");
+			return message;
+		}
+		if (review === "edit") {
+			debug("User chose to edit message");
+			const edited = await text({
+				message: "Edit commit message:",
+				initialValue: message,
+				validate: (v) => v?.trim() ? void 0 : "Message cannot be empty"
+			});
+			if (isCancel(edited)) continue;
+			message = String(edited).trim();
+			debug("Edited message:", message);
+		}
+	}
+}
+//#endregion
 //#region src/commands/auto-group.ts
 async function runAutoGroupFlow(changedFiles, flags) {
 	const { included, excluded } = filterExcludedFiles(changedFiles);
@@ -1818,6 +1929,245 @@ function buildExcludedFilesMessage(files) {
 	return "chore: update generated files";
 }
 //#endregion
+//#region src/commands/agent.ts
+/**
+* Wrapper around getHead() that returns "" on fresh repos with no commits.
+* `git rev-parse HEAD` fails with exit 128 on a brand-new repo, which would
+* crash the agent flow before the first commit can be made.
+*/
+async function safeGetHead() {
+	try {
+		return await getHead();
+	} catch {
+		return "";
+	}
+}
+/**
+* Headless agent command — orchestrates the entire commit flow without any TUI
+* interaction. Emits structured JSON results to stdout, one per line. Returns
+* control to the caller with `process.exitCode` set to one of the 7 documented
+* exit codes (0=success, 1=generic, 2=no_changes, 3=git, 4=ai, 5=check, 6=hook).
+*/
+async function agentCommand(flags) {
+	debug("agentCommand called", { flags });
+	if (flags.retry) {
+		process.exitCode = EXIT_CODES.GENERIC;
+		writeAgentResult({
+			status: "failure",
+			commits: [],
+			errors: ["--agent is not compatible with --retry"]
+		});
+		return;
+	}
+	try {
+		await assertGitRepo();
+	} catch (err) {
+		process.exitCode = EXIT_CODES.GIT;
+		writeAgentResult({
+			status: "failure",
+			commits: [],
+			errors: [err instanceof Error ? err.message : String(err)]
+		});
+		return;
+	}
+	const status = await getStatusShort();
+	debug("Git status:", status || "(empty)");
+	if (!status) {
+		process.exitCode = EXIT_CODES.NO_CHANGES;
+		writeAgentResult({
+			status: "no_changes",
+			commits: []
+		});
+		return;
+	}
+	const changedFiles = await getChangedFiles();
+	debug("Changed files:", changedFiles.length);
+	await stageFiles(changedFiles.map((f) => f.path));
+	const diffResult = await getStagedDiff();
+	if (!diffResult) {
+		process.exitCode = EXIT_CODES.NO_CHANGES;
+		writeAgentResult({
+			status: "no_changes",
+			commits: []
+		});
+		return;
+	}
+	if ("excludedFiles" in diffResult) {
+		debug("All staged files are excluded:", diffResult.excludedFiles);
+		const message = buildExcludedFilesMessage(diffResult.excludedFiles);
+		const headBefore = await safeGetHead();
+		const result = await attemptCommit(message);
+		const headAfter = await safeGetHead();
+		if (result.ok || headBefore !== headAfter) {
+			process.exitCode = EXIT_CODES.SUCCESS;
+			writeAgentResult({
+				status: "success",
+				commits: [{
+					message,
+					hash: headAfter,
+					files: diffResult.excludedFiles
+				}]
+			});
+		} else {
+			process.exitCode = EXIT_CODES.HOOK;
+			writeAgentResult({
+				status: "failure",
+				commits: [],
+				errors: parseHookErrors(result.stderr ?? "").map((e) => `[${e.tool}] ${e.message}`)
+			});
+		}
+		return;
+	}
+	if (flags.message) {
+		debug("Using provided message:", flags.message);
+		const headBefore = await safeGetHead();
+		const result = await attemptCommit(flags.message);
+		const headAfter = await safeGetHead();
+		if (result.ok || headBefore !== headAfter) {
+			process.exitCode = EXIT_CODES.SUCCESS;
+			writeAgentResult({
+				status: "success",
+				commits: [{
+					message: flags.message,
+					hash: headAfter,
+					files: diffResult.files
+				}]
+			});
+		} else {
+			process.exitCode = EXIT_CODES.HOOK;
+			writeAgentResult({
+				status: "failure",
+				commits: [],
+				errors: parseHookErrors(result.stderr ?? "").map((e) => `[${e.tool}] ${e.message}`)
+			});
+		}
+		return;
+	}
+	if (!flags.noCheck) {
+		const repoRoot = await getRepoRoot();
+		if (await detectConfig(repoRoot)) {
+			debug("Running user checks on changed files...");
+			const checkResults = await runAllChecks(repoRoot, changedFiles.filter((f) => f.status !== "D").map((f) => f.path), 6e4);
+			if (!checkResults.ok) {
+				const errorMessages = checkResults.results.filter((r) => !r.ok).map((r) => `[${r.tool}]\n${r.stdout}\n${r.stderr}`.trim()).filter(Boolean);
+				const parsed = parseCheckErrors(errorMessages.join("\n\n"));
+				const errors = parsed.length > 0 ? parsed.map((e) => `[${e.tool}] ${e.message}`) : errorMessages;
+				process.exitCode = EXIT_CODES.CHECK;
+				writeAgentResult({
+					status: "failure",
+					commits: [],
+					errors
+				});
+				return;
+			}
+		}
+	}
+	const { included, excluded } = filterExcludedFiles(changedFiles);
+	debug("Auto-group: %d included, %d excluded", included.length, excluded.length);
+	if (excluded.length > 0) {
+		const message = buildExcludedFilesMessage(excluded);
+		debug("Committing %d excluded files:", excluded.length, excluded);
+		await resetStaging();
+		await stageFiles(excluded);
+		const headBefore = await safeGetHead();
+		const result = await attemptCommit(message);
+		const headAfter = await safeGetHead();
+		if (!result.ok && headBefore === headAfter) debug("Excluded files commit failed, continuing without them");
+	}
+	if (included.length === 0) {
+		process.exitCode = EXIT_CODES.SUCCESS;
+		writeAgentResult({
+			status: "success",
+			commits: []
+		});
+		return;
+	}
+	const config = await readConfig();
+	const provider = isValidProvider(config.provider ?? "groq") ? config.provider : "groq";
+	let apiKey;
+	try {
+		apiKey = await getProviderApiKey(provider);
+	} catch {
+		process.exitCode = EXIT_CODES.AI;
+		writeAgentResult({
+			status: "failure",
+			commits: [],
+			errors: [`No API key found for ${provider}. Set ${PROVIDER_ENV_KEYS[provider]} env var or run 'cmint config'`]
+		});
+		return;
+	}
+	const model = getModelForProvider(config, provider, PROVIDER_CONFIGS[provider].defaultModel);
+	const timeout = config.timeout ? parseInt(config.timeout, 10) : void 0;
+	let groups;
+	try {
+		groups = validateGroups((await generateGroups(included, apiKey, model, timeout, provider, config.proxy)).groups, included);
+	} catch (err) {
+		process.exitCode = EXIT_CODES.AI;
+		writeAgentResult({
+			status: "failure",
+			commits: [],
+			errors: [err instanceof Error ? err.message : String(err)]
+		});
+		return;
+	}
+	const commits = [];
+	for (const group of groups) {
+		debug("Processing group %d/%d: %s", commits.length + 1, groups.length, group.name);
+		await resetStaging();
+		await stageFiles(group.files);
+		const groupDiff = await getStagedDiff();
+		if (!groupDiff || "excludedFiles" in groupDiff) {
+			debug(`Skipping group "${group.name}" — no diff`);
+			continue;
+		}
+		let message;
+		try {
+			message = await generateCommitMessage(groupDiff.diff, {
+				apiKey,
+				model,
+				type: config.type,
+				timeout,
+				hint: flags.hint,
+				provider,
+				proxy: config.proxy
+			});
+		} catch (err) {
+			process.exitCode = EXIT_CODES.AI;
+			writeAgentResult({
+				status: "failure",
+				commits,
+				errors: [err instanceof Error ? err.message : String(err)]
+			});
+			return;
+		}
+		await saveCachedCommit(await getRepoRoot(), message);
+		const headBefore = await safeGetHead();
+		const result = await attemptCommit(message);
+		const headAfter = await safeGetHead();
+		if (result.ok || headBefore !== headAfter) {
+			commits.push({
+				message,
+				hash: headAfter,
+				files: group.files,
+				groupName: group.name
+			});
+			continue;
+		}
+		process.exitCode = EXIT_CODES.HOOK;
+		writeAgentResult({
+			status: "failure",
+			commits,
+			errors: parseHookErrors(result.stderr ?? "").map((e) => `[${e.tool}] ${e.message}`)
+		});
+		return;
+	}
+	process.exitCode = EXIT_CODES.SUCCESS;
+	writeAgentResult({
+		status: "success",
+		commits
+	});
+}
+//#endregion
 //#region src/commands/commit-utils.ts
 /** Shared recovery menu factory — avoids repeating the same callback set */
 function makeRecoveryCallbacks(message) {
@@ -1873,6 +2223,199 @@ async function handleRetry() {
 	else process.exit(1);
 }
 //#endregion
+//#region src/commands/setup.ts
+/** Marker files for each tool. First match wins per tool. */
+const TOOL_MARKERS = {
+	biome: ["biome.json", "biome.jsonc"],
+	eslint: [
+		"eslint.config.js",
+		"eslint.config.mjs",
+		"eslint.config.ts",
+		"eslint.config.cjs",
+		".eslintrc.js",
+		".eslintrc.cjs",
+		".eslintrc.json",
+		".eslintrc.yml",
+		".eslintrc.yaml",
+		".eslintrc"
+	],
+	typescript: ["tsconfig.json"],
+	vitest: [
+		"vitest.config.js",
+		"vitest.config.mts",
+		"vitest.config.ts",
+		"vitest.config.mjs"
+	]
+};
+/** Indent for generated config — matches biome.json `indentStyle: "tab"`. */
+const TAB = "	";
+async function exists(path) {
+	try {
+		await access(path, constants.R_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Scan a directory for marker files that indicate which tools the project uses.
+* Returns a map of tool name to detected status. Order within each tool's list
+* is priority order (first match wins).
+*/
+async function detectTools(cwd) {
+	const result = {
+		biome: false,
+		eslint: false,
+		typescript: false,
+		vitest: false
+	};
+	for (const [tool, files] of Object.entries(TOOL_MARKERS)) for (const file of files) if (await exists(join(cwd, file))) {
+		result[tool] = true;
+		debug("setup: detected %s via %s", tool, file);
+		break;
+	}
+	debug("setup: detection result %o", result);
+	return result;
+}
+/**
+* Build the string content of a .cmintrc file from a detection result.
+* Returns tabs-indented TS/JS object literal with trailing commas. Biome is
+* preferred when both biome and eslint are present — overlapping globs would
+* cause both tools to run on the same files, which is wasteful and noisy.
+*/
+function buildCmintrcContent(tools) {
+	const entries = [];
+	if (tools.biome || tools.eslint) {
+		const cmd = tools.biome ? "biome check --write --no-errors-on-unmatched --error-on-warnings" : "eslint --fix";
+		const ext = tools.biome ? "{js,ts,json}" : "{js,ts}";
+		entries.push(`${TAB}"*.${ext}": "${cmd}",`);
+	}
+	const tsChecks = [];
+	if (tools.typescript) tsChecks.push("tsc --noEmit");
+	if (tools.vitest) tsChecks.push("vitest run --passWithNoTests");
+	if (tsChecks.length > 0) {
+		const body = tsChecks.map((c) => `"${c}"`).join(", ");
+		const fn = tsChecks.length === 1 ? `() => ${body}` : `() => [${body}]`;
+		entries.push(`${TAB}"*.ts": ${fn},`);
+	}
+	if (entries.length === 0) return `export default {\n};\n`;
+	return `export default {\n${entries.join("\n")}\n};\n`;
+}
+/** Choose the file extension based on whether the project uses TypeScript. */
+function pickFileName(tools) {
+	return tools.typescript ? ".cmintrc.ts" : ".cmintrc";
+}
+function formatDetection(tools) {
+	return Object.entries(tools).map(([tool, found]) => `  ${found ? green("✓") : dim("✗")} ${tool}`).join("\n");
+}
+/**
+* Interactive setup for `.cmintrc`. Detects biome/eslint/typescript/vitest in
+* the given directory, previews the generated config, and writes the file
+* after confirmation. Refuses to overwrite without explicit consent. Defaults
+* to `process.cwd()` when called from the `cmint config` menu; the preflight
+* caller passes the repo root explicitly.
+*/
+async function setupCmintrcCommand(cwd = process.cwd()) {
+	debug("setupCmintrcCommand: starting in %s", cwd);
+	const tools = await detectTools(cwd);
+	p.log.info(`Detected tools in ${bold(cwd)}:`);
+	p.log.message(formatDetection(tools));
+	if (!Object.values(tools).some(Boolean)) p.log.warn("No recognized tools found. Writing an empty config to fill in manually.");
+	else if (tools.biome && tools.eslint) p.log.warn(yellow("Both biome and eslint detected — using biome (remove this line to switch)."));
+	const fileName = pickFileName(tools);
+	const filePath = join(cwd, fileName);
+	if (await exists(filePath)) {
+		const overwrite = await p.confirm({ message: `${fileName} already exists. Overwrite?` });
+		if (p.isCancel(overwrite) || !overwrite) {
+			p.log.info(dim("Cancelled — existing file left untouched."));
+			return;
+		}
+	}
+	const content = buildCmintrcContent(tools);
+	p.log.info(dim(`\nPreview of ${fileName}:`));
+	p.log.message(dim(content));
+	const confirm = await p.confirm({ message: `Write ${fileName}?` });
+	if (p.isCancel(confirm) || !confirm) {
+		p.log.info(dim("Cancelled."));
+		return;
+	}
+	await writeFile(filePath, content, "utf-8");
+	debug("setupCmintrcCommand: wrote %s", filePath);
+	p.log.success(green(`Wrote ${fileName}`));
+}
+/** Project-local marker file that suppresses the preflight prompt forever. */
+const SKIP_SETUP_MARKER = ".cmint-skip-setup";
+/** True if at least one of biome/eslint/typescript/vitest is present. */
+function isAutoConfigurable(tools) {
+	return Object.values(tools).some(Boolean);
+}
+/** True if the skip-setup marker exists in `cwd`. */
+async function hasSkipSetupMarker(cwd) {
+	return exists(join(cwd, SKIP_SETUP_MARKER));
+}
+/** Write the skip-setup marker to `cwd`. The file is empty by design. */
+async function writeSkipSetupMarker(cwd) {
+	const filePath = join(cwd, SKIP_SETUP_MARKER);
+	await writeFile(filePath, "", "utf-8");
+	debug("preflight: wrote skip-setup marker to %s", filePath);
+}
+/**
+* One-shot prompt run at the start of `cmint`. Skips silently if the user
+* already has a `.cmintrc` or has previously opted out (`.cmint-skip-setup`).
+* If the project is auto-configurable, asks the user whether to run setup
+* now. Choices: `yes` runs the standard setup flow; `no` proceeds without
+* setup and re-prompts next time; `never` writes a marker to suppress the
+* prompt for this project forever.
+*/
+async function runPreflightSetupPrompt(cwd) {
+	debug("preflight: checking %s", cwd);
+	if (await hasSkipSetupMarker(cwd)) {
+		debug("preflight: skip-setup marker present, skipping prompt");
+		return;
+	}
+	const existingConfig = await detectConfig(cwd);
+	if (existingConfig) {
+		debug("preflight: .cmintrc present at %s, skipping prompt", existingConfig);
+		return;
+	}
+	if (!isAutoConfigurable(await detectTools(cwd))) {
+		debug("preflight: project not auto-configurable, skipping prompt");
+		return;
+	}
+	const choice = await p.select({
+		message: "No .cmintrc found. Run setup to create one from detected tools?",
+		options: [
+			{
+				label: "Yes, set up .cmintrc",
+				value: "yes"
+			},
+			{
+				label: "No, skip for now",
+				value: "no"
+			},
+			{
+				label: "No, don't ask again",
+				value: "never"
+			}
+		]
+	});
+	if (p.isCancel(choice)) {
+		debug("preflight: user cancelled prompt");
+		return;
+	}
+	if (choice === "never") {
+		await writeSkipSetupMarker(cwd);
+		p.log.info(dim(`Won't ask again. Delete ${SKIP_SETUP_MARKER} to re-enable.`));
+		return;
+	}
+	if (choice === "no") {
+		p.log.info(dim("Skipping .cmintrc setup."));
+		return;
+	}
+	debug("preflight: user chose yes, running setup");
+	await setupCmintrcCommand(cwd);
+}
+//#endregion
 //#region src/ui/staging-menu.ts
 async function showStagingMenu(files, hasChecks) {
 	debug("showStagingMenu: %d files", files.length);
@@ -2035,7 +2578,8 @@ async function runPreCommitChecks(changedFiles, noCheck) {
 		});
 		if (menuResult === "cancelled") process.exit(1);
 		if (menuResult === "retried") {
-			debug("Re-running checks after retry...");
+			debug("Re-staging files and re-running checks after retry...");
+			await stageAll();
 			const ckSpinner = spinner();
 			ckSpinner.start("Running checks...");
 			checkResults = await runAllChecks(checkRoot, stagedFileList, 6e4);
@@ -2058,6 +2602,8 @@ async function commitCommand(flags) {
 	debug("commitCommand called", { flags });
 	await assertGitRepo();
 	if (flags.retry) return handleRetry();
+	const repoRoot = await getRepoRoot();
+	await runPreflightSetupPrompt(repoRoot);
 	intro("🌿 commit-mint");
 	const status = await getStatusShort();
 	debug("Git status:", status || "(empty)");
@@ -2104,7 +2650,7 @@ async function commitCommand(flags) {
 		debug("All staged files are excluded:", diffResult.excludedFiles);
 		const message = buildExcludedFilesMessage(diffResult.excludedFiles);
 		log.info(diffResult.excludedFiles.map((f) => `     ${f}`).join("\n"));
-		await saveCachedCommit(await getRepoRoot(), message);
+		await saveCachedCommit(repoRoot, message);
 		s.start("Running pre-commit hooks...");
 		const result = await commitWithRecovery(message, s, await getHead());
 		if (result === "committed") {
@@ -2163,7 +2709,6 @@ async function commitCommand(flags) {
 		return;
 	}
 	message = reviewed;
-	const repoRoot = await getRepoRoot();
 	await saveCachedCommit(repoRoot, message);
 	debug("Message cached for repo:", repoRoot);
 	s.start("Running pre-commit hooks...");
@@ -2347,13 +2892,20 @@ async function configCommand() {
 		p.note(buildConfigDisplay(config), "commit-mint config");
 		const action = await p.select({
 			message: "What would you like to do?",
-			options: [{
-				label: "Edit settings",
-				value: "edit"
-			}, {
-				label: "Done",
-				value: "done"
-			}]
+			options: [
+				{
+					label: "Edit settings",
+					value: "edit"
+				},
+				{
+					label: "Setup .cmintrc",
+					value: "setup"
+				},
+				{
+					label: "Done",
+					value: "done"
+				}
+			]
 		});
 		if (p.isCancel(action)) {
 			debug("configCommand: cancelled at main menu");
@@ -2365,10 +2917,49 @@ async function configCommand() {
 			p.outro("Config saved.");
 			return;
 		}
+		if (action === "setup") {
+			debug("configCommand: starting .cmintrc setup");
+			await setupCmintrcCommand();
+			continue;
+		}
 		await editSettingsLoop(config);
 	}
 }
 //#endregion
+//#region src/commands/logs.ts
+const LOG_PATH = join(os.homedir(), ".cache", "commit-mint", "debug.log");
+const SESSION_SEPARATOR = /^--- session .+ ---$/;
+async function logsCommand(flags) {
+	let content;
+	try {
+		content = await readFile(LOG_PATH, "utf8");
+	} catch (err) {
+		if (err.code === "ENOENT") {
+			console.error("No debug logs found. Run cmint with any command first.");
+			process.exit(1);
+		}
+		throw err;
+	}
+	if (content.trim() === "") {
+		console.error("No debug logs found. Run cmint with any command first.");
+		process.exit(1);
+	}
+	const allLines = content.split("\n");
+	let lastSessionIndex = -1;
+	for (let i = allLines.length - 1; i >= 0; i--) if (SESSION_SEPARATOR.test(allLines[i])) {
+		lastSessionIndex = i;
+		break;
+	}
+	const sessionLines = lastSessionIndex === -1 ? allLines : allLines.slice(lastSessionIndex + 1);
+	const filtered = sessionLines.filter((line) => line.length > 0 || sessionLines.indexOf(line) === 0);
+	if (filtered.length === 0) {
+		console.error("No debug logs found. Run cmint with any command first.");
+		process.exit(1);
+	}
+	const lines = flags.lines !== void 0 && flags.lines > 0 ? filtered.slice(-flags.lines) : filtered;
+	for (const line of lines) console.log(line);
+}
+//#endregion
 //#region src/cli.ts
 const { version } = package_default;
 cli({
@@ -2409,14 +3000,31 @@ cli({
 			description: "Skip user-defined pre-commit checks",
 			alias: "N",
 			default: false
+		},
+		agent: {
+			type: Boolean,
+			description: "AI agent mode: non-interactive auto-group with JSON output",
+			default: false
 		}
 	},
-	commands: [command({ name: "config" }, async () => {
+	commands: [command({
+		name: "logs",
+		description: "Show debug logs from the last cmint run",
+		flags: { lines: {
+			type: Number,
+			description: "Number of lines to show from the end",
+			alias: "n"
+		} }
+	}, async (argv) => {
+		await logsCommand(argv.flags);
+	}), command({ name: "config" }, async () => {
 		await configCommand();
 	})]
 }, (argv) => {
+	writeSessionHeader();
 	setDebug(argv.flags.debug);
-	commitCommand(argv.flags);
+	if (argv.flags.agent) agentCommand(argv.flags);
+	else commitCommand(argv.flags);
 });
 //#endregion
 export {};