> 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/phase30-session05-persistence-and-save-contracts/tasks.md). # Task Checklist **Session ID**: `phase30-session05-persistence-and-save-contracts` **Total Tasks**: 24 **Estimated Duration**: 3-4 hours **Created**: 2026-06-22 *** ## Legend * `[x]` = Completed * `[ ]` = Pending * `[P]` = Parallelizable * `[SNNMM]` = Session reference * `TNNN` = Task ID *** ## Setup (2 tasks) * [x] T001 \[S3005] Verify Session 04 economy, claim-store, validation, and AI Rogue storage handoff assumptions (`.spec_system/specs/phase30-session04-economy-and-ledger/validation.md`) * [x] T002 \[S3005] Inventory current AI Rogue persistence entry points and test fixtures before editing (`src/extensions/ai-rogue/claim-store.ts`) *** ## Foundation (7 tasks) * [x] T003 \[S3005] \[P] Create versioned preference, wallet, ledger, run history, save metadata, and runtime snapshot schemas with defaults and migration helpers (`src/extensions/ai-rogue/save-schema.ts`) * [x] T004 \[S3005] \[P] Create browser-local persistence helpers for localStorage and IndexedDB with schema-validated input, explicit error mapping, transaction boundaries, and reset allowlists (`src/extensions/ai-rogue/persistence.ts`) * [x] T005 \[S3005] \[P] Create a React save-state hook with explicit loading, empty, error, offline, denied-storage, and reset states plus cleanup on scope exit for acquired resources (`src/extensions/ai-rogue/use-save-state.ts`) * [x] T006 \[S3005] Update extension capability types for IndexedDB reporting without changing dynamic loading behavior (`src/extensions/types.ts`) * [x] T007 \[S3005] Update AI Rogue capability declarations for localStorage preferences and IndexedDB save contracts (`src/extensions/ai-rogue/capabilities.ts`) * [x] T008 \[S3005] \[P] Add schema tests for valid, missing, stale, malformed, partial, and migrated AI Rogue save records (`src/extensions/ai-rogue/__tests__/save-schema.test.ts`) * [x] T009 \[S3005] \[P] Add persistence tests for localStorage, IndexedDB adapter errors, write transactions, reset scoping, legacy claim migration, and private-field rejection (`src/extensions/ai-rogue/__tests__/persistence.test.ts`) *** ## Implementation (9 tasks) * [x] T010 \[S3005] Bridge the Session 04 claim-store into the versioned wallet and ledger persistence path while preserving legacy redemption-key idempotency (`src/extensions/ai-rogue/claim-store.ts`) * [x] T011 \[S3005] Wire Ledger wallet and ledger persistence into manual claims with duplicate-trigger prevention while in-flight and rollback on persistence failure (`src/extensions/ai-rogue/views/ledger-view.tsx`) * [x] T012 \[S3005] Replace Settings preview controls with persistent preference controls using accessible labels, focus management, denied/restricted storage handling, and state revalidation on re-entry (`src/extensions/ai-rogue/views/settings-view.tsx`) * [x] T013 \[S3005] Add AI Rogue-only reset controls with duplicate-trigger prevention, reset allowlist messaging, transaction boundaries, and compensation on failure (`src/extensions/ai-rogue/views/settings-view.tsx`) * [x] T014 \[S3005] Wire Loadout to durable wallet, preference, and save readiness state without adding upgrade purchase behavior (`src/extensions/ai-rogue/views/loadout-view.tsx`) * [x] T015 \[S3005] Surface coarse save/load and run-history readiness in Play with explicit loading, empty, error, offline, and unavailable states (`src/extensions/ai-rogue/views/play-view.tsx`) * [x] T016 \[S3005] Emit coarse save/load/restart runtime events with reset in-flight guards and state reset on re-entry (`src/extensions/ai-rogue/views/runtime-canvas.tsx`) * [x] T017 \[S3005] Extend AI Rogue component tests for capability declarations, Ledger persistence, Settings preferences/reset, Loadout readiness, and Play save/load states (`src/extensions/ai-rogue/__tests__/client.test.tsx`) * [x] T018 \[S3005] Extend extension route tests for AI Rogue IndexedDB capability labels and persistence-state route rendering (`src/routes/__tests__/extensions-routes.test.tsx`) *** ## Testing (6 tasks) * [x] T019 \[S3005] Add hook tests for save-state loading, empty storage, denied storage, reset, duplicate-trigger prevention, and refresh behavior (`src/extensions/ai-rogue/__tests__/use-save-state.test.tsx`) * [x] T020 \[S3005] Add Playwright persistence coverage for preference refresh, claim/wallet idempotency, save/load readiness, reset scoping, and private text leakage (`tests/e2e/ai-rogue-persistence.spec.ts`) * [x] T021 \[S3005] Update Ledger Playwright coverage to assert durable wallet and ledger idempotency after refresh (`tests/e2e/ai-rogue-ledger.spec.ts`) * [x] T022 \[S3005] Run focused Vitest coverage for AI Rogue persistence, claim, client, and route behavior (`bun run test -- src/extensions/ai-rogue src/routes/__tests__/extensions-routes.test.tsx`) * [x] T023 \[S3005] Run focused browser coverage and typecheck (`bun run test:e2e -- tests/e2e/ai-rogue-ledger.spec.ts tests/e2e/ai-rogue-persistence.spec.ts && bun run typecheck`) * [x] T024 \[S3005] Validate scoped formatting, ASCII/LF, secret/privacy scans, and no generated private runtime data in session files (`session-quality-gates`) *** ## 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 the `validate` workflow step *** ## Next Steps Run the `validate` 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/phase30-session05-persistence-and-save-contracts/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.