Rework story engine flow and reorganize project docs

src/hooks/useGameFlow.ts

@@ -14,6 +14,7 @@ import { buildInitialNpcState, buildInitialPlayerInventory } from '../data/npcIn
 import { createInitialGameRuntimeStats } from '../data/runtimeStats';
 import { ensureSceneEncounterPreview,RESOLVED_ENTITY_X_METERS } from '../data/sceneEncounterPreviews';
 import { getScenePreset,getWorldCampScenePreset } from '../data/scenePresets';
+import { createEmptyStoryEngineMemoryState } from '../services/storyEngine/visibilityEngine';
 import { AnimationState, Character, CustomWorldProfile, Encounter, GameState, SceneNpc, WorldType } from '../types';
 import type { BottomTab } from '../types/navigation';
 
@@ -58,6 +59,11 @@ function createInitialGameState(): GameState {
     runtimeStats: createInitialGameRuntimeStats(),
     currentScene: 'Selection',
     storyHistory: [],
+    storyEngineMemory: createEmptyStoryEngineMemoryState(),
+    chapterState: null,
+    campaignState: null,
+    activeScenarioPackId: null,
+    activeCampaignPackId: null,
     characterChats: {},
     lastObserveSignsSceneId: null,
     lastObserveSignsReport: null,
@@ -65,7 +71,7 @@ function createInitialGameState(): GameState {
     currentEncounter: null,
     npcInteractionActive: false,
     currentScenePreset: null,
-    sceneMonsters: [],
+    sceneHostileNpcs: [],
     playerX: 0,
     playerOffsetY: 0,
     playerFacing: 'right',
@@ -128,9 +134,14 @@ export function useGameFlow() {
         worldType: resolvedWorldType,
         customWorldProfile,
         currentScenePreset: initialScenePreset,
-        sceneMonsters: [],
+        sceneHostileNpcs: [],
         currentEncounter: null,
         npcInteractionActive: false,
+        storyEngineMemory: createEmptyStoryEngineMemoryState(),
+        chapterState: null,
+        campaignState: null,
+        activeScenarioPackId: customWorldProfile?.scenarioPackId ?? null,
+        activeCampaignPackId: customWorldProfile?.campaignPackId ?? null,
         lastObserveSignsSceneId: null,
         lastObserveSignsReport: null,
         playerActionMode: 'idle',
@@ -178,16 +189,21 @@ export function useGameFlow() {
           ...prev,
           playerCharacter: character,
           runtimeStats: createInitialGameRuntimeStats({ isActiveRun: true }),
-          currentScene: 'Story',
-          storyHistory: [],
-          characterChats: {},
+           currentScene: 'Story',
+           storyHistory: [],
+           storyEngineMemory: createEmptyStoryEngineMemoryState(),
+           chapterState: null,
+           campaignState: null,
+           activeScenarioPackId: gameState.customWorldProfile?.scenarioPackId ?? null,
+           activeCampaignPackId: gameState.customWorldProfile?.campaignPackId ?? null,
+           characterChats: {},
           currentEncounter: initialEncounter,
           npcInteractionActive: false,
           currentScenePreset: initialScenePreset,
           lastObserveSignsSceneId: null,
           lastObserveSignsReport: null,
           animationState: AnimationState.IDLE,
-          sceneMonsters: [],
+          sceneHostileNpcs: [],
           playerX: 0,
           playerOffsetY: 0,
           playerFacing: 'right',