update ecomm/0035/SESSION-0035.0-TRANSCRIPT-2026-06-12T02-07--INPROGRESS.md

ecomm/0035/SESSION-0035.0-TRANSCRIPT-2026-06-12T02-07--INPROGRESS.md

@@ -4,11 +4,9 @@
 > Start: 2026-06-12T02-07 (PST)
 > Type: planning-and-executing
 > Claude-Session: 2c8ed539-d087-409e-ad4d-effec7f8d6b3
-> Status: **PLACEHOLDER — claimed at session start; finalized at session end.**
+> Status: **FINALIZED.**
->
+> Posture: autonomous (yolo)
-> This file reserves session ID 0035 for ecomm. The driver replaces this
+> Outcome: SLICE-8 Shopify dialect SHIPPED to PPE — v0.8.0, PR #32, Feature #13 closed.
-> body with the full transcript and renames the file to its final
-> SESSION-0035.0-TRANSCRIPT-2026-06-12T02-07--<end>.md form at session end.
 
 ## Launch prompt
 
@@ -46,3 +44,90 @@ Ships (per SD-0002 §6.5.1 / §7.2):
 _Autonomous-mode low-confidence calls the driver made and would have
 liked operator input on. Appended as the session runs; surfaced at
 finalize. Empty if none._
+
+1. **Dialect detection by signature + canonical veto, not exact header set.** The
+   spec §7.4 mentions a possible `unknown_dialect` state; I implemented signature
+   detection (Shopify-only columns) with a **canonical-distinctive veto** instead
+   of a third dialect state. A file with any canonical-distinctive column
+   (`Description`/`Variant Cost`/`Variant Weight`/`Google Product Category`/…) is
+   canonical; ambiguous/hybrid headers fall through to canonical (warns, never
+   corrupts). Robust to Shopify's market-column variance. Adopted after an
+   adversarial review found the naive signature-only detection could misread a
+   canonical file carrying a stray signature name (e.g. `SEO Title`) and silently
+   corrupt (`Type` dropped, weight kg→g). No `unknown_dialect` state added.
+
+2. **`Variant Grams` → `Variant Weight` with unit forced to `g`.** Shopify's own
+   `Variant Weight Unit` display column is *not imported* (warned). Lossless in
+   mass (grams is exact). Weight + synthesized unit move together on clear. Revisit
+   if merchants need kg/lb display fidelity round-tripped.
+
+3. **DOC-2 served as raw Markdown** (`text/markdown`) at `/api/products/columns.md`,
+   mirroring how DOC-3 `sample.csv` is served — not a styled HTML page. Satisfies
+   "app-served, source in framework repo"; styled rendering is a future enhancement.
+
+## Notes / incidents
+
+- The adversarial-review **subagent ran `git checkout` and left the working tree on
+  `main`** mid-session (commits were safe on the feature branch). Recovered by
+  checking the branch back out. Worth a plugin-feedback note: review subagents
+  should not switch branches in the shared checkout (the §5.4 worktree hazard, here
+  caused by a *subagent* rather than a second session).
+- The repo `.venv` was **stale** at session start (missing Pillow + google-cloud-storage
+  from SLICE-7); re-synced from `backend/requirements.txt`.
+
+## Pre-state
+
+- On `main` @ 8ed9b25 (SLICE-7 merged, v0.7.0 live on PPE). Clean, pushed.
+- SD-0002 SLICE-5/6/7 delivered; SLICE-8 (Shopify dialect) the last slice, no new
+  Solution Design needed (it's part of the approved SD-0002). Anchor eligible R2a.
+- Stale `--INPROGRESS` placeholder SESSION-0027 noted (orphaned, predates shipped
+  0034) — not a live concurrent session; no worktree mandate triggered.
+
+## Session arc (turn-by-turn)
+
+1. **Init** — classified `/goal SLICE-8` as planning-and-executing; claimed session
+   0035; verified clean `main`; resolved app/content; eligibility gate ELIGIBLE
+   (R2a, anchored on SD-0002). Read SD-0002 §6.5.1 / §7.2 SLICE-8.
+2. **Map** — Explore agent mapped the existing import codec/pipeline/UI. Key find:
+   the `detect_dialect` seam, `unknown_columns` threading, and `dialectLabel` UI
+   helper already existed from SLICE-5 — SLICE-8 fills them in; the frontend
+   not-imported banner already renders. Bulk of work = backend detection + mapping.
+3. **Plan** — wrote `docs/superpowers/plans/2026-06-12-slice-8-shopify-dialect.md`
+   (writing-plans). Branch `slice-8-shopify-dialect`.
+4. **Execute (9 tasks, inline TDD)** — (1) `dialect_shopify` adapter; (2) wire into
+   `codec.parse_csv` (header rewrite at the INV-17 boundary + grams→weight-unit
+   synth); (3) exhaustive mapping fixture; (4) INV-10 over a partial Shopify import;
+   (5) frontend label + format-help links; (6) DOC-2 `columns.md` + route; (7) DOC-4
+   notes; (8) E2E `e2e_import_shopify_dialect`; (9) v0.8.0 bump + full gate.
+   Each task committed; e2e selector race fixed (asserted an unambiguous
+   not-imported column).
+5. **Adversarial review** — a review subagent found two real HIGH findings
+   (canonical-file misdetection → silent corruption; dual-named-column shadow).
+   Fixed with the **canonical-distinctive veto** + tightened grams synthesis
+   (commit a851d35); +4 tests. (The subagent also left the tree on `main` — see
+   incidents.) Re-ran full gate + E2E green.
+6. **Ship** — push → PR #32 → merge (e2d8b5c); tag v0.8.0; `flotilla-core deploy
+   ecomm` 9/9 green (deploys.id=45); PPE `/healthz` → 0.8.0, DOC-2 serving;
+   stamped `release/2026-06-12T02-41`; closed Feature #13.
+7. **Finalize** — archived the plan to content `plans/`; updated memory; published
+   this transcript.
+
+## Cut state
+
+- `main` @ e2d8b5c, **v0.8.0 LIVE on PPE** (https://ecomm-ppe.wiggleverse.org).
+  Tags `v0.8.0` + `release/2026-06-12T02-41` pushed. Feature #13 closed.
+- **SD-0002 fully delivered.** Local `main` synced + clean; feature branch deleted.
+- Gates green: `check.sh` (lint-imports + backend pytest + frontend build + 22
+  vitest) and `e2e.sh` **8/8**.
+- Not shipped to **prod** (prod doesn't exist yet — SLICE-4 prod stand-up, an
+  operator-gated flotilla gesture, closes Feature #1 and would let v0.5–0.8 ship).
+
+## Next-session prompt
+
+```
+/goal Brainstorm and write the Solution Design for Products list + read-only detail (wiggleverse/wiggleverse-ecomm#14, P1 feature under epic #12): list view with sort, search, and column selection (defined defaults) over the SD-0002 catalog, plus a read-only product detail view; reusable data-table-as-Common-Component is a non-binding solution note. type/feature → needs its SD before any plan (§4.3 R3); author section-by-section in wiggleverse-ecomm-content/specs/ (next is SD-0003), graduate at finalize.
+```
+
+Operator may instead prioritize the **SLICE-4 prod stand-up** (closes Feature #1,
+unblocks shipping v0.5–0.8 to prod), the **#23 rebrand SD**, or the **manual PPE
+image walk** (SLICE-7 GcsObjectStore first real exercise) — confirm at session open.