feat: M11b — ownership tracking, agent groups, interactive renewal approval

Ownership: owners/teams GUI pages, notification email resolution via
resolveRecipient (owner_id → owner.email lookup). Agent groups: dynamic
device grouping by OS/arch/IP CIDR/version with manual include/exclude
membership, migration 000004, full CRUD stack (domain → repo → service →
handler → frontend). Interactive approval: AwaitingApproval job state,
approve/reject API endpoints with reason tracking. Tests: 12 agent group
handler tests, 8 approve/reject job handler tests, integration tests
updated for 13-param RegisterHandlers. Docs updated across architecture,
concepts, and seed data.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

internal/domain/agent_group.go

@@ -0,0 +1,53 @@
+package domain
+
+import (
+	"time"
+)
+
+// AgentGroup defines a logical grouping of agents based on metadata criteria
+// and/or manual membership. Used for policy scoping and fleet management.
+type AgentGroup struct {
+	ID                string    `json:"id"`
+	Name              string    `json:"name"`
+	Description       string    `json:"description"`
+	MatchOS           string    `json:"match_os"`
+	MatchArchitecture string    `json:"match_architecture"`
+	MatchIPCIDR       string    `json:"match_ip_cidr"`
+	MatchVersion      string    `json:"match_version"`
+	Enabled           bool      `json:"enabled"`
+	CreatedAt         time.Time `json:"created_at"`
+	UpdatedAt         time.Time `json:"updated_at"`
+}
+
+// AgentGroupMembership represents an explicit (manual) agent-to-group mapping.
+type AgentGroupMembership struct {
+	AgentGroupID   string    `json:"agent_group_id"`
+	AgentID        string    `json:"agent_id"`
+	MembershipType string    `json:"membership_type"` // "include" or "exclude"
+	CreatedAt      time.Time `json:"created_at"`
+}
+
+// HasDynamicCriteria returns true if this group defines at least one metadata match rule.
+func (g *AgentGroup) HasDynamicCriteria() bool {
+	return g.MatchOS != "" || g.MatchArchitecture != "" || g.MatchIPCIDR != "" || g.MatchVersion != ""
+}
+
+// MatchesAgent checks whether an agent's metadata matches all non-empty criteria.
+// Empty criteria fields are treated as wildcards (match anything).
+func (g *AgentGroup) MatchesAgent(agent *Agent) bool {
+	if g.MatchOS != "" && agent.OS != g.MatchOS {
+		return false
+	}
+	if g.MatchArchitecture != "" && agent.Architecture != g.MatchArchitecture {
+		return false
+	}
+	if g.MatchVersion != "" && agent.Version != g.MatchVersion {
+		return false
+	}
+	// IP CIDR matching is more complex — for now, do exact match on the field.
+	// Full CIDR parsing (net.ParseCIDR + Contains) deferred to when we have real use cases.
+	if g.MatchIPCIDR != "" && agent.IPAddress != g.MatchIPCIDR {
+		return false
+	}
+	return true
+}

internal/domain/job.go

@@ -35,12 +35,13 @@ const (
 type JobStatus string
 
 const (
-	JobStatusPending     JobStatus = "Pending"
-	JobStatusAwaitingCSR JobStatus = "AwaitingCSR"
-	JobStatusRunning     JobStatus = "Running"
-	JobStatusCompleted   JobStatus = "Completed"
-	JobStatusFailed      JobStatus = "Failed"
-	JobStatusCancelled   JobStatus = "Cancelled"
+	JobStatusPending          JobStatus = "Pending"
+	JobStatusAwaitingCSR      JobStatus = "AwaitingCSR"
+	JobStatusAwaitingApproval JobStatus = "AwaitingApproval"
+	JobStatusRunning          JobStatus = "Running"
+	JobStatusCompleted        JobStatus = "Completed"
+	JobStatusFailed           JobStatus = "Failed"
+	JobStatusCancelled        JobStatus = "Cancelled"
 )
 
 // DeploymentJob represents a job that deploys a certificate to a target via an agent.