feat(routing): add logical group schema foundation

tests/integration/store_init_test.go

@@ -133,7 +133,15 @@ func TestStoreAppliesLatestMigration(t *testing.T) {
 	store := openTestStore(t)
 	defer closeTestStore(t, store)
 
-	for _, table := range []string{"import_runs", "import_run_items", "import_run_item_events"} {
+	for _, table := range []string{
+		"import_runs",
+		"import_run_items",
+		"import_run_item_events",
+		"logical_groups",
+		"logical_group_models",
+		"logical_group_routes",
+		"logical_group_route_models",
+	} {
 		if !tableExists(t, store.SQLDB(), table) {
 			t.Fatalf("table %q does not exist after latest migration", table)
 		}
@@ -165,6 +173,185 @@ func TestStoreAppliesLatestMigration(t *testing.T) {
 			t.Fatalf("column %q missing from import_run_items", column)
 		}
 	}
+
+	for _, column := range []string{
+		"logical_group_id",
+		"display_name",
+		"route_policy",
+		"sticky_mode",
+		"conversation_ttl_seconds",
+		"user_model_ttl_seconds",
+		"failover_threshold",
+		"cooldown_seconds",
+	} {
+		if !tableColumnExists(t, store.SQLDB(), "logical_groups", column) {
+			t.Fatalf("column %q missing from logical_groups", column)
+		}
+	}
+
+	for _, column := range []string{
+		"logical_group_id",
+		"public_model",
+		"status",
+	} {
+		if !tableColumnExists(t, store.SQLDB(), "logical_group_models", column) {
+			t.Fatalf("column %q missing from logical_group_models", column)
+		}
+	}
+
+	for _, column := range []string{
+		"route_id",
+		"logical_group_id",
+		"priority",
+		"weight",
+		"shadow_group_id",
+		"shadow_host_id",
+		"upstream_base_url_hint",
+		"cooldown_until",
+	} {
+		if !tableColumnExists(t, store.SQLDB(), "logical_group_routes", column) {
+			t.Fatalf("column %q missing from logical_group_routes", column)
+		}
+	}
+
+	for _, column := range []string{
+		"route_id",
+		"public_model",
+		"shadow_model",
+		"status",
+	} {
+		if !tableColumnExists(t, store.SQLDB(), "logical_group_route_models", column) {
+			t.Fatalf("column %q missing from logical_group_route_models", column)
+		}
+	}
+}
+
+func TestStoreInitEnforcesLogicalRoutingConstraints(t *testing.T) {
+	ctx := context.Background()
+	store := openTestStore(t)
+	defer closeTestStore(t, store)
+
+	db := store.SQLDB()
+	mustExecSQL(t, db, `
+INSERT INTO logical_groups (
+    logical_group_id,
+    display_name,
+    status
+) VALUES (?, ?, ?)`,
+		"gpt-shared",
+		"GPT Shared",
+		"active",
+	)
+
+	if _, err := db.ExecContext(ctx, `
+INSERT INTO logical_groups (
+    logical_group_id,
+    display_name,
+    status
+) VALUES (?, ?, ?)`,
+		"gpt-shared",
+		"GPT Shared Duplicate",
+		"active",
+	); err == nil {
+		t.Fatal("duplicate logical_group_id insert error = nil, want unique constraint failure")
+	}
+
+	mustExecSQL(t, db, `
+INSERT INTO logical_group_models (
+    logical_group_id,
+    public_model
+) VALUES (?, ?)`,
+		"gpt-shared",
+		"gpt-5.4",
+	)
+
+	if _, err := db.ExecContext(ctx, `
+INSERT INTO logical_group_models (
+    logical_group_id,
+    public_model
+) VALUES (?, ?)`,
+		"gpt-shared",
+		"gpt-5.4",
+	); err == nil {
+		t.Fatal("duplicate logical_group_models insert error = nil, want unique constraint failure")
+	}
+
+	if _, err := db.ExecContext(ctx, `
+INSERT INTO logical_group_routes (
+    route_id,
+    logical_group_id,
+    name,
+    status,
+    priority,
+    shadow_group_id,
+    shadow_host_id
+) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+		"route-missing-group",
+		"missing-group",
+		"Missing Group Route",
+		"active",
+		10,
+		"shadow-group-a",
+		"shadow-host-a",
+	); err == nil {
+		t.Fatal("logical_group_routes missing group error = nil, want foreign key failure")
+	}
+
+	mustExecSQL(t, db, `
+INSERT INTO logical_group_routes (
+    route_id,
+    logical_group_id,
+    name,
+    status,
+    priority,
+    shadow_group_id,
+    shadow_host_id
+) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+		"route-asxs",
+		"gpt-shared",
+		"ASXS",
+		"active",
+		10,
+		"gpt-shared__asxs",
+		"remote43",
+	)
+
+	if _, err := db.ExecContext(ctx, `
+INSERT INTO logical_group_route_models (
+    route_id,
+    public_model,
+    shadow_model
+) VALUES (?, ?, ?)`,
+		"missing-route",
+		"gpt-5.4",
+		"gpt-5.4",
+	); err == nil {
+		t.Fatal("logical_group_route_models missing route error = nil, want foreign key failure")
+	}
+
+	mustExecSQL(t, db, `
+INSERT INTO logical_group_route_models (
+    route_id,
+    public_model,
+    shadow_model
+) VALUES (?, ?, ?)`,
+		"route-asxs",
+		"gpt-5.4",
+		"gpt-5.4",
+	)
+
+	if _, err := db.ExecContext(ctx, `
+INSERT INTO logical_group_route_models (
+    route_id,
+    public_model,
+    shadow_model
+) VALUES (?, ?, ?)`,
+		"route-asxs",
+		"gpt-5.4",
+		"gpt-5.4-alt",
+	); err == nil {
+		t.Fatal("duplicate logical_group_route_models insert error = nil, want unique constraint failure")
+	}
 }
 
 func TestStoreInitBackfillsLedgerForCompletePreLedgerSchema(t *testing.T) {
@@ -303,6 +490,14 @@ func mustExec(t *testing.T, db *sql.DB, statement string) {
 	}
 }
 
+func mustExecSQL(t *testing.T, db *sql.DB, statement string, args ...any) {
+	t.Helper()
+
+	if _, err := db.ExecContext(context.Background(), statement, args...); err != nil {
+		t.Fatalf("ExecContext() error = %v", err)
+	}
+}
+
 func closeTestStore(t *testing.T, store *sqlite.DB) {
 	t.Helper()