Files
fish-config/conf.d/auto-pull.fish
T
rootiest 261e663e97 feat(auto-pull): opt-in background fast-forward for registered repos
Add a C2-guarded PWD handler that background fast-forwards the fish-config
repo (baseline) plus any repos in a machine-local registry. Safety is
guaranteed by _auto_pull_sync: clean tree + has-upstream + --ff-only, else
no-op. Never rebases, merges, or overwrites work.

- conf.d/auto-pull.fish: --on-variable PWD handler, throttled to fire once
  per repo entry; spawns a --no-config child to run the worker
- functions/_auto_pull_sync.fish: the ff-only worker (safe on any branch)
- functions/auto-pull.fish: add/remove/list/status registry management,
  usable even when C2 is disabled
- completions/auto-pull.fish: subcommand + registered-repo completions

Registry lives at ~/.config/.user-dots/fish/auto-pull.list (machine-local,
never committed).
2026-06-19 02:21:21 -04:00

63 lines
2.8 KiB
Fish

# Copyright (C) 2026 Rootiest
# SPDX-License-Identifier: AGPL-3.0-or-later
# ╭──────────────────────────────────────────────────────────╮
# │ Auto-Pull (C2 — Autoexec) │
# ╰──────────────────────────────────────────────────────────╯
#
# Background, fast-forward-only `git pull` for opted-in repositories. Fires
# when the working directory enters the fish-config repo (always covered as a
# baseline) or any repository registered via the `auto-pull` command. The
# actual sync is delegated to `_auto_pull_sync`, which only ever fast-forwards
# a clean repo — see that function for the full safety contract.
#
# Manage the registry with: auto-pull add / remove / list / status
# C2 guard: when auto-execution is disabled, do not register the handler.
__fish_config_op_enabled __fish_config_op_autoexec; or exit
# SYNOPSIS
# __auto_pull_on_pwd (event handler, --on-variable PWD)
#
# DESCRIPTION
# On every directory change, checks whether the new $PWD is inside a
# registered repository (or the fish-config baseline) and, if so, kicks a
# background fast-forward. A throttle global ensures it fires once per
# repository entry rather than on every sub-directory change.
function __auto_pull_on_pwd --on-variable PWD
set -q __fish_config_dir; or set -g __fish_config_dir $XDG_CONFIG_HOME/fish
set -l list "$XDG_CONFIG_HOME/.user-dots/fish/auto-pull.list"
# Candidate roots: the fish-config repo plus the user's registry.
set -l roots $__fish_config_dir
test -r "$list"; and set -a roots (command cat "$list" 2>/dev/null)
# Find the registered root containing $PWD (exact match or a sub-directory).
set -l hit
for r in $roots
test -n "$r"; or continue
if test "$PWD" = "$r"; or string match -q -- "$r/*" "$PWD"
set hit "$r"
break
end
end
# Outside every registered repo: clear the throttle so re-entry re-syncs.
if test -z "$hit"
set -e __auto_pull_last
return
end
# Already synced for this repo entry — skip until we leave and return.
test "$hit" = "$__auto_pull_last"; and return
set -g __auto_pull_last "$hit"
# Background fast-forward. A --no-config child sources just the worker so
# it stays fast and free of shell side-effects; real `git`, no shadows.
set -l worker "$__fish_config_dir/functions/_auto_pull_sync.fish"
test -r "$worker"; or return
fish --no-config -c 'source $argv[1]; _auto_pull_sync $argv[2]' -- "$worker" "$hit" &
disown 2>/dev/null
end