+

frontend/src/lib/components/assistant/AssistantChatPanel.svelte

@@ -9,6 +9,10 @@
    * @RELATION: BINDS_TO -> DatasetReviewWorkspace
    * @RELATION: DISPATCHES -> taskDrawer
    * @SEMANTICS: assistant-chat, confirmation, long-running-task, progress-tracking
+   * @PRE: Assistant chat store, API adapters, and optional dataset review session context are initialized before the panel becomes interactive.
+   * @POST: User and assistant message state, conversation history, and task affordances stay synchronized with the active conversation scope.
+   * @SIDE_EFFECT: Reads and mutates assistant conversation state, may navigate to review routes, opens task drawer affordances, and emits toast feedback.
+   * @DATA_CONTRACT: Input[{variant,className,assistantChatStore,datasetReviewSessionId?}] -> Output[{messages,conversations,conversationId,llmReady,panelVisible}]
    * @INVARIANT: User commands and assistant responses are appended in chronological order.
    * @INVARIANT: Risky operations are executed only through explicit confirm action.
    * @UX_STATE: Closed -> Panel is hidden when variant is drawer.

frontend/src/lib/components/health/PolicyForm.svelte

@@ -3,8 +3,9 @@
 @COMPLEXITY: 3
 @PURPOSE: Form for creating and editing validation policies.
 @LAYER: UI
-@RELATION: DISPATCHES -> onSave
-@RELATION: DISPATCHES -> onCancel
+@RELATION: DEPENDS_ON -> ValidationPolicy
+@PRE: Parent provides callable onSave/onCancel handlers and an environments collection that may be empty but remains array-like.
+@POST: Form submission forwards the current draft to onSave and cancel delegates dismissal to the parent callback without mutating external state directly.
 
 @UX_STATE: Idle -> Displays the policy form.
 @UX_STATE: Submitting -> Disables inputs and shows a loading state.