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, 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, or an aborted prompt (Ctrl-C, a declined confirmation).
2: A usage error: unknown option, invalid value, missing operand, or an unparsable configuration file.

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