refactor: make markdown generation idiomatic

- Re-namespace the markdown generation task, from `docs:markdown`, to
  `docs:generate:markdown`, so it's clearer what it's doing.
  This could be folded into the `docs:generate` task as an option, but
  we can tackle that separately if we find it's more ergonomic.
- Call `docs:generate` if the XML doesn't yet exist, instead of nagging
  the user to do it. Make the computer do the work, not the user.
- Hide xml-to-markdown.py from `mise tasks` output, because it's
  internal implementation that users shouldn't be calling directly.
- Ensure Python is installed, so xml-to-markdown.py works out of the box

Author: auxesis

mise.toml

@@ -11,7 +11,7 @@
 "rust" = { version = "latest", components = "rustc,rust-std,cargo,rustfmt,rust-docs,clippy" }
 "cargo:cargo-binstall" = "latest"
 "cargo:sqlx-cli" = "latest"
-
+"python" = "latest"
 
 [task_config]
 includes = ["tasks", "tasks/postgres.toml"]
@@ -55,21 +55,3 @@ dir = "{{config_root}}/tests/sqlx"
 run = """
 cargo watch -x test
 """
-
-[tasks."docs:markdown"]
-description = "Generate Markdown from XML documentation"
-run = """
-  echo "Converting XML to Markdown..."
-
-  # Ensure XML exists
-  if [ ! -d "docs/api/xml" ]; then
-    echo "Error: XML documentation not found. Run 'mise run docs:generate' first."
-    exit 1
-  fi
-
-  # Run converter
-  python3 tasks/xml-to-markdown.py docs/api/xml docs/api/markdown
-
-  echo ""
-  echo "✓ Markdown documentation: docs/api/markdown/API.md"
-"""

tasks/docs/generate/markdown.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+#MISE description="Generate Markdown from XML documentation"
+
+echo "Converting XML to Markdown..."
+
+# Ensure XML exists
+if [ ! -d "docs/api/xml" ]; then
+  echo "warning: XML documentation not found"
+  echo "Generating XML documentation..."
+  mise run --output prefix docs:generate
+fi
+
+# Run converter
+mise run --output prefix docs:generate:xml-to-markdown docs/api/xml docs/api/markdown
+
+echo ""
+echo "✓ Markdown documentation: docs/api/markdown/API.md"

tasks/xml-to-markdown.py renamed to tasks/docs/generate/xml-to-markdown.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+#MISE hide=true
 """
 Simple Doxygen XML to Markdown converter for SQL function documentation.