Metadata-Version: 2.4
Name: vaultburn
Version: 1.0.0
Summary: Offline SaaS spend auditor. CSV in → decision report out. VaultBurn discovers decisions; it never makes them.
Author-email: VaultBurn <vaultburn@proton.me>
License-Expression: MIT
Project-URL: Homepage, https://github.com/neverlose-io/vaultburn
Project-URL: Repository, https://github.com/neverlose-io/vaultburn
Project-URL: Issues, https://github.com/neverlose-io/vaultburn/issues
Keywords: saas,audit,csv,offline,spend,decision-support
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# VaultBurn

Offline SaaS spend auditor. CSV in → decision report out.

**VaultBurn discovers decisions. It never makes them.**

## Install

```bash
pip install vaultburn
```

Use

```bash
vaultburn subs.csv              # text report
vaultburn subs.csv --json r.json
vaultburn --init                # generate template
vaultburn --help                # full schema & philosophy
```

Schema

Required: name, monthly_cost, seats, used_seats, last_used

Optional: renew_date, category, critical, reason, replacement_group, cost_model

cost_model

· per_seat (default): monthly_cost is the price per seat
· flat: monthly_cost is the total monthly price

Signals

· monthly_spend — Sum of all subscriptions
· unused_seat_cost — Idle seats × seat cost
· potentially_cancellable — used=0 AND stale AND not critical
· duplicate_candidate — From user-declared replacement groups
· renewals_7d — Subscriptions renewing within 7 days

Verdicts

· cancellable — used=0, stale, not critical
· review — needs human attention
· protected — critical, never suggested for cancellation
· ignored — user marked replacement_group=ignore
· ok — clean

What it does NOT do

· No cloud. No OAuth. No accounts. No telemetry.
· No auto-cancel. No auto-keep. No cheapest-wins.
· No Stripe (yet — will add only if 3 users request it).

Philosophy

VaultBurn discovers decisions. It never makes them.

License

MIT.
