Skip to content

🚀 [Feature]: Module catalog now shows release and Process-PSModule status - #74

Merged
Marius Storhaug (MariusStorhaug) merged 19 commits into
mainfrom
enhance-module-catalog
Jul 19, 2026
Merged

🚀 [Feature]: Module catalog now shows release and Process-PSModule status#74
Marius Storhaug (MariusStorhaug) merged 19 commits into
mainfrom
enhance-module-catalog

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Jul 19, 2026

Copy link
Copy Markdown
Member

The module catalog now provides operational module status at a glance: each module entry links to its own generated page, shows current module/release information, and exposes Process-PSModule workflow usage status with live repository activity metrics.

New: Module-specific catalog pages

Each module name in the catalog now links to a generated module page under src/docs/Modules/Catalog/Repositories/. The page includes repository metadata, version information, README-derived summary content, and direct links for maintenance activity.

Changed: Catalog entries provide richer status signals

Catalog rows now use expanded columns: Name, Version, ProcessVersion, Issues, PRs, and Stars. Name links include a sanitized/truncated README-based hover preview so maintainers can quickly understand module purpose without leaving the catalog.

Changed: Process-PSModule usage is now visible per module

For each module repository, the catalog now attempts to detect the reusable Process-PSModule workflow reference and reports both the referenced value and computed status (for example up-to-date, behind, sha-pinned, not-configured).

Changed: Catalog refresh is now scheduled

The Docs workflow now includes a weekly scheduled run so generated catalog data refreshes even when no direct docs edits are pushed.

Technical Details

  • Extended .github/actions/update-index/src/main.ps1 to pass discovered repositories into module catalog generation.
  • Extended .github/actions/update-index/src/Helper.psm1 with:
    • GitHub API data retrieval for releases/tags, README, issues, PRs, and workflow content.
    • Response-unwrapping logic for GitHub module API wrapper shapes.
    • README summary extraction and HTML attribute sanitization for hover previews.
    • Per-module page generation under src/docs/Modules/Catalog/Repositories/.
    • Process-PSModule reference parsing from module workflow files and status classification.
    • Local testing compatibility improvements for authenticated user contexts and expected 404 handling for optional workflow files.
  • Added weekly schedule trigger to .github/workflows/Docs.yml.
  • Updated catalog documentation text to describe generated table/page behavior.
Related issues

-No linked issue (requested directly in coordinated session)

Add enriched module catalog generation with Process-PSModule reference tracking, per-repo catalog page generation, and a weekly docs refresh schedule.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Clarify that catalog table and linked module pages are generated from repository metadata and README summaries.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown

Super-linter summary

Language Validation result
CHECKOV Pass ✅
GITHUB_ACTIONS Pass ✅
GITHUB_ACTIONS_ZIZMOR Pass ✅
GITLEAKS Pass ✅
GIT_MERGE_CONFLICT_MARKERS Pass ✅
HTML Pass ✅
JAVASCRIPT_ES Pass ✅
JAVASCRIPT_PRETTIER 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

Use supported GitHub module calls discovered locally: Get-GitHubRepository -Owner and Invoke-GitHubAPI for REST lookups.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Fix module-qualified API invocation, unwrap GitHub module response envelopes, correct workflow URI interpolation, and fall back to anonymous mode when no context exists.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Allow Show-RepoList to reuse non-App contexts locally, rely on supported repository properties, and suppress expected 404s for optional workflow files.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title Enhance module catalog generation Enhance PSModule module catalog generation Jul 19, 2026
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title Enhance PSModule module catalog generation 🚀 [Feature]: Module catalog now shows release and Process-PSModule status Jul 19, 2026
Add help comments, align close-brace formatting, and add ShouldProcess support for generated catalog page writes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Change Docs workflow cron to run every 5 minutes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Gate lint job to pull_request events and remove lint as a publish dependency so scheduled/push refreshes only require build.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Restore publish dependency on lint (while allowing skipped lint) and replace Out-Null pipeline usage in catalog helper to match standards.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Store legacy catalog layout as v1 templates, move current layout to v2 templates, and render catalog from v2 templates by default.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Preserve the original v1 module catalog row structure with inline encoded SVG badge links instead of the simplified placeholder version.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Add visual icons to Version, ProcessVersion, Issues, PRs, and Stars column headers in the v2 module catalog template.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Replace text/emoji v2 numeric column headers with icon-only images from PSModule/.github media and include alt/title text for accessibility.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copy module catalog header icons into repo assets and update v2 template to use local relative paths instead of external raw.githubusercontent URLs.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Set package-variant-closed-check.svg fill to #848D97 to align with the other module catalog header icons.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Replace the process-version header icon with a local Primer-style cogwheel SVG and keep the shared catalog icon color (#848D97).

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Replace module catalog issue, PR, star, and tag SVGs with the upstream Primer Octicons shapes while keeping the local color override at #848D97.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as ready for review July 19, 2026 19:27
Mark module catalog row/table templates as HTMLHint fragments so doctype-first does not fail on partial templates that are intentionally embedded snippets.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug
Marius Storhaug (MariusStorhaug) merged commit 53f56c3 into main Jul 19, 2026
21 checks passed
@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the enhance-module-catalog branch July 19, 2026 19:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant