feat(pbs): add sprite animation and shared Studio authoring

Implement DEC-0084 with factory-only Sprite/Animator structs, complete result
lowering, validated animation sidecars, generated PBS factories and JavaFX/MCP
authoring through shared services.

Qualify native dev/release with ordinary and optimized producers, zero-allocation
playback, private-cycle reclamation, canonical Composer pixels, installed JARs
and JavaFX lifecycle. Preserve the runtime checkout and existing host ABI.
This commit is contained in:
2026-11-05 15:16:07 +00:00
parent 1d8b8c2101
commit bf31184d4d
151 changed files with 4823 additions and 98 deletions
@@ -0,0 +1,211 @@
---
id: LSN-0100
ticket: pbs-core-sprite-animation
title: Sprite Animation, Typed Results and Shared Authoring
created: 2026-11-05
tags: [compiler, pbs, core, stdlib, animation, studio, packer]
---
## Context and outcome
Owner: **compiler/pbs**. Studio owns the neutral authoring model and editor;
Packer owns registered asset identity and the effective glyph layout.
DEC-0084 and PLN-0162 delivered one complete feature across these domains.
Their workflow artifacts were retired after implementation; the durable contracts
are [PBS chapter 27](../../../docs/specs/compiler-languages/pbs/27.%20Core%20Sprite%20and%20Animation%20Specification.md)
and [Studio chapter 12](../../../docs/specs/studio/12.%20Animation%20Authoring%20Specification.md).
Games previously supplied primitive Composer arguments and implemented animation
themselves. The final implementation supplies ordinary PBS `Sprite`,
`AnimatorBuilder` and `Animator` structs, explicit-tick playback, generated
factories from canonical JSON, complete JavaFX authoring, task-authorized MCP
operations and installed examples. Composer keeps its public nine arguments,
int status, capability and host identity. No runtime source or ABI changed.
## Model identity and playback separately
`SpriteView.sprite()` returns bank and glyph together. A palette, position,
layer, flip and priority still belong to the caller's emission. A visual query
neither advances an animator nor constructs a Sprite.
The builder fixes its bank and initial clip name. It permits one open clip,
validates operations in the specified order and retains a failed draft for repair.
Every `build()` copies all mutable clip/frame nodes before publishing an animator.
Two builds have independent playback and backing; ordinary assignment aliases
one animator. Only immutable strings may retain ordinary sharing.
The public types carry trusted factory-only construction metadata. Checking the
spelling of an imported type would be insufficient: aliases preserve the declaring
type's identity, and same-module permission is tied to the current file/module.
Game source cannot manufacture the reserved attribute. Public barrels hide node
types and constructor completion surfaces.
Each published clip has immutable frame links with cumulative ends and a tail
link to its head. Animator retains its selected clip, current frame, phase and
playback state. For positive ticks while Playing:
1. Reject `phase > LONG_MAX - ticks` before addition.
2. Loop reduces the new phase modulo the total duration.
3. Once finishes after the entire final duration and retains the last image.
4. Resolve the frame from cumulative ends, traversing at most one clip.
5. Publish the new phase, cursor and state after calculations complete.
No per-tick or per-skipped-loop iteration is needed. Successful advance, negative
and overflow errors, and sprite queries execute no heap allocations after
construction. Builder construction and copying have their ordinary allocation
costs. A VM resource trap remains a trap; recoverable domain-error preservation
does not promise rollback after arbitrary VM failures.
`play` and `select` reset even when passed the current name. Use `play` on an
action transition, then `advance` for continuity. Pause/resume preserve progress;
resume does not restart Finished. Stop resets to Stopped; restart resets to Playing.
## Preserve the complete result group
Executable result returns use the existing VM group:
```text
Int32 status, complete typed payload
0 = success; 1..N = canonical error declaration order
```
Unit returns only status. An inactive reference, function or trait payload uses
runtime-admitted nullable defaults. Reserved, never-assigned locals supply Null
without allocating default-holder structs. Scalars and builtin groups receive
their correct typed defaults. Slot count alone never establishes nominal type or
error identity.
Propagation evaluates once, discards pending expression temporaries on its error
path, returns the same status and supplies the enclosing function's inactive
payload. Handling evaluates once and executes only its selected recovery/remap.
Neither catches a VM trap. Imports, contract calls, discarded results and Registry
signatures must agree on the same status-plus-payload shape. A result-effect
function cannot become a plain `Fn` value; successful Fn payloads remain ordinary
typed function references.
A useful integration pitfall appeared in `let glyph = animator.sprite().glyph_id`.
The tuple-producing method inherited the projected field's expected int type,
which prevented the method call from being selected during lowering. Lowering the
receiver with its own tuple type fixes the call and subsequent projection.
The state-matrix fixture exposed this before native admission.
## Canonical persistence has one owner
The sidecar `animations.studio.json` is the editable persistence surface. Its
strict version-1 codec rejects duplicate/unknown keys, unsupported versions,
invalid UTF-16 strings and fractional/out-of-range integers. Durations retain exact
signed 64-bit values, including numbers above JavaScript's exact integer range.
Bindings use stable selected artifact IDs, current glyph indices and fingerprints.
Paths and list positions are not animation identity. Reordering, removal and
replacement block preview/build until an explicit rebind. Bank relocation retains
identity. Palette and playback clock never become definition fields.
`prometeu-animation` owns DTOs, codec, validation, revisions, rebind and timeline.
It depends on no compiler, concrete Packer, JavaFX or Spring classes. Packer exposes
its effective layout using the same material/composition helpers as packing. App
composition adapts that public API to the neutral layout port.
Revision verification and atomic replacement run under Packer's existing project
exclusion. Preparing rebind returns a binding-only candidate, old/new differences,
affected frames, proposal hash and bank revision. Applying checks the exact current
proposal. The hash correlates content; it introduces no new grant or approval.
Late asynchronous callbacks require attention. Cancelling the waiting task thread
does not necessarily stop a queued Packer callback. Task authority and a sticky
cancellation state are checked again at publication. Concurrent creates admit one
winner; a cancelled late callback cannot overwrite canonical bytes.
Studio's module boundary is also real: session consumes the exported
`assets.AnimationOperations` seam, rather than depending on the hidden
`assets.animation.DefaultAnimationService` implementation. The modularity test
caught that distinction during integration.
## Generate a view instead of another document
Only registered, included banks with valid definitions publish factories:
```pbs
import { create_hero } from @app:generated/animations/b_12345678123412341234123456789abc;
import { AnimationError } from @core:animation;
fn example() -> result<AnimationError> {
let value = create_hero(3)!;
value.play("idle")!;
value.advance(2)!;
let image = value.sprite();
// Caller supplies image.bank_id/image.glyph_id plus external emission inputs.
return ok(());
}
```
PBS owns this deterministic projection. Factories sort by animator ID; clip/frame
order remains authored order. Revisions include the document, resolved bank and
generator version, excluding timestamps and absolute paths. Included invalid
definitions or a missing layout resolver fail explicitly. Physical modules cannot
occupy the reserved namespace.
The compiler/LSP exposes revision-scoped read-only documents and UTF-8 origin
ranges mapped to JSON pointers. The origin command revalidates the current source
and opens the bank/field through Studio's authoring service. Caller-provided paths
are not navigation authority. Wire metadata uses URI strings, not Java filesystem
implementation objects, so JSON-RPC serialization does not reflect into private
`Path` internals. Changed origins are rejected after edits or reconnect.
JavaFX and MCP share validation, persistence, preview and rebind services. Human
draft editing stays in controls; authority and file writes stay in services.
Handoff awaits animation refresh as well as the existing forms. UI autoplay merely
schedules explicit preview ticks. MCP query/update schemas admit only fields for
the selected operation and retain existing task admission and result envelopes.
## Qualify the boundary that actually executes
The production-native matrix executes both ordinary and optimized producers in
dev and release. Result fixtures cover complete payloads, once-only evaluation,
recovery/remapping and uncaught traps. Animation fixtures cover ownership, all
domain errors, state/time boundaries, long/count limits, int-max jumps and zero
executed allocation instructions in the marked paths.
Safepoint fixtures observe live private rings, then zero retained Animator/clip/frame
objects after releasing their last owner. The observed cumulative reclamation is
2,411 objects at the first collection and 4,817 at the second. Test-only near-limit
and safepoint setup is isolated from shipped modules; no billions-of-elements claim
or public mutation hook is implied.
A real saved-project corpus runs direct and generated animators through Composer.
For both producers and native profiles, ticks 0..7 produce glyphs
`0,0,1,1,1,2,0,0`, alternating palettes 0/1. Every sprite pixel matches shared
preview: 32 native frame observations and 16,384 pixel comparisons. The configured
packaged process repeats both producer variants with 8,192 pixel comparisons.
The sidecar bytes remain unchanged by palette selection and execution.
That gate found a pre-existing Composer adapter mismatch: native statuses use an
Int64 carrier while the public PBS facade returns int. The private host declaration
now uses long and the facade explicitly narrows using an existing intrinsic.
Public arguments, status type, slot counts, capability and host identity remain
unchanged. Runtime modification was unnecessary.
Installed knowledge is tested in a separate JVM outside the checkout using product
JARs. It saves a Packer-bound definition, compiles generated factories, verifies
read-only origins and installed MCP schemas, and supplies native firmware fixtures.
The JavaFX gate authors, saves, previews, repairs drift and closes the real editor.
The full regression and architecture/modularity gates pass.
See [qualification evidence](evidence/README.md), [concrete results](evidence/results.json)
and [editor capture](evidence/animation-editor.png). The evidence records exact
hashes, commands, environment and practical test limits. Cargo outputs stayed under
`/tmp`; the runtime checkout remained unchanged. No runtime commits were created.
## Common mistakes
- Treating a result payload as its plain return while forgetting the status slot.
- Allocating a default holder on every unit error or inactive payload path.
- Letting aliases or transitive factory return types lose declaration provenance.
- Sharing mutable builder nodes with published animators.
- Replaying every skipped tick or loop instead of reducing phase first.
- Calling `play` every frame and unintentionally resetting the cursor.
- Retargeting frames by path/order when stable identity drifts.
- Validating a revision before queuing work and assuming it remains current at save.
- Keeping stale generated text as a fallback after validation fails.
- Testing only source compilation when typed native admission and real rendering
are part of the contract.
@@ -0,0 +1,31 @@
# DEC-0084 / PLN-0162 qualification evidence
Owner: compiler/pbs; cross-domain Studio and Packer. Completed 2026-11-05.
- `environment.json` records provider, installed executables, targets and commands.
- `source.sha256` identifies every changed tracked/untracked implementation file.
- `fixtures.sha256.gz` identifies the mandatory Result/Animation PBX, manifests,
packed assets and shared-preview pixel oracles in the Studio build corpus.
- `results.json` records concrete counts and limits; native logs contain assertions.
- Compressed regression and test reports preserve the final successful gates.
- `animation-editor.png` is the real JavaFX editor after authoring/save/preview.
The production VM/firmware matrix ran ordinary and optimized producers in both
native dev/release profiles. The saved-project Composer corpus compares every
sprite pixel against the shared canonical preview while alternating palette IDs.
The configured installed process repeats that comparison for both producers.
Heap counts cover executed allocation opcodes in the marked paths, not constructor
costs, host rendering or a claim about every theoretical program. Test-only count,
phase and safepoint setup does not add a public mutation API. Zero-quota construction
produces resource traps; it does not become a recoverable animation error.
Origin navigation is qualified through the real compiler/LSP bridge and registry,
wire serialization, editor selection and client TypeScript compilation. The new
CodeLens was not separately exercised in a VS Code Extension Development Host.
The JavaFX image uses the standalone control with the default skin, not a full
Studio shell screenshot.
The repository has no CLI operation to create/allocate a lesson. LSN-0100 was
prepared from the next available metadata ID; `discussion housekeep` registers
it and advances that counter. No index edit was performed manually.
@@ -0,0 +1,21 @@
0d28d6891ad8d385c1d103233e85f619005543528269eb6531428f07f1b348c0 README.md
d5260791f61756c7c1d5f9864e4a0c91c76751833a6e7827346a06e21672608c acceptance.md
15525c8aa73b7d940c020721a4fd1aa677d3d0c3fd6186ada0a8ff5082c0334f animation-authoring.xml.gz
95776283387855cb29abf982bc15cf680a2af90db23271e30c86784e16190fd0 animation-editor.png
2c0df78907358c81e820e5339664a221f7abd96583f13f062a303e98eb33943c animation-native-dev.log.gz
86c0ceca52378b4fb3f1750912c33abb878fc7e52d39395a7245a140b51286b0 animation-native-release.log.gz
bd3d04976189f3077709582fb5110c902503cb3af407ff82600b5f56226c6906 animation-ui.xml.gz
a4e58f9a9115d6c69e74e7add930f72f7259306c48c62cad47e3500605f9e9ec authoring-final.log.gz
9fe0bf32db9ca80997ace82d59f67782151cf9196df7e0a7346058960a0d521d composer-installed-process.log.gz
8e3faee9ff1cb98394aa3c08693e497bd03b131f92d4af78f926dec7182ae470 composer-installed-process.xml.gz
dbaa6ef29376e6c0f2763c13acbbcca9b9f188de830db8699b0f49c1bc88f8d7 environment.json
9324e7c344fdcfb0e6aaad7e00fc282a8f6b8424d115bb5f8bc0643176c29214 fixtures.sha256.gz
fa7e3732a4c3b7f2331cafbdcad22c6c30ea7a34c5222d824312b0688f782b02 fn-effect-rejection.log.gz
c0e843b7aeb63dcf4f4f0b1d206f314c5ea827cdfca33b66ddbe7c1c1e09c9fb installed-knowledge.xml.gz
9ef7dc7a127288ad4289a4e37c0d047081ffec3273659ad4912340ba27d985da regression.log.gz
d5caa3ba786b97e3d7de731f5645e9eb5fe448fe4abcc02dfecba5e2e9e9b000 result-native-dev.log.gz
10d6cb9fa5aafcd8f1c989ec87a5720e1a6944c34f47ab82e903af7bb722e39f result-native-release.log.gz
955cfe97d4033ab758024e1735f861fc12ccf1630139841abfd55d8b7f7c2668 results.json
25024cca3fdd75e59d09a6526a64c6cc7ef43d8af2f7121d849c7e61f62aedd4 source.sha256
cd3505eb82eb5e0e60e459b93cb744a5846f520ffe53ff2a214a9378c0f55572 workflow.txt
a33cc281e5263d4e03aa0220b5ab6f7e6a4180222a980d646e68a569963217ef ../LSN-0100-sprite-animation-and-shared-authoring.md
@@ -0,0 +1,26 @@
# Acceptance mapping
All fourteen PLN-0162 criteria were completed. The accepted scope was not split.
| Criterion | Implementation and observed gate |
| --- | --- |
| AC1 | English PBS 27 / Studio 12, propagated compiler/Packer/Studio chapters and indexes. Installed references read from JARs. |
| AC2 | Status-first full typed return groups. 21 Result cases × ordinary/optimized × native dev/release; trap cases remain traps; plain-Fn rejection tested. |
| AC3 | stdlib 1 core/sprite and core/animation, concrete/trait SpriteView queries, factory-only positional/named aliases rejected; forged metadata rejected. |
| AC4 | Reused builder produces independent finalized nodes. Draft repair/removal/rebuild preserves existing animators; assignment aliases. |
| AC5 | Native Loop/Once boundaries, complete state/reset behavior, pause/resume, zero/negative input, checked overflow, int-max jump and limit cases. |
| AC6 | Native instruction counters observe zero heap allocations in marked sprite/advance/error paths; bounded traversal gate; quota traps and cycle reclamation observed. |
| AC7 | Stable identities, fingerprints and exact JSON. Real Packer sidecar leaves assets.pa byte-identical; rebind detects drift; bank relocation retains identity and revision. |
| AC8 | Neutral p.animation module and layout port. Architecture and Spring Modulith gates pass. Included definitions without a resolver fail explicitly. |
| AC9 | Real build factories, reserved collision diagnostic, invalid/excluded behavior, exact UTF-8 including controls/supplementary characters, sorted/byte-identical regeneration; read-only revision-scoped JSON origins reject stale navigation/reconnect. |
| AC10 | Actual JavaFX create/frame/save/preview/rebind/origin selection/close fixture passes. Handoff awaits animation persistence/refresh and retains failed drafts. |
| AC11 | Shared manual/task services and strict MCP schemas. Valid MCP save/get/preview parity, stale revision, invalid authority, revoked task, concurrent creates and cancelled late publication tested. |
| AC12 | Direct/generated Composer pixels equal preview across tick boundaries and alternating palettes in ordinary/optimized producers and native dev/release. Configured packaged process repeats both producers. |
| AC13 | Installed JARs expose specs/modules/examples/MCP schemas and compile a saved project outside the checkout. Generated installed fixtures execute through production firmware. Runtime tree remains clean. |
| AC14 | Full Gradle regression, installed knowledge, architecture/modularity, dedicated JavaFX gate, client TypeScript compilation, native matrices and diff/workflow validation pass. |
The new origin CodeLens was typechecked and its server/editor contracts were
qualified; a new VS Code Extension Development Host session was not performed.
The screenshot is the actual standalone JavaFX control with the default skin.
Count and safepoint fixtures use isolated test setup rather than allocating
billions of nodes or adding shipped mutation hooks.
Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

