Skip to content

feat(provenance): add autk-provenance module with provenance tracking and session insights#68

Open
JP109 wants to merge 21 commits into
urban-toolkit:mainfrom
JP109:provenance-implementation
Open

feat(provenance): add autk-provenance module with provenance tracking and session insights#68
JP109 wants to merge 21 commits into
urban-toolkit:mainfrom
JP109:provenance-implementation

Conversation

@JP109
Copy link
Copy Markdown
Collaborator

@JP109 JP109 commented May 6, 2026

Hey, this PR adds autk-provenance, a new module we built on top of the existing Autark stack.

Every interaction a user makes, like picking features on the map, brushing a chart, toggling a layer,
panning the camera, gets recorded as a node in a branching graph. You can navigate back and
forward through that graph and every view restores to exactly what it looked like at that point.
Branches happen naturally when you go back and take a different path.

The easiest way in is renderInsightsWorkspace, which wires up a full coordinated workspace
(map + scatter + bar chart + parallel coordinates + histogram + provenance trail + session
insights) from a single function call. createAutarkProvenance is there if you want to bring
your own layout, and createProvenance handles non-Autark state shapes.

There's also a session insight engine that reads the graph and summarizes the session and allows users to annotate nodes.

We had to touch a few of the existing modules to make it work. autk-map now exposes viewport
listeners and per-layer highlight methods. autk-plot got owned vs coordinated selection, brush
events, and a new Histogram type. Nothing existing was broken or removed.

Two gallery examples are under autk-provenance/ if you want to run it: all-plots-provenance
is the full workspace, map-plot-provenance is a lighter map-only version.

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.

2 participants