Orkuncakilkaya
9ed0070039
Follow-up to #31: the doc/lint/grammar checks moved to Ludic there; this ports the remaining docgen piece (gen.py / check.py / palette.py) so nothing in the documentation pipeline is Python any more. Three new `x` subcommands, all in Ludic and compiled by Ludic: - x docs-gen [--out DIR] the static-site generator: parses docs/language/** front-matter + bodies (fences, Parameters:), builds the section/symbol model, reads the asset templates, and emits every page + ns/color/api pages + the landing page + ludic-highlight.js + symbols.json + .nojekyll. - x docs-check [DIR] the coverage / integrity guard (required files, a page per inventory.json symbol, duplicate-token and one-dir-per-namespace guards, highlighter link targets). - x docs-palette the named-colour source of truth: the palette table moved into tools/x/docgen.ludic, emitting emit_color.ludic (pointer, not ptr) + palette.json. Verified against the Python oracle: `x docs-gen` reproduces all 466 output files BYTE-FOR-BYTE (a Ludic json.dumps/html.escape/front-matter port — ordered dicts, indent=2 vs compact, ensure_ascii \uXXXX, codepoint-aware truncation), and `x docs-check` matches check.py's pass/fail output. Wired into `x test` as a gate (docs-gen -> docs-check on a fresh site; docs-palette stays byte-identical). CI swap: ci.yml and docs.yml call the Ludic generator; docs.yml drops the python:3.12 container and bootstraps the toolchain from the IR seed instead. tools/docgen/{gen,check,palette}.py deleted; only assets/ + inventory.json remain. Completes #31's criterion 3. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
86 lines
4 KiB
YAML
86 lines
4 KiB
YAML
name: ci
|
|
|
|
# Build the language toolchain from its IR seed and run the regression suites on
|
|
# every push to main and every pull request. Until this landed the only workflow
|
|
# was docs.yml, so nothing gated a change on `x test` / `x test-tools` or on the
|
|
# compiler even building from the seed. See also bootstrap.yml, which proves the
|
|
# C-free self-rebuild reproduces the seed byte-for-byte.
|
|
on:
|
|
push:
|
|
branches: [main]
|
|
pull_request:
|
|
workflow_dispatch: {}
|
|
|
|
jobs:
|
|
build-and-test:
|
|
# Same runner label the docs workflow uses — the self-hosted Forgejo runner
|
|
# advertises `docker`, not the GitHub-ism `ubuntu-latest`.
|
|
runs-on: docker
|
|
# Reuse the runner's own base image (Debian bookworm with git + node already
|
|
# present) and add just the one thing the toolchain needs: a modern clang
|
|
# (LLVM 16 — the IR uses opaque pointers, so clang 15+ is required). The docs
|
|
# generator and its guards are now Ludic, so the job carries no Python. A
|
|
# prebuilt image with clang baked in is the obvious future speed-up (see
|
|
# issue #33's packaging work).
|
|
container: node:20-bookworm
|
|
steps:
|
|
- name: Install clang-16
|
|
run: |
|
|
set -eu
|
|
export DEBIAN_FRONTEND=noninteractive
|
|
apt-get update -qq
|
|
apt-get install -y -qq --no-install-recommends clang-16 git ca-certificates
|
|
clang-16 --version | head -1
|
|
|
|
- name: Check out the triggering commit
|
|
run: |
|
|
set -eu
|
|
git config --global --add safe.directory '*'
|
|
git clone https://git.workshopsoft.io/workshopsoft/ludic.git .
|
|
git checkout "${GITHUB_SHA}" 2>/dev/null || git checkout "${GITHUB_REF_NAME:-main}"
|
|
git log --oneline -1
|
|
# The toolchain is macOS-first; on this Linux runner it links against a
|
|
# tiny C-free IR shim that supplies the Darwin standard-stream globals
|
|
# (__stdoutp/__stderrp) over glibc's stdout/stderr. Injected through
|
|
# LUDIC_CC so every clang invocation — the seed bootstrap, `x build`,
|
|
# and each compiled test program — picks it up. Absolute path so it
|
|
# still resolves if a step changes directory.
|
|
echo "LUDIC_CC=clang-16 $(pwd)/tools/ci/linux_stdio_shim.ll" >> "$GITHUB_ENV"
|
|
echo "LUDIC_HOME=$(pwd)" >> "$GITHUB_ENV"
|
|
|
|
- name: Bootstrap the toolchain from the IR seed (clang only)
|
|
run: |
|
|
set -eu
|
|
# clang assembles + links the compiler's own checked-in IR seed (plus
|
|
# the Linux stdio shim), then that seed builds the whole toolchain into
|
|
# bin/ — ludicc, ludic, x, ludic-fmt, ludic-lsp. No C compiler, no
|
|
# pre-built binaries: the language builds itself from source + seed.
|
|
mkdir -p bin
|
|
clang-16 tools/ci/linux_stdio_shim.ll selfhost/ludicc.seed.ll -o bin/ludicc
|
|
bin/ludicc tools/x/main.ludic -o bin/x
|
|
bin/x build
|
|
|
|
- name: Regression suite (x test)
|
|
run: bin/x test
|
|
|
|
- name: Editor-toolchain suite (x test-tools)
|
|
# Grammar/lexer/vocabulary sync, ludic-fmt idempotence (the project's
|
|
# formatting contract — hand alignment is deliberately preserved, so the
|
|
# gate is fmt(fmt(x)) == fmt(x), not fmt(x) == x), and the JSON/XML editor
|
|
# assets. Cross-file LSP behaviour and the golden renders are macOS-ABI
|
|
# bound and skip here — visibly — until the runtime's directory walk and
|
|
# windowing are portable.
|
|
run: bin/x test-tools
|
|
|
|
- name: Docs cover the implementation
|
|
run: |
|
|
set -eu
|
|
# The whole docs toolchain is written in Ludic and runs through x —
|
|
# no Python anywhere. check-impl / check-vocabulary / check-docs guard
|
|
# the sources; docs-gen builds the site and docs-check is its coverage
|
|
# + integrity guard. (check-vocabulary also runs in `x test-tools`.)
|
|
bin/x check-impl
|
|
bin/x check-vocabulary
|
|
bin/x check-docs
|
|
bin/x docs-gen --out build/pages
|
|
bin/x docs-check build/pages
|