NAME

repomatic sync-uv-lock - Re-lock dependencies and roll cooldown overrides forward

SYNOPSIS

repomatic sync-uv-lock [OPTIONS]

DESCRIPTION

Upgrade all dependencies and clean up stale cooldown overrides.

Wraps uv lock --upgrade and:


  - syncs the repomatic-owned [tool.uv] policy pins (required-version,


    exclude-newer) in pyproject.toml from the bundled template, so every


    machine resolves the lockfile against the same uv floor and cooldown


  - prunes exclude-newer-package entries from pyproject.toml whose held


    version has aged past the exclude-newer cutoff, or whose own cutoff


    has when the lock holds no version, then freezes the survivors at


    their locked version (a fixed date) so the upgrade holds them


    instead of tracking newer releases


  - prints a table of updated packages with upload dates


  - reports the cooldown-bypass lifecycle: entries pruned or frozen by


    the run, and each active freeze with the date it expires


  - optionally fetches release notes from GitHub (markdown)


  - optionally reports newer releases held back by the cooldown, with the


    date each ages out of the exclude-newer window (--held-back)

The table respects the global --table-format option (github, json,
csv, etc.). Release notes are always rendered as markdown.

OPTIONS

--lockfile FILE: Path to the uv.lock file.
--table / --no-table: Print a summary table of updated packages.
--release-notes / --no-release-notes: Fetch release notes from GitHub (markdown, appended after the table).
--held-back / --no-held-back: Report newer releases withheld by the exclude-newer cooldown (runs a second uv resolution).
--output FILE: Write a markdown report (table + release notes) to this file.
--output-format [markdown|github-actions]: Format for --output. github-actions produces format for PR template consumption in workflows.
--help / -h: Show this message and exit.

ENVIRONMENT

SYNC_UV_LOCK_LOCKFILE: Path to the uv.lock file.
SYNC_UV_LOCK_TABLE: Print a summary table of updated packages.
SYNC_UV_LOCK_RELEASE_NOTES: Fetch release notes from GitHub (markdown, appended after the table).
SYNC_UV_LOCK_HELD_BACK: Report newer releases withheld by the exclude-newer cooldown (runs a second uv resolution).
SYNC_UV_LOCK_OUTPUT: Write a markdown report (table + release notes) to this file.
SYNC_UV_LOCK_OUTPUT_FORMAT: Format for --output. github-actions produces format for PR template consumption in workflows.
SYNC_UV_LOCK__CLICK_DEFAULT_HELP: Show this message and exit.

EXIT STATUS

0: Success.
1: A runtime error, an aborted prompt (Ctrl-D), or a declined confirmation.
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.
130: Interrupted with Ctrl-C: the process ends by SIGINT, reported as 130.

EXAMPLES

Upgrade and show changes

repomatic sync\-uv\-lock

With release notes

repomatic sync\-uv\-lock \-\-release\-notes

Render the report as a GitHub-flavored table

repomatic \-\-table\-format github sync\-uv\-lock

Render the report as JSON

repomatic \-\-table\-format json sync\-uv\-lock

CI: write markdown report as a GitHub Actions step output

repomatic sync\-uv\-lock \-\-no\-table \-\-release\-notes \-\-output "$GITHUB_OUTPUT" \-\-output\-format github\-actions

AUTHORS

Kevin Deldycke