Rework story engine flow and reorganize project docs

src/hooks/story/choiceActions.test.ts

@@ -62,7 +62,6 @@ function createBaseState(): GameState {
     currentEncounter: null,
     npcInteractionActive: false,
     currentScenePreset: null,
-    sceneMonsters: [],
     sceneHostileNpcs: [],
     playerX: 0,
     playerOffsetY: 0,
@@ -140,7 +139,6 @@ describe('createStoryChoiceActions', () => {
     const afterSequence = {
       ...state,
       inBattle: false,
-      sceneMonsters: [],
       sceneHostileNpcs: [],
       currentNpcBattleOutcome: 'fight_victory' as const,
     };
@@ -179,7 +177,7 @@ describe('createStoryChoiceActions', () => {
       generateStoryForState,
       getAvailableOptionsForState: vi.fn(() => null),
       getStoryGenerationHostileNpcs: vi.fn(() => []),
-      getResolvedSceneHostileNpcs: vi.fn((inputState: GameState) => inputState.sceneMonsters),
+      getResolvedSceneHostileNpcs: vi.fn((inputState: GameState) => inputState.sceneHostileNpcs),
       buildNpcStory: vi.fn(() => createFallbackStory()),
       updateQuestLog: vi.fn((inputState: GameState) => inputState),
       incrementRuntimeStats: vi.fn((inputState: GameState) => inputState),
@@ -233,7 +231,7 @@ describe('createStoryChoiceActions', () => {
       ...createBaseState(),
       currentBattleNpcId: null,
       currentNpcBattleMode: null,
-      sceneMonsters: [
+      sceneHostileNpcs: [
         {
           id: 'wolf-1',
           name: '山狼',
@@ -289,7 +287,7 @@ describe('createStoryChoiceActions', () => {
       generateStoryForState: vi.fn(),
       getAvailableOptionsForState: vi.fn(() => null),
       getStoryGenerationHostileNpcs: vi.fn(() => []),
-      getResolvedSceneHostileNpcs: vi.fn((inputState: GameState) => inputState.sceneMonsters),
+      getResolvedSceneHostileNpcs: vi.fn((inputState: GameState) => inputState.sceneHostileNpcs),
       buildNpcStory: vi.fn(() => createFallbackStory()),
       updateQuestLog: vi.fn((inputState: GameState) => inputState),
       incrementRuntimeStats: vi.fn((inputState: GameState) => inputState),