Sync VHDLTest with TemplateDotNetTool template (#103)

* Initial plan

* Update project to align with TemplateDotNetTool template

- Update .editorconfig to match template format:
  - Use LF line endings globally (not CRLF for C# files)
  - Simplified to cleaner template structure
  - Upgrade naming convention severity from suggestion to warning
  - Add csharp_nullable_reference_types = enable
  - Add csharp_prefer_braces = true:warning (was silent)
  - Add csharp_style_namespace_declarations = file_scoped:warning
  - Consolidate XML file groups
- Convert all C# source and test files from CRLF to LF line endings
- Apply dotnet format to fix new csharp_prefer_braces:warning violations
- Update .markdownlint-cli2.jsonc:
  - Remove MD024 (siblings_only) rule not in template
  - Fix node_modules ignore pattern ('**/node_modules' -> 'node_modules')
  - Remove comment blocks not in template
- Update .cspell.json ignorePaths to match template:
  - Remove non-template entries: *.csproj, *spdx.json, TestResults, .vs, *.bak
  - Fix spdx.json pattern to *.spdx.json
  - Reorder to match template structure
- Update .github/ISSUE_TEMPLATE/config.yml:
  - Add documentation link matching template structure
  - Update discussions link name from 'Ask a Question' to 'Discussions'
  - Keep security issue link (VHDLTest-specific)
- Add missing .github/ISSUE_TEMPLATE/question.yml (adapted from template)
- Update .github/pull_request_template.md:
  - Add self-validation tests step with VHDLTest project path
  - Fix YAML linter command to match template (yamllint .)
  - Update 'All tests pass' to 'All unit tests pass' to match template
- Update AGENTS.md:
  - Add Agent Selection Guide section
  - Add Project Structure section
  - Add Documentation section
  - Add Markdown Link Style section
  - Add CI/CD section
  - Add Agent Report Files section
  - Update Key Files to reference dotnet reqstream --enforce
  - Update Requirements section to use reqstream enforcement
  - Update Code Style section with full details
- Update .github/agents/requirements-agent.md:
  - Add Test Source Filters section (matches template)
  - Update enforcement command to use dotnet reqstream
- Update .github/dependabot.yml:
  - Rename NuGet group from 'dotnet-dependencies' to 'nuget-dependencies'
- Update .github/workflows/build.yaml:
  - Fix quality check step names to match template:
    'Spell Check' -> 'Run spell checker'
    'Markdown Lint' -> 'Run markdown linter'
    'YAML Lint' -> 'Run YAML linter'
  - Reorder quality checks: markdown first, then spell check, then YAML
  - Add name field to build job ('Build ${{ matrix.os }}')
  - Reorder build job: name, needs, permissions (matches template)
  - Remove inline comments from build job permissions
  - Add --pdf-variant pdf/a-3u to all Weasyprint PDF generation steps
  - Fix SonarMark step to use shell:bash and bash-compatible $SONAR_TOKEN

* Add macOS support from template PR #54: build/test-ghdl matrices, OS_SHORT fix, requirements, AGENTS

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Add brew install nvc for macOS, use mcode backend for GHDL, add macOS to test-nvc matrix

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Fix MD024 lint failure by enabling siblings_only for duplicate headings

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Restore llvm backend for GHDL on macOS (mcode unsupported)

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Add diagnostic output (exit code + simulator log) on validation test failure

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Add GHDL elaboration step (-e) before run (-r) to fix llvm backend on macOS

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Fix cspell: rename elabResults to elaborateResults

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Update .github/agents/requirements-agent.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix ActiveHdlSimulator: standardize output directory to VHDLTest.out/ActiveHDL

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

* Fix deadlock risks in RunProgram/Runner; add const for ActiveHDL dir; fix VivadoSimulator comment

Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Malcolmnixon <1863707+Malcolmnixon@users.noreply.github.com>
Co-authored-by: Malcolm Nixon <Malcolm.nixon@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.cspell.json

@@ -71,22 +71,17 @@
   ],
   "ignorePaths": [
     "node_modules",
+    ".git",
     "bin",
     "obj",
-    ".git",
-    "*.dll",
-    "*.exe",
-    "*.pdb",
     "*.nupkg",
     "*.snupkg",
+    "*.dll",
+    "*.exe",
     "*.trx",
-    "*.csproj",
-    "*spdx.json",
+    "*.spdx.json",
     "package-lock.json",
     "yarn.lock",
-    "TestResults",
-    ".vs",
-    "*.bak",
     "AGENT_REPORT_*.md"
   ]
 }

