tududi/frontend/utils/taskIntelligenceService.ts

import { Task } from '../entities/Task';

/**
 * Analyzes a task name to determine if it's vague or needs improvement
 * Returns an object with analysis results and suggestions
 */
export interface TaskAnalysis {
  isVague: boolean;
  reason: 'short' | 'no_verb' | 'vague_pattern' | 'good';
  suggestion?: string;
  severity: 'low' | 'medium' | 'high';
}

export const analyzeTaskName = (taskName: string): TaskAnalysis => {
  const trimmedName = taskName.toLowerCase().trim();
  
  // Very short tasks (less than 10 chars) - original logic
  if (trimmedName.length > 0 && trimmedName.length < 10) {
    return {
      isVague: true,
      reason: 'short',
      suggestion: 'task.suggestions.short',
      severity: 'medium'
    };
  }
  
  // Skip if it's already a next action (contains →)
  if (trimmedName.includes('→')) {
    return {
      isVague: false,
      reason: 'good',
      severity: 'low'
    };
  }
  
  // More comprehensive action verb patterns
  const actionVerbPatterns = [
    // Direct action verbs at start
    /^(call|email|text|message|phone|contact)/,
    /^(write|draft|compose|type|create|make)/,
    /^(read|review|check|examine|study|analyze)/,
    /^(buy|purchase|order|get|obtain|acquire)/,
    /^(schedule|book|arrange|plan|set up|setup)/,
    /^(meet|discuss|talk|speak|chat)/,
    /^(send|deliver|ship|mail|forward)/,
    /^(update|edit|modify|change|fix|correct)/,
    /^(finish|complete|finalize|wrap up)/,
    /^(submit|file|upload|post|publish)/,
    /^(organize|sort|clean|tidy|arrange)/,
    /^(research|find|search|look up|investigate)/,
    /^(prepare|gather|collect|assemble)/,
    /^(install|download|set up|configure)/,
    /^(test|try|experiment|validate)/,
    /^(backup|save|export|archive)/,
    /^(delete|remove|uninstall|cancel)/,
    
    // Gerund forms (-ing verbs) which are often good actions
    /^(calling|emailing|writing|reading|buying|scheduling|meeting|sending|updating|finishing|submitting|organizing|researching|preparing|installing|testing|backing)/,
    
    // Question patterns (usually clear next actions)
    /^(what|how|when|where|why|which)/,
    /\?$/,
    
    // Imperative patterns with objects
    /^(add|remove|insert|attach|include|exclude)/,
    /^(start|begin|initiate|launch|kick off)/,
    /^(stop|end|terminate|close|shut)/,
    
    // Common task patterns
    /^(follow up|followup)/,
    /^(sign up|signup)/,
    /^(log in|login)/,
    /^(pick up|pickup)/,
    /^(drop off|dropoff)/,
    /^(set up|setup)/,
    /^(clean up|cleanup)/,
    /^(wrap up|wrapup)/
  ];
  
  // Check if task starts with any action verb pattern
  const hasActionVerb = actionVerbPatterns.some(pattern => pattern.test(trimmedName));
  if (hasActionVerb) {
    return {
      isVague: false,
      reason: 'good',
      severity: 'low'
    };
  }
  
  // Check for common non-actionable patterns (these are vague)
  const vaguePatterns = [
    // Single words without context
    /^[a-zA-Z]+$/,
    // Just names without action
    /^[A-Z][a-z]+ [A-Z][a-z]+$/,
    // Just project/area names
    /^(project|website|app|system|process|issue|problem|bug|feature)$/i,
    // Very short tasks without clear action (less than 3 words)
    /^(\w+\s+\w+|^\w+)$/
  ];
  
  // Only flag as vague if it matches vague patterns AND is not clearly actionable
  const matchesVaguePattern = vaguePatterns.some(pattern => pattern.test(trimmedName));
  
  // Additional checks for good tasks that shouldn't be flagged
  const hasGoodStructure = (
    trimmedName.length > 15 || // Longer tasks are usually more specific
    trimmedName.split(' ').length > 3 || // More than 3 words usually means more specific
    /\b(for|with|to|from|about|regarding|re:|fwd:)\b/.test(trimmedName) || // Prepositions indicate context
    /\b(tomorrow|today|monday|tuesday|wednesday|thursday|friday|saturday|sunday|next week|this week)\b/.test(trimmedName) || // Time references
    /\b(project|meeting|appointment|deadline|due|urgent|important)\b/.test(trimmedName) // Context indicators
  );
  
  if (matchesVaguePattern && !hasGoodStructure) {
    return {
      isVague: true,
      reason: 'vague_pattern',
      suggestion: 'task.suggestions.vague',
      severity: 'high'
    };
  }
  
  // Check for missing action verbs (less strict)
  if (!hasActionVerb && trimmedName.split(' ').length <= 2) {
    return {
      isVague: true,
      reason: 'no_verb',
      suggestion: 'task.suggestions.noVerb',
      severity: 'medium'
    };
  }
  
  return {
    isVague: false,
    reason: 'good',
    severity: 'low'
  };
};

/**
 * Filters tasks to find vague ones using the enhanced logic
 */
export const getVagueTasks = (tasks: Task[]): Task[] => {
  return tasks.filter(task => {
    if (task.status === 'done' || task.status === 'archived') return false;
    
    const analysis = analyzeTaskName(task.name);
    return analysis.isVague;
  });
};

/**
 * Gets a user-friendly suggestion for improving a task name
 */
export const getTaskNameSuggestion = (taskName: string): string | null => {
  const analysis = analyzeTaskName(taskName);
  return analysis.isVague ? (analysis.suggestion || null) : null;
};