whole new world

.buckconfig

@@ -0,0 +1,23 @@
+[repositories]
+root = .
+prelude = prelude
+toolchains = toolchains
+none = none
+
+[repository_aliases]
+config = prelude
+ovr_config = prelude
+fbcode = none
+fbsource = none
+fbcode_macros = none
+buck = none
+
+[parser]
+target_platform_detector_spec = target:root//...->prelude//platforms:default
+
+[project]
+ignore = .git
+
+[llvm]
+prefix = /opt/homebrew/opt/llvm
+suffix =

.github/workflows/bootstrap.yml

@@ -0,0 +1,199 @@
+# The full buck2 bootstrap matrix, as a reusable workflow: ci.yml runs
+# it on every push/PR, release.yml runs the SAME jobs on a version tag
+# (release-P3's "a release is a green matrix" is literal — one
+# definition, two callers).
+#
+# Per platform (macOS arm64, Linux arm64/x86_64), sequential targets —
+# buck2 shares artifacts between them, so the stage ladder (stage1
+# builds feed stage2/3) costs one traversal:
+#
+#   test-eir     EIR unit tests (node-hosted)
+#   test-stage0  full suite against the node-hosted compiler
+#   test-stage1  suite against the self-compiled compiler
+#   test-stage2  suite against stage1's self-compile
+#   test-stage3  suite + the stage2/stage3 byte-identity fixed point
+#
+# then the dist tarball + its smoke tests (release-P1) and the package
+# smokes (release-P2), uploading echojs-dist-<platform> artifacts.
+name: bootstrap
+
+on:
+  workflow_call:
+
+jobs:
+  bootstrap-macos-arm64:
+    name: bootstrap-macos-arm64
+    runs-on: macos-15 # arm64
+    timeout-minutes: 120
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install llvm
+        run: |
+          brew install llvm
+          "$(brew --prefix llvm)/bin/llvm-config" --version
+
+      # the facebook/buck2 `latest` release binary, same as before —
+      # the action just owns the platform selection and unpacking
+      - uses: dtolnay/install-buck2@latest
+      - run: buck2 --version
+
+      # unpinned (runtime-P3): the value-based harness serializes logged
+      # values itself (test/harness-console-shim.js) on both the node and
+      # ejs sides, so baselines no longer depend on node's inspect format
+      # (verified: 22.4.0 and 22.23.2 generate byte-identical baselines)
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+
+      - name: npm ci
+        run: npm ci
+
+      # the node-hosted (stage0) compiler drives llvm through this
+      # node-gyp native addon; buck picks up the built artifact
+      - name: Build the node-llvm addon
+        run: ./node-llvm/build-addon.sh "$(brew --prefix llvm)"
+
+      - name: TypeScript typecheck
+        run: |
+          node node_modules/typescript/bin/tsc -p tsconfig.json
+          node node_modules/typescript/bin/tsc -p test --noEmit
+
+      - name: buck2 bootstrap matrix
+        run: |
+          buck2 build \
+            //:test-eir \
+            //:test-stage0 \
+            //:test-stage1 \
+            //:test-stage2 \
+            //:test-stage3
+
+      # the relocatable dist artifact + its installed-layout smoke test
+      # (release-P1); the stage builds above are shared, so this only
+      # adds the repack + smoke compile
+      - name: dist artifact
+        run: |
+          buck2 build //:test-dist
+          buck2 build //:dist --out dist-out/
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: echojs-dist-macos-arm64
+          path: dist-out/*.tar.gz
+          if-no-files-found: error
+
+      # release-P2 package smokes.  The formula comes from the tarball
+      # just built (file:// url) via a throwaway local tap; the npm
+      # wrapper installs through its EJS_NPM_TARBALL override.
+      # release-P3 points both at hosted release assets instead.
+      - name: package smoke (homebrew + npm)
+        run: |
+          brew tap-new --no-git toshok/echojs-ci
+          ./packaging/homebrew/make-formula.sh \
+            --tarball dist-out/echojs-*.tar.gz \
+            --out "$(brew --repository)/Library/Taps/toshok/homebrew-echojs-ci/Formula/echojs.rb"
+          brew install toshok/echojs-ci/echojs
+          echo 'console.log(`ok ${[1,2].map((x) => x + 1).join("")}`)' > "$RUNNER_TEMP/smoke.js"
+          "$(brew --prefix)/bin/ejs" -q -o "$RUNNER_TEMP/smoke.exe" "$RUNNER_TEMP/smoke.js"
+          test "$("$RUNNER_TEMP/smoke.exe")" = "ok 23"
+          brew test echojs
+          brew uninstall echojs
+
+          cd "$RUNNER_TEMP"
+          npm pack "$GITHUB_WORKSPACE/packaging/npm"
+          mkdir npm-smoke && cd npm-smoke
+          npm init -y > /dev/null
+          EJS_NPM_TARBALL="$(echo "$GITHUB_WORKSPACE"/dist-out/echojs-*.tar.gz)" \
+            npm install --no-fund --no-audit ../pirouette-echojs-*.tgz
+          ./node_modules/.bin/ejs -q -o smoke.exe ../smoke.js
+          test "$(./smoke.exe)" = "ok 23"
+
+      - name: Surface test logs on failure
+        if: failure()
+        run: |
+          find buck-out/v2 -name "test-*.log" -newer package.json 2>/dev/null | while read -r f; do
+            echo "=== $f ==="
+            tail -60 "$f"
+          done || true
+
+  bootstrap-linux:
+    name: bootstrap-linux-${{ matrix.arch }}
+    runs-on: ${{ matrix.runner }}
+    timeout-minutes: 150
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - arch: arm64
+            runner: ubuntu-24.04-arm
+          - arch: x86_64
+            runner: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive
+
+      - name: Install packages
+        run: |
+          sudo apt-get update -qq
+          sudo apt-get install -y -qq build-essential cmake libunwind-dev libuv1-dev
+
+      - name: Install llvm 22
+        run: |
+          curl -sSf https://apt.llvm.org/llvm.sh -o /tmp/llvm.sh
+          chmod +x /tmp/llvm.sh
+          sudo /tmp/llvm.sh 22
+          /usr/lib/llvm-22/bin/llvm-config --version
+          # prelude's cxx toolchain wants a bare clang++ on PATH
+          echo "/usr/lib/llvm-22/bin" >> "$GITHUB_PATH"
+
+      - uses: dtolnay/install-buck2@latest
+      - run: buck2 --version
+
+      # unpinned (runtime-P3) — see the macOS job's note
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+
+      - name: npm ci
+        run: npm ci
+
+      - name: Build the node-llvm addon
+        run: ./node-llvm/build-addon.sh /usr/lib/llvm-22
+
+      - name: buck2 bootstrap matrix
+        run: |
+          buck2 build --config llvm.prefix=/usr/lib/llvm-22 \
+            //:test-eir \
+            //:test-stage0 \
+            //:test-stage1 \
+            //:test-stage2 \
+            //:test-stage3
+
+      # release-P1 — see the macOS job's note
+      - name: dist artifact
+        run: |
+          buck2 build --config llvm.prefix=/usr/lib/llvm-22 //:test-dist
+          buck2 build --config llvm.prefix=/usr/lib/llvm-22 //:dist --out dist-out/
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: echojs-dist-linux-${{ matrix.arch }}
+          path: dist-out/*.tar.gz
+          if-no-files-found: error
+
+      # release-P2 — the npm wrapper against the tarball just built
+      # (the prefix installer is smoke-tested inside //:test-dist)
+      - name: package smoke (npm)
+        run: |
+          cd "$RUNNER_TEMP"
+          npm pack "$GITHUB_WORKSPACE/packaging/npm"
+          mkdir npm-smoke && cd npm-smoke
+          npm init -y > /dev/null
+          EJS_NPM_TARBALL="$(echo "$GITHUB_WORKSPACE"/dist-out/echojs-*.tar.gz)" \
+            npm install --no-fund --no-audit ../pirouette-echojs-*.tgz
+          echo 'console.log(`ok ${[1,2].map((x) => x + 1).join("")}`)' > smoke.js
+          ./node_modules/.bin/ejs -q -o smoke.exe smoke.js
+          test "$(./smoke.exe)" = "ok 23"