muze: Gallery/Showcase tier on every archetype; layout routes on tier before confidence; main-tabs switch defaults ON

Leadership 2026-09-22: Gallery-grade Muze (declarative grammar, editable in
Muze Studio) may sit on prod main tabs; Showcase-grade programs (KPI card
boards, risk matrix, ridgelines, year-in-sales) only on the 4th tab beside
the table. All 16 shipped archetypes are Gallery grade; each now declares
tier=GALLERY, tier_of()/muze_tier() expose it, and _fill_showcase sends any
SHOWCASE-tier or untagged Muze tile to the 4th tab regardless of rating.

MUZE_ENGINE_MAIN_TABS: unset now means ON (the OFF default was the 'keep Muze
off prod' rule that leadership lifted); 'false' remains the emergency off.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

demoprep_app/liveboards/golden_layout.py

@@ -60,27 +60,25 @@ MUZE_SHOWCASE_MAX = 3  # boone 2026-09-03: 'a little more Muze'
 # The data-first Muze engine (Sept 10) on the exec/manager tabs is a PER-SPACE
 # switch, read from the environment at build time:
 #
-#   MUZE_ENGINE_MAIN_TABS=true    answers whose shape fits a high-confidence
-#                                 archetype are drawn as Muze on the main tabs
-#   unset / false                 the engine is skipped and the main tabs carry
-#                                 native charts exactly as prod has since
-#                                 2026-09-15; Muze appears only as the
-#                                 surplus-heatmap upgrade on the showcase tab
+#   unset / true                  answers whose shape fits a high-confidence
+#                                 GALLERY-tier archetype are drawn as Muze on
+#                                 the main tabs (the default)
+#   MUZE_ENGINE_MAIN_TABS=false   the engine is skipped and the main tabs carry
+#                                 native charts as prod did 2026-09-15..22;
+#                                 Muze appears only on the showcase tab
 #
-# OFF is the default on purpose. This used to be a module constant, flipped by
-# hand: True on test, False in the emergency prod build (boone 2026-09-15, a
-# stakeholder asked that one-day-old Muze stay off prod). A constant meant the
-# two Spaces could never run the same commit, so nothing else could ship to
-# prod without either carrying Muze along or forking the line. Now the same
-# build runs everywhere and the Space VARIABLE (not a secret) decides: set on
-# test-mcp, absent on prod (boone 2026-09-21, Agent Q review action item).
+# ON is the default since 2026-09-22: leadership approved Gallery-grade Muze on
+# prod main tabs (Showcase-grade stays on the 4th tab — see muze_archetypes
+# GALLERY/SHOWCASE). The switch is kept as the emergency off: the 2026-09-15
+# scare (a stakeholder asked that one-day-old Muze stay off prod) is exactly
+# when it earns its keep, and a Space VARIABLE flips it without a deploy.
 #
 # The state is never invisible: config_check reports it per Space, and every
 # build stamps muze_main_tabs_state() into its change list. An unreadable value
 # is refused, not guessed - a typo must not quietly turn Muze on in prod.
 MUZE_ENGINE_MAIN_TABS_VAR = "MUZE_ENGINE_MAIN_TABS"
-_FLAG_TRUE = ("1", "true", "on", "yes")
-_FLAG_FALSE = ("", "0", "false", "off", "no")
+_FLAG_TRUE = ("", "1", "true", "on", "yes")   # unset -> ON (default since 2026-09-22)
+_FLAG_FALSE = ("0", "false", "off", "no")
 
 
 def muze_main_tabs_enabled() -> bool:
@@ -99,7 +97,7 @@ def muze_main_tabs_state() -> str:
     """One line for change lists and config_check: the value AND where it came from."""
     raw = (os.getenv(MUZE_ENGINE_MAIN_TABS_VAR) or "").strip()
     if not raw:
-        return f"Muze on main tabs: OFF ({MUZE_ENGINE_MAIN_TABS_VAR} unset - default)"
+        return f"Muze on main tabs: ON ({MUZE_ENGINE_MAIN_TABS_VAR} unset - default)"
     return (f"Muze on main tabs: {'ON' if muze_main_tabs_enabled() else 'OFF'} "
             f"({MUZE_ENGINE_MAIN_TABS_VAR}={raw})")
 MUZE_SHOWCASE_MIN = 2  # if surplus yields fewer, upgrade the retained heatmap too
@@ -1132,11 +1130,15 @@ def _fill_showcase(
     # 1. Custom and exotic visuals — the reason this tab exists. A Muze tile the
     #    engine drew with HIGH confidence is a first-class chart and stays where
     #    its role put it; medium/low confidence and hand-made custom charts come here.
-    from demoprep_app.liveboards.muze_engine import muze_confidence
+    from demoprep_app.liveboards.muze_engine import muze_confidence, muze_tier
     #    No cap here: a medium/low Muze tile must NEVER stay on a main tab. Run
     #    0910_125157 put a medium lollipop on Tixr's exec tab because the 5th one
     #    overflowed the showcase target.
-    take(lambda v: _chart_type(v) in SHOWCASE_CHART_TYPES and muze_confidence(v) != "high",
+    #    Tier first (leadership 2026-09-22): SHOWCASE-grade Muze — and any Muze
+    #    tile without a recognised @archetype — goes here regardless of rating.
+    #    GALLERY-grade then routes on confidence as before.
+    take(lambda v: _chart_type(v) in SHOWCASE_CHART_TYPES
+         and (muze_tier(v) == "showcase" or muze_confidence(v) != "high"),
          10**6)
 
     # 2. Exactly one table.

demoprep_app/liveboards/muze_archetypes.py

@@ -37,6 +37,15 @@ from demoprep_app.liveboards.muze_templates import (
 
 HIGH, MEDIUM, LOW = "high", "medium", "low"
 
+# Two tiers of Muze, as ThoughtSpot itself publishes them (leadership 2026-09-22):
+#   GALLERY  — Muze Gallery grammar: rows/columns/color, one or two layers, a
+#              dozen lines an SE can edit in Muze Studio. Allowed on tabs 1-3.
+#   SHOWCASE — Showcase-grade programs (KPI card boards, risk matrix, ridgelines,
+#              "year in sales"): transforms, several canvases, custom DOM. Only
+#              ever on the 4th tab, next to the table and the experiments.
+# Every archetype declares its tier; the layout routes on it BEFORE confidence.
+GALLERY, SHOWCASE = "gallery", "showcase"
+
 # --------------------------------------------------------------------------- safety skeleton
 _PRELUDE = """\
 // @archetype __ARCHETYPE__
@@ -364,13 +373,13 @@ _STACKED_AREA = """\
 # slots: engine slot -> JS constant. Engine slots: measure, measure2, dim, dim2, date.
 ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "bar_ranking": {
-        "body": _BAR, "confidence": HIGH, "family": "Ranking",
+        "body": _BAR, "confidence": HIGH, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 15},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
     },
     "hbar_ranking": {
-        "body": _HBAR, "confidence": HIGH, "family": "Ranking",
+        "body": _HBAR, "confidence": HIGH, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 15},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
@@ -379,25 +388,25 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
         # MEDIUM (showcase) 2026-09-16: head size solved — Muze point `size.value`
         # is a fraction of the band (1/8/18/90 all saturated at ~100px on 09-10;
         # 0.3 measured ~35px on the scatter). 0.15 here; promote after a real render.
-        "body": _LOLLIPOP, "confidence": MEDIUM, "family": "Ranking",
+        "body": _LOLLIPOP, "confidence": MEDIUM, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 15},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
     },
     "stacked_bar": {
-        "body": _STACKED_BAR, "confidence": HIGH, "family": "Part of a Whole",
+        "body": _STACKED_BAR, "confidence": HIGH, "family": "Part of a Whole", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 2, "date": False},
         "max_card": {"dim": 12, "dim2": 6},
         "slots": {"dim": "D_FIELD", "dim2": "C_FIELD", "measure": "M_FIELD"},
     },
     "multi_line": {
-        "body": _MULTI_LINE, "confidence": HIGH, "family": "Trend Analysis",
+        "body": _MULTI_LINE, "confidence": HIGH, "family": "Trend Analysis", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": True},
         "max_card": {"dim": 6},
         "slots": {"date": "T_FIELD", "dim": "C_FIELD", "measure": "M_FIELD"},
     },
     "bullet": {
-        "body": _BULLET, "confidence": HIGH, "family": "Ranking",
+        "body": _BULLET, "confidence": HIGH, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 2, "dims": 1, "date": False, "target": True},
         "max_card": {"dim": 12},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD", "measure2": "T_FIELD"},
