@qontinui/navigation 0.1.6 → 0.2.0

package/dist/index.cjs

@@ -244,7 +244,13 @@ 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"
@@ -259,12 +265,21 @@ var REVIEW_ITEMS = [
     productMode: "ai"
   },
   {
-    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"
   },
   {
@@ -276,6 +291,16 @@ var REVIEW_ITEMS = [
     color: "#F97316",
     platforms: ["runner"],
     productMode: "ai"
+  },
+  {
+    id: "helper-tasks",
+    label: "Helper Tasks",
+    icon: "MessageSquare",
+    description: "Helper Task Queue \u2014 emit human spot-check tasks, review helper verdicts, invite helpers",
+    route: "/review/helper-tasks",
+    color: "#10B981",
+    platforms: ["runner"],
+    productMode: "ai"
   }
 ];
 var REVIEW_GROUP = {

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 */
@@ -192,8 +211,10 @@ type NavigationAction = {
  * 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[];

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 */
@@ -192,8 +211,10 @@ type NavigationAction = {
  * 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[];

package/dist/index.js

@@ -154,7 +154,13 @@ 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"
@@ -169,12 +175,21 @@ var REVIEW_ITEMS = [
     productMode: "ai"
   },
   {
-    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"
   },
   {
@@ -186,6 +201,16 @@ var REVIEW_ITEMS = [
     color: "#F97316",
     platforms: ["runner"],
     productMode: "ai"
+  },
+  {
+    id: "helper-tasks",
+    label: "Helper Tasks",
+    icon: "MessageSquare",
+    description: "Helper Task Queue \u2014 emit human spot-check tasks, review helper verdicts, invite helpers",
+    route: "/review/helper-tasks",
+    color: "#10B981",
+    platforms: ["runner"],
+    productMode: "ai"
   }
 ];
 var REVIEW_GROUP = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/navigation",
-  "version": "0.1.6",
+  "version": "0.2.0",
   "description": "Shared navigation structure for Qontinui applications",
   "type": "module",
   "main": "dist/index.cjs",