mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 16:21:30 +00:00
shankar0123
21aeed4f4e
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
113 lines
4.4 KiB
Go
113 lines
4.4 KiB
Go
// Copyright 2026 certctl LLC. All rights reserved.
|
|
// SPDX-License-Identifier: BUSL-1.1
|
|
|
|
package domain
|
|
|
|
import "time"
|
|
|
|
// HealthStatus represents the current health state of a monitored endpoint.
|
|
type HealthStatus string
|
|
|
|
const (
|
|
HealthStatusHealthy HealthStatus = "healthy"
|
|
HealthStatusDegraded HealthStatus = "degraded"
|
|
HealthStatusDown HealthStatus = "down"
|
|
HealthStatusCertMismatch HealthStatus = "cert_mismatch"
|
|
HealthStatusUnknown HealthStatus = "unknown"
|
|
)
|
|
|
|
// IsValidHealthStatus checks if a health status string is valid.
|
|
func IsValidHealthStatus(s string) bool {
|
|
switch HealthStatus(s) {
|
|
case HealthStatusHealthy, HealthStatusDegraded, HealthStatusDown, HealthStatusCertMismatch, HealthStatusUnknown:
|
|
return true
|
|
}
|
|
return false
|
|
}
|
|
|
|
// EndpointHealthCheck represents a monitored TLS endpoint.
|
|
type EndpointHealthCheck struct {
|
|
ID string `json:"id"`
|
|
Endpoint string `json:"endpoint"`
|
|
CertificateID *string `json:"certificate_id,omitempty"`
|
|
NetworkScanTargetID *string `json:"network_scan_target_id,omitempty"`
|
|
ExpectedFingerprint string `json:"expected_fingerprint"`
|
|
ObservedFingerprint string `json:"observed_fingerprint"`
|
|
Status HealthStatus `json:"status"`
|
|
ConsecutiveFailures int `json:"consecutive_failures"`
|
|
ResponseTimeMs int `json:"response_time_ms"`
|
|
TLSVersion string `json:"tls_version"`
|
|
CipherSuite string `json:"cipher_suite"`
|
|
CertSubject string `json:"cert_subject"`
|
|
CertIssuer string `json:"cert_issuer"`
|
|
CertExpiry *time.Time `json:"cert_expiry,omitempty"`
|
|
LastCheckedAt *time.Time `json:"last_checked_at,omitempty"`
|
|
LastSuccessAt *time.Time `json:"last_success_at,omitempty"`
|
|
LastFailureAt *time.Time `json:"last_failure_at,omitempty"`
|
|
LastTransitionAt *time.Time `json:"last_transition_at,omitempty"`
|
|
FailureReason string `json:"failure_reason"`
|
|
DegradedThreshold int `json:"degraded_threshold"`
|
|
DownThreshold int `json:"down_threshold"`
|
|
CheckIntervalSecs int `json:"check_interval_seconds"`
|
|
Enabled bool `json:"enabled"`
|
|
Acknowledged bool `json:"acknowledged"`
|
|
AcknowledgedBy string `json:"acknowledged_by,omitempty"`
|
|
AcknowledgedAt *time.Time `json:"acknowledged_at,omitempty"`
|
|
CreatedAt time.Time `json:"created_at"`
|
|
UpdatedAt time.Time `json:"updated_at"`
|
|
}
|
|
|
|
// TransitionStatus computes the new health status based on the probe result.
|
|
// Returns the new status and whether a transition occurred.
|
|
func (h *EndpointHealthCheck) TransitionStatus(probeSuccess bool, observedFingerprint string) (HealthStatus, bool) {
|
|
oldStatus := h.Status
|
|
var newStatus HealthStatus
|
|
|
|
if probeSuccess {
|
|
if h.ExpectedFingerprint != "" && observedFingerprint != h.ExpectedFingerprint {
|
|
newStatus = HealthStatusCertMismatch
|
|
} else {
|
|
newStatus = HealthStatusHealthy
|
|
}
|
|
} else {
|
|
// Increment failures for next calculation (caller will update h.ConsecutiveFailures)
|
|
failures := h.ConsecutiveFailures + 1
|
|
if failures >= h.DownThreshold {
|
|
newStatus = HealthStatusDown
|
|
} else if failures >= h.DegradedThreshold {
|
|
newStatus = HealthStatusDegraded
|
|
} else {
|
|
// Keep current status during initial failures before threshold
|
|
// Unless we were in an error state, transition to degraded after first failure
|
|
if h.Status == HealthStatusUnknown || h.Status == HealthStatusHealthy {
|
|
newStatus = HealthStatusHealthy // still considered healthy during grace period
|
|
} else {
|
|
newStatus = h.Status
|
|
}
|
|
}
|
|
}
|
|
|
|
return newStatus, newStatus != oldStatus
|
|
}
|
|
|
|
// HealthHistoryEntry represents a single probe record.
|
|
type HealthHistoryEntry struct {
|
|
ID string `json:"id"`
|
|
HealthCheckID string `json:"health_check_id"`
|
|
Status string `json:"status"`
|
|
ResponseTimeMs int `json:"response_time_ms"`
|
|
Fingerprint string `json:"fingerprint"`
|
|
FailureReason string `json:"failure_reason"`
|
|
CheckedAt time.Time `json:"checked_at"`
|
|
}
|
|
|
|
// HealthCheckSummary contains aggregate counts by status.
|
|
type HealthCheckSummary struct {
|
|
Healthy int `json:"healthy"`
|
|
Degraded int `json:"degraded"`
|
|
Down int `json:"down"`
|
|
CertMismatch int `json:"cert_mismatch"`
|
|
Unknown int `json:"unknown"`
|
|
Total int `json:"total"`
|
|
}
|