.editorconfig

@@ -5,242 +5,66 @@ root = true
 
 # All files
 [*]
+charset = utf-8
+end_of_line = lf
 indent_style = space
+indent_size = 4
 insert_final_newline = true
 trim_trailing_whitespace = true
-charset = utf-8
-
-# Code files
-[*.{cs,csx,vb,vbx}]
-indent_size = 4
 
-# XML project files
-[*.{csproj,vbproj,vcxproj,vcxproj.filters,proj,projitems,shproj}]
-indent_size = 2
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false
 
-# XML config files
-[*.{props,targets,ruleset,config,nuspec,resx,vsixmanifest,vsct}]
+# YAML files
+[*.{yml,yaml}]
 indent_size = 2
 
 # JSON files
 [*.json]
 indent_size = 2
 
-# YAML files
-[*.{yml,yaml}]
+# XML files
+[*.{xml,csproj,props,targets}]
 indent_size = 2
 
-# Markdown files
-[*.md]
-trim_trailing_whitespace = false
-
-# Shell scripts
-[*.sh]
-end_of_line = lf
-
-# Batch files
-[*.{cmd,bat}]
-end_of_line = crlf
-
 # C# files
 [*.cs]
-
-#### Core EditorConfig Options ####
-
-# Indentation and spacing
 indent_size = 4
-tab_width = 4
-
-# New line preferences
-end_of_line = crlf
-insert_final_newline = true
-
-#### .NET Coding Conventions ####
-
-# Organize usings
-dotnet_separate_import_directive_groups = false
-dotnet_sort_system_directives_first = true
-file_header_template = unset
-
-# this. and Me. preferences
-dotnet_style_qualification_for_event = false:suggestion
-dotnet_style_qualification_for_field = false:suggestion
-dotnet_style_qualification_for_method = false:suggestion
-dotnet_style_qualification_for_property = false:suggestion
-
-# Language keywords vs BCL types preferences
-dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
-dotnet_style_predefined_type_for_member_access = true:suggestion
-
-# Parentheses preferences
-dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:silent
-dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:silent
-dotnet_style_parentheses_in_other_operators = never_if_unnecessary:silent
-dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:silent
-
-# Modifier preferences
-dotnet_style_require_accessibility_modifiers = for_non_interface_members:suggestion
-
-# Expression-level preferences
-dotnet_style_coalesce_expression = true:suggestion
-dotnet_style_collection_initializer = true:suggestion
-dotnet_style_explicit_tuple_names = true:suggestion
-dotnet_style_namespace_match_folder = true:suggestion
-dotnet_style_null_propagation = true:suggestion
-dotnet_style_object_initializer = true:suggestion
-dotnet_style_operator_placement_when_wrapping = beginning_of_line
-dotnet_style_prefer_auto_properties = true:suggestion
-dotnet_style_prefer_compound_assignment = true:suggestion
-dotnet_style_prefer_conditional_expression_over_assignment = true:silent
-dotnet_style_prefer_conditional_expression_over_return = true:silent
-dotnet_style_prefer_inferred_anonymous_type_member_names = true:suggestion
-dotnet_style_prefer_inferred_tuple_names = true:suggestion
-dotnet_style_prefer_is_null_check_over_reference_equality_method = true:suggestion
-dotnet_style_prefer_simplified_boolean_expressions = true:suggestion
-dotnet_style_prefer_simplified_interpolation = true:suggestion
-
-# Field preferences
-dotnet_style_readonly_field = true:suggestion
-
-# Parameter preferences
-dotnet_code_quality_unused_parameters = all:suggestion
-
-# Suppression preferences
-dotnet_remove_unnecessary_suppression_exclusions = none
-
-#### C# Coding Conventions ####
-
-# var preferences
-csharp_style_var_elsewhere = false:silent
-csharp_style_var_for_built_in_types = false:silent
-csharp_style_var_when_type_is_apparent = false:silent
 
