crosswake_threadline

Threadline audit and correlation observer for Crosswake — the route-policy and runtime-contract library for Phoenix apps that go mobile.

This package extracts Crosswake.Threadline.*, Crosswake.Audit.Ledger, Crosswake.Plug.Threadline, and Crosswake.Live.Threadline into a standalone Hex dependency so hosts can adopt threadline audit/correlation as a Hex dependency. The module namespaces and the adopter touch-points (plug Crosswake.Plug.Threadline, on_mount: Crosswake.Live.Threadline) are unchanged — extraction is non-breaking.

Installation

Add crosswake_threadline to your mix.exs:

defp deps do
  [
    {:crosswake, "~> 0.1"},
    {:crosswake_threadline, "~> 0.1"},
    # Optional — only needed if you use Crosswake.Plug.Threadline:
    {:plug, "~> 1.0"},
    # Optional — only needed if you use Crosswake.Live.Threadline:
    {:phoenix_live_view, "~> 1.1"}
  ]
end

After adding the optional :plug or :phoenix_live_view deps, run: mix deps.compile --force crosswake_threadline (stale-BEAM caveat: optional deps are not compiled by default until forced.)

Usage

Plug (HTTP thread_id propagation)

plug Crosswake.Plug.Threadline

LiveView (thread_id metadata bridge)

on_mount {Crosswake.Live.Threadline, :default}

Audit Ledger (host-owned schema generation)

Generate the host-owned Ecto schema and migration:

mix crosswake.gen.audit

Threadline CLI (timeline visualization)

mix crosswake.threadline --thread-id <id>
mix crosswake.threadline --actor-ref <ref>

Configuration (durable posture)

config :crosswake,
  audit_repo: MyApp.Repo,
  audit_ledger: MyApp.Audit.Ledger,
  audit_hmac_secret: "your-secret-here"