Add root-tags orphan detection and close CLI traceability gap

[Malcolmnixon]

Summary

Adds root-tags-based orphan detection to VersionMark, following the same
pattern already applied to ReqStream, DictionaryMark, FileAssert, ReviewMark,
SarifMark, SonarMark, and Ste100Mark.

• Upgraded demaconsulting.reqstream from 1.10.0 to 1.11.0.
• Tagged all System-* and Platform-* requirements with [system].
• Added docs/reqstream/quality.yaml with [quality]-tagged requirements for
  repository/process-level outcomes (build integrity, static analysis, peer
  review, documentation generation, test infrastructure, requirements
  traceability, architecture traceability), each linking to its supporting OTS
  tool as a children entry (never named in the requirement text) and each
  carrying direct test evidence links.
• Set root-tags: [system, quality] in requirements.yaml, with a comment
  explaining that configuring root-tags here makes orphan checking automatic
  on every reqstream invocation (no --root-tags flag needed).

Closing a real traceability gap

VersionMark already had a partial children: hierarchy under its four System
requirements (Capture, Publish, Lint, Validate), but 60 of 127 requirements
were unreachable from any of them - most notably every CommandLine-* and
Context-* requirement covering the tool's baseline -v/--version,
-h/--help, --silent, --log, and error-handling flags. These flags are
documented in the README and exercised by passing tests, but had no
System-level requirement representing them.

A new VersionMark-System-CommandLine requirement was added to close this
gap, backed by existing passing tests (no fabricated links). The remaining 59
orphans (Program dispatch, VersionInfo/Formatter error and consolidation
paths, Configuration file parsing, and Utilities glob/path helpers) were
linked as children of the specific System requirement whose behavior they
implement. The three genuinely product-facing OTS dependencies (YamlDotNet,
FileSystemGlobbing, TestResults) are linked as children of the requirements
that actually consume them, while the remaining 12 process/compliance OTS
requirements are linked under the new quality.yaml.

Validation

dotnet reqstream --requirements requirements.yaml --enforce
# 0 of 139 requirements orphaned (root-tags: system, quality)

• pwsh ./build.ps1 - build succeeded, 732/735 tests passed (3 skipped, Unix-only) across net8.0/net9.0/net10.0.
• pwsh ./fix.ps1 - no formatting changes needed.
• pwsh ./lint.ps1 - no errors (yamllint, cspell/markdownlint, ReqStream, ReviewMark, SysML2Tools, dotnet format).

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

[Copilot]

🟢 Approval recommended

The changes are limited to requirements/traceability configuration and documentation, and the referenced IDs/tests appear consistent with existing OTS and test naming in the repository.

Pull request overview

This PR strengthens VersionMark’s requirements traceability by introducing root-tags-based orphan detection and extending the requirements hierarchy so previously-unreachable CLI and utility behaviors trace to root system/quality requirements.

Changes:

• Configure root-tags: [system, quality] and add a new docs/reqstream/quality.yaml to model repository/process quality outcomes as requirements.
• Close a CLI traceability gap by adding a new root system requirement for baseline command-line behavior and linking additional previously-orphaned requirements into the System hierarchy.
• Upgrade demaconsulting.reqstream from 1.10.0 to 1.11.0 to support/align with the new root-tags enforcement behavior.

File summaries

File	Description
requirements.yaml	Adds root-tags: [system, quality] and includes the new quality requirements file to enable automatic orphan detection.
docs/reqstream/version-mark/utilities.yaml	Links FileSystemGlobbing OTS dependency under the utilities requirements tree.
docs/reqstream/version-mark/publishing.yaml	Adds missing children links from publishing behaviors to formatter/version/glob requirements to eliminate orphans.
docs/reqstream/version-mark/platform-requirements.yaml	Tags platform requirements with [system] so they qualify as roots under configured root-tags.
docs/reqstream/version-mark/configuration.yaml	Links YamlDotNet OTS dependency to the configuration requirements that consume it.
docs/reqstream/version-mark/capture.yaml	Adds missing children links from capture behaviors to config/path/version-info requirements to eliminate orphans.
docs/reqstream/version-mark.yaml	Tags top-level System requirements with [system] and adds a new System CLI requirement to close CLI traceability gaps.
docs/reqstream/quality.yaml	Introduces [quality] root requirements for CI/repository outcomes and links the supporting OTS tools as children.
.config/dotnet-tools.json	Bumps demaconsulting.reqstream tool version to 1.11.0.

Review details

• Files reviewed: 9/9 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.