Clean up migrate zig compiler branch

Author: lukewilliamboswell

.github/workflows/deploy-docs.yml

@@ -33,7 +33,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install Zig
-        uses: mlugg/setup-zig@v2
+        uses: mlugg/setup-zig@8d6198c65fb0feaa111df26e6b467fea8345e46f # ratchet:mlugg/setup-zig@v2.0.5
         with:
           version: 0.16.0
 
@@ -97,7 +97,7 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Install Zig
-        uses: mlugg/setup-zig@v2
+        uses: mlugg/setup-zig@8d6198c65fb0feaa111df26e6b467fea8345e46f # ratchet:mlugg/setup-zig@v2.0.5
         with:
           version: 0.16.0
 

.github/workflows/release.yml

@@ -57,13 +57,7 @@ bench-folder*
 *.roc-format-failed-ast-after
 *.roc-format-failed-ast-before
 
-# Tests
-file-test
-example-stdin
-http-get-json
-file-read-buffered
-temp-dir
-env-var
+# Test artifacts
 out.txt
 
 # Downloaded Roc nightly
@@ -83,9 +77,6 @@ all_tests_output.log
 # Old build artifacts (platform/*.a was pre-migration location)
 platform/*.a
 
-ci/check_all_exposed_funs_tested
-ci/check_cargo_versions_match
-
 # build script artifacts
 build
 

.github/workflows/test_latest_release.yml

@@ -12,9 +12,9 @@ The pinned Roc compiler commit lives in `.roc-version`. To update it:
 2. Run `./ci/regenerate_glue.sh` to refresh `src/roc_platform_abi.rs`.
 3. Run `cargo check` and `./ci/all_tests.sh` to verify the new compiler works.
 
-## How to generate docs?
+## Documentation
 
-TODO describe how to generate docs once `roc docs` is implemented in the new compiler
+Generated Roc docs are currently disabled for this migration branch because `roc docs` is not implemented in the new compiler backend yet. Update this section and restore docs CI when that command is available again.
 
 ## Regenerating Rust Glue
 

.gitignore

@@ -5,7 +5,9 @@
 
 # basic-cli
 
-A Roc [platform](https://github.com/roc-lang/roc/wiki/Roc-concepts-explained#platform) to work with files, commands, HTTP, TCP, command line arguments,...
+A Roc [platform](https://github.com/roc-lang/roc/wiki/Roc-concepts-explained#platform) for command-line programs.
+
+This migration branch supports command execution, directories, environment variables, files, locales, paths, random seeds, sleeping, standard input/output/error, terminal raw mode, and UTC time. HTTP, TCP, SQLite, and URL helpers from the old API have not been ported to the new compiler backend yet.
 
 :eyes: **examples**:
   - [latest main branch](https://github.com/roc-lang/basic-cli/tree/main/examples)
@@ -36,3 +38,13 @@ The Rust host ABI is generated from `platform/main.roc` using Roc's `RustGlue.ro
 ```
 
 Commit `src/roc_platform_abi.rs` with any platform API change and the matching Rust host updates.
+
+### Verification
+
+Run the full local check before opening release or CI-facing changes:
+
+```sh
+./ci/all_tests.sh
+```
+
+The script checks generated glue, builds the host, checks and builds every example, and runs expect tests for examples with maintained scripts. When all target host libraries are present, it also bundles the platform, serves it from localhost, and tests examples against that bundle.

CONTRIBUTING.md

@@ -6,6 +6,8 @@ ROOT_DIR="$(dirname "$SCRIPT_DIR")"
 
 cd "$ROOT_DIR"
 
+EXAMPLE_NAMES=()
+
 # Cleanup function to restore examples and stop HTTP server
 cleanup() {
     echo ""
@@ -24,7 +26,7 @@ cleanup() {
     fi
 
     # Remove built binaries
-    for example in "${MIGRATED_EXAMPLES[@]}"; do
+    for example in "${EXAMPLE_NAMES[@]:-}"; do
         rm -f "examples/${example}"
     done
 
@@ -106,8 +108,15 @@ else
     echo "=== Skipping platform build (NO_BUILD=1) ==="
 fi
 
-# List of migrated examples that have expect tests
-MIGRATED_EXAMPLES=(
+EXAMPLES_DIR="${ROOT_DIR}/examples/"
+export EXAMPLES_DIR
+
+TESTS_DIR="${ROOT_DIR}/tests/"
+export TESTS_DIR
+
+# Examples with maintained expect tests. All examples are checked and built
+# below; this list only controls which built binaries are executed.
+EXPECT_EXAMPLES=(
     "command-line-args"
     "hello-world"
     "stdin-basic"
@@ -122,11 +131,9 @@ MIGRATED_EXAMPLES=(
     "env-var"
 )
 
-EXAMPLES_DIR="${ROOT_DIR}/examples/"
-export EXAMPLES_DIR
-
-TESTS_DIR="${ROOT_DIR}/tests/"
-export TESTS_DIR
+for roc_file in "${EXAMPLES_DIR}"*.roc; do
+    [ -f "$roc_file" ] && EXAMPLE_NAMES+=("$(basename "${roc_file%.roc}")")
+done
 
 # Check if all target libraries exist for bundling
 ALL_TARGETS_EXIST=true
@@ -188,10 +195,9 @@ else
     echo "Run './build.sh --all' first to test with bundled platform"
 fi
 
-# roc check migrated examples
 echo ""
 echo "=== Checking examples ==="
-for example in "${MIGRATED_EXAMPLES[@]}"; do
+for example in "${EXAMPLE_NAMES[@]}"; do
     echo "Checking: ${example}.roc"
     roc check "examples/${example}.roc"
 done
@@ -208,14 +214,13 @@ for test in "${TESTS_FILES[@]}"; do
     roc check "tests/${test}.roc"
 done
 
-# roc build migrated examples
 echo ""
 if [ "$USE_BUNDLE" = true ]; then
     echo "=== Building examples (using bundle) ==="
 else
     echo "=== Building examples (using local platform) ==="
 fi
-for example in "${MIGRATED_EXAMPLES[@]}"; do
+for example in "${EXAMPLE_NAMES[@]}"; do
     echo "Building: ${example}.roc"
     roc build "examples/${example}.roc"
     mv "./${example}" "examples/"
@@ -225,9 +230,14 @@ done
 echo ""
 echo "=== Running expect tests ==="
 FAILED=0
-for example in "${MIGRATED_EXAMPLES[@]}"; do
+for example in "${EXPECT_EXAMPLES[@]}"; do
     echo ""
     echo "--- Testing: $example ---"
+    if [ ! -f "ci/expect_scripts/${example}.exp" ]; then
+        echo "FAIL: missing expect script for $example"
+        FAILED=1
+        continue
+    fi
     set +e
     expect "ci/expect_scripts/${example}.exp"
     EXIT_CODE=$?