@@ -406,7 +415,7 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
         # MEDIUM on purpose: the surplus-heatmap upgrade uses it, and surplus
         # heatmaps belong on the showcase tab. The engine's two-dim fallback to it
         # therefore lands there too; stacked_bar (few colours) is the main-tab pick.
-        "body": None, "confidence": MEDIUM, "family": "Distribution",  # drawn by muze_templates
+        "body": None, "confidence": MEDIUM, "family": "Distribution", "tier": GALLERY,  # drawn by muze_templates
         "needs": {"measures": 1, "dims": 2, "date": False},
         "max_card": {"dim": 12, "dim2": 12},
         "slots": {"dim": "x", "dim2": "y", "measure": "measure"},
@@ -416,7 +425,7 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
         # category, no target) is what 15 native tiles on main tabs were on 2026-09-10.
         # HIGH: rendered and inspected 2026-09-10 (GridPuls "DR Capacity by Participant":
         # bars left axis, line right axis, compact ticks, both axes titled).
-        "body": _DUAL_AXIS, "confidence": HIGH, "family": "Multivariate",
+        "body": _DUAL_AXIS, "confidence": HIGH, "family": "Multivariate", "tier": GALLERY,
         "needs": {"measures": 2, "dims": 1, "date": False},
         "max_card": {"dim": 12},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD", "measure2": "M2_FIELD"},
