BS-JD-209 - Deterministic imported-asset fingerprints #56
Closed
opened 2026-07-13 01:00:50 -04:00 by Rbanh
·
1 comment
main
Clear current reference
main
codex/m2-content-workspace
codex/fbx-external-textures
codex/deterministic-asset-fingerprints
codex/guarded-shutdown-savepoints
codex/sample-regression-pack
codex/operator-invariants-completion
codex/renderer-foundation-acceptance
codex/collider-diagnostics
codex/physics-placement
codex/terrain-material-layers
codex/terrain-sculpt-strokes
codex/terrain-foundation
codex/non-blocking-native-dialogs
codex/collaboration-live-acceptance
codex/material-library-targeted-drop
codex/source-control-collaboration-safety
codex/renderer-material-component-foundation
Clear current reference
No results found.
Labels
Clear labels
area:animation
area:assets
area:audio
area:brushes
area:build-release
area:extensions
area:governance
area:hierarchy
area:inspector
area:navigation
area:operators
area:physics
area:project-ux
area:quality
area:rendering
area:runtime
area:scene-io
area:terrain
area:viewport
priority:P0
priority:P1
priority:P2
priority:P3
roadmap:jackdaw
roadmap:production
type:architecture
type:docs
type:epic
type:feature
Skeletal animation import, preview, graph/state authoring, and runtime integration.
Asset browser, material browser, thumbnails, import, processing, and asset watcher.
Audio source/listener authoring, buses, spatial preview, and runtime integration.
Brush geometry, CSG, face editing, UVs, and brush diagnostics.
Build profiles, packaging, content validation, release gates, and distribution diagnostics.
Static extension API, extension scaffolds, dylib exploration.
Policy, attribution, planning, and production process.
Outliner hierarchy, parenting, grouping, prefab structure, ordering, and selection workflows.
Inspector, component metadata, component editing UX.
Navigation mesh authoring, baking, diagnostics, and AI path preview.
Editor operator/action framework, undo, commit/cancel semantics.
Physics placement, colliders, rigid bodies, diagnostics, and overlays.
Project launcher, profiles, templates, or first-run project workflow.
Regression packs, tests, performance budgets, profiler, first-hour UX.
Static and skinned renderers, material slots, shaders, ray tracing, and render-path integration.
BRP, remote inspector, PIE, game preview, runtime integration.
Scene document, save/load, schema, migration, or reference repair.
Terrain authoring, terrain sculpting, heightmaps, and terrain materials.
Viewport interaction, selection, shortcuts, camera, overlays, and controls.
Must-have prerequisite or milestone-critical item.
Important production feature after P0 work is stable.
Useful follow-up or polish item.
Exploratory or later spike.
Jackdaw-inspired Blacksite editor roadmap item.
Blacksite production-readiness roadmap item beyond the Jackdaw-inspired foundation.
Architecture, internal framework, or hard-to-reverse technical decision.
Documentation, policy, samples, or issue-board structure.
Tracking epic that groups related milestone work.
User-visible feature or capability.
Milestone
No items
No Milestone
M2 - Content workspace and asset pipeline
Projects
Clear projects
No projects
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Falling-Metal-Interactive/Blacksite#56
Reference in new issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Summary
Make imported-asset fingerprints and generated manifests deterministic so launching the editor or running validators does not dirty a clean checkout when source bytes are unchanged.
Why
Native #33 QA repeatedly rewrote the generated animation/static-mesh manifests for
RobotExpressive.glbsolely because the checkout/source mtime differed from persistedmodified_unix_secs. The content hash and byte length were unchanged. Later validation also normalized only the final newline. These changes are repository noise, obscure intentional edits, and make clean-checkout release evidence unreliable.Git does not preserve source mtimes, so persisting checkout timestamps as semantic identity cannot be stable across contributors or CI.
Implementation notes
Acceptance criteria
cargo validate-levels, andcargo validate-samples.Docs/tests
The content-addressed contract is owned by ADR 0043, integrated with ADRs 0017/0028, and enforced by the post-validator clean-worktree CI assertion.
Evidence
Acceptance complete
Published to
mainat7e99243a78ee99207763ec92e80bcf6dd03f7151.Implementation commits:
e1b2f86a495496da83947777d332d00a15a1779d- shared content-addressed fingerprints, registry/manifests, validators, CI cleanliness assertion, migration, tests, and ADR 0043.cbd380a9413411667a83f74b66c5a2feda5e1af7- normalized registry publication order plus discovery-order regression coverage.7e99243a78ee99207763ec92e80bcf6dd03f7151- exact acceptance record, roadmap, debt audit, and production-readiness matrix 0.6.Verification:
cargo fmt --all -- --checkcargo clippy --workspace --all-targets -- -D warningscargo test --workspace --all-targets --no-fail-fast(editor 300 passed; scene 100 passed plus one ignored manual migration; shared 99 passed; all workspace targets green)cargo validate-levels --project .(81 dependencies, five known nonblocking findings, zero blocking)cargo validate-samples --project .(five samples, 86 dependencies, the same five nonblocking findings, zero blocking)touchofRobotExpressive.glbproduced no Git or generated-artifact diff; the original nanosecond timestamp was restored.Evidence:
docs/editor/evaluations/deterministic-asset-fingerprints/Packaged acceptance remains explicitly owner-deferred and is not claimed. Native QA separately exposed missing external painted-chair FBX textures; that independent defect is tracked in #58. Production readiness remains Not ready under #50.
mainto mainmainto main