[mwbrooks]

Changelog

When a coding agent runs slack docs search, text results now link to the markdown version of each page, so the agent can read it without parsing HTML.

Summary

This pull request links slack docs search results to each page's markdown version when a coding agent runs the command, so the agent can read the result straight away instead of fetching the HTML page.

$ slack docs search "socket mode" --limit=1
...
Socket Mode
   https://docs.slack.dev/tools/java-slack-sdk/guides/socket-mode.md

• Every docs.slack.dev page is served as markdown at its path plus .md. Agents are detected with the same useragent check the CLI already uses for its user agent.
• People running the command get the usual page links, unchanged.
• Generated SDK reference pages ending in .html have no markdown version, so they keep their original link.

Testing

• From a coding agent, or with CLAUDECODE=1, run slack docs search "socket mode" --limit=3 and confirm each link ends in .md and opens as markdown.
• Without an agent (env -u CLAUDECODE -u AGENT slack docs search "socket mode" --limit=3), confirm the links are the usual page URLs.

Notes

• JSON output is unchanged, to keep it a stable copy of the search API response.
• Follows docs: describe the docs command as search in help text #754. Part of a few small changes to get coding agents using slack docs.

Requirements

• I've read and understood the Contributing Guidelines and have done my best effort to follow them.
• I've read and agree to the Code of Conduct.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.46%. Comparing base (19c588c) to head (12448e8).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #755      +/-   ##
==========================================
+ Coverage   78.41%   78.46%   +0.05%     
==========================================
  Files         240      240              
  Lines       18179    18193      +14     
==========================================
+ Hits        14255    14276      +21     
+ Misses       3924     3917       -7     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[zimeg]

📚 @mwbrooks LGTM! Linking agents straight to the markdown pages is a great nudge, and keeping the .html reference pages and JSON output as they are makes sense to me.

[zimeg]

🧹 quibble: I think our test ordering keeps the command test first, so perhaps this can move below Test_Docs_SearchCommand?

[mwbrooks]

Applied in 12448e8, thanks! 🙇

[mwbrooks]

Thanks @zimeg for the quick review! 🙇