Rewrites

.gitignore

@@ -108,3 +108,4 @@ Thumbs.db
 ehthumbs.db
 Desktop.ini
 
+.obsidian/

Makefile

@@ -1,3 +1,5 @@
+SHELL := /bin/bash
+
 TEX_MAIN := tex/computer.tex
 BUILD_DIR := build
 OUT_PDF := computer.pdf
@@ -6,6 +8,7 @@ SVG_SRCS := $(wildcard svg/*.svg)
 SVG_PDFS := $(SVG_SRCS:.svg=.pdf)
 
 .PHONY: all clean
+.PHONY: progress
 
 all: $(OUT_PDF)
 
@@ -35,3 +38,24 @@ clean:
 	latexmk -C -output-directory=$(BUILD_DIR) $(TEX_MAIN) || true
 	rm -rf $(BUILD_DIR) $(OUT_PDF)
 	rm -f tex/computer.{aux,log,out,fls,fdb_latexmk,synctex.gz,pdf}
+
+progress:
+	@set -e; \
+	  file="ROADMAP.md"; \
+	  done=$$(grep -ao "✅" "$$file" | wc -l | tr -d " "); \
+	  doing=$$(grep -ao "⏳" "$$file" | wc -l | tr -d " "); \
+	  todo=$$(grep -ao "◽️" "$$file" | wc -l | tr -d " "); \
+	  total=$$((done + doing + todo)); \
+	  if [ $$total -eq 0 ]; then pct=0; else pct=$$(((100*done + total/2)/total)); fi; \
+	  width=20; filled=$$(((pct*width + 50)/100)); \
+	  bar_short="["; for ((i=1;i<=width;i++)); do if [ $$i -le $$filled ]; then bar_short="$$bar_short█"; else bar_short="$$bar_short░"; fi; done; bar_short="$$bar_short]"; \
+	  width2=49; filled2=$$(((pct*width2 + 50)/100)); \
+	  bar_long="["; for ((i=1;i<=width2;i++)); do if [ $$i -le $$filled2 ]; then bar_long="$$bar_long█"; else bar_long="$$bar_long░"; fi; done; bar_long="$$bar_long]"; \
+	  bottom="0   10   20   30   40   50   60   70   80   90  100"; \
+	  for f in ROADMAP.md README.md; do \
+	    [ -f "$$f" ] || continue; \
+	    PROGPCT="$${pct}% ($${done}/$${total})" perl -0777 -CS -Mutf8 -pi -e 'my $$r=$$ENV{PROGPCT}; s|<!-- PROGRESS_PCT(?:_README)? -->.*?<!-- /PROGRESS_PCT(?:_README)? -->|<!-- PROGRESS_PCT -->$$r<!-- /PROGRESS_PCT -->|sg' "$$f"; \
+	    PROGBAR_SHORT="$${bar_short}" perl -0777 -CS -Mutf8 -pi -e 'my $$r=$$ENV{PROGBAR_SHORT}; s|<!-- PROGRESS_BAR(?:_README)? -->.*?<!-- /PROGRESS_BAR(?:_README)? -->|<!-- PROGRESS_BAR -->$$r<!-- /PROGRESS_BAR -->|sg' "$$f"; \
+	    PROGBAR_LONG="$${bar_long}" BOTTOM="$${bottom}" perl -0777 -CS -Mutf8 -pi -e 'my ($$r,$$b)=@ENV{qw/PROGBAR_LONG BOTTOM/}; s|(<!-- progress -->\n```text\n)[^\n]*\n[^\n]*\n(```\n<!-- /progress -->)|$$1$$r\n$$b\n$$2|sg' "$$f"; \
+	  done; \
+	  echo "Updated progress to $${pct}% ($${done}/$${total}) across ROADMAP.md and README.md"

README.md

@@ -14,6 +14,20 @@
 <p>By James Ross</p>
 </div>
 
+## Status
+
+**Overall Progress:** <!-- PROGRESS_PCT -->39% (178/460)<!-- /PROGRESS_PCT -->  
+<!-- PROGRESS_BAR -->��]<!-- /PROGRESS_BAR -->
+
+[Roadmap & checklist →](ROADMAP.md)
+
+<!-- progress -->
+```text
+��]
+0   10   20   30   40   50   60   70   80   90  100
+```
+<!-- /progress -->
+
 ## What if computation had a shape?
 
 Not metaphorically. Not as a diagram on a whiteboard. But as a navigable geometry, where programs move through possibility space, bugs are wrong turns, optimizations are shorter paths, and every execution leaves a trail you can walk backward.

tex/01-note-to-the-reader.tex

@@ -10,7 +10,16 @@ \chapter*{Part I --- The Universe as Rewrite}
 \textbf{Computation is what reality is made of, not what we do \emph{to} reality.}
 \end{quote}
 
-Up to now, most of us have only seen the shadows of this truth—projected, flattened, and made safe by decades of comforting abstractions. This book asks you to turn toward the source, to see the forms behind the shadows. Everything that follows traces the geometry of that world.
+Up to now, most of us have only interacted with computation through 
+\emph{abstractions}—interfaces designed to hide structure, flatten history, and 
+sanitize the underlying machinery. What we call “code” is often just the 
+silhouette of a far richer process.
+
+This book asks you to look directly at that process: to stop reasoning from
+interfaces and start reasoning from \emph{structure}. Once you do, a different 
+picture emerges—a picture with geometry, causality, and motion. Everything that 
+follows is an attempt to map that deeper layer with precision.
+
 
 \subsection*{Why This Matters: From Black Boxes to Glass Boxes}
 
@@ -123,7 +132,7 @@ \subsection*{A Call to Action: Go Bend Some Universes}
 We have laid the foundation for a computational cosmology. You now hold the keys to a system that replaces probabilistic guesswork with deterministic geometry, and opaque processes with absolute provenance. This is not an evolution. It is an architectural revolution.
 
 \begin{quote}
-\textbf{Those who finish this book will not see computation the same way again. Once you learn to perceive the geometry beneath the code, the old mindset of “just running the code” collapses into a kind of flatness. It is like stepping outside Plato’s cave: the familiar shadows of computation give way to a full, three-dimensional world of structures, laws, and histories that were always there, waiting to be seen.}
+\textbf{Those who finish this book will not see computation the same way again. Once you learn to perceive the geometry beneath the code, the old mindset of “just running the code” collapses into a kind of flatness. It is like switching from a diagnostic log to a full-system trace: the flat, fragmented view of computation you once relied on is replaced by a living, three-dimensional landscape of structures, laws, and histories that were always there—just never visible at once. Once you learn to see in this geometry, the old mindset of “just running the code” collapses into something impossibly thin.}
 \end{quote}
 
 If you are a physicist, expect parts of this to feel like an API spec for the laws you already know. If you are a computer scientist, expect ``the machine'' to suddenly include galaxies. If you are an ML person, expect models to shrink back down to what they are: ways of steering flows through a much larger space.