test: add offline regression harness for archive runner (#1)

* test: add offline runner regression harness

* docs: document offline runner regression tests

* ci: run offline runner regression tests

* ci: update GitHub Actions runtime versions

Author: Charlie-Wang-03

.github/workflows/offline-runner-tests.yml

@@ -0,0 +1,29 @@
+name: Offline runner regression tests
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  unittest:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.11"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Run offline runner regression tests
+        run: python -m unittest discover -s tests -p "test_*.py" -v

README.md

@@ -32,7 +32,9 @@ Place this repository directly inside the initialized Moonshine runtime home, no
     ├── README.md
     ├── run_archive.py
     ├── archive-format-specification.md
-    ├── skills/                           
+    ├── tests/
+    │   └── test_run_archive_offline.py
+    ├── skills/
     │   ├── math-object-origin-archive/
     │   │   └── SKILL.md
     │   └── verify-math-object-origin-archive/
@@ -107,3 +109,15 @@ The following directories are created automatically when the runner is used and
 
 - Final archives: `Creative-Intelligence/archives/<input-name>/`
 - Queue state and project/session associations: `Creative-Intelligence/runs/<input-name>.state.json`
+
+## Offline regression tests
+
+The deterministic runner contracts can be tested from a standalone checkout without an initialized Moonshine runtime, provider credentials, network access, or model calls. The test harness uses only the Python standard library and provides import-time stubs for the narrow Moonshine symbols required to load `run_archive.py`.
+
+Run from the `Creative-Intelligence` repository root:
+
+```bash
+python -m unittest discover -s tests -p "test_*.py" -v
+```
+
+These tests cover runner-owned deterministic behavior such as queue validation, immutable queue state, format-placeholder checks, verifier-output integrity, archive overwrite protection, and provider preflight logic. They do **not** simulate Moonshine agent execution, session storage, MCP tools, or real verification-provider behavior; those remain runtime integration concerns.