Add CI workflow for running tests (#271)

* Add CI workflow for running tests

Adds a GitHub Actions workflow that runs tests on push and pull
requests to the main branch.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use cross-platform sed in doc.sh for CI compatibility

The macOS-specific `sed -i ''` syntax doesn't work on Linux.
Added the sedi() wrapper function that handles both platforms.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* fix: use HOME env var in test for CI compatibility

TERM is not available in CI environments (no terminal).
HOME is available in both local and CI environments.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: reteps

.github/workflows/test.yml

@@ -0,0 +1,26 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

scripts/doc.sh

@@ -16,6 +16,12 @@ export LINECLEAR="\033[1G\033[2K" # position to column 1; erase whole line
 export DIM="\033[0;2m"
 export RESET="\033[0;0m"
 
+# Note on the `sed` command:
+# On Linux, the -i switch can be used without an extension argument
+# On macOS, the -i switch must be followed by an extension argument (which can be empty)
+sedi () {
+    sed --version >/dev/null 2>&1 && sed -i -- "$@" || sed -i '' "$@"
+}
 
 printf $BASENAME$DOT$RESET" Building api.md"
 
@@ -43,9 +49,9 @@ mv ./temp-docs/common ./temp-docs/03
 npx concat-md --decrease-title-levels --dir-name-as-title --hide-anchor-links ./temp-docs > ./src/api.md
 
 # Remove `# 01`, `# 02`, `# 03` from the api.md
-sed -i '' 's/# 01//g' ./src/api.md
-sed -i '' 's/# 02//g' ./src/api.md
-sed -i '' 's/# 03//g' ./src/api.md
+sedi 's/# 01//g' ./src/api.md
+sedi 's/# 02//g' ./src/api.md
+sedi 's/# 03//g' ./src/api.md
 
 #rm -rf ./temp-docs
 

test/cortex/cortex-parse.test.ts

@@ -31,8 +31,8 @@ describe('CORTEX PARSING DIRECTIVES', () => {
     expect(validUa).toBe(true);
   });
   test('Environment variable directive', () => {
-    expect(validCortex('#env("TERM")')).toStrictEqual({
-      str: process.env['TERM'],
+    expect(validCortex('#env("HOME")')).toStrictEqual({
+      str: process.env['HOME'],
     });
   });
   test('Warning directive', () => {