chore(plugins): add SDK retirement plan report

This commit is contained in:
Peter Steinberger
2026-04-28 04:42:52 +01:00
parent 1df48506a7
commit c17b9fe623
4 changed files with 73 additions and 4 deletions

View File

@@ -90,7 +90,8 @@ For external plugins, compatibility work follows this order:
Maintainers can audit the current migration queue with
`pnpm plugins:boundary-report`. Use `pnpm plugins:boundary-report:summary` for
compact counts, `--owner <id>` for one plugin or compatibility owner, and
compact counts, `--owner <id>` for one plugin or compatibility owner,
`--retirement-plan` for an issue/PR-ready dormant SDK checklist, and
`pnpm plugins:boundary-report:ci` when a CI gate should fail on due
compatibility records, cross-owner reserved SDK imports, or unused reserved SDK
subpaths without a dormant classification. The report groups deprecated

View File

@@ -12,8 +12,9 @@ full list of 200+ subpaths lives in `scripts/lib/plugin-sdk-entrypoints.json`;
reserved bundled-plugin helper subpaths appear there but are implementation
detail unless a doc page explicitly promotes them. Maintainers can audit active
and dormant reserved helper subpaths with `pnpm plugins:boundary-report:summary`;
the full JSON report includes dormant helper owner, replacement, and
remove-after metadata.
`pnpm plugins:boundary-report --retirement-plan` emits an issue/PR-ready
checklist grouped by owner, and the full JSON report includes dormant helper
owner, replacement, and remove-after metadata.
For the plugin authoring guide, see [Plugin SDK overview](/plugins/sdk-overview).