Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 22 additions & 6 deletions .agents/plans/A13-release-rc1.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,12 +42,28 @@ final.
summarizing the diff vs `1.0.0-rc.1`.
- [ ] `mix test` passes (≥ current count + new tests from
A19-A35).
- [ ] **Suite gate**: at least N/29 official Lua 5.3 suite files
passing, where N is set by A20-A24 outcomes. Target is
"near-fully compliant"; specific number to be set after triage
lands. Files explicitly out of scope (`os.execute` etc.) are
documented as deliberate non-goals in the README and
CHANGELOG. **Best-guess: ≥22/29 with documented exclusions.**
- [ ] **Suite gate**: **20/29 official Lua 5.3 suite files passing,
with 9 documented exclusions.** (Settled 2026-06-10 after a live
re-triage of every whole-file skip; supersedes the earlier
best-guess ≥22, which was never achievable — 22 would require a
capability or perf rewrite we have deliberately deferred.)
- **Today: 17/29 pass.** Path to 20 is three triage plans:
`strings.lua` (`tostring(function)` address fixed, clearing
line 126; next blocker is `string.format('%q')` escaping at
line 153 — a format chain), `sort.lua` and `math.lua` (need a
triage pass each). First-failure sites are recorded in
`test/lua53_skips.exs`.
- **9 documented exclusions**, by category (reasons live in
`test/lua53_skips.exs` + `@deferred_permanent`):
- filesystem / subprocess non-goals (4): `main`, `files`,
`attrib`, `verybig`
- capability non-goals (2): `coroutine`, `db`
- perf-bound, revisit 1.0.x (2): `big`, `closure` (both >90s)
- PUC error-wording divergence (1): `errors`
- If `sort` or `math` proves to be a wording/perf rabbit hole,
exclude it too and ship at the resulting floor (≥18). Every
exclusion must stay a documented non-goal/known-limit in
`lua53_skips.exs`, the README, and the CHANGELOG.
- [ ] **Perf gate**: `mix lua.bench --compare-baseline` passes
against the locked-in baseline from A35. No workload more than
25% slower than Luerl on the same machine.
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A19-error-line-info-native-funcs.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 215
branch: fix/error-line-info-stdlib
base: main
status: review
status: merged
direction: A
unlocks:
- line numbers on `string.upper(nil)`, `table.insert(t, nil, 5)`, etc.
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A20-triage-sandbox-refusals.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 216
branch: triage/sandbox-refusals
base: main
status: review
status: merged
direction: A
unlocks:
- main.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A21a-integer-divide-by-zero.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 259
pr: 292
branch: fix/runtime-type-cluster
base: main
status: review
status: merged
direction: A
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A22a-gc-collectgarbage-stub.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 260
pr: 287
branch: fix/gc-vm-errors
base: main
status: review
status: merged
direction: A
unlocks:
- gc.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A23a-gsub-replacement-errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 261
pr: 291
branch: fix/metamethod-control-flow
base: main
status: review
status: merged
direction: A
unlocks:
- pm.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A24a-table-unpack-too-many-results.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 262
pr: 293
branch: fix/stdlib-data-structure
base: main
status: review
status: merged
direction: A
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A25-string-pack-unpack.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 217
branch: feat/string-pack-unpack
base: main
status: review
status: merged
direction: A
unlocks:
- tpack.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A26-error-message-quality.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 263
pr: 304
branch: errors/quality-pass
base: main
status: review
status: merged
direction: A
unlocks:
- "world-class error messages" promise of the library
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A27-inspect-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 218
branch: dx/inspect-protocol
base: main
status: review
status: merged
direction: A
unlocks:
- readable iex output for Lua values
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A29-mix-tasks.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 220
branch: dx/mix-tasks
base: main
status: review
status: merged
direction: A
unlocks:
- one-line invocations from a Mix project
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A30-examples-directory.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 264
pr: 300
branch: docs/examples
base: main
status: review
status: merged
direction: A
unlocks:
- "embedding patterns are obvious" promise
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A31-readme-rewrite.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 265
pr: 298
branch: docs/readme-rewrite
base: main
status: review
status: merged
direction: A
unlocks:
- "first-impression" of the library on Hex/GitHub
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A32-docstring-audit.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 266
pr: 301
branch: docs/docstring-audit
base: main
status: review
status: merged
direction: A
unlocks:
- "world-class docs" promise
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A36-parser-error-positions.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 222
branch: fix/parser-error-positions
base: main
status: review
status: merged
direction: A
unlocks:
- `Lua.eval!("2 + 2")` produces a useful error message
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A37-parser-error-tuple-shapes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 241
branch: fix/parser-error-tuple-shapes
base: main
status: review
status: merged
direction: A
unlocks:
- Table-field syntax errors render with position and source context
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A38-dialyzer-plt-cache.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 243
branch: ci/dialyzer-plt-cache
base: main
status: review
status: merged
direction: A
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A39-require-leaks-open-upvalues.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 244
pr: 245
branch: fix/require-leaks-open-upvalues
base: main
status: review
status: merged
direction: A
unlocks:
- luassert.assertions
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A40-arith-name-hints.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 252
pr: 270
branch: errors/arith-bitwise-hints
base: main
status: review
status: merged
direction: A
unlocks:
- math.lua (reason narrowed)
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A41-funcdecl-head-name.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 255
pr: 274
branch: fix/funcdecl-head-name
base: main
status: review
status: merged
direction: A
unlocks:
- calls.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A42-paren-adjust-single-value.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 254
pr: 278
branch: fix/paren-adjust-single-value
base: main
status: review
status: merged
direction: A
unlocks:
- constructs.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A43-os-library.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 280
pr: 289
branch: fix/runtime-type-errors
base: main
status: review
status: merged
direction: A
unlocks:
- all.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A44-debug-getinfo-name.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 279
pr: 290
branch: feat/debug-getinfo-name
base: main
status: review
status: merged
direction: A
unlocks:
- constructs.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A45-short-circuit-level4.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 281
pr: 294
branch: fix/short-circuit-level4
base: main
status: review
status: merged
direction: A
unlocks:
- constructs.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A46-pattern-position-capture.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 257
pr: 288
branch: feat/pattern-position-capture
base: main
status: review
status: merged
direction: A
unlocks:
- pm.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A47-open-upvalue-block-close.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 276
pr: 303
branch: fix/open-upvalue-block-close
base: main
status: review
status: merged
direction: A
unlocks:
- calls.lua
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/A48-pcall-error-value-passthrough.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 334
pr: 335
branch: fix/pcall-error-value-passthrough
base: main
status: review
status: merged
direction: A
unlocks:
- structured error objects (error({code = ...})) survive pcall
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B10-table-sort-batch-writeback.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 307
pr: 318
branch: perf/table-sort-batch-writeback
base: main
status: review
status: merged
direction: B
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B11-setlist-batch-insert.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 308
pr: 321
branch: perf/setlist-batch-insert
base: main
status: review
status: merged
direction: B
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B12-string-format-flags-bitmask.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 309
pr: 317
branch: perf/string-format-flags-bitmask
base: main
status: review
status: merged
direction: B
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B13-string-format-width-iolist.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 310
pr: 316
branch: perf/string-format-width-iolist
base: main
status: review
status: merged
direction: B
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B14-string-format-iolib-float.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 311
pr: 319
branch: perf/string-format-iolib-float
base: main
status: review
status: merged
direction: B
---

Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B5a-v2-dispatcher-foundation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 237
branch: perf/dispatcher-foundation
base: main
status: review
status: merged
direction: B
unlocks:
- B5b-v2 (table opcodes), B5c-v2 (closures), B5d-v2 (error fidelity)
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B5b-v2-dispatcher-tables.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 271
pr: 275
branch: perf/dispatcher-tables
base: main
status: review
status: merged
direction: B
unlocks:
- ~2x speedup on table_ops benchmarks
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B8-inline-numeric-narrowing.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: null
pr: 227
branch: perf/inline-numeric-narrowing
base: main
status: review
status: merged
direction: B
unlocks:
- small but free win on all integer-arithmetic workloads
Expand Down
2 changes: 1 addition & 1 deletion .agents/plans/B9-stdlib-hot-paths.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ issue: 273
pr: 299
branch: perf/stdlib-hot-paths
base: main
status: review
status: merged
direction: B
unlocks:
- closes most of the string.format gap vs Luerl (1.77x) and C Lua (5.5x)
Expand Down
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## Unreleased

