bQUARKz
9458312d73
Add PBS find-references as the request-local inverse of definition identity on FrontendLanguageService. Usage sites are identifier tokens whose definition locations intersect the cursor set. Empty results stay honest when definition is empty, including virtual stdlib paths. Honor includeDeclaration in the LSP bridge. Housekeep DSC-0040 with LSN-0069.
Prometeu Studio
Prometeu Studio is the desktop development environment for the Prometeu toolchain.
This repository packages the Studio shell together with the embedded services it depends on: compiler pipeline integration, asset packing, runtime/debug orchestration, and project-local Studio state. The current implementation is a Java/JavaFX multi-module Gradle build.
What Lives Here
The root project is a monorepo with these main areas:
prometeu-app: JavaFX application entry point (p.studio.App).prometeu-studio: Studio UI, workspaces, project session lifecycle, play/stop flow, and debugger-facing surfaces.prometeu-packer: embedded packer APIs and implementation used by Studio.prometeu-compiler: compiler core, build pipeline, frontend APIs, and the PBS frontend.prometeu-infra: shared infrastructure used across modules.docs/: normative specifications and architectural references.discussion/: workflow artifacts for agendas, decisions, plans, and lessons.test-projects/: sample workspaces used for local development and tests.
Current Product Shape
The Studio shell currently organizes the product around three workspaces:
- Assets
- Debug
- Shipper
At runtime, the app boots an embedded packer, restores project-local Studio state, and opens the Studio launcher window. Project creation currently scaffolds a Prometeu workspace with prometeu.json, src/, assets/, build/, cartridge/, .workspace/, and local Studio metadata.
Requirements
- JDK 21 or newer recommended for local development
- Gradle wrapper (
./gradlew) included in the repository - A desktop environment capable of running JavaFX
Common Commands
Run the full project graph listing:
./gradlew projects
Run the desktop application:
./gradlew :prometeu-app:run
Run the test suite:
./gradlew test
Generate the aggregated coverage report:
./gradlew jacocoTestReport
Repository Reading Guide
If you are new to the codebase, this order is usually the fastest path:
- Start at
prometeu-appto see application bootstrap. - Read
prometeu-studiofor the shell, workspaces, and user-facing flows. - Read
prometeu-packerfor asset and packaging boundaries. - Read
prometeu-compilerwhen you need compiler or PBS language behavior.
Specs And Architecture
Important reference surfaces:
docs/specs/compiler/: shared compiler specificationsdocs/specs/packer/: packer specificationsdocs/vm-arch/: VM and ISA architecture references
These documents are the long-term normative source for behavior and contracts. When code and docs diverge, fix the divergence explicitly instead of relying on tribal knowledge.