release: v0.6.0 — Agent Orchestration + UI Improvements

.gitattributes

@@ -0,0 +1,3 @@
+# Force LF line endings for YAML files in workflows
+.github/workflows/**/*.yml text eol=lf
+.github/workflows/**/*.yaml text eol=lf

.github/copilot-instructions.md

@@ -1,131 +1,22 @@
-# Gerado por letra flow move. Nao edite manualmente.
-
-### ⚠ ATENÇÃO: 2 problema(s) grave(s) detectado(s) pelo diagnóstico automático
-Execute `letra health` para detalhes e `letra health ack <id>` para reconhecer.
-# Letra Session — letra
-
-PASSO OBRIGATÓRIO #1: letra pulse — verificar estado do workspace
-PASSO OBRIGATÓRIO #2: Leia .letra/context.md — contexto completo do projeto
-PASSO OBRIGATÓRIO #3: Leia .letra/focus.md — foco e outcome da sessão
-PASSO OBRIGATÓRIO #4: Leia .letra/specs/write-sync/spec.md — ACs do item
-
-## Foco Atual
-
-Item: ITEM-1 · Branding: header Letra no flow serve + 3 opções de logo
-Spec: write-sync
-Estágio: Done
-
-## Alertas
-
-Alerta · severidade baixa
-  ID: hr-4652f8f0
-  O que: AC "flow diff" marcado [ ] mas implementado
-  Onde: ac-stale
-  Desde: 17/06/2026, 14:13:59
-  Ação: `letra health ack hr-4652f8f0`
-
-Alerta · severidade baixa
-  ID: hr-4103b765
-  O que: AC "flow visualize" marcado [ ] mas implementado
-  Onde: ac-stale
-  Desde: 17/06/2026, 14:13:59
-  Ação: `letra health ack hr-4103b765`
-
-Alerta · severidade baixa
-  ID: hr-dd77601
-  O que: AC "flow export" marcado [ ] mas implementado
-  Onde: ac-stale
-  Desde: 17/06/2026, 14:13:59
-  Ação: `letra health ack hr-dd77601`
-
-Alerta · severidade baixa
-  ID: hr-6380dc9e
-  O que: AC "GET /" marcado [ ] mas implementado
-  Onde: ac-stale
-  Desde: 17/06/2026, 14:13:59
-  Ação: `letra health ack hr-6380dc9e`
-
-Alerta · severidade baixa
-  ID: hr-352219f2
-  O que: AC "letra sitrep" marcado [ ] mas implementado
-  Onde: ac-stale
-  Desde: 17/06/2026, 14:13:59
-  Ação: `letra health ack hr-352219f2`
-
-  e mais 3 alertas
-
-## Regras (Violação = Erro Grave)
-
-**Violação = Erro Grave**
-
-- Não edite workflow.json manualmente — use `letra flow` e `letra focus`
-- Não crie specs fora de .letra/specs/ — use `letra spec new`
-- Não pule os passos obrigatórios de início acima
-- Execute `letra validate` antes de mover item entre estágios
-- Siga a constitution.md rigorosamente
-
-## Fluxo de Execução
-
-**Loop por AC**:
-  1. Implemente o AC no código
-  2. `letra ac done <AC-ID>` — marca como concluído no spec.md
-  3. `letra validate` — verifica se ACs estão consistentes
-  4. Repita até todos os ACs do item estarem concluídos
-
-**Ao concluir todos ACs**:
-  → `letra pulse` — confirma estado
-  → `letra sitrep` — atualiza context.md
-  → `letra flow move <ITEM-ID> --auto` — avança para próximo estágio
-
-## Comandos
-
-**Leitura (seguro — não muda nada):**
-  `letra pulse`                    — Overview do workspace
-  `letra health`                   — Alertas ativos
-  `letra flow board`               — Todas as colunas do fluxo
-  `letra flow backlog`             — Itens no backlog
-  `letra validate`                 — Validar specs e ACs
-
-**Escrita (muda estado):**
-  `letra health ack <id>`          — Reconhecer alerta
-  `letra health dismiss <id>`      — Descartar alerta
-  `letra health scan`              — Re-executar verificações
-  `letra sitrep`                   — Atualizar context.md
-  `letra flow move <id> --to <s>`  — Mover item entre estágios
-  `letra focus <spec>`             — Definir foco
-  `letra focus --clear`            — Limpar foco
-
-## Continuidade
-
-Última atividade: 15/06/2026, 17:55:27
-Ações:
-  • item_move: Item ITEM-49 movido: Backlog → Done
-  • item_move: Item ITEM-44 movido: Backlog → Code
-  • item_move: Item ITEM-44 movido: Code → Review
-  • item_move: Item ITEM-44 movido: Review → Done
-  • validate: Validação executada — 26 passed, 0 failed, 248 war
-
-## Checklist de Encerramento
-
-1. `letra pulse --json` — veja itens, ACs, alertas, backlog
-
-2. Decida o estado:
-
-   **CONTINUE** (backlog tem itens OU item atual tem ACs pendentes):
-     → Relate o progresso: quais ACs fez, o que falta, onde parou
-     → Se sessão >30 min, pare e relate. Caso contrário, continue.
-
-   **BLOCKED** (backlog vazio, item sem ACs pendentes, aguardando humano):
-     → Relate "Trabalho concluído, aguardando revisão"
-     → Liste o que foi feito e decisões necessárias
-
-   **ALL_DONE** (todos os itens em Done, backlog vazio):
-     → Relate missão completa: itens concluídos, o que foi construído, próximos passos
-
-## Arquivos de Contexto
-
+# Gerado por letra ac. Nao edite manualmente.
+# Letra Context — VSCode Copilot Adapter
+Read the following files before starting any task:
 - .letra/context.md
 - .letra/constitution.md
 - .letra/glossary.md
 - .letra/constraints.md
 - .letra/focus.md
