feat: update residence learning flows

Commit non-media application and asset changes while leaving audio, video, and environment files out of version control.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

src/config/progression.ts

@@ -3,6 +3,15 @@ import { PUZZLE_RESIDENCES } from './puzzleResidences'
 
 export type PuzzleProgress = Record<string, Set<number>>
 
+const BUILD_UNLOCK_ALL = import.meta.env.VITE_PROGRESS_UNLOCK_ALL === 'true'
+const UNLOCK_ALL_STORAGE_KEY = 'debug:progression-unlock-all'
+
+const isUnlockAllEnabled = () => {
+  if (!BUILD_UNLOCK_ALL) return false
+  if (typeof window === 'undefined') return true
+  return window.sessionStorage.getItem(UNLOCK_ALL_STORAGE_KEY) !== 'false'
+}
+
 const getResidenceIndex = (residence: string) =>
   PUZZLE_RESIDENCES.findIndex((item) => item.residence === residence)
 
@@ -24,10 +33,13 @@ export const isResidenceStarted = (residence: string, puzzles: PuzzleProgress) =
 }
 
 export const isResidenceComplete = (residence: string, puzzles: PuzzleProgress) => {
+  if (isUnlockAllEnabled()) return true
   return arePiecesUnlocked(residence, puzzles, getConfiguredPieceIds(residence))
 }
 
 export const isResidenceUnlocked = (residence: string, puzzles: PuzzleProgress) => {
+  if (isUnlockAllEnabled()) return true
+
   const index = getResidenceIndex(residence)
   if (index === 0) return true
   if (index < 0) return false
@@ -50,6 +62,8 @@ export const isMenuModuleStarted = (moduleName: string, puzzles: PuzzleProgress)
 }
 
 export const isMenuModuleComplete = (moduleName: string, puzzles: PuzzleProgress) => {
+  if (isUnlockAllEnabled()) return true
+
   const residences = PUZZLE_RESIDENCES.filter((item) => item.moduleName === moduleName)
   if (residences.length === 0) return false
   return residences.every((item) => isResidenceComplete(item.residence, puzzles))
@@ -65,6 +79,14 @@ const getPieceIdsByRoute = (residence: string, routePrefix: string) => {
 }
 
 export const getResidenceStageUnlocks = (residence: string, puzzles: PuzzleProgress) => {
+  if (isUnlockAllEnabled()) {
+    return {
+      dialogueUnlocked: true,
+      reflectionUnlocked: true,
+      internalizationUnlocked: true,
+    }
+  }
+
   const residenceUnlocked = isResidenceUnlocked(residence, puzzles)
 
   return {