fix(docs): remove Mermaid diagram and add missing collection cards by WilliamBerryiii · Pull Request #1247 · microsoft/hve-core

WilliamBerryiii · 2026-03-31T04:37:22Z

Description

Removed the redundant Mermaid-based collection hierarchy diagram from the Docusaurus landing page and eliminated the @docusaurus/theme-mermaid dependency with its entire transitive dependency tree (~60+ packages, ~1,364 lines removed from package-lock.json). Added three previously missing collection cards (gitlab, jira, rai-planning) to ensure the landing page accurately represents all available collections.

Dependency Cleanup

The Mermaid visualization ecosystem was exclusively used by the diagram feature and is safely removed.

Removed @docusaurus/theme-mermaid from package.json and docusaurus.config.js (mermaid: true config and themes array entry)
Cascade-removed ~60+ transitive packages from package-lock.json: complete D3 ecosystem, Cytoscape graph library, Mermaid core and parser, DOMPurify, KaTeX, marked, dagre-d3-es, roughjs, langium, and supporting utilities

Landing Page Simplification

Removed buildCollectionDiagram() function, Mermaid import, diagram variable, and rendering JSX from index.tsx
Removed .diagramContainer CSS class from styles.module.css
Deleted Mermaid.tsx mock component and buildCollectionDiagram.test.ts test suite

Collection Card Expansion

Added gitlab (Experimental, 2 artifacts), jira (Experimental, 13 artifacts), and rai-planning (Experimental, 13 artifacts) to collectionCards.ts
Updated collectionCards.test.ts with three new expected collection names

Related Issue(s)

Fixes #1239

Type of Change

Select all that apply:

Code & Documentation:

Bug fix (non-breaking change fixing an issue)
New feature (non-breaking change adding functionality)
Breaking change (fix or feature causing existing functionality to change)
Documentation update

Infrastructure & Configuration:

AI Artifacts:

Reviewed contribution with prompt-builder agent and addressed all feedback
Copilot instructions (.github/instructions/*.instructions.md)
Copilot prompt (.github/prompts/*.prompt.md)
Copilot agent (.github/agents/*.agent.md)
Copilot skill (.github/skills/*/SKILL.md)

Note for AI Artifact Contributors:

Agents: Research, indexing/referencing other project (using standard VS Code GitHub Copilot/MCP tools), planning, and general implementation agents likely already exist. Review .github/agents/ before creating new ones.

Skills: Must include both bash and PowerShell scripts. See Skills.

Model Versions: Only contributions targeting the latest Anthropic and OpenAI models will be accepted. Older model versions (e.g., GPT-3.5, Claude 3) will be rejected.

See Agents Not Accepted and Model Version Requirements.

Other:

Script/automation (.ps1, .sh, .py)
Other (please describe):

Sample Prompts (for AI Artifact Contributions)

Testing

Automated Validation

Command	Status
`npm run lint:md`	✅ Pass (186 files, 0 errors)
`npm run spell-check`	⚠️ Pre-existing (5 issues in `docs/announcements/` — not in this PR)
`npm run lint:frontmatter`	✅ Pass (443 files, 0 errors)
`npm run validate:skills`	⚠️ Pre-existing (`.venv` in `jira` skill — not in this PR)
`npm run lint:md-links`	✅ Pass (3 broken external links in `GOVERNANCE.md` — not in this PR)
`npm run lint:ps`	✅ Pass
`npm run plugin:generate`	✅ Pass (14 plugins generated, 0 errors)

Diff-Based Assessments

Dependency removal analysis: Verified complete cascade removal of @docusaurus/theme-mermaid and all transitive dependencies (~60+ packages) including D3, Cytoscape, and Mermaid ecosystems.
Collection card consistency: Verified new collection entries follow existing patterns in collectionCards.ts with correct structure (name, description, maturity, artifactCount).
Test coverage: collectionCards.test.ts updated with three new expected collection names. Diagram-related test file (buildCollectionDiagram.test.ts) removed alongside feature deletion.

Security Analysis

No sensitive data, credentials, or NDA content detected in changes.
Dependency changes are exclusively removals — no new dependencies introduced.
No security scripts modified.

Note

Manual testing was not performed.

Checklist

Required Checks

Documentation is updated (if applicable)
Files follow existing naming conventions
Changes are backwards compatible (if applicable)
Tests added for new functionality (if applicable)

AI Artifact Contributions

Used /prompt-analyze to review contribution
Addressed all feedback from prompt-builder review
Verified contribution follows common standards and type-specific requirements

Required Automated Checks

The following validation commands must pass before merging:

