semantics

specs/020-task-reports-design/contracts/modules.md

@@ -15,7 +15,7 @@
 # @POST: Response contains normalized reports with deterministic ordering and total metadata.
 # @POST: Unknown task type is mapped to fallback type "unknown" and remains visible.
 # @POST: Partial payloads are rendered with placeholders, never causing report omission.
-# [/DEF:ReportsAggregationModule]
+# [/DEF:ReportsAggregationModule:Module]
 
 ---
 
@@ -33,7 +33,7 @@
 # @POST: List endpoint returns {items, total, page, page_size, has_next, applied_filters}.
 # @POST: Detail endpoint returns a single normalized report with diagnostics/next actions when available.
 # @POST: Validation errors are explicit (400-range) and machine-readable.
-# [/DEF:ReportsApiContract]
+# [/DEF:ReportsApiContract:Module]
 
 ---
 
@@ -59,7 +59,7 @@
  * @UX_FEEDBACK: On filter apply, list updates with immediate visual acknowledgment.
  * @UX_RECOVERY: Retry failed loads, clear filters, and continue reading partial reports with placeholders.
  */
-<!-- [/DEF:UnifiedReportsPage] -->
+<!-- [/DEF:UnifiedReportsPage:Component] -->
 
 ---
 
@@ -75,7 +75,7 @@
 # @INVARIANT: Native fetch is not used directly; existing wrapper-based request path is preserved.
 # @PRE: Valid auth token is present when required by backend.
 # @POST: Returns parsed report payload or structured error object for UI-state mapping.
-# [/DEF:ReportsApiClient]
+# [/DEF:ReportsApiClient:Module]
 
 ---
 
@@ -90,7 +90,7 @@
 # @INVARIANT: Exactly one fallback profile exists and is used for unknown task types.
 # @PRE: Input task_type may be known or unknown.
 # @POST: Returns profile with display label and variant tokens required for rendering.
-# [/DEF:ReportTypeProfileRegistry]
+# [/DEF:ReportTypeProfileRegistry:Module]
 
 ---
 
@@ -106,4 +106,4 @@ Scenario traced: Operator finds failed migration quickly and triages.
 6. `ReportsApiContract` detail endpoint returns diagnostics + `next_actions`.
 7. UI shows actionable failure context and recovery guidance without changing page context.
 
-Continuity check: No interface mismatch found across contracts for list/filter/detail path.
+Continuity check: No interface mismatch found across contracts for list/filter/detail path.