docs: advise against parsing raw CLI output

[mintlify]

Adds a "Don't parse the raw CLI output" section to the Querying Kosli tutorial, advising readers to use exit codes or --output json rather than grepping human-readable output (e.g. COMPLIANT/NON-COMPLIANT/INCOMPLIANT). This avoids scripts silently breaking when wording is tweaked between CLI versions (context: internal discussion around kosli-dev/cli#970).

---

Generated by Mintlify Agent.

Requested by: [email protected] via Slack
Mintlify session: slack_1782312639.838479_C0AJTQ5633K

[claude]

Claude finished @mbevc1's task in 47s —— View job

---

PR Review: docs: advise against parsing raw CLI output

• Gather context and read changed files
• Review against CLAUDE.md conventions
• Post review findings

Findings

File: tutorials/querying_kosli.md (+11 lines, new section)

No issues found. This is a clean, well-placed addition:

• Navigation: Page already exists in config/navigation.json — no update needed (existing page, not a new one).
• Links: All internal links are root-relative (/getting_started/install, /client_reference/kosli_search, etc.) — correct per CLAUDE.md.
• Front matter: Present and well-formed.
• Writing style: Active voice, imperative mood, American spelling — all consistent with conventions.
• Structure: The new section fits naturally before the "What you've accomplished" wrap-up. The two bullet points (exit codes, structured output) give readers clear, actionable alternatives.
• Diataxis fit: Practical advice inside a tutorial — appropriate scope.

Note on latest commit (5dbca54): mbevc1's suggestion was applied, removing the INCOMPLIANT parenthetical. The closing sentence is now cleaner and avoids potential reader confusion about whether INCOMPLIANT was a typo.

Overall: solid, focused addition. No critical or improvement-level findings.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
kosli	🔴 Failed	–	Jun 24, 2026, 3:23 PM