Search and tags

[alxgsv]

Summary by CodeRabbit

• New Features
  • Added file search with text, phrase, date, size, image, tag, sorting, pagination, and JSON/table output options.
  • Added file tagging support for uploads and URL uploads with repeatable --tag flags.
  • Added tag management commands to list, replace, update, and clear file tags.
  • File information now displays tags and search highlights.
• Validation
  • Added validation and normalization for search criteria and tags, including trimming, lowercasing, deduplication, and limit checks.
• Documentation
  • Updated README and command help with file search and tag management guidance.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: be645d75-5b88-4176-a3fc-739f17def48d

📥 Commits

Reviewing files that changed from the base of the PR and between 6b3aed6 and 41fd44c.

⛔ Files ignored due to path filters (1)

• go.sum is excluded by !**/*.sum

📒 Files selected for processing (22)

• README.md
• go.mod
• internal/client/file.go
• internal/client/file_search_test.go
• internal/client/tag.go
• internal/cmd/file.go
• internal/cmd/file_search.go
• internal/cmd/file_search_test.go
• internal/cmd/file_test.go
• internal/cmd/file_upload.go
• internal/cmd/file_upload_from_url.go
• internal/cmd/file_upload_from_url_test.go
• internal/cmd/file_upload_test.go
• internal/cmd/helpers.go
• internal/cmd/root.go
• internal/cmd/schema.go
• internal/cmd/tag.go
• internal/cmd/tag_test.go
• internal/service/interfaces.go
• internal/validate/search.go
• internal/validate/tag.go
• internal/validate/tag_search_test.go

Included review availability: 4 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 5 reviews per hour.

---

Walkthrough

The CLI now supports file search, file tags, tag management, and tagged uploads. The service and client layers add search and tag contracts, SDK mappings, validation, pagination, dry-run output, and related documentation.

Changes

File Search and Tagging

Layer / File(s)	Summary
Search and tag contracts go.mod, internal/service/interfaces.go, internal/validate/*	Adds search and tag service models, interfaces, SDK-backed limits, search validation, and tag normalization.
SDK search and tag integration internal/client/file.go, internal/client/tag.go, internal/client/file_search_test.go	Maps search and tag operations through the SDK. Handles pagination termination. Preserves tags, highlights, and upload tags.
File search command internal/cmd/file.go, internal/cmd/file_search.go, internal/cmd/file_search_test.go, internal/cmd/file_test.go, internal/cmd/schema.go, README.md	Adds filter parsing, validation, single-page and streaming search, result formatting, schema metadata, tests, and search documentation.
Tag management commands internal/cmd/tag.go, internal/cmd/tag_test.go, internal/cmd/helpers.go, internal/cmd/root.go, internal/cmd/schema.go, README.md	Adds list, replace, update, and clear commands with service resolution, dry-run diffs, output formatting, tests, and documentation.
Tagged upload flows internal/cmd/file_upload.go, internal/cmd/file_upload_from_url.go, internal/cmd/file_upload_test.go, internal/cmd/file_upload_from_url_test.go	Adds repeatable tag flags, normalization, validation, upload propagation, dry-run rendering, and tests.

Estimated code review effort: 4 (Complex) | ~60 minutes

Merge Risk: ⚪ Minimal · up to 41fd4

The search and tag functionality is merge-ready after normal checks and review; no actionable merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 13.43% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 67 functions across 20 files. (2 skipped:…	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly identifies the two primary changes: file search and tag support. It is concise and related to the pull request changes.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

Docstring coverage is 13.43% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 67 functions across 20 files. (2 skipped: 2 unsupported.)

• Fix all pre-merge checks with AI

✨ Finishing Touches 💡 1

📝 Generate docstrings 💡

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feature/search

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

PR Build Artifacts

Commit	Build	Time (UTC)
41fd44c	Download	2026-08-26 09:21:42 UTC

Available platforms

• uploadcare-cli_0.2.0-SNAPSHOT-463debf_darwin_amd64.tar.gz
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_darwin_arm64.tar.gz
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_linux_amd64.tar.gz
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_linux_arm64.tar.gz
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_linux_armv7.tar.gz
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_windows_amd64.zip
• uploadcare-cli_0.2.0-SNAPSHOT-463debf_windows_arm64.zip

How to install

1. Click Download for the build you want
2. Download uploadcare-cli-binaries zip
3. Unzip it — you'll find per-platform archives inside
4. Extract the archive for your platform (e.g. tar xzf uploadcare-cli_*_darwin_arm64.tar.gz)
5. Run ./uploadcare