gatecheck 0.0.1-beta.5

package/dist/setup-BGSEp6JC.mjs

@@ -0,0 +1,441 @@
+import { n as loadConfig, r as resolveConfigPath, t as log } from "./bin.mjs";
+import { access, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import * as v from "valibot";
+import { stringify } from "yaml";
+import inquirer from "inquirer";
+
+//#region src/pm.ts
+const lockfiles = [
+	{
+		file: "pnpm-lock.yaml",
+		pm: "pnpm"
+	},
+	{
+		file: "bun.lockb",
+		pm: "bun"
+	},
+	{
+		file: "bun.lock",
+		pm: "bun"
+	},
+	{
+		file: "yarn.lock",
+		pm: "yarn"
+	},
+	{
+		file: "package-lock.json",
+		pm: "npm"
+	}
+];
+const detectPackageManager = async (cwd) => {
+	for (const { file, pm } of lockfiles) try {
+		await access(resolve(cwd, file));
+		return pm;
+	} catch {}
+	return "npm";
+};
+const executors = {
+	pnpm: "pnpm exec",
+	npm: "npx",
+	yarn: "yarn exec",
+	bun: "bunx"
+};
+const getExecutor = (pm) => executors[pm];
+const runners = {
+	pnpm: "pnpm",
+	npm: "npx",
+	yarn: "yarn",
+	bun: "bunx"
+};
+const getRunner = (pm) => runners[pm];
+
+//#endregion
+//#region src/presets.ts
+const presets = [
+	{
+		name: "prettier",
+		description: "Format with Prettier",
+		checks: { prettier: {
+			match: "\\.((m|c)?(j|t)sx?|json|css|scss|less|html|md|ya?ml)$",
+			command: "prettier --write --no-error-on-unmatched-pattern {{ ctx.CHANGED_FILES }}",
+			group: "format"
+		} }
+	},
+	{
+		name: "oxfmt",
+		description: "Format with oxfmt",
+		checks: { oxfmt: {
+			match: "\\.(m|c)?(j|t)sx?$",
+			command: "oxfmt --write --no-error-on-unmatched-pattern {{ ctx.CHANGED_FILES }}",
+			group: "format"
+		} }
+	},
+	{
+		name: "eslint",
+		description: "Lint with ESLint",
+		checks: { eslint: {
+			match: "\\.(m|c)?(j|t)sx?$",
+			command: "eslint {{ ctx.CHANGED_FILES }}",
+			group: "lint"
+		} }
+	},
+	{
+		name: "oxlint",
+		description: "Lint with oxlint",
+		checks: { oxlint: {
+			match: "\\.(m|c)?(j|t)sx?$",
+			command: "oxlint --type-aware --fix {{ ctx.CHANGED_FILES }}",
+			group: "lint"
+		} }
+	},
+	{
+		name: "biome",
+		description: "Lint & format with Biome",
+		checks: {
+			"biome-format": {
+				match: "\\.((m|c)?(j|t)sx?|json|jsonc|css)$",
+				command: "biome format --write {{ ctx.CHANGED_FILES }}",
+				group: "format"
+			},
+			"biome-check": {
+				match: "\\.((m|c)?(j|t)sx?|json|jsonc|css)$",
+				command: "biome check --write {{ ctx.CHANGED_FILES }}",
+				group: "lint"
+			}
+		}
+	},
+	{
+		name: "tsc",
+		description: "Type-check with TypeScript compiler",
+		checks: { typecheck: {
+			match: "\\.(m|c)?tsx?$",
+			command: "tsc --noEmit",
+			group: "typecheck"
+		} }
+	},
+	{
+		name: "tsgo",
+		description: "Type-check with tsgo (native TypeScript)",
+		checks: { "typecheck-tsgo": {
+			match: "\\.(m|c)?tsx?$",
+			command: "tsgo --noEmit",
+			group: "typecheck"
+		} }
+	},
+	{
+		name: "vitest",
+		description: "Run related tests with Vitest",
+		checks: { vitest: {
+			match: "\\.(m|c)?(j|t)sx?$",
+			command: "vitest related --run --passWithNoTests {{ ctx.CHANGED_FILES }}",
+			group: "test"
+		} }
+	},
+	{
+		name: "jest",
+		description: "Run related tests with Jest",
+		checks: { jest: {
+			match: "\\.(m|c)?(j|t)sx?$",
+			command: "jest --findRelatedTests --passWithNoTests {{ ctx.CHANGED_FILES }}",
+			group: "test"
+		} }
+	}
+];
+const REVIEW_PROMPT = [
+	"Changed files: {{ ctx.CHANGED_FILES }}",
+	"",
+	"You are a professional software architect.",
+	"Please review the changes above.",
+	"Point out any design issues, bug risks, or improvements."
+].join("\n");
+const reviewPresets = [{
+	name: "codex",
+	description: "Architecture review with OpenAI Codex",
+	reviews: { "codex-review": {
+		match: ".*",
+		exclude: "**/*.md",
+		vars: { prompt: REVIEW_PROMPT },
+		command: "codex exec --sandbox 'workspace-write' {{ vars.prompt }}"
+	} }
+}, {
+	name: "claude",
+	description: "Architecture review with Claude Code",
+	reviews: { "claude-review": {
+		match: ".*",
+		exclude: "**/*.md",
+		vars: { prompt: REVIEW_PROMPT },
+		command: "claude --permission-mode 'auto' -p {{ vars.prompt }}"
+	} }
+}];
+
+//#endregion
+//#region src/setup.ts
+const DEFAULT_CHANGED = "untracked,unstaged,staged,branch:main";
+const DEFAULT_TARGET = "all";
+const promptDefaults = async (existing) => {
+	const answers = await inquirer.prompt([{
+		type: "input",
+		name: "changed",
+		message: "Default changed sources (comma-separated):",
+		default: existing?.changed ?? DEFAULT_CHANGED
+	}, {
+		type: "input",
+		name: "target",
+		message: "Default target groups (comma-separated or 'all'):",
+		default: existing?.target ?? DEFAULT_TARGET
+	}]);
+	return {
+		changed: answers.changed,
+		target: answers.target
+	};
+};
+const resolveDefaults = (existing) => ({
+	changed: existing?.changed ?? DEFAULT_CHANGED,
+	target: existing?.target ?? DEFAULT_TARGET
+});
+const presetDependencies = {
+	prettier: ["prettier"],
+	oxfmt: ["oxfmt"],
+	eslint: ["eslint"],
+	oxlint: ["oxlint"],
+	biome: ["@biomejs/biome"],
+	tsc: ["typescript"],
+	tsgo: ["@typescript/native-preview"],
+	vitest: ["vitest"],
+	jest: ["jest"]
+};
+const PackageJsonSchema = v.object({
+	dependencies: v.optional(v.record(v.string(), v.string())),
+	devDependencies: v.optional(v.record(v.string(), v.string()))
+});
+const readInstalledDeps = async (cwd) => {
+	try {
+		const raw = await readFile(join(cwd, "package.json"), "utf-8");
+		const json = JSON.parse(raw);
+		const pkg = v.parse(PackageJsonSchema, json);
+		const deps = /* @__PURE__ */ new Set();
+		if (pkg.dependencies !== void 0) for (const name of Object.keys(pkg.dependencies)) deps.add(name);
+		if (pkg.devDependencies !== void 0) for (const name of Object.keys(pkg.devDependencies)) deps.add(name);
+		return deps;
+	} catch {
+		return /* @__PURE__ */ new Set();
+	}
+};
+const prefixCommand = (command, executor) => `${executor} ${command}`;
+const isPresetDetected = (presetName, existingNames, installedDeps) => {
+	const preset = presets.find((p) => p.name === presetName);
+	if (preset !== void 0 && Object.keys(preset.checks).some((k) => existingNames.has(k))) return true;
+	const deps = presetDependencies[presetName];
+	if (deps !== void 0 && deps.some((d) => installedDeps.has(d))) return true;
+	return false;
+};
+const toCheckEntries = (selected, existingChecks, executor) => {
+	const existingByName = new Map(existingChecks.map((c) => [c.name, c]));
+	return selected.flatMap((name) => {
+		const preset = presets.find((p) => p.name === name);
+		if (preset === void 0) return [];
+		const checks = preset.checks;
+		return Object.entries(checks).map(([checkName, checkConfig]) => {
+			const existing = existingByName.get(checkName);
+			if (existing !== void 0) return existing;
+			return {
+				name: checkName,
+				match: checkConfig.match,
+				group: checkConfig.group,
+				command: prefixCommand(checkConfig.command, executor)
+			};
+		});
+	});
+};
+const promptPresets = async (existingChecks, executor, installedDeps) => {
+	const existingNames = new Set(existingChecks.map((c) => c.name));
+	const { selected } = await inquirer.prompt([{
+		type: "checkbox",
+		name: "selected",
+		message: "Select checks to add:",
+		choices: presets.map((p) => ({
+			name: `${p.name} - ${p.description}`,
+			value: p.name,
+			checked: isPresetDetected(p.name, existingNames, installedDeps)
+		}))
+	}]);
+	return toCheckEntries(selected, existingChecks, executor);
+};
+const autoSelectPresets = (existingChecks, executor, installedDeps) => {
+	const existingNames = new Set(existingChecks.map((c) => c.name));
+	return toCheckEntries(presets.filter((p) => isPresetDetected(p.name, existingNames, installedDeps)).map((p) => p.name), existingChecks, executor);
+};
+const toReviewEntries = (selected, existingReviews) => {
+	const existingByName = new Map(existingReviews.map((r) => [r.name, r]));
+	return selected.flatMap((name) => {
+		const preset = reviewPresets.find((p) => p.name === name);
+		if (preset === void 0) return [];
+		const reviews = preset.reviews;
+		return Object.entries(reviews).map(([reviewName, reviewConfig]) => {
+			const existing = existingByName.get(reviewName);
+			if (existing !== void 0) return existing;
+			return {
+				name: reviewName,
+				...reviewConfig
+			};
+		});
+	});
+};
+const promptReviewPresets = async (existingReviews) => {
+	const { selected } = await inquirer.prompt([{
+		type: "select",
+		name: "selected",
+		message: "Select a review preset:",
+		choices: [...reviewPresets.map((p) => ({
+			name: `${p.name} - ${p.description}`,
+			value: p.name
+		})), {
+			name: "none - Skip review setup",
+			value: "none"
+		}]
+	}]);
+	if (selected === "none") return existingReviews;
+	return toReviewEntries([selected], existingReviews);
+};
+const StopHookEntrySchema = v.object({
+	matcher: v.string(),
+	hooks: v.array(v.object({
+		type: v.string(),
+		command: v.string()
+	}))
+});
+const ClaudeSettingsSchema = v.looseObject({ hooks: v.optional(v.looseObject({ Stop: v.optional(v.array(StopHookEntrySchema)) })) });
+const resolveClaudeSettingsPath = (cwd) => join(cwd, ".claude", "settings.json");
+const readClaudeSettings = async (path) => {
+	try {
+		const raw = await readFile(path, "utf-8");
+		const json = JSON.parse(raw);
+		return v.parse(ClaudeSettingsSchema, json);
+	} catch {
+		return {};
+	}
+};
+const hasStopHook = (settings, command) => {
+	return (settings.hooks?.Stop ?? []).some((entry) => entry.hooks.some((h) => h.command === command));
+};
+const promptClaudeCodeHooks = async (cwd, runner) => {
+	const settingsPath = resolveClaudeSettingsPath(cwd);
+	const command = `${runner} gatecheck check --format claude-code-hooks`;
+	const settings = await readClaudeSettings(settingsPath);
+	if (hasStopHook(settings, command)) {
+		log("Claude Code Stop hook is already configured.");
+		return;
+	}
+	const { enable } = await inquirer.prompt([{
+		type: "confirm",
+		name: "enable",
+		message: "Set up Claude Code Stop hook? This runs checks before Claude finishes and blocks it from stopping if any check fails.",
+		default: true
+	}]);
+	if (!enable) return;
+	const hookEntry = {
+		matcher: "",
+		hooks: [{
+			type: "command",
+			command
+		}]
+	};
+	const existingStop = settings.hooks?.Stop ?? [];
+	const updated = {
+		...settings,
+		hooks: {
+			...settings.hooks,
+			Stop: [...existingStop, hookEntry]
+		}
+	};
+	await mkdir(dirname(settingsPath), { recursive: true });
+	await writeFile(settingsPath, `${JSON.stringify(updated, null, 2)}\n`);
+	log(`Claude Code hook written to ${settingsPath}`);
+};
+const CopilotHookEntrySchema = v.object({
+	type: v.string(),
+	bash: v.string()
+});
+const CopilotHooksFileSchema = v.looseObject({
+	version: v.number(),
+	hooks: v.optional(v.looseObject({ agentStop: v.optional(v.array(CopilotHookEntrySchema)) }))
+});
+const resolveCopilotHooksPath = (cwd) => join(cwd, ".github", "hooks", "gatecheck.json");
+const readCopilotHooksFile = async (path) => {
+	try {
+		const raw = await readFile(path, "utf-8");
+		const json = JSON.parse(raw);
+		return v.parse(CopilotHooksFileSchema, json);
+	} catch {
+		return { version: 1 };
+	}
+};
+const hasCopilotAgentStopHook = (config, bash) => {
+	return (config.hooks?.agentStop ?? []).some((entry) => entry.bash === bash);
+};
+const promptCopilotCliHooks = async (cwd, runner) => {
+	const hooksPath = resolveCopilotHooksPath(cwd);
+	const bash = `${runner} gatecheck check --format copilot-cli-hooks`;
+	const config = await readCopilotHooksFile(hooksPath);
+	if (hasCopilotAgentStopHook(config, bash)) {
+		log("Copilot CLI agentStop hook is already configured.");
+		return;
+	}
+	const { enable } = await inquirer.prompt([{
+		type: "confirm",
+		name: "enable",
+		message: "Set up Copilot CLI agentStop hook? This runs checks before Copilot finishes and blocks it from stopping if any check fails.",
+		default: true
+	}]);
+	if (!enable) return;
+	const hookEntry = {
+		type: "command",
+		bash
+	};
+	const existingAgentStop = config.hooks?.agentStop ?? [];
+	const updated = {
+		...config,
+		version: config.version,
+		hooks: {
+			...config.hooks,
+			agentStop: [...existingAgentStop, hookEntry]
+		}
+	};
+	await mkdir(dirname(hooksPath), { recursive: true });
+	await writeFile(hooksPath, `${JSON.stringify(updated, null, 2)}\n`);
+	log(`Copilot CLI hook written to ${hooksPath}`);
+};
+const runSetup = async (cwd, options) => {
+	const nonInteractive = options?.nonInteractive === true;
+	let existing;
+	try {
+		existing = await loadConfig(cwd);
+	} catch {}
+	log("gatecheck setup\n");
+	const pm = await detectPackageManager(cwd);
+	const executor = getExecutor(pm);
+	const runner = getRunner(pm);
+	log(`Detected package manager: ${pm}\n`);
+	const installedDeps = existing !== void 0 ? /* @__PURE__ */ new Set() : await readInstalledDeps(cwd);
+	const defaults = nonInteractive ? resolveDefaults(existing?.defaults) : await promptDefaults(existing?.defaults);
+	const checks = nonInteractive ? autoSelectPresets(existing?.checks ?? [], executor, installedDeps) : await promptPresets(existing?.checks ?? [], executor, installedDeps);
+	const reviews = nonInteractive ? existing?.reviews ?? [] : await promptReviewPresets(existing?.reviews ?? []);
+	const config = {
+		defaults,
+		checks,
+		...reviews.length > 0 ? { reviews } : {}
+	};
+	const configPath = resolveConfigPath(cwd);
+	await writeFile(configPath, stringify(config, { lineWidth: 120 }));
+	log(`\nConfig written to ${configPath}`);
+	if (!nonInteractive) {
+		log("");
+		await promptClaudeCodeHooks(cwd, runner);
+		log("");
+		await promptCopilotCliHooks(cwd, runner);
+	}
+};
+
+//#endregion
+export { runSetup };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "gatecheck",
+  "version": "0.0.1-beta.5",
+  "description": "Quality gate for git changes — run checks and AI reviews against changed files",
+  "license": "MIT",
+  "bin": {
+    "gatecheck": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "dependencies": {
+    "commander": "14.0.3",
+    "inquirer": "13.3.0",
+    "valibot": "1.2.0",
+    "yaml": "2.8.2"
+  },
+  "devDependencies": {
+    "@tsconfig/strictest": "2.0.8",
+    "@types/inquirer": "9.0.9",
+    "@types/node": "25.3.3",
+    "@valibot/to-json-schema": "1.5.0",
+    "lefthook": "2.1.2",
+    "npm-run-all2": "8.0.4",
+    "oxfmt": "0.36.0",
+    "oxlint": "1.51.0",
+    "oxlint-tsgolint": "0.16.0",
+    "release-it": "19.2.4",
+    "release-it-pnpm": "4.6.6",
+    "tsdown": "0.20.3",
+    "tsx": "4.21.0",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "cli": "tsx ./src/bin.ts",
+    "test": "vitest run",
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "run-s lint:*",
+    "lint:oxlint": "oxlint --type-aware --type-check --ignore-path .gitignore --report-unused-disable-directives --tsconfig ./tsconfig.json",
+    "lint:oxfmt": "pnpm fix:oxfmt --check",
+    "fix": "run-s fix:*",
+    "fix:oxlint": "pnpm lint:oxlint --fix --fix-suggestions --fix-dangerously",
+    "fix:oxfmt": "oxfmt --ignore-path .gitignore --no-error-on-unmatched-pattern"
+  }
+}