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.

Record Community transition refund preparation

rcourtman8bbde3f35472
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
new file mode 100644
index 0000000000..f540062d9b
--- /dev/null
+++ b/docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md
@@ -0,0 +1,71 @@
+# 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.
+
+## Prepared boundary
+
+`pulse-pro:license-server/v6_commercial_refunds.go` binds the requested
+subscription and invoice to a configured annual Pulse price, one complete annual
+line, its paid payment intent and exact captured charge. Customer, subscription,
+price, invoice, payment and currency must agree throughout. Missing, ambiguous,
+prorated, disputed or contradictory evidence stops the preview. A release
+outside the selected paid period requires reconciliation.
+
+Amounts use actual captured minor units rather than list prices or converted
+currency. The calculation requires at least 30 days between proposed notice and
+release, and reports the 60-day claim deadline. Its version identifies the
+calculation policy, not an activated customer programme. Both current annual
+prices and grandfathered recurring annual prices work without a v6 licence row.
+The preview is explicitly unexecutable.
+
+Prior refunds produce only a cash-bounded ceiling and a reconciliation status.
+The preview cannot infer whether an earlier refund was a transition remedy,
+goodwill or a price adjustment. An invoice balance adjustment similarly
+withholds an additional-refund recommendation. The separate recent-first-
+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.
+
+## Remaining implementation
+
+Keep the public free-feature change out of the automatic release train until
+the notice and effective release are coordinated. Community history, remote
+probes and ordinary accounts must not regain removed restrictions through old
+grants or lapse. Preserve configured physical retention and existing data.
+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.
+
+Confirmed cancellation must terminate paid rights through the canonical local
+projection and version-floor path, including matching legacy entitlements.
+Partial refund webhooks alone do not perform that termination. Prove event
+order, replay, renewal between preview and execution, lack of unintended
+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`.
+This record does not close the external commercial transition proof or claim
+that the free-feature release or complete refund executor has shipped.
+
+## Verification
+
+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.
diff --git a/docs/release-control/v6/internal/status.json b/docs/release-control/v6/internal/status.json
index 36fbdbe6a7..c7768b6b5e 100644
--- a/docs/release-control/v6/internal/status.json
+++ b/docs/release-control/v6/internal/status.json
@@ -5161,6 +5161,10 @@
{
"kind": "lane-followup",
"id": "cloud-commercial-transition-external-proof"
+ },
+ {
+ "kind": "lane-followup",
+ "id": "community-commercial-transition-cutover"
}
]
},
@@ -9564,6 +9568,24 @@
"subsystem_ids": [
"deployment-installability"
]
+ },
+ {
+ "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.",
+ "owner": "project-owner",
+ "status": "planned",
+ "recorded_at": "2026-10-25",
+ "lane_ids": [
+ "L3"
+ ],
+ "subsystem_ids": [
+ "cloud-paid"
+ ],
+ "repo_ids": [
+ "pulse",
+ "pulse-pro"
+ ],
+ "cross_repo": true
}
],
"coverage_gaps": [
diff --git a/docs/release-control/v6/internal/subsystems/cloud-paid.md b/docs/release-control/v6/internal/subsystems/cloud-paid.md
index 2d9c6e506c..b1515f340a 100644
--- a/docs/release-control/v6/internal/subsystems/cloud-paid.md
+++ b/docs/release-control/v6/internal/subsystems/cloud-paid.md
@@ -15,6 +15,26 @@
## Purpose
+### Community transition refund preparation
+
+`pulse-pro:license-server/v6_commercial_refunds.go` owns the admin-only annual
+transition refund preview. Its proposed announcement and release dates do not
+activate a programme. It reads an exact configured annual subscription,
+invoice, payment intent and captured charge, in the charge's original integer
+currency units. Both grandfathered recurring and current prices use the existing
+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 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
+`docs/release-control/v6/internal/records/community-transition-refund-preparation-2026-10-25.md`.
+
### Reporting measurement precedes commercial feature decisions
Schema-v20 reporting usage exports only aggregate generation by closed report
@@ -303,6 +323,7 @@ establish Compose mounts, tenant provisioning or installed provider recovery.
88. `pulse-pro:license-server/README.md`
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`
## Shared Boundaries
diff --git a/docs/release-control/v6/internal/subsystems/registry.json b/docs/release-control/v6/internal/subsystems/registry.json
index c1aaa3bd4e..fbf77b6e7d 100644
--- a/docs/release-control/v6/internal/subsystems/registry.json
+++ b/docs/release-control/v6/internal/subsystems/registry.json
@@ -3711,6 +3711,7 @@
"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_refunds.go",
"pulse-pro:license-server/v6_commercial_transitions.go",
"pulse-pro:license-server/v6_grants.go",
"pulse-pro:license-server/v6_handlers.go",
@@ -4500,6 +4501,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_refunds_test.go",
"pulse-pro:license-server/v6_status_test.go"
]
},
@@ -4567,6 +4569,19 @@
"pulse-pro:license-server/main_test.go",
"pulse-pro:scripts/tests/test_grandfathered_recurring_cutover_preview.py"
]
+ },
+ {
+ "id": "community-transition-refund-preview",
+ "label": "read-only exact-payment annual transition refund calculation proof",
+ "match_prefixes": [],
+ "match_files": [
+ "pulse-pro:license-server/v6_commercial_refunds.go"
+ ],
+ "allow_same_subsystem_tests": false,
+ "test_prefixes": [],
+ "exact_files": [
+ "pulse-pro:license-server/v6_commercial_refunds_test.go"
+ ]
}
],
"match_files": null