@@ -424,7 +433,7 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "donut": {
         # HIGH 2026-09-16: Tixr "Tickets by Channel" (6 slices, legend bottom, all
         # labels visible). The engine only offers it for <=6 additive slices.
-        "body": _DONUT, "confidence": HIGH, "family": "Part of a Whole",
+        "body": _DONUT, "confidence": HIGH, "family": "Part of a Whole", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 6},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
@@ -435,7 +444,7 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "pareto": {
         # HIGH 2026-09-16: Tixr "Top 10 Clients by Revenue" — bars in rank order,
         # cumulative-share line on a % axis, compact ticks.
-        "body": _PARETO, "confidence": HIGH, "family": "Ranking",
+        "body": _PARETO, "confidence": HIGH, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 15},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
@@ -443,7 +452,7 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "polar_area": {
         # MEDIUM (showcase): the rose draws (True "Pipeline by Client Segment") but
         # small slices vanish — a showcase piece, not an executive read.
-        "body": _POLAR_AREA, "confidence": MEDIUM, "family": "Distribution",
+        "body": _POLAR_AREA, "confidence": MEDIUM, "family": "Distribution", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": False},
         "max_card": {"dim": 8},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD"},
@@ -451,20 +460,20 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "scatter": {
         # MEDIUM (showcase): renders (Tixr "Ticket & Fee Revenue by Vertical", size
         # 0.3) but four points is a sparse tile; earns main tabs once seen on more data.
-        "body": _SCATTER, "confidence": MEDIUM, "family": "Correlation",
+        "body": _SCATTER, "confidence": MEDIUM, "family": "Correlation", "tier": GALLERY,
         "needs": {"measures": 2, "dims": 1, "date": False},
         "max_card": {"dim": 15},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD", "measure2": "M2_FIELD"},
     },
     "bar_tick": {
-        "body": _BAR_TICK, "confidence": MEDIUM, "family": "Ranking",
+        "body": _BAR_TICK, "confidence": MEDIUM, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 2, "dims": 1, "date": False},
         "max_card": {"dim": 10},
         "slots": {"dim": "D_FIELD", "measure": "M_FIELD", "measure2": "M2_FIELD"},
     },
     "stacked_bar_100": {
         # HIGH 2026-09-16: Tixr "Tickets by Genre" x Region — 0-100% axis, legend bottom.
-        "body": _STACKED_BAR_100, "confidence": HIGH, "family": "Part of a Whole",
+        "body": _STACKED_BAR_100, "confidence": HIGH, "family": "Part of a Whole", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 2, "date": False},
         "max_card": {"dim": 12, "dim2": 6},
         "slots": {"dim": "D_FIELD", "dim2": "C_FIELD", "measure": "M_FIELD"},
