Files
certctl/internal/domain/agent_group.go
T
shankar0123 21aeed4f4e legal: addlicense headers + normalize legacy variants (Phase 0 RED-4)
Phase 0 closure (Path B2, post-rewrite):

addlicense sweep — adds the canonical certctl LLC copyright + BUSL-1.1
SPDX header to every production Go file. Template:

  // Copyright 2026 certctl LLC. All rights reserved.
  // SPDX-License-Identifier: BUSL-1.1

Coverage: 338 / 338 production Go files (cmd/ + internal/, excluding
*_test.go and **/testdata/**). Pre-sweep coverage was 22 / 338 (6.5%);
post-sweep is 338 / 338 (100%).

Normalized 22 pre-existing legacy headers (`// Copyright (c) certctl`
+ `// SPDX-License-Identifier: BSL-1.1`) and 1 file using a
`Certctl Contributors` attribution. The legacy SPDX ID `BSL-1.1`
is non-standard; the official SPDX identifier for Business Source
License 1.1 is `BUSL-1.1` (capital U). All 338 files now share the
canonical form.

Generated via:
  addlicense -c "certctl LLC" -y 2026 \
    -f cowork/legal/copyright-header.tpl \
    -ignore '**/testdata/**' -ignore '**/*_test.go' \
    cmd/ internal/

Verification:
  find cmd internal -name '*.go' -not -name '*_test.go' \
    -not -path '*/testdata/*' \
    -exec grep -L '^// Copyright 2026 certctl LLC' {} \; | wc -l

  Returns: 0

gofmt clean. Header additions are comments only, no compile impact.

Closes: cowork/certctl-architecture-diligence-audit.html#fix-RED-4
2026-05-13 21:23:35 +00:00

57 lines
2.0 KiB
Go

// Copyright 2026 certctl LLC. All rights reserved.
// SPDX-License-Identifier: BUSL-1.1
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
}