@@ -0,0 +1,33 @@
{
"date": "2026-11-05",
"platform": "macOS-27.2-arm64-arm-64bit-Mach-O",
"studio_head": "1d8b8c21014b5b2e94bcd6621dbea177afc0d4eb",
"studio_tree": "uncommitted implementation; exact changed files in source.sha256",
"runtime_head": "09d8778f046a2819c50ac786bfb50e958ef5af61",
"runtime_working_tree": "clean",
"runtime_writes": false,
"runtime_commits": false,
"cargo_target": "/tmp/studio-animation-native-target",
"rustc": "rustc 1.98.1 (48a229cea 2026-09-01)",
"node": "24.21.0 (existing NVM installation; system Node has a missing ICU dependency)",
"java": {
"gradle_launcher": "Amazon Corretto 25",
"product_and_tests": "Amazon Corretto 21"
},
"installed_runtime": "/Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/runtime/dist-staging/stable/prometeu-cli-aarch64-apple-darwin",
"installed_runtime_sha256": {
"prometeu": "182e4d9a4d32201c8ad892a11c297de7059dcc0a837660bdd173be44808b9906",
"prometeu-headless": "7703190f63844d91fa125ba3a322b5e771db79a282b3cfbb3480eef76422b6ef",
"prometeu-runtime": "0e8e692395cedea799b6d555b416e40536dcabf3a98a2061327d2010c478e446"
},
"commands": [
"./gradlew test :prometeu-app:installedKnowledgeTest :prometeu-app:animationDesktopTest --console=plain",
"./gradlew :prometeu-app:test --tests *AnimationIntegrationTest :prometeu-app:headlessProcessTest --tests *AnimationInstalledRuntimeTest -PstudioRuntimeInstall=<environment installed_runtime> --console=plain",
"./gradlew :prometeu-architecture-tests:test --tests *PbsResultTest.resultFunctions* --console=plain",
"CARGO_TARGET_DIR=/tmp/studio-animation-native-target python3 tools/pbx-conformance/run.py --runtime ../runtime --result-only [--release]",
"CARGO_TARGET_DIR=/tmp/studio-animation-native-target python3 tools/pbx-conformance/run.py --runtime ../runtime --animation-only [--release]",
"NVM Node 24.21.0: node tools/vscode-extension/node_modules/typescript/bin/tsc -p tools/vscode-extension",
"git diff --check",
"discussion validate"
]
}
@@ -0,0 +1,134 @@
{
"result": {
"producer_variants": [
"ordinary",
"optimized"
],
"native_profiles": [
"dev",
"release"
],
"cases_per_producer": 21,
"native_fixture_runs": 84,
"trap_cases": "remain VM traps; handle never recovers traps"
},
"animation": {
"cases_per_producer": 9,
"producer_variants": [
"ordinary",
"optimized"
],
"native_profiles": [
"dev",
"release"
],
"native_fixture_runs": 36,
"measured_allocations": 0,
"measured_paths": [
"sprite via concrete/trait",
"successful advance",
"negative advance",
"overflow advance",
"factory/builder error paths"
],
"count_setup": "test-only near-limit nodes; unchanged production operation; no billions-of-elements claim",
"frame_traversal_gate": "less than 50000 measured instructions including int-max jump"
},
"gc": {
"profiles": [
"dev",
"release"
],
"producer_variants": [
"ordinary",
"optimized"
],
"live_root_first_safepoint": true,
"unowned_animation_clip_frame_objects_second_safepoint": 0,
"reclaimed_first_safepoint": 2411,
"reclaimed_cumulative_second_safepoint": 4817
},
"composer": {
"producer_variants": [
"ordinary",
"optimized"
],
"native_profiles": [
"dev",
"release"
],
"ticks": [
0,
1,
2,
3,
4,
5,
6,
7
],
"glyphs": [
0,
0,
1,
1,
1,
2,
0,
0
],
"palettes": [
0,
1,
0,
1,
0,
1,
0,
1
],
"sources": [
"direct builder",
"saved JSON generated factory"
],
"sprite_size": [
16,
16
],
"native_frame_observations": 32,
"native_pixel_comparisons": 16384,
"installed_process_frame_observations": 16,
"installed_process_pixel_comparisons": 8192,
"canonical_sidecar_bytes_preserved": true
},
"ui": {
"toolkit": "actual JavaFX, standalone control, default skin",
"actions": [
"create animator and clip",
"add frame with exact duration",
"save",
"preview canonical PNG",
"bank drift",
"prepare/apply rebind",
"JSON origin selection",
"handoff and close"
],
"screenshot": "animation-editor.png"
},
"navigation": {
"revision_revalidation": true,
"reconnect": true,
"stale_origin_rejection": true,
"wire_origin_serialization": true,
"client_typecheck": true,
"full_vscode_development_host_for_new_codelens": false
},
"boundaries": {
"runtime_unchanged": true,
"neutral_model_architecture": true,
"studio_module_export_contract": true,
"binary_assets_unchanged_by_sidecar": true,
"cancelled_late_publication_blocked": true,
"concurrent_create_single_winner": true
}
}
@@ -0,0 +1,129 @@
bb32a9d1fc9345ee10b604a2e0e6097c4264d8040247901bd626d2dad633720d docs/specs/compiler-languages/pbs/10. Memory and Lifetime Specification.md
c8ad4792299089eb74846a177dedb592a55e1161ca36fb3d3b4682b47a7453b6 docs/specs/compiler-languages/pbs/13. Lowering IRBackend Specification.md
ec3a04c5c732e08c956fba7a1c1913e4915ac9dda7d3452180ec79fcd4517ea6 docs/specs/compiler-languages/pbs/27. Core Sprite and Animation Specification.md
9d2721529fafb7b984e158cbed2211d4bdf9b9bc545dbbbc18553c0784aff4e2 docs/specs/compiler-languages/pbs/3. Core Syntax Specification.md
8fae59383422256af30625a1debd8b9d3d06bf79de4b6054fd973826b9351204 docs/specs/compiler-languages/pbs/4. Static Semantics Specification.md
837186551dabf59a829d141f76214800c8933e383da57a279842b7ccda40266e docs/specs/compiler-languages/pbs/5. Manifest, Stdlib, and SDK Resolution Specification.md
65b38a52baf784f28f19d0ef993565c028c3731044d7fadc06cb3f465d8823fe docs/specs/compiler-languages/pbs/8. Stdlib Environment Packaging and Loading Specification.md
6251c7b245371677d9c3128ed105798a713065ebdb5b3362d1a24fc70a17c20f docs/specs/compiler-languages/pbs/9. Dynamic Semantics Specification.md
4b66f7067ad726857842bc840dde3ca6c86e5e6bf5ccc41bb016fca4b858e4f0 docs/specs/compiler-languages/pbs/README.md
f039d441eaba2d3de051cdd5ead730b3edada225f6022ff4d5f2e450048df08b docs/specs/compiler/18. Standard Library Surface Specification.md
1eef76bdc53e7b8121ff6357ecf7e91a2b278176e189d057d804eba9385a950d docs/specs/compiler/20. IRBackend to IRVM Lowering Specification.md
e683f2b322d51848d9bcd2c63b33d926e94cc27135d8763791e6b6262e8032ab docs/specs/compiler/25. Typed Registry and PBX v0 Specification.md
ca0edb95fea030beaa9e7f20913c46eec9de3f204a0dadbfa31d916aa9522a21 docs/specs/packer/2. Workspace, Registry, and Asset Identity Specification.md
4f380e0b4361e3a52ce286832319bfac0d45e55fc7f9f9b197fb1c87d310493e docs/specs/packer/3. Asset Declaration and Virtual Asset Contract Specification.md
3fa1b270d1b4e2a66d12ef6f3025161f3a2a3607baf50b191fd142cd322e5956 docs/specs/packer/4. Build Artifacts and Deterministic Packing Specification.md
ca3c6005183161313d4371c788058cf4bc6a4eef9a085a55201c453a6893864d docs/specs/studio/11. MCP Tools and Project Knowledge Contract.md
41881dae01a0420ef9f20aa555363e2b8a6b8b6cf4f7126157729b91704f2ba0 docs/specs/studio/12. Animation Authoring Specification.md
1007134a4e37e1070fb90cfb6fda79be2f60a252398c856f8e8a5c13984e40b9 docs/specs/studio/4. Assets Workspace Specification.md
c265f466573474fc5b769705d1e7b80831395635dbf9b74f87965d7b1a8f0e8f docs/specs/studio/9. Studio Core and Adapter Architecture Specification.md
6821f65531e72dfdcd9945685c26af425b6c671b200193ded10a56735c09c02d docs/specs/studio/README.md
7d5951e493364a7815066e76799b93f6a6c614a76911758e937fb70b12e3154c prometeu-animation/build.gradle.kts
4a65d23e0a708337a1d79a8c857cdd074f05b76de11ab2929a6f0d890aac6d0e prometeu-animation/src/main/java/p/animation/AnimationCodec.java
fddda8ae3f78a32d62c5efd85539f5ffab904a1ddafaa17f2becf662510abcbc prometeu-animation/src/main/java/p/animation/AnimationDiagnostic.java
1664c83f83f6c56733545707185601d22de7bf5c2027f76d0ab18b2a61c355f2 prometeu-animation/src/main/java/p/animation/AnimationDocument.java
4857bd166d3758d0a8c49ad4963142eff3e4bf64178b8dab7747ddb99308d4c4 prometeu-animation/src/main/java/p/animation/AnimationOriginNavigation.java
f77ed5b4946fea3452275e0807b0d979519d92f706832f823ae8a460907d01a1 prometeu-animation/src/main/java/p/animation/AnimationRebind.java
d31acf93ecb83f9622966e1d361dc31ef6c366dc35dce3d8bff1a8d20f035150 prometeu-animation/src/main/java/p/animation/AnimationRevision.java
ce9bdadfe16f24fcae358d7de213a8c8450ca8a5e2ed45075c6f2f10bda0d983 prometeu-animation/src/main/java/p/animation/AnimationSource.java
1363b399ef7494abe88b3cb2a1e30d0815347501305558e72b1f4f56dc086bd8 prometeu-animation/src/main/java/p/animation/AnimationTimeline.java
57fcb4956030d63b74d0824e5fa35cdd033516c851ba9cde415201cfa51ebec7 prometeu-animation/src/main/java/p/animation/AnimationValidator.java
6fd1f8b203735769e3ec7a7e62240a41fa34a654a19c09151a11f5668953df66 prometeu-animation/src/main/java/p/animation/GlyphBankLayout.java
176f288b6ea3f984c52227b26264bcf69dbe4bb5535990aa9ef37cab48e8d742 prometeu-animation/src/main/java/p/animation/GlyphBankLayoutSource.java
30980f79ba7c1aeda8c7b7be728b14852320222243f962dcc02cf8e194b85689 prometeu-animation/src/test/java/p/animation/AnimationContractTest.java
843a4dfb03afa46905642c5055171606b65e46937d5bc428d503838f7827ab20 prometeu-app/build.gradle.kts
3cd71fdfcf8dfddf60eacca7b0caff08795ff00b55f7da80d400c57b4dc30ae2 prometeu-app/src/main/java/p/studio/app/StudioApplicationConfiguration.java
954626f88beaed539a60be0f9142b4e85ab14106a6baa42abccaefb7756c5352 prometeu-app/src/main/java/p/studio/app/StudioUiFactory.java
a320b60885537e917bef66e34ed3cedea53fa1d1580d05fc38d0e9480f1d91a3 prometeu-app/src/main/java/p/studio/app/assets/PackerGlyphBankLayouts.java
b1692849f2af66faea261e4cc7e5b68baa15919811a29fb9092971389ad9ac1a prometeu-app/src/main/java/p/studio/app/compiler/CompilerBuildGatewayAdapter.java
0c258a15eb3f34aafed92d96a6a9fdf0e2356752836972c21248a8b3b2d1cb28 prometeu-app/src/main/java/p/studio/app/compiler/CompilerProjectKnowledge.java
919e7bcbfaf98f2027291475afc39dc68e7e9b2a086edcfb3bc75f5866e94153 prometeu-app/src/main/java/p/studio/app/mcp/ContractSchema.java
ed0975206ea18373f6e5f436d7f714c96e93bd728f941fc3548cd7739f5a0486 prometeu-app/src/main/java/p/studio/app/mcp/McpAnimationTools.java
86c74b1c1ea5bb74bfc032ff1bebede93e79770d0edb5e1e598856816b9b5d64 prometeu-app/src/main/resources/mcp/studio-tools-v1.json
4c6231869b9fec9827fa0cf8dcc08a9b45c4497268d57f98fcafd91da5865310 prometeu-app/src/test/java/p/studio/app/StudioApplicationConfigurationTest.java
d696dbf3b86e0dfbb49aaf750d7fd31462d4cba8cba903c5fb9de0016121ec4d prometeu-app/src/test/java/p/studio/app/animation/AnimationDesktopTest.java
1ffbcb740b830a066f4ecb7a89ad780aee9c3bd96a33965eeb9b1947c4b2be67 prometeu-app/src/test/java/p/studio/app/animation/AnimationInstalledProbe.java
61cdc1867697dfe339c4e907f1bfec5873d1a71d93f2297c69994025d3db9d4c prometeu-app/src/test/java/p/studio/app/animation/AnimationInstalledRuntimeTest.java
56af831e13d28c8c59d4deb6d21fedef9d8225d96e6748bc56a3e8c98b51b82e prometeu-app/src/test/java/p/studio/app/animation/AnimationIntegrationTest.java
f96ec4cac9d2d4f033ac4449679dae1582f0980b9755b833999641d815cb18f5 prometeu-app/src/test/java/p/studio/app/animation/AnimationProjectFixture.java
4a66af119ed6d27f6acf05746770aa78cd522aea15b8a0adce303fea5fbe8f69 prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java
c22b0666b7dbda7bb1aedc2688fe35e447a05008aa0726cabee70741b8c4e02c prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeTest.java
e4a5d6062e3436dad94907cf3afa1b6c569283858c71354d0e1aff19f444c627 prometeu-app/src/test/java/p/studio/app/mcp/McpContractTest.java
631f454efb56a75ec39b7ea2c99cf48cb32bf12a7b73f25f397915ae20438697 prometeu-app/src/test/java/p/studio/app/mcp/stdio/StudioMcpStdioTest.java
dad477da094986d9157eaf305f1bf9e15a3cac82ecdcdedabc83074bd5305303 prometeu-architecture-tests/src/test/java/p/studio/architecture/StudioBoundaryArchTest.java
9d4fc89ca4817842ae795e9515e8836e95b99c508e2e3b5fb8c9f3a61e51229f prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsResultTest.java
018a70ad1fa3edaa971c760937e258fddac8c6ae1a36c9b55575186327f357fc prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsRuntimeAlignmentTest.java
2a9b6e71c29729060615c10a99acc85496f9920c3bee3017fb184a61bd93961c prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSpriteAnimationTest.java
f328dccad9f040c84d769cdeffa5d8783b78e86664a4187ff5c23c7cf81b7978 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/PBSFrontendLanguageService.java
ff57258886cff5b367fdb78ee9518188aa98daffd7d6af44536757d3ccfb7b8f prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsCallableSlotCounter.java
4365be38ea866eced4606fbcf53e61992355f6bbdd8398b5418a01b2e68b464c prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsStdlibConstruction.java
bae95724d6b31f5367e6bd9ca96a7da1805be8141d30d506686e7f9a988b0bbb prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/ast/PbsAst.java
73954236ba33bcbbdecf5f8f8b6c45dab8a7dd2488e032abd34a3c12cb0a659b prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/ast/PbsAstRewriter.java
0985dcd45f200a0eb24da602827482f90499f790dcaa52719dc769da3893f71d prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java
d37d6e6cea1090e90913689f28db54cb0cf24e497fc3663c7ea2dc64f6f3ee4e prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableLoweringContext.java
73f8bf2d22a11191f43c51691d820a606e48c0c0f4fc746ec8ebefec71bbc0f3 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableLoweringService.java
c64c11ffce06554da57861c373f81897739c9f93b05c8f8559e292b19d1233b5 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableStackAnalyzer.java
ce9ad71e884ad106719ddbbe1db99f183b8fba75db237af08e089e280fd2401f prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsRuntimeTypes.java
5c6777b8d57027b18f3c19133628335af3a76008f629b9e3b44b8e5fa9bd47c5 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java
b5cc039430efbfacdc3720f72495bb661e50d195fb520cbf6dab31445147c9a4 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java
061c248e8de616e3ce8412b76930744248b1fd36e59454a05b91185bc27be7df prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java
d35633448a3023f837c743d2c96cfc0ccb1df23f2956d0d5934dc1824c686fc6 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowStructuralExpressionAnalyzer.java
b65b02effea05dd9a10b32a9a03c9843a92c1ada9902ad19b14e0de7222cbb14 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/services/PbsAnimationProjection.java
6965b8325f0b7da1a83f7581984b34ea00671d66085d3210488fb672941e390f prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/services/PbsImportedSemanticContextService.java
4429e1dc0dfb27e1aa145011683c589b1a3f4502be1223ef03aa8b2cddc28f65 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/services/PbsModuleAssemblyService.java
5907731d1a10036d50021fe8263c2e8f9f2b79d0fddfb9a70b2d8449b42aecbc prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/core/animation/main.pbs
36e78b0dafd0a4e5f4b63499a5f197870d9abaa5a2c02364339ffde3a87c3862 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/core/animation/mod.barrel
61b530fa321c3e69983c8c6e0a48503534a280a9d4b266cd1b62a5fe54d9d382 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/core/sprite/main.pbs
29c4ffff336a54ab874ed8dce996ebd877f7b3145cdf5844836bff9a2f3757f8 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/core/sprite/mod.barrel
c92f3ab13a0cd2cb2e2adba7b236ce1282b89733d3dde0b1e396da950a7b7552 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/composer/main.pbs
639beb705a61799351f22109b5356520498824f326ab1af1fd711daef4cdf641 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/ANIMATION.md
2567aca3b9e0a733871c2f736c7f0a4ce43415cf5b43dddfaf93963cd6db19c6 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/animation.pbs
be65d777f43e82312d565816442bbb565dd00c6005c606a11ced58dbe6dc6f97 prometeu-compiler/prometeu-build-pipeline/build.gradle.kts
f4ec6a28525d2493d6d160409437016bf8973cc2cc01a6fe072a364fe50c29c3 prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/models/BuilderPipelineContext.java
8d6e05a68ebb707442356b9b2975d80a412b6993fe62789c6cbbbc9243e732a3 prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/workspaces/AssetSurfaceContextLoader.java
c9a0ee7309b022c872346a8d7125ac6d24fa77778b9ae2dbfbca003caf6d8213 prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/workspaces/stages/FrontendPhasePipelineStage.java
9a76574ee95514c0bd69d1468f55216984dd57210efc2677798dfbb899f53b81 prometeu-compiler/prometeu-frontend-api/build.gradle.kts
bf4e92a43215d760967e476bf899d0cf9f42ab26ba74c0a4bcb40f22248c8788 prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/messages/FESurfaceContext.java
bc7d38ec152c1ff250d45d3eeab1b00fe9a9c83fc384599e0f9c0a161c654863 prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/services/FrontendSourceDocument.java
6ec24293d82e3606663acf993106a6275094c47be0da28d720762700a56373cf prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/LspServerLifecycleImpl.java
9bf8484492e08ff3f4839d7e8022e3737d85a2e663987187c86235406eba8ac5 prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/compiler/CompilerLanguageServiceBridge.java
2f391046cc51604d00a1876cdc99495421d9893a324bd8b2c28edf5d59853a9c prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/compiler/ExternalSourceRegistry.java
ec8702d093e5845b47312b65cab4421a632f9c57f075843e22570c91fff2365d prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/protocol/ExternalSourceLanguageServer.java
82fa22592d2a24a79745f08aae456682994a2994ad2957c66d5ac2d51cfd3d44 prometeu-lsp/prometeu-lsp-v1/src/main/java/p/studio/lsp/services/protocol/PrometeuLanguageServer.java
404b12a9131b6aa1607cec4c81bda55e8a403db329494f1e9a386247d4236027 prometeu-lsp/prometeu-lsp-v1/src/test/java/p/studio/lsp/services/compiler/ExternalSourceRegistryTest.java
13079954d52a51b77880ee5988349323eb427b09001f47d1a48f0fa7532aa0c6 prometeu-packer/prometeu-packer-api/src/main/java/p/packer/PackerWorkspaceService.java
c35b1ea511199fc91dab4a7401e37d8a91c0a7debcdfe2b516194fae26ffadb1 prometeu-packer/prometeu-packer-api/src/main/java/p/packer/dtos/PackerGlyphBankLayoutDTO.java
d2659d7d9627557e907dd8e77d490c63ea72f2b3e33252601b43c66be78b953a prometeu-packer/prometeu-packer-api/src/main/java/p/packer/messages/GetGlyphBankLayoutRequest.java
8b686dd77199cf275ced2101c6351bec4876ec1dfc0dbf723d3c826e68d9a1b4 prometeu-packer/prometeu-packer-v1/src/main/java/p/packer/repositories/PackerAbstractBankWalker.java
276d878ce8e864e4d3badbc54bae754935d7ff565f72b150d76b34be443e0a22 prometeu-packer/prometeu-packer-v1/src/main/java/p/packer/services/FileSystemPackerWorkspaceService.java
af1a00db5a065f178fe3f09c487cc8e7f5bfe3da20162ea4584740e1e090a3ce prometeu-studio-api/build.gradle.kts
c9570929f5b3b7e99a42ba7f1784f763a4f35c9896bd3998385a3a3a1e8562fd prometeu-studio-api/src/main/java/p/studio/api/assets/AssetSummary.java
5581216eb1e3fbc09651120b889f75ec6619e6f4b0489bb0f6dfdd91794d0347 prometeu-studio-api/src/main/java/p/studio/api/assets/animation/AnimationService.java
fc5542118b270ada7c6ea383187028af87920192d7358b6a011adddf114c3af2 prometeu-studio-api/src/main/java/p/studio/api/assets/animation/AnimationTasks.java
4435e427529b0a7ebef4e98dc870e7598ec5d647578b9c3cecfcee2a717bada8 prometeu-studio-api/src/main/java/p/studio/api/assets/workspace/AssetWorkspaceAssetSummary.java
a8e67f1a3877be23f59c191eb40fbb2036088e53836e8dc13c2c99a43778fdf8 prometeu-studio-api/src/main/java/p/studio/api/automation/AutomationFailure.java
455af9c0f133ab62a70f30758208afd337a202c7a92b8c4064cc1c977ecd39a8 prometeu-studio-core/src/main/java/p/studio/core/assets/AnimationOperations.java
4e3db0ca8c1b47ac2f8d253188fb93a7d3c6fdccf8f755ab898b3f41181c27f6 prometeu-studio-core/src/main/java/p/studio/core/assets/PackerAssetCatalog.java
7cd160b03ca0ef1892ed1c8ac1713ab541a4691bdc66680514907ecb0b260ea4 prometeu-studio-core/src/main/java/p/studio/core/assets/PackerAssetDetails.java
420a53d8a86c6e3e2d66022f03a616396fa863e2632be4346d470d9808d4e17f prometeu-studio-core/src/main/java/p/studio/core/assets/animation/AnimationPreviewRenderer.java
f19f1fb878eeeb5b4167602520042e271f9102c0aef796e7ffe0c5590d88f52a prometeu-studio-core/src/main/java/p/studio/core/assets/animation/DefaultAnimationService.java
aaddecc065e53d8942e594cc2e3efe969988084aa7ca30906acfa5f730359c08 prometeu-studio-core/src/main/java/p/studio/core/assets/animation/ManualAnimationService.java
678c32d2cbd9f7d4a31737263fa1f2e56c7bfe4b83e168d9a79448a4c7906761 prometeu-studio-core/src/main/java/p/studio/core/session/TaskAnimationService.java
cb5fa3bd1d1384145e0cba59bdf18ad8f288949526ec6d00936089ba5a695a0b prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/events/StudioAnimationOriginRequestedEvent.java
a06eaf5fdf327388ca00073e33deb7751bd97a766161d594d51c7180799f5e04 prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/MainView.java
0f928aaf0e3d6cdc5224e7373ef3afa951d810ee8803b0632d07c56fd997d7ca prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/window/StudioWindowCoordinator.java
be51cd5bb0e91986578d4a33c510f1728f66f31011f89ce43c05963f9c5239c1 prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/AssetWorkspace.java
b95ec37e9554f5fc4f6d48dc5cb13357b36cdc476341898c69ed3ac78d5babd5 prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetDetailsControl.java
bdbb2d8fcab150c398da0a41dec219f97f6b4329d5676b15e01ad3cf8ae6080a prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/AssetListMappings.java
4701d71fc568480a3c204d117a321cd1e398d4b29bdcc4b498396bbe9343d288 prometeu-studio-ui-javafx/src/main/java/p/studio/ui/javafx/workspaces/assets/details/animation/AnimationEditorControl.java
0242e87b38301dcd768b604747c368893317b3efe228f5125c821bba933b5e47 settings.gradle.kts
625305ac75a2319dd3a1cee9db450bbeb31a60d85a35b9fc03afbd0ad3441e60 tools/pbx-conformance/README.md
6c1b543960bd0ecabcd4cf89ef3cb6646df2b909cb2cf9e6965c59225a0e1a3f tools/pbx-conformance/animation.rs
51bbebb411078bf4d8336e28d35e438aba49c47deebb3ffbd55859fbda80c432 tools/pbx-conformance/main.rs
7829e50105fc9bc3ced056aa8a34714a644908483532f154a437fa41928122ab tools/pbx-conformance/result.rs
29a6623d2ba1ff3d3e1b0017a2fc10cbb790dfc7126dabf999c75250d9d9ce30 tools/pbx-conformance/run.py
ff7669746d0cb7167a84e3e383d3570968888bbedde812a79a6aaefac2a74f7e tools/vscode-extension/out/extension.js
2ba64626f79b7fe8abeb260ce8572dfd8bb1f4dfcbe8c65e5eaf2e512fecbfe7 tools/vscode-extension/out/externalSources.js
b4a1e93075da5bb89d37d5196110a4aa0ce9070f55692827eef70e9d6d9d01d1 tools/vscode-extension/package.json
2e7babd6f2272c0f96aa3d65bf4bf940dd6e2a4e5cd91f149d7d17ef40b22039 tools/vscode-extension/src/extension.ts
3fec63d03afe610d4a5d0eb7c9ff5758af5bec076d4cd01adbb8da6ba1f0fbec tools/vscode-extension/src/externalSources.ts
@@ -0,0 +1,18 @@
$ discussion mark-plan PLN-0162 done
marked plan PLN-0162 done for DSC-0098
$ discussion housekeep DSC-0098 --lesson discussion/lessons/DSC-0098-pbs-core-sprite-animation/LSN-0100-sprite-animation-and-shared-authoring.md
housekept DSC-0098
removed workflow artifacts: 3
registered lesson: LSN-0100
$ discussion validate
validation passed
$ discussion inspect DSC-0098
DSC-0098 done pbs-core-sprite-animation
PBS Core Sprite and Animation
tags: compiler, pbs, core, stdlib, sprites, animation
lessons:
- LSN-0100 done exists /Users/niltonconstantino/personal/workspace.personal/intrepid/prometeu/studio/discussion/lessons/DSC-0098-pbs-core-sprite-animation/LSN-0100-sprite-animation-and-shared-authoring.md