> 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/phase33-session05-polish-public-demo-ui-states/tasks.md).

# Task Checklist

**Session ID**: `phase33-session05-polish-public-demo-ui-states` **Total Tasks**: 20 **Estimated Duration**: 3-4 hours **Created**: 2026-06-25

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Progress Summary

| Metric              | Value   |
| ------------------- | ------- |
| Tasks Completed     | 20 / 20 |
| Estimated Remaining | 0 hours |
| Blockers            | 0       |

***

## Setup (3 tasks)

* [x] T001 \[S3305] Verify Phase 33 Session 01 through Session 04 completion evidence and Session 05 scope (`.spec_system/PRD/phase_33/session_05_polish_public_demo_ui_states.md`)
* [x] T002 \[S3305] Audit shared public-demo copy, Dream controls, and Trend Finder route notices for hosted-runtime claims (`src/lib/public-demo.ts`)
* [x] T003 \[S3305] Audit public-demo route matrix, sidebar route reachability, and existing focused test coverage (`scripts/lib/pages-demo-routes.ts`)

***

## Foundation (4 tasks)

* [x] T004 \[S3305] Extend shared public-demo copy for frozen Trend Finder, frozen Dream Review, disabled runtime actions, read-only setup, and browser-local controls (`src/lib/public-demo.ts`)
* [x] T005 \[S3305] Add Dream public-demo presentation branches for populated snapshot and unavailable snapshot states with product-facing copy only (`src/components/home/dream-hero.tsx`)
* [x] T006 \[S3305] Tighten Dream run public-demo button and hook semantics with duplicate-trigger prevention while in-flight and no local endpoint fetches (`src/lib/use-dream-run.ts`)
* [x] T007 \[S3305] Define stricter public-demo product-surface checks for the route matrix and navigation smoke path (`scripts/lib/pages-demo-routes.ts`)

***

## Implementation (8 tasks)

* [x] T008 \[S3305] Update Trend Finder Trends snapshot, provenance, run-control, and empty-state copy with explicit loading, empty, error, offline, and public-demo states (`src/extensions/trend-finder/views/trends-view.tsx`)
* [x] T009 \[S3305] Update Engine Replay public-demo replay, runtime-disabled, scheduler, and live-progress copy with product-facing labels only (`src/extensions/trend-finder/views/engine-replay-view.tsx`)
* [x] T010 \[S3305] Update Sources public-demo source setup and scheduler panels with read-only copy and no hosted setup/write implications (`src/extensions/trend-finder/views/sources-view.tsx`)
* [x] T011 \[S3305] Update Hidden Gems empty states and watching filters to distinguish frozen generated rows from browser-local state (`src/extensions/trend-finder/views/hidden-gems-view.tsx`)
* [x] T012 \[S3305] Update Signal Workbench triage controls and empty states so public-demo notes, tags, and visibility edits are browser-local only (`src/extensions/trend-finder/views/signal-workbench-view.tsx`)
* [x] T013 \[S3305] Update Watchlist generated-row, local pin, note, tag, and empty-state copy so browser-local state does not imply committed fixture mutation (`src/extensions/trend-finder/views/watchlist-view.tsx`)
* [x] T014 \[S3305] Update Brief frozen snapshot, export, clipboard, and unavailable copy with product-facing copy and no live-collection claims (`src/extensions/trend-finder/views/brief-view.tsx`)
* [x] T015 \[S3305] Verify and adjust sidebar/navigation labels that imply live local runtime work in public demo mode (`src/components/app-sidebar.tsx`)

***

## Testing (5 tasks)

* [x] T016 \[S3305] \[P] Add public-demo copy and Dream run unit tests for disabled controls, no token fetch, no run post, no refresh, and accessible labels (`src/lib/__tests__/public-demo.test.ts`)
* [x] T017 \[S3305] \[P] Add Dream home public-demo tests for populated snapshot and unavailable snapshot states (`src/components/home/__tests__/dream-hero.test.tsx`)
* [x] T018 \[S3305] \[P] Add Trend Finder public-demo unit tests for route labels, empty states, browser-local copy, and no local bridge calls (`src/lib/__tests__/trend-finder-dashboard.test.tsx`)
* [x] T019 \[S3305] Update Pages route registry tests and desktop/mobile route smoke expectations for the polished public-demo product surfaces (`scripts/lib/__tests__/pages-demo-routes.test.ts`)
* [x] T020 \[S3305] Run focused automated checks, Pages desktop/mobile smoke readiness checks, ASCII validation, and LF validation (`bun run test -- src/lib/__tests__/public-demo.test.ts src/lib/__tests__/use-dream-run.test.tsx src/components/__tests__/dream-run-button.test.tsx src/components/home/__tests__/dream-hero.test.tsx src/lib/__tests__/trend-finder-dashboard.test.tsx src/lib/__tests__/trend-finder-engine-replay.test.tsx src/extensions/trend-finder/components/__tests__/signal-workbench-view.test.tsx src/extensions/trend-finder/views/__tests__/brief-view.test.tsx scripts/lib/__tests__/pages-demo-routes.test.ts`)

***

## Completion Checklist

* [x] All tasks marked `[x]`
* [x] All tests and checks passing
* [x] All files ASCII-encoded with LF line endings
* [x] implementation-notes.md updated
* [x] Ready for `creview` to review and repair uncommitted implementation changes

***

## Next Steps

Run the `creview` workflow step.


---

# 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/phase33-session05-polish-public-demo-ui-states/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.