style: add visual divider between folders and items in workspace listing

.changes/unreleased/optimization-20260203-163440.yaml

@@ -0,0 +1,6 @@
+kind: optimization
+body: Add visual divider between folders and items in `ls` command on workspaces with text output format
+time: 2026-02-03T16:34:40.477661885Z
+custom:
+    Author: ayeshurun
+    AuthorLink: https://github.com/ayeshurun

.github/workflows/create-release.yml

@@ -4,12 +4,12 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: "The version to release (e.g., v1.2.0)"
+        description: 'The version to release (e.g., v1.2.0)'
         required: true
       commit_sha:
-        description: "Optional: Commit SHA to create the tag on. If not provided, the tag will be created on the latest commit of the current branch (HEAD)"
+        description: 'Optional: Commit SHA to create the tag on. If not provided, the tag will be created on the latest commit of the current branch (HEAD)'
         required: false
-        default: ""
+        default: ''
 
 jobs:
   create-release:
@@ -20,7 +20,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
-          fetch-depth: 0 # Required to access full commit history for validation
+          fetch-depth: 0  # Required to access full commit history for validation
 
       - name: Display workflow information
         run: |
@@ -65,22 +65,22 @@ jobs:
         run: |
           VERSION="${{ github.event.inputs.version }}"
           COMMIT_SHA="${{ github.event.inputs.commit_sha }}"
-
+          
           # Use provided commit SHA or default to HEAD
           if [ -n "$COMMIT_SHA" ]; then
             TARGET_COMMIT="$COMMIT_SHA"
           else
             TARGET_COMMIT="HEAD"
           fi
-
+          
           echo "tag_name=$VERSION" >> $GITHUB_OUTPUT
           echo "changelog_file_path=.changes/${VERSION}.md" >> $GITHUB_OUTPUT
           echo "target_commit=$TARGET_COMMIT" >> $GITHUB_OUTPUT
-
+          
           # Get the actual commit SHA for display
           ACTUAL_SHA=$(git rev-parse "$TARGET_COMMIT")
           echo "actual_sha=$ACTUAL_SHA" >> $GITHUB_OUTPUT
-
+          
           echo "✅ Release variables set:"
           echo "  - Tag name: $VERSION"
           echo "  - Target commit: $ACTUAL_SHA"

src/fabric_cli/commands/fs/ls/fab_fs_ls_item.py

@@ -10,12 +10,68 @@
 from fabric_cli.utils import fab_cmd_fs_utils as utils_fs
 from fabric_cli.utils import fab_cmd_ls_utils as utils_ls
 
+# Divider used to separate folders and items in workspace listings
+_DIVIDER = "------------------------------"
+
+
+def _sort_ws_elements_with_seperation(
+    ws_elements: list[Union[Item, Folder]], show_details: bool
+) -> list[dict]:
+    """
+    Groups elements by type (Folders first, then Items), sorts each group using sort_ws_elements,
+    and inserts a divider between non-empty groups.
+
+    Args:
+        ws_elements: List of workspace elements (Items and Folders)
+        show_details: Whether to include detailed columns
+
+    Returns:
+        list: Single list with folders first, divider, then items
+    """
+    if not ws_elements:
+        return []
+
+    result = []
+    first_group = True
+    type_order = [Folder, Item]
+
+    for typ in type_order:
+        group = [el for el in ws_elements if isinstance(el, typ)]
+        if group:
+            group_dicts = utils_fs.sort_ws_elements(group, show_details)
+            if not first_group:
+                divider = {"name": _DIVIDER}
+                if show_details:
+                    divider["id"] = ""
+                result.append(divider)
+            result.extend(group_dicts)
+            first_group = False
+
+    return result
+
 
 def exec(workspace: Workspace, args):
     show_details = bool(args.long)
     show_all = bool(args.all)
     ws_elements: list[Union[Item, Folder]] = utils_fs.get_ws_elements(workspace)
-    sorted_elements_dict = utils_fs.sort_ws_elements(ws_elements, show_details)
+
+    # Check if folder listing is enabled
+    folder_listing_enabled = (
+        fab_state_config.get_config(fab_constant.FAB_FOLDER_LISTING_ENABLED) == "true"
+    )
+
+    # Get output format from args or config
+    output_format = getattr(args, "output_format", None) or fab_state_config.get_config(
+        fab_constant.FAB_OUTPUT_FORMAT
+    )
+
+    # Use separation if folder listing is enabled, output is text format, and --long is not provided
+    if folder_listing_enabled and output_format == "text" and not show_details:
+        sorted_elements_dict = _sort_ws_elements_with_seperation(
+            ws_elements, show_details
+        )
+    else:
+        sorted_elements_dict = utils_fs.sort_ws_elements(ws_elements, show_details)
 
     show_hidden = (
         show_all or fab_state_config.get_config(fab_constant.FAB_SHOW_HIDDEN) == "true"

tests/test_commands/recordings/test_commands/test_ls/class_setup.yaml

@@ -11,7 +11,7 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
     uri: https://api.fabric.microsoft.com/v1/workspaces
   response:
@@ -26,15 +26,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '1517'
+      - '2096'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:28:59 GMT
+      - Tue, 06 Jan 2026 13:09:57 GMT
       Pragma:
       - no-cache
       RequestId:
-      - a1ca655d-adf4-4a7a-8d2c-2dc3ab03e53b
+      - 0ec0d210-30ae-4090-85e2-325c932f8c3a
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -60,7 +60,7 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
     uri: https://api.fabric.microsoft.com/v1/workspaces
   response:
@@ -75,15 +75,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '1517'
+      - '2096'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:29:00 GMT
+      - Tue, 06 Jan 2026 13:09:57 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 4fb405d9-466a-4e9d-81f3-a61091331c8a
+      - b8741740-c7ed-4a13-9a48-3e7e9433efa2
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -109,13 +109,13 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
     uri: https://api.fabric.microsoft.com/v1/capacities
   response:
     body:
       string: '{"value": [{"id": "00000000-0000-0000-0000-000000000004", "displayName":
-        "mocked_fabriccli_capacity_name", "sku": "F2", "region": "Central US", "state":
+        "mocked_fabriccli_capacity_name", "sku": "F32", "region": "Central US", "state":
         "Active"}]}'
     headers:
       Access-Control-Expose-Headers:
