algebraic-portfolio-provenance-studio-ve/AGENTS.md

APPS Agents Documentation

Architecture: Python MVP for Algebraic Portfolio Provenance Studio (APPS)

• Core DSL: algebraic_portfolio_provenance_studio_ve.dsl
• Deterministic Backtester: algebraic_portfolio_provenance_studio_ve.simulator
• Graph-of-Contracts registry: algebraic_portfolio_provenance_studio_ve.registry
• Adapters: algebraic_portfolio_provenance_studio_ve.adapters
• Tests: tests/test_basic.py

How to run locally:

• pytest -q
• python -m build

Packaging integration:

• pyproject.toml defines the package name algebraic_portfolio_provenance_studio_ve

Conventions:

• Minimal, well-scoped MVP. Each module is a stepping stone toward the full APPS architecture.