🪲 [Fix]: New modules inherit the current repository baseline (#53)
New modules created from this template start with the current Process-PSModule v8 test and documentation contract, a repository-local contribution guide, and centrally managed PSModule community policies. The template's scheduled framework run returns to green.
Fixed: Current Process-PSModule compatibility
The starter test requires Pester 6.1.0 while retaining the supported 6.x range. The starter public function links first to its generated online reference, as required by the framework source test.
Changed: Generated documentation design
Generated module sites now share the portable typography, icons, palettes, navigation, search, content, plugin, and Markdown-extension settings from MSXOrg/docs. Explicit navigation remains absent, so Zensical derives index-first, alphabetical navigation from the generated folder tree. Cookie consent is not part of the generated-module template.
Changed: Repository and organization guidance have explicit owners
The repository owns .github/CONTRIBUTING.md. Code of Conduct, security, and support policies remain centrally managed by PSModule/.github and are linked rather than copied. Process-PSModule owns module releases, so the template no longer carries unused GitHub generated-release-notes configuration.
Technical details
- Raises the starter test's minimum Pester version from 6.0.0 to 6.1.0.
- Adds the canonical generated documentation URL to the starter function's comment-based help.
- Aligns
.github/zensical.tomlwithMSXOrg/docsatbc6c212b1da6872424543cc6c4d249b1b1f8a845, with MSX settings taking precedence over Process-PSModule differences. - Enables
navigation.indexeswhile keeping manualnavabsent. - Keeps generated-site exceptions explicit: no source edit/view actions,
custom_dir, JavaScript/CSS assets,watch, snippets, or[project.extra.consent]. Cookie consent is intentionally not part of generated module sites. - Restricts placeholders to repository identity and content-specific values.
- Moves
CONTRIBUTING.mdto.github/CONTRIBUTING.md, updates repository links, and aligns its workflow references with current MSX guidance. - Links the Code of Conduct, security policy, and support guidance from the centrally managed
PSModule/.githubsource; no local policy overrides are included. - Removes
.github/release.ymlbecause Process-PSModule owns release generation and does not use GitHub generated release notes..github/PSModule.ymlremains the repository-local workflow settings surface. - GitHub's branch contents API resolves
.github/CONTRIBUTING.mdand.github/PSModule.ymland confirms the local policy files, root contribution duplicate, and.github/release.ymlare absent. - Preserves the exact v8 caller workflow, with no
TestDatapayload required. - Migration inventory: one module-local test file, no external fixtures, no mocks, no data-driven cases, and no setup or teardown scripts.
- Local validation: Pester 6.1.0 passed; PSScriptAnalyzer 1.25.0 reported no findings; the pinned MSX TOML contract comparison, codespell, relative-link checks, central-policy link checks, and file-ownership checks passed; a staged Zensical 0.0.50 build completed with only the pre-existing README-link warnings tracked by PSModule/Process-PSModule#523.
- Hosted validation: the full Process-PSModule build, site, source, module, module-local, lint, result, coverage, and CodeQL checks passed on Linux, macOS, and Windows at
d92cdc6. - Final Copilot review at
d92cdc6covered all eight changed files and generated no new comments. Its suppressed quickstart-link note is already owned by #42 and is not added to this scope. - Copilot's earlier scaffold-link concern cannot use the suggested placeholder without failing the framework's exact-link test; the initialization gap is recorded separately in #56, and the review thread is resolved.
- Overlap review: #42 edits the deleted root contributing guide and needs reconciliation. #49 also removes
.github/release.yml, but its proposed CODEOWNERS and pull-request-template deletions are not adopted. #50 and #51 remain independent, although #51 touches the same AGENTS link line. - Issue convergence sweep: the finished diff fully satisfies #52, #54, and #55; no other open template issue is completed by this scope.
| Changed surface | Standards checked | Framework docs checked | Result |
|---|---|---|---|
tests/** |
MSX PowerShell testing | Process-PSModule Pester 6.1 migration | Fixed in this PR |
src/functions/public/** |
MSX PowerShell functions and comment-based help | Process-PSModule source test contract | Fixed in this PR |
.github/zensical.toml |
MSX documentation design | Process-PSModule Zensical design and staging contract | Fixed in this PR |
.github/CONTRIBUTING.md, README.md, AGENTS.md |
MSX repository and community guidance | PSModule central policy ownership | Fixed in this PR |
.github/release.yml |
MSX repository configuration | Process-PSModule release ownership | Fixed in this PR |
Relevant issues (or links)
Related work
- References PSModule/Process-PSModule#519
- References PSModule/Process-PSModule#438
- Followed by PSModule/Process-PSModule#523
- Followed by #56
- References MSXOrg/docs#190
- References #42
- References #49
- References #50
- References #51