feat: add --mintlify flag to kosli docs command

[dangrondahl]

Summary

• Adds --mintlify flag to kosli docs command to generate Mintlify-compatible MDX documentation directly from the CLI
• Introduces new internal/docgen package with a Formatter interface, implemented by HugoFormatter (existing behavior) and MintlifyFormatter (new)
• Converts bare https://docs.kosli.com/path URLs in flag descriptions to clickable [docs](/path) markdown links in Mintlify output
• Hugo output remains unchanged (backward compatible)

Details

New package internal/docgen/ extracts doc generation logic from cmd/kosli/docs.go into a clean architecture:

• Formatter interface with Hugo and Mintlify implementations
• CommandMetaFunc callback bridges cmd/kosli (isBeta/isDeprecated) with docgen
• LiveDocProvider interface abstracts HTTP calls for live doc examples
• Shared helpers (CommandsInTable, RenderFlagsTables, etc.) moved from cmd/kosli

Mintlify-specific features:

• Front matter uses description: (sanitized, truncated) instead of summary:
• <Warning>, <Tabs>/<Tab>, <AccordionGroup>/<Accordion> components instead of Hugo shortcodes
• JSX escaping for {expr} and <WORD> patterns outside code fences
• No h1 title (Mintlify renders from front matter)
• Relative doc URLs converted to clickable markdown links

Test plan

• go test ./internal/docgen/... — all new unit tests pass
• go test ./cmd/kosli/... -run TestDocsCommandTestSuite — Hugo golden file unchanged
• Mintlify golden file tests for snyk and deprecated artifact commands
• Generated full CLI reference (92 pages) and verified in Mintlify docs repo
• Compared Hugo output against existing docs.kosli.com content (identical except machine-local paths)

Closes #662

[dangrondahl]

Tests

Current Hugo docs

I have tested and compared the creation of Hugo CLI docs. By first running make cli-doc on main and then

mkdir tmp
DOCS=true go run ./cmd/kosli docs --dir tmp

On the feature branch. All files are identical

Mintlify

In the docs repo I ran:

DOCS=true go run <path to cli repo>/cmd/kosli docs --dir mintlify --mintlify

on a path that was covered by docs.json

All files looks correct.

[Copilot]

Pull request overview

This pull request adds a --mintlify flag to the kosli docs command to generate Mintlify-compatible MDX documentation alongside the existing Hugo markdown format. The implementation introduces a new internal/docgen package that extracts and refactors the documentation generation logic into a clean, interface-based architecture.

Changes:

• Introduces internal/docgen package with Formatter interface implemented by HugoFormatter and MintlifyFormatter
• Converts bare https://docs.kosli.com/path URLs in flag descriptions to clickable markdown links in Mintlify output
• Refactors existing Hugo documentation generation to use the new architecture while maintaining backward compatibility

Reviewed changes

Copilot reviewed 15 out of 17 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
internal/docgen/formatter.go	Defines Formatter interface and related types (CommandMeta, CIExample, LiveDocProvider)
internal/docgen/hugo.go	Hugo formatter implementation (extracted from cmd/kosli/docs.go)
internal/docgen/mintlify.go	New Mintlify formatter with MDX components and JSX escaping
internal/docgen/helpers.go	Shared helper functions (CommandsInTable, HashTitledExamples, etc.) moved from cmd/kosli
internal/docgen/generate.go	Main generation logic using the Formatter interface
internal/docgen/*_test.go	Comprehensive unit tests for formatters and helpers
cmd/kosli/docs.go	Refactored to use internal/docgen package with new --mintlify flag
cmd/kosli/docs_test.go	Updated tests with new golden file paths and Mintlify test cases
cmd/kosli/testdata/output/docs/hugo/*	Hugo golden files for testing (relocated from previous path)
cmd/kosli/testdata/output/docs/mintlify/*	New Mintlify golden files for testing
cmd/kosli/printCommandsInTable.go	Removed (functionality moved to internal/docgen/helpers.go with modernization)

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.