@verydia/decision-logs

Human-readable audit logs for compliance officers and auditors.

Overview

@verydia/decision-logs generates structured, human-readable decision logs from trace analysis and compliance evaluations. These logs are designed for non-technical stakeholders including compliance officers, security teams, and auditors.

Features

• 8 Comprehensive Sections: Overview, Timeline, Policy, Safety, RAG, Performance, Compliance, and Insights
• Multiple Output Formats: JSON, Plain Text, and Markdown
• Compliance Integration: Optional compliance profile evaluation
• Human-Readable Language: Clear, professional language for governance teams

Installation

pnpm add @verydia/decision-logs

Usage

import { buildDecisionLog, renderDecisionLogMarkdown } from "@verydia/decision-logs";
import { analyzeTrace } from "@verydia/trace-insights";

// Build analysis from events
const analysis = analyzeTrace("trace-123", events);

// Build decision log
const decisionLog = buildDecisionLog({ analysis });

// Render as markdown
const markdown = renderDecisionLogMarkdown(decisionLog);

OSS Boundary & Dependencies

This package is OSS-safe and production-ready.

Allowed Dependencies

• @verydia/trace-insights - Trace analysis and insights
• @verydia/compliance-core - Compliance evaluation
• @verydia/telemetry-core - Telemetry event types

All dependencies are strictly OSS-safe with no proprietary or internal app dependencies.

External Dependencies

None. This package has zero external npm dependencies.

License

MIT