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.

In the app:LockfilesOpen screen

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.

Reproduce approvals
Reconstruct the catalog context behind a release, procurement decision, or incident.
Detect assumption drift
Fail a review or CI check when the catalog release changes or a deployment disappears.

Create the lockfile

  1. Complete the registry, cost, and policy review first.
  2. Select the project that owns the decision.
  3. Enter one or more deployment public IDs separated by commas.
  4. 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

  1. Return to Lockfiles after a catalog release or before a production release.
  2. Select Verify on the saved record.
  3. 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

valid
boolean
True only when the digest matches, the catalog release is current, and every pinned deployment still exists.
release_changed
boolean
Signals that the catalog has advanced since the decision was pinned.
missing_deployment_ids
string[]
Deployments that no longer resolve in the current catalog.
actual_sha256
string
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.