> 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/phases/phase_20/session_01_connections_stats_long_tail.md).

# Session 01: Connections, Stats And Long-Tail Sections

**Session ID**: `phase20-session01-connections-stats-long-tail` **Status**: Not Started **Estimated Tasks**: \~16-22 **Estimated Duration**: 3-4 hours

***

## Objective

Port the remaining read-only/low-risk v2.3 Hermes sections into modular aios components: Connections, stats, skills, recent sessions, roles, activity, CLI, run-in-terminal, and shared section/cell primitives. Source-code anchors are the V23 long-tail route component references listed below.

***

## Scope

### In Scope (MVP)

* Connections source constants/components: `HERMES_LOCAL_LOGOS` V23 `agents.hermes.tsx:90`, `HermesConnectionsStrip` `:1335`, `ConnectionsModeToggle` `:1476`, `ConnectionLogo` `:1523`, `ProviderLogoChip` `:1246`.
* Stats source components: `HermesStatsSection` V23 `:3257`, `HermesLiveStats` `:5716`, `RichStatCell` `:5896`, `LiveStatCell` `:5935`, `HermesClaudeOsBridgeCard` `:6000`, `StatTile` `:7214`.
* Skills source components: `HermesLiveSkills` V23 `:6165`, `SkillTile` `:6386`, `HermesSkillsSection` `:7005`, `SectionHead` `:6521`.
* Sessions source components: `HermesRecentSessions` V23 `:6565`, `SessionRow` `:6691`, `PlatformBadge` `:6661`, `PlatformBadgeIcon` `:6623`.
* Roles source components: `HermesRolesSection` V23 `:6794`, `RoleCell` `:6830`, `ROLES` `:6743`.
* Activity source components: `HermesActivityPanels` V23 `:6909`, `Capability` `:6981`.
* CLI source components/data: `HermesCliCheatsheet` V23 `:7118`, `CliCategoryCell` `:7139`, `CliCommandRow` `:7162`, `CLI_CATEGORIES` `:7061`, `RunInTerminalCard` `:7262`.
* Targets: upgrade `AIOS/src/components/hermes/hermes-skills.tsx` (`:59`) and `AIOS/src/components/hermes/hermes-sessions.tsx` (`:52`); add small focused components under `AIOS/src/components/hermes/`; wire through `hermes-read-only-page.tsx` tabs/panels as decided in Phase 16 Session 01.
* Use Phase 16 queries/demo fixtures for connections, sessions, stats, skills, roles, activity, and CLI data. Any missing projection is added to the hook/type layer, not fetched directly from components.

### Out of Scope

* New write endpoints or write UI.
* Cleanup/dead-code removal and final parity certification (Session 02).
* Reworking earlier Chat/Pantheon/Memory/Mnemosyne/Mission/Documents surfaces beyond integration fixes needed for the long-tail layout.

***

## Prerequisites

* [ ] Phases 16-19 complete and validated.
* [ ] Long-tail data shapes and demo fixtures are present from Phase 16 Session 03 or added through the same typed hook/demo-data pattern.
* [ ] The Phase 16 IA decision identifies where long-tail sections live.

***

## Deliverables

1. Modular Connections, stats, skills, recent sessions, roles, activity, CLI, and run-in-terminal components under `AIOS/src/components/hermes/`.
2. Existing `hermes-skills.tsx` and `hermes-sessions.tsx` upgraded without bypassing the hook layer.
3. Mode-matrix coverage and `hermes-sections.test.tsx` extensions for the new long-tail sections.

***

## Success Criteria

* [ ] All long-tail v2.3 sections listed above are reachable from the Hermes page through modular aios components.
* [ ] Components consume `useHermes`/typed props/demo fixtures only; no direct raw fetches.
* [ ] Existing Skills and Sessions behavior remains compatible while gaining the v2.3 long-tail detail.
* [ ] Mode matrix renders; typecheck, lint, and tests pass.


---

# 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/phases/phase_20/session_01_connections_stats_long_tail.md?ask=<question>&goal=<endgoal>
```

`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.