Pin a reproducible decision with lockfiles
Freeze the catalog release and deployment IDs behind an approved decision, then verify whether the assumptions still hold later.
Why pin a decision
“We chose model X” is not reproducible. A useful decision record must identify the exact deployments, the catalog release used to evaluate them, and a content digest that proves the record was not changed.
Create the lockfile
- Complete the registry, cost, and policy review first.
- Select the project that owns the decision.
- Enter one or more deployment public IDs separated by commas.
- Select Create lockfile. ALLM adds the current catalog release and stores a canonical SHA-256 digest.
Pinned content
{
"catalog_release_id": "cat_2026_07_22_01",
"deployment_ids": [
"dep_openai_gpt_5_1_responses_global",
"dep_anthropic_claude_sonnet_4_5_messages_global"
]
}Store the evidence
Select Download and commit the JSON file beside the service or configuration it governs. Record the lockfile ID, content digest, policy version, approver, and business context in the pull request or change record.
The downloaded file is an input, not a guarantee
Reproducibility comes from verifying the file whenever the catalog changes—not from creating it once and forgetting it.
Verify after drift
- Return to Lockfiles after a catalog release or before a production release.
- Select Verify on the saved record.
- Review the Latest result. If invalid, inspect release drift and missing deployment IDs before approving a new lockfile.
Example verification result
{
"valid": false,
"actual_sha256": "6f2e…a104",
"expected_sha256": "6f2e…a104",
"locked_catalog_release_id": "cat_2026_07_22_01",
"current_catalog_release_id": "cat_2026_08_03_01",
"release_changed": true,
"missing_deployment_ids": []
}Interpret verification
validboolean
True only when the digest matches, the catalog release is current, and every pinned deployment still exists.
release_changedboolean
Signals that the catalog has advanced since the decision was pinned.
missing_deployment_idsstring[]
Deployments that no longer resolve in the current catalog.
actual_sha256string
Digest recalculated from canonical lockfile content.
Availability
Creating lockfiles requires Pro or Business and an owner, admin, or developer role. Owners, admins, developers, and viewers can verify them.
Building the same workflow in code?