{"version":"2.1.239","anchor":"directory-sync-can-fast-forward-a-cloud-checkout-from-a-git-","canonical_anchor":"directory-sync-can-fast-forward-a-cloud-checkout-from-a-git-","heading":"Directory sync can fast-forward a cloud checkout from a git bundle","tier":"soon","area":"Directory Sync","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.239\/e\/directory-sync-can-fast-forward-a-cloud-checkout-from-a-git-","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.239","markdown":"### Directory sync can fast-forward a cloud checkout from a git bundle\n\nCloud checkouts could fast-forward from a downloaded git bundle, but no caller enables it.\n\n**What**\n\nThe sync manifest can now carry an overlay block (hash, size, target head, pin) pointing at a git bundle. The worker downloads it, verifies it, fetches it and does a fast-forward-only merge. It is behind the same overlay option that defaults to false, and no caller in this build passes true.\n\n**Details**\n\n- The bundle must be a version 2 git bundle whose prerequisite commits exist locally; if the clone is shallow, sync fetches `--depth=1` from origin first.\n- Refs land under `refs\/ccr-seed\/overlay` before the merge.\n- The apply refuses on a detached HEAD, a dirty working tree, a target head that is not a descendant of the current one, or if a turn has already started.\n- Reported as `tengu_dir_sync_overlay_start`, `_complete` and `_failed`, plus `ccr_dir_sync_overlay`.\n\n**Evidence**\n\n`# v2 git bundle`\n\n- Area: Directory Sync\n- Tier: Nothing to try yet\n- Useful: 1\/5\n- Signal: 3\/5\n- Present in the build but not switched on"}