Select the Jenkins JDK25 tool for all pipeline stages. Commit and push explicitly requested by Nilton. Validation: git diff --check passed; pipeline execution remains with Jenkins.
Prometeu Studio
Prometeu Studio is the desktop development environment for the Prometeu toolchain. It combines a JavaFX application with compiler integration, asset packing, project services and runtime orchestration in a multi-module Java/Gradle build.
Requirements
- JDK 25 for compilation, tests and the bundled application runtime
- The included Gradle wrapper (Gradle 9.3.1)
- A desktop environment capable of running JavaFX
- A qualified native Prometeu runtime installation for running games
Getting Started
Run these commands from the Studio repository root:
./gradlew :prometeu-app:run
Open an existing project from the project chooser and select a qualified runtime installation. Use Play, Pause, Resume and Stop to run the game inside Studio. Games with saves require an existing development save image or an explicitly disposable session. Close the project before opening another.
The default frontend is prometeu-studio-ui-javafx-2. It provides project opening
and integrated Play; editors, Assets/DEV/Shipper workspaces and MCP grant controls
are outside its current UI. Play prepares a cartridge directory for execution;
distribution/export is a separate concern.
See the development guide for installation, runtime qualification, IntelliJ setup, MCP integration and integration test commands. The integrated Play specification defines execution, input and save behavior.
Build and Test
./gradlew build
./gradlew test
./gradlew jacocoTestReport
test runs unit tests and excludes JUnit @Tag("integration"). The aggregated
JaCoCo report uses unit test results. Process, network and desktop checks have
separate opt-in commands.
Stage a complete installation with its bundled Java runtime:
./gradlew :prometeu-app:stageStudioInstallation
The default installation root is
~/Library/Application Support/Prometeu/Studio; current selects its active
version. See installation and development
for an isolated development installation.
Repository Structure
| Area | Responsibility |
|---|---|
prometeu-app |
Spring Boot composition, concrete adapters, packaging and the p.studio.app.StudioLauncher entry point |
prometeu-studio-api |
Toolkit-neutral Studio contracts and operations |
prometeu-studio-core |
JavaFX-free project, session, asset, shipper and execution services |
prometeu-studio-ui-javafx-2 |
Default frontend and presentation foundation |
prometeu-studio-ui-javafx |
Previous frontend retained for adapter compatibility checks |
prometeu-compiler |
Compiler core, build pipeline, frontend APIs and PBS frontend |
prometeu-packer |
Asset packing APIs and implementation |
prometeu-infra |
Shared infrastructure |
test-projects |
Sample projects and integration fixtures |
docs |
Technical guides, specifications and architecture references |
discussion/lessons |
Published engineering lessons and their assets |
Run ./gradlew projects to list the complete module graph.
Start with prometeu-app for application bootstrap, then read
prometeu-studio-api and prometeu-studio-core for contracts and services.
The JavaFX 2 module guide covers the current
frontend. Follow the compiler and packer modules for their respective pipelines.
Documentation
- Development guide: installation, MCP, troubleshooting and integration checks
- Specification guide: domain ownership and reading order
- Studio: application, services and integration contracts
- Compiler: shared compiler contracts
- PBS: language and SDK
- Packer: asset and packaging contracts
- VM architecture: VM/ISA references and provenance
- VS Code extension: language tooling and external source navigation
Engineering discussions, decisions, plans, build/acceptance results and pending investigations belong to the enclosing Prometeu Engineering workspace in AI Engineering. See AGENTS.md before contributing.