---
id: TASK-133
title: PWA — guide engine (step sequencing + audio)
status: Done
assignee: []
created_date: '2026-03-29 20:52'
labels:
  - pwa
  - guide
milestone: m-2
dependencies: []
priority: high
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Write guide-engine.js (load/sequence/advance steps, dwell timer completion detection, onStepChange/onGuideComplete callbacks), audio-engine.js (Web Speech TTS wrapper), and guide-store.js (IndexedDB offline cache).
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [ ] #1 Guide engine normalises both canonical and on-disk JSON schemas
- [ ] #2 Dwell timer tracks continuous detection, resets on break
- [ ] #3 TTS with English voice preference and queue support
- [ ] #4 IndexedDB store with save/get/list/delete/importFromUrl
<!-- AC:END -->

## Final Summary

<!-- SECTION:FINAL_SUMMARY:BEGIN -->
guide-engine.js: dual schema normalisation, dwell timer. audio-engine.js: SpeechSynthesis with voice selection. guide-store.js: IndexedDB gaia-guides store.
<!-- SECTION:FINAL_SUMMARY:END -->