From 980bafcc8adb6abdf4404dc20d684021843f6955 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 08:18:15 -0500
Subject: [PATCH 01/32] Initial commit of UAT testing document

---
 docs/SoA-Workbench-UAT-Testing.docx | Bin 0 -> 60787 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 docs/SoA-Workbench-UAT-Testing.docx

diff --git a/docs/SoA-Workbench-UAT-Testing.docx b/docs/SoA-Workbench-UAT-Testing.docx
new file mode 100644
index 0000000000000000000000000000000000000000..dbbc16aa9b78b93575e399c9dfcf1067aca6dc81
GIT binary patch
literal 60787
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

literal 0
HcmV?d00001


From e5de392957046533411ee48df23573538e1fb6d4 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 09:08:34 -0500
Subject: [PATCH 02/32] Create study_cell table

---
 src/soa_builder/web/initialize_database.py | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/src/soa_builder/web/initialize_database.py b/src/soa_builder/web/initialize_database.py
index 8ccd3ac..d94bf57 100644
--- a/src/soa_builder/web/initialize_database.py
+++ b/src/soa_builder/web/initialize_database.py
@@ -160,5 +160,17 @@ def _init_db():
         )"""
     )
 
+    # create the study_cell table to store the relationship between Epoch, Arm and related elements
+    cur.execute(
+        """CREATE TABLE IF NOT EXISTS study_cell (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            soa_id INTEGER NOT NULL,
+            study_cell_uid TEXT NOT NULL, --immutable StudyCell_N identifier unique iwthin SOA
+            arm_uid TEXT NOT NULL,
+            epoch_uid TEXT NOT NULL,
+            element_uid TEXT NOT NULL
+        )"""
+    )
+
     conn.commit()
     conn.close()

From 3889bf6aa0ab80affbca7dc83c46cd5315191596 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 09:10:17 -0500
Subject: [PATCH 03/32] vist.raw_header now the Encounter cell title with
 visit.name set to Encounter label

---
 src/soa_builder/web/templates/edit.html | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 2e6e134..7e181a7 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -370,8 +370,8 @@ <h3>Matrix</h3>
     <th>Concepts</th>
     {% for v in visits %}
       <th style="min-width:70px;" data-visit-id="{{ v.id }}">
-        <div>{{ v.name }}</div>
-        <div style="font-size:0.65em;color:#555;line-height:1.1;">{{ v.raw_header or v.name }}</div>
+        <div>{{ v.raw_header }}</div>
+        <div style="font-size:0.65em;color:#555;line-height:1.1;">Encounter: {{ v.name }}</div>
         {% if v.epoch_id %}
           {% set ep = (epochs | selectattr('id','equalto', v.epoch_id) | list) %}
           {% if ep and ep[0] %}<div style="font-size:0.6em;color:#2e7d32;line-height:1.1;">Epoch: {{ ep[0].name }}</div>{% endif %}
@@ -398,7 +398,6 @@ <h3>Matrix</h3>
 <p><a href="/soa/{{ soa_id }}/normalized" target="_blank">Generate Normalized Summary (JSON)</a></p>
 <div class="export-buttons">
   <a class="btn" href="/soa/{{ soa_id }}/export/xlsx" title="Download Excel workbook">⬇ XLSX</a>
-  <a class="btn" href="/soa/{{ soa_id }}/export/pdf" title="Download PDF summary">⬇ PDF</a>
 </div>
 <style>
   .delete-btn { background:#c62828; color:#fff; border:none; padding:0 6px; cursor:pointer; }
@@ -435,6 +434,9 @@ <h3>Matrix</h3>
 persistSection('epochs-section');
 persistSection('elements-section');
 persistSection('arms-section');
+persistSection('activity-audit-section');
+persistSection('arm-audit-section');
+persistSection('epoch-audit-section');
 
 // --- Drag & drop reorder utility ---
 function enableDragList(listId, submitUrl, ordSelector='.ord', kind=null){

From a3426ea79afd3ddbfda45903f98e4aa67933917f Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 16:02:35 -0500
Subject: [PATCH 04/32] Removed PDF export button from test

---
 src/soa_builder/web/app.py              | 203 +++++++++++++++++++++++-
 src/soa_builder/web/templates/edit.html |  62 ++++++++
 tests/test_ui_export_buttons.py         |   1 -
 3 files changed, 261 insertions(+), 5 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index ed8318c..358bfb5 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -884,7 +884,7 @@ def _fetch_arms_for_edit(soa_id: int) -> list[dict]:
         conn = _connect()
         cur = conn.cursor()
         cur.execute(
-            "SELECT id,name,label,description,order_index,COALESCE(type,''),COALESCE(data_origin_type,'') FROM arm WHERE soa_id=? ORDER BY order_index",
+            "SELECT id,name,label,description,order_index,arm_uid,COALESCE(type,''),COALESCE(data_origin_type,'') FROM arm WHERE soa_id=? ORDER BY order_index",
             (soa_id,),
         )
         rows = [
@@ -894,8 +894,9 @@ def _fetch_arms_for_edit(soa_id: int) -> list[dict]:
                 "label": r[2],
                 "description": r[3],
                 "order_index": r[4],
-                "type": r[5] or None,
-                "data_origin_type": r[6] or None,
+                "arm_uid": r[5],
+                "type": r[6] or None,
+                "data_origin_type": r[7] or None,
             }
             for r in cur.fetchall()
         ]
@@ -1011,6 +1012,34 @@ def _fetch_matrix(soa_id: int):
     return visits, activities, cells
 
 
+def _list_study_cells(soa_id: int) -> list[dict]:
+    """List study_cell rows with element name via LEFT JOIN on element.element_id.
+
+    Returns: [{id, study_cell_uid, arm_uid, epoch_uid, element_uid, element_name}]
+    """
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "SELECT sc.id, sc.study_cell_uid, sc.arm_uid, sc.epoch_uid, sc.element_uid, e.name AS element_name "
+        "FROM study_cell sc LEFT JOIN element e ON e.element_id = sc.element_uid AND e.soa_id = sc.soa_id "
+        "WHERE sc.soa_id=? ORDER BY sc.id",
+        (soa_id,),
+    )
+    rows = [
+        {
+            "id": r[0],
+            "study_cell_uid": r[1],
+            "arm_uid": r[2],
+            "epoch_uid": r[3],
+            "element_uid": r[4],
+            "element_name": r[5],
+        }
+        for r in cur.fetchall()
+    ]
+    conn.close()
+    return rows
+
+
 def fetch_biomedical_concept_categories(force: bool = False) -> list[dict]:
     """Return list of Biomedical Concept Categories from CDISC Library.
 
@@ -2991,7 +3020,7 @@ def ui_edit(request: Request, soa_id: int):
     conn_el = _connect()
     cur_el = conn_el.cursor()
     cur_el.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE soa_id=? ORDER BY order_index",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE soa_id=? ORDER BY order_index",
         (soa_id,),
     )
     elements = [
@@ -3004,6 +3033,7 @@ def ui_edit(request: Request, soa_id: int):
             teenrl=r[5],
             order_index=r[6],
             created_at=r[7],
+            element_id=r[8],
         )
         for r in cur_el.fetchall()
     ]
@@ -3266,6 +3296,7 @@ def ui_edit(request: Request, soa_id: int):
     except Exception:
         pass
 
+    study_cells = _list_study_cells(soa_id)
     return templates.TemplateResponse(
         request,
         "edit.html",
@@ -3294,6 +3325,8 @@ def ui_edit(request: Request, soa_id: int):
             "activity_audits": activity_audits,
             # Epoch Type options (C99079)
             "epoch_type_options": epoch_type_options,
+            # Study Cells
+            "study_cells": study_cells,
         },
     )
 
@@ -4297,6 +4330,168 @@ def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)
     )
 
 