-# Expression-bodied members
-csharp_style_expression_bodied_accessors = true:silent
-csharp_style_expression_bodied_constructors = false:silent
-csharp_style_expression_bodied_indexers = true:silent
-csharp_style_expression_bodied_lambdas = true:suggestion
-csharp_style_expression_bodied_local_functions = false:silent
+# Code style rules
+csharp_prefer_braces = true:warning
+csharp_prefer_simple_using_statement = true:suggestion
+csharp_style_namespace_declarations = file_scoped:warning
+csharp_style_prefer_method_group_conversion = true:silent
+csharp_style_prefer_top_level_statements = true:silent
 csharp_style_expression_bodied_methods = false:silent
+csharp_style_expression_bodied_constructors = false:silent
 csharp_style_expression_bodied_operators = false:silent
 csharp_style_expression_bodied_properties = true:silent
+csharp_style_expression_bodied_indexers = true:silent
+csharp_style_expression_bodied_accessors = true:silent
+csharp_style_expression_bodied_lambdas = true:silent
+csharp_style_expression_bodied_local_functions = false:silent
 
-# Pattern matching preferences
-csharp_style_pattern_matching_over_as_with_null_check = true:suggestion
-csharp_style_pattern_matching_over_is_with_cast_check = true:suggestion
-csharp_style_prefer_not_pattern = true:suggestion
-csharp_style_prefer_pattern_matching = true:silent
-csharp_style_prefer_switch_expression = true:suggestion
-csharp_style_prefer_extended_property_pattern = true:suggestion
-
-# Null-checking preferences
-csharp_style_conditional_delegate_call = true:suggestion
-csharp_style_prefer_parameter_null_checking = true:suggestion
-
-# Modifier preferences
-csharp_prefer_static_local_function = true:suggestion
-csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async:suggestion
-
-# Code-block preferences
-csharp_prefer_braces = true:silent
-csharp_prefer_simple_using_statement = true:suggestion
-
-# Expression-level preferences
-csharp_prefer_simple_default_expression = true:suggestion
-csharp_style_deconstructed_variable_declaration = true:suggestion
-csharp_style_implicit_object_creation_when_type_is_apparent = true:suggestion
-csharp_style_inlined_variable_declaration = true:suggestion
-csharp_style_pattern_local_over_anonymous_function = true:suggestion
-csharp_style_prefer_index_operator = true:suggestion
-csharp_style_prefer_null_check_over_type_check = true:suggestion
-csharp_style_prefer_range_operator = true:suggestion
-csharp_style_throw_expression = true:suggestion
-csharp_style_unused_value_assignment_preference = discard_variable:suggestion
-csharp_style_unused_value_expression_statement_preference = discard_variable:silent
-
-# 'using' directive preferences
-csharp_using_directive_placement = outside_namespace:silent
-
-# Namespace preferences
-csharp_style_namespace_declarations = file_scoped:suggestion
-
-#### C# Formatting Rules ####
-
-# New line preferences
-csharp_new_line_before_catch = true
-csharp_new_line_before_else = true
-csharp_new_line_before_finally = true
-csharp_new_line_before_members_in_anonymous_types = true
-csharp_new_line_before_members_in_object_initializers = true
-csharp_new_line_before_open_brace = all
-csharp_new_line_between_query_expression_clauses = true
-
-# Indentation preferences
-csharp_indent_block_contents = true
-csharp_indent_braces = false
-csharp_indent_case_contents = true
-csharp_indent_case_contents_when_block = true
-csharp_indent_labels = one_less_than_current
-csharp_indent_switch_labels = true
-
-# Space preferences
-csharp_space_after_cast = false
-csharp_space_after_colon_in_inheritance_clause = true
-csharp_space_after_comma = true
-csharp_space_after_dot = false
-csharp_space_after_keywords_in_control_flow_statements = true
-csharp_space_after_semicolon_in_for_statement = true
-csharp_space_around_binary_operators = before_and_after
-csharp_space_around_declaration_statements = false
-csharp_space_before_colon_in_inheritance_clause = true
-csharp_space_before_comma = false
-csharp_space_before_dot = false
-csharp_space_before_open_square_brackets = false
-csharp_space_before_semicolon_in_for_statement = false
-csharp_space_between_empty_square_brackets = false
-csharp_space_between_method_call_empty_parameter_list_parentheses = false
-csharp_space_between_method_call_name_and_opening_parenthesis = false
-csharp_space_between_method_call_parameter_list_parentheses = false
-csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
-csharp_space_between_method_declaration_name_and_open_parenthesis = false
-csharp_space_between_method_declaration_parameter_list_parentheses = false
-csharp_space_between_parentheses = false
-csharp_space_between_square_brackets = false
-
-# Wrapping preferences
-csharp_preserve_single_line_blocks = true
-csharp_preserve_single_line_statements = true
-
-#### Naming styles ####
-
-# Naming rules
-
-dotnet_naming_rule.interface_should_be_begins_with_i.severity = suggestion
+# Naming conventions
+dotnet_naming_rule.interface_should_be_begins_with_i.severity = warning
 dotnet_naming_rule.interface_should_be_begins_with_i.symbols = interface
 dotnet_naming_rule.interface_should_be_begins_with_i.style = begins_with_i
 
