From 61c88f5abb7f78a0eb8cbc77c3a12b9e578ff027 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Fri, 23 Jan 2026 11:27:53 -0500
Subject: [PATCH 01/11] add activatable status indicator

---
 packages/client/src/clients/guide/client.ts   |  7 +++++
 packages/client/src/clients/guide/index.ts    |  6 +++-
 .../guide/components/Toolbar/V2/GuideRow.tsx  | 31 +++++++++++++++++--
 .../Toolbar/V2/GuidesListDisplaySelect.tsx    |  8 ++---
 .../guide/components/Toolbar/V2/V2.tsx        |  7 +++--
 .../Toolbar/V2/useInspectGuideClientStore.ts  | 22 +++++++++++--
 6 files changed, 68 insertions(+), 13 deletions(-)

diff --git a/packages/client/src/clients/guide/client.ts b/packages/client/src/clients/guide/client.ts
index 742c073d8..e458b3d8c 100644
--- a/packages/client/src/clients/guide/client.ts
+++ b/packages/client/src/clients/guide/client.ts
@@ -217,6 +217,13 @@ const predicate = (
     return false;
   }
 
+  return checkActivatable(guide, location);
+};
+
+export const checkActivatable = (
+  guide: KnockGuide,
+  location: string | undefined,
+) => {
   const url = location ? newUrl(location) : undefined;
 
   const urlRules = guide.activation_url_rules || [];
diff --git a/packages/client/src/clients/guide/index.ts b/packages/client/src/clients/guide/index.ts
index ddcb5e288..7d5519160 100644
--- a/packages/client/src/clients/guide/index.ts
+++ b/packages/client/src/clients/guide/index.ts
@@ -1,4 +1,8 @@
-export { KnockGuideClient, DEBUG_QUERY_PARAMS } from "./client";
+export {
+  KnockGuideClient,
+  DEBUG_QUERY_PARAMS,
+  checkActivatable,
+} from "./client";
 export type {
   KnockGuide,
   KnockGuideStep,
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index bc029e2c0..ac5c88600 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -1,9 +1,15 @@
 import { Button } from "@telegraph/button";
-import { Stack } from "@telegraph/layout";
+import { Box, Stack } from "@telegraph/layout";
 import { Tag } from "@telegraph/tag";
 import { Tooltip } from "@telegraph/tooltip";
 import { Text } from "@telegraph/typography";
-import { CheckCircle2, CircleDashed, Eye, UserCircle2 } from "lucide-react";
+import {
+  CheckCircle2,
+  CircleDashed,
+  Eye,
+  LocateFixed,
+  UserCircle2,
+} from "lucide-react";
 import * as React from "react";
 
 import { GuideHoverCard } from "./GuideHoverCard";
@@ -43,6 +49,27 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
       </Stack>
 
       <Stack justify="flex-end">
+        {guide.__typename === "Guide" && (
+          <Stack gap="1">
+            <Tooltip
+              label="Current location does not match the activation conditions"
+              enabled={!guide.inspection.activatable.status}
+            >
+              <Button
+                px="1"
+                size="1"
+                variant="soft"
+                color={guide.inspection.activatable.status ? "green" : "red"}
+                leadingIcon={{ icon: LocateFixed, alt: "Target" }}
+              />
+            </Tooltip>
+          </Stack>
+        )}
+        {guide.__typename === "Guide" && (
+          <Stack px="1" align="center">
+            <Box h="3" borderLeft="px" borderColor="gray-6" />
+          </Stack>
+        )}
         <Stack gap="1">
           {!isUnknownGuide(guide) && (
             <>
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuidesListDisplaySelect.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuidesListDisplaySelect.tsx
index 5c3941261..2b7c51324 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuidesListDisplaySelect.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuidesListDisplaySelect.tsx
@@ -22,11 +22,9 @@ export const GuidesListDisplaySelect = ({ value, onChange }: Props) => {
         style: { zIndex: TOOLBAR_Z_INDEX },
       }}
     >
-      {/* NOTE: Commented out until we can show relevant indicators for this opt
-        <Select.Option size="1" value="current-page">
-          Displayable on current page
-        </Select.Option>
-      */}
+      <Select.Option size="1" value="current-page">
+        Displayable on current page
+      </Select.Option>
       <Select.Option size="1" value="all-eligible">
         All eligible guides for user
       </Select.Option>
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
index eef46369c..2bb872e65 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
@@ -16,6 +16,7 @@ import {
 import { detectToolbarParam } from "./helpers";
 import {
   InspectionResult,
+  checkUsable,
   useInspectGuideClientStore,
 } from "./useInspectGuideClientStore";
 
@@ -27,10 +28,12 @@ const GuidesList = ({
   displayOption: DisplayOption;
 }) => {
   return guides.map((guide, idx) => {
+    if (displayOption === "current-page" && !checkUsable(guide)) {
+      return null;
+    }
     if (displayOption === "all-eligible" && !guide.annotation.isEligible) {
       return null;
     }
-
     return <GuideRow key={guide.key} guide={guide} orderIndex={idx} />;
   });
 };
@@ -39,7 +42,7 @@ export const V2 = () => {
   const { client } = useGuideContext();
 
   const [guidesListDisplayOption, setGuidesListDisplayOption] =
-    React.useState<DisplayOption>("all-eligible");
+    React.useState<DisplayOption>("current-page");
 
   const [isVisible, setIsVisible] = React.useState(detectToolbarParam());
   const [isCollapsed, setIsCollapsed] = React.useState(true);
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index 1857297dd..fdfc6154b 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -2,6 +2,7 @@ import {
   KnockGuide,
   KnockGuideClientStoreState,
   KnockGuideIneligibilityMarker,
+  checkActivatable,
 } from "@knocklabs/client";
 import { useGuideContext, useStore } from "@knocklabs/react-core";
 
@@ -28,6 +29,10 @@ type TargetableStatusFalse = {
 };
 type TargetableStatus = TargetableStatusTrue | TargetableStatusFalse;
 
+type ActivatableStatus = {
+  status: boolean;
+};
+
 // Archived: `false` status = good
 type ArchivedStatus = {
   status: boolean;
@@ -38,6 +43,7 @@ type AnnotatedStatuses = {
   active: ActiveStatus;
   targetable: TargetableStatus;
   archived: ArchivedStatus;
+  activatable: ActivatableStatus;
 };
 
 type GuideAnnotation = AnnotatedStatuses & {
@@ -54,6 +60,14 @@ export type AnnotatedGuide = KnockGuide & {
   priority?: number;
 };
 
+export const checkUsable = (guide: AnnotatedGuide | MissingGuide) => {
+  if (guide.__typename === "MissingGuide") return false;
+  if (!checkEligible(guide)) return false;
+  if (!guide.annotation.activatable.status) return false;
+
+  return true;
+};
+
 // Exists and ordered in control but absent in switchboard (therefore not
 // included in the api response), which implies a newly created guide that has
 // never been published to switchboard.
@@ -118,14 +132,14 @@ const resolveIsEligible = ({
 
 type StoreStateSnapshot = Pick<
   KnockGuideClientStoreState,
-  "guides" | "guideGroups" | "ineligibleGuides" | "debug"
+  "location" | "guides" | "guideGroups" | "ineligibleGuides" | "debug"
 >;
 
 const annotateGuide = (
   guide: KnockGuide,
   snapshot: StoreStateSnapshot,
 ): AnnotatedGuide => {
-  const { ineligibleGuides } = snapshot;
+  const { ineligibleGuides, location } = snapshot;
   const marker = ineligibleGuides[guide.key];
   const ineligiblity = marker ? toIneligibilityStatus(marker) : undefined;
 
@@ -133,6 +147,7 @@ const annotateGuide = (
     active: ineligiblity?.active || { status: true },
     targetable: ineligiblity?.targetable || { status: true },
     archived: ineligiblity?.archived || { status: false },
+    activatable: { status: checkActivatable(guide, location) },
   };
 
   const annotation: GuideAnnotation = {
@@ -161,8 +176,9 @@ export const useInspectGuideClientStore = (): InspectionResult | undefined => {
   const { client } = useGuideContext();
 
   // Extract a snapshot of the client store state for debugging.
-  const snapshot = useStore(client.store, (state) => {
+  const snapshot: StoreStateSnapshot = useStore(client.store, (state) => {
     return {
+      location: state.location,
       guides: state.guides,
       guideGroups: state.guideGroups,
       ineligibleGuides: state.ineligibleGuides,

From 35be601c758c243f1afde375f73d0d7b4b891318 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Wed, 11 Feb 2026 15:57:56 -0500
Subject: [PATCH 02/11] clean up naming and such

---
 .../guide/components/Toolbar/V2/V2.tsx        |  7 ++++--
 .../Toolbar/V2/useInspectGuideClientStore.ts  | 23 ++++++++++++-------
 2 files changed, 20 insertions(+), 10 deletions(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
index 2bb872e65..60a9a7789 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
@@ -16,7 +16,6 @@ import {
 import { detectToolbarParam } from "./helpers";
 import {
   InspectionResult,
-  checkUsable,
   useInspectGuideClientStore,
 } from "./useInspectGuideClientStore";
 
@@ -28,7 +27,11 @@ const GuidesList = ({
   displayOption: DisplayOption;
 }) => {
   return guides.map((guide, idx) => {
-    if (displayOption === "current-page" && !checkUsable(guide)) {
+    if (
+      displayOption === "current-page" &&
+      !guide.annotation.isEligible &&
+      !guide.annotation.isQualified
+    ) {
       return null;
     }
     if (displayOption === "all-eligible" && !guide.annotation.isEligible) {
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index fdfc6154b..6abbf3bca 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -43,6 +43,7 @@ type AnnotatedStatuses = {
   active: ActiveStatus;
   targetable: TargetableStatus;
   archived: ArchivedStatus;
+  // Individual qualified statuses:
   activatable: ActivatableStatus;
 };
 
@@ -50,6 +51,10 @@ type GuideAnnotation = AnnotatedStatuses & {
   // Resolved eligibility based on active, targetable and archived statuses,
   // which are backend driven evaluation results that are exposed for debugging.
   isEligible: boolean;
+
+  // Resolved display qualification based on an activatable status, which
+  // informs "when" and "where" an eligible guide can be displayed to user.
+  isQualified: boolean;
 };
 
 export type AnnotatedGuide = KnockGuide & {
@@ -60,14 +65,6 @@ export type AnnotatedGuide = KnockGuide & {
   priority?: number;
 };
 
-export const checkUsable = (guide: AnnotatedGuide | MissingGuide) => {
-  if (guide.__typename === "MissingGuide") return false;
-  if (!checkEligible(guide)) return false;
-  if (!guide.annotation.activatable.status) return false;
-
-  return true;
-};
-
 // Exists and ordered in control but absent in switchboard (therefore not
 // included in the api response), which implies a newly created guide that has
 // never been published to switchboard.
@@ -78,6 +75,7 @@ export type UnknownGuide = {
   bypass_global_group_limit: false;
   annotation: {
     isEligible: false;
+    isQualified: false;
   };
 };
 
@@ -130,6 +128,11 @@ const resolveIsEligible = ({
   return true;
 };
 
+export const resolveIsQualified = ({ activatable }: AnnotatedStatuses) => {
+  if (!activatable.status) return false;
+  return true;
+};
+
 type StoreStateSnapshot = Pick<
   KnockGuideClientStoreState,
   "location" | "guides" | "guideGroups" | "ineligibleGuides" | "debug"
@@ -144,15 +147,18 @@ const annotateGuide = (
   const ineligiblity = marker ? toIneligibilityStatus(marker) : undefined;
 
   const statuses: AnnotatedStatuses = {
+    // isEligible:
     active: ineligiblity?.active || { status: true },
     targetable: ineligiblity?.targetable || { status: true },
     archived: ineligiblity?.archived || { status: false },
+    // isQualified:
     activatable: { status: checkActivatable(guide, location) },
   };
 
   const annotation: GuideAnnotation = {
     ...statuses,
     isEligible: resolveIsEligible(statuses),
+    isQualified: resolveIsQualified(statuses),
   };
 
   return {
@@ -169,6 +175,7 @@ const newUnknownGuide = (key: KnockGuide["key"]) =>
     bypass_global_group_limit: false,
     annotation: {
       isEligible: false,
+      isQualified: false,
     },
   }) as UnknownGuide;
 

From c04d66d4defa69bd6d2111d9567c82ecfe6bb86f Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Wed, 11 Feb 2026 21:48:56 -0500
Subject: [PATCH 03/11] fix

---
 .../src/modules/guide/components/Toolbar/V2/GuideRow.tsx  | 8 ++++----
 .../react/src/modules/guide/components/Toolbar/V2/V2.tsx  | 3 +--
 2 files changed, 5 insertions(+), 6 deletions(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index ac5c88600..798b21e01 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -49,23 +49,23 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
       </Stack>
 
       <Stack justify="flex-end">
-        {guide.__typename === "Guide" && (
+        {!isUnknownGuide(guide) && (
           <Stack gap="1">
             <Tooltip
               label="Current location does not match the activation conditions"
-              enabled={!guide.inspection.activatable.status}
+              enabled={!guide.annotation.activatable.status}
             >
               <Button
                 px="1"
                 size="1"
                 variant="soft"
-                color={guide.inspection.activatable.status ? "green" : "red"}
+                color={guide.annotation.activatable.status ? "green" : "red"}
                 leadingIcon={{ icon: LocateFixed, alt: "Target" }}
               />
             </Tooltip>
           </Stack>
         )}
-        {guide.__typename === "Guide" && (
+        {!isUnknownGuide(guide) && (
           <Stack px="1" align="center">
             <Box h="3" borderLeft="px" borderColor="gray-6" />
           </Stack>
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
index 60a9a7789..9f61f1a3b 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
@@ -29,8 +29,7 @@ const GuidesList = ({
   return guides.map((guide, idx) => {
     if (
       displayOption === "current-page" &&
-      !guide.annotation.isEligible &&
-      !guide.annotation.isQualified
+      (!guide.annotation.isEligible || !guide.annotation.isQualified)
     ) {
       return null;
     }

From 5b41e64d690883a15c1ba86c5ef0924768ad1892 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Thu, 12 Feb 2026 15:49:05 -0500
Subject: [PATCH 04/11] more update

---
 .../src/modules/guide/components/Toolbar/V2/GuideRow.tsx   | 7 +++++--
 .../react/src/modules/guide/components/Toolbar/V2/V2.tsx   | 1 +
 .../components/Toolbar/V2/useInspectGuideClientStore.ts    | 2 +-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index 798b21e01..5155a9310 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -52,8 +52,11 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
         {!isUnknownGuide(guide) && (
           <Stack gap="1">
             <Tooltip
-              label="Current location does not match the activation conditions"
-              enabled={!guide.annotation.activatable.status}
+              label={
+                guide.annotation.activatable.status
+                  ? "This guide can be activated in the current location"
+                  : "This guide cannot be activated in the current location"
+              }
             >
               <Button
                 px="1"
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
index 9f61f1a3b..1a885fd75 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/V2.tsx
@@ -36,6 +36,7 @@ const GuidesList = ({
     if (displayOption === "all-eligible" && !guide.annotation.isEligible) {
       return null;
     }
+
     return <GuideRow key={guide.key} guide={guide} orderIndex={idx} />;
   });
 };
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index 6abbf3bca..b9d6c16ea 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -183,7 +183,7 @@ export const useInspectGuideClientStore = (): InspectionResult | undefined => {
   const { client } = useGuideContext();
 
   // Extract a snapshot of the client store state for debugging.
-  const snapshot: StoreStateSnapshot = useStore(client.store, (state) => {
+  const snapshot = useStore(client.store, (state) => {
     return {
       location: state.location,
       guides: state.guides,

From 8b4370d4af5225bfa05d6a10efa44c2affbaf895 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Thu, 12 Feb 2026 15:51:52 -0500
Subject: [PATCH 05/11] more update

---
 .../src/modules/guide/components/Toolbar/V2/GuideRow.tsx      | 4 ++--
 .../guide/components/Toolbar/V2/useInspectGuideClientStore.ts | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index 5155a9310..d946ed063 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -54,8 +54,8 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
             <Tooltip
               label={
                 guide.annotation.activatable.status
-                  ? "This guide can be activated in the current location"
-                  : "This guide cannot be activated in the current location"
+                  ? "This guide can be activated at the current location"
+                  : "This guide cannot be activated at the current location"
               }
             >
               <Button
diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index b9d6c16ea..6abbf3bca 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -183,7 +183,7 @@ export const useInspectGuideClientStore = (): InspectionResult | undefined => {
   const { client } = useGuideContext();
 
   // Extract a snapshot of the client store state for debugging.
-  const snapshot = useStore(client.store, (state) => {
+  const snapshot: StoreStateSnapshot = useStore(client.store, (state) => {
     return {
       location: state.location,
       guides: state.guides,

From 31fab60ca0dc5cb7f3ea84bc2fb7b67f3a9c5d3d Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Thu, 12 Feb 2026 16:21:29 -0500
Subject: [PATCH 06/11] add tests

---
 .../V2/useInspectGuideClientStore.test.ts     | 132 +++++++++++++++++-
 1 file changed, 131 insertions(+), 1 deletion(-)

diff --git a/packages/react/test/guide/Toolbar/V2/useInspectGuideClientStore.test.ts b/packages/react/test/guide/Toolbar/V2/useInspectGuideClientStore.test.ts
index 284032a89..54ba472fb 100644
--- a/packages/react/test/guide/Toolbar/V2/useInspectGuideClientStore.test.ts
+++ b/packages/react/test/guide/Toolbar/V2/useInspectGuideClientStore.test.ts
@@ -1,15 +1,27 @@
 import { renderHook } from "@testing-library/react";
-import { describe, expect, test, vi } from "vitest";
+import { beforeEach, describe, expect, test, vi } from "vitest";
 
 import {
   type AnnotatedGuide,
   isUnknownGuide,
+  resolveIsQualified,
   useInspectGuideClientStore,
 } from "../../../../src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore";
 
 // Mutable snapshot that tests can override to simulate different store states.
 let mockStoreState: Record<string, unknown> = {};
 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const mockCheckActivatable = vi.fn((..._args: any[]) => true);
+
+vi.mock("@knocklabs/client", async () => {
+  const actual = await vi.importActual("@knocklabs/client");
+  return {
+    ...actual,
+    checkActivatable: (...args: unknown[]) => mockCheckActivatable(...args),
+  };
+});
+
 vi.mock("@knocklabs/react-core", async () => {
   const actual = await vi.importActual("@knocklabs/react-core");
   return {
@@ -67,6 +79,7 @@ const makeMarker = (
 
 const setSnapshot = (partial: Record<string, unknown>) => {
   mockStoreState = {
+    location: "https://example.com",
     guides: {},
     guideGroups: [],
     ineligibleGuides: {},
@@ -82,6 +95,11 @@ const renderInspect = () => {
 };
 
 describe("useInspectGuideClientStore", () => {
+  beforeEach(() => {
+    mockCheckActivatable.mockReset();
+    mockCheckActivatable.mockReturnValue(true);
+  });
+
   // ----- Early returns -----
 
   test("returns undefined when not in debugging mode", () => {
@@ -119,6 +137,7 @@ describe("useInspectGuideClientStore", () => {
     expect(unknown.key).toBe("missing_key");
     expect(unknown.active).toBe(false);
     expect(unknown.annotation.isEligible).toBe(false);
+    expect(unknown.annotation.isQualified).toBe(false);
   });
 
   // ----- Guide annotation: fully eligible (no marker) -----
@@ -343,4 +362,115 @@ describe("useInspectGuideClientStore", () => {
       expect(annotated.annotation.isEligible).toBe(true);
     });
   });
+
+  // ----- activatable + isQualified -----
+
+  describe("activatable status and isQualified", () => {
+    test("marks guide as activatable and qualified when checkActivatable returns true", () => {
+      mockCheckActivatable.mockReturnValue(true);
+      const guide = makeGuide({ key: "g1" });
+      setSnapshot({
+        guideGroups: [makeGuideGroup(["g1"])],
+        guides: { g1: guide },
+        ineligibleGuides: {},
+      });
+
+      const result = renderInspect()!;
+      const annotated = result.guides[0] as AnnotatedGuide;
+      expect(annotated.annotation.activatable).toEqual({ status: true });
+      expect(annotated.annotation.isQualified).toBe(true);
+    });
+
+    test("marks guide as not activatable and not qualified when checkActivatable returns false", () => {
+      mockCheckActivatable.mockReturnValue(false);
+      const guide = makeGuide({ key: "g1" });
+      setSnapshot({
+        guideGroups: [makeGuideGroup(["g1"])],
+        guides: { g1: guide },
+        ineligibleGuides: {},
+      });
+
+      const result = renderInspect()!;
+      const annotated = result.guides[0] as AnnotatedGuide;
+      expect(annotated.annotation.activatable).toEqual({ status: false });
+      expect(annotated.annotation.isQualified).toBe(false);
+    });
+
+    test("passes the guide and location to checkActivatable", () => {
+      const guide = makeGuide({ key: "g1" });
+      setSnapshot({
+        location: "https://app.example.com/dashboard",
+        guideGroups: [makeGuideGroup(["g1"])],
+        guides: { g1: guide },
+        ineligibleGuides: {},
+      });
+
+      renderInspect();
+      expect(mockCheckActivatable).toHaveBeenCalledWith(
+        expect.objectContaining({ key: "g1" }),
+        "https://app.example.com/dashboard",
+      );
+    });
+
+    test("a guide can be eligible but not qualified", () => {
+      mockCheckActivatable.mockReturnValue(false);
+      const guide = makeGuide({ key: "g1", active: true });
+      setSnapshot({
+        guideGroups: [makeGuideGroup(["g1"])],
+        guides: { g1: guide },
+        ineligibleGuides: {},
+      });
+
+      const result = renderInspect()!;
+      const annotated = result.guides[0] as AnnotatedGuide;
+      expect(annotated.annotation.isEligible).toBe(true);
+      expect(annotated.annotation.isQualified).toBe(false);
+    });
+
+    test("a guide can be ineligible but qualified", () => {
+      mockCheckActivatable.mockReturnValue(true);
+      const guide = makeGuide({ key: "g1", active: true });
+      const marker = makeMarker(
+        "g1",
+        "guide_not_active",
+        "Guide is not active",
+      );
+      setSnapshot({
+        guideGroups: [makeGuideGroup(["g1"])],
+        guides: { g1: guide },
+        ineligibleGuides: { g1: marker },
+      });
+
+      const result = renderInspect()!;
+      const annotated = result.guides[0] as AnnotatedGuide;
+      expect(annotated.annotation.isEligible).toBe(false);
+      expect(annotated.annotation.isQualified).toBe(true);
+    });
+  });
+
+  // ----- resolveIsQualified (unit) -----
+
+  describe("resolveIsQualified", () => {
+    test("returns true when activatable status is true", () => {
+      expect(
+        resolveIsQualified({
+          active: { status: true },
+          targetable: { status: true },
+          archived: { status: false },
+          activatable: { status: true },
+        }),
+      ).toBe(true);
+    });
+
+    test("returns false when activatable status is false", () => {
+      expect(
+        resolveIsQualified({
+          active: { status: true },
+          targetable: { status: true },
+          archived: { status: false },
+          activatable: { status: false },
+        }),
+      ).toBe(false);
+    });
+  });
 });

From d1c9db9e8ee1223511a096682768b897f6c569ae Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Thu, 12 Feb 2026 16:21:56 -0500
Subject: [PATCH 07/11] cursor bot feedbacks

---
 .../guide/components/Toolbar/V2/useInspectGuideClientStore.ts   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index 6abbf3bca..524016941 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -128,7 +128,7 @@ const resolveIsEligible = ({
   return true;
 };
 
-export const resolveIsQualified = ({ activatable }: AnnotatedStatuses) => {
+const resolveIsQualified = ({ activatable }: AnnotatedStatuses) => {
   if (!activatable.status) return false;
   return true;
 };

From 7b59c65ee13f8ec7db3ab4edff3b3d7abe93af32 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Thu, 12 Feb 2026 20:42:23 -0500
Subject: [PATCH 08/11] bring up some downstream changes

---
 .../react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index d946ed063..a799abcc5 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -69,7 +69,7 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
           </Stack>
         )}
         {!isUnknownGuide(guide) && (
-          <Stack px="1" align="center">
+          <Stack px="2" align="center">
             <Box h="3" borderLeft="px" borderColor="gray-6" />
           </Stack>
         )}

From 6168f38b7c1b3b84c8dabe153191b7f3f3cebf6a Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Fri, 13 Feb 2026 13:24:58 -0500
Subject: [PATCH 09/11] fix export

---
 .../guide/components/Toolbar/V2/useInspectGuideClientStore.ts   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
index 524016941..6abbf3bca 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/useInspectGuideClientStore.ts
@@ -128,7 +128,7 @@ const resolveIsEligible = ({
   return true;
 };
 
-const resolveIsQualified = ({ activatable }: AnnotatedStatuses) => {
+export const resolveIsQualified = ({ activatable }: AnnotatedStatuses) => {
   if (!activatable.status) return false;
   return true;
 };

From 98e26f097b8fd9655da6c25b9b5f83f47b9712a2 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Fri, 13 Feb 2026 13:28:25 -0500
Subject: [PATCH 10/11] fix workspace file deprecation warning

---
 package.json         | 8 ++++----
 vitest/config.ts     | 1 +
 vitest/workspaces.ts | 1 -
 3 files changed, 5 insertions(+), 5 deletions(-)
 delete mode 100644 vitest/workspaces.ts

diff --git a/package.json b/package.json
index 17f7e4e33..369e536ca 100644
--- a/package.json
+++ b/package.json
@@ -14,10 +14,10 @@
     "lint": "turbo lint",
     "format": "turbo format",
     "format:check": "turbo format:check",
-    "test": "vitest run --config=./vitest/config.ts --workspace=./vitest/workspaces.ts",
-    "test:watch": "vitest run --config=./vitest/config.ts --workspace=./vitest/workspaces.ts --watch",
-    "test:coverage": "vitest run --config=./vitest/config.ts --workspace=./vitest/workspaces.ts --coverage",
-    "test:ci": "vitest run --config=./vitest/config.ts --workspace=./vitest/workspaces.ts --silent --coverage --reporter=junit --outputFile=test-report.junit.xml",
+    "test": "vitest run --config=./vitest/config.ts",
+    "test:watch": "vitest run --config=./vitest/config.ts --watch",
+    "test:coverage": "vitest run --config=./vitest/config.ts --coverage",
+    "test:ci": "vitest run --config=./vitest/config.ts --silent --coverage --reporter=junit --outputFile=test-report.junit.xml",
     "test:integration": "yarn test:integration:react-18 && yarn test:integration:react-19",
     "test:integration:react-18": "./integration/run-integration.sh 18.2.0",
     "test:integration:react-19": "./integration/run-integration.sh 19.1.0",
diff --git a/vitest/config.ts b/vitest/config.ts
index 0f5651de8..d3098f588 100644
--- a/vitest/config.ts
+++ b/vitest/config.ts
@@ -2,6 +2,7 @@ import { defineConfig } from "vitest/config";
 
 const sharedConfig = defineConfig({
   test: {
+    projects: ["packages/*"],
     coverage: {
       provider: "v8",
       all: true,
diff --git a/vitest/workspaces.ts b/vitest/workspaces.ts
deleted file mode 100644
index c1efc9a8b..000000000
--- a/vitest/workspaces.ts
+++ /dev/null
@@ -1 +0,0 @@
-export default ["packages/*"];

From 1f3c0f5874acb9b08c1f8f6f8861d178908374d2 Mon Sep 17 00:00:00 2001
From: Thomas <thomas.whyyou@gmail.com>
Date: Fri, 13 Feb 2026 13:53:22 -0500
Subject: [PATCH 11/11] pr review feedbacks

---
 .../guide/components/Toolbar/V2/GuideRow.tsx  | 44 +++++++++----------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
index a799abcc5..e260425ad 100644
--- a/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
+++ b/packages/react/src/modules/guide/components/Toolbar/V2/GuideRow.tsx
@@ -50,28 +50,28 @@ export const GuideRow = ({ guide, orderIndex }: Props) => {
 
       <Stack justify="flex-end">
         {!isUnknownGuide(guide) && (
-          <Stack gap="1">
-            <Tooltip
-              label={
-                guide.annotation.activatable.status
-                  ? "This guide can be activated at the current location"
-                  : "This guide cannot be activated at the current location"
-              }
-            >
-              <Button
-                px="1"
-                size="1"
-                variant="soft"
-                color={guide.annotation.activatable.status ? "green" : "red"}
-                leadingIcon={{ icon: LocateFixed, alt: "Target" }}
-              />
-            </Tooltip>
-          </Stack>
-        )}
-        {!isUnknownGuide(guide) && (
-          <Stack px="2" align="center">
-            <Box h="3" borderLeft="px" borderColor="gray-6" />
-          </Stack>
+          <>
+            <Stack gap="1">
+              <Tooltip
+                label={
+                  guide.annotation.activatable.status
+                    ? "This guide can be activated at the current location"
+                    : "This guide cannot be activated at the current location"
+                }
+              >
+                <Button
+                  px="1"
+                  size="1"
+                  variant="soft"
+                  color={guide.annotation.activatable.status ? "green" : "red"}
+                  leadingIcon={{ icon: LocateFixed, alt: "Target" }}
+                />
+              </Tooltip>
+            </Stack>
+            <Stack px="2" align="center">
+              <Box h="3" borderLeft="px" borderColor="gray-6" />
+            </Stack>
+          </>
         )}
         <Stack gap="1">
           {!isUnknownGuide(guide) && (