> 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/tasks.md).

# Task Checklist

**Session ID**: `phase20-session01-connections-stats-long-tail` **Total Tasks**: 22 **Estimated Duration**: 3-4 hours **Created**: 2026-06-02

***

## Legend

* `[x]` = Completed
* `[ ]` = Pending
* `[P]` = Parallelizable (can run with other \[P] tasks)
* `[SNNMM]` = Session reference (NN=phase number, MM=session number)
* `TNNN` = Task ID

***

## Progress Summary

| Category       | Total  | Done   | Remaining |
| -------------- | ------ | ------ | --------- |
| Setup          | 3      | 3      | 0         |
| Foundation     | 5      | 5      | 0         |
| Implementation | 13     | 13     | 0         |
| Testing        | 1      | 1      | 0         |
| **Total**      | **22** | **22** | **0**     |

***

## Setup (3 tasks)

Initial configuration and environment preparation.

* [x] T001 \[S2001] Verify Phase 16-19 prerequisites, v2.3 anchors, and current Hermes hook/demo contracts before implementation (`.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md`)
* [x] T002 \[S2001] Audit existing Hermes page tabs, state surfaces, and data availability for connections, stats, skills, sessions, roles, activity, and CLI without changing source (`src/components/hermes/hermes-read-only-page.tsx`)
* [x] T003 \[S2001] Decide long-tail tab grouping and record why the chosen placement preserves scanability and avoids duplicate write surfaces (`.spec_system/specs/phase20-session01-connections-stats-long-tail/implementation-notes.md`)

***

## Foundation (5 tasks)

Core structures and base implementations.

* [x] T004 \[S2001] \[P] Create typed long-tail constants for roles, CLI categories, provider/logo slugs, platform badges, and capability labels with exhaustive enum handling where applicable (`src/components/hermes/hermes-long-tail-data.ts`)
* [x] T005 \[S2001] \[P] Add a connections display component with normalized rows, local-logo lookup, deterministic fallback rendering, and explicit loading, empty, error, offline, and demo states (`src/components/hermes/hermes-connections.tsx`)
* [x] T006 \[S2001] \[P] Add a derived live stats component with bounded session/message/model/activity calculations and deterministic ordering for null or tied session values (`src/components/hermes/hermes-live-stats.tsx`)
* [x] T007 \[S2001] \[P] Add read-only role and capability components with static v2.3-derived role data and no write or prompt execution affordances (`src/components/hermes/hermes-roles.tsx`)
* [x] T008 \[S2001] \[P] Add a CLI cheatsheet and terminal setup component with copy buttons, copied-state reset, keyboard focus support, and no browser command execution (`src/components/hermes/hermes-cli-cheatsheet.tsx`)

***

## Implementation (13 tasks)

Main feature implementation.

* [x] T009 \[S2001] Add an activity panel derived from sessions, skills, profiles, and status views with explicit loading, empty, error, and offline states (`src/components/hermes/hermes-activity.tsx`)
* [x] T010 \[S2001] Upgrade Skills cards with v2.3-inspired tiles, bounded descriptions, expand/collapse behavior, state reset on re-entry, and existing demo/live state handling (`src/components/hermes/hermes-skills.tsx`)
* [x] T011 \[S2001] Upgrade Sessions rows with platform badges, provider/model chips, relative-time fallbacks, stable sorting, and explicit token-failure and empty states (`src/components/hermes/hermes-sessions.tsx`)
* [x] T012 \[S2001] Wire connections and stats views into `HermesReadOnlyPage` using `hermes.connections`, `hermes.sessions`, `hermes.models`, `hermes.skills`, `hermes.profiles`, and demo views only (`src/components/hermes/hermes-read-only-page.tsx`)
* [x] T013 \[S2001] Wire roles, activity, CLI, and terminal setup guidance into the chosen long-tail tab or panels without duplicating Chat, Mission, Documents, Memory, Mnemosyne, Pantheon, or Admin write controls (`src/components/hermes/hermes-read-only-page.tsx`)
* [x] T014 \[S2001] Update Hermes route description copy only as needed so it names the new long-tail read-only surfaces without overclaiming final parity (`src/routes/agents.hermes.tsx`)
* [x] T015 \[S2001] Add small shared primitives only if repeated long-tail UI needs them, preserving existing Hermes visual tokens and focus styling (`src/components/hermes/hermes-page-primitives.tsx`)
* [x] T016 \[S2001] Extend demo data only if new components need additional bounded fixture fields, keeping live and demo shapes parser-compatible (`src/lib/hermes-demo-data.ts`)
* [x] T017 \[S2001] Extend Hermes types and parsers only if missing hook-layer projections are discovered, with schema-validated input and explicit error mapping (`src/lib/hermes-types.ts`)
* [x] T018 \[S2001] Extend `useHermes` only if new parser projections are required, keeping all bridge calls hook-owned with timeout/query cancellation behavior and no component-owned fetches (`src/hooks/use-hermes.ts`)
* [x] T019 \[S2001] Add or update component tests for Connections, Stats, Roles, Activity, CLI, Skills, Sessions, and page wiring across live/demo/setup/offline/error/token states (`src/components/hermes/__tests__/hermes-sections.test.tsx`)
* [x] T020 \[S2001] Update parser/demo fixture tests if task T017 or T018 changes hook-layer contracts (`src/lib/__tests__/hermes-types.test.ts`)
* [x] T021 \[S2001] Update hook tests if task T018 adds projections, including token-gating, offline behavior, malformed payloads, and no sensitive reads without a token (`src/hooks/__tests__/use-hermes.test.tsx`)

***

## Testing (1 task)

Verification and quality assurance.

* [x] T022 \[S2001] Run focused Hermes tests, typecheck, lint, ASCII validation, and manual desktop/mobile layout checks; document any unrelated pre-existing failures (`.spec_system/specs/phase20-session01-connections-stats-long-tail/validation.md`)

***

## Completion Checklist

Before marking session complete:

* [x] All tasks marked `[x]`
* [x] All tests passing
* [x] All files ASCII-encoded
* [x] implementation-notes.md updated
* [x] Ready for the validate workflow step

***

## Next Steps

Run the implement workflow step to begin AI-led implementation.


---

# 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/tasks.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.