Merge branch 'main' into remove-claude-file

Author: MariusStorhaug

.gitattributes

@@ -1,15 +1 @@
-# Needed for publishing of examples, build worker defaults to core.autocrlf=input.
-* text eol=autocrlf
-
-*.mof   text eol=crlf
-*.sh    text eol=lf
-*.svg   eol=lf
-
-# Ensure any exe files are treated as binary
-*.exe binary
-*.jpg binary
-*.xl* binary
-*.pfx binary
-*.png binary
-*.dll binary
-*.so  binary
+* text=auto eol=lf

.github/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing
+
+Follow the central [MSX contribution workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/)
+and [MSX Ways of Working](https://msx.no/docs/Ways-of-Working/) for shared contribution guidance.
+
+For framework-specific guidance, review the
+[Process-PSModule documentation](https://psmodule.io/Process-PSModule/).

.github/PSModule.yml

@@ -1,31 +1,11 @@
-# This file is used to configure the Process-PSModule workflow.
-# Reference:
-# - https://github.com/PSModule/Process-PSModule?tab=readme-ov-file#configuration
-
 Test:
   CodeCoverage:
-    PercentTarget: 0
-# Uncomment this to test faster by skipping some steps
-#   TestResults:
-#     Skip: true
-#   SourceCode:
-#     Skip: true
-#   PSModule:
-#     Skip: true
-#   Module:
-#     Windows:
-#       Skip: true
-#     MacOS:
-#       Skip: true
-# Build:
-#   Docs:
-#     Skip: true
+    PercentTarget: 80
 
 Linter:
   env:
     VALIDATE_BIOME_FORMAT: false
     VALIDATE_BIOME_LINT: false
-    VALIDATE_GITHUB_ACTIONS_ZIZMOR: false
     VALIDATE_JSCPD: false
     VALIDATE_JSON_PRETTIER: false
     VALIDATE_MARKDOWN_PRETTIER: false

.github/dependabot.yml

@@ -1,16 +1,7 @@
-# To get started with Dependabot version updates, you'll need to specify which
-# package ecosystems to update and where the package manifests are located.
-# Please see the documentation for all configuration options:
-# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
-
 version: 2
 updates:
   - package-ecosystem: github-actions
     directory: /
-    labels:
-      - dependencies
-      - github-actions
     schedule:
-      interval: daily
-    cooldown:
-      default-days: 7
+      interval: cron
+      cron: '0 0 */3 * *'

.github/linters/zizmor.yaml

@@ -0,0 +1,5 @@
+rules:
+  unpinned-uses:
+    config:
+      policies:
+        PSModule/Process-PSModule/.github/workflows/workflow.yml: ref-pin

.github/zensical.toml

@@ -1,56 +1,97 @@
+# Zensical configuration
+# https://zensical.org/docs/setup/basics/
+
 [project]
 site_name = "-{{ REPO_NAME }}-"
+site_url = "https://psmodule.io/-{{ REPO_NAME }}-/"
+docs_dir = "docs"
 repo_name = "-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
 repo_url = "https://github.com/-{{ REPO_OWNER }}-/-{{ REPO_NAME }}-"
 
 [project.theme]
-variant = "classic"
 language = "en"
+font.text = "Mona Sans"
+font.code = "Source Code Pro"
 logo = "Assets/icon.png"
 favicon = "Assets/icon.png"
 features = [
-    "navigation.instant",
-    "navigation.instant.progress",
-    "navigation.top",
-    "navigation.tracking",
-    "navigation.expand",
-    "search.suggest",
-    "search.highlight",
-    "content.code.copy"
+  "announce.dismiss",
+  "content.code.annotate",
+  "content.code.copy",
+  "content.tooltips",
+  "navigation.footer",
+  "navigation.indexes",
+  "navigation.instant",
+  "navigation.instant.prefetch",
+  "navigation.instant.preview",
+  "navigation.instant.progress",
+  "navigation.tabs",
+  "navigation.top",
+  "navigation.tracking",
+  "search.highlight",
+  "search.share",
+  "search.suggest",
+  "toc.follow",
 ]
 
+[project.theme.icon]
+repo = "material/github"
+link = "material/link-variant"
+
+# Palette toggle for automatic mode
 [[project.theme.palette]]
 media = "(prefers-color-scheme)"
 toggle.icon = "lucide/sun-moon"
 toggle.name = "Switch to dark mode"
 
+# Palette toggle for dark mode
 [[project.theme.palette]]
 media = "(prefers-color-scheme: dark)"
 scheme = "slate"
 primary = "black"
-accent = "light-blue"
+accent = "light blue"
 toggle.icon = "lucide/moon"
 toggle.name = "Switch to light mode"
 
+# Palette toggle for light mode
 [[project.theme.palette]]
 media = "(prefers-color-scheme: light)"
 scheme = "default"
 primary = "black"
-accent = "light-blue"
+accent = "light blue"
 toggle.icon = "lucide/sun"
 toggle.name = "Switch to system preference"
 
-[project.theme.icon]
-repo = "fontawesome/brands/github"
+[project.plugins.meta]
+
+[project.plugins.search]
 
 [project.markdown_extensions.toc]
-permalink = true
+permalink = "#"
 
 [project.markdown_extensions.attr_list]
+
+[project.markdown_extensions.abbr]
+
 [project.markdown_extensions.admonition]
+
+[project.markdown_extensions.def_list]
+
+[project.markdown_extensions.footnotes]
+
 [project.markdown_extensions.md_in_html]
+
+[project.markdown_extensions.tables]
+
 [project.markdown_extensions.pymdownx.details]
+
 [project.markdown_extensions.pymdownx.superfences]
+custom_fences = [
+  { name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" },
+]
+
+[project.markdown_extensions.pymdownx.tasklist]
+custom_checkbox = true
 
 [[project.extra.social]]
 icon = "fontawesome/brands/discord"

AGENTS.md

@@ -1,32 +1,9 @@
-# Agents
+# AGENTS
 
-## Main directive
+Read in this order:
 
-Everything is a work in progress and can be improved.
-If you find a problem or improvement, fix if small; otherwise open an issue.
-
-## Repo guidance
-
-- [`README.md`](README.md) — what this repository is and its purpose as a template.
-- [`CONTRIBUTING.md`](CONTRIBUTING.md) — how to contribute to this repository.
-
-## PSModule Framework guidance
-
-Regarding repo structure, module source code and how the Process-PSModule workflow works.
-For PSModule-specific build, layout, and process guidance:
-
-- [Template quickstart](https://psmodule.github.io/docs/Modules/Process-PSModule/template-quickstart/) — how to create a new module from this template.
-- [Repository defaults](https://psmodule.github.io/docs/Modules/Repository-Defaults/) — the expected repository layout and required files.
-- [Module anatomy](https://psmodule.github.io/docs/Modules/Process-PSModule/module-anatomy/) — source layout and framework conventions.
-- [Build, test, pack, publish](https://psmodule.github.io/docs/Modules/Process-PSModule/build-test-pack-publish/) — the CI/CD pipeline.
-- [Standards](https://psmodule.github.io/docs/Modules/Standards/) — PowerShell module coding standards.
-- [PSModule/memory](https://github.com/PSModule/memory) — durable cross-session agent working memory for the PSModule organization.
-
-## Org-wide guidance
-
-For cross-cutting ways of working and standards:
-
-- [Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/) — how agents and humans collaborate in this ecosystem.
-- [Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) — contribution workflow, branching, PRs, issues.
-- [Coding Standards](https://msxorg.github.io/docs/Coding-Standards/) — language-level conventions.
-- [MSXOrg/memory](https://github.com/MSXOrg/memory) — durable agent working memory: gotchas, knowledge, and agent role notes.
+1. [`README.md`](README.md)
+   - what this repository is and what it contains
+2. [`.github/CONTRIBUTING.md`](.github/CONTRIBUTING.md)
+   - how a change is made and reviewed
+   - how to understand the contribution process and applicable standards

CONTRIBUTING.md

@@ -2,28 +2,5 @@
 
 The canonical starting template for new PowerShell modules in the PSModule organization.
 
-## Purpose
-
-Use this template when creating a new PowerShell module repository.
-It provides the CI/CD framework wiring, required community files, and starter layout that every PSModule module repository needs.
-
-For step-by-step instructions, see the [template quickstart](https://psmodule.github.io/docs/Modules/Process-PSModule/template-quickstart/).
-
-## After creating a repository from this template
-
-1. Replace the `{{ NAME }}` placeholder with your module name throughout the repository.
-2. Replace the starter function, test, and example with your module's first real command.
-3. Set the repository description and custom properties on GitHub.
-4. Confirm `.github/PSModule.yml` only overrides defaults when your module needs different behavior.
-5. Open a draft pull request and run the full CI pipeline.
-
-See [repository defaults](https://psmodule.github.io/docs/Modules/Repository-Defaults/) for the full checklist.
-
-## Prerequisites
-
-Modules built from this template use the [PSModule framework](https://github.com/PSModule/Process-PSModule) for building, testing, and publishing.
-
-## Contributing
-
-To contribute to this template itself, read the [Contribution guidelines](CONTRIBUTING.md).
-For agents and AI tools, start with [`AGENTS.md`](AGENTS.md).
+For setup, read the framework guidance in the
+[Process-PSModule documentation](https://psmodule.io/Process-PSModule/).