feat(libxce-failover): controller populates primary host/port on E_XCE_REDIRECT replies (task 5.3)

src/controller/testsuite/controller_test.c

@@ -23,6 +23,7 @@ extern void test_ha_role(void);
 extern void test_ha_role_lifecycle(void);
 extern void test_ha_cluster(void);
 extern void test_ha_redirect(void);
+extern void test_join_redirect(void);
 extern void test_p1_integration(void);
 extern void test_repl_unit(void);
 extern void test_repl_apply(void);
@@ -150,6 +151,7 @@ int main(int argc, char* argv[])
     TEST(test_ha_role_lifecycle);
     TEST(test_ha_cluster);
     TEST(test_ha_redirect);
+    TEST(test_join_redirect);
     TEST(test_p1_integration);
     TEST(test_repl_unit);
     TEST(test_repl_apply);

src/controller/testsuite/test_join_redirect.c

@@ -0,0 +1,103 @@
+/*
+ * test_join_redirect.c — Task 5.3 (libxce-failover)
+ *
+ * ControllerRedirectAddress: the controller's E_XCE_REDIRECT reply must carry
+ * the primary's host and port so the libxce client can use it as a one-hop hint
+ * (Req 8.1).  When no primary is known, the path must yield E_XCE_NOMASTER
+ * rather than an addressless redirect (Req 8.2).
+ *
+ * handle_join() is not directly unit-testable (needs a live endpoint + capnp
+ * transport), so join.c factors fill_redirect_reply(reply, ha) — the exact
+ * helper the production E_XCE_REDIRECT branch uses to populate the reply from
+ * ha state.  These tests drive that helper.
+ */
+
+#include <stdint.h>
+#include <stdio.h>
+#include <string.h>
+
+#include <unity/unity.h>
+
+#include "ha.h"        /* ha_state_t, ha_init, ha_should_redirect, xce_reply_t (via typemap.h) */
+#include "xce/errnox.h" /* E_XCE_REDIRECT, E_XCE_NOMASTER */
+
+/*
+ * Production helper defined in join.c and exercised on the E_XCE_REDIRECT path.
+ * Declared here (rather than in a controller header) because cluster.h pulls in
+ * netio.h/OpenSSL, which ha.h deliberately avoids; join.c is linked into this
+ * test binary, so an extern prototype is sufficient.
+ */
+extern void fill_redirect_reply(xce_reply_t *reply, const ha_state_t *ha);
+
+/* ── helpers ────────────────────────────────────────────────── */
+
+static ha_config_t valid_cfg(void)
+{
+    ha_config_t cfg = {
+        .heartbeat_interval_ms    = 3000,
+        .heartbeat_timeout_ms     = 10000,
+        .election_timeout_ms      = 2000,
+        .probe_connect_timeout_ms = 500,
+        .max_promotion_retries    = 5,
+    };
+    return cfg;
+}
+
+/* ── tests ──────────────────────────────────────────────────── */
+
+/*
+ * Req 8.1: when a primary is known, the redirect reply carries the primary's
+ * host and port verbatim from ha state.
+ */
+static void test_redirect_reply_carries_primary_address(void)
+{
+    ha_state_t  ha;
+    ha_config_t cfg = valid_cfg();
+    xce_reply_t reply;
+
+    TEST_ASSERT_EQUAL_INT(0, ha_init(&ha, &cfg, 1));
+    /* Default role after init is STANDBY; set a known primary. */
+    strncpy(ha.primary_host, "10.0.1.7", sizeof(ha.primary_host) - 1);
+    ha.primary_port = 7001;
+
+    /* Sanity: this is genuinely a redirect situation. */
+    TEST_ASSERT_EQUAL_INT(1, ha_should_redirect(&ha));
+
+    memset(&reply, 0, sizeof(reply));
+    fill_redirect_reply(&reply, &ha);
+
+    TEST_ASSERT_NOT_NULL(reply.redirect_host);
+    TEST_ASSERT_EQUAL_STRING("10.0.1.7", reply.redirect_host);
+    TEST_ASSERT_EQUAL_UINT16(7001, reply.redirect_port);
+
+    ha_fini(&ha);
+    printf("test_redirect_reply_carries_primary_address: PASS\n");
+}
+
+/*
+ * Req 8.2: when no primary is known, this is NOT a redirect situation
+ * (ha_should_redirect == 0, ha_no_primary_known == 1), so the join path
+ * returns E_XCE_NOMASTER rather than an addressless redirect.
+ */
+static void test_no_primary_known_yields_nomaster_not_redirect(void)
+{
+    ha_state_t  ha;
+    ha_config_t cfg = valid_cfg();
+
+    TEST_ASSERT_EQUAL_INT(0, ha_init(&ha, &cfg, 1));
+    /* primary_host empty after init — no known primary. */
+
+    TEST_ASSERT_EQUAL_INT(0, ha_should_redirect(&ha));
+    TEST_ASSERT_EQUAL_INT(1, ha_no_primary_known(&ha));
+
+    ha_fini(&ha);
+    printf("test_no_primary_known_yields_nomaster_not_redirect: PASS\n");
+}
+
+/* ── suite entry point ─────────────────────────────────────── */
+
+void test_join_redirect(void)
+{
+    RUN_TEST(test_redirect_reply_carries_primary_address);
+    RUN_TEST(test_no_primary_known_yields_nomaster_not_redirect);
+}