semantic markup update

frontend/src/components/TaskRunner.svelte

@@ -38,6 +38,8 @@
     // [DEF:connect:Function]
     /**
      * @purpose Establishes WebSocket connection with exponential backoff.
+     * @pre selectedTask must be set in the store.
+     * @post WebSocket instance created and listeners attached.
      */
     function connect() {
         const task = get(selectedTask);
@@ -131,6 +133,8 @@
 
     // [DEF:fetchTargetDatabases:Function]
     // @PURPOSE: Fetches the list of databases in the target environment.
+    // @PRE: task must be selected and have a target environment parameter.
+    // @POST: targetDatabases array is populated with database objects.
     async function fetchTargetDatabases() {
         const task = get(selectedTask);
         if (!task || !task.params.to_env) return;
@@ -153,6 +157,8 @@
 
     // [DEF:handleMappingResolve:Function]
     // @PURPOSE: Handles the resolution of a missing database mapping.
+    // @PRE: event.detail contains sourceDbUuid, targetDbUuid, and targetDbName.
+    // @POST: Mapping is saved and task is resumed.
     async function handleMappingResolve(event) {
         const task = get(selectedTask);
         const { sourceDbUuid, targetDbUuid, targetDbName } = event.detail;
@@ -196,6 +202,8 @@
     
     // [DEF:handlePasswordResume:Function]
     // @PURPOSE: Handles the submission of database passwords to resume a task.
+    // @PRE: event.detail contains passwords dictionary.
+    // @POST: Task resume endpoint is called with passwords.
     async function handlePasswordResume(event) {
         const task = get(selectedTask);
         const { passwords } = event.detail;
@@ -218,6 +226,8 @@
 
     // [DEF:startDataTimeout:Function]
     // @PURPOSE: Starts a timeout to detect when the log stream has stalled.
+    // @PRE: None.
+    // @POST: dataTimeout is set to check connection status after 5s.
     function startDataTimeout() {
         waitingForData = false;
         dataTimeout = setTimeout(() => {
@@ -230,6 +240,8 @@
 
     // [DEF:resetDataTimeout:Function]
     // @PURPOSE: Resets the data stall timeout.
+    // @PRE: dataTimeout must be active.
+    // @POST: dataTimeout is cleared and restarted.
     function resetDataTimeout() {
         clearTimeout(dataTimeout);
         waitingForData = false;
@@ -239,6 +251,8 @@
 
     // [DEF:onMount:Function]
     // @PURPOSE: Initializes the component and subscribes to task selection changes.
+    // @PRE: Svelte component is mounting.
+    // @POST: Store subscription is created and returned for cleanup.
     onMount(() => {
         // Subscribe to selectedTask changes
         const unsubscribe = selectedTask.subscribe(task => {
@@ -267,6 +281,8 @@
     // [DEF:onDestroy:Function]
     /**
      * @purpose Close WebSocket connection when the component is destroyed.
+     * @pre Component is being destroyed.
+     * @post WebSocket is closed and timeouts are cleared.
      */
     onDestroy(() => {
         clearTimeout(reconnectTimeout);