BS-PR-707 - Production-readiness acceptance gate and release checklist #50
Open
opened 2026-07-10 04:04:47 -04:00 by Rbanh
·
17 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
M7 - Content production and shipping
Projects
Clear projects
No projects
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Falling-Metal-Interactive/Blacksite#50
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
Define and execute the objective gate for calling Blacksite production-ready for an indie game team.
Exit gate
Deliverables
Rbanh referenced this issue2026-07-11 18:49:46 -04:00
Production-gate audit checkpoint
A current versioned acceptance matrix is now drafted locally at:
docs/editor/evaluations/production-readiness/README.mdThe historical H1-H6 sign-off files are being marked as historical baselines rather than current production evidence. Several contain pending CI/manual checks or waivers and therefore cannot satisfy this gate.
Current result: Not ready
Matrix additions
The draft matrix includes:
A corresponding working plan is drafted at
.cursor/plans/production_readiness_acceptance_2026-07-12.plan.md.This comment records the live audit only. The matrix files are not yet committed/pushed, no release-candidate commit is nominated, and this issue remains open.
Matrix published and main source gate green
The production-readiness matrix and execution plan are now published on main:
f2ad88ff2ad88f3931de1The exact integrated tree passes formatting, full workspace check, strict workspace Clippy, the dev/hot-reload launch-feature Clippy matrix, full workspace tests, content validation with 0 blocking findings, and the navigation artifact check.
This is strong integrated source evidence, but it is not represented as a clean-checkout candidate pass: no release candidate is nominated, packaged testing remains owner-deferred, and G2/G4/G5/G6/G7/G8 still have the blockers recorded in the matrix. Overall status remains Not ready.
Material workflow gate advanced on integrated main
Main is now fast-forwarded and published at
3794faa.This closes two previously recorded P0 workflow blockers:
The integrated tree passed workspace all-target check, strict workspace Clippy, all workspace tests, strict editor Clippy for both
devandhot-reload, level validation with 0 blockers, navigation freshness, and live Wayland preview/commit/undo/cancel QA. The same live relaunch produced no hydration hierarchy warnings.The target cache reached 212 GiB during the matrix; the documented safe cleanup reclaimed 51.4 GiB of incremental cache, leaving 44 GiB free. The three-day deep scan found no stale hashed artifacts.
Gate effect
Overall production status remains Not ready: no release candidate is nominated, G4 soak, G5 measured budgets, G6 clean-checkout evidence, G7 independent sign-off, and remaining workflow/limitation work are still outstanding. Packaged testing remains explicitly deferred and is not claimed.
Governance gate cleanup
#35 is now closed after an evidence-backed M0-M7 milestone and documentation audit (comment 928). No partial capability ticket was closed during that audit.
Open P0 capability/quality work is now #51, #33, and #32; #1 and this issue remain open as roadmap/gate trackers. This improves G8 bookkeeping but does not change the overall Not ready result.
Roadmap update: #49 is now closed with live native-Wayland acceptance and evidence commit
61be244integrated onmain. M7 now has only this production-readiness gate open. Packaged acceptance remains intentionally deferred; the newly observed synchronous native-file-dialog stall is being addressed next before claiming readiness.Production-readiness update: native-dialog responsiveness #52 is closed and integrated on
mainatba59f57.The real KDE portal Open dialog was held for 12 seconds under native Wayland; Blacksite remained mapped, visible, input-capable, and responsive in Hyprland with no application-not-responding client. All native picker/confirmation constructions now run through the shared broker, with two focused lifecycle/frame-progress tests and full source-only verification green.
Packaged acceptance remains deferred by project-owner direction, so this gate remains open for its remaining release-candidate evidence.
Production-readiness update: terrain foundation #22 is closed and integrated on
mainated21bcc.Blacksite now has a first-class versioned
TerrainDesc, deterministic runtime-only render/collider chunks, registry/inspector/history integration, strict validation, and a committed terrain regression fixture. Full source-only verification passed with 60 dependencies and zero project-validation blockers.G2 remains blocked on terrain sculpting/layers #23/#24 and physics placement #25. Foundation terrain is raster-visible and deliberately excluded from Solari until exact terrain layer/Surface parity lands in #24; no black or semantically mismatched ray proxy is claimed.
Terrain production workflow update: #23 is accepted and closed in
293811a.The representative terrain fixture now has modal Raise/Lower/Flatten/Smooth/Noise tools, exact cancel restoration, one history transaction per stroke, terrain-following visual feedback, exclusive viewport input ownership, and no transform-gizmo overlap. Full workspace source gates, content validation, navigation freshness, and native Wayland acceptance pass. Evaluation record.
Packaged acceptance remains deferred by owner direction. Terrain material layers/weight painting (#24), broader representative workflow signoff, performance budgets, soak, clean-checkout CI, and independent first-hour QA remain open, so the production gate stays open.
Production-readiness update: terrain material layers and weight painting (#24) are complete and integrated on
mainatd1a56f7.The pass added compact normalized four-channel persistence, revision-aware blended PBR hydration, inspector assignment/reorder/tiling, modal Paint/Erase with exact cancel and grouped history, and fixed reflected list-snapshot restore plus an invalid material-extension prepass override found during live QA. Full source gates and native Wayland acceptance passed; packaged tests remain intentionally skipped per current direction.
Physics placement acceptance is complete and #25 is closed on
mainat 0e7aed4.The production-readiness matrix now records the workflow as source/live pass. Evidence covers deterministic Avian settle, exact cancel restoration, one-command commit/undo/redo, missing-prerequisite diagnostics, scene-switch lifecycle safety, a committed fixture, and a native Gitea screenshot attachment. Full workspace tests and all-target Clippy are green; level validation reports 0 blocking errors. Packaged verification remains explicitly deferred and is not being counted as release signoff.
Collider authoring/diagnostics (#26) is source/live accepted and M3 is now closed at 0ce43fc.
The production matrix now records collider authoring as pass: scaled primitive overlays, cooked mesh bounds, semantic ready/trigger/disabled/warning/invalid states, selectable missing/stale/invalid/oversized findings, undoable shape switching, and shared physics-placement preflight were verified in the native Wayland editor. Full workspace tests, all-target Clippy, formatting, and 62-dependency project validation are green with 0 blocking errors. Packaged acceptance remains owner-deferred and is not counted as release signoff.
Production-gate update: renderer/material foundation #51 is closed, removing it from the open P0 list.
The repository now explicitly records #53 as a P1 property-block runtime/promotion feature and #54 as a P2 deformed-Solari limitation with raster/Forward fallback. The remaining gate-relevant P0 implementation items are #32 (sample/regression pack) and #33 (tool regression/undo invariants); brush acceptance #37 still blocks G2 signoff. Commit: 9a67a25.
BS-JD-502 / #33 is complete on
mainat1ab3886. The production operator contract now covers stable terminal status, exact failure/cancel/no-op rollback, helper cleanup, atomic grouping/lighting, modal command ownership, read-only CSG, terrain/physics interruptions, and repeated semantic undo/redo. Full workspace tests, strict all-target Clippy, format/diff checks, and level validation passed. G3 is source-complete but remains Partial until the nominated release candidate is rerun from a clean checkout. The remaining open P0 implementation blocker is #32 (sample scenes and regression pack).Acceptance-gate update:
The deterministic five-area sample project is now implemented, source-gated, and natively accepted on exact implementation commit
d52cc2e; evidence is merged tomainat62b5389. See #32 comment 1057 for direct PNG attachments and interaction results, and comment 1058 for final source gates.The production matrix is v0.4:
No production-ready claim is being made yet. Packaged tests remain owner-deferred.
Gate checkpoint at
a048233fceab86649f8c1004137a59f0cd62ac12:Accordingly this issue remains open and Blacksite is not yet production-ready.
Production-readiness checkpoint: #56 complete
mainis published at7e99243a78ee99207763ec92e80bcf6dd03f7151; deterministic imported-asset fingerprints #56 are closed.Feature-level evidence now includes a fresh detached LFS-hydrated checkout, native editor startup/asset scan, exact artifact hashes, live mtime-only drift, both headless validators, workspace tests, strict clippy, and ordinary Gitea screenshot attachments. The authoritative matrix is version 0.6 at
docs/editor/evaluations/production-readiness/README.md.Production readiness remains Not ready. No release candidate is nominated; eight-hour soak evidence, performance budgets, exact-candidate CI/content reruns, consolidated limitations, brush #37, and independent first-hour sign-off remain. Packaged acceptance is still explicitly owner-deferred and is not claimed.
Native #56 QA also found missing external textures and duplicate load errors for the committed painted-chair FBX. That independent P1 asset-pipeline defect is tracked in #58.
Production-readiness checkpoint: #58 complete
mainis published at931f561e7ff1489f897e22ebb3cc7545fcfef702; P1 external FBX texture dependency handling #58 is closed.Feature-level evidence now covers sandboxed path resolution, transactional sidecar publication and rollback, read-only preflight validation, stable Asset Browser dependency states, ordinary inline Gitea PNG attachments, a normalized committed chair, and a deliberately broken exact-commit native fixture. The authoritative matrix is version 0.7 at
docs/editor/evaluations/production-readiness/README.md.Production readiness remains Not ready. No release candidate is nominated. The M1 brush signoff #37 and P1 material property-block workflow #53 remain open, along with the consolidated release-candidate reruns, eight-hour soak, measured performance budgets, limitations ledger, and independent first-hour signoff required by this gate. Packaged acceptance remains explicitly owner-deferred.