Skip to content

Add read-only Lattice topology provenance - #4313

Open
mgazza wants to merge 1 commit into
mainfrom
feat/lattice-topology-provenance
Open

Add read-only Lattice topology provenance#4313
mgazza wants to merge 1 commit into
mainfrom
feat/lattice-topology-provenance

Conversation

@mgazza

@mgazza mgazza commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • add default-off, read-only ingestion of the gateway's retained Lattice topology
  • merge provider documents by authority, recency, and stable input order
  • preserve provider-local capability refs in a provenance sidecar after merged refs are reminted
  • expose GatewayMQTT.lattice_source_ref(...) as the future intent-dispatch seam
  • support current 0.2 fragments and the proposed 0.3 topology family

This PR does not publish /control, alter the planner, or write to inverter hardware.

Safety

  • feature flag defaults off (lattice_projection_enable)
  • malformed/stale/reused-version documents preserve the last known-good snapshot
  • node/capability tombstones remove stale provenance
  • exact-rank live/tombstone conflicts have deterministic first-input behavior

Verification

  • python3 apps/predbat/tests/test_lattice_topology.py — 11/11 passed
  • Python syntax compilation passed
  • Ruff, Black, CSpell, whitespace hooks passed
  • GitNexus final change scope: LOW for the tie correction, no affected execution flows

Tracking

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