Lifecycle Guarantees Reference
[!IMPORTANT] Non-Normative Document
This document is informative only.
[!NOTE] Verified Source Model This page is a Documentation-surface first projection of the same upstream assets currently bound to the Validation Lab
/guaranteesroute:
- V1 direct runtime source:
Validation_Lab/governance/LIFECYCLE_GUARANTEES.yaml- V2 direct runtime source:
Validation_Lab/public/_data/v2/rulesets/ruleset-v2.0.0.json- Supporting provenance:
Validation_Lab/governance/TERMINOLOGY_MAPPING.mdThis docs page does not replace the Validation Lab route or its bound source assets.
Current Guarantees Model
The current public guarantees model in Validation Lab is aggregate, not single-source:
- Legacy V1 line:
LG-01throughLG-05fromLIFECYCLE_GUARANTEES.yaml - V2 baseline line: deterministic baseline clauses from
ruleset-v2.0.0.json
That means this page must distinguish two guarantee lines that coexist on the current Lab surface.
- Flow-01~05 = Protocol test scenarios defined in the main repository under
tests/golden/flows/ - LG-01~05 = Legacy Validation Lab lifecycle guarantees defined in
Validation_Lab/governance/LIFECYCLE_GUARANTEES.yaml - V2 baseline clauses = deterministic clause identifiers such as
PROV-V2-01andDET-V2-01defined in the V2 ruleset bundle
These are distinct naming spaces and should not be conflated.
Legacy V1 Lifecycle Guarantees
The V1 guarantee line remains frozen in LIFECYCLE_GUARANTEES.yaml and is currently tied to ruleset-1.0.
| ID | Internal ID | Name | Description | Evidence Hint |
|---|---|---|---|---|
| LG-01 | gf-01 | Single Agent Lifecycle | Evaluates presence of context, plan, and trace artifacts. | artifacts/context.json, artifacts/plan.json, artifacts/trace.json |
| LG-02 | gf-02 | Multi-Agent Collaboration | Evaluates presence of timeline events. | timeline/events.ndjson |
| LG-03 | gf-03 | Human-in-the-Loop Gating | Evaluates presence of confirm decision records. | artifacts/context.json (confirm field) |
| LG-04 | gf-04 | Drift Detection & Recovery | Evaluates presence of manifest file. | manifest.json |
| LG-05 | gf-05 | External Tool Integration | Evaluates presence of integrity checksums. | integrity/sha256sums.txt |
Under ruleset-1.0, this guarantee line is still presence-level.
The V1 YAML also records what is not yet evaluated semantically under that legacy line.
V2 Baseline Clause Bundle
The current Lab /guarantees route also renders a V2 baseline clause bundle from ruleset-v2.0.0.json.
This is the verified V2 source currently bound to the guarantees route, even though newer V2 bundles may exist elsewhere in the broader ruleset inventory.
| Clause ID | Name | Severity | Evaluation Type |
|---|---|---|---|
PROV-V2-01 | Substrate Reference Integrity | CRITICAL | EXISTENCE |
PROV-V2-02 | Lock Integrity Enforcement | CRITICAL | JSON_MATCH |
LIFECYCLE-V2-01 | Trace Artifact Existence | CRITICAL | EXISTENCE |
LIFECYCLE-V2-02 | Timeline Data Presence | CRITICAL | MIN_COUNT |
TRUST-V2-01 | Runner Seal Verification | CRITICAL | JSON_MATCH |
DET-V2-01 | Canonical Determinism Proof | CRITICAL | JSON_MATCH |
METADATA-V2-01 | Execution Timestamp Integrity | WARNING | JSON_MATCH |
How to Read This Page
Use this page as a Documentation reference projection for the current guarantees model:
- If you need the frozen legacy LG definitions, go to the V1 YAML.
- If you need the V2 baseline clause bundle currently displayed on the Lab guarantees surface, go to
ruleset-v2.0.0.json. - If you need the live Lab rendering and navigation behavior, use Lab Site: Guarantees.
Related Resources
- Validation Lab Overview — Four boundaries and terminology
- Ruleset Reference — Verified V1/V2 ruleset source model
- Evidence Pack Contract — Current public contract model
- Lab Site: Guarantees — Live aggregate reference