ajo-engine-compiler

Native compiler for sealed Ajo applications. This package contains a direct Linux x64 executable, with no installation scripts, downloaders or runtime npm dependencies.

Install the matching pair in an Ajo application:

npm install --save-dev --save-exact [email protected] [email protected]

Build the application with ajo-kit, then seal and run its descriptor:

npx --no-install ajo-engine-compiler --input .ajo/compiler.json --output .ajo/artifact
npx --no-install ajo-engine .ajo/artifact

The application chooses its environment, port and data directory. The runtime loads sealed bytecode; it does not execute JavaScript or TypeScript source. Node and a package manager are development/install tools. The installed binary can run directly without Node.

Both executables are static PIE binaries built with musl. The verified platform matrix is Linux x64 on Alpine 3.24.1 (musl 1.2.6) and the Freedesktop 25.08 runtime (glibc 2.42). No support is claimed for macOS, Windows, ARM or an untested minimum Linux kernel. The npm metadata declares OS/CPU; no libc package is needed. npm rejects unsupported hosts. With pnpm, use engine-strict=true to enforce platform rejection; its default configuration can install an incompatible package. A package manager may create its own command shim. The packaged executable itself has no Node or shell dependency.

Use the same version of both packages. PIN identifies the bytecode/runtime contract; SHA256SUMS and PROVENANCE.json identify this package's contents and recorded build inputs. These local records do not authenticate a publisher or prove reproducible builds. The source code is ISC; linked third-party code retains the licenses and notices listed in THIRD_PARTY.md and licenses/.

See the artifact contract and development guide.