feat: add find command for catalog search

[nadavs123]

📥 Pull Request

Closes #172

Summary

Adds a new find command that searches for Fabric items across all accessible workspaces using the Catalog Search API (POST /v1/catalog/search).

Usage

# Basic search
fab find "sales report"

# Filter by item type(s)
fab find "data" --type Lakehouse
fab find "monthly" --type Report Warehouse

# Limit results
fab find "dashboard" --max-items 10

# Detailed view (shows IDs for scripting)
fab find "sales" -l

# Pagination
fab find --next-token "eyJTa2lwIjoy..."

Flags

Flag	Description
--type	Filter by item type(s), space-separated
--max-items	Maximum results per page (1-1000)
-l/--long	Show detailed output with IDs
--next-token	Continuation token for next page

Implementation details

• Follows existing CLI patterns: @fab_command decorator, print_output_format(), FabricCLIError
• Tab-completion for --type via argcomplete
• --max-items validation (1-1000)
• Structured error handling for unsupported/unknown types, missing query, API failures
• Description column hidden in compact mode when no items have descriptions
• Empty fields hidden in long (-l) mode
• Pagination via --next-token (continuation token approach)

Files added

• src/fabric_cli/client/fab_api_catalog.py — API client
• src/fabric_cli/commands/find/__init__.py — Package init
• src/fabric_cli/commands/find/fab_find.py — Command logic
• src/fabric_cli/parsers/fab_find_parser.py — Argument parser
• tests/test_commands/find/__init__.py — Test package init
• tests/test_commands/find/test_find.py — 22 unit tests
• .changes/unreleased/added-20260209-171617.yaml — Changie entry

Files modified

• src/fabric_cli/core/fab_parser_setup.py — Register find parser

Notes

• Dashboard is the only unsupported item type
• Dataflow Gen1/Gen2 are currently not searchable; only Dataflow Gen2 CI/CD is returned (as type Dataflow)
• Scorecards are returned as type Report
• Requires Catalog.Read.All scope (not yet added to CLI app registration)