Skip to content

Add AzDO pipeline to bump decoupled deps and update API docs after publish#5661

Merged
iclanton merged 30 commits intomainfrom
decoupled-bump-pipeline
Feb 25, 2026
Merged

Add AzDO pipeline to bump decoupled deps and update API docs after publish#5661
iclanton merged 30 commits intomainfrom
decoupled-bump-pipeline

Conversation

@iclanton
Copy link
Member

@iclanton iclanton commented Feb 21, 2026

Summary

Adds a new AzDO pipeline (npm-post-publish.yaml) that runs automatically after either npm publish pipeline completes. Currently it bumps decoupled local dependencies to the latest published versions and opens a GitHub PR with the changes. It is also includes a stage that regenerates API markdown documentation on rushstack-websites using api-documenter.

Example PR here: #5660

Depends on #5663

What it does

Stage 1: Bump decoupled local dependencies

  1. Waits a configurable delay (default 5 min) for packages to propagate to npm
  2. Runs bump-decoupled-local-dependencies from repo-toolbox
  3. Runs rush update to refresh the lockfile
  4. Commits changes and generates empty change files via rush change --bulk --bump-type none
  5. Force-pushes to automated/bump-decoupled-deps and creates/updates a GitHub PR

Stage 2: Update API documentation (planned)

Once the publish-api-artifact PR (#5663) merges, a second stage will be added to:

  1. Download the *.api.json artifact from the triggering publish pipeline
  2. Run api-documenter markdown to generate updated API reference pages
  3. Open a PR against microsoft/rushstack-websites with the refreshed markdown

Files

  • npm-post-publish.yaml — Main pipeline, triggered by both rushstack NPM Publish and rushstack NPM Publish (rush)
  • templates/push-and-create-github-pr.yaml — Reusable template for force-pushing a branch and creating/updating a GitHub PR via the REST API (supports a WorkingDirectory parameter for multi-repo checkout scenarios)
  • templates/post-publish.yaml — Fix lib/lib-commonjs/ path for repo-toolbox invocations

@iclanton iclanton changed the title Introduce a pipeline to automatically bump decoupled local dependencies after publish. Add AzDO pipeline to bump decoupled local dependencies after publish Feb 22, 2026
@iclanton iclanton changed the title Add AzDO pipeline to bump decoupled local dependencies after publish Add AzDO pipeline to bump decoupled deps and update API docs after publish Feb 22, 2026
@iclanton iclanton force-pushed the decoupled-bump-pipeline branch from aeb7916 to 1e5760c Compare February 22, 2026 22:21
@iclanton iclanton force-pushed the decoupled-bump-pipeline branch from 7baaa7f to 06c89dc Compare February 23, 2026 18:11
@iclanton iclanton force-pushed the decoupled-bump-pipeline branch from 06c89dc to f62258a Compare February 23, 2026 18:17
@iclanton iclanton force-pushed the decoupled-bump-pipeline branch from 4caa62c to 43b9ba8 Compare February 23, 2026 19:03
@octogonz
Copy link
Collaborator

We discussed this in today's call. Meeting notes: 💬 Community call: CI publishing & Qdrant

@iclanton iclanton merged commit cee44f8 into main Feb 25, 2026
9 checks passed
@iclanton iclanton deleted the decoupled-bump-pipeline branch February 25, 2026 00:34
@github-project-automation github-project-automation bot moved this from Needs triage to Closed in Bug Triage Feb 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Closed

Development

Successfully merging this pull request may close these issues.

2 participants