⚙️ [Maintenance]: Internalize runtime settings by phase#402
Merged
Conversation
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Super-linter summary
All files and directories linted successfully For more information, see the GitHub Actions workflow run Powered by Super-linter |
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Marius Storhaug (MariusStorhaug)
added a commit
to MSXOrg/docs
that referenced
this pull request
Jul 18, 2026
…dated (#56) Process-PSModule documentation now describes the current internal runtime settings contract in evergreen terms while keeping `.github/PSModule.yml` as the user-facing configuration source. ## Changed: Pipeline stages runtime contract documentation - Clarified that Plan enriches `.github/PSModule.yml` into an internal runtime `Settings` object shared between jobs. - Documented the current phase-owned execution flags, test suite matrix locations, and publish resolution paths as the active contract. ## Changed: Runtime settings reference style - Replaced comparison-oriented wording with definitive runtime path documentation (`Settings.*`) and behavior-focused descriptions. - Kept version stamping and release-decision references aligned with `Settings.Publish.Module.Resolution.*`. ## Changed: Usage behavior wording - Updated the important-file behavior section to state the current runtime values declaratively. ## Technical Details - Files updated: - `src/docs/Frameworks/Process-PSModule/pipeline-stages.md` - `src/docs/Frameworks/Process-PSModule/usage.md` - `src/docs/Frameworks/Process-PSModule/configuration.md` - Change is documentation-only and aligned with the current Process-PSModule runtime contract. <details> <summary>Related links</summary> - Upstream runtime contract context: PSModule/Process-PSModule#402 </details> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Runtime execution flags and test matrices are now owned by each phase object instead of a shared root
Run/TestSuitescontract.Changed: Runtime execution state is phase-owned
Get-PSModuleSettingsnow enriches each phase withDesired/Enabledstate and stores suites under the owning test phase:Linter.Repository/Linter.SourceCodeBuild.Module/Build.Docs/Build.SiteTest.SourceCode.Suites,Test.PSModule.Suites,Test.Module.SuitesTest.Module.BeforeAllEnabled,Test.Module.MainEnabled,Test.Module.AfterAllEnabledTest.TestResults.Enabled,Test.CodeCoverage.EnabledPublish.Module.Enabled,Publish.Site.EnabledChanged: Workflows now consume the new phase-owned schema
Reusable workflows and the root workflow were updated to reference phase-local state instead of
Settings.Run.*andSettings.TestSuites.*.Changed: Version resolution is scoped under publish phase
Plan.ymlnow stores resolved version metadata under:Settings.Publish.Module.Resolution.VersionSettings.Publish.Module.Resolution.PrereleaseSettings.Publish.Module.Resolution.FullVersionSettings.Publish.Module.Resolution.ReleaseTypeSettings.Publish.Module.Resolution.CreateReleaseBuild-Module.ymlandTest-ModuleLocal.ymlwere updated to read this new location.Changed: Settings schema deprecates root Run contract
Settings.schema.jsonno longer defines rootTestSuitesand marks rootRunas deprecated.Technical Details
Enabledvalues from the same event/state logic previously used to buildRun.*.Related issues