semantic update

frontend/src/components/storage/FileList.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:FileList:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: storage, files, list, table
 @PURPOSE:   Displays a table of files with metadata and actions.
-@LAYER:     Component
+@LAYER:     UI
 @RELATION:  DEPENDS_ON -> storageService
 
 @PROPS:     files (Array) - List of StoredFile objects.
@@ -22,10 +23,13 @@
   // [DEF:isDirectory:Function]
   /**
    * @purpose Checks if a file object represents a directory.
+   * @pre     file object has mime_type property.
+   * @post    Returns boolean.
    * @param   {Object} file - The file object to check.
    * @return  {boolean} True if it's a directory, false otherwise.
    */
   function isDirectory(file) {
+    console.log("[isDirectory][Action] Checking file type");
     return file.mime_type === 'directory';
   }
   // [/DEF:isDirectory:Function]
@@ -33,10 +37,13 @@
   // [DEF:formatSize:Function]
   /**
    * @purpose Formats file size in bytes into a human-readable string.
+   * @pre     bytes is a number.
+   * @post    Returns formatted string.
    * @param   {number} bytes - The size in bytes.
    * @return  {string} Formatted size (e.g., "1.2 MB").
    */
   function formatSize(bytes) {
+    console.log(`[formatSize][Action] Formatting ${bytes} bytes`);
     if (bytes === 0) return '0 B';
     const k = 1024;
     const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
@@ -48,10 +55,13 @@
   // [DEF:formatDate:Function]
   /**
    * @purpose Formats an ISO date string into a localized readable format.
+   * @pre     dateStr is a valid date string.
+   * @post    Returns localized string.
    * @param   {string} dateStr - The date string to format.
    * @return  {string} Localized date and time.
    */
   function formatDate(dateStr) {
+    console.log("[formatDate][Action] Formatting date string");
     return new Date(dateStr).toLocaleString();
   }
   // [/DEF:formatDate:Function]

frontend/src/components/storage/FileUpload.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:FileUpload:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: storage, upload, files
 @PURPOSE:   Provides a form for uploading files to a specific category.
-@LAYER:     Component
+@LAYER:     UI
 @RELATION:  DEPENDS_ON -> storageService
 
 @PROPS:     None

frontend/src/routes/admin/roles/+page.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:AdminRolesPage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: admin, role-management, rbac
 @PURPOSE:   UI for managing system roles and their permissions.
-@LAYER:     Feature
+@LAYER:     Domain
 @RELATION:  DEPENDS_ON -> frontend.src.services.adminService
 @RELATION:  DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
 
@@ -56,7 +57,13 @@
   // [/DEF:loadData:Function]
 
   // [DEF:openCreateModal:Function]
+  /**
+   * @purpose Initializes state for creating a new role.
+   * @pre     None.
+   * @post    showModal is true, roleForm is reset.
+   */
   function openCreateModal() {
+    console.log("[openCreateModal][Action] Opening create modal");
     isEditing = false;
     currentRoleId = null;
     roleForm = { name: '', description: '', permissions: [] };
@@ -65,7 +72,13 @@
   // [/DEF:openCreateModal:Function]
 
   // [DEF:openEditModal:Function]
+  /**
+   * @purpose Initializes state for editing an existing role.
+   * @pre     role object is provided.
+   * @post    showModal is true, roleForm is populated.
+   */
   function openEditModal(role) {
+    console.log(`[openEditModal][Action] Opening edit modal for role ${role.id}`);
     isEditing = true;
     currentRoleId = role.id;
     roleForm = {
@@ -80,6 +93,8 @@
   // [DEF:handleSaveRole:Function]
   /**
    * @purpose Submits role data (create or update).
+   * @pre     roleForm contains valid data.
+   * @post    Role is saved, modal closed, data reloaded.
    */
   async function handleSaveRole() {
     console.log('[AdminRolesPage][handleSaveRole][Entry]');
@@ -100,6 +115,11 @@
   // [/DEF:handleSaveRole:Function]
 
   // [DEF:handleDeleteRole:Function]
+  /**
+   * @purpose Deletes a role after confirmation.
+   * @pre     role object is provided.
+   * @post    Role is deleted if confirmed, data reloaded.
+   */
   async function handleDeleteRole(role) {
     if (!confirm($t.admin.roles.confirm_delete.replace('{name}', role.name))) return;
     

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

@@ -1,8 +1,9 @@
 <!-- [DEF:LoginPage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: login, auth, ui, form
 @PURPOSE:   Provides the user interface for local and ADFS authentication.
-@LAYER:     Feature
+@LAYER:     UI
 @RELATION:  USES -> authStore
 @RELATION:  CALLS -> api.auth.login
 

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

@@ -303,7 +303,7 @@
       />
     </div>
 
-    <!-- [DEF:DashboardSelectionSection] -->
+    <!-- [DEF:DashboardSelectionSection:Component] -->
     <div class="mb-8">
       <h2 class="text-lg font-medium mb-4">Select Dashboards</h2>
       
@@ -316,7 +316,7 @@
         <p class="text-gray-500 italic">Select a source environment to view dashboards.</p>
       {/if}
     </div>
-    <!-- [/DEF:DashboardSelectionSection] -->
+    <!-- [/DEF:DashboardSelectionSection:Component] -->
 
 
     <div class="flex items-center mb-4">

frontend/src/routes/tools/storage/+page.svelte

@@ -1,8 +1,9 @@
 <!-- [DEF:StoragePage:Component] -->
 <!--
+@TIER:      STANDARD
 @SEMANTICS: storage, files, management
 @PURPOSE:   Main page for file storage management.
-@LAYER:     Feature
+@LAYER:     UI
 @RELATION:  DEPENDS_ON -> storageService
 @RELATION:  CONTAINS -> FileList
 @RELATION:  CONTAINS -> FileUpload

frontend/src/services/adminService.js

@@ -1,5 +1,6 @@
 // [DEF:adminService:Module]
 //
+// @TIER:      STANDARD
 // @SEMANTICS: admin, users, roles, ad-mappings, api
 // @PURPOSE:   Service for Admin-related API calls (User and Role management).
 // @LAYER:     Service