ritual.sh/assets/js/games/engine/game-engine.js

// Game Engine - Main orchestrator for terminal games
class GameEngine {
  constructor(gameDefinition) {
    this.definition = gameDefinition;
    this.terminal = null;
    this.adapter = null;
    this.state = null;
    this.input = null;
    this.scenes = null;

    this.isRunning = false;
    this.originalExecuteCommand = null;
  }

  // Register this game as a terminal command
  register() {
    if (!window.terminal) {
      console.warn("Terminal not available, cannot register game:", this.definition.id);
      return;
    }

    this.terminal = window.terminal;
    const self = this;
    const def = this.definition;

    this.terminal.registerCommand(
      def.command || def.id,
      def.description || `Play ${def.name}`,
      async (args) => {
        if (args[0] === "reset") {
          self._reset();
          return;
        }
        if (args[0] === "continue" || args[0] === "resume") {
          await self.start(true);
          return;
        }
        await self.start();
      },
    );
  }

  // Start the game
  async start(continueGame = false) {
    if (this.isRunning) {
      this.terminal.printWarning("Game is already running!");
      return;
    }

    this.isRunning = true;

    // Initialize components
    this.adapter = new TerminalAdapter(this.terminal);
    this.state = new StateManager(this.definition.id);
    this.input = new InputManager(this.adapter);
    this.scenes = new SceneManager(this.adapter, this.state, this.input);

    // Initialize state
    this.state.init(this.definition.initialState || {});

    // Register scenes
    this.scenes.registerScenes(this.definition.scenes);

    // Hook into terminal input
    this._hookInput();

    // Check for existing save
    const hasSave = this.state.hasSavedState();

    // Show intro unless continuing
    if (!continueGame && !hasSave) {
      if (this.definition.intro) {
        await this._playIntro();
      }
    } else if (hasSave && !continueGame) {
      // Ask if player wants to continue
      this.adapter.clear();
      this.adapter.printInfo("A saved game was found.");
      const shouldContinue = await this.input.awaitConfirm("Continue from where you left off?");

      if (!shouldContinue) {
        this.state.reset();
        this.state.init(this.definition.initialState || {});
        if (this.definition.intro) {
          await this._playIntro();
        }
      }
    }

    // Go to start scene (or last scene if continuing)
    const startScene = this.state.get("_currentScene") || this.definition.startScene || "start";
    await this.scenes.goTo(startScene);
  }

  async _playIntro() {
    this.adapter.clear();

    // Show title
    if (this.definition.name) {
      this.adapter.printHTML(
        `<div class="game-title">${this.definition.name}</div>`,
      );
      this.adapter.print("");
    }

    // Show intro content
    if (typeof this.definition.intro === "string") {
      this.adapter.print(this.definition.intro);
    } else if (Array.isArray(this.definition.intro)) {
      await this.scenes._renderContent(this.definition.intro);
    }

    this.adapter.print("");

    // Wait for input to continue
    await this.input.awaitOption(
      [{ text: "Begin", value: true }],
      "Press Enter or 1 to start...",
    );
  }

  _hookInput() {
    // Store original executeCommand
    this.originalExecuteCommand = this.terminal.executeCommand.bind(this.terminal);

    // Override to intercept input
    const self = this;
    this.terminal.executeCommand = function (commandString) {
      if (!self.isRunning) {
        return self.originalExecuteCommand(commandString);
      }

      // Check for exit commands
      const cmd = commandString.toLowerCase().trim();
      if (cmd === "quit" || cmd === "exit" || cmd === "q") {
        self.stop();
        return;
      }

      // Check for save command
      if (cmd === "save") {
        self._saveProgress();
        return;
      }

      // Pass to input manager if in text mode
      if (self.input.getMode() === "text") {
        self.input.handleTextInput(commandString);
      }
    };
  }

  _saveProgress() {
    // Save current scene for resuming
    const currentSceneId = this.scenes.getCurrentSceneId();
    if (currentSceneId) {
      this.state.set("_currentScene", currentSceneId);
    }
    this.adapter.printSuccess("Game progress saved.");
  }

  // Stop the game and restore terminal
  stop() {
    // Save progress before stopping
    this._saveProgress();

    this.isRunning = false;

    // Cleanup input manager
    if (this.input) {
      this.input.destroy();
    }

    // Restore original command handler
    if (this.originalExecuteCommand) {
      this.terminal.executeCommand = this.originalExecuteCommand;
    }

    this.adapter.print("");
    this.adapter.printInfo(`Exited ${this.definition.name}. Progress saved.`);
    this.adapter.print('Type "help" for available commands.');
    this.adapter.print(
      `Type "${this.definition.command || this.definition.id}" to continue playing.`,
    );
  }

  _reset() {
    if (this.state) {
      this.state.reset();
    } else {
      // Create temporary state manager just to reset
      const tempState = new StateManager(this.definition.id);
      tempState.reset();
    }
    this.terminal.printSuccess(`${this.definition.name} progress has been reset.`);
  }

  // Check if game is currently running
  isActive() {
    return this.isRunning;
  }

  // Get game definition
  getDefinition() {
    return this.definition;
  }
}

// Make available globally
window.GameEngine = GameEngine;