Upgrading components¶

New models come out all the time. hlock upgrade tells you which locked components have newer versions available, re-measures the stack with them, and only changes your lock when you ask. It always keeps the previous lock, so you can roll back.

Plan¶

By default upgrade only plans:

$ hlock upgrade --all
component  locked      available
planner    qwen-7b  →  qwen-32b
plan: 1 upgrade(s) available — rerun with --apply to perform.
next → hlock upgrade --all --apply

Upgrade one target instead of everything with --to:

hlock upgrade --to qwen-32b

Apply¶

$ hlock upgrade --all --apply
component  locked      available
planner    qwen-7b  →  qwen-32b
✓ upgraded  success rate 100% → 100%  (previous lock kept at harness.lock.prev)

Applying re-runs the task pack on the upgraded stack and compares success rates. If the success rate drops, the upgrade is rolled back automatically. Pass --force to keep it anyway.

Roll back¶

$ hlock upgrade --rollback
✓ restored harness.lock from harness.lock.prev

Reviewing an upgrade¶

Because the lock is a committed file, an upgrade is a reviewable diff:

hlock upgrade --all --apply
git diff harness.lock     # model, fingerprint, and evidence changes side by side