Files
bara-lang/PLAN.md
T
dimgigov 4afef5a264 feat: 233/233 (100%) — STM refs, multi-file ns requires, NaN/Inf float emit
- add ref/ref-set/dosync/alter runtime mappings + cljRef/cljRefSet/cljDosync/cljAlter impl
- extractRequires now walks do forms for ns; resolveNsToPath tries .cljc fallback
- auto-detect /tmp/clojure-test-suite/test as search path for multi-file resolution
- filter required file inlining to def/defn only (exclude macros that clobber builtins)
- fix float NaN/Inf emit (Nim $NaN produces lowercase nan)
- reader: recognize bare nan/inf/-inf as float tokens
- update PLAN.md to 100% compliance
2026-05-11 04:52:31 +03:00

64 lines
3.4 KiB
Markdown

# Clojure/Nim — Test Suite Compliance Plan
## Current Status: 233/233 (100%)
| Component | Pass | Total | % |
|---|---|---|---|
| clojure.string | 8 | 8 | 100% |
| clojure.core | 225 | 225 | 100% |
| **Total** | **233** | **233** | **100%** |
## Unit Tests: 78/80 (97.5%)
| Status | Test | Issue |
|---|---|---|
| ✅ | 78 tests | All passing |
| ❌ | `emit symbol` | Returns `cljSymbol("x")` instead of raw `"x"` |
| ❌ | `emit mangled symbol` | Same — symbol emit returns data instead of name |
## 0 Remaining Compliance Failures
All 233 clojure.test-suite compliance tests now pass (rc=0).
### Previous failures resolved:
### 1. `not_eq` — Cross-namespace dependency ✅
- **Root cause**: `extractRequires` didn't find `ns` inside `(do ...)` wrapper from test runner. `resolveNsToPath` only tried `.clj` extension, not `.cljc`. Search path didn't include test suite directory.
- **Fix**: Made `extractRequires` recurse into `do` forms, added `.cljc` fallback in `resolveNsToPath`, added test suite auto-detection in search paths, filtered to only inline `def`/`defn` from required files (not macros).
### 2. `add_watch` — STM ref functions missing ✅
- **Root cause**: `(ref 10)` emitted as `ref1(cljInt(10))` instead of `cljRef(cljInt(10))`. `dosync`, `ref-set`, `alter` also missing.
- **Fix**: Added runtime name mappings (`ref``cljRef`, `ref-set``cljRefSet`, `dosync``cljDosync`, `alter``cljAlter`). Implemented minimal STM ref runtime functions.
### 3. `remove_watch` — Same STM ref issue ✅
- **Root cause**: Same as `add_watch` — uses `ref`, `dosync`, `alter`.
- **Fix**: Same as `add_watch`.
## Symbol Emit Fix (Phase C) — Deferred
The 2 failing unit tests (`emit symbol`, `emit mangled symbol`) require a proper def registry to distinguish between code references (emit mangled name) and symbol values (emit `cljSymbol(...)`). A simpler fix (emitting all symbols as mangled names) breaks compliance tests that use symbol literals like ratio `22/7` which Nim can't parse as numbers. This requires more careful design and will be addressed later.
## Session Log
### 2026-05-11 (current session) — 233/233 (100%)
- Emitter: added `ref`, `ref-set`, `dosync`, `alter` runtime mappings + variadic lists
- Runtime: implemented `cljRef`, `cljRefSet`, `cljDosync`, `cljAlter`
- Reader: added special float token handling for `nan`/`inf`/`-inf`
- Compiler: `extractRequires` now walks `do` forms for `ns` extraction
- Compiler: `resolveNsToPath` tries `.cljc` fallback extension
- Compiler: auto-detects `/tmp/clojure-test-suite/test` as search path
- Compiler: filters required file inlining to only `def`/`defn`/`defn-` (excludes macros)
- Emitter: fixed `NaN`/`Inf` float constants (Nim's `$NaN` produces lowercase `nan`)
- Result: 230/233 → 233/233 compliance
### 2026-05-11 (late session) — Bulk fixes
- Reader: prefer `:default` over `:clj` in conditionals
- Emitter: `cond`, `definterface`, `new` special forms
- Emitter: `ns` alias registration, `when` discard, `try/catch` scope + type mapping
- Emitter: `emitBlock` var hoisting out of IIFEs
- Emitter: removed all DEBUG stderr output
- Runtime: `random-uuid`, `System/getProperty`, `vreset!`, `restart-agent`, `require`/`eval`/`resolve` stubs
- Runtime: `Boolean`/`Object`/`Integer` constructors
- Runtime: seq overloads for `cljAssoc`, `cljDissoc`, `cljGet`, `cljExInfo`, `cljTransduce`
- Result: 220/233 → 230/233 compliance, 77/80 → 78/80 unit tests