agent-roast 0.24.0 → 0.25.0

package/README.md

@@ -37,7 +37,7 @@ npx agent-roast          # review what you have not committed yet (on a clean tr
 ## Stop your coding agent from doing it
 
 ```bash
-npx agent-roast hook install          # Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot and Factory Droid
+npx agent-roast hook install          # Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid, Kiro and Antigravity CLI
 ```
 
 For Claude Code there is also a plugin: `/plugin install agent-roast --marketplace Nari-Ab/agent-roast`. Any agent that speaks
@@ -167,6 +167,8 @@ It is a review aid. It cannot prove who wrote a change or that code is correct,
 configuration, exceptions, baselines, limits) · [Comparison](docs/comparison.md) · [Measurements](docs/benchmarks.md) ·
 [Real blocks](docs/examples.md) · [Try it on your repository](docs/pilot.md) · [Contributing](CONTRIBUTING.md) · [Changelog](CHANGELOG.md)
 
+[MCP server setup](docs/integrations.md#mcp-server) · [![MCPRush scan grade for the Agent Roast MCP server](https://mcprush.com/badge/agent-roast-mcp/score.svg)](https://mcprush.com/nari-ab/agent-roast-mcp)
+
 Found a finding that was wrong, or a shortcut it missed? That is the most useful report there is:
 [open an issue](https://github.com/Nari-Ab/agent-roast/issues/new/choose).
 

package/dist/{chunk-U5MFYERX.js → chunk-ELOEHPEC.js}

@@ -5095,7 +5095,7 @@ function formatReplayTerminal(result, allRules = false) {
 // src/hook.ts
 import path8 from "path";
 import * as fs7 from "fs/promises";
-var HOOK_AGENTS = ["claude", "codex", "cursor", "gemini", "copilot", "droid"];
+var HOOK_AGENTS = ["claude", "codex", "cursor", "gemini", "copilot", "droid", "kiro", "antigravity"];
 var DEFAULT_TIMEOUT_MS = 25e3;
 var PAUSE_FILE = "agent-roast-hook-paused";
 var LISTED = 6;
@@ -5103,14 +5103,16 @@ var LISTED_WARNINGS = 3;
 function detectAgent(input) {
   if ("workspace_roots" in input || "cursor_version" in input || "conversation_id" in input) return "cursor";
   if (input.hook_event_name === "AfterAgent" || "prompt_response" in input) return "gemini";
+  if ("conversationId" in input || "fullyIdle" in input) return "antigravity";
   if ("turn_id" in input) return "codex";
   return "claude";
 }
 function inputCwd(agent, input, env) {
   const roots = input.workspace_roots;
   if (agent === "cursor" && Array.isArray(roots) && typeof roots[0] === "string") return roots[0];
+  if (agent === "antigravity" && Array.isArray(input.workspacePaths) && typeof input.workspacePaths[0] === "string") return input.workspacePaths[0];
   if (typeof input.cwd === "string" && input.cwd) return input.cwd;
-  return env.CLAUDE_PROJECT_DIR || env.CURSOR_PROJECT_DIR || env.GEMINI_PROJECT_DIR || env.FACTORY_PROJECT_DIR || process.cwd();
+  return env.CLAUDE_PROJECT_DIR || env.CURSOR_PROJECT_DIR || env.GEMINI_PROJECT_DIR || env.FACTORY_PROJECT_DIR || env.KIRO_PROJECT_DIR || env.ANTIGRAVITY_PROJECT_DIR || process.cwd();
 }
 function clip(text, limit) {
   const flat = terminalText(text).replace(/\s+/g, " ").trim();
@@ -5174,7 +5176,7 @@ function parseDuration(text) {
   if (!match || Number(match[1]) < 1) throw new ConfigError("Use a duration such as 30m, 2h or 1d.");
   return Number(match[1]) * { m: 6e4, h: 36e5, d: 864e5 }[match[2].toLowerCase()];
 }
-var outcome = (action, stdout = "", stderr = "", result) => ({ action, stdout, stderr, exitCode: 0, result });
+var outcome = (action, stdout = "", stderr = "", result, exitCode = 0) => ({ action, stdout, stderr, exitCode, result });
 async function runHook(rawInput, options = {}) {
   const env = options.env ?? process.env;
   let input = {};
@@ -5205,16 +5207,25 @@ async function runHook(rawInput, options = {}) {
   } finally {
     clearTimeout(timer);
   }
-  if (!result.failedRules.length) return outcome("pass", agent === "cursor" || agent === "gemini" ? "{}\n" : "", "", result);
+  if (!result.failedRules.length) {
+    const fine = agent === "cursor" || agent === "gemini" ? "{}\n" : agent === "antigravity" ? '{"decision":"stop"}\n' : "";
+    return outcome("pass", fine, "", result);
+  }
   const alreadyAsked = input.stop_hook_active === true || typeof input.loop_count === "number" && input.loop_count > 0;
   if (alreadyAsked || advisory) {
     const warning = formatUserWarning(result);
+    if (agent === "kiro") return outcome("warn", "", advisory ? `${warning}
+` : "", result);
+    if (agent === "antigravity") return outcome("warn", '{"decision":"stop"}\n', advisory ? `${warning}
+` : "", result);
     const notice = agent === "copilot" ? { type: "progress", message: warning } : { systemMessage: warning };
     return outcome("warn", agent === "cursor" ? "{}\n" : JSON.stringify(notice) + "\n", agent === "cursor" && advisory ? `${warning}
 ` : "", result);
   }
   const message = formatAgentFeedback(result);
-  const answer = agent === "cursor" ? { followup_message: message } : { decision: agent === "gemini" ? "deny" : "block", reason: message };
+  if (agent === "kiro") return outcome("block", "", `${message}
+`, result, 1);
+  const answer = agent === "cursor" ? { followup_message: message } : agent === "antigravity" ? { decision: "continue", reason: message } : { decision: agent === "gemini" ? "deny" : "block", reason: message };
   return outcome("block", JSON.stringify(answer) + "\n", "", result);
 }
 
@@ -5225,9 +5236,18 @@ import path9 from "path";
 import { randomUUID as randomUUID4 } from "crypto";
 import { createRequire as createRequire2 } from "module";
 import { spawnSync as spawnSync3 } from "child_process";
-var AGENT_LABELS = { claude: "Claude Code", codex: "Codex", cursor: "Cursor", gemini: "Gemini CLI", copilot: "GitHub Copilot", droid: "Factory Droid" };
+var AGENT_LABELS = {
+  claude: "Claude Code",
+  codex: "Codex",
+  cursor: "Cursor",
+  gemini: "Gemini CLI",
+  copilot: "GitHub Copilot",
+  droid: "Factory Droid",
+  kiro: "Kiro",
+  antigravity: "Antigravity CLI"
+};
 var TIMEOUT_SECONDS = 60;
-var FINISH_EVENT = { claude: "Stop", codex: "Stop", cursor: "stop", gemini: "AfterAgent", copilot: "Stop", droid: "Stop" };
+var FINISH_EVENT = { claude: "Stop", codex: "Stop", cursor: "stop", gemini: "AfterAgent", copilot: "Stop", droid: "Stop", kiro: "Stop", antigravity: "Stop" };
 function packageVersion() {
   const require3 = createRequire2(import.meta.url);
   return String(require3("../package.json").version);
@@ -5257,6 +5277,8 @@ function hookConfigPath(agent, scope, root, home, env = process.env) {
   if (agent === "gemini") return path9.join(scope === "global" ? home : root, ".gemini", "settings.json");
   if (agent === "copilot") return path9.join(scope === "global" ? env.COPILOT_HOME || path9.join(home, ".copilot") : path9.join(root, ".github"), "hooks", "agent-roast.json");
   if (agent === "droid") return path9.join(scope === "global" ? home : root, ".factory", "hooks.json");
+  if (agent === "kiro") return path9.join(scope === "global" ? home : root, ".kiro", "hooks", "agent-roast.json");
+  if (agent === "antigravity") return path9.join(scope === "global" ? path9.join(home, ".gemini", "config") : path9.join(root, ".agents"), "hooks.json");
   return path9.join(scope === "global" ? env.CODEX_HOME || path9.join(home, ".codex") : path9.join(root, ".codex"), "hooks.json");
 }
 function readJsonFile(file) {
@@ -5293,21 +5315,34 @@ function writeJsonFile(link, json) {
 }
 var asArray = (value) => Array.isArray(value) ? value : [];
 var isObject = (value) => Boolean(value) && typeof value === "object" && !Array.isArray(value);
+var containerKey = (agent) => agent === "antigravity" ? "agent-roast" : "hooks";
 function eventMap(agent, data, create) {
   if (agent === "droid") return data;
-  if (create && !isObject(data.hooks)) data.hooks = {};
-  return isObject(data.hooks) ? data.hooks : void 0;
+  const key = containerKey(agent);
+  if (create && !isObject(data[key])) data[key] = {};
+  return isObject(data[key]) ? data[key] : void 0;
 }
-var isFlat = (agent) => agent === "cursor" || agent === "copilot";
+var isFlat = (agent) => agent === "cursor" || agent === "copilot" || agent === "antigravity";
 function addStopHook(agent, data, command) {
   const before = JSON.stringify(data);
+  if (agent === "kiro") {
+    data.version ??= "v1";
+    const hooks = asArray(data.hooks);
+    const ours = hooks.find((hook) => isOurs(hook?.action?.command));
+    if (ours) ours.action.command = command;
+    else hooks.push({ name: "agent-roast", trigger: FINISH_EVENT.kiro, action: { type: "command", command }, timeout: TIMEOUT_SECONDS });
+    data.hooks = hooks;
+    return JSON.stringify(data) !== before;
+  }
   const events = eventMap(agent, data, true), event = FINISH_EVENT[agent];
   if (isFlat(agent)) {
-    data.version ??= 1;
+    if (agent !== "antigravity") data.version ??= 1;
     const handlers = asArray(events[event]);
     const ours = handlers.find((handler) => isOurs(handler?.command));
     if (ours) ours.command = command;
-    else handlers.push(agent === "cursor" ? { command, timeout: TIMEOUT_SECONDS, loop_limit: 2 } : { type: "command", command, timeoutSec: TIMEOUT_SECONDS });
+    else handlers.push(
+      agent === "cursor" ? { command, timeout: TIMEOUT_SECONDS, loop_limit: 2 } : agent === "antigravity" ? { type: "command", command, timeout: TIMEOUT_SECONDS } : { type: "command", command, timeoutSec: TIMEOUT_SECONDS }
+    );
     events[event] = handlers;
   } else {
     const groups = asArray(events[event]);
@@ -5320,6 +5355,12 @@ function addStopHook(agent, data, command) {
 }
 function removeStopHook(agent, data) {
   const before = JSON.stringify(data);
+  if (agent === "kiro") {
+    const kept = asArray(data.hooks).filter((hook) => !isOurs(hook?.action?.command));
+    if (kept.length) data.hooks = kept;
+    else delete data.hooks;
+    return JSON.stringify(data) !== before;
+  }
   const events = eventMap(agent, data, false), event = FINISH_EVENT[agent];
   if (!events) return false;
   if (isFlat(agent)) {
@@ -5332,7 +5373,7 @@ function removeStopHook(agent, data) {
     if (kept.length) events[event] = kept;
     else delete events[event];
   }
-  if (events !== data && !Object.keys(events).length) delete data.hooks;
+  if (events !== data && !Object.keys(events).length) delete data[containerKey(agent)];
   return JSON.stringify(data) !== before;
 }
 function context(options) {
@@ -5362,16 +5403,19 @@ function uninstallHooks(options) {
 function hookStatus(options) {
   const { root, home, env } = context({ ...options, scope: "project" });
   const rows = [];
-  for (const agent of ["claude", "codex", "cursor", "gemini", "copilot", "droid"]) {
+  for (const agent of ["claude", "codex", "cursor", "gemini", "copilot", "droid", "kiro", "antigravity"]) {
     for (const scope of ["project", "local", "global"]) {
       if (scope === "local" && agent !== "claude") continue;
       const file = hookConfigPath(agent, scope, root, home, env);
       let command;
       try {
         const data = readJsonFile(file).data;
-        const listed = asArray(eventMap(agent, data, false)?.[FINISH_EVENT[agent]]);
-        const handlers = isFlat(agent) ? listed : listed.flatMap((group) => asArray(group?.hooks));
-        command = handlers.map((handler) => handler?.command).find(isOurs);
+        if (agent === "kiro") command = asArray(data.hooks).map((hook) => hook?.action?.command).find(isOurs);
+        else {
+          const listed = asArray(eventMap(agent, data, false)?.[FINISH_EVENT[agent]]);
+          const handlers = isFlat(agent) ? listed : listed.flatMap((group) => asArray(group?.hooks));
+          command = handlers.map((handler) => handler?.command).find(isOurs);
+        }
       } catch {
       }
       rows.push({ agent, scope, file, command, installed: Boolean(command), advisory: isAdvisory(command), action: command ? "unchanged" : "absent" });

package/dist/cli.js

@@ -38,7 +38,7 @@ import {
   terminalText,
   uninstallHooks,
   writeBaseline
-} from "./chunk-U5MFYERX.js";
+} from "./chunk-ELOEHPEC.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -100,7 +100,7 @@ function isDefaultInvocation(options) {
 var NEXT_STEPS = [
   "",
   pc.bold("Next steps"),
-  `  ${pc.cyan("npx agent-roast hook install")}   stop your coding agent from weakening checks (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid)`,
+  `  ${pc.cyan("npx agent-roast hook install")}   stop your coding agent from weakening checks (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid, Kiro, Antigravity CLI)`,
   `  ${pc.cyan("npx agent-roast init --ci")}      add the pull-request check (GitHub Actions)`,
   `  ${pc.cyan("npx agent-roast demo")}           see a scripted example`,
   ""
@@ -505,7 +505,7 @@ program.command("demo").description('See what agent-roast reports for a scripted
   }
 });
 program.command("audit").description("Score the Git history by the shortcuts it adds (the original agent-roast report)").argument("[path]", "Path to git repository (default: current directory)", ".").action((repoPath) => rootAction(repoPath, { ...program.opts(), forceLegacy: true }));
-var hook = program.command("hook").description("Guard a coding agent: send it back to fix the code when it weakens a check (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid)");
+var hook = program.command("hook").description("Guard a coding agent: send it back to fix the code when it weakens a check (Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid, Kiro, Antigravity CLI)");
 hook.command("run").description("Run by the agent when it is about to finish; reads the agent's JSON on stdin and answers in its dialect").option("--agent <agent>", `${HOOK_AGENTS.join(", ")} (detected from the input when omitted)`).option("--advisory", "only warn the person; never send the agent back", false).action(async (opts) => {
   let agent;
   try {
@@ -525,13 +525,16 @@ hook.command("run").description("Run by the agent when it is about to finish; re
     process.exitCode = 0;
   }
 });
-hook.command("install").description("Add the hook to Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot or Factory Droid in this repository").argument("[agents...]", `${HOOK_AGENTS.join(", ")} (default: the agents that already have a folder in this repository)`).option("--global", "install for every repository of this user instead", false).option("--local", "Claude Code only: use .claude/settings.local.json, which stays out of Git", false).option("--command <program>", "program to run instead of 'npx --yes agent-roast@<version>', for example 'agent-roast' when installed globally").option("--advisory", "try it without risk: the hook only warns you and never sends the agent back", false).option("--instructions", "also write a short 'keep the checks honest' paragraph into AGENTS.md / CLAUDE.md", false).option("--dry-run", "show what would change without writing anything", false).action((names, opts) => {
+hook.command("install").description("Add the hook to Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid, Kiro or Antigravity CLI in this repository").argument("[agents...]", `${HOOK_AGENTS.join(", ")} (default: the agents that already have a folder in this repository)`).option("--global", "install for every repository of this user instead", false).option("--local", "Claude Code only: use .claude/settings.local.json, which stays out of Git", false).option("--command <program>", "program to run instead of 'npx --yes agent-roast@<version>', for example 'agent-roast' when installed globally").option("--advisory", "try it without risk: the hook only warns you and never sends the agent back", false).option("--instructions", "also write a short 'keep the checks honest' paragraph into AGENTS.md / CLAUDE.md", false).option("--dry-run", "show what would change without writing anything", false).action((names, opts) => {
   try {
     if (opts.global && opts.local) throw new ConfigError("Choose --global or --local, not both.");
     let agents = parseAgents(names);
     const root = repositoryRoot(process.cwd());
-    if (!agents.length) agents = HOOK_AGENTS.filter((agent) => fs.existsSync(path.join(root, { claude: ".claude", codex: ".codex", cursor: ".cursor", gemini: ".gemini", copilot: ".github/hooks", droid: ".factory" }[agent])));
-    if (!agents.length) throw new ConfigError("Name the agent to guard: agent-roast hook install claude (or codex, cursor, gemini, copilot, droid).");
+    if (!agents.length) agents = HOOK_AGENTS.filter((agent) => fs.existsSync(path.join(
+      root,
+      { claude: ".claude", codex: ".codex", cursor: ".cursor", gemini: ".gemini", copilot: ".github/hooks", droid: ".factory", kiro: ".kiro", antigravity: ".agents" }[agent]
+    )));
+    if (!agents.length) throw new ConfigError("Name the agent to guard: agent-roast hook install claude (or codex, cursor, gemini, copilot, droid, kiro, antigravity).");
     const scope = opts.global ? "global" : opts.local ? "local" : "project";
     const advisory = opts.advisory || program.opts().advisory === true;
     const changes = installHooks({ cwd: process.cwd(), agents, scope, command: opts.command, advisory, dryRun: opts.dryRun });
@@ -545,6 +548,8 @@ hook.command("install").description("Add the hook to Claude Code, Codex, Cursor,
     if (agents.includes("gemini")) console.log("\nGemini CLI warns the first time it sees a project hook, and again when its command changes; /hooks panel shows it.");
     if (agents.includes("copilot")) console.log("\nGitHub Copilot reads hook files when it starts: restart it. The cloud agent loads them from the default branch only.");
     if (agents.includes("droid")) console.log("\nFactory Droid takes a snapshot of its hooks at startup: restart it, and review the hook with /hooks.");
+    if (agents.includes("kiro")) console.log("\nKiro reads hooks when a session starts: restart it. Its Stop hook sends the agent back on any error; there is no documented way to tell a first try from a retry, so every run until the agent fixes it sends the agent back again.");
+    if (agents.includes("antigravity")) console.log("\nAntigravity CLI reads hooks when a session starts: restart it, or run /hooks to see what is loaded. --advisory is a one-line warning in its log, not a message to you inside the session: Antigravity CLI documents no channel for that.");
     if (!opts.dryRun && advisory) console.log("\nAdvisory mode: when the agent finishes with weakened checks you get a one-line warning and the agent is never sent back.\nStart sending it back: agent-roast hook install (without --advisory)   \xB7   remove it: agent-roast hook uninstall");
     else if (!opts.dryRun) console.log("\nWhen the agent is about to finish with weakened checks it is sent back once to fix the code.\nTurn it off for a while: agent-roast hook pause   \xB7   only warn instead: agent-roast hook install --advisory   \xB7   remove it: agent-roast hook uninstall");
   } catch (error) {
@@ -552,7 +557,7 @@ hook.command("install").description("Add the hook to Claude Code, Codex, Cursor,
     process.exitCode = 2;
   }
 });
-hook.command("uninstall").description("Remove the hook from Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot or Factory Droid").argument("[agents...]", `${HOOK_AGENTS.join(", ")} (default: all)`).option("--global", "remove it from the user-level files", false).option("--local", "Claude Code only: remove it from .claude/settings.local.json", false).option("--dry-run", "show what would change without writing anything", false).action((names, opts) => {
+hook.command("uninstall").description("Remove the hook from Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Factory Droid, Kiro or Antigravity CLI").argument("[agents...]", `${HOOK_AGENTS.join(", ")} (default: all)`).option("--global", "remove it from the user-level files", false).option("--local", "Claude Code only: remove it from .claude/settings.local.json", false).option("--dry-run", "show what would change without writing anything", false).action((names, opts) => {
   try {
     if (opts.global && opts.local) throw new ConfigError("Choose --global or --local, not both.");
     const agents = names.length ? parseAgents(names) : [...HOOK_AGENTS].filter((agent) => !(opts.local && agent !== "claude"));
@@ -572,7 +577,7 @@ hook.command("status").description("Show where the hook is installed").action(as
     const paused = await hookPausedUntil(process.cwd());
     if (paused) console.log(`
   Paused in this repository until ${paused.toLocaleString()} (agent-roast hook resume).`);
-    if (!rows.some((row) => row.installed)) console.log("\n  Install it with: agent-roast hook install claude   (or codex, cursor, gemini, copilot, droid)");
+    if (!rows.some((row) => row.installed)) console.log("\n  Install it with: agent-roast hook install claude   (or codex, cursor, gemini, copilot, droid, kiro, antigravity)");
   } catch (error) {
     console.error(`agent-roast hook status error: ${errorMessage(error)}`);
     process.exitCode = 2;

package/dist/index.d.ts

@@ -475,7 +475,7 @@ declare function replayHistory(options?: ReplayOptions): Promise<ReplayResult>;
 declare function formatReplayTerminal(result: ReplayResult, allRules?: boolean): string;
 
 /** Coding agents that can run a command when they are about to finish and feed its answer back. */
-type HookAgent = "claude" | "codex" | "cursor" | "gemini" | "copilot" | "droid";
+type HookAgent = "claude" | "codex" | "cursor" | "gemini" | "copilot" | "droid" | "kiro" | "antigravity";
 declare const HOOK_AGENTS: readonly HookAgent[];
 interface HookOptions {
     /** Which agent is calling. Detected from its input when omitted. */

package/dist/index.js

@@ -92,7 +92,7 @@ import {
   unquoteGitPath,
   validateExceptions,
   writeBaseline
-} from "./chunk-U5MFYERX.js";
+} from "./chunk-ELOEHPEC.js";
 export {
   AGENT_LABELS,
   CONFIG_FILENAMES,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-roast",
-  "version": "0.24.0",
-  "description": "Stops AI agents (and rushed humans) weakening tests, coverage gates or CI to get a green build. Hook for Claude Code, Codex, Cursor, Gemini CLI, Copilot, Droid; pre-commit; GitHub Action. Offline.",
+  "version": "0.25.0",
+  "description": "Stops AI agents (and rushed humans) weakening tests, coverage gates or CI to get a green build. Hook for 8 coding agents, pre-commit, GitHub Action. Offline.",
   "mcpName": "io.github.Nari-Ab/agent-roast",
   "type": "module",
   "main": "./dist/index.js",