feat: add persistent parameter shorthand

[kichristensen]

What does this change

Adds a persistent: true shorthand on parameter definitions so a value provided at install is automatically remembered for subsequent upgrade and uninstall runs — without manually wiring outputs and parameter sources.

schemaVersion: 1.2.0

parameters:
  - name: resource-group
    type: string
    persistent: true

Enable the feature:

export PORTER_EXPERIMENTAL=persistent-parameters

At manifest validation time, persistent: true expands into:

• a file destination at /cnab/app/<name>
• source.output: <name>
• an explicit applyTo list covering all declared actions (including install)
• a matching output definition (unless one already exists)

No changes to the CNAB adapter are required — after expansion the param is identical to the longhand.

What issue does it fix

Closes #1889

Notes for the reviewer

• Schema version 1.2.0 is required; gated behind the persistent-parameters experimental feature flag (same pattern as DepsV2 / 1.1.0)
• persistent: true hard-errors when combined with source, path/env, or applyTo
• applyTo is set explicitly (including install) to prevent exemptFromInstall() from silently dropping install from the list

Checklist

• Did you write tests?
• Did you write documentation?
• Did you change porter.yaml or a storage document record? Update the corresponding schema file.
• If this is your first pull request, please add your name to the bottom of our Contributors list. Thank you for making Porter better! 🙇‍♀️

[Copilot]

Pull request overview

Adds an experimental persistent: true shorthand for manifest parameters that automatically persists install-time values for reuse in later actions (upgrade/uninstall) by expanding into longhand CNAB parameter+output wiring.

Changes:

• Introduces parameters.persistent (schemaVersion 1.2.0, gated by persistent-parameters) and expands it during manifest validation.
• Ensures runtime execution enables the persistent-parameters flag so already-built bundles run without requiring runtime config changes.
• Adds unit/integration tests, schema updates, and documentation for the new shorthand and schema version.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
pkg/manifest/manifest.go	Expands persistent: true into destination/source/applyTo/output; updates supported schemaVersion constraint based on feature flags.
pkg/manifest/manifest_test.go	Unit tests for persistent parameter expansion + schema gating behavior.
pkg/experimental/experimental.go	Adds persistent-parameters flag name and FlagPersistentParameters bit.
pkg/porter/run.go	Forces persistent-parameters flag on in porter run runtime context.
pkg/schema/manifest.schema.json	Adds parameters.persistent to the manifest JSON schema.
pkg/porter/testdata/schema.json	Updates embedded test schema to include parameters.persistent.
tests/integration/testdata/schema/schema.json	Updates integration schema fixture to include parameters.persistent.
pkg/manifest/testdata/porter-with-persistent-params.yaml	New manifest fixture exercising persistent: true at schemaVersion 1.2.0.
tests/integration/testdata/bundles/bundle-with-persistent-params/porter.yaml	New integration bundle demonstrating persistent parameter behavior.
tests/integration/persistent_params_test.go	New integration test validating persistence across install→upgrade.
pkg/cnab/config-adapter/adapter_test.go	Verifies manifest→bundle conversion includes the expanded persistent param + output wiring.
docs/content/docs/development/authoring-a-bundle/persisting-data.md	Documents persistent parameters as a third persistence mechanism with examples/restrictions.
docs/content/docs/bundle/manifest/file-format/_index.md	Adds schema 1.2.0 row and documents parameters.persistent field.
docs/content/docs/bundle/manifest/file-format/1.2.0.md	New schema 1.2.0 file format page focused on parameters.persistent.
.github/workflows/porter-integration-pr.yml	Runs the new persistent parameters integration test in PR CI.
.github/workflows/porter-integration-release.yml	Runs the new persistent parameters integration test in release CI.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[kichristensen]

We should investigate how dependencies-v2 and persistent-parameters interact at the schema version level.

• dependencies-v2 requires schemaVersion: 1.1.0
• persistent-parameters requires schemaVersion: 1.2.0

A bundle needing both features can only declare one schemaVersion, so there is currently no valid version that satisfies both flags simultaneously. Worth deciding whether 1.2.0 should be a superset that also enables deps-v2 features, or whether the version gating strategy needs revisiting.

[kichristensen]

Fixed in 257b5eb: changed the deps-v2 schema constraint from || 1.1.0 to || >= 1.1.0, so any schema version ≥ 1.1.0 (including 1.2.0) is valid when the flag is enabled. A bundle can now declare schemaVersion: 1.2.0 and use both features with both flags set.