artifacts: add calculators/ — the 30 built calculators (5/variant) + machine-docs + git logs

calculators/builder-adversary/run-02/machine-docs/STATUS-lex.md

@@ -0,0 +1,103 @@
+# STATUS — phase lex (Builder)
+
+## DONE
+
+All DoD gates Adversary-verified PASS. Phase complete.
+
+## Gates
+
+| Gate | Status |
+|------|--------|
+| D1 — numbers | **PASS** (Adversary @2026-06-15T00:36Z) |
+| D2 — operators & parens | **PASS** (Adversary @2026-06-15T00:36Z) |
+| D3 — whitespace & errors | **PASS** (Adversary @2026-06-15T00:36Z) |
+| D4 — tests green | **PASS** (Adversary @2026-06-15T00:36Z) |
+
+## Post-verification fix
+
+**AF-01 addressed:** Wrapped `float(raw)` in `try/except ValueError` to re-raise as `LexError` for malformed number literals like `1.2.3`, `.`, `..`. 24 tests still pass.
+
+---
+
+## Claim: D1 — numbers
+
+**WHAT:** `calc/lexer.py::tokenize` correctly tokenizes integers and floats to NUMBER tokens with numeric Python values (int for integers, float for floats). EOF is always the final token.
+
+**HOW to verify:**
+```bash
+python -c "from calc.lexer import tokenize; t=tokenize('42'); assert t[0].kind=='NUMBER' and t[0].value==42 and isinstance(t[0].value,int) and t[1].kind=='EOF', t"
+python -c "from calc.lexer import tokenize; t=tokenize('3.14'); assert t[0].kind=='NUMBER' and abs(t[0].value-3.14)<1e-9 and isinstance(t[0].value,float), t"
+python -c "from calc.lexer import tokenize; t=tokenize('.5'); assert t[0].value==0.5, t"
+python -c "from calc.lexer import tokenize; t=tokenize('10.'); assert t[0].value==10.0, t"
+```
+
+**EXPECTED:** All assertions pass (exit 0).
+
+**WHERE:** `calc/lexer.py`
+
+---
+
+## Claim: D2 — operators & parens
+
+**WHAT:** `+`, `-`, `*`, `/`, `(`, `)` each tokenize to PLUS, MINUS, STAR, SLASH, LPAREN, RPAREN respectively. `tokenize("1+2*3")` → NUMBER PLUS NUMBER STAR NUMBER EOF.
+
+**HOW to verify:**
+```bash
+python -c "from calc.lexer import tokenize; k=[t.kind for t in tokenize('1+2*3')]; assert k==['NUMBER','PLUS','NUMBER','STAR','NUMBER','EOF'], k"
+python -c "from calc.lexer import tokenize; print([(t.kind,t.value) for t in tokenize('3.5*(1-2)')])"
+```
+
+**EXPECTED:**
+- First command: exit 0 (assertion passes)
+- Second command prints: `[('NUMBER', 3.5), ('STAR', '*'), ('LPAREN', '('), ('NUMBER', 1), ('MINUS', '-'), ('NUMBER', 2), ('RPAREN', ')'), ('EOF', None)]`
+
+**WHERE:** `calc/lexer.py`
+
+---
+
+## Claim: D3 — whitespace & errors
+
+**WHAT:** Spaces and tabs between tokens are skipped. Invalid characters (letters, `@`, `$`, etc.) raise `LexError` with the offending char and its position in the message.
+
+**HOW to verify:**
+```bash
+python -c "from calc.lexer import tokenize; k=[t.kind for t in tokenize('  12  +  3 ')]; assert k==['NUMBER','PLUS','NUMBER','EOF'], k"
+python -c "
+from calc.lexer import tokenize, LexError
+try:
+    tokenize('1 @ 2')
+    assert False, 'should have raised'
+except LexError as e:
+    assert '@' in str(e), str(e)
+    assert '2' in str(e), str(e)
+print('OK')
+"
+```
+
+**EXPECTED:**
+- First command: exit 0
+- Second command prints: `OK`
+
+**WHERE:** `calc/lexer.py`
+
+---
+
+## Claim: D4 — tests green
+
+**WHAT:** `calc/test_lexer.py` passes under `python -m unittest` with 0 failures (24 tests).
+
+**HOW to verify:**
+```bash
+python -m unittest -q
+```
+
+**EXPECTED:**
+```
+----------------------------------------------------------------------
+Ran 24 tests in 0.001s
+
+OK
+```
+Exit code 0.
+
+**WHERE:** `calc/test_lexer.py`, `calc/lexer.py`