Release, schedule and restore rule versions

Purpose

A release makes a reviewed expression available to consumers. Version history lets staff explain and reverse that choice.

How It Works

A publisher reviews the draft, its validation and comparison with the earlier release. Effective dates support planned changes. An optional simulation adds a view of the likely impact. The publisher commits the release and receives its numbered version. Following consumers can then use the effective expression. Compatibility checks expose followers that cannot support the change. A forced release suspends those incompatible uses for repair. The publisher can inspect older versions and restore an earlier expression through a fresh release. Racing edits or releases can produce conflicts requiring a reload. Publication has no active second-person approval stage.

Relationships

Author a readable eligibility rule provides the draft to review and release.

Show evidence (sources, provenance, origins, pinned commits)

The Formal Contract

The narrative above explains; the sections below are authoritative — the rules, scenarios and tests this document binds.

Outcomes: Following consumers select the effective published expression.Restoration releases an earlier expression as a new version.Release history attributes changes to their authors.
Surfaces: consoleapi
Intent sources: services-platform:docs/milestones/plans/PLAT-M11-plan.md#1. Objectiveservices-platform:docs/milestones/plans/PLAT-M11-plan.md#D4services-platform:docs/milestones/plans/PLAT-M11-plan.md#A3services-platform:docs/proposals/eligibility/17-decision-register.md#D-14

Controls

28 controls apply, from the corpus control catalogue.

TC-AVL-004 TC-AVL-005 TC-AZ-001 TC-AZ-002 TC-AZ-003 TC-AZ-004 TC-IAM-001 TC-IAM-002 TC-IAM-004 TC-IAM-005 TC-IAM-006 TC-LOG-001 TC-LOG-002 TC-LOG-003 TC-LOG-004 TC-LOG-005 TC-MON-001 TC-PI-001 TC-PI-002 TC-PI-003 TC-PI-004 TC-PI-005 TC-TEN-001 TC-TEN-002 TC-TEN-003 TC-VEN-001 TC-VEN-002 TC-VEN-003

Permissions

Key	Checked at	Scope
`platform.eligibility.publish`	api	tenant
`platform.eligibility.read`	api	tenant

Business Rules

13 rules, 12 to be proved before approval. A rule's product intent is derived from its origin: 13 confirmed by a product decision, the rest inheriting this capability's confirmed.

