feat(raft-library): task 3.1 — raft_init validation, state init, raft_snapshot; 12 tests

src/lib/raft/raft.h

@@ -12,6 +12,9 @@ typedef enum {
     RAFT_LEADER    = 2,
 } raft_role_t;
 
+/* Forward declaration — full definition follows raft_state_t */
+typedef struct raft_callbacks_t raft_callbacks_t;
+
 /* raft_state_t: pure Raft consensus state for one node.
  *
  * Contains only the Raft invariant state.  Application-specific fields
@@ -29,6 +32,9 @@ typedef struct {
     int          election_decided;   /* 1 once on_become_leader/follower fired */
     uint32_t     election_timeout_ms;
     int          my_priority;        /* priority index for jitter (0 = highest) */
+    /* set by raft_init — needed by the state machine to fire callbacks */
+    const raft_callbacks_t *cbs;
+    void        *ctx;
 } raft_state_t;
 
 /* raft_snapshot_t: point-in-time read of all Raft state for logging/debugging */
@@ -57,7 +63,7 @@ typedef struct {
  *   on_vote_eligible  — if NULL, all Raft-eligible candidates are granted
  *   on_trace          — if NULL, tracing is suppressed
  */
-typedef struct {
+typedef struct raft_callbacks_t {
     /* REQUIRED: Send a RequestVote RPC to peer peer_idx for the given term.
      * The caller encodes config_tag, log_lsn, and any other fields in the wire RPC. */
     int  (*on_send_vote_request)(void *ctx, int peer_idx, uint64_t term);