BS-JD-220 - Modular Editor UI Architecture and Debt Ratchet #68
Closed
opened 2026-07-15 01:06:00 -04:00 by Rbanh
·
5 comments
No Branch/Tag Specified
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
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#68
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.
Goal
Finish M2 with a scalable editor UI architecture and an automated debt ratchet while preserving the live-material correctness owned by #67.
Scope
EditorComponentRegistrythe sole built-in Inspector card dispatcher; remove hard-coded component-type dispatch..codexarchitecture policy andscripts/codex/architecture_audit.pywith deterministic ratchet and exception self-tests.Architecture budgets
Acceptance criteria
Ownership boundary
#67 remains the authority for live material state, explicit source saving, conditional derived processing, conflicts, recovery, and responsiveness. This issue owns the modular editor architecture and permanent debt ratchet needed for M2 signoff.
Child of #59 and required by #65 before M2 closure. Visual QA remains user-owned. No issue closure or milestone closure occurs before acceptance and explicit publication approval.
Candidate-ready — commit
cf6eabaThe current Penpot boards are now exported with the candidate and are the pinned visual acceptance source for this issue: design export index.
Required Inspector matches
The Inspector and Content Browser shells meet the architecture ratchet; built-in cards dispatch through the component registry; primitive/static/skinned Material slots share the same action-returning UI. Focused geometry/containment/resize tests, strict candidate lint, architecture audit, and native wide/narrow interaction acceptance pass. The Penpot CODEGEN MAP remains documentation-only and is not rendered.
Acceptance reopened — visual proof incomplete
The prior closure was premature. Exported Penpot targets and automated geometry tests do not by themselves prove current native 1:1 conformance. Fresh implemented-UI captures were not attached beside each authoritative design target, and the latest user review identifies remaining visible Inspector work.
This item is reopened. Acceptance now requires current side-by-side design/implementation evidence for the applicable 620 px and 420 px Material layouts, shared component headers, Static Mesh Renderer compositions, material states, and color overlays. Each observed delta must be recorded and resolved before this item can return to Candidate-ready or Closed.
Mainline publication checkpoint — commit
53dc1e4The current implementation and exported design evidence are now published on
mainat53dc1e44d861c9ff85c6d63b328d95bd5042eea4.The exact published tree passes the architecture audit, formatting, full workspace/all-feature tests, strict all-target/all-feature Clippy,
process-assets --check, level/sample validation, QA packaging, and documentation audit. The generated runtime catalog was refreshed before the final candidate run, and publication readback confirmsorigin/mainresolves the exact commit.This is a mainline evidence checkpoint only. The reopened visual-acceptance requirement remains in force: #68, #65, #59, and M2 stay open until the required current side-by-side Penpot/native evidence is reviewed and accepted.
Acceptance-in-progress — Penpot Page 03 Content Browser refinement
The current Penpot 03 — Content Browser · Workspace boards are now the visual source of truth for this issue in addition to the Inspector/Foundation exports already pinned above.
Required Content Browser matches
Blacksite Editor / Content Browser / Wide(e755994a-6c1d-80bd-8008-58e2e8668f78): 1240×650 standalone reference; 36 px title row mapped to the production dock tab, 88 px toolbar, 216 px Sources, flexible asset grid, 290 px Details, and 32 px status footer.Blacksite Editor / Content Browser / Compact(e755994a-6c1d-80bd-8008-58e2e8dbf894): 620×650 reference; grid-only default, explicit mutually-exclusive Sources/Details access, preserved navigation/search/grid-list controls, Import/New on the breadcrumb row, and no clipped actions.Fresh PNG exports are now present in the local candidate worktree as:
docs/editor/evaluations/content-workspace-m2/penpot/content-browser-wide-1240.pngdocs/editor/evaluations/content-workspace-m2/penpot/content-browser-compact-620.pngThe production slice maps the same shared chrome into the docked editor, renames the tab to Content Browser, implements wide Sources/grid/Details and compact grid/Sources/Details states, and adds catalog/processing/selection status. Managed architecture/format/check/strict-lint gates pass. Direct native QA passed wide, compact, Sources/Details toggle isolation, and a repeated 1200×760 ↔ 1800×1100 resize sweep without the prior crash/freeze.
This remains Acceptance-in-progress on a dirty worktree. The export links will be made immutable only when the exact candidate is published; this comment does not nominate, close, or publish the issue.
Closed — verified main candidate
634ec16Accepted against
634ec16c5e627d598aaccf130974224ba76b0e13, now published on bothmainandcodex/m2-content-workspace.Closure evidence:
This closes #68 only; consolidated milestone signoff proceeds through #65 next.