agent-orchestrator-benchmark/calculators/builder-adversary/run-03/machine-docs/DECISIONS.md

DECISIONS (append-only, shared)

D-001: Token representation

Token is a dataclass with kind: str and value (int | float | None). NUMBER tokens carry their parsed numeric value; operator/paren tokens carry None. EOF carries None value. Rationale: parser phases can pattern-match on kind and directly use value without re-parsing.

D-002: Integer vs float distinction

If a number string contains '.' it is parsed as float, otherwise int. Edge cases: '.5' → float(0.5), '10.' → float(10.0), '42' → int(42).