syncweaver update

Update a tracked external repository to a new ref, re-vendoring content and re-applying any tracked patches. Use --patch-conflict-strategy to control behaviour when patch re-application fails.

Usage

Usage: syncweaver update [OPTIONS]

  Update a tracked external repository in the current host repository.

Options:
  --path PATH                     Tracked destination path in the host
                                  repository, e.g. code/package1.  [required]
  --ref TEXT                      Git ref to vendor (branch, tag, or commit).
                                  Defaults to lockfile ref.
  --remote-subdir TEXT            Optional repository subdirectory to vendor,
                                  e.g. src/package1. Defaults to lockfile
                                  remote_subdir when present.
  --patch-conflict-strategy [fail|warn]
                                  Behavior when tracked patch reapply fails
                                  during update. Use 'fail' to abort update or
                                  'warn' to continue with unpatched files.
                                  [default: fail]
  --lockfile PATH                 Path to .syncweaver-lock.json in the host
                                  repository.  [default: .syncweaver-
                                  lock.json]
  -h, --help                      Show this message and exit.

Examples

# Update to latest HEAD for the tracked ref
syncweaver update --path code/mypackage

# Pin to a new tag
syncweaver update --path code/mypackage --ref v2.0.0

# Continue past patch conflicts instead of failing
syncweaver update --path code/mypackage --patch-conflict-strategy warn