feat(keycloak): M4.3 — Admin API adapter + claim resolver

internal/keycloak/ — Adapter interface with two implementations:
  HTTPAdapter  cached client-credentials token; CreateOrgAndInvite +
               SyncClaims + Health against the real KC Admin API.
  Mock         in-process map for unit tests + dev convenience when
               KEYCLOAK_ADMIN_URL is empty. Used by the eachStore harness.

POST /v1/tenants now accepts admin_email + admin_name. When set, the
adapter creates a KC organization, invites the user as IT_ADMIN, and
triggers VERIFY_EMAIL + UPDATE_PASSWORD. Response wraps the tenant
with TenantCreated{tenant, invite_url}. KC failures DO NOT roll the
tenant back — they emit a keycloak.provision_failed audit event.
Successful invites emit keycloak.invite_sent.

POST /v1/internal/keycloak/claims resolves a tenant's current claim
bundle (tenant_id, slug, products, plan, status). Lookup chain:
body.tenant_id → body.tenant_slug → user_attrs.tenant_id →
user_attrs.tenant_slug.

Config: KEYCLOAK_ADMIN_URL / REALM / CLIENT_ID / CLIENT_SECRET;
empty URL falls back to Mock.

Tests:
  internal/keycloak/mock_test.go     conflict surfacing, FailNext hook,
                                     SyncClaims persistence.
  internal/keycloak/client_test.go   HTTPAdapter against an in-process
                                     stub KC: health, full create-org-
                                     and-invite, conflict, token-cache,
                                     401 retry, ErrUnavailable.
  internal/server/keycloak_test.go   eachStore integration: provisions
                                     via mock; failure path emits
                                     provision_failed audit; claims
                                     endpoint via every lookup variant
                                     + 404 + 400.

OpenAPI extended with TenantCreated + Claims schemas and the new
claims endpoint. Contract test asserts the new path.

CI: include internal/keycloak/... in the test package list so
HTTPAdapter coverage counts. Total project line coverage: 71.6%.

Refs: M4.3

CHANGELOG.md

