Add root-tags orphan detection for requirements traceability

[Malcolmnixon]

Summary

Applies the root-tags orphan-detection pattern (established across sibling DemaConsulting repos) to ApiMark's requirements traceability.

• Bumped \demaconsulting.reqstream\ tool to 1.11.0.
• Tagged all 18 top-level system requirements (ApiMarkCore, ApiMarkCpp, ApiMarkDotNet, ApiMarkMsbuild, ApiMarkTool, ApiMarkVhdl) with [system].
• Closed 66 genuine traceability gaps by linking implementation-level requirements (FileMarkdownWriter*, FileMarkdownWriterFactory*, null-guard requirements, EmitConfig range validation, DocumentationCoverageCapable edge cases, ApiMarkTask forwarding/error-handling, CLI flag rejection, SelfTest enforce-docs tests, Vhdl error paths) as children of their existing parent requirements. Each link reflects real code/test evidence already present in the codebase.
• Added \docs/reqstream/quality.yaml\ grouping the 6 OTS dependencies (Mono.Cecil, Clang, CppAstNet, ANTLR4, DemaConsulting.TestResults, Microsoft.Extensions.FileSystemGlobbing) under [quality]\ tags, so third-party-derived requirements are not reported as orphans.
• Added
  oot-tags: [system, quality]\ to
  equirements.yaml.

Validation

• \dotnet reqstream --requirements requirements.yaml --enforce\ → 0 of 369 requirements orphaned.
• \pwsh ./build.ps1\ → same pre-existing test failures as on main (Clang not installed on this dev machine; unrelated to this change, confirmed via \git stash).
• \pwsh ./fix.ps1\ / \pwsh ./lint.ps1\ → clean, exit 0.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

[Copilot]

🟢 Approval recommended

The changes are consistent, syntactically sound, and the newly added/linked requirement IDs resolve correctly within the repo structure.

Pull request overview

This PR strengthens ApiMark’s requirements traceability setup by enabling “root-tags” orphan detection in ReqStream and ensuring both system-level and off-the-shelf (OTS) dependency requirements are properly rooted to avoid false orphan reports.

Changes:

• Added root-tags: [system, quality] to enable orphan detection anchored on tagged root requirements.
• Tagged top-level “system” requirements and expanded child links to close traceability gaps across core/tool/msbuild/dotnet/cpp/vhdl requirement trees.
• Introduced a new docs/reqstream/quality.yaml root requirement grouping for OTS dependency requirements, and bumped demaconsulting.reqstream to 1.11.0.

File summaries

File	Description
requirements.yaml	Adds root-tags and includes the new quality root file to support orphan detection.
docs/reqstream/quality.yaml	Adds [quality]-tagged root/grouping requirements to attach OTS requirements to a non-functional “quality” root.
docs/reqstream/api-mark-core.yaml	Tags top-level ApiMarkCore requirements as [system] and connects additional child requirements to close gaps.
docs/reqstream/api-mark-dot-net.yaml	Tags top-level ApiMarkDotNet requirements as [system] and links additional child requirements.
docs/reqstream/api-mark-msbuild.yaml	Tags top-level ApiMarkMsbuild requirements as [system] and links additional ApiMarkTask child requirements.
docs/reqstream/api-mark-tool.yaml	Tags the top-level ApiMarkTool requirement as [system].
docs/reqstream/api-mark-tool/cli.yaml	Adds a missing child requirement link for CLI option parsing validation.
docs/reqstream/api-mark-tool/self-test.yaml	Adds missing child requirement links for enforce-docs self-test scenarios and output suppression.
docs/reqstream/api-mark-vhdl.yaml	Tags the top-level ApiMarkVhdl requirement as [system] and links additional child requirements.
docs/reqstream/api-mark-cpp.yaml	Tags top-level ApiMarkCpp requirements as [system].
.config/dotnet-tools.json	Bumps demaconsulting.reqstream tool version to 1.11.0.

Review details

• Files reviewed: 11/11 changed files
• Comments generated: 0
• Review effort level: Lite

---

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