feat(cli): add --meta flag to search command to include metadata in results

Add optional --meta/-m flag to the search command that retrieves and augments
matched results with asset metadata using the index get method. When enabled,
the flag fetches full asset details for each match and includes the metadata
field in the JSON output if available.

Author: titusz

iscc_search/cli/__init__.py

@@ -309,6 +309,7 @@ def get(
 def search(
     iscc_code,  # type: str
     limit=typer.Option(3, "--limit", "-l", help="Maximum number of results"),  # type: int
+    meta: bool = typer.Option(False, "--meta", "-m", help="Include metadata for matched results"),
 ):
     # type: (...) -> None
     """
@@ -318,7 +319,7 @@ def search(
 
     Example:
         iscc-search search ISCC:KECYCMZIOY36XXGZ7S6QJQ2AEEXPOVEHZYPK6GMSFLU3WF54UPZMTPY
-        iscc-search search ISCC:KEC... --limit 10
+        iscc-search search ISCC:KEC... --limit 10 --meta
     """
     from iscc_search.schema import IsccAsset
 
@@ -345,21 +346,35 @@ def search(
         results = index.search_assets("default", query, limit=int(limit))
         progress.remove_task(task)
 
+    # Build matches output
+    matches_output = []
+    for match in results.matches:
+        match_dict = {
+            "iscc_id": match.iscc_id,
+            "score": match.score,
+            "matches": match.matches,
+        }
+
+        # If --meta flag is set, retrieve and add metadata
+        if meta:
+            try:
+                asset = index.get_asset("default", match.iscc_id)
+                if asset.metadata:
+                    match_dict["metadata"] = asset.metadata
+            except FileNotFoundError:
+                # Asset not found, skip metadata
+                pass
+
+        matches_output.append(match_dict)
+
     # Close index
     index.close()
 
     # Output as JSON
     output = {
         "query": {"iscc_code": results.query.iscc_code, "units": results.query.units},
         "metric": results.metric,
-        "matches": [
-            {
-                "iscc_id": match.iscc_id,
-                "score": match.score,
-                "matches": match.matches,
-            }
-            for match in results.matches
-        ],
+        "matches": matches_output,
     }
 
     console.print_json(json.dumps(output))