From 0d313f989d539cb9d69022806f76d21caa403b08 Mon Sep 17 00:00:00 2001 From: Alex Maldonado Date: Mon, 5 Oct 2026 03:33:58 +0000 Subject: [PATCH] Make this repository the engines' home; the course copies from here Whether the engines' changes went back to the course or the course took them from here was an open question (docs/engines.md). Soundness fixes to the prover cannot wait for a round trip through a repository with no engine tests, so this repository now owns the engines. - pixi run engines-export /static builds and writes every engine module into the course's static/js/: JavaScript modules as written, TypeScript ones (logic, solver, vcgen) as built, without source maps. - pixi run engines-diff now shows what the course has not taken yet, comparing the file the course would receive with its copy. Both scripts share the list of modules in scripts/engines-files.mjs. - docs/engines.md describes the ownership, the prover's three modules and its number model, the soundness tests and the bugs found so far, the changes the course receives with the next export, and how to export. - AGENTS.md gains a hard rule: never let the prover call something proved that a run breaks, with how to add a soundness regression first. - docs/app.md's Known limits no longer sends engine fixes upstream. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01FgvbRdoEheAHqsRmr2WuKZ --- AGENTS.md | 6 ++-- README.md | 7 +++-- docs/app.md | 2 +- docs/engines.md | 60 ++++++++++++++++++++++++++++---------- pixi.toml | 3 +- scripts/engines-diff.mjs | 47 +++++++++++++++++------------ scripts/engines-export.mjs | 43 +++++++++++++++++++++++++++ scripts/engines-files.mjs | 25 ++++++++++++++++ 8 files changed, 151 insertions(+), 42 deletions(-) create mode 100644 scripts/engines-export.mjs create mode 100644 scripts/engines-files.mjs diff --git a/AGENTS.md b/AGENTS.md index 66a5c44..53bc170 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -27,12 +27,13 @@ The full suite takes about two minutes. While iterating, build and run one file: 3. **Never claim Mojo compiles, runs, or prints something without the real compiler's answer.** Mojo is pinned to 1.1.0. The checker may never report an error on a program the compiler accepts, and the interpreter must print exactly what godbolt printed or decline; `tests/mojo-check.test.mjs` and `tests/mojo-run.test.mjs` hold them to that. Every Mojo construct you write into the app must pass `checkMojo`, and every standard-library name must exist in `src/mojo/generated/stdlib.ts` or `types.ts`. 4. **No new dependencies.** TypeScript is the only npm package. There is no bundler, no framework, and no runtime dependency; the corpus pipeline is Python's standard library only. CodeMirror is vendored as one built module (`src/vendor/`), rebuilt only by `scripts/vendor/codemirror.sh`. 5. **You have no network** in most sandboxes. Godbolt (`mojo-verify`, Compile & run) and GitHub (`mojo-harvest`, `mojo-fetch`) need one. Never fake their results; leave those steps to the owner and list them. -6. **Keep the workspace working while you change it.** Code panes are always the CodeMirror editor (`Editor` in `src/ui/editor.ts`, over the vendored `src/vendor/codemirror.js`), never a `