⚙️ [Maintenance]: CI and documentation builds use Process-PSModule v6.1.19

[Marius Storhaug (MariusStorhaug)]

NerdFonts now runs its CI and documentation builds through Process-PSModule v6.1.19, with dependency compatibility and documentation links aligned so contributors get reliable build, test, and site-generation results.

Changed: CI and documentation builds

The repository now uses the latest Process-PSModule release and builds the documentation site with Zensical. The site build remains enabled, and no contributor action is required beyond the existing workflow and documentation conventions.

Fixed: build and test compatibility

Dependency bounds, canonical documentation links, temporary download paths, and cache-fallback coverage now match the current pipeline expectations. The workflow passes only the API key it needs instead of inheriting all repository secrets.

---

Technical details

• Updated .github/workflows/Process-PSModule.yml to Process-PSModule v6.1.19 and explicit APIKey wiring.
• Updated actions/checkout to v7.0.1 in Update-FontsData.yml.
• Replaced .github/mkdocs.yml with .github/zensical.toml; the site build is enabled in .github/PSModule.yml.
• Updated Fonts and Admin dependency minimums and maximum bounds in Install-NerdFont.ps1.
• Switched font downloads to the system temporary directory.
• Replaced mocked cache-fallback behavior with a live locked-file scenario.
• Added trailing slashes to canonical documentation links and added the missing contribution/documentation guidance.
• Standards and framework alignment:

Changed surface	Standards checked	Framework docs checked	Result
.github/workflows/**	GitHub Actions, secret handling	Process-PSModule workflow contract	Aligned
.github/zensical.toml	Documentation configuration	Process-PSModule site pipeline	Aligned
src/**, tests/**	PowerShell dependencies, testing	Process-PSModule source/test checks	Aligned
README.md, CONTRIBUTING.md	Documentation	Repository contribution guidance	Aligned

• Issue convergence sweep: reviewed related open work and incorporated the system temporary-directory and README documentation changes in this delivery.

Relevant issues (or links)

• Build-PSModuleManifest fails when #Requires MaximumVersion uses wildcards Process-PSModule#444 — wildcard MaximumVersion parsing was tracked upstream; current Process-PSModule releases include the upstream fix.
• Use system temp directory for temporary font downloads instead of $HOME #69 — system temporary directory for font downloads.
• 📖 [Docs]: README links to generated command reference #85 — README documentation link.

[Copilot]

Pull request overview

This PR performs a “quality review” update across the NerdFonts PowerShell module repository, focusing on dependency/workflow bumps and small maintenance fixes (documentation + tests) to keep CI and module behavior aligned with upstream PSModule framework changes.

Changes:

• Bump PSModule/Process-PSModule reusable workflow from v5.5.0 to v6.1.16 and update actions/checkout to v7.0.1 in Update-FontsData.yml.
• Loosen #Requires -Modules constraints for Fonts and Admin in Install-NerdFont.ps1 by switching from fixed RequiredVersion to a version range.
• Add CONTRIBUTING.md and adjust the cache-fallback Pester test mocks to avoid unintended mock failures on the cache-write path.

Reviewed changes

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

Show a summary per file

File	Description
tests/NerdFonts.Tests.ps1	Adds default mocks for cache-write path in the cache-fallback test (but mock precedence likely needs adjustment).
src/functions/public/Install-NerdFont.ps1	Updates module dependency requirements to a looser version range for Fonts and Admin.
CONTRIBUTING.md	Adds contribution guidelines to match existing README references.
.github/workflows/Update-FontsData.yml	Bumps pinned actions/checkout to v7.0.1.
.github/workflows/Process-PSModule.yml	Bumps pinned PSModule/Process-PSModule reusable workflow to v6.1.16.

---

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

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
JSON	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

Suppressed comments (2)

tests/NerdFonts.Tests.ps1:283

• These comments describe the issue as the "cache-read filter" no longer matching, but the underlying problem is that the cache-write Copy-Item/Move-Item calls don’t match the filtered mock. Rewording will make the intent clearer for future maintenance.

 [System.IO.FileAccess]::Read,
[System.IO.FileShare]::None

CONTRIBUTING.md:12

• The documentation link in this new CONTRIBUTING guide points at msxorg.github.io/docs/Frameworks/Process-PSModule/, but the repo’s existing Process-PSModule reference points contributors to the GitHub README configuration docs. Using the same canonical link here avoids sending contributors to a potentially stale/incorrect URL.

2. Familiarize yourself with the PSModule framework documentation at
<https://msxorg.github.io/docs/Frameworks/Process-PSModule/>.

[Copilot]

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

Suppressed comments (2)

tests/NerdFonts.Tests.ps1:32

• The dynamic module loader relies on Get-ChildItem ordering when dot-sourcing files. File enumeration order can vary across platforms/filesystems, which can make the test harness brittle as additional source files are added. Sort the discovered file lists before dot-sourcing to ensure deterministic module initialization.

 }
It 'Returns a specific font' {
$font = Get-NerdFont -Name 'Tinos'
Write-Verbose ($font | Out-String) -Verbose

CONTRIBUTING.md:36

• Import-Module ./src will fail because src/ does not contain a module manifest (.psd1) or script module (.psm1). Since the tests now import the source tree dynamically, the development instructions should call Pester directly (and optionally reference the test harness) rather than importing ./src.

```powershell
Import-Module ./src
Invoke-Pester

</details>

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 10 out of 10 changed files in this pull request and generated no new comments.

Suppressed comments (2)

.github/PSModule.yml:21

• .github/PSModule.yml now sets Build.Site.Skip: true, which disables the site generation step. That appears to conflict with this PR’s stated goal of migrating the documentation site config to .github/zensical.toml for v6 site generation and linking to generated docs in the README. If the site should still be generated, this should be removed or set to false.

Build:
Site:
Skip: true

tests/NerdFonts.Tests.ps1:283

• This test expects Copy-Item to fail due to [System.IO.File]::Open(..., FileShare::None), but on non-Windows runners Copy-Item/File.Copy may not reliably honor these share-mode locks. That can cause the test to stop exercising the cache-fallback path and become a cache-hit test instead.

 $fileLock = [System.IO.File]::Open(
$cachedFile,
[System.IO.FileMode]::Open,
[System.IO.FileAccess]::Read,
[System.IO.FileShare]::None