diff --git a/openspec/changes/archive/.gitkeep b/openspec/changes/archive/.gitkeep new file mode 100644 index 000000000..e69de29bb diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/.openspec.yaml b/openspec/changes/archive/2026-11-10-workspace-repo-groups/.openspec.yaml new file mode 100644 index 000000000..2b638f838 --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-11-10 diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/design.md b/openspec/changes/archive/2026-11-10-workspace-repo-groups/design.md new file mode 100644 index 000000000..2f7862ea7 --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/design.md @@ -0,0 +1,115 @@ +# Design + +## Context + +Motivação: ver `proposal.md` (seção Why). Requisitos: `specs/workspace-repositories/spec.md` e `specs/repository-tree-selection/spec.md`. + +Estado atual que molda a abordagem: + +- `Preferences` guarda duas listas independentes: `Workspaces` (cada uma com as abas em `Repositories` e `ActiveIdx`) e `RepositoryNodes`, a árvore global de grupos e repositórios. Os grupos têm um `Id` GUID estável; os repositórios usam o caminho como `Id`. +- A serialização do `preference.json` é feita por código gerado (`App.JsonCodeGen.cs`, `[JsonSerializable(typeof(ViewModels.Preferences))]`). Propriedades públicas novas em `Workspace` são salvas automaticamente; propriedades só de leitura e as marcadas com `[JsonIgnore]` não são. Campos desconhecidos no arquivo são ignorados ao ler. +- Muitos pontos procuram nós na árvore global inteira: `Preferences.FindNode`, usado ao abrir abas, apagar e renomear, a detecção de repositórios já gerenciados no `ScanRepositories` e a limpeza de nós inválidos. +- `Welcome` é um singleton compartilhado por todas as abas vazias. `Refresh()` monta `Rows` a partir de uma coleção-base, com profundidade inicial 0, e a busca marca `IsVisible` percorrendo a mesma coleção. +- Em toda a base, `parent == null` significa "raiz". Ele aparece em `FindOrAddNodeByRepositoryPath`, chamado por `Welcome`, `Init`, `Clone`, `OpenLocalRepository`, `TrustRepository`, `ScanRepositories` e na abertura pela linha de comando do `Launcher` (`TryOpenRepositoryFromPath`). Aparece também em `AddNode` (usado por `CreateGroup`) e em `MoveNode` (soltar na área vazia e "ROOT" em `MoveRepositoryNode`). As abas restauradas de um workspace não passam por ele: um repositório fora da árvore abre como aba "unmanaged" e não é adicionado. +- Os seletores de grupo de `Clone` e `OpenLocalRepository` e a `LauncherPagesCommandPalette` percorrem `Preferences.RepositoryNodes` inteira. +- `Views/BranchTree.axaml.cs` já implementa uma árvore com `SelectionMode="Multiple"`, com Ctrl (Meta no macOS) e Shift e ações sobre `SelectedItems`. + +## Goals / Non-Goals + +**Goals:** +- Cada workspace com a sua árvore, sem reescrever os pontos que procuram nós globalmente. +- Um ponto único que decide qual é a raiz atual, usado por todos os fluxos que recebem `parent == null`. +- Migrar a árvore existente sem perder nada e sem exigir passo manual. +- Seleção múltipla e mover em lote reaproveitando o padrão do `BranchTree`. + +**Non-Goals:** +- Um repositório em mais de um workspace. +- Ver os repositórios de todos os workspaces juntos. +- Mover itens entre workspaces pela interface. Hoje isso só acontece apagando um workspace; arrastar entre workspaces fica para depois. +- Apagar, abrir ou editar vários itens de uma vez. Só mover entra em lote nesta change. +- Manter a seleção depois de mover: a lista é reconstruída e a seleção é limpa. +- Traduzir os textos novos para línguas além de en_US e pt_BR. + +## Decisions + +### D1. A árvore de cada workspace é um grupo-raiz oculto na árvore global +`Workspace` ganha `RootGroupId` (string, persistido). Ele aponta para um grupo no primeiro nível de `Preferences.RepositoryNodes`. Esse grupo é a raiz da árvore do workspace e nunca aparece na interface. No modelo novo, o primeiro nível da árvore global só tem esses grupos-raiz, um por workspace. O nome do grupo-raiz acompanha o nome do workspace, só para o JSON ficar legível e para uma versão antiga do SourceGit mostrar algo que faça sentido. + +- *Alternativa descartada: uma `List` dentro de cada `Workspace`.* É o modelo mais "puro", mas obriga a reescrever todos os pontos que procuram nós globalmente (Context) para varrer todos os workspaces. Também deixa a regra "um repositório num só workspace" para ser garantida à mão. Com a árvore global única, um `Id` só pode existir uma vez, então a regra vem de graça. +- *Alternativa descartada: manter a ligação opcional a um grupo visível (versão anterior desta change).* Foi rejeitada pelo usuário: o workspace deve ser a raiz, sem depender de um grupo ligado. + +### D2. Migração em `PrepareWorkspaces`, idempotente +Roda em toda carga, mas só faz algo quando encontra o que corrigir: +1. Para cada workspace com `RootGroupId` vazio ou apontando para um grupo inexistente: se há exatamente um grupo com o mesmo nome (sem diferenciar maiúsculas) em qualquer nível, ou, havendo vários, exatamente um com a grafia exata, esse grupo vira o grupo-raiz e, se estiver aninhado, sobe para o primeiro nível. Se não há, um grupo-raiz vazio é criado. +2. Todo nó do primeiro nível que não é grupo-raiz de algum workspace é movido para dentro do grupo-raiz do workspace "Default" (ou do primeiro workspace, se não houver um "Default"). +3. O nome de cada grupo-raiz é sincronizado com o nome do workspace. + +Na carga seguinte, os workspaces já têm `RootGroupId` válido, então o passo 1 não religa nada. Isso atende ao cenário "Migração não se repete". O passo 2 só age se outra versão do app tiver deixado itens soltos no primeiro nível. + +Os campos `LinkedGroupId` e `IsGroupLinkResolved`, gravados pela versão anterior desta change, deixam de existir. O leitor ignora os dois, e a ligação pelo nome refaz a associação. + +### D3. Raiz efetiva centralizada em `Preferences` +`Preferences.GetScopeRoot()` retorna o grupo-raiz do workspace ativo e o recria se tiver sumido, então nunca retorna `null` depois da carga. `GetScopeNodes()` retorna os `SubNodes` dele. + +Os três pontos de entrada traduzem `null` para essa raiz: +- `AddNode(node, to: null)` → `to = GetScopeRoot()`. +- `MoveNode(node, to: null)` → `to = GetScopeRoot()`. +- `FindOrAddNodeByRepositoryPath(repo, parent: null, shouldMoveNode)`: se o nó não existe, é criado na raiz do workspace ativo. Se já existe em algum lugar, ou seja, em algum workspace, e o `parent` original era `null`, ele **não** é movido. Com `parent` explícito, o comportamento atual continua igual. + +`FindOrCreateGroupRecursive`, usado pelo `ScanRepositories`, passa a partir de `GetScopeNodes()`. A detecção de repositórios já gerenciados no `ScanRepositories` continua global, para que escanear não tire repositórios de outros workspaces. + +Rotinas internas que usam `RepositoryNodes` diretamente (busca por ID, remoção, limpeza de inválidos, ordenação após renomear) continuam operando na árvore inteira. + +### D4. Telas que listam a árvore usam a raiz efetiva +- `Welcome.Refresh()`, a busca e `UpdateStatusAsync` usam `GetScopeNodes()`. +- `Clone` e `OpenLocalRepository` montam o seletor de grupos a partir de `GetScopeNodes()`. A opção "Sem grupo" já passa `null`, que vira a raiz do workspace. +- `LauncherPagesCommandPalette` lista os repositórios de `GetScopeNodes()`. +- `MoveRepositoryNode` mostra como raiz uma linha com o nome do workspace, que aponta para o grupo-raiz, e lista só os grupos dele. + +`Launcher.SwitchWorkspace` chama `Welcome.Instance.Refresh()` depois de trocar o workspace ativo. + +### D5. Ciclo de vida do workspace em `ConfigureWorkspace` +- **Criar:** o workspace novo recebe um grupo-raiz vazio na hora. +- **Apagar:** os `SubNodes` do grupo-raiz vão para o grupo-raiz do workspace ativo (o apagado nunca é o ativo, pela regra que já existe). Depois o grupo-raiz é removido. +- **Renomear:** ao fechar a janela, o nome dos grupos-raiz é sincronizado e a tela inicial é atualizada. + +### D6. Seleção múltipla +`RepositoryListBox` usa `SelectionMode="Multiple"`. Ctrl (Meta no macOS) e Shift vêm do próprio `ListBox` do Avalonia. + +**Problema conhecido:** o `ListBox` muda a seleção quando o botão é *apertado*, então apertar sobre um item já selecionado colapsaria a seleção antes do arrasto. Solução: no `PointerPressed` do item, se ele já está selecionado, não há modificador e `SelectedItems.Count > 1`, o evento é marcado como tratado e fica guardado um "clique pendente". No `PointerReleased` sem arrasto, só aquele item fica selecionado. + +As teclas que usam `SelectedItem` (Enter, Esquerda/Direita, Delete) só agem quando `SelectedItems.Count == 1`. + +### D6b. Seleção em retângulo +O `ListBox` do Avalonia não tem seleção em retângulo, então ela é implementada na view da tela inicial: +- Um `Canvas` sobreposto à árvore, que não recebe cliques, mostra o retângulo. +- O gesto só começa quando o botão é apertado fora de qualquer `ListBoxItem` e fora da barra de rolagem. O ponteiro é capturado pela lista. +- A cada movimento, os itens são calculados pelos contêineres realizados cujos limites cruzam o retângulo, e a seleção é aplicada em lote pelo `Selection` do `ListBox`. Com Ctrl ao começar, a seleção anterior é somada. +- *Limitação aceita:* não há rolagem automática ao encostar na borda. Com a virtualização, só os itens visíveis podem ser cobertos, o que já é o que o retângulo mostra. + +### D7. Arrasto de vários itens +O formato `sourcegit-dnd-repo-node` continua o mesmo, mas o conteúdo passa a ser uma lista de IDs separados por `\n`. Se o item sob o cursor está na seleção, vão todos os selecionados; se não está, vai só ele. + +### D8. Mover em lote no modelo +`Welcome.MoveNodes(nodes, to)`, usado pelo arrasto e pela janela: +1. **Normalizar:** remover da lista todo nó que é descendente de outro grupo também selecionado. +2. **Validar:** se `to` é um dos grupos selecionados ou descendente de um deles, não mover nada. +3. Chamar `Preferences.MoveNode(n, to, save: false)` para cada nó, depois `Save()` uma vez e `Refresh()`. + +- *Por que tudo ou nada:* a janela já esconde os destinos inválidos, então o caso só acontece por arrasto, e não fazer nada é o retorno mais claro. + +### D9. `MoveRepositoryNode` para vários itens +Recebe `IReadOnlyList targets`, mostra o nome do item ou "N itens", pula os grupos selecionados e seus descendentes, e delega para `Welcome.MoveNodes`. O construtor de um único item continua existindo para `RepositoryNode.Move()`. + +## Risks / Trade-offs + +- **[Algum fluxo passa `null` esperando a raiz real]** → A tradução fica só nos três métodos de D3. As tarefas incluem conferir cada chamador listado em Context. +- **[A seleção colapsa ao começar o arrasto]** → Tratado em D6. Precisa de teste manual no Linux, porque o comportamento de pressão do `ListBox` é do Avalonia. +- **[Um repositório aberto em aba não aparece na tela inicial]** porque está em outro workspace → É intencional (um repositório, um workspace). Para movê-lo, por enquanto o caminho é trocar para o workspace dele. +- **[A migração associa o grupo errado]** quando há nomes parecidos → Só associa com nome igual (sem diferenciar maiúsculas) e com um único candidato. O resto vai para o Default, de onde o usuário move com a seleção múltipla. +- **[O `preference.json` migrado aberto numa versão antiga do SourceGit]** → A versão antiga mostra cada workspace como um grupo de mesmo nome no primeiro nível e descarta `RootGroupId` ao salvar. Ao voltar para esta versão, o passo 1 da migração religa os grupos pelo nome. + +## Migration Plan + +- Não há passo manual. Na primeira carga com esta versão, `PrepareWorkspaces` executa D2 e o resultado é salvo no próximo `Save()`. +- **Rollback:** voltar para a versão anterior. A árvore continua íntegra, com um grupo por workspace no primeiro nível. diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/proposal.md b/openspec/changes/archive/2026-11-10-workspace-repo-groups/proposal.md new file mode 100644 index 000000000..1a5ea9e41 --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/proposal.md @@ -0,0 +1,35 @@ +# Proposal + +## Why + +Hoje um workspace guarda só as abas de repositório abertas. A árvore de repositórios e grupos da tela inicial (Welcome) é global e não muda quando o workspace muda. Quem separa os projetos em workspaces (por exemplo MEEDS, ManyLinks, Conecta) troca de workspace e continua vendo todos os projetos misturados, então os workspaces parecem não ter efeito. Além disso, reorganizar a árvore é lento: só dá para mover um repositório ou grupo por vez. + +## What Changes + +- **Cada workspace passa a ter a própria árvore de repositórios.** O workspace é a raiz: dentro dele ficam repositórios e grupos (pastas organizacionais), em quantos níveis o usuário quiser. Um workspace novo começa vazio. +- **Cada repositório pertence a um único workspace.** Adicionar ou abrir um repositório que já está em outro workspace não o tira de lá. +- A tela inicial mostra **só a árvore do workspace ativo**, e trocar de workspace troca a árvore. A busca procura só nela. +- Tudo o que hoje cai na "raiz" passa a cair na raiz do workspace ativo: abrir, clonar, inicializar, confiar, escanear, abrir pela linha de comando, criar grupo, soltar na área vazia e mover para a raiz. +- Os seletores de grupo de "Clonar" e "Abrir repositório local", a janela "Mover para outro grupo" e a paleta de repositórios passam a mostrar só o workspace ativo. +- Apagar um workspace leva a árvore dele para o workspace ativo, para não perder nada. +- **Migração da árvore global existente:** um grupo com o mesmo nome de um workspace vira a árvore desse workspace. O que não corresponder a nenhum workspace vai para o workspace "Default" (ou para o primeiro, se não houver um "Default"). +- **Seleção múltipla na árvore da tela inicial** com Ctrl+clique e Shift+clique. Os itens selecionados podem ser movidos juntos arrastando a seleção ou pelo menu "Mover para outro grupo". +- **Compatibilidade:** o `preference.json` existente é migrado na primeira carga. Uma versão antiga do SourceGit que ler o arquivo migrado mostra cada workspace como um grupo de mesmo nome na árvore global, sem perder repositórios. + +## Capabilities + +### New Capabilities +- `workspace-repositories`: árvore de repositórios própria de cada workspace. Cobre a migração da árvore global, o que a tela inicial e a busca mostram, para onde vão os itens novos, os seletores restritos ao workspace e o que acontece ao criar, renomear e apagar workspaces. +- `repository-tree-selection`: seleção de um ou vários itens na árvore de repositórios da tela inicial e as ações em lote sobre essa seleção (mover arrastando e pelo menu). + +### Modified Capabilities + + +## Impact + +- **Modelo e persistência:** `ViewModels/Workspace.cs` ganha o ID da raiz da sua árvore. `ViewModels/Preferences.cs` ganha a migração em `PrepareWorkspaces` e a regra "raiz → raiz do workspace ativo" em `FindOrAddNodeByRepositoryPath`, `AddNode`, `MoveNode` e `FindOrCreateGroupRecursive`. +- **Tela inicial:** `ViewModels/Welcome.cs` (`Refresh`, busca, mover em lote), `Views/Welcome.axaml` e `Views/Welcome.axaml.cs` (seleção múltipla, arrastar vários itens, menu de contexto). +- **Seletores restritos ao workspace:** `ViewModels/Clone.cs`, `ViewModels/OpenLocalRepository.cs`, `ViewModels/MoveRepositoryNode.cs` (com `Views/MoveRepositoryNode.axaml`) e `ViewModels/LauncherPagesCommandPalette.cs`. +- **Workspaces:** `ViewModels/Launcher.cs` (`SwitchWorkspace` atualiza a tela inicial) e `ViewModels/ConfigureWorkspace.cs` (criar, renomear e apagar mantêm a árvore de cada workspace). +- **Textos:** chaves novas em `Resources/Locales/en_US.axaml` e `pt_BR.axaml`. As outras línguas caem no texto em inglês. +- **Sem dependências novas.** diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/repository-tree-selection/spec.md b/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/repository-tree-selection/spec.md new file mode 100644 index 000000000..118f7603a --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/repository-tree-selection/spec.md @@ -0,0 +1,130 @@ +# Spec Delta + +## Purpose + +Permite selecionar vários repositórios e grupos na árvore da tela inicial e movê-los de uma vez, em vez de reorganizar a árvore um item por vez. + +## ADDED Requirements + +### Requirement: Seleção múltipla com Ctrl e Shift +A árvore de repositórios da tela inicial SHALL aceitar seleção de vários itens. Clique sem modificador SHALL selecionar só o item clicado. Ctrl+clique SHALL adicionar o item à seleção ou tirá-lo dela. Shift+clique SHALL selecionar o intervalo visível entre o último item clicado e o item clicado. + +#### Scenario: Ctrl+clique +- **GIVEN** "meeds-bff" está selecionado +- **WHEN** o usuário dá Ctrl+clique em "meeds-ms-auth" +- **THEN** "meeds-bff" e "meeds-ms-auth" ficam selecionados + +#### Scenario: Ctrl+clique em item já selecionado +- **GIVEN** "meeds-bff" e "meeds-ms-auth" estão selecionados +- **WHEN** o usuário dá Ctrl+clique em "meeds-ms-auth" +- **THEN** só "meeds-bff" continua selecionado + +#### Scenario: Shift+clique +- **GIVEN** "meeds-front-admin" está selecionado e a lista mostra, em ordem, "meeds-front-admin", "meeds-front-doctor", "meeds-front-documentos", "meeds-front-web" +- **WHEN** o usuário dá Shift+clique em "meeds-front-web" +- **THEN** os quatro repositórios ficam selecionados + +#### Scenario: Clique simples desfaz a seleção múltipla +- **GIVEN** três repositórios estão selecionados +- **WHEN** o usuário clica sem modificador em um quarto repositório +- **THEN** só o quarto repositório fica selecionado + +### Requirement: Seleção em retângulo na área vazia +Apertar o botão esquerdo na área vazia da árvore e arrastar SHALL desenhar um retângulo e selecionar todos os itens que ele cobre, atualizando a seleção enquanto o ponteiro se move. Sem modificador, o retângulo SHALL substituir a seleção; com Ctrl (Meta no macOS), SHALL somar à seleção que existia antes. Soltar o botão SHALL esconder o retângulo e manter a seleção. + +#### Scenario: Retângulo sobre vários repositórios +- **GIVEN** a árvore mostra "meeds-bff", "meeds-front-admin" e "meeds-front-doctor" em sequência, com área vazia abaixo +- **WHEN** o usuário aperta o botão na área vazia abaixo da lista e arrasta para cima até cobrir os três +- **THEN** os três ficam selecionados + +#### Scenario: Retângulo com Ctrl soma à seleção +- **GIVEN** "meeds-ms-auth" está selecionado +- **WHEN** o usuário segura Ctrl e desenha um retângulo sobre "meeds-bff" e "meeds-front-admin" +- **THEN** os três ficam selecionados + +#### Scenario: Gesto sobre um item continua sendo arrastar +- **WHEN** o usuário aperta o botão sobre um item e arrasta +- **THEN** nenhum retângulo é desenhado e o item é arrastado para mover + +### Requirement: Arrastar a seleção +Começar a arrastar um item que faz parte da seleção SHALL arrastar todos os itens selecionados. Começar a arrastar um item fora da seleção SHALL arrastar só esse item. Apertar o botão sobre um item já selecionado, sem modificador, SHALL manter a seleção até o usuário soltar sem ter arrastado. + +#### Scenario: Arrastar vários para um grupo +- **GIVEN** "meeds-integracao-betim" e "meeds-integracao-gmus" estão selecionados +- **WHEN** o usuário arrasta um dos dois e solta sobre o grupo "Integrações" +- **THEN** os dois repositórios passam a ficar dentro de "Integrações" + +#### Scenario: Soltar sobre um repositório +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário arrasta a seleção e solta sobre um repositório que está no grupo "MEEDS" +- **THEN** os dois repositórios vão para o grupo "MEEDS", que é o grupo do repositório de destino + +#### Scenario: Arrastar item fora da seleção +- **GIVEN** "meeds-bff" e "meeds-ms-auth" estão selecionados +- **WHEN** o usuário arrasta "meeds-ms-bpa", que não está selecionado, e solta sobre o grupo "Antigos" +- **THEN** só "meeds-ms-bpa" é movido + +#### Scenario: Clique sem arrastar em item selecionado +- **GIVEN** três repositórios estão selecionados +- **WHEN** o usuário aperta e solta o botão sobre um deles sem arrastar e sem modificador +- **THEN** só esse repositório fica selecionado + +### Requirement: Mover a seleção pelo menu +Com mais de um item selecionado, o menu de contexto aberto sobre um item da seleção SHALL oferecer mover todos os selecionados, mostrando quantos são. A janela de destino SHALL mover todos os itens para o grupo escolhido. + +#### Scenario: Mover vários pelo menu +- **GIVEN** quatro repositórios estão selecionados +- **WHEN** o usuário clica com o botão direito em um deles, escolhe mover e seleciona o grupo "Front" +- **THEN** os quatro repositórios passam a ficar dentro de "Front" + +#### Scenario: Menu sobre item fora da seleção +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário clica com o botão direito em um terceiro repositório, fora da seleção +- **THEN** a seleção passa a ser só esse repositório e o menu mostra as ações de um único item + +### Requirement: Ações de item único com seleção múltipla +Com mais de um item selecionado, o menu de contexto SHALL mostrar só ações que valem para todos os selecionados. Ações de um único item (editar, abrir, abrir no gerenciador de arquivos, abrir terminal, apagar) SHALL ficar fora desse menu. A tecla Delete SHALL não apagar nada quando há mais de um item selecionado. + +#### Scenario: Menu com seleção múltipla +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário abre o menu de contexto sobre um deles +- **THEN** o menu mostra a ação de mover os selecionados e não mostra editar, abrir nem apagar + +#### Scenario: Delete com seleção múltipla +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário aperta Delete +- **THEN** nenhum item é apagado e a janela de confirmação de exclusão não abre + +### Requirement: Grupo e descendentes selecionados juntos +Quando a seleção contém um grupo e itens que estão dentro dele, mover a seleção SHALL mover só o grupo, e os itens internos SHALL ir junto com ele, mantendo a estrutura. + +#### Scenario: Grupo e filho selecionados +- **GIVEN** o grupo "Antigos" e o repositório "Antigos/legado-api" estão selecionados +- **WHEN** o usuário move a seleção para o grupo "Arquivo" +- **THEN** "Antigos" fica dentro de "Arquivo" e "legado-api" continua dentro de "Antigos" + +### Requirement: Destinos inválidos +Um grupo selecionado SHALL não poder ser movido para dentro de si mesmo nem de um descendente. A janela de destino SHALL esconder esses grupos, e soltar a seleção sobre um deles SHALL não mover nenhum item. + +#### Scenario: Janela de destino com grupo selecionado +- **GIVEN** o grupo "Antigos", que tem o subgrupo "Antigos/2024", está selecionado +- **WHEN** o usuário abre "Mover para outro grupo" +- **THEN** a lista de destinos não mostra "Antigos" nem "Antigos/2024" + +#### Scenario: Soltar sobre o próprio descendente +- **GIVEN** o grupo "Antigos" e o repositório "outro-repo" estão selecionados +- **WHEN** o usuário arrasta a seleção e solta sobre o subgrupo "Antigos/2024" +- **THEN** nenhum item é movido + +### Requirement: Seleção e destinos dentro do workspace +A seleção SHALL conter só itens visíveis na tela inicial, que pertencem ao workspace ativo. Mover para a raiz SHALL levar os itens para a raiz do workspace ativo, e a janela de destino SHALL mostrar como raiz o workspace ativo e só os grupos dele. + +#### Scenario: Mover para a raiz do workspace +- **GIVEN** o workspace ativo é "MEEDS" e dois repositórios do grupo "Antigos" estão selecionados +- **WHEN** o usuário move a seleção para a raiz pela janela de destino +- **THEN** os dois repositórios passam a ficar na raiz do workspace "MEEDS" + +#### Scenario: Destinos do workspace +- **GIVEN** o workspace ativo é "MEEDS" e o workspace "ManyLinks" tem o grupo "Front" +- **WHEN** o usuário abre "Mover para outro grupo" com itens selecionados +- **THEN** a janela mostra "MEEDS" como raiz e só os grupos de "MEEDS" como destinos, sem "Front" diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/workspace-repositories/spec.md b/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/workspace-repositories/spec.md new file mode 100644 index 000000000..69a9e9b13 --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/specs/workspace-repositories/spec.md @@ -0,0 +1,124 @@ +# Spec Delta + +## Purpose + +Dá a cada workspace a sua própria árvore de repositórios e grupos, para que trocar de workspace também troque a lista de repositórios da tela inicial, além das abas abertas. + +## ADDED Requirements + +### Requirement: Árvore própria por workspace +Cada workspace SHALL ter a sua própria árvore de repositórios e grupos, cuja raiz é o próprio workspace. A tela inicial SHALL mostrar só a árvore do workspace ativo, sem nenhum nó que represente o workspace. Um workspace criado SHALL começar com a árvore vazia. + +#### Scenario: Tela inicial do workspace ativo +- **GIVEN** o workspace "MEEDS" contém "meeds-bff" e o grupo "Integrações", e o workspace "Conecta" contém "conecta_front" +- **WHEN** o usuário está no workspace "MEEDS" e abre uma aba nova +- **THEN** a tela inicial lista "Integrações" e "meeds-bff" no primeiro nível e não lista "conecta_front" + +#### Scenario: Trocar de workspace troca a árvore +- **GIVEN** a tela inicial mostra a árvore do workspace "MEEDS" +- **WHEN** o usuário troca para o workspace "Conecta" +- **THEN** a tela inicial passa a mostrar a árvore do workspace "Conecta" + +#### Scenario: Workspace novo +- **WHEN** o usuário cria um workspace e o ativa +- **THEN** a tela inicial mostra uma árvore vazia + +### Requirement: Repositório em um único workspace +Um repositório SHALL estar na árvore de no máximo um workspace. Abrir, clonar, inicializar ou confiar em um repositório que já está na árvore de outro workspace SHALL abrir a aba normalmente e SHALL mantê-lo no workspace onde já está. + +#### Scenario: Abrir repositório de outro workspace +- **GIVEN** o workspace ativo é "Conecta" e o repositório "meeds-bff" está no workspace "MEEDS" +- **WHEN** o usuário abre "meeds-bff" pelo menu "Abrir repositório local" +- **THEN** a aba de "meeds-bff" abre, e "meeds-bff" continua no workspace "MEEDS" e não aparece na tela inicial de "Conecta" + +#### Scenario: Abrir repositório que não está em nenhum workspace +- **GIVEN** o workspace ativo é "Conecta" e o repositório "utilitarios" não está em nenhum workspace +- **WHEN** o usuário abre "utilitarios" pelo menu "Abrir repositório local" sem escolher grupo +- **THEN** "utilitarios" é adicionado à raiz do workspace "Conecta" + +### Requirement: Raiz do workspace como destino +Toda ação que coloca um item na raiz SHALL colocá-lo na raiz do workspace ativo: adicionar, clonar, inicializar ou confiar em um repositório, abrir um repositório recebido pela linha de comando, escanear a pasta padrão de clone, criar grupo na raiz, soltar itens na área vazia da lista e escolher a raiz em "Mover para outro grupo". + +#### Scenario: Clonar sem escolher grupo +- **GIVEN** o workspace ativo é "MEEDS" +- **WHEN** o usuário clona um repositório novo escolhendo "Sem grupo" +- **THEN** o repositório aparece na raiz do workspace "MEEDS" + +#### Scenario: Criar grupo na raiz +- **GIVEN** o workspace ativo é "MEEDS" +- **WHEN** o usuário cria o grupo "Microsserviços" pelo menu da área vazia +- **THEN** o grupo "Microsserviços" aparece na raiz do workspace "MEEDS" + +#### Scenario: Soltar na área vazia +- **GIVEN** o workspace ativo é "MEEDS" e existe o grupo "Antigos" dentro dele +- **WHEN** o usuário arrasta um repositório de "Antigos" e solta na área vazia da lista +- **THEN** o repositório passa a ficar na raiz do workspace "MEEDS" + +#### Scenario: Escanear a pasta padrão de clone +- **GIVEN** o workspace ativo é "MEEDS" e a pasta padrão de clone tem a subpasta "api" com um repositório novo +- **WHEN** o usuário reescaneia a pasta padrão de clone +- **THEN** o grupo "api" é criado dentro do workspace "MEEDS" com o repositório novo, e repositórios que já estão em outros workspaces não são movidos + +### Requirement: Busca restrita ao workspace +A busca da tela inicial SHALL procurar só na árvore do workspace ativo. + +#### Scenario: Busca no workspace +- **GIVEN** o workspace ativo é "MEEDS" e o workspace "ManyLinks" tem "manylinks-auth-front" +- **WHEN** o usuário busca "front" +- **THEN** aparecem só os repositórios do workspace "MEEDS" cujo nome contém "front" + +### Requirement: Seletores restritos ao workspace +Os seletores de grupo de "Clonar" e "Abrir repositório local" e a paleta de repositórios SHALL listar só os grupos e repositórios do workspace ativo. + +#### Scenario: Grupos ao clonar +- **GIVEN** o workspace ativo é "MEEDS", que tem o grupo "Integrações", e o workspace "ManyLinks" tem o grupo "Front" +- **WHEN** o usuário abre "Clonar repositório" +- **THEN** a lista de grupos mostra "Integrações" e não mostra "Front" + +#### Scenario: Paleta de repositórios +- **GIVEN** o workspace ativo é "Conecta" +- **WHEN** o usuário abre a paleta de troca de repositórios +- **THEN** a paleta lista só os repositórios do workspace "Conecta" + +### Requirement: Migração da árvore global +Na primeira carga, cada workspace SHALL receber como árvore o conteúdo do grupo de mesmo nome, ignorando maiúsculas e minúsculas, quando há exatamente um grupo com esse nome; havendo vários, SHALL valer o único com a grafia exata do workspace. Todo o resto da árvore global SHALL ir para o workspace "Default", ou para o primeiro workspace se não houver um "Default". A migração SHALL acontecer uma única vez e SHALL não perder nenhum repositório nem grupo. + +#### Scenario: Grupo com o nome do workspace +- **GIVEN** a árvore global tem o grupo "MEEDS" com 19 repositórios e existe o workspace "MEEDS" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** a árvore do workspace "MEEDS" tem os 19 repositórios no primeiro nível, sem um grupo "MEEDS" no meio + +#### Scenario: Grupos com grafias diferentes +- **GIVEN** a árvore global tem os grupos "MEEDS" e "Meeds" e existe o workspace "MEEDS" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** o conteúdo do grupo "MEEDS" vira a árvore do workspace "MEEDS", e o grupo "Meeds" vai para o workspace "Default" + +#### Scenario: Itens sem workspace correspondente +- **GIVEN** a árvore global tem o repositório solto "utilitarios" e o grupo "Estudos", e não existe workspace "Estudos" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** "utilitarios" e "Estudos" ficam na árvore do workspace "Default" + +#### Scenario: Migração não se repete +- **GIVEN** a migração já aconteceu e o usuário criou depois um grupo "Conecta" dentro do workspace "MEEDS" +- **WHEN** o app é reiniciado +- **THEN** o grupo "Conecta" continua dentro do workspace "MEEDS" + +### Requirement: Renomear e apagar workspaces +Renomear um workspace SHALL manter a árvore dele. Apagar um workspace SHALL levar toda a árvore dele para a raiz do workspace ativo. + +#### Scenario: Renomear workspace +- **WHEN** o usuário renomeia o workspace "MEEDS" para "Meeds Saúde" +- **THEN** o workspace "Meeds Saúde" continua com os mesmos repositórios e grupos + +#### Scenario: Apagar workspace +- **GIVEN** o workspace ativo é "Default" e o workspace "Conecta" tem "conecta_front" e "conecta-back" +- **WHEN** o usuário apaga o workspace "Conecta" +- **THEN** "conecta_front" e "conecta-back" aparecem na raiz do workspace "Default" + +### Requirement: Abas do workspace mantidas +Trocar de workspace SHALL continuar fechando as abas do workspace anterior e restaurando as abas salvas do novo workspace. + +#### Scenario: Restaurar abas ao trocar +- **GIVEN** o workspace "Conecta" tinha as abas "conecta_front" e "conecta-back" abertas +- **WHEN** o usuário troca para "Conecta" +- **THEN** as duas abas são reabertas e a tela inicial mostra a árvore do workspace "Conecta" diff --git a/openspec/changes/archive/2026-11-10-workspace-repo-groups/tasks.md b/openspec/changes/archive/2026-11-10-workspace-repo-groups/tasks.md new file mode 100644 index 000000000..3b855a877 --- /dev/null +++ b/openspec/changes/archive/2026-11-10-workspace-repo-groups/tasks.md @@ -0,0 +1,48 @@ +# Tasks + +> O projeto não tem testes automatizados. Cada tarefa é verificada com a build (`dotnet build src/SourceGit.csproj` sem erros nem avisos) e com as checagens manuais descritas. Os cenários citados estão em `specs/`. + +## 1. Modelo: árvore própria por workspace + +- [x] 1.1 Trocar em `Workspace` os campos da versão anterior (`LinkedGroupId`, `IsGroupLinkResolved`, `ShowAllRepositories`) por `RootGroupId` (string, persistido), conforme design D1. Verificar: build ok e, depois de rodar e fechar o app, o `preference.json` tem `RootGroupId` em cada workspace e não tem os campos antigos. +- [x] 1.2 Implementar a migração idempotente em `Preferences.PrepareWorkspaces()` (design D2): grupo de mesmo nome vira o grupo-raiz e sobe para o primeiro nível; sem grupo, cria um vazio; itens soltos no primeiro nível vão para o Default (ou o primeiro workspace); nomes sincronizados. Verificar com o `preference.json` real: o primeiro nível tem só os quatro grupos-raiz, MEEDS/ManyLinks/Conecta têm os repositórios no primeiro nível da sua árvore, e nenhum repositório some (contar antes e depois). Reiniciar não muda nada (cenários de "Migração da árvore global"). +- [x] 1.3 Implementar `GetScopeRoot()` (sempre o grupo-raiz do workspace ativo, recriando se faltar) e `GetScopeNodes()` (design D3). Verificar: build ok e cenário "Workspace novo". + +## 2. Modelo: raiz do workspace como destino + +- [x] 2.1 Traduzir `to == null` para `GetScopeRoot()` em `Preferences.AddNode` e `Preferences.MoveNode`. Verificar: "Criar grupo" pela área vazia cria o grupo na raiz do workspace ativo (cenário "Criar grupo na raiz"). +- [x] 2.2 Ajustar `FindOrAddNodeByRepositoryPath`: criar na raiz do workspace ativo e, com `parent` original `null`, nunca mover um nó que já existe (design D3). Verificar: os cenários "Abrir repositório de outro workspace" e "Abrir repositório que não está em nenhum workspace". +- [x] 2.3 Fazer `FindOrCreateGroupRecursive` partir de `GetScopeNodes()`, mantendo global a detecção de repositórios gerenciados no `ScanRepositories`. Verificar: o cenário "Escanear a pasta padrão de clone". +- [x] 2.4 Conferir cada chamador listado no design (Context) e confirmar que nenhum precisa da raiz global. Verificar: o cenário "Clonar sem escolher grupo"; abrir pela linha de comando (`SourceGit `) um repositório fora da árvore o põe na raiz do workspace ativo. + +## 3. Telas restritas ao workspace + +- [x] 3.1 Fazer `Welcome.Refresh()`, a busca e `UpdateStatusAsync` usarem `GetScopeNodes()`, e remover a faixa e o "Ver todos" (design D4). Verificar: os cenários "Tela inicial do workspace ativo" e "Busca no workspace". +- [x] 3.2 Em `Launcher.SwitchWorkspace`, chamar `Welcome.Instance.Refresh()`. Verificar: os cenários "Trocar de workspace troca a árvore" e "Restaurar abas ao trocar". +- [x] 3.3 Restringir ao workspace ativo os seletores de grupo de `Clone` e `OpenLocalRepository` e a `LauncherPagesCommandPalette` (design D4). Verificar: os cenários "Grupos ao clonar" e "Paleta de repositórios". +- [x] 3.4 Remover as chaves de texto que deixaram de ser usadas (faixa, "Ver todos", seletor de grupo) de `en_US.axaml` e `pt_BR.axaml`. Verificar: `grep` sem ocorrências no código e build ok. + +## 4. Ciclo de vida do workspace + +- [x] 4.1 Em `ConfigureWorkspace`, remover o seletor de grupo, criar o grupo-raiz ao criar um workspace e, ao apagar, levar a árvore para o workspace ativo (design D5). Verificar: os cenários "Workspace novo" e "Apagar workspace". +- [x] 4.2 Sincronizar o nome dos grupos-raiz e atualizar a tela inicial ao fechar a configuração. Verificar: o cenário "Renomear workspace". + +## 5. Seleção múltipla na árvore + +- [x] 5.1 Usar `SelectionMode="Multiple"` no `RepositoryListBox` (design D6). Verificar: os cenários de "Seleção múltipla com Ctrl e Shift". +- [x] 5.2 Adiar a seleção única para o `PointerReleased` sem arrasto quando o item apertado já está numa seleção múltipla (design D6). Verificar: o cenário "Clique sem arrastar em item selecionado", e arrastar mantém todos selecionados. +- [x] 5.3 Fazer Enter, Esquerda/Direita e Delete agirem só com exatamente um item selecionado. Verificar: o cenário "Delete com seleção múltipla"; com um item, tudo funciona como antes. +- [x] 5.4 Implementar a seleção em retângulo na área vazia (design D6b). Verificar: os cenários "Retângulo sobre vários repositórios", "Retângulo com Ctrl soma à seleção" e "Gesto sobre um item continua sendo arrastar". + +## 6. Mover vários itens + +- [x] 6.1 Implementar `Welcome.MoveNodes(nodes, to)` (design D8). Verificar: o cenário "Grupo e filho selecionados". +- [x] 6.2 Levar no arrasto todos os IDs selecionados, ou só o item arrastado quando ele está fora da seleção, e usar `MoveNodes` em `DropOnTreeNode` e `DropOnTreeView` (design D7). Verificar: os cenários "Arrastar vários para um grupo", "Soltar sobre um repositório", "Arrastar item fora da seleção", "Soltar sobre o próprio descendente" e "Soltar na área vazia". +- [x] 6.3 `MoveRepositoryNode` com vários itens, com a raiz mostrando o nome do workspace e só os grupos dele (design D9). Verificar: os cenários "Mover vários pelo menu", "Janela de destino com grupo selecionado", "Mover para a raiz do workspace" e "Destinos do workspace"; mover um item só continua igual a antes. +- [x] 6.4 Menu de contexto com seleção múltipla: só "Mover N itens para outro grupo"; clique fora da seleção volta ao menu de um item. Verificar: os cenários "Menu com seleção múltipla" e "Menu sobre item fora da seleção". +- [x] 6.5 Manter em `en_US.axaml` e `pt_BR.axaml` as chaves do menu e da janela para vários itens. Verificar: os textos aparecem traduzidos. + +## 7. Integração + +- [x] 7.1 Rodar a build em Release (`dotnet build src/SourceGit.csproj -c Release`) e a checagem de formatação do CI (`dotnet format --verify-no-changes src/SourceGit.csproj`). Verificar: as duas passam sem erros. +- [x] 7.2 Percorrer de ponta a ponta com o `preference.json` real: abrir o app, conferir a migração, trocar entre workspaces, buscar, clonar ou abrir um repositório, criar e apagar um workspace de teste, selecionar vários repositórios e movê-los arrastando e pelo menu, reiniciar e confirmar que tudo persistiu. diff --git a/openspec/config.yaml b/openspec/config.yaml new file mode 100644 index 000000000..2805cb671 --- /dev/null +++ b/openspec/config.yaml @@ -0,0 +1,32 @@ +schema: spec-driven + +# Project context (optional) +# Add only constraints that should guide OpenSpec artifacts and workflows. +# Include constraints an agent cannot infer by reading the code. +# Keep general project documentation and discoverable codebase facts out. +# Example: +# context: | +# Designs and tasks must cover Windows, macOS, and Linux +# Write all artifacts in Spanish + +# Per-artifact rules (optional) +# Add custom rules for specific artifacts. +# Example: +# rules: +# proposal: +# - Keep proposals under 500 words +# - Always state what is out of scope +# tasks: +# - Break tasks into chunks of max 2 hours + +# Per-operation guidance (optional) +# Add advisory guidance for how apply and archive work should be conducted. +# This is separate from artifact rules above. +# Example: +# operations: +# apply: +# guidance: +# - Keep test summaries concise +# archive: +# guidance: +# - Summarize the archive outcome before finishing diff --git a/openspec/specs/.gitkeep b/openspec/specs/.gitkeep new file mode 100644 index 000000000..e69de29bb diff --git a/openspec/specs/repository-tree-selection/spec.md b/openspec/specs/repository-tree-selection/spec.md new file mode 100644 index 000000000..89d33ad99 --- /dev/null +++ b/openspec/specs/repository-tree-selection/spec.md @@ -0,0 +1,130 @@ +# repository-tree-selection Specification + +## Purpose + +Permite selecionar vários repositórios e grupos na árvore da tela inicial e movê-los de uma vez, em vez de reorganizar a árvore um item por vez. + +## Requirements + +### Requirement: Seleção múltipla com Ctrl e Shift +A árvore de repositórios da tela inicial SHALL aceitar seleção de vários itens. Clique sem modificador SHALL selecionar só o item clicado. Ctrl+clique SHALL adicionar o item à seleção ou tirá-lo dela. Shift+clique SHALL selecionar o intervalo visível entre o último item clicado e o item clicado. + +#### Scenario: Ctrl+clique +- **GIVEN** "meeds-bff" está selecionado +- **WHEN** o usuário dá Ctrl+clique em "meeds-ms-auth" +- **THEN** "meeds-bff" e "meeds-ms-auth" ficam selecionados + +#### Scenario: Ctrl+clique em item já selecionado +- **GIVEN** "meeds-bff" e "meeds-ms-auth" estão selecionados +- **WHEN** o usuário dá Ctrl+clique em "meeds-ms-auth" +- **THEN** só "meeds-bff" continua selecionado + +#### Scenario: Shift+clique +- **GIVEN** "meeds-front-admin" está selecionado e a lista mostra, em ordem, "meeds-front-admin", "meeds-front-doctor", "meeds-front-documentos", "meeds-front-web" +- **WHEN** o usuário dá Shift+clique em "meeds-front-web" +- **THEN** os quatro repositórios ficam selecionados + +#### Scenario: Clique simples desfaz a seleção múltipla +- **GIVEN** três repositórios estão selecionados +- **WHEN** o usuário clica sem modificador em um quarto repositório +- **THEN** só o quarto repositório fica selecionado + +### Requirement: Seleção em retângulo na área vazia +Apertar o botão esquerdo na área vazia da árvore e arrastar SHALL desenhar um retângulo e selecionar todos os itens que ele cobre, atualizando a seleção enquanto o ponteiro se move. Sem modificador, o retângulo SHALL substituir a seleção; com Ctrl (Meta no macOS), SHALL somar à seleção que existia antes. Soltar o botão SHALL esconder o retângulo e manter a seleção. + +#### Scenario: Retângulo sobre vários repositórios +- **GIVEN** a árvore mostra "meeds-bff", "meeds-front-admin" e "meeds-front-doctor" em sequência, com área vazia abaixo +- **WHEN** o usuário aperta o botão na área vazia abaixo da lista e arrasta para cima até cobrir os três +- **THEN** os três ficam selecionados + +#### Scenario: Retângulo com Ctrl soma à seleção +- **GIVEN** "meeds-ms-auth" está selecionado +- **WHEN** o usuário segura Ctrl e desenha um retângulo sobre "meeds-bff" e "meeds-front-admin" +- **THEN** os três ficam selecionados + +#### Scenario: Gesto sobre um item continua sendo arrastar +- **WHEN** o usuário aperta o botão sobre um item e arrasta +- **THEN** nenhum retângulo é desenhado e o item é arrastado para mover + +### Requirement: Arrastar a seleção +Começar a arrastar um item que faz parte da seleção SHALL arrastar todos os itens selecionados. Começar a arrastar um item fora da seleção SHALL arrastar só esse item. Apertar o botão sobre um item já selecionado, sem modificador, SHALL manter a seleção até o usuário soltar sem ter arrastado. + +#### Scenario: Arrastar vários para um grupo +- **GIVEN** "meeds-integracao-betim" e "meeds-integracao-gmus" estão selecionados +- **WHEN** o usuário arrasta um dos dois e solta sobre o grupo "Integrações" +- **THEN** os dois repositórios passam a ficar dentro de "Integrações" + +#### Scenario: Soltar sobre um repositório +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário arrasta a seleção e solta sobre um repositório que está no grupo "MEEDS" +- **THEN** os dois repositórios vão para o grupo "MEEDS", que é o grupo do repositório de destino + +#### Scenario: Arrastar item fora da seleção +- **GIVEN** "meeds-bff" e "meeds-ms-auth" estão selecionados +- **WHEN** o usuário arrasta "meeds-ms-bpa", que não está selecionado, e solta sobre o grupo "Antigos" +- **THEN** só "meeds-ms-bpa" é movido + +#### Scenario: Clique sem arrastar em item selecionado +- **GIVEN** três repositórios estão selecionados +- **WHEN** o usuário aperta e solta o botão sobre um deles sem arrastar e sem modificador +- **THEN** só esse repositório fica selecionado + +### Requirement: Mover a seleção pelo menu +Com mais de um item selecionado, o menu de contexto aberto sobre um item da seleção SHALL oferecer mover todos os selecionados, mostrando quantos são. A janela de destino SHALL mover todos os itens para o grupo escolhido. + +#### Scenario: Mover vários pelo menu +- **GIVEN** quatro repositórios estão selecionados +- **WHEN** o usuário clica com o botão direito em um deles, escolhe mover e seleciona o grupo "Front" +- **THEN** os quatro repositórios passam a ficar dentro de "Front" + +#### Scenario: Menu sobre item fora da seleção +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário clica com o botão direito em um terceiro repositório, fora da seleção +- **THEN** a seleção passa a ser só esse repositório e o menu mostra as ações de um único item + +### Requirement: Ações de item único com seleção múltipla +Com mais de um item selecionado, o menu de contexto SHALL mostrar só ações que valem para todos os selecionados. Ações de um único item (editar, abrir, abrir no gerenciador de arquivos, abrir terminal, apagar) SHALL ficar fora desse menu. A tecla Delete SHALL não apagar nada quando há mais de um item selecionado. + +#### Scenario: Menu com seleção múltipla +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário abre o menu de contexto sobre um deles +- **THEN** o menu mostra a ação de mover os selecionados e não mostra editar, abrir nem apagar + +#### Scenario: Delete com seleção múltipla +- **GIVEN** dois repositórios estão selecionados +- **WHEN** o usuário aperta Delete +- **THEN** nenhum item é apagado e a janela de confirmação de exclusão não abre + +### Requirement: Grupo e descendentes selecionados juntos +Quando a seleção contém um grupo e itens que estão dentro dele, mover a seleção SHALL mover só o grupo, e os itens internos SHALL ir junto com ele, mantendo a estrutura. + +#### Scenario: Grupo e filho selecionados +- **GIVEN** o grupo "Antigos" e o repositório "Antigos/legado-api" estão selecionados +- **WHEN** o usuário move a seleção para o grupo "Arquivo" +- **THEN** "Antigos" fica dentro de "Arquivo" e "legado-api" continua dentro de "Antigos" + +### Requirement: Destinos inválidos +Um grupo selecionado SHALL não poder ser movido para dentro de si mesmo nem de um descendente. A janela de destino SHALL esconder esses grupos, e soltar a seleção sobre um deles SHALL não mover nenhum item. + +#### Scenario: Janela de destino com grupo selecionado +- **GIVEN** o grupo "Antigos", que tem o subgrupo "Antigos/2024", está selecionado +- **WHEN** o usuário abre "Mover para outro grupo" +- **THEN** a lista de destinos não mostra "Antigos" nem "Antigos/2024" + +#### Scenario: Soltar sobre o próprio descendente +- **GIVEN** o grupo "Antigos" e o repositório "outro-repo" estão selecionados +- **WHEN** o usuário arrasta a seleção e solta sobre o subgrupo "Antigos/2024" +- **THEN** nenhum item é movido + +### Requirement: Seleção e destinos dentro do workspace +A seleção SHALL conter só itens visíveis na tela inicial, que pertencem ao workspace ativo. Mover para a raiz SHALL levar os itens para a raiz do workspace ativo, e a janela de destino SHALL mostrar como raiz o workspace ativo e só os grupos dele. + +#### Scenario: Mover para a raiz do workspace +- **GIVEN** o workspace ativo é "MEEDS" e dois repositórios do grupo "Antigos" estão selecionados +- **WHEN** o usuário move a seleção para a raiz pela janela de destino +- **THEN** os dois repositórios passam a ficar na raiz do workspace "MEEDS" + +#### Scenario: Destinos do workspace +- **GIVEN** o workspace ativo é "MEEDS" e o workspace "ManyLinks" tem o grupo "Front" +- **WHEN** o usuário abre "Mover para outro grupo" com itens selecionados +- **THEN** a janela mostra "MEEDS" como raiz e só os grupos de "MEEDS" como destinos, sem "Front" diff --git a/openspec/specs/workspace-repositories/spec.md b/openspec/specs/workspace-repositories/spec.md new file mode 100644 index 000000000..59c4d100b --- /dev/null +++ b/openspec/specs/workspace-repositories/spec.md @@ -0,0 +1,124 @@ +# workspace-repositories Specification + +## Purpose + +Dá a cada workspace a sua própria árvore de repositórios e grupos, para que trocar de workspace também troque a lista de repositórios da tela inicial, além das abas abertas. + +## Requirements + +### Requirement: Árvore própria por workspace +Cada workspace SHALL ter a sua própria árvore de repositórios e grupos, cuja raiz é o próprio workspace. A tela inicial SHALL mostrar só a árvore do workspace ativo, sem nenhum nó que represente o workspace. Um workspace criado SHALL começar com a árvore vazia. + +#### Scenario: Tela inicial do workspace ativo +- **GIVEN** o workspace "MEEDS" contém "meeds-bff" e o grupo "Integrações", e o workspace "Conecta" contém "conecta_front" +- **WHEN** o usuário está no workspace "MEEDS" e abre uma aba nova +- **THEN** a tela inicial lista "Integrações" e "meeds-bff" no primeiro nível e não lista "conecta_front" + +#### Scenario: Trocar de workspace troca a árvore +- **GIVEN** a tela inicial mostra a árvore do workspace "MEEDS" +- **WHEN** o usuário troca para o workspace "Conecta" +- **THEN** a tela inicial passa a mostrar a árvore do workspace "Conecta" + +#### Scenario: Workspace novo +- **WHEN** o usuário cria um workspace e o ativa +- **THEN** a tela inicial mostra uma árvore vazia + +### Requirement: Repositório em um único workspace +Um repositório SHALL estar na árvore de no máximo um workspace. Abrir, clonar, inicializar ou confiar em um repositório que já está na árvore de outro workspace SHALL abrir a aba normalmente e SHALL mantê-lo no workspace onde já está. + +#### Scenario: Abrir repositório de outro workspace +- **GIVEN** o workspace ativo é "Conecta" e o repositório "meeds-bff" está no workspace "MEEDS" +- **WHEN** o usuário abre "meeds-bff" pelo menu "Abrir repositório local" +- **THEN** a aba de "meeds-bff" abre, e "meeds-bff" continua no workspace "MEEDS" e não aparece na tela inicial de "Conecta" + +#### Scenario: Abrir repositório que não está em nenhum workspace +- **GIVEN** o workspace ativo é "Conecta" e o repositório "utilitarios" não está em nenhum workspace +- **WHEN** o usuário abre "utilitarios" pelo menu "Abrir repositório local" sem escolher grupo +- **THEN** "utilitarios" é adicionado à raiz do workspace "Conecta" + +### Requirement: Raiz do workspace como destino +Toda ação que coloca um item na raiz SHALL colocá-lo na raiz do workspace ativo: adicionar, clonar, inicializar ou confiar em um repositório, abrir um repositório recebido pela linha de comando, escanear a pasta padrão de clone, criar grupo na raiz, soltar itens na área vazia da lista e escolher a raiz em "Mover para outro grupo". + +#### Scenario: Clonar sem escolher grupo +- **GIVEN** o workspace ativo é "MEEDS" +- **WHEN** o usuário clona um repositório novo escolhendo "Sem grupo" +- **THEN** o repositório aparece na raiz do workspace "MEEDS" + +#### Scenario: Criar grupo na raiz +- **GIVEN** o workspace ativo é "MEEDS" +- **WHEN** o usuário cria o grupo "Microsserviços" pelo menu da área vazia +- **THEN** o grupo "Microsserviços" aparece na raiz do workspace "MEEDS" + +#### Scenario: Soltar na área vazia +- **GIVEN** o workspace ativo é "MEEDS" e existe o grupo "Antigos" dentro dele +- **WHEN** o usuário arrasta um repositório de "Antigos" e solta na área vazia da lista +- **THEN** o repositório passa a ficar na raiz do workspace "MEEDS" + +#### Scenario: Escanear a pasta padrão de clone +- **GIVEN** o workspace ativo é "MEEDS" e a pasta padrão de clone tem a subpasta "api" com um repositório novo +- **WHEN** o usuário reescaneia a pasta padrão de clone +- **THEN** o grupo "api" é criado dentro do workspace "MEEDS" com o repositório novo, e repositórios que já estão em outros workspaces não são movidos + +### Requirement: Busca restrita ao workspace +A busca da tela inicial SHALL procurar só na árvore do workspace ativo. + +#### Scenario: Busca no workspace +- **GIVEN** o workspace ativo é "MEEDS" e o workspace "ManyLinks" tem "manylinks-auth-front" +- **WHEN** o usuário busca "front" +- **THEN** aparecem só os repositórios do workspace "MEEDS" cujo nome contém "front" + +### Requirement: Seletores restritos ao workspace +Os seletores de grupo de "Clonar" e "Abrir repositório local" e a paleta de repositórios SHALL listar só os grupos e repositórios do workspace ativo. + +#### Scenario: Grupos ao clonar +- **GIVEN** o workspace ativo é "MEEDS", que tem o grupo "Integrações", e o workspace "ManyLinks" tem o grupo "Front" +- **WHEN** o usuário abre "Clonar repositório" +- **THEN** a lista de grupos mostra "Integrações" e não mostra "Front" + +#### Scenario: Paleta de repositórios +- **GIVEN** o workspace ativo é "Conecta" +- **WHEN** o usuário abre a paleta de troca de repositórios +- **THEN** a paleta lista só os repositórios do workspace "Conecta" + +### Requirement: Migração da árvore global +Na primeira carga, cada workspace SHALL receber como árvore o conteúdo do grupo de mesmo nome, ignorando maiúsculas e minúsculas, quando há exatamente um grupo com esse nome; havendo vários, SHALL valer o único com a grafia exata do workspace. Todo o resto da árvore global SHALL ir para o workspace "Default", ou para o primeiro workspace se não houver um "Default". A migração SHALL acontecer uma única vez e SHALL não perder nenhum repositório nem grupo. + +#### Scenario: Grupo com o nome do workspace +- **GIVEN** a árvore global tem o grupo "MEEDS" com 19 repositórios e existe o workspace "MEEDS" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** a árvore do workspace "MEEDS" tem os 19 repositórios no primeiro nível, sem um grupo "MEEDS" no meio + +#### Scenario: Grupos com grafias diferentes +- **GIVEN** a árvore global tem os grupos "MEEDS" e "Meeds" e existe o workspace "MEEDS" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** o conteúdo do grupo "MEEDS" vira a árvore do workspace "MEEDS", e o grupo "Meeds" vai para o workspace "Default" + +#### Scenario: Itens sem workspace correspondente +- **GIVEN** a árvore global tem o repositório solto "utilitarios" e o grupo "Estudos", e não existe workspace "Estudos" +- **WHEN** o app carrega as preferências pela primeira vez com esta versão +- **THEN** "utilitarios" e "Estudos" ficam na árvore do workspace "Default" + +#### Scenario: Migração não se repete +- **GIVEN** a migração já aconteceu e o usuário criou depois um grupo "Conecta" dentro do workspace "MEEDS" +- **WHEN** o app é reiniciado +- **THEN** o grupo "Conecta" continua dentro do workspace "MEEDS" + +### Requirement: Renomear e apagar workspaces +Renomear um workspace SHALL manter a árvore dele. Apagar um workspace SHALL levar toda a árvore dele para a raiz do workspace ativo. + +#### Scenario: Renomear workspace +- **WHEN** o usuário renomeia o workspace "MEEDS" para "Meeds Saúde" +- **THEN** o workspace "Meeds Saúde" continua com os mesmos repositórios e grupos + +#### Scenario: Apagar workspace +- **GIVEN** o workspace ativo é "Default" e o workspace "Conecta" tem "conecta_front" e "conecta-back" +- **WHEN** o usuário apaga o workspace "Conecta" +- **THEN** "conecta_front" e "conecta-back" aparecem na raiz do workspace "Default" + +### Requirement: Abas do workspace mantidas +Trocar de workspace SHALL continuar fechando as abas do workspace anterior e restaurando as abas salvas do novo workspace. + +#### Scenario: Restaurar abas ao trocar +- **GIVEN** o workspace "Conecta" tinha as abas "conecta_front" e "conecta-back" abertas +- **WHEN** o usuário troca para "Conecta" +- **THEN** as duas abas são reabertas e a tela inicial mostra a árvore do workspace "Conecta" diff --git a/src/Resources/Locales/en_US.axaml b/src/Resources/Locales/en_US.axaml index 603d223a9..59cdffc2e 100644 --- a/src/Resources/Locales/en_US.axaml +++ b/src/Resources/Locales/en_US.axaml @@ -636,6 +636,7 @@ Move To: Submodule: Move Repository Node + {0} items Select parent node for: Name: NO @@ -1041,6 +1042,7 @@ Manually add a branch/tag history filter will disable this feature automatically DRAG & DROP FOLDER SUPPORTED. CUSTOM GROUPING SUPPORTED. Edit Move to Another Group + Move {0} Items to Another Group Open All Repositories Open Repository Open Terminal diff --git a/src/Resources/Locales/pt_BR.axaml b/src/Resources/Locales/pt_BR.axaml index 5084f0180..e3fd72f5d 100644 --- a/src/Resources/Locales/pt_BR.axaml +++ b/src/Resources/Locales/pt_BR.axaml @@ -369,6 +369,7 @@ Para: Opção de Mesclagem: Mover nó do repositório + {0} itens Selecionar nó pai para: Nome: O Git NÃO foi configurado. Por favor, vá para [Preferências] e configure primeiro. @@ -599,6 +600,7 @@ ARRASTAR E SOLTAR PASTAS SUPORTADO. AGRUPAMENTO PERSONALIZADO SUPORTADO. Editar Mover para Outro Grupo + Mover {0} Itens para Outro Grupo Abrir Todos os Repositórios Abrir Repositório Abrir Terminal diff --git a/src/Resources/Styles.axaml b/src/Resources/Styles.axaml index d1ba76c82..75d71796f 100644 --- a/src/Resources/Styles.axaml +++ b/src/Resources/Styles.axaml @@ -179,6 +179,32 @@