ra2-eva-cursor-hooks 1.0.0

package/assets/audio/eva_soviet/transcriptions.json

@@ -0,0 +1,132 @@
+{
+  "csof001.wav": "Warning, nuclear silo detected.",
+  "csof002.wav": "Warning, nuclear missile launched.",
+  "csof003.wav": "Nuclear missile ready.",
+  "csof004.wav": "Warning, iron curtain detected.",
+  "csof005.wav": "Warning, iron curtain activated.",
+  "csof006.wav": "Iron Curtain ready.",
+  "csof007.wav": "Warning, chronosphere detected.",
+  "csof008.wav": "Warning, chronosphere activated.",
+  "csof009.wav": "Chronosphere ready.",
+  "csof010.wav": "Weather control device detected.",
+  "csof011.wav": "Warning, lightning storm created.",
+  "csof012.wav": "Lightning storm ready.",
+  "csof013.wav": "Mission accomplished.",
+  "csof014.wav": "Mission failed.",
+  "csof015.wav": "Battle control terminated.",
+  "csof016.wav": "Establishing battlefield control. Stand by.",
+  "csof017.wav": "Primary objective achieved.",
+  "csof018.wav": "Secondary objective achieved.",
+  "csof019.wav": "Tertiary objective achieved.",
+  "csof020.wav": "Critical unit lost.",
+  "csof021.wav": "Critical structure lost.",
+  "csof022.wav": "You are victorious.",
+  "csof023.wav": "You have lost.",
+  "csof024.wav": "You have resigned.",
+  "csof025.wav": "Player resigned.",
+  "csof026.wav": "Player defeated.",
+  "csof027.wav": "20 minutes remaining.",
+  "csof028.wav": "10 minutes remaining.",
+  "csof029.wav": "5 minutes remaining.",
+  "csof030.wav": "4 minutes remaining.",
+  "csof031.wav": "3 minutes remaining.",
+  "csof032.wav": "2 minutes remaining.",
+  "csof033.wav": "1 minute remaining.",
+  "csof035.wav": "Timer started.",
+  "csof036.wav": "Timer stopped.",
+  "csof037.wav": "Ore miner under attack.",
+  "csof038.wav": "Reinforcements have arrived.",
+  "csof039.wav": "New terrain discovered.",
+  "csof040.wav": "Incoming transmission.",
+  "csof041.wav": "Beacon detected.",
+  "csof042.wav": "Beacon placed.",
+  "csof043.wav": "Alliance formed.",
+  "csof044.wav": "Alliance broken.",
+  "csof045.wav": "Our ally is under attack.",
+  "csof046.wav": "Bridge repaired.",
+  "csof047.wav": "Unable to comply, building in progress.",
+  "csof048.wav": "Construction complete.",
+  "csof049.wav": "New construction options.",
+  "csof050.wav": "Insufficient funds.",
+  "csof051.wav": "Cancelled.",
+  "csof052.wav": "Building.",
+  "csof053.wav": "Low power.",
+  "csof054.wav": "Our base is under attack.",
+  "csof055.wav": "Primary building selected.",
+  "csof056.wav": "On hold.",
+  "csof057.wav": "Repairing.",
+  "csof058.wav": "Structure sold.",
+  "csof059.wav": "Base defenses offline.",
+  "csof060.wav": "Building offline.",
+  "csof061.wav": "Building online.",
+  "csof062.wav": "Unit ready.",
+  "csof063.wav": "Cannot deploy here.",
+  "csof064.wav": "Unit lost.",
+  "csof065.wav": "Select target.",
+  "csof066.wav": "Training.",
+  "csof067.wav": "Armor upgraded.",
+  "csof068.wav": "Firepower upgraded.",
+  "csof069.wav": "Speed upgraded.",
+  "csof070.wav": "Unit repaired.",
+  "csof071.wav": "Unit sold.",
+  "csof072.wav": "Building captured.",
+  "csof073.wav": "Building infiltrated.",
+  "csof074.wav": "New technology acquired.",
+  "csof075.wav": "Enemy base powered down.",
+  "csof076.wav": "Unit firepower upgraded.",
+  "csof077.wav": "Unit armor upgraded.",
+  "csof078.wav": "Unit speed upgraded.",
+  "csof079.wav": "Unit promoted.",
+  "csof080.wav": "Unit upgraded.",
+  "csof081.wav": "Firepower technology stolen, all units gain firepower upgrade.",
+  "csof082.wav": "Armor technology stolen, all units gain armor upgrade.",
+  "csof083.wav": "New mission objective received.",
+  "csof084.wav": "Upgrade in progress.",
+  "csof085.wav": "Upgrade complete.",
+  "csof086.wav": "Ore miner offline.",
+  "csof087.wav": "Enemy power restored.",
+  "csof088.wav": "Building infiltrated, technology stolen.",
+  "csof089.wav": "Building infiltrated, radar sabotaged.",
+  "csof090.wav": "Building infiltrated, cash stolen.",
+  "csof091.wav": "Building infiltrated, power sabotaged.",
+  "csof092.wav": "Technology stolen.",
+  "csof093.wav": "Radar sabotaged.",
+  "csof094.wav": "Cash stolen.",
+  "csof095.wav": "Power sabotaged.",
+  "csof096.wav": "Warning, enemy air armada detected.",
+  "csof097.wav": "Warning, enemy fleet detected.",
+  "csof098.wav": "Warning, enemy armor battalion detected.",
+  "csof099.wav": "Warning, enemy infantry battalion detected.",
+  "csof100.wav": "New rally point established.",
+  "csof101.wav": "Alliance requested.",
+  "csof102.wav": "Requesting alliance.",
+  "csof103.wav": "Enemy alliance formed.",
+  "csof104.wav": "New objective received.",
+  "csof105.wav": "Tech building captured.",
+  "csof106.wav": "Tech building lost.",
+  "csof107.wav": "Structure garrisoned.",
+  "csof108.wav": "Structure abandoned.",
+  "csof109.wav": "War miner offline.",
+  "csof120.wav": "Battle control online.",
+  "csof121.wav": "Reinforcements ready.",
+  "csof122.wav": "Weather control device offline.",
+  "csofu04.wav": "Soviet technology at its finest, terror drones can enter and destroy enemy vehicles from the inside.",
+  "csofu06.wav": "The V3 launcher has extreme range capabilities coupled with devastating damage potential. Destruction guaranteed. Just don't leave it undefended.",
+  "csofu07.wav": "The appropriately named Apocalypse Tank is war in a can. It can attack any ground or air targets and be expected to be the last unit standing.",
+  "csofu08.wav": "They may be slow, but the Kirov airships can take great punishment and deliver even more.",
+  "csofu09.wav": "The Sea Scorpion is a fast attack sea raider. It cannot win the war for you, but you cannot win the war without it. It is your only anti-air defense on the water.",
+  "csofu10.wav": "I don't agree with this kind of experimentation, but you cannot deny the results. A giant squid can immobilize and eventually destroy any sea vessel.",
+  "csofu11.wav": "The Typhoon attack sub is undetectable by normal Allied units, but look out for Allied dolphins and destroyers.",
+  "csofu15.wav": "Tesla troopers have powerful weapons but they are useless against buildings. They also make excellent base defense as they can overpower Tesla coils with their weapons.",
+  "csofu16.wav": "The Soviet engineer can repair buildings or capture enemy buildings if you can get them past defenses.",
+  "csofu18.wav": "Crazy Ivan can plant bombs on enemy buildings, or perhaps a conscript would agree to carry them for you.",
+  "csofu19.wav": "The Allies cannot match our nuclear power. Deploy a Desolator to sterilize an area.",
+  "csofu20.wav": "Our most top secret weapon, the Psi-Corps trooper is useful for quickly turning Allied units to our side.",
+  "csofu21.wav": "Commander, this Allied GI is a well-trained soldier capable of quickly deploying a heavy machine gun when stationed within buildings or deployed with his sandbag nest.",
+  "csofu25.wav": "These arrogant Allied spies believe their disguises will allow them to infiltrate our buildings. They will soon find that the only thing they can infiltrate is our faithful dog's stomachs.",
+  "csofu26.wav": "The Allied Rocketeers are men who hurl themselves through the air thanks to some jetpacks strapped to them in the hopes of wounding one of our tanks or buildings. Fools.",
+  "csofu27.wav": "Commander, beware these Chrono Legionnaires. They use some unknown technology to teleport themselves anywhere and then simply erase our forces.",
+  "csofu30.wav": "Comrade, this Prism Tank of the Allies is a dangerous threat to our massed forces. Its directed energy weapon has no trouble harming many of our forces in a single shot.",
+  "csofu31.wav": "Another annoying trick of the Allies. The Mirage Tank can mask itself as almost any object nearby it and then remain concealed and fire upon us.",
+  "csofu33.wav": "The Allied Harrier is an airborne threat to any of our forces who do not have adequate anti-air support. It does not stand up well to flak, Commander."
+}

