> 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/phase22-session03-setup-wizard-dream-sources-strip/tasks.md).

# Task Checklist

**Session ID**: `phase22-session03-setup-wizard-dream-sources-strip` **Total Tasks**: 17 **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 | 6      | 6      | 0         |
| Testing        | 3      | 3      | 0         |
| **Total**      | **17** | **17** | **0**     |

***

## Setup (3 tasks)

Initial configuration and environment preparation.

* [x] T001 \[S2203] Verify Phase 22 Session 01 and Session 02 validation, Antigravity contract, and usage-consumer prerequisites (`.spec_system/specs/phase22-session02-antigravity-usage-consumers/validation.md`)
* [x] T002 \[S2203] Inspect setup wizard constants, detection helpers, and Hermes setup tests before changing defaults (`src/components/setup/constants.ts`)
* [x] T003 \[S2203] Inspect current home transform, `useHomeData`, home route mount points, and v2.3 Dream source strip reference (`src/lib/home-transforms.ts`)

***

## Foundation (5 tasks)

Core structures and base implementations.

* [x] T004 \[S2203] Add Dream source tile status/data types for all seven fixed source categories (`src/components/home/types.ts`)
* [x] T005 \[S2203] Implement pure Dream source derivation with finite counts, deterministic ordering, and safe detail strings (`src/lib/home-transforms.ts`)
* [x] T006 \[S2203] \[P] Add home-transform tests for fully live, partially missing, no Antigravity, no Hermes, and example-data states (`src/lib/__tests__/home-transforms.test.ts`)
* [x] T007 \[S2203] \[P] Add Dream source strip component test harness for source count, status pills, and toggle behavior (`src/components/home/__tests__/dream-sources-strip.test.tsx`)
* [x] T008 \[S2203] \[P] Add Hermes setup default-path regression coverage while preserving detected/missing state assertions (`src/routes/__tests__/setup-modal.test.tsx`)

***

## Implementation (6 tasks)

Main feature implementation.

* [x] T009 \[S2203] Update the Hermes Agent setup card default path to `~/.hermes/hermes-agent` with detection-path precedence and revalidation on setup re-entry (`src/components/setup/constants.ts`)
* [x] T010 \[S2203] Create the Dream source strip component shell and tile renderer with explicit live, optional, missing, and example-data states (`src/components/home/dream-sources-strip.tsx`)
* [x] T011 \[S2203] Implement the strip toggle and status pill controls with platform-appropriate accessibility labels, focus management, and input support (`src/components/home/dream-sources-strip.tsx`)
* [x] T012 \[S2203] Wire derived Dream source rows into `HomeData` and `useHomeData` without route-level nested data parsing (`src/lib/use-home-data.ts`)
* [x] T013 \[S2203] Mount `DreamSourcesStrip` near `DreamHero` on the home dashboard while preserving existing Dream and Hermes surfaces (`src/routes/index.tsx`)
* [x] T014 \[S2203] Verify rendered source details use selector-provided safe labels/counts only and never raw paths, prompts, transcripts, or credential material (`src/components/home/dream-sources-strip.tsx`)

***

## Testing (3 tasks)

Verification and quality assurance.

* [x] T015 \[S2203] Run focused setup, transform, and Dream source strip tests and fix regressions (`package.json`)
* [x] T016 \[S2203] Run app typecheck and fix type regressions from the new home data contract (`tsconfig.json`)
* [x] T017 \[S2203] Validate ASCII encoding and record implementation notes before validate handoff (`.spec_system/specs/phase22-session03-setup-wizard-dream-sources-strip/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] 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/phase22-session03-setup-wizard-dream-sources-strip/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.
