elizaos--eliza/plugins/plugin-coding-tools/src/lib/run-git-command.ts

/**
 * `runGitCommand` helper: runs a git subcommand with `execFile` (no shell) under a
 * given cwd and timeout, brokered through the core capability router so git access
 * can be gated or denied by the host. Used by the worktree actions.
 */
import { execFile } from "node:child_process";
import { promisify } from "node:util";

import {
  CapabilityError,
  type GitOperation,
  getCapabilityRouter,
  type IAgentRuntime,
} from "@elizaos/core";

const execFileAsync = promisify(execFile);

export type RunGitCommandOptions = {
  cwd: string;
  args: string[];
  timeoutMs: number;
};

export type RunGitCommandResult = {
  routed: boolean;
  stdout: string;
  stderr: string;
  exitCode: number | null;
  signal: string | null;
};

export class GitCommandExecutionError extends Error {
  readonly stderr: string;

  constructor(message: string, stderr = "") {
    super(message);
    this.name = "GitCommandExecutionError";
    this.stderr = stderr;
  }
}

export async function runGitCommand(
  runtime: IAgentRuntime,
  opts: RunGitCommandOptions,
): Promise<RunGitCommandResult> {
  const router = getCapabilityRouter(runtime);
  if (router) {
    try {
      const result = await router.git.commandRun({
        root: opts.cwd,
        args: opts.args,
      });
      return routedResult(result.operation);
    } catch (error) {
      // error-policy:J4 only the expected "no git capability" shape
      // (CAPABILITY_UNAVAILABLE) degrades to the local-git fallback below; any
      // other router error rethrows so a real git failure surfaces instead of
      // being masked by the local path.
      if (
        error instanceof CapabilityError &&
        error.code === "CAPABILITY_UNAVAILABLE"
      ) {
        return runLocalGitCommand(opts);
      }
      throw error;
    }
  }

  return runLocalGitCommand(opts);
}

async function runLocalGitCommand(
  opts: RunGitCommandOptions,
): Promise<RunGitCommandResult> {
  const result = await execFileAsync("git", opts.args, {
    cwd: opts.cwd,
    encoding: "utf8",
    timeout: opts.timeoutMs,
  });
  return {
    routed: false,
    stdout: result.stdout,
    stderr: result.stderr,
    exitCode: 0,
    signal: null,
  };
}

function routedResult(operation: GitOperation): RunGitCommandResult {
  const exitCode = operation.exitCode ?? null;
  if (operation.status === "failed" || (exitCode !== null && exitCode !== 0)) {
    throw new GitCommandExecutionError(
      operation.error ?? `git exited with status ${exitCode}`,
      operation.stderr,
    );
  }
  return {
    routed: true,
    stdout: operation.stdout,
    stderr: operation.stderr,
    exitCode,
    signal: operation.signal ?? null,
  };
}