diff --git a/.ai-engineering/ai-engineering.yaml b/.ai-engineering/ai-engineering.yaml index 1fc3577..c3fdce1 100644 --- a/.ai-engineering/ai-engineering.yaml +++ b/.ai-engineering/ai-engineering.yaml @@ -18,7 +18,7 @@ repositories: language: null access: read: true - edit: false + edit: true validationCommands: [] agents: general: diff --git a/.ai-engineering/works/.sequence.yaml b/.ai-engineering/works/.sequence.yaml index 08303c4..09e8881 100644 --- a/.ai-engineering/works/.sequence.yaml +++ b/.ai-engineering/works/.sequence.yaml @@ -1,3 +1,3 @@ --- schemaVersion: 2 -lastWork: "0012" +lastWork: "0013" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/artifact.yaml new file mode 100644 index 0000000..4fb5e08 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0001" +workId: "WRK-0013" +origin: "Inspeção estática do repositório Studio fa37d0d0c7d9f8ea33ea630571ed6117581a1958\ + \ e referências primárias em 2026-11-17" +purpose: "Proveniência, fingerprints, catálogo MCP, métricas e limites da primeira\ + \ análise UX/UI" +path: "artifacts/evidence/ART-0001/payload" +sha256: "15f799dd254777ac7356d1faa5809e8a882a918ace053beaec9632a24d2d9dd9" +size: 26066 +author: "codex" +createdAt: "2026-11-17T09:55:06.978878Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/payload new file mode 100644 index 0000000..550edbf --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0001/payload @@ -0,0 +1,178 @@ +# WRK-0013 — evidências da inspeção inicial + +Inspeção estática em 2026-11-17T09:55:05.787434+00:00 + +## Proveniência + +`git -C . rev-parse HEAD` +```text +e727dfb55fdd1e174bfc32e5f67a645cb225a2f0 +``` +`git -C . status --short` +```text +M .ai-engineering/works/.sequence.yaml +?? .ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/ +``` +`git -C studio rev-parse HEAD` +```text +fa37d0d0c7d9f8ea33ea630571ed6117581a1958 +``` +`git -C studio status --short` +```text +(sem saída) +``` + +## Fontes e impressões digitais + +Caminhos relativos à raiz Prometeu. Referências históricas não são testes executados agora. + +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java` — 213 linhas; SHA-256 `342e545a4a5853dc8f000f1b5ca612fe7e108b821cb9bd714954e98f290147e4`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/WorkspaceHost.java` — 56 linhas; SHA-256 `c13dad7ad3b5d22ce6f24986b5f3ea7ea3e2cf186fdf42b1c32e4e5b39b5d76e`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/StudioWorkspaceLifecycleSupport.java` — 64 linhas; SHA-256 `9001f5fb4fa55fdfda97eedbd0a4168066c2ca6c3f5de5828dce30d7d8b9bf22`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetWorkspace.java` — 286 linhas; SHA-256 `c1abaacbc083fd0f0767c46405c0c7f6a5d99b9ad13ae50481ba6c03096b3831`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetAuthoringPane.java` — 48 linhas; SHA-256 `857c5be725da76be35850d595642a2eaf9263b551adf96929f246e8474945dac`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetBatchReview.java` — 75 linhas; SHA-256 `25fb7d5b692b5588b42f71beec23da0fef9d97f5da4f06f478e804300c33b6e0`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/list/AssetListControl.java` — 312 linhas; SHA-256 `0316cad56bfb0ea9b177fdb1bd8e2b4d0bc653244f7e50f85784d03a499c0540`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java` — 863 linhas; SHA-256 `b95ec37e9554f5fc4f6d48dc5cb13357b36cdc476341898c69ed3ac78d5babd5`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/summary/AssetDetailsSummaryControl.java` — 92 linhas; SHA-256 `d7cf29fbcf1b158a1b31184482c16146ceedf1e1d4d7da50b2a95415b718f57e`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/animation/AnimationEditorControl.java` — 127 linhas; SHA-256 `4701d71fc568480a3c204d117a321cd1e398d4b29bdcc4b498396bbe9343d288`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/debug/DebugWorkspace.java` — 121 linhas; SHA-256 `8ef4f0fedf17cea6d3c03f6d493009a792c57c5abaaaa1394aa3ec1e4cc8c30d`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/dev/DevWorkspace.java` — 185 linhas; SHA-256 `4e8df09489c6841348d747fd477fb80f2e0726aa19338698d776e05e51d757cf`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/tests/TestsWorkspace.java` — 140 linhas; SHA-256 `3414161a16ac4be46f521341da126528b2aef24acc6ad56d6c1d04de1e31cc16`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/builder/ShipperWorkspace.java` — 135 linhas; SHA-256 `1a69a0f6818ecca6a667e8467db121406e3ebb2db7799db0cccfd1466fd2d976`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioRightUtilityPanelControl.java` — 46 linhas; SHA-256 `c6915af8ff78a2e85c0b0fd37fe7470a9da5f6fa57b9ee67084f1615f299a058`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioShellMenuBarControl.java` — 43 linhas; SHA-256 `3d1c49567a36e16df06f201eae0d7225068a35dba9394dbc3a2771942a37e114`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/WorkspaceDockPane.java` — 253 linhas; SHA-256 `47d51e00e8ba3ae31207db21bd69f61d9e897a6b3e7360d0da1aa8d4592f6279`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/events/StudioWorkspaceEventBus.java` — 31 linhas; SHA-256 `394710d9743e3c9153e2087efc31f5c6209e763cf9336d60d821a10c1c03e411`. +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/utilities/ThemeService.java` — 39 linhas; SHA-256 `28b8f2bfbf97c6b8cd7012b67d42104395de01a571c30cb8c272769b7ff16bd3`. +- `studio/prometeu-studio-ui-javafx/src/main/resources/themes/default-prometeu.css` — 1590 linhas; SHA-256 `a32672f4cc7a6daa907b96fbed032c433e5e48656bc5e217888f3c3444fc7147`. +- `studio/prometeu-studio-ui-javafx/build.gradle.kts` — 16 linhas; SHA-256 `480b4c9457e02418d2dfc5c726f3836bba2225e0a38c7f6a1e02310b33ce0548`. +- `studio/gradle/libs.versions.toml` — 35 linhas; SHA-256 `8f73a4524b27bb3d3e93a3dc2bd6a56c5e6cd8c192c38bc0972f7a208eee22ca`. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/assets/AssetAuthoringService.java` — 31 linhas; SHA-256 `1e54099ba43bdbb367f7c608072c4f74922890f4c353c866fcc2a7ca588e0c04`. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/project/ProjectLocalStudioState.java` — 92 linhas; SHA-256 `466bb859ce2e1342a7e5d8ecfd5bee188e003cb05923bb630eca9d1386e7ffc2`. +- `studio/prometeu-studio-core/src/main/java/p/studio/core/session/DefaultAutomationSession.java` — 390 linhas; SHA-256 `f987ba5fbfed0c4f66d2569a62969a492f3cc655430efd8a9a89fa56dd4fc612`. +- `studio/prometeu-app/src/main/java/p/studio/app/StudioApplicationConfiguration.java` — 445 linhas; SHA-256 `8a402338f783888736929be2f0a477857e6d76346415d26cc47c58863890a622`. +- `studio/prometeu-app/src/main/java/p/studio/app/mcp/McpAssetAuthoringTools.java` — 36 linhas; SHA-256 `336afc6c9fd6489197b32bacf95400b47ee9eaa21351d923757571002c64446d`. +- `studio/prometeu-app/src/main/java/p/studio/app/mcp/McpTaskTools.java` — 117 linhas; SHA-256 `6eae888d9a1fd2738e510d31f68197d269b2506e9c52cde251fd8edff258077f`. +- `studio/prometeu-app/src/main/java/p/studio/app/mcp/McpGuestTestTools.java` — 45 linhas; SHA-256 `9f4e1ba4cfd4917e616d6b0310f1b7020f28cb9cc86516460c0f01aa2261dad8`. +- `studio/prometeu-app/src/main/resources/mcp/studio-tools-v1.json` — 8107 linhas; SHA-256 `644460877c87cdbe3bd1a77c7e6f764c24fe9b1c16c0eb237b48675e12e5126e`. +- `studio/docs/specs/studio/1. Studio Shell and Workspace Layout Specification.md` — 164 linhas; SHA-256 `a6367b1a6425f9d2e6832a22cd53ca1a1a0def6c05e8212c2d17695beccbd3c1`. +- `studio/docs/specs/studio/10. DEV and Automation Specification.md` — 487 linhas; SHA-256 `acaa5a570551aea448d8b0d142b9dda79bf5bf37fd5d023c9670faae38186da7`. +- `studio/docs/specs/studio/11. MCP Tools and Project Knowledge Contract.md` — 845 linhas; SHA-256 `b022af034499a9ec22211bf946b5bfc0640b517eb350725d0752f77a5d4d180b`. +- `studio/docs/specs/studio/12. Animation Authoring Specification.md` — 159 linhas; SHA-256 `6b6bf6270380a11dd23bb7c919ab47a81d27e21e9560a351a83bef976f0fa4a4`. +- `studio/docs/specs/studio/2. Studio UI Foundations Specification.md` — 199 linhas; SHA-256 `ac5486c8246cd5dc8f3f7b7589299a62b941739b3bdc94c41706da42b3a18582`. +- `studio/docs/specs/studio/3. Studio Components Module Specification.md` — 66 linhas; SHA-256 `a83aad4c932cdc3ebac65344f57ed5fe5a7f9366107defbee7606850b8f3b893`. +- `studio/docs/specs/studio/4. Assets Workspace Specification.md` — 545 linhas; SHA-256 `0d68cc2d666c6222445e2e1be1572609abc00fc8344e543619875e70c63ff90a`. +- `studio/docs/specs/studio/8. Project-Local Studio State Specification.md` — 303 linhas; SHA-256 `001f8c0419d0a12edbc1d86745091b722540f40a1e4d18bb5c03db94cd0d32bb`. +- `studio/docs/specs/studio/9. Studio Core and Adapter Architecture Specification.md` — 359 linhas; SHA-256 `6001e92c6334e176439bd65e073627e1c6e660f8d19ea7f1d94eabda88752546`. +- `studio/docs/specs/studio/README.md` — 104 linhas; SHA-256 `6821f65531e72dfdcd9945685c26af425b6c671b200193ded10a56735c09c02d`. +- `studio/discussion/lessons/DSC-0031-studio-editor-workspace-cleanup/LSN-0049-remove-the-embedded-editor-stack-before-rebuilding-code-workflows.md` — 84 linhas; SHA-256 `730d190dfa112ec2972d6b55e3b25dc8e170dbd382d956e1bd72e592e29ad9e9`. +- `studio/discussion/lessons/DSC-0032-studio-new-lsp-api-and-v1-boundary/LSN-0047-project-scoped-lsp-boundary-and-protocol-containment.md` — 106 linhas; SHA-256 `739a45cb003d11c27f7d48ea08e6f3207eba0f080743378f7aae64cf4b098e0e`. +- `studio/discussion/lessons/DSC-0067-studio-core-javafx-decoupling/LSN-0075-studio-services-must-outlive-the-current-ui.md` — 103 linhas; SHA-256 `53c095101306144f2c6ffce1bf6685ddf6b11b5f5eeb95fdb8f776e9d3cf10a8`. +- `.ai-engineering/works/WRK-000D-studio-terminal-embutido-no-dev-do-studio/discussions/DSC-0001.md` — 114 linhas; SHA-256 `af39757c986532aa247851edac4ddae51d846bb2cb592adcfd8e00679d80230d`. + +## Métricas reproduzíveis + +- CSS: 1590 linhas; 214 literais hexadecimais distintos. Isso não mede cores percebidas nem prova baixa qualidade visual. +- Arquivos Java de produção no adapter: 124. +- Catálogo MCP: 48 ferramentas declaradas; presença não comprova execução em instalação atual. + +## Catálogo MCP observado + +- `studio_project_context` — Read the open project's manifest-driven language, capability, reference and edit-scope context. Includes current authority/cleanup and last-known runtime observations without a task grant; revoked task identities remain invalid. +- `studio_reference_read` — Read only an indexed local language/SDK reference, paginated in Unicode code points. +- `studio_control_acquire` — Acquire the task after explicit human grant in DEV. Authentication alone is insufficient. +- `studio_control_release` — Invalidate this task, stop managed work and refresh documents before manual return. Return and cleanup are independent; errors retain authority/cleanup in details.control and native cause when available. +- `studio_language_query` — Query project LSP capabilities using saved project files or task-owned read-only external sources. readExternalSource reads an external URI returned by definition; hover and definition can continue inside it. Returns refactoring proposals, never applies edits. Adds analysis and context from the retained didOpen analysis negotiated with prometeuDiagnosticAnalysis v1. Includes saved-source SHA-256 and queryId. 10000 ms execution from admission plus 2000 ms cleanup; language failures use LANGUAGE_QUERY_* or LANGUAGE_SERVER_UNAVAILABLE. Capability fallback is limited with ANALYSIS_DETAILS_UNAVAILABLE. Never infer validity from an empty standard diagnostic array. +- `studio_build_start` — Start saved-source compile and pack; return operationId promptly. Reuse clientRequestId only for identical parameters. Omitted targetId selects production. Declared test targets use exclusive immutable target/build outputs. +- `studio_headless_boot` — Boot the project's known build artifact in one managed headless session. Never accepts an arbitrary cartridge path. Memcard requires an explicit choice and protocol 1.1 capability. Optional memcard prepares media before boot; create never replaces existing media. +- `studio_headless_reset` — reset the task-owned headless session; preserve runtime semantics and task authority. A native memcard refusal preserves the session and structured state for a later explicit decision. Success leaves an UNBOOTED session and stale capture: explicitly boot the same build before advancing. +- `studio_headless_clear_input` — clear_input the task-owned headless session; preserve runtime semantics and task authority. +- `studio_headless_capture` — capture the task-owned headless session; preserve runtime semantics and task authority. +- `studio_headless_state` — state the task-owned headless session; preserve runtime semantics and task authority. +- `studio_headless_fault` — fault the task-owned headless session; preserve runtime semantics and task authority. +- `studio_headless_shutdown` — shutdown the task-owned headless session; preserve runtime semantics and task authority. A native memcard refusal preserves the session and structured state for a later explicit decision. +- `studio_headless_set_input` — Replace normalized input. Omitted controls become false/zero, not a partial patch. +- `studio_headless_advance` — Start bounded frame advancement and return operationId promptly; results include the canonical PNG. Do not blindly retry lost responses. +- `studio_operation_get` — Read a task-local operation by exactly one of operationId or clientRequestId, including known progress, typed result and image. Worker completion (SUCCEEDED) is independent of build approval. Build result adds canonical issues, summary and context; usable buildId requires SUCCESS with all four stages passed. Cancellation remains CANCELLED; final results require workerTerminated. observation is the immutable operation-final checkpoint; currentObservation is a later passive session snapshot. Read native causes and unavailable inspections without parsing diagnostics. Lookup never replays advance. +- `studio_operation_cancel` — Request cancellation of an owned operation. Acknowledgement is not worker termination or task release. +- `studio_headless_memcard_state` — Observe native media, session, dirty RAM, request, IO and recovery state without executing the guest. Requires negotiated protocol 1.1 memcard capability. +- `studio_headless_memcard_mount` — Explicitly open or create media after reset and before boot; create never replaces existing media. Requires negotiated protocol 1.1 memcard capability. +- `studio_headless_memcard_unmount` — Unmount idle media outside a resident game session. Requires negotiated protocol 1.1 memcard capability. +- `studio_headless_memcard_reconcile` — Ask the runtime to revalidate the selected same card while suspended; preserves RAM and continuation. Requires negotiated protocol 1.1 memcard capability. +- `studio_headless_memcard_continue_in_memory` — Explicitly continue a suspended session in RAM through the runtime; no durability claim. Requires negotiated protocol 1.1 memcard capability. +- `studio_animation_query` — List, get, validate or preview canonical bank animation definitions through the same services as the Assets editor. Preview uses explicit ticks and transient palette input; reads never rebind. +- `studio_animation_update` — Save/delete animator definitions or prepare/apply an explicit binding-only rebind. Expected revisions prevent overwrites; only create accepts explicitly null expectedRevision. No arbitrary file paths or extra approval flow. +- `studio_evidence_persist` — Persist the ORIGINAL terminated operation capture; never advances or recaptures. Repeat identical clientRequestId to recover the publication; changed parameters conflict. +- `studio_evidence_import` — Copy a PNG reference from the project or an explicitly human-authorized canonical path. Import NEVER approves a baseline. +- `studio_evidence_compare` — Compare one retained checkpoint using lossless RGBA8. Alpha is explicit; omitted tolerances are exact. ROI/masks are half-open, no clipping or resize. Rejection is distinct from operational failure; diff uses original coordinates. +- `studio_evidence_list` — Read paginated immutable publications, reports and human baseline revisions. Use requestId to recover a lost response without guest execution. +- `studio_evidence_metadata` — Read historical artifact identity/hashes/provenance and separate current staleness. A new authorized task in the same project can read old evidence. +- `studio_evidence_read` — Read a bounded byte range by opaque artifact ID. No arbitrary path download. Length is at most 1 MiB and range must fit the immutable object. +- `studio_evidence_image` — Return the retained canonical PNG directly as MCP image content with metadata and integrity validation. Maximum object size 32 MiB; no extra transport. +- `studio_evidence_delete` — Explicitly delete a publication under current mutation authority. Refuse while another report or baseline references its artifacts or revision. No eviction or automatic baseline changes. +- `studio_tests_targets` — List declared isolated test targets using the common manifest parser. +- `studio_tests_start` — Build an isolated target and run bounded structured tests in a fresh owned process. Explicit media/teardown policy; no personal card fallback. Reuse request identity only with identical full parameters. +- `studio_tests_get` — Read the current test result/progress by exactly one operation or request identity; never replays execution. Final results require actual worker termination. +- `studio_tests_cancel` — Request test cancellation. Query until workerTerminated before treating the result as final. +- `studio_tests_transcript` — Read a bounded immutable transcript page retaining native and producer event identities. Lookup never advances the guest. +- `studio_tests_shutdown` — Explicitly close a retained test runtime after native dirty/pending-data refusal. Discard is never inferred; wait for worker termination before recovery. +- `studio_assets_catalog` — Query the shared project asset catalog with stable references and explicit bounded paging. +- `studio_assets_artifacts` — Read stable glyph artifact identities, public geometry and current fingerprints for scene composition and explicit rebind. Callers do not need to edit native glyph indices. +- `studio_assets_revision` — Read the canonical complete asset-input revision. Copy this returned value into a preview request; never invent its digest. +- `studio_assets_dependencies` — Query declared generated output ownership, dependency edges and current stale state. Does not execute a producer or regenerate outputs. +- `studio_assets_budget` — Query shared bank content, existing/included banks, actual final preload and potential dynamic residency separately. Qualification is bound to exact installed executables; unknown is explicit. This wave qualifies glyph/scene only. +- `studio_assets_preview` — Prepare and retain a revision-checked asset batch preview without changing published project inputs. Explicit PNG source, palette and glyph/scene operations only; external PNG grants require prior human selection. Incompatible references require explicit rebind. +- `studio_assets_preview_get` — Inspect a retained same-project preview under current task authority. +- `studio_assets_commit` — Explicitly publish the reviewed batch under the same task, rechecking project and PNG bytes. Publication is atomic for shared readers and recoverable. Identical retries return applied truth; late cancellation does not roll back a committed batch. +- `studio_assets_result` — Recover the retained batch result after a lost response, including applied/recovered/conflict/cancelled truth. Querying does not replay publication. +- `studio_assets_inspect` — Read canonical bank contract, source files, native palette metadata and full producer diagnostics under current authority. Does not initialize or backfill published identities. + +## Índice de trechos verificados + +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:131` — `new StudioWorkspaceRailItem<>(WorkspaceId.ASSETS, "📦", i18n.bind(I18n.WORKSPACE_ASSETS)),` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:132` — `new StudioWorkspaceRailItem<>(WorkspaceId.DEBUG, "🎮", i18n.bind(I18n.WORKSPACE_DEBUG)),` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:133` — `new StudioWorkspaceRailItem<>(WorkspaceId.DEV, "◇", i18n.bind(I18n.WORKSPACE_DEV)),` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:134` — `new StudioWorkspaceRailItem<>(WorkspaceId.TESTS, "✓", i18n.bind(I18n.WORKSPACE_TESTS)),` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:135` — `new StudioWorkspaceRailItem<>(WorkspaceId.SHIPPER, "⚙️", i18n.bind(I18n.WORKSPACE_SHIPPER))` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java:140` — `setRight(new StudioRightUtilityPanelControl(` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetWorkspace.java:151` — `if (splitPane == null || pendingAssetsLayoutState.contentSplitDividers().isEmpty()) {` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetWorkspace.java:155` — `splitPane.setDividerPositions(pendingAssetsLayoutState.contentSplitDividers().stream()` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetAuthoringPane.java:18` — `private final Label summary=new Label("Loading asset budget…");private final TextArea facts=new TextArea();private final ComboBox bank=new ComboBox<>();` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java:123` — `@Override public java.util.concurrent.CompletionStage refreshFromDisk() {` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java:131` — `var animationRefresh = animationEditor == null ? java.util.concurrent.CompletableFuture.completedFuture(null) : animationEditor.refreshFromDisk();` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java:365` — `detailsContent.getChildren().setAll(buildDetailsSections());` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java:372` — `private Node[] buildDetailsSections() {` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/animation/AnimationEditorControl.java:54` — `var documentRow=row(save,button("Validate draft",this::validateDraft),button("Reload",this::refreshFromDisk),button("Read JSON draft",this::readJsonDraft),status);` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/animation/AnimationEditorControl.java:75` — `setDisable(next==null);if(next!=null)refreshFromDisk();return true;` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/animation/AnimationEditorControl.java:124` — `@Override public CompletionStage refreshFromDisk(){return fx(()->{if(busy)return pending.thenCompose(v->refreshFromDisk());if(bank==null)return CompletableFuture.completedFuture(null);clock.stop();play.setSelected(false);return call(AnimationService.Request.get(project,bank),response->loaded(response.view()));}).thenCompose(v->v);}` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/tests/TestsWorkspace.java:72` — `polling=new Timeline(new KeyFrame(Duration.millis(300),event->refresh()));polling.setCycleCount(Animation.INDEFINITE);controls();` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/builder/ShipperWorkspace.java:76` — `buildOperation.cancel();` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioRightUtilityPanelControl.java:22` — `setPrefWidth(280);` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioShellMenuBarControl.java:20` — `newProjectItem.setOnAction(ignored -> { });` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioShellMenuBarControl.java:24` — `openItem.setOnAction(ignored -> { });` +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/controls/shell/StudioShellMenuBarControl.java:28` — `saveItem.setOnAction(ignored -> { });` +- `studio/prometeu-studio-api/src/main/java/p/studio/api/project/ProjectLocalStudioState.java:27` — `public record ShellLayout(AssetsLayoutState assetsLayout) {` +- `studio/prometeu-studio-api/src/main/java/p/studio/api/project/ProjectLocalStudioState.java:41` — `public record AssetsLayoutState(List contentSplitDividers) {` +- `studio/prometeu-studio-api/src/main/java/p/studio/api/project/ProjectLocalStudioState.java:43` — `contentSplitDividers = normalizeDividerPositions(contentSplitDividers);` +- `studio/prometeu-studio-api/src/main/java/p/studio/api/project/ProjectLocalStudioState.java:51` — `return new AssetsLayoutState(contentSplitDividers);` +- `studio/prometeu-studio-core/src/main/java/p/studio/core/session/DefaultAutomationSession.java:249` — `return p.refreshFromDisk();` + +## Limites + +- Nenhum build, teste ou sessão gráfica executado nesta análise. Legibilidade, ergonomia, DPI, performance e frequência real de uso requerem observação. +- Busca por WatchService/watchService e eventos gerais de alteração de assets na API/Core/App não localizou um canal geral. O handoff de retorno possui refreshFromDisk. A busca não prova ausência de todos os mecanismos possíveis. +- Busca por org.fxmisc/CodeArea/InlineCssTextArea/StyleClassedTextArea na produção JavaFX: sem matches. RichTextFX continua declarado como dependência. +- Specs 1–4 têm cabeçalho Draft e declaram consolidar decisões aceitas; não inferir autorização de revisá-las. A lista de workspaces na lesson DEC-0031 é histórica. +- Somente registros AIE escritos; implementação e specs do Studio intactas. + +## Referências externas primárias consultadas + +- https://docs.godotengine.org/en/stable/getting_started/introduction/first_look_at_the_editor.html +- https://docs.godotengine.org/en/stable/tutorials/editor/customizing_editor.html +- https://pixelvision8.github.io/Website/ +- https://github.com/PixelVision8/PixelVision8/wiki +- https://openjfx.io/javadoc/23/javafx.graphics/javafx/scene/doc-files/cssref.html +- https://openjfx.io/javadoc/23/javafx.controls/javafx/scene/control/Control.html + +Contexto de pesquisa, sem evidência de execução do Studio nem aprovação de direção. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/artifact.yaml new file mode 100644 index 0000000..3eb0869 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0002" +workId: "WRK-0013" +origin: "Inspeção estática runtime 2d5735cb13876b3608cd5a90f849ef6823fc1d94 e studio\ + \ fa37d0d0c7d9f8ea33ea630571ed6117581a1958" +purpose: "Fundamentar discussão de editor principal, SceneBank versus scene de jogo,\ + \ dependências e residência de bancos; runtime somente leitura" +path: "artifacts/evidence/ART-0002/payload" +sha256: "d51e3bec9044599afff66193734056dbf9d5b3dcbcdbcb198145c09067f7f5ce" +size: 19244 +author: "codex" +createdAt: "2026-11-17T10:42:53.507712Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/payload new file mode 100644 index 0000000..73227ff --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0002/payload @@ -0,0 +1,463 @@ +# WRK-0013 — inspeção complementar de bancos, maps e composição + +Data UTC: 2026-11-17T10:42:52.544233+00:00 + +Owner de produto: studio. Runtime somente leitura. Sem build, testes ou execução gráfica. + +- runtime: `2d5735cb13876b3608cd5a90f849ef6823fc1d94`; status: limpo +- studio: `fa37d0d0c7d9f8ea33ea630571ed6117581a1958`; status: limpo + +## Fontes e hashes + +- `runtime/docs/specs/runtime/15-asset-management.md` — SHA-256 `0d7eda80c59ffbb7c49340835540bc0dc93aa25d7e74078e03475673bedb8b3a`; 590 linhas. +- `runtime/docs/specs/runtime/04-gfx-peripheral.md` — SHA-256 `fb5837ade0b76df63989f5d724c8bef7247b9851408ba4b6f257acf911be5c85`; 819 linhas. +- `runtime/crates/console/prometeu-hal/src/scene_bank.rs` — SHA-256 `6ba5e4e577389355f2c8678958d23b1c74d266404959966c777798c14dc59a55`; 56 linhas. +- `runtime/crates/console/prometeu-hal/src/scene_layer.rs` — SHA-256 `11cbd34788389d959c0d134251ce9c4b2c499a76228052886a149db5c95db504`; 60 linhas. +- `runtime/crates/console/prometeu-hal/src/tile.rs` — SHA-256 `cd29513a645c79dc4ca1b4a736fe0c54478d189be74b9725e8ea716b632a62b5`; 10 linhas. +- `runtime/crates/console/prometeu-hal/src/glyph_bank.rs` — SHA-256 `caca493e059f5d22324524131a10f14c07542208d3dee52ccefa354e92eb6fc4`; 155 linhas. +- `runtime/crates/console/prometeu-hal/src/sprite.rs` — SHA-256 `9d18df0698cc97431f48bbf5a06f223ab51bf1cd721da89a1126f2c8774b83cb`; 14 linhas. +- `runtime/crates/console/prometeu-drivers/src/memory_banks.rs` — SHA-256 `19a1e6e07db298878018f3aec6ab94c36efda63911d935591a05022fc35d24e0`; 248 linhas. +- `runtime/crates/console/prometeu-drivers/src/frame_composer.rs` — SHA-256 `e108a694bc72ea210bc6a668bdc070f88328456f5f90f550f8db88f0096a79d5`; 1166 linhas. +- `studio/docs/specs/studio/12. Animation Authoring Specification.md` — SHA-256 `6b6bf6270380a11dd23bb7c919ab47a81d27e21e9560a351a83bef976f0fa4a4`; 159 linhas. +- `studio/test-projects/main/src/main.pbs` — SHA-256 `20219dd7b340bbb3d750d684e108cefa75e65a4c10f171fb7b42fedf98b71d9f`; 95 linhas. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/assets/metadata/AssetStudioSceneBankMetadata.java` — SHA-256 `6b1ee951ec8b1bd82d5030946a502414ba41f1ff078266535f2b511b6af3f732`; 40 linhas. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/assets/metadata/AssetStudioSceneLayerBinding.java` — SHA-256 `3adcf8c2fcfa5089714f6c9b2e73033b6345843caeb927f0c1b7e3ece9340099`; 82 linhas. + +## runtime/docs/specs/runtime/15-asset-management.md:9 +```text +9: +10: PROMETEU asset management is bank-centric. +11: +12: Assets are: +13: +14: - cold bytes stored in the cartridge; +15: - described by cartridge metadata; +16: - materialized into host-managed banks; +17: - separate from VM heap ownership. +18: +19: This chapter describes the runtime contract currently visible in the codebase. It is not a full tooling pipeline specification. +20: +21: ## 2 Core Principles +22: +23: 1. asset residency is explicit; +24: 2. asset memory belongs to the machine, not to the VM heap; +25: 3. banks and slots are hardware/runtime concepts; +26: 4. loading and activation are explicit operations; +27: 5. asset memory does not participate in GC. +28: +29: ## 3 Cartridge Asset Artifact +30: +31: The runtime currently consumes one primary cartridge asset artifact: +``` + +## runtime/docs/specs/runtime/15-asset-management.md:179 +```text +179: before they are loaded by the runtime. +180: +181: Palette indices are ordinary indices. Transparency is represented by the alpha +182: channel of the resolved RGBA8888 palette entry, not by reserving index `0`. +183: +184: `palette_id` is valid only when it is lower than the referenced resident glyph +185: bank's `palette_count`. Canonical runtime composition MUST NOT substitute +186: transparent, black, or any other default color for `palette_id >= +187: palette_count`. +188: +189: ### 4.2 `SCENE` asset contract in v1 +190: +191: For `BankType::SCENE`, the v1 runtime-facing contract is: +192: +193: - `codec = NONE` +194: - payload magic is `SCNE` +195: - payload version is `1` +196: - layer count is fixed at `4` +197: - each layer carries its own glyph dependency +198: - the glyph dependency is serialized as canonical `AssetId` using signed 32-bit little-endian width +199: - the payload MUST describe cold asset dependencies only and MUST NOT encode runtime glyph slot topology +200: +201: Even with `codec = NONE`, `SCENE` still has a bank-specific binary contract. The serialized layout is normative and distinct from any transient runtime residency state. +202: +203: #### 4.2.1 Layer Header Layout +204: +205: Each scene layer header is: +206: +207: 1. `flags: u8` +208: 2. `glyph_asset_id: i32` (little-endian) +209: 3. `tile_size: u8` +210: 4. `reserved: u16` +211: 5. `parallax_x: f32` +212: 6. `parallax_y: f32` +213: 7. `width: u32` +214: 8. `height: u32` +215: 9. `tile_count: u32` +216: 10. `reserved: u32` +217: +218: This makes the canonical per-layer header size `32` bytes. +219: +220: Normative rules: +221: +222: - `glyph_asset_id` MUST be interpreted as the cold identity of the glyph dependency for that layer; +223: - `glyph_asset_id` MUST NOT be interpreted as a runtime slot id; +224: - each layer MUST own exactly one glyph dependency reference; +225: - no shared dependency table exists in this contract; +226: - `tile_count` MUST equal `width * height`. +227: +228: #### 4.2.2 Runtime Binding Semantics +229: +230: `SCENE` assets do not own runtime residency. +231: +232: Therefore: +233: +234: - the runtime MUST resolve scene glyph dependencies through runtime-owned residency state; +235: - the runtime MUST maintain a runtime-owned mapping from committed glyph `AssetId` to glyph slot; +236: - scene bind and scene draw MUST consult runtime residency, not serialized slot topology; +237: - a missing scene glyph dependency is not a passive asset-status condition. +238: +239: If a scene glyph dependency cannot be resolved: +240: +241: - `bind_scene` MUST fail as a fatal machine error with clear logging; +242: - draw/composition MUST fail as a fatal machine error with clear logging; +243: - runtime MUST NOT continue scene composition after the missing dependency is detected. +244: +245: ### 4.3 Decoding validation and physical payload completeness +``` + +## runtime/docs/specs/runtime/15-asset-management.md:280 +```text +280: +281: The runtime resolves bank context from `asset_table` using `asset_id`. +282: +283: Internally, the runtime may still use a bank-qualified slot reference such as: +284: +285: ```text +286: SlotRef { bank_type, index } +287: ``` +288: +289: That internal representation is derived from the resolved `AssetEntry`, not supplied by the caller. +290: +291: ### 5.1 Canonical Bank Telemetry +292: +293: The canonical visible bank telemetry contract is exposed by `AssetManager`. +294: +295: The per-bank summary is slot-first and uses this shape: +296: +297: ```text +298: BankTelemetry { +299: bank_type +300: used_slots +301: total_slots +302: } +303: ``` +304: +305: Rules: +306: +307: - the visible contract MUST NOT expose byte-oriented bank occupancy as the canonical summary; +308: - canonical bank names are `GLYPH` and `SOUNDS`; +309: - detailed occupancy inspection remains host-owned and slot-based through slot references, not bank byte totals; +310: - public runtime specs MUST NOT treat `bank.slot_info` or JSON bank inspection payloads as the long-term guest ABI; +311: - any residual byte accounting MAY exist internally, but it is not part of the visible bank telemetry contract. +``` + +## runtime/docs/specs/runtime/15-asset-management.md:340 +```text +340: +341: `open_slice` is the runtime-facing concept for opening a limited view over a payload slice. The runtime must not require the whole `assets.pa` payload to remain resident in RAM as its baseline operating mode. +342: +343: `OP_MODE` selects between direct slice consumption and temporary materialization in memory. +344: +345: For v1: +346: +347: - `OP_MODE` is derived from `codec`/CODEX; +348: - explicit per-asset hinting is not part of the baseline contract. +349: - `TILES` with `codec = NONE` may still stage in memory before bank installation because bank-specific decode expands packed pixel indices into the resident representation. +350: - during the migration window, runtime may accept legacy `RAW` as an alias of `NONE`. +351: +352: The runtime does not treat asset installation as implicit side effect. +353: +354: ## 7 Residency and Ownership +355: +356: Asset banks are host/runtime-owned memory. +357: +358: Therefore: +359: +360: - VM heap does not own asset residency; +361: - GC does not scan asset bank memory; +362: - shutting down a cartridge can release bank residency independently of VM heap behavior. +363: - the runtime must not keep the full `assets.pa` payload resident in RAM as a baseline requirement. +``` + +## runtime/docs/specs/runtime/15-asset-management.md:396 +```text +396: +397: Validation rules: +398: +399: - `preload` is resolved by `asset_id`, not by `asset_name`; +400: - every `preload.asset_id` must exist in the same `asset_table`; +401: - no two preload entries may resolve to the same `(bank_type, slot)` pair; +402: - legacy preload keyed by `asset_name` is invalid for the current contract. +403: +404: Lifecycle rule: +405: +406: - `preload` is boot-time input only; +407: - it does not need to remain live after initialization completes. +408: +409: Bootstrap rule: +410: +411: - invalid preload is a structural cartridge error and must fail cartridge bootstrap before normal execution begins. +412: +413: ## 10 Relationship to Other Specs +414: +415: - [`13-cartridge.md`](13-cartridge.md) defines the cartridge package and the requirement that `assets.pa` carries its own asset header. +416: - [`16-host-abi-and-syscalls.md`](16-host-abi-and-syscalls.md) defines the syscall boundary used to manipulate assets. +417: - [`03-memory-stack-heap-and-allocation.md`](03-memory-stack-heap-and-allocation.md) defines the distinction between VM heap memory and host-owned memory. +418: +419: ## 11 Syscall Surface and Status Policy +420: +421: `asset` follows status-first policy. +422: +423: Fault boundary: +424: +425: - `Trap`: structural ABI misuse (type/arity/capability/shape mismatch); +``` + +## runtime/crates/console/prometeu-hal/src/scene_bank.rs:1 +```text +1: use crate::scene_layer::SceneLayer; +2: +3: #[derive(Clone, Debug)] +4: pub struct SceneBank { +5: pub layers: [SceneLayer; 4], +6: } +``` + +## runtime/crates/console/prometeu-hal/src/scene_layer.rs:1 +```text +1: use crate::asset::AssetId; +2: use crate::glyph_bank::TileSize; +3: use crate::tilemap::TileMap; +4: +5: #[derive(Clone, Copy, Debug)] +6: pub struct ParallaxFactor { +7: pub x: f32, +8: pub y: f32, +9: } +10: +11: #[derive(Clone, Debug)] +12: pub struct SceneLayer { +13: pub active: bool, +14: pub glyph_asset_id: AssetId, +15: pub tile_size: TileSize, +16: pub parallax_factor: ParallaxFactor, +17: pub tilemap: TileMap, +18: } +19: +20: #[cfg(test)] +``` + +## runtime/crates/console/prometeu-hal/src/sprite.rs:1 +```text +1: use crate::glyph::Glyph; +2: +3: #[derive(Clone, Copy, Debug)] +4: pub struct Sprite { +5: pub glyph: Glyph, +6: pub x: i32, +7: pub y: i32, +8: pub layer: u8, +9: pub bank_id: u8, +10: pub active: bool, +11: pub flip_x: bool, +12: pub flip_y: bool, +13: pub priority: u8, +14: } +``` + +## runtime/crates/console/prometeu-drivers/src/memory_banks.rs:72 +```text +72: } +73: +74: impl Default for MemoryBanks { +75: fn default() -> Self { +76: Self::new() +77: } +78: } +79: +80: impl MemoryBanks { +81: /// Creates a new set of memory banks with empty slots. +82: pub fn new() -> Self { +83: Self { +84: glyph_bank_pool: Arc::new(RwLock::new(std::array::from_fn(|_| None))), +85: sound_bank_pool: Arc::new(RwLock::new(std::array::from_fn(|_| None))), +86: scene_bank_pool: Arc::new(RwLock::new(std::array::from_fn(|_| None))), +87: } +88: } +89: } +90: +91: impl GlyphBankPoolAccess for MemoryBanks { +92: fn glyph_bank_slot(&self, slot: usize) -> Option> { +93: let pool = self.glyph_bank_pool.read().unwrap(); +``` + +## runtime/crates/console/prometeu-drivers/src/frame_composer.rs:120 +```text +120: } +121: } +122: +123: pub struct FrameComposer { +124: scene_bank_pool: Arc, +125: glyph_slot_index: GlyphAssetSlotIndex, +126: viewport_width_px: usize, +127: viewport_height_px: usize, +128: active_scene_id: Option, +129: active_scene: Option>, +130: scene_status: SceneStatus, +131: camera_x_px: i32, +132: camera_y_px: i32, +133: cache: Option, +134: resolver: Option, +135: sprite_controller: SpriteController, +136: } +137: +138: #[derive(Clone, Debug, Default, PartialEq, Eq)] +139: pub struct ComposerBuffer { +140: pub bound_scene: Option, +141: pub camera: Camera2D, +142: pub sprites: Vec, +143: pub hud: HudPacket, +144: } +145: +146: impl ComposerBuffer { +147: pub fn close(self) -> Game2DFramePacket { +148: Game2DFramePacket::new( +``` + +## runtime/crates/console/prometeu-drivers/src/frame_composer.rs:215 +```text +215: pub fn bind_scene(&mut self, scene_bank_id: usize) -> bool { +216: let Some(scene) = self.scene_bank_pool.scene_bank_slot(scene_bank_id) else { +217: self.unbind_scene(); +218: return false; +219: }; +220: +221: let _ = self.resolve_glyph_slots(&scene, scene_bank_id, "bind_scene"); +222: +223: let (cache, resolver) = +224: Self::build_scene_runtime(self.viewport_width_px, self.viewport_height_px, &scene); +225: self.active_scene_id = Some(scene_bank_id); +226: self.active_scene = Some(scene); +227: self.scene_status = SceneStatus::Available { scene_bank_id }; +228: self.cache = Some(cache); +229: self.resolver = Some(resolver); +230: true +231: } +``` + +## runtime/crates/console/prometeu-drivers/src/frame_composer.rs:404 +```text +404: fn resolve_glyph_slots( +405: &self, +406: scene: &SceneBank, +407: scene_bank_id: usize, +408: phase: &str, +409: ) -> [usize; 4] { +410: std::array::from_fn(|layer_index| { +411: let layer = &scene.layers[layer_index]; +412: self.glyph_slot_index.glyph_slot_for_asset(layer.glyph_asset_id).unwrap_or_else(|| { +413: panic!( +414: "SCENE dependency fatal during {}: scene_bank_id={}, layer={}, glyph_asset_id={}", +415: phase, scene_bank_id, layer_index, layer.glyph_asset_id +416: ) +417: }) +418: }) +419: } +420: +``` + +## studio/docs/specs/studio/12. Animation Authoring Specification.md:14 +```text +14: +15: Each registered glyph bank can contain animations.studio.json, a JSON UTF-8 +16: sidecar distinct from asset.json and studio.asset.json. Its strict schema is: +17: +18: ```json +19: { +20: "schema_version": 1, +21: "bank_asset_uuid": "", +22: "bindings": [{"artifact_id": "", "glyph_id": 7, +23: "fingerprint": ""}], +24: "animators": [{"id": "hero", "initial_clip": "idle", "clips": [ +25: {"name": "idle", "mode": "loop", "frames": [ +26: {"artifact_id": "", "duration_ticks": 4} +27: ]} +28: ]}] +29: } +30: ``` +31: +32: Animator IDs are unique PBS identifiers matching [A-Za-z_][A-Za-z0-9_]*. Modes +33: are once/loop; frame order matters. Each animator has nonempty named clips; +34: zero animator definitions is allowed. Decode long integers exactly. No palette, +35: position or runtime bank slot is stored. Unknown fields/versions and malformed +36: or duplicate bindings/JSON keys are errors, not fallback triggers. +37: +38: Every referenced artifact must match the containing bank UUID and Packer's current +39: effective glyph ID/fingerprint. Reordering, removal and content replacement produce +40: blocking drift diagnostics. Explicit prepare/apply rebind presents old/new bindings +41: and affected frames, validates the result and requires the expected revision. +42: Never silently retarget by list order or path. Save validates the whole candidate +43: against the current snapshot and uses a revision check plus atomic replacement; +``` + +## studio/docs/specs/studio/12. Animation Authoring Specification.md:56 +```text +56: projects without definitions retain an empty context and compatible entry points. +57: +58: FESurfaceContext carries language-neutral validated snapshots; PBS alone emits +59: virtual modules at @:generated/animations/b_. +60: Factories are create_(bank_id: int) -> result Animator. +61: Reserve generated/animations and reject physical-module collisions. Only registered, +62: build-included banks publish factories. Invalid included definitions block build; +63: never reuse stale generated text. Sort factories by ID, preserve clip/frame order, +64: escape PBS literals and exclude timestamps/absolute paths. Keep generated modules +``` + +## studio/test-projects/main/src/main.pbs:1 +```text +1: import { Log } from @sdk:log; +2: import { Pad, Button, Touch } from @sdk:input; +3: import { Composer } from @sdk:composer; +4: +5: // Preloaded by Packer: Zelda3 -> glyph slot 0, tileset -> glyph slot 1, +6: // tiled2 -> scene slot 0. No separate atlas load is needed. +7: declare global scene_bound: bool = false; +``` + +## studio/test-projects/main/src/main.pbs:27 +```text +27: { +28: // Composer operations run during Frame, after preloads have completed. +29: if (!scene_bound) { +30: let status: int = Composer.bind_scene(0); +31: if (status != 0) { +32: Log.failure("Unable to bind the preloaded scene"); +33: return; +34: } +35: scene_bound = true; +36: } +``` + +## studio/test-projects/main/src/main.pbs:62 +```text +62: } +63: Composer.set_camera(camera_x, 0); +64: Composer.emit_sprite(tile_id, 0, (Touch.x() as int) - 16, (Touch.y() as int) + 8, 2, 0, true, false, 0); +65: +``` + +## Limites e interpretação + +- SceneBank/layers/tilemap atuais representam mapa com quatro layers, não evidenciam um modelo de scene de jogo com entidades/scripts persistidos. +- A busca por struct Entity/GameObject/World, trait Entity/Component, enum Entity e spawn_entity não localizou um framework desses no runtime inspecionado; não é prova universal de ausência de modelos de jogo em bibliotecas externas. +- O composer recebe sprites separadamente da SceneBank; uma scene de autoria mais ampla exigirá contrato próprio de entidades/persistência/projeção. +- Identidade de asset no conteúdo e slot de residência são conceitos separados; o editor futuro não deve serializar slots na SceneBank para imitar o runtime. +- MemoryBanks usa 16 slots por família nesta implementação. A UI deve consumir orçamento/perfil qualificado, não hardcode desse número. +- Metadados de animação usam UUID/artifact identity/fingerprint; índices de glyph e slots têm papéis distintos. +- Não há implementação nova nem proposta aprovada de ECS, formato de scene amplo, geração de código ou mudança de runtime. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/artifact.yaml new file mode 100644 index 0000000..a741b19 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0003" +workId: "WRK-0013" +origin: "Auditoria estática somente leitura do port Zelda 1, HEAD 583c8811892977c266dffd3c500798791386632c;\ + \ registros históricos e catálogo fonte MCP atual" +purpose: "Fundamentar UX AI-first na produção real do port: organização, salas/bancos,\ + \ geração, revisão e feedback; distinguir fatos atuais de evidência histórica" +path: "artifacts/evidence/ART-0003/payload" +sha256: "cb24bfc899fb6c941b4b4b940f58ab1a21c789799f77e158c89dea2375c569c8" +size: 11616 +author: "codex" +createdAt: "2026-11-17T10:52:11.435609Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/payload new file mode 100644 index 0000000..f12caa9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0003/payload @@ -0,0 +1,129 @@ +# WRK-0013 — estudo de caso Zelda 1 + +Inspeção estática UTC: 2026-11-17T10:52:10.801038+00:00 + +Projeto consultado em leitura: ports/nes/zelda-1. Work operacional desta auditoria: WRK-0013 do workspace Prometeu. Não retomar o desenvolvimento pausado do port. + +## Proveniência + +HEAD do port: `583c8811892977c266dffd3c500798791386632c` + +Alterações preexistentes observadas na primeira inspeção (não produzidas nesta auditoria): +```text +M .ai-engineering/AGENTS.md + M .ai-engineering/README.md + M .ai-engineering/protocol.json + M .ai-engineering/works/WRK-0001-planejar-proximo-recorte/work.md + M AGENTS.md +?? .ai-engineering/works/WRK-0001-planejar-proximo-recorte/discussions/DSC-0005.md +``` + +## Fontes verificadas e hashes + +- `ports/nes/zelda-1/AGENTS.md` — SHA-256 `9512fda817322f12eef8afa04a7c79c1cb5d6aa6e36e4dcf72df56a7759d4ad1`; 227 linhas. +- `ports/nes/zelda-1/prometeu.json` — SHA-256 `4f83a5cbeb406f756d238645b0bbb11846b962021560e0237ceb4577de271b20`; 10 linhas. +- `ports/nes/zelda-1/docs/scene-composition.md` — SHA-256 `2be5eb2ad53653a838dc884fdc528100da1d1505e2b0800457502f5ef2de44ad`; 74 linhas. +- `ports/nes/zelda-1/docs/prometeu-feedback.md` — SHA-256 `ad0761860c5b8e5efe9ea5d94f736a1555ec3f0bc8154d53e9f5d288dec24988`; 966 linhas. +- `ports/nes/zelda-1/docs/port-status.md` — SHA-256 `bf74916fe8e18fa488fc365d6a0dd48e30264f535877ec87c65ef3d5badf70a2`; 326 linhas. +- `ports/nes/zelda-1/src/main.pbs` — SHA-256 `2a25c1c1f556e4150312393ca37e20b3d38399f88375e69f4ca173099fefa7b6`; 15 linhas. +- `ports/nes/zelda-1/src/game/main.pbs` — SHA-256 `001da9f0c53c19fe02f7ebc550326f810f35c19c2d4712755bb4fd4934a6ec82`; 16 linhas. +- `ports/nes/zelda-1/src/game/flow.pbs` — SHA-256 `ce4e06df583823730c6d197da7201abb83187c267925ffdef65cb356d0f489c9`; 112 linhas. +- `ports/nes/zelda-1/src/scene/main.pbs` — SHA-256 `df480912990f126a61dc654056e36350ecf648083253dc18ad78bd82796d52e7`; 123 linhas. +- `ports/nes/zelda-1/src/stage/main.pbs` — SHA-256 `09654049bd0dda1636f8479bfead3486ec2f6eddbbed0f8e3166f6432baf46cd`; 143 linhas. +- `ports/nes/zelda-1/src/stage/flow.pbs` — SHA-256 `154e22c17f87d8a77b3335c863fecc8fcc71ff3fb9ac6f5eacecb773e21d6fae`; 140 linhas. +- `ports/nes/zelda-1/src/stages/cave_shop/main.pbs` — SHA-256 `110cdee50512db5f20559fda027bbc399ef30e860007672ac3ea8d6ff658c781`; 40 linhas. +- `ports/nes/zelda-1/src/shop/visit.pbs` — SHA-256 `0b0150e1753bdd8e12404ac2c4269bd11bb5e04684d610fd499e1b1ccaa9627c`; 23 linhas. +- `ports/nes/zelda-1/src/link/main.pbs` — SHA-256 `59a02dc91fbcbf281dc266afe2d7da92fb064ed2f8a4f5ef5c3ca66368487ec3`; 156 linhas. +- `ports/nes/zelda-1/src/enemies/octorok/main.pbs` — SHA-256 `d724a0e12dcc41ea41ea5686f219d230bd8512c4fa6d59dc1b39163b10bca827`; 171 linhas. +- `ports/nes/zelda-1/src/world/bombable_wall.pbs` — SHA-256 `bdf07469a74088df65e5959d495c4f0bc57c73dcfb35aedf8af1217cc8eb0405`; 12 linhas. +- `ports/nes/zelda-1/src/screens/inventory/main.pbs` — SHA-256 `7a5c089138883460861015df9da9d7f1307e093180ca8629b948e0f0e842ab2d`; 16 linhas. +- `ports/nes/zelda-1/tools/overworld_manifest.json` — SHA-256 `3e6aed03996a2445f6b4d33a9a286a69cde97ca388accb8f130de17a3e2ca68e`; 122 linhas. +- `ports/nes/zelda-1/tools/prepare_overworld.py` — SHA-256 `85b0628eea88352e29f4ffe5253ff7619645e2d982fb044465488e8553174fd0`; 141 linhas. +- `ports/nes/zelda-1/extracted/overworld/expansion/catalog.json` — SHA-256 `05b15a4d62e1c7607d2bd25c812afb2d223db7c3d802afb1448b1378a2ee13d1`; 684 linhas. +- `ports/nes/zelda-1/extracted/link/refactor-validation.json` — SHA-256 `ada45375086cc17485074eb7e6feac2cacc8bf4815ae318ac63dd353294e31b8`; 528 linhas. +- `ports/nes/zelda-1/extracted/supply_shop/save-validation.json` — SHA-256 `c92df7fece58be3db32eefbdf5d9963e33b60f6d4d4376d6d5386fef33b8ba5f`; 20 linhas. +- `ports/nes/zelda-1/assets/characters/link/asset.json` — SHA-256 `e5817d82fb4879f8831d3c5aec6a28670180ecf714ed556dd5ebbbd31d8d9f3f`; 220 linhas. +- `ports/nes/zelda-1/assets/tilesets/north/asset.json` — SHA-256 `3fa48c406577392a85b73090475690526552938a699b1bf0c668fb02a7183e1a`; 354 linhas. +- `ports/nes/zelda-1/assets/scenes/overworld_north/asset.json` — SHA-256 `0cce797804aea292411b8d8c283b13e2f249c78fd65e234f6b731b6f9dfbc23a`; 14 linhas. +- `ports/nes/zelda-1/assets/scenes/overworld_north_scroll/asset.json` — SHA-256 `2beda98435d8c2e9d8dad0c69e084662b3bbba05c3a548e0ff1b8dca9fe3a552`; 14 linhas. +- `ports/nes/zelda-1/assets/scenes/inventory/asset.json` — SHA-256 `74b3d3578a262ea06abb99ce13ea344baa8a02fd36bb77d48deec4f32547ebb8`; 14 linhas. +- `ports/nes/zelda-1/assets/ui/hud/asset.json` — SHA-256 `a196baddf16720114bb190dd8aaed7d0c0c9866b7eaa704854da4902bc381aaf`; 230 linhas. + +## Dimensão observada + +- src: 137 arquivos. +- assets: 1350 arquivos. +- tools: 85 arquivos. +- extracted: 2681 arquivos. +- Catálogo fonte: 13 salas do overworld. +- Catálogo gerado retido: 13 salas, 15 ligações bidirecionais; limites registrados {'actor_pool': 5, 'scene_slots': 16}. +- Resultado histórico de refactor retido: passed=58. Não executado nesta auditoria. + +## Âncoras úteis + +- `ports/nes/zelda-1/docs/scene-composition.md:4` — ROM. A organização gráfica deve aproveitar o Prometeu: uma scene com terreno +- `ports/nes/zelda-1/docs/scene-composition.md:73` — O inventário passou a 16 faixas dentro do slot 15. Stage ID 16 é um ID de +- `ports/nes/zelda-1/docs/prometeu-feedback.md:174` — ### ATR-08 Importação de bancos pelo agente exige edição de manifestos +- `ports/nes/zelda-1/docs/prometeu-feedback.md:312` — ### ATR-15 Compor elementos mutáveis sobre o terreno fixo +- `ports/nes/zelda-1/docs/prometeu-feedback.md:371` — ## Avaliação de interface ainda a fazer +- `ports/nes/zelda-1/docs/prometeu-feedback.md:390` — ### ATR-17 — Limite de bancos aparece como falha genérica no boot +- `ports/nes/zelda-1/docs/prometeu-feedback.md:814` — ### ATR-19 Validação visual nativa e serviço local de automação do Studio +- `ports/nes/zelda-1/docs/prometeu-feedback.md:899` — proposta ATR-19 acima: comparação estruturada de artefatos no Studio reduziria +- `ports/nes/zelda-1/docs/prometeu-feedback.md:911` — **Positivo / ATR-15:** quatro mapas e mais um interior foram integrados sem +- `ports/nes/zelda-1/docs/prometeu-feedback.md:917` — **Produção / ATR-08:** o gerador do port deixou buracos 28/29 no HUD ao derivar +- `ports/nes/zelda-1/docs/prometeu-feedback.md:934` — **ATR-19:** as 81 comparações exatas deste recorte ainda exigiram captura em +- `ports/nes/zelda-1/src/game/main.pbs:7` — declare service Game { +- `ports/nes/zelda-1/src/scene/main.pbs:19` — declare service Scene { +- `ports/nes/zelda-1/src/stage/main.pbs:14` — declare service Stage { +- `ports/nes/zelda-1/src/stage/main.pbs:106` — fn render() -> bool { +- `ports/nes/zelda-1/src/stage/main.pbs:111` — if Stage.scrolling() { let status = Composer.bind_scene(14); return status == 0; } +- `ports/nes/zelda-1/src/stages/cave_shop/main.pbs:35` — fn render() -> bool { let status=Composer.bind_scene(1); return status==0; } +- `ports/nes/zelda-1/src/link/main.pbs:5` — declare global state: LinkState = new LinkState(120, 133, 4, 0, 0, false, 0, 4, 0, 0, 0, 0, 1); +- `ports/nes/zelda-1/src/enemies/octorok/main.pbs:11` — declare global e0: Octorok = new Octorok(new Rock(0, 0, 0,0,0), 80, 93, 4, 0, 0, 0, 0, 0, 32, 1, 0, false,0,0,0,7); +- `ports/nes/zelda-1/tools/prepare_overworld.py:2` — """Generate room-owned stages, shared atlases, native foes and route tables.""" +- `ports/nes/zelda-1/tools/prepare_overworld.py:80` — fn render() -> bool {{ let status=Composer.bind_scene(13); return status==0; }} +- `ports/nes/zelda-1/tools/prepare_overworld.py:87` — wrapper=shop_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==112 && y==77 && grid==0; }\n fn render()') +- `ports/nes/zelda-1/tools/prepare_overworld.py:90` — supply_room.write_text(supply_room.read_text().replace(' fn render()', ' fn can_enter(x: int,y: int,grid: int) -> bool { return x==64 && y==77 && grid==0; }\n fn render()')) +- `ports/nes/zelda-1/tools/prepare_overworld.py:96` — source=source.replace(' fn render()', ' fn wall_opened() -> bool { return rock_wall.opened(); }\n fn finish_visit() -> void { wall_fresh=false; }\n fn blast(x: int,y: int) -> void { let opened=rock_wall.try_blast(x,y); if opened { wall_fresh=true; } }\n fn can_enter(x: int,y: int,grid: int) -> bool { let opened=rock_wall.opened(); return opened && x==112 && y==77 && grid==0; }\n fn draw_wall(dx: int,dy: int) -> void { if rock_wall.opened() { return; }\n'+''.join(f' Scene.emit_sprite({glyph[t]},0,{112+x}+dx,{80+y}+dy,10,0);\n' for t,x,y in [(216,0,0),(218,8,0),(217,0,8),(219,8,8)])+' }\n fn render()') +- `ports/nes/zelda-1/tools/prepare_overworld.py:102` — marker_id=f'world-marker-{e["room"]:02x}';existing=next((a for a in hdoc['artifacts'] if a['artifact_id']==marker_id),None) +- `ports/nes/zelda-1/tools/prepare_overworld.py:107` — path=hud/f'world-marker-{e["room"]:02x}.png';im.save(path);hdoc['artifacts']=[a for a in hdoc['artifacts'] if a['index']!=idx and a['artifact_id']!=f'world-marker-{e["room"]:02x}']+[{'file':path.name,'index':idx,'artifact_id':path.stem,'fingerprint':hashlib.sha256(path.read_bytes()).hexdigest()}];hud_ids[e['stage']]=idx + +## Comparação temporal com o Studio atual + +- `studio/prometeu-app/src/main/resources/mcp/studio-tools-v1.json` — SHA-256 `644460877c87cdbe3bd1a77c7e6f764c24fe9b1c16c0eb237b48675e12e5126e`. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/assets/AssetAuthoringService.java` — SHA-256 `1e54099ba43bdbb367f7c608072c4f74922890f4c353c866fcc2a7ca588e0c04`. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/automation/EvidenceTools.java` — SHA-256 `4ec022b977c079c0af5e070e86e3b1493e2c25fa4b9fb7b97e48dc3722116ba3`. +- `studio/prometeu-studio-api/src/main/java/p/studio/api/automation/GuestTestTools.java` — SHA-256 `6d75a7c119bbb094e34ac63d68edc356770ade8d9164a002200859426a93843d`. +- studio_evidence_persist +- studio_evidence_import +- studio_evidence_compare +- studio_evidence_list +- studio_evidence_metadata +- studio_evidence_read +- studio_evidence_image +- studio_evidence_delete +- studio_tests_targets +- studio_tests_start +- studio_tests_get +- studio_tests_cancel +- studio_tests_transcript +- studio_tests_shutdown +- studio_assets_catalog +- studio_assets_artifacts +- studio_assets_revision +- studio_assets_dependencies +- studio_assets_budget +- studio_assets_preview +- studio_assets_preview_get +- studio_assets_commit +- studio_assets_result +- studio_assets_inspect + +## Limites + +- O relato de que o usuário não escreveu código e acompanhou a evolução é evidência humana desta conversa; não inferir autoria individual a partir de git/file metadata. +- Documentos e resultados retidos registram execuções anteriores. Nenhum teste, build, geração de assets, boot, MCP ou screenshot foi executado agora. +- Feedback do port declara que painéis do Studio ainda não foram avaliados visualmente; dificuldades do agente/compilador não são prova de defeito visual da GUI. +- Lacunas históricas de importação e comparação de imagens devem ser contrastadas com tools de autoria/evidência presentes no catálogo fonte atual. Não se verificou disponibilidade nem desempenho na instalação corrente. +- Sala/stage lógica, banco/atlas e slot runtime são identidades distintas. O módulo Scene do port é apresentação própria do jogo, não um contrato normativo de scene do Studio. +- Nenhum arquivo do port, incluindo feedback e sua AIE, foi alterado. As alterações preexistentes devem ser preservadas. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/artifact.yaml new file mode 100644 index 0000000..5387977 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0004" +workId: "WRK-0013" +origin: "prometeu-ui-foundation.html" +purpose: "Estudo visual exploratório do shell mínimo e amostras de componentes; temas\ + \ escuro/claro e pt-BR/inglês. Não é implementação JavaFX nem aprovação final da\ + \ identidade." +path: "artifacts/evidence/ART-0004/payload" +sha256: "14a05d949b7f8a1938af171d75c33620f72d91ff4d918e185dcfde69bd021f7f" +size: 13275 +author: "Codex" +createdAt: "2026-11-17T14:43:06.763801Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/payload new file mode 100644 index 0000000..9a286e2 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0004/payload @@ -0,0 +1,106 @@ + +
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/artifact.yaml new file mode 100644 index 0000000..eba4040 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0005" +workId: "WRK-0013" +origin: "prometeu-ui-pixel.html" +purpose: "Alternativa exploratória com molduras em degraus e relevo; comparação com\ + \ tratamento anterior, temas e idiomas preservados. Sem implementação JavaFX." +path: "artifacts/evidence/ART-0005/payload" +sha256: "e7e7fe9d7af0380fb98b647dc106b04d233f36c92dfce5021acff18987e4365b" +size: 18812 +author: "Codex" +createdAt: "2026-11-17T14:54:31.952735Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/payload new file mode 100644 index 0000000..5de02b1 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0005/payload @@ -0,0 +1,144 @@ + +
+
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/artifact.yaml new file mode 100644 index 0000000..21c1df5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0006" +workId: "WRK-0013" +origin: "prometeu-ui-mono.html" +purpose: "Estudo de tipografia Departure Mono 1.500, fonte monoespaçada pixelada,\ + \ aplicada à UI com bordas em degraus e relevo; comparação com tipografia anterior.\ + \ Fonte incorporada, licença preservada separadamente." +path: "artifacts/evidence/ART-0006/payload" +sha256: "dd1d4d87d85fee54692b786d4b076c0146672d1b8ad3392294ea118c7039d78c" +size: 133062 +author: "Codex" +createdAt: "2026-11-17T15:06:09.776397Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/payload new file mode 100644 index 0000000..a2bbd2a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0006/payload @@ -0,0 +1,157 @@ + +
+
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/artifact.yaml new file mode 100644 index 0000000..5686348 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0007" +workId: "WRK-0013" +origin: "prometeu-ui-mono.html" +purpose: "Comparação de Departure Mono e Roboto Mono com texto editável sincronizado,\ + \ glifos de teste, fontes e licenças SIL OFL incorporadas; temas e idioma preservados." +path: "artifacts/evidence/ART-0007/payload" +sha256: "61bc34a02582d5315ac910403c52f7fec6c78fa9bb8d3ad16066082ea484a944" +size: 267578 +author: "Codex" +createdAt: "2026-11-17T15:14:13.228485Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/payload new file mode 100644 index 0000000..7035667 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0007/payload @@ -0,0 +1,391 @@ + +
+
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+

TESTE DE TEXTO · 16,5 px

+ +
+
+

Departure Mono

+

A criação começa com uma ideia. Organize suas cenas, ajuste os personagens e dê vida à aventura. Ação, música e imaginação: você escolhe o próximo passo.

+
Aa Bb Cc · á à â ã é ê í ó ô õ ú ç
+Il1 O0 · 0123456789
+{} [] () <> != == + - * /
+
+
+

Roboto Mono

+

A criação começa com uma ideia. Organize suas cenas, ajuste os personagens e dê vida à aventura. Ação, música e imaginação: você escolhe o próximo passo.

+
Aa Bb Cc · á à â ã é ê í ó ô õ ú ç
+Il1 O0 · 0123456789
+{} [] () <> != == + - * /
+
+
+
+
Departure Mono · SIL OFL 1.1
Copyright 2022–2024 Helena Zhang (helenazhang.com).
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+
Roboto Mono · SIL OFL 1.1
Copyright 2015 The Roboto Mono Project Authors (https://github.com/googlefonts/robotomono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/artifact.yaml new file mode 100644 index 0000000..ea89dd2 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0008" +workId: "WRK-0013" +origin: "wrk0013-foundation-checks.log" +purpose: "Gradle foundation unit tests/installDist and legacy UI compilation; real\ + \ command output before desktop qualification." +path: "artifacts/evidence/ART-0008/payload" +sha256: "f20316489a8a6535f7711b19e17559281c28606fe9d97b454817dab45d17804f" +size: 1606 +author: "Codex" +createdAt: "2026-11-17T16:53:36.164168Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/payload new file mode 100644 index 0000000..200b1d0 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0008/payload @@ -0,0 +1,34 @@ +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target +> Task :buildSrc:checkKotlinGradlePluginConfigurationErrors SKIPPED +> Task :buildSrc:generateExternalPluginSpecBuilders UP-TO-DATE +> Task :buildSrc:extractPrecompiledScriptPluginPlugins UP-TO-DATE +> Task :buildSrc:compilePluginsBlocks UP-TO-DATE +> Task :buildSrc:generatePrecompiledScriptPluginAccessors UP-TO-DATE +> Task :buildSrc:generateScriptPluginAdapters UP-TO-DATE + +> Task :buildSrc:compileKotlin UP-TO-DATE +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target + +> Task :buildSrc:compileJava NO-SOURCE +> Task :buildSrc:compileGroovy NO-SOURCE +> Task :buildSrc:pluginDescriptors UP-TO-DATE +> Task :buildSrc:processResources UP-TO-DATE +> Task :buildSrc:classes UP-TO-DATE +> Task :buildSrc:jar UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:compileJava UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:processResources +> Task :prometeu-studio-ui-javafx-2:classes +> Task :prometeu-studio-ui-javafx-2:jar +> Task :prometeu-studio-ui-javafx-2:compileTestJava +> Task :prometeu-studio-ui-javafx-2:processTestResources NO-SOURCE +> Task :prometeu-studio-ui-javafx-2:testClasses +> Task :prometeu-studio-ui-javafx-2:test +> Task :prometeu-studio-ui-javafx-2:startScripts +> Task :prometeu-studio-ui-javafx-2:jacocoTestReport +> Task :prometeu-studio-ui-javafx-2:installDist +> Task :prometeu-animation:compileJava UP-TO-DATE +> Task :prometeu-studio-api:compileJava UP-TO-DATE +> Task :prometeu-studio-ui-javafx:compileJava UP-TO-DATE + +BUILD SUCCESSFUL in 7s +20 actionable tasks: 7 executed, 13 up-to-date diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/artifact.yaml new file mode 100644 index 0000000..90c4005 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/artifact.yaml @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "ART-0009" +workId: "WRK-0013" +origin: "wrk0013-desktop-layout.log" +purpose: "Real macOS JavaFX component/shell qualification after responsive layout\ + \ correction, including theme/locale/font retention, clipboard, Tab, close/reopen\ + \ and appearance timing." +path: "artifacts/evidence/ART-0009/payload" +sha256: "c93ab9dad6a340ba2a7723ed58f637ab65c70268d1c79626cc2eca74f233020a" +size: 1633 +author: "Codex" +createdAt: "2026-11-17T17:05:32.974313Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/payload new file mode 100644 index 0000000..9f15813 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0009/payload @@ -0,0 +1,35 @@ +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target +> Task :buildSrc:checkKotlinGradlePluginConfigurationErrors SKIPPED +> Task :buildSrc:generateExternalPluginSpecBuilders UP-TO-DATE +> Task :buildSrc:extractPrecompiledScriptPluginPlugins UP-TO-DATE +> Task :buildSrc:compilePluginsBlocks UP-TO-DATE +> Task :buildSrc:generatePrecompiledScriptPluginAccessors UP-TO-DATE +> Task :buildSrc:generateScriptPluginAdapters UP-TO-DATE + +> Task :buildSrc:compileKotlin UP-TO-DATE +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target + +> Task :buildSrc:compileJava NO-SOURCE +> Task :buildSrc:compileGroovy NO-SOURCE +> Task :buildSrc:pluginDescriptors UP-TO-DATE +> Task :buildSrc:processResources UP-TO-DATE +> Task :buildSrc:classes UP-TO-DATE +> Task :buildSrc:jar UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:compileJava +> Task :prometeu-studio-ui-javafx-2:processResources UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:classes +> Task :prometeu-studio-ui-javafx-2:compileTestJava +> Task :prometeu-studio-ui-javafx-2:processTestResources NO-SOURCE +> Task :prometeu-studio-ui-javafx-2:testClasses + +> Task :prometeu-studio-ui-javafx-2:desktopTest + +FoundationDesktopTest STANDARD_ERROR + Nov 17, 2026 4:59:20 P.M. com.sun.javafx.application.PlatformImpl startup + WARNING: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @36916eb0' + +FoundationDesktopTest > shellGalleryStateThemesLocalesFontsAndLifecycle() STANDARD_OUT + 20 appearance changes, average FX CSS/layout ms=19.63036665 + +BUILD SUCCESSFUL in 8s +13 actionable tasks: 3 executed, 10 up-to-date diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/artifact.yaml new file mode 100644 index 0000000..d133a09 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0010" +workId: "WRK-0013" +origin: "wrk0013-final-checks.log" +purpose: "Final unit/desktop/installDist/legacy compile gate after popup translation,\ + \ responsive toolbar, contrast and capture synchronization fixes; all passed." +path: "artifacts/evidence/ART-0010/payload" +sha256: "bb94afb2e871aa42eb94574c9bd43f9b95c5ecf3889d982ab3c795f46bfe1dce" +size: 2012 +author: "Codex" +createdAt: "2026-11-17T17:40:49.994626Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/payload new file mode 100644 index 0000000..0d262ee --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0010/payload @@ -0,0 +1,44 @@ +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target +> Task :buildSrc:checkKotlinGradlePluginConfigurationErrors SKIPPED +> Task :buildSrc:generateExternalPluginSpecBuilders UP-TO-DATE +> Task :buildSrc:extractPrecompiledScriptPluginPlugins UP-TO-DATE +> Task :buildSrc:compilePluginsBlocks UP-TO-DATE +> Task :buildSrc:generatePrecompiledScriptPluginAccessors UP-TO-DATE +> Task :buildSrc:generateScriptPluginAdapters UP-TO-DATE + +> Task :buildSrc:compileKotlin UP-TO-DATE +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target + +> Task :buildSrc:compileJava NO-SOURCE +> Task :buildSrc:compileGroovy NO-SOURCE +> Task :buildSrc:pluginDescriptors UP-TO-DATE +> Task :buildSrc:processResources UP-TO-DATE +> Task :buildSrc:classes UP-TO-DATE +> Task :buildSrc:jar UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:compileJava +> Task :prometeu-studio-ui-javafx-2:processResources +> Task :prometeu-studio-ui-javafx-2:classes +> Task :prometeu-studio-ui-javafx-2:jar +> Task :prometeu-studio-ui-javafx-2:compileTestJava +> Task :prometeu-studio-ui-javafx-2:processTestResources NO-SOURCE +> Task :prometeu-studio-ui-javafx-2:testClasses +> Task :prometeu-studio-ui-javafx-2:test +> Task :prometeu-studio-ui-javafx-2:jacocoTestReport + +> Task :prometeu-studio-ui-javafx-2:desktopTest + +FoundationDesktopTest STANDARD_ERROR + Nov 17, 2026 5:20:39 P.M. com.sun.javafx.application.PlatformImpl startup + WARNING: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @36916eb0' + +FoundationDesktopTest > shellGalleryStateThemesLocalesFontsAndLifecycle() STANDARD_OUT + 20 appearance changes, average FX CSS/layout ms=19.2100021 + +> Task :prometeu-studio-ui-javafx-2:startScripts +> Task :prometeu-studio-ui-javafx-2:installDist +> Task :prometeu-animation:compileJava UP-TO-DATE +> Task :prometeu-studio-api:compileJava UP-TO-DATE +> Task :prometeu-studio-ui-javafx:compileJava UP-TO-DATE + +BUILD SUCCESSFUL in 10s +21 actionable tasks: 9 executed, 12 up-to-date diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/artifact.yaml new file mode 100644 index 0000000..b45d7bf --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0011" +workId: "WRK-0013" +origin: "wrk0013-qualification.zip" +purpose: "Final macOS qualification bundle: actual JavaFX PNG captures, per-capture\ + \ environment, JUnit XML, Gradle final/launcher logs and source SHA-256 manifest." +path: "artifacts/evidence/ART-0011/payload" +sha256: "0cc6f63628397e28d101e96c0af0f618a564995451a5b123d212cc7984069881" +size: 258330 +author: "Codex" +createdAt: "2026-11-17T17:42:21.336718Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/payload new file mode 100644 index 0000000..51a96d9 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0011/payload differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/artifact.yaml new file mode 100644 index 0000000..9e6e323 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0012" +workId: "WRK-0013" +origin: "qualification-report.md" +purpose: "Final qualification synthesis, DEC acceptance mapping, observed corrections,\ + \ exact commands/results, environment/limits and durable integration surfaces." +path: "artifacts/evidence/ART-0012/payload" +sha256: "a4aad25d72b2c2d80c8c4ba6d74af158726eb80d42d4e018429a6e3dea1bcfa2" +size: 7000 +author: "Codex" +createdAt: "2026-11-17T17:43:45.302953Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/payload new file mode 100644 index 0000000..7c1651d --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0012/payload @@ -0,0 +1,71 @@ +# JavaFX 2 foundation — implementation and qualification + +Date: 2026-11-17. Owner: Studio. Decision: DEC-0001, explicitly accepted by Nilton. Plan: PLN-0001. + +## Delivered scope + +Implemented `studio/prometeu-studio-ui-javafx-2`, with its own launcher, presentation context, native-control components, responsive shell toolbar and scalable stepped/beveled vector outlines. The default product shell contains identity, theme/language selectors and an empty central frame. The developer gallery is a separate launch and supplies font/scale choices, validation/progress states and editable text compared in Departure Mono and Roboto Mono. + +Dark/light, pt-BR/English, inherited typography, localized feedback and already-open selector popups update in place. Small user preferences preserve appearance choices through an off-FX-thread writer. Local font binaries and complete SIL OFL notices are bundled in the jar and installed distribution. No game project, backend or agent is required. + +Only module inclusion, the new module and its docs/spec index were changed in Studio. Existing frontend implementation/launcher and backend are untouched. Runtime status was checked clean. No commits were created. The root AIE Studio edit flag was enabled under the explicit implementation authorization; runtime remains read-only. + +## Actual commands and outcomes + +Run from `studio`: + +```sh +./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:desktopTest :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava --console=plain +./gradlew :prometeu-studio-ui-javafx-2:run --console=plain +``` + +- Integrated gate: BUILD SUCCESSFUL. Full final output: ART-0010 and `wrk0013-final-checks.log`. +- Actual independent application launch: BUILD SUCCESSFUL after the native window run; `wrk0013-shell-launch.log`. No project/runtime startup was requested or wired. +- Display-free unit tests: 8 passed, 0 failed/error (6 presentation/preference cases, 2 resource/contrast cases). +- Real JavaFX desktop scenario: 1 passed, 0 failed/error. It traverses 8 theme × language × font combinations, localization of an already-open popup, Tab from theme to language, native clipboard edit/paste, validation and retained input, repeated CSS/layout updates, resizing and 3 independent reopenings. +- Installed `licenses/`: both complete font notices confirmed. +- `git diff --check` passed. This is not a full backend/compiler/runtime regression run; no such implementation changed. + +## Environment and measurements + +macOS 27.2; test JVM Java 21.0.4; JavaFX 23.0.2; reported output scale 2×2. The actual environment and presentation settings accompany every PNG in a `.txt` file. + +Normal scene: 1200×800. Minimum outer window: 680×480, with 680×452 scene content in this native-decorated environment. Captures wait for JavaFX pulses after resizing, then record image dimensions and metadata together. Assertions check image/scene dimensions, minimum-width gallery overflow and remaining central space in the minimum product shell. + +Final measured average for 20 in-place appearance changes followed by CSS/layout: **19.21 ms**, below the plan's 250 ms average budget. This measures that operation, not total input latency or an FPS guarantee. + +Snapshots are logical scene captures, not OS screenshots of physical pixels. Running on a real 2× display verifies that environment, but does not prove pixel-perfect rendering at all fractional scales. Both default and changed typography/scale paths were exercised. + +## Visual inspection and corrections + +Inspected actual PNGs for the dark/default shell, minimum shell/gallery, dark Departure, light Departure/Roboto and the font comparison area. Corrected horizontal overflow in the narrow toolbar, then used a responsive toolbar to preserve a compact single row at usual widths. Captures now match the resized scene dimensions. Corrected low-contrast golden headings on light surfaces to a theme-specific violet role; selector arrows use text color. Progress has a visible localized percentage and a contrasting theme-specific fill. Default empty shell and gallery are kept distinct. + +Unit verification compares semantic theme key sets and required text/background, heading, focus/border, error, accent and progress contrast pairs. Disabled controls retain deliberate disabled appearance. These checks do not constitute accessibility certification or exhaustive pixel-level auditing. + +## DEC acceptance coverage + +| Criterion | Evidence | +| --- | --- | +| Independent module, old frontend preserved | Final compilation/install gate, standalone run, module build file and source manifest. | +| Component families and empty product shell | `shell-dark-default.png`, `shell-minimum-680x480.png`, gallery matrix, public component source/API guide. | +| Theme/locale switching, fallback, preferences | Presentation tests; real state retention, dynamic feedback and open-popup checks. | +| Departure default, Roboto alternative, configuration/licenses | Resource tests, font gallery, installed license directory, font samples and runtime font-family assertions. | +| Native behavior, focus, accessible semantics/contrast | Clipboard, Tab/focus, native control paths, localized labels/error text and contrast tests; manual qualification limits below. | +| Actual macOS visual qualification | PNGs with matching metadata and dimension assertions in ART-0011. | +| Lifecycle/responsiveness | Context close/reopen assertions, independent persistence worker test, 20-update measurement. | +| No domain/backend/runtime expansion | Source SHA-256 manifest and checked Studio/runtime diff scope. | + +## Remaining environment-specific qualification + +Windows/Linux, a screen-reader walkthrough and multi-step native IME composition were not exercised. Controls preserve the native JavaFX semantics/path; that is not evidence of completed platform/assistive/IME qualification. No guarantee is made for fractional HiDPI pixel sharpness, arbitrary system fonts, full docking or future editor/ACP lifecycle. + +The build emitted the existing buildSrc JDK 25/Kotlin JVM target advisory; the new module uses Java 21. The desktop harness emitted JavaFX's unnamed-module warning; tests and window launch succeeded. Neither warning was represented as a functional failure or silently suppressed. + +## Durable integration + +- `studio/prometeu-studio-ui-javafx-2/README.md`: commands, API/ownership, settings/i18n, licenses and qualification boundaries. +- `studio/docs/specs/studio/13. JavaFX 2 Foundation Specification.md`: implemented foundation contract. +- `studio/docs/specs/studio/README.md`: explicit coexistence with the existing frontend corpus. +- ART-0011: immutable ZIP of final PNGs, metadata, JUnit XML, build/launch logs and source hashes. The source manifest excludes build products and captures the final source files used by the final gate. + +No ACP, Assets, code/scene editor, entity model, pixel/audio editor, execution/debug or Shipper feature was implemented. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/artifact.yaml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/artifact.yaml new file mode 100644 index 0000000..5db464c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/artifact.yaml @@ -0,0 +1,12 @@ +--- +schemaVersion: 1 +id: "ART-0013" +workId: "WRK-0013" +origin: "ai-engineering:plans:62403bef5e1702d857e4635f207dafe0ead6c44236bf8a12755dfd0ad2779677" +purpose: "Deterministic aggregation of completed Plans and reviewed cancellations;\ + \ not semantic verification of prose criteria" +path: "artifacts/evidence/ART-0013/payload" +sha256: "62403bef5e1702d857e4635f207dafe0ead6c44236bf8a12755dfd0ad2779677" +size: 284 +author: "system:plans" +createdAt: "2026-11-17T17:44:49.062008Z" diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/payload b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/payload new file mode 100644 index 0000000..45eb8b6 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/evidence/ART-0013/payload @@ -0,0 +1,10 @@ +{ + "schemaVersion" : 1, + "workId" : "WRK-0013", + "inputHash" : "6eda756b78e916dfdbda52bfcf245b487832d7d4303dbbd0e610385f766f2214", + "plans" : [ { + "id" : "PLN-0001", + "revision" : 18, + "sha256" : "416c49d74abf88762b9549ba985d553f946d9ac80238430ca927197c5fa0c91a" + } ] +} diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.png new file mode 100644 index 0000000..a6c4ebf Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.txt new file mode 100644 index 0000000..5929ba9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-DEPARTURE.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=ENGLISH, typeface=DEPARTURE, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.png new file mode 100644 index 0000000..7ed51c7 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.txt new file mode 100644 index 0000000..a68acf8 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-ENGLISH-ROBOTO.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=ENGLISH, typeface=ROBOTO, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.png new file mode 100644 index 0000000..445b911 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.txt new file mode 100644 index 0000000..f10074a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-DEPARTURE.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=PORTUGUESE, typeface=DEPARTURE, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.png new file mode 100644 index 0000000..6b26263 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.txt new file mode 100644 index 0000000..bc346bd --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/DARK-PORTUGUESE-ROBOTO.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=PORTUGUESE, typeface=ROBOTO, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.png new file mode 100644 index 0000000..377b60e Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.txt new file mode 100644 index 0000000..44155c5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-DEPARTURE.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=ENGLISH, typeface=DEPARTURE, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.png new file mode 100644 index 0000000..ca1ca10 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.txt new file mode 100644 index 0000000..c3aba7f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-ENGLISH-ROBOTO.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=ENGLISH, typeface=ROBOTO, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.png new file mode 100644 index 0000000..4e3c9c1 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.txt new file mode 100644 index 0000000..98db13a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-DEPARTURE.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=PORTUGUESE, typeface=DEPARTURE, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.png new file mode 100644 index 0000000..7937ae7 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.txt new file mode 100644 index 0000000..26e46d5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/LIGHT-PORTUGUESE-ROBOTO.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=PORTUGUESE, typeface=ROBOTO, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/desktopTest-TEST-p.studio.ui.javafx2.FoundationDesktopTest.xml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/desktopTest-TEST-p.studio.ui.javafx2.FoundationDesktopTest.xml new file mode 100644 index 0000000..f284c50 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/desktopTest-TEST-p.studio.ui.javafx2.FoundationDesktopTest.xml @@ -0,0 +1,10 @@ + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.png new file mode 100644 index 0000000..007a1a0 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.txt new file mode 100644 index 0000000..a7f3509 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/fonts-and-licenses.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=PORTUGUESE, typeface=ROBOTO, scale=1.0] +scene=680.0x452.0 +image=680.0x452.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.png new file mode 100644 index 0000000..7108e9e Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.txt new file mode 100644 index 0000000..a7f3509 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/minimum-680x480.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=LIGHT, language=PORTUGUESE, typeface=ROBOTO, scale=1.0] +scene=680.0x452.0 +image=680.0x452.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/qualification-report.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/qualification-report.md new file mode 100644 index 0000000..7c1651d --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/qualification-report.md @@ -0,0 +1,71 @@ +# JavaFX 2 foundation — implementation and qualification + +Date: 2026-11-17. Owner: Studio. Decision: DEC-0001, explicitly accepted by Nilton. Plan: PLN-0001. + +## Delivered scope + +Implemented `studio/prometeu-studio-ui-javafx-2`, with its own launcher, presentation context, native-control components, responsive shell toolbar and scalable stepped/beveled vector outlines. The default product shell contains identity, theme/language selectors and an empty central frame. The developer gallery is a separate launch and supplies font/scale choices, validation/progress states and editable text compared in Departure Mono and Roboto Mono. + +Dark/light, pt-BR/English, inherited typography, localized feedback and already-open selector popups update in place. Small user preferences preserve appearance choices through an off-FX-thread writer. Local font binaries and complete SIL OFL notices are bundled in the jar and installed distribution. No game project, backend or agent is required. + +Only module inclusion, the new module and its docs/spec index were changed in Studio. Existing frontend implementation/launcher and backend are untouched. Runtime status was checked clean. No commits were created. The root AIE Studio edit flag was enabled under the explicit implementation authorization; runtime remains read-only. + +## Actual commands and outcomes + +Run from `studio`: + +```sh +./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:desktopTest :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava --console=plain +./gradlew :prometeu-studio-ui-javafx-2:run --console=plain +``` + +- Integrated gate: BUILD SUCCESSFUL. Full final output: ART-0010 and `wrk0013-final-checks.log`. +- Actual independent application launch: BUILD SUCCESSFUL after the native window run; `wrk0013-shell-launch.log`. No project/runtime startup was requested or wired. +- Display-free unit tests: 8 passed, 0 failed/error (6 presentation/preference cases, 2 resource/contrast cases). +- Real JavaFX desktop scenario: 1 passed, 0 failed/error. It traverses 8 theme × language × font combinations, localization of an already-open popup, Tab from theme to language, native clipboard edit/paste, validation and retained input, repeated CSS/layout updates, resizing and 3 independent reopenings. +- Installed `licenses/`: both complete font notices confirmed. +- `git diff --check` passed. This is not a full backend/compiler/runtime regression run; no such implementation changed. + +## Environment and measurements + +macOS 27.2; test JVM Java 21.0.4; JavaFX 23.0.2; reported output scale 2×2. The actual environment and presentation settings accompany every PNG in a `.txt` file. + +Normal scene: 1200×800. Minimum outer window: 680×480, with 680×452 scene content in this native-decorated environment. Captures wait for JavaFX pulses after resizing, then record image dimensions and metadata together. Assertions check image/scene dimensions, minimum-width gallery overflow and remaining central space in the minimum product shell. + +Final measured average for 20 in-place appearance changes followed by CSS/layout: **19.21 ms**, below the plan's 250 ms average budget. This measures that operation, not total input latency or an FPS guarantee. + +Snapshots are logical scene captures, not OS screenshots of physical pixels. Running on a real 2× display verifies that environment, but does not prove pixel-perfect rendering at all fractional scales. Both default and changed typography/scale paths were exercised. + +## Visual inspection and corrections + +Inspected actual PNGs for the dark/default shell, minimum shell/gallery, dark Departure, light Departure/Roboto and the font comparison area. Corrected horizontal overflow in the narrow toolbar, then used a responsive toolbar to preserve a compact single row at usual widths. Captures now match the resized scene dimensions. Corrected low-contrast golden headings on light surfaces to a theme-specific violet role; selector arrows use text color. Progress has a visible localized percentage and a contrasting theme-specific fill. Default empty shell and gallery are kept distinct. + +Unit verification compares semantic theme key sets and required text/background, heading, focus/border, error, accent and progress contrast pairs. Disabled controls retain deliberate disabled appearance. These checks do not constitute accessibility certification or exhaustive pixel-level auditing. + +## DEC acceptance coverage + +| Criterion | Evidence | +| --- | --- | +| Independent module, old frontend preserved | Final compilation/install gate, standalone run, module build file and source manifest. | +| Component families and empty product shell | `shell-dark-default.png`, `shell-minimum-680x480.png`, gallery matrix, public component source/API guide. | +| Theme/locale switching, fallback, preferences | Presentation tests; real state retention, dynamic feedback and open-popup checks. | +| Departure default, Roboto alternative, configuration/licenses | Resource tests, font gallery, installed license directory, font samples and runtime font-family assertions. | +| Native behavior, focus, accessible semantics/contrast | Clipboard, Tab/focus, native control paths, localized labels/error text and contrast tests; manual qualification limits below. | +| Actual macOS visual qualification | PNGs with matching metadata and dimension assertions in ART-0011. | +| Lifecycle/responsiveness | Context close/reopen assertions, independent persistence worker test, 20-update measurement. | +| No domain/backend/runtime expansion | Source SHA-256 manifest and checked Studio/runtime diff scope. | + +## Remaining environment-specific qualification + +Windows/Linux, a screen-reader walkthrough and multi-step native IME composition were not exercised. Controls preserve the native JavaFX semantics/path; that is not evidence of completed platform/assistive/IME qualification. No guarantee is made for fractional HiDPI pixel sharpness, arbitrary system fonts, full docking or future editor/ACP lifecycle. + +The build emitted the existing buildSrc JDK 25/Kotlin JVM target advisory; the new module uses Java 21. The desktop harness emitted JavaFX's unnamed-module warning; tests and window launch succeeded. Neither warning was represented as a functional failure or silently suppressed. + +## Durable integration + +- `studio/prometeu-studio-ui-javafx-2/README.md`: commands, API/ownership, settings/i18n, licenses and qualification boundaries. +- `studio/docs/specs/studio/13. JavaFX 2 Foundation Specification.md`: implemented foundation contract. +- `studio/docs/specs/studio/README.md`: explicit coexistence with the existing frontend corpus. +- ART-0011: immutable ZIP of final PNGs, metadata, JUnit XML, build/launch logs and source hashes. The source manifest excludes build products and captures the final source files used by the final gate. + +No ACP, Assets, code/scene editor, entity model, pixel/audio editor, execution/debug or Shipper feature was implemented. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.png new file mode 100644 index 0000000..62a0035 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.txt new file mode 100644 index 0000000..5929ba9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-dark-default.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=ENGLISH, typeface=DEPARTURE, scale=1.0] +scene=1200.0x800.0 +image=1200.0x800.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.png b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.png new file mode 100644 index 0000000..793fc99 Binary files /dev/null and b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.png differ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.txt new file mode 100644 index 0000000..2eb41d9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/shell-minimum-680x480.txt @@ -0,0 +1,6 @@ +os=Mac OS X 27.2 +java=21.0.4 +outputScale=2.0x2.0 +settings=PresentationSettings[theme=DARK, language=ENGLISH, typeface=DEPARTURE, scale=1.0] +scene=680.0x452.0 +image=680.0x452.0 diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/source-sha256.json b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/source-sha256.json new file mode 100644 index 0000000..24c1c00 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/source-sha256.json @@ -0,0 +1,43 @@ +{ + "studio/prometeu-studio-ui-javafx-2/src/test/java/p/studio/ui/javafx2/PresentationContractTest.java": "65a1f2fed65f4ba949075f3c2ddf021695bba0b5ebd79ab16dfba537f6a42d01", + "studio/prometeu-studio-ui-javafx-2/src/test/java/p/studio/ui/javafx2/FoundationResourcesTest.java": "58316485344732a79e5a41275765da8362cc73c8019dc4dcadc49b449e3b6c46", + "studio/prometeu-studio-ui-javafx-2/src/test/java/p/studio/ui/javafx2/FoundationDesktopTest.java": "7a1b6e3e33fa25955dcf13580729fc24f7303bb043a2b0b0e2387243cb7bfa5e", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/styles/dark.css": "e27be3d17ec4d10d94662d565c1e4e9fc9d2843f3343217766d56a5bfdac6d67", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/styles/light.css": "a73f41638014772780de9507067d4f1265dc935e4da7a335b40b98e3f5397195", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/styles/components.css": "d477ab78bec469464ab3929f4e79e677926ba4a25b8ae38dcd455cc5992d6325", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/i18n/messages_pt_BR.properties": "69dad258cd81d23c1d1a9bad69487c395e26685fae59e4736d00b109627f8245", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/i18n/messages_en.properties": "c6ba2be11faacd1fadc752ef73a3e40757fe5c680b01664fc7ada0061304491a", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/fonts/RobotoMono-Regular.otf": "874671c3f088802a915e3f7b1b773d3d031e04a21d82e2eb5107aa1c51895c21", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/fonts/DepartureMono-1.500.otf": "4d53f663155cf8bf7ffc8e688776e719625f7bbb80a8d90073438b249261a2e0", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/fonts/departure-mono-LICENSE.txt": "b65e42750f3cb65437a97f4dfd781c58f199259949db2341012be60e32500e83", + "studio/prometeu-studio-ui-javafx-2/src/main/resources/p/studio/ui/javafx2/fonts/roboto-mono-LICENSE.txt": "50ab8dd54680d3473f649c9db86fece88434d097c7834475c1c72d2f8c429215", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/StudioApplication.java": "11aeb4f89724f8f0fe28a1450b1a977e4df2184e76a1f40a7c5633b304d4eb9e", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/StudioLauncher.java": "a4384965589002329ba3dbb082a35e1e2b905e7f68fbc5fee2d59e16c2f36cd6", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/demo/ComponentGallery.java": "b2ee6900e61c3f1078b93bceb9bbaba4a4978e6c57bfe7bb8bfac418db07c039", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/preferences/SettingsPersistence.java": "02e45e34cdd86973d25fd1db0ba88c93ba37a600c416328bab00d7048177bdf8", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/preferences/UserSettingsStore.java": "ee72a71f5f8950d95861d1de8720f5b8baf387a9424a12ff842d8537f741c22c", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/preferences/SettingsStore.java": "32f5f145e9e32acea6857aff3511b4129b3c8336d7ab6b398952565d8deb6b36", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/shell/PresentationToolbar.java": "c50c1916a619b9a5996b070e956df23fb544b808d0407e71c4c732026bd50ef1", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/shell/MinimalShell.java": "7256c7bc44570b7e007bcef718ec28d7eff814678d75f5fef7f6b68deb377e94", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/appearance/PresentationSettings.java": "8dfc447492dc9d1d1d4c57dbbc115626f7291c468684e28d4f4202a442b42724", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/appearance/FontResources.java": "68c035d5a018d8541fa5211432a598a8d2b5b454b201b131774b2718467aaa33", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/appearance/Theme.java": "bf11f37fa1a9e23cb3094ac4ebdf4df726bc2b65154c255ed543aadecffe4a9c", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/appearance/AppearanceContext.java": "003094632ba35520f7969b21c47e177d1b0b02b5c12f1fe7f55c108be179ade7", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/appearance/Typeface.java": "9852756ba72d705cd8b3e4eef6e434ea613c3a4f604b84dc05a940a3a848adca", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioButton.java": "3b28e4c440b0ab84df7e7fe857c1ed80659e5f81d232aec2716146240b255b8b", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/PixelGeometry.java": "4b11660623a7e4bed8817e52be853fa7c92d72c5673d28eb1960263e60b09061", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioIcon.java": "8efe9b917887fa3d89bf592ccca4629b5e31f1fc506c644687a58a4c882dcdd4", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioTextField.java": "13bc149947b3815f35e80f7f9c42c0147e693a052a10f6c0d055907d72b93724", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioFeedback.java": "e45084198e2dc0a6247604cab421990e5a757f122e197c09740ae358c857ecc7", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioText.java": "ed133ca4efa53fe73361b9e36c6d329f5b52519fee074746abedcafff1c9bcbd", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioSelect.java": "7771d0d7e75febc5d91e46cb2609ee26d0bfb34218072f804aaccb7713233912", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioToggle.java": "ffd62693d76482c361549bc0fb25aeaf1454cc246494e351c79890554975cd36", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/components/StudioPanel.java": "304cc654f43c388cc6e07c51e7ba90b5e27ba29bed6d43cbcc2c51551b03a9a2", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/i18n/Messages.java": "cb63bde25cd907f467a49b614e4839baa97b20e3e33267214edfe3e2c07f9a63", + "studio/prometeu-studio-ui-javafx-2/src/main/java/p/studio/ui/javafx2/i18n/StudioLanguage.java": "5c7c19b514f0633e39176b8defbd405d9548431c7eed2a6d6a8299f9d792ee01", + "studio/prometeu-studio-ui-javafx-2/build.gradle.kts": "8c3a91265085f306615d83014675924ed0c9073341f6e269eeca16c11482204b", + "studio/prometeu-studio-ui-javafx-2/README.md": "9a5c5f29f349387c43637e7bb115d5ff1457152fd159fd0e7cda71330fb3fd2e", + "studio/settings.gradle.kts": "d4fab4bc717155abde4e228420578679f0c0e8826f0585ad557ea0771ec67a9c", + "studio/docs/specs/studio/README.md": "bb6e3ca46c0f19abed88e72e34faf1fdead897a70521ce4f5a0b369ecefe9b84", + "studio/docs/specs/studio/13. JavaFX 2 Foundation Specification.md": "074bce4db905805447544bbf8970392bc8ab9056a8ab37b0ea0c0af8c6d5b15e" +} diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.FoundationResourcesTest.xml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.FoundationResourcesTest.xml new file mode 100644 index 0000000..ed3e1b2 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.FoundationResourcesTest.xml @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.PresentationContractTest.xml b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.PresentationContractTest.xml new file mode 100644 index 0000000..80c74d1 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/test-TEST-p.studio.ui.javafx2.PresentationContractTest.xml @@ -0,0 +1,12 @@ + + + + + + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-final-checks.log b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-final-checks.log new file mode 100644 index 0000000..0d262ee --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-final-checks.log @@ -0,0 +1,44 @@ +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target +> Task :buildSrc:checkKotlinGradlePluginConfigurationErrors SKIPPED +> Task :buildSrc:generateExternalPluginSpecBuilders UP-TO-DATE +> Task :buildSrc:extractPrecompiledScriptPluginPlugins UP-TO-DATE +> Task :buildSrc:compilePluginsBlocks UP-TO-DATE +> Task :buildSrc:generatePrecompiledScriptPluginAccessors UP-TO-DATE +> Task :buildSrc:generateScriptPluginAdapters UP-TO-DATE + +> Task :buildSrc:compileKotlin UP-TO-DATE +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target + +> Task :buildSrc:compileJava NO-SOURCE +> Task :buildSrc:compileGroovy NO-SOURCE +> Task :buildSrc:pluginDescriptors UP-TO-DATE +> Task :buildSrc:processResources UP-TO-DATE +> Task :buildSrc:classes UP-TO-DATE +> Task :buildSrc:jar UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:compileJava +> Task :prometeu-studio-ui-javafx-2:processResources +> Task :prometeu-studio-ui-javafx-2:classes +> Task :prometeu-studio-ui-javafx-2:jar +> Task :prometeu-studio-ui-javafx-2:compileTestJava +> Task :prometeu-studio-ui-javafx-2:processTestResources NO-SOURCE +> Task :prometeu-studio-ui-javafx-2:testClasses +> Task :prometeu-studio-ui-javafx-2:test +> Task :prometeu-studio-ui-javafx-2:jacocoTestReport + +> Task :prometeu-studio-ui-javafx-2:desktopTest + +FoundationDesktopTest STANDARD_ERROR + Nov 17, 2026 5:20:39 P.M. com.sun.javafx.application.PlatformImpl startup + WARNING: Unsupported JavaFX configuration: classes were loaded from 'unnamed module @36916eb0' + +FoundationDesktopTest > shellGalleryStateThemesLocalesFontsAndLifecycle() STANDARD_OUT + 20 appearance changes, average FX CSS/layout ms=19.2100021 + +> Task :prometeu-studio-ui-javafx-2:startScripts +> Task :prometeu-studio-ui-javafx-2:installDist +> Task :prometeu-animation:compileJava UP-TO-DATE +> Task :prometeu-studio-api:compileJava UP-TO-DATE +> Task :prometeu-studio-ui-javafx:compileJava UP-TO-DATE + +BUILD SUCCESSFUL in 10s +21 actionable tasks: 9 executed, 12 up-to-date diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-shell-launch.log b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-shell-launch.log new file mode 100644 index 0000000..ef3161f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/qualification/wrk0013-shell-launch.log @@ -0,0 +1,24 @@ +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target +> Task :buildSrc:checkKotlinGradlePluginConfigurationErrors SKIPPED +> Task :buildSrc:generateExternalPluginSpecBuilders UP-TO-DATE +> Task :buildSrc:extractPrecompiledScriptPluginPlugins UP-TO-DATE +> Task :buildSrc:compilePluginsBlocks UP-TO-DATE +> Task :buildSrc:generatePrecompiledScriptPluginAccessors UP-TO-DATE +> Task :buildSrc:generateScriptPluginAdapters UP-TO-DATE + +> Task :buildSrc:compileKotlin UP-TO-DATE +Kotlin does not yet support 25 JDK target, falling back to Kotlin JVM_24 JVM target + +> Task :buildSrc:compileJava NO-SOURCE +> Task :buildSrc:compileGroovy NO-SOURCE +> Task :buildSrc:pluginDescriptors UP-TO-DATE +> Task :buildSrc:processResources UP-TO-DATE +> Task :buildSrc:classes UP-TO-DATE +> Task :buildSrc:jar UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:compileJava UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:processResources UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:classes UP-TO-DATE +> Task :prometeu-studio-ui-javafx-2:run + +BUILD SUCCESSFUL in 31s +12 actionable tasks: 1 executed, 11 up-to-date diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/departure-mono-LICENSE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/departure-mono-LICENSE.txt new file mode 100644 index 0000000..de52476 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/departure-mono-LICENSE.txt @@ -0,0 +1,93 @@ +Copyright 2022–2024 Helena Zhang (helenazhang.com). + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://openfontlicense.org + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-browser.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-browser.html new file mode 100644 index 0000000..352cd58 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-browser.html @@ -0,0 +1,2821 @@ + + + + + + + +Prometeu Ui Foundation + + + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-foundation.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-foundation.html new file mode 100644 index 0000000..9a286e2 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-foundation.html @@ -0,0 +1,106 @@ + +
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono-browser.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono-browser.html new file mode 100644 index 0000000..f331b83 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono-browser.html @@ -0,0 +1,3106 @@ + + + + + + + +Prometeu Ui Mono + + + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono.html new file mode 100644 index 0000000..7035667 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-mono.html @@ -0,0 +1,391 @@ + +
+
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+

TESTE DE TEXTO · 16,5 px

+ +
+
+

Departure Mono

+

A criação começa com uma ideia. Organize suas cenas, ajuste os personagens e dê vida à aventura. Ação, música e imaginação: você escolhe o próximo passo.

+
Aa Bb Cc · á à â ã é ê í ó ô õ ú ç
+Il1 O0 · 0123456789
+{} [] () <> != == + - * /
+
+
+

Roboto Mono

+

A criação começa com uma ideia. Organize suas cenas, ajuste os personagens e dê vida à aventura. Ação, música e imaginação: você escolhe o próximo passo.

+
Aa Bb Cc · á à â ã é ê í ó ô õ ú ç
+Il1 O0 · 0123456789
+{} [] () <> != == + - * /
+
+
+
+
Departure Mono · SIL OFL 1.1
Copyright 2022–2024 Helena Zhang (helenazhang.com).
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+
Roboto Mono · SIL OFL 1.1
Copyright 2015 The Roboto Mono Project Authors (https://github.com/googlefonts/robotomono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel-browser.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel-browser.html new file mode 100644 index 0000000..13e1a13 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel-browser.html @@ -0,0 +1,2859 @@ + + + + + + + +Prometeu Ui Pixel + + + + + + + + + diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel.html b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel.html new file mode 100644 index 0000000..5de02b1 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/prometeu-ui-pixel.html @@ -0,0 +1,144 @@ + +
+
+
+
Prometeu Studio
+
+
prometeu studio
+
+ + +
+
+
+
+
+

COMPONENTES · AMOSTRAS

+
+
+
+ +
60%
+
+
+ +
+
+
+
+
+
+ diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/roboto-mono-LICENSE.txt b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/roboto-mono-LICENSE.txt new file mode 100644 index 0000000..8e7df33 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/artifacts/visuals/roboto-mono-LICENSE.txt @@ -0,0 +1,93 @@ +Copyright 2015 The Roboto Mono Project Authors (https://github.com/googlefonts/robotomono) + +This Font Software is licensed under the SIL Open Font License, Version 1.1. +This license is copied below, and is also available with a FAQ at: +https://openfontlicense.org + + +----------------------------------------------------------- +SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007 +----------------------------------------------------------- + +PREAMBLE +The goals of the Open Font License (OFL) are to stimulate worldwide +development of collaborative font projects, to support the font creation +efforts of academic and linguistic communities, and to provide a free and +open framework in which fonts may be shared and improved in partnership +with others. + +The OFL allows the licensed fonts to be used, studied, modified and +redistributed freely as long as they are not sold by themselves. The +fonts, including any derivative works, can be bundled, embedded, +redistributed and/or sold with any software provided that any reserved +names are not used by derivative works. The fonts and derivatives, +however, cannot be released under any other type of license. The +requirement for fonts to remain under this license does not apply +to any document created using the fonts or their derivatives. + +DEFINITIONS +"Font Software" refers to the set of files released by the Copyright +Holder(s) under this license and clearly marked as such. This may +include source files, build scripts and documentation. + +"Reserved Font Name" refers to any names specified as such after the +copyright statement(s). + +"Original Version" refers to the collection of Font Software components as +distributed by the Copyright Holder(s). + +"Modified Version" refers to any derivative made by adding to, deleting, +or substituting -- in part or in whole -- any of the components of the +Original Version, by changing formats or by porting the Font Software to a +new environment. + +"Author" refers to any designer, engineer, programmer, technical +writer or other person who contributed to the Font Software. + +PERMISSION & CONDITIONS +Permission is hereby granted, free of charge, to any person obtaining +a copy of the Font Software, to use, study, copy, merge, embed, modify, +redistribute, and sell modified and unmodified copies of the Font +Software, subject to the following conditions: + +1) Neither the Font Software nor any of its individual components, +in Original or Modified Versions, may be sold by itself. + +2) Original or Modified Versions of the Font Software may be bundled, +redistributed and/or sold with any software, provided that each copy +contains the above copyright notice and this license. These can be +included either as stand-alone text files, human-readable headers or +in the appropriate machine-readable metadata fields within text or +binary files as long as those fields can be easily viewed by the user. + +3) No Modified Version of the Font Software may use the Reserved Font +Name(s) unless explicit written permission is granted by the corresponding +Copyright Holder. This restriction only applies to the primary font name as +presented to the users. + +4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font +Software shall not be used to promote, endorse or advertise any +Modified Version, except to acknowledge the contribution(s) of the +Copyright Holder(s) and the Author(s) or with their explicit written +permission. + +5) The Font Software, modified or unmodified, in part or in whole, +must be distributed entirely under this license, and must not be +distributed under any other license. The requirement for fonts to +remain under this license does not apply to any document created +using the Font Software. + +TERMINATION +This license becomes null and void if any of the above conditions are +not met. + +DISCLAIMER +THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF +MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT +OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE +COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL +DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM +OTHER DEALINGS IN THE FONT SOFTWARE. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0001.md new file mode 100644 index 0000000..f74069a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0001.md @@ -0,0 +1,176 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0013" +title: "Studio UI JavaFX 2 — fundação de componentes, temas, i18n e shell mínimo" +context: "Reescrever integralmente o frontend em novo módulo JavaFX, preservando backend\ + \ e UI antiga separada para consulta funcional. Discussão reduzida ao primeiro recorte\ + \ de componentes básicos e shell mínimo, com direção visual e tipografia escolhidas\ + \ pelo humano." +approach: "Criar prometeu-studio-ui-javafx-2 com componentes próprios, molduras em\ + \ degraus e relevo, Departure Mono padrão e Roboto Mono alternativa, temas escuro/claro,\ + \ pt-BR/inglês, tipografia configurável, licenças locais e shell vazio executável.\ + \ Encapsular bibliotecas; validar comportamento desktop, lifecycle e aparência real\ + \ no macOS antes de integrar features." +alternatives: [] +rationale: "Uma fundação pequena e verificável consolida identidade, temas e i18n\ + \ desde o início, permite substituição de dependências e evita transportar a estrutura\ + \ manual da UI antiga ou antecipar ACP e editores." +risks: [] +acceptanceCriteria: [] +approvalStatus: "DRAFT" +author: "Codex" +createdAt: "2026-11-17T16:36:51.242775Z" +evidence: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0007" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T16:36:51.242775Z" +updatedBy: "Codex" +changeReason: "Draft created" +approvals: [] +revises: null +supersededBy: null +documentVersion: 2 +--- + +## Contexto e autoridade + +Esta decisão define o primeiro recorte do novo frontend do Prometeu Studio: componentes básicos e shell mínimo executável, com temas e internacionalização desde o início. O produto seguirá evoluindo como suíte visual de desenvolvimento de jogos com IA, preservando autoria manual e serviços de backend. + +A solicitação humana de emissão foi registrada em `guidance.decisionRequests` do WRK-0013 para DEC-0001, em 2026-11-17: “vamos emitir a dec entao”. Emitir o documento não equivale a aprová-lo nem a autorizar implementação. Este documento permanece DRAFT até aprovação humana explícita. Os requisitos abaixo passam a ser normativos para execução após essa aprovação e a preparação do plano correspondente. + +As evidências ART-0001–0003 registram inspeção estática de Studio, runtime e port Zelda 1. Confirmam fronteiras de serviços API/Core/MCP aproveitáveis e o caráter central dos bancos de assets. O feedback do port já contribuiu para aprimorar o Studio; não é um backlog a reabrir automaticamente. A inspeção não incluiu execução gráfica do JavaFX. + +Os estudos ART-0004–0007 permitiram discutir temas, molduras e tipografia. O humano escolheu bordas em degraus com relevo e Departure Mono como padrão, admitindo outras fontes configuráveis. ART-0007 compara Departure Mono e Roboto Mono, com ambas incorporadas e licenciadas. As verificações feitas nesses estudos foram estáticas e de cobertura de caracteres; não demonstram qualidade de renderização, acessibilidade ou performance no JavaFX. + +## Decisão + +### 1. Fronteira do novo frontend + +1. O novo frontend DEVE começar no módulo `prometeu-studio-ui-javafx-2`, dentro do projeto Studio, mantendo Java e JavaFX e as convenções de build compatíveis do repositório. +2. O módulo DEVE implementar componentes, estilos, recursos e composição próprios. NÃO DEVE depender do módulo de UI antigo, copiar seus componentes/CSS ou usá-lo como inspiração visual, conceitual ou arquitetural. +3. O módulo antigo DEVE permanecer separado e funcional para consulta de capacidades, contratos e integrações e para continuidade de uso durante a transição. Sua remoção, migração de telas e substituição do lançamento atual ficam fora deste recorte. +4. API/Core, serviços de aplicação, contratos MCP e runtime existentes DEVEM ser preservados. A UI NÃO DEVE duplicar lógica de negócio. O shell vazio NÃO DEVE inicializar agentes, runtime, build ou projeto apenas para exibir a fundação visual. +5. A fundação DEVE poder ser executada por uma entrada de desenvolvimento própria e documentada. Dependências DEVEM ser proporcionais aos consumidores reais; este recorte não exige novas abstrações de domínio ou novos módulos além do módulo de UI definido. + +### 2. Shell mínimo + +O shell DEVE conter uma janela com decoração nativa, identificação do Prometeu Studio, seletores de tema e idioma e área central vazia. O interior DEVE ter identidade visual própria e comportamento desktop previsível. + +O shell DEVE redimensionar corretamente, manter foco e ordem de navegação por teclado e administrar seu lifecycle. Fechar e reabrir NÃO DEVE duplicar listeners, timers ou recursos. A área central NÃO DEVE ser preenchida com placeholders de editores, comandos fictícios, dashboards ou painéis de features ainda ausentes. + +Uma demonstração técnica auxiliar dos componentes e estados PODE existir separada do shell do produto. Ela NÃO constitui um novo workspace e não é requisito construir um catálogo geral de controles JavaFX. + +### 3. Componentes Studio + +O conjunto inicial fica limitado às famílias abaixo, com variantes proporcionais ao shell e às demonstrações de verificação: + +| Família | Responsabilidade e estados relevantes | +| --- | --- | +| Texto e título | Hierarquia, quebra/truncamento deliberados, texto dinâmico, semântica acessível e tipografia configurável. | +| Ícone | Identidade visual pixel, dimensões previsíveis, escala e nome acessível quando transmitir significado. | +| Botão e toggle | Ações/seleção; normal, hover, foco, pressionado, selecionado e desabilitado conforme aplicabilidade. | +| Campo de texto | Entrada e validação; edição, seleção, clipboard, composição/IME, foco, desabilitado e erro. | +| Seletor | Tema/idioma e opções da demonstração; seleção, teclado, foco e popup coerente com o tema. | +| Painel e moldura | Composição e hierarquia visual, expansão e limites mínimos; sem impor docking. | +| Feedback básico | Mensagem, erro e progresso/ocupado em demonstração, com significado textual além da cor. | + +Cada componente DEVE expor contrato pequeno de propriedades, eventos, estados, defaults e ownership. Aparência e comportamento DEVEM ter responsabilidades claras. Composição de controles JavaFX é preferida quando suficiente; Control/Skin ou desenho específico DEVEM ser usados por benefício concreto, não como obrigação para todo elemento. + +Semântica e edição nativas DEVEM ser preservadas. Canvas ou desenho geométrico PODEM atender decoração específica, mas NÃO DEVEM substituir indiscriminadamente campos, botões ou seleção por superfícies sem comportamento acessível. Nenhum padrão MVVM/MVI, event bus global, sistema de plugins ou framework reativo é exigido por esta decisão. + +### 4. Design system e temas + +1. A identidade DEVE seguir a direção bananodore: paleta intencional, molduras com cantos em degraus e relevo em camadas, iconografia pixel e acabamento de ferramenta de criação de jogos. NÃO DEVE simular um sistema operacional dentro do Studio nem reduzir a resolução de toda a interface. +2. Temas iniciais: bananodore escuro e alternativa clara, completos para os componentes e estados presentes. O tema inicial é o escuro quando não existir preferência salva. +3. Cores DEVEM ser tokens semânticos de superfícies, texto, borda, foco, seleção e feedback. Espaçamento, dimensões, tipografia e iconografia DEVEM ter escalas coerentes. Valores de aparência NÃO DEVEM ficar dispersos nas views. +4. A troca de tema DEVE atualizar a janela, componentes e popups existentes sem reconstruir o domínio ou descartar estado de entrada. Recursos e seletores CSS DEVEM ter namespace próprio. +5. A paleta e a geometria de ART-0007 são referência visual de partida. Os valores exatos de cor, espessura, tamanho de fonte e espaçamento NÃO ficam congelados por este documento; ajustes coerentes com a direção podem ser feitos e documentados a partir da verificação no JavaFX. +6. O HTML dos estudos NÃO é implementação do produto nem especificação de sintaxe CSS JavaFX. A tradução DEVE respeitar os recursos reais de JavaFX e manter o efeito visual sem exigir os mesmos mecanismos do navegador. + +### 5. Tipografia e licenças + +Departure Mono DEVE ser a fonte padrão do interior da nova UI. A decoração nativa permanece sob responsabilidade da plataforma. A tipografia DEVE ser configurável por recursos/configuração de apresentação, com família e escala centralizadas; componentes NÃO DEVEM fixar uma família internamente. + +Departure Mono e Roboto Mono DEVEM estar disponíveis como recursos locais da fundação, com as licenças completas SIL OFL e avisos de copyright preservados na distribuição. Carregar fontes NÃO DEVE depender de instalação prévia ou de acesso à internet. Roboto Mono DEVE permanecer como alternativa verificável e em amostra de texto comparativa. Não se decide agora qual fonte será usada nos futuros editores ou em respostas extensas da IA. + +O primeiro recorte DEVE provar a substituição da família e ajuste da escala em demonstração/configuração. Não exige gerenciador de fontes do sistema nem tela completa de preferências. Quando houver falha de carregamento ou glifo ausente, DEVE existir fallback legível e diagnóstico; não pode haver perda silenciosa de texto. + +A verificação DEVE incluir acentos portugueses, números, pontuação e caracteres confundíveis, além de tamanhos e HiDPI reais. A recomendação da Departure de múltiplos de 11 px é referência para escolher tamanhos; não autoriza texto ilegível nem promessa de alinhamento perfeito em qualquer escala fracionária. + +### 6. Internacionalização e preferências + +1. Idiomas iniciais: pt-BR e inglês. Todo texto de interface, inclusive mensagens parametrizadas, rótulos acessíveis, menus/popups presentes e textos dinâmicos, DEVE passar pelo mecanismo de i18n desde sua criação. +2. A troca de idioma DEVE atualizar os componentes existentes sem reiniciar a janela e sem alterar conteúdo escrito pelo usuário. Código, textos do projeto e futuras respostas de agentes não são strings de interface a traduzir. +3. Formatação de números, datas e mensagens DEVE respeitar o locale. Bundles DEVEM ter cobertura de chaves verificável. Inglês é o bundle de fallback; uma chave ausente em ambos DEVE produzir marcador identificável e diagnóstico, com falha na verificação de cobertura, em vez de desaparecer silenciosamente. +4. Na primeira execução, o idioma DEVE corresponder ao locale do sistema quando suportado; caso contrário, usar inglês. Tema, idioma e configuração tipográfica explicitamente escolhidos DEVEM ser restauráveis como preferências locais do usuário, sem exigir projeto aberto. +5. A persistência DEVE ser pequena, tolerar preferência ausente/inválida e ter defaults determinísticos. Não exige migração do estado antigo, persistência de layouts de editores ou framework genérico de configurações. + +Esses defaults operacionais são definidos nesta proposta para tornar o plano executável e podem ser revistos antes da aprovação da DEC. + +### 7. Bibliotecas e separação de responsabilidades + +Bibliotecas externas são permitidas quando trouxerem benefício demonstrável de aparência ou funcionamento para o recorte. A escolha DEVE considerar compatibilidade com Java/JavaFX, licença, empacotamento, lifecycle, temas/i18n, teclado, acessibilidade e custo de renderização. + +Toda integração DEVE ficar encapsulada em componentes/adapters Studio, que traduzem eventos, propriedades, recursos e estilos. Tipos específicos da biblioteca NÃO DEVEM vazar para consumidores dos componentes nem para API/Core. Não se exige esconder os tipos nativos usuais de JavaFX ou criar wrappers mecânicos de todo o catálogo da dependência. Nenhuma biblioteca concreta adicional fica escolhida por esta DEC. + +UI e design system NÃO DEVEM executar IO ou trabalho bloqueante na FX thread. Listeners, bindings, timers e recursos DEVEM ter dono e encerramento explícitos. O módulo DEVE manter apresentação e serviços separados, sem infraestrutura especulativa para features futuras. + +## Contexto preservado para os próximos recortes + +O Studio seguirá orientado à criação visual de jogos; editor/conteúdo é a unidade principal e IA não reduz o produto a um chat. Autoria manual, orientação, pequenos ajustes e delegação ampla continuam caminhos legítimos. + +A direção futura inclui ACP e múltiplos chats por projeto com atuação sobre todo o projeto. A execução de prompt será exclusiva por projeto, impedirá novos prompts durante o trabalho, manterá interrupção acessível e devolverá edição ao terminar; interrupção deverá alcançar o agente naquele contexto. Prompt abaixo e saída acima permanecem direção de UX. Esses comportamentos não são implementados pelo shell mínimo. + +Bancos permanecem fundamentais à autoria e integração de assets; scene contém o mapa e poderá evoluir além dele. Entidades ainda não são uma feature existente do engine. Código/LSP interno e externo, gestão/edição de scenes, pixels e áudio/sequenciador terão recortes próprios. A referência Godot orienta a futura organização do ambiente, sem impor neste shell regiões vazias, docking ou cópia de sua arquitetura. + +A sequência de direção é fundação → shell/ambiente IA → Assets → editores de código/scene → Shipper. Works posteriores devem carregar os requisitos pertinentes sem herdar automaticamente aprovação ou detalhamento técnico desta DEC. + +## Alternativas consideradas e justificativa + +| Alternativa | Encaminhamento | +| --- | --- | +| Evoluir a implementação visual antiga | Rejeitada para a nova UI por escolha humana explícita; mantém-se somente como consulta funcional. | +| Trocar JavaFX ou implementar o produto como aplicação web | Fora da direção aceita; JavaFX preserva a plataforma escolhida e o backend existente. | +| Construir shell completo, ACP e editores juntos | Adiado: amplia dependências e impede verificar a fundação em um recorte pequeno. | +| Manter somente controles JavaFX sem identidade própria | Insuficiente para a direção visual; comportamento nativo será combinado com componentes e estilos Studio. | +| Desenhar todos os controles manualmente | Rejeitado como estratégia geral pelo custo de comportamento, acessibilidade e manutenção. | +| Roboto Mono como padrão | Mantida como alternativa; a escolha humana para a identidade padrão é Departure Mono. | +| Fixar fonte, paleta e medidas nas views | Rejeitado: dificulta temas, configuração tipográfica, consistência e evolução. | +| Docking livre, SDK de extensões e arquitetura genérica desde o começo | Adiados até consumidores e requisitos concretos justificarem o custo. | + +O recorte permite verificar identidade, ergonomia e contratos de apresentação antes de integrar capacidades de domínio. A separação do módulo mantém a aplicação atual utilizável e torna a adoção reversível. + +## Critérios de aceite para o plano posterior + +1. O novo módulo compila e seu shell mínimo é executável por comando documentado, sem projeto/agente/runtime; o frontend antigo continua separado e executável e não é dependência da UI nova. +2. As famílias de componentes definidas têm contratos pequenos e demonstrações suficientes dos estados aplicáveis, com bordas em degraus/relevo e conteúdo central vazio no shell do produto. +3. Escuro/claro e pt-BR/inglês são trocáveis na mesma sessão, incluindo mensagens dinâmicas e popups presentes, sem perda de entrada; defaults, fallback, chaves e restauração das preferências são verificáveis. +4. Departure Mono é padrão; Roboto Mono é alternativa local demonstrável; fonte/escala são configuráveis sem alteração das views, e ambas as licenças/avisos acompanham os recursos. +5. Teclado, foco, edição/clipboard e semântica acessível funcionam nos controles usados. Informação de estado não depende apenas de cor. Referências de contraste: texto normal 4,5:1, texto grande 3:1 e indicadores necessários de controles/estados 3:1, sem alegar certificação por esses números isolados. +6. Há inspeção visual real no macOS disponível, com capturas identificando ambiente, tema, idioma, fonte e escala. A matriz inclui janela usual e tamanho mínimo suportado, texto longo/acentuado, estados presentes e HiDPI disponível; limitações de equipamentos/escala ficam registradas. +7. Troca repetida de tema/idioma/fonte, redimensionamento e fechamento/reabertura não deixam estado incoerente ou recursos duplicados. Testes cobrem comportamento próprio e regressões relevantes, sem repetir testes internos de JavaFX/dependências. Performance é observada no ambiente real e budgets justificáveis são definidos no plano, sem inventar medições. +8. Nenhum editor, ACP, workspace de domínio, mudança de backend/runtime ou migração de projeto foi introduzido para concluir esta fundação. Evidências distinguem validação estática, execução e QA visual. + +## Riscos, limites e integração + +- **Fonte e densidade:** Departure pode exigir ajuste de tamanho, espaçamento e escala; a configuração centralizada e Roboto alternativa permitem corrigir sem redesenhar componentes. Não se presume conforto de leitura pelo mockup. +- **Tradução visual:** CSS de navegador não corresponde diretamente a CSS JavaFX. Molduras, popups e estados devem ser comprovados na implementação real, preservando semântica e foco. +- **Duas UIs:** aumenta temporariamente a superfície de build/distribuição. Manter entradas independentes, sem acoplamento ou remoção prematura da antiga. +- **Portabilidade:** JavaFX é mantido, mas o primeiro aceite visual é no macOS. Não declarar Windows/Linux validados; a matriz dessas plataformas deve ser estabelecida quando houver ambiente para executá-la. +- **Escopo:** o mínimo shell não prova futuros contratos de host de documentos, autoridade de agente, reatividade a alterações externas, undo/redo ou docking. Esses mecanismos exigirão decisões específicas. +- **Documentação histórica:** as especificações atuais do shell/componentes descrevem a implementação anterior. Esta DEC rege somente a UI nova; a integração documental futura deve identificar explicitamente essa coexistência, preservando contratos de backend e sem reinterpretar o histórico como inspiração de frontend. +- **Execução:** o workspace AIE atual declara Studio/runtime como somente leitura. Emitir esta DEC não altera essa política. O plano posterior deve identificar o contexto de implementação e acesso de escrita aplicável antes de executar mudanças nesses repositórios. + +Não há lacuna de produto bloqueante identificada para este recorte. Valores finais de tokens, escolha de biblioteca adicional, organização interna de pacotes, comando de execução e matriz detalhada de QA são escolhas de implementação/planejamento dentro dos limites acima. Se evidência exigir contrariar escopo, tecnologia, identidade ou fronteiras aprovadas, a DEC deverá ser revisada com aprovação aplicável. + +## Histórico e referências + +- 2026-11-17: emissão inicial solicitada por Nilton; DRAFT preparado por Codex para revisão. Nenhuma implementação, Plan ou aprovação de conteúdo foi registrada por esta emissão. +- Escopo e fronteiras: DSC-0024–0029. Qualidade e encapsulamento: DSC-0030. Aceite do shell/temas/idiomas: DSC-0031. Estudos e fontes: DSC-0033–0035. Escolha Departure: DSC-0036–0037. +- Evidências de base: ART-0001 (Studio), ART-0002 (runtime), ART-0003 (port Zelda). Evidência visual mais recente: ART-0007. Estudos anteriores ficam preservados para rastreabilidade, sem congelar valores finais. +- Fontes do estudo: Departure Mono 1.500, repositório `rektdeckard/departure-mono`, commit `75152a3f1e6dacdd248a6c397c97dbf27e33eea0`; Roboto Mono Regular, repositório `googlefonts/RobotoMono`, commit `7bf0b33178844cc7d0c9915b746ece1be7f46bea`. Licenças em `artifacts/visuals/departure-mono-LICENSE.txt` e `artifacts/visuals/roboto-mono-LICENSE.txt` deste Work. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0002.md new file mode 100644 index 0000000..6da986c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/.history/DEC-0001/r0002.md @@ -0,0 +1,210 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0013" +title: "Studio UI JavaFX 2 — fundação de componentes, temas, i18n e shell mínimo" +context: "Reescrever integralmente o frontend em novo módulo JavaFX, preservando backend\ + \ e UI antiga separada para consulta funcional. Discussão reduzida ao primeiro recorte\ + \ de componentes básicos e shell mínimo, com direção visual e tipografia escolhidas\ + \ pelo humano." +approach: "Criar prometeu-studio-ui-javafx-2 com componentes próprios, molduras em\ + \ degraus e relevo, Departure Mono padrão e Roboto Mono alternativa, temas escuro/claro,\ + \ pt-BR/inglês, tipografia configurável, licenças locais e shell vazio executável.\ + \ Encapsular bibliotecas; validar comportamento desktop, lifecycle e aparência real\ + \ no macOS antes de integrar features." +alternatives: +- "Adaptar a UI antiga: rejeitada para a nova UI por escolha humana; somente consulta\ + \ funcional." +- "Implementar shell completo, ACP e editores agora: adiado para Works posteriores." +- "Desenhar todos os controles manualmente: rejeitado como estratégia geral; preservar\ + \ semântica JavaFX com componentes próprios." +- "Roboto Mono padrão: mantida como alternativa; Departure foi a escolha humana para\ + \ identidade." +rationale: "Uma fundação pequena e verificável consolida identidade, temas e i18n\ + \ desde o início, permite substituição de dependências e evita transportar a estrutura\ + \ manual da UI antiga ou antecipar ACP e editores." +risks: +- "Departure pode exigir ajustes de tamanho/escala; legibilidade e HiDPI precisam\ + \ de validação JavaFX." +- "HTML/CSS dos estudos não garante reprodução em JavaFX; verificar geometria, popups\ + \ e estados reais." +- "Coexistência de duas UIs exige entradas separadas e dependências sem acoplamento." +- "Aceite visual inicial é no macOS; Windows/Linux exigirão validação própria." +- "Host de documentos, autoridade ACP e reatividade externa continuam fora deste recorte\ + \ e dependem de decisões futuras." +- "Workspace AIE atual mantém Studio/runtime somente leitura; o plano deve estabelecer\ + \ o contexto de implementação e escrita aplicável." +acceptanceCriteria: +- "Módulo novo e shell mínimo executáveis independentemente, sem dependência da UI\ + \ antiga ou inicialização de projeto/agente/runtime; UI antiga preservada." +- "Componentes básicos com contratos e estados verificáveis, bordas em degraus/relevo\ + \ e centro vazio no shell do produto." +- "Temas escuro/claro e pt-BR/inglês trocáveis na sessão, com mensagens/popups, cobertura\ + \ de chaves, fallback, formatação e preferências restauráveis." +- "Departure Mono padrão e Roboto Mono alternativa local, família/escala configurá\ + veis, amostras comparativas e licenças/copyright na distribuição." +- "Comportamento desktop e semântica acessível verificados: foco, teclado, clipboard/ediç\ + ão e contraste dos estados aplicáveis." +- "QA visual real no macOS com capturas e ambiente identificados, resize, texto longo/acentuado\ + \ e HiDPI disponível; sem alegar outras plataformas validadas." +- "Lifecycle e responsividade verificados, sem trabalho bloqueante na FX thread ou\ + \ recursos duplicados; testes focados nos contratos próprios." +- "Sem editores, ACP, workspaces de domínio ou mudanças de backend/runtime; evidê\ + ncias distinguem análise estática, execução e QA visual." +approvalStatus: "DRAFT" +author: "Codex" +createdAt: "2026-11-17T16:36:51.242775Z" +evidence: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0007" +revision: 2 +previousHash: "f91816ff05b3514ffbed6bedf19b88d098437eecc3f96e1a5e54c926abd775b4" +updatedAt: "2026-11-17T16:37:12.617094Z" +updatedBy: "Codex" +changeReason: "Materializar critérios, alternativas e riscos da proposta nos campos\ + \ estruturados para orientar revisão e plano posterior." +approvals: [] +revises: null +supersededBy: null +documentVersion: 2 +--- + +## Contexto e autoridade + +Esta decisão define o primeiro recorte do novo frontend do Prometeu Studio: componentes básicos e shell mínimo executável, com temas e internacionalização desde o início. O produto seguirá evoluindo como suíte visual de desenvolvimento de jogos com IA, preservando autoria manual e serviços de backend. + +A solicitação humana de emissão foi registrada em `guidance.decisionRequests` do WRK-0013 para DEC-0001, em 2026-11-17: “vamos emitir a dec entao”. Emitir o documento não equivale a aprová-lo nem a autorizar implementação. Este documento permanece DRAFT até aprovação humana explícita. Os requisitos abaixo passam a ser normativos para execução após essa aprovação e a preparação do plano correspondente. + +As evidências ART-0001–0003 registram inspeção estática de Studio, runtime e port Zelda 1. Confirmam fronteiras de serviços API/Core/MCP aproveitáveis e o caráter central dos bancos de assets. O feedback do port já contribuiu para aprimorar o Studio; não é um backlog a reabrir automaticamente. A inspeção não incluiu execução gráfica do JavaFX. + +Os estudos ART-0004–0007 permitiram discutir temas, molduras e tipografia. O humano escolheu bordas em degraus com relevo e Departure Mono como padrão, admitindo outras fontes configuráveis. ART-0007 compara Departure Mono e Roboto Mono, com ambas incorporadas e licenciadas. As verificações feitas nesses estudos foram estáticas e de cobertura de caracteres; não demonstram qualidade de renderização, acessibilidade ou performance no JavaFX. + +## Decisão + +### 1. Fronteira do novo frontend + +1. O novo frontend DEVE começar no módulo `prometeu-studio-ui-javafx-2`, dentro do projeto Studio, mantendo Java e JavaFX e as convenções de build compatíveis do repositório. +2. O módulo DEVE implementar componentes, estilos, recursos e composição próprios. NÃO DEVE depender do módulo de UI antigo, copiar seus componentes/CSS ou usá-lo como inspiração visual, conceitual ou arquitetural. +3. O módulo antigo DEVE permanecer separado e funcional para consulta de capacidades, contratos e integrações e para continuidade de uso durante a transição. Sua remoção, migração de telas e substituição do lançamento atual ficam fora deste recorte. +4. API/Core, serviços de aplicação, contratos MCP e runtime existentes DEVEM ser preservados. A UI NÃO DEVE duplicar lógica de negócio. O shell vazio NÃO DEVE inicializar agentes, runtime, build ou projeto apenas para exibir a fundação visual. +5. A fundação DEVE poder ser executada por uma entrada de desenvolvimento própria e documentada. Dependências DEVEM ser proporcionais aos consumidores reais; este recorte não exige novas abstrações de domínio ou novos módulos além do módulo de UI definido. + +### 2. Shell mínimo + +O shell DEVE conter uma janela com decoração nativa, identificação do Prometeu Studio, seletores de tema e idioma e área central vazia. O interior DEVE ter identidade visual própria e comportamento desktop previsível. + +O shell DEVE redimensionar corretamente, manter foco e ordem de navegação por teclado e administrar seu lifecycle. Fechar e reabrir NÃO DEVE duplicar listeners, timers ou recursos. A área central NÃO DEVE ser preenchida com placeholders de editores, comandos fictícios, dashboards ou painéis de features ainda ausentes. + +Uma demonstração técnica auxiliar dos componentes e estados PODE existir separada do shell do produto. Ela NÃO constitui um novo workspace e não é requisito construir um catálogo geral de controles JavaFX. + +### 3. Componentes Studio + +O conjunto inicial fica limitado às famílias abaixo, com variantes proporcionais ao shell e às demonstrações de verificação: + +| Família | Responsabilidade e estados relevantes | +| --- | --- | +| Texto e título | Hierarquia, quebra/truncamento deliberados, texto dinâmico, semântica acessível e tipografia configurável. | +| Ícone | Identidade visual pixel, dimensões previsíveis, escala e nome acessível quando transmitir significado. | +| Botão e toggle | Ações/seleção; normal, hover, foco, pressionado, selecionado e desabilitado conforme aplicabilidade. | +| Campo de texto | Entrada e validação; edição, seleção, clipboard, composição/IME, foco, desabilitado e erro. | +| Seletor | Tema/idioma e opções da demonstração; seleção, teclado, foco e popup coerente com o tema. | +| Painel e moldura | Composição e hierarquia visual, expansão e limites mínimos; sem impor docking. | +| Feedback básico | Mensagem, erro e progresso/ocupado em demonstração, com significado textual além da cor. | + +Cada componente DEVE expor contrato pequeno de propriedades, eventos, estados, defaults e ownership. Aparência e comportamento DEVEM ter responsabilidades claras. Composição de controles JavaFX é preferida quando suficiente; Control/Skin ou desenho específico DEVEM ser usados por benefício concreto, não como obrigação para todo elemento. + +Semântica e edição nativas DEVEM ser preservadas. Canvas ou desenho geométrico PODEM atender decoração específica, mas NÃO DEVEM substituir indiscriminadamente campos, botões ou seleção por superfícies sem comportamento acessível. Nenhum padrão MVVM/MVI, event bus global, sistema de plugins ou framework reativo é exigido por esta decisão. + +### 4. Design system e temas + +1. A identidade DEVE seguir a direção bananodore: paleta intencional, molduras com cantos em degraus e relevo em camadas, iconografia pixel e acabamento de ferramenta de criação de jogos. NÃO DEVE simular um sistema operacional dentro do Studio nem reduzir a resolução de toda a interface. +2. Temas iniciais: bananodore escuro e alternativa clara, completos para os componentes e estados presentes. O tema inicial é o escuro quando não existir preferência salva. +3. Cores DEVEM ser tokens semânticos de superfícies, texto, borda, foco, seleção e feedback. Espaçamento, dimensões, tipografia e iconografia DEVEM ter escalas coerentes. Valores de aparência NÃO DEVEM ficar dispersos nas views. +4. A troca de tema DEVE atualizar a janela, componentes e popups existentes sem reconstruir o domínio ou descartar estado de entrada. Recursos e seletores CSS DEVEM ter namespace próprio. +5. A paleta e a geometria de ART-0007 são referência visual de partida. Os valores exatos de cor, espessura, tamanho de fonte e espaçamento NÃO ficam congelados por este documento; ajustes coerentes com a direção podem ser feitos e documentados a partir da verificação no JavaFX. +6. O HTML dos estudos NÃO é implementação do produto nem especificação de sintaxe CSS JavaFX. A tradução DEVE respeitar os recursos reais de JavaFX e manter o efeito visual sem exigir os mesmos mecanismos do navegador. + +### 5. Tipografia e licenças + +Departure Mono DEVE ser a fonte padrão do interior da nova UI. A decoração nativa permanece sob responsabilidade da plataforma. A tipografia DEVE ser configurável por recursos/configuração de apresentação, com família e escala centralizadas; componentes NÃO DEVEM fixar uma família internamente. + +Departure Mono e Roboto Mono DEVEM estar disponíveis como recursos locais da fundação, com as licenças completas SIL OFL e avisos de copyright preservados na distribuição. Carregar fontes NÃO DEVE depender de instalação prévia ou de acesso à internet. Roboto Mono DEVE permanecer como alternativa verificável e em amostra de texto comparativa. Não se decide agora qual fonte será usada nos futuros editores ou em respostas extensas da IA. + +O primeiro recorte DEVE provar a substituição da família e ajuste da escala em demonstração/configuração. Não exige gerenciador de fontes do sistema nem tela completa de preferências. Quando houver falha de carregamento ou glifo ausente, DEVE existir fallback legível e diagnóstico; não pode haver perda silenciosa de texto. + +A verificação DEVE incluir acentos portugueses, números, pontuação e caracteres confundíveis, além de tamanhos e HiDPI reais. A recomendação da Departure de múltiplos de 11 px é referência para escolher tamanhos; não autoriza texto ilegível nem promessa de alinhamento perfeito em qualquer escala fracionária. + +### 6. Internacionalização e preferências + +1. Idiomas iniciais: pt-BR e inglês. Todo texto de interface, inclusive mensagens parametrizadas, rótulos acessíveis, menus/popups presentes e textos dinâmicos, DEVE passar pelo mecanismo de i18n desde sua criação. +2. A troca de idioma DEVE atualizar os componentes existentes sem reiniciar a janela e sem alterar conteúdo escrito pelo usuário. Código, textos do projeto e futuras respostas de agentes não são strings de interface a traduzir. +3. Formatação de números, datas e mensagens DEVE respeitar o locale. Bundles DEVEM ter cobertura de chaves verificável. Inglês é o bundle de fallback; uma chave ausente em ambos DEVE produzir marcador identificável e diagnóstico, com falha na verificação de cobertura, em vez de desaparecer silenciosamente. +4. Na primeira execução, o idioma DEVE corresponder ao locale do sistema quando suportado; caso contrário, usar inglês. Tema, idioma e configuração tipográfica explicitamente escolhidos DEVEM ser restauráveis como preferências locais do usuário, sem exigir projeto aberto. +5. A persistência DEVE ser pequena, tolerar preferência ausente/inválida e ter defaults determinísticos. Não exige migração do estado antigo, persistência de layouts de editores ou framework genérico de configurações. + +Esses defaults operacionais são definidos nesta proposta para tornar o plano executável e podem ser revistos antes da aprovação da DEC. + +### 7. Bibliotecas e separação de responsabilidades + +Bibliotecas externas são permitidas quando trouxerem benefício demonstrável de aparência ou funcionamento para o recorte. A escolha DEVE considerar compatibilidade com Java/JavaFX, licença, empacotamento, lifecycle, temas/i18n, teclado, acessibilidade e custo de renderização. + +Toda integração DEVE ficar encapsulada em componentes/adapters Studio, que traduzem eventos, propriedades, recursos e estilos. Tipos específicos da biblioteca NÃO DEVEM vazar para consumidores dos componentes nem para API/Core. Não se exige esconder os tipos nativos usuais de JavaFX ou criar wrappers mecânicos de todo o catálogo da dependência. Nenhuma biblioteca concreta adicional fica escolhida por esta DEC. + +UI e design system NÃO DEVEM executar IO ou trabalho bloqueante na FX thread. Listeners, bindings, timers e recursos DEVEM ter dono e encerramento explícitos. O módulo DEVE manter apresentação e serviços separados, sem infraestrutura especulativa para features futuras. + +## Contexto preservado para os próximos recortes + +O Studio seguirá orientado à criação visual de jogos; editor/conteúdo é a unidade principal e IA não reduz o produto a um chat. Autoria manual, orientação, pequenos ajustes e delegação ampla continuam caminhos legítimos. + +A direção futura inclui ACP e múltiplos chats por projeto com atuação sobre todo o projeto. A execução de prompt será exclusiva por projeto, impedirá novos prompts durante o trabalho, manterá interrupção acessível e devolverá edição ao terminar; interrupção deverá alcançar o agente naquele contexto. Prompt abaixo e saída acima permanecem direção de UX. Esses comportamentos não são implementados pelo shell mínimo. + +Bancos permanecem fundamentais à autoria e integração de assets; scene contém o mapa e poderá evoluir além dele. Entidades ainda não são uma feature existente do engine. Código/LSP interno e externo, gestão/edição de scenes, pixels e áudio/sequenciador terão recortes próprios. A referência Godot orienta a futura organização do ambiente, sem impor neste shell regiões vazias, docking ou cópia de sua arquitetura. + +A sequência de direção é fundação → shell/ambiente IA → Assets → editores de código/scene → Shipper. Works posteriores devem carregar os requisitos pertinentes sem herdar automaticamente aprovação ou detalhamento técnico desta DEC. + +## Alternativas consideradas e justificativa + +| Alternativa | Encaminhamento | +| --- | --- | +| Evoluir a implementação visual antiga | Rejeitada para a nova UI por escolha humana explícita; mantém-se somente como consulta funcional. | +| Trocar JavaFX ou implementar o produto como aplicação web | Fora da direção aceita; JavaFX preserva a plataforma escolhida e o backend existente. | +| Construir shell completo, ACP e editores juntos | Adiado: amplia dependências e impede verificar a fundação em um recorte pequeno. | +| Manter somente controles JavaFX sem identidade própria | Insuficiente para a direção visual; comportamento nativo será combinado com componentes e estilos Studio. | +| Desenhar todos os controles manualmente | Rejeitado como estratégia geral pelo custo de comportamento, acessibilidade e manutenção. | +| Roboto Mono como padrão | Mantida como alternativa; a escolha humana para a identidade padrão é Departure Mono. | +| Fixar fonte, paleta e medidas nas views | Rejeitado: dificulta temas, configuração tipográfica, consistência e evolução. | +| Docking livre, SDK de extensões e arquitetura genérica desde o começo | Adiados até consumidores e requisitos concretos justificarem o custo. | + +O recorte permite verificar identidade, ergonomia e contratos de apresentação antes de integrar capacidades de domínio. A separação do módulo mantém a aplicação atual utilizável e torna a adoção reversível. + +## Critérios de aceite para o plano posterior + +1. O novo módulo compila e seu shell mínimo é executável por comando documentado, sem projeto/agente/runtime; o frontend antigo continua separado e executável e não é dependência da UI nova. +2. As famílias de componentes definidas têm contratos pequenos e demonstrações suficientes dos estados aplicáveis, com bordas em degraus/relevo e conteúdo central vazio no shell do produto. +3. Escuro/claro e pt-BR/inglês são trocáveis na mesma sessão, incluindo mensagens dinâmicas e popups presentes, sem perda de entrada; defaults, fallback, chaves e restauração das preferências são verificáveis. +4. Departure Mono é padrão; Roboto Mono é alternativa local demonstrável; fonte/escala são configuráveis sem alteração das views, e ambas as licenças/avisos acompanham os recursos. +5. Teclado, foco, edição/clipboard e semântica acessível funcionam nos controles usados. Informação de estado não depende apenas de cor. Referências de contraste: texto normal 4,5:1, texto grande 3:1 e indicadores necessários de controles/estados 3:1, sem alegar certificação por esses números isolados. +6. Há inspeção visual real no macOS disponível, com capturas identificando ambiente, tema, idioma, fonte e escala. A matriz inclui janela usual e tamanho mínimo suportado, texto longo/acentuado, estados presentes e HiDPI disponível; limitações de equipamentos/escala ficam registradas. +7. Troca repetida de tema/idioma/fonte, redimensionamento e fechamento/reabertura não deixam estado incoerente ou recursos duplicados. Testes cobrem comportamento próprio e regressões relevantes, sem repetir testes internos de JavaFX/dependências. Performance é observada no ambiente real e budgets justificáveis são definidos no plano, sem inventar medições. +8. Nenhum editor, ACP, workspace de domínio, mudança de backend/runtime ou migração de projeto foi introduzido para concluir esta fundação. Evidências distinguem validação estática, execução e QA visual. + +## Riscos, limites e integração + +- **Fonte e densidade:** Departure pode exigir ajuste de tamanho, espaçamento e escala; a configuração centralizada e Roboto alternativa permitem corrigir sem redesenhar componentes. Não se presume conforto de leitura pelo mockup. +- **Tradução visual:** CSS de navegador não corresponde diretamente a CSS JavaFX. Molduras, popups e estados devem ser comprovados na implementação real, preservando semântica e foco. +- **Duas UIs:** aumenta temporariamente a superfície de build/distribuição. Manter entradas independentes, sem acoplamento ou remoção prematura da antiga. +- **Portabilidade:** JavaFX é mantido, mas o primeiro aceite visual é no macOS. Não declarar Windows/Linux validados; a matriz dessas plataformas deve ser estabelecida quando houver ambiente para executá-la. +- **Escopo:** o mínimo shell não prova futuros contratos de host de documentos, autoridade de agente, reatividade a alterações externas, undo/redo ou docking. Esses mecanismos exigirão decisões específicas. +- **Documentação histórica:** as especificações atuais do shell/componentes descrevem a implementação anterior. Esta DEC rege somente a UI nova; a integração documental futura deve identificar explicitamente essa coexistência, preservando contratos de backend e sem reinterpretar o histórico como inspiração de frontend. +- **Execução:** o workspace AIE atual declara Studio/runtime como somente leitura. Emitir esta DEC não altera essa política. O plano posterior deve identificar o contexto de implementação e acesso de escrita aplicável antes de executar mudanças nesses repositórios. + +Não há lacuna de produto bloqueante identificada para este recorte. Valores finais de tokens, escolha de biblioteca adicional, organização interna de pacotes, comando de execução e matriz detalhada de QA são escolhas de implementação/planejamento dentro dos limites acima. Se evidência exigir contrariar escopo, tecnologia, identidade ou fronteiras aprovadas, a DEC deverá ser revisada com aprovação aplicável. + +## Histórico e referências + +- 2026-11-17: emissão inicial solicitada por Nilton; DRAFT preparado por Codex para revisão. Nenhuma implementação, Plan ou aprovação de conteúdo foi registrada por esta emissão. +- Escopo e fronteiras: DSC-0024–0029. Qualidade e encapsulamento: DSC-0030. Aceite do shell/temas/idiomas: DSC-0031. Estudos e fontes: DSC-0033–0035. Escolha Departure: DSC-0036–0037. +- Evidências de base: ART-0001 (Studio), ART-0002 (runtime), ART-0003 (port Zelda). Evidência visual mais recente: ART-0007. Estudos anteriores ficam preservados para rastreabilidade, sem congelar valores finais. +- Fontes do estudo: Departure Mono 1.500, repositório `rektdeckard/departure-mono`, commit `75152a3f1e6dacdd248a6c397c97dbf27e33eea0`; Roboto Mono Regular, repositório `googlefonts/RobotoMono`, commit `7bf0b33178844cc7d0c9915b746ece1be7f46bea`. Licenças em `artifacts/visuals/departure-mono-LICENSE.txt` e `artifacts/visuals/roboto-mono-LICENSE.txt` deste Work. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/DEC-0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/DEC-0001.md new file mode 100644 index 0000000..2f310f7 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/decisions/DEC-0001.md @@ -0,0 +1,216 @@ +--- +schemaVersion: 1 +id: "DEC-0001" +workId: "WRK-0013" +title: "Studio UI JavaFX 2 — fundação de componentes, temas, i18n e shell mínimo" +context: "Reescrever integralmente o frontend em novo módulo JavaFX, preservando backend\ + \ e UI antiga separada para consulta funcional. Discussão reduzida ao primeiro recorte\ + \ de componentes básicos e shell mínimo, com direção visual e tipografia escolhidas\ + \ pelo humano." +approach: "Criar prometeu-studio-ui-javafx-2 com componentes próprios, molduras em\ + \ degraus e relevo, Departure Mono padrão e Roboto Mono alternativa, temas escuro/claro,\ + \ pt-BR/inglês, tipografia configurável, licenças locais e shell vazio executável.\ + \ Encapsular bibliotecas; validar comportamento desktop, lifecycle e aparência real\ + \ no macOS antes de integrar features." +alternatives: +- "Adaptar a UI antiga: rejeitada para a nova UI por escolha humana; somente consulta\ + \ funcional." +- "Implementar shell completo, ACP e editores agora: adiado para Works posteriores." +- "Desenhar todos os controles manualmente: rejeitado como estratégia geral; preservar\ + \ semântica JavaFX com componentes próprios." +- "Roboto Mono padrão: mantida como alternativa; Departure foi a escolha humana para\ + \ identidade." +rationale: "Uma fundação pequena e verificável consolida identidade, temas e i18n\ + \ desde o início, permite substituição de dependências e evita transportar a estrutura\ + \ manual da UI antiga ou antecipar ACP e editores." +risks: +- "Departure pode exigir ajustes de tamanho/escala; legibilidade e HiDPI precisam\ + \ de validação JavaFX." +- "HTML/CSS dos estudos não garante reprodução em JavaFX; verificar geometria, popups\ + \ e estados reais." +- "Coexistência de duas UIs exige entradas separadas e dependências sem acoplamento." +- "Aceite visual inicial é no macOS; Windows/Linux exigirão validação própria." +- "Host de documentos, autoridade ACP e reatividade externa continuam fora deste recorte\ + \ e dependem de decisões futuras." +- "Workspace AIE atual mantém Studio/runtime somente leitura; o plano deve estabelecer\ + \ o contexto de implementação e escrita aplicável." +acceptanceCriteria: +- "Módulo novo e shell mínimo executáveis independentemente, sem dependência da UI\ + \ antiga ou inicialização de projeto/agente/runtime; UI antiga preservada." +- "Componentes básicos com contratos e estados verificáveis, bordas em degraus/relevo\ + \ e centro vazio no shell do produto." +- "Temas escuro/claro e pt-BR/inglês trocáveis na sessão, com mensagens/popups, cobertura\ + \ de chaves, fallback, formatação e preferências restauráveis." +- "Departure Mono padrão e Roboto Mono alternativa local, família/escala configurá\ + veis, amostras comparativas e licenças/copyright na distribuição." +- "Comportamento desktop e semântica acessível verificados: foco, teclado, clipboard/ediç\ + ão e contraste dos estados aplicáveis." +- "QA visual real no macOS com capturas e ambiente identificados, resize, texto longo/acentuado\ + \ e HiDPI disponível; sem alegar outras plataformas validadas." +- "Lifecycle e responsividade verificados, sem trabalho bloqueante na FX thread ou\ + \ recursos duplicados; testes focados nos contratos próprios." +- "Sem editores, ACP, workspaces de domínio ou mudanças de backend/runtime; evidê\ + ncias distinguem análise estática, execução e QA visual." +approvalStatus: "ACCEPTED" +author: "Codex" +createdAt: "2026-11-17T16:36:51.242775Z" +evidence: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0007" +revision: 3 +previousHash: "9770dd93df46e966acdf62426763d4dd5fa6466862459e9ef9acc6e5019c5f69" +updatedAt: "2026-11-17T16:39:26.043667Z" +updatedBy: "Nilton" +changeReason: "Aprovação humana explícita: vamos aceitar a dec e gerar o plan, e depois\ + \ impl." +approvals: +- status: "ACCEPTED" + by: "Nilton" + reason: "Aprovação humana explícita: vamos aceitar a dec e gerar o plan, e depois\ + \ impl." + at: "2026-11-17T16:39:26.043477Z" + humanApproved: true +revises: null +supersededBy: null +documentVersion: 2 +--- + +## Contexto e autoridade + +Esta decisão define o primeiro recorte do novo frontend do Prometeu Studio: componentes básicos e shell mínimo executável, com temas e internacionalização desde o início. O produto seguirá evoluindo como suíte visual de desenvolvimento de jogos com IA, preservando autoria manual e serviços de backend. + +A solicitação humana de emissão foi registrada em `guidance.decisionRequests` do WRK-0013 para DEC-0001, em 2026-11-17: “vamos emitir a dec entao”. Emitir o documento não equivale a aprová-lo nem a autorizar implementação. Este documento permanece DRAFT até aprovação humana explícita. Os requisitos abaixo passam a ser normativos para execução após essa aprovação e a preparação do plano correspondente. + +As evidências ART-0001–0003 registram inspeção estática de Studio, runtime e port Zelda 1. Confirmam fronteiras de serviços API/Core/MCP aproveitáveis e o caráter central dos bancos de assets. O feedback do port já contribuiu para aprimorar o Studio; não é um backlog a reabrir automaticamente. A inspeção não incluiu execução gráfica do JavaFX. + +Os estudos ART-0004–0007 permitiram discutir temas, molduras e tipografia. O humano escolheu bordas em degraus com relevo e Departure Mono como padrão, admitindo outras fontes configuráveis. ART-0007 compara Departure Mono e Roboto Mono, com ambas incorporadas e licenciadas. As verificações feitas nesses estudos foram estáticas e de cobertura de caracteres; não demonstram qualidade de renderização, acessibilidade ou performance no JavaFX. + +## Decisão + +### 1. Fronteira do novo frontend + +1. O novo frontend DEVE começar no módulo `prometeu-studio-ui-javafx-2`, dentro do projeto Studio, mantendo Java e JavaFX e as convenções de build compatíveis do repositório. +2. O módulo DEVE implementar componentes, estilos, recursos e composição próprios. NÃO DEVE depender do módulo de UI antigo, copiar seus componentes/CSS ou usá-lo como inspiração visual, conceitual ou arquitetural. +3. O módulo antigo DEVE permanecer separado e funcional para consulta de capacidades, contratos e integrações e para continuidade de uso durante a transição. Sua remoção, migração de telas e substituição do lançamento atual ficam fora deste recorte. +4. API/Core, serviços de aplicação, contratos MCP e runtime existentes DEVEM ser preservados. A UI NÃO DEVE duplicar lógica de negócio. O shell vazio NÃO DEVE inicializar agentes, runtime, build ou projeto apenas para exibir a fundação visual. +5. A fundação DEVE poder ser executada por uma entrada de desenvolvimento própria e documentada. Dependências DEVEM ser proporcionais aos consumidores reais; este recorte não exige novas abstrações de domínio ou novos módulos além do módulo de UI definido. + +### 2. Shell mínimo + +O shell DEVE conter uma janela com decoração nativa, identificação do Prometeu Studio, seletores de tema e idioma e área central vazia. O interior DEVE ter identidade visual própria e comportamento desktop previsível. + +O shell DEVE redimensionar corretamente, manter foco e ordem de navegação por teclado e administrar seu lifecycle. Fechar e reabrir NÃO DEVE duplicar listeners, timers ou recursos. A área central NÃO DEVE ser preenchida com placeholders de editores, comandos fictícios, dashboards ou painéis de features ainda ausentes. + +Uma demonstração técnica auxiliar dos componentes e estados PODE existir separada do shell do produto. Ela NÃO constitui um novo workspace e não é requisito construir um catálogo geral de controles JavaFX. + +### 3. Componentes Studio + +O conjunto inicial fica limitado às famílias abaixo, com variantes proporcionais ao shell e às demonstrações de verificação: + +| Família | Responsabilidade e estados relevantes | +| --- | --- | +| Texto e título | Hierarquia, quebra/truncamento deliberados, texto dinâmico, semântica acessível e tipografia configurável. | +| Ícone | Identidade visual pixel, dimensões previsíveis, escala e nome acessível quando transmitir significado. | +| Botão e toggle | Ações/seleção; normal, hover, foco, pressionado, selecionado e desabilitado conforme aplicabilidade. | +| Campo de texto | Entrada e validação; edição, seleção, clipboard, composição/IME, foco, desabilitado e erro. | +| Seletor | Tema/idioma e opções da demonstração; seleção, teclado, foco e popup coerente com o tema. | +| Painel e moldura | Composição e hierarquia visual, expansão e limites mínimos; sem impor docking. | +| Feedback básico | Mensagem, erro e progresso/ocupado em demonstração, com significado textual além da cor. | + +Cada componente DEVE expor contrato pequeno de propriedades, eventos, estados, defaults e ownership. Aparência e comportamento DEVEM ter responsabilidades claras. Composição de controles JavaFX é preferida quando suficiente; Control/Skin ou desenho específico DEVEM ser usados por benefício concreto, não como obrigação para todo elemento. + +Semântica e edição nativas DEVEM ser preservadas. Canvas ou desenho geométrico PODEM atender decoração específica, mas NÃO DEVEM substituir indiscriminadamente campos, botões ou seleção por superfícies sem comportamento acessível. Nenhum padrão MVVM/MVI, event bus global, sistema de plugins ou framework reativo é exigido por esta decisão. + +### 4. Design system e temas + +1. A identidade DEVE seguir a direção bananodore: paleta intencional, molduras com cantos em degraus e relevo em camadas, iconografia pixel e acabamento de ferramenta de criação de jogos. NÃO DEVE simular um sistema operacional dentro do Studio nem reduzir a resolução de toda a interface. +2. Temas iniciais: bananodore escuro e alternativa clara, completos para os componentes e estados presentes. O tema inicial é o escuro quando não existir preferência salva. +3. Cores DEVEM ser tokens semânticos de superfícies, texto, borda, foco, seleção e feedback. Espaçamento, dimensões, tipografia e iconografia DEVEM ter escalas coerentes. Valores de aparência NÃO DEVEM ficar dispersos nas views. +4. A troca de tema DEVE atualizar a janela, componentes e popups existentes sem reconstruir o domínio ou descartar estado de entrada. Recursos e seletores CSS DEVEM ter namespace próprio. +5. A paleta e a geometria de ART-0007 são referência visual de partida. Os valores exatos de cor, espessura, tamanho de fonte e espaçamento NÃO ficam congelados por este documento; ajustes coerentes com a direção podem ser feitos e documentados a partir da verificação no JavaFX. +6. O HTML dos estudos NÃO é implementação do produto nem especificação de sintaxe CSS JavaFX. A tradução DEVE respeitar os recursos reais de JavaFX e manter o efeito visual sem exigir os mesmos mecanismos do navegador. + +### 5. Tipografia e licenças + +Departure Mono DEVE ser a fonte padrão do interior da nova UI. A decoração nativa permanece sob responsabilidade da plataforma. A tipografia DEVE ser configurável por recursos/configuração de apresentação, com família e escala centralizadas; componentes NÃO DEVEM fixar uma família internamente. + +Departure Mono e Roboto Mono DEVEM estar disponíveis como recursos locais da fundação, com as licenças completas SIL OFL e avisos de copyright preservados na distribuição. Carregar fontes NÃO DEVE depender de instalação prévia ou de acesso à internet. Roboto Mono DEVE permanecer como alternativa verificável e em amostra de texto comparativa. Não se decide agora qual fonte será usada nos futuros editores ou em respostas extensas da IA. + +O primeiro recorte DEVE provar a substituição da família e ajuste da escala em demonstração/configuração. Não exige gerenciador de fontes do sistema nem tela completa de preferências. Quando houver falha de carregamento ou glifo ausente, DEVE existir fallback legível e diagnóstico; não pode haver perda silenciosa de texto. + +A verificação DEVE incluir acentos portugueses, números, pontuação e caracteres confundíveis, além de tamanhos e HiDPI reais. A recomendação da Departure de múltiplos de 11 px é referência para escolher tamanhos; não autoriza texto ilegível nem promessa de alinhamento perfeito em qualquer escala fracionária. + +### 6. Internacionalização e preferências + +1. Idiomas iniciais: pt-BR e inglês. Todo texto de interface, inclusive mensagens parametrizadas, rótulos acessíveis, menus/popups presentes e textos dinâmicos, DEVE passar pelo mecanismo de i18n desde sua criação. +2. A troca de idioma DEVE atualizar os componentes existentes sem reiniciar a janela e sem alterar conteúdo escrito pelo usuário. Código, textos do projeto e futuras respostas de agentes não são strings de interface a traduzir. +3. Formatação de números, datas e mensagens DEVE respeitar o locale. Bundles DEVEM ter cobertura de chaves verificável. Inglês é o bundle de fallback; uma chave ausente em ambos DEVE produzir marcador identificável e diagnóstico, com falha na verificação de cobertura, em vez de desaparecer silenciosamente. +4. Na primeira execução, o idioma DEVE corresponder ao locale do sistema quando suportado; caso contrário, usar inglês. Tema, idioma e configuração tipográfica explicitamente escolhidos DEVEM ser restauráveis como preferências locais do usuário, sem exigir projeto aberto. +5. A persistência DEVE ser pequena, tolerar preferência ausente/inválida e ter defaults determinísticos. Não exige migração do estado antigo, persistência de layouts de editores ou framework genérico de configurações. + +Esses defaults operacionais são definidos nesta proposta para tornar o plano executável e podem ser revistos antes da aprovação da DEC. + +### 7. Bibliotecas e separação de responsabilidades + +Bibliotecas externas são permitidas quando trouxerem benefício demonstrável de aparência ou funcionamento para o recorte. A escolha DEVE considerar compatibilidade com Java/JavaFX, licença, empacotamento, lifecycle, temas/i18n, teclado, acessibilidade e custo de renderização. + +Toda integração DEVE ficar encapsulada em componentes/adapters Studio, que traduzem eventos, propriedades, recursos e estilos. Tipos específicos da biblioteca NÃO DEVEM vazar para consumidores dos componentes nem para API/Core. Não se exige esconder os tipos nativos usuais de JavaFX ou criar wrappers mecânicos de todo o catálogo da dependência. Nenhuma biblioteca concreta adicional fica escolhida por esta DEC. + +UI e design system NÃO DEVEM executar IO ou trabalho bloqueante na FX thread. Listeners, bindings, timers e recursos DEVEM ter dono e encerramento explícitos. O módulo DEVE manter apresentação e serviços separados, sem infraestrutura especulativa para features futuras. + +## Contexto preservado para os próximos recortes + +O Studio seguirá orientado à criação visual de jogos; editor/conteúdo é a unidade principal e IA não reduz o produto a um chat. Autoria manual, orientação, pequenos ajustes e delegação ampla continuam caminhos legítimos. + +A direção futura inclui ACP e múltiplos chats por projeto com atuação sobre todo o projeto. A execução de prompt será exclusiva por projeto, impedirá novos prompts durante o trabalho, manterá interrupção acessível e devolverá edição ao terminar; interrupção deverá alcançar o agente naquele contexto. Prompt abaixo e saída acima permanecem direção de UX. Esses comportamentos não são implementados pelo shell mínimo. + +Bancos permanecem fundamentais à autoria e integração de assets; scene contém o mapa e poderá evoluir além dele. Entidades ainda não são uma feature existente do engine. Código/LSP interno e externo, gestão/edição de scenes, pixels e áudio/sequenciador terão recortes próprios. A referência Godot orienta a futura organização do ambiente, sem impor neste shell regiões vazias, docking ou cópia de sua arquitetura. + +A sequência de direção é fundação → shell/ambiente IA → Assets → editores de código/scene → Shipper. Works posteriores devem carregar os requisitos pertinentes sem herdar automaticamente aprovação ou detalhamento técnico desta DEC. + +## Alternativas consideradas e justificativa + +| Alternativa | Encaminhamento | +| --- | --- | +| Evoluir a implementação visual antiga | Rejeitada para a nova UI por escolha humana explícita; mantém-se somente como consulta funcional. | +| Trocar JavaFX ou implementar o produto como aplicação web | Fora da direção aceita; JavaFX preserva a plataforma escolhida e o backend existente. | +| Construir shell completo, ACP e editores juntos | Adiado: amplia dependências e impede verificar a fundação em um recorte pequeno. | +| Manter somente controles JavaFX sem identidade própria | Insuficiente para a direção visual; comportamento nativo será combinado com componentes e estilos Studio. | +| Desenhar todos os controles manualmente | Rejeitado como estratégia geral pelo custo de comportamento, acessibilidade e manutenção. | +| Roboto Mono como padrão | Mantida como alternativa; a escolha humana para a identidade padrão é Departure Mono. | +| Fixar fonte, paleta e medidas nas views | Rejeitado: dificulta temas, configuração tipográfica, consistência e evolução. | +| Docking livre, SDK de extensões e arquitetura genérica desde o começo | Adiados até consumidores e requisitos concretos justificarem o custo. | + +O recorte permite verificar identidade, ergonomia e contratos de apresentação antes de integrar capacidades de domínio. A separação do módulo mantém a aplicação atual utilizável e torna a adoção reversível. + +## Critérios de aceite para o plano posterior + +1. O novo módulo compila e seu shell mínimo é executável por comando documentado, sem projeto/agente/runtime; o frontend antigo continua separado e executável e não é dependência da UI nova. +2. As famílias de componentes definidas têm contratos pequenos e demonstrações suficientes dos estados aplicáveis, com bordas em degraus/relevo e conteúdo central vazio no shell do produto. +3. Escuro/claro e pt-BR/inglês são trocáveis na mesma sessão, incluindo mensagens dinâmicas e popups presentes, sem perda de entrada; defaults, fallback, chaves e restauração das preferências são verificáveis. +4. Departure Mono é padrão; Roboto Mono é alternativa local demonstrável; fonte/escala são configuráveis sem alteração das views, e ambas as licenças/avisos acompanham os recursos. +5. Teclado, foco, edição/clipboard e semântica acessível funcionam nos controles usados. Informação de estado não depende apenas de cor. Referências de contraste: texto normal 4,5:1, texto grande 3:1 e indicadores necessários de controles/estados 3:1, sem alegar certificação por esses números isolados. +6. Há inspeção visual real no macOS disponível, com capturas identificando ambiente, tema, idioma, fonte e escala. A matriz inclui janela usual e tamanho mínimo suportado, texto longo/acentuado, estados presentes e HiDPI disponível; limitações de equipamentos/escala ficam registradas. +7. Troca repetida de tema/idioma/fonte, redimensionamento e fechamento/reabertura não deixam estado incoerente ou recursos duplicados. Testes cobrem comportamento próprio e regressões relevantes, sem repetir testes internos de JavaFX/dependências. Performance é observada no ambiente real e budgets justificáveis são definidos no plano, sem inventar medições. +8. Nenhum editor, ACP, workspace de domínio, mudança de backend/runtime ou migração de projeto foi introduzido para concluir esta fundação. Evidências distinguem validação estática, execução e QA visual. + +## Riscos, limites e integração + +- **Fonte e densidade:** Departure pode exigir ajuste de tamanho, espaçamento e escala; a configuração centralizada e Roboto alternativa permitem corrigir sem redesenhar componentes. Não se presume conforto de leitura pelo mockup. +- **Tradução visual:** CSS de navegador não corresponde diretamente a CSS JavaFX. Molduras, popups e estados devem ser comprovados na implementação real, preservando semântica e foco. +- **Duas UIs:** aumenta temporariamente a superfície de build/distribuição. Manter entradas independentes, sem acoplamento ou remoção prematura da antiga. +- **Portabilidade:** JavaFX é mantido, mas o primeiro aceite visual é no macOS. Não declarar Windows/Linux validados; a matriz dessas plataformas deve ser estabelecida quando houver ambiente para executá-la. +- **Escopo:** o mínimo shell não prova futuros contratos de host de documentos, autoridade de agente, reatividade a alterações externas, undo/redo ou docking. Esses mecanismos exigirão decisões específicas. +- **Documentação histórica:** as especificações atuais do shell/componentes descrevem a implementação anterior. Esta DEC rege somente a UI nova; a integração documental futura deve identificar explicitamente essa coexistência, preservando contratos de backend e sem reinterpretar o histórico como inspiração de frontend. +- **Execução:** o workspace AIE atual declara Studio/runtime como somente leitura. Emitir esta DEC não altera essa política. O plano posterior deve identificar o contexto de implementação e acesso de escrita aplicável antes de executar mudanças nesses repositórios. + +Não há lacuna de produto bloqueante identificada para este recorte. Valores finais de tokens, escolha de biblioteca adicional, organização interna de pacotes, comando de execução e matriz detalhada de QA são escolhas de implementação/planejamento dentro dos limites acima. Se evidência exigir contrariar escopo, tecnologia, identidade ou fronteiras aprovadas, a DEC deverá ser revisada com aprovação aplicável. + +## Histórico e referências + +- 2026-11-17: emissão inicial solicitada por Nilton; DRAFT preparado por Codex para revisão. Nenhuma implementação, Plan ou aprovação de conteúdo foi registrada por esta emissão. +- Escopo e fronteiras: DSC-0024–0029. Qualidade e encapsulamento: DSC-0030. Aceite do shell/temas/idiomas: DSC-0031. Estudos e fontes: DSC-0033–0035. Escolha Departure: DSC-0036–0037. +- Evidências de base: ART-0001 (Studio), ART-0002 (runtime), ART-0003 (port Zelda). Evidência visual mais recente: ART-0007. Estudos anteriores ficam preservados para rastreabilidade, sem congelar valores finais. +- Fontes do estudo: Departure Mono 1.500, repositório `rektdeckard/departure-mono`, commit `75152a3f1e6dacdd248a6c397c97dbf27e33eea0`; Roboto Mono Regular, repositório `googlefonts/RobotoMono`, commit `7bf0b33178844cc7d0c9915b746ece1be7f46bea`. Licenças em `artifacts/visuals/departure-mono-LICENSE.txt` e `artifacts/visuals/roboto-mono-LICENSE.txt` deste Work. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0001.md new file mode 100644 index 0000000..d1d05c0 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0001.md @@ -0,0 +1,408 @@ +--- +schemaVersion: 1 +id: "DSC-0001" +workId: "WRK-0013" +discussionId: "main" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T09:51:46.180557Z" +respondsTo: null +documentVersion: 2 +--- + +# Prometeu Studio — UX/UI Redesign & AI-First Experience + +## Contexto + +Quero iniciar uma discussão sobre uma reformulação profunda da experiência de usuário (UX) e da interface gráfica (UI) do Prometeu Studio. + +**Esta é uma atividade de discovery, análise e planejamento. Não implemente alterações ainda.** + +Antes de propor qualquer solução, examine o código, a arquitetura, os componentes JavaFX, os workspaces existentes, as especificações e as decisões arquiteturais registradas no repositório. + +Quero que você questione a estrutura atual, em vez de simplesmente propor melhorias cosméticas sobre ela. + +O objetivo não é preservar todas as decisões de UX anteriores. O produto evoluiu significativamente, especialmente com a introdução de uma arquitetura AI-first. + +--- + +## 1. Visão do produto + +O Prometeu Studio é o ambiente de desenvolvimento do ecossistema Prometeu. + +Ele possui diversas responsabilidades, que não devem ser reduzidas aos exemplos abaixo. Entretanto, algumas capacidades fundamentais incluem: + +- Organização e gerenciamento de projetos e assets. +- Integração com agentes de IA por meio de MCP. +- Compilação, execução, depuração e empacotamento. +- Gerenciamento e inspeção de recursos. +- Ferramentas de autoria e desenvolvimento. +- Futuramente, edição integrada de código e scenes. + +O Studio já possui uma implementação funcional, construída principalmente com Java e JavaFX, além de contratos e serviços existentes. + +Não estamos propondo reescrever a aplicação em outro framework. + +**Queremos preservar a infraestrutura que funciona e reformular profundamente a forma como o usuário interage com ela.** + +## 2. O problema atual + +Minha percepção é que o frontend está excessivamente complexo, desorganizado e visualmente pouco atraente. + +Existem muitos controles, painéis, formulários e operações que parecem ter sido adicionados ao longo do desenvolvimento sem uma revisão consistente de UX. + +O resultado é uma interface com características de aplicação enterprise, em vez de uma ferramenta de criação de jogos. + +Suspeito que parte significativa dessa complexidade seja consequência da arquitetura original, orientada a operações manuais. + +Não assuma que todos os elementos atualmente visíveis precisam continuar existindo. + +Quero identificar: + +- Funcionalidades redundantes. +- Informações técnicas expostas sem necessidade. +- Controles de baixa frequência de utilização. +- Fluxos manuais que já podem ser executados pela IA. +- Workspaces que poderiam ser consolidados. +- Problemas de navegação e hierarquia visual. +- Componentes que deveriam ser contextuais. +- Oportunidades de simplificação sem perda funcional. + +Também quero distinguir funcionalidades realmente úteis de elementos que existem apenas por decisões históricas de implementação. + +## 3. A transição para AI-first + +Este é um ponto fundamental. + +O Studio foi originalmente desenvolvido em torno de um workflow manual. + +O gerenciamento de assets é um exemplo importante: diversas etapas de importação, configuração, declaração, validação e preparação dos recursos eram executadas individualmente pelo usuário. + +Com a evolução da integração MCP e dos agentes de IA, grande parte dessas operações pode ser automatizada. + +Isso altera o papel da interface. + +Antes, o usuário precisava compreender e executar cada etapa operacional. + +Agora, muitas vezes, ele precisa principalmente: + +1. Expressar um objetivo. +2. Acompanhar o trabalho da IA quando necessário. +3. Inspecionar os resultados. +4. Validar ou corrigir alterações. +5. Continuar criando o jogo. + +Portanto, a interface não deveria continuar organizada predominantemente ao redor de formulários e operações manuais. + +### Princípios importantes + +**AI-first não significa chat-first.** + +Não quero transformar o Studio em uma aplicação de chat com ferramentas secundárias. + +O Studio deve continuar sendo uma aplicação desktop visual, rica e interativa. + +A IA deve operar sobre as capacidades reais do projeto, preferencialmente pelos mesmos serviços de aplicação utilizados pela interface gráfica. + +O MCP não deveria manter uma implementação paralela da lógica de negócio. + +As operações precisam continuar verificáveis, observáveis e, quando aplicável, reversíveis. + +A interface deve permitir intervenção humana sem exigir que todo o fluxo seja executado manualmente. + +Também não quero remover operações manuais indiscriminadamente. Elas podem continuar úteis para ajustes precisos, recuperação de falhas e desenvolvimento sem agentes. + +A questão é definir **quais operações merecem presença permanente na interface e quais devem ficar disponíveis apenas quando necessárias**. + +## 4. Referência principal de UX: Godot + +Quero utilizar o editor da Godot como principal referência de organização e experiência de usuário. + +Não pretendo copiar sua arquitetura interna nem reproduzir literalmente seu modelo baseado em nós. + +O que me interessa é a organização do ambiente: + +- Interface centralizada em torno do projeto. +- Área principal de trabalho com diferentes editores. +- Painéis laterais contextuais. +- Project/File Browser acessível. +- Inspector associado à seleção atual. +- Painéis inferiores para output, diagnostics e debug. +- Navegação consistente entre diferentes atividades. +- Possibilidade de recolher e redimensionar painéis. +- Aproveitamento eficiente do espaço disponível. +- Uma experiência integrada em vez de múltiplas telas desconectadas. + +Um modelo inicial para discussão seria: + +**Esquerda:** navegação do projeto, arquivos, recursos ou hierarquia da scene. + +**Centro:** área principal de trabalho, que pode apresentar assets, código, scenes, previews ou resultados de outras ferramentas. + +**Direita:** inspector contextual, propriedades e informações do item selecionado. + +**Parte inferior:** output, diagnostics, debug e activity, normalmente recolhíveis. + +**Topo:** navegação principal, execução, ações globais e estado resumido do agente. + +Essa estrutura é apenas uma hipótese inicial. + +Analise sua adequação ao Studio atual antes de aceitá-la. + +Não considero obrigatório implementar docking livre logo de início. Painéis redimensionáveis, recolhíveis e com layouts persistidos podem ser suficientes. + +## 5. Referência principal de UI: Pixel Vision 8 + +Embora a Godot seja nossa referência de UX, não quero simplesmente copiar sua aparência. + +A identidade estética que procuro é inspirada no **Pixel Vision 8** e em interfaces de jogos e ferramentas retrô. + +Internamente, chamo essa direção estética de "bananodore". + +Para evitar ambiguidades, isso significa: + +- Visual lúdico, artesanal e com personalidade. +- Ícones em pixel art. +- Paleta de cores intencional e relativamente limitada. +- Painéis e molduras com estética retrô. +- Botões, abas e controles com identidade visual própria. +- Tipografia inspirada em interfaces clássicas, quando apropriado. +- Menos aparência de ferramenta enterprise. +- Mais sensação de ferramenta de criação de jogos. + +Quero que o Studio seja visualmente interessante e agradável de utilizar. + +Entretanto, não quero sacrificar: + +- Legibilidade do código. +- Ergonomia. +- Densidade útil de informação. +- Redimensionamento. +- Performance. +- Acessibilidade. +- Comportamento esperado de aplicações desktop. + +A ideia é combinar: + +**Godot como referência de UX + Pixel Vision 8 como referência estética + Prometeu como identidade própria.** + +Evite interpretar essa direção como a necessidade de criar um sistema operacional fictício dentro do Studio. + +## 6. JavaFX e estratégia técnica + +A decisão atual é manter JavaFX como tecnologia de frontend. + +Não quero uma proposta de migração de framework sem uma justificativa técnica excepcional. + +Precisamos investigar como construir um design system consistente e reutilizável sobre JavaFX. + +Avalie: + +- CSS e temas. +- Design tokens. +- Controles customizados. +- Componentes reutilizáveis. +- Ícones e assets pixel art. +- Tipografia. +- Escalabilidade em diferentes resoluções e densidades de pixels. +- Separação entre apresentação e lógica de negócio. +- Persistência de estado e layout. +- Performance de componentes personalizados. +- Possibilidade de desenhar elementos específicos com Canvas quando apropriado. + +Não assuma que precisamos substituir todos os controles JavaFX por implementações desenhadas manualmente. + +Identifique o equilíbrio entre skinning, customização e manutenção. + +Investigue também o CSS existente, os padrões visuais atuais e a estrutura do módulo `prometeu-studio-ui-javafx`. + +## 7. Os futuros editores de código e scenes + +Existem dois projetos importantes que precisamos considerar na nova arquitetura de UX. + +### Integrated Code Editor + +O Studio atualmente oferece suporte à linguagem PBS, mas queremos evoluir a experiência de edição integrada. + +Isso poderá envolver: + +- Editor com syntax highlighting. +- Integração com LSP. +- Diagnostics. +- Navegação por símbolos. +- Referências. +- Integração com assets e scenes. +- Build/run. +- Eventual expansão para outros tipos de arquivo. + +Investigue as decisões históricas relacionadas ao editor integrado, incluindo a eventual remoção de implementações anteriores. + +### Integrated Scene Editor + +Queremos integrar edição de scenes diretamente ao Studio, reduzindo a dependência de workflows baseados em ferramentas externas. + +Esse projeto deverá considerar: + +- Viewport. +- Layers. +- Tiles e brushes. +- Entidades e objetos. +- Seleção. +- Inspector. +- Propriedades. +- Integração com scripts e assets. +- Undo/redo. +- Operações de autoria expostas de forma consistente para GUI e agentes. + +**Importante:** esses dois editores são projetos grandes e independentes. + +Não quero implementá-los como parte imediata do redesign visual. + +Entretanto, a nova arquitetura do frontend precisa estar preparada para recebê-los, evitando outro refactor estrutural no futuro. + +## 8. Ferramentas externas + +Não queremos transformar o Studio em uma suíte universal de criação de conteúdo. + +Por enquanto, edição de pixel art e produção de áudio devem permanecer em ferramentas especializadas externas. + +O Studio deve conseguir organizar, importar, referenciar, inspecionar e integrar esses assets ao projeto. + +Isso não significa que todos os formatos precisem de editores próprios. + +## 9. Auditoria dos workspaces existentes + +Investigue todos os workspaces reais da aplicação, incluindo Assets, DEV, Debug e Shipper, além dos componentes globais do shell. + +Para cada workspace, identifique: + +1. Qual problema ele resolve? +2. Quais tarefas o usuário realmente executa? +3. Quais operações já podem ser realizadas via MCP? +4. Quais informações precisam estar permanentemente visíveis? +5. Quais controles deveriam ser contextuais? +6. Quais elementos parecem redundantes? +7. O workspace merece continuar existindo como área independente? +8. Ele poderia ser reorganizado como painel, ferramenta ou fluxo contextual? +9. Quais serviços e contratos precisam ser preservados? + +Quero especial atenção ao Asset Workspace, pois ele provavelmente conserva bastante complexidade herdada do processo manual de gerenciamento de recursos. + +Mas não limite a auditoria a Assets. + +Não proponha remover recursos sem entender sua função e dependências. + +## 10. Arquitetura da interface + +Gostaria que investigássemos uma organização conceitual com: + +- Application Shell. +- Project Navigation. +- Editor/Document Host. +- Contextual Inspector. +- Bottom Tool Panels. +- AI Activity/Agent Control. +- Design System. + +Essas são responsabilidades conceituais, não necessariamente módulos Gradle ou novas classes. + +Não crie uma nova arquitetura apenas por elegância. + +Verifique quanto da implementação atual pode ser preservado, adaptado ou simplificado. + +Em particular, investigue: + +- `MainView`. +- Workspaces e seus ciclos de vida. +- Controles reutilizáveis. +- Estado global e contextual. +- Navegação. +- Seleção de recursos. +- Acoplamento entre serviços e views. +- Contratos existentes entre frontend e backend. +- Integração com MCP. +- Persistência de layouts. + +Considere também como a GUI poderá reagir a alterações realizadas pela IA sem depender de refreshes manuais desnecessários. + +## 11. O que espero desta primeira análise + +Não quero uma lista genérica de boas práticas de UX. + +Quero uma avaliação fundamentada no código real do projeto. + +Prepare uma proposta de discussão contendo: + +### A. Diagnóstico do frontend + +Identifique os principais problemas estruturais e possíveis causas de complexidade. + +Diferencie problemas confirmados pelo código de hipóteses que exigiriam inspeção visual ou testes de uso. + +### B. Inventário funcional + +Mapeie os workspaces, os componentes principais e suas responsabilidades. + +Classifique os elementos relevantes como: + +- Manter. +- Simplificar. +- Mover. +- Consolidar. +- Tornar contextual. +- Candidato à remoção. + +Justifique cada classificação. + +### C. Nova proposta de information architecture + +Descreva como poderia funcionar a navegação principal do Studio, tomando a Godot como referência de UX. + +Explique como os workspaces atuais poderiam se encaixar nessa organização. + +### D. Direção de design system + +Defina os princípios técnicos e visuais necessários para construir uma identidade inspirada no Pixel Vision 8 em JavaFX. + +Evite implementar componentes neste momento. + +### E. Estratégia de migração + +Proponha etapas pequenas, verificáveis e reversíveis. + +Priorize inicialmente mudanças que reduzam a complexidade sem exigir a implementação dos novos editores. + +### F. Riscos e decisões em aberto + +Identifique consequências arquiteturais, compatibilidade, funcionalidades potencialmente afetadas e decisões que devemos tomar antes da implementação. + +## 12. Restrições desta atividade + +- Não modifique código. +- Não implemente o redesign. +- Não crie novos workspaces. +- Não inicie o editor de código ou de scene. +- Não substitua JavaFX. +- Não remova funcionalidades. +- Não assuma que a arquitetura atual precisa ser totalmente descartada. +- Não aceite automaticamente as hipóteses deste documento. + +**Quero uma discussão crítica e tecnicamente fundamentada, não uma concordância automática com as minhas ideias.** + +Se alguma proposta for inadequada à arquitetura atual, explique por quê e apresente alternativas. + +Se houver boas decisões existentes que merecem ser preservadas, destaque-as. + +## 13. Primeiro passo + +Comece examinando o repositório, a documentação, as decisões arquiteturais e a implementação atual de JavaFX. + +Depois apresente: + +1. Seu entendimento da arquitetura atual do Studio. +2. Os cinco problemas de UX/UI de maior impacto que conseguir identificar. +3. Uma avaliação da viabilidade de adotarmos a organização de UX da Godot. +4. Os principais pontos em que o design atual está preso ao workflow manual anterior ao MCP. +5. As perguntas e decisões arquiteturais que precisamos discutir antes de elaborar um plano de implementação. + +**Não avance automaticamente para a implementação. Quero revisar essas conclusões e discutir as alternativas antes de decidirmos a direção final.** diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0002.md new file mode 100644 index 0000000..5270f6a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0002.md @@ -0,0 +1,163 @@ +--- +schemaVersion: 1 +id: "DSC-0002" +workId: "WRK-0013" +discussionId: "TOP-0001" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T09:59:13.674958Z" +respondsTo: null +documentVersion: 2 +--- + +# Primeira análise — UX/UI do Studio e experiência AI-first + +Síntese parcial para discussão. Owner: `studio`. Work: WRK-0013, EXPLORATORY. Não é uma DEC, não encerra exploração e não autoriza implementação. + +## Base e limites da análise + +Inspeção estática da revisão Studio `fa37d0d0c7d9f8ea33ea630571ed6117581a1958`, inicialmente sem alterações locais. O prompt humano completo está em DSC-0001. ART-0001 contém inventário de fontes, hashes, âncoras de código, métricas e catálogo MCP observado. + +Foram examinados shell, montagem e lifecycle dos cinco workspaces efetivamente registrados, composição de Assets e seus detalhes, contratos de autoria, handlers MCP, autoridade/handoff, persistência, CSS, componentes e documentação normativa/histórica pertinente. Não executei a aplicação, builds ou testes nesta etapa. Não há evidência nova de usabilidade, frequência de uso, performance ou aparência renderizada. Os problemas abaixo têm evidência estrutural; sua prioridade é uma avaliação inicial, não uma medição com usuários. + +As fontes são referenciadas por caminhos relativos à raiz Prometeu. Os documentos históricos citados por DEC foram consultados por suas lessons e pela consolidação nas specs atuais; não se afirma que os arquivos operacionais originais removidos ainda existam. + +## A. Arquitetura atual e diagnóstico — TOP-0001 + +### O que já funciona como base arquitetural + +O Studio já tem a separação necessária para um frontend AI-first: `prometeu-studio-ui-javafx` consome `prometeu-studio-api`; `prometeu-studio-core` implementa sessões, políticas e casos de uso; `prometeu-app` compõe serviços e adapters concretos, incluindo MCP, processo do runtime, compiler e LSP. A dependência Gradle da UI é da API, além de JavaFX e RichTextFX. A spec 9 e a lesson LSN-0075 consolidam essa direção. O redesign não exige refazer esse corte. + +`MainView` é a composição visual do projeto aberto. Recebe serviços explicitamente, cria o controlador de Play/Stop, monta os workspaces, registra o handoff de documentos de Assets na automação e projeta os bloqueios de autoridade. `WorkspaceHost` mantém as raízes dos workspaces em um StackPane e alterna `visible`/`managed`. O suporte de lifecycle assina controles na ativação e chama `unLoad` e unsubscribe ao sair. Isso é um host de áreas de atividade; ainda não é um host de documentos editáveis com abas, histórico de navegação e seleção compartilhada. + +Os workspaces reais são Assets, Debug, DEV, Shipper e Tests. Tests é condicional à presença de `GuestTestTools`; não deve ser omitido porque a lista histórica de shell tem apenas quatro entradas. Launcher, shield de carregamento, menu, rail, Run e Activity completam o shell. `MainView` monta Run no cabeçalho do painel direito, junto de Activity; a descrição de Run no topo é uma intenção da spec, não a árvore visual exata da implementação. + +Sessões de execução/automação pertencem ao projeto e sobrevivem à troca de workspace. `OperationHandle` oferece identidade, progresso, conclusão, cancelamento e término. `DocumentHandoff` oferece dirty/save/refresh. APIs e resultados já permitem observar a mesma operação pela GUI e pelo agente; a UI não deve reconstruir seus significados a partir dos logs. + +O sistema de eventos tipados global/por-workspace, as projeções locais, formulários com drafts, seleção por identidade estável, revisão de batches, diagnósticos estruturados, isolamento de autoridade e persistência em `.studio/` são decisões úteis a preservar. Nenhuma delas exige preservar a posição atual dos controles. + +### Os cinco problemas de maior impacto + +| Prioridade | Evidência confirmada no código | Impacto provável e limite | Direção a discutir | +| --- | --- | --- | --- | +| 1. Assets mistura descoberta, propriedades e ferramentas de autoria | `AssetWorkspace` monta budget/autoria, barra Refresh/Add/Pack, lista e detalhes. `AssetDetailsControl.buildDetailsSections()` empilha Summary/Actions, contrato, composição ou layers, schema, paleta e animação. `AssetAuthoringPane` possui um ComboBox de bank independente da seleção do navegador. | A operação sobre um bank pode exigir outra seleção além daquela usada pelo inspector; preview/autoria disputam a área com administração. Quantidade de scroll e confusão efetiva precisam de inspeção visual. | Um contexto explícito de seleção, preview/autoria no centro e propriedades/ações pertinentes no inspector; resumo de capacidade global separado do detalhe por bank. | +| 2. Navegação interfere no trabalho e divide atividades relacionadas | `WorkspaceHost.change()` desativa a área anterior. `ShipperWorkspace.unLoad()` chama `buildOperation.cancel()`. Debug apresenta estado/logs; Shipper contém toolbar, label de projeto, diagnostics/logs. Run seleciona Debug antes de Play. | Sair de Shipper solicita cancelar o build; navegar pode virar uma decisão operacional involuntária. Persistência de operação difere entre áreas. A extensão das consequências após cancelamento depende do serviço e não foi executada aqui. | Separar observar/ocultar de cancelar/encerrar, com operações de duração de projeto; tratar build/output e Debug como ferramentas contextuais, preservando seus serviços. | +| 3. A autoridade é global ao projeto, mas sua explicação está concentrada em DEV | Grant/reclaim, estado Manual/Waiting/Working/Returning e readiness são apresentados em `DevWorkspace`. `MainView` bloqueia Assets/Shipper/Run em função da mesma `AutomationSession`, inclusive fora de DEV. | O usuário pode encontrar ações indisponíveis sem uma explicação próxima. Confundir operação concluída, agente conectado e controle devolvido é um risco de UX; a semântica do Core já os distingue. | Estado resumido e retomada de controle acessíveis no shell, com DEV como inspeção detalhada, mantendo os quatro estados e a ordem de cleanup/handoff. | +| 4. Atualização pós-agente tem uma base segura, mas cobertura visual incompleta | `DefaultAutomationSession` chama `DocumentHandoff.refreshFromDisk()` antes de desbloquear. O handoff de `AssetDetailsControl` atualiza detalhes selecionados/animação. `AssetListControl` observa eventos UI de refresh/projeção. O contrato `AssetAuthoringService` não expõe assinatura de alterações e `AssetAuthoringPane` tem refresh próprio. | Não foi localizado um fluxo geral commit MCP → invalidação de catálogo/budget/navegação visível. Não se deve concluir que nada atualiza: há refresh na ativação de Assets e no retorno para documentos. O risco é apresentar projeções de revisões diferentes. | Fatos de mudança/revisão no limite neutro dos serviços; adapter projeta invalidações pontuais e sync estrutural quando necessário. Arquivos alterados externamente exigem estratégia distinta de commits conhecidos do serviço. | +| 5. A apresentação tem classes reutilizáveis, porém linguagem visual e localização incompletas | CSS padrão com 1.590 linhas e 214 literais hexadecimais distintos, fonte raiz Inter/Segoe e botões arredondados. Rail usa emoji/símbolos. Tests e autoria têm muitos textos literais. `ThemeService` carrega JetBrains Mono e retorna um tema padrão. | Falta uma paleta semântica explícita e a identidade varia por componentes. Contagem de cores não prova por si só um problema estético; aparência enterprise e qualidade visual precisam de renderização. Hardcoded English limita i18n real. | Tokens e papéis visuais, conjunto de ícones próprio, estados consistentes e i18n também nos componentes recentes; preservar controles e comportamento desktop. | + +Uma descoberta adicional de alta confiança: `StudioShellMenuBarControl` oferece New Project/Open/Save com handlers vazios; Edit/View/Help são menus sem itens. Isso é affordance sem comportamento neste controle, não evidência de que o launcher não abre/cria projetos. Retirar ou desabilitar honestamente esses itens até haver uma ação real é um candidato mais seguro que inventar funcionalidades para preencher o menu. + +### Quanto da complexidade é anterior ao MCP? + +A hipótese humana é parcialmente sustentada. A composição de Assets ainda apresenta operações como criar, registrar, configurar contrato, compor, incluir no build e empacotar como passos visíveis de administração. `AssetDetailsSummaryControl` dá destaque a ID, localização, tipo, registro e participação; a spec 4 historicamente descreve uma interface didática do modelo do packer. Essa intenção explica parte da exposição técnica. + +Entretanto, o frontend já mudou com AI-first: `SharedAssetCommands`/`SharedSceneWorkflow`, batches revisionados, orçamento, ownership, evidências visuais, testes e animações são incorporações recentes. O ComboBox adicional e a área de budget/autoria não são simplesmente resíduos pré-MCP. A complexidade parece resultar também da sobreposição de capacidades novas à composição anterior, sem reorganizar sua hierarquia. Isso muda a proposta: revisar a distribuição de informação, preservando a semântica de revisão/conflicto que tornou a automação verificável. + +## B. Inventário funcional e classificação preliminar — TOP-0001 / TOP-0003 + +Classificações são propostas, não autorização de mudança. Frequência e utilidade não foram medidas. + +| Área ou elemento | Problema/tarefas atuais | Cobertura MCP observada | Classificação e justificativa | +| --- | --- | --- | --- | +| Launcher e sessão de projeto | Abrir/criar projeto, preparar integração, montar/fechar sessão e restaurar estado | Contexto só do projeto aberto; catálogo não oferece substituto geral para launcher | **Manter / simplificar.** Identidade de projeto continua sendo a raiz do ambiente. Preservar ProjectCatalog/ProjectSession e tratamento de falha de preparação. | +| Rail e host | Alternar áreas inteiras, restaurar workspace | Navegação é UI-local | **Simplificar / consolidar.** Não presumir que toda área de serviço merece destino principal. Preservar lifecycle e estado até testar outra organização. | +| Menu do shell | Affordances globais | Não aplicável | **Candidato à remoção:** itens sem efeito e menus vazios, após confirmar ausência de bindings externos. A capacidade de abrir/criar projetos permanece no launcher. | +| Run/Stop | Preparar e executar para uso humano | Build e headless têm tools próprios, mas não são o mesmo Play/DevTools humano | **Manter / mover.** Ação global compacta no topo, com estado e razão de bloqueio. Preservar ExecutionController/ExecutionSession e exclusão de autoridade. | +| Activity | Timeline operacional do projeto | Estado, operações e evidências podem ser consultados; sem equivalência de toda a timeline visual | **Mover / simplificar.** Resumo global sempre acessível; histórico recolhível em tool panel. Não substituir diagnostics por log. | +| Assets: navegador | Descobrir assets registrados/não registrados, buscar/filtrar, selecionar | `studio_assets_catalog`, inspect/artifacts | **Manter / simplificar.** Navegar por assets canônicos continua útil; não substituí-los por arquivos soltos. Preservar AssetCatalog, referências e identidade durante refresh/move. | +| Assets: seletor de bank na autoria | Escolher alvo para import/ownership sem depender do navegador | Autoria recebe referência estável do bank | **Consolidar.** Preferir seleção contextual única ou explicitar um alvo independente quando o fluxo realmente exigir. A redundância funcional precisa ser validada com cenários de múltiplos alvos. | +| Summary e Runtime Contract | Inspecionar IDs, origem, registro, codec/formato, preload | `studio_assets_inspect`, budget e preview de update_contract/build_participation | **Simplificar / tornar contextual.** Nome, tipo e problemas visíveis; ID, hash, codec e paths em detalhe técnico, sem esconder limites, origem ou falhas relevantes. Preservar contrato/API e controles de precisão. | +| Composição, paletas, animações e layers | Configurar conteúdo e inspecionar preview | Batches de composição de glyph/paleta/scene; `studio_animation_query/update` | **Manter / mover.** Ferramentas visuais centrais e propriedades no inspector. Animação já é uma capacidade real; não eliminá-la por confundir com os futuros editores. Preservar revisões, referências e handoff. | +| Add/Register/Import/Pack e ações técnicas | Fluxo manual e recuperação | Preview/commit de create_bank, register_bank, import_png, composição, contrato e inclusão; build via `studio_build_start` | **Tornar contextual / simplificar.** Agrupar por objetivo e alvo; manter caminho manual acessível. Pack de workspace e build completo não são equivalentes; não deduplicar antes de mapear os efeitos. | +| Ownership/dependencies e budget | Declarar dependências de outputs, inspecionar custos e conflitos | dependencies, budget e ownership em preview/commit | **Manter / simplificar.** Resumo global legível e drill-down; declaração de produtor não executa geração. Não ocultar cartridge blockers nem recomputar contagens na GUI. | +| Refresh Assets / Refresh budget | Reconciliar catálogo e orçamento | Queries e revisão disponíveis | **Consolidar / tornar contextual.** Manter recuperação explícita; remover necessidade rotineira apenas quando cobertura de invalidação estiver provada. | +| Remover/relocar assets | Mutação sensível e alteração de identidade/endereço | Não encontrei operação equivalente explícita no schema de batches atual | **Manter / tornar contextual.** Não declarar paridade MCP universal. Preservar preview, destino escolhido, blockers e confirmação sensível até revisão específica. | +| Debug | Observar execução humana e logs | Headless é alternativa com lifecycle/protocolo diferente | **Mover / simplificar.** Estado/logs em tool panel com acesso contextual ao runtime humano. Preservar ExecutionSession, diagnóstico e separação de headless; o código atual não demonstra debugger com breakpoints/step. | +| DEV | Conceder/retomar controle, readiness, observar operações/capturas/diagnostics/evidências | acquire/release, operações, build, language, headless e evidências | **Manter responsabilidades / mover resumo / simplificar detalhe.** Grant/reclaim humanos não podem desaparecer. Separação de Debug é contrato atual; retirar DEV como workspace exige revisão explícita. Preparação e recuperação de conexão podem ser contextuais. | +| Tests | Selecionar target/mídia/limites, executar/cancelar, ver casos/transcript/evidências e fechar runtime retido | `studio_tests_targets/start/get/cancel/transcript/shutdown` | **Manter / simplificar / tornar contextual.** Resultados e seleção de target próximos do projeto; frames por bloco, mídia/reopen e proveniência em detalhes de execução. Não unificar execução de testes com produção. Decidir depois entre ferramenta inferior e editor de resultados. | +| Shipper | `Shipper.prepare`, resultados estruturados e logs; área de projeto ainda é label | `studio_build_start` prepara build/pack pelo serviço compartilhado; não há prova de suíte final de release | **Consolidar / mover.** Preparação atual cabe como comando e resultado de build. Não excluir capacidade futura de distribuir/publicar sob argumento de que já existe. Revisar cancelamento no unload. | +| Painéis de diagnostics/logs/evidence | Explicar falhas e reter resultado/proveniência | Mesmo resultado diagnóstico e contratos de evidência/testes | **Consolidar apresentação / manter ownership.** Tabs podem compartilhar região inferior, mantendo identidade de projeto/operação, filtro por produtor, origem, parcialidade e captura atual versus histórica. | +| RichTextFX | Dependência declarada sem imports/usos encontrados na produção JavaFX | Não aplicável | **Candidato à remoção da dependência residual**, só após verificação de consumidores, testes e empacotamento. Sua existência não prova que o editor antigo permanece funcional. Nenhuma alteração agora. | + +Informação permanente deve priorizar projeto, alvo/seleção, editor ativo, dirty/conflito quando houver, autoridade, operação corrente, blockers e resumo de capacidade pertinente. IDs técnicos, hashes, sequência de chamadas e opções de recuperação ficam acessíveis por contexto. Isso não significa esconder a evidência necessária para diagnosticar falhas. + +## C. Information architecture e viabilidade Godot — TOP-0002 / TOP-0005 + +A documentação da Godot apresenta telas principais, docks contextuais e painel inferior, além de redimensionamento e layouts salvos. São referências adequadas de organização, sem impor seu modelo de nós ao Prometeu. [Interface da Godot](https://docs.godotengine.org/en/stable/getting_started/introduction/first_look_at_the_editor.html), [customização](https://docs.godotengine.org/en/stable/tutorials/editor/customizing_editor.html). + +A viabilidade é **alta para layout e interação em JavaFX**, **condicionada para semântica compartilhada de seleção/documentos** e **não é uma troca de CSS**. BorderPane, SplitPane, TabPane e o `WorkspaceDockPane` já cobrem parte dos mecanismos. Não há necessidade demonstrada de docking livre ou outro framework. + +Hipótese preferida para discussão: ambiente centrado no projeto com o centro dedicado àquilo que se está criando/inspecionando. À esquerda, navegação por assets com visão complementar de arquivos; hierarquia da scene só quando existir um editor correspondente. Ao centro, preview e ferramentas visuais existentes, mais resultados que precisem de espaço. À direita, propriedades da seleção atual; embaixo, ferramentas recolhíveis de output, problemas, testes, atividade e observação. No topo, projeto, execução e autoridade/estado resumido do agente, com acesso à retomada humana. + +Não colocar o atual formulário inteiro em um inspector estreito. Composição de banks, previews, animações e evidências precisam de área central; o inspector recebe propriedades e ações daquele contexto. Tampouco converter o navegador de assets em um file browser puro: o asset canônico e seu registro não se reduzem à pasta e seus inputs. + +Dois caminhos devem permanecer em discussão: + +1. **Evoluir o shell atual primeiro:** manter destinos dos workspaces, recolher Activity, melhorar contexto e distribuir detalhe/preview em Assets. Menor custo e migração mais simples; pode conservar a sensação de telas desconectadas. +2. **Convergir para um host central de editores/visualizadores e painéis de ferramenta:** Assets deixa de monopolizar um workspace administrativo; build/debug/tests tornam-se ferramentas de projeto, e DEV mantém inspeção distinta com controle global. Melhor integração esperada; exige definir seleção, foco, dirty/close, navegação e lifetime antes de mover áreas. + +Minha inclinação é validar o segundo como direção, migrando por passos compatíveis com o primeiro. Ainda não há evidência suficiente para escolher abas universais, um inspector global ou a eliminação do rail. + +Conflitos explícitos com a baseline: spec 1 fixa rail e utility panel direito e proíbe console global obrigatório; spec 4 fixa a composição de detalhes de Assets e a localização de Activity; spec 10 exige DEV separado de Debug. Compartilhar uma região de apresentação não obriga mesclar protocolos ou ownership, mas mudar essas prescrições requer DEC posterior e propagação consciente. O status Draft no cabeçalho de algumas specs não autoriza ignorar decisões aceitas consolidadas nelas. + +### Preparação para os futuros editores + +A lesson LSN-0049 registra a remoção do antigo workspace Editor, VFS e acoplamentos de sessão na DEC-0031. `ProjectLocalStudioState` trata `EDITOR` antigo como `ASSETS`. A LSN-0047 registra o novo LSP por projeto, separado de protocolo e semântica do compiler. O futuro editor deve consumir essas fronteiras atuais e respeitar semântica por frontend; não ressuscitar o VFS antigo por conveniência ou tornar PBS o modelo universal. + +Preparação agora significa explicitar responsabilidades para alvo aberto, seleção, foco/atalhos, apresentação de diagnostics, dirty/save/close e participação no handoff. Não significa construir um framework universal de documentos sem consumidor, nem implementar syntax highlighting/LSP na UI nesta atividade. + +Scene Bank já tem entidade canônica de autoria e interoperabilidade Tiled. Um futuro scene editor deve editar essa verdade com operações compartilhadas, sem fazer TMX virar modelo canônico nem acoplar packer ao viewport. Viewport, seleção de tiles/entidades, brushes e undo/redo precisam de projeto e contratos próprios. Batches com preview/commit não equivalem a uma pilha de undo. Os editores de pixel art e áudio continuam externos; organizar/inspecionar/integrar não exige criar um editor por formato. Sound authoring/packing/qualification está explicitamente adiado na wave de autoria compartilhada, portanto não assumir paridade com glyph e scene. + +## D. Direção de design system JavaFX — TOP-0004 + +A identidade bananodore pode ser construída incrementalmente no adapter atual. O site do Pixel Vision 8 combina linguagem retrô com conveniências modernas; usamos isso como referência estética, sem importar seu sistema operacional ou sua suíte completa. [Referência oficial Pixel Vision 8](https://pixelvision8.github.io/Website/). + +Proposta técnica: manter comportamento dos controles JavaFX; aplicar CSS e composição primeiro, skins específicas quando o CSS for insuficiente e desenho próprio somente para superfícies que o justifiquem. JavaFX 23, usado no projeto em 23.0.2, oferece CSS com lookup de cores e suporte de skins em Control. Tokens não devem pressupor equivalência com CSS custom properties/`var()` de navegador; medidas e tipografia podem precisar de valores gerados/centralizados ou propriedades próprias. [CSS JavaFX 23](https://openjfx.io/javadoc/23/javafx.graphics/javafx/scene/doc-files/cssref.html), [Control e skins](https://openjfx.io/javadoc/23/javafx.controls/javafx/scene/control/Control.html). + +Proposta visual, sujeita a estudo renderizado: + +- Paleta pequena de papéis: fundo, superfícies, borda, texto, foco, seleção, ação, warning, erro e sucesso. Acento de identidade não substitui significado operacional. Não escolher agora os hex finais. +- Molduras, abas e botões com geometria e detalhes retrô coerentes; hierarquia por espaço, contraste e tipografia, sem ornamentar cada container. +- Conjunto próprio de ícones pixel art com grades base e variantes de escala. Evitar depender da aparência de emoji do sistema. Texto/tooltip e nome acessível continuam necessários. +- Fonte de interface legível; fonte retrô em locais selecionados após verificar caracteres e locale. Código, números, paths e diagnostics usam família adequada a leitura prolongada, aproveitando JetBrains Mono já empacotada. +- Escala de layout independente da grade do conteúdo de jogo. Pixels nítidos no preview não justificam rasterizar toda a UI. Validar escala fracionária, monitores diferentes e bounds mínimos; não prometer pixel perfection em qualquer escala. +- Preservar foco visível, navegação por teclado, seleção, menu contextual, clipboard e motivos legíveis para ações indisponíveis. Cor sozinha não comunica estado. +- Reutilizar componentes atuais de shell/forms/feedback/inspection com consumidor concreto; sem módulo Gradle de design system ou wrapper geral de JavaFX só por organização. +- Canvas pode servir a overlays, grids e previews densos quando medição justificar. Formulários, textos editáveis, menus e listas não ganham com redesenho manual geral. Para grandes catálogos, investigar virtualização: o navegador atual reconstrói grupos e cria nodes de cada item no VBox, sem prova de problema de performance nesta sessão. +- Eventos/projeções e I18nService permanecem parte do padrão. Os textos literais recentes entram no inventário de migração; CSS, locale e estilos de estado devem ser verificáveis juntos. + +## E. Estratégia de migração para discutir — TOP-0006 + +Esta sequência é uma proposta narrativa de opções. Não é Plan AIE, ordem aprovada ou autorização de execução. + +| Etapa candidata | Entrega pequena | Como verificar | Reversibilidade e dependência | +| --- | --- | --- | --- | +| 0. Observar tarefas reais | Baseline visual em projeto pequeno e catálogo grande: import/inspeção, edição manual, grant/MCP/reclaim, build, testes e reabertura | Capturas, percursos e medidas de espaço/ações/scroll; comparar usuário com e sem agente. Definir o que precisa melhorar antes de escolher layout final | Somente evidência; não depende de editores futuros | +| 1. Corrigir hierarquia e affordances | Reduzir proeminência de itens técnicos e controles sem efeito; unificar alvo contextual onde couber; detalhar autoridade sem redesenhar todo o shell | Mesmas tarefas e serviços alcançáveis; teclado/i18n; nenhuma perda de preview/commit, blockers ou edição manual | Pequenos diffs por componente; comandos e serviços preservados; requer decisão sobre mudanças normativas | +| 2. Provar atualização e lifetime | Cobertura de catálogo/budget/documentos após commits e retorno; build observado fora de Shipper sem cancelamento implícito se essa política for aceita | Criar/remover/mover/alterar asset e retornar de MCP; selecionar durante refresh; conflito dirty; navegar no build, cancelar e fechar projeto; não liberar autoridade antes de cleanup | Contratos neutros mínimos; separar infraestrutura de observação do reposicionamento visual; reversão explícita por alteração | +| 3. Reorganizar regiões com conteúdo existente | Mover Run/estado do agente, recolher Activity e apresentar preview/inspector mais coerentes | Mesmos cenários, janela menor e larga, foco/atalhos, falhas e reabertura; medir ganho de centro útil | Sem implementar editor; preservar dados de projeto e fallback do estado de layout | +| 4. Aplicar design system por família | Tokens, tipografia, ícones e skins em componentes já usados | Capturas comparáveis, foco, contraste, disabled/selected/error, locale longo, DPI e custo de layout/render | Manter tema anterior durante comparação se viável; diffs de estilo separados de alterações semânticas | +| 5. Consolidar host e estado aceitos | Persistir visibilidade/proporções e contexto realmente necessários, usando `.studio/state.json` versionado | Reabrir, estado ausente/inválido/antigo, resize e troca de tela; não restaurar autoridade/tarefas/processos | Defaults seguros e migração explícita se schema mudar; não recuperar Editor legado | + +As etapas não exigem implementação dos editores de código ou scene. Se o estudo provar que uma versão menor do shell resolve a maior parte do problema, não há razão para construir antes uma infraestrutura completa de IDE. + +Checks futuros devem aproveitar testes existentes de autoridade, estado local, projeções e integração de autoria/diagnostics, além do smoke desktop. A mera existência desses testes não comprova que passaram agora. Desacoplar navegação de cancelamento ou mudar handoff exige testes comportamentais específicos; edição de CSS isolada pede sobretudo QA visual. + +## F. Riscos, alternativas e decisões em aberto — TOP-0003 / TOP-0005 / TOP-0006 + +1. **Unidade de navegação:** projeto/objeto/documento ou workspace? Que casos exigem vários itens abertos simultaneamente? O centro pode começar como host do conteúdo atual sem abas de edição completas? +2. **Seleção:** escolher um asset deve apenas inspecionar ou também abrir uma ferramenta? O inspector acompanha seleção transitória ou documento ativo? Qual alvo recebe um comando durante uma seleção diferente no navegador? +3. **Ferramentas versus áreas independentes:** Debug, Tests e preparação de Shipper precisam mesmo de destinos primários? Onde resultados longos e revisão de evidências são mais úteis? Não reduzir tudo a um painel baixo apertado. +4. **DEV e autoridade:** aceitamos projetar grant/reclaim e estado no shell enquanto DEV continua separado? Que mudança de UX exigiria revisar a obrigatoriedade de workspace DEV? Manter humano/headless distintos mesmo que compartilhem padrões visuais. +5. **Observabilidade:** qual estado mínimo sempre visível — operação, tarefa, autoridade, conexão, freshness? Conclusão de operação não devolve autoridade; captura histórica não representa live preview. Quais detalhes aparecem apenas em falha? +6. **Atualização e conflito:** quais mudanças geram eventos neutros de serviço e quais exigem detecção de disco ou sync no foco? Como marcar stale e agrupar mudanças de batch sem tempestade de refresh? Como proteger drafts e preservar seleção/revisão? +7. **Revisão humana:** o baseline não oferece Apply/merge global para código externo, nem rollback universal. A IA já edita arquivos reais; batches possuem preview/commit próprio. Discutir inspection/diff sem prometer que toda mudança fica pendente de aprovação humana por operação. +8. **Operações e lifecycle:** navegar nunca deve cancelar implicitamente? Quais operações são realmente de projeto, quais são drafts locais e quais precisam encerrar no close? Cancel requested, worker terminated e cleanup completed continuam fatos distintos. +9. **Modelo de assets:** manter assets canônicos como unidade sem esconder arquivos úteis. Quais operações de baixa frequência merecem menu avançado? Quais alertas e limites precisam continuar explícitos para o criador entender o jogo? +10. **Compatibilidade e persistência:** layout por projeto ou preferência global? O que vale restaurar além do workspace/divisor de Assets atual? Preservar defaults, legado EDITOR→ASSETS, `.studio/setup.json` separado e exclusão de credenciais/grants/processos do estado. +11. **Design system:** quanta tipografia pixelada funciona para idiomas, acessibilidade e leitura prolongada? Qual densidade e tamanho mínimo suportados? Quais escalas/OS entram no aceite? Comparar estados renderizados antes de normatizar paleta. +12. **Futuros editores:** definir mínimo comum de foco, dirty/save/close, diagnostics e handoff sem desenhar suas implementações agora. Scene entity, compiler e serviços LSP mantêm ownership. Undo/redo precisa de decisão própria de autoria, não de uma ilusão de reversibilidade universal. +13. **Escopos relacionados:** WRK-000D já explora terminal embutido em DEV; esta análise não aprova biblioteca, PTY, processo nem localização desse terminal. WRK-000C trata dependências locais. Coordenar navegação e espaço futuro sem absorver esses projetos ou bloquear o redesign por eles. + +Não proponho remover nenhuma capacidade de domínio com base nesta inspeção. Os candidatos mais concretos de remoção são affordances sem efeito e dependência residual; controles operacionais legítimos são candidatos sobretudo a contextualização. O caminho recomendado para a próxima rodada é discutir unidade de navegação/seleção e autoridade global, e depois comparar os dois caminhos de shell com tarefas e evidência visual. A exploração permanece aberta para revisão humana, sem DEC ou Plan. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0003.md new file mode 100644 index 0000000..fff3cf7 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0003.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0003" +workId: "WRK-0013" +discussionId: "TOP-0002" +kind: "QUESTION" +author: "codex" +createdAt: "2026-11-17T09:59:42.166630Z" +respondsTo: null +documentVersion: 2 +--- + +Qual deve ser a unidade principal de navegação: workspaces de atividade, objetos/documentos do projeto, ou uma transição entre os dois? Como seleção do navegador, documento ativo e alvo do inspector se relacionam? DSC-0002, seção C, compara manter o shell evoluído com convergir para host central e ferramentas contextuais; nenhuma opção está aprovada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0004.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0004.md new file mode 100644 index 0000000..2321ef7 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0004.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0004" +workId: "WRK-0013" +discussionId: "TOP-0003" +kind: "QUESTION" +author: "codex" +createdAt: "2026-11-17T09:59:42.614459Z" +respondsTo: null +documentVersion: 2 +--- + +Que resumo de autoridade, conexão, operação e freshness precisa estar sempre visível, e como oferecer retomada humana fora de DEV? Que cobertura de invalidação deve existir após commits MCP e alterações externas sem sobrescrever drafts? Preservar grant/acquire/return separados e revisão sem prometer Apply/rollback universal. Referência: DSC-0002, seções A, B e F. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0005.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0005.md new file mode 100644 index 0000000..d0d28cb --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0005.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0005" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "QUESTION" +author: "codex" +createdAt: "2026-11-17T09:59:43.114499Z" +respondsTo: null +documentVersion: 2 +--- + +Qual equilíbrio de identidade retrô, tipografia, densidade e escala será aceito? Em quais resoluções/OS/DPI/locales devemos comparar componentes renderizados antes de escolher paleta, fontes e skins? A direção em DSC-0002, seção D, preserva controles JavaFX e deixa cores/estética finais em aberto. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0006.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0006.md new file mode 100644 index 0000000..d14a1ff --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0006.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0006" +workId: "WRK-0013" +discussionId: "TOP-0005" +kind: "QUESTION" +author: "codex" +createdAt: "2026-11-17T09:59:43.630280Z" +respondsTo: null +documentVersion: 2 +--- + +Qual contrato mínimo de seleção, foco, dirty/save/close, diagnostics e handoff precisamos preservar para futuros editores, sem implementar agora um framework especulativo? Como garantir que scene authoring continue canônico e o novo editor de código não ressuscite VFS/estado removidos pela DEC-0031? Referência: DSC-0002, seção C. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0007.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0007.md new file mode 100644 index 0000000..5de5a21 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0007.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0007" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "QUESTION" +author: "codex" +createdAt: "2026-11-17T09:59:44.076965Z" +respondsTo: null +documentVersion: 2 +--- + +Quais alterações pequenas podem ser priorizadas após revisão das conclusões, e quais contratos de shell/DEV/Assets precisam ser explicitamente revistos antes disso? A navegação deve parar de cancelar build em Shipper? Como comparar e reverter cada alteração, preservando estado local, lifecycle e independência do terminal discutido em WRK-000D? Referência: DSC-0002, seções E e F. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0008.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0008.md new file mode 100644 index 0000000..1f90a08 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0008.md @@ -0,0 +1,25 @@ +--- +schemaVersion: 1 +id: "DSC-0008" +workId: "WRK-0013" +discussionId: "main" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T10:16:12.560265Z" +respondsTo: null +documentVersion: 2 +--- + +# Evolução da visão do produto — instrução humana + +Mensagem de Nilton nesta conversa, preservada como direção para exploração; não é aprovação de DEC ou implementação: + +> o editor de codigo ira retornar, e consumira o LSP internamente, podendo o LSP ser inicializado para atender um VSCode da vida. gostaria tb de termos um gerenciador de scenes e um editor das mesmas. e pq nao um pequeno editor de pixeis emergencial no futuro. e talvez ateh um editor de som, musicas, uma especie de sequenciador. porem todas essas coisas podem ser adicionadas depois, no entanto, eh interessante saber que elas podem e vao existir em algum momento. a ideia eh que o studio tente entregar uma suite unica de desenvolvimento, podendo aceitar importar assets externos. a minha ideia eh que o studio seja IA first, e que ela tenha um prompt de IA associado usando um APC onde o usuario possa configurar qual IA e modelo esta usando. isso talvez seja interessante, pois assim poderiamos controlar acesso ao studio enquanto a IA trabalha. alem claro de prover um UI/UX mais limpa e clara e com uma cara mais Pixel Vision 8, com capacidade para ter diferentes temas. vamos discutir essas ideias e ver como elas progridem. + +Esclarecimento solicitado: se “APC” significava ACP (Agent Client Protocol), integração direta a APIs de modelos ou opção em aberto. + +Resposta humana explícita: **“ACP — conectar clientes/agentes ao Studio”**. + +Esta mensagem altera a premissa do prompt inicial que mantinha pixel art/áudio exclusivamente externos e amplia a hipótese de interação de IA: o Studio pode ser cliente ACP, com prompt e seleção de agente/modelo. A suíte continua aceitando ferramentas externas. Código e scenes são direções futuras explícitas; pixels e áudio/sequenciador são possibilidades a explorar, sem prioridade, escopo ou datas definidos. + +Mantêm-se EXPLORATORY, aprovação humana obrigatória de DEC, descoberta crítica e ausência de autorização para modificar código/specs, implementar editores ou iniciar integração ACP. O prompt inicial e a primeira análise permanecem como histórico, lidos à luz desta atualização. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0009.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0009.md new file mode 100644 index 0000000..e486cde --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0009.md @@ -0,0 +1,110 @@ +--- +schemaVersion: 1 +id: "DSC-0009" +workId: "WRK-0013" +discussionId: "TOP-0007" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T10:18:02.898434Z" +respondsTo: null +documentVersion: 2 +--- + +# Segunda síntese — suíte integrada e cliente ACP + +Síntese parcial de exploração, após a instrução humana em DSC-0008. Relaciona TOP-0002 a TOP-0007. Não é DEC, não solicita encerramento da exploração e não altera specs ou código. + +## Premissas atualizadas + +O produto desejado é uma suíte integrada de desenvolvimento de jogos, aberta à importação e ao uso de ferramentas externas. O editor de código retornará consumindo o LSP; o produto deve acolher gestão e edição de scenes. Edição emergencial de pixels e ferramentas de som/música/sequenciador entram como possibilidades futuras de produto. Não há prioridade, calendário ou profundidade funcional aprovados para esses editores. + +O usuário confirmou que a integração sugerida é ACP (Agent Client Protocol). A ideia é ter prompt associado ao Studio e configuração do agente/modelo, mantendo UX visual clara e identidade Pixel Vision 8 com diferentes temas. + +Isso revisa duas premissas da análise anterior: pixel art/áudio não precisam permanecer exclusivamente externos para sempre; hospedar a interação com o agente passa a ser uma direção explícita de discussão. As conclusões estáticas da primeira análise continuam válidas como observações da implementação, mas seus limites de produto devem ser lidos com esta atualização. A remoção do editor antigo deixa uma lição de fronteiras e lifecycle; não é um veto a um editor futuro. + +## 1. Uma suíte integrada pede continuidade entre editores + +A consequência arquitetural mais útil dessa visão é passar a tratar editores como formas de trabalhar sobre conteúdo do projeto. Um asset pode abrir em preview, editor visual ou propriedades conforme o tipo e a intenção. Código, scene, pixels e sequenciador devem conseguir compartilhar projeto, navegação, seleção contextual, ação de salvar/fechar, histórico de navegação, indicação de conflito, diagnósticos e integração de IA. + +Não é necessário que todos os editores tenham o mesmo estado interno, comandos ou undo stack. Um sequenciador tem transporte, timeline e seleção temporal; um editor de código tem caret, documentos e LSP; uma scene tem viewport e seleção espacial. A unidade da suíte vem do shell e de contratos úteis em comum. O contexto do inspector e das ferramentas deve acompanhar o editor ativo sem tentar colocar toda operação em um formulário universal. + +Proposta: evoluir as responsabilidades do centro para um host de editores/visualizadores e usar painéis auxiliares contextuais. Isso não exige que cada editor futuro vire um workspace completo com navegação e logs próprios. A presença explícita de vários editores no horizonte torna essa alternativa mais relevante que na primeira análise. Ainda não decide abas, splits simultâneos, plugin system, novos módulos ou classes. + +Preparar agora é documentar os pontos de integração e evitar novas dependências específicas de Assets no shell. Uma interface genérica de plugin/editor construída sem validar consumidores reais poderia virar outra fonte de complexidade. A transição pode começar com preview, composição e animações que já existem. + +## 2. LSP interno e clientes externos + +Inspeção adicional confirmou bases concretas para essa intenção: + +- `studio/prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/TcpLspServerHost.java` aceita sockets em loop e cria uma instância `PrometeuLanguageServer` por conexão, com bridge do compiler compartilhado e suporte de desconexão. +- `LspServerLifecycleImpl.java` mantém hosts por projeto, expondo endpoint e shutdown. +- `studio/prometeu-app/src/main/java/p/studio/app/lsp/LspLifecycleAdapter.java` abre o endpoint em loopback/porta atribuída pelo SO e publica descoberta em `.studio/lsp.json`. +- `studio/tools/vscode-extension/src/extension.ts` e `discovery.ts` já implementam descoberta, cliente LSP externo e reconexão. +- `PrometeuTextDocumentService.java` mantém texto e versões de documentos por instância da conexão. + +Portanto, coexistir com VS Code não parte do zero. Um editor interno como cliente LSP tem uma trajetória coerente com as fronteiras atuais. Consumo interno não exige injetar classes LSP4J/implementações diretamente nos controles JavaFX; o adapter de aplicação pode mediar a integração preservando a neutralidade da API. + +Há três cenários diferentes a discutir: só editor interno; Studio aberto junto de cliente externo; e LSP disponível para cliente externo sem janela de Studio. O código inspecionado comprova host por projeto e múltiplas conexões, não o terceiro cenário nem ausência de conflitos entre clientes. + +Um detalhe decisivo são os buffers não salvos. Studio, VS Code e consulta do agente podem observar textos diferentes. O baseline de build/automação usa arquivos salvos. A presença de um mesmo servidor não sincroniza automaticamente buffers entre editores nem autoriza sobrescrevê-los. Precisamos definir política de dirty, alteração externa, save, fonte de diagnostics e handoff antes de prometer edição simultânea transparente. + +## 3. Gestão de scenes e autoria + +O gerenciador responde quais scenes existem, como são encontradas, abertas, organizadas, referenciadas e inspecionadas. O editor responde como seu conteúdo é alterado. Eles podem compartilhar seleção e navegador sem terem a mesma UI ou escopo. + +O Studio já possui modelo canônico de Scene Bank, workflow de layers e publicação para packer. Precisamos explicitar se a futura cena de jogo é exatamente esse recurso ou se compõe também entidades, scripts, áudio e outras referências. Não assumir equivalência entre Scene Bank runtime e uma cena de autoria mais ampla. + +Pixels e áudio/sequenciador devem usar integração semelhante quando priorizados: documentos/recursos reconhecidos pelo projeto, previews, operações e formatos definidos. Um editor emergencial de pixels pode começar com objetivos pequenos; prometer compatibilidade com formatos complexos, animações ou áudio completo exigiria decisões próprias. Importar assets externos continua sendo um fluxo normal, com proveniência, reimport e conflito preservados. Não é necessário escolher agora um editor para cada formato. + +## 4. ACP, MCP e LSP têm papéis complementares + +| Fronteira | Papel proposto | +| --- | --- | +| Studio cliente ACP → agente | Sessão de conversa, envio de prompt/contexto, atualizações, pedidos de permissão e configuração anunciada pelo agente | +| Agente cliente MCP → Studio | Ferramentas especializadas de assets, build, runtime, testes, animação e evidências, com autorização do projeto e serviços existentes | +| Editor interno ou externo cliente LSP → servidor de linguagem | Diagnostics, completion, navegação e demais capacidades do frontend/compiler | +| GUI → API/Core | Edição e operações humanas sobre os mesmos serviços especializados | + +Essa composição mantém o agente como programa que conduz seu loop e o Studio como cliente visual e dono das capacidades/autoridade do projeto. Ter prompt integrado não obriga criar um orquestrador de modelos ou duplicar ferramentas MCP em ACP. + +A documentação oficial do ACP descreve prompt, sessão e notificações; o setup admite servidores MCP e a configuração de sessão pode expor seleção de modelo e parâmetros. A UI deve refletir as opções de cada agente: não prometer qualquer modelo em qualquer agente, nem inferir que mudar modelo preserva contexto. Autenticação e credenciais dependem do agente e de suas capacidades. Ver [overview v1](https://agentclientprotocol.com/protocol/v1/overview), [session setup](https://agentclientprotocol.com/protocol/v1/session-setup) e [config options](https://agentclientprotocol.com/protocol/v1/session-config-options). + +Na consulta desta sessão a documentação identifica v1 como Latest e v2 como Draft. Não escolhemos versão, SDK, agente ou matriz de compatibilidade; uma investigação futura deve fixar versões efetivamente testadas e separar recursos publicados de drafts. + +## 5. Prompt contextual e autoridade + +Uma hipótese de UX é um painel de agente recolhível, acessível em todo o projeto, com agente/modelo, contexto associado, prompt, andamento e permissões. O conteúdo visual continua sendo o centro de criação. Além de digitar um pedido, o usuário poderia anexar ou referenciar asset selecionado, trecho de código, diagnostics, scene ou captura de teste. É importante tornar explícito qual contexto será enviado e qual alvo será alterado. + +O envio de um prompt de análise pode ter uma política diferente de uma tarefa que vai escrever e executar. A ação de executar uma tarefa poderia coordenar save/handoff, autorização, envio e acompanhamento, mas o usuário precisa saber qual autoridade concede. O grant implícito não deve ser introduzido como detalhe de implementação. A política exata continua aberta. + +É plausível começar com um agente executor por projeto, alinhado à autoridade atual de tarefa única, enquanto múltiplas conversas, sessões ou agentes permanecem possibilidades separadas. Conversa, turno, tarefa Studio, operação e processo são identidades diferentes; não presumir equivalência um-para-um sem decidir os casos. + +Os estados visuais podem reutilizar a máquina existente: Manual → Waiting → Working → Returning → Manual. Enquanto o agente escreve, manter navegação, preview, leitura e inspeção; bloquear mutações conflitantes. Durante a retomada, invalidar autoridade, pedir interrupção, terminar operações geridas, reconciliar documentos e somente então liberar edição. Conversa encerrada não comprova término de todos os processos. + +ACP melhora a capacidade de coordenar o agente, mas não é um sandbox de filesystem. Revogar MCP controla entrada nos serviços do Studio; um processo com acesso direto ao projeto precisa de lifecycle e política próprios. A documentação explicita permissões do processo e cancelamento; não atribuir ao protocolo garantias de isolamento ou de término universal de subprocessos. Esse limite é diretamente relevante à expectativa humana de controlar acesso enquanto a IA trabalha. Ver [trust model v1 no repositório oficial](https://raw.githubusercontent.com/agentclientprotocol/agent-client-protocol/main/docs/protocol/v1/security.mdx) e [cancellation v1](https://agentclientprotocol.com/protocol/v1/cancellation). + +## 6. Fronteiras atuais a revisar quando houver decisão + +Specs 9 e 10 atualmente delegam agente/chat/provedor ao cliente externo, e spec 10 proíbe chat/provider settings dentro de DEV. A nova intenção humana autoriza discutir a revisão dessas regras, sem transformar a baseline atual em justificativa para rejeitar a ideia nem fingir que a mudança já foi decidida. + +Uma evolução possível preserva API/Core neutros e mantém processo, protocolo ACP e credenciais no adapter de infraestrutura, com apresentação JavaFX e contratos de sessão adequados. A localização exata do host e de novos serviços precisa de decisão; não assumir dependências de SDK ACP na API, Core ou controles. + +O terminal de WRK-000D permanece discussão relacionada. Um cliente ACP estruturado pode oferecer experiência integrada sem terminal visível permanente. Um terminal ainda pode ter uso geral e interativo; ACP e terminal não são automaticamente entregas equivalentes. + +## 7. Temas e identidade visual + +Múltiplos temas entram explicitamente na direção de produto. O tema controla paleta, tipografia, ícones e tratamento de superfícies/estados; o layout e o comportamento dos editores pertencem às suas responsabilidades próprias. Isso ajuda a criar um tema bananodore expressivo e outros temas de leitura/contraste sem manter versões paralelas de componentes. + +O CSS e o ThemeService atuais são pontos de partida, mas não demonstram um catálogo/trocador de temas completo. Definir tokens semânticos de superfície/texto/foco/seleção/status é mais útil que escolher cores isoladas agora. Extensões futuras devem consumir os mesmos papéis de estilo e regras de foco/i18n. Fontes de código, timelines e dados precisam manter legibilidade mesmo em um tema mais ornamental. + +## Próximas questões de discussão + +1. Centro do Studio como host de editores/visualizadores: quais conteúdos atuais devem provar essa ideia primeiro? +2. Painel de agente como ferramenta global recolhível: ele acompanha seleção/editor ou usa anexos/contexto fixados explicitamente por conversa? +3. Um executor por projeto inicialmente, com conversas independentes? Como a ação de enviar/executar expressa a concessão de autoridade? +4. Qual profundidade de integração ACP é desejada: só prompt/tool activity e MCP ou também mediação de filesystem/terminais disponíveis no agente/protocolo? +5. LSP externo somente com sessão do Studio aberta ou também em modo separado? Qual política para buffers concorrentes? +6. Qual relação entre scene de jogo futura e Scene Bank canônico atual? +7. Tema altera só aparência ou também densidade preferida? Quais estados e editores são os primeiros exemplares para validar o tema bananodore? + +Minha recomendação provisória é explorar como eixo do shell a tríade projeto + editores + agente contextual, preservando ferramentas operacionais e contratos atuais. Essa hipótese acomoda a suíte futura e permite melhorar a UI existente antes de entregar os novos editores. Todas as escolhas de implementação permanecem abertas. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0010.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0010.md new file mode 100644 index 0000000..6c4239d --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0010.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0010" +workId: "WRK-0013" +discussionId: "TOP-0002" +kind: "RESPONSE" +author: "Nilton" +createdAt: "2026-11-17T10:42:54.038134Z" +respondsTo: "DSC-0003" +documentVersion: 2 +--- + +Direção humana explícita nesta conversa: colocando o Studio como IA first, o editor deveria ser a unidade principal, com a IA na frente daquilo que estaria editando. O Prometeu trabalha com bancos de assets, empacotados para servir de tilesets e spritesheets/animações, carregados na memória em execução. O editor de scenes e a futura montagem de entidades devem trabalhar com esses bancos. Ainda não há editor de entidades. A scene desejada é semelhante à Unity, enquanto atualmente atende principalmente ao mapa. Autorizada inspeção do runtime para aprofundar a discussão. Esta resposta estabelece a direção editor como unidade principal; não define ainda o vínculo exato entre seleção, documento ativo e alvo de tarefa, nem aprova DEC/implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0011.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0011.md new file mode 100644 index 0000000..92671db --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0011.md @@ -0,0 +1,78 @@ +--- +schemaVersion: 1 +id: "DSC-0011" +workId: "WRK-0013" +discussionId: "TOP-0005" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T10:44:28.038269Z" +respondsTo: null +documentVersion: 2 +--- + +# Terceira síntese — editor principal, IA contextual e scenes centradas em bancos + +Síntese parcial após a resposta humana DSC-0010. Owner de produto: studio. Runtime consultado somente em leitura. Evidência complementar: ART-0002. EXPLORATORY permanece ativo; sem DEC, Plan ou implementação. + +## Direção estabelecida e questões que continuam abertas + +O usuário escolheu o editor como unidade principal do Studio, com a IA na frente daquilo que edita. Isso fortalece a direção de um host central de editores/visualizadores e reduz a pertinência de tratar cada área operacional como tela independente. A posição exata do prompt e a relação entre foco, seleção e alvo de tarefa ainda precisam de discussão. + +Interpretação proposta de IA na frente: a IA é um meio de atuar diretamente sobre o conteúdo e seu contexto, com ações/resultados visíveis no editor correspondente. O centro continua mostrando o objeto de criação e o usuário consegue editar/inspecionar conforme a autoridade atual. Não reduzir AI-first a um chat global que perde a seleção, nem tratar a escolha do editor como exigência de execução manual passo a passo. + +O produto deve representar bancos como unidades reais de conteúdo, dependências e publicação. Tilesets e spritesheets são papéis de uso desses bancos gráficos. A limpeza visual deve ajudar a entender essas relações e automatizar trabalho operacional sem ocultar requisitos da máquina. + +## O que a leitura do runtime confirmou + +1. `runtime/docs/specs/runtime/15-asset-management.md` define assets como bytes frios do cartucho, materializados em bancos geridos pelo host/runtime, separados do heap da VM. O artefato é `assets.pa`, com tabela e payload, e preload de boot. Empacotado, carregado, pronto e committed são fatos diferentes. +2. Os tipos atuais incluem GLYPH, SCENE e SOUNDS. `GlyphBank` representa a folha gráfica indexada e suas paletas. Usar um banco como tileset ou para sprites não cria duas famílias físicas novas de runtime. +3. `SceneBank` contém exatamente quatro `SceneLayer`. Cada layer contém dependência `glyph_asset_id`, tile size, parallax e tilemap. Cada tile contém active, glyph/palette e flips. Não há hierarquia persistida de entidades/scripts nesse formato inspecionado. +4. `FrameComposer` vincula um SceneBank residente, usa câmera e cache/resolver do viewport e compõe sprites fornecidos separadamente. O exemplo `studio/test-projects/main/src/main.pbs` vincula o mapa com `Composer.bind_scene(0)` e emite sprite com `Composer.emit_sprite(...)` no frame. +5. A dependência do mapa é publicada por `AssetId`, não por slot fixo. `FrameComposer.resolve_glyph_slots` consulta o índice de residência AssetId→slot. Dependência ausente em bind/draw é falha fatal do contrato atual, não um carregamento automático ou apenas aviso visual. +6. `MemoryBanks` tem 16 slots por família na implementação consultada. Isso é evidência do runtime atual, não autorização para colocar esse número fixo em controles JavaFX; budgets e perfil qualificado devem continuar vindo dos serviços produtores. +7. A autoria de animação existente já usa UUID do bank, artifact IDs estáveis, bindings e fingerprints. Não persiste runtime slot/posição/paleta na definição. O gerador PBS recebe `bank_id` ao construir o animator. Reordenar assets pode exigir rebind explícito; imagens/índices não são intercambiáveis por posição de lista. + +Buscas dirigidas não localizaram um framework runtime Entity/GameObject/World nas superfícies consultadas. Isso não prova ausência em todo SDK/projeto externo. O que está demonstrado é que SceneBank, Sprite e a composição inspecionados não estabelecem sozinhos o futuro modelo de entidades da suíte. + +## Três níveis úteis para a discussion + +| Nível | Papel e estado | +| --- | --- | +| Banco de conteúdo | Glyphs/paletas, mapas e sons preparados e publicados pelos contratos de asset; infraestrutura existente, com diferentes coberturas de autoria no Studio | +| SceneBank atual | Mapa em quatro layers e suas dependências gráficas, consumido pela composição runtime; implementação existente | +| Scene de autoria mais ampla | Ambiente que reúne mapa, instâncias de entidades, referências de scripts/animações e demais propriedades que vierem a ser definidas; direção futura solicitada, ainda sem contrato aprovado | + +A semelhança com Unity foi expressa pelo humano como visão de scene, não como adoção automática de GameObject/Component, ECS, prefabs ou formato de engine alheia. A proposta mais compatível com a base é uma scene de autoria que possa referenciar o mapa existente e definições/instâncias de entidades, com projeção explícita para o jogo. + +Preservar SceneBank como produto do mapa evita alargar incidentalmente seu formato binário. Continuam abertas pelo menos duas alternativas: um documento de scene de autoria que é projetado em bancos + código/dados de inicialização; ou evolução de um contrato runtime para consumir composição mais ampla. A inspeção atual favorece investigar primeiro a projeção em capacidades existentes, mas não comprova que basta nem escolhe formato, linguagem, gerador ou dono de runtime de entidades. Qualquer alteração futura no runtime exigirá escopo e autorização específicos. + +O futuro editor de entidades merece discussão própria: definição reutilizável versus instância, propriedades editáveis, vínculo a código, estado por instância e serialização/lifecycle. Um sprite é a representação gráfica de uma entidade possível; não basta para definir comportamento, persistência, colisão ou outros componentes. Esses recursos não devem aparecer como capacidades já entregues. + +## Consequências de UX para o shell e os editores + +O host central deve abrir o tipo de conteúdo em que se trabalha: mapa, animação, banco, código e futuramente scene/entidade. A navegação oferece acesso a esses objetos e suas dependências. O inspector segue o contexto de edição aceito, e as ferramentas operacionais apresentam diagnóstico/resultado sem exigir abandonar o trabalho. + +No editor de mapa, o usuário deve escolher tiles de banks reais, pintar layers e inspecionar os vínculos. No de animação, frames vêm dos artifacts do bank. No futuro editor de entidade, a representação gráfica referencia banco/animação e separa posição/instância da definição do recurso. O banco pode ser inspecionado e reorganizado como conteúdo próprio, mantendo relações com seus consumidores. + +Uma indicação contextual de dependências, capacidade e blockers faz parte da ferramenta de criação. Exemplos de mensagens úteis: mapa referencia tileset não incluído; animação está em drift após reordenação; dependência necessária não está coberta pelo preload/estratégia de carregamento conhecida. Cada afirmação precisa vir da análise produtora apropriada. O editor não deve inferir estado residente atual a partir de inclusão no build ou do total de banks potenciais. + +Isso revisa a proposta de simplificar Assets: muitas operações deixam a superfície permanente de administração, mas gerenciamento e inspeção de bancos continuam centrais. Algumas tarefas são mais naturais no editor consumidor; outras, como composição/reorganização de um bank compartilhado, precisam de visão própria e análise de referências. Nem todo detalhe técnico deve desaparecer, porque parte dele explica restrições concretas do jogo. + +## IA contextual sobre o mesmo modelo + +Hipótese de interação: o editor expõe um pedido contextual com alvo visível. O usuário pode pedir à IA para compor/ajustar um mapa, reparar bindings de animação ou preparar um bank. A IA consulta conteúdo canônico, dependências, revisões, perfil/budget e diagnostics, usa serviços compartilhados e produz resultados que a GUI consegue atualizar e inspecionar. + +O alvo inicial pode vir do editor ativo e da seleção; uma tarefa em execução deve manter identidade e escopo próprios. Navegar para outro editor para inspecionar um resultado não deveria redirecionar silenciosamente a tarefa. A tarefa pode legitimamente tocar vários banks/arquivos; o escopo e os afetados precisam continuar legíveis, sem restringir toda operação ao único documento visível. + +Um pedido futuro como adicionar inimigos a uma sala evidencia os limites atuais: preparar assets/animações e editar mapa tem bases existentes; criar instâncias persistentes e ligar seu comportamento depende do futuro modelo de entidade/scene. ACP é a interação com o agente; a capacidade de domínio precisa existir em serviços de autoria para GUI/MCP ou ter um caminho de edição de código explícito. Não prometer que anexar um prompt cria esse contrato automaticamente. + +Quanto ao empacotamento, a direção AI-first é permitir à IA preparar batches, composição, bindings e validação por objetivo, mantendo revisão/conflicto e diagnósticos existentes. Um editor deve apresentar tanto o resultado visual quanto prontidão de publicação. O pipeline geral — fontes/autoria, preparação/publicação, cartucho, residência, execução — tem etapas distintas; a interface pode torná-las compreensíveis sem obrigar o humano a executá-las uma a uma. + +## Próximas questões a amadurecer + +- Qual é a primeira definição de scene de jogo acima do mapa: referência a SceneBank + instâncias de entidades + configuração inicial? Que partes ainda permanecem no código do jogo? +- Que constitui uma entidade reutilizável e como seus dados são vinculados a scripts/animações sem impor arquitetura Unity ou ECS por analogia? +- Como o editor e a IA apresentam e validam dependências de conteúdo, publicação e residência? Quem produz uma eventual estratégia de carregamento por scene, respeitando o runtime atual? +- Que ação fixa o contexto da tarefa da IA e como mostrar múltiplos documentos/banks afetados durante a navegação? + +A direção de produto editor principal está registrada como resposta humana, e as demais escolhas permanecem abertas. Não foi adotado um formato novo de scene, editor de entidades, sistema de componentes ou comportamento de carregamento automático. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0012.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0012.md new file mode 100644 index 0000000..4fdf80f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0012.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0012" +workId: "WRK-0013" +discussionId: "TOP-0005" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T10:52:11.872182Z" +respondsTo: null +documentVersion: 2 +--- + +Correção humana: a scene possui o mapa, mas não é somente o mapa; sua representação vai evoluir com o tempo. Entidades ainda não existem no Prometeu. O port Zelda 1 do NES em ./ports/nes/zelda-1 foi majoritariamente feito com IA usando a UI e o MCP atuais. O humano acompanhou a evolução e relata não ter escrito uma linha de código. Esse projeto já ajudou a melhorar o Prometeu; o humano solicita examinar como suas responsabilidades estão separadas. A inspeção é contextual ao redesign, não uma solicitação de retomar o port ou implementar entidades/scenes. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0013.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0013.md new file mode 100644 index 0000000..2da94e5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0013.md @@ -0,0 +1,87 @@ +--- +schemaVersion: 1 +id: "DSC-0013" +workId: "WRK-0013" +discussionId: "TOP-0001" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T10:53:41.961874Z" +respondsTo: null +documentVersion: 2 +--- + +# Quarta síntese — organização do port Zelda 1 como caso de UX AI-first + +Atualiza DSC-0011 à luz da correção humana DSC-0012. Estudo somente de leitura; fontes, hashes, revisão e limites em ART-0003. Owner da discussão: studio. Nenhuma alteração no port, no runtime ou na implementação do Studio. EXPLORATORY permanece aberto. + +## Correção de enquadramento + +A scene possui o mapa e deve evoluir além dele. A representação atual de SceneBank/tilemap não deve ser usada para limitar o conceito de produto nem para determinar antecipadamente um segundo tipo de recurso scene. A formulação anterior que separava rigidamente SceneBank de uma scene maior era uma alternativa especulativa, não uma definição aceita. A investigação deve partir da intenção humana de evolução e dos contratos realmente existentes. + +Entidades ainda não existem como capacidade do Prometeu. Link, Octoroks, Zora, lojas e objetos do port são código específico do jogo em structs/services. São exemplos úteis de necessidades futuras, não evidência de um sistema de entidades existente ou decisão sobre ECS/componentes/prefabs. + +O relato humano de produção quase integral por IA, sem código escrito pelo usuário e com acompanhamento da evolução, é referência central do produto. AI-first já é um workflow praticado; o redesign deve melhorar sua observabilidade, clareza e interação. A escolha do editor como unidade principal não obriga o usuário a virar operador de formulários ou programador manual. O editor pode ser o lugar para ver, orientar, inspecionar e corrigir o conteúdo trabalhado pela IA. + +## Separação observada no jogo + +| Superfície | Responsabilidade verificada | +| --- | --- | +| `prometeu.json` e `src/main.pbs` | Projeto `zelda1`, target Game, app_id estável e memcard; root liga Init/Frame/MemcardBoot aos módulos, sem concentrar gameplay | +| `src/game` | GameFlow coordena abertura, menus, partida, morte e lifecycle externo; chama atualização/desenho | +| `src/scene` | Serviço de apresentação do jogo: área NES 256×240 centralizada no framebuffer 480×270, câmera, alinhamento de sprites, HUD e moldura | +| `src/stage` | Fronteira da sala ativa, transições, render do cenário, acesso a sondas/colisão e encaminhamento de interações | +| `src/stages/` | Conteúdo e regras locais, dados do terreno, colisão, entradas e objetos de cada sala; não correspondem necessariamente a um banco ou slot exclusivo | +| `src/overworld` | Catálogo gerado de identidade das salas, câmera, vizinhança, inimigos, HUD e transições | +| `src/link`, `src/enemies`, `src/loot` | Estado/comportamento/render próprios de atores, armas, tiros e drops; exemplos de composição de gameplay em código | +| `src/inventory`, `src/world`, `src/save` | Inventário, flags persistentes e save separados de apresentação e de desenho do mapa | +| `src/hud`, `src/screens`, `src/shop` | HUD/telas e regras compartilhadas de visita/compra; duas lojas reutilizam ShopVisit | +| `assets` | Banks gráficos de personagens/tilesets/UI e Scene Banks; suas identidades e relações com o código/importação | +| `tools` e `extracted` | Extração/oráculos NES, geração de conteúdo, fixtures e evidências retidas. O gerador final do overworld compõe atlas, mapas e fontes para múltiplas responsabilidades | + +Essa separação pertence ao jogo. O nome `src/scene` designa seu serviço de apresentação; não é automaticamente um schema de scene do Studio. A arquitetura da UI deve tornar as relações navegáveis sem converter cada pasta em um workspace. + +## Casos concretos que mudam a discussão de UX + +### 1. Sala lógica, banco e slot são diferentes + +O catálogo contém 13 salas do overworld e 15 ligações bidirecionais. O estado do port registra também quatro interiores. `prepare_overworld.py` publica um atlas compartilhado de salas, outro de transições e fontes de catálogo; o caminho de render usa slots 13 para o atlas de salas, 14 para transições e 15 para inventário. Stage ID 16 é uma identidade de conteúdo, não slot 16. + +Uma navegação limitada a banks mostraria a organização física do empacotamento, mas não explicaria sozinha as salas e suas ligações. A UX precisa oferecer a unidade lógica que o usuário está criando e permitir inspecionar os banks utilizados, sua região no atlas, consumidores e orçamento. Não presumir relação um-para-um entre scene/sala/editor e slot de memória. + +### 2. Terreno compartilhado e objetos mutáveis já são uma necessidade real + +`docs/scene-composition.md` explica que caverna e lojas reutilizam terreno e emitem NPCs, produtos, texto/fogo separadamente. A compra/piscar não exige trocar o banco inteiro. `CaveShop.render()` vincula o terreno 1 e `draw_objects()` combina arte e estado da visita. `BombableWall` mantém uma flag que coordena cobertura, colisão e entrada. + +Uma futura experiência de scene deve permitir compreender o conjunto e inspecionar o elemento relevante: origem gráfica, estado, posição, regra e código. Isso é requisito de navegação e inspeção; um editor completo de entidades ainda é projeto futuro. Não fabricar uma hierarquia editável automaticamente a partir de structs PBS arbitrários. + +### 3. Contexto da IA atravessa vários arquivos e recursos + +Adicionar uma sala no port pode afetar catálogo, terreno, atlas de transição, marcador de HUD, faixa de inventário, vizinhança e código. `prepare_overworld.py` torna essa relação concreta e mantém identidades/índices existentes. + +Assim, IA associada ao editor deve começar pelo alvo visível, mas apresentar o conjunto de afetados da tarefa. Restringir todo contexto a um arquivo perde parte importante da produção. Mudar a aba não deve trocar silenciosamente o alvo da tarefa. Uma revisão legível pode agrupar resultado visual, recursos alterados, consumidores e validações, com acesso ao código conforme necessário. + +### 4. Autoria e geração precisam de proveniência + +Há fontes e dados gerados, metadados de asset, PNGs e entradas de origem. Algumas regras manuais coexistem com arquivos gerados; `prepare_overworld.py` inclusive produz wrappers e ajustes locais. A UI deveria permitir seguir origem → saída → usos e identificar o produtor quando registrado. Não tomar apenas extensão/nome `.generated` como autoridade nem executar geradores arbitrários automaticamente. A integração com ownership/dependencies existentes deve ser avaliada. + +### 5. Revisão de execução e evidência é parte do editor AI-first + +O port tem documentação e resultados históricos de validação visual, inputs determinísticos, colisão, flags e save. O arquivo retido de refactor registra 58 casos aprovados; esses resultados não foram reexecutados nesta inspeção. O feedback também registra casos em que uma referência derivada do mesmo PNG não detectou erro de composição e em que uma fixture falhou sem que o jogo estivesse errado. + +Isso sugere preview jogável/observação, checkpoints, comparação e origem do diagnóstico como ferramentas fundamentais para quem dirige a IA. Um resultado deve indicar revisão/build, fonte da referência, limites de cobertura e se é execução atual ou evidência histórica. A leitura de código deve estar disponível, mas a avaliação do progresso pode começar pelo comportamento e pelo conteúdo visual. + +## Feedback do port e comparação temporal + +`docs/prometeu-feedback.md` registra aspectos a preservar: identidade verificável de banks/artifacts, ticks explícitos para preview, build/pack/runtime integrados, capturas determinísticas, diagnósticos localizados e grant/revisões explícitos. O redesign precisa conservar essas garantias enquanto reduz a exposição operacional rotineira. + +O mesmo documento registra custos históricos de importar/criar banks editando persistência, manipular base64 e comparar imagens com scripts, inferir estado final de autoridade e localizar falhas de build. Vários itens são linguagem/runtime ou limitações das ferramentas do agente, não defeitos visuais demonstrados; o documento afirma que os painéis do Studio ainda não foram avaliados visualmente. + +O catálogo fonte atual do Studio já contém `studio_assets_preview/commit/budget`, ferramentas de evidência/compare/image e testes. Portanto, ATR-08 e ATR-19 são motivação histórica e cenários de revalidação, não prova de ausência atual. Nesta auditoria não foi verificado o que a instalação do usuário anuncia ou como o port se comporta com essas APIs novas. Também não se deve importar como decisão a proposta histórica de novos transportes HTTP/WebSocket feita no feedback; o Studio já possui fronteiras próprias. + +## Direção de UX reforçada por este caso + +Editor principal como ambiente de criação e inspeção, com IA contextual e capacidade de atuar em escopo maior que o documento. Navegação liga conteúdo lógico, banks, fontes e resultados. Inspector apresenta o que o produtor conhece; ferramentas inferiores oferecem operação, problemas, testes e evidências com identidade consistente. + +Uma tarefa representativa para avaliar o redesign é ampliar uma sala/conexão e verificar resultado visual e comportamento, preservando orçamento e recursos compartilhados. Ela exercita os mesmos serviços que já tornaram o port possível e pode revelar se o humano consegue acompanhar e orientar o trabalho sem dominar slots, arquivos de registry e scripts de transporte. + +O próximo aprofundamento deve tratar de como mostrar esse conteúdo lógico e sua proveniência, com os contratos hoje disponíveis e sem prometer entidades ou interpretação universal de código. A evolução de scenes continua aberta; nenhum novo formato, modelo de entidades ou gerador foi escolhido. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0014.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0014.md new file mode 100644 index 0000000..f8e6525 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0014.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0014" +workId: "WRK-0013" +discussionId: "TOP-0007" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T11:14:27.715213Z" +respondsTo: null +documentVersion: 2 +--- + +Esclarecimento humano: ports/nes/zelda-1/docs/prometeu-feedback.md já foi usado para aprimorar o Studio. O Studio deve facilitar a vida técnica e permitir que a criatividade afloreça, para que o técnico não seja impeditivo para criar um game. A IA está ali para codar em PBS e ajustar o necessário para o Prometeu rodar a ideia. Esta é a intenção de produto para a discussão, sem autorização de implementação ou encerramento da exploração. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0015.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0015.md new file mode 100644 index 0000000..8a21479 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0015.md @@ -0,0 +1,37 @@ +--- +schemaVersion: 1 +id: "DSC-0015" +workId: "WRK-0013" +discussionId: "TOP-0007" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T11:14:28.146703Z" +respondsTo: null +documentVersion: 2 +--- + +# Criatividade como objetivo da experiência AI-first + +Refinamento exploratório após esclarecimento humano. O feedback do Zelda já foi usado para aprimorar o Studio; tratá-lo como histórico de aprendizado e evidência de produção, sem reabrir seus itens como backlog de correções por inferência. + +## Intenção humana + +O Studio deve facilitar a vida técnica e permitir que a criatividade afloreça: o técnico não deve impedir a criação do jogo. A IA está presente para programar em PBS e ajustar o necessário para o Prometeu executar a ideia. Isso esclarece a motivação de AI-first e o significado do editor como unidade principal. + +## Interpretação para discutir + +O percurso central deve partir de uma intenção de criação, permitir acompanhar sua materialização e terminar com um resultado que o usuário consegue experimentar, inspecionar e orientar. A IA traduz essa intenção em código PBS, composição/preparação de assets, configuração, build e ajustes, conforme as capacidades e contratos disponíveis. O editor oferece o contexto visual e os meios de autoria/avaliação; o humano pode dirigir o trabalho sem precisar conhecer cada etapa do pipeline. + +Exemplo futuro de experiência: pedir que o personagem execute uma ação numa sala, ver o resultado jogável e orientar ritmo, aparência ou comportamento. O Studio torna visíveis os conteúdos e resultados relevantes; a IA investiga e realiza as alterações técnicas necessárias no escopo autorizado. A interação pode atravessar código, animações e bancos mantendo contexto e rastreabilidade. + +As restrições reais da máquina continuam existindo. A proposta de UX é permitir que a IA resolva os detalhes técnicos e que o Studio apresente consequências e escolhas criativas quando forem necessárias. Quando não houver capacidade ou solução válida, comunicar o limite concreto e alternativas compreensíveis; não prometer execução universal nem esconder falhas. O usuário continua podendo acessar código, propriedades e operações manuais para precisão, aprendizado e recuperação. + +Critérios de experiência sugeridos, ainda sem decisão ou plano: + +- O usuário consegue formular uma intenção e reconhecer seu resultado no editor/execução. +- O contexto da tarefa e o progresso são claros, inclusive quando atravessam vários recursos. +- Detalhes operacionais rotineiros não exigem intervenção humana constante. +- Uma limitação técnica chega ao humano como problema compreensível e escolha pertinente, com evidência disponível para aprofundamento. +- O usuário consegue experimentar, pedir ajustes e retomar controle com segurança. + +O critério mais relevante do redesign passa a ser a facilidade de transformar intenção em jogo verificável. A aparência Pixel Vision 8, os temas, a organização do shell e o cliente ACP devem servir esse objetivo. Nenhum item deste registro aprova implementação ou encerra a exploração. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0016.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0016.md new file mode 100644 index 0000000..0445f47 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0016.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0016" +workId: "WRK-0013" +discussionId: "TOP-0002" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T11:18:15.715942Z" +respondsTo: null +documentVersion: 2 +--- + +Esclarecimento humano: o desenvolvedor pode escolher fazer mais coisas manualmente e pedir apenas orientação à IA, ou delegar somente pequenos ajustes. Todos esses percursos precisam ser possíveis. Há pessoas que se divertem fazendo o jogo. Autoria manual é parte da experiência criativa, não apenas alternativa de recuperação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0017.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0017.md new file mode 100644 index 0000000..0b76168 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0017.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0017" +workId: "WRK-0013" +discussionId: "TOP-0002" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T11:18:16.141216Z" +respondsTo: null +documentVersion: 2 +--- + +Refinamento exploratório: AI-first significa IA integrada ao contexto de criação com grau de participação escolhido pelo desenvolvedor em cada tarefa. A suíte deve oferecer autoria manual completa, orientação sem mutação, colaboração pontual e delegação ampla, com transição fluida em vez de modos de produto rígidos. A orientação da IA pode coexistir com edição humana; tarefas que escrevem preservam a coordenação de autoridade e conflitos. Simplificar a UI exige hierarquia e controles contextuais, preservando descoberta e qualidade das ferramentas manuais. Menus avançados não devem virar destino genérico de toda autoria manual. O editor permanece espaço comum de criação e inspeção; o prazer de construir e aprender é um objetivo de UX. Essas implicações são propostas para discutir, sem DEC ou implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0018.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0018.md new file mode 100644 index 0000000..3aec6c5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0018.md @@ -0,0 +1,26 @@ +--- +schemaVersion: 1 +id: "DSC-0018" +workId: "WRK-0013" +discussionId: "main" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T11:57:32.492415Z" +respondsTo: null +documentVersion: 2 +--- + +# Escolhas humanas — conversa, foco da IA e migração incremental + +Resposta explícita de Nilton aos seis questionamentos da síntese anterior, seguida de intenção de novo módulo. Registro de direção dentro da exploração; não é encerramento de EXPLORATORY nem aprovação de DEC/implementação. + +1. **Conversa:** uma por projeto. Isso substitui a hipótese de múltiplas conversas por objetivo discutida anteriormente. +2. **Contexto e foco:** trazer o prompt para dentro do Prometeu deve permitir selecionar conteúdo e fornecê-lo à IA. Com uma IA rodando, o Studio deve ficar travado no trabalho da IA, prompt e resultado. +3. **Convivência:** a resposta sobre exclusividade/edição humana durante execução remete ao item 2. +4. **Apresentação:** semelhante ao fluxo atual e ao prompt do Codex: prompt abaixo e output acima. +5. **Detalhes técnicos:** concordância com apresentar restrições acionáveis e estado resumido no contexto, com aprofundamento técnico disponível. +6. **Prioridade:** preparar primeiro o ambiente da IA; depois Assets; editores de código e scene na sequência; Shipper pode vir por último. Ordem relativa entre código e scene não foi especificada. Debug, Tests, evidências e outros editores não foram descartados nem tiveram prioridade definida nesta resposta. + +**Migração:** o humano deseja criar um novo módulo para o refactor, mantendo a implementação atual como consulta e backup, e acrescentando capacidades progressivamente. O novo deve começar com suporte a temas e i18n, pois esses aspectos se perderam na UI anterior. + +Continuam válidos JavaFX, serviços compartilhados, autoria manual/orientação/ajustes/delegação escolhidos por tarefa e futura evolução de scenes. O modo de discussão permanece EXPLORATORY. Não inferir autorização de DEC/Plan, migração de dados, substituição da aplicação atual, duplicação do backend ou implementação imediata de editores. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0019.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0019.md new file mode 100644 index 0000000..c9452cb --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0019.md @@ -0,0 +1,77 @@ +--- +schemaVersion: 1 +id: "DSC-0019" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T11:57:33.271203Z" +respondsTo: null +documentVersion: 2 +--- + +# Síntese de direção — novo módulo JavaFX e primeiro corte de IA + +Exploração de WRK-0013 após escolhas humanas em DSC-0018. Não é DEC/Plan ou implementação. As prioridades e a conversa única por projeto vêm do humano; nomes, fronteiras exatas e composição abaixo são propostas técnicas para discutir. + +## Experiência consolidada + +Uma conversa por projeto, com contexto obtido a partir do conteúdo selecionado. O editor continua sendo unidade de criação/inspeção; a mesma conversa pode operar sobre vários conteúdos do projeto. Não criar uma conversa independente por editor nem trocar silenciosamente o alvo da tarefa quando o foco muda. + +Durante a execução da IA, o humano pediu que o projeto fique travado no trabalho da IA, prompt e resultado. Interpretação proposta: foco visual na tarefa em andamento e bloqueio das ações/navegação que desviem ou alterem o trabalho; interrupção e retomada continuam acessíveis. Esta leitura é mais restritiva que a hipótese anterior de navegação livre durante escrita e precisa ser refletida na futura revisão de UX, sem enfraquecer autoridade/cleanup do Core. + +Estado visual do painel e autoridade são fatos relacionados, mas distintos. Uma resposta de orientação pode não exigir autoridade de mutação; tarefas que escrevem precisam do handoff e exclusão existentes. O fim de um turno ACP, término de workers e devolução de autoridade não devem ser tratados como o mesmo evento por conveniência visual. Continua por definir em que momento o editor é liberado ao fim de cada tarefa/turno e como lidar com follow-up enquanto há execução. + +O bloqueio tem como unidade proposta o projeto da tarefa, consistente com a conversa e autoridade atuais. Não inferir travamento de outras janelas/projetos do processo desktop. A escolha de foco visual não exige um novo sistema de permissão paralelo. + +Apresentação solicitada: composer de prompt embaixo, saída/histórico acima. Texto, chamadas de ferramenta, permissões, resultados e links para imagens/artefatos podem compor esse output, com detalhes acessíveis. Não prometer um terminal/emulador Codex idêntico: a integração escolhida é cliente ACP com apresentação JavaFX. + +## Novo módulo como estratégia incremental + +Sugestão de nome provisório: `prometeu-studio-ui-javafx-next`. + +O módulo atual `prometeu-studio-ui-javafx` permanece disponível como referência funcional e opção de retorno durante a transição. O novo implementa apresentação, componentes, estado visual, temas, localização e o host de conteúdo. Reutiliza `prometeu-studio-api`, sessões, autoridade, operações, autoria de assets, diagnósticos e MCP existentes. + +Não copiar Core, backend, runtime, compiler ou servidor MCP. Evitar dependência geral da UI nova sobre a UI antiga: isso levaria o shell e seus acoplamentos para a nova implementação. Componentes/recursos efetivamente úteis podem ser aproveitados deliberadamente, com fronteira explícita. O objetivo não exige uma coleção de módulos novos de design system, plugins e abstrações especulativas. + +Protocolo/processo ACP e integrações concretas precisam de fronteira de infraestrutura; a UI consome contratos e eventos adequados. O desejo de novo módulo visual não implica colocar subprocessos, credenciais, codecs e coordenação de tarefas dentro de controls JavaFX. Os contratos ACP ainda precisam ser decididos; a autoridade do projeto permanece compartilhada. + +O app atual compõe diretamente StudioUiFactory/StudioWindowCoordinator e importa I18nService/ThemeService da UI existente. `settings.gradle.kts` e o build de `prometeu-app` incluem apenas esse adapter visual. Portanto, criar um diretório novo não basta: uma futura implementação precisa de uma composição selecionável que monte uma UI por sessão/lançamento, reutilizando a mesma infraestrutura. A forma de seleção ainda não foi escolhida; não criar dois donos concorrentes da mesma sessão de projeto por acidente. + +Temas e bundles dos dois adapters precisam de namespaces/resources distintos para evitar colisão de classpath. Layout/restauração novos também precisam de compatibilidade e fallback explícitos, preservando os arquivos canônicos do projeto e o papel de `.studio/state.json`. A opção de voltar à UI anterior não é um mecanismo de desfazer alterações do conteúdo do jogo. + +## Temas e i18n desde o primeiro componente + +O código atual já tem ResourceBundle e bindings por locale, bundles inglês e pt_BR e CSS/ThemeService. O problema observado é adoção inconsistente, com textos/estilos locais recentes. O novo deve tratar esses mecanismos como contrato de admissão de componentes, não como limpeza futura. + +Propostas de critérios para o futuro primeiro corte: + +- Paleta de papéis semânticos, estilos de componentes/estados e mecanismo de seleção de tema desde o shell inicial. O bananodore é a direção visual de identidade; a API visual deve permitir outros temas. +- Texto de interface por chaves/bundles, formatação locale-aware e atualização dos textos dinâmicos. Começar com as traduções existentes inglês/pt_BR é uma opção de baixo atrito, ainda sem escolher idioma padrão por inferência. +- Conteúdo do usuário, resposta do agente, código e mensagem original de produtor mantêm autoria/idioma próprios; a localização cobre a apresentação do Studio e não traduz esses conteúdos silenciosamente. +- Validar o mecanismo com pelo menos dois temas e dois locales nos componentes do primeiro corte; isso é proposta de verificação, não solicitação de implementar um editor de temas. +- Verificar chaves faltantes, mensagens de erro/empty/loading, conteúdo longo, foco/teclado e persistência da preferência; separar visual e locale de semântica de execução. + +## Primeiro corte proposto para discussão + +A ordem humana é ambiente de IA → Assets → editores de código/scene → Shipper. A fundação de shell/temas/i18n faz parte do ambiente inicial de IA. O primeiro corte deve demonstrar abrir um projeto real, selecionar/conectar agente e configuração suportada, usar a conversa única, enviar contexto disponível, acompanhar output acima do prompt, executar operações pelos serviços compartilhados e interromper/retomar com estado honesto. + +Isso pode começar com contexto de projeto e referências/capturas que já existam. Seleção rica em Assets e nos futuros editores cresce com suas entregas; não apresentar seleção visual fictícia de um editor ainda ausente nem implementar esses editores como requisito oculto da integração ACP. + +Debug, Tests, diagnostics e evidências podem servir de capacidades do primeiro corte por serviços atuais, sem exigir a reconstrução imediata de todos os seus painéis. Build/pack continuam necessários ao trabalho da IA mesmo com a reformulação visual de Shipper adiada. Da mesma forma, código pode ser alterado pelo agente antes do retorno do editor integrado. + +As fronteiras propostas mantêm o que já funciona e permitem evoluir a UI por conteúdos reais. Permanecem abertas: forma de seleção da UI antiga/nova, política de término de turno/liberação/novos prompts, primeiros agentes e capabilities suportadas, conteúdo mínimo do primeiro resultado visual e detalhes da persistência de conversa versus autoridade. Nada disso autoriza persistir grants, credenciais ou processos no snapshot de layout. + +## Evidência estática adicional desta rodada + +Consultados em Studio `fa37d0d0c7d9f8ea33ea630571ed6117581a1958`: + +- `studio/settings.gradle.kts` — módulos atuais; +- `studio/prometeu-studio-ui-javafx/build.gradle.kts` — dependência visual da API e bibliotecas; +- `studio/prometeu-app/build.gradle.kts` — composição/packaging do app com UI atual; +- `studio/prometeu-app/src/main/java/p/studio/app/StudioUiFactory.java` e `StudioApplicationConfiguration.java` — composição concreta e serviços visuais; +- `studio/prometeu-app/src/main/java/p/studio/app/StudioLauncher.java` — escolha stdio MCP versus JavaFX; +- `studio/prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/utilities/i18n/I18nService.java`, bundles e ThemeService já examinados — base existente de localização/tema; +- `studio/prometeu-architecture-tests/src/test/java/p/studio/architecture/StudioBoundaryArchTest.java` — regras que usam os namespaces atuais e precisam cobrir a nova UI. + +Não houve build, testes ou alterações em código/specs. AIE é o único destino de escrita desta rodada. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0020.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0020.md new file mode 100644 index 0000000..54e7aa6 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0020.md @@ -0,0 +1,24 @@ +--- +schemaVersion: 1 +id: "DSC-0020" +workId: "WRK-0013" +discussionId: "main" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T12:30:18.860490Z" +respondsTo: null +documentVersion: 2 +--- + +# Ajuste de direção — chats por projeto, interrupção contextual e componentes primeiro + +Direção humana explícita desta rodada: + +- Durante execução o projeto permanece focado no trabalho da IA, prompt e resultado. Interromper/retomar o controle também deve parar o agente naquele contexto. +- O vínculo da conversa ao projeto não significa chat único: o Studio pode gerenciar vários chats normalmente, e cada chat pode atuar sobre o projeto inteiro. +- O nome solicitado para o novo módulo é **`prometeu-studio-ui-javafx-2`**. +- O primeiro recorte sugerido passa a ser criar os componentes mais básicos com temas e i18n; depois compor shell e restante. + +Isso corrige a leitura de chat único nos registros DSC-0018/DSC-0019 e o nome provisório `javafx-next`, sem apagar esse histórico. Também insere a fundação visual antes do ambiente funcional de IA. Mantém-se a direção posterior IA → Assets → editores código/scene → Shipper, sujeita à exploração. + +Não houve instrução de encerrar EXPLORATORY, solicitar DEC ou iniciar implementação nesta rodada. Requisitos e nome do módulo estão definidos pelo humano; a proposta de primeiro recorte ainda é discutida abaixo. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0021.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0021.md new file mode 100644 index 0000000..f0a1514 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0021.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0021" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T12:30:19.327251Z" +respondsTo: null +documentVersion: 2 +--- + +Proposta exploratória para o primeiro recorte de prometeu-studio-ui-javafx-2: uma fundação visual pequena, demonstrável em galeria de desenvolvimento, com tipografia/textos, botões e toggles, campos de texto simples/multilinha, seletores, superfícies/painéis e feedback de estado/progresso necessários ao futuro shell/ambiente de IA. Usar CSS e controles JavaFX existentes quando suficientes; componentes próprios somente quando houver responsabilidade útil. Exercitar tema e locale nos estados normal/hover/foco/pressed/disabled/erro/loading, com troca efetiva entre dois temas e dois idiomas e cobertura de textos dinâmicos, conteúdo longo e teclas. Catálogo de componentes amplo, editor de temas, renderizador completo de conversa e cliente ACP ficam fora desse recorte proposto. O shell poderá ser composto sobre essa fundação na etapa seguinte. Trata-se de proposta de escopo, sem implementação, DEC ou Plan. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0022.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0022.md new file mode 100644 index 0000000..63a9ef6 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0022.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0022" +workId: "WRK-0013" +discussionId: "TOP-0007" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T12:30:19.799199Z" +respondsTo: null +documentVersion: 2 +--- + +Síntese após correção humana: gerenciar múltiplos chats pertencentes ao projeto; cada chat pode atuar no projeto como um todo, recebendo contexto selecionado e mantendo escopo explícito de tarefa. Quantidade de chats não decide concorrência de mutações; o Core atual mantém exclusão por projeto/tarefa e qualquer evolução exige discussão própria. Interromper e retomar exige cancelar a execução do agente no contexto correspondente, revogar sua autoridade e aguardar término/cleanup das operações geridas antes de liberar edição. Não basta desbloquear a GUI ou apenas revogar MCP enquanto o turno segue escrevendo. Parar esse contexto não implica encerrar todos os chats/projetos nem matar indiscriminadamente um processo que hospede outras sessões. Fim normal do turno, fila/follow-up e persistência de histórico permanecem questões abertas; nenhuma política foi inferida nesta rodada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0023.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0023.md new file mode 100644 index 0000000..60bf20e --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0023.md @@ -0,0 +1,33 @@ +--- +schemaVersion: 1 +id: "DSC-0023" +workId: "WRK-0013" +discussionId: "TOP-0007" +kind: "NOTE" +author: "Nilton" +createdAt: "2026-11-17T12:33:08.744003Z" +respondsTo: null +documentVersion: 2 +--- + +# Ciclo de prompt — exclusividade durante execução e retorno automático + +Escolhas humanas explícitas desta rodada: + +1. Ao terminar a resposta, o projeto volta automaticamente à edição. +2. Durante a execução da IA não é permitido enviar novo prompt. O Studio fica travado no trabalho em andamento, prompt e resultados. +3. O usuário comparou isso à delegação atual, na qual a IA assume o Studio, agora vinculada à execução de um prompt. + +Essas escolhas resolvem as perguntas sobre retorno normal e novos prompts levantadas em DSC-0019/DSC-0022 e na conversa. Não há fila de prompts, steering por nova mensagem ou execução paralela de prompts nesse contexto. Múltiplos chats continuam permitidos, com atuação sobre o projeto inteiro; a exclusividade de execução do projeto também deve impedir iniciar outro prompt por um chat diferente do mesmo projeto. + +## Síntese operacional proposta + +Edição disponível → envio do prompt/contexto → delegação e bloqueio do projeto → agente executa com output observável → término do prompt e devolução coordenada → edição disponível automaticamente. + +Interromper permanece uma saída explícita: para o agente naquele contexto e suas operações geridas, coordena cleanup/retorno e libera edição quando a parada estiver concluída. Término de uma ferramenta ou de um build intermediário não representa término do prompt. Trocar de chat não contorna exclusividade nem muda o alvo da tarefa em execução. + +A devolução automática deve usar a autoridade/handoff/cleanup existentes. A regra de UX não deve liberar edição apenas porque o stream de texto parou enquanto há escrita/operação ainda ativa. Eventual falha de interrupção/cleanup precisa de estado de recuperação legível, preservando o fato real; isso é requisito técnico para cumprir o comportamento humano, não uma etapa manual obrigatória em cada conclusão normal. + +O travamento é temporal durante a execução do prompt e não transforma toda a conversa em concessão permanente de controle. O histórico do chat permanece após o retorno à edição. + +Este é registro de direção em EXPLORATORY. Sem DEC, Plan, código, novo módulo ou alterações normativas nesta rodada. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0024.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0024.md new file mode 100644 index 0000000..f3034d9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0024.md @@ -0,0 +1,68 @@ +--- +schemaVersion: 1 +id: "DSC-0024" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T12:59:27.194752Z" +respondsTo: null +documentVersion: 2 +--- + +# Recorte do WRK-0013 — fundação de componentes JavaFX 2 + +## Motivo e autoridade de escopo + +O humano sugeriu concentrar este Work no primeiro recorte e abrir outras agendas para features específicas, pois aprofundar todas aqui ficaria pesado. Refinamento operacional dessa sugestão: WRK-0013 passa a focar a fundação visual do novo módulo. A visão e as escolhas acumuladas permanecem como contexto e histórico; nenhum registro anterior é apagado nem convertido em aprovação formal de arquitetura. + +O Work continua EXPLORATORY. Esta redução de escopo não encerra discussão, solicita DEC, aprova implementação, cancela entregas já planejadas ou cria novos Works. Não existem DEC/Plans neste Work. + +## Escopo ativo + +- Fronteira e estrutura mínima de `prometeu-studio-ui-javafx-2`, mantendo o módulo atual disponível para referência e retorno. +- Tokens de aparência e regras visuais necessárias aos componentes iniciais: superfícies, texto, bordas, foco, seleção e estados. +- Temas e i18n desde a entrada de cada componente, incluindo troca efetiva, textos dinâmicos e formatação apropriada. +- Conjunto pequeno de componentes básicos com consumidores previstos no futuro shell/ambiente de IA; preferir JavaFX/CSS quando suficientes. +- Uma galeria de desenvolvimento para demonstrar estados, temas, idiomas, teclado, legibilidade e conteúdo longo; não é workspace do produto. +- Critérios de validação dessa fundação, limites do recorte e preservação da UI existente. + +## Questões a discutir neste recorte + +1. Quais componentes mínimos entram na primeira galeria e quais estados precisam demonstrar? +2. Como organizar tokens, estilos, recursos e bundles sem dependência geral da UI antiga? +3. Quais temas/idiomas iniciais vão provar os mecanismos, e como verificar troca e fallback/chaves ausentes? +4. Como executar a galeria e limitar a composição inicial ao necessário para verificá-la? +5. Quais verificações funcionais/visuais são suficientes para admitir a fundação antes de compor o shell? + +Nenhuma dessas questões exige decidir agora contratos de chats, ACP, editor de código ou scene. Os requisitos conhecidos desses consumidores servem para escolher componentes úteis, sem implementar prematuramente suas features. + +## Contexto de produto preservado + +- Criação visual de jogos, editor como unidade principal, autoria manual/orientação/ajustes/delegação escolhidos por tarefa; IA ajuda a concretizar ideias em PBS e conteúdo executável. +- Chats pertencem ao projeto e podem atuar sobre ele inteiro, com seleção como contexto. Vários chats são permitidos; execução de prompt é exclusiva por projeto, com bloqueio de novos pedidos, parada do agente no contexto quando interrompido e retorno automático à edição ao terminar. +- Prompt abaixo e saída acima; aparência bananodore/Pixel Vision 8 e temas; serviços API/Core/MCP preservados; LSP interno e externo; bancos fundamentais; scene contém o mapa e evolui; entidades ainda não existem. +- Ordem de direção: fundação de componentes → shell/ambiente IA → Assets → editores de código/scene → Shipper. Sem prioridade fina aprovada entre todas as capacidades auxiliares. + +Fontes dessa visão: DSC-0001 (prompt original), DSC-0008/0010/0012/0014/0016/0018/0020/0023 (direção e correções humanas). Sínteses de análise: DSC-0002/0009/0011/0013/0015/0017/0019/0021/0022, lidas à luz das correções posteriores. ART-0001–0003 preservam a inspeção inicial, runtime e port Zelda. + +## Destinos futuros — pendentes de criação + +| Feature | Discussão futura correspondente | +| --- | --- | +| Shell e host de conteúdos | Navegação, seleção, regiões, foco e restauração de layout | +| Ambiente de IA/ACP | Chats, agente/modelo, contexto, output, autoridade, interrupção e lifecycle | +| Assets | Autoria/inspeção de bancos, dependências, publicação, budget e reatividade | +| Editor de código/LSP | Documentos, buffers, edição, assistência e coexistência com clientes externos | +| Scenes | Gestão, evolução da composição e editor; entidades em discussão própria quando priorizadas | +| Execução, Debug, Tests e evidências | Integração visual e operacional das capacidades existentes, separadas conforme escopo útil | +| Shipper | Experiência final de preparação/distribuição e contratos a preservar | +| Pixels e áudio/sequenciador | Recortes próprios futuros quando priorizados | + +Nenhum ID de Work novo foi criado ou inventado. Abrir os próximos Works conforme prioridade, levando links para este contexto e requisitos realmente pertinentes. Orientação/encerramento/aceite de um Work não se herdam automaticamente pelos demais. Esta lista retém o destino das questões ampliadas, sem exigir detalhar todas para concluir a fundação. + +## Tratamento dos tópicos e perguntas anteriores + +TOP-0004 e a fronteira mínima de TOP-0006 permanecem ativos. Auditoria inicial de TOP-0001 é evidência já produzida. TOP-0002/0003/0005/0007 e a migração ampla de TOP-0006 ficam como contexto para os destinos futuros acima. + +DSC-0004 (autoridade/atualização), DSC-0006 (futuros editores) e DSC-0007 (migração ampla) recebem respostas de disposição de escopo: ficam adiadas para seus destinos, sem fingir solução técnica. DSC-0005, relativa à fundação visual, continua pertinente; os detalhes de DPI/plataformas e aceitação visual precisam ser proporcionais aos componentes deste recorte. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0025.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0025.md new file mode 100644 index 0000000..686924b --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0025.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0025" +workId: "WRK-0013" +discussionId: "TOP-0003" +kind: "RESPONSE" +author: "codex" +createdAt: "2026-11-17T12:59:31.702611Z" +respondsTo: "DSC-0004" +documentVersion: 2 +--- + +Disposição de escopo conforme DSC-0024: autoridade, UI durante execução e invalidação após MCP ficam para o futuro Work de ambiente IA/ACP e para a integração de Assets. Direções humanas já registradas em DSC-0020/0023 permanecem contexto; mecanismos de reatividade não estão resolvidos. Esses detalhes não integram o aceite atual da fundação de componentes. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0026.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0026.md new file mode 100644 index 0000000..dedff0c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0026.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0026" +workId: "WRK-0013" +discussionId: "TOP-0005" +kind: "RESPONSE" +author: "codex" +createdAt: "2026-11-17T12:59:32.243660Z" +respondsTo: "DSC-0006" +documentVersion: 2 +--- + +Disposição de escopo conforme DSC-0024: contratos específicos de documentos/LSP, scene e entidades serão aprofundados em Works próprios quando priorizados. A primeira análise e as evidências ficam preservadas. A fundação visual atual considera apenas necessidades conhecidas de seus consumidores, sem escolher ou implementar os futuros editores. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0027.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0027.md new file mode 100644 index 0000000..1c3b596 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0027.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0027" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "RESPONSE" +author: "codex" +createdAt: "2026-11-17T12:59:32.771292Z" +respondsTo: "DSC-0007" +documentVersion: 2 +--- + +Disposição de escopo conforme DSC-0024: este Work trata somente da fundação de prometeu-studio-ui-javafx-2, componentes/temas/i18n/galeria e preservação da UI anterior. Migração funcional de shell, cancelamento de build ao navegar, terminal e demais features são destinos posteriores, sem resolução técnica por inferência. A prioridade geral e o nome do módulo já estão registrados nas escolhas humanas. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0028.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0028.md new file mode 100644 index 0000000..d78fff5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0028.md @@ -0,0 +1,31 @@ +--- +schemaVersion: 1 +id: "DSC-0028" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T13:37:46.870225Z" +respondsTo: null +documentVersion: 2 +--- + +# Ajuste do primeiro recorte — componentes básicos e shell mínimo + +Instrução humana nesta rodada: iniciar o primeiro recorte com componentes básicos e um shell mínimo somente, sem nenhum editor, acrescentando capacidades progressivamente. + +Isso atualiza DSC-0024: o shell mínimo entra no escopo ativo; a composição completa do shell e suas features continuam destinadas a Works posteriores. A galeria deixa de ser uma entrega obrigatória anterior ao shell: a fundação pode ser verificada no shell e por demonstrações técnicas auxiliares proporcionais ao que precisar ser inspecionado. + +## Recorte atual para discutir + +- Novo módulo `prometeu-studio-ui-javafx-2`, preservando a UI existente. +- Componentes básicos em conjunto pequeno, usando controles JavaFX/CSS quando suficientes. +- Tokens, temas e i18n desde a primeira composição. +- Shell mínimo executável, com janela principal e composição visual básica. Proposta de conteúdo inicial: identificação do Studio, seleção de tema/idioma e área central vazia. Não preencher com comandos fictícios ou regiões de features sem função. +- Verificações proporcionais de tema/locale, foco/teclado, estados, resize e lifecycle da janela. + +O shell deve crescer a partir de consumidores reais. Não exige nesta entrega host completo de documentos, gestão de projetos, docking, conversa ACP, execução de agentes, Assets, Debug/Tests, editores ou Shipper. O módulo mínimo não precisa abrir um jogo ou iniciar serviços de agente para demonstrar sua fundação visual. Não transformar a primeira entrega em um catálogo geral de controles JavaFX. + +O nome do módulo, preservação da UI atual, temas/i18n e escopo de componentes + shell mínimo vêm da direção humana. Os detalhes do conteúdo inicial e da execução/verificação acima são propostas para a discussão, ainda sem decisão formal. + +Mantêm-se EXPLORATORY e aprovação humana de DEC. O pedido não encerrou a exploração nem solicitou DEC/Plan. Nenhuma alteração de código/specs ou criação de módulo foi executada nesta rodada. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0029.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0029.md new file mode 100644 index 0000000..84f2cb3 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0029.md @@ -0,0 +1,31 @@ +--- +schemaVersion: 1 +id: "DSC-0029" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T14:01:46.492093Z" +respondsTo: null +documentVersion: 2 +--- + +# Fronteira esclarecida — backend mantido e frontend completamente reescrito + +Esclarecimento humano: a intenção é reescrever completamente a UI e seus conceitos com base no novo modelo de componentes. O backend permanece. A expressão anterior “preservando a UI atual” não deve ser interpretada como preservar sua arquitetura ou reaproveitar sua implementação no novo frontend. + +O pedido anterior de manter a UI antiga como consulta/backup continua sendo uma estratégia de transição: o módulo antigo permanece separado como referência histórica e funcional. Isso não impõe seus layouts, controles, workspaces, CSS, navegação ou composição ao novo módulo. + +Confirmação humana subsequente nesta mesma rodada: “deixe o modulo antigo lah, use para consulta quando necessario, mas nada como fonte de inspiracao”. A consulta deve servir a compreender funcionalidades, contratos, capacidades e integrações existentes. Não usar a UI antiga como inspiração visual, conceitual ou arquitetural para a nova implementação. + +Direção para `prometeu-studio-ui-javafx-2`: + +- Nova implementação dos componentes Studio, temas/i18n e shell, com modelo próprio de composição. +- Sem dependência da UI antiga nem cópia/inspiração de seus controles, shell, estilos ou estrutura como base do novo frontend. +- JavaFX continua sendo a tecnologia escolhida; usar seus controles nativos/CSS quando adequado é compatível com reescrever os componentes do Studio. +- API/Core, serviços de projeto, autoria, build/runtime, MCP e demais capacidades de backend existentes permanecem os contratos de integração; não duplicar lógica de negócio na UI nova. +- O primeiro recorte permanece componentes básicos e shell mínimo, com temas e i18n desde o início, sem editores ou features de domínio. + +Esse esclarecimento substitui formulações anteriores que sugeriam adaptação incremental dos componentes antigos, e qualifica a restrição inicial de não presumir descarte da arquitetura: ela continua pertinente ao backend; o humano agora determinou explicitamente a reescrita integral do frontend. + +Não houve instrução de encerrar EXPLORATORY ou solicitar DEC/Plan. Este registro corrige o escopo documental; nenhum código foi modificado e o novo módulo ainda não foi criado. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0030.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0030.md new file mode 100644 index 0000000..45b545d --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0030.md @@ -0,0 +1,57 @@ +--- +schemaVersion: 1 +id: "DSC-0030" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "codex" +createdAt: "2026-11-17T14:06:26.191170Z" +respondsTo: null +documentVersion: 2 +--- + +# Qualidade da nova UI e encapsulamento de bibliotecas + +Direção humana desta rodada: + +- O frontend deve buscar o melhor acabamento e os melhores padrões aplicáveis, sem economizar em qualidade. +- Bibliotecas adicionais estão autorizadas para melhorar aparência e funcionamento, sempre encapsuladas em componentes próprios. + +Este registro refina a fundação de `prometeu-studio-ui-javafx-2`. O recorte continua pequeno: componentes básicos e shell mínimo, sem editores, ACP ou features de domínio. EXPLORATORY permanece aberto; nenhuma biblioteca foi escolhida/instalada, nenhum módulo/código foi criado e não há DEC/Plan. + +## Qualidade como critério verificável + +1. **Identidade visual deliberada.** Direção bananodore/Pixel Vision 8 com hierarquia, paleta e geometria coerentes, ícones próprios e tipografia legível. Criar a identidade a partir da visão atual, sem copiar ou buscar inspiração na UI antiga. Comparar estados renderizados antes de consolidar valores finais. +2. **Design system por papéis.** Tokens semânticos de superfícies/texto/borda/foco/seleção/feedback, mais escala consistente de espaçamento, tamanhos, tipografia e iconografia. Tema e estado têm responsabilidade explícita; evitar cores/medidas de aparência dispersas nas views. Cores do conteúdo de jogo não são tokens do tema da UI. +3. **Contratos pequenos de componente.** Propriedades, eventos, estados, defaults e responsabilidade documentados com exemplos concretos. Composição para estruturas simples; Control/Skin quando a separação de aparência/comportamento trouxer valor. Estado explícito e alterações previsíveis, sem impor MVVM/MVI ou um framework reativo a todo controle por nomenclatura. +4. **Comportamento desktop consistente.** Foco visível e ordem de teclado, ativação/seleção e edição previsíveis, atalhos adequados, clipboard e composição de texto/IME nos campos usados. Estados normal, hover, foco, pressed, selected, disabled, error e loading somente onde fizerem sentido ao componente. +5. **Acessibilidade na fundação.** Semântica/nomes acessíveis, foco identificável, ações utilizáveis por teclado e informação além de cor. Usar contraste de texto 4.5:1, texto grande 3:1 e indicadores necessários de controles/estados 3:1 como referências de projeto adaptadas ao desktop. Não alegar certificação WCAG do produto por aplicar esses números; validação assistiva precisa ser real e proporcional ao ambiente suportado. +6. **Temas completos.** Troca efetiva nos componentes e estados e nos popups/dialogs que existirem. CSS e recursos com namespaces próprios, sem colisão com o módulo antigo. O tema bananodore precisa ser legível e extensível para outros temas; não duplicar implementações de componentes por tema. +7. **i18n integral da interface.** Chaves, mensagens parametrizadas e formatação por locale, atualização de textos dinâmicos, diagnóstico de chaves ausentes e teste com conteúdo longo. Texto do usuário/agente/código preserva autoria e idioma. Provar os mecanismos em pelo menos dois temas e idiomas é proposta de verificação, não escolha automática dos valores visuais finais ou de idioma padrão. +8. **Redimensionamento e escala.** Layouts que respeitam mínimos, expansão, truncamento deliberado e texto longo. Tratar escala de controles/tipografia separadamente da grade de pixel art; avaliar DPI e escala fracionária sem prometer nitidez raster perfeita em qualquer fator. Não escalar a Scene inteira como substituto de layout responsivo. +9. **Responsividade e lifecycle.** Sem IO/trabalho bloqueante na FX thread. Listeners/bindings/timers/recursos têm ownership e teardown claros. Medir comportamento de resize, troca de tema/locale e reabertura; evitar tempestades de layout/estilo e efeitos custosos sem benefício observado. Definir budgets mensuráveis no ambiente real quando a fundação executável existir, sem inventar resultados de performance agora. +10. **Verificação do comportamento próprio e QA visual.** Testes devem cobrir contratos próprios, troca de tema/locale, chaves, lifecycle e regressões relevantes; não replicar testes do JavaFX ou da biblioteca. Inspeção real dos estados renderizados, com capturas por ambiente definido, resize, teclado, idiomas e escalas escolhidos. Compilar não comprova qualidade visual. O shell mínimo e demonstrações auxiliares suficientes servem essa verificação, mantendo galeria separada opcional. + +O compromisso é entregar poucos componentes bem resolvidos e um shell mínimo acabado. Qualidade não autoriza ampliar o catálogo, implementar docking ou construir infraestrutura genérica sem consumidor. + +## Bibliotecas e componentes próprios + +Bibliotecas de terceiros podem ser usadas quando trouxerem ganho concreto para uma necessidade do recorte. O consumidor da UI deve falar com componentes Studio, com API própria pequena e coerente, sem importar classes/propriedades/eventos específicos da biblioteca para as views. + +O componente/adapter Studio é dono da integração: traduz configuração e eventos, controla estilos e recursos, conecta temas/i18n, fornece semântica acessível e administra lifecycle. Tipos de terceiros ficam restritos à implementação interna dessa integração. Não reexportar o catálogo inteiro da dependência nem criar wrappers mecânicos sem um consumidor. Controles nativos JavaFX podem ser usados internamente para manter seu comportamento esperado. + +Antes de escolher uma dependência, comparar benefício demonstrável com JavaFX/CSS/composição e verificar compatibilidade com Java/JavaFX, empacotamento, temas, i18n, teclado/acessibilidade e custo de render. Avaliar a biblioteca no contexto do componente, inclusive seus popups e estados, em vez de aceitar a aparência padrão como identidade do Studio. A autorização é para usar bibliotecas adequadas; não é uma escolha prévia de qualquer stack ou conjunto de dependências. + +Esse encapsulamento protege o restante da UI contra a substituição futura da biblioteca. As dependências concretas não entram na Studio API/Core nem determinam os contratos de domínio. + +## Referências primárias consultadas + +Consulta online desta rodada, como apoio técnico às propostas e não aprovação de design: + +- [Control / skins — JavaFX 23](https://openjfx.io/javadoc/23/javafx.controls/javafx/scene/control/Control.html): comportamento, semântica e skinning de controles. O projeto atual usa JavaFX 23.0.2. +- [CSS Reference — JavaFX 23](https://openjfx.io/javadoc/23/javafx.graphics/javafx/scene/doc-files/cssref.html): estilos, lookup de cores e estados; não presumir equivalência com CSS de navegador. +- [W3C — contraste de texto](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html). +- [W3C — contraste de componentes/estados](https://www.w3.org/WAI/WCAG22/Understanding/non-text-contrast.html). +- [W3C — foco visível](https://www.w3.org/WAI/WCAG22/Understanding/focus-visible). + +WCAG é usada aqui como referência técnica de legibilidade/foco; os critérios web não substituem avaliação real de acessibilidade da aplicação JavaFX. diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0031.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0031.md new file mode 100644 index 0000000..216f884 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0031.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0031" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "RESPONSE" +author: "Nilton" +createdAt: "2026-11-17T14:20:47.587486Z" +respondsTo: "DSC-0005" +documentVersion: 2 +--- + +Aceite humano explícito nesta conversa: sim para todas as propostas da síntese anterior. Aceitos: preparar amostra visual de paleta/tipografia/bordas/ícones/estados; tema bananodore escuro e alternativa clara; idiomas pt-BR e inglês; decoração nativa da janela com identidade própria no interior, centro vazio e seletores tema/idioma; validação inicial no macOS disponível com resize e HiDPI, cobertura Windows/Linux a definir; lista inicial de textos/títulos, ícones, botões/toggles, campos, seletores, painéis e feedback básico. Aceita a preparação da proposta visual como próximo passo. Não houve pedido explícito de encerrar EXPLORATORY, emitir DEC ou implementar a UI. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0032.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0032.md new file mode 100644 index 0000000..8a333c1 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0032.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0032" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T14:43:17.110868Z" +respondsTo: null +documentVersion: 2 +--- + +Após o aceite humano DSC-0031, foi preparada a amostra visual exploratória ART-0004: shell vazio com decoração macOS representada, seletores de tema/idioma e catálogo separado de componentes. Prévia interativa em artifacts/visuals/prometeu-ui-foundation.html. Paleta escura ameixa/creme/amarelo e clara marfim; títulos pixel e texto regular são propostas para revisão, sem aprovação final de fontes/tokens. Verificados estaticamente estrutura do fragmento, IDs únicos, referências por ID e sintaxe JavaScript; contrastes calculados entre tokens selecionados, sem equivaler a auditoria de acessibilidade ou QA visual. Não houve inspeção de renderização em navegador/JavaFX. Geração de imagem não retornou após espera prolongada e a chamada foi encerrada; nenhuma imagem foi produzida. Nenhum módulo ou código da aplicação foi implementado. EXPLORATORY continua aberto; próximo passo é revisar a direção visual. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0033.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0033.md new file mode 100644 index 0000000..d1a5384 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0033.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0033" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T14:54:32.606486Z" +respondsTo: null +documentVersion: 2 +--- + +Nilton pediu explorar aparência mais pixelada, sobretudo bordas, sem reduzir resolução. Preparada alternativa ART-0005 em artifacts/visuals/prometeu-ui-pixel.html e versão para navegador prometeu-ui-pixel-browser.html. Molduras com cantos em degraus de 4px e relevo em camadas para painéis, botões e campos; texto mantém resolução normal e janela mantém decoração nativa representada. Seletor de estudo compara tratamento pixel e anterior, separado do shell do produto. Estrutura, IDs/seletores e sintaxe JavaScript verificados estaticamente; renderização não inspecionada. Estudos anteriores preservados. Ainda é hipótese visual, não aceite final nem implementação ou solicitação de DEC. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0034.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0034.md new file mode 100644 index 0000000..4bc6b49 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0034.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0034" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T15:06:25.096288Z" +respondsTo: null +documentVersion: 2 +--- + +Feedback humano: Nilton gostou das bordas em degraus e relevo e pediu fonte mais monoespaçada/pixelada. Preparado estudo ART-0006 com Departure Mono 1.500 em textos, controles e títulos; decoração nativa da janela mantém fonte da plataforma. Seletor de tipografia compara com o estudo anterior. Arquivos artifacts/visuals/prometeu-ui-mono.html e prometeu-ui-mono-browser.html; fonte incorporada e licença SIL OFL preservada em departure-mono-LICENSE.txt. Fonte obtida do commit 75152a3f1e6dacdd248a6c397c97dbf27e33eea0 do repositório oficial rektdeckard/departure-mono; referência https://github.com/rektdeckard/departure-mono/releases/tag/v1.500 . Verificação binária do cmap confirmou letras acentuadas portuguesas; todas as larguras de avanço são 350 unidades. Estrutura/IDs/seletores e sintaxe JS validados estaticamente; sem inspeção visual de renderização ou garantia de legibilidade. Preferência por bordas registrada; nova fonte permanece proposta para revisão. Sem implementação JavaFX ou encerramento de EXPLORATORY. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0035.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0035.md new file mode 100644 index 0000000..088d336 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0035.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0035" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T15:14:29.064766Z" +respondsTo: null +documentVersion: 2 +--- + +Pedido humano explícito: incluir Departure Mono e Roboto Mono, adicionar as licenças e amostras de texto para ambas. Atualizado estudo ART-0007 no mesmo prometeu-ui-mono.html/browser.html: seletor permite aplicar qualquer das duas à UI e seção separada compara o mesmo texto editável em ambas a 16,5 px, com acentos, dígitos e pontuação. Ambas incorporadas; licenças completas acessíveis na prévia e preservadas em departure-mono-LICENSE.txt e roboto-mono-LICENSE.txt. Roboto Mono Regular obtida do commit oficial googlefonts/RobotoMono 7bf0b33178844cc7d0c9915b746ece1be7f46bea, OTF sha256 874671c3f088802a915e3f7b1b773d3d031e04a21d82e2eb5107aa1c51895c21. Removida importação de fontes externas do estudo atual. Cmap das duas confirmou acentos portugueses e símbolos das amostras; verificados estrutura, IDs, referências e sintaxe JavaScript. Sem inspeção de renderização ou implementação JavaFX. A presença de ambas não define a distribuição final por contexto; EXPLORATORY permanece aberto. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0036.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0036.md new file mode 100644 index 0000000..f2abd2e --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0036.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0036" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "RESPONSE" +author: "Nilton" +createdAt: "2026-11-17T16:26:46.283449Z" +respondsTo: "DSC-0035" +documentVersion: 2 +--- + +eu vou arriscar com a departure, acho que ficaremos bem, qq coisa ofertamos a possibilidade de configurar outras fontes \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0037.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0037.md new file mode 100644 index 0000000..8cf3c32 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0037.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0037" +workId: "WRK-0013" +discussionId: "TOP-0004" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T16:26:46.834538Z" +respondsTo: null +documentVersion: 2 +--- + +Síntese da escolha humana DSC-0036: adotar Departure Mono como fonte padrão da nova UI. Manter famílias/tamanhos em recursos/tokens de tipografia, evitando fonte fixa dentro dos componentes e permitindo configuração de outras fontes. Roboto Mono e ambas as licenças permanecem no estudo comparativo. A escolha não define agora um gerenciador completo de fontes nem comprova ergonomia no JavaFX; legibilidade, acentos, escalas e HiDPI precisam ser avaliados na implementação futura. EXPLORATORY permanece aberto, sem solicitação de DEC ou autorização de implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0038.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0038.md new file mode 100644 index 0000000..90db909 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0038.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0038" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "CONCLUSION" +author: "Codex" +createdAt: "2026-11-17T16:37:41.445441Z" +respondsTo: null +documentVersion: 2 +--- + +A pedido explícito de Nilton, registrado em guidance.decisionRequests, foi emitida DEC-0001 para revisão do primeiro recorte. Consolida módulo JavaFX 2 independente, componentes básicos, shell vazio, temas/i18n, bordas em degraus/relevo, Departure padrão, Roboto alternativa e fontes configuráveis/licenciadas, encapsulamento de bibliotecas e QA real no macOS. Critérios, limites, alternativas e riscos constam do documento. Defaults operacionais de tema/locale e preferências são explícitos na proposta para revisão. AprovaçãoStatus permanece DRAFT, sem aprovação humana do conteúdo, Plan ou implementação; política de acesso de Studio/runtime não foi alterada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0039.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0039.md new file mode 100644 index 0000000..b6e178f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0039.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0039" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T16:40:48.472Z" +respondsTo: null +documentVersion: 2 +--- + +Nilton aprovou explicitamente DEC-0001 e autorizou gerar o plano e implementar o primeiro recorte. Aceite registrado pela CLI; cadastro Studio atualizado para edição por essa autorização, runtime permanece somente leitura. Sem autorização de commits. Planejamento e execução limitados ao módulo novo, integração mínima de build/specs e validações da fundação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0040.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0040.md new file mode 100644 index 0000000..7d1977d --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0040.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0040" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "NOTE" +author: "Codex" +createdAt: "2026-11-17T16:42:24.745113Z" +respondsTo: null +documentVersion: 2 +--- + +A CLI repo add recusou atualizar cadastro já existente. Após a autorização explícita de implementação por Nilton, editado o arquivo portátil ai-engineering.yaml somente para habilitar edição de Studio; runtime continua read-only. Isso corrige o registro anterior que antecipava o resultado do comando. PLN-0001 contém cinco etapas em inglês e validação proporcional ao recorte aceito. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0041.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0041.md new file mode 100644 index 0000000..bb43d3b --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/discussions/DSC-0041.md @@ -0,0 +1,13 @@ +--- +schemaVersion: 1 +id: "DSC-0041" +workId: "WRK-0013" +discussionId: "TOP-0006" +kind: "CONCLUSION" +author: "Codex" +createdAt: "2026-11-17T17:44:35.066496Z" +respondsTo: null +documentVersion: 2 +--- + +DEC-0001 aceita por Nilton, PLN-0001 executado e fundação JavaFX 2 entregue. Módulo independente, shell vazio/galeria separada, componentes próprios, temas/i18n, Departure padrão e Roboto alternativa com licenças, preferências e tipografia configuráveis. Gate final: 8 testes unitários + 1 cenário desktop real, distribuição, compile da UI antiga e lançamento real bem-sucedidos. Capturas macOS 27.2/outputScale 2× inspecionadas, correções de overflow/contraste/popup aplicadas; média final CSS/layout 19,21 ms em 20 trocas. ART-0011/0012 preservam resultados, fontes e limites. Windows/Linux, walkthrough assistivo e composição IME nativa permanecem não exercitados, sem certificação inferida. Backend/runtime e implementação da UI anterior intactos; nenhum commit criado. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0001.md new file mode 100644 index 0000000..5d6d13a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0001.md @@ -0,0 +1,20 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: [] +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T16:40:49.383921Z" +updatedBy: "Codex" +changeReason: "Plan created" +documentVersion: 2 +--- + +Implement the accepted standalone JavaFX frontend foundation in Studio, preserve the existing frontend/backend, and qualify themes, locales, typography, component contracts and desktop behavior. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0002.md new file mode 100644 index 0000000..1740658 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0002.md @@ -0,0 +1,29 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: [] +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 2 +previousHash: "2991d06c629dcaad6eb9de949fcddc8bfd771dcc2e4304bcf6ad52b34b1763a9" +updatedAt: "2026-11-17T16:41:52.114959Z" +updatedBy: "Codex" +changeReason: "Expand the accepted decision into a standalone execution and verification\ + \ contract." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0003.md new file mode 100644 index 0000000..3497b11 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0003.md @@ -0,0 +1,44 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:41:55.613403Z" +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 3 +previousHash: "00f0e4b4e238c0c5d6db5b2b26e4e4dcff7e26eb71aabd3d06061ae159aa7b96" +updatedAt: "2026-11-17T16:41:55.613446Z" +updatedBy: "Codex" +changeReason: "Accepted DEC-0001 implementation authorized by Nilton." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0004.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0004.md new file mode 100644 index 0000000..2b758b5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0004.md @@ -0,0 +1,61 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:41:55.613403Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 4 +previousHash: "29e644a586740d8c29724cd67ab74c9c9671dbfa03e2fca41549687418d2e393" +updatedAt: "2026-11-17T16:42:02.667595Z" +updatedBy: "Codex" +changeReason: "Accepted DEC-0001 implementation authorized by Nilton." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0005.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0005.md new file mode 100644 index 0000000..c8f597f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0005.md @@ -0,0 +1,78 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:41:55.613403Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 5 +previousHash: "231b499b6cf02bcd4eaa0f44567081f860e6aca0e9fe9d6384c10808984851d4" +updatedAt: "2026-11-17T16:42:06.627995Z" +updatedBy: "Codex" +changeReason: "Accepted DEC-0001 implementation authorized by Nilton." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0006.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0006.md new file mode 100644 index 0000000..ffff89b --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0006.md @@ -0,0 +1,96 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:41:55.613403Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 6 +previousHash: "da706a92b225121c2f8fdada6a528c5ea0fde3126d24bbc0fa96942b09715bbb" +updatedAt: "2026-11-17T16:42:16.974757Z" +updatedBy: "Codex" +changeReason: "Accepted DEC-0001 implementation authorized by Nilton." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0007.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0007.md new file mode 100644 index 0000000..5fa9dcc --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0007.md @@ -0,0 +1,112 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:41:55.613403Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "OPEN" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 7 +previousHash: "629a5b2af6f43947dcc48beee2582f0a07beac2a1b8d42627fcef2ae20eead39" +updatedAt: "2026-11-17T16:42:21.108273Z" +updatedBy: "Codex" +changeReason: "Accepted DEC-0001 implementation authorized by Nilton." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0008.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0008.md new file mode 100644 index 0000000..1eb3414 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0008.md @@ -0,0 +1,112 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "ACTIVE" + result: "Start the authorized implementation of the independent foundation module." + evidence: [] + updatedAt: "2026-11-17T16:42:28.970753Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 8 +previousHash: "f23975b01c083b42ec2b4b79d351e5a1fb5e2fd6eb562f66f8e51bbb7845a75e" +updatedAt: "2026-11-17T16:42:28.970823Z" +updatedBy: "Codex" +changeReason: "Start the authorized implementation of the independent foundation module." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0009.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0009.md new file mode 100644 index 0000000..744899c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0009.md @@ -0,0 +1,115 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:02.667549Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 9 +previousHash: "5c518bb7ee4f0d02b8d7c87bfcfdbdcad07a9af9f27480207a2bab601a4c1d56" +updatedAt: "2026-11-17T16:53:37.655431Z" +updatedBy: "Codex" +changeReason: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0010.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0010.md new file mode 100644 index 0000000..1bb2405 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0010.md @@ -0,0 +1,116 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "ACTIVE" + result: "Component implementation compiled; now qualifying actual JavaFX appearance\ + \ and native behavior." + evidence: [] + updatedAt: "2026-11-17T16:53:45.199398Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 10 +previousHash: "8f1133e088554f0a7a37e27afe1e0468c3f64b24417438aa2db3d1b52181e54c" +updatedAt: "2026-11-17T16:53:45.199507Z" +updatedBy: "Codex" +changeReason: "Component implementation compiled; now qualifying actual JavaFX appearance\ + \ and native behavior." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0011.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0011.md new file mode 100644 index 0000000..3c09f23 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0011.md @@ -0,0 +1,119 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:06.627947Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 11 +previousHash: "d7629ccd71f424653e9a64980100dc5e039b773e35a8a64fc3ac7ffc1dfcd9db" +updatedAt: "2026-11-17T17:05:34.334591Z" +updatedBy: "Codex" +changeReason: "All initial component families implemented with owned presentation\ + \ state, scalable stepped geometry, theme/font/locale propagation and real desktop\ + \ qualification; final regression gate remains in TSK-0004." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0012.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0012.md new file mode 100644 index 0000000..fe722eb --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0012.md @@ -0,0 +1,118 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "ACTIVE" + result: "Qualify the composed shell and separate gallery against the accepted scope." + evidence: [] + updatedAt: "2026-11-17T17:05:39.310788Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 12 +previousHash: "f7c9d617a863e4f49b4d192b6dc24de4b316b0c23db64c378516c69ebe6fe1a2" +updatedAt: "2026-11-17T17:05:39.310871Z" +updatedBy: "Codex" +changeReason: "Qualify the composed shell and separate gallery against the accepted\ + \ scope." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0013.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0013.md new file mode 100644 index 0000000..1d615df --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0013.md @@ -0,0 +1,122 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:16.974535Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 13 +previousHash: "39fe8d60aed8440391c96d2b2572ca6dd2aa58a41e6785ed3a2ec2e9979b6d82" +updatedAt: "2026-11-17T17:41:25.511329Z" +updatedBy: "Codex" +changeReason: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0014.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0014.md new file mode 100644 index 0000000..8c7ac37 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0014.md @@ -0,0 +1,122 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "ACTIVE" + result: "Consolidate final real desktop captures, test XML, environment, contrast\ + \ and performance evidence." + evidence: [] + updatedAt: "2026-11-17T17:41:35.723408Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 14 +previousHash: "907dc434c60d29870561bbbb07c4401a2a3fbc7bcd779ec44843c92c3726e1b4" +updatedAt: "2026-11-17T17:41:35.723476Z" +updatedBy: "Codex" +changeReason: "Consolidate final real desktop captures, test XML, environment, contrast\ + \ and performance evidence." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0015.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0015.md new file mode 100644 index 0000000..94c9a79 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0015.md @@ -0,0 +1,127 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "Eight unit tests and real desktop scenario passed, standalone run succeeded,\ + \ captures inspected and corrected, timing/contrast verified; environment and\ + \ manual qualification limits documented." + evidence: + - "ART-0010" + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:43:46.855431Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "OPEN" + result: "" + evidence: [] + updatedAt: "2026-11-17T16:42:21.108215Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 15 +previousHash: "110480f1e436387f425f24a740f04e638cace835757554d14f16509747aabc58" +updatedAt: "2026-11-17T17:43:46.855503Z" +updatedBy: "Codex" +changeReason: "Eight unit tests and real desktop scenario passed, standalone run succeeded,\ + \ captures inspected and corrected, timing/contrast verified; environment and manual\ + \ qualification limits documented." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0016.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0016.md new file mode 100644 index 0000000..c7ef54a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0016.md @@ -0,0 +1,125 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "Eight unit tests and real desktop scenario passed, standalone run succeeded,\ + \ captures inspected and corrected, timing/contrast verified; environment and\ + \ manual qualification limits documented." + evidence: + - "ART-0010" + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:43:46.855431Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "ACTIVE" + result: "Finish durable documentation, scope review and AIE evidence validation." + evidence: [] + updatedAt: "2026-11-17T17:43:52.710228Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 16 +previousHash: "d216b07ba9010e5d0284425ef7e1c9451f11db0040be1d6475bb06f155268c28" +updatedAt: "2026-11-17T17:43:52.710353Z" +updatedBy: "Codex" +changeReason: "Finish durable documentation, scope review and AIE evidence validation." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0017.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0017.md new file mode 100644 index 0000000..b8060e8 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/.history/PLN-0001/r0017.md @@ -0,0 +1,131 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "Eight unit tests and real desktop scenario passed, standalone run succeeded,\ + \ captures inspected and corrected, timing/contrast verified; environment and\ + \ manual qualification limits documented." + evidence: + - "ART-0010" + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:43:46.855431Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "COMPLETED" + result: "English module guide and canonical JavaFX 2 spec/index integrated; final\ + \ source manifest matches, build/test/visual evidence preserved and AIE/diff validation\ + \ passes. Runtime and old frontend implementation unchanged; no commits." + evidence: + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:44:43.010012Z" +status: "ACTIVE" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 17 +previousHash: "335b79441b4a2777586a686726f3a211396833a21a594741d1b13f13a12865d3" +updatedAt: "2026-11-17T17:44:43.010129Z" +updatedBy: "Codex" +changeReason: "English module guide and canonical JavaFX 2 spec/index integrated;\ + \ final source manifest matches, build/test/visual evidence preserved and AIE/diff\ + \ validation passes. Runtime and old frontend implementation unchanged; no commits." +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/PLN-0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/PLN-0001.md new file mode 100644 index 0000000..90da8f9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/plans/PLN-0001.md @@ -0,0 +1,129 @@ +--- +schemaVersion: 1 +id: "PLN-0001" +workId: "WRK-0013" +title: "Implement JavaFX 2 foundations and minimal shell" +decisions: +- "DEC-0001" +steps: +- id: "TSK-0001" + title: "Register the independent module and presentation resources" + description: "Add settings.gradle.kts inclusion and a Java 21/JavaFX 23.0.2 application\ + \ module with no project dependencies. Bundle local Departure/Roboto fonts and\ + \ full SIL OFL notices. Create appearance enums/settings, tolerant user preference\ + \ storage with background persistence, reactive locale/messages with English fallback\ + \ and missing-key diagnostics. Preserve existing launch and backend." + acceptanceCriteria: + - "New module compiles independently; resources and licenses are local." + - "Unit tests cover defaults, invalid preferences, bundle parity, formatting/fallback\ + \ and preference round-trip." + dependsOn: [] + status: "COMPLETED" + result: "Independent module compiles; font/license resources bundled; preferences,\ + \ locale fallback/parity and persistence tests pass; legacy UI still compiles." + evidence: + - "ART-0008" + updatedAt: "2026-11-17T16:53:37.655365Z" +- id: "TSK-0002" + title: "Implement Studio components and theme system" + description: "Implement p.studio.ui.javafx2.components plus appearance context/CSS.\ + \ Cover text/title/icon/button/toggle/text field/select/panel/feedback, native\ + \ semantics, scalable stepped/beveled surfaces, dark/light semantic colors, runtime\ + \ font/scale and explicit disposal. Keep themes consistent in selector popups;\ + \ no third-party API leakage." + acceptanceCriteria: + - "All component families expose documented small APIs and applicable states." + - "Both themes, languages and fonts propagate without reconstructing controls or\ + \ losing values." + dependsOn: + - "TSK-0001" + status: "COMPLETED" + result: "All initial component families implemented with owned presentation state,\ + \ scalable stepped geometry, theme/font/locale propagation and real desktop qualification;\ + \ final regression gate remains in TSK-0004." + evidence: + - "ART-0009" + updatedAt: "2026-11-17T17:05:34.334523Z" +- id: "TSK-0003" + title: "Compose the minimal shell and separate gallery" + description: "Add independent launcher/application, native-decorated minimum 680x480\ + \ shell with identity, theme/locale selectors and empty center. Add a separate\ + \ gallery launch for states, font/scale configuration, comparable text, validation/progress\ + \ and keyboard/clipboard checks. Start no project/runtime/agent services; context/persistence\ + \ resources close deterministically." + acceptanceCriteria: + - "Default run shows only the accepted shell; gallery is not a product workspace." + - "Theme/locale/font/scale preference restoration and repeated close/reopen are\ + \ exercised." + dependsOn: + - "TSK-0002" + status: "COMPLETED" + result: "Independent launcher/distribution and minimal shell plus separate gallery\ + \ implemented; default/minimum shell captures, preference restoration and close/reopen\ + \ validated." + evidence: + - "ART-0010" + updatedAt: "2026-11-17T17:41:25.511239Z" +- id: "TSK-0004" + title: "Qualify behavior and visual quality on macOS" + description: "Run module unit tests/installDist and legacy UI compile. Add opt-in\ + \ real JavaFX desktop tests and screenshots covering dark/light, pt-BR/en, both\ + \ fonts, 1200x800/680x480, input/selection, popup states, focus/tab, disposal\ + \ and output-scale metadata. Measure repeated updates against 250 ms and inspect\ + \ actual captures; repair failures before acceptance. Record any unverified native\ + \ IME/assistive behavior and Windows/Linux limits." + acceptanceCriteria: + - "Build, distribution, unit and real desktop checks pass with captured provenance." + - "Inspect captures for clipping, contrast, geometry and readable accented text;\ + \ record measurements and remaining limitations honestly." + dependsOn: + - "TSK-0003" + status: "COMPLETED" + result: "Eight unit tests and real desktop scenario passed, standalone run succeeded,\ + \ captures inspected and corrected, timing/contrast verified; environment and\ + \ manual qualification limits documented." + evidence: + - "ART-0010" + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:43:46.855431Z" +- id: "TSK-0005" + title: "Integrate durable docs and evidence" + description: "Publish English JavaFX 2 foundation spec and module usage/API/lifecycle\ + \ documentation. Update Studio specs index to distinguish new foundation from\ + \ the old shell. Record changes, commands, screenshots and scope boundaries in\ + \ AIE, verify evidence integrity and mark only fully verified steps complete.\ + \ Leave no commits or runtime modifications." + acceptanceCriteria: + - "Documentation matches executable behavior and commands." + - "AIE validation passes and evidence covers all DEC acceptance criteria." + dependsOn: + - "TSK-0004" + status: "COMPLETED" + result: "English module guide and canonical JavaFX 2 spec/index integrated; final\ + \ source manifest matches, build/test/visual evidence preserved and AIE/diff validation\ + \ passes. Runtime and old frontend implementation unchanged; no commits." + evidence: + - "ART-0011" + - "ART-0012" + updatedAt: "2026-11-17T17:44:43.010012Z" +status: "COMPLETED" +author: "Codex" +createdAt: "2026-11-17T16:40:49.383921Z" +revision: 18 +previousHash: "0577b989cfd95efe04c9105cd7d93b2eb4cccb301ec58ba4daecad5d1b2397da" +updatedAt: "2026-11-17T17:44:47.227069Z" +updatedBy: "system:plans" +changeReason: "All required steps completed; reviewed cancellations retained" +documentVersion: 2 +--- + +Implement a new, independent JavaFX module named prometeu-studio-ui-javafx-2 in studio. Preserve the backend, runtime and existing frontend; do not reuse its views, controls or CSS. Human explicitly accepted DEC-0001 and authorized plan plus implementation on 2026-11-17. No commits authorized. Studio write access is authorized for this scope; runtime remains read-only. + +Deliver an executable native-decorated window with Studio identity, theme/language selectors and an empty center, plus a separate development gallery. Provide own text/icon/button/toggle/field/select/panel/feedback components. Use native JavaFX behavior with scalable stepped/beveled geometry and semantic tokens. Bundle Departure Mono (default) and Roboto Mono, both SIL OFL notices. Themes: dark by default and light. Languages: pt-BR and English; system locale when supported, English fallback; missing-key marker and coverage failure. Restore theme/language/font/scale through small user preferences without a project, with tolerant defaults. Keep IO off the FX thread. Encapsulate external libraries; none is needed for this foundation. + +Targets: studio/settings.gradle.kts; studio/prometeu-studio-ui-javafx-2/build.gradle.kts and src/main/java/p/studio/ui/javafx2/{appearance,components,i18n,preferences,shell,demo}; matching resources and tests; studio/docs/specs/studio JavaFX 2 foundation spec and README. Use Java 21, JavaFX 23.0.2 and existing Gradle conventions. Keep application services untouched. Package-private implementation details, constructor-owned context and explicit close/unbind lifecycle; no speculative docking/plugins/agent/domain infrastructure. + +Verification: ./gradlew :prometeu-studio-ui-javafx-2:test :prometeu-studio-ui-javafx-2:installDist :prometeu-studio-ui-javafx:compileJava; opt-in :prometeu-studio-ui-javafx-2:desktopTest for real toolkit, windows, selectors/popups, input, keyboard/focus, state retention, resize and close/reopen. Capture dark/light, pt-BR/en and both fonts on available macOS, including minimum 680x480 and usual 1200x800, text overflow, accented/similar glyphs and actual output scale. Measure repeated theme/locale/font switches and resize; use an initial 250 ms FX update budget and retain environment/results rather than assume performance. Check text contrast >=4.5:1, large text >=3:1 and required control/focus indicators >=3:1; this is not accessibility certification. Document native accessibility/IME limits honestly. Windows/Linux are not qualified by macOS checks. Missing environment approvals must not be treated as success. + +Acceptance: new and old launches remain independent; center empty; both complete themes/locales and preferences work without input loss; font/scale swap without view changes and font licenses distributed; desktop semantic behavior/focus/clipboard and component state coverage verified; no duplicate subscriptions/resources or blocking FX IO; no ACP, Assets, editor, runtime/backend changes. Evidence links each step to actual commands and observed outcomes. Mitigate font/HiDPI and CSS translation risk by visual inspection and adjustment within DEC; retain old launcher for reversible adoption. Escalate sandbox-required build/GUI access through normal tool approval only. Do not mark unfinished QA complete. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0002/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0002/r0001.md new file mode 100644 index 0000000..c388529 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0002/r0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0002" +workId: "WRK-0013" +title: "Information architecture e navegação" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:43.705291Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:43.705291Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Avaliar organização inspirada na Godot, contexto de seleção, documentos, inspector, painéis inferiores e coexistência de ferramentas. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0001.md new file mode 100644 index 0000000..ae117f3 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Design system JavaFX e identidade bananodore" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:44.388010Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +CSS, tokens, skins, controles, pixel art, tipografia, escala, acessibilidade, performance e preservação de i18n. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0002.md new file mode 100644 index 0000000..462e2a9 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0002.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Design system JavaFX e identidade bananodore" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 2 +previousHash: "af7370f92d6e8bf4528f18efdfa7e8512ace6da3c16dc0608b5547ca82959669" +updatedAt: "2026-11-17T10:16:13.477123Z" +updatedBy: "codex" +changeReason: "Pedido humano explícito de capacidade para diferentes temas, além da\ + \ direção Pixel Vision 8." +documentVersion: 2 +--- + +Explorar design system JavaFX com identidade bananodore/Pixel Vision 8 e múltiplos temas: tokens semânticos, CSS, skins, ícones, fontes, densidade, acessibilidade, performance e i18n. Separar estrutura e semântica dos componentes de cada tema; sem implementar componentes agora. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0003.md new file mode 100644 index 0000000..c26244c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0003.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Temas e i18n como fundação do novo frontend" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 3 +previousHash: "0dc4f16ab428e2c47c3ea749040fa6a9c61eddde0aae7fd199edcf26bd039248" +updatedAt: "2026-11-17T11:58:12.156495Z" +updatedBy: "codex" +changeReason: "Escolhas humanas explícitas registradas em DSC-0018; preservar exploraç\ + ão e distinguir proposta técnica em DSC-0019." +documentVersion: 2 +--- + +Requisito humano explícito: o novo módulo começa com temas e i18n. Explorar tokens semânticos, CSS/skins, seleção de tema, recursos/bundles e atualização de locale, identidade Pixel Vision 8/bananodore, acessibilidade, escala e ausência de textos/cores de UI dispersos. Validar componentes desde o primeiro corte; sem implementar componentes nesta exploração. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0004.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0004.md new file mode 100644 index 0000000..15f918f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0004.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Componentes básicos com temas e i18n desde o início" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 4 +previousHash: "fee0966c49b00dd444d4a57a0fc46ee0af779223a4ebf8929b2b4fb92db981d9" +updatedAt: "2026-11-17T12:30:21.148284Z" +updatedBy: "codex" +changeReason: "Correções e prioridade humana em DSC-0020; preservar histórico e exploraç\ + ão." +documentVersion: 2 +--- + +Primeiro recorte humano sugerido para prometeu-studio-ui-javafx-2: fundação de componentes antes do shell. Proposta: poucos controles com consumidores previstos, tokens semânticos, estados/foco, CSS e bindings de locale, demonstrados em galeria com dois temas/idiomas. Definir escopo concreto e critérios antes de implementação; evitar reconstrução geral de JavaFX. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0005.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0005.md new file mode 100644 index 0000000..889f81f --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0005.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Componentes básicos com temas e i18n desde o início" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 5 +previousHash: "71150d1bce64474bdd05bfd632e8bc0c0cd573914869dc6eedda38495c1f452f" +updatedAt: "2026-11-17T14:01:50.143281Z" +updatedBy: "codex" +changeReason: "Reescrita completa confirmada pelo humano: novos componentes, temas\ + \ e i18n; UI antiga não é fonte de inspiração." +documentVersion: 2 +--- + +Definir novos componentes Studio com temas e i18n desde a fundação de prometeu-studio-ui-javafx-2. Tokens semânticos, estilo próprio bananodore, controles JavaFX nativos quando adequados, estados/foco, CSS e locale. Não copiar controles/estilos/modelo da UI antiga. Compor shell mínimo antes das features; galeria separada opcional. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0006.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0006.md new file mode 100644 index 0000000..5509dc1 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0006.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Componentes novos — qualidade, temas, i18n e integração de bibliotecas" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 6 +previousHash: "3da2e9ef4a54048a6035102be62b180e23c23102771790963a876615f22e2ab8" +updatedAt: "2026-11-17T14:06:29.126225Z" +updatedBy: "codex" +changeReason: "Pedido humano de máxima qualidade e autorização de bibliotecas encapsuladas;\ + \ DSC-0030." +documentVersion: 2 +--- + +Fundação de prometeu-studio-ui-javafx-2 com contratos de componente, tokens, estados, temas/i18n, foco/teclado/acessibilidade, resize/DPI, responsividade/lifecycle e QA visual real. Bibliotecas adicionais autorizadas quando úteis, sempre encapsuladas em componentes Studio de API própria, sem vazamento de tipos para views/API/Core. Recorte continua componentes básicos e shell mínimo; UI antiga só consulta funcional. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0007.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0007.md new file mode 100644 index 0000000..3d0e2a5 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0004/r0007.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Componentes novos — qualidade, temas, i18n e integração de bibliotecas" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 7 +previousHash: "606b8cf08d6f046982036e47005a109b68ac209df0715ad716ae9390cd2896bf" +updatedAt: "2026-11-17T14:20:48.098731Z" +updatedBy: "codex" +changeReason: "Aceite humano de todas as propostas visuais e de validação em DSC-0031;\ + \ preparar amostra visual, mantendo exploração." +documentVersion: 2 +--- + +Direções aceitas: bananodore escuro + claro, pt-BR + inglês, janela nativa/centro vazio/seletores, macOS/resize/HiDPI inicialmente e componentes básicos definidos. Próximo artefato: amostra visual concreta para avaliar paleta/tipografia/bordas/ícones/estados. Temas/i18n, acessibilidade, responsividade, lifecycle e bibliotecas encapsuladas continuam requisitos; nenhum detalhe visual final ou biblioteca foi escolhido por inferência. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0005/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0005/r0001.md new file mode 100644 index 0000000..4045175 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0005/r0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0005" +workId: "WRK-0013" +title: "Futuros editores e fronteiras de autoria" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.716969Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:44.716969Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Preparar responsabilidades para código/LSP e scenes, respeitando a remoção histórica do editor, cenas canônicas e ferramentas externas; sem implementar editores. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0001.md new file mode 100644 index 0000000..69aecfa --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Migração, riscos e decisões em aberto" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:45.056669Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Comparar etapas pequenas, verificáveis e reversíveis; contratos afetados e dependências de outros Works; sem criar DEC ou Plan nesta exploração. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0002.md new file mode 100644 index 0000000..d60574a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0002.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Novo módulo JavaFX e migração por capacidades" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 2 +previousHash: "f028c5dc994ae024a7158173f310d64f1c085dc1acd5bed4783c03bb30abd2db" +updatedAt: "2026-11-17T11:58:11.722764Z" +updatedBy: "codex" +changeReason: "Escolhas humanas explícitas registradas em DSC-0018; preservar exploraç\ + ão e distinguir proposta técnica em DSC-0019." +documentVersion: 2 +--- + +Direção humana DSC-0018: novo módulo de frontend, preservando UI atual para consulta/backup; fundação de temas/i18n desde o início. Prioridade: ambiente da IA, Assets, editores de código/scene e Shipper por último. Discutir composição selecionável, rollback da UI, layout/estado, reuso API/Core e fronteira ACP; sem duplicação do backend ou implementação nesta exploração. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0003.md new file mode 100644 index 0000000..b9ea2f8 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0003.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Novo módulo JavaFX 2 e migração por capacidades" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 3 +previousHash: "e956d2f95d24b0a8307973788e9c6b3c981fa11f89bb22fc9585de4c14c51d47" +updatedAt: "2026-11-17T12:30:20.690926Z" +updatedBy: "codex" +changeReason: "Correções e prioridade humana em DSC-0020; preservar histórico e exploraç\ + ão." +documentVersion: 2 +--- + +Nome humano: prometeu-studio-ui-javafx-2, preservando a UI atual para consulta/retorno. Primeiro recorte proposto: componentes básicos com temas e i18n; depois composição do shell e ambiente IA, Assets, editores código/scene e Shipper. Reutilizar API/Core e infraestrutura; discutir composição selecionável e compatibilidade de estado. Nenhuma implementação iniciada. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0004.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0004.md new file mode 100644 index 0000000..e8280e0 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0004.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Escopo ativo — módulo JavaFX 2 e galeria inicial" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 4 +previousHash: "7dd345a59e2d6c8dca5746192c68afae1ae63f69eb1638bc1267eb8e9d2ea6bc" +updatedAt: "2026-11-17T12:59:33.252929Z" +updatedBy: "codex" +changeReason: "Recorte de escopo proposto pelo humano: fundação de componentes agora,\ + \ features em Works próprios; DSC-0024." +documentVersion: 2 +--- + +Definir a fronteira mínima de prometeu-studio-ui-javafx-2 e a galeria de componentes com temas/i18n, preservando a UI atual. Shell, ACP, Assets, editores e Shipper ficam para futuros Works, com referências/destinos em DSC-0024. Migração ampla e implementação não fazem parte desta exploração. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0005.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0005.md new file mode 100644 index 0000000..b07d63a --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0005.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Escopo ativo — componentes e shell mínimo JavaFX 2" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 5 +previousHash: "9be3fe53a78366b382ae4c259e00092f45a0dc22ecff9828301032d3aacb150d" +updatedAt: "2026-11-17T13:37:50.276291Z" +updatedBy: "codex" +changeReason: "Pedido humano de incluir shell mínimo junto dos componentes, sem editores\ + \ ou demais features; DSC-0028." +documentVersion: 2 +--- + +Definir fronteira mínima de prometeu-studio-ui-javafx-2, componentes básicos e shell mínimo executável, com temas/i18n e preservação da UI atual. Sem editores, ACP, Assets ou features de domínio. Galeria separada é opcional; composição e validação proporcionais ao recorte. O shell completo e demais capacidades permanecem em futuros Works. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0006.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0006.md new file mode 100644 index 0000000..0997d59 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0006/r0006.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Escopo ativo — frontend novo, componentes e shell mínimo" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 6 +previousHash: "2d8f8bd8b220898c30c1d98dd40375dd620107892933bb15d76a46502643f761" +updatedAt: "2026-11-17T14:01:49.619912Z" +updatedBy: "codex" +changeReason: "Esclarecimento humano e confirmação em DSC-0029: frontend reescrito\ + \ integralmente; legado somente consulta, sem inspiração." +documentVersion: 2 +--- + +Definir prometeu-studio-ui-javafx-2 como reescrita completa do frontend sobre novo modelo de componentes, mantendo backend/API/Core. Legado permanece separado somente consulta de funcionalidades/integrações; não inspira nem fornece controles/layouts/estrutura/CSS à UI nova. Primeiro recorte: componentes básicos e shell mínimo com temas/i18n, sem editores/features de domínio. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0001.md new file mode 100644 index 0000000..f2f9d6c --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0007" +workId: "WRK-0013" +title: "Host de agentes ACP e experiência integrada de IA" +sources: [] +author: "codex" +createdAt: "2026-11-17T10:15:31.613746Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T10:15:31.613746Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Intenção humana confirmada: ACP (Agent Client Protocol) para conectar o Studio a agentes configuráveis. Explorar prompt, contexto visual, seleção de agente/modelo, lifecycle, coexistência MCP, autoridade e capacidades efetivamente negociadas. Revisão da baseline que hoje exclui chat/provider dentro do Studio, sem alteração normativa ou implementação nesta etapa. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0002.md new file mode 100644 index 0000000..5aaf102 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0002.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0007" +workId: "WRK-0013" +title: "Uma conversa por projeto, IA contextual e apresentação do trabalho" +sources: [] +author: "codex" +createdAt: "2026-11-17T10:15:31.613746Z" +revision: 2 +previousHash: "1f2dedbfe7536073d4616b7a0202e692679c532129ccd5b611475abc2e3c7c68" +updatedAt: "2026-11-17T11:58:11.297483Z" +updatedBy: "codex" +changeReason: "Escolhas humanas explícitas registradas em DSC-0018; preservar exploraç\ + ão e distinguir proposta técnica em DSC-0019." +documentVersion: 2 +--- + +Direção humana DSC-0018: uma conversa por projeto via ACP; contexto fornecido por seleção; prompt abaixo e saída acima. Durante execução, projeto focado no trabalho/prompt/resultado da IA. Explorar interrupção/retomada, autoridade, resultado, agente/modelo e ciclo de tarefa. A política exata de liberação ao fim do turno permanece aberta. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0003.md new file mode 100644 index 0000000..991f2fe --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/.history/TOP-0007/r0003.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0007" +workId: "WRK-0013" +title: "Chats por projeto, IA contextual e interrupção coordenada" +sources: [] +author: "codex" +createdAt: "2026-11-17T10:15:31.613746Z" +revision: 3 +previousHash: "d78759c6e50f301f0cdf7cefd2c77db5b05651c5f97f80bef7953c07dbc4f563" +updatedAt: "2026-11-17T12:30:20.242534Z" +updatedBy: "codex" +changeReason: "Correções e prioridade humana em DSC-0020; preservar histórico e exploraç\ + ão." +documentVersion: 2 +--- + +Correção humana DSC-0020: múltiplos chats por projeto, cada um apto a atuar no projeto inteiro. Seleção fornece contexto; output acima e prompt abaixo. Enquanto executa, foco no trabalho da IA. Interromper/retomar também para o agente naquele contexto; alinhar ACP, autoridade e término/cleanup reais. Concorrência, fila e política de fim normal de turno seguem abertas. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0001.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0001.md new file mode 100644 index 0000000..d29c816 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0001.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0001" +workId: "WRK-0013" +title: "Diagnóstico e inventário do frontend" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:43.338927Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:43.338927Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Arquitetura e cinco problemas prioritários; shell e todos os workspaces reais; classificação funcional e distinção entre evidência, hipótese e proposta. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0002.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0002.md new file mode 100644 index 0000000..6414ce4 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0002.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0002" +workId: "WRK-0013" +title: "Editor como unidade principal e IA contextual" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:43.705291Z" +revision: 2 +previousHash: "d79e8a15e2c576896c63572c3df2a2951740342d35740100de5fb6050e9da1c5" +updatedAt: "2026-11-17T10:44:28.438665Z" +updatedBy: "codex" +changeReason: "Resposta humana DSC-0010 escolhe editor como unidade principal; manter\ + \ em discussão contexto de seleção, foco e tarefa da IA." +documentVersion: 2 +--- + +Direção humana: o editor é a unidade principal da suíte, com IA na frente do conteúdo editado. Explorar host central, contexto de seleção/documento/tarefa, navegador de conteúdo e bancos, inspector e ferramentas inferiores. A posição do prompt, vínculo de contexto, foco e lifecycles permanecem abertos; sem decisão formal ou implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0003.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0003.md new file mode 100644 index 0000000..8d007f6 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0003.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0003" +workId: "WRK-0013" +title: "AI-first, autoridade e atualização da GUI" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.052220Z" +revision: 1 +previousHash: null +updatedAt: "2026-11-17T09:53:44.052220Z" +updatedBy: "codex" +changeReason: "Topic created" +documentVersion: 2 +--- + +Mapear GUI/MCP, acompanhamento, grant/reclaim, handoff, revisão, conflitos e atualização das projeções sem refresh manual rotineiro. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0004.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0004.md new file mode 100644 index 0000000..5aaa459 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0004.md @@ -0,0 +1,17 @@ +--- +schemaVersion: 1 +id: "TOP-0004" +workId: "WRK-0013" +title: "Componentes novos — qualidade, temas, i18n e integração de bibliotecas" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.388010Z" +revision: 8 +previousHash: "c48b5344e769d5c175462e99b0cbe5e336a9c49947bb64f0fbb21229c3ef52f1" +updatedAt: "2026-11-17T16:37:40.190824Z" +updatedBy: "Codex" +changeReason: "Consolidar escolhas visuais e emissão da DEC-0001 solicitada pelo humano." +documentVersion: 2 +--- + +Direção consolidada na DEC-0001 em DRAFT: bananodore escuro/claro, pt-BR/inglês, bordas em degraus com relevo, Departure Mono padrão e Roboto Mono alternativa local, tipografia configurável e licenças preservadas. Componentes próprios com acessibilidade, temas/i18n, lifecycle e bibliotecas encapsuladas. ART-0007 é referência exploratória; valores exatos e qualidade JavaFX dependem de validação real. Documento aguarda aprovação humana; emissão não inicia implementação. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0005.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0005.md new file mode 100644 index 0000000..42751f3 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0005.md @@ -0,0 +1,19 @@ +--- +schemaVersion: 1 +id: "TOP-0005" +workId: "WRK-0013" +title: "Suíte integrada, editores futuros e LSP interno/externo" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:44.716969Z" +revision: 2 +previousHash: "289fd1841e0d3dd10889bb49f5a205daba0a2bf7166db930cf0b1428ca33cc49" +updatedAt: "2026-11-17T10:16:13.021991Z" +updatedBy: "codex" +changeReason: "Evolução explícita da visão humana: suíte integrada, retorno do editor\ + \ de código com LSP, gestor/editor de scenes e possíveis editores futuros de pixels\ + \ e áudio." +documentVersion: 2 +--- + +Explorar host e contratos de edição comuns para código/LSP, gestão e edição de scenes, pixels emergenciais e som/música/sequenciador futuros; manter importação e ferramentas externas. Preservar a lição da remoção do editor antigo sem tratar sua ausência como direção definitiva. Sem implementar editores nesta atividade. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0006.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0006.md new file mode 100644 index 0000000..e6343bd --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0006.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0006" +workId: "WRK-0013" +title: "Escopo ativo — frontend novo, componentes e shell mínimo" +sources: [] +author: "codex" +createdAt: "2026-11-17T09:53:45.056669Z" +revision: 7 +previousHash: "3be3cc9bca8aca6eb6d1a806ec1a4d6eec8e573078c1ae07603f2a61efe655cb" +updatedAt: "2026-11-17T16:37:40.780829Z" +updatedBy: "Codex" +changeReason: "Solicitação humana de DEC registrada; fronteira consolidada para revisã\ + o." +documentVersion: 2 +--- + +DEC-0001 em DRAFT define prometeu-studio-ui-javafx-2: frontend completamente novo, componentes básicos e shell mínimo executável com centro vazio, temas/i18n e backend preservado. UI antiga separada somente para consulta funcional, sem inspiração ou dependência. ACP, Assets, editores e demais features ficam para Works posteriores. Emissão autorizada explicitamente por Nilton; aprovação do conteúdo e plano de execução permanecem pendentes. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0007.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0007.md new file mode 100644 index 0000000..ffd9add --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/topics/TOP-0007.md @@ -0,0 +1,18 @@ +--- +schemaVersion: 1 +id: "TOP-0007" +workId: "WRK-0013" +title: "Chats por projeto e execução exclusiva por prompt" +sources: [] +author: "codex" +createdAt: "2026-11-17T10:15:31.613746Z" +revision: 4 +previousHash: "e475973959ae1a19260046f16ccbf7cc0bb84cb9ee71127932a416354a8b5a1f" +updatedAt: "2026-11-17T12:33:09.220774Z" +updatedBy: "codex" +changeReason: "Resposta humana explícita nesta rodada: retorno automático à ediçã\ + o ao terminar, novos prompts bloqueados durante execução." +documentVersion: 2 +--- + +Múltiplos chats por projeto, cada um com atuação no projeto inteiro; seleção fornece contexto. Enviar prompt inicia o trabalho exclusivo da IA, com output acima/prompt abaixo e bloqueio do projeto. Não enviar/enfileirar outro prompt enquanto executa, inclusive por outro chat do projeto. Término normal devolve automaticamente edição após release/cleanup; interrupção para o agente naquele contexto. Histórico da conversa não implica controle permanente. \ No newline at end of file diff --git a/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/work.md b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/work.md new file mode 100644 index 0000000..d1934a8 --- /dev/null +++ b/.ai-engineering/works/WRK-0013-studio-ux-ui-redesign-ai-first-experience-javafx/work.md @@ -0,0 +1,226 @@ +--- +schemaVersion: 1 +id: "WRK-0013" +title: "Studio UI JavaFX 2 — componentes básicos e shell mínimo com temas e i18n" +description: "Implementação autorizada explicitamente por Nilton após aceite da DEC-0001\ + \ e geração do PLN-0001. Frontend novo, backend preservado e UI antiga separada\ + \ somente como consulta funcional; recorte limitado à fundação e shell mínimo." +goal: "Entregar a fundação de prometeu-studio-ui-javafx-2 conforme DEC-0001 aceita:\ + \ componentes básicos, temas/i18n/fontes configuráveis e shell mínimo independente,\ + \ com evidências de execução e QA no macOS." +motivation: "O port Zelda 1 demonstra produção conduzida pela IA com direção e acompanhamento\ + \ humano. O Studio deve reduzir o esforço técnico necessário para criar e avaliar\ + \ ideias, preservando capacidades, contratos e rastreabilidade. O feedback desse\ + \ port já foi usado para aprimorar o Studio e serve como histórico de aprendizado." +constraints: +- "Executar somente o recorte aprovado na DEC-0001 e PLN-0001; novos compromissos\ + \ que o contradigam exigem revisão aplicável." +- "Manter JavaFX e backend/API/Core/MCP/runtime existentes. UI nova sem dependência,\ + \ cópia ou inspiração do módulo de frontend anterior." +- "Studio com escrita autorizada para este recorte; runtime somente leitura. Nenhum\ + \ commit autorizado." +- "Sem ACP, Assets, editores, workspaces de domínio ou Shipper neste recorte; recursos\ + \ futuros permanecem em Works próprios." +- "Aprovação humana da DEC registrada; evidência real requerida para execução/QA.\ + \ Não presumir validação de plataformas, IME ou tecnologia assistiva não exercitadas." +acceptanceCriteria: +- "Fronteira de prometeu-studio-ui-javafx-2 explicitada: frontend completamente novo,\ + \ dependências mínimas e backend existente; módulo antigo somente consulta funcional,\ + \ sem dependência, inspiração ou reaproveitamento de seus componentes/estrutura." +- "Lista inicial aceita: textos/títulos, ícones, botões/toggles, campos, seletores,\ + \ painéis e feedback básico, com contratos pequenos, estados/lifecycle explícitos\ + \ e comportamento desktop consistente; bibliotecas adequadas encapsuladas em componentes\ + \ Studio." +- "Temas iniciais aceitos: bananodore escuro e alternativa clara. Idiomas iniciais\ + \ aceitos: pt-BR e inglês. Definir tokens/recursos/i18n com troca efetiva, textos\ + \ dinâmicos, formatação/chaves/fallback e estados consistentes." +- "Shell mínimo aceito: decoração nativa da janela, identidade própria no interior,\ + \ centro vazio e seletores tema/idioma; sem editores, comandos fictícios ou domí\ + nio. Validação inicial no macOS disponível com resize e HiDPI; cobertura Windows/Linux\ + \ permanece a definir." +- "Preparar amostra visual concreta de paleta/tipografia/bordas/ícones/estados para\ + \ avaliar a direção antes da decisão/implementação. Aceite das propostas de escopo\ + \ não equivale a aprovar uma imagem ou valores finais ainda não vistos." +- "Qualidade: identidade bananodore deliberada, documentação/testes dos contratos\ + \ próprios e QA visual real. Nenhum resultado de contraste/acessibilidade/performance\ + \ pode ser presumido por mockup ou compilação." +- "Bibliotecas adicionais admitidas por benefício e compatibilidade, encapsuladas\ + \ em componentes de API própria, sem vazamento de tipos para consumidores ou API/Core.\ + \ Nenhuma biblioteca escolhida por inferência." +- "Histórico/evidências/direções de produto preservados, demais features em Works\ + \ futuros; manter EXPLORATORY até instrução humana explícita de encerramento/solicitaç\ + ão de DEC." +status: "COMPLETED" +createdAt: "2026-11-17T09:49:38.836122Z" +updatedAt: "2026-11-17T17:44:49.105707Z" +author: "Nilton" +repositories: +- repositoryId: "studio" + path: "studio" + head: "fa37d0d0c7d9f8ea33ea630571ed6117581a1958" + dirty: false +discussions: +- "DSC-0001" +- "DSC-0002" +- "DSC-0003" +- "DSC-0004" +- "DSC-0005" +- "DSC-0006" +- "DSC-0007" +- "DSC-0008" +- "DSC-0009" +- "DSC-0010" +- "DSC-0011" +- "DSC-0012" +- "DSC-0013" +- "DSC-0014" +- "DSC-0015" +- "DSC-0016" +- "DSC-0017" +- "DSC-0018" +- "DSC-0019" +- "DSC-0020" +- "DSC-0021" +- "DSC-0022" +- "DSC-0023" +- "DSC-0024" +- "DSC-0025" +- "DSC-0026" +- "DSC-0027" +- "DSC-0028" +- "DSC-0029" +- "DSC-0030" +- "DSC-0031" +- "DSC-0032" +- "DSC-0033" +- "DSC-0034" +- "DSC-0035" +- "DSC-0036" +- "DSC-0037" +- "DSC-0038" +- "DSC-0039" +- "DSC-0040" +- "DSC-0041" +decisions: +- "DEC-0001" +artifacts: +- "ART-0001" +- "ART-0002" +- "ART-0003" +- "ART-0004" +- "ART-0005" +- "ART-0006" +- "ART-0007" +- "ART-0008" +- "ART-0009" +- "ART-0010" +- "ART-0011" +- "ART-0012" +- "ART-0013" +plans: +- "PLN-0001" +completions: +- at: "2026-11-17T17:44:49.105707Z" + by: "system:plans" + summary: "All required Plans completed; requester=Codex" + humanApproved: false + scopeHash: "eed9276915870dbe8b5520154c6d44a7f1d8f782c6bfc0e8cbf80fe276afe9f6" + criteria: + - criterion: 1 + text: "Fronteira de prometeu-studio-ui-javafx-2 explicitada: frontend completamente\ + \ novo, dependências mínimas e backend existente; módulo antigo somente consulta\ + \ funcional, sem dependência, inspiração ou reaproveitamento de seus componentes/estrutura." + evidence: + - "ART-0013" + - criterion: 2 + text: "Lista inicial aceita: textos/títulos, ícones, botões/toggles, campos, seletores,\ + \ painéis e feedback básico, com contratos pequenos, estados/lifecycle explí\ + citos e comportamento desktop consistente; bibliotecas adequadas encapsuladas\ + \ em componentes Studio." + evidence: + - "ART-0013" + - criterion: 3 + text: "Temas iniciais aceitos: bananodore escuro e alternativa clara. Idiomas\ + \ iniciais aceitos: pt-BR e inglês. Definir tokens/recursos/i18n com troca efetiva,\ + \ textos dinâmicos, formatação/chaves/fallback e estados consistentes." + evidence: + - "ART-0013" + - criterion: 4 + text: "Shell mínimo aceito: decoração nativa da janela, identidade própria no\ + \ interior, centro vazio e seletores tema/idioma; sem editores, comandos fictí\ + cios ou domínio. Validação inicial no macOS disponível com resize e HiDPI; cobertura\ + \ Windows/Linux permanece a definir." + evidence: + - "ART-0013" + - criterion: 5 + text: "Preparar amostra visual concreta de paleta/tipografia/bordas/ícones/estados\ + \ para avaliar a direção antes da decisão/implementação. Aceite das propostas\ + \ de escopo não equivale a aprovar uma imagem ou valores finais ainda não vistos." + evidence: + - "ART-0013" + - criterion: 6 + text: "Qualidade: identidade bananodore deliberada, documentação/testes dos contratos\ + \ próprios e QA visual real. Nenhum resultado de contraste/acessibilidade/performance\ + \ pode ser presumido por mockup ou compilação." + evidence: + - "ART-0013" + - criterion: 7 + text: "Bibliotecas adicionais admitidas por benefício e compatibilidade, encapsuladas\ + \ em componentes de API própria, sem vazamento de tipos para consumidores ou\ + \ API/Core. Nenhuma biblioteca escolhida por inferência." + evidence: + - "ART-0013" + - criterion: 8 + text: "Histórico/evidências/direções de produto preservados, demais features em\ + \ Works futuros; manter EXPLORATORY até instrução humana explícita de encerramento/solicitaç\ + ão de DEC." + evidence: + - "ART-0013" + integrations: [] + noIntegrationReason: "Canonical changes and execution results are recorded in the\ + \ Plan step evidence" + origin: "SYSTEM_PLANS" + delegation: null + aggregation: + receipt: "ART-0013" + inputHash: "6eda756b78e916dfdbda52bfcf245b487832d7d4303dbbd0e610385f766f2214" + requester: "Codex" + requestId: "6d455fe0-0378-4e42-bc27-287a9291b394" +events: +- action: "COMPLETE" + by: "system:plans" + reason: "All required Plans completed; requester=Codex" + at: "2026-11-17T17:44:49.105707Z" +archived: false +topics: +- "TOP-0001" +- "TOP-0002" +- "TOP-0003" +- "TOP-0004" +- "TOP-0005" +- "TOP-0006" +- "TOP-0007" +surveys: [] +dispositions: [] +agentRuns: [] +epic: false +guidance: + mode: "EXPLORATORY" + approvalPolicy: "REQUIRED" + history: + - mode: "EXPLORATORY" + approvalPolicy: "REQUIRED" + by: "Nilton" + reason: "Escolha humana explícita nesta conversa: EXPLORATORY — investigar e discutir\ + \ alternativas antes de solicitar uma decisão." + at: "2026-11-17T09:49:38.792833Z" + humanApproved: true + decisionRequests: + - decisionId: "DEC-0001" + by: "Nilton" + reason: "Instrução humana explícita nesta conversa: vamos emitir a dec entao.\ + \ Encerrar a exploração deste primeiro recorte para emitir a DEC revisável,\ + \ sem inferir aprovação do conteúdo ou autorização de implementação." + at: "2026-11-17T16:33:59.652523Z" + humanApproved: true +--- diff --git a/studio b/studio index fa37d0d..1e17fc4 160000 --- a/studio +++ b/studio @@ -1 +1 @@ -Subproject commit fa37d0d0c7d9f8ea33ea630571ed6117581a1958 +Subproject commit 1e17fc4d677f580592e47fa9ffe3e9bb41600f94