Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

Track annual transition refund exit preparation

rcourtman71810d420bb7
diff --git a/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md b/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md
index f540062d9b..6afc610e11 100644
--- a/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md
+++ b/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md
@@ -1,9 +1,9 @@
# Community transition refund preparation
-25 October 2026. Commercial preparation under L2 and L3. This slice adds an
-admin-only calculation of an annual transition refund from proposed announcement
-and release dates. It does not activate a programme, change the published offer,
-remove runtime gates or authorize payment actions.
+25 October 2026. Commercial preparation under L2 and L3. The preview and
+subsequent annual quote/apply preparation do not adopt programme dates, deploy
+the service, change the published offer, remove runtime gates or authorize
+production payment actions.
## Prepared boundary
@@ -29,9 +29,31 @@ purchase remedy is explicitly not evaluated, and monthly payments are out of
scope. Unsupported cohorts have private 422 reasons, distinct from unavailable
provider evidence.
-All provider operations are GETs. No subscription, refund, local licence,
-commercial projection, revocation event or customer email is changed. Existing
-full-refund and support-cancellation paths retain their current semantics.
+The preview makes provider GETs only and remains unexecutable. Its proposed
+dates cannot activate the separate annual exit authority.
+
+The annual exit extends the existing durable commercial quote authority.
+Original payment and policy terms bind real legacy/v6 targets through complete
+invoice and checkout chains. Only refund exits may omit a primary v6 licence;
+normal quote constraints and existing records are preserved by migration.
+The programme is absent by default and has no adopted dates.
+
+Permanent local rights with conflicting recurring billing links require
+manual reconciliation. Unrelated permanent purchases are preserved.
+
+Cancellation and refund each have a persisted, compare-and-set intent before
+their provider request. No lease reclaim resends an uncertain financial call.
+An authoritative canceled read, matching legacy termination, canonical v6
+projection/version-floor outbox and confirmed progress commit together before
+refund intent. Removing current programme configuration after cancellation
+does not discard that saved obligation. Pending refunds remain pending.
+
+All application subscription/refund writers share the active-exit fence.
+Read-only provider reconciliation remains available without an active
+programme. An uncertain cancellation that did not execute can release its
+local fence only through an explicit, audited operator attestation of provider
+evidence that the request cannot complete. An active read or elapsed time is
+insufficient. No financial request is repeated by that resolution.
## Remaining implementation
@@ -43,12 +65,15 @@ Pro retains supported investigation/actions, custom roles and reporting at
protected prices. The proposed Business checkout pause must be coherent with
public copy and preserve original rights and support promises.
-Before offering the annual exit, extend the existing commercial transition
-authority with a durable quote bound to the adopted programme, exact invoice
-and charge, and the applicable local licence generations. Re-read financial
-evidence before execution. A known pre-mutation failure differs from an
-uncertain financial outcome. Do not reclaim or automatically retry uncertain
-cancellation or refund work.
+Before offering the annual exit, adopt the programme and complete explicit
+prior-refund/credit, renewal-period and failed/absent-refund reconciliation.
+The prepared authority refuses ambiguous cases. A manual replacement needs
+provider evidence, exact payment binding and a retained purpose; it must not
+turn into an automatic financial retry. Outstanding customer invoices and
+pending invoice items require reconciliation because subscription cancellation
+can affect customer-wide collection. Keep the recent-first-purchase remedy
+separate and bind its exact original payment, rather than reuse email/newest-
+payment selection.
Confirmed cancellation must terminate paid rights through the canonical local
projection and version-floor path, including matching legacy entitlements.
@@ -58,8 +83,13 @@ credits/invoices, and customer-runtime convergence before activation. Full
recent-first-purchase remedies remain distinct from unused annual time.
These are active residuals in `community-commercial-transition-cutover`.
+
+Confirmed provider cancellation with an unconfirmed local projection is a
+separate manual recovery case. Reconcile changed/missing local rights before
+recording cancellation confirmed or authorizing payment; the negative
+cancellation resolution cannot apply to an already canceled subscription.
This record does not close the external commercial transition proof or claim
-that the free-feature release or complete refund executor has shipped.
+that the free-feature release or complete customer programme has shipped.
## Verification
@@ -67,5 +97,10 @@ The standalone license-server Go suite includes
`v6_commercial_refunds_test.go` for exact-payment admission, grandfathered and
current annual prices, currency preservation, partial/full prior refunds,
integer rounding, malformed evidence, interrupted reads, admin-only admission
-and absence of a public route. The source is prepared independently of any
-production deployment or provider test-mode mutation.
+and absence of a public route. `v6_commercial_refund_exits_test.go` covers
+legacy/v6 termination with unrelated purchases preserved, uncertain/pending
+provider outcomes, concurrent confirmations, atomic rollback, stale evidence,
+operator-attested negative resolution, late partial-refund events, existing
+writer fencing and upgrade preservation of ordinary customer quotes. The
+source is prepared independently of production deployment and provider
+test-mode mutation.
diff --git a/docs/release-control/v6/internal/status.json b/docs/release-control/v6/internal/status.json
index c7768b6b5e..43e9d39a81 100644
--- a/docs/release-control/v6/internal/status.json
+++ b/docs/release-control/v6/internal/status.json
@@ -9571,7 +9571,7 @@
},
{
"id": "community-commercial-transition-cutover",
- "summary": "Complete the notice-bound Community transition remedy through the commercial authority: adopted policy, exact-payment annual preview, durable quote/apply, prior-refund reconciliation, cross-generation entitlement termination and external event/runtime proof before customer activation.",
+ "summary": "Activate the notice-bound Community transition remedy after adopted policy, prior-refund/credit and renewal-period reconciliation, recent-first-purchase proof, failed/absent-refund recovery, production-schema migration proof and external event/runtime convergence. Annual legacy/v6 quote/apply preparation does not close these obligations.",
"owner": "project-owner",
"status": "planned",
"recorded_at": "2026-10-25",
diff --git a/docs/release-control/v6/internal/subsystems/cloud-paid.md b/docs/release-control/v6/internal/subsystems/cloud-paid.md
index b1515f340a..d1e7633fc5 100644
--- a/docs/release-control/v6/internal/subsystems/cloud-paid.md
+++ b/docs/release-control/v6/internal/subsystems/cloud-paid.md
@@ -26,13 +26,23 @@ commercial catalog without requiring a migrated v6 licence. The preview is not
an executable transition quote and never cancels, refunds, changes entitlements
or sends customer mail.
+The annual exit extends the existing quote authority with original-payment
+terms and real legacy/v6 targets. Intent precedes each provider mutation;
+canonical projection, legacy termination, version-floor outbox and confirmed
+cancellation progress share a transaction before refund intent. All application
+subscription/refund writers respect the active-exit fence. Uncertain outcomes
+are not lease-reclaimed, pending refunds remain pending, and an operator's
+negative cancellation resolution requires retained provider evidence rather
+than elapsed time. The programme is absent by default.
+
The Community history/probe/seat boundary and Business sales pause remain
-pending the notice-bound cutover. Before a refund exit is offered, the existing
-commercial authority still needs a durable, policy-bound quote and one-attempt
-execution with exact cancellation, original-payment refund, cross-generation
-entitlement termination, version-floor invalidation and reconciliation proof.
-No payment effect may be inferred from an unsigned preview or its dates. The
-preparation record is
+pending the notice-bound cutover. Before a refund exit is offered, adopt the
+programme and complete prior-refund/credit and renewal-period reconciliation,
+the separate recent-first-purchase remedy, failed/absent-refund recovery,
+production-schema migration proof and external event/runtime convergence.
+Customer-wide outstanding billing requires explicit reconciliation. No payment
+effect may be inferred from an unsigned preview or its dates. The preparation
+record is
`docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md`.
### Reporting measurement precedes commercial feature decisions
@@ -324,6 +334,13 @@ establish Compose mounts, tenant provisioning or installed provider recovery.
89. `pulse-pro:license-server/entrypoint.sh.template`
90. `pulse-pro:license-server/secrets.env.template`
91. `pulse-pro:license-server/v6_commercial_refunds.go`
+92. `pulse-pro:license-server/v6_commercial_refund_exits.go`
+93. `pulse-pro:license-server/v6_commercial_refund_quotes.go`
+94. `pulse-pro:license-server/v6_commercial_refund_schema.go`
+95. `pulse-pro:license-server/v6_commercial_projection.go`
+96. `pulse-pro:license-server/v6_schema.go`
+97. `pulse-pro:license-server/admin_refund_provider.go`
+98. `pulse-pro:license-server/admin_support.go`
## Shared Boundaries
diff --git a/docs/release-control/v6/internal/subsystems/registry.json b/docs/release-control/v6/internal/subsystems/registry.json
index fbf77b6e7d..ede9dc6626 100644
--- a/docs/release-control/v6/internal/subsystems/registry.json
+++ b/docs/release-control/v6/internal/subsystems/registry.json
@@ -3702,6 +3702,8 @@
"pulse-pro:landing-page/index.html",
"pulse-pro:landing-page/manage.html",
"pulse-pro:landing-page/thanks.html",
+ "pulse-pro:license-server/admin_refund_provider.go",
+ "pulse-pro:license-server/admin_support.go",
"pulse-pro:license-server/admin_ui.go",
"pulse-pro:license-server/entrypoint.sh.template",
"pulse-pro:license-server/grandfathering.go",
@@ -3711,11 +3713,16 @@
"pulse-pro:license-server/secrets.env.template",
"pulse-pro:license-server/self_hosted_feature_catalog.generated.go",
"pulse-pro:license-server/v6_checkout.go",
+ "pulse-pro:license-server/v6_commercial_projection.go",
+ "pulse-pro:license-server/v6_commercial_refund_exits.go",
+ "pulse-pro:license-server/v6_commercial_refund_quotes.go",
+ "pulse-pro:license-server/v6_commercial_refund_schema.go",
"pulse-pro:license-server/v6_commercial_refunds.go",
"pulse-pro:license-server/v6_commercial_transitions.go",
"pulse-pro:license-server/v6_grants.go",
"pulse-pro:license-server/v6_handlers.go",
"pulse-pro:license-server/v6_reconcile.go",
+ "pulse-pro:license-server/v6_schema.go",
"pulse-pro:license-server/v6_store.go",
"pulse-pro:relay-server/main.go",
"pulse-pro:relay-server/registry.go",
@@ -3808,6 +3815,7 @@
"allow_same_subsystem_tests": false,
"test_prefixes": [],
"exact_files": [
+ "pulse-pro:license-server/v6_commercial_refund_exits_test.go",
"pulse-pro:license-server/v6_commercial_transitions_test.go"
]
},
@@ -4501,6 +4509,7 @@
"pkg/licensing/activation_store_test.go",
"pkg/licensing/grant_refresh_test.go",
"pkg/licensing/installation_status_poll_test.go",
+ "pulse-pro:license-server/v6_commercial_refund_exits_test.go",
"pulse-pro:license-server/v6_commercial_refunds_test.go",
"pulse-pro:license-server/v6_status_test.go"
]
@@ -4549,7 +4558,8 @@
"test_prefixes": [],
"exact_files": [
"pulse-pro:license-server/commercial_strict_json_test.go",
- "pulse-pro:license-server/main_test.go"
+ "pulse-pro:license-server/main_test.go",
+ "pulse-pro:license-server/v6_commercial_refund_exits_test.go"
]
},
{
@@ -4580,8 +4590,34 @@
"allow_same_subsystem_tests": false,
"test_prefixes": [],
"exact_files": [
+ "pulse-pro:license-server/v6_commercial_refund_exits_test.go",
"pulse-pro:license-server/v6_commercial_refunds_test.go"
]
+ },
+ {
+ "id": "community-transition-refund-exit",
+ "label": "annual transition refund binding and one-attempt execution proof",
+ "match_prefixes": [],
+ "match_files": [
+ "pulse-pro:license-server/admin_refund_provider.go",
+ "pulse-pro:license-server/admin_support.go",
+ "pulse-pro:license-server/v6_commercial_projection.go",
+ "pulse-pro:license-server/v6_commercial_refund_exits.go",
+ "pulse-pro:license-server/v6_commercial_refund_quotes.go",
+ "pulse-pro:license-server/v6_commercial_refund_schema.go",
+ "pulse-pro:license-server/v6_schema.go"
+ ],
+ "allow_same_subsystem_tests": false,
+ "test_prefixes": [],
+ "exact_files": [
+ "pulse-pro:license-server/admin_refund_preflight_test.go",
+ "pulse-pro:license-server/admin_refund_safety_test.go",
+ "pulse-pro:license-server/admin_support_test.go",
+ "pulse-pro:license-server/v6_commercial_projection_test.go",
+ "pulse-pro:license-server/v6_commercial_refund_exits_test.go",
+ "pulse-pro:license-server/v6_commercial_transitions_test.go",
+ "pulse-pro:license-server/v6_store_test.go"
+ ]
}
],
"match_files": null