Stage E (writing): appendix cross-references as 'Appendix X' (crefalias), typewriter double hyphens, patch wording (Appendix E)
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
1 changed file +5 −4
modified
paper/appendix/appendix.tex
+5 −4
@@ -2,6 +2,7 @@ | ||
| 2 | 2 | % where it is discussed; please do not add a second \input of the same float (duplicate labels). — 2026-11-05 |
| 3 | 3 | % ============================================================================ |
| 4 | 4 | \begin{appendices} |
| 5 | +\crefalias{section}{appendix} % cleveref: refer to appendix sections as ``Appendix E'', not ``Section E'' | |
| 5 | 6 | % ============================================================================ |
| 6 | 7 | |
| 7 | 8 | \section{Taxonomy}\label{app:taxonomy} |
@@ -76,7 +77,7 @@ Author order, affiliations and CRediT contributions & Pending confirmation by th | ||
| 76 | 77 | |
| 77 | 78 | \lstinputlisting{../results/runs/git_diff_df7905d_2324b58.patch} |
| 78 | 79 | |
| 79 | −\noindent The diff from the first commit (\texttt{0304133}) to \texttt{2324b58} on the same files is the following change to the corpus-layer \texttt{filing\_parser.py}: | |
| 80 | +\noindent The diff from the first commit (\texttt{0304133}) to \texttt{2324b58} on the same files adds the following change to the corpus-layer \texttt{filing\_parser.py} (the patch repeats the \texttt{store.py} lines above): | |
| 80 | 81 | |
| 81 | 82 | \lstinputlisting{../results/runs/git_diff_0304133_2324b58.patch} |
| 82 | 83 | |
@@ -114,10 +115,10 @@ The exhibits generated from the read-only audits of this revision (\texttt{code/ | ||
| 114 | 115 | \begin{enumerate} |
| 115 | 116 | \item Clone the repository at revision \texttt{2324b58} and create the Python environment from the lock files shipped with the paper (\texttt{.python-version} = \SPIDpythonVersion; \texttt{requirements.lock}, \SPIDrequirementsLockPackages\ packages from the master node, including DuckDB \SPIDduckdbVersion, pyarrow, lxml and sentence-transformers; \texttt{environment.md} records the hardware). The exhibit environment of the paper is pinned separately in \texttt{reproducibility/environment/}. |
| 116 | 117 | \item \texttt{python scripts/build\_universe.py} rebuilds \texttt{data/metadata/universe.json} from a \emph{current} download of the holdings and ticker files, which will not reproduce the October 2026 snapshot; the frozen artefacts used here are kept with the paper (\texttt{data/metadata/}, SHA-256 in \texttt{SHA256SUMS}) and must be used instead. |
| 117 | −\item \texttt{python scripts/download\_filings.py --universe --rate 9} downloads the corpus (idempotent; about \SPIDrawGb~GB; \SPIDacqHours\ hours at two IP addresses in October 2026). The cluster orchestration used for the October 2026 build is in \texttt{scripts/cluster/}. | |
| 118 | +\item \texttt{python scripts/download\_filings.py -{}-universe -{}-rate 9} downloads the corpus (idempotent; about \SPIDrawGb~GB; \SPIDacqHours\ hours at two IP addresses in October 2026). The cluster orchestration used for the October 2026 build is in \texttt{scripts/cluster/}. | |
| 118 | 119 | \item \texttt{python scripts/build\_database.py}, \texttt{parse\_filings.py}, \texttt{build\_embeddings.py}, \texttt{build\_factors.py} build the corpus layer; \texttt{export\_shard.py}/\texttt{merge\_shards.py} are needed only for a distributed build. The S\&P~500 10-K items of the June 2026 block cannot be rebuilt by this path (\Cref{sec:segmenters}). |
| 119 | −\item In \texttt{project-db/}: \texttt{python -m spid pending} reports the sections to be extracted and the estimated cost; \texttt{python run\_full\_extract.py --workers \SPIDworkers} runs the extraction against the ledger (a re-run is not expected to return identical mentions; \Cref{sec:contract}); \texttt{python -m spid resolve graph embed analytics} builds the project layer (representative fields depend on tie order; \Cref{sec:resolution_rule}). | |
| 120 | −\item In the working-paper folder: \texttt{./run\_all.sh} regenerates every table, figure and inline number from \texttt{data/} and \texttt{results/} and runs the \SPIDtestsN\ checks of \texttt{tests/}; \texttt{./run\_all.sh --with-node} first re-runs \texttt{code/export\_stats.py} read-only on the master node, and \texttt{--with-audit} re-runs the Stage D audits of \texttt{code/audit/} (read-only connections, temporary tables only, seed \SPIDannSeed). \texttt{latexmk} in \texttt{paper/} compiles the manuscript. | |
| 120 | +\item In \texttt{project-db/}: \texttt{python -m spid pending} reports the sections to be extracted and the estimated cost; \texttt{python run\_full\_extract.py -{}-workers \SPIDworkers} runs the extraction against the ledger (a re-run is not expected to return identical mentions; \Cref{sec:contract}); \texttt{python -m spid resolve graph embed analytics} builds the project layer (representative fields depend on tie order; \Cref{sec:resolution_rule}). | |
| 121 | +\item In the working-paper folder: \texttt{./run\_all.sh} regenerates every table, figure and inline number from \texttt{data/} and \texttt{results/} and runs the \SPIDtestsN\ checks of \texttt{tests/}; \texttt{./run\_all.sh -{}-with-node} first re-runs \texttt{code/export\_stats.py} read-only on the master node, and \texttt{-{}-with-audit} re-runs the Stage D audits of \texttt{code/audit/} (read-only connections, temporary tables only, seed \SPIDannSeed). \texttt{latexmk} in \texttt{paper/} compiles the manuscript. | |
| 121 | 122 | \end{enumerate} |
| 122 | 123 | |
| 123 | 124 | \end{appendices} |
| 124 | 125 | |