feat: add elastic docs commands (search, ask, chat, read)

[Mpdreamz]

Reimplementation of #1

Add four subcommands under elastic docs for interacting with the
Elastic documentation directly from the CLI. No Elasticsearch context or
API key is required — these commands use the public elastic.co docs APIs.

elastic docs [command]

Available Commands:
  search   Search Elastic documentation
  ask      Ask a question about Elastic documentation using AI
  chat     Ask with interactive follow-up conversation
  read     Read an Elastic documentation page

elastic docs search <query>

Search results rendered as styled markdown — title, product, URL, and
AI summary. Defaults to 5 results.

elastic docs search "ingest pipelines"
elastic docs search "machine learning" --size 10
elastic docs search "ingest pipelines" --json

elastic docs ask <question>

Single-shot AI answer with live spinner phases (Thinking → Searching → Generating).
Paragraphs are rendered incrementally as they complete via paragraph-aware buffering.

elastic docs ask "What is Elasticsearch?"

elastic docs chat <question>

Same as ask but loops for follow-up questions; shares a conversationId
so the AI retains context across the conversation.

elastic docs chat "How do ingest pipelines work?"

elastic docs read <path|url|query>

Fetch any Elastic docs page rendered with colours and formatting.
Accepts a docs path, a full elastic.co URL, or a free-text query
(searches and reads the first result). Use --raw for unrendered markdown.

elastic docs read /reference/elasticsearch
elastic docs read "ingest pipelines"
elastic docs read https://www.elastic.co/docs/reference/elasticsearch --raw

Implementation details

• src/docs/client.ts — fetch-based client for the search, read, and
  ask-ai SSE endpoints. SSE parsing uses a line buffer that persists across
  HTTP body chunks so split data: lines never produce malformed JSON and
  silently drop content.
• src/docs/stream.ts — paragraph-buffering streamer: accumulates chunks,
  only flushes at `-fence-aware \n\n boundaries, strips <!--REFERENCES-->
  silently, surfaces real API phases (Searching / Generating answer) via the spinner.
• marked + marked-terminal for terminal markdown rendering. A blank
  cli-highlight theme prevents per-token syntax colours from conflicting
  with terminal themes.
• src/factory.ts — adds optional positionalArg to CommandConfig /
  ParsedResult so commands can declare a single positional argument.
  All four docs commands use this (elastic docs search <query>, etc.).
• Config loading is skipped in preAction for docs subcommands — no
  Elasticsearch credentials needed.

[JoshMock]

Some thoughts before we merge this. Just want to make sure we're sticking to the agent-first philosophy as much as possible.

[github-actions]

✅MegaLinter analysis: Success

Descriptor	Linter	Files	Fixed	Errors	Warnings	Elapsed time
✅ COPYPASTE	jscpd	yes		no	no	3.2s
✅ REPOSITORY	gitleaks	yes		no	no	8.09s
✅ REPOSITORY	git_diff	yes		no	no	0.02s
✅ REPOSITORY	secretlint	yes		no	no	1.88s
✅ REPOSITORY	trivy	yes		no	no	11.22s

See detailed reports in MegaLinter artifacts
Set VALIDATE_ALL_CODEBASE: true in mega-linter.yml to validate all sources, not only the diff

MegaLinter is graciously provided by OX Security
Show us your support by starring ⭐ the repository

[JoshMock]

👏