name: docling-upstream-upgrade description: "Run the one-command Docling upstream upgrade workflow: fetch latest upstream, port local delta, validate, and record baseline metadata."
Docling Upstream Upgrade
Trigger phrases
- "fetch latest and port changes over"
- "upgrade docling upstream"
- "port latest docling-parse changes"
Purpose
Make upstream upgrades reproducible and auditable for ignored upstream sources.
Primary command
powershell -ExecutionPolicy Bypass -File .\scripts\fetch-latest-and-port-docling-parse.ps1
What this skill enforces
- Refresh the tracked upstream delta patch.
- Fetch latest upstream refs (unless intentionally skipped).
- Reapply local port delta onto target upstream commit.
- Run validation gates (tests, smoke, parity, patch check).
- Update baseline metadata (
patches/docling-parse/upstream-baseline.json). - Log outcomes in
docs/operations/progress.md. - Update docs/changelog when workflow/script behavior changes.
Safe debug modes
- Preflight only, no workspace mutation:
-DryRun
- Offline/local preflight:
-SkipFetch
- Faster command-path verification:
-SkipValidation
- Keep temp workspace on failure:
-KeepTempOnFailure
Required evidence after run
- Validation command outcomes recorded in
docs/operations/progress.md. - Baseline metadata file updated.
docs/CHANGELOG.mdupdated for workflow/script changes.