+
+# Rules
+- Always read specs in .letra/specs/ before writing code
+- Run `letra validate` to check acceptance criteria
+- Execute `letra ac done <ID>` after implementing each AC
+- Follow the constitution.md rules strictly
+- Use formal tone in all generated content
+
+<!-- mermaid-ai-skills:start -->
+## Mermaid Diagrams
+
+When the user asks to create, edit, or visualize a diagram, follow the
+instructions in `.github/instructions/mermaid.instructions.md`.
+<!-- mermaid-ai-skills:end -->

.github/instructions/mermaid.instructions.md

@@ -0,0 +1,85 @@
+---
+applyTo: "**"
+---
+# Mermaid AI Skills
+
+When the user asks to create, edit, or visualize any diagram, use the Mermaid
+VS Code extension tools and commands described below.
+
+## Workflow
+
+1. Determine the diagram type and generate Mermaid syntax.
+2. Write the diagram to a `.mmd` file in the project.
+3. Validate syntax: correct first-line keyword, arrow types, balanced brackets.
+4. Preview via the Mermaid extension — open the `.mmd` file (auto-preview) or run
+   **MermaidChart: Preview Diagram** (`mermaidChart.preview`).
+
+## LM Tools — call these for every diagram interaction
+
+- `mermaid-diagram-validator` — validate Mermaid syntax before presenting any diagram
+- `mermaid-diagram-preview` — render a live preview inside VS Code after generating
+- `get-syntax-docs-mermaid` — fetch correct syntax docs for any diagram type
+
+## VS Code Commands
+
+Invoke via Command Palette or the VS Code command API (GitHub Copilot in VS Code only).
+Do not invent command IDs. Prefer writing/editing `.mmd` files when a command is not needed.
+
+### Diagram editing & preview
+- **Preview** (`mermaidChart.preview`) — preview the active Mermaid editor (`.mmd` / `.mermaid` must be open).
+- **Create Diagram** (`mermaidChart.createMermaidFile`) — creates a demo flowchart and opens preview side by side.
+- **Repair Diagram** (`mermaidChart.repairDiagram`) — Mermaid AI repair for the active diagram; uses Mermaid AI credits — tell the user before running.
+- **Improve Diagram** (`mermaidChart.improveDiagram`) — uses Copilot / LM API; suggests layout + styling variants for the active diagram.
+
+### Generate diagrams (GitHub Copilot required)
+- **Generate Diagram from Code** (`mermaidChart.generateDiagramFromCode`)
+- **Generate Cloud Diagram** (`mermaidChart.generateCloudDiagram`)
+- **Generate ER Diagram** (`mermaidChart.generateERDiagram`)
+- **Generate Docker Diagram** (`mermaidChart.generateDockerDiagram`)
+- **Open AI Chat** (`mermaidChart.openCopilotChat`)
+
+### Mermaid Chart cloud
+- **Login** (`mermaidChart.login`) / **Logout** (`mermaidChart.logout`)
+- **Connect Diagram** (`mermaidChart.connectDiagramToMermaidChart`) — link a local diagram to Mermaid Chart.
+- **Sync Diagram** (`mermaidChart.syncDiagramWithMermaid`) — only for diagrams already connected (frontmatter has `id:`). Example:
+  ```yaml
+  ---
+  id: cbd9e9ba-a2cb-47c5-a98e-8c28a753428d
+  ---
+  ```
+
+### Review Mermaid Sync
+For diagrams updated by the Mermaid Chart GitHub Sync app (or pre-commit regenerate):
+- **Review Mermaid Sync** (`mermaidChart.reviewAppCommits`) — start / open the review flow.
+- **Regenerate with Mermaid AI** (`mermaidChart.regenerateDiagramWithMermaidAI`) — regenerate from source references.
+Do not manually rewrite diagrams managed by this workflow. Accept/reject/diff UI actions stay in the extension UI.
+
+### Install / update this pack
+- **MermaidChart: Install AI Skills…** (`mermaidChart.installAiSkills`)
+
+## @mermaid-chart slash commands
+
+| Command | Purpose |
+|---|---|
+| `/generate_diagram_from_code` | General diagram from any source file |
+| `/generate_execution_sequence` | Sequence diagram from code flow |
+| `/generate_er_diagram` | ER diagram from schema / models |
+| `/generate_cloud_architecture_diagram` | Cloud / CI-CD architecture |
+| `/generate_docker_diagram` | Architecture from Dockerfiles |
+| `/generate_c4_topdown_architecture` | C4 top-down architecture |
+| `/analyze_code_ownership` | Code ownership diagram |
+| `/generate_dependency_diagram` | Dependency / security visualisation |
+
+## Rules
+
+1. Always call `mermaid-diagram-validator` before showing any diagram.
+2. Always call `mermaid-diagram-preview` after generating a diagram.
+3. Use `get-syntax-docs-mermaid` before generating an unfamiliar diagram type.
+4. Prefer `@mermaid-chart` slash commands for complex generation.
+5. Write diagrams to `.mmd` files; never return unvalidated Mermaid syntax.
+6. Warn the user before Repair (Mermaid AI credits).
+7. Cooperate with the Sync workflow — do not manually regenerate managed diagrams.
+
+## Docs
+
+More commands and features: https://marketplace.visualstudio.com/items?itemName=MermaidChart.vscode-mermaid-chart