story_event_graph.h

Go to the documentation of this file.

#ifndef YAZE_CORE_STORY_EVENT_GRAPH_H
#define YAZE_CORE_STORY_EVENT_GRAPH_H
 
#include <cstdint>
#include <string>
#include <unordered_map>
#include <vector>
 
#include "absl/status/status.h"
#include "core/oracle_progression.h"
 
namespace yaze::core {
 
struct StoryFlag {
  std::string name;
  std::string value;      // e.g., "2" for GameState=2
  std::string reg;        // e.g., "OOSPROG" for bit-based flags
  int bit = -1;           // Bit index if applicable (-1 = not a bitfield)
  std::string operation;  // "increment", "set", etc.
};
 
struct StoryLocation {
  std::string name;
  std::string entrance_id;       // e.g., "0/1", "2"
  std::string overworld_id;      // e.g., "0x33"
  std::string special_world_id;  // e.g., "0x80"
  std::string room_id;           // e.g., "0x202"
};
 
struct StoryPredicate {
  std::string reg;  // e.g., "GAMESTATE", "CRYSTALS", "OOSPROG"
  std::string op;
  int value = 0;
  int bit = -1;
  uint32_t mask = 0;
};
 
struct StoryEdge {
  std::string from;
  std::string to;
  std::string type;  // "dependency"
};
 
enum class StoryNodeStatus : uint8_t {
  kLocked,     // Prerequisites not met (gray)
  kAvailable,  // Prerequisites met, not yet done (yellow)
  kCompleted,  // Event has occurred (green)
  kBlocked,    // Has a blocker annotation (red)
};
 
struct StoryEventNode {
  std::string id;    // "EV-001"
  std::string name;  // "Intro begins"
 
  std::vector<StoryFlag> flags;
  std::vector<StoryLocation> locations;
  std::vector<std::string> scripts;
  std::vector<std::string> text_ids;  // hex: "0x1F"
 
  // Optional completion predicates. If empty, the graph falls back to
  // heuristics based on game_state/crystals (legacy behavior).
  std::vector<StoryPredicate> completed_when;
 
  std::vector<std::string> dependencies;  // Inbound edge source IDs
  std::vector<std::string> unlocks;       // Outbound edge target IDs
 
  std::string evidence;
  std::string last_verified;
  std::string notes;
 
  // Layout position (computed by AutoLayout)
  float pos_x = 0.0f;
  float pos_y = 0.0f;
 
  // Runtime state
  StoryNodeStatus status = StoryNodeStatus::kLocked;
};
 
class StoryEventGraph {
 public:
  StoryEventGraph() = default;
 
  absl::Status LoadFromJson(const std::string& path);
 
  absl::Status LoadFromString(const std::string& json_content);
 
  [[nodiscard]] bool loaded() const { return !nodes_.empty(); }
 
  void AutoLayout();
 
  void UpdateStatus(uint8_t crystal_bitfield, uint8_t game_state);
 
  void UpdateStatus(const OracleProgressionState& state);
 
  [[nodiscard]] std::vector<std::string> GetCompletedNodes(
      uint8_t crystal_bitfield, uint8_t game_state) const;
 
  [[nodiscard]] std::vector<std::string> GetCompletedNodes(
      const OracleProgressionState& state) const;
 
  // ─── Accessors ─────────────────────────────────────────────────
 
  [[nodiscard]] const std::vector<StoryEventNode>& nodes() const {
    return nodes_;
  }
 
  [[nodiscard]] const std::vector<StoryEdge>& edges() const { return edges_; }
 
  [[nodiscard]] const StoryEventNode* GetNode(const std::string& id) const;
 
 private:
  std::vector<StoryEventNode> nodes_;
  std::vector<StoryEdge> edges_;
  std::unordered_map<std::string, size_t> node_index_;  // id -> nodes_ index
};
 
}  // namespace yaze::core
 
#endif  // YAZE_CORE_STORY_EVENT_GRAPH_H