> 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/phase27-session07-convergence-detection-and-trajectory-visuals/tasks.md).

# Task Checklist

**Session ID**: `phase27-session07-convergence-detection-and-trajectory-visuals` **Total Tasks**: 21 **Estimated Duration**: 3-4 hours **Created**: 2026-06-13

***

## 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          | 2      | 2      | 0         |
| Foundation     | 6      | 6      | 0         |
| Implementation | 8      | 8      | 0         |
| Testing        | 5      | 5      | 0         |
| **Total**      | **21** | **21** | **0**     |

***

## Setup (2 tasks)

Initial verification and source orientation.

* [x] T001 \[S2707] Verify analyzer state, Session 04 and Session 06 completion, and convergence PRD scope (`.spec_system/specs/phase27-session07-convergence-detection-and-trajectory-visuals/implementation-notes.md`)
* [x] T002 \[S2707] Inspect collector, scoring, historical context, schema, view-model, Signal Radar, evidence, and fixture baselines (`.spec_system/specs/phase27-session07-convergence-detection-and-trajectory-visuals/implementation-notes.md`)

***

## Foundation (6 tasks)

Core convergence and trajectory contracts.

* [x] T003 \[S2707] \[P] Create pure convergence helper with timestamp normalization, source first-seen extraction, 48-hour window detection, stable ordering, and explicit unavailable states (`scripts/lib/ai-runtime/convergence.ts`)
* [x] T004 \[S2707] \[P] Add convergence helper unit tests for window edges, missing timestamps, duplicate evidence IDs, single-source topics, and deterministic ordering (`scripts/lib/ai-runtime/__tests__/convergence.test.ts`)
* [x] T005 \[S2707] Extend scoring output with bounded actual score trajectory points from historical context and current score, without publishing extrapolated estimates (`scripts/lib/ai-runtime/scoring.ts`)
* [x] T006 \[S2707] Add bounded convergence and score trajectory schemas, defaults, topic fields, and exhaustive enum handling with schema-validated input and explicit error mapping (`src/extensions/trend-finder/schema.ts`)
* [x] T007 \[S2707] Add convergence and trajectory view-model projections with lag labels, SVG points, explicit empty states, and accessibility text (`src/extensions/trend-finder/view-model.ts`)
* [x] T008 \[S2707] \[P] Add detected, not-detected, unavailable, single-source, and missing-history fixture states for browser and UI coverage (`src/extensions/trend-finder/fixtures.ts`)

***

## Implementation (8 tasks)

Collector wiring and selected-topic UI.

* [x] T009 \[S2707] Attach convergence to final collector topics after source breakdown enrichment with timeout-free deterministic derivation (`scripts/extensions/trend-finder/collector.ts`)
* [x] T010 \[S2707] Emit sanitized convergence and trajectory counters in Engine Replay trace context without private paths, raw timestamps beyond browser payload, or source payload details (`scripts/extensions/trend-finder/collector.ts`)
* [x] T011 \[S2707] \[P] Create convergence timeline component with detected, not-detected, single-source, unavailable, and empty states plus stable dimensions and platform-appropriate accessibility labels (`src/extensions/trend-finder/components/convergence-timeline.tsx`)
* [x] T012 \[S2707] \[P] Create score trajectory component with fixed SVG dimensions, actual-point labels, and visibly labeled slope extrapolation (`src/extensions/trend-finder/components/score-trajectory.tsx`)
* [x] T013 \[S2707] Wire convergence timeline and score trajectory into the selected-topic Signal Radar inspector with state reset or revalidation on selected topic changes (`src/extensions/trend-finder/components/signal-radar.tsx`)
* [x] T014 \[S2707] Update committed example payload with compact convergence and trajectory examples while preserving browser-safe additive defaults (`src/data/live-data.example.json`)
* [x] T015 \[S2707] Extend collector tests for convergence attachment, missing timestamp warnings, single-source states, and sanitized trace counters (`scripts/extensions/trend-finder/__tests__/collector.test.ts`)
* [x] T016 \[S2707] Extend scoring tests for trajectory bounds, current-score inclusion, missing-history fallback, and absence of forecast point estimates (`scripts/lib/ai-runtime/__tests__/scoring.test.ts`)

***

## Testing (5 tasks)

Verification and quality assurance.

* [x] T017 \[S2707] Extend schema tests for convergence and trajectory defaults, malformed branches, max-array bounds, and legacy payload parsing (`src/lib/__tests__/trend-finder-schema.test.ts`)
* [x] T018 \[S2707] Extend view-model tests for convergence lag labels, lead role copy, trajectory SVG points, missing-history states, and extrapolation labels (`src/extensions/trend-finder/__tests__/view-model.test.ts`)
* [x] T019 \[S2707] \[P] Add component tests for timeline rendering, empty states, ARIA labels, and mobile-safe text behavior (`src/extensions/trend-finder/components/__tests__/convergence-timeline.test.tsx`)
* [x] T020 \[S2707] \[P] Add component tests for score trajectory rendering, actual-point labels, missing-history state, and extrapolation labeling (`src/extensions/trend-finder/components/__tests__/score-trajectory.test.tsx`)
* [x] T021 \[S2707] Run focused validation, ASCII checks, payload budget check, and record implementation results (`.spec_system/specs/phase27-session07-convergence-detection-and-trajectory-visuals/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/phase27-session07-convergence-detection-and-trajectory-visuals/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.