F010 - AI Analysis Methods (AutoCrit Feature Parity)

interface PacingAnalysis {
  sentenceVariation: {
    score: number; // 0-100
    averageLength: number;
    variationCoefficient: number;
    shortSentenceRatio: number; // <10 words
    longSentenceRatio: number;  // >25 words
    examples: {
      effective: string[];
      needsImprovement: string[];
    };
  };
  paragraphFlow: {
    score: number;
    averageParagraphLength: number;
    dialogueToNarrativeRatio: number;
    transitionEffectiveness: number;
    slowSections: Array<{
      location: string;
      reason: string;
      suggestion: string;
    }>;
  };
  chapterPacing: {
    score: number;
    chapterLengthConsistency: number;
    endingHooks: number;
    openingStrength: number;
    pacingVariation: number;
  };
  overallMomentum: {
    score: number;
    tensionCurve: Array<{ chapter: number; tensionLevel: number }>;
    actionSceneRatio: number;
    contemplativeSceneRatio: number;
  };
}
 
// AI Prompt Strategy for Pacing Analysis
const PACING_ANALYSIS_PROMPT = `
You are a professional manuscript editor analyzing pacing and momentum. 
 
ANALYSIS REQUIREMENTS:
1. SENTENCE VARIATION: Count tokens per sentence and evaluate variety
   - Short sentences (1-10 words): Good for impact, tension
   - Medium sentences (11-25 words): Standard narrative flow
   - Long sentences (25+ words): Description, complex ideas
   - Flag monotonous patterns
 
2. PARAGRAPH STRUCTURE: Evaluate paragraph flow and rhythm
   - Dialogue-heavy paragraphs: Fast pace
   - Description-heavy paragraphs: Slower pace
   - Action paragraphs: Dynamic pace
   - Identify paragraphs that feel sluggish
 
3. CHAPTER MOMENTUM: Assess chapter-level pacing
   - Opening hooks and closing hooks
   - Balance of action vs. contemplation
   - Scene transitions and their effectiveness
 
4. SLOW SECTION IDENTIFICATION: Find areas that drag
   - Long descriptive passages without action
   - Repetitive internal monologue
   - Lack of conflict or tension
   - Poor dialogue-to-narrative balance
 
MANUSCRIPT CONTENT: [CONTENT_HERE]
 
Provide detailed analysis with specific examples and numerical scores.
`;
 
async function analyzePacing(content: string, genre: string): Promise<PacingAnalysis> {
  const prompt = buildPacingPrompt(content, genre);
  const aiResponse = await aiService.analyze(prompt);
  
  return {
    sentenceVariation: extractSentenceMetrics(aiResponse),
    paragraphFlow: extractParagraphMetrics(aiResponse),
    chapterPacing: extractChapterMetrics(aiResponse),
    overallMomentum: calculateMomentumScore(aiResponse)
  };
}

interface DialogueAnalysis {
  naturalness: {
    score: number;
    conversationalFlow: number;
    authenticity: number;
    examples: {
      natural: string[];
      stilted: string[];
    };
  };
  characterVoice: {
    score: number;
    voiceDistinction: number;
    consistencyPerCharacter: Record<string, number>;
    speechPatterns: Record<string, string[]>;
  };
  technicalQuality: {
    score: number;
    tagVariety: number;
    adverbOveruse: number;
    punctuationCorrectness: number;
    repetitiveTagCount: number;
  };
  subtext: {
    score: number;
    subtextPresence: number;
    emotionalDepth: number;
    conflictInDialogue: number;
  };
}
 
