prometeu-studio/discussion/workflow/plans/PLN-0043-debug-workspace-first-wave-surface.md

id	ticket	title	status	created	completed	tags
PLN-0043	studio-debugger-workspace-integration	Ordered Plan 3 - First-wave DebugWorkspace registration and temporary execution surface	review	2026-04-06		studio debugger workspace logs shell

Objective

Register a native DebugWorkspace in Studio and provide a first-wave temporary execution surface that consumes shared session state and merged logs.

Background

DEC-0022 requires a real native workspace, not an external launcher. DEC-0021 requires Play to navigate toward the debugger destination at the start of execution.

This plan intentionally keeps the UI crude and execution-focused.

Scope

Included

• Register a concrete DebugWorkspace in the Studio shell.
• Consume the shared session/service boundary from PLN-0042.
• Render simple session state and a simple merged log sink with visible source labels.
• Provide a temporary but native in-Studio execution destination.

Excluded

• Polished final debugger UX.
• Rich manual connect/disconnect controls.
• Profiler behavior.
• Standalone debugger bootstrap embedding.

Execution Steps

Step 1 - Register the workspace in the shell

What: Make WorkspaceId.DEBUG point to a real workspace implementation. How: Add and register a native DebugWorkspace that follows Studio workspace lifecycle and event-bus rules. File(s): prometeu-studio/src/main/java/p/studio/window/MainView.java, prometeu-studio/src/main/java/p/studio/workspaces/.../DebugWorkspace.java (new).

Step 2 - Add first-wave session state presentation

What: Surface the shared session states in the workspace. How: Render a simple status area or equivalent control showing at least idle, preparing, prepare_failed, connecting, running, runtime_failed, and stopped. File(s): DebugWorkspace controls and supporting view models/bindings.

Step 3 - Add the temporary merged log sink

What: Show merged execution logs in a simple native Studio surface. How: Use a list/console style control with visible source labels and lightweight severity treatment. Consume the shared session log stream from PLN-0042. File(s): DebugWorkspace controls, log pane/control package.

Step 4 - Preserve native Studio shape

What: Keep lifecycle, theming, i18n, and shell-navigation compliance. How: Avoid importing the standalone debugger host/bootstrap. Use only Studio-native workspace composition. File(s): workspace implementation, i18n keys, theme/style files as needed.

Test Requirements

Unit Tests

• Verify the workspace can consume session state updates and reflect them.
• Verify merged log entries render with visible source identity.

Integration Tests

• Mount the workspace in a shell test and confirm it registers without throwing.
• Feed synthetic session/log events and confirm the workspace updates without owning the underlying state.

Manual Verification

• Open the Debug workspace from the Studio shell.
• Confirm session states and merged logs are visible in a simple but usable surface.

Acceptance Criteria

• WorkspaceId.DEBUG resolves to a real native workspace.
• The workspace shows shared execution state.
• The workspace shows merged logs with visible source identity.
• The implementation stays within native Studio workspace boundaries.

Dependencies

• Accepted DEC-0022.
• PLN-0042 shared execution session and log contracts.

Risks

• The first-wave UI may accidentally hardcode temporary choices that later feel permanent.
• Workspace ownership may drift into session ownership if bindings are not kept one-way.