Aoineco Ledger

# Aoineco Ledger — AI Agent Financial Tracking Engine

<!-- 🌌 Aoineco-Verified | S-DNA: AOI-2026-0213-SDNA-AL01 -->

**Version:** 1.0.0  
**Author:** Aoineco & Co.  
**License:** MIT  
**Tags:** finance, expense-tracking, budget, roi, bootstrap, multi-agent, accounting

## Description

Financial tracking engine built for AI agents operating on extreme budgets. Tracks every API call, gas fee, and revenue stream with per-agent cost attribution. Native support for the $7 Bootstrap Protocol.

Rebuilt from `agentledger` (Node.js) into Python with major enhancements for multi-agent squads and micro-budget operations.

**Core metric:** *Intelligence per Dollar (IPD) — how many operations you get per cent spent.*

## Problem

AI agents spend money (API calls, gas fees, subscriptions) but rarely track it. When you're running a 9-agent squad on a $7 seed budget, every fraction of a cent matters. You need:
- Real-time visibility into burn rate and runway
- Per-agent cost attribution (who's spending what?)
- Budget alerts BEFORE you overspend
- Revenue tracking to measure actual ROI

## Features

| Feature | Description |
|---------|-------------|
| **Transaction Logging** | Log expenses, revenue, API costs, gas fees with one-liner methods |
| **$7 Bootstrap Metrics** | Seed tracking, ROI%, runway days, daily burn rate, IPD |
| **Per-Agent Cost Attribution** | Track spending by squad member (oracle, blue-sound, etc.) |
| **Budget Alerts** | Set limits per category/period — warns at 80%, blocks at 100% |
| **Category System** | Pre-configured for AI ops: API/LLM, Gas/Blockchain, Revenue/Gig, etc. |
| **CSV/JSON Export** | Full transaction export for tax, audit, or analysis |
| **JSONL Storage** | Append-only transaction log — fast, corruption-resistant |
| **Period Filtering** | Query by today, this-week, this-month, this-year, or all |

## Quick Start

```python
from ledger_engine import AoinecoLedger

ledger = AoinecoLedger()

# Log API cost
ledger.log_api_cost(0.0042, "Googl...