amulecmd: expose search filters (type, extension, availability, size) - #542

Closes #395.

Motivation

amulecmd help search exposes only the three search modes (global, local, kad) plus a free-text query. The advanced filters the GUI uses (file type, extension, availability, min/max size) are already implemented end-to-end on the EC layer — CEC_Search_Tag accepts all of them, the GUI populates them, the daemon honors them — but the CLI was passing empty defaults, so CLI users have no way to narrow searches like the GUI can.

Change

src/TextClient.cpp:

• Add a small inline parser that extracts optional --type / --extension / --avail / --min-size / --max-size flags from the search arguments. Flags can appear before, after, or interleaved with the keyword(s); unrecognized tokens are joined as the search query.
• Wire the parsed values into the existing CEC_Search_Tag constructor instead of the previously-hardcoded empty defaults.
• Bump the local min_size / max_size types from uint32 to uint64 to match the EC tag — the previous code silently capped sizes at 4 GiB even though the wire protocol carries 64 bits.
• Fix a pre-existing typo (extention → extension) in the local variable shadowing the parameter name.

docs/man/amulecmd.1 and po/amule.pot: document the new flags.

Examples

amulecmd -P <pwd> -c "search global linux iso --type Iso --min-size 100M"
amulecmd -P <pwd> -c "search kad amule --extension iso"
amulecmd -P <pwd> -c "search global ubuntu --avail 20 --max-size 5G"

amulecmd help search prints the full filter syntax with examples.

Localization

Only the English man page is updated — the localized variants (amulecmd.de.1, .es.1, .fr.1, .hu.1, .it.1, .ro.1, .ru.1, .tr.1, .zh_TW.1) need follow-up translation work for the new section. Until that lands, users invoking man amulecmd under those locales won't see the new filter syntax in the manpage; the runtime help (amulecmd help search) is gettext-driven and falls back to English where translations are missing, so the CLI itself stays usable everywhere.

The new wxTRANSLATE-wrapped strings have been added to po/amule.pot. The per-language .po files are intentionally left alone — msgmerge will mark the new strings as untranslated on the next sync, which is the standard gettext flow.

Testing

Verified end-to-end on macOS 26.4 / Apple Silicon against a running aMule build of master, ed2k Global search via a connected server:

Sample entries from test 2 are all .iso filenames; sample entries from test 3 all show file sizes ≥ 500 MiB. Filters reach the daemon, are applied, and reduce the result set as expected.

Also verified:

• help search displays the new long-form documentation correctly.
• Filters before / after / interleaved with the keyword all work.
• Invalid inputs (missing keyword, missing flag value, bad size suffix) are rejected with a clear error and Type 'help search' to get more help.
• 64-bit sizes (e.g. --min-size 8G) flow through to the EC tag without truncation.

Compatibility

No API changes. Existing search global X / search local X / search kad X calls continue to work exactly as before — the new flags are purely additive and optional.