Merge pull request #18 from nova-rey/codex/add-ci-workflow-for-installer-runtime

Author: nova-rey

.github/workflows/installer-runtime-ci.yml

@@ -0,0 +1,31 @@
+name: Screaming Penguin Installer Runtime CI
+
+on:
+  push:
+    paths:
+      - "installer/runtime/**"
+      - ".github/workflows/installer-runtime-ci.yml"
+  pull_request:
+    paths:
+      - "installer/runtime/**"
+      - ".github/workflows/installer-runtime-ci.yml"
+  workflow_dispatch:
+
+jobs:
+  shell-syntax:
+    name: Shell Syntax Check (Installer Runtime)
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Show environment info
+        run: |
+          uname -a
+          echo "Shell: $SHELL"
+
+      - name: POSIX shell syntax check for installer runtime scripts
+        run: |
+          echo "[CI] Running 'sh -n' on installer/runtime scripts..."
+          find installer/runtime -type f -name "*.sh" -print0 | xargs -0 sh -n

docs/CI_OVERVIEW.md

@@ -137,3 +137,21 @@ This workflow does not run on every push or pull request to avoid
 overloading Debian mirrors and to keep PR latency low. It is intended
 for periodic validation of the rootfs builder and can be triggered
 manually when needed.
+
+## Installer Runtime CI (Phase 5)
+
+The installer runtime shell scripts are validated by a dedicated CI workflow:
+
+- **Workflow file:** `.github/workflows/installer-runtime-ci.yml`
+- **Triggers:**
+  - On push and pull request affecting `installer/runtime/**`
+  - Manual (`workflow_dispatch`)
+
+The job performs a POSIX shell syntax check using `sh -n` over all
+`installer/runtime/*.sh` files. This ensures that the installer orchestration
+and helper scripts remain syntactically valid without executing them or
+touching any block devices.
+
+This workflow complements the main image build and QEMU smoke tests by
+providing a fast, low-risk verification path focused specifically on the
+installer runtime.

docs/SP_BIBLE.md

@@ -102,3 +102,14 @@ GPT + EFI + ext4, rootfs extraction, chroot-based system configuration
 machine in sp-installer. Audio hooks were implemented as best-effort helpers
 for startup and completion. Initramfs wiring and CI coverage remain for later
 checkpoints.
+
+## Entry 011 — Phase 5 Installer CI and Polish
+
+**Date:** 2025-11-16
+
+Completed Phase 5 by adding CI coverage for the installer runtime scripts.
+Introduced a dedicated GitHub Actions workflow (`installer-runtime-ci.yml`)
+that runs `sh -n` over all installer/runtime shell scripts on relevant pushes
+and pull requests. Updated CI_OVERVIEW.md to document this workflow. No
+runtime behavior changes were made in this checkpoint; it strictly improves
+confidence in the installer shell code.