@qontinui/navigation 0.2.0 → 0.3.1

package/dist/index.cjs

@@ -75,6 +75,7 @@ __export(index_exports, {
   isGroupExpanded: () => isGroupExpanded,
   isItemActive: () => isItemActive,
   isItemAvailable: () => isItemAvailable,
+  isItemDemoted: () => isItemDemoted,
   isItemExpanded: () => isItemExpanded,
   isSecondaryOpenFor: () => isSecondaryOpenFor,
   isValidIconName: () => isValidIconName,
@@ -97,7 +98,16 @@ var WORKSPACE_ITEMS = [
     description: "Visual automation dashboard",
     route: "/tools/visual-automation",
     color: "#10B981",
-    productMode: "visual"
+    productMode: "visual",
+    // Web-only: `/tools/visual-automation` is a Next.js route in qontinui-web.
+    // The runner has no tab for this id — it is in no `MainTabId` union member
+    // and `TabContent` has no case — so on the runner the item rendered and its
+    // click was REFUSED by the sidebar's id guard with a console error. Dead
+    // nav items are worse than absent ones: the user reads the refusal as the
+    // app being broken. (Latent since the item was added; surfaced when Visual
+    // mode became a deliberate opt-in and this became one of only four items
+    // in it.)
+    platforms: ["web"]
   },
   {
     id: "prompt-home",
@@ -106,7 +116,13 @@ var WORKSPACE_ITEMS = [
     description: "Tell the runner what to do in plain English",
     route: "/prompt-home",
     color: "#8B5CF6",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only demotion. On the runner this page COMPOSES a loop workflow
+    // (setup → verification → agentic → completion) from a prompt and hands it
+    // to the executor — it is the loop paradigm's front door, not the
+    // Terminal's, so it belongs behind the advanced disclosure there. On
+    // qontinui-web the same route is the app's landing page, so it stays.
+    hidden: ["runner"]
   },
   {
     id: "gui-automation",
@@ -115,7 +131,10 @@ var WORKSPACE_ITEMS = [
     description: "Run and schedule workflows",
     route: "/execute",
     color: "#10B981",
-    productMode: "visual"
+    productMode: "visual",
+    // Web demotes it (coord+sessions default); the runner reaches it through
+    // the Visual product mode, which is itself disclosure-gated there.
+    hidden: ["web"]
   },
   {
     id: "terminal",
@@ -134,7 +153,12 @@ var WORKSPACE_ITEMS = [
     description: "Monitor active executions",
     route: "/runs/active",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    // The loop-workflow cockpit: phase badge, iteration counter, GUI/Playwright
+    // widgets and the "did the fix work?" verification panel. A Terminal
+    // session watches itself in the Terminal, so this is advanced on both
+    // platforms (web already demoted it locally).
+    hidden: true
   },
   {
     id: "productivity",
@@ -167,7 +191,9 @@ var SESSION_ITEMS = [
     icon: "Zap",
     description: "Action execution log",
     route: "/runs/actions",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // GUI action log — only ever populated by a visual/loop workflow run.
+    hidden: true
   },
   {
     id: "run-image",
@@ -175,7 +201,8 @@ var SESSION_ITEMS = [
     icon: "Image",
     description: "Visual recognition results",
     route: "/runs/image-recognition",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    hidden: true
   },
   {
     id: "run-findings",
@@ -191,7 +218,9 @@ var SESSION_ITEMS = [
     icon: "FileSearch",
     description: "State exploration results",
     route: "/runs/state-exploration",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // State-machine exploration is a visual-GUI-automation artifact.
+    hidden: true
   },
   {
     id: "run-tests",
@@ -199,7 +228,9 @@ var SESSION_ITEMS = [
     icon: "TestTube",
     description: "Playwright test results",
     route: "/runs/test-results",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // Populated by the loop's verification phase, never by a chat session.
+    hidden: true
   },
   {
     id: "run-ai-output",
@@ -253,7 +284,12 @@ var REVIEW_ITEMS = [
     hasOwnPage: true,
     route: "/runs",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner keeps it: a Terminal/Claude session creates a `task_run`
+    // (`workflow_type: "chat"`), so this IS the runner's session history.
+    // qontinui-web demotes it — its sessions live in `coord.sessions` and
+    // produce no task_runs.
+    hidden: ["web"]
   },
   {
     id: "run-findings",
@@ -262,7 +298,8 @@ var REVIEW_ITEMS = [
     description: "Review findings and HITL questions across runs",
     route: "/runs/findings",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: ["web"]
   },
   {
     // Id is "observations" (NOT "memory"): it must match the runner's
@@ -457,9 +494,15 @@ var BUILD_ITEMS = [
     description: "Visual GUI automation \u2014 build state machines and inspect runs",
     route: "/vga",
     color: "var(--brand-secondary)",
-    // Visual GUI automation belongs to Visual mode, not AI Dev (removed from
-    // the AI Dev sidebar on both runner and web).
-    productMode: "visual"
+    // Visual GUI automation belongs to Visual mode, not AI Dev.
+    productMode: "visual",
+    // Web-only for the same reason as `visual-dashboard`: `/vga` is a
+    // qontinui-web route and the runner has no `vga` tab, so the item was a
+    // dead click there. `hidden: ["web"]` additionally keeps it out of web's
+    // coord+sessions default menu — so it now appears in exactly one place:
+    // web, in Visual mode, with the advanced disclosure on.
+    platforms: ["web"],
+    hidden: ["web"]
   },
   {
     id: "orchestration-loop",
@@ -660,7 +703,11 @@ var CONFIGURE_ITEMS = [
     icon: "Radio",
     description: "Workflow event bus, queue status, circuit breaker",
     hiddenInProd: true,
-    productMode: "ai"
+    productMode: "ai",
+    // Workflow event bus — a loop-workflow internal. Dev-only AND advanced, so
+    // the CONFIGURE group has no default-visible item left and the group header
+    // is dropped entirely by filterGroupsForPlatform.
+    hidden: true
   }
 ];
 var CONFIGURE_GROUP = {
@@ -1104,11 +1151,16 @@ function setShowHiddenItems(show) {
 function getShowHiddenItems() {
   return _showHiddenItems;
 }
+function isItemDemoted(item, platform) {
+  const demoted = item.hidden;
+  if (!demoted) return false;
+  return demoted === true || demoted.includes(platform);
+}
 function isItemAvailable(item, platform) {
   if (item.hiddenInProd && !isDevelopmentMode()) {
     return false;
   }
-  if (item.hidden && !_showHiddenItems) {
+  if (isItemDemoted(item, platform) && !_showHiddenItems) {
     return false;
   }
   if (_productMode && item.productMode && item.productMode !== "both" && item.productMode !== _productMode) {
@@ -1454,6 +1506,7 @@ function NavigationItemShell({
   isGroupExpanded,
   isItemActive,
   isItemAvailable,
+  isItemDemoted,
   isItemExpanded,
   isSecondaryOpenFor,
   isValidIconName,

package/dist/index.d.cts

@@ -65,10 +65,18 @@ interface NavigationItem {
      * sidebar until the user opts in via the "Show advanced automation features"
      * setting (wired through `setShowHiddenItems(true)`). The route/tab id is
      * still registered, so deep-links and programmatic tab-activation continue
-     * to resolve. Used to demote the workflow-authoring surfaces (workflow
-     * builder, DAG editor, orchestration loop, step builders) now that the
-     * Terminal is the primary entry point. */
-    hidden?: boolean;
+     * to resolve. Used to demote the verification-agentic loop-workflow surfaces
+     * (workflow builder, DAG editor, orchestration loop, step builders, the
+     * run/execution dashboards) now that the Terminal is the primary entry point.
+     *
+     * `true` demotes the item on EVERY platform. A platform list demotes it only
+     * on the named platforms — the runner and qontinui-web disagree about a
+     * handful of items (the runner's Home/prompt entry is advanced there but is
+     * still web's landing page; web's coord+sessions default drops runs/findings
+     * the runner keeps), and expressing that at the source beats each app
+     * carrying its own parallel demotion list that silently drifts.
+     */
+    hidden?: boolean | Platform[];
     /** Product mode visibility - "ai", "visual", or "both" (default: shown in all modes) */
     productMode?: "ai" | "visual" | "both";
     /** URL path for web routing (e.g., "/build/workflows") */
@@ -177,10 +185,12 @@ type NavigationAction = {
  *   - platform:    "runner" | "web" | both (default) — which app shows the item
  *   - productMode: "ai" | "visual" | "both" | undefined (default=both) — which product mode
  *   - hiddenInProd: true — dev-only items hidden in production
- *   - hidden: true — "advanced" surfaces (the workflow-authoring tools) kept
- *     out of the default sidebar until the user opts in via "Show advanced
- *     automation features" (setShowHiddenItems). Route/tab id stays registered,
- *     so deep-links (e.g. the Terminal "save as workflow" disclosure) resolve.
+ *   - hidden: true | Platform[] — "advanced" surfaces (the loop-workflow and
+ *     workflow-authoring tools) kept out of the default sidebar until the user
+ *     opts in via "Show advanced automation features" (setShowHiddenItems).
+ *     Route/tab id stays registered, so deep-links (e.g. the Terminal
+ *     "save as workflow" disclosure) resolve. A platform list demotes on only
+ *     those platforms — see `NavigationItem.hidden`.
  *
  * ---------------------------------------------------------------------------
  * Terminal-centric information architecture (2026-06).
@@ -203,9 +213,21 @@ type NavigationAction = {
  *     (Groups that end up with no visible items are dropped by
  *     filterGroupsForPlatform, so no bare group header renders.)
  *
+ * 2026-07 follow-up — the loop-workflow残り. The first pass demoted the
+ * BUILDERS but left the loop's RUNTIME surfaces in the default set: the
+ * natural-language Home prompt (which composes and launches a
+ * setup→verification→agentic→completion workflow), the Active dashboard
+ * (phase badge, iteration counter, "did the fix work?" verification widget),
+ * and the GUI/loop-specific run detail tabs (Actions, Image Recognition,
+ * State Explorer, Test Results). Those are the loop paradigm's cockpit, not
+ * the Terminal's, so they are demoted too. What stays under Runs is the set a
+ * Terminal session actually produces — chat sessions create `task_runs` with
+ * `workflow_type: "chat"`, so Summary / Findings / AI Output / Statistics /
+ * AI Data remain first-class.
+ *
  * The default (toggle OFF, AI Dev mode) is therefore the lean, Terminal-first
- * set: WORKSPACE (Home / Terminal / Active / Productivity), REVIEW (Runs /
- * Findings / Memory / Knowledge), and SYSTEM (Settings / Help). This mirrors
+ * set: WORKSPACE (Terminal / Productivity), REVIEW (Runs / Findings / Memory /
+ * Knowledge / Helper Tasks), and SYSTEM (Settings / Help). This mirrors
  * qontinui-web's coord+sessions-centric default menu.
  *
  * Both platforms share this structure; per-item `platforms`/`productMode`
@@ -320,6 +342,13 @@ declare function setShowHiddenItems(show: boolean): void;
  * Whether `hidden` items are currently shown.
  */
 declare function getShowHiddenItems(): boolean;
+/**
+ * Whether an item's `hidden` ("advanced") demotion applies on this platform.
+ *
+ * `hidden: true` demotes everywhere; `hidden: ["runner"]` demotes only on the
+ * runner. Absent/false is never demoted.
+ */
+declare function isItemDemoted(item: NavigationItem, platform: Platform): boolean;
 /**
  * Filter a navigation item based on platform.
  * Returns true if the item should be shown on the given platform.
@@ -498,4 +527,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };
+export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemDemoted, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };

package/dist/index.d.ts

@@ -65,10 +65,18 @@ interface NavigationItem {
      * sidebar until the user opts in via the "Show advanced automation features"
      * setting (wired through `setShowHiddenItems(true)`). The route/tab id is
      * still registered, so deep-links and programmatic tab-activation continue
-     * to resolve. Used to demote the workflow-authoring surfaces (workflow
-     * builder, DAG editor, orchestration loop, step builders) now that the
-     * Terminal is the primary entry point. */
-    hidden?: boolean;
+     * to resolve. Used to demote the verification-agentic loop-workflow surfaces
+     * (workflow builder, DAG editor, orchestration loop, step builders, the
+     * run/execution dashboards) now that the Terminal is the primary entry point.
+     *
+     * `true` demotes the item on EVERY platform. A platform list demotes it only
+     * on the named platforms — the runner and qontinui-web disagree about a
+     * handful of items (the runner's Home/prompt entry is advanced there but is
+     * still web's landing page; web's coord+sessions default drops runs/findings
+     * the runner keeps), and expressing that at the source beats each app
+     * carrying its own parallel demotion list that silently drifts.
+     */
+    hidden?: boolean | Platform[];
     /** Product mode visibility - "ai", "visual", or "both" (default: shown in all modes) */
     productMode?: "ai" | "visual" | "both";
     /** URL path for web routing (e.g., "/build/workflows") */
@@ -177,10 +185,12 @@ type NavigationAction = {
  *   - platform:    "runner" | "web" | both (default) — which app shows the item
  *   - productMode: "ai" | "visual" | "both" | undefined (default=both) — which product mode
  *   - hiddenInProd: true — dev-only items hidden in production
- *   - hidden: true — "advanced" surfaces (the workflow-authoring tools) kept
- *     out of the default sidebar until the user opts in via "Show advanced
- *     automation features" (setShowHiddenItems). Route/tab id stays registered,
- *     so deep-links (e.g. the Terminal "save as workflow" disclosure) resolve.
+ *   - hidden: true | Platform[] — "advanced" surfaces (the loop-workflow and
+ *     workflow-authoring tools) kept out of the default sidebar until the user
+ *     opts in via "Show advanced automation features" (setShowHiddenItems).
+ *     Route/tab id stays registered, so deep-links (e.g. the Terminal
+ *     "save as workflow" disclosure) resolve. A platform list demotes on only
+ *     those platforms — see `NavigationItem.hidden`.
  *
  * ---------------------------------------------------------------------------
  * Terminal-centric information architecture (2026-06).
@@ -203,9 +213,21 @@ type NavigationAction = {
  *     (Groups that end up with no visible items are dropped by
  *     filterGroupsForPlatform, so no bare group header renders.)
  *
+ * 2026-07 follow-up — the loop-workflow残り. The first pass demoted the
+ * BUILDERS but left the loop's RUNTIME surfaces in the default set: the
+ * natural-language Home prompt (which composes and launches a
+ * setup→verification→agentic→completion workflow), the Active dashboard
+ * (phase badge, iteration counter, "did the fix work?" verification widget),
+ * and the GUI/loop-specific run detail tabs (Actions, Image Recognition,
+ * State Explorer, Test Results). Those are the loop paradigm's cockpit, not
+ * the Terminal's, so they are demoted too. What stays under Runs is the set a
+ * Terminal session actually produces — chat sessions create `task_runs` with
+ * `workflow_type: "chat"`, so Summary / Findings / AI Output / Statistics /
+ * AI Data remain first-class.
+ *
  * The default (toggle OFF, AI Dev mode) is therefore the lean, Terminal-first
- * set: WORKSPACE (Home / Terminal / Active / Productivity), REVIEW (Runs /
- * Findings / Memory / Knowledge), and SYSTEM (Settings / Help). This mirrors
+ * set: WORKSPACE (Terminal / Productivity), REVIEW (Runs / Findings / Memory /
+ * Knowledge / Helper Tasks), and SYSTEM (Settings / Help). This mirrors
  * qontinui-web's coord+sessions-centric default menu.
  *
  * Both platforms share this structure; per-item `platforms`/`productMode`
@@ -320,6 +342,13 @@ declare function setShowHiddenItems(show: boolean): void;
  * Whether `hidden` items are currently shown.
  */
 declare function getShowHiddenItems(): boolean;
+/**
+ * Whether an item's `hidden` ("advanced") demotion applies on this platform.
+ *
+ * `hidden: true` demotes everywhere; `hidden: ["runner"]` demotes only on the
+ * runner. Absent/false is never demoted.
+ */
+declare function isItemDemoted(item: NavigationItem, platform: Platform): boolean;
 /**
  * Filter a navigation item based on platform.
  * Returns true if the item should be shown on the given platform.
@@ -498,4 +527,4 @@ interface NavigationItemShellProps {
  */
 declare function NavigationItemShell({ item, onActivate, children, }: NavigationItemShellProps): React.ReactElement;
 
-export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };
+export { AUTOMATE_GROUP, AUTOMATE_ITEMS, BUILD_GROUP, BUILD_ITEMS, CHILDREN_MAP, CONFIGURE_GROUP, CONFIGURE_ITEMS, DEV_GROUP, DEV_ITEMS, ICON_NAMES, INSIGHTS_GROUP, INSIGHTS_ITEMS, type IconName, NAVIGATION_GROUPS, type NavigationAction, type NavigationBadge, type NavigationGroup, type NavigationItem, type NavigationItemLike, NavigationItemShell, type NavigationItemShellProps, type NavigationState, type Platform, REVIEW_GROUP, REVIEW_ITEMS, RUNS_ITEMS, SESSION_ITEMS, SETTINGS_ITEMS, SPEND_GROUP, SPEND_ITEMS, STORAGE_KEYS, SYSTEM_GROUP, SYSTEM_ITEMS, type SecondarySidebarState, WORKSPACE_GROUP, WORKSPACE_ITEMS, createInitialState, deserializeState, filterGroupForPlatform, filterGroupsForPlatform, filterItemsForPlatform, findItemById, getAllItems, getChildrenForPlatform, getChildrenItems, getItemGroup, getNavigationGroups, getProductMode, getRunnerNavigation, getShowHiddenItems, getWebNavigation, isDevelopmentMode, isGroupExpanded, isItemActive, isItemAvailable, isItemDemoted, isItemExpanded, isSecondaryOpenFor, isValidIconName, navigationActions, navigationReducer, serializeState, setDevelopmentMode, setProductMode, setShowHiddenItems, useNavigationItem };

package/dist/index.js

@@ -7,7 +7,16 @@ var WORKSPACE_ITEMS = [
     description: "Visual automation dashboard",
     route: "/tools/visual-automation",
     color: "#10B981",
-    productMode: "visual"
+    productMode: "visual",
+    // Web-only: `/tools/visual-automation` is a Next.js route in qontinui-web.
+    // The runner has no tab for this id — it is in no `MainTabId` union member
+    // and `TabContent` has no case — so on the runner the item rendered and its
+    // click was REFUSED by the sidebar's id guard with a console error. Dead
+    // nav items are worse than absent ones: the user reads the refusal as the
+    // app being broken. (Latent since the item was added; surfaced when Visual
+    // mode became a deliberate opt-in and this became one of only four items
+    // in it.)
+    platforms: ["web"]
   },
   {
     id: "prompt-home",
@@ -16,7 +25,13 @@ var WORKSPACE_ITEMS = [
     description: "Tell the runner what to do in plain English",
     route: "/prompt-home",
     color: "#8B5CF6",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner-only demotion. On the runner this page COMPOSES a loop workflow
+    // (setup → verification → agentic → completion) from a prompt and hands it
+    // to the executor — it is the loop paradigm's front door, not the
+    // Terminal's, so it belongs behind the advanced disclosure there. On
+    // qontinui-web the same route is the app's landing page, so it stays.
+    hidden: ["runner"]
   },
   {
     id: "gui-automation",
@@ -25,7 +40,10 @@ var WORKSPACE_ITEMS = [
     description: "Run and schedule workflows",
     route: "/execute",
     color: "#10B981",
-    productMode: "visual"
+    productMode: "visual",
+    // Web demotes it (coord+sessions default); the runner reaches it through
+    // the Visual product mode, which is itself disclosure-gated there.
+    hidden: ["web"]
   },
   {
     id: "terminal",
@@ -44,7 +62,12 @@ var WORKSPACE_ITEMS = [
     description: "Monitor active executions",
     route: "/runs/active",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    // The loop-workflow cockpit: phase badge, iteration counter, GUI/Playwright
+    // widgets and the "did the fix work?" verification panel. A Terminal
+    // session watches itself in the Terminal, so this is advanced on both
+    // platforms (web already demoted it locally).
+    hidden: true
   },
   {
     id: "productivity",
@@ -77,7 +100,9 @@ var SESSION_ITEMS = [
     icon: "Zap",
     description: "Action execution log",
     route: "/runs/actions",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // GUI action log — only ever populated by a visual/loop workflow run.
+    hidden: true
   },
   {
     id: "run-image",
@@ -85,7 +110,8 @@ var SESSION_ITEMS = [
     icon: "Image",
     description: "Visual recognition results",
     route: "/runs/image-recognition",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    hidden: true
   },
   {
     id: "run-findings",
@@ -101,7 +127,9 @@ var SESSION_ITEMS = [
     icon: "FileSearch",
     description: "State exploration results",
     route: "/runs/state-exploration",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // State-machine exploration is a visual-GUI-automation artifact.
+    hidden: true
   },
   {
     id: "run-tests",
@@ -109,7 +137,9 @@ var SESSION_ITEMS = [
     icon: "TestTube",
     description: "Playwright test results",
     route: "/runs/test-results",
-    color: "#4A90D9"
+    color: "#4A90D9",
+    // Populated by the loop's verification phase, never by a chat session.
+    hidden: true
   },
   {
     id: "run-ai-output",
@@ -163,7 +193,12 @@ var REVIEW_ITEMS = [
     hasOwnPage: true,
     route: "/runs",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    // Runner keeps it: a Terminal/Claude session creates a `task_run`
+    // (`workflow_type: "chat"`), so this IS the runner's session history.
+    // qontinui-web demotes it — its sessions live in `coord.sessions` and
+    // produce no task_runs.
+    hidden: ["web"]
   },
   {
     id: "run-findings",
@@ -172,7 +207,8 @@ var REVIEW_ITEMS = [
     description: "Review findings and HITL questions across runs",
     route: "/runs/findings",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: ["web"]
   },
   {
     // Id is "observations" (NOT "memory"): it must match the runner's
@@ -367,9 +403,15 @@ var BUILD_ITEMS = [
     description: "Visual GUI automation \u2014 build state machines and inspect runs",
     route: "/vga",
     color: "var(--brand-secondary)",
-    // Visual GUI automation belongs to Visual mode, not AI Dev (removed from
-    // the AI Dev sidebar on both runner and web).
-    productMode: "visual"
+    // Visual GUI automation belongs to Visual mode, not AI Dev.
+    productMode: "visual",
+    // Web-only for the same reason as `visual-dashboard`: `/vga` is a
+    // qontinui-web route and the runner has no `vga` tab, so the item was a
+    // dead click there. `hidden: ["web"]` additionally keeps it out of web's
+    // coord+sessions default menu — so it now appears in exactly one place:
+    // web, in Visual mode, with the advanced disclosure on.
+    platforms: ["web"],
+    hidden: ["web"]
   },
   {
     id: "orchestration-loop",
@@ -570,7 +612,11 @@ var CONFIGURE_ITEMS = [
     icon: "Radio",
     description: "Workflow event bus, queue status, circuit breaker",
     hiddenInProd: true,
-    productMode: "ai"
+    productMode: "ai",
+    // Workflow event bus — a loop-workflow internal. Dev-only AND advanced, so
+    // the CONFIGURE group has no default-visible item left and the group header
+    // is dropped entirely by filterGroupsForPlatform.
+    hidden: true
   }
 ];
 var CONFIGURE_GROUP = {
@@ -1014,11 +1060,16 @@ function setShowHiddenItems(show) {
 function getShowHiddenItems() {
   return _showHiddenItems;
 }
+function isItemDemoted(item, platform) {
+  const demoted = item.hidden;
+  if (!demoted) return false;
+  return demoted === true || demoted.includes(platform);
+}
 function isItemAvailable(item, platform) {
   if (item.hiddenInProd && !isDevelopmentMode()) {
     return false;
   }
-  if (item.hidden && !_showHiddenItems) {
+  if (isItemDemoted(item, platform) && !_showHiddenItems) {
     return false;
   }
   if (_productMode && item.productMode && item.productMode !== "both" && item.productMode !== _productMode) {
@@ -1363,6 +1414,7 @@ export {
   isGroupExpanded,
   isItemActive,
   isItemAvailable,
+  isItemDemoted,
   isItemExpanded,
   isSecondaryOpenFor,
   isValidIconName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/navigation",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Shared navigation structure for Qontinui applications",
   "type": "module",
   "main": "dist/index.cjs",
@@ -13,6 +13,7 @@
     "build": "tsup src/index.ts --format cjs,esm --dts && node -e \"if(!require('fs').statSync('dist/index.d.ts').size)process.exit(1)\"",
     "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
     "typecheck": "tsc --noEmit",
+    "test": "vitest run",
     "lint": "eslint src/",
     "clean": "rm -rf dist",
     "prepublishOnly": "npm run build"
@@ -56,6 +57,7 @@
     "react": "^19.0.0",
     "tsup": "^8.0.1",
     "typescript": "^6.0.2",
-    "typescript-eslint": "^8.61.0"
+    "typescript-eslint": "^8.61.0",
+    "vitest": "^3.2.7"
   }
 }