Rework story engine flow and reorganize project docs

src/data/stateFunctions.ts

@@ -3,7 +3,7 @@ import {
   FunctionCategory,
   PlayerStateMode,
   SceneDirective,
-  SceneMonster,
+  SceneHostileNpc,
   SkillStyle,
   StoryOption,
   WorldType,
@@ -73,7 +73,7 @@ export interface FunctionAvailabilityContext {
   inBattle: boolean;
   currentSceneId?: string | null;
   currentSceneName?: string | null;
-  monsters: SceneMonster[];
+  monsters: SceneHostileNpc[];
   playerHp: number;
   playerMaxHp: number;
   playerMana: number;
@@ -185,7 +185,7 @@ export function buildStateFunctionDefinitions(
 
 const ALL_FUNCTIONS = buildStateFunctionDefinitions();
 
-function hasAliveMonsters(monsters: SceneMonster[]) {
+function hasAliveMonsters(monsters: SceneHostileNpc[]) {
   return monsters.some((monster) => monster.hp > 0);
 }