> 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/phase18-session02-mnemosyne-constellation-readonly/tasks.md).

# Task Checklist

**Session ID**: `phase18-session02-mnemosyne-constellation-readonly` **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 | 10     | 10     | 0         |
| Testing        | 4      | 4      | 0         |
| **Total**      | **22** | **22** | **0**     |

***

## Setup (3 tasks)

Initial confirmation and implementation notes.

* [x] T001 \[S1802] Verify v2.3 Mnemosyne source anchors, current AI OS assets, and existing 3D dependency versions (`.spec_system/specs/phase18-session02-mnemosyne-constellation-readonly/implementation-notes.md`)
* [x] T002 \[S1802] Confirm Phase 18 Session 01 memory/profile/Obsidian storage contracts for read-only reuse (`src/components/hermes/hermes-obsidian-bridge.tsx`)
* [x] T003 \[S1802] Record the raw `three` bloom approach and dependency decision before implementation (`.spec_system/specs/phase18-session02-mnemosyne-constellation-readonly/implementation-notes.md`)

***

## Foundation (5 tasks)

Typed graph data, lazy boundaries, and test fixtures.

* [x] T004 \[S1802] \[P] Create Mnemosyne graph types and bounded label helpers with exhaustive query-state mapping (`src/components/hermes/hermes-mnemosyne-data.ts`)
* [x] T005 \[S1802] Implement memory, SOUL, persona, session, and Obsidian node derivation with bounded labels and deterministic ordering (`src/components/hermes/hermes-mnemosyne-data.ts`)
* [x] T006 \[S1802] Implement source-filter and view-mode graph projections without mutating source data (`src/components/hermes/hermes-mnemosyne-data.ts`)
* [x] T007 \[S1802] \[P] Create focused Mnemosyne test fixtures for memory, sessions, Pantheon, and Obsidian connected/disconnected states (`src/components/hermes/__tests__/hermes-mnemosyne.test.tsx`)
* [x] T008 \[S1802] \[P] Add lazy import and WebGL module mocks for component tests with cleanup on scope exit for imported resources (`src/components/hermes/__tests__/hermes-mnemosyne.test.tsx`)

***

## Implementation (10 tasks)

Main read-only Mnemosyne tab.

* [x] T009 \[S1802] Create the lazy Mnemosyne component shell with explicit loading, empty, error, offline, token-failure, success, and demo states (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T010 \[S1802] Wire `HermesReadOnlyPage` to lazy-load the `Mnemosyne` tab behind Suspense without importing 3D vendor code on initial render (`src/components/hermes/hermes-read-only-page.tsx`)
* [x] T011 \[S1802] Implement source toggles for Hermes and Obsidian with disabled/revalidated behavior on storage and focus changes (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T012 \[S1802] Implement accessible view-mode controls for constellation, spheres, and drift modes with deterministic graph projection (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T013 \[S1802] Dynamically import `react-force-graph-3d`, `three`, and `UnrealBloomPass` with cancellation and failure-path handling (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T014 \[S1802] Render Hermes, memory, SOUL, persona, session, and Obsidian nodes with custom three objects and bounded tooltips (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T015 \[S1802] Add force tuning, starfield, lighting, bloom, and camera framing with cleanup on unmount for animation frames and graph side effects (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T016 \[S1802] Add auto-orbit pause/reduced-motion behavior with platform-appropriate accessibility labels and input support (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T017 \[S1802] Add responsive canvas sizing and scroll-safe behavior for desktop and mobile viewports (`src/components/hermes/hermes-mnemosyne.tsx`)
* [x] T018 \[S1802] Keep the existing bundle-budget script aligned with measured lazy chunk names if an explicit vendor pattern is required (`scripts/check-bundle-budget.sh`)

***

## Testing (4 tasks)

Verification and quality assurance.

* [x] T019 \[S1802] Write data adapter tests for node derivation, bounded labels, source filters, session caps, template SOUL, and Obsidian states (`src/components/hermes/__tests__/hermes-mnemosyne.test.tsx`)
* [x] T020 \[S1802] Write component tests for lazy fallback, controls, empty/error states, accessibility labels, and cleanup behavior (`src/components/hermes/__tests__/hermes-mnemosyne.test.tsx`)
* [x] T021 \[S1802] Extend Hermes page mode-matrix coverage for the Mnemosyne tab and live/demo transitions (`src/components/hermes/__tests__/hermes-sections.test.tsx`)
* [x] T022 \[S1802] Run focused tests, typecheck, lint, build, bundle budget, ASCII validation, and Playwright screenshot/canvas-pixel checks (`.spec_system/specs/phase18-session02-mnemosyne-constellation-readonly/implementation-notes.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] Bundle decision and budget evidence recorded
* [x] Playwright screenshots and canvas-pixel checks recorded
* [x] Ready for the validate workflow step

***

## Next Steps

Run the `validate` workflow step to complete session validation.


---

# 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/phase18-session02-mnemosyne-constellation-readonly/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.