rom_lifecycle_manager.h

Go to the documentation of this file.

#ifndef YAZE_APP_EDITOR_SYSTEM_ROM_LIFECYCLE_MANAGER_H_
#define YAZE_APP_EDITOR_SYSTEM_ROM_LIFECYCLE_MANAGER_H_
 
#include <optional>
#include <string>
#include <vector>
 
#include "absl/status/status.h"
#include "app/editor/system/session/rom_file_manager.h"
#include "core/hack_manifest.h"
#include "core/project.h"
#include "rom/rom.h"
#include "util/rom_hash.h"
 
namespace yaze::editor {
 
class SessionCoordinator;
class ToastManager;
class PopupManager;
struct RomSession;
 
class RomLifecycleManager {
 public:
  enum class PotItemSaveDecision {
    kSaveWithPotItems,
    kSaveWithoutPotItems,
    kCancel
  };
 
  struct Dependencies {
    RomFileManager* rom_file_manager = nullptr;
    SessionCoordinator* session_coordinator = nullptr;
    ToastManager* toast_manager = nullptr;
    PopupManager* popup_manager = nullptr;
    project::YazeProject* project = nullptr;
  };
 
  RomLifecycleManager() = default;
  explicit RomLifecycleManager(Dependencies deps);
  ~RomLifecycleManager() = default;
 
  void Initialize(Dependencies deps);
 
  void SetProjectContext(const project::YazeProject* project) {
    project_ = project;
  }
 
  // =========================================================================
  // ROM Hash & Write Policy
  // =========================================================================
 
  void ActivateRomIdentity(const RomSession* session);
 
  const std::string& current_rom_hash() const {
    return current_rom_identity_.crc32;
  }
 
  bool IsRomHashMismatch() const;
 
  absl::Status CheckRomOpenPolicy(Rom* rom);
 
  absl::Status CheckRomRebindPolicy(Rom* rom);
 
  absl::Status CheckRomWritePolicy(
      Rom* rom,
      const std::optional<std::string>& target_filename = std::nullopt);
 
  absl::Status CheckOracleRomSafetyPreSave(Rom* rom);
 
  // =========================================================================
  // ROM Write Confirmation State Machine
  // =========================================================================
 
  bool IsRomWriteConfirmPending() const { return pending_rom_write_confirm_; }
  void ConfirmRomWrite();
  void CancelRomWriteConfirm();
  void AllowBuildOutputOpenOnce() { bypass_build_output_open_once_ = true; }
 
  // =========================================================================
  // Write Conflict Management (ASM-owned address protection)
  // =========================================================================
 
  const std::vector<core::WriteConflict>& pending_write_conflicts() const {
    return pending_write_conflicts_;
  }
  bool ShouldBypassWriteConflict() const { return bypass_write_conflict_once_; }
  void BypassWriteConflictOnce() { bypass_write_conflict_once_ = true; }
  void ClearPendingWriteConflicts() { pending_write_conflicts_.clear(); }
  void SetPendingWriteConflicts(std::vector<core::WriteConflict> conflicts) {
    pending_write_conflicts_ = std::move(conflicts);
  }
  void ConsumeWriteConflictBypass() {
    bypass_write_conflict_once_ = false;
    pending_write_conflicts_.clear();
  }
 
  // =========================================================================
  // Pot Item Save Confirmation
  // =========================================================================
 
  bool HasPendingPotItemSaveConfirmation() const {
    return pending_pot_item_save_confirm_;
  }
  int pending_pot_item_unloaded_rooms() const {
    return pending_pot_item_unloaded_rooms_;
  }
  int pending_pot_item_total_rooms() const {
    return pending_pot_item_total_rooms_;
  }
 
  void SetPotItemConfirmPending(int unloaded_rooms, int total_rooms);
 
  PotItemSaveDecision ResolvePotItemSaveConfirmation(
      PotItemSaveDecision decision);
 
  bool ShouldBypassPotItemConfirm() const {
    return bypass_pot_item_confirm_once_;
  }
  bool ShouldSuppressPotItemSave() const {
    return suppress_pot_item_save_once_;
  }
  void CancelPotItemSaveConfirmation() {
    pending_pot_item_save_confirm_ = false;
    pending_pot_item_unloaded_rooms_ = 0;
    pending_pot_item_total_rooms_ = 0;
    ClearPotItemBypass();
  }
  void ClearPotItemBypass() {
    bypass_pot_item_confirm_once_ = false;
    suppress_pot_item_save_once_ = false;
  }
 
  void ResetPendingSaveState() {
    CancelRomWriteConfirm();
    CancelPotItemSaveConfirmation();
    pending_write_conflicts_.clear();
    bypass_write_conflict_once_ = false;
  }
 
  // =========================================================================
  // Backup Management (delegates to RomFileManager)
  // =========================================================================
 
  std::vector<RomFileManager::BackupEntry> GetRomBackups(Rom* rom) const;
  absl::Status PruneRomBackups(Rom* rom);
 
  void ApplyDefaultBackupPolicy(bool enabled, const std::string& folder,
                                int retention_count, bool keep_daily,
                                int keep_daily_days);
 
 private:
  bool HasEditableSource(const std::string& source_path) const;
 
  // Dependencies (non-owning pointers)
  RomFileManager* rom_file_manager_ = nullptr;
  SessionCoordinator* session_coordinator_ = nullptr;
  ToastManager* toast_manager_ = nullptr;
  PopupManager* popup_manager_ = nullptr;
  const project::YazeProject* project_ = nullptr;
 
  // Active view of the session-owned baseline; replaced on every activation.
  util::RomIdentityHashes current_rom_identity_;
  std::string current_rom_path_;
  std::string current_rom_editing_source_path_;
 
  // Write confirmation state machine
  bool pending_rom_write_confirm_ = false;
  bool bypass_rom_write_confirm_once_ = false;
  bool bypass_build_output_open_once_ = false;
 
  // Pot item save confirmation state
  bool pending_pot_item_save_confirm_ = false;
  int pending_pot_item_unloaded_rooms_ = 0;
  int pending_pot_item_total_rooms_ = 0;
  bool bypass_pot_item_confirm_once_ = false;
  bool suppress_pot_item_save_once_ = false;
 
  // Write conflict state (ASM-owned address protection)
  std::vector<core::WriteConflict> pending_write_conflicts_;
  bool bypass_write_conflict_once_ = false;
};
 
}  // namespace yaze::editor
 
#endif  // YAZE_APP_EDITOR_SYSTEM_ROM_LIFECYCLE_MANAGER_H_