Licence check-in grace window: 7 days → 30 days (code, UI strings, docs) #799

Closed
opened 2026-09-28 03:32:08 +00:00 by Cordy · 0 comments
Owner

Decision (Nikola, 2026-09-28)

When a licensed instance cannot reach the licence server, it should keep full licensed behaviour for 30 days before falling back to the free tier. Today that window is 7 days. swisscairn.ch (public-sector page) already states 30 days, which is intentional: it becomes true with this issue, before launch.

Where 7 days lives today (main @ 72ce5a9)

Code

  • internal/license/manager.go: graceWindow = 7 * 24 * time.Hour. The retry cadence (retryInterval = 24h) and the check-in interval (30 days) stay as they are.
  • internal/license/license_test.go ~L142 builds FailingSince from graceWindow. Tests should keep deriving from the constant, and add one that asserts day 29 is still licensed and day 31 is not.
  • Check that the admin status exposes the right deadline: GraceDeadline is derived from graceWindow (manager.go ~L281), so it should follow automatically. Verify the admin bell / Licensing page show the new date.

Admin UI strings (web/static/index.html, all 4 languages)

  • licWrongUnreachVal: "…retries daily for 7 days, then falls back to the free tier"
  • licDropUnreachWhy: "…unreachable for more than seven days of daily attempts."
  • licBellDropGrace: "The licence server was unreachable for seven days. …"
  • Grep the file for any other "seven" / "7 days" tied to licensing.

Docs

  • docs/handbook/licensing-faq.md L43: "a 7-day daily-retry grace window"
  • README.md L173: "a 7-day grace window"
  • ARCHITECTURE.md L304: "daily retry with a 7-day admin-visible grace window". The separate 14-day revoked watch (#437) is unrelated; leave it unless we decide otherwise.
  • EULA.md: check the check-in paragraph for any stated period.
  • Add a CHANGELOG.md entry, since this changes behaviour an operator could observe.

Site (cairn-site, AlpineFiles redesign)

  • public-sector.html already says 30 days. Correct after this issue.
  • docs.html says "its week of grace", and the current main index says "a week of grace" / "week-long grace window". Flip both.
  • terms.html (draft) carries a todo: "confirm the grace period — the site currently says a week in one place and thirty days in another". Resolve it to 30 days.

Open question to settle in this issue

Keep the revoked-watch (14 days, #437) as it is, or align it? Default: leave it. A server that actively says "revoked" is a different situation from one that can't be reached.

Done when

  • graceWindow is 30 days, and tests cover the boundary.
  • All admin strings in 4 languages say 30 days / thirty days.
  • The handbook, README, ARCHITECTURE and EULA (if applicable) say 30 days.
  • A CHANGELOG entry is added.
  • The site no longer mentions a week anywhere.
## Decision (Nikola, 2026-09-28) When a licensed instance cannot reach the licence server, it should keep full licensed behaviour for **30 days** before falling back to the free tier. Today that window is 7 days. swisscairn.ch (public-sector page) already states 30 days, which is intentional: it becomes true with this issue, before launch. ## Where 7 days lives today (main @ 72ce5a9) **Code** - `internal/license/manager.go`: `graceWindow = 7 * 24 * time.Hour`. The retry cadence (`retryInterval` = 24h) and the check-in interval (30 days) stay as they are. - `internal/license/license_test.go` ~L142 builds `FailingSince` from `graceWindow`. Tests should keep deriving from the constant, and add one that asserts day 29 is still licensed and day 31 is not. - Check that the admin status exposes the right deadline: `GraceDeadline` is derived from `graceWindow` (manager.go ~L281), so it should follow automatically. Verify the admin bell / Licensing page show the new date. **Admin UI strings** (`web/static/index.html`, all 4 languages) - `licWrongUnreachVal`: "…retries daily for 7 days, then falls back to the free tier" - `licDropUnreachWhy`: "…unreachable for more than seven days of daily attempts." - `licBellDropGrace`: "The licence server was unreachable for seven days. …" - Grep the file for any other "seven" / "7 days" tied to licensing. **Docs** - `docs/handbook/licensing-faq.md` L43: "a 7-day daily-retry grace window" - `README.md` L173: "a 7-day grace window" - `ARCHITECTURE.md` L304: "daily retry with a 7-day admin-visible grace window". The separate 14-day revoked watch (#437) is unrelated; leave it unless we decide otherwise. - `EULA.md`: check the check-in paragraph for any stated period. - Add a `CHANGELOG.md` entry, since this changes behaviour an operator could observe. **Site (cairn-site, AlpineFiles redesign)** - public-sector.html already says 30 days. Correct after this issue. - docs.html says "its week of grace", and the current main index says "a week of grace" / "week-long grace window". Flip both. - terms.html (draft) carries a todo: "confirm the grace period — the site currently says a week in one place and thirty days in another". Resolve it to 30 days. ## Open question to settle in this issue Keep the revoked-watch (14 days, #437) as it is, or align it? Default: leave it. A server that actively says "revoked" is a different situation from one that can't be reached. ## Done when - `graceWindow` is 30 days, and tests cover the boundary. - All admin strings in 4 languages say 30 days / thirty days. - The handbook, README, ARCHITECTURE and EULA (if applicable) say 30 days. - A CHANGELOG entry is added. - The site no longer mentions a week anywhere.
Cordy closed this issue 2026-10-01 13:48:41 +00:00
Sign in to join this conversation.
No labels
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Cordy/Cairn#799
No description provided.