BS-PR-705 - Navigation mesh authoring, bake diagnostics, and path preview #48

New Issue

Rbanh · 2026-07-10T04:04:46-04:00

Rbanh commented

2026-07-10 04:04:46 -04:00

Summary

Provide a practical navigation workflow for AI-driven indie game levels.

Scope

Authored navigation bounds, areas, links, obstacles, and agent profiles.
Deterministic bake command with dirty-region or debounced rebuild behavior.
Viewport mesh overlay, isolated-area warnings, and start/end path preview.
Saved bake artifact with source fingerprint and stale-state detection.
Runtime query API owned outside editor UI.

Acceptance criteria

A level designer can define bounds, bake, inspect, and path-test navigation.
Geometry changes mark only affected navigation data stale where practical.
Invalid links, unreachable samples, and bake failures are actionable.
Bake artifacts never serialize helper visualizers.
Headless bake/validation and sample-level coverage ship.

## Summary Provide a practical navigation workflow for AI-driven indie game levels. ## Scope - Authored navigation bounds, areas, links, obstacles, and agent profiles. - Deterministic bake command with dirty-region or debounced rebuild behavior. - Viewport mesh overlay, isolated-area warnings, and start/end path preview. - Saved bake artifact with source fingerprint and stale-state detection. - Runtime query API owned outside editor UI. ## Acceptance criteria - [ ] A level designer can define bounds, bake, inspect, and path-test navigation. - [ ] Geometry changes mark only affected navigation data stale where practical. - [ ] Invalid links, unreachable samples, and bake failures are actionable. - [ ] Bake artifacts never serialize helper visualizers. - [ ] Headless bake/validation and sample-level coverage ship.

navigation-authoring-overview.png

357 KiB

navigation-path-preview.png

356 KiB

Rbanh added this to the M7 - Content production and shipping milestone 2026-07-10 04:04:46 -04:00

Rbanh added the

labels 2026-07-10 04:04:46 -04:00

Rbanh referenced this issue

2026-07-10 04:05:27 -04:00

BS-JD-ROADMAP - Jackdaw-inspired editor production roadmap #1

Rbanh commented

2026-07-12 02:54:43 -04:00

Published acceptance — `b4aa61e`

Navigation authoring is implemented, verified, and pushed on codex/renderer-material-component-foundation.

Acceptance evidence

Designer flow: typed bounds/obstacle/area/link actors, complete agent controls, deterministic Bake, truthful overlay, Test Path, and persisted named validation samples.
Live debug editor: selected artifact loaded current; query returned an 8.20 m, six-waypoint route through navigation-link-center; editor rebake produced 26 polygons; pinning a second sample immediately marked the artifact stale and disabled path testing; undo restored the current one-sample state.
Source fidelity: the active unsaved snapshot, visible subscenes, recursive prefab sources, navigation-relevant overrides, and exact affine transforms resolve through one shared path. Bounds never synthesize a floor.
Diagnostics/integrity: duplicate artifact owners, invalid agents/grid budgets/links/samples, prefab drift/structure, empty bakes, tampering, and deterministic content mismatch are owner-attributed with repair guidance.
Runtime parity: one height-aware multi-link Polyanya query core drives editor preview, game Vec3 adaptation, project validation, and the renderer-free validation command.
Serialization: baked artifacts contain only versioned runtime data; viewport meshes, routes, endpoints, visualizers, and editor caches remain transient.

Verification

Affected source matrix: 390 passed; 1 intentional manual migration test ignored.
Strict clippy -D warnings: passed for shared, scene, game, editor, and xtask all targets.
cargo bake-navigation --project . --check: 1 deterministic artifact current.
cargo validate-levels: 59 dependencies, 5 non-blocking findings, 0 blocking errors.
Formatting, staged diff checks, LFS upload, and remote commit verification: passed.

Packaged/release acceptance was explicitly deferred by project-owner direction and is not claimed here. All BS-PR-705 acceptance criteria are satisfied at source/headless/debug-editor scope.

## Published acceptance — `b4aa61e` Navigation authoring is implemented, verified, and pushed on `codex/renderer-material-component-foundation`. - [Commit b4aa61e](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/commit/b4aa61e39459c12b81d86575eac62c50b4efbedd) - [Navigation evaluation record](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/src/commit/b4aa61e39459c12b81d86575eac62c50b4efbedd/docs/editor/evaluations/navigation-authoring/README.md) - [Selected bounds, baked mesh, source visualizers, and sample controls](https://git.spacetrainclubhouse.com/attachments/fd2f82dd-fbca-4c6b-ad75-a9a9fcf61a3d) - [Shared runtime path preview](https://git.spacetrainclubhouse.com/attachments/899afefc-edae-49d8-9e8c-a2678b811328) ### Acceptance evidence - Designer flow: typed bounds/obstacle/area/link actors, complete agent controls, deterministic **Bake**, truthful overlay, **Test Path**, and persisted named validation samples. - Live debug editor: selected artifact loaded current; query returned an 8.20 m, six-waypoint route through `navigation-link-center`; editor rebake produced 26 polygons; pinning a second sample immediately marked the artifact stale and disabled path testing; undo restored the current one-sample state. - Source fidelity: the active unsaved snapshot, visible subscenes, recursive prefab sources, navigation-relevant overrides, and exact affine transforms resolve through one shared path. Bounds never synthesize a floor. - Diagnostics/integrity: duplicate artifact owners, invalid agents/grid budgets/links/samples, prefab drift/structure, empty bakes, tampering, and deterministic content mismatch are owner-attributed with repair guidance. - Runtime parity: one height-aware multi-link Polyanya query core drives editor preview, game `Vec3` adaptation, project validation, and the renderer-free validation command. - Serialization: baked artifacts contain only versioned runtime data; viewport meshes, routes, endpoints, visualizers, and editor caches remain transient. ### Verification - Affected source matrix: 390 passed; 1 intentional manual migration test ignored. - Strict `clippy -D warnings`: passed for shared, scene, game, editor, and xtask all targets. - `cargo bake-navigation --project . --check`: 1 deterministic artifact current. - `cargo validate-levels`: 59 dependencies, 5 non-blocking findings, 0 blocking errors. - Formatting, staged diff checks, LFS upload, and remote commit verification: passed. Packaged/release acceptance was explicitly deferred by project-owner direction and is not claimed here. All BS-PR-705 acceptance criteria are satisfied at source/headless/debug-editor scope.

Rbanh closed this issue

2026-07-12 02:54:54 -04:00

Sign in to join this conversation.

No Milestone

No project

No Assignees

1 Participants

Notifications

Due Date

The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Falling-Metal-Interactive/Blacksite#48

BS-PR-705 - Navigation mesh authoring, bake diagnostics, and path preview #48