### Fixed

- **`tostring` on a function now returns a `function: 0x...` address**
instead of the bare string `"function"`, matching PUC-Lua's
`tostring(print)`-style output (builtins render as
`function: builtin: 0x...`). The address is a deterministic
per-value pseudo-pointer. Table rendering (`table: 0x...`) is
unchanged. `type(f)` still returns `"function"`.

## [v1.0.0-rc.2] - 2026-06-10

The third release candidate for `1.0.0`. It builds on rc.1 with a major
Expand Down
26 changes: 18 additions & 8 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,24 @@

This is the strategic overview. For per-PR detail, see [`.agents/plans/`](.agents/plans).

## Status: 2026-05-21

- **Unit tests**: 1,705 passing, 0 failing, 30 skipped.
- **Lua 5.3 official suite**: 6/29 files passing (`simple_test.lua`,
`api.lua`, `bitwise.lua`, `code.lua`, `tpack.lua`, `vararg.lua`).
- **Current focus**: post-B-series consolidation. See [Direction B —
Performance](#direction-b--performance-1-0-x) for what was tried,
what shipped, and what we learned about the limits.
## Status: 2026-06-10

- **Version**: `1.0.0-rc.2` shipped (rc.0, rc.1, rc.2 all released).
- **Unit tests**: 2,230 passing (62 doctests, 51 properties, 2,117
tests), 0 failing, 7 skipped.
- **Lua 5.3 official suite**: 17/29 files passing. 8 fully clean
(`api`, `bitwise`, `code`, `nextvar`, `simple_test`, `tpack`, `utf8`,
`vararg`) plus 9 passing with documented skip-ranges (`all`, `calls`,
`constructs`, `events`, `gc`, `goto`, `literals`, `locals`, `pm`). 4
deliberate non-goals (`main`, `files`, `attrib`, `verybig`). 8 still
whole-file-skipped pending triage (`big`, `closure`, `coroutine`,
`db`, `errors`, `math`, `sort`, `strings`).
- **Current focus**: closing the `1.0.0` release gates in
[`A13`](.agents/plans/A13-release-rc1.md) — suite gate (settled at
**20/29 with 9 documented exclusions**; 17 pass today, 3 triage
plans remain — `strings`/`sort`/`math`), perf gate
(A33–A35 baseline + parity, recursion regression #324), and the DX
gate (`Lua.dbg/2`, PR #219).

## Done

Expand Down
Loading
Loading