> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase20-session01-connections-stats-long-tail/implementation-notes.md). # Implementation Notes **Session ID**: `phase20-session01-connections-stats-long-tail` **Started**: 2026-06-02 12:05 **Last Updated**: 2026-06-02 12:05 *** ## Session Progress | Metric | Value | | ------------------- | --------- | | Tasks Completed | 22 / 22 | | Estimated Remaining | 0 minutes | | Blockers | 0 | *** ## Task Log ### 2026-06-02 - Session Start **Environment verified**: * [x] Prerequisites confirmed * [x] Tools available * [x] Directory structure ready * [x] Bun 1.3.14 available * [x] Current session resolved from `.spec_system/state.json` *** ### Task T001 - Verify prerequisites and contracts **Started**: 2026-06-02 12:05 **Completed**: 2026-06-02 12:05 **Duration**: 1 minute **Notes**: * Ran `.spec_system/scripts/analyze-project.sh --json`; active session is `phase20-session01-connections-stats-long-tail`. * Ran `.spec_system/scripts/check-prereqs.sh --json --env`; spec system, jq, and git passed. * Ran `.spec_system/scripts/check-prereqs.sh --json --tools bun`; Bun 1.3.14 passed and matches `.bun-version`. * Verified the v2.3 source anchor exists at `/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/agents.hermes.tsx`. * Confirmed current AIOS hook contracts already expose `connections`, `sessions`, `models`, `skills`, `profiles`, `status`, and demo fixtures with typed `HermesQueryView` wrappers. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Created the session progress log and recorded prerequisite verification. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T001 complete and updated progress. **BQC Fixes**: * N/A - Setup verification only. *** ### Task T002 - Audit existing Hermes page and data availability **Started**: 2026-06-02 12:05 **Completed**: 2026-06-02 12:06 **Duration**: 1 minute **Notes**: * Audited `src/components/hermes/hermes-read-only-page.tsx`: it owns demo/live mode, selected chat session state, `useHermes`, `useHermesAdmin`, and the current tab composition. * Existing tabs are Sessions, Chat, Mission, Documents, Memory, Mnemosyne, Pantheon, Skills, and Admin. * Existing state surfaces use `modeNotice`, `HermesStatusBar`, `StateBlock`, and `HermesQueryView` state values. * Data availability is already sufficient for this session: `useHermes` exposes `connections`, `sessions`, `models`, `skills`, `profiles`, `status`, and the demo fixture exports include connections, profiles, sessions, models, status, and skills. * Current Skills and Sessions components are small and state-aware but lack v2.3-style rich chips, collapse/expand, and long-tail detail. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Recorded audit findings. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T002 complete and updated progress. **BQC Fixes**: * N/A - Source audit only. *** ### Task T003 - Decide long-tail tab grouping **Started**: 2026-06-02 12:06 **Completed**: 2026-06-02 12:06 **Duration**: 1 minute **Notes**: * Chosen placement: add one new read-only `Overview` tab as the default tab. * `Overview` will contain Connections, Live Stats, Activity, Roles, CLI cheatsheet, and Terminal setup guidance. * Existing `Sessions` and `Skills` tabs remain their owning surfaces and will be upgraded in place. * Existing Chat, Mission, Documents, Memory, Mnemosyne, Pantheon, and Admin tabs remain unchanged in ownership so no long-tail panel duplicates write controls or admin workflows. * This keeps the tab list scannable by adding one long-tail tab instead of one tab per small section. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Recorded the grouping decision. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T003 complete and updated progress. **BQC Fixes**: * N/A - Placement decision only. *** ### Task T004 - Create typed long-tail constants **Started**: 2026-06-02 12:06 **Completed**: 2026-06-02 12:08 **Duration**: 2 minutes **Notes**: * Added typed constants for local logo assets, Simple Icons slugs, platform badges, role cards, capability meters, CLI categories, and terminal setup commands. * Added deterministic helpers for slug normalization, fallback color selection, provider inference, platform badge lookup, and exhaustive labels for connection kind, connection status, and model tier. * Corrected the terminal install command to the v2.3 anchor command instead of using a placeholder-style URL. **Files Changed**: * `src/components/hermes/hermes-long-tail-data.ts` - Created typed constants and helper functions for long-tail Hermes components. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T004. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T004 complete and updated progress. **BQC Fixes**: * Contract alignment: Exhaustive switch helpers cover current connection kind, connection status, and model tier enums (`src/components/hermes/hermes-long-tail-data.ts`). *** ### Task T005 - Add Hermes connections component **Started**: 2026-06-02 12:08 **Completed**: 2026-06-02 12:10 **Duration**: 2 minutes **Notes**: * Added a prop-driven connections strip that consumes `HermesQueryView`. * Normalizes rows by kind, slug, status, and display labels, with stable ordering for connected rows, kind, and name. * Added local logo lookup, Simple Icons only for verified slugs, and deterministic initial-letter fallback rendering. * Added filter buttons for all, connected, and needs-setup rows. * Added explicit idle, loading, empty, error, offline, token-failure, success, and demo states. **Files Changed**: * `src/components/hermes/hermes-connections.tsx` - Created the connections display component and logo fallback renderer. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T005. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T005 complete and updated progress. **BQC Fixes**: * State freshness on re-entry: Connection filter resets when demo/live mode or query state changes (`src/components/hermes/hermes-connections.tsx`). * Failure path completeness: All `HermesSectionState` values render explicit `StateBlock` copy (`src/components/hermes/hermes-connections.tsx`). * External dependency resilience: Remote logo image failures fall back to deterministic local initials without blank/broken images (`src/components/hermes/hermes-connections.tsx`). *** ### Task T006 - Add derived live stats component **Started**: 2026-06-02 12:10 **Completed**: 2026-06-02 12:12 **Duration**: 2 minutes **Notes**: * Added a prop-driven stats component that derives session totals, message totals, distinct models, last activity, connection counts, profile counts, skill counts, status, configured model, model tiers, and activity buckets from existing query views. * Stable session ordering uses timestamp descending with ID tie-breakers. * Null or missing timestamps fall back to parsed dates or `0`, keeping sort and bucket behavior deterministic. * Activity bucket anchoring preserves useful demo/live output without relying on raw polling or component-owned fetches. **Files Changed**: * `src/components/hermes/hermes-live-stats.tsx` - Created derived stats ledger and compact activity sparkline. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T006. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T006 complete and updated progress. **BQC Fixes**: * Contract alignment: Stats derive only from typed `HermesQueryView` props and existing body contracts (`src/components/hermes/hermes-live-stats.tsx`). * Failure path completeness: Session-state failures render explicit state blocks before stats are shown (`src/components/hermes/hermes-live-stats.tsx`). *** ### Task T007 - Add read-only roles and capabilities **Started**: 2026-06-02 12:12 **Completed**: 2026-06-02 12:14 **Duration**: 2 minutes **Notes**: * Added a read-only roles panel using typed static role and capability constants. * Added context counts from sessions, profiles, and skills when those views are available. * Role cards are passive articles, not action buttons, and include no prompt execution or write affordances. **Files Changed**: * `src/components/hermes/hermes-roles.tsx` - Created role cards, capability meters, and context summary. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T007. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T007 complete and updated progress. **BQC Fixes**: * Duplicate action prevention: Role cards intentionally render as passive articles, so there are no triggerable write or prompt actions to double-submit (`src/components/hermes/hermes-roles.tsx`). * Error information boundaries: Missing token-gated context is summarized as `Gated` rather than exposing internal endpoint details (`src/components/hermes/hermes-roles.tsx`). *** ### Task T008 - Add CLI cheatsheet and terminal setup **Started**: 2026-06-02 12:14 **Completed**: 2026-06-02 12:17 **Duration**: 3 minutes **Notes**: * Added CLI category grids from typed constants with keyboard-focusable copy buttons. * Added a passive terminal setup card that narrows install, setup, or doctor commands by route mode. * Added clipboard fallback handling with a copied/failed state reset. * The component copies command text only; it never executes terminal commands in the browser. **Files Changed**: * `src/components/hermes/hermes-cli-cheatsheet.tsx` - Created CLI cheatsheet, copy buttons, terminal command cards, and mode-aware setup guidance. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T008. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T008 complete and updated progress. **BQC Fixes**: * Resource cleanup: Copy-state reset timeouts are cleared on unmount and before a new reset timer is set (`src/components/hermes/hermes-cli-cheatsheet.tsx`). * Duplicate action prevention: Copy actions are isolated to per-button state and never invoke browser-side command execution (`src/components/hermes/hermes-cli-cheatsheet.tsx`). * Accessibility and platform compliance: Copy affordances are real buttons with labels, visible focus styles, and polite copied/failed status text (`src/components/hermes/hermes-cli-cheatsheet.tsx`). *** ### Task T009 - Add derived activity panel **Started**: 2026-06-02 12:17 **Completed**: 2026-06-02 12:19 **Duration**: 2 minutes **Notes**: * Added a read-only activity panel derived from sessions, skills, profiles, and status query views. * Recent session items sort by timestamp descending with ID tie-breakers. * Context rows for bridge status, profiles, and skills keep the panel useful when token-gated session activity is unavailable but public/status context exists. * Added explicit idle, loading, empty, error, offline, token-failure, success, and demo handling. **Files Changed**: * `src/components/hermes/hermes-activity.tsx` - Created recent activity and read-path summary panels. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T009. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T009 complete and updated progress. **BQC Fixes**: * Failure path completeness: Activity renders explicit state blocks when no context data is available, and visible degraded-state chips when partial context remains (`src/components/hermes/hermes-activity.tsx`). * Contract alignment: Activity rows derive only from typed query views and do not start fetches or timers (`src/components/hermes/hermes-activity.tsx`). *** ### Task T010 - Upgrade Skills cards **Started**: 2026-06-02 12:19 **Completed**: 2026-06-02 12:21 **Duration**: 2 minutes **Notes**: * Replaced the basic skills grid with numbered v2.3-inspired tiles, bounded descriptions, inferred provider/platform chips, and summary counters. * Added collapse/expand behavior with a six-skill default. * Preserved existing `HermesQueryView` state handling for live, demo, loading, empty, error, offline, and token-failure states. **Files Changed**: * `src/components/hermes/hermes-skills.tsx` - Upgraded skill cards and expand/collapse behavior. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T010. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T010 complete and updated progress. **BQC Fixes**: * State freshness on re-entry: Expanded state resets when demo/live mode or the query state changes (`src/components/hermes/hermes-skills.tsx`). * Accessibility and platform compliance: Expand/collapse uses a real button with visible focus styling through the existing `TextButton` primitive (`src/components/hermes/hermes-skills.tsx`). *** ### Task T011 - Upgrade Sessions rows **Started**: 2026-06-02 12:21 **Completed**: 2026-06-02 12:23 **Duration**: 2 minutes **Notes**: * Replaced basic session rows with richer rows that include platform badges, model/provider chips, message counts, stable metadata, and relative-time fallbacks. * Stable sorting uses timestamp descending with ID tie-breakers and supports missing timestamps. * Token-failure and empty states keep explicit state copy. **Files Changed**: * `src/components/hermes/hermes-sessions.tsx` - Upgraded recent session rows, sort/fallback logic, and state copy. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T011. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T011 complete and updated progress. **BQC Fixes**: * Contract alignment: Session display derives only from `HermesSessionSummary` fields and handles nullable model/platform/timestamps (`src/components/hermes/hermes-sessions.tsx`). * Failure path completeness: Token-failure and empty states render explicit `StateBlock` output (`src/components/hermes/hermes-sessions.tsx`). *** ### Task T012 - Wire connections and stats into HermesReadOnlyPage **Started**: 2026-06-02 12:23 **Completed**: 2026-06-02 12:24 **Duration**: 1 minute **Notes**: * Added a demo/live `connections` query view using `HERMES_DEMO_DATA.connections` or `hermes.connections`. * Added `HermesConnections` and `HermesLiveStats` to the new `Overview` tab. * Live stats receive status, models, sessions, connections, profiles, and skills through existing query views only. **Files Changed**: * `src/components/hermes/hermes-read-only-page.tsx` - Added Overview tab wiring for connections and live stats. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T012. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T012 complete and updated progress. **BQC Fixes**: * Contract alignment: Page wiring passes hook-owned `HermesQueryView` values and demo fixtures only, with no component-owned bridge fetches (`src/components/hermes/hermes-read-only-page.tsx`). *** ### Task T013 - Wire roles, activity, CLI, and terminal setup **Started**: 2026-06-02 12:24 **Completed**: 2026-06-02 12:25 **Duration**: 1 minute **Notes**: * Added `HermesActivity`, `HermesRoles`, and `HermesCliCheatsheet` to the new `Overview` tab. * Kept Chat, Mission, Documents, Memory, Mnemosyne, Pantheon, Skills, and Admin as separate owning tabs. * Updated the page hero copy to mention the new long-tail read-only surfaces without claiming final parity. **Files Changed**: * `src/components/hermes/hermes-read-only-page.tsx` - Added Overview tab and long-tail component composition. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T013. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T013 complete and updated progress. **BQC Fixes**: * Duplicate action prevention: New long-tail sections are grouped away from existing Admin, Mission, Documents, and Chat write surfaces, so write controls are not duplicated (`src/components/hermes/hermes-read-only-page.tsx`). *** ### Task T014 - Update route description copy **Started**: 2026-06-02 12:25 **Completed**: 2026-06-02 12:25 **Duration**: 1 minute **Notes**: * Updated the route metadata description to include connections, stats, roles, and CLI guidance. * Avoided final parity language; Phase 20 Session 02 owns cleanup and sign-off. **Files Changed**: * `src/routes/agents.hermes.tsx` - Updated read-only route description metadata. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T014. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T014 complete and updated progress. **BQC Fixes**: * N/A - Metadata copy only. *** ### Task T015 - Evaluate shared primitive needs **Started**: 2026-06-02 12:25 **Completed**: 2026-06-02 12:26 **Duration**: 1 minute **Notes**: * Reviewed repeated long-tail UI patterns after adding the foundation components. * Existing primitives (`SectionPanel`, `StateBlock`, `TextButton`, `HermesStatusChip`, `ClipText`, and `MetaLine`) cover the repeated needs. * No new shared primitive was added, preserving the existing visual tokens and avoiding unnecessary abstraction. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T015. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T015 complete and updated progress. **BQC Fixes**: * N/A - Primitive evaluation only. *** ### Task T016 - Evaluate demo data needs **Started**: 2026-06-02 12:26 **Completed**: 2026-06-02 12:26 **Duration**: 1 minute **Notes**: * Existing demo fixtures already include bounded connections, sessions, models, profiles, status, and skills data. * No additional demo fields were required by the new components. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T016. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T016 complete and updated progress. **BQC Fixes**: * Contract alignment: Avoided unnecessary demo/live shape drift because existing fixtures already match parser contracts. *** ### Task T017 - Evaluate Hermes parser/type needs **Started**: 2026-06-02 12:26 **Completed**: 2026-06-02 12:27 **Duration**: 1 minute **Notes**: * Existing `HermesConnectionsBody`, `HermesSessionsBody`, `HermesModelsBody`, `HermesProfilesBody`, `HermesSkillsBody`, and `HermesStatusBody` contracts are sufficient. * No parser or type extension was needed. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T017. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T017 complete and updated progress. **BQC Fixes**: * Contract alignment: Avoided parser churn because no missing hook-layer projection was discovered. *** ### Task T018 - Evaluate useHermes projection needs **Started**: 2026-06-02 12:27 **Completed**: 2026-06-02 12:27 **Duration**: 1 minute **Notes**: * Existing `useHermes` already owns all needed bridge calls and returns the required query views. * No new bridge endpoint, fetch, polling path, or hook projection was required. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T018. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T018 complete and updated progress. **BQC Fixes**: * Trust boundary enforcement: Kept bridge access in `useHermes`; no long-tail component reads endpoints directly. *** ### Task T019 - Add component and page wiring tests **Started**: 2026-06-02 12:27 **Completed**: 2026-06-02 12:32 **Duration**: 5 minutes **Notes**: * Added long-tail fixtures and tests for Overview page wiring, live/demo transitions, Connections filtering/state matrix, Live Stats state matrix, Activity state matrix, Roles rendering, and CLI copy behavior. * Updated the Sessions sort expectation for the upgraded row heading behavior. * Fixed a React duplicate-key warning in the stats provider stack by de-duping provider keys. * Focused component test command passed: `bun run test src/components/hermes/__tests__/hermes-sections.test.tsx` (86 tests). **Files Changed**: * `src/components/hermes/__tests__/hermes-sections.test.tsx` - Extended Hermes component coverage for long-tail sections and adjusted Sessions expectation. * `src/components/hermes/hermes-live-stats.tsx` - De-duped provider key rendering after test coverage surfaced duplicate provider keys. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T019. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T019 complete and updated progress. **BQC Fixes**: * Contract alignment: Tests cover live/demo page wiring and state matrices for the new prop-driven query-view components. * Failure path completeness: Added direct state matrix coverage for Connections, Live Stats, and Activity. *** ### Task T020 - Evaluate parser/demo fixture tests **Started**: 2026-06-02 12:32 **Completed**: 2026-06-02 12:32 **Duration**: 1 minute **Notes**: * T017 and T018 did not change parser, fixture, or hook-layer contracts. * No parser/demo fixture test edits were required. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T020. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T020 complete and updated progress. **BQC Fixes**: * N/A - Conditional test task with no contract changes. *** ### Task T021 - Evaluate hook tests **Started**: 2026-06-02 12:32 **Completed**: 2026-06-02 12:32 **Duration**: 1 minute **Notes**: * T018 did not add hook projections or bridge calls. * Existing hook tests remain the owning coverage for token-gating, offline behavior, malformed payloads, and sensitive read protection. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T021. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T021 complete and updated progress. **BQC Fixes**: * N/A - Conditional hook-test task with no hook changes. *** ### Task T022 - Run quality gates and layout checks **Started**: 2026-06-02 12:32 **Completed**: 2026-06-02 12:33 **Duration**: 1 minute **Notes**: * Ran focused Hermes component tests, Hermes parser/hook tests, typecheck, lint, ASCII validation, and Playwright desktop/mobile layout checks. * Fixed Prettier lint failures by formatting touched files, then reran focused tests, typecheck, lint, and ASCII validation successfully. * Browser layout checks passed in demo mode at desktop and mobile widths with no document horizontal overflow and no checked text-container overflow. * Temporary Vite dev server was stopped after validation. **Files Changed**: * `.spec_system/specs/phase20-session01-connections-stats-long-tail/validation.md` - Added validation results and browser evidence. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md` - Logged T022. * `.spec_system/specs/phase20-session01-connections-stats-long-tail/tasks.md` - Marked T022 complete, completed checklist, and updated progress. **BQC Fixes**: * N/A - Final validation task. *** ## Session Summary * Added Hermes long-tail data constants, connection strip, live stats ledger, roles panel, activity panel, and CLI/terminal setup surface. * Upgraded Skills and Sessions with richer tiles/rows, deterministic ordering, state handling, metadata chips, and reset/fallback behavior. * Wired a new default `Overview` tab into the Hermes read-only page while preserving existing write-owned tabs. * Added focused component/page tests for live, demo, setup, offline, error, token-failure, copy, and state-matrix behavior. * Verified focused tests, parser/hook tests, typecheck, lint, ASCII, and desktop/mobile layout checks. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase20-session01-connections-stats-long-tail/implementation-notes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.