====== FR-CFG-005 — Configuration Version History ======

[[dido:02-crusible:99-annexes:annex-c-requirements:03-functional-requirements:03-01-configuration-management:start|Go to Crucible Configuration Management Requirements]]

===== Statement =====

[[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]] SHALL maintain the complete version history of each [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configuration]].

===== Derived From =====

This requirement derives from:

  * Crucible System Requirements Specification, Version 1.1 Draft, Functional Requirements, Configuration Management, FR-CFG-005

The Original Requirement states:

> //The system SHALL maintain complete configuration version history.//[[dido:02-crusible:99-annexes:annex-b:cr-001|[C1]]]

FR-CFG-005:

  * Replaces **The system** with the defined system name [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]]
  * Identifies the [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configuration]] as the configuration whose version history is maintained

No other substantive normalization is required.

===== Rationale =====

The version history of an [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configuration]] records the revisions of that configuration over time.

Maintaining the complete version history allows an authorized user or process to identify and retrieve earlier and current configuration revisions.

The version history supports separately governed activities such as:

  * Revision comparison
  * Historical configuration retrieval
  * Change review
  * Configuration restoration
  * Configuration audit
  * [[dido:99_annexes:annex-b-terms-and-definitions:r:reproducibility|Reproducibility]]

===== Applies To =====

This requirement applies to:

  * [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]]
  * [[dido:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configurations]]
  * Infrastructure Configuration revisions
  * Configuration version history
  * [[dido:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]]

===== Verification =====

Verification confirms that:

  - A tested Infrastructure Configuration has two or more revisions
  - [[dido:99_annexes:annex-b-terms-and-definitions:c:crucible|Crucible]] retains each tested revision in the configuration version history
  - Each tested revision remains distinguishable from the other tested revisions
  - An authorized user or process can identify and retrieve each tested revision
  - Creation of a succeeding revision does not overwrite a preceding revision
  - The version history identifies the order of the tested revisions

===== Referenced By =====

The following pages reference this requirement:

{{backlinks>.#dido:02-crusible}}

===== Implementation Status =====

Implemented and Verified

===== Requirement Status =====

<todo>Review and approve FR-CFG-005 as a leaf requirement.</todo>

----
===== Issues =====

<todo>Determine whether Configuration Version History requires a controlled definition in the shared Terms and Definitions corpus.</todo>

<todo>Determine whether separate requirements define revision metadata, retention periods, deletion controls, comparison, or restoration.</todo>

----
===== Notes for Editors =====

This requirement page retains the stable requirement identifier ''FR-CFG-005''.

This page is a leaf requirement page and omits a trailing '':start'' from its namespace.

The Statement preserves the approved source intent by requiring Crucible to maintain the complete version history of each Infrastructure Configuration.

Do not add approval status, authorship, timestamps, change rationale, retention periods, deletion controls, comparison, restoration, deployment association, provenance, or traceability obligations to the Statement unless the controlling requirement changes through an approved requirements process.

To reference this requirement Statement from another wiki page, insert:

<code dokuwiki>
{{section>dido:02-crusible:99-annexes:annex-c-requirements:03-functional-requirements:03-01-configuration-management:fr-cfg-005#Statement&noheader&nofooter&noeditbtn}}
</code>

----

<WRAP centeralign>
© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
</WRAP>