mirror of
https://github.com/shankar0123/certctl.git
synced 2026-06-07 18:51:32 +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
39 lines
1.6 KiB
Go
39 lines
1.6 KiB
Go
// Copyright 2026 certctl LLC. All rights reserved.
|
|
// SPDX-License-Identifier: BUSL-1.1
|
|
|
|
package domain
|
|
|
|
import "time"
|
|
|
|
// RenewalInfo represents ACME Renewal Information (ARI) per RFC 9773.
|
|
// It provides CA-directed renewal timing via a suggested renewal window.
|
|
type RenewalInfo struct {
|
|
// SuggestedWindowStart is the beginning of the time window during which the CA suggests renewal.
|
|
SuggestedWindowStart time.Time `json:"suggested_window_start"`
|
|
|
|
// SuggestedWindowEnd is the end of the time window during which the CA suggests renewal.
|
|
SuggestedWindowEnd time.Time `json:"suggested_window_end"`
|
|
|
|
// RetryAfter is the earliest time the client should re-poll for updated ARI.
|
|
// Zero value means no retry constraint.
|
|
RetryAfter time.Time `json:"retry_after,omitempty"`
|
|
|
|
// ExplanationURL is an optional URL with human-readable explanation for the renewal timing.
|
|
ExplanationURL string `json:"explanation_url,omitempty"`
|
|
}
|
|
|
|
// ShouldRenewNow returns true if the current time is within or past the suggested renewal window.
|
|
// This is the primary decision point: if true, renewal should proceed immediately.
|
|
func (r *RenewalInfo) ShouldRenewNow() bool {
|
|
now := time.Now()
|
|
return !now.Before(r.SuggestedWindowStart)
|
|
}
|
|
|
|
// OptimalRenewalTime returns the midpoint of the suggested renewal window,
|
|
// which is the recommended time to initiate renewal per RFC 9773.
|
|
// This can be used for scheduling if the current time is before the window.
|
|
func (r *RenewalInfo) OptimalRenewalTime() time.Time {
|
|
duration := r.SuggestedWindowEnd.Sub(r.SuggestedWindowStart)
|
|
return r.SuggestedWindowStart.Add(duration / 2)
|
|
}
|