feat(youtube): add search command

[BRO3886]

The gog youtube command group currently supports activities, channels, comments, playlists, and videos, but is missing a search subcommand.

The YouTube Data API v3 has a search.list endpoint that allows searching for videos, channels, and playlists by query string with filters like type, sort order, and channel restriction.

Proposed: gog youtube search ls <query> with --type, --order, --channel-id, --max, --page flags. Should support both OAuth and API key auth paths, and follow existing table/JSON output patterns.

PR: #650

[clawsweeper]

Codex review: keeping this open for maintainer follow-up; there is still a little grit to resolve. Reviewed May 28, 2026, 3:34 AM ET / 07:34 UTC.

Summary
Keep open: current main does not yet include the requested YouTube search command, and this issue is paired with the same-author open implementation PR at #650.

Reproducibility: not applicable. this is a feature request, and source/doc inspection confirms the requested subcommand is absent from current main.

Ways to help us reproduce this

• Add a screenshot or short recording showing the behavior.
• Add expected vs actual behavior.
• Share version, platform, channel/provider, and relevant config details.

Next step
A same-author open PR already implements the requested command, so the next action is review/land or close that PR rather than spawning a separate fix branch.

Review details

Best possible solution:

Review the paired PR and land it if its API-key/OAuth behavior, output shape, docs, tests, and live Google proof meet the repository merge bar.

Do we have a high-confidence way to reproduce the issue?

Not applicable: this is a feature request, and source/doc inspection confirms the requested subcommand is absent from current main.

Is this the best way to solve the issue?

Unclear until the paired PR is reviewed: adding a small primitive under the existing YouTube command group fits the request, but the implementation still needs normal review and proof handling.

AGENTS.md: found and applied where relevant.

Remaining risk / open question:

• The paired PR is still open, so this issue should not be treated as implemented until that PR lands or another implementation merges.

Codex review notes: model gpt-5.5, reasoning high; reviewed against 9987f8b2f053.

Label changes

Label changes:

• add P2: This is a bounded feature request in an existing YouTube command group with an open implementation PR.
• add impact:other: The missing command affects CLI coverage for a supported YouTube API surface rather than auth, state, delivery, or security.
• add issue-rating: 🌊 off-meta tidepool: Current issue advisory state selects this label.

Label justifications:

• P2: This is a bounded feature request in an existing YouTube command group with an open implementation PR.
• impact:other: The missing command affects CLI coverage for a supported YouTube API surface rather than auth, state, delivery, or security.

Evidence reviewed

What I checked:

• Repository policy read: AGENTS.md was read fully; its parseable-output guidance matches the requested table/JSON behavior, and its PR-link guidance supports reviewing the paired PR without branch switching. (AGENTS.md:1, 9987f8b2f053)
• Current YouTube command surface: The YouTube command group exposes activities, videos, playlists, comments, and channels, with no Search field or search subcommand on current main. (internal/cmd/youtube.go:15, 9987f8b2f053)
• Generated docs lack search: The generated gog youtube docs list activities, channels, comments, playlists, and videos only. (docs/commands/gog-youtube.md:17, 9987f8b2f053)
• Supported area evidence: README documents YouTube as an existing supported CLI area with API-key reads and OAuth-backed authenticated reads. (README.md:309, 9987f8b2f053)
• History provenance: The existing YouTube command group was introduced with the v0.19.0 release commit, which is the relevant ownership trail for this command surface. (internal/cmd/youtube.go:15, b25a3c029b37)
• Vision fit: VISION.md allows small, useful primitives in already supported areas and expects live Google proof when live API behavior is the point. (VISION.md:7, 9987f8b2f053)

Likely related people:

• steipete: The current YouTube command group, helper paths, tests, and generated docs all trace to commit b25a3c0, authored by Peter Steinberger; the repository identity maps this area to steipete. (role: introduced behavior; confidence: high; commits: b25a3c029b37; files: internal/cmd/youtube.go, internal/cmd/youtube_services.go, internal/googleapi/youtube.go)

How this review workflow works

• ClawSweeper keeps one durable marker-backed review comment per issue or PR.
• Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
• A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
• PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
• Maintainers can also comment @clawsweeper review to request a fresh review only.
• Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
• Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
• Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

[BRO3886]

Implemented in #650