Add an ecosystem to converter mapping requests - #23804

## 3.251.0 (2026-07-08)

### Features

- [programgen/pcl] Invoke functions declared with multi-argument inputs
using positional arguments in PCL
[pulumi#23571](pulumi#23571)
- [sdkgen] Generate SDKs and programs for extension-parameterized
packages [pulumi#23579](pulumi#23579)
- [engine] Add `TargetSnippets` to deployment options to target snippets
by UUID.

### Bug Fixes

- [cli/display] Prevent plugin debug logs from appearing as raw JSON in
the CLI's output when logging with `--logtostderr`
[pulumi#23633](pulumi#23633)
- [cli] Show a `retain` marker for retain-on-delete resources in
`--diff` output
- [sdk/nodejs] Don't include the version in module paths when
serializing functions when using pnpm
- [cli] Don't miscopy out archives

### Improvements

- [cli/deployment] `pulumi deployment settings` no longer writes the
local `Pulumi.<stack>.deploy.yaml` file: the experimental `init`,
`pull`, `configure`, and `env` subcommands have been removed, and the
CLI no longer calls the deployment-settings encrypt endpoint.
`get`/`edit`/`destroy` continue to manage settings directly in Pulumi
Cloud [pulumi#23480](pulumi#23480)
- [cli/import] Support importing resources under parameterized providers
from a converter or import file
[pulumi#23763](pulumi#23763)
- [cli/import] Support importing resources under extension-parameterized
providers [pulumi#23779](pulumi#23779)
- [engine] Add OpenTelemetry spans to the StackReference read path so
performance traces can pinpoint slow snapshot fetches, deserialization,
or secret decryption
- [cli/deployment] The deployment settings file
(`Pulumi.<stack>.deploy.yaml`) has been removed entirely. The
experimental `pulumi deployment settings push` (`update`/`up`) command,
the `--config-file` flag, and the SDK helpers that read the file have
been removed. Manage deployment settings directly in Pulumi Cloud with
`pulumi deployment settings get`, `edit`, and `destroy`
[pulumi#23480](pulumi#23480)
- [cli/env] Report the new revision number when an environment
definition is updated (e.g. `pulumi env edit`, `pulumi env provider`,
`pulumi env version rollback`)
[pulumi#23799](pulumi#23799)
- [cli/convert] Add an `ecosystem` field to converter mapping requests
so a converter can request mappings for the ecosystem it consumes rather
than its own name [pulumi#23804](pulumi#23804)

### Miscellaneous

- [cli] Add `pulumi neo --debug-update` and `pulumi neo --debug-preview`
flags to investigate a failed update or preview, suggested in the
failure output [pulumi#23499](pulumi#23499)
- [cli/env] Fold the Pulumi ESC engine and CLI into the pulumi/pulumi
monorepo, removing the sdk↔esc Go module cycle. Internal refactor with
no user-facing behavior change; `pulumi env`/`pulumi esc` are
unaffected. [pulumi#23746](pulumi#23746)

…meter

pulumi/pulumi#23804 added an `ecosystem` argument to
`convert.Mapper.GetMapping`, identifying the source ecosystem whose
mappings the caller consumes. tf2pulumi converts Terraform programs, so
its provider-info source now requests "terraform" mappings explicitly;
the internal test-file mapper gains (and ignores) the new parameter.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

…meter

pulumi/pulumi#23804 added an `ecosystem` argument to
`convert.Mapper.GetMapping`, identifying the source ecosystem whose
mappings the caller consumes. tf2pulumi converts Terraform programs, so
its provider-info source now requests "terraform" mappings explicitly;
the internal test-file mapper gains (and ignores) the new parameter.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

pulumi/pulumi#23804 (released in v3.251.0) added an `ecosystem` argument
to `convert.Mapper.GetMapping`, identifying the source ecosystem whose
mappings the caller consumes. tf2pulumi converts Terraform programs, so
its provider-info source now requests "terraform" mappings explicitly;
the internal test-file mapper gains (and ignores) the new parameter.

Needed by pulumi/pulumi-hcl#321, which depends on a post-#23804
core and cannot compile `pkg/tf2pulumi/il` (nor anything importing it,
including `pkg/tfgen`) against current main. Verified locally: `go
vet`/`go build` clean across the root module (the only module affected —
no other `convert.Mapper` implementors or callers in the repo), and the
downstream pulumi-hcl test harness compiles against this branch.

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

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>