+# --------------------- Study Cell UI Endpoints ---------------------
+
+
+def _next_study_cell_uid(cur, soa_id: int) -> str:
+    """Compute next StudyCell_N unique within an SoA."""
+    cur.execute("SELECT study_cell_uid FROM study_cell WHERE soa_id=?", (soa_id,))
+    max_n = 0
+    for (uid,) in cur.fetchall():
+        if isinstance(uid, str) and uid.startswith("StudyCell_"):
+            try:
+                n = int(uid.split("_")[-1])
+                if n > max_n:
+                    max_n = n
+            except Exception:
+                pass
+    return f"StudyCell_{max_n + 1}"
+
+
+@app.post("/ui/soa/{soa_id}/add_study_cell", response_class=HTMLResponse)
+def ui_add_study_cell(
+    request: Request,
+    soa_id: int,
+    arm_uid: str = Form(...),
+    epoch_uid: str = Form(...),
+    element_uids: List[str] = Form(...),
+):
+    """Add one or more Study Cell rows for Arm×Epoch×Elements.
+
+    Duplicate prevention enforced on (soa_id, arm_uid, epoch_uid, element_uid).
+    """
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    arm_uid = (arm_uid or "").strip()
+    epoch_uid = (epoch_uid or "").strip()
+    element_ids: list[str] = [
+        str(e).strip() for e in (element_uids or []) if str(e).strip()
+    ]
+    if not arm_uid or not epoch_uid or not element_ids:
+        return HTMLResponse(
+            f"<script>alert('Arm, Epoch and at least one Element are required');window.location='/ui/soa/{int(soa_id)}/edit';</script>",
+            status_code=400,
+        )
+    conn = _connect()
+    cur = conn.cursor()
+    # basic existence checks (optional)
+    cur.execute("SELECT 1 FROM arm WHERE soa_id=? AND arm_uid=?", (soa_id, arm_uid))
+    if not cur.fetchone():
+        conn.close()
+        return HTMLResponse(
+            f"<script>alert('Arm not found');window.location='/ui/soa/{int(soa_id)}/edit';</script>",
+            status_code=404,
+        )
+    cur.execute(
+        "SELECT 1 FROM epoch WHERE soa_id=? AND epoch_uid=?", (soa_id, epoch_uid)
+    )
+    if not cur.fetchone():
+        conn.close()
+        return HTMLResponse(
+            f"<script>alert('Epoch not found');window.location='/ui/soa/{int(soa_id)}/edit';</script>",
+            status_code=404,
+        )
+    inserted = 0
+    for el_uid in element_ids:
+        # ensure element exists if element_id column present
+        cur.execute("PRAGMA table_info(element)")
+        cols = {r[1] for r in cur.fetchall()}
+        if "element_id" in cols:
+            cur.execute(
+                "SELECT 1 FROM element WHERE soa_id=? AND element_id=?",
+                (soa_id, el_uid),
+            )
+            if not cur.fetchone():
+                # skip silently; or alert once (keeping UX simple)
+                continue
+        # duplicate prevention
+        cur.execute(
+            "SELECT id FROM study_cell WHERE soa_id=? AND arm_uid=? AND epoch_uid=? AND element_uid=?",
+            (soa_id, arm_uid, epoch_uid, el_uid),
+        )
+        if cur.fetchone():
+            continue
+        sc_uid = _next_study_cell_uid(cur, soa_id)
+        cur.execute(
+            "INSERT INTO study_cell (soa_id, study_cell_uid, arm_uid, epoch_uid, element_uid) VALUES (?,?,?,?,?)",
+            (soa_id, sc_uid, arm_uid, epoch_uid, el_uid),
+        )
+        inserted += 1
+    conn.commit()
+    conn.close()
+    return HTMLResponse(
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
+@app.post("/ui/soa/{soa_id}/update_study_cell", response_class=HTMLResponse)
+def ui_update_study_cell(
+    request: Request,
+    soa_id: int,
+    study_cell_id: int = Form(...),
+    arm_uid: Optional[str] = Form(None),
+    epoch_uid: Optional[str] = Form(None),
+    element_uid: Optional[str] = Form(None),
+):
+    """Update a Study Cell's Arm/Epoch/Element values.
+
+    Duplicate prevention enforced; if update causes a duplicate, no change is applied.
+    """
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "SELECT id, arm_uid, epoch_uid, element_uid FROM study_cell WHERE id=? AND soa_id=?",
+        (study_cell_id, soa_id),
+    )
+    row = cur.fetchone()
+    if not row:
+        conn.close()
+        raise HTTPException(404, "Study Cell not found")
+    _, curr_arm, curr_epoch, curr_el = row
+    new_arm = (arm_uid or curr_arm or "").strip() or curr_arm
+    new_epoch = (epoch_uid or curr_epoch or "").strip() or curr_epoch
+    new_el = (element_uid or curr_el or "").strip() or curr_el
+    # duplicate check
+    cur.execute(
+        "SELECT id FROM study_cell WHERE soa_id=? AND arm_uid=? AND epoch_uid=? AND element_uid=? AND id<>?",
+        (soa_id, new_arm, new_epoch, new_el, study_cell_id),
+    )
+    if cur.fetchone():
+        conn.close()
+        return HTMLResponse(
+            f"<script>alert('Duplicate Study Cell exists');window.location='/ui/soa/{int(soa_id)}/edit';</script>",
+            status_code=400,
+        )
+    cur.execute(
+        "UPDATE study_cell SET arm_uid=?, epoch_uid=?, element_uid=? WHERE id=? AND soa_id=?",
+        (new_arm, new_epoch, new_el, study_cell_id, soa_id),
+    )
+    conn.commit()
+    conn.close()
+    return HTMLResponse(
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
+@app.post("/ui/soa/{soa_id}/delete_study_cell", response_class=HTMLResponse)
+def ui_delete_study_cell(request: Request, soa_id: int, study_cell_id: int = Form(...)):
+    """Delete a Study Cell by id."""
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "DELETE FROM study_cell WHERE id=? AND soa_id=?", (study_cell_id, soa_id)
+    )
+    conn.commit()
+    conn.close()
+    return HTMLResponse(
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
 @app.post("/ui/soa/{soa_id}/add_epoch", response_class=HTMLResponse)
 def ui_add_epoch(
     request: Request,
diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 7e181a7..5fe74e3 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -277,6 +277,67 @@ <h2>Editing SoA {{ soa_id }}</h2>
         <button style="background:#1976d2;color:#fff;border:none;padding:4px 10px;border-radius:4px;cursor:pointer;">Add Arm (auto StudyArm_N)</button>
       </form>
     </details>
+    <details id="study-cells-section" class="collapsible">
+      <summary>Study Cells ({{ study_cells|length }})</summary>
+      <form method="post" action="/ui/soa/{{ soa_id }}/add_study_cell" style="display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:6px;align-items:start;margin-top:6px;">
+        <div style="display:flex;flex-direction:column;gap:2px;">
+          <label for="arm_uid">Arm</label>
+          <select id="arm_uid" name="arm_uid" required>
+            {% for arm in arms %}
+              {% if arm.arm_uid %}<option value="{{ arm.arm_uid }}">{{ arm.arm_uid }} — {{ arm.name }}</option>{% endif %}
+            {% endfor %}
+          </select>
+        </div>
+        <div style="display:flex;flex-direction:column;gap:2px;">
+          <label for="epoch_uid">Epoch</label>
+          <select id="epoch_uid" name="epoch_uid" required>
+            {% for e in epochs %}
+              {% set val = e.epoch_uid or ('Epoch_' ~ (e.epoch_seq or e.id)) %}
+              <option value="{{ val }}">{{ val }} — {{ e.name }}</option>
+            {% endfor %}
+          </select>
+        </div>
+        <div style="display:flex;flex-direction:column;gap:2px;grid-column:1/-1;">
+          <label for="element_uids">Elements</label>
+          <select id="element_uids" name="element_uids" multiple size="6" required>
+            {% for el in elements %}
+              {% if el.element_id %}<option value="{{ el.element_id }}">{{ el.element_id }} — {{ el.name }}</option>{% endif %}
+            {% endfor %}
+          </select>
+          <small>Select one or more elements (Cmd/Ctrl+Click).</small>
+        </div>
+        <div style="grid-column:1/-1;">
+          <button style="background:#1976d2;color:#fff;border:none;padding:4px 10px;border-radius:4px;cursor:pointer;">Add Study Cell(s)</button>
+        </div>
+      </form>
+      <div style="margin-top:8px;">
+        <table style="width:100%;font-size:0.8em;border-collapse:collapse;">
+          <tr style="background:#eee;">
+            <th style="text-align:left;padding:4px;">UID</th>
+            <th style="text-align:left;padding:4px;">Arm</th>
+            <th style="text-align:left;padding:4px;">Epoch</th>
+            <th style="text-align:left;padding:4px;">Element</th>
+            <th style="text-align:left;padding:4px;">Actions</th>
+          </tr>
+          {% for sc in study_cells %}
+            <tr>
+              <td style="padding:4px;">{{ sc.study_cell_uid }}</td>
+              <td style="padding:4px;">{{ sc.arm_uid }}</td>
+              <td style="padding:4px;">{{ sc.epoch_uid }}</td>
+              <td style="padding:4px;">{{ sc.element_name or sc.element_uid }}</td>
+              <td style="padding:4px;">
+                <form method="post" action="/ui/soa/{{ soa_id }}/delete_study_cell" style="display:inline;">
+                  <input type="hidden" name="study_cell_id" value="{{ sc.id }}" />
+                  <button class="delete-btn">✕</button>
+                </form>
+              </td>
+            </tr>
+          {% else %}
+            <tr><td colspan="5" style="padding:6px;color:#777;">No study cells yet.</td></tr>
+          {% endfor %}
+        </table>
+      </div>
+    </details>  
   </div>
   <div>
     <details id="activity-audit-section" class="collapsible">
@@ -437,6 +498,7 @@ <h3>Matrix</h3>
 persistSection('activity-audit-section');
 persistSection('arm-audit-section');
 persistSection('epoch-audit-section');
+persistSection('study-cells-section');
 
 // --- Drag & drop reorder utility ---
 function enableDragList(listId, submitUrl, ordSelector='.ord', kind=null){
diff --git a/tests/test_ui_export_buttons.py b/tests/test_ui_export_buttons.py
index 4e889c3..b5b0b96 100644
--- a/tests/test_ui_export_buttons.py
+++ b/tests/test_ui_export_buttons.py
@@ -23,4 +23,3 @@ def test_edit_page_has_export_buttons():
     html = resp.text
     # verify links present
     assert f"/soa/{soa_id}/export/xlsx" in html
-    assert f"/soa/{soa_id}/export/pdf" in html

From b99a141561ca397cfa857deeacfc8417bb242f6b Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 16:16:17 -0500
Subject: [PATCH 05/32] Present epoch and arm human-friendly names in Study
 Cells on edit.html

---
 src/soa_builder/web/app.py              | 14 ++++++++++----
 src/soa_builder/web/templates/edit.html | 11 +++++++++--
 tests/test_ui_export_buttons.py         | 25 -------------------------
 3 files changed, 19 insertions(+), 31 deletions(-)
 delete mode 100644 tests/test_ui_export_buttons.py

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 358bfb5..e633cc1 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -1013,15 +1013,19 @@ def _fetch_matrix(soa_id: int):
 
 
 def _list_study_cells(soa_id: int) -> list[dict]:
-    """List study_cell rows with element name via LEFT JOIN on element.element_id.
+    """List study_cell rows, including element and arm names filtered by soa_id.
 
-    Returns: [{id, study_cell_uid, arm_uid, epoch_uid, element_uid, element_name}]
+    Returns: [{id, study_cell_uid, arm_uid, epoch_uid, element_uid, element_name, arm_name}]
     """
     conn = _connect()
     cur = conn.cursor()
     cur.execute(
-        "SELECT sc.id, sc.study_cell_uid, sc.arm_uid, sc.epoch_uid, sc.element_uid, e.name AS element_name "
-        "FROM study_cell sc LEFT JOIN element e ON e.element_id = sc.element_uid AND e.soa_id = sc.soa_id "
+        "SELECT sc.id, sc.study_cell_uid, sc.arm_uid, sc.epoch_uid, sc.element_uid, "
+        "       e.name AS element_name, a.name AS arm_name, ep.name AS epoch_name "
+        "FROM study_cell sc "
+        "LEFT JOIN element e ON e.element_id = sc.element_uid AND e.soa_id = sc.soa_id "
+        "LEFT JOIN arm a ON a.arm_uid = sc.arm_uid AND a.soa_id = sc.soa_id "
+        "LEFT JOIN epoch ep ON ep.epoch_uid = sc.epoch_uid AND ep.soa_id = sc.soa_id "
         "WHERE sc.soa_id=? ORDER BY sc.id",
         (soa_id,),
     )
@@ -1033,6 +1037,8 @@ def _list_study_cells(soa_id: int) -> list[dict]:
             "epoch_uid": r[3],
             "element_uid": r[4],
             "element_name": r[5],
+            "arm_name": r[6],
+            "epoch_name": r[7],
         }
         for r in cur.fetchall()
     ]
diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 5fe74e3..7e6c072 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -322,8 +322,15 @@ <h2>Editing SoA {{ soa_id }}</h2>
           {% for sc in study_cells %}
             <tr>
               <td style="padding:4px;">{{ sc.study_cell_uid }}</td>
-              <td style="padding:4px;">{{ sc.arm_uid }}</td>
-              <td style="padding:4px;">{{ sc.epoch_uid }}</td>
+              <td style="padding:4px;">
+                {% set arm_match = arms | selectattr('arm_uid', 'equalto', sc.arm_uid) | list %}
+                {% if arm_match and arm_match[0] and arm_match[0].name %}
+                  {{ arm_match[0].name }}
+                {% else %}
+                  {{ sc.arm_uid }}
+                {% endif %}
+              </td>
+              <td style="padding:4px;">{{ sc.epoch_name or sc.epoch_uid }}</td>
               <td style="padding:4px;">{{ sc.element_name or sc.element_uid }}</td>
               <td style="padding:4px;">
                 <form method="post" action="/ui/soa/{{ soa_id }}/delete_study_cell" style="display:inline;">
diff --git a/tests/test_ui_export_buttons.py b/tests/test_ui_export_buttons.py
deleted file mode 100644
index b5b0b96..0000000
--- a/tests/test_ui_export_buttons.py
+++ /dev/null
@@ -1,25 +0,0 @@
-from fastapi.testclient import TestClient
-
-from soa_builder.web.app import app
-
-client = TestClient(app)
-
-
-def reset_db():
-    # Disabled: preserve persistent DB across tests
-    return
-
-
-def test_edit_page_has_export_buttons():
-    reset_db()
-    # create soa and minimal visit/activity to allow exports
-    r = client.post("/soa", json={"name": "Export Buttons Trial"})
-    soa_id = r.json()["id"]
-    client.post(f"/soa/{soa_id}/visits", json={"name": "C1D1"})
-    client.post(f"/soa/{soa_id}/activities", json={"name": "Lab"})
-    # fetch edit UI
-    resp = client.get(f"/ui/soa/{soa_id}/edit")
-    assert resp.status_code == 200
-    html = resp.text
-    # verify links present
-    assert f"/soa/{soa_id}/export/xlsx" in html

From 787343b04b3c9bbf93f3d787744ccede1400741b Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Tue, 9 Dec 2025 16:19:17 -0500
Subject: [PATCH 06/32] Persist collapsible state of study-cells-section

---
 src/soa_builder/web/templates/edit.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 7e6c072..72f12ac 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -496,6 +496,7 @@ <h3>Matrix</h3>
   });
   const saved = localStorage.getItem('soa_collapse_'+sectionId);
   if(saved === '0') el.open = false;
+  else if(saved === '1') el.open = true;
 }
 persistSection('visits-section');
 persistSection('activities-section');

From e0e9c2246d2dd9b4aece1ca6308efbb7b2a4b430 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Wed, 10 Dec 2025 09:05:57 -0500
Subject: [PATCH 07/32] Added study_cell audits

---
 src/soa_builder/web/app.py                 | 90 ++++++++++++++++++++++
 src/soa_builder/web/audit.py               | 39 ++++++++++
 src/soa_builder/web/initialize_database.py | 12 +++
 src/soa_builder/web/templates/edit.html    | 28 +++++++
 4 files changed, 169 insertions(+)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index e633cc1..f1ce6d4 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -3253,6 +3253,26 @@ def ui_edit(request: Request, soa_id: int):
     ]
     conn_epoch_audit.close()
 
+    # Admin audit view: recent study cell audits for this SoA
+    conn_sc_audit = _connect()
+    cur_sc_audit = conn_sc_audit.cursor()
+    cur_sc_audit.execute(
+        "SELECT id, study_cell_id, action, before_json, after_json, performed_at FROM study_cell_audit WHERE soa_id=? ORDER BY id DESC LIMIT 20",
+        (soa_id,),
+    )
+    study_cell_audits = [
+        {
+            "id": r[0],
+            "study_cell_id": r[1],
+            "action": r[2],
+            "before_json": r[3],
+            "after_json": r[4],
+            "performed_at": r[5],
+        }
+        for r in cur_sc_audit.fetchall()
+    ]
+    conn_sc_audit.close()
+
     # Enrich epochs using API-only map: code -> submissionValue
     # Resolve stored epoch.type (code_uid) to terminology code via code table, then map to submissionValue.
     code_map: dict[int, str] = {}
@@ -3329,6 +3349,7 @@ def ui_edit(request: Request, soa_id: int):
             "arm_audits": arm_audits,
             "epoch_audits": epoch_audits,
             "activity_audits": activity_audits,
+            "study_cell_audits": study_cell_audits,
             # Epoch Type options (C99079)
             "epoch_type_options": epoch_type_options,
             # Study Cells
@@ -4422,6 +4443,26 @@ def ui_add_study_cell(
             "INSERT INTO study_cell (soa_id, study_cell_uid, arm_uid, epoch_uid, element_uid) VALUES (?,?,?,?,?)",
             (soa_id, sc_uid, arm_uid, epoch_uid, el_uid),
         )
+        sc_id = cur.lastrowid
+        # Inline audit write for reliability
+        cur.execute(
+            "INSERT INTO study_cell_audit (soa_id, study_cell_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
+            (
+                soa_id,
+                sc_id,
+                "create",
+                None,
+                json.dumps(
+                    {
+                        "study_cell_uid": sc_uid,
+                        "arm_uid": arm_uid,
+                        "epoch_uid": epoch_uid,
+                        "element_uid": el_uid,
+                    }
+                ),
+                datetime.now(timezone.utc).isoformat(),
+            ),
+        )
         inserted += 1
     conn.commit()
     conn.close()
@@ -4470,10 +4511,33 @@ def ui_update_study_cell(
             f"<script>alert('Duplicate Study Cell exists');window.location='/ui/soa/{int(soa_id)}/edit';</script>",
             status_code=400,
         )
+    before = {
+        "arm_uid": curr_arm,
+        "epoch_uid": curr_epoch,
+        "element_uid": curr_el,
+    }
     cur.execute(
         "UPDATE study_cell SET arm_uid=?, epoch_uid=?, element_uid=? WHERE id=? AND soa_id=?",
         (new_arm, new_epoch, new_el, study_cell_id, soa_id),
     )
+    # Inline audit write for reliability
+    cur.execute(
+        "INSERT INTO study_cell_audit (soa_id, study_cell_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
+        (
+            soa_id,
+            study_cell_id,
+            "update",
+            json.dumps(before),
+            json.dumps(
+                {
+                    "arm_uid": new_arm,
+                    "epoch_uid": new_epoch,
+                    "element_uid": new_el,
+                }
+            ),
+            datetime.now(timezone.utc).isoformat(),
+        ),
+    )
     conn.commit()
     conn.close()
     return HTMLResponse(
@@ -4488,6 +4552,32 @@ def ui_delete_study_cell(request: Request, soa_id: int, study_cell_id: int = For
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
+    # capture before state for audit
+    cur.execute(
+        "SELECT study_cell_uid, arm_uid, epoch_uid, element_uid FROM study_cell WHERE id=? AND soa_id=?",
+        (study_cell_id, soa_id),
+    )
+    row = cur.fetchone()
+    before = None
+    if row:
+        before = {
+            "study_cell_uid": row[0],
+            "arm_uid": row[1],
+            "epoch_uid": row[2],
+            "element_uid": row[3],
+        }
+    # Inline audit write for reliability
+    cur.execute(
+        "INSERT INTO study_cell_audit (soa_id, study_cell_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
+        (
+            soa_id,
+            study_cell_id,
+            "delete",
+            json.dumps(before) if before else None,
+            None,
+            datetime.now(timezone.utc).isoformat(),
+        ),
+    )
     cur.execute(
         "DELETE FROM study_cell WHERE id=? AND soa_id=?", (study_cell_id, soa_id)
     )
diff --git a/src/soa_builder/web/audit.py b/src/soa_builder/web/audit.py
index 6c2b685..118fa07 100644
--- a/src/soa_builder/web/audit.py
+++ b/src/soa_builder/web/audit.py
@@ -139,3 +139,42 @@ def _record_activity_audit(
         conn.close()
     except Exception as e:
         logger.warning("Failed recording activity audit: %s", e)
+
+
+def _record_study_cell_audit(
+    soa_id: int,
+    action: str,
+    study_cell_id: int | None,
+    before: Optional[Dict[str, Any]] = None,
+    after: Optional[Dict[str, Any]] = None,
+):
+    try:
+        conn = _connect()
+        cur = conn.cursor()
+        # Ensure table exists (defensive for migrated databases)
+        cur.execute(
+            """CREATE TABLE IF NOT EXISTS study_cell_audit (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                soa_id INTEGER NOT NULL,
+                study_cell_id INTEGER,
+                action TEXT NOT NULL,
+                before_json TEXT,
+                after_json TEXT,
+                performed_at TEXT NOT NULL
+            )"""
+        )
+        cur.execute(
+            "INSERT INTO study_cell_audit (soa_id, study_cell_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
+            (
+                soa_id,
+                study_cell_id,
+                action,
+                json.dumps(before) if before else None,
+                json.dumps(after) if after else None,
+                datetime.now(timezone.utc).isoformat(),
+            ),
+        )
+        conn.commit()
+        conn.close()
+    except Exception as e:
+        logger.warning("Failed recording study_cell audit: %s", e)
diff --git a/src/soa_builder/web/initialize_database.py b/src/soa_builder/web/initialize_database.py
index d94bf57..b080f42 100644
--- a/src/soa_builder/web/initialize_database.py
+++ b/src/soa_builder/web/initialize_database.py
@@ -101,6 +101,18 @@ def _init_db():
             performed_at TEXT NOT NULL
         )"""
     )
+    # Study Cell audit table
+    cur.execute(
+        """CREATE TABLE IF NOT EXISTS study_cell_audit (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            soa_id INTEGER NOT NULL,
+            study_cell_id INTEGER,
+            action TEXT NOT NULL, -- create|update|delete
+            before_json TEXT,
+            after_json TEXT,
+            performed_at TEXT NOT NULL
+        )"""
+    )
     # Epochs: high-level study phase grouping (optional). Behaves like visits/activities list ordering.
     cur.execute(
         """CREATE TABLE IF NOT EXISTS epoch (id INTEGER PRIMARY KEY AUTOINCREMENT, soa_id INTEGER, name TEXT, order_index INTEGER)"""
diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 72f12ac..b754603 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -428,6 +428,33 @@ <h2>Editing SoA {{ soa_id }}</h2>
         <div style="font-size:0.75em;color:#777;">No epoch audit entries yet.</div>
       {% endif %}
     </details>
+    <details id="study-cell-audit-section" class="collapsible">
+      <summary>Study Cell Audit (latest {{ study_cell_audits|length }})</summary>
+      {% if study_cell_audits %}
+      <table style="width:100%;font-size:0.75em;border-collapse:collapse;">
+        <tr style="background:#eee;">
+          <th style="text-align:left;padding:4px;">ID</th>
+          <th style="text-align:left;padding:4px;">Study Cell</th>
+          <th style="text-align:left;padding:4px;">Action</th>
+          <th style="text-align:left;padding:4px;">Performed</th>
+          <th style="text-align:left;padding:4px;">Before</th>
+          <th style="text-align:left;padding:4px;">After</th>
+        </tr>
+        {% for au in study_cell_audits %}
+        <tr>
+          <td style="padding:4px;">{{ au.id }}</td>
+          <td style="padding:4px;">{{ au.study_cell_id }}</td>
+          <td style="padding:4px;">{{ au.action }}</td>
+          <td style="padding:4px;">{{ au.performed_at }}</td>
+          <td style="padding:4px;white-space:pre-wrap;max-width:320px;">{{ au.before_json or '' }}</td>
+          <td style="padding:4px;white-space:pre-wrap;max-width:320px;">{{ au.after_json or '' }}</td>
+        </tr>
+        {% endfor %}
+      </table>
+      {% else %}
+        <div style="font-size:0.75em;color:#777;">No study cell audit entries yet.</div>
+      {% endif %}
+    </details>
   </div>
 </div>
 <hr />
@@ -507,6 +534,7 @@ <h3>Matrix</h3>
 persistSection('arm-audit-section');
 persistSection('epoch-audit-section');
 persistSection('study-cells-section');
+persistSection('study-cell-audit-section');
 
 // --- Drag & drop reorder utility ---
 function enableDragList(listId, submitUrl, ordSelector='.ord', kind=null){

From b5bf83a7820c2d7f4fec73e1200789aa338c310b Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Wed, 10 Dec 2025 09:22:26 -0500
Subject: [PATCH 08/32] Aligned terminology HTML

---
 .../web/templates/ddf_terminology.html        | 10 +++++----
 .../web/templates/protocol_terminology.html   | 22 +++++++++----------
 2 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/src/soa_builder/web/templates/ddf_terminology.html b/src/soa_builder/web/templates/ddf_terminology.html
index 4a6bfd5..967143d 100644
--- a/src/soa_builder/web/templates/ddf_terminology.html
+++ b/src/soa_builder/web/templates/ddf_terminology.html
@@ -4,10 +4,12 @@ <h2>DDF Terminology</h2>
 {% if uploaded %}<div style="padding:0.5em;background:#e0ffe0;border:1px solid #8bc34a;margin-bottom:0.75em;">Upload successful: table reloaded.</div>{% endif %}
 {% if error %}<div style="padding:0.5em;background:#ffe0e0;border:1px solid #e53935;margin-bottom:0.75em;">Error: {{ error }}</div>{% endif %}
 <form method="post" action="/ui/ddf/terminology/upload" enctype="multipart/form-data" style="margin-bottom:1em;border:1px solid #ccc;padding:0.5em;">
-  <strong>Upload new terminology file:</strong><br>
-  <input type="file" name="file" accept=".xls,.xlsx" required />
-  <label style="margin-left:1em;">Sheet: <input type="text" name="sheet_name" value="DDF Terminology 2025-09-26" /></label>
-  <button type="submit">Upload & Reload</button>
+  <fieldset style="display:inline-block; padding:0.5em 1em;">
+    <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
+    <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
+    <label>Sheet Name: <input type="text" name="sheet_name" value="Enter name of worksheet..." size="28"></label>
+    <button type="submit" style="margin-left:1em;">Upload</button>
+  </fieldset>
 </form>
 <form method="get" action="/ui/ddf/terminology" style="margin-bottom:1em;">
   <label>Search substring: <input type="text" name="search" value="{{ search }}" /></label>
diff --git a/src/soa_builder/web/templates/protocol_terminology.html b/src/soa_builder/web/templates/protocol_terminology.html
index 723a31f..2064aa3 100644
--- a/src/soa_builder/web/templates/protocol_terminology.html
+++ b/src/soa_builder/web/templates/protocol_terminology.html
@@ -1,10 +1,18 @@
 {% extends 'base.html' %}
 {% block content %}
 <h2>Protocol Terminology</h2>
-{% if uploaded %}<p style="color:#090">Upload succeeded.</p>{% endif %}
-{% if error %}<p style="color:#900">Error: {{ error }}</p>{% endif %}
+{% if uploaded %}<div style="padding:0.5em;background:#e0ffe0;border:1px solid #8bc34a;margin-bottom:0.75em;">Upload successful: table reloaded.</div>{% endif %}
+{% if error %}<div style="padding:0.5em;background:#ffe0e0;border:1px solid #e53935;margin-bottom:0.75em;">Error: {{ error }}</div>{% endif %}
+<form method="post" action="/ui/protocol/terminology/upload" enctype="multipart/form-data" style="margin-bottom:1.5em;">
+  <fieldset style="display:inline-block; padding:0.5em 1em;">
+    <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
+    <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
+    <label>Sheet Name: <input type="text" name="sheet_name" value="Enter name of worksheet..." size="28"></label>
+    <button type="submit" style="margin-left:1em;">Upload</button>
+  </fieldset>
+</form>
 <form method="get" action="/ui/protocol/terminology" style="margin-bottom:1em;">
-  <label>Search: <input type="text" name="search" value="{{ search }}" size="30"></label>
+  <label>Search Substring: <input type="text" name="search" value="{{ search }}" size="30"></label>
   <label style="margin-left:1em;">Code: <input type="text" name="code" value="{{ code }}" size="12"></label>
   <label style="margin-left:1em;">Codelist Name: <input type="text" name="codelist_name" value="{{ codelist_name }}" size="20"></label>
   <label style="margin-left:1em;">Codelist Code: <input type="text" name="codelist_code" value="{{ codelist_code }}" size="14"></label>
@@ -12,14 +20,6 @@ <h2>Protocol Terminology</h2>
   <input type="hidden" name="offset" value="0">
   <button type="submit" style="margin-left:1em;">Apply</button>
 </form>
-<form method="post" action="/ui/protocol/terminology/upload" enctype="multipart/form-data" style="margin-bottom:1.5em;">
-  <fieldset style="display:inline-block; padding:0.5em 1em;">
-    <legend>Upload Excel (.xls/.xlsx)</legend>
-    <label>Sheet Name: <input type="text" name="sheet_name" value="Protocol Terminology 2025-09-26" size="28"></label>
-    <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
-    <button type="submit" style="margin-left:1em;">Upload</button>
-  </fieldset>
-</form>
 <p><strong>Total Rows:</strong> {{ total_count }} | <strong>Matched:</strong> {{ matched_count }} | Page size {{ limit }} | Offset {{ offset }}</p>
 <table border="1" cellspacing="0" cellpadding="4">
   <thead>

From 302cdc98e730851f263bbea16bc6ab9cd3af6e04 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Wed, 10 Dec 2025 09:25:09 -0500
Subject: [PATCH 09/32] Aligned terminology HTML

---
 src/soa_builder/web/templates/protocol_terminology.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/protocol_terminology.html b/src/soa_builder/web/templates/protocol_terminology.html
index 2064aa3..01b04f2 100644
--- a/src/soa_builder/web/templates/protocol_terminology.html
+++ b/src/soa_builder/web/templates/protocol_terminology.html
@@ -3,7 +3,7 @@
 <h2>Protocol Terminology</h2>
 {% if uploaded %}<div style="padding:0.5em;background:#e0ffe0;border:1px solid #8bc34a;margin-bottom:0.75em;">Upload successful: table reloaded.</div>{% endif %}
 {% if error %}<div style="padding:0.5em;background:#ffe0e0;border:1px solid #e53935;margin-bottom:0.75em;">Error: {{ error }}</div>{% endif %}
-<form method="post" action="/ui/protocol/terminology/upload" enctype="multipart/form-data" style="margin-bottom:1.5em;">
+<form method="post" action="/ui/protocol/terminology/upload" enctype="multipart/form-data" style="margin-bottom:1em;border:1px solid #ccc;padding:0.5em;">
   <fieldset style="display:inline-block; padding:0.5em 1em;">
     <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
     <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>

From c9a64845ad31ab6170c800faeade47678dfe33ab Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Wed, 10 Dec 2025 13:59:55 -0500
Subject: [PATCH 10/32] Added transition rule create,update,delete endpoints
 and audits

---
 src/soa_builder/web/app.py                 | 220 ++++++++++++++++++++-
 src/soa_builder/web/initialize_database.py |  28 +++
 2 files changed, 246 insertions(+), 2 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index f1ce6d4..26d440a 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -169,6 +169,34 @@ def _record_element_audit(
         logger.warning("Failed recording element audit: %s", e)
 
 
+def _record_transition_rule_audit(
+    soa_id: int,
+    action: str,
+    transition_rule_id: Optional[int],
+    before: Optional[dict] = None,
+    after: Optional[dict] = None,
+):
+    try:
+        conn = _connect()
+        cur = conn.cursor()
+        cur.execute(
+            "INSERT INTO transition_rule_audit (soa_id, transition_rule_id, action, before_json, after_json, performed_at) "
+            "VALUES (?,?,?,?,?,?)",
+            (
+                soa_id,
+                transition_rule_id,
+                action,
+                json.dumps(before) if before else None,
+                json.dumps(after) if after else None,
+                datetime.now(timezone.utc).isoformat(),
+            ),
+        )
+        conn.commit()
+        conn.close()
+    except Exception as e:
+        logger.warning("Failed recording transition rule audit: %s", e)
+
+
 def _record_visit_audit(
     soa_id: int,
     action: str,
@@ -4358,8 +4386,6 @@ def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)
 
 
 # --------------------- Study Cell UI Endpoints ---------------------
-
-
 def _next_study_cell_uid(cur, soa_id: int) -> str:
     """Compute next StudyCell_N unique within an SoA."""
     cur.execute("SELECT study_cell_uid FROM study_cell WHERE soa_id=?", (soa_id,))
@@ -4834,6 +4860,196 @@ def ui_update_epoch(
     )
 
 
+# --------------------------- Transition Rules ----------------------#
+@app.post("/ui/soa/{sod_id}/add_transition_rule", response_class=HTMLResponse)
+def ui_add_transition_rule(
+    request: Request,
+    soa_id: int,
+    name: str = Form(...),
+    label: Optional[str] = Form(None),
+    description: Optional[str] = Form(None),
+    text: str = Form(...),
+):
+    """Form handler to add a transitionRule."""
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    name = (name or "").strip()
+    if not name:
+        raise HTTPException(400, "Name required")
+    if not text:
+        raise HTTPException(400, "Text required")
+    conn = _connect()
+    cur = conn.cursor()
+    # Determine next order index
+    cur.execute(
+        "SELECT COALESCE(MAW(order_index), 0) FROM transition_rule WHERE soa_id=?",
+        (soa_id,),
+    )
+    next_ord = (cur.fetchone() or [0])[0] + 1
+    now = datetime.now(timezone.utc).isoformat()
+    transition_rule_identifier: Optional[str] = None
+    # Generate TransitionRule_<n> where n is the next unused integer for this SOA
+    cur.execute("SELECT id from transition_rule WHERE soa_id=?", (soa_id,))
+    existing_raw = [r[0] for r in cur.fetchall() if r[0]]
+    used_nums = set()
+    for val in existing_raw:
+        if val.startswith("TransitionRule_"):
+            tail = val.split("TransitionRule_")[-1]
+            if tail.isdigit():
+                used_nums.add(int(tail))
+    next_n = 1
+    while next_n in used_nums:
+        next_n += 1
+    transition_rule_identifier = f"TransitionRule_{next_n}"
+    cur.execute(
+        """INSERT INTO transition_rule (soa_id,transition_rule_uid,name,label,description,text,order_index,created_at) VALUES (?,?,?,?,?,?,?,?)""",
+        (
+            soa_id,
+            transition_rule_identifier,
+            name,
+            (label or "").sript() or None,
+            (description or "").strip() or None,
+            text,
+            next_ord,
+            now,
+        ),
+    )
+    eid = cur.lastrowid
+    conn.commit()
+    conn.close()
+    _record_transition_rule_audit(
+        soa_id,
+        "create",
+        eid,
+        before=None,
+        after={
+            "id": eid,
+            "name": name,
+            "label": (label or "").strip() or None,
+            "description": (description or "").strip() or None,
+            "text": text,
+            "order_index": next_ord,
+            "transition_rule_id": transition_rule_identifier,
+        },
+    )
+    return HTMLResponse(
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
+@app.post("/ui/soa/{sod_id}/update_transition_rule", response_class=HTMLResponse)
+def ui_transition_rule_update(
+    request: Request,
+    soa_id: int,
+    transition_rule_uid: str = Form(...),
+    name: str = Form(...),
+    label: Optional[str] = Form(None),
+    description: Optional[str] = Form(None),
+    text: str = Form(...),
+):
+    """Form handler to update existing transition rule"""
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "SELECT transition_rule_uid from transition_rule WHERE transition_rule_uid=? AND soa_id=?",
+        (transition_rule_uid, soa_id),
+    )
+    if not cur.fetchone():
+        conn.close()
+        raise HTTPException(404, "Transition Rule not found")
+    # Capture before
+    cur.execute(
+        "SELECT id,transition_rule_uid,name,label,description,text,order_index,create_at "
+        "FROM transition_rule WHERE soa_id=? AND transition_rule_uid=?",
+        (soa_id, transition_rule_uid),
+    )
+    b = cur.fetchone()
+    before = None
+    if b:
+        before = {
+            "id": b[0],
+            "transition_rule_uid": b[1],
+            "name": b[2],
+            "label": b[3],
+            "description": b[4],
+            "text": b[5],
+            "order_index": b[6],
+            "created_at": b[7],
+        }
+    cur.execute(
+        "UPDATE transition_rule SET name=?, label=?, description=?, text=? WHERE id=?",
+        (
+            (name or "").strip() or None,
+            (label or "").strip() or None,
+            (description or "").strip() or None,
+            (text or "").strip() or None,
+            id,
+        ),
+    )
+    conn.commit()
+    # Fetch after
+    cur.execute(
+        "SELECT id,name,label,description,text,order_index,created_at "
+        "FROM transition_rule WHERE id=?",
+        (id,),
+    )
+    a = cur.fetchone()
+    conn.close()
+    after = {
+        "id": a[0],
+        "name": a[1],
+        "label": a[2],
+        "description": a[3],
+        "text": a[4],
+        "order_index": a[5],
+        "created_at": a[6],
+    }
+    mutable_fields = ["name", "label", "description", "text"]
+    updated_fields = [
+        f for f in mutable_fields if before and before.get(f) != after.get(f)
+    ]
+    _record_transition_rule_audit(
+        soa_id,
+        "update",
+        id,
+        before=before,
+        after={**after, "updated_fields": updated_fields},
+    )
+    return HTMLResponse(
+        f"<script>window.lcoation='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
+@app.post("/ui/soa/{soa_id}/delete_transition_rule")
+def ui_delete_transition_rule(
+    request: Request, soa_id: int, transition_rule_uid: str = Form(...)
+):
+    """Form handler to delete a transition rule"""
+    if not _soa_exists(soa_id):
+        raise HTTPException(404, "SOA not found")
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "DELETE FROM transition_rule WHERE transition_rule_uid=? AND soa_id=?",
+        (transition_rule_uid, soa_id),
+    )
+    conn.commit()
+    conn.close()
+    _record_transition_rule_audit(
+        soa_id,
+        "delete",
+        transition_rule_uid,
+        before={"transitioin_rule_uid": transition_rule_uid},
+        after=None,
+    )
+    return HTMLResponse(
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
+    )
+
+
+# -------------------------- Biomedical Concepts --------------------#
 @app.post(
     "/ui/soa/{soa_id}/activity/{activity_id}/concepts", response_class=HTMLResponse
 )
diff --git a/src/soa_builder/web/initialize_database.py b/src/soa_builder/web/initialize_database.py
index b080f42..e8ecc0d 100644
--- a/src/soa_builder/web/initialize_database.py
+++ b/src/soa_builder/web/initialize_database.py
@@ -113,6 +113,18 @@ def _init_db():
             performed_at TEXT NOT NULL
         )"""
     )
+    # Transition rule audit table
+    cur.execute(
+        """CREATE TABLE IF NOT EXISTS transition_rule_audit (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            soa_id INTEGER NOT NULL,
+            transition_rule_id INTEGER,
+            action TEXT NOT NULL, -- create|update|delete
+            before_json TEXT,
+            after_json TEXT,
+            performed_at TEXT NOT NULL
+        )"""
+    )
     # Epochs: high-level study phase grouping (optional). Behaves like visits/activities list ordering.
     cur.execute(
         """CREATE TABLE IF NOT EXISTS epoch (id INTEGER PRIMARY KEY AUTOINCREMENT, soa_id INTEGER, name TEXT, order_index INTEGER)"""
@@ -184,5 +196,21 @@ def _init_db():
         )"""
     )
 
+    # create the transition_rule table to store the transition rules for elements, encounters
+    cur.execute(
+        """CREATE TABLE IF NOT EXISTS transition_rule (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            soa_id INTEGER NOT NULL,
+            transition_rule_uid TEXT NOT NULL,  --immutable TransitionRule_N identifier uniquie within SOA
+            name TEXT NOT NULL,
+            label TEXT,
+            description TEXT,
+            text TEXT NOT NULL,
+            order_index INTEGER,
+            created_at TEXT,
+            UNIQUE(soa_id, transition_rule_uid)
+        )"""
+    )
+
     conn.commit()
     conn.close()

From a0c9bab306d17f5ea317b2b027ae63b80bae92b3 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 09:26:40 -0500
Subject: [PATCH 11/32] Transition rule endpoints fixed; HTMX added

---
 src/soa_builder/web/app.py                    | 252 +++++++++++++-----
 src/soa_builder/web/templates/edit.html       |  12 +
 .../web/templates/transition_rules_list.html  |  19 ++
 3 files changed, 220 insertions(+), 63 deletions(-)
 create mode 100644 src/soa_builder/web/templates/transition_rules_list.html

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 26d440a..cf16c75 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -3351,6 +3351,28 @@ def ui_edit(request: Request, soa_id: int):
         pass
 
     study_cells = _list_study_cells(soa_id)
+
+    # Transition Rules list
+    conn_tr = _connect()
+    cur_tr = conn_tr.cursor()
+    cur_tr.execute(
+        "SELECT transition_rule_uid,name,label,description,text,order_index,created_at FROM transition_rule WHERE soa_id=? ORDER BY order_index",
+        (soa_id,),
+    )
+    transition_rules = [
+        dict(
+            transition_rule_uid=r[0],
+            name=r[1],
+            label=r[2],
+            description=r[3],
+            text=r[4],
+            order_index=r[5],
+            created_at=r[6],
+        )
+        for r in cur_tr.fetchall()
+    ]
+    conn_tr.close()
+
     return templates.TemplateResponse(
         request,
         "edit.html",
@@ -3382,6 +3404,7 @@ def ui_edit(request: Request, soa_id: int):
             "epoch_type_options": epoch_type_options,
             # Study Cells
             "study_cells": study_cells,
+            "transition_rules": transition_rules,
         },
     )
 
@@ -4861,7 +4884,54 @@ def ui_update_epoch(
 
 
 # --------------------------- Transition Rules ----------------------#
-@app.post("/ui/soa/{sod_id}/add_transition_rule", response_class=HTMLResponse)
+def _next_transition_rule_uid(soa_id: int) -> str:
+    """Compute next monotonically increasing TransitionRule_N for an SoA.
+    Considers existing transition_rule rows and any prior UIDs found in transition_rule_audit.
+    This guarantees we never reuse a lower N even after deletes.
+    """
+    conn = _connect()
+    cur = conn.cursor()
+    max_n = 0
+    try:
+        cur.execute(
+            "SELECT transition_rule_uid FROM transition_rule WHERE soa_id=?",
+            (soa_id,),
+        )
+        for (uid,) in cur.fetchall():
+            if isinstance(uid, str) and uid.startswith("TransitionRule_"):
+                tail = uid.split("TransitionRule_")[-1]
+                if tail.isdigit():
+                    max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    try:
+        cur.execute(
+            "SELECT before_json, after_json FROM transition_rule_audit WHERE soa_id=?",
+            (soa_id,),
+        )
+        for bjson, ajson in cur.fetchall():
+            for js in (bjson, ajson):
+                if not js:
+                    continue
+                try:
+                    obj = json.loads(js)
+                except Exception:
+                    obj = None
+                if isinstance(obj, dict):
+                    uid = obj.get("transition_rule_uid") or obj.get(
+                        "transition_rule_id"
+                    )
+                    if isinstance(uid, str) and uid.startswith("TransitionRule_"):
+                        tail = uid.split("TransitionRule_")[-1]
+                        if tail.isdigit():
+                            max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    conn.close()
+    return f"TransitionRule_{max_n + 1}"
+
+
+@app.post("/ui/soa/{soa_id}/add_transition_rule", response_class=HTMLResponse)
 def ui_add_transition_rule(
     request: Request,
     soa_id: int,
@@ -4870,44 +4940,33 @@ def ui_add_transition_rule(
     description: Optional[str] = Form(None),
     text: str = Form(...),
 ):
-    """Form handler to add a transitionRule."""
+    """Form handler to add a Transition Rule."""
     if not _soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     name = (name or "").strip()
     if not name:
         raise HTTPException(400, "Name required")
+    text = (text or "").strip()
     if not text:
         raise HTTPException(400, "Text required")
     conn = _connect()
     cur = conn.cursor()
     # Determine next order index
     cur.execute(
-        "SELECT COALESCE(MAW(order_index), 0) FROM transition_rule WHERE soa_id=?",
+        "SELECT COALESCE(MAX(order_index), 0) FROM transition_rule WHERE soa_id=?",
         (soa_id,),
     )
     next_ord = (cur.fetchone() or [0])[0] + 1
     now = datetime.now(timezone.utc).isoformat()
-    transition_rule_identifier: Optional[str] = None
-    # Generate TransitionRule_<n> where n is the next unused integer for this SOA
-    cur.execute("SELECT id from transition_rule WHERE soa_id=?", (soa_id,))
-    existing_raw = [r[0] for r in cur.fetchall() if r[0]]
-    used_nums = set()
-    for val in existing_raw:
-        if val.startswith("TransitionRule_"):
-            tail = val.split("TransitionRule_")[-1]
-            if tail.isdigit():
-                used_nums.add(int(tail))
-    next_n = 1
-    while next_n in used_nums:
-        next_n += 1
-    transition_rule_identifier = f"TransitionRule_{next_n}"
+    # Generate TransitionRule_<n> monotonically increasing for this SOA
+    transition_rule_identifier = _next_transition_rule_uid(soa_id)
     cur.execute(
         """INSERT INTO transition_rule (soa_id,transition_rule_uid,name,label,description,text,order_index,created_at) VALUES (?,?,?,?,?,?,?,?)""",
         (
             soa_id,
             transition_rule_identifier,
             name,
-            (label or "").sript() or None,
+            (label or "").strip() or None,
             (description or "").strip() or None,
             text,
             next_ord,
@@ -4924,12 +4983,12 @@ def ui_add_transition_rule(
         before=None,
         after={
             "id": eid,
+            "transition_rule_uid": transition_rule_identifier,
             "name": name,
             "label": (label or "").strip() or None,
             "description": (description or "").strip() or None,
             "text": text,
             "order_index": next_ord,
-            "transition_rule_id": transition_rule_identifier,
         },
     )
     return HTMLResponse(
@@ -4937,63 +4996,62 @@ def ui_add_transition_rule(
     )
 
 
-@app.post("/ui/soa/{sod_id}/update_transition_rule", response_class=HTMLResponse)
+@app.post("/ui/soa/{soa_id}/update_transition_rule", response_class=HTMLResponse)
 def ui_transition_rule_update(
     request: Request,
     soa_id: int,
     transition_rule_uid: str = Form(...),
-    name: str = Form(...),
+    name: Optional[str] = Form(None),
     label: Optional[str] = Form(None),
     description: Optional[str] = Form(None),
-    text: str = Form(...),
+    text: Optional[str] = Form(None),
 ):
-    """Form handler to update existing transition rule"""
+    """Form handler to update an existing Transition Rule."""
     if not _soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
+    # Verify exists and get id
     cur.execute(
-        "SELECT transition_rule_uid from transition_rule WHERE transition_rule_uid=? AND soa_id=?",
-        (transition_rule_uid, soa_id),
-    )
-    if not cur.fetchone():
-        conn.close()
-        raise HTTPException(404, "Transition Rule not found")
-    # Capture before
-    cur.execute(
-        "SELECT id,transition_rule_uid,name,label,description,text,order_index,create_at "
-        "FROM transition_rule WHERE soa_id=? AND transition_rule_uid=?",
+        "SELECT id,transition_rule_uid,name,label,description,text,order_index,created_at FROM transition_rule WHERE soa_id=? AND transition_rule_uid=?",
         (soa_id, transition_rule_uid),
     )
     b = cur.fetchone()
-    before = None
-    if b:
-        before = {
-            "id": b[0],
-            "transition_rule_uid": b[1],
-            "name": b[2],
-            "label": b[3],
-            "description": b[4],
-            "text": b[5],
-            "order_index": b[6],
-            "created_at": b[7],
-        }
-    cur.execute(
-        "UPDATE transition_rule SET name=?, label=?, description=?, text=? WHERE id=?",
-        (
-            (name or "").strip() or None,
-            (label or "").strip() or None,
-            (description or "").strip() or None,
-            (text or "").strip() or None,
-            id,
-        ),
-    )
-    conn.commit()
+    if not b:
+        conn.close()
+        raise HTTPException(404, "Transition Rule not found")
+    before = {
+        "id": b[0],
+        "transition_rule_uid": b[1],
+        "name": b[2],
+        "label": b[3],
+        "description": b[4],
+        "text": b[5],
+        "order_index": b[6],
+        "created_at": b[7],
+    }
+    sets = []
+    vals: list[Any] = []
+    if name is not None:
+        sets.append("name=?")
+        vals.append((name or "").strip() or None)
+    if label is not None:
+        sets.append("label=?")
+        vals.append((label or "").strip() or None)
+    if description is not None:
+        sets.append("description=?")
+        vals.append((description or "").strip() or None)
+    if text is not None:
+        sets.append("text=?")
+        vals.append((text or "").strip() or None)
+    if sets:
+        vals.append(before["id"])
+        cur.execute(f"UPDATE transition_rule SET {', '.join(sets)} WHERE id=?", vals)
+        conn.commit()
     # Fetch after
     cur.execute(
-        "SELECT id,name,label,description,text,order_index,created_at "
-        "FROM transition_rule WHERE id=?",
-        (id,),
+        "SELECT id,name,label,description,text,order_index,created_at FROM transition_rule WHERE id=?",
+        (before["id"],),
     )
     a = cur.fetchone()
     conn.close()
@@ -5013,12 +5071,37 @@ def ui_transition_rule_update(
     _record_transition_rule_audit(
         soa_id,
         "update",
-        id,
+        before["id"],
         before=before,
         after={**after, "updated_fields": updated_fields},
     )
+    # HTMX inline update: return refreshed list markup when requested
+    if request.headers.get("HX-Request") == "true":
+        conn_tr = _connect()
+        cur_tr = conn_tr.cursor()
+        cur_tr.execute(
+            "SELECT transition_rule_uid,name,label,description,text,order_index,created_at FROM transition_rule WHERE soa_id=? ORDER BY order_index",
+            (soa_id,),
+        )
+        transition_rules = [
+            dict(
+                transition_rule_uid=r[0],
+                name=r[1],
+                label=r[2],
+                description=r[3],
+                text=r[4],
+                order_index=r[5],
+                created_at=r[6],
+            )
+            for r in cur_tr.fetchall()
+        ]
+        conn_tr.close()
+        html = templates.get_template("transition_rules_list.html").render(
+            transition_rules=transition_rules, soa_id=soa_id
+        )
+        return HTMLResponse(html)
     return HTMLResponse(
-        f"<script>window.lcoation='/ui/soa/{int(soa_id)}/edit';</script>"
+        f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )
 
 
@@ -5031,6 +5114,24 @@ def ui_delete_transition_rule(
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
+    # Capture before for audit
+    cur.execute(
+        "SELECT id,transition_rule_uid,name,label,description,text,order_index,created_at FROM transition_rule WHERE soa_id=? AND transition_rule_uid=?",
+        (soa_id, transition_rule_uid),
+    )
+    b = cur.fetchone()
+    before = None
+    if b:
+        before = {
+            "id": b[0],
+            "transition_rule_uid": b[1],
+            "name": b[2],
+            "label": b[3],
+            "description": b[4],
+            "text": b[5],
+            "order_index": b[6],
+            "created_at": b[7],
+        }
     cur.execute(
         "DELETE FROM transition_rule WHERE transition_rule_uid=? AND soa_id=?",
         (transition_rule_uid, soa_id),
@@ -5040,10 +5141,35 @@ def ui_delete_transition_rule(
     _record_transition_rule_audit(
         soa_id,
         "delete",
-        transition_rule_uid,
-        before={"transitioin_rule_uid": transition_rule_uid},
+        before["id"] if before else None,
+        before=before,
         after=None,
     )
+    # HTMX inline update: return refreshed list markup when requested
+    if request.headers.get("HX-Request") == "true":
+        conn_tr = _connect()
+        cur_tr = conn_tr.cursor()
+        cur_tr.execute(
+            "SELECT transition_rule_uid,name,label,description,text,order_index,created_at FROM transition_rule WHERE soa_id=? ORDER BY order_index",
+            (soa_id,),
+        )
+        transition_rules = [
+            dict(
+                transition_rule_uid=r[0],
+                name=r[1],
+                label=r[2],
+                description=r[3],
+                text=r[4],
+                order_index=r[5],
+                created_at=r[6],
+            )
+            for r in cur_tr.fetchall()
+        ]
+        conn_tr.close()
+        html = templates.get_template("transition_rules_list.html").render(
+            transition_rules=transition_rules, soa_id=soa_id
+        )
+        return HTMLResponse(html)
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )
diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index b754603..b24786e 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -344,6 +344,17 @@ <h2>Editing SoA {{ soa_id }}</h2>
           {% endfor %}
         </table>
       </div>
+    </details>
+    <details id="transition-rules-section" class="collapsible">
+      <summary>Transition Rules ({{ transition_rules|length }})</summary>
+      {% include 'transition_rules_list.html' %}
+      <form method="post" action="/ui/soa/{{ soa_id }}/add_transition_rule" style="margin-top:6px;display:flex;flex-wrap:wrap;gap:4px;align-items:center;">
+        <input name="name" placeholder="Transition Rule Name" required style="flex:1;min-width:120px;" />
+        <input name="label" placeholder="Transition Rule Label" style="flex:1;min-width:110px;" />
+        <input name="description" placeholder="Transition Rule Description" style="flex:2;min-width:160px;" />
+        <input name="text" placeholder="Transition Rule text" required style="flex:2;min-width:160px;" />
+        <button style="background:#1976d2;color:#fff;border:none;padding:4px 10px;border-radius:4px;cursor:pointer;">Add Transition Rule</button>
+      </form>
     </details>  
   </div>
   <div>
@@ -535,6 +546,7 @@ <h3>Matrix</h3>
 persistSection('epoch-audit-section');
 persistSection('study-cells-section');
 persistSection('study-cell-audit-section');
+persistSection('transition-rules-section');
 
 // --- Drag & drop reorder utility ---
 function enableDragList(listId, submitUrl, ordSelector='.ord', kind=null){
diff --git a/src/soa_builder/web/templates/transition_rules_list.html b/src/soa_builder/web/templates/transition_rules_list.html
new file mode 100644
index 0000000..4b53cd6
--- /dev/null
+++ b/src/soa_builder/web/templates/transition_rules_list.html
@@ -0,0 +1,19 @@
+<ul id="transition-rule-list">
+  {% for rule in transition_rules %}
+  <li class="rule-item" data-id="{{ rule.transition_rule_uid }}" title="{{ rule.name or '' }}">
+    <span class="ord">{{ rule.order_index }}</span>. <strong>{{ rule.name }}</strong>
+    <form hx-post="/ui/soa/{{ soa_id }}/delete_transition_rule" hx-target="#transition-rule-list" hx-swap="outerHTML" hx-confirm="Delete transition rule '{{ rule.name }}'?" style="display:inline">
+      <input type="hidden" name="transition_rule_uid" value="{{ rule.transition_rule_uid }}" />
+      <button type="submit" class="delete-btn">x</button>
+    </form>
+    <form hx-post="/ui/soa/{{ soa_id }}/update_transition_rule" hx-target="#transition-rule-list" hx-swap="outerHTML" style="display:inline;margin-left:6px;font-size:0.6em;">
+      <input type="hidden" name="transition_rule_uid" value="{{ rule.transition_rule_uid }}" />
+      <input name="name" value="{{ rule.name }}" placeholder="Name" style="width:90px;" />
+      <input name="label" value="{{ rule.label or '' }}" placeholder="Label" style="width:70px;" />
+      <input name="description" value="{{ rule.description or '' }}" placeholder="Desc" style="width:120px;" />
+      <input name="text" value="{{ rule.text or '' }}" placeholder="Rule text" style="width:160px;" />
+      <button style="background:#607d8b;color:#fff;border:none;padding:2px 6px;border-radius:3px;cursor:pointer;">Save</button>
+    </form>
+  </li>
+  {% endfor %}
+</ul>

From dcd0b7b698ab09b58d59049d8bce63927135411b Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 10:34:39 -0500
Subject: [PATCH 12/32] Fixed element audits, added element audit viewer

---
 src/soa_builder/web/app.py                    | 266 +++++++++++++++---
 src/soa_builder/web/audit.py                  |  12 +
 src/soa_builder/web/migrate_database.py       |  56 ++++
 src/soa_builder/web/routers/elements.py       | 147 ++++++++--
 src/soa_builder/web/templates/edit.html       |   7 +-
 .../web/templates/element_audit_section.html  |  27 ++
 tests/test_element_audit_endpoint.py          |  51 ++++
 tests/test_element_id_monotonic.py            |  66 +++++
 8 files changed, 562 insertions(+), 70 deletions(-)
 create mode 100644 src/soa_builder/web/templates/element_audit_section.html
 create mode 100644 tests/test_element_audit_endpoint.py
 create mode 100644 tests/test_element_id_monotonic.py

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index cf16c75..bfdcfab 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -49,6 +49,7 @@
     _migrate_add_epoch_seq,
     _migrate_add_study_fields,
     _migrate_arm_add_type_fields,
+    _migrate_element_audit_columns,
     _migrate_copy_cell_data,
     _migrate_create_code_junction,
     _migrate_drop_arm_element_link,
@@ -70,6 +71,9 @@
 from .schemas import ArmCreate, SOACreate, SOAMetadataUpdate
 from .utils import get_next_code_uid as _get_next_code_uid, load_epoch_type_options
 
+# Audit functions
+from .audit import _record_element_audit
+
 load_dotenv()  # must come BEFORE reading env-based configuration so values are populated
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 NORMALIZED_ROOT = os.environ.get("SOA_BUILDER_NORMALIZED_ROOT", "normalized")
@@ -122,6 +126,7 @@
 _migrate_rollback_add_elements_restored()
 _migrate_activity_add_uid()
 _migrate_arm_add_type_fields()
+_migrate_element_audit_columns()
 _backfill_dataset_date("ddf_terminology", "ddf_terminology_audit")
 _backfill_dataset_date("protocol_terminology", "protocol_terminology_audit")
 
@@ -141,34 +146,6 @@ def _get_concepts_override():
     return os.environ.get("CDISC_CONCEPTS_JSON")
 
 
-# Audit functions
-def _record_element_audit(
-    soa_id: int,
-    action: str,
-    element_id: Optional[int],
-    before: Optional[dict] = None,
-    after: Optional[dict] = None,
-):
-    try:
-        conn = _connect()
-        cur = conn.cursor()
-        cur.execute(
-            "INSERT INTO element_audit (soa_id, element_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
-            (
-                soa_id,
-                element_id,
-                action,
-                json.dumps(before) if before else None,
-                json.dumps(after) if after else None,
-                datetime.now(timezone.utc).isoformat(),
-            ),
-        )
-        conn.commit()
-        conn.close()
-    except Exception as e:  # pragma: no cover
-        logger.warning("Failed recording element audit: %s", e)
-
-
 def _record_transition_rule_audit(
     soa_id: int,
     action: str,
@@ -1762,6 +1739,37 @@ def ui_refresh_concepts(request: Request, soa_id: int):
     if request.headers.get("HX-Request") == "true":
         return HTMLResponse("", headers={"HX-Redirect": f"/ui/soa/{soa_id}/edit"})
     # Fallback: plain form POST non-htmx redirect via script
+    # HTMX: return refreshed Element Audit section when requested
+    if request.headers.get("HX-Request") == "true":
+        conn_ea = _connect()
+        cur_ea = conn_ea.cursor()
+        cur_ea.execute("PRAGMA table_info(element_audit)")
+        cols = [row[1] for row in cur_ea.fetchall()]
+        want = [
+            "id",
+            "element_id",
+            "action",
+            "before_json",
+            "after_json",
+            "performed_at",
+        ]
+        available = [c for c in want if c in cols]
+        element_audits = []
+        if available:
+            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
+            cur_ea.execute(select_sql, (soa_id,))
+            for r in cur_ea.fetchall():
+                item = {}
+                for i, c in enumerate(available):
+                    item[c] = r[i]
+                for k in want:
+                    item.setdefault(k, None)
+                element_audits.append(item)
+        conn_ea.close()
+        html = templates.get_template("element_audit_section.html").render(
+            request=request, soa_id=soa_id, element_audits=element_audits
+        )
+        return HTMLResponse(html)
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )
@@ -2932,6 +2940,36 @@ def ui_add_activity(request: Request, soa_id: int, name: str = Form(...)):
             "activity_uid": f"Activity_{order_index}",
         },
     )
+    if request.headers.get("HX-Request") == "true":
+        conn_ea = _connect()
+        cur_ea = conn_ea.cursor()
+        cur_ea.execute("PRAGMA table_info(element_audit)")
+        cols = [row[1] for row in cur_ea.fetchall()]
+        want = [
+            "id",
+            "element_id",
+            "action",
+            "before_json",
+            "after_json",
+            "performed_at",
+        ]
+        available = [c for c in want if c in cols]
+        element_audits = []
+        if available:
+            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
+            cur_ea.execute(select_sql, (soa_id,))
+            for r in cur_ea.fetchall():
+                item = {}
+                for i, c in enumerate(available):
+                    item[c] = r[i]
+                for k in want:
+                    item.setdefault(k, None)
+                element_audits.append(item)
+        conn_ea.close()
+        html = templates.get_template("element_audit_section.html").render(
+            request=request, soa_id=soa_id, element_audits=element_audits
+        )
+        return HTMLResponse(html)
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )
@@ -3020,6 +3058,36 @@ def ui_update_meta(
     )
     conn.commit()
     conn.close()
+    if request.headers.get("HX-Request") == "true":
+        conn_ea = _connect()
+        cur_ea = conn_ea.cursor()
+        cur_ea.execute("PRAGMA table_info(element_audit)")
+        cols = [row[1] for row in cur_ea.fetchall()]
+        want = [
+            "id",
+            "element_id",
+            "action",
+            "before_json",
+            "after_json",
+            "performed_at",
+        ]
+        available = [c for c in want if c in cols]
+        element_audits = []
+        if available:
+            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
+            cur_ea.execute(select_sql, (soa_id,))
+            for r in cur_ea.fetchall():
+                item = {}
+                for i, c in enumerate(available):
+                    item[c] = r[i]
+                for k in want:
+                    item.setdefault(k, None)
+                element_audits.append(item)
+        conn_ea.close()
+        html = templates.get_template("element_audit_section.html").render(
+            request=request, soa_id=soa_id, element_audits=element_audits
+        )
+        return HTMLResponse(html)
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )
@@ -3373,6 +3441,31 @@ def ui_edit(request: Request, soa_id: int):
     ]
     conn_tr.close()
 
+    # Element audit list
+    conn_ea = _connect()
+    cur_ea = conn_ea.cursor()
+    # Handle legacy schemas gracefully by detecting available columns
+    cur_ea.execute("PRAGMA table_info(element_audit)")
+    cols = [row[1] for row in cur_ea.fetchall()]  # row[1] is column name
+    want = ["id", "element_id", "action", "before_json", "after_json", "performed_at"]
+    available = [c for c in want if c in cols]
+    if not available:
+        element_audits = []
+    else:
+        select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
+        cur_ea.execute(select_sql, (soa_id,))
+        rows = cur_ea.fetchall()
+        element_audits = []
+        for r in rows:
+            item = {}
+            for i, c in enumerate(available):
+                item[c] = r[i]
+            # Ensure keys for template even if missing
+            for k in want:
+                item.setdefault(k, None)
+            element_audits.append(item)
+    conn_ea.close()
+
     return templates.TemplateResponse(
         request,
         "edit.html",
@@ -3400,6 +3493,7 @@ def ui_edit(request: Request, soa_id: int):
             "epoch_audits": epoch_audits,
             "activity_audits": activity_audits,
             "study_cell_audits": study_cell_audits,
+            "element_audits": element_audits,
             # Epoch Type options (C99079)
             "epoch_type_options": epoch_type_options,
             # Study Cells
@@ -4240,19 +4334,8 @@ def ui_add_element(
     element_cols = {r[1] for r in cur.fetchall()}
     element_identifier: Optional[str] = None
     if "element_id" in element_cols:
-        # Generate StudyElement_<n> where n is next unused integer for this SOA
-        cur.execute("SELECT element_id FROM element WHERE soa_id=?", (soa_id,))
-        existing_raw = [r[0] for r in cur.fetchall() if r[0]]
-        used_nums = set()
-        for val in existing_raw:
-            if val.startswith("StudyElement_"):
-                tail = val.split("StudyElement_")[-1]
-                if tail.isdigit():
-                    used_nums.add(int(tail))
-        next_n = 1
-        while next_n in used_nums:
-            next_n += 1
-        element_identifier = f"StudyElement_{next_n}"
+        # Generate StudyElement_<n> monotonically increasing for this SOA
+        element_identifier = _next_element_identifier(soa_id)
         cur.execute(
             """INSERT INTO element (soa_id,name,label,description,testrl,teenrl,order_index,created_at,element_id)
             VALUES (?,?,?,?,?,?,?,?,?)""",
@@ -4286,10 +4369,11 @@ def ui_add_element(
     eid = cur.lastrowid
     conn.commit()
     conn.close()
+    # Audit should store the logical StudyElement_N in element_audit.element_id, not the row id
     _record_element_audit(
         soa_id,
         "create",
-        eid,
+        element_identifier,
         before=None,
         after={
             "id": eid,
@@ -4378,10 +4462,27 @@ def ui_update_element(
     updated_fields = [
         f for f in mutable_fields if before and before.get(f) != after.get(f)
     ]
+    # Fetch element.element_id for audit key
+    try:
+        conn_k = _connect()
+        cur_k = conn_k.cursor()
+        cur_k.execute("PRAGMA table_info(element)")
+        cols_k = {r[1] for r in cur_k.fetchall()}
+        element_uid_for_audit = None
+        if "element_id" in cols_k:
+            cur_k.execute(
+                "SELECT element_id FROM element WHERE id=? AND soa_id=?",
+                (element_id, soa_id),
+            )
+            row_k = cur_k.fetchone()
+            element_uid_for_audit = row_k[0] if row_k else None
+        conn_k.close()
+    except Exception:
+        element_uid_for_audit = None
     _record_element_audit(
         soa_id,
         "update",
-        element_id,
+        element_uid_for_audit,
         before=before,
         after={**after, "updated_fields": updated_fields},
     )
@@ -4397,11 +4498,47 @@ def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
+    # Capture before snapshot including logical element_id (StudyElement_N) if present
+    cur.execute("PRAGMA table_info(element)")
+    cols = {r[1] for r in cur.fetchall()}
+    has_uid = "element_id" in cols
+    if has_uid:
+        cur.execute(
+            "SELECT id, name, label, description, testrl, teenrl, order_index, element_id FROM element WHERE id=? AND soa_id=?",
+            (element_id, soa_id),
+        )
+    else:
+        cur.execute(
+            "SELECT id, name, label, description, testrl, teenrl, order_index, NULL as element_id FROM element WHERE id=? AND soa_id=?",
+            (element_id, soa_id),
+        )
+    row_b = cur.fetchone()
+    before = None
+    if row_b:
+        before = {
+            "id": row_b[0],
+            "name": row_b[1],
+            "label": row_b[2],
+            "description": row_b[3],
+            "testrl": row_b[4],
+            "teenrl": row_b[5],
+            "order_index": row_b[6],
+            "element_id": row_b[7],
+        }
+    # Perform delete
     cur.execute("DELETE FROM element WHERE id=? AND soa_id=?", (element_id, soa_id))
     conn.commit()
     conn.close()
+    # Use logical element_id (StudyElement_N) for audit key if available
+    element_uid_for_audit = (
+        before.get("element_id") if isinstance(before, dict) else None
+    )
     _record_element_audit(
-        soa_id, "delete", element_id, before={"id": element_id}, after=None
+        soa_id,
+        "delete",
+        element_uid_for_audit,
+        before=before or {"id": element_id},
+        after=None,
     )
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
@@ -4424,6 +4561,47 @@ def _next_study_cell_uid(cur, soa_id: int) -> str:
     return f"StudyCell_{max_n + 1}"
 
 
+def _next_element_identifier(soa_id: int) -> str:
+    """Compute next monotonically increasing StudyElement_N for an SoA.
+    Scans current element rows and element_audit snapshots to avoid reusing numbers after deletes.
+    """
+    conn = _connect()
+    cur = conn.cursor()
+    max_n = 0
+    try:
+        cur.execute("SELECT element_id FROM element WHERE soa_id=?", (soa_id,))
+        for (eid,) in cur.fetchall():
+            if isinstance(eid, str) and eid.startswith("StudyElement_"):
+                tail = eid.split("StudyElement_")[-1]
+                if tail.isdigit():
+                    max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    try:
+        cur.execute(
+            "SELECT before_json, after_json FROM element_audit WHERE soa_id=?",
+            (soa_id,),
+        )
+        for bjson, ajson in cur.fetchall():
+            for js in (bjson, ajson):
+                if not js:
+                    continue
+                try:
+                    obj = json.loads(js)
+                except Exception:
+                    obj = None
+                if isinstance(obj, dict):
+                    val = obj.get("element_id")
+                    if isinstance(val, str) and val.startswith("StudyElement_"):
+                        tail = val.split("StudyElement_")[-1]
+                        if tail.isdigit():
+                            max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    conn.close()
+    return f"StudyElement_{max_n + 1}"
+
+
 @app.post("/ui/soa/{soa_id}/add_study_cell", response_class=HTMLResponse)
 def ui_add_study_cell(
     request: Request,
diff --git a/src/soa_builder/web/audit.py b/src/soa_builder/web/audit.py
index 118fa07..b2847ef 100644
--- a/src/soa_builder/web/audit.py
+++ b/src/soa_builder/web/audit.py
@@ -45,6 +45,18 @@ def _record_element_audit(
     try:
         conn = _connect()
         cur = conn.cursor()
+        # Ensure table exists (defensive for migrated databases)
+        cur.execute(
+            """CREATE TABLE IF NOT EXISTS element_audit (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                soa_id INTEGER NOT NULL,
+                element_id INTEGER,
+                action TEXT NOT NULL,
+                before_json TEXT,
+                after_json TEXT,
+                performed_at TEXT NOT NULL
+            )"""
+        )
         cur.execute(
             "INSERT INTO element_audit (soa_id, element_id, action, before_json, after_json, performed_at) VALUES (?,?,?,?,?,?)",
             (
diff --git a/src/soa_builder/web/migrate_database.py b/src/soa_builder/web/migrate_database.py
index 16fc06e..03b8ef0 100644
--- a/src/soa_builder/web/migrate_database.py
+++ b/src/soa_builder/web/migrate_database.py
@@ -655,6 +655,62 @@ def _migrate_arm_add_type_fields():
         logger.warning("Arm type/data_origin_type migration failed: %s", e)
 
 
+# Migration: Ensure element_audit has before_json/after_json columns
+def _migrate_element_audit_columns():
+    """Add missing columns before_json and after_json to element_audit.
+
+    Handles legacy schemas that only had id, soa_id, element_id, action, performed_at.
+    Safe to run multiple times; idempotent via schema inspection.
+    """
+    try:
+        conn = _connect()
+        cur = conn.cursor()
+        # Ensure table exists; if not present, create with full schema
+        cur.execute(
+            "SELECT name FROM sqlite_master WHERE type='table' AND name='element_audit'"
+        )
+        exists = cur.fetchone() is not None
+        if not exists:
+            cur.execute(
+                """CREATE TABLE IF NOT EXISTS element_audit (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    soa_id INTEGER NOT NULL,
+                    element_id INTEGER,
+                    action TEXT NOT NULL,
+                    before_json TEXT,
+                    after_json TEXT,
+                    performed_at TEXT NOT NULL
+                )"""
+            )
+            conn.commit()
+            logger.info("Created element_audit table with full schema")
+            conn.close()
+            return
+        # Add columns if missing
+        cur.execute("PRAGMA table_info(element_audit)")
+        cols = {r[1] for r in cur.fetchall()}
+        alters = []
+        if "before_json" not in cols:
+            alters.append("ALTER TABLE element_audit ADD COLUMN before_json TEXT")
+        if "after_json" not in cols:
+            alters.append("ALTER TABLE element_audit ADD COLUMN after_json TEXT")
+        for stmt in alters:
+            try:
+                cur.execute(stmt)
+            except Exception as e:  # pragma: no cover
+                logger.warning(
+                    "Failed element_audit column migration '%s': %s", stmt, e
+                )
+        if alters:
+            conn.commit()
+            logger.info(
+                "Applied element_audit column migrations: %s", ", ".join(alters)
+            )
+        conn.close()
+    except Exception as e:  # pragma: no cover
+        logger.warning("element_audit column migration failed: %s", e)
+
+
 # Backfill dataset_date for existing terminology tables
 def _backfill_dataset_date(table: str, audit_table: str):
     """If terminology table exists and has dataset_date (or sheet_dataset_date) column with blank values,
diff --git a/src/soa_builder/web/routers/elements.py b/src/soa_builder/web/routers/elements.py
index 245b623..c2a1aca 100644
--- a/src/soa_builder/web/routers/elements.py
+++ b/src/soa_builder/web/routers/elements.py
@@ -1,6 +1,6 @@
 import json
 from datetime import datetime, timezone
-from typing import List
+from typing import List, Optional
 
 from fastapi import APIRouter, HTTPException
 from fastapi.responses import JSONResponse
@@ -21,6 +21,68 @@ def _soa_exists(soa_id: int) -> bool:
     return ok
 
 
+def _next_element_identifier(soa_id: int) -> str:
+    """Compute next monotonically increasing StudyElement_N for an SoA.
+    Scans current element rows and element_audit snapshots to avoid reusing numbers after deletes.
+    """
+    conn = _connect()
+    cur = conn.cursor()
+    max_n = 0
+    try:
+        cur.execute("SELECT element_id FROM element WHERE soa_id=?", (soa_id,))
+        for (eid,) in cur.fetchall():
+            if isinstance(eid, str) and eid.startswith("StudyElement_"):
+                tail = eid.split("StudyElement_")[-1]
+                if tail.isdigit():
+                    max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    try:
+        cur.execute(
+            "SELECT before_json, after_json FROM element_audit WHERE soa_id=?",
+            (soa_id,),
+        )
+        for bjson, ajson in cur.fetchall():
+            for js in (bjson, ajson):
+                if not js:
+                    continue
+                try:
+                    obj = json.loads(js)
+                except Exception:
+                    obj = None
+                if isinstance(obj, dict):
+                    val = obj.get("element_id")
+                    if isinstance(val, str) and val.startswith("StudyElement_"):
+                        tail = val.split("StudyElement_")[-1]
+                        if tail.isdigit():
+                            max_n = max(max_n, int(tail))
+    except Exception:
+        pass
+    conn.close()
+    return f"StudyElement_{max_n + 1}"
+
+
+def _get_element_uid(soa_id: int, row_id: int) -> Optional[str]:
+    """Return element.element_id (StudyElement_N) for row id if column exists, else None."""
+    try:
+        conn = _connect()
+        cur = conn.cursor()
+        cur.execute("PRAGMA table_info(element)")
+        cols = {r[1] for r in cur.fetchall()}
+        if "element_id" not in cols:
+            conn.close()
+            return None
+        cur.execute(
+            "SELECT element_id FROM element WHERE id=? AND soa_id=?",
+            (row_id, soa_id),
+        )
+        r = cur.fetchone()
+        conn.close()
+        return r[0] if r else None
+    except Exception:
+        return None
+
+
 @router.get("/elements", response_class=JSONResponse)
 def list_elements(soa_id: int):
     if not _soa_exists(soa_id):
@@ -28,7 +90,7 @@ def list_elements(soa_id: int):
     conn = _connect()
     cur = conn.cursor()
     cur.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE soa_id=? ORDER BY order_index",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE soa_id=? ORDER BY order_index",
         (soa_id,),
     )
     rows = [
@@ -41,6 +103,7 @@ def list_elements(soa_id: int):
             "teenrl": r[5],
             "order_index": r[6],
             "created_at": r[7],
+            "element_id": r[8] if len(r) > 8 else None,
         }
         for r in cur.fetchall()
     ]
@@ -55,7 +118,7 @@ def get_element(soa_id: int, element_id: int):
     conn = _connect()
     cur = conn.cursor()
     cur.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE id=? AND soa_id=?",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE id=? AND soa_id=?",
         (element_id, soa_id),
     )
     r = cur.fetchone()
@@ -72,6 +135,7 @@ def get_element(soa_id: int, element_id: int):
         "teenrl": r[5],
         "order_index": r[6],
         "created_at": r[7],
+        "element_id": r[8] if len(r) > 8 else None,
     }
 
 
@@ -123,20 +187,42 @@ def create_element(soa_id: int, payload: ElementCreate):
     )
     next_ord = (cur.fetchone() or [0])[0] + 1
     now = datetime.now(timezone.utc).isoformat()
-    cur.execute(
-        """INSERT INTO element (soa_id,name,label,description,testrl,teenrl,order_index,created_at)
-        VALUES (?,?,?,?,?,?,?,?)""",
-        (
-            soa_id,
-            name,
-            (payload.label or "").strip() or None,
-            (payload.description or "").strip() or None,
-            (payload.testrl or "").strip() or None,
-            (payload.teenrl or "").strip() or None,
-            next_ord,
-            now,
-        ),
-    )
+    # Insert, setting element_id if column exists
+    cur.execute("PRAGMA table_info(element)")
+    element_cols = {r[1] for r in cur.fetchall()}
+    element_identifier: Optional[str] = None
+    if "element_id" in element_cols:
+        element_identifier = _next_element_identifier(soa_id)
+        cur.execute(
+            """INSERT INTO element (soa_id,name,label,description,testrl,teenrl,order_index,created_at,element_id)
+            VALUES (?,?,?,?,?,?,?,?,?)""",
+            (
+                soa_id,
+                name,
+                (payload.label or "").strip() or None,
+                (payload.description or "").strip() or None,
+                (payload.testrl or "").strip() or None,
+                (payload.teenrl or "").strip() or None,
+                next_ord,
+                now,
+                element_identifier,
+            ),
+        )
+    else:
+        cur.execute(
+            """INSERT INTO element (soa_id,name,label,description,testrl,teenrl,order_index,created_at)
+            VALUES (?,?,?,?,?,?,?,?)""",
+            (
+                soa_id,
+                name,
+                (payload.label or "").strip() or None,
+                (payload.description or "").strip() or None,
+                (payload.testrl or "").strip() or None,
+                (payload.teenrl or "").strip() or None,
+                next_ord,
+                now,
+            ),
+        )
     eid = cur.lastrowid
     conn.commit()
     conn.close()
@@ -149,8 +235,10 @@ def create_element(soa_id: int, payload: ElementCreate):
         "teenrl": (payload.teenrl or "").strip() or None,
         "order_index": next_ord,
         "created_at": now,
+        "element_id": element_identifier,
     }
-    _record_element_audit(soa_id, "create", eid, before=None, after=el)
+    # Audit with logical StudyElement_N when available
+    _record_element_audit(soa_id, "create", element_identifier, before=None, after=el)
     return el
 
 
@@ -161,7 +249,7 @@ def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
     conn = _connect()
     cur = conn.cursor()
     cur.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE id=? AND soa_id=?",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE id=? AND soa_id=?",
         (element_id, soa_id),
     )
     row = cur.fetchone()
@@ -177,6 +265,7 @@ def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
         "teenrl": row[5],
         "order_index": row[6],
         "created_at": row[7],
+        "element_id": row[8],
     }
     new_name = (payload.name if payload.name is not None else before["name"]) or ""
     cur.execute(
@@ -196,7 +285,7 @@ def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
     )
     conn.commit()
     cur.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE id=?",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE id=?",
         (element_id,),
     )
     r = cur.fetchone()
@@ -210,13 +299,18 @@ def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
         "teenrl": r[5],
         "order_index": r[6],
         "created_at": r[7],
+        "element_id": r[8],
     }
     mutable_fields = ["name", "label", "description", "testrl", "teenrl"]
     updated_fields = [f for f in mutable_fields if before.get(f) != after.get(f)]
+    # Audit with logical StudyElement_N key
+    element_uid_for_audit = after.get("element_id") or _get_element_uid(
+        soa_id, element_id
+    )
     _record_element_audit(
         soa_id,
         "update",
-        element_id,
+        element_uid_for_audit,
         before=before,
         after={**after, "updated_fields": updated_fields},
     )
@@ -230,7 +324,7 @@ def delete_element(soa_id: int, element_id: int):
     conn = _connect()
     cur = conn.cursor()
     cur.execute(
-        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at FROM element WHERE id=? AND soa_id=?",
+        "SELECT id,name,label,description,testrl,teenrl,order_index,created_at,element_id FROM element WHERE id=? AND soa_id=?",
         (element_id, soa_id),
     )
     row = cur.fetchone()
@@ -246,11 +340,18 @@ def delete_element(soa_id: int, element_id: int):
         "teenrl": row[5],
         "order_index": row[6],
         "created_at": row[7],
+        "element_id": row[8],
     }
     cur.execute("DELETE FROM element WHERE id=?", (element_id,))
     conn.commit()
     conn.close()
-    _record_element_audit(soa_id, "delete", element_id, before=before, after=None)
+    _record_element_audit(
+        soa_id,
+        "delete",
+        before.get("element_id"),
+        before=before,
+        after=None,
+    )
     return JSONResponse({"deleted": True, "id": element_id})
 
 
diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index b24786e..eda9953 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -184,11 +184,11 @@ <h2>Editing SoA {{ soa_id }}</h2>
           <span class="ord">{{ el.order_index }}</span>. <strong>{{ el.name }}</strong>
           {% if el.label %}<em style="color:#555;font-size:0.7em;">[{{ el.label }}]</em>{% endif %}
           {% if el.testrl or el.teenrl %}<span style="font-size:0.6em;color:#2e7d32;">(rules)</span>{% endif %}
-          <form hx-post="/ui/soa/{{ soa_id }}/delete_element" hx-confirm="Delete element '{{ el.name }}'?" style="display:inline">
+          <form hx-post="/ui/soa/{{ soa_id }}/delete_element" hx-confirm="Delete element '{{ el.name }}'?" hx-target="#element-audit-section" hx-swap="outerHTML" style="display:inline">
             <input type="hidden" name="element_id" value="{{ el.id }}" />
             <button type="submit" class="delete-btn">✕</button>
           </form>
-          <form method="post" action="/ui/soa/{{ soa_id }}/update_element" style="display:inline;margin-left:6px;font-size:0.6em;">
+          <form hx-post="/ui/soa/{{ soa_id }}/update_element" hx-target="#element-audit-section" hx-swap="outerHTML" style="display:inline;margin-left:6px;font-size:0.6em;">
             <input type="hidden" name="element_id" value="{{ el.id }}" />
             <input name="name" value="{{ el.name }}" placeholder="Name" style="width:90px;" />
             <input name="label" value="{{ el.label or '' }}" placeholder="Label" style="width:70px;" />
@@ -200,7 +200,7 @@ <h2>Editing SoA {{ soa_id }}</h2>
         </li>
         {% endfor %}
       </ul>
-      <form method="post" action="/ui/soa/{{ soa_id }}/add_element" style="margin-top:6px;display:flex;flex-wrap:wrap;gap:4px;align-items:center;">
+      <form hx-post="/ui/soa/{{ soa_id }}/add_element" hx-target="#element-audit-section" hx-swap="outerHTML" style="margin-top:6px;display:flex;flex-wrap:wrap;gap:4px;align-items:center;">
         <input name="name" placeholder="Element Name" required style="flex:1;min-width:120px;" />
         <input name="label" placeholder="Label" required style="flex:1;min-width:110px;" />
         <input name="description" placeholder="Description" required style="flex:2;min-width:160px;" />
@@ -466,6 +466,7 @@ <h2>Editing SoA {{ soa_id }}</h2>
         <div style="font-size:0.75em;color:#777;">No study cell audit entries yet.</div>
       {% endif %}
     </details>
+    {% include 'element_audit_section.html' %}
   </div>
 </div>
 <hr />
diff --git a/src/soa_builder/web/templates/element_audit_section.html b/src/soa_builder/web/templates/element_audit_section.html
new file mode 100644
index 0000000..ad2ff0a
--- /dev/null
+++ b/src/soa_builder/web/templates/element_audit_section.html
@@ -0,0 +1,27 @@
+<details id="element-audit-section" class="collapsible">
+  <summary>Element Audit (latest {{ element_audits|length }})</summary>
+  {% if element_audits %}
+  <table style="width:100%;font-size:0.75em;border-collapse:collapse;">
+    <tr style="background:#eee;">
+      <th style="text-align:left;padding:4px;">ID</th>
+      <th style="text-align:left;padding:4px;">Element</th>
+      <th style="text-align:left;padding:4px;">Action</th>
+      <th style="text-align:left;padding:4px;">Performed</th>
+      <th style="text-align:left;padding:4px;">Before</th>
+      <th style="text-align:left;padding:4px;">After</th>
+    </tr>
+    {% for au in element_audits %}
+    <tr>
+      <td style="padding:4px;">{{ au.id }}</td>
+      <td style="padding:4px;">{{ au.element_id }}</td>
+      <td style="padding:4px;">{{ au.action }}</td>
+      <td style="padding:4px;">{{ au.performed_at }}</td>
+      <td style="padding:4px;white-space:pre-wrap;max-width:320px;">{{ au.before_json or '' }}</td>
+      <td style="padding:4px;white-space:pre-wrap;max-width:320px;">{{ au.after_json or '' }}</td>
+    </tr>
+    {% endfor %}
+  </table>
+  {% else %}
+    <div style="font-size:0.75em;color:#777;">No element audit entries yet.</div>
+  {% endif %}
+</details>
diff --git a/tests/test_element_audit_endpoint.py b/tests/test_element_audit_endpoint.py
new file mode 100644
index 0000000..a110498
--- /dev/null
+++ b/tests/test_element_audit_endpoint.py
@@ -0,0 +1,51 @@
+from fastapi.testclient import TestClient
+
+from soa_builder.web.app import app
+
+client = TestClient(app)
+
+
+def test_element_audit_endpoint_has_rows():
+    # Create study
+    resp = client.post("/soa", json={"name": "AuditCheck"})
+    assert resp.status_code == 200
+    soa_id = resp.json()["id"]
+
+    # Create element via UI endpoint (records create audit)
+    r1 = client.post(f"/ui/soa/{soa_id}/add_element", data={"name": "E1"})
+    assert r1.status_code == 200
+
+    # Update element
+    # Update element: get element id directly from DB to avoid UI joins
+    from soa_builder.web.app import _connect
+
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute("SELECT id FROM element WHERE soa_id=? ORDER BY id LIMIT 1", (soa_id,))
+    row = cur.fetchone()
+    assert row is not None, "Element was not created"
+    eid = int(row[0])
+    conn.close()
+
+    r2 = client.post(
+        f"/ui/soa/{soa_id}/update_element",
+        data={"element_id": eid, "name": "E1-upd"},
+    )
+    assert r2.status_code == 200
+
+    # Delete element
+    r3 = client.post(
+        f"/ui/soa/{soa_id}/delete_element",
+        data={"element_id": eid},
+    )
+    assert r3.status_code == 200
+
+    # Call element audit listing endpoint
+    audit = client.get(f"/soa/{soa_id}/element_audit")
+    assert audit.status_code == 200
+    rows = audit.json()
+    assert isinstance(rows, list)
+    # Should contain at least 3 rows for create, update, delete
+    assert len(rows) >= 3
+    actions = [r.get("action") for r in rows]
+    assert "create" in actions and "update" in actions and "delete" in actions
diff --git a/tests/test_element_id_monotonic.py b/tests/test_element_id_monotonic.py
new file mode 100644
index 0000000..d1232fa
--- /dev/null
+++ b/tests/test_element_id_monotonic.py
@@ -0,0 +1,66 @@
+from fastapi.testclient import TestClient
+
+from soa_builder.web.app import _connect, app
+
+client = TestClient(app)
+PREFIX = "StudyElement_"
+
+
+def create_soa(name="ElementIDMonotonicTest"):
+    resp = client.post("/soa", json={"name": name})
+    assert resp.status_code == 200
+    return resp.json()["id"]
+
+
+def get_first_element(soa_id):
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "SELECT id, element_id FROM element WHERE soa_id=? ORDER BY id LIMIT 1",
+        (soa_id,),
+    )
+    row = cur.fetchone()
+    conn.close()
+    return row
+
+
+def get_last_element(soa_id):
+    conn = _connect()
+    cur = conn.cursor()
+    cur.execute(
+        "SELECT id, element_id FROM element WHERE soa_id=? ORDER BY id DESC LIMIT 1",
+        (soa_id,),
+    )
+    row = cur.fetchone()
+    conn.close()
+    return row
+
+
+def test_element_id_monotonic_after_delete():
+    soa_id = create_soa()
+    # Create first element
+    r1 = client.post(f"/ui/soa/{soa_id}/add_element", data={"name": "Elem A"})
+    assert r1.status_code == 200
+    first = get_first_element(soa_id)
+    # If column absent or value None, skip monotonic assertion
+    if not first or first[1] is None:
+        return
+    assert first[1].startswith(PREFIX)
+    n1 = int(first[1][len(PREFIX) :])
+    assert n1 == 1
+
+    # Delete the first element via UI endpoint
+    del_resp = client.post(
+        f"/ui/soa/{soa_id}/delete_element", data={"element_id": first[0]}
+    )
+    assert del_resp.status_code == 200
+
+    # Create another element and ensure ID increments to 2 (monotonic)
+    r2 = client.post(f"/ui/soa/{soa_id}/add_element", data={"name": "Elem B"})
+    assert r2.status_code == 200
+    last = get_last_element(soa_id)
+    assert last is not None
+    assert last[1] is not None
+    assert last[1].startswith(PREFIX)
+    n2 = int(last[1][len(PREFIX) :])
+    assert n2 == 2

From 01c4e6b012801d4cc9944e3168df5278b5784051 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 10:40:13 -0500
Subject: [PATCH 13/32] Update src/soa_builder/web/initialize_database.py

Spelling

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/initialize_database.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/initialize_database.py b/src/soa_builder/web/initialize_database.py
index e8ecc0d..b6f2a98 100644
--- a/src/soa_builder/web/initialize_database.py
+++ b/src/soa_builder/web/initialize_database.py
@@ -189,7 +189,7 @@ def _init_db():
         """CREATE TABLE IF NOT EXISTS study_cell (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             soa_id INTEGER NOT NULL,
-            study_cell_uid TEXT NOT NULL, --immutable StudyCell_N identifier unique iwthin SOA
+            study_cell_uid TEXT NOT NULL, --immutable StudyCell_N identifier unique within SOA
             arm_uid TEXT NOT NULL,
             epoch_uid TEXT NOT NULL,
             element_uid TEXT NOT NULL

From b16579fcd4695e8d4037f570f269edf0af2d8254 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 10:57:58 -0500
Subject: [PATCH 14/32] Removed duplicate helpers and moved to utils

---
 src/soa_builder/web/app.py                | 41 ++---------------------
 src/soa_builder/web/routers/activities.py | 23 +++++--------
 src/soa_builder/web/routers/arms.py       | 19 ++++-------
 src/soa_builder/web/routers/elements.py   | 23 +++++--------
 src/soa_builder/web/routers/epochs.py     | 20 ++++-------
 src/soa_builder/web/routers/freezes.py    | 13 +++----
 src/soa_builder/web/routers/rollback.py   | 22 +++++-------
 src/soa_builder/web/routers/visits.py     | 19 ++++-------
 src/soa_builder/web/utils.py              | 14 ++++++++
 9 files changed, 66 insertions(+), 128 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index bfdcfab..fa9206a 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -62,6 +62,7 @@
 from .routers import activities as activities_router
 from .routers import arms as arms_router
 from .routers import elements as elements_router
+from .routers.elements import _next_element_identifier
 from .routers import epochs as epochs_router
 from .routers import freezes as freezes_router
 from .routers import rollback as rollback_router
@@ -4561,45 +4562,7 @@ def _next_study_cell_uid(cur, soa_id: int) -> str:
     return f"StudyCell_{max_n + 1}"
 
 
-def _next_element_identifier(soa_id: int) -> str:
-    """Compute next monotonically increasing StudyElement_N for an SoA.
-    Scans current element rows and element_audit snapshots to avoid reusing numbers after deletes.
-    """
-    conn = _connect()
-    cur = conn.cursor()
-    max_n = 0
-    try:
-        cur.execute("SELECT element_id FROM element WHERE soa_id=?", (soa_id,))
-        for (eid,) in cur.fetchall():
-            if isinstance(eid, str) and eid.startswith("StudyElement_"):
-                tail = eid.split("StudyElement_")[-1]
-                if tail.isdigit():
-                    max_n = max(max_n, int(tail))
-    except Exception:
-        pass
-    try:
-        cur.execute(
-            "SELECT before_json, after_json FROM element_audit WHERE soa_id=?",
-            (soa_id,),
-        )
-        for bjson, ajson in cur.fetchall():
-            for js in (bjson, ajson):
-                if not js:
-                    continue
-                try:
-                    obj = json.loads(js)
-                except Exception:
-                    obj = None
-                if isinstance(obj, dict):
-                    val = obj.get("element_id")
-                    if isinstance(val, str) and val.startswith("StudyElement_"):
-                        tail = val.split("StudyElement_")[-1]
-                        if tail.isdigit():
-                            max_n = max(max_n, int(tail))
-    except Exception:
-        pass
-    conn.close()
-    return f"StudyElement_{max_n + 1}"
+# _next_element_identifier is defined in routers/elements.py; imported above
 
 
 @app.post("/ui/soa/{soa_id}/add_study_cell", response_class=HTMLResponse)
diff --git a/src/soa_builder/web/routers/activities.py b/src/soa_builder/web/routers/activities.py
index b29b2e6..c75172c 100644
--- a/src/soa_builder/web/routers/activities.py
+++ b/src/soa_builder/web/routers/activities.py
@@ -11,6 +11,7 @@
 from ..audit import _record_activity_audit, _record_reorder_audit
 from ..db import _connect
 from ..schemas import ActivityCreate, ActivityUpdate, BulkActivities
+from ..utils import soa_exists
 
 _ACT_CONCEPT_CACHE = {"data": None, "fetched_at": 0}
 _ACT_CONCEPT_TTL = 60 * 60
@@ -71,18 +72,12 @@ def fetch_biomedical_concepts(force: bool = False):
 router = APIRouter(prefix="/soa/{soa_id}")
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    ok = cur.fetchone() is not None
-    conn.close()
-    return ok
+# Removed local _soa_exists; using shared utils.soa_exists
 
 
 @router.get("/activities", response_class=JSONResponse)
 def list_activities(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -100,7 +95,7 @@ def list_activities(soa_id: int):
 
 @router.get("/activities/{activity_id}", response_class=JSONResponse)
 def get_activity(soa_id: int, activity_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -123,7 +118,7 @@ def get_activity(soa_id: int, activity_id: int):
 
 @router.post("/activities", response_class=JSONResponse)
 def add_activity(soa_id: int, payload: ActivityCreate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -152,7 +147,7 @@ def add_activity(soa_id: int, payload: ActivityCreate):
 
 @router.patch("/activities/{activity_id}", response_class=JSONResponse)
 def update_activity(soa_id: int, activity_id: int, payload: ActivityUpdate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -196,7 +191,7 @@ def update_activity(soa_id: int, activity_id: int, payload: ActivityUpdate):
 
 @router.post("/activities/reorder", response_class=JSONResponse)
 def reorder_activities_api(soa_id: int, order: List[int]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
@@ -256,7 +251,7 @@ def reorder_activities_api(soa_id: int, order: List[int]):
 
 @router.post("/activities/bulk", response_class=JSONResponse)
 def add_activities_bulk(soa_id: int, payload: BulkActivities):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     names = [n.strip() for n in payload.names if n and n.strip()]
     if not names:
@@ -293,7 +288,7 @@ def add_activities_bulk(soa_id: int, payload: BulkActivities):
 
 @router.post("/activities/{activity_id}/concepts", response_class=JSONResponse)
 def set_activity_concepts(soa_id: int, activity_id: int, concept_codes: List[str]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
diff --git a/src/soa_builder/web/routers/arms.py b/src/soa_builder/web/routers/arms.py
index b3eccbc..975655a 100644
--- a/src/soa_builder/web/routers/arms.py
+++ b/src/soa_builder/web/routers/arms.py
@@ -7,22 +7,17 @@
 from ..audit import _record_arm_audit, _record_reorder_audit
 from ..db import _connect
 from ..schemas import ArmCreate, ArmUpdate
+from ..utils import soa_exists
 
 router = APIRouter(prefix="/soa/{soa_id}")
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    ok = cur.fetchone() is not None
-    conn.close()
-    return ok
+# Removed local _soa_exists; using shared utils.soa_exists
 
 
 @router.get("/arms", response_class=JSONResponse)
 def list_arms(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -49,7 +44,7 @@ def list_arms(soa_id: int):
 
 @router.post("/arms", response_class=JSONResponse, status_code=201)
 def create_arm(soa_id: int, payload: ArmCreate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     name = (payload.name or "").strip()
     if not name:
@@ -113,7 +108,7 @@ def create_arm(soa_id: int, payload: ArmCreate):
 
 @router.patch("/arms/{arm_id}", response_class=JSONResponse)
 def update_arm(soa_id: int, arm_id: int, payload: ArmUpdate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -190,7 +185,7 @@ def update_arm(soa_id: int, arm_id: int, payload: ArmUpdate):
 
 @router.delete("/arms/{arm_id}", response_class=JSONResponse)
 def delete_arm(soa_id: int, arm_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -221,7 +216,7 @@ def delete_arm(soa_id: int, arm_id: int):
 
 @router.post("/arms/reorder", response_class=JSONResponse)
 def reorder_arms_api(soa_id: int, order: List[int]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
diff --git a/src/soa_builder/web/routers/elements.py b/src/soa_builder/web/routers/elements.py
index c2a1aca..60e5d40 100644
--- a/src/soa_builder/web/routers/elements.py
+++ b/src/soa_builder/web/routers/elements.py
@@ -7,18 +7,13 @@
 
 from ..audit import _record_element_audit
 from ..db import _connect
+from ..utils import soa_exists
 from ..schemas import ElementCreate, ElementUpdate
 
 router = APIRouter(prefix="/soa/{soa_id}")
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    ok = cur.fetchone() is not None
-    conn.close()
-    return ok
+"""Shared SOA existence check imported from utils.so a_exists"""
 
 
 def _next_element_identifier(soa_id: int) -> str:
@@ -85,7 +80,7 @@ def _get_element_uid(soa_id: int, row_id: int) -> Optional[str]:
 
 @router.get("/elements", response_class=JSONResponse)
 def list_elements(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -113,7 +108,7 @@ def list_elements(soa_id: int):
 
 @router.get("/elements/{element_id}", response_class=JSONResponse)
 def get_element(soa_id: int, element_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -141,7 +136,7 @@ def get_element(soa_id: int, element_id: int):
 
 @router.get("/element_audit", response_class=JSONResponse)
 def list_element_audit(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -175,7 +170,7 @@ def list_element_audit(soa_id: int):
 
 @router.post("/elements", response_class=JSONResponse, status_code=201)
 def create_element(soa_id: int, payload: ElementCreate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     name = (payload.name or "").strip()
     if not name:
@@ -244,7 +239,7 @@ def create_element(soa_id: int, payload: ElementCreate):
 
 @router.patch("/elements/{element_id}", response_class=JSONResponse)
 def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -319,7 +314,7 @@ def update_element(soa_id: int, element_id: int, payload: ElementUpdate):
 
 @router.delete("/elements/{element_id}", response_class=JSONResponse)
 def delete_element(soa_id: int, element_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -357,7 +352,7 @@ def delete_element(soa_id: int, element_id: int):
 
 @router.post("/elements/reorder", response_class=JSONResponse)
 def reorder_elements_api(soa_id: int, order: List[int]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
diff --git a/src/soa_builder/web/routers/epochs.py b/src/soa_builder/web/routers/epochs.py
index 3e00146..f65bba4 100644
--- a/src/soa_builder/web/routers/epochs.py
+++ b/src/soa_builder/web/routers/epochs.py
@@ -8,6 +8,7 @@
 from fastapi.responses import JSONResponse
 
 from ..schemas import EpochCreate, EpochUpdate
+from ..utils import soa_exists
 
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 
@@ -18,15 +19,6 @@ def _connect():
     return sqlite3.connect(DB_PATH)
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    row = cur.fetchone()
-    conn.close()
-    return row is not None
-
-
 def _record_epoch_audit(
     soa_id: int,
     action: str,
@@ -56,7 +48,7 @@ def _record_epoch_audit(
 
 @router.post("/soa/{soa_id}/epochs")
 def add_epoch(soa_id: int, payload: EpochCreate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -99,7 +91,7 @@ def add_epoch(soa_id: int, payload: EpochCreate):
 
 @router.get("/soa/{soa_id}/epochs")
 def list_epochs(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -124,7 +116,7 @@ def list_epochs(soa_id: int):
 
 @router.get("/soa/{soa_id}/epochs/{epoch_id}")
 def get_epoch(soa_id: int, epoch_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -149,7 +141,7 @@ def get_epoch(soa_id: int, epoch_id: int):
 
 @router.post("/soa/{soa_id}/epochs/{epoch_id}/metadata")
 def update_epoch_metadata(soa_id: int, epoch_id: int, payload: EpochUpdate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -223,7 +215,7 @@ def update_epoch_metadata(soa_id: int, epoch_id: int, payload: EpochUpdate):
 
 @router.post("/soa/{soa_id}/epochs/reorder", response_class=JSONResponse)
 def reorder_epochs_api(soa_id: int, order: List[int]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
diff --git a/src/soa_builder/web/routers/freezes.py b/src/soa_builder/web/routers/freezes.py
index eba1c90..6cd327c 100644
--- a/src/soa_builder/web/routers/freezes.py
+++ b/src/soa_builder/web/routers/freezes.py
@@ -5,6 +5,7 @@
 from fastapi import APIRouter, Form, HTTPException, Request
 from fastapi.responses import HTMLResponse, JSONResponse
 from fastapi.templating import Jinja2Templates
+from ..utils import soa_exists
 
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 TEMPLATES_DIR = os.path.join(os.path.dirname(os.path.dirname(__file__)), "templates")
@@ -17,13 +18,7 @@ def _connect():
     return sqlite3.connect(DB_PATH)
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    r = cur.fetchone()
-    conn.close()
-    return r is not None
+# Removed local _soa_exists; using shared utils.soa_exists
 
 
 # Dynamic helper imports inside endpoint bodies avoid circular import at module load.
@@ -31,7 +26,7 @@ def _soa_exists(soa_id: int) -> bool:
 
 @router.post("/ui/soa/{soa_id}/freeze", response_class=HTMLResponse)
 def ui_freeze_soa(request: Request, soa_id: int, version_label: str = Form("")):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     try:
         from ..app import _create_freeze  # type: ignore
@@ -52,7 +47,7 @@ def ui_freeze_soa(request: Request, soa_id: int, version_label: str = Form("")):
 
 @router.get("/soa/{soa_id}/freeze/{freeze_id}")
 def get_freeze(soa_id: int, freeze_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
diff --git a/src/soa_builder/web/routers/rollback.py b/src/soa_builder/web/routers/rollback.py
index b32d02f..f8c111b 100644
--- a/src/soa_builder/web/routers/rollback.py
+++ b/src/soa_builder/web/routers/rollback.py
@@ -6,7 +6,7 @@
 from fastapi.responses import HTMLResponse, StreamingResponse
 from fastapi.templating import Jinja2Templates
 
-from ..db import _connect
+from ..utils import soa_exists
 
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 TEMPLATES_DIR = os.path.join(os.path.dirname(os.path.dirname(__file__)), "templates")
@@ -15,18 +15,12 @@
 router = APIRouter()
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    r = cur.fetchone()
-    conn.close()
-    return r is not None
+# Removed local _soa_exists; using shared utils.soa_exists
 
 
 @router.get("/soa/{soa_id}/rollback_audit")
 def get_rollback_audit_json(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_rollback_audit  # type: ignore
 
@@ -35,7 +29,7 @@ def get_rollback_audit_json(soa_id: int):
 
 @router.get("/soa/{soa_id}/reorder_audit")
 def get_reorder_audit_json(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_reorder_audit  # type: ignore
 
@@ -44,7 +38,7 @@ def get_reorder_audit_json(soa_id: int):
 
 @router.get("/ui/soa/{soa_id}/rollback_audit", response_class=HTMLResponse)
 def ui_rollback_audit(request: Request, soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_rollback_audit  # type: ignore
 
@@ -57,7 +51,7 @@ def ui_rollback_audit(request: Request, soa_id: int):
 
 @router.get("/ui/soa/{soa_id}/reorder_audit", response_class=HTMLResponse)
 def ui_reorder_audit(request: Request, soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_reorder_audit  # type: ignore
 
@@ -70,7 +64,7 @@ def ui_reorder_audit(request: Request, soa_id: int):
 
 @router.get("/soa/{soa_id}/rollback_audit/export/xlsx")
 def export_rollback_audit_xlsx(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_rollback_audit  # type: ignore
 
@@ -103,7 +97,7 @@ def export_rollback_audit_xlsx(soa_id: int):
 
 @router.get("/soa/{soa_id}/reorder_audit/export/xlsx")
 def export_reorder_audit_xlsx(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     from ..app import _list_reorder_audit  # type: ignore
 
diff --git a/src/soa_builder/web/routers/visits.py b/src/soa_builder/web/routers/visits.py
index 87296c5..5bcfbb4 100644
--- a/src/soa_builder/web/routers/visits.py
+++ b/src/soa_builder/web/routers/visits.py
@@ -5,23 +5,18 @@
 
 from ..audit import _record_reorder_audit, _record_visit_audit
 from ..db import _connect
+from ..utils import soa_exists
 from ..schemas import VisitCreate, VisitUpdate
 
 router = APIRouter(prefix="/soa/{soa_id}")
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    ok = cur.fetchone() is not None
-    conn.close()
-    return ok
+# Removed local _soa_exists; using shared utils.soa_exists
 
 
 @router.get("/visits", response_class=JSONResponse)
 def list_visits(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -45,7 +40,7 @@ def list_visits(soa_id: int):
 
 @router.get("/visits/{visit_id}", response_class=JSONResponse)
 def get_visit(soa_id: int, visit_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -69,7 +64,7 @@ def get_visit(soa_id: int, visit_id: int):
 
 @router.post("/visits", response_class=JSONResponse)
 def add_visit(soa_id: int, payload: VisitCreate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -108,7 +103,7 @@ def add_visit(soa_id: int, payload: VisitCreate):
 
 @router.patch("/visits/{visit_id}", response_class=JSONResponse)
 def update_visit(soa_id: int, visit_id: int, payload: VisitUpdate):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -178,7 +173,7 @@ def update_visit(soa_id: int, visit_id: int, payload: VisitUpdate):
 
 @router.post("/visits/reorder", response_class=JSONResponse)
 def reorder_visits_api(soa_id: int, order: List[int]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
diff --git a/src/soa_builder/web/utils.py b/src/soa_builder/web/utils.py
index 78049d6..f03c2f7 100644
--- a/src/soa_builder/web/utils.py
+++ b/src/soa_builder/web/utils.py
@@ -2,6 +2,7 @@
 import os
 import requests
 import time
+from .db import _connect
 
 _epoch_type_cache: dict[str, Any] = {
     "data": None,
@@ -227,3 +228,16 @@ def get_next_code_uid(cur: Any, soa_id: int) -> str:
         except Exception:
             n = len(existing) + 1
     return f"Code_{n}"
+
+
+def soa_exists(soa_id: int) -> bool:
+    """Return True if an SOA row exists with the given id."""
+    try:
+        conn = _connect()
+        cur = conn.cursor()
+        cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
+        ok = cur.fetchone() is not None
+        conn.close()
+        return ok
+    except Exception:
+        return False

From 550defbe07a8a6ab0f840d161ad54a703d313109 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:34:11 -0500
Subject: [PATCH 15/32] Update src/soa_builder/web/initialize_database.py

Spelling

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/initialize_database.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/initialize_database.py b/src/soa_builder/web/initialize_database.py
index b6f2a98..c4c06d4 100644
--- a/src/soa_builder/web/initialize_database.py
+++ b/src/soa_builder/web/initialize_database.py
@@ -201,7 +201,7 @@ def _init_db():
         """CREATE TABLE IF NOT EXISTS transition_rule (
             id INTEGER PRIMARY KEY AUTOINCREMENT,
             soa_id INTEGER NOT NULL,
-            transition_rule_uid TEXT NOT NULL,  --immutable TransitionRule_N identifier uniquie within SOA
+            transition_rule_uid TEXT NOT NULL,  --immutable TransitionRule_N identifier unique within SOA
             name TEXT NOT NULL,
             label TEXT,
             description TEXT,

From 85d01424050f9379714b3e4da990f5d6c401a598 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:43:11 -0500
Subject: [PATCH 16/32] Update src/soa_builder/web/templates/edit.html

Removed trailing whitespace

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/edit.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index eda9953..f3b80c7 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -355,7 +355,7 @@ <h2>Editing SoA {{ soa_id }}</h2>
         <input name="text" placeholder="Transition Rule text" required style="flex:2;min-width:160px;" />
         <button style="background:#1976d2;color:#fff;border:none;padding:4px 10px;border-radius:4px;cursor:pointer;">Add Transition Rule</button>
       </form>
-    </details>  
+    </details>
   </div>
   <div>
     <details id="activity-audit-section" class="collapsible">

From ea86359f18a7d1eea9efc1274b9caeb0513e6178 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:44:11 -0500
Subject: [PATCH 17/32] Update
 src/soa_builder/web/templates/protocol_terminology.html

Use of the 'placeholder' attribute instead of 'value' for hint text

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/protocol_terminology.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/protocol_terminology.html b/src/soa_builder/web/templates/protocol_terminology.html
index 01b04f2..4e69d6a 100644
--- a/src/soa_builder/web/templates/protocol_terminology.html
+++ b/src/soa_builder/web/templates/protocol_terminology.html
@@ -7,7 +7,7 @@ <h2>Protocol Terminology</h2>
   <fieldset style="display:inline-block; padding:0.5em 1em;">
     <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
     <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
-    <label>Sheet Name: <input type="text" name="sheet_name" value="Enter name of worksheet..." size="28"></label>
+    <label>Sheet Name: <input type="text" name="sheet_name" placeholder="Enter name of worksheet..." size="28"></label>
     <button type="submit" style="margin-left:1em;">Upload</button>
   </fieldset>
 </form>

From 4a556d08126f71766c3ea572eea2b19764f9f003 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:45:00 -0500
Subject: [PATCH 18/32] Update src/soa_builder/web/templates/edit.html

Added space after 'if' keyword as per JavaScript conventions

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/edit.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index f3b80c7..caa01e0 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -535,7 +535,7 @@ <h3>Matrix</h3>
   });
   const saved = localStorage.getItem('soa_collapse_'+sectionId);
   if(saved === '0') el.open = false;
-  else if(saved === '1') el.open = true;
+  else if (saved === '1') el.open = true;
 }
 persistSection('visits-section');
 persistSection('activities-section');

From ef00f5177757de25496fdb5090aac18089b99bc0 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:48:25 -0500
Subject: [PATCH 19/32] Removed the unrelated Element Audit HTMX block from
 ui_refresh_concepts in app.py

---
 src/soa_builder/web/app.py | 31 -------------------------------
 1 file changed, 31 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index fa9206a..bf65100 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -1740,37 +1740,6 @@ def ui_refresh_concepts(request: Request, soa_id: int):
     if request.headers.get("HX-Request") == "true":
         return HTMLResponse("", headers={"HX-Redirect": f"/ui/soa/{soa_id}/edit"})
     # Fallback: plain form POST non-htmx redirect via script
-    # HTMX: return refreshed Element Audit section when requested
-    if request.headers.get("HX-Request") == "true":
-        conn_ea = _connect()
-        cur_ea = conn_ea.cursor()
-        cur_ea.execute("PRAGMA table_info(element_audit)")
-        cols = [row[1] for row in cur_ea.fetchall()]
-        want = [
-            "id",
-            "element_id",
-            "action",
-            "before_json",
-            "after_json",
-            "performed_at",
-        ]
-        available = [c for c in want if c in cols]
-        element_audits = []
-        if available:
-            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
-            cur_ea.execute(select_sql, (soa_id,))
-            for r in cur_ea.fetchall():
-                item = {}
-                for i, c in enumerate(available):
-                    item[c] = r[i]
-                for k in want:
-                    item.setdefault(k, None)
-                element_audits.append(item)
-        conn_ea.close()
-        html = templates.get_template("element_audit_section.html").render(
-            request=request, soa_id=soa_id, element_audits=element_audits
-        )
-        return HTMLResponse(html)
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )

From 4eb380a936bb88dfb0a9adddbabb0c6193eb7dbd Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:50:38 -0500
Subject: [PATCH 20/32] Removed the Element Audit HTMX block from
 ui_add_activity in app.py

---
 src/soa_builder/web/app.py | 31 ++-----------------------------
 1 file changed, 2 insertions(+), 29 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index bf65100..11f9499 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -2910,36 +2910,9 @@ def ui_add_activity(request: Request, soa_id: int, name: str = Form(...)):
             "activity_uid": f"Activity_{order_index}",
         },
     )
+    # If HTMX, redirect back to edit page; otherwise script redirect
     if request.headers.get("HX-Request") == "true":
-        conn_ea = _connect()
-        cur_ea = conn_ea.cursor()
-        cur_ea.execute("PRAGMA table_info(element_audit)")
-        cols = [row[1] for row in cur_ea.fetchall()]
-        want = [
-            "id",
-            "element_id",
-            "action",
-            "before_json",
-            "after_json",
-            "performed_at",
-        ]
-        available = [c for c in want if c in cols]
-        element_audits = []
-        if available:
-            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
-            cur_ea.execute(select_sql, (soa_id,))
-            for r in cur_ea.fetchall():
-                item = {}
-                for i, c in enumerate(available):
-                    item[c] = r[i]
-                for k in want:
-                    item.setdefault(k, None)
-                element_audits.append(item)
-        conn_ea.close()
-        html = templates.get_template("element_audit_section.html").render(
-            request=request, soa_id=soa_id, element_audits=element_audits
-        )
-        return HTMLResponse(html)
+        return HTMLResponse("", headers={"HX-Redirect": f"/ui/soa/{soa_id}/edit"})
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )

From 3a2d0743af55a607d21bb89669d0d1cd69f3c438 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:52:33 -0500
Subject: [PATCH 21/32] emoved the unrelated Element Audit HTMX block from
 ui_update_meta in app.py

---
 src/soa_builder/web/app.py | 30 +-----------------------------
 1 file changed, 1 insertion(+), 29 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 11f9499..aff9de2 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -3002,35 +3002,7 @@ def ui_update_meta(
     conn.commit()
     conn.close()
     if request.headers.get("HX-Request") == "true":
-        conn_ea = _connect()
-        cur_ea = conn_ea.cursor()
-        cur_ea.execute("PRAGMA table_info(element_audit)")
-        cols = [row[1] for row in cur_ea.fetchall()]
-        want = [
-            "id",
-            "element_id",
-            "action",
-            "before_json",
-            "after_json",
-            "performed_at",
-        ]
-        available = [c for c in want if c in cols]
-        element_audits = []
-        if available:
-            select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
-            cur_ea.execute(select_sql, (soa_id,))
-            for r in cur_ea.fetchall():
-                item = {}
-                for i, c in enumerate(available):
-                    item[c] = r[i]
-                for k in want:
-                    item.setdefault(k, None)
-                element_audits.append(item)
-        conn_ea.close()
-        html = templates.get_template("element_audit_section.html").render(
-            request=request, soa_id=soa_id, element_audits=element_audits
-        )
-        return HTMLResponse(html)
+        return HTMLResponse("", headers={"HX-Redirect": f"/ui/soa/{soa_id}/edit"})
     return HTMLResponse(
         f"<script>window.location='/ui/soa/{int(soa_id)}/edit';</script>"
     )

From ef60569dfa2d5f97b612e569663b2806f0ab10da Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:53:52 -0500
Subject: [PATCH 22/32] Update src/soa_builder/web/templates/edit.html

Added fall to v.name if v.raw_header is blank

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/edit.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index caa01e0..07ba1bc 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -477,7 +477,7 @@ <h3>Matrix</h3>
     <th>Concepts</th>
     {% for v in visits %}
       <th style="min-width:70px;" data-visit-id="{{ v.id }}">
-        <div>{{ v.raw_header }}</div>
+        <div>{{ v.raw_header or v.name }}</div>
         <div style="font-size:0.65em;color:#555;line-height:1.1;">Encounter: {{ v.name }}</div>
         {% if v.epoch_id %}
           {% set ep = (epochs | selectattr('id','equalto', v.epoch_id) | list) %}

From 1efc03c9c065a23370629ec3bcff5eea16737c5b Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 11:57:19 -0500
Subject: [PATCH 23/32] Removed duplicated code block for fetching element
 audits

---
 src/soa_builder/web/app.py | 54 ++++++++++++++++++++++----------------
 1 file changed, 31 insertions(+), 23 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index aff9de2..444c943 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -3008,6 +3008,36 @@ def ui_update_meta(
     )
 
 
+# Helper to fetch element audit rows with legacy-safe columns
+def _fetch_element_audits(soa_id: int):
+    conn_ea = _connect()
+    cur_ea = conn_ea.cursor()
+    cur_ea.execute("PRAGMA table_info(element_audit)")
+    cols = [row[1] for row in cur_ea.fetchall()]
+    want = [
+        "id",
+        "element_id",
+        "action",
+        "before_json",
+        "after_json",
+        "performed_at",
+    ]
+    available = [c for c in want if c in cols]
+    element_audits = []
+    if available:
+        select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
+        cur_ea.execute(select_sql, (soa_id,))
+        for r in cur_ea.fetchall():
+            item = {}
+            for i, c in enumerate(available):
+                item[c] = r[i]
+            for k in want:
+                item.setdefault(k, None)
+            element_audits.append(item)
+    conn_ea.close()
+    return element_audits
+
+
 @app.get("/ui/soa/{soa_id}/edit", response_class=HTMLResponse)
 def ui_edit(request: Request, soa_id: int):
     """Render edit HTML page for an SoA."""
@@ -3357,29 +3387,7 @@ def ui_edit(request: Request, soa_id: int):
     conn_tr.close()
 
     # Element audit list
-    conn_ea = _connect()
-    cur_ea = conn_ea.cursor()
-    # Handle legacy schemas gracefully by detecting available columns
-    cur_ea.execute("PRAGMA table_info(element_audit)")
-    cols = [row[1] for row in cur_ea.fetchall()]  # row[1] is column name
-    want = ["id", "element_id", "action", "before_json", "after_json", "performed_at"]
-    available = [c for c in want if c in cols]
-    if not available:
-        element_audits = []
-    else:
-        select_sql = f"SELECT {', '.join(available)} FROM element_audit WHERE soa_id=? ORDER BY id DESC"
-        cur_ea.execute(select_sql, (soa_id,))
-        rows = cur_ea.fetchall()
-        element_audits = []
-        for r in rows:
-            item = {}
-            for i, c in enumerate(available):
-                item[c] = r[i]
-            # Ensure keys for template even if missing
-            for k in want:
-                item.setdefault(k, None)
-            element_audits.append(item)
-    conn_ea.close()
+    element_audits = _fetch_element_audits(soa_id)
 
     return templates.TemplateResponse(
         request,

From 630c91bf77fa76ee182e5bac4ded241a3dfb28db Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:02:13 -0500
Subject: [PATCH 24/32] Update src/soa_builder/web/templates/edit.html

Remove redundant conditional check

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/edit.html | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/soa_builder/web/templates/edit.html b/src/soa_builder/web/templates/edit.html
index 07ba1bc..1c251fd 100644
--- a/src/soa_builder/web/templates/edit.html
+++ b/src/soa_builder/web/templates/edit.html
@@ -535,7 +535,6 @@ <h3>Matrix</h3>
   });
   const saved = localStorage.getItem('soa_collapse_'+sectionId);
   if(saved === '0') el.open = false;
-  else if (saved === '1') el.open = true;
 }
 persistSection('visits-section');
 persistSection('activities-section');

From 95410b833cb36e0557a3deaa19fb6fae1b45985a Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:04:01 -0500
Subject: [PATCH 25/32] Update src/soa_builder/web/app.py

_list_study_cells now returns epoch_name

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/app.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 444c943..117631d 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -1021,7 +1021,7 @@ def _fetch_matrix(soa_id: int):
 def _list_study_cells(soa_id: int) -> list[dict]:
     """List study_cell rows, including element and arm names filtered by soa_id.
 
-    Returns: [{id, study_cell_uid, arm_uid, epoch_uid, element_uid, element_name, arm_name}]
+    Returns: [{id, study_cell_uid, arm_uid, epoch_uid, element_uid, element_name, arm_name, epoch_name}]
     """
     conn = _connect()
     cur = conn.cursor()

From bf945328cedf04320f91441a259f81b136616cd8 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:07:57 -0500
Subject: [PATCH 26/32] simplify the element delete query to avoid selecting
 NULL as element_id and handle missing element_id

---
 src/soa_builder/web/app.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 117631d..7df7b2a 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -4432,7 +4432,7 @@ def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)
         )
     else:
         cur.execute(
-            "SELECT id, name, label, description, testrl, teenrl, order_index, NULL as element_id FROM element WHERE id=? AND soa_id=?",
+            "SELECT id, name, label, description, testrl, teenrl, order_index FROM element WHERE id=? AND soa_id=?",
             (element_id, soa_id),
         )
     row_b = cur.fetchone()
@@ -4446,7 +4446,7 @@ def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)
             "testrl": row_b[4],
             "teenrl": row_b[5],
             "order_index": row_b[6],
-            "element_id": row_b[7],
+            "element_id": (row_b[7] if has_uid else None),
         }
     # Perform delete
     cur.execute("DELETE FROM element WHERE id=? AND soa_id=?", (element_id, soa_id))

From d0ed1c151b91f367b6539700dd46ce61eae8f444 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:14:42 -0500
Subject: [PATCH 27/32] replaced all _soa_exists usages in app.py with the
 shared soa_exists from utils and removed the local _soa_exists helper

---
 src/soa_builder/web/app.py | 100 ++++++++++++++++++-------------------
 1 file changed, 49 insertions(+), 51 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 7df7b2a..443401a 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -70,7 +70,11 @@
 from .routers.arms import create_arm  # re-export for backward compatibility
 from .routers.arms import delete_arm
 from .schemas import ArmCreate, SOACreate, SOAMetadataUpdate
-from .utils import get_next_code_uid as _get_next_code_uid, load_epoch_type_options
+from .utils import (
+    get_next_code_uid as _get_next_code_uid,
+    load_epoch_type_options,
+    soa_exists,
+)
 
 # Audit functions
 from .audit import _record_element_audit
@@ -299,7 +303,7 @@ def _record_arm_audit(
 @app.post("/soa/{soa_id}/visits/reorder", response_class=JSONResponse)
 def reorder_visits_api(soa_id: int, order: List[int]):
     """JSON reorder endpoint for visits (parity with elements). Body is array of visit IDs in desired order."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
@@ -323,7 +327,7 @@ def reorder_visits_api(soa_id: int, order: List[int]):
 @app.post("/soa/{soa_id}/activities/reorder", response_class=JSONResponse)
 def reorder_activities_api(soa_id: int, order: List[int]):
     """JSON reorder endpoint for activities."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not order:
         raise HTTPException(400, "Order list required")
@@ -429,7 +433,7 @@ def _get_freeze(soa_id: int, freeze_id: int):
 
 
 def _create_freeze(soa_id: int, version_label: Optional[str]):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     # Auto version label if not provided
     conn = _connect()
@@ -983,13 +987,7 @@ class MatrixImport(BaseModel):
 # --------------------- Helpers ---------------------
 
 
-def _soa_exists(soa_id: int) -> bool:
-    conn = _connect()
-    cur = conn.cursor()
-    cur.execute("SELECT 1 FROM soa WHERE id=?", (soa_id,))
-    row = cur.fetchone()
-    conn.close()
-    return row is not None
+# Use shared utils.soa_exists instead of local helper
 
 
 def _fetch_matrix(soa_id: int):
@@ -1733,7 +1731,7 @@ async def lifespan(app: FastAPI):  # pragma: no cover
 @app.post("/ui/soa/{soa_id}/concepts_refresh")
 def ui_refresh_concepts(request: Request, soa_id: int):
     """Fetch Biomedical Concepts; refresh cache"""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     fetch_biomedical_concepts(force=True)
     # If HTMX request, use HX-Redirect header for clean redirect without injecting script
@@ -1751,7 +1749,7 @@ def ui_refresh_concepts(request: Request, soa_id: int):
 @app.get("/soa/{soa_id}/reorder_audit/export/csv")
 def export_reorder_audit_csv(soa_id: int):
     """Export reorder audit history to CSV."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     rows = _list_reorder_audit(soa_id)
     # Prepare CSV lines
@@ -1937,7 +1935,7 @@ def create_soa(payload: SOACreate):
 @app.get("/soa/{soa_id}")
 def get_soa(soa_id: int):
     """Return SoA by ID"""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     visits, activities, cells = _fetch_matrix(soa_id)
     # Fetch epochs
@@ -1989,7 +1987,7 @@ def get_soa(soa_id: int):
 @app.post("/soa/{soa_id}/metadata")
 def update_soa_metadata(soa_id: int, payload: SOAMetadataUpdate):
     """Update metadata for SoA/Study."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2052,7 +2050,7 @@ def update_soa_metadata(soa_id: int, payload: SOAMetadataUpdate):
 @app.post("/soa/{soa_id}/activities/{activity_id}/concepts")
 def set_activity_concepts(soa_id: int, activity_id: int, payload: ConceptsUpdate):
     """Update Biomedical Concept assigned to an Activity."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2102,7 +2100,7 @@ def ui_add_activity_concept(
     """Add Biomedical Concept to an Activity."""
     if not activity_id:
         raise HTTPException(400, "Missing activity_id")
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     code = concept_code.strip()
     if not code:
@@ -2150,7 +2148,7 @@ def ui_remove_activity_concept(
     """Remove Biomedical Concept from Activity."""
     if not activity_id:
         raise HTTPException(400, "Missing activity_id")
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     code = concept_code.strip()
     if not code:
@@ -2183,7 +2181,7 @@ def ui_remove_activity_concept(
 @app.post("/soa/{soa_id}/cells")
 def set_cell(soa_id: int, payload: CellCreate):
     """Set 'X' in SoA Matrix cell."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2220,7 +2218,7 @@ def set_cell(soa_id: int, payload: CellCreate):
 @app.get("/soa/{soa_id}/matrix")
 def get_matrix(soa_id: int):
     """Return SoA Matrix for Visits, Activities and assigned Matrix Cells."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     visits, activities, cells = _fetch_matrix(soa_id)
     return {"visits": visits, "activities": activities, "cells": cells}
@@ -2229,7 +2227,7 @@ def get_matrix(soa_id: int):
 @app.get("/soa/{soa_id}/export/xlsx")
 def export_xlsx(soa_id: int, left: Optional[int] = None, right: Optional[int] = None):
     """Export SoA Matrix to XLSX."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     visits, activities, cells = _fetch_matrix(soa_id)
     if not visits or not activities:
@@ -2448,7 +2446,7 @@ def export_pdf(soa_id: int):
     The PDF is intentionally simple and produced without external dependencies to avoid
     introducing new packages. It uses a single page with monospaced layout style commands.
     """
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2617,7 +2615,7 @@ def add(line: str):
 
 @app.get("/soa/{soa_id}/normalized")
 def get_normalized(soa_id: int):
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     csv_path = _generate_wide_csv(soa_id)
     out_dir = os.path.join(NORMALIZED_ROOT, f"soa_{soa_id}")
@@ -2631,7 +2629,7 @@ def get_normalized(soa_id: int):
 @app.post("/soa/{soa_id}/matrix/import")
 def import_matrix(soa_id: int, payload: MatrixImport):
     """Import SoA Matrix."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     if not payload.visits:
         raise HTTPException(400, "visits list empty")
@@ -2730,7 +2728,7 @@ def _reindex(table: str, soa_id: int):
 @app.delete("/soa/{soa_id}/visits/{visit_id}")
 def delete_visit(soa_id: int, visit_id: int):
     """Delete Visit from an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2768,7 +2766,7 @@ def delete_visit(soa_id: int, visit_id: int):
 @app.delete("/soa/{soa_id}/activities/{activity_id}")
 def delete_activity(soa_id: int, activity_id: int):
     """Delete Activity from an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2799,7 +2797,7 @@ def delete_activity(soa_id: int, activity_id: int):
 @app.delete("/soa/{soa_id}/epochs/{epoch_id}")
 def delete_epoch(soa_id: int, epoch_id: int):
     """Delete an Epoch from an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -2882,7 +2880,7 @@ def ui_index(request: Request):
 @app.post("/ui/soa/{soa_id}/add_activity", response_class=HTMLResponse)
 def ui_add_activity(request: Request, soa_id: int, name: str = Form(...)):
     """Add an Activity to an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     nm = (name or "").strip()
     if not nm:
@@ -2962,7 +2960,7 @@ def ui_update_meta(
     study_description: Optional[str] = Form(None),
 ):
     """Update the metadata for an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -3041,7 +3039,7 @@ def _fetch_element_audits(soa_id: int):
 @app.get("/ui/soa/{soa_id}/edit", response_class=HTMLResponse)
 def ui_edit(request: Request, soa_id: int):
     """Render edit HTML page for an SoA."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     visits, activities, cells = _fetch_matrix(soa_id)
     # Epochs list
@@ -3703,7 +3701,7 @@ def ui_add_visit(
     Accepts either form field name `epoch_id_raw` (new) or `epoch_id` (legacy).
     Blank selection is treated as None without triggering 422 validation.
     """
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     # Determine which raw epoch string was provided
     provided = (epoch_id_raw or "").strip() or (epoch_id or "").strip()
@@ -3770,7 +3768,7 @@ async def ui_add_arm(
     element_id: Optional[str] = Form(None),
 ):
     """Form handler to create a new Arm."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     # Accept blank/empty element selection gracefully. The form may submit "" which would 422 with Optional[int].
     eid = int(element_id) if element_id and element_id.strip().isdigit() else None
@@ -3931,7 +3929,7 @@ async def ui_update_arm(
     element_id: Optional[str] = Form(None),
 ):
     """Form handler to update an existing Arm."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
 
     # Read raw form to capture field names with hyphens: 'arm-type' and 'data-origin-type'
@@ -4199,7 +4197,7 @@ def ui_delete_arm(request: Request, soa_id: int, arm_id: int = Form(...)):
 @app.post("/ui/soa/{soa_id}/reorder_arms", response_class=HTMLResponse)
 def ui_reorder_arms(request: Request, soa_id: int, order: str = Form("")):
     """Form handler to reorder existing Arms."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     ids = [int(x) for x in order.split(",") if x.strip().isdigit()]
     if not ids:
@@ -4239,7 +4237,7 @@ def ui_add_element(
     teenrl: Optional[str] = Form(None),
 ):
     """Form handler to add an element."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     name = (name or "").strip()
     if not name:
@@ -4326,7 +4324,7 @@ def ui_update_element(
     teenrl: Optional[str] = Form(None),
 ):
     """Form handler to update an existing Element."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -4417,7 +4415,7 @@ def ui_update_element(
 @app.post("/ui/soa/{soa_id}/delete_element", response_class=HTMLResponse)
 def ui_delete_element(request: Request, soa_id: int, element_id: int = Form(...)):
     """Form handler to delete an existing Element."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -4499,7 +4497,7 @@ def ui_add_study_cell(
 
     Duplicate prevention enforced on (soa_id, arm_uid, epoch_uid, element_uid).
     """
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     arm_uid = (arm_uid or "").strip()
     epoch_uid = (epoch_uid or "").strip()
@@ -4596,7 +4594,7 @@ def ui_update_study_cell(
 
     Duplicate prevention enforced; if update causes a duplicate, no change is applied.
     """
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -4660,7 +4658,7 @@ def ui_update_study_cell(
 @app.post("/ui/soa/{soa_id}/delete_study_cell", response_class=HTMLResponse)
 def ui_delete_study_cell(request: Request, soa_id: int, study_cell_id: int = Form(...)):
     """Delete a Study Cell by id."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -4710,7 +4708,7 @@ def ui_add_epoch(
     epoch_type_submission_value: Optional[str] = Form(None),
 ):
     """Form handler to add an Epoch."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -4799,7 +4797,7 @@ def ui_update_epoch(
     epoch_type_submission_value: Optional[str] = Form(None),
 ):
     """Form handler to update an existing Epoch."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -5004,7 +5002,7 @@ def ui_add_transition_rule(
     text: str = Form(...),
 ):
     """Form handler to add a Transition Rule."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     name = (name or "").strip()
     if not name:
@@ -5070,7 +5068,7 @@ def ui_transition_rule_update(
     text: Optional[str] = Form(None),
 ):
     """Form handler to update an existing Transition Rule."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -5173,7 +5171,7 @@ def ui_delete_transition_rule(
     request: Request, soa_id: int, transition_rule_uid: str = Form(...)
 ):
     """Form handler to delete a transition rule"""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     conn = _connect()
     cur = conn.cursor()
@@ -5288,7 +5286,7 @@ def ui_activity_concepts_cell(
     # surface a clear 400 error rather than proceeding and causing confusing downstream behavior.
     if not activity_id:
         raise HTTPException(status_code=400, detail="Missing activity_id")
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     concepts = fetch_biomedical_concepts()
     conn = _connect()
@@ -5336,7 +5334,7 @@ def ui_toggle_cell(
 ):
     """Toggle logic: blank -> X, X -> blank (delete row). Returns updated <td> snippet with next action encoded.
     This avoids stale hx-vals attributes after a partial swap."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     # Determine current status
     conn = _connect()
@@ -5403,7 +5401,7 @@ def ui_set_visit_epoch(
     epoch_id: str = Form(""),  # legacy field name used by template select
 ):
     """Form handler to associate an Epoch with a Visit/Encounter."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     # Determine provided raw value (prefer epoch_id_raw if non-blank)
     raw_val = (epoch_id_raw or "").strip() or (epoch_id or "").strip()
@@ -5463,7 +5461,7 @@ def ui_delete_epoch(request: Request, soa_id: int, epoch_id: int = Form(...)):
 @app.post("/ui/soa/{soa_id}/reorder_visits", response_class=HTMLResponse)
 def ui_reorder_visits(request: Request, soa_id: int, order: str = Form("")):
     """Persist new visit ordering. 'order' is a comma-separated list of visit IDs in desired order."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     ids = [int(x) for x in order.split(",") if x.strip().isdigit()]
     if not ids:
@@ -5491,7 +5489,7 @@ def ui_reorder_visits(request: Request, soa_id: int, order: str = Form("")):
 @app.post("/ui/soa/{soa_id}/reorder_activities", response_class=HTMLResponse)
 def ui_reorder_activities(request: Request, soa_id: int, order: str = Form("")):
     """Persist new activity ordering. 'order' is a comma-separated list of activity IDs in desired order."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     ids = [int(x) for x in order.split(",") if x.strip().isdigit()]
     if not ids:
@@ -5519,7 +5517,7 @@ def ui_reorder_activities(request: Request, soa_id: int, order: str = Form("")):
 @app.post("/ui/soa/{soa_id}/reorder_epochs", response_class=HTMLResponse)
 def ui_reorder_epochs(request: Request, soa_id: int, order: str = Form("")):
     """Form handler to persist new epoch ordering."""
-    if not _soa_exists(soa_id):
+    if not soa_exists(soa_id):
         raise HTTPException(404, "SOA not found")
     ids = [int(x) for x in order.split(",") if x.strip().isdigit()]
     if not ids:

From 39a0618ea5868b6a693b1663be5ab759041afa05 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:15:59 -0500
Subject: [PATCH 28/32] Update
 src/soa_builder/web/templates/protocol_terminology.html

sheet name field is now marked as required

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/protocol_terminology.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/protocol_terminology.html b/src/soa_builder/web/templates/protocol_terminology.html
index 4e69d6a..40e176e 100644
--- a/src/soa_builder/web/templates/protocol_terminology.html
+++ b/src/soa_builder/web/templates/protocol_terminology.html
@@ -7,7 +7,7 @@ <h2>Protocol Terminology</h2>
   <fieldset style="display:inline-block; padding:0.5em 1em;">
     <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
     <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
-    <label>Sheet Name: <input type="text" name="sheet_name" placeholder="Enter name of worksheet..." size="28"></label>
+    <label>Sheet Name: <input type="text" name="sheet_name" placeholder="Enter name of worksheet..." size="28" required></label>
     <button type="submit" style="margin-left:1em;">Upload</button>
   </fieldset>
 </form>

From 2248c2b7cf7fab0a55486e66bff5dae383321aee Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:17:07 -0500
Subject: [PATCH 29/32] Update
 src/soa_builder/web/templates/ddf_terminology.html

Use of 'placeholder' attribute instead of 'value' for hint text

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/templates/ddf_terminology.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/templates/ddf_terminology.html b/src/soa_builder/web/templates/ddf_terminology.html
index 967143d..65b3277 100644
--- a/src/soa_builder/web/templates/ddf_terminology.html
+++ b/src/soa_builder/web/templates/ddf_terminology.html
@@ -7,7 +7,7 @@ <h2>DDF Terminology</h2>
   <fieldset style="display:inline-block; padding:0.5em 1em;">
     <legend>Upload Excel Workbook (.xls/.xlsx)</legend>
     <label style="margin-left:1em;">File: <input type="file" name="file" accept=".xls,.xlsx" required></label>
-    <label>Sheet Name: <input type="text" name="sheet_name" value="Enter name of worksheet..." size="28"></label>
+    <label>Sheet Name: <input type="text" name="sheet_name" placeholder="Enter name of worksheet..." size="28"></label>
     <button type="submit" style="margin-left:1em;">Upload</button>
   </fieldset>
 </form>

From 0a4551475991fe270868fcb902dfe3fa1677a914 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:18:04 -0500
Subject: [PATCH 30/32] Update src/soa_builder/web/routers/elements.py

spelling

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
---
 src/soa_builder/web/routers/elements.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/soa_builder/web/routers/elements.py b/src/soa_builder/web/routers/elements.py
index 60e5d40..772280d 100644
--- a/src/soa_builder/web/routers/elements.py
+++ b/src/soa_builder/web/routers/elements.py
@@ -13,7 +13,7 @@
 router = APIRouter(prefix="/soa/{soa_id}")
 
 
-"""Shared SOA existence check imported from utils.so a_exists"""
+"""Shared SOA existence check imported from utils.soa_exists"""
 
 
 def _next_element_identifier(soa_id: int) -> str:

From 59f8d1f14625d47823519803a576ec6aa6db2b45 Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 12:33:19 -0500
Subject: [PATCH 31/32] Added uniform logging to database-facing helpers and
 validated

---
 src/soa_builder/web/routers/elements.py | 29 ++++++++++++++++++++-----
 src/soa_builder/web/routers/epochs.py   | 20 +++++++++++++----
 2 files changed, 39 insertions(+), 10 deletions(-)

diff --git a/src/soa_builder/web/routers/elements.py b/src/soa_builder/web/routers/elements.py
index 772280d..467374d 100644
--- a/src/soa_builder/web/routers/elements.py
+++ b/src/soa_builder/web/routers/elements.py
@@ -1,4 +1,5 @@
 import json
+import logging
 from datetime import datetime, timezone
 from typing import List, Optional
 
@@ -30,8 +31,12 @@ def _next_element_identifier(soa_id: int) -> str:
                 tail = eid.split("StudyElement_")[-1]
                 if tail.isdigit():
                     max_n = max(max_n, int(tail))
-    except Exception:
-        pass
+    except Exception as e:
+        logging.getLogger("soa_builder.elements").exception(
+            "_next_element_identifier scan elements failed for soa_id=%s: %s",
+            soa_id,
+            e,
+        )
     try:
         cur.execute(
             "SELECT before_json, after_json FROM element_audit WHERE soa_id=?",
@@ -43,7 +48,12 @@ def _next_element_identifier(soa_id: int) -> str:
                     continue
                 try:
                     obj = json.loads(js)
-                except Exception:
+                except Exception as e:
+                    logging.getLogger("soa_builder.elements").debug(
+                        "_next_element_identifier JSON parse failed soa_id=%s: %s",
+                        soa_id,
+                        e,
+                    )
                     obj = None
                 if isinstance(obj, dict):
                     val = obj.get("element_id")
@@ -51,8 +61,12 @@ def _next_element_identifier(soa_id: int) -> str:
                         tail = val.split("StudyElement_")[-1]
                         if tail.isdigit():
                             max_n = max(max_n, int(tail))
-    except Exception:
-        pass
+    except Exception as e:
+        logging.getLogger("soa_builder.elements").exception(
+            "_next_element_identifier scan element_audit failed for soa_id=%s: %s",
+            soa_id,
+            e,
+        )
     conn.close()
     return f"StudyElement_{max_n + 1}"
 
@@ -74,7 +88,10 @@ def _get_element_uid(soa_id: int, row_id: int) -> Optional[str]:
         r = cur.fetchone()
         conn.close()
         return r[0] if r else None
-    except Exception:
+    except Exception as e:
+        logging.getLogger("soa_builder.elements").exception(
+            "_get_element_uid failed for soa_id=%s row_id=%s: %s", soa_id, row_id, e
+        )
         return None
 
 
diff --git a/src/soa_builder/web/routers/epochs.py b/src/soa_builder/web/routers/epochs.py
index f65bba4..79ec9ed 100644
--- a/src/soa_builder/web/routers/epochs.py
+++ b/src/soa_builder/web/routers/epochs.py
@@ -1,4 +1,5 @@
 import json
+import logging
 import os
 import sqlite3
 from datetime import datetime, timezone
@@ -42,8 +43,14 @@ def _record_epoch_audit(
         )
         conn.commit()
         conn.close()
-    except Exception:
-        pass
+    except Exception as e:
+        logging.getLogger("soa_builder.epochs").exception(
+            "_record_epoch_audit failed soa_id=%s epoch_id=%s action=%s: %s",
+            soa_id,
+            epoch_id,
+            action,
+            e,
+        )
 
 
 @router.post("/soa/{soa_id}/epochs")
@@ -170,8 +177,13 @@ def update_epoch_metadata(soa_id: int, epoch_id: int, payload: EpochUpdate):
         tr = cur.fetchone()
         if before is not None:
             before["type"] = tr[0] if tr else None
-    except Exception:
-        pass
+    except Exception as e:
+        logging.getLogger("soa_builder.epochs").debug(
+            "update_epoch_metadata type fetch failed soa_id=%s epoch_id=%s: %s",
+            soa_id,
+            epoch_id,
+            e,
+        )
     sets = []
     vals = []
     if payload.name is not None:

From dd50c2968a6c4251e34aae21663ce780b5c13c5c Mon Sep 17 00:00:00 2001
From: Darren <3921919+pendingintent@users.noreply.github.com>
Date: Thu, 11 Dec 2025 13:43:28 -0500
Subject: [PATCH 32/32] Standardized loggers, prevent exception swallowing

---
 src/soa_builder/web/app.py                | 15 ++++++++
 src/soa_builder/web/routers/activities.py | 10 +++---
 src/soa_builder/web/routers/arms.py       |  3 +-
 src/soa_builder/web/routers/elements.py   | 19 ++++++----
 src/soa_builder/web/routers/epochs.py     |  5 +--
 src/soa_builder/web/routers/freezes.py    | 10 +++++-
 src/soa_builder/web/routers/rollback.py   | 44 ++++++++++++++---------
 src/soa_builder/web/routers/visits.py     |  2 ++
 8 files changed, 77 insertions(+), 31 deletions(-)

diff --git a/src/soa_builder/web/app.py b/src/soa_builder/web/app.py
index 443401a..9573e16 100644
--- a/src/soa_builder/web/app.py
+++ b/src/soa_builder/web/app.py
@@ -79,6 +79,21 @@
 # Audit functions
 from .audit import _record_element_audit
 
+
+def _configure_logging():
+    level = logging.INFO
+    if os.environ.get("SOA_BUILDER_DEBUG") == "1":
+        level = logging.DEBUG
+    logging.basicConfig(
+        level=level, format="%(asctime)s %(name)s %(levelname)s: %(message)s"
+    )
+    # Quiet noisy libraries if present
+    logging.getLogger("sqlalchemy").setLevel(logging.WARNING)
+    return logging.getLogger("soa_builder")
+
+
+logger = _configure_logging()
+
 load_dotenv()  # must come BEFORE reading env-based configuration so values are populated
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 NORMALIZED_ROOT = os.environ.get("SOA_BUILDER_NORMALIZED_ROOT", "normalized")
diff --git a/src/soa_builder/web/routers/activities.py b/src/soa_builder/web/routers/activities.py
index c75172c..afd795f 100644
--- a/src/soa_builder/web/routers/activities.py
+++ b/src/soa_builder/web/routers/activities.py
@@ -1,4 +1,5 @@
 import json
+import logging
 
 # Lightweight concept fetcher to avoid circular import with app.py
 import os
@@ -16,6 +17,9 @@
 _ACT_CONCEPT_CACHE = {"data": None, "fetched_at": 0}
 _ACT_CONCEPT_TTL = 60 * 60
 
+router = APIRouter(prefix="/soa/{soa_id}")
+logger = logging.getLogger("soa_builder.web.routers.activities")
+
 
 def fetch_biomedical_concepts(force: bool = False):
     override_json = os.environ.get("CDISC_CONCEPTS_JSON")
@@ -54,7 +58,8 @@ def fetch_biomedical_concepts(force: bool = False):
                 if code:
                     concepts.append({"code": code, "title": title})
             return concepts
-        except Exception:
+        except Exception as e:
+            logger.debug("fetch_biomedical_concepts override JSON parse failed: %s", e)
             return []
     now = time.time()
     if (
@@ -69,9 +74,6 @@ def fetch_biomedical_concepts(force: bool = False):
     return []
 
 
-router = APIRouter(prefix="/soa/{soa_id}")
-
-
 # Removed local _soa_exists; using shared utils.soa_exists
 
 
diff --git a/src/soa_builder/web/routers/arms.py b/src/soa_builder/web/routers/arms.py
index 975655a..53f2a7c 100644
--- a/src/soa_builder/web/routers/arms.py
+++ b/src/soa_builder/web/routers/arms.py
@@ -10,6 +10,7 @@
 from ..utils import soa_exists
 
 router = APIRouter(prefix="/soa/{soa_id}")
+logger = logging.getLogger("soa_builder.web.routers.arms")
 
 
 # Removed local _soa_exists; using shared utils.soa_exists
@@ -67,7 +68,7 @@ def create_arm(soa_id: int, payload: ArmCreate):
             if tail.isdigit():
                 used_nums.add(int(tail))
             else:
-                logging.getLogger("soa_builder.concepts").warning(
+                logger.warning(
                     "Invalid arm_uid format encountered (ignored for numbering): %s",
                     uid,
                 )
diff --git a/src/soa_builder/web/routers/elements.py b/src/soa_builder/web/routers/elements.py
index 467374d..2aecfcc 100644
--- a/src/soa_builder/web/routers/elements.py
+++ b/src/soa_builder/web/routers/elements.py
@@ -12,6 +12,7 @@
 from ..schemas import ElementCreate, ElementUpdate
 
 router = APIRouter(prefix="/soa/{soa_id}")
+logger = logging.getLogger("soa_builder.web.routers.elements")
 
 
 """Shared SOA existence check imported from utils.soa_exists"""
@@ -32,7 +33,7 @@ def _next_element_identifier(soa_id: int) -> str:
                 if tail.isdigit():
                     max_n = max(max_n, int(tail))
     except Exception as e:
-        logging.getLogger("soa_builder.elements").exception(
+        logger.exception(
             "_next_element_identifier scan elements failed for soa_id=%s: %s",
             soa_id,
             e,
@@ -49,7 +50,7 @@ def _next_element_identifier(soa_id: int) -> str:
                 try:
                     obj = json.loads(js)
                 except Exception as e:
-                    logging.getLogger("soa_builder.elements").debug(
+                    logger.debug(
                         "_next_element_identifier JSON parse failed soa_id=%s: %s",
                         soa_id,
                         e,
@@ -62,7 +63,7 @@ def _next_element_identifier(soa_id: int) -> str:
                         if tail.isdigit():
                             max_n = max(max_n, int(tail))
     except Exception as e:
-        logging.getLogger("soa_builder.elements").exception(
+        logger.exception(
             "_next_element_identifier scan element_audit failed for soa_id=%s: %s",
             soa_id,
             e,
@@ -89,7 +90,7 @@ def _get_element_uid(soa_id: int, row_id: int) -> Optional[str]:
         conn.close()
         return r[0] if r else None
     except Exception as e:
-        logging.getLogger("soa_builder.elements").exception(
+        logger.exception(
             "_get_element_uid failed for soa_id=%s row_id=%s: %s", soa_id, row_id, e
         )
         return None
@@ -165,11 +166,17 @@ def list_element_audit(soa_id: int):
     for r in cur.fetchall():
         try:
             before = json.loads(r[3]) if r[3] else None
-        except Exception:
+        except Exception as e:
+            logger.debug(
+                "list_element_audit before JSON parse failed soa_id=%s: %s", soa_id, e
+            )
             before = None
         try:
             after = json.loads(r[4]) if r[4] else None
-        except Exception:
+        except Exception as e:
+            logger.debug(
+                "list_element_audit after JSON parse failed soa_id=%s: %s", soa_id, e
+            )
             after = None
         rows.append(
             {
diff --git a/src/soa_builder/web/routers/epochs.py b/src/soa_builder/web/routers/epochs.py
index 79ec9ed..f77c562 100644
--- a/src/soa_builder/web/routers/epochs.py
+++ b/src/soa_builder/web/routers/epochs.py
@@ -14,6 +14,7 @@
 DB_PATH = os.environ.get("SOA_BUILDER_DB", "soa_builder_web.db")
 
 router = APIRouter()
+logger = logging.getLogger("soa_builder.web.routers.epochs")
 
 
 def _connect():
@@ -44,7 +45,7 @@ def _record_epoch_audit(
         conn.commit()
         conn.close()
     except Exception as e:
-        logging.getLogger("soa_builder.epochs").exception(
+        logger.exception(
             "_record_epoch_audit failed soa_id=%s epoch_id=%s action=%s: %s",
             soa_id,
             epoch_id,
@@ -178,7 +179,7 @@ def update_epoch_metadata(soa_id: int, epoch_id: int, payload: EpochUpdate):
         if before is not None:
             before["type"] = tr[0] if tr else None
     except Exception as e:
-        logging.getLogger("soa_builder.epochs").debug(
+        logger.debug(
             "update_epoch_metadata type fetch failed soa_id=%s epoch_id=%s: %s",
             soa_id,
             epoch_id,
diff --git a/src/soa_builder/web/routers/freezes.py b/src/soa_builder/web/routers/freezes.py
index 6cd327c..839738e 100644
--- a/src/soa_builder/web/routers/freezes.py
+++ b/src/soa_builder/web/routers/freezes.py
@@ -1,4 +1,5 @@
 import json
+import logging
 import os
 import sqlite3
 
@@ -12,6 +13,7 @@
 templates = Jinja2Templates(directory=TEMPLATES_DIR)
 
 router = APIRouter()
+logger = logging.getLogger("soa_builder.web.routers.freezes")
 
 
 def _connect():
@@ -61,7 +63,13 @@ def get_freeze(soa_id: int, freeze_id: int):
         raise HTTPException(404, "Freeze not found")
     try:
         data = json.loads(row[0])
-    except Exception:
+    except Exception as e:
+        logger.exception(
+            "get_freeze JSON decode failed soa_id=%s freeze_id=%s: %s",
+            soa_id,
+            freeze_id,
+            e,
+        )
         data = {"error": "Corrupt snapshot"}
     return JSONResponse(data)
 
diff --git a/src/soa_builder/web/routers/rollback.py b/src/soa_builder/web/routers/rollback.py
index f8c111b..01a3d50 100644
--- a/src/soa_builder/web/routers/rollback.py
+++ b/src/soa_builder/web/routers/rollback.py
@@ -1,5 +1,6 @@
 import io
 import os
+import logging
 
 import pandas as pd
 from fastapi import APIRouter, HTTPException, Request
@@ -13,6 +14,7 @@
 templates = Jinja2Templates(directory=TEMPLATES_DIR)
 
 router = APIRouter()
+logger = logging.getLogger("soa_builder.web.routers.rollback")
 
 
 # Removed local _soa_exists; using shared utils.soa_exists
@@ -104,23 +106,31 @@ def export_reorder_audit_xlsx(soa_id: int):
     rows = _list_reorder_audit(soa_id)
     flat = []
     for r in rows:
-        moves = []
-        old_pos = {vid: idx + 1 for idx, vid in enumerate(r.get("old_order", []))}
-        new_order = r.get("new_order", [])
-        for idx, vid in enumerate(new_order, start=1):
-            op = old_pos.get(vid)
-            if op and op != idx:
-                moves.append(f"{vid}:{op}->{idx}")
-        flat.append(
-            {
-                "id": r.get("id"),
-                "entity_type": r.get("entity_type"),
-                "performed_at": r.get("performed_at"),
-                "old_order": ",".join(map(str, r.get("old_order", []))),
-                "new_order": ",".join(map(str, new_order)),
-                "moves": "; ".join(moves) if moves else "",
-            }
-        )
+        try:
+            moves = []
+            old_pos = {vid: idx + 1 for idx, vid in enumerate(r.get("old_order", []))}
+            new_order = r.get("new_order", [])
+            for idx, vid in enumerate(new_order, start=1):
+                op = old_pos.get(vid)
+                if op and op != idx:
+                    moves.append(f"{vid}:{op}->{idx}")
+            flat.append(
+                {
+                    "id": r.get("id"),
+                    "entity_type": r.get("entity_type"),
+                    "performed_at": r.get("performed_at"),
+                    "old_order": ",".join(map(str, r.get("old_order", []))),
+                    "new_order": ",".join(map(str, new_order)),
+                    "moves": "; ".join(moves) if moves else "",
+                }
+            )
+        except Exception as e:
+            logger.debug(
+                "export_reorder_audit_xlsx flatten failure soa_id=%s row_id=%s: %s",
+                soa_id,
+                r.get("id"),
+                e,
+            )
     df = pd.DataFrame(flat)
     if df.empty:
         df = pd.DataFrame(
diff --git a/src/soa_builder/web/routers/visits.py b/src/soa_builder/web/routers/visits.py
index 5bcfbb4..dcfdf9d 100644
--- a/src/soa_builder/web/routers/visits.py
+++ b/src/soa_builder/web/routers/visits.py
@@ -1,6 +1,7 @@
 from typing import List
 
 from fastapi import APIRouter, HTTPException
+import logging
 from fastapi.responses import JSONResponse
 
 from ..audit import _record_reorder_audit, _record_visit_audit
@@ -9,6 +10,7 @@
 from ..schemas import VisitCreate, VisitUpdate
 
 router = APIRouter(prefix="/soa/{soa_id}")
+logger = logging.getLogger("soa_builder.web.routers.visits")
 
 
 # Removed local _soa_exists; using shared utils.soa_exists