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

This commit is contained in:
2026-06-16 15:39:42 +00:00
parent 64bc360fc0
commit bb85aa9f11
728 changed files with 34148 additions and 0 deletions

View File

@ -0,0 +1,15 @@
# JOURNAL-parse
## Design decisions
- **Grammar**: classic 3-level recursive descent:
- `expr → term (('+' | '-') term)*` (lowest precedence)
- `term → unary (('*' | '/') unary)*` (medium)
- `unary → '-' unary | primary` (right-recursive for stacked unary)
- `primary → NUMBER | '(' expr ')'`
- Left associativity falls out naturally from the `while` loops in `_expr` and `_term`.
- Unary is right-recursive (`-` `-` 5 → nested Unary) as is conventional.
- Empty input detected early at `parse()` entry before any descent.
- Trailing tokens detected after `_expr()` returns, before EOF check.
## Test count: 31 (20 parser + 11 existing lexer)