discussion/index.ndjson

@@ -8,7 +8,7 @@
 {"type":"discussion","id":"DSC-0059","status":"open","ticket":"multi-frontend-common-lifecycle","title":"Extrair lifecycle comum das responsabilidades do frontend PBS","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","compiler-pbs","lifecycle","backend","multi-frontend"],"agendas":[{"id":"AGD-0062","file":"AGD-0062-multi-frontend-common-lifecycle.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
 {"type":"discussion","id":"DSC-0058","status":"open","ticket":"multi-frontend-serializable-ir","title":"Manter a IR comum serializavel por design","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","ir","backend","serialization","multi-frontend"],"agendas":[{"id":"AGD-0061","file":"AGD-0061-multi-frontend-serializable-ir.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
 {"type":"discussion","id":"DSC-0057","status":"open","ticket":"multi-frontend-frontend-backend-contract","title":"Estabilizar contrato entre frontend e backend comum","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","compiler-pbs","ir","backend","multi-frontend"],"agendas":[{"id":"AGD-0060","file":"AGD-0060-multi-frontend-frontend-backend-contract.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}
-{"type":"discussion","id":"DSC-0056","status":"in_progress","ticket":"multi-frontend-remove-pbs-branches","title":"Generalizar o contrato LSP/editorial para frontends","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","compiler-pbs","studio","frontend","coupling","multi-frontend"],"agendas":[{"id":"AGD-0059","file":"AGD-0059-multi-frontend-remove-pbs-branches.md","status":"accepted","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[{"id":"DEC-0042","file":"DEC-0042-frontend-editorial-language-service-contract-for-lsp.md","status":"accepted","created_at":"2026-07-15","updated_at":"2026-07-15","ref_agenda":"AGD-0059"}],"plans":[{"id":"PLN-0111","file":"PLN-0111-define-generic-frontend-editorial-dtos-and-capability-surface.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0112","file":"PLN-0112-migrate-semantic-tokens-to-generic-frontend-language-service.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0113","file":"PLN-0113-migrate-completion-to-generic-frontend-models.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0114","file":"PLN-0114-migrate-hover-and-documentation-to-generic-frontend-models.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0115","file":"PLN-0115-migrate-signature-help-to-generic-frontend-models.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0116","file":"PLN-0116-remove-pbs-imports-from-common-lsp-and-add-boundary-coverage.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]}],"lessons":[]}
+{"type":"discussion","id":"DSC-0056","status":"in_progress","ticket":"multi-frontend-remove-pbs-branches","title":"Generalizar o contrato LSP/editorial para frontends","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","compiler-pbs","studio","frontend","coupling","multi-frontend"],"agendas":[{"id":"AGD-0059","file":"AGD-0059-multi-frontend-remove-pbs-branches.md","status":"accepted","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[{"id":"DEC-0042","file":"DEC-0042-frontend-editorial-language-service-contract-for-lsp.md","status":"accepted","created_at":"2026-07-15","updated_at":"2026-07-15","ref_agenda":"AGD-0059"}],"plans":[{"id":"PLN-0111","file":"PLN-0111-define-generic-frontend-editorial-dtos-and-capability-surface.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0112","file":"PLN-0112-migrate-semantic-tokens-to-generic-frontend-language-service.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0113","file":"PLN-0113-migrate-completion-to-generic-frontend-models.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0114","file":"PLN-0114-migrate-hover-and-documentation-to-generic-frontend-models.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0115","file":"PLN-0115-migrate-signature-help-to-generic-frontend-models.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]},{"id":"PLN-0116","file":"PLN-0116-remove-pbs-imports-from-common-lsp-and-add-boundary-coverage.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15","ref_decisions":["DEC-0042"]}],"lessons":[]}
 {"type":"discussion","id":"DSC-0055","status":"done","ticket":"multi-frontend-compiler-vs-language-services","title":"Separar compilacao de servicos editoriais de frontend","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","studio","lsp","editor","frontend","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0056","file":"discussion/lessons/DSC-0055-multi-frontend-compiler-vs-language-services/LSN-0056-compile-first-frontends-with-optional-editorial-capabilities.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15"}]}
 {"type":"discussion","id":"DSC-0054","status":"done","ticket":"multi-frontend-provider-contract","title":"Introduzir provider completo de frontend","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["compiler","compiler-general","studio","frontend","registry","multi-frontend"],"agendas":[],"decisions":[],"plans":[],"lessons":[{"id":"LSN-0055","file":"discussion/lessons/DSC-0054-multi-frontend-provider-contract/LSN-0055-static-frontend-providers-before-plugin-architecture.md","status":"done","created_at":"2026-07-15","updated_at":"2026-07-15"}]}
 {"type":"discussion","id":"DSC-0053","status":"open","ticket":"pbs-lsp-call-and-type-hierarchy","title":"PBS LSP Call and Type Hierarchy","created_at":"2026-07-15","updated_at":"2026-07-15","tags":["studio","lsp","vscode","compiler-pbs","editor","call-hierarchy","type-hierarchy"],"agendas":[{"id":"AGD-0056","file":"AGD-0056-pbs-lsp-call-and-type-hierarchy.md","status":"open","created_at":"2026-07-15","updated_at":"2026-07-15"}],"decisions":[],"plans":[],"lessons":[]}

discussion/workflow/plans/PLN-0114-migrate-hover-and-documentation-to-generic-frontend-models.md

@@ -2,8 +2,9 @@
 id: PLN-0114
 ticket: multi-frontend-remove-pbs-branches
 title: Migrate hover and documentation to generic frontend models
-status: open
+status: done
 created: 2026-07-15
+completed: 2026-07-15
 ref_decisions: [DEC-0042]
 tags: [compiler, compiler-general, compiler-pbs, studio, frontend, coupling, multi-frontend]
 ---
@@ -70,37 +71,3 @@ Migrate LSP hover handling to generic frontend hover models while preserving PBS
 - `prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/PBSFrontendLanguageService.java`
 - `prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/compiler/CompilerLanguageServiceBridge.java`
 - Hover-related tests.
-
-TBD.
-
-## Objective
-
-TBD.
-
-## Dependencies
-
-TBD.
-
-## Scope
-
-TBD.
-
-## Non-Goals
-
-TBD.
-
-## Execution Method
-
-TBD.
-
-## Acceptance Criteria
-
-TBD.
-
-## Tests
-
-TBD.
-
-## Affected Artifacts
-
-TBD.

prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/PBSFrontendLanguageService.java

@@ -10,8 +10,11 @@ import p.studio.compiler.pbs.semantics.PbsEditorialSymbolKind;
 import p.studio.compiler.pbs.semantics.PbsEditorialSupportService;
 import p.studio.compiler.services.FrontendCompletionCandidate;
 import p.studio.compiler.services.FrontendDocumentRequest;
+import p.studio.compiler.services.FrontendDocumentation;
 import p.studio.compiler.services.FrontendEditorialContext;
+import p.studio.compiler.services.FrontendHover;
 import p.studio.compiler.services.FrontendLanguageService;
+import p.studio.compiler.services.FrontendSignature;
 import p.studio.compiler.services.FrontendSymbolKind;
 import p.studio.utilities.structures.ReadOnlyList;
 
@@ -78,6 +81,30 @@ public final class PBSFrontendLanguageService implements FrontendLanguageService
         return editorialSupportService.hover(sourceText, ast, supplementalTopDecls, feSurfaceContext, offset);
     }
 
