@qontinui/navigation 0.1.7 → 0.3.0

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,
@@ -106,7 +107,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 +122,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 +144,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 +182,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 +192,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 +209,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 +219,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",
@@ -244,10 +266,21 @@ var REVIEW_ITEMS = [
     icon: "History",
     description: "Browse and manage all runs",
     hasChildren: true,
+    // Runs is a parent WITH a page of its own (/runs — the run browser).
+    // `selectsFirstChild: false` alone means "expand only, activate nothing",
+    // which left the item inert: clicking Runs opened the flyout but never
+    // dispatched a tab change. It must activate its OWN id, not its first
+    // child's ("run-recap"), so `selectsFirstChild` cannot express this.
     selectsFirstChild: false,
+    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",
@@ -256,15 +289,25 @@ var REVIEW_ITEMS = [
     description: "Review findings and HITL questions across runs",
     route: "/runs/findings",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: ["web"]
   },
   {
-    id: "memory",
+    // Id is "observations" (NOT "memory"): it must match the runner's
+    // `MainTabId` union member / `TabContent` case that actually renders this
+    // page. The old "memory" id was in no consumer's tab union, so clicking
+    // the item activated a tab that did not exist.
+    id: "observations",
     label: "Memory",
     icon: "Brain",
     description: "Cross-session observation memory from past runs",
     route: "/observe/memory",
     color: "#8B5CF6",
+    // Runner-only: qontinui-web has no `observe/` route tree at all, so this
+    // item's route 404s there — and because qontinui-web derives its co-pilot
+    // page map from getWebNavigation(), an un-gated item also advertises that
+    // 404 as a navigable target to the planner. Gate it at the source.
+    platforms: ["runner"],
     productMode: "ai"
   },
   {
@@ -443,8 +486,11 @@ var BUILD_ITEMS = [
     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"
+    // the AI Dev sidebar on both runner and web). Web demotes it outright; on
+    // the runner it is reached through the Visual product mode, which is itself
+    // behind the "Show visual GUI automation" disclosure.
+    productMode: "visual",
+    hidden: ["web"]
   },
   {
     id: "orchestration-loop",
@@ -645,7 +691,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 = {
@@ -1089,11 +1139,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) {
@@ -1439,6 +1494,7 @@ function NavigationItemShell({
   isGroupExpanded,
   isItemActive,
   isItemAvailable,
+  isItemDemoted,
   isItemExpanded,
   isSecondaryOpenFor,
   isValidIconName,

package/dist/index.d.cts

@@ -30,6 +30,25 @@ interface NavigationItem {
     hasChildren?: boolean;
     /** If true, clicking this item selects its first child instead of itself */
     selectsFirstChild?: boolean;
+    /**
+     * If true, this item is a parent (`hasChildren: true`) that ALSO has a page
+     * of its own: clicking it must activate the item's own id (in addition to
+     * opening its children flyout/submenu), not just expand.
+     *
+     * This is the third case in the parent-click contract, and it exists because
+     * the other two cannot express it:
+     *   - `selectsFirstChild: true`  — activates the FIRST CHILD's id (e.g.
+     *     "settings" → "settings-account"). The parent has no page of its own.
+     *   - `selectsFirstChild: false` — activates NOTHING; the click only
+     *     expands. Correct for a pure container.
+     *   - `hasOwnPage: true`         — activates the PARENT's own id (e.g.
+     *     "runs" → the Runs page). Use when the parent is a real destination.
+     *
+     * Consumers implementing item-click MUST honour this: when a parent has
+     * `hasOwnPage`, dispatch the tab/route change for `item.id` itself.
+     * Ignored for items without children.
+     */
+    hasOwnPage?: boolean;
     /** Platform availability - if not set, available on all platforms */
     platforms?: Platform[];
     /** Badge count or status to show on this item */
@@ -46,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") */
@@ -158,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).
@@ -184,16 +213,30 @@ 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`
  * filters yield the right view for each (web has no Terminal; runner has no
  * Dashboard/Runners, etc.). qontinui-web additionally demotes a few items the
- * runner keeps (runs/active/findings/memory — task_run-scoped, not session-
- * scoped) via its own local list; those stay un-`hidden` here.
+ * runner keeps (runs/active/findings — task_run-scoped, not session-scoped)
+ * via its own local list; those stay un-`hidden` here. The observation-memory
+ * item is no longer among them: it is `platforms: ["runner"]` now, since web
+ * has no `observe/` route tree (its route 404s there).
  */
 
 declare const WORKSPACE_ITEMS: NavigationItem[];
@@ -299,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.
@@ -477,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

@@ -30,6 +30,25 @@ interface NavigationItem {
     hasChildren?: boolean;
     /** If true, clicking this item selects its first child instead of itself */
     selectsFirstChild?: boolean;
+    /**
+     * If true, this item is a parent (`hasChildren: true`) that ALSO has a page
+     * of its own: clicking it must activate the item's own id (in addition to
+     * opening its children flyout/submenu), not just expand.
+     *
+     * This is the third case in the parent-click contract, and it exists because
+     * the other two cannot express it:
+     *   - `selectsFirstChild: true`  — activates the FIRST CHILD's id (e.g.
+     *     "settings" → "settings-account"). The parent has no page of its own.
+     *   - `selectsFirstChild: false` — activates NOTHING; the click only
+     *     expands. Correct for a pure container.
+     *   - `hasOwnPage: true`         — activates the PARENT's own id (e.g.
+     *     "runs" → the Runs page). Use when the parent is a real destination.
+     *
+     * Consumers implementing item-click MUST honour this: when a parent has
+     * `hasOwnPage`, dispatch the tab/route change for `item.id` itself.
+     * Ignored for items without children.
+     */
+    hasOwnPage?: boolean;
     /** Platform availability - if not set, available on all platforms */
     platforms?: Platform[];
     /** Badge count or status to show on this item */
@@ -46,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") */
@@ -158,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).
@@ -184,16 +213,30 @@ 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`
  * filters yield the right view for each (web has no Terminal; runner has no
  * Dashboard/Runners, etc.). qontinui-web additionally demotes a few items the
- * runner keeps (runs/active/findings/memory — task_run-scoped, not session-
- * scoped) via its own local list; those stay un-`hidden` here.
+ * runner keeps (runs/active/findings — task_run-scoped, not session-scoped)
+ * via its own local list; those stay un-`hidden` here. The observation-memory
+ * item is no longer among them: it is `platforms: ["runner"]` now, since web
+ * has no `observe/` route tree (its route 404s there).
  */
 
 declare const WORKSPACE_ITEMS: NavigationItem[];
@@ -299,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.
@@ -477,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

@@ -16,7 +16,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 +31,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 +53,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 +91,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 +101,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 +118,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 +128,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",
@@ -154,10 +175,21 @@ var REVIEW_ITEMS = [
     icon: "History",
     description: "Browse and manage all runs",
     hasChildren: true,
+    // Runs is a parent WITH a page of its own (/runs — the run browser).
+    // `selectsFirstChild: false` alone means "expand only, activate nothing",
+    // which left the item inert: clicking Runs opened the flyout but never
+    // dispatched a tab change. It must activate its OWN id, not its first
+    // child's ("run-recap"), so `selectsFirstChild` cannot express this.
     selectsFirstChild: false,
+    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",
@@ -166,15 +198,25 @@ var REVIEW_ITEMS = [
     description: "Review findings and HITL questions across runs",
     route: "/runs/findings",
     color: "#4A90D9",
-    productMode: "ai"
+    productMode: "ai",
+    hidden: ["web"]
   },
   {
-    id: "memory",
+    // Id is "observations" (NOT "memory"): it must match the runner's
+    // `MainTabId` union member / `TabContent` case that actually renders this
+    // page. The old "memory" id was in no consumer's tab union, so clicking
+    // the item activated a tab that did not exist.
+    id: "observations",
     label: "Memory",
     icon: "Brain",
     description: "Cross-session observation memory from past runs",
     route: "/observe/memory",
     color: "#8B5CF6",
+    // Runner-only: qontinui-web has no `observe/` route tree at all, so this
+    // item's route 404s there — and because qontinui-web derives its co-pilot
+    // page map from getWebNavigation(), an un-gated item also advertises that
+    // 404 as a navigable target to the planner. Gate it at the source.
+    platforms: ["runner"],
     productMode: "ai"
   },
   {
@@ -353,8 +395,11 @@ var BUILD_ITEMS = [
     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"
+    // the AI Dev sidebar on both runner and web). Web demotes it outright; on
+    // the runner it is reached through the Visual product mode, which is itself
+    // behind the "Show visual GUI automation" disclosure.
+    productMode: "visual",
+    hidden: ["web"]
   },
   {
     id: "orchestration-loop",
@@ -555,7 +600,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 = {
@@ -999,11 +1048,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) {
@@ -1348,6 +1402,7 @@ export {
   isGroupExpanded,
   isItemActive,
   isItemAvailable,
+  isItemDemoted,
   isItemExpanded,
   isSecondaryOpenFor,
   isValidIconName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/navigation",
-  "version": "0.1.7",
+  "version": "0.3.0",
   "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"
   }
 }