const DIALOGUE_ANALYSIS_PROMPT = `
You are analyzing dialogue quality in this manuscript. Evaluate:
 
1. NATURALNESS: Does dialogue sound like real conversation?
   - Contractions usage (natural speech patterns)
   - Sentence fragments and interruptions
   - Realistic vocabulary for character age/background
   - Avoid overly formal or stiff language
 
2. CHARACTER VOICE DISTINCTION: Can you tell characters apart by speech alone?
   - Unique vocabulary per character
   - Different sentence structures
   - Consistent speech patterns
   - Age/background-appropriate language
 
3. TECHNICAL DIALOGUE CRAFT:
   - Count dialogue tags: "said" vs. other tags
   - Identify adverbs in dialogue tags (usually unnecessary)
   - Check punctuation correctness
   - Flag repetitive tag patterns
 
4. SUBTEXT AND DEPTH:
   - Characters saying one thing, meaning another
   - Emotional undercurrents in conversation
   - Conflict and tension in dialogue
   - Characters revealing personality through speech
 
DIALOGUE EXAMPLES FROM MANUSCRIPT: [DIALOGUE_HERE]
 
Provide specific feedback with examples of effective and problematic dialogue.
`;

interface CharacterAnalysis {
  arcDevelopment: {
    score: number;
    protagonistArc: {
      startingPoint: string;
      growthMoments: string[];
      endingPoint: string;
      changeMetrics: number;
    };
    supportingCharacterArcs: Array<{
      character: string;
      arcScore: number;
      development: string;
    }>;
  };
  motivation: {
    score: number;
    goalsClarity: number;
    motivationConsistency: number;
    internalConflict: number;
    externalConflict: number;
  };
  consistency: {
    score: number;
    behaviorConsistency: number;
    speechPatternConsistency: number;
    physicalDescriptionConsistency: number;
    contradictions: string[];
  };
  relationshipDynamics: {
    score: number;
    relationshipDevelopment: number;
    conflictDynamics: number;
    supportingRelationships: number;
  };
}
 
const CHARACTER_ANALYSIS_PROMPT = `
Analyze character development throughout this manuscript:
 
1. CHARACTER ARC TRACKING:
   - Identify the protagonist and their starting emotional/psychological state
   - Track key moments of growth, change, or realization
   - Evaluate the ending state vs. beginning state
   - Assess if the character truly changes and grows
 
2. MOTIVATION ANALYSIS:
   - What does each major character want? (external goals)
   - What do they need? (internal growth)
   - Are motivations clear and compelling?
   - Do characters make decisions consistent with their goals?
 
3. CONSISTENCY CHECKING:
   - Physical descriptions: height, eye color, age consistency
   - Personality traits: behavior patterns throughout story
   - Speech patterns: vocabulary and manner of speaking
   - Skills and abilities: what characters can/cannot do
 
4. RELATIONSHIP DYNAMICS:
   - How do character relationships evolve?
   - Are conflicts between characters realistic and compelling?
   - Do characters influence each other's growth?
 
MANUSCRIPT CONTENT: [CONTENT_HERE]
 
Focus on major characters and provide specific examples of development or lack thereof.
`;

interface PlotAnalysis {
  structure: {
    score: number;
    threeActStructure: {
      act1Percentage: number;
      act2Percentage: number;
      act3Percentage: number;
      structureBalance: number;
    };
    plotPoints: {
      incitingIncident: string;
      midpoint: string;
      climax: string;
      resolution: string;
    };
  };
  consistency: {
    score: number;
    plotHoles: Array<{
      issue: string;
      location: string;
      severity: 'minor' | 'major' | 'critical';
    }>;
    contradictions: string[];
    timelineConsistency: number;
  };
  conflictDevelopment: {
    score: number;
    conflictEscalation: number;
    stakesProgression: number;
    resolutionSatisfaction: number;
  };
  threadResolution: {
    score: number;
    unresolvedThreads: string[];
    setupPayoffPairs: Array<{
      setup: string;
      payoff: string;
      effectiveness: number;
    }>;
  };
}
 
