aemdm 0.5.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -0
- package/dist/cli.js +11 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -109,6 +109,8 @@ aemdm search --text "hero" --json | jq -r '.hits.results[0].assetId'
|
|
|
109
109
|
|
|
110
110
|
Use `--skill` to print a concise guide that explains what the tool does, which commands to use, and how an LLM should choose between them.
|
|
111
111
|
|
|
112
|
+
The skill output now also includes explicit search guardrails for agents, including that full-text search uses `--text` and that `aemdm search` does not support a `--query` flag.
|
|
113
|
+
|
|
112
114
|
```bash
|
|
113
115
|
npx aemdm --skill
|
|
114
116
|
```
|
package/dist/cli.js
CHANGED
|
@@ -498,6 +498,7 @@ Asset URL examples:
|
|
|
498
498
|
|
|
499
499
|
Search examples:
|
|
500
500
|
- aemdm search --text "hero banner"
|
|
501
|
+
- aemdm search --text "hero images" --json
|
|
501
502
|
- aemdm search --where x:y=z
|
|
502
503
|
- aemdm search --where repositoryMetadata.dc:format=image/jpeg,image/png
|
|
503
504
|
- aemdm search --first-id --where x:y=z
|
|
@@ -507,6 +508,15 @@ Search examples:
|
|
|
507
508
|
- aemdm search --text "homepage" --first-metadata
|
|
508
509
|
- aemdm search --text "homepage" --first-binary --output ./first.bin
|
|
509
510
|
|
|
511
|
+
Search syntax guardrails:
|
|
512
|
+
- For full-text search, always use --text "<words>".
|
|
513
|
+
- There is no --query flag on aemdm search.
|
|
514
|
+
- Do not invent alternate flags like --query, -q, or a positional search string.
|
|
515
|
+
- The search inputs are: --text, --where, and --raw-query.
|
|
516
|
+
- If you are unsure which flags are valid, run aemdm search --help before guessing.
|
|
517
|
+
- Good example: aemdm search --text "hero images" --json
|
|
518
|
+
- Good example: aemdm search --text "hero" --first-url --format webp
|
|
519
|
+
|
|
510
520
|
Filter DSL:
|
|
511
521
|
- --where x:y=z maps to assetMetadata.x:y = ["z"]
|
|
512
522
|
- --where repositoryMetadata.dc:format=image/jpeg,image/png maps to an exact-match term filter with multiple values
|
|
@@ -518,6 +528,7 @@ Raw query escape hatch:
|
|
|
518
528
|
LLM usage guidance:
|
|
519
529
|
- Use asset get when you already know the asset ID.
|
|
520
530
|
- Use search when you need to discover an asset by metadata or text.
|
|
531
|
+
- For discovery from natural language, start with search --text, not a made-up flag.
|
|
521
532
|
- Prefer --first-id or --ids-only when another CLI call needs asset IDs.
|
|
522
533
|
- Prefer --first-url when the user wants a delivery URL from a search result.
|
|
523
534
|
--first-url uses the dc:format from the search hit to pick the correct route automatically.
|