Function writeCommitGraph

packages/backend/src/git.ts:496–524

({
    path,
    forceBackfill,
    onProgress,
    signal,
}: {
    path: string,
    forceBackfill?: boolean,
    onProgress?: onProgressFn,
    signal?: AbortSignal,
})

 * @see: https://git-scm.com/docs/commit-graph
 */
export const writeCommitGraph = async ({
    path,
    forceBackfill,
    onProgress,
    signal,
}: {
    path: string,
    forceBackfill?: boolean,
    onProgress?: onProgressFn,
    signal?: AbortSignal,
}): Promise<void> => {
    const git = createGitClientForPath(path, onProgress, signal);

    try {
        const args = ['commit-graph', 'write', '--reachable', '--changed-paths'];
        if (forceBackfill) {
            // --split=replace consolidates any existing layers into a single new layer,
            // which forces git to recompute Bloom filters for every commit (not just commits
            // added since the last write). Used for the one-time migration of repos that have
            // a Bloom-less commit-graph from before --changed-paths was enabled.
            // @see: https://git-scm.com/docs/git-commit-graph#Documentation/git-commit-graph.txt-write
            args.push('--split=replace');
        }
        await git.raw(args);
    } catch (error) {
        // Don't throw an exception here since this is just a performance optimization.
        logger.debug(`Failed to write commit-graph for ${path}:`, error);
    }
}