> For the complete documentation index, see [llms.txt](https://faction-os.gitbook.io/faction-os-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase23-session07-scanner-and-golden-age-states/tasks.md). # Task Checklist **Session ID**: `phase23-session07-scanner-and-golden-age-states` **Total Tasks**: 22 **Estimated Duration**: 3-4 hours **Created**: 2026-07-05 *** Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID. *** ## Setup (3 tasks) * [x] T001 \[S2307] Verify analyzer state, Phase 23 prerequisites, and Session 07 scope (`.spec_system/PRD/phase_23/session_07_scanner_and_golden_age_states.md`) * [x] T002 \[S2307] Inspect existing Quest Board scan status, projection reducer, and battlefield state anchors (`apps/web/src/lib/questBoardModel.ts`) * [x] T003 \[S2307] Prepare Battlefield test fixture helpers for scan status, canonical snapshots, zero heroes, and mock mode (`apps/web/tests/Battlefield.test.tsx`) *** ## Foundation (5 tasks) * [x] T004 \[S2307] \[P] Create a typed battlefield scanner-state classifier with exhaustive scan-status handling (`apps/web/src/lib/battlefieldScannerState.ts`) * [x] T005 \[S2307] Add pure scanner-state classification tests for clean, not-run, running, failed, Legion-present, drill, and zero-hero branches (`apps/web/tests/battlefieldScannerState.test.ts`) * [x] T006 \[S2307] \[P] Add failed-scan camp preservation logic while keeping successful clean snapshots authoritative (`apps/web/src/lib/gameProjection.ts`) * [x] T007 \[S2307] Add reducer regression coverage for failed scan preservation and successful clean snapshot clearing (`apps/web/tests/gameProjection.test.ts`) * [x] T008 \[S2307] Extend Battlefield fixtures to seed Quest Board scan display, canonical snapshot state, projection camps, and settings mock state (`apps/web/tests/Battlefield.test.tsx`) *** ## Implementation (8 tasks) * [x] T009 \[S2307] Create the scanner state presentation layer with stable test ids and product-facing copy (`apps/web/src/components/battlefield/ScannerStateLayer.tsx`) * [x] T010 \[S2307] Implement Dispatch Scouts running-state and reduced-motion static badge rendering (`apps/web/src/components/battlefield/ScannerStateLayer.tsx`) * [x] T011 \[S2307] Wire short-lived scouts-dispatched transition state with cleanup on scope exit (`apps/web/src/components/battlefield/Battlefield.tsx`) * [x] T012 \[S2307] Integrate scanner-state derivation from Quest Board state, ranked camps, visible heroes, and mock setting (`apps/web/src/components/battlefield/Battlefield.tsx`) * [x] T013 \[S2307] Render Golden Age and scan-not-run treatments without scanner configuration or diagnostics (`apps/web/src/components/battlefield/ScannerStateLayer.tsx`) * [x] T014 \[S2307] Render failed-scan treatment without camp clearing or enemy-progress copy (`apps/web/src/components/battlefield/ScannerStateLayer.tsx`) * [x] T015 \[S2307] Render mock drill labeling for visible camps and zero-hero neutral copy (`apps/web/src/components/battlefield/ScannerStateLayer.tsx`) * [x] T016 \[S2307] Add scanner, scout, Golden Age, failed-scan, drill, and reduced-motion styles (`apps/web/src/index.css`) *** ## Testing (6 tasks) * [x] T017 \[S2307] Add Battlefield tests for Golden Age and scan-not-run behavior (`apps/web/tests/Battlefield.test.tsx`) * [x] T018 \[S2307] Add Battlefield tests for running scouts, failed scans preserving existing camps, and reduced-motion scout badge behavior (`apps/web/tests/Battlefield.test.tsx`) * [x] T019 \[S2307] Add Battlefield tests for zero-hero neutrality and mock drill labeling (`apps/web/tests/Battlefield.test.tsx`) * [x] T020 \[S2307] Run focused Vitest coverage for scanner state, Battlefield, and projection reducer behavior (`npm test -- apps/web/tests/battlefieldScannerState.test.ts apps/web/tests/Battlefield.test.tsx apps/web/tests/gameProjection.test.ts`) * [x] T021 \[S2307] Run web package typecheck (`npm --workspace @factionos/web run typecheck`) * [x] T022 \[S2307] Run formatting plus ASCII/LF validation for touched files (`npm run format:check`) *** ## 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` (next step in the implement -> creview -> validate sequence) *** ## 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://faction-os.gitbook.io/faction-os-docs/.spec_system/archive/sessions/phase23-session07-scanner-and-golden-age-states/tasks.md?ask=&goal= ``` `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.