semantics update

frontend/package-lock.json

@@ -912,7 +912,6 @@
       "integrity": "sha512-Vp3zX/qlwerQmHMP6x0Ry1oY7eKKRcOWGc2P59srOp4zcqyn+etJyQpELgOi4+ZSUgteX8Y387NuwruLgGXLUQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@standard-schema/spec": "^1.0.0",
         "@sveltejs/acorn-typescript": "^1.0.5",
@@ -952,7 +951,6 @@
       "integrity": "sha512-YZs/OSKOQAQCnJvM/P+F1URotNnYNeU3P2s4oIpzm1uFaqUEqRxUB0g5ejMjEb5Gjb9/PiBI5Ktrq4rUUF8UVQ==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@sveltejs/vite-plugin-svelte-inspector": "^5.0.0",
         "debug": "^4.4.1",
@@ -1006,7 +1004,6 @@
       "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "acorn": "bin/acorn"
       },
@@ -1155,7 +1152,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "baseline-browser-mapping": "^2.9.0",
         "caniuse-lite": "^1.0.30001759",
@@ -1613,7 +1609,6 @@
       "integrity": "sha512-/imKNG4EbWNrVjoNC/1H5/9GFy+tqjGBHCaSsN+P2RnPqjsLmv6UD3Ej+Kj8nBWaRAwyk7kK5ZUc+OEatnTR3A==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "bin": {
         "jiti": "bin/jiti.js"
       }
@@ -1851,7 +1846,6 @@
         }
       ],
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "nanoid": "^3.3.11",
         "picocolors": "^1.1.1",
@@ -2224,7 +2218,6 @@
       "integrity": "sha512-ZhLtvroYxUxr+HQJfMZEDRsGsmU46x12RvAv/zi9584f5KOX7bUrEbhPJ7cKFmUvZTJXi/CFZUYwDC6M1FigPw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "@jridgewell/remapping": "^2.3.4",
         "@jridgewell/sourcemap-codec": "^1.5.0",
@@ -2348,7 +2341,6 @@
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },
@@ -2430,7 +2422,6 @@
       "integrity": "sha512-dZwN5L1VlUBewiP6H9s2+B3e3Jg96D0vzN+Ry73sOefebhYr9f94wwkMNN/9ouoU8pV1BqA1d1zGk8928cx0rg==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "esbuild": "^0.27.0",
         "fdir": "^6.5.0",
@@ -2524,7 +2515,6 @@
       "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "engines": {
         "node": ">=12"
       },

frontend/src/components/tools/ConnectionForm.svelte

@@ -45,6 +45,7 @@
             isSubmitting = false;
         }
     }
+    // [/DEF:handleSubmit:Function]
 
     function resetForm() {
         name = '';

frontend/src/components/tools/ConnectionList.svelte

@@ -29,6 +29,7 @@
             isLoading = false;
         }
     }
+    // [/DEF:fetchConnections:Function]
 
     // [DEF:handleDelete:Function]
     // @PURPOSE: Deletes a connection configuration.
@@ -43,6 +44,7 @@
             addToast(e.message, 'error');
         }
     }
+    // [/DEF:handleDelete:Function]
 
     onMount(fetchConnections);
 

frontend/src/components/tools/DebugTool.svelte

@@ -23,6 +23,13 @@
     let results = null;
     let pollInterval;
 
+    // [DEF:fetchEnvironments:Function]
+    /**
+     * @purpose Fetches available environments.
+     * @pre     API is available.
+     * @post    envs variable is populated.
+     * @returns {Promise<void>}
+     */
     async function fetchEnvironments() {
         try {
             const res = await fetch('/api/environments');
@@ -31,7 +38,15 @@
             addToast('Failed to fetch environments', 'error');
         }
     }
+    // [/DEF:fetchEnvironments:Function]
 
+    // [DEF:handleRunDebug:Function]
+    /**
+     * @purpose Triggers the debug task.
+     * @pre     Required fields are selected.
+     * @post    Task is started and polling begins.
+     * @returns {Promise<void>}
+     */
     async function handleRunDebug() {
         isRunning = true;
         results = null;
@@ -66,7 +81,16 @@
             addToast(e.message, 'error');
         }
     }
+    // [/DEF:handleRunDebug:Function]
 
+    // [DEF:startPolling:Function]
+    /**
+     * @purpose Polls for task completion.
+     * @pre     Task ID is valid.
+     * @post    Polls until success/failure.
+     * @param   {string} taskId - ID of the task.
+     * @returns {void}
+     */
     function startPolling(taskId) {
         if (pollInterval) clearInterval(pollInterval);
         pollInterval = setInterval(async () => {
@@ -89,6 +113,7 @@
             }
         }, 2000);
     }
+    // [/DEF:startPolling:Function]
 
     onMount(fetchEnvironments);
 </script>
@@ -161,4 +186,5 @@
             </div>
         </div>
     {/if}
-</div>
+</div>
+<!-- [/DEF:DebugTool:Component] -->

frontend/src/components/tools/MapperTool.svelte

@@ -37,6 +37,7 @@
             addToast('Failed to fetch data', 'error');
         }
     }
+    // [/DEF:fetchData:Function]
 
     // [DEF:handleRunMapper:Function]
     // @PURPOSE: Triggers the MapperPlugin task.
@@ -77,6 +78,7 @@
             isRunning = false;
         }
     }
+    // [/DEF:handleRunMapper:Function]
 
     onMount(fetchData);
 </script>

frontend/src/components/tools/SearchTool.svelte

@@ -30,6 +30,7 @@
             addToast('Failed to fetch environments', 'error');
         }
     }
+    // [/DEF:fetchEnvironments:Function]
 
     // [DEF:handleSearch:Function]
     // @PURPOSE: Triggers the SearchPlugin task.
@@ -56,6 +57,7 @@
             addToast(e.message, 'error');
         }
     }
+    // [/DEF:handleSearch:Function]
 
     // [DEF:startPolling:Function]
     // @PURPOSE: Polls for task completion and results.
@@ -84,6 +86,7 @@
             }
         }, 2000);
     }
+    // [/DEF:startPolling:Function]
 
     onMount(fetchEnvironments);
 </script>