idea74-polyport-studio-interactive/README.md

PolyPort Studio: Interactive, Verifiable Algebraic Portfolio Design (MVP)

This repository implements a production-oriented MVP for a graphical, algebraic DSL-driven portfolio design tool.

• Language: Python (Core). See pyproject.toml for packaging and project metadata.
• Core functionality: A minimal DSL parser that converts a simple domain-specific language into a canonical LocalProblem-like representation.
• Extensibility: Designed for adapters (Graph-of-Contracts) to map real-world data feeds into the canonical form.
• Testing: Pytest-based tests; an executable test.sh orchestrates tests and packaging checks.

How to run locally:

• Install dependencies (if any) with your Python environment.
• Run tests: bash test.sh.

Project structure:

• src/idea74_polyport_studio_interactive/ # Python package with the DSL core
• tests/ # Pytest test-suite
• AGENTS.md # Architecture and contribution guide
• README.md # This file
• pyproject.toml # Packaging metadata
• test.sh # Test runner (also builds)

Note: This is an MVP that focuses on correctness, testability, and a clean path toward a production-grade, offline-first architecture.