Add playable slice cauldron playbooks and holodeck measurement groundwork.

Deprecate WebGL from the default renderer chain, expand CursorLayer and
measure protocol design, retire city.load-by-letter for tool shortcuts, and
document Batch 1 playbooks (PB-01–PB-05) plus Holodeck cutover skeletons.

Author: SimHacker

.github/workflows/emscripten_build.yml

@@ -1,4 +1,6 @@
-# Manual runs only — avoids automatic deploy on every push to main.
+# Manual runs only — does NOT run on push to main.
+# Protects https://micropolisweb.com/ during development: merge freely; publish only when ready.
+#
 # Actions → Build Wasm Library with Emscripten → Run workflow
 #
 # What this does:
@@ -7,7 +9,7 @@
 #   3. Verify monorepo structure invariants (pnpm run verify:structure)
 #   4. Optionally generate Doxygen C++ API docs
 #   5. Build SvelteKit app (pnpm --filter micropolis run build) — includes Jekyll
-#   6. Deploy static site + optional Doxygen to GitHub Pages
+#   6. Deploy to GitHub Pages ONLY if you check "Deploy to GitHub Pages" (default: off)
 
 name: Build Wasm Library with Emscripten
 
@@ -18,10 +20,20 @@ on:
         description: Generate Doxygen C++ API HTML and publish it at /doc on Pages
         type: boolean
         default: true
+      deploy_to_pages:
+        description: >-
+          Deploy build to GitHub Pages (micropolisweb.com). Leave unchecked while
+          developing — verify the build first, then re-run with this enabled.
+        type: boolean
+        default: false
 
 permissions:
   contents: write
 
+concurrency:
+  group: micropolis-pages-deploy
+  cancel-in-progress: false
+
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -89,7 +101,10 @@ jobs:
           fi
 
       - name: Deploy to GitHub Pages
-        if: success() && github.ref == 'refs/heads/main'
+        if: >-
+          success() &&
+          github.ref == 'refs/heads/main' &&
+          inputs.deploy_to_pages == true
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pr-checks.yml

@@ -1,10 +1,6 @@
-# Lightweight checks that run on every push and PR — no Emscripten required.
-# Tests use the committed WASM artifacts in apps/micropolis/src/lib/.
-#
-# Jobs:
-#   structure  — verify monorepo layout invariants (20 assertions)
-#   build-ts   — TypeScript compile for vitamoo + mooshow + vitamoospace
-#   test       — Micropolis Vitest suite (real WASM in Node, 18 tests)
+# Lightweight checks on push/PR — no Emscripten, no GitHub Pages deploy.
+# The live demo at https://micropolisweb.com/ is unchanged by pushes to main.
+# Publish only via: Actions → "Build Wasm Library with Emscripten" → deploy_to_pages ✓
 
 name: PR Checks
 

apps/micropolis/README.md

@@ -52,6 +52,18 @@ pnpm run build
 
 Preview the production build with **`pnpm run preview`**.
 
+## Publishing (micropolisweb.com)
+
+The public demo at [micropolisweb.com](https://micropolisweb.com/) is **not** updated by pushes to `main`.
+
+| Action | Updates live site? |
+|--------|------------------|
+| `git push origin main` | No — runs PR Checks only |
+| `pnpm run dev` / `pnpm run preview` locally | No |
+| **Actions → Build Wasm Library with Emscripten** | Only if you check **Deploy to GitHub Pages** |
+
+Deploy defaults to **off**. Run the workflow without deploy to verify a production build; run again with deploy enabled when ready to publish.
+
 ## CLI
 
 One CLI exposes city-file tools, terminal visualizations, the WASM simulator, and the command bus:

apps/micropolis/src/lib/TileView.svelte

@@ -354,13 +354,6 @@
       spacePanHeld = true;
     }
 
