updates 33.2 112

Makefile

@@ -28,11 +28,15 @@ export PYTHON
 # treat them as goals of their own, so each gets a no-op rule.
 ARGS := $(wordlist 2,$(words $(MAKECMDGOALS)),$(MAKECMDGOALS))
 ifneq ($(ARGS),)
+# Declares each extra word as a target that does nothing: `:` is an empty rule
+# body and `@` silences it. Without this, `make build sample` runs the build and
+# then fails with "No rule to make target 'sample'", because make reads every
+# word on the line as something it has been asked to build.
 $(eval $(ARGS):;@:)
 endif
 
 .DEFAULT_GOAL := help
-.PHONY: help build start stop cluster deploy component
+.PHONY: help build start stop dist docs cluster deploy component
 
 help:                          ## list targets
 	@grep -hE '^[a-z]+:.*?##' $(MAKEFILE_LIST) | sed 's/:.*##/\t/' | expand -t16
@@ -48,6 +52,14 @@ start:                         ## run a built room  [<room>] [-d] [--build]
 stop:                          ## stop a running room  [<room>]
 	bash ctrl/stop.sh $(or $(ARGS),$(ROOM))
 
+dist:                          ## compile the plexus UIs to single files  [<room>]
+	bash ctrl/dist.sh $(or $(ARGS),$(ROOM))
+
+# ── docs ───────────────────────────────────────────────────────────────────
+
+docs:                          ## documentation  [serve [port]|graphs [theme]]  (default serve)
+	bash ctrl/docs.sh $(or $(ARGS),serve)
+
 # ── cluster ────────────────────────────────────────────────────────────────
 
 cluster:                       ## shared kind cluster  [up|down|status]  (default status)