From bc0fa1ec73618fdb940831a8dcece9c745808dca Mon Sep 17 00:00:00 2001 From: Mark IJbema Date: Wed, 25 Feb 2026 09:08:35 +0100 Subject: [PATCH] docs(vscode): restore mermaid-diagram-features.md, clarify legacy repo references --- .../mermaid-diagram-features.md | 30 ++++++++++++++----- 1 file changed, 23 insertions(+), 7 deletions(-) diff --git a/packages/kilo-vscode/docs/chat-ui-features/mermaid-diagram-features.md b/packages/kilo-vscode/docs/chat-ui-features/mermaid-diagram-features.md index a95d60810df..ddbccc750ad 100644 --- a/packages/kilo-vscode/docs/chat-ui-features/mermaid-diagram-features.md +++ b/packages/kilo-vscode/docs/chat-ui-features/mermaid-diagram-features.md @@ -1,13 +1,29 @@ # Mermaid Diagram Features -**Priority:** P2 -**Status:** ❌ Not started +Interactive actions around Mermaid diagram rendering, error handling, and AI-assisted fixes. -## Remaining Work +## Location (kilocode-legacy) -- Mermaid diagram rendering in chat messages (currently renders as plain code blocks) -- "Fix with AI" button for mermaid syntax errors — needs to route through CLI +These components exist in the [kilocode-legacy](https://github.com/Kilo-Org/kilocode-legacy) repo, not in this extension: + +- `webview-ui/src/components/common/MermaidBlock.tsx` +- `webview-ui/src/components/common/MermaidButton.tsx` + +## Interactions + +- **"Fix with AI" button** - Auto-fixes mermaid syntax errors using AI (`MermaidSyntaxFixer`) - Copy button for diagram code - Click to open rendered diagram as PNG in editor -- Error display with original code -- Loading states during processing +- Error expansion with original code display +- Loading states during processing ("Fixing syntax...", "Loading...") +- Shows both fixed and original versions when syntax fix is applied + +## Suggested migration + +**Reimplement?** Mostly no for rendering; **yes/adapter work** for "Fix with AI". + +- Mermaid rendering/copy/open-PNG is a webview concern; keep the existing UI. +- The **"Fix with AI"** action currently relies on Kilo-side AI plumbing. With the agent runtime moving to Kilo CLI per [`docs/opencode-core/opencode-migration-plan.md`](docs/opencode-core/opencode-migration-plan.md:1), you likely need to re-route this button to: + - either a dedicated Kilo CLI prompt/tool that returns corrected Mermaid source, or + - a small Kilo-side helper that asks Kilo CLI to fix the snippet (so the button remains functional without the legacy Kilo orchestration loop). +- Kilo CLI UI doesn't appear to ship an equivalent Mermaid renderer/fixer (only a Mermaid file icon is present in [`packages/ui/src/components/file-icons/types.ts`](https://github.com/Kilo-Org/kilocode/blob/main/packages/ui/src/components/file-icons/types.ts:1)).