Id	Rule	Kind	Enforced at	Provenance
`01`must prove Confirmed	Publishing and restoring earlier expressions require the sensitive publish permission; lacking it rejects the request without a change. proved by `ATS-PFM-ELG-004-01`, `TST-PFM-ELG-185`, `TST-PFM-ELG-411`	permission	api	test services-platform:modules/eligibility/tests/e2e/eligibility-definitions.e2e.spec.js#refuses the publish to a writer without the publish permission, 403
`02`must prove Confirmed	Publication rejects validation errors and unlicensed application conditions, including those reached through references, while warnings remain nonblocking. origin: services-platform:docs/proposals/eligibility/17-decision-register.md#D-07 proved by `ATS-PFM-ELG-001-18`, `ATS-PFM-ELG-004-02`, `ATS-PFM-ELG-004-13`, `TST-PFM-ELG-166`, `TST-PFM-ELG-188`, `TST-PFM-ELG-435`	validation	service	test services-platform:modules/eligibility/tests/integration/services/governance/publish.integration.spec.js#refuses a condition type of an application the tenant is not licensed for
`03`must prove Confirmed	Publication assigns the draft its next permanent version number and supersedes the previous publication when their effective periods overlap. proved by `ATS-PFM-ELG-004-03`, `ATS-PFM-ELG-004-14`, `ATS-PFM-ELG-005-10`, `TST-PFM-ELG-435`	lifecycle	service, database	test services-platform:modules/eligibility/tests/integration/services/governance/publish.integration.spec.js#publishes the next draft as version 2 and supersedes version 1
`04`must prove Confirmed	Effective periods include their starting day and exclude their ending day; overlap with an older publication is rejected, while a disjoint latest publication remains effective for its own period. proved by `ATS-PFM-ELG-004-04`, `TST-PFM-ELG-163`, `TST-PFM-ELG-165`, `TST-PFM-ELG-462`	validation	service	test services-platform:modules/eligibility/tests/integration/services/persistence/versions.integration.spec.js#refuses a publish whose range overlaps a published version other than the last one, naming it, and leaves the draft
`05`must prove Confirmed	Effective dates must exist in the calendar, and an impossible date is rejected with its field identified. proved by `ATS-PFM-ELG-004-05`, `TST-PFM-ELG-413`	validation	api, service	test services-platform:modules/eligibility/tests/e2e/eligibility-governance-repairs.e2e.spec.js#refuses a draft with effective_from 2027-02-31, 400, naming the field
`06`must prove Confirmed	Publication rejects a version that no longer fits an active following use unless explicitly forced, in which case incompatible followers are suspended. origin: services-platform:docs/milestones/plans/PLAT-M11-plan.md#D4 proved by `ATS-PFM-ELG-004-06`, `ATS-PFM-ELG-004-15`, `ATS-PFM-ELG-007-17`, `TST-PFM-ELG-089`, `TST-PFM-ELG-434`	policy	service	test services-platform:modules/eligibility/tests/integration/services/governance/publish-followers.integration.spec.js#refuses the publish as unfit_followers, naming the binding and what its kind does not supply
`07`must prove Confirmed	Publication removes plans for the changed rule and every expression that follows it through references; a direct pin to the unchanged earlier version retains its plan. proved by `ATS-PFM-ELG-004-07`, `ATS-PFM-ELG-004-16`, `ATS-PFM-ELG-010-07`, `TST-PFM-ELG-178`, `TST-PFM-ELG-434`	invariant	service	test services-platform:modules/eligibility/tests/integration/services/governance/publish-followers.integration.spec.js#finds every rule that inlines C at any depth, and none that pins a version of C
`08`must prove Confirmed	Rollback revalidates an earlier expression and copies its dependencies into the next publication with a rollback note, preserving any current draft. proved by `ATS-PFM-ELG-004-08`, `TST-PFM-ELG-169`, `TST-PFM-ELG-435`, `TST-PFM-ELG-462`	lifecycle	service	test services-platform:modules/eligibility/tests/integration/services/governance/publish.integration.spec.js#publishes version 1’s rule as version 3 with the rollback note, superseding version 2
`09`must prove Confirmed	Only one concurrent attempt publishes a draft; the losing attempt receives the winning version and publication time in a stale-change refusal without the publisher’s identity. proved by `ATS-PFM-ELG-004-09`, `TST-PFM-ELG-003`, `TST-PFM-ELG-180`, `TST-PFM-ELG-435`	invariant	service, database	test services-platform:modules/eligibility/tests/integration/services/governance/publish.integration.spec.js#refuses the loser with StaleObject naming the winner’s version and when it was published, not IllegalOperation
`10`must prove Confirmed	The published expression is the expression validated for that request; a racing save can land beforehand, remain as a later draft or produce a stale-change or retryable-conflict refusal. proved by `ATS-PFM-ELG-004-10`, `TST-PFM-ELG-004`, `TST-PFM-ELG-181`	invariant	service	test react-console:acceptance/eligibility/playwright/journeys/governance/ELIG-ACC-0149.spec.ts#ELIG-ACC-0149
`11`must prove Confirmed	History presents versions newest first, includes the draft and compares any pair through readable additions, removals and changes. proved by `ATS-PFM-ELG-004-11`, `TST-PFM-ELG-170`, `TST-PFM-ELG-411`, `TST-PFM-ELG-432`	calculation	service	test services-platform:modules/eligibility/tests/integration/services/governance/diff.integration.spec.js#answers every change from version 1 to the draft, version 2, with its sentence and the counts
`12`must prove Confirmed	Rule and binding writes create attributable change events, with publication versions, change counts and the simulation choice; refused writes create none. proved by `ATS-PFM-ELG-004-12`, `ATS-PFM-ELG-004-17`, `ATS-PFM-ELG-011-09`, `TST-PFM-ELG-189`, `TST-PFM-ELG-435`	invariant	service	test services-platform:modules/eligibility/tests/integration/services/governance/publish.integration.spec.js#records the publish with its versions and the size of its diff
`13` Confirmed	Publication has no second-approver requirement because the console’s conditional approval stage has no setting that activates it. origin: services-platform:docs/milestones/plans/PLAT-M11-plan.md#A3	policy	console	observed react-console:lib/eligibility/status.ts:requiresApproval

Scenarios

Id	Given	When	Then	Provenance
`01`	A member price follows the first release while an audit use pins it.	A publisher releases a second expression admitting inactive members.	The price follows the new effective release and the auditor retains the pin.	test react-console:acceptance/eligibility/playwright/journeys/governance/ELIG-ACC-0130.spec.ts#ELIG-ACC-0130
`02`	Two releases have disjoint periods before and after the year boundary.	Evaluation is requested on either side of that boundary.	The expression effective for the selected day answers.	test react-console:acceptance/eligibility/playwright/journeys/governance/ELIG-ACC-0131.spec.ts#ELIG-ACC-0131

Edge Cases

Id	Given	When	Then	Provenance
`03`	A future release follows an open-ended current expression.	The publisher attempts a correction for the earlier period.	Overlapping earlier periods fail, and a rollback with an appropriate end restores the present expression.	test react-console:acceptance/eligibility/playwright/journeys/governance/ELIG-ACC-0133.spec.ts#ELIG-ACC-0133

Planning

Implementation

Release, schedule and restore rule versions ​

Purpose ​

How It Works ​

Relationships ​