Files
Guinevere Saenger 4b3bf4bdda Add SDKv2->PF migration and docs-patch conflict guidance to pulumi-upgrade-provider (#42)
Adds two real-world upgrade findings to the `pulumi-upgrade-provider` errors reference, drawn from recent manual upgrades of pulumi-vault and pulumi-venafi.

- **SDKv2→Plugin Framework migration** (from pulumi/pulumi-vault#1078): when upstream moves a resource to the Plugin Framework, tfgen reports the resource's token mapping as missing and suggests removing it — following that suggestion silently drops a resource users depend on. Documents the "remove the mapping" trap, the removed-vs-migrated triage, and the concrete muxing wiring (exported Framework constructor shim, `MuxShimWithPF` with a shared primary, `MainWithMuxer`).
- **Docs-only patch conflict** (from pulumi/pulumi-venafi#840): a small single-purpose docs patch that only removes an untranslatable section (e.g. `## Import`) can be retired for a targeted `SkipSectionByHeader` docs edit rule, which can also drop the `upstream` submodule. Includes the caveat that this is not a default tactic — multi-file or substantive patches should be resolved in place, and edit rules should stay small.

Also adds matching `use_cases.yaml` routing queries and bumps the plugin patch version to 1.0.4 in both ecosystem manifests.

## Test plan
- `uv run pytest tests/test_manifests.py -v`
- `uv run pytest tests/test_skill_selection_accuracy.py -v`
- `uv run pytest tests/test_skill_quality.py -v -s`

🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_01158iavPo5xrJM3Et3exP93
2026-07-22 05:22:51 -04:00
..