Fuse

Fuse combines two snapshots into one new snapshot. The source snapshots stay untouched, and path conflicts are resolved by a fixed left-first rule.

What Fuse is

Fuse is snapshot composition. You choose a left snapshot, choose a right snapshot, and create a brand-new output snapshot from the result.

It does not rewrite the originals. Their history remains as-is, while the composed result becomes a new checkpoint you can keep in its own space.

Left-first rule

Fuse has one conflict rule: left wins. If both snapshots contain the same path, the left snapshot decides the result.

Because the rule is fixed, there is no interactive conflict resolution step. Order is the decision.

  • Left snapshot: baseline and source of truth on conflicting paths.
  • Right snapshot: additional material that is applied where the left side does not already decide the path.
  • Output snapshot: a newly created checkpoint in the chosen output space.

Why it matters

Real work often splits into separate lines of exploration. One line stabilizes, another experiments, and a third prepares a cleaner handoff.

Fuse gives you a way to reuse the useful parts of that work without pretending the original timelines never existed. You keep the sources intact and create one more snapshot you can stand behind.

Fuse across spaces

Left and right snapshots can be resolved from different spaces, and the output can be written into another space. That makes Fuse especially useful when timelines are intentionally kept separate.

In practice, this means you can keep experiments isolated, then compose a cleaner result later without flattening everything into one running timeline.

Early Access note: specific commands and outputs may change. The concepts remain stable.