usage-logging

## Table of Contents - [Overview](#overview) - [When to Use](#when-to-use) - [Core Concepts](#core-concepts) - [Session Management](#session-management) - [Log Entry Structure](#log-entry-structure) - [Quick Start](#quick-start) - [Initialize Logger](#initialize-logger) - [Log Operations](#log-operations) - [Query Usage](#query-usage) - [Integration Pattern](#integration-pattern) - [Log Storage](#log-storage) - [Detailed Resources](#detailed-resources) - [Exit Criteria](#exit-criteria) # Usage Logging ## Overview Session-aware logging infrastructure for tracking operations across plugins. Provides structured JSONL logging with automatic session management for audit trails and analytics. ## When To Use - Need audit trails for operations - Tracking costs across sessions - Building usage analytics - Debugging with operation history ## When NOT To Use - Simple operations without logging needs ## Core Concepts ### Session Management Sessions group related operations: - Auto-created on first operation - Timeout after 1 hour of inactivity - Unique session IDs for tracking ### Log Entry Structure ```json { "timestamp": "2025-12-05T10:30:00Z", "session_id": "session_1733394600", "service": "my-service", "operation": "analyze_files", "tokens": 5000, "success": true, "duration_seconds": 2.5, "metadata": {} } ``` **Verification:** Run the command with `--help` flag to verify availability. ## Quick Start ### Initialize Logger ```python from leyline.usage_lo...