Version 2 defaults prefer-canonical-src to yes, which is only safe with a
non-zero ref-op-cost: the tie-break concentrates references onto canonical
extents, and ref-op-cost is the term that prices moving them. With
ref-op-cost = 0, a references corpus run did about 70 times the
reference-redirect work of a build without the tie-break (56.7M vs 804K
redirects).
Use 53, the same weight as ref-cost and extent-cost: one rewritten
reference costs about one extent item. Version 1 keeps 0.
Assisted-by: Claude-Code:claude-opus-5-5
single extent, biasing the planner against dedupes that move a large
reference cluster for little physical gain — a brake on the reference-cluster
growth that low reference limits can otherwise cause.
- * Default: `0` (disabled — the term contributes nothing, so the cost model is
- unchanged until an operator opts in).
+ * Default: `53`, the same as `ref-cost` (config version 1 and `v0.11`: `0`,
+ which disables the term).
* Accepts a [size value](config-format.md#size-values).
* **`snapshot-sharing`**
# Percentage with %, or a size value (e.g. 128K, 1M - 4K).
free-min = 128K
+ # Space-debt weight per reference a plan rewrites. Prices the
+ # reference movement that prefer-canonical-src drives.
+ ref-op-cost = 53
+
# The [resolve] section controls how bees maps physical addresses back to
# the files that reference them.