idea115-taxalpha-studio-declarative/README.md

idea115-taxalpha-studio-declarative

TaxAlpha Studio (Phase-0 skeleton)

This repository contains a Phase-0 skeleton for the TaxAlpha Studio project — a declarative, auditable tax-aware harvesting and optimization engine.

What is included

• A tiny canonical IR (TaxLot, Account, HarvestAction, PlanDelta, AuditLog)
• A line-oriented DSL parser (very small, deterministic)
• A deterministic greedy warm-start optimizer (solver prototype)
• Two simple adapters: CSV reader and a mocked custodian adapter
• Tests and packaging metadata so the project builds and tests locally

Run tests

bash test.sh