BS-PR-707 - Production-readiness acceptance gate and release checklist #50
Labels
No Label
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
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Falling-Metal-Interactive/Blacksite#50
Loading…
Reference in New Issue
Block a user
No description provided.
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
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.