@@ -161,7 +161,7 @@ jobs:
                -o -name 'empty-state.mjs' -o -name 'listing-order.mjs' -o -name 'menu-categories.mjs' \
                -o -name 'not-found.mjs' -o -name 'pager.mjs' -o -name 'related-rule.mjs' \
                -o -name 'reveal-css.mjs' -o -name 'shop-design.mjs' -o -name 'source-index.mjs' \
-               -o -name 'lead-cards.mjs' -o -name 'article-head.mjs' -o -name 'cascade-slot.mjs' -o -name 'utility-body.mjs' -o -name 'owned-selectors.mjs' \
+               -o -name 'lead-cards.mjs' -o -name 'article-head.mjs' -o -name 'cascade-slot.mjs' -o -name 'utility-body.mjs' -o -name 'owned-selectors.mjs' -o -name 'part-band.mjs' -o -name 'selector-tree.mjs' \
                -o -name 'visual-edit.zip' -o -name 'THREAT-MODEL.md' \
                -o -name 'gotcha-classification.md' -o -type d -name templates \) -print)
           if [ -n "$found" ]; then
 
@@ -238,6 +238,23 @@ def fmt(v):
     return fmt(p.get("price", 0)), fmt(p.get("regular_price", 0))
 
 
+REVIEWS_SEL = "#reviews, #review_form, .woocommerce-Reviews"
+
+
+def html_reviews_verdict(shown_before, shown_after):
+    """'ok' when reviews work on the HTML theme's product page, else the GAP.
+
+    shown_before: the reviews section renders for the product as it is (a
+    design without reviews shows none until one exists — not a gap);
+    shown_after: an approved test review rendered (None = not exercised, no
+    wp-cli)."""
+    if shown_after is True:
+        return "ok"
+    if shown_after is None:
+        return "ok" if shown_before else "unverified"
+    return "an approved review is not shown on its product page"
+
+
 def enable_cod(run):
     """Turn cash on delivery on for the audit's order; returns what to restore.
 
@@ -488,13 +505,37 @@ def add_to_cart(p, row, expect_ok=True):
             gap("my-account did not render a login form", "my-account")
 
         anyrow = by["simple"] or by["variable"]
-        if anyrow:
+        reviews_on = wpcli("option get woocommerce_enable_reviews") if args.wp_cli else "yes"
+        if anyrow and reviews_on != "no":
+            # A design without reviews shows none until a product HAS one, so
+            # the check is that an approved review appears once it exists —
+            # and that a product without one shows exactly the design.
             page.goto(product_url(anyrow), wait_until="networkidle")
             page.wait_for_timeout(1200)
-            if "review" in page.inner_text("body").lower():
-                ok("a product page offers reviews", "reviews")
+            before = bool(page.query_selector(REVIEWS_SEL))
+            after = None
+            if args.wp_cli and anyrow.get("id"):
+                cid = wpcli(f"comment create --comment_post_ID={int(anyrow['id'])} --comment_type=review "
+                            "--comment_approved=1 --comment_author='Coverage Audit' "
+                            "--comment_author_email=audit@coverage.test "
+                            "--comment_content='Audit review: soft and warm.' --porcelain")
+                if cid:
+                    wpcli(f"comment meta add {int(cid)} rating 5")
+                    wpcli(f"eval 'wc_delete_product_transients({int(anyrow['id'])}); "
+                          f"WC_Comments::clear_transients({int(anyrow['id'])});'")
+                    page.goto(product_url(anyrow), wait_until="networkidle")
+                    page.wait_for_timeout(1200)
+                    box = page.query_selector(REVIEWS_SEL)
+                    after = bool(box) and "Audit review: soft and warm." in box.inner_text()
+                    wpcli(f"comment delete {int(cid)} --force")
+                    wpcli(f"eval 'WC_Comments::clear_transients({int(anyrow['id'])});'")
+            verdict = html_reviews_verdict(before, after)
+            if verdict == "ok":
+                ok("an approved review shows on its product page" if after else "a product page offers reviews", "reviews")
+            elif verdict == "unverified":
+                note("reviews: none render yet (the design has none) — pass --wp-cli to prove an approved one shows")
             else:
-                gap("reviews are enabled in Woo but rendered nowhere", "reviews")
+                gap(verdict, "reviews")
 
         page.goto(f"{BASE}/cart/", wait_until="networkidle")
         page.wait_for_timeout(2500)
@@ -610,6 +651,21 @@ def spec_frozen(specs, rows):
     return not all(squash(specs[0]) in own_text(r) for r in rows)
 
 
+def reviews_verdict(in_template, shown_before, shown_after):
+    """'ok' when reviews work on a product page, else the GAP text.
+
+    in_template: the product template places a reviews block (None = unknown,
+    no wp-cli); shown_before: reviews render with the product as it is;
+    shown_after: an approved test review rendered (None = not exercised)."""
+    if in_template is False:
+        return "reviews are enabled in Woo but the product template has no reviews block"
+    if shown_after is True or (shown_after is None and shown_before):
+        return "ok"
+    if shown_after is None:
+        return "reviews are enabled in Woo but rendered nowhere"
+    return "an approved review is not shown on its product page"
+
+
 def soldout_ids(row):
     """The product and every variation of it — what a basket line can carry."""
     return {row.get("id")} | {v.get("id") for v in row.get("variations") or [] if isinstance(v, dict)}
@@ -1098,16 +1154,36 @@ def click_add():
         else:
             gap("no published page renders the WooCommerce account form", "my-account")
 
+        # A block theme may show its reviews block only once a product has a
+        # review (a design without one stays as drawn), so "reviews work" is:
+        # enabled in WooCommerce, placed in the product template, and a real
+        # approved review rendered on the page (then deleted again).
         reviews_on = wpcli("option get woocommerce_enable_reviews") if args.wp_cli else "yes"
         if anyrow and reviews_on != "no":
+            REVIEWS = ("#reviews, .woocommerce-Reviews, .wp-block-woocommerce-product-reviews, "
+                       ".wp-block-woocommerce-product-details")
+            in_template = None
+            if args.wp_cli:
+                found = wpcli("eval \"$t = get_block_template(get_stylesheet() . '//single-product'); echo $t ? (int) (strpos($t->content, 'wp:woocommerce/product-reviews') !== false || strpos($t->content, 'wp:woocommerce/product-details') !== false) : 2;\"")
+                in_template = found == "1" if found in ("0", "1") else None
             go(anyrow["permalink"])
-            if page.query_selector("#reviews, #review_form, .woocommerce-Reviews, "
-                                   ".wp-block-woocommerce-product-reviews, "
-                                   ".wp-block-woocommerce-product-review-form, "
-                                   ".wp-block-woocommerce-product-details"):
-                ok("a product page offers reviews", "reviews")
+            before = page.query_selector(REVIEWS) is not None
+            after, review = None, None
+            if args.wp_cli:
+                marker = "Woo audit review " + str(anyrow["id"])
+                cid = wpcli(f"comment create --comment_post_ID={int(anyrow['id'])} --comment_type=review --comment_approved=1 "
+                            f"--comment_author=Audit --comment_author_email=audit@example.com --comment_content={shlex.quote(marker)} --porcelain")
+                if cid and cid.isdigit():
+                    cleanup.append(f"comment delete {cid} --force")
+                    go(anyrow["permalink"])
+                    block = page.query_selector(REVIEWS)
+                    after = bool(block and marker in (block.inner_text() or ""))
+                    wpcli(f"comment delete {cid} --force")
+            verdict = reviews_verdict(in_template, before, after)
+            if verdict == "ok":
+                ok("a product page offers reviews" + (" (rendered once a review exists)" if after and not before else ""), "reviews")
             else:
-                gap("reviews are enabled in Woo but rendered nowhere", "reviews")
+                gap(verdict, "reviews")
 
         if cart_url:
             go(cart_url, 2500)
 
@@ -36,6 +36,8 @@
 from pathlib import Path
 
 from playwright.sync_api import sync_playwright
+sys.path.insert(0, str(Path(__file__).resolve().parent / "lib"))
+from manifest_paths import input_dir_of, workspace_of  # noqa: E402
 
 ap = argparse.ArgumentParser()
 ap.add_argument("--manifest", required=True)
@@ -44,7 +46,7 @@
 args = ap.parse_args()
 
 MF = json.loads(Path(args.manifest).read_text())
-WS = Path(MF["workspace"]).resolve()
+WS = workspace_of(MF, args.manifest)
 DIST = Path(args.dist or (WS / "astro-project" / "dist")).resolve()
 OUT = Path(args.out or (WS / "chrome-at-rest")).resolve()
 OUT.mkdir(parents=True, exist_ok=True)
 
@@ -31,6 +31,7 @@
 import { readFileSync, writeFileSync, readdirSync, statSync, existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { entryKind, safePathUnderRoot } from './lib/safe-path.mjs';
+import { inputDirOf, workspaceOf } from './lib/manifest-paths.mjs';
 
 // A tag's attribute run may legitimately contain '>' inside a quoted value
 // (Tailwind: class="[&>svg]:size-3").
@@ -406,7 +407,7 @@ const groupKey = (markup, volatile, pageFile) => rootTargets(collapseClassWhites
  * per zone via findNavZone(); the region-wide call below is only for the
  * whole-region default when no zone is declared.
  */
-export function regionNavStates(rawVariants) {
+export function regionNavStates(rawVariants, children = new Map()) {
   // Per href, per class value, the SET OF PAGES that wear it — not a count.
   // An active/resting pair is one href appearing with two class values on
   // DIFFERENT pages: resting everywhere, active on the one page it points at.
@@ -452,6 +453,13 @@ export function regionNavStates(rawVariants) {
   // neither value, or both).
   const pageOf = (x) => String(x || '').split(/[?#]/)[0].replace(/^\.?\/+/, '')
     .replace(/(^|\/)index\.html?$/i, '$1').replace(/\.html?$/i, '').replace(/\/+$/, '');
+  // A page is a CHILD of a link's target when its address extends the
+  // target's (blog/an-article under blog), or when the caller names it as one
+  // — a blog whose articles sit beside the listing (journal-hook.html next to
+  // journal.html) is a section all the same, and only the manifest knows it.
+  const childPages = new Map([...children].map(([t, pages]) => [pageOf(t), new Set([...pages].map(pageOf))]));
+  const isChild = (pg, target) => !!target && (pageOf(pg).startsWith(`${target}/`)
+    || (childPages.get(target) || new Set()).has(pageOf(pg)));
   for (const [href, t] of tally) {
     if (t.size < 2) continue;
     const target = pageOf(href);
@@ -464,14 +472,32 @@ export function regionNavStates(rawVariants) {
     // Beyond the target and UNDER it (blog/an-article for blog): a value worn
     // on unrelated pages (a 404 styled differently) is a variant, not a
     // section, and must not switch the rule on.
-    if (worn.length === 1 && target && [...worn[0][1]].some((pg) => pageOf(pg).startsWith(`${target}/`))) section = true;
+    if (worn.length === 1 && target && [...worn[0][1]].some((pg) => isChild(pg, target))) section = true;
     const candidates = ranked.slice(1).filter(([, pages]) => disjoint(pages, restPages));
     if (!candidates.length) continue; // two links to one target, not a state pair
     rests.set(restValue, (rests.get(restValue) || 0) + restPages.size);
     for (const [value, pages] of candidates) {
       actives.set(value, (actives.get(value) || 0) + pages.size);
     }
   }
+  // The same section highlight, carried by `aria-current` instead of a class
+  // — `.nav-links a[aria-current="page"]::after` drawing the underline. The
+  // class vote above never sees it, and the runtime writes aria-current only
+  // on the link to the page being served, so a design that marked the
+  // listing's link on its articles lost that on every article. Switched on
+  // ONLY when the source did it: some link carries aria-current on a page
+  // that is its target's child. The value it carried there is kept, since a
+  // design may style "page" and "true" differently.
+  let ariaSection = '';
+  const ARIA = /\saria-current=(["'])([^"']*)\1/i;
+  for (const v of rawVariants) {
+    for (const m of v.markup.matchAll(LINK)) {
+      const aria = ARIA.exec(m[0]);
+      if (!aria || aria[2].toLowerCase() === 'false') continue;
+      const target = pageOf(fold(m[2], v.pages[0]));
+      if (v.pages.some((pg) => isChild(pg, target))) ariaSection = ariaSection || aria[2];
+    }
+  }
   const ranked = (m) => [...m.entries()].sort((a, b) => b[1] - a[1]);
   const top = (m) => (m.size ? ranked(m)[0][0] : '');
   // A menu with two LEVELS legitimately has one active/resting pair PER LEVEL
@@ -489,7 +515,7 @@ export function regionNavStates(rawVariants) {
   const restVocabularies = restRanked
     .filter(([, n]) => n >= (restRanked[0]?.[1] || 0) / 2)
     .map(([value, pages]) => ({ value, pages }));
-  return { active: top(actives), rest: top(rests), restVocabularies, section };
+  return { active: top(actives), rest: top(rests), restVocabularies, section, ariaSection };
 }
 
 /**
@@ -509,7 +535,7 @@ export function regionNavStates(rawVariants) {
 export function computeChromeGroups(MF, WS) {
   const astroReport = JSON.parse(readFileSync(join(WS, 'astro-report.json'), 'utf8'));
   const fragDir = join(WS, 'astro-project', 'src', 'fragments', 'chrome');
-  const VOL = volatileClasses(resolve(MF.input.dir));
+  const VOL = volatileClasses(inputDirOf(MF, join(WS, 'conversion-manifest.json')));
   const variants = astroReport.chromeVariants || [];
   const manifestPages = Array.isArray(MF.pages)
     ? new Set(MF.pages.map((page) => page.file))
@@ -583,7 +609,7 @@ const invokedDirectly = process.argv[1] && import.meta.url.endsWith(process.argv
 if (invokedDirectly && process.argv.some((a) => a.startsWith('--manifest='))) {
   const manifestPath = process.argv.find((a) => a.startsWith('--manifest=')).slice(11);
   const MF = JSON.parse(readFileSync(manifestPath, 'utf8'));
-  const WS = resolve(MF.workspace);
+  const WS = workspaceOf(MF, manifestPath);
   const { regions } = computeChromeGroups(MF, WS);
   // Markup stays out of the JSON — the capture step reads chrome from the
   // LIVE page, and make-theme imports this module directly. The JSON names
 
@@ -31,6 +31,8 @@
 
 from playwright.sync_api import sync_playwright
 from PIL import Image, ImageDraw
+sys.path.insert(0, str(Path(__file__).resolve().parent / "lib"))
+from manifest_paths import input_dir_of, workspace_of  # noqa: E402
 
 ap = argparse.ArgumentParser()
 ap.add_argument("--manifest", required=True)
@@ -44,7 +46,7 @@
 args = ap.parse_args()
 
 MF = json.loads(Path(args.manifest).read_text())
-WS = Path(MF["workspace"]).resolve()
+WS = workspace_of(MF, args.manifest)
 # A native Gutenberg (v2) manifest: WordPress routes come from each page's
 # kind and slug, not from its key; fragments are not pages.
 V2 = MF.get("schema") == "html2wp/2" or MF.get("target") == "gutenberg"
 
@@ -40,6 +40,8 @@
 
 sys.path.insert(0, str(Path(__file__).parent / "lib"))
 from collection_coverage import uncovered
+sys.path.insert(0, str(Path(__file__).resolve().parent / "lib"))
+from manifest_paths import input_dir_of, workspace_of  # noqa: E402
 
 ap = argparse.ArgumentParser()
 ap.add_argument("--manifest", required=True)
@@ -48,7 +50,7 @@
 
 MANIFEST = Path(args.manifest).resolve()
 MF = json.loads(MANIFEST.read_text())
-WS = Path(MF["workspace"]).resolve()
+WS = workspace_of(MF, MANIFEST)
 DIST = Path(args.dist or (WS / "astro-project" / "dist")).resolve()
 
 # From the function expression itself — playwright decides "expression or
 
@@ -70,7 +70,7 @@ MF="$WS/conversion-manifest.json"
 U="${U:-$WS/input-untouched}"
 [ -d "$U" ] || { echo "no untouched original at $U" >&2; exit 64; }
 if [ -z "$W" ]; then
-  W="$(python3 -c 'import json,sys; print(json.load(open(sys.argv[1]))["input"]["dir"])' "$MF")" \
+  W="$(python3 -c 'import json,sys; sys.path.insert(0, sys.argv[2]); from manifest_paths import input_dir_of; print(input_dir_of(json.load(open(sys.argv[1])), sys.argv[1]))' "$MF" "$(dirname "$0")/lib")" \
     || { echo "cannot read input.dir from $MF — pass --working" >&2; exit 64; }
 fi
 [ -d "$W" ] || { echo "no working copy at $W" >&2; exit 64; }