> 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/phase28-session03-calibration-version-and-confidence-dampener/tasks.md).

# Task Checklist

**Session ID**: `phase28-session03-calibration-version-and-confidence-dampener` **Total Tasks**: 23 **Estimated Duration**: 3-4 hours **Created**: 2026-06-14

***

## 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     | 6      | 6      | 0         |
| Implementation | 9      | 9      | 0         |
| Testing        | 5      | 5      | 0         |
| **Total**      | **23** | **23** | **0**     |

***

## Setup (3 tasks)

Initial configuration and environment preparation.

* [x] T001 \[S2803] Verify Session 01 and Session 02 validation artifacts before consuming dedup, quality, and collection-health fields (`.spec_system/specs/phase28-session02-signal-quality-score-and-collection-health/validation.md`)
* [x] T002 \[S2803] Inspect Trends-Finderz scoring-version and confidence-dampener references for bounded local adaptation (`EXAMPLES/trends-finderz/lib/scoring/trend-score.ts`)
* [x] T003 \[S2803] Inspect current scoring, snapshot, movement, prediction, retro, schema, and score-breakdown contracts before editing (`scripts/lib/ai-runtime/scoring.ts`)

***

## Foundation (6 tasks)

Core structures and base implementations.

* [x] T004 \[S2803] \[P] Define `SCORING_VERSION`, unknown-version defaults, and pure confidence-calibration helpers with bounded inputs and exhaustive edge handling (`scripts/lib/ai-runtime/scoring.ts`)
* [x] T005 \[S2803] \[P] Add additive topic, movement, prediction, retro, and comparison schemas with legacy defaults and exhaustive enum handling (`src/extensions/trend-finder/schema.ts`)
* [x] T006 \[S2803] Extend snapshot contracts with scoring-version fields, `unknown` parsing, and comparison metadata defaults (`scripts/lib/ai-runtime/snapshots.ts`)
* [x] T007 \[S2803] Extend prediction and retro record contracts with trusted local scoring-version fields and sanitized defaults (`scripts/lib/ai-runtime/predictions.ts`)
* [x] T008 \[S2803] Extend movement analyst input/output contracts with current/previous scoring-version comparison fields and local provenance notes (`scripts/lib/ai-runtime/movement-analyst.ts`)
* [x] T009 \[S2803] Add score-confidence and scoring-version warning view-model labels with compact empty, unknown, mismatch, and current-version states (`src/extensions/trend-finder/view-model.ts`)

***

## Implementation (9 tasks)

Main feature implementation.

* [x] T010 \[S2803] Apply sample-confidence derivation and bounded dampener to final opportunity scoring with no six-factor weight changes and no low-confidence score inflation (`scripts/lib/ai-runtime/scoring.ts`)
* [x] T011 \[S2803] Stamp scoring version into collected topics, snapshot writes, previous-snapshot projections, and browser payloads with schema-validated input and explicit error mapping (`scripts/extensions/trend-finder/collector.ts`)
* [x] T012 \[S2803] Stamp deterministic and sanitized AI prediction records with the local scoring version while preventing AI-provided version override (`scripts/lib/ai-runtime/predictions.ts`)
* [x] T013 \[S2803] Flag movement comparisons across different or unknown versions without suppressing movement status or evidence summaries (`scripts/lib/ai-runtime/movement-analyst.ts`)
* [x] T014 \[S2803] Flag retro comparisons across prediction/current scoring versions while preserving target-date due-state and pending behavior (`scripts/lib/ai-runtime/retros.ts`)
* [x] T015 \[S2803] Pass scoring-version metadata through prediction/retro pipeline inputs, archives, story-log projection, and warnings with browser-safe bounded labels (`scripts/extensions/trend-finder/collector.ts`)
* [x] T016 \[S2803] Render sample-confidence value and dampener context in the score breakdown with accessible labels and stable compact layout (`src/extensions/trend-finder/components/score-breakdown.tsx`)
* [x] T017 \[S2803] Render scoring-version mismatch or unknown-version provenance in Engine Replay score context without exposing archive paths or raw payloads (`src/extensions/trend-finder/components/engine-score-panel.tsx`)
* [x] T018 \[S2803] Preserve legacy payload, snapshot, prediction, and retro parsing with `unknown` version fallbacks and no crash paths (`src/extensions/trend-finder/schema.ts`)

***

## Testing (5 tasks)

Verification and quality assurance.

* [x] T019 \[S2803] \[P] Add scoring calibration tests for version constants, confidence derivation, dampener bounds, raw/adjusted score metadata, and thin-vs-strong evidence behavior (`scripts/lib/ai-runtime/__tests__/scoring-calibration.test.ts`)
* [x] T020 \[S2803] \[P] Add snapshot and movement tests for version stamping, legacy unknown parsing, cross-version flags, and unsuppressed movement statuses (`scripts/lib/ai-runtime/__tests__/movement-analyst.test.ts`)
* [x] T021 \[S2803] \[P] Add prediction and retro tests for local version stamping, AI-output sanitation, cross-version retro flags, and due-state preservation (`scripts/lib/ai-runtime/__tests__/retros.test.ts`)
* [x] T022 \[S2803] \[P] Add collector, schema, view-model, and component tests for payload stamping, confidence labels, mismatch labels, legacy defaults, and browser-safe output (`scripts/extensions/trend-finder/__tests__/collector.test.ts`)
* [x] T023 \[S2803] Run focused Vitest suites, `bun run typecheck:scripts`, and ASCII/LF validation for all session artifacts (`package.json`)

***

## 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 validate workflow step to verify session completeness.


---

# 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/phase28-session03-calibration-version-and-confidence-dampener/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.