Improve onboarding quickstart and guidance

.github/workflows/ci.yml

@@ -53,6 +53,9 @@ jobs:
       - name: Zig version
         run: zig version
 
+      - name: Run macOS quickstart regression
+        run: bash ./platform/macos/scripts/quickstart-regression.sh
+
       - name: Build host artifacts
         run: zig build
 

README.md

@@ -51,7 +51,7 @@ zig build
 ./zig-out/bin/spiderweb-control \
   --auth-token <admin-token> \
   workspace_up \
-  '{"name":"Demo","vision":"Mounted workspace demo","template_id":"dev","activate":false}'
+  '{"name":"Demo","vision":"Mounted workspace demo","template_id":"just_try_it","activate":false}'
 
 # Mount that workspace into the local filesystem
 ./zig-out/bin/spiderweb-fs-mount \

platform/macos/README.md

@@ -68,3 +68,20 @@ For background on Apple’s starting point, see [Building a passthrough file sys
 
 For shipping Spiderweb to a normal SIP-enabled Mac, see the release packaging guide in [RELEASE.md](/Users/deanocalver/Documents/Spider/Spiderweb/platform/macos/RELEASE.md).
 For the planned end-user installer and first-run flow, see [INSTALLER_UX.md](/Users/deanocalver/Documents/Spider/Spiderweb/platform/macos/INSTALLER_UX.md).
+
+## Quickstart Regression
+
+Run the onboarding regression checks with:
+
+```bash
+./platform/macos/scripts/quickstart-regression.sh
+```
+
+That script compiles a temporary Swift harness against `SpiderwebAppController.swift` and verifies the quickstart state machine behaviors that are easy to regress:
+
+- switching presets resets the targeted workspace and drive
+- persisted blocked quickstart state resumes cleanly on relaunch
+- unrelated workspaces are not accidentally adopted during resume
+- already-mounted native drive errors are treated as satisfied only when the drive is actually active
+
+The default Spiderweb first-run preset now uses the dedicated `just_try_it` workspace template instead of the broader `dev` template, so onboarding stays intentionally minimal even if the development template grows over time.

platform/macos/RELEASE.md

@@ -77,6 +77,7 @@ Optional flags:
 By default the script:
 
 - builds the Zig CLI payload for the current host architecture
+- runs the macOS quickstart regression harness
 - archives and exports `Spiderweb.app` for `developer-id` distribution
 - builds a signed `spiderweb.fs` wrapper bundle
 - builds a signed flat installer package