init

docs/ai/Common/DTS.CommonCore/Interface/TestModule.md

@@ -0,0 +1,64 @@
+---
+source_files:
+  - Common/DTS.CommonCore/Interface/TestModule/ITestModuleView.cs
+  - Common/DTS.CommonCore/Interface/TestModule/ITestModuleViewModel.cs
+generated_at: "2026-04-17T16:36:19.630468+00:00"
+model: "zai-org/GLM-5-FP8"
+schema_version: 1
+sha256: "cc0415a419692cf6"
+---
+
+# Documentation: Test Module View Interfaces
+
+## 1. Purpose
+
+This module defines the view and view model contracts for a Test Module component within an MVVM (Model-View-ViewModel) architecture. `ITestModuleView` serves as a marker interface for test module views, while `ITestModuleViewModel` provides the contract for a view model that exposes a collection of assemblies, likely for test discovery or execution purposes.
+
+---
+
+## 2. Public Interface
+
+### `ITestModuleView`
+**Namespace:** `DTS.Common.Interface`  
+**Inherits from:** `IBaseView`
+
+An empty marker interface. No members are defined beyond those inherited from `IBaseView`.
+
+---
+
+### `ITestModuleViewModel`
+**Namespace:** `DTS.Common.Interface`  
+**Inherits from:** `IBaseViewModel`
+
+| Member | Type | Access | Description |
+|--------|------|--------|-------------|
+| `AssemblyList` | `List<Assembly>` | get; set; | A mutable list of `System.Reflection.Assembly` objects associated with the test module. |
+
+---
+
+## 3. Invariants
+
+- `ITestModuleView` must always be assignable to `IBaseView`.
+- `ITestModuleViewModel` must always be assignable to `IBaseViewModel`.
+- The `AssemblyList` property is declared as `List<Assembly>` (reference type); nullability constraints, if any, are not specified in the interface and must be enforced by implementations.
+- The presence of a public setter on `AssemblyList` implies the list reference itself can be replaced, not just modified in-place.
+
+---
+
+## 4. Dependencies
+
+### This module depends on:
+- `DTS.Common.Base` — provides `IBaseView` and `IBaseViewModel` base interfaces
+- `System.Collections.Generic` — provides `List<T>` (used in `ITestModuleViewModel`)
+- `System.Reflection` — provides `Assembly` (used in `ITestModuleViewModel`)
+
+### What depends on this module:
+- **Unknown from source alone.** No consumers are visible in the provided files.
+
+---
+
+## 5. Gotchas
+
+- **Marker interface with no members:** `ITestModuleView` defines no members of its own. Its purpose (type identification, dependency injection registration, etc.) is not clear from the source alone.
+- **Mutable list with setter:** The `AssemblyList` property allows both getting and setting the entire list reference. Callers can replace the list entirely, which may have implications for consumers expecting the same list instance to be retained. Thread-safety and change notification behaviors are unspecified.
+- **Nullability not specified:** The interface does not indicate whether `AssemblyList` may be null or must always contain valid `Assembly` objects. Implementations must define and document their own constraints.