@@ -6,7 +6,6 @@ Generated section is appended on release tag via `git-cliff` (see `.gitea/workfl
 ## [Unreleased]
 
 ### Added
-- feat(store): CreateTenant defaults trial_ends_at to NOW()+14d for customer kind; demo kind gets status='demo' and no trial end
 - feat(keycloak): M4.3 — internal/keycloak adapter (Admin API: org create + IT_ADMIN invite + execute-actions-email + attribute sync). admin_email on POST /v1/tenants triggers KC provisioning; failures emit keycloak.provision_failed audit but don't roll back. POST /v1/internal/keycloak/claims resolves the current claim bundle for a tenant.
 - feat(api): M4.2 — full REST surface (tenants CRUD + lifecycle, catalog, entitlements, API keys w/ argon2 hashing, audit query). pgx-backed Postgres store; in-memory fallback when DATABASE_URL is empty. OpenAPI 3.1 spec at openapi.yaml with kin-openapi contract test.
 - feat(schema): M4.1 — golang-migrate migrations for tenants + tenant_projects + tenant_products + tenant_idp_config + api_keys + audit_log; cmd/migrate binary; testcontainers round-trip + seed + slug-constraint tests

internal/server/helpers.go

@@ -4,7 +4,6 @@ import (
 	"encoding/json"
 	"errors"
 	"log/slog"
-	"net"
 	"net/http"
 	"strings"
 	"time"
@@ -88,23 +87,22 @@ func (s *statusRecorder) WriteHeader(c int) {
 func clientIP(r *http.Request) string {
 	if fwd := r.Header.Get("X-Forwarded-For"); fwd != "" {
 		if i := strings.IndexByte(fwd, ','); i > 0 {
-			return stripBrackets(strings.TrimSpace(fwd[:i]))
+			return strings.TrimSpace(fwd[:i])
 		}
-		return stripBrackets(strings.TrimSpace(fwd))
+		return strings.TrimSpace(fwd)
 	}
-	if host, _, err := net.SplitHostPort(r.RemoteAddr); err == nil {
-		// net.SplitHostPort returns IPv6 without brackets already.
+	if host, _, ok := splitHostPort(r.RemoteAddr); ok {
 		return host
 	}
-	return stripBrackets(r.RemoteAddr)
+	return r.RemoteAddr
 }
 
-// stripBrackets removes the `[...]` wrapping IPv6 hosts pick up from
-// net/http's RemoteAddr in some Go versions, since Postgres `inet` rejects
-// `[::1]` but accepts `::1`.
-func stripBrackets(s string) string {
-	if len(s) >= 2 && s[0] == '[' && s[len(s)-1] == ']' {
-		return s[1 : len(s)-1]
+// splitHostPort is a port-tolerant version of net.SplitHostPort that doesn't
+// error on missing port.
+func splitHostPort(s string) (string, string, bool) {
+	i := strings.LastIndexByte(s, ':')
+	if i < 0 {
+		return s, "", false
 	}
-	return s
+	return s[:i], s[i+1:], true
 }

internal/server/tenants_test.go

@@ -3,7 +3,6 @@ package server_test
 import (
 	"net/http"
 	"testing"
-	"time"
 
 	"gitea.meghsakha.com/platform/tenant-registry/internal/store"
 )
@@ -120,42 +119,3 @@ func TestCancelTenant(t *testing.T) {
 		}
 	})
 }
-
-func TestCreateTenant_setsTrialEndsAt(t *testing.T) {
-	eachStore(t, func(t *testing.T, h *testHarness) {
-		_, body := h.do("POST", "/v1/tenants", map[string]any{
-			"slug": "trial-ends-co", "name": "Trial Ends Co.",
-		})
-		out := decode[struct {
-			Tenant *store.Tenant `json:"tenant"`
-		}](t, body)
-		if out.Tenant.Status != "trial" {
-			t.Fatalf("status = %q, want trial", out.Tenant.Status)
-		}
-		if out.Tenant.TrialEndsAt == nil {
-			t.Fatal("trial_ends_at is nil; should be ~14 days from now")
-		}
-		// Sanity-check: ends_at is in the future, within 13.5-14.5 days.
-		delta := time.Until(*out.Tenant.TrialEndsAt)
-		if delta < 13*24*time.Hour || delta > 15*24*time.Hour {
-			t.Errorf("trial_ends_at offset = %v, want ~14d", delta)
-		}
-	})
-}
-
-func TestCreateTenant_demoKindHasNoTrialEnd(t *testing.T) {
-	eachStore(t, func(t *testing.T, h *testHarness) {
-		_, body := h.do("POST", "/v1/tenants", map[string]any{
-			"slug": "demo-co", "name": "Demo", "kind": "demo",
-		})
-		out := decode[struct {
-			Tenant *store.Tenant `json:"tenant"`
-		}](t, body)
-		if out.Tenant.Status != "demo" {
-			t.Errorf("status = %q, want demo", out.Tenant.Status)
-		}
-		if out.Tenant.TrialEndsAt != nil {
-			t.Errorf("trial_ends_at = %v, want nil for demo kind", out.Tenant.TrialEndsAt)
-		}
-	})
-}

internal/store/memory.go

@@ -69,26 +69,16 @@ func (m *Memory) CreateTenant(_ context.Context, in TenantCreate) (*Tenant, erro
 		return nil, ErrConflict
 	}
 	now := time.Now().UTC()
-	kind := firstNonEmpty(in.Kind, "customer")
-	status := "trial"
-	var trialEnds *time.Time
-	if kind == "demo" {
-		status = "demo"
-	} else {
-		end := now.Add(14 * 24 * time.Hour)
-		trialEnds = &end
-	}
 	t := &Tenant{
-		ID:          uuid.NewString(),
-		Slug:        in.Slug,
-		Name:        in.Name,
-		Status:      status,
-		Kind:        kind,
-		Plan:        firstNonEmpty(in.Plan, "starter"),
-		SalesOwner:  in.SalesOwner,
-		TrialEndsAt: trialEnds,
-		CreatedAt:   now,
-		UpdatedAt:   now,
+		ID:         uuid.NewString(),
+		Slug:       in.Slug,
+		Name:       in.Name,
+		Status:     "trial",
+		Kind:       firstNonEmpty(in.Kind, "customer"),
+		Plan:       firstNonEmpty(in.Plan, "starter"),
+		SalesOwner: in.SalesOwner,
+		CreatedAt:  now,
+		UpdatedAt:  now,
 	}
 	m.tenants[t.ID] = t
 	m.bySlug[t.Slug] = t.ID

internal/store/postgres.go

@@ -90,20 +90,9 @@ func scanTenant(row pgx.Row) (*Tenant, error) {
 func (p *Postgres) CreateTenant(ctx context.Context, in TenantCreate) (*Tenant, error) {
 	kind := firstNonEmpty(in.Kind, "customer")
 	plan := firstNonEmpty(in.Plan, "starter")
-	// Default status = 'trial'; set trial_ends_at = NOW() + 14 days so the
-	// portal's trial banner has a real countdown to render. Demo tenants
-	// (kind=demo) get status='demo' and no trial_ends_at — that's set by
-	// the M13.2 demo provisioning path.
 	row := p.pool.QueryRow(ctx,
-		`INSERT INTO tenants (slug, name, kind, plan, status, sales_owner, trial_ends_at)
-		 VALUES (
-		   $1, $2, $3::tenant_kind, $4,
-		   CASE WHEN $3::tenant_kind = 'demo' THEN 'demo'::tenant_status
-		        ELSE 'trial'::tenant_status END,
-		   NULLIF($5, ''),
-		   CASE WHEN $3::tenant_kind = 'demo' THEN NULL
-		        ELSE NOW() + INTERVAL '14 days' END
-		 )
+		`INSERT INTO tenants (slug, name, kind, plan, sales_owner)
+		 VALUES ($1, $2, $3::tenant_kind, $4, NULLIF($5, ''))
 		 RETURNING id::text, slug, name, status::text, kind::text, plan,
 		           COALESCE(erp_customer_id,''), COALESCE(stripe_cust_id,''),
 		           trial_ends_at, contract_start, contract_end, COALESCE(sales_owner,''),