-dotnet_naming_rule.types_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.types_should_be_pascal_case.severity = warning
 dotnet_naming_rule.types_should_be_pascal_case.symbols = types
 dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case
 
-dotnet_naming_rule.non_field_members_should_be_pascal_case.severity = suggestion
+dotnet_naming_rule.non_field_members_should_be_pascal_case.severity = warning
 dotnet_naming_rule.non_field_members_should_be_pascal_case.symbols = non_field_members
 dotnet_naming_rule.non_field_members_should_be_pascal_case.style = pascal_case
 
-dotnet_naming_rule.private_or_internal_field_should_be_begins_with_underscore.severity = suggestion
-dotnet_naming_rule.private_or_internal_field_should_be_begins_with_underscore.symbols = private_or_internal_field
-dotnet_naming_rule.private_or_internal_field_should_be_begins_with_underscore.style = begins_with_underscore
-
 # Symbol specifications
-
 dotnet_naming_symbols.interface.applicable_kinds = interface
 dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
 dotnet_naming_symbols.interface.required_modifiers = 
 
-dotnet_naming_symbols.private_or_internal_field.applicable_kinds = field
-dotnet_naming_symbols.private_or_internal_field.applicable_accessibilities = internal, private, private_protected
-dotnet_naming_symbols.private_or_internal_field.required_modifiers = 
-
 dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
 dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
 dotnet_naming_symbols.types.required_modifiers = 
@@ -250,18 +74,22 @@ dotnet_naming_symbols.non_field_members.applicable_accessibilities = public, int
 dotnet_naming_symbols.non_field_members.required_modifiers = 
 
 # Naming styles
+dotnet_naming_style.begins_with_i.required_prefix = I
+dotnet_naming_style.begins_with_i.required_suffix = 
+dotnet_naming_style.begins_with_i.word_separator = 
+dotnet_naming_style.begins_with_i.capitalization = pascal_case
 
 dotnet_naming_style.pascal_case.required_prefix = 
 dotnet_naming_style.pascal_case.required_suffix = 
 dotnet_naming_style.pascal_case.word_separator = 
 dotnet_naming_style.pascal_case.capitalization = pascal_case
 
-dotnet_naming_style.begins_with_i.required_prefix = I
-dotnet_naming_style.begins_with_i.required_suffix = 
-dotnet_naming_style.begins_with_i.word_separator = 
-dotnet_naming_style.begins_with_i.capitalization = pascal_case
+# Organize usings
+dotnet_sort_system_directives_first = true
+dotnet_separate_import_directive_groups = false
+
+# Code quality - set to suggestion to not break existing code
+dotnet_code_quality_unused_parameters = all:suggestion
 
-dotnet_naming_style.begins_with_underscore.required_prefix = _
-dotnet_naming_style.begins_with_underscore.required_suffix = 
-dotnet_naming_style.begins_with_underscore.word_separator = 
-dotnet_naming_style.begins_with_underscore.capitalization = camel_case
+# Nullable reference types
+csharp_nullable_reference_types = enable

.github/ISSUE_TEMPLATE/config.yml

@@ -1,7 +1,10 @@
 ---
 blank_issues_enabled: false
 contact_links:
-  - name: 💬 Ask a Question
+  - name: 📚 Documentation
+    url: https://github.com/demaconsulting/VHDLTest
+    about: Read the documentation for VHDLTest
+  - name: 💬 Discussions
     url: https://github.com/demaconsulting/VHDLTest/discussions
     about: Ask questions and discuss with the community
   - name: 🔒 Security Issue