Skip to content

feat(pathfinder): add prepared endpoint freshness primitives - #62

Draft
apotema wants to merge 1 commit into
mainfrom
feat/prepared-endpoint-foundation
Draft

apotema wants to merge 1 commit into
mainfrom
feat/prepared-endpoint-foundation

Conversation

@apotema

@apotema apotema commented Oct 15, 2026

Copy link
Copy Markdown
Contributor

Prepared distance matching needs to reject stale endpoints without resolving positions or rebuilding Floyd–Warshall during a query. This first slice adds transient CMN publication metadata and explicit, read-only access to a prepared distance table.

CMNs distinguish pending, ready and completed off-graph results. Publication validates captured world/entity/position/graph inputs; invalidation preserves the last node and its original stamp for debugging. Obsolete results cannot overwrite a newer publication. The table query returns finite cost or null and never repairs a dirty graph.

Part of https://github.com/moca-tecnologia/flying-platform-labelle/pull/1046. This is deliberately a foundation: engine mutation hooks, registered movement-node dispatch, rotating bounded preparation, legacy writer migration and gameplay query migration remain outstanding. Existing game matching behavior is unchanged. The low-level node query does not validate entity readiness; consumers must not use it to bypass that contract.

Validation: 13 unit tests and 76 navigation specs pass (zig build test spec); all 20 Flying Platform test targets pass against the local dependency override. Five new regression tests cover stale stamps/identity, off-graph completion, obsolete publication, node zero, and no-repair table access. See rfc/prepared-endpoint-implementation.md for the remaining integration boundaries.

@coderabbitai

coderabbitai Bot commented Oct 15, 2026

Copy link
Copy Markdown

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant