:orphan:

.. include:: /_templates/include-file/page-prefix.rst

.. note:: **Prompt: Naming transition to System B underscores (v1) --- 2026m04d10.**
   Systematic rename of h*, h₀, h/ to h_star, h_zero, h_dark across
   all HEAVEN papers. Designed for execution in a fresh context window.


****************************************************************************************************
Prompt: Transition All HEAVEN Papers to System B Naming (h_star / h_zero / h_dark)
****************************************************************************************************

| **VVN:** ``dv_ClaOp46_v1_2026m04d10``
| **Origin:** b17 writing session. Naming convention decided 2026m04d10.


Context
========

The HEAVEN paper series (b11--b18) currently uses mixed notation for
three core agent-role concepts:

- ``h*`` (sometimes ``h\ :sup:`*```, sometimes bare ``h*`` in text)
- ``h₀`` / ``h_0`` / ``h\ :sub:`0``` / ``:math:`h_0```
- ``h/`` (new concept, not yet in papers)

**Decision (2026m04d10):** All papers transition to **System B
(underscore-unified tokens)**:

.. list-table::
   :header-rows: 1
   :widths: 20 20 60

   * - Old forms
     - New token
     - Meaning
   * - ``h*``, ``h\ :sup:`*```, "h-star"
     - ``h_star``
     - Greatest positive causal influence on humanity's future (ax19)
   * - ``h₀``, ``h_0``, ``h\ :sub:`0```, ``:math:`h_0```
     - ``h_zero``
     - Deliberate choice to become the least to serve all (th6 Case 3)
   * - (not yet used)
     - ``h_dark``
     - Greatest negative causal influence on humanity's future

**Rationale:** One grep finds everything. Self-documenting.
Filename/URL/code-safe. No edge cases. See
``AHA/matheology-naming-decisions.md`` for full analysis.


Step 1: Read These Files
===========================

1. ``.claude/CLAUDE.md`` --- full project rules
2. ``AHA/matheology-naming-decisions.md`` --- the naming decision and
   its rationale (MUST be read and followed exactly)


Step 2: Inventory
===================

Before making any changes, produce a complete inventory of all
occurrences of the old forms across the entire ``source/`` directory.

Search for ALL of the following patterns:

- ``h*`` (bare, in running text --- be careful not to match RST italic
  markers or wildcards)
- ``h\ :sup:`*```
- ``h₀`` (unicode subscript zero)
- ``h_0`` (underscore zero)
- ``h\ :sub:`0```
- ``:math:`h_0```
- ``:math:`h^*```
- ``:math:`h^{*}```
- ``h-star`` (in running text, NOT in filenames)
- ``h-zero`` (in running text)
- Any other forms you discover

For each file, record:

1. File path
2. Line number(s)
3. The exact old form found
4. The context (is it in running text, a math block, a table cell,
   a section heading, a meta description, a keyword list, a label
   anchor, or a citation?)

**Do NOT change anything in this step.** Inventory only.


Step 3: Context-Sensitive Replacement Rules
=============================================

Apply these rules:

1. **Running text:** Replace all old forms with the new token
   (``h_star``, ``h_zero``, ``h_dark``). If ``h_star`` triggers RST
   interpretation as a hyperlink reference (because of trailing
   underscore patterns), escape as ``h\_star`` or use inline literal
   ````h_star````. Test after replacement.

2. **Math blocks** (``:math:`` directives): Replace
   ``:math:`h^*``` with ``:math:`h_{star}``` and
   ``:math:`h_0``` with ``:math:`h_{zero}``. In LaTeX math mode,
   underscored multi-character subscripts need braces.

3. **Section headings:** Replace directly. Heading underlines may
   need length adjustment.

4. **Labels and cross-references** (``.. _mmv1-b17-sec7:`` etc.):
   Do NOT rename label anchors or filenames. The transition applies
   to **content**, not to structural identifiers. Filenames keep
   ``h-star`` as they are.

5. **Meta descriptions and keywords:** Replace old forms with new
   tokens.

6. **Tables and list-tables:** Replace in cell content.

7. **LLog files:** Do NOT modify content within LLog files. LLogs
   are append-only audit trails. Add a dated note at the end of each
   affected llog explaining the naming transition instead.

8. **Prompt files:** Do NOT modify prompt files. They are historical
   records of what was asked.

9. **Introduce h_dark:** In b17 Section 2 (or a new definitions
   subsection), add the h_dark definition. In the Supervillain Theorem
   discussion (b13), add a note connecting th2 to the h_star |rarr|
   h_dark transition. The key theorem to state:

   "Any h_star who refuses to become h_zero will become h_dark by
   failing to live up to the h_star calling (unless someone else picks
   up the failure and steps in)."

10. **Do NOT rename h_star to anything else in the OO-versioned files**
    (``source/matheology/hell/mm/b/14/OOv1/``, ``OOv2/``, ``OOv3/``).
    These are earlier-maturity files that may use different conventions.
    Flag them in the inventory but skip them unless LLoL explicitly
    approves changes.


Step 4: Execute Replacements
==============================

Work file by file, starting with the most recent versions (MMv3 before
MMv2 before MMv1). For each file:

1. Read the file
2. Make all replacements per Step 3 rules
3. Check that RST rendering is not broken (no unintended italics,
   no broken cross-references)
4. Record what was changed in the llog

**Build after every 3--5 files** (``make dev``) to catch errors early.


Step 5: Verification
======================

After all replacements:

1. Run ``make dev`` and confirm zero new errors
2. Grep for any remaining old forms: ``h*`` (in content, not
   filenames), ``h₀``, ``h\ :sub:`0```, ``:math:`h_0```
3. Grep for ``h_star``, ``h_zero``, ``h_dark`` to confirm all
   instances render correctly
4. Spot-check 5 files in the built HTML to confirm rendering


Step 6: Output
================

**LLog:** save at
``source/matheology/hell/ll/study/b/17/study_ll_2026m04dNN_naming-transition-llog.rst``

Include: verbatim prompt, complete inventory (Step 2), all changes
made (file, line, old form, new form), build verification results,
and any issues encountered.