@@ -125,15 +125,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '271'
+      - '425'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:29:05 GMT
+      - Tue, 06 Jan 2026 13:10:01 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 9a962d92-07ed-4680-97dc-c07909f25e22
+      - 47895aad-73fd-49c2-b5f1-6242b5c9b3d8
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -162,12 +162,12 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: POST
     uri: https://api.fabric.microsoft.com/v1/workspaces
   response:
     body:
-      string: '{"id": "7b82ecee-ed54-4d87-84dd-07511c5f5ad2", "displayName": "fabriccli_WorkspacePerTestclass_000001",
+      string: '{"id": "b86e9b69-16a9-4078-aff8-922ba052431e", "displayName": "fabriccli_WorkspacePerTestclass_000001",
         "description": "Created by fab", "type": "Workspace", "capacityId": "00000000-0000-0000-0000-000000000004"}'
     headers:
       Access-Control-Expose-Headers:
@@ -177,17 +177,17 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '189'
+      - '188'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:29:14 GMT
+      - Tue, 06 Jan 2026 13:10:08 GMT
       Location:
-      - https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2
+      - https://api.fabric.microsoft.com/v1/workspaces/b86e9b69-16a9-4078-aff8-922ba052431e
       Pragma:
       - no-cache
       RequestId:
-      - a9920ffb-8339-43a8-8f5b-ab313cafb507
+      - 4611b486-ee97-401f-bc7f-d686e34ee3b1
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -213,13 +213,13 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (ls; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
     uri: https://api.fabric.microsoft.com/v1/workspaces
   response:
     body:
       string: '{"value": [{"id": "3634a139-2c9e-4205-910b-3b089a31be47", "displayName":
-        "My workspace", "description": "", "type": "Personal"}, {"id": "7b82ecee-ed54-4d87-84dd-07511c5f5ad2",
+        "My workspace", "description": "", "type": "Personal"}, {"id": "b86e9b69-16a9-4078-aff8-922ba052431e",
         "displayName": "fabriccli_WorkspacePerTestclass_000001", "description": "Created
         by fab", "type": "Workspace", "capacityId": "00000000-0000-0000-0000-000000000004"}]}'
     headers:
@@ -230,15 +230,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '1551'
+      - '2130'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:29:43 GMT
+      - Tue, 06 Jan 2026 13:10:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 760e6315-8597-44fc-807f-62840e999e08
+      - 8a1402e0-38c2-4bb2-89d0-eb8582dbd688
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -264,14 +264,12 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (ls; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: GET
-    uri: https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2/items
+    uri: https://api.fabric.microsoft.com/v1/workspaces/b86e9b69-16a9-4078-aff8-922ba052431e/items
   response:
     body:
-      string: '{"value": [{"id": "2d69f214-7721-41c3-a595-1ac4960a7215", "type": "Notebook",
-        "displayName": "fabcli000001", "description": "Created by fab", "workspaceId":
-        "7b82ecee-ed54-4d87-84dd-07511c5f5ad2"}]}'
+      string: '{"value": []}'
     headers:
       Access-Control-Expose-Headers:
       - RequestId
@@ -280,15 +278,15 @@ interactions:
       Content-Encoding:
       - gzip
       Content-Length:
-      - '176'
+      - '32'
       Content-Type:
       - application/json; charset=utf-8
       Date:
-      - Sun, 16 Nov 2025 13:29:44 GMT
+      - Tue, 06 Jan 2026 13:10:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 8f711d74-2ab1-4d92-9c00-f90f31843fe1
+      - 60a90680-1baf-41a3-b15e-9be0bad4932d
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options:
@@ -316,9 +314,9 @@ interactions:
       Content-Type:
       - application/json
       User-Agent:
-      - ms-fabric-cli/1.1.0 (None; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
+      - ms-fabric-cli/1.3.1 (ls; Linux; x86_64; 6.6.87.2-microsoft-standard-WSL2)
     method: DELETE
-    uri: https://api.fabric.microsoft.com/v1/workspaces/7b82ecee-ed54-4d87-84dd-07511c5f5ad2
+    uri: https://api.fabric.microsoft.com/v1/workspaces/b86e9b69-16a9-4078-aff8-922ba052431e
   response:
     body:
       string: ''
@@ -334,11 +332,11 @@ interactions:
       Content-Type:
       - application/octet-stream
       Date:
-      - Sun, 16 Nov 2025 13:29:45 GMT
+      - Tue, 06 Jan 2026 13:10:51 GMT
       Pragma:
       - no-cache
       RequestId:
-      - 87dce47d-17c3-48d7-8046-89b2600e75b1
+      - 4a7ae808-9baa-4b36-9657-a1ea8f286ae3
       Strict-Transport-Security:
       - max-age=31536000; includeSubDomains
       X-Content-Type-Options: