56 lines
1.9 KiB
YAML
56 lines
1.9 KiB
YAML
name: read_release_metadata
|
|
|
|
summary: >
|
|
Read the `.alfred/metadata.yaml` file for a release folder.
|
|
|
|
description: |
|
|
Returns whatever has been previously persisted by inspector tools
|
|
(analyze_release, probe_media, find_media_imdb_id) and by the subtitle
|
|
pipeline. Works for any folder — download or library — as long as the
|
|
release has been touched at least once. Missing metadata is not an
|
|
error: the tool returns `has_metadata=false` with an empty dict.
|
|
|
|
when_to_use: |
|
|
- Before re-running analyze_release / probe_media on a release you
|
|
might have already seen — saves a full re-inspection.
|
|
- To answer "what do we know about X?" without scanning.
|
|
- To list which releases in a library have no `.alfred` yet (loop +
|
|
`has_metadata`).
|
|
|
|
when_not_to_use: |
|
|
- To search a library by name — use query_library.
|
|
- When you need a fresh probe/parse — call the inspector directly,
|
|
the result will be persisted automatically.
|
|
|
|
next_steps: |
|
|
- If `has_metadata=false`, decide whether to inspect now
|
|
(analyze_release / probe_media).
|
|
- If `has_metadata=true`, read `metadata.parse`, `metadata.probe`,
|
|
`metadata.tmdb` blocks before deciding next actions.
|
|
|
|
cache:
|
|
key: release_path
|
|
|
|
parameters:
|
|
release_path:
|
|
description: Absolute path to the release folder (or any file inside it).
|
|
why_needed: |
|
|
The store lives at `<release_root>/.alfred/metadata.yaml`. A file
|
|
path is auto-resolved to its parent folder.
|
|
example: /mnt/library/tv_shows/Foundation.2021.1080p.WEBRip.x265-RARBG
|
|
|
|
returns:
|
|
ok:
|
|
description: Release inspected (file may or may not exist).
|
|
fields:
|
|
status: "'ok'"
|
|
release_path: Absolute path of the release folder.
|
|
has_metadata: True if `.alfred/metadata.yaml` exists.
|
|
metadata: Full content of the file, or empty dict.
|
|
|
|
error:
|
|
description: Path does not exist on disk.
|
|
fields:
|
|
error: Short error code (not_found).
|
|
message: Human-readable explanation.
|