DD b15 — Floor-Layer Naming & Transform for Jubilee Floor Pours#

Status: tested on the b11-intro-pet-mmv5 pilot, 2026m05d29. Extends DD b12 (5D-link names) for the Floor Model of bug c103.
Worked example (the spec-by-example): source/study/matheo/b11-intro-pet-mmv5.rst.
Per-paper data: the floor-plan table source/study/matheo/matheo-floor-plan-table.html.

1. Scope#

How to pour the latest-of-each-type HELL paper onto the clean, citable /study/matheo/ floor. Copy, never move — HELL originals stay untouched (old links never break). Each pour is independent, so papers parallelise across fresh sessions; a single wrap-up assembles the cross-paper nav/table afterward.

2. Naming & citation#

  • FileID = b<NN>-<TYPE>-<keyword>-mmv5 (TYPE first: form / math / intro / theophil / syseng / socpsy / econ / polsci / why / esc …). The FileID is the RST :ref: anchor (a label at the top of the file). Internal section anchors are prefixed with the FileID.

  • Citation form: Matheo-<FileID> (e.g. Matheo-b11-intro-pet-mmv5).

  • Stability: uniform mmv5 for every floor copy (the first official Matheo release marker). This deliberately flattens real maturity — a documented StayVS-bend, chosen for a memorable single release; true maturity stays in the HELL source + the floor-plan table.

3. The cover sequence (the b19 model — NOT b18)#

Echo the high-quality b19 title-page structure. Order:

  1. .. only:: latex raw titlepage (PDF cover): header macros · title · byline · fn 1–3 · “4–N See Declarations” pointer · Broader Significance · \vfill · Declarations (fn 4–N) · License-as-last-fn · \end{titlepage}\newpage.

  2. #### title heading (the HTML <h1>; in PDF it is the body title).

  3. .. only:: html block: byline · titlepage-credentials (fn 1–3 + “4–N See Declarations” + the header-line, see §5) · <hr/> · Broader Significance · <hr/> · Declarations (fn 4–N) · <hr/>.

  4. Abstract — bold **Abstract** (NOT a heading, so it stays out of the ToC), placed before the ToC. .. raw:: latex \newpage after it so the ToC gets its own page.

  5. .. contents:: ToC, then .. raw:: latex \newpage before the body.

  6. Body sections.

Hard rule (clutter → SI): anything that is not in the Title → byline → fn 1–3 → Broader Significance → Abstract → ToC → Introduction sequence (e.g. a .. note:: Draft status… block, old Study aN-Intro / series ID lines) moves verbatim to the Supplementary-Info appendix (§9). Old ID/subtitle lines are deleted from the cover.

4. Byline (which form)#

Per AHA/study-title-page-footnotes-template.md:

  • STD (9 fn, 3 authors) — LLoL¹⁻⁵ + AI Claude Opus 4.6-4.7 Max⁶⁻⁷ + Everyone⁸ + License⁹: all matheology papers b11–b18.

  • B19 (conditional, LLoL alone, no AI on byline): b19 only.

  • B21 (framework form): b21 only.

fn 5 carries a per-paper hope sentence (≤ ~80 chars). Author an Abstract and Broader Significance where missing; FLAG every one you write for LLoL.

5. Headers (the FileID line)#

  • PDF \paperheadercenter = Matheo-<FileID> (e.g. \renewcommand{\paperheadercenter}{\scriptsize Matheo-b11-intro-pet-mmv5}).

  • HTML — a matching plain-text line as the last entry of the titlepage-credentials block (after the “4–N See Declarations” line, before the Broader-Significance <hr/>): | This is Balospe.com/study Matheo-<FileID> (<variant-date YYYYmMMdDD>). (no code-style backticks.)

