% docs/book/fabric.tex -- master file of The Book of Fabric (#138): the FABRIC
% design record as one book, published with every release (Captain Bob,
% 2026-11-07: "build a 'The Book of Fabric' and publish it as version
% <version> every release"; 2026-11-08: "Publish. Fabric is all about steady
% state.").
%
% Built by `make fabric` (docs/book/Makefile) with xelatex, from the same
% pandoc fragments as the book (fabric-0 ... fabric-4, from docs/fabric/).
\documentclass[11pt,openany]{book}

\input{preamble}

\title{The Book of Fabric\\[0.5em]\large The StarshipOS design record}
\author{Robert A. James (Captain Bob)}
\date{Version \texttt{\bookversion}\\Built \bookdate{} from commit \texttt{\bookcommit}}

\begin{document}
\frontmatter
\maketitle
\tableofcontents

\chapter{About this book}
FABRIC is the design record of StarshipOS, LithosAnanke and StarForth: every
ruling, the reasoning behind it, what was built, what was found, and what was
abandoned, written as the work happened. It is reproduced here as written --
struck-through corrections, superseded plans and all -- because the record of
what was believed, and when, is part of the record.

One document is living at a time; when its topic closes, it is closed and a
successor opens. Part~I is the living document. Part~II holds the closed
ones, in the order they were written; each states, at its head, when and why
it closed. Part~III holds the forward-looking notes.

Each chapter is the Markdown file named below, converted when this book is
built; the version and commit on the title page say exactly which.

\begin{longtable}{@{}lll@{}}
\toprule
Document & Topic & Status \\
\midrule
\endhead
FABRIC-3 & Bare metal boot & Living \\
FABRIC-0 & The Stadium & Closed 2026-08-12 \\
FABRIC-1 & The Stadium, continued & Closed 2026-08-25 \\
FABRIC-2 & The Stadium, continued again & Closed 2026-09-04 \\
FABRIC-3.5 & The Tripod/kernel reshuffle & Closed 2026-09-22 \\
FABRIC-3.6 & The reshuffle's execution log & Closed 2026-09-22 \\
FABRIC-3.7 & Phase 8 PKI: the elevation entrypoint & Closed 2026-10-14 \\
FABRIC-4 & Forward-looking design notes & Notes \\
\bottomrule
\end{longtable}

\mainmatter

\part{The living record}
\input{fabric-3}

\part{The closed records}
\input{fabric-0}
\input{fabric-1}
\input{fabric-2}
\input{fabric-3-5}
\input{fabric-3-6}
\input{fabric-3-7}

\part{Forward-looking notes}
\input{fabric-4}

\end{document}