CLI improvements

.github/scripts/smoke-test.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+# Smoke tests for morpho6 CLI (install / PR gate).
+set -euo pipefail
+
+MORPHO6="${MORPHO6:-morpho6}"
+
+expect_ok() {
+  local desc="$1"
+  shift
+  echo "==> $desc"
+  "$@"
+}
+
+expect_fail() {
+  local desc="$1"
+  shift
+  echo "==> $desc (expect failure)"
+  if "$@"; then
+    echo "expected failure, but succeeded: $*" >&2
+    exit 1
+  fi
+}
+
+expect_contains() {
+  local desc="$1"
+  local needle="$2"
+  shift 2
+  echo "==> $desc"
+  local out
+  out="$("$@" 2>&1)" || true
+  if ! grep -Fq -- "$needle" <<<"$out"; then
+    echo "expected output to contain: $needle" >&2
+    echo "got:" >&2
+    echo "$out" >&2
+    exit 1
+  fi
+}
+
+# Basic eval / version / help
+expect_ok "version" "$MORPHO6" --version
+expect_ok "eval" "$MORPHO6" -e 'print(1)'
+expect_ok "multiple -e preamble" "$MORPHO6" -e 'var x = 1' -e 'print(x)'
+
+# Help queries
+expect_contains "CLI usage" "Usage: morpho6" "$MORPHO6" --help
+expect_contains "help index topic" "Topics:" "$MORPHO6" --no-color --help help
+expect_contains "help Matrix" "Matrix" "$MORPHO6" --no-color --help Matrix
+expect_fail "unknown help topic" "$MORPHO6" --no-color --help NotARealTopicXYZ123
+
+# Option parsing
+expect_ok "workers" "$MORPHO6" --workers 2 -e 'print(1)'
+expect_ok "disassemble only" "$MORPHO6" -D -e 'print(1)'
+expect_contains "disassemble with source" ">>>    1 :" "$MORPHO6" --no-color -dl -e 'print(1)'
+
+# -D must not execute (disassembly may still mention constants)
+out="$("$MORPHO6" -D -e 'print("EXECUTED")' 2>&1)" || true
+if grep -Eq '^EXECUTED$' <<<"$out"; then
+  echo "-D should not execute the program" >&2
+  echo "$out" >&2
+  exit 1
+fi
+
+# Failure exit codes
+expect_fail "missing list file" "$MORPHO6" -l /no/such/file.morpho
+expect_fail "bad eval" "$MORPHO6" -e 'var x ='
+expect_fail "unknown option" "$MORPHO6" --not-a-real-option
+
+# File + preamble
+tmp="$(mktemp /tmp/morpho-smoke.XXXXXX.morpho)"
+trap 'rm -f "$tmp"' EXIT
+printf 'print(x)\n' >"$tmp"
+expect_ok "eval preamble + file" "$MORPHO6" -e 'var x = 7' "$tmp"
+
+# Piped stdin + preamble
+expect_ok "eval preamble + stdin" bash -c "printf 'print(x)\n' | $MORPHO6 -e 'var x = 3'"
+
+# NO_COLOR / --no-color should not emit CSI sequences for help
+out="$(NO_COLOR=1 "$MORPHO6" --help Matrix 2>&1)" || true
+if grep -Eq $'\x1B\[' <<<"$out"; then
+  echo "NO_COLOR=1 still produced ANSI escapes" >&2
+  exit 1
+fi
+
+echo "All smoke tests passed."

.github/workflows/basic-install.yml

@@ -0,0 +1,38 @@
+name: Basic install
+
+on:
+  push:
+    branches: [ "main", "inline" ]
+  pull_request:
+    branches: [ "main", "inline" ]
+
+jobs:
+  basic-install:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v5
+
+    - name: Install Morpho dependencies
+      run: |
+        sudo apt update
+        sudo apt install -y libsuitesparse-dev liblapacke-dev libunistring-dev
+
+    - name: Build and install Morpho
+      run: |
+        git clone --depth 1 --branch dev https://github.com/Morpho-lang/morpho.git
+        cd morpho
+        cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+        cmake --build build --config Release
+        sudo cmake --install build --config Release
+        sudo ldconfig
+
+    - name: Build and install morpho-cli
+      run: |
+        cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+        cmake --build build --config Release
+        sudo cmake --install build --config Release
+
+    - name: Smoke test morpho6
+      run: |
+        chmod +x .github/scripts/smoke-test.sh
+        .github/scripts/smoke-test.sh

