feat(sync) Recover from hangs and surface progress (#544)

`vcspull sync` no longer freezes a batch when one repository hangs on
credentials or stalls on a slow fetch, and the user can see what's
running while it does. Adds a per-repo timeout, a live status
indicator, a streaming output panel, an npm/pnpm-style debug log,
SIGINT-clean Ctrl-C handling, and quieter libvcs output by default.

- **Per-repo timeout** with a 10s wall-clock default (`--timeout
  SECONDS`, `VCSPULL_SYNC_TIMEOUT_SECONDS`). Timed-out repos surface
  in the summary with a copy-pasteable rerun command.
- **Live status indicator** — spinner in a terminal, periodic "still
  syncing" heartbeat in pipes. Disabled under `--json`, `--ndjson`,
  `--color=never`.
- **Streaming output trail** — git's `From <url>` / `* [new branch]`
  output appears in a 3-line panel above the spinner and collapses
  to the permanent `✓ Synced` line on completion. Tunable with
  `--panel-lines N` / `VCSPULL_PROGRESS_LINES`.
- **Per-invocation debug log** under `$TMPDIR/vcspull/`, surfaced
  only on failure or timeout (`--log-file PATH`, `--no-log-file`).
- **Ctrl-C aborts shell chains** — `vcspull sync ~/a; vcspull sync
  ~/b` now stops on the first interrupt, matching `git clone; git
  fetch`.
- **Quieter default output** — libvcs's per-repo log crumbs no
  longer print at the default verbosity. `-v` opens INFO; `-vv`
  opens DEBUG. The debug log file always captures DEBUG.

Breaking changes:
- Minimum libvcs bumped from 0.39.0 to 0.40.0 (for upstream per-repo
  timeout and fast `set_remotes` fixes this branch relies on).

Fixes #543

Author: tony

CHANGES

@@ -37,6 +37,55 @@ $ uvx --from 'vcspull' --prerelease allow vcspull
 _Notes on upcoming releases will be added here_
 <!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
 
+### Breaking changes
+
+- Bump minimum libvcs from 0.39.0 to 0.40.0 (#544)
+
+### What's new
+
+#### `vcspull sync`: per-repo timeout
+
+A stuck repository no longer freezes the whole batch. Each repo runs
+under a 10-second wall-clock deadline; override with `--timeout
+SECONDS` or `VCSPULL_SYNC_TIMEOUT_SECONDS`. The summary lists any
+timed-out repos with a copy-pasteable rerun command. (#544)
+
+#### `vcspull sync`: live status indicator
+
+The active repo is now visible while sync runs. In a terminal you get
+a spinner with the repo name and elapsed time; in pipes you get a
+start line plus a periodic "still syncing" heartbeat. Disabled under
+`--json`, `--ndjson`, and `--color=never`. (#544)
+
+#### `vcspull sync`: streaming output trail
+
+Git's streaming output now appears in a 3-line trail above the
+spinner and collapses to the permanent `✓ Synced` line when the repo
+finishes. Tunable with `--panel-lines` (`0` hides, `-1` unbounded) or
+`VCSPULL_PROGRESS_LINES`. (#544)
+
+#### `vcspull sync`: per-invocation debug log
+
+Every run drops a debug log under `$TMPDIR/vcspull/` (npm/pnpm style),
+surfaced to the terminal only when something failed or timed out.
+Override with `--log-file PATH`; disable with `--no-log-file`. (#544)
+
+#### `vcspull sync`: Ctrl-C aborts shell chains
+
+`vcspull sync` now exits via signal on Ctrl-C, so chained invocations
+like `vcspull sync ~/a; vcspull sync ~/b` stop on the first interrupt
+instead of running the whole list. Matches `git clone; git fetch`. (#544)
+
+#### `vcspull`: quieter default output
+
+libvcs's per-repo log crumbs no longer print at the default verbosity.
+Pass `-v` for INFO-level libvcs activity (`Updating to 'main'.`); pass
+`-vv` for DEBUG. The debug log file always captures DEBUG regardless. (#544)
+
+### Bug fixes
+
+- Sync no longer hangs on credential prompts or slow fetches (#544)
+
 ### Documentation
 
 - Visual improvements to API docs from [gp-sphinx](https://gp-sphinx.git-pull.com)-based Sphinx packages (#542)

pyproject.toml

@@ -53,7 +53,7 @@ keywords = [
 ]
 homepage = "https://vcspull.git-pull.com"
 dependencies = [
-  "libvcs~=0.39.0",
+  "libvcs>=0.40.0,<0.41.0",
   "colorama>=0.3.9",
   "PyYAML>=6.0"
 ]

src/vcspull/cli/__init__.py

@@ -440,7 +440,14 @@ def cli(_args: list[str] | None = None) -> None:
     ) = subparsers
     args = parser.parse_args(_args)
 
-    setup_logger(log=log, level=args.log_level.upper())
+    # ``args.verbosity`` is only set by the sync subcommand; default 0
+    # everywhere else. The sync ``-v`` ladder (0 → libvcs WARNING; 1 → INFO;
+    # 2+ → DEBUG) is documented in :func:`vcspull.log.setup_logger`.
+    setup_logger(
+        log=log,
+        level=args.log_level.upper(),
+        verbosity=getattr(args, "verbosity", 0),
+    )
 
     if args.subparser_name is None:
         parser.print_help()
@@ -466,6 +473,10 @@ def cli(_args: list[str] | None = None) -> None:
             sync_all=getattr(args, "sync_all", False),
             parser=sync_parser,
             include_worktrees=getattr(args, "include_worktrees", False),
+            timeout=getattr(args, "timeout", None),
+            log_file=getattr(args, "log_file", None),
+            no_log_file=getattr(args, "no_log_file", False),
+            panel_lines=getattr(args, "panel_lines", None),
         )
     elif args.subparser_name == "list":
         list_repos(