package/bin/install.js

@@ -0,0 +1,249 @@
+#!/usr/bin/env node
+
+/**
+ * Red Alert 2 EVA Cursor Hooks Installer
+ * Installs EVA voice lines as Cursor IDE hooks
+ *
+ * Usage: npx ra2-eva-cursor-hooks
+ */
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+
+// ANSI colors
+const colors = {
+  red: "\x1b[0;31m",
+  green: "\x1b[0;32m",
+  yellow: "\x1b[1;33m",
+  blue: "\x1b[0;34m",
+  reset: "\x1b[0m",
+};
+
+function log(color, message) {
+  console.log(`${color}${message}${colors.reset}`);
+}
+
+function copyRecursive(src, dest) {
+  const stat = fs.statSync(src);
+
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src);
+    for (const entry of entries) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function countFiles(dir, extension) {
+  let count = 0;
+  const entries = fs.readdirSync(dir);
+  for (const entry of entries) {
+    if (entry.endsWith(extension)) {
+      count++;
+    }
+  }
+  return count;
+}
+
+function main() {
+  // Banner
+  log(colors.blue, "╔═══════════════════════════════════════════════════════╗");
+  log(
+    colors.blue,
+    `║   ${colors.red}RED ALERT 2${colors.blue} EVA Cursor Hooks Installer            ║`
+  );
+  log(colors.blue, "╚═══════════════════════════════════════════════════════╝");
+  console.log();
+
+  // Paths
+  const homeDir = os.homedir();
+  const cursorDir = path.join(homeDir, ".cursor");
+  const targetDir = path.join(cursorDir, "hooks", "ra2-eva");
+  const hooksJsonPath = path.join(cursorDir, "hooks.json");
+
+  // Source paths (relative to this script's package)
+  const packageRoot = path.join(__dirname, "..");
+  const srcDir = path.join(packageRoot, "src");
+  const assetsDir = path.join(packageRoot, "assets");
+
+  // Step 1: Remove existing installation
+  log(colors.yellow, "[1/5] Removing existing installation...");
+  if (fs.existsSync(targetDir)) {
+    fs.rmSync(targetDir, { recursive: true, force: true });
+  }
+
+  // Step 2: Create directory structure
+  log(colors.yellow, "[2/5] Creating directory structure...");
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  // Step 3: Copy TypeScript source files
+  log(colors.yellow, "[3/5] Copying TypeScript source files...");
+  const srcFiles = ["index.ts", "player.ts", "sounds.ts", "types.ts"];
+  for (const file of srcFiles) {
+    const srcPath = path.join(srcDir, file);
+    const destPath = path.join(targetDir, file);
+    if (fs.existsSync(srcPath)) {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+
+  // Step 4: Copy audio assets
+  log(colors.yellow, "[4/5] Copying audio assets...");
+  const assetsTargetDir = path.join(targetDir, "assets");
+  copyRecursive(assetsDir, assetsTargetDir);
+
+  const alliedDir = path.join(assetsTargetDir, "audio", "eva_allied");
+  const sovietDir = path.join(assetsTargetDir, "audio", "eva_soviet");
+  const alliedCount = fs.existsSync(alliedDir)
+    ? countFiles(alliedDir, ".wav")
+    : 0;
+  const sovietCount = fs.existsSync(sovietDir)
+    ? countFiles(sovietDir, ".wav")
+    : 0;
+
+  console.log(
+    `    Allied EVA sounds: ${colors.green}${alliedCount}${colors.reset}`
+  );
+  console.log(
+    `    Soviet EVA sounds: ${colors.green}${sovietCount}${colors.reset}`
+  );
+
+  // Step 5: Configure hooks.json
+  log(colors.yellow, "[5/5] Configuring hooks.json...");
+
+  const hookCommand = `bun run ${targetDir}/index.ts`;
+  const hookEvents = [
+    "sessionStart",
+    "sessionEnd",
+    "preToolUse",
+    "postToolUse",
+    "postToolUseFailure",
+    "beforeShellExecution",
+    "afterShellExecution",
+    "beforeReadFile",
+    "afterFileEdit",
+    "beforeMCPExecution",
+    "afterMCPExecution",
+    "beforeSubmitPrompt",
+    "subagentStart",
+    "subagentStop",
+    "stop",
+    "preCompact",
+    "afterAgentThought",
+  ];
+
+  // Load existing hooks.json or create new
+  let hooksConfig = { version: 1, hooks: {} };
+  if (fs.existsSync(hooksJsonPath)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(hooksJsonPath, "utf8"));
+      hooksConfig = existing;
+      if (!hooksConfig.hooks) {
+        hooksConfig.hooks = {};
+      }
+    } catch (e) {
+      // If parsing fails, start fresh
+      hooksConfig = { version: 1, hooks: {} };
+    }
+  }
+
+  // Add RA2 EVA hooks
+  for (const event of hookEvents) {
+    hooksConfig.hooks[event] = [{ command: hookCommand }];
+  }
+
+  fs.writeFileSync(hooksJsonPath, JSON.stringify(hooksConfig, null, 2));
+
+  // Success message
+  console.log();
+  log(
+    colors.green,
+    "╔═══════════════════════════════════════════════════════╗"
+  );
+  log(
+    colors.green,
+    "║   Installation Complete!                              ║"
+  );
+  log(
+    colors.green,
+    "╚═══════════════════════════════════════════════════════╝"
+  );
+  console.log();
+  console.log(`Installed to: ${colors.blue}${targetDir}${colors.reset}`);
+  console.log(`Hooks config: ${colors.blue}${hooksJsonPath}${colors.reset}`);
+  console.log();
+  log(colors.yellow, "Faction selection:");
+  console.log(
+    `  • Odd hours (1,3,5...):  ${colors.blue}Allied EVA${colors.reset} (English)`
+  );
+  console.log(
+    `  • Even hours (0,2,4...): ${colors.red}Soviet EVA${colors.reset} (Russian accent)`
+  );
+  console.log();
+
+  const currentHour = new Date().getHours();
+  const faction = currentHour % 2 === 1 ? "Allied" : "Soviet";
+  const factionColor = currentHour % 2 === 1 ? colors.blue : colors.red;
+  console.log(
+    `Current hour: ${currentHour} → ${factionColor}${faction}${colors.reset} faction active`
+  );
+  console.log();
+  log(colors.yellow, "Prerequisites:");
+  console.log("  • Bun runtime must be installed (https://bun.sh)");
+  console.log("  • Run: curl -fsSL https://bun.sh/install | bash");
+  console.log();
+  log(colors.yellow, "To activate:");
+  console.log("  Restart Cursor or reload the window");
+  console.log();
+  log(colors.yellow, "To uninstall:");
+  console.log("  npx ra2-eva-cursor-hooks --uninstall");
+  console.log();
+  log(colors.green, "Establishing battlefield control. Stand by.");
+}
+
+// Handle --uninstall flag
+if (process.argv.includes("--uninstall")) {
+  const homeDir = os.homedir();
+  const targetDir = path.join(homeDir, ".cursor", "hooks", "ra2-eva");
+  const hooksJsonPath = path.join(homeDir, ".cursor", "hooks.json");
+
+  log(colors.yellow, "Uninstalling RA2 EVA Cursor Hooks...");
+
+  if (fs.existsSync(targetDir)) {
+    fs.rmSync(targetDir, { recursive: true, force: true });
+    log(colors.green, `Removed: ${targetDir}`);
+  }
+
+  if (fs.existsSync(hooksJsonPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(hooksJsonPath, "utf8"));
+      if (config.hooks) {
+        // Remove RA2 hooks
+        for (const key of Object.keys(config.hooks)) {
+          const hooks = config.hooks[key];
+          if (Array.isArray(hooks)) {
+            config.hooks[key] = hooks.filter(
+              (h) => !h.command?.includes("ra2-eva")
+            );
+            if (config.hooks[key].length === 0) {
+              delete config.hooks[key];
+            }
+          }
+        }
+        fs.writeFileSync(hooksJsonPath, JSON.stringify(config, null, 2));
+        log(colors.green, "Cleaned up hooks.json");
+      }
+    } catch (e) {
+      // Ignore errors
+    }
+  }
+
+  log(colors.green, "Uninstallation complete. Battle control terminated.");
+  process.exit(0);
+}
+
+main();

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ra2-eva-cursor-hooks",
+  "version": "1.0.0",
+  "description": "Red Alert 2 EVA voice lines for Cursor IDE hooks - nostalgic audio feedback for your coding sessions",
+  "keywords": [
+    "cursor",
+    "cursor-ide",
+    "hooks",
+    "red-alert-2",
+    "eva",
+    "audio",
+    "sound",
+    "nostalgia"
+  ],
+  "author": "Toubat",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/toubatbrian/cursor-hooks.git"
+  },
+  "bin": {
+    "ra2-eva-cursor-hooks": "./bin/install.js",
+    "ra2-eva": "./bin/install.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "assets/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,122 @@
+#!/usr/bin/env bun
+/**
+ * Red Alert 2 EVA Cursor Hooks
+ *
+ * Plays nostalgic Red Alert 2 EVA voice lines for Cursor agent events.
+ * Alternates between Allied (odd hours) and Soviet (even hours) voices.
+ */
+
+import { stdin } from "bun";
+import { getFaction, playHookSound } from "./player";
+import type {
+  BeforeReadFileOutput,
+  BeforeShellExecutionOutput,
+  BeforeSubmitPromptOutput,
+  HookInput,
+  PreCompactOutput,
+  PreToolUseOutput,
+  SessionStartOutput,
+  StopOutput,
+  SubagentStartOutput,
+  SubagentStopOutput,
+} from "./types";
+
+/**
+ * Parse hook input from stdin
+ */
+async function parseHookInput<T>(): Promise<T> {
+  const text = await stdin.text();
+  return JSON.parse(text) as T;
+}
+
+/**
+ * Build the appropriate response for each hook type
+ */
+function buildResponse(hookName: string): Record<string, unknown> {
+  switch (hookName) {
+    // Hooks that need to allow the action to proceed
+    case "sessionStart": {
+      const response: SessionStartOutput = { continue: true };
+      return response;
+    }
+
+    case "preToolUse": {
+      const response: PreToolUseOutput = { decision: "allow" };
+      return response;
+    }
+
+    case "beforeShellExecution":
+    case "beforeMCPExecution": {
+      const response: BeforeShellExecutionOutput = { permission: "allow" };
+      return response;
+    }
+
+    case "beforeReadFile": {
+      const response: BeforeReadFileOutput = { permission: "allow" };
+      return response;
+    }
+
+    case "beforeSubmitPrompt": {
+      const response: BeforeSubmitPromptOutput = { continue: true };
+      return response;
+    }
+
+    case "subagentStart": {
+      const response: SubagentStartOutput = { decision: "allow" };
+      return response;
+    }
+
+    // Hooks that can optionally trigger follow-ups
+    case "subagentStop": {
+      const response: SubagentStopOutput = {};
+      return response;
+    }
+
+    case "stop": {
+      const response: StopOutput = {};
+      return response;
+    }
+
+    case "preCompact": {
+      const response: PreCompactOutput = {};
+      return response;
+    }
+
+    // Observation-only hooks (no output needed)
+    case "sessionEnd":
+    case "postToolUse":
+    case "postToolUseFailure":
+    case "afterShellExecution":
+    case "afterMCPExecution":
+    case "afterFileEdit":
+    default:
+      return {};
+  }
+}
+
+/**
+ * Main hook handler
+ */
+async function main(): Promise<void> {
+  const input = await parseHookInput<HookInput>();
+  const hookName = input.hook_event_name;
+
+  // Log to stderr (doesn't interfere with JSON output)
+  const faction = getFaction();
+  const hour = new Date().getHours();
+  console.error(`[EVA] Hook: ${hookName}`);
+  console.error(`[EVA] ${faction.toUpperCase()} faction (hour: ${hour})`);
+
+  // Play the appropriate sound (fire and forget)
+  await playHookSound(input);
+
+  // Build and return the appropriate response
+  const response = buildResponse(hookName);
+  process.stdout.write(JSON.stringify(response) + "\n");
+}
+
+main().catch((error) => {
+  console.error("[EVA] Hook failed:", error);
+  // Return empty object on error to not block Cursor
+  process.stdout.write("{}\n");
+});