From 3dbb2e800177ffe6dfe373664c0f162efbf53f77 Mon Sep 17 00:00:00 2001
From: FragginWagon <greg.r.jacobs@gmail.com>
Date: Sun, 13 Sep 2026 17:39:11 -0400
Subject: [PATCH] fix: clarify listing review fields

---
 apps/web/src/components/molecules/ReviewListStep.vue | 4 ++++
 docs/IMPLEMENTATION-STATUS.md                        | 1 +
 2 files changed, 5 insertions(+)

diff --git a/apps/web/src/components/molecules/ReviewListStep.vue b/apps/web/src/components/molecules/ReviewListStep.vue
index 1a718aa..94c8dc3 100644
--- a/apps/web/src/components/molecules/ReviewListStep.vue
+++ b/apps/web/src/components/molecules/ReviewListStep.vue
@@ -22,6 +22,7 @@ defineEmits(['update:inventoryItemId', 'update:askingPrice', 'submit']);
       :value="inventoryItemId"
       class="fixture-input"
       required
+      aria-describedby="listing-inventory-help"
       @change="$emit('update:inventoryItemId', $event.target.value)"
     >
       <option value="" disabled>Select a physical copy</option>
@@ -29,6 +30,7 @@ defineEmits(['update:inventoryItemId', 'update:askingPrice', 'submit']);
         {{ item.id }} · {{ item.status }}
       </option>
     </select>
+    <p id="listing-inventory-help">Only an active physical copy can be selected for a new listing.</p>
     <label class="fixture-label" for="listing-price">Asking price (cents)</label>
     <input
       id="listing-price"
@@ -37,8 +39,10 @@ defineEmits(['update:inventoryItemId', 'update:askingPrice', 'submit']);
       type="number"
       min="1"
       required
+      aria-describedby="listing-price-help"
       @input="$emit('update:askingPrice', $event.target.value)"
     />
+    <p id="listing-price-help">Enter the asking price in whole cents. Publication also requires a completed image and condition.</p>
     <button class="button button--primary" type="submit" :disabled="isSaving">
       Create listing draft
     </button>
diff --git a/docs/IMPLEMENTATION-STATUS.md b/docs/IMPLEMENTATION-STATUS.md
index 9d91fb0..4eef24d 100644
--- a/docs/IMPLEMENTATION-STATUS.md
+++ b/docs/IMPLEMENTATION-STATUS.md
@@ -282,6 +282,7 @@ Remaining roadmap areas are approved external provider credentials/adapters, bro
 - Admin sale and acquisition amount fields now expose explicit units and optional-field guidance through associated help text.
 - Provider mapping fields now explain Product versus Search identifiers, and pricing values expose their cents unit through associated help text.
 - Product identity and physical-copy selectors now include associated guidance describing the catalog and copy-level choices.
+- Review/list controls now explain active-copy requirements, cents units, and publication prerequisites through associated help text.
 
 ## Local Commands