implements PLN-0062
This commit is contained in:
@@ -0,0 +1,106 @@
|
||||
---
|
||||
id: AGD-0034
|
||||
ticket: studio-editor-workspace-cleanup
|
||||
title: Limpeza completa do Workspace Editor do Studio e remoção dos acoplamentos legados
|
||||
status: accepted
|
||||
created: 2026-05-05
|
||||
resolved: 2026-05-05
|
||||
decision: DEC-0031
|
||||
tags: [studio, editor, cleanup, vfs, lsp, migration]
|
||||
---
|
||||
|
||||
## Pain
|
||||
|
||||
O repositório ainda carrega um `Workspace Editor` no `prometeu-studio` junto com camadas de `VFS` e `LSP` desenhadas especificamente para esse editor embutido.
|
||||
|
||||
Esse conjunto virou um legado arquitetural:
|
||||
|
||||
- o editor JavaFX não é mais a direção do produto;
|
||||
- o `prometeu-vfs` atual está acoplado ao modelo editorial do editor embutido;
|
||||
- o `prometeu-lsp` atual está acoplado ao `VFS` e ao host local do Studio;
|
||||
- e manter essa base viva só aumenta o custo da futura reconstrução correta do backend de código.
|
||||
|
||||
## Context
|
||||
|
||||
- O monorepo já separa `prometeu-compiler`, `prometeu-packer` e `prometeu-studio`, mas o `prometeu-lsp` e o `prometeu-vfs` atuais nasceram como suporte ao editor embutido.
|
||||
- A capacidade de compilação dos projetos deve continuar existindo no Studio.
|
||||
- O alvo imediato não é discutir o novo LSP nem o novo contrato de automação.
|
||||
- O alvo imediato é remover:
|
||||
- o `Workspace Editor`;
|
||||
- o `prometeu-lsp` legado usado por ele;
|
||||
- e o `prometeu-vfs` acoplado a esse modelo editorial.
|
||||
- O Studio continua existindo como produto fora do editor:
|
||||
- shell e launcher de projeto;
|
||||
- assets workspace;
|
||||
- shipper/build surfaces;
|
||||
- play/stop e integração com runtime/debug.
|
||||
- Uma agenda futura poderá discutir a reconstrução do backend de código e do novo servidor LSP, mas isso fica fora deste artefato.
|
||||
|
||||
## Open Questions
|
||||
|
||||
- Quais partes do `prometeu-vfs` atual pertencem exclusivamente ao `Workspace Editor` e podem ser removidas integralmente?
|
||||
- Existe algum consumer ainda válido do `prometeu-lsp` legado fora do editor embutido?
|
||||
- O fluxo `play` ou qualquer outro fluxo do Studio depende hoje, mesmo indiretamente, de APIs do editor legado, do `VFS` legado ou do `LSP` legado?
|
||||
- A limpeza deve remover apenas código de produção ou também specs, testes, lessons e referências que tratam o editor embutido como superfície ativa?
|
||||
- Quais contratos de compilação precisam ser preservados explicitamente enquanto a camada de edição é removida?
|
||||
|
||||
## Options
|
||||
|
||||
### Option A - Manter o editor legado até a reconstrução completa do backend de código
|
||||
- **Approach:** adiar a limpeza e preservar temporariamente `Workspace Editor`, `prometeu-vfs` legado e `prometeu-lsp` legado até o novo backend existir.
|
||||
- **Pro:** menor ruptura imediata.
|
||||
- **Con:** prolonga a vida do legado, aumenta custo de manutenção e deixa a futura reconstrução mais confusa.
|
||||
- **Maintainability:** fraca.
|
||||
|
||||
### Option B - Limpeza completa agora, preservando apenas a compilação do Studio
|
||||
- **Approach:** remover `Workspace Editor`, `prometeu-lsp` legado e o `prometeu-vfs` acoplado a esse modelo, mantendo apenas as superfícies de compilação e execução que não dependem desse stack.
|
||||
- **Pro:** reduz o legado antes da reconstrução, clarifica boundaries e impede que o futuro LSP nasça comprometido por compatibilidade acidental.
|
||||
- **Con:** cria um período sem editor embutido e sem backend de código novo dentro do Studio.
|
||||
- **Maintainability:** forte.
|
||||
|
||||
Vamos de Option B.
|
||||
|
||||
## Discussion
|
||||
|
||||
O trabalho desta agenda não é desenhar o novo backend de código.
|
||||
|
||||
O trabalho desta agenda é remover o legado que impediria esse redesenho.
|
||||
|
||||
Isso implica alguns cortes diretos:
|
||||
|
||||
- o `Workspace Editor` deixa de ser superfície ativa do Studio;
|
||||
- o `prometeu-lsp` atual deixa de ser tratado como base evolutiva;
|
||||
- o `prometeu-vfs` atual, por ser acoplado ao modelo editorial do editor embutido, sai junto com esse stack;
|
||||
- as capacidades de compilação, build e execução que não dependem desse stack devem ser preservadas.
|
||||
|
||||
O princípio aqui é de limpeza arquitetural antes de reconstrução:
|
||||
|
||||
- não carregar compatibilidade acidental com o editor antigo;
|
||||
- não manter um `VFS` ou `LSP` cujo contrato nasce de um modelo que já foi abandonado;
|
||||
- e não misturar, nesta discussão, a limpeza do legado com o desenho do futuro servidor LSP.
|
||||
|
||||
Isso também reduz o risco de falsa migração:
|
||||
|
||||
- em vez de adaptar o editor atual, o repositório assume explicitamente que ele vai morrer;
|
||||
- em vez de reaproveitar um `LSP` embrionário acoplado ao host local, o repositório aceita que um novo backend de código será desenhado depois;
|
||||
- e em vez de preservar o `VFS` por inércia, o repositório valida se ele ainda possui valor fora do modelo que o originou.
|
||||
|
||||
## Resolution
|
||||
|
||||
Recomendação preliminar:
|
||||
|
||||
- seguir com a Option B;
|
||||
- tratar esta agenda exclusivamente como limpeza completa do `Workspace Editor` do Studio;
|
||||
- remover junto o `prometeu-lsp` legado e o `prometeu-vfs` acoplado a esse modelo;
|
||||
- preservar explicitamente a capacidade de compilação e os fluxos do Studio que não dependem desse stack;
|
||||
- e abrir uma discussão futura separada para o backend de código novo, o novo LSP e o contrato de automação.
|
||||
|
||||
## Next Step
|
||||
|
||||
Se a direção fizer sentido, o próximo passo disciplinado é fechar uma `decision` com:
|
||||
|
||||
1. o escopo exato da remoção do `Workspace Editor`;
|
||||
2. o escopo exato da remoção do `prometeu-lsp` legado;
|
||||
3. o escopo exato da remoção do `prometeu-vfs` acoplado a esse modelo;
|
||||
4. as capacidades de compilação e execução que devem sobreviver intactas;
|
||||
5. e os artefatos normativos, testes e código que precisam ser limpos ou preservados.
|
||||
@@ -0,0 +1,148 @@
|
||||
---
|
||||
id: DEC-0031
|
||||
ticket: studio-editor-workspace-cleanup
|
||||
title: Limpeza completa do Workspace Editor do Studio e remoção dos acoplamentos legados
|
||||
status: in_progress
|
||||
created: 2026-05-05
|
||||
accepted: 2026-05-05
|
||||
agenda: AGD-0034
|
||||
plans: [PLN-0062, PLN-0063, PLN-0064]
|
||||
tags: [studio, editor, cleanup, vfs, lsp, migration]
|
||||
---
|
||||
|
||||
## Decision
|
||||
|
||||
O repositório SHALL remover integralmente o `Workspace Editor` do Studio como superfície ativa do produto.
|
||||
|
||||
Essa remoção SHALL incluir:
|
||||
|
||||
1. o workspace de código embutido em `prometeu-studio`;
|
||||
2. o `prometeu-lsp` legado usado por esse workspace;
|
||||
3. o `prometeu-vfs` legado acoplado ao modelo editorial desse workspace;
|
||||
4. os pontos de integração do shell, da sessão de projeto e do bootstrap que assumem a existência desse stack;
|
||||
5. e os artefatos normativos, testes e referências documentais que tratam esse stack como superfície vigente.
|
||||
|
||||
Ao mesmo tempo, esta decisão ALSO locks que:
|
||||
|
||||
1. a capacidade de compilação dos projetos MUST permanecer disponível no Studio;
|
||||
2. os fluxos atuais de `build`, `play`, `run` e `debug` MUST permanecer funcionais desde que não dependam do editor legado, do `prometeu-lsp` legado ou do `prometeu-vfs` legado;
|
||||
3. esta decisão MUST NOT introduzir o novo backend de código, o novo servidor LSP ou o futuro contrato de automação;
|
||||
4. qualquer reconstrução dessas superfícies MUST acontecer em discussão posterior e separada.
|
||||
|
||||
## Rationale
|
||||
|
||||
O `Workspace Editor`, o `prometeu-lsp` atual e o `prometeu-vfs` atual formam um stack único, criado especificamente para o editor embutido do Studio.
|
||||
|
||||
Esse stack não é mais alinhado à direção do produto:
|
||||
|
||||
1. o editor JavaFX deixou de ser a direção principal;
|
||||
2. o `prometeu-lsp` atual não deve ser tratado como base séria para um futuro servidor LSP;
|
||||
3. o `prometeu-vfs` atual carrega um contrato editorial pensado para o editor embutido;
|
||||
4. manter esse legado vivo aumenta o custo de reconstrução e preserva boundaries errados por inércia.
|
||||
|
||||
Portanto, a limpeza precisa acontecer antes da reconstrução.
|
||||
|
||||
## Technical Specification
|
||||
|
||||
### 1. Editor Workspace Removal
|
||||
|
||||
O Studio MUST remover a superfície `Code Editor` do shell.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. remover `WorkspaceId.EDITOR`;
|
||||
2. remover o `EditorWorkspace` e todos os controles, painéis, modelos e helpers sob `prometeu-studio/.../workspaces/editor`;
|
||||
3. remover a presença do editor na workspace rail, no layout principal e no fluxo de restauração de shell;
|
||||
4. remover strings, ícones e estado visual exclusivos dessa superfície.
|
||||
|
||||
### 2. Legacy LSP Removal
|
||||
|
||||
O repositório MUST remover o `prometeu-lsp` legado como módulo ativo.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. remover os módulos `prometeu-lsp-api` e `prometeu-lsp-v1`;
|
||||
2. remover `LspService`, `LspServiceFactory` e todos os DTOs/messages específicos desse stack legado;
|
||||
3. remover a criação e injeção dessas dependências no `AppContainer`, no `Container`, na sessão de projeto e nos testes associados;
|
||||
4. remover a hipótese de que esse `LSP` será evoluído para o futuro backend de código.
|
||||
|
||||
Os conceitos úteis descobertos nesse stack MAY ser reaproveitados mais tarde, mas esta decisão não preserva compatibilidade de código, pacote ou contrato com ele.
|
||||
|
||||
### 3. Legacy VFS Removal
|
||||
|
||||
O repositório MUST remover o `prometeu-vfs` legado como módulo ativo.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. remover os módulos `prometeu-vfs-api` e `prometeu-vfs-v1`;
|
||||
2. remover `VfsProjectDocument`, `ProjectDocumentVfsFactory` e implementações filesystem-backed associadas;
|
||||
3. remover a criação e posse desse `VFS` na sessão de projeto;
|
||||
4. remover qualquer regra que trate esse `VFS` como boundary documental vigente do Studio.
|
||||
|
||||
Esta decisão assume que o `prometeu-vfs` atual pertence ao modelo do editor legado e, portanto, não deve sobreviver por compatibilidade acidental.
|
||||
|
||||
### 4. Session and Shell Cleanup
|
||||
|
||||
O Studio MUST reconfigurar a sessão de projeto e o shell principal para não depender do stack removido.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. remover `LSP` e `VFS` legados da estrutura de `StudioProjectSession`;
|
||||
2. remover sua criação em `StudioProjectSessionFactory`;
|
||||
3. remover dependências globais correspondentes do bootstrap e do container;
|
||||
4. remover persistência de layout e restauração editorial específicas do editor.
|
||||
|
||||
### 5. State Cleanup
|
||||
|
||||
O estado local do projeto MUST deixar de persistir dados exclusivos do editor legado.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. remover `editorRestoration`;
|
||||
2. remover `shellLayout.editorLayout`;
|
||||
3. garantir fallback seguro para estados antigos já persistidos em `.studio/state.json`;
|
||||
4. preservar apenas os campos ainda pertencentes a workspaces vivos e ao shell remanescente.
|
||||
|
||||
### 6. Documentation and Test Cleanup
|
||||
|
||||
O repositório MUST limpar artefatos normativos e testes que descrevem o stack legado como vigente.
|
||||
|
||||
Isso inclui:
|
||||
|
||||
1. revisar ou remover as specs do `Code Editor`, do `Project Document VFS` e do `Integrated LSP Semantic Read Phase`;
|
||||
2. revisar `docs/specs/studio/README.md`;
|
||||
3. remover ou arquivar testes exclusivos do editor, do `prometeu-lsp` legado e do `prometeu-vfs` legado;
|
||||
4. revisar lessons e referências históricas para deixar explícito que se tratam de legado, quando forem mantidas.
|
||||
|
||||
### 7. Capabilities That MUST Survive
|
||||
|
||||
As seguintes capacidades MUST sobreviver a esta limpeza:
|
||||
|
||||
1. compilação de projetos pelo pipeline canônico existente;
|
||||
2. build de artefatos via `BuilderPipelineService`;
|
||||
3. preparação do fluxo de shipper;
|
||||
4. `play`, `run` e `debug` do Studio, desde que apoiados nas superfícies remanescentes e não no stack removido;
|
||||
5. workspaces `Assets`, `Shipper` e `Debug`, além do launcher e do shell geral.
|
||||
|
||||
### 8. Explicit Non-Goals
|
||||
|
||||
Esta decisão MUST NOT:
|
||||
|
||||
1. definir o novo servidor LSP;
|
||||
2. definir o novo contrato de automação;
|
||||
3. definir o novo modelo de sessão de código;
|
||||
4. definir integração com VS Code;
|
||||
5. reter compatibilidade com o `LSP` ou `VFS` legados por conveniência.
|
||||
|
||||
## Constraints
|
||||
|
||||
1. A limpeza MUST preservar o pipeline canônico `analyze`, `compile` e `build` já existente no compiler.
|
||||
2. A limpeza MUST evitar remover ou degradar fluxos de `build/run/debug` que hoje dependem apenas de `compiler`, `shipper`, runtime e shell.
|
||||
3. A limpeza MUST deixar o shell do Studio em estado coerente, sem workspace fantasma, sem layout órfão e sem dependências mortas.
|
||||
4. A limpeza MUST tratar specs e estado persistido como parte do trabalho, não como detalhe pós-código.
|
||||
5. A futura reconstrução do backend de código SHALL nascer em discussão separada, sem herdar obrigação de compatibilidade com o stack removido.
|
||||
|
||||
## Revision Log
|
||||
|
||||
- 2026-05-05: Initial draft from AGD-0034.
|
||||
- 2026-05-05: Accepted and decomposed into PLN-0062, PLN-0063, and PLN-0064.
|
||||
+91
@@ -0,0 +1,91 @@
|
||||
---
|
||||
id: PLN-0062
|
||||
ticket: studio-editor-workspace-cleanup
|
||||
title: Shell Session and State Cleanup After Editor Removal
|
||||
status: done
|
||||
created: 2026-05-05
|
||||
completed: 2026-05-05
|
||||
tags: [studio, editor, cleanup, shell, session, state]
|
||||
---
|
||||
|
||||
## Objective
|
||||
|
||||
Remove the `Code Editor` workspace from the Studio shell and reconfigure project session and persisted state so the application remains coherent without any editor-owned concepts.
|
||||
|
||||
## Background
|
||||
|
||||
`DEC-0031` locks the complete removal of the embedded editor stack. The shell, project session, workspace registry, and `.studio/state.json` currently still assume the existence of `WorkspaceId.EDITOR`, `EditorWorkspace`, editor restoration state, and editor-specific layout state.
|
||||
|
||||
## Scope
|
||||
|
||||
### Included
|
||||
- Remove `WorkspaceId.EDITOR` from the Studio shell.
|
||||
- Remove `EditorWorkspace` registration and shell integration.
|
||||
- Remove editor-specific state persistence and restoration paths.
|
||||
- Remove `LSP`/`VFS` legacy ownership from `StudioProjectSession` and `StudioProjectSessionFactory`.
|
||||
- Keep `Assets`, `Shipper`, `Debug`, launcher, and shell flows functional.
|
||||
|
||||
### Excluded
|
||||
- Removal of the `prometeu-lsp` and `prometeu-vfs` module source trees themselves.
|
||||
- Documentation and lesson cleanup.
|
||||
- New code backend or replacement LSP architecture.
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### Step 1 - Remove editor workspace registration from the shell
|
||||
|
||||
**What:** Remove all shell-level references to the `Code Editor` workspace.
|
||||
**How:** Update the main window composition to stop creating `EditorWorkspace`, remove the editor rail item, stop selecting or restoring `WorkspaceId.EDITOR`, and ensure shell fallback remains stable when old persisted state still references the editor.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/window/MainView.java`, `prometeu-studio/src/main/java/p/studio/workspaces/WorkspaceId.java`, any directly related shell controls or selectors.
|
||||
|
||||
### Step 2 - Remove editor-owned state and restoration from project-local state
|
||||
|
||||
**What:** Remove editor layout and restoration data from persisted project-local Studio state.
|
||||
**How:** Simplify `ProjectLocalStudioState` to remove `editorRestoration` and `shellLayout.editorLayout`, update normalization/defaults, and make loading old `.studio/state.json` degrade safely without crashes or stale editor assumptions.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/projectstate/ProjectLocalStudioState.java`, `prometeu-studio/src/main/java/p/studio/projectstate/ProjectLocalStudioStateService.java`, any callers that write or restore editor state.
|
||||
|
||||
### Step 3 - Reconfigure project session to stop owning editor legacy dependencies
|
||||
|
||||
**What:** Remove legacy editor-driven `LSP` and `VFS` ownership from project session composition.
|
||||
**How:** Refactor `StudioProjectSession` and `StudioProjectSessionFactory` so opening a project no longer constructs `VfsProjectDocument` or `LspService`, and so close semantics remain valid without those resources.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/projectsessions/StudioProjectSession.java`, `prometeu-studio/src/main/java/p/studio/projectsessions/StudioProjectSessionFactory.java`, dependent tests.
|
||||
|
||||
### Step 4 - Remove bootstrap/container dependencies that only existed for the editor stack
|
||||
|
||||
**What:** Remove application bootstrap and container seams that exist only to inject legacy editor stack services.
|
||||
**How:** Delete `LspServiceFactory` and `ProjectDocumentVfsFactory` accessors from the container surfaces once shell/session no longer depend on them, and update `AppContainer` accordingly.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/Container.java`, `prometeu-app/src/main/java/p/studio/AppContainer.java`, directly affected tests.
|
||||
|
||||
## Test Requirements
|
||||
|
||||
### Unit Tests
|
||||
- Update session and state tests to reflect the absence of editor state.
|
||||
- Add coverage for loading old persisted project-local state without editor restoration fields being required.
|
||||
|
||||
### Integration Tests
|
||||
- Verify the main Studio shell opens a project and activates a surviving workspace without editor registration.
|
||||
- Verify session close still saves valid project-local state and shuts down surviving services cleanly.
|
||||
|
||||
### Manual Verification
|
||||
- Open the Studio shell and confirm only surviving workspaces appear.
|
||||
- Reopen a project with stale `.studio/state.json` containing editor data and confirm safe fallback.
|
||||
- Confirm project switching and shell startup remain stable.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [x] `WorkspaceId.EDITOR` no longer exists in production code.
|
||||
- [x] `MainView` no longer instantiates or restores `EditorWorkspace`.
|
||||
- [x] Project-local state no longer persists editor restoration or editor layout fields.
|
||||
- [x] `StudioProjectSession` no longer owns legacy editor `LSP`/`VFS` resources.
|
||||
- [x] The Studio shell remains functional with surviving workspaces.
|
||||
|
||||
## Dependencies
|
||||
|
||||
- `DEC-0031` accepted and normatively locked.
|
||||
- Knowledge of all shell/session/state call sites that currently assume the editor exists.
|
||||
|
||||
## Risks
|
||||
|
||||
- Shell restoration may break if old persisted state is not normalized defensively.
|
||||
- Session teardown may regress if hidden resource ownership remains after field removal.
|
||||
- Removing editor assumptions too early may temporarily orphan callers still using editor-specific state APIs.
|
||||
+92
@@ -0,0 +1,92 @@
|
||||
---
|
||||
id: PLN-0063
|
||||
ticket: studio-editor-workspace-cleanup
|
||||
title: Legacy LSP and VFS Module Removal with Runtime Preservation
|
||||
status: open
|
||||
created: 2026-05-05
|
||||
completed:
|
||||
tags: [studio, editor, cleanup, lsp, vfs, runtime]
|
||||
---
|
||||
|
||||
## Objective
|
||||
|
||||
Remove the legacy `prometeu-lsp` and `prometeu-vfs` modules and all remaining code references to them while preserving compiler, shipper, play, run, and debug flows that do not depend on the editor stack.
|
||||
|
||||
## Background
|
||||
|
||||
`DEC-0031` treats the current `prometeu-lsp` and `prometeu-vfs` modules as part of the embedded editor legacy stack. The Studio execution path must continue to compile, build, package, and run projects through the existing compiler and runtime orchestration layers.
|
||||
|
||||
## Scope
|
||||
|
||||
### Included
|
||||
- Remove `prometeu-lsp` modules from Gradle settings and codebase references.
|
||||
- Remove `prometeu-vfs` modules from Gradle settings and codebase references.
|
||||
- Remove tests dedicated to these legacy modules.
|
||||
- Verify `StudioShipperService`, `StudioPlayStopCoordinator`, and runtime/debug flows remain intact.
|
||||
|
||||
### Excluded
|
||||
- Shell/editor state cleanup handled by a separate plan.
|
||||
- Documentation/spec/lesson cleanup handled by a separate plan.
|
||||
- New replacement backend services.
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### Step 1 - Remove Gradle module registration for legacy editor stack modules
|
||||
|
||||
**What:** Stop building the legacy `prometeu-lsp` and `prometeu-vfs` modules.
|
||||
**How:** Remove the module includes and any direct module dependencies that point to `prometeu-lsp:*` and `prometeu-vfs:*`, then fix resulting build graph fallout in Studio modules.
|
||||
**File(s):** `settings.gradle.kts`, affected `build.gradle.kts` files in `prometeu-app`, `prometeu-studio`, and module directories.
|
||||
|
||||
### Step 2 - Remove legacy module source trees and direct test coverage
|
||||
|
||||
**What:** Delete the legacy `prometeu-lsp` and `prometeu-vfs` code once all consumers are detached.
|
||||
**How:** Remove module source files and their dedicated tests only after production call sites no longer compile against them.
|
||||
**File(s):** `prometeu-lsp/**`, `prometeu-vfs/**`, related test sources in `prometeu-studio`.
|
||||
|
||||
### Step 3 - Preserve compiler and shipper build flow
|
||||
|
||||
**What:** Ensure build preparation still uses the canonical compiler pipeline without editor legacy dependencies.
|
||||
**How:** Validate and adjust `StudioShipperService` and any shipper/build callers so they continue using `BuilderPipelineService`, `BuilderPipelineConfig`, and `BuilderPipelineContext` directly without reintroducing removed editor-layer seams.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/shipper/StudioShipperService.java`, affected compiler/shipper integration tests.
|
||||
|
||||
### Step 4 - Preserve play, run, and debug execution flow
|
||||
|
||||
**What:** Ensure runtime orchestration continues to function after legacy module removal.
|
||||
**How:** Re-test and patch `StudioPlayStopCoordinator`, runtime handshake services, execution session handling, and debug workspace projections if any hidden import or event dependency pointed at removed editor-stack modules.
|
||||
**File(s):** `prometeu-studio/src/main/java/p/studio/execution/StudioPlayStopCoordinator.java`, `prometeu-studio/src/main/java/p/studio/debug/runtime/**`, `prometeu-studio/src/main/java/p/studio/workspaces/debug/**`, related tests.
|
||||
|
||||
## Test Requirements
|
||||
|
||||
### Unit Tests
|
||||
- Update or remove module-specific tests for `prometeu-lsp` and `prometeu-vfs`.
|
||||
- Preserve unit coverage for execution session, play/stop coordination, and runtime handshake behavior.
|
||||
|
||||
### Integration Tests
|
||||
- Run compiler pipeline integration tests that cover `analyze`, `compile`, and `build`.
|
||||
- Run shipper/build integration tests that exercise `StudioShipperService`.
|
||||
- Run runtime/debug integration or coordinator tests that validate play/stop behavior.
|
||||
|
||||
### Manual Verification
|
||||
- Trigger Studio build flow and confirm artifact generation still works.
|
||||
- Trigger Studio play flow and confirm runtime launch/stop still works.
|
||||
- Open Debug and Shipper workspaces and confirm they remain operational.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] `prometeu-lsp` is no longer part of the build graph.
|
||||
- [ ] `prometeu-vfs` is no longer part of the build graph.
|
||||
- [ ] No production Studio class imports legacy `LSP` or `VFS` module types.
|
||||
- [ ] Compiler and shipper build flows still work.
|
||||
- [ ] Play/run/debug flows still work without the removed modules.
|
||||
|
||||
## Dependencies
|
||||
|
||||
- `DEC-0031` accepted and normatively locked.
|
||||
- Shell/session cleanup completed enough that no surviving production code still requires legacy `LSP`/`VFS` types.
|
||||
|
||||
## Risks
|
||||
|
||||
- Hidden transitive dependencies may keep the build graph coupled to removed modules longer than expected.
|
||||
- Runtime or debug flows may have indirect event or session assumptions not obvious from imports alone.
|
||||
- Deleting modules too early may obscure compile errors that should instead be fixed in surviving Studio code first.
|
||||
|
||||
+91
@@ -0,0 +1,91 @@
|
||||
---
|
||||
id: PLN-0064
|
||||
ticket: studio-editor-workspace-cleanup
|
||||
title: Normative Test and Lesson Cleanup for Editor Stack Removal
|
||||
status: open
|
||||
created: 2026-05-05
|
||||
completed:
|
||||
tags: [studio, editor, cleanup, docs, tests, lessons]
|
||||
---
|
||||
|
||||
## Objective
|
||||
|
||||
Remove or revise the normative documentation, tests, lessons, and user-facing resources that describe the embedded editor stack as a current Studio surface.
|
||||
|
||||
## Background
|
||||
|
||||
`DEC-0031` treats the editor stack removal as both code cleanup and normative cleanup. The repository currently contains active specs, README entries, i18n resources, and lessons that define `Code Editor`, `prometeu-vfs`, and the integrated semantic-read phase as active architecture.
|
||||
|
||||
## Scope
|
||||
|
||||
### Included
|
||||
- Remove or rewrite Studio specs dedicated to the embedded editor stack.
|
||||
- Update the Studio specs index and README.
|
||||
- Remove or archive editor/LSP/VFS-specific tests that are no longer valid.
|
||||
- Reclassify legacy lessons and references so they are not presented as active guidance.
|
||||
- Remove user-facing i18n strings that only existed for the editor stack.
|
||||
|
||||
### Excluded
|
||||
- Implementation of shell/session/module cleanup itself.
|
||||
- Future specs for the replacement backend or replacement external-editor strategy.
|
||||
|
||||
## Execution Steps
|
||||
|
||||
### Step 1 - Clean normative Studio specs
|
||||
|
||||
**What:** Remove or replace specs that define the embedded editor stack as active architecture.
|
||||
**How:** Delete or explicitly retire the `Code Editor`, `Project Document VFS`, and `Integrated LSP Semantic Read Phase` specs, then rewrite any remaining Studio README/index material so it no longer points to dead architecture.
|
||||
**File(s):** `docs/specs/studio/5. Code Editor Workspace Specification.md`, `docs/specs/studio/6. Project Document VFS Specification.md`, `docs/specs/studio/7. Integrated LSP Semantic Read Phase Specification.md`, `docs/specs/studio/README.md`.
|
||||
|
||||
### Step 2 - Clean user-facing resources and shell references
|
||||
|
||||
**What:** Remove editor-specific strings, labels, and messages that no longer correspond to product surfaces.
|
||||
**How:** Delete `workspace.code` and `codeEditor.*` message keys and any equivalent theme or resource references still tied to removed editor UI.
|
||||
**File(s):** `prometeu-studio/src/main/resources/i18n/messages.properties`, any directly related theme or resource files.
|
||||
|
||||
### Step 3 - Clean tests and update surviving expectations
|
||||
|
||||
**What:** Remove tests whose sole purpose was validating the editor stack and update remaining tests to stop expecting that stack.
|
||||
**How:** Delete or rewrite tests for editor workspace behavior, legacy `LSP`, legacy `VFS`, session expectations, and any shell assertions that still require the editor workspace.
|
||||
**File(s):** `prometeu-studio/src/test/java/p/studio/projectsessions/**`, editor-related tests, `prometeu-lsp/**/test/**`, `prometeu-vfs/**/test/**`, any shell-level tests affected by workspace removal.
|
||||
|
||||
### Step 4 - Reclassify lessons and historical references
|
||||
|
||||
**What:** Ensure discussion lessons remain historically useful without being mistaken for current architecture.
|
||||
**How:** Review the lessons and references tied to editor/VFS/LSP waves and either archive them, mark them as legacy, or update index/readme material so they are not treated as active operational guidance.
|
||||
**File(s):** affected files under `discussion/lessons/DSC-0010*`, `DSC-0012*`, `DSC-0013*`, `DSC-0014*`, `DSC-0016*`, `DSC-0017*`, `DSC-0020*`, `DSC-0021*`, plus any summary/index surfaces that present them.
|
||||
|
||||
## Test Requirements
|
||||
|
||||
### Unit Tests
|
||||
- Ensure no surviving test suite still references removed editor stack types or message keys.
|
||||
- Add assertions where needed that remaining shell/resource state is internally consistent.
|
||||
|
||||
### Integration Tests
|
||||
- Validate the Studio docs/spec tree remains internally linked after removal or retirement of the editor specs.
|
||||
- Validate the build/test graph no longer includes editor-stack-only suites.
|
||||
|
||||
### Manual Verification
|
||||
- Read the Studio spec README and confirm it no longer advertises the removed stack as active.
|
||||
- Inspect project lessons/readme surfaces and confirm editor-stack lessons are clearly historical or retired.
|
||||
- Launch the application and confirm no missing i18n keys or dead UI labels remain.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- [ ] Studio specs no longer define the embedded editor stack as an active surface.
|
||||
- [ ] Studio README/index material no longer points to removed editor/VFS/LSP architecture as current.
|
||||
- [ ] Editor-specific i18n keys are removed or no longer consumed.
|
||||
- [ ] Obsolete tests are removed or rewritten.
|
||||
- [ ] Historical lessons are clearly demoted from active operational guidance.
|
||||
|
||||
## Dependencies
|
||||
|
||||
- `DEC-0031` accepted and normatively locked.
|
||||
- Sufficient implementation progress that the codebase no longer depends on the removed specs/resources/tests.
|
||||
|
||||
## Risks
|
||||
|
||||
- Removing normative docs too early may temporarily leave the repo without clear current guidance.
|
||||
- Historical lessons may still be valuable; deleting them outright could lose context that should instead be reclassified.
|
||||
- Partial cleanup can leave broken links or missing i18n keys that only appear at runtime.
|
||||
|
||||
Reference in New Issue
Block a user