PSGO-1086: Document --cleanup-rename-conflicts flag for pull command

[Matovidlo]

Jira issue(s): PSGO-1086

Documents the new --cleanup-rename-conflicts flag added to the kbc pull command in keboola/keboola-as-code#2425. This flag handles rename conflicts during pull operations specifically for UI-only DevOps workflows.

Changes:

• Pull command documentation: Added --cleanup-rename-conflicts flag to options section with description and prominent warning about file deletion
• DevOps use cases: Added new "UI-Only Sync Workflow" section explaining when and how to use the flag, including:
  • Explanation of rename conflicts in chained rename scenarios (A→B, C→A)
  • Usage instructions for UI-only workflows
  • Clear warnings about when NOT to use this flag
  • Data loss warnings since conflicting files are permanently removed

---

Review focus areas:

• Technical accuracy: Verify the flag description matches actual implementation behavior from the source PR
• Warning prominence: Check if warnings about permanent file deletion are sufficiently clear and visible
• Use case boundaries: Ensure the distinction between UI-only vs Git-based workflows is clear
• Markdown rendering: Verify alert boxes and formatting render correctly on the actual documentation site

Key safety consideration: This flag enables destructive operations (removes conflicting files) so accuracy of warnings and use case descriptions is critical.

Link to Devin run: https://app.devin.ai/sessions/ee80f1cc32794834b1a6aa3961fa4608
Requested by: @Matovidlo

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[Copilot]

Pull Request Overview

This PR documents the new --cleanup-rename-conflicts flag for the kbc pull command to help users handle rename conflicts in UI-only DevOps workflows. The flag provides a solution for chained rename scenarios that occur when configurations are renamed through the Keboola UI interface.

• Added comprehensive documentation for the --cleanup-rename-conflicts flag with usage examples and safety warnings
• Created a new "UI-Only Sync Workflow" section explaining when and how to use the flag
• Included prominent warnings about permanent file deletion and clear guidance on when NOT to use the flag

Reviewed Changes

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

File	Description
cli/commands/sync/pull/index.md	Added flag documentation with description and warning alert box
cli/devops-use-cases/index.md	Added comprehensive use case section with examples and safety guidelines

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}