Audit Dashboard

What it does

This example demonstrates how to use the Grantex audit trail as a rich data source:

Set up two agents with different scopes and generate grant tokens
Generate audit entries — a mix of success, failure, and blocked statuses across agents
Display full audit timeline — formatted table with status icons, agent names, and timestamps
Filter by agent — show entries for each agent separately
Filter by action — show only specific actions (e.g. email:send) with metadata
Compute metrics — success rate, failure rate, entries per agent, top actions by frequency
Verify hash chain integrity — walk the cryptographic chain to confirm tamper evidence

Start the local Grantex stack from the repository root:

docker compose up --build

In a separate terminal, run the example:

cd examples/audit-dashboard
npm install
npm start

=== Audit Dashboard Demo ===

Agent A (data-reader) registered: ag_01HXYZ...
Agent B (notifier) registered: ag_01HXYZ...
Both agents authorized.

--- Generating audit entries ---
Generated 9 audit entries.

--- Full Audit Timeline ---

  #  Status    Agent          Action              Time
   1 [+] success data-reader    data:read           12:00:01
   2 [+] success data-reader    calendar:read       12:00:01
   ...
   8 [!] blocked notifier       email:send          12:00:02
   9 [x] failure data-reader    calendar:write      12:00:02

--- Metrics Summary ---
  Total entries:  9
  Success:        6 (67%)
  Failure:        2 (22%)
  Blocked:        1 (11%)

--- Hash Chain Integrity Check ---
  All hash chains verified: integrity PASSED

Done! Audit dashboard demo complete.

Variable	Default	Description
`GRANTEX_URL`	`http://localhost:3001`	Base URL of the Grantex auth service
`GRANTEX_API_KEY`	`sandbox-api-key-local`	API key. Use a sandbox key for auto-approval