semantic markup update

frontend/src/routes/migration/+page.svelte

@@ -51,6 +51,7 @@
   // [DEF:fetchEnvironments:Function]
   /**
    * @purpose Fetches the list of environments from the API.
+   * @pre     None.
    * @post    environments state is updated.
    */
   async function fetchEnvironments() {
@@ -69,6 +70,7 @@
   // [DEF:fetchDashboards:Function]
   /**
    * @purpose Fetches dashboards for the selected source environment.
+   * @pre     envId is a valid environment ID.
    * @param envId The environment ID.
    * @post    dashboards state is updated.
    */
@@ -93,6 +95,8 @@
   // [DEF:fetchDatabases:Function]
   /**
    * @purpose Fetches databases from both environments and gets suggestions.
+   * @pre     sourceEnvId and targetEnvId must be set.
+   * @post    sourceDatabases, targetDatabases, mappings, and suggestions are updated.
    */
   async function fetchDatabases() {
     if (!sourceEnvId || !targetEnvId) return;
@@ -128,6 +132,8 @@
   // [DEF:handleMappingUpdate:Function]
   /**
    * @purpose Saves a mapping to the backend.
+   * @pre     event.detail contains sourceUuid and targetUuid.
+   * @post    Mapping is saved and local mappings list is updated.
    */
   async function handleMappingUpdate(event: CustomEvent) {
     const { sourceUuid, targetUuid } = event.detail;
@@ -162,6 +168,8 @@
 
   // [DEF:handleViewLogs:Function]
   // @PURPOSE: Opens the log viewer for a specific task.
+  // @PRE: event.detail contains task object.
+  // @POST: logViewer state updated and showLogViewer set to true.
   function handleViewLogs(event: CustomEvent) {
       const task = event.detail;
       logViewerTaskId = task.id;
@@ -172,6 +180,8 @@
 
   // [DEF:handlePasswordPrompt:Function]
   // @PURPOSE: Reactive logic to show password prompt when a task is awaiting input.
+  // @PRE: selectedTask status is AWAITING_INPUT.
+  // @POST: showPasswordPrompt set to true with request data.
   // This is triggered by TaskRunner or TaskHistory when a task needs input
   // For now, we rely on the WebSocket or manual check.
   // Ideally, TaskHistory or TaskRunner emits an event when input is needed.
@@ -194,6 +204,8 @@
 
   // [DEF:handleResumeMigration:Function]
   // @PURPOSE: Resumes a migration task with provided passwords.
+  // @PRE: event.detail contains passwords.
+  // @POST: resumeTask is called and showPasswordPrompt is hidden on success.
   async function handleResumeMigration(event: CustomEvent) {
       if (!$selectedTask) return;
       
@@ -214,6 +226,7 @@
   /**
    * @purpose Starts the migration process.
    * @pre     sourceEnvId and targetEnvId must be set and different.
+   * @post    Migration task is started and selectedTask is updated.
    */
   async function startMigration() {
     if (!sourceEnvId || !targetEnvId) {

frontend/src/routes/migration/mappings/+page.svelte

@@ -32,6 +32,8 @@
 
   // [DEF:fetchEnvironments:Function]
   // @PURPOSE: Fetches the list of environments.
+  // @PRE: None.
+  // @POST: environments array is populated.
   async function fetchEnvironments() {
     try {
       const response = await fetch('/api/environments');
@@ -50,6 +52,8 @@
   // [DEF:fetchDatabases:Function]
   /**
    * @purpose Fetches databases from both environments and gets suggestions.
+   * @pre sourceEnvId and targetEnvId must be set.
+   * @post sourceDatabases, targetDatabases, mappings, and suggestions are updated.
    */
   async function fetchDatabases() {
     if (!sourceEnvId || !targetEnvId) return;
@@ -86,6 +90,8 @@
   // [DEF:handleUpdate:Function]
   /**
    * @purpose Saves a mapping to the backend.
+   * @pre event.detail contains sourceUuid and targetUuid.
+   * @post Mapping is saved and local mappings list is updated.
    */
   async function handleUpdate(event: CustomEvent) {
     const { sourceUuid, targetUuid } = event.detail;