const PLOT_ANALYSIS_PROMPT = `
Analyze plot structure and consistency:
 
1. STORY STRUCTURE:
   - Identify Act 1 (setup): approximately 25% of story
   - Identify Act 2 (development): approximately 50% of story  
   - Identify Act 3 (resolution): approximately 25% of story
   - Locate: inciting incident, midpoint twist, climax, resolution
 
2. PLOT HOLE DETECTION:
   - Timeline inconsistencies (character ages, dates, seasons)
   - Character ability inconsistencies (suddenly knowing skills)
   - Logic gaps (how did character get from A to B?)
   - Missing motivation explanations
   - Contradictory information between scenes
 
3. CONFLICT ESCALATION:
   - Does tension increase throughout the story?
   - Are stakes raised appropriately?
   - Do obstacles become more challenging?
   - Is the climax the highest point of tension?
 
4. SETUP AND PAYOFF:
   - Information introduced early that becomes important later
   - Chekhov's gun principle: if introduced, must be used
   - Foreshadowing effectiveness
   - Unresolved plot threads
 
MANUSCRIPT CONTENT: [CONTENT_HERE]
 
Identify specific issues with exact locations and severity levels.
`;

interface POVAnalysis {
  consistency: {
    score: number;
    povType: 'first' | 'second' | 'third-limited' | 'third-omniscient' | 'mixed';
    povSwitches: Array<{
      location: string;
      fromCharacter: string;
      toCharacter: string;
      appropriate: boolean;
    }>;
    headHoppingInstances: string[];
  };
  effectiveness: {
    score: number;
    povChoiceAppropriate: number;
    characterVoiceStrength: number;
    intimacyLevel: number;
  };
}
 
const POV_ANALYSIS_PROMPT = `
Analyze point of view consistency and effectiveness:
 
1. POV IDENTIFICATION:
   - Identify primary POV type (first person, third limited, etc.)
   - Track which character's perspective we're following
   - Note any POV switches between scenes/chapters
 
2. CONSISTENCY CHECKING:
   - Can we only know what the POV character knows?
   - Do we only see what the POV character can see?
   - Are there inappropriate "mind reading" moments?
   - Is internal voice consistent with POV character?
 
3. HEAD-HOPPING DETECTION:
   - Switching POV within a scene without clear breaks
   - Knowing other characters' thoughts inappropriately
   - Seeing things the POV character couldn't see
 
MANUSCRIPT CONTENT: [CONTENT_HERE]
 
Flag specific instances of POV violations with exact quotes.
`;

interface WorldBuildingAnalysis {
  consistency: {
    score: number;
    settingDetails: number;
    rulesConsistency: number;
    geographyLogic: number;
  };
  immersion: {
    score: number;
    sensoryDetails: number;
    culturalAuthenticity: number;
    believability: number;
  };
  development: {
    score: number;
    worldComplexity: number;
    originalityScore: number;
    integrationWithPlot: number;
  };
}
 
// Additional analysis methods for Strong Writing, Word Choice, and Foreshadowing
// follow similar patterns with specific AI prompts and scoring algorithms

class AIResponseProcessor {
  parseAnalysisResponse(response: string, category: string): CategoryResult {
    try {
      const parsed = JSON.parse(response);
      return {
        score: this.validateScore(parsed.score),
        feedback: parsed.feedback || '',
        strengths: parsed.strengths || [],
        weaknesses: parsed.weaknesses || [],
        examples: parsed.examples || {},
        suggestions: parsed.suggestions || []
      };
    } catch (error) {
      return this.createErrorResult(category, error);
    }
  }
 
  validateScore(score: any): number {
    const numScore = Number(score);
    if (isNaN(numScore) || numScore < 0 || numScore > 100) {
      return 50; // Default neutral score
    }
    return Math.round(numScore);
  }
 
  createErrorResult(category: string, error: Error): CategoryResult {
    return {
      score: 0,
      feedback: `Analysis failed for ${category}: ${error.message}`,
      strengths: [],
      weaknesses: ['Analysis could not be completed'],
      examples: {},
      suggestions: ['Please try re-running the analysis']
    };
  }
}