> 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/phase36-session07-adaptive-stinger-pack/tasks.md).

# Task Checklist

**Session ID**: `phase36-session07-adaptive-stinger-pack` **Total Tasks**: 20 **Estimated Duration**: 3-4 hours **Created**: 2026-06-28

***

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 \[S3607] Verify completed Session 06 adaptive contract, current SFX asset inventory, generation prerequisites, and media policy before adding stingers (`.spec_system/PRD/phase_36/session_07_adaptive_stinger_pack.md`)
* [x] T002 \[S3607] Inspect adaptive profile mapping, renderer duplicate-suppression paths, audio tests, browser proof, and provenance structure for Session 07 insertion points (`src/extensions/ai-rogue/runtime/audio.ts`)
* [x] T003 \[S3607] Create implementation notes for generation choices, prompt decisions, browser review, validation commands, caveats, and Session 08 handoff (`.spec_system/specs/phase36-session07-adaptive-stinger-pack/implementation-notes.md`)

***

## Foundation (5 tasks)

* [x] T004 \[S3607] Add seven adaptive stinger cue definitions to the existing SFX generation script with short restrained prompts and no voice, music, or melody constraints (`scripts/generate-ai-rogue-audio-sfx.ts`)
* [x] T005 \[S3607] Generate or import approved raw masters and encode committed mono 48 kHz Ogg Opus stingers 58-64 with timeout, retry/backoff, and failure-path handling for external generation (`src/assets/ai-rogue/audio/sfx/58_stinger_combat_start.ogg`)
* [x] T006 \[S3607] Update SFX provenance for every committed stinger with prompt, request, raw-response, render, byte-count, duration, codec, channel, and sample-rate metadata (`src/assets/ai-rogue/audio/sfx/provenance.json`)
* [x] T007 \[S3607] Extend the audio cue type contract with dedicated stinger IDs and exhaustive type coverage (`src/extensions/ai-rogue/runtime/types-simulation.ts`)
* [x] T008 \[S3607] Register stinger file basenames in the audio engine SFX lookup with missing-URL and decode-failure fallback preserved (`src/extensions/ai-rogue/runtime/audio.ts`)

***

## Implementation (6 tasks)

* [x] T009 \[S3607] Map each adaptive request profile to its dedicated stinger cue with conservative volume, existing cooldowns, and bounded music/theme ducking (`src/extensions/ai-rogue/runtime/audio.ts`)
* [x] T010 \[S3607] Update adaptive request duplicate-suppression rules so dedicated objective, final-defense, victory, and defeat stingers play once while old provisional duplicates remain prevented (`src/extensions/ai-rogue/runtime/renderer-audio-adapter.ts`)
* [x] T011 \[S3607] Preserve heartbeat, theme ambience, depth music, terminal music, one-shot SFX, mute, volume, autoplay unlock, lazy decode, and silent fallback behavior while stingers run (`src/extensions/ai-rogue/runtime/audio.ts`)
* [x] T012 \[S3607] Update desktop and mobile browser proof constants and assertions for all seven dedicated stinger basenames with explicit loading, failed-request, and page-error checks (`tests/e2e/ai-rogue-runtime.spec.ts`)
* [x] T013 \[S3607] Update durable AI Rogue audio docs and README summary with the shipped stinger pack, asset policy fit, fallback behavior, and Session 08 human-listening scope (`docs/extensions/ai-rogue/game-feel.md`)
* [x] T014 \[S3607] Update the Phase 36 Session 07 stub with delivered assets, runtime wiring, validation evidence, review caveats, and Session 08 handoff notes (`.spec_system/PRD/phase_36/session_07_adaptive_stinger_pack.md`)

***

## Testing (6 tasks)

* [x] T015 \[S3607] \[P] Add focused audio-engine tests for dedicated stinger URL selection, cooldowns, ducking schedules, mute/volume interaction, failed fetch/decode, and dispose-before-decode cleanup (`src/extensions/ai-rogue/runtime/__tests__/audio.test.ts`)
* [x] T016 \[S3607] \[P] Add renderer-adapter tests for all seven adaptive moments, no-repeat transitions, and dedicated-stinger playback after provisional duplicate suppression changes (`src/extensions/ai-rogue/runtime/__tests__/renderer-audio-adapter.test.ts`)
* [x] T017 \[S3607] \[P] Run focused audio, adapter, and affected combat/protocol/objective tests after implementation (`src/extensions/ai-rogue/runtime/__tests__/audio.test.ts`)
* [x] T018 \[S3607] Run desktop and mobile browser audio proof with stinger fetch/source-start assertions, silent fallback, no failed Ogg requests, and product-surface copy checks (`tests/e2e/ai-rogue-runtime.spec.ts`)
* [x] T019 \[S3607] Run typecheck, lint if touched code needs it, asset-size validation, and focused ASCII/LF checks for changed text artifacts (`package.json`)
* [x] T020 \[S3607] Complete runtime review notes for repeated triggers, volume interaction, load/decode recovery, no product debug UI, and update implementation notes with commands and evidence (`.spec_system/specs/phase36-session07-adaptive-stinger-pack/implementation-notes.md`)

***

## 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 continue 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://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/sessions/phase36-session07-adaptive-stinger-pack/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.
