@aletheia-labs/auditor

Read-only local CLI/UI for inspecting Aletheia governance evidence.

This package is the Phase 10 product surface: it makes evidence reports inspectable without cloning the full repository.

Run

npx @aletheia-labs/auditor ./evidence/evaluation-suite/phase-6-report.json

Multiple reports can be loaded into the same local session:

npx @aletheia-labs/auditor \
  ./evidence/evaluation-suite/phase-6-report.json \
  ./evidence/framework-contracts/phase-7-report.json \
  ./evidence/langgraph-governed-agent/fixture-report.json

From a repo checkout:

pnpm run demo:auditor-cli

Options

aletheia-auditor --port 4180 ./phase-6-report.json
aletheia-auditor --host 127.0.0.1 ./phase-7-report.json
aletheia-auditor --help

The server binds locally by default and prints the URL.

What It Does

• Serves the auditor UI locally.
• Accepts one or more explicit evidence JSON paths.
• Loads those reports through a read-only HTTP API.
• Supports local browser file upload through the UI.
• Shows records, timeline, decisions, conflicts, memory references, diffs, evidence, editorial review candidates, approve-with-edit commands, replacement signals, editorial compass pressure with ignored control-memory counts, editorial style-guide rules, style issues, audit suggestions, in-memory and durable checkpoint-resume cases, and raw JSON.

What It Does Not Do

• No memory-store mutation.
• No SQLite write path.
• No provider keys or OAuth.
• No background daemon.
• No action execution.
• No production authorization.
• No semantic retrieval, embeddings, or vector storage.

Receipts remain evidence. The auditor explains why a decision happened; it does not make the decision authoritative for a host.