feat: add find command for catalog search

.changes/unreleased/added-20260209-171617.yaml

@@ -0,0 +1,6 @@
+kind: added
+body: Add new 'fab find' command for searching the Fabric catalog across workspaces
+time: 2026-02-09T17:16:17.2056327+02:00
+custom:
+    Author: nschachter
+    AuthorLink: https://github.com/nschachter

MANIFEST.in

@@ -1,2 +1,3 @@
 include src/fabric_cli/core/fab_config/command_support.yaml
+include src/fabric_cli/commands/find/type_supported.yaml
 recursive-include src/fabric_cli/commands/fs/payloads *

docs/commands/find.md

@@ -0,0 +1,55 @@
+# `find` Command
+
+Search the Fabric catalog for items across all workspaces.
+
+**Usage:**
+
+```
+fab find <query> [-P <params>] [-l] [-q <query>]
+```
+
+**Parameters:**
+
+- `<query>`: Search text. Matches display name, description, and workspace name.
+- `-P, --params`: Filter parameters in `key=value` or `key!=value` format. Use brackets for multiple values: `type=[Lakehouse,Notebook]`. Use `!=` to exclude: `type!=Dashboard`.
+- `-l, --long`: Show detailed table with IDs (name, id, type, workspace, workspace_id, description). Optional.
+- `-q, --query`: JMESPath query to filter results client-side. Optional.
+
+**Examples:**
+
+```
+# search for items by name or description
+fab find 'sales report'
+
+# search for lakehouses only
+fab find 'data' -P type=Lakehouse
+
+# search for multiple item types (bracket syntax)
+fab find 'dashboard' -P type=[Report,SemanticModel]
+
+# exclude a type
+fab find 'data' -P type!=Dashboard
+
+# show detailed output with IDs
+fab find 'sales' -l
+
+# combine filters
+fab find 'finance' -P type=[Warehouse,Lakehouse] -l
+
+# project specific fields
+fab find 'data' -q "[].{name: name, workspace: workspace}"
+```
+
+**Behavior:**
+
+- In interactive mode (`fab` shell), results are paged 50 at a time with "Press Enter to continue..." prompts.
+- In command-line mode (`fab find ...`), all results are fetched in a single pass (up to 1000 per API call).
+- Type names are case-insensitive. `type=lakehouse` matches `Lakehouse`.
+- The `-q` JMESPath filter is applied client-side after results are returned from the API.
+
+**Supported filter parameters:**
+
+| Parameter | Description |
+|-----------|-------------|
+| `type`    | Filter by item type. Supports `eq` (default) and `ne` (`!=`) operators. |
+

pyproject.toml

@@ -49,6 +49,8 @@ package-data = { "fabric_cli.core.fab_config" = [
     "command_support.yaml",
 ], "fabric_cli.commands.fs" = [
     "payloads/*",
+], "fabric_cli.commands.find" = [
+    "type_supported.yaml",
 ] }
 
 [tool.mypy]

src/fabric_cli/client/fab_api_catalog.py

@@ -0,0 +1,47 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.
+
+"""Catalog API client for searching Fabric items across workspaces.
+
+API Reference: POST https://api.fabric.microsoft.com/v1/catalog/search
+Required Scope: Catalog.Read.All
+"""
+
+from argparse import Namespace
+
+from fabric_cli.client import fab_api_client as fabric_api
+from fabric_cli.client.fab_api_types import ApiResponse
+
+
+def search(args: Namespace, payload: dict) -> ApiResponse:
+    """Search the Fabric catalog for items.
+
+    https://learn.microsoft.com/en-us/rest/api/fabric/core/catalog/search
+
+    Args:
+        args: Namespace with request configuration
+        payload: Dict with search request body:
+            - search (required): Text to search across displayName, description, workspaceName
+            - pageSize: Number of results per page
+            - continuationToken: Token for pagination
+            - filter: OData filter string, e.g., "Type eq 'Report' or Type eq 'Lakehouse'"
+
+    Returns:
+        ApiResponse with search results containing:
+            - value: List of ItemCatalogEntry objects
+            - continuationToken: Token for next page (if more results exist)
+
+    Note:
+        The following item types are NOT searchable via this API:
+        Dashboard
+
+        Note: Dataflow Gen1 and Gen2 are currently not searchable; only Dataflow Gen2
+        CI/CD items are returned (as type 'Dataflow').
+        Scorecards are returned as type 'Report'.
+    """
+    args.uri = "catalog/search"
+    args.method = "post"
+    # raw_response=True so we handle pagination ourselves in fab_find
+    args.raw_response = True
+    return fabric_api.do_request(args, json=payload)
+

src/fabric_cli/commands/find/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) Microsoft Corporation.
+# Licensed under the MIT License.