> 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/phase37-session04-g3-theme-decals/tasks.md).

# Task Checklist

**Session ID**: `phase37-session04-g3-theme-decals` **Total Tasks**: 22 **Estimated Duration**: 3-4 hours **Created**: 2026-06-29

***

Legend: `[x]` completed; `[ ]` pending; `[P]` parallelizable; `[SNNMM]` session ref; `TNNN` task ID.

***

## Progress Summary

| Metric              | Value   |
| ------------------- | ------- |
| Tasks Completed     | 22 / 22 |
| Estimated Remaining | 0 hours |
| Blockers            | 0       |

***

## Setup (3 tasks)

* [x] T001 \[S3704] Verify G3 source, alpha derivative, current crop manifest, gameplay/UI atlas outputs, docs preview, and packer prerequisites before edits (`docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/source/ai-rogue-sector-themes-source.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/alpha/ai-rogue-sector-themes-alpha.png`, `docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/crop-manifest.json`, `src/assets/ai-rogue/gameplay-atlas.json`, `src/assets/ai-rogue/ui-atlas.json`, `scripts/extensions/ai-rogue/pack-visual-assets.py`)
* [x] T002 \[S3704] Create the G3 implementation ledger with candidate review, manifest decisions, validation commands, desktop/mobile evidence, and no-text-safe review sections (`.spec_system/specs/phase37-session04-g3-theme-decals/implementation-notes.md`)
* [x] T003 \[S3704] Baseline current theme, world-generation, render-model, renderer-layer, atlas count, and browser scenario behavior before modifying assets (`src/extensions/ai-rogue/runtime/themes.ts`, `src/extensions/ai-rogue/runtime/world-generator.ts`, `src/extensions/ai-rogue/runtime/render-model.ts`, `src/extensions/ai-rogue/runtime/renderer-layers.ts`, `src/extensions/ai-rogue/runtime/__tests__/themes.test.ts`, `tests/e2e/ai-rogue-runtime.spec.ts`)

***

## Foundation (5 tasks)

* [x] T004 \[S3704] Extend accepted and rejected G3 crop decisions for Cold Cache coolant/frost marks, Corrupted Index cracks/debris, Firewall vents/ember conduits, Model Vault slabs/lock motifs, and Kernel Core floors/ribs with no-baked-text review (`docs/ongoing-projects/generated/ai-rogue-visual-audio-assets/crop-manifest.json`)
* [x] T005 \[S3704] Run the visual packer and refresh gameplay atlas output plus the docs preview while preserving the existing UI atlas unless a scoped G3 UI need is proven (`scripts/extensions/ai-rogue/pack-visual-assets.py`, `src/assets/ai-rogue/gameplay-atlas.png`, `src/assets/ai-rogue/gameplay-atlas.json`, `src/assets/ai-rogue/ui-atlas.png`, `src/assets/ai-rogue/ui-atlas.json`, `docs/extensions/ai-rogue/generated/ai-rogue-production-atlas-preview.png`)
* [x] T006 \[S3704] Add typed G3 theme tile/decal frame-name unions, frame-name arrays, and required gameplay-frame contracts with types matching declared contracts; exhaustive enum handling (`src/extensions/ai-rogue/runtime/types-assets.ts`, `src/extensions/ai-rogue/runtime/assets.ts`)
* [x] T007 \[S3704] Create typed sector theme visual helpers for tile variants, sparse decals, atmosphere colors, deterministic placement, and stable fallbacks (`src/extensions/ai-rogue/runtime/theme-visuals.ts`)
* [x] T008 \[S3704] Add focused theme-visual helper tests for all five sector themes, deterministic decal selection, high-contrast/reduced-motion choices, and unknown-theme fallback behavior (`src/extensions/ai-rogue/runtime/__tests__/theme-visuals.test.ts`)

***

## Implementation (9 tasks)

* [x] T009 \[S3704] Wire world-generation tile frame selection through `theme-visuals.ts` while preserving dimensions, start/exit positions, tile kinds, passability, sight blocking, hazard damage, enemy spawns, and pickup spawns (`src/extensions/ai-rogue/runtime/world-generator.ts`)
* [x] T010 \[S3704] Wire sparse G3 decal overlay sprites in the render model with deterministic ordering, visibility/exploration alpha, in-bounds sizing, and product-facing labels only (`src/extensions/ai-rogue/runtime/render-model.ts`)
* [x] T011 \[S3704] Wire theme-aware background atmosphere from `snapshot.theme` through renderer layers while preserving reduced-motion scanline behavior (`src/extensions/ai-rogue/runtime/renderer-layers.ts`, `src/extensions/ai-rogue/runtime/renderer.ts`)
* [x] T012 \[S3704] Align sector theme metadata with the new visual mapping without changing pressure, enemy tables, palette hints, or ambience routes (`src/extensions/ai-rogue/runtime/themes.ts`, `src/extensions/ai-rogue/runtime/theme-visuals.ts`)
* [x] T013 \[S3704] \[P] Update atlas contract tests for accepted G3 frames, post-pack gameplay atlas counts, required-frame lists, and TexturePacker metadata (`src/extensions/ai-rogue/runtime/__tests__/assets.test.ts`)
* [x] T014 \[S3704] \[P] Update theme tests proving every sector theme resolves stable visual metadata alongside existing pressure and ambience contracts (`src/extensions/ai-rogue/runtime/__tests__/themes.test.ts`)
* [x] T015 \[S3704] \[P] Update world-generation tests proving seeded worlds keep rule-relevant structure stable while frame names vary by sector theme (`src/extensions/ai-rogue/runtime/__tests__/world.test.ts`)
* [x] T016 \[S3704] \[P] Update render-model tests for theme tile variants, decal overlays, z-ordering, high-contrast behavior, reduced-motion behavior, and product-facing sprite labels (`src/extensions/ai-rogue/runtime/__tests__/render-model.test.ts`)
* [x] T017 \[S3704] \[P] Update biome/final-depth tests proving theme pressure, Kernel Core final-depth behavior, and final-defense presentation remain stable after G3 visual wiring (`src/extensions/ai-rogue/runtime/__tests__/biome-final.test.ts`)

***

## Testing (5 tasks)

* [x] T018 \[S3704] Run the packer, typecheck, and asset-size validation and record command results (`scripts/extensions/ai-rogue/pack-visual-assets.py`, `bun run typecheck`, `scripts/check-asset-sizes.sh`)
* [x] T019 \[S3704] Run focused Vitest suites for assets, theme-visuals, themes, world, render-model, and biome-final behavior touched by G3 changes (`src/extensions/ai-rogue/runtime/__tests__/assets.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/theme-visuals.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/themes.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/world.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/render-model.test.ts`, `src/extensions/ai-rogue/runtime/__tests__/biome-final.test.ts`)
* [x] T020 \[S3704] Run desktop AI Rogue browser proof for all five sector themes with distinct in-bounds G3 visuals, product-facing copy only, and no route-visible diagnostics (`tests/e2e/ai-rogue-runtime.spec.ts`)
* [x] T021 \[S3704] Run mobile AI Rogue browser proof for theme readability, compact input, no horizontal overflow, no layout overlap, and normal recovery/control paths (`tests/e2e/ai-rogue-mobile.spec.ts`)
* [x] T022 \[S3704] Update visual asset documentation and validate ASCII, LF line endings, diff whitespace, and completion notes before handoff (`docs/extensions/ai-rogue/visual-assets.md`, `git diff --check`, `.spec_system/specs/phase37-session04-g3-theme-decals/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 `implement` 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/phase37-session04-g3-theme-decals/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.