Skip to main content

Specification Lifecycle

The PTI specification exists at two levels: individual RFCs and released specification bundles (e.g., Specification v1.0). This document describes how both evolve under ecosystem governance.

RFC-level lifecycle

Each RFC follows the status ladder defined in RFC Process:

StatusNormative weightImplementer expectation
DraftInformative onlyPrototype at own risk
ReviewInformative; feedback solicitedPilot interoperability tests welcome
CandidateProvisional normativeMay build against with migration expectation
AcceptedNormative for new workSHOULD implement for target profile
StableBinding for certificationMUST implement for certified profile
DeprecatedSupersededSHOULD migrate by published date
RetiredHistoricalMUST NOT use for new certifications

Specification bundle lifecycle

A specification bundle (such as v1.0) is a curated snapshot referencing RFC statuses at release time.

Bundle states

Bundle stateMeaning
CurrentRecommended target for new implementations
MaintainedReceives errata and security fixes; no new features
Extended supportCritical security patches only
End of lifeNo further patches; certificates not renewed

Release types

Aligned with Version Management:

TypeRFC impactBundle example
MajorBreaking changes allowed with policyv2.0
MinorAdditive RFCs, new optional capabilitiesv1.1
Patch / errataClarifications, test fixes, non-semantic correctionsv1.0.1

A minor bundle release MAY promote RFCs from Accepted to Stable without a major version if no breaking change is introduced.

Lifecycle gates

Promotion between bundle states MUST satisfy:

Current → Maintained

  • Successor minor or major release published
  • Minimum 12 months as Current RECOMMENDED
  • Migration guide available per Breaking Changes Policy

Maintained → Extended support

  • Working Group vote with public notice (≥90 days)
  • Conformance Program publishes sunset timeline for certifications

Extended support → End of life

  • All Stable RFCs in bundle Deprecated or Retired with replacements
  • Final security advisory review by SRG

Errata process

Errata correct unintended ambiguity without changing interoperable behavior.

  1. Reporter files errata proposal with test case demonstrating ambiguity
  2. Maintainer triages; SHOULD respond within 14 days
  3. If behavior clarification affects implementations differently, treat as minor RFC revision — not errata
  4. Accepted errata MUST update conformance tests if applicable

Relationship to conformance

RFC / bundle statusConformance impact
Stable RFCMUST appear in profile requirements for applicable profiles
Accepted RFCMAY be optional until Stable
Deprecated RFCRemoved from new certifications; grandfather period documented
Retired RFCExisting certificates MUST NOT renew

See Conformance Program.

Publication artifacts

Each bundle release MUST publish:

  • RFC index with statuses (RFC Index)
  • Changelog referencing RFC IDs and Git revisions
  • Updated profile matrices
  • Migration notes for implementers upgrading from prior bundle