-    if ((key >= "a") && (key <= "z")) { // letters — load city by first letter
-      event.preventDefault();
-      const letter = key.charCodeAt(0) - "a".charCodeAt(0);
-      void commandBus.dispatch('city.load-by-letter', commandContext(event, { letter }));
-      return;
-    }
-
     switch (key) {
 
       case " ": // space

apps/micropolis/src/lib/holodeck/createMeasureStore.svelte.ts

@@ -0,0 +1,124 @@
+/**
+ * Svelte 5 rune binding for holodeck sparse measure protocol.
+ * @see documentation/designs/map-compositing-and-measurement.md §3.4–§3.5
+ *
+ * FUTURE: multi-player collaborative tools (shared refs, role-scoped writable props,
+ * tool-as-vehicle) use the same bindProp/setProp path — see §3.5. Not implemented yet.
+ */
+import {
+	applyMeasureConstraint,
+	applyMeasurePatch,
+	createMeasureSnapshot,
+	getMeasureProp,
+	isMeasurePropWritable,
+	resolveMeasureConstraint,
+	type HolodeckStage,
+	type MeasureJson,
+	type MeasurePropertyConstraint,
+	type MeasureRef,
+	type MeasureSnapshot,
+	type MeasureValue,
+} from '@micropolis/render-core';
+
+export interface MeasureStoreOptions {
+	/** Refs to subscribe — sparse read/patch each frame. */
+	refs: MeasureRef[];
+}
+
+export type MeasureStore = ReturnType<typeof createMeasureStore>;
+
+/**
+ * Reactive measure snapshot tied to a holodeck stage.
+ * Call `tick()` after input/state changes or from rAF; returns true if DOM should relayout.
+ */
+export function createMeasureStore(stage: HolodeckStage, options: MeasureStoreOptions) {
+	const snapshot = $state<MeasureSnapshot>(createMeasureSnapshot(options.refs));
+
+	function get(ref: MeasureRef): MeasureValue | undefined {
+		return snapshot.values[ref];
+	}
+
+	function getProp(ref: MeasureRef, key: string): MeasureJson | undefined {
+		return getMeasureProp(get(ref), key);
+	}
+
+	function tick(): boolean {
+		stage.render();
+		const patch = stage.measurePatch(options.refs, snapshot.frame);
+		return applyMeasurePatch(snapshot, patch);
+	}
+
+	/** Push sparse property patches into plugins before render (two-way bind: UI → holodeck). */
+	function write(patches: Record<MeasureRef, Record<string, unknown>>): void {
+		stage.measureWrite({ op: 'write', schema_version: 1, patches });
+	}
+
+	/**
+	 * Write one bindable property with constraints (lineWidth, opacity, left, …).
+	 * Returns false if holodeck marked the key read-only.
+	 */
+	function setProp(
+		ref: MeasureRef,
+		key: string,
+		value: MeasureJson,
+		constraint?: MeasurePropertyConstraint,
+	): boolean {
+		const current = get(ref);
+		const resolved = resolveMeasureConstraint(key, constraint, current);
+		if (!isMeasurePropWritable(key, resolved, current)) return false;
+		const constrained = applyMeasureConstraint(value, resolved);
+		if (constrained === undefined) return false;
+		write({ [ref]: { [key]: constrained } });
+		return true;
+	}
+
+	/**
+	 * Two-way rune binding for one property on a ref.
+	 * Holodeck → UI on `tick()`; UI → holodeck on assignment.
+	 */
+	function bindProp(ref: MeasureRef, key: string, constraint?: MeasurePropertyConstraint) {
+		let local = $state<MeasureJson | undefined>(undefined);
+		let pushing = false;
+
+		function pull(): void {
+			if (pushing) return;
+			const raw = getProp(ref, key);
+			const resolved = resolveMeasureConstraint(key, constraint, get(ref));
+			local = applyMeasureConstraint(raw, resolved);
+		}
+
+		function push(value: MeasureJson): void {
+			pushing = true;
+			if (setProp(ref, key, value, constraint)) {
+				tick();
+				pull();
+			}
+			pushing = false;
+		}
+
+		pull();
+
+		return {
+			get current() {
+				return local;
+			},
+			set current(value: MeasureJson) {
+				push(value);
+			},
+			pull,
+			push,
+		};
+	}
+
+	return {
+		get snapshot() {
+			return snapshot;
+		},
+		get,
+		getProp,
+		setProp,
+		bindProp,
+		tick,
+		write,
+	};
+}