🪲 [Fix]: New modules inherit the current repository baseline

[Marius Storhaug (MariusStorhaug)]

New modules created from this template start with the current Process-PSModule v8 test and documentation contract, plus repository-local community guidance in GitHub-recognized locations. 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: Community guidance stays with each repository

The contributing guide now lives under .github/ with the Code of Conduct, security policy, and support guidance. Repositories created from the template carry all four files directly instead of relying on organization fallback files.

---

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.toml with MSXOrg/docs at bc6c212b1da6872424543cc6c4d249b1b1f8a845, with MSX settings taking precedence over Process-PSModule differences.
• Enables navigation.indexes while keeping manual nav absent.
• 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.md to .github/CONTRIBUTING.md, updates repository links, and aligns its workflow references with current MSX guidance.
• Adds .github/CODE_OF_CONDUCT.md, .github/SECURITY.md, and .github/SUPPORT.md byte-for-byte from PSModule/.github main at 52b83ea9eacb3b8ce62a0cfaeede9620f2ca1469.
• Leaves no root duplicates of the four community-health files; all relative links resolve, and GitHub's contents API resolves each .github/ path on this branch.
• Preserves the exact v8 caller workflow, with no TestData payload 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, and external-link checks passed; a staged Zensical 0.0.50 build completed with only the pre-existing README-link warnings tracked by Generated module sites publish broken README links 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.
• Final Copilot review covered all ten changed files. Its scaffold-link concern cannot use the suggested placeholder without failing the framework's exact-link test; the initialization gap is recorded separately in Generated repositories need a canonical scaffold help link #56, and the review thread is resolved.
• Overlap review: 📖 [Docs]: Documentation links in the template resolve again #42 edits the now-relocated root contributing guide and will need reconciliation; its current repository-standard link is included in the relocated guide. ⚙️ [Maintenance]: New module repositories ship the Claude Code and Copilot agent routes #50 and ⚙️ [Maintenance]: Agent guidance links point to documentation that exists #51 remain independent, although ⚙️ [Maintenance]: Agent guidance links point to documentation that exists #51 touches the same AGENTS link line. ⚙️ [Maintenance]: Repository guidance uses shared standards #49 proposes deleting required standard files and conflicts with this direction.
• Issue convergence sweep: the finished diff fully satisfies Template does not meet the Process-PSModule v8.0.3 test contract #52, Template Zensical profile lags the canonical documentation design #54, and Community health files use repository-local GitHub paths #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/*.md, README.md, AGENTS.md	MSX repository and community-health conventions	PSModule community defaults	Fixed in this PR

Relevant issues (or links)

• Resolves Template does not meet the Process-PSModule v8.0.3 test contract #52
• Resolves Template Zensical profile lags the canonical documentation design #54
• Resolves Community health files use repository-local GitHub paths #55

Related work

• References Upgrade Process-PSModule to Pester 6.1 Process-PSModule#519
• References ⚙️ [Maintenance]: [process-v8-major-tag] Roll the v8 caller across the fleet Process-PSModule#438
• Followed by Generated module sites publish broken README links Process-PSModule#523
• Followed by Generated repositories need a canonical scaffold help link #56
• References Automatic palette mode uses a misleading link icon MSXOrg/docs#190
• References 📖 [Docs]: Documentation links in the template resolve again #42
• References ⚙️ [Maintenance]: New module repositories ship the Claude Code and Copilot agent routes #50
• References ⚙️ [Maintenance]: Agent guidance links point to documentation that exists #51

[psmodule-s-shelly]

No Significant Changes Detected

This PR does not contain changes to files that would trigger a new release:

Pattern	Description
^src/	Matches files where path matches this pattern
^README\.md$	Matches files where path matches this pattern

Build, test, and publish stages will be skipped for this PR.

If you believe this is incorrect, please verify that your changes are in the correct locations.

[Copilot]

Pull request overview

Updates this PowerShell module template so newly generated modules align with the current Process-PSModule v8 baseline (Pester 6.1 minimum, source-test help link expectations, and updated Zensical documentation-site configuration), returning the scheduled framework run to green.

Changes:

• Raised the starter test’s minimum required Pester version from 6.0.0 to 6.1.0 (still allowing 6.x).
• Added a canonical generated documentation .LINK to the scaffold public function’s comment-based help.
• Aligned .github/zensical.toml with the current documentation-site design baseline (theme features, palettes, icons, and markdown extensions).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
tests/PSModuleTest.Tests.ps1	Bumps the minimum Pester version required by the starter test to match the current framework baseline.
src/functions/public/Get-PSModuleTest.ps1	Adds canonical online reference link to satisfy source-test documentation expectations.
.github/zensical.toml	Updates Zensical site configuration to the current shared documentation design baseline (theme, palette, plugins, markdown extensions).

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated 1 comment.