6. Labels, citations, images, refs#

  • Labels: namespace every internal section/figure anchor with the FileID (b11-mmv3r1-foo → b11-intro-pet-mmv5-foo) so copies never collide with the HELL originals. Reference canonical axiom/theorem anchors (DD b12); do not redefine them.

  • Citations: neutralise broken docutils refs ([Matheo-N-m]_ / [Balospe-N-m]_) to plain Matheo-bNN text; deactivate :doc: links to inert path literals so they cannot warn. (Proper bib + intra-floor links are the post-pour task — see AA #5.)

  • External (non-Matheo) bibliography (rule added 2026m05d29 from the b13/b14 pour): a paper may cite outside works (e.g. (Schelling 1960), (Piketty 2014)) in prose or via docutils .. [KEY] defs. Handle by the in-bib test:

    • Key already in source/_bib/references.bib (e.g. Schelling1960 ): wire the citation to :cite:`Key` and add a References section with .. bibliography:: :filter: cited and True just before the footer (the proven b12-math / b14-math pattern). This renders with the FF footer — the footer does not interfere (the bibliography is emitted above it). Bibtex :cite: keys are shared across docs, so reusing a key another floor paper cites causes no duplicate-citation collision.

    • Key NOT yet in the bib — the common case (most floor papers’ hand-written reference lists: Piketty / Acemoglu / Ostrom / Buchanan / Plantinga / Spence …): leave the source’s plain-text list or prose as-is. Do not auto-convert to :cite: — a blanket sweep would emit missing-key warnings or drop references, and author/year→key matching is error-prone (e.g. several Plantinga entries). Adding those works to references.bib then wiring them is AA #5 (a careful, per-paper task, not a quick pour step).

    • Docutils .. [KEY] external defs (not :cite: roles): must be converted to plain text (or to :cite: if the key is in the bib), or they collide with the built HELL original’s identical defs (duplicate-citation warnings).

  • Images: stay in /_file/ (absolute paths); not moved.

  • References (if any): at the very end, \newpage before; add .. raw:: latex \newpage before each major section so ref-link landings sit on the right page.

7. Supplementary-Info appendix (down-payment)#

A Supplementary Info section at the end carrying: a HUMANE statement (human + AI POV, stub), author contributions (who did what), a Provenance hatch (cautioned HELL links), the moved cover clutter, and a deferred-naming note. Stubs now; full write-ups later.

8. Close like a feedback page#

  • FF FeedbackFlow footer (FOOTER FORM block, slug = FF+study-matheo-<FileID>@balospe.com).

  • og:card social-card :og:card:title: + :og:card:description: in the .. meta:: block.

9. Folder layout & nav (wrap-up step)#

  • Files live in source/study/matheo/bNN/<FileID>.rst (per-paper folders).

  • Each study/matheo/bNN/index.rst = a chooser page: per type, the short-label + title + abstract (the formal abstract first, then intro, then others — “AuditTheMath, not buildALearningPath”), with a toctree of its type-files (so files de-orphan; sidebar shows b11–b21, expandable).

  • study/matheo/index.rst = on-ramp (lead with b11-why-matheo, then b18a Phase 1) + the public table (cols #, FileID, Audience, Title, PDF) + a toctree of the bNN nodes + a small link to the floor-plan HTML for HELL-tracing.

  • Root nav: add Matheo Study Series </study/matheo/index> to source/index.rst under The Solution, right after Good News Pack.

10. The transform-script template (proven on b11)#

Set the per-paper variables, then run. Steps 1–2 are mechanical; steps 3–5 use the worked b11-intro-pet-mmv5.rst as the pattern (cover order, Abstract, SI, FF). Build with make pdf SECTION=<dst> and make dev; surface any authored Abstract/Broader-Significance to LLoL.

SRC=source/matheology/hell/mm/b/NN/<...source.rst>
DST=source/study/matheo/bNN/<FileID>.rst        # mkdir -p the bNN folder
FID=b<NN>-<type>-<keyword>-mmv5
cp "$SRC" "$DST"
# 1) namespace labels (replace the source's label stem with the FileID)
sed -i '' "s/<source-label-stem>/$FID/g" "$DST"
# 2) neutralise broken citations + (then, in Python) deactivate :doc: links,
#    add og:card, set \paperheadercenter=Matheo-$FID + the HTML header-line,
#    move clutter notes to SI, port the cover to the b19 order, TL;DR/lead ->
#    **Abstract**, add the FF footer.  (See b11-intro-pet-mmv5.rst verbatim.)

(For papers that already carry the new STD/B19/B21 title page — b11, b18a, b19, b21 — the cover port is light. For papers lacking one, stamp the form from the AHA template and author a Broader Significance + Abstract.)

11. Open follow-ups (AnyAims — mirror the floor-plan table)#

  1. AA #1 h*→h_star / h₀→h_zero / h/→h_dark content sweep (post-launch; plan: hell/ll/study/b/17/b17-prompt-naming-transition-v1).

  2. AA #2 Broader-Significance / Abstract where missing.

  3. AA #3 b18b adversarial review before any public exposure.

  4. AA #4 b18e war paper (post-launch).

  5. AA #5 add floor papers to references.bib + wire intra-floor citations (replaces the neutralised refs and the deactivated :doc: links). Also add each floor paper’s external works not yet in the bib (Piketty, Acemoglu, Ostrom, Buchanan/Tullock, Olson, Spence, Scheidel, the specific Plantinga/Hartshorne titles, …) and convert the current hand-written reference lists to :cite: + .. bibliography:: (per §6’s in-bib test). Per-paper and careful — not a blanket sweep (most works are not yet in the bib, so a sweep would drop refs or warn; b14-math’s single in-bib Schelling1960 was wired during the pour as the one safe case).