Rework story engine flow and reorganize project docs

src/services/runtimeItemAiDirector.ts

@@ -1,9 +1,9 @@
+import {buildRuntimeItemAiIntent} from '../data/runtimeItemNarrative';
 import type {
   RuntimeItemAiIntent,
   RuntimeItemGenerationContext,
   RuntimeItemPlan,
 } from '../types';
-import {buildRuntimeItemAiIntent} from '../data/runtimeItemNarrative';
 import {requestChatMessageContent} from './llmClient';
 import {parseJsonResponseText} from './llmParsers';
 import {
@@ -64,6 +64,19 @@ function sanitizeRuntimeItemAiIntent(
     tone: ['grim', 'mysterious', 'martial', 'ritual', 'survival'].includes(tone)
       ? (tone as RuntimeItemAiIntent['tone'])
       : fallback.tone,
+    visibleClue: coerceString(intent.visibleClue, fallback.visibleClue ?? ''),
+    witnessMark: coerceString(intent.witnessMark, fallback.witnessMark ?? ''),
+    unfinishedBusiness: coerceString(
+      intent.unfinishedBusiness,
+      fallback.unfinishedBusiness ?? '',
+    ),
+    hiddenHook: coerceString(intent.hiddenHook, fallback.hiddenHook ?? ''),
+    reactionHooks: coerceStringArray(
+      intent.reactionHooks,
+      fallback.reactionHooks ?? [],
+      4,
+    ),
+    namingPattern: coerceString(intent.namingPattern, fallback.namingPattern ?? ''),
   };
 }