+    @Override
+    public Optional<FrontendHover> hover(
+            final FrontendDocumentRequest request,
+            final FrontendEditorialContext editorialContext,
+            final int offset) {
+        if (request == null
+                || editorialContext == null
+                || !(editorialContext.syntaxTree() instanceof PbsAst.File ast)
+                || !(editorialContext.supplementalDeclarations() instanceof ReadOnlyList<?> supplementalTopDecls)
+                || !(editorialContext.semanticContext() instanceof FESurfaceContext feSurfaceContext)) {
+            return Optional.empty();
+        }
+
+        @SuppressWarnings("unchecked")
+        final ReadOnlyList<PbsAst.TopDecl> typedSupplementalTopDecls =
+                (ReadOnlyList<PbsAst.TopDecl>) supplementalTopDecls;
+        return hover(
+                request.documentText(),
+                ast,
+                typedSupplementalTopDecls,
+                feSurfaceContext,
+                offset).map(this::toFrontendHover);
+    }
+
     public Optional<PbsEditorialSignatureHelp> signatureHelp(
             final String sourceText,
             final PbsAst.File ast,
@@ -105,6 +132,18 @@ public final class PBSFrontendLanguageService implements FrontendLanguageService
                 candidate.origin());
     }
 
+    private FrontendHover toFrontendHover(final PbsEditorialResolvedSymbol symbol) {
+        return new FrontendHover(
+                symbol.displayName(),
+                toFrontendSymbolKind(symbol.kind()),
+                symbol.detail(),
+                symbol.origin(),
+                symbol.signatures().stream()
+                        .map(signature -> new FrontendSignature(signature.label(), signature.parameterLabels(), ""))
+                        .toList(),
+                FrontendDocumentation.markdown(symbol.documentation()));
+    }
+
     private FrontendSymbolKind toFrontendSymbolKind(final PbsEditorialSymbolKind kind) {
         return FrontendSymbolKind.valueOf(kind.name());
     }

prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/services/FrontendLanguageService.java

@@ -32,6 +32,13 @@ public interface FrontendLanguageService {
         return Optional.empty();
     }
 
+    default Optional<FrontendHover> hover(
+            final FrontendDocumentRequest request,
+            final FrontendEditorialContext editorialContext,
+            final int offset) {
+        return hover(request, offset);
+    }
+
     default FrontendSignatureHelp signatureHelp(
             final FrontendDocumentRequest request,
             final int offset) {

prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/compiler/CompilerLanguageServiceBridge.java

@@ -9,7 +9,9 @@ import p.studio.compiler.pbs.semantics.*;
 import p.studio.compiler.services.FrontendCompletionCandidate;
 import p.studio.compiler.services.FrontendDocumentRequest;
 import p.studio.compiler.services.FrontendEditorialContext;
+import p.studio.compiler.services.FrontendHover;
 import p.studio.compiler.services.FrontendProvider;
+import p.studio.compiler.services.FrontendSignature;
 import p.studio.compiler.services.FrontendSymbolKind;
 import p.studio.compiler.services.PBSFrontendPhaseService;
 import p.studio.compiler.source.identifiers.FileId;
@@ -111,18 +113,25 @@ public final class CompilerLanguageServiceBridge implements LanguageServiceBridg
             final int line,
             final int character) {
         Objects.requireNonNull(context, "context");
-        final Optional<PBSFrontendLanguageService> languageService = pbsLanguageService(context);
+        final var provider = frontendProvider(context);
+        final var languageService = provider.languageService();
         if (languageService.isEmpty()) {
             return new BaselineHover("No symbol information.");
         }
         return editorialDocument(context, documentUri, text)
                 .flatMap(document -> {
                     final int offset = new DocumentPositionMapper(document.text()).byteOffsetOf(line, character);
-                    return languageService.orElseThrow().hover(
+                    final FrontendDocumentRequest request = new FrontendDocumentRequest(
-                            document.text(),
+                            context.projectRoot(),
+                            normalizeDocumentPath(documentUri),
+                            document.text());
+                    final FrontendEditorialContext editorialContext = new FrontendEditorialContext(
                             document.ast(),
                             document.supplementalTopDecls(),
-                            document.feSurfaceContext(),
+                            document.feSurfaceContext());
+                    return languageService.orElseThrow().hover(
+                            request,
+                            editorialContext,
                             offset);
                 })
                 .map(symbol -> new BaselineHover(formatHoverMarkdown(symbol)))
@@ -408,9 +417,9 @@ public final class CompilerLanguageServiceBridge implements LanguageServiceBridg
         };
     }
 
-    private String formatHoverMarkdown(final PbsEditorialResolvedSymbol symbol) {
+    private String formatHoverMarkdown(final FrontendHover symbol) {
         final StringBuilder markdown = new StringBuilder();
-        final List<PbsEditorialSignature> signatures = symbol.signatures();
+        final List<FrontendSignature> signatures = symbol.signatures();
         if (!signatures.isEmpty()) {
             markdown.append("```pbs\n");
             for (int index = 0; index < signatures.size(); index += 1) {
@@ -436,7 +445,7 @@ public final class CompilerLanguageServiceBridge implements LanguageServiceBridg
             markdown.append(" from `").append(symbol.origin()).append('`');
         }
         if (!symbol.documentation().isBlank()) {
-            markdown.append("\n\n").append(symbol.documentation());
+            markdown.append("\n\n").append(symbol.documentation().text());
         }
         return markdown.toString();
     }