Skip to content

The one and only agent harness for complex codebases. Project memory, planning, execution, and verified completion inside Codex.

5.9 KB
Raw Blame
#!/usr/bin/env node

// components/git-bash/src/codex-hook.ts
import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
import { homedir } from "node:os";
import { dirname, join } from "node:path";
var BASH_TOOL_NAME = "Bash";
var REMINDER = "On Windows, prefer the OMO git_bash MCP for shell commands before using built-in exec_command. Use exec_command only when git_bash is unavailable or for non-shell operations. " + "In code mode, these tools may be deferred: inspect ALL_TOOLS with exec to discover the actual git_bash run, diagnose, and which_bash tool names, then invoke the matching entries through the tools object inside exec before treating git_bash as unavailable. Do not issue deferred names as top-level tool calls.";
function parsePreToolUsePayload(raw) {
  if (raw.trim().length === 0)
    return null;
  try {
    const parsed = JSON.parse(raw);
    return isPreToolUsePayload(parsed) ? parsed : null;
  } catch (error) {
    if (error instanceof SyntaxError)
      return null;
    return null;
  }
}
function parsePostCompactPayload(raw) {
  if (raw.trim().length === 0)
    return null;
  try {
    const parsed = JSON.parse(raw);
    return isPostCompactPayload(parsed) ? parsed : null;
  } catch (error) {
    if (error instanceof SyntaxError)
      return null;
    return null;
  }
}
function applyGitBashPreToolUseReminder(payload, options = {}) {
  if (payload.hook_event_name !== "PreToolUse")
    return "";
  if (payload.tool_name !== BASH_TOOL_NAME)
    return "";
  if (!isWindowsHost(options))
    return "";
  const markerPath = reminderMarkerPath(payload.session_id, options.pluginDataRoot);
  if (hasReminderMarker(markerPath))
    return "";
  mkdirSync(dirname(markerPath), { recursive: true });
  writeFileSync(markerPath, `${new Date().toISOString()}
`);
  const output = {
    hookSpecificOutput: {
      hookEventName: "PreToolUse",
      additionalContext: REMINDER
    }
  };
  return `${JSON.stringify(output)}
`;
}
function applyGitBashPostCompactReset(payload, options = {}) {
  if (payload.hook_event_name !== "PostCompact")
    return "";
  rmSync(reminderMarkerPath(payload.session_id, options.pluginDataRoot), { force: true });
  return "";
}
async function runGitBashHookCli(stdin, stdout, eventName = "pre-tool-use", options = {}) {
  try {
    const raw = await readAll(stdin);
    const output = eventName === "post-compact" ? postCompactOutput(raw, options) : preToolUseOutput(raw, options);
    if (output.length > 0)
      stdout.write(output);
  } catch (error) {
    if (error instanceof Error)
      return;
    return;
  }
}
function preToolUseOutput(raw, options) {
  const payload = parsePreToolUsePayload(raw);
  if (payload === null)
    return "";
  return applyGitBashPreToolUseReminder(payload, options);
}
function postCompactOutput(raw, options) {
  const payload = parsePostCompactPayload(raw);
  if (payload === null)
    return "";
  return applyGitBashPostCompactReset(payload, options);
}
function isWindowsHost(options) {
  const platform = options.platform ?? process.platform;
  if (platform === "win32")
    return true;
  const env = options.env ?? process.env;
  return env["OS"] === "Windows_NT" || env["ComSpec"] !== undefined || env["SystemRoot"] !== undefined;
}
function hasReminderMarker(path) {
  return existsSync(path);
}
function reminderMarkerPath(sessionId, pluginDataRoot) {
  const root = pluginDataRoot ?? process.env["PLUGIN_DATA"] ?? join(homedir(), ".codex", "omo-git-bash");
  return join(root, "git-bash-reminder", `${safePathSegment(sessionId)}.seen`);
}
function safePathSegment(value) {
  return value.replace(/[^A-Za-z0-9._-]/g, "_");
}
function isPreToolUsePayload(value) {
  if (!isRecord(value))
    return false;
  return value["hook_event_name"] === "PreToolUse" && typeof value["cwd"] === "string" && typeof value["model"] === "string" && typeof value["permission_mode"] === "string" && typeof value["session_id"] === "string" && typeof value["tool_name"] === "string" && typeof value["tool_use_id"] === "string" && (value["transcript_path"] === null || typeof value["transcript_path"] === "string") && typeof value["turn_id"] === "string" && Object.hasOwn(value, "tool_input");
}
function isPostCompactPayload(value) {
  if (!isRecord(value))
    return false;
  return value["hook_event_name"] === "PostCompact" && typeof value["session_id"] === "string" && (value["transcript_path"] === undefined || value["transcript_path"] === null || typeof value["transcript_path"] === "string") && (value["trigger"] === undefined || typeof value["trigger"] === "string");
}
function isRecord(value) {
  return typeof value === "object" && value !== null && !Array.isArray(value);
}
function readAll(stdin) {
  return new Promise((resolve, reject) => {
    let data = "";
    stdin.setEncoding("utf8");
    stdin.on("data", (chunk) => {
      data += chunk instanceof Buffer ? chunk.toString() : String(chunk);
    });
    stdin.once("error", reject);
    stdin.once("end", () => resolve(data));
  });
}

// components/git-bash/src/cli.ts
var TOP_LEVEL_HELP = `Usage:
  omo-git-bash-hook hook pre-tool-use
  omo-git-bash-hook hook post-compact
  omo-git-bash-hook help | --help | -h
`;
async function main() {
  const argv = process.argv.slice(2);
  const command = argv[0];
  if (command === undefined || command === "help" || command === "--help" || command === "-h") {
    process.stdout.write(TOP_LEVEL_HELP);
    return 0;
  }
  if (command === "hook" && argv[1] === "pre-tool-use") {
    await runGitBashHookCli(process.stdin, process.stdout, "pre-tool-use");
    return 0;
  }
  if (command === "hook" && argv[1] === "post-compact") {
    await runGitBashHookCli(process.stdin, process.stdout, "post-compact");
    return 0;
  }
  process.stderr.write(`[omo-git-bash-hook] unknown command: ${argv.join(" ")}
${TOP_LEVEL_HELP}`);
  return 1;
}
main().then((code) => {
  process.exit(code);
}).catch((error) => {
  process.stderr.write(`[omo-git-bash-hook] ${error instanceof Error ? error.message : String(error)}
`);
  process.exit(1);
});