Threadline.Investigation (Threadline v0.4.0)

Copy Markdown View Source

Higher-level investigation helpers layered on top of Threadline query primitives.

Use these helpers when you want the canonical operator questions as one public entrypoint instead of assembling low-level filter lists manually.

Summary

Functions

Returns change rows across tables for one actor, ordered by captured_at descending, then id descending.

Returns one keyset page of change rows across tables for one actor.

Returns change rows linked to one correlation_id with strict inner-join semantics.

Returns one keyset page of changes linked to one correlation_id.

Returns one transaction-focused incident bundle with linked context and packaged diffs.

Returns change history for one schema row, ordered by captured_at descending, then id descending.

Returns one keyset page of row history for a single schema row.

Returns one transaction-oriented investigation slice with linked transaction and optional action metadata.

Functions

actor_window(actor_ref, filters \\ [], opts \\ [])

Returns change rows across tables for one actor, ordered by captured_at descending, then id descending.

filters accepts timeline filters except :actor_ref, which is fixed by the helper argument.

actor_window_page(actor_ref, filters \\ [], opts \\ [])

Returns one keyset page of change rows across tables for one actor.

correlation_bundle(correlation_id, filters \\ [], opts \\ [])

Returns change rows linked to one correlation_id with strict inner-join semantics.

filters accepts timeline filters except :correlation_id, which is fixed by the helper argument.

correlation_bundle_page(correlation_id, filters \\ [], opts \\ [])

Returns one keyset page of changes linked to one correlation_id.

incident_bundle(transaction_id, opts \\ [])

Returns one transaction-focused incident bundle with linked context and packaged diffs.

row_history(schema_module, id, filters \\ [], opts \\ [])

Returns change history for one schema row, ordered by captured_at descending, then id descending.

filters accepts only :from, :to, and optional :repo parity with the lower-level timeline APIs. Pass paging controls in opts only when using row_history_page/4.

row_history_page(schema_module, id, filters \\ [], opts \\ [])

Returns one keyset page of row history for a single schema row.

Uses the same (captured_at, id) keyset rules as Threadline.timeline_page/2.

transaction_context(transaction_id, opts \\ [])

Returns one transaction-oriented investigation slice with linked transaction and optional action metadata.