Markdown linting: npm run lint:md
Spell checking: npm run spell-check (pre-existing issues in unrelated files)
Frontmatter validation: npm run lint:frontmatter
Skill structure validation: npm run validate:skills (pre-existing .venv warning in unrelated skill)
Link validation: npm run lint:md-links (pre-existing broken external links in unrelated file)
PowerShell analysis: npm run lint:ps
Plugin freshness: npm run plugin:generate

Security Considerations

This PR does not contain any sensitive or NDA information
Any new dependencies have been reviewed for security issues
Security-related scripts follow the principle of least privilege (N/A — no security scripts modified)

Additional Notes

All 107 Docusaurus tests pass after these changes.
Build succeeds with no warnings related to removed dependencies.
The D3, Cytoscape, and Mermaid visualization ecosystems were exclusively used by the diagram feature and are safely removed.

- remove buildCollectionDiagram function and collectionDiagram const - remove Mermaid import and diagramContainer rendering block - remove diagramContainer CSS rules from styles.module.css - delete orphaned buildCollectionDiagram.test.ts Closes #1239 🗑️ - Generated by Copilot

- add gitlab, jira, and rai-planning collection cards as Experimental - remove @docusaurus/theme-mermaid from config, dependencies, and mock - update collectionCards test to include new collection names 🧹 - Generated by Copilot

codecov-commenter · 2026-03-31T04:39:19Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.71%. Comparing base (0634790) to head (f4c2705).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1247      +/-   ##
==========================================
- Coverage   87.72%   87.71%   -0.02%     
==========================================
  Files          61       61              
  Lines        9318     9318              
==========================================
- Hits         8174     8173       -1     
- Misses       1144     1145       +1

