feat: integrate claude-code-base-action as local subaction (#285)

* feat: integrate claude-code-base-action as local subaction

- Copy claude-code-base-action into base-action/ directory
- Update action.yml to reference ./base-action instead of external repo
- Preserve complete base action structure for future refactoring

This eliminates the external dependency while maintaining modularity.

* feat: consolidate CI workflows and add version bump workflow

- Move base-action test workflows to main .github/workflows/
- Update workflow references to use ./base-action
- Add CI jobs for base-action (test, typecheck, prettier)
- Add bump-claude-code-version workflow for base-action
- Remove redundant .github directory from base-action

This consolidates all CI workflows in one place while maintaining
full test coverage for both the main action and base-action.

* tsc

* copy again

* fix tests

* fix: use absolute path for base-action reference

Replace relative path ./base-action with ${{ github.action_path }}/base-action
to ensure the action works correctly when used in other repositories.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: inline base-action execution to support usage in other repos

Replace uses: ./base-action with direct shell execution since GitHub Actions
doesn't support dynamic paths in composite actions. This ensures the action
works correctly when used in other repositories.

Changes:
- Install Claude Code globally before execution
- Run base-action's index.ts directly with bun
- Pass all required INPUT_* environment variables
- Maintain base-action for future separate publishing

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>

base-action/src/index.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env bun
+
+import * as core from "@actions/core";
+import { preparePrompt } from "./prepare-prompt";
+import { runClaude } from "./run-claude";
+import { setupClaudeCodeSettings } from "./setup-claude-code-settings";
+import { validateEnvironmentVariables } from "./validate-env";
+
+async function run() {
+  try {
+    validateEnvironmentVariables();
+
+    await setupClaudeCodeSettings(process.env.INPUT_SETTINGS);
+
+    const promptConfig = await preparePrompt({
+      prompt: process.env.INPUT_PROMPT || "",
+      promptFile: process.env.INPUT_PROMPT_FILE || "",
+    });
+
+    await runClaude(promptConfig.path, {
+      allowedTools: process.env.INPUT_ALLOWED_TOOLS,
+      disallowedTools: process.env.INPUT_DISALLOWED_TOOLS,
+      maxTurns: process.env.INPUT_MAX_TURNS,
+      mcpConfig: process.env.INPUT_MCP_CONFIG,
+      systemPrompt: process.env.INPUT_SYSTEM_PROMPT,
+      appendSystemPrompt: process.env.INPUT_APPEND_SYSTEM_PROMPT,
+      claudeEnv: process.env.INPUT_CLAUDE_ENV,
+      fallbackModel: process.env.INPUT_FALLBACK_MODEL,
+    });
+  } catch (error) {
+    core.setFailed(`Action failed with error: ${error}`);
+    core.setOutput("conclusion", "failure");
+    process.exit(1);
+  }
+}
+
+if (import.meta.main) {
+  run();
+}

base-action/src/prepare-prompt.ts

@@ -0,0 +1,82 @@
+import { existsSync, statSync } from "fs";
+import { mkdir, writeFile } from "fs/promises";
+
+export type PreparePromptInput = {
+  prompt: string;
+  promptFile: string;
+};
+
+export type PreparePromptConfig = {
+  type: "file" | "inline";
+  path: string;
+};
+
+async function validateAndPreparePrompt(
+  input: PreparePromptInput,
+): Promise<PreparePromptConfig> {
+  // Validate inputs
+  if (!input.prompt && !input.promptFile) {
+    throw new Error(
+      "Neither 'prompt' nor 'prompt_file' was provided. At least one is required.",
+    );
+  }
+
+  if (input.prompt && input.promptFile) {
+    throw new Error(
+      "Both 'prompt' and 'prompt_file' were provided. Please specify only one.",
+    );
+  }
+
+  // Handle prompt file
+  if (input.promptFile) {
+    if (!existsSync(input.promptFile)) {
+      throw new Error(`Prompt file '${input.promptFile}' does not exist.`);
+    }
+
+    // Validate that the file is not empty
+    const stats = statSync(input.promptFile);
+    if (stats.size === 0) {
+      throw new Error(
+        "Prompt file is empty. Please provide a non-empty prompt.",
+      );
+    }
+
+    return {
+      type: "file",
+      path: input.promptFile,
+    };
+  }
+
+  // Handle inline prompt
+  if (!input.prompt || input.prompt.trim().length === 0) {
+    throw new Error("Prompt is empty. Please provide a non-empty prompt.");
+  }
+
+  const inlinePath = "/tmp/claude-action/prompt.txt";
+  return {
+    type: "inline",
+    path: inlinePath,
+  };
+}
+
+async function createTemporaryPromptFile(
+  prompt: string,
+  promptPath: string,
+): Promise<void> {
+  // Create the directory path
+  const dirPath = promptPath.substring(0, promptPath.lastIndexOf("/"));
+  await mkdir(dirPath, { recursive: true });
+  await writeFile(promptPath, prompt);
+}
+
+export async function preparePrompt(
+  input: PreparePromptInput,
+): Promise<PreparePromptConfig> {
+  const config = await validateAndPreparePrompt(input);
+
+  if (config.type === "inline") {
+    await createTemporaryPromptFile(input.prompt, config.path);
+  }
+
+  return config;
+}

base-action/src/run-claude.ts

@@ -0,0 +1,327 @@
+import * as core from "@actions/core";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { unlink, writeFile, stat } from "fs/promises";
+import { createWriteStream } from "fs";
+import { spawn } from "child_process";
+
+const execAsync = promisify(exec);
+
+const PIPE_PATH = `${process.env.RUNNER_TEMP}/claude_prompt_pipe`;
+const EXECUTION_FILE = `${process.env.RUNNER_TEMP}/claude-execution-output.json`;
+const BASE_ARGS = ["-p", "--verbose", "--output-format", "stream-json"];
+
+export type ClaudeOptions = {
+  allowedTools?: string;
+  disallowedTools?: string;
+  maxTurns?: string;
+  mcpConfig?: string;
+  systemPrompt?: string;
+  appendSystemPrompt?: string;
+  claudeEnv?: string;
+  fallbackModel?: string;
+  timeoutMinutes?: string;
+};
+
+type PreparedConfig = {
+  claudeArgs: string[];
+  promptPath: string;
+  env: Record<string, string>;
+};
+
+function parseCustomEnvVars(claudeEnv?: string): Record<string, string> {
+  if (!claudeEnv || claudeEnv.trim() === "") {
+    return {};
+  }
+
+  const customEnv: Record<string, string> = {};
+
+  // Split by lines and parse each line as KEY: VALUE
+  const lines = claudeEnv.split("\n");
+
+  for (const line of lines) {
+    const trimmedLine = line.trim();
+    if (trimmedLine === "" || trimmedLine.startsWith("#")) {
+      continue; // Skip empty lines and comments
+    }
+
+    const colonIndex = trimmedLine.indexOf(":");
+    if (colonIndex === -1) {
+      continue; // Skip lines without colons
+    }
+
+    const key = trimmedLine.substring(0, colonIndex).trim();
+    const value = trimmedLine.substring(colonIndex + 1).trim();
+
+    if (key) {
+      customEnv[key] = value;
+    }
+  }
+
+  return customEnv;
+}
+
+export function prepareRunConfig(
+  promptPath: string,
+  options: ClaudeOptions,
+): PreparedConfig {
+  const claudeArgs = [...BASE_ARGS];
+
+  if (options.allowedTools) {
+    claudeArgs.push("--allowedTools", options.allowedTools);
+  }
+  if (options.disallowedTools) {
+    claudeArgs.push("--disallowedTools", options.disallowedTools);
+  }
+  if (options.maxTurns) {
+    const maxTurnsNum = parseInt(options.maxTurns, 10);
+    if (isNaN(maxTurnsNum) || maxTurnsNum <= 0) {
+      throw new Error(
+        `maxTurns must be a positive number, got: ${options.maxTurns}`,
+      );
+    }
+    claudeArgs.push("--max-turns", options.maxTurns);
+  }
+  if (options.mcpConfig) {
+    claudeArgs.push("--mcp-config", options.mcpConfig);
+  }
+  if (options.systemPrompt) {
+    claudeArgs.push("--system-prompt", options.systemPrompt);
+  }
+  if (options.appendSystemPrompt) {
+    claudeArgs.push("--append-system-prompt", options.appendSystemPrompt);
+  }
+  if (options.fallbackModel) {
+    claudeArgs.push("--fallback-model", options.fallbackModel);
+  }
+  if (options.timeoutMinutes) {
+    const timeoutMinutesNum = parseInt(options.timeoutMinutes, 10);
+    if (isNaN(timeoutMinutesNum) || timeoutMinutesNum <= 0) {
+      throw new Error(
+        `timeoutMinutes must be a positive number, got: ${options.timeoutMinutes}`,
+      );
+    }
+  }
+
+  // Parse custom environment variables
+  const customEnv = parseCustomEnvVars(options.claudeEnv);
+
+  return {
+    claudeArgs,
+    promptPath,
+    env: customEnv,
+  };
+}
+
+export async function runClaude(promptPath: string, options: ClaudeOptions) {
+  const config = prepareRunConfig(promptPath, options);
+
+  // Create a named pipe
+  try {
+    await unlink(PIPE_PATH);
+  } catch (e) {
+    // Ignore if file doesn't exist
+  }
+
+  // Create the named pipe
+  await execAsync(`mkfifo "${PIPE_PATH}"`);
+
+  // Log prompt file size
+  let promptSize = "unknown";
+  try {
+    const stats = await stat(config.promptPath);
+    promptSize = stats.size.toString();
+  } catch (e) {
+    // Ignore error
+  }
+
+  console.log(`Prompt file size: ${promptSize} bytes`);
+
+  // Log custom environment variables if any
+  if (Object.keys(config.env).length > 0) {
+    const envKeys = Object.keys(config.env).join(", ");
+    console.log(`Custom environment variables: ${envKeys}`);
+  }
+
+  // Output to console
+  console.log(`Running Claude with prompt from file: ${config.promptPath}`);
+
+  // Start sending prompt to pipe in background
+  const catProcess = spawn("cat", [config.promptPath], {
+    stdio: ["ignore", "pipe", "inherit"],
+  });
+  const pipeStream = createWriteStream(PIPE_PATH);
+  catProcess.stdout.pipe(pipeStream);
+
+  catProcess.on("error", (error) => {
+    console.error("Error reading prompt file:", error);
+    pipeStream.destroy();
+  });
+
+  const claudeProcess = spawn("claude", config.claudeArgs, {
+    stdio: ["pipe", "pipe", "inherit"],
+    env: {
+      ...process.env,
+      ...config.env,
+    },
+  });
+
+  // Handle Claude process errors
+  claudeProcess.on("error", (error) => {
+    console.error("Error spawning Claude process:", error);
+    pipeStream.destroy();
+  });
+
+  // Capture output for parsing execution metrics
+  let output = "";
+  claudeProcess.stdout.on("data", (data) => {
+    const text = data.toString();
+
+    // Try to parse as JSON and pretty print if it's on a single line
+    const lines = text.split("\n");
+    lines.forEach((line: string, index: number) => {
+      if (line.trim() === "") return;
+
+      try {
+        // Check if this line is a JSON object
+        const parsed = JSON.parse(line);
+        const prettyJson = JSON.stringify(parsed, null, 2);
+        process.stdout.write(prettyJson);
+        if (index < lines.length - 1 || text.endsWith("\n")) {
+          process.stdout.write("\n");
+        }
+      } catch (e) {
+        // Not a JSON object, print as is
+        process.stdout.write(line);
+        if (index < lines.length - 1 || text.endsWith("\n")) {
+          process.stdout.write("\n");
+        }
+      }
+    });
+
+    output += text;
+  });
+
+  // Handle stdout errors
+  claudeProcess.stdout.on("error", (error) => {
+    console.error("Error reading Claude stdout:", error);
+  });
+
+  // Pipe from named pipe to Claude
+  const pipeProcess = spawn("cat", [PIPE_PATH]);
+  pipeProcess.stdout.pipe(claudeProcess.stdin);
+
+  // Handle pipe process errors
+  pipeProcess.on("error", (error) => {
+    console.error("Error reading from named pipe:", error);
+    claudeProcess.kill("SIGTERM");
+  });
+
+  // Wait for Claude to finish with timeout
+  let timeoutMs = 10 * 60 * 1000; // Default 10 minutes
+  if (options.timeoutMinutes) {
+    timeoutMs = parseInt(options.timeoutMinutes, 10) * 60 * 1000;
+  } else if (process.env.INPUT_TIMEOUT_MINUTES) {
+    const envTimeout = parseInt(process.env.INPUT_TIMEOUT_MINUTES, 10);
+    if (isNaN(envTimeout) || envTimeout <= 0) {
+      throw new Error(
+        `INPUT_TIMEOUT_MINUTES must be a positive number, got: ${process.env.INPUT_TIMEOUT_MINUTES}`,
+      );
+    }
+    timeoutMs = envTimeout * 60 * 1000;
+  }
+  const exitCode = await new Promise<number>((resolve) => {
+    let resolved = false;
+
+    // Set a timeout for the process
+    const timeoutId = setTimeout(() => {
+      if (!resolved) {
+        console.error(
+          `Claude process timed out after ${timeoutMs / 1000} seconds`,
+        );
+        claudeProcess.kill("SIGTERM");
+        // Give it 5 seconds to terminate gracefully, then force kill
+        setTimeout(() => {
+          try {
+            claudeProcess.kill("SIGKILL");
+          } catch (e) {
+            // Process may already be dead
+          }
+        }, 5000);
+        resolved = true;
+        resolve(124); // Standard timeout exit code
+      }
+    }, timeoutMs);
+
+    claudeProcess.on("close", (code) => {
+      if (!resolved) {
+        clearTimeout(timeoutId);
+        resolved = true;
+        resolve(code || 0);
+      }
+    });
+
+    claudeProcess.on("error", (error) => {
+      if (!resolved) {
+        console.error("Claude process error:", error);
+        clearTimeout(timeoutId);
+        resolved = true;
+        resolve(1);
+      }
+    });
+  });
+
+  // Clean up processes
+  try {
+    catProcess.kill("SIGTERM");
+  } catch (e) {
+    // Process may already be dead
+  }
+  try {
+    pipeProcess.kill("SIGTERM");
+  } catch (e) {
+    // Process may already be dead
+  }
+
+  // Clean up pipe file
+  try {
+    await unlink(PIPE_PATH);
+  } catch (e) {
+    // Ignore errors during cleanup
+  }
+
+  // Set conclusion based on exit code
+  if (exitCode === 0) {
+    // Try to process the output and save execution metrics
+    try {
+      await writeFile("output.txt", output);
+
+      // Process output.txt into JSON and save to execution file
+      const { stdout: jsonOutput } = await execAsync("jq -s '.' output.txt");
+      await writeFile(EXECUTION_FILE, jsonOutput);
+
+      console.log(`Log saved to ${EXECUTION_FILE}`);
+    } catch (e) {
+      core.warning(`Failed to process output for execution metrics: ${e}`);
+    }
+
+    core.setOutput("conclusion", "success");
+    core.setOutput("execution_file", EXECUTION_FILE);
+  } else {
+    core.setOutput("conclusion", "failure");
+
+    // Still try to save execution file if we have output
+    if (output) {
+      try {
+        await writeFile("output.txt", output);
+        const { stdout: jsonOutput } = await execAsync("jq -s '.' output.txt");
+        await writeFile(EXECUTION_FILE, jsonOutput);
+        core.setOutput("execution_file", EXECUTION_FILE);
+      } catch (e) {
+        // Ignore errors when processing output during failure
+      }
+    }
+
+    process.exit(exitCode);
+  }
+}

base-action/src/setup-claude-code-settings.ts

@@ -0,0 +1,68 @@
+import { $ } from "bun";
+import { homedir } from "os";
+import { readFile } from "fs/promises";
+
+export async function setupClaudeCodeSettings(
+  settingsInput?: string,
+  homeDir?: string,
+) {
+  const home = homeDir ?? homedir();
+  const settingsPath = `${home}/.claude/settings.json`;
+  console.log(`Setting up Claude settings at: ${settingsPath}`);
+
+  // Ensure .claude directory exists
+  console.log(`Creating .claude directory...`);
+  await $`mkdir -p ${home}/.claude`.quiet();
+
+  let settings: Record<string, unknown> = {};
+  try {
+    const existingSettings = await $`cat ${settingsPath}`.quiet().text();
+    if (existingSettings.trim()) {
+      settings = JSON.parse(existingSettings);
+      console.log(
+        `Found existing settings:`,
+        JSON.stringify(settings, null, 2),
+      );
+    } else {
+      console.log(`Settings file exists but is empty`);
+    }
+  } catch (e) {
+    console.log(`No existing settings file found, creating new one`);
+  }
+
+  // Handle settings input (either file path or JSON string)
+  if (settingsInput && settingsInput.trim()) {
+    console.log(`Processing settings input...`);
+    let inputSettings: Record<string, unknown> = {};
+
+    try {
+      // First try to parse as JSON
+      inputSettings = JSON.parse(settingsInput);
+      console.log(`Parsed settings input as JSON`);
+    } catch (e) {
+      // If not JSON, treat as file path
+      console.log(
+        `Settings input is not JSON, treating as file path: ${settingsInput}`,
+      );
+      try {
+        const fileContent = await readFile(settingsInput, "utf-8");
+        inputSettings = JSON.parse(fileContent);
+        console.log(`Successfully read and parsed settings from file`);
+      } catch (fileError) {
+        console.error(`Failed to read or parse settings file: ${fileError}`);
+        throw new Error(`Failed to process settings input: ${fileError}`);
+      }
+    }
+
+    // Merge input settings with existing settings
+    settings = { ...settings, ...inputSettings };
+    console.log(`Merged settings with input settings`);
+  }
+
+  // Always set enableAllProjectMcpServers to true
+  settings.enableAllProjectMcpServers = true;
+  console.log(`Updated settings with enableAllProjectMcpServers: true`);
+
+  await $`echo ${JSON.stringify(settings, null, 2)} > ${settingsPath}`.quiet();
+  console.log(`Settings saved successfully`);
+}

base-action/src/validate-env.ts

@@ -0,0 +1,54 @@
+/**
+ * Validates the environment variables required for running Claude Code
+ * based on the selected provider (Anthropic API, AWS Bedrock, or Google Vertex AI)
+ */
+export function validateEnvironmentVariables() {
+  const useBedrock = process.env.CLAUDE_CODE_USE_BEDROCK === "1";
+  const useVertex = process.env.CLAUDE_CODE_USE_VERTEX === "1";
+  const anthropicApiKey = process.env.ANTHROPIC_API_KEY;
+  const claudeCodeOAuthToken = process.env.CLAUDE_CODE_OAUTH_TOKEN;
+
+  const errors: string[] = [];
+
+  if (useBedrock && useVertex) {
+    errors.push(
+      "Cannot use both Bedrock and Vertex AI simultaneously. Please set only one provider.",
+    );
+  }
+
+  if (!useBedrock && !useVertex) {
+    if (!anthropicApiKey && !claudeCodeOAuthToken) {
+      errors.push(
+        "Either ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN is required when using direct Anthropic API.",
+      );
+    }
+  } else if (useBedrock) {
+    const requiredBedrockVars = {
+      AWS_REGION: process.env.AWS_REGION,
+      AWS_ACCESS_KEY_ID: process.env.AWS_ACCESS_KEY_ID,
+      AWS_SECRET_ACCESS_KEY: process.env.AWS_SECRET_ACCESS_KEY,
+    };
+
+    Object.entries(requiredBedrockVars).forEach(([key, value]) => {
+      if (!value) {
+        errors.push(`${key} is required when using AWS Bedrock.`);
+      }
+    });
+  } else if (useVertex) {
+    const requiredVertexVars = {
+      ANTHROPIC_VERTEX_PROJECT_ID: process.env.ANTHROPIC_VERTEX_PROJECT_ID,
+      CLOUD_ML_REGION: process.env.CLOUD_ML_REGION,
+    };
+
+    Object.entries(requiredVertexVars).forEach(([key, value]) => {
+      if (!value) {
+        errors.push(`${key} is required when using Google Vertex AI.`);
+      }
+    });
+  }
+
+  if (errors.length > 0) {
+    const errorMessage = `Environment variable validation failed:\n${errors.map((e) => `  - ${e}`).join("\n")}`;
+    throw new Error(errorMessage);
+  }
+}