@@ -472,14 +481,14 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
     "crosstab_bar": {
         # MEDIUM (showcase): clean trellis (Tixr "Revenue by Sales Channel" x Payment
         # Category) but tall; a third-width tile would cramp it.
-        "body": _CROSSTAB_BAR, "confidence": MEDIUM, "family": "Ranking",
+        "body": _CROSSTAB_BAR, "confidence": MEDIUM, "family": "Ranking", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 2, "date": False},
         "max_card": {"dim": 10, "dim2": 5},
         "slots": {"dim": "D_FIELD", "dim2": "C_FIELD", "measure": "M_FIELD"},
     },
     "stacked_area": {
         # HIGH 2026-09-16: True "Monthly Revenue by Service Line", 18 months, month ticks.
-        "body": _STACKED_AREA, "confidence": HIGH, "family": "Part of a Whole",
+        "body": _STACKED_AREA, "confidence": HIGH, "family": "Part of a Whole", "tier": GALLERY,
         "needs": {"measures": 1, "dims": 1, "date": True},
         "max_card": {"dim": 6},
         "slots": {"date": "T_FIELD", "dim": "C_FIELD", "measure": "M_FIELD"},
@@ -489,6 +498,12 @@ ARCHETYPES: Dict[str, Dict[str, Any]] = {
 TARGET_WORDS = ("target", "goal", "budget", "plan", "quota", "forecast", "benchmark")
 
 
+def tier_of(archetype: str) -> str:
+    """GALLERY or SHOWCASE; unknown archetypes are treated as SHOWCASE (kept off the main tabs)."""
+    spec = ARCHETYPES.get(archetype)
+    return spec.get("tier", SHOWCASE) if spec else SHOWCASE
+
+
 def confidence_of(archetype: str) -> str:
     return ARCHETYPES[archetype]["confidence"]
 

demoprep_app/liveboards/muze_engine.py

@@ -227,6 +227,17 @@ def convert_to_muze(viz: Dict[str, Any], archetype: str, bindings: Dict[str, str
     answer["display_mode"] = "CHART_MODE"
 
 
+def muze_tier(viz: Dict[str, Any]) -> Optional[str]:
+    """GALLERY / SHOWCASE for a MUZE_STUDIO viz, None if not Muze. Unknown or
+    hand-made Muze (no @archetype tag) is SHOWCASE: off the main tabs."""
+    chart = (viz.get("answer") or {}).get("chart") or {}
+    if chart.get("type") != MUZE_CHART_TYPE:
+        return None
+    from demoprep_app.liveboards.muze_archetypes import tier_of
+    name = archetype_of(chart)
+    return tier_of(name) if name else "showcase"
+
+
 def muze_confidence(viz: Dict[str, Any]) -> Optional[str]:
     """Confidence of the archetype that drew a MUZE_STUDIO viz, or None if not Muze."""
     name = archetype_of((viz.get("answer") or {}).get("chart") or {})

tests/test_muze_engine.py

@@ -210,3 +210,28 @@ def test_pareto_only_for_additive_measures():
     assert "pareto" not in picks
     total = _viz("V2", "Revenue by Provider", "[Revenue] [Provider Type]", ["Provider Type", "Total Revenue"])
     assert "pareto" in {choose_archetype(_shape(total, {"Provider Type": 8}), i)[0] for i in range(12)}
+
+
+def test_every_archetype_declares_a_tier_and_all_current_ones_are_gallery_grade():
+    from demoprep_app.liveboards.muze_archetypes import GALLERY, SHOWCASE, tier_of
+    for name, spec in ARCHETYPES.items():
+        assert spec.get("tier") in (GALLERY, SHOWCASE), name
+        assert tier_of(name) == GALLERY, f"{name}: every shipped archetype is Gallery grammar (leadership 2026-09-22)"
+    assert tier_of("something_new") == SHOWCASE  # unknown stays off the main tabs
+
+
+def test_showcase_tier_muze_always_routes_to_the_fourth_tab():
+    """A SHOWCASE-tier tile must leave the main tabs even if someone rates it HIGH."""
+    from demoprep_app.liveboards import muze_archetypes as MA
+    from demoprep_app.liveboards.golden_layout import _fill_showcase
+    viz = _viz("V1", "Revenue by Region", "[Revenue] [Region]", ["Region", "Total Revenue"])
+    convert_to_muze(viz, "bar_ranking", {"dim": "Region", "measure": "Total Revenue"})
+    saved = dict(MA.ARCHETYPES["bar_ranking"])
+    try:
+        MA.ARCHETYPES["bar_ranking"]["tier"] = MA.SHOWCASE          # pretend it is a program
+        MA.ARCHETYPES["bar_ranking"]["confidence"] = HIGH
+        buckets = {"breakdown": ["V1"], "ranking": [], "detail": [], "driver": [], "trend": [], "showcase": []}
+        _fill_showcase(buckets, [viz])
+        assert buckets["showcase"] == ["V1"] and buckets["breakdown"] == []
+    finally:
+        MA.ARCHETYPES["bar_ranking"] = saved

tests/test_muze_main_tabs_flag.py

@@ -5,7 +5,8 @@ Run: pytest tests/test_muze_main_tabs_flag.py -q --noconftest
 It used to be a module constant: True on test, False in the emergency prod
 build. That meant test and prod could never run the same commit, so nothing
 else could ship to prod without carrying Muze along. Now one build runs
-everywhere and the Space variable decides. OFF is the default, and the state is
+everywhere and the Space variable decides. ON is the default since 2026-09-22
+(leadership approved Gallery-grade Muze on prod main tabs), and the state is
 stamped into every build's change list so it is never invisible.
 """
 from __future__ import annotations
@@ -21,22 +22,23 @@ from demoprep_app.liveboards.golden_layout import (
 
 
 class TestReading:
-    @pytest.mark.parametrize("raw", ["true", "TRUE", " True ", "1", "on", "yes"])
+    @pytest.mark.parametrize("raw", ["true", "TRUE", " True ", "1", "on", "yes", "", "  "])  # blank = default = ON
     def test_true_spellings(self, monkeypatch, raw):
         monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, raw)
         assert muze_main_tabs_enabled() is True
 
-    @pytest.mark.parametrize("raw", ["false", "FALSE", "0", "off", "no", "", "  "])
+    @pytest.mark.parametrize("raw", ["false", "FALSE", "0", "off", "no"])
     def test_false_spellings(self, monkeypatch, raw):
         monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, raw)
         assert muze_main_tabs_enabled() is False
 
-    def test_unset_is_off_and_says_so(self, monkeypatch):
-        """Default OFF: an unconfigured Space (prod) never draws Muze on main tabs."""
+    def test_unset_is_on_and_says_so(self, monkeypatch):
+        """Default ON since 2026-09-22: an unconfigured Space draws Gallery-grade
+        Muze on the main tabs; only an explicit false switches it off."""
         monkeypatch.delenv(MUZE_ENGINE_MAIN_TABS_VAR, raising=False)
-        assert muze_main_tabs_enabled() is False
+        assert muze_main_tabs_enabled() is True
         state = muze_main_tabs_state()
-        assert "OFF" in state and "unset" in state
+        assert "ON" in state and "unset" in state
 
     def test_a_set_value_names_itself(self, monkeypatch):
         monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, "true")
@@ -84,7 +86,7 @@ class TestGate:
         return calls, changes
 
     def test_off_skips_the_engine_and_stamps_off(self, monkeypatch):
-        monkeypatch.delenv(MUZE_ENGINE_MAIN_TABS_VAR, raising=False)
+        monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, "false")
         calls, changes = self._run(monkeypatch)
         assert calls == []
         assert any(c.startswith("Muze on main tabs: OFF") for c in changes), changes
@@ -97,7 +99,7 @@ class TestGate:
 
     def test_the_same_code_flips_with_the_environment(self, monkeypatch):
         """One commit, two Spaces: only the variable differs."""
-        monkeypatch.delenv(MUZE_ENGINE_MAIN_TABS_VAR, raising=False)
+        monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, "false")
         off, _ = self._run(monkeypatch)
         monkeypatch.setenv(MUZE_ENGINE_MAIN_TABS_VAR, "true")
         on, _ = self._run(monkeypatch)