Flag	Coverage Δ
pester	`85.30% <ø> (-0.02%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.
see 1 file with indirect coverage changes

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

katriendg

Thanks LGTM
While reviewing this one with the collectioncard updates, and reviewing some other PRs I realized we may not have added some additional requirements to the contributing guide.

Created to Issues which tackle some of this, please see if these make sense?

#1248
#1249

WilliamBerryiii · 2026-04-01T16:32:48Z

Thanks LGTM While reviewing this one with the collectioncard updates, and reviewing some other PRs I realized we may not have added some additional requirements to the contributing guide.

Created to Issues which tackle some of this, please see if these make sense?

#1248 #1249
@katriendg
Yeah ... I think I'll spend some time to do a full collection audit soon ... we probably have some big problems with docs, maturity levels and promotion of agents to stable to deal with.

## Pre-Release 3.3.41 ### ✨ Features - add agentic workflows for automated issue triage, implementation, PR review, dependency review, and doc-staleness detection (#1219) - consolidate package-lock.json version sync into Update-VersionFiles.ps1 (#1240) - add standards code review agent and full review orchestrator (#1174) - standardize pytest-mock as Python mocking framework (#1170) - add Jira backlog workflows and Jira/GitLab skills (#978) - add centralized version bump script and supply-chain attestation (#1183) ### 🐛 Bug Fixes - replace invalid bare tool names with official tool identifiers (#1198) - fix broken links and remove orphaned reference in code review docs (#1257) - exclude Python env dirs from skill validation warnings (#1255) - pin happy-dom and serialize-javascript to resolve Dependabot vulnerabilities (#1253) - remove Mermaid diagram and add missing collection cards (#1247) - disable MCP servers by default to prevent token limit errors (#1144) - sync package-lock.json after pre-release version bump (#1236) - separate mermaid node declarations and add dynamic diagram generation with tests (#1215) - replace anchor links in meeting-analyst with bold text references (#1201) - remove recursive symlinks in jira and gitlab skill directories (#1233) - validate-installation scripts now check .github/skills directory (#1010) (#1206) - resolve npm audit vulnerabilities via dependency overrides (#1200) - add post-release triggers to scorecard workflow (#1186) - add missing .md extensions to relative links in agent documentation (#1180) ### 📚 Documentation - CLI getting-started: clarify plugin install commands as alternatives (-all vs base) (#1251) ### ♻️ Refactoring - align agent and prompt folder names to collection identifier (#1210) ### 🔧 Maintenance - streamline RAI Planner phase structure and documentation (#1273) - bump happy-dom from 20.8.8 to 20.8.9 in /docs/docusaurus (#1237) - pre-release 3.3.27 (#1191) - bump pygments from 2.19.2 to 2.20.0 in /.github/skills/gitlab/gitlab (#1234) - bump path-to-regexp from 0.1.12 to 0.1.13 in /docs/docusaurus (#1226) - bump the github-actions group with 4 updates (#1231) - add missing folders and alphabetize location lists (#1193) - bump brace-expansion (#1224) - bump handlebars from 4.7.8 to 4.7.9 in /docs/docusaurus (#1217) - bump brace-expansion from 5.0.3 to 5.0.5 in /docs/docusaurus (#1213) - pre-release 3.3.10 (#1187) - bump markdownlint-cli2 from 0.21.0 to 0.22.0 in the npm-dependencies group (#1175) - bump the github-actions group with 3 updates (#1176) - pre-release 3.3.1 (#1165) --- *Managed automatically by pre-release workflow.* Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

## Pre-Release 3.3.101 ### ✨ Features - add removed maturity tier and retire owasp-docker (#1444) - add evaluation dataset creator (#1279) - align RAI planner with guide, remove scoring, improve UX (#1287) - add PSGallery staleness check and BOM cleanup (#1379) - ISA-95 network planner agent (#1177) - auto-generate collection.md with maturity filtering (#1316) - add folder-consistency check and standardize WARN outp… (#1350) - add synth-data-generate prompt to data-science collection (#1419) - add canonical deck workflow and customer-card rendering for design thinking (#1413) - add Figma MCP integration for DT artifact export (#1222) - introduce `owasp-docker` (#1245) - replace hve-core-specific references with portable discovery-based language (#1335) - introduce `owasp-cicd` (#1246) - add secure-by-design knowledge skill (#1223) - introduce `owasp-infrastructure` (#1244) - introduce `owasp-mcp` (#1207) - add OutputPath parameter to Invoke-LinkLanguageCheck.ps1 (#1229) - add -OutputPath parameter to Validate-SkillStructure.ps1 (#1225) - add maintainer-only skip-review label guard (#1293) - add extension collections overview and integrate into getting started flow (#950) - add agentic workflows for automated issue triage, implementation, PR review, dependency review, and doc-staleness detection (#1219) - consolidate package-lock.json version sync into Update-VersionFiles.ps1 (#1240) - add standards code review agent and full review orchestrator (#1174) - standardize pytest-mock as Python mocking framework (#1170) - add Jira backlog workflows and Jira/GitLab skills (#978) - add centralized version bump script and supply-chain attestation (#1183) ### 🐛 Bug Fixes - pin PowerShell-Yaml to 0.4.7 across all install sites (#1378) - close fork-PR/workflow-file-PR secret-strip gap and normalize upload-artifact version (#1421) - replace stream-based lookahead with array indexing in list-changed-files.sh (#1376) - centralize ISO 8601 timestamp regex in CIHelpers (#1343) - update stale documentation date in release-process.md (#1363) - pin basic-ftp to 5.3.0 to resolve GHSA-rp42-5vxx-qpwr (#1374) - add bot filter to dependency PR review workflow (#1362) - resolve pip-audit findings in powerpoint, gitlab, and jira skill lock files (#1360) - standardize Timestamp JSON key casing across all lint result files (#1314) - add synchronize trigger to PR Review workflow (#1323) - standardize timestamp in Validate-SkillStructure.ps1 to use Get-StandardTimestamp (#1280) - add parallel subagent dispatch and structured JSON contracts to code-review-full (#1304) - standardize timestamp in SecurityHelpers.psm1 to use Get-StandardTimestamp (#1284) - standardize timestamps in Test-DependencyPinning.ps1 and SecurityClasses.psm1 (#1282) - derive collection artifact counts from YAML at build time (#1275) - standardize timestamp in FrontmatterValidation.psm1 to use Get-StandardTimestamp (#1285) - standardize timestamp in Markdown-Link-Check.ps1 to use Get-StandardTimestamp (#1283) - escape hyphens in Mermaid diagram on Collections page (#1262) - add summary timestamp to PSScriptAnalyzer output (#1211) - fix plugin compatibility and robustness for coding-standards code review agents (#1289) - standardize timestamp in Test-CopyrightHeaders.ps1 to use Get-StandardTimestamp (#1278) - standardize timestamp in Invoke-YamlLint.ps1 to use Get-StandardTimestamp (#1270) - standardize timestamp in Invoke-LinkLanguageCheck.ps1 to use Get-StandardTimestamp (#1264) - fix dependency-review path filters and sparse-checkout cone mode (#1259) - replace invalid bare tool names with official tool identifiers (#1198) - fix broken links and remove orphaned reference in code review docs (#1257) - exclude Python env dirs from skill validation warnings (#1255) - pin happy-dom and serialize-javascript to resolve Dependabot vulnerabilities (#1253) - remove Mermaid diagram and add missing collection cards (#1247) - disable MCP servers by default to prevent token limit errors (#1144) - sync package-lock.json after pre-release version bump (#1236) - separate mermaid node declarations and add dynamic diagram generation with tests (#1215) - replace anchor links in meeting-analyst with bold text references (#1201) - remove recursive symlinks in jira and gitlab skill directories (#1233) - validate-installation scripts now check .github/skills directory (#1010) (#1206) - resolve npm audit vulnerabilities via dependency overrides (#1200) - add post-release triggers to scorecard workflow (#1186) - add missing .md extensions to relative links in agent documentation (#1180) ### 📚 Documentation - broaden Security Review description beyond OWASP (#1385) - document maintainer advisory mode and skip-review label guard (#1386) - document ExcludePaths/OutputPath for Invoke-LinkLanguageCheck (#1383) - CLI getting-started: clarify plugin install commands as alternatives (-all vs base) (#1251) ### ♻️ Refactoring - align agent and prompt folder names to collection identifier (#1210) ### 🔧 Maintenance - pin PSScriptAnalyzer to 1.25.0 and sync stale workflow version comments (#1389) - bump lxml from 6.0.2 to 6.1.0 in /.github/skills/experimental/powerpoint (#1424) - bump @vscode/vsce from 3.7.1 to 3.9.1 in the npm-dependencies group (#1390) - bump the github-actions group across 1 directory with 7 updates (#1391) - bump follow-redirects from 1.15.11 to 1.16.0 in /docs/docusaurus (#1356) - upgrade Node.js from 20 to 24 and bump cspell to v10 (#1353) - bump basic-ftp from 5.2.0 to 5.2.1 (#1324) - update github/gh-aw-actions requirement to 536ea1bad8c6715d098a9dc1afea8d403733acfe in the github-actions group across 1 directory (#1298) - update security instruction attributions and compliance (#1294) - bump the npm-dependencies group with 2 updates (#1297) - pre-release 3.3.41 (#1252) - streamline RAI Planner phase structure and documentation (#1273) - bump happy-dom from 20.8.8 to 20.8.9 in /docs/docusaurus (#1237) - pre-release 3.3.27 (#1191) - bump pygments from 2.19.2 to 2.20.0 in /.github/skills/gitlab/gitlab (#1234) - bump path-to-regexp from 0.1.12 to 0.1.13 in /docs/docusaurus (#1226) - bump the github-actions group with 4 updates (#1231) - add missing folders and alphabetize location lists (#1193) - bump brace-expansion (#1224) - bump handlebars from 4.7.8 to 4.7.9 in /docs/docusaurus (#1217) - bump brace-expansion from 5.0.3 to 5.0.5 in /docs/docusaurus (#1213) - pre-release 3.3.10 (#1187) - bump markdownlint-cli2 from 0.21.0 to 0.22.0 in the npm-dependencies group (#1175) - bump the github-actions group with 3 updates (#1176) - pre-release 3.3.1 (#1165) --- *Managed automatically by pre-release workflow.* Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

WilliamBerryiii added 2 commits March 30, 2026 17:47

WilliamBerryiii requested a review from a team as a code owner March 31, 2026 04:37

katriendg approved these changes Mar 31, 2026

View reviewed changes

nguyena2 approved these changes Apr 1, 2026

View reviewed changes

Merge branch 'main' into fix/remove-redundant-mermaid-diagram

f4c2705

rezatnoMsirhC approved these changes Apr 1, 2026

View reviewed changes

Merge branch 'main' into fix/remove-redundant-mermaid-diagram

446fe22

WilliamBerryiii merged commit b3f73e2 into main Apr 1, 2026
40 checks passed

This was referenced Apr 1, 2026

chore(main): pre-release 3.3.41 #1252

Merged

chore(main): release hve-core 3.4.0 #1184

Open

hve-core-release-please Bot mentioned this pull request Apr 2, 2026

chore(main): pre-release 3.3.101 #1274

Merged

hve-core-release-please Bot mentioned this pull request Apr 27, 2026

chore(main): pre-release 3.3.111 #1476

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

fix(docs): remove Mermaid diagram and add missing collection cards#1247

fix(docs): remove Mermaid diagram and add missing collection cards#1247
WilliamBerryiii merged 4 commits intomainfrom
fix/remove-redundant-mermaid-diagram

WilliamBerryiii commented Mar 31, 2026

Uh oh!

codecov-commenter commented Mar 31, 2026 •

edited

Loading

Uh oh!

katriendg left a comment

Uh oh!

WilliamBerryiii commented Apr 1, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

WilliamBerryiii commented Mar 31, 2026

Description

Dependency Cleanup

Landing Page Simplification

Collection Card Expansion

Related Issue(s)

Type of Change

Sample Prompts (for AI Artifact Contributions)

Testing

Automated Validation

Diff-Based Assessments

Security Analysis

Checklist

Required Checks

AI Artifact Contributions

Required Automated Checks

Security Considerations

Additional Notes

Uh oh!

codecov-commenter commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

katriendg left a comment

Choose a reason for hiding this comment

Uh oh!

WilliamBerryiii commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

codecov-commenter commented Mar 31, 2026 •

edited

Loading

WilliamBerryiii commented Apr 1, 2026 •

edited

Loading