.gitignore

@@ -5,3 +5,5 @@ build-xcode/*
 .vscode/*
 .vscode/settings.json
 /.vscode
+REVIEW.md
+/dist

README.md

@@ -2,17 +2,13 @@
 
 # Morpho-cli
 
-A terminal app for the [morpho language](https://github.com/Morpho-lang/morpho).  Improved unicode support requires an external library e.g. [libgrapheme](https://libs.suckless.org/libgrapheme/) or [libunistring](https://www.gnu.org/software/libunistring/).
+A terminal app for the [morpho language](https://github.com/Morpho-lang/morpho) using the [inline line editor](https://github.com/Morpho-lang/inline).  Improved unicode support requires an external library e.g. [libgrapheme](https://libs.suckless.org/libgrapheme/) or [libunistring](https://www.gnu.org/software/libunistring/).
 
 Like morpho itself, Morpho-cli is released under an MIT license (see the LICENSE file for details). See the [main morpho repository](https://github.com/Morpho-lang/morpho) for information about contributing etc. Please report any issues or feature requests about the morpho-cli terminal app specifically here: suggestions for improvement are very welcome. 
 
 ## Installation
 
-For this release, morpho can be installed on all supported platforms using the homebrew package manager. Alternatively, the program can be installed from source as described below. 
-
-### Install with homebrew
-
-The simplest way to install morpho-cli is through the [homebrew package manager](https://brew.sh). To do so:
+The simplest way to install the morpho terminal app is to use the [homebrew package manager](https://brew.sh). To do so:
 
 1. If not already installed, install homebrew on your machine as described on the [homebrew website](https://brew.sh)
 
@@ -26,7 +22,36 @@ brew install morpho morpho-cli morpho-morphoview morpho-morphopm
 
 If you need to uninstall morpho, simply open a terminal and type `brew uninstall morpho-cli morpho-morphoview morpho`. It's very important to uninstall the homebrew morpho in this way before attempting to install from source as below.
 
-### Install from source
+## Running
+
+To run type, 
+
+    morpho6
+
+into a terminal. The terminal app takes a number of optional arguments:
+
+| Option | Description |
+|--------|-------------|
+| `-h`, `--help [query]` | Show CLI help, or look up a language help topic |
+| `-v`, `--version` | Show version information |
+| `-c`, `--check` | Check syntax without executing |
+| `-e`, `--eval <code>` | Execute a code string (before file/REPL if combined) |
+| `-i`, `--interactive` | Enter REPL after running a file |
+| `-l`, `--list <file>` | List a file with syntax highlighting |
+| `-d`, `--disassemble` | Show disassembly |
+| `-D` | Disassemble only (no execution) |
+| `-dl` | Disassemble with source listing |
+| `-debug`, `--debug` | Enable debugger |
+| `-O`, `--optimize` | Enable optimizations |
+| `-profile`, `--profile` | Enable profiling |
+| `--no-color` | Disable syntax highlighting |
+| `-w`, `--workers <n>` | Set number of worker threads |
+
+If no file is specified, morpho enters interactive mode. If stdin is piped or redirected, morpho reads and executes from stdin. Any options after the file name are passed to the morpho program and are available from the `System` class:
+
+    var args = System.arguments()
+
+## Manual install from source
 
 To install, clone this repository:
 
@@ -35,13 +60,8 @@ To install, clone this repository:
 and then,
 
     cd morpho-cli 
-    mkdir build
-    cd build
-    cmake -DCMAKE_BUILD_TYPE=Release ..
-    make install 
+    cmake -S . -B build
+    cmake --build build --config Release
+    sudo cmake --install build --config Release
 
-You may need to use sudo make install.
-
-To run,
-
-    morpho6
+This manual build installs into '/usr/local/bin' by default.