Document and validate C++ and C# APIs in English and Russian

[konard]

Summary

Complete bilingual English/Russian API documentation for both languages in #12, including the request for complete CI coverage and the C# follow-up.

• Add documentation comments to all public declarations across the 39 C++ headers, including concepts, primary templates, helper types, aliases, generated-member macros, interface methods, and destructors. The comments on IMatcher match the current main API.
• Add a C++ workflow that checks source comment coverage, builds Doxygen HTML and XML with warnings as errors, and uploads both formats. The source check catches undocumented concepts that Doxygen 1.9.8 does not warn about. Internal implementation helpers are excluded from the published reference.
• Verify all 22 generated public C# API members have English and Russian XML paragraphs in their summaries and present parameter, type parameter, return, and other documentation sections. The existing C# build treats missing XML comments as errors; the new check catches single-language comments. Require the XML file in the NuGet package. The existing DocFX workflow generates and validates the C# site and PDF.
• Bump the C++ package to 0.4.1 and the C# package to 0.6.1 with release notes for their documentation updates.

Reproduction

At the previous PR head, CEnumerable.h defined Enumerable and its public type aliases without documentation, and CCounter.h defined an undocumented public concept. Doxygen reported missing class/member comments for Enumerable but did not report the concept. The C++ coverage check now fails for both omissions and for undocumented primary templates.

Previously, replacing a Russian <para> in a C# XML comment with another English paragraph would still let the C# build and DocFX site succeed. The new XML coverage check fails on that case, on a missing English paragraph, and on an empty member list. All current 22 C# API members pass.

Verification

• C++ coverage regression tests: 4 passed; all 39 public headers passed the coverage check.
• Doxygen HTML and XML: generated with zero warnings.
• C++ CMake/GoogleTest suite: 8 passed.
• C# XML coverage regression tests: 4 passed; all 22 generated API members passed.
• C# build: zero warnings; 3 tests passed; NuGet package contains Platform.Interfaces.xml.
• DocFX site and PDF: generated with zero warnings; site validation passed.
• Repository Node policy suite: 41 passed.
• git diff --check: passed.

The local C# tests used .NET major-version roll-forward because this workspace has .NET 10 and the test host targets .NET 8. GitHub Actions runs with .NET 8.

Fixes #12.

[konard]

Here we also need to ensure exactly everything is fully covered with doc comments, so it will be possible to generate docs automatically using our CI/CD.

[konard]

🤖 AI Work Session Started

Starting automated work session at 2026-09-26T02:19:22.312Z

The PR has been converted to draft mode while work is in progress.

This comment marks the beginning of an AI work session. Please wait for the session to finish, and provide your feedback.

Runtime: solve v2.32.0 · tool codex · model gpt-6-sol · task image konard/hive-mind-dind:2.32.0@sha256:f73befa87d04185dfba6329bbb9acc8b8b16f1bbb1b07d68d7b38d28df574020

[konard]

Not only C++, C# also, all our programming languages must be fully supported.

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Model: GPT-6 Sol
• Provider: OpenAI
• Public pricing estimate: $6.977096

📊 Context and tokens usage:

• 225.3K / 200K (113%) input tokens, 59.0K / 128K (46%) output tokens

Total: (225.3K + 13.0M cached) input tokens, 59.0K output tokens, $6.977096 cost

🤖 Models used:

• Tool: OpenAI Codex
• Requested: gpt-6-sol
• Thinking level: xhigh (~31999 tokens)
• Model: GPT-6 Sol (gpt-6-sol)

📎 Log file uploaded as Gist (6538KB)

• View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.

[konard]

🎉 Auto-merged

This pull request has been automatically merged by hive-mind.

• All CI checks have passed

---

Auto-merged by hive-mind with --auto-merge flag